Struct CostTracker 

pub struct CostTracker { /* private fields */ }

Cost tracker for API usage monitoring and budget enforcement.

Implementations

impl CostTracker

pub fn new( config: CostConfig, workspace_dir: &Path, ) -> Result<CostTracker, Error>

Create a new cost tracker.

pub fn session_id(&self) -> &str

Get the session ID.

pub fn check_budget( &self, estimated_cost_usd: f64, ) -> Result<BudgetCheck, Error>

Check if a request is within budget.

pub fn record_usage(&self, usage: TokenUsage) -> Result<(), Error>

Record a usage event without per-agent attribution.

pub fn record_usage_with_agent( &self, usage: TokenUsage, agent_alias: Option<&str>, ) -> Result<(), Error>

Record a usage event attributed to a specific agent alias. When [cost].track_per_agent is false the alias is dropped before persistence.

pub fn get_summary(&self) -> Result<CostSummary, Error>

Get the current cost summary. When [cost].track_per_agent is enabled, the response includes a by_agent rollup over today’s records.

pub fn get_summary_in_bounds( &self, from: Option<DateTime<Utc>>, to: Option<DateTime<Utc>>, ) -> Result<CostSummary, Error>

Filter persisted records by [from, to) (either side None is unbounded) and roll up by_model / by_agent / window totals. Bounds come from the caller (the dashboard computes them in the operator’s local timezone); the tracker doesn’t decide what “today” means.

pub fn get_summary_for_agent( &self, agent_alias: &str, ) -> Result<CostSummary, Error>

Get the current cost summary scoped to a single agent alias. The session/day/month figures and by_model are filtered to records attributed to that alias; by_agent is left empty since the caller already chose the dimension.

pub fn get_daily_cost(&self, date: NaiveDate) -> Result<f64, Error>

Get the daily cost for a specific date.

pub fn get_monthly_cost(&self, year: i32, month: u32) -> Result<f64, Error>

Get the monthly cost for a specific month.

impl CostTracker

pub fn get_or_init_global( config: CostConfig, workspace_dir: &Path, ) -> Option<Arc<CostTracker>>

Return the process-global CostTracker, creating it on first call. Subsequent calls (from gateway or channels, whichever starts second) receive the same Arc. Returns None when cost tracking is disabled or initialisation fails.