@onkernel/sdk 0.106.0 → 0.107.0

package/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 {

package/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 {

package/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';

package/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.

package/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';

package/src/resources/vaults/items.ts

@@ -133,8 +133,10 @@ export class Items extends APIResource {
    * device approval before native Square Pay. Keep the returned approval page open,
    * poll until ready_to_submit, then submit before preparation.expires_at. Unused
    * preparations expire automatically and cannot be reused. If spend-request
-   * creation is rate limited, returns HTTP 429 with code
-   * `spend_request_rate_limited`; stop and back off before retrying.
+   * creation is rejected with a non-retryable provider error, the card item is
+   * deleted and the provider's error code and message are returned. Rate limits
+   * return HTTP 429 and retain the card item; stop, back off, and retry the same
+   * authorize operation.
    *
    * Fill returns a value-free execution result. Validation failures before writing
    * return 400 (invalid request or targets), 403 (access or destination denied), 404
@@ -316,7 +318,8 @@ export namespace CardVaultItemSpec {
    */
   export interface LinkCardVaultItemSpec {
     /**
-     * Integer amount in minor currency units.
+     * Integer amount in minor currency units. Link permits at most 50000 per spend
+     * request.
      */
     amount: number;
 

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.106.0'; // x-release-please-version
+export const VERSION = '0.107.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.106.0";
+export declare const VERSION = "0.107.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.106.0";
+export declare const VERSION = "0.107.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.106.0'; // x-release-please-version
+exports.VERSION = '0.107.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.106.0'; // x-release-please-version
+export const VERSION = '0.107.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map