Enum RuntimeEvent 

pub enum RuntimeEvent {
    ToolCallStart {
        tool_name: String,
        call_id: String,
        timestamp_ms: u64,
    },
    ToolCallEnd {
        tool_name: String,
        call_id: String,
        duration_ms: u64,
        success: bool,
        timestamp_ms: u64,
    },
    LlmRequestStart {
        model: String,
        request_id: String,
        timestamp_ms: u64,
    },
    LlmResponseEnd {
        model: String,
        request_id: String,
        input_tokens: u64,
        output_tokens: u64,
        duration_ms: u64,
        timestamp_ms: u64,
    },
    AgentStart {
        agent_id: String,
        task: String,
        timestamp_ms: u64,
    },
    AgentEnd {
        agent_id: String,
        success: bool,
        timestamp_ms: u64,
    },
    AgentError {
        agent_id: String,
        error: String,
        timestamp_ms: u64,
    },
    SessionStart {
        session_id: String,
        timestamp_ms: u64,
    },
    SessionEnd {
        session_id: String,
        timestamp_ms: u64,
    },
    SessionStatusChanged {
        session_id: String,
        status: SessionStatus,
        timestamp_ms: u64,
    },
    TokenUsage {
        model: String,
        input_tokens: u64,
        output_tokens: u64,
        cost_usd: f64,
        timestamp_ms: u64,
    },
    BudgetExhausted {
        budget_usd: f64,
        total_cost_usd: f64,
        timestamp_ms: u64,
    },
    ConfigReloaded {
        timestamp_ms: u64,
    },
    ShutdownRequested {
        reason: String,
        timestamp_ms: u64,
    },
    Custom {
        event_type: String,
        source: String,
        data: Value,
        timestamp_ms: u64,
    },
}

A strongly-typed event published on the bus.

Each variant carries only the data relevant to that event kind, replacing the previous stringly-typed Event struct.

Variants

ToolCallStart

A tool call is about to start.

Fields

tool_name: String

call_id: String

timestamp_ms: u64

ToolCallEnd

A tool call completed.

Fields

tool_name: String

call_id: String

duration_ms: u64

success: bool

timestamp_ms: u64

LlmRequestStart

An LLM request was sent.

Fields

model: String

request_id: String

timestamp_ms: u64

LlmResponseEnd

An LLM response was received.

Fields

model: String

request_id: String

input_tokens: u64

output_tokens: u64

duration_ms: u64

timestamp_ms: u64

AgentStart

An agent started working.

Fields

agent_id: String

task: String

timestamp_ms: u64

AgentEnd

An agent finished.

Fields

agent_id: String

success: bool

timestamp_ms: u64

AgentError

An agent encountered an error.

Fields

agent_id: String

error: String

timestamp_ms: u64

SessionStart

Session started.

Fields

session_id: String

timestamp_ms: u64

SessionEnd

Session ended.

Fields

session_id: String

timestamp_ms: u64

SessionStatusChanged

Session status changed (idle -> busy -> retry -> idle).

Fields

session_id: String

status: SessionStatus

timestamp_ms: u64

TokenUsage

Token usage was recorded.

Fields

model: String

input_tokens: u64

output_tokens: u64

cost_usd: f64

timestamp_ms: u64

BudgetExhausted

Session cost budget has been exhausted.

Published when [CostTracker::is_over_budget] returns true after recording token usage. The agent loop should pause and notify the user.

Fields

budget_usd: f64

total_cost_usd: f64

timestamp_ms: u64

ConfigReloaded

Configuration was reloaded.

Fields

timestamp_ms: u64

ShutdownRequested

Graceful shutdown requested.

Fields

reason: String

timestamp_ms: u64

Custom

Escape hatch for events not covered by the typed variants.

Fields

event_type: String

source: String

data: Value

timestamp_ms: u64

Implementations

impl RuntimeEvent

pub fn topic(&self) -> EventTopic

Return the EventTopic for this event.

pub fn timestamp_ms(&self) -> u64

Return the timestamp in milliseconds since epoch.

Trait Implementations

impl Clone for RuntimeEvent

fn clone(&self) -> RuntimeEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RuntimeEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RuntimeEvent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RuntimeEvent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.