diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index c84411f..2b11449 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
{
- ".": "0.26.0"
+ ".": "0.27.0"
}
diff --git a/.stats.yml b/.stats.yml
index 2857ba8..9ec6fcc 100644
--- a/.stats.yml
+++ b/.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
diff --git a/CHANGELOG.md b/CHANGELOG.md
index ea2fc14..ae1450a 100644
--- a/CHANGELOG.md
+++ b/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)
diff --git a/api.md b/api.md
index 45e2b0d..d86a880 100644
--- a/api.md
+++ b/api.md
@@ -73,7 +73,7 @@ Types:
Methods:
- client.browsers.create({ ...params }) -> BrowserCreateResponse
-- client.browsers.retrieve(id) -> BrowserRetrieveResponse
+- client.browsers.retrieve(id, { ...params }) -> BrowserRetrieveResponse
- client.browsers.update(id, { ...params }) -> BrowserUpdateResponse
- client.browsers.list({ ...params }) -> BrowserListResponsesOffsetPagination
- client.browsers.delete({ ...params }) -> void
diff --git a/package.json b/package.json
index 76168f1..5eb7b3b 100644
--- a/package.json
+++ b/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",
diff --git a/src/client.ts b/src/client.ts
index 581c7fd..24808b4 100644
--- a/src/client.ts
+++ b/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,
diff --git a/src/resources/browsers/browsers.ts b/src/resources/browsers/browsers.ts
index a745380..040c783 100644
--- a/src/resources/browsers/browsers.ts
+++ b/src/resources/browsers/browsers.ts
@@ -105,8 +105,12 @@ export class Browsers extends APIResource {
* );
* ```
*/
- retrieve(id: string, options?: RequestOptions): APIPromise {
- return this._client.get(path`/browsers/${id}`, options);
+ retrieve(
+ id: string,
+ query: BrowserRetrieveParams | null | undefined = {},
+ options?: RequestOptions,
+ ): APIPromise {
+ 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,
diff --git a/src/resources/browsers/index.ts b/src/resources/browsers/index.ts
index d00c32c..046c1b2 100644
--- a/src/resources/browsers/index.ts
+++ b/src/resources/browsers/index.ts
@@ -9,6 +9,7 @@ export {
type BrowserUpdateResponse,
type BrowserListResponse,
type BrowserCreateParams,
+ type BrowserRetrieveParams,
type BrowserUpdateParams,
type BrowserListParams,
type BrowserDeleteParams,
diff --git a/src/resources/index.ts b/src/resources/index.ts
index e95e4ae..1b7282a 100644
--- a/src/resources/index.ts
+++ b/src/resources/index.ts
@@ -28,6 +28,7 @@ export {
type BrowserUpdateResponse,
type BrowserListResponse,
type BrowserCreateParams,
+ type BrowserRetrieveParams,
type BrowserUpdateParams,
type BrowserListParams,
type BrowserDeleteParams,
diff --git a/src/version.ts b/src/version.ts
index aa25151..288031c 100644
--- a/src/version.ts
+++ b/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
diff --git a/tests/api-resources/browsers/browsers.test.ts b/tests/api-resources/browsers/browsers.test.ts
index f6d629d..51fecec 100644
--- a/tests/api-resources/browsers/browsers.test.ts
+++ b/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' },
),