Enum AgentEvent 

pub enum AgentEvent {
    PermissionRequested {
        proposal: Box<Proposal>,
        raw: Value,
    },
    PermissionResponded {
        request_id: String,
        delivery: Delivery,
        raw: Value,
    },
    Init {
        session_id: String,
        model: String,
        raw: Value,
    },
    Text {
        text: String,
        raw: Value,
    },
    ToolUse {
        tool: String,
        summary: String,
        raw: Value,
    },
    ToolResult {
        tool: Option<String>,
        denied: bool,
        summary: String,
        raw: Value,
    },
    Result {
        text: String,
        is_error: bool,
        usage: TokenUsage,
        cost_usd: Option<f64>,
        num_turns: Option<u32>,
        raw: Value,
    },
    Other {
        raw: Value,
    },
}

Normalized events surfaced from a session’s output stream.

raw always carries the full original stream-json line for transcript fidelity; the variants extract only what the engine acts on.

Variants

PermissionRequested

A live one-call request. It cannot be answered through a user message.

Fields

proposal: Box<Proposal>

raw: Value

PermissionResponded

Transport receipt, distinct from the tool’s eventual effect.

Fields

request_id: String

delivery: Delivery

raw: Value

Init

First message of a session (type: "system", subtype: "init").

Fields

session_id: String

model: String

raw: Value

Text

Assistant text output.

Fields

text: String

raw: Value

ToolUse

Assistant requested a tool.

Fields

tool: String

summary: String

Compact human-readable summary of the input (e.g. the Bash command).

raw: Value

ToolResult

Tool result returned to the model. denied is true when the call was blocked by permission rules — surfaced so the dashboard shows guardrails firing (§4.7).

Fields

tool: Option<String>

denied: bool

summary: String

raw: Value

Result

Terminal result (type: "result"). Exactly one per completed turn in single-shot mode; in streaming mode one per injected turn.

Fields

text: String

Final result text (worker report JSON lives here when –json-schema was set).

is_error: bool

usage: TokenUsage

cost_usd: Option<f64>

Cost attributable to this result, not a cumulative session total.

num_turns: Option<u32>

raw: Value

Other

Anything else (kept for transcripts; engine ignores).

Fields

raw: Value

Trait Implementations

impl Clone for AgentEvent

fn clone(&self) -> Self

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<'de> Deserialize<'de> for AgentEvent

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AgentEvent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.