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

@@ -152,6 +152,10 @@ Methods:
 
 ## Computer
 
+Types:
+
+- <code><a href="./src/resources/browsers/computer.ts">ComputerSetCursorVisibilityResponse</a></code>
+
 Methods:
 
 - <code title="post /browsers/{id}/computer/screenshot">client.browsers.computer.<a href="./src/resources/browsers/computer.ts">captureScreenshot</a>(id, { ...params }) -> Response</code>
@@ -160,6 +164,7 @@ Methods:
 - <code title="post /browsers/{id}/computer/move_mouse">client.browsers.computer.<a href="./src/resources/browsers/computer.ts">moveMouse</a>(id, { ...params }) -> void</code>
 - <code title="post /browsers/{id}/computer/press_key">client.browsers.computer.<a href="./src/resources/browsers/computer.ts">pressKey</a>(id, { ...params }) -> void</code>
 - <code title="post /browsers/{id}/computer/scroll">client.browsers.computer.<a href="./src/resources/browsers/computer.ts">scroll</a>(id, { ...params }) -> void</code>
+- <code title="post /browsers/{id}/computer/cursor">client.browsers.computer.<a href="./src/resources/browsers/computer.ts">setCursorVisibility</a>(id, { ...params }) -> ComputerSetCursorVisibilityResponse</code>
 - <code title="post /browsers/{id}/computer/type">client.browsers.computer.<a href="./src/resources/browsers/computer.ts">typeText</a>(id, { ...params }) -> void</code>
 
 ## Playwright

src/resources/browsers/browsers.ts

@@ -11,6 +11,8 @@ import {
   ComputerMoveMouseParams,
   ComputerPressKeyParams,
   ComputerScrollParams,
+  ComputerSetCursorVisibilityParams,
+  ComputerSetCursorVisibilityResponse,
   ComputerTypeTextParams,
 } from './computer';
 import * as LogsAPI from './logs';
@@ -759,12 +761,14 @@ export declare namespace Browsers {
 
   export {
     Computer as Computer,
+    type ComputerSetCursorVisibilityResponse as ComputerSetCursorVisibilityResponse,
     type ComputerCaptureScreenshotParams as ComputerCaptureScreenshotParams,
     type ComputerClickMouseParams as ComputerClickMouseParams,
     type ComputerDragMouseParams as ComputerDragMouseParams,
     type ComputerMoveMouseParams as ComputerMoveMouseParams,
     type ComputerPressKeyParams as ComputerPressKeyParams,
     type ComputerScrollParams as ComputerScrollParams,
+    type ComputerSetCursorVisibilityParams as ComputerSetCursorVisibilityParams,
     type ComputerTypeTextParams as ComputerTypeTextParams,
   };
 

src/resources/browsers/computer.ts

@@ -125,6 +125,25 @@ export class Computer extends APIResource {
     });
   }
 
+  /**
+   * Set cursor visibility
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.browsers.computer.setCursorVisibility('id', {
+   *     hidden: true,
+   *   });
+   * ```
+   */
+  setCursorVisibility(
+    id: string,
+    body: ComputerSetCursorVisibilityParams,
+    options?: RequestOptions,
+  ): APIPromise<ComputerSetCursorVisibilityResponse> {
+    return this._client.post(path`/browsers/${id}/computer/cursor`, { body, ...options });
+  }
+
   /**
    * Type text on the browser instance
    *
@@ -144,6 +163,16 @@ export class Computer extends APIResource {
   }
 }
 
+/**
+ * Generic OK response.
+ */
+export interface ComputerSetCursorVisibilityResponse {
+  /**
+   * Indicates success.
+   */
+  ok: boolean;
+}
+
 export interface ComputerCaptureScreenshotParams {
   region?: ComputerCaptureScreenshotParams.Region;
 }
@@ -303,6 +332,13 @@ export interface ComputerScrollParams {
   hold_keys?: Array<string>;
 }
 
+export interface ComputerSetCursorVisibilityParams {
+  /**
+   * Whether the cursor should be hidden or visible
+   */
+  hidden: boolean;
+}
+
 export interface ComputerTypeTextParams {
   /**
    * Text to type on the browser instance
@@ -317,12 +353,14 @@ export interface ComputerTypeTextParams {
 
 export declare namespace Computer {
   export {
+    type ComputerSetCursorVisibilityResponse as ComputerSetCursorVisibilityResponse,
     type ComputerCaptureScreenshotParams as ComputerCaptureScreenshotParams,
     type ComputerClickMouseParams as ComputerClickMouseParams,
     type ComputerDragMouseParams as ComputerDragMouseParams,
     type ComputerMoveMouseParams as ComputerMoveMouseParams,
     type ComputerPressKeyParams as ComputerPressKeyParams,
     type ComputerScrollParams as ComputerScrollParams,
+    type ComputerSetCursorVisibilityParams as ComputerSetCursorVisibilityParams,
     type ComputerTypeTextParams as ComputerTypeTextParams,
   };
 }

src/resources/browsers/index.ts

@@ -13,12 +13,14 @@ export {
 } from './browsers';
 export {
   Computer,
+  type ComputerSetCursorVisibilityResponse,
   type ComputerCaptureScreenshotParams,
   type ComputerClickMouseParams,
   type ComputerDragMouseParams,
   type ComputerMoveMouseParams,
   type ComputerPressKeyParams,
   type ComputerScrollParams,
+  type ComputerSetCursorVisibilityParams,
   type ComputerTypeTextParams,
 } from './computer';
 export {

tests/api-resources/browsers/computer.test.ts

@@ -136,6 +136,23 @@ describe('resource computer', () => {
     });
   });
 
+  // Prism tests are disabled
+  test.skip('setCursorVisibility: only required params', async () => {
+    const responsePromise = client.browsers.computer.setCursorVisibility('id', { hidden: true });
+    const rawResponse = await responsePromise.asResponse();
+    expect(rawResponse).toBeInstanceOf(Response);
+    const response = await responsePromise;
+    expect(response).not.toBeInstanceOf(Response);
+    const dataAndResponse = await responsePromise.withResponse();
+    expect(dataAndResponse.data).toBe(response);
+    expect(dataAndResponse.response).toBe(rawResponse);
+  });
+
+  // Prism tests are disabled
+  test.skip('setCursorVisibility: required and optional params', async () => {
+    const response = await client.browsers.computer.setCursorVisibility('id', { hidden: true });
+  });
+
   // Prism tests are disabled
   test.skip('typeText: only required params', async () => {
     const responsePromise = client.browsers.computer.typeText('id', { text: 'text' });