Struct TokenUsage 

pub struct TokenUsage {
    pub prompt_tokens: u64,
    pub completion_tokens: u64,
    pub total_tokens: u64,
}

Token consumption statistics for a single LLM call or aggregated period.

This is a stable, cross-layer value object. Every crate that needs to represent “how many tokens were used” should use this type (or re-export it) instead of defining a local duplicate.

Fields

prompt_tokens: u64

Tokens in the LLM request (prompt / input).

completion_tokens: u64

Tokens in the LLM response (completion / output).

total_tokens: u64

Total tokens consumed (normally prompt + completion).

Implementations

impl TokenUsage

pub fn add_assign(&mut self, other: TokenUsage)

Accumulate another usage snapshot into this one.

pub fn recompute_total(&mut self)

Recompute total_tokens from the two component fields.

pub fn clamped_for_durable_metrics(self) -> TokenUsage

Normalize all counters to the lossless signed-64 durable range.

Components saturate independently and the total is recomputed from the saturated components, then saturated to the same boundary. This makes the policy deterministic even if an upstream supplied an inconsistent total and keeps round, session, and runtime views reconcilable.

pub fn add_assign_durable(&mut self, other: TokenUsage)

Accumulate usage with the same saturation policy used by durable stores.

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

impl Debug for TokenUsage

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

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<TokenUsage, <__D as Deserializer<'de>>::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 as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for TokenUsage