Struct UsageLedger 

pub struct UsageLedger { /* private fields */ }

Implementations

impl UsageLedger

pub fn new() -> Self

pub fn with_ttl(ttl: Duration) -> Self

pub fn record( &mut self, request_id: RequestId, attempt_id: AttemptId, prompt_tokens: u64, completion_tokens: u64, total_tokens: u64, ) -> InsertOutcome

Record a completed attempt’s usage. Returns InsertOutcome::is_new() false when the same (request, attempt) was already recorded, which the caller must treat as a no-op billing event.

pub fn len(&self) -> usize

The number of distinct attempts currently recorded.

pub fn is_empty(&self) -> bool

pub fn contains(&self, request_id: &RequestId, attempt_id: &AttemptId) -> bool

True when a usage record exists for this (request, attempt) pair.

pub fn total_tokens(&self) -> u64

Total tokens recorded across all distinct attempts.

pub fn sweep_expired(&mut self)

Drops records older than the TTL. Called lazily on every record and available explicitly for maintenance. The clock read is floored to the ledger’s monotonic timestamp so a backwards jump cannot expire freshly recorded rows.

Trait Implementations

impl Debug for UsageLedger

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

Formats the value using the given formatter.

impl Default for UsageLedger

fn default() -> Self

Returns the “default value” for a type.