Enum RunnerOutput 

#[non_exhaustive]
pub enum RunnerOutput {
    TextContent {
        text: String,
    },
    BuiltinToolCall {
        tool_use_id: String,
        name: String,
        input: Value,
    },
    CustomToolCall {
        custom_tool_use_id: String,
        name: String,
        input: Value,
    },
    McpToolCall {
        tool_use_id: String,
        name: String,
        input: Value,
    },
    TurnComplete {
        stop_reason: StopReason,
    },
}

Represents a Runner output event that needs to be mapped to a SessionEvent.

This is the internal representation that normalizes provider-specific event formats before they become provider-neutral session events. The session loop constructs RunnerOutput values from the raw Runner event stream.

Variants

• TextContent: LLM generated text → agent.message
• BuiltinToolCall: Built-in tool invocation → agent.tool_use
• CustomToolCall: Custom (client-executed) tool → agent.custom_tool_use
• McpToolCall: MCP tool invocation → agent.mcp_tool_use
• TurnComplete: Turn finished with a stop reason → status.idle

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

TextContent

LLM generated text content.

Fields

text: String

The generated text.

BuiltinToolCall

LLM requested a built-in tool call (executes server-side in sandbox).

Fields

tool_use_id: String

Unique identifier for this tool invocation.

name: String

Name of the built-in tool.

input: Value

Tool input parameters as JSON.

CustomToolCall

LLM requested a custom (client-executed) tool call. The session loop will park until the client delivers a result.

Fields

custom_tool_use_id: String

Unique identifier for this custom tool invocation.

name: String

Name of the custom tool.

input: Value

Tool input parameters as JSON.

McpToolCall

LLM requested an MCP tool call.

Fields

tool_use_id: String

Unique identifier for this MCP tool invocation.

name: String

Name of the MCP tool.

input: Value

Tool input parameters as JSON.

TurnComplete

Turn completed with a stop reason.

Fields

stop_reason: StopReason

Why the turn ended.

Trait Implementations

impl Clone for RunnerOutput

fn clone(&self) -> RunnerOutput

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RunnerOutput

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RunnerOutput

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RunnerOutput

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.