feat: [kernel-1028] add api clipboard support

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 101
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-a935c8aae21f8ddb83ea5e289034df12cbde88d432fa2b287629814bb3f58bb6.yml
-openapi_spec_hash: df3189b9728372f01662a19c060bcbc5
-config_hash: 81f143f4bee47ae7b0b8357551babadf
+configured_endpoints: 103
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-f05b888046776a18dbffc1264a27c0256839d132066ef5f6e09ccf1bc505a8f7.yml
+openapi_spec_hash: 646fce3982d3efbdb38004b0e4ac4d17
+config_hash: cff4d43372b6fa66b64e2d4150f6aa76

api.md

@@ -192,6 +192,7 @@ Types:
 ```python
 from kernel.types.browsers import (
     ComputerGetMousePositionResponse,
+    ComputerReadClipboardResponse,
     ComputerSetCursorVisibilityResponse,
 )
 ```
@@ -205,9 +206,11 @@ Methods:
 - <code title="post /browsers/{id}/computer/get_mouse_position">client.browsers.computer.<a href="./src/kernel/resources/browsers/computer.py">get_mouse_position</a>(id) -> <a href="./src/kernel/types/browsers/computer_get_mouse_position_response.py">ComputerGetMousePositionResponse</a></code>
 - <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/clipboard/read">client.browsers.computer.<a href="./src/kernel/resources/browsers/computer.py">read_clipboard</a>(id) -> <a href="./src/kernel/types/browsers/computer_read_clipboard_response.py">ComputerReadClipboardResponse</a></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>
+- <code title="post /browsers/{id}/computer/clipboard/write">client.browsers.computer.<a href="./src/kernel/resources/browsers/computer.py">write_clipboard</a>(id, \*\*<a href="src/kernel/types/browsers/computer_write_clipboard_params.py">params</a>) -> None</code>
 
 ## Playwright
 

src/kernel/resources/browsers/computer.py

@@ -34,9 +34,11 @@
     computer_drag_mouse_params,
     computer_move_mouse_params,
     computer_click_mouse_params,
+    computer_write_clipboard_params,
     computer_capture_screenshot_params,
     computer_set_cursor_visibility_params,
 )
+from ...types.browsers.computer_read_clipboard_response import ComputerReadClipboardResponse
 from ...types.browsers.computer_get_mouse_position_response import ComputerGetMousePositionResponse
 from ...types.browsers.computer_set_cursor_visibility_response import ComputerSetCursorVisibilityResponse
 
@@ -408,6 +410,39 @@ def press_key(
             cast_to=NoneType,
         )
 
+    def read_clipboard(
+        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,
+    ) -> ComputerReadClipboardResponse:
+        """
+        Read text from the clipboard on the browser instance
+
+        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}")
+        return self._post(
+            f"/browsers/{id}/computer/clipboard/read",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=ComputerReadClipboardResponse,
+        )
+
     def scroll(
         self,
         id: str,
@@ -553,6 +588,44 @@ def type_text(
             cast_to=NoneType,
         )
 
+    def write_clipboard(
+        self,
+        id: str,
+        *,
+        text: 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:
+        """
+        Write text to the clipboard on the browser instance
+
+        Args:
+          text: Text to write to the system clipboard
+
+          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._post(
+            f"/browsers/{id}/computer/clipboard/write",
+            body=maybe_transform({"text": text}, computer_write_clipboard_params.ComputerWriteClipboardParams),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
 
 class AsyncComputerResource(AsyncAPIResource):
     @cached_property
@@ -919,6 +992,39 @@ async def press_key(
             cast_to=NoneType,
         )
 
+    async def read_clipboard(
+        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,
+    ) -> ComputerReadClipboardResponse:
+        """
+        Read text from the clipboard on the browser instance
+
+        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}")
+        return await self._post(
+            f"/browsers/{id}/computer/clipboard/read",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=ComputerReadClipboardResponse,
+        )
+
     async def scroll(
         self,
         id: str,
@@ -1064,6 +1170,46 @@ async def type_text(
             cast_to=NoneType,
         )
 
+    async def write_clipboard(
+        self,
+        id: str,
+        *,
+        text: 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:
+        """
+        Write text to the clipboard on the browser instance
+
+        Args:
+          text: Text to write to the system clipboard
+
+          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._post(
+            f"/browsers/{id}/computer/clipboard/write",
+            body=await async_maybe_transform(
+                {"text": text}, computer_write_clipboard_params.ComputerWriteClipboardParams
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
 
 class ComputerResourceWithRawResponse:
     def __init__(self, computer: ComputerResource) -> None:
@@ -1091,6 +1237,9 @@ def __init__(self, computer: ComputerResource) -> None:
         self.press_key = to_raw_response_wrapper(
             computer.press_key,
         )
+        self.read_clipboard = to_raw_response_wrapper(
+            computer.read_clipboard,
+        )
         self.scroll = to_raw_response_wrapper(
             computer.scroll,
         )
@@ -1100,6 +1249,9 @@ def __init__(self, computer: ComputerResource) -> None:
         self.type_text = to_raw_response_wrapper(
             computer.type_text,
         )
+        self.write_clipboard = to_raw_response_wrapper(
+            computer.write_clipboard,
+        )
 
 
 class AsyncComputerResourceWithRawResponse:
@@ -1128,6 +1280,9 @@ def __init__(self, computer: AsyncComputerResource) -> None:
         self.press_key = async_to_raw_response_wrapper(
             computer.press_key,
         )
+        self.read_clipboard = async_to_raw_response_wrapper(
+            computer.read_clipboard,
+        )
         self.scroll = async_to_raw_response_wrapper(
             computer.scroll,
         )
@@ -1137,6 +1292,9 @@ def __init__(self, computer: AsyncComputerResource) -> None:
         self.type_text = async_to_raw_response_wrapper(
             computer.type_text,
         )
+        self.write_clipboard = async_to_raw_response_wrapper(
+            computer.write_clipboard,
+        )
 
 
 class ComputerResourceWithStreamingResponse:
@@ -1165,6 +1323,9 @@ def __init__(self, computer: ComputerResource) -> None:
         self.press_key = to_streamed_response_wrapper(
             computer.press_key,
         )
+        self.read_clipboard = to_streamed_response_wrapper(
+            computer.read_clipboard,
+        )
         self.scroll = to_streamed_response_wrapper(
             computer.scroll,
         )
@@ -1174,6 +1335,9 @@ def __init__(self, computer: ComputerResource) -> None:
         self.type_text = to_streamed_response_wrapper(
             computer.type_text,
         )
+        self.write_clipboard = to_streamed_response_wrapper(
+            computer.write_clipboard,
+        )
 
 
 class AsyncComputerResourceWithStreamingResponse:
@@ -1202,6 +1366,9 @@ def __init__(self, computer: AsyncComputerResource) -> None:
         self.press_key = async_to_streamed_response_wrapper(
             computer.press_key,
         )
+        self.read_clipboard = async_to_streamed_response_wrapper(
+            computer.read_clipboard,
+        )
         self.scroll = async_to_streamed_response_wrapper(
             computer.scroll,
         )
@@ -1211,3 +1378,6 @@ def __init__(self, computer: AsyncComputerResource) -> None:
         self.type_text = async_to_streamed_response_wrapper(
             computer.type_text,
         )
+        self.write_clipboard = async_to_streamed_response_wrapper(
+            computer.write_clipboard,
+        )

src/kernel/types/browsers/__init__.py

@@ -41,6 +41,8 @@
 from .playwright_execute_response import PlaywrightExecuteResponse as PlaywrightExecuteResponse
 from .f_set_file_permissions_params import FSetFilePermissionsParams as FSetFilePermissionsParams
 from .process_stdout_stream_response import ProcessStdoutStreamResponse as ProcessStdoutStreamResponse
+from .computer_write_clipboard_params import ComputerWriteClipboardParams as ComputerWriteClipboardParams
+from .computer_read_clipboard_response import ComputerReadClipboardResponse as ComputerReadClipboardResponse
 from .computer_capture_screenshot_params import ComputerCaptureScreenshotParams as ComputerCaptureScreenshotParams
 from .computer_get_mouse_position_response import ComputerGetMousePositionResponse as ComputerGetMousePositionResponse
 from .computer_set_cursor_visibility_params import (

src/kernel/types/browsers/computer_read_clipboard_response.py

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from ..._models import BaseModel
+
+__all__ = ["ComputerReadClipboardResponse"]
+
+
+class ComputerReadClipboardResponse(BaseModel):
+    text: str
+    """Current clipboard text content"""

src/kernel/types/browsers/computer_write_clipboard_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__ = ["ComputerWriteClipboardParams"]
+
+
+class ComputerWriteClipboardParams(TypedDict, total=False):
+    text: Required[str]
+    """Text to write to the system clipboard"""