Enum ThreadEvent 

pub enum ThreadEvent {
    ThreadStarted(ThreadStarted),
    TurnStarted(TurnStarted),
    TurnCompleted(TurnCompleted),
    TurnFailed(TurnFailed),
    ItemStarted(ItemEnvelope<ItemSnapshot>),
    ItemDelta(ItemDelta),
    ItemCompleted(ItemEnvelope<ItemSnapshot>),
    ItemFailed(ItemEnvelope<ItemFailure>),
    Error(EventError),
}

Single JSONL event emitted by codex exec --json.

Each line on stdout maps to a ThreadEvent with lifecycle edges:

• thread.started is emitted once per invocation.
• turn.started begins the turn associated with the provided prompt.
• one or more item.* events stream output and tool activity.
• turn.completed or turn.failed closes the stream; error captures transport-level failures.

Item variants mirror the upstream item_type field: agent_message, reasoning, command_execution, file_change, mcp_tool_call, web_search, todo_list, and error. Unknown or future fields are preserved in extra maps to keep the parser forward-compatible.

Variants

ThreadStarted(ThreadStarted)

TurnStarted(TurnStarted)

TurnCompleted(TurnCompleted)

TurnFailed(TurnFailed)

ItemStarted(ItemEnvelope<ItemSnapshot>)

ItemDelta(ItemDelta)

ItemCompleted(ItemEnvelope<ItemSnapshot>)

ItemFailed(ItemEnvelope<ItemFailure>)

Error(EventError)

Implementations

impl ThreadEvent

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

Trait Implementations

impl Clone for ThreadEvent

fn clone(&self) -> ThreadEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ThreadEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ThreadEvent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ThreadEvent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.