Struct TurnResult 

pub struct TurnResult {
    pub result: Value,
    pub events: Vec<Value>,
}

The result of one turn through a DuplexSession.

result is the raw JSON of the {"type": "result", ...} message that closed the turn. events carries every other message received during the turn (system, assistant, stream_event, user) in arrival order, with the closing result excluded.

Fields

result: Value

The raw {"type": "result", ...} message that ended the turn.

events: Vec<Value>

Every other message received during the turn, in order.

Implementations

impl TurnResult

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

Extract result.result as a string, if present.

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

Extract result.session_id, if present.

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

Extract total_cost_usd (preferred) or the legacy cost_usd field, if either is present.

This is the CLI’s running total for the session, not the cost of this turn: each result message reports everything spent so far, earlier turns included. When the session was spawned with DuplexOptions::resume or DuplexOptions::continue_session, the CLI restores the resumed session’s total, so the figure also covers spend from before this process started.

A turn’s own cost is the change from the previous turn’s total. Conversation records that change for each turn and keeps the cumulative figure.

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

Extract duration_ms, if present.

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

Extract result.subtype, if present: "success" for a turn that completed, or an error subtype such as "error_during_execution" for an interrupted turn.

pub fn is_error(&self) -> bool

Extract result.is_error. Returns false when the field is absent.

Trait Implementations

impl Clone for TurnResult

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TurnResult

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

Formats the value using the given formatter.