openai-agents 0.0.7__tar.gz → 0.0.9__tar.gz

{openai_agents-0.0.7 → openai_agents-0.0.9}/.github/ISSUE_TEMPLATE/feature_request.md

@@ -10,7 +10,7 @@ assignees: ''
 ### Please read this first
 
 - **Have you read the docs?**[Agents SDK docs](https://openai.github.io/openai-agents-python/)
-- **Have you searched for related issues?** Others may have had similar requesrs
+- **Have you searched for related issues?** Others may have had similar requests
 
 ### Describe the feature
 What is the feature you're requesting? How would it work? Please provide examples and details if possible.

{openai_agents-0.0.7 → openai_agents-0.0.9}/.github/ISSUE_TEMPLATE/question.md

@@ -10,7 +10,7 @@ assignees: ''
 ### Please read this first
 
 - **Have you read the docs?**[Agents SDK docs](https://openai.github.io/openai-agents-python/)
-- **Have you searched for related issues?** Others may have had similar requesrs
+- **Have you searched for related issues?** Others may have had similar requests
 
 ### Question
 Describe your question. Provide details if available.

openai_agents-0.0.9/.vscode/settings.json

@@ -0,0 +1,7 @@
+{
+    "python.testing.pytestArgs": [
+        "tests"
+    ],
+    "python.testing.unittestEnabled": false,
+    "python.testing.pytestEnabled": true
+}

{openai_agents-0.0.7 → openai_agents-0.0.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: openai-agents
-Version: 0.0.7
+Version: 0.0.9
 Summary: OpenAI Agents SDK
 Project-URL: Homepage, https://github.com/openai/openai-agents-python
 Project-URL: Repository, https://github.com/openai/openai-agents-python
@@ -19,7 +19,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.9
 Requires-Dist: griffe<2,>=1.5.6
-Requires-Dist: mcp; python_version >= '3.10'
+Requires-Dist: mcp<2,>=1.6.0; python_version >= '3.10'
 Requires-Dist: openai>=1.66.5
 Requires-Dist: pydantic<3,>=2.10
 Requires-Dist: requests<3,>=2.0

{openai_agents-0.0.7 → openai_agents-0.0.9}/docs/examples.md

@@ -5,32 +5,38 @@ Check out a variety of sample implementations of the SDK in the examples section
 
 ## Categories
 
-- **agent_patterns:**
+- **[agent_patterns](https://github.com/openai/openai-agents-python/tree/main/examples/agent_patterns):**
   Examples in this category illustrate common agent design patterns, such as
-  
+
     - Deterministic workflows
     - Agents as tools
     - Parallel agent execution
 
-- **basic:**
+- **[basic](https://github.com/openai/openai-agents-python/tree/main/examples/basic):**
   These examples showcase foundational capabilities of the SDK, such as
-  
+
     - Dynamic system prompts
     - Streaming outputs
     - Lifecycle events
 
-- **tool examples:**
+- **[tool examples](https://github.com/openai/openai-agents-python/tree/main/examples/tools):**
   Learn how to implement OAI hosted tools such as web search and file search,
    and integrate them into your agents.
 
-- **model providers:**
+- **[model providers](https://github.com/openai/openai-agents-python/tree/main/examples/model_providers):**
   Explore how to use non-OpenAI models with the SDK.
 
-- **handoffs:**
+- **[handoffs](https://github.com/openai/openai-agents-python/tree/main/examples/handoffs):**
   See practical examples of agent handoffs.
 
-- **customer_service** and **research_bot:**
+- **[mcp](https://github.com/openai/openai-agents-python/tree/main/examples/mcp):**
+  Learn how to build agents with MCP.
+
+- **[customer_service](https://github.com/openai/openai-agents-python/tree/main/examples/customer_service)** and **[research_bot](https://github.com/openai/openai-agents-python/tree/main/examples/research_bot):**
   Two more built-out examples that illustrate real-world applications
-  
+
     - **customer_service**: Example customer service system for an airline.
     - **research_bot**: Simple deep research clone.
+
+- **[voice](https://github.com/openai/openai-agents-python/tree/main/examples/voice):**
+  See examples of voice agents, using our TTS and STT models.

{openai_agents-0.0.7 → openai_agents-0.0.9}/docs/mcp.md

@@ -1,4 +1,4 @@
-# Model context protocol
+# Model context protocol (MCP)
 
 The [Model context protocol](https://modelcontextprotocol.io/introduction) (aka MCP) is a way to provide tools and context to the LLM. From the MCP docs:
 
@@ -46,6 +46,15 @@ Every time an Agent runs, it calls `list_tools()` on the MCP server. This can be
 
 If you want to invalidate the cache, you can call `invalidate_tools_cache()` on the servers.
 
-## End-to-end example
+## End-to-end examples
 
 View complete working examples at [examples/mcp](https://github.com/openai/openai-agents-python/tree/main/examples/mcp).
+
+## Tracing
+
+[Tracing](./tracing.md) automatically captures MCP operations, including:
+
+1. Calls to the MCP server to list tools
+2. MCP-related info on function calls
+
+![MCP Tracing Screenshot](./assets/images/mcp-tracing.jpg)

{openai_agents-0.0.7 → openai_agents-0.0.9}/docs/running_agents.md

@@ -53,7 +53,7 @@ The `run_config` parameter lets you configure some global settings for the agent
 -   [`handoff_input_filter`][agents.run.RunConfig.handoff_input_filter]: A global input filter to apply to all handoffs, if the handoff doesn't already have one. The input filter allows you to edit the inputs that are sent to the new agent. See the documentation in [`Handoff.input_filter`][agents.handoffs.Handoff.input_filter] for more details.
 -   [`tracing_disabled`][agents.run.RunConfig.tracing_disabled]: Allows you to disable [tracing](tracing.md) for the entire run.
 -   [`trace_include_sensitive_data`][agents.run.RunConfig.trace_include_sensitive_data]: Configures whether traces will include potentially sensitive data, such as LLM and tool call inputs/outputs.
--   [`workflow_name`][agents.run.RunConfig.workflow_name], [`trace_id`][agents.run.RunConfig.trace_id], [`group_id`][agents.run.RunConfig.group_id]: Sets the tracing workflow name, trace ID and trace group ID for the run. We recommend at least setting `workflow_name`. The session ID is an optional field that lets you link traces across multiple runs.
+-   [`workflow_name`][agents.run.RunConfig.workflow_name], [`trace_id`][agents.run.RunConfig.trace_id], [`group_id`][agents.run.RunConfig.group_id]: Sets the tracing workflow name, trace ID and trace group ID for the run. We recommend at least setting `workflow_name`. The group ID is an optional field that lets you link traces across multiple runs.
 -   [`trace_metadata`][agents.run.RunConfig.trace_metadata]: Metadata to include on all traces.
 
 ## Conversations/chat threads

{openai_agents-0.0.7 → openai_agents-0.0.9}/docs/tracing.md

@@ -101,7 +101,8 @@ To customize this default setup, to send traces to alternative or additional bac
 
 -   [Weights & Biases](https://weave-docs.wandb.ai/guides/integrations/openai_agents)
 -   [Arize-Phoenix](https://docs.arize.com/phoenix/tracing/integrations-tracing/openai-agents-sdk)
--   [MLflow](https://mlflow.org/docs/latest/tracing/integrations/openai-agent)
+-   [MLflow (self-hosted/OSS](https://mlflow.org/docs/latest/tracing/integrations/openai-agent)
+-   [MLflow (Databricks hosted](https://docs.databricks.com/aws/en/mlflow/mlflow-tracing#-automatic-tracing)
 -   [Braintrust](https://braintrust.dev/docs/guides/traces/integrations#openai-agents-sdk)
 -   [Pydantic Logfire](https://logfire.pydantic.dev/docs/integrations/llms/openai/#openai-agents)
 -   [AgentOps](https://docs.agentops.ai/v1/integrations/agentssdk)
@@ -111,3 +112,5 @@ To customize this default setup, to send traces to alternative or additional bac
 -   [Maxim AI](https://www.getmaxim.ai/docs/observe/integrations/openai-agents-sdk)
 -   [Comet Opik](https://www.comet.com/docs/opik/tracing/integrations/openai_agents)
 -   [Langfuse](https://langfuse.com/docs/integrations/openaiagentssdk/openai-agents)
+-   [Langtrace](https://docs.langtrace.ai/supported-integrations/llm-frameworks/openai-agents-sdk)
+-   [Okahu-Monocle](https://github.com/monocle2ai/monocle)

{openai_agents-0.0.7 → openai_agents-0.0.9}/examples/financial_research_agent/manager.py

@@ -38,7 +38,7 @@ class FinancialResearchManager:
         with trace("Financial research trace", trace_id=trace_id):
             self.printer.update_item(
                 "trace_id",
-                f"View trace: https://platform.openai.com/traces/{trace_id}",
+                f"View trace: https://platform.openai.com/traces/trace?trace_id={trace_id}",
                 is_done=True,
                 hide_checkmark=True,
             )

{openai_agents-0.0.7 → openai_agents-0.0.9}/examples/mcp/filesystem_example/README.md

@@ -5,12 +5,12 @@ This example uses the [filesystem MCP server](https://github.com/modelcontextpro
 Run it via:
 
 ```
-uv run python  python examples/mcp/filesystem_example/main.py
+uv run python examples/mcp/filesystem_example/main.py
 ```
 
 ## Details
 
-The example uses the `MCPServerStdio` class from `agents`, with the command:
+The example uses the `MCPServerStdio` class from `agents.mcp`, with the command:
 
 ```bash
 npx -y "@modelcontextprotocol/server-filesystem" <samples_directory>

{openai_agents-0.0.7 → openai_agents-0.0.9}/examples/mcp/filesystem_example/main.py

@@ -45,7 +45,7 @@ async def main():
     ) as server:
         trace_id = gen_trace_id()
         with trace(workflow_name="MCP Filesystem Example", trace_id=trace_id):
-            print(f"View trace: https://platform.openai.com/traces/{trace_id}\n")
+            print(f"View trace: https://platform.openai.com/traces/trace?trace_id={trace_id}\n")
             await run(server)
 
 

{openai_agents-0.0.7 → openai_agents-0.0.9}/examples/mcp/git_example/README.md

@@ -10,16 +10,17 @@ uv run python examples/mcp/git_example/main.py
 
 ## Details
 
-The example uses the `MCPServerStdio` class from `agents`, with the command:
+The example uses the `MCPServerStdio` class from `agents.mcp`, with the command:
 
 ```bash
 uvx mcp-server-git
 ```
+
 Prior to running the agent, the user is prompted to provide a local directory path to their git repo. Using that, the Agent can invoke Git MCP tools like `git_log` to inspect the git commit log.
 
 Under the hood:
 
 1. The server is spun up in a subprocess, and exposes a bunch of tools like `git_log()`
 2. We add the server instance to the Agent via `mcp_agents`.
-3. Each time the agent runs, we call out to the MCP server to fetch the list of tools via `server.list_tools()`. The result is cached. 
+3. Each time the agent runs, we call out to the MCP server to fetch the list of tools via `server.list_tools()`. The result is cached.
 4. If the LLM chooses to use an MCP tool, we call the MCP server to run the tool via `server.run_tool()`.

{openai_agents-0.0.7 → openai_agents-0.0.9}/examples/mcp/git_example/main.py

@@ -30,12 +30,8 @@ async def main():
     directory_path = input("Please enter the path to the git repository: ")
 
     async with MCPServerStdio(
-        params={
-            "command": "uvx",
-            "args": [
-                "mcp-server-git"
-            ]
-        }
+        cache_tools_list=True,  # Cache the tools list, for demonstration
+        params={"command": "uvx", "args": ["mcp-server-git"]},
     ) as server:
         with trace(workflow_name="MCP Git Example"):
             await run(server, directory_path)

openai_agents-0.0.9/examples/mcp/sse_example/README.md

@@ -0,0 +1,13 @@
+# MCP SSE Example
+
+This example uses a local SSE server in [server.py](server.py).
+
+Run the example via:
+
+```
+uv run python examples/mcp/sse_example/main.py
+```
+
+## Details
+
+The example uses the `MCPServerSse` class from `agents.mcp`. The server runs in a sub-process at `https://localhost:8000/sse`.

openai_agents-0.0.9/examples/mcp/sse_example/main.py

@@ -0,0 +1,83 @@
+import asyncio
+import os
+import shutil
+import subprocess
+import time
+from typing import Any
+
+from agents import Agent, Runner, gen_trace_id, trace
+from agents.mcp import MCPServer, MCPServerSse
+from agents.model_settings import ModelSettings
+
+
+async def run(mcp_server: MCPServer):
+    agent = Agent(
+        name="Assistant",
+        instructions="Use the tools to answer the questions.",
+        mcp_servers=[mcp_server],
+        model_settings=ModelSettings(tool_choice="required"),
+    )
+
+    # Use the `add` tool to add two numbers
+    message = "Add these numbers: 7 and 22."
+    print(f"Running: {message}")
+    result = await Runner.run(starting_agent=agent, input=message)
+    print(result.final_output)
+
+    # Run the `get_weather` tool
+    message = "What's the weather in Tokyo?"
+    print(f"\n\nRunning: {message}")
+    result = await Runner.run(starting_agent=agent, input=message)
+    print(result.final_output)
+
+    # Run the `get_secret_word` tool
+    message = "What's the secret word?"
+    print(f"\n\nRunning: {message}")
+    result = await Runner.run(starting_agent=agent, input=message)
+    print(result.final_output)
+
+
+async def main():
+    async with MCPServerSse(
+        name="SSE Python Server",
+        params={
+            "url": "http://localhost:8000/sse",
+        },
+    ) as server:
+        trace_id = gen_trace_id()
+        with trace(workflow_name="SSE Example", trace_id=trace_id):
+            print(f"View trace: https://platform.openai.com/traces/trace?trace_id={trace_id}\n")
+            await run(server)
+
+
+if __name__ == "__main__":
+    # Let's make sure the user has uv installed
+    if not shutil.which("uv"):
+        raise RuntimeError(
+            "uv is not installed. Please install it: https://docs.astral.sh/uv/getting-started/installation/"
+        )
+
+    # We'll run the SSE server in a subprocess. Usually this would be a remote server, but for this
+    # demo, we'll run it locally at http://localhost:8000/sse
+    process: subprocess.Popen[Any] | None = None
+    try:
+        this_dir = os.path.dirname(os.path.abspath(__file__))
+        server_file = os.path.join(this_dir, "server.py")
+
+        print("Starting SSE server at http://localhost:8000/sse ...")
+
+        # Run `uv run server.py` to start the SSE server
+        process = subprocess.Popen(["uv", "run", server_file])
+        # Give it 3 seconds to start
+        time.sleep(3)
+
+        print("SSE server started. Running example...\n\n")
+    except Exception as e:
+        print(f"Error starting SSE server: {e}")
+        exit(1)
+
+    try:
+        asyncio.run(main())
+    finally:
+        if process:
+            process.terminate()

openai_agents-0.0.9/examples/mcp/sse_example/server.py

@@ -0,0 +1,33 @@
+import random
+
+import requests
+from mcp.server.fastmcp import FastMCP
+
+# Create server
+mcp = FastMCP("Echo Server")
+
+
+@mcp.tool()
+def add(a: int, b: int) -> int:
+    """Add two numbers"""
+    print(f"[debug-server] add({a}, {b})")
+    return a + b
+
+
+@mcp.tool()
+def get_secret_word() -> str:
+    print("[debug-server] get_secret_word()")
+    return random.choice(["apple", "banana", "cherry"])
+
+
+@mcp.tool()
+def get_current_weather(city: str) -> str:
+    print(f"[debug-server] get_current_weather({city})")
+
+    endpoint = "https://wttr.in"
+    response = requests.get(f"{endpoint}/{city}")
+    return response.text
+
+
+if __name__ == "__main__":
+    mcp.run(transport="sse")

{openai_agents-0.0.7 → openai_agents-0.0.9}/examples/research_bot/manager.py

@@ -23,7 +23,7 @@ class ResearchManager:
         with trace("Research trace", trace_id=trace_id):
             self.printer.update_item(
                 "trace_id",
-                f"View trace: https://platform.openai.com/traces/{trace_id}",
+                f"View trace: https://platform.openai.com/traces/trace?trace_id={trace_id}",
                 is_done=True,
                 hide_checkmark=True,
             )

{openai_agents-0.0.7 → openai_agents-0.0.9}/examples/research_bot/sample_outputs/product_recs.txt

@@ -3,7 +3,7 @@
 $ uv run python -m examples.research_bot.main
 
 What would you like to research? Best surfboards for beginners. I can catch my own waves, but previously used an 11ft board. What should I look for, what are my options? Various budget ranges.
-View trace: https://platform.openai.com/traces/trace_...
+View trace: https://platform.openai.com/traces/trace?trace_id=trace_...
 Starting research...
 ✅ Will perform 15 searches
 ✅ Searching... 15/15 completed

{openai_agents-0.0.7 → openai_agents-0.0.9}/examples/research_bot/sample_outputs/vacation.txt

@@ -2,7 +2,7 @@
 
 $ uv run python -m examples.research_bot.main
 What would you like to research? Caribbean vacation spots in April, optimizing for surfing, hiking and water sports
-View trace: https://platform.openai.com/traces/trace_....
+View trace: https://platform.openai.com/traces/trace?trace_id=trace_....
 Starting research...
 ✅ Will perform 15 searches
 ✅ Searching... 15/15 completed

{openai_agents-0.0.7 → openai_agents-0.0.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "openai-agents"
-version = "0.0.7"
+version = "0.0.9"
 description = "OpenAI Agents SDK"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -13,7 +13,7 @@ dependencies = [
     "typing-extensions>=4.12.2, <5",
     "requests>=2.0, <3",
     "types-requests>=2.0, <3",
-    "mcp; python_version >= '3.10'",
+    "mcp>=1.6.0, <2; python_version >= '3.10'",
 ]
 classifiers = [
     "Typing :: Typed",
@@ -54,7 +54,6 @@ dev = [
     "pynput",
     "types-pynput",
     "sounddevice",
-    "pynput",
     "textual",
     "websockets",
     "graphviz",

{openai_agents-0.0.7 → openai_agents-0.0.9}/src/agents/__init__.py

@@ -100,6 +100,7 @@ from .tracing import (
     transcription_span,
 )
 from .usage import Usage
+from .version import __version__
 
 
 def set_default_openai_key(key: str, use_for_tracing: bool = True) -> None:
@@ -247,4 +248,5 @@ __all__ = [
     "gen_trace_id",
     "gen_span_id",
     "default_tool_error_function",
+    "__version__",
 ]

{openai_agents-0.0.7 → openai_agents-0.0.9}/src/agents/agent.py

@@ -6,7 +6,7 @@ from collections.abc import Awaitable
 from dataclasses import dataclass, field
 from typing import TYPE_CHECKING, Any, Callable, Generic, Literal, cast
 
-from typing_extensions import TypeAlias, TypedDict
+from typing_extensions import NotRequired, TypeAlias, TypedDict
 
 from .guardrail import InputGuardrail, OutputGuardrail
 from .handoffs import Handoff
@@ -44,7 +44,7 @@ ToolsToFinalOutputFunction: TypeAlias = Callable[
     MaybeAwaitable[ToolsToFinalOutputResult],
 ]
 """A function that takes a run context and a list of tool results, and returns a
-`ToolToFinalOutputResult`.
+`ToolsToFinalOutputResult`.
 """
 
 
@@ -53,6 +53,15 @@ class StopAtTools(TypedDict):
     """A list of tool names, any of which will stop the agent from running further."""
 
 
+class MCPConfig(TypedDict):
+    """Configuration for MCP servers."""
+
+    convert_schemas_to_strict: NotRequired[bool]
+    """If True, we will attempt to convert the MCP schemas to strict-mode schemas. This is a
+    best-effort conversion, so some schemas may not be convertible. Defaults to False.
+    """
+
+
 @dataclass
 class Agent(Generic[TContext]):
     """An agent is an AI model configured with instructions, tools, guardrails, handoffs and more.
@@ -119,6 +128,9 @@ class Agent(Generic[TContext]):
     longer needed.
     """
 
+    mcp_config: MCPConfig = field(default_factory=lambda: MCPConfig())
+    """Configuration for MCP servers."""
+
     input_guardrails: list[InputGuardrail[TContext]] = field(default_factory=list)
     """A list of checks that run in parallel to the agent's execution, before generating a
     response. Runs only if the agent is the first agent in the chain.
@@ -224,7 +236,8 @@ class Agent(Generic[TContext]):
 
     async def get_mcp_tools(self) -> list[Tool]:
         """Fetches the available tools from the MCP servers."""
-        return await MCPUtil.get_all_function_tools(self.mcp_servers)
+        convert_schemas_to_strict = self.mcp_config.get("convert_schemas_to_strict", False)
+        return await MCPUtil.get_all_function_tools(self.mcp_servers, convert_schemas_to_strict)
 
     async def get_all_tools(self) -> list[Tool]:
         """All agent tools, including MCP tools and function tools."""

{openai_agents-0.0.7 → openai_agents-0.0.9}/src/agents/mcp/util.py

@@ -2,6 +2,8 @@ import functools
 import json
 from typing import TYPE_CHECKING, Any
 
+from agents.strict_schema import ensure_strict_json_schema
+
 from .. import _debug
 from ..exceptions import AgentsException, ModelBehaviorError, UserError
 from ..logger import logger
@@ -19,12 +21,14 @@ class MCPUtil:
     """Set of utilities for interop between MCP and Agents SDK tools."""
 
     @classmethod
-    async def get_all_function_tools(cls, servers: list["MCPServer"]) -> list[Tool]:
+    async def get_all_function_tools(
+        cls, servers: list["MCPServer"], convert_schemas_to_strict: bool
+    ) -> list[Tool]:
         """Get all function tools from a list of MCP servers."""
         tools = []
         tool_names: set[str] = set()
         for server in servers:
-            server_tools = await cls.get_function_tools(server)
+            server_tools = await cls.get_function_tools(server, convert_schemas_to_strict)
             server_tool_names = {tool.name for tool in server_tools}
             if len(server_tool_names & tool_names) > 0:
                 raise UserError(
@@ -37,25 +41,42 @@ class MCPUtil:
         return tools
 
     @classmethod
-    async def get_function_tools(cls, server: "MCPServer") -> list[Tool]:
+    async def get_function_tools(
+        cls, server: "MCPServer", convert_schemas_to_strict: bool
+    ) -> list[Tool]:
         """Get all function tools from a single MCP server."""
 
         with mcp_tools_span(server=server.name) as span:
             tools = await server.list_tools()
             span.span_data.result = [tool.name for tool in tools]
 
-        return [cls.to_function_tool(tool, server) for tool in tools]
+        return [cls.to_function_tool(tool, server, convert_schemas_to_strict) for tool in tools]
 
     @classmethod
-    def to_function_tool(cls, tool: "MCPTool", server: "MCPServer") -> FunctionTool:
+    def to_function_tool(
+        cls, tool: "MCPTool", server: "MCPServer", convert_schemas_to_strict: bool
+    ) -> FunctionTool:
         """Convert an MCP tool to an Agents SDK function tool."""
         invoke_func = functools.partial(cls.invoke_mcp_tool, server, tool)
+        schema, is_strict = tool.inputSchema, False
+
+        # MCP spec doesn't require the inputSchema to have `properties`, but OpenAI spec does.
+        if "properties" not in schema:
+            schema["properties"] = {}
+
+        if convert_schemas_to_strict:
+            try:
+                schema = ensure_strict_json_schema(schema)
+                is_strict = True
+            except Exception as e:
+                logger.info(f"Error converting MCP schema to strict mode: {e}")
+
         return FunctionTool(
             name=tool.name,
             description=tool.description or "",
-            params_json_schema=tool.inputSchema,
+            params_json_schema=schema,
             on_invoke_tool=invoke_func,
-            strict_json_schema=False,
+            strict_json_schema=is_strict,
         )
 
     @classmethod

{openai_agents-0.0.7 → openai_agents-0.0.9}/src/agents/model_settings.py

@@ -1,8 +1,10 @@
 from __future__ import annotations
 
-from dataclasses import dataclass
+from dataclasses import dataclass, fields, replace
 from typing import Literal
 
+from openai.types.shared import Reasoning
+
 
 @dataclass
 class ModelSettings:
@@ -30,8 +32,9 @@ class ModelSettings:
     tool_choice: Literal["auto", "required", "none"] | str | None = None
     """The tool choice to use when calling the model."""
 
-    parallel_tool_calls: bool | None = False
-    """Whether to use parallel tool calls when calling the model."""
+    parallel_tool_calls: bool | None = None
+    """Whether to use parallel tool calls when calling the model.
+    Defaults to False if not provided."""
 
     truncation: Literal["auto", "disabled"] | None = None
     """The truncation strategy to use when calling the model."""
@@ -39,18 +42,27 @@ class ModelSettings:
     max_tokens: int | None = None
     """The maximum number of output tokens to generate."""
 
+    reasoning: Reasoning | None = None
+    """Configuration options for
+    [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+    """
+
+    metadata: dict[str, str] | None = None
+    """Metadata to include with the model response call."""
+
+    store: bool | None = None
+    """Whether to store the generated model response for later retrieval.
+    Defaults to True if not provided."""
+
     def resolve(self, override: ModelSettings | None) -> ModelSettings:
         """Produce a new ModelSettings by overlaying any non-None values from the
         override on top of this instance."""
         if override is None:
             return self
-        return ModelSettings(
-            temperature=override.temperature or self.temperature,
-            top_p=override.top_p or self.top_p,
-            frequency_penalty=override.frequency_penalty or self.frequency_penalty,
-            presence_penalty=override.presence_penalty or self.presence_penalty,
-            tool_choice=override.tool_choice or self.tool_choice,
-            parallel_tool_calls=override.parallel_tool_calls or self.parallel_tool_calls,
-            truncation=override.truncation or self.truncation,
-            max_tokens=override.max_tokens or self.max_tokens,
-        )
+
+        changes = {
+            field.name: getattr(override, field.name)
+            for field in fields(self)
+            if getattr(override, field.name) is not None
+        }
+        return replace(self, **changes)