Key Changes Docker file API migration Docker file APIs now run entirely inside a running container. This changes compatibility for applications that relied on host-side file access: images need /bin/sh and GNU filesystem utilities, including realpath, and access uses the container's default user or explicit runAs. Use a compatible image and suitable file permissions. Editor updates accept source f…
What's Changed fix: preserve model settings for GPT-5 and newer models by @seratch in #1850 Documentation & Other Changes docs: document v0.17.1 SDK updates by @seratch in #1742 chore: update versions by @github-actions[bot] in #1852 Full Changelog: v0.17.1...v0.17.2
What's Changed feat: add server-wide MCP tool guardrails by @seratch in #1754 feat: allow custom output guardrail blocked messages by @seratch in #1745 feat(sandbox): allow labels on Docker sandbox containers by @seratch in #1740 feat: support image results in web search tools by @seratch in #1843 fix: enforce selected callable type alias contracts by @seratch in #1749 fix: preserve serialized app…
Key Changes Output-guardrail replay safety Serialized output-bearing approval checkpoints now fail closed with UserError when the SDK cannot prove which response owns a pending terminal tool output. Continue with the live RunState when possible, or start a new run from safe input instead of replaying ambiguous serialized items. When an output guardrail rejects a completed function-tool result used…
What's Changed feat(core): add model call timeouts by @seratch in #1679 feat(sandbox): add run-scoped sandbox working directories by @seratch in #1683 feat(sandbox): allow Docker sandboxes to disable networking by @seratch in #1695 feat(extensions): add Modal sandbox resource options by @seratch in #1693 fix(core): honor exact call approval decisions by @seratch in #1694 fix(sandbox): validate vie…
Key Changes Deterministic SDK testing utilities This release adds provider-neutral testing utilities through @openai/agents/testing, @openai/agents-core/testing, @openai/agents/realtime/testing, and @openai/agents-realtime/testing. ScriptedModel, scriptedSandboxSession(), and ScriptedRealtimeTransport let applications exercise runner, sandbox, and Realtime workflows without live model, sandbox, We…
Key Changes OpenAI client compatibility and the new default model This release requires openai 7.2 or later for applications that supply their own OpenAI client. Agents without an explicit model now use gpt-5.6-luna with reasoning.effort: "none" and text.verbosity: "low". Configure an explicit model or set OPENAI_DEFAULT_MODEL when an application needs a different default. MCP v2 negotiation with…
What's Changed feat: add session history transactions by @seratch in #1572 fix: resolve model-visible tool name collisions consistently by @seratch in #1565 fix: preserve approved tool results across output guardrails by @seratch in #1562 fix: preserve completed tool guardrail results by @seratch in #1578 fix: preserve inline compaction items across turns by @seratch in #1567 fix: preserve causal…
What's Changed feat: preserve sandbox environment secret references by @seratch in #1547 fix: preserve raw realtime transport event payloads by @seratch in #1550 fix: reject ephemeral paths during sandbox archive hydration by @seratch in #1553 fix: redact endpoint credentials from MCP transport errors by @seratch in #1551 fix: redact MCP URL credentials from external metadata by @seratch in #1552…
What's Changed fix(core): export lifecycle and agent tool helper types by @seratch in #1535 fix(sandbox): support native Windows paths in path grants by @seratch in #1538 fix(sandbox): allow Docker workdirs within path grants by @seratch in #1540 fix(sandbox): preserve verified Docker sessions across resumes by @seratch in #1541 Documentation & Other Changes docs: updates for v0.14.0 by @seratch i…
Key Changes Programmatic Tool Calling support The SDK now supports Programmatic Tool Calling, allowing supported models to generate hosted JavaScript that coordinates eligible tools and reduces their intermediate results. Program calls are preserved across streaming, sessions, replay, and serialized RunState. Refer to a simple example to see how it works. Sensitive model and tool data logging is n…
What's Changed feat(ai-sdk): support provider-executed tool search by @seratch in #1483 fix: decode base64 without host globals by @seratch in #1481 fix: correlate streamed text with output items by @seratch in #1486 Documentation & Other Changes docs: clarify sandbox client support on Windows by @seratch in #1489 chore: upgrade pnpm toolchain by @seratch in #1487 chore: bump E2B version by @matth…
What's Changed fix: preserve stream usage reported on non-final chunks by @sohumt123 in #1474 fix: fail union/tuple schema conversion instead of silently dropping members by @parthkinro in #1476 fix(ai-sdk): concatenate all text parts in non-streaming responses by @LeSingh1 in #1475 Documentation & Other Changes fix: preflight pnpm upgrades against action setup by @seratch in #1470 chore: update v…
What's Changed fix: avoid tracing process lifecycle listeners in workerd by @brien-oai in #1467 Documentation & Other Changes docs: document hosted multi-agent and GPT-5.6 request controls by @seratch in #1459 chore: update versions by @github-actions[bot] in #1464 New Contributors @brien-oai made their first contribution in #1467 Full Changelog: v0.13.2...v0.13.3
What's Changed feat: support GPT-5.6 request controls by @seratch in #1463 feat: add experimental hosted multi-agent support by @seratch in #1458 fix: resolve workspace packages from source in Vitest by @seratch in #1449 fix: restore run usage when deserializing RunState by @winklemad in #1451 fix(realtime): surface provider error when /realtime/calls fails by @RahulGopathi in #1461 Documentation…
What's Changed feat: add compatible defaults for GPT-5.6 model families by @seratch in #1454 fix(openai): support openai 6.46.0 usage types by @HAYDEN-OAI in #1453 Documentation & Other Changes docs: updates for v0.13.0 by @seratch in #1447 chore: update pnpm and development dependencies by @seratch in #1450 chore: update versions by @github-actions[bot] in #1452 New Contributors @HAYDEN-OAI made…
Key Changes RealtimeAgent's default is now gpt-realtime-2.1 Since this version, the default model for RealtimeAgents is gpt-realtime-2.1: https://developers.openai.com/api/docs/models/gpt-realtime-2.1 What's Changed feat: update realtime default model to gpt-realtime-2.1 by @seratch in #1446 Documentation & Other Changes docs: updates for v0.12.1 by @seratch in #1445 chore: update versions by @git…
What's Changed feat: add invalid final output recovery handler by @seratch in #1444 fix: #1396 restore system messages in conversation history by @Epochex in #1397 fix: reject invalid handoff input filters by @fallintoplace in #1427 fix: accept OpenAI clients across module resolution modes by @seratch in #1433 fix: avoid replaying acknowledged tool results on resume by @seratch in #1437 refactor:…
What's Changed fix(core): avoid reevaluating resolved tool approvals by @seratch in #1418 fix(core): preserve empty array tool outputs by @seratch in #1419 fix(core): parse special permission bits by position by @seratch in #1421 fix(core): await sibling guardrails after failures by @seratch in #1420 fix(core): distinguish remote mount edit guidance by @seratch in #1422 fix(realtime): prevent ambi…
What's Changed feat: add opt-in pre-approval tool input guardrails by @seratch in #1358 feat: add SDK-only custom data for tool outputs by @seratch in #1360 Documentation & Other Changes chore: update versions by @github-actions[bot] in #1411 Full Changelog: v0.11.7...v0.11.8
What's Changed feat: expose serializable full MCP tool results by @seratch in #1380 fix: expose sandbox error retryability metadata by @seratch in #1398 fix: delegate incomplete auth to Vercel SDK by @scotttrinh in #1405 fix: recover legacy session authentication through Vercel SDK by @seratch in #1410 fix: update Modal sandbox provider for Modal SDK 0.7.6 APIs by @thomelane in #1381 fix: honor to…
What's Changed feat: add tracing span lifecycle dispatch helpers by @seratch in #1372 fix: set model metadata on generation span in streaming + chat completions by @imxinde in #1368 Documentation & Other Changes chore(deps): bump the npm_and_yarn group across 3 directories with 1 update by @dependabot[bot] in #1364 chore: update versions by @github-actions[bot] in #1370 New Contributors @imxinde m…
What's Changed feat: add opt-in recovery for missing function tools by @seratch in #1336 feat: add configurable tracing ID generation by @seratch in #1344 feat: add Handoff clone overrides by @seratch in #1348 feat: add scoped trace context helpers by @seratch in #1347 feat: add RunState trace clearing for resumed runs by @seratch in #1356 feat: add completed tracing lifecycle dispatch helpers by…
What's Changed fix: avoid empty chat completions tool outputs by @seratch in #1309 fix: avoid auto responses for unknown realtime tools by @seratch in #1310 fix: preserve local approval rejection reasons by @seratch in #1311 fix: abort active tracing exports on shutdown timeout by @seratch in #1313 fix: preserve reasoning identities for OpenAI Conversations persistence by @seratch in #1308 Documen…
What's Changed fix: make tracing shutdown best-effort on process exit by @seratch in #1306 Documentation & Other Changes docs: update MCP examples by @seratch in #1305 chore: update versions by @github-actions[bot] in #1307 Full Changelog: v0.11.2...v0.11.3
What's Changed fix: add configurable sandbox archive extraction limits by @seratch in #1299 fix: include structured sandbox provider error details by @seratch in #1301 fix: include Cloudflare sandbox exec and cleanup error details by @seratch in #1300 fix: preserve GitRepo root subpath aliases by @seratch in #1294 fix: validate sandbox GitRepo subpaths by @seratch in #1290 fix: guard no-op tracing…
What's Changed fix(sandbox): align Blaxel parity behavior by @mstolarzblaxelai in #1276 fix: preserve sandbox env resolvers across manifest merges by @mstolarzblaxelai in #1275 Documentation & Other Changes docs: updates for v0.11.0 by @seratch in #1271 docs: update translated document pages by @github-actions[bot] in #1274 chore: update versions by @github-actions[bot] in #1277 New Contributors @…
Key Changes RealtimeAgent's default is now gpt-realtime-2 Since this version, the default model for RealtimeAgents is gpt-realtime-2: https://developers.openai.com/api/docs/models/gpt-realtime-2 Sandbox local source materialization change In this version, sandbox local source materialization keeps LocalFile.src and LocalDir.src within the materialization baseDir unless the source path is covered b…