Enum ExtensionEvent 

pub enum ExtensionEvent {
    Startup {
        version: String,
        session_file: Option<String>,
    },
    AgentStart {
        session_id: String,
    },
    AgentEnd {
        session_id: String,
        messages: Vec<Message>,
        error: Option<String>,
    },
    TurnStart {
        session_id: String,
        turn_index: usize,
    },
    TurnEnd {
        session_id: String,
        turn_index: usize,
        message: AssistantMessage,
        tool_results: Vec<ToolResultMessage>,
    },
    ToolCall {
        tool_name: String,
        tool_call_id: String,
        input: Value,
    },
    ToolResult {
        tool_name: String,
        tool_call_id: String,
        input: Value,
        content: Vec<ContentBlock>,
        details: Option<Value>,
        is_error: bool,
    },
    SessionBeforeSwitch {
        current_session: Option<String>,
        target_session: String,
    },
    SessionBeforeFork {
        current_session: Option<String>,
        fork_entry_id: String,
    },
    Input {
        content: String,
        attachments: Vec<ImageContent>,
    },
}

Events that can be dispatched to extension handlers.

The serialized representation is tagged with type in snake_case, matching the string event name used by JS hooks (e.g. "tool_call").

Variants

Startup

Agent startup (once per session).

Fields

version: String

session_file: Option<String>

AgentStart

Before first API call in a run.

Fields

session_id: String

AgentEnd

After agent loop ends.

Fields

session_id: String

messages: Vec<Message>

error: Option<String>

TurnStart

Before provider.stream() call.

Fields

session_id: String

turn_index: usize

TurnEnd

After response processed.

Fields

session_id: String

turn_index: usize

message: AssistantMessage

tool_results: Vec<ToolResultMessage>

ToolCall

Before tool execution (can block).

Fields

tool_name: String

tool_call_id: String

input: Value

ToolResult

After tool execution (can modify result).

Fields

tool_name: String

tool_call_id: String

input: Value

content: Vec<ContentBlock>

details: Option<Value>

is_error: bool

SessionBeforeSwitch

Before session switch (can cancel).

Fields

current_session: Option<String>

target_session: String

SessionBeforeFork

Before session fork (can cancel).

Fields

current_session: Option<String>

fork_entry_id: String

Input

Before processing user input (can transform).

Fields

content: String

attachments: Vec<ImageContent>

Implementations

impl ExtensionEvent

pub const fn event_name(&self) -> &'static str

Get the event name for dispatch.

Trait Implementations

impl Clone for ExtensionEvent

fn clone(&self) -> ExtensionEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExtensionEvent

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

Formats the value using the given formatter.

impl Serialize for ExtensionEvent

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.