Enum ContextDelivery 

pub enum ContextDelivery {
    Immediate,
    Deferred,
}

When to deliver model-role context turns to the wire.

Controls timing of context injection (tool advisory, repair nudge, steering modifiers, phase instructions, on_enter_context).

Mode	Behavior	Best for
Immediate	Send as single batched frame during TurnComplete	Low-latency apps, text-only
Deferred	Queue until next user send (audio/text/video)	Voice apps where mid-silence sends cause glitches

Example

Live::builder()
    .steering_mode(SteeringMode::ContextInjection)
    .context_delivery(ContextDelivery::Deferred)  // flush with next user audio
    .phase("greeting")
        .instruction("Welcome the guest")
        .done()
    .initial_phase("greeting")

Variants

Immediate

Send batched context immediately during TurnComplete processing.

All context turns are accumulated into a single send_client_content call and sent as one WebSocket frame. The model receives the context as soon as the turn completes, before the next user interaction.

Deferred

Queue context and flush before the next user send.

Context turns are pushed into a PendingContext buffer. The DeferredWriter drains this buffer before forwarding send_audio, send_text, or send_video — ensuring context arrives in the same burst as user content.

This eliminates the “extraneous message” problem where isolated context frames sent during silence can cause the model to interrupt or produce unexpected responses.

Trait Implementations

impl Clone for ContextDelivery

fn clone(&self) -> ContextDelivery

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ContextDelivery

impl Debug for ContextDelivery

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

Formats the value using the given formatter.

impl Default for ContextDelivery

fn default() -> ContextDelivery

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ContextDelivery

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ContextDelivery

impl JsonSchema for ContextDelivery

fn schema_name() -> String

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

impl PartialEq for ContextDelivery

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ContextDelivery

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 ContextDelivery