#[non_exhaustive]pub struct TurnResult {Show 17 fields
pub session_id: Option<String>,
pub result: Option<String>,
pub structured_output: Option<Value>,
pub total_cost_usd: Option<f64>,
pub ttft_ms: Option<u64>,
pub duration_ms: Option<u64>,
pub duration_api_ms: Option<u64>,
pub num_turns: Option<u64>,
pub input_tokens: Option<u64>,
pub output_tokens: Option<u64>,
pub cache_read_input_tokens: Option<u64>,
pub cache_creation_input_tokens: Option<u64>,
pub model_usage: Option<Value>,
pub stop_reason: Option<String>,
pub terminal_reason: Option<String>,
pub permission_denials: Vec<Value>,
pub origin: Option<Value>,
}Expand description
Outcome of a finished turn, from its result frame.
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.session_id: Option<String>Session id the CLI reported.
result: Option<String>Final text of the turn.
structured_output: Option<Value>Output matching Initialize::json_schema.
total_cost_usd: Option<f64>Cost in USD (total_cost_usd).
ttft_ms: Option<u64>Time to first token, in milliseconds (ttft_ms).
duration_ms: Option<u64>Wall-clock duration of the turn, in milliseconds (duration_ms).
duration_api_ms: Option<u64>Time spent in API calls, in milliseconds (duration_api_ms).
num_turns: Option<u64>Agentic turns (model calls) the turn took.
input_tokens: Option<u64>usage.input_tokens.
output_tokens: Option<u64>usage.output_tokens.
cache_read_input_tokens: Option<u64>usage.cache_read_input_tokens.
cache_creation_input_tokens: Option<u64>usage.cache_creation_input_tokens.
model_usage: Option<Value>Per-model token and cost breakdown.
stop_reason: Option<String>stop_reason of the result frame.
terminal_reason: Option<String>Why the agent loop ended (terminal_reason, e.g. “completed”).
permission_denials: Vec<Value>Tool calls the permission system denied.
origin: Option<Value>Set when the CLI started the turn itself (e.g. after a background
task finished); None for prompted turns.