feat(api): update via SDK Studio

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 7
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-39aa058a60035c34a636e7f580b4b9c76b05400ae401ef04a761572b20a5425b.yml
-openapi_spec_hash: bb79a204f9edb6b6ccfe783a0a82a423
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-2813f659cb4e9e81cd3d9c94df748fd6c54f966fd6fd4881da369394aa981ace.yml
+openapi_spec_hash: facb760f50156c700b5c016087a70d64
 config_hash: 3eb1ed1dd0067258984b31d53a0dab48

README.md

@@ -87,6 +87,22 @@ Nested request parameters are [TypedDicts](https://docs.python.org/3/library/typ
 
 Typed requests and responses provide autocomplete and documentation within your editor. If you would like to see type errors in VS Code to help catch bugs earlier, set `python.analysis.typeCheckingMode` to `basic`.
 
+## Nested params
+
+Nested parameters are dictionaries, typed using `TypedDict`, for example:
+
+```python
+from kernel import Kernel
+
+client = Kernel()
+
+browser = client.browsers.create(
+    invocation_id="ckqwer3o20000jb9s7abcdef",
+    persistence={"id": "my-shared-browser"},
+)
+print(browser.persistence)
+```
+
 ## File uploads
 
 Request parameters that correspond to file uploads can be passed as `bytes`, or a [`PathLike`](https://docs.python.org/3/library/os.html#os.PathLike) instance or a tuple of `(filename, contents, media type)`.

src/kernel/resources/browsers.py

@@ -46,6 +46,7 @@ def create(
         self,
         *,
         invocation_id: str,
+        persistence: browser_create_params.Persistence | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -59,6 +60,8 @@ def create(
         Args:
           invocation_id: action invocation ID
 
+          persistence: Optional persistence configuration for the browser session.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -69,7 +72,13 @@ def create(
         """
         return self._post(
             "/browsers",
-            body=maybe_transform({"invocation_id": invocation_id}, browser_create_params.BrowserCreateParams),
+            body=maybe_transform(
+                {
+                    "invocation_id": invocation_id,
+                    "persistence": persistence,
+                },
+                browser_create_params.BrowserCreateParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -134,6 +143,7 @@ async def create(
         self,
         *,
         invocation_id: str,
+        persistence: browser_create_params.Persistence | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -147,6 +157,8 @@ async def create(
         Args:
           invocation_id: action invocation ID
 
+          persistence: Optional persistence configuration for the browser session.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -158,7 +170,11 @@ async def create(
         return await self._post(
             "/browsers",
             body=await async_maybe_transform(
-                {"invocation_id": invocation_id}, browser_create_params.BrowserCreateParams
+                {
+                    "invocation_id": invocation_id,
+                    "persistence": persistence,
+                },
+                browser_create_params.BrowserCreateParams,
             ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout

src/kernel/types/browser_create_params.py

@@ -4,9 +4,17 @@
 
 from typing_extensions import Required, TypedDict
 
-__all__ = ["BrowserCreateParams"]
+__all__ = ["BrowserCreateParams", "Persistence"]
 
 
 class BrowserCreateParams(TypedDict, total=False):
     invocation_id: Required[str]
     """action invocation ID"""
+
+    persistence: Persistence
+    """Optional persistence configuration for the browser session."""
+
+
+class Persistence(TypedDict, total=False):
+    id: Required[str]
+    """Unique identifier for the persistent browser session."""

src/kernel/types/browser_create_response.py

@@ -1,8 +1,15 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+from typing import Optional
+
 from .._models import BaseModel
 
-__all__ = ["BrowserCreateResponse"]
+__all__ = ["BrowserCreateResponse", "Persistence"]
+
+
+class Persistence(BaseModel):
+    id: str
+    """Unique identifier for the persistent browser session."""
 
 
 class BrowserCreateResponse(BaseModel):
@@ -14,3 +21,6 @@ class BrowserCreateResponse(BaseModel):
 
     session_id: str
     """Unique identifier for the browser session"""
+
+    persistence: Optional[Persistence] = None
+    """Optional persistence configuration for the browser session."""

src/kernel/types/browser_retrieve_response.py

@@ -1,8 +1,15 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+from typing import Optional
+
 from .._models import BaseModel
 
-__all__ = ["BrowserRetrieveResponse"]
+__all__ = ["BrowserRetrieveResponse", "Persistence"]
+
+
+class Persistence(BaseModel):
+    id: str
+    """Unique identifier for the persistent browser session."""
 
 
 class BrowserRetrieveResponse(BaseModel):
@@ -14,3 +21,6 @@ class BrowserRetrieveResponse(BaseModel):
 
     session_id: str
     """Unique identifier for the browser session"""
+
+    persistence: Optional[Persistence] = None
+    """Optional persistence configuration for the browser session."""

tests/api_resources/test_browsers.py

@@ -25,6 +25,15 @@ def test_method_create(self, client: Kernel) -> None:
         )
         assert_matches_type(BrowserCreateResponse, browser, path=["response"])
 
+    @pytest.mark.skip()
+    @parametrize
+    def test_method_create_with_all_params(self, client: Kernel) -> None:
+        browser = client.browsers.create(
+            invocation_id="ckqwer3o20000jb9s7abcdef",
+            persistence={"id": "my-shared-browser"},
+        )
+        assert_matches_type(BrowserCreateResponse, browser, path=["response"])
+
     @pytest.mark.skip()
     @parametrize
     def test_raw_response_create(self, client: Kernel) -> None:
@@ -105,6 +114,15 @@ async def test_method_create(self, async_client: AsyncKernel) -> None:
         )
         assert_matches_type(BrowserCreateResponse, browser, path=["response"])
 
+    @pytest.mark.skip()
+    @parametrize
+    async def test_method_create_with_all_params(self, async_client: AsyncKernel) -> None:
+        browser = await async_client.browsers.create(
+            invocation_id="ckqwer3o20000jb9s7abcdef",
+            persistence={"id": "my-shared-browser"},
+        )
+        assert_matches_type(BrowserCreateResponse, browser, path=["response"])
+
     @pytest.mark.skip()
     @parametrize
     async def test_raw_response_create(self, async_client: AsyncKernel) -> None: