@onkernel/sdk 0.54.0 → 0.57.0

package/src/resources/browsers/browsers.ts

@@ -51,6 +51,43 @@ 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,
+  BrowserTelemetryRequestConfig,
+  Telemetry,
+  TelemetryStreamParams,
+  TelemetryStreamResponse,
+} from './telemetry';
 import * as FsAPI from './fs/fs';
 import {
   FCreateDirectoryParams,
@@ -82,6 +119,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 +193,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 +265,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 +367,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 +390,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.
    */
@@ -394,10 +407,18 @@ export interface BrowserCreateResponse {
 
   /**
    * URL the session was asked to navigate to on creation, if any. Recorded for
-   * debugging — navigation is best-effort and may have failed.
+   * 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.
    */
@@ -467,6 +488,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.
    */
@@ -483,12 +511,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.
    */
@@ -506,10 +528,18 @@ export interface BrowserRetrieveResponse {
 
   /**
    * URL the session was asked to navigate to on creation, if any. Recorded for
-   * debugging — navigation is best-effort and may have failed.
+   * 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.
    */
@@ -579,6 +609,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.
    */
@@ -595,12 +632,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.
    */
@@ -618,10 +649,18 @@ export interface BrowserUpdateResponse {
 
   /**
    * URL the session was asked to navigate to on creation, if any. Recorded for
-   * debugging — navigation is best-effort and may have failed.
+   * 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.
    */
@@ -691,6 +730,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.
    */
@@ -707,12 +753,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.
    */
@@ -730,10 +770,18 @@ export interface BrowserListResponse {
 
   /**
    * URL the session was asked to navigate to on creation, if any. Recorded for
-   * debugging — navigation is best-effort and may have failed.
+   * 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.
    */
@@ -782,6 +830,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.
    */
@@ -810,12 +866,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.
@@ -830,11 +880,9 @@ export interface BrowserCreateParams {
   proxy_id?: string;
 
   /**
-   * Optional URL to navigate to immediately after the browser is created.
-   * Best-effort: failures to navigate do not fail browser creation. Any pre-existing
-   * tabs are reduced to a single tab which is then navigated. Accepts any URL
-   * Chromium can resolve, including chrome:// pages. Ignored when reusing an
-   * existing persistent session.
+   * Optional URL to open when the browser session is created. Navigation is
+   * best-effort, so navigation failures do not prevent the session from being
+   * created.
    */
   start_url?: string;
 
@@ -844,6 +892,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?: TelemetryAPI.BrowserTelemetryRequestConfig | null;
+
   /**
    * The number of seconds of inactivity before the browser session is terminated.
    * Activity includes CDP connections and live view connections. Defaults to 60
@@ -896,6 +953,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?: TelemetryAPI.BrowserTelemetryRequestConfig | null;
+
   /**
    * Viewport configuration to apply to the browser session.
    */
@@ -936,13 +1002,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).
@@ -997,6 +1056,7 @@ export namespace BrowserLoadExtensionsParams {
   }
 }
 
+Browsers.Telemetry = Telemetry;
 Browsers.Replays = Replays;
 Browsers.Fs = Fs;
 Browsers.Process = Process;
@@ -1006,7 +1066,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,
@@ -1020,11 +1079,47 @@ 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 {
+    Telemetry 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 BrowserTelemetryRequestConfig as BrowserTelemetryRequestConfig,
+    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,39 @@ 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 BrowserTelemetryRequestConfig,
+  type TelemetryStreamResponse,
+  type TelemetryStreamParams,
+} from './telemetry';