Enum KernelEvent 

pub enum KernelEvent {
    AgentCreated {
        id: AgentId,
        name: String,
    },
    AgentStarted {
        id: AgentId,
    },
    AgentStopped {
        id: AgentId,
    },
    AgentFailed {
        id: AgentId,
        error: String,
    },
    MessageReceived {
        from: AgentId,
        content: String,
    },
    SeedCreated {
        seed_id: Uuid,
    },
    EvaluationComplete {
        seed_id: Uuid,
        passed: bool,
    },
    PhaseStarted {
        session_id: String,
        phase: Phase,
    },
    PhaseCompleted {
        session_id: String,
        phase: Phase,
        result_summary: String,
    },
    AgentOutput {
        session_id: String,
        agent_id: AgentId,
        output: String,
    },
    ApprovalRequested {
        id: Uuid,
        action: String,
        resource: String,
        reason: String,
    },
    ApprovalResolved {
        id: Uuid,
        approved: bool,
    },
    MemoryStored {
        id: String,
        memory_type: String,
        source: String,
    },
    MemoryRecalled {
        query: String,
        count: usize,
    },
    AgentGroupCreated {
        group_id: Uuid,
        agent_count: usize,
    },
    AgentGroupMemberCompleted {
        group_id: Uuid,
        agent_id: Uuid,
        success: bool,
    },
    ProjectCreated {
        project_id: Uuid,
        name: String,
        source: String,
    },
    ProjectActivated {
        project_id: Uuid,
        name: String,
    },
    EvolutionStarted {
        seed_id: Uuid,
        new_seed_id: Uuid,
        iteration: u32,
    },
    EvolutionMaxReached {
        seed_id: Uuid,
        final_score: f64,
        iterations: u32,
    },
    ToolExecutionStarted {
        session_id: String,
        tool_name: String,
        tool_call_id: String,
        tool_args: Value,
    },
    ToolExecutionFinished {
        session_id: String,
        tool_call_id: String,
        tool_name: String,
        duration_ms: u64,
        is_error: bool,
        output_summary: String,
    },
    ToolExecutionProgress {
        session_id: String,
        tool_call_id: String,
        tool_name: String,
        progress: String,
        tab_id: Option<Uuid>,
        context: Option<Value>,
    },
    MemoryRecallUsed {
        session_id: String,
        query: String,
        count: usize,
        source: String,
    },
    TokenUsageUpdate {
        session_id: String,
        input_tokens: u64,
        output_tokens: u64,
    },
    ReasoningFragment {
        session_id: String,
        content: String,
        source: String,
    },
    CalendarEventCreated {
        uid: String,
        title: String,
        start: String,
        end: String,
    },
    CalendarEventUpdated {
        uid: String,
        title: String,
    },
    CalendarEventDeleted {
        uid: String,
        title: String,
    },
    EmailSent {
        subject: String,
        message_id: String,
        template_name: Option<String>,
    },
}

Events that flow through the kernel event bus.

Variants

AgentCreated

A new agent has been created.

Fields

id: AgentId

The new agent’s ID.

name: String

The agent’s name/goal.

AgentStarted

An agent has started executing.

Fields

id: AgentId

The agent’s ID.

AgentStopped

An agent has been stopped.

Fields

id: AgentId

The agent’s ID.

AgentFailed

An agent has encountered a failure.

Fields

id: AgentId

The agent’s ID.

error: String

Description of the error.

MessageReceived

A message has been received from an agent.

Fields

from: AgentId

The sending agent’s ID.

content: String

Message content.

SeedCreated

A new seed has been created.

Fields

seed_id: Uuid

The seed’s ID.

EvaluationComplete

An evaluation has completed.

Fields

seed_id: Uuid

The seed that was evaluated.

passed: bool

Whether the evaluation passed.

PhaseStarted

An Ouroboros phase has started.

Fields

session_id: String

The session this phase belongs to.

phase: Phase

The phase that started.

PhaseCompleted

An Ouroboros phase has completed.

Fields

session_id: String

The session this phase belongs to.

phase: Phase

The phase that completed.

result_summary: String

A brief summary of the result.

AgentOutput

An agent has produced output.

Fields

session_id: String

The session this output belongs to.

agent_id: AgentId

The agent’s ID.

output: String

The output content.

ApprovalRequested

A HitL approval request has been submitted.

Fields

id: Uuid

The approval request ID.

action: String

The action requiring approval.

resource: String

The resource involved.

reason: String

Reason for the request.

ApprovalResolved

A HitL approval has been resolved (approved or rejected).

Fields

id: Uuid

The approval request ID.

approved: bool

Whether it was approved (true) or rejected (false).

MemoryStored

A memory entry was stored.

Fields

id: String

Memory entry ID.

memory_type: String

Memory type label.

source: String

Source of the memory.

MemoryRecalled

Memories were recalled for a new session.

Fields

query: String

The recall query.

count: usize

Number of memories returned.

AgentGroupCreated

Multi-agent group created.

Fields

group_id: Uuid

The group’s ID.

agent_count: usize

Number of agents in the group.

AgentGroupMemberCompleted

An agent in a group completed.

Fields

group_id: Uuid

The group’s ID.

agent_id: Uuid

The agent’s ID.

success: bool

Whether the agent succeeded.

ProjectCreated

A new Project has been created (RFC-011).

Fields

project_id: Uuid

The project’s ID.

name: String

The project’s name.

source: String

How it was created.

ProjectActivated

A Project has been activated (RFC-011).

Fields

project_id: Uuid

The project’s ID.

name: String

The project’s name.

EvolutionStarted

Evolution has started (evaluate → evolve → re-execute loop).

Fields

seed_id: Uuid

Seed ID before evolution.

new_seed_id: Uuid

Seed ID after evolution.

iteration: u32

Current iteration (0-based).

EvolutionMaxReached

Evolution loop reached max iterations.

Fields

seed_id: Uuid

The final seed ID.

final_score: f64

Final evaluation score.

iterations: u32

Number of iterations completed.

ToolExecutionStarted

A tool execution has started (real-time, RFC-015).

Fields

session_id: String

Session this tool call belongs to.

tool_name: String

Name of the tool (e.g. “read_file”, “bash”, “memory_recall”).

tool_call_id: String

Provider-specific tool call ID used to correlate start/end.

tool_args: Value

Tool input arguments (JSON).

ToolExecutionFinished

A tool execution has finished (real-time, RFC-015).

Fields

session_id: String

Session this tool call belongs to.

tool_call_id: String

Provider-specific tool call ID.

tool_name: String

Name of the tool.

duration_ms: u64

Wall-clock duration in milliseconds.

is_error: bool

Whether the tool returned an error.

output_summary: String

Truncated output (max ~500 chars) for streaming.

ToolExecutionProgress

A tool execution emitted a progress update (real-time, RFC-015).

Fields

session_id: String

Session this tool call belongs to.

tool_call_id: String

Provider-specific tool call ID.

tool_name: String

Name of the tool.

progress: String

Human-readable progress text (already-formatted by the tool).

tab_id: Option<Uuid>

Tab that emitted this progress event, if the upstream tool tracks tabs. None for tools that don’t have a tab concept (e.g. legacy oxi-agent versions that don’t propagate tab_id).

context: Option<Value>

Semantic context from the tool call (e.g. PageVisit, WebSearch). Stored as serde_json::Value to decouple kernel events from oxi-sdk’s internal ToolCallContext enum. UI consumers that understand a context variant render it richly; older consumers simply ignore the field.

MemoryRecallUsed

Memory was recalled during agent execution (RFC-015).

Fields

session_id: String

Session this recall belongs to.

query: String

The recall query.

count: usize

Number of memories returned.

source: String

Memory tier source (“hot” | “warm” | “cold”).

TokenUsageUpdate

Token usage update (RFC-015).

Fields

session_id: String

Session this usage belongs to.

input_tokens: u64

Cumulative input tokens.

output_tokens: u64

Cumulative output tokens.

ReasoningFragment

Reasoning/compaction fragment (RFC-015).

Fields

session_id: String

Session this fragment belongs to.

content: String

The fragment text (chain-of-thought, compaction summary, etc).

source: String

Source label: “chain_of_thought” | “compaction” | “reflection”.

CalendarEventCreated

A calendar event was created.

Fields

uid: String

Event UID.

title: String

Event title.

start: String

Start time.

end: String

End time.

CalendarEventUpdated

A calendar event was updated.

Fields

uid: String

Event UID.

title: String

Event title.

CalendarEventDeleted

A calendar event was deleted.

Fields

uid: String

Event UID.

title: String

Event title.

EmailSent

An email has been sent.

Fields

subject: String

Email subject.

message_id: String

SMTP message ID.

template_name: Option<String>

Template name (if template was used/saved).

Trait Implementations

impl Clone for KernelEvent

fn clone(&self) -> KernelEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for KernelEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for KernelEvent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for KernelEvent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.