From af9ecef97c052d66a78e2c4048998f981ad47695 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Wed, 2 Jul 2025 21:49:34 +0000
Subject: [PATCH 1/2] feat(api): headless browsers

---
 .stats.yml                           |  4 +--
 src/resources/browsers.ts            | 39 +++++++++++++++++-----------
 tests/api-resources/browsers.test.ts |  1 +
 3 files changed, 27 insertions(+), 17 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index d45a618..401ed65 100644
--- a/.stats.yml
+++ b/.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
diff --git a/src/resources/browsers.ts b/src/resources/browsers.ts
index ac3ffac..8afcb8c 100644
--- a/src/resources/browsers.ts
+++ b/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,6 +107,12 @@ 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.
    */
@@ -119,11 +120,6 @@ export interface BrowserCreateResponse {
 }
 
 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
    */
diff --git a/tests/api-resources/browsers.test.ts b/tests/api-resources/browsers.test.ts
index 24863a9..d28bd02 100644
--- a/tests/api-resources/browsers.test.ts
+++ b/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,

From 6c1633b0e3dcd5e243a5aa9b43bea18ad0929b01 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Wed, 2 Jul 2025 21:49:53 +0000
Subject: [PATCH 2/2] release: 0.7.0

---
 .release-please-manifest.json | 2 +-
 CHANGELOG.md                  | 8 ++++++++
 package.json                  | 2 +-
 src/version.ts                | 2 +-
 4 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 5b530ee..e7ca613 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.6.5"
+  ".": "0.7.0"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2f2b551..54a37d1 100644
--- a/CHANGELOG.md
+++ b/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)
diff --git a/package.json b/package.json
index 3dfa61d..dce29ff 100644
--- a/package.json
+++ b/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",
diff --git a/src/version.ts b/src/version.ts
index d9810da..d9da9f7 100644
--- a/src/version.ts
+++ b/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