// AI Platform Drift
OpenAI Agents JS SDK v0.22.0-alpha.3 rejects previously ignored Session.enqueue() ifBusy option
OpenAI Agents JavaScript SDK releases · published 2026-11-16 22:01 UTC
WHAT CHANGEDSession.enqueue() now rejects the previously ignored ifBusy option. session.enqueue(input) retains queueing behavior. session.submit(input, { ifBusy: 'reject' }) rejects while the Session is busy. AgentOptions<Context, Output> now requires a matching outputType for non-string Output types. Tool callbacks can now overlap by default in native catalogs with only automatic tools; maxFunctionConcurrency: 1 on agent.run() or agent.session() preserves one-at-a-time admission per turn. Linux bundles require glibc 2.39 or later and OpenSSL 3. Windows x64 requires the x64 Visual C++ Redistributable.
WHY IT MATTERSCode passing ifBusy to Session.enqueue() will now throw instead of silently ignoring the option. Applications with shared mutable state or side effects in tool callbacks may experience race conditions under concurrent admission. Non-string Output types without matching outputType declarations will fail type checking. Existing Linux deployments on older glibc versions cannot run the new bundles.
WHAT TO DOGrep for Session.enqueue() calls with ifBusy and replace with session.submit(input, { ifBusy: 'reject' }) where rejection is intended. Add maxFunctionConcurrency: 1 to agent.run() or agent.session() calls if tool callbacks share mutable state. Add matching outputType to AgentOptions for non-string Output types. Verify Linux hosts run glibc 2.39+ and OpenSSL 3 before upgrading.
Model-reported confidence 85% (not measured accuracy)
Primary source ↗
written by anthropic/claude-sonnet-4.5
Show the reasoning — raw diff, triage verdict, confidence
RAW DIFF
+## v0.22.0-alpha.3 +https://github.com/openai/openai-agents-js/releases/tag/v0.22.0-alpha.3 +2026-11-16T21:06:52Z + +Highlights + +Native Agents have been gaining typed Decisions through agent.decide(), callback-bound ctx.decide(), and OpenAIDecisions. These calls have been taking explicit input and returning a boolean, a constrained choice, or a supported structured value. DecisionHandoff has been using Decisions to choose among the Agents configured for a native text handoff. Typed Decisions +Native Agents have been supporting application-owned model backends through ResponsesModel, ChatCompletionsModel, and AiSdkModel, including streamed output within each adapter's limits. Provider and model configuration +Native Realtime and voice have been expanding across Node.js, browsers, React Native, and Workers. The new controls have been covering audio input, response timing, history edits, usage, and SIP or browser call setup. Native voice +Native LocalStorage has been gaining named profiles, history queries, edits, and forks. The SDK has also been adding memory, artifact, and UI helpers for sandbox workflows. Local profiles · History and checkpoints +Local executors have been gaining read-only workspaces and opt-in trusted_workspace_write on Linux and macOS. Trusted workspace writes have been allowing broader host reads while limiting writes to granted roots. Applications have also been opting into AGENTS.md discovery. Local execution · Project guidance + +Upgrade actions + +Tool callbacks can now overlap. Native catalogs with only automatic tools have been admitting callbacks concurrently by default. Shared mutable state or side effects can race. Setting maxFunctionConcurrency: 1 on agent.run() or agent.session() has been preserving one-at-a-time admission per turn. Function admission +Session.enqueue() has been rejecting the previously ignored ifBusy option. session.enqueue(input) has been retaining queueing. session.submit(input, { ifBusy: 'reject' }) has been rejecting while the Session is busy. Session methods +AgentOptions<Context, Output> has been requiring a matching outputType for non-string Output types. Output configuration +Serialized Classic sandbox restores have been requiring trusted bindings from application configuration. UnixLocal restores have been using resumeAuthority.workspaceRootPath or resumeAuthority.localSnapshotPath where applicable. UnixLocal and Docker remote snapshot restores have been requiring a separately trusted resumeAuthority.remoteSnapshotId. Sandbox resume and snapshots +TypeScript code with exhaustive switches has been gaining new observation variants and the http_json request mode to handle. Applications injecting a client into the new OpenAIDecisions adapter have been requiring openai 7.30.0 or later. Provider and model configuration · Typed Decisions +Bundled installations have been using five matching packages from one version and platform. Checkpoint restores have been requiring the same native Codex revision and the matching trusted declarations, output settings, and executor policy. Local bundle installation · Checkpoint compatibility + +Added + +Native tools have been gaining namespaces, concurrency limits, caller restrictions, managed approvals, client-side tool search, and configurable error formatting. Native MCP has been adding discovery filters, cache controls, per-tool approvals, and borrowed aliases. Native tools · MCP configuration +Native provider options have been adding scoped headers and query parameters, explicit WebSocket routes, provider-managed history, buffered Responses JSON, hosted prompts, and retry controls. Native text sessions have been gaining registered Sign in with ChatGPT and saved Codex CLI login routes. Provider configuration +beforeComplete has been letting applications inspect proposed output and continue or stop the current turn. turn.acceptedText() has been exposing exact accepted text prefixes during generation. Accepted output + +Fixed + +Native Responses HTTP requests, provider-history reads, and Responses WebSocket handshakes have been identifying the SDK as openai_agents_js and reporting the installed package version in User-Agent. Request identity fix +Native ESM and CommonJS imports from one SDK installation have been sharing class and tool identity on supported Node.js configurations. Realtime Node.js entry points have also been sharing one implementation. Module identity +Native cleanup and recovery have been preserving terminal-tool ownership, child settlement, cancellation, MCP callback errors, and accepted executor grants across supported continuations. Recovery + +Bundle installation +The prerelease has been targeting Linux x64, Linux ARM64, macOS Apple silicon, and Windows x64. The Linux bundles have been requiring glibc 2.39 or later and OpenSSL 3. The Windows x64 bundle has been requiring the x64 Visual C++ Redistributable. + +Platform +Starter bundle +SHA-256 checksums + +Linux x64 +Download starter +Checksums + +Linux ARM64 +Download starter +Checksums + +macOS Apple silicon +Download starter +Checksums + +Windows x64 +Download starter +Checksums + +The starter checks have been using Node.js 24. The SHA256SUMS-<platform> file from the release has been providing the expected archive checksum. The following commands have been installing the starter from its extracted agents-starter directory and running the greeting with OPENAI_API_KEY set. The greeting has been making a live model request. +npm ci --ignore-scripts +node hello.mjs +The starter has been bundling the matching five SDK tarballs. For an existing application, the local bundle guide has been showing where to copy the tarballs and how to keep their versions aligned. The table has been listing the version and platform in each release asset name. Local bundle installation +Full comparison with alpha.2
HOW IT WAS JUDGED
Triage signals below are model-reported assertions, preserved verbatim; they are not independent arithmetic verification.
| triage verdict | MATERIAL at 0.92, needed 0.5 |
|---|---|
| triage reasoning | Multiple breaking API changes affecting session handling, output configuration, sandbox restoration, and model adapter requirements. |
| signals | breaking API change: Session.enqueue() now rejects previously ignored ifBusy option · breaking API change: AgentOptions<Context, Output> now requires matching outputType for non-string Output types · breaking API change: exhaustive switch handlers must handle new observation variants and http_json request mode · breaking API change: OpenAIDecisions adapter now requires openai 7.30.0 or later · breaking API change: Serialized Classic sandbox restores now require trusted bindings · breaking API change: UnixLocal and Docker remote snapshot restores require separately trusted resumeAuthority.remoteSnapshotId · new feature: tool callbacks can now overlap with maxFunctionConcurrency control · new feature: Typed Decisions through agent.decide() and ctx.decide() · new feature: application-owned model backends (ResponsesModel, ChatCompletionsModel, AiSdkModel) · new feature: Native Realtime and voice expansion across platforms · new feature: Local profiles with named storage, history queries, edits, forks · new feature: trusted_workspace_write on Linux and macOS · new feature: Native MCP with discovery filters and per-tool approvals · new feature: beforeComplete callback for output inspection · platform requirement: Linux bundles require glibc 2.39 or later and OpenSSL 3 · platform requirement: Windows x64 requires x64 Visual C++ Redistributable |
| suppression | — |
| triage model | anthropic/claude-haiku-4.5 ($0.00000) |
| writer model | anthropic/claude-sonnet-4.5 ($0.00000) |