Struct Usage 

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

What the harness has spent on this run so far.

Every member is cumulative for the harness run, never the increment since the last report: a harness that sends a running count as it streams and a final total at the end is reported verbatim, both times. The runtime attributes, to each turn it closes, only the growth of each member over what it has already attributed, so reporting the same total twice adds nothing and a member that shrinks contributes zero. A driver that reports deltas instead would be counted several times over.

Every member is independently optional. none means this harness does not report this count and is never the same fact as 0, which means the harness reported spending none: the runtime keeps the two apart all the way into the trace.

cache-read and cache-creation sit beside input, never inside it. A harness that folds its cache counts into its input count must subtract them before reporting, so that input is always the uncached prompt alone. thinking is a subset of output, not an addition to it.

No cost figure and no context-window size is carried. A price a harness computed against its own table is a different claim from a token count, and the runtime has no equivalent on its other transport to make it mean the same thing on both.

Fields

input: Option<u64>

Prompt tokens, excluding anything cache-read or cache-creation covers.

output: Option<u64>

Generated tokens, including the thinking subset below.

cache_read: Option<u64>

Prompt tokens served from the provider’s cache.

cache_creation: Option<u64>

Prompt tokens written to the provider’s cache.

thinking: Option<u64>

The part of output the harness reports as reasoning.

Trait Implementations

impl Clone for Usage

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ComponentType for Usage

impl Copy for Usage

impl Debug for Usage

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

Formats the value using the given formatter.

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 Lift for Usage

impl Lower for Usage

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.