@ulearning/ai-sdk 0.0.0-stage → 1.0.0-next.0

package/dist/legacy-runtime/AssistantRuntimeProvider.d.ts

@@ -0,0 +1,13 @@
+import { type AssistantClient, type AuiConfig } from "@ulearning/ai-store";
+import type { AssistantRuntime } from "@ulearning/ai-core";
+export declare namespace AssistantRuntimeProvider {
+    type Props = {
+        runtime: AssistantRuntime;
+        /** Explicit parent client; omitted providers start an isolated scope. */
+        aui?: AssistantClient | undefined;
+        config?: AuiConfig | undefined;
+    };
+}
+export declare const AssistantRuntimeProviderImpl: import("vue").DefineSetupFnComponent<AssistantRuntimeProvider.Props, {}, {}, AssistantRuntimeProvider.Props & {}, import("vue").PublicProps>;
+export declare const AssistantRuntimeProvider: import("vue").DefineSetupFnComponent<AssistantRuntimeProvider.Props, {}, {}, AssistantRuntimeProvider.Props & {}, import("vue").PublicProps>;
+//# sourceMappingURL=AssistantRuntimeProvider.d.ts.map

package/dist/legacy-runtime/AssistantRuntimeProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssistantRuntimeProvider.d.ts","mappings":"AAGA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,SAAS,EAEf,MAAM,qBAAqB;AAE5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB;AAK1D,yBAAiB,wBAAwB,CAAC;IACxC,KAAY,KAAK,GAAG;QAClB,OAAO,EAAE,gBAAgB;QACzB;QACA,GAAG,CAAC,EAAE,eAAe,GAAG,SAAS;QACjC,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS;KAC/B;;AAiBH,eAAO,MAAM,4BAA4B,8IAsBxC;AACD,eAAO,MAAM,wBAAwB,8IAA+B","names":[],"ignoreList":[],"sources":["../../src/legacy-runtime/AssistantRuntimeProvider.tsx"],"sourcesContent":[null]}

package/dist/legacy-runtime/AssistantRuntimeProvider.js

@@ -0,0 +1,37 @@
+"use client";
+import { ThreadPrimitiveViewportProvider } from "../context/providers/ThreadViewportProvider.js";
+import { DevToolsProviderApi } from "../devtools/DevToolsHooks.js";
+import { AssistantProviderBase } from "@ulearning/ai-core/vue";
+import { defineComponent, h } from "vue";
+import { useAui } from "@ulearning/ai-store";
+import { useIsomorphicLayoutEffect } from "@ulearning/ai-store/internal";
+// src/legacy-runtime/AssistantRuntimeProvider.tsx
+const DevToolsRegistration = defineComponent({
+	name: "DevToolsRegistration",
+	setup() {
+		const aui = useAui();
+		useIsomorphicLayoutEffect(() => {
+			if (typeof process === "undefined" || process.env.NODE_ENV === "production") return;
+			return DevToolsProviderApi.register(aui);
+		}, []);
+		return () => null;
+	}
+});
+const AssistantRuntimeProviderImpl = defineComponent(function AssistantRuntimeProvider(props, { slots }) {
+	return () => h(AssistantProviderBase, {
+		runtime: props.runtime,
+		aui: props.aui ?? null,
+		config: props.config
+	}, { default: () => [h(DevToolsRegistration), h(ThreadPrimitiveViewportProvider, null, slots)] });
+}, {
+	name: "AssistantRuntimeProvider",
+	props: [
+		"runtime",
+		"aui",
+		"config"
+	]
+});
+const AssistantRuntimeProvider = AssistantRuntimeProviderImpl;
+export { AssistantRuntimeProvider, AssistantRuntimeProviderImpl };
+
+//# sourceMappingURL=AssistantRuntimeProvider.js.map

package/dist/legacy-runtime/AssistantRuntimeProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssistantRuntimeProvider.js","names":["defineComponent","h","AssistantClient","AuiConfig","useAui","useIsomorphicLayoutEffect","AssistantRuntime","AssistantProviderBase","ThreadPrimitiveViewportProvider","DevToolsProviderApi","AssistantRuntimeProvider","Props","runtime","aui","config","DevToolsRegistration","name","setup","process","env","NODE_ENV","register","AssistantRuntimeProviderImpl","props","slots","default"],"sources":["../../src/legacy-runtime/AssistantRuntimeProvider.tsx"],"sourcesContent":["\"use client\";\n\nimport { defineComponent, h } from \"vue\";\nimport {\n  type AssistantClient,\n  type AuiConfig,\n  useAui,\n} from \"@ulearning/ai-store\";\nimport { useIsomorphicLayoutEffect } from \"@ulearning/ai-store/internal\";\nimport type { AssistantRuntime } from \"@ulearning/ai-core\";\nimport { AssistantProviderBase } from \"@ulearning/ai-core/vue\";\nimport { ThreadPrimitiveViewportProvider } from \"../context/providers/ThreadViewportProvider\";\nimport { DevToolsProviderApi } from \"../devtools/DevToolsHooks\";\n\nexport namespace AssistantRuntimeProvider {\n  export type Props = {\n    runtime: AssistantRuntime;\n    /** Explicit parent client; omitted providers start an isolated scope. */\n    aui?: AssistantClient | undefined;\n    config?: AuiConfig | undefined;\n  };\n}\nconst DevToolsRegistration = defineComponent({\n  name: \"DevToolsRegistration\",\n  setup() {\n    const aui = useAui();\n    useIsomorphicLayoutEffect(() => {\n      if (\n        typeof process === \"undefined\" ||\n        process.env.NODE_ENV === \"production\"\n      )\n        return;\n      return DevToolsProviderApi.register(aui);\n    }, []);\n    return () => null;\n  },\n});\nexport const AssistantRuntimeProviderImpl = defineComponent(\n  function AssistantRuntimeProvider(\n    props: AssistantRuntimeProvider.Props,\n    { slots },\n  ) {\n    return () =>\n      h(\n        AssistantProviderBase,\n        {\n          runtime: props.runtime,\n          aui: props.aui ?? null,\n          config: props.config,\n        },\n        {\n          default: () => [\n            h(DevToolsRegistration),\n            h(ThreadPrimitiveViewportProvider, null, slots),\n          ],\n        },\n      );\n  },\n  { name: \"AssistantRuntimeProvider\", props: [\"runtime\", \"aui\", \"config\"] },\n);\nexport const AssistantRuntimeProvider = AssistantRuntimeProviderImpl;\n"],"mappings":";;;;;;;;AAsBA,MAAMe,uBAAuBf,gBAAgB;CAC3CgB,MAAM;CACNC,QAAQ;EACN,MAAMJ,MAAMT,OAAO;EACnBC,gCAAgC;GAC9B,IACE,OAAOa,YAAY,eACnBA,QAAQC,IAAIC,aAAa,cAEzB;GACF,OAAOX,oBAAoBY,SAASR,GAAG;EACzC,GAAG,CAAA,CAAE;EACL,aAAa;CACf;AACF,CAAC;AACD,MAAaS,+BAA+BtB,gBAC1C,SAASU,yBACPa,OACA,EAAEC,SACF;CACA,aACEvB,EACEM,uBACA;EACEK,SAASW,MAAMX;EACfC,KAAKU,MAAMV,OAAO;EAClBC,QAAQS,MAAMT;CAChB,GACA,EACEW,eAAe,CACbxB,EAAEc,oBAAoB,GACtBd,EAAEO,iCAAiC,MAAMgB,KAAK,CAAC,EAEnD,CACF;AACJ,GACA;CAAER,MAAM;CAA4BO,OAAO;EAAC;EAAW;EAAO;CAAQ;AAAE,CAC1E;AACA,MAAab,2BAA2BY"}

package/dist/mcp-apps/McpAppRenderer.d.ts

@@ -0,0 +1,60 @@
+import { type VNodeChild } from "vue";
+import type { ToolCallMessagePart } from "@ulearning/ai-core";
+import type { ToolCallMessagePartComponent } from "@ulearning/ai-core/vue";
+import { type ResourceElement } from "@ulearning/ai-tap";
+import type { McpAppBridgeHandlers, McpAppHostContext, McpAppHostInfo, McpAppSandboxConfig, McpAppsHost } from "./types.js";
+/**
+ * Options that apply to a single MCP app. `McpAppRenderer` takes them as
+ * thread-wide defaults, and its `forPart` resolver overrides them for one part.
+ */
+export type McpAppPartOptions = {
+    /** Sandbox + container styling. Passes through to SafeContentFrame. */
+    sandbox?: McpAppSandboxConfig;
+    /**
+     * Upper bound (in pixels) applied to the widget-driven auto-resize height.
+     * Defaults to 800.
+     */
+    maxHeight?: number;
+    /** Identifies the host to the widget in the `ui/initialize` response. */
+    hostInfo?: McpAppHostInfo;
+    /** Delivered to the widget on initialize and pushed via `notifications/host_context/changed` on change. */
+    hostContext?: McpAppHostContext;
+    /**
+     * Optional widget interaction and lifecycle handlers. Data-plane handlers
+     * (`callTool`, `readResource`, `listResources`) always use `host`.
+     *
+     * Which handlers a widget may call is captured when its frame mounts, so a
+     * `forPart` resolver returns the same handler keys for a part on every
+     * render even when the implementations change.
+     */
+    handlers?: Omit<McpAppBridgeHandlers, "callTool" | "readResource" | "listResources">;
+    /** Rendered when no MCP app is on the part, or while load is in flight / failed (unless overridden). */
+    fallback?: VNodeChild;
+    /** Rendered while the resource is loading. Defaults to `fallback`. */
+    loadingFallback?: VNodeChild;
+    /** Rendered when the resource load rejects. Defaults to `fallback`. */
+    errorFallback?: VNodeChild | ((error: Error) => VNodeChild);
+};
+export type McpAppRendererOptions = McpAppPartOptions & {
+    /**
+     * Provides the data-plane operations the widget can request
+     * (`loadResource`, `callTool`, `readResource`, `listResources`). Use
+     * `McpAppsRemoteHost({ url })` for the default HTTP-route convention.
+     */
+    host: ResourceElement<McpAppsHost>;
+    /**
+     * Resolves the options for one part. Each returned value replaces the
+     * thread-wide option of the same name, so a host can give every MCP app its
+     * own display mode and answer `requestDisplayMode` for the part that asked.
+     *
+     * `handlers` is the exception and merges per key. Its keys are capabilities
+     * negotiated with the widget rather than data, so replacing the whole bag to
+     * add one handler would withdraw the others from that part's widget with
+     * nothing to observe it by.
+     */
+    forPart?: (part: ToolCallMessagePart) => McpAppPartOptions;
+};
+export declare const McpAppRenderer: import("@ulearning/ai-tap").Resource<{
+    readonly render: ToolCallMessagePartComponent;
+}, [options: McpAppRendererOptions]>;
+//# sourceMappingURL=McpAppRenderer.d.ts.map

package/dist/mcp-apps/McpAppRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpAppRenderer.d.ts","mappings":"AAEA,OAAO,EAA4C,KAAK,UAAU,EAAE,MAAM,KAAK;AAG/E,OAAO,KAAK,EAGV,mBAAmB,EACpB,MAAM,oBAAoB;AAC3B,OAAO,KAAK,EACV,4BAA4B,EAE7B,MAAM,wBAAwB;AAI/B,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,mBAAmB;AAE/E,OAAO,KAAK,EACV,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EAEd,mBAAmB,EACnB,WAAW,EACZ,MAAM,YAAS;AAIhB;;;;AAIA,MAAM,MAAM,iBAAiB,GAAG;IAC9B;IACA,OAAO,CAAC,EAAE,mBAAmB;IAC7B;;;;IAIA,SAAS,CAAC,EAAE,MAAM;IAClB;IACA,QAAQ,CAAC,EAAE,cAAc;IACzB;IACA,WAAW,CAAC,EAAE,iBAAiB;IAC/B;;;;;;;;IAQA,QAAQ,CAAC,EAAE,IAAI,CACb,oBAAoB,EACpB,UAAU,GAAG,cAAc,GAAG,eAAe,CAC9C;IACD;IACA,QAAQ,CAAC,EAAE,UAAU;IACrB;IACA,eAAe,CAAC,EAAE,UAAU;IAC5B;IACA,aAAa,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,UAAU,CAAC;CAC5D;AAED,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG;IACtD;;;;;IAKA,IAAI,EAAE,eAAe,CAAC,WAAW,CAAC;IAClC;;;;;;;;;;IAUA,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,iBAAiB;CAC3D;AAsUD,eAAO,MAAM,cAAc;qBA9BL,4BAA4B;oCA8BO","names":[],"ignoreList":[],"sources":["../../src/mcp-apps/McpAppRenderer.tsx"],"sourcesContent":[null]}

package/dist/mcp-apps/McpAppRenderer.js

@@ -0,0 +1,223 @@
+"use client";
+import { useIsomorphicLayoutEffect } from "../utils/useIsomorphicLayoutEffect.js";
+import { McpAppFrame } from "./app-frame.js";
+import { getMcpAppFromToolPart } from "./utils.js";
+import { computed, defineComponent, h, shallowRef } from "vue";
+import { useAui } from "@ulearning/ai-store";
+import { createStore } from "zustand/vanilla";
+import { isRecord } from "@ulearning/ai-core/internal";
+import { resource, useEffect, useMemo, useResource, useState } from "@ulearning/ai-tap";
+// src/mcp-apps/McpAppRenderer.tsx
+const isSameOptions = (a, b) => {
+	const aKeys = Object.keys(a).filter((key) => key !== "host");
+	const bKeys = Object.keys(b).filter((key) => key !== "host");
+	if (aKeys.length !== bKeys.length) return false;
+	const aValues = a;
+	const bValues = b;
+	return aKeys.every((key) => Object.hasOwn(bValues, key) && Object.is(aValues[key], bValues[key]));
+};
+function getInput(part) {
+	if (part.status.type === "running" && (part.argsText === "" || part.argsText === "{}")) return;
+	return part.args;
+}
+const defaultOpenLink = ({ url }) => {
+	window.open(url, "_blank", "noopener,noreferrer");
+};
+function extractSendMessageTexts(params) {
+	if (typeof params === "string") return [params];
+	if (!params || typeof params !== "object") return void 0;
+	const obj = params;
+	if (typeof obj["prompt"] === "string") return [obj["prompt"]];
+	if (typeof obj["text"] === "string") return [obj["text"]];
+	if (typeof obj["message"] === "string") return [obj["message"]];
+	const content = obj["content"];
+	if (Array.isArray(content)) return Object.keys(content).filter((key) => {
+		const index = Number(key);
+		return Number.isInteger(index) && index >= 0 && index < content.length && String(index) === key;
+	}).map((key) => content[Number(key)]).filter((block) => isRecord(block) && block["type"] === "text" && typeof block["text"] === "string").map((block) => block.text);
+}
+function extractSendMessageContent(params) {
+	const texts = extractSendMessageTexts(params);
+	if (!texts) return { reason: "unrecognised params shape" };
+	const content = texts.filter((text) => text !== "").map((text) => ({
+		type: "text",
+		text
+	}));
+	if (content.length === 0) return { reason: "no text content to append" };
+	return { content };
+}
+function resolvePartOptions(options, part) {
+	const overrides = options.forPart?.(part);
+	if (!overrides) return options;
+	const handlers = options.handlers && overrides.handlers ? {
+		...options.handlers,
+		...overrides.handlers
+	} : overrides.handlers ?? options.handlers;
+	return {
+		...options,
+		...overrides,
+		...handlers === void 0 ? {} : { handlers }
+	};
+}
+const InlineRenderer = defineComponent((props) => {
+	const aui = useAui();
+	const store = props.useRendererStore;
+	const snapshot = shallowRef(store.getState());
+	useIsomorphicLayoutEffect(() => {
+		let active = true;
+		const refresh = () => {
+			if (active) snapshot.value = store.getState();
+		};
+		const release = store.subscribe(refresh);
+		refresh();
+		return () => {
+			active = false;
+			release();
+		};
+	}, []);
+	const host = computed(() => snapshot.value.host);
+	const opts = computed(() => resolvePartOptions(snapshot.value.options, props.part));
+	const app = computed(() => getMcpAppFromToolPart(props.part));
+	let cachedApp;
+	useIsomorphicLayoutEffect(() => {
+		if (app.value != null) cachedApp = app.value;
+	}, () => [app.value]);
+	const appForRender = computed(() => app.value ?? cachedApp);
+	const loadedResource = shallowRef();
+	const resourceUri = computed(() => appForRender.value?.resourceUri);
+	const serverId = computed(() => appForRender.value?.serverId);
+	useIsomorphicLayoutEffect(() => {
+		if (resourceUri.value == null) return;
+		let cancelled = false;
+		const targetHost = host.value;
+		const targetUri = resourceUri.value;
+		const targetServerId = serverId.value;
+		const loadResource = async () => {
+			await Promise.resolve();
+			if (cancelled || store.getState().host !== targetHost) return;
+			try {
+				const resource = await targetHost.loadResource({
+					uri: targetUri,
+					...targetServerId ? { serverId: targetServerId } : {}
+				});
+				if (!cancelled) loadedResource.value = {
+					host: targetHost,
+					resourceUri: targetUri,
+					...targetServerId !== void 0 ? { serverId: targetServerId } : {},
+					resource
+				};
+			} catch (error) {
+				if (!cancelled) loadedResource.value = {
+					host: targetHost,
+					resourceUri: targetUri,
+					...targetServerId !== void 0 ? { serverId: targetServerId } : {},
+					error: error instanceof Error ? error : new Error(String(error))
+				};
+			}
+		};
+		loadResource();
+		return () => {
+			cancelled = true;
+		};
+	}, () => [
+		host.value,
+		resourceUri.value,
+		serverId.value
+	]);
+	const bridgeHandlers = computed(() => {
+		const callerHandlers = opts.value.handlers;
+		const committedServerId = serverId.value;
+		return {
+			...callerHandlers,
+			openLink: callerHandlers?.openLink ?? defaultOpenLink,
+			sendMessage: callerHandlers?.sendMessage ?? ((params) => {
+				const result = extractSendMessageContent(params);
+				if ("reason" in result) return {
+					isError: true,
+					ok: false,
+					reason: result.reason
+				};
+				const composer = aui.thread.composer();
+				composer.setText([composer.getState().text, result.content.map((part) => part.text).join("\n")].filter((part) => part.trim()).join(" "));
+				return { ok: true };
+			}),
+			callTool: (params) => store.getState().host.callTool({
+				...params,
+				...committedServerId ? { serverId: committedServerId } : {}
+			}),
+			readResource: (params) => store.getState().host.readResource({
+				...params,
+				...committedServerId ? { serverId: committedServerId } : {}
+			}),
+			listResources: (params) => committedServerId ? store.getState().host.listResources({
+				...isRecord(params) ? params : {},
+				serverId: committedServerId
+			}) : store.getState().host.listResources(params)
+		};
+	});
+	return () => {
+		const options = opts.value;
+		const metadata = appForRender.value;
+		const loaded = loadedResource.value;
+		const current = loaded?.host === host.value && loaded?.resourceUri === metadata?.resourceUri && loaded?.serverId === metadata?.serverId ? loaded : void 0;
+		const fallback = options.fallback ?? null;
+		if (metadata == null) return fallback;
+		if (current?.error != null) {
+			const errorFallback = options.errorFallback;
+			return errorFallback === void 0 ? fallback : typeof errorFallback === "function" ? errorFallback(current.error) : errorFallback;
+		}
+		if (current?.resource == null) return options.loadingFallback ?? fallback;
+		return h(McpAppFrame, {
+			app: metadata,
+			resource: current.resource,
+			input: getInput(props.part),
+			output: props.part.result,
+			...options.sandbox === void 0 ? {} : { sandbox: options.sandbox },
+			handlers: bridgeHandlers.value,
+			...options.hostInfo === void 0 ? {} : { hostInfo: options.hostInfo },
+			...options.hostContext === void 0 ? {} : { hostContext: options.hostContext },
+			...options.maxHeight === void 0 ? {} : { maxHeight: options.maxHeight }
+		});
+	};
+}, {
+	name: "McpAppInlineRenderer",
+	props: ["part", "useRendererStore"]
+});
+/**
+* Creates a tool-call renderer for MCP Apps embedded in assistant messages.
+*
+* Compose this into the `Tools` resource through its `mcpApp` option. When a
+* tool-call part carries `mcp.app` metadata for a `ui://` resource, the
+* renderer loads that resource from the configured host and displays it in a
+* sandboxed frame.
+*/
+const useMcpAppRenderer = (options) => {
+	const host = useResource(options.host);
+	const [useRendererStore] = useState(() => createStore(() => ({
+		host,
+		options
+	})));
+	useEffect(() => {
+		useRendererStore.setState((prev) => prev.host === host && isSameOptions(prev.options, options) ? prev : {
+			host,
+			options
+		});
+	}, [
+		host,
+		options,
+		useRendererStore
+	]);
+	return { render: useMemo(() => {
+		function McpAppRenderer(props) {
+			return h(InlineRenderer, {
+				part: { ...props },
+				useRendererStore
+			});
+		}
+		return McpAppRenderer;
+	}, [useRendererStore]) };
+};
+const McpAppRenderer = resource(useMcpAppRenderer);
+export { McpAppRenderer };
+
+//# sourceMappingURL=McpAppRenderer.js.map

package/dist/mcp-apps/McpAppRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpAppRenderer.js","names":["computed","defineComponent","h","shallowRef","VNodeChild","useEffect","useMemo","useState","useIsomorphicLayoutEffect","McpAppMetadata","TextMessagePart","ToolCallMessagePart","ToolCallMessagePartComponent","ToolCallMessagePartProps","useAui","createStore","StoreApi","useResource","resource","ResourceElement","McpAppFrame","McpAppBridgeHandlers","McpAppHostContext","McpAppHostInfo","McpAppResource","McpAppSandboxConfig","McpAppsHost","getMcpAppFromToolPart","isRecord","McpAppPartOptions","sandbox","maxHeight","hostInfo","hostContext","handlers","Omit","fallback","loadingFallback","errorFallback","error","Error","McpAppRendererOptions","host","forPart","part","LoadedResourceState","resourceUri","serverId","RendererState","options","UseRendererStore","isSameOptions","a","b","aKeys","Object","keys","filter","key","bKeys","length","aValues","Record","bValues","every","hasOwn","is","getInput","status","type","argsText","args","undefined","defaultOpenLink","url","window","open","extractSendMessageTexts","params","obj","content","Array","isArray","index","Number","isInteger","String","map","block","text","extractSendMessageContent","reason","texts","resolvePartOptions","overrides","InlineRenderer","props","useRendererStore","aui","store","snapshot","getState","active","refresh","value","release","subscribe","opts","app","cachedApp","appForRender","loadedResource","cancelled","targetHost","targetUri","targetServerId","loadResource","Promise","resolve","uri","bridgeHandlers","callerHandlers","committedServerId","openLink","sendMessage","result","isError","ok","composer","thread","setText","join","trim","callTool","readResource","listResources","metadata","loaded","current","input","output","name","useMcpAppRenderer","render","setState","prev","McpAppRenderer","Render","Render"],"sources":["../../src/mcp-apps/McpAppRenderer.tsx"],"sourcesContent":["\"use client\";\n\nimport { computed, defineComponent, h, shallowRef, type VNodeChild } from \"vue\";\nimport { useEffect, useMemo, useState } from \"@ulearning/ai-tap\";\nimport { useIsomorphicLayoutEffect } from \"../utils/useIsomorphicLayoutEffect\";\nimport type {\n  McpAppMetadata,\n  TextMessagePart,\n  ToolCallMessagePart,\n} from \"@ulearning/ai-core\";\nimport type {\n  ToolCallMessagePartComponent,\n  ToolCallMessagePartProps,\n} from \"@ulearning/ai-core/vue\";\nimport { useAui } from \"@ulearning/ai-store\";\nimport { createStore, type StoreApi } from \"zustand/vanilla\";\n\nimport { useResource, resource, type ResourceElement } from \"@ulearning/ai-tap\";\nimport { McpAppFrame } from \"./app-frame\";\nimport type {\n  McpAppBridgeHandlers,\n  McpAppHostContext,\n  McpAppHostInfo,\n  McpAppResource,\n  McpAppSandboxConfig,\n  McpAppsHost,\n} from \"./types\";\nimport { getMcpAppFromToolPart } from \"./utils\";\nimport { isRecord } from \"@ulearning/ai-core/internal\";\n\n/**\n * Options that apply to a single MCP app. `McpAppRenderer` takes them as\n * thread-wide defaults, and its `forPart` resolver overrides them for one part.\n */\nexport type McpAppPartOptions = {\n  /** Sandbox + container styling. Passes through to SafeContentFrame. */\n  sandbox?: McpAppSandboxConfig;\n  /**\n   * Upper bound (in pixels) applied to the widget-driven auto-resize height.\n   * Defaults to 800.\n   */\n  maxHeight?: number;\n  /** Identifies the host to the widget in the `ui/initialize` response. */\n  hostInfo?: McpAppHostInfo;\n  /** Delivered to the widget on initialize and pushed via `notifications/host_context/changed` on change. */\n  hostContext?: McpAppHostContext;\n  /**\n   * Optional widget interaction and lifecycle handlers. Data-plane handlers\n   * (`callTool`, `readResource`, `listResources`) always use `host`.\n   *\n   * Which handlers a widget may call is captured when its frame mounts, so a\n   * `forPart` resolver returns the same handler keys for a part on every\n   * render even when the implementations change.\n   */\n  handlers?: Omit<\n    McpAppBridgeHandlers,\n    \"callTool\" | \"readResource\" | \"listResources\"\n  >;\n  /** Rendered when no MCP app is on the part, or while load is in flight / failed (unless overridden). */\n  fallback?: VNodeChild;\n  /** Rendered while the resource is loading. Defaults to `fallback`. */\n  loadingFallback?: VNodeChild;\n  /** Rendered when the resource load rejects. Defaults to `fallback`. */\n  errorFallback?: VNodeChild | ((error: Error) => VNodeChild);\n};\n\nexport type McpAppRendererOptions = McpAppPartOptions & {\n  /**\n   * Provides the data-plane operations the widget can request\n   * (`loadResource`, `callTool`, `readResource`, `listResources`). Use\n   * `McpAppsRemoteHost({ url })` for the default HTTP-route convention.\n   */\n  host: ResourceElement<McpAppsHost>;\n  /**\n   * Resolves the options for one part. Each returned value replaces the\n   * thread-wide option of the same name, so a host can give every MCP app its\n   * own display mode and answer `requestDisplayMode` for the part that asked.\n   *\n   * `handlers` is the exception and merges per key. Its keys are capabilities\n   * negotiated with the widget rather than data, so replacing the whole bag to\n   * add one handler would withdraw the others from that part's widget with\n   * nothing to observe it by.\n   */\n  forPart?: (part: ToolCallMessagePart) => McpAppPartOptions;\n};\n\ntype LoadedResourceState = {\n  host: McpAppsHost;\n  resourceUri: string;\n  serverId?: string;\n  resource?: McpAppResource;\n  error?: Error;\n};\n\ntype RendererState = {\n  host: McpAppsHost;\n  options: McpAppRendererOptions;\n};\n\ntype UseRendererStore = StoreApi<RendererState>;\n\n// Callers pass options as an object literal, so the resource hands this a fresh\n// identity on every run; comparing the values keeps an unchanged run from\n// re-rendering every mounted part. `host` is excluded because it is an element\n// rebuilt on every run, and the store carries the resolved host separately.\nconst isSameOptions = (\n  a: McpAppRendererOptions,\n  b: McpAppRendererOptions,\n): boolean => {\n  const aKeys = Object.keys(a).filter((key) => key !== \"host\");\n  const bKeys = Object.keys(b).filter((key) => key !== \"host\");\n  if (aKeys.length !== bKeys.length) return false;\n  const aValues = a as Record<string, unknown>;\n  const bValues = b as Record<string, unknown>;\n  return aKeys.every(\n    (key) =>\n      Object.hasOwn(bValues, key) && Object.is(aValues[key], bValues[key]),\n  );\n};\n\nfunction getInput(part: {\n  status: { type: string };\n  argsText: string;\n  args: unknown;\n}): unknown {\n  if (\n    part.status.type === \"running\" &&\n    (part.argsText === \"\" || part.argsText === \"{}\")\n  ) {\n    return undefined;\n  }\n  return part.args;\n}\n\nconst defaultOpenLink = ({ url }: { url: string }) => {\n  window.open(url, \"_blank\", \"noopener,noreferrer\");\n};\n\nfunction extractSendMessageTexts(params: unknown): string[] | undefined {\n  if (typeof params === \"string\") return [params];\n  if (!params || typeof params !== \"object\") return undefined;\n  const obj = params as Record<string, unknown>;\n  if (typeof obj[\"prompt\"] === \"string\") return [obj[\"prompt\"]];\n  if (typeof obj[\"text\"] === \"string\") return [obj[\"text\"]];\n  if (typeof obj[\"message\"] === \"string\") return [obj[\"message\"]];\n  const content = obj[\"content\"];\n  if (Array.isArray(content)) {\n    return Object.keys(content)\n      .filter((key) => {\n        const index = Number(key);\n        return (\n          Number.isInteger(index) &&\n          index >= 0 &&\n          index < content.length &&\n          String(index) === key\n        );\n      })\n      .map((key) => content[Number(key)])\n      .filter(\n        (block): block is { type: \"text\"; text: string } =>\n          isRecord(block) &&\n          block[\"type\"] === \"text\" &&\n          typeof block[\"text\"] === \"string\",\n      )\n      .map((block) => block.text);\n  }\n  return undefined;\n}\n\nfunction extractSendMessageContent(\n  params: unknown,\n): { content: TextMessagePart[] } | { reason: string } {\n  const texts = extractSendMessageTexts(params);\n  if (!texts) return { reason: \"unrecognised params shape\" };\n  const content = texts\n    .filter((text) => text !== \"\")\n    .map((text): TextMessagePart => ({ type: \"text\", text }));\n  if (content.length === 0) {\n    return { reason: \"no text content to append\" };\n  }\n  return { content };\n}\n\nfunction resolvePartOptions(\n  options: McpAppRendererOptions,\n  part: ToolCallMessagePartProps,\n): McpAppRendererOptions {\n  const overrides = options.forPart?.(part);\n  if (!overrides) return options;\n  const handlers =\n    options.handlers && overrides.handlers\n      ? { ...options.handlers, ...overrides.handlers }\n      : (overrides.handlers ?? options.handlers);\n  return {\n    ...options,\n    ...overrides,\n    ...(handlers === undefined ? {} : { handlers }),\n  };\n}\n\nconst InlineRenderer = defineComponent(\n  (props: {\n    part: ToolCallMessagePartProps;\n    useRendererStore: UseRendererStore;\n  }) => {\n    const aui = useAui();\n    const store = props.useRendererStore;\n    const snapshot = shallowRef(store.getState());\n    useIsomorphicLayoutEffect(() => {\n      let active = true;\n      const refresh = () => {\n        if (active) snapshot.value = store.getState();\n      };\n      const release = store.subscribe(refresh);\n      refresh();\n      return () => {\n        active = false;\n        release();\n      };\n    }, []);\n    const host = computed(() => snapshot.value.host);\n    const opts = computed(() =>\n      resolvePartOptions(snapshot.value.options, props.part),\n    );\n    const app = computed(() => getMcpAppFromToolPart(props.part));\n    // Cache only after the owning Vue branch commits. An abandoned Suspense\n    // branch must never replace the metadata used by the visible frame.\n    let cachedApp: McpAppMetadata | undefined;\n    useIsomorphicLayoutEffect(\n      () => {\n        if (app.value != null) cachedApp = app.value;\n      },\n      () => [app.value],\n    );\n    const appForRender = computed(() => app.value ?? cachedApp);\n    const loadedResource = shallowRef<LoadedResourceState>();\n    const resourceUri = computed(() => appForRender.value?.resourceUri);\n    const serverId = computed(() => appForRender.value?.serverId);\n    useIsomorphicLayoutEffect(\n      () => {\n        if (resourceUri.value == null) return;\n        let cancelled = false;\n        const targetHost = host.value;\n        const targetUri = resourceUri.value;\n        const targetServerId = serverId.value;\n        const loadResource = async () => {\n          // Tap publishes the committed host during its effect flush. Newly\n          // mounted parts wait for that publication before starting their load.\n          await Promise.resolve();\n          if (cancelled || store.getState().host !== targetHost) return;\n          try {\n            const resource = await targetHost.loadResource({\n              uri: targetUri,\n              ...(targetServerId ? { serverId: targetServerId } : {}),\n            });\n            if (!cancelled)\n              loadedResource.value = {\n                host: targetHost,\n                resourceUri: targetUri,\n                ...(targetServerId !== undefined\n                  ? { serverId: targetServerId }\n                  : {}),\n                resource,\n              };\n          } catch (error: unknown) {\n            if (!cancelled)\n              loadedResource.value = {\n                host: targetHost,\n                resourceUri: targetUri,\n                ...(targetServerId !== undefined\n                  ? { serverId: targetServerId }\n                  : {}),\n                error:\n                  error instanceof Error ? error : new Error(String(error)),\n              };\n          }\n        };\n        void loadResource();\n        return () => {\n          cancelled = true;\n        };\n      },\n      () => [host.value, resourceUri.value, serverId.value],\n    );\n\n    const bridgeHandlers = computed<McpAppBridgeHandlers>(() => {\n      const callerHandlers = opts.value.handlers;\n      const committedServerId = serverId.value;\n      return {\n        ...callerHandlers,\n        openLink: callerHandlers?.openLink ?? defaultOpenLink,\n        sendMessage:\n          callerHandlers?.sendMessage ??\n          ((params) => {\n            const result = extractSendMessageContent(params);\n            if (\"reason\" in result)\n              return { isError: true, ok: false, reason: result.reason };\n            const composer = aui.thread.composer();\n            composer.setText(\n              [\n                composer.getState().text,\n                result.content.map((part) => part.text).join(\"\\n\"),\n              ]\n                .filter((part) => part.trim())\n                .join(\" \"),\n            );\n            return { ok: true };\n          }),\n        callTool: (params) =>\n          store.getState().host.callTool({\n            ...params,\n            ...(committedServerId ? { serverId: committedServerId } : {}),\n          }),\n        readResource: (params) =>\n          store.getState().host.readResource({\n            ...params,\n            ...(committedServerId ? { serverId: committedServerId } : {}),\n          }),\n        listResources: (params) =>\n          committedServerId\n            ? store.getState().host.listResources({\n                ...(isRecord(params) ? params : {}),\n                serverId: committedServerId,\n              })\n            : store.getState().host.listResources(params),\n      };\n    });\n    return () => {\n      const options = opts.value;\n      const metadata = appForRender.value;\n      const loaded = loadedResource.value;\n      const current =\n        loaded?.host === host.value &&\n        loaded?.resourceUri === metadata?.resourceUri &&\n        loaded?.serverId === metadata?.serverId\n          ? loaded\n          : undefined;\n      const fallback = options.fallback ?? null;\n      if (metadata == null) return fallback;\n      if (current?.error != null) {\n        const errorFallback = options.errorFallback;\n        return errorFallback === undefined\n          ? fallback\n          : typeof errorFallback === \"function\"\n            ? errorFallback(current.error)\n            : errorFallback;\n      }\n      if (current?.resource == null) return options.loadingFallback ?? fallback;\n      return h(McpAppFrame, {\n        app: metadata,\n        resource: current.resource,\n        input: getInput(props.part),\n        output: props.part.result,\n        ...(options.sandbox === undefined ? {} : { sandbox: options.sandbox }),\n        handlers: bridgeHandlers.value,\n        ...(options.hostInfo === undefined\n          ? {}\n          : { hostInfo: options.hostInfo }),\n        ...(options.hostContext === undefined\n          ? {}\n          : { hostContext: options.hostContext }),\n        ...(options.maxHeight === undefined\n          ? {}\n          : { maxHeight: options.maxHeight }),\n      });\n    };\n  },\n  { name: \"McpAppInlineRenderer\", props: [\"part\", \"useRendererStore\"] },\n);\n\n/**\n * Creates a tool-call renderer for MCP Apps embedded in assistant messages.\n *\n * Compose this into the `Tools` resource through its `mcpApp` option. When a\n * tool-call part carries `mcp.app` metadata for a `ui://` resource, the\n * renderer loads that resource from the configured host and displays it in a\n * sandboxed frame.\n */\nconst useMcpAppRenderer = (\n  options: McpAppRendererOptions,\n): { readonly render: ToolCallMessagePartComponent } => {\n  const host = useResource(options.host);\n\n  // The rendered component identity has to stay stable, or every part remounts\n  // its frame; options reach the parts through the store instead of props.\n  const [useRendererStore] = useState(() =>\n    createStore<RendererState>(() => ({ host, options })),\n  );\n  useEffect(() => {\n    useRendererStore.setState((prev) =>\n      prev.host === host && isSameOptions(prev.options, options)\n        ? prev\n        : { host, options },\n    );\n  }, [host, options, useRendererStore]);\n\n  const render = useMemo((): ToolCallMessagePartComponent => {\n    function McpAppRenderer(props: ToolCallMessagePartProps) {\n      // Native functional components retain their attrs object across updates.\n      // Publish a fresh part snapshot so the stateful child's computed inputs\n      // observe field changes, including removal of the app metadata.\n      return h(InlineRenderer, { part: { ...props }, useRendererStore });\n    }\n    const Render = McpAppRenderer;\n    return Render;\n  }, [useRendererStore]);\n\n  return { render };\n};\n\nexport const McpAppRenderer = resource(useMcpAppRenderer);\n"],"mappings":"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"}

package/dist/mcp-apps/McpAppsRemoteHost.d.ts

@@ -0,0 +1,3 @@
+import type { McpAppsHost, McpAppsRemoteHostOptions } from "./types.js";
+export declare const McpAppsRemoteHost: import("@ulearning/ai-tap").Resource<McpAppsHost, [options: McpAppsRemoteHostOptions]>;
+//# sourceMappingURL=McpAppsRemoteHost.d.ts.map

package/dist/mcp-apps/McpAppsRemoteHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpAppsRemoteHost.d.ts","mappings":"AACA,OAAO,KAAK,EAEV,WAAW,EACX,wBAAwB,EACzB,MAAM,YAAS;AA0JhB,eAAO,MAAM,iBAAiB,wFAAiC","names":[],"ignoreList":[],"sources":["../../src/mcp-apps/McpAppsRemoteHost.ts"],"sourcesContent":[null]}

package/dist/mcp-apps/McpAppsRemoteHost.js

@@ -0,0 +1,101 @@
+import { resource, useEffect, useMemo, useRef } from "@ulearning/ai-tap";
+// src/mcp-apps/McpAppsRemoteHost.ts
+const truncateBody = (body) => body.length > 500 ? `${body.slice(0, 500)}...` : body;
+const extractErrorBody = (body) => {
+	const trimmed = body.trim();
+	if (!trimmed) return void 0;
+	try {
+		const parsed = JSON.parse(trimmed);
+		if (parsed && typeof parsed === "object") {
+			const record = parsed;
+			if (typeof record.message === "string") return record.message;
+			if (typeof record.error === "string") return record.error;
+			if (record.error && typeof record.error === "object") {
+				const error = record.error;
+				if (typeof error.message === "string") return error.message;
+			}
+		}
+	} catch {
+		return truncateBody(trimmed);
+	}
+	return truncateBody(trimmed);
+};
+const readErrorBody = async (res) => {
+	try {
+		return extractErrorBody(await res.text());
+	} catch {
+		return;
+	}
+};
+const invalidMcpAppResource = (options) => {
+	throw new Error(`Invalid MCP App host response "mcp-apps/read-resource" from "${options.url}": expected a resource with non-empty string "uri" and "html" fields`);
+};
+const parseMcpAppResource = (value, options) => {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return invalidMcpAppResource(options);
+	const resource = value;
+	if (typeof resource.uri !== "string" || resource.uri.trim() === "" || typeof resource.html !== "string" || resource.html.trim() === "") return invalidMcpAppResource(options);
+	return value;
+};
+async function postToHost(options, method, params) {
+	const doFetch = options.fetch ?? fetch;
+	const extraHeaders = typeof options.headers === "function" ? await options.headers() : options.headers ?? {};
+	const res = await doFetch(options.url, {
+		method: "POST",
+		headers: {
+			"content-type": "application/json",
+			...extraHeaders
+		},
+		body: JSON.stringify({
+			method,
+			params
+		})
+	});
+	if (!res.ok) {
+		const status = res.statusText ? `${res.status} ${res.statusText}` : `${res.status}`;
+		const body = await readErrorBody(res);
+		throw new Error(`MCP App host request "${method}" to "${options.url}" failed with ${status}${body ? `: ${body}` : ""}`);
+	}
+	try {
+		return await res.json();
+	} catch (cause) {
+		throw new Error(`Invalid MCP App host response "${method}" from "${options.url}": expected valid JSON`, { cause });
+	}
+}
+/**
+* Creates the default HTTP host for MCP App widgets.
+*
+* The host POSTs widget requests to the configured route as `{ method,
+* params }`, using the method names expected by the assistant-ui MCP Apps
+* guide.
+*/
+const useMcpAppsRemoteHost = (options) => {
+	const optionsRef = useRef(options);
+	useEffect(() => {
+		optionsRef.current = options;
+	});
+	const url = options.url;
+	const hostState = useMemo(() => {
+		let pendingOptions = options;
+		const getCurrentOptions = () => optionsRef.current.url === url ? optionsRef.current : pendingOptions;
+		return {
+			host: {
+				loadResource: async (params) => {
+					const options = getCurrentOptions();
+					return parseMcpAppResource(await postToHost(options, "mcp-apps/read-resource", params), options);
+				},
+				callTool: (params) => postToHost(getCurrentOptions(), "tools/call", params),
+				readResource: (params) => postToHost(getCurrentOptions(), "resources/read", params),
+				listResources: (params) => postToHost(getCurrentOptions(), "resources/list", params)
+			},
+			updatePendingOptions: (next) => {
+				pendingOptions = next;
+			}
+		};
+	}, [url]);
+	if (optionsRef.current.url !== url) hostState.updatePendingOptions(options);
+	return hostState.host;
+};
+const McpAppsRemoteHost = resource(useMcpAppsRemoteHost);
+export { McpAppsRemoteHost };
+
+//# sourceMappingURL=McpAppsRemoteHost.js.map

package/dist/mcp-apps/McpAppsRemoteHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpAppsRemoteHost.js","names":[],"sources":["../../src/mcp-apps/McpAppsRemoteHost.ts"],"sourcesContent":["import { resource, useEffect, useMemo, useRef } from \"@ulearning/ai-tap\";\nimport type {\n  McpAppResource,\n  McpAppsHost,\n  McpAppsRemoteHostOptions,\n} from \"./types\";\n\nconst truncateBody = (body: string) =>\n  body.length > 500 ? `${body.slice(0, 500)}...` : body;\n\nconst extractErrorBody = (body: string): string | undefined => {\n  const trimmed = body.trim();\n  if (!trimmed) return undefined;\n\n  try {\n    const parsed = JSON.parse(trimmed) as unknown;\n    if (parsed && typeof parsed === \"object\") {\n      const record = parsed as Record<string, unknown>;\n      if (typeof record.message === \"string\") return record.message;\n      if (typeof record.error === \"string\") return record.error;\n      if (record.error && typeof record.error === \"object\") {\n        const error = record.error as Record<string, unknown>;\n        if (typeof error.message === \"string\") return error.message;\n      }\n    }\n  } catch {\n    return truncateBody(trimmed);\n  }\n\n  return truncateBody(trimmed);\n};\n\nconst readErrorBody = async (res: Response): Promise<string | undefined> => {\n  try {\n    return extractErrorBody(await res.text());\n  } catch {\n    return undefined;\n  }\n};\n\nconst invalidMcpAppResource = (options: McpAppsRemoteHostOptions): never => {\n  throw new Error(\n    `Invalid MCP App host response \"mcp-apps/read-resource\" from \"${options.url}\": expected a resource with non-empty string \"uri\" and \"html\" fields`,\n  );\n};\n\nconst parseMcpAppResource = (\n  value: unknown,\n  options: McpAppsRemoteHostOptions,\n): McpAppResource => {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    return invalidMcpAppResource(options);\n  }\n\n  const resource = value as Record<string, unknown>;\n  if (\n    typeof resource.uri !== \"string\" ||\n    resource.uri.trim() === \"\" ||\n    typeof resource.html !== \"string\" ||\n    resource.html.trim() === \"\"\n  ) {\n    return invalidMcpAppResource(options);\n  }\n\n  return value as McpAppResource;\n};\n\nasync function postToHost(\n  options: McpAppsRemoteHostOptions,\n  method: string,\n  params: unknown,\n): Promise<unknown> {\n  const doFetch = options.fetch ?? fetch;\n  const extraHeaders =\n    typeof options.headers === \"function\"\n      ? await options.headers()\n      : (options.headers ?? {});\n  const res = await doFetch(options.url, {\n    method: \"POST\",\n    headers: { \"content-type\": \"application/json\", ...extraHeaders },\n    body: JSON.stringify({ method, params }),\n  });\n  if (!res.ok) {\n    const status = res.statusText\n      ? `${res.status} ${res.statusText}`\n      : `${res.status}`;\n    const body = await readErrorBody(res);\n    throw new Error(\n      `MCP App host request \"${method}\" to \"${options.url}\" failed with ${status}${body ? `: ${body}` : \"\"}`,\n    );\n  }\n  try {\n    return await res.json();\n  } catch (cause) {\n    throw new Error(\n      `Invalid MCP App host response \"${method}\" from \"${options.url}\": expected valid JSON`,\n      { cause },\n    );\n  }\n}\n\n/**\n * Creates the default HTTP host for MCP App widgets.\n *\n * The host POSTs widget requests to the configured route as `{ method,\n * params }`, using the method names expected by the assistant-ui MCP Apps\n * guide.\n */\nconst useMcpAppsRemoteHost = (\n  options: McpAppsRemoteHostOptions,\n): McpAppsHost => {\n  const optionsRef = useRef(options);\n  useEffect(() => {\n    optionsRef.current = options;\n  });\n\n  const url = options.url;\n\n  const hostState = useMemo(() => {\n    let pendingOptions = options;\n    const getCurrentOptions = () =>\n      optionsRef.current.url === url ? optionsRef.current : pendingOptions;\n    const host: McpAppsHost = {\n      loadResource: async (params) => {\n        const options = getCurrentOptions();\n        return parseMcpAppResource(\n          await postToHost(options, \"mcp-apps/read-resource\", params),\n          options,\n        );\n      },\n      callTool: (params) =>\n        postToHost(getCurrentOptions(), \"tools/call\", params),\n      readResource: (params) =>\n        postToHost(getCurrentOptions(), \"resources/read\", params),\n      listResources: (params) =>\n        postToHost(getCurrentOptions(), \"resources/list\", params),\n    };\n    return {\n      host,\n      updatePendingOptions: (next: McpAppsRemoteHostOptions) => {\n        pendingOptions = next;\n      },\n    };\n    // oxlint-disable-next-line react/exhaustive-deps -- URL changes replace the host identity; pending and same-URL options are refreshed outside the memo\n  }, [url]);\n\n  // The pending snapshot is read only while the committed ref still lags this\n  // host's URL, and every write to it carries that same render's options, so\n  // no render can pair one URL with another's credentials. A committed host can\n  // be written here (a child layout effect re-rendering synchronously runs\n  // before passive effects publish the ref), which stays coherent for the same\n  // reason.\n  if (optionsRef.current.url !== url) {\n    hostState.updatePendingOptions(options);\n  }\n\n  return hostState.host;\n};\n\nexport const McpAppsRemoteHost = resource(useMcpAppsRemoteHost);\n"],"mappings":"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"}

package/dist/mcp-apps/app-frame.d.ts

@@ -0,0 +1,3 @@
+import type { McpAppFrameProps } from "./types.js";
+export declare const McpAppFrame: import("vue").DefineSetupFnComponent<McpAppFrameProps, {}, {}, McpAppFrameProps & {}, import("vue").PublicProps>;
+//# sourceMappingURL=app-frame.d.ts.map

package/dist/mcp-apps/app-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-frame.d.ts","mappings":"AAWA,OAAO,KAAK,EAEV,gBAAgB,EAEjB,MAAM,YAAS;AA+IhB,eAAO,MAAM,WAAW,kHAgMvB","names":[],"ignoreList":[],"sources":["../../src/mcp-apps/app-frame.tsx"],"sourcesContent":[null]}