Release 0.18.0

[github-actions]

Release readiness review (v0.17.8 -> TARGET origin/main @ 4fde807)

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

Diff

v0.17.8...4fde807

Release call:

🟢 GREEN LIGHT TO SHIP No confirmed regression, compatibility break, or packaging failure; all 159 focused changed-area tests passed.

Scope summary:

• 23 files changed (+728/-443); key areas: Realtime default model, SQLAlchemy session serialization, agent visualization, examples, release documentation, and generated translations.
• Five commits after v0.17.8, including three runtime changes.

Risk assessment (ordered by impact):

1. Realtime default changes without matching English documentation

   • Risk: 🟡 MODERATE. Applications relying on the implicit model will move from gpt-realtime-2 to gpt-realtime-2.1 without code changes, while the README and English Realtime guides still recommend gpt-realtime-2.
   • Evidence: 909c5c434 updates DEFAULT_REALTIME_MODEL, the model type, examples, and tests. The [official model page](https://developers.openai.com/api/docs/models/gpt-realtime-2.1) confirms the model ID and Realtime capabilities.
   • Files: src/agents/realtime/openai_realtime.py, src/agents/realtime/config.py, README.md, docs/index.md, docs/realtime/quickstart.md, docs/realtime/guide.md
   • Action: Before publishing, update the English documentation and docs/release.md to describe the new default and explain that users can pin model_name. Pass condition: no English guide presents gpt-realtime-2 as the current SDK default.

2. New SQLAlchemy Unicode storage option

   • Risk: 🟢 LOW. The option is additive, keyword-only, appended to the public constructor, and defaults to the historical escaped JSON representation.
   • Evidence: ensure_ascii: bool = True preserves existing storage bytes; tests cover escaped and readable Unicode storage plus round trips. Constructor inspection confirmed existing parameter order is unchanged.
   • Files: src/agents/extensions/memory/sqlalchemy_session.py, tests/extensions/memory/test_sqlalchemy_session.py
   • Action: Document ensure_ascii=False in docs/sessions/sqlalchemy_session.md and the release notes. Pass condition: the opt-in behavior and encoding responsibility are discoverable without reading source code.

3. Visualization style merge

   • Risk: 🟢 LOW. The patch correctly replaces duplicate Graphviz style attributes with style="filled,rounded", preserving the handoff fill color.
   • Evidence: b4606c8f4; the visualization tests passed, and an actual SVG render contained fill="lightyellow".
   • Files: src/agents/extensions/visualization.py, tests/test_visualization.py
   • Action: Retain the current regression assertions. Pass condition: uv run pytest -q tests/test_visualization.py passes and rendered handoff nodes remain filled.

4. Release version and notes still represent v0.17.8

   • Risk: 🟢 LOW. This is normal for pre-release main, but the target cannot be published as a distinct package until the release commit updates its version.
   • Evidence: pyproject.toml and the installed package still report 0.17.8; no post-tag changes are yet summarized in docs/release.md.
   • Files: pyproject.toml, docs/release.md
   • Action: Have the release commit bump the next routine patch version to 0.17.9 and add the post-tag changes. Pass condition: the built distribution reports 0.17.9 and its notes cover the Realtime default, SQLAlchemy option, and visualization fix.

Notes:

• Remote verification confirmed v0.17.8 as the latest tag and origin/main at 4fde807f1fa6a79b6bc9332f10947bbced117349.
• Focused validation: 159 passed in 2.53s.
• uv lock --check, git diff --check, constructor/import smoke checks, and Graphviz SVG rendering passed.
• The working tree remained clean on main...origin/main.
• The skill’s CI assumption was retained; a full local verification stack was not rerun.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 2d5a05ff76

ℹ️ 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".