feat: feat hide cursor v2

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 65
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-8c7e0b9069a18bc9437269618cde251ba15568771f2b4811d57f0d5f0fd5692d.yml
-openapi_spec_hash: aa2544d0bf0e7e875939aaa8e2e114d3
-config_hash: 0fbdda3a736cc2748ca33371871e61b3
+configured_endpoints: 66
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-86854c41729a6b26f71e26c906f665f69939f23e2d7adcc43380aee64cf6d056.yml
+openapi_spec_hash: 270a40c8af29e83cbda77d3700fd456a
+config_hash: 9421eb86b7f3f4b274f123279da3858e

api.md

@@ -168,6 +168,12 @@ Methods:
 
 ## Computer
 
+Types:
+
+```python
+from kernel.types.browsers import ComputerSetCursorVisibilityResponse
+```
+
 Methods:
 
 - <code title="post /browsers/{id}/computer/screenshot">client.browsers.computer.<a href="./src/kernel/resources/browsers/computer.py">capture_screenshot</a>(id, \*\*<a href="src/kernel/types/browsers/computer_capture_screenshot_params.py">params</a>) -> BinaryAPIResponse</code>
@@ -176,6 +182,7 @@ Methods:
 - <code title="post /browsers/{id}/computer/move_mouse">client.browsers.computer.<a href="./src/kernel/resources/browsers/computer.py">move_mouse</a>(id, \*\*<a href="src/kernel/types/browsers/computer_move_mouse_params.py">params</a>) -> None</code>
 - <code title="post /browsers/{id}/computer/press_key">client.browsers.computer.<a href="./src/kernel/resources/browsers/computer.py">press_key</a>(id, \*\*<a href="src/kernel/types/browsers/computer_press_key_params.py">params</a>) -> None</code>
 - <code title="post /browsers/{id}/computer/scroll">client.browsers.computer.<a href="./src/kernel/resources/browsers/computer.py">scroll</a>(id, \*\*<a href="src/kernel/types/browsers/computer_scroll_params.py">params</a>) -> None</code>
+- <code title="post /browsers/{id}/computer/cursor">client.browsers.computer.<a href="./src/kernel/resources/browsers/computer.py">set_cursor_visibility</a>(id, \*\*<a href="src/kernel/types/browsers/computer_set_cursor_visibility_params.py">params</a>) -> <a href="./src/kernel/types/browsers/computer_set_cursor_visibility_response.py">ComputerSetCursorVisibilityResponse</a></code>
 - <code title="post /browsers/{id}/computer/type">client.browsers.computer.<a href="./src/kernel/resources/browsers/computer.py">type_text</a>(id, \*\*<a href="src/kernel/types/browsers/computer_type_text_params.py">params</a>) -> None</code>
 
 ## Playwright

src/kernel/resources/browsers/computer.py

@@ -34,7 +34,9 @@
     computer_move_mouse_params,
     computer_click_mouse_params,
     computer_capture_screenshot_params,
+    computer_set_cursor_visibility_params,
 )
+from ...types.browsers.computer_set_cursor_visibility_response import ComputerSetCursorVisibilityResponse
 
 __all__ = ["ComputerResource", "AsyncComputerResource"]
 
@@ -390,6 +392,45 @@ def scroll(
             cast_to=NoneType,
         )
 
+    def set_cursor_visibility(
+        self,
+        id: str,
+        *,
+        hidden: bool,
+        # 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,
+    ) -> ComputerSetCursorVisibilityResponse:
+        """
+        Set cursor visibility
+
+        Args:
+          hidden: Whether the cursor should be hidden or visible
+
+          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}")
+        return self._post(
+            f"/browsers/{id}/computer/cursor",
+            body=maybe_transform(
+                {"hidden": hidden}, computer_set_cursor_visibility_params.ComputerSetCursorVisibilityParams
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=ComputerSetCursorVisibilityResponse,
+        )
+
     def type_text(
         self,
         id: str,
@@ -789,6 +830,45 @@ async def scroll(
             cast_to=NoneType,
         )
 
+    async def set_cursor_visibility(
+        self,
+        id: str,
+        *,
+        hidden: bool,
+        # 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,
+    ) -> ComputerSetCursorVisibilityResponse:
+        """
+        Set cursor visibility
+
+        Args:
+          hidden: Whether the cursor should be hidden or visible
+
+          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}")
+        return await self._post(
+            f"/browsers/{id}/computer/cursor",
+            body=await async_maybe_transform(
+                {"hidden": hidden}, computer_set_cursor_visibility_params.ComputerSetCursorVisibilityParams
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=ComputerSetCursorVisibilityResponse,
+        )
+
     async def type_text(
         self,
         id: str,
@@ -860,6 +940,9 @@ def __init__(self, computer: ComputerResource) -> None:
         self.scroll = to_raw_response_wrapper(
             computer.scroll,
         )
+        self.set_cursor_visibility = to_raw_response_wrapper(
+            computer.set_cursor_visibility,
+        )
         self.type_text = to_raw_response_wrapper(
             computer.type_text,
         )
@@ -888,6 +971,9 @@ def __init__(self, computer: AsyncComputerResource) -> None:
         self.scroll = async_to_raw_response_wrapper(
             computer.scroll,
         )
+        self.set_cursor_visibility = async_to_raw_response_wrapper(
+            computer.set_cursor_visibility,
+        )
         self.type_text = async_to_raw_response_wrapper(
             computer.type_text,
         )
@@ -916,6 +1002,9 @@ def __init__(self, computer: ComputerResource) -> None:
         self.scroll = to_streamed_response_wrapper(
             computer.scroll,
         )
+        self.set_cursor_visibility = to_streamed_response_wrapper(
+            computer.set_cursor_visibility,
+        )
         self.type_text = to_streamed_response_wrapper(
             computer.type_text,
         )
@@ -944,6 +1033,9 @@ def __init__(self, computer: AsyncComputerResource) -> None:
         self.scroll = async_to_streamed_response_wrapper(
             computer.scroll,
         )
+        self.set_cursor_visibility = async_to_streamed_response_wrapper(
+            computer.set_cursor_visibility,
+        )
         self.type_text = async_to_streamed_response_wrapper(
             computer.type_text,
         )

src/kernel/types/browsers/__init__.py

@@ -39,3 +39,9 @@
 from .f_set_file_permissions_params import FSetFilePermissionsParams as FSetFilePermissionsParams
 from .process_stdout_stream_response import ProcessStdoutStreamResponse as ProcessStdoutStreamResponse
 from .computer_capture_screenshot_params import ComputerCaptureScreenshotParams as ComputerCaptureScreenshotParams
+from .computer_set_cursor_visibility_params import (
+    ComputerSetCursorVisibilityParams as ComputerSetCursorVisibilityParams,
+)
+from .computer_set_cursor_visibility_response import (
+    ComputerSetCursorVisibilityResponse as ComputerSetCursorVisibilityResponse,
+)

src/kernel/types/browsers/computer_set_cursor_visibility_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__ = ["ComputerSetCursorVisibilityParams"]
+
+
+class ComputerSetCursorVisibilityParams(TypedDict, total=False):
+    hidden: Required[bool]
+    """Whether the cursor should be hidden or visible"""

src/kernel/types/browsers/computer_set_cursor_visibility_response.py

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from ..._models import BaseModel
+
+__all__ = ["ComputerSetCursorVisibilityResponse"]
+
+
+class ComputerSetCursorVisibilityResponse(BaseModel):
+    ok: bool
+    """Indicates success."""

tests/api_resources/browsers/test_computer.py

@@ -10,12 +10,16 @@
 from respx import MockRouter
 
 from kernel import Kernel, AsyncKernel
+from tests.utils import assert_matches_type
 from kernel._response import (
     BinaryAPIResponse,
     AsyncBinaryAPIResponse,
     StreamedBinaryAPIResponse,
     AsyncStreamedBinaryAPIResponse,
 )
+from kernel.types.browsers import (
+    ComputerSetCursorVisibilityResponse,
+)
 
 base_url = os.environ.get("TEST_API_BASE_URL", "http://127.0.0.1:4010")
 
@@ -396,6 +400,52 @@ def test_path_params_scroll(self, client: Kernel) -> None:
                 y=0,
             )
 
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_method_set_cursor_visibility(self, client: Kernel) -> None:
+        computer = client.browsers.computer.set_cursor_visibility(
+            id="id",
+            hidden=True,
+        )
+        assert_matches_type(ComputerSetCursorVisibilityResponse, computer, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_raw_response_set_cursor_visibility(self, client: Kernel) -> None:
+        response = client.browsers.computer.with_raw_response.set_cursor_visibility(
+            id="id",
+            hidden=True,
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        computer = response.parse()
+        assert_matches_type(ComputerSetCursorVisibilityResponse, computer, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_streaming_response_set_cursor_visibility(self, client: Kernel) -> None:
+        with client.browsers.computer.with_streaming_response.set_cursor_visibility(
+            id="id",
+            hidden=True,
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            computer = response.parse()
+            assert_matches_type(ComputerSetCursorVisibilityResponse, computer, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_path_params_set_cursor_visibility(self, client: Kernel) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `id` but received ''"):
+            client.browsers.computer.with_raw_response.set_cursor_visibility(
+                id="",
+                hidden=True,
+            )
+
     @pytest.mark.skip(reason="Prism tests are disabled")
     @parametrize
     def test_method_type_text(self, client: Kernel) -> None:
@@ -835,6 +885,52 @@ async def test_path_params_scroll(self, async_client: AsyncKernel) -> None:
                 y=0,
             )
 
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_method_set_cursor_visibility(self, async_client: AsyncKernel) -> None:
+        computer = await async_client.browsers.computer.set_cursor_visibility(
+            id="id",
+            hidden=True,
+        )
+        assert_matches_type(ComputerSetCursorVisibilityResponse, computer, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_raw_response_set_cursor_visibility(self, async_client: AsyncKernel) -> None:
+        response = await async_client.browsers.computer.with_raw_response.set_cursor_visibility(
+            id="id",
+            hidden=True,
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        computer = await response.parse()
+        assert_matches_type(ComputerSetCursorVisibilityResponse, computer, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_streaming_response_set_cursor_visibility(self, async_client: AsyncKernel) -> None:
+        async with async_client.browsers.computer.with_streaming_response.set_cursor_visibility(
+            id="id",
+            hidden=True,
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            computer = await response.parse()
+            assert_matches_type(ComputerSetCursorVisibilityResponse, computer, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_path_params_set_cursor_visibility(self, async_client: AsyncKernel) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `id` but received ''"):
+            await async_client.browsers.computer.with_raw_response.set_cursor_visibility(
+                id="",
+                hidden=True,
+            )
+
     @pytest.mark.skip(reason="Prism tests are disabled")
     @parametrize
     async def test_method_type_text(self, async_client: AsyncKernel) -> None: