Enum CodingCliEvent 

pub enum CodingCliEvent {
    RunStarted {
        run_id: CliRunId,
        vendor: CliVendorKind,
        model: Option<String>,
        session_id: Option<CliSessionId>,
    },
    SystemInit {
        tools: Vec<ToolDescriptorInit>,
        mcp_servers: Vec<McpServerInit>,
        plugins: Vec<String>,
    },
    AssistantTextDelta {
        text: String,
    },
    ToolCallStarted {
        tool_call_id: String,
        name: String,
        input: Value,
    },
    ToolCallFinished {
        tool_call_id: String,
        output: Option<Value>,
        error: Option<String>,
    },
    ApiRetry {
        attempt: u32,
        delay_ms: u64,
        reason: String,
    },
    Usage {
        input_tokens: u64,
        output_tokens: u64,
        cost_usd: Option<f64>,
    },
    RunFinished {
        reason: FinishReason,
        result_text: Option<String>,
    },
    RawVendorEvent {
        vendor: CliVendorKind,
        payload: Value,
    },
    Note {
        message: String,
        fields: BTreeMap<String, Value>,
    },
}

Normalized lifecycle events. Tagged enum — serializes as {"kind": "...", ...} so the web client can switch on kind.

Variants

RunStarted

The harness has spawned the CLI process. Emitted before any vendor-side events.

Fields

run_id: CliRunId

vendor: CliVendorKind

model: Option<String>

session_id: Option<CliSessionId>

SystemInit

The CLI’s system/init (or equivalent): tools loaded, MCP servers connected, plugins resolved.

Fields

tools: Vec<ToolDescriptorInit>

mcp_servers: Vec<McpServerInit>

plugins: Vec<String>

AssistantTextDelta

Streaming assistant text. Adapters emit one event per delta.

Fields

text: String

ToolCallStarted

CLI started a tool call.

Fields

tool_call_id: String

name: String

input: Value

ToolCallFinished

CLI’s tool call returned.

Fields

tool_call_id: String

output: Option<Value>

error: Option<String>

ApiRetry

Vendor reported a retryable API error.

Fields

attempt: u32

delay_ms: u64

reason: String

Usage

Token / cost accounting.

Fields

input_tokens: u64

output_tokens: u64

cost_usd: Option<f64>

RunFinished

Terminal event — process is done.

Fields

reason: FinishReason

result_text: Option<String>

RawVendorEvent

Pass-through for vendor-specific events the normalizer doesn’t yet map. Always safe to ignore in the UI.

Fields

vendor: CliVendorKind

payload: Value

Note

Free-form diagnostic message (parser warnings, etc.).

Fields

message: String

fields: BTreeMap<String, Value>

Trait Implementations

impl Clone for CodingCliEvent

fn clone(&self) -> CodingCliEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CodingCliEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CodingCliEvent

fn deserialize<__D>( __deserializer: __D, ) -> Result<CodingCliEvent, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CodingCliEvent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.