Struct TokenUsage 

pub struct TokenUsage {
    pub prompt_tokens: usize,
    pub completion_tokens: usize,
    pub cached_input_tokens: usize,
    pub cache_creation_input_tokens: usize,
    pub reasoning_output_tokens: usize,
    pub source: TokenUsageSource,
}

Token usage statistics normalized across providers.

Component fields are disjoint; totals are derived, never stored:

• prompt_tokens: fresh (non-cached) input only. Adapters subtract cache reads for providers whose wire prompt count includes them.
• cached_input_tokens / cache_creation_input_tokens: cache read and write.
• completion_tokens: non-reasoning output only. Adapters subtract reasoning for providers whose wire completion count includes it. Anthropic reports no separate thinking count, so its thinking tokens ride inside completion_tokens and reasoning_output_tokens stays 0.
• reasoning_output_tokens: disjoint from completion_tokens.

Fields

prompt_tokens: usize

completion_tokens: usize

cached_input_tokens: usize

cache_creation_input_tokens: usize

reasoning_output_tokens: usize

source: TokenUsageSource

Implementations

impl TokenUsage

pub fn provider(prompt_tokens: usize, completion_tokens: usize) -> Self

pub fn estimate(prompt_tokens: usize) -> Self

pub fn with_cached_input(self, cached_input_tokens: usize) -> Self

pub fn with_cache_creation(self, cache_creation_input_tokens: usize) -> Self

pub fn with_reasoning_output(self, reasoning_output_tokens: usize) -> Self

pub fn input_total_tokens(&self) -> usize

pub fn output_total_tokens(&self) -> usize

pub fn total_tokens(&self) -> usize

Full request total, derived. Equals every provider’s wire total (verified for Anthropic, OpenAI, Gemini, Ollama) — a stored total would only reintroduce per-provider drift.

Trait Implementations

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 Debug for TokenUsage

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

Formats the value using the given formatter.

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