mountly-mcp 4.1.0 → 4.3.0

package/dist/compose/index.js

@@ -0,0 +1,141 @@
+// src/compose/index.ts
+import { z } from "zod";
+import {
+  RESOURCE_MIME_TYPE,
+  registerAppResource,
+  registerAppTool
+} from "@modelcontextprotocol/ext-apps/server";
+var DEFAULT_RESOURCE_URI = "ui://mountly/compose.html";
+var DEFAULT_TOOL_NAME = "show_page";
+function composeViewHtml(options) {
+  const importMap = JSON.stringify({ imports: options.imports }).replace(/</g, "\\u003c");
+  const styles = (options.styles ?? "").replace(/<\/style/gi, "<\\/style");
+  const title = (options.title ?? "Page").replace(/[<&]/g, "");
+  return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>${title}</title>
+    <script type="importmap">${importMap}</script>
+    <style>${styles}</style>
+  </head>
+  <body>
+    <main id="page"></main>
+    <script type="module">
+      import { App } from "@modelcontextprotocol/ext-apps";
+      import { connectView } from "mountly-compose";
+
+      const app = new App({ name: "mountly-compose", version: "1.0.0" });
+      connectView(app, document.querySelector("#page"), {
+        request: "Show the updated page with ${DEFAULT_TOOL_NAME}.",
+      });
+      await app.connect();
+    </script>
+  </body>
+</html>
+`;
+}
+function originsOf(options) {
+  const urls = [
+    ...Object.values(options.imports),
+    ...options.catalog.elements.flatMap((el) => el.embed ? [el.embed] : [])
+  ];
+  const origins = /* @__PURE__ */ new Set();
+  for (const url of urls) {
+    try {
+      origins.add(new URL(url).origin);
+    } catch {
+    }
+  }
+  return [...origins];
+}
+function tagsOf(node, into = /* @__PURE__ */ new Set()) {
+  into.add(node.tag);
+  for (const child of node.children ?? []) tagsOf(child, into);
+  return into;
+}
+function viewPayload(catalog, page) {
+  return { page, elements: catalog.elements, actions: catalog.actions };
+}
+function registerComposeApp(server, options) {
+  const { catalog } = options;
+  const name = options.name ?? DEFAULT_TOOL_NAME;
+  const resourceUri = options.resourceUri ?? DEFAULT_RESOURCE_URI;
+  if (!resourceUri.startsWith("ui://")) {
+    throw new Error(
+      `mountly-mcp/compose: resourceUri must use 'ui://' (received '${resourceUri}')`
+    );
+  }
+  const origins = originsOf(options);
+  const csp = { connectDomains: origins, resourceDomains: origins, frameDomains: [] };
+  const html = composeViewHtml(options);
+  registerAppResource(
+    server,
+    "compose_view",
+    resourceUri,
+    {
+      mimeType: RESOURCE_MIME_TYPE,
+      description: "A page composed from teams' custom elements.",
+      _meta: { ui: { prefersBorder: false, csp } }
+    },
+    async () => ({
+      contents: [
+        { uri: resourceUri, mimeType: RESOURCE_MIME_TYPE, text: html, _meta: { ui: { csp } } }
+      ]
+    })
+  );
+  const description = [
+    `Show the user a page built from the components below. Call it with { "page": <tree> }.`,
+    `To change the page, call it again with the whole updated page.`,
+    options.instructions ?? "",
+    "",
+    catalog.prompt()
+  ].filter((line, index) => line || index > 2).join("\n");
+  registerAppTool(
+    server,
+    name,
+    {
+      title: "Show page",
+      description,
+      inputSchema: { page: z.unknown().describe("The page as a tree: { tag, attrs, children }.") },
+      _meta: { ui: { resourceUri, visibility: ["model", "app"] } }
+    },
+    (async (args) => {
+      const errors = catalog.validate(args.page);
+      let page = args.page;
+      let note = "";
+      if (errors.length) {
+        const { tree, dropped } = catalog.repair(args.page);
+        if (!tree || catalog.validate(tree).length) {
+          return {
+            isError: true,
+            content: [
+              {
+                type: "text",
+                text: `The page cannot be shown:
+${errors.join("\n")}
+Fix these and call ${name} again.`
+              }
+            ]
+          };
+        }
+        page = tree;
+        note = ` Removed what the catalog does not allow: ${dropped.join("; ")}.`;
+      }
+      const hostTags = new Set(
+        catalog.elements.filter((el) => el.team === "host").map((el) => el.tag)
+      );
+      const tags = [...tagsOf(page)].filter((tag) => !hostTags.has(tag));
+      return {
+        content: [{ type: "text", text: `Showing ${tags.join(", ") || "the page"}.${note}` }],
+        structuredContent: viewPayload(catalog, page)
+      };
+    })
+  );
+  return { tool: name, resourceUri };
+}
+export {
+  composeViewHtml,
+  registerComposeApp
+};
+//# sourceMappingURL=index.js.map

package/dist/compose/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/compose/index.ts"],"sourcesContent":["/**\n * Show a page composed from many teams' custom elements inside an MCP host.\n *\n * The agent is the composer: `show_page` carries the catalog's prompt as its\n * description, the agent calls it with a tree, the server validates (or\n * repairs) it, and the `ui://` view renders it with `mountly-compose` — each\n * team's code loading on first use. When the user acts in a widget, the view\n * sends the agent its next turn, with the current page, so it edits rather than\n * starts over.\n */\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport {\n  RESOURCE_MIME_TYPE,\n  registerAppResource,\n  registerAppTool,\n} from \"@modelcontextprotocol/ext-apps/server\";\nimport type { Catalog, Tree } from \"mountly-compose\";\n\nconst DEFAULT_RESOURCE_URI = \"ui://mountly/compose.html\";\nconst DEFAULT_TOOL_NAME = \"show_page\";\n\nexport interface ComposeViewOptions {\n  /**\n   * The view's import map. Must map `mountly-compose` and\n   * `@modelcontextprotocol/ext-apps` (its `app-with-deps` build), plus\n   * whatever the teams' peer embeds import: `react`, `react/jsx-runtime`,\n   * `react-dom/client`, `mountly-react`, `mountly/embed`.\n   */\n  imports: Record<string, string>;\n  /** The page's own CSS: host layout (`ui-stack`, `ui-grid`, `ui-note`) and design tokens. */\n  styles?: string;\n  /** Document title. */\n  title?: string;\n}\n\nexport interface RegisterComposeAppOptions extends ComposeViewOptions {\n  catalog: Catalog;\n  /** MCP tool name. Default `show_page`. */\n  name?: string;\n  /** `ui://` resource for the view. */\n  resourceUri?: string;\n  /** Appended to the tool description: what the agent may fill ids from, house rules. */\n  instructions?: string;\n}\n\n/** The view HTML: an import map, the host's CSS, and a module that renders tool results. */\nexport function composeViewHtml(options: ComposeViewOptions): string {\n  const importMap = JSON.stringify({ imports: options.imports }).replace(/</g, \"\\\\u003c\");\n  const styles = (options.styles ?? \"\").replace(/<\\/style/gi, \"<\\\\/style\");\n  const title = (options.title ?? \"Page\").replace(/[<&]/g, \"\");\n  return `<!doctype html>\n<html lang=\"en\">\n  <head>\n    <meta charset=\"utf-8\" />\n    <title>${title}</title>\n    <script type=\"importmap\">${importMap}</script>\n    <style>${styles}</style>\n  </head>\n  <body>\n    <main id=\"page\"></main>\n    <script type=\"module\">\n      import { App } from \"@modelcontextprotocol/ext-apps\";\n      import { connectView } from \"mountly-compose\";\n\n      const app = new App({ name: \"mountly-compose\", version: \"1.0.0\" });\n      connectView(app, document.querySelector(\"#page\"), {\n        request: \"Show the updated page with ${DEFAULT_TOOL_NAME}.\",\n      });\n      await app.connect();\n    </script>\n  </body>\n</html>\n`;\n}\n\n/** Every origin the view loads code or data from, for its content security policy. */\nfunction originsOf(options: RegisterComposeAppOptions): string[] {\n  const urls = [\n    ...Object.values(options.imports),\n    ...options.catalog.elements.flatMap((el) => (el.embed ? [el.embed] : [])),\n  ];\n  const origins = new Set<string>();\n  for (const url of urls) {\n    try {\n      origins.add(new URL(url).origin);\n    } catch {\n      // A relative URL is same-origin with the view and needs no entry.\n    }\n  }\n  return [...origins];\n}\n\nfunction tagsOf(node: Tree, into = new Set<string>()): Set<string> {\n  into.add(node.tag);\n  for (const child of node.children ?? []) tagsOf(child, into);\n  return into;\n}\n\n/**\n * What the view renders with: the page, and the catalog's elements and actions.\n * All the elements, not just the page's: an action names the widgets the next\n * page must show, and the view hands that to the agent on the next turn.\n */\nfunction viewPayload(catalog: Catalog, page: Tree) {\n  return { page, elements: catalog.elements, actions: catalog.actions };\n}\n\n/**\n * Register the `show_page` tool and its `ui://` view on an MCP server.\n *\n * The input is `{ page }`, typed loosely on purpose: a strict schema would make\n * the SDK reject a near-miss before the handler could repair it. The handler\n * validates against the catalog, strips small mistakes, and otherwise returns\n * the reasons as a tool error the agent can act on.\n */\nexport function registerComposeApp(\n  server: McpServer,\n  options: RegisterComposeAppOptions,\n): { tool: string; resourceUri: string } {\n  const { catalog } = options;\n  const name = options.name ?? DEFAULT_TOOL_NAME;\n  const resourceUri = options.resourceUri ?? DEFAULT_RESOURCE_URI;\n  if (!resourceUri.startsWith(\"ui://\")) {\n    throw new Error(\n      `mountly-mcp/compose: resourceUri must use 'ui://' (received '${resourceUri}')`,\n    );\n  }\n  const origins = originsOf(options);\n  const csp = { connectDomains: origins, resourceDomains: origins, frameDomains: [] };\n  const html = composeViewHtml(options);\n\n  registerAppResource(\n    server,\n    \"compose_view\",\n    resourceUri,\n    {\n      mimeType: RESOURCE_MIME_TYPE,\n      description: \"A page composed from teams' custom elements.\",\n      _meta: { ui: { prefersBorder: false, csp } },\n    },\n    async () => ({\n      contents: [\n        { uri: resourceUri, mimeType: RESOURCE_MIME_TYPE, text: html, _meta: { ui: { csp } } },\n      ],\n    }),\n  );\n\n  const description = [\n    `Show the user a page built from the components below. Call it with { \"page\": <tree> }.`,\n    `To change the page, call it again with the whole updated page.`,\n    options.instructions ?? \"\",\n    \"\",\n    catalog.prompt(),\n  ]\n    .filter((line, index) => line || index > 2)\n    .join(\"\\n\");\n\n  registerAppTool(\n    server,\n    name,\n    {\n      title: \"Show page\",\n      description,\n      inputSchema: { page: z.unknown().describe(\"The page as a tree: { tag, attrs, children }.\") },\n      _meta: { ui: { resourceUri, visibility: [\"model\", \"app\"] } },\n    } as never,\n    (async (args: { page?: unknown }) => {\n      const errors = catalog.validate(args.page);\n      let page = args.page as Tree;\n      let note = \"\";\n      if (errors.length) {\n        const { tree, dropped } = catalog.repair(args.page);\n        if (!tree || catalog.validate(tree).length) {\n          return {\n            isError: true,\n            content: [\n              {\n                type: \"text\",\n                text: `The page cannot be shown:\\n${errors.join(\"\\n\")}\\nFix these and call ${name} again.`,\n              },\n            ],\n          };\n        }\n        page = tree;\n        note = ` Removed what the catalog does not allow: ${dropped.join(\"; \")}.`;\n      }\n      const hostTags = new Set(\n        catalog.elements.filter((el) => el.team === \"host\").map((el) => el.tag),\n      );\n      const tags = [...tagsOf(page)].filter((tag) => !hostTags.has(tag));\n      return {\n        content: [{ type: \"text\", text: `Showing ${tags.join(\", \") || \"the page\"}.${note}` }],\n        structuredContent: viewPayload(catalog, page),\n      };\n    }) as never,\n  );\n\n  return { tool: name, resourceUri };\n}\n"],"mappings":"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","names":[]}

package/dist/dev/host-entry.js

@@ -15186,7 +15186,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     }
   });
 
-  // ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/types.js
+  // ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_@cfworker+json-schema@4.1.1_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/types.js
   init_v4();
   var RELATED_TASK_META_KEY = "io.modelcontextprotocol/related-task";
   var JSONRPC_VERSION = "2.0";
@@ -16707,7 +16707,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
   // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/mini/parse.js
   init_core2();
 
-  // ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/server/zod-compat.js
+  // ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_@cfworker+json-schema@4.1.1_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/server/zod-compat.js
   function isZ4Schema(s2) {
     const schema = s2;
     return !!schema._zod;
@@ -16770,7 +16770,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     return void 0;
   }
 
-  // ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/interfaces.js
+  // ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_@cfworker+json-schema@4.1.1_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/interfaces.js
   function isTerminal(status) {
     return status === "completed" || status === "failed" || status === "cancelled";
   }
@@ -16778,7 +16778,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
   // ../../node_modules/.pnpm/zod-to-json-schema@3.25.2_zod@4.4.3/node_modules/zod-to-json-schema/dist/esm/parsers/string.js
   var ALPHA_NUMERIC = new Set("ABCDEFGHIJKLMNOPQRSTUVXYZabcdefghijklmnopqrstuvxyz0123456789");
 
-  // ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/server/zod-json-schema-compat.js
+  // ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_@cfworker+json-schema@4.1.1_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/server/zod-json-schema-compat.js
   function getMethodLiteral(schema) {
     const shape = getObjectShape(schema);
     const methodSchema = shape?.method;
@@ -16799,7 +16799,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     return result.data;
   }
 
-  // ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/protocol.js
+  // ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_@cfworker+json-schema@4.1.1_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/protocol.js
   var DEFAULT_REQUEST_TIMEOUT_MSEC = 6e4;
   var Protocol = class {
     constructor(_options) {
@@ -17734,7 +17734,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     }
   };
 
-  // ../../node_modules/.pnpm/@modelcontextprotocol+ext-apps@1.7.5_@modelcontextprotocol+sdk@1.30.0_zod@4.4.3__react-dom@19_cmaoxxnyjgqtqbxeim6duwrgeu/node_modules/@modelcontextprotocol/ext-apps/dist/src/app-bridge.js
+  // ../../node_modules/.pnpm/@modelcontextprotocol+ext-apps@1.7.5_@modelcontextprotocol+sdk@1.30.0_@cfworker+json-schema@4_zach7odob275zkkz2vkisyu32i/node_modules/@modelcontextprotocol/ext-apps/dist/src/app-bridge.js
   init_v4();
   var ZQ = ((X) => typeof __require < "u" ? __require : typeof Proxy < "u" ? new Proxy(X, { get: (Y, Z) => (typeof __require < "u" ? __require : Y)[Z] }) : X)(function(X) {
     if (typeof __require < "u") return __require.apply(this, arguments);
@@ -18213,6 +18213,8 @@ container holding the app. Specify either width or maxWidth, and either height o
   var capabilities = {
     openLinks: {},
     logging: {},
+    // A view's `sendMessage` asks the host to post the user's next turn to the agent.
+    message: { text: {} },
     ...config2.hasServer ? { serverTools: {} } : {}
   };
   var bridge = new DX(null, { name: "mountly-mcp-dev", version: "1.0.0" }, capabilities, {
@@ -18225,6 +18227,11 @@ container holding the app. Specify either width or maxWidth, and either height o
     }
   });
   bridge.onloggingmessage = (params) => log("in", `notifications/message ${params.level}`);
+  bridge.onmessage = async ({ content }) => {
+    const text = content.map((block) => "text" in block ? block.text : `[${block.type}]`).join(" ");
+    log("in", `ui/message ${text}`);
+    return {};
+  };
   bridge.onopenlink = async ({ url: url2 }) => {
     window.open(url2, "_blank", "noopener,noreferrer");
     return {};

package/dist/dev/index.js

@@ -1,7 +1,7 @@
 import {
   sandboxProxyHtml,
   startDevHost
-} from "../chunk-KWVGW5Q7.js";
+} from "../chunk-GN2IQYV3.js";
 import {
   connectMcpServer
 } from "../chunk-OWAXBNZA.js";

package/dist/{doctor-B54H6CRN.js → doctor-4MTC6Y4X.js}

@@ -4,9 +4,9 @@ import {
 } from "./chunk-EOWAWZH2.js";
 
 // src/doctor.ts
-import { existsSync, readFileSync } from "fs";
+import { existsSync, readFileSync, readdirSync } from "fs";
 import { createRequire } from "module";
-import { resolve } from "path";
+import { join, resolve } from "path";
 function nodeMajor() {
   return Number(process.versions.node.split(".")[0] ?? 0);
 }
@@ -18,6 +18,33 @@ function tryResolve(specifier, fromDir) {
     return null;
   }
 }
+var OPENAI_USAGE = /openai\/ui|useOpenAIExtensions|mountly-mcp\/openai|mountly-mcp\/react\/openai|@openai\/mcp-extensions|openaiUi\b|openaiUiToolMeta|enableOpenAiExtensions/;
+function projectSourcesMentionOpenAi(cwd, viteConfig) {
+  const candidates = [];
+  if (viteConfig) candidates.push(viteConfig);
+  for (const name of ["server.ts", "server.mjs", "server.js", "src/server.ts", "src/view.tsx"]) {
+    const path = resolve(cwd, name);
+    if (existsSync(path)) candidates.push(path);
+  }
+  const srcDir = resolve(cwd, "src");
+  if (existsSync(srcDir)) {
+    try {
+      for (const entry of readdirSync(srcDir, { withFileTypes: true })) {
+        if (entry.isFile() && /\.(tsx?|jsx?|mjs|cjs)$/.test(entry.name)) {
+          candidates.push(join(srcDir, entry.name));
+        }
+      }
+    } catch {
+    }
+  }
+  for (const path of candidates) {
+    try {
+      if (OPENAI_USAGE.test(readFileSync(path, "utf8"))) return true;
+    } catch {
+    }
+  }
+  return false;
+}
 function runDoctor(cwd = process.cwd()) {
   const checks = [];
   const major = nodeMajor();
@@ -88,6 +115,14 @@ function runDoctor(cwd = process.cwd()) {
       }
     }
   }
+  if (projectSourcesMentionOpenAi(cwd, viteConfig)) {
+    const openai = tryResolve("@openai/mcp-extensions/package.json", cwd);
+    checks.push({
+      id: "openai-extensions",
+      ok: Boolean(openai),
+      detail: openai ? `@openai/mcp-extensions resolvable (${openai})` : "Project references OpenAI MCP extensions but @openai/mcp-extensions is not installed. Run: pnpm add @openai/mcp-extensions"
+    });
+  }
   const hard = checks.filter((c) => c.id !== "manifest" && c.id !== "playwright");
   const ok = hard.every((c) => c.ok);
   return { ok, checks };
@@ -119,4 +154,4 @@ export {
   formatDoctorReport,
   runDoctor
 };
-//# sourceMappingURL=doctor-B54H6CRN.js.map
+//# sourceMappingURL=doctor-4MTC6Y4X.js.map

package/dist/doctor-4MTC6Y4X.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/doctor.ts"],"sourcesContent":["import { existsSync, readFileSync, readdirSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { join, resolve } from \"node:path\";\nimport { CLI_ERROR_CODES, cliError } from \"./errors.js\";\n\nexport interface DoctorCheck {\n  id: string;\n  ok: boolean;\n  detail: string;\n}\n\nexport interface DoctorReport {\n  ok: boolean;\n  checks: DoctorCheck[];\n}\n\nfunction nodeMajor(): number {\n  return Number(process.versions.node.split(\".\")[0] ?? 0);\n}\n\nfunction tryResolve(specifier: string, fromDir: string): string | null {\n  try {\n    const require = createRequire(resolve(fromDir, \"package.json\"));\n    return require.resolve(specifier);\n  } catch {\n    return null;\n  }\n}\n\nconst OPENAI_USAGE =\n  /openai\\/ui|useOpenAIExtensions|mountly-mcp\\/openai|mountly-mcp\\/react\\/openai|@openai\\/mcp-extensions|openaiUi\\b|openaiUiToolMeta|enableOpenAiExtensions/;\n\nfunction projectSourcesMentionOpenAi(cwd: string, viteConfig?: string): boolean {\n  const candidates: string[] = [];\n  if (viteConfig) candidates.push(viteConfig);\n  for (const name of [\"server.ts\", \"server.mjs\", \"server.js\", \"src/server.ts\", \"src/view.tsx\"]) {\n    const path = resolve(cwd, name);\n    if (existsSync(path)) candidates.push(path);\n  }\n  const srcDir = resolve(cwd, \"src\");\n  if (existsSync(srcDir)) {\n    try {\n      for (const entry of readdirSync(srcDir, { withFileTypes: true })) {\n        if (entry.isFile() && /\\.(tsx?|jsx?|mjs|cjs)$/.test(entry.name)) {\n          candidates.push(join(srcDir, entry.name));\n        }\n      }\n    } catch {\n      // ignore unreadable src\n    }\n  }\n  for (const path of candidates) {\n    try {\n      if (OPENAI_USAGE.test(readFileSync(path, \"utf8\"))) return true;\n    } catch {\n      // skip\n    }\n  }\n  return false;\n}\n\n/**\n * Check the local project for Mountly MCP readiness. Exits nonzero via the\n * CLI when `ok` is false.\n */\nexport function runDoctor(cwd = process.cwd()): DoctorReport {\n  const checks: DoctorCheck[] = [];\n\n  const major = nodeMajor();\n  checks.push({\n    id: \"node\",\n    ok: major >= 20,\n    detail:\n      major >= 20\n        ? `Node ${process.versions.node} (ok; 20+ required, 22+ recommended)`\n        : `Node ${process.versions.node} is below 20. Upgrade Node, then re-run mountly-mcp doctor.`,\n  });\n\n  const viteConfigCandidates = [\n    \"vite.config.ts\",\n    \"vite.config.mts\",\n    \"vite.config.js\",\n    \"vite.config.mjs\",\n  ].map((name) => resolve(cwd, name));\n  const viteConfig = viteConfigCandidates.find((path) => existsSync(path));\n  checks.push({\n    id: \"vite-config\",\n    ok: Boolean(viteConfig),\n    detail: viteConfig\n      ? `Found ${viteConfig}`\n      : \"No vite.config.* in this directory. Run from the View project, or: npx mountly-mcp create my-app --framework react\",\n  });\n\n  if (viteConfig) {\n    const source = readFileSync(viteConfig, \"utf8\");\n    const hasPlugin = /mountlyMcpViews\\s*\\(/.test(source);\n    checks.push({\n      id: \"vite-plugin\",\n      ok: hasPlugin,\n      detail: hasPlugin\n        ? \"vite config imports mountlyMcpViews()\"\n        : `Add mountlyMcpViews() from \"mountly-mcp/vite\" to ${viteConfig}`,\n    });\n  }\n\n  const manifest = resolve(cwd, \"dist/mountly-mcp.manifest.json\");\n  checks.push({\n    id: \"manifest\",\n    ok: existsSync(manifest),\n    detail: existsSync(manifest)\n      ? `Found ${manifest}`\n      : \"No dist/mountly-mcp.manifest.json yet. Run: npx mountly-mcp build\",\n  });\n\n  const playwright = tryResolve(\"playwright\", cwd) ?? tryResolve(\"@playwright/test\", cwd);\n  checks.push({\n    id: \"playwright\",\n    ok: Boolean(playwright),\n    detail: playwright\n      ? `Playwright resolvable for verify --render (${playwright})`\n      : \"Playwright not installed. For CI render checks: pnpm add -D playwright && npx playwright install chromium\",\n  });\n\n  const pkgPath = resolve(cwd, \"package.json\");\n  if (existsSync(pkgPath)) {\n    const pkg = JSON.parse(readFileSync(pkgPath, \"utf8\")) as {\n      dependencies?: Record<string, string>;\n      peerDependencies?: Record<string, string>;\n      devDependencies?: Record<string, string>;\n    };\n    const deps = { ...pkg.dependencies, ...pkg.devDependencies };\n    if (deps.react) {\n      const reactPath = tryResolve(\"react/package.json\", cwd);\n      if (reactPath) {\n        const reactPkg = JSON.parse(readFileSync(reactPath, \"utf8\")) as { version?: string };\n        const reactMajor = Number((reactPkg.version ?? \"0\").split(\".\")[0]);\n        checks.push({\n          id: \"react\",\n          ok: reactMajor >= 19,\n          detail:\n            reactMajor >= 19\n              ? `React ${reactPkg.version} (ok)`\n              : `React ${reactPkg.version} is below 19. mountly-mcp/react and mountly-react require React 19.`,\n        });\n      }\n    }\n    if (deps.vite) {\n      const vitePath = tryResolve(\"vite/package.json\", cwd);\n      if (vitePath) {\n        const vitePkg = JSON.parse(readFileSync(vitePath, \"utf8\")) as { version?: string };\n        const viteMajor = Number((vitePkg.version ?? \"0\").split(\".\")[0]);\n        checks.push({\n          id: \"vite\",\n          ok: viteMajor >= 8,\n          detail:\n            viteMajor >= 8\n              ? `Vite ${vitePkg.version} (ok)`\n              : `Vite ${vitePkg.version} is below 8. mountly-mcp/vite is built and tested against Vite 8.`,\n        });\n      }\n    }\n  }\n\n  if (projectSourcesMentionOpenAi(cwd, viteConfig)) {\n    const openai = tryResolve(\"@openai/mcp-extensions/package.json\", cwd);\n    checks.push({\n      id: \"openai-extensions\",\n      ok: Boolean(openai),\n      detail: openai\n        ? `@openai/mcp-extensions resolvable (${openai})`\n        : 'Project references OpenAI MCP extensions but @openai/mcp-extensions is not installed. Run: pnpm add @openai/mcp-extensions',\n    });\n  }\n\n  // Manifest missing is advisory for a brand-new scaffold before first build.\n  const hard = checks.filter((c) => c.id !== \"manifest\" && c.id !== \"playwright\");\n  const ok = hard.every((c) => c.ok);\n\n  return { ok, checks };\n}\n\nexport function formatDoctorReport(report: DoctorReport): string {\n  const lines = [\"mountly-mcp doctor\", \"\"];\n  for (const check of report.checks) {\n    lines.push(`${check.ok ? \"ok\" : \"FAIL\"}  ${check.id.padEnd(14)} ${check.detail}`);\n  }\n  lines.push(\"\");\n  lines.push(report.ok ? \"Ready for mountly-mcp build / dev / verify.\" : \"Fix FAIL items above.\");\n  lines.push(\"\");\n  return `${lines.join(\"\\n\")}\\n`;\n}\n\nexport function doctorCommand(cwd = process.cwd()): void {\n  const report = runDoctor(cwd);\n  process.stdout.write(formatDoctorReport(report));\n  if (!report.ok) {\n    throw cliError(\n      CLI_ERROR_CODES.DOCTOR_FAILED,\n      \"one or more doctor checks failed\",\n      \"Fix the FAIL lines above, then re-run: mountly-mcp doctor\",\n    );\n  }\n}\n"],"mappings":"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","names":["require"]}

package/dist/index.js

@@ -1,11 +1,11 @@
-import {
-  sandboxProxyHtml
-} from "./chunk-6QHKKFO3.js";
 import {
   MCP_VIEW_GLOBAL_KEY,
   getPublishedMcpView,
   publishMcpView
 } from "./chunk-5L3QHYWK.js";
+import {
+  sandboxProxyHtml
+} from "./chunk-6QHKKFO3.js";
 import {
   App,
   PostMessageTransport,

package/dist/json-render/index.js

@@ -1,3 +1,7 @@
+import {
+  buildAppHtml,
+  useJsonRenderApp
+} from "../chunk-33DMFKKD.js";
 import {
   createJsonRenderMcpApp,
   registerJsonRenderResource,
@@ -15,12 +19,9 @@ import {
   createMcpView,
   useMcpApp,
   useToolResult
-} from "../chunk-SXF23BZD.js";
+} from "../chunk-HIAIQVK5.js";
+import "../chunk-4SZHJ4MK.js";
 import "../chunk-5L3QHYWK.js";
-import {
-  buildAppHtml,
-  useJsonRenderApp
-} from "../chunk-33DMFKKD.js";
 import "../chunk-YJA4H6IB.js";
 
 // src/json-render/generative-view.tsx

package/dist/json-render/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/json-render/generative-view.tsx","../../src/json-render/index.ts","../../src/json-render/use-spec-stream.ts"],"sourcesContent":["import { createElement } from \"react\";\nimport { type ComponentMap, createRenderer } from \"@json-render/react\";\nimport type { Catalog, SchemaDefinition, Spec } from \"@json-render/core\";\nimport { createMcpView, useMcpApp, useToolResult } from \"../react/index.js\";\nimport type { App } from \"@modelcontextprotocol/ext-apps\";\nimport type { AdapterOptions } from \"mountly/adapter\";\nimport type { McpView } from \"../types.js\";\n\n/** The catalog-data constraint createRenderer infers against. */\ntype CatalogData = { components: Record<string, { props: unknown }> };\n\n/**\n * Route a generated UI's actions back to the MCP host. Called with the action\n * name, its (resolved) params, and the view-side `App` handle.\n */\nexport type ActionRouter = (\n  name: string,\n  params: Record<string, unknown> | undefined,\n  mcp: App,\n) => void;\n\n/**\n * Default router: an `ask` action with a string `prompt` param sends a\n * follow-up user turn to the model via `App.sendMessage`. This is the agent\n * loop json-render alone cannot do — it has no concept of an MCP host.\n */\nexport const defaultActionRouter: ActionRouter = (name, params, mcp) => {\n  if (name !== \"ask\") return;\n  const prompt = params?.prompt;\n  const text = typeof prompt === \"string\" ? prompt : \"\";\n  if (text) {\n    void mcp.sendMessage({ role: \"user\", content: [{ type: \"text\", text }] });\n  }\n};\n\n/**\n * Identity helper that types a components map against a catalog (so it can be\n * defined once and reused by both `createGenerativeView` and `createRenderer`)\n * without losing per-component prop inference.\n *\n * ```ts\n * export const components = defineComponents(catalog, {\n *   Metric: ({ element }) => <span>{element.props.value}</span>,\n * });\n * ```\n */\nexport function defineComponents<TDef extends SchemaDefinition, TCatalog extends CatalogData>(\n  _catalog: Catalog<TDef, TCatalog>,\n  components: ComponentMap<TCatalog[\"components\"]>,\n): ComponentMap<TCatalog[\"components\"]> {\n  return components;\n}\n\nexport interface GenerativeViewOptions<\n  TDef extends SchemaDefinition,\n  TCatalog extends CatalogData,\n> extends AdapterOptions {\n  /** The json-render catalog — the vocabulary the agent may compose. */\n  catalog: Catalog<TDef, TCatalog>;\n  /** Native component implementations for each catalog type. */\n  components: ComponentMap<TCatalog[\"components\"]>;\n  /**\n   * How a generated UI's actions reach the agent. Defaults to\n   * {@link defaultActionRouter} (`ask` → `App.sendMessage`).\n   */\n  onAction?: ActionRouter;\n}\n\ninterface ToolResultShape {\n  structuredContent?: { spec?: Spec };\n}\n\n/**\n * Turn a json-render catalog + components into a mountly MCP Apps View.\n *\n * Reads the spec from the tool result, renders it natively (resolving `$state`\n * from `spec.state`), and routes actions back to the MCP host.\n *\n * ```ts\n * createGenerativeView({ catalog, components, styles, shadow: true });\n * ```\n */\nexport function createGenerativeView<TDef extends SchemaDefinition, TCatalog extends CatalogData>(\n  options: GenerativeViewOptions<TDef, TCatalog>,\n): McpView {\n  const { catalog, components, onAction = defaultActionRouter, ...adapter } = options;\n  const Rendered = createRenderer(catalog, components);\n\n  function GenerativeView() {\n    const mcp = useMcpApp();\n    const result = useToolResult<ToolResultShape>();\n    const spec = result?.structuredContent?.spec ?? null;\n    if (!spec) return null;\n    return createElement(Rendered, {\n      spec,\n      state: spec.state,\n      onAction: (name: string, params?: Record<string, unknown>) => onAction(name, params, mcp),\n    });\n  }\n\n  return createMcpView(GenerativeView, adapter);\n}\n","export {\n  type ActionRouter,\n  type GenerativeViewOptions,\n  createGenerativeView,\n  defaultActionRouter,\n  defineComponents,\n} from \"./generative-view.js\";\nexport {\n  type JsonRenderToolOptions,\n  type RegisterJsonRenderResourceOptions,\n  type RegisterJsonRenderToolOptions,\n  type CreateJsonRenderMcpAppOptions,\n  createJsonRenderMcpApp,\n  registerJsonRenderTool,\n  registerJsonRenderResource,\n} from \"./mcp.js\";\nexport {\n  type BuildAppHtmlOptions,\n  type UseJsonRenderAppOptions,\n  type UseJsonRenderAppReturn,\n  buildAppHtml,\n  useJsonRenderApp,\n} from \"./app.js\";\n\n// Convenience re-exports for rendering the same catalog natively (non-MCP) —\n// previews, tests, or a plain mountly feature. Pair with `mountly-react`'s\n// `createWidget` to mount a spec outside an MCP host.\nexport { createRenderer } from \"@json-render/react\";\nexport type { ComponentMap, ComponentRenderProps } from \"@json-render/react\";\n\n// Streaming primitives (json-render's own): replay a known spec as a patch\n// stream, compile patches back into a progressively-built spec, and the AI-SDK\n// transform that classifies a model's UI-message stream into spec patches.\nexport {\n  compileSpecStream,\n  compileTextStreamToSpecs,\n  createJsonRenderTransform,\n  createSpecStreamCompiler,\n  parseSpecStreamLine,\n  specToPatchLines,\n} from \"./spec-stream.js\";\nexport type { Spec } from \"@json-render/core\";\n\n// --- Two ways to stream ---\n//\n// Replay (known spec): `useSpecStream` takes a finished spec — e.g. the one an\n// MCP tool delivered as `structuredContent` — and replays it as a live build,\n// with the compiler, loading flag, and cancellation included.\nexport {\n  type SpecStreamState,\n  type UseSpecStreamOptions,\n  useSpecStream,\n} from \"./use-spec-stream.js\";\n\n// Live (from a model): `useUIStream` / `useChatUI` are json-render's own client\n// hooks — POST a prompt to an endpoint that streams JSONL patches (see\n// `streamSpec` in `mountly-mcp/json-render/server`) and render the spec as it\n// builds. Re-exported so the live path is one import away.\nexport { useChatUI, useUIStream } from \"@json-render/react\";\nexport type { UseUIStreamOptions, UseUIStreamReturn } from \"@json-render/react\";\n","import { useEffect, useState } from \"react\";\nimport type { Spec } from \"@json-render/core\";\nimport { createSpecStreamCompiler } from \"@json-render/core\";\nimport { specToPatchLines } from \"./spec-stream.js\";\n\nexport interface UseSpecStreamOptions {\n  /** Delay between patches, ms. Default 90. Set 0 to render instantly. */\n  intervalMs?: number;\n}\n\nexport interface SpecStreamState {\n  /** The progressively-built spec (partial while streaming, full when done). */\n  spec: Spec | null;\n  /** Convenience: `spec?.state`, to pass straight to the renderer. */\n  state: Record<string, unknown> | undefined;\n  /** True while patches are still being applied. */\n  loading: boolean;\n}\n\n/**\n * Replay a finished spec as a live json-render stream — and own all the\n * ceremony. Give it the target spec; it scaffolds a `createSpecStreamCompiler`,\n * replays the patches with a delay, exposes the partial spec + `loading` after\n * each step, and cancels cleanly when the target changes (so a self-driving UI\n * that swaps specs mid-stream just works). Re-streams whenever `target` changes.\n *\n * ```tsx\n * const { spec, state, loading } = useSpecStream(specs[view]);\n * return <Renderer spec={spec} state={state} loading={loading} onAction={...} />;\n * ```\n */\nexport function useSpecStream(\n  target: Spec | null | undefined,\n  options: UseSpecStreamOptions = {},\n): SpecStreamState {\n  const { intervalMs = 90 } = options;\n  const [spec, setSpec] = useState<Spec | null>(null);\n  const [loading, setLoading] = useState(false);\n\n  useEffect(() => {\n    if (!target) {\n      setSpec(null);\n      setLoading(false);\n      return;\n    }\n    let cancelled = false;\n    const compiler = createSpecStreamCompiler<Spec>();\n    const lines = specToPatchLines(target);\n    setLoading(true);\n\n    void (async () => {\n      for (const line of lines) {\n        if (cancelled) return;\n        const { result } = compiler.push(`${line}\\n`);\n        setSpec({ ...result });\n        if (intervalMs > 0) {\n          await new Promise((r) => setTimeout(r, intervalMs));\n        }\n      }\n      if (cancelled) return;\n      setSpec(compiler.getResult());\n      setLoading(false);\n    })();\n\n    return () => {\n      cancelled = true;\n    };\n  }, [target, intervalMs]);\n\n  return { spec, state: spec?.state, loading };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAC9B,SAA4B,sBAAsB;AAyB3C,IAAM,sBAAoC,CAAC,MAAM,QAAQ,QAAQ;AACtE,MAAI,SAAS,MAAO;AACpB,QAAM,SAAS,QAAQ;AACvB,QAAM,OAAO,OAAO,WAAW,WAAW,SAAS;AACnD,MAAI,MAAM;AACR,SAAK,IAAI,YAAY,EAAE,MAAM,QAAQ,SAAS,CAAC,EAAE,MAAM,QAAQ,KAAK,CAAC,EAAE,CAAC;AAAA,EAC1E;AACF;AAaO,SAAS,iBACd,UACA,YACsC;AACtC,SAAO;AACT;AA+BO,SAAS,qBACd,SACS;AACT,QAAM,EAAE,SAAS,YAAY,WAAW,qBAAqB,GAAG,QAAQ,IAAI;AAC5E,QAAM,WAAW,eAAe,SAAS,UAAU;AAEnD,WAAS,iBAAiB;AACxB,UAAM,MAAM,UAAU;AACtB,UAAM,SAAS,cAA+B;AAC9C,UAAM,OAAO,QAAQ,mBAAmB,QAAQ;AAChD,QAAI,CAAC,KAAM,QAAO;AAClB,WAAO,cAAc,UAAU;AAAA,MAC7B;AAAA,MACA,OAAO,KAAK;AAAA,MACZ,UAAU,CAAC,MAAc,WAAqC,SAAS,MAAM,QAAQ,GAAG;AAAA,IAC1F,CAAC;AAAA,EACH;AAEA,SAAO,cAAc,gBAAgB,OAAO;AAC9C;;;AC1EA,SAAS,kBAAAA,uBAAsB;;;AC3B/B,SAAS,WAAW,gBAAgB;AAEpC,SAAS,4BAAAC,iCAAgC;AA6BlC,SAAS,cACd,QACA,UAAgC,CAAC,GAChB;AACjB,QAAM,EAAE,aAAa,GAAG,IAAI;AAC5B,QAAM,CAAC,MAAM,OAAO,IAAI,SAAsB,IAAI;AAClD,QAAM,CAAC,SAAS,UAAU,IAAI,SAAS,KAAK;AAE5C,YAAU,MAAM;AACd,QAAI,CAAC,QAAQ;AACX,cAAQ,IAAI;AACZ,iBAAW,KAAK;AAChB;AAAA,IACF;AACA,QAAI,YAAY;AAChB,UAAM,WAAWC,0BAA+B;AAChD,UAAM,QAAQ,iBAAiB,MAAM;AACrC,eAAW,IAAI;AAEf,UAAM,YAAY;AAChB,iBAAW,QAAQ,OAAO;AACxB,YAAI,UAAW;AACf,cAAM,EAAE,OAAO,IAAI,SAAS,KAAK,GAAG,IAAI;AAAA,CAAI;AAC5C,gBAAQ,EAAE,GAAG,OAAO,CAAC;AACrB,YAAI,aAAa,GAAG;AAClB,gBAAM,IAAI,QAAQ,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;AAAA,QACpD;AAAA,MACF;AACA,UAAI,UAAW;AACf,cAAQ,SAAS,UAAU,CAAC;AAC5B,iBAAW,KAAK;AAAA,IAClB,GAAG;AAEH,WAAO,MAAM;AACX,kBAAY;AAAA,IACd;AAAA,EACF,GAAG,CAAC,QAAQ,UAAU,CAAC;AAEvB,SAAO,EAAE,MAAM,OAAO,MAAM,OAAO,QAAQ;AAC7C;;;ADZA,SAAS,WAAW,mBAAmB;","names":["createRenderer","createSpecStreamCompiler","createSpecStreamCompiler"]}
+{"version":3,"sources":["../../src/json-render/generative-view.tsx","../../src/json-render/index.ts","../../src/json-render/use-spec-stream.ts"],"sourcesContent":["import { createElement } from \"react\";\nimport { type ComponentMap, createRenderer } from \"@json-render/react\";\nimport type { Catalog, SchemaDefinition, Spec } from \"@json-render/core\";\nimport { createMcpView, useMcpApp, useToolResult } from \"../react/index.js\";\nimport type { App } from \"@modelcontextprotocol/ext-apps\";\nimport type { AdapterOptions } from \"mountly/adapter\";\nimport type { McpView } from \"../types.js\";\n\n/** The catalog-data constraint createRenderer infers against. */\ntype CatalogData = { components: Record<string, { props: unknown }> };\n\n/**\n * Route a generated UI's actions back to the MCP host. Called with the action\n * name, its (resolved) params, and the view-side `App` handle.\n */\nexport type ActionRouter = (\n  name: string,\n  params: Record<string, unknown> | undefined,\n  mcp: App,\n) => void;\n\n/**\n * Default router: an `ask` action with a string `prompt` param sends a\n * follow-up user turn to the model via `App.sendMessage`. This is the agent\n * loop json-render alone cannot do — it has no concept of an MCP host.\n */\nexport const defaultActionRouter: ActionRouter = (name, params, mcp) => {\n  if (name !== \"ask\") return;\n  const prompt = params?.prompt;\n  const text = typeof prompt === \"string\" ? prompt : \"\";\n  if (text) {\n    void mcp.sendMessage({ role: \"user\", content: [{ type: \"text\", text }] });\n  }\n};\n\n/**\n * Identity helper that types a components map against a catalog (so it can be\n * defined once and reused by both `createGenerativeView` and `createRenderer`)\n * without losing per-component prop inference.\n *\n * ```ts\n * export const components = defineComponents(catalog, {\n *   Metric: ({ element }) => <span>{element.props.value}</span>,\n * });\n * ```\n */\nexport function defineComponents<TDef extends SchemaDefinition, TCatalog extends CatalogData>(\n  _catalog: Catalog<TDef, TCatalog>,\n  components: ComponentMap<TCatalog[\"components\"]>,\n): ComponentMap<TCatalog[\"components\"]> {\n  return components;\n}\n\nexport interface GenerativeViewOptions<\n  TDef extends SchemaDefinition,\n  TCatalog extends CatalogData,\n> extends AdapterOptions {\n  /** The json-render catalog — the vocabulary the agent may compose. */\n  catalog: Catalog<TDef, TCatalog>;\n  /** Native component implementations for each catalog type. */\n  components: ComponentMap<TCatalog[\"components\"]>;\n  /**\n   * How a generated UI's actions reach the agent. Defaults to\n   * {@link defaultActionRouter} (`ask` → `App.sendMessage`).\n   */\n  onAction?: ActionRouter;\n}\n\ninterface ToolResultShape {\n  structuredContent?: { spec?: Spec };\n}\n\n/**\n * Turn a json-render catalog + components into a mountly MCP Apps View.\n *\n * Reads the spec from the tool result, renders it natively (resolving `$state`\n * from `spec.state`), and routes actions back to the MCP host.\n *\n * ```ts\n * createGenerativeView({ catalog, components, styles, shadow: true });\n * ```\n */\nexport function createGenerativeView<TDef extends SchemaDefinition, TCatalog extends CatalogData>(\n  options: GenerativeViewOptions<TDef, TCatalog>,\n): McpView {\n  const { catalog, components, onAction = defaultActionRouter, ...adapter } = options;\n  const Rendered = createRenderer(catalog, components);\n\n  function GenerativeView() {\n    const mcp = useMcpApp();\n    const result = useToolResult<ToolResultShape>();\n    const spec = result?.structuredContent?.spec ?? null;\n    if (!spec) return null;\n    return createElement(Rendered, {\n      spec,\n      state: spec.state,\n      onAction: (name: string, params?: Record<string, unknown>) => onAction(name, params, mcp),\n    });\n  }\n\n  return createMcpView(GenerativeView, adapter);\n}\n","export {\n  type ActionRouter,\n  type GenerativeViewOptions,\n  createGenerativeView,\n  defaultActionRouter,\n  defineComponents,\n} from \"./generative-view.js\";\nexport {\n  type JsonRenderToolOptions,\n  type RegisterJsonRenderResourceOptions,\n  type RegisterJsonRenderToolOptions,\n  type CreateJsonRenderMcpAppOptions,\n  createJsonRenderMcpApp,\n  registerJsonRenderTool,\n  registerJsonRenderResource,\n} from \"./mcp.js\";\nexport {\n  type BuildAppHtmlOptions,\n  type UseJsonRenderAppOptions,\n  type UseJsonRenderAppReturn,\n  buildAppHtml,\n  useJsonRenderApp,\n} from \"./app.js\";\n\n// Convenience re-exports for rendering the same catalog natively (non-MCP) —\n// previews, tests, or a plain mountly feature. Pair with `mountly-react`'s\n// `createWidget` to mount a spec outside an MCP host.\nexport { createRenderer } from \"@json-render/react\";\nexport type { ComponentMap, ComponentRenderProps } from \"@json-render/react\";\n\n// Streaming primitives (json-render's own): replay a known spec as a patch\n// stream, compile patches back into a progressively-built spec, and the AI-SDK\n// transform that classifies a model's UI-message stream into spec patches.\nexport {\n  compileSpecStream,\n  compileTextStreamToSpecs,\n  createJsonRenderTransform,\n  createSpecStreamCompiler,\n  parseSpecStreamLine,\n  specToPatchLines,\n} from \"./spec-stream.js\";\nexport type { Spec } from \"@json-render/core\";\n\n// --- Two ways to stream ---\n//\n// Replay (known spec): `useSpecStream` takes a finished spec — e.g. the one an\n// MCP tool delivered as `structuredContent` — and replays it as a live build,\n// with the compiler, loading flag, and cancellation included.\nexport {\n  type SpecStreamState,\n  type UseSpecStreamOptions,\n  useSpecStream,\n} from \"./use-spec-stream.js\";\n\n// Live (from a model): `useUIStream` / `useChatUI` are json-render's own client\n// hooks — POST a prompt to an endpoint that streams JSONL patches (see\n// `streamSpec` in `mountly-mcp/json-render/server`) and render the spec as it\n// builds. Re-exported so the live path is one import away.\nexport { useChatUI, useUIStream } from \"@json-render/react\";\nexport type { UseUIStreamOptions, UseUIStreamReturn } from \"@json-render/react\";\n","import { useEffect, useState } from \"react\";\nimport type { Spec } from \"@json-render/core\";\nimport { createSpecStreamCompiler } from \"@json-render/core\";\nimport { specToPatchLines } from \"./spec-stream.js\";\n\nexport interface UseSpecStreamOptions {\n  /** Delay between patches, ms. Default 90. Set 0 to render instantly. */\n  intervalMs?: number;\n}\n\nexport interface SpecStreamState {\n  /** The progressively-built spec (partial while streaming, full when done). */\n  spec: Spec | null;\n  /** Convenience: `spec?.state`, to pass straight to the renderer. */\n  state: Record<string, unknown> | undefined;\n  /** True while patches are still being applied. */\n  loading: boolean;\n}\n\n/**\n * Replay a finished spec as a live json-render stream — and own all the\n * ceremony. Give it the target spec; it scaffolds a `createSpecStreamCompiler`,\n * replays the patches with a delay, exposes the partial spec + `loading` after\n * each step, and cancels cleanly when the target changes (so a self-driving UI\n * that swaps specs mid-stream just works). Re-streams whenever `target` changes.\n *\n * ```tsx\n * const { spec, state, loading } = useSpecStream(specs[view]);\n * return <Renderer spec={spec} state={state} loading={loading} onAction={...} />;\n * ```\n */\nexport function useSpecStream(\n  target: Spec | null | undefined,\n  options: UseSpecStreamOptions = {},\n): SpecStreamState {\n  const { intervalMs = 90 } = options;\n  const [spec, setSpec] = useState<Spec | null>(null);\n  const [loading, setLoading] = useState(false);\n\n  useEffect(() => {\n    if (!target) {\n      setSpec(null);\n      setLoading(false);\n      return;\n    }\n    let cancelled = false;\n    const compiler = createSpecStreamCompiler<Spec>();\n    const lines = specToPatchLines(target);\n    setLoading(true);\n\n    void (async () => {\n      for (const line of lines) {\n        if (cancelled) return;\n        const { result } = compiler.push(`${line}\\n`);\n        setSpec({ ...result });\n        if (intervalMs > 0) {\n          await new Promise((r) => setTimeout(r, intervalMs));\n        }\n      }\n      if (cancelled) return;\n      setSpec(compiler.getResult());\n      setLoading(false);\n    })();\n\n    return () => {\n      cancelled = true;\n    };\n  }, [target, intervalMs]);\n\n  return { spec, state: spec?.state, loading };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAC9B,SAA4B,sBAAsB;AAyB3C,IAAM,sBAAoC,CAAC,MAAM,QAAQ,QAAQ;AACtE,MAAI,SAAS,MAAO;AACpB,QAAM,SAAS,QAAQ;AACvB,QAAM,OAAO,OAAO,WAAW,WAAW,SAAS;AACnD,MAAI,MAAM;AACR,SAAK,IAAI,YAAY,EAAE,MAAM,QAAQ,SAAS,CAAC,EAAE,MAAM,QAAQ,KAAK,CAAC,EAAE,CAAC;AAAA,EAC1E;AACF;AAaO,SAAS,iBACd,UACA,YACsC;AACtC,SAAO;AACT;AA+BO,SAAS,qBACd,SACS;AACT,QAAM,EAAE,SAAS,YAAY,WAAW,qBAAqB,GAAG,QAAQ,IAAI;AAC5E,QAAM,WAAW,eAAe,SAAS,UAAU;AAEnD,WAAS,iBAAiB;AACxB,UAAM,MAAM,UAAU;AACtB,UAAM,SAAS,cAA+B;AAC9C,UAAM,OAAO,QAAQ,mBAAmB,QAAQ;AAChD,QAAI,CAAC,KAAM,QAAO;AAClB,WAAO,cAAc,UAAU;AAAA,MAC7B;AAAA,MACA,OAAO,KAAK;AAAA,MACZ,UAAU,CAAC,MAAc,WAAqC,SAAS,MAAM,QAAQ,GAAG;AAAA,IAC1F,CAAC;AAAA,EACH;AAEA,SAAO,cAAc,gBAAgB,OAAO;AAC9C;;;AC1EA,SAAS,kBAAAA,uBAAsB;;;AC3B/B,SAAS,WAAW,gBAAgB;AAEpC,SAAS,4BAAAC,iCAAgC;AA6BlC,SAAS,cACd,QACA,UAAgC,CAAC,GAChB;AACjB,QAAM,EAAE,aAAa,GAAG,IAAI;AAC5B,QAAM,CAAC,MAAM,OAAO,IAAI,SAAsB,IAAI;AAClD,QAAM,CAAC,SAAS,UAAU,IAAI,SAAS,KAAK;AAE5C,YAAU,MAAM;AACd,QAAI,CAAC,QAAQ;AACX,cAAQ,IAAI;AACZ,iBAAW,KAAK;AAChB;AAAA,IACF;AACA,QAAI,YAAY;AAChB,UAAM,WAAWC,0BAA+B;AAChD,UAAM,QAAQ,iBAAiB,MAAM;AACrC,eAAW,IAAI;AAEf,UAAM,YAAY;AAChB,iBAAW,QAAQ,OAAO;AACxB,YAAI,UAAW;AACf,cAAM,EAAE,OAAO,IAAI,SAAS,KAAK,GAAG,IAAI;AAAA,CAAI;AAC5C,gBAAQ,EAAE,GAAG,OAAO,CAAC;AACrB,YAAI,aAAa,GAAG;AAClB,gBAAM,IAAI,QAAQ,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;AAAA,QACpD;AAAA,MACF;AACA,UAAI,UAAW;AACf,cAAQ,SAAS,UAAU,CAAC;AAC5B,iBAAW,KAAK;AAAA,IAClB,GAAG;AAEH,WAAO,MAAM;AACX,kBAAY;AAAA,IACd;AAAA,EACF,GAAG,CAAC,QAAQ,UAAU,CAAC;AAEvB,SAAO,EAAE,MAAM,OAAO,MAAM,OAAO,QAAQ;AAC7C;;;ADZA,SAAS,WAAW,mBAAmB;","names":["createRenderer","createSpecStreamCompiler","createSpecStreamCompiler"]}

package/dist/openai/server.d.ts

@@ -0,0 +1,16 @@
+/**
+ * ChatGPT helpers that wrap `@openai/mcp-extensions/server`.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { OpenAIExtensions, type OpenAIUiEntrypoint, type OpenAIUiResourceMetadata, type OpenAIUiToolMetadata } from "@openai/mcp-extensions/server";
+/** Return the official OpenAI extensions surface for this MCP server. */
+export declare function enableOpenAiExtensions(server: McpServer): OpenAIExtensions;
+/** Build a `_meta` fragment with typed `"openai/ui"` tool metadata. */
+export declare function openaiUiToolMeta(meta: OpenAIUiToolMetadata): {
+    "openai/ui": OpenAIUiToolMetadata;
+};
+/** Build a `_meta` fragment with typed `"openai/ui"` resource metadata. */
+export declare function openaiUiResourceMeta(meta: OpenAIUiResourceMetadata): {
+    "openai/ui": OpenAIUiResourceMetadata;
+};
+export { OpenAIExtensions, type OpenAIUiEntrypoint, type OpenAIUiResourceMetadata, type OpenAIUiToolMetadata, };

package/dist/openai/server.js

@@ -0,0 +1,20 @@
+// src/openai/server.ts
+import {
+  OpenAIExtensions
+} from "@openai/mcp-extensions/server";
+function enableOpenAiExtensions(server) {
+  return new OpenAIExtensions(server);
+}
+function openaiUiToolMeta(meta) {
+  return { "openai/ui": meta };
+}
+function openaiUiResourceMeta(meta) {
+  return { "openai/ui": meta };
+}
+export {
+  OpenAIExtensions,
+  enableOpenAiExtensions,
+  openaiUiResourceMeta,
+  openaiUiToolMeta
+};
+//# sourceMappingURL=server.js.map

package/dist/openai/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/openai/server.ts"],"sourcesContent":["/**\n * ChatGPT helpers that wrap `@openai/mcp-extensions/server`.\n */\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport {\n  OpenAIExtensions,\n  type OpenAIUiEntrypoint,\n  type OpenAIUiResourceMetadata,\n  type OpenAIUiToolMetadata,\n} from \"@openai/mcp-extensions/server\";\n\n/** Return the official OpenAI extensions surface for this MCP server. */\nexport function enableOpenAiExtensions(server: McpServer): OpenAIExtensions {\n  return new OpenAIExtensions(server);\n}\n\n/** Build a `_meta` fragment with typed `\"openai/ui\"` tool metadata. */\nexport function openaiUiToolMeta(\n  meta: OpenAIUiToolMetadata,\n): { \"openai/ui\": OpenAIUiToolMetadata } {\n  return { \"openai/ui\": meta };\n}\n\n/** Build a `_meta` fragment with typed `\"openai/ui\"` resource metadata. */\nexport function openaiUiResourceMeta(\n  meta: OpenAIUiResourceMetadata,\n): { \"openai/ui\": OpenAIUiResourceMetadata } {\n  return { \"openai/ui\": meta };\n}\n\nexport {\n  OpenAIExtensions,\n  type OpenAIUiEntrypoint,\n  type OpenAIUiResourceMetadata,\n  type OpenAIUiToolMetadata,\n};\n"],"mappings":";AAIA;AAAA,EACE;AAAA,OAIK;AAGA,SAAS,uBAAuB,QAAqC;AAC1E,SAAO,IAAI,iBAAiB,MAAM;AACpC;AAGO,SAAS,iBACd,MACuC;AACvC,SAAO,EAAE,aAAa,KAAK;AAC7B;AAGO,SAAS,qBACd,MAC2C;AAC3C,SAAO,EAAE,aAAa,KAAK;AAC7B;","names":[]}

package/dist/react/index.js

@@ -1,5 +1,4 @@
 import {
-  McpContext,
   createMcpView,
   useAutoResize,
   useDisplayMode,
@@ -14,7 +13,10 @@ import {
   useToolInputPartial,
   useToolResult,
   useUpdateModelContext
-} from "../chunk-SXF23BZD.js";
+} from "../chunk-HIAIQVK5.js";
+import {
+  McpContext
+} from "../chunk-4SZHJ4MK.js";
 import "../chunk-5L3QHYWK.js";
 export {
   McpContext,

package/dist/react/openai-extensions.d.ts

@@ -0,0 +1,6 @@
+import { OpenAIExtensions } from "@openai/mcp-extensions/app";
+/**
+ * Official ChatGPT extension surface for this View.
+ * One `OpenAIExtensions` per App handle. Call `message`, `files`, `deepLink`, and the rest on the returned instance.
+ */
+export declare function useOpenAIExtensions(): OpenAIExtensions;

package/dist/react/openai-extensions.js

@@ -0,0 +1,25 @@
+import {
+  McpContext
+} from "../chunk-4SZHJ4MK.js";
+
+// src/react/openai-extensions.ts
+import { useContext, useRef } from "react";
+import { OpenAIExtensions } from "@openai/mcp-extensions/app";
+function useOpenAIExtensions() {
+  const ctx = useContext(McpContext);
+  if (!ctx) {
+    throw new Error(
+      "mountly-mcp/react: useOpenAIExtensions must be used inside a View wrapped with createMcpView()."
+    );
+  }
+  const app = ctx.app;
+  const ref = useRef(null);
+  if (ref.current?.app !== app) {
+    ref.current = { app, extensions: new OpenAIExtensions(app) };
+  }
+  return ref.current.extensions;
+}
+export {
+  useOpenAIExtensions
+};
+//# sourceMappingURL=openai-extensions.js.map

package/dist/react/openai-extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/openai-extensions.ts"],"sourcesContent":["/**\n * ChatGPT extension hook backed by `@openai/mcp-extensions/app`.\n * Separate entry (`mountly-mcp/react/openai`) keeps the peer out of ordinary Views.\n */\nimport { useContext, useRef } from \"react\";\nimport type { App } from \"@modelcontextprotocol/ext-apps\";\nimport { OpenAIExtensions } from \"@openai/mcp-extensions/app\";\nimport { McpContext } from \"./context.js\";\n\n/**\n * Official ChatGPT extension surface for this View.\n * One `OpenAIExtensions` per App handle. Call `message`, `files`, `deepLink`, and the rest on the returned instance.\n */\nexport function useOpenAIExtensions(): OpenAIExtensions {\n  const ctx = useContext(McpContext);\n  if (!ctx) {\n    throw new Error(\n      \"mountly-mcp/react: useOpenAIExtensions must be used inside a View wrapped with createMcpView().\",\n    );\n  }\n  const app = ctx.app;\n  const ref = useRef<{ app: App; extensions: OpenAIExtensions } | null>(null);\n  if (ref.current?.app !== app) {\n    ref.current = { app, extensions: new OpenAIExtensions(app) };\n  }\n  return ref.current.extensions;\n}\n"],"mappings":";;;;;AAIA,SAAS,YAAY,cAAc;AAEnC,SAAS,wBAAwB;AAO1B,SAAS,sBAAwC;AACtD,QAAM,MAAM,WAAW,UAAU;AACjC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,QAAM,MAAM,IAAI;AAChB,QAAM,MAAM,OAA0D,IAAI;AAC1E,MAAI,IAAI,SAAS,QAAQ,KAAK;AAC5B,QAAI,UAAU,EAAE,KAAK,YAAY,IAAI,iBAAiB,GAAG,EAAE;AAAA,EAC7D;AACA,SAAO,IAAI,QAAQ;AACrB;","names":[]}

package/dist/server/index.js

@@ -116,15 +116,20 @@ async function registerMcpApps(server, options) {
   server.server.registerCapabilities({
     extensions: { [EXTENSION_ID]: { mimeTypes: [RESOURCE_MIME_TYPE] } }
   });
-  const resources = views.map(
-    ({ artifact, html }) => registerAppResource(
+  const resources = views.map(({ artifact, html }) => {
+    const resourceMeta = {
+      ui: artifact.declaration._meta.ui
+    };
+    const openaiUi = artifact.declaration._meta["openai/ui"];
+    if (openaiUi !== void 0) resourceMeta["openai/ui"] = openaiUi;
+    return registerAppResource(
       server,
       artifact.name,
       artifact.uri,
       {
         mimeType: artifact.declaration.mimeType,
         description: artifact.declaration.description,
-        _meta: { ui: artifact.declaration._meta.ui }
+        _meta: resourceMeta
       },
       async () => ({
         contents: [
@@ -132,12 +137,12 @@ async function registerMcpApps(server, options) {
             uri: artifact.uri,
             mimeType: artifact.declaration.mimeType,
             text: html,
-            _meta: { ui: artifact.declaration._meta.ui }
+            _meta: resourceMeta
           }
         ]
       })
-    )
-  );
+    );
+  });
   const tools = (options.tools ?? []).map((registration) => {
     const { meta, withoutUi, visibility } = mergedToolMetadata(registration);
     const config = registration.config ?? {};