Struct RunSummary 

pub struct RunSummary {
    pub rounds: usize,
    pub tool_calls: usize,
    pub usage: Usage,
    pub usage_omitted: bool,
    pub cache_omitted: bool,
    pub finish_reason: Option<FinishReason>,
    pub latency: Duration,
    pub provider_model: Option<String>,
}

Execution summary for one run.

Fields

rounds: usize

Number of conversation rounds.

tool_calls: usize

Total number of tool executions.

usage: Usage

Sum of reported token usage across provider turns.

Always the sum of the parts that were reported: turns whose provider did not return usage contribute nothing. Only exact when usage_omitted is false; otherwise it is a lower bound. The cached-token part has its own, finer-grained latch in cache_omitted.

usage_omitted: bool

true = at least one provider turn did not report usage (the endpoint omitted it), so usage is a lower bound rather than the run’s exact usage.

cache_omitted: bool

true = at least one provider turn did not report the prompt-cache breakdown, so usage.cached_tokens is a lower bound: it is the sum of the turns that did report one (None when no turn did).

Implied by usage_omitted — a turn that reported no usage at all reported no cache breakdown either.

finish_reason: Option<FinishReason>

Final direct-answer provider finish reason, when available.

latency: Duration

Wall-clock run latency.

provider_model: Option<String>

Provider model identifier, when the provider exposes one.

Trait Implementations

impl Clone for RunSummary

fn clone(&self) -> RunSummary

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RunSummary

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

Formats the value using the given formatter.

impl Default for RunSummary

fn default() -> RunSummary

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RunSummary

fn deserialize<__D>( __deserializer: __D, ) -> Result<RunSummary, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for RunSummary

impl PartialEq for RunSummary

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for RunSummary

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RunSummary