@onkernel/sdk 0.55.0 → 0.58.0

package/src/resources/browsers/browsers.ts

@@ -51,6 +51,42 @@ import {
   ReplayStopParams,
   Replays,
 } from './replays';
+import * as TelemetryAPI from './telemetry';
+import {
+  BrowserCallStack,
+  BrowserConsoleErrorEvent,
+  BrowserConsoleLogEvent,
+  BrowserEventContext,
+  BrowserEventSource,
+  BrowserHTTPHeaders,
+  BrowserInteractionClickEvent,
+  BrowserInteractionKeyEvent,
+  BrowserInteractionScrollSettledEvent,
+  BrowserMonitorDisconnectedEvent,
+  BrowserMonitorInitFailedEvent,
+  BrowserMonitorReconnectFailedEvent,
+  BrowserMonitorReconnectedEvent,
+  BrowserMonitorScreenshotEvent,
+  BrowserNetworkIdleEvent,
+  BrowserNetworkLoadingFailedEvent,
+  BrowserNetworkRequestEvent,
+  BrowserNetworkResponseEvent,
+  BrowserPageDomContentLoadedEvent,
+  BrowserPageLayoutSettledEvent,
+  BrowserPageLayoutShiftEvent,
+  BrowserPageLcpEvent,
+  BrowserPageLoadEvent,
+  BrowserPageNavigationEvent,
+  BrowserPageNavigationSettledEvent,
+  BrowserPageTabOpenedEvent,
+  BrowserTelemetryCategoriesConfig,
+  BrowserTelemetryCategoryConfig,
+  BrowserTelemetryConfig,
+  BrowserTelemetryEvent,
+  Telemetry as TelemetryAPITelemetry,
+  TelemetryStreamParams,
+  TelemetryStreamResponse,
+} from './telemetry';
 import * as FsAPI from './fs/fs';
 import {
   FCreateDirectoryParams,
@@ -82,6 +118,7 @@ import { browserFetch, type BrowserFetchInit } from '../../lib/browser-fetch';
  * Create and manage browser sessions.
  */
 export class Browsers extends APIResource {
+  telemetry: TelemetryAPI.Telemetry = new TelemetryAPI.Telemetry(this._client);
   replays: ReplaysAPI.Replays = new ReplaysAPI.Replays(this._client);
   fs: FsAPI.Fs = new FsAPI.Fs(this._client);
   process: ProcessAPI.Process = new ProcessAPI.Process(this._client);
@@ -155,21 +192,6 @@ export class Browsers extends APIResource {
     return this._client.getAPIList('/browsers', OffsetPagination<BrowserListResponse>, { query, ...options });
   }
 
-  /**
-   * DEPRECATED: Use DELETE /browsers/{id} instead. Delete a persistent browser
-   * session by its persistent_id.
-   *
-   * @deprecated
-   */
-  delete(params: BrowserDeleteParams, options?: RequestOptions): APIPromise<void> {
-    const { persistent_id } = params;
-    return this._client.delete('/browsers', {
-      query: { persistent_id },
-      ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
-    });
-  }
-
   /**
    * Sends an HTTP request through Chrome's HTTP request stack, inheriting the
    * browser's TLS fingerprint, cookies, proxy configuration, and headers. Returns a
@@ -242,17 +264,6 @@ export type BrowserListResponsesOffsetPagination = OffsetPagination<BrowserListR
 
 export type ProfilesOffsetPagination = OffsetPagination<Profile>;
 
-/**
- * @deprecated DEPRECATED: Use timeout_seconds (up to 72 hours) and Profiles
- * instead.
- */
-export interface BrowserPersistence {
-  /**
-   * DEPRECATED: Unique identifier for the persistent browser session.
-   */
-  id: string;
-}
-
 /**
  * Browser pool this session was acquired from, if any.
  */
@@ -355,6 +366,13 @@ export interface BrowserCreateResponse {
    */
   browser_live_view_url?: string;
 
+  /**
+   * Custom Chrome enterprise policy overrides that were applied to this browser
+   * session, if any. Echoed back for verification. Keys are Chrome enterprise policy
+   * names.
+   */
+  chrome_policy?: { [key: string]: unknown };
+
   /**
    * When the browser session was soft-deleted. Only present for deleted sessions.
    */
@@ -371,12 +389,6 @@ export interface BrowserCreateResponse {
    */
   kiosk_mode?: boolean;
 
-  /**
-   * @deprecated DEPRECATED: Use timeout_seconds (up to 72 hours) and Profiles
-   * instead.
-   */
-  persistence?: BrowserPersistence;
-
   /**
    * Browser pool this session was acquired from, if any.
    */
@@ -393,10 +405,19 @@ export interface BrowserCreateResponse {
   proxy_id?: string;
 
   /**
-   * Start URL requested for the session, if provided.
+   * URL the session was asked to navigate to on creation, if any. Recorded for
+   * debugging. Navigation is fire-and-forget — the URL is dispatched to the browser
+   * without waiting for it to load, and any errors (DNS failure, bad status,
+   * timeout) are silently dropped. Captures what was requested, not what the browser
+   * actually loaded.
    */
   start_url?: string;
 
+  /**
+   * Active telemetry configuration for the session, if any.
+   */
+  telemetry?: TelemetryAPI.BrowserTelemetryConfig | null;
+
   /**
    * Session usage metrics.
    */
@@ -466,6 +487,13 @@ export interface BrowserRetrieveResponse {
    */
   browser_live_view_url?: string;
 
+  /**
+   * Custom Chrome enterprise policy overrides that were applied to this browser
+   * session, if any. Echoed back for verification. Keys are Chrome enterprise policy
+   * names.
+   */
+  chrome_policy?: { [key: string]: unknown };
+
   /**
    * When the browser session was soft-deleted. Only present for deleted sessions.
    */
@@ -482,12 +510,6 @@ export interface BrowserRetrieveResponse {
    */
   kiosk_mode?: boolean;
 
-  /**
-   * @deprecated DEPRECATED: Use timeout_seconds (up to 72 hours) and Profiles
-   * instead.
-   */
-  persistence?: BrowserPersistence;
-
   /**
    * Browser pool this session was acquired from, if any.
    */
@@ -504,10 +526,19 @@ export interface BrowserRetrieveResponse {
   proxy_id?: string;
 
   /**
-   * Start URL requested for the session, if provided.
+   * URL the session was asked to navigate to on creation, if any. Recorded for
+   * debugging. Navigation is fire-and-forget — the URL is dispatched to the browser
+   * without waiting for it to load, and any errors (DNS failure, bad status,
+   * timeout) are silently dropped. Captures what was requested, not what the browser
+   * actually loaded.
    */
   start_url?: string;
 
+  /**
+   * Active telemetry configuration for the session, if any.
+   */
+  telemetry?: TelemetryAPI.BrowserTelemetryConfig | null;
+
   /**
    * Session usage metrics.
    */
@@ -577,6 +608,13 @@ export interface BrowserUpdateResponse {
    */
   browser_live_view_url?: string;
 
+  /**
+   * Custom Chrome enterprise policy overrides that were applied to this browser
+   * session, if any. Echoed back for verification. Keys are Chrome enterprise policy
+   * names.
+   */
+  chrome_policy?: { [key: string]: unknown };
+
   /**
    * When the browser session was soft-deleted. Only present for deleted sessions.
    */
@@ -593,12 +631,6 @@ export interface BrowserUpdateResponse {
    */
   kiosk_mode?: boolean;
 
-  /**
-   * @deprecated DEPRECATED: Use timeout_seconds (up to 72 hours) and Profiles
-   * instead.
-   */
-  persistence?: BrowserPersistence;
-
   /**
    * Browser pool this session was acquired from, if any.
    */
@@ -615,10 +647,19 @@ export interface BrowserUpdateResponse {
   proxy_id?: string;
 
   /**
-   * Start URL requested for the session, if provided.
+   * URL the session was asked to navigate to on creation, if any. Recorded for
+   * debugging. Navigation is fire-and-forget — the URL is dispatched to the browser
+   * without waiting for it to load, and any errors (DNS failure, bad status,
+   * timeout) are silently dropped. Captures what was requested, not what the browser
+   * actually loaded.
    */
   start_url?: string;
 
+  /**
+   * Active telemetry configuration for the session, if any.
+   */
+  telemetry?: TelemetryAPI.BrowserTelemetryConfig | null;
+
   /**
    * Session usage metrics.
    */
@@ -688,6 +729,13 @@ export interface BrowserListResponse {
    */
   browser_live_view_url?: string;
 
+  /**
+   * Custom Chrome enterprise policy overrides that were applied to this browser
+   * session, if any. Echoed back for verification. Keys are Chrome enterprise policy
+   * names.
+   */
+  chrome_policy?: { [key: string]: unknown };
+
   /**
    * When the browser session was soft-deleted. Only present for deleted sessions.
    */
@@ -704,12 +752,6 @@ export interface BrowserListResponse {
    */
   kiosk_mode?: boolean;
 
-  /**
-   * @deprecated DEPRECATED: Use timeout_seconds (up to 72 hours) and Profiles
-   * instead.
-   */
-  persistence?: BrowserPersistence;
-
   /**
    * Browser pool this session was acquired from, if any.
    */
@@ -726,10 +768,19 @@ export interface BrowserListResponse {
   proxy_id?: string;
 
   /**
-   * Start URL requested for the session, if provided.
+   * URL the session was asked to navigate to on creation, if any. Recorded for
+   * debugging. Navigation is fire-and-forget — the URL is dispatched to the browser
+   * without waiting for it to load, and any errors (DNS failure, bad status,
+   * timeout) are silently dropped. Captures what was requested, not what the browser
+   * actually loaded.
    */
   start_url?: string;
 
+  /**
+   * Active telemetry configuration for the session, if any.
+   */
+  telemetry?: TelemetryAPI.BrowserTelemetryConfig | null;
+
   /**
    * Session usage metrics.
    */
@@ -778,6 +829,14 @@ export interface BrowserCurlResponse {
 }
 
 export interface BrowserCreateParams {
+  /**
+   * Custom Chrome enterprise policy overrides applied to this browser session. Keys
+   * are Chrome enterprise policy names; values must match their expected types.
+   * Blocked: kernel-managed policies (extensions, proxy, CDP/automation). See
+   * https://chromeenterprise.google/policies/
+   */
+  chrome_policy?: { [key: string]: unknown };
+
   /**
    * List of browser extensions to load into the session. Provide each by id or name.
    */
@@ -806,12 +865,6 @@ export interface BrowserCreateParams {
    */
   kiosk_mode?: boolean;
 
-  /**
-   * @deprecated DEPRECATED: Use timeout_seconds (up to 72 hours) and Profiles
-   * instead.
-   */
-  persistence?: BrowserPersistence;
-
   /**
    * Profile selection for the browser session. Provide either id or name. If
    * specified, the matching profile will be loaded into the browser session.
@@ -838,6 +891,15 @@ export interface BrowserCreateParams {
    */
   stealth?: boolean;
 
+  /**
+   * Telemetry configuration for the browser session. Set enabled to true to start
+   * capture using VM defaults, or provide browser category settings. If omitted,
+   * null, set to an empty object ({}), set to enabled: false without browser
+   * category settings, or all four categories are explicitly disabled, capture is
+   * not started.
+   */
+  telemetry?: BrowserCreateParams.Telemetry | null;
+
   /**
    * The number of seconds of inactivity before the browser session is terminated.
    * Activity includes CDP connections and live view connections. Defaults to 60
@@ -864,6 +926,32 @@ export interface BrowserCreateParams {
   viewport?: Shared.BrowserViewport;
 }
 
+export namespace BrowserCreateParams {
+  /**
+   * Telemetry configuration for the browser session. Set enabled to true to start
+   * capture using VM defaults, or provide browser category settings. If omitted,
+   * null, set to an empty object ({}), set to enabled: false without browser
+   * category settings, or all four categories are explicitly disabled, capture is
+   * not started.
+   */
+  export interface Telemetry {
+    /**
+     * Per-category enable/disable flags. If enabled is true and browser is omitted or
+     * empty, the VM default category set is used. Explicitly disabling all four
+     * categories stops capture on update and starts no capture on create.
+     */
+    browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
+
+    /**
+     * Request shortcut for browser telemetry capture. True enables capture using VM
+     * defaults unless browser category settings are provided. False stops capture on
+     * update and starts no capture on create. enabled=false cannot be combined with
+     * browser category settings.
+     */
+    enabled?: boolean;
+  }
+}
+
 export interface BrowserRetrieveParams {
   /**
    * When true, includes soft-deleted browser sessions in the lookup.
@@ -890,6 +978,15 @@ export interface BrowserUpdateParams {
    */
   proxy_id?: string | null;
 
+  /**
+   * Telemetry configuration. Omit, set to null, or set to an empty object ({}) to
+   * leave the existing configuration unchanged. Set enabled to true to enable
+   * capture using VM defaults. Set enabled to false to stop capture. Provide browser
+   * category settings for per-category updates. Explicitly disabling all four
+   * categories also stops capture.
+   */
+  telemetry?: BrowserUpdateParams.Telemetry | null;
+
   /**
    * Viewport configuration to apply to the browser session.
    */
@@ -897,6 +994,30 @@ export interface BrowserUpdateParams {
 }
 
 export namespace BrowserUpdateParams {
+  /**
+   * Telemetry configuration. Omit, set to null, or set to an empty object ({}) to
+   * leave the existing configuration unchanged. Set enabled to true to enable
+   * capture using VM defaults. Set enabled to false to stop capture. Provide browser
+   * category settings for per-category updates. Explicitly disabling all four
+   * categories also stops capture.
+   */
+  export interface Telemetry {
+    /**
+     * Per-category enable/disable flags. If enabled is true and browser is omitted or
+     * empty, the VM default category set is used. Explicitly disabling all four
+     * categories stops capture on update and starts no capture on create.
+     */
+    browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
+
+    /**
+     * Request shortcut for browser telemetry capture. True enables capture using VM
+     * defaults unless browser category settings are provided. False stops capture on
+     * update and starts no capture on create. enabled=false cannot be combined with
+     * browser category settings.
+     */
+    enabled?: boolean;
+  }
+
   /**
    * Viewport configuration to apply to the browser session.
    */
@@ -930,13 +1051,6 @@ export interface BrowserListParams extends OffsetPaginationParams {
   status?: 'active' | 'deleted' | 'all';
 }
 
-export interface BrowserDeleteParams {
-  /**
-   * Persistent browser identifier
-   */
-  persistent_id: string;
-}
-
 export interface BrowserCurlParams {
   /**
    * Target URL (must be http or https).
@@ -991,6 +1105,7 @@ export namespace BrowserLoadExtensionsParams {
   }
 }
 
+Browsers.Telemetry = TelemetryAPITelemetry;
 Browsers.Replays = Replays;
 Browsers.Fs = Fs;
 Browsers.Process = Process;
@@ -1000,7 +1115,6 @@ Browsers.Playwright = Playwright;
 
 export declare namespace Browsers {
   export {
-    type BrowserPersistence as BrowserPersistence,
     type BrowserPoolRef as BrowserPoolRef,
     type BrowserUsage as BrowserUsage,
     type Profile as Profile,
@@ -1014,11 +1128,46 @@ export declare namespace Browsers {
     type BrowserRetrieveParams as BrowserRetrieveParams,
     type BrowserUpdateParams as BrowserUpdateParams,
     type BrowserListParams as BrowserListParams,
-    type BrowserDeleteParams as BrowserDeleteParams,
     type BrowserCurlParams as BrowserCurlParams,
     type BrowserLoadExtensionsParams as BrowserLoadExtensionsParams,
   };
 
+  export {
+    TelemetryAPITelemetry as Telemetry,
+    type BrowserCallStack as BrowserCallStack,
+    type BrowserConsoleErrorEvent as BrowserConsoleErrorEvent,
+    type BrowserConsoleLogEvent as BrowserConsoleLogEvent,
+    type BrowserEventContext as BrowserEventContext,
+    type BrowserEventSource as BrowserEventSource,
+    type BrowserHTTPHeaders as BrowserHTTPHeaders,
+    type BrowserInteractionClickEvent as BrowserInteractionClickEvent,
+    type BrowserInteractionKeyEvent as BrowserInteractionKeyEvent,
+    type BrowserInteractionScrollSettledEvent as BrowserInteractionScrollSettledEvent,
+    type BrowserMonitorDisconnectedEvent as BrowserMonitorDisconnectedEvent,
+    type BrowserMonitorInitFailedEvent as BrowserMonitorInitFailedEvent,
+    type BrowserMonitorReconnectFailedEvent as BrowserMonitorReconnectFailedEvent,
+    type BrowserMonitorReconnectedEvent as BrowserMonitorReconnectedEvent,
+    type BrowserMonitorScreenshotEvent as BrowserMonitorScreenshotEvent,
+    type BrowserNetworkIdleEvent as BrowserNetworkIdleEvent,
+    type BrowserNetworkLoadingFailedEvent as BrowserNetworkLoadingFailedEvent,
+    type BrowserNetworkRequestEvent as BrowserNetworkRequestEvent,
+    type BrowserNetworkResponseEvent as BrowserNetworkResponseEvent,
+    type BrowserPageDomContentLoadedEvent as BrowserPageDomContentLoadedEvent,
+    type BrowserPageLayoutSettledEvent as BrowserPageLayoutSettledEvent,
+    type BrowserPageLayoutShiftEvent as BrowserPageLayoutShiftEvent,
+    type BrowserPageLcpEvent as BrowserPageLcpEvent,
+    type BrowserPageLoadEvent as BrowserPageLoadEvent,
+    type BrowserPageNavigationEvent as BrowserPageNavigationEvent,
+    type BrowserPageNavigationSettledEvent as BrowserPageNavigationSettledEvent,
+    type BrowserPageTabOpenedEvent as BrowserPageTabOpenedEvent,
+    type BrowserTelemetryCategoriesConfig as BrowserTelemetryCategoriesConfig,
+    type BrowserTelemetryCategoryConfig as BrowserTelemetryCategoryConfig,
+    type BrowserTelemetryConfig as BrowserTelemetryConfig,
+    type BrowserTelemetryEvent as BrowserTelemetryEvent,
+    type TelemetryStreamResponse as TelemetryStreamResponse,
+    type TelemetryStreamParams as TelemetryStreamParams,
+  };
+
   export {
     Replays as Replays,
     type ReplayListResponse as ReplayListResponse,

package/src/resources/browsers/index.ts

@@ -2,7 +2,6 @@
 
 export {
   Browsers,
-  type BrowserPersistence,
   type BrowserPoolRef,
   type BrowserUsage,
   type Profile,
@@ -15,7 +14,6 @@ export {
   type BrowserRetrieveParams,
   type BrowserUpdateParams,
   type BrowserListParams,
-  type BrowserDeleteParams,
   type BrowserCurlParams,
   type BrowserLoadExtensionsParams,
   type ProfilesOffsetPagination,
@@ -81,3 +79,38 @@ export {
   type ReplayStartParams,
   type ReplayStopParams,
 } from './replays';
+export {
+  Telemetry,
+  type BrowserCallStack,
+  type BrowserConsoleErrorEvent,
+  type BrowserConsoleLogEvent,
+  type BrowserEventContext,
+  type BrowserEventSource,
+  type BrowserHTTPHeaders,
+  type BrowserInteractionClickEvent,
+  type BrowserInteractionKeyEvent,
+  type BrowserInteractionScrollSettledEvent,
+  type BrowserMonitorDisconnectedEvent,
+  type BrowserMonitorInitFailedEvent,
+  type BrowserMonitorReconnectFailedEvent,
+  type BrowserMonitorReconnectedEvent,
+  type BrowserMonitorScreenshotEvent,
+  type BrowserNetworkIdleEvent,
+  type BrowserNetworkLoadingFailedEvent,
+  type BrowserNetworkRequestEvent,
+  type BrowserNetworkResponseEvent,
+  type BrowserPageDomContentLoadedEvent,
+  type BrowserPageLayoutSettledEvent,
+  type BrowserPageLayoutShiftEvent,
+  type BrowserPageLcpEvent,
+  type BrowserPageLoadEvent,
+  type BrowserPageNavigationEvent,
+  type BrowserPageNavigationSettledEvent,
+  type BrowserPageTabOpenedEvent,
+  type BrowserTelemetryCategoriesConfig,
+  type BrowserTelemetryCategoryConfig,
+  type BrowserTelemetryConfig,
+  type BrowserTelemetryEvent,
+  type TelemetryStreamResponse,
+  type TelemetryStreamParams,
+} from './telemetry';