This release includes 1 breaking change for platform teams planning a safe upgrade.
✓ No known CVEs patched in this version
Topics
Summary
AI summaryDefault model changed to gpt-5.4-mini affecting implicit settings; new config options added for turn limits, tool concurrency, and MCP server naming.
Full changelog
Key Changes
Default model change
In this version, the SDK default model is now gpt-5.4-mini instead of gpt-4.1. This could affect agents and runs that do not explicitly set a model. Because the new default is a GPT-5 model, implicit default model settings now include GPT-5 defaults such as reasoning.effort="none" and verbosity="low".
The new default model should work better for most use cases (see the report at https://github.com/openai/openai-agents-js/pull/1248), but if you need to keep the previous default model behavior for some reasons, set a model explicitly on the agent or run config or set the OPENAI_DEFAULT_MODEL environment variable.
maxTurns configuration
This version adds a new option maxTurns=null to disable the Agents SDK run turn limit while preserving the existing default of DEFAULT_MAX_TURNS (10) when maxTurns is omitted.
Tool execution concurrency
This version adds a new SDK-side runtime configuration for local function tool execution concurrency: toolExecution.maxFunctionToolConcurrency on RunConfig, preserves default behavior when unset. The change keeps provider-side ModelSettings.parallelToolCalls separate from SDK-side local execution scheduling.
Server-prefixed MCP tool naming
This version adds a new option MCPConfigin Agent to align with the Python SDK. When Its includeServerInToolNames is set to true, the SDK includes the MCP server name in the tool name to prevent tool name conflicts with other MCP servers.
What's Changed
- feat: switch the default model to a newer mini model (affecting only when a model is unset) by @seratch in https://github.com/openai/openai-agents-js/pull/1248
- feat: allow maxTurns null to disable turn limits by @seratch in https://github.com/openai/openai-agents-js/pull/1247
- feat: accept manifest init shorthands in sandbox configuration by @seratch in https://github.com/openai/openai-agents-js/pull/1250
- feat: add function tool concurrency config by @seratch in https://github.com/openai/openai-agents-js/pull/1254
- feat: align local MCP config with the Python SDK by @seratch in https://github.com/openai/openai-agents-js/pull/1255
- fix: reject external symlink targets during Cloudflare workspace hydrate by @seratch in https://github.com/openai/openai-agents-js/pull/1258
Documentation & Other Changes
- docs: update translated document pages by @github-actions[bot] in https://github.com/openai/openai-agents-js/pull/1253
- chore: upgrade pnpm to 10.33.4 by @seratch in https://github.com/openai/openai-agents-js/pull/1257
- chore: update versions by @github-actions[bot] in https://github.com/openai/openai-agents-js/pull/1252
Full Changelog: https://github.com/openai/openai-agents-js/compare/v0.9.1...v0.10.0
Breaking Changes
- Default model changed from `gpt-4.1` to `gpt-5.4-mini`, altering implicit settings such as `reasoning.effort="none"` and `verbosity="low"` when a model is not explicitly set.
Weekly OSS security release digest.
The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.
No spam, unsubscribe anytime.
Share this release
About openai-agents-js
A lightweight, powerful framework for multi-agent workflows and voice agents
Related context
Related tools
Beta — feedback welcome: [email protected]