@onkernel/sdk 0.97.0 → 0.98.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/telemetry/destinations.ts

@@ -12,15 +12,19 @@ import { path } from '../../internal/utils/path';
  */
 export class Destinations extends APIResource {
   /**
-   * Create an OTLP export destination in the resolved project. Names must be unique
-   * within the project.
+   * Create an OTLP export destination in the authenticated organization. Names must
+   * be unique within the organization. Requires an organization-scoped credential or
+   * dashboard authentication; project-scoped credentials receive a 403.
    */
   create(body: DestinationCreateParams, options?: RequestOptions): APIPromise<OtlpDestination> {
     return this._client.post('/telemetry/destinations', { body, ...options });
   }
 
   /**
-   * Retrieve a single OTLP destination in the resolved project by its ID or name.
+   * Retrieve a customer-visible OTLP destination in the authenticated organization
+   * by its ID or name. Project-scoped credentials can retrieve these destinations
+   * for selection by workloads in their project. Non-dashboard reads return header
+   * values redacted.
    */
   retrieve(idOrName: string, options?: RequestOptions): APIPromise<OtlpDestination> {
     return this._client.get(path`/telemetry/destinations/${idOrName}`, options);
@@ -31,10 +35,11 @@ export class Destinations extends APIResource {
    * values without restarting, which makes this the way to rotate credentials
    * without interrupting export.
    *
-   * Names must be unique within the project. Renaming is refused with a 409 while a
-   * managed auth connection selects this destination by name, since that connection
-   * resolves the name on every login. Every other field, including `headers`, stays
-   * editable.
+   * Names must be unique within the organization. Renaming is refused with a 409
+   * while a managed auth connection selects this destination by name, since that
+   * connection resolves the name on every login. Every other field, including
+   * `headers`, stays editable. Requires an organization-scoped credential or
+   * dashboard authentication; project-scoped credentials receive a 403.
    */
   update(
     idOrName: string,
@@ -45,7 +50,10 @@ export class Destinations extends APIResource {
   }
 
   /**
-   * List OTLP export destinations in the resolved project.
+   * List customer-visible OTLP export destinations in the authenticated
+   * organization. Project-scoped credentials can list these destinations for
+   * selection by workloads in their project. Non-dashboard reads return header
+   * values redacted.
    */
   list(
     query: DestinationListParams | null | undefined = {},
@@ -63,6 +71,8 @@ export class Destinations extends APIResource {
    * end or delete them first. It is refused the same way while a managed auth
    * connection still selects it, because that connection re-resolves the destination
    * on every login, and while a managed auth login using it is still in progress.
+   * Requires an organization-scoped credential or dashboard authentication;
+   * project-scoped credentials receive a 403.
    */
   delete(idOrName: string, options?: RequestOptions): APIPromise<void> {
     return this._client.delete(path`/telemetry/destinations/${idOrName}`, {
@@ -91,13 +101,14 @@ export interface OtlpDestination {
 
   /**
    * Headers sent with each export request. Names are returned in canonical form
-   * (`Authorization`, not `authorization`). Values are returned redacted as empty
-   * strings, so the keys are visible but the credentials are not.
+   * (`Authorization`, not `authorization`). Non-dashboard reads return values
+   * redacted as empty strings, so the keys are visible but the credentials are not.
+   * Dashboard reads return the stored values.
    */
   headers: { [key: string]: string };
 
   /**
-   * Unique within the project. Usable in place of the ID when selecting a
+   * Unique within the organization. Usable in place of the ID when selecting a
    * destination, so it cannot be shaped like an ID.
    */
   name: string;
@@ -124,7 +135,7 @@ export interface DestinationCreateParams {
   endpoint: string;
 
   /**
-   * Unique within the project.
+   * Unique within the organization.
    */
   name: string;
 

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.97.0'; // x-release-please-version
+export const VERSION = '0.98.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.97.0";
+export declare const VERSION = "0.98.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.97.0'; // x-release-please-version
+exports.VERSION = '0.98.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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