@openai/agents

OpenAI Agents SDK (JS/TS) by OpenAI

The OpenAI Agents SDK is a lightweight yet powerful framework for building multi-agent workflows.

Live Registry Versionv0.21.0Previous: v0.20.0Published 2026-10-20

Stability Grade

C+ (69/100)

90-Day Velocity

14 releases

Moderate cadence

Dependencies

4 direct

NPM manifest

License

MIT

Verified on NPM

Recommended Exact Pin: npm install @openai/agents@0.21.0

NPM Registry ->GitHub Repo ->

TL;DR Verdict & Quick Citation Summary (2026-10-24)Source: AgentBreakWatch Live NPM Index

OpenAI Agents SDK (JS/TS) (@openai/agents) is currently at v0.21.0 on NPM (published 2026-10-20), with a 90-day stability score of 69/100 (C+) and HIGH schema drift risk across 14 releases in the past 90 days. 0.x minor releases regularly refine handoff filter signatures, hosted MCP tool definitions, and RealtimeAgent voice session events. Production teams should pin npm install @openai/agents@0.21.0 rather than using unpinned @latest tags.

Breaking Changes & Tool Schema Drift Analysis

0.x minor releases regularly refine handoff filter signatures, hosted MCP tool definitions, and RealtimeAgent voice session events.

Watched Exports / MCP Tool Signatures:

AgentruntoolhandoffhostedMcpTool

Before (Deprecated / Unpinned Pattern)

const myTool = tool({ name: "search", parameters: z.object({ q: z.string() }), execute: async ({ q }) => q });

After (Verified v0.21.0 Pattern)

const myTool = tool({
  name: "search",
  description: "Search docs",
  parameters: z.object({ q: z.string() }),
  strict: true,
  execute: async ({ q }) => q
});

Frequently Asked Questions: @openai/agents

What is the latest version of @openai/agents on NPM?

As of 2026-10-24, the latest stable version of @openai/agents (OpenAI Agents SDK (JS/TS) by OpenAI) on NPM is v0.21.0, published on 2026-10-20. It has shipped 14 releases in the last 90 days.

Does @openai/agents v0.21.0 have breaking changes or MCP schema drift risk?

@openai/agents currently carries a HIGH schema drift risk rating with a Stability Score of 69/100 (Grade C+). 0.x minor releases regularly refine handoff filter signatures, hosted MCP tool definitions, and RealtimeAgent voice session events.

How do I safely pin @openai/agents in production?

Avoid unpinned @latest tags in production agent configs. Pin the exact verified version using `npm install @openai/agents@0.21.0` and monitor Agent, run, tool, handoff, hostedMcpTool for parameter or schema changes.

30-Min Registry & Schema Poller

Get Instant Breaking-Change Alerts for @openai/agents

We poll NPM and openai/openai-agents-js every 30 minutes. Get an email with the exact diff when @openai/agents ships a breaking release beyond v0.21.0.