Repository navigation
release: 0.25.0 - #5394
release: 0.25.0#5394
Conversation
Codex Review Summary: ✅ CompletedThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
deb3250 to
793faf2
Compare
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 793faf29cb
ℹ️ About Codex in GitHub
Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".
91a43cd to
1e21202
Compare
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 4ee48e51ac
ℹ️ About Codex in GitHub
Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".
8dbe7bc to
d18702a
Compare
5c10e86 to
f0f338f
Compare
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: f0f338f594
ℹ️ About Codex in GitHub
Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".
c5b2c3d to
0ee3299
Compare
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: f74b0af042
ℹ️ About Codex in GitHub
Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".
deddf64 to
3984b8d
Compare
seratch
left a comment
There was a problem hiding this comment.
Approve local release review 4cd46a6
Release readiness review (v0.24.0 -> TARGET 4cd46a6)
This is a release readiness report done by $final-release-review skill.
Diff
Release intent
- Review mode: final candidate
- Intended release: minor, 0.25.0
- Minimum required release type: minor. Existing Pydantic checkpoint callers can need a serializer where v0.24.0 omitted an unset field, and previously supported MCP dependency pins can require an upgrade.
- Versioning verdict: compatible
Release call
🟢 GREEN LIGHT TO SHIP. The candidate provides migration paths for the compatibility changes. The package metadata, editable lock entry, Release Please manifest, source version and frozen API baseline agree on 0.25.0.
Scope summary
- 261 files changed (+14,052/-17,143) across the SDK, tests, examples, documentation and release workflows. Relative to current
mainatfd78fa038f853598ed849e25eec78bab1e49aa00, #5394 changes only six release metadata files. The frozen API snapshot records its generating commite03c7157f7629ff60aa3e434f2f083f72e4c7ba9, the candidate's parent.
Risk assessment (ordered by impact)
-
Runloop sandbox migration
- Risk: 🟢 LOW with migration. Applications using the beta Runloop integration must switch providers before upgrading or stay on 0.24.0 during migration.
- Evidence: The candidate removes the
runloopextra,agents.extensions.sandbox.runloop, and the Runloop exports. The migration guide identifies the supported Modal client and explains how provider-specific state affects the move. - Files:
pyproject.toml,src/agents/extensions/sandbox/__init__.py,examples/sandbox/extensions/README.md - Action: Preserve needed workspace data first. For Modal, install
openai-agents[modal], replace the client and options inSandboxRunConfig, adapt mounts, and restore data into a new sandbox. Existing Runloop session IDs and snapshots cannot be resumed directly by Modal.
-
Checkpoint readers and Pydantic context serialization
- Risk: 🟢 LOW with ordered deployment. A v0.24.0 worker rejects a new
1.22checkpoint. A Pydantic context with a process-local default, such as a client object, can now require an explicit serializer. - Evidence: v0.25.0 still reads
1.21and writes1.22to track approvals owned by nested agent tools. Pydantic context snapshots now include default values and in-place edits using JSON serialization. - Files:
src/agents/run_state.py,tests/test_run_state_pydantic_context.py - Action: Upgrade resume workers before enabling new writers, or route checkpoints by SDK version. Use
context_serializerto exclude or transform process-local fields andcontext_deserializerorcontext_overrideto restore the application context.
- Risk: 🟢 LOW with ordered deployment. A v0.24.0 worker rejects a new
-
Model defaults and dependency pins
- Risk: 🟢 LOW with explicit configuration. Applications that leave the compaction model unset will use a different model. Dependency locks may also need updates.
- Evidence:
OpenAIResponsesCompactionSessionchanges its default fromgpt-4.1togpt-6-luna. MCP now requires>=1.30.0,<3,!=2.0.*,!=2.1.*. The Daytona extra requiresdaytona>=0.226.1,<1. - Files:
src/agents/memory/openai_responses_compaction_session.py,src/agents/models/default_models.py,pyproject.toml - Action: Set
model="gpt-4.1"on the compaction session to retain its previous model. Refresh incompatible dependency pins. With MCP v2 Streamable HTTP, enable tool retries only when replaying a call is safe.
Documentation coverage (non-blocking)
- Coverage source: Reviewed the current open PRs. No separate open PR covers the 0.25.0 user-guide updates below.
- Status: partially covered.
- Covered obligations: The sandbox extension examples document the Runloop-to-Modal migration and data preservation. The human-in-the-loop guide already describes context serializers and version-aware resume routing.
- Post-release updates:
- In
docs/human_in_the_loop.md, add the1.22reader-before-writer rollout order and a Pydantic example that excludes a process-local field. - In
docs/sessions/index.mdanddocs/models/index.md, distinguish the new compaction default from the agent model default, show themodel=override, and update GPT-5-and-newer reasoning model guidance. - In
docs/mcp.md, correct the dependency range and explain when retrying concurrent Streamable HTTP tool requests is safe. Indocs/handoffs.md, document the Runner-onlyfailure_error_functionand its default exception behavior. - In
docs/sandbox/clients.md, link the Runloop migration, record the Daytona range and refresh the localized provider tables. Inexamples/sandbox/external_provider/README.md, qualify the local co-install command: the standalone example declares>=0.24.0,<0.25.0and cannot be installed alongside this candidate with that constraint.
- In
- Publication timing: Publish the 0.25.0 guidance after the package is available.
Key Changes draft
Key Changes
Version 0.25.0 removes the beta Runloop sandbox provider and changes how Pydantic run contexts are checkpointed. Runloop users should preserve their workspace data before switching providers. Applications that share checkpoints across workers should upgrade readers first.
Highlights:
- Migrate Runloop workloads to another supported sandbox provider, such as Modal, or remain on 0.24.0 while migrating. Provider-specific sessions and snapshots require a separate data migration.
- Resume nested agent-tool approvals with output guardrails using RunState schema
1.22. Pydantic checkpoints now preserve default values and in-place edits. Use a custom serializer for process-local resources. OpenAIResponsesCompactionSessionnow defaults togpt-6-luna. Setmodel="gpt-4.1"to keep the previous choice. Agent model settings also follow the selected model more closely. Native Chat Completions tool requests forgpt-6-solandgpt-6-lunadefault to non-reasoning mode when no effort is supplied.- Runner handoffs can opt into recovery with
failure_error_function. Omitting it preserves exception propagation. The demo REPL can now approve or reject individual tool calls. - MCP v2 Streamable HTTP supports concurrent requests. MCP v1 retains serialized requests. Failed and incomplete Responses calls now retain provider-reported token usage.
|
🤖 Created releases: 🌻 |
Automated release candidate. Actions freezes the API contract and performs release-readiness review. Merge only after required checks and code-owner approval. See .github/RELEASING.md.
0.25.0 (2026-11-17)
Features
Bug Fixes
This PR was generated with Release Please. See documentation.