mountly-mcp 3.1.0 → 4.0.1

package/README.md

@@ -1,29 +1,51 @@
 # mountly-mcp
 
-**Build MCP Apps from the components you already have — in React, Vue, or Svelte.**
+**Build MCP Apps from React, Vue, or Svelte components — new or existing.**
 
 [MCP Apps](https://github.com/modelcontextprotocol/ext-apps) (SEP-1865) lets an
 MCP server render interactive UI inside Claude, ChatGPT and other hosts. The
-official SDK gives you the protocol and expects you to hand-write the view.
-`mountly-mcp` starts from a component instead:
+official SDK gives you the protocol. `mountly-mcp` is the view layer on top:
+write a component, get a `ui://` resource, a local host, and server registration
+without hand-writing the handshake HTML.
 
 ```ts
-import { createMcpWidget } from "mountly-mcp/vue";
-import Dashboard from "./Dashboard.vue";
+import { createMcpView } from "mountly-mcp/react";
+import Dashboard from "./Dashboard";
 
-(globalThis as { __mountlyMcpWidget__?: unknown }).__mountlyMcpWidget__ =
-  createMcpWidget(Dashboard);
+createMcpView(Dashboard);
 ```
 
-`mountly-mcp build` turns that into a versioned App manifest containing one or
-many `ui://` resources. `registerMcpApps` installs them into the MCP server your
-application already owns. Your component is unchanged, and the same one can
-keep running on your website.
+That path is the default whether the dashboard is three metric cards for one
+host or a multi-View production server. Prefer the scaffolder for greenfield:
 
-**If you're on React and starting from scratch**, the official
-[`@modelcontextprotocol/ext-apps`](https://www.npmjs.com/package/@modelcontextprotocol/ext-apps)
-skills are the shorter path — this package is worth it when you have existing
-components, a Vite build, or a framework other than React.
+```bash
+npx mountly-mcp create my-app --framework react
+cd my-app && pnpm install && pnpm dev
+```
+
+`--framework` takes `react`, `vue`, `svelte`, or `vanilla`. Vanilla pulls in no
+framework and no adapter: a View is just `mount` / `update` / `unmount`, so
+`publishMcpView` takes the object directly and the bridge drives it the same
+way it drives the others.
+
+## Build with Agent Skills
+
+| Skill | Try it |
+| --- | --- |
+| [`create-mcp-app`](../../plugins/mountly-mcp/skills/create-mcp-app/SKILL.md) | _"Create an MCP App"_ |
+| [`add-app-to-server`](../../plugins/mountly-mcp/skills/add-app-to-server/SKILL.md) | _"Add UI to my MCP server"_ |
+| [`convert-web-app`](../../plugins/mountly-mcp/skills/convert-web-app/SKILL.md) | _"Turn my component into an MCP App"_ |
+| [`migrate-ext-apps`](../../plugins/mountly-mcp/skills/migrate-ext-apps/SKILL.md) | _"Migrate from ext-apps"_ |
+
+```
+/plugin marketplace add jagreehal/mountly
+/plugin install mountly-mcp@mountly
+```
+
+Docs: [Agent Skills](https://mountly.dev/mcp-apps/agent-skills/).
+`mountly-mcp build` emits a versioned App manifest; `registerMcpApps` installs
+the Views into the MCP server you already own. Existing website components stay
+reusable as-is.
 
 The wire protocol is delegated to the official `@modelcontextprotocol/sdk` and
 `@modelcontextprotocol/ext-apps` packages in full, so server transports,
@@ -33,8 +55,11 @@ reimplementation of it. Both are runtime dependencies of `mountly-mcp`.
 ## Install
 
 ```bash
-npm install mountly-mcp mountly
-npm install mountly-vue        # or mountly-react / mountly-svelte
+# React (default) — mountly + mountly-react included
+npm install mountly-mcp react react-dom
+
+# Vue / Svelte
+npm install mountly-mcp mountly-vue vue   # or mountly-svelte + svelte
 ```
 
 Install `@modelcontextprotocol/sdk` directly only when your application imports
@@ -46,12 +71,12 @@ server entry point does not require a separate SDK install.
 ```ts
 // vite.config.ts
 import vue from "@vitejs/plugin-vue";
-import { mountlyMcpWidget } from "mountly-mcp/vite";
+import { mountlyMcpViews } from "mountly-mcp/vite";
 
 export default defineConfig({
   plugins: [
     vue(),
-    mountlyMcpWidget({
+    mountlyMcpViews({
       apps: [
         {
           entry: "src/dashboard.ts",
@@ -89,7 +114,7 @@ npx mountly-mcp dev
 npx mountly-mcp dev --app weather_dashboard
 ```
 
-Builds the widget, serves it in a local MCP Apps host, and rebuilds on save.
+Builds the View, serves it in a local MCP Apps host, and rebuilds on save.
 Config comes from the plugin already in your vite config.
 
 It's a real host, not a preview: the published official `AppBridge` drives the
@@ -249,10 +274,10 @@ renders what it can. Drop the loose branch once core relaxes those fields.
 | Entry                  | What's in it                                             |
 | ---------------------- | -------------------------------------------------------- |
 | `mountly-mcp`          | `runBridge`, spec types re-exported from ext-apps        |
-| `mountly-mcp/react`    | `createMcpWidget` + hooks                                |
-| `mountly-mcp/vue`      | `createMcpWidget` + composables                          |
-| `mountly-mcp/svelte`   | `createMcpWidget` (props-based)                          |
-| `mountly-mcp/vite`     | single- and multi-View `mountlyMcpWidget()` build plugin |
+| `mountly-mcp/react`    | `createMcpView` + hooks                                |
+| `mountly-mcp/vue`      | `createMcpView` + composables                          |
+| `mountly-mcp/svelte`   | `createMcpView` (props-based)                          |
+| `mountly-mcp/vite`     | single- and multi-View `mountlyMcpViews()` build plugin |
 | `mountly-mcp/artifact` | versioned manifest and App artifact APIs                 |
 | `mountly-mcp/dev`      | `startDevHost()` and in-process server connectivity      |
 | `mountly-mcp/build`    | `buildMcpResource` for other bundlers                    |
@@ -262,13 +287,18 @@ renders what it can. Drop the loose branch once core relaxes those fields.
 Types use the spec's own names (`McpUiHostContext`, `McpUiDisplayMode`, …) —
 one vocabulary, no translation layer.
 
-## Agent Skill
+## Agent Skills
+
+Install the plugin skills and ask your coding agent to create an MCP App:
+[Agent Skills docs](https://mountly.dev/mcp-apps/agent-skills/) ·
+[`create-mcp-app`](../../plugins/mountly-mcp/skills/create-mcp-app/SKILL.md).
 
-Ask your coding agent for an MCP App and let it scaffold:
-[`plugins/mountly-mcp/skills/create-mcp-widget`](../../../plugins/mountly-mcp/skills/create-mcp-widget/SKILL.md).
+Greenfield without an agent: `npx mountly-mcp create my-app --framework react`.
 
 ## See also
 
-- [`docs/examples/mcp-app-demo`](../../../docs/examples/mcp-app-demo) — full demo
-  with a sandbox-proxy preview host and an out-of-process stdio check
+- [`docs/examples/mcp-release-readiness`](../../docs/examples/mcp-release-readiness) —
+  production-shaped Vite View (closest to `create`)
+- [`docs/examples/mcp-app-demo`](../../docs/examples/mcp-app-demo) — advanced
+  protocol harness (not the greenfield starter)
 - `docs/how-to-test.md`

package/dist/bridge/iframe-entry.js

@@ -18556,7 +18556,7 @@ container holding the app. Specify either width or maxWidth, and either height o
     INITIALIZE_FAILED: "mountly-mcp/initialize-failed",
     INITIALIZE_TIMEOUT: "mountly-mcp/initialize-timeout",
     TOOL_CALL_FAILED: "mountly-mcp/tool-call-failed",
-    WIDGET_MOUNT_THREW: "mountly-mcp/widget-mount-threw",
+    VIEW_MOUNT_THREW: "mountly-mcp/view-mount-threw",
     INVALID_ORIGIN: "mountly-mcp/invalid-origin"
   };
 
@@ -18573,7 +18573,7 @@ container holding the app. Specify either width or maxWidth, and either height o
   }
   function runBridge(options) {
     const {
-      widget: widget2,
+      view: view2,
       container: container2,
       awaitToolResult: awaitToolResult2 = true,
       streamToolInput: streamToolInput2 = false,
@@ -18612,31 +18612,31 @@ container holding the app. Specify either width or maxWidth, and either height o
         if (stopped) return;
         try {
           if (!mounted) {
-            const r2 = widget2.mount(container2, props);
+            const r2 = view2.mount(container2, props);
             if (r2 instanceof Promise) await r2;
             mounted = true;
             container2.setAttribute("data-mountly-mcp-state", "mounted");
-          } else if (widget2.update) {
-            const r2 = widget2.update(container2, props);
+          } else if (view2.update) {
+            const r2 = view2.update(container2, props);
             if (r2 instanceof Promise) await r2;
           } else {
-            await widget2.unmount(container2);
+            await view2.unmount(container2);
             mounted = false;
-            const r2 = widget2.mount(container2, props);
+            const r2 = view2.mount(container2, props);
             if (r2 instanceof Promise) await r2;
             mounted = true;
           }
         } catch (error51) {
-          notifyError(MCP_ERROR_CODES.WIDGET_MOUNT_THREW, error51);
+          notifyError(MCP_ERROR_CODES.VIEW_MOUNT_THREW, error51);
         }
       });
       return pending;
     }
-    async function unmountWidget() {
+    async function unmountView() {
       await pending;
       if (!mounted) return;
       mounted = false;
-      await widget2.unmount(container2);
+      await view2.unmount(container2);
     }
     const handleToolInput = (params) => {
       toolInput = params;
@@ -18669,7 +18669,7 @@ container holding the app. Specify either width or maxWidth, and either height o
       stopped = true;
       detachTeardown();
       detachAppHandlers();
-      await unmountWidget();
+      await unmountView();
       return await previousTeardown?.(params, extra) ?? {};
     };
     app.onteardown = bridgeTeardown;
@@ -18702,7 +18702,7 @@ container holding the app. Specify either width or maxWidth, and either height o
       stopped = true;
       detachTeardown();
       detachAppHandlers();
-      void unmountWidget();
+      void unmountView();
       if (!options.app) void app.close().catch(() => void 0);
     }
     detachTeardown = options.onTeardown?.(stopBridge) ?? (typeof window !== "undefined" ? (() => {
@@ -18717,21 +18717,29 @@ container holding the app. Specify either width or maxWidth, and either height o
     };
   }
 
+  // src/publish.ts
+  var MCP_VIEW_GLOBAL_KEY = "__mountlyMcpView__";
+  function getPublishedMcpView() {
+    return globalThis[MCP_VIEW_GLOBAL_KEY];
+  }
+
   // src/bridge/iframe-entry.ts
-  var widget = globalThis.__mountlyMcpWidget__;
+  var view = getPublishedMcpView();
   var awaitToolResult = globalThis.__mountlyMcpAwaitToolResult__ ?? true;
   var streamToolInput = globalThis.__mountlyMcpStreamToolInput__ ?? false;
   var availableDisplayModes = globalThis.__mountlyMcpAvailableDisplayModes__ ?? ["inline"];
   var appInfo = globalThis.__mountlyMcpAppInfo__;
-  if (!widget) {
-    throw new Error("[mountly-mcp] no widget on globalThis.__mountlyMcpWidget__");
+  if (!view) {
+    throw new Error(
+      `[mountly-mcp] no View published \u2014 call createMcpView(...) (or publishMcpView) in your entry so ${MCP_VIEW_GLOBAL_KEY} is set`
+    );
   }
   var container = document.getElementById("mountly-mcp-root");
   if (!container) {
     throw new Error("[mountly-mcp] #mountly-mcp-root not found in iframe DOM");
   }
   var bridge = runBridge({
-    widget,
+    view,
     container,
     awaitToolResult,
     streamToolInput,

package/dist/bridge/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * View-side bridge that turns an MCP Apps `App` into a mountly `WidgetModule`
+ * View-side bridge that turns an MCP Apps `App` into a mountly view module
  * lifecycle. The full spec handshake — `ui/initialize`,
  * `ui/notifications/initialized`, `ui/notifications/tool-input(-partial)`,
  * `ui/notifications/tool-result`, `ui/notifications/tool-cancelled`,
@@ -7,15 +7,15 @@
  * `ui/notifications/size-changed` — is delegated to ext-apps's `App`.
  */
 import { App, PostMessageTransport, type McpUiDisplayMode } from "@modelcontextprotocol/ext-apps";
-import type { WidgetModule } from "mountly/adapter";
+import type { McpView } from "../types.js";
 export interface RunBridgeOptions {
     /** Pre-constructed App (used by jsdom tests); otherwise one is created here. */
     app?: App;
-    widget: WidgetModule;
+    view: McpView;
     container: Element;
     /**
      * If true (default), mount is deferred until the first tool-result arrives;
-     * the widget renders against `{ toolInput, toolResult, hostContext, mcp }`
+     * the View renders against `{ toolInput, toolResult, hostContext, mcp }`
      * props on each notification.
      *
      * If false, mount fires immediately after `ui/initialize` with `{ mcp }`
@@ -27,7 +27,7 @@ export interface RunBridgeOptions {
      *
      * Off by default — the spec lets views ignore partials, and they carry
      * best-effort recovered JSON that MUST NOT drive critical operations. When
-     * on, partials arrive as `toolInputPartial` (mounting the widget early if
+     * on, partials arrive as `toolInputPartial` (mounting the View early if
      * needed) and are cleared once the complete `tool-input` lands.
      */
     streamToolInput?: boolean;

package/dist/bridge/index.js

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

package/dist/build/index.d.ts

@@ -5,7 +5,7 @@ import type { McpAppArtifact } from "../artifact/index.js";
  * Absolute path to the iframe bridge runtime shipped with this package.
  *
  * `buildMcpResource` inlines this file's contents into the emitted HTML so
- * the widget can speak the MCP Apps postMessage protocol. Use this when you
+ * the View can speak the MCP Apps postMessage protocol. Use this when you
  * need to point another build tool at the runtime, or when you want a
  * stable, version-pinned alternative to passing `bridgeRuntimePath` yourself.
  *
@@ -50,9 +50,9 @@ export interface BuildResult {
     artifact: McpAppArtifact;
 }
 export interface BuildFromSourceOptions extends Omit<BuildSelfContainedOptions, "entry" | "cssEntry"> {
-    /** The bundled widget JS. */
+    /** The bundled View JS. */
     js: string;
-    /** The widget's CSS, if it has any. */
+    /** The View's CSS, if it has any. */
     css?: string;
 }
 /**

package/dist/build/index.js

@@ -4,8 +4,8 @@ import {
   emitHtml,
   emitMeta,
   getBridgeRuntimePath
-} from "../chunk-4WAKOYMK.js";
-import "../chunk-DQLQOMDM.js";
+} from "../chunk-MTJDRWGD.js";
+import "../chunk-M4WFJR3C.js";
 import "../chunk-YJA4H6IB.js";
 export {
   buildMcpResource,

package/dist/{chunk-NLQDVNZP.js → chunk-AEVQKFXX.js}

@@ -1,3 +1,7 @@
+import {
+  publishMcpView
+} from "./chunk-SADNMGP6.js";
+
 // src/react/context.ts
 import { createContext } from "react";
 var McpContext = createContext(null);
@@ -16,12 +20,12 @@ function useEnsuredContext() {
   const ctx = useContext(McpContext);
   if (!ctx) {
     throw new Error(
-      "mountly-mcp/react: useMcpHost/useToolInput/etc must be used inside a widget wrapped with createMcpWidget()."
+      "mountly-mcp/react: useMcpApp/useToolInput/etc must be used inside a View wrapped with createMcpView()."
     );
   }
   return ctx;
 }
-function useMcpHost() {
+function useMcpApp() {
   return useEnsuredContext().app;
 }
 function useToolInput() {
@@ -73,10 +77,10 @@ function useAutoResize(...args) {
   return useAutoResizeBase(...args);
 }
 
-// src/react/create-widget.ts
+// src/react/create-view.ts
 import { createElement } from "react";
 import { createWidget } from "mountly-react";
-function createMcpWidget(Component, options) {
+function createMcpView(Component, options) {
   const Wrapped = (props) => {
     const { mcp, toolInput, toolInputPartial, toolResult, hostContext, ...rest } = props;
     const value = {
@@ -92,12 +96,12 @@ function createMcpWidget(Component, options) {
       createElement(Component, rest)
     );
   };
-  return createWidget(Wrapped, options);
+  return publishMcpView(createWidget(Wrapped, options));
 }
 
 export {
   McpContext,
-  useMcpHost,
+  useMcpApp,
   useToolInput,
   useToolInputPartial,
   useToolResult,
@@ -110,6 +114,6 @@ export {
   useDocumentTheme,
   useUpdateModelContext,
   useAutoResize,
-  createMcpWidget
+  createMcpView
 };
-//# sourceMappingURL=chunk-NLQDVNZP.js.map
+//# sourceMappingURL=chunk-AEVQKFXX.js.map

package/dist/chunk-AEVQKFXX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/context.ts","../src/react/hooks.ts","../src/react/create-view.ts"],"sourcesContent":["import { createContext } from \"react\";\nimport type {\n  App,\n  McpUiHostContext,\n  McpUiToolInputNotification,\n  McpUiToolInputPartialNotification,\n  McpUiToolResultNotification,\n} from \"@modelcontextprotocol/ext-apps\";\n\n/**\n * Shared per-View context. The bridge populates this on each mount/update,\n * so consumers can synchronously read the initial values (no event subscription\n * race) and the React tree re-renders when the bridge calls `update()`.\n */\nexport interface McpContextValue {\n  app: App;\n  toolInput?: McpUiToolInputNotification[\"params\"];\n  toolInputPartial?: McpUiToolInputPartialNotification[\"params\"];\n  toolResult?: McpUiToolResultNotification[\"params\"];\n  hostContext?: McpUiHostContext;\n}\n\nexport const McpContext = createContext<McpContextValue | null>(null);\nMcpContext.displayName = \"McpContext\";\n","import { useContext } from \"react\";\nimport {\n  useAutoResize as useAutoResizeBase,\n  useDocumentTheme as useDocumentThemeBase,\n  useHostFonts as useHostFontsBase,\n  useHostStyleVariables as useHostStyleVariablesBase,\n  useHostStyles as useHostStylesBase,\n} from \"@modelcontextprotocol/ext-apps/react\";\nimport type {\n  App,\n  McpUiDisplayMode,\n  McpUiHostContext,\n  McpUiUpdateModelContextRequest,\n} from \"@modelcontextprotocol/ext-apps\";\nimport { McpContext } from \"./context.js\";\n\nfunction useEnsuredContext() {\n  const ctx = useContext(McpContext);\n  if (!ctx) {\n    throw new Error(\n      \"mountly-mcp/react: useMcpApp/useToolInput/etc must be used inside a View wrapped with createMcpView().\",\n    );\n  }\n  return ctx;\n}\n\n/** The view-side ext-apps App. Use this to call server tools, send messages, open links, etc. */\nexport function useMcpApp(): App {\n  return useEnsuredContext().app;\n}\n\n/** Complete notification params; read the tool arguments from `.arguments`. */\nexport function useToolInput<T = unknown>(): T | undefined {\n  return useEnsuredContext().toolInput as T | undefined;\n}\n\n/**\n * Streaming tool arguments (`ui/notifications/tool-input-partial`), present only\n * when the bridge runs with `streamToolInput`. Best-effort recovered JSON —\n * fields may be missing or change between notifications, so render loading\n * states from it, never critical operations. Undefined once the complete\n * {@link useToolInput} arrives.\n */\nexport function useToolInputPartial<T = unknown>(): Partial<T> | undefined {\n  return useEnsuredContext().toolInputPartial as Partial<T> | undefined;\n}\n\n/** Complete MCP tool result; structured data is available at `.structuredContent`. */\nexport function useToolResult<T = unknown>(): T | undefined {\n  return useEnsuredContext().toolResult as T | undefined;\n}\n\n/** Latest host context snapshot (theme, styles, displayMode, container dimensions, etc.). */\nexport function useHostContext(): McpUiHostContext | undefined {\n  return useEnsuredContext().hostContext;\n}\n\n/** Current display mode reported by the host. */\nexport function useDisplayMode(): McpUiDisplayMode | undefined {\n  return useHostContext()?.displayMode;\n}\n\n/**\n * Request a display mode change, resolving to the mode the host actually\n * applied — which the spec allows to differ from the one asked for.\n *\n * Modes the host didn't list in `availableDisplayModes` are never requested\n * (the spec requires views to check first); the current mode comes back\n * unchanged instead.\n */\nexport function useRequestDisplayMode(): (\n  mode: McpUiDisplayMode,\n) => Promise<McpUiDisplayMode | undefined> {\n  const { app, hostContext } = useEnsuredContext();\n  return async (mode) => {\n    const available = hostContext?.availableDisplayModes;\n    if (available && !available.includes(mode)) return hostContext?.displayMode;\n    const result = await app.requestDisplayMode({ mode });\n    return result.mode;\n  };\n}\n\n/** Apply host CSS variables (and react to host-context changes). */\nexport function useHostStyleVariables(): void {\n  const { app, hostContext } = useEnsuredContext();\n  useHostStyleVariablesBase(app, hostContext ?? null);\n}\n\n/** Apply host-provided `@font-face`/`@import` rules. */\nexport function useHostFonts(): void {\n  const { app, hostContext } = useEnsuredContext();\n  useHostFontsBase(app, hostContext ?? null);\n}\n\n/** One-shot helper: apply both host style variables and host fonts. */\nexport function useHostStyles(): void {\n  const { app, hostContext } = useEnsuredContext();\n  useHostStylesBase(app, hostContext ?? null);\n}\n\n/** Track the document theme reactively. */\nexport function useDocumentTheme() {\n  return useDocumentThemeBase();\n}\n\n/**\n * Return a function that calls `app.updateModelContext(params)`.\n *\n * Context updates are available to the model in future turns without\n * triggering an immediate response. Only the last update is kept.\n */\nexport function useUpdateModelContext(): (\n  params: McpUiUpdateModelContextRequest[\"params\"],\n) => Promise<void> {\n  const { app } = useEnsuredContext();\n  return async (params) => {\n    await app.updateModelContext(params);\n  };\n}\n\n/** Manually control auto-resize (rarely needed — the bridge calls setupSizeChangedNotifications by default). */\nexport function useAutoResize(...args: Parameters<typeof useAutoResizeBase>) {\n  return useAutoResizeBase(...args);\n}\n","/**\n * Wraps a React component as an MCP Apps View and publishes it for the bridge.\n * One call is enough — no manual global assign.\n */\nimport { createElement, type ComponentType } from \"react\";\nimport { createWidget } from \"mountly-react\";\nimport type { AdapterOptions } from \"mountly/adapter\";\nimport type { McpView, McpViewProps } from \"../types.js\";\nimport { publishMcpView } from \"../publish.js\";\nimport { McpContext, type McpContextValue } from \"./context.js\";\n\nexport function createMcpView<P extends object>(\n  Component: ComponentType<P>,\n  options?: AdapterOptions,\n): McpView {\n  const Wrapped = (props: P & McpViewProps) => {\n    const { mcp, toolInput, toolInputPartial, toolResult, hostContext, ...rest } =\n      props as McpViewProps & P;\n    const value: McpContextValue = {\n      app: mcp,\n      toolInput,\n      toolInputPartial,\n      toolResult,\n      hostContext,\n    };\n    return createElement(\n      McpContext.Provider,\n      { value },\n      createElement(Component as ComponentType, rest as P),\n    );\n  };\n  return publishMcpView(createWidget(Wrapped as ComponentType<P & McpViewProps>, options));\n}\n"],"mappings":";;;;;AAAA,SAAS,qBAAqB;AAsBvB,IAAM,aAAa,cAAsC,IAAI;AACpE,WAAW,cAAc;;;ACvBzB,SAAS,kBAAkB;AAC3B;AAAA,EACE,iBAAiB;AAAA,EACjB,oBAAoB;AAAA,EACpB,gBAAgB;AAAA,EAChB,yBAAyB;AAAA,EACzB,iBAAiB;AAAA,OACZ;AASP,SAAS,oBAAoB;AAC3B,QAAM,MAAM,WAAW,UAAU;AACjC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,YAAiB;AAC/B,SAAO,kBAAkB,EAAE;AAC7B;AAGO,SAAS,eAA2C;AACzD,SAAO,kBAAkB,EAAE;AAC7B;AASO,SAAS,sBAA2D;AACzE,SAAO,kBAAkB,EAAE;AAC7B;AAGO,SAAS,gBAA4C;AAC1D,SAAO,kBAAkB,EAAE;AAC7B;AAGO,SAAS,iBAA+C;AAC7D,SAAO,kBAAkB,EAAE;AAC7B;AAGO,SAAS,iBAA+C;AAC7D,SAAO,eAAe,GAAG;AAC3B;AAUO,SAAS,wBAE2B;AACzC,QAAM,EAAE,KAAK,YAAY,IAAI,kBAAkB;AAC/C,SAAO,OAAO,SAAS;AACrB,UAAM,YAAY,aAAa;AAC/B,QAAI,aAAa,CAAC,UAAU,SAAS,IAAI,EAAG,QAAO,aAAa;AAChE,UAAM,SAAS,MAAM,IAAI,mBAAmB,EAAE,KAAK,CAAC;AACpD,WAAO,OAAO;AAAA,EAChB;AACF;AAGO,SAAS,wBAA8B;AAC5C,QAAM,EAAE,KAAK,YAAY,IAAI,kBAAkB;AAC/C,4BAA0B,KAAK,eAAe,IAAI;AACpD;AAGO,SAAS,eAAqB;AACnC,QAAM,EAAE,KAAK,YAAY,IAAI,kBAAkB;AAC/C,mBAAiB,KAAK,eAAe,IAAI;AAC3C;AAGO,SAAS,gBAAsB;AACpC,QAAM,EAAE,KAAK,YAAY,IAAI,kBAAkB;AAC/C,oBAAkB,KAAK,eAAe,IAAI;AAC5C;AAGO,SAAS,mBAAmB;AACjC,SAAO,qBAAqB;AAC9B;AAQO,SAAS,wBAEG;AACjB,QAAM,EAAE,IAAI,IAAI,kBAAkB;AAClC,SAAO,OAAO,WAAW;AACvB,UAAM,IAAI,mBAAmB,MAAM;AAAA,EACrC;AACF;AAGO,SAAS,iBAAiB,MAA4C;AAC3E,SAAO,kBAAkB,GAAG,IAAI;AAClC;;;ACvHA,SAAS,qBAAyC;AAClD,SAAS,oBAAoB;AAMtB,SAAS,cACd,WACA,SACS;AACT,QAAM,UAAU,CAAC,UAA4B;AAC3C,UAAM,EAAE,KAAK,WAAW,kBAAkB,YAAY,aAAa,GAAG,KAAK,IACzE;AACF,UAAM,QAAyB;AAAA,MAC7B,KAAK;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AACA,WAAO;AAAA,MACL,WAAW;AAAA,MACX,EAAE,MAAM;AAAA,MACR,cAAc,WAA4B,IAAS;AAAA,IACrD;AAAA,EACF;AACA,SAAO,eAAe,aAAa,SAA4C,OAAO,CAAC;AACzF;","names":[]}

package/dist/{chunk-SNWNF2XI.js → chunk-JVQZGKBL.js}

@@ -1,6 +1,6 @@
 import {
   MCP_ERROR_CODES
-} from "./chunk-DQLQOMDM.js";
+} from "./chunk-M4WFJR3C.js";
 
 // src/bridge/index.ts
 import {
@@ -19,7 +19,7 @@ function renderErrorBoundary(container, code, message) {
 }
 function runBridge(options) {
   const {
-    widget,
+    view,
     container,
     awaitToolResult = true,
     streamToolInput = false,
@@ -58,31 +58,31 @@ function runBridge(options) {
       if (stopped) return;
       try {
         if (!mounted) {
-          const r = widget.mount(container, props);
+          const r = view.mount(container, props);
           if (r instanceof Promise) await r;
           mounted = true;
           container.setAttribute("data-mountly-mcp-state", "mounted");
-        } else if (widget.update) {
-          const r = widget.update(container, props);
+        } else if (view.update) {
+          const r = view.update(container, props);
           if (r instanceof Promise) await r;
         } else {
-          await widget.unmount(container);
+          await view.unmount(container);
           mounted = false;
-          const r = widget.mount(container, props);
+          const r = view.mount(container, props);
           if (r instanceof Promise) await r;
           mounted = true;
         }
       } catch (error) {
-        notifyError(MCP_ERROR_CODES.WIDGET_MOUNT_THREW, error);
+        notifyError(MCP_ERROR_CODES.VIEW_MOUNT_THREW, error);
       }
     });
     return pending;
   }
-  async function unmountWidget() {
+  async function unmountView() {
     await pending;
     if (!mounted) return;
     mounted = false;
-    await widget.unmount(container);
+    await view.unmount(container);
   }
   const handleToolInput = (params) => {
     toolInput = params;
@@ -115,7 +115,7 @@ function runBridge(options) {
     stopped = true;
     detachTeardown();
     detachAppHandlers();
-    await unmountWidget();
+    await unmountView();
     return await previousTeardown?.(params, extra) ?? {};
   };
   app.onteardown = bridgeTeardown;
@@ -148,7 +148,7 @@ function runBridge(options) {
     stopped = true;
     detachTeardown();
     detachAppHandlers();
-    void unmountWidget();
+    void unmountView();
     if (!options.app) void app.close().catch(() => void 0);
   }
   detachTeardown = options.onTeardown?.(stopBridge) ?? (typeof window !== "undefined" ? (() => {
@@ -168,4 +168,4 @@ export {
   PostMessageTransport,
   runBridge
 };
-//# sourceMappingURL=chunk-SNWNF2XI.js.map
+//# sourceMappingURL=chunk-JVQZGKBL.js.map

package/dist/chunk-JVQZGKBL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bridge/index.ts"],"sourcesContent":["/**\n * View-side bridge that turns an MCP Apps `App` into a mountly view module\n * lifecycle. The full spec handshake — `ui/initialize`,\n * `ui/notifications/initialized`, `ui/notifications/tool-input(-partial)`,\n * `ui/notifications/tool-result`, `ui/notifications/tool-cancelled`,\n * `ui/notifications/host-context-changed`, `ui/resource-teardown`,\n * `ui/notifications/size-changed` — is delegated to ext-apps's `App`.\n */\nimport {\n  App,\n  PostMessageTransport,\n  type McpUiAppCapabilities,\n  type McpUiDisplayMode,\n  type McpUiToolInputNotification,\n  type McpUiToolInputPartialNotification,\n  type McpUiToolResultNotification,\n} from \"@modelcontextprotocol/ext-apps\";\n\nimport { MCP_ERROR_CODES } from \"../schema.js\";\nimport type { McpView, McpViewProps } from \"../types.js\";\n\nexport interface RunBridgeOptions {\n  /** Pre-constructed App (used by jsdom tests); otherwise one is created here. */\n  app?: App;\n  view: McpView;\n  container: Element;\n  /**\n   * If true (default), mount is deferred until the first tool-result arrives;\n   * the View renders against `{ toolInput, toolResult, hostContext, mcp }`\n   * props on each notification.\n   *\n   * If false, mount fires immediately after `ui/initialize` with `{ mcp }`\n   * only — for \"stateless\" views that drive themselves via `mcp.callServerTool`.\n   */\n  awaitToolResult?: boolean;\n  /**\n   * Render progressive states from `ui/notifications/tool-input-partial`.\n   *\n   * Off by default — the spec lets views ignore partials, and they carry\n   * best-effort recovered JSON that MUST NOT drive critical operations. When\n   * on, partials arrive as `toolInputPartial` (mounting the View early if\n   * needed) and are cleared once the complete `tool-input` lands.\n   */\n  streamToolInput?: boolean;\n  /** Display modes this view supports. Declared to the host during `ui/initialize`. */\n  availableDisplayModes?: ReadonlyArray<McpUiDisplayMode>;\n  /** App identity sent during `ui/initialize`. */\n  appInfo?: { name: string; version: string };\n  /** Override for tests; defaults to `window.addEventListener('beforeunload', ...)`. */\n  onTeardown?: (handler: () => void) => () => void;\n}\n\nexport interface RunningBridge {\n  /** Resolves once `ui/initialize` handshake completes and the first mount (or deferred mount) is wired. */\n  ready: Promise<void>;\n  /** The underlying App; exposed for hosts that want to drive the view directly. */\n  app: App;\n  /** Synchronously triggers teardown. */\n  stop(): void;\n}\n\n/**\n * `data-mountly-mcp-state` is the View's machine-readable outcome, read by\n * `verify --render`. It only ever moves forward — `mounted` once the View\n * has mounted, `error` if the boundary replaced it — so a state written here\n * can never be clobbered by a later lifecycle step.\n */\nfunction renderErrorBoundary(container: Element, code: string, message?: string): void {\n  container.setAttribute(\"data-mountly-mcp-state\", \"error\");\n  const doc = container.ownerDocument;\n  if (!doc) return;\n  const errorDiv = doc.createElement(\"div\");\n  errorDiv.setAttribute(\"data-mountly-mcp-error\", code);\n  if (message !== undefined) errorDiv.textContent = message;\n  container.innerHTML = \"\";\n  container.appendChild(errorDiv);\n}\n\nexport function runBridge(options: RunBridgeOptions): RunningBridge {\n  const {\n    view,\n    container,\n    awaitToolResult = true,\n    streamToolInput = false,\n    availableDisplayModes = [\"inline\"],\n    appInfo = { name: \"mountly-mcp\", version: \"0.0.0\" },\n  } = options;\n\n  const appCapabilities: McpUiAppCapabilities = {\n    availableDisplayModes: [...availableDisplayModes],\n  };\n\n  const app = options.app ?? new App(appInfo, appCapabilities);\n\n  let toolInput: McpUiToolInputNotification[\"params\"] | undefined;\n  let toolInputPartial: McpUiToolInputPartialNotification[\"params\"] | undefined;\n  let toolResult: McpUiToolResultNotification[\"params\"] | undefined;\n  let mounted = false;\n  let stopped = false;\n  let pending: Promise<void> = Promise.resolve();\n\n  function currentProps(): McpViewProps {\n    return {\n      mcp: app,\n      toolInput,\n      toolInputPartial,\n      toolResult,\n      hostContext: app.getHostContext(),\n    };\n  }\n\n  function notifyError(code: string, error: unknown): void {\n    const message = error instanceof Error ? error.message : String(error);\n    try {\n      void app.sendLog({ level: \"error\", data: { code, message } }).catch(() => undefined);\n    } catch {\n      // ignore — log channel may not be ready\n    }\n    renderErrorBoundary(container, code, message);\n  }\n\n  function renderWith(props: McpViewProps): Promise<void> {\n    pending = pending.then(async () => {\n      if (stopped) return;\n      try {\n        if (!mounted) {\n          const r = view.mount(container, props);\n          if (r instanceof Promise) await r;\n          mounted = true;\n          container.setAttribute(\"data-mountly-mcp-state\", \"mounted\");\n        } else if (view.update) {\n          const r = view.update(container, props);\n          if (r instanceof Promise) await r;\n        } else {\n          await view.unmount(container);\n          mounted = false;\n          const r = view.mount(container, props);\n          if (r instanceof Promise) await r;\n          mounted = true;\n        }\n      } catch (error) {\n        notifyError(MCP_ERROR_CODES.VIEW_MOUNT_THREW, error);\n      }\n    });\n    return pending;\n  }\n\n  async function unmountView(): Promise<void> {\n    await pending;\n    if (!mounted) return;\n    mounted = false;\n    await view.unmount(container);\n  }\n\n  // Event handlers MUST be registered before connect() — ext-apps will refuse\n  // to attach handlers retroactively after the initialize handshake completes.\n  const handleToolInput = (params: McpUiToolInputNotification[\"params\"]) => {\n    toolInput = params;\n    toolInputPartial = undefined;\n    if (!awaitToolResult) return;\n    if (mounted || toolResult !== undefined) void renderWith(currentProps());\n  };\n\n  const handleToolInputPartial = (params: McpUiToolInputPartialNotification[\"params\"]) => {\n    // Views MAY ignore partial input per spec; opt in with `streamToolInput`.\n    // Consumers wanting finer control can subscribe via app.addEventListener.\n    if (!streamToolInput) return;\n    toolInputPartial = params;\n    void renderWith(currentProps());\n  };\n\n  const handleToolResult = (params: McpUiToolResultNotification[\"params\"]) => {\n    toolResult = params;\n    void renderWith(currentProps());\n  };\n\n  const handleToolCancelled = () => {\n    void renderWith(currentProps());\n  };\n\n  const handleHostContextChanged = () => {\n    if (mounted) void renderWith(currentProps());\n  };\n\n  app.addEventListener(\"toolinput\", handleToolInput);\n  app.addEventListener(\"toolinputpartial\", handleToolInputPartial);\n  app.addEventListener(\"toolresult\", handleToolResult);\n  app.addEventListener(\"toolcancelled\", handleToolCancelled);\n  app.addEventListener(\"hostcontextchanged\", handleHostContextChanged);\n\n  const previousTeardown = app.onteardown;\n  const bridgeTeardown: NonNullable<typeof app.onteardown> = async (params, extra) => {\n    stopped = true;\n    detachTeardown();\n    detachAppHandlers();\n    await unmountView();\n    return (await previousTeardown?.(params, extra)) ?? {};\n  };\n  app.onteardown = bridgeTeardown;\n\n  function detachAppHandlers(): void {\n    app.removeEventListener(\"toolinput\", handleToolInput);\n    app.removeEventListener(\"toolinputpartial\", handleToolInputPartial);\n    app.removeEventListener(\"toolresult\", handleToolResult);\n    app.removeEventListener(\"toolcancelled\", handleToolCancelled);\n    app.removeEventListener(\"hostcontextchanged\", handleHostContextChanged);\n    if (app.onteardown === bridgeTeardown) app.onteardown = previousTeardown;\n  }\n\n  const ready = (async () => {\n    try {\n      if (!options.app) {\n        // App.connect() defaults to PostMessageTransport(window.parent, window.parent)\n        // and owns automatic resize setup.\n        await app.connect();\n      }\n\n      if (!awaitToolResult) {\n        await renderWith(currentProps());\n      }\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      const code = /timeout/i.test(message)\n        ? MCP_ERROR_CODES.INITIALIZE_TIMEOUT\n        : MCP_ERROR_CODES.INITIALIZE_FAILED;\n      notifyError(code, error);\n      throw error;\n    }\n  })();\n\n  let detachTeardown: () => void = () => undefined;\n\n  function stopBridge(): void {\n    if (stopped) return;\n    stopped = true;\n    detachTeardown();\n    detachAppHandlers();\n    void unmountView();\n    if (!options.app) void app.close().catch(() => undefined);\n  }\n\n  detachTeardown =\n    options.onTeardown?.(stopBridge) ??\n    (typeof window !== \"undefined\"\n      ? (() => {\n          const h = () => stopBridge();\n          window.addEventListener(\"beforeunload\", h);\n          return () => window.removeEventListener(\"beforeunload\", h);\n        })()\n      : () => undefined);\n\n  return {\n    ready,\n    app,\n    stop: stopBridge,\n  };\n}\n\nexport { App, PostMessageTransport };\nexport type {\n  McpUiAppCapabilities,\n  McpUiHostCapabilities,\n  McpUiHostContext,\n  McpUiToolInputNotification,\n  McpUiToolInputPartialNotification,\n  McpUiToolResultNotification,\n  McpUiToolCancelledNotification,\n  McpUiHostContextChangedNotification,\n} from \"@modelcontextprotocol/ext-apps\";\n"],"mappings":"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","names":[]}