@onkernel/sdk 0.19.1 → 0.20.0

package/src/resources/browsers/browsers.ts

@@ -1,7 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
-import * as BrowsersAPI from './browsers';
 import * as ComputerAPI from './computer';
 import {
   Computer,
@@ -63,6 +62,7 @@ import {
   Fs,
 } from './fs/fs';
 import { APIPromise } from '../../core/api-promise';
+import { OffsetPagination, type OffsetPaginationParams, PagePromise } from '../../core/pagination';
 import { type Uploadable } from '../../core/uploads';
 import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
@@ -107,15 +107,22 @@ export class Browsers extends APIResource {
   }
 
   /**
-   * List active browser sessions
+   * List all browser sessions with pagination support. Use include_deleted=true to
+   * include soft-deleted sessions in the results.
    *
    * @example
    * ```ts
-   * const browsers = await client.browsers.list();
+   * // Automatically fetches more pages as needed.
+   * for await (const browserListResponse of client.browsers.list()) {
+   *   // ...
+   * }
    * ```
    */
-  list(options?: RequestOptions): APIPromise<BrowserListResponse> {
-    return this._client.get('/browsers', options);
+  list(
+    query: BrowserListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<BrowserListResponsesOffsetPagination, BrowserListResponse> {
+    return this._client.getAPIList('/browsers', OffsetPagination<BrowserListResponse>, { query, ...options });
   }
 
   /**
@@ -181,6 +188,8 @@ export class Browsers extends APIResource {
   }
 }
 
+export type BrowserListResponsesOffsetPagination = OffsetPagination<BrowserListResponse>;
+
 /**
  * Optional persistence configuration for the browser session.
  */
@@ -258,6 +267,11 @@ export interface BrowserCreateResponse {
    */
   browser_live_view_url?: string;
 
+  /**
+   * When the browser session was soft-deleted. Only present for deleted sessions.
+   */
+  deleted_at?: string;
+
   /**
    * Whether the browser session is running in kiosk mode.
    */
@@ -358,6 +372,11 @@ export interface BrowserRetrieveResponse {
    */
   browser_live_view_url?: string;
 
+  /**
+   * When the browser session was soft-deleted. Only present for deleted sessions.
+   */
+  deleted_at?: string;
+
   /**
    * Whether the browser session is running in kiosk mode.
    */
@@ -421,107 +440,108 @@ export namespace BrowserRetrieveResponse {
   }
 }
 
-export type BrowserListResponse = Array<BrowserListResponse.BrowserListResponseItem>;
+export interface BrowserListResponse {
+  /**
+   * Websocket URL for Chrome DevTools Protocol connections to the browser session
+   */
+  cdp_ws_url: string;
 
-export namespace BrowserListResponse {
-  export interface BrowserListResponseItem {
-    /**
-     * Websocket URL for Chrome DevTools Protocol connections to the browser session
-     */
-    cdp_ws_url: string;
+  /**
+   * When the browser session was created.
+   */
+  created_at: string;
 
-    /**
-     * When the browser session was created.
-     */
-    created_at: string;
+  /**
+   * Whether the browser session is running in headless mode.
+   */
+  headless: boolean;
 
-    /**
-     * Whether the browser session is running in headless mode.
-     */
-    headless: boolean;
+  /**
+   * Unique identifier for the browser session
+   */
+  session_id: string;
 
-    /**
-     * Unique identifier for the browser session
-     */
-    session_id: string;
+  /**
+   * Whether the browser session is running in stealth mode.
+   */
+  stealth: boolean;
 
-    /**
-     * Whether the browser session is running in stealth mode.
-     */
-    stealth: boolean;
+  /**
+   * The number of seconds of inactivity before the browser session is terminated.
+   */
+  timeout_seconds: number;
 
-    /**
-     * The number of seconds of inactivity before the browser session is terminated.
-     */
-    timeout_seconds: number;
+  /**
+   * Remote URL for live viewing the browser session. Only available for non-headless
+   * browsers.
+   */
+  browser_live_view_url?: string;
 
-    /**
-     * Remote URL for live viewing the browser session. Only available for non-headless
-     * browsers.
-     */
-    browser_live_view_url?: string;
+  /**
+   * When the browser session was soft-deleted. Only present for deleted sessions.
+   */
+  deleted_at?: string;
 
-    /**
-     * Whether the browser session is running in kiosk mode.
-     */
-    kiosk_mode?: boolean;
+  /**
+   * Whether the browser session is running in kiosk mode.
+   */
+  kiosk_mode?: boolean;
 
-    /**
-     * Optional persistence configuration for the browser session.
-     */
-    persistence?: BrowsersAPI.BrowserPersistence;
+  /**
+   * Optional persistence configuration for the browser session.
+   */
+  persistence?: BrowserPersistence;
 
-    /**
-     * Browser profile metadata.
-     */
-    profile?: BrowsersAPI.Profile;
+  /**
+   * Browser profile metadata.
+   */
+  profile?: Profile;
+
+  /**
+   * ID of the proxy associated with this browser session, if any.
+   */
+  proxy_id?: string;
+
+  /**
+   * Initial browser window size in pixels with optional refresh rate. If omitted,
+   * image defaults apply (commonly 1024x768@60). Only specific viewport
+   * configurations are supported. The server will reject unsupported combinations.
+   * Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+   * 1440x900@25, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will
+   * be automatically determined from the width and height if they match a supported
+   * configuration exactly. Note: Higher resolutions may affect the responsiveness of
+   * live view browser
+   */
+  viewport?: BrowserListResponse.Viewport;
+}
 
+export namespace BrowserListResponse {
+  /**
+   * Initial browser window size in pixels with optional refresh rate. If omitted,
+   * image defaults apply (commonly 1024x768@60). Only specific viewport
+   * configurations are supported. The server will reject unsupported combinations.
+   * Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+   * 1440x900@25, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will
+   * be automatically determined from the width and height if they match a supported
+   * configuration exactly. Note: Higher resolutions may affect the responsiveness of
+   * live view browser
+   */
+  export interface Viewport {
     /**
-     * ID of the proxy associated with this browser session, if any.
+     * Browser window height in pixels.
      */
-    proxy_id?: string;
+    height: number;
 
     /**
-     * Initial browser window size in pixels with optional refresh rate. If omitted,
-     * image defaults apply (commonly 1024x768@60). Only specific viewport
-     * configurations are supported. The server will reject unsupported combinations.
-     * Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-     * 1440x900@25, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will
-     * be automatically determined from the width and height if they match a supported
-     * configuration exactly. Note: Higher resolutions may affect the responsiveness of
-     * live view browser
+     * Browser window width in pixels.
      */
-    viewport?: BrowserListResponseItem.Viewport;
-  }
+    width: number;
 
-  export namespace BrowserListResponseItem {
     /**
-     * Initial browser window size in pixels with optional refresh rate. If omitted,
-     * image defaults apply (commonly 1024x768@60). Only specific viewport
-     * configurations are supported. The server will reject unsupported combinations.
-     * Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-     * 1440x900@25, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will
-     * be automatically determined from the width and height if they match a supported
-     * configuration exactly. Note: Higher resolutions may affect the responsiveness of
-     * live view browser
+     * Display refresh rate in Hz. If omitted, automatically determined from width and
+     * height.
      */
-    export interface Viewport {
-      /**
-       * Browser window height in pixels.
-       */
-      height: number;
-
-      /**
-       * Browser window width in pixels.
-       */
-      width: number;
-
-      /**
-       * Display refresh rate in Hz. If omitted, automatically determined from width and
-       * height.
-       */
-      refresh_rate?: number;
-    }
+    refresh_rate?: number;
   }
 }
 
@@ -576,7 +596,7 @@ export interface BrowserCreateParams {
    * The number of seconds of inactivity before the browser session is terminated.
    * Only applicable to non-persistent browsers. Activity includes CDP connections
    * and live view connections. Defaults to 60 seconds. Minimum allowed is 10
-   * seconds. Maximum allowed is 86400 (24 hours). We check for inactivity every 5
+   * seconds. Maximum allowed is 259200 (72 hours). We check for inactivity every 5
    * seconds, so the actual timeout behavior you will see is +/- 5 seconds around the
    * specified value.
    */
@@ -666,6 +686,14 @@ export namespace BrowserCreateParams {
   }
 }
 
+export interface BrowserListParams extends OffsetPaginationParams {
+  /**
+   * When true, includes soft-deleted browser sessions in the results alongside
+   * active sessions.
+   */
+  include_deleted?: boolean;
+}
+
 export interface BrowserDeleteParams {
   /**
    * Persistent browser identifier
@@ -709,7 +737,9 @@ export declare namespace Browsers {
     type BrowserCreateResponse as BrowserCreateResponse,
     type BrowserRetrieveResponse as BrowserRetrieveResponse,
     type BrowserListResponse as BrowserListResponse,
+    type BrowserListResponsesOffsetPagination as BrowserListResponsesOffsetPagination,
     type BrowserCreateParams as BrowserCreateParams,
+    type BrowserListParams as BrowserListParams,
     type BrowserDeleteParams as BrowserDeleteParams,
     type BrowserLoadExtensionsParams as BrowserLoadExtensionsParams,
   };

package/src/resources/browsers/index.ts

@@ -8,8 +8,10 @@ export {
   type BrowserRetrieveResponse,
   type BrowserListResponse,
   type BrowserCreateParams,
+  type BrowserListParams,
   type BrowserDeleteParams,
   type BrowserLoadExtensionsParams,
+  type BrowserListResponsesOffsetPagination,
 } from './browsers';
 export {
   Computer,

package/src/resources/index.ts

@@ -15,8 +15,10 @@ export {
   type BrowserRetrieveResponse,
   type BrowserListResponse,
   type BrowserCreateParams,
+  type BrowserListParams,
   type BrowserDeleteParams,
   type BrowserLoadExtensionsParams,
+  type BrowserListResponsesOffsetPagination,
 } from './browsers/browsers';
 export {
   Deployments,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.19.1'; // x-release-please-version
+export const VERSION = '0.20.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.19.1";
+export declare const VERSION = "0.20.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.19.1'; // x-release-please-version
+exports.VERSION = '0.20.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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