// AI Platform Drift
OpenAI Agents Python SDK v1.0.0-alpha.1 breaks Agent.run() and Session.submit() APIs
OpenAI Agents Python SDK releases · published 2026-11-21 07:11 UTC
WHAT CHANGEDOpenAI released v1.0.0-alpha.1 of the Agents Python SDK with breaking API changes. Agent.run() and Session.submit() from v0.24.0-alpha.8 are replaced by Runner.run() and Runner.run_streamed(). SessionState checkpoints from alpha.8 are incompatible with the new Runner's RunState format. The release adds Codex as an opt-in model provider via CodexProvider and is distributed exclusively through GitHub Releases, not PyPI. Requires Python 3.10–3.14.
WHY IT MATTERSExisting code using Agent.run() or Session.submit() will break on upgrade. Saved SessionState checkpoints from v0.24.0-alpha.8 cannot be resumed in v1.0.0-alpha.1, requiring fresh SDK sessions for conversation history. Any automation or CI that expects PyPI distribution will fail to find the package.
WHAT TO DOBefore upgrading, complete all pending native runs and approvals in your v0.24.0-alpha.8 environment. Migrate execution calls from Agent.run()/Session.submit() to Runner.run()/Runner.run_streamed() and import Agent, Runner, and RunConfig from agents instead of agents.classic. Update installation scripts to fetch wheels from GitHub Releases using the platform-specific URLs provided in the release notes.
Model-reported confidence 95% (not measured accuracy)
Primary source ↗
written by anthropic/claude-sonnet-4.5
Show the reasoning — raw diff, triage verdict, confidence
RAW DIFF
+## Agents SDK v1.0.0-alpha.1 +https://github.com/openai/openai-agents-python/releases/tag/v1.0.0-alpha.1 +2026-11-20T20:51:28Z + +Agents SDK v1.0.0-alpha.1 +This first preview from feat/simple-codex adds Codex as an opt-in model provider for the Python Agents SDK. The prebuilt openai-agents wheels (version 1.0.0a1) are available exclusively through GitHub Releases. +Highlights + +Choose Codex per run. Import CodexProvider from agents.models.codex and create provider = CodexProvider(). Pass RunConfig(model_provider=provider) to the Runner. Codex uses your saved login. For API key authentication, use CodexProvider(api_key=...). The provider selects the model for agents that use a model name or the default model. Run the same agent with either provider +Reuse Codex Core inside Python. The wheel embeds unmodified Codex Core rust-v0.166.0 through PyO3. Direct calls to Core eliminate codex app-server startup and JSON-RPC. Reuse the provider to share one ThreadManager across calls. Each call gets a fresh thread. Use an SDK session for history and close the provider with await provider.aclose() when you finish. Thread lifetime and history · Codex source +Use SDK tools and approvals. Stream text, hand off to a specialist, pause for approval before a Python tool runs, and validate typed output. Native commands follow Codex's sandbox and approval settings. A native approval prompt ends the model call. Execution and approvals · Supported tools and model settings + +Install and try it +Activate a virtual environment with standard CPython 3.10–3.14. Copy the link for your platform and replace WHEEL_URL in the command below. Each link includes the SHA-256 digest that pip checks when it downloads the wheel. Checksums for all four wheels +Linux x86-64 (glibc 2.28+) · Linux ARM64 (glibc 2.28+) · macOS 11+ on Apple silicon · Windows x64 +python -m pip install --only-binary=:all: "WHEEL_URL" +To try the wildlife example, check out v1.0.0-alpha.1 and run the command below from the repository root with the wheel installed. If your only credential is a saved Codex login, set OPENAI_AGENTS_DISABLE_TRACING=1 in your shell first. Wildlife example · Authentication +python -I examples/model_providers/codex_provider.py --codex +Fixed + +Automatic session compaction uses local conversation history for Codex, including after an approval pause. Compaction needs its own OpenAI client or credentials. Session compaction +Saved sandbox manifests preserve inline binary files when you resume a run. If you share these manifests, upgrade all readers before saving non-UTF-8 content. Use LocalFile when older SDKs need to read the manifest. Manifest compatibility + +Moving from the harness preview +If you use Agent.run() or Session.submit() in v0.24.0-alpha.8, move execution to Runner.run() or Runner.run_streamed() and select CodexProvider in your run config. If you use agents.classic, import Agent, Runner, and RunConfig from agents. Previous harness release · Runner example +Finish pending native runs and approvals in your alpha.8 environment. Its SessionState checkpoints use a different format from the Runner's RunState. Start a fresh SDK session for conversation history in alpha.1. SDK sessions +Release verification +The SDK suite passed on the merged feat/simple-codex commit. CI built all four wheels and tested fresh installs on CPython 3.10 and 3.14 on each platform. We verified all four downloads against SHA256SUMS. Source 87e8f533 · SDK tests · Wheel builds and installation checks +We also ran the wildlife example with a live model and the Linux x86-64 wheel on CPython 3.12. The specialist identified an American bison from the photo, called the Python catalog tool, and returned a typed report with record ID synthetic-bison-001. Example and assertions
HOW IT WAS JUDGED
Triage signals below are model-reported assertions, preserved verbatim; they are not independent arithmetic verification.
| triage verdict | MATERIAL at 0.92, needed 0.5 |
|---|---|
| triage reasoning | Major version with breaking API changes, new provider, deployment model shift, and session incompatibility. |
| signals | new major version release (v1.0.0-alpha.1) · new model provider added (Codex) · breaking API changes (Agent.run() → Runner.run(), Session.submit() → Runner.run_streamed()) · authentication method changes (CodexProvider with api_key parameter) · deployment change (wheels available exclusively via GitHub Releases, not PyPI) · session state incompatibility (SessionState vs RunState format difference) · minimum Python version specified (3.10–3.14) · new execution model (Runner-based instead of harness-based) |
| suppression | — |
| triage model | anthropic/claude-haiku-4.5 ($0.00000) |
| writer model | anthropic/claude-sonnet-4.5 ($0.00000) |