@onkernel/sdk 0.43.0 → 0.45.0

package/src/resources/auth/connections.ts

@@ -44,6 +44,21 @@ export class Connections extends APIResource {
     return this._client.get(path`/auth/connections/${id}`, options);
   }
 
+  /**
+   * Update an auth connection's configuration. Only the fields provided will be
+   * updated.
+   *
+   * @example
+   * ```ts
+   * const managedAuth = await client.auth.connections.update(
+   *   'id',
+   * );
+   * ```
+   */
+  update(id: string, body: ConnectionUpdateParams, options?: RequestOptions): APIPromise<ManagedAuth> {
+    return this._client.patch(path`/auth/connections/${id}`, { body, ...options });
+  }
+
   /**
    * List auth connections with optional filters for profile_name and domain.
    *
@@ -340,6 +355,12 @@ export interface ManagedAuth {
    */
   proxy_id?: string;
 
+  /**
+   * Non-MFA choices presented during the auth flow, such as account selection or org
+   * pickers (present when flow_step=awaiting_input).
+   */
+  sign_in_options?: Array<ManagedAuth.SignInOption> | null;
+
   /**
    * SSO provider being used (e.g., google, github, microsoft)
    */
@@ -467,6 +488,27 @@ export namespace ManagedAuth {
      */
     selector: string;
   }
+
+  /**
+   * A non-MFA choice presented during the auth flow (e.g. account selection, org
+   * picker)
+   */
+  export interface SignInOption {
+    /**
+     * Unique identifier for this option (used to submit selection back)
+     */
+    id: string;
+
+    /**
+     * Display text for the option
+     */
+    label: string;
+
+    /**
+     * Additional context such as email address or org name
+     */
+    description?: string | null;
+  }
 }
 
 /**
@@ -588,8 +630,96 @@ export namespace ManagedAuthCreateRequest {
 }
 
 /**
- * Request to submit field values, click an SSO button, or select an MFA method.
- * Provide exactly one of fields, sso_button_selector, or mfa_option_id.
+ * Request to update an auth connection's configuration
+ */
+export interface ManagedAuthUpdateRequest {
+  /**
+   * Additional domains valid for this auth flow (replaces existing list)
+   */
+  allowed_domains?: Array<string>;
+
+  /**
+   * Reference to credentials for the auth connection. Use one of:
+   *
+   * - { name } for Kernel credentials
+   * - { provider, path } for external provider item
+   * - { provider, auto: true } for external provider domain lookup
+   */
+  credential?: ManagedAuthUpdateRequest.Credential;
+
+  /**
+   * Interval in seconds between automatic health checks
+   */
+  health_check_interval?: number;
+
+  /**
+   * Login page URL. Set to empty string to clear.
+   */
+  login_url?: string;
+
+  /**
+   * Proxy selection. Provide either id or name. The proxy must belong to the
+   * caller's org.
+   */
+  proxy?: ManagedAuthUpdateRequest.Proxy;
+
+  /**
+   * Whether to save credentials after every successful login
+   */
+  save_credentials?: boolean;
+}
+
+export namespace ManagedAuthUpdateRequest {
+  /**
+   * Reference to credentials for the auth connection. Use one of:
+   *
+   * - { name } for Kernel credentials
+   * - { provider, path } for external provider item
+   * - { provider, auto: true } for external provider domain lookup
+   */
+  export interface Credential {
+    /**
+     * If true, lookup by domain from the specified provider
+     */
+    auto?: boolean;
+
+    /**
+     * Kernel credential name
+     */
+    name?: string;
+
+    /**
+     * Provider-specific path (e.g., "VaultName/ItemName" for 1Password)
+     */
+    path?: string;
+
+    /**
+     * External provider name (e.g., "my-1p")
+     */
+    provider?: string;
+  }
+
+  /**
+   * Proxy selection. Provide either id or name. The proxy must belong to the
+   * caller's org.
+   */
+  export interface Proxy {
+    /**
+     * Proxy ID
+     */
+    id?: string;
+
+    /**
+     * Proxy name
+     */
+    name?: string;
+  }
+}
+
+/**
+ * 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.
  */
 export interface SubmitFieldsRequest {
   /**
@@ -598,14 +728,26 @@ export interface SubmitFieldsRequest {
   fields?: { [key: string]: string };
 
   /**
-   * Optional MFA option ID if user selected an MFA method
+   * The MFA method type to select (when mfa_options were returned)
    */
   mfa_option_id?: string;
 
   /**
-   * Optional XPath selector if user chose to click an SSO button instead
+   * The sign-in option ID to select (when sign_in_options were returned)
+   */
+  sign_in_option_id?: string;
+
+  /**
+   * XPath selector for the SSO button to click (ODA). Use sso_provider instead for
+   * CUA.
    */
   sso_button_selector?: string;
+
+  /**
+   * SSO provider to click, matching the provider field from pending_sso_buttons
+   * (e.g., "google", "github"). Cannot be used with sso_button_selector.
+   */
+  sso_provider?: string;
 }
 
 /**
@@ -703,6 +845,12 @@ export namespace ConnectionFollowResponse {
      */
     post_login_url?: string;
 
+    /**
+     * Non-MFA choices presented during the auth flow, such as account selection or org
+     * pickers (present when flow_step=AWAITING_INPUT).
+     */
+    sign_in_options?: Array<ManagedAuthStateEvent.SignInOption>;
+
     /**
      * Visible error message from the website (e.g., 'Incorrect password'). Present
      * when the website displays an error during login.
@@ -796,6 +944,27 @@ export namespace ConnectionFollowResponse {
        */
       selector: string;
     }
+
+    /**
+     * A non-MFA choice presented during the auth flow (e.g. account selection, org
+     * picker)
+     */
+    export interface SignInOption {
+      /**
+       * Unique identifier for this option (used to submit selection back)
+       */
+      id: string;
+
+      /**
+       * Display text for the option
+       */
+      label: string;
+
+      /**
+       * Additional context such as email address or org name
+       */
+      description?: string | null;
+    }
   }
 }
 
@@ -914,6 +1083,90 @@ export namespace ConnectionCreateParams {
   }
 }
 
+export interface ConnectionUpdateParams {
+  /**
+   * Additional domains valid for this auth flow (replaces existing list)
+   */
+  allowed_domains?: Array<string>;
+
+  /**
+   * Reference to credentials for the auth connection. Use one of:
+   *
+   * - { name } for Kernel credentials
+   * - { provider, path } for external provider item
+   * - { provider, auto: true } for external provider domain lookup
+   */
+  credential?: ConnectionUpdateParams.Credential;
+
+  /**
+   * Interval in seconds between automatic health checks
+   */
+  health_check_interval?: number;
+
+  /**
+   * Login page URL. Set to empty string to clear.
+   */
+  login_url?: string;
+
+  /**
+   * Proxy selection. Provide either id or name. The proxy must belong to the
+   * caller's org.
+   */
+  proxy?: ConnectionUpdateParams.Proxy;
+
+  /**
+   * Whether to save credentials after every successful login
+   */
+  save_credentials?: boolean;
+}
+
+export namespace ConnectionUpdateParams {
+  /**
+   * Reference to credentials for the auth connection. Use one of:
+   *
+   * - { name } for Kernel credentials
+   * - { provider, path } for external provider item
+   * - { provider, auto: true } for external provider domain lookup
+   */
+  export interface Credential {
+    /**
+     * If true, lookup by domain from the specified provider
+     */
+    auto?: boolean;
+
+    /**
+     * Kernel credential name
+     */
+    name?: string;
+
+    /**
+     * Provider-specific path (e.g., "VaultName/ItemName" for 1Password)
+     */
+    path?: string;
+
+    /**
+     * External provider name (e.g., "my-1p")
+     */
+    provider?: string;
+  }
+
+  /**
+   * Proxy selection. Provide either id or name. The proxy must belong to the
+   * caller's org.
+   */
+  export interface Proxy {
+    /**
+     * Proxy ID
+     */
+    id?: string;
+
+    /**
+     * Proxy name
+     */
+    name?: string;
+  }
+}
+
 export interface ConnectionListParams extends OffsetPaginationParams {
   /**
    * Filter by domain
@@ -959,14 +1212,26 @@ export interface ConnectionSubmitParams {
   fields?: { [key: string]: string };
 
   /**
-   * Optional MFA option ID if user selected an MFA method
+   * The MFA method type to select (when mfa_options were returned)
    */
   mfa_option_id?: string;
 
   /**
-   * Optional XPath selector if user chose to click an SSO button instead
+   * The sign-in option ID to select (when sign_in_options were returned)
+   */
+  sign_in_option_id?: string;
+
+  /**
+   * XPath selector for the SSO button to click (ODA). Use sso_provider instead for
+   * CUA.
    */
   sso_button_selector?: string;
+
+  /**
+   * SSO provider to click, matching the provider field from pending_sso_buttons
+   * (e.g., "google", "github"). Cannot be used with sso_button_selector.
+   */
+  sso_provider?: string;
 }
 
 export declare namespace Connections {
@@ -974,11 +1239,13 @@ export declare namespace Connections {
     type LoginResponse as LoginResponse,
     type ManagedAuth as ManagedAuth,
     type ManagedAuthCreateRequest as ManagedAuthCreateRequest,
+    type ManagedAuthUpdateRequest as ManagedAuthUpdateRequest,
     type SubmitFieldsRequest as SubmitFieldsRequest,
     type SubmitFieldsResponse as SubmitFieldsResponse,
     type ConnectionFollowResponse as ConnectionFollowResponse,
     type ManagedAuthsOffsetPagination as ManagedAuthsOffsetPagination,
     type ConnectionCreateParams as ConnectionCreateParams,
+    type ConnectionUpdateParams as ConnectionUpdateParams,
     type ConnectionListParams as ConnectionListParams,
     type ConnectionLoginParams as ConnectionLoginParams,
     type ConnectionSubmitParams as ConnectionSubmitParams,

package/src/resources/auth/index.ts

@@ -6,10 +6,12 @@ export {
   type LoginResponse,
   type ManagedAuth,
   type ManagedAuthCreateRequest,
+  type ManagedAuthUpdateRequest,
   type SubmitFieldsRequest,
   type SubmitFieldsResponse,
   type ConnectionFollowResponse,
   type ConnectionCreateParams,
+  type ConnectionUpdateParams,
   type ConnectionListParams,
   type ConnectionLoginParams,
   type ConnectionSubmitParams,

package/src/resources/browser-pools.ts

@@ -190,6 +190,14 @@ export namespace BrowserPool {
      */
     size: number;
 
+    /**
+     * Custom Chrome enterprise policy overrides applied to all browsers in this pool.
+     * 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.
      */
@@ -243,9 +251,13 @@ export namespace BrowserPool {
 
     /**
      * Initial browser window size in pixels with optional refresh rate. If omitted,
-     * image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,
-     * but the following configurations are known-good and fully tested: 2560x1440@10,
-     * 1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60.
+     * image defaults apply (1920x1080@25). For GPU images, the default is
+     * 1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+     * Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+     * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+     * presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+     * 800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+     * 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
      * Viewports outside this list may exhibit unstable live view or recording
      * behavior. If refresh_rate is not provided, it will be automatically determined
      * based on the resolution (higher resolutions use lower refresh rates to keep
@@ -305,7 +317,8 @@ export interface BrowserPoolAcquireResponse {
   deleted_at?: string;
 
   /**
-   * Whether the browser session has hardware-accelerated GPU rendering.
+   * Whether GPU acceleration is enabled for the browser session (only supported for
+   * headful sessions).
    */
   gpu?: boolean;
 
@@ -342,9 +355,13 @@ export interface BrowserPoolAcquireResponse {
 
   /**
    * Initial browser window size in pixels with optional refresh rate. If omitted,
-   * image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,
-   * but the following configurations are known-good and fully tested: 2560x1440@10,
-   * 1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60.
+   * image defaults apply (1920x1080@25). For GPU images, the default is
+   * 1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+   * Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+   * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+   * presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+   * 800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+   * 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
    * Viewports outside this list may exhibit unstable live view or recording
    * behavior. If refresh_rate is not provided, it will be automatically determined
    * based on the resolution (higher resolutions use lower refresh rates to keep
@@ -361,6 +378,14 @@ export interface BrowserPoolCreateParams {
    */
   size: number;
 
+  /**
+   * Custom Chrome enterprise policy overrides applied to all browsers in this pool.
+   * 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.
    */
@@ -414,9 +439,13 @@ export interface BrowserPoolCreateParams {
 
   /**
    * Initial browser window size in pixels with optional refresh rate. If omitted,
-   * image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,
-   * but the following configurations are known-good and fully tested: 2560x1440@10,
-   * 1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60.
+   * image defaults apply (1920x1080@25). For GPU images, the default is
+   * 1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+   * Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+   * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+   * presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+   * 800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+   * 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
    * Viewports outside this list may exhibit unstable live view or recording
    * behavior. If refresh_rate is not provided, it will be automatically determined
    * based on the resolution (higher resolutions use lower refresh rates to keep
@@ -433,6 +462,14 @@ export interface BrowserPoolUpdateParams {
    */
   size: number;
 
+  /**
+   * Custom Chrome enterprise policy overrides applied to all browsers in this pool.
+   * 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 };
+
   /**
    * Whether to discard all idle browsers and rebuild the pool immediately. Defaults
    * to false.
@@ -492,9 +529,13 @@ export interface BrowserPoolUpdateParams {
 
   /**
    * Initial browser window size in pixels with optional refresh rate. If omitted,
-   * image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,
-   * but the following configurations are known-good and fully tested: 2560x1440@10,
-   * 1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60.
+   * image defaults apply (1920x1080@25). For GPU images, the default is
+   * 1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+   * Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+   * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+   * presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+   * 800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+   * 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
    * Viewports outside this list may exhibit unstable live view or recording
    * behavior. If refresh_rate is not provided, it will be automatically determined
    * based on the resolution (higher resolutions use lower refresh rates to keep

package/src/resources/browsers/browsers.ts

@@ -330,7 +330,8 @@ export interface BrowserCreateResponse {
   deleted_at?: string;
 
   /**
-   * Whether the browser session has hardware-accelerated GPU rendering.
+   * Whether GPU acceleration is enabled for the browser session (only supported for
+   * headful sessions).
    */
   gpu?: boolean;
 
@@ -367,9 +368,13 @@ export interface BrowserCreateResponse {
 
   /**
    * Initial browser window size in pixels with optional refresh rate. If omitted,
-   * image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,
-   * but the following configurations are known-good and fully tested: 2560x1440@10,
-   * 1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60.
+   * image defaults apply (1920x1080@25). For GPU images, the default is
+   * 1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+   * Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+   * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+   * presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+   * 800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+   * 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
    * Viewports outside this list may exhibit unstable live view or recording
    * behavior. If refresh_rate is not provided, it will be automatically determined
    * based on the resolution (higher resolutions use lower refresh rates to keep
@@ -426,7 +431,8 @@ export interface BrowserRetrieveResponse {
   deleted_at?: string;
 
   /**
-   * Whether the browser session has hardware-accelerated GPU rendering.
+   * Whether GPU acceleration is enabled for the browser session (only supported for
+   * headful sessions).
    */
   gpu?: boolean;
 
@@ -463,9 +469,13 @@ export interface BrowserRetrieveResponse {
 
   /**
    * Initial browser window size in pixels with optional refresh rate. If omitted,
-   * image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,
-   * but the following configurations are known-good and fully tested: 2560x1440@10,
-   * 1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60.
+   * image defaults apply (1920x1080@25). For GPU images, the default is
+   * 1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+   * Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+   * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+   * presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+   * 800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+   * 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
    * Viewports outside this list may exhibit unstable live view or recording
    * behavior. If refresh_rate is not provided, it will be automatically determined
    * based on the resolution (higher resolutions use lower refresh rates to keep
@@ -522,7 +532,8 @@ export interface BrowserUpdateResponse {
   deleted_at?: string;
 
   /**
-   * Whether the browser session has hardware-accelerated GPU rendering.
+   * Whether GPU acceleration is enabled for the browser session (only supported for
+   * headful sessions).
    */
   gpu?: boolean;
 
@@ -559,9 +570,13 @@ export interface BrowserUpdateResponse {
 
   /**
    * Initial browser window size in pixels with optional refresh rate. If omitted,
-   * image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,
-   * but the following configurations are known-good and fully tested: 2560x1440@10,
-   * 1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60.
+   * image defaults apply (1920x1080@25). For GPU images, the default is
+   * 1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+   * Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+   * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+   * presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+   * 800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+   * 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
    * Viewports outside this list may exhibit unstable live view or recording
    * behavior. If refresh_rate is not provided, it will be automatically determined
    * based on the resolution (higher resolutions use lower refresh rates to keep
@@ -618,7 +633,8 @@ export interface BrowserListResponse {
   deleted_at?: string;
 
   /**
-   * Whether the browser session has hardware-accelerated GPU rendering.
+   * Whether GPU acceleration is enabled for the browser session (only supported for
+   * headful sessions).
    */
   gpu?: boolean;
 
@@ -655,9 +671,13 @@ export interface BrowserListResponse {
 
   /**
    * Initial browser window size in pixels with optional refresh rate. If omitted,
-   * image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,
-   * but the following configurations are known-good and fully tested: 2560x1440@10,
-   * 1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60.
+   * image defaults apply (1920x1080@25). For GPU images, the default is
+   * 1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+   * Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+   * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+   * presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+   * 800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+   * 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
    * Viewports outside this list may exhibit unstable live view or recording
    * behavior. If refresh_rate is not provided, it will be automatically determined
    * based on the resolution (higher resolutions use lower refresh rates to keep
@@ -673,8 +693,8 @@ export interface BrowserCreateParams {
   extensions?: Array<Shared.BrowserExtension>;
 
   /**
-   * If true, launches a hardware-accelerated browser with GPU rendering. Requires
-   * Start-Up or Enterprise plan.
+   * If true, enables GPU acceleration for the browser session. Requires Start-Up or
+   * Enterprise plan and headless=false.
    */
   gpu?: boolean;
 
@@ -731,9 +751,13 @@ export interface BrowserCreateParams {
 
   /**
    * Initial browser window size in pixels with optional refresh rate. If omitted,
-   * image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,
-   * but the following configurations are known-good and fully tested: 2560x1440@10,
-   * 1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60.
+   * image defaults apply (1920x1080@25). For GPU images, the default is
+   * 1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
+   * Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+   * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
+   * presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
+   * 800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
+   * 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
    * Viewports outside this list may exhibit unstable live view or recording
    * behavior. If refresh_rate is not provided, it will be automatically determined
    * based on the resolution (higher resolutions use lower refresh rates to keep
@@ -750,6 +774,12 @@ export interface BrowserRetrieveParams {
 }
 
 export interface BrowserUpdateParams {
+  /**
+   * If true, stealth browsers connect directly instead of using the default stealth
+   * proxy.
+   */
+  disable_default_proxy?: boolean;
+
   /**
    * Profile to load into the browser session. Only allowed if the session does not
    * already have a profile loaded.