codex

type AgentInput struct {
	Name                  string
	Model                 string
	ModelProvider         string
	SandboxMode           string
	ApprovalPolicy        string
	ModelReasoningEffort  string
	AllowedEnvVars        []string
	EnableWebSearch       bool
	EnableShellCache      bool
	ModelInstructionsFile string
	DindEnabled           bool
}

type Codex struct {
	v1.DefaultTool
	// contains filtered or unexported fields
}

type CodexConfig struct {
	Projects       map[string]*Project             `toml:"projects,omitempty"`
	ModelProviders map[string]*ModelProviderConfig `toml:"model_providers,omitempty"`
	Profiles       map[string]*Profile             `toml:"profiles"`
	MCPServers     map[string]*MCPServer           `toml:"mcp_servers"`
}

type DynamicToolContentItem struct {
	Type string `json:"type"`
	Text string `json:"text,omitempty"`
}

type Features struct {
	WebSearchRequest bool `toml:"web_search_request,omitempty"`
	ShellSnapshot    bool `toml:"shell_snapshot,omitempty"`
}

type FileChange struct {
	Path string `json:"path,omitempty"`
	Kind string `json:"kind,omitempty"` // e.g. "add", "modify", "delete"
}

type MCPContentBlock struct {
	Type string `json:"type"`
	Text string `json:"text,omitempty"`
}

type MCPInput struct {
	Name          string
	Type          string // Transport type: "stdio", "sse" or "http"
	URL           string
	Command       string
	Args          []string
	Env           map[string]string
	Headers       map[string]string // HTTP request headers, used for "http" transport
	EnabledTools  []string
	DisabledTools []string
	TrustPolicy   string // e.g. "always" to auto-approve tool calls in exec mode
}

type MCPServer struct {
	Type          string            `toml:"type,omitempty"`    // Transport type: "stdio", "sse" or "http"
	URL           string            `toml:"url,omitempty"`     // For remote MCP (sse/http)
	Command       string            `toml:"command,omitempty"` // For local MCP (stdio)
	Args          []string          `toml:"args,omitempty"`
	Env           map[string]string `toml:"env,omitempty"`
	Headers       map[string]string `toml:"headers,omitempty"` // HTTP request headers for "http" transport
	EnabledTools  []string          `toml:"enabled_tools,omitempty"`
	DisabledTools []string          `toml:"disabled_tools,omitempty"`
	TrustPolicy   string            `toml:"trust_policy,omitempty"` // e.g. "always" to auto-approve tool calls in exec mode
}

type MCPToolError struct {
	Message string `json:"message,omitempty"`
}

type MCPToolResult struct {
	Content           []MCPContentBlock `json:"content,omitempty"`
	StructuredContent json.RawMessage   `json:"structured_content,omitempty"`
}

type Model string

type ModelProviderConfig struct {
	Name    string `toml:"name,omitempty"`
	BaseURL string `toml:"base_url,omitempty"`
	EnvKey  string `toml:"env_key,omitempty"`
}

type ModelProviderInput struct {
	// Name is the key used to reference this provider from a Profile's ModelProvider field.
	Name string
	// BaseURL is the OpenAI-compatible API endpoint, e.g. "https://api.example.com/v1".
	BaseURL string
	// EnvKey is the name of the environment variable that holds the API key.
	EnvKey string
}

type Profile struct {
	Model                  string                 `toml:"model"`
	ModelProvider          string                 `toml:"model_provider,omitempty"`
	SandboxMode            string                 `toml:"sandbox_mode"`
	ApprovalPolicy         string                 `toml:"approval_policy"`
	ModelReasoningEffort   string                 `toml:"model_reasoning_effort"`
	ShellEnvironmentPolicy *ShellEnvPolicy        `toml:"shell_environment_policy,omitempty"`
	Features               *Features              `toml:"features,omitempty"`
	ModelInstructionsFile  string                 `toml:"model_instructions_file,omitempty"`
	SandboxWorkspaceWrite  *SandboxWorkspaceWrite `toml:"sandbox_workspace_write,omitempty"`
}

type Project struct {
	TrustLevel string `toml:"trust_level,omitempty"`
}

type SandboxWorkspaceWrite struct {
	NetworkAccess bool     `toml:"network_access,omitempty"`
	WritableRoots []string `toml:"writable_roots,omitempty"`
}

type ShellEnvPolicy struct {
	IncludeOnly []string          `toml:"include_only,omitempty"`
	Set         map[string]string `toml:"set,omitempty"`
}

type StreamEvent struct {
	// Type identifies the event kind, e.g. "thread.started", "turn.started",
	// "item.started", "item.completed", "turn.completed".
	Type string `json:"type"`

	// Message is populated with "error" events.
	Message string `json:"message"`

	// ThreadID is set on "thread.started" events and carries the session
	// identifier that must be forwarded to the API (analogous to session_id in Claude).
	ThreadID string `json:"thread_id,omitempty"`

	// Item is populated on "item.started" and "item.completed" events.
	Item *StreamItem `json:"item,omitempty"`

	// Usage is populated on "turn.completed" events and contains token usage statistics.
	Usage *TurnUsage `json:"usage,omitempty"`

	// Error is populated on "turn.failed" events.
	Error *TurnError `json:"error,omitempty"`
}

type StreamItem struct {
	// ID is the stable identifier for this item across started/completed pairs.
	ID string `json:"id"`

	// Type describes what kind of item this is: "reasoning", "agent_message", "todo_list",
	// "command_execution", "dynamic_tool_call", "mcp_tool_call", "file_change", etc.
	Type string `json:"type"`

	// Text is populated for "reasoning" and "agent_message" items.
	Text string `json:"text,omitempty"`

	// Message is populated for Type "error" items.
	Message string `json:"message,omitempty"`

	// Command and output fields are populated for "command_execution" items.
	Command          string `json:"command,omitempty"`
	AggregatedOutput string `json:"aggregated_output,omitempty"`
	ExitCode         *int   `json:"exit_code,omitempty"`
	Status           string `json:"status,omitempty"`

	// Items is populated for "todo_list" items.
	Items []TodoItem `json:"items,omitempty"`

	// Tool fields are populated for "mcp_tool_call" and "dynamic_tool_call" items.
	Server    string          `json:"server,omitempty"`
	Namespace string          `json:"namespace,omitempty"`
	Tool      string          `json:"tool,omitempty"`
	Arguments json.RawMessage `json:"arguments,omitempty"`
	Result    *MCPToolResult  `json:"result,omitempty"`
	Error     *MCPToolError   `json:"error,omitempty"`

	// ContentItems is populated for "dynamic_tool_call" items.
	ContentItems []DynamicToolContentItem `json:"content_items,omitempty"`
	Success      *bool                    `json:"success,omitempty"`

	// Query is populated for "web_search" items.
	Query string `json:"query,omitempty"`

	// Changes is populated for "file_change" items.
	Changes []FileChange `json:"changes,omitempty"`
}

type TodoItem struct {
	Text      string `json:"text"`
	Completed bool   `json:"completed"`
}

type TurnError struct {
	Message string `json:"message,omitempty"`
}

type TurnUsage struct {
	InputTokens       int `json:"input_tokens"`
	CachedInputTokens int `json:"cached_input_tokens"`
	OutputTokens      int `json:"output_tokens"`
}