Struct CostTracker 

pub struct CostTracker {
    pub total_input_tokens: u64,
    pub total_output_tokens: u64,
    pub total_cost_usd: f64,
    pub call_count: u64,
    pub budget_usd: Option<f64>,
}

Tracks cumulative token usage and estimated cost for a session.

Fields

total_input_tokens: u64

total_output_tokens: u64

total_cost_usd: f64

call_count: u64

budget_usd: Option<f64>

Optional session cost budget in USD. When set, the agent loop should check is_over_budget and pause when the budget is exhausted.

Implementations

impl CostTracker

pub fn new() -> Self

Create a new empty tracker.

pub fn set_budget(&mut self, usd: f64)

Set a cost budget in USD for the session.

Once total_cost_usd reaches or exceeds this value, is_over_budget returns true and the agent loop should pause.

pub fn is_over_budget(&self) -> bool

Check whether the session has exceeded its cost budget.

Returns false when no budget has been set.

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

Return the remaining budget in USD, or None if no budget is set.

pub fn record_usage( &mut self, usage: &TokenUsage, pricing: Option<&PricingInfo>, ) -> f64

Record token usage from a single LLM call.

Returns the incremental cost for this call in USD.

pub fn format_cost(&self) -> String

Format the total cost for display.

pub fn to_metadata(&self) -> HashMap<String, Value>

Export cost data for session metadata persistence.

pub fn restore_from_metadata(&mut self, metadata: &Value)

Restore cost state from session metadata (for --continue sessions).

Trait Implementations

impl Clone for CostTracker

fn clone(&self) -> CostTracker

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CostTracker

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

Formats the value using the given formatter.

impl Default for CostTracker

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CostTracker

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CostTracker

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.