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

package/dist/mcp-apps/csp.js

@@ -0,0 +1,92 @@
+// src/mcp-apps/csp.ts
+const isAllowedOrigin = (value, allowWebSocket) => {
+	if (!(allowWebSocket ? /^(?:https?|wss?):\/\//i : /^https?:\/\//i).test(value) || /[\s;'"`,]/.test(value)) return false;
+	try {
+		const url = new URL(value.replace("://*.", "://wildcard."));
+		return url.username === "" && url.password === "" && url.pathname === "/" && url.search === "" && url.hash === "";
+	} catch {
+		return false;
+	}
+};
+const getAllowedOrigins = (values, allowWebSocket = false) => Array.isArray(values) ? [...new Set(values.filter((value) => typeof value === "string" && isAllowedOrigin(value, allowWebSocket)))] : [];
+const directive = (name, values) => `${name} ${values.join(" ")}`;
+const buildMcpAppCsp = (csp) => {
+	const connectDomains = getAllowedOrigins(csp?.connectDomains, true);
+	const resourceDomains = getAllowedOrigins(csp?.resourceDomains);
+	const frameDomains = getAllowedOrigins(csp?.frameDomains);
+	const baseUriDomains = getAllowedOrigins(csp?.baseUriDomains);
+	return [
+		"default-src 'none'",
+		directive("script-src", [
+			"'self'",
+			"'unsafe-inline'",
+			...resourceDomains
+		]),
+		directive("style-src", [
+			"'self'",
+			"'unsafe-inline'",
+			...resourceDomains
+		]),
+		directive("connect-src", connectDomains.length > 0 ? ["'self'", ...connectDomains] : ["'none'"]),
+		directive("img-src", [
+			"'self'",
+			"data:",
+			...resourceDomains
+		]),
+		directive("font-src", ["'self'", ...resourceDomains]),
+		directive("media-src", [
+			"'self'",
+			"data:",
+			...resourceDomains
+		]),
+		directive("frame-src", frameDomains.length > 0 ? frameDomains : ["'none'"]),
+		directive("base-uri", baseUriDomains.length > 0 ? baseUriDomains : ["'self'"]),
+		"object-src 'none'",
+		"form-action 'none'"
+	].join("; ");
+};
+const findDoctypeEnd = (html) => {
+	let offset = 0;
+	while (offset < html.length) {
+		const whitespace = html.slice(offset).match(/^[\t\n\f\r ]+/)?.[0];
+		if (whitespace) {
+			offset += whitespace.length;
+			continue;
+		}
+		if (html.startsWith("<!--", offset)) {
+			if (html.startsWith("<!-->", offset)) {
+				offset += 5;
+				continue;
+			}
+			if (html.startsWith("<!--->", offset)) {
+				offset += 6;
+				continue;
+			}
+			const commentEnd = html.indexOf("-->", offset + 4);
+			const bangCommentEnd = html.indexOf("--!>", offset + 4);
+			if (commentEnd === -1 && bangCommentEnd === -1) return 0;
+			offset = bangCommentEnd !== -1 && (commentEnd === -1 || bangCommentEnd < commentEnd) ? bangCommentEnd + 4 : commentEnd + 3;
+			continue;
+		}
+		if (html.slice(offset, offset + 9).toLowerCase() === "<!doctype") break;
+		if (html.startsWith("<?", offset) || html.startsWith("<!", offset)) {
+			const bogusCommentEnd = html.indexOf(">", offset + 2);
+			if (bogusCommentEnd === -1) return 0;
+			offset = bogusCommentEnd + 1;
+			continue;
+		}
+		break;
+	}
+	if (html.slice(offset, offset + 9).toLowerCase() !== "<!doctype") return offset;
+	const end = html.indexOf(">", offset + 9);
+	return end === -1 ? 0 : end + 1;
+};
+const applyMcpAppCsp = (html, csp) => {
+	const normalizedHtml = html.charCodeAt(0) === 65279 ? html.slice(1) : html;
+	const meta = `<meta http-equiv="Content-Security-Policy" content="${buildMcpAppCsp(csp)}">`;
+	const insertionPoint = findDoctypeEnd(normalizedHtml);
+	return `${normalizedHtml.slice(0, insertionPoint)}${meta}${normalizedHtml.slice(insertionPoint)}`;
+};
+export { applyMcpAppCsp, buildMcpAppCsp };
+
+//# sourceMappingURL=csp.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"csp.js","names":[],"sources":["../../src/mcp-apps/csp.ts"],"sourcesContent":["import type { McpAppResourceCSP } from \"./types\";\n\nconst isAllowedOrigin = (value: string, allowWebSocket: boolean): boolean => {\n  const scheme = allowWebSocket ? /^(?:https?|wss?):\\/\\//i : /^https?:\\/\\//i;\n  if (!scheme.test(value) || /[\\s;'\"`,]/.test(value)) {\n    return false;\n  }\n\n  try {\n    const url = new URL(value.replace(\"://*.\", \"://wildcard.\"));\n    return (\n      url.username === \"\" &&\n      url.password === \"\" &&\n      url.pathname === \"/\" &&\n      url.search === \"\" &&\n      url.hash === \"\"\n    );\n  } catch {\n    return false;\n  }\n};\n\nconst getAllowedOrigins = (\n  values: unknown,\n  allowWebSocket = false,\n): string[] =>\n  Array.isArray(values)\n    ? [\n        ...new Set(\n          values.filter(\n            (value): value is string =>\n              typeof value === \"string\" &&\n              isAllowedOrigin(value, allowWebSocket),\n          ),\n        ),\n      ]\n    : [];\n\nconst directive = (name: string, values: readonly string[]) =>\n  `${name} ${values.join(\" \")}`;\n\nexport const buildMcpAppCsp = (csp?: McpAppResourceCSP): string => {\n  const connectDomains = getAllowedOrigins(csp?.connectDomains, true);\n  const resourceDomains = getAllowedOrigins(csp?.resourceDomains);\n  const frameDomains = getAllowedOrigins(csp?.frameDomains);\n  const baseUriDomains = getAllowedOrigins(csp?.baseUriDomains);\n\n  return [\n    \"default-src 'none'\",\n    directive(\"script-src\", [\"'self'\", \"'unsafe-inline'\", ...resourceDomains]),\n    directive(\"style-src\", [\"'self'\", \"'unsafe-inline'\", ...resourceDomains]),\n    directive(\n      \"connect-src\",\n      connectDomains.length > 0 ? [\"'self'\", ...connectDomains] : [\"'none'\"],\n    ),\n    directive(\"img-src\", [\"'self'\", \"data:\", ...resourceDomains]),\n    directive(\"font-src\", [\"'self'\", ...resourceDomains]),\n    directive(\"media-src\", [\"'self'\", \"data:\", ...resourceDomains]),\n    directive(\"frame-src\", frameDomains.length > 0 ? frameDomains : [\"'none'\"]),\n    directive(\n      \"base-uri\",\n      baseUriDomains.length > 0 ? baseUriDomains : [\"'self'\"],\n    ),\n    \"object-src 'none'\",\n    \"form-action 'none'\",\n  ].join(\"; \");\n};\n\nconst findDoctypeEnd = (html: string): number => {\n  let offset = 0;\n\n  while (offset < html.length) {\n    const whitespace = html.slice(offset).match(/^[\\t\\n\\f\\r ]+/)?.[0];\n    if (whitespace) {\n      offset += whitespace.length;\n      continue;\n    }\n    if (html.startsWith(\"<!--\", offset)) {\n      if (html.startsWith(\"<!-->\", offset)) {\n        offset += 5;\n        continue;\n      }\n      if (html.startsWith(\"<!--->\", offset)) {\n        offset += 6;\n        continue;\n      }\n      const commentEnd = html.indexOf(\"-->\", offset + 4);\n      const bangCommentEnd = html.indexOf(\"--!>\", offset + 4);\n      if (commentEnd === -1 && bangCommentEnd === -1) return 0;\n      offset =\n        bangCommentEnd !== -1 &&\n        (commentEnd === -1 || bangCommentEnd < commentEnd)\n          ? bangCommentEnd + 4\n          : commentEnd + 3;\n      continue;\n    }\n    if (html.slice(offset, offset + 9).toLowerCase() === \"<!doctype\") {\n      break;\n    }\n    if (html.startsWith(\"<?\", offset) || html.startsWith(\"<!\", offset)) {\n      const bogusCommentEnd = html.indexOf(\">\", offset + 2);\n      if (bogusCommentEnd === -1) return 0;\n      offset = bogusCommentEnd + 1;\n      continue;\n    }\n    break;\n  }\n\n  if (html.slice(offset, offset + 9).toLowerCase() !== \"<!doctype\") {\n    return offset;\n  }\n  const end = html.indexOf(\">\", offset + 9);\n  return end === -1 ? 0 : end + 1;\n};\n\nexport const applyMcpAppCsp = (\n  html: string,\n  csp?: McpAppResourceCSP,\n): string => {\n  const normalizedHtml = html.charCodeAt(0) === 0xfeff ? html.slice(1) : html;\n  const meta = `<meta http-equiv=\"Content-Security-Policy\" content=\"${buildMcpAppCsp(csp)}\">`;\n  const insertionPoint = findDoctypeEnd(normalizedHtml);\n  return `${normalizedHtml.slice(0, insertionPoint)}${meta}${normalizedHtml.slice(insertionPoint)}`;\n};\n"],"mappings":"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"}

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

@@ -0,0 +1,5 @@
+export { McpAppRenderer, type McpAppPartOptions, type McpAppRendererOptions, } from "./McpAppRenderer.js";
+export { McpAppsRemoteHost } from "./McpAppsRemoteHost.js";
+export { getMcpAppFromToolPart } from "./utils.js";
+export type { McpAppMetadata, McpAppResource, McpAppResourceMeta, McpAppResourceCSP, McpAppSandboxConfig, McpAppHostInfo, McpAppHostContext, McpAppDisplayMode, McpAppsHost, McpAppsRemoteHostOptions, McpAppToolCallParams, McpAppInitializeParams, McpAppBridgeHandlers, ToolCallMessagePartMcpMetadata, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","mappings":"AAAA,OAAO,EACL,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,GAC3B,MAAM,qBAAkB;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAqB;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAS;AAC/C,YAAY,EACV,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,8BAA8B,GAC/B,MAAM,YAAS","names":[],"ignoreList":[],"sources":["../../src/mcp-apps/index.ts"],"sourcesContent":[null]}

package/dist/mcp-apps/index.js

@@ -0,0 +1,4 @@
+import { getMcpAppFromToolPart } from "./utils.js";
+import { McpAppRenderer } from "./McpAppRenderer.js";
+import { McpAppsRemoteHost } from "./McpAppsRemoteHost.js";
+export { McpAppRenderer, McpAppsRemoteHost, getMcpAppFromToolPart };

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

@@ -0,0 +1,161 @@
+import type { McpAppMetadata, ToolCallMessagePartMcpMetadata } from "@ulearning/ai-core";
+import type { SandboxHostConfig } from "../sandbox-host/SandboxHost.js";
+export type { McpAppMetadata, ToolCallMessagePartMcpMetadata };
+export declare const MCP_APP_MIME_TYPE: "text/html;profile=mcp-app";
+export declare const MCP_APP_PROTOCOL_VERSION: "0.1";
+export type McpAppResourceCSP = {
+    connectDomains?: string[];
+    resourceDomains?: string[];
+    frameDomains?: string[];
+    baseUriDomains?: string[];
+    [k: string]: unknown;
+};
+export type McpAppResourceMeta = {
+    prefersBorder?: boolean;
+    csp?: McpAppResourceCSP;
+    permissions?: Record<string, unknown>;
+    [k: string]: unknown;
+};
+export type McpAppResource = {
+    uri: string;
+    mimeType: typeof MCP_APP_MIME_TYPE;
+    html: string;
+    meta?: McpAppResourceMeta;
+};
+export type McpAppDisplayMode = "inline" | "fullscreen" | "pip";
+export type McpAppHostContext = {
+    theme?: "light" | "dark";
+    displayMode?: McpAppDisplayMode;
+    availableDisplayModes?: McpAppDisplayMode[];
+    [k: string]: unknown;
+};
+export type McpAppHostInfo = {
+    name: string;
+    version: string;
+};
+/**
+ * What `McpAppRenderer` needs from its host — the data-plane operations
+ * the widget can request. Provided by a host resource like
+ * `McpAppsRemoteHost`.
+ */
+export type McpAppsHost = {
+    loadResource: (params: {
+        uri: string;
+        serverId?: string;
+    }) => Promise<McpAppResource>;
+    callTool: (params: McpAppToolCallParams & {
+        serverId?: string;
+    }) => Promise<unknown>;
+    readResource: (params: {
+        uri: string;
+        serverId?: string;
+    }) => Promise<unknown>;
+    listResources: (params?: unknown) => Promise<unknown>;
+};
+/**
+ * Options for `McpAppsRemoteHost`. The host POSTs `{ method, params }` to
+ * `url` and expects JSON responses. Params may carry `serverId` for host-side routing. Method names sent:
+ * - `mcp-apps/read-resource` (`{ uri, serverId? }`) → `McpAppResource`
+ * - `tools/call` (`{ name, arguments?, serverId? }`) → tool result
+ * - `resources/read` (`{ uri, serverId? }`) → resource read result
+ * - `resources/list` (`{ serverId?, ...params }?`) → list result
+ */
+export type McpAppsRemoteHostOptions = {
+    url: string;
+    fetch?: typeof fetch;
+    headers?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
+};
+export type McpAppToolCallParams = {
+    name: string;
+    arguments?: Record<string, unknown>;
+};
+/**
+ * The params of the app's `ui/initialize` request, as `onInitialized`
+ * receives them. A field that fails validation is omitted, and
+ * `availableDisplayModes` keeps only the modes the bridge recognizes.
+ */
+export type McpAppInitializeParams = {
+    appInfo?: {
+        name: string;
+        version: string;
+        [k: string]: unknown;
+    };
+    appCapabilities?: {
+        availableDisplayModes?: McpAppDisplayMode[];
+        [k: string]: unknown;
+    };
+    protocolVersion?: string;
+};
+export type McpAppBridgeHandlers = {
+    allowedTools?: readonly string[];
+    callTool?: (params: McpAppToolCallParams) => Promise<unknown> | unknown;
+    readResource?: (params: {
+        uri: string;
+    }) => Promise<unknown> | unknown;
+    listResources?: (params?: unknown) => Promise<unknown> | unknown;
+    openLink?: (params: {
+        url: string;
+    }) => Promise<unknown> | unknown;
+    sendMessage?: (params: unknown) => Promise<unknown> | unknown;
+    updateModelContext?: (params: unknown) => Promise<unknown> | unknown;
+    requestDisplayMode?: (params: {
+        mode: McpAppDisplayMode;
+    }) => Promise<{
+        mode: McpAppDisplayMode;
+    }> | {
+        mode: McpAppDisplayMode;
+    };
+    onSizeChange?: (params: {
+        width?: number;
+        height?: number;
+    }) => void;
+    onInitialized?: (params: McpAppInitializeParams) => void;
+    onRequestTeardown?: (params: unknown) => void;
+    onLog?: (params: unknown) => void;
+    onError?: (error: Error) => void;
+};
+export type McpAppSandboxConfig = SandboxHostConfig;
+export type McpAppFrameProps = {
+    app: McpAppMetadata;
+    resource: McpAppResource;
+    input?: unknown;
+    output?: unknown;
+    sandbox?: McpAppSandboxConfig | undefined;
+    handlers?: McpAppBridgeHandlers | undefined;
+    hostInfo?: McpAppHostInfo | undefined;
+    hostContext?: McpAppHostContext | undefined;
+    /**
+     * Upper bound (in pixels) for the auto-resize height driven by the widget's
+     * `notifications/size_changed`. Defaults to 800.
+     */
+    maxHeight?: number | undefined;
+};
+export type McpAppJsonRpcRequest = {
+    jsonrpc: "2.0";
+    id: string | number;
+    method: string;
+    params?: unknown;
+};
+export type McpAppJsonRpcNotification = {
+    jsonrpc: "2.0";
+    method: string;
+    params?: unknown;
+};
+export type McpAppJsonRpcError = {
+    code: number;
+    message: string;
+    data?: unknown;
+};
+export type McpAppJsonRpcResponse = {
+    jsonrpc: "2.0";
+    id: string | number;
+    result: unknown;
+    error?: never;
+} | {
+    jsonrpc: "2.0";
+    id: string | number;
+    result?: never;
+    error: McpAppJsonRpcError;
+};
+export type McpAppJsonRpcMessage = McpAppJsonRpcRequest | McpAppJsonRpcNotification | McpAppJsonRpcResponse;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","mappings":"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","names":[],"ignoreList":[],"sources":["../../src/mcp-apps/types.ts"],"sourcesContent":[null]}

package/dist/mcp-apps/types.js

@@ -0,0 +1,6 @@
+// src/mcp-apps/types.ts
+const MCP_APP_MIME_TYPE = "text/html;profile=mcp-app";
+const MCP_APP_PROTOCOL_VERSION = "0.1";
+export { MCP_APP_MIME_TYPE, MCP_APP_PROTOCOL_VERSION };
+
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../src/mcp-apps/types.ts"],"sourcesContent":["import type {\n  McpAppMetadata,\n  ToolCallMessagePartMcpMetadata,\n} from \"@ulearning/ai-core\";\nimport type { SandboxHostConfig } from \"../sandbox-host/SandboxHost\";\n\nexport type { McpAppMetadata, ToolCallMessagePartMcpMetadata };\n\nexport const MCP_APP_MIME_TYPE = \"text/html;profile=mcp-app\" as const;\n\nexport const MCP_APP_PROTOCOL_VERSION = \"0.1\" as const;\n\nexport type McpAppResourceCSP = {\n  connectDomains?: string[];\n  resourceDomains?: string[];\n  frameDomains?: string[];\n  baseUriDomains?: string[];\n  [k: string]: unknown;\n};\n\nexport type McpAppResourceMeta = {\n  prefersBorder?: boolean;\n  csp?: McpAppResourceCSP;\n  permissions?: Record<string, unknown>;\n  [k: string]: unknown;\n};\n\nexport type McpAppResource = {\n  uri: string;\n  mimeType: typeof MCP_APP_MIME_TYPE;\n  html: string;\n  meta?: McpAppResourceMeta;\n};\n\nexport type McpAppDisplayMode = \"inline\" | \"fullscreen\" | \"pip\";\n\nexport type McpAppHostContext = {\n  theme?: \"light\" | \"dark\";\n  displayMode?: McpAppDisplayMode;\n  availableDisplayModes?: McpAppDisplayMode[];\n  [k: string]: unknown;\n};\n\nexport type McpAppHostInfo = {\n  name: string;\n  version: string;\n};\n\n/**\n * What `McpAppRenderer` needs from its host — the data-plane operations\n * the widget can request. Provided by a host resource like\n * `McpAppsRemoteHost`.\n */\nexport type McpAppsHost = {\n  loadResource: (params: {\n    uri: string;\n    serverId?: string;\n  }) => Promise<McpAppResource>;\n  callTool: (\n    params: McpAppToolCallParams & { serverId?: string },\n  ) => Promise<unknown>;\n  readResource: (params: {\n    uri: string;\n    serverId?: string;\n  }) => Promise<unknown>;\n  listResources: (params?: unknown) => Promise<unknown>;\n};\n\n/**\n * Options for `McpAppsRemoteHost`. The host POSTs `{ method, params }` to\n * `url` and expects JSON responses. Params may carry `serverId` for host-side routing. Method names sent:\n * - `mcp-apps/read-resource` (`{ uri, serverId? }`) → `McpAppResource`\n * - `tools/call` (`{ name, arguments?, serverId? }`) → tool result\n * - `resources/read` (`{ uri, serverId? }`) → resource read result\n * - `resources/list` (`{ serverId?, ...params }?`) → list result\n */\nexport type McpAppsRemoteHostOptions = {\n  url: string;\n  fetch?: typeof fetch;\n  headers?:\n    | Record<string, string>\n    | (() => Record<string, string> | Promise<Record<string, string>>);\n};\n\nexport type McpAppToolCallParams = {\n  name: string;\n  arguments?: Record<string, unknown>;\n};\n\n/**\n * The params of the app's `ui/initialize` request, as `onInitialized`\n * receives them. A field that fails validation is omitted, and\n * `availableDisplayModes` keeps only the modes the bridge recognizes.\n */\nexport type McpAppInitializeParams = {\n  appInfo?: { name: string; version: string; [k: string]: unknown };\n  appCapabilities?: {\n    availableDisplayModes?: McpAppDisplayMode[];\n    [k: string]: unknown;\n  };\n  protocolVersion?: string;\n};\n\nexport type McpAppBridgeHandlers = {\n  allowedTools?: readonly string[];\n  callTool?: (params: McpAppToolCallParams) => Promise<unknown> | unknown;\n  readResource?: (params: { uri: string }) => Promise<unknown> | unknown;\n  listResources?: (params?: unknown) => Promise<unknown> | unknown;\n  openLink?: (params: { url: string }) => Promise<unknown> | unknown;\n  sendMessage?: (params: unknown) => Promise<unknown> | unknown;\n  updateModelContext?: (params: unknown) => Promise<unknown> | unknown;\n  requestDisplayMode?: (params: {\n    mode: McpAppDisplayMode;\n  }) => Promise<{ mode: McpAppDisplayMode }> | { mode: McpAppDisplayMode };\n  onSizeChange?: (params: { width?: number; height?: number }) => void;\n  onInitialized?: (params: McpAppInitializeParams) => void;\n  onRequestTeardown?: (params: unknown) => void;\n  onLog?: (params: unknown) => void;\n  onError?: (error: Error) => void;\n};\n\nexport type McpAppSandboxConfig = SandboxHostConfig;\n\nexport type McpAppFrameProps = {\n  app: McpAppMetadata;\n  resource: McpAppResource;\n  input?: unknown;\n  output?: unknown;\n  sandbox?: McpAppSandboxConfig | undefined;\n  handlers?: McpAppBridgeHandlers | undefined;\n  hostInfo?: McpAppHostInfo | undefined;\n  hostContext?: McpAppHostContext | undefined;\n  /**\n   * Upper bound (in pixels) for the auto-resize height driven by the widget's\n   * `notifications/size_changed`. Defaults to 800.\n   */\n  maxHeight?: number | undefined;\n};\n\nexport type McpAppJsonRpcRequest = {\n  jsonrpc: \"2.0\";\n  id: string | number;\n  method: string;\n  params?: unknown;\n};\n\nexport type McpAppJsonRpcNotification = {\n  jsonrpc: \"2.0\";\n  method: string;\n  params?: unknown;\n};\n\nexport type McpAppJsonRpcError = {\n  code: number;\n  message: string;\n  data?: unknown;\n};\n\nexport type McpAppJsonRpcResponse =\n  | {\n      jsonrpc: \"2.0\";\n      id: string | number;\n      result: unknown;\n      error?: never;\n    }\n  | {\n      jsonrpc: \"2.0\";\n      id: string | number;\n      result?: never;\n      error: McpAppJsonRpcError;\n    };\n\nexport type McpAppJsonRpcMessage =\n  | McpAppJsonRpcRequest\n  | McpAppJsonRpcNotification\n  | McpAppJsonRpcResponse;\n"],"mappings":";AAQA,MAAa,oBAAoB;AAEjC,MAAa,2BAA2B"}

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

@@ -0,0 +1,12 @@
+import { type McpAppMetadata, type ToolCallMessagePart } from "@ulearning/ai-core";
+type ToolPartLike = Pick<ToolCallMessagePart, "mcp">;
+/**
+ * Returns MCP app metadata for a tool-call part that points at a `ui://`
+ * resource.
+ *
+ * Returns `undefined` when the part has no MCP app metadata or the metadata
+ * does not reference an assistant-ui MCP app resource.
+ */
+export declare function getMcpAppFromToolPart(part: ToolPartLike): McpAppMetadata | undefined;
+export {};
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACzB,MAAM,oBAAoB;AAE3B,KAAK,YAAY,GAAG,IAAI,CAAC,mBAAmB,EAAE,KAAK,CAAC;AAEpD;;;;;;;AAOA,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,YAAY,GACjB,cAAc,GAAG,SAAS","names":[],"ignoreList":[],"sources":["../../src/mcp-apps/utils.ts"],"sourcesContent":[null]}

package/dist/mcp-apps/utils.js

@@ -0,0 +1,18 @@
+import { isMcpAppUri } from "@ulearning/ai-core";
+// src/mcp-apps/utils.ts
+/**
+* Returns MCP app metadata for a tool-call part that points at a `ui://`
+* resource.
+*
+* Returns `undefined` when the part has no MCP app metadata or the metadata
+* does not reference an assistant-ui MCP app resource.
+*/
+function getMcpAppFromToolPart(part) {
+	const app = part.mcp?.app;
+	if (!app) return void 0;
+	if (!isMcpAppUri(app.resourceUri)) return void 0;
+	return app;
+}
+export { getMcpAppFromToolPart };
+
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":[],"sources":["../../src/mcp-apps/utils.ts"],"sourcesContent":["import {\n  isMcpAppUri,\n  type McpAppMetadata,\n  type ToolCallMessagePart,\n} from \"@ulearning/ai-core\";\n\ntype ToolPartLike = Pick<ToolCallMessagePart, \"mcp\">;\n\n/**\n * Returns MCP app metadata for a tool-call part that points at a `ui://`\n * resource.\n *\n * Returns `undefined` when the part has no MCP app metadata or the metadata\n * does not reference an assistant-ui MCP app resource.\n */\nexport function getMcpAppFromToolPart(\n  part: ToolPartLike,\n): McpAppMetadata | undefined {\n  const app = part.mcp?.app;\n  if (!app) return undefined;\n  if (!isMcpAppUri(app.resourceUri)) return undefined;\n  return app;\n}\n"],"mappings":";;;;;;;;;AAeA,SAAgB,sBACd,MAC4B;CAC5B,MAAM,MAAM,KAAK,KAAK;CACtB,IAAI,CAAC,KAAK,OAAO,KAAA;CACjB,IAAI,CAAC,YAAY,IAAI,WAAW,GAAG,OAAO,KAAA;CAC1C,OAAO;AACT"}

package/dist/model-context/frame/useAssistantFrameHost.d.ts

@@ -0,0 +1,35 @@
+import type { Unsubscribe } from "@ulearning/ai-core";
+import { type MaybeRefOrGetter, type Ref } from "vue";
+import { AssistantFrameHost } from "@ulearning/ai-core";
+type UseAssistantFrameHostOptions = {
+    iframeRef: Readonly<Ref<HTMLIFrameElement | null | undefined>>;
+    targetOrigin?: string;
+    register: (frameHost: AssistantFrameHost) => Unsubscribe;
+};
+/**
+ * Vue composable that manages the lifecycle of an AssistantFrameHost and its binding to the current AssistantRuntime.
+ *
+ * Usage example:
+ * ```tsx
+ * function setupFrame({
+ *   trustedOrigin,
+ *   register,
+ * }: {
+ *   trustedOrigin: string;
+ *   register: Parameters<typeof useAssistantFrameHost>[0]["register"];
+ * }) {
+ *   const iframeRef = shallowRef<HTMLIFrameElement | null>(null);
+ *
+ *   useAssistantFrameHost({
+ *     iframeRef,
+ *     targetOrigin: trustedOrigin,
+ *     register,
+ *   });
+ *
+ *   return () => <iframe ref={iframeRef} src="..." />;
+ * }
+ * ```
+ */
+export declare const useAssistantFrameHost: (options: MaybeRefOrGetter<UseAssistantFrameHostOptions>) => void;
+export {};
+//# sourceMappingURL=useAssistantFrameHost.d.ts.map

package/dist/model-context/frame/useAssistantFrameHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAssistantFrameHost.d.ts","mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB;AACrD,OAAO,EAAkB,KAAK,gBAAgB,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK;AAErE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB;AAEvD,KAAK,4BAA4B,GAAG;IAClC,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,iBAAiB,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAC9D,YAAY,CAAC,EAAE,MAAM;IACrB,QAAQ,EAAE,CAAC,SAAS,EAAE,kBAAkB,KAAK,WAAW;CACzD;AAED;;;;;;;;;;;;;;;;;;;;;;;;AAwBA,eAAO,MAAM,qBAAqB,GAChC,SAAS,gBAAgB,CAAC,4BAA4B,CAAC,KACtD,IAiGF","names":[],"ignoreList":[],"sources":["../../../src/model-context/frame/useAssistantFrameHost.ts"],"sourcesContent":[null]}

package/dist/model-context/frame/useAssistantFrameHost.js

@@ -0,0 +1,109 @@
+"use client";
+import { AssistantFrameHost } from "@ulearning/ai-core";
+import { toValue, watch } from "vue";
+import { useIsomorphicLayoutEffect } from "@ulearning/ai-store/internal";
+// src/model-context/frame/useAssistantFrameHost.ts
+/**
+* Vue composable that manages the lifecycle of an AssistantFrameHost and its binding to the current AssistantRuntime.
+*
+* Usage example:
+* ```tsx
+* function setupFrame({
+*   trustedOrigin,
+*   register,
+* }: {
+*   trustedOrigin: string;
+*   register: Parameters<typeof useAssistantFrameHost>[0]["register"];
+* }) {
+*   const iframeRef = shallowRef<HTMLIFrameElement | null>(null);
+*
+*   useAssistantFrameHost({
+*     iframeRef,
+*     targetOrigin: trustedOrigin,
+*     register,
+*   });
+*
+*   return () => <iframe ref={iframeRef} src="..." />;
+* }
+* ```
+*/
+const useAssistantFrameHost = (options) => {
+	useIsomorphicLayoutEffect(() => {
+		const { iframeRef, targetOrigin, register } = toValue(options);
+		let active;
+		const syncFrame = () => {
+			const iframe = iframeRef.value;
+			const iframeWindow = iframe?.isConnected === false ? null : iframe?.contentWindow;
+			if (active && active.iframe === iframe && active.window === iframeWindow) return;
+			const previous = active;
+			active = void 0;
+			let disposalFailed = false;
+			let disposalError;
+			try {
+				previous?.dispose();
+			} catch (error) {
+				disposalFailed = true;
+				disposalError = error;
+			}
+			if (iframe && iframeWindow) {
+				const frameHost = new AssistantFrameHost(iframeWindow, targetOrigin);
+				let unsubscribe;
+				try {
+					unsubscribe = register(frameHost);
+				} catch (error) {
+					frameHost.dispose();
+					throw error;
+				}
+				const onLoad = () => frameHost.frameLoaded();
+				iframe.addEventListener("load", onLoad);
+				active = {
+					iframe,
+					window: iframeWindow,
+					dispose: () => {
+						iframe.removeEventListener("load", onLoad);
+						let cleanupFailed = false;
+						let cleanupError;
+						try {
+							frameHost.dispose();
+						} catch (error) {
+							cleanupFailed = true;
+							cleanupError = error;
+						}
+						try {
+							unsubscribe();
+						} catch (error) {
+							if (cleanupFailed) console.error("[assistant-ui] AssistantFrameHost unregistration failed.", error);
+							else {
+								cleanupFailed = true;
+								cleanupError = error;
+							}
+						}
+						if (cleanupFailed) throw cleanupError;
+					}
+				};
+			}
+			if (disposalFailed) throw disposalError;
+		};
+		syncFrame();
+		watch(iframeRef, syncFrame, { flush: "post" });
+		const observer = new MutationObserver(syncFrame);
+		observer.observe(document, {
+			childList: true,
+			subtree: true
+		});
+		return () => {
+			observer.disconnect();
+			active?.dispose();
+		};
+	}, () => {
+		const { iframeRef, targetOrigin, register } = toValue(options);
+		return [
+			iframeRef,
+			targetOrigin,
+			register
+		];
+	});
+};
+export { useAssistantFrameHost };
+
+//# sourceMappingURL=useAssistantFrameHost.js.map

package/dist/model-context/frame/useAssistantFrameHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAssistantFrameHost.js","names":[],"sources":["../../../src/model-context/frame/useAssistantFrameHost.ts"],"sourcesContent":["\"use client\";\n\nimport type { Unsubscribe } from \"@ulearning/ai-core\";\nimport { toValue, watch, type MaybeRefOrGetter, type Ref } from \"vue\";\nimport { useIsomorphicLayoutEffect } from \"@ulearning/ai-store/internal\";\nimport { AssistantFrameHost } from \"@ulearning/ai-core\";\n\ntype UseAssistantFrameHostOptions = {\n  iframeRef: Readonly<Ref<HTMLIFrameElement | null | undefined>>;\n  targetOrigin?: string;\n  register: (frameHost: AssistantFrameHost) => Unsubscribe;\n};\n\n/**\n * Vue composable that manages the lifecycle of an AssistantFrameHost and its binding to the current AssistantRuntime.\n *\n * Usage example:\n * ```tsx\n * function setupFrame({\n *   trustedOrigin,\n *   register,\n * }: {\n *   trustedOrigin: string;\n *   register: Parameters<typeof useAssistantFrameHost>[0][\"register\"];\n * }) {\n *   const iframeRef = shallowRef<HTMLIFrameElement | null>(null);\n *\n *   useAssistantFrameHost({\n *     iframeRef,\n *     targetOrigin: trustedOrigin,\n *     register,\n *   });\n *\n *   return () => <iframe ref={iframeRef} src=\"...\" />;\n * }\n * ```\n */\nexport const useAssistantFrameHost = (\n  options: MaybeRefOrGetter<UseAssistantFrameHostOptions>,\n): void => {\n  useIsomorphicLayoutEffect(\n    () => {\n      const { iframeRef, targetOrigin, register } = toValue(options);\n      let active:\n        | {\n            iframe: HTMLIFrameElement;\n            window: Window;\n            dispose: () => void;\n          }\n        | undefined;\n\n      const syncFrame = () => {\n        const iframe = iframeRef.value;\n        const iframeWindow =\n          iframe?.isConnected === false ? null : iframe?.contentWindow;\n        if (\n          active &&\n          active.iframe === iframe &&\n          active.window === iframeWindow\n        )\n          return;\n\n        const previous = active;\n        active = undefined;\n        let disposalFailed = false;\n        let disposalError: unknown;\n        try {\n          previous?.dispose();\n        } catch (error) {\n          disposalFailed = true;\n          disposalError = error;\n        }\n\n        if (iframe && iframeWindow) {\n          const frameHost = new AssistantFrameHost(iframeWindow, targetOrigin);\n          let unsubscribe: Unsubscribe;\n          try {\n            unsubscribe = register(frameHost);\n          } catch (error) {\n            frameHost.dispose();\n            throw error;\n          }\n          const onLoad = () => frameHost.frameLoaded();\n          iframe.addEventListener(\"load\", onLoad);\n          active = {\n            iframe,\n            window: iframeWindow,\n            dispose: () => {\n              iframe.removeEventListener(\"load\", onLoad);\n              let cleanupFailed = false;\n              let cleanupError: unknown;\n\n              try {\n                frameHost.dispose();\n              } catch (error) {\n                cleanupFailed = true;\n                cleanupError = error;\n              }\n\n              try {\n                unsubscribe();\n              } catch (error) {\n                if (cleanupFailed) {\n                  console.error(\n                    \"[assistant-ui] AssistantFrameHost unregistration failed.\",\n                    error,\n                  );\n                } else {\n                  cleanupFailed = true;\n                  cleanupError = error;\n                }\n              }\n\n              if (cleanupFailed) throw cleanupError;\n            },\n          };\n        }\n\n        if (disposalFailed) throw disposalError;\n      };\n\n      syncFrame();\n      watch(iframeRef, syncFrame, { flush: \"post\" });\n      const observer = new MutationObserver(syncFrame);\n      observer.observe(document, { childList: true, subtree: true });\n\n      return () => {\n        observer.disconnect();\n        active?.dispose();\n      };\n    },\n    () => {\n      const { iframeRef, targetOrigin, register } = toValue(options);\n      return [iframeRef, targetOrigin, register];\n    },\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,MAAa,yBACX,YACS;CACT,gCACQ;EACJ,MAAM,EAAE,WAAW,cAAc,aAAa,QAAQ,OAAO;EAC7D,IAAI;EAQJ,MAAM,kBAAkB;GACtB,MAAM,SAAS,UAAU;GACzB,MAAM,eACJ,QAAQ,gBAAgB,QAAQ,OAAO,QAAQ;GACjD,IACE,UACA,OAAO,WAAW,UAClB,OAAO,WAAW,cAElB;GAEF,MAAM,WAAW;GACjB,SAAS,KAAA;GACT,IAAI,iBAAiB;GACrB,IAAI;GACJ,IAAI;IACF,UAAU,QAAQ;GACpB,SAAS,OAAO;IACd,iBAAiB;IACjB,gBAAgB;GAClB;GAEA,IAAI,UAAU,cAAc;IAC1B,MAAM,YAAY,IAAI,mBAAmB,cAAc,YAAY;IACnE,IAAI;IACJ,IAAI;KACF,cAAc,SAAS,SAAS;IAClC,SAAS,OAAO;KACd,UAAU,QAAQ;KAClB,MAAM;IACR;IACA,MAAM,eAAe,UAAU,YAAY;IAC3C,OAAO,iBAAiB,QAAQ,MAAM;IACtC,SAAS;KACP;KACA,QAAQ;KACR,eAAe;MACb,OAAO,oBAAoB,QAAQ,MAAM;MACzC,IAAI,gBAAgB;MACpB,IAAI;MAEJ,IAAI;OACF,UAAU,QAAQ;MACpB,SAAS,OAAO;OACd,gBAAgB;OAChB,eAAe;MACjB;MAEA,IAAI;OACF,YAAY;MACd,SAAS,OAAO;OACd,IAAI,eACF,QAAQ,MACN,4DACA,KACF;YACK;QACL,gBAAgB;QAChB,eAAe;OACjB;MACF;MAEA,IAAI,eAAe,MAAM;KAC3B;IACF;GACF;GAEA,IAAI,gBAAgB,MAAM;EAC5B;EAEA,UAAU;EACV,MAAM,WAAW,WAAW,EAAE,OAAO,OAAO,CAAC;EAC7C,MAAM,WAAW,IAAI,iBAAiB,SAAS;EAC/C,SAAS,QAAQ,UAAU;GAAE,WAAW;GAAM,SAAS;EAAK,CAAC;EAE7D,aAAa;GACX,SAAS,WAAW;GACpB,QAAQ,QAAQ;EAClB;CACF,SACM;EACJ,MAAM,EAAE,WAAW,cAAc,aAAa,QAAQ,OAAO;EAC7D,OAAO;GAAC;GAAW;GAAc;EAAQ;CAC3C,CACF;AACF"}

package/dist/model-context/makeAssistantVisible.d.ts

@@ -0,0 +1,11 @@
+import { type Component, type FunctionalComponent } from "vue";
+type ComponentProps<T extends Component> = T extends new (...args: never[]) => {
+    $props: infer P extends object;
+} ? P : T extends FunctionalComponent<infer P extends object> ? P : Record<string, unknown>;
+export declare const makeAssistantVisible: <T extends Component>(Component: T, config?: {
+    clickable?: boolean | undefined;
+    editable?: boolean | undefined;
+    settleDelayMs?: number | undefined;
+}) => import("vue").DefineSetupFnComponent<ComponentProps<T>, {}, {}, ComponentProps<T> & {}, import("vue").PublicProps>;
+export default makeAssistantVisible;
+//# sourceMappingURL=makeAssistantVisible.d.ts.map

package/dist/model-context/makeAssistantVisible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeAssistantVisible.d.ts","mappings":"AAEA,OAAO,EAML,KAAK,SAAS,EACd,KAAK,mBAAmB,EAEzB,MAAM,KAAK;AAgGZ,KAAK,cAAc,CAAC,CAAC,SAAS,SAAS,IAAI,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK;IAC7E,MAAM,EAAE,MAAM,CAAC,SAAS,MAAM;CAC/B,GACG,CAAC,GACD,CAAC,SAAS,mBAAmB,CAAC,MAAM,CAAC,SAAS,MAAM,CAAC,GACnD,CAAC,GACD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;AAE7B,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,SAAS,EACtD,WAAW,CAAC,EACZ,SAAS;IACP,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS;IAC/B,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS;IAC9B,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS;CACnC,uHA4DF;AAED,eAAe,oBAAoB","names":[],"ignoreList":[],"sources":["../../src/model-context/makeAssistantVisible.tsx"],"sourcesContent":[null]}

package/dist/model-context/makeAssistantVisible.js

@@ -0,0 +1,102 @@
+"use client";
+import { tool } from "@ulearning/ai-core";
+import { defineComponent, h, inject, provide, useId } from "vue";
+import { useAui } from "@ulearning/ai-store";
+import { useIsomorphicLayoutEffect } from "@ulearning/ai-store/internal";
+import { useForwardExpose } from "reka-ui";
+// src/model-context/makeAssistantVisible.tsx
+const DEFAULT_ACTION_SETTLE_DELAY_MS = 2e3;
+const MAX_ACTION_SETTLE_DELAY_MS = 2147483647;
+const waitForSettle = async (settleDelayMs) => {
+	const delay = Number.isFinite(settleDelayMs) && settleDelayMs >= 0 && settleDelayMs <= MAX_ACTION_SETTLE_DELAY_MS ? settleDelayMs : DEFAULT_ACTION_SETTLE_DELAY_MS;
+	if (delay === 0) return;
+	await new Promise((resolve) => setTimeout(resolve, delay));
+};
+const readActionSettleDelay = (element) => {
+	const value = element.dataset.actionSettleDelay;
+	return value === void 0 || value.trim() === "" ? DEFAULT_ACTION_SETTLE_DELAY_MS : Number(value);
+};
+const click = tool({
+	parameters: {
+		type: "object",
+		properties: { clickId: { type: "string" } },
+		required: ["clickId"]
+	},
+	execute: async ({ clickId }) => {
+		const escapedClickId = CSS.escape(clickId);
+		const el = document.querySelector(`[data-click-id='${escapedClickId}']`);
+		if (el instanceof HTMLElement) {
+			el.click();
+			await waitForSettle(readActionSettleDelay(el));
+			return {};
+		} else return "Element not found";
+	}
+});
+const setNativeValue = (element, value) => {
+	const prototype = element instanceof HTMLInputElement ? HTMLInputElement.prototype : HTMLTextAreaElement.prototype;
+	const setter = Object.getOwnPropertyDescriptor(prototype, "value")?.set;
+	if (setter) setter.call(element, value);
+	else element.value = value;
+};
+const edit = tool({
+	parameters: {
+		type: "object",
+		properties: {
+			editId: { type: "string" },
+			value: { type: "string" }
+		},
+		required: ["editId", "value"]
+	},
+	execute: async ({ editId, value }) => {
+		const escapedEditId = CSS.escape(editId);
+		const el = document.querySelector(`[data-edit-id='${escapedEditId}']`);
+		if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) {
+			setNativeValue(el, value);
+			el.dispatchEvent(new Event("input", { bubbles: true }));
+			el.dispatchEvent(new Event("change", { bubbles: true }));
+			await waitForSettle(readActionSettleDelay(el));
+			return {};
+		} else return "Element not found";
+	}
+});
+const ReadableContext = Symbol("AssistantVisible");
+const makeAssistantVisible = (Component, config) => {
+	const settleDelayMs = config?.settleDelayMs ?? DEFAULT_ACTION_SETTLE_DELAY_MS;
+	if (!Number.isFinite(settleDelayMs) || settleDelayMs < 0 || settleDelayMs > MAX_ACTION_SETTLE_DELAY_MS) throw new RangeError(`settleDelayMs must be between 0 and ${MAX_ACTION_SETTLE_DELAY_MS}`);
+	const WrappedComponent = Component;
+	return defineComponent(function AssistantVisible(props, { attrs, slots }) {
+		const isNestedReadable = inject(ReadableContext, false);
+		provide(ReadableContext, true);
+		const clickId = useId();
+		const { forwardRef, currentElement } = useForwardExpose();
+		const aui = useAui();
+		const { clickable, editable } = config ?? {};
+		useIsomorphicLayoutEffect(() => aui.modelContext.register({ getModelContext: () => ({
+			tools: {
+				...clickable ? { click } : {},
+				...editable ? { edit } : {}
+			},
+			system: !isNestedReadable && currentElement.value instanceof HTMLElement ? currentElement.value.outerHTML : void 0
+		}) }), () => [
+			isNestedReadable,
+			aui,
+			clickable,
+			editable
+		]);
+		return () => h(WrappedComponent, {
+			...attrs,
+			...props,
+			...clickable ? { "data-click-id": clickId } : {},
+			...editable ? { "data-edit-id": clickId } : {},
+			...config?.settleDelayMs !== void 0 && (clickable || editable) ? { "data-action-settle-delay": settleDelayMs } : {},
+			ref: forwardRef
+		}, slots);
+	}, {
+		name: Component.name ?? "AssistantVisible",
+		inheritAttrs: false,
+		props: []
+	});
+};
+export { makeAssistantVisible as default, makeAssistantVisible };
+
+//# sourceMappingURL=makeAssistantVisible.js.map