feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 17
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-3ec96d0022acb32aa2676c2e7ae20152b899a776ccd499380c334c955b9ba071.yml
-openapi_spec_hash: b64c095d82185c1cd0355abea88b606f
-config_hash: 00ec9df250b9dc077f8d3b93a442d252
+configured_endpoints: 18
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-d173129101e26f450c200e84430d993479c034700cf826917425d513b88912e6.yml
+openapi_spec_hash: 150b86da7588979d7619b1a894e4720c
+config_hash: eaeed470b1070b34df69c49d68e67355

api.md

@@ -92,3 +92,4 @@ Methods:
 - <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>
+- <code title="get /browsers/{id}/replay">client.browsers.<a href="./src/kernel/resources/browsers.py">retrieve_replay</a>(id) -> BinaryAPIResponse</code>

src/kernel/resources/browsers.py

@@ -10,10 +10,18 @@
 from .._compat import cached_property
 from .._resource import SyncAPIResource, AsyncAPIResource
 from .._response import (
+    BinaryAPIResponse,
+    AsyncBinaryAPIResponse,
+    StreamedBinaryAPIResponse,
+    AsyncStreamedBinaryAPIResponse,
     to_raw_response_wrapper,
     to_streamed_response_wrapper,
     async_to_raw_response_wrapper,
+    to_custom_raw_response_wrapper,
     async_to_streamed_response_wrapper,
+    to_custom_streamed_response_wrapper,
+    async_to_custom_raw_response_wrapper,
+    async_to_custom_streamed_response_wrapper,
 )
 from .._base_client import make_request_options
 from ..types.browser_list_response import BrowserListResponse
@@ -50,6 +58,7 @@ def create(
         headless: bool | NotGiven = NOT_GIVEN,
         invocation_id: str | NotGiven = NOT_GIVEN,
         persistence: BrowserPersistenceParam | NotGiven = NOT_GIVEN,
+        replay: bool | 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.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -69,6 +78,8 @@ def create(
 
           persistence: Optional persistence configuration for the browser session.
 
+          replay: If true, enables replay recording of the browser session. Defaults to false.
+
           stealth: If true, launches the browser in stealth mode to reduce detection by anti-bot
               mechanisms.
 
@@ -87,6 +98,7 @@ def create(
                     "headless": headless,
                     "invocation_id": invocation_id,
                     "persistence": persistence,
+                    "replay": replay,
                     "stealth": stealth,
                 },
                 browser_create_params.BrowserCreateParams,
@@ -221,6 +233,40 @@ def delete_by_id(
             cast_to=NoneType,
         )
 
+    def retrieve_replay(
+        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,
+    ) -> BinaryAPIResponse:
+        """
+        Get browser session replay.
+
+        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": "video/mp4", **(extra_headers or {})}
+        return self._get(
+            f"/browsers/{id}/replay",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=BinaryAPIResponse,
+        )
+
 
 class AsyncBrowsersResource(AsyncAPIResource):
     @cached_property
@@ -248,6 +294,7 @@ async def create(
         headless: bool | NotGiven = NOT_GIVEN,
         invocation_id: str | NotGiven = NOT_GIVEN,
         persistence: BrowserPersistenceParam | NotGiven = NOT_GIVEN,
+        replay: bool | 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.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -267,6 +314,8 @@ async def create(
 
           persistence: Optional persistence configuration for the browser session.
 
+          replay: If true, enables replay recording of the browser session. Defaults to false.
+
           stealth: If true, launches the browser in stealth mode to reduce detection by anti-bot
               mechanisms.
 
@@ -285,6 +334,7 @@ async def create(
                     "headless": headless,
                     "invocation_id": invocation_id,
                     "persistence": persistence,
+                    "replay": replay,
                     "stealth": stealth,
                 },
                 browser_create_params.BrowserCreateParams,
@@ -421,6 +471,40 @@ async def delete_by_id(
             cast_to=NoneType,
         )
 
+    async def retrieve_replay(
+        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,
+    ) -> AsyncBinaryAPIResponse:
+        """
+        Get browser session replay.
+
+        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": "video/mp4", **(extra_headers or {})}
+        return await self._get(
+            f"/browsers/{id}/replay",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=AsyncBinaryAPIResponse,
+        )
+
 
 class BrowsersResourceWithRawResponse:
     def __init__(self, browsers: BrowsersResource) -> None:
@@ -441,6 +525,10 @@ def __init__(self, browsers: BrowsersResource) -> None:
         self.delete_by_id = to_raw_response_wrapper(
             browsers.delete_by_id,
         )
+        self.retrieve_replay = to_custom_raw_response_wrapper(
+            browsers.retrieve_replay,
+            BinaryAPIResponse,
+        )
 
 
 class AsyncBrowsersResourceWithRawResponse:
@@ -462,6 +550,10 @@ def __init__(self, browsers: AsyncBrowsersResource) -> None:
         self.delete_by_id = async_to_raw_response_wrapper(
             browsers.delete_by_id,
         )
+        self.retrieve_replay = async_to_custom_raw_response_wrapper(
+            browsers.retrieve_replay,
+            AsyncBinaryAPIResponse,
+        )
 
 
 class BrowsersResourceWithStreamingResponse:
@@ -483,6 +575,10 @@ def __init__(self, browsers: BrowsersResource) -> None:
         self.delete_by_id = to_streamed_response_wrapper(
             browsers.delete_by_id,
         )
+        self.retrieve_replay = to_custom_streamed_response_wrapper(
+            browsers.retrieve_replay,
+            StreamedBinaryAPIResponse,
+        )
 
 
 class AsyncBrowsersResourceWithStreamingResponse:
@@ -504,3 +600,7 @@ def __init__(self, browsers: AsyncBrowsersResource) -> None:
         self.delete_by_id = async_to_streamed_response_wrapper(
             browsers.delete_by_id,
         )
+        self.retrieve_replay = async_to_custom_streamed_response_wrapper(
+            browsers.retrieve_replay,
+            AsyncStreamedBinaryAPIResponse,
+        )

src/kernel/types/browser_create_params.py

@@ -22,6 +22,9 @@ class BrowserCreateParams(TypedDict, total=False):
     persistence: BrowserPersistenceParam
     """Optional persistence configuration for the browser session."""
 
+    replay: bool
+    """If true, enables replay recording of the browser session. Defaults to false."""
+
     stealth: bool
     """
     If true, launches the browser in stealth mode to reduce detection by anti-bot

src/kernel/types/browser_create_response.py

@@ -23,3 +23,6 @@ class BrowserCreateResponse(BaseModel):
 
     persistence: Optional[BrowserPersistence] = None
     """Optional persistence configuration for the browser session."""
+
+    replay_view_url: Optional[str] = None
+    """Remote URL for viewing the browser session replay if enabled"""

src/kernel/types/browser_list_response.py

@@ -25,5 +25,8 @@ class BrowserListResponseItem(BaseModel):
     persistence: Optional[BrowserPersistence] = None
     """Optional persistence configuration for the browser session."""
 
+    replay_view_url: Optional[str] = None
+    """Remote URL for viewing the browser session replay if enabled"""
+
 
 BrowserListResponse: TypeAlias = List[BrowserListResponseItem]

src/kernel/types/browser_retrieve_response.py

@@ -23,3 +23,6 @@ class BrowserRetrieveResponse(BaseModel):
 
     persistence: Optional[BrowserPersistence] = None
     """Optional persistence configuration for the browser session."""
+
+    replay_view_url: Optional[str] = None
+    """Remote URL for viewing the browser session replay if enabled"""