openai-responses

SKILL.md

Stateful agentic conversations with preserved reasoning, server-side tools, and automatic state management.

Preserves model reasoning across turns (+5% performance on TAUBench), eliminating manual history tracking and improving multi-turn interactions

Built-in server-side tools: Code Interpreter, File Search, Web Search, DALL-E, and MCP integration without backend round trips

Automatic conversation state management with 90-day expiration; 40-80% better cache utilization than Chat Completions

Polymorphic output with 8 item types (message, reasoning, code execution, tool calls, web search results); background mode supports up to 10-minute timeouts

Prevents 11 documented errors including Zod v4 incompatibility, MCP connection failures, and streaming mode limitations; Assistants API sunset August 26, 2026

OpenAI Responses API

Status: Production Ready
Last Updated: 2026-01-21
API Launch: March 2025
Dependencies: openai@6.16.0 (Node.js) or fetch API (Cloudflare Workers)

What Is the Responses API?

OpenAI's unified interface for agentic applications, launched March 2025. Provides stateful conversations with preserved reasoning state across turns.

Key Innovation: Unlike Chat Completions (reasoning discarded between turns), Responses preserves the model's reasoning notebook, improving performance by 5% on TAUBench and enabling better multi-turn interactions.

vs Chat Completions: