@agent-native/core 0.175.0-nightly-20260826053817 → 0.175.0

package/dist/browser-sessions/actions.js

@@ -63,6 +63,8 @@ function compactSession(session) {
             requiresApproval: action.requiresApproval,
             schema: action.schema ?? action.parameters,
         })),
+        webmcpToolCount: session.webmcpTools?.length ?? 0,
+        webmcpTools: session.webmcpTools ?? [],
     };
 }
 export function createBrowserSessionActionEntries(options) {
@@ -142,6 +144,83 @@ export function createBrowserSessionActionEntries(options) {
                 return { ok: true, sessionId, actions };
             },
         },
+        "list-browser-session-webmcp-tools": {
+            readOnly: true,
+            tool: {
+                description: "List WebMCP tools exposed by a connected browser page. Use this before running one because names, schemas, origins, and read-only hints are page-local and can change after navigation.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        sessionId: {
+                            type: "string",
+                            description: "Browser session id from list-browser-sessions. Optional when only one tab is active.",
+                        },
+                        timeoutMs: {
+                            type: "number",
+                            description: "How long to wait for the live tab to respond.",
+                        },
+                    },
+                },
+            },
+            run: async (args) => {
+                const ownerEmail = requireOwner(options);
+                const sessionId = await resolveSessionId(ownerEmail, readString(args, "sessionId"));
+                const tools = await callBrowserSession(ownerEmail, sessionId, {
+                    type: "list-webmcp-tools",
+                    timeoutMs: readTimeoutMs(args, options),
+                }, { timeoutMs: readTimeoutMs(args, options) });
+                return { ok: true, sessionId, tools };
+            },
+        },
+        "run-browser-session-webmcp-tool": {
+            needsApproval: () => true,
+            tool: {
+                description: "Run a WebMCP tool exposed by a connected browser page. Use list-browser-session-webmcp-tools first, preserve its origin for duplicate names, and expect human approval for every execution.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        sessionId: {
+                            type: "string",
+                            description: "Browser session id from list-browser-sessions. Optional when only one tab is active.",
+                        },
+                        name: {
+                            type: "string",
+                            description: "The WebMCP tool name to run.",
+                        },
+                        origin: {
+                            type: "string",
+                            description: "The registered tool origin when the same name is exposed by multiple origins.",
+                        },
+                        args: {
+                            type: "object",
+                            description: "JSON-serializable arguments matching the discovered WebMCP input schema.",
+                        },
+                        timeoutMs: {
+                            type: "number",
+                            description: "How long to wait for the live tab to respond.",
+                        },
+                    },
+                    required: ["name"],
+                },
+            },
+            run: async (args) => {
+                const ownerEmail = requireOwner(options);
+                const name = readString(args, "name");
+                if (!name)
+                    throw new Error("name is required");
+                const timeoutMs = readTimeoutMs(args, options);
+                const sessionId = await resolveSessionId(ownerEmail, readString(args, "sessionId"));
+                const origin = readString(args, "origin");
+                const result = await callBrowserSession(ownerEmail, sessionId, {
+                    type: "run-webmcp-tool",
+                    name,
+                    origin,
+                    args: args.args,
+                    timeoutMs,
+                }, { timeoutMs });
+                return { ok: true, sessionId, name, result };
+            },
+        },
         "run-browser-session-action": {
             tool: {
                 description: "Run a live client action in a connected browser tab. Use list-browser-session-actions first to discover the current action names and schemas. Omit sessionId to use the most recently active tab.",

package/dist/browser-sessions/store.js

@@ -6,6 +6,8 @@ export const DEFAULT_BROWSER_SESSION_REQUEST_POLL_MS = 250;
 const SESSION_TABLE = "agent_native_browser_sessions";
 const REQUEST_TABLE = "agent_native_browser_session_requests";
 const SAFE_ID_RE = /^[A-Za-z0-9._:-]{1,160}$/;
+const MAX_WEBMCP_TOOL_COUNT = 100;
+const MAX_WEBMCP_MANIFEST_CHARS = 500_000;
 let initPromise;
 function nowMs() {
     return Date.now();
@@ -117,6 +119,60 @@ function parseActions(value) {
             typeof action.name === "string")
         : [];
 }
+function isWebMcpAction(action) {
+    return action.source === "webmcp";
+}
+function normalizeWebMcpTools(value) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value)) {
+        throw new Error("webmcpTools must be an array");
+    }
+    if (value.length > MAX_WEBMCP_TOOL_COUNT) {
+        throw new Error(`WebMCP returned more than the ${MAX_WEBMCP_TOOL_COUNT}-tool limit`);
+    }
+    let serialized;
+    try {
+        serialized = JSON.stringify(value);
+    }
+    catch {
+        throw new Error("WebMCP tool manifest must be JSON-serializable");
+    }
+    if (serialized === undefined) {
+        throw new Error("WebMCP tool manifest must be JSON-serializable");
+    }
+    if (serialized.length > MAX_WEBMCP_MANIFEST_CHARS) {
+        throw new Error(`WebMCP tool manifest exceeds the ${MAX_WEBMCP_MANIFEST_CHARS}-character limit`);
+    }
+    return value;
+}
+function toWebMcpAction(tool) {
+    return {
+        name: tool.name,
+        description: tool.description,
+        ...(tool.title ? { title: tool.title } : {}),
+        ...(tool.inputSchema ? { schema: tool.inputSchema } : {}),
+        ...(tool.origin ? { origin: tool.origin } : {}),
+        ...(tool.annotations ? { annotations: tool.annotations } : {}),
+        source: "webmcp",
+        availability: "browser-session",
+    };
+}
+function fromWebMcpAction(action) {
+    const schema = action.schema ?? action.parameters;
+    return {
+        name: action.name,
+        description: action.description,
+        ...(typeof action.title === "string" ? { title: action.title } : {}),
+        ...(schema ? { inputSchema: schema } : {}),
+        ...(typeof action.origin === "string" ? { origin: action.origin } : {}),
+        ...(action.annotations && typeof action.annotations === "object"
+            ? {
+                annotations: action.annotations,
+            }
+            : {}),
+    };
+}
 function parseSession(value, sessionId) {
     const parsed = safeJsonParse(value, { id: sessionId });
     return parsed && typeof parsed === "object" && !Array.isArray(parsed)
@@ -162,6 +218,7 @@ function normalizeSessionInput(input) {
         connectedAt: new Date(connectedAt).toISOString(),
         ...(url ? { url } : {}),
     };
+    const webmcpTools = normalizeWebMcpTools(input.webmcpTools);
     return {
         sessionId,
         session,
@@ -172,7 +229,10 @@ function normalizeSessionInput(input) {
             !Array.isArray(input.context)
             ? input.context
             : undefined,
-        actions: Array.isArray(input.actions) ? input.actions : [],
+        actions: [
+            ...(Array.isArray(input.actions) ? input.actions : []),
+            ...webmcpTools.map(toWebMcpAction),
+        ],
         connectedAt,
         ttlMs: typeof input.ttlMs === "number" && input.ttlMs > 0
             ? Math.min(input.ttlMs, 5 * 60 * 1000)
@@ -182,13 +242,15 @@ function normalizeSessionInput(input) {
 function rowToSession(row, now = nowMs()) {
     const sessionId = String(row.session_id ?? "");
     const expiresAt = Number(row.expires_at ?? 0);
+    const parsedActions = parseActions(row.actions_json);
     return {
         sessionId,
         session: parseSession(row.session_json, sessionId),
         label: typeof row.label === "string" ? row.label : undefined,
         url: typeof row.url === "string" ? row.url : undefined,
         context: parseOptionalObject(row.context_json),
-        actions: parseActions(row.actions_json),
+        actions: parsedActions.filter((action) => !isWebMcpAction(action)),
+        webmcpTools: parsedActions.filter(isWebMcpAction).map(fromWebMcpAction),
         connectedAt: Number(row.connected_at ?? 0),
         lastSeenAt: Number(row.last_seen_at ?? 0),
         expiresAt,
@@ -219,6 +281,20 @@ function rowToRequest(row) {
     };
     if (type === "run-action")
         request.args = payload;
+    else if (type === "run-webmcp-tool") {
+        const envelope = payload && typeof payload === "object" && !Array.isArray(payload)
+            ? payload
+            : undefined;
+        request.args =
+            envelope && "args" in envelope
+                ? envelope.args
+                : typeof envelope?.origin === "string" && envelope.origin
+                    ? {}
+                    : payload;
+        if (typeof envelope?.origin === "string" && envelope.origin) {
+            request.origin = envelope.origin;
+        }
+    }
     else
         request.payload = payload;
     return request;
@@ -339,14 +415,17 @@ function normalizeRequestInput(input) {
     if (input.type !== "get-context" &&
         input.type !== "list-actions" &&
         input.type !== "run-action" &&
+        input.type !== "list-webmcp-tools" &&
+        input.type !== "run-webmcp-tool" &&
         input.type !== "command") {
-        throw new Error("request type must be get-context, list-actions, run-action, or command");
+        throw new Error("request type must be get-context, list-actions, run-action, list-webmcp-tools, run-webmcp-tool, or command");
     }
     const name = typeof input.name === "string" && input.name.trim()
         ? input.name.trim()
         : undefined;
-    if (input.type === "run-action" && !name) {
-        throw new Error("name is required for run-action requests");
+    if ((input.type === "run-action" || input.type === "run-webmcp-tool") &&
+        !name) {
+        throw new Error("name is required for tool execution requests");
     }
     const command = typeof input.command === "string" && input.command.trim()
         ? input.command.trim()
@@ -356,8 +435,13 @@ function normalizeRequestInput(input) {
     return {
         type: input.type,
         name,
+        ...(input.origin ? { origin: input.origin } : {}),
         command,
-        payload: input.type === "run-action" ? input.args : input.payload,
+        payload: input.type === "run-action"
+            ? input.args
+            : input.type === "run-webmcp-tool"
+                ? { args: input.args, origin: input.origin }
+                : input.payload,
         timeoutMs: typeof input.timeoutMs === "number" && input.timeoutMs > 0
             ? Math.min(input.timeoutMs, 2 * 60 * 1000)
             : DEFAULT_BROWSER_SESSION_REQUEST_TIMEOUT_MS,

package/dist/browser-sessions/types.d.ts

@@ -1,4 +1,5 @@
-export type AgentNativeBrowserSessionRequestType = "get-context" | "list-actions" | "run-action" | "command";
+import type { AgentNativeWebMcpTool } from "../client/webmcp.js";
+export type AgentNativeBrowserSessionRequestType = "get-context" | "list-actions" | "run-action" | "list-webmcp-tools" | "run-webmcp-tool" | "command";
 export type AgentNativeBrowserSessionRequestStatus = "pending" | "claimed" | "completed" | "failed" | "expired";
 export type AgentNativeBrowserSessionJsonObject = Record<string, unknown>;
 export interface AgentNativeBrowserSessionAction {
@@ -27,6 +28,7 @@ export interface AgentNativeBrowserSessionRecord {
     url?: string;
     context?: AgentNativeBrowserSessionJsonObject;
     actions: AgentNativeBrowserSessionAction[];
+    webmcpTools?: AgentNativeWebMcpTool[];
     connectedAt: number;
     lastSeenAt: number;
     expiresAt: number;
@@ -37,6 +39,7 @@ export interface AgentNativeBrowserSessionRequest {
     sessionId: string;
     type: AgentNativeBrowserSessionRequestType;
     name?: string;
+    origin?: string;
     command?: string;
     args?: unknown;
     payload?: unknown;
@@ -55,11 +58,13 @@ export interface RegisterAgentNativeBrowserSessionInput {
     url?: string;
     context?: AgentNativeBrowserSessionJsonObject;
     actions?: AgentNativeBrowserSessionAction[];
+    webmcpTools?: AgentNativeWebMcpTool[];
     ttlMs?: number;
 }
 export interface CreateAgentNativeBrowserSessionRequestInput {
     type: AgentNativeBrowserSessionRequestType;
     name?: string;
+    origin?: string;
     command?: string;
     args?: unknown;
     payload?: unknown;

package/dist/client/AgentNativeEmbedded.d.ts

@@ -2,6 +2,7 @@ import React from "react";
 import { type AgentChatSurfaceProps, type AgentSidebarProps } from "./AgentPanel.js";
 import { type AgentNativeBrowserSessionBridge } from "./browser-session-bridge.js";
 import { type AgentNativeClientActions, type AgentNativeHostCommandHandlers, type AgentNativeHostContextGetter, type AgentNativeHostSession, type AgentNativeScreenSnapshotOptions } from "./host-bridge.js";
+import type { AgentNativeWebMcpClient } from "./webmcp.js";
 export interface AgentNativeEmbeddedCommandCallbackInfo {
     command: string;
     requestId?: string;
@@ -24,6 +25,8 @@ export interface UseAgentNativeEmbeddedBrowserSessionOptions {
     getContext?: AgentNativeHostContextGetter;
     screen?: boolean | AgentNativeScreenSnapshotOptions;
     commands?: AgentNativeHostCommandHandlers;
+    /** WebMCP tools this chat may consume from the current page. */
+    webmcp?: AgentNativeWebMcpClient;
     session?: string | Partial<AgentNativeHostSession>;
     browserSession?: AgentNativeEmbeddedBrowserSessionOptions;
     onRefresh?: AgentNativeEmbeddedCommandCallback;
@@ -42,5 +45,5 @@ export interface AgentNativeEmbeddedProps extends Omit<AgentSidebarProps, "child
     /** Props forwarded to AgentChatSurface in panel mode. */
     panel?: AgentChatSurfaceProps;
 }
-export declare function useAgentNativeEmbeddedBrowserSession({ enabled, actions, getContext, screen, commands, session, browserSession, onNavigate, onOpenResource, onRefresh, onRemount, onRequestApproval, }: UseAgentNativeEmbeddedBrowserSessionOptions): void;
-export declare function AgentNativeEmbedded({ children, surface, actions, getContext, enabled, screen, commands, session, browserSession, onNavigate, onOpenResource, onRefresh, onRemount, onRequestApproval, panel, ...sidebarProps }: AgentNativeEmbeddedProps): React.JSX.Element;
+export declare function useAgentNativeEmbeddedBrowserSession({ enabled, actions, getContext, screen, commands, webmcp, session, browserSession, onNavigate, onOpenResource, onRefresh, onRemount, onRequestApproval, }: UseAgentNativeEmbeddedBrowserSessionOptions): void;
+export declare function AgentNativeEmbedded({ children, surface, actions, getContext, enabled, screen, commands, webmcp, session, browserSession, onNavigate, onOpenResource, onRefresh, onRemount, onRequestApproval, panel, ...sidebarProps }: AgentNativeEmbeddedProps): React.JSX.Element;

package/dist/client/AgentNativeEmbedded.js

@@ -71,7 +71,7 @@ function useMergedEmbeddedCommands({ commands, onNavigate, onOpenResource, onRef
         onRequestApproval,
     ]);
 }
-export function useAgentNativeEmbeddedBrowserSession({ enabled = true, actions, getContext, screen = true, commands, session, browserSession, onNavigate, onOpenResource, onRefresh, onRemount, onRequestApproval, }) {
+export function useAgentNativeEmbeddedBrowserSession({ enabled = true, actions, getContext, screen = true, commands, webmcp, session, browserSession, onNavigate, onOpenResource, onRefresh, onRemount, onRequestApproval, }) {
     const mergedCommands = useMergedEmbeddedCommands({
         commands,
         onNavigate,
@@ -101,6 +101,7 @@ export function useAgentNativeEmbeddedBrowserSession({ enabled = true, actions,
             session,
             getContext: getMergedContext,
             actions,
+            webmcp,
             commands: mergedCommands,
         }).start();
         browserSession?.onReady?.(bridge);
@@ -119,15 +120,17 @@ export function useAgentNativeEmbeddedBrowserSession({ enabled = true, actions,
         getMergedContext,
         mergedCommands,
         session,
+        webmcp,
     ]);
 }
-export function AgentNativeEmbedded({ children, surface, actions, getContext, enabled, screen, commands, session, browserSession, onNavigate, onOpenResource, onRefresh, onRemount, onRequestApproval, panel, ...sidebarProps }) {
+export function AgentNativeEmbedded({ children, surface, actions, getContext, enabled, screen, commands, webmcp, session, browserSession, onNavigate, onOpenResource, onRefresh, onRemount, onRequestApproval, panel, ...sidebarProps }) {
     useAgentNativeEmbeddedBrowserSession({
         enabled,
         actions,
         getContext,
         screen,
         commands,
+        webmcp,
         session,
         browserSession,
         onNavigate,

package/dist/client/AgentNativeFrame.d.ts

@@ -1,5 +1,6 @@
 import React, { type IframeHTMLAttributes } from "react";
 import { type AgentNativeClientActions, type AgentNativeHostAuth, type AgentNativeHostBridge, type AgentNativeHostBridgeEvent, type AgentNativeHostCommandHandlers, type AgentNativeHostContextGetter, type AgentNativeHostSession } from "./host-bridge.js";
+import type { AgentNativeWebMcpClient } from "./webmcp.js";
 export interface AgentNativeFrameProps extends Omit<IframeHTMLAttributes<HTMLIFrameElement>, "src"> {
     /** URL of the Agent-Native sidecar/frame app. */
     agentUrl: string;
@@ -16,6 +17,8 @@ export interface AgentNativeFrameProps extends Omit<IframeHTMLAttributes<HTMLIFr
     commands?: AgentNativeHostCommandHandlers;
     /** Live browser-session actions the iframe sidecar can discover and call. */
     actions?: AgentNativeClientActions;
+    /** WebMCP tools the iframe sidecar may discover and call in the host page. */
+    webmcp?: AgentNativeWebMcpClient;
     /** Optional auth payload sent to the trusted iframe sidecar. */
     auth?: AgentNativeHostAuth;
     onBridgeEvent?: (event: AgentNativeHostBridgeEvent) => void;

package/dist/client/AgentNativeFrame.js

@@ -23,7 +23,7 @@ const defaultStyle = {
     width: "100%",
     height: "100%",
 };
-export const AgentNativeFrame = forwardRef(function AgentNativeFrame({ agentUrl, agentOrigin, session, getContext, commands, actions, auth, onBridgeEvent, onBridgeReady, title = "Agent Native assistant", sandbox = "allow-scripts allow-same-origin allow-forms allow-popups allow-downloads", allow = "clipboard-read; clipboard-write; microphone; fullscreen", referrerPolicy = "strict-origin-when-cross-origin", style, onLoad, ...iframeProps }, forwardedRef) {
+export const AgentNativeFrame = forwardRef(function AgentNativeFrame({ agentUrl, agentOrigin, session, getContext, commands, actions, webmcp, auth, onBridgeEvent, onBridgeReady, title = "Agent Native assistant", sandbox = "allow-scripts allow-same-origin allow-forms allow-popups allow-downloads", allow = "clipboard-read; clipboard-write; microphone; fullscreen", referrerPolicy = "strict-origin-when-cross-origin", style, onLoad, ...iframeProps }, forwardedRef) {
     const iframeRef = useRef(null);
     const bridgeRef = useRef(null);
     const resolvedOrigin = useMemo(() => agentOrigin ?? originFromUrl(agentUrl), [agentOrigin, agentUrl]);
@@ -34,6 +34,7 @@ export const AgentNativeFrame = forwardRef(function AgentNativeFrame({ agentUrl,
             getContext,
             commands,
             actions,
+            webmcp,
             auth,
             onEvent: onBridgeEvent,
             targetWindow: iframeRef.current?.contentWindow ?? null,
@@ -54,6 +55,7 @@ export const AgentNativeFrame = forwardRef(function AgentNativeFrame({ agentUrl,
         onBridgeReady,
         resolvedOrigin,
         session,
+        webmcp,
     ]);
     return (_jsx("iframe", { ...iframeProps, ref: (node) => {
             iframeRef.current = node;

package/dist/client/browser-session-bridge.d.ts

@@ -1,5 +1,6 @@
 import type { AgentNativeBrowserSessionRecord, AgentNativeBrowserSessionRequest } from "../browser-sessions/types.js";
 import { type AgentNativeClientActions, type AgentNativeHostRequestOptions, type AgentNativeHostCommandHandlers, type AgentNativeHostContextGetter, type AgentNativeHostSession } from "./host-bridge.js";
+import type { AgentNativeWebMcpClient } from "./webmcp.js";
 export interface AgentNativeBrowserSessionBridgeOptions extends AgentNativeHostRequestOptions {
     /** Framework browser-session endpoint. Defaults to /_agent-native/browser-sessions. */
     endpoint?: string;
@@ -17,6 +18,8 @@ export interface AgentNativeBrowserSessionBridgeOptions extends AgentNativeHostR
     getContext?: AgentNativeHostContextGetter;
     /** Direct in-app client actions exposed to backend browser-session tools. */
     actions?: AgentNativeClientActions;
+    /** WebMCP tools available in this document, or "host" through an iframe bridge. */
+    webmcp?: AgentNativeWebMcpClient | "host";
     /** Direct in-app host commands exposed to backend browser-session tools. */
     commands?: AgentNativeHostCommandHandlers;
     /** Origin label passed to direct action/command callbacks. */

package/dist/client/browser-session-bridge.js

@@ -1,6 +1,6 @@
 import { createPollEngine } from "../shared/poll-engine.js";
 import { agentNativePath } from "./api-path.js";
-import { announceAgentNativeFrameReady, defaultAgentNativeHostCommands, requestAgentNativeHostActions, requestAgentNativeHostContext, runAgentNativeHostAction, sendAgentNativeHostCommand, } from "./host-bridge.js";
+import { announceAgentNativeFrameReady, defaultAgentNativeHostCommands, requestAgentNativeHostActions, requestAgentNativeHostContext, requestAgentNativeHostWebMcpTools, runAgentNativeHostAction, runAgentNativeHostWebMcpTool, sendAgentNativeHostCommand, } from "./host-bridge.js";
 const DEFAULT_ENDPOINT = "/_agent-native/browser-sessions";
 const DEFAULT_HEARTBEAT_MS = 5_000;
 const DEFAULT_POLL_MS = 500;
@@ -95,14 +95,15 @@ async function deleteJson(options, path) {
     }
 }
 function hostRequestOptions(options) {
-    const { endpoint: _endpoint, sessionId: _sessionId, session: _session, getContext: _getContext, actions: _actions, commands: _commands, origin: _origin, label: _label, heartbeatMs: _heartbeatMs, pollMs: _pollMs, ttlMs: _ttlMs, fetch: _fetch, ...hostOptions } = options;
+    const { endpoint: _endpoint, sessionId: _sessionId, session: _session, getContext: _getContext, actions: _actions, webmcp: _webmcp, commands: _commands, origin: _origin, label: _label, heartbeatMs: _heartbeatMs, pollMs: _pollMs, ttlMs: _ttlMs, fetch: _fetch, ...hostOptions } = options;
     return hostOptions;
 }
 function hasDirectHost(options) {
     return Boolean(options.getContext ||
         options.actions ||
         options.commands ||
-        options.session);
+        options.session ||
+        (options.webmcp && options.webmcp !== "host"));
 }
 function directOrigin(options) {
     return options.origin || "agent-native-embedded";
@@ -169,6 +170,35 @@ async function resolveDirectActionManifest(options) {
         .map(toActionManifest)
         .filter(Boolean);
 }
+async function resolveWebMcpTools(options) {
+    if (!options.webmcp)
+        return undefined;
+    try {
+        if (options.webmcp === "host") {
+            return await requestAgentNativeHostWebMcpTools(hostRequestOptions(options));
+        }
+        if (!options.webmcp.supported)
+            return [];
+        return await options.webmcp.listTools();
+    }
+    catch (error) {
+        void error;
+        return undefined;
+    }
+}
+function requireDirectWebMcpClient(options) {
+    if (!options.webmcp || options.webmcp === "host") {
+        throw new Error("WebMCP is not enabled for this browser session");
+    }
+    return options.webmcp;
+}
+function findWebMcpTool(tools, name, origin) {
+    const matches = tools.filter((tool) => tool.name === name && (!origin || tool.origin === origin));
+    if (matches.length > 1 && !origin) {
+        throw new Error(`WebMCP tool "${name}" is exposed by multiple origins; origin is required`);
+    }
+    return matches[0];
+}
 async function findDirectAction(options, name) {
     const actions = await resolveClientActions(options.actions);
     return actions.find((action) => action.name === name);
@@ -196,6 +226,10 @@ async function executeDirectBrowserSessionRequest(request, options) {
     if (request.type === "list-actions") {
         return resolveDirectActionManifest(options);
     }
+    if (request.type === "list-webmcp-tools") {
+        const tools = await requireDirectWebMcpClient(options).listTools();
+        return tools;
+    }
     if (request.type === "run-action") {
         if (!request.name) {
             throw new Error("Browser-session action request is missing name");
@@ -217,6 +251,18 @@ async function executeDirectBrowserSessionRequest(request, options) {
             command: (command, payload) => runDirectCommand(command, payload, request.id, options),
         });
     }
+    if (request.type === "run-webmcp-tool") {
+        if (!request.name) {
+            throw new Error("Browser-session WebMCP request is missing name");
+        }
+        const client = requireDirectWebMcpClient(options);
+        const tools = await client.listTools();
+        const tool = findWebMcpTool(tools, request.name, request.origin);
+        if (!tool) {
+            throw new Error(`WebMCP tool "${request.name}" is no longer available`);
+        }
+        return client.executeListedTool(tool, request.args);
+    }
     if (request.type === "command") {
         return runDirectCommand(request.command || "refreshData", request.payload, request.id, options);
     }
@@ -238,21 +284,39 @@ function normalizeSession(sessionId, label, hostSession, contextUrl) {
     };
 }
 async function executeBrowserSessionRequest(request, options) {
+    const hostOptions = hostRequestOptions(options);
+    if (options.webmcp === "host" && request.type === "list-webmcp-tools") {
+        return requestAgentNativeHostWebMcpTools(hostOptions);
+    }
+    if (options.webmcp === "host" && request.type === "run-webmcp-tool") {
+        if (!request.name) {
+            throw new Error("Browser-session WebMCP request is missing name");
+        }
+        return runAgentNativeHostWebMcpTool({ name: request.name, origin: request.origin }, request.args, hostOptions);
+    }
     if (hasDirectHost(options)) {
         return executeDirectBrowserSessionRequest(request, options);
     }
-    const hostOptions = hostRequestOptions(options);
     if (request.type === "get-context") {
         return requestAgentNativeHostContext(hostOptions);
     }
     if (request.type === "list-actions") {
         return requestAgentNativeHostActions(hostOptions);
     }
+    if (request.type === "list-webmcp-tools") {
+        return requestAgentNativeHostWebMcpTools(hostOptions);
+    }
     if (request.type === "run-action") {
         if (!request.name)
             throw new Error("Browser-session action request is missing name");
         return runAgentNativeHostAction(request.name, request.args, hostOptions);
     }
+    if (request.type === "run-webmcp-tool") {
+        if (!request.name) {
+            throw new Error("Browser-session WebMCP request is missing name");
+        }
+        return runAgentNativeHostWebMcpTool({ name: request.name, origin: request.origin }, request.args, hostOptions);
+    }
     if (request.type === "command") {
         return sendAgentNativeHostCommand(request.command || "refreshData", request.payload, hostOptions);
     }
@@ -263,18 +327,23 @@ export function createAgentNativeBrowserSessionBridge(options = {}) {
     let fallbackSessionId = null;
     let started = false;
     let onVisibility;
+    let lastWebMcpTools;
     async function refreshRegistration() {
         const direct = hasDirectHost(options);
         const hostOptions = hostRequestOptions(options);
-        const [context, actions] = direct
+        const [context, actions, webmcpTools] = direct
             ? await Promise.all([
                 resolveDirectContext(options),
                 resolveDirectActionManifest(options).catch(() => []),
+                resolveWebMcpTools(options),
             ])
             : await Promise.all([
                 requestAgentNativeHostContext(hostOptions),
                 requestAgentNativeHostActions(hostOptions).catch(() => []),
+                resolveWebMcpTools(options),
             ]);
+        if (webmcpTools !== undefined)
+            lastWebMcpTools = webmcpTools;
         const hostSession = context.session;
         if (!currentSessionId) {
             currentSessionId =
@@ -287,6 +356,9 @@ export function createAgentNativeBrowserSessionBridge(options = {}) {
             sessionId: currentSessionId,
             context,
             actions,
+            ...(lastWebMcpTools !== undefined
+                ? { webmcpTools: lastWebMcpTools }
+                : {}),
             ttlMs: options.ttlMs,
         });
         return body.session;

package/dist/client/host/index.d.ts

@@ -12,8 +12,9 @@ export { AgentNativeExtensionFrame, AgentNativeExtensionSlot, type AgentNativeEx
 export { AGENT_NATIVE_EXTENSION_MESSAGE_TYPES, buildAgentNativeExtensionHtml, createHttpAgentNativeExtensionStorage, createLocalStorageAgentNativeExtensionStorage, getAgentNativeExtensionManifest, isAgentNativeExtensionAllowedInSlot, normalizeAgentNativeExtensionSandbox, type AgentNativeExtensionDefinition, type AgentNativeExtensionManifest, type AgentNativeExtensionMessageType, type AgentNativeExtensionStorage, type AgentNativeExtensionStorageContext, type AgentNativeExtensionStorageOptions, type AgentNativeExtensionStorageRow, type AgentNativeExtensionStorageScope, type BuildAgentNativeExtensionHtmlOptions, type CreateHttpAgentNativeExtensionStorageOptions, } from "../extensions/portable-extension.js";
 export { buildSessionReplayIframeBootstrap, injectSessionReplayIframeBootstrap, } from "../../extensions/session-replay-iframe.js";
 export { SESSION_REPLAY_IFRAME_ATTRIBUTE, SESSION_REPLAY_IFRAME_PROBE, SESSION_REPLAY_IFRAME_START, SESSION_REPLAY_IFRAME_STOP, } from "../../session-replay-iframe-protocol.js";
-export { AGENT_NATIVE_HOST_BRIDGE_VERSION, AGENT_NATIVE_HOST_MESSAGE_TYPES, announceAgentNativeFrameReady, createAgentNativeHostBridge, defaultAgentNativeHostCommands, onAgentNativeHostInit, readAgentNativeScreenContext, requestAgentNativeHostActions, requestAgentNativeHostContext, runAgentNativeHostAction, sendAgentNativeHostCommand, type AgentNativeActionAvailability, type AgentNativeActionManifestEntry, type AgentNativeClientAction, type AgentNativeClientActionApprovalConfig, type AgentNativeClientActionGetter, type AgentNativeClientActionRuntime, type AgentNativeClientActions, type AgentNativeHostAuth, type AgentNativeHostAuthPayload, type AgentNativeHostBridge, type AgentNativeHostBridgeEvent, type AgentNativeHostBridgeOptions, type AgentNativeHostCapabilities, type AgentNativeHostCommandHandler, type AgentNativeHostCommandHandlers, type AgentNativeHostCommandRequest, type AgentNativeHostContext, type AgentNativeHostContextGetter, type AgentNativeHostInit, type AgentNativeHostMessageType, type AgentNativeHostRequestOptions, type AgentNativeHostResourceContext, type AgentNativeHostRouteContext, type AgentNativeHostSelectionContext, type AgentNativeHostSession, type AgentNativeJsonSchema, type AgentNativeScreenSnapshot, type AgentNativeScreenSnapshotOptions, type BuiltInAgentNativeHostCommand, } from "../host-bridge.js";
-export { AGENT_NATIVE_HOST_TOOL_NAMES, createAgentNativeHostTools, type AgentNativeHostToolDefinition, type AgentNativeHostToolName, type AgentNativeHostToolParameters, type AgentNativeHostToolSet, type CreateAgentNativeHostToolsOptions, type RunAgentNativeHostActionToolInput, type SendAgentNativeHostCommandToolInput, } from "../host-tools.js";
+export { AGENT_NATIVE_HOST_BRIDGE_VERSION, AGENT_NATIVE_HOST_MESSAGE_TYPES, announceAgentNativeFrameReady, createAgentNativeHostBridge, defaultAgentNativeHostCommands, onAgentNativeHostInit, readAgentNativeScreenContext, requestAgentNativeHostActions, requestAgentNativeHostContext, requestAgentNativeHostWebMcpTools, runAgentNativeHostAction, runAgentNativeHostWebMcpTool, sendAgentNativeHostCommand, type AgentNativeActionAvailability, type AgentNativeActionManifestEntry, type AgentNativeClientAction, type AgentNativeClientActionApprovalConfig, type AgentNativeClientActionGetter, type AgentNativeClientActionRuntime, type AgentNativeClientActions, type AgentNativeHostAuth, type AgentNativeHostAuthPayload, type AgentNativeHostBridge, type AgentNativeHostBridgeEvent, type AgentNativeHostBridgeOptions, type AgentNativeHostCapabilities, type AgentNativeHostCommandHandler, type AgentNativeHostCommandHandlers, type AgentNativeHostCommandRequest, type AgentNativeHostContext, type AgentNativeHostContextGetter, type AgentNativeHostInit, type AgentNativeHostMessageType, type AgentNativeHostRequestOptions, type AgentNativeHostResourceContext, type AgentNativeHostRouteContext, type AgentNativeHostSelectionContext, type AgentNativeHostSession, type AgentNativeJsonSchema, type AgentNativeScreenSnapshot, type AgentNativeScreenSnapshotOptions, type BuiltInAgentNativeHostCommand, } from "../host-bridge.js";
+export { AgentNativeWebMcpUnsupportedError, createAgentNativeWebMcpClient, createAgentNativeWebMcpRegistration, isAgentNativeWebMcpSupported, type AgentNativeWebMcpApprovalRequest, type AgentNativeWebMcpClient, type AgentNativeWebMcpClientOptions, type AgentNativeWebMcpRegistration, type AgentNativeWebMcpRegistrationOptions, type AgentNativeWebMcpTool, type AgentNativeWebMcpToolAnnotations, type AgentNativeWebMcpToolExecutionOptions, type AgentNativeWebMcpToolResult, } from "../webmcp.js";
+export { AGENT_NATIVE_HOST_TOOL_NAMES, createAgentNativeHostTools, type AgentNativeHostToolDefinition, type AgentNativeHostToolName, type AgentNativeHostToolParameters, type AgentNativeHostToolSet, type CreateAgentNativeHostToolsOptions, type RunAgentNativeHostActionToolInput, type RunAgentNativeHostWebMcpToolInput, type SendAgentNativeHostCommandToolInput, } from "../host-tools.js";
 export { createAgentNativeBrowserSessionBridge, startAgentNativeBrowserSessionBridge, type AgentNativeBrowserSessionBridge, type AgentNativeBrowserSessionBridgeOptions, } from "../browser-session-bridge.js";
 export type { AgentNativeBrowserSession, AgentNativeBrowserSessionAction, AgentNativeBrowserSessionRecord, AgentNativeBrowserSessionRequest, AgentNativeBrowserSessionRequestStatus, AgentNativeBrowserSessionRequestType, CreateAgentNativeBrowserSessionRequestInput, RegisterAgentNativeBrowserSessionInput, } from "../../browser-sessions/types.js";
 export type { AppToFrameMessage, FrameToAppMessage, FrameMessage, CodeCompleteMessage, ChatRunningMessage, } from "../frame-protocol.js";

package/dist/client/host/index.js

@@ -12,7 +12,8 @@ export { AgentNativeExtensionFrame, AgentNativeExtensionSlot, } from "../extensi
 export { AGENT_NATIVE_EXTENSION_MESSAGE_TYPES, buildAgentNativeExtensionHtml, createHttpAgentNativeExtensionStorage, createLocalStorageAgentNativeExtensionStorage, getAgentNativeExtensionManifest, isAgentNativeExtensionAllowedInSlot, normalizeAgentNativeExtensionSandbox, } from "../extensions/portable-extension.js";
 export { buildSessionReplayIframeBootstrap, injectSessionReplayIframeBootstrap, } from "../../extensions/session-replay-iframe.js";
 export { SESSION_REPLAY_IFRAME_ATTRIBUTE, SESSION_REPLAY_IFRAME_PROBE, SESSION_REPLAY_IFRAME_START, SESSION_REPLAY_IFRAME_STOP, } from "../../session-replay-iframe-protocol.js";
-export { AGENT_NATIVE_HOST_BRIDGE_VERSION, AGENT_NATIVE_HOST_MESSAGE_TYPES, announceAgentNativeFrameReady, createAgentNativeHostBridge, defaultAgentNativeHostCommands, onAgentNativeHostInit, readAgentNativeScreenContext, requestAgentNativeHostActions, requestAgentNativeHostContext, runAgentNativeHostAction, sendAgentNativeHostCommand, } from "../host-bridge.js";
+export { AGENT_NATIVE_HOST_BRIDGE_VERSION, AGENT_NATIVE_HOST_MESSAGE_TYPES, announceAgentNativeFrameReady, createAgentNativeHostBridge, defaultAgentNativeHostCommands, onAgentNativeHostInit, readAgentNativeScreenContext, requestAgentNativeHostActions, requestAgentNativeHostContext, requestAgentNativeHostWebMcpTools, runAgentNativeHostAction, runAgentNativeHostWebMcpTool, sendAgentNativeHostCommand, } from "../host-bridge.js";
+export { AgentNativeWebMcpUnsupportedError, createAgentNativeWebMcpClient, createAgentNativeWebMcpRegistration, isAgentNativeWebMcpSupported, } from "../webmcp.js";
 export { AGENT_NATIVE_HOST_TOOL_NAMES, createAgentNativeHostTools, } from "../host-tools.js";
 export { createAgentNativeBrowserSessionBridge, startAgentNativeBrowserSessionBridge, } from "../browser-session-bridge.js";
 export { IframeEmbed, parseEmbedBody } from "../IframeEmbed.js";