Date: 2026-11-08
Approved through issue #1202 and pull request #1204.
The carried @agentclientprotocol/codex-acp 1.6.2 snapshot depended on
@openai/codex 0.148.0 and launched that bundled CLI unless CODEX_PATH was
set. The bundled CLI's model catalog omitted models the host's installed CLI
advertised. For a configured model missing from its catalog, the adapter
offered a model choice with no effort selector, so XMD correctly refused an
explicit effort that the host CLI supports. Claude had the same gap and already
uses the host-installed CLI.
The maintainer directed: "we had a similar problem with claude and we changed it to use whatever version is installed on teh server. We shouldn't bundle anything." That direction replaces the alternative of pinning a newer bundled CLI.
The retained Codex adapter launches the Codex CLI installed on the execution
host: nonempty CODEX_PATH, otherwise codex on the host PATH, selected and
checked for launchability at the runtime host boundary. The adapter carries no
Codex CLI dependency and no executable fallback. The adapter protocol code stays
carried because it supplies the turn identity, acceptance and native identity
metadata no published adapter reports.
Codex keeps its maintained archive and generated snapshot route. A readable source patch against the recorded producer commit, with pinned lock and compiler inputs, reproduces the shipped executable bytes.
The host must provide a launchable Codex CLI. A host without one refuses before inference, and no bundled CLI supplies availability or a catalog.
Reproducibility covers the adapter bytes, not the host CLI they launch. Updating the host CLI can change ordinary availability and the advertised model and effort catalog while the adapter digest stays the same. A session offers whatever the selected host CLI reports.
A session continues quietly on whichever host CLI is selected today, under the provider's live confirmation of its original native identity, for every operation including native launch and attachment. The strict build equality this record first kept for native work was replaced by decision record 005.
The repacked snapshot has a new digest. It neither migrates saved records nor equates the old and new snapshot identities.