gproxy_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)]
9#[non_exhaustive]
10pub enum FallbacksParam {
11    Default(FallbacksDefault),
12    Models(Vec<FallbackParam>),
13    Raw(serde_json::Value),
14}
15
16#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
17#[non_exhaustive]
18pub enum FallbacksDefault {
19    #[serde(rename = "default")]
20    Default,
21}
22
23#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
24#[serde(untagged)]
25#[non_exhaustive]
26pub enum FallbackCreditTokenParam {
27    Token(String),
28    Config(FallbackCreditTokenConfig),
29    Raw(serde_json::Value),
30}
31
32#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, gproxy_protocol_macros::WireBuilder)]
33#[cfg_attr(not(feature = "exhaustive"), non_exhaustive)]
34pub struct FallbackCreditTokenConfig {
35    pub token: String,
36    #[serde(skip_serializing_if = "Option::is_none")]
37    pub mode: Option<FallbackCreditMode>,
38    #[serde(default, flatten, skip_serializing_if = "JsonObject::is_empty")]
39    pub rest: serde_json::Map<String, serde_json::Value>,
40}
41
42#[derive(Debug, Clone, PartialEq, Eq, Serialize)]
43#[serde(untagged)]
44#[non_exhaustive]
45pub enum FallbackCreditMode {
46    Known(FallbackCreditModeKnown),
47    Unknown(String),
48}
49
50// Manual Deserialize: unknown values fall back without formatting an
51// unknown-variant error (see `protocol::extensible`).
52impl<'de> serde::Deserialize<'de> for FallbackCreditMode {
53    fn deserialize<D: serde::Deserializer<'de>>(d: D) -> Result<Self, D::Error> {
54        crate::claude::extensible::deserialize_extensible(d, Self::Known, Self::Unknown)
55    }
56}
57
58#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
59#[non_exhaustive]
60pub enum FallbackCreditModeKnown {
61    #[serde(rename = "strict")]
62    Strict,
63    #[serde(rename = "best_effort")]
64    BestEffort,
65}
66
67/// One ordered entry of the request-level `fallbacks` chain.
68#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, gproxy_protocol_macros::WireBuilder)]
69#[cfg_attr(not(feature = "exhaustive"), non_exhaustive)]
70pub struct FallbackParam {
71    pub model: ClaudeModel,
72    #[serde(skip_serializing_if = "Option::is_none")]
73    pub max_tokens: Option<u64>,
74    #[serde(skip_serializing_if = "Option::is_none")]
75    pub output_config: Option<OutputConfig>,
76    #[serde(skip_serializing_if = "Option::is_none")]
77    pub speed: Option<Speed>,
78    #[serde(skip_serializing_if = "Option::is_none")]
79    pub thinking: Option<ThinkingConfig>,
80    #[serde(default, flatten, skip_serializing_if = "JsonObject::is_empty")]
81    pub rest: serde_json::Map<String, serde_json::Value>,
82}
gproxy_protocol/claude/common/fallback.rs

gproxy_protocol/claude/common/
fallback.rs
