codex

type Client struct {
	// contains filtered or unexported fields
}

type ClientInfo struct {
	Title   string `json:"title"`
	Name    string `json:"name"`
	Version string `json:"version"`
}

type ClientOpts struct {
	CWD     string   // working directory of the subprocess
	Env     []string // full environment for the subprocess (not merged with os.Environ)
	Command []string // command override; when set, used verbatim (tests)
}

type ErrorParams struct {
	Error RPCError `json:"error"`
}

type Event struct {
	Type      string `json:"type"`
	Content   string `json:"content,omitempty"`
	Error     string `json:"error,omitempty"`
	SessionID string `json:"session_id,omitempty"` // codex thread ID
}

type FileChange struct {
	Path string `json:"path"`
}

type InitializeCaps struct {
	ExperimentalAPI           bool     `json:"experimentalApi"`
	RequestAttestation        bool     `json:"requestAttestation"`
	OptOutNotificationMethods []string `json:"optOutNotificationMethods"`
}

type InitializeParams struct {
	ClientInfo   ClientInfo     `json:"clientInfo"`
	Capabilities InitializeCaps `json:"capabilities"`
}

type InitializeResponse struct {
	UserAgent string `json:"userAgent"`
}

type Item struct {
	Type     string       `json:"type"`
	ID       string       `json:"id"`
	Text     string       `json:"text,omitempty"`     // agentMessage
	Phase    string       `json:"phase,omitempty"`    // agentMessage: "final_answer" | "analysis"
	Command  string       `json:"command,omitempty"`  // commandExecution
	Status   string       `json:"status,omitempty"`   // commandExecution, fileChange, mcpToolCall
	ExitCode *int         `json:"exitCode,omitempty"` // commandExecution
	Tool     string       `json:"tool,omitempty"`     // mcpToolCall, dynamicToolCall
	Server   string       `json:"server,omitempty"`   // mcpToolCall
	Query    string       `json:"query,omitempty"`    // webSearch
	Review   string       `json:"review,omitempty"`   // exitedReviewMode
	Summary  []string     `json:"summary,omitempty"`  // reasoning
	Changes  []FileChange `json:"changes,omitempty"`  // fileChange
}

type ItemParams struct {
	ThreadID string `json:"threadId"`
	TurnID   string `json:"turnId"`
	Item     Item   `json:"item"`
}

type JSONRPCNotification struct {
	JSONRPC string          `json:"jsonrpc"`
	Method  string          `json:"method"`
	Params  json.RawMessage `json:"params"`
}

type JSONRPCRequest struct {
	JSONRPC string `json:"jsonrpc"`
	ID      int    `json:"id"`
	Method  string `json:"method"`
	Params  any    `json:"params"`
}

type JSONRPCResponse struct {
	JSONRPC string          `json:"jsonrpc"`
	ID      int             `json:"id"`
	Result  json.RawMessage `json:"result,omitempty"`
	Error   *RPCError       `json:"error,omitempty"`
}

type RPCError struct {
	Code    int    `json:"code"`
	Message string `json:"message"`
}

type ReviewStartParams struct {
	ThreadID string       `json:"threadId"`
	Delivery string       `json:"delivery"`
	Target   ReviewTarget `json:"target"`
}

type ReviewStartResponse struct {
	Turn Turn `json:"turn"`
}

type ReviewTarget struct {
	Type string `json:"type"`
}

type RunResult struct {
	Status     string `json:"status"`
	Result     string `json:"result,omitempty"`
	Error      string `json:"error,omitempty"`
	SessionID  string `json:"session_id,omitempty"`  // codex thread ID
	Stderr     string `json:"stderr,omitempty"`      // captured app-server stderr
	StopReason string `json:"stop_reason,omitempty"` // turn status: completed/interrupted/failed
}

type Session struct {
	// contains filtered or unexported fields
}

type SessionOpts struct {
	CWD     string   // working directory for the thread
	Prompt  string   // task prompt (ignored when Review is set; review has no prompt)
	Sandbox string   // SandboxReadOnly or SandboxWorkspaceWrite
	Env     []string // full environment for the app-server subprocess
	Review  bool     // run review/start instead of turn/start
	Command []string // command override; used verbatim (tests)
}

type Thread struct {
	ID string `json:"id"`
}

type ThreadStartParams struct {
	CWD            string  `json:"cwd"`
	Model          *string `json:"model"`
	ApprovalPolicy string  `json:"approvalPolicy"`
	Sandbox        string  `json:"sandbox"`
	ServiceName    string  `json:"serviceName"`
	Ephemeral      bool    `json:"ephemeral"`
}

type ThreadStartResponse struct {
	Thread Thread `json:"thread"`
}

type Turn struct {
	ID     string `json:"id"`
	Status string `json:"status"`
	Error  string `json:"error"`
}

type TurnCompletedParams struct {
	ThreadID string `json:"threadId"`
	Turn     Turn   `json:"turn"`
}

type TurnInterruptParams struct {
	ThreadID string `json:"threadId"`
	TurnID   string `json:"turnId"`
}

type TurnStartParams struct {
	ThreadID string      `json:"threadId"`
	Input    []UserInput `json:"input"`
	Model    *string     `json:"model"`
	Effort   *string     `json:"effort"`
}

type TurnStartResponse struct {
	Turn Turn `json:"turn"`
}

type TurnStartedParams struct {
	ThreadID string `json:"threadId"`
	Turn     Turn   `json:"turn"`
}

type UserInput struct {
	Type         string `json:"type"`
	Text         string `json:"text"`
	TextElements []any  `json:"text_elements"`
}