Struct TokenTracker 

pub struct TokenTracker { /* private fields */ }

One agent’s context window, tracked from real LLM API usage rather than estimation. Owns the ContextUsage snapshot the agent publishes and evaluates the compaction policy against it.

Implementations

impl TokenTracker

pub fn new(context_limit: Option<u32>) -> Self

pub fn record_usage(&mut self, sample: TokenUsage)

Record usage from an LLM API response.

pub fn snapshot(&self) -> &ContextUsage

The current window as published on ContextEvent::UsageUpdated.

pub fn usage_ratio(&self) -> Option<f64>

Current context usage as a ratio (0.0 - 1.0)

pub fn exceeds_threshold(&self, threshold: f64) -> bool

Whether current usage exceeds the given threshold

pub fn needs_compaction(&self, estimated_tokens: u32, threshold: f64) -> bool

Whether the context needs compaction

pub fn tokens_remaining(&self) -> Option<Tokens>

Tokens remaining before hitting limit

pub fn set_context_limit(&mut self, limit: Option<u32>)

Update the context limit (e.g. when switching models)

pub fn reset_current_usage(&mut self)

Forget the last call after context compaction so it cannot immediately re-trigger compaction.

Trait Implementations

impl Clone for TokenTracker

fn clone(&self) -> TokenTracker

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TokenTracker

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

Formats the value using the given formatter.

impl Default for TokenTracker

fn default() -> TokenTracker

Returns the “default value” for a type.