Struct AgentResult 

pub struct AgentResult { /* private fields */ }

The result of a successful agent invocation.

Wraps the raw AgentOutput and provides convenience accessors for the response text, typed JSON deserialization, session metadata, and usage stats.

Implementations

impl AgentResult

pub fn text(&self) -> &str

Return the agent’s response as a plain text string.

If the underlying value is not a JSON string (e.g. when structured output was requested), returns an empty string and logs a warning.

pub fn value(&self) -> &Value

Return the raw JSON Value of the agent’s response.

pub fn json<T: DeserializeOwned>(&self) -> Result<T, OperationError>

Deserialize the agent’s response into the given type T.

This clones the underlying JSON value. If you no longer need the AgentResult afterwards, use into_json instead to avoid the clone.

Errors

Returns OperationError::Deserialize if the JSON value does not match T.

pub fn into_json<T: DeserializeOwned>(self) -> Result<T, OperationError>

Consume the result and deserialize the response into T without cloning.

Errors

Returns OperationError::Deserialize if the JSON value does not match T.

pub fn session_id(&self) -> Option<&str>

Return the provider-assigned session ID, if available.

pub fn cost_usd(&self) -> Option<f64>

Return the cost of this invocation in USD, if reported by the provider.

pub fn input_tokens(&self) -> Option<u64>

Return the number of input tokens consumed, if reported.

pub fn output_tokens(&self) -> Option<u64>

Return the number of output tokens generated, if reported.

pub fn duration_ms(&self) -> u64

Return the wall-clock duration of the invocation in milliseconds.

pub fn model(&self) -> Option<&str>

Return the concrete model identifier used, if reported by the provider.

pub fn debug_messages(&self) -> Option<&[DebugMessage]>

Return the conversation trace captured during a verbose invocation.

Returns None when Agent::verbose was not called. When present, each DebugMessage contains the assistant’s text and tool calls for one conversation turn.

Trait Implementations

impl Debug for AgentResult

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

Formats the value using the given formatter.