@onkernel/sdk 0.93.0 → 0.95.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,13 @@ 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',
+  'process',
+];
 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 +278,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

@@ -261,8 +261,10 @@ export interface ManagedAuth {
   status: 'AUTHENTICATED' | 'NEEDS_AUTH';
 
   /**
-   * Additional domains that are valid for this auth flow (besides the primary
-   * domain). Useful when login pages redirect to different domains.
+   * Additional hostname roots valid for this auth flow, besides the primary domain.
+   * Each value allows credential entry on that exact hostname and its subdomains.
+   * Leading `www.` and `*.` labels are normalized away. When omitted or empty,
+   * credential entry is unrestricted.
    *
    * The following SSO/OAuth provider domains are automatically allowed by default
    * and do not need to be specified:
@@ -549,12 +551,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 +922,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;
 
@@ -1016,8 +1018,10 @@ export interface ManagedAuthCreateRequest {
   profile_name: string;
 
   /**
-   * Additional domains valid for this auth flow (besides the primary domain). Useful
-   * when login pages redirect to different domains.
+   * Additional hostname roots valid for this auth flow, besides the primary domain.
+   * Each value allows credential entry on that exact hostname and its subdomains.
+   * Leading `www.` and `*.` labels are normalized away. When omitted or empty,
+   * credential entry is unrestricted.
    *
    * The following SSO/OAuth provider domains are automatically allowed by default
    * and do not need to be specified:
@@ -1121,12 +1125,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;
 
@@ -1336,7 +1340,10 @@ export interface ManagedAuthTimelineEvent {
  */
 export interface ManagedAuthUpdateRequest {
   /**
-   * Additional domains valid for this auth flow (replaces existing list)
+   * Additional hostname roots valid for this auth flow. Each value allows credential
+   * entry on that exact hostname and its subdomains; leading `www.` and `*.` labels
+   * are normalized away. An empty list leaves credential entry unrestricted.
+   * Replaces the existing list.
    */
   allowed_domains?: Array<string>;
 
@@ -1417,12 +1424,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;
 
@@ -1967,8 +1974,10 @@ export interface ConnectionCreateParams {
   profile_name: string;
 
   /**
-   * Additional domains valid for this auth flow (besides the primary domain). Useful
-   * when login pages redirect to different domains.
+   * Additional hostname roots valid for this auth flow, besides the primary domain.
+   * Each value allows credential entry on that exact hostname and its subdomains.
+   * Leading `www.` and `*.` labels are normalized away. When omitted or empty,
+   * credential entry is unrestricted.
    *
    * The following SSO/OAuth provider domains are automatically allowed by default
    * and do not need to be specified:
@@ -2072,12 +2081,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;
 
@@ -2199,7 +2208,10 @@ export namespace ConnectionCreateParams {
 
 export interface ConnectionUpdateParams {
   /**
-   * Additional domains valid for this auth flow (replaces existing list)
+   * Additional hostname roots valid for this auth flow. Each value allows credential
+   * entry on that exact hostname and its subdomains; leading `www.` and `*.` labels
+   * are normalized away. An empty list leaves credential entry unrestricted.
+   * Replaces the existing list.
    */
   allowed_domains?: Array<string>;
 
@@ -2280,12 +2292,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 +2470,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

@@ -199,7 +199,7 @@ export interface BrowserPool {
   /**
    * Geographic region of the browser pool. Fixed once the pool is created.
    */
-  region: 'us-east' | 'eu-west';
+  region: 'us-east' | 'eu-west' | 'ap-southeast';
 
   /**
    * Browser pool name, if set
@@ -382,7 +382,7 @@ export interface BrowserPoolAcquireResponse {
   /**
    * Geographic region of the browser session. Fixed once the session is created.
    */
-  region: 'us-east' | 'eu-west';
+  region: 'us-east' | 'eu-west' | 'ap-southeast';
 
   /**
    * Unique identifier for the browser session
@@ -595,7 +595,7 @@ export interface BrowserPoolCreateParams {
    * Region selection requires a Start-Up or Enterprise plan, defaults to us-east
    * when omitted on create.
    */
-  region?: 'us-east' | 'eu-west';
+  region?: 'us-east' | 'eu-west' | 'ap-southeast';
 
   /**
    * Optional URL to navigate to when a new browser is warmed into the pool.
@@ -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;
 
@@ -1028,7 +1028,7 @@ export interface BrowserPoolListParams extends OffsetPaginationParams {
   /**
    * Filter pools by geographic region. Omit to list pools in all regions.
    */
-  region?: 'us-east' | 'eu-west';
+  region?: 'us-east' | 'eu-west' | 'ap-southeast';
 }
 
 export interface BrowserPoolDeleteParams {
@@ -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,
@@ -252,8 +258,8 @@ export class Browsers extends APIResource {
   }
 
   /**
-   * Loads one or more unpacked extensions and restarts Chromium on the browser
-   * instance.
+   * Loads one or more unpacked extensions using live CDP activation when eligible.
+   * Chromium restarts when enterprise policy requires it or live activation fails.
    *
    * @example
    * ```ts
@@ -473,7 +479,7 @@ export interface BrowserCreateResponse {
   /**
    * Geographic region of the browser session. Fixed once the session is created.
    */
-  region: 'us-east' | 'eu-west';
+  region: 'us-east' | 'eu-west' | 'ap-southeast';
 
   /**
    * Unique identifier for the browser session
@@ -633,7 +639,7 @@ export interface BrowserRetrieveResponse {
   /**
    * Geographic region of the browser session. Fixed once the session is created.
    */
-  region: 'us-east' | 'eu-west';
+  region: 'us-east' | 'eu-west' | 'ap-southeast';
 
   /**
    * Unique identifier for the browser session
@@ -793,7 +799,7 @@ export interface BrowserUpdateResponse {
   /**
    * Geographic region of the browser session. Fixed once the session is created.
    */
-  region: 'us-east' | 'eu-west';
+  region: 'us-east' | 'eu-west' | 'ap-southeast';
 
   /**
    * Unique identifier for the browser session
@@ -953,7 +959,7 @@ export interface BrowserListResponse {
   /**
    * Geographic region of the browser session. Fixed once the session is created.
    */
-  region: 'us-east' | 'eu-west';
+  region: 'us-east' | 'eu-west' | 'ap-southeast';
 
   /**
    * Unique identifier for the browser session
@@ -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;
 
@@ -1197,7 +1203,7 @@ export interface BrowserCreateParams {
    * created. Region selection requires a Start-Up or Enterprise plan, defaults to
    * us-east when omitted on create.
    */
-  region?: 'us-east' | 'eu-west';
+  region?: 'us-east' | 'eu-west' | 'ap-southeast';
 
   /**
    * Optional URL to open when the browser session is created. Navigation is
@@ -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;
 
@@ -1536,7 +1542,7 @@ export interface BrowserListParams extends OffsetPaginationParams {
   /**
    * Filter sessions by geographic region. Omit to list sessions in all regions.
    */
-  region?: 'us-east' | 'eu-west';
+  region?: 'us-east' | 'eu-west' | 'ap-southeast';
 
   /**
    * Filter sessions by status. "active" returns only active sessions (default),
@@ -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,