Merge pull request #187 from kernel/release-please--branches--main--changes--next--components--sdk

release: 0.107.0

Author: stainless-app[bot]

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.106.0"
+  ".": "0.107.0"
 }

.stats.yml

@@ -1 +1 @@
-configured_endpoints: 164
+configured_endpoints: 165

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [0.107.0](https://github.com/kernel/kernel-node-sdk/compare/v0.106.0...v0.107.0) (2026-09-16)
+
+
+### Features
+
+* Classify unevaluable config registry targets ([e6d16a7](https://github.com/kernel/kernel-node-sdk/commit/e6d16a732f8581b7c46bc2b47ffd4f77a7bb6ed5))
+* Expose persistent Browser REPL through the API ([f7b2e99](https://github.com/kernel/kernel-node-sdk/commit/f7b2e99d2b632ad36ef2f831afa53bc8175a1ae8))
+* Return Link spend request errors directly ([25d898f](https://github.com/kernel/kernel-node-sdk/commit/25d898f383e7c712478df9ed62d2d7f460ee68f8))
+
 ## 0.106.0 (2026-09-16)
 
 Full Changelog: [v0.104.0...v0.106.0](https://github.com/kernel/kernel-node-sdk/compare/v0.104.0...v0.106.0)

api.md

@@ -106,6 +106,11 @@ Types:
 - <code><a href="./src/resources/browsers/browsers.ts">BrowserProxy</a></code>
 - <code><a href="./src/resources/browsers/browsers.ts">BrowserProxyConfig</a></code>
 - <code><a href="./src/resources/browsers/browsers.ts">BrowserProxyMode</a></code>
+- <code><a href="./src/resources/browsers/browsers.ts">BrowserReplContent</a></code>
+- <code><a href="./src/resources/browsers/browsers.ts">BrowserReplImageContent</a></code>
+- <code><a href="./src/resources/browsers/browsers.ts">BrowserReplRequest</a></code>
+- <code><a href="./src/resources/browsers/browsers.ts">BrowserReplResult</a></code>
+- <code><a href="./src/resources/browsers/browsers.ts">BrowserReplTextContent</a></code>
 - <code><a href="./src/resources/browsers/browsers.ts">BrowserUsage</a></code>
 - <code><a href="./src/resources/browsers/browsers.ts">Profile</a></code>
 - <code><a href="./src/resources/browsers/browsers.ts">Tags</a></code>
@@ -125,6 +130,7 @@ Methods:
 - <code title="post /browsers/{id_or_name}/curl">client.browsers.<a href="./src/resources/browsers/browsers.ts">curl</a>(idOrName, { ...params }) -> BrowserCurlResponse</code>
 - <code title="delete /browsers/{id_or_name}">client.browsers.<a href="./src/resources/browsers/browsers.ts">deleteByID</a>(idOrName) -> void</code>
 - <code title="post /browsers/{id_or_name}/extensions">client.browsers.<a href="./src/resources/browsers/browsers.ts">loadExtensions</a>(idOrName, { ...params }) -> void</code>
+- <code title="post /browsers/{id_or_name}/repl">client.browsers.<a href="./src/resources/browsers/browsers.ts">repl</a>(idOrName, { ...params }) -> BrowserReplResult</code>
 
 ## Telemetry
 

package.json

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

src/client.ts

@@ -168,6 +168,12 @@ import {
   BrowserProxy,
   BrowserProxyConfig,
   BrowserProxyMode,
+  BrowserReplContent,
+  BrowserReplImageContent,
+  BrowserReplParams,
+  BrowserReplRequest,
+  BrowserReplResult,
+  BrowserReplTextContent,
   BrowserRetrieveParams,
   BrowserRetrieveResponse,
   BrowserUpdateParams,
@@ -1053,9 +1059,6 @@ export class Kernel {
    * Resolve browser and proxy recommendations for bot-protected sites.
    */
   configRegistry: API.ConfigRegistry = new API.ConfigRegistry(this);
-  /**
-   * Create and manage browser sessions.
-   */
   browsers: API.Browsers = new API.Browsers(this);
   /**
    * Create, list, retrieve, and delete browser profiles.
@@ -1205,6 +1208,11 @@ export declare namespace Kernel {
     type BrowserProxy as BrowserProxy,
     type BrowserProxyConfig as BrowserProxyConfig,
     type BrowserProxyMode as BrowserProxyMode,
+    type BrowserReplContent as BrowserReplContent,
+    type BrowserReplImageContent as BrowserReplImageContent,
+    type BrowserReplRequest as BrowserReplRequest,
+    type BrowserReplResult as BrowserReplResult,
+    type BrowserReplTextContent as BrowserReplTextContent,
     type BrowserUsage as BrowserUsage,
     type Profile as Profile,
     type Tags as Tags,
@@ -1221,6 +1229,7 @@ export declare namespace Kernel {
     type BrowserListParams as BrowserListParams,
     type BrowserCurlParams as BrowserCurlParams,
     type BrowserLoadExtensionsParams as BrowserLoadExtensionsParams,
+    type BrowserReplParams as BrowserReplParams,
   };
 
   export {

src/resources/browsers/browsers.ts

@@ -149,9 +149,6 @@ import { multipartFormRequestOptions } from '../../internal/uploads';
 import { path } from '../../internal/utils/path';
 import { browserFetch, type BrowserFetchInit } from '../../lib/browser-fetch';
 
-/**
- * Create and manage browser sessions.
- */
 export class Browsers extends APIResource {
   telemetry: TelemetryAPI.Telemetry = new TelemetryAPI.Telemetry(this._client);
   replays: ReplaysAPI.Replays = new ReplaysAPI.Replays(this._client);
@@ -306,6 +303,33 @@ export class Browsers extends APIResource {
       ),
     );
   }
+
+  /**
+   * Execute JavaScript in a persistent Node.js runtime inside the browser VM.
+   * Top-level bindings, closures, mutations, and dynamically imported modules
+   * persist across calls until the REPL is reset or replaced. Start with
+   * `repl.help()` to list available methods, or call `repl.help("click")` for
+   * detailed help.
+   *
+   * Expression values are ignored. Emit ordered text or image output with
+   * `repl.write(...)`, console methods, or `repl.emitImage(...)`. The runtime also
+   * exposes browser-control helpers, WebMCP, Patchright, Playwright, and raw CDP.
+   *
+   * Executions are serialized. A timeout, crash, OOM, or protocol failure terminates
+   * the REPL and changes its `repl_id`. This is unrestricted code execution inside
+   * the browser VM and is not sandboxed.
+   *
+   * @example
+   * ```ts
+   * const browserReplResult = await client.browsers.repl(
+   *   'htzv5orfit78e1m2biiifpbv',
+   *   { code: 'code' },
+   * );
+   * ```
+   */
+  repl(idOrName: string, body: BrowserReplParams, options?: RequestOptions): APIPromise<BrowserReplResult> {
+    return this._client.post(path`/browsers/${idOrName}/repl`, { body, ...options });
+  }
 }
 
 export type BrowserListResponsesOffsetPagination = OffsetPagination<BrowserListResponse>;
@@ -434,6 +458,104 @@ export interface BrowserProxyConfig {
  */
 export type BrowserProxyMode = 'direct' | 'default';
 
+/**
+ * Ordered discriminated union of Browser REPL output items.
+ */
+export type BrowserReplContent = BrowserReplTextContent | BrowserReplImageContent;
+
+export interface BrowserReplImageContent {
+  data_b64: string;
+
+  mime_type: string;
+
+  type: 'image';
+}
+
+/**
+ * Request to execute code in the persistent Browser REPL.
+ */
+export interface BrowserReplRequest {
+  /**
+   * JavaScript evaluated in a persistent Node.js runtime. Top-level bindings persist
+   * until the browser VM's API process exits, the REPL is reset, or the REPL is
+   * terminated after a crash or timeout. Static top-level imports are unsupported;
+   * use dynamic `import()`. Expression values are ignored; emit output with
+   * `repl.write(...)`, console methods, or `repl.emitImage(...)`. May be empty only
+   * when `reset` is true.
+   */
+  code: string;
+
+  /**
+   * Terminate the current REPL, start a fresh one, and then evaluate code.
+   */
+  reset?: boolean;
+
+  /**
+   * Maximum execution time in seconds. Default is 60.
+   */
+  timeout_sec?: number;
+}
+
+/**
+ * Result of Browser REPL code execution.
+ */
+export interface BrowserReplResult {
+  /**
+   * CUID2 identifying the exact state-holding REPL process used for this execution.
+   * Stable across calls and Chromium reconnects; changes after an API restart,
+   * explicit reset, execution timeout, or REPL crash.
+   */
+  repl_id: string;
+
+  /**
+   * Whether the code executed successfully.
+   */
+  success: boolean;
+
+  /**
+   * Optional ordered text/image output produced by the execution.
+   */
+  content?: Array<BrowserReplContent>;
+
+  /**
+   * True if text or image output was dropped or truncated due to response limits.
+   */
+  content_truncated?: boolean;
+
+  /**
+   * Wall-clock execution time in milliseconds.
+   */
+  duration_ms?: number;
+
+  /**
+   * Error message if execution failed.
+   */
+  error?: string;
+
+  /**
+   * True if the REPL identified by `repl_id` was terminated by this request. The
+   * next request lazily starts a fresh REPL with a new `repl_id`.
+   */
+  repl_terminated?: boolean;
+
+  /**
+   * Stack trace if execution failed.
+   */
+  stack?: string;
+}
+
+export interface BrowserReplTextContent {
+  /**
+   * `write` is emitted by `repl.write`; `stdout` and `stderr` are emitted by console
+   * methods.
+   */
+  channel: 'write' | 'stdout' | 'stderr';
+
+  text: string;
+
+  type: 'text';
+}
+
 /**
  * Session usage metrics.
  */
@@ -1703,6 +1825,28 @@ export namespace BrowserLoadExtensionsParams {
   }
 }
 
+export interface BrowserReplParams {
+  /**
+   * JavaScript evaluated in a persistent Node.js runtime. Top-level bindings persist
+   * until the browser VM's API process exits, the REPL is reset, or the REPL is
+   * terminated after a crash or timeout. Static top-level imports are unsupported;
+   * use dynamic `import()`. Expression values are ignored; emit output with
+   * `repl.write(...)`, console methods, or `repl.emitImage(...)`. May be empty only
+   * when `reset` is true.
+   */
+  code: string;
+
+  /**
+   * Terminate the current REPL, start a fresh one, and then evaluate code.
+   */
+  reset?: boolean;
+
+  /**
+   * Maximum execution time in seconds. Default is 60.
+   */
+  timeout_sec?: number;
+}
+
 Browsers.Telemetry = TelemetryAPITelemetry;
 Browsers.Replays = Replays;
 Browsers.Fs = Fs;
@@ -1721,6 +1865,11 @@ export declare namespace Browsers {
     type BrowserProxy as BrowserProxy,
     type BrowserProxyConfig as BrowserProxyConfig,
     type BrowserProxyMode as BrowserProxyMode,
+    type BrowserReplContent as BrowserReplContent,
+    type BrowserReplImageContent as BrowserReplImageContent,
+    type BrowserReplRequest as BrowserReplRequest,
+    type BrowserReplResult as BrowserReplResult,
+    type BrowserReplTextContent as BrowserReplTextContent,
     type BrowserUsage as BrowserUsage,
     type Profile as Profile,
     type Tags as Tags,
@@ -1737,6 +1886,7 @@ export declare namespace Browsers {
     type BrowserListParams as BrowserListParams,
     type BrowserCurlParams as BrowserCurlParams,
     type BrowserLoadExtensionsParams as BrowserLoadExtensionsParams,
+    type BrowserReplParams as BrowserReplParams,
   };
 
   export {

src/resources/browsers/index.ts

@@ -9,6 +9,11 @@ export {
   type BrowserProxy,
   type BrowserProxyConfig,
   type BrowserProxyMode,
+  type BrowserReplContent,
+  type BrowserReplImageContent,
+  type BrowserReplRequest,
+  type BrowserReplResult,
+  type BrowserReplTextContent,
   type BrowserUsage,
   type Profile,
   type Tags,
@@ -24,6 +29,7 @@ export {
   type BrowserListParams,
   type BrowserCurlParams,
   type BrowserLoadExtensionsParams,
+  type BrowserReplParams,
   type ProfilesOffsetPagination,
   type BrowserListResponsesOffsetPagination,
 } from './browsers';

src/resources/config-registry/config-registry.ts

@@ -261,7 +261,7 @@ export interface NoRecommendation {
   /**
    * Machine-readable reason Kernel cannot currently provide a config recommendation.
    */
-  code: 'proxy_restricted' | 'no_working_configuration' | 'inconclusive';
+  code: 'proxy_restricted' | 'target_not_evaluable' | 'no_working_configuration' | 'inconclusive';
 
   /**
    * Human-readable explanation suitable for display.

src/resources/index.ts

@@ -47,6 +47,11 @@ export {
   type BrowserProxy,
   type BrowserProxyConfig,
   type BrowserProxyMode,
+  type BrowserReplContent,
+  type BrowserReplImageContent,
+  type BrowserReplRequest,
+  type BrowserReplResult,
+  type BrowserReplTextContent,
   type BrowserUsage,
   type Profile,
   type Tags,
@@ -62,6 +67,7 @@ export {
   type BrowserListParams,
   type BrowserCurlParams,
   type BrowserLoadExtensionsParams,
+  type BrowserReplParams,
   type ProfilesOffsetPagination,
   type BrowserListResponsesOffsetPagination,
 } from './browsers/browsers';