Enum SessionEvent 

pub enum SessionEvent {
    RunStarted {
        run_id: String,
        goal: String,
        criteria: Vec<String>,
        agent_id: Option<String>,
        system_prompt: Option<String>,
    },
    LlmCompleted {
        turn: u32,
        message: Message,
        provider_replay: Option<ProviderReplay>,
    },
    ToolRequested {
        turn: u32,
        calls: Vec<ToolCall>,
    },
    ToolCompleted {
        turn: u32,
        results: Vec<ToolResult>,
    },
    Compressed {
        turn: u32,
        archived_seq_range: (u64, u64),
        action: Option<String>,
        summary: Option<String>,
        summary_tokens: Option<u32>,
        archive_ref: Option<String>,
        preserved_refs: Vec<String>,
    },
    PageOut {
        turn: u32,
        action: Option<String>,
        summary: Option<String>,
        tier_hint: Option<String>,
        message_count: u32,
    },
    PageIn {
        turn: u32,
        entry_count: u32,
    },
    LargeResultSpooled {
        turn: u32,
        call_id: String,
        tool: String,
        original_size: u32,
        preview_size: u32,
        spool_ref: Option<String>,
    },
    RunTerminal {
        reason: String,
        turns_used: u32,
        total_tokens: u64,
    },
    ToolArgumentRepaired {
        turn: u32,
        tool: String,
        original_arguments: String,
        repaired_arguments: String,
    },
    PermissionRequested {
        turn: u32,
        tool: String,
        arguments: String,
        reason: Option<String>,
    },
    PermissionResolved {
        turn: u32,
        approved: bool,
        responder: String,
    },
    ToolDenied {
        turn: u32,
        call_id: String,
        tool_name: String,
        reason: String,
    },
    CapabilityChanged {
        turn: u32,
        added: Vec<String>,
        removed: Vec<String>,
        change_kind: Option<String>,
        capability_id: Option<String>,
        version: Option<String>,
        mounted_by: Option<String>,
        mount_reason: Option<String>,
    },
    ContextRenewed {
        turn: u32,
        sprint: u32,
        handoff_ref: String,
    },
    Suspended {
        turn: u32,
        reason: String,
        pending_calls: Vec<String>,
    },
    Resumed {
        turn: u32,
        approved: Vec<String>,
        denied: Vec<String>,
    },
    ToolGated {
        turn: u32,
        call_id: String,
        tool: String,
        reason: String,
    },
    SignalDisposed {
        turn: u32,
        signal_id: String,
        disposition: String,
        queue_depth: u32,
    },
    BudgetExceeded {
        turn: u32,
        budget: String,
    },
    CheckpointTaken {
        turn: u32,
        history_len: u32,
    },
    Rollbacked {
        turn: u32,
        checkpoint_history_len: u32,
        reason: Option<RollbackReason>,
    },
    AgentProcessChanged {
        turn: u32,
        agent_id: String,
        parent_session_id: String,
        role: String,
        isolation: String,
        context_inheritance: String,
        state: String,
        permitted_capability_ids: Vec<String>,
        result_termination: Option<String>,
    },
    MilestoneAdvanced {
        turn: u32,
        phase_id: String,
        capabilities_unlocked: Vec<String>,
    },
    MilestoneBlocked {
        turn: u32,
        phase_id: String,
        reason: String,
    },
    MemoryWritten {
        turn: u32,
        memory_id: String,
        memory_kind: String,
        size_bytes: u32,
    },
    MemoryQueried {
        turn: u32,
        query_context: String,
        requested_k: usize,
        requires_async_response: bool,
    },
    MemoryValidationFailed {
        turn: u32,
        memory_id: String,
        error: String,
    },
    MemoryRetrievalResult {
        retrieval: MemoryRetrieval,
    },
}

Append-only session event kinds for the unified Agent OS Runtime.

Combines execution loop events with OS-level lifecycle control, capability manifest auditing, and governance gates.

Variants

RunStarted

Fields

run_id: String

goal: String

criteria: Vec<String>

agent_id: Option<String>

system_prompt: Option<String>

LlmCompleted

Fields

turn: u32

message: Message

provider_replay: Option<ProviderReplay>

ToolRequested

Fields

turn: u32

calls: Vec<ToolCall>

ToolCompleted

Fields

turn: u32

results: Vec<ToolResult>

Compressed

Fields

turn: u32

archived_seq_range: (u64, u64)

action: Option<String>

summary: Option<String>

summary_tokens: Option<u32>

archive_ref: Option<String>

preserved_refs: Vec<String>

PageOut

Working memory paged out for long-term storage (kernel page_out).

Fields

turn: u32

action: Option<String>

summary: Option<String>

tier_hint: Option<String>

message_count: u32

PageIn

Long-term entries injected into knowledge partition (SDK page_in).

Fields

turn: u32

entry_count: u32

LargeResultSpooled

Large tool result spooled to disk by the SDK (kernel Layer 1).

Fields

turn: u32

call_id: String

tool: String

original_size: u32

preview_size: u32

spool_ref: Option<String>

RunTerminal

Fields

reason: String

turns_used: u32

total_tokens: u64

ToolArgumentRepaired

Tool arguments automatically repaired under white-listed heuristics.

Fields

turn: u32

tool: String

original_arguments: String

repaired_arguments: String

PermissionRequested

Escalated permission gate requested for a tool, suspending current execution.

Fields

turn: u32

tool: String

arguments: String

reason: Option<String>

PermissionResolved

Permission decision resolved by the user or an automated policy engine.

Fields

turn: u32

approved: bool

responder: String

ToolDenied

Tool blocked monotonically by security governance policy or denial of consent.

Fields

turn: u32

call_id: String

tool_name: String

reason: String

CapabilityChanged

Model-visible capabilities dynamically updated (e.g., loading skills or mounting MCPs).

Fields

turn: u32

added: Vec<String>

removed: Vec<String>

change_kind: Option<String>

capability_id: Option<String>

version: Option<String>

mounted_by: Option<String>

mount_reason: Option<String>

ContextRenewed

Context reset and sprint rotated after a context boundary handoff.

Fields

turn: u32

sprint: u32

handoff_ref: String

Suspended

Execution paused (waiting for human-in-the-loop interaction or long-running tasks).

Fields

turn: u32

reason: String

pending_calls: Vec<String>

Resumed

Execution resumed.

Fields

turn: u32

approved: Vec<String>

denied: Vec<String>

ToolGated

Kernel governance gate: tool requires approval before execution.

Fields

turn: u32

call_id: String

tool: String

reason: String

SignalDisposed

In-kernel signal disposition (attention policy).

Fields

turn: u32

signal_id: String

disposition: String

queue_depth: u32

BudgetExceeded

Scheduler budget axis exhausted.

Fields

turn: u32

budget: String

CheckpointTaken

Checkpoint taken at the start of a turn transaction (before LLM call).

Fields

turn: u32

history_len: u32

Rollbacked

Transaction rollback indicating state was restored to a checkpoint.

Fields

turn: u32

checkpoint_history_len: u32

reason: Option<RollbackReason>

AgentProcessChanged

Kernel process table changed for a spawned sub-agent.

Fields

turn: u32

agent_id: String

parent_session_id: String

role: String

isolation: String

context_inheritance: String

state: String

permitted_capability_ids: Vec<String>

result_termination: Option<String>

MilestoneAdvanced

Milestone phase criteria passed — capabilities unlocked, phase advanced.

Fields

turn: u32

phase_id: String

capabilities_unlocked: Vec<String>

MilestoneBlocked

Milestone phase criteria not met — run continues without advancing the phase.

Fields

turn: u32

phase_id: String

reason: String

MemoryWritten

Memory entry written successfully (SDK → kernel acknowledgment).

Fields

turn: u32

memory_id: String

memory_kind: String

size_bytes: u32

MemoryQueried

Memory query request (kernel → SDK; SDK should respond asynchronously).

Fields

turn: u32

query_context: String

requested_k: usize

requires_async_response: bool

MemoryValidationFailed

Memory validation failed (kernel rejected a write request).

Fields

turn: u32

memory_id: String

error: String

MemoryRetrievalResult

Memory retrieval result (SDK → kernel via Resume or other async mechanism).

Fields

retrieval: MemoryRetrieval

Implementations

impl SessionEvent

pub fn kind_str(&self) -> &'static str

Event kind string (snake_case tag).

pub fn is_kernel_os_event(&self) -> bool

Whether this event is a kernel OS decision (replay ignores for message reconstruction).

Trait Implementations

impl Clone for SessionEvent

fn clone(&self) -> SessionEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SessionEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SessionEvent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SessionEvent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.