release: 0.9.1

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.9.0"
+  ".": "0.9.1"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 31
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-e907afeabfeea49dedd783112ac3fd29267bc86f3d594f89ba9a2abf2bcbc9d8.yml
-openapi_spec_hash: 060ca6288c1a09b6d1bdf207a0011165
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-b55c3e0424fa7733487139488b9fff00ad8949ff02ee3160ee36b9334e84b134.yml
+openapi_spec_hash: 17f36677e3dc0a3aeb419654c8d5cae3
 config_hash: f67e4b33b2fb30c1405ee2fff8096320

CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.9.1 (2025-08-15)
+
+Full Changelog: [v0.9.0...v0.9.1](https://github.com/onkernel/kernel-node-sdk/compare/v0.9.0...v0.9.1)
+
+### Features
+
+* **api:** add browser timeouts ([a7cf6cd](https://github.com/onkernel/kernel-node-sdk/commit/a7cf6cdc4b35728bbdf85469d4212e90e5241b78))
+
+### Chores
+
+* **internal:** codegen related update ([0665717](https://github.com/onkernel/kernel-node-sdk/commit/0665717e9f8831133ccec9cb24e29a0db800c86f))
+* **internal:** update comment in script ([c435fb5](https://github.com/onkernel/kernel-node-sdk/commit/c435fb5125da065d4a5d36777506a8924c7fb02e))
+* update @stainless-api/prism-cli to v5.15.0 ([391384a](https://github.com/onkernel/kernel-node-sdk/commit/391384a0c5cc64b4bc4f4e8f717e11ae4cf7bce5))
+
 ## 0.9.0 (2025-08-08)
 
 Full Changelog: [v0.8.3...v0.9.0](https://github.com/onkernel/kernel-node-sdk/compare/v0.8.3...v0.9.0)

package.json

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

scripts/mock

@@ -21,7 +21,7 @@ echo "==> Starting mock server with URL ${URL}"
 
 # Run prism mock on the given spec
 if [ "$1" == "--daemon" ]; then
-  npm exec --package=@stainless-api/prism-cli@5.8.5 -- prism mock "$URL" &> .prism.log &
+  npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock "$URL" &> .prism.log &
 
   # Wait for server to come online
   echo -n "Waiting for server"
@@ -37,5 +37,5 @@ if [ "$1" == "--daemon" ]; then
 
   echo
 else
-  npm exec --package=@stainless-api/prism-cli@5.8.5 -- prism mock "$URL"
+  npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock "$URL"
 fi

scripts/test

@@ -43,7 +43,7 @@ elif ! prism_is_running ; then
   echo -e "To run the server, pass in the path or url of your OpenAPI"
   echo -e "spec to the prism command:"
   echo
-  echo -e "  \$ ${YELLOW}npm exec --package=@stoplight/prism-cli@~5.3.2 -- prism mock path/to/your.openapi.yml${NC}"
+  echo -e "  \$ ${YELLOW}npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock path/to/your.openapi.yml${NC}"
   echo
 
   exit 1

src/resources/browsers/browsers.ts

@@ -129,11 +129,31 @@ export interface BrowserCreateResponse {
    */
   cdp_ws_url: string;
 
+  /**
+   * When the browser session was created.
+   */
+  created_at: string;
+
+  /**
+   * Whether the browser session is running in headless mode.
+   */
+  headless: boolean;
+
   /**
    * Unique identifier for the browser session
    */
   session_id: string;
 
+  /**
+   * Whether the browser session is running in stealth mode.
+   */
+  stealth: boolean;
+
+  /**
+   * The number of seconds of inactivity before the browser session is terminated.
+   */
+  timeout_seconds: number;
+
   /**
    * Remote URL for live viewing the browser session. Only available for non-headless
    * browsers.
@@ -152,11 +172,31 @@ export interface BrowserRetrieveResponse {
    */
   cdp_ws_url: string;
 
+  /**
+   * When the browser session was created.
+   */
+  created_at: string;
+
+  /**
+   * Whether the browser session is running in headless mode.
+   */
+  headless: boolean;
+
   /**
    * Unique identifier for the browser session
    */
   session_id: string;
 
+  /**
+   * Whether the browser session is running in stealth mode.
+   */
+  stealth: boolean;
+
+  /**
+   * The number of seconds of inactivity before the browser session is terminated.
+   */
+  timeout_seconds: number;
+
   /**
    * Remote URL for live viewing the browser session. Only available for non-headless
    * browsers.
@@ -178,11 +218,31 @@ export namespace BrowserListResponse {
      */
     cdp_ws_url: string;
 
+    /**
+     * When the browser session was created.
+     */
+    created_at: string;
+
+    /**
+     * Whether the browser session is running in headless mode.
+     */
+    headless: boolean;
+
     /**
      * Unique identifier for the browser session
      */
     session_id: string;
 
+    /**
+     * Whether the browser session is running in stealth mode.
+     */
+    stealth: boolean;
+
+    /**
+     * The number of seconds of inactivity before the browser session is terminated.
+     */
+    timeout_seconds: number;
+
     /**
      * Remote URL for live viewing the browser session. Only available for non-headless
      * browsers.
@@ -218,6 +278,13 @@ export interface BrowserCreateParams {
    * mechanisms.
    */
   stealth?: boolean;
+
+  /**
+   * The number of seconds of inactivity before the browser session is terminated.
+   * Only applicable to non-persistent browsers. Activity includes CDP connections
+   * and live view connections. Defaults to 60 seconds.
+   */
+  timeout_seconds?: number;
 }
 
 export interface BrowserDeleteParams {

src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.9.0'; // x-release-please-version
+export const VERSION = '0.9.1'; // x-release-please-version

tests/api-resources/apps.test.ts

@@ -8,7 +8,7 @@ const client = new Kernel({
 });
 
 describe('resource apps', () => {
-  // skipped: tests are disabled for the time being
+  // Prism tests are disabled
   test.skip('list', async () => {
     const responsePromise = client.apps.list();
     const rawResponse = await responsePromise.asResponse();
@@ -20,7 +20,7 @@ describe('resource apps', () => {
     expect(dataAndResponse.response).toBe(rawResponse);
   });
 
-  // skipped: tests are disabled for the time being
+  // Prism tests are disabled
   test.skip('list: 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(

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

@@ -8,7 +8,7 @@ const client = new Kernel({
 });
 
 describe('resource browsers', () => {
-  // skipped: tests are disabled for the time being
+  // Prism tests are disabled
   test.skip('create', async () => {
     const responsePromise = client.browsers.create();
     const rawResponse = await responsePromise.asResponse();
@@ -20,7 +20,7 @@ describe('resource browsers', () => {
     expect(dataAndResponse.response).toBe(rawResponse);
   });
 
-  // skipped: tests are disabled for the time being
+  // Prism tests are disabled
   test.skip('create: 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(
@@ -30,13 +30,14 @@ describe('resource browsers', () => {
           invocation_id: 'rr33xuugxj9h0bkf1rdt2bet',
           persistence: { id: 'my-awesome-browser-for-user-1234' },
           stealth: true,
+          timeout_seconds: 0,
         },
         { path: '/_stainless_unknown_path' },
       ),
     ).rejects.toThrow(Kernel.NotFoundError);
   });
 
-  // skipped: tests are disabled for the time being
+  // Prism tests are disabled
   test.skip('retrieve', async () => {
     const responsePromise = client.browsers.retrieve('htzv5orfit78e1m2biiifpbv');
     const rawResponse = await responsePromise.asResponse();
@@ -48,7 +49,7 @@ describe('resource browsers', () => {
     expect(dataAndResponse.response).toBe(rawResponse);
   });
 
-  // skipped: tests are disabled for the time being
+  // Prism tests are disabled
   test.skip('list', async () => {
     const responsePromise = client.browsers.list();
     const rawResponse = await responsePromise.asResponse();
@@ -60,7 +61,7 @@ describe('resource browsers', () => {
     expect(dataAndResponse.response).toBe(rawResponse);
   });
 
-  // skipped: tests are disabled for the time being
+  // Prism tests are disabled
   test.skip('delete: only required params', async () => {
     const responsePromise = client.browsers.delete({ persistent_id: 'persistent_id' });
     const rawResponse = await responsePromise.asResponse();
@@ -72,12 +73,12 @@ describe('resource browsers', () => {
     expect(dataAndResponse.response).toBe(rawResponse);
   });
 
-  // skipped: tests are disabled for the time being
+  // Prism tests are disabled
   test.skip('delete: required and optional params', async () => {
     const response = await client.browsers.delete({ persistent_id: 'persistent_id' });
   });
 
-  // skipped: tests are disabled for the time being
+  // Prism tests are disabled
   test.skip('deleteByID', async () => {
     const responsePromise = client.browsers.deleteByID('htzv5orfit78e1m2biiifpbv');
     const rawResponse = await responsePromise.asResponse();

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

@@ -8,7 +8,7 @@ const client = new Kernel({
 });
 
 describe('resource fs', () => {
-  // skipped: tests are disabled for the time being
+  // Prism tests are disabled
   test.skip('createDirectory: only required params', async () => {
     const responsePromise = client.browsers.fs.createDirectory('id', { path: '/J!' });
     const rawResponse = await responsePromise.asResponse();
@@ -20,12 +20,12 @@ describe('resource fs', () => {
     expect(dataAndResponse.response).toBe(rawResponse);
   });
 
-  // skipped: tests are disabled for the time being
+  // Prism tests are disabled
   test.skip('createDirectory: required and optional params', async () => {
     const response = await client.browsers.fs.createDirectory('id', { path: '/J!', mode: '0611' });
   });
 
-  // skipped: tests are disabled for the time being
+  // Prism tests are disabled
   test.skip('deleteDirectory: only required params', async () => {
     const responsePromise = client.browsers.fs.deleteDirectory('id', { path: '/J!' });
     const rawResponse = await responsePromise.asResponse();
@@ -37,12 +37,12 @@ describe('resource fs', () => {
     expect(dataAndResponse.response).toBe(rawResponse);
   });
 
-  // skipped: tests are disabled for the time being
+  // Prism tests are disabled
   test.skip('deleteDirectory: required and optional params', async () => {
     const response = await client.browsers.fs.deleteDirectory('id', { path: '/J!' });
   });
 
-  // skipped: tests are disabled for the time being
+  // Prism tests are disabled
   test.skip('deleteFile: only required params', async () => {
     const responsePromise = client.browsers.fs.deleteFile('id', { path: '/J!' });
     const rawResponse = await responsePromise.asResponse();
@@ -54,12 +54,12 @@ describe('resource fs', () => {
     expect(dataAndResponse.response).toBe(rawResponse);
   });
 
-  // skipped: tests are disabled for the time being
+  // Prism tests are disabled
   test.skip('deleteFile: required and optional params', async () => {
     const response = await client.browsers.fs.deleteFile('id', { path: '/J!' });
   });
 
-  // skipped: tests are disabled for the time being
+  // Prism tests are disabled
   test.skip('fileInfo: only required params', async () => {
     const responsePromise = client.browsers.fs.fileInfo('id', { path: '/J!' });
     const rawResponse = await responsePromise.asResponse();
@@ -71,12 +71,12 @@ describe('resource fs', () => {
     expect(dataAndResponse.response).toBe(rawResponse);
   });
 
-  // skipped: tests are disabled for the time being
+  // Prism tests are disabled
   test.skip('fileInfo: required and optional params', async () => {
     const response = await client.browsers.fs.fileInfo('id', { path: '/J!' });
   });
 
-  // skipped: tests are disabled for the time being
+  // Prism tests are disabled
   test.skip('listFiles: only required params', async () => {
     const responsePromise = client.browsers.fs.listFiles('id', { path: '/J!' });
     const rawResponse = await responsePromise.asResponse();
@@ -88,12 +88,12 @@ describe('resource fs', () => {
     expect(dataAndResponse.response).toBe(rawResponse);
   });
 
-  // skipped: tests are disabled for the time being
+  // Prism tests are disabled
   test.skip('listFiles: required and optional params', async () => {
     const response = await client.browsers.fs.listFiles('id', { path: '/J!' });
   });
 
-  // skipped: tests are disabled for the time being
+  // Prism tests are disabled
   test.skip('move: only required params', async () => {
     const responsePromise = client.browsers.fs.move('id', { dest_path: '/J!', src_path: '/J!' });
     const rawResponse = await responsePromise.asResponse();
@@ -105,17 +105,16 @@ describe('resource fs', () => {
     expect(dataAndResponse.response).toBe(rawResponse);
   });
 
-  // skipped: tests are disabled for the time being
+  // Prism tests are disabled
   test.skip('move: required and optional params', async () => {
     const response = await client.browsers.fs.move('id', { dest_path: '/J!', src_path: '/J!' });
   });
 
-  // skipped: tests are disabled for the time being
-  test.skip('readFile: required and optional params', async () => {
+  test('readFile: required and optional params', async () => {
     const response = await client.browsers.fs.readFile('id', { path: '/J!' });
   });
 
-  // skipped: tests are disabled for the time being
+  // Prism tests are disabled
   test.skip('setFilePermissions: only required params', async () => {
     const responsePromise = client.browsers.fs.setFilePermissions('id', { mode: '0611', path: '/J!' });
     const rawResponse = await responsePromise.asResponse();
@@ -127,7 +126,7 @@ describe('resource fs', () => {
     expect(dataAndResponse.response).toBe(rawResponse);
   });
 
-  // skipped: tests are disabled for the time being
+  // Prism tests are disabled
   test.skip('setFilePermissions: required and optional params', async () => {
     const response = await client.browsers.fs.setFilePermissions('id', {
       mode: '0611',
@@ -137,7 +136,7 @@ describe('resource fs', () => {
     });
   });
 
-  // skipped: tests are disabled for the time being
+  // Prism tests are disabled
   test.skip('writeFile: only required params', async () => {
     const responsePromise = client.browsers.fs.writeFile(
       'id',
@@ -153,7 +152,7 @@ describe('resource fs', () => {
     expect(dataAndResponse.response).toBe(rawResponse);
   });
 
-  // skipped: tests are disabled for the time being
+  // Prism tests are disabled
   test.skip('writeFile: required and optional params', async () => {
     const response = await client.browsers.fs.writeFile(
       'id',