fix(api): default search_context_size to None to preserve recording compatibility

The search_context_size field defaulted to "medium", which caused the
tool executor to always inject it into kwargs even when not explicitly
set by the user. This changed the recording hash for web search tool
calls, breaking all integration tests in replay mode with "Recording
not found" errors surfaced as 500s.

Change the default to None so search_context_size is only injected
when the user explicitly provides it, preserving backward compatibility
with existing integration test recordings.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Sébastien Han <seb@redhat.com>

Author: leseb

client-sdks/stainless/openapi.yml

@@ -6969,7 +6969,6 @@ components:
             - medium
             - high
           - type: 'null'
-          default: medium
         filters:
           anyOf:
           - $ref: '#/components/schemas/WebSearchFilters'

docs/static/deprecated-ogx-spec.yaml

@@ -3159,7 +3159,6 @@ components:
             - medium
             - high
           - type: 'null'
-          default: medium
         filters:
           anyOf:
           - $ref: '#/components/schemas/WebSearchFilters'

docs/static/experimental-ogx-spec.yaml

@@ -3604,7 +3604,6 @@ components:
             - medium
             - high
           - type: 'null'
-          default: medium
         filters:
           anyOf:
           - $ref: '#/components/schemas/WebSearchFilters'

docs/static/ogx-spec.yaml

@@ -6522,7 +6522,6 @@ components:
             - medium
             - high
           - type: 'null'
-          default: medium
         filters:
           anyOf:
           - $ref: '#/components/schemas/WebSearchFilters'

docs/static/stainless-ogx-spec.yaml

@@ -6969,7 +6969,6 @@ components:
             - medium
             - high
           - type: 'null'
-          default: medium
         filters:
           anyOf:
           - $ref: '#/components/schemas/WebSearchFilters'

src/ogx_api/openai_responses.py

@@ -573,7 +573,7 @@ class OpenAIResponseInputToolWebSearch(BaseModel):
         | Literal["web_search_preview_2025_03_11"]
         | Literal["web_search_2025_08_26"]
     ) = "web_search"
-    search_context_size: Literal["low", "medium", "high"] | None = "medium"
+    search_context_size: Literal["low", "medium", "high"] | None = None
     filters: WebSearchFilters | None = None
     user_location: WebSearchUserLocation | None = None
 

tests/unit/api/test_web_search_models.py

@@ -67,7 +67,7 @@ def test_web_search_tool_filters_none_by_default():
     tool = OpenAIResponseInputToolWebSearch(type="web_search")
     assert tool.filters is None
     assert tool.user_location is None
-    assert tool.search_context_size == "medium"
+    assert tool.search_context_size is None
 
 
 def test_web_search_tool_filters_with_empty_allowed_domains():

tests/unit/providers/responses/builtin/test_openai_responses_tools.py

@@ -98,7 +98,7 @@ async def test_create_openai_response_with_string_input_with_tools(openai_respon
         openai_responses_impl.tool_groups_api.get_tool.assert_called_once_with("web_search")
         openai_responses_impl.tool_runtime_api.invoke_tool.assert_called_once_with(
             tool_name="web_search",
-            kwargs={"query": "What is the capital of Ireland?", "search_context_size": "medium"},
+            kwargs={"query": "What is the capital of Ireland?"},
         )
 
         openai_responses_impl.responses_store.upsert_response_object.assert_called()
@@ -972,7 +972,7 @@ async def test_web_search_with_filters_and_location(openai_responses_impl, mock_
 
 
 async def test_web_search_without_config_passes_only_query(openai_responses_impl, mock_inference_api):
-    """Test that web search without filters/location only passes query + default search_context_size."""
+    """Test that web search without filters/location only passes query."""
     _setup_web_search_mocks(openai_responses_impl, mock_inference_api)
     await openai_responses_impl.create_openai_response(
         input="What is the capital of Ireland?",
@@ -982,6 +982,6 @@ async def test_web_search_without_config_passes_only_query(openai_responses_impl
     )
     call_kwargs = openai_responses_impl.tool_runtime_api.invoke_tool.call_args.kwargs["kwargs"]
     assert call_kwargs["query"] == "What is the capital of Ireland?"
-    assert call_kwargs["search_context_size"] == "medium"
+    assert "search_context_size" not in call_kwargs
     assert "allowed_domains" not in call_kwargs
     assert "user_location" not in call_kwargs