gproxy_protocol/claude/common/
usage.rs

1use serde::{Deserialize, Serialize};
2
3use super::{ClaudeModel, InferenceGeo, IterationUsageType, Speed, UsageServiceTier};
4
5#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, gproxy_protocol_macros::WireBuilder)]
6#[cfg_attr(not(feature = "exhaustive"), non_exhaustive)]
7pub struct Usage {
8    #[serde(skip_serializing_if = "Option::is_none")]
9    pub input_tokens: Option<u64>,
10    #[serde(skip_serializing_if = "Option::is_none")]
11    pub output_tokens: Option<u64>,
12    #[serde(skip_serializing_if = "Option::is_none")]
13    pub cache_creation_input_tokens: Option<u64>,
14    #[serde(skip_serializing_if = "Option::is_none")]
15    pub cache_read_input_tokens: Option<u64>,
16    #[serde(skip_serializing_if = "Option::is_none")]
17    pub cache_creation: Option<CacheCreation>,
18    #[serde(skip_serializing_if = "Option::is_none")]
19    pub output_tokens_details: Option<OutputTokensDetails>,
20    #[serde(skip_serializing_if = "Option::is_none")]
21    pub server_tool_use: Option<ServerToolUsage>,
22    #[serde(skip_serializing_if = "Option::is_none")]
23    pub iterations: Option<Vec<IterationUsage>>,
24    #[serde(skip_serializing_if = "Option::is_none")]
25    pub inference_geo: Option<InferenceGeo>,
26    #[serde(skip_serializing_if = "Option::is_none")]
27    pub service_tier: Option<UsageServiceTier>,
28    #[serde(skip_serializing_if = "Option::is_none")]
29    pub speed: Option<Speed>,
30    #[serde(default, flatten, skip_serializing_if = "serde_json::Map::is_empty")]
31    pub rest: serde_json::Map<String, serde_json::Value>,
32}
33
34#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, gproxy_protocol_macros::WireBuilder)]
35#[cfg_attr(not(feature = "exhaustive"), non_exhaustive)]
36pub struct CacheCreation {
37    pub ephemeral_1h_input_tokens: u64,
38    pub ephemeral_5m_input_tokens: u64,
39    #[serde(default, flatten, skip_serializing_if = "serde_json::Map::is_empty")]
40    pub rest: serde_json::Map<String, serde_json::Value>,
41}
42
43impl Usage {
44    /// Total cache-creation tokens: the aggregate field when present, else the
45    /// 5m/1h breakdown sum (either side may be absent on the wire).
46    pub fn cache_creation_total(&self) -> Option<u64> {
47        self.cache_creation_input_tokens.or_else(|| {
48            self.cache_creation
49                .as_ref()
50                .map(|c| c.ephemeral_5m_input_tokens + c.ephemeral_1h_input_tokens)
51        })
52    }
53}
54
55#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, gproxy_protocol_macros::WireBuilder)]
56#[cfg_attr(not(feature = "exhaustive"), non_exhaustive)]
57pub struct OutputTokensDetails {
58    #[serde(skip_serializing_if = "Option::is_none")]
59    pub thinking_tokens: Option<u64>,
60    #[serde(default, flatten, skip_serializing_if = "serde_json::Map::is_empty")]
61    pub rest: serde_json::Map<String, serde_json::Value>,
62}
63
64#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, gproxy_protocol_macros::WireBuilder)]
65#[cfg_attr(not(feature = "exhaustive"), non_exhaustive)]
66pub struct ServerToolUsage {
67    #[serde(skip_serializing_if = "Option::is_none")]
68    pub web_fetch_requests: Option<u64>,
69    #[serde(skip_serializing_if = "Option::is_none")]
70    pub web_search_requests: Option<u64>,
71    #[serde(default, flatten, skip_serializing_if = "serde_json::Map::is_empty")]
72    pub rest: serde_json::Map<String, serde_json::Value>,
73}
74
75#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, gproxy_protocol_macros::WireBuilder)]
76#[cfg_attr(not(feature = "exhaustive"), non_exhaustive)]
77pub struct IterationUsage {
78    #[serde(rename = "type")]
79    pub type_: IterationUsageType,
80    #[serde(skip_serializing_if = "Option::is_none")]
81    pub model: Option<ClaudeModel>,
82    #[serde(skip_serializing_if = "Option::is_none")]
83    pub input_tokens: Option<u64>,
84    #[serde(skip_serializing_if = "Option::is_none")]
85    pub output_tokens: Option<u64>,
86    #[serde(skip_serializing_if = "Option::is_none")]
87    pub cache_creation_input_tokens: Option<u64>,
88    #[serde(skip_serializing_if = "Option::is_none")]
89    pub cache_read_input_tokens: Option<u64>,
90    #[serde(skip_serializing_if = "Option::is_none")]
91    pub cache_creation: Option<CacheCreation>,
92    #[serde(default, flatten, skip_serializing_if = "serde_json::Map::is_empty")]
93    pub rest: serde_json::Map<String, serde_json::Value>,
94}
gproxy_protocol/claude/common/usage.rs

gproxy_protocol/claude/common/
usage.rs
