Skip to content

Agent Codex

Cluster: Uncategorised | Type: component | MCP Tools: 13

Overview

Public API

CodexAvailability(BaseModel)

Field Type Default
cli_present bool required
sdk_present bool required
api_key_configured bool required
recommended_path Literal['cli', 'sdk', 'unavailable'] required

AgentCodexBlock(AIBlock[AgentCodexInput, AgentCodexOutput, None])

Field Type Default
name str 'agent_codex'
availability CodexAvailability field(default_factory=probe)

Methods:

infer(data: AgentCodexInput) -> Result[AgentCodexOutput]

ops() -> list[str]

CodexLLMCaller

An LLMCaller backed directly by the OpenAI Codex CLI (codex exec).

Constructor:

Parameter Type Default
timeout_seconds int 240
sandbox str 'read-only'
reasoning_effort str \| None 'high'

Methods:

complete(system: str, user: str, max_tokens: int = DEFAULT_MAX_TOKENS) -> str

AgentCodexInput(BaseModel)

Field Type Default
op Literal['run', 'session', 'skill', 'agent', 'meta', 'pipeline', 'status'] 'run'
prompt str ''
model str 'gpt-5-codex'
context dict Field(default_factory=dict)
timeout_seconds int 60
allow_paid_api bool False

AgentCodexOutput(BaseModel)

Field Type Default
ok bool required
op str required
response str ''
verdict Literal['pass', 'fail', 'timeout', 'unavailable', 'not_applicable'] 'not_applicable'
label Literal['verified', 'qualified-draft', 'blocked-escalated', 'draft'] 'draft'
metadata dict Field(default_factory=dict)
degraded bool False
degradation_reason str ''
agentic_evidence dict Field(default_factory=dict)

Functions

probe() -> CodexAvailability

MCP Tools

Operation Source
ops codex_mcp
help codex_mcp
run codex_mcp
session codex_mcp
skill codex_mcp
agent codex_mcp
meta codex_mcp
pipeline codex_mcp
status codex_mcp
list_strategies codex_mcp
explain_sandbox_policy codex_mcp
recommend_sandbox codex_mcp
list_patterns codex_mcp