mountly-mcp 0.0.0 → 3.1.0

package/dist/chunk-BUGGLMNA.js

@@ -1,132 +0,0 @@
-import {
-  MCP_ERROR_CODES
-} from "./chunk-A64ZILAS.js";
-
-// src/bridge/index.ts
-import {
-  App,
-  PostMessageTransport
-} from "@modelcontextprotocol/ext-apps";
-function renderErrorBoundary(container, code, message) {
-  const doc = container.ownerDocument;
-  if (!doc) return;
-  const errorDiv = doc.createElement("div");
-  errorDiv.setAttribute("data-mountly-mcp-error", code);
-  if (message !== void 0) errorDiv.textContent = message;
-  container.innerHTML = "";
-  container.appendChild(errorDiv);
-}
-function runBridge(options) {
-  const {
-    widget,
-    container,
-    awaitToolResult = true,
-    availableDisplayModes = ["inline"],
-    appInfo = { name: "mountly-mcp", version: "0.0.0" }
-  } = options;
-  const appCapabilities = {
-    availableDisplayModes: [...availableDisplayModes]
-  };
-  const app = options.app ?? new App(appInfo, appCapabilities);
-  let toolInput;
-  let toolResult;
-  let mounted = false;
-  let pending = Promise.resolve();
-  function currentProps() {
-    return {
-      mcp: app,
-      toolInput,
-      toolResult,
-      hostContext: app.getHostContext()
-    };
-  }
-  function notifyError(code, error) {
-    const message = error instanceof Error ? error.message : String(error);
-    try {
-      app.sendLog({ level: "error", data: { code, message } });
-    } catch {
-    }
-    renderErrorBoundary(container, code, message);
-  }
-  function renderWith(props) {
-    pending = pending.then(async () => {
-      try {
-        if (!mounted) {
-          const r = widget.mount(container, props);
-          if (r instanceof Promise) await r;
-          mounted = true;
-        } else if (widget.update) {
-          const r = widget.update(container, props);
-          if (r instanceof Promise) await r;
-        } else {
-          widget.unmount(container);
-          const r = widget.mount(container, props);
-          if (r instanceof Promise) await r;
-          mounted = true;
-        }
-      } catch (error) {
-        notifyError(MCP_ERROR_CODES.WIDGET_MOUNT_THREW, error);
-      }
-    });
-  }
-  app.ontoolinput = (params) => {
-    toolInput = params;
-    if (!awaitToolResult) return;
-    if (mounted || toolResult !== void 0) renderWith(currentProps());
-  };
-  app.ontoolinputpartial = () => {
-  };
-  app.ontoolresult = (params) => {
-    toolResult = params;
-    renderWith(currentProps());
-  };
-  app.ontoolcancelled = () => {
-    renderWith(currentProps());
-  };
-  app.onhostcontextchanged = () => {
-    if (mounted) renderWith(currentProps());
-  };
-  app.onteardown = async () => {
-    if (mounted) {
-      widget.unmount(container);
-      mounted = false;
-    }
-    return {};
-  };
-  const ready = (async () => {
-    if (!options.app) {
-      await app.connect();
-    }
-    try {
-      app.setupSizeChangedNotifications();
-    } catch {
-    }
-    if (!awaitToolResult) {
-      renderWith({ mcp: app });
-    }
-  })();
-  const detachTeardown = options.onTeardown?.(() => {
-    if (mounted) widget.unmount(container);
-  }) ?? (typeof window !== "undefined" ? (() => {
-    const h = () => {
-      if (mounted) widget.unmount(container);
-    };
-    window.addEventListener("beforeunload", h);
-    return () => window.removeEventListener("beforeunload", h);
-  })() : () => void 0);
-  return {
-    ready,
-    app,
-    stop() {
-      detachTeardown();
-      if (mounted) widget.unmount(container);
-    }
-  };
-}
-
-export {
-  App,
-  PostMessageTransport,
-  runBridge
-};
-//# sourceMappingURL=chunk-BUGGLMNA.js.map

package/dist/chunk-BUGGLMNA.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/bridge/index.ts"],"sourcesContent":["/**\n * View-side bridge that turns an MCP Apps `App` into a mountly `WidgetModule`\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} from \"@modelcontextprotocol/ext-apps\";\nimport type { WidgetModule } from \"mountly/adapter\";\nimport { MCP_ERROR_CODES } from \"../schema.js\";\nimport type {\n  DisplayMode,\n  McpWidgetProps,\n  ToolInput,\n  ToolResult,\n} from \"../types.js\";\n\nexport interface RunBridgeOptions {\n  /** Pre-constructed App (used by jsdom tests); otherwise one is created here. */\n  app?: App;\n  widget: WidgetModule;\n  container: Element;\n  /**\n   * If true (default), mount is deferred until the first tool-result arrives;\n   * the widget 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  /** Display modes this view supports. Declared to the host during `ui/initialize`. */\n  availableDisplayModes?: ReadonlyArray<DisplayMode>;\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\nfunction renderErrorBoundary(container: Element, code: string, message?: string): void {\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    widget,\n    container,\n    awaitToolResult = true,\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: ToolInput | undefined;\n  let toolResult: ToolResult | undefined;\n  let mounted = false;\n  let pending: Promise<void> = Promise.resolve();\n\n  function currentProps(): McpWidgetProps {\n    return {\n      mcp: app,\n      toolInput,\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      app.sendLog({ level: \"error\", data: { code, message } });\n    } catch {\n      // ignore — log channel may not be ready\n    }\n    renderErrorBoundary(container, code, message);\n  }\n\n  function renderWith(props: McpWidgetProps): void {\n    pending = pending.then(async () => {\n      try {\n        if (!mounted) {\n          const r = widget.mount(container, props);\n          if (r instanceof Promise) await r;\n          mounted = true;\n        } else if (widget.update) {\n          const r = widget.update(container, props);\n          if (r instanceof Promise) await r;\n        } else {\n          widget.unmount(container);\n          const r = widget.mount(container, props);\n          if (r instanceof Promise) await r;\n          mounted = true;\n        }\n      } catch (error) {\n        notifyError(MCP_ERROR_CODES.WIDGET_MOUNT_THREW, error);\n      }\n    });\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  app.ontoolinput = (params) => {\n    toolInput = params;\n    if (!awaitToolResult) return;\n    if (mounted || toolResult !== undefined) renderWith(currentProps());\n  };\n\n  app.ontoolinputpartial = () => {\n    // Views MAY ignore partial input per spec; default policy is to skip.\n    // Consumers wanting streaming UX can subscribe via app.addEventListener.\n  };\n\n  app.ontoolresult = (params) => {\n    toolResult = params;\n    renderWith(currentProps());\n  };\n\n  app.ontoolcancelled = () => {\n    renderWith(currentProps());\n  };\n\n  app.onhostcontextchanged = () => {\n    if (mounted) renderWith(currentProps());\n  };\n\n  app.onteardown = async () => {\n    if (mounted) {\n      widget.unmount(container);\n      mounted = false;\n    }\n    return {};\n  };\n\n  const ready = (async () => {\n    if (!options.app) {\n      // App.connect() defaults to PostMessageTransport(window.parent, window.parent).\n      await app.connect();\n    }\n\n    try {\n      app.setupSizeChangedNotifications();\n    } catch {\n      // ResizeObserver may be unavailable (jsdom/non-browser).\n    }\n\n    if (!awaitToolResult) {\n      renderWith({ mcp: app });\n    }\n  })();\n\n  const detachTeardown =\n    options.onTeardown?.(() => {\n      if (mounted) widget.unmount(container);\n    }) ??\n    (typeof window !== \"undefined\"\n      ? (() => {\n          const h = () => {\n            if (mounted) widget.unmount(container);\n          };\n          window.addEventListener(\"beforeunload\", h);\n          return () => window.removeEventListener(\"beforeunload\", h);\n        })()\n      : () => undefined);\n\n  return {\n    ready,\n    app,\n    stop() {\n      detachTeardown();\n      if (mounted) widget.unmount(container);\n    },\n  };\n}\n\nexport { App, PostMessageTransport };\nexport type {\n  McpUiAppCapabilities,\n  McpUiHostCapabilities,\n  McpUiHostContext,\n  McpUiToolInputNotification,\n  McpUiToolResultNotification,\n  McpUiToolCancelledNotification,\n  McpUiHostContextChangedNotification,\n} from \"@modelcontextprotocol/ext-apps\";\n"],"mappings":"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","names":[]}

package/dist/types-B9JAWm4W.d.ts

@@ -1,62 +0,0 @@
-import { McpUiAppCapabilities, McpUiDisplayMode, McpUiHostCapabilities, McpUiHostContext, McpUiHostContextChangedNotification, McpUiResourceCsp, App, RESOURCE_MIME_TYPE, McpUiResourceMeta, McpUiResourcePermissions, McpUiToolMeta, McpUiToolVisibility, McpUiToolInputNotification, McpUiToolResultNotification, McpUiToolCancelledNotification } from '@modelcontextprotocol/ext-apps';
-
-/**
- * Types — re-exported from `@modelcontextprotocol/ext-apps` so they stay in
- * lock-step with the official MCP Apps spec (SEP-1865, 2026-01-26).
- *
- * Only the mountly-specific glue types (props passed to a widget's mount(),
- * resource declaration written to the sidecar JSON) live here.
- */
-
-/** The MCP Apps view-side SDK instance. mountly-mcp surfaces this through React context. */
-type McpHost = App;
-type DisplayMode = McpUiDisplayMode;
-type AppCapabilities = McpUiAppCapabilities;
-type HostCapabilities = McpUiHostCapabilities;
-type HostContext = McpUiHostContext;
-type McpCsp = McpUiResourceCsp;
-type McpResourcePermissions = McpUiResourcePermissions;
-type McpResourceMeta = McpUiResourceMeta;
-type McpToolMeta = McpUiToolMeta;
-type McpToolVisibility = McpUiToolVisibility;
-type ToolInput = McpUiToolInputNotification["params"];
-type ToolResult = McpUiToolResultNotification["params"];
-type ToolCancelled = McpUiToolCancelledNotification["params"];
-type HostContextChanged = McpUiHostContextChangedNotification["params"];
-/**
- * Props passed to a `WidgetModule.mount(container, props)` call.
- *
- * The bridge surfaces the App handle plus the latest tool input/result and a
- * snapshot of host context. Widgets receive new props through `update()` as
- * notifications arrive — see `runBridge` in `bridge/index.ts`.
- */
-interface McpWidgetProps {
-    /** The view-side ext-apps App; exposes the full spec-compliant API surface. */
-    mcp: McpHost;
-    /** Tool arguments (after `ui/notifications/tool-input`). */
-    toolInput?: ToolInput;
-    /** Tool result (after `ui/notifications/tool-result`). */
-    toolResult?: ToolResult;
-    /** Host context (theme, styles, displayMode, container dimensions, etc.). */
-    hostContext?: HostContext;
-}
-/**
- * Resource metadata written to the `.meta.json` sidecar next to the emitted
- * HTML, consumed by `mountly-mcp-server` when registering the `ui://`
- * resource with `_meta.ui = {...}`.
- */
-interface McpResourceDeclaration {
-    protocolVersion: string;
-    uri: string;
-    name: string;
-    description?: string;
-    mimeType: typeof RESOURCE_MIME_TYPE;
-    /** Whether `runBridge` defers mount until the first tool-result arrives. */
-    awaitToolResult: boolean;
-    displayModes: ReadonlyArray<DisplayMode>;
-    _meta: {
-        ui: McpResourceMeta;
-    };
-}
-
-export type { AppCapabilities as A, DisplayMode as D, HostCapabilities as H, McpCsp as M, ToolCancelled as T, HostContext as a, HostContextChanged as b, McpHost as c, McpResourceDeclaration as d, McpResourceMeta as e, McpResourcePermissions as f, McpToolMeta as g, McpToolVisibility as h, McpWidgetProps as i, ToolInput as j, ToolResult as k };