@hyperbrowser/sdk 1.1.0 → 1.2.1

package/dist/services/webmcp.d.ts

@@ -0,0 +1,16 @@
+import { BaseService } from "./base";
+import { WebMCPInvocation, WebMCPInvokeParams, WebMCPInvokeResult, WebMCPResultParams, WebMCPStartParams, WebMCPToolsResponse } from "../types/webmcp";
+/** Page tools for sessions created with enableWebMcp: true. */
+export declare class WebMCPService extends BaseService {
+    private path;
+    /** Discover current tools across the session's tabs and frames. */
+    listTools(sessionId: string): Promise<WebMCPToolsResponse>;
+    /** Invoke once. Transport failures never cause an automatic retry. */
+    invoke(sessionId: string, params: WebMCPInvokeParams): Promise<WebMCPInvokeResult>;
+    /** Start once and return a handle. A lost response may mean the tool already ran. */
+    start(sessionId: string, params: WebMCPStartParams): Promise<WebMCPInvocation>;
+    /** Read or long-poll a handle. Pending responses do not cancel or restart the tool. */
+    getResult(sessionId: string, invocationId: string, params?: WebMCPResultParams): Promise<WebMCPInvocation>;
+    /** Request cancellation; completion can win the race. Read getResult for the outcome. */
+    cancel(sessionId: string, invocationId: string): Promise<WebMCPInvocation>;
+}

package/dist/services/webmcp.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebMCPService = void 0;
+const base_1 = require("./base");
+function seconds(value, min, max, name) {
+    if (!Number.isInteger(value) || value < min || value > max) {
+        throw new RangeError(`${name} must be an integer between ${min} and ${max}`);
+    }
+    return value;
+}
+function invocationBody(params) {
+    if (typeof params.toolRef !== "string" || !params.toolRef.trim()) {
+        throw new TypeError("toolRef must be a non-empty string from listTools");
+    }
+    if (params.input !== undefined &&
+        (params.input === null || typeof params.input !== "object" || Array.isArray(params.input))) {
+        throw new TypeError("input must be a JSON object");
+    }
+    return JSON.stringify(params);
+}
+/** Page tools for sessions created with enableWebMcp: true. */
+class WebMCPService extends base_1.BaseService {
+    path(sessionId) {
+        return `/session/${encodeURIComponent(sessionId)}/webmcp`;
+    }
+    /** Discover current tools across the session's tabs and frames. */
+    async listTools(sessionId) {
+        return this.request(`${this.path(sessionId)}/tools`, {
+            timeout: Math.max(this.timeout, 40000),
+        });
+    }
+    /** Invoke once. Transport failures never cause an automatic retry. */
+    async invoke(sessionId, params) {
+        const timeout = seconds(params.timeoutSeconds ?? 60, 1, 120, "timeoutSeconds");
+        return this.request(`${this.path(sessionId)}/invoke`, {
+            method: "POST",
+            body: invocationBody(params),
+            timeout: Math.max(this.timeout, (timeout + 35) * 1000),
+        });
+    }
+    /** Start once and return a handle. A lost response may mean the tool already ran. */
+    async start(sessionId, params) {
+        seconds(params.timeoutSeconds ?? 300, 1, 3600, "timeoutSeconds");
+        return this.request(`${this.path(sessionId)}/invocations`, {
+            method: "POST",
+            body: invocationBody(params),
+            timeout: Math.max(this.timeout, 40000),
+        });
+    }
+    /** Read or long-poll a handle. Pending responses do not cancel or restart the tool. */
+    async getResult(sessionId, invocationId, params = {}) {
+        const wait = seconds(params.waitSeconds ?? 0, 0, 30, "waitSeconds");
+        return this.request(`${this.path(sessionId)}/invocations/${encodeURIComponent(invocationId)}`, { timeout: Math.max(this.timeout, (wait + 20) * 1000) }, { waitSeconds: params.waitSeconds });
+    }
+    /** Request cancellation; completion can win the race. Read getResult for the outcome. */
+    async cancel(sessionId, invocationId) {
+        return this.request(`${this.path(sessionId)}/invocations/${encodeURIComponent(invocationId)}/cancel`, { method: "POST", timeout: Math.max(this.timeout, 20000) });
+    }
+}
+exports.WebMCPService = WebMCPService;

package/dist/types/constants.d.ts

@@ -29,7 +29,7 @@ export type HyperAgentLlm = "gpt-5.6-luna" | "gpt-5.5" | "gpt-5.2" | "gpt-5.1" |
 export type GeminiComputerUseLlm = "gemini-3.8-flash" | "gemini-3.7-flash" | "gemini-3.6-flash" | "gemini-3.5-flash" | "gemini-3.5-flash-lite" | "gemini-3-flash-preview" | "gemini-2.5-computer-use-preview-10-2025";
 export type GrokComputerUseLlm = "grok-4.7" | "grok-4.6" | "grok-4.5";
 export type GrokReasoningEffort = "low" | "medium" | "high";
-export type MetaComputerUseLlm = "muse-spark-1.1" | "muse-spark-1.2" | "muse-spark-1.3";
+export type MetaComputerUseLlm = "muse-spark-1.1" | "muse-spark-1.2" | "muse-spark-1.3" | "muse-wonder-1.0";
 export type MetaReasoningEffort = "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
 export type JevComputerUseLlm = "jev-1.13.0" | "jev-latest";
 export type JevTextLlm = "gemini-3.5-flash-lite";

package/dist/types/index.d.ts

@@ -1,4 +1,5 @@
 export { HyperbrowserConfig } from "./config";
+export * from "./webmcp";
 export { StartCrawlJobParams, StartCrawlJobResponse, CrawledPage, CrawlJobResponse, GetCrawlJobParams, CrawlJobStatusResponse, } from "./crawl";
 export { StartScrapeJobParams, StartScrapeJobResponse, ScrapeJobData, ScrapeJobResponse, ScrapeOptions, ScrapeJobStatusResponse, BatchScrapeJobStatusResponse, StorageStateOptions, } from "./scrape";
 export { StartExtractJobParams, StartExtractJobResponse, ExtractJobResponse, ExtractJobStatusResponse, ExtractJobMetadata, } from "./extract";
@@ -11,8 +12,9 @@ export { StartGrokComputerUseTaskParams, StartGrokComputerUseTaskResponse, GrokC
 export { StartMetaComputerUseTaskParams, StartMetaComputerUseTaskResponse, MetaComputerUseTaskStatusResponse, MetaComputerUseTaskResponse, MetaComputerUseTaskData, MetaComputerUseStepResponse, MetaComputerUseStepError, MetaComputerUseStepIncompleteDetails, MetaComputerUseStepReasoning, MetaComputerUseApiKeys, MetaComputerUseTaskMetadata, } from "./agents/meta-computer-use";
 export { StartJevComputerUseTaskParams, StartJevComputerUseTaskResponse, JevComputerUseTaskStatusResponse, JevComputerUseTaskResponse, JevComputerUseTaskData, JevComputerUseStepResponse, JevComputerUseApiKeys, JevComputerUseTaskMetadata, } from "./agents/jev-computer-use";
 export { BasicResponse, BrowserMemorySize, SessionStatus, Session, SessionDetail, SessionGetParams, SessionListParams, SessionListResponse, ScreenConfig, CaptchaEvaluationPageResult, CaptchaEvaluationParams, CaptchaEvaluationResponse, CaptchaEvaluationTarget, CaptchaEvaluationType, CaptchaSolverType, CreateSessionParams, CreateSessionSnapshotResponse, GetSessionDownloadsUrlResponse, GetSessionVideoRecordingUrlResponse, GetSessionRecordingUrlResponse, ImageCaptchaParam, UploadFileResponse, UploadFileOptions, GetActiveSessionsCountResponse, SessionEventLogListParams, SessionEventLogListResponse, SessionEventLog, SessionProfile, SessionLaunchState, SessionCreditBreakdown, StartSessionFromSnapshotParams, UpdateSessionProfileParams, UpdateSessionProxyLocationParams, UpdateSessionProxyParams, UpdateSessionScreenParams, UpdateSessionSolveCaptchasParams, UpdateSessionSolveCaptchasResponse, } from "./session";
-export { SandboxStatus, SandboxRuntimeTarget, SandboxNetworkPolicy, SandboxNetworkPolicyPatch, SandboxNetworkUpdateResult, Sandbox, SandboxDetail, SandboxVolumeMountType, SandboxVolumeMount, SandboxListParams, SandboxListResponse, SandboxImageSource, SandboxImageSummary, SandboxImageListParams, SandboxImageListResponse, SandboxSnapshotStatus, SandboxSnapshotSummary, SandboxSnapshotListParams, SandboxSnapshotListResponse, SandboxSnapshotDeleteResult, SandboxImageDeleteResult, SandboxImageInit, SandboxImageBuildStatus, SandboxImageBuildInputFormat, SandboxImageBuildSourcePlatform, SandboxImageBuildUpload, SandboxImageBuild, SandboxBuildContextBundle, SandboxBuildContextMode, SandboxBuildContextManifest, SandboxDockerImageConfig, SandboxDockerImageLayer, SandboxDockerImageManifest, CreateSandboxImageBuildParams, ReuseSandboxDockerImageParams, CompleteSandboxImageBuildParams, SandboxImageBuildCreateResult, SandboxDockerImageReuseResult, SandboxImageBuildResolutionOutcome, SandboxImageBuildResolution, SandboxImageBuildWaitOptions, BuildSandboxImageFromDockerImageOptions, BuildSandboxImageFromDockerfileOptions, GetOrBuildSandboxImageOptions, SandboxImageBuildListParams, SandboxImageBuildListResponse, CreateSandboxParams, SandboxMemorySnapshotParams, SandboxMemorySnapshotResult, SandboxExposeParams, SandboxExposeResult, SandboxUnexposeResult, SandboxProcessStatus, SandboxExecParams, SandboxExecOptions, SandboxProcessSummary, SandboxProcessResult, SandboxProcessListParams, SandboxProcessListResponse, SandboxProcessWaitParams, SandboxProcessSignal, SandboxProcessStdinParams, SandboxProcessOutputEvent, SandboxProcessExitEvent, SandboxProcessStreamEvent, SandboxFileType, SandboxFileInfo, SandboxFileWriteInfo, SandboxFileListOptions, SandboxFileReadFormat, SandboxFileReadOptions, SandboxFileWriteData, SandboxFileWriteEntry, SandboxFileTextWriteOptions, SandboxFileBytesWriteOptions, SandboxFileMakeDirOptions, SandboxFileCopyParams, SandboxFileChmodParams, SandboxFileChownParams, SandboxFileTransferResult, SandboxFileSystemEventType, SandboxFileSystemEvent, SandboxWatchDirOptions, SandboxPresignFileParams, SandboxPresignedUrl, SandboxTerminalCreateParams, SandboxTerminalOutputChunk, SandboxTerminalStatus, SandboxTerminalWaitParams, SandboxTerminalKillParams, SandboxTerminalEvent, } from "./sandbox";
+export { SandboxStatus, SandboxRuntimeTarget, SandboxNetworkPolicy, SandboxNetworkPolicyPatch, SandboxNetworkUpdateResult, Sandbox, SandboxDetail, SandboxVolumeMountType, SandboxVolumeMount, SandboxSecretReference, SandboxSecrets, SandboxResolvedSecret, SandboxListParams, SandboxListResponse, SandboxImageSource, SandboxImageSummary, SandboxImageListParams, SandboxImageListResponse, SandboxSnapshotStatus, SandboxSnapshotSummary, SandboxSnapshotListParams, SandboxSnapshotListResponse, SandboxSnapshotDeleteResult, SandboxImageDeleteResult, SandboxImageInit, SandboxImageBuildStatus, SandboxImageBuildInputFormat, SandboxImageBuildSourcePlatform, SandboxImageBuildUpload, SandboxImageBuild, SandboxBuildContextBundle, SandboxBuildContextMode, SandboxBuildContextManifest, SandboxDockerImageConfig, SandboxDockerImageLayer, SandboxDockerImageManifest, CreateSandboxImageBuildParams, ReuseSandboxDockerImageParams, CompleteSandboxImageBuildParams, SandboxImageBuildCreateResult, SandboxDockerImageReuseResult, SandboxImageBuildResolutionOutcome, SandboxImageBuildResolution, SandboxImageBuildWaitOptions, BuildSandboxImageFromDockerImageOptions, BuildSandboxImageFromDockerfileOptions, GetOrBuildSandboxImageOptions, SandboxImageBuildListParams, SandboxImageBuildListResponse, CreateSandboxParams, SandboxMemorySnapshotParams, SandboxMemorySnapshotResult, SandboxExposeParams, SandboxExposeResult, SandboxUnexposeResult, SandboxProcessStatus, SandboxExecParams, SandboxExecOptions, SandboxProcessSummary, SandboxProcessResult, SandboxProcessListParams, SandboxProcessListResponse, SandboxProcessWaitParams, SandboxProcessSignal, SandboxProcessStdinParams, SandboxProcessOutputEvent, SandboxProcessExitEvent, SandboxProcessStreamEvent, SandboxFileType, SandboxFileInfo, SandboxFileWriteInfo, SandboxFileListOptions, SandboxFileReadFormat, SandboxFileReadOptions, SandboxFileWriteData, SandboxFileWriteEntry, SandboxFileTextWriteOptions, SandboxFileBytesWriteOptions, SandboxFileMakeDirOptions, SandboxFileCopyParams, SandboxFileChmodParams, SandboxFileChownParams, SandboxFileTransferResult, SandboxFileSystemEventType, SandboxFileSystemEvent, SandboxWatchDirOptions, SandboxPresignFileParams, SandboxPresignedUrl, SandboxTerminalCreateParams, SandboxTerminalOutputChunk, SandboxTerminalStatus, SandboxTerminalWaitParams, SandboxTerminalKillParams, SandboxTerminalEvent, } from "./sandbox";
 export { CreateVolumeParams, Volume, VolumeListParams, VolumeListResponse, VolumeDeleteResult, } from "./volume";
+export { SecretValue, SecretsPublicKey, SecretsPublicKeyJwk, Secret, SecretVersion, SecretDetail, CreateSecretParams, UpdateSecretParams, SecretListParams, SecretListResponse, SecretDeleteResult, SecretVersionDeleteResult, } from "./secret";
 export { CreateProfileParams, ForkProfileParams, ProfileResponse, CreateProfileResponse, ProfileListParams, ProfileListResponse, } from "./profile";
 export { CreateExtensionParams, CreateExtensionResponse, ListExtensionsResponse, } from "./extension";
 export { ExtractJobStatus, BrowserUseTaskStatus, BrowserUseLlm, ClaudeComputerUseLlm, ClaudeComputerUseReasoningEffort, CuaLlm, CuaReasoningEffort, GeminiComputerUseLlm, GrokComputerUseLlm, GrokReasoningEffort, MetaComputerUseLlm, MetaReasoningEffort, JevComputerUseLlm, JevTextLlm, ScrapeScreenshotFormat, ScrapeJobStatus, CrawlJobStatus, Country, State, ISO639_1, OperatingSystem, Platform, ScrapeFormat, ScrapeWaitUntil, ScrapePageStatus, CrawlPageStatus, RecordingStatus, DownloadsStatus, HyperAgentLlm, HyperAgentTaskStatus, ClaudeComputerUseTaskStatus, CuaTaskStatus, GeminiComputerUseTaskStatus, GrokComputerUseTaskStatus, MetaComputerUseTaskStatus, JevComputerUseTaskStatus, SessionEventLogType, SessionRegion, BrowserUseVersion, HyperAgentVersion, } from "./constants";

package/dist/types/index.js

@@ -1,5 +1,20 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ComputerAction = void 0;
+__exportStar(require("./webmcp"), exports);
 var computer_action_1 = require("./computer-action");
 Object.defineProperty(exports, "ComputerAction", { enumerable: true, get: function () { return computer_action_1.ComputerAction; } });

package/dist/types/sandbox.d.ts

@@ -59,12 +59,34 @@ export interface Sandbox {
     network?: SandboxNetworkPolicy | null;
     runtime: SandboxRuntimeTarget;
     exposedPorts: SandboxExposeResult[];
+    /**
+     * Secrets were delivered into the sandbox, or it was restored from a
+     * snapshot that may hold them.
+     */
+    containsSecrets?: boolean;
 }
 export interface SandboxDetail extends Sandbox {
     token: string | null;
     tokenExpiresAt: string | null;
 }
 export type SandboxVolumeMountType = "rw" | "ro";
+/**
+ * A stored secret to deliver as an environment variable: its name, or
+ * `{ name, version }` to pin a version. The latest version is used otherwise.
+ */
+export type SandboxSecretReference = string | {
+    name: string;
+    version?: number | "latest";
+};
+/** Environment variable name to secret, at most 32 per process or sandbox. */
+export type SandboxSecrets = Record<string, SandboxSecretReference>;
+/** The secret version an environment variable received. */
+export interface SandboxResolvedSecret {
+    env: string;
+    name: string;
+    secretId: string;
+    version: number;
+}
 export interface SandboxVolumeMount {
     id: string;
     type?: SandboxVolumeMountType;
@@ -89,6 +111,7 @@ export type CreateSandboxParams = (SandboxCreateCommonParams & {
     cpu?: never;
     memoryMiB?: never;
     diskMiB?: never;
+    secrets?: never;
 }) | (SandboxCreateCommonParams & {
     snapshotName?: never;
     snapshotId?: never;
@@ -97,6 +120,12 @@ export type CreateSandboxParams = (SandboxCreateCommonParams & {
     cpu?: number;
     memoryMiB?: number;
     diskMiB?: number;
+    /**
+     * Secrets for the image's startup command only; requires the API key's
+     * `secrets.use` scope and is not supported with `runtimeClass:
+     * "gvisor-cpu"`. The sandbox is marked as containing secrets.
+     */
+    secrets?: SandboxSecrets;
 });
 export interface SandboxListParams {
     status?: SandboxStatus;
@@ -157,6 +186,8 @@ export interface SandboxSnapshotSummary {
     compatibilityTag?: string | null;
     metadata: Record<string, unknown>;
     uploaded: boolean;
+    /** The snapshot's memory may hold secrets. */
+    containsSecrets?: boolean;
     createdAt: string;
     updatedAt: string;
 }
@@ -409,6 +440,17 @@ export interface SandboxExecParams {
     timeoutMs?: number;
     timeoutSec?: number;
     runAs?: string;
+    /**
+     * Stored secrets to deliver as environment variables of this process only.
+     * The process is started through the control API, which has the sandbox
+     * service decrypt them; requires the API key's `secrets.use` scope. Anything
+     * running as the same user (or root) in the sandbox can read the process's
+     * environment, and the sandbox is marked as containing secrets.
+     *
+     * Output is read back from the process's retained output rather than the
+     * start stream, so `maxOutputBytes` does not apply.
+     */
+    secrets?: SandboxSecrets;
     /** @deprecated Ignored for process APIs. */
     useShell?: boolean;
 }

package/dist/types/secret.d.ts

@@ -0,0 +1,67 @@
+/** A secret value: a UTF-8 string or its raw bytes, used byte-for-byte. */
+export type SecretValue = string | Uint8Array;
+export interface SecretsPublicKeyJwk {
+    kty: string;
+    n: string;
+    e: string;
+}
+/** The platform key that secret values are encrypted to before upload. */
+export interface SecretsPublicKey {
+    kid: string;
+    alg: string;
+    enc: string;
+    jwk: SecretsPublicKeyJwk;
+}
+export interface Secret {
+    id: string;
+    name: string;
+    description: string;
+    /** Bound into every envelope for this secret; the SDK uses it when encrypting. */
+    encryptionContext: string;
+    /** Null until a value is stored. */
+    latestVersion: number | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface SecretVersion {
+    version: number;
+    kid: string;
+    createdAt: string;
+}
+export interface SecretDetail extends Secret {
+    versions: SecretVersion[];
+}
+export interface CreateSecretParams {
+    /** 1-128 letters, digits, '_' or '-', starting with a letter or digit. */
+    name: string;
+    description?: string;
+    /**
+     * The first version's value. It is validated and the platform key is checked
+     * before the secret is created, then encrypted locally and uploaded.
+     */
+    value?: SecretValue;
+}
+export interface UpdateSecretParams {
+    description: string;
+}
+export interface SecretListParams {
+    search?: string;
+    page?: number;
+    /** At most 100. */
+    limit?: number;
+}
+export interface SecretListResponse {
+    secrets: Secret[];
+    totalCount: number;
+    page: number;
+    perPage: number;
+}
+export interface SecretDeleteResult {
+    deleted: boolean;
+    id: string;
+    name: string;
+}
+export interface SecretVersionDeleteResult {
+    deleted: boolean;
+    version: number;
+}

package/dist/types/secret.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/session.d.ts

@@ -10,6 +10,7 @@ export interface SessionProfile {
     persistChanges?: boolean;
 }
 export interface SessionLaunchState {
+    enableWebMcp?: boolean;
     useUltraStealth?: boolean;
     useStealth?: boolean;
     useProxy?: boolean;
@@ -128,6 +129,8 @@ export interface StartSessionFromSnapshotParams {
     snapshotId: string;
 }
 export interface CreateSessionParams {
+    /** Enable page-provided WebMCP tools. Defaults to false on the server. */
+    enableWebMcp?: boolean;
     useUltraStealth?: boolean;
     useStealth?: boolean;
     useProxy?: boolean;

package/dist/types/webmcp.d.ts

@@ -0,0 +1,84 @@
+/** Page-provided hints; these are not browser-enforced guarantees. */
+export interface WebMCPAnnotations {
+    readOnly: boolean;
+    untrustedContent: boolean;
+    consequential: boolean;
+    autosubmit: boolean;
+    destructive?: boolean;
+    idempotent?: boolean;
+    openWorld?: boolean;
+}
+export interface WebMCPFrame {
+    id: string;
+    url: string;
+    isMainFrame: boolean;
+}
+export interface WebMCPSource {
+    provider: "native" | "polyfill";
+    tabId: string;
+    pageUrl: string;
+    pageTitle: string;
+    frame: WebMCPFrame;
+}
+export interface WebMCPTool {
+    /** Opaque reference to this document. Discover tools again after navigation. */
+    toolRef: string;
+    name: string;
+    title?: string;
+    description: string;
+    inputSchema?: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+    annotations: WebMCPAnnotations;
+    declarative: boolean;
+    /** Native DOM node identifier, when available, in the source target/frame. */
+    backendNodeId?: number;
+    source: WebMCPSource;
+}
+export interface WebMCPToolsResponse {
+    tools: WebMCPTool[];
+    nativeSupported: boolean;
+    truncated: boolean;
+}
+export interface WebMCPInvokeParams {
+    toolRef: string;
+    /** Page-defined keys are passed through unchanged. Defaults to {}. */
+    input?: Record<string, unknown>;
+    /** Execution deadline in seconds: 1–120, default 60. */
+    timeoutSeconds?: number;
+}
+export interface WebMCPStartParams extends WebMCPInvokeParams {
+    /** Execution deadline including human submission: 1–3600 seconds, default 300. */
+    timeoutSeconds?: number;
+}
+export interface WebMCPResultParams {
+    /** Wait 0–30 seconds, default 0. A pending response does not cancel the tool. */
+    waitSeconds?: number;
+}
+export type WebMCPInvokeStatus = "completed" | "error" | "canceled" | "awaiting_submission";
+export type WebMCPInvocationStatus = WebMCPInvokeStatus | "running" | "outcome_unknown";
+export interface WebMCPInvokeResult {
+    invocationId?: string;
+    status: WebMCPInvokeStatus;
+    output?: unknown;
+    errorText?: string;
+    outputBytes: number;
+    outputTruncated?: boolean;
+    outputPreview?: string;
+    untrustedContent: boolean;
+    durationMs: number;
+}
+export interface WebMCPInvocationError {
+    code: string;
+    message: string;
+}
+/** Session-local record; results expire and do not survive receiver restarts. */
+export interface WebMCPInvocation {
+    invocationId: string;
+    toolRef: string;
+    status: WebMCPInvocationStatus;
+    cancellationRequested: boolean;
+    createdAt: string;
+    expiresAt?: string;
+    result?: WebMCPInvokeResult;
+    error?: WebMCPInvocationError;
+}

package/dist/types/webmcp.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperbrowser/sdk",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "description": "Node SDK for Hyperbrowser API",
   "author": "",
   "repository": {