Struct TurnUsage 

pub struct TurnUsage { /* private fields */ }

Exact token accounting for every Responses call in one logical agent turn.

Cache-read and cache-write tokens are subsets of input tokens. Reasoning tokens are a subset of output tokens. The values are summed from provider usage records across warmup, generation, tool continuation, steering, and compaction calls made before the turn reaches its terminal boundary. Check Self::cost_status to distinguish a provider-omitted usage record from a genuine zero-token total.

Implementations

impl TurnUsage

pub const fn input_tokens(&self) -> u64

Returns all input tokens billed or reported by the provider.

pub const fn cached_input_tokens(&self) -> u64

Returns input tokens served from the provider’s prompt cache.

pub const fn cache_write_input_tokens(&self) -> u64

Returns input tokens newly written into the provider’s prompt cache.

pub const fn output_tokens(&self) -> u64

Returns all output tokens billed or reported by the provider.

pub const fn reasoning_output_tokens(&self) -> u64

Returns reasoning tokens included within Self::output_tokens.

pub const fn total_tokens(&self) -> u64

Returns the provider-reported total token count.

pub fn estimated_cost(&self) -> Option<&EstimatedUsdCost>

Returns the automatic local USD estimate.

Nanocodex applies the built-in standard or priority gpt-5.6-sol rates. None means the provider omitted usage; absence is never serialized as a misleading zero.

pub const fn cost_status(&self) -> CostStatus

Returns why an estimate is present or unavailable.

Trait Implementations

impl Clone for TurnUsage

fn clone(&self) -> TurnUsage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TurnUsage

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

Formats the value using the given formatter.

impl Default for TurnUsage

fn default() -> TurnUsage

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TurnUsage

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for TurnUsage

impl PartialEq for TurnUsage

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for TurnUsage

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 TurnUsage