Enum TurnEvent 

pub enum TurnEvent {
    TextDelta(String),
    ToolStarted {
        name: String,
    },
    ApprovalPending {
        request_id: String,
        tool_name: String,
        title: String,
        args_json: String,
    },
    HandoffStarted {
        child_agent_id: String,
        reason: String,
    },
    Done,
}

Incremental event emitted while a turn streams from the control plane.

Unlike AgentDialer::run_turn, which folds the whole turn into one string, the streaming API surfaces each meaningful step as it arrives so a live surface (e.g. Slack chat.appendStream) can update in place.

Variants

TextDelta(String)

Incremental assistant answer text (model/assistant role).

ToolStarted

A tool call has started, named for a user-visible “thinking step”.

Fields

name: String

The tool/function name, or the call id when the name is absent.

ApprovalPending

The turn paused before executing a tool that requires human approval. Emitted (one per pending call) from the terminal AgentEnd just before TurnEvent::Done. The caller submits a decision via ApprovalService.Respond (the THIN path) and re-drives the turn.

Fields

request_id: String

Tool-call id == the approval request_id to answer.

tool_name: String

The tool/function name awaiting approval. Raw machine identifier; the field of record for trust/audit.

title: String

Human display label (MCP-style title) for the tool, for rendering in the approval prompt. May be empty; the surface then derives one from tool_name.

args_json: String

Arguments JSON for the call.

HandoffStarted

The turn suspended to delegate to a sub-agent: the model invoked the reserved __handoff_to primitive. Surfaced (once) from the terminal AgentEnd.handoff just before TurnEvent::Done. The child conversation runs independently; the parent resumes when the child returns, so an edge can render “delegating…” rather than going silent.

Fields

child_agent_id: String

The child agent / planner chosen; empty selects the parent’s default planner.

reason: String

Free-form reason captured for operator visibility.

Done

Terminal event: the turn has ended and no further events follow.

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.

impl Eq for TurnEvent

impl PartialEq for TurnEvent

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