Struct TurnOutcome 

pub struct TurnOutcome {
    pub new_messages: Vec<Message>,
    pub final_text: Option<String>,
    pub finish_reason: FinishReason,
    pub usage: TokenUsage,
    pub llm_latency_ms: u64,
    pub steps: usize,
    pub side_effects: Vec<SideEffect>,
    pub plan_buffer: Option<Vec<ToolCall>>,
    pub tool_audits: HashMap<String, AuditMeta>,
    pub plan_confirmed: bool,
}

The result of executing one turn.

Returned to the Wrapper, which appends new_messages to its transcript, persists them, handles side effects, and tracks costs.

Fields

new_messages: Vec<Message>

All messages produced during this turn (assistant responses + tool results). Does NOT include the input messages — only what the kernel generated.

final_text: Option<String>

The final assistant text (convenience — also the last assistant msg in new_messages).

finish_reason: FinishReason

Why the turn ended.

usage: TokenUsage

Cumulative token usage across all LLM calls in this turn.

llm_latency_ms: u64

Total LLM call latency in milliseconds (excluding tool execution time).

steps: usize

Number of steps (LLM invocations) executed in this turn.

side_effects: Vec<SideEffect>

Side effects the Wrapper should adopt (background jobs, scheduled tasks).

plan_buffer: Option<Vec<ToolCall>>

Buffered tool calls from a proposed plan (when plan is pending).

tool_audits: HashMap<String, AuditMeta>

Goal-153: audit records for tool results, keyed by tool_call_id. Passed through from RunInnerOutcome so the persistence layer can emit MessageAppendedWithAudit for tool messages.

plan_confirmed: bool

Whether the plan was confirmed by the user.

Trait Implementations

impl Debug for TurnOutcome

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

Formats the value using the given formatter.

impl From<TurnOutcome> for RuntimeOutcome

fn from(t: TurnOutcome) -> Self

Converts to this type from the input type.