mountly-mcp 4.0.2 → 4.2.0

package/dist/create.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/create.ts"],"sourcesContent":["import {\n  cpSync,\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  readdirSync,\n  statSync,\n  unlinkSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n/** Package root: dist/cli.js → .. ; src/cli.ts during tests → .. when run via dist. */\nconst PACKAGE_ROOT = resolve(__dirname, \"..\");\nconst TEMPLATES = resolve(PACKAGE_ROOT, \"templates\");\n\n/**\n * The version of mountly-mcp doing the scaffolding, so the generated\n * package.json pins the API this CLI actually ships.\n *\n * Hardcoding the pin in the templates meant a major release left them behind:\n * `^3.1.0` cannot resolve to 4.0.0, so every scaffolded app installed a\n * package without the exports its own vite.config imported.\n */\nfunction ownVersion(): string {\n  const pkg = JSON.parse(readFileSync(join(PACKAGE_ROOT, \"package.json\"), \"utf8\")) as {\n    version?: string;\n  };\n  if (!pkg.version) throw new Error(\"mountly-mcp: cannot read own version from package.json\");\n  return pkg.version;\n}\n\nconst SUPPORTED = [\"react\", \"vue\", \"svelte\", \"vanilla\"] as const;\ntype Framework = (typeof SUPPORTED)[number];\n\nexport interface CreateArgs {\n  name: string;\n  framework: Framework;\n  dir: string;\n}\n\nexport function parseCreateArgs(argv: ReadonlyArray<string>): CreateArgs {\n  const name = argv[0];\n  if (!name || name.startsWith(\"-\")) {\n    throw new Error(\n      \"mountly-mcp create requires a project name. e.g. mountly-mcp create my-app --framework react\",\n    );\n  }\n\n  let framework: Framework = \"react\";\n  let dir = `./${name}`;\n\n  for (let i = 1; i < argv.length; i += 1) {\n    const arg = argv[i];\n    if (arg === \"--framework\" || arg === \"-f\") {\n      const value = argv[++i];\n      if (value === undefined) throw new Error(`mountly-mcp: ${arg} needs a value`);\n      if (!SUPPORTED.includes(value as Framework)) {\n        throw new Error(\n          `mountly-mcp: framework \"${value}\" not supported. Available: ${SUPPORTED.join(\", \")}`,\n        );\n      }\n      framework = value as Framework;\n    } else if (arg === \"--dir\") {\n      const value = argv[++i];\n      if (value === undefined) throw new Error(\"mountly-mcp: --dir needs a value\");\n      dir = value;\n    } else {\n      throw new Error(`mountly-mcp: unknown create option '${arg}'`);\n    }\n  }\n\n  return { name, framework, dir };\n}\n\nfunction slugify(name: string): string {\n  return name\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n}\n\nfunction renderTemplates(dir: string, ctx: Record<string, string>): void {\n  for (const entry of readdirSync(dir)) {\n    const full = join(dir, entry);\n    if (statSync(full).isDirectory()) {\n      renderTemplates(full, ctx);\n      continue;\n    }\n    if (!entry.endsWith(\".tmpl\")) continue;\n    let content = readFileSync(full, \"utf8\");\n    for (const [key, value] of Object.entries(ctx)) {\n      content = content.split(`{{${key}}}`).join(value);\n    }\n    writeFileSync(full.replace(/\\.tmpl$/, \"\"), content);\n    unlinkSync(full);\n  }\n}\n\nexport async function createProject(args: CreateArgs): Promise<void> {\n  const target = resolve(args.dir);\n  if (existsSync(target)) {\n    throw new Error(`mountly-mcp: target directory already exists: ${target}`);\n  }\n\n  const tplDir = join(TEMPLATES, args.framework);\n  if (!existsSync(tplDir)) {\n    throw new Error(\n      `mountly-mcp: template for framework \"${args.framework}\" is missing at ${tplDir}`,\n    );\n  }\n\n  mkdirSync(target, { recursive: true });\n  cpSync(tplDir, target, { recursive: true });\n\n  const slug = slugify(args.name) || \"app\";\n  renderTemplates(target, {\n    name: args.name,\n    slug,\n    uri: `ui://${slug}/dashboard`,\n    framework: args.framework,\n    mcpVersion: ownVersion(),\n  });\n\n  process.stdout.write(\n    [\n      \"\",\n      `✓ Created MCP App ${args.name} (${args.framework}) at ${target}`,\n      \"\",\n      \"Next steps:\",\n      `  cd ${args.dir}`,\n      \"  pnpm install\",\n      \"  pnpm dev          # sandboxed host + live reload\",\n      \"  pnpm verify       # conformance check\",\n      \"\",\n      \"Do not clone the Mountly monorepo for greenfield apps — this scaffold is the canonical path.\",\n      \"\",\n    ].join(\"\\n\"),\n  );\n}\n"],"mappings":";AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,SAAS,MAAM,eAAe;AACvC,SAAS,qBAAqB;AAE9B,IAAM,YAAY,QAAQ,cAAc,YAAY,GAAG,CAAC;AAExD,IAAM,eAAe,QAAQ,WAAW,IAAI;AAC5C,IAAM,YAAY,QAAQ,cAAc,WAAW;AAUnD,SAAS,aAAqB;AAC5B,QAAM,MAAM,KAAK,MAAM,aAAa,KAAK,cAAc,cAAc,GAAG,MAAM,CAAC;AAG/E,MAAI,CAAC,IAAI,QAAS,OAAM,IAAI,MAAM,wDAAwD;AAC1F,SAAO,IAAI;AACb;AAEA,IAAM,YAAY,CAAC,SAAS,OAAO,UAAU,SAAS;AAS/C,SAAS,gBAAgB,MAAyC;AACvE,QAAM,OAAO,KAAK,CAAC;AACnB,MAAI,CAAC,QAAQ,KAAK,WAAW,GAAG,GAAG;AACjC,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,MAAI,YAAuB;AAC3B,MAAI,MAAM,KAAK,IAAI;AAEnB,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK,GAAG;AACvC,UAAM,MAAM,KAAK,CAAC;AAClB,QAAI,QAAQ,iBAAiB,QAAQ,MAAM;AACzC,YAAM,QAAQ,KAAK,EAAE,CAAC;AACtB,UAAI,UAAU,OAAW,OAAM,IAAI,MAAM,gBAAgB,GAAG,gBAAgB;AAC5E,UAAI,CAAC,UAAU,SAAS,KAAkB,GAAG;AAC3C,cAAM,IAAI;AAAA,UACR,2BAA2B,KAAK,+BAA+B,UAAU,KAAK,IAAI,CAAC;AAAA,QACrF;AAAA,MACF;AACA,kBAAY;AAAA,IACd,WAAW,QAAQ,SAAS;AAC1B,YAAM,QAAQ,KAAK,EAAE,CAAC;AACtB,UAAI,UAAU,OAAW,OAAM,IAAI,MAAM,kCAAkC;AAC3E,YAAM;AAAA,IACR,OAAO;AACL,YAAM,IAAI,MAAM,uCAAuC,GAAG,GAAG;AAAA,IAC/D;AAAA,EACF;AAEA,SAAO,EAAE,MAAM,WAAW,IAAI;AAChC;AAEA,SAAS,QAAQ,MAAsB;AACrC,SAAO,KACJ,KAAK,EACL,YAAY,EACZ,QAAQ,eAAe,GAAG,EAC1B,QAAQ,YAAY,EAAE;AAC3B;AAEA,SAAS,gBAAgB,KAAa,KAAmC;AACvE,aAAW,SAAS,YAAY,GAAG,GAAG;AACpC,UAAM,OAAO,KAAK,KAAK,KAAK;AAC5B,QAAI,SAAS,IAAI,EAAE,YAAY,GAAG;AAChC,sBAAgB,MAAM,GAAG;AACzB;AAAA,IACF;AACA,QAAI,CAAC,MAAM,SAAS,OAAO,EAAG;AAC9B,QAAI,UAAU,aAAa,MAAM,MAAM;AACvC,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,GAAG,GAAG;AAC9C,gBAAU,QAAQ,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,KAAK;AAAA,IAClD;AACA,kBAAc,KAAK,QAAQ,WAAW,EAAE,GAAG,OAAO;AAClD,eAAW,IAAI;AAAA,EACjB;AACF;AAEA,eAAsB,cAAc,MAAiC;AACnE,QAAM,SAAS,QAAQ,KAAK,GAAG;AAC/B,MAAI,WAAW,MAAM,GAAG;AACtB,UAAM,IAAI,MAAM,iDAAiD,MAAM,EAAE;AAAA,EAC3E;AAEA,QAAM,SAAS,KAAK,WAAW,KAAK,SAAS;AAC7C,MAAI,CAAC,WAAW,MAAM,GAAG;AACvB,UAAM,IAAI;AAAA,MACR,wCAAwC,KAAK,SAAS,mBAAmB,MAAM;AAAA,IACjF;AAAA,EACF;AAEA,YAAU,QAAQ,EAAE,WAAW,KAAK,CAAC;AACrC,SAAO,QAAQ,QAAQ,EAAE,WAAW,KAAK,CAAC;AAE1C,QAAM,OAAO,QAAQ,KAAK,IAAI,KAAK;AACnC,kBAAgB,QAAQ;AAAA,IACtB,MAAM,KAAK;AAAA,IACX;AAAA,IACA,KAAK,QAAQ,IAAI;AAAA,IACjB,WAAW,KAAK;AAAA,IAChB,YAAY,WAAW;AAAA,EACzB,CAAC;AAED,UAAQ,OAAO;AAAA,IACb;AAAA,MACE;AAAA,MACA,0BAAqB,KAAK,IAAI,KAAK,KAAK,SAAS,QAAQ,MAAM;AAAA,MAC/D;AAAA,MACA;AAAA,MACA,QAAQ,KAAK,GAAG;AAAA,MAChB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,EAAE,KAAK,IAAI;AAAA,EACb;AACF;","names":[]}
+{"version":3,"sources":["../src/create.ts"],"sourcesContent":["import {\n  cpSync,\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  readdirSync,\n  statSync,\n  unlinkSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { CLI_ERROR_CODES, cliError } from \"./errors.js\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n/** Package root: dist/cli.js → .. ; src/cli.ts during tests → .. when run via dist. */\nconst PACKAGE_ROOT = resolve(__dirname, \"..\");\nconst TEMPLATES = resolve(PACKAGE_ROOT, \"templates\");\n\n/**\n * The version of mountly-mcp doing the scaffolding, so the generated\n * package.json pins the API this CLI actually ships.\n *\n * Hardcoding the pin in the templates meant a major release left them behind:\n * `^3.1.0` cannot resolve to 4.0.0, so every scaffolded app installed a\n * package without the exports its own vite.config imported.\n */\nfunction ownVersion(): string {\n  const pkg = JSON.parse(readFileSync(join(PACKAGE_ROOT, \"package.json\"), \"utf8\")) as {\n    version?: string;\n  };\n  if (!pkg.version) throw new Error(\"mountly-mcp: cannot read own version from package.json\");\n  return pkg.version;\n}\n\nconst SUPPORTED = [\"react\", \"vue\", \"svelte\", \"vanilla\"] as const;\ntype Framework = (typeof SUPPORTED)[number];\n\nexport interface CreateArgs {\n  name: string;\n  framework: Framework;\n  dir: string;\n}\n\nexport function parseCreateArgs(argv: ReadonlyArray<string>): CreateArgs {\n  const name = argv[0];\n  if (!name || name.startsWith(\"-\")) {\n    throw cliError(\n      CLI_ERROR_CODES.UNKNOWN_OPTION,\n      \"create requires a project name\",\n      \"Example: mountly-mcp create my-app --framework react\",\n    );\n  }\n\n  let framework: Framework = \"react\";\n  let dir = `./${name}`;\n\n  for (let i = 1; i < argv.length; i += 1) {\n    const arg = argv[i];\n    if (arg === \"--framework\" || arg === \"-f\") {\n      const value = argv[++i];\n      if (value === undefined) {\n        throw cliError(\n          CLI_ERROR_CODES.UNKNOWN_OPTION,\n          `${arg} needs a value`,\n          `Available: ${SUPPORTED.join(\", \")}`,\n        );\n      }\n      if (!SUPPORTED.includes(value as Framework)) {\n        throw cliError(\n          CLI_ERROR_CODES.UNKNOWN_OPTION,\n          `framework \"${value}\" not supported`,\n          `Available: ${SUPPORTED.join(\", \")}`,\n        );\n      }\n      framework = value as Framework;\n    } else if (arg === \"--dir\") {\n      const value = argv[++i];\n      if (value === undefined) {\n        throw cliError(\n          CLI_ERROR_CODES.UNKNOWN_OPTION,\n          \"--dir needs a value\",\n          \"Example: --dir ./apps/my-app\",\n        );\n      }\n      dir = value;\n    } else {\n      throw cliError(\n        CLI_ERROR_CODES.UNKNOWN_OPTION,\n        `unknown create option '${arg}'`,\n        \"Options: --framework | --dir\",\n      );\n    }\n  }\n\n  return { name, framework, dir };\n}\n\nfunction slugify(name: string): string {\n  return name\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n}\n\nfunction renderTemplates(dir: string, ctx: Record<string, string>): void {\n  for (const entry of readdirSync(dir)) {\n    const full = join(dir, entry);\n    if (statSync(full).isDirectory()) {\n      renderTemplates(full, ctx);\n      continue;\n    }\n    if (!entry.endsWith(\".tmpl\")) continue;\n    let content = readFileSync(full, \"utf8\");\n    for (const [key, value] of Object.entries(ctx)) {\n      content = content.split(`{{${key}}}`).join(value);\n    }\n    writeFileSync(full.replace(/\\.tmpl$/, \"\"), content);\n    unlinkSync(full);\n  }\n}\n\nexport async function createProject(args: CreateArgs): Promise<void> {\n  const target = resolve(args.dir);\n  if (existsSync(target)) {\n    throw cliError(\n      CLI_ERROR_CODES.TARGET_EXISTS,\n      `target directory already exists: ${target}`,\n      \"Choose another --dir, or remove the existing folder\",\n    );\n  }\n\n  const tplDir = join(TEMPLATES, args.framework);\n  if (!existsSync(tplDir)) {\n    throw cliError(\n      CLI_ERROR_CODES.MISSING_TEMPLATE,\n      `template for framework \"${args.framework}\" is missing at ${tplDir}`,\n      `Available: ${SUPPORTED.join(\", \")}`,\n    );\n  }\n\n  mkdirSync(target, { recursive: true });\n  cpSync(tplDir, target, { recursive: true });\n\n  const slug = slugify(args.name) || \"app\";\n  renderTemplates(target, {\n    name: args.name,\n    slug,\n    uri: `ui://${slug}/dashboard`,\n    framework: args.framework,\n    mcpVersion: ownVersion(),\n  });\n\n  process.stdout.write(\n    [\n      \"\",\n      `✓ Created MCP App ${args.name} (${args.framework}) at ${target}`,\n      \"\",\n      \"Next:\",\n      `  cd ${args.dir}`,\n      \"  pnpm install\",\n      \"  pnpm dev\",\n      \"\",\n    ].join(\"\\n\"),\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/dev/host-entry.js

@@ -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,10 +1,10 @@
 import {
   sandboxProxyHtml,
   startDevHost
-} from "../chunk-KWVGW5Q7.js";
+} from "../chunk-GN2IQYV3.js";
 import {
   connectMcpServer
-} from "../chunk-UECZA34Q.js";
+} from "../chunk-OWAXBNZA.js";
 import "../chunk-YJA4H6IB.js";
 export {
   connectMcpServer,

package/dist/doctor-B54H6CRN.js

@@ -0,0 +1,122 @@
+import {
+  CLI_ERROR_CODES,
+  cliError
+} from "./chunk-EOWAWZH2.js";
+
+// src/doctor.ts
+import { existsSync, readFileSync } from "fs";
+import { createRequire } from "module";
+import { resolve } from "path";
+function nodeMajor() {
+  return Number(process.versions.node.split(".")[0] ?? 0);
+}
+function tryResolve(specifier, fromDir) {
+  try {
+    const require2 = createRequire(resolve(fromDir, "package.json"));
+    return require2.resolve(specifier);
+  } catch {
+    return null;
+  }
+}
+function runDoctor(cwd = process.cwd()) {
+  const checks = [];
+  const major = nodeMajor();
+  checks.push({
+    id: "node",
+    ok: major >= 20,
+    detail: major >= 20 ? `Node ${process.versions.node} (ok; 20+ required, 22+ recommended)` : `Node ${process.versions.node} is below 20. Upgrade Node, then re-run mountly-mcp doctor.`
+  });
+  const viteConfigCandidates = [
+    "vite.config.ts",
+    "vite.config.mts",
+    "vite.config.js",
+    "vite.config.mjs"
+  ].map((name) => resolve(cwd, name));
+  const viteConfig = viteConfigCandidates.find((path) => existsSync(path));
+  checks.push({
+    id: "vite-config",
+    ok: Boolean(viteConfig),
+    detail: viteConfig ? `Found ${viteConfig}` : "No vite.config.* in this directory. Run from the View project, or: npx mountly-mcp create my-app --framework react"
+  });
+  if (viteConfig) {
+    const source = readFileSync(viteConfig, "utf8");
+    const hasPlugin = /mountlyMcpViews\s*\(/.test(source);
+    checks.push({
+      id: "vite-plugin",
+      ok: hasPlugin,
+      detail: hasPlugin ? "vite config imports mountlyMcpViews()" : `Add mountlyMcpViews() from "mountly-mcp/vite" to ${viteConfig}`
+    });
+  }
+  const manifest = resolve(cwd, "dist/mountly-mcp.manifest.json");
+  checks.push({
+    id: "manifest",
+    ok: existsSync(manifest),
+    detail: existsSync(manifest) ? `Found ${manifest}` : "No dist/mountly-mcp.manifest.json yet. Run: npx mountly-mcp build"
+  });
+  const playwright = tryResolve("playwright", cwd) ?? tryResolve("@playwright/test", cwd);
+  checks.push({
+    id: "playwright",
+    ok: Boolean(playwright),
+    detail: playwright ? `Playwright resolvable for verify --render (${playwright})` : "Playwright not installed. For CI render checks: pnpm add -D playwright && npx playwright install chromium"
+  });
+  const pkgPath = resolve(cwd, "package.json");
+  if (existsSync(pkgPath)) {
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+    const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+    if (deps.react) {
+      const reactPath = tryResolve("react/package.json", cwd);
+      if (reactPath) {
+        const reactPkg = JSON.parse(readFileSync(reactPath, "utf8"));
+        const reactMajor = Number((reactPkg.version ?? "0").split(".")[0]);
+        checks.push({
+          id: "react",
+          ok: reactMajor >= 19,
+          detail: reactMajor >= 19 ? `React ${reactPkg.version} (ok)` : `React ${reactPkg.version} is below 19. mountly-mcp/react and mountly-react require React 19.`
+        });
+      }
+    }
+    if (deps.vite) {
+      const vitePath = tryResolve("vite/package.json", cwd);
+      if (vitePath) {
+        const vitePkg = JSON.parse(readFileSync(vitePath, "utf8"));
+        const viteMajor = Number((vitePkg.version ?? "0").split(".")[0]);
+        checks.push({
+          id: "vite",
+          ok: viteMajor >= 8,
+          detail: viteMajor >= 8 ? `Vite ${vitePkg.version} (ok)` : `Vite ${vitePkg.version} is below 8. mountly-mcp/vite is built and tested against Vite 8.`
+        });
+      }
+    }
+  }
+  const hard = checks.filter((c) => c.id !== "manifest" && c.id !== "playwright");
+  const ok = hard.every((c) => c.ok);
+  return { ok, checks };
+}
+function formatDoctorReport(report) {
+  const lines = ["mountly-mcp doctor", ""];
+  for (const check of report.checks) {
+    lines.push(`${check.ok ? "ok" : "FAIL"}  ${check.id.padEnd(14)} ${check.detail}`);
+  }
+  lines.push("");
+  lines.push(report.ok ? "Ready for mountly-mcp build / dev / verify." : "Fix FAIL items above.");
+  lines.push("");
+  return `${lines.join("\n")}
+`;
+}
+function doctorCommand(cwd = process.cwd()) {
+  const report = runDoctor(cwd);
+  process.stdout.write(formatDoctorReport(report));
+  if (!report.ok) {
+    throw cliError(
+      CLI_ERROR_CODES.DOCTOR_FAILED,
+      "one or more doctor checks failed",
+      "Fix the FAIL lines above, then re-run: mountly-mcp doctor"
+    );
+  }
+}
+export {
+  doctorCommand,
+  formatDoctorReport,
+  runDoctor
+};
+//# sourceMappingURL=doctor-B54H6CRN.js.map

package/dist/doctor-B54H6CRN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/doctor.ts"],"sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { 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\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  // 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/doctor.d.ts

@@ -0,0 +1,16 @@
+export interface DoctorCheck {
+    id: string;
+    ok: boolean;
+    detail: string;
+}
+export interface DoctorReport {
+    ok: boolean;
+    checks: DoctorCheck[];
+}
+/**
+ * Check the local project for Mountly MCP readiness. Exits nonzero via the
+ * CLI when `ok` is false.
+ */
+export declare function runDoctor(cwd?: string): DoctorReport;
+export declare function formatDoctorReport(report: DoctorReport): string;
+export declare function doctorCommand(cwd?: string): void;

package/dist/errors-4ERW7HZB.js

@@ -0,0 +1,11 @@
+import {
+  CLI_ERROR_CODES,
+  MountlyMcpCliError,
+  cliError
+} from "./chunk-EOWAWZH2.js";
+export {
+  CLI_ERROR_CODES,
+  MountlyMcpCliError,
+  cliError
+};
+//# sourceMappingURL=errors-4ERW7HZB.js.map

package/dist/errors-4ERW7HZB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/errors.d.ts

@@ -0,0 +1,25 @@
+/**
+ * LLM-shaped CLI errors: a stable code plus the next command or file to open.
+ * Skills and agents should key off the `mountly-mcp/…` code prefix.
+ */
+export declare const CLI_ERROR_CODES: {
+    readonly MISSING_VITE_PLUGIN: "mountly-mcp/missing-vite-plugin";
+    readonly NO_VITE_CONFIG: "mountly-mcp/no-vite-config";
+    readonly UNKNOWN_VIEW: "mountly-mcp/unknown-view";
+    readonly MULTI_VIEW_NEEDS_APP: "mountly-mcp/multi-view-needs-app";
+    readonly INVALID_UI_URI: "mountly-mcp/invalid-ui-uri";
+    readonly BAD_SERVER_EXPORT: "mountly-mcp/bad-server-export";
+    readonly NO_TOOL_FOR_VIEW: "mountly-mcp/no-tool-for-view";
+    readonly UNKNOWN_OPTION: "mountly-mcp/unknown-option";
+    readonly UNKNOWN_COMMAND: "mountly-mcp/unknown-command";
+    readonly TARGET_EXISTS: "mountly-mcp/target-exists";
+    readonly MISSING_TEMPLATE: "mountly-mcp/missing-template";
+    readonly DOCTOR_FAILED: "mountly-mcp/doctor-failed";
+};
+export type CliErrorCode = (typeof CLI_ERROR_CODES)[keyof typeof CLI_ERROR_CODES];
+export declare class MountlyMcpCliError extends Error {
+    readonly code: CliErrorCode;
+    readonly next: string;
+    constructor(code: CliErrorCode, message: string, next: string);
+}
+export declare function cliError(code: CliErrorCode, message: string, next: string): MountlyMcpCliError;

package/dist/json-render/index.js

@@ -1,3 +1,7 @@
+import {
+  buildAppHtml,
+  useJsonRenderApp
+} from "../chunk-33DMFKKD.js";
 import {
   createJsonRenderMcpApp,
   registerJsonRenderResource,
@@ -17,10 +21,6 @@ import {
   useToolResult
 } from "../chunk-SXF23BZD.js";
 import "../chunk-5L3QHYWK.js";
-import {
-  buildAppHtml,
-  useJsonRenderApp
-} from "../chunk-33DMFKKD.js";
 import "../chunk-YJA4H6IB.js";
 
 // src/json-render/generative-view.tsx

package/package.json

@@ -1,18 +1,20 @@
 {
   "name": "mountly-mcp",
-  "version": "4.0.2",
+  "version": "4.2.0",
   "description": "Build MCP Apps (SEP-1865) views from React, Vue or Svelte components — new or existing. One build emits the ui:// resource, its sidecar, and the MCP server wiring.",
   "keywords": [
     "chatgpt",
     "claude",
     "mcp",
     "mcp-apps",
+    "mcp-apps-view",
     "mcp-ui",
     "mcp-view",
     "model-context-protocol",
     "react",
     "sep-1865",
     "svelte",
+    "ui-resource",
     "vite-plugin",
     "vue"
   ],
@@ -27,7 +29,8 @@
   },
   "files": [
     "dist",
-    "templates"
+    "templates",
+    "GLOSSARY.md"
   ],
   "type": "module",
   "main": "./dist/index.js",
@@ -66,6 +69,10 @@
       "types": "./dist/json-render/server.d.ts",
       "import": "./dist/json-render/server.js"
     },
+    "./compose": {
+      "types": "./dist/compose/index.d.ts",
+      "import": "./dist/compose/index.js"
+    },
     "./json-render/app": {
       "types": "./dist/json-render/app.d.ts",
       "import": "./dist/json-render/app.js"
@@ -107,7 +114,7 @@
   "dependencies": {
     "@modelcontextprotocol/ext-apps": "^1.7.5",
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "mountly": "^1.0.0",
+    "mountly": "^1.3.0",
     "mountly-react": "^2.1.0",
     "zod": "^4.4.3"
   },
@@ -125,7 +132,8 @@
     "tsup": "^8.5.1",
     "typescript": "^7.0.2",
     "vite": "^8.1.5",
-    "mountly-svelte": "^2.1.0",
+    "mountly-svelte": "^2.1.1",
+    "mountly-compose": "0.1.0",
     "mountly-vue": "^2.1.0"
   },
   "peerDependencies": {
@@ -133,12 +141,13 @@
     "@json-render/react": "^0.20.0",
     "ai": "^7.0.65",
     "axe-core": ">=4.10.0",
+    "mountly-compose": "^0.1.0",
     "mountly-svelte": "^2.1.0",
     "mountly-vue": "^2.1.0",
     "playwright": ">=1.62.1",
     "react": "^19",
     "react-dom": "^19",
-    "vite": "^8.2.1"
+    "vite": "^8"
   },
   "peerDependenciesMeta": {
     "@json-render/core": {
@@ -170,6 +179,9 @@
     },
     "axe-core": {
       "optional": true
+    },
+    "mountly-compose": {
+      "optional": true
     }
   },
   "scripts": {

package/templates/react/README.md.tmpl

@@ -2,14 +2,91 @@
 
 MCP App scaffolded with `mountly-mcp create`.
 
+## Runbook
+
 ```bash
 pnpm install
-pnpm dev      # sandboxed host on :5179
-pnpm verify   # conformance
+pnpm dev                 # sandboxed AppBridge host on :5179 (uses --server ./server.mjs)
+pnpm verify              # static conformance
+pnpm verify:render       # + Chromium mount check (needs Playwright)
+```
+
+| File | Role |
+| --- | --- |
+| `src/view.tsx` | `createMcpView`: View entry; reads tool data via `useToolResult` |
+| `server.mjs` | `registerMcpApps`: factory for `mountly-mcp dev --server` |
+| `serve-stdio.mjs` | Stdio entry for Claude Desktop / VS Code / ChatGPT connectors |
+| `mcp.fixtures.json` | Tool **arguments** when using `--server` |
+| `vite.config.ts` | `mountlyMcpViews({ apps: [...] })` |
+| `dist/mountly-mcp.manifest.json` | Build artifact (after `pnpm build` / first `dev`) |
+
+Do not clone the Mountly monorepo for greenfield apps: this project is the canonical path.
+
+## Open in a real host
+
+`serve-stdio.mjs` is included. Build first (`pnpm build` or run `pnpm dev` once), then point the host at that entry.
+
+Never write logs to **stdout** in a stdio server.
+
+### Claude Desktop
+
+`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):
+
+```json
+{
+  "mcpServers": {
+    "{{slug}}": {
+      "command": "node",
+      "args": ["/ABSOLUTE/PATH/TO/{{name}}/serve-stdio.mjs"]
+    }
+  }
+}
+```
+
+### VS Code
+
+`.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "{{slug}}": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["${workspaceFolder}/serve-stdio.mjs"]
+    }
+  }
+}
 ```
 
-- View: `src/view.tsx` (`createMcpView`)
-- Server: `server.mjs` (`registerMcpApps`)
-- Fixtures: `mcp.fixtures.json` (tool args when using `--server`)
+### ChatGPT
+
+Use a connector / custom MCP that runs the same `serve-stdio.mjs` (or an HTTP transport your deployment owns). Mountly does not own OAuth or hosting.
+
+## CI
+
+```yaml
+# .github/workflows/mcp-verify.yml
+name: mcp-verify
+on: [push, pull_request]
+jobs:
+  verify:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with: { node-version: 22, cache: pnpm }
+      - run: pnpm install
+      - run: pnpm exec mountly-mcp build
+      - run: pnpm exec playwright install chromium
+      - run: pnpm exec mountly-mcp verify --strict --render
+```
+
+## Add another View
+
+```bash
+pnpm exec mountly-mcp add settings --framework react
+```
 
-Do not clone the Mountly monorepo for greenfield apps — this project is the canonical path.
+Then register a tool with matching `resourceUri` in `server.mjs` via `registerMcpApps`.

package/templates/react/package.json.tmpl

@@ -8,6 +8,8 @@
     "dev": "mountly-mcp dev --server ./server.mjs",
     "verify": "mountly-mcp verify",
     "verify:strict": "mountly-mcp verify --strict",
+    "verify:render": "mountly-mcp verify --strict --render",
+    "doctor": "mountly-mcp doctor",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {

package/templates/react/serve-stdio.mjs.tmpl

@@ -0,0 +1,9 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import createServer from "./server.mjs";
+
+/**
+ * Stdio entry for Claude Desktop / VS Code / other MCP hosts.
+ * Never write logs to stdout: stdout is the JSON-RPC channel.
+ */
+const server = await createServer();
+await server.connect(new StdioServerTransport());

package/templates/react/server.mjs.tmpl

@@ -1,3 +1,4 @@
+import { fileURLToPath } from "node:url";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { readMcpAppManifest } from "mountly-mcp/artifact";
 import { registerMcpApps } from "mountly-mcp/server";
@@ -5,6 +6,10 @@ import { z } from "zod";
 
 const URI = "{{uri}}";
 
+// Resolved from this file, not the cwd: an MCP host spawns the process with a
+// working directory of its own choosing.
+const MANIFEST = fileURLToPath(new URL("./dist/mountly-mcp.manifest.json", import.meta.url));
+
 function sampleCards() {
   return [
     { label: "Requests", value: Math.floor(1200 + Math.random() * 200) },
@@ -20,7 +25,7 @@ export default async function createServer() {
     { capabilities: { tools: {}, resources: {} } },
   );
 
-  const { artifacts } = await readMcpAppManifest("dist/mountly-mcp.manifest.json");
+  const { artifacts } = await readMcpAppManifest(MANIFEST);
 
   await registerMcpApps(server, {
     views: artifacts.map((artifact) => ({ artifact })),

package/templates/react/src/view.tsx.tmpl

@@ -130,7 +130,7 @@ function Dashboard() {
       <p className="eyebrow">MCP App · Mountly</p>
       <h1>{title}</h1>
       <p className="subtitle">
-        Built with <code>mountly-mcp</code> — try Refresh to call an app-only tool.
+        Built with <code>mountly-mcp</code>. Try Refresh to call an app-only tool.
       </p>
       <div className="grid">
         {cards.length === 0

package/templates/svelte/README.md.tmpl

@@ -1,14 +1,37 @@
 # {{name}}
 
-MCP App scaffolded with `mountly-mcp create --framework svelte`.
+MCP App scaffolded with `mountly-mcp create` (Svelte).
+
+## Runbook
 
 ```bash
 pnpm install
 pnpm dev
 pnpm verify
+pnpm verify:render
+```
+
+| File | Role |
+| --- | --- |
+| `src/view.ts` | `createMcpView` entry |
+| `src/Dashboard.svelte` | View UI: `toolResult` prop |
+| `server.mjs` | `registerMcpApps` factory |
+| `mcp.fixtures.json` | Tool args for `dev --server` |
+
+## Open in a real host
+
+`serve-stdio.mjs` is included. Point Claude Desktop or VS Code at that entry (stdio). ChatGPT: use your connector against the same process.
+
+## CI
+
+```bash
+pnpm exec mountly-mcp build
+pnpm exec playwright install chromium
+pnpm exec mountly-mcp verify --strict --render
 ```
 
-- View: `src/view.ts` + `src/Dashboard.svelte`
-- Server: `server.mjs` (`registerMcpApps`)
+## Add another View
 
-Do not clone the Mountly monorepo for greenfield apps — this project is the canonical path.
+```bash
+pnpm exec mountly-mcp add settings --framework svelte
+```

package/templates/svelte/package.json.tmpl

@@ -8,6 +8,8 @@
     "dev": "mountly-mcp dev --server ./server.mjs",
     "verify": "mountly-mcp verify",
     "verify:strict": "mountly-mcp verify --strict",
+    "verify:render": "mountly-mcp verify --strict --render",
+    "doctor": "mountly-mcp doctor",
     "typecheck": "svelte-check --tsconfig ./tsconfig.json"
   },
   "dependencies": {

package/templates/svelte/serve-stdio.mjs.tmpl

@@ -0,0 +1,5 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import createServer from "./server.mjs";
+
+const server = await createServer();
+await server.connect(new StdioServerTransport());

package/templates/svelte/server.mjs.tmpl

@@ -1,3 +1,4 @@
+import { fileURLToPath } from "node:url";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { readMcpAppManifest } from "mountly-mcp/artifact";
 import { registerMcpApps } from "mountly-mcp/server";
@@ -5,6 +6,10 @@ import { z } from "zod";
 
 const URI = "{{uri}}";
 
+// Resolved from this file, not the cwd: an MCP host spawns the process with a
+// working directory of its own choosing.
+const MANIFEST = fileURLToPath(new URL("./dist/mountly-mcp.manifest.json", import.meta.url));
+
 function sampleCards() {
   return [
     { label: "Requests", value: Math.floor(1200 + Math.random() * 200) },
@@ -20,7 +25,7 @@ export default async function createServer() {
     { capabilities: { tools: {}, resources: {} } },
   );
 
-  const { artifacts } = await readMcpAppManifest("dist/mountly-mcp.manifest.json");
+  const { artifacts } = await readMcpAppManifest(MANIFEST);
 
   await registerMcpApps(server, {
     views: artifacts.map((artifact) => ({ artifact })),

package/templates/svelte/src/Dashboard.svelte.tmpl

@@ -61,7 +61,7 @@
   <p class="eyebrow">MCP App · Mountly</p>
   <h1>{title}</h1>
   <p class="subtitle">
-    Built with <code>mountly-mcp</code> — try Refresh to call an app-only tool.
+    Built with <code>mountly-mcp</code>. Try Refresh to call an app-only tool.
   </p>
   <div class="grid">
     {#if cards.length === 0}