@onkernel/sdk 0.14.2 → 0.16.0

package/resources/deployments.js

@@ -15,7 +15,10 @@ class Deployments extends resource_1.APIResource {
      * ```ts
      * const deployment = await client.deployments.create({
      *   entrypoint_rel_path: 'src/app.py',
+     *   env_vars: { FOO: 'bar' },
      *   file: fs.createReadStream('path/to/file'),
+     *   region: 'aws.us-east-1a',
+     *   version: '1.0.0',
      * });
      * ```
      */

package/resources/deployments.js.map

@@ -1 +1 @@
-{"version":3,"file":"deployments.js","sourceRoot":"","sources":["../src/resources/deployments.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAG/C,sDAAgG;AAGhG,oDAAmD;AAEnD,oDAAkE;AAClE,oDAA8C;AAE9C,MAAa,WAAY,SAAQ,sBAAW;IAC1C;;;;;;;;;;OAUG;IACH,MAAM,CAAC,IAA4B,EAAE,OAAwB;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,IAAA,qCAA2B,EAAC,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5G,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,gBAAgB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAAiD,EAAE,EACnD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,CAAA,6BAAwC,CAAA,EAAE;YACvF,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CACJ,EAAU,EACV,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,gBAAgB,EAAE,SAAS,EAAE;YACvD,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1E,MAAM,EAAE,IAAI;SACb,CAAiD,CAAC;IACrD,CAAC;CACF;AAvED,kCAuEC"}
+{"version":3,"file":"deployments.js","sourceRoot":"","sources":["../src/resources/deployments.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAG/C,sDAAgG;AAGhG,oDAAmD;AAEnD,oDAAkE;AAClE,oDAA8C;AAE9C,MAAa,WAAY,SAAQ,sBAAW;IAC1C;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,IAA4B,EAAE,OAAwB;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,IAAA,qCAA2B,EAAC,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5G,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,gBAAgB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAAiD,EAAE,EACnD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,CAAA,6BAAwC,CAAA,EAAE;YACvF,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CACJ,EAAU,EACV,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,gBAAgB,EAAE,SAAS,EAAE;YACvD,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1E,MAAM,EAAE,IAAI;SACb,CAAiD,CAAC;IACrD,CAAC;CACF;AA1ED,kCA0EC"}

package/resources/deployments.mjs

@@ -12,7 +12,10 @@ export class Deployments extends APIResource {
      * ```ts
      * const deployment = await client.deployments.create({
      *   entrypoint_rel_path: 'src/app.py',
+     *   env_vars: { FOO: 'bar' },
      *   file: fs.createReadStream('path/to/file'),
+     *   region: 'aws.us-east-1a',
+     *   version: '1.0.0',
      * });
      * ```
      */

package/resources/deployments.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"deployments.mjs","sourceRoot":"","sources":["../src/resources/deployments.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,gBAAgB,EAA4C;OAG9D,EAAE,YAAY,EAAE;OAEhB,EAAE,2BAA2B,EAAE;OAC/B,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;OAUG;IACH,MAAM,CAAC,IAA4B,EAAE,OAAwB;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,2BAA2B,CAAC,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5G,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,gBAAgB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAAiD,EAAE,EACnD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,CAAA,gBAAwC,CAAA,EAAE;YACvF,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CACJ,EAAU,EACV,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,gBAAgB,EAAE,SAAS,EAAE;YACvD,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1E,MAAM,EAAE,IAAI;SACb,CAAiD,CAAC;IACrD,CAAC;CACF"}
+{"version":3,"file":"deployments.mjs","sourceRoot":"","sources":["../src/resources/deployments.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,gBAAgB,EAA4C;OAG9D,EAAE,YAAY,EAAE;OAEhB,EAAE,2BAA2B,EAAE;OAC/B,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,IAA4B,EAAE,OAAwB;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,2BAA2B,CAAC,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5G,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,gBAAgB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAAiD,EAAE,EACnD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,CAAA,gBAAwC,CAAA,EAAE;YACvF,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CACJ,EAAU,EACV,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,gBAAgB,EAAE,SAAS,EAAE;YACvD,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1E,MAAM,EAAE,IAAI;SACb,CAAiD,CAAC;IACrD,CAAC;CACF"}

package/src/core/pagination.ts

@@ -148,11 +148,7 @@ export class OffsetPagination<Item> extends AbstractPage<Item> {
   }
 
   nextPageRequestOptions(): PageRequestOptions | null {
-    const offset = this.next_offset;
-    if (!offset) {
-      return null;
-    }
-
+    const offset = this.next_offset ?? 0;
     const length = this.getPaginatedItems().length;
     const currentCount = offset + length;
 

package/src/internal/uploads.ts

@@ -176,9 +176,27 @@ const addFormValue = async (form: FormData, key: string, value: unknown): Promis
   } else if (Array.isArray(value)) {
     await Promise.all(value.map((entry) => addFormValue(form, key + '[]', entry)));
   } else if (typeof value === 'object') {
-    await Promise.all(
-      Object.entries(value).map(([name, prop]) => addFormValue(form, `${key}[${name}]`, prop)),
-    );
+    // Special case: env_vars should always be flattened for backward compatibility
+    // with APIs that expect env_vars[KEY] format
+    const shouldAlwaysFlatten = key === 'env_vars';
+    // If the object doesn't contain any uploadable values,
+    // serialize it as JSON instead of flattening it into bracketed keys.
+    // This handles fields with contentType: application/json in the OpenAPI spec.
+    if (!shouldAlwaysFlatten && !hasUploadableValue(value)) {
+      // Filter out undefined values to check if object has any actual content
+      const entries = Object.entries(value).filter(([_, v]) => v !== undefined);
+      if (entries.length > 0) {
+        form.append(key, JSON.stringify(value));
+      }
+      // If all properties are undefined, don't add anything to the form
+    } else {
+      // Flatten objects that:
+      // - Contain uploadable values (files/blobs), or
+      // - Are explicitly marked to always flatten (like env_vars)
+      await Promise.all(
+        Object.entries(value).map(([name, prop]) => addFormValue(form, `${key}[${name}]`, prop)),
+      );
+    }
   } else {
     throw new TypeError(
       `Invalid value given to form, expected a string, number, boolean, object, Array, File or Blob but got ${value} instead`,

package/src/resources/browsers/browsers.ts

@@ -2,8 +2,21 @@
 
 import { APIResource } from '../../core/resource';
 import * as BrowsersAPI from './browsers';
+import * as ComputerAPI from './computer';
+import {
+  Computer,
+  ComputerCaptureScreenshotParams,
+  ComputerClickMouseParams,
+  ComputerDragMouseParams,
+  ComputerMoveMouseParams,
+  ComputerPressKeyParams,
+  ComputerScrollParams,
+  ComputerTypeTextParams,
+} 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,
@@ -59,6 +72,8 @@ export class Browsers extends APIResource {
   fs: FsAPI.Fs = new FsAPI.Fs(this._client);
   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.
@@ -682,6 +697,8 @@ Browsers.Replays = Replays;
 Browsers.Fs = Fs;
 Browsers.Process = Process;
 Browsers.Logs = Logs;
+Browsers.Computer = Computer;
+Browsers.Playwright = Playwright;
 
 export declare namespace Browsers {
   export {
@@ -739,4 +756,21 @@ export declare namespace Browsers {
   };
 
   export { Logs as Logs, type LogStreamParams as LogStreamParams };
+
+  export {
+    Computer as Computer,
+    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 ComputerTypeTextParams as ComputerTypeTextParams,
+  };
+
+  export {
+    Playwright as Playwright,
+    type PlaywrightExecuteResponse as PlaywrightExecuteResponse,
+    type PlaywrightExecuteParams as PlaywrightExecuteParams,
+  };
 }

package/src/resources/browsers/computer.ts

@@ -0,0 +1,328 @@
+// 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 { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Computer extends APIResource {
+  /**
+   * Capture a screenshot of the browser instance
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.browsers.computer.captureScreenshot('id');
+   *
+   * const content = await response.blob();
+   * console.log(content);
+   * ```
+   */
+  captureScreenshot(
+    id: string,
+    body: ComputerCaptureScreenshotParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<Response> {
+    return this._client.post(path`/browsers/${id}/computer/screenshot`, {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: 'image/png' }, options?.headers]),
+      __binaryResponse: true,
+    });
+  }
+
+  /**
+   * Simulate a mouse click action on the browser instance
+   *
+   * @example
+   * ```ts
+   * await client.browsers.computer.clickMouse('id', {
+   *   x: 0,
+   *   y: 0,
+   * });
+   * ```
+   */
+  clickMouse(id: string, body: ComputerClickMouseParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/browsers/${id}/computer/click_mouse`, {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Drag the mouse along a path
+   *
+   * @example
+   * ```ts
+   * await client.browsers.computer.dragMouse('id', {
+   *   path: [
+   *     [0, 0],
+   *     [0, 0],
+   *   ],
+   * });
+   * ```
+   */
+  dragMouse(id: string, body: ComputerDragMouseParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/browsers/${id}/computer/drag_mouse`, {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Move the mouse cursor to the specified coordinates on the browser instance
+   *
+   * @example
+   * ```ts
+   * await client.browsers.computer.moveMouse('id', {
+   *   x: 0,
+   *   y: 0,
+   * });
+   * ```
+   */
+  moveMouse(id: string, body: ComputerMoveMouseParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/browsers/${id}/computer/move_mouse`, {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Press one or more keys on the host computer
+   *
+   * @example
+   * ```ts
+   * await client.browsers.computer.pressKey('id', {
+   *   keys: ['string'],
+   * });
+   * ```
+   */
+  pressKey(id: string, body: ComputerPressKeyParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/browsers/${id}/computer/press_key`, {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Scroll the mouse wheel at a position on the host computer
+   *
+   * @example
+   * ```ts
+   * await client.browsers.computer.scroll('id', { x: 0, y: 0 });
+   * ```
+   */
+  scroll(id: string, body: ComputerScrollParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/browsers/${id}/computer/scroll`, {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Type text on the browser instance
+   *
+   * @example
+   * ```ts
+   * await client.browsers.computer.typeText('id', {
+   *   text: 'text',
+   * });
+   * ```
+   */
+  typeText(id: string, body: ComputerTypeTextParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/browsers/${id}/computer/type`, {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export interface ComputerCaptureScreenshotParams {
+  region?: ComputerCaptureScreenshotParams.Region;
+}
+
+export namespace ComputerCaptureScreenshotParams {
+  export interface Region {
+    /**
+     * Height of the region in pixels
+     */
+    height: number;
+
+    /**
+     * Width of the region in pixels
+     */
+    width: number;
+
+    /**
+     * X coordinate of the region's top-left corner
+     */
+    x: number;
+
+    /**
+     * Y coordinate of the region's top-left corner
+     */
+    y: number;
+  }
+}
+
+export interface ComputerClickMouseParams {
+  /**
+   * X coordinate of the click position
+   */
+  x: number;
+
+  /**
+   * Y coordinate of the click position
+   */
+  y: number;
+
+  /**
+   * Mouse button to interact with
+   */
+  button?: 'left' | 'right' | 'middle' | 'back' | 'forward';
+
+  /**
+   * Type of click action
+   */
+  click_type?: 'down' | 'up' | 'click';
+
+  /**
+   * Modifier keys to hold during the click
+   */
+  hold_keys?: Array<string>;
+
+  /**
+   * Number of times to repeat the click
+   */
+  num_clicks?: number;
+}
+
+export interface ComputerDragMouseParams {
+  /**
+   * Ordered list of [x, y] coordinate pairs to move through while dragging. Must
+   * contain at least 2 points.
+   */
+  path: Array<Array<number>>;
+
+  /**
+   * Mouse button to drag with
+   */
+  button?: 'left' | 'middle' | 'right';
+
+  /**
+   * Delay in milliseconds between button down and starting to move along the path.
+   */
+  delay?: number;
+
+  /**
+   * Modifier keys to hold during the drag
+   */
+  hold_keys?: Array<string>;
+
+  /**
+   * Delay in milliseconds between relative steps while dragging (not the initial
+   * delay).
+   */
+  step_delay_ms?: number;
+
+  /**
+   * Number of relative move steps per segment in the path. Minimum 1.
+   */
+  steps_per_segment?: number;
+}
+
+export interface ComputerMoveMouseParams {
+  /**
+   * X coordinate to move the cursor to
+   */
+  x: number;
+
+  /**
+   * Y coordinate to move the cursor to
+   */
+  y: number;
+
+  /**
+   * Modifier keys to hold during the move
+   */
+  hold_keys?: Array<string>;
+}
+
+export interface ComputerPressKeyParams {
+  /**
+   * List of key symbols to press. Each item should be a key symbol supported by
+   * xdotool (see X11 keysym definitions). Examples include "Return", "Shift",
+   * "Ctrl", "Alt", "F5". Items in this list could also be combinations, e.g.
+   * "Ctrl+t" or "Ctrl+Shift+Tab".
+   */
+  keys: Array<string>;
+
+  /**
+   * Duration to hold the keys down in milliseconds. If omitted or 0, keys are
+   * tapped.
+   */
+  duration?: number;
+
+  /**
+   * Optional modifier keys to hold during the key press sequence.
+   */
+  hold_keys?: Array<string>;
+}
+
+export interface ComputerScrollParams {
+  /**
+   * X coordinate at which to perform the scroll
+   */
+  x: number;
+
+  /**
+   * Y coordinate at which to perform the scroll
+   */
+  y: number;
+
+  /**
+   * Horizontal scroll amount. Positive scrolls right, negative scrolls left.
+   */
+  delta_x?: number;
+
+  /**
+   * Vertical scroll amount. Positive scrolls down, negative scrolls up.
+   */
+  delta_y?: number;
+
+  /**
+   * Modifier keys to hold during the scroll
+   */
+  hold_keys?: Array<string>;
+}
+
+export interface ComputerTypeTextParams {
+  /**
+   * Text to type on the browser instance
+   */
+  text: string;
+
+  /**
+   * Delay in milliseconds between keystrokes
+   */
+  delay?: number;
+}
+
+export declare namespace Computer {
+  export {
+    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 ComputerTypeTextParams as ComputerTypeTextParams,
+  };
+}

package/src/resources/browsers/index.ts

@@ -11,6 +11,16 @@ export {
   type BrowserDeleteParams,
   type BrowserLoadExtensionsParams,
 } from './browsers';
+export {
+  Computer,
+  type ComputerCaptureScreenshotParams,
+  type ComputerClickMouseParams,
+  type ComputerDragMouseParams,
+  type ComputerMoveMouseParams,
+  type ComputerPressKeyParams,
+  type ComputerScrollParams,
+  type ComputerTypeTextParams,
+} from './computer';
 export {
   Fs,
   type FFileInfoResponse,
@@ -29,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,

package/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,
+  };
+}

package/src/resources/deployments.ts

@@ -19,7 +19,10 @@ export class Deployments extends APIResource {
    * ```ts
    * const deployment = await client.deployments.create({
    *   entrypoint_rel_path: 'src/app.py',
+   *   env_vars: { FOO: 'bar' },
    *   file: fs.createReadStream('path/to/file'),
+   *   region: 'aws.us-east-1a',
+   *   version: '1.0.0',
    * });
    * ```
    */
@@ -349,12 +352,7 @@ export interface DeploymentCreateParams {
   /**
    * Relative path to the entrypoint of the application
    */
-  entrypoint_rel_path: string;
-
-  /**
-   * ZIP file containing the application source directory
-   */
-  file: Uploadable;
+  entrypoint_rel_path?: string;
 
   /**
    * Map of environment variables to set for the deployed application. Each key-value
@@ -362,6 +360,11 @@ export interface DeploymentCreateParams {
    */
   env_vars?: { [key: string]: string };
 
+  /**
+   * ZIP file containing the application source directory
+   */
+  file?: Uploadable;
+
   /**
    * Allow overwriting an existing app version
    */
@@ -372,12 +375,71 @@ export interface DeploymentCreateParams {
    */
   region?: 'aws.us-east-1a';
 
+  /**
+   * Source from which to fetch application code.
+   */
+  source?: DeploymentCreateParams.Source;
+
   /**
    * Version of the application. Can be any string.
    */
   version?: string;
 }
 
+export namespace DeploymentCreateParams {
+  /**
+   * Source from which to fetch application code.
+   */
+  export interface Source {
+    /**
+     * Relative path to the application entrypoint within the selected path.
+     */
+    entrypoint: string;
+
+    /**
+     * Git ref (branch, tag, or commit SHA) to fetch.
+     */
+    ref: string;
+
+    /**
+     * Source type identifier.
+     */
+    type: 'github';
+
+    /**
+     * Base repository URL (without blob/tree suffixes).
+     */
+    url: string;
+
+    /**
+     * Authentication for private repositories.
+     */
+    auth?: Source.Auth;
+
+    /**
+     * Path within the repo to deploy (omit to use repo root).
+     */
+    path?: string;
+  }
+
+  export namespace Source {
+    /**
+     * Authentication for private repositories.
+     */
+    export interface Auth {
+      /**
+       * GitHub PAT or installation access token
+       */
+      token: string;
+
+      /**
+       * Auth method
+       */
+      method: 'github_token';
+    }
+  }
+}
+
 export interface DeploymentListParams extends OffsetPaginationParams {
   /**
    * Filter results by application name.

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.14.2'; // x-release-please-version
+export const VERSION = '0.16.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.14.2";
+export declare const VERSION = "0.16.0";
 //# sourceMappingURL=version.d.mts.map