Struct ModelEvent 

pub struct ModelEvent {
    pub event: Symbol,
    pub runner: Symbol,
    pub model: String,
    pub span_id: Expr,
    pub response: Option<ModelResponse>,
    pub extra: Vec<(Expr, Expr)>,
}

Structured streaming event emitted by a model runner.

Fields

event: Symbol

Event kind such as start, delta, usage, tool-call, or final.

runner: Symbol

Runner identity that produced the event.

model: String

Provider or runtime model name for the event.

span_id: Expr

Correlation id for one inference span.

response: Option<ModelResponse>

Final response payload for terminal events when available.

extra: Vec<(Expr, Expr)>

Open extension fields preserved for event-specific payloads.

Implementations

impl ModelEvent

pub fn new( event: Symbol, runner: Symbol, model: impl Into<String>, span_id: Expr, ) -> Self

Constructs a generic event record.

pub fn start(runner: Symbol, model: impl Into<String>, span_id: Expr) -> Self

Constructs a start event.

pub fn delta_text( runner: Symbol, model: impl Into<String>, span_id: Expr, text: impl Into<String>, ) -> Self

Constructs a text delta event.

pub fn usage( runner: Symbol, model: impl Into<String>, span_id: Expr, usage: ModelUsage, ) -> Self

Constructs a usage event.

pub fn error_text( runner: Symbol, model: impl Into<String>, span_id: Expr, message: impl Into<String>, ) -> Self

Constructs an error event with a text payload.

pub fn tool_call( runner: Symbol, model: impl Into<String>, span_id: Expr, tool_call: Expr, ) -> Self

Constructs a tool-call event.

pub fn final_of(response: &ModelResponse) -> Self

Constructs a terminal final event from a completed response.

pub fn with_field(self, key: &str, value: Expr) -> Self

Appends an extra field to the event payload.

pub fn to_kernel_event(&self, cx: &mut Cx, run: Ref, seq: u64) -> Result<Event>

Converts this model event into a kernel chunk event with a content ref.

Trait Implementations

impl Clone for ModelEvent

fn clone(&self) -> ModelEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ModelEvent

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

Formats the value using the given formatter.

impl From<ModelEvent> for Expr

fn from(value: ModelEvent) -> Self

Converts to this type from the input type.

impl PartialEq for ModelEvent

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ModelEvent

impl TryFrom<Expr> for ModelEvent

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: Expr) -> Result<Self>

Performs the conversion.