Enum Item 

pub enum Item {
    AgentMessage {
        id: Option<String>,
        text: Option<String>,
    },
    Reasoning {
        id: Option<String>,
        text: Option<String>,
    },
    CommandExecution {
        id: Option<String>,
        command: Option<String>,
        aggregated_output: Option<String>,
        exit_code: Option<i32>,
        status: Option<String>,
    },
    FileChange {
        id: Option<String>,
        changes: Vec<FileUpdateChange>,
        status: Option<String>,
    },
    McpToolCall {
        id: Option<String>,
        server: Option<String>,
        tool: Option<String>,
        status: Option<String>,
    },
    WebSearch {
        id: Option<String>,
        query: Option<String>,
    },
    TodoList {
        id: Option<String>,
        items: Vec<TodoItem>,
    },
    Error {
        id: Option<String>,
        message: Option<String>,
    },
    Unknown,
}

An item within a codex execution turn.

Items represent the model’s actions: generating text, executing commands, modifying files, etc. Each item goes through started -> updated* -> completed.

Variants

AgentMessage

A text message from the agent.

Fields

id: Option<String>

Unique item identifier.

text: Option<String>

The message text.

Reasoning

Reasoning / chain-of-thought text.

Fields

id: Option<String>

Unique item identifier.

text: Option<String>

The reasoning text.

CommandExecution

A shell command execution.

Fields

id: Option<String>

Unique item identifier.

command: Option<String>

The command that was executed.

aggregated_output: Option<String>

Aggregated stdout/stderr output from the command.

exit_code: Option<i32>

Exit code of the command.

status: Option<String>

Execution status (e.g. “completed”, “running”).

FileChange

A file modification.

Fields

id: Option<String>

Unique item identifier.

changes: Vec<FileUpdateChange>

The individual file changes.

status: Option<String>

Status of the file change.

McpToolCall

An MCP tool invocation.

Fields

id: Option<String>

Unique item identifier.

server: Option<String>

The MCP server name.

tool: Option<String>

The tool name.

status: Option<String>

Execution status.

WebSearch

A web search query.

Fields

id: Option<String>

Unique item identifier.

query: Option<String>

The search query.

TodoList

A todo/task list.

Fields

id: Option<String>

Unique item identifier.

items: Vec<TodoItem>

The todo items.

Error

An item-level error.

Fields

id: Option<String>

Unique item identifier.

message: Option<String>

Error message.

Unknown

Forward-compatibility: any unrecognized item type.

Implementations

impl Item

pub fn id(&self) -> Option<&str>

Get the item ID, if present.

pub fn text(&self) -> Option<&str>

Get the text content for message/reasoning items.

Trait Implementations

impl Clone for Item

fn clone(&self) -> Item

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Item

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Item

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Item

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

where __S: Serializer,

Serialize this value into the given Serde serializer.