feat(api): manual updates

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-349e1b0f6291eedd731c1660155a50adcb3424fb8cd9e17bbdc0939ff3bbffcd.yml
-openapi_spec_hash: 456b593ea71d72bc31a6338a25363e9f
-config_hash: 5f6b5ec6e84fb01932ba87c6a9623d9b
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-e6a9dca1a93568e403ac72128d86f30c8c3f1336d4b67017d7e61b1836f10f47.yml
+openapi_spec_hash: ef01e0649bb0e283df0aa81c369649df
+config_hash: abc9d1eb9779bb5629eaed7074c42809

README.md

@@ -43,7 +43,7 @@ client = Stagehand(
 
 response = client.sessions.act(
     id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123",
-    input="Click the login button",
+    input="click the first link on the page",
 )
 print(response.data)
 ```
@@ -76,7 +76,7 @@ client = AsyncStagehand(
 async def main() -> None:
     response = await client.sessions.act(
         id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123",
-        input="Click the login button",
+        input="click the first link on the page",
     )
     print(response.data)
 
@@ -119,7 +119,7 @@ async def main() -> None:
     ) as client:
         response = await client.sessions.act(
             id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123",
-            input="Click the login button",
+            input="click the first link on the page",
         )
         print(response.data)
 
@@ -169,9 +169,8 @@ from stagehand import Stagehand
 client = Stagehand()
 
 try:
-    client.sessions.act(
-        id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123",
-        input="Click the login button",
+    client.sessions.start(
+        model_name="gpt-4o",
     )
 except stagehand.APIConnectionError as e:
     print("The server could not be reached")
@@ -215,9 +214,8 @@ client = Stagehand(
 )
 
 # Or, configure per-request:
-client.with_options(max_retries=5).sessions.act(
-    id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123",
-    input="Click the login button",
+client.with_options(max_retries=5).sessions.start(
+    model_name="gpt-4o",
 )
 ```
 
@@ -241,9 +239,8 @@ client = Stagehand(
 )
 
 # Override per-request:
-client.with_options(timeout=5.0).sessions.act(
-    id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123",
-    input="Click the login button",
+client.with_options(timeout=5.0).sessions.start(
+    model_name="gpt-4o",
 )
 ```
 
@@ -285,13 +282,12 @@ The "raw" Response object can be accessed by prefixing `.with_raw_response.` to
 from stagehand import Stagehand
 
 client = Stagehand()
-response = client.sessions.with_raw_response.act(
-    id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123",
-    input="Click the login button",
+response = client.sessions.with_raw_response.start(
+    model_name="gpt-4o",
 )
 print(response.headers.get('X-My-Header'))
 
-session = response.parse()  # get the object that `sessions.act()` would have returned
+session = response.parse()  # get the object that `sessions.start()` would have returned
 print(session.data)
 ```
 
@@ -306,9 +302,8 @@ The above interface eagerly reads the full response body when you make the reque
 To stream the response body, use `.with_streaming_response` instead, which requires a context manager and only reads the response body once you call `.read()`, `.text()`, `.json()`, `.iter_bytes()`, `.iter_text()`, `.iter_lines()` or `.parse()`. In the async client, these are async methods.
 
 ```python
-with client.sessions.with_streaming_response.act(
-    id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123",
-    input="Click the login button",
+with client.sessions.with_streaming_response.start(
+    model_name="gpt-4o",
 ) as response:
     print(response.headers.get("X-My-Header"))
 

tests/test_client.py

@@ -876,26 +876,20 @@ def test_parse_retry_after_header(
     @mock.patch("stagehand._base_client.BaseClient._calculate_retry_timeout", _low_retry_timeout)
     @pytest.mark.respx(base_url=base_url)
     def test_retrying_timeout_errors_doesnt_leak(self, respx_mock: MockRouter, client: Stagehand) -> None:
-        respx_mock.post("/v1/sessions/c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123/act").mock(
-            side_effect=httpx.TimeoutException("Test timeout error")
-        )
+        respx_mock.post("/v1/sessions/start").mock(side_effect=httpx.TimeoutException("Test timeout error"))
 
         with pytest.raises(APITimeoutError):
-            client.sessions.with_streaming_response.act(
-                id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123", input="Click the login button"
-            ).__enter__()
+            client.sessions.with_streaming_response.start(model_name="gpt-4o").__enter__()
 
         assert _get_open_connections(client) == 0
 
     @mock.patch("stagehand._base_client.BaseClient._calculate_retry_timeout", _low_retry_timeout)
     @pytest.mark.respx(base_url=base_url)
     def test_retrying_status_errors_doesnt_leak(self, respx_mock: MockRouter, client: Stagehand) -> None:
-        respx_mock.post("/v1/sessions/c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123/act").mock(return_value=httpx.Response(500))
+        respx_mock.post("/v1/sessions/start").mock(return_value=httpx.Response(500))
 
         with pytest.raises(APIStatusError):
-            client.sessions.with_streaming_response.act(
-                id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123", input="Click the login button"
-            ).__enter__()
+            client.sessions.with_streaming_response.start(model_name="gpt-4o").__enter__()
         assert _get_open_connections(client) == 0
 
     @pytest.mark.parametrize("failures_before_success", [0, 2, 4])
@@ -922,11 +916,9 @@ def retry_handler(_request: httpx.Request) -> httpx.Response:
                 return httpx.Response(500)
             return httpx.Response(200)
 
-        respx_mock.post("/v1/sessions/c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123/act").mock(side_effect=retry_handler)
+        respx_mock.post("/v1/sessions/start").mock(side_effect=retry_handler)
 
-        response = client.sessions.with_raw_response.act(
-            id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123", input="Click the login button"
-        )
+        response = client.sessions.with_raw_response.start(model_name="gpt-4o")
 
         assert response.retries_taken == failures_before_success
         assert int(response.http_request.headers.get("x-stainless-retry-count")) == failures_before_success
@@ -948,12 +940,10 @@ def retry_handler(_request: httpx.Request) -> httpx.Response:
                 return httpx.Response(500)
             return httpx.Response(200)
 
-        respx_mock.post("/v1/sessions/c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123/act").mock(side_effect=retry_handler)
+        respx_mock.post("/v1/sessions/start").mock(side_effect=retry_handler)
 
-        response = client.sessions.with_raw_response.act(
-            id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123",
-            input="Click the login button",
-            extra_headers={"x-stainless-retry-count": Omit()},
+        response = client.sessions.with_raw_response.start(
+            model_name="gpt-4o", extra_headers={"x-stainless-retry-count": Omit()}
         )
 
         assert len(response.http_request.headers.get_list("x-stainless-retry-count")) == 0
@@ -975,12 +965,10 @@ def retry_handler(_request: httpx.Request) -> httpx.Response:
                 return httpx.Response(500)
             return httpx.Response(200)
 
-        respx_mock.post("/v1/sessions/c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123/act").mock(side_effect=retry_handler)
+        respx_mock.post("/v1/sessions/start").mock(side_effect=retry_handler)
 
-        response = client.sessions.with_raw_response.act(
-            id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123",
-            input="Click the login button",
-            extra_headers={"x-stainless-retry-count": "42"},
+        response = client.sessions.with_raw_response.start(
+            model_name="gpt-4o", extra_headers={"x-stainless-retry-count": "42"}
         )
 
         assert response.http_request.headers.get("x-stainless-retry-count") == "42"
@@ -1856,14 +1844,10 @@ async def test_parse_retry_after_header(
     async def test_retrying_timeout_errors_doesnt_leak(
         self, respx_mock: MockRouter, async_client: AsyncStagehand
     ) -> None:
-        respx_mock.post("/v1/sessions/c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123/act").mock(
-            side_effect=httpx.TimeoutException("Test timeout error")
-        )
+        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.act(
-                id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123", input="Click the login button"
-            ).__aenter__()
+            await async_client.sessions.with_streaming_response.start(model_name="gpt-4o").__aenter__()
 
         assert _get_open_connections(async_client) == 0
 
@@ -1872,12 +1856,10 @@ async def test_retrying_timeout_errors_doesnt_leak(
     async def test_retrying_status_errors_doesnt_leak(
         self, respx_mock: MockRouter, async_client: AsyncStagehand
     ) -> None:
-        respx_mock.post("/v1/sessions/c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123/act").mock(return_value=httpx.Response(500))
+        respx_mock.post("/v1/sessions/start").mock(return_value=httpx.Response(500))
 
         with pytest.raises(APIStatusError):
-            await async_client.sessions.with_streaming_response.act(
-                id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123", input="Click the login button"
-            ).__aenter__()
+            await async_client.sessions.with_streaming_response.start(model_name="gpt-4o").__aenter__()
         assert _get_open_connections(async_client) == 0
 
     @pytest.mark.parametrize("failures_before_success", [0, 2, 4])
@@ -1904,11 +1886,9 @@ def retry_handler(_request: httpx.Request) -> httpx.Response:
                 return httpx.Response(500)
             return httpx.Response(200)
 
-        respx_mock.post("/v1/sessions/c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123/act").mock(side_effect=retry_handler)
+        respx_mock.post("/v1/sessions/start").mock(side_effect=retry_handler)
 
-        response = await client.sessions.with_raw_response.act(
-            id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123", input="Click the login button"
-        )
+        response = await client.sessions.with_raw_response.start(model_name="gpt-4o")
 
         assert response.retries_taken == failures_before_success
         assert int(response.http_request.headers.get("x-stainless-retry-count")) == failures_before_success
@@ -1930,12 +1910,10 @@ def retry_handler(_request: httpx.Request) -> httpx.Response:
                 return httpx.Response(500)
             return httpx.Response(200)
 
-        respx_mock.post("/v1/sessions/c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123/act").mock(side_effect=retry_handler)
+        respx_mock.post("/v1/sessions/start").mock(side_effect=retry_handler)
 
-        response = await client.sessions.with_raw_response.act(
-            id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123",
-            input="Click the login button",
-            extra_headers={"x-stainless-retry-count": Omit()},
+        response = await client.sessions.with_raw_response.start(
+            model_name="gpt-4o", extra_headers={"x-stainless-retry-count": Omit()}
         )
 
         assert len(response.http_request.headers.get_list("x-stainless-retry-count")) == 0
@@ -1957,12 +1935,10 @@ def retry_handler(_request: httpx.Request) -> httpx.Response:
                 return httpx.Response(500)
             return httpx.Response(200)
 
-        respx_mock.post("/v1/sessions/c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123/act").mock(side_effect=retry_handler)
+        respx_mock.post("/v1/sessions/start").mock(side_effect=retry_handler)
 
-        response = await client.sessions.with_raw_response.act(
-            id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123",
-            input="Click the login button",
-            extra_headers={"x-stainless-retry-count": "42"},
+        response = await client.sessions.with_raw_response.start(
+            model_name="gpt-4o", extra_headers={"x-stainless-retry-count": "42"}
         )
 
         assert response.http_request.headers.get("x-stainless-retry-count") == "42"