Struct AgentOutcome 

pub struct AgentOutcome {
    pub response: ModelResponse,
    pub transcript: Vec<Message>,
    pub turns: u32,
    pub tool_calls: u32,
    pub delegations: u32,
    pub usage: Usage,
}

Successful terminal state of an agent run.

Fields

response: ModelResponse

Final model response.

transcript: Vec<Message>

Complete canonical transcript, including tool calls and results.

turns: u32

Model turns performed by this agent.

tool_calls: u32

Tool calls attempted by this agent.

delegations: u32

Successful direct child-agent delegations performed by this agent.

usage: Usage

Shared run-tree usage snapshot at completion.

Implementations

impl AgentOutcome

pub fn text(&self) -> String

Collects model-visible terminal text in canonical content order.

pub fn into_text(self) -> String

Consumes the outcome and returns only model-visible terminal text.

Use this only when the transcript, usage, counters, warnings, and provider-specific response data are no longer needed.

pub fn terminal_repairs(&self) -> u32

Returns the number of bounded terminal repair turns in this execution.

pub fn into_structured<T>( self, ) -> Result<StructuredAgentOutcome<T>, StructuredOutputError>

where T: DeserializeOwned,

Locally validates and decodes the final model response while preserving the complete canonical outcome.

Errors

Returns StructuredOutputError when the response is missing textual output, contains a refusal, or does not deserialize as T.

Trait Implementations

impl Clone for AgentOutcome

fn clone(&self) -> AgentOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentOutcome

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentOutcome

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for AgentOutcome

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for AgentOutcome

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 AgentOutcome