Skip to content

openai-agents-js

AI Agents & Assistants

A lightweight JavaScript/TypeScript framework for building and orchestrating multi‑agent workflows with configurable tools, guardrails, and tracing.

TypeScript Latest v0.11.6 · 5d ago Security brief →

Features

  • Provider‑agnostic agent orchestration (OpenAI APIs + more)
  • Sandbox agents with filesystem workspace and command execution
  • Configurable tools, handoffs, and human‑in‑the‑loop mechanisms
  • Built‑in session history management and tracing for debugging

Recent releases

View all 56 releases →
No immediate action
v0.11.6 Mixed

Tracing helpers + metadata fix + docs

No immediate action
v0.11.5 Mixed

Recovery, tracing ID, RunState clearing

No immediate action
v0.11.4 Bug fix

Preserve rejection reasons

v0.11.3 Bug fix

Tracing shutdown now operates as a best‑effort cleanup on process exit.

Full changelog

What's Changed

  • fix: make tracing shutdown best-effort on process exit by @seratch in https://github.com/openai/openai-agents-js/pull/1306

Documentation & Other Changes

  • docs: update MCP examples by @seratch in https://github.com/openai/openai-agents-js/pull/1305
  • chore: update versions by @github-actions[bot] in https://github.com/openai/openai-agents-js/pull/1307

Full Changelog: https://github.com/openai/openai-agents-js/compare/v0.11.2...v0.11.3

v0.11.2 Bug fix

Fixed preserving the latest response ID on resume.

Full changelog

What's Changed

  • fix: add configurable sandbox archive extraction limits by @seratch in https://github.com/openai/openai-agents-js/pull/1299
  • fix: include structured sandbox provider error details by @seratch in https://github.com/openai/openai-agents-js/pull/1301
  • fix: include Cloudflare sandbox exec and cleanup error details by @seratch in https://github.com/openai/openai-agents-js/pull/1300
  • fix: preserve GitRepo root subpath aliases by @seratch in https://github.com/openai/openai-agents-js/pull/1294
  • fix: validate sandbox GitRepo subpaths by @seratch in https://github.com/openai/openai-agents-js/pull/1290
  • fix: guard no-op tracing span IDs by @seratch in https://github.com/openai/openai-agents-js/pull/1292
  • fix: add strict feature validation for chat completions by @seratch in https://github.com/openai/openai-agents-js/pull/1279
  • fix: keep trace batch processing alive after exporter errors by @seratch in https://github.com/openai/openai-agents-js/pull/1291
  • fix: drop reasoning items orphaned by dropped tool calls by @seratch in https://github.com/openai/openai-agents-js/pull/1280
  • fix: preserve latest response id on resume by @seratch in https://github.com/openai/openai-agents-js/pull/1281
  • fix: allow callback-only handoff hooks by @seratch in https://github.com/openai/openai-agents-js/pull/1283
  • fix: exclude computer instances from provider detection by @seratch in https://github.com/openai/openai-agents-js/pull/1284
  • fix: preserve output audio content from output item events (realtime) by @seratch in https://github.com/openai/openai-agents-js/pull/1287
  • fix: treat null audio channels as unset (realtime) by @seratch in https://github.com/openai/openai-agents-js/pull/1289
  • fix: align Chat Completions strict validation by @seratch in https://github.com/openai/openai-agents-js/pull/1303
  • fix avoid duplicating reasoning across parallel tool calls in ai-sdk by @seratch in https://github.com/openai/openai-agents-js/pull/1285

Documentation & Other Changes

  • docs: skip corrupt Prisma session records by @seratch in https://github.com/openai/openai-agents-js/pull/1288
  • docs: skip corrupt FileSession items during pop by @seratch in https://github.com/openai/openai-agents-js/pull/1298
  • docs: fix md formatting for Python version note by @YazdanRa in https://github.com/openai/openai-agents-js/pull/1297
  • docs: refine examples auto-run defaults by @seratch in https://github.com/openai/openai-agents-js/pull/1302
  • test: isolate and speed up slow sandbox tests by @seratch in https://github.com/openai/openai-agents-js/pull/1304
  • test: keep output guardrail tripwires behind sibling completion by @seratch in https://github.com/openai/openai-agents-js/pull/1286
  • chore: stabilize examples auto-run for local MCP and sandbox runs by @seratch in https://github.com/openai/openai-agents-js/pull/1295
  • chore: upgrade pnpm toolchain to 11.0.9 by @seratch in https://github.com/openai/openai-agents-js/pull/1293
  • chore: update versions by @github-actions[bot] in https://github.com/openai/openai-agents-js/pull/1282

New Contributors

  • @YazdanRa made their first contribution in https://github.com/openai/openai-agents-js/pull/1297

Full Changelog: https://github.com/openai/openai-agents-js/compare/v0.11.1...v0.11.2

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.

About

Stars
3,157
Forks
796
Languages
TypeScript JavaScript Shell
Downloads/week
931,490 ↑32%
NPM Maintainers
13
Contributors
91
TypeScript
Types included ✓

Install & Platforms

Install via
npm

Beta — feedback welcome: [email protected]