release: 0.7.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.6.5"
+  ".": "0.7.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 17
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-0ac9428eb663361184124cdd6a6e80ae8dc72c927626c949f22aacc4f40095de.yml
-openapi_spec_hash: 27707667d706ac33f2d9ccb23c0f15c3
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-3ec96d0022acb32aa2676c2e7ae20152b899a776ccd499380c334c955b9ba071.yml
+openapi_spec_hash: b64c095d82185c1cd0355abea88b606f
 config_hash: 00ec9df250b9dc077f8d3b93a442d252

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.7.0 (2025-07-02)
+
+Full Changelog: [v0.6.5...v0.7.0](https://github.com/onkernel/kernel-node-sdk/compare/v0.6.5...v0.7.0)
+
+### Features
+
+* **api:** headless browsers ([af9ecef](https://github.com/onkernel/kernel-node-sdk/commit/af9ecef97c052d66a78e2c4048998f981ad47695))
+
 ## 0.6.5 (2025-07-02)
 
 Full Changelog: [v0.6.4...v0.6.5](https://github.com/onkernel/kernel-node-sdk/compare/v0.6.4...v0.6.5)

package.json

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

src/resources/browsers.ts

@@ -97,11 +97,6 @@ export interface BrowserPersistence {
 }
 
 export interface BrowserCreateResponse {
-  /**
-   * Remote URL for live viewing the browser session
-   */
-  browser_live_view_url: string;
-
   /**
    * Websocket URL for Chrome DevTools Protocol connections to the browser session
    */
@@ -112,18 +107,19 @@ export interface BrowserCreateResponse {
    */
   session_id: string;
 
+  /**
+   * Remote URL for live viewing the browser session. Only available for non-headless
+   * browsers.
+   */
+  browser_live_view_url?: string;
+
   /**
    * Optional persistence configuration for the browser session.
    */
   persistence?: BrowserPersistence;
 }
 
 export interface BrowserRetrieveResponse {
-  /**
-   * Remote URL for live viewing the browser session
-   */
-  browser_live_view_url: string;
-
   /**
    * Websocket URL for Chrome DevTools Protocol connections to the browser session
    */
@@ -134,6 +130,12 @@ export interface BrowserRetrieveResponse {
    */
   session_id: string;
 
+  /**
+   * Remote URL for live viewing the browser session. Only available for non-headless
+   * browsers.
+   */
+  browser_live_view_url?: string;
+
   /**
    * Optional persistence configuration for the browser session.
    */
@@ -144,11 +146,6 @@ export type BrowserListResponse = Array<BrowserListResponse.BrowserListResponseI
 
 export namespace BrowserListResponse {
   export interface BrowserListResponseItem {
-    /**
-     * Remote URL for live viewing the browser session
-     */
-    browser_live_view_url: string;
-
     /**
      * Websocket URL for Chrome DevTools Protocol connections to the browser session
      */
@@ -159,6 +156,12 @@ export namespace BrowserListResponse {
      */
     session_id: string;
 
+    /**
+     * Remote URL for live viewing the browser session. Only available for non-headless
+     * browsers.
+     */
+    browser_live_view_url?: string;
+
     /**
      * Optional persistence configuration for the browser session.
      */
@@ -167,6 +170,12 @@ export namespace BrowserListResponse {
 }
 
 export interface BrowserCreateParams {
+  /**
+   * If true, launches the browser using a headless image (no VNC/GUI). Defaults to
+   * false.
+   */
+  headless?: boolean;
+
   /**
    * action invocation ID
    */

src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.6.5'; // x-release-please-version
+export const VERSION = '0.7.0'; // x-release-please-version

tests/api-resources/browsers.test.ts

@@ -26,6 +26,7 @@ describe('resource browsers', () => {
     await expect(
       client.browsers.create(
         {
+          headless: false,
           invocation_id: 'rr33xuugxj9h0bkf1rdt2bet',
           persistence: { id: 'my-awesome-browser-for-user-1234' },
           stealth: true,