Enum Event 

pub enum Event {
    InstallOrUpgrade {
        kind: InstallKind,
        previous_version: Option<String>,
    },
    SessionStart {
        source: SessionSource,
    },
    SessionEnd {
        duration_bucket: DurationBucket,
        exit_class: ExitClass,
        cold_start_bucket: Option<ColdStartBucket>,
        providers: Vec<String>,
        counters: Counters,
        errors: Errors,
        turn_wall: TurnWall,
    },
    Panic {
        site: String,
    },
}

One telemetry event.

The tag is the event key, so the wire form is flat and the variant set is closed.

Variants

InstallOrUpgrade

This binary’s version differs from the one last recorded on this machine.

Fields

kind: InstallKind

Install, upgrade, or downgrade.

previous_version: Option<String>

The previously recorded version, read from the telemetry state file only — never from session history or config mtimes, which have a different privacy contract.

SessionStart

A session began.

Fields

source: SessionSource

How it was started.

SessionEnd

A session ended. Everything the session accumulated ships here, once.

Fields

duration_bucket: DurationBucket

Bucketed wall-clock session length.

exit_class: ExitClass

How the process ended.

cold_start_bucket: Option<ColdStartBucket>

Bucketed cold start. null on surfaces that do not measure it.

providers: Vec<String>

Sorted, deduplicated ProviderKind names. A custom provider yields the literal "custom", never the customer’s [providers.<name>] table key, and no model id is sent for any provider.

counters: Counters

Feature-use counts.

errors: Errors

Error counts.

turn_wall: TurnWall

Turn wall-clock histogram.

Panic

The process panicked.

Fields

site: String

Source location, reduced by the crates/ allowlist. Never the panic message: a slicing panic embeds the entire string being sliced, and this tree slices user and model text in dozens of places.

Implementations

impl Event

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

The event discriminant, for the doc-match test.

pub fn is_bounded(&self) -> bool

Whether every string this event carries is inside its declared bound.

The bounds above are enforced by the constructors — Counters is a struct of u32s, providers comes from ProviderKind::as_str(), and site comes from crate::reduce_panic_site. That holds only for an event this process built. Events are also read back from buffer.jsonl and deserialized before a batch is assembled, and serde will happily fill site, previous_version, and providers with any string the file contains. Anything running as this user can append a line to that file — including a Bash tool call this session made on the model’s behalf — so the drain path must re-establish the bound rather than inherit it.

Failing this check drops the event. It is never sanitized: a payload that the schema cannot account for is not made safe by editing it.

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 Eq for Event

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