Struct UsageSnapshot 

pub struct UsageSnapshot {
    pub run_id: String,
    pub latest_usage: Option<Usage>,
    pub total_usage: Usage,
    pub estimate_pricing: Option<PricingEstimate>,
    pub entries: Vec<UsageSnapshotEntry>,
    pub agent_usages: BTreeMap<String, UsageAgentTotal>,
    pub model_usages: BTreeMap<String, Usage>,
    pub model_estimate_pricing: BTreeMap<String, PricingEstimate>,
}

Cumulative usage snapshot for one run.

Realtime consumers should treat each snapshot as a replacement for the previous snapshot with the same run id.

Fields

run_id: String

Run identifier for the snapshot.

latest_usage: Option<Usage>

Usage reported by the latest provider request that produced this snapshot.

This is intentionally separate from total_usage: realtime UI surfaces may use the latest request total tokens as the current context-window estimate, while total_usage remains the cumulative run ledger.

total_usage: Usage

Cumulative usage across all known entries in this run.

estimate_pricing: Option<PricingEstimate>

Estimated cumulative pricing across all known entries in this run, in USD.

entries: Vec<UsageSnapshotEntry>

Per-agent/source cumulative usage entries.

agent_usages: BTreeMap<String, UsageAgentTotal>

Cumulative usage grouped by agent id.

model_usages: BTreeMap<String, Usage>

Cumulative usage grouped by model id.

model_estimate_pricing: BTreeMap<String, PricingEstimate>

Estimated cumulative pricing grouped by model id, in USD.

Trait Implementations

impl Clone for UsageSnapshot

fn clone(&self) -> UsageSnapshot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UsageSnapshot

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

Formats the value using the given formatter.

impl Default for UsageSnapshot

fn default() -> UsageSnapshot

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for UsageSnapshot

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for UsageSnapshot

impl PartialEq for UsageSnapshot

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for UsageSnapshot

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 UsageSnapshot