lean-ctx-protocol 0.5.0

Open wire contracts for lean-ctx: events, observations, assignments, evidence gaps.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

use serde::{Deserialize, Serialize};

/// Granular token usage breakdown.
#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)]
pub struct UsageBreakdownV1 {
    pub input_tokens: u64,
    pub output_tokens: u64,
    pub cached_input_tokens: u64,
    pub cache_write_tokens: u64,
    pub reasoning_tokens: u64,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub other_units: Vec<MeasuredUnitV1>,
}

#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct MeasuredUnitV1 {
    pub unit_type: String,
    pub quantity: u64,
}

#[cfg(test)]
mod tests {
    use crate::{MeasuredUnitV1, UsageBreakdownV1};

    #[test]
    fn serialization_round_trip() {
        let usage = UsageBreakdownV1 {
            input_tokens: 10,
            output_tokens: 5,
            cached_input_tokens: 3,
            cache_write_tokens: 2,
            reasoning_tokens: 1,
            other_units: vec![MeasuredUnitV1 {
                unit_type: "image".to_owned(),
                quantity: 1,
            }],
        };
        let json = serde_json::to_string(&usage).expect("usage should serialize");
        let decoded = serde_json::from_str(&json).expect("usage should deserialize");
        assert_eq!(usage, decoded);
    }
}