@onkernel/sdk 0.93.0 → 0.94.0

package/src/client.ts

@@ -136,6 +136,29 @@ import {
   ProxyUpdateParams,
   ProxyUpdateResponse,
 } from './resources/proxies';
+import {
+  Analysis,
+  AnalysisSummariesOffsetPagination,
+  AnalysisSummary,
+  Browser,
+  Evidence,
+  LookupRequest,
+  LookupResponse,
+  NoRecommendation,
+  Proxy,
+  Recommendation,
+  RecommendationResult,
+  RecommendationSummariesOffsetPagination,
+  RecommendationSummary,
+  ResolveRequest,
+  SiteConfigListParams,
+  SiteConfigListRecommendationsParams,
+  SiteConfigLookupParams,
+  SiteConfigResolveParams,
+  SiteConfigResponse,
+  SiteConfigs,
+  Target,
+} from './resources/site-configs';
 import {
   AuditLogEntriesPageTokenPagination,
   AuditLogEntry,
@@ -1012,6 +1035,10 @@ export class Kernel {
    * Invoke actions and stream or query invocation status and events.
    */
   invocations: API.Invocations = new API.Invocations(this);
+  /**
+   * Resolve browser and proxy recommendations for bot-protected sites.
+   */
+  siteConfigs: API.SiteConfigs = new API.SiteConfigs(this);
   /**
    * Create and manage browser sessions.
    */
@@ -1063,6 +1090,7 @@ export class Kernel {
 Kernel.Deployments = Deployments;
 Kernel.Apps = Apps;
 Kernel.Invocations = Invocations;
+Kernel.SiteConfigs = SiteConfigs;
 Kernel.Browsers = Browsers;
 Kernel.Profiles = Profiles;
 Kernel.Auth = Auth;
@@ -1128,6 +1156,30 @@ export declare namespace Kernel {
     type InvocationFollowParams as InvocationFollowParams,
   };
 
+  export {
+    SiteConfigs as SiteConfigs,
+    type Analysis as Analysis,
+    type AnalysisSummary as AnalysisSummary,
+    type Browser as Browser,
+    type Evidence as Evidence,
+    type LookupRequest as LookupRequest,
+    type LookupResponse as LookupResponse,
+    type NoRecommendation as NoRecommendation,
+    type Proxy as Proxy,
+    type Recommendation as Recommendation,
+    type RecommendationResult as RecommendationResult,
+    type RecommendationSummary as RecommendationSummary,
+    type ResolveRequest as ResolveRequest,
+    type SiteConfigResponse as SiteConfigResponse,
+    type Target as Target,
+    type AnalysisSummariesOffsetPagination as AnalysisSummariesOffsetPagination,
+    type RecommendationSummariesOffsetPagination as RecommendationSummariesOffsetPagination,
+    type SiteConfigListParams as SiteConfigListParams,
+    type SiteConfigListRecommendationsParams as SiteConfigListRecommendationsParams,
+    type SiteConfigLookupParams as SiteConfigLookupParams,
+    type SiteConfigResolveParams as SiteConfigResolveParams,
+  };
+
   export {
     Browsers as Browsers,
     type BrowserMemory as BrowserMemory,

package/src/lib/browser-routing.ts

@@ -1,4 +1,5 @@
 import type { Fetch, RequestInfo, RequestInit } from '../internal/builtin-types';
+import { CancelReadableStream } from '../internal/shims';
 import { joinURL } from './join-url';
 
 export type BrowserRoute = {
@@ -22,6 +23,15 @@ export class BrowserRouteCache {
     this.entries.delete(sessionId);
   }
 
+  deleteIfJwt(sessionId: string, jwt: string): boolean {
+    const route = this.entries.get(sessionId);
+    if (!route || route.jwt !== jwt) {
+      return false;
+    }
+    this.entries.delete(sessionId);
+    return true;
+  }
+
   clear(): void {
     this.entries.clear();
   }
@@ -31,7 +41,7 @@ const BROWSER_ROUTING_SUBRESOURCES_ENV = 'KERNEL_BROWSER_ROUTING_SUBRESOURCES';
 // Path prefixes eligible for direct-to-VM routing. "telemetry/stream" is the live
 // SSE endpoint (served by the VM); "telemetry/events" is a historical read served
 // by the control plane (S2) and must NOT be here.
-const DEFAULT_BROWSER_ROUTING_SUBRESOURCES = ['curl', 'telemetry/stream'];
+const DEFAULT_BROWSER_ROUTING_SUBRESOURCES = ['curl', 'telemetry/stream', 'computer', 'playwright'];
 const BROWSER_ROUTE_CACHEABLE_PATH = /^\/(?:v\d+\/)?browsers(?:\/[^/]+)?\/?$/;
 const BROWSER_POOL_ACQUIRE_PATH = /^\/(?:v\d+\/)?browser_pools\/[^/]+\/acquire\/?$/;
 const BROWSER_DELETE_BY_ID_PATH = /^\/(?:v\d+\/)?browsers\/([^/]+)\/?$/;
@@ -262,7 +272,13 @@ async function routeRequest(
 
   const headers = new Headers(request.headers);
   headers.delete('authorization');
-  return innerFetch(target.toString(), buildRoutedInit(input, request, init, headers));
+  const routed = await innerFetch(target.toString(), buildRoutedInit(input, request, init, headers));
+  if ((routed.status === 401 || routed.status === 403) && target.searchParams.get('jwt')) {
+    cache.deleteIfJwt(sessionId, target.searchParams.get('jwt') ?? '');
+    await CancelReadableStream(routed.body);
+    return innerFetch(input, init);
+  }
+  return routed;
 }
 
 function buildRoutedInit(

package/src/resources/auth/connections.ts

@@ -549,12 +549,12 @@ export namespace ManagedAuth {
      * Per-category capture flags. The operational categories (control, connection,
      * system, captcha) are captured whenever telemetry is enabled; set one to
      * enabled=false to opt out. The CDP categories (console, network, page,
-     * interaction) and screenshot are off by default; set enabled=true to opt in. On
-     * create, provided categories layer onto the default set. On update, provided
-     * categories merge onto the session's current config; when no telemetry is active
-     * this falls back to the default set (matching create). If browser is omitted or
-     * empty, the default set is used. A browser config that disables every category
-     * stops capture on update and starts no capture on create.
+     * interaction), screenshot and platform are off by default; set enabled=true to
+     * opt in. On create, provided categories layer onto the default set. On update,
+     * provided categories merge onto the session's current config; when no telemetry
+     * is active this falls back to the default set (matching create). If browser is
+     * omitted or empty, the default set is used. A browser config that disables every
+     * category stops capture on update and starts no capture on create.
      */
     browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
 
@@ -920,12 +920,12 @@ export namespace ManagedAuthBrowserConfig {
      * Per-category capture flags. The operational categories (control, connection,
      * system, captcha) are captured whenever telemetry is enabled; set one to
      * enabled=false to opt out. The CDP categories (console, network, page,
-     * interaction) and screenshot are off by default; set enabled=true to opt in. On
-     * create, provided categories layer onto the default set. On update, provided
-     * categories merge onto the session's current config; when no telemetry is active
-     * this falls back to the default set (matching create). If browser is omitted or
-     * empty, the default set is used. A browser config that disables every category
-     * stops capture on update and starts no capture on create.
+     * interaction), screenshot and platform are off by default; set enabled=true to
+     * opt in. On create, provided categories layer onto the default set. On update,
+     * provided categories merge onto the session's current config; when no telemetry
+     * is active this falls back to the default set (matching create). If browser is
+     * omitted or empty, the default set is used. A browser config that disables every
+     * category stops capture on update and starts no capture on create.
      */
     browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
 
@@ -1121,12 +1121,12 @@ export namespace ManagedAuthCreateRequest {
      * Per-category capture flags. The operational categories (control, connection,
      * system, captcha) are captured whenever telemetry is enabled; set one to
      * enabled=false to opt out. The CDP categories (console, network, page,
-     * interaction) and screenshot are off by default; set enabled=true to opt in. On
-     * create, provided categories layer onto the default set. On update, provided
-     * categories merge onto the session's current config; when no telemetry is active
-     * this falls back to the default set (matching create). If browser is omitted or
-     * empty, the default set is used. A browser config that disables every category
-     * stops capture on update and starts no capture on create.
+     * interaction), screenshot and platform are off by default; set enabled=true to
+     * opt in. On create, provided categories layer onto the default set. On update,
+     * provided categories merge onto the session's current config; when no telemetry
+     * is active this falls back to the default set (matching create). If browser is
+     * omitted or empty, the default set is used. A browser config that disables every
+     * category stops capture on update and starts no capture on create.
      */
     browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
 
@@ -1417,12 +1417,12 @@ export namespace ManagedAuthUpdateRequest {
      * Per-category capture flags. The operational categories (control, connection,
      * system, captcha) are captured whenever telemetry is enabled; set one to
      * enabled=false to opt out. The CDP categories (console, network, page,
-     * interaction) and screenshot are off by default; set enabled=true to opt in. On
-     * create, provided categories layer onto the default set. On update, provided
-     * categories merge onto the session's current config; when no telemetry is active
-     * this falls back to the default set (matching create). If browser is omitted or
-     * empty, the default set is used. A browser config that disables every category
-     * stops capture on update and starts no capture on create.
+     * interaction), screenshot and platform are off by default; set enabled=true to
+     * opt in. On create, provided categories layer onto the default set. On update,
+     * provided categories merge onto the session's current config; when no telemetry
+     * is active this falls back to the default set (matching create). If browser is
+     * omitted or empty, the default set is used. A browser config that disables every
+     * category stops capture on update and starts no capture on create.
      */
     browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
 
@@ -2072,12 +2072,12 @@ export namespace ConnectionCreateParams {
      * Per-category capture flags. The operational categories (control, connection,
      * system, captcha) are captured whenever telemetry is enabled; set one to
      * enabled=false to opt out. The CDP categories (console, network, page,
-     * interaction) and screenshot are off by default; set enabled=true to opt in. On
-     * create, provided categories layer onto the default set. On update, provided
-     * categories merge onto the session's current config; when no telemetry is active
-     * this falls back to the default set (matching create). If browser is omitted or
-     * empty, the default set is used. A browser config that disables every category
-     * stops capture on update and starts no capture on create.
+     * interaction), screenshot and platform are off by default; set enabled=true to
+     * opt in. On create, provided categories layer onto the default set. On update,
+     * provided categories merge onto the session's current config; when no telemetry
+     * is active this falls back to the default set (matching create). If browser is
+     * omitted or empty, the default set is used. A browser config that disables every
+     * category stops capture on update and starts no capture on create.
      */
     browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
 
@@ -2280,12 +2280,12 @@ export namespace ConnectionUpdateParams {
      * Per-category capture flags. The operational categories (control, connection,
      * system, captcha) are captured whenever telemetry is enabled; set one to
      * enabled=false to opt out. The CDP categories (console, network, page,
-     * interaction) and screenshot are off by default; set enabled=true to opt in. On
-     * create, provided categories layer onto the default set. On update, provided
-     * categories merge onto the session's current config; when no telemetry is active
-     * this falls back to the default set (matching create). If browser is omitted or
-     * empty, the default set is used. A browser config that disables every category
-     * stops capture on update and starts no capture on create.
+     * interaction), screenshot and platform are off by default; set enabled=true to
+     * opt in. On create, provided categories layer onto the default set. On update,
+     * provided categories merge onto the session's current config; when no telemetry
+     * is active this falls back to the default set (matching create). If browser is
+     * omitted or empty, the default set is used. A browser config that disables every
+     * category stops capture on update and starts no capture on create.
      */
     browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
 
@@ -2458,12 +2458,12 @@ export namespace ConnectionLoginParams {
      * Per-category capture flags. The operational categories (control, connection,
      * system, captcha) are captured whenever telemetry is enabled; set one to
      * enabled=false to opt out. The CDP categories (console, network, page,
-     * interaction) and screenshot are off by default; set enabled=true to opt in. On
-     * create, provided categories layer onto the default set. On update, provided
-     * categories merge onto the session's current config; when no telemetry is active
-     * this falls back to the default set (matching create). If browser is omitted or
-     * empty, the default set is used. A browser config that disables every category
-     * stops capture on update and starts no capture on create.
+     * interaction), screenshot and platform are off by default; set enabled=true to
+     * opt in. On create, provided categories layer onto the default set. On update,
+     * provided categories merge onto the session's current config; when no telemetry
+     * is active this falls back to the default set (matching create). If browser is
+     * omitted or empty, the default set is used. A browser config that disables every
+     * category stops capture on update and starts no capture on create.
      */
     browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
 

package/src/resources/browser-pools.ts

@@ -679,12 +679,12 @@ export namespace BrowserPoolCreateParams {
      * Per-category capture flags. The operational categories (control, connection,
      * system, captcha) are captured whenever telemetry is enabled; set one to
      * enabled=false to opt out. The CDP categories (console, network, page,
-     * interaction) and screenshot are off by default; set enabled=true to opt in. On
-     * create, provided categories layer onto the default set. On update, provided
-     * categories merge onto the session's current config; when no telemetry is active
-     * this falls back to the default set (matching create). If browser is omitted or
-     * empty, the default set is used. A browser config that disables every category
-     * stops capture on update and starts no capture on create.
+     * interaction), screenshot and platform are off by default; set enabled=true to
+     * opt in. On create, provided categories layer onto the default set. On update,
+     * provided categories merge onto the session's current config; when no telemetry
+     * is active this falls back to the default set (matching create). If browser is
+     * omitted or empty, the default set is used. A browser config that disables every
+     * category stops capture on update and starts no capture on create.
      */
     browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
 
@@ -930,12 +930,12 @@ export namespace BrowserPoolUpdateParams {
      * Per-category capture flags. The operational categories (control, connection,
      * system, captcha) are captured whenever telemetry is enabled; set one to
      * enabled=false to opt out. The CDP categories (console, network, page,
-     * interaction) and screenshot are off by default; set enabled=true to opt in. On
-     * create, provided categories layer onto the default set. On update, provided
-     * categories merge onto the session's current config; when no telemetry is active
-     * this falls back to the default set (matching create). If browser is omitted or
-     * empty, the default set is used. A browser config that disables every category
-     * stops capture on update and starts no capture on create.
+     * interaction), screenshot and platform are off by default; set enabled=true to
+     * opt in. On create, provided categories layer onto the default set. On update,
+     * provided categories merge onto the session's current config; when no telemetry
+     * is active this falls back to the default set (matching create). If browser is
+     * omitted or empty, the default set is used. A browser config that disables every
+     * category stops capture on update and starts no capture on create.
      */
     browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
 
@@ -1098,12 +1098,12 @@ export namespace BrowserPoolAcquireParams {
      * Per-category capture flags. The operational categories (control, connection,
      * system, captcha) are captured whenever telemetry is enabled; set one to
      * enabled=false to opt out. The CDP categories (console, network, page,
-     * interaction) and screenshot are off by default; set enabled=true to opt in. On
-     * create, provided categories layer onto the default set. On update, provided
-     * categories merge onto the session's current config; when no telemetry is active
-     * this falls back to the default set (matching create). If browser is omitted or
-     * empty, the default set is used. A browser config that disables every category
-     * stops capture on update and starts no capture on create.
+     * interaction), screenshot and platform are off by default; set enabled=true to
+     * opt in. On create, provided categories layer onto the default set. On update,
+     * provided categories merge onto the session's current config; when no telemetry
+     * is active this falls back to the default set (matching create). If browser is
+     * omitted or empty, the default set is used. A browser config that disables every
+     * category stops capture on update and starts no capture on create.
      */
     browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
 

package/src/resources/browsers/browsers.ts

@@ -56,6 +56,8 @@ import {
   BrowserAPICallEvent,
   BrowserCallStack,
   BrowserCaptchaSolveResultEvent,
+  BrowserCdpCommandEvent,
+  BrowserCdpCommandMethod,
   BrowserCdpConnectEvent,
   BrowserCdpDisconnectEvent,
   BrowserConsoleErrorEvent,
@@ -77,6 +79,7 @@ import {
   BrowserNetworkLoadingFailedEvent,
   BrowserNetworkRequestEvent,
   BrowserNetworkResponseEvent,
+  BrowserPageCrashedEvent,
   BrowserPageDomContentLoadedEvent,
   BrowserPageLayoutSettledEvent,
   BrowserPageLayoutShiftEvent,
@@ -85,12 +88,15 @@ import {
   BrowserPageNavigationEvent,
   BrowserPageNavigationSettledEvent,
   BrowserPageTabOpenedEvent,
+  BrowserPlatformAPICallEvent,
   BrowserProxyErrorEvent,
   BrowserServiceCrashedEvent,
   BrowserSystemOomKillEvent,
   BrowserTelemetryCategoriesConfig,
   BrowserTelemetryCategoryConfig,
+  BrowserTelemetryCdpControlConfig,
   BrowserTelemetryConfig,
+  BrowserTelemetryControlConfig,
   BrowserTelemetryEvent,
   BrowserTelemetryExportConfig,
   BrowserTelemetryOtlpExportConfig,
@@ -1130,7 +1136,7 @@ export interface BrowserCreateParams {
 
   /**
    * If true, enables GPU acceleration for the browser session. Requires Start-Up or
-   * Enterprise plan and headless=false.
+   * Enterprise plan, headless=false, and region=us-east.
    */
   gpu?: boolean;
 
@@ -1270,12 +1276,12 @@ export namespace BrowserCreateParams {
      * Per-category capture flags. The operational categories (control, connection,
      * system, captcha) are captured whenever telemetry is enabled; set one to
      * enabled=false to opt out. The CDP categories (console, network, page,
-     * interaction) and screenshot are off by default; set enabled=true to opt in. On
-     * create, provided categories layer onto the default set. On update, provided
-     * categories merge onto the session's current config; when no telemetry is active
-     * this falls back to the default set (matching create). If browser is omitted or
-     * empty, the default set is used. A browser config that disables every category
-     * stops capture on update and starts no capture on create.
+     * interaction), screenshot and platform are off by default; set enabled=true to
+     * opt in. On create, provided categories layer onto the default set. On update,
+     * provided categories merge onto the session's current config; when no telemetry
+     * is active this falls back to the default set (matching create). If browser is
+     * omitted or empty, the default set is used. A browser config that disables every
+     * category stops capture on update and starts no capture on create.
      */
     browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
 
@@ -1428,12 +1434,12 @@ export namespace BrowserUpdateParams {
      * Per-category capture flags. The operational categories (control, connection,
      * system, captcha) are captured whenever telemetry is enabled; set one to
      * enabled=false to opt out. The CDP categories (console, network, page,
-     * interaction) and screenshot are off by default; set enabled=true to opt in. On
-     * create, provided categories layer onto the default set. On update, provided
-     * categories merge onto the session's current config; when no telemetry is active
-     * this falls back to the default set (matching create). If browser is omitted or
-     * empty, the default set is used. A browser config that disables every category
-     * stops capture on update and starts no capture on create.
+     * interaction), screenshot and platform are off by default; set enabled=true to
+     * opt in. On create, provided categories layer onto the default set. On update,
+     * provided categories merge onto the session's current config; when no telemetry
+     * is active this falls back to the default set (matching create). If browser is
+     * omitted or empty, the default set is used. A browser config that disables every
+     * category stops capture on update and starts no capture on create.
      */
     browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
 
@@ -1645,6 +1651,8 @@ export declare namespace Browsers {
     type BrowserAPICallEvent as BrowserAPICallEvent,
     type BrowserCallStack as BrowserCallStack,
     type BrowserCaptchaSolveResultEvent as BrowserCaptchaSolveResultEvent,
+    type BrowserCdpCommandEvent as BrowserCdpCommandEvent,
+    type BrowserCdpCommandMethod as BrowserCdpCommandMethod,
     type BrowserCdpConnectEvent as BrowserCdpConnectEvent,
     type BrowserCdpDisconnectEvent as BrowserCdpDisconnectEvent,
     type BrowserConsoleErrorEvent as BrowserConsoleErrorEvent,
@@ -1666,6 +1674,7 @@ export declare namespace Browsers {
     type BrowserNetworkLoadingFailedEvent as BrowserNetworkLoadingFailedEvent,
     type BrowserNetworkRequestEvent as BrowserNetworkRequestEvent,
     type BrowserNetworkResponseEvent as BrowserNetworkResponseEvent,
+    type BrowserPageCrashedEvent as BrowserPageCrashedEvent,
     type BrowserPageDomContentLoadedEvent as BrowserPageDomContentLoadedEvent,
     type BrowserPageLayoutSettledEvent as BrowserPageLayoutSettledEvent,
     type BrowserPageLayoutShiftEvent as BrowserPageLayoutShiftEvent,
@@ -1674,12 +1683,15 @@ export declare namespace Browsers {
     type BrowserPageNavigationEvent as BrowserPageNavigationEvent,
     type BrowserPageNavigationSettledEvent as BrowserPageNavigationSettledEvent,
     type BrowserPageTabOpenedEvent as BrowserPageTabOpenedEvent,
+    type BrowserPlatformAPICallEvent as BrowserPlatformAPICallEvent,
     type BrowserProxyErrorEvent as BrowserProxyErrorEvent,
     type BrowserServiceCrashedEvent as BrowserServiceCrashedEvent,
     type BrowserSystemOomKillEvent as BrowserSystemOomKillEvent,
     type BrowserTelemetryCategoriesConfig as BrowserTelemetryCategoriesConfig,
     type BrowserTelemetryCategoryConfig as BrowserTelemetryCategoryConfig,
+    type BrowserTelemetryCdpControlConfig as BrowserTelemetryCdpControlConfig,
     type BrowserTelemetryConfig as BrowserTelemetryConfig,
+    type BrowserTelemetryControlConfig as BrowserTelemetryControlConfig,
     type BrowserTelemetryEvent as BrowserTelemetryEvent,
     type BrowserTelemetryExportConfig as BrowserTelemetryExportConfig,
     type BrowserTelemetryOtlpExportConfig as BrowserTelemetryOtlpExportConfig,

package/src/resources/browsers/index.ts

@@ -91,6 +91,8 @@ export {
   type BrowserAPICallEvent,
   type BrowserCallStack,
   type BrowserCaptchaSolveResultEvent,
+  type BrowserCdpCommandEvent,
+  type BrowserCdpCommandMethod,
   type BrowserCdpConnectEvent,
   type BrowserCdpDisconnectEvent,
   type BrowserConsoleErrorEvent,
@@ -112,6 +114,7 @@ export {
   type BrowserNetworkLoadingFailedEvent,
   type BrowserNetworkRequestEvent,
   type BrowserNetworkResponseEvent,
+  type BrowserPageCrashedEvent,
   type BrowserPageDomContentLoadedEvent,
   type BrowserPageLayoutSettledEvent,
   type BrowserPageLayoutShiftEvent,
@@ -120,12 +123,15 @@ export {
   type BrowserPageNavigationEvent,
   type BrowserPageNavigationSettledEvent,
   type BrowserPageTabOpenedEvent,
+  type BrowserPlatformAPICallEvent,
   type BrowserProxyErrorEvent,
   type BrowserServiceCrashedEvent,
   type BrowserSystemOomKillEvent,
   type BrowserTelemetryCategoriesConfig,
   type BrowserTelemetryCategoryConfig,
+  type BrowserTelemetryCdpControlConfig,
   type BrowserTelemetryConfig,
+  type BrowserTelemetryControlConfig,
   type BrowserTelemetryEvent,
   type BrowserTelemetryExportConfig,
   type BrowserTelemetryOtlpExportConfig,