Enum AgentEvent 

pub enum AgentEvent {
    Ready {
        capabilities: AgentCapabilities,
    },
    SessionStarted {
        session: SessionId,
    },
    ModesAvailable {
        session: SessionId,
        current: String,
        available: Vec<SessionMode>,
    },
    ModeChanged {
        session: SessionId,
        mode: String,
    },
    MessageChunk {
        session: SessionId,
        text: String,
    },
    ThoughtChunk {
        session: SessionId,
        text: String,
    },
    ReadFileRequested {
        session: SessionId,
        request: ReadRequestId,
        path: PathBuf,
    },
    ProposedEdit {
        session: SessionId,
        proposal: ProposalId,
        path: PathBuf,
        old_text: Option<String>,
        new_text: String,
    },
    PermissionRequested {
        session: SessionId,
        request: PermissionRequestId,
        summary: String,
        command: Vec<String>,
        terminal_spec: Option<TerminalSpec>,
    },
    TerminalRequest {
        session: SessionId,
        request: AgentTerminalRequestId,
        operation: AgentTerminalOperation,
    },
    TerminalAttached {
        session: SessionId,
        terminal: TerminalId,
    },
    TurnEnded {
        session: SessionId,
        reason: StopReason,
    },
    Failed {
        session: SessionId,
        message: String,
    },
}

What comes back from the agent.

Exhaustive on purpose, like FsEvent: adding a variant should break every loop that has not decided what to do about it.

Variants

Ready

The handshake completed. Emitted once, before any session, so it carries no SessionId — capabilities belong to the agent connection, not to a session.

Fields

capabilities: AgentCapabilities

SessionStarted

Fields

session: SessionId

ModesAvailable

What the agent will let this session do, and which of those it started in (ADR-0015). Absent for agents that do not offer modes, which is most of them.

Fields

session: SessionId

current: String

available: Vec<SessionMode>

ModeChanged

The agent reports the session is now in mode. The agent’s account is the truth, so this is what updates the client — not the response to our own request.

Fields

session: SessionId

mode: String

MessageChunk

Streamed assistant text.

Fields

session: SessionId

text: String

ThoughtChunk

Streamed reasoning, rendered dimmer than the answer.

Fields

session: SessionId

text: String

ReadFileRequested

The agent asked us for a file. We answer from the buffer if it is open.

Fields

session: SessionId

request: ReadRequestId

path: PathBuf

ProposedEdit

A proposed edit, as whole-file before/after text — the shape ACP actually uses. old_text is None when the agent is creating a new file.

Fields

session: SessionId

proposal: ProposalId

path: PathBuf

old_text: Option<String>

new_text: String

PermissionRequested

A tool call awaiting approval. command is an argv array — we never interpolate agent output into a shell string (ARCHITECTURE.md §9.4, §11).

Fields

session: SessionId

request: PermissionRequestId

summary: String

command: Vec<String>

terminal_spec: Option<TerminalSpec>

Present only when raw ACP input supplied an exact structured command.

TerminalRequest

Fields

session: SessionId

request: AgentTerminalRequestId

operation: AgentTerminalOperation

TerminalAttached

Fields

session: SessionId

terminal: TerminalId

TurnEnded

Fields

session: SessionId

reason: StopReason

Failed

Fields

session: SessionId

message: String

Trait Implementations

impl Clone for AgentEvent

fn clone(&self) -> AgentEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentEvent

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

Formats the value using the given formatter.

impl Eq for AgentEvent

impl PartialEq for AgentEvent

fn eq(&self, other: &AgentEvent) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for AgentEvent