gproxy_protocol/protocol/claude/common/
usage.rs

1use std::collections::BTreeMap;
2
3use serde::{Deserialize, Serialize};
4
5use super::{ClaudeModel, InferenceGeo, IterationUsageType, JsonObject, Speed, UsageServiceTier};
6
7#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
8pub struct Usage {
9    #[serde(skip_serializing_if = "Option::is_none")]
10    pub input_tokens: Option<u64>,
11    #[serde(skip_serializing_if = "Option::is_none")]
12    pub output_tokens: Option<u64>,
13    #[serde(skip_serializing_if = "Option::is_none")]
14    pub cache_creation_input_tokens: Option<u64>,
15    #[serde(skip_serializing_if = "Option::is_none")]
16    pub cache_read_input_tokens: Option<u64>,
17    #[serde(skip_serializing_if = "Option::is_none")]
18    pub cache_creation: Option<CacheCreation>,
19    #[serde(skip_serializing_if = "Option::is_none")]
20    pub output_tokens_details: Option<OutputTokensDetails>,
21    #[serde(skip_serializing_if = "Option::is_none")]
22    pub server_tool_use: Option<ServerToolUsage>,
23    #[serde(skip_serializing_if = "Option::is_none")]
24    pub iterations: Option<Vec<IterationUsage>>,
25    #[serde(skip_serializing_if = "Option::is_none")]
26    pub inference_geo: Option<InferenceGeo>,
27    #[serde(skip_serializing_if = "Option::is_none")]
28    pub service_tier: Option<UsageServiceTier>,
29    #[serde(skip_serializing_if = "Option::is_none")]
30    pub speed: Option<Speed>,
31    #[serde(default, flatten, skip_serializing_if = "BTreeMap::is_empty")]
32    pub extra: JsonObject,
33}
34
35#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
36pub struct CacheCreation {
37    pub ephemeral_1h_input_tokens: u64,
38    pub ephemeral_5m_input_tokens: u64,
39    #[serde(default, flatten, skip_serializing_if = "BTreeMap::is_empty")]
40    pub extra: JsonObject,
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)]
56pub struct OutputTokensDetails {
57    pub thinking_tokens: u64,
58    #[serde(default, flatten, skip_serializing_if = "BTreeMap::is_empty")]
59    pub extra: JsonObject,
60}
61
62#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
63pub struct ServerToolUsage {
64    #[serde(skip_serializing_if = "Option::is_none")]
65    pub web_fetch_requests: Option<u64>,
66    #[serde(skip_serializing_if = "Option::is_none")]
67    pub web_search_requests: Option<u64>,
68    #[serde(default, flatten, skip_serializing_if = "BTreeMap::is_empty")]
69    pub extra: JsonObject,
70}
71
72#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
73pub struct IterationUsage {
74    #[serde(rename = "type")]
75    pub type_: IterationUsageType,
76    #[serde(skip_serializing_if = "Option::is_none")]
77    pub model: Option<ClaudeModel>,
78    #[serde(skip_serializing_if = "Option::is_none")]
79    pub input_tokens: Option<u64>,
80    #[serde(skip_serializing_if = "Option::is_none")]
81    pub output_tokens: Option<u64>,
82    #[serde(skip_serializing_if = "Option::is_none")]
83    pub cache_creation_input_tokens: Option<u64>,
84    #[serde(skip_serializing_if = "Option::is_none")]
85    pub cache_read_input_tokens: Option<u64>,
86    #[serde(skip_serializing_if = "Option::is_none")]
87    pub cache_creation: Option<CacheCreation>,
88    #[serde(default, flatten, skip_serializing_if = "BTreeMap::is_empty")]
89    pub extra: JsonObject,
90}
gproxy_protocol/protocol/claude/common/usage.rs

gproxy_protocol/protocol/claude/common/
usage.rs
