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 toolChoice per 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

• fix(realtime): sync OpenAI realtime model type list by @seratch in #1010

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

v0.5.0

Key Changes

WebSocket Mode for OpenAI Responses API

This version adds WebSocket mode support for OpenAI's Responses API. This is a new opt-in feature, so the default behavior is unchanged. If you want to switch all Responses API calls to WebSocket mode, call setOpenAIResponsesTransport('websocket') to enable it for all OpenAI Responses model agents.

You can also use withResponsesWebSocketSession o enable a reusable WebSocket connection, as shown below:

import { Agent, withResponsesWebSocketSession } from '@openai/agents';

const agent = new Agent({
  name: 'Assistant',
  instructions: 'You are a helpful assistant.',
  model: 'gpt-5.2-codex',
});
await withResponsesWebSocketSession(async ({ run }) => {
  const streamed = await run(agent, 'Say hello in one sentence.', {
    stream: true,
  });
  for await (const _event of streamed.toStream()) {
    // Drain the stream.
  }
  console.log(streamed.finalOutput);
});

References:

• https://developers.openai.com/api/docs/guides/websocket-mode
• #1004

What's Changed

• feat: add responses websocket transport and websocket session helper by @seratch in #1004

Documents & Other Changes

• docs: add missing changes by @seratch in #1002
• docs: update translated document pages by @github-actions[bot] in #1003
• chore: change #1004 to minor version changes by @seratch in #1007
• chore: update versions by @github-actions[bot] in #1006

Full Changelog: v0.4.15...v0.5.0

v0.4.15

What's Changed

• fix(agents-core): respect tracingDisabled for function tool calls by @anishhegde in #1000

Documents & Other Changes

• chore(deps): bump the npm_and_yarn group across 1 directory with 2 updates by @dependabot[bot] in #998
• chore: update versions by @github-actions[bot] in #1001

New Contributors

• @anishhegde made their first contribution in #1000

Full Changelog: v0.4.14...v0.4.15

v0.4.14

What's Changed

• fix(agents-core): preserve nested agent-tool approval attribution on restore by @seratch in #996

Documents & Other Changes

• chore: update versions by @github-actions[bot] in #997

Full Changelog: v0.4.13...v0.4.14

v0.4.13

Key Changes

reasoningItemIdPolicy: omit for reasoning models

To mitigate 400 errors caused by an inconsistent set of items when using reasoning models, this release introduces the reasoningItemIdPolicy: 'omit' option for Runner options and the run utility. This is a new, opt-in option, so the default behavior is unchanged.

const result = await run(
  agent,
  'What is the weather in San Francisco?',
  { reasoningItemIdPolicy: 'omit' },
);

What's Changed

• fix(agents-core): rehydrate RunState interruption items on resume by @seratch in #993
• fix(agents-core): persist reasoning item ID policy across resumes and clarify filter interaction by @seratch in #991
• fix(agents-core): await parallel input guardrails before resolving turn in non-streaming run by @panilya in #992

Documents & Other Changes

• chore: update versions by @github-actions[bot] in #994

New Contributors

• @panilya made their first contribution in #992

Full Changelog: v0.4.12...v0.4.13

v0.4.12

What's Changed

• feat: #987 pass run context into applyPatch editor operations by @seratch in #990
• fix: #582 prevent duplicate realtime session events after reconnect by @seratch in #980
• fix: #551 preserve pre-tool assistant transcript in realtime agent_end events by @seratch in #982
• fix: #722 normalize data URL images for AI SDK providers by @seratch in #983
• fix: #479 avoid Bun browser startup crash when shim modules are temporarily unresolved by @seratch in #984
• fix: #579 use streamed chunk IDs in Chat Completions traces and output items by @seratch in #985
• fix: #302 propagate output guardrail context types to OutputGuardrailFunctionArgs by @seratch in #986
• fix: #116 respect toolChoice none overrides after tool lifecycle updates by @seratch in #988
• fix: #257 normalize response message content metadata into providerData by @seratch in #989

Documents & Other Changes

• docs: update a few document pages by @seratch in #976
• docs: update translated document pages by @github-actions[bot] in #978
• chore: update versions by @github-actions[bot] in #981

Full Changelog: v0.4.11...v0.4.12

v0.4.11

What's Changed

• fix: normalize realtime turnDetection modelVersion to model_version by @seratch in #968
• fix: #972 emit tracing function spans for shell, apply_patch, and computer tools by @seratch in #975

Documents & Other Changes

• docs: add function tool timeouts by @seratch in #966
• docs: update translated document pages by @github-actions[bot] in #969
• chore(changesets): switch OpenAI package group from linked to fixed versioning by @seratch in #971
• chore: update versions by @github-actions[bot] in #970

Full Changelog: v0.4.10...v0.4.11

v0.4.10

What's Changed

• feat(core,realtime): add function tool timeouts by @seratch in #965

Documents & Other Changes

• chore: update versions by @github-actions[bot] in #967

Full Changelog: v0.4.9...v0.4.10