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>,
        edit: Option<ProposedEditDiff>,
    },
    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.

edit: Option<ProposedEditDiff>

The edit this permission would authorise, when the agent described one.

An agent that asks before editing is an agent whose edits can be reviewed, so this is what turns an “allow?” prompt into a diff (ADR-0016 §1).

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

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