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

v0.2.1

Key Changes

This should have been included in v0.2.0. Since this version, the underlying openai package's version range is 6.x.

What's Changed

• fix: upgrade openai package from v5 to v6 by @seratch in #617
• chore: update versions by @github-actions[bot] in #618

Full Changelog: v0.2.0...v0.2.1

v0.2.0

Key Changes

• #602 Tool outputs can include image/file in OpenAI's standard format (see the examples in the PR description)
• #609 This SDK now supports both zod 4 and zod 3

After releasing this version, we found that zod 4 support is still incomplete. We'll make this SDK functional with both zod 3 and 4 runtime, but as for the compatibility with TSC type checker, there are still things to work on. For now, please continue using zod 3 along with this SDK. See #617 for more details.

What's Changed

• Upgrade pnpm to the latest version by @seratch in #603
• Upgrade dependencies for dev, docs, and examples by @seratch in #604
• fix: #607 make main execution in examples consistent by @seratch in #608
• Fix: Handoff creation error when using onHandoff without inputType by @MuhammadHamidRaza in #611
• feat: #313 Enable tools to return image/file data to an Agent by @seratch in #602
• feat: #561 support both zod3 and zod4 by @seratch in #609
• add unit tests for uncovered patterns by @seratch in #616
• chore: update versions by @github-actions[bot] in #615

New Contributors

• @MuhammadHamidRaza made their first contribution in #611

Full Changelog: v0.1.11...v0.2.0