Struct QuotaTracker 

pub struct QuotaTracker { /* private fields */ }

The QuotaTracker.

Implementations

impl QuotaTracker

pub fn new(config: TokenMaxingConfig) -> Self

pub fn reload(&self, config: TokenMaxingConfig)

pub fn update_live_snapshot(&self, snapshot: QuotaSnapshot)

Store the most recent live QuotaSnapshot for provider.

pub fn live_snapshot(&self, provider: &str) -> Option<QuotaSnapshot>

pub fn live_providers(&self) -> Vec<String>

pub fn live_eligible(&self, provider: &str) -> Option<bool>

Some(true) = subscription, Some(false) = metered (or unknown), None = no live data.

pub fn availability(&self, provider: &str) -> Availability

The verdict for a single provider (v2 — live snapshot first).

pub fn snapshots(&self) -> Vec<QuotaTrackerSnapshot>

All providers (eligible or not). v2 includes config entries, self-tracked budget providers, AND auto-discovered live providers.

pub fn record_failure( &self, provider: &str, class: FailureClass, resets_at: Option<DateTime<Utc>>, )

Reactive override — record a failure class.

pub fn clear_cooldown(&self, provider: &str)

pub fn apply_recalibration( &self, provider: &str, remaining_percent: Option<f64>, resets_at: Option<DateTime<Utc>>, token_limit: Option<u64>, outcome: RecalibrationOutcome, ) -> bool

v2: takes token_limit: Option<u64> from the live response (replaces the v1 config lookup). When None, falls back to [[token-maxing.providers]] config.

pub fn reserve(&self, provider: &str, tokens: u64) -> Result<(), ReserveError>

pub fn release(&self, provider: &str, tokens: u64)

pub fn snapshot(&self, provider: &str) -> Option<ProviderSnapshot>

pub fn recalibration_history(&self) -> Vec<RecalibrationRecord>

pub fn cooldown_history(&self) -> Vec<CooldownRecord>

pub fn config(&self) -> TokenMaxingConfig