@onkernel/sdk 0.75.0 → 0.78.0

package/resources/proxies.mjs

@@ -9,24 +9,65 @@ import { path } from "../internal/utils/path.mjs";
 export class Proxies extends APIResource {
     /**
      * Create a new proxy configuration in the resolved project.
+     *
+     * @example
+     * ```ts
+     * const proxy = await client.proxies.create({
+     *   type: 'datacenter',
+     * });
+     * ```
      */
     create(body, options) {
         return this._client.post('/proxies', { body, ...options });
     }
     /**
      * Retrieve a proxy in the resolved project by ID.
+     *
+     * @example
+     * ```ts
+     * const proxy = await client.proxies.retrieve('id');
+     * ```
      */
     retrieve(id, options) {
         return this._client.get(path `/proxies/${id}`, options);
     }
+    /**
+     * Update a proxy's name. Proxy names are not unique and are not ID-or-name
+     * addressable on this endpoint; duplicate names are allowed. Name-based
+     * session-create lookups can remain ambiguous until callers resolve proxies by ID
+     * or the API adds a stronger uniqueness contract.
+     *
+     * @example
+     * ```ts
+     * const proxy = await client.proxies.update('id', {
+     *   name: 'my-renamed-proxy',
+     * });
+     * ```
+     */
+    update(id, body, options) {
+        return this._client.patch(path `/proxies/${id}`, { body, ...options });
+    }
     /**
      * List proxies in the resolved project.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const proxyListResponse of client.proxies.list()) {
+     *   // ...
+     * }
+     * ```
      */
     list(query = {}, options) {
         return this._client.getAPIList('/proxies', (OffsetPagination), { query, ...options });
     }
     /**
      * Soft delete a proxy. Sessions referencing it are not modified.
+     *
+     * @example
+     * ```ts
+     * await client.proxies.delete('id');
+     * ```
      */
     delete(id, options) {
         return this._client.delete(path `/proxies/${id}`, {
@@ -41,6 +82,11 @@ export class Proxies extends APIResource {
      * exit IP. For residential and mobile proxies, the exit node varies between
      * requests, so this validates proxy configuration and connectivity rather than
      * guaranteeing site-specific reachability.
+     *
+     * @example
+     * ```ts
+     * const response = await client.proxies.check('id');
+     * ```
      */
     check(id, body = {}, options) {
         return this._client.post(path `/proxies/${id}/check`, { body, ...options });

package/resources/proxies.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"proxies.mjs","sourceRoot":"","sources":["../src/resources/proxies.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAE/C,OAAO,EAAE,gBAAgB,EAA4C,+BAA2B;AAChG,OAAO,EAAE,YAAY,EAAE,gCAA4B;AAEnD,OAAO,EAAE,IAAI,EAAE,mCAA+B;AAE9C;;GAEG;AACH,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC;;OAEG;IACH,MAAM,CAAC,IAAuB,EAAE,OAAwB;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,YAAY,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,IAAI,CACF,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,CAAA,gBAAmC,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzG,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,YAAY,EAAE,EAAE,EAAE;YAC/C,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CACH,EAAU,EACV,OAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,YAAY,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;CACF"}
+{"version":3,"file":"proxies.mjs","sourceRoot":"","sources":["../src/resources/proxies.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAE/C,OAAO,EAAE,gBAAgB,EAA4C,+BAA2B;AAChG,OAAO,EAAE,YAAY,EAAE,gCAA4B;AAEnD,OAAO,EAAE,IAAI,EAAE,mCAA+B;AAE9C;;GAEG;AACH,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;OASG;IACH,MAAM,CAAC,IAAuB,EAAE,OAAwB;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,YAAY,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,EAAU,EAAE,IAAuB,EAAE,OAAwB;QAClE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,YAAY,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,CAAA,gBAAmC,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzG,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,YAAY,EAAE,EAAE,EAAE;YAC/C,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CACH,EAAU,EACV,OAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,YAAY,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;CACF"}

package/src/client.ts

@@ -123,7 +123,7 @@ import {
   InvocationUpdateResponse,
   Invocations,
 } from './resources/invocations';
-import { ProfileCreateParams, ProfileListParams, Profiles } from './resources/profiles';
+import { ProfileCreateParams, ProfileListParams, ProfileUpdateParams, Profiles } from './resources/profiles';
 import {
   Proxies,
   ProxyCheckParams,
@@ -134,6 +134,8 @@ import {
   ProxyListResponse,
   ProxyListResponsesOffsetPagination,
   ProxyRetrieveResponse,
+  ProxyUpdateParams,
+  ProxyUpdateResponse,
 } from './resources/proxies';
 import { Auth } from './resources/auth/auth';
 import {
@@ -1122,6 +1124,7 @@ export declare namespace Kernel {
   export {
     Profiles as Profiles,
     type ProfileCreateParams as ProfileCreateParams,
+    type ProfileUpdateParams as ProfileUpdateParams,
     type ProfileListParams as ProfileListParams,
   };
 
@@ -1131,10 +1134,12 @@ export declare namespace Kernel {
     Proxies as Proxies,
     type ProxyCreateResponse as ProxyCreateResponse,
     type ProxyRetrieveResponse as ProxyRetrieveResponse,
+    type ProxyUpdateResponse as ProxyUpdateResponse,
     type ProxyListResponse as ProxyListResponse,
     type ProxyCheckResponse as ProxyCheckResponse,
     type ProxyListResponsesOffsetPagination as ProxyListResponsesOffsetPagination,
     type ProxyCreateParams as ProxyCreateParams,
+    type ProxyUpdateParams as ProxyUpdateParams,
     type ProxyListParams as ProxyListParams,
     type ProxyCheckParams as ProxyCheckParams,
   };

package/src/resources/api-keys.ts

@@ -141,7 +141,8 @@ export interface APIKey {
   masked_key: string;
 
   /**
-   * API key name
+   * Label for the API key. API keys are not addressable by name; use the ID or key
+   * identifier for stable references.
    */
   name: string;
 
@@ -188,7 +189,7 @@ export interface CreatedAPIKey extends APIKey {
 
 export interface APIKeyCreateParams {
   /**
-   * API key name (1-255 characters)
+   * Label for the API key (1-255 characters). API keys are not addressable by name.
    */
   name: string;
 
@@ -225,6 +226,14 @@ export interface APIKeyListParams extends OffsetPaginationParams {
    */
   include_deleted?: boolean;
 
+  /**
+   * Exact-match filter on API key name using the database collation. In production,
+   * matching is case- and accent-insensitive. Names are not required to be unique,
+   * so multiple keys may match. When status=all or include_deleted=true is set,
+   * soft-deleted keys with the same name may also match.
+   */
+  name?: string;
+
   /**
    * Case-insensitive substring match against API key name, creator, and project. API
    * key identifiers and masked keys match by exact value or prefix.

package/src/resources/audit-logs.ts

@@ -119,7 +119,7 @@ export interface AuditLogListParams extends PageTokenPaginationParams {
   /**
    * Filter out results by HTTP method.
    */
-  exclude_method?: string;
+  exclude_method?: Array<string>;
 
   /**
    * Filter by HTTP method.
@@ -166,7 +166,7 @@ export interface AuditLogExportChunkParams {
   /**
    * Filter out results by HTTP method.
    */
-  exclude_method?: string;
+  exclude_method?: Array<string>;
 
   /**
    * Encoding for the returned chunk.

package/src/resources/auth/connections.ts

@@ -729,7 +729,9 @@ export interface ManagedAuthCreateRequest {
 
   /**
    * Proxy selection. Provide either id or name. The proxy must be in the same
-   * project as the resource referencing it.
+   * project as the resource referencing it. When selecting by name, the name must
+   * match exactly one active proxy in the project. Ambiguous names return a 400; use
+   * id for stable references.
    */
   proxy?: ManagedAuthCreateRequest.Proxy;
 
@@ -778,7 +780,9 @@ export namespace ManagedAuthCreateRequest {
 
   /**
    * Proxy selection. Provide either id or name. The proxy must be in the same
-   * project as the resource referencing it.
+   * project as the resource referencing it. When selecting by name, the name must
+   * match exactly one active proxy in the project. Ambiguous names return a 400; use
+   * id for stable references.
    */
   export interface Proxy {
     /**
@@ -917,7 +921,9 @@ export interface ManagedAuthUpdateRequest {
 
   /**
    * Proxy selection. Provide either id or name. The proxy must be in the same
-   * project as the resource referencing it.
+   * project as the resource referencing it. When selecting by name, the name must
+   * match exactly one active proxy in the project. Ambiguous names return a 400; use
+   * id for stable references.
    */
   proxy?: ManagedAuthUpdateRequest.Proxy;
 
@@ -964,7 +970,9 @@ export namespace ManagedAuthUpdateRequest {
 
   /**
    * Proxy selection. Provide either id or name. The proxy must be in the same
-   * project as the resource referencing it.
+   * project as the resource referencing it. When selecting by name, the name must
+   * match exactly one active proxy in the project. Ambiguous names return a 400; use
+   * id for stable references.
    */
   export interface Proxy {
     /**
@@ -1320,7 +1328,9 @@ export interface ConnectionCreateParams {
 
   /**
    * Proxy selection. Provide either id or name. The proxy must be in the same
-   * project as the resource referencing it.
+   * project as the resource referencing it. When selecting by name, the name must
+   * match exactly one active proxy in the project. Ambiguous names return a 400; use
+   * id for stable references.
    */
   proxy?: ConnectionCreateParams.Proxy;
 
@@ -1369,7 +1379,9 @@ export namespace ConnectionCreateParams {
 
   /**
    * Proxy selection. Provide either id or name. The proxy must be in the same
-   * project as the resource referencing it.
+   * project as the resource referencing it. When selecting by name, the name must
+   * match exactly one active proxy in the project. Ambiguous names return a 400; use
+   * id for stable references.
    */
   export interface Proxy {
     /**
@@ -1430,7 +1442,9 @@ export interface ConnectionUpdateParams {
 
   /**
    * Proxy selection. Provide either id or name. The proxy must be in the same
-   * project as the resource referencing it.
+   * project as the resource referencing it. When selecting by name, the name must
+   * match exactly one active proxy in the project. Ambiguous names return a 400; use
+   * id for stable references.
    */
   proxy?: ConnectionUpdateParams.Proxy;
 
@@ -1477,7 +1491,9 @@ export namespace ConnectionUpdateParams {
 
   /**
    * Proxy selection. Provide either id or name. The proxy must be in the same
-   * project as the resource referencing it.
+   * project as the resource referencing it. When selecting by name, the name must
+   * match exactly one active proxy in the project. Ambiguous names return a 400; use
+   * id for stable references.
    */
   export interface Proxy {
     /**
@@ -1512,7 +1528,9 @@ export interface ConnectionListParams extends OffsetPaginationParams {
 export interface ConnectionLoginParams {
   /**
    * Proxy selection. Provide either id or name. The proxy must be in the same
-   * project as the resource referencing it.
+   * project as the resource referencing it. When selecting by name, the name must
+   * match exactly one active proxy in the project. Ambiguous names return a 400; use
+   * id for stable references.
    */
   proxy?: ConnectionLoginParams.Proxy;
 
@@ -1526,7 +1544,9 @@ export interface ConnectionLoginParams {
 export namespace ConnectionLoginParams {
   /**
    * Proxy selection. Provide either id or name. The proxy must be in the same
-   * project as the resource referencing it.
+   * project as the resource referencing it. When selecting by name, the name must
+   * match exactly one active proxy in the project. Ambiguous names return a 400; use
+   * id for stable references.
    */
   export interface Proxy {
     /**

package/src/resources/browser-pools.ts

@@ -216,7 +216,7 @@ export namespace BrowserPool {
    */
   export interface BrowserPoolConfig {
     /**
-     * Number of browsers to maintain in the pool. The maximum size is determined by
+     * Number of browsers maintained in the pool. The maximum size is determined by
      * your organization's pooled sessions limit (the sum of all pool sizes cannot
      * exceed your limit).
      */
@@ -226,7 +226,8 @@ export namespace BrowserPool {
      * 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/
+     * https://chromeenterprise.google/policies/ The serialized JSON payload is capped
+     * at 5 MiB.
      */
     chrome_policy?: { [key: string]: unknown };
 
@@ -236,14 +237,13 @@ export namespace BrowserPool {
     extensions?: Array<Shared.BrowserExtension>;
 
     /**
-     * Percentage of the pool to fill per minute. Defaults to 10. The cap is 25 for
-     * most organizations but can be raised per-organization, so only the lower bound
-     * is enforced here.
+     * Percentage of the pool to fill per minute. The cap is 25 for most organizations
+     * but can be raised per-organization, so only the lower bound is enforced here.
      */
     fill_rate_per_minute?: number;
 
     /**
-     * If true, launches the browser using a headless image. Defaults to false.
+     * If true, launches the browser using a headless image.
      */
     headless?: boolean;
 
@@ -268,15 +268,15 @@ export namespace BrowserPool {
     profile?: BrowserPoolConfig.Profile;
 
     /**
-     * Optional proxy to associate to the browser session. Must reference a proxy in
-     * the same project as the browser session.
+     * Optional proxy associated to the browser session. References a proxy in the same
+     * project as the browser session.
      */
     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.
+     * pool browsers pick up the latest profile data. When a profile is provided during
+     * creation, this defaults to true. Requires a profile to be set on the pool.
      */
     refresh_on_profile_update?: boolean;
 
@@ -297,7 +297,7 @@ export namespace BrowserPool {
 
     /**
      * 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).
+     * are destroyed. Minimum 10, maximum 259200 (72 hours).
      */
     timeout_seconds?: number;
 
@@ -485,7 +485,8 @@ export interface BrowserPoolCreateParams {
    * 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/
+   * https://chromeenterprise.google/policies/ The serialized JSON payload is capped
+   * at 5 MiB.
    */
   chrome_policy?: { [key: string]: unknown };
 
@@ -508,7 +509,7 @@ export interface BrowserPoolCreateParams {
 
   /**
    * If true, launches the browser in kiosk mode to hide address bar and tabs in live
-   * view.
+   * view. Defaults to false.
    */
   kiosk_mode?: boolean;
 
@@ -534,8 +535,8 @@ export interface BrowserPoolCreateParams {
 
   /**
    * 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.
+   * pool browsers pick up the latest profile data. When a profile is provided during
+   * creation, this defaults to true. Requires a profile to be set on the pool.
    */
   refresh_on_profile_update?: boolean;
 
@@ -550,7 +551,7 @@ export interface BrowserPoolCreateParams {
 
   /**
    * If true, launches the browser in stealth mode to reduce detection by anti-bot
-   * mechanisms.
+   * mechanisms. Defaults to false.
    */
   stealth?: boolean;
 
@@ -601,10 +602,12 @@ export namespace BrowserPoolCreateParams {
 
 export interface BrowserPoolUpdateParams {
   /**
-   * Custom Chrome enterprise policy overrides applied to all browsers in this pool.
-   * Keys are Chrome enterprise policy names; values must match their expected types.
+   * If provided, replaces the custom Chrome enterprise policy overrides applied to
+   * all browsers in this pool. Empty object clears any previously-set policy. 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/
+   * https://chromeenterprise.google/policies/ The serialized JSON payload is capped
+   * at 5 MiB.
    */
   chrome_policy?: { [key: string]: unknown };
 
@@ -619,30 +622,31 @@ export interface BrowserPoolUpdateParams {
   discard_all_idle?: boolean;
 
   /**
-   * List of browser extensions to load into the session. Provide each by id or name.
+   * If provided, replaces the extension list. Empty array clears all
+   * previously-selected extensions. Omit this field to leave extensions unchanged.
    */
   extensions?: Array<Shared.BrowserExtension>;
 
   /**
-   * Percentage of the pool to fill per minute. Defaults to 10. The cap is 25 for
-   * most organizations but can be raised per-organization, so only the lower bound
-   * is enforced here.
+   * If provided, replaces the percentage of the pool to fill per minute. The cap is
+   * 25 for most organizations but can be raised per-organization, so only the lower
+   * bound is enforced here.
    */
   fill_rate_per_minute?: number;
 
   /**
-   * If true, launches the browser using a headless image. Defaults to false.
+   * If provided, replaces whether browsers launch using a headless image.
    */
   headless?: boolean;
 
   /**
-   * If true, launches the browser in kiosk mode to hide address bar and tabs in live
-   * view.
+   * If provided, replaces whether browsers launch in kiosk mode.
    */
   kiosk_mode?: boolean;
 
   /**
-   * Optional name for the browser pool. Must be unique within the project.
+   * If provided, replaces the pool name. Empty string is a no-op; the pool name
+   * cannot be cleared or reset to empty once assigned.
    */
   name?: string;
 
@@ -656,43 +660,42 @@ export interface BrowserPoolUpdateParams {
   profile?: BrowserPoolUpdateParams.Profile;
 
   /**
-   * Optional proxy to associate to the browser session. Must reference a proxy in
-   * the same project as the browser session.
+   * Empty string clears the previously-selected proxy. Omit this field to leave the
+   * proxy unchanged.
    */
   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.
+   * If provided, replaces whether idle browsers are flushed when the profile the
+   * pool uses is updated. When the pool's profile reference is changed (including
+   * newly attached) and this field is omitted, it defaults to true. Re-sending the
+   * same profile reference leaves this setting unchanged. Clearing the profile also
+   * disables this setting. 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
-   * exceed your limit).
+   * If provided, replaces the 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 exceed your limit).
    */
   size?: number;
 
   /**
-   * 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
-   * newly-warmed browsers; browsers reused via release/acquire keep whatever URL the
-   * previous lease left them on. Accepts any URL Chromium can resolve, including
-   * chrome:// pages.
+   * If provided, replaces the URL to navigate to when a new browser is warmed into
+   * the pool. Empty string clears the previously-set URL. Omit this field to leave
+   * it unchanged.
    */
   start_url?: string;
 
   /**
-   * If true, launches the browser in stealth mode to reduce detection by anti-bot
-   * mechanisms.
+   * If provided, replaces whether browsers launch in stealth mode.
    */
   stealth?: boolean;
 
   /**
-   * 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).
+   * 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).
    */
   timeout_seconds?: number;
 
@@ -737,7 +740,16 @@ export namespace BrowserPoolUpdateParams {
 
 export interface BrowserPoolListParams extends OffsetPaginationParams {
   /**
-   * Search browser pools by name or ID.
+   * Exact-match filter on browser pool name using the database collation. In
+   * production, matching is case- and accent-insensitive. During the default-project
+   * migration, unscoped requests prefer a concrete default-project browser pool over
+   * a legacy unscoped browser pool with the same name.
+   */
+  name?: string;
+
+  /**
+   * Case-insensitive substring match against browser pool name. IDs match by exact
+   * value.
    */
   query?: string;
 }

package/src/resources/browsers/browsers.ts

@@ -1014,18 +1014,27 @@ export namespace BrowserCreateParams {
    */
   export interface Telemetry {
     /**
-     * Per-category capture flags. Selection is opt-in: only the categories set to
-     * enabled=true are captured; anything omitted is off. If enabled is true and
-     * browser is omitted or empty, the default category set is used. A browser config
-     * that enables nothing stops capture on update and starts no capture on create.
+     * 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 using the
-     * default category set unless browser category settings are provided. False stops
-     * capture on update and starts no capture on create. enabled=false cannot be
-     * combined with browser category settings.
+     * 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;
   }
@@ -1096,18 +1105,27 @@ export namespace BrowserUpdateParams {
    */
   export interface Telemetry {
     /**
-     * Per-category capture flags. Selection is opt-in: only the categories set to
-     * enabled=true are captured; anything omitted is off. If enabled is true and
-     * browser is omitted or empty, the default category set is used. A browser config
-     * that enables nothing stops capture on update and starts no capture on create.
+     * 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 using the
-     * default category set unless browser category settings are provided. False stops
-     * capture on update and starts no capture on create. enabled=false cannot be
-     * combined with browser category settings.
+     * 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;
   }

package/src/resources/browsers/telemetry.ts

@@ -371,7 +371,10 @@ export namespace BrowserConsoleErrorEvent {
    */
   export interface Data extends TelemetryAPI.BrowserEventContext {
     /**
-     * Error message text. Present in both source paths.
+     * Human-readable error text, as the browser console would display it. For
+     * console.error() calls, the first argument coerced to a string. For uncaught
+     * exceptions, the prefix and error message, e.g. "Uncaught Error: boom" or
+     * "Uncaught (in promise) TypeError: x is not a function".
      */
     text: string;
 
@@ -1879,12 +1882,11 @@ export namespace BrowserSystemOomKillEvent {
 }
 
 /**
- * Per-category telemetry capture settings. Selection is opt-in: set a category to
- * enabled=true to capture it; anything omitted is off. The default set (used by
- * enabled=true with no per-category settings) is the lightweight operational
- * signals: control, connection, system, captcha. The CDP categories (console,
- * network, page, interaction) and screenshot are off by default and must be opted
- * into.
+ * Per-category telemetry capture settings layered onto the default set. The
+ * operational signals (control, connection, system, captcha) are on by default and
+ * are opt-out: set one to enabled=false to stop capturing it. The CDP categories
+ * (console, network, page, interaction) and screenshot are off by default and are
+ * opt-in: set enabled=true to capture them.
  */
 export interface BrowserTelemetryCategoriesConfig {
   /**
@@ -1948,8 +1950,9 @@ export interface BrowserTelemetryCategoriesConfig {
  */
 export interface BrowserTelemetryCategoryConfig {
   /**
-   * Whether this category is captured. Selection is opt-in, so an omitted category
-   * is not captured.
+   * Whether this category is captured. Operational categories (control, connection,
+   * system, captcha) default to true; set false to opt out. CDP categories (console,
+   * network, page, interaction) and screenshot default to false; set true to opt in.
    */
   enabled?: boolean;
 }

package/src/resources/credential-providers.ts

@@ -346,7 +346,8 @@ export interface CredentialProviderUpdateParams {
 
 export interface CredentialProviderListParams extends OffsetPaginationParams {
   /**
-   * Search credential providers by name or ID.
+   * Case-insensitive substring match against credential provider name. IDs match by
+   * exact value.
    */
   query?: string;
 }