Struct UsageMetadata 

pub struct UsageMetadata {
    pub prompt_token_count: Option<i32>,
    pub cached_content_token_count: Option<i32>,
    pub candidates_token_count: Option<i32>,
    pub thoughts_token_count: Option<i32>,
    pub total_token_count: Option<i32>,
}

Token usage statistics from the backend.

Fields

prompt_token_count: Option<i32>

Tokens in the prompt.

cached_content_token_count: Option<i32>

Tokens served from cache.

candidates_token_count: Option<i32>

Tokens in the model’s response.

thoughts_token_count: Option<i32>

Tokens used for chain-of-thought reasoning.

total_token_count: Option<i32>

Total tokens (prompt + response + thoughts).

Implementations

impl UsageMetadata

pub fn merge_round(&mut self, other: &UsageMetadata)

Fold a SUCCESSIVE ROUND of the SAME turn into self — the per-turn accumulator the backend loops use. prompt_token_count / cached_content_token_count describe the LIVE CONTEXT SIZE, which the model reports afresh each round of a multi-round tool turn, so they take the LATEST value (summing them quadruple-counted the context on a 4-round turn, made the context-fullness bar “fluctuate wildly”, and fired auto-compaction early — on-chain feedback #73). Output-side counts (candidates / thoughts / total) are genuinely cumulative and sum. For cross-turn billing-style totals use Self::accumulate.

pub fn accumulate(&mut self, other: &UsageMetadata)

Fold other into self, summing EVERY field — the cross-turn billing-style accumulator (Conversation::cumulative_usage). Missing fields on either side are treated as zero so the accumulator only advances when the backend reports usage.

Trait Implementations

impl Clone for UsageMetadata

fn clone(&self) -> UsageMetadata

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UsageMetadata

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

Formats the value using the given formatter.

impl Default for UsageMetadata

fn default() -> UsageMetadata

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for UsageMetadata

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for UsageMetadata

impl PartialEq for UsageMetadata

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for UsageMetadata

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 UsageMetadata