Enum ResponseItem 

pub enum ResponseItem {
    Message {
        role: String,
        content: Vec<ContentBlock>,
        extra: ExtraFields,
    },
    FunctionCall {
        name: String,
        arguments: String,
        call_id: String,
        extra: ExtraFields,
    },
    FunctionCallOutput {
        call_id: String,
        output: Value,
        extra: ExtraFields,
    },
    CustomToolCall {
        name: Option<String>,
        input: Value,
        call_id: Option<String>,
        extra: ExtraFields,
    },
    CustomToolCallOutput {
        call_id: Option<String>,
        output: Value,
        extra: ExtraFields,
    },
    Reasoning {
        extra: ExtraFields,
    },
    WebSearchCall {
        extra: ExtraFields,
    },
    ToolSearchCall {
        extra: ExtraFields,
    },
    ToolSearchOutput {
        extra: ExtraFields,
    },
    ImageGenerationCall {
        extra: ExtraFields,
    },
    Unknown,
}

A canonical conversation item (response_item payload).

Variants

Message

A chat message turn.

Fields

role: String

user / assistant / developer / system.

content: Vec<ContentBlock>

Content blocks.

extra: ExtraFields

Anything else (e.g. phase).

FunctionCall

A built-in function (tool) call.

Fields

name: String

Tool name.

arguments: String

JSON-encoded argument string.

call_id: String

Provider call id.

extra: ExtraFields

Anything else.

FunctionCallOutput

The output of a function call.

Fields

call_id: String

The call id this answers.

output: Value

Output (string or structured).

extra: ExtraFields

Anything else.

CustomToolCall

A custom / MCP tool call. Not yet normalized by the loader.

Fields

name: Option<String>

Tool name.

input: Value

JSON-encoded arguments.

call_id: Option<String>

Call id.

extra: ExtraFields

Anything else.

CustomToolCallOutput

A custom / MCP tool result. Not yet normalized by the loader.

Fields

call_id: Option<String>

The call id this answers.

output: Value

Output.

extra: ExtraFields

Anything else.

Reasoning

Model reasoning. Not folded 1:1 into a ChatMessage (there’s no canonical “reasoning” role), but summary text, the raw content chain-of-thought text when genuinely non-null, and a correctly-gated encrypted_content flag (only when that field is non-null — a present-but-null key, which every real rollout carries, must NOT set the flag) ARE captured by crate::session::Session::from_codex_str onto the next assistant message’s metadata (reasoning/reasoning_content/ reasoning_encrypted), or flushed as their own message when no following assistant turn exists to attach to — see crate::audit::Coverage::Retained (D5/N1/N2/N3, PARITY-12). The opaque encrypted_content blob itself is not replayed cross-model.

Fields

extra: ExtraFields

Anything (summary, encrypted_content, …).

WebSearchCall

A web-search server tool call. Not yet normalized.

Fields

extra: ExtraFields

Anything.

ToolSearchCall

A tool-search call. Not yet normalized.

Fields

extra: ExtraFields

Anything.

ToolSearchOutput

A tool-search result. Not yet normalized.

Fields

extra: ExtraFields

Anything.

ImageGenerationCall

An image-generation call. Not yet normalized.

Fields

extra: ExtraFields

Anything.

Unknown

Any response-item type we do not model yet.

Implementations

impl ResponseItem

pub fn tag(&self) -> Option<&'static str>

The static discriminant name, or None for ResponseItem::Unknown.

pub fn is_normalized(&self) -> bool

Whether the loader currently normalizes this item into a crate::ChatMessage.

Trait Implementations

impl Clone for ResponseItem

fn clone(&self) -> ResponseItem

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ResponseItem

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ResponseItem

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.