Struct ContextUsageSnapshot 

pub struct ContextUsageSnapshot {
    pub used_tokens: usize,
    pub max_tokens: Option<usize>,
    pub remaining_tokens: Option<usize>,
    pub used_percent: Option<u8>,
    pub source: TokenUsageSource,
    pub prompt_tokens: usize,
    pub cached_input_tokens: usize,
    pub cache_creation_input_tokens: usize,
    pub completion_tokens: usize,
    pub reasoning_output_tokens: usize,
    pub breakdown: Option<PromptTokenBreakdown>,
}

The model-visible context for the latest request. This is separate from cumulative session usage, which is an API/accounting total.

Fields

used_tokens: usize

max_tokens: Option<usize>

remaining_tokens: Option<usize>

used_percent: Option<u8>

source: TokenUsageSource

prompt_tokens: usize

cached_input_tokens: usize

cache_creation_input_tokens: usize

completion_tokens: usize

reasoning_output_tokens: usize

breakdown: Option<PromptTokenBreakdown>

Implementations

impl ContextUsageSnapshot

pub fn from_usage(usage: &TokenUsage, max_tokens: Option<usize>) -> Self

pub fn from_estimate( breakdown: PromptTokenBreakdown, max_tokens: Option<usize>, ) -> Self

pub fn is_estimate(&self) -> bool

pub fn with_additional_tokens(self, extra: usize) -> Self

Return a copy with extra tokens folded into the running total. Used by /context to add built-in tool-schema tokens that the reducer’s MCP-only request estimate can’t see. Recomputes remaining_tokens and used_percent; the breakdown is left untouched (the caller surfaces the built-in figure on its own line so the MCP line stays accurate).

Trait Implementations

impl Clone for ContextUsageSnapshot

fn clone(&self) -> ContextUsageSnapshot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContextUsageSnapshot

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ContextUsageSnapshot

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ContextUsageSnapshot

impl PartialEq for ContextUsageSnapshot

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ContextUsageSnapshot

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 ContextUsageSnapshot