Enum StreamDelta 

pub enum StreamDelta {
    Text(String),
    Status(String),
    ToolStart {
        tool: String,
        arguments: Arc<Value>,
        tool_provenance: Option<ToolProvenance>,
    },
    ToolComplete {
        tool: String,
        arguments: Arc<Value>,
        tool_provenance: Option<ToolProvenance>,
        secs: u64,
        success: bool,
        error: Option<String>,
    },
    Reasoning(String),
    Lifecycle(ProgressEvent),
}

Delta sent from the agent loop to the channel’s draft updater. Append-only — no clear/reset variant exists by design.

Variants

Text(String)

Response text to append to the message buffer.

Status(String)

Ephemeral tool progress (not part of the response body).

ToolStart

A pending tool call. Channel draft consumers decide how to render its arguments; the runtime keeps this event structured to avoid coupling a transport-specific disclosure policy into the agent loop.

Fields

tool: String

arguments: Arc<Value>

tool_provenance: Option<ToolProvenance>

Canonical trust origin carried from the resolved static or activated tool. None means the name did not resolve in either registry.

ToolComplete

A completed tool call paired with its original arguments.

Fields

tool: String

arguments: Arc<Value>

tool_provenance: Option<ToolProvenance>

The same trust origin observed when the matching start event was emitted; consumers must treat None as untrusted.

secs: u64

success: bool

error: Option<String>

Reasoning(String)

Provider reasoning text. Channel surfaces must opt in before rendering.

Lifecycle(ProgressEvent)

Typed, non-sensitive agent lifecycle progress.

Implementations

impl StreamDelta

pub fn legacy_status(&self) -> Option<String>

Render structured tool events with the historical conservative policy. Non-Matrix consumers must use this instead of serializing arguments.

Trait Implementations

impl Clone for StreamDelta

fn clone(&self) -> StreamDelta

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StreamDelta

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

Formats the value using the given formatter.