Enum UiEvent 

pub enum UiEvent {
    AssistantPartial {
        text: String,
    },
    AssistantMessage {
        content: String,
    },
    ToolCall {
        id: String,
        name: String,
        arguments: String,
    },
    ToolResult {
        id: String,
        name: String,
        output: String,
        success: bool,
    },
    Usage {
        input_tokens: u64,
        output_tokens: u64,
    },
    Reasoning {
        content: String,
    },
    Latency {
        llm_ms: u64,
    },
    Compacted {
        removed: usize,
        kept: usize,
    },
    TurnFinished,
    Error {
        message: String,
    },
    PlanProposed {
        plan_text: String,
        tool_calls: Vec<Value>,
    },
    PlanConfirmed,
    PlanRejected {
        reason: String,
    },
    PlanModeRequested {
        reason: String,
    },
    PlanModeApproved,
    PlanModeRejected {
        reason: String,
    },
    TodoUpdated {
        todos: Vec<TodoItem>,
    },
    GoalContinuing {
        reason: String,
        turns: u32,
    },
    GoalAchieved {
        condition: String,
        turns: u32,
    },
    GoalCleared,
    Interrupted,
    SessionResumed {
        session_id: String,
        turn_count: usize,
    },
    McpServersLoaded {
        entries: Vec<McpEntry>,
    },
    HookStarted {
        hook_event: String,
        hook_name: String,
        status_message: Option<String>,
    },
    HookProgress {
        hook_event: String,
        hook_name: String,
        last_line: String,
    },
    HookFinished {
        hook_event: String,
        hook_name: String,
        outcome: String,
        duration_ms: u64,
    },
    HookSystemMessage {
        text: String,
    },
}

Events bubbled up from the backend worker into the UI loop.

Variants

AssistantPartial

A streamed partial token chunk to append to the in-flight assistant message.

Fields

text: String

AssistantMessage

A completed assistant message (non-streaming providers, or the final flush after PartialToken chunks).

Fields

content: String

ToolCall

Model requested to execute a tool. Carries the call id so the matching UiEvent::ToolResult can pair up.

Fields

id: String

name: String

arguments: String

ToolResult

Tool finished executing. id matches the originating UiEvent::ToolCall.

Fields

id: String

name: String

output: String

success: bool

Usage

Token usage for the latest LLM call.

Fields

input_tokens: u64

output_tokens: u64

Reasoning

Reasoning / thinking content produced by the model for the current step (DeepSeek R1, OpenAI o1, …). Carries the full reasoning text; the TUI renders it as a thinking… block above the corresponding assistant message. Steps that did not produce reasoning never emit this event.

Fields

content: String

Latency

Latency (ms) of the latest LLM call.

Fields

llm_ms: u64

Compacted

Transcript compaction notification.

Fields

removed: usize

kept: usize

TurnFinished

Marks the end of a turn so the UI can stop the spinner.

Error

A non-fatal error worth surfacing to the user.

Fields

message: String

PlanProposed

Goal-147: structured plan proposal from the runtime (AgentEvent::PlanProposed). The UI opens a Modal::PlanReview over the chat screen and freezes input until the user approves / rejects / edits.

tool_calls carries the pending tool calls as JSON values — each one has name, id, and arguments fields, mirroring the kernel’s serialised StepEvent::PlanProposed payload.

Fields

plan_text: String

tool_calls: Vec<Value>

PlanConfirmed

Goal-147: the runtime accepted the plan and resumed execution. Closes any open Modal::PlanReview and pushes a System block.

PlanRejected

Goal-147: the runtime rejected (or had its plan rejected) with a free-form reason. Same UI handling as PlanConfirmed plus the reason in the System block.

Fields

reason: String

PlanModeRequested

Goal-202: agent called request_plan_mode; user should approve or skip.

Fields

reason: String

PlanModeApproved

Goal-202: user approved the plan-mode entry request.

PlanModeRejected

Goal-202: user rejected the plan-mode entry request.

Fields

reason: String

TodoUpdated

Goal-167: the agent updated its task list via todo_write. Carries the complete replacement list so the UI can re-render without a diff.

Fields

todos: Vec<TodoItem>

GoalContinuing

Goal loop is running; the judge found the condition not yet met.

Fields

reason: String

turns: u32

GoalAchieved

Goal loop completed — condition confirmed met.

Fields

condition: String

turns: u32

GoalCleared

Active goal was cleared (budget exceeded, /goal clear, or API).

Interrupted

The current turn was aborted by the user (Esc/Ctrl+C). The backend cancelled the in-flight LLM request via JoinHandle::abort() and truncated the transcript back to the pre-turn state.

SessionResumed

A previous session was successfully loaded into the runtime. The UI should clear the in-progress transcript and show a System block.

Fields

session_id: String

turn_count: usize

McpServersLoaded

MCP server list loaded from the workspace config.

Fields

entries: Vec<McpEntry>

HookStarted

A hook started executing.

Fields

hook_event: String

hook_name: String

status_message: Option<String>

HookProgress

A hook produced incremental output (last stdout line).

Fields

hook_event: String

hook_name: String

last_line: String

HookFinished

A hook finished executing.

Fields

hook_event: String

hook_name: String

outcome: String

duration_ms: u64

HookSystemMessage

The hook produced a system message to surface to the user.

Fields

text: String

Trait Implementations

impl Clone for UiEvent

fn clone(&self) -> UiEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UiEvent

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

Formats the value using the given formatter.

impl Eq for UiEvent

impl PartialEq for UiEvent

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