release: 0.27.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.26.0"
+  ".": "0.27.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 91
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-fc2c80b398a8dd511010ae7cda5e21c353e388ee130aa288974b47af4208b5b8.yml
-openapi_spec_hash: 5e06586dbbb9fce12b907f4e32497006
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-59d2925a3cb93809cc762a3ac350691b365898e284f2c66a5999b9a6a37a35e5.yml
+openapi_spec_hash: dfcb0a49e657426d0c0f44cfa3e89430
 config_hash: cc7fdd701d995d4b3456d77041c604cf

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.27.0 (2026-01-19)
+
+Full Changelog: [v0.26.0...v0.27.0](https://github.com/kernel/kernel-node-sdk/compare/v0.26.0...v0.27.0)
+
+### Features
+
+* **dashboard:** add browser replays support for past browsers ([7df0d1b](https://github.com/kernel/kernel-node-sdk/commit/7df0d1b630bd87d6a8fc1999d33214f9434646fb))
+
 ## 0.26.0 (2026-01-17)
 
 Full Changelog: [v0.26.0...v0.26.0](https://github.com/kernel/kernel-node-sdk/compare/v0.26.0...v0.26.0)

api.md

@@ -73,7 +73,7 @@ Types:
 Methods:
 
 - <code title="post /browsers">client.browsers.<a href="./src/resources/browsers/browsers.ts">create</a>({ ...params }) -> BrowserCreateResponse</code>
-- <code title="get /browsers/{id}">client.browsers.<a href="./src/resources/browsers/browsers.ts">retrieve</a>(id) -> BrowserRetrieveResponse</code>
+- <code title="get /browsers/{id}">client.browsers.<a href="./src/resources/browsers/browsers.ts">retrieve</a>(id, { ...params }) -> BrowserRetrieveResponse</code>
 - <code title="patch /browsers/{id}">client.browsers.<a href="./src/resources/browsers/browsers.ts">update</a>(id, { ...params }) -> BrowserUpdateResponse</code>
 - <code title="get /browsers">client.browsers.<a href="./src/resources/browsers/browsers.ts">list</a>({ ...params }) -> BrowserListResponsesOffsetPagination</code>
 - <code title="delete /browsers">client.browsers.<a href="./src/resources/browsers/browsers.ts">delete</a>({ ...params }) -> void</code>

package.json

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

src/client.ts

@@ -94,6 +94,7 @@ import {
   BrowserListResponsesOffsetPagination,
   BrowserLoadExtensionsParams,
   BrowserPersistence,
+  BrowserRetrieveParams,
   BrowserRetrieveResponse,
   BrowserUpdateParams,
   BrowserUpdateResponse,
@@ -939,6 +940,7 @@ export declare namespace Kernel {
     type BrowserListResponse as BrowserListResponse,
     type BrowserListResponsesOffsetPagination as BrowserListResponsesOffsetPagination,
     type BrowserCreateParams as BrowserCreateParams,
+    type BrowserRetrieveParams as BrowserRetrieveParams,
     type BrowserUpdateParams as BrowserUpdateParams,
     type BrowserListParams as BrowserListParams,
     type BrowserDeleteParams as BrowserDeleteParams,

src/resources/browsers/browsers.ts

@@ -105,8 +105,12 @@ export class Browsers extends APIResource {
    * );
    * ```
    */
-  retrieve(id: string, options?: RequestOptions): APIPromise<BrowserRetrieveResponse> {
-    return this._client.get(path`/browsers/${id}`, options);
+  retrieve(
+    id: string,
+    query: BrowserRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<BrowserRetrieveResponse> {
+    return this._client.get(path`/browsers/${id}`, { query, ...options });
   }
 
   /**
@@ -124,8 +128,8 @@ export class Browsers extends APIResource {
   }
 
   /**
-   * List all browser sessions with pagination support. Use include_deleted=true to
-   * include soft-deleted sessions in the results.
+   * List all browser sessions with pagination support. Use status parameter to
+   * filter by session state.
    *
    * @example
    * ```ts
@@ -618,6 +622,13 @@ export interface BrowserCreateParams {
   viewport?: Shared.BrowserViewport;
 }
 
+export interface BrowserRetrieveParams {
+  /**
+   * When true, includes soft-deleted browser sessions in the lookup.
+   */
+  include_deleted?: boolean;
+}
+
 export interface BrowserUpdateParams {
   /**
    * ID of the proxy to use. Omit to leave unchanged, set to empty string to remove
@@ -628,10 +639,16 @@ export interface BrowserUpdateParams {
 
 export interface BrowserListParams extends OffsetPaginationParams {
   /**
-   * When true, includes soft-deleted browser sessions in the results alongside
-   * active sessions.
+   * Deprecated: Use status=all instead. When true, includes soft-deleted browser
+   * sessions in the results alongside active sessions.
    */
   include_deleted?: boolean;
+
+  /**
+   * Filter sessions by status. "active" returns only active sessions (default),
+   * "deleted" returns only soft-deleted sessions, "all" returns both.
+   */
+  status?: 'active' | 'deleted' | 'all';
 }
 
 export interface BrowserDeleteParams {
@@ -680,6 +697,7 @@ export declare namespace Browsers {
     type BrowserListResponse as BrowserListResponse,
     type BrowserListResponsesOffsetPagination as BrowserListResponsesOffsetPagination,
     type BrowserCreateParams as BrowserCreateParams,
+    type BrowserRetrieveParams as BrowserRetrieveParams,
     type BrowserUpdateParams as BrowserUpdateParams,
     type BrowserListParams as BrowserListParams,
     type BrowserDeleteParams as BrowserDeleteParams,

src/resources/browsers/index.ts

@@ -9,6 +9,7 @@ export {
   type BrowserUpdateResponse,
   type BrowserListResponse,
   type BrowserCreateParams,
+  type BrowserRetrieveParams,
   type BrowserUpdateParams,
   type BrowserListParams,
   type BrowserDeleteParams,

src/resources/index.ts

@@ -28,6 +28,7 @@ export {
   type BrowserUpdateResponse,
   type BrowserListResponse,
   type BrowserCreateParams,
+  type BrowserRetrieveParams,
   type BrowserUpdateParams,
   type BrowserListParams,
   type BrowserDeleteParams,

src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.26.0'; // x-release-please-version
+export const VERSION = '0.27.0'; // x-release-please-version

tests/api-resources/browsers/browsers.test.ts

@@ -62,6 +62,18 @@ describe('resource browsers', () => {
     expect(dataAndResponse.response).toBe(rawResponse);
   });
 
+  // Prism tests are disabled
+  test.skip('retrieve: request options and params are passed correctly', async () => {
+    // ensure the request options are being passed correctly by passing an invalid HTTP method in order to cause an error
+    await expect(
+      client.browsers.retrieve(
+        'htzv5orfit78e1m2biiifpbv',
+        { include_deleted: true },
+        { path: '/_stainless_unknown_path' },
+      ),
+    ).rejects.toThrow(Kernel.NotFoundError);
+  });
+
   // Prism tests are disabled
   test.skip('update', async () => {
     const responsePromise = client.browsers.update('htzv5orfit78e1m2biiifpbv', {});
@@ -95,6 +107,7 @@ describe('resource browsers', () => {
           include_deleted: true,
           limit: 1,
           offset: 0,
+          status: 'active',
         },
         { path: '/_stainless_unknown_path' },
       ),