mountly-mcp 4.0.2 → 4.2.0

package/dist/cli.js

@@ -1,8 +1,12 @@
 #!/usr/bin/env node
+import {
+  CLI_ERROR_CODES,
+  cliError
+} from "./chunk-EOWAWZH2.js";
 import {
   startDevHost
-} from "./chunk-KWVGW5Q7.js";
-import "./chunk-UECZA34Q.js";
+} from "./chunk-GN2IQYV3.js";
+import "./chunk-OWAXBNZA.js";
 import "./chunk-YJA4H6IB.js";
 
 // src/cli.ts
@@ -14,7 +18,13 @@ function parseArgs(argv) {
     const arg = argv[i];
     const next = () => {
       const value = argv[i + 1];
-      if (value === void 0) throw new Error(`mountly-mcp: ${arg} needs a value`);
+      if (value === void 0) {
+        throw cliError(
+          CLI_ERROR_CODES.UNKNOWN_OPTION,
+          `${arg} needs a value`,
+          "See: mountly-mcp --help"
+        );
+      }
       i += 1;
       return value;
     };
@@ -27,7 +37,13 @@ function parseArgs(argv) {
     else if (arg === "--help" || arg === "-h") {
       printUsage();
       process.exit(0);
-    } else throw new Error(`mountly-mcp: unknown option '${arg}'`);
+    } else {
+      throw cliError(
+        CLI_ERROR_CODES.UNKNOWN_OPTION,
+        `unknown option '${arg}'`,
+        "See: mountly-mcp --help"
+      );
+    }
   }
   return args;
 }
@@ -37,7 +53,13 @@ function parseVerifyArgs(argv) {
     const arg = argv[i];
     const next = () => {
       const value = argv[i + 1];
-      if (value === void 0) throw new Error(`mountly-mcp: ${arg} needs a value`);
+      if (value === void 0) {
+        throw cliError(
+          CLI_ERROR_CODES.UNKNOWN_OPTION,
+          `${arg} needs a value`,
+          "See: mountly-mcp --help"
+        );
+      }
       i += 1;
       return value;
     };
@@ -46,10 +68,20 @@ function parseVerifyArgs(argv) {
     else if (arg === "--strict") args.strict = true;
     else if (arg === "--render") args.render = true;
     else if (arg === "--json") args.json = true;
-    else throw new Error(`mountly-mcp: unknown verify option '${arg}'`);
+    else {
+      throw cliError(
+        CLI_ERROR_CODES.UNKNOWN_OPTION,
+        `unknown verify option '${arg}'`,
+        "Options: --manifest --html --strict --render --json"
+      );
+    }
   }
   if (args.manifest && args.html.length > 0) {
-    throw new Error("mountly-mcp: verify accepts either --manifest or --html, not both");
+    throw cliError(
+      CLI_ERROR_CODES.UNKNOWN_OPTION,
+      "verify accepts either --manifest or --html, not both",
+      "Use: mountly-mcp verify   OR   mountly-mcp verify --html dist/dashboard.html"
+    );
   }
   return args;
 }
@@ -59,26 +91,46 @@ function parseBuildArgs(argv) {
     const arg = argv[i];
     if (arg === "--config" || arg === "-c") {
       const value = argv[i + 1];
-      if (value === void 0) throw new Error(`mountly-mcp: ${arg} needs a value`);
+      if (value === void 0) {
+        throw cliError(
+          CLI_ERROR_CODES.UNKNOWN_OPTION,
+          `${arg} needs a value`,
+          "Example: mountly-mcp build --config ./vite.config.ts"
+        );
+      }
       args.config = value;
       i += 1;
-    } else throw new Error(`mountly-mcp: unknown build option '${arg}'`);
+    } else {
+      throw cliError(
+        CLI_ERROR_CODES.UNKNOWN_OPTION,
+        `unknown build option '${arg}'`,
+        "Options: --config"
+      );
+    }
   }
   return args;
 }
 function printUsage() {
-  process.stdout.write(`mountly-mcp \u2014 create, build, develop, and verify MCP Apps
+  process.stdout.write(`mountly-mcp \u2014 create, add, build, develop, doctor, and verify MCP Apps
 
 Usage:
   mountly-mcp create <name> [options]
+  mountly-mcp add <name> [options]
   mountly-mcp build [options]
   mountly-mcp dev [options]
   mountly-mcp verify [options]
+  mountly-mcp doctor
 
 Create options:
-  -f, --framework <name>  react | vue | svelte (default: react)
+  -f, --framework <name>  react | vue | svelte | vanilla (default: react)
       --dir <path>        output directory (default: ./<name>)
 
+Add options (second View in an existing project):
+  -f, --framework <name>  react | vue | svelte | vanilla (default: detect)
+      --entry <path>      View entry (default: src/<name>.tsx|ts)
+      --uri <ui://...>    resource URI (default: ui://app/<name>)
+  -c, --config <path>     vite config (default: auto)
+
 Dev / build options:
   -c, --config <path>    vite config to read the View from (default: auto)
   -f, --fixtures <path>  JSON of named samples (default: mcp.fixtures.json)
@@ -126,8 +178,10 @@ async function loadViewOptions(configFile, appName) {
   const { loadConfigFromFile } = await import("vite");
   const loaded = await loadConfigFromFile({ command: "build", mode: "development" }, configFile);
   if (!loaded) {
-    throw new Error(
-      "mountly-mcp: no vite config found. Pass --config, or add mountlyMcpViews() to vite.config.ts."
+    throw cliError(
+      CLI_ERROR_CODES.NO_VITE_CONFIG,
+      "no vite config found",
+      "Pass --config, or add mountlyMcpViews() to vite.config.ts. Or: npx mountly-mcp create my-app"
     );
   }
   const plugins = (loaded.config.plugins ?? []).flat(
@@ -135,20 +189,26 @@ async function loadViewOptions(configFile, appName) {
   );
   const plugin = plugins.find((p) => p?.api?.mountlyMcp);
   if (!plugin?.api?.mountlyMcp) {
-    throw new Error(
-      `mountly-mcp: no mountlyMcpViews() plugin in ${loaded.path}. Add it to the plugins array.`
+    throw cliError(
+      CLI_ERROR_CODES.MISSING_VITE_PLUGIN,
+      `no mountlyMcpViews() plugin in ${loaded.path}`,
+      `Add mountlyMcpViews({ apps: [...] }) from "mountly-mcp/vite" to ${loaded.path}`
     );
   }
   const apps = plugin.api.mountlyMcp.apps;
   if (apps.length > 1 && appName === void 0) {
-    throw new Error(
-      `mountly-mcp: this build contains several Views; pass --app <name>. Available: ${apps.map((app) => app.name).join(", ")}`
+    throw cliError(
+      CLI_ERROR_CODES.MULTI_VIEW_NEEDS_APP,
+      "this build contains several Views",
+      `Pass --app <name>. Available: ${apps.map((app) => app.name).join(", ")}`
     );
   }
   const selected = appName === void 0 ? apps[0] : apps.find((app) => app.name === appName);
   if (!selected) {
-    throw new Error(
-      `mountly-mcp: no View named '${String(appName)}'. Available: ${apps.map((app) => app.name).join(", ")}`
+    throw cliError(
+      CLI_ERROR_CODES.UNKNOWN_VIEW,
+      `no View named '${String(appName)}'`,
+      `Available: ${apps.map((app) => app.name).join(", ")}`
     );
   }
   return {
@@ -220,12 +280,14 @@ async function dev(args) {
     void (async () => {
       await waitForFile(`${htmlPath}.meta.json`);
       if (args.server) {
-        const { connectMcpServer } = await import("./connect-server-7L4HGKKL.js");
+        const { connectMcpServer } = await import("./connect-server-P2UZ62YC.js");
         server = await connectMcpServer(args.server);
         toolName = await server.toolFor(options.uri);
         if (!toolName) {
-          throw new Error(
-            `mountly-mcp: server '${args.server}' has no tool linked to View '${options.uri}'`
+          throw cliError(
+            CLI_ERROR_CODES.NO_TOOL_FOR_VIEW,
+            `server '${args.server}' has no tool linked to View '${options.uri}'`,
+            `In registerMcpApps tools[], set resourceUri: "${options.uri}" on a model-visible tool`
           );
         }
       }
@@ -282,12 +344,22 @@ async function main() {
     const { createProject, parseCreateArgs } = await import("./create.js");
     return createProject(parseCreateArgs(rest));
   }
+  if (command === "add") {
+    const { addView, parseAddArgs } = await import("./add-DAFMA4F3.js");
+    return addView(parseAddArgs(rest));
+  }
+  if (command === "doctor") {
+    const { doctorCommand } = await import("./doctor-B54H6CRN.js");
+    return doctorCommand();
+  }
   if (command === "dev") return dev(parseArgs(rest));
   if (command === "build") return buildApps(parseBuildArgs(rest));
   if (command === "verify") return verify(parseVerifyArgs(rest));
-  process.stderr.write(`mountly-mcp: unknown command '${command}'. Try 'mountly-mcp --help'.
-`);
-  process.exit(1);
+  throw cliError(
+    CLI_ERROR_CODES.UNKNOWN_COMMAND,
+    `unknown command '${command}'`,
+    "Try: mountly-mcp create | add | build | dev | verify | doctor"
+  );
 }
 main().catch((error) => {
   process.stderr.write(`${error instanceof Error ? error.message : String(error)}

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * `mountly-mcp dev` — build the View, serve it in a real sandboxed MCP Apps\n * host, and rebuild on change.\n *\n * Config comes from the `mountlyMcpViews()` plugin already in vite.config.ts,\n * so there is nothing new to configure.\n */\nimport { readFile } from \"node:fs/promises\";\nimport { resolve } from \"node:path\";\nimport { startDevHost } from \"./dev/index.js\";\nimport type { ConnectedMcpServer } from \"./dev/connect-server.js\";\nimport type { MountlyMcpViteApi, MountlyMcpViewOptions } from \"./vite/index.js\";\n\ninterface Args {\n  config?: string;\n  fixtures?: string;\n  server?: string;\n  app?: string;\n  port?: number;\n  open: boolean;\n}\n\ninterface VerifyArgs {\n  manifest?: string;\n  html: string[];\n  strict: boolean;\n  render: boolean;\n  json: boolean;\n}\n\ninterface BuildArgs {\n  config?: string;\n}\n\nfunction parseArgs(argv: ReadonlyArray<string>): Args {\n  const args: Args = { open: true };\n  for (let i = 0; i < argv.length; i += 1) {\n    const arg = argv[i];\n    const next = (): string => {\n      const value = argv[i + 1];\n      if (value === undefined) throw new Error(`mountly-mcp: ${arg} needs a value`);\n      i += 1;\n      return value;\n    };\n    if (arg === \"--config\" || arg === \"-c\") args.config = next();\n    else if (arg === \"--fixtures\" || arg === \"-f\") args.fixtures = next();\n    else if (arg === \"--server\" || arg === \"-s\") args.server = next();\n    else if (arg === \"--app\" || arg === \"-a\") args.app = next();\n    else if (arg === \"--port\" || arg === \"-p\") args.port = Number(next());\n    else if (arg === \"--no-open\") args.open = false;\n    else if (arg === \"--help\" || arg === \"-h\") {\n      printUsage();\n      process.exit(0);\n    } else throw new Error(`mountly-mcp: unknown option '${arg}'`);\n  }\n  return args;\n}\n\nfunction parseVerifyArgs(argv: ReadonlyArray<string>): VerifyArgs {\n  const args: VerifyArgs = { html: [], strict: false, render: false, json: false };\n  for (let i = 0; i < argv.length; i += 1) {\n    const arg = argv[i];\n    const next = (): string => {\n      const value = argv[i + 1];\n      if (value === undefined) throw new Error(`mountly-mcp: ${arg} needs a value`);\n      i += 1;\n      return value;\n    };\n    if (arg === \"--manifest\" || arg === \"-m\") args.manifest = next();\n    else if (arg === \"--html\") args.html.push(next());\n    else if (arg === \"--strict\") args.strict = true;\n    else if (arg === \"--render\") args.render = true;\n    else if (arg === \"--json\") args.json = true;\n    else throw new Error(`mountly-mcp: unknown verify option '${arg}'`);\n  }\n  if (args.manifest && args.html.length > 0) {\n    throw new Error(\"mountly-mcp: verify accepts either --manifest or --html, not both\");\n  }\n  return args;\n}\n\nfunction parseBuildArgs(argv: ReadonlyArray<string>): BuildArgs {\n  const args: BuildArgs = {};\n  for (let i = 0; i < argv.length; i += 1) {\n    const arg = argv[i];\n    if (arg === \"--config\" || arg === \"-c\") {\n      const value = argv[i + 1];\n      if (value === undefined) throw new Error(`mountly-mcp: ${arg} needs a value`);\n      args.config = value;\n      i += 1;\n    } else throw new Error(`mountly-mcp: unknown build option '${arg}'`);\n  }\n  return args;\n}\n\nfunction printUsage(): void {\n  process.stdout.write(`mountly-mcp — create, build, develop, and verify MCP Apps\n\nUsage:\n  mountly-mcp create <name> [options]\n  mountly-mcp build [options]\n  mountly-mcp dev [options]\n  mountly-mcp verify [options]\n\nCreate options:\n  -f, --framework <name>  react | vue | svelte (default: react)\n      --dir <path>        output directory (default: ./<name>)\n\nDev / build options:\n  -c, --config <path>    vite config to read the View from (default: auto)\n  -f, --fixtures <path>  JSON of named samples (default: mcp.fixtures.json)\n  -s, --server <path>    module default-exporting your MCP server, to call real tools\n  -a, --app <name>       View to develop (required when the manifest has several)\n  -p, --port <number>    host port (default: 5179; the sandbox takes the next one)\n      --no-open          don't open a browser\n  -h, --help             show this\n\nVerify options:\n  -m, --manifest <path>  manifest to verify (default: dist/mountly-mcp.manifest.json)\n      --html <path>      transitional single-View HTML; repeat for several\n      --strict           fail when warnings are present\n      --render           require each View to mount with content in Chromium (needs playwright)\n      --json             output the conformance report as JSON\n\nGreenfield: prefer \\`mountly-mcp create\\` — do not clone the Mountly monorepo.\n\nThe View's entry, uri and name come from the mountlyMcpViews() plugin in\nyour vite config, so there is nothing extra to configure.\n\nWithout --server each fixture value is delivered as structuredContent. With\n--server it is the tool's arguments instead, the view receives what the real\ntool returns, and tool calls the view makes itself are routed to your server.\n`);\n}\n\nasync function buildApps(args: BuildArgs): Promise<void> {\n  const { createBuilder } = await import(\"vite\");\n  const builder = await createBuilder({ configFile: args.config }, false);\n  await builder.buildApp();\n}\n\nasync function verify(args: VerifyArgs): Promise<void> {\n  const { formatConformanceReport, verifyMcpApps } = await import(\"./testing/index.js\");\n  const report = await verifyMcpApps({\n    manifestPath: args.manifest,\n    htmlPaths: args.html.length > 0 ? args.html : undefined,\n    render: args.render,\n  });\n  process.stdout.write(\n    args.json ? JSON.stringify(report, null, 2) : formatConformanceReport(report),\n  );\n  if (!report.ok || (args.strict && report.diagnostics.length > 0)) process.exitCode = 1;\n}\n\n/**\n * Read the View's options back out of the vite config. The plugin publishes\n * them on `api.mountlyMcp`, so this stays correct if its option shape changes.\n */\nasync function loadViewOptions(\n  configFile: string | undefined,\n  appName: string | undefined,\n): Promise<{ options: MountlyMcpViewOptions; outDir: string; root: string }> {\n  const { loadConfigFromFile } = await import(\"vite\");\n  const loaded = await loadConfigFromFile({ command: \"build\", mode: \"development\" }, configFile);\n  if (!loaded) {\n    throw new Error(\n      \"mountly-mcp: no vite config found. Pass --config, or add mountlyMcpViews() to vite.config.ts.\",\n    );\n  }\n  // Flattened as unknown[]: vite's PluginOption is recursively nested, and\n  // asking TS to flatten it by its own type sends the checker infinite.\n  const plugins = ((loaded.config.plugins ?? []) as unknown[]).flat(\n    Number.POSITIVE_INFINITY,\n  ) as Array<{ name?: string; api?: { mountlyMcp?: MountlyMcpViteApi } } | null>;\n  const plugin = plugins.find((p) => p?.api?.mountlyMcp);\n  if (!plugin?.api?.mountlyMcp) {\n    throw new Error(\n      `mountly-mcp: no mountlyMcpViews() plugin in ${loaded.path}. Add it to the plugins array.`,\n    );\n  }\n  const apps = plugin.api.mountlyMcp.apps;\n  if (apps.length > 1 && appName === undefined) {\n    throw new Error(\n      `mountly-mcp: this build contains several Views; pass --app <name>. Available: ${apps.map((app) => app.name).join(\", \")}`,\n    );\n  }\n  const selected = appName === undefined ? apps[0] : apps.find((app) => app.name === appName);\n  if (!selected) {\n    throw new Error(\n      `mountly-mcp: no View named '${String(appName)}'. Available: ${apps.map((app) => app.name).join(\", \")}`,\n    );\n  }\n  return {\n    options: selected,\n    outDir: (loaded.config.build?.outDir as string | undefined) ?? \"dist\",\n    root: (loaded.config.root as string | undefined) ?? process.cwd(),\n  };\n}\n\n/**\n * Vite empties the out dir at the start of every build and the plugin writes\n * the resource in `closeBundle`, so the watcher's END event can arrive while\n * the files are still missing. Wait for the artifact rather than trusting the\n * event ordering — this also covers a build that failed and wrote nothing.\n */\nasync function waitForFile(path: string, timeoutMs = 15_000): Promise<void> {\n  const deadline = Date.now() + timeoutMs;\n  for (;;) {\n    try {\n      await readFile(path);\n      return;\n    } catch {\n      if (Date.now() > deadline) throw new Error(`mountly-mcp: timed out waiting for ${path}`);\n      await new Promise((done) => setTimeout(done, 50));\n    }\n  }\n}\n\nasync function loadFixtures(path: string | undefined): Promise<Record<string, unknown>> {\n  const file = path ?? \"mcp.fixtures.json\";\n  try {\n    return JSON.parse(await readFile(resolve(file), \"utf8\")) as Record<string, unknown>;\n  } catch (error) {\n    // An explicit --fixtures that doesn't load is a mistake worth reporting;\n    // the default one simply being absent is not.\n    if (path) throw new Error(`mountly-mcp: could not read fixtures '${file}': ${String(error)}`);\n    return {};\n  }\n}\n\nasync function dev(args: Args): Promise<void> {\n  const { options, outDir, root } = await loadViewOptions(args.config, args.app);\n  const fixtures = await loadFixtures(args.fixtures);\n\n  // Connected after the first build, not here: a server module typically reads\n  // the View it serves, which does not exist yet on a cold checkout.\n  let server: ConnectedMcpServer | undefined;\n  let toolName: string | undefined;\n\n  const { build } = await import(\"vite\");\n  const htmlPath = options.output\n    ? resolve(root, options.output)\n    : resolve(root, outDir, `${options.name}.html`);\n\n  // A watching build: vite rebuilds on change, and each rebuild bumps the\n  // version the browser is polling, which reloads it.\n  let host: Awaited<ReturnType<typeof startDevHost>> | undefined;\n  let started = false;\n\n  const previousSelectedApp = process.env.MOUNTLY_MCP_SELECTED_APP;\n  process.env.MOUNTLY_MCP_SELECTED_APP = options.name;\n  const watcher = await build({\n    configFile: args.config ?? undefined,\n    build: { watch: {} },\n    logLevel: \"warn\",\n  }).finally(() => {\n    if (previousSelectedApp === undefined) delete process.env.MOUNTLY_MCP_SELECTED_APP;\n    else process.env.MOUNTLY_MCP_SELECTED_APP = previousSelectedApp;\n  });\n\n  // `build({ watch })` returns a rollup watcher; the first BUNDLE_END means the\n  // View exists on disk and the host has something to serve.\n  const rollupWatcher = watcher as unknown as {\n    on(event: \"event\", cb: (e: { code: string; error?: Error }) => void): void;\n    close(): Promise<void>;\n  };\n\n  rollupWatcher.on(\"event\", (event) => {\n    if (event.code === \"ERROR\") {\n      process.stderr.write(`mountly-mcp: build failed — ${event.error?.message ?? \"unknown\"}\\n`);\n      return;\n    }\n    if (event.code !== \"END\") return;\n    if (started) {\n      void waitForFile(`${htmlPath}.meta.json`).then(\n        () => {\n          host?.reload();\n          process.stdout.write(\"mountly-mcp: rebuilt\\n\");\n        },\n        (error: unknown) => process.stderr.write(`${String(error)}\\n`),\n      );\n      return;\n    }\n    started = true;\n    void (async () => {\n      await waitForFile(`${htmlPath}.meta.json`);\n      if (args.server) {\n        const { connectMcpServer } = await import(\"./dev/connect-server.js\");\n        server = await connectMcpServer(args.server);\n        toolName = await server.toolFor(options.uri);\n        if (!toolName) {\n          throw new Error(\n            `mountly-mcp: server '${args.server}' has no tool linked to View '${options.uri}'`,\n          );\n        }\n      }\n      host = await startDevHost({\n        htmlPath,\n        fixtures,\n        toolInput: {},\n        toolName,\n        callTool: server?.callTool,\n        hostPort: args.port,\n      });\n      process.stdout.write(\n        `\\n  mountly-mcp dev\\n` +\n          `  host     ${host.hostUrl}\\n` +\n          `  sandbox  ${host.sandboxUrl}\\n` +\n          `  view     ${htmlPath}\\n` +\n          `  fixtures ${Object.keys(fixtures).length || \"none — pass --fixtures\"}\\n` +\n          `  server   ${server ? `${args.server} → ${toolName ?? \"no tool bound to \" + options.uri}` : \"none — fixtures deliver directly\"}\\n\\n` +\n          `  watching for changes; ctrl+c to stop\\n\\n`,\n      );\n      if (args.open) {\n        const { spawn } = await import(\"node:child_process\");\n        const opener =\n          process.platform === \"darwin\"\n            ? \"open\"\n            : process.platform === \"win32\"\n              ? \"start\"\n              : \"xdg-open\";\n        spawn(opener, [host.hostUrl], { stdio: \"ignore\", detached: true, shell: true }).unref();\n      }\n    })().catch((error: unknown) => {\n      // Startup runs inside a watcher callback, where a rejection would\n      // otherwise be silent and leave the process alive with no host.\n      process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`);\n      void Promise.all([rollupWatcher.close(), server?.close()]).finally(() => process.exit(1));\n    });\n  });\n\n  const shutdown = (): void => {\n    void (async () => {\n      await rollupWatcher.close();\n      await host?.close();\n      await server?.close();\n      process.exit(0);\n    })();\n  };\n  process.on(\"SIGINT\", shutdown);\n  process.on(\"SIGTERM\", shutdown);\n}\n\nasync function main(): Promise<void> {\n  const [command, ...rest] = process.argv.slice(2);\n  if (command === undefined || command === \"--help\" || command === \"-h\") {\n    printUsage();\n    process.exit(command === undefined ? 1 : 0);\n  }\n  if (command === \"create\") {\n    const { createProject, parseCreateArgs } = await import(\"./create.js\");\n    return createProject(parseCreateArgs(rest));\n  }\n  if (command === \"dev\") return dev(parseArgs(rest));\n  if (command === \"build\") return buildApps(parseBuildArgs(rest));\n  if (command === \"verify\") return verify(parseVerifyArgs(rest));\n  process.stderr.write(`mountly-mcp: unknown command '${command}'. Try 'mountly-mcp --help'.\\n`);\n  process.exit(1);\n}\n\nmain().catch((error: unknown) => {\n  process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`);\n  process.exit(1);\n});\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * `mountly-mcp` — create, add, build, develop, doctor, and verify MCP Apps.\n *\n * Config for build/dev comes from `mountlyMcpViews()` in vite.config.ts.\n */\nimport { readFile } from \"node:fs/promises\";\nimport { resolve } from \"node:path\";\nimport { startDevHost } from \"./dev/index.js\";\nimport type { ConnectedMcpServer } from \"./dev/connect-server.js\";\nimport { CLI_ERROR_CODES, cliError } from \"./errors.js\";\nimport type { MountlyMcpViteApi, MountlyMcpViewOptions } from \"./vite/index.js\";\n\ninterface Args {\n  config?: string;\n  fixtures?: string;\n  server?: string;\n  app?: string;\n  port?: number;\n  open: boolean;\n}\n\ninterface VerifyArgs {\n  manifest?: string;\n  html: string[];\n  strict: boolean;\n  render: boolean;\n  json: boolean;\n}\n\ninterface BuildArgs {\n  config?: string;\n}\n\nfunction parseArgs(argv: ReadonlyArray<string>): Args {\n  const args: Args = { open: true };\n  for (let i = 0; i < argv.length; i += 1) {\n    const arg = argv[i];\n    const next = (): string => {\n      const value = argv[i + 1];\n      if (value === undefined) {\n        throw cliError(\n          CLI_ERROR_CODES.UNKNOWN_OPTION,\n          `${arg} needs a value`,\n          \"See: mountly-mcp --help\",\n        );\n      }\n      i += 1;\n      return value;\n    };\n    if (arg === \"--config\" || arg === \"-c\") args.config = next();\n    else if (arg === \"--fixtures\" || arg === \"-f\") args.fixtures = next();\n    else if (arg === \"--server\" || arg === \"-s\") args.server = next();\n    else if (arg === \"--app\" || arg === \"-a\") args.app = next();\n    else if (arg === \"--port\" || arg === \"-p\") args.port = Number(next());\n    else if (arg === \"--no-open\") args.open = false;\n    else if (arg === \"--help\" || arg === \"-h\") {\n      printUsage();\n      process.exit(0);\n    } else {\n      throw cliError(\n        CLI_ERROR_CODES.UNKNOWN_OPTION,\n        `unknown option '${arg}'`,\n        \"See: mountly-mcp --help\",\n      );\n    }\n  }\n  return args;\n}\n\nfunction parseVerifyArgs(argv: ReadonlyArray<string>): VerifyArgs {\n  const args: VerifyArgs = { html: [], strict: false, render: false, json: false };\n  for (let i = 0; i < argv.length; i += 1) {\n    const arg = argv[i];\n    const next = (): string => {\n      const value = argv[i + 1];\n      if (value === undefined) {\n        throw cliError(\n          CLI_ERROR_CODES.UNKNOWN_OPTION,\n          `${arg} needs a value`,\n          \"See: mountly-mcp --help\",\n        );\n      }\n      i += 1;\n      return value;\n    };\n    if (arg === \"--manifest\" || arg === \"-m\") args.manifest = next();\n    else if (arg === \"--html\") args.html.push(next());\n    else if (arg === \"--strict\") args.strict = true;\n    else if (arg === \"--render\") args.render = true;\n    else if (arg === \"--json\") args.json = true;\n    else {\n      throw cliError(\n        CLI_ERROR_CODES.UNKNOWN_OPTION,\n        `unknown verify option '${arg}'`,\n        \"Options: --manifest --html --strict --render --json\",\n      );\n    }\n  }\n  if (args.manifest && args.html.length > 0) {\n    throw cliError(\n      CLI_ERROR_CODES.UNKNOWN_OPTION,\n      \"verify accepts either --manifest or --html, not both\",\n      \"Use: mountly-mcp verify   OR   mountly-mcp verify --html dist/dashboard.html\",\n    );\n  }\n  return args;\n}\n\nfunction parseBuildArgs(argv: ReadonlyArray<string>): BuildArgs {\n  const args: BuildArgs = {};\n  for (let i = 0; i < argv.length; i += 1) {\n    const arg = argv[i];\n    if (arg === \"--config\" || arg === \"-c\") {\n      const value = argv[i + 1];\n      if (value === undefined) {\n        throw cliError(\n          CLI_ERROR_CODES.UNKNOWN_OPTION,\n          `${arg} needs a value`,\n          \"Example: mountly-mcp build --config ./vite.config.ts\",\n        );\n      }\n      args.config = value;\n      i += 1;\n    } else {\n      throw cliError(\n        CLI_ERROR_CODES.UNKNOWN_OPTION,\n        `unknown build option '${arg}'`,\n        \"Options: --config\",\n      );\n    }\n  }\n  return args;\n}\n\nfunction printUsage(): void {\n  process.stdout.write(`mountly-mcp — create, add, build, develop, doctor, and verify MCP Apps\n\nUsage:\n  mountly-mcp create <name> [options]\n  mountly-mcp add <name> [options]\n  mountly-mcp build [options]\n  mountly-mcp dev [options]\n  mountly-mcp verify [options]\n  mountly-mcp doctor\n\nCreate options:\n  -f, --framework <name>  react | vue | svelte | vanilla (default: react)\n      --dir <path>        output directory (default: ./<name>)\n\nAdd options (second View in an existing project):\n  -f, --framework <name>  react | vue | svelte | vanilla (default: detect)\n      --entry <path>      View entry (default: src/<name>.tsx|ts)\n      --uri <ui://...>    resource URI (default: ui://app/<name>)\n  -c, --config <path>     vite config (default: auto)\n\nDev / build options:\n  -c, --config <path>    vite config to read the View from (default: auto)\n  -f, --fixtures <path>  JSON of named samples (default: mcp.fixtures.json)\n  -s, --server <path>    module default-exporting your MCP server, to call real tools\n  -a, --app <name>       View to develop (required when the manifest has several)\n  -p, --port <number>    host port (default: 5179; the sandbox takes the next one)\n      --no-open          don't open a browser\n  -h, --help             show this\n\nVerify options:\n  -m, --manifest <path>  manifest to verify (default: dist/mountly-mcp.manifest.json)\n      --html <path>      transitional single-View HTML; repeat for several\n      --strict           fail when warnings are present\n      --render           require each View to mount with content in Chromium (needs playwright)\n      --json             output the conformance report as JSON\n\nGreenfield: prefer \\`mountly-mcp create\\` — do not clone the Mountly monorepo.\n\nThe View's entry, uri and name come from the mountlyMcpViews() plugin in\nyour vite config, so there is nothing extra to configure.\n\nWithout --server each fixture value is delivered as structuredContent. With\n--server it is the tool's arguments instead, the view receives what the real\ntool returns, and tool calls the view makes itself are routed to your server.\n`);\n}\n\nasync function buildApps(args: BuildArgs): Promise<void> {\n  const { createBuilder } = await import(\"vite\");\n  const builder = await createBuilder({ configFile: args.config }, false);\n  await builder.buildApp();\n}\n\nasync function verify(args: VerifyArgs): Promise<void> {\n  const { formatConformanceReport, verifyMcpApps } = await import(\"./testing/index.js\");\n  const report = await verifyMcpApps({\n    manifestPath: args.manifest,\n    htmlPaths: args.html.length > 0 ? args.html : undefined,\n    render: args.render,\n  });\n  process.stdout.write(\n    args.json ? JSON.stringify(report, null, 2) : formatConformanceReport(report),\n  );\n  if (!report.ok || (args.strict && report.diagnostics.length > 0)) process.exitCode = 1;\n}\n\n/**\n * Read the View's options back out of the vite config. The plugin publishes\n * them on `api.mountlyMcp`, so this stays correct if its option shape changes.\n */\nasync function loadViewOptions(\n  configFile: string | undefined,\n  appName: string | undefined,\n): Promise<{ options: MountlyMcpViewOptions; outDir: string; root: string }> {\n  const { loadConfigFromFile } = await import(\"vite\");\n  const loaded = await loadConfigFromFile({ command: \"build\", mode: \"development\" }, configFile);\n  if (!loaded) {\n    throw cliError(\n      CLI_ERROR_CODES.NO_VITE_CONFIG,\n      \"no vite config found\",\n      \"Pass --config, or add mountlyMcpViews() to vite.config.ts. Or: npx mountly-mcp create my-app\",\n    );\n  }\n  // Flattened as unknown[]: vite's PluginOption is recursively nested, and\n  // asking TS to flatten it by its own type sends the checker infinite.\n  const plugins = ((loaded.config.plugins ?? []) as unknown[]).flat(\n    Number.POSITIVE_INFINITY,\n  ) as Array<{ name?: string; api?: { mountlyMcp?: MountlyMcpViteApi } } | null>;\n  const plugin = plugins.find((p) => p?.api?.mountlyMcp);\n  if (!plugin?.api?.mountlyMcp) {\n    throw cliError(\n      CLI_ERROR_CODES.MISSING_VITE_PLUGIN,\n      `no mountlyMcpViews() plugin in ${loaded.path}`,\n      `Add mountlyMcpViews({ apps: [...] }) from \"mountly-mcp/vite\" to ${loaded.path}`,\n    );\n  }\n  const apps = plugin.api.mountlyMcp.apps;\n  if (apps.length > 1 && appName === undefined) {\n    throw cliError(\n      CLI_ERROR_CODES.MULTI_VIEW_NEEDS_APP,\n      \"this build contains several Views\",\n      `Pass --app <name>. Available: ${apps.map((app) => app.name).join(\", \")}`,\n    );\n  }\n  const selected = appName === undefined ? apps[0] : apps.find((app) => app.name === appName);\n  if (!selected) {\n    throw cliError(\n      CLI_ERROR_CODES.UNKNOWN_VIEW,\n      `no View named '${String(appName)}'`,\n      `Available: ${apps.map((app) => app.name).join(\", \")}`,\n    );\n  }\n  return {\n    options: selected,\n    outDir: (loaded.config.build?.outDir as string | undefined) ?? \"dist\",\n    root: (loaded.config.root as string | undefined) ?? process.cwd(),\n  };\n}\n\n/**\n * Vite empties the out dir at the start of every build and the plugin writes\n * the resource in `closeBundle`, so the watcher's END event can arrive while\n * the files are still missing. Wait for the artifact rather than trusting the\n * event ordering — this also covers a build that failed and wrote nothing.\n */\nasync function waitForFile(path: string, timeoutMs = 15_000): Promise<void> {\n  const deadline = Date.now() + timeoutMs;\n  for (;;) {\n    try {\n      await readFile(path);\n      return;\n    } catch {\n      if (Date.now() > deadline) throw new Error(`mountly-mcp: timed out waiting for ${path}`);\n      await new Promise((done) => setTimeout(done, 50));\n    }\n  }\n}\n\nasync function loadFixtures(path: string | undefined): Promise<Record<string, unknown>> {\n  const file = path ?? \"mcp.fixtures.json\";\n  try {\n    return JSON.parse(await readFile(resolve(file), \"utf8\")) as Record<string, unknown>;\n  } catch (error) {\n    // An explicit --fixtures that doesn't load is a mistake worth reporting;\n    // the default one simply being absent is not.\n    if (path) throw new Error(`mountly-mcp: could not read fixtures '${file}': ${String(error)}`);\n    return {};\n  }\n}\n\nasync function dev(args: Args): Promise<void> {\n  const { options, outDir, root } = await loadViewOptions(args.config, args.app);\n  const fixtures = await loadFixtures(args.fixtures);\n\n  // Connected after the first build, not here: a server module typically reads\n  // the View it serves, which does not exist yet on a cold checkout.\n  let server: ConnectedMcpServer | undefined;\n  let toolName: string | undefined;\n\n  const { build } = await import(\"vite\");\n  const htmlPath = options.output\n    ? resolve(root, options.output)\n    : resolve(root, outDir, `${options.name}.html`);\n\n  // A watching build: vite rebuilds on change, and each rebuild bumps the\n  // version the browser is polling, which reloads it.\n  let host: Awaited<ReturnType<typeof startDevHost>> | undefined;\n  let started = false;\n\n  const previousSelectedApp = process.env.MOUNTLY_MCP_SELECTED_APP;\n  process.env.MOUNTLY_MCP_SELECTED_APP = options.name;\n  const watcher = await build({\n    configFile: args.config ?? undefined,\n    build: { watch: {} },\n    logLevel: \"warn\",\n  }).finally(() => {\n    if (previousSelectedApp === undefined) delete process.env.MOUNTLY_MCP_SELECTED_APP;\n    else process.env.MOUNTLY_MCP_SELECTED_APP = previousSelectedApp;\n  });\n\n  // `build({ watch })` returns a rollup watcher; the first BUNDLE_END means the\n  // View exists on disk and the host has something to serve.\n  const rollupWatcher = watcher as unknown as {\n    on(event: \"event\", cb: (e: { code: string; error?: Error }) => void): void;\n    close(): Promise<void>;\n  };\n\n  rollupWatcher.on(\"event\", (event) => {\n    if (event.code === \"ERROR\") {\n      process.stderr.write(`mountly-mcp: build failed — ${event.error?.message ?? \"unknown\"}\\n`);\n      return;\n    }\n    if (event.code !== \"END\") return;\n    if (started) {\n      void waitForFile(`${htmlPath}.meta.json`).then(\n        () => {\n          host?.reload();\n          process.stdout.write(\"mountly-mcp: rebuilt\\n\");\n        },\n        (error: unknown) => process.stderr.write(`${String(error)}\\n`),\n      );\n      return;\n    }\n    started = true;\n    void (async () => {\n      await waitForFile(`${htmlPath}.meta.json`);\n      if (args.server) {\n        const { connectMcpServer } = await import(\"./dev/connect-server.js\");\n        server = await connectMcpServer(args.server);\n        toolName = await server.toolFor(options.uri);\n        if (!toolName) {\n          throw cliError(\n            CLI_ERROR_CODES.NO_TOOL_FOR_VIEW,\n            `server '${args.server}' has no tool linked to View '${options.uri}'`,\n            `In registerMcpApps tools[], set resourceUri: \"${options.uri}\" on a model-visible tool`,\n          );\n        }\n      }\n      host = await startDevHost({\n        htmlPath,\n        fixtures,\n        toolInput: {},\n        toolName,\n        callTool: server?.callTool,\n        hostPort: args.port,\n      });\n      process.stdout.write(\n        `\\n  mountly-mcp dev\\n` +\n          `  host     ${host.hostUrl}\\n` +\n          `  sandbox  ${host.sandboxUrl}\\n` +\n          `  view     ${htmlPath}\\n` +\n          `  fixtures ${Object.keys(fixtures).length || \"none — pass --fixtures\"}\\n` +\n          `  server   ${server ? `${args.server} → ${toolName ?? \"no tool bound to \" + options.uri}` : \"none — fixtures deliver directly\"}\\n\\n` +\n          `  watching for changes; ctrl+c to stop\\n\\n`,\n      );\n      if (args.open) {\n        const { spawn } = await import(\"node:child_process\");\n        const opener =\n          process.platform === \"darwin\"\n            ? \"open\"\n            : process.platform === \"win32\"\n              ? \"start\"\n              : \"xdg-open\";\n        spawn(opener, [host.hostUrl], { stdio: \"ignore\", detached: true, shell: true }).unref();\n      }\n    })().catch((error: unknown) => {\n      // Startup runs inside a watcher callback, where a rejection would\n      // otherwise be silent and leave the process alive with no host.\n      process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`);\n      void Promise.all([rollupWatcher.close(), server?.close()]).finally(() => process.exit(1));\n    });\n  });\n\n  const shutdown = (): void => {\n    void (async () => {\n      await rollupWatcher.close();\n      await host?.close();\n      await server?.close();\n      process.exit(0);\n    })();\n  };\n  process.on(\"SIGINT\", shutdown);\n  process.on(\"SIGTERM\", shutdown);\n}\n\nasync function main(): Promise<void> {\n  const [command, ...rest] = process.argv.slice(2);\n  if (command === undefined || command === \"--help\" || command === \"-h\") {\n    printUsage();\n    process.exit(command === undefined ? 1 : 0);\n  }\n  if (command === \"create\") {\n    const { createProject, parseCreateArgs } = await import(\"./create.js\");\n    return createProject(parseCreateArgs(rest));\n  }\n  if (command === \"add\") {\n    const { addView, parseAddArgs } = await import(\"./add.js\");\n    return addView(parseAddArgs(rest));\n  }\n  if (command === \"doctor\") {\n    const { doctorCommand } = await import(\"./doctor.js\");\n    return doctorCommand();\n  }\n  if (command === \"dev\") return dev(parseArgs(rest));\n  if (command === \"build\") return buildApps(parseBuildArgs(rest));\n  if (command === \"verify\") return verify(parseVerifyArgs(rest));\n  throw cliError(\n    CLI_ERROR_CODES.UNKNOWN_COMMAND,\n    `unknown command '${command}'`,\n    \"Try: mountly-mcp create | add | build | dev | verify | doctor\",\n  );\n}\n\nmain().catch((error: unknown) => {\n  process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`);\n  process.exit(1);\n});\n"],"mappings":"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","names":[]}

package/dist/compose/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Show a page composed from many teams' custom elements inside an MCP host.
+ *
+ * The agent is the composer: `show_page` carries the catalog's prompt as its
+ * description, the agent calls it with a tree, the server validates (or
+ * repairs) it, and the `ui://` view renders it with `mountly-compose` — each
+ * team's code loading on first use. When the user acts in a widget, the view
+ * sends the agent its next turn, with the current page, so it edits rather than
+ * starts over.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Catalog } from "mountly-compose";
+export interface ComposeViewOptions {
+    /**
+     * The view's import map. Must map `mountly-compose` and
+     * `@modelcontextprotocol/ext-apps` (its `app-with-deps` build), plus
+     * whatever the teams' peer embeds import: `react`, `react/jsx-runtime`,
+     * `react-dom/client`, `mountly-react`, `mountly/embed`.
+     */
+    imports: Record<string, string>;
+    /** The page's own CSS: host layout (`ui-stack`, `ui-grid`, `ui-note`) and design tokens. */
+    styles?: string;
+    /** Document title. */
+    title?: string;
+}
+export interface RegisterComposeAppOptions extends ComposeViewOptions {
+    catalog: Catalog;
+    /** MCP tool name. Default `show_page`. */
+    name?: string;
+    /** `ui://` resource for the view. */
+    resourceUri?: string;
+    /** Appended to the tool description: what the agent may fill ids from, house rules. */
+    instructions?: string;
+}
+/** The view HTML: an import map, the host's CSS, and a module that renders tool results. */
+export declare function composeViewHtml(options: ComposeViewOptions): string;
+/**
+ * Register the `show_page` tool and its `ui://` view on an MCP server.
+ *
+ * The input is `{ page }`, typed loosely on purpose: a strict schema would make
+ * the SDK reject a near-miss before the handler could repair it. The handler
+ * validates against the catalog, strips small mistakes, and otherwise returns
+ * the reasons as a tool error the agent can act on.
+ */
+export declare function registerComposeApp(server: McpServer, options: RegisterComposeAppOptions): {
+    tool: string;
+    resourceUri: string;
+};

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/connect-server-P2UZ62YC.js

@@ -0,0 +1,7 @@
+import {
+  connectMcpServer
+} from "./chunk-OWAXBNZA.js";
+export {
+  connectMcpServer
+};
+//# sourceMappingURL=connect-server-P2UZ62YC.js.map

package/dist/create.js

@@ -1,3 +1,8 @@
+import {
+  CLI_ERROR_CODES,
+  cliError
+} from "./chunk-EOWAWZH2.js";
+
 // src/create.ts
 import {
   cpSync,
@@ -23,8 +28,10 @@ var SUPPORTED = ["react", "vue", "svelte", "vanilla"];
 function parseCreateArgs(argv) {
   const name = argv[0];
   if (!name || name.startsWith("-")) {
-    throw new Error(
-      "mountly-mcp create requires a project name. e.g. mountly-mcp create my-app --framework react"
+    throw cliError(
+      CLI_ERROR_CODES.UNKNOWN_OPTION,
+      "create requires a project name",
+      "Example: mountly-mcp create my-app --framework react"
     );
   }
   let framework = "react";
@@ -33,19 +40,37 @@ function parseCreateArgs(argv) {
     const arg = argv[i];
     if (arg === "--framework" || arg === "-f") {
       const value = argv[++i];
-      if (value === void 0) throw new Error(`mountly-mcp: ${arg} needs a value`);
+      if (value === void 0) {
+        throw cliError(
+          CLI_ERROR_CODES.UNKNOWN_OPTION,
+          `${arg} needs a value`,
+          `Available: ${SUPPORTED.join(", ")}`
+        );
+      }
       if (!SUPPORTED.includes(value)) {
-        throw new Error(
-          `mountly-mcp: framework "${value}" not supported. Available: ${SUPPORTED.join(", ")}`
+        throw cliError(
+          CLI_ERROR_CODES.UNKNOWN_OPTION,
+          `framework "${value}" not supported`,
+          `Available: ${SUPPORTED.join(", ")}`
         );
       }
       framework = value;
     } else if (arg === "--dir") {
       const value = argv[++i];
-      if (value === void 0) throw new Error("mountly-mcp: --dir needs a value");
+      if (value === void 0) {
+        throw cliError(
+          CLI_ERROR_CODES.UNKNOWN_OPTION,
+          "--dir needs a value",
+          "Example: --dir ./apps/my-app"
+        );
+      }
       dir = value;
     } else {
-      throw new Error(`mountly-mcp: unknown create option '${arg}'`);
+      throw cliError(
+        CLI_ERROR_CODES.UNKNOWN_OPTION,
+        `unknown create option '${arg}'`,
+        "Options: --framework | --dir"
+      );
     }
   }
   return { name, framework, dir };
@@ -72,12 +97,18 @@ function renderTemplates(dir, ctx) {
 async function createProject(args) {
   const target = resolve(args.dir);
   if (existsSync(target)) {
-    throw new Error(`mountly-mcp: target directory already exists: ${target}`);
+    throw cliError(
+      CLI_ERROR_CODES.TARGET_EXISTS,
+      `target directory already exists: ${target}`,
+      "Choose another --dir, or remove the existing folder"
+    );
   }
   const tplDir = join(TEMPLATES, args.framework);
   if (!existsSync(tplDir)) {
-    throw new Error(
-      `mountly-mcp: template for framework "${args.framework}" is missing at ${tplDir}`
+    throw cliError(
+      CLI_ERROR_CODES.MISSING_TEMPLATE,
+      `template for framework "${args.framework}" is missing at ${tplDir}`,
+      `Available: ${SUPPORTED.join(", ")}`
     );
   }
   mkdirSync(target, { recursive: true });
@@ -95,13 +126,10 @@ async function createProject(args) {
       "",
       `\u2713 Created MCP App ${args.name} (${args.framework}) at ${target}`,
       "",
-      "Next steps:",
+      "Next:",
       `  cd ${args.dir}`,
       "  pnpm install",
-      "  pnpm dev          # sandboxed host + live reload",
-      "  pnpm verify       # conformance check",
-      "",
-      "Do not clone the Mountly monorepo for greenfield apps \u2014 this scaffold is the canonical path.",
+      "  pnpm dev",
       ""
     ].join("\n")
   );