@onkernel/sdk 0.97.0 → 0.99.0

package/src/resources/browsers/playwright.ts

@@ -12,23 +12,26 @@ export class Playwright extends APIResource {
   /**
    * Execute arbitrary Playwright code in a fresh execution context against the
    * browser. The code runs in the same VM as the browser, minimizing latency and
-   * maximizing throughput. It has access to 'page', 'context', and 'browser'
-   * variables. It can `return` a value, and this value is returned in the response.
+   * maximizing throughput. It has access to 'page', 'context', 'browser', and
+   * 'webmcp' variables. Use 'webmcp.listTools()' to discover browser-wide WebMCP
+   * tools and 'webmcp.invokeTool(toolRef, input?, { timeoutSec? })' to invoke an
+   * exact registration. It can `return` a value, and this value is returned in the
+   * response.
    *
    * @example
    * ```ts
    * const response = await client.browsers.playwright.execute(
-   *   'id',
+   *   'htzv5orfit78e1m2biiifpbv',
    *   { code: 'code' },
    * );
    * ```
    */
   execute(
-    id: string,
+    idOrName: string,
     body: PlaywrightExecuteParams,
     options?: RequestOptions,
   ): APIPromise<PlaywrightExecuteResponse> {
-    return this._client.post(path`/browsers/${id}/playwright/execute`, { body, ...options });
+    return this._client.post(path`/browsers/${idOrName}/playwright/execute`, { body, ...options });
   }
 }
 

package/src/resources/browsers/process.ts

@@ -16,13 +16,14 @@ export class Process extends APIResource {
    *
    * @example
    * ```ts
-   * const response = await client.browsers.process.exec('id', {
-   *   command: 'command',
-   * });
+   * const response = await client.browsers.process.exec(
+   *   'htzv5orfit78e1m2biiifpbv',
+   *   { command: 'command' },
+   * );
    * ```
    */
-  exec(id: string, body: ProcessExecParams, options?: RequestOptions): APIPromise<ProcessExecResponse> {
-    return this._client.post(path`/browsers/${id}/process/exec`, { body, ...options });
+  exec(idOrName: string, body: ProcessExecParams, options?: RequestOptions): APIPromise<ProcessExecResponse> {
+    return this._client.post(path`/browsers/${idOrName}/process/exec`, { body, ...options });
   }
 
   /**
@@ -32,7 +33,10 @@ export class Process extends APIResource {
    * ```ts
    * const response = await client.browsers.process.kill(
    *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
-   *   { id: 'id', signal: 'TERM' },
+   *   {
+   *     id_or_name: 'htzv5orfit78e1m2biiifpbv',
+   *     signal: 'TERM',
+   *   },
    * );
    * ```
    */
@@ -41,8 +45,8 @@ export class Process extends APIResource {
     params: ProcessKillParams,
     options?: RequestOptions,
   ): APIPromise<ProcessKillResponse> {
-    const { id, ...body } = params;
-    return this._client.post(path`/browsers/${id}/process/${processID}/kill`, { body, ...options });
+    const { id_or_name, ...body } = params;
+    return this._client.post(path`/browsers/${id_or_name}/process/${processID}/kill`, { body, ...options });
   }
 
   /**
@@ -53,7 +57,7 @@ export class Process extends APIResource {
    * const response = await client.browsers.process.resize(
    *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
    *   {
-   *     id: 'id',
+   *     id_or_name: 'htzv5orfit78e1m2biiifpbv',
    *     cols: 1,
    *     rows: 1,
    *   },
@@ -65,8 +69,8 @@ export class Process extends APIResource {
     params: ProcessResizeParams,
     options?: RequestOptions,
   ): APIPromise<ProcessResizeResponse> {
-    const { id, ...body } = params;
-    return this._client.post(path`/browsers/${id}/process/${processID}/resize`, { body, ...options });
+    const { id_or_name, ...body } = params;
+    return this._client.post(path`/browsers/${id_or_name}/process/${processID}/resize`, { body, ...options });
   }
 
   /**
@@ -74,13 +78,18 @@ export class Process extends APIResource {
    *
    * @example
    * ```ts
-   * const response = await client.browsers.process.spawn('id', {
-   *   command: 'command',
-   * });
+   * const response = await client.browsers.process.spawn(
+   *   'htzv5orfit78e1m2biiifpbv',
+   *   { command: 'command' },
+   * );
    * ```
    */
-  spawn(id: string, body: ProcessSpawnParams, options?: RequestOptions): APIPromise<ProcessSpawnResponse> {
-    return this._client.post(path`/browsers/${id}/process/spawn`, { body, ...options });
+  spawn(
+    idOrName: string,
+    body: ProcessSpawnParams,
+    options?: RequestOptions,
+  ): APIPromise<ProcessSpawnResponse> {
+    return this._client.post(path`/browsers/${idOrName}/process/spawn`, { body, ...options });
   }
 
   /**
@@ -90,7 +99,7 @@ export class Process extends APIResource {
    * ```ts
    * const response = await client.browsers.process.status(
    *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
-   *   { id: 'id' },
+   *   { id_or_name: 'htzv5orfit78e1m2biiifpbv' },
    * );
    * ```
    */
@@ -99,8 +108,8 @@ export class Process extends APIResource {
     params: ProcessStatusParams,
     options?: RequestOptions,
   ): APIPromise<ProcessStatusResponse> {
-    const { id } = params;
-    return this._client.get(path`/browsers/${id}/process/${processID}/status`, options);
+    const { id_or_name } = params;
+    return this._client.get(path`/browsers/${id_or_name}/process/${processID}/status`, options);
   }
 
   /**
@@ -110,7 +119,10 @@ export class Process extends APIResource {
    * ```ts
    * const response = await client.browsers.process.stdin(
    *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
-   *   { id: 'id', data_b64: 'data_b64' },
+   *   {
+   *     id_or_name: 'htzv5orfit78e1m2biiifpbv',
+   *     data_b64: 'data_b64',
+   *   },
    * );
    * ```
    */
@@ -119,8 +131,8 @@ export class Process extends APIResource {
     params: ProcessStdinParams,
     options?: RequestOptions,
   ): APIPromise<ProcessStdinResponse> {
-    const { id, ...body } = params;
-    return this._client.post(path`/browsers/${id}/process/${processID}/stdin`, { body, ...options });
+    const { id_or_name, ...body } = params;
+    return this._client.post(path`/browsers/${id_or_name}/process/${processID}/stdin`, { body, ...options });
   }
 
   /**
@@ -130,7 +142,7 @@ export class Process extends APIResource {
    * ```ts
    * const response = await client.browsers.process.stdoutStream(
    *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
-   *   { id: 'id' },
+   *   { id_or_name: 'htzv5orfit78e1m2biiifpbv' },
    * );
    * ```
    */
@@ -139,8 +151,8 @@ export class Process extends APIResource {
     params: ProcessStdoutStreamParams,
     options?: RequestOptions,
   ): APIPromise<Stream<ProcessStdoutStreamResponse>> {
-    const { id } = params;
-    return this._client.get(path`/browsers/${id}/process/${processID}/stdout/stream`, {
+    const { id_or_name } = params;
+    return this._client.get(path`/browsers/${id_or_name}/process/${processID}/stdout/stream`, {
       ...options,
       headers: buildHeaders([{ Accept: 'text/event-stream' }, options?.headers]),
       stream: true,
@@ -312,9 +324,9 @@ export interface ProcessExecParams {
 
 export interface ProcessKillParams {
   /**
-   * Path param: Browser session ID
+   * Path param: Browser session ID or name
    */
-  id: string;
+  id_or_name: string;
 
   /**
    * Body param: Signal to send.
@@ -324,9 +336,9 @@ export interface ProcessKillParams {
 
 export interface ProcessResizeParams {
   /**
-   * Path param: Browser session ID
+   * Path param: Browser session ID or name
    */
-  id: string;
+  id_or_name: string;
 
   /**
    * Body param: New terminal columns.
@@ -393,16 +405,16 @@ export interface ProcessSpawnParams {
 
 export interface ProcessStatusParams {
   /**
-   * Browser session ID
+   * Browser session ID or name
    */
-  id: string;
+  id_or_name: string;
 }
 
 export interface ProcessStdinParams {
   /**
-   * Path param: Browser session ID
+   * Path param: Browser session ID or name
    */
-  id: string;
+  id_or_name: string;
 
   /**
    * Body param: Base64-encoded data to write.
@@ -412,9 +424,9 @@ export interface ProcessStdinParams {
 
 export interface ProcessStdoutStreamParams {
   /**
-   * Browser session ID
+   * Browser session ID or name
    */
-  id: string;
+  id_or_name: string;
 }
 
 export declare namespace Process {

package/src/resources/browsers/replays.ts

@@ -15,11 +15,13 @@ export class Replays extends APIResource {
    *
    * @example
    * ```ts
-   * const replays = await client.browsers.replays.list('id');
+   * const replays = await client.browsers.replays.list(
+   *   'htzv5orfit78e1m2biiifpbv',
+   * );
    * ```
    */
-  list(id: string, options?: RequestOptions): APIPromise<ReplayListResponse> {
-    return this._client.get(path`/browsers/${id}/replays`, options);
+  list(idOrName: string, options?: RequestOptions): APIPromise<ReplayListResponse> {
+    return this._client.get(path`/browsers/${idOrName}/replays`, options);
   }
 
   /**
@@ -29,7 +31,7 @@ export class Replays extends APIResource {
    * ```ts
    * const response = await client.browsers.replays.download(
    *   'replay_id',
-   *   { id: 'id' },
+   *   { id_or_name: 'htzv5orfit78e1m2biiifpbv' },
    * );
    *
    * const content = await response.blob();
@@ -37,8 +39,8 @@ export class Replays extends APIResource {
    * ```
    */
   download(replayID: string, params: ReplayDownloadParams, options?: RequestOptions): APIPromise<Response> {
-    const { id } = params;
-    return this._client.get(path`/browsers/${id}/replays/${replayID}`, {
+    const { id_or_name } = params;
+    return this._client.get(path`/browsers/${id_or_name}/replays/${replayID}`, {
       ...options,
       headers: buildHeaders([{ Accept: 'video/mp4' }, options?.headers]),
       __binaryResponse: true,
@@ -50,15 +52,17 @@ export class Replays extends APIResource {
    *
    * @example
    * ```ts
-   * const response = await client.browsers.replays.start('id');
+   * const response = await client.browsers.replays.start(
+   *   'htzv5orfit78e1m2biiifpbv',
+   * );
    * ```
    */
   start(
-    id: string,
+    idOrName: string,
     body: ReplayStartParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<ReplayStartResponse> {
-    return this._client.post(path`/browsers/${id}/replays`, { body, ...options });
+    return this._client.post(path`/browsers/${idOrName}/replays`, { body, ...options });
   }
 
   /**
@@ -67,13 +71,13 @@ export class Replays extends APIResource {
    * @example
    * ```ts
    * await client.browsers.replays.stop('replay_id', {
-   *   id: 'id',
+   *   id_or_name: 'htzv5orfit78e1m2biiifpbv',
    * });
    * ```
    */
   stop(replayID: string, params: ReplayStopParams, options?: RequestOptions): APIPromise<void> {
-    const { id } = params;
-    return this._client.post(path`/browsers/${id}/replays/${replayID}/stop`, {
+    const { id_or_name } = params;
+    return this._client.post(path`/browsers/${id_or_name}/replays/${replayID}/stop`, {
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
@@ -136,9 +140,9 @@ export interface ReplayStartResponse {
 
 export interface ReplayDownloadParams {
   /**
-   * Browser session ID
+   * Browser session ID or name
    */
-  id: string;
+  id_or_name: string;
 }
 
 export interface ReplayStartParams {
@@ -162,9 +166,9 @@ export interface ReplayStartParams {
 
 export interface ReplayStopParams {
   /**
-   * Browser session ID
+   * Browser session ID or name
    */
-  id: string;
+  id_or_name: string;
 }
 
 export declare namespace Replays {

package/src/resources/browsers/telemetry.ts

@@ -23,19 +23,19 @@ export class Telemetry extends APIResource {
    * ```ts
    * // Automatically fetches more pages as needed.
    * for await (const telemetryEventsResponse of client.browsers.telemetry.events(
-   *   'id',
+   *   'htzv5orfit78e1m2biiifpbv',
    * )) {
    *   // ...
    * }
    * ```
    */
   events(
-    id: string,
+    idOrName: string,
     query: TelemetryEventsParams | null | undefined = {},
     options?: RequestOptions,
   ): PagePromise<TelemetryEventsResponsesOffsetPagination, TelemetryEventsResponse> {
     return this._client.getAPIList(
-      path`/browsers/${id}/telemetry/events`,
+      path`/browsers/${idOrName}/telemetry/events`,
       OffsetPagination<TelemetryEventsResponse>,
       { query, ...options },
     );
@@ -55,17 +55,17 @@ export class Telemetry extends APIResource {
    * @example
    * ```ts
    * const response = await client.browsers.telemetry.stream(
-   *   'id',
+   *   'htzv5orfit78e1m2biiifpbv',
    * );
    * ```
    */
   stream(
-    id: string,
+    idOrName: string,
     params: TelemetryStreamParams | undefined = {},
     options?: RequestOptions,
   ): APIPromise<Stream<TelemetryStreamResponse>> {
     const { 'Last-Event-ID': lastEventID, ...query } = params ?? {};
-    return this._client.get(path`/browsers/${id}/telemetry/stream`, {
+    return this._client.get(path`/browsers/${idOrName}/telemetry/stream`, {
       query,
       ...options,
       headers: buildHeaders([

package/src/resources/browsers/webmcp.ts

@@ -0,0 +1,196 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+/**
+ * Discover and invoke native page tools across the browser instance.
+ */
+export class Webmcp extends APIResource {
+  /**
+   * Invokes the exact live registration identified by tool_ref and waits
+   * synchronously for its result. Navigation during execution is allowed. If the tab
+   * or embedded frame disappears, or the request times out after invocation begins,
+   * the response reports outcome_unknown and the tool is not retried.
+   *
+   * @example
+   * ```ts
+   * const invocationResult =
+   *   await client.browsers.webmcp.invokeTool(
+   *     'htzv5orfit78e1m2biiifpbv',
+   *     {
+   *       input: { foo: 'bar' },
+   *       tool_ref: 'x',
+   *     },
+   *   );
+   * ```
+   */
+  invokeTool(
+    idOrName: string,
+    body: WebmcpInvokeToolParams,
+    options?: RequestOptions,
+  ): APIPromise<InvocationResult> {
+    return this._client.post(path`/browsers/${idOrName}/webmcp/invoke`, { body, ...options });
+  }
+
+  /**
+   * Returns a snapshot of native WebMCP tools available across every open tab and
+   * embedded frame in the browser. Each tool includes an opaque tool_ref for
+   * invoking that exact live registration. Tools disappear when their document
+   * closes or navigates away.
+   *
+   * @example
+   * ```ts
+   * const toolsResponse =
+   *   await client.browsers.webmcp.listTools(
+   *     'htzv5orfit78e1m2biiifpbv',
+   *   );
+   * ```
+   */
+  listTools(idOrName: string, options?: RequestOptions): APIPromise<ToolsResponse> {
+    return this._client.get(path`/browsers/${idOrName}/webmcp/tools`, options);
+  }
+}
+
+export interface InvocationFailure {
+  code: 'outcome_unknown';
+
+  message: string;
+
+  invocation_id?: string;
+}
+
+export interface InvocationResult {
+  invocation_id: string;
+
+  status: 'completed' | 'canceled' | 'error';
+
+  error_text?: string;
+
+  /**
+   * Untrusted page-provided output. Callers must treat it as potentially malicious
+   * input.
+   */
+  output?: unknown;
+}
+
+export interface InvokeRequest {
+  /**
+   * Tool input, limited to 1 MiB after JSON serialization.
+   */
+  input: { [key: string]: unknown };
+
+  tool_ref: string;
+
+  timeout_sec?: number;
+}
+
+export interface Tool {
+  description: string;
+
+  input_schema: { [key: string]: unknown };
+
+  name: string;
+
+  source: ToolSource;
+
+  /**
+   * Opaque reference for invoking this exact live registration. It becomes invalid
+   * when its document or browser process is replaced.
+   */
+  tool_ref: string;
+
+  /**
+   * Page-provided behavioral hints. These values are untrusted and are not enforced
+   * by Kernel.
+   */
+  annotations?: ToolAnnotations;
+}
+
+/**
+ * Page-provided behavioral hints. These values are untrusted and are not enforced
+ * by Kernel.
+ */
+export interface ToolAnnotations {
+  autosubmit: boolean;
+
+  consequential: boolean;
+
+  read_only: boolean;
+
+  untrusted_content: boolean;
+}
+
+export interface ToolFrame {
+  /**
+   * Monotonically increasing identifier for this embedded frame during the current
+   * browser process.
+   */
+  frame_id: number;
+
+  /**
+   * Current frame URL with the fragment omitted.
+   */
+  url: string;
+}
+
+export interface ToolSource {
+  /**
+   * Embedded frame that registered the tool, or null when the top-level page
+   * registered it.
+   */
+  frame: ToolFrame | null;
+
+  /**
+   * Current title of the top-level page.
+   */
+  page_title: string;
+
+  /**
+   * Current URL of the top-level page with the fragment omitted.
+   */
+  page_url: string;
+
+  /**
+   * Monotonically increasing identifier for the tab during the current browser
+   * process.
+   */
+  tab_id: number;
+
+  /**
+   * Monotonically increasing identifier for the browser window during the current
+   * browser process.
+   */
+  window_id: number;
+}
+
+export interface ToolsResponse {
+  tools: Array<Tool>;
+}
+
+export interface WebmcpInvokeToolParams {
+  /**
+   * Tool input, limited to 1 MiB after JSON serialization.
+   */
+  input: { [key: string]: unknown };
+
+  tool_ref: string;
+
+  timeout_sec?: number;
+}
+
+export declare namespace Webmcp {
+  export {
+    type InvocationFailure as InvocationFailure,
+    type InvocationResult as InvocationResult,
+    type InvokeRequest as InvokeRequest,
+    type Tool as Tool,
+    type ToolAnnotations as ToolAnnotations,
+    type ToolFrame as ToolFrame,
+    type ToolSource as ToolSource,
+    type ToolsResponse as ToolsResponse,
+    type WebmcpInvokeToolParams as WebmcpInvokeToolParams,
+  };
+}

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

@@ -15,8 +15,8 @@ export class ConfigRegistry extends APIResource {
   analyses: AnalysesAPI.Analyses = new AnalysesAPI.Analyses(this._client);
 
   /**
-   * Lists unique domains previously analyzed by the selected project with their
-   * current domain-level recommendations.
+   * Lists unique exact targets previously analyzed by the selected project with the
+   * recommendation produced by each target's latest analysis.
    *
    * @example
    * ```ts
@@ -431,22 +431,24 @@ export type RecommendationResult = Recommendation | NoRecommendation;
 
 export interface RecommendationSummary {
   /**
-   * ID of the most recently requested analysis for this domain.
+   * ID of the most recently requested analysis for this exact target.
    */
   analysis_id: string;
 
   /**
-   * Lifecycle status of the most recently requested analysis for this domain.
+   * Lifecycle status of the most recently requested analysis for this exact target.
    */
   analysis_status: 'running' | 'completed' | 'failed' | 'canceled';
 
   /**
-   * Most recent time the selected project requested an analysis for this domain.
+   * Most recent time the selected project requested an analysis for this exact
+   * target.
    */
   last_requested_at: string;
 
   /**
-   * Current domain-level recommendation. Null when no eligible knowledge exists.
+   * Recommendation produced by the latest analysis. Null when that analysis did not
+   * produce one.
    */
   recommendation: Recommendation | null;
 
@@ -456,13 +458,14 @@ export interface RecommendationSummary {
   recommended_config_label: string | null;
 
   /**
-   * Success rate for the recommended configuration. Null when no eligible knowledge
-   * exists.
+   * Success rate for the recommended configuration. Null when the latest analysis
+   * did not produce one.
    */
   success_rate: number | null;
 
   /**
-   * Registrable domain previously analyzed by the selected project.
+   * Normalized exact target previously analyzed by the selected project, including
+   * scheme, host, port, and path.
    */
   target: string;
 }
@@ -500,8 +503,8 @@ export interface Target {
 
 export interface ConfigRegistryListParams extends OffsetPaginationParams {
   /**
-   * Case-insensitive domain search. Full URLs are reduced to their registrable
-   * domain.
+   * Case-insensitive substring search over normalized targets, including domain,
+   * subdomain, and path.
    */
   search?: string;
 

package/src/resources/index.ts

@@ -50,6 +50,7 @@ export {
   type BrowserUsage,
   type Profile,
   type Tags,
+  type VaultReference,
   type BrowserCreateResponse,
   type BrowserRetrieveResponse,
   type BrowserUpdateResponse,
@@ -179,3 +180,10 @@ export {
   type ProxyListResponsesOffsetPagination,
 } from './proxies';
 export { Telemetry } from './telemetry/telemetry';
+export {
+  Vaults,
+  type Vault,
+  type VaultListParams,
+  type VaultUpsertParams,
+  type VaultsOffsetPagination,
+} from './vaults/vaults';

package/src/resources/invocations.ts

@@ -561,6 +561,17 @@ export namespace InvocationListBrowsersResponse {
      */
     usage?: BrowsersAPI.BrowserUsage;
 
+    /**
+     * Whether final usage billing is still pending or complete. Only present for
+     * deleted sessions.
+     */
+    usage_status?: 'pending' | 'ready';
+
+    /**
+     * Vaults linked when the browser session was created.
+     */
+    vaults?: Array<BrowsersAPI.VaultReference>;
+
     /**
      * Initial browser window size in pixels with optional refresh rate. If omitted,
      * image defaults apply (1920x1080@25). For GPU images, the default is