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

v0.4.9

What's Changed

• fix(tracing): avoid internal dist type imports in OpenAI tracing exporter by @seratch in #959
• fix(tracing): propagate trace metadata to spans for processors by @seratch in #964

Documents & Other Changes

• docs: update docs to reflect recent changes by @seratch in #960
• docs: update translated document pages by @github-actions[bot] in #962
• chore: update versions by @github-actions[bot] in #961

Full Changelog: v0.4.8...v0.4.9

v0.4.8

What's Changed

• fix(tracing): #954 preserve generation usage metadata via usage.details by @seratch in #956
• fix(agents-realtime): wait for session.updated ack before resolving connect() by @jamierpond in #949

Documents & Other Changes

• chore: update versions by @github-actions[bot] in #958
• docs: update SSE endpoint to Streamable HTTP in examples by @seratch in #957

New Contributors

• @jamierpond made their first contribution in #949

Full Changelog: v0.4.7...v0.4.8

v0.4.7

Key Changes

Hosted container tool + Skills

This release includes the hosted shell runtime tool along with its native skills support. Developers now can pass a container-based shell runtime with skills this way:

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

const agent = new Agent({
  name: 'Container Shell Agent',
  model: 'gpt-5.2',
  instructions: 'Use the available container to answer user requests.',
  tools: [
    shellTool({
      environment: {
        type: 'container_auto',
        skills: [{type: 'skill_reference', skillId: "skill_698bbe879adc81918725cbc69dcae7960bc5613dadaed377", version: "1"}],
      },
    }),
  ],
});

Check the following examples for more details:

• https://github.com/openai/openai-agents-js/blob/main/examples/tools/container-shell-inline-skill.ts
• https://github.com/openai/openai-agents-js/blob/main/examples/tools/container-shell-skill-ref.ts

References:

• Hosted shell: https://developers.openai.com/api/docs/guides/tools-shell#hosted-runtime-details
• Skills API: https://developers.openai.com/api/docs/guides/tools-skills
• Skills Cookbook: https://developers.openai.com/cookbook/examples/skills_in_api

What's Changed

• feat: support shell tool environment + skills by @seratch in #950
• fix(agents-extensions): #945 map AI SDK cacheRead usage to cached_tokens by @seratch in #946
• fix(agents-openai): omit named tool_choice when prompt supplies tools by @seratch in #951
• fix(agents-core): preserve legacy ShellTool typing and strict shell pending statuses by @seratch in #952

Documents & Other Changes

• docs: clarify Codex run-context threading guidance and examples by @seratch in #942
• docs: update translated document pages by @github-actions[bot] in #943
• chore: upgrade pnpm to 10.29.2 by @seratch in #948
• chore: update versions by @github-actions[bot] in #947

Full Changelog: v0.4.6...v0.4.7

v0.4.6

What's Changed

• feat(extensions): add codex run-context thread reuse and same-thread workflow by @seratch in #940
• chore(deps): bump @modelcontextprotocol/sdk from 1.25.2 to 1.26.0 in the npm_and_yarn group across 1 directory by @dependabot[bot] in #939

Documents & Other Changes

• chore: upgrade dev deps by @seratch in #936
• chore(skills): migrate repository skill paths to .agents/skills by @seratch in #935
• docs(guides): add missing option coverage across runner, mcp, sessions, and extensions by @seratch in #937
• docs: update translated document pages by @github-actions[bot] in #938
• chore: update versions by @github-actions[bot] in #941

Full Changelog: v0.4.5...v0.4.6

v0.4.5

What's Changed

• feat: #921 add structured input builders for agent tools by @seratch in #924
• feat: add MCP server errorFunction support by @seratch in #926
• feat: add MCP tool meta resolver support by @seratch in #919
• feat: #663 add computer tool approvals and run context arg by @seratch in #920
• feat: #763 add onSafetyCheck hook for computer safety checks by @seratch in #925
• feat(core,realtime): add configurable approval-rejection tool error messages by @seratch in #932
• fix: #932 consider traceIncludeSensitiveData option by @seratch in #933
• fix: populate streamed chat completion choices in generation traces by @seratch in #934
• fix: preserve zod descriptions in json schema output by @seratch in #923

Documents & Other Changes

• chore(deps): bump the github-actions group with 2 updates by @dependabot[bot] in #928
• chore(deps): bump fastify from 5.3.3 to 5.7.3 in the npm_and_yarn group across 1 directory by @dependabot[bot] in #931
• chore(deps): bump the npm_and_yarn group across 4 directories with 1 update by @dependabot[bot] in #918
• chore: update versions by @github-actions[bot] in #922

Full Changelog: v0.4.4...v0.4.5

v0.4.4

What's Changed

• fix: #680 resume nested agent tool approvals after interruptions by @seratch in #916

Documents & Other Changes

• chore(deps): bump hono from 4.11.4 to 4.11.7 in the npm_and_yarn group across 1 directory by @dependabot[bot] in #913
• chore: upgrade pnpm to 10.28.2 by @seratch in #915
• chore: update versions by @github-actions[bot] in #917

Full Changelog: v0.4.3...v0.4.4