Current section
Files
Jump to
Current section
Files
guides/provider_behavior_manifest.md
# Codex Provider Behavior Manifest
Provider-native Codex behavior must be proven here before this SDK translates
it. This manifest is SDK-owned evidence; it is not proof that ASM can expose the
feature as common behavior across providers.
| Feature | Evidence type | CLI version/source revision | Fixture | Live smoke | Known unsupported semantics | Date verified |
| --- | --- | --- | --- | --- | --- | --- |
| `codex exec --json` argument rendering for model, reasoning config, profile, sandbox, working directory, additional directories, output schema, continuation/cancellation, and image flags | source inspection note and SDK render tests | current Codex CLI contract as represented by SDK options | `test/codex/runtime_exec_render_test.exs`; `test/codex/exec_test.exs` | `examples/promotion_path/sdk_direct_codex.exs` | Codex-native exec flags; ASM must not accept these as generic provider options without all-four proof | 2026-04-29 |
| App-server transport, dynamic tools, MCP notifications, approval requests, sandbox policy, and permission profiles | source inspection note, recorded app-server fixtures, and live examples | current Codex app-server contract | `test/codex/app_server_transport_test.exs`; `examples/live_app_server_dynamic_tools.exs`; `examples/live_app_server_approvals.exs` | Existing app-server live examples | Codex-native only; does not establish common ASM host tools, approvals, MCP, or sandbox policy | 2026-04-29 |
| Shared `execution_surface` normalization for local and SSH placement | source inspection note and SDK runtime tests | current `cli_subprocess_core` dependency | `test/codex/exec_test.exs`; `test/codex/runtime_exec_render_test.exs` | `examples/promotion_path/sdk_direct_codex.exs` for local keyword input; live SSH tests remain opt-in | Placement only; execution surface metadata must not become provider-native Codex configuration | 2026-04-29 |
| GPT-5.6 Sol/Terra/Luna and GPT-5.3-Codex-Spark model selection with model-specific defaults and effort sets | upstream model registry, official Codex docs, authenticated live model probe, SDK projection tests, and live Spark exec | `codex-cli 0.144.1`; upstream `bca577d69a`; live `model/list` with `includeHidden: true` | `test/codex/models_test.exs`; `test/codex/options_test.exs`; `../cli_subprocess_core/test/cli_subprocess_core/model_registry_test.exs` | Authenticated probe and exact-OK Spark exec on 2026-07-10; Sol is default | Explicit CLI IDs only; no `gpt-5.6` API alias; Luna lacks `ultra`; Spark is text-only, Pro-only preview, and non-API | 2026-07-10 |
| ChatGPT login app branding/hosted success page and plugin install-policy source | upstream app-server v2 protocol and SDK request/typed-protocol tests | `codex-cli 0.144.0`; upstream `account.rs` and `plugin.rs` at `6ced1ac5eb` | `test/codex/app_server/api_test.exs`; `test/codex/protocol/plugin_test.exs` | Covered by the authenticated app-server initialization/model probe environment; no credential values recorded | Codex app-server only; not an ASM common auth/plugin contract | 2026-07-09 |
| Experimental Amazon Bedrock login request and persisted auth shape | upstream app-server protocol plus auth-store source and SDK request/store tests | upstream `54b8f112a3`; `LoginAccountParams::AmazonBedrock` and `AuthMode::BedrockApiKey` | `test/codex/app_server/account_bedrock_test.exs` | Not live-observable with installed `codex-cli 0.144.1` | Schema-only upstream: the current account processor returns an unimplemented error; requires experimental API initialization; Codex-native and not an ASM common auth contract | 2026-07-11 |