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.8.5 · April 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.8.5 (April 2026)

HITL approval flows for tool calls in browser clients.
Browser support improvements with tree-shaken bundles.
Zod v4 support across all structured-output helpers.

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
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).