Enum StreamedTurnEvent 

pub enum StreamedTurnEvent {
    EmitIngested,
    EmitToolCallDelta {
        id: String,
        internal_call_id: String,
        content: ToolCallDeltaContent,
    },
    InvalidToolCall(Box<StreamedInvalidToolCall>),
    Completed {
        usage: Usage,
        emit_final: bool,
    },
}

What a driver must do with one ingested stream item.

Deliberately exhaustive: a driver must handle every event, so adding a variant is a breaking change by design.

Variants

EmitIngested

Forward the ingested item to the consumer as-is (text, reasoning, or reasoning deltas, after accumulation).

EmitToolCallDelta

Forward this tool-call delta. Argument deltas buffered while the tool name awaited validation are replayed through this event.

Fields

id: String

Provider-supplied tool call ID.

internal_call_id: String

Rig-generated identifier correlating this call’s stream items.

content: ToolCallDeltaContent

The (possibly repaired) name or argument delta.

InvalidToolCall(Box<StreamedInvalidToolCall>)

The model emitted an unknown or disallowed tool call. Resolve it via AgentRun::resolve_streamed_invalid_tool_call, then apply the outcome with StreamedTurnAssembler::resolve_pending_invalid.

Completed

The provider reported the end of this completion call. Record it (see AgentRun::record_streamed_completion_call); when emit_final is set, the turn streamed text and the driver should run its stream-finish hook and forward the final item.

Fields

usage: Usage

Provider-reported usage for this call. Zero-valued usage means the provider reported no usage metrics.

emit_final: bool

Whether the ingested final item should be forwarded to the consumer (set when the turn streamed text).

Trait Implementations

impl Clone for StreamedTurnEvent

fn clone(&self) -> StreamedTurnEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StreamedTurnEvent

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

Formats the value using the given formatter.