Release 0.12.1

[github-actions]

Release readiness review (v0.12.0 -> TARGET 559dc45)

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

Diff

v0.12.0...559dc45

Release call:

🟢 GREEN LIGHT TO SHIP Patch release scope is focused, test coverage was added for the runtime behavior change, and no concrete blocking regressions were found in the diff evidence.

Scope summary:

• 30 files changed (+1588/-614); key areas touched: src/agents/run_context.py, src/agents/run_state.py, src/agents/run_internal/{tool_execution.py,turn_resolution.py}, src/agents/realtime/session.py, targeted tests under tests/, docs updates (including retry docs and translations), and version bump to 0.12.1.

Risk assessment (ordered by impact):

1. RunState schema writer advanced to 1.6 in a patch release

• Risk: 🟡 MODERATE. Mixed-version environments can hit state handoff incompatibility if newer snapshots are consumed by older SDKs.
• Evidence: src/agents/run_state.py changes CURRENT_SCHEMA_VERSION from 1.5 to 1.6, and to_json() always writes current schema; compatibility tests were updated in tests/test_run_state.py.
• Files: src/agents/run_state.py, tests/test_run_state.py, docs/release.md.
• Action: Add/confirm release note text explicitly warning that serialized RunState emitted by 0.12.1 requires readers that support schema 1.6; pass criterion is a published note in release artifacts.

2. Approval rejection-message flow changed across runner + realtime paths

• Risk: 🟢 LOW. Behavior changed but is strongly covered by new targeted tests for explicit-message precedence, namespace handling, and MCP reason propagation.
• Evidence: Runtime additions in run_context.py, tool_execution.py, turn_resolution.py, and realtime/session.py; new tests in tests/test_agent_runner.py, tests/test_run_context_approvals.py, tests/test_run_context_wrapper.py, tests/test_run_step_execution.py, tests/realtime/test_session.py.
• Files: src/agents/run_context.py, src/agents/run_internal/tool_execution.py, src/agents/run_internal/turn_resolution.py, src/agents/realtime/session.py, tests/test_agent_runner.py, tests/test_run_step_execution.py, tests/realtime/test_session.py.
• Action: Run focused regression suite for rejection behavior; pass criterion is all related tests green:
  • uv run pytest -s tests/test_agent_runner.py -k rejection
  • uv run pytest -s tests/test_run_state.py -k rejection
  • uv run pytest -s tests/test_run_step_execution.py -k rejection
  • uv run pytest -s tests/realtime/test_session.py -k reject

Notes:

• Working tree is clean (git status --short returned no changes).
• Base and target were resolved from local tags/HEAD as requested (BASE_TAG=v0.12.0, TARGET=559dc45e4b0a21a1814c1ea0f8a3889bf04d89ff).
• Local verification commands were not executed in this CI review step; assessment assumes standard CI verification for the target commit.