feat: Using provider/model syntax in modelName examples within openapi spec

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 7
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-1705ff86e7ec80d6be2ddbb0e3cbee821f3e95d68fa6a48c790f586e3470e678.yml
-openapi_spec_hash: cf0d4dad078a7f7c1256b437e349b911
-config_hash: 3c21550e2c94cad4339d3093d794beb0
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-119383e808f394a7676e901bac8b97b6d7402d187d03452fd8d62b31d4085580.yml
+openapi_spec_hash: 8a8d7be19d95f849098690863fe9a71a
+config_hash: 1f709f8775e13029dc60064ef3a94355

src/stagehand/types/model_config_param.py

@@ -12,7 +12,7 @@
 
 class ModelConfigObject(TypedDict, total=False):
     model_name: Required[Annotated[str, PropertyInfo(alias="modelName")]]
-    """Model name string without prefix (e.g., 'gpt-5-nano', 'claude-4.5-opus')"""
+    """Model name string (e.g., 'openai/gpt-5-nano', 'anthropic/claude-4.5-opus')"""
 
     api_key: Annotated[str, PropertyInfo(alias="apiKey")]
     """API key for the model provider"""

tests/api_resources/test_sessions.py

@@ -691,15 +691,15 @@ def test_path_params_observe_overload_2(self, client: Stagehand) -> None:
     @parametrize
     def test_method_start(self, client: Stagehand) -> None:
         session = client.sessions.start(
-            model_name="gpt-4o",
+            model_name="openai/gpt-4o",
         )
         assert_matches_type(SessionStartResponse, session, path=["response"])
 
     @pytest.mark.skip(reason="Prism tests are disabled")
     @parametrize
     def test_method_start_with_all_params(self, client: Stagehand) -> None:
         session = client.sessions.start(
-            model_name="gpt-4o",
+            model_name="openai/gpt-4o",
             act_timeout_ms=0,
             browser={
                 "cdp_url": "ws://localhost:9222",
@@ -787,7 +787,7 @@ def test_method_start_with_all_params(self, client: Stagehand) -> None:
     @parametrize
     def test_raw_response_start(self, client: Stagehand) -> None:
         response = client.sessions.with_raw_response.start(
-            model_name="gpt-4o",
+            model_name="openai/gpt-4o",
         )
 
         assert response.is_closed is True
@@ -799,7 +799,7 @@ def test_raw_response_start(self, client: Stagehand) -> None:
     @parametrize
     def test_streaming_response_start(self, client: Stagehand) -> None:
         with client.sessions.with_streaming_response.start(
-            model_name="gpt-4o",
+            model_name="openai/gpt-4o",
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -1480,15 +1480,15 @@ async def test_path_params_observe_overload_2(self, async_client: AsyncStagehand
     @parametrize
     async def test_method_start(self, async_client: AsyncStagehand) -> None:
         session = await async_client.sessions.start(
-            model_name="gpt-4o",
+            model_name="openai/gpt-4o",
         )
         assert_matches_type(SessionStartResponse, session, path=["response"])
 
     @pytest.mark.skip(reason="Prism tests are disabled")
     @parametrize
     async def test_method_start_with_all_params(self, async_client: AsyncStagehand) -> None:
         session = await async_client.sessions.start(
-            model_name="gpt-4o",
+            model_name="openai/gpt-4o",
             act_timeout_ms=0,
             browser={
                 "cdp_url": "ws://localhost:9222",
@@ -1576,7 +1576,7 @@ async def test_method_start_with_all_params(self, async_client: AsyncStagehand)
     @parametrize
     async def test_raw_response_start(self, async_client: AsyncStagehand) -> None:
         response = await async_client.sessions.with_raw_response.start(
-            model_name="gpt-4o",
+            model_name="openai/gpt-4o",
         )
 
         assert response.is_closed is True
@@ -1588,7 +1588,7 @@ async def test_raw_response_start(self, async_client: AsyncStagehand) -> None:
     @parametrize
     async def test_streaming_response_start(self, async_client: AsyncStagehand) -> None:
         async with async_client.sessions.with_streaming_response.start(
-            model_name="gpt-4o",
+            model_name="openai/gpt-4o",
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"

tests/test_client.py

@@ -891,7 +891,7 @@ def test_retrying_timeout_errors_doesnt_leak(self, respx_mock: MockRouter, clien
         respx_mock.post("/v1/sessions/start").mock(side_effect=httpx.TimeoutException("Test timeout error"))
 
         with pytest.raises(APITimeoutError):
-            client.sessions.with_streaming_response.start(model_name="gpt-4o").__enter__()
+            client.sessions.with_streaming_response.start(model_name="openai/gpt-4o").__enter__()
 
         assert _get_open_connections(client) == 0
 
@@ -901,7 +901,7 @@ def test_retrying_status_errors_doesnt_leak(self, respx_mock: MockRouter, client
         respx_mock.post("/v1/sessions/start").mock(return_value=httpx.Response(500))
 
         with pytest.raises(APIStatusError):
-            client.sessions.with_streaming_response.start(model_name="gpt-4o").__enter__()
+            client.sessions.with_streaming_response.start(model_name="openai/gpt-4o").__enter__()
         assert _get_open_connections(client) == 0
 
     @pytest.mark.parametrize("failures_before_success", [0, 2, 4])
@@ -930,7 +930,7 @@ def retry_handler(_request: httpx.Request) -> httpx.Response:
 
         respx_mock.post("/v1/sessions/start").mock(side_effect=retry_handler)
 
-        response = client.sessions.with_raw_response.start(model_name="gpt-4o")
+        response = client.sessions.with_raw_response.start(model_name="openai/gpt-4o")
 
         assert response.retries_taken == failures_before_success
         assert int(response.http_request.headers.get("x-stainless-retry-count")) == failures_before_success
@@ -955,7 +955,7 @@ def retry_handler(_request: httpx.Request) -> httpx.Response:
         respx_mock.post("/v1/sessions/start").mock(side_effect=retry_handler)
 
         response = client.sessions.with_raw_response.start(
-            model_name="gpt-4o", extra_headers={"x-stainless-retry-count": Omit()}
+            model_name="openai/gpt-4o", extra_headers={"x-stainless-retry-count": Omit()}
         )
 
         assert len(response.http_request.headers.get_list("x-stainless-retry-count")) == 0
@@ -980,7 +980,7 @@ def retry_handler(_request: httpx.Request) -> httpx.Response:
         respx_mock.post("/v1/sessions/start").mock(side_effect=retry_handler)
 
         response = client.sessions.with_raw_response.start(
-            model_name="gpt-4o", extra_headers={"x-stainless-retry-count": "42"}
+            model_name="openai/gpt-4o", extra_headers={"x-stainless-retry-count": "42"}
         )
 
         assert response.http_request.headers.get("x-stainless-retry-count") == "42"
@@ -1870,7 +1870,7 @@ async def test_retrying_timeout_errors_doesnt_leak(
         respx_mock.post("/v1/sessions/start").mock(side_effect=httpx.TimeoutException("Test timeout error"))
 
         with pytest.raises(APITimeoutError):
-            await async_client.sessions.with_streaming_response.start(model_name="gpt-4o").__aenter__()
+            await async_client.sessions.with_streaming_response.start(model_name="openai/gpt-4o").__aenter__()
 
         assert _get_open_connections(async_client) == 0
 
@@ -1882,7 +1882,7 @@ async def test_retrying_status_errors_doesnt_leak(
         respx_mock.post("/v1/sessions/start").mock(return_value=httpx.Response(500))
 
         with pytest.raises(APIStatusError):
-            await async_client.sessions.with_streaming_response.start(model_name="gpt-4o").__aenter__()
+            await async_client.sessions.with_streaming_response.start(model_name="openai/gpt-4o").__aenter__()
         assert _get_open_connections(async_client) == 0
 
     @pytest.mark.parametrize("failures_before_success", [0, 2, 4])
@@ -1911,7 +1911,7 @@ def retry_handler(_request: httpx.Request) -> httpx.Response:
 
         respx_mock.post("/v1/sessions/start").mock(side_effect=retry_handler)
 
-        response = await client.sessions.with_raw_response.start(model_name="gpt-4o")
+        response = await client.sessions.with_raw_response.start(model_name="openai/gpt-4o")
 
         assert response.retries_taken == failures_before_success
         assert int(response.http_request.headers.get("x-stainless-retry-count")) == failures_before_success
@@ -1936,7 +1936,7 @@ def retry_handler(_request: httpx.Request) -> httpx.Response:
         respx_mock.post("/v1/sessions/start").mock(side_effect=retry_handler)
 
         response = await client.sessions.with_raw_response.start(
-            model_name="gpt-4o", extra_headers={"x-stainless-retry-count": Omit()}
+            model_name="openai/gpt-4o", extra_headers={"x-stainless-retry-count": Omit()}
         )
 
         assert len(response.http_request.headers.get_list("x-stainless-retry-count")) == 0
@@ -1961,7 +1961,7 @@ def retry_handler(_request: httpx.Request) -> httpx.Response:
         respx_mock.post("/v1/sessions/start").mock(side_effect=retry_handler)
 
         response = await client.sessions.with_raw_response.start(
-            model_name="gpt-4o", extra_headers={"x-stainless-retry-count": "42"}
+            model_name="openai/gpt-4o", extra_headers={"x-stainless-retry-count": "42"}
         )
 
         assert response.http_request.headers.get("x-stainless-retry-count") == "42"