Struct UsageSummary 

pub struct UsageSummary {
    pub model_requests: u32,
    pub reported_model_requests: u32,
    pub input_tokens: u64,
    pub output_tokens: u64,
    pub cached_input_tokens: Option<u64>,
    pub reasoning_output_tokens: Option<u64>,
    pub peak_input_tokens: u64,
    pub credits: Option<u64>,
    pub tool_calls: u32,
    pub window_truncations: u32,
    pub trimmed_messages: u64,
}

Aggregated model and tool usage for one Agent run.

Fields

model_requests: u32

Model requests attempted by Runtime.

reported_model_requests: u32

Requests whose provider returned token accounting.

input_tokens: u64

Aggregated input tokens.

output_tokens: u64

Aggregated output tokens.

cached_input_tokens: Option<u64>

Aggregated cached input tokens when any provider reported them.

reasoning_output_tokens: Option<u64>

Aggregated reasoning output tokens when any provider reported them.

peak_input_tokens: u64

Largest single-request input observed or estimated during the run.

credits: Option<u64>

Aggregated provider-normalized billable credits when reported.

tool_calls: u32

Tool calls requested by models.

window_truncations: u32

Number of prompt-window truncations across the main loop and derived workflows.

trimmed_messages: u64

Number of prompt messages removed by window truncation.

Implementations

impl UsageSummary

pub fn record_model_attempt(&mut self)

Records that Runtime attempted one provider request.

pub fn record_usage(&mut self, usage: TokenUsage, reported: bool)

Records normalized usage without incrementing the already-recorded attempt count.

pub fn record_model_request(&mut self, usage: Option<TokenUsage>)

Records one completed model request while preserving missing telemetry.

pub fn record_window_truncation(&mut self, removed_messages: usize)

Records one deterministic prompt-history truncation.

Trait Implementations

impl Clone for UsageSummary

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for UsageSummary

impl Debug for UsageSummary

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

Formats the value using the given formatter.

impl Default for UsageSummary

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for UsageSummary

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for UsageSummary

impl PartialEq for UsageSummary

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for UsageSummary

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 UsageSummary