Enum Event 

pub enum Event {
    RunStarted {

        schema: u32,
        basis: String,
        session_id: String,
        workspace: PathBuf,
        model: String,
        provider: String,
        context_files: Vec<ContextFile>,
        skills_dirs: Vec<PathBuf>,
        skills: Vec<SkillSummary>,
        templates_dirs: Vec<PathBuf>,
        templates: Vec<TemplateSummary>,
        mcp_files: Vec<ContextFile>,
        mcp_servers: Vec<String>,
    
},
    UserMessage {
        text: String,
    },
    AssistantDelta {
        text: String,
    },
    AssistantReasoningDelta {
        text: String,
    },
    AssistantMessage {
        text: String,
    },
    ToolQueued {
        tool_call_id: String,
        tool_name: String,
        summary: String,
        mutability: Mutability,
        input: Value,
    },
    ToolStarted {
        tool_call_id: String,
        tool_name: String,
    },
    ToolProgress {
        tool_call_id: String,
        tool_name: String,
        progress: String,
    },
    ToolCompleted {
        tool_call_id: String,
        tool_name: String,
        summary: String,
        is_error: bool,
    },
    PermissionRequested {
        request_id: String,
        tool_call_id: String,
        tool_name: String,
        description: String,
        preview: Value,
    },
    PermissionResolved {
        request_id: String,
        tool_call_id: String,
        tool_name: String,
        outcome: PermissionOutcome,
        rule_scope: Option<RuleScope>,
    },
    TaskUpdated {
        task_id: String,
        kind: TaskKind,
        status: TaskStatus,
        title: String,
        detail: Option<String>,
    },
    CompactionStarted {
        agent_id: String,
    },
    CompactionCompleted {
        agent_id: String,
        replaced_items: usize,
        preserved_items: usize,
        transcript_len: usize,
        extracted_facts: usize,
        summary_preview: String,
    },
    MemoryUpdated {
        agent_id: String,
        stored_records: usize,
    },
    Usage {
        agent_id: String,
        input_tokens: u64,
        output_tokens: u64,
        cache_read_tokens: u64,
        cache_creation_tokens: u64,
    },
    Notice {
        severity: NoticeSeverity,
        message: String,
    },
    Retry {
        agent_id: String,
        error: String,
        attempt: u32,
        max_attempts: u32,
        next_delay_ms: u64,
    },
    Error {
        message: String,
        recoverable: bool,
    },
    Branched {
        entry_id: String,
        abandoned_entries: usize,
    },
    RunFinished {
        outcome: RunOutcome,
        stopped_by: Option<Bound>,
    },
}

Everything that can appear on the stream.

RunStarted and RunFinished are basis’s own bookends; the rest are normalized from mentra’s SessionEvent.

Variants

RunStarted

Always the first line. Carries the schema version.

Fields

schema: u32

basis: String

session_id: String

workspace: PathBuf

model: String

provider: String

context_files: Vec<ContextFile>

Context files discovered for this run, weakest precedence first.

skills_dirs: Vec<PathBuf>

Skills directories in effect, most specific first. Omitted rather than empty so a stream without skills stays quiet about them.

skills: Vec<SkillSummary>

The skills those directories produced, after layering — what the model can actually load by name.

templates_dirs: Vec<PathBuf>

Template directories in effect, most specific first.

templates: Vec<TemplateSummary>

The templates those directories produced, after layering — what a client can offer as commands.

mcp_files: Vec<ContextFile>

MCP configuration files in effect, weakest precedence first.

Named for the same reason context files are, and more urgently: an .mcp.json says which programs to spawn and carries the credentials to spawn them with, so it is the last thing that should take effect without appearing anywhere.

mcp_servers: Vec<String>

The servers those files produced, after layering. Names only — commands, arguments, and environment stay out of the stream, which is the same no-echo rule McpError follows.

UserMessage

Fields

text: String

AssistantDelta

Fields

text: String

AssistantReasoningDelta

Fields

text: String

AssistantMessage

Fields

text: String

ToolQueued

Fields

tool_call_id: String

tool_name: String

summary: String

mutability: Mutability

input: Value

Parsed tool input when it is valid JSON, else the raw string.

ToolStarted

Fields

tool_call_id: String

tool_name: String

ToolProgress

Fields

tool_call_id: String

tool_name: String

progress: String

ToolCompleted

Fields

tool_call_id: String

tool_name: String

summary: String

is_error: bool

PermissionRequested

Fields

request_id: String

tool_call_id: String

tool_name: String

description: String

preview: Value

Parsed preview when it is valid JSON, else the raw string.

PermissionResolved

Fields

request_id: String

tool_call_id: String

tool_name: String

outcome: PermissionOutcome

rule_scope: Option<RuleScope>

TaskUpdated

Fields

task_id: String

kind: TaskKind

status: TaskStatus

title: String

detail: Option<String>

CompactionStarted

Fields

agent_id: String

CompactionCompleted

Fields

agent_id: String

replaced_items: usize

preserved_items: usize

transcript_len: usize

extracted_facts: usize

summary_preview: String

MemoryUpdated

Fields

agent_id: String

stored_records: usize

Usage

Fields

agent_id: String

input_tokens: u64

output_tokens: u64

cache_read_tokens: u64

cache_creation_tokens: u64

Notice

Fields

severity: NoticeSeverity

message: String

Retry

Fields

agent_id: String

error: String

attempt: u32

max_attempts: u32

next_delay_ms: u64

Error

Fields

message: String

recoverable: bool

Branched

The session returned to an earlier entry; later turns continue from there along a different path.

Fields

entry_id: String

abandoned_entries: usize

How many entries left the active path. They stay in the transcript and remain reachable.

RunFinished

Always the last line.

Fields

outcome: RunOutcome

stopped_by: Option<Bound>

The bound that ended the run, when one did — the same fact the CLI’s exit 3 carries, for a consumer reading the stream instead of the exit code. Absent, not null, on an unbounded finish, so a schema-1 consumer that never heard of it reads the line unchanged.

Implementations

impl Event

pub fn from_session_event(event: &SessionEvent) -> Option<Self>

Normalizes a mentra session event, or None when basis’s stream already carries the information some other way.

Trait Implementations

impl Clone for Event

fn clone(&self) -> Event

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Event

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Event

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Event

fn eq(&self, other: &Event) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Event

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Event