Struct UsageReport 

pub struct UsageReport {
    pub budget_requested: u32,
    pub budget_consumed: u64,
    pub as_of: String,
    pub providers: Vec<ProviderUsage>,
}

A per-request roll-up of context cost across every provider a query fanned out to (docs/context-reuse.md §2).

This is the shape a host maps into a metering pipeline: one row per (request, provider) with a frame-cited token total, plus the request-level budget requested vs. consumed and the accounting snapshot time.

Fields

budget_requested: u32

The query’s max_tokens — the budget the host asked providers to respect.

budget_consumed: u64

The summed token_cost of every served frame across all providers — what the request actually consumed.

as_of: String

The accounting snapshot time (RFC 3339), supplied by the host that produced the report. This is the report’s as-of, distinct from a query’s bi-temporal as_of retrieval pin.

providers: Vec<ProviderUsage>

Per-provider usage, one entry per provider the query fanned out to.

Implementations

impl UsageReport

pub fn total_provider_cost(&self) -> u64

Re-sum every provider’s token_cost. Equals budget_consumed for a consistently-built report.

pub fn total_frames_served(&self) -> u64

The number of frames served across all providers.

pub fn is_consistent(&self) -> bool

The core arithmetic identity a metering pipeline checks before trusting the report: the consumed total equals the summed cost of every served frame, and each provider’s aggregate agrees with its itemized frames. A report that fails this is a corrupted total, never a silent misbill (§2 conformance).

pub fn within_budget(&self) -> bool

Whether the request stayed within its requested budget. A conformant host drops budget-lying providers before they reach a report, so a report built by such a host always satisfies this.

Trait Implementations

impl Clone for UsageReport

fn clone(&self) -> UsageReport

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UsageReport

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for UsageReport

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for UsageReport

impl PartialEq for UsageReport

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for UsageReport

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 UsageReport