v0.3.9

What's Changed

• feat: Add experimental codex tool module by @seratch in #867
• fix(agents-core): #670 set subclass error names by @seratch in #862

Experimental: Codex Tool Support

Starting with this version, we have added a new experimental Codex extension (@openai/agents-extensions/experimental/codex). This extension allows you to use Codex as a tool within your agents. Since this module is still experimental, its behavior and implementation details may change in future releases.

If you run an agent with codexTool() on a host where Codex is installed, the agent will use Codex as a tool to answer the question. The tool simply runs the Codex CLI as a subprocess, so all existing Codex configuration, skills, and capabilities are available without any additional setup.

See the example code and #862 for more details.

Documents & Others

• docs: add docs-sync skill guidance by @seratch in #857
• docs: align agent guides after $docs-sync audit by @seratch in #858
• ci: fix changeset milestone selection for patch bumps by @seratch in #863
• ci: Add pnpm-upgrade skill and automated job by @seratch in #865
• chore(deps): bump the npm_and_yarn group across 0 directory with 3 updates by @dependabot[bot] in #866
• Update all translated document pages by @github-actions[bot] in #859
• chore: update versions by @github-actions[bot] in #864

Full Changelog: v0.3.8...v0.3.9

v0.3.8

What's Changed

• fix: stabilize run resumption and tool execution pipeline by @seratch in #827
• feat: Add tool input/output guardrails to TS SDK by @seratch in #812
• feat: Add per-run tracing API key support by @seratch in #813
• feat: Add ai-sdk v3 support and improve other provider compatibility; fix #770 #791 by @seratch in #814
• feat: #794 Expose ToolInputParameters and ToolOptions from the top-level exports so wrappers can import the tool types by @seratch in #795
• fix: opt-in run state enhancement for #813 by @seratch in #834
• fix: Skip response_format when "text" in Chat Completions calls by @seratch in #835
• fix: #709 Share tracing context across runtimes to prevent Deno + ai-sdk context loss by @seratch in #828
• fix: #799 Expose raw input and validation error in tool parsing failures by @shrirajh in #800
• fix: Fix #809 chat completions tool calls when content is present by @seratch in #817
• fix(realtime): #820 null values for noise_reduction / transcription / turn_detection are ignored by @seratch in #822
• fix: #816 preserve falsy turn detection config values by @seratch in #819
• fix: sanitize conversation items for non-OpenAI models in HITL flow by @seratch in #845
• fix: whitelist realtime session tool payload to documented fields by @seratch in #849
• fix(agents-extensions): #802 handle object based token usage in ai-sdk wrapper by @ArpitMishra17 in #805
• fix: Fix streaming cancellation to abort promptly and resolve completion on cancel by @seratch in #818
• fix: Add content: null when having tool calls for Chat Completions by @seratch in #815
• fix: terminate streamable HTTP MCP sessions safely with typed guard by @seratch in #837
• refactor: #275 simplify streaming state by removing unused index tracking by @nexo-tech in #841
• fix: #829 Ensure generated declarations are type-checked and expose PreparedInputWithSessionResult by @seratch in #830
• chore(deps): bump @modelcontextprotocol/sdk from 1.24.0 to 1.25.1 in the npm_and_yarn group across 1 directory by @dependabot[bot] in #811
• chore(deps): bump @modelcontextprotocol/sdk from 1.25.1 to 1.25.2 in the npm_and_yarn group across 1 directory by @dependabot[bot] in #821

Documents

• docs: #804 improve the retry document section to be accurate by @seratch in #823
• Update all translated document pages by @github-actions[bot] in #824
• Improve guardrail tripwire logic in examples by @RajKKapadia in #803
• feat(examples): add HITL session scenario coverage with rehydration and rejections by @seratch in #842

Misc

• Upgrade pnpm to the latest patch version and dev deps as well by @seratch in #797
• chore(deps): bump the npm_and_yarn group across 3 directories with 1 update by @dependabot[bot] in #798
• Upgrade pnpm to 10.27.0; dev/docs dependencies too by @seratch in #810
• misc: Add verify-changes skill for project maintainers by @seratch in #826
• Add regression tests covering agent scenarios by @seratch in #832
• Add example runner script by @seratch in #833
• chore: Rename verify-changes and tweak its behavior, add MCP server skills by @seratch in #836
• docs: clarify completion report guidance in AGENTS.md by @seratch in #838
• docs: add pr-draft-summary skill instructions by @seratch in #839
• feat: expand example runner filtering and refresh sample images by @seratch in #840
• docs: move exec plan guide to repo root by @seratch in #846
• feat: add examples auto-run helper and refresh example workflows by @seratch in #848
• Upgrade pnpm, dev, and docs deps by @seratch in #850
• misc: add integration-tests skill guide by @seratch in #851
• Add two more agent skills by @seratch in #852
• Add unit tests using $test-coverage-improver by @seratch in #853
• ci: add Codex changeset validation workflow by @seratch in #854
• ci: add release PR review automation by @seratch in #856
• chore: update versions by @github-actions[bot] in #796

New Contributors

• @shrirajh made their first contribution in #800
• @RajKKapadia made their first contribution in #803
• @ArpitMishra17 made their first contribution in #805
• @nexo-tech made their first contribution in #841

Full Changelog: v0.3.7...v0.3.8

v0.3.7

What's Changed

• fix: Fix a bug where MCP servers don't use clientSessionTimeoutSeconds (re-fix for #781) by @seratch in #787
• chore: update versions by @github-actions[bot] in #788

Documents

• Update documents for new responses.compact session by @seratch in #784
• Update all translated document pages by @github-actions[bot] in #786
• Adjust sessions docs and upgrade dev/docs dependencies by @seratch in #789
• Update all translated document pages by @github-actions[bot] in #790

Full Changelog: v0.3.6...v0.3.7

v0.3.6

What's Changed

• feat: Add responses.compact-wired session feature by @seratch in #760
• fix: Add usage data integration to #760 feature addition by @seratch in #785
• fix: Enable creating/disposing Computer per agent run ref: #663 by @seratch in #771
• fix: Fix a bug where MCP servers don't use clientSessionTimeoutSeconds by @seratch in #781
• fix(agents-openai): #777 add gpt-image-1-mini and gpt-image-1.5 support to imageGenerationTool by @JoelCCodes in #776
• fix: #775 tracing: previousSpan is not correctly set by @seratch in #782
• feat: Literal unions: preserve completions by narrowing string branches by @seratch in #783
• Upgrade GitHub Actions to latest versions by @salmanmkc in #774
• Upgrade GitHub Actions for Node 24 compatibility by @salmanmkc in #773
• pnpm 10.26.0 by @seratch in #780
• chore: update versions by @github-actions[bot] in #779

Documents

• docs: document updates for #749 streaming for agents as tools by @seratch in #755
• Update all translated document pages by @github-actions[bot] in #769

New Contributors

• @salmanmkc made their first contribution in #774
• @JoelCCodes made their first contribution in #776

Full Changelog: v0.3.5...v0.3.6

v0.3.5

What's Changed

• feat(realtime): Add usage field to input audio transcription completed event by @lion8 in #724
• fix: support input_file for chat completions when possible by @danielmklein in #735
• Upgrade dev and docs dependencies by @seratch in #738
• chore(deps): bump @modelcontextprotocol/sdk from 1.12.1 to 1.24.0 in the npm_and_yarn group across 1 directory by @dependabot[bot] in #737
• Fix #732 Ensure SpanData types are exported by @lattwood in #731
• fix(agents-extensions): ##711 improve AI SDK error details in tracing by @AryanBagade in #740
• feat(agents-extensions): #628 add Anthropic extended thinking support by @AryanBagade in #742
• Upgrade pnpm to 10.25.0 by @seratch in #743
• fix: #701 prevent duplicate function_call items in session history after resuming from interruption by @mjschock in #702
• fix: #745 Export OpenAIConversationsSessionOptions by @seratch in #747
• fix: #753 Emit agent_tool_end event when function tools throw errors by @aasullivan in #754
• fix: propagate providerData for function_calls in chat completions converter by @danielmklein in #746
• feat: track token usage while streaming responses for openai models by @ianyimi in #750
• feat: Add onStream/on(key) handlers to an agent as tool by @seratch in #749
• fix: event data adjustment for #749 by @seratch in #764
• feat: #762 Add turnInput (optional) to agent_start event hooks by @seratch in #765
• chore: update versions by @github-actions[bot] in #728

Documents

• fix(security): patch CVE-2025-66478 Next.js RCE vulnerability by @ben-vargas in #736
• docs(ai-sdk): #758 document actual scripts and prerequisites by @Harrrryz in #759
• docs: Upgrading to GPT-5.2 by @cguo-oai in #766
• Update all translated document pages by @github-actions[bot] in #767

New Contributors

• @lion8 made their first contribution in #724
• @danielmklein made their first contribution in #735
• @ben-vargas made their first contribution in #736
• @lattwood made their first contribution in #731
• @AryanBagade made their first contribution in #740
• @mjschock made their first contribution in #702
• @Harrrryz made their first contribution in #759
• @cguo-oai made their first contribution in #766

Full Changelog: v0.3.4...v0.3.5

v0.3.4

What's Changed

• docs: document updates for #687 runInParallel option for input guardrails by @seratch in #688
• fix: #699 Forward fetch parameter to SSEClientTransport in MCPServerSSE by @aasullivan in #700
• feat: Add ToolOptions to agents-core package export by @ianyimi in #704
• fix: strip leading {} from streaming tool call arguments (Bedrock) by @anton-tw in #712
• fix: #708 data: string in an input_image message item does not work with some providers by @seratch in #717
• fix: preserve Gemini thought_signature in multi-turn tool calls by @shibu-web in #718
• feat: #713 Access tool call items in an output guardrail by @seratch in #716
• feat: #695 Customizable MCP list tool caching by @seratch in #715
• Upgrade pnpm to 10.24.0 by @seratch in #720
• chore: update versions by @github-actions[bot] in #714

New Contributors

• @aasullivan made their first contribution in #700
• @ianyimi made their first contribution in #704
• @anton-tw made their first contribution in #712
• @shibu-web made their first contribution in #718

Full Changelog: v0.3.3...v0.3.4

v0.3.3

What's Changed

• feat: Add prompt_cache_retention option to ModelSettings by @seratch in #668
• fix: #638 add unit tests demonstrating how to get usage in streaming mode by @seratch in #673
• fix: #316 developer-friendly message for output type errors by @seratch in #672
• fix: #675 top-level voice param in realtime session config does not work by @seratch in #677
• fix: #683 Failing to run MCP servers when deserializing run state data by @seratch in #685
• fix: #523 transcript removal issue when being interrupted by @seratch in #674
• feat: #678 Add a list of per-request usage data to Usage by @seratch in #686
• feat: #679 Add runInParallel option to input guardrail initialization by @seratch in #687
• chore: update versions by @github-actions[bot] in #671

Full Changelog: v0.3.2...v0.3.3

v0.3.2

What's Changed

• feat: Add reasoning.effort: none parameter for gpt-5.1 by @seratch in #657
• fix: Omit tools parameter when prompt ID is set but tools in the agent is absent by @seratch in #658
• fix: #638 Add usage data from stream on response (Chat Completions) by @rclayton-godaddy in #652
• chore: update versions by @github-actions[bot] in #661

New Contributors

• @rclayton-godaddy made their first contribution in #652

Full Changelog: v0.3.1...v0.3.2

v0.3.1

What's Changed

• docs: Add the Sessions feature document page by @seratch in #627
• docs: Add Realtime SIP document section by @seratch in #632
• Update all translated document pages by @github-actions[bot] in #644
• Add shell and apply patch by @dkundel-openai in #653
• chore: update versions by @github-actions[bot] in #654

Full Changelog: v0.3.0...v0.3.1

v0.3.0

Key Changes

• #420 Memory feature using sessions store - see the document page and examples for details
• #624 SIP protocol support in realtime agent runner - see the document page and the Twilio SIP example app for details

What's Changed

• Upgrade Astro version for serving document site by @seratch in #619
• docs: fix spelling mistake in tools.mdx by @tobiasbueschel in #621
• fix: non-OpenAI models w/ OpenRouter send an empty string when calling tools by @ertembiyik in #499
• fix: #613 Listen to peerConnection state in OpenAIRealtimeWebRTC to detect disconnects by @IM594 in #620
• Upgrade pnpm to 10.20.0 by @seratch in #626
• feat: fix #272 add memory feature by @seratch in #420
• feat: #439 add SIP support for realtime agent runner by @seratch in #624
• fix: #633 fix a bug where tracingDisabled in realtime config does not work by @seratch in #637
• fix: #639 Type issue with realtime agent handoffs by @seratch in #641
• chore: update versions by @github-actions[bot] in #625

New Contributors

• @tobiasbueschel made their first contribution in #621
• @ertembiyik made their first contribution in #499
• @IM594 made their first contribution in #620

Full Changelog: v0.2.1...v0.3.0