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-2813f659cb4e9e81cd3d9c94df748fd6c54f966fd6fd4881da369394aa981ace.yml
-openapi_spec_hash: facb760f50156c700b5c016087a70d64
-config_hash: 3eb1ed1dd0067258984b31d53a0dab48
+configured_endpoints: 10
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-ffefc234d11c041cadab66fa6e7c379cebbd9422d38f2b1b1019e425ae19bbd8.yml
+openapi_spec_hash: aa04a371ff95b44847450d657ad0a920
+config_hash: f33cc77a9c01e879ad127194c897a988

api.md

@@ -41,10 +41,18 @@ Methods:
 Types:
 
 ```python
-from kernel.types import BrowserCreateResponse, BrowserRetrieveResponse
+from kernel.types import (
+    BrowserPersistence,
+    BrowserCreateResponse,
+    BrowserRetrieveResponse,
+    BrowserListResponse,
+)
 ```
 
 Methods:
 
 - <code title="post /browsers">client.browsers.<a href="./src/kernel/resources/browsers.py">create</a>(\*\*<a href="src/kernel/types/browser_create_params.py">params</a>) -> <a href="./src/kernel/types/browser_create_response.py">BrowserCreateResponse</a></code>
 - <code title="get /browsers/{id}">client.browsers.<a href="./src/kernel/resources/browsers.py">retrieve</a>(id) -> <a href="./src/kernel/types/browser_retrieve_response.py">BrowserRetrieveResponse</a></code>
+- <code title="get /browsers">client.browsers.<a href="./src/kernel/resources/browsers.py">list</a>() -> <a href="./src/kernel/types/browser_list_response.py">BrowserListResponse</a></code>
+- <code title="delete /browsers">client.browsers.<a href="./src/kernel/resources/browsers.py">delete</a>(\*\*<a href="src/kernel/types/browser_delete_params.py">params</a>) -> None</code>
+- <code title="delete /browsers/{id}">client.browsers.<a href="./src/kernel/resources/browsers.py">delete_by_id</a>(id) -> None</code>

src/kernel/resources/browsers.py

@@ -4,8 +4,8 @@
 
 import httpx
 
-from ..types import browser_create_params
-from .._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from ..types import browser_create_params, browser_delete_params
+from .._types import NOT_GIVEN, Body, Query, Headers, NoneType, NotGiven
 from .._utils import maybe_transform, async_maybe_transform
 from .._compat import cached_property
 from .._resource import SyncAPIResource, AsyncAPIResource
@@ -16,7 +16,9 @@
     async_to_streamed_response_wrapper,
 )
 from .._base_client import make_request_options
+from ..types.browser_list_response import BrowserListResponse
 from ..types.browser_create_response import BrowserCreateResponse
+from ..types.browser_persistence_param import BrowserPersistenceParam
 from ..types.browser_retrieve_response import BrowserRetrieveResponse
 
 __all__ = ["BrowsersResource", "AsyncBrowsersResource"]
@@ -46,7 +48,7 @@ def create(
         self,
         *,
         invocation_id: str,
-        persistence: browser_create_params.Persistence | NotGiven = NOT_GIVEN,
+        persistence: BrowserPersistenceParam | 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,
@@ -118,6 +120,97 @@ def retrieve(
             cast_to=BrowserRetrieveResponse,
         )
 
+    def list(
+        self,
+        *,
+        # 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> BrowserListResponse:
+        """List active browser sessions for the authenticated user"""
+        return self._get(
+            "/browsers",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=BrowserListResponse,
+        )
+
+    def delete(
+        self,
+        *,
+        persistent_id: str,
+        # 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """
+        Delete a persistent browser session by persistent_id query parameter.
+
+        Args:
+          persistent_id: Persistent browser identifier
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        return self._delete(
+            "/browsers",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform({"persistent_id": persistent_id}, browser_delete_params.BrowserDeleteParams),
+            ),
+            cast_to=NoneType,
+        )
+
+    def delete_by_id(
+        self,
+        id: str,
+        *,
+        # 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """
+        Delete Browser Session by ID
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        return self._delete(
+            f"/browsers/{id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
 
 class AsyncBrowsersResource(AsyncAPIResource):
     @cached_property
@@ -143,7 +236,7 @@ async def create(
         self,
         *,
         invocation_id: str,
-        persistence: browser_create_params.Persistence | NotGiven = NOT_GIVEN,
+        persistence: BrowserPersistenceParam | 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,
@@ -215,6 +308,99 @@ async def retrieve(
             cast_to=BrowserRetrieveResponse,
         )
 
+    async def list(
+        self,
+        *,
+        # 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> BrowserListResponse:
+        """List active browser sessions for the authenticated user"""
+        return await self._get(
+            "/browsers",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=BrowserListResponse,
+        )
+
+    async def delete(
+        self,
+        *,
+        persistent_id: str,
+        # 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """
+        Delete a persistent browser session by persistent_id query parameter.
+
+        Args:
+          persistent_id: Persistent browser identifier
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        return await self._delete(
+            "/browsers",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform(
+                    {"persistent_id": persistent_id}, browser_delete_params.BrowserDeleteParams
+                ),
+            ),
+            cast_to=NoneType,
+        )
+
+    async def delete_by_id(
+        self,
+        id: str,
+        *,
+        # 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """
+        Delete Browser Session by ID
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        return await self._delete(
+            f"/browsers/{id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
 
 class BrowsersResourceWithRawResponse:
     def __init__(self, browsers: BrowsersResource) -> None:
@@ -226,6 +412,15 @@ def __init__(self, browsers: BrowsersResource) -> None:
         self.retrieve = to_raw_response_wrapper(
             browsers.retrieve,
         )
+        self.list = to_raw_response_wrapper(
+            browsers.list,
+        )
+        self.delete = to_raw_response_wrapper(
+            browsers.delete,
+        )
+        self.delete_by_id = to_raw_response_wrapper(
+            browsers.delete_by_id,
+        )
 
 
 class AsyncBrowsersResourceWithRawResponse:
@@ -238,6 +433,15 @@ def __init__(self, browsers: AsyncBrowsersResource) -> None:
         self.retrieve = async_to_raw_response_wrapper(
             browsers.retrieve,
         )
+        self.list = async_to_raw_response_wrapper(
+            browsers.list,
+        )
+        self.delete = async_to_raw_response_wrapper(
+            browsers.delete,
+        )
+        self.delete_by_id = async_to_raw_response_wrapper(
+            browsers.delete_by_id,
+        )
 
 
 class BrowsersResourceWithStreamingResponse:
@@ -250,6 +454,15 @@ def __init__(self, browsers: BrowsersResource) -> None:
         self.retrieve = to_streamed_response_wrapper(
             browsers.retrieve,
         )
+        self.list = to_streamed_response_wrapper(
+            browsers.list,
+        )
+        self.delete = to_streamed_response_wrapper(
+            browsers.delete,
+        )
+        self.delete_by_id = to_streamed_response_wrapper(
+            browsers.delete_by_id,
+        )
 
 
 class AsyncBrowsersResourceWithStreamingResponse:
@@ -262,3 +475,12 @@ def __init__(self, browsers: AsyncBrowsersResource) -> None:
         self.retrieve = async_to_streamed_response_wrapper(
             browsers.retrieve,
         )
+        self.list = async_to_streamed_response_wrapper(
+            browsers.list,
+        )
+        self.delete = async_to_streamed_response_wrapper(
+            browsers.delete,
+        )
+        self.delete_by_id = async_to_streamed_response_wrapper(
+            browsers.delete_by_id,
+        )

src/kernel/types/__init__.py

@@ -4,6 +4,10 @@
 
 from .app_list_params import AppListParams as AppListParams
 from .app_list_response import AppListResponse as AppListResponse
+from .browser_persistence import BrowserPersistence as BrowserPersistence
 from .browser_create_params import BrowserCreateParams as BrowserCreateParams
+from .browser_delete_params import BrowserDeleteParams as BrowserDeleteParams
+from .browser_list_response import BrowserListResponse as BrowserListResponse
 from .browser_create_response import BrowserCreateResponse as BrowserCreateResponse
+from .browser_persistence_param import BrowserPersistenceParam as BrowserPersistenceParam
 from .browser_retrieve_response import BrowserRetrieveResponse as BrowserRetrieveResponse

src/kernel/types/browser_create_params.py

@@ -4,17 +4,14 @@
 
 from typing_extensions import Required, TypedDict
 
-__all__ = ["BrowserCreateParams", "Persistence"]
+from .browser_persistence_param import BrowserPersistenceParam
+
+__all__ = ["BrowserCreateParams"]
 
 
 class BrowserCreateParams(TypedDict, total=False):
     invocation_id: Required[str]
     """action invocation ID"""
 
-    persistence: Persistence
+    persistence: BrowserPersistenceParam
     """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

@@ -3,13 +3,9 @@
 from typing import Optional
 
 from .._models import BaseModel
+from .browser_persistence import BrowserPersistence
 
-__all__ = ["BrowserCreateResponse", "Persistence"]
-
-
-class Persistence(BaseModel):
-    id: str
-    """Unique identifier for the persistent browser session."""
+__all__ = ["BrowserCreateResponse"]
 
 
 class BrowserCreateResponse(BaseModel):
@@ -22,5 +18,5 @@ class BrowserCreateResponse(BaseModel):
     session_id: str
     """Unique identifier for the browser session"""
 
-    persistence: Optional[Persistence] = None
+    persistence: Optional[BrowserPersistence] = None
     """Optional persistence configuration for the browser session."""

src/kernel/types/browser_delete_params.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+__all__ = ["BrowserDeleteParams"]
+
+
+class BrowserDeleteParams(TypedDict, total=False):
+    persistent_id: Required[str]
+    """Persistent browser identifier"""