Struct TokenUsage 

pub struct TokenUsage {
    pub input_tokens: u64,
    pub output_tokens: u64,
    pub cache_read_input_tokens: u64,
    pub cache_creation_input_tokens: u64,
    pub cache_creation_5m_input_tokens: u64,
    pub cache_creation_1h_input_tokens: u64,
}

Normalized usage; fields absent from a provider response default to zero.

Fields

input_tokens: u64

output_tokens: u64

cache_read_input_tokens: u64

cache_creation_input_tokens: u64

cache_creation_5m_input_tokens: u64

Cache-write tokens billed at the 5-minute TTL rate — a refinement of cache_creation_input_tokens (which stays the authoritative total), not a replacement for it. skip_serializing_if keeps a payload with no per-TTL breakdown byte-identical to one from before this field existed: this struct is persisted in the session log and serialized into --json/ACP frames, so a zero bucket must stay invisible on the wire.

cache_creation_1h_input_tokens: u64

Cache-write tokens billed at the 1-hour TTL rate (2x input, vs. 1.25x for the 5-minute default). See cache_creation_5m_input_tokens.

Implementations

impl TokenUsage

pub fn hit_ratio(&self) -> Option<f64>

Fraction of prompt tokens (input + cache reads + cache writes) served from the cache. None when there was no cache activity at all (no reads, no writes) — that is “nothing to report”, not a 0% hit rate, so a plain uncached request never shows a misleading 0%. Division by zero never happens: the guard only lets the divide run once the denominator has a cache-derived term in it.

Trait Implementations

impl AddAssign for TokenUsage

fn add_assign(&mut self, rhs: Self)

Performs the += operation.

impl Clone for TokenUsage

fn clone(&self) -> TokenUsage

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for TokenUsage

impl Debug for TokenUsage

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for TokenUsage

fn default() -> TokenUsage

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TokenUsage

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for TokenUsage

impl PartialEq for TokenUsage

fn eq(&self, other: &TokenUsage) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for TokenUsage

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for TokenUsage