Struct UsageReport 

pub struct UsageReport {

    pub scope: EvaluationScope,
    pub record_count: usize,
    pub run_count: usize,
    pub turn_count: usize,
    pub provider_call_count: u64,
    pub provider_input_tokens: u64,
    pub provider_output_tokens: u64,
    pub provider_total_tokens: u64,
    pub tool_call_count: u64,
    pub tool_completed_count: u64,
    pub tool_non_success_count: u64,
    pub elapsed_ms: Option<u64>,
    pub tool_total_elapsed_ms: Option<u64>,
    pub limitations: Vec<String>,
}

Provider/tool usage report derived from durable trace evidence.

Fields

scope: EvaluationScope

Scope this usage report describes.

record_count: usize

Number of journal records inspected.

run_count: usize

Number of runs represented in the source trace.

turn_count: usize

Number of turns represented in the source trace.

provider_call_count: u64

Number of completed provider calls.

provider_input_tokens: u64

Sum of provider input tokens.

provider_output_tokens: u64

Sum of provider output tokens.

provider_total_tokens: u64

Sum of provider total tokens.

tool_call_count: u64

Number of distinct tool calls.

tool_completed_count: u64

Number of completed tool calls.

tool_non_success_count: u64

Number of failed, timed out, cancelled, denied, unknown, or recovery-required tool calls.

elapsed_ms: Option<u64>

Elapsed time across the scope when durable timestamps support it.

tool_total_elapsed_ms: Option<u64>

Sum of per-tool elapsed milliseconds when available.

limitations: Vec<String>

Limitations found while deriving usage.

Implementations

impl UsageReport

pub fn from_run_trace(trace: &RunTrace) -> Result<Self, AgentError>

Builds a usage report from a run trace.

pub fn from_trace_metrics(metrics: TraceMetrics) -> Result<Self, AgentError>

Builds a usage report from precomputed trace metrics.

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

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 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