Struct ContextUsage 

pub struct ContextUsage { /* private fields */ }

Application-measured token usage for one context window.

Implementations

impl ContextUsage

pub fn new(used: u64, limit: u64) -> Self

Creates a usage snapshot from consumed tokens and the window size.

pub fn input(self, tokens: u64) -> Self

Records input (prompt) tokens for the breakdown.

pub fn output(self, tokens: u64) -> Self

Records output (completion) tokens for the breakdown.

pub fn reasoning(self, tokens: u64) -> Self

Records reasoning tokens for the breakdown.

pub fn cached(self, tokens: u64) -> Self

Records cached (prompt-cache hit) tokens for the breakdown.

pub fn cost(self, cost: impl Into<SharedString>) -> Self

Records an application-formatted cost line (for example $0.42).

pub fn fraction(&self) -> f32

Used tokens as a fraction of the limit, clamped to 0.0..=1.0.

pub fn percent(&self) -> u8

Used tokens as a whole percentage.

pub fn level(&self) -> UsageLevel

The band the current usage falls in.

pub fn used(&self) -> u64

Returns the consumed token count.

pub fn limit(&self) -> u64

Returns the window size in tokens.

Trait Implementations

impl Clone for ContextUsage

fn clone(&self) -> ContextUsage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContextUsage

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

Formats the value using the given formatter.

impl Default for ContextUsage

fn default() -> ContextUsage

Returns the “default value” for a type.

impl Eq for ContextUsage

impl PartialEq for ContextUsage

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ContextUsage