@onkernel/sdk 0.74.0 → 0.75.0

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
@@ -296,12 +320,11 @@ export namespace BrowserPool {
 
   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 {
       /**
@@ -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
@@ -550,12 +579,11 @@ export interface BrowserPoolCreateParams {
 
 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
@@ -677,12 +715,11 @@ export interface BrowserPoolUpdateParams {
 
 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/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
    */

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.74.0'; // x-release-please-version
+export const VERSION = '0.75.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.74.0";
+export declare const VERSION = "0.75.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.74.0'; // x-release-please-version
+exports.VERSION = '0.75.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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