feat(api): /browsers no longer requires invocation id

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 16
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-2aec229ccf91f7c1ac95aa675ea2a59bd61af9e363a22c3b49677992f1eeb16a.yml
-openapi_spec_hash: c80cd5d52a79cd5366a76d4a825bd27a
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-ff8ccba8b5409eaa1128df9027582cb63f66e8accd75e511f70b7c27ef26c9ae.yml
+openapi_spec_hash: 1dbacc339695a7c78718f90f791d3f01
 config_hash: b8e1fff080fbaa22656ab0a57b591777

README.md

@@ -134,7 +134,6 @@ from kernel import Kernel
 client = Kernel()
 
 browser = client.browsers.create(
-    invocation_id="rr33xuugxj9h0bkf1rdt2bet",
     persistence={"id": "my-awesome-browser-for-user-1234"},
 )
 print(browser.persistence)

src/kernel/resources/browsers.py

@@ -47,7 +47,7 @@ def with_streaming_response(self) -> BrowsersResourceWithStreamingResponse:
     def create(
         self,
         *,
-        invocation_id: str,
+        invocation_id: str | NotGiven = NOT_GIVEN,
         persistence: BrowserPersistenceParam | NotGiven = NOT_GIVEN,
         stealth: bool | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -240,7 +240,7 @@ def with_streaming_response(self) -> AsyncBrowsersResourceWithStreamingResponse:
     async def create(
         self,
         *,
-        invocation_id: str,
+        invocation_id: str | NotGiven = NOT_GIVEN,
         persistence: BrowserPersistenceParam | NotGiven = NOT_GIVEN,
         stealth: bool | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.

src/kernel/types/browser_create_params.py

@@ -2,15 +2,15 @@
 
 from __future__ import annotations
 
-from typing_extensions import Required, TypedDict
+from typing_extensions import TypedDict
 
 from .browser_persistence_param import BrowserPersistenceParam
 
 __all__ = ["BrowserCreateParams"]
 
 
 class BrowserCreateParams(TypedDict, total=False):
-    invocation_id: Required[str]
+    invocation_id: str
     """action invocation ID"""
 
     persistence: BrowserPersistenceParam

tests/api_resources/test_browsers.py

@@ -24,9 +24,7 @@ class TestBrowsers:
     @pytest.mark.skip()
     @parametrize
     def test_method_create(self, client: Kernel) -> None:
-        browser = client.browsers.create(
-            invocation_id="rr33xuugxj9h0bkf1rdt2bet",
-        )
+        browser = client.browsers.create()
         assert_matches_type(BrowserCreateResponse, browser, path=["response"])
 
     @pytest.mark.skip()
@@ -42,9 +40,7 @@ def test_method_create_with_all_params(self, client: Kernel) -> None:
     @pytest.mark.skip()
     @parametrize
     def test_raw_response_create(self, client: Kernel) -> None:
-        response = client.browsers.with_raw_response.create(
-            invocation_id="rr33xuugxj9h0bkf1rdt2bet",
-        )
+        response = client.browsers.with_raw_response.create()
 
         assert response.is_closed is True
         assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -54,9 +50,7 @@ def test_raw_response_create(self, client: Kernel) -> None:
     @pytest.mark.skip()
     @parametrize
     def test_streaming_response_create(self, client: Kernel) -> None:
-        with client.browsers.with_streaming_response.create(
-            invocation_id="rr33xuugxj9h0bkf1rdt2bet",
-        ) as response:
+        with client.browsers.with_streaming_response.create() as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
 
@@ -220,9 +214,7 @@ class TestAsyncBrowsers:
     @pytest.mark.skip()
     @parametrize
     async def test_method_create(self, async_client: AsyncKernel) -> None:
-        browser = await async_client.browsers.create(
-            invocation_id="rr33xuugxj9h0bkf1rdt2bet",
-        )
+        browser = await async_client.browsers.create()
         assert_matches_type(BrowserCreateResponse, browser, path=["response"])
 
     @pytest.mark.skip()
@@ -238,9 +230,7 @@ async def test_method_create_with_all_params(self, async_client: AsyncKernel) ->
     @pytest.mark.skip()
     @parametrize
     async def test_raw_response_create(self, async_client: AsyncKernel) -> None:
-        response = await async_client.browsers.with_raw_response.create(
-            invocation_id="rr33xuugxj9h0bkf1rdt2bet",
-        )
+        response = await async_client.browsers.with_raw_response.create()
 
         assert response.is_closed is True
         assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -250,9 +240,7 @@ async def test_raw_response_create(self, async_client: AsyncKernel) -> None:
     @pytest.mark.skip()
     @parametrize
     async def test_streaming_response_create(self, async_client: AsyncKernel) -> None:
-        async with async_client.browsers.with_streaming_response.create(
-            invocation_id="rr33xuugxj9h0bkf1rdt2bet",
-        ) as response:
+        async with async_client.browsers.with_streaming_response.create() as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
 

tests/test_client.py

@@ -724,7 +724,7 @@ def test_retrying_timeout_errors_doesnt_leak(self, respx_mock: MockRouter, clien
         respx_mock.post("/browsers").mock(side_effect=httpx.TimeoutException("Test timeout error"))
 
         with pytest.raises(APITimeoutError):
-            client.browsers.with_streaming_response.create(invocation_id="rr33xuugxj9h0bkf1rdt2bet").__enter__()
+            client.browsers.with_streaming_response.create().__enter__()
 
         assert _get_open_connections(self.client) == 0
 
@@ -735,7 +735,7 @@ def test_retrying_status_errors_doesnt_leak(self, respx_mock: MockRouter, client
         respx_mock.post("/browsers").mock(return_value=httpx.Response(500))
 
         with pytest.raises(APIStatusError):
-            client.browsers.with_streaming_response.create(invocation_id="rr33xuugxj9h0bkf1rdt2bet").__enter__()
+            client.browsers.with_streaming_response.create().__enter__()
         assert _get_open_connections(self.client) == 0
 
     @pytest.mark.parametrize("failures_before_success", [0, 2, 4])
@@ -764,7 +764,7 @@ def retry_handler(_request: httpx.Request) -> httpx.Response:
 
         respx_mock.post("/browsers").mock(side_effect=retry_handler)
 
-        response = client.browsers.with_raw_response.create(invocation_id="rr33xuugxj9h0bkf1rdt2bet")
+        response = client.browsers.with_raw_response.create()
 
         assert response.retries_taken == failures_before_success
         assert int(response.http_request.headers.get("x-stainless-retry-count")) == failures_before_success
@@ -788,9 +788,7 @@ def retry_handler(_request: httpx.Request) -> httpx.Response:
 
         respx_mock.post("/browsers").mock(side_effect=retry_handler)
 
-        response = client.browsers.with_raw_response.create(
-            invocation_id="rr33xuugxj9h0bkf1rdt2bet", extra_headers={"x-stainless-retry-count": Omit()}
-        )
+        response = client.browsers.with_raw_response.create(extra_headers={"x-stainless-retry-count": Omit()})
 
         assert len(response.http_request.headers.get_list("x-stainless-retry-count")) == 0
 
@@ -813,9 +811,7 @@ def retry_handler(_request: httpx.Request) -> httpx.Response:
 
         respx_mock.post("/browsers").mock(side_effect=retry_handler)
 
-        response = client.browsers.with_raw_response.create(
-            invocation_id="rr33xuugxj9h0bkf1rdt2bet", extra_headers={"x-stainless-retry-count": "42"}
-        )
+        response = client.browsers.with_raw_response.create(extra_headers={"x-stainless-retry-count": "42"})
 
         assert response.http_request.headers.get("x-stainless-retry-count") == "42"
 
@@ -1555,9 +1551,7 @@ async def test_retrying_timeout_errors_doesnt_leak(self, respx_mock: MockRouter,
         respx_mock.post("/browsers").mock(side_effect=httpx.TimeoutException("Test timeout error"))
 
         with pytest.raises(APITimeoutError):
-            await async_client.browsers.with_streaming_response.create(
-                invocation_id="rr33xuugxj9h0bkf1rdt2bet"
-            ).__aenter__()
+            await async_client.browsers.with_streaming_response.create().__aenter__()
 
         assert _get_open_connections(self.client) == 0
 
@@ -1568,9 +1562,7 @@ async def test_retrying_status_errors_doesnt_leak(self, respx_mock: MockRouter,
         respx_mock.post("/browsers").mock(return_value=httpx.Response(500))
 
         with pytest.raises(APIStatusError):
-            await async_client.browsers.with_streaming_response.create(
-                invocation_id="rr33xuugxj9h0bkf1rdt2bet"
-            ).__aenter__()
+            await async_client.browsers.with_streaming_response.create().__aenter__()
         assert _get_open_connections(self.client) == 0
 
     @pytest.mark.parametrize("failures_before_success", [0, 2, 4])
@@ -1600,7 +1592,7 @@ def retry_handler(_request: httpx.Request) -> httpx.Response:
 
         respx_mock.post("/browsers").mock(side_effect=retry_handler)
 
-        response = await client.browsers.with_raw_response.create(invocation_id="rr33xuugxj9h0bkf1rdt2bet")
+        response = await client.browsers.with_raw_response.create()
 
         assert response.retries_taken == failures_before_success
         assert int(response.http_request.headers.get("x-stainless-retry-count")) == failures_before_success
@@ -1625,9 +1617,7 @@ def retry_handler(_request: httpx.Request) -> httpx.Response:
 
         respx_mock.post("/browsers").mock(side_effect=retry_handler)
 
-        response = await client.browsers.with_raw_response.create(
-            invocation_id="rr33xuugxj9h0bkf1rdt2bet", extra_headers={"x-stainless-retry-count": Omit()}
-        )
+        response = await client.browsers.with_raw_response.create(extra_headers={"x-stainless-retry-count": Omit()})
 
         assert len(response.http_request.headers.get_list("x-stainless-retry-count")) == 0
 
@@ -1651,9 +1641,7 @@ def retry_handler(_request: httpx.Request) -> httpx.Response:
 
         respx_mock.post("/browsers").mock(side_effect=retry_handler)
 
-        response = await client.browsers.with_raw_response.create(
-            invocation_id="rr33xuugxj9h0bkf1rdt2bet", extra_headers={"x-stainless-retry-count": "42"}
-        )
+        response = await client.browsers.with_raw_response.create(extra_headers={"x-stainless-retry-count": "42"})
 
         assert response.http_request.headers.get("x-stainless-retry-count") == "42"