Skip to main content

gproxy_protocol/protocol/claude/common/
fallback.rs

1use serde::{Deserialize, Serialize};
2
3use super::{ClaudeModel, JsonObject, OutputConfig, Speed, ThinkingConfig};
4
5/// Request-level fallback routing: either Anthropic's category-aware defaults
6/// or an ordered chain of up to three caller-selected models.
7#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
8#[serde(untagged)]
9pub enum FallbacksParam {
10    Default(FallbacksDefault),
11    Models(Vec<FallbackParam>),
12}
13
14#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
15pub enum FallbacksDefault {
16    #[serde(rename = "default")]
17    Default,
18}
19
20#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
21#[serde(untagged)]
22pub enum FallbackCreditTokenParam {
23    Token(String),
24    Config(FallbackCreditTokenConfig),
25}
26
27#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
28pub struct FallbackCreditTokenConfig {
29    pub token: String,
30    #[serde(skip_serializing_if = "Option::is_none")]
31    pub mode: Option<FallbackCreditMode>,
32    #[serde(default, flatten, skip_serializing_if = "JsonObject::is_empty")]
33    pub extra: JsonObject,
34}
35
36#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
37#[serde(untagged)]
38pub enum FallbackCreditMode {
39    Known(FallbackCreditModeKnown),
40    Unknown(String),
41}
42
43#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
44pub enum FallbackCreditModeKnown {
45    #[serde(rename = "strict")]
46    Strict,
47    #[serde(rename = "best_effort")]
48    BestEffort,
49}
50
51/// One ordered entry of the request-level `fallbacks` chain.
52#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
53pub struct FallbackParam {
54    pub model: ClaudeModel,
55    #[serde(skip_serializing_if = "Option::is_none")]
56    pub max_tokens: Option<u64>,
57    #[serde(skip_serializing_if = "Option::is_none")]
58    pub output_config: Option<OutputConfig>,
59    #[serde(skip_serializing_if = "Option::is_none")]
60    pub speed: Option<Speed>,
61    #[serde(skip_serializing_if = "Option::is_none")]
62    pub thinking: Option<ThinkingConfig>,
63    #[serde(default, flatten, skip_serializing_if = "JsonObject::is_empty")]
64    pub extra: JsonObject,
65}