{
"id": "agent-runtime-impl:codex.runtime@1.x",
"_kind": "AgentRuntimeImpl",
"_file": "agent-stack/runtime-impls/codex-runtime-1-x.yaml",
"_cluster": "agent-stack",
"attributes": {
"displayName": "Codex CLI Runtime (1.x)",
"agentVersionId": "agent-version:codex@1.x",
"subagentDispatchMechanism": "handoff",
"subagentChildSessionPolicy": "ephemeral-child-session",
"subagentToolScopePolicy": "inherit-parent",
"packageRef": "source-ref:codex-github",
"builtInTools": [
"tool-descriptor:read",
"tool-descriptor:bash"
],
"toolRegistryDiscovery": "static-bundled",
"hookSockets": [
"hook-surface:codex.on-tool-call",
"hook-surface:codex.on-stop"
],
"internalSessionStateLocation": "~/.codex/sessions/",
"sessionFileFormat": "jsonl",
"sessionFilePathConvention": "~/.codex/sessions/<session-id>.jsonl",
"approvalGatingPrimitive": "per-call",
"subprocessSandboxStrategy": "native-sandbox",
"runtimeIdentity": "none",
"supportedMCPTransports": [
"mcp-transport:stdio",
"mcp-transport:streamable-http"
],
"supportsStreaming": true
},
"outgoingEdges": [
{
"from": "agent-runtime-impl:codex.runtime@1.x",
"to": "layer:5-agent-runtime",
"kind": "realizes",
"attributes": {}
},
{
"from": "agent-runtime-impl:codex.runtime@1.x",
"to": "agent:codex",
"kind": "composes",
"attributes": {
"role": "runtime"
}
},
{
"from": "agent-runtime-impl:codex.runtime@1.x",
"to": "hook-surface:codex.on-tool-call",
"kind": "exposes",
"attributes": {}
},
{
"from": "agent-runtime-impl:codex.runtime@1.x",
"to": "hook-surface:codex.on-stop",
"kind": "exposes",
"attributes": {}
},
{
"from": "agent-runtime-impl:codex.runtime@1.x",
"to": "tool-descriptor:read",
"kind": "bundles",
"attributes": {}
},
{
"from": "agent-runtime-impl:codex.runtime@1.x",
"to": "tool-descriptor:bash",
"kind": "bundles",
"attributes": {}
},
{
"from": "agent-runtime-impl:codex.runtime@1.x",
"to": "mcp-transport:stdio",
"kind": "connects",
"attributes": {}
},
{
"from": "agent-runtime-impl:codex.runtime@1.x",
"to": "mcp-transport:streamable-http",
"kind": "connects",
"attributes": {}
},
{
"from": "agent-runtime-impl:codex.runtime@1.x",
"to": "capability:mcp-stdio",
"kind": "supports",
"attributes": {
"versionRange": ">=1.0.0 <2.0.0",
"level": "full"
}
},
{
"from": "agent-runtime-impl:codex.runtime@1.x",
"to": "capability:supports-mcp",
"kind": "supports",
"attributes": {
"versionRange": ">=1.0.0 <2.0.0",
"level": "full",
"notes": "Codex CLI supports MCP server configuration for local and remote tool integrations. "
}
},
{
"from": "agent-runtime-impl:codex.runtime@1.x",
"to": "capability:mcp-streamable-http",
"kind": "supports",
"attributes": {
"versionRange": ">=1.0.0 <2.0.0",
"level": "partial",
"notes": "Modeled from OpenAI Codex MCP documentation covering remote MCP server integration alongside stdio configuration. "
}
},
{
"from": "agent-runtime-impl:codex.runtime@1.x",
"to": "capability:supports-subagent-dispatch",
"kind": "supports",
"attributes": {
"versionRange": "*",
"level": "full",
"notes": "OpenAI Agents SDK handoff primitive. "
}
},
{
"from": "agent-runtime-impl:codex.runtime@1.x",
"to": "permission-mode:codex-untrusted",
"kind": "operates_in_permission_mode",
"attributes": {}
},
{
"from": "agent-runtime-impl:codex.runtime@1.x",
"to": "permission-mode:codex-on-failure",
"kind": "operates_in_permission_mode",
"attributes": {}
},
{
"from": "agent-runtime-impl:codex.runtime@1.x",
"to": "permission-mode:codex-on-request",
"kind": "operates_in_permission_mode",
"attributes": {}
},
{
"from": "agent-runtime-impl:codex.runtime@1.x",
"to": "permission-mode:codex-never",
"kind": "operates_in_permission_mode",
"attributes": {}
},
{
"from": "agent-runtime-impl:codex.runtime@1.x",
"to": "env-var:openai-api-key",
"kind": "has_env_var",
"attributes": {}
},
{
"from": "agent-runtime-impl:codex.runtime@1.x",
"to": "env-var:openai-base-url",
"kind": "has_env_var",
"attributes": {}
},
{
"from": "agent-runtime-impl:codex.runtime@1.x",
"to": "mcp-transport:stdio",
"kind": "speaks",
"attributes": {}
},
{
"from": "agent-runtime-impl:codex.runtime@1.x",
"to": "mcp-transport:streamable-http",
"kind": "speaks",
"attributes": {}
}
],
"incomingEdges": [
{
"from": "agent-version:codex@1.x",
"to": "agent-runtime-impl:codex.runtime@1.x",
"kind": "composed_of",
"attributes": {
"role": "runtime"
}
},
{
"from": "agent-version:codex-websocket@current",
"to": "agent-runtime-impl:codex.runtime@1.x",
"kind": "composed_of",
"attributes": {
"role": "runtime"
}
},
{
"from": "claim:codex-research-approval-and-sandbox-controls",
"to": "agent-runtime-impl:codex.runtime@1.x",
"kind": "about_subject"
},
{
"from": "claim:codex-research-mcp-support",
"to": "agent-runtime-impl:codex.runtime@1.x",
"kind": "about_subject"
},
{
"from": "claim:codex-research-cli-approval-flag",
"to": "agent-runtime-impl:codex.runtime@1.x",
"kind": "about_subject"
},
{
"from": "claim:codex-research-approval-policy-permission-modes",
"to": "agent-runtime-impl:codex.runtime@1.x",
"kind": "about_subject"
},
{
"from": "claim:codex-research-sandbox-modes",
"to": "agent-runtime-impl:codex.runtime@1.x",
"kind": "about_subject"
},
{
"from": "mcp-transport:stdio",
"to": "agent-runtime-impl:codex.runtime@1.x",
"kind": "spoken_by",
"attributes": {}
},
{
"from": "mcp-transport:streamable-http",
"to": "agent-runtime-impl:codex.runtime@1.x",
"kind": "spoken_by",
"attributes": {}
}
]
}