Releases: openai/openai-agents-js
v0.8.1
What's Changed
- fix: #1122 hide ignored handoffs without breaking managed continuations by @seratch in #1123
- fix(agents-core): stabilize streamable HTTP reconnect retry test by @seratch in #1125
- fix(agents-core): hide streamed final output after guardrail failures by @seratch in #1124
- fix(realtime): defer response.create until the previous turn finishes by @seratch in #1127
- fix(agents-openai): omit empty computer safety checks on replay by @seratch in #1129
Documentation & Other Changes
- chore: update versions by @github-actions[bot] in #1126
Full Changelog: v0.8.0...v0.8.1
v0.8.0
Key Changes
This minor release does not introduce a breaking change, but it includes a notable Realtime default update plus MCP runtime stability fixes.
What's Changed
- fix: upgrade the default realtime model to gpt-realtime-1.5 by @seratch in #1108
- fix: recover segmented assistant output in agent tools and finalization by @seratch in #1117
- feat(mcp): add resource wrappers and streamable session ids by @seratch in #1111
- fix(mcp): resolve MCP server wrapper issues by @seratch in #1118
- fix: strip reasoning and approval placeholders from handoff filters by @seratch in #1115
Documentation & Other Changes
- docs: add PromptLayer tracing integration link by @adagradschool in #1106
- docs: update translated document pages by @github-actions[bot] in #1107
- docs: clarify streaming cancellation and resume behavior by @seratch in #1114
- docs: update translated document pages by @github-actions[bot] in #1116
- chore: upgrade pnpm toolchain to 10.32.1 by @seratch in #1103
- chore(deps): bump the npm_and_yarn group across 4 directories with 2 updates by @dependabot[bot] in #1105
- chore: add runtime behavior probe skill by @seratch in #1112
- chore(deps): bump h3 from 1.15.8 to 1.15.9 in the npm_and_yarn group across 0 directory by @dependabot[bot] in #1119
- chore(code-change-verification): parallelize fail-fast validation steps by @seratch in #1120
- chore: update versions by @github-actions[bot] in #1109
New Contributors
- @adagradschool made their first contribution in #1106
Full Changelog: v0.7.2...v0.8.0
v0.7.2
What's Changed
- fix: avoid replaying orphan hosted shell calls across turns by @seratch in #1099
- fix(agents-core): prune orphan hosted shell calls from public history by @seratch in #1102
Documentation & Other Changes
- docs: updates for #1091 feature addition by @seratch in #1092
- docs: update translated document pages by @github-actions[bot] in #1095
- docs: update translated document pages by @github-actions[bot] in #1096
- chore: update versions by @github-actions[bot] in #1101
Full Changelog: v0.7.1...v0.7.2
v0.7.1
What's Changed
Documentation & Other Changes
- docs: add retry settings by @seratch in #1087
- docs: update translated document pages by @github-actions[bot] in #1088
- fix(docs): scope the Zod v3 alias for Astro 6 by @seratch in #1094
- chore: update versions by @github-actions[bot] in #1093
Full Changelog: v0.7.0...v0.7.1
v0.7.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.
- https://github.com/openai/openai-agents-js/blob/main/examples/basic/retry.ts
- https://github.com/openai/openai-agents-js/blob/main/examples/ai-sdk/retry.ts
What's Changed
Documentation & Other Changes
- docs: clarify tool search support and namespace guidance by @seratch in #1072
- docs: computer tool updates by @seratch in #1074
- docs: update translated document pages by @github-actions[bot] in #1081
- chore: update versions by @github-actions[bot] in #1086
Full Changelog: v0.6.0...v0.7.0
v0.6.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.
Import path changes for AI SDK adapter users
If you have been using the @openai/agents-extensions package for the aisdk() helper, please migrate to importing it from @openai/agents-extensions/ai-sdk. The top-level import had been deprecated since version 0.4, and it has now been removed to allow developers to use the extensions package without AI SDK modules.
What's Changed
- feat: add Responses tool search support by @seratch in #1065
- fix: migrate ComputerTool to the GA computer tool by @seratch in #1073
- fix: allow GA computer tools without display metadata by @seratch in #1078
- fix(agents-extensions): remove deprecated top-level AI SDK exports by @seratch in #1061
- fix(agents-core): rehydrate custom client tool_search runtime tools on resume by @seratch in #1067
- fix: #1070 preserve MCP image mimeType in tool outputs by @seratch in #1071
- fix(agents-core): fold unreleased RunState schema changes into 1.8 by @seratch in #1075
Documents & Other Changes
- docs: update translated document pages by @github-actions[bot] in #1060
- chore(deps): bump fastify from 5.7.3 to 5.8.1 in the npm_and_yarn group across 1 directory by @dependabot[bot] in #1063
- fix: preserve canonical chat completions providerData fields by @seratch in #1064
- docs: refresh docs and examples to gpt-5.4 by @seratch in #1068
- docs: update translated document pages by @github-actions[bot] in #1069
- test: expand coverage for helper and session edge cases by @seratch in #1077
- fix(ci): serialize tsc-multi builds in GitHub workflows by @seratch in #1076
- chore: update versions by @github-actions[bot] in #1062
Full Changelog: v0.5.4...v0.6.0
v0.5.4
What's Changed
Documents & Other Changes
- docs: updates for #1036 by @seratch in #1037
- docs: update translated document pages by @github-actions[bot] in #1042
- docs: updates for #1040 by @seratch in #1041
- docs: update translated document pages by @github-actions[bot] in #1043
- docs: improve TypeScript docs entry points and guide navigation by @seratch in #1044
- docs: update translated document pages by @github-actions[bot] in #1045
- docs: update translated document pages by @github-actions[bot] in #1046
- chore: upgrade pnpm to 10.30.3 and clarify SHA pinning by @seratch in #1047
- docs: clarify dynamic prompts and runtime doc caveats by @seratch in #1048
- docs: update translated document pages by @github-actions[bot] in #1049
- docs: align agent and voice agent guides with current SDK behavior by @seratch in #1050
- docs: update translated document pages by @github-actions[bot] in #1051
- chore: upgrade dev & docs dependencies by @seratch in #1052
- docs: clarify run context, handoffs, and human-in-the-loop guides by @seratch in #1053
- docs: update translated document pages by @github-actions[bot] in #1054
- chore(deps): bump hono from 4.12.2 to 4.12.4 in the npm_and_yarn group across 1 directory by @dependabot[bot] in #1055
- chore: add implementation strategy guidance for compatibility decisions by @seratch in #1056
- chore: update versions by @github-actions[bot] in #1059
Full Changelog: v0.5.3...v0.5.4
v0.5.3
What's Changed
- feat: expose agent tool invocation metadata on run results by @seratch in #1040
- feat: #261 add ai-sdk output text transform hook for provider compatibility by @seratch in #1036
Documents & Other Changes
- docs: update translated document pages by @github-actions[bot] in #1023
- docs: update translated document pages by @github-actions[bot] in #1024
- docs: correct
toolChoiceper the example description by @TheSpiciestDev in #1026 - docs: refresh SDK guides and source-backed examples by @seratch in #1029
- docs: update translated document pages by @github-actions[bot] in #1030
- docs: follow-up changes for #1029 by @seratch in #1031
- docs: update translated document pages by @github-actions[bot] in #1032
- docs: update translated document pages by @github-actions[bot] in #1033
- docs: update README files by @seratch in #1038
- docs: Fix typo: recieves to receives by @04cb in #1039
- perf: speed up tracing and realtime unit tests by @seratch in #1027
- chore(deps): bump the github-actions group with 3 updates by @dependabot[bot] in #1035
- chore: update versions by @github-actions[bot] in #1028
New Contributors
- @TheSpiciestDev made their first contribution in #1026
- @04cb made their first contribution in #1039
Full Changelog: v0.5.2...v0.5.3
v0.5.2
What's Changed
- fix(agents-openai): sanitize oversized tracing span payloads by @seratch in #1019
- fix(agents-openai): preserve OpenAI Responses request IDs in raw responses by @seratch in #1021
- fix(agents-core): enum missing type field when not nullable by @alexian-ic in #1015
Documents & Other Changes
- docs: structure improvements by @seratch in #1013
- docs: update translated document pages by @github-actions[bot] in #1014
- chore(deps): bump hono from 4.12.0 to 4.12.2 in the npm_and_yarn group across 1 directory by @dependabot[bot] in #1017
- chore: update versions by @github-actions[bot] in #1016
New Contributors
- @alexian-ic made their first contribution in #1015
Full Changelog: v0.5.1...v0.5.2
v0.5.1
What's Changed
Documents & Other Changes
- docs: add responses websocket support by @seratch in #1008
- docs: update translated document pages by @github-actions[bot] in #1009
- chore: update versions by @github-actions[bot] in #1011
Full Changelog: v0.5.0...v0.5.1