feat: ad hoc playwright code exec AP|

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 64
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-e21f0324774a1762bc2bba0da3a8a6b0d0e74720d7a1c83dec813f9e027fcf58.yml
-openapi_spec_hash: f1b636abfd6cb8e7c2ba7ffb8e53b9ba
-config_hash: 09a2df23048cb16689c9a390d9e5bc47
+configured_endpoints: 65
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-ecf484375ede1edd7754779ad8beeebd4ba9118152fe6cd65772dc7245a19dee.yml
+openapi_spec_hash: b1f3f05005f75cbf5b82299459e2aa9b
+config_hash: 3ded7a0ed77b1bfd68eabc6763521fe8

api.md

@@ -162,6 +162,16 @@ Methods:
 - <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/type">client.browsers.computer.<a href="./src/resources/browsers/computer.ts">typeText</a>(id, { ...params }) -> void</code>
 
+## Playwright
+
+Types:
+
+- <code><a href="./src/resources/browsers/playwright.ts">PlaywrightExecuteResponse</a></code>
+
+Methods:
+
+- <code title="post /browsers/{id}/playwright/execute">client.browsers.playwright.<a href="./src/resources/browsers/playwright.ts">execute</a>(id, { ...params }) -> PlaywrightExecuteResponse</code>
+
 # Profiles
 
 Types:

src/resources/browsers/browsers.ts

@@ -15,6 +15,8 @@ import {
 } from './computer';
 import * as LogsAPI from './logs';
 import { LogStreamParams, Logs } from './logs';
+import * as PlaywrightAPI from './playwright';
+import { Playwright, PlaywrightExecuteParams, PlaywrightExecuteResponse } from './playwright';
 import * as ProcessAPI from './process';
 import {
   Process,
@@ -71,6 +73,7 @@ export class Browsers extends APIResource {
   process: ProcessAPI.Process = new ProcessAPI.Process(this._client);
   logs: LogsAPI.Logs = new LogsAPI.Logs(this._client);
   computer: ComputerAPI.Computer = new ComputerAPI.Computer(this._client);
+  playwright: PlaywrightAPI.Playwright = new PlaywrightAPI.Playwright(this._client);
 
   /**
    * Create a new browser session from within an action.
@@ -695,6 +698,7 @@ Browsers.Fs = Fs;
 Browsers.Process = Process;
 Browsers.Logs = Logs;
 Browsers.Computer = Computer;
+Browsers.Playwright = Playwright;
 
 export declare namespace Browsers {
   export {
@@ -763,4 +767,10 @@ export declare namespace Browsers {
     type ComputerScrollParams as ComputerScrollParams,
     type ComputerTypeTextParams as ComputerTypeTextParams,
   };
+
+  export {
+    Playwright as Playwright,
+    type PlaywrightExecuteResponse as PlaywrightExecuteResponse,
+    type PlaywrightExecuteParams as PlaywrightExecuteParams,
+  };
 }

src/resources/browsers/index.ts

@@ -39,6 +39,7 @@ export {
   type FWriteFileParams,
 } from './fs/index';
 export { Logs, type LogStreamParams } from './logs';
+export { Playwright, type PlaywrightExecuteResponse, type PlaywrightExecuteParams } from './playwright';
 export {
   Process,
   type ProcessExecResponse,

src/resources/browsers/playwright.ts

@@ -0,0 +1,83 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Playwright extends APIResource {
+  /**
+   * Execute arbitrary Playwright code in a fresh execution context against the
+   * browser. The code runs in the same VM as the browser, minimizing latency and
+   * maximizing throughput. It has access to 'page', 'context', and 'browser'
+   * variables. It can `return` a value, and this value is returned in the response.
+   *
+   * @example
+   * ```ts
+   * const response = await client.browsers.playwright.execute(
+   *   'id',
+   *   { code: 'code' },
+   * );
+   * ```
+   */
+  execute(
+    id: string,
+    body: PlaywrightExecuteParams,
+    options?: RequestOptions,
+  ): APIPromise<PlaywrightExecuteResponse> {
+    return this._client.post(path`/browsers/${id}/playwright/execute`, { body, ...options });
+  }
+}
+
+/**
+ * Result of Playwright code execution
+ */
+export interface PlaywrightExecuteResponse {
+  /**
+   * Whether the code executed successfully
+   */
+  success: boolean;
+
+  /**
+   * Error message if execution failed
+   */
+  error?: string;
+
+  /**
+   * The value returned by the code (if any)
+   */
+  result?: unknown;
+
+  /**
+   * Standard error from the execution
+   */
+  stderr?: string;
+
+  /**
+   * Standard output from the execution
+   */
+  stdout?: string;
+}
+
+export interface PlaywrightExecuteParams {
+  /**
+   * TypeScript/JavaScript code to execute. The code has access to 'page', 'context',
+   * and 'browser' variables. It runs within a function, so you can use a return
+   * statement at the end to return a value. This value is returned as the `result`
+   * property in the response. Example: "await page.goto('https://example.com');
+   * return await page.title();"
+   */
+  code: string;
+
+  /**
+   * Maximum execution time in seconds. Default is 60.
+   */
+  timeout_sec?: number;
+}
+
+export declare namespace Playwright {
+  export {
+    type PlaywrightExecuteResponse as PlaywrightExecuteResponse,
+    type PlaywrightExecuteParams as PlaywrightExecuteParams,
+  };
+}

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

@@ -0,0 +1,27 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import Kernel from '@onkernel/sdk';
+
+const client = new Kernel({
+  apiKey: 'My API Key',
+  baseURL: process.env['TEST_API_BASE_URL'] ?? 'http://127.0.0.1:4010',
+});
+
+describe('resource playwright', () => {
+  // Prism tests are disabled
+  test.skip('execute: only required params', async () => {
+    const responsePromise = client.browsers.playwright.execute('id', { code: 'code' });
+    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('execute: required and optional params', async () => {
+    const response = await client.browsers.playwright.execute('id', { code: 'code', timeout_sec: 1 });
+  });
+});