OpenAI Agents SDK (TypeScript)

Production-ready TypeScript SDK with the same minimal primitives as the Python version, plus first-class browser support, HITL approval flows, and Express streaming.

Install

npm install @openai/agents

Version

v0.11.6 · May 2026 · Node 18+

Best for

Full-stack agents, HITL-approved workflows, browser-side tools.

Zero → Hero

1 · Core fundamentals Install, first agent, Runner · 15 min

2 · Your first agent Linear chat, context, async · 20 min

3 · Multi-agent systems Handoffs, specialist routing · 25 min

4 · Tools integration Function tools, MCP, built-ins · 25 min

5 · Structured output Zod schemas, typed responses · 15 min

6 · Middleware Lifecycle hooks, interceptors · 20 min

7 · Streaming (Express) SSE streaming server · 20 min

8 · Production Deployment, scaling, resilience · 30 min

Jump to a topic

Agent primitive

Handoffs

Function tools

Structured output (Zod)

Middleware

2025 features

Streaming server (Express)

Swarm migration

Reference

Comprehensive guide Full technical reference.

2025 features

Swarm migration guide

Middleware

Recipes

Diagrams

Production guide

Streaming server (Express)

What’s new in v0.11.6 (May 2026)

v0.11.6 (May 2026) — Patch; stability and dependency updates. 163 exports confirmed (@openai/agents@0.11.6, /tmp/npm-check-0529); all key symbols (Agent, Runner, run, handoff, tool, shellTool, toolSearchTool, applyPatchTool, applyDiff, retryPolicies, MemorySession, OpenAIConversationsSession, OpenAIResponsesCompactionSession) confirmed present.
v0.11.5 (May 2026) — Patch; stability and dependency updates. 161 exports confirmed; all key symbols (Agent, Runner, run, handoff, tool, shellTool, toolSearchTool, applyPatchTool, applyDiff, retryPolicies, MemorySession, OpenAIConversationsSession, OpenAIResponsesCompactionSession, MCPServerStreamableHttp, RuntimeEventEmitter, applySessionHistoryMutations) confirmed present in @openai/agents@0.11.5 (.routine-envs/check-0523-node).
v0.11.4 (May 12) — Patch; stability improvements. All key symbols (Agent, Runner, run, handoff, tool, shellTool, toolSearchTool, applyPatchTool, applyDiff, retryPolicies, MemorySession, OpenAIConversationsSession, OpenAIResponsesCompactionSession, MCPServerStreamableHttp, RuntimeEventEmitter, applySessionHistoryMutations) confirmed present in @openai/agents@0.11.4 (.routine-envs/check-0512-node).
v0.11.3 (May 11) — Patch; stability improvements.
v0.11.2 (May 10) — Patch; stability improvements.
v0.11.1 (May 9) — Patch; stability improvements.
v0.11.0 (May 7) — New helpers: shellTool (sandboxed shell command execution), toolSearchTool (dynamic tool discovery), applyPatchTool (code-patch application), applyDiff (diff application utility). retryPolicies collection for configurable retry strategies. MemorySession and OpenAIConversationsSession for structured session management. MCPServerStreamableHttp added to MCP server options. All confirmed in @openai/agents@0.11.1 (.routine-envs/check-0509-node).
v0.9.0–v0.10.5 (May 3–6) — Minor releases; OpenAIConversationsSession, OpenAIResponsesCompactionSession, RuntimeEventEmitter, applySessionHistoryMutations; performance improvements.
v0.8.5 (April 2026) — HITL approval flows; browser bundle improvements; Zod v4.

Install, minimal example

import { Agent, run } from '@openai/agents';

const agent = new Agent({
  name: 'Assistant',
  instructions: 'You are a helpful assistant.',
});

const result = await run(agent, 'What is 2 + 2?');
console.log(result.finalOutput);

Ready? Start Zero → Hero Step 1 →

Revision history

Date	Version	Changes	Reviewer
2026-05-29	0.11.6	Patch release bump 0.11.5 → 0.11.6; “What’s new” heading updated to v0.11.6; v0.11.6 bullet added; comprehensive guide header updated; revision history entry added. Key symbols (`Agent`, `Runner`, `run`, `handoff`, `tool`) confirmed in `@openai/agents@0.11.6` (`/tmp/npm-check-0529`); 163 total exports confirmed.	Claude routine
2026-05-23	0.11.5	Patch release bump 0.11.4 → 0.11.5; “What’s new” heading updated to v0.11.5; v0.11.5 bullet added; comprehensive guide header updated; revision history entry added. Key symbols (`Agent`, `Runner`, `run`, `handoff`, `tool`) confirmed in installed `@openai/agents@0.11.5` (`.routine-envs/check-0523-node`); 161 total exports confirmed.	Claude routine
2026-05-12	0.11.4	Version bumped 0.11.3 → 0.11.4; “What’s new” section updated; comprehensive guide header updated; revision history entry added. All key symbols (`Agent`, `Runner`, `run`, `handoff`, `tool`, `shellTool`, `toolSearchTool`, `applyPatchTool`, `applyDiff`, `retryPolicies`, `MemorySession`, `OpenAIConversationsSession`, `OpenAIResponsesCompactionSession`, `MCPServerStreamableHttp`, `RuntimeEventEmitter`, `applySessionHistoryMutations`) confirmed in installed `@openai/agents@0.11.4` (`.routine-envs/check-0512-node`).	Claude routine
2026-05-11	0.11.3	Version bumped 0.11.1 → 0.11.3 (two patch releases: 0.11.2, 0.11.3); “What’s new” section updated; comprehensive guide header updated; revision history entry added. All key symbols confirmed in installed `@openai/agents@0.11.3` (`.routine-envs/check-0511-node`).	Claude routine
2026-05-09	0.11.1	Version bumped 0.8.5 → 0.11.1 (multiple minor and patch releases); “What’s new” updated; comprehensive guide header updated. New symbols confirmed in installed `@openai/agents@0.11.1` (`.routine-envs/check-0509-node`): `shellTool`, `toolSearchTool`, `applyPatchTool`, `applyDiff`, `retryPolicies`, `MemorySession`, `OpenAIConversationsSession`, `OpenAIResponsesCompactionSession`, `RuntimeEventEmitter`, `applySessionHistoryMutations`, `MCPServerStreamableHttp`. Revision history entry added.	Claude routine
2026-04-21	0.8.5	Banner bumped to installed version 0.8.5.	—
April 9, 2026	0.8.3	HITL approval flows; browser bundle improvements; Zod v4.	—
November 2025	0.3.2	Initial TypeScript guide; Swarm migration; MCP.	—

Note: Python implementation lives at OpenAI Agents SDK (Python).