codex

type BaseInstructions struct {
	Text       string          `json:"text"`
	Provenance json.RawMessage `json:"provenance"`

	Members
}

type Compacted struct {
	Message string `json:"message"`
	// ReplacementHistory is the new window's items, in order; absent in
	// older rollouts, which rebuilt it from the user messages on resume.
	ReplacementHistory         []json.RawMessage `json:"replacement_history"`
	ReplacementHistoryMetadata json.RawMessage   `json:"replacement_history_metadata"`
	WindowNumber               json.Number       `json:"window_number"`
	CompactionResponseID       string            `json:"compaction_response_id"`
	LatestTokenUsageRecord     json.RawMessage   `json:"latest_token_usage_record"`
	ResumeMetadata             json.RawMessage   `json:"resume_metadata"`

	Members
}

type ContentItem struct {
	Type     string `json:"type"`
	Text     string `json:"text"`
	ImageURL string `json:"image_url"`
	FileID   string `json:"file_id"`
	Detail   string `json:"detail"`
	AudioURL string `json:"audio_url"`
}

type Event struct {
	Type string `json:"type"`

	// turn_started, turn_complete, turn_aborted.
	TurnID     string `json:"turn_id"`
	RootTurnID string `json:"root_turn_id"`
	// turn_aborted.
	Reason json.RawMessage `json:"reason"`

	// thread_rolled_back: how many user turns were dropped.
	NumTurns *int64 `json:"num_turns"`

	// token_count.
	Info       *TokenUsageInfo `json:"info"`
	RateLimits json.RawMessage `json:"rate_limits"`

	// user_message and agent_message.
	Message string `json:"message"`
	// user_message.
	Images json.RawMessage `json:"images"`
	// agent_reasoning and agent_reasoning_raw_content.
	Text string `json:"text"`

	// item_completed.
	Item json.RawMessage `json:"item"`

	Members
}

type File struct {
	// Path is the file the rollout was read from; empty when it was read
	// from a reader.
	Path string
	// Lines are the lines that decoded as JSON objects, in file order.
	Lines []*Line
	// Errors lists the lines that could not be read, which the reader
	// skipped, as Codex skips them.
	Errors []LineError
	// Legacy says the file is in the layout before the envelope: a bare
	// session meta first, then bare items and state records.
	Legacy bool
}

type GitInfo struct {
	CommitHash    string `json:"commit_hash"`
	Branch        string `json:"branch"`
	RepositoryURL string `json:"repository_url"`

	Members
}

type Index struct {
	// Root is the directory indexed, symbolic links resolved.
	Root string
	// Skipped lists the rollouts whose session meta could not be read
	// and the directories that could not be walked: a thread among them
	// is in no family.
	Skipped []Skip
	// contains filtered or unexported fields
}

type InterAgent struct {
	ID               string          `json:"id"`
	Author           string          `json:"author"`
	Recipient        string          `json:"recipient"`
	OtherRecipients  json.RawMessage `json:"other_recipients"`
	Content          string          `json:"content"`
	EncryptedContent string          `json:"encrypted_content"`
	Passthrough      json.RawMessage `json:"internal_chat_message_metadata_passthrough"`
	TriggerTurn      bool            `json:"trigger_turn"`

	Members
}

type Item struct {
	Type   string `json:"type"`
	ID     string `json:"id"`
	Status string `json:"status"`

	// message, additional_tools.
	Role string `json:"role"`
	// message (content items), reasoning (reasoning text), agent_message.
	Content json.RawMessage `json:"content"`
	// message: commentary, partial_answer or final_answer.
	Phase string `json:"phase"`
	// Codex's own encrypted form of several items, and the reasoning or
	// compaction item's encrypted content.
	EncryptedContent *string `json:"encrypted_content"`

	// reasoning.
	Summary json.RawMessage `json:"summary"`

	// function_call, custom_tool_call and their outputs; local_shell_call,
	// tool_search_call and tool_search_output, where it may be null.
	CallID    string `json:"call_id"`
	Name      string `json:"name"`
	Namespace string `json:"namespace"`
	// function_call: a JSON string; tool_search_call: any value.
	Arguments             json.RawMessage `json:"arguments"`
	EncryptedFunctionArgs json.RawMessage `json:"encrypted_function_args"`
	// custom_tool_call: the free-form input.
	Input string `json:"input"`
	// function_call_output and custom_tool_call_output: a string or an
	// array of content items.
	Output json.RawMessage `json:"output"`

	// local_shell_call and web_search_call.
	Action json.RawMessage `json:"action"`
	// tool_search_call and tool_search_output.
	Execution string `json:"execution"`
	// tool_search_output and additional_tools.
	Tools json.RawMessage `json:"tools"`

	// agent_message.
	Author    string `json:"author"`
	Recipient string `json:"recipient"`

	// image_generation_call.
	RevisedPrompt string `json:"revised_prompt"`
	Result        string `json:"result"`

	// configuration_update.
	Reasoning json.RawMessage `json:"reasoning"`

	// ghost_snapshot.
	GhostCommit json.RawMessage `json:"ghost_commit"`

	// Passthrough is metadata Codex sends the Responses API beside the
	// item: the turn id, creation time, content kinds.
	Passthrough json.RawMessage `json:"internal_chat_message_metadata_passthrough"`

	Members
}

type Line struct {
	Timestamp string `json:"timestamp"`
	// Ordinal is the line's position in the thread's history, which
	// newer rollouts write.
	Ordinal json.Number     `json:"ordinal"`
	Type    string          `json:"type"`
	Payload json.RawMessage `json:"payload"`
	// Metadata is a response item's harness metadata
	// (CodexHarnessMetadata), never sent to the model.
	Metadata json.RawMessage `json:"metadata"`

	Members

	// No is the line's 1-based number in its file.
	No int `json:"-"`
	// Raw is the line as read.
	Raw json.RawMessage `json:"-"`
	// Kind is what the line holds: Type for an envelope line; for a
	// legacy line TypeSessionMeta, TypeResponseItem or TypeState.
	Kind string `json:"-"`
	// Legacy says the line is in the layout before the envelope.
	Legacy bool `json:"-"`
	// Err is set when the line is JSON but not a rollout line: an object
	// with no type and no record_type past the first line.
	Err error `json:"-"`
	// PayloadErr is set when the payload of a kind this package types
	// does not decode as that kind; the typed field is then nil.
	PayloadErr error `json:"-"`

	Meta        *SessionMeta      `json:"-"`
	Item        *Item             `json:"-"`
	Event       *Event            `json:"-"`
	TurnContext *TurnContext      `json:"-"`
	Compacted   *Compacted        `json:"-"`
	InterAgent  *InterAgent       `json:"-"`
	UsageRecord *TokenUsageRecord `json:"-"`
}

type LineError struct {
	No  int
	Err error
}

type Members = jsonline.Members

type SessionMeta struct {
	// ID is the thread's id; SessionID the root thread's, which a
	// sub-agent shares.
	ID                         string            `json:"id"`
	SessionID                  string            `json:"session_id"`
	ForkedFromID               string            `json:"forked_from_id"`
	ForkedFromOrdinalExclusive json.Number       `json:"forked_from_ordinal_exclusive"`
	ParentThreadID             string            `json:"parent_thread_id"`
	Timestamp                  string            `json:"timestamp"`
	CWD                        string            `json:"cwd"`
	Originator                 string            `json:"originator"`
	CLIVersion                 string            `json:"cli_version"`
	Source                     json.RawMessage   `json:"source"`
	ThreadSource               string            `json:"thread_source"`
	AgentNickname              string            `json:"agent_nickname"`
	AgentRole                  string            `json:"agent_role"`
	AgentPath                  string            `json:"agent_path"`
	ModelProvider              string            `json:"model_provider"`
	BaseInstructions           *BaseInstructions `json:"base_instructions"`
	DynamicTools               json.RawMessage   `json:"dynamic_tools"`
	MemoryMode                 string            `json:"memory_mode"`
	// HistoryMode is "legacy" (the default) or "paginated".
	HistoryMode string `json:"history_mode"`
	// HistoryBase names a prefix of another rollout this thread
	// inherits by reference, not by copy.
	HistoryBase                 json.RawMessage `json:"history_base"`
	SubagentHistoryStartOrdinal json.Number     `json:"subagent_history_start_ordinal"`
	MultiAgentVersion           string          `json:"multi_agent_version"`
	ContextWindow               json.RawMessage `json:"context_window"`
	Git                         *GitInfo        `json:"git"`
	// Instructions is the legacy layout's user instructions, which later
	// versions moved to the turn context.
	Instructions *string `json:"instructions"`

	Members
}

type Skip struct {
	Path string
	Err  error
}

type Thread struct {
	// ID is the thread's id; Parent the thread that spawned it, or "".
	ID, Parent string
	// AgentPath is the MultiAgentV2 path it was spawned at, or "".
	AgentPath string
	Path      string
}

type ThreadSpawn struct {
	ParentThreadID string `json:"parent_thread_id"`
	Depth          int    `json:"depth"`
	AgentPath      string `json:"agent_path"`
	AgentNickname  string `json:"agent_nickname"`
	AgentRole      string `json:"agent_role"`
}

type TokenUsage struct {
	InputTokens           int64 `json:"input_tokens"`
	CachedInputTokens     int64 `json:"cached_input_tokens"`
	CacheWriteInputTokens int64 `json:"cache_write_input_tokens"`
	OutputTokens          int64 `json:"output_tokens"`
	ReasoningOutputTokens int64 `json:"reasoning_output_tokens"`
	TotalTokens           int64 `json:"total_tokens"`

	Members
}

type TokenUsageInfo struct {
	TotalTokenUsage    *TokenUsage `json:"total_token_usage"`
	LastTokenUsage     *TokenUsage `json:"last_token_usage"`
	ModelContextWindow *int64      `json:"model_context_window"`

	Members
}

type TokenUsageRecord struct {
	ThreadID         string      `json:"thread_id"`
	TurnID           string      `json:"turn_id"`
	SessionID        string      `json:"session_id"`
	RootTurnID       string      `json:"root_turn_id"`
	ResponseID       string      `json:"response_id"`
	Usage            *TokenUsage `json:"usage"`
	TurnTokenUsage   *TokenUsage `json:"turn_token_usage"`
	ThreadTokenUsage *TokenUsage `json:"thread_token_usage"`

	Members
}

type TurnContext struct {
	TurnID            string          `json:"turn_id"`
	RootTurnID        string          `json:"root_turn_id"`
	CWD               string          `json:"cwd"`
	ApprovalPolicy    json.RawMessage `json:"approval_policy"`
	SandboxPolicy     json.RawMessage `json:"sandbox_policy"`
	PermissionProfile json.RawMessage `json:"permission_profile"`
	Model             string          `json:"model"`
	// Effort is the reasoning effort: none, minimal, low, medium, high,
	// xhigh, or absent for the model's default.
	Effort string `json:"effort"`
	// Summary is the reasoning summary setting: auto, concise, detailed
	// or none.
	Summary           json.RawMessage `json:"summary"`
	CollaborationMode json.RawMessage `json:"collaboration_mode"`
	// UserInstructions and DeveloperInstructions are what versions of
	// early 2026 recorded here; the text the model saw is in the
	// developer and user message items.
	UserInstructions      *string `json:"user_instructions"`
	DeveloperInstructions *string `json:"developer_instructions"`
	// TruncationPolicy is how tool output was cut before it was sent,
	// {"mode":"bytes"|"tokens","limit":n}, which those versions recorded.
	TruncationPolicy json.RawMessage `json:"truncation_policy"`

	Members
}