Enum RuntimeEvent 

pub enum RuntimeEvent {
    TextDelta {
        session_id: SessionId,
        text: String,
        agent_id: Option<String>,
        trace_id: Option<String>,
    },
    ThoughtDelta {
        session_id: SessionId,
        text: String,
        agent_id: Option<String>,
        trace_id: Option<String>,
    },
    ToolCallStarted {
        session_id: SessionId,
        tool_name: String,
        args_json: String,
        agent_id: Option<String>,
        trace_id: Option<String>,
    },
    ToolCallFinished {
        session_id: SessionId,
        tool_name: String,
        summary: String,
        agent_id: Option<String>,
        trace_id: Option<String>,
    },
    AwaitingApproval {
        session_id: SessionId,
        request: ApprovalRequest,
        agent_id: Option<String>,
        trace_id: Option<String>,
    },
    Checkpoint {
        session_id: SessionId,
        checkpoint: CheckpointData,
        agent_id: Option<String>,
        trace_id: Option<String>,
    },
    RunFinished {
        session_id: SessionId,
        agent_id: Option<String>,
        trace_id: Option<String>,
    },
    RunCancelled {
        session_id: SessionId,
        agent_id: Option<String>,
        trace_id: Option<String>,
    },
    PlanUpdated {
        session_id: SessionId,
        objective: String,
        explanation: Option<String>,
        plan: Vec<PlanItem>,
        agent_id: Option<String>,
        trace_id: Option<String>,
    },
    UserEvent {
        session_id: SessionId,
        event: UserEvent,
        agent_id: Option<String>,
        trace_id: Option<String>,
    },
}

Unified runtime event — the single event type for both internal and external consumers (frontends, CLIs, tests).

Variants

TextDelta

Fields

session_id: SessionId

text: String

agent_id: Option<String>

Identifies the agent that produced this event (root / sub-agent path).

trace_id: Option<String>

Distributed tracing context carried across systems (e.g. MCP caller → phi-agent).

ThoughtDelta

Fields

session_id: SessionId

text: String

agent_id: Option<String>

trace_id: Option<String>

ToolCallStarted

Fields

session_id: SessionId

tool_name: String

args_json: String

agent_id: Option<String>

trace_id: Option<String>

ToolCallFinished

Fields

session_id: SessionId

tool_name: String

summary: String

agent_id: Option<String>

trace_id: Option<String>

AwaitingApproval

Fields

session_id: SessionId

request: ApprovalRequest

agent_id: Option<String>

trace_id: Option<String>

Checkpoint

Fields

session_id: SessionId

checkpoint: CheckpointData

agent_id: Option<String>

trace_id: Option<String>

RunFinished

Fields

session_id: SessionId

agent_id: Option<String>

trace_id: Option<String>

RunCancelled

Fields

session_id: SessionId

agent_id: Option<String>

trace_id: Option<String>

PlanUpdated

Fields

session_id: SessionId

objective: String

explanation: Option<String>

plan: Vec<PlanItem>

agent_id: Option<String>

trace_id: Option<String>

UserEvent

A user-space event produced by a tool.

Fields

session_id: SessionId

event: UserEvent

agent_id: Option<String>

trace_id: Option<String>

Implementations

impl RuntimeEvent

pub fn session_id(&self) -> &SessionId

Get the session ID associated with this event.

pub fn agent_id(&self) -> Option<&str>

Get the agent ID associated with this event, if any.

pub fn trace_id(&self) -> Option<&str>

Get the trace ID associated with this event, if any.

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.