@onkernel/sdk 0.42.1 → 0.44.0

package/src/resources/browsers/browsers.ts

@@ -313,6 +313,11 @@ export interface BrowserCreateResponse {
    */
   timeout_seconds: number;
 
+  /**
+   * Websocket URL for WebDriver BiDi connections to the browser session
+   */
+  webdriver_ws_url: string;
+
   /**
    * Remote URL for live viewing the browser session. Only available for non-headless
    * browsers.
@@ -325,7 +330,8 @@ export interface BrowserCreateResponse {
   deleted_at?: string;
 
   /**
-   * Whether the browser session has hardware-accelerated GPU rendering.
+   * Whether GPU acceleration is enabled for the browser session (only supported for
+   * headful sessions).
    */
   gpu?: boolean;
 
@@ -362,9 +368,13 @@ export interface BrowserCreateResponse {
 
   /**
    * Initial browser window size in pixels with optional refresh rate. If omitted,
-   * image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,
-   * but the following configurations are known-good and fully tested: 2560x1440@10,
-   * 1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60.
+   * image defaults apply (1920x1080@25). For GPU images, the default is
+   * 1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+   * Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+   * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+   * presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+   * 800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+   * 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
    * Viewports outside this list may exhibit unstable live view or recording
    * behavior. If refresh_rate is not provided, it will be automatically determined
    * based on the resolution (higher resolutions use lower refresh rates to keep
@@ -404,6 +414,11 @@ export interface BrowserRetrieveResponse {
    */
   timeout_seconds: number;
 
+  /**
+   * Websocket URL for WebDriver BiDi connections to the browser session
+   */
+  webdriver_ws_url: string;
+
   /**
    * Remote URL for live viewing the browser session. Only available for non-headless
    * browsers.
@@ -416,7 +431,8 @@ export interface BrowserRetrieveResponse {
   deleted_at?: string;
 
   /**
-   * Whether the browser session has hardware-accelerated GPU rendering.
+   * Whether GPU acceleration is enabled for the browser session (only supported for
+   * headful sessions).
    */
   gpu?: boolean;
 
@@ -453,9 +469,13 @@ export interface BrowserRetrieveResponse {
 
   /**
    * Initial browser window size in pixels with optional refresh rate. If omitted,
-   * image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,
-   * but the following configurations are known-good and fully tested: 2560x1440@10,
-   * 1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60.
+   * image defaults apply (1920x1080@25). For GPU images, the default is
+   * 1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+   * Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+   * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+   * presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+   * 800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+   * 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
    * Viewports outside this list may exhibit unstable live view or recording
    * behavior. If refresh_rate is not provided, it will be automatically determined
    * based on the resolution (higher resolutions use lower refresh rates to keep
@@ -495,6 +515,11 @@ export interface BrowserUpdateResponse {
    */
   timeout_seconds: number;
 
+  /**
+   * Websocket URL for WebDriver BiDi connections to the browser session
+   */
+  webdriver_ws_url: string;
+
   /**
    * Remote URL for live viewing the browser session. Only available for non-headless
    * browsers.
@@ -507,7 +532,8 @@ export interface BrowserUpdateResponse {
   deleted_at?: string;
 
   /**
-   * Whether the browser session has hardware-accelerated GPU rendering.
+   * Whether GPU acceleration is enabled for the browser session (only supported for
+   * headful sessions).
    */
   gpu?: boolean;
 
@@ -544,9 +570,13 @@ export interface BrowserUpdateResponse {
 
   /**
    * Initial browser window size in pixels with optional refresh rate. If omitted,
-   * image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,
-   * but the following configurations are known-good and fully tested: 2560x1440@10,
-   * 1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60.
+   * image defaults apply (1920x1080@25). For GPU images, the default is
+   * 1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+   * Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+   * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+   * presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+   * 800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+   * 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
    * Viewports outside this list may exhibit unstable live view or recording
    * behavior. If refresh_rate is not provided, it will be automatically determined
    * based on the resolution (higher resolutions use lower refresh rates to keep
@@ -586,6 +616,11 @@ export interface BrowserListResponse {
    */
   timeout_seconds: number;
 
+  /**
+   * Websocket URL for WebDriver BiDi connections to the browser session
+   */
+  webdriver_ws_url: string;
+
   /**
    * Remote URL for live viewing the browser session. Only available for non-headless
    * browsers.
@@ -598,7 +633,8 @@ export interface BrowserListResponse {
   deleted_at?: string;
 
   /**
-   * Whether the browser session has hardware-accelerated GPU rendering.
+   * Whether GPU acceleration is enabled for the browser session (only supported for
+   * headful sessions).
    */
   gpu?: boolean;
 
@@ -635,9 +671,13 @@ export interface BrowserListResponse {
 
   /**
    * Initial browser window size in pixels with optional refresh rate. If omitted,
-   * image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,
-   * but the following configurations are known-good and fully tested: 2560x1440@10,
-   * 1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60.
+   * image defaults apply (1920x1080@25). For GPU images, the default is
+   * 1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+   * Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+   * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+   * presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+   * 800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+   * 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
    * Viewports outside this list may exhibit unstable live view or recording
    * behavior. If refresh_rate is not provided, it will be automatically determined
    * based on the resolution (higher resolutions use lower refresh rates to keep
@@ -653,8 +693,8 @@ export interface BrowserCreateParams {
   extensions?: Array<Shared.BrowserExtension>;
 
   /**
-   * If true, launches a hardware-accelerated browser with GPU rendering. Requires
-   * Start-Up or Enterprise plan.
+   * If true, enables GPU acceleration for the browser session. Requires Start-Up or
+   * Enterprise plan and headless=false.
    */
   gpu?: boolean;
 
@@ -711,9 +751,13 @@ export interface BrowserCreateParams {
 
   /**
    * Initial browser window size in pixels with optional refresh rate. If omitted,
-   * image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,
-   * but the following configurations are known-good and fully tested: 2560x1440@10,
-   * 1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60.
+   * image defaults apply (1920x1080@25). For GPU images, the default is
+   * 1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+   * Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+   * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+   * presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+   * 800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+   * 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
    * Viewports outside this list may exhibit unstable live view or recording
    * behavior. If refresh_rate is not provided, it will be automatically determined
    * based on the resolution (higher resolutions use lower refresh rates to keep

package/src/resources/browsers/computer.ts

@@ -353,11 +353,23 @@ export namespace ComputerBatchParams {
        */
       delay?: number;
 
+      /**
+       * Target total duration in milliseconds for the entire drag movement when
+       * smooth=true. Omit for automatic timing based on total path length.
+       */
+      duration_ms?: number;
+
       /**
        * Modifier keys to hold during the drag
        */
       hold_keys?: Array<string>;
 
+      /**
+       * Use human-like Bezier curves between path waypoints instead of linear
+       * interpolation. When true, steps_per_segment and step_delay_ms are ignored.
+       */
+      smooth?: boolean;
+
       /**
        * Delay in milliseconds between relative steps while dragging (not the initial
        * delay).
@@ -431,12 +443,14 @@ export namespace ComputerBatchParams {
       y: number;
 
       /**
-       * Horizontal scroll amount. Positive scrolls right, negative scrolls left.
+       * Horizontal scroll amount in xdotool "wheel units." Positive scrolls right,
+       * negative scrolls left.
        */
       delta_x?: number;
 
       /**
-       * Vertical scroll amount. Positive scrolls down, negative scrolls up.
+       * Vertical scroll amount in xdotool "wheel units." Positive scrolls down, negative
+       * scrolls up.
        */
       delta_y?: number;
 
@@ -554,11 +568,23 @@ export interface ComputerDragMouseParams {
    */
   delay?: number;
 
+  /**
+   * Target total duration in milliseconds for the entire drag movement when
+   * smooth=true. Omit for automatic timing based on total path length.
+   */
+  duration_ms?: number;
+
   /**
    * Modifier keys to hold during the drag
    */
   hold_keys?: Array<string>;
 
+  /**
+   * Use human-like Bezier curves between path waypoints instead of linear
+   * interpolation. When true, steps_per_segment and step_delay_ms are ignored.
+   */
+  smooth?: boolean;
+
   /**
    * Delay in milliseconds between relative steps while dragging (not the initial
    * delay).
@@ -632,12 +658,14 @@ export interface ComputerScrollParams {
   y: number;
 
   /**
-   * Horizontal scroll amount. Positive scrolls right, negative scrolls left.
+   * Horizontal scroll amount in xdotool "wheel units." Positive scrolls right,
+   * negative scrolls left.
    */
   delta_x?: number;
 
   /**
-   * Vertical scroll amount. Positive scrolls down, negative scrolls up.
+   * Vertical scroll amount in xdotool "wheel units." Positive scrolls down, negative
+   * scrolls up.
    */
   delta_y?: number;
 

package/src/resources/invocations.ts

@@ -448,6 +448,11 @@ export namespace InvocationListBrowsersResponse {
      */
     timeout_seconds: number;
 
+    /**
+     * Websocket URL for WebDriver BiDi connections to the browser session
+     */
+    webdriver_ws_url: string;
+
     /**
      * Remote URL for live viewing the browser session. Only available for non-headless
      * browsers.
@@ -460,7 +465,8 @@ export namespace InvocationListBrowsersResponse {
     deleted_at?: string;
 
     /**
-     * Whether the browser session has hardware-accelerated GPU rendering.
+     * Whether GPU acceleration is enabled for the browser session (only supported for
+     * headful sessions).
      */
     gpu?: boolean;
 
@@ -497,9 +503,13 @@ export namespace InvocationListBrowsersResponse {
 
     /**
      * Initial browser window size in pixels with optional refresh rate. If omitted,
-     * image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,
-     * but the following configurations are known-good and fully tested: 2560x1440@10,
-     * 1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60.
+     * image defaults apply (1920x1080@25). For GPU images, the default is
+     * 1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+     * Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+     * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+     * presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+     * 800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+     * 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
      * Viewports outside this list may exhibit unstable live view or recording
      * behavior. If refresh_rate is not provided, it will be automatically determined
      * based on the resolution (higher resolutions use lower refresh rates to keep

package/src/resources/shared.ts

@@ -65,9 +65,13 @@ export interface BrowserProfile {
 
 /**
  * Initial browser window size in pixels with optional refresh rate. If omitted,
- * image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,
- * but the following configurations are known-good and fully tested: 2560x1440@10,
- * 1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60.
+ * image defaults apply (1920x1080@25). For GPU images, the default is
+ * 1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+ * Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+ * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+ * presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+ * 800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+ * 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
  * Viewports outside this list may exhibit unstable live view or recording
  * behavior. If refresh_rate is not provided, it will be automatically determined
  * based on the resolution (higher resolutions use lower refresh rates to keep

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.42.1'; // x-release-please-version
+export const VERSION = '0.44.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.42.1";
+export declare const VERSION = "0.44.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.42.1'; // x-release-please-version
+exports.VERSION = '0.44.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.42.1'; // x-release-please-version
+export const VERSION = '0.44.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map