@mastra/playground-ui 68.0.0 → 69.0.0-alpha.1

package/dist/domains/mcps/components/mcp-app-tool-result.es.js

@@ -1,6 +1,8 @@
-import { t as Txt } from "../../../Txt-BM6TVV_c.js";
+import { useMcpAppHostContext } from "../context/mcp-app-host-context-value.es.js";
+import { useMcpAppToolCall } from "../hooks/use-mcp-app-tool-call.es.js";
 import { McpAppViewer } from "./mcp-app-viewer.es.js";
-import { useCallback } from "react";
+import { t as Txt } from "../../../Txt-5efBsb2p.js";
+import { useMemo } from "react";
 import { jsx } from "react/jsx-runtime";
 import { useMastraClient } from "@mastra/react";
 import { useQuery } from "@tanstack/react-query";
@@ -13,8 +15,29 @@ import { useQuery } from "@tanstack/react-query";
 * (ui/notifications/tool-input and ui/notifications/tool-result), enabling
 * the app to hydrate with data from the tool call.
 */
-function McpAppToolResult({ appInfo, toolArgs, toolResult, onSendMessage, readOnly }) {
+function McpAppToolResult({ appInfo, toolArgs, toolResult, toolCallId, onSendMessage, onUpdateModelContext, readOnly }) {
 	const client = useMastraClient();
+	const host = useMcpAppHostContext();
+	const { toolName, resourceUri } = appInfo;
+	const app = useMemo(() => toolCallId === void 0 ? void 0 : {
+		toolName,
+		toolCallId,
+		resourceUri
+	}, [
+		toolName,
+		toolCallId,
+		resourceUri
+	]);
+	const hostContext = useMemo(() => app && host?.hostContext?.(app) || void 0, [app, host]);
+	const onModelContext = useMemo(() => {
+		const handler = host?.onModelContext;
+		if (!app || !handler || readOnly) return void 0;
+		return (params) => handler(app, params);
+	}, [
+		app,
+		host,
+		readOnly
+	]);
 	const { data: html, isLoading } = useQuery({
 		queryKey: [
 			"mcp-app-html",
@@ -27,9 +50,7 @@ function McpAppToolResult({ appInfo, toolArgs, toolResult, onSendMessage, readOn
 		staleTime: 3e5,
 		refetchOnWindowFocus: false
 	});
-	const handleToolCall = useCallback(async (toolName, args) => {
-		return client.getMcpServerTool(appInfo.serverId, toolName).execute({ data: args });
-	}, [client, appInfo.serverId]);
+	const handleToolCall = useMcpAppToolCall(appInfo.serverId);
 	if (isLoading || !html) return /* @__PURE__ */ jsx(Txt, {
 		as: "p",
 		variant: "body",
@@ -44,6 +65,9 @@ function McpAppToolResult({ appInfo, toolArgs, toolResult, onSendMessage, readOn
 		toolResult,
 		onToolCall: readOnly ? void 0 : handleToolCall,
 		onSendMessage: readOnly ? void 0 : onSendMessage,
+		onUpdateModelContext: readOnly ? void 0 : onUpdateModelContext,
+		onModelContext,
+		hostContext,
 		className: "rounded-md border border-border"
 	});
 }

package/dist/domains/mcps/components/mcp-app-tool-result.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-app-tool-result.es.js","names":[],"sources":["../../../../src/domains/mcps/components/mcp-app-tool-result.tsx"],"sourcesContent":["import { useMastraClient } from '@mastra/react';\nimport type { McpAppToolInfo } from '@mastra/react/hooks/mcps';\nimport { useQuery } from '@tanstack/react-query';\nimport { useCallback } from 'react';\nimport { McpAppViewer } from './mcp-app-viewer';\nimport { Txt } from '@/ds/components/Txt';\n\ninterface McpAppToolResultProps {\n  appInfo: McpAppToolInfo;\n  toolArgs?: Record<string, unknown>;\n  toolResult?: unknown;\n  onSendMessage?: (content: string) => void;\n  readOnly?: boolean;\n}\n\n/**\n * Fetches MCP App HTML from the resource URI and renders it in a McpAppViewer.\n * Used inline in agent chat when a tool call has an associated MCP App UI.\n *\n * Passes tool arguments and result to the iframe via the MCP Apps protocol\n * (ui/notifications/tool-input and ui/notifications/tool-result), enabling\n * the app to hydrate with data from the tool call.\n */\nexport function McpAppToolResult({ appInfo, toolArgs, toolResult, onSendMessage, readOnly }: McpAppToolResultProps) {\n  const client = useMastraClient();\n\n  const { data: html, isLoading } = useQuery({\n    queryKey: ['mcp-app-html', appInfo.serverId, appInfo.resourceUri],\n    queryFn: async () => {\n      const response = await client.readMcpServerResource(appInfo.serverId, appInfo.resourceUri);\n      const content = response.contents?.[0];\n      return content?.text ?? '';\n    },\n    staleTime: 5 * 60_000,\n    refetchOnWindowFocus: false,\n  });\n\n  const handleToolCall = useCallback(\n    async (toolName: string, args: Record<string, unknown>) => {\n      const tool = client.getMcpServerTool(appInfo.serverId, toolName);\n      return tool.execute({ data: args });\n    },\n    [client, appInfo.serverId],\n  );\n\n  if (isLoading || !html) {\n    return (\n      <Txt as=\"p\" variant=\"body\" tone=\"muted\" className=\"rounded-md border border-border bg-background p-4\">\n        Loading MCP App UI…\n      </Txt>\n    );\n  }\n\n  return (\n    <McpAppViewer\n      html={html}\n      toolName={appInfo.toolName}\n      toolInput={toolArgs}\n      toolResult={toolResult}\n      onToolCall={readOnly ? undefined : handleToolCall}\n      onSendMessage={readOnly ? undefined : onSendMessage}\n      className=\"rounded-md border border-border\"\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;AAuBA,SAAgB,iBAAiB,EAAE,SAAS,UAAU,YAAY,eAAe,YAAmC;CAClH,MAAM,SAAS,gBAAgB;CAE/B,MAAM,EAAE,MAAM,MAAM,cAAc,SAAS;EACzC,UAAU;GAAC;GAAgB,QAAQ;GAAU,QAAQ;EAAW;EAChE,SAAS,YAAY;GAGnB,SADgB,MADO,OAAO,sBAAsB,QAAQ,UAAU,QAAQ,WAAW,EAAA,CAChE,WAAW,GAAA,EACpB,QAAQ;EAC1B;EACA,WAAW;EACX,sBAAsB;CACxB,CAAC;CAED,MAAM,iBAAiB,YACrB,OAAO,UAAkB,SAAkC;EAEzD,OADa,OAAO,iBAAiB,QAAQ,UAAU,QAChD,CAAA,CAAK,QAAQ,EAAE,MAAM,KAAK,CAAC;CACpC,GACA,CAAC,QAAQ,QAAQ,QAAQ,CAC3B;CAEA,IAAI,aAAa,CAAC,MAChB,OACE,oBAAC,KAAD;EAAK,IAAG;EAAI,SAAQ;EAAO,MAAK;EAAQ,WAAU;EAAoD,UAAA;CAEjG,CAAA;CAIT,OACE,oBAAC,cAAD;EACQ;EACN,UAAU,QAAQ;EAClB,WAAW;EACC;EACZ,YAAY,WAAW,KAAA,IAAY;EACnC,eAAe,WAAW,KAAA,IAAY;EACtC,WAAU;CACX,CAAA;AAEL"}
+{"version":3,"file":"mcp-app-tool-result.es.js","names":[],"sources":["../../../../src/domains/mcps/components/mcp-app-tool-result.tsx"],"sourcesContent":["import { useMastraClient } from '@mastra/react';\nimport type { McpAppToolInfo } from '@mastra/react/hooks/mcps';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMemo } from 'react';\nimport { useMcpAppHostContext } from '../context/mcp-app-host-context-value';\nimport type { McpAppModelContextParams, McpAppRef } from '../context/mcp-app-host-context-value';\nimport { useMcpAppToolCall } from '../hooks/use-mcp-app-tool-call';\nimport { McpAppViewer } from './mcp-app-viewer';\nimport { Txt } from '@/ds/components/Txt';\n\ninterface McpAppToolResultProps {\n  appInfo: McpAppToolInfo;\n  toolArgs?: Record<string, unknown>;\n  toolResult?: unknown;\n  /** The chat tool call that rendered this app. Required for an `McpAppHostProvider` to reach the app. */\n  toolCallId?: string;\n  onSendMessage?: (content: string) => void;\n  onUpdateModelContext?: (context: string | undefined) => void;\n  readOnly?: boolean;\n}\n\n/**\n * Fetches MCP App HTML from the resource URI and renders it in a McpAppViewer.\n * Used inline in agent chat when a tool call has an associated MCP App UI.\n *\n * Passes tool arguments and result to the iframe via the MCP Apps protocol\n * (ui/notifications/tool-input and ui/notifications/tool-result), enabling\n * the app to hydrate with data from the tool call.\n */\nexport function McpAppToolResult({\n  appInfo,\n  toolArgs,\n  toolResult,\n  toolCallId,\n  onSendMessage,\n  onUpdateModelContext,\n  readOnly,\n}: McpAppToolResultProps) {\n  const client = useMastraClient();\n  const host = useMcpAppHostContext();\n  const { toolName, resourceUri } = appInfo;\n  const app: McpAppRef | undefined = useMemo(\n    () => (toolCallId === undefined ? undefined : { toolName, toolCallId, resourceUri }),\n    [toolName, toolCallId, resourceUri],\n  );\n  const hostContext = useMemo(() => (app && host?.hostContext?.(app)) || undefined, [app, host]);\n  const onModelContext = useMemo(() => {\n    const handler = host?.onModelContext;\n    if (!app || !handler || readOnly) return undefined;\n    return (params: McpAppModelContextParams) => handler(app, params);\n  }, [app, host, readOnly]);\n\n  const { data: html, isLoading } = useQuery({\n    queryKey: ['mcp-app-html', appInfo.serverId, appInfo.resourceUri],\n    queryFn: async () => {\n      const response = await client.readMcpServerResource(appInfo.serverId, appInfo.resourceUri);\n      const content = response.contents?.[0];\n      return content?.text ?? '';\n    },\n    staleTime: 5 * 60_000,\n    refetchOnWindowFocus: false,\n  });\n\n  const handleToolCall = useMcpAppToolCall(appInfo.serverId);\n\n  if (isLoading || !html) {\n    return (\n      <Txt as=\"p\" variant=\"body\" tone=\"muted\" className=\"rounded-md border border-border bg-background p-4\">\n        Loading MCP App UI…\n      </Txt>\n    );\n  }\n\n  return (\n    <McpAppViewer\n      html={html}\n      toolName={appInfo.toolName}\n      toolInput={toolArgs}\n      toolResult={toolResult}\n      onToolCall={readOnly ? undefined : handleToolCall}\n      onSendMessage={readOnly ? undefined : onSendMessage}\n      onUpdateModelContext={readOnly ? undefined : onUpdateModelContext}\n      onModelContext={onModelContext}\n      hostContext={hostContext}\n      className=\"rounded-md border border-border\"\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AA6BA,SAAgB,iBAAiB,EAC/B,SACA,UACA,YACA,YACA,eACA,sBACA,YACwB;CACxB,MAAM,SAAS,gBAAgB;CAC/B,MAAM,OAAO,qBAAqB;CAClC,MAAM,EAAE,UAAU,gBAAgB;CAClC,MAAM,MAA6B,cAC1B,eAAe,KAAA,IAAY,KAAA,IAAY;EAAE;EAAU;EAAY;CAAY,GAClF;EAAC;EAAU;EAAY;CAAW,CACpC;CACA,MAAM,cAAc,cAAe,OAAO,MAAM,cAAc,GAAG,KAAM,KAAA,GAAW,CAAC,KAAK,IAAI,CAAC;CAC7F,MAAM,iBAAiB,cAAc;EACnC,MAAM,UAAU,MAAM;EACtB,IAAI,CAAC,OAAO,CAAC,WAAW,UAAU,OAAO,KAAA;EACzC,QAAQ,WAAqC,QAAQ,KAAK,MAAM;CAClE,GAAG;EAAC;EAAK;EAAM;CAAQ,CAAC;CAExB,MAAM,EAAE,MAAM,MAAM,cAAc,SAAS;EACzC,UAAU;GAAC;GAAgB,QAAQ;GAAU,QAAQ;EAAW;EAChE,SAAS,YAAY;GAGnB,SADgB,MADO,OAAO,sBAAsB,QAAQ,UAAU,QAAQ,WAAW,EAAA,CAChE,WAAW,GAAA,EACpB,QAAQ;EAC1B;EACA,WAAW;EACX,sBAAsB;CACxB,CAAC;CAED,MAAM,iBAAiB,kBAAkB,QAAQ,QAAQ;CAEzD,IAAI,aAAa,CAAC,MAChB,OACE,oBAAC,KAAD;EAAK,IAAG;EAAI,SAAQ;EAAO,MAAK;EAAQ,WAAU;EAAoD,UAAA;CAEjG,CAAA;CAIT,OACE,oBAAC,cAAD;EACQ;EACN,UAAU,QAAQ;EAClB,WAAW;EACC;EACZ,YAAY,WAAW,KAAA,IAAY;EACnC,eAAe,WAAW,KAAA,IAAY;EACtC,sBAAsB,WAAW,KAAA,IAAY;EAC7B;EACH;EACb,WAAU;CACX,CAAA;AAEL"}

package/dist/domains/mcps/components/mcp-app-viewer.cjs.js

@@ -1,4 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_types = require("../../../types-KjLUPShK.cjs");
+const require_ThemeProvider = require("../../../ThemeProvider-DViLuk6C.cjs");
 let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
 let _mcp_ui_client = require("@mcp-ui/client");
@@ -22,6 +24,21 @@ function getSandboxBlobUrl() {
 	}
 	return _blobUrl;
 }
+/** Renders an app's model context as text, labelled with the app it comes from. Empty context clears it. */
+function modelContextText(toolName, params) {
+	const text = Array.isArray(params?.content) ? params.content.filter((block) => block?.type === "text" && typeof block.text === "string").map((block) => block.text) : [];
+	if (params?.structuredContent !== void 0) text.push(JSON.stringify(params.structuredContent));
+	if (text.length === 0) return void 0;
+	return [`Context from the "${toolName}" MCP App shown in this conversation:`, ...text].join("\n");
+}
+function modelContextParams(params) {
+	const { content, structuredContent } = params ?? {};
+	const isRecord = structuredContent !== null && typeof structuredContent === "object" && !Array.isArray(structuredContent);
+	return {
+		...Array.isArray(content) && { content },
+		...isRecord && { structuredContent }
+	};
+}
 /**
 * McpAppViewer renders MCP App HTML using the standard @mcp-ui/client AppRenderer.
 *
@@ -29,20 +46,44 @@ function getSandboxBlobUrl() {
 * all MCP Apps protocol handling (bridge injection, handshake, tool input/result
 * delivery, JSON-RPC communication) to the standard implementation.
 */
-function McpAppViewer({ html, title: _title = "MCP App", toolName = "mcp-app", toolInput, toolResult, onToolCall, onSendMessage, sandboxUrl, className }) {
+function McpAppViewer({ html, title: _title = "MCP App", toolName = "mcp-app", toolInput, toolResult, onToolCall, onSendMessage, onUpdateModelContext, onModelContext, hostContext: extraHostContext, sandboxUrl, className }) {
 	const appRef = (0, react.useRef)(null);
 	const [height, setHeight] = (0, react.useState)(400);
 	const hostInfo = (0, react.useMemo)(() => ({
 		name: "Mastra Studio",
 		version: "1.0.0"
 	}), []);
+	const canCallTools = Boolean(onToolCall);
+	const canSendMessages = Boolean(onSendMessage);
+	const canUpdateModelContext = Boolean(onUpdateModelContext || onModelContext);
+	const hostCapabilities = (0, react.useMemo)(() => ({
+		openLinks: {},
+		...canCallTools && { serverTools: {} },
+		...canSendMessages && { message: {} },
+		...canUpdateModelContext && { updateModelContext: {
+			text: {},
+			structuredContent: {}
+		} }
+	}), [
+		canCallTools,
+		canSendMessages,
+		canUpdateModelContext
+	]);
+	const { resolvedTheme } = require_ThemeProvider.useTheme();
+	const hostContext = (0, react.useMemo)(() => ({
+		...extraHostContext,
+		theme: resolvedTheme
+	}), [extraHostContext, resolvedTheme]);
 	const normalizedToolResult = (0, react.useMemo)(() => {
 		if (toolResult === void 0) return void 0;
 		if (toolResult && typeof toolResult === "object" && Array.isArray(toolResult.content)) return toolResult;
-		return { content: [{
-			type: "text",
-			text: typeof toolResult === "string" ? toolResult : JSON.stringify(toolResult)
-		}] };
+		return {
+			content: [{
+				type: "text",
+				text: typeof toolResult === "string" ? toolResult : JSON.stringify(toolResult)
+			}],
+			...toolResult !== null && typeof toolResult === "object" && !Array.isArray(toolResult) && { structuredContent: toolResult }
+		};
 	}, [toolResult]);
 	const resolvedSandboxUrl = (0, react.useMemo)(() => sandboxUrl ?? getSandboxBlobUrl(), [sandboxUrl]);
 	const sandbox = (0, react.useMemo)(() => ({ url: resolvedSandboxUrl }), [resolvedSandboxUrl]);
@@ -53,7 +94,6 @@ function McpAppViewer({ html, title: _title = "MCP App", toolName = "mcp-app", t
 		}] };
 		const raw = await onToolCall(params.name, params.arguments ?? {});
 		const isCtResult = (obj) => !!obj && typeof obj === "object" && Array.isArray(obj.content) && obj.content.length > 0 && typeof obj.content[0]?.type === "string";
-		if (raw && typeof raw === "object" && "result" in raw && isCtResult(raw.result)) return raw.result;
 		if (isCtResult(raw)) return raw;
 		return {
 			content: [{
@@ -69,8 +109,21 @@ function McpAppViewer({ html, title: _title = "MCP App", toolName = "mcp-app", t
 		if (text) onSendMessage(text);
 		return {};
 	}, [onSendMessage]);
+	const handleFallbackRequest = (0, react.useCallback)(async (request) => {
+		if (request.method !== "ui/update-model-context" || !canUpdateModelContext) throw new require_types.McpError(require_types.ErrorCode.MethodNotFound, `No handler for method: ${request.method}`);
+		onUpdateModelContext?.(modelContextText(toolName, request.params));
+		onModelContext?.(modelContextParams(request.params));
+		return {};
+	}, [
+		canUpdateModelContext,
+		onUpdateModelContext,
+		onModelContext,
+		toolName
+	]);
 	const handleOpenLink = (0, react.useCallback)(async (params) => {
-		if (typeof params.url === "string") window.open(params.url, "_blank", "noopener,noreferrer");
+		const protocol = URL.canParse(params.url) ? new URL(params.url).protocol : void 0;
+		if (protocol !== "http:" && protocol !== "https:") throw new require_types.McpError(require_types.ErrorCode.InvalidParams, "Studio only opens http and https links from MCP Apps");
+		window.open(params.url, "_blank", "noopener,noreferrer");
 		return {};
 	}, []);
 	const handleSizeChanged = (0, react.useCallback)((params) => {
@@ -85,8 +138,7 @@ function McpAppViewer({ html, title: _title = "MCP App", toolName = "mcp-app", t
 			width: "100%",
 			height: `${height}px`,
 			overflow: "hidden",
-			borderRadius: "8px",
-			background: "white"
+			borderRadius: "8px"
 		},
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_mcp_ui_client.AppRenderer, {
 			ref: appRef,
@@ -96,8 +148,11 @@ function McpAppViewer({ html, title: _title = "MCP App", toolName = "mcp-app", t
 			toolInput,
 			toolResult: normalizedToolResult,
 			hostInfo,
+			hostCapabilities,
+			hostContext,
 			onCallTool: handleCallTool,
 			onMessage: handleMessage,
+			onFallbackRequest: handleFallbackRequest,
 			onOpenLink: handleOpenLink,
 			onSizeChanged: handleSizeChanged,
 			onError: handleError

package/dist/domains/mcps/components/mcp-app-viewer.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-app-viewer.cjs.js","names":["useRef","useState","useMemo","useCallback","AppRenderer"],"sources":["../../../../src/domains/mcps/components/mcp-app-viewer.tsx"],"sourcesContent":["import { AppRenderer } from '@mcp-ui/client';\nimport type { AppRendererHandle, SandboxConfig } from '@mcp-ui/client';\nimport type { CallToolRequest, CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { useCallback, useMemo, useRef, useState } from 'react';\n\nconst SANDBOX_PROXY_HTML = `<!DOCTYPE html>\n<html><head><meta charset=\"UTF-8\"><style>html,body{margin:0;padding:0;width:100%;height:100%}</style></head>\n<body><script>\nwindow.addEventListener('message',function(e){\n  var d=e.data;if(!d||typeof d!=='object')return;\n  if(d.method==='ui/notifications/sandbox-resource-ready'){\n    var h=(d.params||{}).html;if(h){document.open();document.write(h);document.close()}\n  }\n});\nwindow.parent.postMessage({jsonrpc:'2.0',method:'ui/notifications/sandbox-proxy-ready',params:{}},'*');\n<\\/script></body></html>`;\n\nlet _blobUrl: URL | null = null;\nfunction getSandboxBlobUrl(): URL {\n  if (!_blobUrl) {\n    const blob = new Blob([SANDBOX_PROXY_HTML], { type: 'text/html' });\n    _blobUrl = new URL(URL.createObjectURL(blob));\n  }\n  return _blobUrl;\n}\n\nexport interface McpAppViewerProps {\n  /** The HTML content to render in the sandboxed iframe */\n  html: string;\n  /** Title for the iframe (accessibility) */\n  title?: string;\n  /** Name of the MCP tool this UI is associated with */\n  toolName?: string;\n  /** Tool arguments that triggered this UI (delivered via tool-input notification) */\n  toolInput?: Record<string, unknown>;\n  /** Tool execution result (delivered via tool-result notification) */\n  toolResult?: unknown;\n  /** Callback when the app sends a tool call request via callServerTool */\n  onToolCall?: (toolName: string, args: Record<string, unknown>) => Promise<unknown>;\n  /** Callback when the app sends a message via sendMessage (drives new chat turns) */\n  onSendMessage?: (content: string) => void;\n  /** Sandbox configuration — URL to the sandbox proxy HTML. If omitted, a blob URL is generated automatically. */\n  sandboxUrl?: URL;\n  /** Optional className for the container */\n  className?: string;\n}\n\n/**\n * McpAppViewer renders MCP App HTML using the standard @mcp-ui/client AppRenderer.\n *\n * This component wraps AppRenderer to provide a Mastra-specific API while delegating\n * all MCP Apps protocol handling (bridge injection, handshake, tool input/result\n * delivery, JSON-RPC communication) to the standard implementation.\n */\nexport function McpAppViewer({\n  html,\n  title: _title = 'MCP App',\n  toolName = 'mcp-app',\n  toolInput,\n  toolResult,\n  onToolCall,\n  onSendMessage,\n  sandboxUrl,\n  className,\n}: McpAppViewerProps) {\n  const appRef = useRef<AppRendererHandle>(null);\n  const [height, setHeight] = useState(400);\n\n  // hostInfo MUST be memoized — it is a dependency of the bridge creation effect\n  // in AppRenderer. A new object reference triggers bridge recreation → sandbox\n  // timeout → toolInput never delivered.\n  const hostInfo = useMemo(() => ({ name: 'Mastra Studio', version: '1.0.0' }), []);\n\n  const normalizedToolResult: CallToolResult | undefined = useMemo(() => {\n    if (toolResult === undefined) return undefined;\n    if (toolResult && typeof toolResult === 'object' && Array.isArray((toolResult as CallToolResult).content)) {\n      return toolResult as CallToolResult;\n    }\n    return {\n      content: [\n        { type: 'text' as const, text: typeof toolResult === 'string' ? toolResult : JSON.stringify(toolResult) },\n      ],\n    };\n  }, [toolResult]);\n\n  const resolvedSandboxUrl = useMemo(() => sandboxUrl ?? getSandboxBlobUrl(), [sandboxUrl]);\n  const sandbox: SandboxConfig = useMemo(() => ({ url: resolvedSandboxUrl }), [resolvedSandboxUrl]);\n\n  const handleCallTool = useCallback(\n    async (params: CallToolRequest['params']): Promise<CallToolResult> => {\n      if (!onToolCall) {\n        return { content: [{ type: 'text', text: 'Tool calls not supported' }] };\n      }\n      const raw = await onToolCall(params.name, params.arguments ?? {});\n\n      // Detect if the result is already a CallToolResult (has content array with typed items)\n      // or wrapped in an API envelope { result: CallToolResult }\n      const isCtResult = (obj: unknown): boolean =>\n        !!obj &&\n        typeof obj === 'object' &&\n        Array.isArray((obj as Record<string, unknown>).content) &&\n        ((obj as Record<string, unknown>).content as unknown[]).length > 0 &&\n        typeof ((obj as Record<string, unknown>).content as Record<string, unknown>[])[0]?.type === 'string';\n\n      if (raw && typeof raw === 'object' && 'result' in raw && isCtResult((raw as Record<string, unknown>).result)) {\n        return (raw as { result: CallToolResult }).result;\n      }\n      if (isCtResult(raw)) {\n        return raw as CallToolResult;\n      }\n      return {\n        content: [{ type: 'text', text: typeof raw === 'string' ? raw : JSON.stringify(raw) }],\n        structuredContent: typeof raw === 'object' ? (raw as Record<string, unknown>) : { result: raw },\n      };\n    },\n    [onToolCall],\n  );\n\n  const handleMessage = useCallback(\n    async (params: { role: string; content: Array<{ type: string; text?: string }> }) => {\n      if (!onSendMessage) return {};\n      const text = params.content\n        ?.filter(block => block.type === 'text')\n        .map(block => block.text)\n        .join('\\n');\n      if (text) {\n        onSendMessage(text);\n      }\n      return {};\n    },\n    [onSendMessage],\n  );\n\n  const handleOpenLink = useCallback(async (params: { url: string }) => {\n    if (typeof params.url === 'string') {\n      window.open(params.url, '_blank', 'noopener,noreferrer');\n    }\n    return {};\n  }, []);\n\n  const handleSizeChanged = useCallback((params: { width?: number; height?: number }) => {\n    if (typeof params.height === 'number') {\n      setHeight(Math.max(100, Math.min(params.height, 2000)));\n    }\n  }, []);\n\n  const handleError = useCallback((error: Error) => {\n    console.error('[McpAppViewer]', error);\n  }, []);\n\n  return (\n    <div\n      className={className}\n      style={{\n        width: '100%',\n        height: `${height}px`,\n        overflow: 'hidden',\n        borderRadius: '8px',\n        background: 'white',\n      }}\n    >\n      <AppRenderer\n        ref={appRef}\n        toolName={toolName}\n        sandbox={sandbox}\n        html={html}\n        toolInput={toolInput}\n        toolResult={normalizedToolResult}\n        hostInfo={hostInfo}\n        onCallTool={handleCallTool}\n        onMessage={handleMessage}\n        onOpenLink={handleOpenLink}\n        onSizeChanged={handleSizeChanged}\n        onError={handleError}\n      />\n    </div>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"mcp-app-viewer.cjs.js","names":["useRef","useState","useMemo","useTheme","useCallback","McpError","ErrorCode","AppRenderer"],"sources":["../../../../src/domains/mcps/components/mcp-app-viewer.tsx"],"sourcesContent":["import { AppRenderer } from '@mcp-ui/client';\nimport type { AppRendererHandle, SandboxConfig } from '@mcp-ui/client';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport type { CallToolRequest, CallToolResult, JSONRPCRequest } from '@modelcontextprotocol/sdk/types.js';\nimport { useCallback, useMemo, useRef, useState } from 'react';\nimport type { ComponentProps } from 'react';\nimport type { McpAppModelContextParams } from '../context/mcp-app-host-context-value';\nimport { useTheme } from '@/ds/components/ThemeProvider';\n\ntype HostCapabilities = NonNullable<ComponentProps<typeof AppRenderer>['hostCapabilities']>;\n\nconst SANDBOX_PROXY_HTML = `<!DOCTYPE html>\n<html><head><meta charset=\"UTF-8\"><style>html,body{margin:0;padding:0;width:100%;height:100%}</style></head>\n<body><script>\nwindow.addEventListener('message',function(e){\n  var d=e.data;if(!d||typeof d!=='object')return;\n  if(d.method==='ui/notifications/sandbox-resource-ready'){\n    var h=(d.params||{}).html;if(h){document.open();document.write(h);document.close()}\n  }\n});\nwindow.parent.postMessage({jsonrpc:'2.0',method:'ui/notifications/sandbox-proxy-ready',params:{}},'*');\n<\\/script></body></html>`;\n\nlet _blobUrl: URL | null = null;\nfunction getSandboxBlobUrl(): URL {\n  if (!_blobUrl) {\n    const blob = new Blob([SANDBOX_PROXY_HTML], { type: 'text/html' });\n    _blobUrl = new URL(URL.createObjectURL(blob));\n  }\n  return _blobUrl;\n}\n\n/** Renders an app's model context as text, labelled with the app it comes from. Empty context clears it. */\nfunction modelContextText(toolName: string, params: JSONRPCRequest['params']): string | undefined {\n  const text = Array.isArray(params?.content)\n    ? params.content\n        .filter(\n          (block): block is { type: 'text'; text: string } => block?.type === 'text' && typeof block.text === 'string',\n        )\n        .map(block => block.text)\n    : [];\n  if (params?.structuredContent !== undefined) {\n    text.push(JSON.stringify(params.structuredContent));\n  }\n  if (text.length === 0) return undefined;\n  return [`Context from the \"${toolName}\" MCP App shown in this conversation:`, ...text].join('\\n');\n}\n\nfunction modelContextParams(params: JSONRPCRequest['params']): McpAppModelContextParams {\n  const { content, structuredContent } = params ?? {};\n  const isRecord =\n    structuredContent !== null && typeof structuredContent === 'object' && !Array.isArray(structuredContent);\n  return {\n    ...(Array.isArray(content) && { content }),\n    ...(isRecord && { structuredContent: structuredContent as Record<string, unknown> }),\n  };\n}\n\nexport interface McpAppViewerProps {\n  /** The HTML content to render in the sandboxed iframe */\n  html: string;\n  /** Title for the iframe (accessibility) */\n  title?: string;\n  /** Name of the MCP tool this UI is associated with */\n  toolName?: string;\n  /** Tool arguments that triggered this UI (delivered via tool-input notification) */\n  toolInput?: Record<string, unknown>;\n  /** Tool execution result (delivered via tool-result notification) */\n  toolResult?: unknown;\n  /** Callback when the app sends a tool call request via callServerTool. Resolves with the tool's output. */\n  onToolCall?: (toolName: string, args: Record<string, unknown>) => Promise<unknown>;\n  /** Callback when the app sends a message via sendMessage (drives new chat turns) */\n  onSendMessage?: (content: string) => void;\n  /**\n   * Callback when the app updates its model context via updateModelContext. Receives the context as\n   * text for the agent's next turn, or `undefined` when the app clears it.\n   */\n  onUpdateModelContext?: (context: string | undefined) => void;\n  /** Callback with the raw params of each updateModelContext, alongside `onUpdateModelContext`. */\n  onModelContext?: (params: McpAppModelContextParams) => void;\n  /** Extra host-context keys sent to the app; `theme` stays the viewer's own. Changes reach the running app. */\n  hostContext?: Record<string, unknown>;\n  /** Sandbox configuration — URL to the sandbox proxy HTML. If omitted, a blob URL is generated automatically. */\n  sandboxUrl?: URL;\n  /** Optional className for the container */\n  className?: string;\n}\n\n/**\n * McpAppViewer renders MCP App HTML using the standard @mcp-ui/client AppRenderer.\n *\n * This component wraps AppRenderer to provide a Mastra-specific API while delegating\n * all MCP Apps protocol handling (bridge injection, handshake, tool input/result\n * delivery, JSON-RPC communication) to the standard implementation.\n */\nexport function McpAppViewer({\n  html,\n  title: _title = 'MCP App',\n  toolName = 'mcp-app',\n  toolInput,\n  toolResult,\n  onToolCall,\n  onSendMessage,\n  onUpdateModelContext,\n  onModelContext,\n  hostContext: extraHostContext,\n  sandboxUrl,\n  className,\n}: McpAppViewerProps) {\n  const appRef = useRef<AppRendererHandle>(null);\n  const [height, setHeight] = useState(400);\n\n  // hostInfo MUST be memoized — it is a dependency of the bridge creation effect\n  // in AppRenderer. A new object reference triggers bridge recreation → sandbox\n  // timeout → toolInput never delivered.\n  const hostInfo = useMemo(() => ({ name: 'Mastra Studio', version: '1.0.0' }), []);\n  // Advertise only what this viewer handles; apps feature-detect these before calling.\n  // Memoized for the same reason as hostInfo.\n  const canCallTools = Boolean(onToolCall);\n  const canSendMessages = Boolean(onSendMessage);\n  const canUpdateModelContext = Boolean(onUpdateModelContext || onModelContext);\n  const hostCapabilities: HostCapabilities = useMemo(\n    () => ({\n      openLinks: {},\n      ...(canCallTools && { serverTools: {} }),\n      ...(canSendMessages && { message: {} }),\n      ...(canUpdateModelContext && { updateModelContext: { text: {}, structuredContent: {} } }),\n    }),\n    [canCallTools, canSendMessages, canUpdateModelContext],\n  );\n  const { resolvedTheme } = useTheme();\n  // Not a bridge dependency: AppRenderer sends only the keys that changed, to the running app.\n  const hostContext = useMemo(() => ({ ...extraHostContext, theme: resolvedTheme }), [extraHostContext, resolvedTheme]);\n\n  const normalizedToolResult: CallToolResult | undefined = useMemo(() => {\n    if (toolResult === undefined) return undefined;\n    if (toolResult && typeof toolResult === 'object' && Array.isArray((toolResult as CallToolResult).content)) {\n      return toolResult as CallToolResult;\n    }\n    const text = typeof toolResult === 'string' ? toolResult : JSON.stringify(toolResult);\n    // Apps render from structuredContent; the JSON text is the model-facing channel the spec asks to mirror it in.\n    const isRecord = toolResult !== null && typeof toolResult === 'object' && !Array.isArray(toolResult);\n    return {\n      content: [{ type: 'text' as const, text }],\n      ...(isRecord && { structuredContent: toolResult as Record<string, unknown> }),\n    };\n  }, [toolResult]);\n\n  const resolvedSandboxUrl = useMemo(() => sandboxUrl ?? getSandboxBlobUrl(), [sandboxUrl]);\n  const sandbox: SandboxConfig = useMemo(() => ({ url: resolvedSandboxUrl }), [resolvedSandboxUrl]);\n\n  const handleCallTool = useCallback(\n    async (params: CallToolRequest['params']): Promise<CallToolResult> => {\n      if (!onToolCall) {\n        return { content: [{ type: 'text', text: 'Tool calls not supported' }] };\n      }\n      const raw = await onToolCall(params.name, params.arguments ?? {});\n\n      // Detect if the result is already a CallToolResult (has content array with typed items)\n      const isCtResult = (obj: unknown): boolean =>\n        !!obj &&\n        typeof obj === 'object' &&\n        Array.isArray((obj as Record<string, unknown>).content) &&\n        ((obj as Record<string, unknown>).content as unknown[]).length > 0 &&\n        typeof ((obj as Record<string, unknown>).content as Record<string, unknown>[])[0]?.type === 'string';\n\n      if (isCtResult(raw)) {\n        return raw as CallToolResult;\n      }\n      return {\n        content: [{ type: 'text', text: typeof raw === 'string' ? raw : JSON.stringify(raw) }],\n        structuredContent: typeof raw === 'object' ? (raw as Record<string, unknown>) : { result: raw },\n      };\n    },\n    [onToolCall],\n  );\n\n  const handleMessage = useCallback(\n    async (params: { role: string; content: Array<{ type: string; text?: string }> }) => {\n      if (!onSendMessage) return {};\n      const text = params.content\n        ?.filter(block => block.type === 'text')\n        .map(block => block.text)\n        .join('\\n');\n      if (text) {\n        onSendMessage(text);\n      }\n      return {};\n    },\n    [onSendMessage],\n  );\n\n  // AppRenderer has no prop for ui/update-model-context, so it arrives as an unhandled request.\n  const handleFallbackRequest = useCallback(\n    async (request: JSONRPCRequest) => {\n      if (request.method !== 'ui/update-model-context' || !canUpdateModelContext) {\n        throw new McpError(ErrorCode.MethodNotFound, `No handler for method: ${request.method}`);\n      }\n      onUpdateModelContext?.(modelContextText(toolName, request.params));\n      onModelContext?.(modelContextParams(request.params));\n      return {};\n    },\n    [canUpdateModelContext, onUpdateModelContext, onModelContext, toolName],\n  );\n\n  const handleOpenLink = useCallback(async (params: { url: string }) => {\n    const protocol = URL.canParse(params.url) ? new URL(params.url).protocol : undefined;\n    // Anything else (javascript:, data:, file:, ...) would run code or read local files, not open a page.\n    if (protocol !== 'http:' && protocol !== 'https:') {\n      throw new McpError(ErrorCode.InvalidParams, 'Studio only opens http and https links from MCP Apps');\n    }\n    window.open(params.url, '_blank', 'noopener,noreferrer');\n    return {};\n  }, []);\n\n  const handleSizeChanged = useCallback((params: { width?: number; height?: number }) => {\n    if (typeof params.height === 'number') {\n      setHeight(Math.max(100, Math.min(params.height, 2000)));\n    }\n  }, []);\n\n  const handleError = useCallback((error: Error) => {\n    console.error('[McpAppViewer]', error);\n  }, []);\n\n  return (\n    <div\n      className={className}\n      style={{\n        width: '100%',\n        height: `${height}px`,\n        overflow: 'hidden',\n        borderRadius: '8px',\n      }}\n    >\n      <AppRenderer\n        ref={appRef}\n        toolName={toolName}\n        sandbox={sandbox}\n        html={html}\n        toolInput={toolInput}\n        toolResult={normalizedToolResult}\n        hostInfo={hostInfo}\n        hostCapabilities={hostCapabilities}\n        hostContext={hostContext}\n        onCallTool={handleCallTool}\n        onMessage={handleMessage}\n        onFallbackRequest={handleFallbackRequest}\n        onOpenLink={handleOpenLink}\n        onSizeChanged={handleSizeChanged}\n        onError={handleError}\n      />\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/domains/mcps/components/mcp-app-viewer.es.js

@@ -1,3 +1,5 @@
+import { n as McpError, t as ErrorCode } from "../../../types-BwdKiX24.js";
+import { n as useTheme } from "../../../ThemeProvider-CQdX5j9p.js";
 import { useCallback, useMemo, useRef, useState } from "react";
 import { jsx } from "react/jsx-runtime";
 import { AppRenderer } from "@mcp-ui/client";
@@ -21,6 +23,21 @@ function getSandboxBlobUrl() {
 	}
 	return _blobUrl;
 }
+/** Renders an app's model context as text, labelled with the app it comes from. Empty context clears it. */
+function modelContextText(toolName, params) {
+	const text = Array.isArray(params?.content) ? params.content.filter((block) => block?.type === "text" && typeof block.text === "string").map((block) => block.text) : [];
+	if (params?.structuredContent !== void 0) text.push(JSON.stringify(params.structuredContent));
+	if (text.length === 0) return void 0;
+	return [`Context from the "${toolName}" MCP App shown in this conversation:`, ...text].join("\n");
+}
+function modelContextParams(params) {
+	const { content, structuredContent } = params ?? {};
+	const isRecord = structuredContent !== null && typeof structuredContent === "object" && !Array.isArray(structuredContent);
+	return {
+		...Array.isArray(content) && { content },
+		...isRecord && { structuredContent }
+	};
+}
 /**
 * McpAppViewer renders MCP App HTML using the standard @mcp-ui/client AppRenderer.
 *
@@ -28,20 +45,44 @@ function getSandboxBlobUrl() {
 * all MCP Apps protocol handling (bridge injection, handshake, tool input/result
 * delivery, JSON-RPC communication) to the standard implementation.
 */
-function McpAppViewer({ html, title: _title = "MCP App", toolName = "mcp-app", toolInput, toolResult, onToolCall, onSendMessage, sandboxUrl, className }) {
+function McpAppViewer({ html, title: _title = "MCP App", toolName = "mcp-app", toolInput, toolResult, onToolCall, onSendMessage, onUpdateModelContext, onModelContext, hostContext: extraHostContext, sandboxUrl, className }) {
 	const appRef = useRef(null);
 	const [height, setHeight] = useState(400);
 	const hostInfo = useMemo(() => ({
 		name: "Mastra Studio",
 		version: "1.0.0"
 	}), []);
+	const canCallTools = Boolean(onToolCall);
+	const canSendMessages = Boolean(onSendMessage);
+	const canUpdateModelContext = Boolean(onUpdateModelContext || onModelContext);
+	const hostCapabilities = useMemo(() => ({
+		openLinks: {},
+		...canCallTools && { serverTools: {} },
+		...canSendMessages && { message: {} },
+		...canUpdateModelContext && { updateModelContext: {
+			text: {},
+			structuredContent: {}
+		} }
+	}), [
+		canCallTools,
+		canSendMessages,
+		canUpdateModelContext
+	]);
+	const { resolvedTheme } = useTheme();
+	const hostContext = useMemo(() => ({
+		...extraHostContext,
+		theme: resolvedTheme
+	}), [extraHostContext, resolvedTheme]);
 	const normalizedToolResult = useMemo(() => {
 		if (toolResult === void 0) return void 0;
 		if (toolResult && typeof toolResult === "object" && Array.isArray(toolResult.content)) return toolResult;
-		return { content: [{
-			type: "text",
-			text: typeof toolResult === "string" ? toolResult : JSON.stringify(toolResult)
-		}] };
+		return {
+			content: [{
+				type: "text",
+				text: typeof toolResult === "string" ? toolResult : JSON.stringify(toolResult)
+			}],
+			...toolResult !== null && typeof toolResult === "object" && !Array.isArray(toolResult) && { structuredContent: toolResult }
+		};
 	}, [toolResult]);
 	const resolvedSandboxUrl = useMemo(() => sandboxUrl ?? getSandboxBlobUrl(), [sandboxUrl]);
 	const sandbox = useMemo(() => ({ url: resolvedSandboxUrl }), [resolvedSandboxUrl]);
@@ -52,7 +93,6 @@ function McpAppViewer({ html, title: _title = "MCP App", toolName = "mcp-app", t
 		}] };
 		const raw = await onToolCall(params.name, params.arguments ?? {});
 		const isCtResult = (obj) => !!obj && typeof obj === "object" && Array.isArray(obj.content) && obj.content.length > 0 && typeof obj.content[0]?.type === "string";
-		if (raw && typeof raw === "object" && "result" in raw && isCtResult(raw.result)) return raw.result;
 		if (isCtResult(raw)) return raw;
 		return {
 			content: [{
@@ -68,8 +108,21 @@ function McpAppViewer({ html, title: _title = "MCP App", toolName = "mcp-app", t
 		if (text) onSendMessage(text);
 		return {};
 	}, [onSendMessage]);
+	const handleFallbackRequest = useCallback(async (request) => {
+		if (request.method !== "ui/update-model-context" || !canUpdateModelContext) throw new McpError(ErrorCode.MethodNotFound, `No handler for method: ${request.method}`);
+		onUpdateModelContext?.(modelContextText(toolName, request.params));
+		onModelContext?.(modelContextParams(request.params));
+		return {};
+	}, [
+		canUpdateModelContext,
+		onUpdateModelContext,
+		onModelContext,
+		toolName
+	]);
 	const handleOpenLink = useCallback(async (params) => {
-		if (typeof params.url === "string") window.open(params.url, "_blank", "noopener,noreferrer");
+		const protocol = URL.canParse(params.url) ? new URL(params.url).protocol : void 0;
+		if (protocol !== "http:" && protocol !== "https:") throw new McpError(ErrorCode.InvalidParams, "Studio only opens http and https links from MCP Apps");
+		window.open(params.url, "_blank", "noopener,noreferrer");
 		return {};
 	}, []);
 	const handleSizeChanged = useCallback((params) => {
@@ -84,8 +137,7 @@ function McpAppViewer({ html, title: _title = "MCP App", toolName = "mcp-app", t
 			width: "100%",
 			height: `${height}px`,
 			overflow: "hidden",
-			borderRadius: "8px",
-			background: "white"
+			borderRadius: "8px"
 		},
 		children: /* @__PURE__ */ jsx(AppRenderer, {
 			ref: appRef,
@@ -95,8 +147,11 @@ function McpAppViewer({ html, title: _title = "MCP App", toolName = "mcp-app", t
 			toolInput,
 			toolResult: normalizedToolResult,
 			hostInfo,
+			hostCapabilities,
+			hostContext,
 			onCallTool: handleCallTool,
 			onMessage: handleMessage,
+			onFallbackRequest: handleFallbackRequest,
 			onOpenLink: handleOpenLink,
 			onSizeChanged: handleSizeChanged,
 			onError: handleError

package/dist/domains/mcps/components/mcp-app-viewer.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-app-viewer.es.js","names":[],"sources":["../../../../src/domains/mcps/components/mcp-app-viewer.tsx"],"sourcesContent":["import { AppRenderer } from '@mcp-ui/client';\nimport type { AppRendererHandle, SandboxConfig } from '@mcp-ui/client';\nimport type { CallToolRequest, CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { useCallback, useMemo, useRef, useState } from 'react';\n\nconst SANDBOX_PROXY_HTML = `<!DOCTYPE html>\n<html><head><meta charset=\"UTF-8\"><style>html,body{margin:0;padding:0;width:100%;height:100%}</style></head>\n<body><script>\nwindow.addEventListener('message',function(e){\n  var d=e.data;if(!d||typeof d!=='object')return;\n  if(d.method==='ui/notifications/sandbox-resource-ready'){\n    var h=(d.params||{}).html;if(h){document.open();document.write(h);document.close()}\n  }\n});\nwindow.parent.postMessage({jsonrpc:'2.0',method:'ui/notifications/sandbox-proxy-ready',params:{}},'*');\n<\\/script></body></html>`;\n\nlet _blobUrl: URL | null = null;\nfunction getSandboxBlobUrl(): URL {\n  if (!_blobUrl) {\n    const blob = new Blob([SANDBOX_PROXY_HTML], { type: 'text/html' });\n    _blobUrl = new URL(URL.createObjectURL(blob));\n  }\n  return _blobUrl;\n}\n\nexport interface McpAppViewerProps {\n  /** The HTML content to render in the sandboxed iframe */\n  html: string;\n  /** Title for the iframe (accessibility) */\n  title?: string;\n  /** Name of the MCP tool this UI is associated with */\n  toolName?: string;\n  /** Tool arguments that triggered this UI (delivered via tool-input notification) */\n  toolInput?: Record<string, unknown>;\n  /** Tool execution result (delivered via tool-result notification) */\n  toolResult?: unknown;\n  /** Callback when the app sends a tool call request via callServerTool */\n  onToolCall?: (toolName: string, args: Record<string, unknown>) => Promise<unknown>;\n  /** Callback when the app sends a message via sendMessage (drives new chat turns) */\n  onSendMessage?: (content: string) => void;\n  /** Sandbox configuration — URL to the sandbox proxy HTML. If omitted, a blob URL is generated automatically. */\n  sandboxUrl?: URL;\n  /** Optional className for the container */\n  className?: string;\n}\n\n/**\n * McpAppViewer renders MCP App HTML using the standard @mcp-ui/client AppRenderer.\n *\n * This component wraps AppRenderer to provide a Mastra-specific API while delegating\n * all MCP Apps protocol handling (bridge injection, handshake, tool input/result\n * delivery, JSON-RPC communication) to the standard implementation.\n */\nexport function McpAppViewer({\n  html,\n  title: _title = 'MCP App',\n  toolName = 'mcp-app',\n  toolInput,\n  toolResult,\n  onToolCall,\n  onSendMessage,\n  sandboxUrl,\n  className,\n}: McpAppViewerProps) {\n  const appRef = useRef<AppRendererHandle>(null);\n  const [height, setHeight] = useState(400);\n\n  // hostInfo MUST be memoized — it is a dependency of the bridge creation effect\n  // in AppRenderer. A new object reference triggers bridge recreation → sandbox\n  // timeout → toolInput never delivered.\n  const hostInfo = useMemo(() => ({ name: 'Mastra Studio', version: '1.0.0' }), []);\n\n  const normalizedToolResult: CallToolResult | undefined = useMemo(() => {\n    if (toolResult === undefined) return undefined;\n    if (toolResult && typeof toolResult === 'object' && Array.isArray((toolResult as CallToolResult).content)) {\n      return toolResult as CallToolResult;\n    }\n    return {\n      content: [\n        { type: 'text' as const, text: typeof toolResult === 'string' ? toolResult : JSON.stringify(toolResult) },\n      ],\n    };\n  }, [toolResult]);\n\n  const resolvedSandboxUrl = useMemo(() => sandboxUrl ?? getSandboxBlobUrl(), [sandboxUrl]);\n  const sandbox: SandboxConfig = useMemo(() => ({ url: resolvedSandboxUrl }), [resolvedSandboxUrl]);\n\n  const handleCallTool = useCallback(\n    async (params: CallToolRequest['params']): Promise<CallToolResult> => {\n      if (!onToolCall) {\n        return { content: [{ type: 'text', text: 'Tool calls not supported' }] };\n      }\n      const raw = await onToolCall(params.name, params.arguments ?? {});\n\n      // Detect if the result is already a CallToolResult (has content array with typed items)\n      // or wrapped in an API envelope { result: CallToolResult }\n      const isCtResult = (obj: unknown): boolean =>\n        !!obj &&\n        typeof obj === 'object' &&\n        Array.isArray((obj as Record<string, unknown>).content) &&\n        ((obj as Record<string, unknown>).content as unknown[]).length > 0 &&\n        typeof ((obj as Record<string, unknown>).content as Record<string, unknown>[])[0]?.type === 'string';\n\n      if (raw && typeof raw === 'object' && 'result' in raw && isCtResult((raw as Record<string, unknown>).result)) {\n        return (raw as { result: CallToolResult }).result;\n      }\n      if (isCtResult(raw)) {\n        return raw as CallToolResult;\n      }\n      return {\n        content: [{ type: 'text', text: typeof raw === 'string' ? raw : JSON.stringify(raw) }],\n        structuredContent: typeof raw === 'object' ? (raw as Record<string, unknown>) : { result: raw },\n      };\n    },\n    [onToolCall],\n  );\n\n  const handleMessage = useCallback(\n    async (params: { role: string; content: Array<{ type: string; text?: string }> }) => {\n      if (!onSendMessage) return {};\n      const text = params.content\n        ?.filter(block => block.type === 'text')\n        .map(block => block.text)\n        .join('\\n');\n      if (text) {\n        onSendMessage(text);\n      }\n      return {};\n    },\n    [onSendMessage],\n  );\n\n  const handleOpenLink = useCallback(async (params: { url: string }) => {\n    if (typeof params.url === 'string') {\n      window.open(params.url, '_blank', 'noopener,noreferrer');\n    }\n    return {};\n  }, []);\n\n  const handleSizeChanged = useCallback((params: { width?: number; height?: number }) => {\n    if (typeof params.height === 'number') {\n      setHeight(Math.max(100, Math.min(params.height, 2000)));\n    }\n  }, []);\n\n  const handleError = useCallback((error: Error) => {\n    console.error('[McpAppViewer]', error);\n  }, []);\n\n  return (\n    <div\n      className={className}\n      style={{\n        width: '100%',\n        height: `${height}px`,\n        overflow: 'hidden',\n        borderRadius: '8px',\n        background: 'white',\n      }}\n    >\n      <AppRenderer\n        ref={appRef}\n        toolName={toolName}\n        sandbox={sandbox}\n        html={html}\n        toolInput={toolInput}\n        toolResult={normalizedToolResult}\n        hostInfo={hostInfo}\n        onCallTool={handleCallTool}\n        onMessage={handleMessage}\n        onOpenLink={handleOpenLink}\n        onSizeChanged={handleSizeChanged}\n        onError={handleError}\n      />\n    </div>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"mcp-app-viewer.es.js","names":[],"sources":["../../../../src/domains/mcps/components/mcp-app-viewer.tsx"],"sourcesContent":["import { AppRenderer } from '@mcp-ui/client';\nimport type { AppRendererHandle, SandboxConfig } from '@mcp-ui/client';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport type { CallToolRequest, CallToolResult, JSONRPCRequest } from '@modelcontextprotocol/sdk/types.js';\nimport { useCallback, useMemo, useRef, useState } from 'react';\nimport type { ComponentProps } from 'react';\nimport type { McpAppModelContextParams } from '../context/mcp-app-host-context-value';\nimport { useTheme } from '@/ds/components/ThemeProvider';\n\ntype HostCapabilities = NonNullable<ComponentProps<typeof AppRenderer>['hostCapabilities']>;\n\nconst SANDBOX_PROXY_HTML = `<!DOCTYPE html>\n<html><head><meta charset=\"UTF-8\"><style>html,body{margin:0;padding:0;width:100%;height:100%}</style></head>\n<body><script>\nwindow.addEventListener('message',function(e){\n  var d=e.data;if(!d||typeof d!=='object')return;\n  if(d.method==='ui/notifications/sandbox-resource-ready'){\n    var h=(d.params||{}).html;if(h){document.open();document.write(h);document.close()}\n  }\n});\nwindow.parent.postMessage({jsonrpc:'2.0',method:'ui/notifications/sandbox-proxy-ready',params:{}},'*');\n<\\/script></body></html>`;\n\nlet _blobUrl: URL | null = null;\nfunction getSandboxBlobUrl(): URL {\n  if (!_blobUrl) {\n    const blob = new Blob([SANDBOX_PROXY_HTML], { type: 'text/html' });\n    _blobUrl = new URL(URL.createObjectURL(blob));\n  }\n  return _blobUrl;\n}\n\n/** Renders an app's model context as text, labelled with the app it comes from. Empty context clears it. */\nfunction modelContextText(toolName: string, params: JSONRPCRequest['params']): string | undefined {\n  const text = Array.isArray(params?.content)\n    ? params.content\n        .filter(\n          (block): block is { type: 'text'; text: string } => block?.type === 'text' && typeof block.text === 'string',\n        )\n        .map(block => block.text)\n    : [];\n  if (params?.structuredContent !== undefined) {\n    text.push(JSON.stringify(params.structuredContent));\n  }\n  if (text.length === 0) return undefined;\n  return [`Context from the \"${toolName}\" MCP App shown in this conversation:`, ...text].join('\\n');\n}\n\nfunction modelContextParams(params: JSONRPCRequest['params']): McpAppModelContextParams {\n  const { content, structuredContent } = params ?? {};\n  const isRecord =\n    structuredContent !== null && typeof structuredContent === 'object' && !Array.isArray(structuredContent);\n  return {\n    ...(Array.isArray(content) && { content }),\n    ...(isRecord && { structuredContent: structuredContent as Record<string, unknown> }),\n  };\n}\n\nexport interface McpAppViewerProps {\n  /** The HTML content to render in the sandboxed iframe */\n  html: string;\n  /** Title for the iframe (accessibility) */\n  title?: string;\n  /** Name of the MCP tool this UI is associated with */\n  toolName?: string;\n  /** Tool arguments that triggered this UI (delivered via tool-input notification) */\n  toolInput?: Record<string, unknown>;\n  /** Tool execution result (delivered via tool-result notification) */\n  toolResult?: unknown;\n  /** Callback when the app sends a tool call request via callServerTool. Resolves with the tool's output. */\n  onToolCall?: (toolName: string, args: Record<string, unknown>) => Promise<unknown>;\n  /** Callback when the app sends a message via sendMessage (drives new chat turns) */\n  onSendMessage?: (content: string) => void;\n  /**\n   * Callback when the app updates its model context via updateModelContext. Receives the context as\n   * text for the agent's next turn, or `undefined` when the app clears it.\n   */\n  onUpdateModelContext?: (context: string | undefined) => void;\n  /** Callback with the raw params of each updateModelContext, alongside `onUpdateModelContext`. */\n  onModelContext?: (params: McpAppModelContextParams) => void;\n  /** Extra host-context keys sent to the app; `theme` stays the viewer's own. Changes reach the running app. */\n  hostContext?: Record<string, unknown>;\n  /** Sandbox configuration — URL to the sandbox proxy HTML. If omitted, a blob URL is generated automatically. */\n  sandboxUrl?: URL;\n  /** Optional className for the container */\n  className?: string;\n}\n\n/**\n * McpAppViewer renders MCP App HTML using the standard @mcp-ui/client AppRenderer.\n *\n * This component wraps AppRenderer to provide a Mastra-specific API while delegating\n * all MCP Apps protocol handling (bridge injection, handshake, tool input/result\n * delivery, JSON-RPC communication) to the standard implementation.\n */\nexport function McpAppViewer({\n  html,\n  title: _title = 'MCP App',\n  toolName = 'mcp-app',\n  toolInput,\n  toolResult,\n  onToolCall,\n  onSendMessage,\n  onUpdateModelContext,\n  onModelContext,\n  hostContext: extraHostContext,\n  sandboxUrl,\n  className,\n}: McpAppViewerProps) {\n  const appRef = useRef<AppRendererHandle>(null);\n  const [height, setHeight] = useState(400);\n\n  // hostInfo MUST be memoized — it is a dependency of the bridge creation effect\n  // in AppRenderer. A new object reference triggers bridge recreation → sandbox\n  // timeout → toolInput never delivered.\n  const hostInfo = useMemo(() => ({ name: 'Mastra Studio', version: '1.0.0' }), []);\n  // Advertise only what this viewer handles; apps feature-detect these before calling.\n  // Memoized for the same reason as hostInfo.\n  const canCallTools = Boolean(onToolCall);\n  const canSendMessages = Boolean(onSendMessage);\n  const canUpdateModelContext = Boolean(onUpdateModelContext || onModelContext);\n  const hostCapabilities: HostCapabilities = useMemo(\n    () => ({\n      openLinks: {},\n      ...(canCallTools && { serverTools: {} }),\n      ...(canSendMessages && { message: {} }),\n      ...(canUpdateModelContext && { updateModelContext: { text: {}, structuredContent: {} } }),\n    }),\n    [canCallTools, canSendMessages, canUpdateModelContext],\n  );\n  const { resolvedTheme } = useTheme();\n  // Not a bridge dependency: AppRenderer sends only the keys that changed, to the running app.\n  const hostContext = useMemo(() => ({ ...extraHostContext, theme: resolvedTheme }), [extraHostContext, resolvedTheme]);\n\n  const normalizedToolResult: CallToolResult | undefined = useMemo(() => {\n    if (toolResult === undefined) return undefined;\n    if (toolResult && typeof toolResult === 'object' && Array.isArray((toolResult as CallToolResult).content)) {\n      return toolResult as CallToolResult;\n    }\n    const text = typeof toolResult === 'string' ? toolResult : JSON.stringify(toolResult);\n    // Apps render from structuredContent; the JSON text is the model-facing channel the spec asks to mirror it in.\n    const isRecord = toolResult !== null && typeof toolResult === 'object' && !Array.isArray(toolResult);\n    return {\n      content: [{ type: 'text' as const, text }],\n      ...(isRecord && { structuredContent: toolResult as Record<string, unknown> }),\n    };\n  }, [toolResult]);\n\n  const resolvedSandboxUrl = useMemo(() => sandboxUrl ?? getSandboxBlobUrl(), [sandboxUrl]);\n  const sandbox: SandboxConfig = useMemo(() => ({ url: resolvedSandboxUrl }), [resolvedSandboxUrl]);\n\n  const handleCallTool = useCallback(\n    async (params: CallToolRequest['params']): Promise<CallToolResult> => {\n      if (!onToolCall) {\n        return { content: [{ type: 'text', text: 'Tool calls not supported' }] };\n      }\n      const raw = await onToolCall(params.name, params.arguments ?? {});\n\n      // Detect if the result is already a CallToolResult (has content array with typed items)\n      const isCtResult = (obj: unknown): boolean =>\n        !!obj &&\n        typeof obj === 'object' &&\n        Array.isArray((obj as Record<string, unknown>).content) &&\n        ((obj as Record<string, unknown>).content as unknown[]).length > 0 &&\n        typeof ((obj as Record<string, unknown>).content as Record<string, unknown>[])[0]?.type === 'string';\n\n      if (isCtResult(raw)) {\n        return raw as CallToolResult;\n      }\n      return {\n        content: [{ type: 'text', text: typeof raw === 'string' ? raw : JSON.stringify(raw) }],\n        structuredContent: typeof raw === 'object' ? (raw as Record<string, unknown>) : { result: raw },\n      };\n    },\n    [onToolCall],\n  );\n\n  const handleMessage = useCallback(\n    async (params: { role: string; content: Array<{ type: string; text?: string }> }) => {\n      if (!onSendMessage) return {};\n      const text = params.content\n        ?.filter(block => block.type === 'text')\n        .map(block => block.text)\n        .join('\\n');\n      if (text) {\n        onSendMessage(text);\n      }\n      return {};\n    },\n    [onSendMessage],\n  );\n\n  // AppRenderer has no prop for ui/update-model-context, so it arrives as an unhandled request.\n  const handleFallbackRequest = useCallback(\n    async (request: JSONRPCRequest) => {\n      if (request.method !== 'ui/update-model-context' || !canUpdateModelContext) {\n        throw new McpError(ErrorCode.MethodNotFound, `No handler for method: ${request.method}`);\n      }\n      onUpdateModelContext?.(modelContextText(toolName, request.params));\n      onModelContext?.(modelContextParams(request.params));\n      return {};\n    },\n    [canUpdateModelContext, onUpdateModelContext, onModelContext, toolName],\n  );\n\n  const handleOpenLink = useCallback(async (params: { url: string }) => {\n    const protocol = URL.canParse(params.url) ? new URL(params.url).protocol : undefined;\n    // Anything else (javascript:, data:, file:, ...) would run code or read local files, not open a page.\n    if (protocol !== 'http:' && protocol !== 'https:') {\n      throw new McpError(ErrorCode.InvalidParams, 'Studio only opens http and https links from MCP Apps');\n    }\n    window.open(params.url, '_blank', 'noopener,noreferrer');\n    return {};\n  }, []);\n\n  const handleSizeChanged = useCallback((params: { width?: number; height?: number }) => {\n    if (typeof params.height === 'number') {\n      setHeight(Math.max(100, Math.min(params.height, 2000)));\n    }\n  }, []);\n\n  const handleError = useCallback((error: Error) => {\n    console.error('[McpAppViewer]', error);\n  }, []);\n\n  return (\n    <div\n      className={className}\n      style={{\n        width: '100%',\n        height: `${height}px`,\n        overflow: 'hidden',\n        borderRadius: '8px',\n      }}\n    >\n      <AppRenderer\n        ref={appRef}\n        toolName={toolName}\n        sandbox={sandbox}\n        html={html}\n        toolInput={toolInput}\n        toolResult={normalizedToolResult}\n        hostInfo={hostInfo}\n        hostCapabilities={hostCapabilities}\n        hostContext={hostContext}\n        onCallTool={handleCallTool}\n        onMessage={handleMessage}\n        onFallbackRequest={handleFallbackRequest}\n        onOpenLink={handleOpenLink}\n        onSizeChanged={handleSizeChanged}\n        onError={handleError}\n      />\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/domains/mcps/context/mcp-app-host-context-value.cjs.js

@@ -0,0 +1,11 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let react = require("react");
+// src/domains/mcps/context/mcp-app-host-context-value.ts
+var McpAppHostContext = (0, react.createContext)(null);
+function useMcpAppHostContext() {
+	return (0, react.useContext)(McpAppHostContext);
+}
+exports.McpAppHostContext = McpAppHostContext;
+exports.useMcpAppHostContext = useMcpAppHostContext;
+
+//# sourceMappingURL=mcp-app-host-context-value.cjs.js.map

package/dist/domains/mcps/context/mcp-app-host-context-value.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-app-host-context-value.cjs.js","names":["createContext","useContext"],"sources":["../../../../src/domains/mcps/context/mcp-app-host-context-value.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\n\n/** The MCP App instance a host callback is about: one tool call's app. */\nexport interface McpAppRef {\n  /** Name of the MCP tool whose app this is */\n  toolName: string;\n  /** The chat tool call that rendered the app */\n  toolCallId: string;\n  /** The app's `ui://` resource URI */\n  resourceUri: string;\n}\n\n/** `ui/update-model-context` params as the app sent them. Untrusted: parse before use. */\nexport interface McpAppModelContextParams {\n  content?: unknown[];\n  structuredContent?: Record<string, unknown>;\n}\n\n/** Lets a chat host extend the MCP Apps rendered in its tool cards. */\nexport interface McpAppHostValue {\n  /** Extra host-context keys for this app instance; `theme` stays the viewer's own. */\n  hostContext?: (app: McpAppRef) => Record<string, unknown> | undefined;\n  /** Called with the raw params of every `ui/update-model-context` from this app instance. */\n  onModelContext?: (app: McpAppRef, params: McpAppModelContextParams) => void;\n}\n\nexport const McpAppHostContext = createContext<McpAppHostValue | null>(null);\n\nexport function useMcpAppHostContext() {\n  return useContext(McpAppHostContext);\n}\n"],"mappings":";;;AA0BA,IAAa,qBAAA,GAAoBA,MAAAA,cAAAA,CAAsC,IAAI;AAE3E,SAAgB,uBAAuB;CACrC,QAAA,GAAOC,MAAAA,WAAAA,CAAW,iBAAiB;AACrC"}

package/dist/domains/mcps/context/mcp-app-host-context-value.d.ts

@@ -0,0 +1 @@
+export * from '../../../src/domains/mcps/context/mcp-app-host-context-value';

package/dist/domains/mcps/context/mcp-app-host-context-value.es.js

@@ -0,0 +1,9 @@
+import { createContext, useContext } from "react";
+// src/domains/mcps/context/mcp-app-host-context-value.ts
+var McpAppHostContext = createContext(null);
+function useMcpAppHostContext() {
+	return useContext(McpAppHostContext);
+}
+export { McpAppHostContext, useMcpAppHostContext };
+
+//# sourceMappingURL=mcp-app-host-context-value.es.js.map

package/dist/domains/mcps/context/mcp-app-host-context-value.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-app-host-context-value.es.js","names":[],"sources":["../../../../src/domains/mcps/context/mcp-app-host-context-value.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\n\n/** The MCP App instance a host callback is about: one tool call's app. */\nexport interface McpAppRef {\n  /** Name of the MCP tool whose app this is */\n  toolName: string;\n  /** The chat tool call that rendered the app */\n  toolCallId: string;\n  /** The app's `ui://` resource URI */\n  resourceUri: string;\n}\n\n/** `ui/update-model-context` params as the app sent them. Untrusted: parse before use. */\nexport interface McpAppModelContextParams {\n  content?: unknown[];\n  structuredContent?: Record<string, unknown>;\n}\n\n/** Lets a chat host extend the MCP Apps rendered in its tool cards. */\nexport interface McpAppHostValue {\n  /** Extra host-context keys for this app instance; `theme` stays the viewer's own. */\n  hostContext?: (app: McpAppRef) => Record<string, unknown> | undefined;\n  /** Called with the raw params of every `ui/update-model-context` from this app instance. */\n  onModelContext?: (app: McpAppRef, params: McpAppModelContextParams) => void;\n}\n\nexport const McpAppHostContext = createContext<McpAppHostValue | null>(null);\n\nexport function useMcpAppHostContext() {\n  return useContext(McpAppHostContext);\n}\n"],"mappings":";;AA0BA,IAAa,oBAAoB,cAAsC,IAAI;AAE3E,SAAgB,uBAAuB;CACrC,OAAO,WAAW,iBAAiB;AACrC"}

package/dist/domains/mcps/context/mcp-app-host-context.cjs.js

@@ -0,0 +1,14 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_domains_mcps_context_mcp_app_host_context_value = require("./mcp-app-host-context-value.cjs.js");
+let react_jsx_runtime = require("react/jsx-runtime");
+// src/domains/mcps/context/mcp-app-host-context.tsx
+/** Extends the MCP Apps rendered in the chat's tool cards; see `McpAppHostValue`. */
+function McpAppHostProvider({ value, children }) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_domains_mcps_context_mcp_app_host_context_value.McpAppHostContext.Provider, {
+		value,
+		children
+	});
+}
+exports.McpAppHostProvider = McpAppHostProvider;
+
+//# sourceMappingURL=mcp-app-host-context.cjs.js.map

package/dist/domains/mcps/context/mcp-app-host-context.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-app-host-context.cjs.js","names":["McpAppHostContext"],"sources":["../../../../src/domains/mcps/context/mcp-app-host-context.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\n\nimport { McpAppHostContext } from './mcp-app-host-context-value';\nimport type { McpAppHostValue } from './mcp-app-host-context-value';\n\n/** Extends the MCP Apps rendered in the chat's tool cards; see `McpAppHostValue`. */\nexport function McpAppHostProvider({ value, children }: { value: McpAppHostValue; children: ReactNode }) {\n  return <McpAppHostContext.Provider value={value}>{children}</McpAppHostContext.Provider>;\n}\n"],"mappings":";;;;;AAMA,SAAgB,mBAAmB,EAAE,OAAO,YAA6D;CACvG,OAAO,iBAAA,GAAA,kBAAA,IAAA,CAACA,wDAAAA,kBAAkB,UAAnB;EAAmC;EAAQ;CAAqC,CAAA;AACzF"}

package/dist/domains/mcps/context/mcp-app-host-context.d.ts

@@ -0,0 +1 @@
+export * from '../../../src/domains/mcps/context/mcp-app-host-context';

package/dist/domains/mcps/context/mcp-app-host-context.es.js

@@ -0,0 +1,13 @@
+import { McpAppHostContext } from "./mcp-app-host-context-value.es.js";
+import { jsx } from "react/jsx-runtime";
+// src/domains/mcps/context/mcp-app-host-context.tsx
+/** Extends the MCP Apps rendered in the chat's tool cards; see `McpAppHostValue`. */
+function McpAppHostProvider({ value, children }) {
+	return /* @__PURE__ */ jsx(McpAppHostContext.Provider, {
+		value,
+		children
+	});
+}
+export { McpAppHostProvider };
+
+//# sourceMappingURL=mcp-app-host-context.es.js.map

package/dist/domains/mcps/context/mcp-app-host-context.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-app-host-context.es.js","names":[],"sources":["../../../../src/domains/mcps/context/mcp-app-host-context.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\n\nimport { McpAppHostContext } from './mcp-app-host-context-value';\nimport type { McpAppHostValue } from './mcp-app-host-context-value';\n\n/** Extends the MCP Apps rendered in the chat's tool cards; see `McpAppHostValue`. */\nexport function McpAppHostProvider({ value, children }: { value: McpAppHostValue; children: ReactNode }) {\n  return <McpAppHostContext.Provider value={value}>{children}</McpAppHostContext.Provider>;\n}\n"],"mappings":";;;;AAMA,SAAgB,mBAAmB,EAAE,OAAO,YAA6D;CACvG,OAAO,oBAAC,kBAAkB,UAAnB;EAAmC;EAAQ;CAAqC,CAAA;AACzF"}

package/dist/domains/mcps/hooks/use-mcp-app-tool-call.cjs.js

@@ -0,0 +1,37 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_types = require("../../../types-KjLUPShK.cjs");
+let react = require("react");
+let _mastra_react = require("@mastra/react");
+let _tanstack_react_query = require("@tanstack/react-query");
+// src/domains/mcps/hooks/use-mcp-app-tool-call.ts
+/** Per the MCP Apps spec, a tool without `_meta.ui.visibility` is visible to both the model and apps. */
+function isAppCallable(tool) {
+	const visibility = tool._meta?.ui?.visibility;
+	return !Array.isArray(visibility) || visibility.includes("app");
+}
+/**
+* Runs the tools an MCP App calls on its own server. Tools the server keeps for the model
+* (`_meta.ui.visibility` without `"app"`) are refused, as the MCP Apps spec requires of hosts.
+*/
+function useMcpAppToolCall(serverId) {
+	const client = (0, _mastra_react.useMastraClient)();
+	const queryClient = (0, _tanstack_react_query.useQueryClient)();
+	return (0, react.useCallback)(async (toolName, args) => {
+		const { tools } = await queryClient.fetchQuery({
+			queryKey: ["mcp-app-server-tools", serverId],
+			queryFn: () => client.getMcpServerTools(serverId),
+			staleTime: 6e4
+		});
+		const tool = tools.find((candidate) => candidate.name === toolName);
+		if (!tool || !isAppCallable(tool)) throw new require_types.McpError(require_types.ErrorCode.InvalidParams, `Tool "${toolName}" isn't available to apps on MCP server "${serverId}"`);
+		const response = await client.getMcpServerTool(serverId, toolName).execute({ data: args });
+		return "result" in response ? response.result : response;
+	}, [
+		client,
+		queryClient,
+		serverId
+	]);
+}
+exports.useMcpAppToolCall = useMcpAppToolCall;
+
+//# sourceMappingURL=use-mcp-app-tool-call.cjs.js.map

package/dist/domains/mcps/hooks/use-mcp-app-tool-call.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-mcp-app-tool-call.cjs.js","names":["useMastraClient","useQueryClient","useCallback","McpError","ErrorCode"],"sources":["../../../../src/domains/mcps/hooks/use-mcp-app-tool-call.ts"],"sourcesContent":["import type { McpServerToolListResponse } from '@mastra/client-js';\nimport { useMastraClient } from '@mastra/react';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { useQueryClient } from '@tanstack/react-query';\nimport { useCallback } from 'react';\n\ntype McpServerTool = McpServerToolListResponse['tools'][number];\n\n/** Per the MCP Apps spec, a tool without `_meta.ui.visibility` is visible to both the model and apps. */\nfunction isAppCallable(tool: McpServerTool): boolean {\n  const visibility = (tool._meta as { ui?: { visibility?: unknown } } | undefined)?.ui?.visibility;\n  return !Array.isArray(visibility) || visibility.includes('app');\n}\n\n/**\n * Runs the tools an MCP App calls on its own server. Tools the server keeps for the model\n * (`_meta.ui.visibility` without `\"app\"`) are refused, as the MCP Apps spec requires of hosts.\n */\nexport function useMcpAppToolCall(serverId: string) {\n  const client = useMastraClient();\n  const queryClient = useQueryClient();\n\n  return useCallback(\n    async (toolName: string, args: Record<string, unknown>) => {\n      const { tools } = await queryClient.fetchQuery({\n        queryKey: ['mcp-app-server-tools', serverId],\n        queryFn: () => client.getMcpServerTools(serverId),\n        staleTime: 60_000,\n      });\n      const tool = tools.find(candidate => candidate.name === toolName);\n      if (!tool || !isAppCallable(tool)) {\n        // Invalid params is the code MCP servers answer an unknown tool with, so apps can tell it apart.\n        throw new McpError(\n          ErrorCode.InvalidParams,\n          `Tool \"${toolName}\" isn't available to apps on MCP server \"${serverId}\"`,\n        );\n      }\n      const response = await client.getMcpServerTool(serverId, toolName).execute({ data: args });\n      return 'result' in response ? response.result : response;\n    },\n    [client, queryClient, serverId],\n  );\n}\n"],"mappings":";;;;;;;AASA,SAAS,cAAc,MAA8B;CACnD,MAAM,aAAc,KAAK,OAAyD,IAAI;CACtF,OAAO,CAAC,MAAM,QAAQ,UAAU,KAAK,WAAW,SAAS,KAAK;AAChE;;;;;AAMA,SAAgB,kBAAkB,UAAkB;CAClD,MAAM,UAAA,GAASA,cAAAA,gBAAAA,CAAgB;CAC/B,MAAM,eAAA,GAAcC,sBAAAA,eAAAA,CAAe;CAEnC,QAAA,GAAOC,MAAAA,YAAAA,CACL,OAAO,UAAkB,SAAkC;EACzD,MAAM,EAAE,UAAU,MAAM,YAAY,WAAW;GAC7C,UAAU,CAAC,wBAAwB,QAAQ;GAC3C,eAAe,OAAO,kBAAkB,QAAQ;GAChD,WAAW;EACb,CAAC;EACD,MAAM,OAAO,MAAM,MAAK,cAAa,UAAU,SAAS,QAAQ;EAChE,IAAI,CAAC,QAAQ,CAAC,cAAc,IAAI,GAE9B,MAAM,IAAIC,cAAAA,SACRC,cAAAA,UAAU,eACV,SAAS,SAAS,2CAA2C,SAAS,EACxE;EAEF,MAAM,WAAW,MAAM,OAAO,iBAAiB,UAAU,QAAQ,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,CAAC;EACzF,OAAO,YAAY,WAAW,SAAS,SAAS;CAClD,GACA;EAAC;EAAQ;EAAa;CAAQ,CAChC;AACF"}

package/dist/domains/mcps/hooks/use-mcp-app-tool-call.d.ts

@@ -0,0 +1 @@
+export * from '../../../src/domains/mcps/hooks/use-mcp-app-tool-call';