mountly-mcp 3.1.0 → 4.0.0

package/dist/{chunk-4WAKOYMK.js → chunk-MTJDRWGD.js}

@@ -1,7 +1,7 @@
 import {
   LATEST_PROTOCOL_VERSION,
   RESOURCE_MIME_TYPE
-} from "./chunk-DQLQOMDM.js";
+} from "./chunk-M4WFJR3C.js";
 import {
   escapeInlineScript,
   serializeInlineScriptValue
@@ -193,4 +193,4 @@ export {
   buildMcpResourceFromSource,
   buildMcpResource
 };
-//# sourceMappingURL=chunk-4WAKOYMK.js.map
+//# sourceMappingURL=chunk-MTJDRWGD.js.map

package/dist/chunk-MTJDRWGD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/build/index.ts","../src/build/emit-html.ts","../src/build/emit-meta.ts"],"sourcesContent":["import { readFile, writeFile } from \"node:fs/promises\";\nimport { fileURLToPath } from \"node:url\";\nimport { resolve } from \"node:path\";\nimport type {\n  McpUiDisplayMode,\n  McpUiResourceCsp,\n  McpUiResourcePermissions,\n} from \"@modelcontextprotocol/ext-apps\";\nimport type { McpResourceDeclaration } from \"../types.js\";\nimport type { McpAppArtifact } from \"../artifact/index.js\";\nimport { emitHtml } from \"./emit-html.js\";\nimport { emitMeta } from \"./emit-meta.js\";\n\n/**\n * Absolute path to the iframe bridge runtime shipped with this package.\n *\n * `buildMcpResource` inlines this file's contents into the emitted HTML so\n * the View can speak the MCP Apps postMessage protocol. Use this when you\n * need to point another build tool at the runtime, or when you want a\n * stable, version-pinned alternative to passing `bridgeRuntimePath` yourself.\n *\n * Resolves relative to the installed package, so it works identically in\n * monorepos and in projects that installed mountly-mcp from npm.\n */\nexport function getBridgeRuntimePath(): string {\n  // Ask the module resolver rather than walking up from __dirname: the subpath\n  // is a declared export, so this holds wherever a bundler puts this file.\n  return fileURLToPath(import.meta.resolve(\"mountly-mcp/bridge/iframe-entry.js\"));\n}\n\nfunction defaultBridgeRuntimePath(): string {\n  return getBridgeRuntimePath();\n}\n\nexport interface BuildSelfContainedOptions {\n  entry: string;\n  uri: string;\n  name: string;\n  output: string;\n  description?: string;\n  awaitToolResult?: boolean;\n  displayModes?: ReadonlyArray<McpUiDisplayMode>;\n  /**\n   * Render progressive states from `ui/notifications/tool-input-partial`.\n   * Off by default — see `RunBridgeOptions.streamToolInput`.\n   */\n  streamToolInput?: boolean;\n  csp?: McpUiResourceCsp;\n  /** Sandbox permissions requested by the view (camera/microphone/geolocation/clipboardWrite). */\n  permissions?: McpUiResourcePermissions;\n  /** Dedicated sandbox origin (host-dependent format). */\n  domain?: string;\n  /** Whether the view requests the host to show a visible border + background. */\n  prefersBorder?: boolean;\n  cssEntry?: string;\n  bridgeRuntimePath?: string;\n}\n\nexport interface BuildCdnOptions extends BuildSelfContainedOptions {\n  cdn: { jsUrl: string; cssUrl: string };\n}\n\nexport type BuildOptions = BuildSelfContainedOptions | BuildCdnOptions;\n\nexport interface BuildResult {\n  htmlPath: string;\n  metaPath: string;\n  declaration: McpResourceDeclaration;\n  artifact: McpAppArtifact;\n}\n\nexport interface BuildFromSourceOptions extends Omit<\n  BuildSelfContainedOptions,\n  \"entry\" | \"cssEntry\"\n> {\n  /** The bundled View JS. */\n  js: string;\n  /** The View's CSS, if it has any. */\n  css?: string;\n}\n\n/**\n * Same as {@link buildMcpResource}, but taking the bundle in memory instead of\n * from disk — for bundler plugins that already hold the emitted sources and\n * shouldn't have to guess when they land on the filesystem.\n */\nexport async function buildMcpResourceFromSource(\n  options: BuildFromSourceOptions,\n): Promise<BuildResult> {\n  const { js, css, ...rest } = options;\n  return writeResource({ ...rest, mode: \"self-contained\", js, css: css ?? \"\" });\n}\n\nexport async function buildMcpResource(options: BuildOptions): Promise<BuildResult> {\n  if (!(\"cdn\" in options)) {\n    const js = await readFile(options.entry, \"utf8\");\n    const css = options.cssEntry ? await readFile(options.cssEntry, \"utf8\") : \"\";\n    return writeResource({ ...options, mode: \"self-contained\", js, css });\n  }\n  return writeResource({ ...options, mode: \"cdn\" });\n}\n\ntype ResourceMeta = Omit<BuildSelfContainedOptions, \"entry\" | \"cssEntry\">;\n\ntype WriteResourceOptions =\n  | (ResourceMeta & { mode: \"self-contained\"; js: string; css: string })\n  | (ResourceMeta & { mode: \"cdn\"; cdn: BuildCdnOptions[\"cdn\"] });\n\nasync function writeResource(options: WriteResourceOptions): Promise<BuildResult> {\n  const bridgeRuntimeJs = await readFile(\n    options.bridgeRuntimePath ?? defaultBridgeRuntimePath(),\n    \"utf8\",\n  );\n\n  const declaration = emitMeta({\n    uri: options.uri,\n    name: options.name,\n    description: options.description,\n    awaitToolResult: options.awaitToolResult,\n    displayModes: options.displayModes,\n    csp: options.mode === \"cdn\" ? mergeCdnIntoCsp(options.csp, options.cdn) : options.csp,\n    permissions: options.permissions,\n    domain: options.domain,\n    prefersBorder: options.prefersBorder,\n  });\n\n  // Same values the sidecar declares, so the view's `ui/initialize` matches it.\n  const config = {\n    awaitToolResult: declaration.awaitToolResult,\n    displayModes: declaration.displayModes,\n    streamToolInput: options.streamToolInput ?? false,\n  };\n\n  const html =\n    options.mode === \"cdn\"\n      ? emitHtml({\n          mode: \"cdn\",\n          uri: options.uri,\n          jsUrl: options.cdn.jsUrl,\n          cssUrl: options.cdn.cssUrl,\n          bridgeRuntimeJs,\n          config,\n        })\n      : emitHtml({\n          mode: \"self-contained\",\n          uri: options.uri,\n          js: options.js,\n          css: options.css,\n          bridgeRuntimeJs,\n          config,\n        });\n\n  const metaPath = `${options.output}.meta.json`;\n  await writeFile(options.output, html, \"utf8\");\n  await writeFile(metaPath, JSON.stringify(declaration, null, 2), \"utf8\");\n\n  const htmlPath = resolve(options.output);\n  return {\n    htmlPath,\n    metaPath: resolve(metaPath),\n    declaration,\n    artifact: {\n      name: declaration.name,\n      uri: declaration.uri,\n      htmlPath,\n      metaPath: resolve(metaPath),\n      declaration,\n    },\n  };\n}\n\nfunction mergeCdnIntoCsp(\n  csp: McpUiResourceCsp | undefined,\n  cdn: { jsUrl: string; cssUrl: string },\n): McpUiResourceCsp {\n  const jsOrigin = new URL(cdn.jsUrl).origin;\n  const cssOrigin = new URL(cdn.cssUrl).origin;\n  const merged: McpUiResourceCsp = { ...(csp ?? {}) };\n  const existing = new Set(merged.resourceDomains ?? []);\n  existing.add(jsOrigin);\n  existing.add(cssOrigin);\n  merged.resourceDomains = Array.from(existing);\n  return merged;\n}\n\nexport { emitHtml } from \"./emit-html.js\";\nexport { emitMeta } from \"./emit-meta.js\";\n","import { MCP_APPS_PROTOCOL_VERSION } from \"../schema.js\";\nimport type { McpUiDisplayMode } from \"@modelcontextprotocol/ext-apps\";\nimport { escapeInlineScript, serializeInlineScriptValue } from \"../html.js\";\n\n/**\n * Runtime config the emitted HTML hands to the inlined bridge\n * (`bridge/iframe-entry.ts` reads these off `globalThis`). Without it the view\n * falls back to `awaitToolResult: true` / `availableDisplayModes: [\"inline\"]`,\n * regardless of what the build declared in the sidecar.\n */\nexport interface EmitHtmlConfig {\n  awaitToolResult?: boolean;\n  displayModes?: ReadonlyArray<McpUiDisplayMode>;\n  streamToolInput?: boolean;\n}\n\nexport interface EmitHtmlSelfContainedInput {\n  mode: \"self-contained\";\n  uri: string;\n  js: string;\n  css: string;\n  bridgeRuntimeJs: string;\n  config?: EmitHtmlConfig;\n}\n\nexport interface EmitHtmlCdnInput {\n  mode: \"cdn\";\n  uri: string;\n  jsUrl: string;\n  cssUrl: string;\n  bridgeRuntimeJs: string;\n  config?: EmitHtmlConfig;\n}\n\nexport type EmitHtmlInput = EmitHtmlSelfContainedInput | EmitHtmlCdnInput;\n\nfunction escapeAttr(value: string): string {\n  return value\n    .replace(/&/g, \"&amp;\")\n    .replace(/\"/g, \"&quot;\")\n    .replace(/</g, \"&lt;\")\n    .replace(/>/g, \"&gt;\");\n}\n\nfunction escapeStyle(value: string): string {\n  return value.replace(/<\\/style/gi, \"<\\\\/style\");\n}\n\n/**\n * Classic (non-module) script so it runs at parse time — before the deferred\n * module scripts that boot the bridge.\n */\nfunction configScript(config: EmitHtmlConfig | undefined): string[] {\n  if (!config) return [];\n  const assignments: string[] = [];\n  if (config.awaitToolResult !== undefined) {\n    assignments.push(\n      `globalThis.__mountlyMcpAwaitToolResult__=${serializeInlineScriptValue(config.awaitToolResult)};`,\n    );\n  }\n  if (config.displayModes !== undefined) {\n    assignments.push(\n      `globalThis.__mountlyMcpAvailableDisplayModes__=${serializeInlineScriptValue(config.displayModes)};`,\n    );\n  }\n  if (config.streamToolInput !== undefined) {\n    assignments.push(\n      `globalThis.__mountlyMcpStreamToolInput__=${serializeInlineScriptValue(config.streamToolInput)};`,\n    );\n  }\n  if (assignments.length === 0) return [];\n  return [`<script>${assignments.join(\"\")}</script>`];\n}\n\nexport function emitHtml(input: EmitHtmlInput): string {\n  const head = [\n    `<meta charset=\"utf-8\">`,\n    `<meta name=\"mountly-mcp-protocol\" content=\"${MCP_APPS_PROTOCOL_VERSION}\">`,\n    `<meta name=\"mountly-mcp-uri\" content=\"${escapeAttr(input.uri)}\">`,\n  ];\n\n  if (input.mode === \"self-contained\") {\n    head.push(`<style>${escapeStyle(input.css)}</style>`);\n    const body = [\n      `<div id=\"mountly-mcp-root\"></div>`,\n      ...configScript(input.config),\n      `<script type=\"module\">${escapeInlineScript(input.js)}\\n${escapeInlineScript(input.bridgeRuntimeJs)}</script>`,\n    ];\n    return template(head, body);\n  }\n\n  head.push(`<link rel=\"stylesheet\" href=\"${escapeAttr(input.cssUrl)}\">`);\n  // The View bundle MUST load before the bridge: module scripts execute in\n  // document order, and the bridge reads the published View synchronously.\n  const body = [\n    `<div id=\"mountly-mcp-root\"></div>`,\n    ...configScript(input.config),\n    `<script type=\"module\" src=\"${escapeAttr(input.jsUrl)}\"></script>`,\n    `<script type=\"module\">${escapeInlineScript(input.bridgeRuntimeJs)}</script>`,\n  ];\n  return template(head, body);\n}\n\nfunction template(head: string[], body: string[]): string {\n  return `<!doctype html>\n<html data-mountly-mcp>\n<head>\n${head.join(\"\\n\")}\n</head>\n<body>\n${body.join(\"\\n\")}\n</body>\n</html>`;\n}\n","import { MCP_APPS_MIME, MCP_APPS_PROTOCOL_VERSION } from \"../schema.js\";\nimport type {\n  McpUiDisplayMode,\n  McpUiResourceCsp,\n  McpUiResourcePermissions,\n} from \"@modelcontextprotocol/ext-apps\";\nimport type { McpResourceDeclaration } from \"../types.js\";\n\nexport interface EmitMetaInput {\n  uri: string;\n  name: string;\n  description?: string;\n  awaitToolResult?: boolean;\n  displayModes?: ReadonlyArray<McpUiDisplayMode>;\n  csp?: McpUiResourceCsp;\n  /** Sandbox permissions requested by the view (camera/microphone/geolocation/clipboardWrite). */\n  permissions?: McpUiResourcePermissions;\n  /** Dedicated sandbox origin requested by the view (host-dependent format). */\n  domain?: string;\n  /** Whether the view requests the host to show a visible border + background. */\n  prefersBorder?: boolean;\n}\n\nfunction assertUiUri(uri: string): void {\n  if (!uri.startsWith(\"ui://\")) {\n    throw new Error(`mountly-mcp: UI resource uri must use the 'ui://' scheme (received '${uri}')`);\n  }\n}\n\nexport function emitMeta(input: EmitMetaInput): McpResourceDeclaration {\n  assertUiUri(input.uri);\n\n  const ui: McpResourceDeclaration[\"_meta\"][\"ui\"] = {};\n  if (input.csp) ui.csp = input.csp;\n  if (input.permissions) ui.permissions = input.permissions;\n  if (input.domain !== undefined) ui.domain = input.domain;\n  if (input.prefersBorder !== undefined) ui.prefersBorder = input.prefersBorder;\n\n  const decl: McpResourceDeclaration = {\n    protocolVersion: MCP_APPS_PROTOCOL_VERSION,\n    uri: input.uri,\n    name: input.name,\n    mimeType: MCP_APPS_MIME,\n    awaitToolResult: input.awaitToolResult ?? true,\n    displayModes: input.displayModes ?? [\"inline\"],\n    _meta: { ui },\n  };\n  if (input.description !== undefined) decl.description = input.description;\n  return decl;\n}\n"],"mappings":";;;;;;;;;;AAAA,SAAS,UAAU,iBAAiB;AACpC,SAAS,qBAAqB;AAC9B,SAAS,eAAe;;;ACkCxB,SAAS,WAAW,OAAuB;AACzC,SAAO,MACJ,QAAQ,MAAM,OAAO,EACrB,QAAQ,MAAM,QAAQ,EACtB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,MAAM;AACzB;AAEA,SAAS,YAAY,OAAuB;AAC1C,SAAO,MAAM,QAAQ,cAAc,WAAW;AAChD;AAMA,SAAS,aAAa,QAA8C;AAClE,MAAI,CAAC,OAAQ,QAAO,CAAC;AACrB,QAAM,cAAwB,CAAC;AAC/B,MAAI,OAAO,oBAAoB,QAAW;AACxC,gBAAY;AAAA,MACV,4CAA4C,2BAA2B,OAAO,eAAe,CAAC;AAAA,IAChG;AAAA,EACF;AACA,MAAI,OAAO,iBAAiB,QAAW;AACrC,gBAAY;AAAA,MACV,kDAAkD,2BAA2B,OAAO,YAAY,CAAC;AAAA,IACnG;AAAA,EACF;AACA,MAAI,OAAO,oBAAoB,QAAW;AACxC,gBAAY;AAAA,MACV,4CAA4C,2BAA2B,OAAO,eAAe,CAAC;AAAA,IAChG;AAAA,EACF;AACA,MAAI,YAAY,WAAW,EAAG,QAAO,CAAC;AACtC,SAAO,CAAC,WAAW,YAAY,KAAK,EAAE,CAAC,WAAW;AACpD;AAEO,SAAS,SAAS,OAA8B;AACrD,QAAM,OAAO;AAAA,IACX;AAAA,IACA,8CAA8C,uBAAyB;AAAA,IACvE,yCAAyC,WAAW,MAAM,GAAG,CAAC;AAAA,EAChE;AAEA,MAAI,MAAM,SAAS,kBAAkB;AACnC,SAAK,KAAK,UAAU,YAAY,MAAM,GAAG,CAAC,UAAU;AACpD,UAAMA,QAAO;AAAA,MACX;AAAA,MACA,GAAG,aAAa,MAAM,MAAM;AAAA,MAC5B,yBAAyB,mBAAmB,MAAM,EAAE,CAAC;AAAA,EAAK,mBAAmB,MAAM,eAAe,CAAC;AAAA,IACrG;AACA,WAAO,SAAS,MAAMA,KAAI;AAAA,EAC5B;AAEA,OAAK,KAAK,gCAAgC,WAAW,MAAM,MAAM,CAAC,IAAI;AAGtE,QAAM,OAAO;AAAA,IACX;AAAA,IACA,GAAG,aAAa,MAAM,MAAM;AAAA,IAC5B,8BAA8B,WAAW,MAAM,KAAK,CAAC;AAAA,IACrD,yBAAyB,mBAAmB,MAAM,eAAe,CAAC;AAAA,EACpE;AACA,SAAO,SAAS,MAAM,IAAI;AAC5B;AAEA,SAAS,SAAS,MAAgB,MAAwB;AACxD,SAAO;AAAA;AAAA;AAAA,EAGP,KAAK,KAAK,IAAI,CAAC;AAAA;AAAA;AAAA,EAGf,KAAK,KAAK,IAAI,CAAC;AAAA;AAAA;AAGjB;;;AC1FA,SAAS,YAAY,KAAmB;AACtC,MAAI,CAAC,IAAI,WAAW,OAAO,GAAG;AAC5B,UAAM,IAAI,MAAM,uEAAuE,GAAG,IAAI;AAAA,EAChG;AACF;AAEO,SAAS,SAAS,OAA8C;AACrE,cAAY,MAAM,GAAG;AAErB,QAAM,KAA4C,CAAC;AACnD,MAAI,MAAM,IAAK,IAAG,MAAM,MAAM;AAC9B,MAAI,MAAM,YAAa,IAAG,cAAc,MAAM;AAC9C,MAAI,MAAM,WAAW,OAAW,IAAG,SAAS,MAAM;AAClD,MAAI,MAAM,kBAAkB,OAAW,IAAG,gBAAgB,MAAM;AAEhE,QAAM,OAA+B;AAAA,IACnC,iBAAiB;AAAA,IACjB,KAAK,MAAM;AAAA,IACX,MAAM,MAAM;AAAA,IACZ,UAAU;AAAA,IACV,iBAAiB,MAAM,mBAAmB;AAAA,IAC1C,cAAc,MAAM,gBAAgB,CAAC,QAAQ;AAAA,IAC7C,OAAO,EAAE,GAAG;AAAA,EACd;AACA,MAAI,MAAM,gBAAgB,OAAW,MAAK,cAAc,MAAM;AAC9D,SAAO;AACT;;;AFzBO,SAAS,uBAA+B;AAG7C,SAAO,cAAc,YAAY,QAAQ,oCAAoC,CAAC;AAChF;AAEA,SAAS,2BAAmC;AAC1C,SAAO,qBAAqB;AAC9B;AAsDA,eAAsB,2BACpB,SACsB;AACtB,QAAM,EAAE,IAAI,KAAK,GAAG,KAAK,IAAI;AAC7B,SAAO,cAAc,EAAE,GAAG,MAAM,MAAM,kBAAkB,IAAI,KAAK,OAAO,GAAG,CAAC;AAC9E;AAEA,eAAsB,iBAAiB,SAA6C;AAClF,MAAI,EAAE,SAAS,UAAU;AACvB,UAAM,KAAK,MAAM,SAAS,QAAQ,OAAO,MAAM;AAC/C,UAAM,MAAM,QAAQ,WAAW,MAAM,SAAS,QAAQ,UAAU,MAAM,IAAI;AAC1E,WAAO,cAAc,EAAE,GAAG,SAAS,MAAM,kBAAkB,IAAI,IAAI,CAAC;AAAA,EACtE;AACA,SAAO,cAAc,EAAE,GAAG,SAAS,MAAM,MAAM,CAAC;AAClD;AAQA,eAAe,cAAc,SAAqD;AAChF,QAAM,kBAAkB,MAAM;AAAA,IAC5B,QAAQ,qBAAqB,yBAAyB;AAAA,IACtD;AAAA,EACF;AAEA,QAAM,cAAc,SAAS;AAAA,IAC3B,KAAK,QAAQ;AAAA,IACb,MAAM,QAAQ;AAAA,IACd,aAAa,QAAQ;AAAA,IACrB,iBAAiB,QAAQ;AAAA,IACzB,cAAc,QAAQ;AAAA,IACtB,KAAK,QAAQ,SAAS,QAAQ,gBAAgB,QAAQ,KAAK,QAAQ,GAAG,IAAI,QAAQ;AAAA,IAClF,aAAa,QAAQ;AAAA,IACrB,QAAQ,QAAQ;AAAA,IAChB,eAAe,QAAQ;AAAA,EACzB,CAAC;AAGD,QAAM,SAAS;AAAA,IACb,iBAAiB,YAAY;AAAA,IAC7B,cAAc,YAAY;AAAA,IAC1B,iBAAiB,QAAQ,mBAAmB;AAAA,EAC9C;AAEA,QAAM,OACJ,QAAQ,SAAS,QACb,SAAS;AAAA,IACP,MAAM;AAAA,IACN,KAAK,QAAQ;AAAA,IACb,OAAO,QAAQ,IAAI;AAAA,IACnB,QAAQ,QAAQ,IAAI;AAAA,IACpB;AAAA,IACA;AAAA,EACF,CAAC,IACD,SAAS;AAAA,IACP,MAAM;AAAA,IACN,KAAK,QAAQ;AAAA,IACb,IAAI,QAAQ;AAAA,IACZ,KAAK,QAAQ;AAAA,IACb;AAAA,IACA;AAAA,EACF,CAAC;AAEP,QAAM,WAAW,GAAG,QAAQ,MAAM;AAClC,QAAM,UAAU,QAAQ,QAAQ,MAAM,MAAM;AAC5C,QAAM,UAAU,UAAU,KAAK,UAAU,aAAa,MAAM,CAAC,GAAG,MAAM;AAEtE,QAAM,WAAW,QAAQ,QAAQ,MAAM;AACvC,SAAO;AAAA,IACL;AAAA,IACA,UAAU,QAAQ,QAAQ;AAAA,IAC1B;AAAA,IACA,UAAU;AAAA,MACR,MAAM,YAAY;AAAA,MAClB,KAAK,YAAY;AAAA,MACjB;AAAA,MACA,UAAU,QAAQ,QAAQ;AAAA,MAC1B;AAAA,IACF;AAAA,EACF;AACF;AAEA,SAAS,gBACP,KACA,KACkB;AAClB,QAAM,WAAW,IAAI,IAAI,IAAI,KAAK,EAAE;AACpC,QAAM,YAAY,IAAI,IAAI,IAAI,MAAM,EAAE;AACtC,QAAM,SAA2B,EAAE,GAAI,OAAO,CAAC,EAAG;AAClD,QAAM,WAAW,IAAI,IAAI,OAAO,mBAAmB,CAAC,CAAC;AACrD,WAAS,IAAI,QAAQ;AACrB,WAAS,IAAI,SAAS;AACtB,SAAO,kBAAkB,MAAM,KAAK,QAAQ;AAC5C,SAAO;AACT;","names":["body"]}

package/dist/chunk-SADNMGP6.js

@@ -0,0 +1,16 @@
+// src/publish.ts
+var MCP_VIEW_GLOBAL_KEY = "__mountlyMcpView__";
+function publishMcpView(view) {
+  globalThis[MCP_VIEW_GLOBAL_KEY] = view;
+  return view;
+}
+function getPublishedMcpView() {
+  return globalThis[MCP_VIEW_GLOBAL_KEY];
+}
+
+export {
+  MCP_VIEW_GLOBAL_KEY,
+  publishMcpView,
+  getPublishedMcpView
+};
+//# sourceMappingURL=chunk-SADNMGP6.js.map

package/dist/chunk-SADNMGP6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/publish.ts"],"sourcesContent":["import type { McpView } from \"./types.js\";\n\n/** Internal bridge key — prefer {@link publishMcpView} / `createMcpView`. */\nexport const MCP_VIEW_GLOBAL_KEY = \"__mountlyMcpView__\" as const;\n\n/**\n * Publish a View module for the iframe bridge. Call once from your View entry\n * (or rely on `createMcpView`, which does this for you).\n */\nexport function publishMcpView(view: McpView): McpView {\n  (globalThis as Record<string, unknown>)[MCP_VIEW_GLOBAL_KEY] = view;\n  return view;\n}\n\n/** Read the published View module, if any. */\nexport function getPublishedMcpView(): McpView | undefined {\n  return (globalThis as Record<string, unknown>)[MCP_VIEW_GLOBAL_KEY] as\n    | McpView\n    | undefined;\n}\n"],"mappings":";AAGO,IAAM,sBAAsB;AAM5B,SAAS,eAAe,MAAwB;AACrD,EAAC,WAAuC,mBAAmB,IAAI;AAC/D,SAAO;AACT;AAGO,SAAS,sBAA2C;AACzD,SAAQ,WAAuC,mBAAmB;AAGpE;","names":[]}

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   startDevHost
-} from "./chunk-KRAS266U.js";
+} from "./chunk-KWVGW5Q7.js";
 import "./chunk-UECZA34Q.js";
 import "./chunk-YJA4H6IB.js";
 
@@ -67,15 +67,20 @@ function parseBuildArgs(argv) {
   return args;
 }
 function printUsage() {
-  process.stdout.write(`mountly-mcp \u2014 build, develop, and verify MCP Apps
+  process.stdout.write(`mountly-mcp \u2014 create, build, develop, and verify MCP Apps
 
 Usage:
+  mountly-mcp create <name> [options]
   mountly-mcp build [options]
   mountly-mcp dev [options]
   mountly-mcp verify [options]
 
-Options:
-  -c, --config <path>    vite config to read the widget from (default: auto)
+Create options:
+  -f, --framework <name>  react | vue | svelte (default: react)
+      --dir <path>        output directory (default: ./<name>)
+
+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)
   -s, --server <path>    module default-exporting your MCP server, to call real tools
   -a, --app <name>       View to develop (required when the manifest has several)
@@ -90,7 +95,9 @@ Verify options:
       --render           require each View to mount with content in Chromium (needs playwright)
       --json             output the conformance report as JSON
 
-The widget's entry, uri and name come from the mountlyMcpWidget() plugin in
+Greenfield: prefer \`mountly-mcp create\` \u2014 do not clone the Mountly monorepo.
+
+The View's entry, uri and name come from the mountlyMcpViews() plugin in
 your vite config, so there is nothing extra to configure.
 
 Without --server each fixture value is delivered as structuredContent. With
@@ -115,12 +122,12 @@ async function verify(args) {
   );
   if (!report.ok || args.strict && report.diagnostics.length > 0) process.exitCode = 1;
 }
-async function loadWidgetOptions(configFile, appName) {
+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 mountlyMcpWidget() to vite.config.ts."
+      "mountly-mcp: no vite config found. Pass --config, or add mountlyMcpViews() to vite.config.ts."
     );
   }
   const plugins = (loaded.config.plugins ?? []).flat(
@@ -129,7 +136,7 @@ async function loadWidgetOptions(configFile, appName) {
   const plugin = plugins.find((p) => p?.api?.mountlyMcp);
   if (!plugin?.api?.mountlyMcp) {
     throw new Error(
-      `mountly-mcp: no mountlyMcpWidget() plugin in ${loaded.path}. Add it to the plugins array.`
+      `mountly-mcp: no mountlyMcpViews() plugin in ${loaded.path}. Add it to the plugins array.`
     );
   }
   const apps = plugin.api.mountlyMcp.apps;
@@ -172,7 +179,7 @@ async function loadFixtures(path) {
   }
 }
 async function dev(args) {
-  const { options, outDir, root } = await loadWidgetOptions(args.config, args.app);
+  const { options, outDir, root } = await loadViewOptions(args.config, args.app);
   const fixtures = await loadFixtures(args.fixtures);
   let server;
   let toolName;
@@ -235,7 +242,7 @@ async function dev(args) {
   mountly-mcp dev
   host     ${host.hostUrl}
   sandbox  ${host.sandboxUrl}
-  widget   ${htmlPath}
+  view     ${htmlPath}
   fixtures ${Object.keys(fixtures).length || "none \u2014 pass --fixtures"}
   server   ${server ? `${args.server} \u2192 ${toolName ?? "no tool bound to " + options.uri}` : "none \u2014 fixtures deliver directly"}
 
@@ -271,6 +278,10 @@ async function main() {
     printUsage();
     process.exit(command === void 0 ? 1 : 0);
   }
+  if (command === "create") {
+    const { createProject, parseCreateArgs } = await import("./create.js");
+    return createProject(parseCreateArgs(rest));
+  }
   if (command === "dev") return dev(parseArgs(rest));
   if (command === "build") return buildApps(parseBuildArgs(rest));
   if (command === "verify") return verify(parseVerifyArgs(rest));

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 widget, serve it in a real sandboxed MCP Apps\n * host, and rebuild on change.\n *\n * Config comes from the `mountlyMcpWidget()` 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, MountlyMcpWidgetOptions } 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 — build, develop, and verify MCP Apps\n\nUsage:\n  mountly-mcp build [options]\n  mountly-mcp dev [options]\n  mountly-mcp verify [options]\n\nOptions:\n  -c, --config <path>    vite config to read the widget 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\nThe widget's entry, uri and name come from the mountlyMcpWidget() 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 widget'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 loadWidgetOptions(\n  configFile: string | undefined,\n  appName: string | undefined,\n): Promise<{ options: MountlyMcpWidgetOptions; 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 mountlyMcpWidget() 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 mountlyMcpWidget() 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 loadWidgetOptions(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  // widget 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          `  widget   ${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 === \"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 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":[]}

package/dist/create.d.ts

@@ -0,0 +1,10 @@
+declare const SUPPORTED: readonly ["react", "vue", "svelte"];
+type Framework = (typeof SUPPORTED)[number];
+export interface CreateArgs {
+    name: string;
+    framework: Framework;
+    dir: string;
+}
+export declare function parseCreateArgs(argv: ReadonlyArray<string>): CreateArgs;
+export declare function createProject(args: CreateArgs): Promise<void>;
+export {};

package/dist/create.js

@@ -0,0 +1,107 @@
+// src/create.ts
+import {
+  cpSync,
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  readdirSync,
+  statSync,
+  unlinkSync,
+  writeFileSync
+} from "fs";
+import { dirname, join, resolve } from "path";
+import { fileURLToPath } from "url";
+var __dirname = dirname(fileURLToPath(import.meta.url));
+var PACKAGE_ROOT = resolve(__dirname, "..");
+var TEMPLATES = resolve(PACKAGE_ROOT, "templates");
+var SUPPORTED = ["react", "vue", "svelte"];
+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"
+    );
+  }
+  let framework = "react";
+  let dir = `./${name}`;
+  for (let i = 1; i < argv.length; i += 1) {
+    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 (!SUPPORTED.includes(value)) {
+        throw new Error(
+          `mountly-mcp: 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");
+      dir = value;
+    } else {
+      throw new Error(`mountly-mcp: unknown create option '${arg}'`);
+    }
+  }
+  return { name, framework, dir };
+}
+function slugify(name) {
+  return name.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function renderTemplates(dir, ctx) {
+  for (const entry of readdirSync(dir)) {
+    const full = join(dir, entry);
+    if (statSync(full).isDirectory()) {
+      renderTemplates(full, ctx);
+      continue;
+    }
+    if (!entry.endsWith(".tmpl")) continue;
+    let content = readFileSync(full, "utf8");
+    for (const [key, value] of Object.entries(ctx)) {
+      content = content.split(`{{${key}}}`).join(value);
+    }
+    writeFileSync(full.replace(/\.tmpl$/, ""), content);
+    unlinkSync(full);
+  }
+}
+async function createProject(args) {
+  const target = resolve(args.dir);
+  if (existsSync(target)) {
+    throw new Error(`mountly-mcp: target directory already exists: ${target}`);
+  }
+  const tplDir = join(TEMPLATES, args.framework);
+  if (!existsSync(tplDir)) {
+    throw new Error(
+      `mountly-mcp: template for framework "${args.framework}" is missing at ${tplDir}`
+    );
+  }
+  mkdirSync(target, { recursive: true });
+  cpSync(tplDir, target, { recursive: true });
+  const slug = slugify(args.name) || "app";
+  renderTemplates(target, {
+    name: args.name,
+    slug,
+    uri: `ui://${slug}/dashboard`,
+    framework: args.framework
+  });
+  process.stdout.write(
+    [
+      "",
+      `\u2713 Created MCP App ${args.name} (${args.framework}) at ${target}`,
+      "",
+      "Next steps:",
+      `  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.",
+      ""
+    ].join("\n")
+  );
+}
+export {
+  createProject,
+  parseCreateArgs
+};
+//# sourceMappingURL=create.js.map

package/dist/create.js.map

@@ -0,0 +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\nconst SUPPORTED = [\"react\", \"vue\", \"svelte\"] 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  });\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":"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","names":[]}

package/dist/dev/host-entry.js

@@ -18261,8 +18261,8 @@ container holding the app. Specify either width or maxWidth, and either height o
   bridge.onsandboxready = async () => {
     log("in", "ui/notifications/sandbox-proxy-ready");
     const [html, declaration] = await Promise.all([
-      fetch("/widget.html").then((response) => response.text()),
-      fetch("/widget.meta.json").then((response) => response.json())
+      fetch("/view.html").then((response) => response.text()),
+      fetch("/view.meta.json").then((response) => response.json())
     ]);
     await bridge.sendSandboxResourceReady({
       html,

package/dist/dev/index.d.ts

@@ -1,5 +1,5 @@
 export interface DevHostOptions {
-    /** Built widget HTML. Its `.meta.json` sidecar is read alongside. */
+    /** Built View HTML. Its `.meta.json` sidecar is read alongside. */
     htmlPath: string;
     /**
      * Named samples, each becoming a button in the host chrome.

package/dist/dev/index.js

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

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./types.js";
 export * from "./schema.js";
+export * from "./publish.js";
 export { runBridge, App, PostMessageTransport } from "./bridge/index.js";
 export type { RunBridgeOptions, RunningBridge } from "./bridge/index.js";
 export { sandboxProxyHtml } from "./sandbox/index.js";

package/dist/index.js

@@ -1,11 +1,16 @@
 import {
   sandboxProxyHtml
 } from "./chunk-6QHKKFO3.js";
+import {
+  MCP_VIEW_GLOBAL_KEY,
+  getPublishedMcpView,
+  publishMcpView
+} from "./chunk-SADNMGP6.js";
 import {
   App,
   PostMessageTransport,
   runBridge
-} from "./chunk-SNWNF2XI.js";
+} from "./chunk-JVQZGKBL.js";
 import {
   EXTENSION_ID,
   LATEST_PROTOCOL_VERSION,
@@ -13,7 +18,7 @@ import {
   MCP_ERROR_CODES,
   RESOURCE_MIME_TYPE,
   RESOURCE_URI_META_KEY
-} from "./chunk-DQLQOMDM.js";
+} from "./chunk-M4WFJR3C.js";
 import "./chunk-YJA4H6IB.js";
 export {
   App,
@@ -22,8 +27,11 @@ export {
   LATEST_PROTOCOL_VERSION as MCP_APPS_PROTOCOL_VERSION,
   MCP_APPS_URI_SCHEME,
   MCP_ERROR_CODES,
+  MCP_VIEW_GLOBAL_KEY,
   PostMessageTransport,
   RESOURCE_URI_META_KEY,
+  getPublishedMcpView,
+  publishMcpView,
   runBridge,
   sandboxProxyHtml
 };

package/dist/json-render/{widget.d.ts → generative-view.d.ts}

@@ -1,7 +1,8 @@
 import { type ComponentMap } from "@json-render/react";
 import type { Catalog, SchemaDefinition } from "@json-render/core";
 import type { App } from "@modelcontextprotocol/ext-apps";
-import type { AdapterOptions, WidgetModule } from "mountly/adapter";
+import type { AdapterOptions } from "mountly/adapter";
+import type { McpView } from "../types.js";
 /** The catalog-data constraint createRenderer infers against. */
 type CatalogData = {
     components: Record<string, {
@@ -21,7 +22,7 @@ export type ActionRouter = (name: string, params: Record<string, unknown> | unde
 export declare const defaultActionRouter: ActionRouter;
 /**
  * Identity helper that types a components map against a catalog (so it can be
- * defined once and reused by both `createGenerativeWidget` and `createRenderer`)
+ * defined once and reused by both `createGenerativeView` and `createRenderer`)
  * without losing per-component prop inference.
  *
  * ```ts
@@ -31,7 +32,7 @@ export declare const defaultActionRouter: ActionRouter;
  * ```
  */
 export declare function defineComponents<TDef extends SchemaDefinition, TCatalog extends CatalogData>(_catalog: Catalog<TDef, TCatalog>, components: ComponentMap<TCatalog["components"]>): ComponentMap<TCatalog["components"]>;
-export interface GenerativeWidgetOptions<TDef extends SchemaDefinition, TCatalog extends CatalogData> extends AdapterOptions {
+export interface GenerativeViewOptions<TDef extends SchemaDefinition, TCatalog extends CatalogData> extends AdapterOptions {
     /** The json-render catalog — the vocabulary the agent may compose. */
     catalog: Catalog<TDef, TCatalog>;
     /** Native component implementations for each catalog type. */
@@ -43,17 +44,14 @@ export interface GenerativeWidgetOptions<TDef extends SchemaDefinition, TCatalog
     onAction?: ActionRouter;
 }
 /**
- * Turn a json-render catalog + components into a mountly MCP Apps widget.
+ * Turn a json-render catalog + components into a mountly MCP Apps View.
  *
- * The returned widget reads the spec from the tool result, renders it natively
- * (resolving `$state` bindings from `spec.state`), and routes the rendered UI's
- * actions back to the MCP host. One call replaces the manual
- * catalog→registry→renderer→state→action-bridge wiring.
+ * Reads the spec from the tool result, renders it natively (resolving `$state`
+ * from `spec.state`), and routes actions back to the MCP host.
  *
  * ```ts
- * const widget = createGenerativeWidget({ catalog, components, styles, shadow: true });
- * (globalThis as { __mountlyMcpWidget__?: unknown }).__mountlyMcpWidget__ = widget;
+ * createGenerativeView({ catalog, components, styles, shadow: true });
  * ```
  */
-export declare function createGenerativeWidget<TDef extends SchemaDefinition, TCatalog extends CatalogData>(options: GenerativeWidgetOptions<TDef, TCatalog>): WidgetModule;
+export declare function createGenerativeView<TDef extends SchemaDefinition, TCatalog extends CatalogData>(options: GenerativeViewOptions<TDef, TCatalog>): McpView;
 export {};

package/dist/json-render/index.d.ts

@@ -1,4 +1,4 @@
-export { type ActionRouter, type GenerativeWidgetOptions, createGenerativeWidget, defaultActionRouter, defineComponents, } from "./widget.js";
+export { type ActionRouter, type GenerativeViewOptions, createGenerativeView, defaultActionRouter, defineComponents, } from "./generative-view.js";
 export { type JsonRenderToolOptions, type RegisterJsonRenderResourceOptions, type RegisterJsonRenderToolOptions, type CreateJsonRenderMcpAppOptions, createJsonRenderMcpApp, registerJsonRenderTool, registerJsonRenderResource, } from "./mcp.js";
 export { type BuildAppHtmlOptions, type UseJsonRenderAppOptions, type UseJsonRenderAppReturn, buildAppHtml, useJsonRenderApp, } from "./app.js";
 export { createRenderer } from "@json-render/react";

package/dist/json-render/index.js

@@ -12,17 +12,18 @@ import {
   specToPatchLines
 } from "../chunk-5EHNJCMF.js";
 import {
-  createMcpWidget,
-  useMcpHost,
+  createMcpView,
+  useMcpApp,
   useToolResult
-} from "../chunk-NLQDVNZP.js";
+} from "../chunk-AEVQKFXX.js";
+import "../chunk-SADNMGP6.js";
 import {
   buildAppHtml,
   useJsonRenderApp
 } from "../chunk-33DMFKKD.js";
 import "../chunk-YJA4H6IB.js";
 
-// src/json-render/widget.tsx
+// src/json-render/generative-view.tsx
 import { createElement } from "react";
 import { createRenderer } from "@json-render/react";
 var defaultActionRouter = (name, params, mcp) => {
@@ -36,11 +37,11 @@ var defaultActionRouter = (name, params, mcp) => {
 function defineComponents(_catalog, components) {
   return components;
 }
-function createGenerativeWidget(options) {
+function createGenerativeView(options) {
   const { catalog, components, onAction = defaultActionRouter, ...adapter } = options;
   const Rendered = createRenderer(catalog, components);
   function GenerativeView() {
-    const mcp = useMcpHost();
+    const mcp = useMcpApp();
     const result = useToolResult();
     const spec = result?.structuredContent?.spec ?? null;
     if (!spec) return null;
@@ -50,7 +51,7 @@ function createGenerativeWidget(options) {
       onAction: (name, params) => onAction(name, params, mcp)
     });
   }
-  return createMcpWidget(GenerativeView, adapter);
+  return createMcpView(GenerativeView, adapter);
 }
 
 // src/json-render/index.ts
@@ -100,7 +101,7 @@ export {
   buildAppHtml,
   compileSpecStream,
   compileTextStreamToSpecs,
-  createGenerativeWidget,
+  createGenerativeView,
   createJsonRenderMcpApp,
   createJsonRenderTransform,
   createRenderer2 as createRenderer,