OpenAI Agents SDK — The AI Toolchain

OpenAI Agents SDK v0.21.1

Sun, 16 Aug 2026 22:28:55 GMT

OpenAI Agents SDK v0.21.1 adds model call timeouts, run-scoped sandbox working directories, Docker networking controls, and Modal resource options. • Adds model call timeouts to the core runner, letting callers bound how long a single model invocation can block. • Adds run-scoped sandbox working directories so each run gets an isolated filesystem context inside the sandbox. • Allows Docker sandboxes to disable networking, enabling air-gapped sandbox execution for sensitive workloads. • Adds Modal sandbox resource options, exposing resource configuration (CPU, memory, GPU, etc.) for Modal-backed sandboxes.

OpenAI Agents SDK v0.21.1

Sun, 16 Aug 2026 22:28:55 GMT

v0.21.1 adds model call timeouts, run-scoped sandbox working directories, Docker network isolation, and Modal resource options. • Adds run-scoped sandbox working directories so each agent run gets an isolated filesystem workspace inside a sandbox. • Allows Docker sandboxes to disable networking, enabling air-gapped container execution for sensitive workloads. • Adds Modal sandbox resource options, giving practitioners control over compute resources allocated to Modal-backed sandboxes. • Adds model call timeouts to cap how long a single LLM call can block an agent run.

OpenAI Agents SDK v0.21.0

Sat, 15 Aug 2026 02:49:37 GMT

Adds provider-neutral testing utilities across `agents.testing`, `agents.realtime.testing`, and `agents.voice.testing`, plus OpenAI Python v3 compatibility. • Adds `agents.testing`, `agents.realtime.testing`, and `agents.voice.testing` modules with scripted/deterministic test utilities for Agent, Sandbox, Realtime, and Voice workflows — no live provider requests required. • Updates OpenAI provider compatibility to `openai>=3.0.0,<4`, including HTTPX2-aware request, response, transport, and exception handling. • Adds configurable retry backoff ceiling for MCP connections. • Adds `managed_secrets` support for referencing existing Runloop secrets in Sandbox sessions.

OpenAI Agents SDK v0.21.0

Sat, 15 Aug 2026 02:49:37 GMT

Adds provider-neutral testing modules for Agent, Realtime, and Voice workflows plus OpenAI Python v3 / HTTPX2 compatibility. • Adds `agents.testing`, `agents.realtime.testing`, and `agents.voice.testing` modules with scripted model utilities for deterministic Agent, Sandbox, Realtime, and Voice workflow tests without live provider requests. • Updates OpenAI provider compatibility to `openai>=3.0.0,<4`, adding HTTPX2-aware request, response, transport, and exception handling. • Adds configurable retry backoff ceiling for MCP connections. • Adds `managed_secrets` support for referencing existing Runloop secrets in Sandbox agents.

OpenAI Agents SDK v0.20.0

Tue, 11 Aug 2026 03:12:14 GMT

OpenAI Agents SDK v0.20.0 switches the default model to `gpt-5.6-luna`, adds RunState.add_input() for durable pending input, MCP SDK v2 support, and GA realtime transcription settings. • Adds RunState.add_input() to stage durable user input before a resumed model call, with guardrail, persistence, and serialization support. • Adds explicit mount credential-exposure acknowledgements to sandbox mount validation, with redacted error contracts that do not serialize credential authority. • Supports MCP Python SDK v2 alongside v1 across `stdio`, `SSE`, and `Streamable HTTP` transports for local MCP connections. • Supports GA transcription settings for `gpt-live-transcribe`, `gpt-transcribe`, and `gpt-realtime-whisper` in realtime input transcription. • Passes run context to custom session implementations. • Preserves raw usage payloads from provider responses. • Allows applications to approve unsafe replays explicitly. • Changes the implicit default model to `gpt-5.6-luna`; explicit models, run-level overrides, and the `OPENAI_DEFAULT_MODEL` environment variable continue to take precedence. Breaking changes: • The implicit default model is now `gpt-5.6-luna` instead of the previous default; applications that relied on the old implicit default will use a different model on upgrade. • Applications using custom MCP HTTP authentication or client factories must use the HTTP types owned by the installed MCP major version (v1 or v2), or pin `mcp<2`, due to the MCP SDK v2 dependency migration.

OpenAI Agents SDK v0.20.0

Tue, 11 Aug 2026 03:12:14 GMT

OpenAI Agents SDK v0.20.0 switches the default model to gpt-5.6-luna, adds RunState.add_input(), MCP SDK v2 support, and GA realtime transcription settings. • Adds RunState.add_input() to stage durable user input before a resumed model call, with guardrail, persistence, and serialization support. • Supports MCP Python SDK v2 alongside v1 across `stdio`, `SSE`, and `Streamable HTTP` transports for local MCP connections. • Adds explicit credential-exposure acknowledgements for sandbox mount configurations. • Realtime input transcription now supports GA transcription settings for `gpt-live-transcribe`, `gpt-transcribe`, and `gpt-realtime-whisper`. • Passes run context to custom session implementations. • Preserves raw usage payloads from provider responses. • Allows applications to approve unsafe replays explicitly. Breaking changes: • The implicit default model is now `gpt-5.6-luna` (previously a different model); workloads that relied on the old default will use the new model on upgrade. Explicit model settings, run-level overrides, and `OPENAI_DEFAULT_MODEL` continue to take precedence. • Applications using custom MCP HTTP authentication or client factories must use the HTTP types owned by the installed MCP major version, or pin `mcp<2`.

OpenAI Agents SDK v0.19.2

Sat, 01 Aug 2026 01:08:37 GMT

OpenAI Agents SDK v0.19.2 exposes original callables through wrapped functions for easier introspection. • Exposes the original callable via a `wrapped` attribute on wrapped functions, enabling runtime introspection of the underlying function.

OpenAI Agents SDK v0.19.2

Sat, 01 Aug 2026 01:08:37 GMT

Exposes original callable through wrapped functions, enabling introspection of tool wrappers in the OpenAI Agents SDK. • Exposes the original callable via a `wrapped` attribute on wrapped functions, allowing introspection of the underlying tool implementation at runtime.

OpenAI Agents SDK v0.19.1

Wed, 29 Jul 2026 07:44:24 GMT

OpenAI Agents SDK v0.19.1 adds native host path support in sandbox path grants. • Adds support for native host paths in sandbox path grants, enabling direct host filesystem access without path translation.

OpenAI Agents SDK v0.19.1

Wed, 29 Jul 2026 07:44:24 GMT

OpenAI Agents SDK v0.19.1 adds native host path support in sandbox path grants. • Supports native host paths in sandbox path grants, allowing local filesystem directories to be granted directly to sandbox agents.

OpenAI Agents SDK v0.19.0

Mon, 27 Jul 2026 04:10:05 GMT

OpenAI Agents SDK v0.19.0 adds Programmatic Tool Calling, a `@tool` decorator alias, and a Vercel cloud bucket mount strategy. • Adds `agents.tool.ProgrammaticToolCallingTool` class, enabling supported OpenAI Responses models to generate JavaScript to coordinate eligible tools, with per-tool `allowed_callers`, structured function-tool outputs, and integration with Runner streaming, guardrails, approvals, sessions, and `RunState`. • Adds the public `agents.decorators` module and a shorter `@tool` alias alongside existing function and guardrail decorators. • Extends function tools to support async callable objects in addition to plain async functions. • Adds `VercelCloudBucketMountStrategy` for sandbox sessions, excluding bucket contents from workspace persistence. • SDK configuration now consistently accepts either typed settings objects or plain dictionaries across agents, runs, models, sessions, sandboxes, and voice pipelines, with validation for unknown settings.

OpenAI Agents SDK v0.19.0

Mon, 27 Jul 2026 04:10:05 GMT

OpenAI Agents SDK v0.19.0 adds Programmatic Tool Calling, a `@tool` decorator alias, and a `VercelCloudBucketMountStrategy`. • Adds `agents.tool.ProgrammaticToolCallingTool`, enabling supported OpenAI Responses models to generate JavaScript to coordinate eligible tools, with support for per-tool `allowed_callers`, structured function-tool outputs, and integration with Runner streaming, guardrails, approvals, sessions, and `RunState`. • Adds the public `agents.decorators` module and a shorter `@tool` alias alongside existing function and guardrail decorators. • Supports async callable objects as function tools. • Adds `VercelCloudBucketMountStrategy` for sandbox session mounting; mounted sessions exclude bucket contents from workspace persistence and do not support dynamic mount changes or session resume. • SDK configuration now consistently accepts either typed settings objects or plain dictionaries across agents, runs, models, sessions, sandboxes, and voice pipelines, with validation for unknown settings.

OpenAI Agents SDK v0.18.3

Fri, 17 Jul 2026 03:39:51 GMT

OpenAI Agents SDK v0.18.3 adds configurable tracing spans and realtime response usage tracking in session context. • Enables configuration of task and turn tracing spans, giving developers control over how agent execution is traced. • Tracks response usage in realtime session context, making token and resource consumption visible within a session.

OpenAI Agents SDK v0.18.2

Sat, 11 Jul 2026 01:07:46 GMT

OpenAI Agents SDK v0.18.2 adds GPT-5.6 request controls and hosted multi-agent beta support. • Adds GPT-5.6 request controls support to the SDK. • Adds hosted multi-agent beta support.

OpenAI Agents SDK v0.18.1

Thu, 09 Jul 2026 23:38:36 GMT

OpenAI Agents SDK v0.18.1 adds GPT-4.1 model defaults and migrates examples to the new defaults. • Adds GPT-5.6 model defaults and migrates bundled examples to use them.

OpenAI Agents SDK v0.18.0

Tue, 07 Jul 2026 06:01:55 GMT

RealtimeAgent defaults to gpt-realtime-2.1 and SQLAlchemySession gains a Unicode storage option. • Adds Unicode storage option to `SQLAlchemySession` for broader character-set support in session persistence. • Changes the default model for `RealtimeAgent` to `gpt-realtime-2.1`. Breaking changes: • The default model for `RealtimeAgent` is now `gpt-realtime-2.1`; any existing code that relied on the previous default model will silently switch behaviour on upgrade.

OpenAI Agents SDK v0.17.8

Mon, 06 Jul 2026 23:36:38 GMT

OpenAI Agents SDK v0.17.8 adds an invalid final output recovery handler for more resilient agent runs. • Adds an invalid final output recovery handler, letting agents recover gracefully when a run produces a final output that fails validation.

OpenAI Agents SDK v0.17.7

Wed, 24 Jun 2026 05:15:03 GMT

v0.17.7 adds configurable WebSocket max_size and buffered Chat Completions tool-call streaming. • Exposes a configurable `max_size` limit for WebSocket connections, allowing callers to raise or lower the message-size cap. • Adds buffered Chat Completions tool-call streaming, delivering complete tool-call payloads as a single event rather than fragmenting them across stream chunks.

OpenAI Agents SDK v0.17.6

Fri, 19 Jun 2026 06:03:31 GMT

OpenAI Agents SDK v0.17.6 adds pre-approval tool input guardrails and SDK-only custom data for tool outputs. • Adds pre-approval tool input guardrails, enabling validation or interception of tool inputs before a tool call is executed. • Adds SDK-only custom data for tool outputs, allowing developers to attach arbitrary metadata to tool results without affecting the JSON-compatible contract sent to the model.

OpenAI Agents SDK v0.17.4

Tue, 26 May 2026 08:54:24 GMT

OpenAI Agents SDK v0.17.4 adds support for Realtime custom voice objects. • Supports custom voice objects in the Realtime API integration.

OpenAI Agents SDK v0.17.0

Fri, 08 May 2026 08:09:48 GMT

OpenAI Agents SDK v0.17.0 defaults RealtimeAgent to gpt-realtime-2 and tightens sandbox path controls via SandboxPathGrant • Adds `SandboxPathGrant` to `Manifest.extra_path_grants` so trusted host paths outside the SDK process `base_dir` can be explicitly granted (optionally `read_only=True`) for sandbox source materialization. • Changes the default model for `RealtimeAgent` sessions to `gpt-realtime-2`. Breaking changes: • Sandbox local source materialization now constrains `LocalFile.src` and `LocalDir.src` to the SDK process current working directory (`base_dir`) unless the path is covered by `Manifest.extra_path_grants`. Applications that copy host files or directories from outside `base_dir` into a sandbox workspace must add a `SandboxPathGrant` for each trusted host root.

OpenAI Agents SDK v0.16.0

Thu, 07 May 2026 00:27:54 GMT

OpenAI Agents SDK v0.16.0 adds MCP server-prefixed tool names, per-run tool concurrency config, and an unlimited-turns mode. • Adds `include_server_in_tool_names` to `MCPConfig` (set `True`) to prefix each MCP tool name with its server name, preventing collisions when multiple MCP servers expose identically named tools. • Adds ToolExecutionConfig(max_function_tool_concurrency=...) on `RunConfig` to cap SDK-side local function tool execution concurrency independently of the provider-side `ModelSettings.parallel_tool_calls` setting. • Adds `max_turns=None` to the run API to disable the turn limit entirely, while preserving the existing default of `DEFAULT_MAX_TURNS` (`10`) when `max_turns` is omitted. • Adds `OPENAI_DEFAULT_MODEL` environment variable as a global override for the SDK default model, allowing the previous `gpt-4.1` behavior to be restored without per-agent code changes. Breaking changes: • The SDK default model is changed from `gpt-4.1` to `gpt-5.4-mini`; agents and runs that do not explicitly set a model will now use `gpt-5.4-mini`, which implicitly applies GPT-5 defaults including `reasoning.effort="none"` and `verbosity="low"`.

OpenAI Agents SDK v0.15.2

Wed, 06 May 2026 00:36:36 GMT

OpenAI Agents SDK v0.15.2 adds a context management model setting for finer control over conversation context. • Adds a context management model setting to control how conversation context is managed within a session.

OpenAI Agents SDK v0.15.1

Sat, 02 May 2026 02:20:18 GMT

OpenAI Agents SDK v0.15.1 exposes WebSocket keepalive options for the Responses API connection. • Exposes WebSocket keepalive options for the Responses API, giving callers control over connection liveness behavior.

OpenAI Agents SDK v0.15.0

Fri, 01 May 2026 06:44:23 GMT

OpenAI Agents SDK v0.15.0 surfaces model refusals as `ModelRefusalError` with a new `model_refusal` error handler. • Adds `ModelRefusalError` exception type so model refusals are raised explicitly instead of producing an empty `final_output` or looping until `MaxTurnsExceeded`. • Adds `model_refusal` key to the `error_handlers` dict in `Runner.run_sync` / `Runner.run` to intercept refusals and return a custom value — including a value matching the agent's output schema for structured-output agents. Breaking changes: • Code that expected a refusal-only model response to complete with `final_output == ""` will now receive a `ModelRefusalError` instead; a `model_refusal` run error handler must be provided to suppress the exception.

OpenAI Agents SDK v0.14.7

Tue, 28 Apr 2026 06:46:57 GMT

Adds `tool_name` and `call_id` convenience properties to tool items in the OpenAI Agents SDK. • Adds `tool_name` and `call_id` convenience properties to tool items, making it easier to inspect tool call context without manual attribute lookup.

OpenAI Agents SDK v0.14.5

Thu, 23 Apr 2026 02:20:27 GMT

OpenAI Agents SDK v0.14.5 adds an idle timeout option for Modal sandbox environments. • Adds an idle timeout option for Modal sandbox code execution environments, allowing control over how long a sandbox remains active without activity.

OpenAI Agents SDK v0.14.4

Tue, 21 Apr 2026 19:28:06 GMT

OpenAI Agents SDK v0.14.4 adds BoxMount support for sandbox environments. • Adds `BoxMount` support for mounting box-based storage into sandbox environments.

OpenAI Agents SDK v0.14.2

Sat, 18 Apr 2026 00:17:07 GMT

OpenAI Agents SDK v0.14.2 adds MongoDB session backend, sandbox extra path grants, and tool origin metadata on run items. • Adds MongoDB session backend via the extensions module, giving agents a persistent conversation store backed by MongoDB. • Supports sandbox extra path grants, allowing additional filesystem paths to be granted to the code-execution sandbox. • Persists tool origin metadata in run items, so downstream code can inspect which tool produced each item in a run.

OpenAI Agents SDK v0.14.0

Wed, 15 Apr 2026 17:11:33 GMT

OpenAI Agents SDK v0.14.0 ships Sandbox Agents — persistent isolated workspaces with shell, filesystem, memory, snapshots, and hosted-provider backends. • Adds `SandboxAgent` class (extends `Agent`) with `default_manifest`, sandbox instructions, capabilities, and `run_as` for running agents inside persistent, isolated workspaces. • Adds `SandboxRunConfig` for per-run sandbox wiring: client creation, live session injection, serialized session resume via `SandboxSessionState`, manifest overrides, snapshots, and `materialization_concurrency` limits. • Adds `Manifest` — a workspace-bootstrap contract covering files, directories, local files, local directories, Git repos, environment variables, users, groups, and mounts. • Adds built-in sandbox capabilities for shell access, filesystem editing and image inspection, skills, memory, and compaction. • Adds `UnixLocalSandboxClient` for fast local development and `DockerSandboxClient` for container-isolated runs with image parity. • Adds hosted sandbox provider clients for Blaxel, Cloudflare, Daytona, E2B, Modal, Runloop, and Vercel, installable as optional extras. • Adds remote storage mount support for S3, Cloudflare R2, Google Cloud Storage, Azure Blob Storage, and S3 Files across Docker, Modal, Cloudflare, Blaxel, Daytona, E2B, and Runloop backends. • Adds sandbox memory capability: stores extracted lessons in the workspace, injects summaries into later runs, and supports read-only or generate-only modes, live stale-memory updates, and S3-backed persistence. • Adds multi-turn memory grouping via `conversation_id`, SDK `Session`, `RunConfig.group_id`, or auto-generated run IDs, with separate memory layouts for per-agent or per-workflow isolation. • Adds portable workspace snapshots with path normalization, symlink preservation, mount-safe snapshotting, and remote snapshot support. • Adds resume paths through runner-managed `RunState`, explicit `SandboxSessionState`, or saved snapshots so agents can continue work across runs. • Adds sandbox-aware `RunState` serialization and unified sandbox tracing integrated with existing SDK spans. • Adds token usage reporting on tracing spans. • Adds safer redaction of sensitive MCP tool outputs when sensitive tracing is disabled. • Adds a large `examples/sandbox/` suite covering local/Docker runners, hosted providers, memory patterns, mount smoke tests, coding tasks, handoff patterns, and domain-specific tutorials (tax-prep, healthcare, dataroom QA, code review, vision website clone).

OpenAI Agents SDK v0.13.5

Mon, 06 Apr 2026 04:11:19 GMT

OpenAI Agents SDK v0.13.5 adds callable approval policies for local MCP servers and a public flush_traces API. • Adds `flush_traces` as a public API to programmatically flush buffered trace data on demand. • Supports callable approval policies for local MCP servers, enabling dynamic, code-driven control over tool-call approvals.

OpenAI Agents SDK v0.13.2

Thu, 26 Mar 2026 23:56:53 GMT

OpenAI Agents SDK v0.13.2 adds `external_web_access` parameter to `WebSearchTool`. • Adds `external_web_access` parameter to `WebSearchTool` to control whether the tool can access external web sources.

OpenAI Agents SDK v0.13.1

Wed, 25 Mar 2026 07:44:57 GMT

OpenAI Agents SDK v0.13.1 adds an any-llm adapter to the extension module for responses-compatible multi-LLM routing. • Adds an `any-llm` adapter to the extension module, enabling responses-compatible routing to any LLM supported by the [any-llm](https://github.com/mozilla-ai/any-llm) library.

OpenAI Agents SDK v0.13.0

Mon, 23 Mar 2026 06:19:55 GMT

OpenAI Agents SDK v0.13.0 adds MCP resource methods, streamable HTTP session resumption, and opt-in reasoning-content replay for Chat Completions. • Adds list_resources(), list_resource_templates(), and read_resource() methods to `MCPServer`, exposing MCP resource access directly from the SDK. • Adds `session_id` property to `MCPServerStreamableHttp`, enabling streamable HTTP sessions to be resumed across reconnects or stateless workers. • Adds `should_replay_reasoning_content` opt-in flag to Chat Completions integrations, improving reasoning/tool-call continuity for adapters such as LiteLLM and DeepSeek. • Changes the default Realtime WebSocket model to `gpt-realtime-1.5`, so new Realtime agent setups use the newer model without extra configuration.

OpenAI Agents SDK v0.12.5

Thu, 19 Mar 2026 07:18:48 GMT

OpenAI Agents SDK v0.12.5 exposes `auth` and `httpx_client_factory` in MCP SSE/StreamableHttp transport params. • Adds `auth` and `httpx_client_factory` parameters to MCP `SSE` and `StreamableHttp` transport configuration, enabling custom authentication and HTTP client injection for MCP server connections.

OpenAI Agents SDK v0.12.1

Fri, 13 Mar 2026 06:45:49 GMT

OpenAI Agents SDK v0.12.1 preserves explicit approval rejection messages across resume flows. • Preserves explicit approval rejection messages across resume flows, so rejection context is no longer lost when an interrupted run is resumed.

OpenAI Agents SDK v0.12.0

Thu, 12 Mar 2026 08:52:13 GMT

OpenAI Agents SDK v0.12.0 adds opt-in retry policies for model API calls via `ModelSettings`. • Adds opt-in retry policy configuration to `ModelSettings`, passable as run config or per-agent model settings to automatically retry failed model API calls.

OpenAI Agents SDK v0.11.0

Mon, 09 Mar 2026 04:10:12 GMT

OpenAI Agents SDK v0.11.0 adds tool search support with namespaces and extends computer use to the GA gpt-5.4 model. • Adds tool search tool support via the Responses API, including namespace scoping — see the `tool_search.py` example for usage. • Extends `ComputerTool` to support the GA `gpt-5.4` model in addition to the existing `computer-use-preview` model.

OpenAI Agents SDK v0.10.5

Thu, 05 Mar 2026 20:43:30 GMT

OpenAI Agents SDK v0.10.5 adds explicit prefix mode control to MultiProvider. • Adds explicit prefix modes to `MultiProvider`, giving developers direct control over how model-name prefixes are applied when routing across multiple model providers.

OpenAI Agents SDK v0.10.3

Mon, 02 Mar 2026 05:13:46 GMT

OpenAI Agents SDK v0.10.3 exposes agent tool invocation metadata and a new tool_context accessor on RunResult. • Adds `tool_context` accessor on `RunResult` to retrieve agent tool invocation context during a run. • Exposes immutable agent tool invocation metadata on run results, making per-tool call details available after execution.

OpenAI Agents SDK v0.10.0

Mon, 23 Feb 2026 23:19:59 GMT

OpenAI Agents SDK v0.10.0 adds opt-in WebSocket mode for the Responses API with a reusable session helper. • Adds set_default_openai_responses_transport('websocket') to switch all Responses API calls to WebSocket mode globally. • Adds responses_websocket_session() async context manager for a reusable WebSocket connection across multiple streamed agent runs. • Adds `use_responses_websocket=True` parameter to `OpenAIProvider` to enable WebSocket mode per-provider.

OpenAI Agents SDK v0.9.2

Thu, 19 Feb 2026 05:15:54 GMT

OpenAI Agents SDK v0.9.2 adds `reasoning_item_id_policy` to `RunConfig` to suppress 400 errors with reasoning models. • Adds `reasoning_item_id_policy='omit'` option to `RunConfig` to drop reasoning item IDs when using reasoning models, preventing 400 errors from inconsistent item sets; opt-in with default behavior unchanged. • Persists `reasoning_item_id_policy` across agent resumes and streamed follow-up turns.

OpenAI Agents SDK v0.9.0

Fri, 13 Feb 2026 22:11:25 GMT

OpenAI Agents SDK v0.9.0 adds configurable function-tool timeouts and a ToolOutputTrimmer for smart context management. • Adds `timeout_seconds`, `timeout_behavior`, and `timeout_error_function` parameters to function tools, letting you cap execution time and choose between `'error_as_result'` or `'raise_exception'` on timeout via `ToolTimeoutBehavior` and `ToolErrorFunction`. • Adds `ToolOutputTrimmer` for smart context management, enabling automatic trimming of tool output to fit within context limits. Breaking changes: • Python 3.9 is no longer supported; upgrade to Python 3.10 or newer. • Agent.as_tool() now returns `FunctionTool` instead of the broader `Tool` union type; code that depends on the `Tool` return type may require adjustment.

OpenAI Agents SDK v0.8.4

Wed, 11 Feb 2026 19:14:01 GMT

OpenAI Agents SDK v0.8.4 adds ShellTool with container runtime and native skills support. • Adds `ShellTool` with `environment` parameter supporting `type: container_auto`, `network_policy`, and `skills` (via `skill_reference` with `skill_id` and `version`) for hosted container shell runtime with native skills support.

OpenAI Agents SDK v0.8.3

Tue, 10 Feb 2026 00:10:17 GMT

Realtime agents SDK gains `model_version` param for turn detection control. • Adds `model_version` parameter to turn detection configuration in the realtime agents SDK, allowing selection of the turn-detection model version.

OpenAI Agents SDK v0.8.2

Mon, 09 Feb 2026 22:30:07 GMT

OpenAI Agents SDK v0.8.2 adds Annotated[T, Field(...)] support in function schemas and exposes the agent inside ToolContext tool calls. • Supports `Annotated[T, Field(...)]` syntax in function tool schemas, letting practitioners attach Pydantic field metadata (descriptions, constraints, aliases) directly to tool function parameters. • Includes the calling `agent` instance in `ToolContext` during tool calls, giving tool implementations access to the agent at runtime.

OpenAI Agents SDK v0.8.1

Fri, 06 Feb 2026 22:43:50 GMT

OpenAI Agents SDK v0.8.1 adds run-context thread reuse for codex_tool and a max-turns limit for the REPL. • Adds a max-turns limit to the REPL loop, preventing runaway multi-turn agent sessions. • Adds run-context thread reuse for `codex_tool`, allowing tool invocations within a run to share execution context across turns.

OpenAI Agents SDK v0.8.0

Thu, 05 Feb 2026 02:51:18 GMT

OpenAI Agents SDK v0.8.0 adds human-in-the-loop approval flows, structured tool input, configurable MCP failure handling, and max-turns error hooks. • Adds `needs_approval=True` parameter to `@function_tool` to declare that a tool call requires human approval before execution; pending approvals surface as `result.interruptions` on the run result. • Adds `RunState` class with state.approve(interruption) and state.reject(interruption) methods, and result.to_state() to serialize a paused run so it can be resumed via Runner.run(agent, state) after human decisions. • Adds `mcp_config={"failure_error_function": ...}` agent-level config key to control MCP tool failure handling; defaults now return model-visible error output instead of failing the whole run; set `failure_error_function=None` on individual MCP servers to restore fail-fast behavior. • Adds `tool_error_formatter` parameter for customizing the error output returned to the model when a tool call fails. • Adds `max_turns` run error handlers so callers can supply a callback when the agent hits its turn limit. • Adds session customization parameters to `Runner` for controlling session behavior. • Adds MCP tool meta resolver support, allowing dynamic resolution of MCP tool metadata. • Supports image responses from MCP servers, enabling MCP tools to return image content. • Adds CRLF line-ending support for `apply_diff`, broadening compatibility with Windows-style patch content. • Adds structured agent tool input support, enabling agents-as-tools to receive typed, structured input. Breaking changes: • Synchronous Python function tools now execute on worker threads via asyncio.to_thread(...) instead of the event loop thread; tools that depend on thread-local state or thread-affine resources must migrate to async implementations or make thread affinity explicit. • Local MCP tool failure handling default behavior changed: failures now return model-visible error output instead of failing the whole run; to restore fail-fast semantics, set `mcp_config={"failure_error_function": None}` at the agent level and `failure_error_function=None` on each local MCP server that has an explicit handler.

OpenAI Agents SDK v0.7.0

Fri, 23 Jan 2026 00:06:00 GMT

OpenAI Agents SDK v0.7.0 adds MCPServerManager for parallel MCP lifecycle management and makes nested handoffs opt-in. • Adds `MCPServerManager` class in `agents.mcp` to safely manage multiple MCP server instances (e.g., `MCPServerStreamableHttp`) with a `connect_in_parallel=True` option and an `active_servers` property for use with `Agent`. • Adds `nest_handoff_history` boolean field to `RunConfig` to opt in to nested handoff history (previously on by default since v0.6.0, now defaults to `False`). • Makes `session_input_callback` optional when using a sessions store; the default behavior is now to append new input to the session history automatically. • Sets the default `reasoning.effort` to `'none'` for gpt-5.1/5.2 models in the default model configuration. Breaking changes: • The `nest_handoff_history` behavior introduced in v0.6.0 is now disabled by default; set RunConfig(nest_handoff_history=True) to restore the previous behavior. • The default `reasoning.effort` for gpt-5.1/5.2 is changed from `'low'` to `'none'`; explicitly set `reasoning.effort='low'` in your agent's `model_settings` if you relied on the previous default.

OpenAI Agents SDK v0.6.9

Tue, 20 Jan 2026 01:56:29 GMT

OpenAI Agents SDK v0.6.9 adds input-based responses compaction with store-aware auto mode. • Adds input-based responses compaction with a store-aware auto mode, enabling smarter context management when responses are stored.

OpenAI Agents SDK v0.6.7

Fri, 16 Jan 2026 22:36:59 GMT

OpenAI Agents SDK v0.6.7 adds experimental Codex tool integration and enforces `max_output_length` on shell tool outputs. • Adds codex_tool() from `agents.extensions.experimental.codex` — an experimental tool that runs the Codex CLI as a subprocess, making all existing Codex configuration, skills, and capabilities available to agents without additional setup. • Enforces `max_output_length` for shell tool outputs, capping runaway output from subprocess-based tools.

OpenAI Agents SDK v0.6.6

Thu, 15 Jan 2026 05:38:03 GMT

OpenAI Agents SDK v0.6.6 adds auto-compaction for long conversations and an async SQLite session store. • Adds `responses.compact` setting to auto-compact long conversations, preventing context-window overflow in multi-turn agent runs. • Adds `AsyncSQLiteSession`, an `aiosqlite`-backed async session store for persisting conversation state without blocking the event loop.

OpenAI Agents SDK v0.6.5

Tue, 06 Jan 2026 15:32:20 GMT

v0.6.5 adds per-run tracing API keys, tool guardrails, AgentHookContext, and Gemini 3 Pro support • Adds per-run tracing API key support, allowing a different API key to be specified for tracing on individual runs rather than globally. • Adds `AgentHookContext` with a `turn_input` field for agent hooks, giving hook callbacks access to the current turn's input. • Adds tool guardrails as arguments to the `@function_tool` decorator, enabling inline guardrail configuration directly on tool definitions. • Adds realtime audio mapping support and SIP session payload handling for realtime agents. • Adds Gemini 3 Pro support with cross-model conversation compatibility. • Preserves non-text tool outputs in LiteLLM and chatcmpl converters, improving fidelity when routing through alternate model backends.

OpenAI Agents SDK v0.6.4

Fri, 19 Dec 2025 06:42:29 GMT

OpenAI Agents SDK v0.6.4 adds streaming and failure-handler control when agents are composed as tools. • Exposes `failure_error_function` parameter in Agent.as_tool() so callers can supply a custom error handler when an agent-as-tool run fails. • Adds `on_stream` callback to Agent.as_tool(), enabling streaming output from agents that are themselves used as tools inside a parent agent.

OpenAI Agents SDK v0.6.3

Thu, 11 Dec 2025 18:07:21 GMT

OpenAI Agents SDK v0.6.3 preserves logprobs from the chat completions API in ModelResponse. • Preserves `logprobs` data from the chat completions API in `ModelResponse`, making token-level probability information available to callers downstream.

OpenAI Agents SDK v0.6.0

Tue, 18 Nov 2025 19:06:26 GMT

OpenAI Agents SDK v0.6.0 adds parallel input guardrails, prompt cache retention, tool error logging, and a breaking handoff history change. • Adds `prompt_cache_retention` field to `ModelSettings` to control prompt cache retention behaviour. • Adds `run_in_parallel` parameter to input guardrails, allowing multiple guardrails to execute concurrently instead of sequentially. • Adds tool error logging so errors raised during tool execution are now captured in logs. • Handoff message history is now collapsed into a single message by default when handing off to a new agent (replaces the previous multi-message history pass-through). Breaking changes: • On agent handoff, message history is now collapsed into a single message by default ('Nest handoff history by default'). Agents that previously relied on the full expanded message history being passed to the receiving agent may behave differently; test before upgrading to v0.6.0 in production.

OpenAI Agents SDK v0.5.1

Thu, 13 Nov 2025 17:59:08 GMT

Adds `shell` and `apply_patch` built-in tools introduced with the GPT-5.1 launch. • Adds `shell` and `apply_patch` as new supported tools for use with GPT-5.1 models.

OpenAI Agents SDK v0.5.0

Wed, 05 Nov 2025 05:28:07 GMT

OpenAI Agents SDK v0.5.0 adds SIP protocol support for RealtimeRunner, per-request usage tracking, and Dapr session storage. • Adds SIP protocol connection support to `RealtimeRunner`, enabling realtime agents to handle SIP-based voice calls. • Adds a list of per-request usage data to the `Usage` object, giving finer-grained token consumption tracking across multi-step runs. • Adds Dapr as a session storage option for agent runs. • Adds Python 3.14 to the list of officially supported versions.

OpenAI Agents SDK v0.4.2

Fri, 24 Oct 2025 21:45:55 GMT

OpenAI Agents SDK v0.4.2 enables async tool calling in Realtime sessions and custom reasoning effort for LiteLLM providers. • Enables async tool calling in Realtime sessions, allowing asynchronous tools to be invoked during real-time agent interactions. • Supports passing custom reasoning effort when using LiteLLM providers.

OpenAI Agents SDK v0.4.0

Fri, 17 Oct 2025 23:21:47 GMT

OpenAI Agents SDK v0.4.0 adds image/file function outputs, graceful stream cancellation, MCP message handler config, and custom HTTP client factory. • Adds `httpx_client_factory` initialization option to `MCPServerStreamableHttp` for supplying a custom HTTPX client when connecting to MCP servers. • Exposes MCP message handler configuration, allowing callers to customize how MCP protocol messages are handled. • Supports image and file output types as return values from agent tool functions. • Adds a graceful cancel mode for streaming runs, enabling clean shutdown of in-progress streamed agent executions. Breaking changes: • openai package v1.x is no longer supported; the SDK now requires openai v2.x (migrated to v2.2.0).

OpenAI Agents SDK v0.3.3

Tue, 30 Sep 2025 23:19:53 GMT

OpenAI Agents SDK v0.3.3 adds AdvancedSQLiteSession with branching, Redis session support, and tool-level input/output guardrails. • Adds `AdvancedSQLiteSession` class with conversation branching and usage tracking for persistent local agent memory. • Adds Redis session support via a new Redis-backed session class for scalable, distributed agent memory across multiple instances. • Adds tool input and output guardrails, enabling validation and filtering at the individual tool call level.

OpenAI Agents SDK v0.3.2

Tue, 23 Sep 2025 20:36:51 GMT

OpenAI Agents SDK v0.3.2 adds tool-call arguments to ToolContext, Annotated-type schema support, and full header overrides. • Adds tool call arguments to `ToolContext` in `RunHooks`, giving hook implementations direct access to the arguments passed to each tool invocation. • Supports `Annotated` types in function tool schemas, enabling richer metadata and constraints on tool parameters. • Allows full HTTP header overrides on the client (previously limited to the user-agent header only).

OpenAI Agents SDK v0.3.1

Thu, 18 Sep 2025 17:20:46 GMT

OpenAI Agents SDK v0.3.1 adds Anthropic extended thinking, input audio noise reduction, session encryption, Annotated-type tool params, and expanded Agent#as_tool options. • Supports `typing.Annotated` types for function tool parameter descriptions, letting developers embed param metadata directly in type hints. • Adds more options to `Agent#as_tool` for finer control when exposing an agent as a callable tool. • Exports `user_agent_override` context manager for overriding the HTTP User-Agent header at runtime. • Adds input audio noise reduction for realtime voice sessions via the Realtime API. • Migrates STT streaming to match the GA Realtime API. • Adds session encryption support using the `cryptography` library in the Sessions implementation. • Supports Anthropic extended thinking and interleaved thinking in agent runs. • Adds a warning when agent names transform into conflicting function names. Breaking changes: • Voice STT streaming has been migrated to match the GA Realtime API — existing STT streaming integrations may need to be updated.

OpenAI Agents SDK v0.3.0

Thu, 11 Sep 2025 19:19:43 GMT

OpenAI Agents SDK v0.3.0 migrates the Realtime Agent integration to the GA Realtime API. • Updates Realtime Agent support to target the generally available OpenAI Realtime API, replacing the previous preview integration. • Allows passing both a `session` and an `input` list together when running agents, enabling more flexible session-and-input composition.

OpenAI Agents SDK v0.2.10

Fri, 29 Aug 2025 14:07:59 GMT

Adds environment-variable control for trace_include_sensitive_data, conversations API support, and reasoning text delta events for gpt-oss models. • Enables `trace_include_sensitive_data` to be configured via an environment variable, letting operators control sensitive data inclusion in traces without code changes. • Adds conversations API support. • Adds reasoning text delta event support for gpt-oss models in streaming runs.

OpenAI Agents SDK v0.2.9

Fri, 22 Aug 2025 02:03:10 GMT

OpenAI Agents SDK v0.2.9 adds lifecycle hooks, SQLAlchemy history backend, MCP retry logic, and realtime input timeouts. • Adds `on_llm_start` and `on_llm_end` lifecycle hooks to the agent, letting callers instrument or intercept LLM calls at the start and end of each invocation. • Adds a `context` parameter to `run_demo_loop`, enabling callers to pass runtime context through the interactive demo loop. • Adds a SQLAlchemy session backend for conversation history management, enabling persistent, database-backed storage of conversation state. • Adds retry logic to MCP server operations, improving resilience when MCP servers are temporarily unavailable. • Adds a realtime input timeout trigger event, surfacing a new event type when realtime session input exceeds a configured timeout. • Adds conditional tool enabling to agent-as-tool, allowing tools exposed via an agent to be selectively enabled or disabled at runtime. • Adds a quick opt-in option to switch to the `gpt-5` model.

OpenAI Agents SDK 0.2.8

Fri, 15 Aug 2025 23:23:33 GMT

OpenAI Agents SDK 0.2.8 adds input modification hooks and removes Realtime message size limits. • Allows modifying the input sent to the model before it is dispatched, enabling pre-processing or sanitization of agent inputs at runtime. • Realtime transport now accepts arbitrarily sized messages, removing previous message-length restrictions.

OpenAI Agents SDK v0.2.7

Thu, 14 Aug 2025 18:58:23 GMT

OpenAI Agents SDK v0.2.7 adds reasoning.effort and verbosity params to ModelSettings plus a Realtime handoff prompt prefix. • Adds `reasoning.effort='minimal'` and `verbosity` parameters to `ModelSettings` for fine-grained control over model reasoning behaviour. • Adds a handoff prompt prefix for Realtime agents, improving context handoff in real-time sessions. • Adds runtime validation for `Agent` constructor arguments, catching misconfiguration at instantiation time.

OpenAI Agents SDK v0.2.6

Mon, 11 Aug 2025 18:51:41 GMT

OpenAI Agents SDK v0.2.6 adds output guardrails for realtime agents and `logprobs` to `ModelSettings`. • Adds `logprobs` field to `ModelSettings` class, enabling log-probability output from model responses. • Supports agent output guardrails in realtime sessions, bringing parity with non-realtime guardrail enforcement.

OpenAI Agents SDK v0.2.5

Thu, 07 Aug 2025 21:04:58 GMT

OpenAI Agents SDK v0.2.5 adds realtime speed control, agent-update-mid-session, MCP server visualization, and split stream events. • Adds `speed` parameter to the realtime API to control the pace of model responses during a session. • Adds the ability to update an agent's configuration during an active realtime session via the new update-agent functionality. • Separates `tool_call_item` and `tool_call_output_item` into distinct stream events, giving handlers finer-grained control over tool call lifecycle. • Exports `MultiProvider` in the public API, making multi-model-provider routing directly importable from the `agents` module. • Visualization now draws MCP servers in agent graphs, making the full tool topology visible. • Enables passing async functions to `HandoffInputData`, expanding handoff customization options.

OpenAI Agents SDK v0.2.4

Tue, 29 Jul 2025 21:38:45 GMT

OpenAI Agents SDK v0.2.4 adds Realtime playback tracking, raw model event forwarding, and a Twilio integration example. • Realtime: enables a playback tracker to monitor audio playback state during realtime sessions. • Realtime: forwards all raw model events to callers, giving full visibility into underlying model event stream. • Realtime: sends audio item and content index in audio events for more precise audio handling. • Realtime: adds a Twilio integration example demonstrating how to connect the Realtime API to a Twilio voice session. • Realtime: optimizes response cancellation to only cancel a response when actually necessary.

OpenAI Agents SDK v0.2.3

Mon, 21 Jul 2025 19:33:53 GMT

OpenAI Agents SDK v0.2.3 adds direct access to the model layer from a realtime session. • Adds direct access to the model layer from a realtime session, enabling lower-level control over the realtime model interface.

OpenAI Agents SDK v0.2.1

Wed, 16 Jul 2025 19:58:56 GMT

OpenAI Agents SDK v0.2.1 adds beta Realtime agents with handoffs and MCP structuredContent support. • Supports `structuredContent` in MCP `tool_result` responses, enabling richer structured data from MCP tools. • Introduces Realtime agents (beta) with support for handoffs between agents during live audio/streaming sessions. • Adds streaming of function call arguments to Chat Completions.

OpenAI Agents SDK v0.2.0

Tue, 15 Jul 2025 15:49:07 GMT

OpenAI Agents SDK v0.2.0 adds Sessions for conversation history, beta RealtimeAgent support, MCP prompts, and file_input content. • Introduces `Sessions` API for automatic conversation history management, letting agents maintain context across multiple turns without manual history threading. • Adds `RealtimeAgent` class (beta) with a dedicated `RealtimeSession`, OpenAI realtime transport implementation, guardrail support, and built-in tracing. • Adds `on_start` support to `VoiceWorkflowBase` and `VoicePipeline` for lifecycle hooks at session start. • Supports `file_input` content type in agent inputs. • Supports MCP prompts via the MCP integration layer. • Adds support for pydantic `Field` annotations in tool arguments for tools decorated with `@function_schema`. Breaking changes: • The `Agent` class is split into `AgentBase` and `Agent`; code that references or subclasses `Agent` directly may break if it relied on internals now moved to `AgentBase`.

OpenAI Agents SDK v0.1.0

Fri, 27 Jun 2025 20:57:28 GMT

OpenAI Agents SDK v0.1.0 adds `is_enabled` on handoffs, MCP tool filtering, safety check handling for ComputerTool, and reasoning content support. • Adds `is_enabled` to handoffs, allowing conditional enabling/disabling of agent handoff targets at runtime. • Adds MCP tool filtering support, enabling agents to restrict which tools are exposed from an MCP server. • Adds safety check handling for `ComputerTool`, surfacing safety blocks during computer-use actions. • Adds reasoning content output, making reasoning model intermediate thoughts accessible in responses. Breaking changes: • MCP server interface includes a breaking change in this release; see https://openai.github.io/openai-agents-python/release/ for the specific migration details.

OpenAI Agents SDK v0.0.19

Wed, 18 Jun 2025 00:48:50 GMT

OpenAI Agents SDK v0.0.19 makes `Runner` an abstract base class, enabling custom runner implementations. • Converts `Runner` to an abstract base class, allowing practitioners to subclass and implement custom runner logic. Breaking changes: • The `Runner` class is now abstract; any code that instantiates `Runner` directly will break on upgrade — subclass it instead.

OpenAI Agents SDK v0.0.18

Mon, 16 Jun 2025 19:50:42 GMT

OpenAI Agents SDK v0.0.18 adds REPL support, dynamic prompt templates, and `tool_call_id` access in tool context. • Adds `run_demo_loop` REPL helper for interactive agent testing sessions. • Adds `tool_call_id` access via `RunContextWrapper` so tool functions can read the ID of the current tool call. • Supports dynamic prompt templates through the OpenAI Prompts feature, enabling centrally managed, versioned agent instructions. • Allows arbitrary keyword arguments to be passed through to the underlying model, enabling access to provider-specific parameters not yet explicitly supported. Breaking changes: • Timeout parameters now accept `float` (seconds) instead of `timedelta` objects — any code passing `timedelta` values to timeout parameters will break.

OpenAI Agents SDK v0.0.17

Wed, 04 Jun 2025 02:37:25 GMT

v0.0.17 adds Portkey AI tracing, `RunErrorDetails` for max-turns exceptions, and `is_enabled` on `FunctionTool`. • Adds `is_enabled` field to `FunctionTool`, allowing tools to be conditionally activated or deactivated at runtime. • Adds `RunErrorDetails` object to the `MaxTurnsExceeded` exception, giving callers structured context when an agent run hits its turn limit. • Adds Portkey AI as a tracing provider, enabling traces to be sent to the Portkey observability platform.

OpenAI Agents SDK v0.0.16

Wed, 21 May 2025 20:07:01 GMT

Adds hosted remote MCP, code interpreter, image generator, and local shell tools, plus an MCP server `instructions` attribute. • Adds an `instructions` attribute to MCP server configuration, allowing per-server instruction strings to be passed alongside tool definitions. • Adds support for hosted remote MCP as a first-class tool type, enabling agents to call remote MCP endpoints without self-hosting a proxy. • Adds a hosted code interpreter tool, letting agents execute code in a sandboxed environment via the Responses API. • Adds a hosted image generator tool, enabling agents to generate images as part of a response pipeline. • Adds a local shell tool, allowing agents to run shell commands on the local machine as a built-in tool type.

OpenAI Agents SDK v0.0.15

Thu, 15 May 2025 22:43:04 GMT

OpenAI Agents SDK v0.0.15 adds Streamable HTTP transport for MCP servers and `extra_body` pass-through to LiteLLM. • Passes `extra_body` through to LiteLLM `acompletion` calls, enabling custom request body fields when using LiteLLM as a model provider. • Adds Streamable HTTP transport support for MCP servers, enabling agents to connect to MCP servers over streamable HTTP in addition to existing transports.

OpenAI Agents SDK v0.0.14

Wed, 30 Apr 2025 15:19:09 GMT

OpenAI Agents SDK v0.0.14 exposes token usage in streaming context and makes TTS voice types exportable. • Exposes `usage` data on the streaming context, letting callers inspect token consumption during streamed agent runs. • Makes the TTS voices type exportable from the SDK, enabling typed references to voice options in downstream code.

OpenAI Agents SDK v0.0.13

Thu, 24 Apr 2025 18:59:38 GMT

OpenAI Agents SDK v0.0.13 adds `extra_headers` to ModelSettings, streaming cancellation, and `to_json_dict` serialization. • Adds `extra_headers` parameter to `ModelSettings` to pass custom HTTP headers on a per-model-settings basis. • Adds to_json_dict() method to `ModelSettings` for serializing model configuration to a JSON-compatible dictionary. • Enables cancellation of in-progress streaming runs via the streaming result object.

OpenAI Agents SDK v0.0.12

Tue, 22 Apr 2025 03:08:07 GMT

OpenAI Agents SDK v0.0.12 adds LiteLLM integration for any third-party model and lifts strict-mode restrictions on agent output types. • Adds LiteLLM integration: pass any provider model to `Agent` via `model="litellm//"` (e.g. `model="litellm/anthropic/claude-3-5-sonnet-20240620"`) to route completions through LiteLLM's unified interface. • Enables non-strict output types on `Agent`, allowing more complex structured outputs that previously required strict JSON schema mode.

OpenAI Agents SDK v0.0.10

Tue, 15 Apr 2025 02:48:24 GMT

OpenAI Agents SDK v0.0.10 adds `previous_response_id` support and new `ModelSettings` fields `extra_query`, `extra_body`, and `stream_options`. • Adds `extra_query` and `extra_body` fields to `ModelSettings` for passing extra request parameters directly to the underlying API call. • Adds support for `previous_response_id` from the OpenAI Responses API, enabling stateful multi-turn conversations without re-sending full message history. • Adds overwrite mechanism for `stream_options` in `ModelSettings`, allowing fine-grained control over streaming behavior. Breaking changes: • The `referencable_id` field is renamed to `response_id` — any code referencing `referencable_id` will break.

OpenAI Agents SDK v0.0.8

Thu, 03 Apr 2025 23:47:01 GMT

OpenAI Agents SDK v0.0.8 adds `store`, `metadata`, and `reasoning` to `ModelSettings`, plus Databricks MLflow tracing and MCP strict-schema conversion. • Adds `store` parameter to `ModelSettings` to control whether model responses are stored. • Adds `metadata` field to `ModelSettings` for attaching arbitrary key-value metadata to model requests. • Adds `reasoning` parameter to `ModelSettings` to configure model reasoning behavior. • Converts MCP tool schemas to strict mode where possible, improving compatibility with strict-schema model APIs. • Adds Databricks MLflow tracing integration for agent observability.

OpenAI Agents SDK v0.0.7

Wed, 26 Mar 2025 16:08:19 GMT

OpenAI Agents SDK v0.0.7 adds MCP server support, Graphviz agent visualization, and configurable tool-choice reset behavior. • Adds MCP (Model Context Protocol) types to the SDK, enabling agents to connect to MCP servers as tool sources. • Adds MCP support to the `Runner`, allowing agents to invoke tools served over MCP stdio transports. • Adds MCP tracing so MCP tool calls appear as spans in the existing tracing pipeline. • Adds Graphviz-based agent visualization functionality to graph agent topology. • Makes the tool-use reset behavior configurable when `tool_choice` is set, giving callers control over how the SDK handles repeated tool-call loops.

OpenAI Agents SDK v0.0.6

Thu, 20 Mar 2025 17:13:27 GMT

OpenAI Agents SDK v0.0.6 adds voice pipeline support to the Python library. • Adds voice pipeline support, enabling agents to process and respond to audio input/output within the SDK.

OpenAI Agents SDK v0.0.5

Wed, 19 Mar 2025 16:36:45 GMT

Adds `tool_use_behavior` on agents and `strict_mode` on function tools, plus `TracingProcessor` public export • Adds `strict_mode` option to `function_schema` and `function_tool` to control strict JSON schema enforcement on tool inputs. • Introduces `tool_use_behavior` field on agents to configure how the agent responds when tools are used. • Exports `TracingProcessor` from the top-level `__init__.py`, making it directly importable as a public API. • Pretty-prints result classes for improved readability during development and debugging.

OpenAI Agents SDK v0.0.4

Thu, 13 Mar 2025 15:20:22 GMT

v0.0.4 adds `max_tokens` to model settings, request ID tracking, and Keywords AI and Scorecard as external trace processors. • Adds `max_tokens` field to `ModelSettings` to cap token usage per model call. • Adds request ID tracking to model responses, enabling correlation of SDK calls to upstream API requests. • Adds Keywords AI as a supported external trace processor for agent observability pipelines. • Adds Scorecard as a supported external trace processor for agent observability pipelines. • Adds examples and documentation for using custom model providers with the SDK.