@onkernel/sdk 0.78.1 → 0.80.0

package/src/resources/auth/connections.ts

@@ -352,6 +352,12 @@ export interface ManagedAuth {
     | 'requires_sms_code'
     | 'requires_email_code';
 
+  /**
+   * Canonical choices awaiting selection. Prefer this over pending_sso_buttons,
+   * mfa_options, and sign_in_options when present.
+   */
+  choices?: Array<ManagedAuth.Choice> | null;
+
   /**
    * Reference to credentials for the auth connection. Use one of:
    *
@@ -383,6 +389,12 @@ export interface ManagedAuth {
    */
   external_action_message?: string | null;
 
+  /**
+   * Canonical fields awaiting input. Prefer this over discovered_fields when
+   * present.
+   */
+  fields?: Array<ManagedAuth.Field> | null;
+
   /**
    * When the current flow expires (null when no flow in progress). A flow past this
    * timestamp is no longer valid and its `flow_status` will be `EXPIRED`. Clients
@@ -503,6 +515,43 @@ export interface ManagedAuth {
 }
 
 export namespace ManagedAuth {
+  /**
+   * Canonical auth-flow choice awaiting user selection.
+   */
+  export interface Choice {
+    /**
+     * Stable choice identifier for canonical submit.
+     */
+    id: string;
+
+    /**
+     * Human-readable choice label.
+     */
+    label: string;
+
+    /**
+     * Choice type.
+     */
+    type:
+      | 'mfa_method'
+      | 'sso_provider'
+      | 'sign_in_method'
+      | 'auth_method'
+      | 'identifier_method'
+      | 'account'
+      | 'other';
+
+    /**
+     * Additional context for the choice.
+     */
+    description?: string | null;
+
+    /**
+     * Selector for the visible choice, when available.
+     */
+    observed_selector?: string | null;
+  }
+
   /**
    * Reference to credentials for the auth connection. Use one of:
    *
@@ -579,6 +628,41 @@ export namespace ManagedAuth {
     required?: boolean;
   }
 
+  /**
+   * Canonical field awaiting user input.
+   */
+  export interface Field {
+    /**
+     * Stable field identifier for canonical submit.
+     */
+    id: string;
+
+    /**
+     * Credential reference name to store the submitted value under.
+     */
+    ref: string;
+
+    /**
+     * Managed-auth field type.
+     */
+    type: 'identifier' | 'password' | 'code' | 'totp_code' | 'totp_secret' | 'text';
+
+    /**
+     * Human-readable label shown to the user.
+     */
+    label?: string;
+
+    /**
+     * Selector for the visible field, when available.
+     */
+    observed_selector?: string | null;
+
+    /**
+     * Whether this field is required.
+     */
+    required?: boolean;
+  }
+
   /**
    * An MFA method option for verification
    */
@@ -825,6 +909,11 @@ export interface ManagedAuthTimelineEvent {
    */
   type: 'login' | 'reauth' | 'health_check';
 
+  /**
+   * Browser session that produced the event, if one was created.
+   */
+  browser_session_id?: string;
+
   /**
    * Machine-readable error code. Present when a login/reauth event failed.
    */
@@ -989,10 +1078,17 @@ export namespace ManagedAuthUpdateRequest {
 
 /**
  * Request to submit field values, click an SSO button, select an MFA method, or
- * select a sign-in option. Provide exactly one of fields, sso_button_selector,
- * sso_provider, mfa_option_id, or sign_in_option_id.
+ * select a sign-in option. Prefer canonical selected_choice_id/field_values when
+ * the API returns fields/choices; legacy
+ * fields/sso_button_selector/sso_provider/mfa_option_id/sign_in_option_id remain
+ * supported during deprecation.
  */
 export interface SubmitFieldsRequest {
+  /**
+   * Canonical map of field ID to submitted value.
+   */
+  field_values?: { [key: string]: string };
+
   /**
    * Map of field name to value
    */
@@ -1003,6 +1099,11 @@ export interface SubmitFieldsRequest {
    */
   mfa_option_id?: string;
 
+  /**
+   * Canonical choice ID selected by the user.
+   */
+  selected_choice_id?: string;
+
   /**
    * The sign-in option ID to select (when sign_in_options were returned)
    */
@@ -1064,6 +1165,12 @@ export namespace ConnectionFollowResponse {
      */
     timestamp: string;
 
+    /**
+     * Canonical choices awaiting selection. Prefer this over pending_sso_buttons,
+     * mfa_options, and sign_in_options when present.
+     */
+    choices?: Array<ManagedAuthStateEvent.Choice>;
+
     /**
      * Fields awaiting input (present when flow_step=AWAITING_INPUT; may also be
      * present with AWAITING_EXTERNAL_ACTION as fallback actions).
@@ -1086,6 +1193,12 @@ export namespace ConnectionFollowResponse {
      */
     external_action_message?: string;
 
+    /**
+     * Canonical fields awaiting input. Prefer this over discovered_fields when
+     * present.
+     */
+    fields?: Array<ManagedAuthStateEvent.Field>;
+
     /**
      * Type of the current flow.
      */
@@ -1133,6 +1246,43 @@ export namespace ConnectionFollowResponse {
   }
 
   export namespace ManagedAuthStateEvent {
+    /**
+     * Canonical auth-flow choice awaiting user selection.
+     */
+    export interface Choice {
+      /**
+       * Stable choice identifier for canonical submit.
+       */
+      id: string;
+
+      /**
+       * Human-readable choice label.
+       */
+      label: string;
+
+      /**
+       * Choice type.
+       */
+      type:
+        | 'mfa_method'
+        | 'sso_provider'
+        | 'sign_in_method'
+        | 'auth_method'
+        | 'identifier_method'
+        | 'account'
+        | 'other';
+
+      /**
+       * Additional context for the choice.
+       */
+      description?: string | null;
+
+      /**
+       * Selector for the visible choice, when available.
+       */
+      observed_selector?: string | null;
+    }
+
     /**
      * A discovered form field
      */
@@ -1180,6 +1330,41 @@ export namespace ConnectionFollowResponse {
       required?: boolean;
     }
 
+    /**
+     * Canonical field awaiting user input.
+     */
+    export interface Field {
+      /**
+       * Stable field identifier for canonical submit.
+       */
+      id: string;
+
+      /**
+       * Credential reference name to store the submitted value under.
+       */
+      ref: string;
+
+      /**
+       * Managed-auth field type.
+       */
+      type: 'identifier' | 'password' | 'code' | 'totp_code' | 'totp_secret' | 'text';
+
+      /**
+       * Human-readable label shown to the user.
+       */
+      label?: string;
+
+      /**
+       * Selector for the visible field, when available.
+       */
+      observed_selector?: string | null;
+
+      /**
+       * Whether this field is required.
+       */
+      required?: boolean;
+    }
+
     /**
      * An MFA method option for verification
      */
@@ -1562,6 +1747,11 @@ export namespace ConnectionLoginParams {
 }
 
 export interface ConnectionSubmitParams {
+  /**
+   * Canonical map of field ID to submitted value.
+   */
+  field_values?: { [key: string]: string };
+
   /**
    * Map of field name to value
    */
@@ -1572,6 +1762,11 @@ export interface ConnectionSubmitParams {
    */
   mfa_option_id?: string;
 
+  /**
+   * Canonical choice ID selected by the user.
+   */
+  selected_choice_id?: string;
+
   /**
    * The sign-in option ID to select (when sign_in_options were returned)
    */

package/src/resources/browser-pools.ts

@@ -295,6 +295,12 @@ export namespace BrowserPool {
      */
     stealth?: boolean;
 
+    /**
+     * Active telemetry configuration applied to browsers warmed into this pool, if
+     * any.
+     */
+    telemetry?: TelemetryAPI.BrowserTelemetryConfig | null;
+
     /**
      * Default idle timeout in seconds for browsers acquired from this pool before they
      * are destroyed. Minimum 10, maximum 259200 (72 hours).
@@ -555,6 +561,16 @@ export interface BrowserPoolCreateParams {
    */
   stealth?: boolean;
 
+  /**
+   * Telemetry configuration applied to browsers warmed into this pool. Set enabled
+   * to true to start capture using the default set, or provide browser category
+   * settings. If omitted, null, set to an empty object ({}), set to enabled: false
+   * without browser category settings, or all four CDP categories are explicitly
+   * disabled, no telemetry is configured on the pool. Only applied to newly-warmed
+   * browsers.
+   */
+  telemetry?: BrowserPoolCreateParams.Telemetry | null;
+
   /**
    * Default idle timeout in seconds for browsers acquired from this pool before they
    * are destroyed. Defaults to 600 seconds. Minimum 10, maximum 259200 (72 hours).
@@ -598,6 +614,41 @@ export namespace BrowserPoolCreateParams {
      */
     name?: string;
   }
+
+  /**
+   * Telemetry configuration applied to browsers warmed into this pool. Set enabled
+   * to true to start capture using the default set, or provide browser category
+   * settings. If omitted, null, set to an empty object ({}), set to enabled: false
+   * without browser category settings, or all four CDP categories are explicitly
+   * disabled, no telemetry is configured on the pool. Only applied to newly-warmed
+   * browsers.
+   */
+  export interface Telemetry {
+    /**
+     * 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.
+     */
+    browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
+
+    /**
+     * Request shortcut for browser telemetry capture. True enables capture; with no
+     * browser category settings it captures the default set (control, connection,
+     * system, captcha), and any browser category settings are layered onto that
+     * default set. On update, enabled=true resolves the config fresh from the default
+     * set plus any provided categories, replacing the session's current selection
+     * rather than merging onto it; omit enabled to merge categories onto the current
+     * selection instead. False stops capture on update and starts no capture on
+     * create. enabled=false cannot be combined with browser category settings.
+     */
+    enabled?: boolean;
+  }
 }
 
 export interface BrowserPoolUpdateParams {
@@ -693,6 +744,17 @@ export interface BrowserPoolUpdateParams {
    */
   stealth?: boolean;
 
+  /**
+   * If provided, updates the pool's 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 the default set. Set enabled to false to
+   * clear the pool's telemetry. Provide browser category settings for per-category
+   * updates, merged onto the pool's current configuration. Only applied to browsers
+   * warmed after the update; browsers already in the pool keep their configuration
+   * until discarded.
+   */
+  telemetry?: BrowserPoolUpdateParams.Telemetry | null;
+
   /**
    * If provided, replaces the default idle timeout in seconds for browsers acquired
    * from this pool before they are destroyed. Minimum 10, maximum 259200 (72 hours).
@@ -736,6 +798,42 @@ export namespace BrowserPoolUpdateParams {
      */
     name?: string;
   }
+
+  /**
+   * If provided, updates the pool's 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 the default set. Set enabled to false to
+   * clear the pool's telemetry. Provide browser category settings for per-category
+   * updates, merged onto the pool's current configuration. Only applied to browsers
+   * warmed after the update; browsers already in the pool keep their configuration
+   * until discarded.
+   */
+  export interface Telemetry {
+    /**
+     * 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.
+     */
+    browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
+
+    /**
+     * Request shortcut for browser telemetry capture. True enables capture; with no
+     * browser category settings it captures the default set (control, connection,
+     * system, captcha), and any browser category settings are layered onto that
+     * default set. On update, enabled=true resolves the config fresh from the default
+     * set plus any provided categories, replacing the session's current selection
+     * rather than merging onto it; omit enabled to merge categories onto the current
+     * selection instead. False stops capture on update and starts no capture on
+     * create. enabled=false cannot be combined with browser category settings.
+     */
+    enabled?: boolean;
+  }
 }
 
 export interface BrowserPoolListParams extends OffsetPaginationParams {
@@ -791,6 +889,57 @@ export interface BrowserPoolAcquireParams {
    * the browser is released back to the pool. Up to 50 pairs.
    */
   tags?: BrowsersAPI.Tags;
+
+  /**
+   * Telemetry override for the acquired browser, applied to this lease only. Merges
+   * onto the browser's current (pool-inherited) telemetry using the same
+   * per-category semantics as PATCH /browsers: provided categories override the
+   * current configuration, omitted categories are inherited. Set enabled to true to
+   * resolve the config fresh from the default set, or enabled to false to stop
+   * capture. When the browser is released back to the pool with reuse, its telemetry
+   * is reset to the pool's baseline, so the override does not carry over to the next
+   * lease.
+   */
+  telemetry?: BrowserPoolAcquireParams.Telemetry | null;
+}
+
+export namespace BrowserPoolAcquireParams {
+  /**
+   * Telemetry override for the acquired browser, applied to this lease only. Merges
+   * onto the browser's current (pool-inherited) telemetry using the same
+   * per-category semantics as PATCH /browsers: provided categories override the
+   * current configuration, omitted categories are inherited. Set enabled to true to
+   * resolve the config fresh from the default set, or enabled to false to stop
+   * capture. When the browser is released back to the pool with reuse, its telemetry
+   * is reset to the pool's baseline, so the override does not carry over to the next
+   * lease.
+   */
+  export interface Telemetry {
+    /**
+     * 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.
+     */
+    browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
+
+    /**
+     * Request shortcut for browser telemetry capture. True enables capture; with no
+     * browser category settings it captures the default set (control, connection,
+     * system, captcha), and any browser category settings are layered onto that
+     * default set. On update, enabled=true resolves the config fresh from the default
+     * set plus any provided categories, replacing the session's current selection
+     * rather than merging onto it; omit enabled to merge categories onto the current
+     * selection instead. False stops capture on update and starts no capture on
+     * create. enabled=false cannot be combined with browser category settings.
+     */
+    enabled?: boolean;
+  }
 }
 
 export interface BrowserPoolReleaseParams {

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.78.1'; // x-release-please-version
+export const VERSION = '0.80.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.78.1";
+export declare const VERSION = "0.80.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.78.1'; // x-release-please-version
+exports.VERSION = '0.80.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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