Struct AgentTurnMetadata 

pub struct AgentTurnMetadata {
    pub thinking: Option<String>,
    pub response_text: String,
    pub input_tokens: u64,
    pub output_tokens: u64,
    pub cache_read_tokens: u64,
    pub stop_reason: String,
}

Agent turn response metadata for observability

Captures detailed information about each agent turn, including:

• Thinking content (if Claude extended thinking is enabled)
• Response text
• Token usage
• Stop reason

Note on Thinking Capture

Full thinking block capture requires using rig’s streaming API or direct completion requests. When using agent.prompt(), thinking is not available (will be None).

Fields

thinking: Option<String>

Thinking content from Claude’s extended thinking (if enabled)

This field is populated when using streaming completion or direct completion API. It’s None when using Agent::prompt().

response_text: String

Main response text from the agent

input_tokens: u64

Input tokens used for this turn

output_tokens: u64

Output tokens generated for this turn

cache_read_tokens: u64

Cache read tokens (Anthropic prompt caching)

stop_reason: String

Stop reason: “end_turn”, “tool_use”, “max_tokens”, “stop_sequence”

Implementations

impl AgentTurnMetadata

pub fn text_only( response: impl Into<String>, stop_reason: impl Into<String>, ) -> AgentTurnMetadata

Create metadata for a simple text response (no thinking)

pub fn with_usage( response: impl Into<String>, input_tokens: u64, output_tokens: u64, stop_reason: impl Into<String>, ) -> AgentTurnMetadata

Create metadata with token usage

pub fn total_tokens(&self) -> u64

Total tokens (input + output)

pub fn has_thinking(&self) -> bool

Check if thinking was captured

Trait Implementations

impl Clone for AgentTurnMetadata

fn clone(&self) -> AgentTurnMetadata

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentTurnMetadata

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentTurnMetadata

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for AgentTurnMetadata

fn eq(&self, other: &AgentTurnMetadata) -> 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 AgentTurnMetadata

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 AgentTurnMetadata