feat(api): manual updates

replays!

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-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
+configured_endpoints: 21
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-a5b1d2c806c42c1534eefc8d34516f7f6e4ab68cb6a836534ee549bdbe4653f3.yml
+openapi_spec_hash: 0be350cc8ddbd1fc7e058ce6c3a44ee8
+config_hash: 307153ecd5b85f77ce8e0d87f6e5dfab

api.md

@@ -87,9 +87,23 @@ from kernel.types import (
 
 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>
-- <code title="get /browsers/{id}/replay">client.browsers.<a href="./src/kernel/resources/browsers.py">retrieve_replay</a>(id) -> BinaryAPIResponse</code>
+- <code title="post /browsers">client.browsers.<a href="./src/kernel/resources/browsers/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/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/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/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/browsers.py">delete_by_id</a>(id) -> None</code>
+
+## Replays
+
+Types:
+
+```python
+from kernel.types.browsers import ReplayListResponse, ReplayStartResponse
+```
+
+Methods:
+
+- <code title="get /browsers/{id}/replays">client.browsers.replays.<a href="./src/kernel/resources/browsers/replays.py">list</a>(id) -> <a href="./src/kernel/types/browsers/replay_list_response.py">ReplayListResponse</a></code>
+- <code title="get /browsers/{id}/replays/{replay_id}">client.browsers.replays.<a href="./src/kernel/resources/browsers/replays.py">download</a>(replay_id, \*, id) -> BinaryAPIResponse</code>
+- <code title="post /browsers/{id}/replays">client.browsers.replays.<a href="./src/kernel/resources/browsers/replays.py">start</a>(id, \*\*<a href="src/kernel/types/browsers/replay_start_params.py">params</a>) -> <a href="./src/kernel/types/browsers/replay_start_response.py">ReplayStartResponse</a></code>
+- <code title="post /browsers/{id}/replays/{replay_id}/stop">client.browsers.replays.<a href="./src/kernel/resources/browsers/replays.py">stop</a>(replay_id, \*, id) -> None</code>

src/kernel/_client.py

@@ -21,7 +21,7 @@
 )
 from ._utils import is_given, get_async_library
 from ._version import __version__
-from .resources import browsers, deployments, invocations
+from .resources import deployments, invocations
 from ._streaming import Stream as Stream, AsyncStream as AsyncStream
 from ._exceptions import KernelError, APIStatusError
 from ._base_client import (
@@ -30,6 +30,7 @@
     AsyncAPIClient,
 )
 from .resources.apps import apps
+from .resources.browsers import browsers
 
 __all__ = [
     "ENVIRONMENTS",

src/kernel/resources/browsers/__init__.py

@@ -0,0 +1,33 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .replays import (
+    ReplaysResource,
+    AsyncReplaysResource,
+    ReplaysResourceWithRawResponse,
+    AsyncReplaysResourceWithRawResponse,
+    ReplaysResourceWithStreamingResponse,
+    AsyncReplaysResourceWithStreamingResponse,
+)
+from .browsers import (
+    BrowsersResource,
+    AsyncBrowsersResource,
+    BrowsersResourceWithRawResponse,
+    AsyncBrowsersResourceWithRawResponse,
+    BrowsersResourceWithStreamingResponse,
+    AsyncBrowsersResourceWithStreamingResponse,
+)
+
+__all__ = [
+    "ReplaysResource",
+    "AsyncReplaysResource",
+    "ReplaysResourceWithRawResponse",
+    "AsyncReplaysResourceWithRawResponse",
+    "ReplaysResourceWithStreamingResponse",
+    "AsyncReplaysResourceWithStreamingResponse",
+    "BrowsersResource",
+    "AsyncBrowsersResource",
+    "BrowsersResourceWithRawResponse",
+    "AsyncBrowsersResourceWithRawResponse",
+    "BrowsersResourceWithStreamingResponse",
+    "AsyncBrowsersResourceWithStreamingResponse",
+]

src/kernel/resources/browsers.py renamed to src/kernel/resources/browsers/browsers.py

@@ -4,35 +4,39 @@
 
 import httpx
 
-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
-from .._response import (
-    BinaryAPIResponse,
-    AsyncBinaryAPIResponse,
-    StreamedBinaryAPIResponse,
-    AsyncStreamedBinaryAPIResponse,
+from ...types import browser_create_params, browser_delete_params
+from .replays import (
+    ReplaysResource,
+    AsyncReplaysResource,
+    ReplaysResourceWithRawResponse,
+    AsyncReplaysResourceWithRawResponse,
+    ReplaysResourceWithStreamingResponse,
+    AsyncReplaysResourceWithStreamingResponse,
+)
+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
+from ..._response import (
     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
-from ..types.browser_create_response import BrowserCreateResponse
-from ..types.browser_persistence_param import BrowserPersistenceParam
-from ..types.browser_retrieve_response import BrowserRetrieveResponse
+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"]
 
 
 class BrowsersResource(SyncAPIResource):
+    @cached_property
+    def replays(self) -> ReplaysResource:
+        return ReplaysResource(self._client)
+
     @cached_property
     def with_raw_response(self) -> BrowsersResourceWithRawResponse:
         """
@@ -58,7 +62,6 @@ 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.
@@ -78,8 +81,6 @@ 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.
 
@@ -98,7 +99,6 @@ def create(
                     "headless": headless,
                     "invocation_id": invocation_id,
                     "persistence": persistence,
-                    "replay": replay,
                     "stealth": stealth,
                 },
                 browser_create_params.BrowserCreateParams,
@@ -233,42 +233,12 @@ 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
+    def replays(self) -> AsyncReplaysResource:
+        return AsyncReplaysResource(self._client)
+
     @cached_property
     def with_raw_response(self) -> AsyncBrowsersResourceWithRawResponse:
         """
@@ -294,7 +264,6 @@ 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.
@@ -314,8 +283,6 @@ 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.
 
@@ -334,7 +301,6 @@ async def create(
                     "headless": headless,
                     "invocation_id": invocation_id,
                     "persistence": persistence,
-                    "replay": replay,
                     "stealth": stealth,
                 },
                 browser_create_params.BrowserCreateParams,
@@ -471,40 +437,6 @@ 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:
@@ -525,10 +457,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,
-        )
+
+    @cached_property
+    def replays(self) -> ReplaysResourceWithRawResponse:
+        return ReplaysResourceWithRawResponse(self._browsers.replays)
 
 
 class AsyncBrowsersResourceWithRawResponse:
@@ -550,10 +482,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,
-        )
+
+    @cached_property
+    def replays(self) -> AsyncReplaysResourceWithRawResponse:
+        return AsyncReplaysResourceWithRawResponse(self._browsers.replays)
 
 
 class BrowsersResourceWithStreamingResponse:
@@ -575,10 +507,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,
-        )
+
+    @cached_property
+    def replays(self) -> ReplaysResourceWithStreamingResponse:
+        return ReplaysResourceWithStreamingResponse(self._browsers.replays)
 
 
 class AsyncBrowsersResourceWithStreamingResponse:
@@ -600,7 +532,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,
-        )
+
+    @cached_property
+    def replays(self) -> AsyncReplaysResourceWithStreamingResponse:
+        return AsyncReplaysResourceWithStreamingResponse(self._browsers.replays)