Codex.Items (Codex SDK v0.3.0)

Typed representations of thread items emitted by the Codex runtime.

This module provides helpers to convert JSON-style maps (with string keys) into structs and back, keeping status fields normalised as atoms.

Summary

Types

t()

Functions

parse!(map)

Parses a JSON-decoded map into a typed thread item struct.

to_map(item)

Converts a typed item struct back into its JSON-serialisable map representation.

Types

t()

@type t() ::
  Codex.Items.AgentMessage.t()
  | Codex.Items.Reasoning.t()
  | Codex.Items.CommandExecution.t()
  | Codex.Items.FileChange.t()
  | Codex.Items.UserMessage.t()
  | Codex.Items.ImageView.t()
  | Codex.Items.ReviewMode.t()
  | Codex.Items.McpToolCall.t()
  | Codex.Items.WebSearch.t()
  | Codex.Items.TodoList.t()
  | Codex.Items.Error.t()

Functions

parse!(map)

@spec parse!(map()) :: t()

Parses a JSON-decoded map into a typed thread item struct.

to_map(item)

@spec to_map(t()) :: map()

Converts a typed item struct back into its JSON-serialisable map representation.