Enum AgentEvent 

pub enum AgentEvent {
    Chunk(String),
    FullMessage(String),
    Flush,
    Typing,
    Status(String),
    ToolStart {
        tool_name: ToolName,
        command: String,
    },
    ToolOutputChunk {
        tool_name: ToolName,
        command: String,
        chunk: String,
    },
    ToolOutput {
        tool_name: ToolName,
        command: String,
        output: String,
        success: bool,
        diff: Option<DiffData>,
        filter_stats: Option<String>,
        kept_lines: Option<Vec<usize>>,
    },
    ConfirmRequest {
        prompt: String,
        response_tx: Sender<bool>,
    },
    ElicitationRequest {
        request: ElicitationRequest,
        response_tx: Sender<ElicitationResponse>,
    },
    QueueCount(usize),
    DiffReady(DiffData),
    CommandResult {
        command_id: String,
        output: String,
    },
    SetCancelSignal(Arc<Notify>),
    SetMetricsRx(Receiver<MetricsSnapshot>),
}

Events produced by the agent and forwarded to the TUI via crate::TuiChannel.

Each variant corresponds to a distinct phase or signal in the agent lifecycle (streaming output, tool execution, user confirmation, etc.).

Examples

use zeph_tui::event::AgentEvent;

let ev = AgentEvent::Chunk("partial response".to_string());
assert!(matches!(ev, AgentEvent::Chunk(_)));

Variants

Chunk(String)

A streaming text chunk from the LLM — appended to the current message.

FullMessage(String)

A complete (non-streaming) assistant message.

Flush

Signals that streaming is complete; the chat widget stops the cursor.

Typing

The agent is waiting for an LLM response (drives the throbber).

Status(String)

A short status string to display in the activity bar (e.g. "Searching memory…").

ToolStart

A tool call has started; the TUI should display a spinner with the tool name.

Fields

tool_name: ToolName

Canonical tool name (e.g. "bash", "read_file").

command: String

The primary command or argument string shown in the status bar.

ToolOutputChunk

An incremental output chunk from a long-running tool (e.g. streaming shell output).

Fields

tool_name: ToolName

Tool that produced the chunk.

command: String

Command argument associated with the tool call.

chunk: String

The chunk text to append.

ToolOutput

Final tool output, replacing any in-progress chunks for this call.

Fields

tool_name: ToolName

Tool that produced the output.

command: String

Command argument associated with the tool call.

output: String

Full rendered output body.

success: bool

true if the tool succeeded, false on error.

diff: Option<DiffData>

Optional diff to display inline in the chat.

filter_stats: Option<String>

Human-readable filter summary, if output was filtered.

kept_lines: Option<Vec<usize>>

Indices of lines retained by the filter.

ConfirmRequest

The agent requests a boolean confirmation from the user.

Fields

prompt: String

Prompt text shown in the confirmation dialog.

response_tx: Sender<bool>

One-shot channel to send the user’s true/false response.

ElicitationRequest

The agent requests structured input via an elicitation dialog.

Fields

request: ElicitationRequest

The elicitation schema and prompt.

response_tx: Sender<ElicitationResponse>

One-shot channel to send the user’s response.

QueueCount(usize)

Updated count of messages queued for the agent (shown in the input bar).

DiffReady(DiffData)

A diff is ready for immediate display in the diff panel.

CommandResult

Result from a slash-command dispatched to the agent.

Fields

command_id: String

The slash-command identifier that produced this result.

output: String

Formatted command output to display.

SetCancelSignal(Arc<Notify>)

Wire a cancel signal into the TUI App after early startup (Phase 2).

SetMetricsRx(Receiver<MetricsSnapshot>)

Wire a metrics receiver into the TUI App after early startup (Phase 2).

Trait Implementations

impl Debug for AgentEvent

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

Formats the value using the given formatter.