release: v0.7.0 — remove CodexRuntime adapter#14
Merged
Conversation
Removes CodexRuntime, CodexOptions, the [codex] pip extra, the openai-codex-sdk dependency, and every test/probe/doc reference. The "codex" provider ID stays reserved for a future adapter wrapping OpenAI's official openai-codex Python SDK once it leaves alpha. Why: openai-codex-sdk on PyPI (what we wrapped) has murky provenance — it self-declares author "OpenAI" but isn't in github.com/openai/codex, and it's fallen behind the Codex CLI. The actually-official Python SDK is openai-codex (v0.131.0a4 alpha) with a different JSON-RPC architecture; neither package exposes models.list(). That made the post-v0.6.3 doctor false-negative (ChatGPT-OAuth tokens rejected by api.openai.com/ v1/models) fundamentally unfixable from inside the adapter. Wrapping uncertain-provenance code isn't earning its weight pre-1.0. Migration: pin airframe-agents<0.7 or move to ClaudeCodeRuntime, CopilotRuntime, BedrockRuntime, or an OpenAI-compat gateway adapter (OpenCodeZen / OpenCodeGo / OpenRouter). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
CodexRuntime,CodexOptions, the[codex]pip extra (openai-codex-sdk>=0.1.11),examples/probe_codex.py,docs/adapters/codex.md, and the four Codex test modules — plus every cross-reference in src docstrings, per-adapter docs, README, andCLAUDE.md.CodexRuntimeorairframe-agents[codex]. Per pre-1.0 SemVer convention the minor is bumped:0.6.3 → 0.7.0. CHANGELOG entry under## [0.7.0] — 2026-05-19.\"codex\"provider ID for a possible future adapter wrapping the officialopenai-codexPython SDK once it leaves alpha. The ID is not re-usable for any other vendor.KimiRuntimeadditions (PR feat(kimi): KimiRuntime scaffolding (Iteration A) #11) into the same release section, so v0.7.0 is the combined Kimi-add + Codex-remove cut.Why remove CodexRuntime?
Two things converged into the same root cause:
openai-codex-sdkon PyPI self-declaresauthor: OpenAIbut it does not live in OpenAI's officialgithub.com/openai/codexrepo, and it has fallen behind the Codex CLI's recent releases.openai-codex(currentlyv0.131.0a4— still alpha) atgithub.com/openai/codex/sdk/python, structured as a JSON-RPC app-server v2 over stdio. Not a drop-in replacement. And — critically — neither Python package exposesclient.models.list()(only the Node@openai/codexSDK does).That made the post-v0.6.3 doctor false-negative Maverick hit —
list_models()rejecting ChatGPT OAuth tokens againstapi.openai.com/v1/models— fundamentally unfixable from insideCodexRuntime.list_models()without hand-rolling more code on top of a package whose maintainership we can't verify. Wrapping uncertain-provenance code isn't earning its weight pre-1.0; cleaner to remove and revisit once the officialopenai-codexpackage stabilises.Migration
Direct users of
CodexRuntimeshould either:airframe-agents<0.7, orClaudeCodeRuntime,CopilotRuntime,BedrockRuntime, or an OpenAI-compat gateway (OpenCodeZenRuntime/OpenCodeGoRuntime/OpenRouterRuntime). Codex subscription holders can route through opencode adapters, which already accept the Codex provider on the opencode side.Test plan
make cigreen locally — 855 passed, 34 skipped after the scrub.uv lockrefreshed;openai-codex-sdk v0.1.11no longer pinned.CodexRuntime/CodexOptions/codex.pyreferences in src, tests, docs, README, or CLAUDE.md (verified with grep).0.7.0to PyPI.🤖 Generated with Claude Code