mountly-mcp 0.0.0 → 4.0.0

package/dist/chunk-DKK26TRS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/artifact/index.ts"],"sourcesContent":["import { readFile, writeFile } from \"node:fs/promises\";\nimport { dirname, isAbsolute, relative, resolve } from \"node:path\";\nimport {\n  McpUiDisplayModeSchema,\n  McpUiResourceMetaSchema,\n  RESOURCE_MIME_TYPE,\n  LATEST_PROTOCOL_VERSION,\n} from \"@modelcontextprotocol/ext-apps\";\nimport type { McpResourceDeclaration } from \"../types.js\";\n\nexport const MCP_APP_MANIFEST_VERSION = 1 as const;\nexport const MCP_APP_MANIFEST_FILE = \"mountly-mcp.manifest.json\";\n\nexport interface McpAppArtifact {\n  /** Developer-facing unique key. */\n  name: string;\n  /** Protocol identity. */\n  uri: string;\n  /** Absolute path to the self-contained View HTML. */\n  htmlPath: string;\n  /** Absolute path to the transitional per-View sidecar. */\n  metaPath: string;\n  declaration: McpResourceDeclaration;\n}\n\nexport interface McpAppManifestEntry {\n  name: string;\n  uri: string;\n  /** Path relative to the manifest, unless explicitly absolute. */\n  html: string;\n  /** Path relative to the manifest, unless explicitly absolute. */\n  meta: string;\n  declaration: McpResourceDeclaration;\n}\n\nexport interface McpAppManifest {\n  formatVersion: typeof MCP_APP_MANIFEST_VERSION;\n  protocolVersion: typeof LATEST_PROTOCOL_VERSION;\n  apps: ReadonlyArray<McpAppManifestEntry>;\n}\n\nexport type ConformanceSeverity = \"error\" | \"warning\";\n\nexport interface ConformanceDiagnostic {\n  severity: ConformanceSeverity;\n  code: string;\n  message: string;\n  source?: string;\n}\n\nexport class McpAppConformanceError extends Error {\n  readonly diagnostics: ReadonlyArray<ConformanceDiagnostic>;\n\n  constructor(diagnostics: ReadonlyArray<ConformanceDiagnostic>) {\n    super(diagnostics.map((d) => `${d.code}: ${d.message}`).join(\"\\n\"));\n    this.name = \"McpAppConformanceError\";\n    this.diagnostics = diagnostics;\n  }\n}\n\nfunction object(value: unknown): Record<string, unknown> | undefined {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : undefined;\n}\n\nexport function inspectMcpResourceDeclaration(\n  value: unknown,\n  source?: string,\n): ReadonlyArray<ConformanceDiagnostic> {\n  const diagnostics: ConformanceDiagnostic[] = [];\n  const add = (code: string, message: string): void => {\n    diagnostics.push({ severity: \"error\", code, message, source });\n  };\n  const candidate = object(value);\n  if (!candidate) {\n    add(\"artifact/not-object\", \"resource declaration must be an object\");\n    return diagnostics;\n  }\n  if (candidate.protocolVersion !== LATEST_PROTOCOL_VERSION) {\n    add(\n      \"artifact/protocol-version\",\n      `sidecar protocolVersion must be '${LATEST_PROTOCOL_VERSION}' (received '${String(candidate.protocolVersion)}')`,\n    );\n  }\n  if (typeof candidate.uri !== \"string\" || !candidate.uri.startsWith(\"ui://\")) {\n    add(\"artifact/uri\", `uri must use the 'ui://' scheme (received '${String(candidate.uri)}')`);\n  }\n  if (typeof candidate.name !== \"string\" || candidate.name.trim() === \"\") {\n    add(\"artifact/name\", \"name must be a non-empty string\");\n  }\n  if (candidate.mimeType !== RESOURCE_MIME_TYPE) {\n    add(\n      \"artifact/mime-type\",\n      `sidecar mimeType must be '${RESOURCE_MIME_TYPE}' (received '${String(candidate.mimeType)}')`,\n    );\n  }\n  if (typeof candidate.awaitToolResult !== \"boolean\") {\n    add(\"artifact/await-tool-result\", \"awaitToolResult must be a boolean\");\n  }\n  if (\n    !Array.isArray(candidate.displayModes) ||\n    candidate.displayModes.length === 0 ||\n    candidate.displayModes.some((mode) => !McpUiDisplayModeSchema.safeParse(mode).success)\n  ) {\n    add(\"artifact/display-modes\", \"displayModes must contain supported MCP Apps display modes\");\n  }\n  const meta = object(candidate._meta);\n  const ui = meta && object(meta.ui);\n  if (!ui || !McpUiResourceMetaSchema.safeParse(ui).success) {\n    add(\"artifact/resource-meta\", \"_meta.ui must be valid MCP Apps resource metadata\");\n  }\n  return diagnostics;\n}\n\nexport function parseMcpResourceDeclaration(\n  value: unknown,\n  source?: string,\n): McpResourceDeclaration {\n  const diagnostics = inspectMcpResourceDeclaration(value, source);\n  if (diagnostics.length > 0) throw new McpAppConformanceError(diagnostics);\n  return value as McpResourceDeclaration;\n}\n\nexport async function readMcpAppArtifact(\n  htmlPath: string,\n  expectedUri?: string,\n): Promise<McpAppArtifact> {\n  const absoluteHtmlPath = resolve(htmlPath);\n  const metaPath = `${absoluteHtmlPath}.meta.json`;\n  const [html, raw] = await Promise.all([\n    readFile(absoluteHtmlPath, \"utf8\"),\n    readFile(metaPath, \"utf8\"),\n  ]);\n  if (!/^\\s*<!doctype html>/i.test(html)) {\n    throw new McpAppConformanceError([\n      {\n        severity: \"error\",\n        code: \"artifact/html5\",\n        message: \"View HTML must start with an HTML5 doctype\",\n        source: absoluteHtmlPath,\n      },\n    ]);\n  }\n  let decoded: unknown;\n  try {\n    decoded = JSON.parse(raw);\n  } catch (error) {\n    throw new McpAppConformanceError([\n      {\n        severity: \"error\",\n        code: \"artifact/meta-json\",\n        message: `metadata is not valid JSON: ${error instanceof Error ? error.message : String(error)}`,\n        source: metaPath,\n      },\n    ]);\n  }\n  const declaration = parseMcpResourceDeclaration(decoded, metaPath);\n  if (expectedUri !== undefined && declaration.uri !== expectedUri) {\n    throw new McpAppConformanceError([\n      {\n        severity: \"error\",\n        code: \"artifact/uri-mismatch\",\n        message: `registration uri '${expectedUri}' does not match sidecar uri '${declaration.uri}'`,\n        source: metaPath,\n      },\n    ]);\n  }\n  return {\n    name: declaration.name,\n    uri: declaration.uri,\n    htmlPath: absoluteHtmlPath,\n    metaPath,\n    declaration,\n  };\n}\n\nfunction manifestPath(path: string, base: string): string {\n  return isAbsolute(path) ? path : resolve(base, path);\n}\n\nexport async function writeMcpAppManifest(\n  path: string,\n  artifacts: ReadonlyArray<McpAppArtifact>,\n): Promise<McpAppManifest> {\n  const absolutePath = resolve(path);\n  const base = dirname(absolutePath);\n  const names = new Set<string>();\n  const uris = new Set<string>();\n  for (const artifact of artifacts) {\n    if (names.has(artifact.name))\n      throw new Error(`mountly-mcp: duplicate app name '${artifact.name}'`);\n    if (uris.has(artifact.uri)) throw new Error(`mountly-mcp: duplicate app uri '${artifact.uri}'`);\n    names.add(artifact.name);\n    uris.add(artifact.uri);\n  }\n  const manifest: McpAppManifest = {\n    formatVersion: MCP_APP_MANIFEST_VERSION,\n    protocolVersion: LATEST_PROTOCOL_VERSION,\n    apps: artifacts.map((artifact) => ({\n      name: artifact.name,\n      uri: artifact.uri,\n      html: relative(base, artifact.htmlPath),\n      meta: relative(base, artifact.metaPath),\n      declaration: artifact.declaration,\n    })),\n  };\n  await writeFile(absolutePath, JSON.stringify(manifest, null, 2), \"utf8\");\n  return manifest;\n}\n\nexport async function readMcpAppManifest(path: string): Promise<{\n  path: string;\n  manifest: McpAppManifest;\n  artifacts: ReadonlyArray<McpAppArtifact>;\n}> {\n  const absolutePath = resolve(path);\n  const base = dirname(absolutePath);\n  let decoded: unknown;\n  try {\n    decoded = JSON.parse(await readFile(absolutePath, \"utf8\"));\n  } catch (error) {\n    throw new Error(\n      `mountly-mcp: could not read manifest '${absolutePath}': ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n  const candidate = object(decoded);\n  if (\n    candidate?.formatVersion !== MCP_APP_MANIFEST_VERSION ||\n    candidate.protocolVersion !== LATEST_PROTOCOL_VERSION ||\n    !Array.isArray(candidate.apps)\n  ) {\n    throw new Error(\n      `mountly-mcp: '${absolutePath}' is not a supported mountly-mcp manifest (expected formatVersion ${MCP_APP_MANIFEST_VERSION})`,\n    );\n  }\n  const manifest = decoded as McpAppManifest;\n  const names = new Set<string>();\n  const uris = new Set<string>();\n  const artifacts: McpAppArtifact[] = [];\n  for (const entry of manifest.apps) {\n    if (names.has(entry.name)) throw new Error(`mountly-mcp: duplicate app name '${entry.name}'`);\n    if (uris.has(entry.uri)) throw new Error(`mountly-mcp: duplicate app uri '${entry.uri}'`);\n    names.add(entry.name);\n    uris.add(entry.uri);\n    const declaration = parseMcpResourceDeclaration(entry.declaration, absolutePath);\n    if (declaration.name !== entry.name || declaration.uri !== entry.uri) {\n      throw new Error(\n        `mountly-mcp: manifest identity does not match declaration for '${entry.name}'`,\n      );\n    }\n    artifacts.push({\n      name: entry.name,\n      uri: entry.uri,\n      htmlPath: manifestPath(entry.html, base),\n      metaPath: manifestPath(entry.meta, base),\n      declaration,\n    });\n  }\n  return { path: absolutePath, manifest, artifacts };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-JVQZGKBL.js

@@ -0,0 +1,171 @@
+import {
+  MCP_ERROR_CODES
+} from "./chunk-M4WFJR3C.js";
+
+// src/bridge/index.ts
+import {
+  App,
+  PostMessageTransport
+} from "@modelcontextprotocol/ext-apps";
+function renderErrorBoundary(container, code, message) {
+  container.setAttribute("data-mountly-mcp-state", "error");
+  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 {
+    view,
+    container,
+    awaitToolResult = true,
+    streamToolInput = false,
+    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 toolInputPartial;
+  let toolResult;
+  let mounted = false;
+  let stopped = false;
+  let pending = Promise.resolve();
+  function currentProps() {
+    return {
+      mcp: app,
+      toolInput,
+      toolInputPartial,
+      toolResult,
+      hostContext: app.getHostContext()
+    };
+  }
+  function notifyError(code, error) {
+    const message = error instanceof Error ? error.message : String(error);
+    try {
+      void app.sendLog({ level: "error", data: { code, message } }).catch(() => void 0);
+    } catch {
+    }
+    renderErrorBoundary(container, code, message);
+  }
+  function renderWith(props) {
+    pending = pending.then(async () => {
+      if (stopped) return;
+      try {
+        if (!mounted) {
+          const r = view.mount(container, props);
+          if (r instanceof Promise) await r;
+          mounted = true;
+          container.setAttribute("data-mountly-mcp-state", "mounted");
+        } else if (view.update) {
+          const r = view.update(container, props);
+          if (r instanceof Promise) await r;
+        } else {
+          await view.unmount(container);
+          mounted = false;
+          const r = view.mount(container, props);
+          if (r instanceof Promise) await r;
+          mounted = true;
+        }
+      } catch (error) {
+        notifyError(MCP_ERROR_CODES.VIEW_MOUNT_THREW, error);
+      }
+    });
+    return pending;
+  }
+  async function unmountView() {
+    await pending;
+    if (!mounted) return;
+    mounted = false;
+    await view.unmount(container);
+  }
+  const handleToolInput = (params) => {
+    toolInput = params;
+    toolInputPartial = void 0;
+    if (!awaitToolResult) return;
+    if (mounted || toolResult !== void 0) void renderWith(currentProps());
+  };
+  const handleToolInputPartial = (params) => {
+    if (!streamToolInput) return;
+    toolInputPartial = params;
+    void renderWith(currentProps());
+  };
+  const handleToolResult = (params) => {
+    toolResult = params;
+    void renderWith(currentProps());
+  };
+  const handleToolCancelled = () => {
+    void renderWith(currentProps());
+  };
+  const handleHostContextChanged = () => {
+    if (mounted) void renderWith(currentProps());
+  };
+  app.addEventListener("toolinput", handleToolInput);
+  app.addEventListener("toolinputpartial", handleToolInputPartial);
+  app.addEventListener("toolresult", handleToolResult);
+  app.addEventListener("toolcancelled", handleToolCancelled);
+  app.addEventListener("hostcontextchanged", handleHostContextChanged);
+  const previousTeardown = app.onteardown;
+  const bridgeTeardown = async (params, extra) => {
+    stopped = true;
+    detachTeardown();
+    detachAppHandlers();
+    await unmountView();
+    return await previousTeardown?.(params, extra) ?? {};
+  };
+  app.onteardown = bridgeTeardown;
+  function detachAppHandlers() {
+    app.removeEventListener("toolinput", handleToolInput);
+    app.removeEventListener("toolinputpartial", handleToolInputPartial);
+    app.removeEventListener("toolresult", handleToolResult);
+    app.removeEventListener("toolcancelled", handleToolCancelled);
+    app.removeEventListener("hostcontextchanged", handleHostContextChanged);
+    if (app.onteardown === bridgeTeardown) app.onteardown = previousTeardown;
+  }
+  const ready = (async () => {
+    try {
+      if (!options.app) {
+        await app.connect();
+      }
+      if (!awaitToolResult) {
+        await renderWith(currentProps());
+      }
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      const code = /timeout/i.test(message) ? MCP_ERROR_CODES.INITIALIZE_TIMEOUT : MCP_ERROR_CODES.INITIALIZE_FAILED;
+      notifyError(code, error);
+      throw error;
+    }
+  })();
+  let detachTeardown = () => void 0;
+  function stopBridge() {
+    if (stopped) return;
+    stopped = true;
+    detachTeardown();
+    detachAppHandlers();
+    void unmountView();
+    if (!options.app) void app.close().catch(() => void 0);
+  }
+  detachTeardown = options.onTeardown?.(stopBridge) ?? (typeof window !== "undefined" ? (() => {
+    const h = () => stopBridge();
+    window.addEventListener("beforeunload", h);
+    return () => window.removeEventListener("beforeunload", h);
+  })() : () => void 0);
+  return {
+    ready,
+    app,
+    stop: stopBridge
+  };
+}
+
+export {
+  App,
+  PostMessageTransport,
+  runBridge
+};
+//# 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":";;;;;AAQA;AAAA,EACE;AAAA,EACA;AAAA,OAMK;AAmDP,SAAS,oBAAoB,WAAoB,MAAc,SAAwB;AACrF,YAAU,aAAa,0BAA0B,OAAO;AACxD,QAAM,MAAM,UAAU;AACtB,MAAI,CAAC,IAAK;AACV,QAAM,WAAW,IAAI,cAAc,KAAK;AACxC,WAAS,aAAa,0BAA0B,IAAI;AACpD,MAAI,YAAY,OAAW,UAAS,cAAc;AAClD,YAAU,YAAY;AACtB,YAAU,YAAY,QAAQ;AAChC;AAEO,SAAS,UAAU,SAA0C;AAClE,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA,kBAAkB;AAAA,IAClB,kBAAkB;AAAA,IAClB,wBAAwB,CAAC,QAAQ;AAAA,IACjC,UAAU,EAAE,MAAM,eAAe,SAAS,QAAQ;AAAA,EACpD,IAAI;AAEJ,QAAM,kBAAwC;AAAA,IAC5C,uBAAuB,CAAC,GAAG,qBAAqB;AAAA,EAClD;AAEA,QAAM,MAAM,QAAQ,OAAO,IAAI,IAAI,SAAS,eAAe;AAE3D,MAAI;AACJ,MAAI;AACJ,MAAI;AACJ,MAAI,UAAU;AACd,MAAI,UAAU;AACd,MAAI,UAAyB,QAAQ,QAAQ;AAE7C,WAAS,eAA6B;AACpC,WAAO;AAAA,MACL,KAAK;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA,aAAa,IAAI,eAAe;AAAA,IAClC;AAAA,EACF;AAEA,WAAS,YAAY,MAAc,OAAsB;AACvD,UAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACrE,QAAI;AACF,WAAK,IAAI,QAAQ,EAAE,OAAO,SAAS,MAAM,EAAE,MAAM,QAAQ,EAAE,CAAC,EAAE,MAAM,MAAM,MAAS;AAAA,IACrF,QAAQ;AAAA,IAER;AACA,wBAAoB,WAAW,MAAM,OAAO;AAAA,EAC9C;AAEA,WAAS,WAAW,OAAoC;AACtD,cAAU,QAAQ,KAAK,YAAY;AACjC,UAAI,QAAS;AACb,UAAI;AACF,YAAI,CAAC,SAAS;AACZ,gBAAM,IAAI,KAAK,MAAM,WAAW,KAAK;AACrC,cAAI,aAAa,QAAS,OAAM;AAChC,oBAAU;AACV,oBAAU,aAAa,0BAA0B,SAAS;AAAA,QAC5D,WAAW,KAAK,QAAQ;AACtB,gBAAM,IAAI,KAAK,OAAO,WAAW,KAAK;AACtC,cAAI,aAAa,QAAS,OAAM;AAAA,QAClC,OAAO;AACL,gBAAM,KAAK,QAAQ,SAAS;AAC5B,oBAAU;AACV,gBAAM,IAAI,KAAK,MAAM,WAAW,KAAK;AACrC,cAAI,aAAa,QAAS,OAAM;AAChC,oBAAU;AAAA,QACZ;AAAA,MACF,SAAS,OAAO;AACd,oBAAY,gBAAgB,kBAAkB,KAAK;AAAA,MACrD;AAAA,IACF,CAAC;AACD,WAAO;AAAA,EACT;AAEA,iBAAe,cAA6B;AAC1C,UAAM;AACN,QAAI,CAAC,QAAS;AACd,cAAU;AACV,UAAM,KAAK,QAAQ,SAAS;AAAA,EAC9B;AAIA,QAAM,kBAAkB,CAAC,WAAiD;AACxE,gBAAY;AACZ,uBAAmB;AACnB,QAAI,CAAC,gBAAiB;AACtB,QAAI,WAAW,eAAe,OAAW,MAAK,WAAW,aAAa,CAAC;AAAA,EACzE;AAEA,QAAM,yBAAyB,CAAC,WAAwD;AAGtF,QAAI,CAAC,gBAAiB;AACtB,uBAAmB;AACnB,SAAK,WAAW,aAAa,CAAC;AAAA,EAChC;AAEA,QAAM,mBAAmB,CAAC,WAAkD;AAC1E,iBAAa;AACb,SAAK,WAAW,aAAa,CAAC;AAAA,EAChC;AAEA,QAAM,sBAAsB,MAAM;AAChC,SAAK,WAAW,aAAa,CAAC;AAAA,EAChC;AAEA,QAAM,2BAA2B,MAAM;AACrC,QAAI,QAAS,MAAK,WAAW,aAAa,CAAC;AAAA,EAC7C;AAEA,MAAI,iBAAiB,aAAa,eAAe;AACjD,MAAI,iBAAiB,oBAAoB,sBAAsB;AAC/D,MAAI,iBAAiB,cAAc,gBAAgB;AACnD,MAAI,iBAAiB,iBAAiB,mBAAmB;AACzD,MAAI,iBAAiB,sBAAsB,wBAAwB;AAEnE,QAAM,mBAAmB,IAAI;AAC7B,QAAM,iBAAqD,OAAO,QAAQ,UAAU;AAClF,cAAU;AACV,mBAAe;AACf,sBAAkB;AAClB,UAAM,YAAY;AAClB,WAAQ,MAAM,mBAAmB,QAAQ,KAAK,KAAM,CAAC;AAAA,EACvD;AACA,MAAI,aAAa;AAEjB,WAAS,oBAA0B;AACjC,QAAI,oBAAoB,aAAa,eAAe;AACpD,QAAI,oBAAoB,oBAAoB,sBAAsB;AAClE,QAAI,oBAAoB,cAAc,gBAAgB;AACtD,QAAI,oBAAoB,iBAAiB,mBAAmB;AAC5D,QAAI,oBAAoB,sBAAsB,wBAAwB;AACtE,QAAI,IAAI,eAAe,eAAgB,KAAI,aAAa;AAAA,EAC1D;AAEA,QAAM,SAAS,YAAY;AACzB,QAAI;AACF,UAAI,CAAC,QAAQ,KAAK;AAGhB,cAAM,IAAI,QAAQ;AAAA,MACpB;AAEA,UAAI,CAAC,iBAAiB;AACpB,cAAM,WAAW,aAAa,CAAC;AAAA,MACjC;AAAA,IACF,SAAS,OAAO;AACd,YAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACrE,YAAM,OAAO,WAAW,KAAK,OAAO,IAChC,gBAAgB,qBAChB,gBAAgB;AACpB,kBAAY,MAAM,KAAK;AACvB,YAAM;AAAA,IACR;AAAA,EACF,GAAG;AAEH,MAAI,iBAA6B,MAAM;AAEvC,WAAS,aAAmB;AAC1B,QAAI,QAAS;AACb,cAAU;AACV,mBAAe;AACf,sBAAkB;AAClB,SAAK,YAAY;AACjB,QAAI,CAAC,QAAQ,IAAK,MAAK,IAAI,MAAM,EAAE,MAAM,MAAM,MAAS;AAAA,EAC1D;AAEA,mBACE,QAAQ,aAAa,UAAU,MAC9B,OAAO,WAAW,eACd,MAAM;AACL,UAAM,IAAI,MAAM,WAAW;AAC3B,WAAO,iBAAiB,gBAAgB,CAAC;AACzC,WAAO,MAAM,OAAO,oBAAoB,gBAAgB,CAAC;AAAA,EAC3D,GAAG,IACH,MAAM;AAEZ,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,MAAM;AAAA,EACR;AACF;","names":[]}