v0.12.2

What's Changed

• fix: #2664 drop orphan hosted shell calls before multi-turn replay by @seratch in #2665
• fix: #2258 add normalized to_input_list mode for filtered handoff follow-ups by @seratch in #2667

Documentation & Other Changes

• docs: update translated document pages by @github-actions[bot] in #2663
• Release 0.12.2 by @github-actions[bot] in #2666

Full Changelog: v0.12.1...v0.12.2

v0.12.1

What's Changed

• feat: #2658 preserve explicit approval rejection messages across resume flows by @seratch in #2660

Documentation & Other Changes

• docs: add retry settings by @seratch in #2655
• docs: update translated document pages by @github-actions[bot] in #2656
• Release 0.12.1 by @github-actions[bot] in #2662

Full Changelog: v0.12.0...v0.12.1

v0.12.0

Key Changes

Opt-in retry settings

New opt-in settings for retries of model API calls is available in this version. The new configuration is available as part of ModelSettings and it can be passed either as run config or model settings per an agent.

Refer to the following code examples for details:

• https://github.com/openai/openai-agents-python/blob/main/examples/basic/retry.py
• https://github.com/openai/openai-agents-python/blob/main/examples/basic/retry_litellm.py

What's Changed

• feat: add opt-in model retry policies by @seratch in #2651

Documentation & Other Changes

• Release 0.12.0 by @github-actions[bot] in #2653

Full Changelog: v0.11.1...v0.12.0

v0.11.1

What's Changed

• fix: show the GA computer alias in tracing by @seratch in #2641

Documentation & Other Changes

• docs: add tool search coverage across Python guides by @seratch in #2622
• docs: cover GA computer tool migration across Python guides by @seratch in #2629
• docs: update translated document pages by @github-actions[bot] in #2640
• Release 0.11.1 by @github-actions[bot] in #2642

Full Changelog: v0.11.0...v0.11.1

v0.11.0

Key Changes

Tool search support

As of this version, the Agents SDK supports the tool search tool, including namespaces: https://developers.openai.com/api/docs/guides/tools-tool-search/

Please refer to this concrete example, as well as the updated documentation.

Computer use tool GA

As of this version, you can use the gpt-5.4 model for the computer use tool, in addition to the existing computer-use-preview model: https://developers.openai.com/api/docs/guides/tools-computer-use/

Please refer to this concrete example, as well as the updated documentation.

What's Changed

• feat: add Responses API tool search support by @seratch in #2610
• fix: #2624 migrate ComputerTool to the GA computer tool by @seratch in #2626
• fix: #2636 make Computer preview metadata optional on GA requests by @seratch in #2639
• fix: Serialize structured realtime tool outputs as JSON by @lavish0000 in #2608
• fix: Finish reasoning summaries before text deltas by @lavish0000 in #2609
• fix: #2617 lower minimum pydantic version to 2.12.2 by @seratch in #2620
• fix(memory): make SQLiteSession satisfy Session protocol by @lavish0000 in #2619
• fix: align RunState schema policy with release boundaries by @seratch in #2632
• fix: preserve plain run context for run-context tool wrappers by @seratch in #2634
• fix: #2603 preserve MCP tool title metadata across tool call items by @seratch in #2621
• fix: enable handling video_url in litellm and chat completions models by @seokhyunan in #2614

Documentation & Other Changes

• docs: updates for #2593 by @seratch in #2594
• docs: refresh docs and examples to gpt-5.4 by @seratch in #2615
• docs: Add local shell skill example by @ihower in #2612
• docs: update translated document pages by @github-actions[bot] in #2606
• docs: update translated document pages by @github-actions[bot] in #2613
• docs: update translated document pages by @github-actions[bot] in #2616
• docs: update translated document pages by @github-actions[bot] in #2627
• chore: run pyright across src and tests in typecheck by @seratch in #2623
• test: improve coverage for tracing and runtime helpers by @seratch in #2635
• Release 0.11.0 by @github-actions[bot] in #2611

New Contributors

• @lavish0000 made their first contribution in #2608
• @seokhyunan made their first contribution in #2614

Full Changelog: v0.10.5...v0.11.0

v0.10.5

What's Changed

• feat: #2492 add explicit MultiProvider prefix modes by @seratch in #2593
• fix: #879 return McpError as a structured error result instead of crashing the agent run by @adityasingh2400 in #2598

Documents & Other Changes

• docs: improve doc coverage for Dapr sessions and advanced model settings by @seratch in #2587
• docs: update translated document pages by @github-actions[bot] in #2589
• docs: clarify realtime transport boundaries and SIP attach flows by @seratch in #2591
• docs: update translated document pages by @github-actions[bot] in #2592
• docs: clarify agent runtime, handoff, HITL, and results flows by @seratch in #2596
• docs: update translated document pages by @github-actions[bot] in #2597
• chore: add implementation strategy guidance for compatibility decisions by @seratch in #2600
• docs: fix deprecated capwords import for Python 3.11+ compatibility by @Jah-yee in #2605
• Release 0.10.5 by @github-actions[bot] in #2595

New Contributors

• @adityasingh2400 made their first contribution in #2598
• @Jah-yee made their first contribution in #2605

Full Changelog: v0.10.4...v0.10.5

v0.10.4

What's Changed

• fix: isolate parallel function tool failures by @seratch in #2584

Documents & Other Changes

• docs: improve documentation entry points and navigation by @seratch in #2578
• docs: update translated document pages by @github-actions[bot] in #2579
• docs: update translated document pages by @github-actions[bot] in #2581
• ci: add repeated async teardown stability checks by @seratch in #2585
• Release 0.10.4 by @github-actions[bot] in #2582

Full Changelog: v0.10.3...v0.10.4

v0.10.3

What's Changed

• feat: expose immutable agent tool invocation metadata on run results (ref #2575) by @seratch in #2576
• feat: #2247 add RunResult tool_context accessor for agent tools by @seratch in #2575
• perf: use deque for BFS queue and voice task ordering by @giulio-leone in #2559

Documents & Other Changes

• docs: update translated document pages by @github-actions[bot] in #2555
• docs: Add nest_handoff_history to Handoffs docs by @Hammad-Noman in #2560
• docs: update translated document pages by @github-actions[bot] in #2561
• docs: update a few docs and code comments by @seratch in #2564
• docs: update translated document pages by @github-actions[bot] in #2565
• docs: reorganize navigation and clarify runtime guides by @seratch in #2568
• docs: update translated document pages by @github-actions[bot] in #2570
• docs: update translated document pages by @github-actions[bot] in #2571
• docs: change http to https in tracing links by @04cb in #2572
• test: speed up make tests with xdist and deterministic waits by @seratch in #2563
• test(mcp): assert runner emits tool_call_output_item on MCP failures by @OiPunk in #2556
• chore(deps): bump astral-sh/setup-uv from 7.2.1 to 7.3.1 by @dependabot[bot] in #2566
• chore(deps): bump actions/stale from 10.1.1 to 10.2.0 by @dependabot[bot] in #2567
• Release 0.10.3 by @github-actions[bot] in #2569

New Contributors

• @giulio-leone made their first contribution in #2559
• @Hammad-Noman made their first contribution in #2560
• @04cb made their first contribution in #2572

Full Changelog: v0.10.2...v0.10.3

v0.10.2

What's Changed

• fix: #2540 reattach resumed traces without duplicate trace starts by @seratch in #2547
• fix: #260 sanitize oversized tracing span payloads by @seratch in #2549
• fix: Require approval for callable MCP policies when agent is omitted by @tiffanycitra in #2553
• fix: #1121 expose model request IDs on raw responses by @seratch in #2552

Documents & Other Changes

• docs: structure improvements by @seratch in #2538
• docs: update translated document pages by @github-actions[bot] in #2539
• Release 0.10.2 by @github-actions[bot] in #2548

New Contributors

• @tiffanycitra made their first contribution in #2553

Full Changelog: v0.10.1...v0.10.2

v0.10.1

What's Changed

• fix: sync realtime model literals in realtime config by @seratch in #2535

Documents & Other Changes

• docs: add responses websocket support by @seratch in #2533
• docs: update translated document pages by @github-actions[bot] in #2534
• Release 0.10.1 by @github-actions[bot] in #2536

Full Changelog: v0.10.0...v0.10.1