Struct CostTracker 

pub struct CostTracker { /* private fields */ }

Implementations

impl CostTracker

pub fn new(enabled: bool, max_daily_cents: f64) -> Self

pub fn with_pricing(self, model: &str, pricing: ModelPricing) -> Self

pub fn record_usage( &self, provider_name: &str, provider_kind: &str, model: &str, input_tokens: u64, cache_read_tokens: u64, cache_write_tokens: u64, output_tokens: u64, )

Record token usage for a single LLM call, attributed to provider_name.

provider_kind must be the value returned by AnyProvider::provider_kind_str(): "ollama" or "candle" for local providers, "cloud" for API providers. Local providers always have zero cost by design; the missing-pricing WARN is suppressed for them to avoid log floods on every Ollama call.

Cache token counts are optional (pass 0 when not available). Cost is computed using model-specific pricing including cache read/write rates.

pub fn check_budget(&self) -> Result<(), BudgetExhausted>

Errors

Returns BudgetExhausted when daily spend exceeds the configured limit.

pub fn max_daily_cents(&self) -> f64

Returns the configured daily budget in cents. Zero means unlimited.

pub fn current_spend(&self) -> f64

pub fn record_successful_task(&self)

Increment the successful-task counter.

Call after each turn that completes without error and produces a usable agent response.

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

Returns cost-per-successful-task in cents, or None if no tasks recorded yet.

pub fn successful_tasks(&self) -> u64

Returns total number of successful tasks recorded today.

pub fn provider_breakdown(&self) -> Vec<(String, ProviderUsage)>

Returns per-provider breakdown sorted by cost descending.