openai/openai-agents-python v0.22.0

on GitHub

Key Changes

Version 0.22.0 is a minor release because it adds substantial runtime hardening and tightens an existing provider configuration contract. Applications that combine an explicit openai_client with organization or project must move those values to the AsyncOpenAI client.

Highlights:

• Redacts terminal function-tool output rejected by agent output guardrails from replayable and persisted SDK state.
• Raises ModelBehaviorError for non-streaming Responses with terminal status failed or incomplete.
• Rejects conflicting provider options when OpenAIProvider receives an explicit client.
• Isolates usage accounting between independent RunState checkpoints while preserving nested-agent aggregation.
• Expands agents registered through handoff(agent) in generated graphs.
• Clarifies the existing shallow-copy behavior of Agent.clone() and RealtimeAgent.clone().

What's Changed

• fix(core): redact blocked tool outputs from replay state by @seratch in #4507
• fix(core): reject ignored explicit-client options for OpenAIProvider by @sylvesterkaczmarek in #4497
• fix(core): preserve Griffe logger inheritance by @sylvesterkaczmarek in #4494
• fix(core): reject terminal failed/incomplete responses in non-streaming get_response by @weike-zhang in https://github.* * fix(core): isolate usage between RunState checkpoints by @chiruu12 in #4479
  fix(sandbox): require apply_patch update hunks by @li2631026381-alt in #4470
• fix(sandbox): enforce Windows mypy compatibility by @seratch in #4499
• fix(tracing): respect model-data logging redaction for record_model_error_on_span by @sylvesterkaczmarek in #4496
• fix(tracing): clean up processors after tracing is disabled by @sylvesterkaczmarek in #4502
• fix(visualization): expand handoff() targets in agent graphs by @hsusul in #4517

Documentation & Other Changes

• docs: document v0.21.1 runtime behavior by @seratch in #4460
• docs: correct Agent.clone list attribute semantics by @thegoodengineer in #4474
• docs: add testing resources to llms indexes by @teachershuang in #4509
• ci: align Python version coverage by @seratch in #4475
• test: use sys.executable instead of tee for the stdio placeholder command by @ErenAta16 in #4478
• fix: keep Codex verification for development sandboxed by @seratch in #4508
  com//pull/4516
• release: 0.22.0 by @seratch in #4523

New Contributors

• @li2631026381-alt made their first contribution in #4470
• @thegoodengineer made their first contribution in #4474
• @teachershuang made their first contribution in #4509
• @weike-zhang made their first contribution in #4516
• @chiruu12 made their first contribution in #4479

Full Changelog: v0.21.1...v0.22.0