mountly-mcp 0.0.0 → 3.1.0

package/dist/bridge/index.d.ts

@@ -1,8 +1,3 @@
-import { App } from '@modelcontextprotocol/ext-apps';
-export { App, McpUiAppCapabilities, McpUiHostCapabilities, McpUiHostContext, McpUiHostContextChangedNotification, McpUiToolCancelledNotification, McpUiToolInputNotification, McpUiToolResultNotification, PostMessageTransport } from '@modelcontextprotocol/ext-apps';
-import { WidgetModule } from 'mountly/adapter';
-import { D as DisplayMode } from '../types-B9JAWm4W.js';
-
 /**
  * View-side bridge that turns an MCP Apps `App` into a mountly `WidgetModule`
  * lifecycle. The full spec handshake — `ui/initialize`,
@@ -11,8 +6,9 @@ import { D as DisplayMode } from '../types-B9JAWm4W.js';
  * `ui/notifications/host-context-changed`, `ui/resource-teardown`,
  * `ui/notifications/size-changed` — is delegated to ext-apps's `App`.
  */
-
-interface RunBridgeOptions {
+import { App, PostMessageTransport, type McpUiDisplayMode } from "@modelcontextprotocol/ext-apps";
+import type { WidgetModule } from "mountly/adapter";
+export interface RunBridgeOptions {
     /** Pre-constructed App (used by jsdom tests); otherwise one is created here. */
     app?: App;
     widget: WidgetModule;
@@ -26,8 +22,17 @@ interface RunBridgeOptions {
      * only — for "stateless" views that drive themselves via `mcp.callServerTool`.
      */
     awaitToolResult?: boolean;
+    /**
+     * Render progressive states from `ui/notifications/tool-input-partial`.
+     *
+     * Off by default — the spec lets views ignore partials, and they carry
+     * best-effort recovered JSON that MUST NOT drive critical operations. When
+     * on, partials arrive as `toolInputPartial` (mounting the widget early if
+     * needed) and are cleared once the complete `tool-input` lands.
+     */
+    streamToolInput?: boolean;
     /** Display modes this view supports. Declared to the host during `ui/initialize`. */
-    availableDisplayModes?: ReadonlyArray<DisplayMode>;
+    availableDisplayModes?: ReadonlyArray<McpUiDisplayMode>;
     /** App identity sent during `ui/initialize`. */
     appInfo?: {
         name: string;
@@ -36,7 +41,7 @@ interface RunBridgeOptions {
     /** Override for tests; defaults to `window.addEventListener('beforeunload', ...)`. */
     onTeardown?: (handler: () => void) => () => void;
 }
-interface RunningBridge {
+export interface RunningBridge {
     /** Resolves once `ui/initialize` handshake completes and the first mount (or deferred mount) is wired. */
     ready: Promise<void>;
     /** The underlying App; exposed for hosts that want to drive the view directly. */
@@ -44,6 +49,6 @@ interface RunningBridge {
     /** Synchronously triggers teardown. */
     stop(): void;
 }
-declare function runBridge(options: RunBridgeOptions): RunningBridge;
-
-export { type RunBridgeOptions, type RunningBridge, runBridge };
+export declare function runBridge(options: RunBridgeOptions): RunningBridge;
+export { App, PostMessageTransport };
+export type { McpUiAppCapabilities, McpUiHostCapabilities, McpUiHostContext, McpUiToolInputNotification, McpUiToolInputPartialNotification, McpUiToolResultNotification, McpUiToolCancelledNotification, McpUiHostContextChangedNotification, } from "@modelcontextprotocol/ext-apps";

package/dist/bridge/index.js

@@ -2,8 +2,8 @@ import {
   App,
   PostMessageTransport,
   runBridge
-} from "../chunk-BUGGLMNA.js";
-import "../chunk-A64ZILAS.js";
+} from "../chunk-SNWNF2XI.js";
+import "../chunk-DQLQOMDM.js";
 export {
   App,
   PostMessageTransport,

package/dist/build/emit-html.d.ts

@@ -0,0 +1,30 @@
+import type { McpUiDisplayMode } from "@modelcontextprotocol/ext-apps";
+/**
+ * Runtime config the emitted HTML hands to the inlined bridge
+ * (`bridge/iframe-entry.ts` reads these off `globalThis`). Without it the view
+ * falls back to `awaitToolResult: true` / `availableDisplayModes: ["inline"]`,
+ * regardless of what the build declared in the sidecar.
+ */
+export interface EmitHtmlConfig {
+    awaitToolResult?: boolean;
+    displayModes?: ReadonlyArray<McpUiDisplayMode>;
+    streamToolInput?: boolean;
+}
+export interface EmitHtmlSelfContainedInput {
+    mode: "self-contained";
+    uri: string;
+    js: string;
+    css: string;
+    bridgeRuntimeJs: string;
+    config?: EmitHtmlConfig;
+}
+export interface EmitHtmlCdnInput {
+    mode: "cdn";
+    uri: string;
+    jsUrl: string;
+    cssUrl: string;
+    bridgeRuntimeJs: string;
+    config?: EmitHtmlConfig;
+}
+export type EmitHtmlInput = EmitHtmlSelfContainedInput | EmitHtmlCdnInput;
+export declare function emitHtml(input: EmitHtmlInput): string;

package/dist/build/emit-meta.d.ts

@@ -0,0 +1,17 @@
+import type { McpUiDisplayMode, McpUiResourceCsp, McpUiResourcePermissions } from "@modelcontextprotocol/ext-apps";
+import type { McpResourceDeclaration } from "../types.js";
+export interface EmitMetaInput {
+    uri: string;
+    name: string;
+    description?: string;
+    awaitToolResult?: boolean;
+    displayModes?: ReadonlyArray<McpUiDisplayMode>;
+    csp?: McpUiResourceCsp;
+    /** Sandbox permissions requested by the view (camera/microphone/geolocation/clipboardWrite). */
+    permissions?: McpUiResourcePermissions;
+    /** Dedicated sandbox origin requested by the view (host-dependent format). */
+    domain?: string;
+    /** Whether the view requests the host to show a visible border + background. */
+    prefersBorder?: boolean;
+}
+export declare function emitMeta(input: EmitMetaInput): McpResourceDeclaration;

package/dist/build/index.d.ts

@@ -1,39 +1,6 @@
-import { D as DisplayMode, M as McpCsp, f as McpResourcePermissions, d as McpResourceDeclaration } from '../types-B9JAWm4W.js';
-import '@modelcontextprotocol/ext-apps';
-
-interface EmitHtmlSelfContainedInput {
-    mode: "self-contained";
-    uri: string;
-    js: string;
-    css: string;
-    bridgeRuntimeJs: string;
-}
-interface EmitHtmlCdnInput {
-    mode: "cdn";
-    uri: string;
-    jsUrl: string;
-    cssUrl: string;
-    bridgeRuntimeJs: string;
-}
-type EmitHtmlInput = EmitHtmlSelfContainedInput | EmitHtmlCdnInput;
-declare function emitHtml(input: EmitHtmlInput): string;
-
-interface EmitMetaInput {
-    uri: string;
-    name: string;
-    description?: string;
-    awaitToolResult?: boolean;
-    displayModes?: ReadonlyArray<DisplayMode>;
-    csp?: McpCsp;
-    /** Sandbox permissions requested by the view (camera/microphone/geolocation/clipboardWrite). */
-    permissions?: McpResourcePermissions;
-    /** Dedicated sandbox origin requested by the view (host-dependent format). */
-    domain?: string;
-    /** Whether the view requests the host to show a visible border + background. */
-    prefersBorder?: boolean;
-}
-declare function emitMeta(input: EmitMetaInput): McpResourceDeclaration;
-
+import type { McpUiDisplayMode, McpUiResourceCsp, McpUiResourcePermissions } from "@modelcontextprotocol/ext-apps";
+import type { McpResourceDeclaration } from "../types.js";
+import type { McpAppArtifact } from "../artifact/index.js";
 /**
  * Absolute path to the iframe bridge runtime shipped with this package.
  *
@@ -45,18 +12,23 @@ declare function emitMeta(input: EmitMetaInput): McpResourceDeclaration;
  * Resolves relative to the installed package, so it works identically in
  * monorepos and in projects that installed mountly-mcp from npm.
  */
-declare function getBridgeRuntimePath(): string;
-interface BuildSelfContainedOptions {
+export declare function getBridgeRuntimePath(): string;
+export interface BuildSelfContainedOptions {
     entry: string;
     uri: string;
     name: string;
     output: string;
     description?: string;
     awaitToolResult?: boolean;
-    displayModes?: ReadonlyArray<DisplayMode>;
-    csp?: McpCsp;
+    displayModes?: ReadonlyArray<McpUiDisplayMode>;
+    /**
+     * Render progressive states from `ui/notifications/tool-input-partial`.
+     * Off by default — see `RunBridgeOptions.streamToolInput`.
+     */
+    streamToolInput?: boolean;
+    csp?: McpUiResourceCsp;
     /** Sandbox permissions requested by the view (camera/microphone/geolocation/clipboardWrite). */
-    permissions?: McpResourcePermissions;
+    permissions?: McpUiResourcePermissions;
     /** Dedicated sandbox origin (host-dependent format). */
     domain?: string;
     /** Whether the view requests the host to show a visible border + background. */
@@ -64,18 +36,31 @@ interface BuildSelfContainedOptions {
     cssEntry?: string;
     bridgeRuntimePath?: string;
 }
-interface BuildCdnOptions extends BuildSelfContainedOptions {
+export interface BuildCdnOptions extends BuildSelfContainedOptions {
     cdn: {
         jsUrl: string;
         cssUrl: string;
     };
 }
-type BuildOptions = BuildSelfContainedOptions | BuildCdnOptions;
-interface BuildResult {
+export type BuildOptions = BuildSelfContainedOptions | BuildCdnOptions;
+export interface BuildResult {
     htmlPath: string;
     metaPath: string;
     declaration: McpResourceDeclaration;
+    artifact: McpAppArtifact;
 }
-declare function buildMcpResource(options: BuildOptions): Promise<BuildResult>;
-
-export { type BuildCdnOptions, type BuildOptions, type BuildResult, type BuildSelfContainedOptions, buildMcpResource, emitHtml, emitMeta, getBridgeRuntimePath };
+export interface BuildFromSourceOptions extends Omit<BuildSelfContainedOptions, "entry" | "cssEntry"> {
+    /** The bundled widget JS. */
+    js: string;
+    /** The widget's CSS, if it has any. */
+    css?: string;
+}
+/**
+ * Same as {@link buildMcpResource}, but taking the bundle in memory instead of
+ * from disk — for bundler plugins that already hold the emitted sources and
+ * shouldn't have to guess when they land on the filesystem.
+ */
+export declare function buildMcpResourceFromSource(options: BuildFromSourceOptions): Promise<BuildResult>;
+export declare function buildMcpResource(options: BuildOptions): Promise<BuildResult>;
+export { emitHtml } from "./emit-html.js";
+export { emitMeta } from "./emit-meta.js";

package/dist/build/index.js

@@ -1,141 +1,15 @@
 import {
-  LATEST_PROTOCOL_VERSION,
-  RESOURCE_MIME_TYPE
-} from "../chunk-A64ZILAS.js";
-
-// src/build/index.ts
-import { readFile, writeFile } from "fs/promises";
-import { dirname, resolve } from "path";
-import { fileURLToPath } from "url";
-
-// src/build/emit-html.ts
-function escapeAttr(value) {
-  return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
-}
-function escapeScript(value) {
-  return value.replace(/<\/script/gi, "<\\/script");
-}
-function escapeStyle(value) {
-  return value.replace(/<\/style/gi, "<\\/style");
-}
-function emitHtml(input) {
-  const head = [
-    `<meta charset="utf-8">`,
-    `<meta name="mountly-mcp-protocol" content="${LATEST_PROTOCOL_VERSION}">`,
-    `<meta name="mountly-mcp-uri" content="${escapeAttr(input.uri)}">`
-  ];
-  if (input.mode === "self-contained") {
-    head.push(`<style>${escapeStyle(input.css)}</style>`);
-    const body2 = [
-      `<div id="mountly-mcp-root"></div>`,
-      `<script type="module">${escapeScript(input.js)}
-${escapeScript(input.bridgeRuntimeJs)}</script>`
-    ];
-    return template(head, body2);
-  }
-  head.push(`<link rel="stylesheet" href="${escapeAttr(input.cssUrl)}">`);
-  const body = [
-    `<div id="mountly-mcp-root"></div>`,
-    `<script type="module">${escapeScript(input.bridgeRuntimeJs)}</script>`,
-    `<script type="module" src="${escapeAttr(input.jsUrl)}"></script>`
-  ];
-  return template(head, body);
-}
-function template(head, body) {
-  return `<!doctype html>
-<html data-mountly-mcp>
-<head>
-${head.join("\n")}
-</head>
-<body>
-${body.join("\n")}
-</body>
-</html>`;
-}
-
-// src/build/emit-meta.ts
-function assertUiUri(uri) {
-  if (!uri.startsWith("ui://")) {
-    throw new Error(
-      `mountly-mcp: UI resource uri must use the 'ui://' scheme (received '${uri}')`
-    );
-  }
-}
-function emitMeta(input) {
-  assertUiUri(input.uri);
-  const ui = {};
-  if (input.csp) ui.csp = input.csp;
-  if (input.permissions) ui.permissions = input.permissions;
-  if (input.domain !== void 0) ui.domain = input.domain;
-  if (input.prefersBorder !== void 0) ui.prefersBorder = input.prefersBorder;
-  const decl = {
-    protocolVersion: LATEST_PROTOCOL_VERSION,
-    uri: input.uri,
-    name: input.name,
-    mimeType: RESOURCE_MIME_TYPE,
-    awaitToolResult: input.awaitToolResult ?? true,
-    displayModes: input.displayModes ?? ["inline"],
-    _meta: { ui }
-  };
-  if (input.description !== void 0) decl.description = input.description;
-  return decl;
-}
-
-// src/build/index.ts
-var __dirname = dirname(fileURLToPath(import.meta.url));
-function getBridgeRuntimePath() {
-  return resolve(__dirname, "../bridge/iframe-entry.js");
-}
-function defaultBridgeRuntimePath() {
-  return getBridgeRuntimePath();
-}
-async function buildMcpResource(options) {
-  const bridgeRuntimeJs = await readFile(
-    options.bridgeRuntimePath ?? defaultBridgeRuntimePath(),
-    "utf8"
-  );
-  const declaration = emitMeta({
-    uri: options.uri,
-    name: options.name,
-    description: options.description,
-    awaitToolResult: options.awaitToolResult,
-    displayModes: options.displayModes,
-    csp: "cdn" in options ? mergeCdnIntoCsp(options.csp, options.cdn) : options.csp,
-    permissions: options.permissions,
-    domain: options.domain,
-    prefersBorder: options.prefersBorder
-  });
-  let html;
-  if ("cdn" in options) {
-    html = emitHtml({
-      mode: "cdn",
-      uri: options.uri,
-      jsUrl: options.cdn.jsUrl,
-      cssUrl: options.cdn.cssUrl,
-      bridgeRuntimeJs
-    });
-  } else {
-    const js = await readFile(options.entry, "utf8");
-    const css = options.cssEntry ? await readFile(options.cssEntry, "utf8") : "";
-    html = emitHtml({ mode: "self-contained", uri: options.uri, js, css, bridgeRuntimeJs });
-  }
-  const metaPath = `${options.output}.meta.json`;
-  await writeFile(options.output, html, "utf8");
-  await writeFile(metaPath, JSON.stringify(declaration, null, 2), "utf8");
-  return { htmlPath: options.output, metaPath, declaration };
-}
-function mergeCdnIntoCsp(csp, cdn) {
-  const jsOrigin = new URL(cdn.jsUrl).origin;
-  const cssOrigin = new URL(cdn.cssUrl).origin;
-  const merged = { ...csp ?? {} };
-  const existing = new Set(merged.resourceDomains ?? []);
-  existing.add(jsOrigin);
-  existing.add(cssOrigin);
-  merged.resourceDomains = Array.from(existing);
-  return merged;
-}
+  buildMcpResource,
+  buildMcpResourceFromSource,
+  emitHtml,
+  emitMeta,
+  getBridgeRuntimePath
+} from "../chunk-4WAKOYMK.js";
+import "../chunk-DQLQOMDM.js";
+import "../chunk-YJA4H6IB.js";
 export {
   buildMcpResource,
+  buildMcpResourceFromSource,
   emitHtml,
   emitMeta,
   getBridgeRuntimePath

package/dist/build/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/build/index.ts","../../src/build/emit-html.ts","../../src/build/emit-meta.ts"],"sourcesContent":["import { readFile, writeFile } from \"node:fs/promises\";\nimport { dirname, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport type {\n  DisplayMode,\n  McpCsp,\n  McpResourceDeclaration,\n  McpResourcePermissions,\n} from \"../types.js\";\nimport { emitHtml } from \"./emit-html.js\";\nimport { emitMeta } from \"./emit-meta.js\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\n/**\n * Absolute path to the iframe bridge runtime shipped with this package.\n *\n * `buildMcpResource` inlines this file's contents into the emitted HTML so\n * the widget can speak the MCP Apps postMessage protocol. Use this when you\n * need to point another build tool at the runtime, or when you want a\n * stable, version-pinned alternative to passing `bridgeRuntimePath` yourself.\n *\n * Resolves relative to the installed package, so it works identically in\n * monorepos and in projects that installed mountly-mcp from npm.\n */\nexport function getBridgeRuntimePath(): string {\n  return resolve(__dirname, \"../bridge/iframe-entry.js\");\n}\n\nfunction defaultBridgeRuntimePath(): string {\n  return getBridgeRuntimePath();\n}\n\nexport interface BuildSelfContainedOptions {\n  entry: string;\n  uri: string;\n  name: string;\n  output: string;\n  description?: string;\n  awaitToolResult?: boolean;\n  displayModes?: ReadonlyArray<DisplayMode>;\n  csp?: McpCsp;\n  /** Sandbox permissions requested by the view (camera/microphone/geolocation/clipboardWrite). */\n  permissions?: McpResourcePermissions;\n  /** Dedicated sandbox origin (host-dependent format). */\n  domain?: string;\n  /** Whether the view requests the host to show a visible border + background. */\n  prefersBorder?: boolean;\n  cssEntry?: string;\n  bridgeRuntimePath?: string;\n}\n\nexport interface BuildCdnOptions extends BuildSelfContainedOptions {\n  cdn: { jsUrl: string; cssUrl: string };\n}\n\nexport type BuildOptions = BuildSelfContainedOptions | BuildCdnOptions;\n\nexport interface BuildResult {\n  htmlPath: string;\n  metaPath: string;\n  declaration: McpResourceDeclaration;\n}\n\nexport async function buildMcpResource(options: BuildOptions): Promise<BuildResult> {\n  const bridgeRuntimeJs = await readFile(\n    options.bridgeRuntimePath ?? defaultBridgeRuntimePath(),\n    \"utf8\",\n  );\n\n  const declaration = emitMeta({\n    uri: options.uri,\n    name: options.name,\n    description: options.description,\n    awaitToolResult: options.awaitToolResult,\n    displayModes: options.displayModes,\n    csp: \"cdn\" in options ? mergeCdnIntoCsp(options.csp, options.cdn) : options.csp,\n    permissions: options.permissions,\n    domain: options.domain,\n    prefersBorder: options.prefersBorder,\n  });\n\n  let html: string;\n  if (\"cdn\" in options) {\n    html = emitHtml({\n      mode: \"cdn\",\n      uri: options.uri,\n      jsUrl: options.cdn.jsUrl,\n      cssUrl: options.cdn.cssUrl,\n      bridgeRuntimeJs,\n    });\n  } else {\n    const js = await readFile(options.entry, \"utf8\");\n    const css = options.cssEntry ? await readFile(options.cssEntry, \"utf8\") : \"\";\n    html = emitHtml({ mode: \"self-contained\", uri: options.uri, js, css, bridgeRuntimeJs });\n  }\n\n  const metaPath = `${options.output}.meta.json`;\n  await writeFile(options.output, html, \"utf8\");\n  await writeFile(metaPath, JSON.stringify(declaration, null, 2), \"utf8\");\n\n  return { htmlPath: options.output, metaPath, declaration };\n}\n\nfunction mergeCdnIntoCsp(\n  csp: McpCsp | undefined,\n  cdn: { jsUrl: string; cssUrl: string },\n): McpCsp {\n  const jsOrigin = new URL(cdn.jsUrl).origin;\n  const cssOrigin = new URL(cdn.cssUrl).origin;\n  const merged: McpCsp = { ...(csp ?? {}) };\n  const existing = new Set(merged.resourceDomains ?? []);\n  existing.add(jsOrigin);\n  existing.add(cssOrigin);\n  merged.resourceDomains = Array.from(existing);\n  return merged;\n}\n\nexport { emitHtml } from \"./emit-html.js\";\nexport { emitMeta } from \"./emit-meta.js\";\n","import { MCP_APPS_PROTOCOL_VERSION } from \"../schema.js\";\n\nexport interface EmitHtmlSelfContainedInput {\n  mode: \"self-contained\";\n  uri: string;\n  js: string;\n  css: string;\n  bridgeRuntimeJs: string;\n}\n\nexport interface EmitHtmlCdnInput {\n  mode: \"cdn\";\n  uri: string;\n  jsUrl: string;\n  cssUrl: string;\n  bridgeRuntimeJs: string;\n}\n\nexport type EmitHtmlInput = EmitHtmlSelfContainedInput | EmitHtmlCdnInput;\n\nfunction escapeAttr(value: string): string {\n  return value\n    .replace(/&/g, \"&amp;\")\n    .replace(/\"/g, \"&quot;\")\n    .replace(/</g, \"&lt;\")\n    .replace(/>/g, \"&gt;\");\n}\n\nfunction escapeScript(value: string): string {\n  return value.replace(/<\\/script/gi, \"<\\\\/script\");\n}\n\nfunction escapeStyle(value: string): string {\n  return value.replace(/<\\/style/gi, \"<\\\\/style\");\n}\n\nexport function emitHtml(input: EmitHtmlInput): string {\n  const head = [\n    `<meta charset=\"utf-8\">`,\n    `<meta name=\"mountly-mcp-protocol\" content=\"${MCP_APPS_PROTOCOL_VERSION}\">`,\n    `<meta name=\"mountly-mcp-uri\" content=\"${escapeAttr(input.uri)}\">`,\n  ];\n\n  if (input.mode === \"self-contained\") {\n    head.push(`<style>${escapeStyle(input.css)}</style>`);\n    const body = [\n      `<div id=\"mountly-mcp-root\"></div>`,\n      `<script type=\"module\">${escapeScript(input.js)}\\n${escapeScript(input.bridgeRuntimeJs)}</script>`,\n    ];\n    return template(head, body);\n  }\n\n  head.push(`<link rel=\"stylesheet\" href=\"${escapeAttr(input.cssUrl)}\">`);\n  const body = [\n    `<div id=\"mountly-mcp-root\"></div>`,\n    `<script type=\"module\">${escapeScript(input.bridgeRuntimeJs)}</script>`,\n    `<script type=\"module\" src=\"${escapeAttr(input.jsUrl)}\"></script>`,\n  ];\n  return template(head, body);\n}\n\nfunction template(head: string[], body: string[]): string {\n  return `<!doctype html>\n<html data-mountly-mcp>\n<head>\n${head.join(\"\\n\")}\n</head>\n<body>\n${body.join(\"\\n\")}\n</body>\n</html>`;\n}\n","import { MCP_APPS_MIME, MCP_APPS_PROTOCOL_VERSION } from \"../schema.js\";\nimport type {\n  DisplayMode,\n  McpCsp,\n  McpResourceDeclaration,\n  McpResourcePermissions,\n} from \"../types.js\";\n\nexport interface EmitMetaInput {\n  uri: string;\n  name: string;\n  description?: string;\n  awaitToolResult?: boolean;\n  displayModes?: ReadonlyArray<DisplayMode>;\n  csp?: McpCsp;\n  /** Sandbox permissions requested by the view (camera/microphone/geolocation/clipboardWrite). */\n  permissions?: McpResourcePermissions;\n  /** Dedicated sandbox origin requested by the view (host-dependent format). */\n  domain?: string;\n  /** Whether the view requests the host to show a visible border + background. */\n  prefersBorder?: boolean;\n}\n\nfunction assertUiUri(uri: string): void {\n  if (!uri.startsWith(\"ui://\")) {\n    throw new Error(\n      `mountly-mcp: UI resource uri must use the 'ui://' scheme (received '${uri}')`,\n    );\n  }\n}\n\nexport function emitMeta(input: EmitMetaInput): McpResourceDeclaration {\n  assertUiUri(input.uri);\n\n  const ui: McpResourceDeclaration[\"_meta\"][\"ui\"] = {};\n  if (input.csp) ui.csp = input.csp;\n  if (input.permissions) ui.permissions = input.permissions;\n  if (input.domain !== undefined) ui.domain = input.domain;\n  if (input.prefersBorder !== undefined) ui.prefersBorder = input.prefersBorder;\n\n  const decl: McpResourceDeclaration = {\n    protocolVersion: MCP_APPS_PROTOCOL_VERSION,\n    uri: input.uri,\n    name: input.name,\n    mimeType: MCP_APPS_MIME,\n    awaitToolResult: input.awaitToolResult ?? true,\n    displayModes: input.displayModes ?? [\"inline\"],\n    _meta: { ui },\n  };\n  if (input.description !== undefined) decl.description = input.description;\n  return decl;\n}\n"],"mappings":"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","names":["body"]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-33DMFKKD.js

@@ -0,0 +1,111 @@
+import {
+  escapeInlineScript
+} from "./chunk-YJA4H6IB.js";
+
+// src/json-render/app.ts
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { App } from "@modelcontextprotocol/ext-apps";
+function isSpec(value) {
+  return !!value && typeof value === "object" && "root" in value;
+}
+function pickSpec(payload) {
+  const structured = payload?.structuredContent;
+  if (isSpec(structured)) return structured;
+  const nested = structured?.spec;
+  if (nested) return nested;
+  for (const part of payload?.content ?? []) {
+    if (part?.type !== "text" || !part.text) continue;
+    try {
+      const parsed = JSON.parse(part.text);
+      if (isSpec(parsed)) return parsed;
+      const wrapped = parsed?.spec;
+      if (isSpec(wrapped)) return wrapped;
+    } catch {
+    }
+  }
+  return null;
+}
+function useJsonRenderApp(options) {
+  const [spec, setSpec] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [connected, setConnected] = useState(false);
+  const [connecting, setConnecting] = useState(true);
+  const [error, setError] = useState(null);
+  const [app, setApp] = useState(null);
+  useEffect(() => {
+    const current = new App({ name: options.name, version: options.version }, {});
+    setApp(current);
+    setConnecting(true);
+    setConnected(false);
+    setError(null);
+    const onToolResult = (params) => {
+      const next = pickSpec(params);
+      if (next) setSpec(next);
+      setLoading(false);
+    };
+    current.addEventListener("toolresult", onToolResult);
+    void current.connect().then(() => {
+      setConnected(true);
+    }).catch((err) => {
+      setError(err instanceof Error ? err : new Error(String(err)));
+    }).finally(() => {
+      setConnecting(false);
+    });
+    return () => {
+      current.removeEventListener("toolresult", onToolResult);
+      void current.close().catch(() => void 0);
+    };
+  }, [options.name, options.version]);
+  const callServerTool = useCallback(
+    async (name, args) => {
+      if (!app) throw new Error("json-render app is not connected yet");
+      setLoading(true);
+      const result = await app.callServerTool({
+        name,
+        arguments: args ?? {}
+      });
+      const next = pickSpec(result);
+      if (next) setSpec(next);
+      setLoading(false);
+    },
+    [app]
+  );
+  return useMemo(
+    () => ({
+      spec,
+      loading,
+      connected,
+      connecting,
+      error,
+      app,
+      callServerTool
+    }),
+    [spec, loading, connected, connecting, error, app, callServerTool]
+  );
+}
+function buildAppHtml(options) {
+  const title = options.title ?? "json-render MCP App";
+  const css = options.css ?? "";
+  const js = escapeInlineScript(options.js);
+  return [
+    "<!doctype html>",
+    "<html>",
+    "<head>",
+    '  <meta charset="utf-8" />',
+    '  <meta name="viewport" content="width=device-width, initial-scale=1" />',
+    `  <title>${title}</title>`,
+    css ? `  <style>${css}</style>` : "",
+    "</head>",
+    "<body>",
+    '  <div id="root"></div>',
+    `  <script type="module">${js}</script>`,
+    "</body>",
+    "</html>"
+  ].filter(Boolean).join("\n");
+}
+
+export {
+  useJsonRenderApp,
+  buildAppHtml
+};
+//# sourceMappingURL=chunk-33DMFKKD.js.map

package/dist/chunk-33DMFKKD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/json-render/app.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useState } from \"react\";\nimport { App } from \"@modelcontextprotocol/ext-apps\";\nimport type { Spec } from \"@json-render/core\";\nimport { escapeInlineScript } from \"../html.js\";\n\nexport interface UseJsonRenderAppOptions {\n  name: string;\n  version: string;\n}\n\nexport interface UseJsonRenderAppReturn {\n  spec: Spec | null;\n  loading: boolean;\n  connected: boolean;\n  connecting: boolean;\n  error: Error | null;\n  app: App | null;\n  callServerTool: (name: string, args?: Record<string, unknown>) => Promise<void>;\n}\n\ntype ToolResultPayload = {\n  structuredContent?: { spec?: Spec } | Spec;\n  content?: ReadonlyArray<{ type?: string; text?: string }>;\n};\n\nfunction isSpec(value: unknown): value is Spec {\n  return !!value && typeof value === \"object\" && \"root\" in (value as Record<string, unknown>);\n}\n\n/**\n * Read the spec from a tool result in either wire format: Mountly's\n * `structuredContent`, or the JSON-in-`content[0].text` that\n * `@json-render/mcp` servers emit. Supporting both means this hook renders\n * a server built with either package.\n */\nfunction pickSpec(payload: ToolResultPayload | undefined): Spec | null {\n  const structured = payload?.structuredContent;\n  if (isSpec(structured)) return structured;\n  const nested = (structured as { spec?: Spec } | undefined)?.spec;\n  if (nested) return nested;\n\n  for (const part of payload?.content ?? []) {\n    if (part?.type !== \"text\" || !part.text) continue;\n    try {\n      const parsed: unknown = JSON.parse(part.text);\n      if (isSpec(parsed)) return parsed;\n      const wrapped = (parsed as { spec?: unknown } | null)?.spec;\n      if (isSpec(wrapped)) return wrapped;\n    } catch {\n      // Not a spec payload — hosts also send plain prose here.\n    }\n  }\n  return null;\n}\n\nexport function useJsonRenderApp(options: UseJsonRenderAppOptions): UseJsonRenderAppReturn {\n  const [spec, setSpec] = useState<Spec | null>(null);\n  const [loading, setLoading] = useState(true);\n  const [connected, setConnected] = useState(false);\n  const [connecting, setConnecting] = useState(true);\n  const [error, setError] = useState<Error | null>(null);\n  const [app, setApp] = useState<App | null>(null);\n\n  useEffect(() => {\n    const current = new App({ name: options.name, version: options.version }, {});\n    setApp(current);\n    setConnecting(true);\n    setConnected(false);\n    setError(null);\n\n    const onToolResult = (params: ToolResultPayload) => {\n      const next = pickSpec(params);\n      if (next) setSpec(next);\n      setLoading(false);\n    };\n    current.addEventListener(\"toolresult\", onToolResult);\n\n    void current\n      .connect()\n      .then(() => {\n        setConnected(true);\n      })\n      .catch((err) => {\n        setError(err instanceof Error ? err : new Error(String(err)));\n      })\n      .finally(() => {\n        setConnecting(false);\n      });\n\n    return () => {\n      current.removeEventListener(\"toolresult\", onToolResult);\n      void current.close().catch(() => undefined);\n    };\n  }, [options.name, options.version]);\n\n  const callServerTool = useCallback(\n    async (name: string, args?: Record<string, unknown>) => {\n      if (!app) throw new Error(\"json-render app is not connected yet\");\n      setLoading(true);\n      const result = (await app.callServerTool({\n        name,\n        arguments: args ?? {},\n      })) as ToolResultPayload;\n      const next = pickSpec(result);\n      if (next) setSpec(next);\n      setLoading(false);\n    },\n    [app],\n  );\n\n  return useMemo(\n    () => ({\n      spec,\n      loading,\n      connected,\n      connecting,\n      error,\n      app,\n      callServerTool,\n    }),\n    [spec, loading, connected, connecting, error, app, callServerTool],\n  );\n}\n\nexport interface BuildAppHtmlOptions {\n  title?: string;\n  js: string;\n  css?: string;\n}\n\nexport function buildAppHtml(options: BuildAppHtmlOptions): string {\n  const title = options.title ?? \"json-render MCP App\";\n  const css = options.css ?? \"\";\n  const js = escapeInlineScript(options.js);\n  return [\n    \"<!doctype html>\",\n    \"<html>\",\n    \"<head>\",\n    '  <meta charset=\"utf-8\" />',\n    '  <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />',\n    `  <title>${title}</title>`,\n    css ? `  <style>${css}</style>` : \"\",\n    \"</head>\",\n    \"<body>\",\n    '  <div id=\"root\"></div>',\n    `  <script type=\"module\">${js}</script>`,\n    \"</body>\",\n    \"</html>\",\n  ]\n    .filter(Boolean)\n    .join(\"\\n\");\n}\n"],"mappings":"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","names":[]}