Struct MeteringEngine 

pub struct MeteringEngine { /* private fields */ }

Engine for tracking LLM costs and enforcing spend quotas.

Implementations

impl MeteringEngine

pub fn new(memory: Arc<MemorySubstrate>) -> Self

Create a new metering engine with embedded default pricing.

pub fn with_prices( memory: Arc<MemorySubstrate>, model_prices: HashMap<String, ModelPrice>, ) -> Self

Create a new metering engine with custom pricing.

pub fn estimate_cost( &self, model: &str, input_tokens: u64, output_tokens: u64, ) -> f64

Calculate the cost for a given model and token counts.

pub async fn record_usage( &self, fighter_id: &FighterId, model: &str, input_tokens: u64, output_tokens: u64, ) -> PunchResult<f64>

Record usage for a fighter, calculating cost automatically.

pub async fn get_spend( &self, fighter_id: &FighterId, period: SpendPeriod, ) -> PunchResult<f64>

Get total spend for a specific fighter over a time period.

pub async fn get_total_spend(&self, period: SpendPeriod) -> PunchResult<f64>

Get total spend across all fighters over a time period.

pub async fn get_fighter_summary( &self, fighter_id: &FighterId, period: SpendPeriod, ) -> PunchResult<UsageSummary>

Get the usage summary for a fighter over a time period.

pub async fn get_total_summary( &self, period: SpendPeriod, ) -> PunchResult<UsageSummary>

Get the total usage summary across all fighters over a time period.

pub async fn get_model_breakdown( &self, fighter_id: &FighterId, period: SpendPeriod, ) -> PunchResult<Vec<ModelUsageBreakdown>>

Get per-model usage breakdown for a fighter over a time period.

pub async fn get_total_model_breakdown( &self, period: SpendPeriod, ) -> PunchResult<Vec<ModelUsageBreakdown>>

Get per-model usage breakdown across all fighters over a time period.

pub async fn get_fighter_breakdown( &self, period: SpendPeriod, ) -> PunchResult<Vec<FighterUsageBreakdown>>

Get per-fighter usage breakdown over a time period.