release: 0.22.1

[seratch]

Release readiness review (v0.22.0 -> TARGET 1114039)

This is a release readiness report done by $final-release-review skill.

Diff

v0.22.0...1114039

Release intent

• Review mode: final candidate
• Intended release: patch 0.22.1
• Minimum required release type: patch
• Versioning verdict: compatible

Release call

🟢 GREEN LIGHT TO SHIP The candidate is based on the latest origin/main, contains only the three release-owned files, passes the prospective artifact and final released-contract gates, and has no proven blocking regression.

Scope summary

• 225 files changed (+13,001/-2,933); key areas touched include core run and session behavior, MCP lifecycle and guardrails, sandbox isolation, Voice, tracing, provider adapters, public-contract enforcement, tests, and documentation.

Risk assessment (ordered by impact)

1. Broad behavior-impacting patch scope

   • Risk: 🟢 LOW. The release contains multiple backward-compatible fixes and additive capabilities across core runtime areas.
   • Evidence: The complete v0.22.0...TARGET diff was reviewed. No incompatible removal or required migration was identified. The prospective contract gate passed against built wheel and sdist artifacts, including optional-dependency profiles.
   • Files: src/agents/, tests/, integration_tests/
   • Action: Require the standard release PR checks to remain green before merge.

2. Expanded public API contract

   • Risk: 🟢 LOW. Two output-guardrail exports are added, while released exports are not removed. Concrete-state contracts now cover all intended public Voice implementations.
   • Evidence: The frozen contract contains 396 callables, 230 canonical imports, 79 public modules, 20 public properties, 3 public aliases, 4 public TypedDict contracts, and 10 public class-state contracts. OpenAIVoiceModelProvider and SingleAgentVoiceWorkflow are both frozen with abstract: false. Prospective completeness checks prevent future public Voice implementations from being omitted silently.
   • Files: tests/fixtures/released_api_contract.json, tests/fixtures/released_api_contract_policy.json, integration_tests/_contract_support.py, tests/test_released_api_contract.py
   • Action: Keep the generated v0.22.1 fixture unchanged and retain the passing released-contract check.

3. Release artifact and optional-dependency compatibility

   • Risk: 🟢 LOW. Packaging or optional-extra drift could otherwise differ from source-checkout behavior.
   • Evidence: make check-prospective-released-api-contract passed for wheel and sdist artifacts across the applicable optional-dependency profiles. make check-released-api-contract VERSION=0.22.1 also passed after materialization.
   • Files: pyproject.toml, uv.lock, integration_tests/packaging/
   • Action: No additional local remediation is required.

Documentation coverage (non-blocking)

• Coverage source: docs: document v0.22.1 behavior updates #4577 at d3b14237ac1a1c67db7385f9838ea1a3867f89fa; all 17 observed check runs completed successfully.
• Status: covered
• Covered obligations: MCP guardrails, Unix-local environment isolation, Voice context and settings, tracing behavior, guardrail results, usage, and related v0.22.1 behavior updates.
• Gaps or post-release suggestions: none. The added Voice contract-completeness enforcement is internal release tooling and creates no user documentation obligation.
• Publication timing: merge after release because the documentation describes behavior not available in the previous published release.

Notes

• Candidate parent and refreshed origin/main are both 9d1f4ea6c6d4c1e5e1f3d875a219f7ce8d23cde2.
• The release commit contains only pyproject.toml, uv.lock, and tests/fixtures/released_api_contract.json.
• The source main checkout remains clean and unchanged.
• No branch was pushed and no GitHub state was mutated.

[chatgpt-codex-connector]

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review	Status	Commit	Review trigger
📝 Code Review	✅ Completed 2026-08-25T02:50:23.623348Z	1114039	New commits
🔒 Security Review	✅ Completed 2026-08-25T02:50:02.552419Z	1114039	New commits

ℹ️ About Codex in GitHub

Your team has set up Codex to 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" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 9b14fff3dd

ℹ️ About Codex in GitHub

Your team has set up Codex to 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 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: cd7cce0e6b

ℹ️ About Codex in GitHub

Your team has set up Codex to 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 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 19f0378daf

ℹ️ About Codex in GitHub

Your team has set up Codex to 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 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".