Enum TurnEvent 

pub enum TurnEvent {
    TextDelta(String),
    ReasoningDelta(String),
    ToolCallStreaming {
        name: String,
        hint: String,
    },
    ToolCallStarted {
        id: String,
        name: String,
        arguments: String,
    },
    ToolBatchStarted {
        batch_id: String,
        calls: Vec<ToolBatchCall>,
    },
    ToolBatchCompleted {
        batch_id: String,
        ok: usize,
        total: usize,
        elapsed_ms: u64,
    },
    ToolOutputChunk {
        call_id: String,
        chunk: String,
    },
    ToolCallResult {
        call_id: String,
        name: String,
        output: String,
        success: bool,
        duration: Duration,
    },
    Error(String),
    Warning(String),
    TokenUsage {
        prompt_tokens: usize,
        completion_tokens: usize,
        total_tokens: usize,
        cached_tokens: usize,
    },
    ContextStats {
        system_tokens: usize,
        sent_tokens: usize,
        dropped_tokens: usize,
        working_set_tokens: usize,
        total_messages: usize,
    },
    WorkingDirChanged(PathBuf),
    ApprovalRequested {
        tool_name: String,
        reason: String,
        call: ToolCall,
        messages: Vec<Message>,
    },
}

Low-level events emitted by TurnRunner during execution. Does not contain approval events — approval is handled internally via PermissionDecider.

Variants

TextDelta(String)

LLM streaming text output

ReasoningDelta(String)

LLM reasoning/thinking content (e.g., DeepSeek-R1, MiniMax-M2.7, o1-series). Emitted when the model produces thinking content separately from the final response. UI can optionally display this in verbose mode (Ctrl+O).

ToolCallStreaming

LLM has started emitting a tool call — name is known, arguments still streaming. Fires once per tool call, BEFORE the full args have arrived. Lets the UI surface the tool name immediately so users see “⠋ Write File…” instead of an opaque “Generating…” while the model spends seconds streaming args.

Fields

name: String

hint: String

ToolCallStarted

Tool call fully assembled, about to execute. id is the provider-supplied call id — pairs with the matching ToolCallResult.call_id.

Fields

id: String

name: String

arguments: String

ToolBatchStarted

Multiple tool calls fan out from one assistant message. Emitted BEFORE the per-call ToolCallStarted events, only when the runner is about to dispatch ≥ 2 non-duplicate calls. Lets the UI render a single grouped block instead of N independent rows. Per-call ToolCallStarted events STILL fire — UIs that don’t care about batches can ignore the batch events and render each call as today.

Fields

batch_id: String

calls: Vec<ToolBatchCall>

ToolBatchCompleted

Closes the batch opened by ToolBatchStarted. UI uses it to finalize the group header with ok / total / elapsed summary.

Fields

batch_id: String

ok: usize

total: usize

elapsed_ms: u64

ToolOutputChunk

Real-time output chunk from a running tool (e.g., bash command). Sent during tool execution before ToolCallResult.

Fields

call_id: String

chunk: String

ToolCallResult

Tool call completed. call_id must equal the id emitted with the corresponding ToolCallStarted.

Fields

call_id: String

name: String

output: String

success: bool

duration: Duration

Error(String)

Non-fatal error during execution

Warning(String)

Non-fatal advisory surfaced from a provider or other subsystem. TUI renders this as a one-line yellow banner; no turn failure. Currently used for “provider may be truncating input” detection.

TokenUsage

Token usage update

Fields

prompt_tokens: usize

completion_tokens: usize

total_tokens: usize

cached_tokens: usize

ContextStats

Context budget stats for logging

Fields

system_tokens: usize

sent_tokens: usize

dropped_tokens: usize

working_set_tokens: usize

total_messages: usize

WorkingDirChanged(PathBuf)

Emitted when a tool mutated ctx.working_dir (e.g. change_dir or a bash call starting with cd). Lets the TUI footer track the current cwd without polling the shared Arc<RwLock<PathBuf>>.

ApprovalRequested

A tool requires user approval. Carries a snapshot of conversation.messages so the TUI can persist mid-turn session state (e.g. for /bg). The approval itself is handled by PermissionDecider; this event is purely informational.

Fields

tool_name: String

reason: String

call: ToolCall

messages: Vec<Message>

Trait Implementations

impl Clone for TurnEvent

fn clone(&self) -> TurnEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TurnEvent

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

Formats the value using the given formatter.