Struct Usage 

pub struct Usage {
    pub input: Option<u64>,
    pub output: Option<u64>,
    pub cache_creation: Option<u64>,
    pub cache_creation_5m: Option<u64>,
    pub cache_creation_1h: Option<u64>,
    pub cache_read: Option<u64>,
    pub thinking: Option<u64>,
}

Token usage as reported by the agent.

Every field is Option: None means UNKNOWN, which is not the same as zero (CLAUDE.md §8.5). Renderers must show unknowns as such.

Fields

input: Option<u64>

output: Option<u64>

cache_creation: Option<u64>

Total cache-creation (write) tokens.

cache_creation_5m: Option<u64>

5-minute-TTL share of cache_creation, when the agent reports the split. Priced differently from the 1h share (see pricing).

cache_creation_1h: Option<u64>

1-hour-TTL share of cache_creation (priced 2x input vs 1.25x for 5m).

cache_read: Option<u64>

thinking: Option<u64>

Extended-thinking (reasoning) tokens, ONLY when the agent reports them as a SEPARATE, disjoint count (Codex reasoning_output_tokens, kept out of output). Claude Code does NOT report them separately — there, thinking is already INCLUDED in output (verified v2.1.178), so this stays None to avoid double-counting in Usage::known_total; thinking is surfaced as a char-measured attribution of output in analysis::dedup instead (CLAUDE.md §8.2).

Implementations

impl Usage

pub fn is_empty(&self) -> bool

True when no field carries any information.

pub fn known_total(&self) -> u64

Sum of all KNOWN token counts (the 5m/1h fields are a breakdown of cache_creation and are not added again).

pub fn merge_max(self, other: Usage) -> Usage

Field-wise maximum, treating None as “no information” (not zero).

This is the dedup merge rule: lines of one request either repeat identical usage or grow monotonically while streaming, so MAX recovers the final per-request value in both cases.

Trait Implementations

impl Clone for Usage

fn clone(&self) -> Usage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Usage

impl Debug for Usage

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

Formats the value using the given formatter.

impl Default for Usage

fn default() -> Usage

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Usage

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Usage

impl PartialEq for Usage

fn eq(&self, other: &Usage) -> 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 Usage

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 Usage