@onkernel/sdk 0.73.0 → 0.75.0

package/resources/shared.d.mts

@@ -62,14 +62,14 @@ export interface BrowserProfile {
  * 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
- * bandwidth reasonable).
+ * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60, 768x1024@60, 390x844@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 bandwidth reasonable).
  */
 export interface BrowserViewport {
     /**

package/resources/shared.d.ts

@@ -62,14 +62,14 @@ export interface BrowserProfile {
  * 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
- * bandwidth reasonable).
+ * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60, 768x1024@60, 390x844@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 bandwidth reasonable).
  */
 export interface BrowserViewport {
     /**

package/src/resources/api-keys.ts

@@ -75,7 +75,8 @@ export class APIKeys extends APIResource {
   }
 
   /**
-   * Delete an API key.
+   * Delete an API key. A key cannot delete itself; use a different key to delete
+   * this one.
    *
    * @example
    * ```ts

package/src/resources/apps.ts

@@ -47,7 +47,9 @@ export interface AppListResponse {
   deployment: string;
 
   /**
-   * Environment variables configured for this app version
+   * Environment variables configured for this app version. Values are redacted for
+   * API key, OAuth, and managed-auth callers, which receive every key with an empty
+   * string value. Only dashboard sessions receive the actual values.
    */
   env_vars: { [key: string]: string };
 

package/src/resources/browser-pools.ts

@@ -48,7 +48,9 @@ export class BrowserPools extends APIResource {
   /**
    * Updates the configuration used to create browsers in the pool. As with creation,
    * save_changes on the pool profile is ignored (not rejected); pooled browsers
-   * never persist changes back to the profile.
+   * never persist changes back to the profile. To clear the profile reference, send
+   * `profile: { "id": "" }`. Clearing the profile also disables
+   * `refresh_on_profile_update`.
    *
    * @example
    * ```ts
@@ -186,10 +188,26 @@ export interface BrowserPool {
    */
   created_at: string;
 
+  /**
+   * Resolved extension IDs attached to the pool, in configured load order. Empty
+   * when no extensions are attached. Authoritative for programmatic consumers; the
+   * extensions inside `browser_pool_config` reflect the configured selector (echoed
+   * as sent on create).
+   */
+  extension_ids: Array<string>;
+
   /**
    * Browser pool name, if set
    */
   name?: string;
+
+  /**
+   * Resolved profile ID the pool is attached to. Omitted when no profile is
+   * attached. Authoritative for programmatic consumers; the profile inside
+   * `browser_pool_config` reflects the configured selector (echoed as sent on
+   * create).
+   */
+  profile_id?: string;
 }
 
 export namespace BrowserPool {
@@ -241,12 +259,11 @@ export namespace BrowserPool {
     name?: string;
 
     /**
-     * Profile selection for browsers in a pool. Provide either id or name. The
-     * matching profile is loaded into every browser in the pool. Profiles must be
-     * created beforehand. Unlike single browser sessions, pools load the profile
-     * read-only and never persist changes back to it, so save_changes is omitted here.
-     * Any save_changes value sent on a pool profile is silently ignored rather than
-     * rejected, so callers reusing a single-session profile object will not error.
+     * Profile configuration for browsers in a pool. Provide either id or name.
+     * Profiles must be created beforehand. Unlike single browser sessions, pools load
+     * the profile read-only and never persist changes back to it, so save_changes is
+     * omitted here. Any save_changes value sent on a pool profile is silently ignored
+     * rather than rejected.
      */
     profile?: BrowserPoolConfig.Profile;
 
@@ -256,6 +273,13 @@ export namespace BrowserPool {
      */
     proxy_id?: string;
 
+    /**
+     * When true, flush idle browsers when the profile the pool uses is updated, so
+     * pool browsers pick up the latest profile data. Requires a profile to be set on
+     * the pool.
+     */
+    refresh_on_profile_update?: boolean;
+
     /**
      * Optional URL to navigate to when a new browser is warmed into the pool.
      * Best-effort: failures to navigate do not fail pool fill. Only applied to
@@ -282,26 +306,25 @@ export namespace BrowserPool {
      * 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
-     * bandwidth reasonable).
+     * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60, 768x1024@60, 390x844@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 bandwidth reasonable).
      */
     viewport?: Shared.BrowserViewport;
   }
 
   export namespace BrowserPoolConfig {
     /**
-     * Profile selection for browsers in a pool. Provide either id or name. The
-     * matching profile is loaded into every browser in the pool. Profiles must be
-     * created beforehand. Unlike single browser sessions, pools load the profile
-     * read-only and never persist changes back to it, so save_changes is omitted here.
-     * Any save_changes value sent on a pool profile is silently ignored rather than
-     * rejected, so callers reusing a single-session profile object will not error.
+     * Profile configuration for browsers in a pool. Provide either id or name.
+     * Profiles must be created beforehand. Unlike single browser sessions, pools load
+     * the profile read-only and never persist changes back to it, so save_changes is
+     * omitted here. Any save_changes value sent on a pool profile is silently ignored
+     * rather than rejected.
      */
     export interface Profile {
       /**
@@ -438,14 +461,14 @@ export interface BrowserPoolAcquireResponse {
    * 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
-   * bandwidth reasonable).
+   * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60, 768x1024@60, 390x844@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 bandwidth reasonable).
    */
   viewport?: Shared.BrowserViewport;
 }
@@ -495,12 +518,11 @@ export interface BrowserPoolCreateParams {
   name?: string;
 
   /**
-   * Profile selection for browsers in a pool. Provide either id or name. The
-   * matching profile is loaded into every browser in the pool. Profiles must be
-   * created beforehand. Unlike single browser sessions, pools load the profile
-   * read-only and never persist changes back to it, so save_changes is omitted here.
-   * Any save_changes value sent on a pool profile is silently ignored rather than
-   * rejected, so callers reusing a single-session profile object will not error.
+   * Profile configuration for browsers in a pool. Provide either id or name.
+   * Profiles must be created beforehand. Unlike single browser sessions, pools load
+   * the profile read-only and never persist changes back to it, so save_changes is
+   * omitted here. Any save_changes value sent on a pool profile is silently ignored
+   * rather than rejected.
    */
   profile?: BrowserPoolCreateParams.Profile;
 
@@ -510,6 +532,13 @@ export interface BrowserPoolCreateParams {
    */
   proxy_id?: string;
 
+  /**
+   * When true, flush idle browsers when the profile the pool uses is updated, so
+   * pool browsers pick up the latest profile data. Requires a profile to be set on
+   * the pool.
+   */
+  refresh_on_profile_update?: boolean;
+
   /**
    * Optional URL to navigate to when a new browser is warmed into the pool.
    * Best-effort: failures to navigate do not fail pool fill. Only applied to
@@ -536,26 +565,25 @@ export interface BrowserPoolCreateParams {
    * 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
-   * bandwidth reasonable).
+   * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60, 768x1024@60, 390x844@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 bandwidth reasonable).
    */
   viewport?: Shared.BrowserViewport;
 }
 
 export namespace BrowserPoolCreateParams {
   /**
-   * Profile selection for browsers in a pool. Provide either id or name. The
-   * matching profile is loaded into every browser in the pool. Profiles must be
-   * created beforehand. Unlike single browser sessions, pools load the profile
-   * read-only and never persist changes back to it, so save_changes is omitted here.
-   * Any save_changes value sent on a pool profile is silently ignored rather than
-   * rejected, so callers reusing a single-session profile object will not error.
+   * Profile configuration for browsers in a pool. Provide either id or name.
+   * Profiles must be created beforehand. Unlike single browser sessions, pools load
+   * the profile read-only and never persist changes back to it, so save_changes is
+   * omitted here. Any save_changes value sent on a pool profile is silently ignored
+   * rather than rejected.
    */
   export interface Profile {
     /**
@@ -581,8 +609,12 @@ export interface BrowserPoolUpdateParams {
   chrome_policy?: { [key: string]: unknown };
 
   /**
-   * Whether to discard all idle browsers and rebuild the pool immediately. Defaults
-   * to false.
+   * Whether to discard all idle browsers and rebuild them immediately with the new
+   * configuration. Defaults to false. Only browsers that are idle when the update
+   * runs are rebuilt. A browser that is in use during the update keeps its original
+   * configuration, and if it is later released with `reuse: true` it returns to the
+   * pool with that stale configuration until it is discarded (by this flag on a
+   * later update, or by flushing the pool).
    */
   discard_all_idle?: boolean;
 
@@ -615,12 +647,11 @@ export interface BrowserPoolUpdateParams {
   name?: string;
 
   /**
-   * Profile selection for browsers in a pool. Provide either id or name. The
-   * matching profile is loaded into every browser in the pool. Profiles must be
-   * created beforehand. Unlike single browser sessions, pools load the profile
-   * read-only and never persist changes back to it, so save_changes is omitted here.
-   * Any save_changes value sent on a pool profile is silently ignored rather than
-   * rejected, so callers reusing a single-session profile object will not error.
+   * Profile configuration for browsers in a pool. Provide either id or name.
+   * Profiles must be created beforehand. Unlike single browser sessions, pools load
+   * the profile read-only and never persist changes back to it, so save_changes is
+   * omitted here. Any save_changes value sent on a pool profile is silently ignored
+   * rather than rejected.
    */
   profile?: BrowserPoolUpdateParams.Profile;
 
@@ -630,6 +661,13 @@ export interface BrowserPoolUpdateParams {
    */
   proxy_id?: string;
 
+  /**
+   * When true, flush idle browsers when the profile the pool uses is updated, so
+   * pool browsers pick up the latest profile data. Requires a profile to be set on
+   * the pool.
+   */
+  refresh_on_profile_update?: boolean;
+
   /**
    * Number of browsers to maintain in the pool. The maximum size is determined by
    * your organization's pooled sessions limit (the sum of all pool sizes cannot
@@ -663,26 +701,25 @@ export interface BrowserPoolUpdateParams {
    * 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
-   * bandwidth reasonable).
+   * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60, 768x1024@60, 390x844@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 bandwidth reasonable).
    */
   viewport?: Shared.BrowserViewport;
 }
 
 export namespace BrowserPoolUpdateParams {
   /**
-   * Profile selection for browsers in a pool. Provide either id or name. The
-   * matching profile is loaded into every browser in the pool. Profiles must be
-   * created beforehand. Unlike single browser sessions, pools load the profile
-   * read-only and never persist changes back to it, so save_changes is omitted here.
-   * Any save_changes value sent on a pool profile is silently ignored rather than
-   * rejected, so callers reusing a single-session profile object will not error.
+   * Profile configuration for browsers in a pool. Provide either id or name.
+   * Profiles must be created beforehand. Unlike single browser sessions, pools load
+   * the profile read-only and never persist changes back to it, so save_changes is
+   * omitted here. Any save_changes value sent on a pool profile is silently ignored
+   * rather than rejected.
    */
   export interface Profile {
     /**
@@ -752,7 +789,10 @@ export interface BrowserPoolReleaseParams {
 
   /**
    * Whether to reuse the browser instance or destroy it and create a new one.
-   * Defaults to true.
+   * Defaults to true. A reused browser keeps the configuration it was created with,
+   * so it does not pick up pool configuration changes made while it was in use.
+   * Release with `reuse: false`, or flush the pool afterward, to rebuild it with the
+   * current configuration.
    */
   reuse?: boolean;
 }

package/src/resources/browsers/browsers.ts

@@ -459,14 +459,14 @@ export interface BrowserCreateResponse {
    * 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
-   * bandwidth reasonable).
+   * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60, 768x1024@60, 390x844@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 bandwidth reasonable).
    */
   viewport?: Shared.BrowserViewport;
 }
@@ -591,14 +591,14 @@ export interface BrowserRetrieveResponse {
    * 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
-   * bandwidth reasonable).
+   * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60, 768x1024@60, 390x844@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 bandwidth reasonable).
    */
   viewport?: Shared.BrowserViewport;
 }
@@ -723,14 +723,14 @@ export interface BrowserUpdateResponse {
    * 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
-   * bandwidth reasonable).
+   * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60, 768x1024@60, 390x844@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 bandwidth reasonable).
    */
   viewport?: Shared.BrowserViewport;
 }
@@ -855,14 +855,14 @@ export interface BrowserListResponse {
    * 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
-   * bandwidth reasonable).
+   * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60, 768x1024@60, 390x844@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 bandwidth reasonable).
    */
   viewport?: Shared.BrowserViewport;
 }
@@ -992,14 +992,14 @@ export interface BrowserCreateParams {
    * 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
-   * bandwidth reasonable).
+   * 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60, 768x1024@60, 390x844@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 bandwidth reasonable).
    */
   viewport?: Shared.BrowserViewport;
 }

package/src/resources/browsers/telemetry.ts

@@ -14,10 +14,10 @@ import { path } from '../../internal/utils/path';
  */
 export class Telemetry extends APIResource {
   /**
-   * Reads a page of telemetry events for the browser session in ascending sequence
-   * order. To page through results, pass the X-Next-Offset value from the previous
-   * response as offset and repeat while X-Has-More is true. Returns an empty list
-   * when telemetry data is unavailable.
+   * Reads a page of telemetry events for the browser session. To page through
+   * results, pass the X-Next-Offset value from the previous response as offset and
+   * repeat while X-Has-More is true. Returns an empty list when telemetry data is
+   * unavailable.
    *
    * @example
    * ```ts
@@ -2076,6 +2076,16 @@ export interface TelemetryEventsParams extends OffsetPaginationParams {
     | 'monitor'
   >;
 
+  /**
+   * Read direction. asc (default) reads oldest first, starting from since or the
+   * offset cursor. desc reads newest first: each request returns one page of up to
+   * limit records ending at the offset cursor (or until, or the newest archived
+   * event); combining desc with since is rejected with a 400. In either direction
+   * the category filter applies within the page, so a filtered page may be empty
+   * while X-Has-More is true.
+   */
+  order?: string;
+
   /**
    * Start of the window: an RFC-3339 timestamp, or a duration like 5m meaning that
    * long ago. Defaults to 5m. Ignored when offset is set.

package/src/resources/deployments.ts

@@ -159,7 +159,9 @@ export namespace DeploymentStateEvent {
     entrypoint_rel_path?: string;
 
     /**
-     * Environment variables configured for this deployment
+     * Environment variables configured for this deployment. Values are redacted for
+     * API key, OAuth, and managed-auth callers, which receive every key with an empty
+     * string value. Only dashboard sessions receive the actual values.
      */
     env_vars?: { [key: string]: string };
 
@@ -205,7 +207,9 @@ export interface DeploymentCreateResponse {
   entrypoint_rel_path?: string;
 
   /**
-   * Environment variables configured for this deployment
+   * Environment variables configured for this deployment. Values are redacted for
+   * API key, OAuth, and managed-auth callers, which receive every key with an empty
+   * string value. Only dashboard sessions receive the actual values.
    */
   env_vars?: { [key: string]: string };
 
@@ -250,7 +254,9 @@ export interface DeploymentRetrieveResponse {
   entrypoint_rel_path?: string;
 
   /**
-   * Environment variables configured for this deployment
+   * Environment variables configured for this deployment. Values are redacted for
+   * API key, OAuth, and managed-auth callers, which receive every key with an empty
+   * string value. Only dashboard sessions receive the actual values.
    */
   env_vars?: { [key: string]: string };
 
@@ -295,7 +301,9 @@ export interface DeploymentListResponse {
   entrypoint_rel_path?: string;
 
   /**
-   * Environment variables configured for this deployment
+   * Environment variables configured for this deployment. Values are redacted for
+   * API key, OAuth, and managed-auth callers, which receive every key with an empty
+   * string value. Only dashboard sessions receive the actual values.
    */
   env_vars?: { [key: string]: string };
 
@@ -361,7 +369,8 @@ export namespace DeploymentFollowResponse {
     version: string;
 
     /**
-     * Environment variables configured for this app version
+     * Environment variables configured for this app version. Not currently populated
+     * on streamed app_version_summary events.
      */
     env_vars?: { [key: string]: string };
   }

package/src/resources/extensions.ts

@@ -147,6 +147,15 @@ export interface ExtensionListResponse {
    */
   size_bytes: number;
 
+  /**
+   * SHA-256 checksum, encoded as lowercase hexadecimal, of the exact uploaded
+   * extension archive bytes. This is not a normalized checksum of the extension
+   * contents; archive metadata, file ordering, and compression can change the
+   * checksum for otherwise identical contents. Omitted for legacy rows and
+   * server-repackaged Chrome Web Store extensions.
+   */
+  checksum?: string | null;
+
   /**
    * Timestamp when the extension was last used
    */
@@ -178,6 +187,15 @@ export interface ExtensionGetResponse {
    */
   size_bytes: number;
 
+  /**
+   * SHA-256 checksum, encoded as lowercase hexadecimal, of the exact uploaded
+   * extension archive bytes. This is not a normalized checksum of the extension
+   * contents; archive metadata, file ordering, and compression can change the
+   * checksum for otherwise identical contents. Omitted for legacy rows and
+   * server-repackaged Chrome Web Store extensions.
+   */
+  checksum?: string | null;
+
   /**
    * Timestamp when the extension was last used
    */
@@ -209,6 +227,15 @@ export interface ExtensionUploadResponse {
    */
   size_bytes: number;
 
+  /**
+   * SHA-256 checksum, encoded as lowercase hexadecimal, of the exact uploaded
+   * extension archive bytes. This is not a normalized checksum of the extension
+   * contents; archive metadata, file ordering, and compression can change the
+   * checksum for otherwise identical contents. Omitted for legacy rows and
+   * server-repackaged Chrome Web Store extensions.
+   */
+  checksum?: string | null;
+
   /**
    * Timestamp when the extension was last used
    */