Struct ProviderUsage 

pub struct ProviderUsage {
    pub provider: String,
    pub api_provider: Option<String>,
    pub account: Option<String>,
    pub source: Option<String>,
    pub account_info: Option<AccountInfo>,
    pub fetched_at: Option<String>,
    pub saved_resets: Option<SavedResets>,
    pub usage: Option<Usage>,
    pub error: Option<String>,
}

One provider/account’s usage entry. The /usage response is an array of these. A fetch failure becomes an entry carrying error (silent-degrade), never a failure of the whole array.

Fields

provider: String

CodexBar provider name (e.g. “codex”), which consumers map to their own id.

api_provider: Option<String>

Canonical API provider identifier — the models.dev slug for the same provider (e.g. “openai” when provider == "codex", “anthropic” for “claude”, “google” for “gemini”, “xai” for “grok”). Present when the producer knows the canonical name; absent for providers with no models.dev counterpart, where consumers fall back to provider. Lets every consumer key on one canonical name instead of each maintaining its own CodexBar-name → canonical map.

account: Option<String>

source: Option<String>

Which retrieval path produced this (e.g. “oauth”) — observability only.

account_info: Option<AccountInfo>

fetched_at: Option<String>

saved_resets: Option<SavedResets>

usage: Option<Usage>

error: Option<String>

Present only on a degraded entry. The consumer skips any entry with a truthy error.

Implementations

impl ProviderUsage

pub fn healthy( provider: &str, account: Option<String>, source: &str, usage: Usage, ) -> Self

A healthy entry with resolved windows.

pub fn degraded(provider: &str, error: impl Display) -> Self

A degraded entry: the provider is named so the consumer can correlate, but it carries only an error string and no windows.

Trait Implementations

impl Clone for ProviderUsage

fn clone(&self) -> ProviderUsage

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ProviderUsage

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ProviderUsage

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ProviderUsage

fn eq(&self, other: &ProviderUsage) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ProviderUsage

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ProviderUsage