release: 0.62.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.61.0"
+  ".": "0.62.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 117
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-33e46e6a0095c2ec39a51860ee4e133c5a21a80a90cbe9e52953c07e5e0295de.yml
-openapi_spec_hash: 4aa466b9af39768b65a44b68ae0d1f6e
-config_hash: ede72e4ae65cc5a6d6927938b3455c46
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-e6c711f0d29a7d956cc8ca621440da966c1f1575b1205d01328b1099edf1c517.yml
+openapi_spec_hash: c06e7e36de1c6f9b29b54a6e3dc08ee5
+config_hash: 36159c262d293fbeacf513ab600a1729

CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.62.0 (2026-06-04)
+
+Full Changelog: [v0.61.0...v0.62.0](https://github.com/kernel/kernel-node-sdk/compare/v0.61.0...v0.62.0)
+
+### Features
+
+* api: paginate GET /browser_pools ([694525a](https://github.com/kernel/kernel-node-sdk/commit/694525a66e8c30775e043593e8b81c60d0b6929b))
+* api: paginate GET /extensions ([df67fdd](https://github.com/kernel/kernel-node-sdk/commit/df67fddc43df68b01c50eb484a75bd1335a7632d))
+* api: paginate GET /org/credential_providers ([2976140](https://github.com/kernel/kernel-node-sdk/commit/2976140c1d35046ab5fff05b1419f74e39b1be5e))
+* api: paginate GET /proxies ([1520c55](https://github.com/kernel/kernel-node-sdk/commit/1520c5542688f2621483e8d62701b0fc07de731a))
+
 ## 0.61.0 (2026-06-03)
 
 Full Changelog: [v0.60.0...v0.61.0](https://github.com/kernel/kernel-node-sdk/compare/v0.60.0...v0.61.0)

api.md

@@ -283,7 +283,7 @@ Methods:
 
 - <code title="post /proxies">client.proxies.<a href="./src/resources/proxies.ts">create</a>({ ...params }) -> ProxyCreateResponse</code>
 - <code title="get /proxies/{id}">client.proxies.<a href="./src/resources/proxies.ts">retrieve</a>(id) -> ProxyRetrieveResponse</code>
-- <code title="get /proxies">client.proxies.<a href="./src/resources/proxies.ts">list</a>() -> ProxyListResponse</code>
+- <code title="get /proxies">client.proxies.<a href="./src/resources/proxies.ts">list</a>({ ...params }) -> ProxyListResponsesOffsetPagination</code>
 - <code title="delete /proxies/{id}">client.proxies.<a href="./src/resources/proxies.ts">delete</a>(id) -> void</code>
 - <code title="post /proxies/{id}/check">client.proxies.<a href="./src/resources/proxies.ts">check</a>(id, { ...params }) -> ProxyCheckResponse</code>
 
@@ -296,7 +296,7 @@ Types:
 
 Methods:
 
-- <code title="get /extensions">client.extensions.<a href="./src/resources/extensions.ts">list</a>() -> ExtensionListResponse</code>
+- <code title="get /extensions">client.extensions.<a href="./src/resources/extensions.ts">list</a>({ ...params }) -> ExtensionListResponsesOffsetPagination</code>
 - <code title="delete /extensions/{id_or_name}">client.extensions.<a href="./src/resources/extensions.ts">delete</a>(idOrName) -> void</code>
 - <code title="get /extensions/{id_or_name}">client.extensions.<a href="./src/resources/extensions.ts">download</a>(idOrName) -> Response</code>
 - <code title="get /extensions/from_chrome_store">client.extensions.<a href="./src/resources/extensions.ts">downloadFromChromeStore</a>({ ...params }) -> Response</code>
@@ -307,15 +307,14 @@ Methods:
 Types:
 
 - <code><a href="./src/resources/browser-pools.ts">BrowserPool</a></code>
-- <code><a href="./src/resources/browser-pools.ts">BrowserPoolListResponse</a></code>
 - <code><a href="./src/resources/browser-pools.ts">BrowserPoolAcquireResponse</a></code>
 
 Methods:
 
 - <code title="post /browser_pools">client.browserPools.<a href="./src/resources/browser-pools.ts">create</a>({ ...params }) -> BrowserPool</code>
 - <code title="get /browser_pools/{id_or_name}">client.browserPools.<a href="./src/resources/browser-pools.ts">retrieve</a>(idOrName) -> BrowserPool</code>
 - <code title="patch /browser_pools/{id_or_name}">client.browserPools.<a href="./src/resources/browser-pools.ts">update</a>(idOrName, { ...params }) -> BrowserPool</code>
-- <code title="get /browser_pools">client.browserPools.<a href="./src/resources/browser-pools.ts">list</a>() -> BrowserPoolListResponse</code>
+- <code title="get /browser_pools">client.browserPools.<a href="./src/resources/browser-pools.ts">list</a>({ ...params }) -> BrowserPoolsOffsetPagination</code>
 - <code title="delete /browser_pools/{id_or_name}">client.browserPools.<a href="./src/resources/browser-pools.ts">delete</a>(idOrName, { ...params }) -> void</code>
 - <code title="post /browser_pools/{id_or_name}/acquire">client.browserPools.<a href="./src/resources/browser-pools.ts">acquire</a>(idOrName, { ...params }) -> BrowserPoolAcquireResponse</code>
 - <code title="post /browser_pools/{id_or_name}/flush">client.browserPools.<a href="./src/resources/browser-pools.ts">flush</a>(idOrName) -> void</code>
@@ -391,15 +390,14 @@ Types:
 - <code><a href="./src/resources/credential-providers.ts">CredentialProviderItem</a></code>
 - <code><a href="./src/resources/credential-providers.ts">CredentialProviderTestResult</a></code>
 - <code><a href="./src/resources/credential-providers.ts">UpdateCredentialProviderRequest</a></code>
-- <code><a href="./src/resources/credential-providers.ts">CredentialProviderListResponse</a></code>
 - <code><a href="./src/resources/credential-providers.ts">CredentialProviderListItemsResponse</a></code>
 
 Methods:
 
 - <code title="post /org/credential_providers">client.credentialProviders.<a href="./src/resources/credential-providers.ts">create</a>({ ...params }) -> CredentialProvider</code>
 - <code title="get /org/credential_providers/{id}">client.credentialProviders.<a href="./src/resources/credential-providers.ts">retrieve</a>(id) -> CredentialProvider</code>
 - <code title="patch /org/credential_providers/{id}">client.credentialProviders.<a href="./src/resources/credential-providers.ts">update</a>(id, { ...params }) -> CredentialProvider</code>
-- <code title="get /org/credential_providers">client.credentialProviders.<a href="./src/resources/credential-providers.ts">list</a>() -> CredentialProviderListResponse</code>
+- <code title="get /org/credential_providers">client.credentialProviders.<a href="./src/resources/credential-providers.ts">list</a>({ ...params }) -> CredentialProvidersOffsetPagination</code>
 - <code title="delete /org/credential_providers/{id}">client.credentialProviders.<a href="./src/resources/credential-providers.ts">delete</a>(id) -> void</code>
 - <code title="get /org/credential_providers/{id}/items">client.credentialProviders.<a href="./src/resources/credential-providers.ts">listItems</a>(id) -> CredentialProviderListItemsResponse</code>
 - <code title="post /org/credential_providers/{id}/test">client.credentialProviders.<a href="./src/resources/credential-providers.ts">test</a>(id) -> CredentialProviderTestResult</code>

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onkernel/sdk",
-  "version": "0.61.0",
+  "version": "0.62.0",
   "description": "The official TypeScript library for the Kernel API",
   "author": "Kernel <>",
   "types": "dist/index.d.ts",

src/client.ts

@@ -40,21 +40,23 @@ import {
   BrowserPoolAcquireResponse,
   BrowserPoolCreateParams,
   BrowserPoolDeleteParams,
-  BrowserPoolListResponse,
+  BrowserPoolListParams,
   BrowserPoolReleaseParams,
   BrowserPoolUpdateParams,
   BrowserPools,
+  BrowserPoolsOffsetPagination,
 } from './resources/browser-pools';
 import {
   CreateCredentialProviderRequest,
   CredentialProvider,
   CredentialProviderCreateParams,
   CredentialProviderItem,
   CredentialProviderListItemsResponse,
-  CredentialProviderListResponse,
+  CredentialProviderListParams,
   CredentialProviderTestResult,
   CredentialProviderUpdateParams,
   CredentialProviders,
+  CredentialProvidersOffsetPagination,
   UpdateCredentialProviderRequest,
 } from './resources/credential-providers';
 import {
@@ -83,7 +85,9 @@ import {
 import { KernelApp } from './core/app-framework';
 import {
   ExtensionDownloadFromChromeStoreParams,
+  ExtensionListParams,
   ExtensionListResponse,
+  ExtensionListResponsesOffsetPagination,
   ExtensionUploadParams,
   ExtensionUploadResponse,
   Extensions,
@@ -110,7 +114,9 @@ import {
   ProxyCheckResponse,
   ProxyCreateParams,
   ProxyCreateResponse,
+  ProxyListParams,
   ProxyListResponse,
+  ProxyListResponsesOffsetPagination,
   ProxyRetrieveResponse,
 } from './resources/proxies';
 import { Auth } from './resources/auth/auth';
@@ -1081,25 +1087,30 @@ export declare namespace Kernel {
     type ProxyRetrieveResponse as ProxyRetrieveResponse,
     type ProxyListResponse as ProxyListResponse,
     type ProxyCheckResponse as ProxyCheckResponse,
+    type ProxyListResponsesOffsetPagination as ProxyListResponsesOffsetPagination,
     type ProxyCreateParams as ProxyCreateParams,
+    type ProxyListParams as ProxyListParams,
     type ProxyCheckParams as ProxyCheckParams,
   };
 
   export {
     Extensions as Extensions,
     type ExtensionListResponse as ExtensionListResponse,
     type ExtensionUploadResponse as ExtensionUploadResponse,
+    type ExtensionListResponsesOffsetPagination as ExtensionListResponsesOffsetPagination,
+    type ExtensionListParams as ExtensionListParams,
     type ExtensionDownloadFromChromeStoreParams as ExtensionDownloadFromChromeStoreParams,
     type ExtensionUploadParams as ExtensionUploadParams,
   };
 
   export {
     BrowserPools as BrowserPools,
     type BrowserPool as BrowserPool,
-    type BrowserPoolListResponse as BrowserPoolListResponse,
     type BrowserPoolAcquireResponse as BrowserPoolAcquireResponse,
+    type BrowserPoolsOffsetPagination as BrowserPoolsOffsetPagination,
     type BrowserPoolCreateParams as BrowserPoolCreateParams,
     type BrowserPoolUpdateParams as BrowserPoolUpdateParams,
+    type BrowserPoolListParams as BrowserPoolListParams,
     type BrowserPoolDeleteParams as BrowserPoolDeleteParams,
     type BrowserPoolAcquireParams as BrowserPoolAcquireParams,
     type BrowserPoolReleaseParams as BrowserPoolReleaseParams,
@@ -1145,10 +1156,11 @@ export declare namespace Kernel {
     type CredentialProviderItem as CredentialProviderItem,
     type CredentialProviderTestResult as CredentialProviderTestResult,
     type UpdateCredentialProviderRequest as UpdateCredentialProviderRequest,
-    type CredentialProviderListResponse as CredentialProviderListResponse,
     type CredentialProviderListItemsResponse as CredentialProviderListItemsResponse,
+    type CredentialProvidersOffsetPagination as CredentialProvidersOffsetPagination,
     type CredentialProviderCreateParams as CredentialProviderCreateParams,
     type CredentialProviderUpdateParams as CredentialProviderUpdateParams,
+    type CredentialProviderListParams as CredentialProviderListParams,
   };
 
   export type AppAction = API.AppAction;

src/resources/browser-pools.ts

@@ -5,6 +5,7 @@ import * as Shared from './shared';
 import * as BrowsersAPI from './browsers/browsers';
 import * as TelemetryAPI from './browsers/telemetry';
 import { APIPromise } from '../core/api-promise';
+import { OffsetPagination, type OffsetPaginationParams, PagePromise } from '../core/pagination';
 import { buildHeaders } from '../internal/headers';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
@@ -60,11 +61,17 @@ export class BrowserPools extends APIResource {
    *
    * @example
    * ```ts
-   * const browserPools = await client.browserPools.list();
+   * // Automatically fetches more pages as needed.
+   * for await (const browserPool of client.browserPools.list()) {
+   *   // ...
+   * }
    * ```
    */
-  list(options?: RequestOptions): APIPromise<BrowserPoolListResponse> {
-    return this._client.get('/browser_pools', options);
+  list(
+    query: BrowserPoolListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<BrowserPoolsOffsetPagination, BrowserPool> {
+    return this._client.getAPIList('/browser_pools', OffsetPagination<BrowserPool>, { query, ...options });
   }
 
   /**
@@ -143,6 +150,8 @@ export class BrowserPools extends APIResource {
   }
 }
 
+export type BrowserPoolsOffsetPagination = OffsetPagination<BrowserPool>;
+
 /**
  * A browser pool containing multiple identically configured browsers.
  */
@@ -276,8 +285,6 @@ export namespace BrowserPool {
   }
 }
 
-export type BrowserPoolListResponse = Array<BrowserPool>;
-
 export interface BrowserPoolAcquireResponse {
   /**
    * Websocket URL for Chrome DevTools Protocol connections to the browser session
@@ -591,6 +598,8 @@ export interface BrowserPoolUpdateParams {
   viewport?: Shared.BrowserViewport;
 }
 
+export interface BrowserPoolListParams extends OffsetPaginationParams {}
+
 export interface BrowserPoolDeleteParams {
   /**
    * If true, force delete even if browsers are currently leased. Leased browsers
@@ -624,10 +633,11 @@ export interface BrowserPoolReleaseParams {
 export declare namespace BrowserPools {
   export {
     type BrowserPool as BrowserPool,
-    type BrowserPoolListResponse as BrowserPoolListResponse,
     type BrowserPoolAcquireResponse as BrowserPoolAcquireResponse,
+    type BrowserPoolsOffsetPagination as BrowserPoolsOffsetPagination,
     type BrowserPoolCreateParams as BrowserPoolCreateParams,
     type BrowserPoolUpdateParams as BrowserPoolUpdateParams,
+    type BrowserPoolListParams as BrowserPoolListParams,
     type BrowserPoolDeleteParams as BrowserPoolDeleteParams,
     type BrowserPoolAcquireParams as BrowserPoolAcquireParams,
     type BrowserPoolReleaseParams as BrowserPoolReleaseParams,

src/resources/credential-providers.ts

@@ -2,6 +2,7 @@
 
 import { APIResource } from '../core/resource';
 import { APIPromise } from '../core/api-promise';
+import { OffsetPagination, type OffsetPaginationParams, PagePromise } from '../core/pagination';
 import { buildHeaders } from '../internal/headers';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
@@ -63,12 +64,20 @@ export class CredentialProviders extends APIResource {
    *
    * @example
    * ```ts
-   * const credentialProviders =
-   *   await client.credentialProviders.list();
+   * // Automatically fetches more pages as needed.
+   * for await (const credentialProvider of client.credentialProviders.list()) {
+   *   // ...
+   * }
    * ```
    */
-  list(options?: RequestOptions): APIPromise<CredentialProviderListResponse> {
-    return this._client.get('/org/credential_providers', options);
+  list(
+    query: CredentialProviderListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<CredentialProvidersOffsetPagination, CredentialProvider> {
+    return this._client.getAPIList('/org/credential_providers', OffsetPagination<CredentialProvider>, {
+      query,
+      ...options,
+    });
   }
 
   /**
@@ -115,6 +124,8 @@ export class CredentialProviders extends APIResource {
   }
 }
 
+export type CredentialProvidersOffsetPagination = OffsetPagination<CredentialProvider>;
+
 /**
  * Request to create an external credential provider
  */
@@ -280,8 +291,6 @@ export interface UpdateCredentialProviderRequest {
   priority?: number;
 }
 
-export type CredentialProviderListResponse = Array<CredentialProvider>;
-
 export interface CredentialProviderListItemsResponse {
   items?: Array<CredentialProviderItem>;
 }
@@ -335,16 +344,19 @@ export interface CredentialProviderUpdateParams {
   priority?: number;
 }
 
+export interface CredentialProviderListParams extends OffsetPaginationParams {}
+
 export declare namespace CredentialProviders {
   export {
     type CreateCredentialProviderRequest as CreateCredentialProviderRequest,
     type CredentialProvider as CredentialProvider,
     type CredentialProviderItem as CredentialProviderItem,
     type CredentialProviderTestResult as CredentialProviderTestResult,
     type UpdateCredentialProviderRequest as UpdateCredentialProviderRequest,
-    type CredentialProviderListResponse as CredentialProviderListResponse,
     type CredentialProviderListItemsResponse as CredentialProviderListItemsResponse,
+    type CredentialProvidersOffsetPagination as CredentialProvidersOffsetPagination,
     type CredentialProviderCreateParams as CredentialProviderCreateParams,
     type CredentialProviderUpdateParams as CredentialProviderUpdateParams,
+    type CredentialProviderListParams as CredentialProviderListParams,
   };
 }