Enum RuntimeEventKind 

pub enum RuntimeEventKind {
    SessionStarted {
        session_id: String,
    },
    TurnStarted {
        turn_id: String,
    },
    AssistantDelta {
        text: String,
    },
    AssistantThinkingDelta {
        text: String,
    },
    ToolRequested(ToolInvocation),
    ApprovalRequired(ApprovalRequest),
    ApprovalResolved(ApprovalDecision),
    CapabilityRecorded(CapabilityLedgerEntry),
    QuestionRequired(QuestionRequest),
    QuestionResolved(QuestionResponse),
    PlanReviewRequired(PlanReviewRequest),
    PlanReviewResolved(PlanReviewResponse),
    SudoPasswordRequired(SudoPasswordRequest),
    ToolStarted(ToolInvocation),
    ToolCompleted(ToolResult),
    SubagentActivity {
        invocation_id: String,
        message: String,
    },
    SubagentTranscript {
        invocation_id: String,
        item: SubagentTranscriptItem,
    },
    HarnessTrace(Value),
    HarnessStopped {
        reason: String,
        message: String,
        tool_name: Option<String>,
    },
    PatchProposed(PatchProposal),
    ContextUpdated,
    TokensUpdated {
        input_tokens: u64,
        output_tokens: u64,
        cache_creation_tokens: u64,
        cache_read_tokens: u64,
    },
    SessionSaved {
        session_id: String,
    },
    SessionTitleUpdated {
        session_id: String,
        title: String,
    },
    TurnCompleted {
        turn_id: String,
        text: String,
    },
    SessionFinished {
        session_id: String,
    },
    MicroCompactApplied {
        messages_cleared: usize,
    },
    AutoCompactStarted,
    AutoCompactCompleted {
        tokens_saved: u64,
    },
    AutoCompactFailed {
        reason: String,
    },
    AutoDreamStarted {
        hours_since_last: u64,
        sessions_reviewed: usize,
    },
    AutoDreamCompleted {
        marked_stale: usize,
        duplicates_merged: usize,
        active_count: usize,
    },
    AutoDreamFailed {
        reason: String,
    },
    SetGoalRequested {
        objective: String,
        short_description: Option<String>,
        token_budget: Option<i64>,
    },
    GoalUpdated {
        session_id: String,
        goal_id: String,
        objective: String,
        short_description: Option<String>,
        status: GoalStatus,
        tokens_used: i64,
        token_budget: Option<i64>,
    },
    Error {
        message: String,
    },
    PlanProposed {
        session_id: String,
        title: String,
        steps: Vec<String>,
    },
    AgentModeChanged {
        session_id: String,
        mode: AgentMode,
    },
}

Discriminates the kind of runtime event emitted by the agent loop.

Variants cover the full session lifecycle from start through turn execution, tool invocation, approval flow, compaction, and error reporting.

Variants

SessionStarted

A new session has been created.

Fields

session_id: String

Unique identifier for the session.

TurnStarted

A new turn within the session has started.

Fields

turn_id: String

Unique identifier for the turn.

AssistantDelta

A streaming text delta from the assistant.

Fields

text: String

Incremental text content.

AssistantThinkingDelta

A streaming thinking/reasoning delta from the assistant.

Fields

text: String

Incremental thinking content.

ToolRequested(ToolInvocation)

The assistant has requested a tool invocation.

ApprovalRequired(ApprovalRequest)

A tool invocation requires user approval before execution.

ApprovalResolved(ApprovalDecision)

An approval request has been resolved (approved or denied).

CapabilityRecorded(CapabilityLedgerEntry)

A capability lifecycle event was recorded by the policy layer.

QuestionRequired(QuestionRequest)

The assistant has requested an interactive user choice.

QuestionResolved(QuestionResponse)

An interactive user choice has been resolved.

PlanReviewRequired(PlanReviewRequest)

Plan tool create is waiting for user review (blocks the turn).

PlanReviewResolved(PlanReviewResponse)

User finished plan review.

SudoPasswordRequired(SudoPasswordRequest)

Sudo password needed (no secret in event payload).

ToolStarted(ToolInvocation)

A tool invocation has begun execution.

ToolCompleted(ToolResult)

A tool invocation has completed.

SubagentActivity

A nested subagent emitted a transient UI activity update.

Fields

invocation_id: String

Parent subagent tool invocation id.

message: String

Human-readable description of the latest nested activity.

SubagentTranscript

A nested subagent emitted a transient transcript item for UI drill-down.

Fields

invocation_id: String

Parent subagent tool invocation id.

item: SubagentTranscriptItem

Transcript item to append for the active UI session.

HarnessTrace(Value)

A harness-level diagnostic trace (profile, message count, tool count).

HarnessStopped

The harness stopped a turn before another model iteration.

Fields

reason: String

Machine-readable stop reason.

message: String

Human-readable diagnostic.

tool_name: Option<String>

Tool involved in the stop, when applicable.

PatchProposed(PatchProposal)

A file patch has been proposed by the assistant.

ContextUpdated

The conversation context has been updated.

TokensUpdated

Token usage has been reported by the model provider.

Fields

input_tokens: u64

Number of input/prompt tokens consumed.

output_tokens: u64

Number of output/completion tokens produced.

cache_creation_tokens: u64

Number of tokens written to the prompt cache (Anthropic).

cache_read_tokens: u64

Number of tokens read from the prompt cache (Anthropic).

SessionSaved

The session has been persisted to disk.

Fields

session_id: String

Identifier of the saved session.

SessionTitleUpdated

Session display title was assigned or updated (provisional or model-named).

Fields

session_id: String

Identifier of the session.

title: String

New display title.

TurnCompleted

A turn has completed with a final text response.

Fields

turn_id: String

Identifier of the completed turn.

text: String

Final assistant text for the turn.

SessionFinished

The session has ended.

Fields

session_id: String

Identifier of the finished session.

MicroCompactApplied

Micro-compaction cleared stale read-only tool results from history.

Fields

messages_cleared: usize

Number of tool result messages that were cleared.

AutoCompactStarted

An automatic conversation compaction has started.

AutoCompactCompleted

An automatic conversation compaction has completed.

Fields

tokens_saved: u64

Estimated number of tokens saved by compaction.

AutoCompactFailed

An automatic conversation compaction has failed.

Fields

reason: String

Human-readable reason for the failure.

AutoDreamStarted

Auto-dream memory consolidation has started.

Fields

hours_since_last: u64

Hours since the last dream run.

sessions_reviewed: usize

Number of sessions reviewed.

AutoDreamCompleted

Auto-dream memory consolidation has completed.

Fields

marked_stale: usize

Memories marked stale.

duplicates_merged: usize

Duplicates merged.

active_count: usize

Active memories remaining.

AutoDreamFailed

Auto-dream memory consolidation has failed.

Fields

reason: String

Human-readable reason for the failure.

SetGoalRequested

The agent requested to set a goal via natural language.

Fields

objective: String

The objective text.

short_description: Option<String>

Optional short UI label.

token_budget: Option<i64>

Optional token budget.

GoalUpdated

Fields

session_id: String

The session this goal belongs to.

goal_id: String

Unique identifier for the goal.

objective: String

The objective text.

short_description: Option<String>

Optional short UI label.

status: GoalStatus

Current goal status.

tokens_used: i64

Tokens consumed so far.

token_budget: Option<i64>

Optional token budget.

Error

An error occurred during agent execution.

Fields

message: String

Human-readable error message.

PlanProposed

The agent proposed a plan in Plan mode. The UI should show a confirmation popup to implement or discard.

Fields

session_id: String

The session that proposed the plan.

title: String

Title/summary of the plan.

steps: Vec<String>

Ordered list of steps.

AgentModeChanged

The agent mode changed (e.g. Default → Plan or Plan → Default).

Fields

session_id: String

The session whose mode changed.

mode: AgentMode

The new mode.

Implementations

impl RuntimeEventKind

pub fn into_agent_event(self) -> Option<AgentEvent>

Converts this event kind into an AgentEvent if applicable.

Returns None for lifecycle-only events that have no direct agent-level counterpart (session/turn lifecycle, tool started, context updated).

Trait Implementations

impl Clone for RuntimeEventKind

fn clone(&self) -> RuntimeEventKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RuntimeEventKind

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RuntimeEventKind

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RuntimeEventKind

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

where __S: Serializer,

Serialize this value into the given Serde serializer.