Skip to content

openai-agents-js

v0.10.0 Breaking

This release includes 1 breaking change for platform teams planning a safe upgrade.

✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

agents openai openai-api realtime-api typescript

Summary

AI summary

Default 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

Track openai-agents-js

Get notified when new releases ship.

Sign up free

About openai-agents-js

A lightweight, powerful framework for multi-agent workflows and voice agents

All releases →

Beta — feedback welcome: [email protected]