@nimblebrain/synapse - npm Package Compare versions

Comparing version 0.1.4 to 0.2.0

dist/chunk-ABJP7PL4.cjs

+'use strict';
+
+// src/detection.ts
+var DEFAULT_THEME = {
+  mode: "light",
+  primaryColor: "#6366f1",
+  tokens: {}
+};
+function detectHost(initResponse) {
+  const resp = initResponse;
+  const serverInfo = safeObj(resp?.serverInfo);
+  const serverName = typeof serverInfo?.name === "string" ? serverInfo.name : "unknown";
+  const protocolVersion = typeof resp?.protocolVersion === "string" ? resp.protocolVersion : "unknown";
+  const hostContext = safeObj(resp?.hostContext);
+  const theme = extractTheme(hostContext?.theme);
+  return {
+    isNimbleBrain: serverName === "nimblebrain",
+    serverName,
+    protocolVersion,
+    theme
+  };
+}
+function extractTheme(raw) {
+  const obj = safeObj(raw);
+  if (!obj) return { ...DEFAULT_THEME };
+  const mode = obj.mode === "light" || obj.mode === "dark" ? obj.mode : DEFAULT_THEME.mode;
+  const primaryColor = typeof obj.primaryColor === "string" ? obj.primaryColor : DEFAULT_THEME.primaryColor;
+  const tokens = obj.tokens !== null && typeof obj.tokens === "object" && !Array.isArray(obj.tokens) ? obj.tokens : {};
+  return { mode, primaryColor, tokens };
+}
+function safeObj(value) {
+  if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+    return value;
+  }
+  return void 0;
+}
+
+// src/keyboard.ts
+var KeyboardForwarder = class {
+  listener;
+  destroyed = false;
+  constructor(transport, customKeys) {
+    const config = customKeys ?? null;
+    this.listener = (event) => {
+      if (this.destroyed) return;
+      if (this.shouldForward(event, config)) {
+        event.preventDefault();
+        transport.send("ui/keydown", {
+          key: event.key,
+          ctrlKey: event.ctrlKey,
+          metaKey: event.metaKey,
+          shiftKey: event.shiftKey,
+          altKey: event.altKey
+        });
+      }
+    };
+    document.addEventListener("keydown", this.listener);
+  }
+  destroy() {
+    if (this.destroyed) return;
+    this.destroyed = true;
+    document.removeEventListener("keydown", this.listener);
+  }
+  shouldForward(event, config) {
+    if (config && config.length === 0) return false;
+    if (config) {
+      return config.some(
+        (k) => event.key.toLowerCase() === k.key.toLowerCase() && (k.ctrl === void 0 || event.ctrlKey === k.ctrl) && (k.meta === void 0 || event.metaKey === k.meta) && (k.shift === void 0 || event.shiftKey === k.shift) && (k.alt === void 0 || event.altKey === k.alt)
+      );
+    }
+    if (event.key === "Escape") return true;
+    if (event.ctrlKey || event.metaKey) return true;
+    return false;
+  }
+};
+
+// src/result-parser.ts
+function parseToolResult(raw) {
+  if (raw == null) {
+    return { data: null, isError: false };
+  }
+  if (isCallToolResult(raw)) {
+    return parseCallToolResult(raw);
+  }
+  return { data: raw, isError: false };
+}
+function isCallToolResult(value) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    return false;
+  }
+  return Array.isArray(value.content);
+}
+function isTextBlock(block) {
+  if (block === null || typeof block !== "object" || Array.isArray(block)) {
+    return false;
+  }
+  const obj = block;
+  return obj.type === "text" && typeof obj.text === "string";
+}
+function parseCallToolResult(result) {
+  const isError = result.isError === true;
+  const content = result.content;
+  if (content.length === 0) {
+    return { data: null, isError };
+  }
+  const firstText = content.find(isTextBlock);
+  if (!firstText) {
+    return { data: content, isError };
+  }
+  try {
+    return { data: JSON.parse(firstText.text), isError };
+  } catch {
+    return { data: firstText.text, isError };
+  }
+}
+
+// src/transport.ts
+var SynapseTransport = class {
+  counter = 0;
+  destroyed = false;
+  pending = /* @__PURE__ */ new Map();
+  handlers = /* @__PURE__ */ new Map();
+  listener;
+  constructor() {
+    this.listener = (event) => this.handleMessage(event);
+    window.addEventListener("message", this.listener);
+  }
+  send(method, params) {
+    if (this.destroyed) return;
+    const msg = {
+      jsonrpc: "2.0",
+      method,
+      ...params !== void 0 && { params }
+    };
+    window.parent.postMessage(msg, "*");
+  }
+  request(method, params) {
+    if (this.destroyed) {
+      return Promise.reject(new Error("Transport destroyed"));
+    }
+    const id = `syn-${++this.counter}`;
+    const msg = {
+      jsonrpc: "2.0",
+      method,
+      id,
+      ...params !== void 0 && { params }
+    };
+    return new Promise((resolve, reject) => {
+      this.pending.set(id, { resolve, reject });
+      window.parent.postMessage(msg, "*");
+    });
+  }
+  onMessage(method, callback) {
+    if (!this.handlers.has(method)) {
+      this.handlers.set(method, /* @__PURE__ */ new Set());
+    }
+    this.handlers.get(method)?.add(callback);
+    return () => {
+      const set = this.handlers.get(method);
+      if (set) {
+        set.delete(callback);
+        if (set.size === 0) {
+          this.handlers.delete(method);
+        }
+      }
+    };
+  }
+  destroy() {
+    if (this.destroyed) return;
+    this.destroyed = true;
+    window.removeEventListener("message", this.listener);
+    const error = new Error("Transport destroyed");
+    for (const entry of this.pending.values()) {
+      entry.reject(error);
+    }
+    this.pending.clear();
+    this.handlers.clear();
+  }
+  handleMessage(event) {
+    if (this.destroyed) return;
+    const data = event.data;
+    if (!data || data.jsonrpc !== "2.0") return;
+    if ("id" in data && data.id && !("method" in data)) {
+      const response = data;
+      const entry = this.pending.get(response.id);
+      if (!entry) return;
+      this.pending.delete(response.id);
+      if (response.error) {
+        const err = new Error(response.error.message);
+        err.code = response.error.code;
+        err.data = response.error.data;
+        entry.reject(err);
+      } else {
+        entry.resolve(response.result);
+      }
+      return;
+    }
+    if ("method" in data && !("id" in data && data.id)) {
+      const notification = data;
+      const set = this.handlers.get(notification.method);
+      if (set) {
+        for (const handler of set) {
+          handler(notification.params);
+        }
+      }
+    }
+  }
+};
+
+// src/core.ts
+function createSynapse(options) {
+  const { name, version, internal = false, forwardKeys } = options;
+  const transport = new SynapseTransport();
+  let hostInfo = null;
+  let currentTheme = {
+    mode: "light",
+    primaryColor: "#6366f1",
+    tokens: {}
+  };
+  let destroyed = false;
+  let stateTimer = null;
+  let keyboard = null;
+  const ready = transport.request("ui/initialize", {
+    protocolVersion: "2026-01-26",
+    clientInfo: { name, version },
+    capabilities: {}
+  }).then((result) => {
+    hostInfo = detectHost(result);
+    currentTheme = hostInfo.theme;
+    transport.send("ui/notifications/initialized", {});
+    keyboard = new KeyboardForwarder(transport, forwardKeys);
+  });
+  const unsubTheme = transport.onMessage("ui/notifications/host-context-changed", (params) => {
+    if (!params) return;
+    const mode = params.theme === "dark" ? "dark" : "light";
+    const tokens = params.tokens && typeof params.tokens === "object" ? params.tokens : currentTheme.tokens;
+    currentTheme = { mode, primaryColor: currentTheme.primaryColor, tokens };
+    for (const cb of themeCallbacks) cb(currentTheme);
+  });
+  const unsubNbTheme = transport.onMessage("ui/themeChanged", (params) => {
+    if (!params) return;
+    const mode = params.mode === "dark" || params.mode === "light" ? params.mode : currentTheme.mode;
+    const tokens = params.tokens && typeof params.tokens === "object" ? params.tokens : currentTheme.tokens;
+    currentTheme = { mode, primaryColor: currentTheme.primaryColor, tokens };
+    for (const cb of themeCallbacks) cb(currentTheme);
+  });
+  const themeCallbacks = /* @__PURE__ */ new Set();
+  const dataCallbacks = /* @__PURE__ */ new Set();
+  const actionCallbacks = /* @__PURE__ */ new Set();
+  const unsubData = transport.onMessage("ui/datachanged", (params) => {
+    if (!params) return;
+    const event = {
+      source: "agent",
+      server: params.server ?? "",
+      tool: params.tool ?? ""
+    };
+    for (const cb of dataCallbacks) cb(event);
+  });
+  const unsubAction = transport.onMessage("ui/action", (params) => {
+    if (!params || typeof params.type !== "string") return;
+    const action = {
+      type: params.type,
+      payload: params.payload ?? {},
+      requiresConfirmation: params.requiresConfirmation === true,
+      label: typeof params.label === "string" ? params.label : void 0
+    };
+    for (const cb of actionCallbacks) cb(action);
+  });
+  const isNB = () => hostInfo?.isNimbleBrain === true;
+  const synapse = {
+    get ready() {
+      return ready;
+    },
+    get isNimbleBrainHost() {
+      return isNB();
+    },
+    get destroyed() {
+      return destroyed;
+    },
+    async callTool(toolName, args) {
+      const params = {
+        name: toolName,
+        arguments: args ?? {}
+      };
+      if (internal) {
+        params.server = name;
+      }
+      const raw = await transport.request("tools/call", params);
+      return parseToolResult(raw);
+    },
+    onDataChanged(callback) {
+      dataCallbacks.add(callback);
+      return () => {
+        dataCallbacks.delete(callback);
+      };
+    },
+    onAction(callback) {
+      actionCallbacks.add(callback);
+      return () => {
+        actionCallbacks.delete(callback);
+      };
+    },
+    getTheme() {
+      return { ...currentTheme };
+    },
+    onThemeChanged(callback) {
+      themeCallbacks.add(callback);
+      return () => {
+        themeCallbacks.delete(callback);
+      };
+    },
+    action(action, params) {
+      if (!isNB()) return;
+      transport.send("ui/action", { action, ...params });
+    },
+    chat(message, context) {
+      if (!isNB()) return;
+      transport.send("ui/chat", { message, context });
+    },
+    setVisibleState(state, summary) {
+      if (!isNB()) return;
+      if (stateTimer) clearTimeout(stateTimer);
+      stateTimer = setTimeout(() => {
+        transport.send("ui/stateChanged", {
+          state,
+          ...summary !== void 0 && { summary }
+        });
+        stateTimer = null;
+      }, 250);
+    },
+    downloadFile(filename, content, mimeType) {
+      if (!isNB()) return;
+      const data = typeof content === "string" ? content : "[Blob content not serializable]";
+      transport.send("ui/downloadFile", {
+        data,
+        filename,
+        mimeType: mimeType ?? "application/octet-stream"
+      });
+    },
+    openLink(url) {
+      if (isNB()) {
+        transport.send("ui/openLink", { url });
+      } else {
+        window.open(url, "_blank", "noopener");
+      }
+    },
+    _onMessage(method, callback) {
+      return transport.onMessage(method, callback);
+    },
+    _request(method, params) {
+      return transport.request(method, params);
+    },
+    destroy() {
+      if (destroyed) return;
+      destroyed = true;
+      if (stateTimer) clearTimeout(stateTimer);
+      keyboard?.destroy();
+      unsubTheme();
+      unsubNbTheme();
+      unsubData();
+      unsubAction();
+      themeCallbacks.clear();
+      dataCallbacks.clear();
+      actionCallbacks.clear();
+      transport.destroy();
+    }
+  };
+  return synapse;
+}
+
+exports.createSynapse = createSynapse;
+//# sourceMappingURL=chunk-ABJP7PL4.cjs.map
+//# sourceMappingURL=chunk-ABJP7PL4.cjs.map

dist/chunk-ABJP7PL4.cjs.map

+{"version":3,"sources":["../src/detection.ts","../src/keyboard.ts","../src/result-parser.ts","../src/transport.ts","../src/core.ts"],"names":[],"mappings":"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","file":"chunk-ABJP7PL4.cjs","sourcesContent":["import type { HostInfo, SynapseTheme } from \"./types\";\n\nconst DEFAULT_THEME: SynapseTheme = {\n  mode: \"light\",\n  primaryColor: \"#6366f1\",\n  tokens: {},\n};\n\n/**\n * Detect the host environment from the ext-apps `ui/initialize` response.\n *\n * Handles missing or malformed fields gracefully — never throws.\n */\nexport function detectHost(initResponse: unknown): HostInfo {\n  const resp = initResponse as Record<string, unknown> | null | undefined;\n\n  const serverInfo = safeObj(resp?.serverInfo);\n  const serverName = typeof serverInfo?.name === \"string\" ? serverInfo.name : \"unknown\";\n\n  const protocolVersion =\n    typeof resp?.protocolVersion === \"string\" ? resp.protocolVersion : \"unknown\";\n\n  const hostContext = safeObj(resp?.hostContext);\n  const theme = extractTheme(hostContext?.theme);\n\n  return {\n    isNimbleBrain: serverName === \"nimblebrain\",\n    serverName,\n    protocolVersion,\n    theme,\n  };\n}\n\nfunction extractTheme(raw: unknown): SynapseTheme {\n  const obj = safeObj(raw);\n  if (!obj) return { ...DEFAULT_THEME };\n\n  const mode = obj.mode === \"light\" || obj.mode === \"dark\" ? obj.mode : DEFAULT_THEME.mode;\n\n  const primaryColor =\n    typeof obj.primaryColor === \"string\" ? obj.primaryColor : DEFAULT_THEME.primaryColor;\n\n  const tokens =\n    obj.tokens !== null && typeof obj.tokens === \"object\" && !Array.isArray(obj.tokens)\n      ? (obj.tokens as Record<string, string>)\n      : {};\n\n  return { mode, primaryColor, tokens };\n}\n\nfunction safeObj(value: unknown): Record<string, unknown> | undefined {\n  if (value !== null && typeof value === \"object\" && !Array.isArray(value)) {\n    return value as Record<string, unknown>;\n  }\n  return undefined;\n}\n","import type { SynapseTransport } from \"./transport.js\";\nimport type { KeyForwardConfig } from \"./types.js\";\n\n/**\n * Forward keyboard shortcuts from the iframe document to the host.\n *\n * By default, forwards all Ctrl/Cmd+key combos and Escape.\n * Apps can customize via `forwardKeys` config.\n */\nexport class KeyboardForwarder {\n  private listener: (event: KeyboardEvent) => void;\n  private destroyed = false;\n\n  constructor(transport: SynapseTransport, customKeys?: KeyForwardConfig[]) {\n    const config = customKeys ?? null; // null = default behavior\n\n    this.listener = (event: KeyboardEvent) => {\n      if (this.destroyed) return;\n      if (this.shouldForward(event, config)) {\n        event.preventDefault();\n        transport.send(\"ui/keydown\", {\n          key: event.key,\n          ctrlKey: event.ctrlKey,\n          metaKey: event.metaKey,\n          shiftKey: event.shiftKey,\n          altKey: event.altKey,\n        });\n      }\n    };\n\n    document.addEventListener(\"keydown\", this.listener);\n  }\n\n  destroy(): void {\n    if (this.destroyed) return;\n    this.destroyed = true;\n    document.removeEventListener(\"keydown\", this.listener);\n  }\n\n  private shouldForward(event: KeyboardEvent, config: KeyForwardConfig[] | null): boolean {\n    // Empty array = forwarding disabled\n    if (config && config.length === 0) return false;\n\n    // Custom config: match exactly\n    if (config) {\n      return config.some(\n        (k) =>\n          event.key.toLowerCase() === k.key.toLowerCase() &&\n          (k.ctrl === undefined || event.ctrlKey === k.ctrl) &&\n          (k.meta === undefined || event.metaKey === k.meta) &&\n          (k.shift === undefined || event.shiftKey === k.shift) &&\n          (k.alt === undefined || event.altKey === k.alt),\n      );\n    }\n\n    // Default: forward all Ctrl/Cmd combos + Escape\n    if (event.key === \"Escape\") return true;\n    if (event.ctrlKey || event.metaKey) return true;\n    return false;\n  }\n}\n","import type { ToolCallResult } from \"./types.js\";\n\n/**\n * Normalize a raw tool call response into a consistent `ToolCallResult`.\n *\n * Handles three shapes:\n * 1. MCP `CallToolResult` — has a `content` array with typed blocks.\n * 2. Raw JSON object (NimbleBrain bridge) — used as-is.\n * 3. Null / undefined — returns `{ data: null, isError: false }`.\n */\nexport function parseToolResult(raw: unknown): ToolCallResult {\n  if (raw == null) {\n    return { data: null, isError: false };\n  }\n\n  if (isCallToolResult(raw)) {\n    return parseCallToolResult(raw);\n  }\n\n  // Raw JSON object — pass through.\n  return { data: raw, isError: false };\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\ninterface McpTextBlock {\n  type: \"text\";\n  text: string;\n}\n\ninterface McpCallToolResult {\n  content: unknown[];\n  isError?: boolean;\n}\n\nfunction isCallToolResult(value: unknown): value is McpCallToolResult {\n  if (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n    return false;\n  }\n  return Array.isArray((value as Record<string, unknown>).content);\n}\n\nfunction isTextBlock(block: unknown): block is McpTextBlock {\n  if (block === null || typeof block !== \"object\" || Array.isArray(block)) {\n    return false;\n  }\n  const obj = block as Record<string, unknown>;\n  return obj.type === \"text\" && typeof obj.text === \"string\";\n}\n\nfunction parseCallToolResult(result: McpCallToolResult): ToolCallResult {\n  const isError = result.isError === true;\n  const content = result.content;\n\n  if (content.length === 0) {\n    return { data: null, isError };\n  }\n\n  const firstText = content.find(isTextBlock);\n\n  if (!firstText) {\n    // No text blocks — return the full content array so callers can inspect it.\n    return { data: content, isError };\n  }\n\n  // Try to parse JSON from the text block.\n  try {\n    return { data: JSON.parse(firstText.text), isError };\n  } catch {\n    // Invalid JSON — return the raw string.\n    return { data: firstText.text, isError };\n  }\n}\n","import type {\n  JsonRpcMessage,\n  JsonRpcNotification,\n  JsonRpcRequest,\n  JsonRpcResponse,\n} from \"./types.js\";\n\ntype PendingEntry = {\n  resolve: (value: unknown) => void;\n  reject: (reason: unknown) => void;\n};\n\ntype MessageHandler = (params: Record<string, unknown> | undefined) => void;\n\nexport class SynapseTransport {\n  private counter = 0;\n  private destroyed = false;\n  private pending = new Map<string, PendingEntry>();\n  private handlers = new Map<string, Set<MessageHandler>>();\n  private listener: (event: MessageEvent) => void;\n\n  constructor() {\n    this.listener = (event: MessageEvent) => this.handleMessage(event);\n    window.addEventListener(\"message\", this.listener);\n  }\n\n  send(method: string, params?: Record<string, unknown>): void {\n    if (this.destroyed) return;\n\n    const msg: JsonRpcNotification = {\n      jsonrpc: \"2.0\",\n      method,\n      ...(params !== undefined && { params }),\n    };\n    window.parent.postMessage(msg, \"*\");\n  }\n\n  request(method: string, params?: Record<string, unknown>): Promise<unknown> {\n    if (this.destroyed) {\n      return Promise.reject(new Error(\"Transport destroyed\"));\n    }\n\n    const id = `syn-${++this.counter}`;\n    const msg: JsonRpcRequest = {\n      jsonrpc: \"2.0\",\n      method,\n      id,\n      ...(params !== undefined && { params }),\n    };\n\n    return new Promise<unknown>((resolve, reject) => {\n      this.pending.set(id, { resolve, reject });\n      window.parent.postMessage(msg, \"*\");\n    });\n  }\n\n  onMessage(method: string, callback: MessageHandler): () => void {\n    if (!this.handlers.has(method)) {\n      this.handlers.set(method, new Set());\n    }\n    this.handlers.get(method)?.add(callback);\n\n    return () => {\n      const set = this.handlers.get(method);\n      if (set) {\n        set.delete(callback);\n        if (set.size === 0) {\n          this.handlers.delete(method);\n        }\n      }\n    };\n  }\n\n  destroy(): void {\n    if (this.destroyed) return;\n    this.destroyed = true;\n\n    window.removeEventListener(\"message\", this.listener);\n\n    const error = new Error(\"Transport destroyed\");\n    for (const entry of this.pending.values()) {\n      entry.reject(error);\n    }\n    this.pending.clear();\n    this.handlers.clear();\n  }\n\n  private handleMessage(event: MessageEvent): void {\n    if (this.destroyed) return;\n\n    const data = event.data as JsonRpcMessage;\n    if (!data || data.jsonrpc !== \"2.0\") return;\n\n    // Response to a pending request\n    if (\"id\" in data && data.id && !(\"method\" in data)) {\n      const response = data as JsonRpcResponse;\n      const entry = this.pending.get(response.id);\n      if (!entry) return;\n      this.pending.delete(response.id);\n\n      if (response.error) {\n        const err = new Error(response.error.message);\n        (err as any).code = response.error.code;\n        (err as any).data = response.error.data;\n        entry.reject(err);\n      } else {\n        entry.resolve(response.result);\n      }\n      return;\n    }\n\n    // Incoming notification\n    if (\"method\" in data && !(\"id\" in data && data.id)) {\n      const notification = data as JsonRpcNotification;\n      const set = this.handlers.get(notification.method);\n      if (set) {\n        for (const handler of set) {\n          handler(notification.params);\n        }\n      }\n    }\n  }\n}\n","import { detectHost } from \"./detection.js\";\nimport { KeyboardForwarder } from \"./keyboard.js\";\nimport { parseToolResult } from \"./result-parser.js\";\nimport { SynapseTransport } from \"./transport.js\";\nimport type {\n  AgentAction,\n  DataChangedEvent,\n  HostInfo,\n  Synapse,\n  SynapseOptions,\n  SynapseTheme,\n  ToolCallResult,\n} from \"./types.js\";\n\n/**\n * Create a Synapse instance.\n *\n * Wraps the ext-apps protocol handshake via `SynapseTransport` and provides\n * a typed, framework-agnostic API for calling tools, reacting to data changes,\n * dispatching actions, and pushing LLM-visible state.\n *\n * In non-NimbleBrain hosts, NB-specific methods degrade to no-ops.\n */\nexport function createSynapse(options: SynapseOptions): Synapse {\n  const { name, version, internal = false, forwardKeys } = options;\n\n  const transport = new SynapseTransport();\n  let hostInfo: HostInfo | null = null;\n  let currentTheme: SynapseTheme = {\n    mode: \"light\",\n    primaryColor: \"#6366f1\",\n    tokens: {},\n  };\n  let destroyed = false;\n\n  // --- Debounce for setVisibleState ---\n  let stateTimer: ReturnType<typeof setTimeout> | null = null;\n\n  // --- Keyboard forwarding ---\n  let keyboard: KeyboardForwarder | null = null;\n\n  // --- ext-apps handshake ---\n  // We send ui/initialize as a JSON-RPC request and wait for the response.\n  const ready = transport\n    .request(\"ui/initialize\", {\n      protocolVersion: \"2026-01-26\",\n      clientInfo: { name, version },\n      capabilities: {},\n    })\n    .then((result) => {\n      hostInfo = detectHost(result);\n      currentTheme = hostInfo.theme;\n\n      // Send initialized notification per ext-apps spec\n      transport.send(\"ui/notifications/initialized\", {});\n\n      // Set up keyboard forwarding after we know the host\n      keyboard = new KeyboardForwarder(transport, forwardKeys);\n    });\n\n  // Listen for theme changes from the host\n  const unsubTheme = transport.onMessage(\"ui/notifications/host-context-changed\", (params) => {\n    if (!params) return;\n    const mode = params.theme === \"dark\" ? \"dark\" : \"light\";\n    const tokens =\n      params.tokens && typeof params.tokens === \"object\"\n        ? (params.tokens as Record<string, string>)\n        : currentTheme.tokens;\n    currentTheme = { mode, primaryColor: currentTheme.primaryColor, tokens };\n    for (const cb of themeCallbacks) cb(currentTheme);\n  });\n\n  // Also listen for NB-specific theme change message\n  const unsubNbTheme = transport.onMessage(\"ui/themeChanged\", (params) => {\n    if (!params) return;\n    const mode =\n      params.mode === \"dark\" || params.mode === \"light\" ? params.mode : currentTheme.mode;\n    const tokens =\n      params.tokens && typeof params.tokens === \"object\"\n        ? (params.tokens as Record<string, string>)\n        : currentTheme.tokens;\n    currentTheme = { mode, primaryColor: currentTheme.primaryColor, tokens };\n    for (const cb of themeCallbacks) cb(currentTheme);\n  });\n\n  const themeCallbacks = new Set<(theme: SynapseTheme) => void>();\n  const dataCallbacks = new Set<(event: DataChangedEvent) => void>();\n  const actionCallbacks = new Set<(action: AgentAction) => void>();\n\n  // Listen for data change events\n  const unsubData = transport.onMessage(\"ui/datachanged\", (params) => {\n    if (!params) return;\n    const event: DataChangedEvent = {\n      source: \"agent\",\n      server: (params.server as string) ?? \"\",\n      tool: (params.tool as string) ?? \"\",\n    };\n    for (const cb of dataCallbacks) cb(event);\n  });\n\n  // Listen for agent actions (typed, declarative commands from the server)\n  const unsubAction = transport.onMessage(\"ui/action\", (params) => {\n    if (!params || typeof params.type !== \"string\") return;\n    const action: AgentAction = {\n      type: params.type as string,\n      payload: (params.payload as Record<string, unknown>) ?? {},\n      requiresConfirmation: params.requiresConfirmation === true,\n      label: typeof params.label === \"string\" ? params.label : undefined,\n    };\n    for (const cb of actionCallbacks) cb(action);\n  });\n\n  const isNB = () => hostInfo?.isNimbleBrain === true;\n\n  const synapse: Synapse = {\n    get ready() {\n      return ready;\n    },\n\n    get isNimbleBrainHost() {\n      return isNB();\n    },\n\n    get destroyed() {\n      return destroyed;\n    },\n\n    async callTool<TInput = Record<string, unknown>, TOutput = unknown>(\n      toolName: string,\n      args?: TInput,\n    ): Promise<ToolCallResult<TOutput>> {\n      const params: Record<string, unknown> = {\n        name: toolName,\n        arguments: args ?? {},\n      };\n      // Internal apps can cross-call\n      if (internal) {\n        params.server = name;\n      }\n      const raw = await transport.request(\"tools/call\", params);\n      return parseToolResult(raw) as ToolCallResult<TOutput>;\n    },\n\n    onDataChanged(callback: (event: DataChangedEvent) => void): () => void {\n      dataCallbacks.add(callback);\n      return () => {\n        dataCallbacks.delete(callback);\n      };\n    },\n\n    onAction(callback: (action: AgentAction) => void): () => void {\n      actionCallbacks.add(callback);\n      return () => {\n        actionCallbacks.delete(callback);\n      };\n    },\n\n    getTheme(): SynapseTheme {\n      return { ...currentTheme };\n    },\n\n    onThemeChanged(callback: (theme: SynapseTheme) => void): () => void {\n      themeCallbacks.add(callback);\n      return () => {\n        themeCallbacks.delete(callback);\n      };\n    },\n\n    action(action: string, params?: Record<string, unknown>): void {\n      if (!isNB()) return;\n      transport.send(\"ui/action\", { action, ...params });\n    },\n\n    chat(message: string, context?: { action?: string; entity?: string }): void {\n      if (!isNB()) return;\n      transport.send(\"ui/chat\", { message, context });\n    },\n\n    setVisibleState(state: Record<string, unknown>, summary?: string): void {\n      if (!isNB()) return;\n\n      // Debounce: 250ms\n      if (stateTimer) clearTimeout(stateTimer);\n      stateTimer = setTimeout(() => {\n        transport.send(\"ui/stateChanged\", {\n          state,\n          ...(summary !== undefined && { summary }),\n        });\n        stateTimer = null;\n      }, 250);\n    },\n\n    downloadFile(filename: string, content: string | Blob, mimeType?: string): void {\n      if (!isNB()) return;\n      const data = typeof content === \"string\" ? content : \"[Blob content not serializable]\";\n      transport.send(\"ui/downloadFile\", {\n        data,\n        filename,\n        mimeType: mimeType ?? \"application/octet-stream\",\n      });\n    },\n\n    openLink(url: string): void {\n      if (isNB()) {\n        transport.send(\"ui/openLink\", { url });\n      } else {\n        window.open(url, \"_blank\", \"noopener\");\n      }\n    },\n\n    _onMessage(\n      method: string,\n      callback: (params: Record<string, unknown> | undefined) => void,\n    ): () => void {\n      return transport.onMessage(method, callback);\n    },\n\n    _request(method: string, params?: Record<string, unknown>): Promise<unknown> {\n      return transport.request(method, params);\n    },\n\n    destroy(): void {\n      if (destroyed) return;\n      destroyed = true;\n\n      if (stateTimer) clearTimeout(stateTimer);\n      keyboard?.destroy();\n      unsubTheme();\n      unsubNbTheme();\n      unsubData();\n      unsubAction();\n      themeCallbacks.clear();\n      dataCallbacks.clear();\n      actionCallbacks.clear();\n      transport.destroy();\n    },\n  };\n\n  return synapse;\n}\n"]}

dist/chunk-BWSAQV3P.js

+// src/detection.ts
+var DEFAULT_THEME = {
+  mode: "light",
+  primaryColor: "#6366f1",
+  tokens: {}
+};
+function detectHost(initResponse) {
+  const resp = initResponse;
+  const serverInfo = safeObj(resp?.serverInfo);
+  const serverName = typeof serverInfo?.name === "string" ? serverInfo.name : "unknown";
+  const protocolVersion = typeof resp?.protocolVersion === "string" ? resp.protocolVersion : "unknown";
+  const hostContext = safeObj(resp?.hostContext);
+  const theme = extractTheme(hostContext?.theme);
+  return {
+    isNimbleBrain: serverName === "nimblebrain",
+    serverName,
+    protocolVersion,
+    theme
+  };
+}
+function extractTheme(raw) {
+  const obj = safeObj(raw);
+  if (!obj) return { ...DEFAULT_THEME };
+  const mode = obj.mode === "light" || obj.mode === "dark" ? obj.mode : DEFAULT_THEME.mode;
+  const primaryColor = typeof obj.primaryColor === "string" ? obj.primaryColor : DEFAULT_THEME.primaryColor;
+  const tokens = obj.tokens !== null && typeof obj.tokens === "object" && !Array.isArray(obj.tokens) ? obj.tokens : {};
+  return { mode, primaryColor, tokens };
+}
+function safeObj(value) {
+  if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+    return value;
+  }
+  return void 0;
+}
+
+// src/keyboard.ts
+var KeyboardForwarder = class {
+  listener;
+  destroyed = false;
+  constructor(transport, customKeys) {
+    const config = customKeys ?? null;
+    this.listener = (event) => {
+      if (this.destroyed) return;
+      if (this.shouldForward(event, config)) {
+        event.preventDefault();
+        transport.send("ui/keydown", {
+          key: event.key,
+          ctrlKey: event.ctrlKey,
+          metaKey: event.metaKey,
+          shiftKey: event.shiftKey,
+          altKey: event.altKey
+        });
+      }
+    };
+    document.addEventListener("keydown", this.listener);
+  }
+  destroy() {
+    if (this.destroyed) return;
+    this.destroyed = true;
+    document.removeEventListener("keydown", this.listener);
+  }
+  shouldForward(event, config) {
+    if (config && config.length === 0) return false;
+    if (config) {
+      return config.some(
+        (k) => event.key.toLowerCase() === k.key.toLowerCase() && (k.ctrl === void 0 || event.ctrlKey === k.ctrl) && (k.meta === void 0 || event.metaKey === k.meta) && (k.shift === void 0 || event.shiftKey === k.shift) && (k.alt === void 0 || event.altKey === k.alt)
+      );
+    }
+    if (event.key === "Escape") return true;
+    if (event.ctrlKey || event.metaKey) return true;
+    return false;
+  }
+};
+
+// src/result-parser.ts
+function parseToolResult(raw) {
+  if (raw == null) {
+    return { data: null, isError: false };
+  }
+  if (isCallToolResult(raw)) {
+    return parseCallToolResult(raw);
+  }
+  return { data: raw, isError: false };
+}
+function isCallToolResult(value) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    return false;
+  }
+  return Array.isArray(value.content);
+}
+function isTextBlock(block) {
+  if (block === null || typeof block !== "object" || Array.isArray(block)) {
+    return false;
+  }
+  const obj = block;
+  return obj.type === "text" && typeof obj.text === "string";
+}
+function parseCallToolResult(result) {
+  const isError = result.isError === true;
+  const content = result.content;
+  if (content.length === 0) {
+    return { data: null, isError };
+  }
+  const firstText = content.find(isTextBlock);
+  if (!firstText) {
+    return { data: content, isError };
+  }
+  try {
+    return { data: JSON.parse(firstText.text), isError };
+  } catch {
+    return { data: firstText.text, isError };
+  }
+}
+
+// src/transport.ts
+var SynapseTransport = class {
+  counter = 0;
+  destroyed = false;
+  pending = /* @__PURE__ */ new Map();
+  handlers = /* @__PURE__ */ new Map();
+  listener;
+  constructor() {
+    this.listener = (event) => this.handleMessage(event);
+    window.addEventListener("message", this.listener);
+  }
+  send(method, params) {
+    if (this.destroyed) return;
+    const msg = {
+      jsonrpc: "2.0",
+      method,
+      ...params !== void 0 && { params }
+    };
+    window.parent.postMessage(msg, "*");
+  }
+  request(method, params) {
+    if (this.destroyed) {
+      return Promise.reject(new Error("Transport destroyed"));
+    }
+    const id = `syn-${++this.counter}`;
+    const msg = {
+      jsonrpc: "2.0",
+      method,
+      id,
+      ...params !== void 0 && { params }
+    };
+    return new Promise((resolve, reject) => {
+      this.pending.set(id, { resolve, reject });
+      window.parent.postMessage(msg, "*");
+    });
+  }
+  onMessage(method, callback) {
+    if (!this.handlers.has(method)) {
+      this.handlers.set(method, /* @__PURE__ */ new Set());
+    }
+    this.handlers.get(method)?.add(callback);
+    return () => {
+      const set = this.handlers.get(method);
+      if (set) {
+        set.delete(callback);
+        if (set.size === 0) {
+          this.handlers.delete(method);
+        }
+      }
+    };
+  }
+  destroy() {
+    if (this.destroyed) return;
+    this.destroyed = true;
+    window.removeEventListener("message", this.listener);
+    const error = new Error("Transport destroyed");
+    for (const entry of this.pending.values()) {
+      entry.reject(error);
+    }
+    this.pending.clear();
+    this.handlers.clear();
+  }
+  handleMessage(event) {
+    if (this.destroyed) return;
+    const data = event.data;
+    if (!data || data.jsonrpc !== "2.0") return;
+    if ("id" in data && data.id && !("method" in data)) {
+      const response = data;
+      const entry = this.pending.get(response.id);
+      if (!entry) return;
+      this.pending.delete(response.id);
+      if (response.error) {
+        const err = new Error(response.error.message);
+        err.code = response.error.code;
+        err.data = response.error.data;
+        entry.reject(err);
+      } else {
+        entry.resolve(response.result);
+      }
+      return;
+    }
+    if ("method" in data && !("id" in data && data.id)) {
+      const notification = data;
+      const set = this.handlers.get(notification.method);
+      if (set) {
+        for (const handler of set) {
+          handler(notification.params);
+        }
+      }
+    }
+  }
+};
+
+// src/core.ts
+function createSynapse(options) {
+  const { name, version, internal = false, forwardKeys } = options;
+  const transport = new SynapseTransport();
+  let hostInfo = null;
+  let currentTheme = {
+    mode: "light",
+    primaryColor: "#6366f1",
+    tokens: {}
+  };
+  let destroyed = false;
+  let stateTimer = null;
+  let keyboard = null;
+  const ready = transport.request("ui/initialize", {
+    protocolVersion: "2026-01-26",
+    clientInfo: { name, version },
+    capabilities: {}
+  }).then((result) => {
+    hostInfo = detectHost(result);
+    currentTheme = hostInfo.theme;
+    transport.send("ui/notifications/initialized", {});
+    keyboard = new KeyboardForwarder(transport, forwardKeys);
+  });
+  const unsubTheme = transport.onMessage("ui/notifications/host-context-changed", (params) => {
+    if (!params) return;
+    const mode = params.theme === "dark" ? "dark" : "light";
+    const tokens = params.tokens && typeof params.tokens === "object" ? params.tokens : currentTheme.tokens;
+    currentTheme = { mode, primaryColor: currentTheme.primaryColor, tokens };
+    for (const cb of themeCallbacks) cb(currentTheme);
+  });
+  const unsubNbTheme = transport.onMessage("ui/themeChanged", (params) => {
+    if (!params) return;
+    const mode = params.mode === "dark" || params.mode === "light" ? params.mode : currentTheme.mode;
+    const tokens = params.tokens && typeof params.tokens === "object" ? params.tokens : currentTheme.tokens;
+    currentTheme = { mode, primaryColor: currentTheme.primaryColor, tokens };
+    for (const cb of themeCallbacks) cb(currentTheme);
+  });
+  const themeCallbacks = /* @__PURE__ */ new Set();
+  const dataCallbacks = /* @__PURE__ */ new Set();
+  const actionCallbacks = /* @__PURE__ */ new Set();
+  const unsubData = transport.onMessage("ui/datachanged", (params) => {
+    if (!params) return;
+    const event = {
+      source: "agent",
+      server: params.server ?? "",
+      tool: params.tool ?? ""
+    };
+    for (const cb of dataCallbacks) cb(event);
+  });
+  const unsubAction = transport.onMessage("ui/action", (params) => {
+    if (!params || typeof params.type !== "string") return;
+    const action = {
+      type: params.type,
+      payload: params.payload ?? {},
+      requiresConfirmation: params.requiresConfirmation === true,
+      label: typeof params.label === "string" ? params.label : void 0
+    };
+    for (const cb of actionCallbacks) cb(action);
+  });
+  const isNB = () => hostInfo?.isNimbleBrain === true;
+  const synapse = {
+    get ready() {
+      return ready;
+    },
+    get isNimbleBrainHost() {
+      return isNB();
+    },
+    get destroyed() {
+      return destroyed;
+    },
+    async callTool(toolName, args) {
+      const params = {
+        name: toolName,
+        arguments: args ?? {}
+      };
+      if (internal) {
+        params.server = name;
+      }
+      const raw = await transport.request("tools/call", params);
+      return parseToolResult(raw);
+    },
+    onDataChanged(callback) {
+      dataCallbacks.add(callback);
+      return () => {
+        dataCallbacks.delete(callback);
+      };
+    },
+    onAction(callback) {
+      actionCallbacks.add(callback);
+      return () => {
+        actionCallbacks.delete(callback);
+      };
+    },
+    getTheme() {
+      return { ...currentTheme };
+    },
+    onThemeChanged(callback) {
+      themeCallbacks.add(callback);
+      return () => {
+        themeCallbacks.delete(callback);
+      };
+    },
+    action(action, params) {
+      if (!isNB()) return;
+      transport.send("ui/action", { action, ...params });
+    },
+    chat(message, context) {
+      if (!isNB()) return;
+      transport.send("ui/chat", { message, context });
+    },
+    setVisibleState(state, summary) {
+      if (!isNB()) return;
+      if (stateTimer) clearTimeout(stateTimer);
+      stateTimer = setTimeout(() => {
+        transport.send("ui/stateChanged", {
+          state,
+          ...summary !== void 0 && { summary }
+        });
+        stateTimer = null;
+      }, 250);
+    },
+    downloadFile(filename, content, mimeType) {
+      if (!isNB()) return;
+      const data = typeof content === "string" ? content : "[Blob content not serializable]";
+      transport.send("ui/downloadFile", {
+        data,
+        filename,
+        mimeType: mimeType ?? "application/octet-stream"
+      });
+    },
+    openLink(url) {
+      if (isNB()) {
+        transport.send("ui/openLink", { url });
+      } else {
+        window.open(url, "_blank", "noopener");
+      }
+    },
+    _onMessage(method, callback) {
+      return transport.onMessage(method, callback);
+    },
+    _request(method, params) {
+      return transport.request(method, params);
+    },
+    destroy() {
+      if (destroyed) return;
+      destroyed = true;
+      if (stateTimer) clearTimeout(stateTimer);
+      keyboard?.destroy();
+      unsubTheme();
+      unsubNbTheme();
+      unsubData();
+      unsubAction();
+      themeCallbacks.clear();
+      dataCallbacks.clear();
+      actionCallbacks.clear();
+      transport.destroy();
+    }
+  };
+  return synapse;
+}
+
+export { createSynapse };
+//# sourceMappingURL=chunk-BWSAQV3P.js.map
+//# sourceMappingURL=chunk-BWSAQV3P.js.map

dist/chunk-BWSAQV3P.js.map

+{"version":3,"sources":["../src/detection.ts","../src/keyboard.ts","../src/result-parser.ts","../src/transport.ts","../src/core.ts"],"names":[],"mappings":";AAEA,IAAM,aAAA,GAA8B;AAAA,EAClC,IAAA,EAAM,OAAA;AAAA,EACN,YAAA,EAAc,SAAA;AAAA,EACd,QAAQ;AACV,CAAA;AAOO,SAAS,WAAW,YAAA,EAAiC;AAC1D,EAAA,MAAM,IAAA,GAAO,YAAA;AAEb,EAAA,MAAM,UAAA,GAAa,OAAA,CAAQ,IAAA,EAAM,UAAU,CAAA;AAC3C,EAAA,MAAM,aAAa,OAAO,UAAA,EAAY,IAAA,KAAS,QAAA,GAAW,WAAW,IAAA,GAAO,SAAA;AAE5E,EAAA,MAAM,kBACJ,OAAO,IAAA,EAAM,eAAA,KAAoB,QAAA,GAAW,KAAK,eAAA,GAAkB,SAAA;AAErE,EAAA,MAAM,WAAA,GAAc,OAAA,CAAQ,IAAA,EAAM,WAAW,CAAA;AAC7C,EAAA,MAAM,KAAA,GAAQ,YAAA,CAAa,WAAA,EAAa,KAAK,CAAA;AAE7C,EAAA,OAAO;AAAA,IACL,eAAe,UAAA,KAAe,aAAA;AAAA,IAC9B,UAAA;AAAA,IACA,eAAA;AAAA,IACA;AAAA,GACF;AACF;AAEA,SAAS,aAAa,GAAA,EAA4B;AAChD,EAAA,MAAM,GAAA,GAAM,QAAQ,GAAG,CAAA;AACvB,EAAA,IAAI,CAAC,GAAA,EAAK,OAAO,EAAE,GAAG,aAAA,EAAc;AAEpC,EAAA,MAAM,IAAA,GAAO,IAAI,IAAA,KAAS,OAAA,IAAW,IAAI,IAAA,KAAS,MAAA,GAAS,GAAA,CAAI,IAAA,GAAO,aAAA,CAAc,IAAA;AAEpF,EAAA,MAAM,eACJ,OAAO,GAAA,CAAI,iBAAiB,QAAA,GAAW,GAAA,CAAI,eAAe,aAAA,CAAc,YAAA;AAE1E,EAAA,MAAM,SACJ,GAAA,CAAI,MAAA,KAAW,IAAA,IAAQ,OAAO,IAAI,MAAA,KAAW,QAAA,IAAY,CAAC,KAAA,CAAM,QAAQ,GAAA,CAAI,MAAM,CAAA,GAC7E,GAAA,CAAI,SACL,EAAC;AAEP,EAAA,OAAO,EAAE,IAAA,EAAM,YAAA,EAAc,MAAA,EAAO;AACtC;AAEA,SAAS,QAAQ,KAAA,EAAqD;AACpE,EAAA,IAAI,KAAA,KAAU,QAAQ,OAAO,KAAA,KAAU,YAAY,CAAC,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG;AACxE,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,OAAO,MAAA;AACT;;;AC9CO,IAAM,oBAAN,MAAwB;AAAA,EACrB,QAAA;AAAA,EACA,SAAA,GAAY,KAAA;AAAA,EAEpB,WAAA,CAAY,WAA6B,UAAA,EAAiC;AACxE,IAAA,MAAM,SAAS,UAAA,IAAc,IAAA;AAE7B,IAAA,IAAA,CAAK,QAAA,GAAW,CAAC,KAAA,KAAyB;AACxC,MAAA,IAAI,KAAK,SAAA,EAAW;AACpB,MAAA,IAAI,IAAA,CAAK,aAAA,CAAc,KAAA,EAAO,MAAM,CAAA,EAAG;AACrC,QAAA,KAAA,CAAM,cAAA,EAAe;AACrB,QAAA,SAAA,CAAU,KAAK,YAAA,EAAc;AAAA,UAC3B,KAAK,KAAA,CAAM,GAAA;AAAA,UACX,SAAS,KAAA,CAAM,OAAA;AAAA,UACf,SAAS,KAAA,CAAM,OAAA;AAAA,UACf,UAAU,KAAA,CAAM,QAAA;AAAA,UAChB,QAAQ,KAAA,CAAM;AAAA,SACf,CAAA;AAAA,MACH;AAAA,IACF,CAAA;AAEA,IAAA,QAAA,CAAS,gBAAA,CAAiB,SAAA,EAAW,IAAA,CAAK,QAAQ,CAAA;AAAA,EACpD;AAAA,EAEA,OAAA,GAAgB;AACd,IAAA,IAAI,KAAK,SAAA,EAAW;AACpB,IAAA,IAAA,CAAK,SAAA,GAAY,IAAA;AACjB,IAAA,QAAA,CAAS,mBAAA,CAAoB,SAAA,EAAW,IAAA,CAAK,QAAQ,CAAA;AAAA,EACvD;AAAA,EAEQ,aAAA,CAAc,OAAsB,MAAA,EAA4C;AAEtF,IAAA,IAAI,MAAA,IAAU,MAAA,CAAO,MAAA,KAAW,CAAA,EAAG,OAAO,KAAA;AAG1C,IAAA,IAAI,MAAA,EAAQ;AACV,MAAA,OAAO,MAAA,CAAO,IAAA;AAAA,QACZ,CAAC,CAAA,KACC,KAAA,CAAM,GAAA,CAAI,WAAA,OAAkB,CAAA,CAAE,GAAA,CAAI,WAAA,EAAY,KAC7C,EAAE,IAAA,KAAS,MAAA,IAAa,KAAA,CAAM,OAAA,KAAY,EAAE,IAAA,CAAA,KAC5C,CAAA,CAAE,IAAA,KAAS,MAAA,IAAa,MAAM,OAAA,KAAY,CAAA,CAAE,IAAA,CAAA,KAC5C,CAAA,CAAE,UAAU,MAAA,IAAa,KAAA,CAAM,QAAA,KAAa,CAAA,CAAE,WAC9C,CAAA,CAAE,GAAA,KAAQ,MAAA,IAAa,KAAA,CAAM,WAAW,CAAA,CAAE,GAAA;AAAA,OAC/C;AAAA,IACF;AAGA,IAAA,IAAI,KAAA,CAAM,GAAA,KAAQ,QAAA,EAAU,OAAO,IAAA;AACnC,IAAA,IAAI,KAAA,CAAM,OAAA,IAAW,KAAA,CAAM,OAAA,EAAS,OAAO,IAAA;AAC3C,IAAA,OAAO,KAAA;AAAA,EACT;AACF,CAAA;;;AClDO,SAAS,gBAAgB,GAAA,EAA8B;AAC5D,EAAA,IAAI,OAAO,IAAA,EAAM;AACf,IAAA,OAAO,EAAE,IAAA,EAAM,IAAA,EAAM,OAAA,EAAS,KAAA,EAAM;AAAA,EACtC;AAEA,EAAA,IAAI,gBAAA,CAAiB,GAAG,CAAA,EAAG;AACzB,IAAA,OAAO,oBAAoB,GAAG,CAAA;AAAA,EAChC;AAGA,EAAA,OAAO,EAAE,IAAA,EAAM,GAAA,EAAK,OAAA,EAAS,KAAA,EAAM;AACrC;AAgBA,SAAS,iBAAiB,KAAA,EAA4C;AACpE,EAAA,IAAI,KAAA,KAAU,QAAQ,OAAO,KAAA,KAAU,YAAY,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG;AACvE,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,OAAO,KAAA,CAAM,OAAA,CAAS,KAAA,CAAkC,OAAO,CAAA;AACjE;AAEA,SAAS,YAAY,KAAA,EAAuC;AAC1D,EAAA,IAAI,KAAA,KAAU,QAAQ,OAAO,KAAA,KAAU,YAAY,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG;AACvE,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,MAAM,GAAA,GAAM,KAAA;AACZ,EAAA,OAAO,GAAA,CAAI,IAAA,KAAS,MAAA,IAAU,OAAO,IAAI,IAAA,KAAS,QAAA;AACpD;AAEA,SAAS,oBAAoB,MAAA,EAA2C;AACtE,EAAA,MAAM,OAAA,GAAU,OAAO,OAAA,KAAY,IAAA;AACnC,EAAA,MAAM,UAAU,MAAA,CAAO,OAAA;AAEvB,EAAA,IAAI,OAAA,CAAQ,WAAW,CAAA,EAAG;AACxB,IAAA,OAAO,EAAE,IAAA,EAAM,IAAA,EAAM,OAAA,EAAQ;AAAA,EAC/B;AAEA,EAAA,MAAM,SAAA,GAAY,OAAA,CAAQ,IAAA,CAAK,WAAW,CAAA;AAE1C,EAAA,IAAI,CAAC,SAAA,EAAW;AAEd,IAAA,OAAO,EAAE,IAAA,EAAM,OAAA,EAAS,OAAA,EAAQ;AAAA,EAClC;AAGA,EAAA,IAAI;AACF,IAAA,OAAO,EAAE,IAAA,EAAM,IAAA,CAAK,MAAM,SAAA,CAAU,IAAI,GAAG,OAAA,EAAQ;AAAA,EACrD,CAAA,CAAA,MAAQ;AAEN,IAAA,OAAO,EAAE,IAAA,EAAM,SAAA,CAAU,IAAA,EAAM,OAAA,EAAQ;AAAA,EACzC;AACF;;;AC5DO,IAAM,mBAAN,MAAuB;AAAA,EACpB,OAAA,GAAU,CAAA;AAAA,EACV,SAAA,GAAY,KAAA;AAAA,EACZ,OAAA,uBAAc,GAAA,EAA0B;AAAA,EACxC,QAAA,uBAAe,GAAA,EAAiC;AAAA,EAChD,QAAA;AAAA,EAER,WAAA,GAAc;AACZ,IAAA,IAAA,CAAK,QAAA,GAAW,CAAC,KAAA,KAAwB,IAAA,CAAK,cAAc,KAAK,CAAA;AACjE,IAAA,MAAA,CAAO,gBAAA,CAAiB,SAAA,EAAW,IAAA,CAAK,QAAQ,CAAA;AAAA,EAClD;AAAA,EAEA,IAAA,CAAK,QAAgB,MAAA,EAAwC;AAC3D,IAAA,IAAI,KAAK,SAAA,EAAW;AAEpB,IAAA,MAAM,GAAA,GAA2B;AAAA,MAC/B,OAAA,EAAS,KAAA;AAAA,MACT,MAAA;AAAA,MACA,GAAI,MAAA,KAAW,MAAA,IAAa,EAAE,MAAA;AAAO,KACvC;AACA,IAAA,MAAA,CAAO,MAAA,CAAO,WAAA,CAAY,GAAA,EAAK,GAAG,CAAA;AAAA,EACpC;AAAA,EAEA,OAAA,CAAQ,QAAgB,MAAA,EAAoD;AAC1E,IAAA,IAAI,KAAK,SAAA,EAAW;AAClB,MAAA,OAAO,OAAA,CAAQ,MAAA,CAAO,IAAI,KAAA,CAAM,qBAAqB,CAAC,CAAA;AAAA,IACxD;AAEA,IAAA,MAAM,EAAA,GAAK,CAAA,IAAA,EAAO,EAAE,IAAA,CAAK,OAAO,CAAA,CAAA;AAChC,IAAA,MAAM,GAAA,GAAsB;AAAA,MAC1B,OAAA,EAAS,KAAA;AAAA,MACT,MAAA;AAAA,MACA,EAAA;AAAA,MACA,GAAI,MAAA,KAAW,MAAA,IAAa,EAAE,MAAA;AAAO,KACvC;AAEA,IAAA,OAAO,IAAI,OAAA,CAAiB,CAAC,OAAA,EAAS,MAAA,KAAW;AAC/C,MAAA,IAAA,CAAK,QAAQ,GAAA,CAAI,EAAA,EAAI,EAAE,OAAA,EAAS,QAAQ,CAAA;AACxC,MAAA,MAAA,CAAO,MAAA,CAAO,WAAA,CAAY,GAAA,EAAK,GAAG,CAAA;AAAA,IACpC,CAAC,CAAA;AAAA,EACH;AAAA,EAEA,SAAA,CAAU,QAAgB,QAAA,EAAsC;AAC9D,IAAA,IAAI,CAAC,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,MAAM,CAAA,EAAG;AAC9B,MAAA,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,MAAA,kBAAQ,IAAI,KAAK,CAAA;AAAA,IACrC;AACA,IAAA,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,MAAM,CAAA,EAAG,IAAI,QAAQ,CAAA;AAEvC,IAAA,OAAO,MAAM;AACX,MAAA,MAAM,GAAA,GAAM,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,MAAM,CAAA;AACpC,MAAA,IAAI,GAAA,EAAK;AACP,QAAA,GAAA,CAAI,OAAO,QAAQ,CAAA;AACnB,QAAA,IAAI,GAAA,CAAI,SAAS,CAAA,EAAG;AAClB,UAAA,IAAA,CAAK,QAAA,CAAS,OAAO,MAAM,CAAA;AAAA,QAC7B;AAAA,MACF;AAAA,IACF,CAAA;AAAA,EACF;AAAA,EAEA,OAAA,GAAgB;AACd,IAAA,IAAI,KAAK,SAAA,EAAW;AACpB,IAAA,IAAA,CAAK,SAAA,GAAY,IAAA;AAEjB,IAAA,MAAA,CAAO,mBAAA,CAAoB,SAAA,EAAW,IAAA,CAAK,QAAQ,CAAA;AAEnD,IAAA,MAAM,KAAA,GAAQ,IAAI,KAAA,CAAM,qBAAqB,CAAA;AAC7C,IAAA,KAAA,MAAW,KAAA,IAAS,IAAA,CAAK,OAAA,CAAQ,MAAA,EAAO,EAAG;AACzC,MAAA,KAAA,CAAM,OAAO,KAAK,CAAA;AAAA,IACpB;AACA,IAAA,IAAA,CAAK,QAAQ,KAAA,EAAM;AACnB,IAAA,IAAA,CAAK,SAAS,KAAA,EAAM;AAAA,EACtB;AAAA,EAEQ,cAAc,KAAA,EAA2B;AAC/C,IAAA,IAAI,KAAK,SAAA,EAAW;AAEpB,IAAA,MAAM,OAAO,KAAA,CAAM,IAAA;AACnB,IAAA,IAAI,CAAC,IAAA,IAAQ,IAAA,CAAK,OAAA,KAAY,KAAA,EAAO;AAGrC,IAAA,IAAI,QAAQ,IAAA,IAAQ,IAAA,CAAK,EAAA,IAAM,EAAE,YAAY,IAAA,CAAA,EAAO;AAClD,MAAA,MAAM,QAAA,GAAW,IAAA;AACjB,MAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,SAAS,EAAE,CAAA;AAC1C,MAAA,IAAI,CAAC,KAAA,EAAO;AACZ,MAAA,IAAA,CAAK,OAAA,CAAQ,MAAA,CAAO,QAAA,CAAS,EAAE,CAAA;AAE/B,MAAA,IAAI,SAAS,KAAA,EAAO;AAClB,QAAA,MAAM,GAAA,GAAM,IAAI,KAAA,CAAM,QAAA,CAAS,MAAM,OAAO,CAAA;AAC5C,QAAC,GAAA,CAAY,IAAA,GAAO,QAAA,CAAS,KAAA,CAAM,IAAA;AACnC,QAAC,GAAA,CAAY,IAAA,GAAO,QAAA,CAAS,KAAA,CAAM,IAAA;AACnC,QAAA,KAAA,CAAM,OAAO,GAAG,CAAA;AAAA,MAClB,CAAA,MAAO;AACL,QAAA,KAAA,CAAM,OAAA,CAAQ,SAAS,MAAM,CAAA;AAAA,MAC/B;AACA,MAAA;AAAA,IACF;AAGA,IAAA,IAAI,YAAY,IAAA,IAAQ,EAAE,IAAA,IAAQ,IAAA,IAAQ,KAAK,EAAA,CAAA,EAAK;AAClD,MAAA,MAAM,YAAA,GAAe,IAAA;AACrB,MAAA,MAAM,GAAA,GAAM,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,aAAa,MAAM,CAAA;AACjD,MAAA,IAAI,GAAA,EAAK;AACP,QAAA,KAAA,MAAW,WAAW,GAAA,EAAK;AACzB,UAAA,OAAA,CAAQ,aAAa,MAAM,CAAA;AAAA,QAC7B;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF,CAAA;;;ACnGO,SAAS,cAAc,OAAA,EAAkC;AAC9D,EAAA,MAAM,EAAE,IAAA,EAAM,OAAA,EAAS,QAAA,GAAW,KAAA,EAAO,aAAY,GAAI,OAAA;AAEzD,EAAA,MAAM,SAAA,GAAY,IAAI,gBAAA,EAAiB;AACvC,EAAA,IAAI,QAAA,GAA4B,IAAA;AAChC,EAAA,IAAI,YAAA,GAA6B;AAAA,IAC/B,IAAA,EAAM,OAAA;AAAA,IACN,YAAA,EAAc,SAAA;AAAA,IACd,QAAQ;AAAC,GACX;AACA,EAAA,IAAI,SAAA,GAAY,KAAA;AAGhB,EAAA,IAAI,UAAA,GAAmD,IAAA;AAGvD,EAAA,IAAI,QAAA,GAAqC,IAAA;AAIzC,EAAA,MAAM,KAAA,GAAQ,SAAA,CACX,OAAA,CAAQ,eAAA,EAAiB;AAAA,IACxB,eAAA,EAAiB,YAAA;AAAA,IACjB,UAAA,EAAY,EAAE,IAAA,EAAM,OAAA,EAAQ;AAAA,IAC5B,cAAc;AAAC,GAChB,CAAA,CACA,IAAA,CAAK,CAAC,MAAA,KAAW;AAChB,IAAA,QAAA,GAAW,WAAW,MAAM,CAAA;AAC5B,IAAA,YAAA,GAAe,QAAA,CAAS,KAAA;AAGxB,IAAA,SAAA,CAAU,IAAA,CAAK,8BAAA,EAAgC,EAAE,CAAA;AAGjD,IAAA,QAAA,GAAW,IAAI,iBAAA,CAAkB,SAAA,EAAW,WAAW,CAAA;AAAA,EACzD,CAAC,CAAA;AAGH,EAAA,MAAM,UAAA,GAAa,SAAA,CAAU,SAAA,CAAU,uCAAA,EAAyC,CAAC,MAAA,KAAW;AAC1F,IAAA,IAAI,CAAC,MAAA,EAAQ;AACb,IAAA,MAAM,IAAA,GAAO,MAAA,CAAO,KAAA,KAAU,MAAA,GAAS,MAAA,GAAS,OAAA;AAChD,IAAA,MAAM,MAAA,GACJ,OAAO,MAAA,IAAU,OAAO,OAAO,MAAA,KAAW,QAAA,GACrC,MAAA,CAAO,MAAA,GACR,YAAA,CAAa,MAAA;AACnB,IAAA,YAAA,GAAe,EAAE,IAAA,EAAM,YAAA,EAAc,YAAA,CAAa,cAAc,MAAA,EAAO;AACvE,IAAA,KAAA,MAAW,EAAA,IAAM,cAAA,EAAgB,EAAA,CAAG,YAAY,CAAA;AAAA,EAClD,CAAC,CAAA;AAGD,EAAA,MAAM,YAAA,GAAe,SAAA,CAAU,SAAA,CAAU,iBAAA,EAAmB,CAAC,MAAA,KAAW;AACtE,IAAA,IAAI,CAAC,MAAA,EAAQ;AACb,IAAA,MAAM,IAAA,GACJ,OAAO,IAAA,KAAS,MAAA,IAAU,OAAO,IAAA,KAAS,OAAA,GAAU,MAAA,CAAO,IAAA,GAAO,YAAA,CAAa,IAAA;AACjF,IAAA,MAAM,MAAA,GACJ,OAAO,MAAA,IAAU,OAAO,OAAO,MAAA,KAAW,QAAA,GACrC,MAAA,CAAO,MAAA,GACR,YAAA,CAAa,MAAA;AACnB,IAAA,YAAA,GAAe,EAAE,IAAA,EAAM,YAAA,EAAc,YAAA,CAAa,cAAc,MAAA,EAAO;AACvE,IAAA,KAAA,MAAW,EAAA,IAAM,cAAA,EAAgB,EAAA,CAAG,YAAY,CAAA;AAAA,EAClD,CAAC,CAAA;AAED,EAAA,MAAM,cAAA,uBAAqB,GAAA,EAAmC;AAC9D,EAAA,MAAM,aAAA,uBAAoB,GAAA,EAAuC;AACjE,EAAA,MAAM,eAAA,uBAAsB,GAAA,EAAmC;AAG/D,EAAA,MAAM,SAAA,GAAY,SAAA,CAAU,SAAA,CAAU,gBAAA,EAAkB,CAAC,MAAA,KAAW;AAClE,IAAA,IAAI,CAAC,MAAA,EAAQ;AACb,IAAA,MAAM,KAAA,GAA0B;AAAA,MAC9B,MAAA,EAAQ,OAAA;AAAA,MACR,MAAA,EAAS,OAAO,MAAA,IAAqB,EAAA;AAAA,MACrC,IAAA,EAAO,OAAO,IAAA,IAAmB;AAAA,KACnC;AACA,IAAA,KAAA,MAAW,EAAA,IAAM,aAAA,EAAe,EAAA,CAAG,KAAK,CAAA;AAAA,EAC1C,CAAC,CAAA;AAGD,EAAA,MAAM,WAAA,GAAc,SAAA,CAAU,SAAA,CAAU,WAAA,EAAa,CAAC,MAAA,KAAW;AAC/D,IAAA,IAAI,CAAC,MAAA,IAAU,OAAO,MAAA,CAAO,SAAS,QAAA,EAAU;AAChD,IAAA,MAAM,MAAA,GAAsB;AAAA,MAC1B,MAAM,MAAA,CAAO,IAAA;AAAA,MACb,OAAA,EAAU,MAAA,CAAO,OAAA,IAAuC,EAAC;AAAA,MACzD,oBAAA,EAAsB,OAAO,oBAAA,KAAyB,IAAA;AAAA,MACtD,OAAO,OAAO,MAAA,CAAO,KAAA,KAAU,QAAA,GAAW,OAAO,KAAA,GAAQ;AAAA,KAC3D;AACA,IAAA,KAAA,MAAW,EAAA,IAAM,eAAA,EAAiB,EAAA,CAAG,MAAM,CAAA;AAAA,EAC7C,CAAC,CAAA;AAED,EAAA,MAAM,IAAA,GAAO,MAAM,QAAA,EAAU,aAAA,KAAkB,IAAA;AAE/C,EAAA,MAAM,OAAA,GAAmB;AAAA,IACvB,IAAI,KAAA,GAAQ;AACV,MAAA,OAAO,KAAA;AAAA,IACT,CAAA;AAAA,IAEA,IAAI,iBAAA,GAAoB;AACtB,MAAA,OAAO,IAAA,EAAK;AAAA,IACd,CAAA;AAAA,IAEA,IAAI,SAAA,GAAY;AACd,MAAA,OAAO,SAAA;AAAA,IACT,CAAA;AAAA,IAEA,MAAM,QAAA,CACJ,QAAA,EACA,IAAA,EACkC;AAClC,MAAA,MAAM,MAAA,GAAkC;AAAA,QACtC,IAAA,EAAM,QAAA;AAAA,QACN,SAAA,EAAW,QAAQ;AAAC,OACtB;AAEA,MAAA,IAAI,QAAA,EAAU;AACZ,QAAA,MAAA,CAAO,MAAA,GAAS,IAAA;AAAA,MAClB;AACA,MAAA,MAAM,GAAA,GAAM,MAAM,SAAA,CAAU,OAAA,CAAQ,cAAc,MAAM,CAAA;AACxD,MAAA,OAAO,gBAAgB,GAAG,CAAA;AAAA,IAC5B,CAAA;AAAA,IAEA,cAAc,QAAA,EAAyD;AACrE,MAAA,aAAA,CAAc,IAAI,QAAQ,CAAA;AAC1B,MAAA,OAAO,MAAM;AACX,QAAA,aAAA,CAAc,OAAO,QAAQ,CAAA;AAAA,MAC/B,CAAA;AAAA,IACF,CAAA;AAAA,IAEA,SAAS,QAAA,EAAqD;AAC5D,MAAA,eAAA,CAAgB,IAAI,QAAQ,CAAA;AAC5B,MAAA,OAAO,MAAM;AACX,QAAA,eAAA,CAAgB,OAAO,QAAQ,CAAA;AAAA,MACjC,CAAA;AAAA,IACF,CAAA;AAAA,IAEA,QAAA,GAAyB;AACvB,MAAA,OAAO,EAAE,GAAG,YAAA,EAAa;AAAA,IAC3B,CAAA;AAAA,IAEA,eAAe,QAAA,EAAqD;AAClE,MAAA,cAAA,CAAe,IAAI,QAAQ,CAAA;AAC3B,MAAA,OAAO,MAAM;AACX,QAAA,cAAA,CAAe,OAAO,QAAQ,CAAA;AAAA,MAChC,CAAA;AAAA,IACF,CAAA;AAAA,IAEA,MAAA,CAAO,QAAgB,MAAA,EAAwC;AAC7D,MAAA,IAAI,CAAC,MAAK,EAAG;AACb,MAAA,SAAA,CAAU,KAAK,WAAA,EAAa,EAAE,MAAA,EAAQ,GAAG,QAAQ,CAAA;AAAA,IACnD,CAAA;AAAA,IAEA,IAAA,CAAK,SAAiB,OAAA,EAAsD;AAC1E,MAAA,IAAI,CAAC,MAAK,EAAG;AACb,MAAA,SAAA,CAAU,IAAA,CAAK,SAAA,EAAW,EAAE,OAAA,EAAS,SAAS,CAAA;AAAA,IAChD,CAAA;AAAA,IAEA,eAAA,CAAgB,OAAgC,OAAA,EAAwB;AACtE,MAAA,IAAI,CAAC,MAAK,EAAG;AAGb,MAAA,IAAI,UAAA,eAAyB,UAAU,CAAA;AACvC,MAAA,UAAA,GAAa,WAAW,MAAM;AAC5B,QAAA,SAAA,CAAU,KAAK,iBAAA,EAAmB;AAAA,UAChC,KAAA;AAAA,UACA,GAAI,OAAA,KAAY,MAAA,IAAa,EAAE,OAAA;AAAQ,SACxC,CAAA;AACD,QAAA,UAAA,GAAa,IAAA;AAAA,MACf,GAAG,GAAG,CAAA;AAAA,IACR,CAAA;AAAA,IAEA,YAAA,CAAa,QAAA,EAAkB,OAAA,EAAwB,QAAA,EAAyB;AAC9E,MAAA,IAAI,CAAC,MAAK,EAAG;AACb,MAAA,MAAM,IAAA,GAAO,OAAO,OAAA,KAAY,QAAA,GAAW,OAAA,GAAU,iCAAA;AACrD,MAAA,SAAA,CAAU,KAAK,iBAAA,EAAmB;AAAA,QAChC,IAAA;AAAA,QACA,QAAA;AAAA,QACA,UAAU,QAAA,IAAY;AAAA,OACvB,CAAA;AAAA,IACH,CAAA;AAAA,IAEA,SAAS,GAAA,EAAmB;AAC1B,MAAA,IAAI,MAAK,EAAG;AACV,QAAA,SAAA,CAAU,IAAA,CAAK,aAAA,EAAe,EAAE,GAAA,EAAK,CAAA;AAAA,MACvC,CAAA,MAAO;AACL,QAAA,MAAA,CAAO,IAAA,CAAK,GAAA,EAAK,QAAA,EAAU,UAAU,CAAA;AAAA,MACvC;AAAA,IACF,CAAA;AAAA,IAEA,UAAA,CACE,QACA,QAAA,EACY;AACZ,MAAA,OAAO,SAAA,CAAU,SAAA,CAAU,MAAA,EAAQ,QAAQ,CAAA;AAAA,IAC7C,CAAA;AAAA,IAEA,QAAA,CAAS,QAAgB,MAAA,EAAoD;AAC3E,MAAA,OAAO,SAAA,CAAU,OAAA,CAAQ,MAAA,EAAQ,MAAM,CAAA;AAAA,IACzC,CAAA;AAAA,IAEA,OAAA,GAAgB;AACd,MAAA,IAAI,SAAA,EAAW;AACf,MAAA,SAAA,GAAY,IAAA;AAEZ,MAAA,IAAI,UAAA,eAAyB,UAAU,CAAA;AACvC,MAAA,QAAA,EAAU,OAAA,EAAQ;AAClB,MAAA,UAAA,EAAW;AACX,MAAA,YAAA,EAAa;AACb,MAAA,SAAA,EAAU;AACV,MAAA,WAAA,EAAY;AACZ,MAAA,cAAA,CAAe,KAAA,EAAM;AACrB,MAAA,aAAA,CAAc,KAAA,EAAM;AACpB,MAAA,eAAA,CAAgB,KAAA,EAAM;AACtB,MAAA,SAAA,CAAU,OAAA,EAAQ;AAAA,IACpB;AAAA,GACF;AAEA,EAAA,OAAO,OAAA;AACT","file":"chunk-BWSAQV3P.js","sourcesContent":["import type { HostInfo, SynapseTheme } from \"./types\";\n\nconst DEFAULT_THEME: SynapseTheme = {\n  mode: \"light\",\n  primaryColor: \"#6366f1\",\n  tokens: {},\n};\n\n/**\n * Detect the host environment from the ext-apps `ui/initialize` response.\n *\n * Handles missing or malformed fields gracefully — never throws.\n */\nexport function detectHost(initResponse: unknown): HostInfo {\n  const resp = initResponse as Record<string, unknown> | null | undefined;\n\n  const serverInfo = safeObj(resp?.serverInfo);\n  const serverName = typeof serverInfo?.name === \"string\" ? serverInfo.name : \"unknown\";\n\n  const protocolVersion =\n    typeof resp?.protocolVersion === \"string\" ? resp.protocolVersion : \"unknown\";\n\n  const hostContext = safeObj(resp?.hostContext);\n  const theme = extractTheme(hostContext?.theme);\n\n  return {\n    isNimbleBrain: serverName === \"nimblebrain\",\n    serverName,\n    protocolVersion,\n    theme,\n  };\n}\n\nfunction extractTheme(raw: unknown): SynapseTheme {\n  const obj = safeObj(raw);\n  if (!obj) return { ...DEFAULT_THEME };\n\n  const mode = obj.mode === \"light\" || obj.mode === \"dark\" ? obj.mode : DEFAULT_THEME.mode;\n\n  const primaryColor =\n    typeof obj.primaryColor === \"string\" ? obj.primaryColor : DEFAULT_THEME.primaryColor;\n\n  const tokens =\n    obj.tokens !== null && typeof obj.tokens === \"object\" && !Array.isArray(obj.tokens)\n      ? (obj.tokens as Record<string, string>)\n      : {};\n\n  return { mode, primaryColor, tokens };\n}\n\nfunction safeObj(value: unknown): Record<string, unknown> | undefined {\n  if (value !== null && typeof value === \"object\" && !Array.isArray(value)) {\n    return value as Record<string, unknown>;\n  }\n  return undefined;\n}\n","import type { SynapseTransport } from \"./transport.js\";\nimport type { KeyForwardConfig } from \"./types.js\";\n\n/**\n * Forward keyboard shortcuts from the iframe document to the host.\n *\n * By default, forwards all Ctrl/Cmd+key combos and Escape.\n * Apps can customize via `forwardKeys` config.\n */\nexport class KeyboardForwarder {\n  private listener: (event: KeyboardEvent) => void;\n  private destroyed = false;\n\n  constructor(transport: SynapseTransport, customKeys?: KeyForwardConfig[]) {\n    const config = customKeys ?? null; // null = default behavior\n\n    this.listener = (event: KeyboardEvent) => {\n      if (this.destroyed) return;\n      if (this.shouldForward(event, config)) {\n        event.preventDefault();\n        transport.send(\"ui/keydown\", {\n          key: event.key,\n          ctrlKey: event.ctrlKey,\n          metaKey: event.metaKey,\n          shiftKey: event.shiftKey,\n          altKey: event.altKey,\n        });\n      }\n    };\n\n    document.addEventListener(\"keydown\", this.listener);\n  }\n\n  destroy(): void {\n    if (this.destroyed) return;\n    this.destroyed = true;\n    document.removeEventListener(\"keydown\", this.listener);\n  }\n\n  private shouldForward(event: KeyboardEvent, config: KeyForwardConfig[] | null): boolean {\n    // Empty array = forwarding disabled\n    if (config && config.length === 0) return false;\n\n    // Custom config: match exactly\n    if (config) {\n      return config.some(\n        (k) =>\n          event.key.toLowerCase() === k.key.toLowerCase() &&\n          (k.ctrl === undefined || event.ctrlKey === k.ctrl) &&\n          (k.meta === undefined || event.metaKey === k.meta) &&\n          (k.shift === undefined || event.shiftKey === k.shift) &&\n          (k.alt === undefined || event.altKey === k.alt),\n      );\n    }\n\n    // Default: forward all Ctrl/Cmd combos + Escape\n    if (event.key === \"Escape\") return true;\n    if (event.ctrlKey || event.metaKey) return true;\n    return false;\n  }\n}\n","import type { ToolCallResult } from \"./types.js\";\n\n/**\n * Normalize a raw tool call response into a consistent `ToolCallResult`.\n *\n * Handles three shapes:\n * 1. MCP `CallToolResult` — has a `content` array with typed blocks.\n * 2. Raw JSON object (NimbleBrain bridge) — used as-is.\n * 3. Null / undefined — returns `{ data: null, isError: false }`.\n */\nexport function parseToolResult(raw: unknown): ToolCallResult {\n  if (raw == null) {\n    return { data: null, isError: false };\n  }\n\n  if (isCallToolResult(raw)) {\n    return parseCallToolResult(raw);\n  }\n\n  // Raw JSON object — pass through.\n  return { data: raw, isError: false };\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\ninterface McpTextBlock {\n  type: \"text\";\n  text: string;\n}\n\ninterface McpCallToolResult {\n  content: unknown[];\n  isError?: boolean;\n}\n\nfunction isCallToolResult(value: unknown): value is McpCallToolResult {\n  if (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n    return false;\n  }\n  return Array.isArray((value as Record<string, unknown>).content);\n}\n\nfunction isTextBlock(block: unknown): block is McpTextBlock {\n  if (block === null || typeof block !== \"object\" || Array.isArray(block)) {\n    return false;\n  }\n  const obj = block as Record<string, unknown>;\n  return obj.type === \"text\" && typeof obj.text === \"string\";\n}\n\nfunction parseCallToolResult(result: McpCallToolResult): ToolCallResult {\n  const isError = result.isError === true;\n  const content = result.content;\n\n  if (content.length === 0) {\n    return { data: null, isError };\n  }\n\n  const firstText = content.find(isTextBlock);\n\n  if (!firstText) {\n    // No text blocks — return the full content array so callers can inspect it.\n    return { data: content, isError };\n  }\n\n  // Try to parse JSON from the text block.\n  try {\n    return { data: JSON.parse(firstText.text), isError };\n  } catch {\n    // Invalid JSON — return the raw string.\n    return { data: firstText.text, isError };\n  }\n}\n","import type {\n  JsonRpcMessage,\n  JsonRpcNotification,\n  JsonRpcRequest,\n  JsonRpcResponse,\n} from \"./types.js\";\n\ntype PendingEntry = {\n  resolve: (value: unknown) => void;\n  reject: (reason: unknown) => void;\n};\n\ntype MessageHandler = (params: Record<string, unknown> | undefined) => void;\n\nexport class SynapseTransport {\n  private counter = 0;\n  private destroyed = false;\n  private pending = new Map<string, PendingEntry>();\n  private handlers = new Map<string, Set<MessageHandler>>();\n  private listener: (event: MessageEvent) => void;\n\n  constructor() {\n    this.listener = (event: MessageEvent) => this.handleMessage(event);\n    window.addEventListener(\"message\", this.listener);\n  }\n\n  send(method: string, params?: Record<string, unknown>): void {\n    if (this.destroyed) return;\n\n    const msg: JsonRpcNotification = {\n      jsonrpc: \"2.0\",\n      method,\n      ...(params !== undefined && { params }),\n    };\n    window.parent.postMessage(msg, \"*\");\n  }\n\n  request(method: string, params?: Record<string, unknown>): Promise<unknown> {\n    if (this.destroyed) {\n      return Promise.reject(new Error(\"Transport destroyed\"));\n    }\n\n    const id = `syn-${++this.counter}`;\n    const msg: JsonRpcRequest = {\n      jsonrpc: \"2.0\",\n      method,\n      id,\n      ...(params !== undefined && { params }),\n    };\n\n    return new Promise<unknown>((resolve, reject) => {\n      this.pending.set(id, { resolve, reject });\n      window.parent.postMessage(msg, \"*\");\n    });\n  }\n\n  onMessage(method: string, callback: MessageHandler): () => void {\n    if (!this.handlers.has(method)) {\n      this.handlers.set(method, new Set());\n    }\n    this.handlers.get(method)?.add(callback);\n\n    return () => {\n      const set = this.handlers.get(method);\n      if (set) {\n        set.delete(callback);\n        if (set.size === 0) {\n          this.handlers.delete(method);\n        }\n      }\n    };\n  }\n\n  destroy(): void {\n    if (this.destroyed) return;\n    this.destroyed = true;\n\n    window.removeEventListener(\"message\", this.listener);\n\n    const error = new Error(\"Transport destroyed\");\n    for (const entry of this.pending.values()) {\n      entry.reject(error);\n    }\n    this.pending.clear();\n    this.handlers.clear();\n  }\n\n  private handleMessage(event: MessageEvent): void {\n    if (this.destroyed) return;\n\n    const data = event.data as JsonRpcMessage;\n    if (!data || data.jsonrpc !== \"2.0\") return;\n\n    // Response to a pending request\n    if (\"id\" in data && data.id && !(\"method\" in data)) {\n      const response = data as JsonRpcResponse;\n      const entry = this.pending.get(response.id);\n      if (!entry) return;\n      this.pending.delete(response.id);\n\n      if (response.error) {\n        const err = new Error(response.error.message);\n        (err as any).code = response.error.code;\n        (err as any).data = response.error.data;\n        entry.reject(err);\n      } else {\n        entry.resolve(response.result);\n      }\n      return;\n    }\n\n    // Incoming notification\n    if (\"method\" in data && !(\"id\" in data && data.id)) {\n      const notification = data as JsonRpcNotification;\n      const set = this.handlers.get(notification.method);\n      if (set) {\n        for (const handler of set) {\n          handler(notification.params);\n        }\n      }\n    }\n  }\n}\n","import { detectHost } from \"./detection.js\";\nimport { KeyboardForwarder } from \"./keyboard.js\";\nimport { parseToolResult } from \"./result-parser.js\";\nimport { SynapseTransport } from \"./transport.js\";\nimport type {\n  AgentAction,\n  DataChangedEvent,\n  HostInfo,\n  Synapse,\n  SynapseOptions,\n  SynapseTheme,\n  ToolCallResult,\n} from \"./types.js\";\n\n/**\n * Create a Synapse instance.\n *\n * Wraps the ext-apps protocol handshake via `SynapseTransport` and provides\n * a typed, framework-agnostic API for calling tools, reacting to data changes,\n * dispatching actions, and pushing LLM-visible state.\n *\n * In non-NimbleBrain hosts, NB-specific methods degrade to no-ops.\n */\nexport function createSynapse(options: SynapseOptions): Synapse {\n  const { name, version, internal = false, forwardKeys } = options;\n\n  const transport = new SynapseTransport();\n  let hostInfo: HostInfo | null = null;\n  let currentTheme: SynapseTheme = {\n    mode: \"light\",\n    primaryColor: \"#6366f1\",\n    tokens: {},\n  };\n  let destroyed = false;\n\n  // --- Debounce for setVisibleState ---\n  let stateTimer: ReturnType<typeof setTimeout> | null = null;\n\n  // --- Keyboard forwarding ---\n  let keyboard: KeyboardForwarder | null = null;\n\n  // --- ext-apps handshake ---\n  // We send ui/initialize as a JSON-RPC request and wait for the response.\n  const ready = transport\n    .request(\"ui/initialize\", {\n      protocolVersion: \"2026-01-26\",\n      clientInfo: { name, version },\n      capabilities: {},\n    })\n    .then((result) => {\n      hostInfo = detectHost(result);\n      currentTheme = hostInfo.theme;\n\n      // Send initialized notification per ext-apps spec\n      transport.send(\"ui/notifications/initialized\", {});\n\n      // Set up keyboard forwarding after we know the host\n      keyboard = new KeyboardForwarder(transport, forwardKeys);\n    });\n\n  // Listen for theme changes from the host\n  const unsubTheme = transport.onMessage(\"ui/notifications/host-context-changed\", (params) => {\n    if (!params) return;\n    const mode = params.theme === \"dark\" ? \"dark\" : \"light\";\n    const tokens =\n      params.tokens && typeof params.tokens === \"object\"\n        ? (params.tokens as Record<string, string>)\n        : currentTheme.tokens;\n    currentTheme = { mode, primaryColor: currentTheme.primaryColor, tokens };\n    for (const cb of themeCallbacks) cb(currentTheme);\n  });\n\n  // Also listen for NB-specific theme change message\n  const unsubNbTheme = transport.onMessage(\"ui/themeChanged\", (params) => {\n    if (!params) return;\n    const mode =\n      params.mode === \"dark\" || params.mode === \"light\" ? params.mode : currentTheme.mode;\n    const tokens =\n      params.tokens && typeof params.tokens === \"object\"\n        ? (params.tokens as Record<string, string>)\n        : currentTheme.tokens;\n    currentTheme = { mode, primaryColor: currentTheme.primaryColor, tokens };\n    for (const cb of themeCallbacks) cb(currentTheme);\n  });\n\n  const themeCallbacks = new Set<(theme: SynapseTheme) => void>();\n  const dataCallbacks = new Set<(event: DataChangedEvent) => void>();\n  const actionCallbacks = new Set<(action: AgentAction) => void>();\n\n  // Listen for data change events\n  const unsubData = transport.onMessage(\"ui/datachanged\", (params) => {\n    if (!params) return;\n    const event: DataChangedEvent = {\n      source: \"agent\",\n      server: (params.server as string) ?? \"\",\n      tool: (params.tool as string) ?? \"\",\n    };\n    for (const cb of dataCallbacks) cb(event);\n  });\n\n  // Listen for agent actions (typed, declarative commands from the server)\n  const unsubAction = transport.onMessage(\"ui/action\", (params) => {\n    if (!params || typeof params.type !== \"string\") return;\n    const action: AgentAction = {\n      type: params.type as string,\n      payload: (params.payload as Record<string, unknown>) ?? {},\n      requiresConfirmation: params.requiresConfirmation === true,\n      label: typeof params.label === \"string\" ? params.label : undefined,\n    };\n    for (const cb of actionCallbacks) cb(action);\n  });\n\n  const isNB = () => hostInfo?.isNimbleBrain === true;\n\n  const synapse: Synapse = {\n    get ready() {\n      return ready;\n    },\n\n    get isNimbleBrainHost() {\n      return isNB();\n    },\n\n    get destroyed() {\n      return destroyed;\n    },\n\n    async callTool<TInput = Record<string, unknown>, TOutput = unknown>(\n      toolName: string,\n      args?: TInput,\n    ): Promise<ToolCallResult<TOutput>> {\n      const params: Record<string, unknown> = {\n        name: toolName,\n        arguments: args ?? {},\n      };\n      // Internal apps can cross-call\n      if (internal) {\n        params.server = name;\n      }\n      const raw = await transport.request(\"tools/call\", params);\n      return parseToolResult(raw) as ToolCallResult<TOutput>;\n    },\n\n    onDataChanged(callback: (event: DataChangedEvent) => void): () => void {\n      dataCallbacks.add(callback);\n      return () => {\n        dataCallbacks.delete(callback);\n      };\n    },\n\n    onAction(callback: (action: AgentAction) => void): () => void {\n      actionCallbacks.add(callback);\n      return () => {\n        actionCallbacks.delete(callback);\n      };\n    },\n\n    getTheme(): SynapseTheme {\n      return { ...currentTheme };\n    },\n\n    onThemeChanged(callback: (theme: SynapseTheme) => void): () => void {\n      themeCallbacks.add(callback);\n      return () => {\n        themeCallbacks.delete(callback);\n      };\n    },\n\n    action(action: string, params?: Record<string, unknown>): void {\n      if (!isNB()) return;\n      transport.send(\"ui/action\", { action, ...params });\n    },\n\n    chat(message: string, context?: { action?: string; entity?: string }): void {\n      if (!isNB()) return;\n      transport.send(\"ui/chat\", { message, context });\n    },\n\n    setVisibleState(state: Record<string, unknown>, summary?: string): void {\n      if (!isNB()) return;\n\n      // Debounce: 250ms\n      if (stateTimer) clearTimeout(stateTimer);\n      stateTimer = setTimeout(() => {\n        transport.send(\"ui/stateChanged\", {\n          state,\n          ...(summary !== undefined && { summary }),\n        });\n        stateTimer = null;\n      }, 250);\n    },\n\n    downloadFile(filename: string, content: string | Blob, mimeType?: string): void {\n      if (!isNB()) return;\n      const data = typeof content === \"string\" ? content : \"[Blob content not serializable]\";\n      transport.send(\"ui/downloadFile\", {\n        data,\n        filename,\n        mimeType: mimeType ?? \"application/octet-stream\",\n      });\n    },\n\n    openLink(url: string): void {\n      if (isNB()) {\n        transport.send(\"ui/openLink\", { url });\n      } else {\n        window.open(url, \"_blank\", \"noopener\");\n      }\n    },\n\n    _onMessage(\n      method: string,\n      callback: (params: Record<string, unknown> | undefined) => void,\n    ): () => void {\n      return transport.onMessage(method, callback);\n    },\n\n    _request(method: string, params?: Record<string, unknown>): Promise<unknown> {\n      return transport.request(method, params);\n    },\n\n    destroy(): void {\n      if (destroyed) return;\n      destroyed = true;\n\n      if (stateTimer) clearTimeout(stateTimer);\n      keyboard?.destroy();\n      unsubTheme();\n      unsubNbTheme();\n      unsubData();\n      unsubAction();\n      themeCallbacks.clear();\n      dataCallbacks.clear();\n      actionCallbacks.clear();\n      transport.destroy();\n    },\n  };\n\n  return synapse;\n}\n"]}

dist/server-3BDZ5S72.cjs

+'use strict';
+
+var child_process = require('child_process');
+var fs = require('fs');
+var http = require('http');
+var path = require('path');
+
+// src/preview/server.ts
+var HOST_HTML = (uiPort, serverPort) => `<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8" />
+  <title>Synapse Preview</title>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; background: #0f172a; color: #e2e8f0; }
+    header { padding: 12px 20px; background: #1e293b; border-bottom: 1px solid #334155; display: flex; align-items: center; gap: 12px; }
+    header h1 { font-size: 14px; font-weight: 500; }
+    header .dot { width: 8px; height: 8px; border-radius: 50%; background: #22c55e; }
+    header .info { font-size: 12px; color: #94a3b8; margin-left: auto; }
+    .theme-toggle { background: #334155; border: none; color: #e2e8f0; padding: 4px 10px; border-radius: 4px; cursor: pointer; font-size: 12px; }
+    iframe { width: 100%; height: calc(100vh - 45px); border: none; }
+  </style>
+</head>
+<body>
+  <header>
+    <span class="dot"></span>
+    <h1>Synapse Preview</h1>
+    <button class="theme-toggle" id="toggle">Toggle Dark/Light</button>
+    <span class="info">MCP: localhost:${serverPort} | UI: localhost:${uiPort}</span>
+  </header>
+  <iframe id="app" src="http://localhost:${uiPort}"></iframe>
+
+  <script>
+    var iframe = document.getElementById("app");
+    var darkMode = true;
+
+    // Minimal NimbleBrain bridge host \u2014 just enough to make Synapse work
+    var tokens = darkMode ? {
+      "--color-background-primary": "#0f172a", "--color-text-primary": "#e2e8f0",
+      "--color-background-secondary": "#1e293b", "--color-text-primary": "#e2e8f0",
+      "--color-text-accent": "#6366f1", "--nb-color-accent-foreground": "#ffffff",
+      "--color-text-secondary": "#94a3b8", "--color-border-primary": "#334155",
+      "--color-ring-primary": "#6366f1", "--nb-color-danger": "#ef4444",
+      "--border-radius-sm": "0.5rem",
+    } : {
+      "--color-background-primary": "#ffffff", "--color-text-primary": "#1a1a1a",
+      "--color-background-secondary": "#f9fafb", "--color-text-primary": "#1a1a1a",
+      "--color-text-accent": "#6366f1", "--nb-color-accent-foreground": "#ffffff",
+      "--color-text-secondary": "#6b7280", "--color-border-primary": "#e5e7eb",
+      "--color-ring-primary": "#6366f1", "--nb-color-danger": "#ef4444",
+      "--border-radius-sm": "0.5rem",
+    };
+
+    function post(msg) { iframe.contentWindow.postMessage(msg, "*"); }
+
+    window.addEventListener("message", async function (event) {
+      if (event.source !== iframe.contentWindow) return;
+      var msg = event.data;
+      if (!msg || typeof msg !== "object") return;
+
+      // ext-apps handshake
+      if (msg.method === "ui/initialize" && msg.id) {
+        post({
+          jsonrpc: "2.0", id: msg.id,
+          result: {
+            protocolVersion: "2026-01-26",
+            serverInfo: { name: "nimblebrain", version: "preview" },
+            capabilities: { openLinks: {}, serverTools: {} },
+            hostContext: { theme: darkMode ? "dark" : "light", primaryColor: "#6366f1", tokens: tokens }
+          }
+        });
+        return;
+      }
+
+      if (msg.method === "ui/notifications/initialized") return;
+
+      // Tool call proxy \u2014 forward to the MCP server
+      if (msg.method === "tools/call" && msg.id) {
+        try {
+          var resp = await fetch("http://localhost:${serverPort}/mcp", {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+              jsonrpc: "2.0", id: msg.id,
+              method: "tools/call",
+              params: { name: msg.params.name, arguments: msg.params.arguments || {} }
+            })
+          });
+          var result = await resp.json();
+          // Forward the JSON-RPC response back to the iframe
+          post(result);
+        } catch (err) {
+          post({ jsonrpc: "2.0", id: msg.id, error: { code: -32000, message: err.message || "Server error" } });
+        }
+        return;
+      }
+
+      // ui/chat \u2014 log to console
+      if (msg.method === "ui/chat") {
+        console.log("[chat]", msg.params?.message);
+        return;
+      }
+
+      // ui/action \u2014 log to console
+      if (msg.method === "ui/action") {
+        console.log("[action]", msg.params?.action, msg.params);
+        return;
+      }
+
+      // ui/keydown \u2014 ignore in preview
+      if (msg.method === "ui/keydown") return;
+
+      // ui/stateChanged \u2014 log
+      if (msg.method === "ui/stateChanged") {
+        console.log("[state]", msg.params?.state);
+        post({ jsonrpc: "2.0", method: "ui/stateAcknowledged", params: { truncated: false } });
+        return;
+      }
+
+      console.log("[bridge] unhandled:", msg.method, msg);
+    });
+
+    // Theme toggle
+    document.getElementById("toggle").addEventListener("click", function () {
+      darkMode = !darkMode;
+      document.body.style.background = darkMode ? "#0f172a" : "#f1f5f9";
+      tokens = darkMode ? {
+        "--color-background-primary": "#0f172a", "--color-text-primary": "#e2e8f0",
+        "--color-background-secondary": "#1e293b", "--color-text-primary": "#e2e8f0",
+        "--color-text-accent": "#6366f1", "--nb-color-accent-foreground": "#ffffff",
+        "--color-text-secondary": "#94a3b8", "--color-border-primary": "#334155",
+        "--color-ring-primary": "#6366f1", "--nb-color-danger": "#ef4444",
+        "--border-radius-sm": "0.5rem",
+      } : {
+        "--color-background-primary": "#ffffff", "--color-text-primary": "#1a1a1a",
+        "--color-background-secondary": "#f9fafb", "--color-text-primary": "#1a1a1a",
+        "--color-text-accent": "#6366f1", "--nb-color-accent-foreground": "#ffffff",
+        "--color-text-secondary": "#6b7280", "--color-border-primary": "#e5e7eb",
+        "--color-ring-primary": "#6366f1", "--nb-color-danger": "#ef4444",
+        "--border-radius-sm": "0.5rem",
+      };
+      post({ jsonrpc: "2.0", method: "ui/themeChanged", params: { mode: darkMode ? "dark" : "light", tokens: tokens } });
+    });
+  </script>
+</body>
+</html>`;
+async function startPreview(options) {
+  const { serverCmd, serverPort, uiDir, uiPort, previewPort } = options;
+  const children = [];
+  console.log(`
+  Synapse Preview
+`);
+  console.log(`  [server] ${serverCmd}`);
+  const serverProc = child_process.spawn(serverCmd, {
+    shell: true,
+    stdio: ["ignore", "pipe", "pipe"]
+  });
+  children.push(serverProc);
+  serverProc.stdout?.on("data", (d) => process.stdout.write(`  [server] ${d}`));
+  serverProc.stderr?.on("data", (d) => process.stderr.write(`  [server] ${d}`));
+  const resolvedUi = path.resolve(uiDir);
+  if (!fs.existsSync(path.join(resolvedUi, "package.json"))) {
+    console.error(`  [ui] Error: no package.json found at ${resolvedUi}`);
+    process.exit(1);
+  }
+  console.log(`  [ui] cd ${resolvedUi} && npx vite --port ${uiPort}`);
+  const uiProc = child_process.spawn("npx", ["vite", "--port", String(uiPort)], {
+    cwd: resolvedUi,
+    stdio: ["ignore", "pipe", "pipe"]
+  });
+  children.push(uiProc);
+  uiProc.stdout?.on("data", (d) => process.stdout.write(`  [ui] ${d}`));
+  uiProc.stderr?.on("data", (d) => process.stderr.write(`  [ui] ${d}`));
+  const html = HOST_HTML(uiPort, serverPort);
+  const host = http.createServer((_req, res) => {
+    res.writeHead(200, { "Content-Type": "text/html" });
+    res.end(html);
+  });
+  host.listen(previewPort, () => {
+    console.log(`
+  Preview:  http://localhost:${previewPort}`);
+    console.log(`  UI:       http://localhost:${uiPort}`);
+    console.log(`  Server:   http://localhost:${serverPort}`);
+    console.log(`
+  Press Ctrl+C to stop.
+`);
+  });
+  const shutdown = () => {
+    console.log("\n  Shutting down...");
+    host.close();
+    for (const child of children) {
+      try {
+        child.kill("SIGTERM");
+      } catch {
+      }
+    }
+    process.exit(0);
+  };
+  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", shutdown);
+}
+
+exports.startPreview = startPreview;
+//# sourceMappingURL=server-3BDZ5S72.cjs.map
+//# sourceMappingURL=server-3BDZ5S72.cjs.map

dist/server-3BDZ5S72.cjs.map

+{"version":3,"sources":["../src/preview/server.ts"],"names":["spawn","resolve","existsSync","join","createServer"],"mappings":"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","file":"server-3BDZ5S72.cjs","sourcesContent":["/**\n * Synapse Preview — standalone dev harness for MCP apps with UIs.\n *\n * Starts the MCP server (HTTP mode) and a minimal bridge host page\n * that iframes the app UI and proxies tool calls to the server.\n *\n * Usage:\n *   npx synapse preview --server \"uv run uvicorn mcp_hello.server:app --port 8001\" --ui ./ui\n *   npx synapse preview --server \"node dist/index.js\" --ui ./ui --server-port 8001\n */\n\nimport { type ChildProcess, spawn } from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\nimport { createServer, type IncomingMessage, type ServerResponse } from \"node:http\";\nimport { join, resolve } from \"node:path\";\n\nexport interface PreviewOptions {\n  /** Shell command to start the MCP server in HTTP mode */\n  serverCmd: string;\n  /** Port the MCP server listens on (default: 8001) */\n  serverPort: number;\n  /** Path to the UI directory (must have package.json with dev script) */\n  uiDir: string;\n  /** Port for the UI Vite dev server (default: 5173) */\n  uiPort: number;\n  /** Port for the preview harness (default: 5180) */\n  previewPort: number;\n}\n\nconst HOST_HTML = (uiPort: number, serverPort: number) => `<!DOCTYPE html>\n<html>\n<head>\n  <meta charset=\"utf-8\" />\n  <title>Synapse Preview</title>\n  <style>\n    * { margin: 0; padding: 0; box-sizing: border-box; }\n    body { font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif; background: #0f172a; color: #e2e8f0; }\n    header { padding: 12px 20px; background: #1e293b; border-bottom: 1px solid #334155; display: flex; align-items: center; gap: 12px; }\n    header h1 { font-size: 14px; font-weight: 500; }\n    header .dot { width: 8px; height: 8px; border-radius: 50%; background: #22c55e; }\n    header .info { font-size: 12px; color: #94a3b8; margin-left: auto; }\n    .theme-toggle { background: #334155; border: none; color: #e2e8f0; padding: 4px 10px; border-radius: 4px; cursor: pointer; font-size: 12px; }\n    iframe { width: 100%; height: calc(100vh - 45px); border: none; }\n  </style>\n</head>\n<body>\n  <header>\n    <span class=\"dot\"></span>\n    <h1>Synapse Preview</h1>\n    <button class=\"theme-toggle\" id=\"toggle\">Toggle Dark/Light</button>\n    <span class=\"info\">MCP: localhost:${serverPort} | UI: localhost:${uiPort}</span>\n  </header>\n  <iframe id=\"app\" src=\"http://localhost:${uiPort}\"></iframe>\n\n  <script>\n    var iframe = document.getElementById(\"app\");\n    var darkMode = true;\n\n    // Minimal NimbleBrain bridge host — just enough to make Synapse work\n    var tokens = darkMode ? {\n      \"--color-background-primary\": \"#0f172a\", \"--color-text-primary\": \"#e2e8f0\",\n      \"--color-background-secondary\": \"#1e293b\", \"--color-text-primary\": \"#e2e8f0\",\n      \"--color-text-accent\": \"#6366f1\", \"--nb-color-accent-foreground\": \"#ffffff\",\n      \"--color-text-secondary\": \"#94a3b8\", \"--color-border-primary\": \"#334155\",\n      \"--color-ring-primary\": \"#6366f1\", \"--nb-color-danger\": \"#ef4444\",\n      \"--border-radius-sm\": \"0.5rem\",\n    } : {\n      \"--color-background-primary\": \"#ffffff\", \"--color-text-primary\": \"#1a1a1a\",\n      \"--color-background-secondary\": \"#f9fafb\", \"--color-text-primary\": \"#1a1a1a\",\n      \"--color-text-accent\": \"#6366f1\", \"--nb-color-accent-foreground\": \"#ffffff\",\n      \"--color-text-secondary\": \"#6b7280\", \"--color-border-primary\": \"#e5e7eb\",\n      \"--color-ring-primary\": \"#6366f1\", \"--nb-color-danger\": \"#ef4444\",\n      \"--border-radius-sm\": \"0.5rem\",\n    };\n\n    function post(msg) { iframe.contentWindow.postMessage(msg, \"*\"); }\n\n    window.addEventListener(\"message\", async function (event) {\n      if (event.source !== iframe.contentWindow) return;\n      var msg = event.data;\n      if (!msg || typeof msg !== \"object\") return;\n\n      // ext-apps handshake\n      if (msg.method === \"ui/initialize\" && msg.id) {\n        post({\n          jsonrpc: \"2.0\", id: msg.id,\n          result: {\n            protocolVersion: \"2026-01-26\",\n            serverInfo: { name: \"nimblebrain\", version: \"preview\" },\n            capabilities: { openLinks: {}, serverTools: {} },\n            hostContext: { theme: darkMode ? \"dark\" : \"light\", primaryColor: \"#6366f1\", tokens: tokens }\n          }\n        });\n        return;\n      }\n\n      if (msg.method === \"ui/notifications/initialized\") return;\n\n      // Tool call proxy — forward to the MCP server\n      if (msg.method === \"tools/call\" && msg.id) {\n        try {\n          var resp = await fetch(\"http://localhost:${serverPort}/mcp\", {\n            method: \"POST\",\n            headers: { \"Content-Type\": \"application/json\" },\n            body: JSON.stringify({\n              jsonrpc: \"2.0\", id: msg.id,\n              method: \"tools/call\",\n              params: { name: msg.params.name, arguments: msg.params.arguments || {} }\n            })\n          });\n          var result = await resp.json();\n          // Forward the JSON-RPC response back to the iframe\n          post(result);\n        } catch (err) {\n          post({ jsonrpc: \"2.0\", id: msg.id, error: { code: -32000, message: err.message || \"Server error\" } });\n        }\n        return;\n      }\n\n      // ui/chat — log to console\n      if (msg.method === \"ui/chat\") {\n        console.log(\"[chat]\", msg.params?.message);\n        return;\n      }\n\n      // ui/action — log to console\n      if (msg.method === \"ui/action\") {\n        console.log(\"[action]\", msg.params?.action, msg.params);\n        return;\n      }\n\n      // ui/keydown — ignore in preview\n      if (msg.method === \"ui/keydown\") return;\n\n      // ui/stateChanged — log\n      if (msg.method === \"ui/stateChanged\") {\n        console.log(\"[state]\", msg.params?.state);\n        post({ jsonrpc: \"2.0\", method: \"ui/stateAcknowledged\", params: { truncated: false } });\n        return;\n      }\n\n      console.log(\"[bridge] unhandled:\", msg.method, msg);\n    });\n\n    // Theme toggle\n    document.getElementById(\"toggle\").addEventListener(\"click\", function () {\n      darkMode = !darkMode;\n      document.body.style.background = darkMode ? \"#0f172a\" : \"#f1f5f9\";\n      tokens = darkMode ? {\n        \"--color-background-primary\": \"#0f172a\", \"--color-text-primary\": \"#e2e8f0\",\n        \"--color-background-secondary\": \"#1e293b\", \"--color-text-primary\": \"#e2e8f0\",\n        \"--color-text-accent\": \"#6366f1\", \"--nb-color-accent-foreground\": \"#ffffff\",\n        \"--color-text-secondary\": \"#94a3b8\", \"--color-border-primary\": \"#334155\",\n        \"--color-ring-primary\": \"#6366f1\", \"--nb-color-danger\": \"#ef4444\",\n        \"--border-radius-sm\": \"0.5rem\",\n      } : {\n        \"--color-background-primary\": \"#ffffff\", \"--color-text-primary\": \"#1a1a1a\",\n        \"--color-background-secondary\": \"#f9fafb\", \"--color-text-primary\": \"#1a1a1a\",\n        \"--color-text-accent\": \"#6366f1\", \"--nb-color-accent-foreground\": \"#ffffff\",\n        \"--color-text-secondary\": \"#6b7280\", \"--color-border-primary\": \"#e5e7eb\",\n        \"--color-ring-primary\": \"#6366f1\", \"--nb-color-danger\": \"#ef4444\",\n        \"--border-radius-sm\": \"0.5rem\",\n      };\n      post({ jsonrpc: \"2.0\", method: \"ui/themeChanged\", params: { mode: darkMode ? \"dark\" : \"light\", tokens: tokens } });\n    });\n  </script>\n</body>\n</html>`;\n\nexport async function startPreview(options: PreviewOptions): Promise<void> {\n  const { serverCmd, serverPort, uiDir, uiPort, previewPort } = options;\n  const children: ChildProcess[] = [];\n\n  console.log(`\\n  Synapse Preview\\n`);\n\n  // 1. Start MCP server\n  console.log(`  [server] ${serverCmd}`);\n  const serverProc = spawn(serverCmd, {\n    shell: true,\n    stdio: [\"ignore\", \"pipe\", \"pipe\"],\n  });\n  children.push(serverProc);\n  serverProc.stdout?.on(\"data\", (d: Buffer) => process.stdout.write(`  [server] ${d}`));\n  serverProc.stderr?.on(\"data\", (d: Buffer) => process.stderr.write(`  [server] ${d}`));\n\n  // 2. Start UI Vite dev server\n  const resolvedUi = resolve(uiDir);\n  if (!existsSync(join(resolvedUi, \"package.json\"))) {\n    console.error(`  [ui] Error: no package.json found at ${resolvedUi}`);\n    process.exit(1);\n  }\n  console.log(`  [ui] cd ${resolvedUi} && npx vite --port ${uiPort}`);\n  const uiProc = spawn(\"npx\", [\"vite\", \"--port\", String(uiPort)], {\n    cwd: resolvedUi,\n    stdio: [\"ignore\", \"pipe\", \"pipe\"],\n  });\n  children.push(uiProc);\n  uiProc.stdout?.on(\"data\", (d: Buffer) => process.stdout.write(`  [ui] ${d}`));\n  uiProc.stderr?.on(\"data\", (d: Buffer) => process.stderr.write(`  [ui] ${d}`));\n\n  // 3. Start preview host\n  const html = HOST_HTML(uiPort, serverPort);\n  const host = createServer((_req: IncomingMessage, res: ServerResponse) => {\n    res.writeHead(200, { \"Content-Type\": \"text/html\" });\n    res.end(html);\n  });\n  host.listen(previewPort, () => {\n    console.log(`\\n  Preview:  http://localhost:${previewPort}`);\n    console.log(`  UI:       http://localhost:${uiPort}`);\n    console.log(`  Server:   http://localhost:${serverPort}`);\n    console.log(`\\n  Press Ctrl+C to stop.\\n`);\n  });\n\n  // Shutdown\n  const shutdown = () => {\n    console.log(\"\\n  Shutting down...\");\n    host.close();\n    for (const child of children) {\n      try {\n        child.kill(\"SIGTERM\");\n      } catch {\n        /* already dead */\n      }\n    }\n    process.exit(0);\n  };\n  process.on(\"SIGINT\", shutdown);\n  process.on(\"SIGTERM\", shutdown);\n}\n"]}

dist/server-NNW54YW5.js

+import { spawn } from 'child_process';
+import { existsSync } from 'fs';
+import { createServer } from 'http';
+import { resolve, join } from 'path';
+
+// src/preview/server.ts
+var HOST_HTML = (uiPort, serverPort) => `<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8" />
+  <title>Synapse Preview</title>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; background: #0f172a; color: #e2e8f0; }
+    header { padding: 12px 20px; background: #1e293b; border-bottom: 1px solid #334155; display: flex; align-items: center; gap: 12px; }
+    header h1 { font-size: 14px; font-weight: 500; }
+    header .dot { width: 8px; height: 8px; border-radius: 50%; background: #22c55e; }
+    header .info { font-size: 12px; color: #94a3b8; margin-left: auto; }
+    .theme-toggle { background: #334155; border: none; color: #e2e8f0; padding: 4px 10px; border-radius: 4px; cursor: pointer; font-size: 12px; }
+    iframe { width: 100%; height: calc(100vh - 45px); border: none; }
+  </style>
+</head>
+<body>
+  <header>
+    <span class="dot"></span>
+    <h1>Synapse Preview</h1>
+    <button class="theme-toggle" id="toggle">Toggle Dark/Light</button>
+    <span class="info">MCP: localhost:${serverPort} | UI: localhost:${uiPort}</span>
+  </header>
+  <iframe id="app" src="http://localhost:${uiPort}"></iframe>
+
+  <script>
+    var iframe = document.getElementById("app");
+    var darkMode = true;
+
+    // Minimal NimbleBrain bridge host \u2014 just enough to make Synapse work
+    var tokens = darkMode ? {
+      "--color-background-primary": "#0f172a", "--color-text-primary": "#e2e8f0",
+      "--color-background-secondary": "#1e293b", "--color-text-primary": "#e2e8f0",
+      "--color-text-accent": "#6366f1", "--nb-color-accent-foreground": "#ffffff",
+      "--color-text-secondary": "#94a3b8", "--color-border-primary": "#334155",
+      "--color-ring-primary": "#6366f1", "--nb-color-danger": "#ef4444",
+      "--border-radius-sm": "0.5rem",
+    } : {
+      "--color-background-primary": "#ffffff", "--color-text-primary": "#1a1a1a",
+      "--color-background-secondary": "#f9fafb", "--color-text-primary": "#1a1a1a",
+      "--color-text-accent": "#6366f1", "--nb-color-accent-foreground": "#ffffff",
+      "--color-text-secondary": "#6b7280", "--color-border-primary": "#e5e7eb",
+      "--color-ring-primary": "#6366f1", "--nb-color-danger": "#ef4444",
+      "--border-radius-sm": "0.5rem",
+    };
+
+    function post(msg) { iframe.contentWindow.postMessage(msg, "*"); }
+
+    window.addEventListener("message", async function (event) {
+      if (event.source !== iframe.contentWindow) return;
+      var msg = event.data;
+      if (!msg || typeof msg !== "object") return;
+
+      // ext-apps handshake
+      if (msg.method === "ui/initialize" && msg.id) {
+        post({
+          jsonrpc: "2.0", id: msg.id,
+          result: {
+            protocolVersion: "2026-01-26",
+            serverInfo: { name: "nimblebrain", version: "preview" },
+            capabilities: { openLinks: {}, serverTools: {} },
+            hostContext: { theme: darkMode ? "dark" : "light", primaryColor: "#6366f1", tokens: tokens }
+          }
+        });
+        return;
+      }
+
+      if (msg.method === "ui/notifications/initialized") return;
+
+      // Tool call proxy \u2014 forward to the MCP server
+      if (msg.method === "tools/call" && msg.id) {
+        try {
+          var resp = await fetch("http://localhost:${serverPort}/mcp", {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+              jsonrpc: "2.0", id: msg.id,
+              method: "tools/call",
+              params: { name: msg.params.name, arguments: msg.params.arguments || {} }
+            })
+          });
+          var result = await resp.json();
+          // Forward the JSON-RPC response back to the iframe
+          post(result);
+        } catch (err) {
+          post({ jsonrpc: "2.0", id: msg.id, error: { code: -32000, message: err.message || "Server error" } });
+        }
+        return;
+      }
+
+      // ui/chat \u2014 log to console
+      if (msg.method === "ui/chat") {
+        console.log("[chat]", msg.params?.message);
+        return;
+      }
+
+      // ui/action \u2014 log to console
+      if (msg.method === "ui/action") {
+        console.log("[action]", msg.params?.action, msg.params);
+        return;
+      }
+
+      // ui/keydown \u2014 ignore in preview
+      if (msg.method === "ui/keydown") return;
+
+      // ui/stateChanged \u2014 log
+      if (msg.method === "ui/stateChanged") {
+        console.log("[state]", msg.params?.state);
+        post({ jsonrpc: "2.0", method: "ui/stateAcknowledged", params: { truncated: false } });
+        return;
+      }
+
+      console.log("[bridge] unhandled:", msg.method, msg);
+    });
+
+    // Theme toggle
+    document.getElementById("toggle").addEventListener("click", function () {
+      darkMode = !darkMode;
+      document.body.style.background = darkMode ? "#0f172a" : "#f1f5f9";
+      tokens = darkMode ? {
+        "--color-background-primary": "#0f172a", "--color-text-primary": "#e2e8f0",
+        "--color-background-secondary": "#1e293b", "--color-text-primary": "#e2e8f0",
+        "--color-text-accent": "#6366f1", "--nb-color-accent-foreground": "#ffffff",
+        "--color-text-secondary": "#94a3b8", "--color-border-primary": "#334155",
+        "--color-ring-primary": "#6366f1", "--nb-color-danger": "#ef4444",
+        "--border-radius-sm": "0.5rem",
+      } : {
+        "--color-background-primary": "#ffffff", "--color-text-primary": "#1a1a1a",
+        "--color-background-secondary": "#f9fafb", "--color-text-primary": "#1a1a1a",
+        "--color-text-accent": "#6366f1", "--nb-color-accent-foreground": "#ffffff",
+        "--color-text-secondary": "#6b7280", "--color-border-primary": "#e5e7eb",
+        "--color-ring-primary": "#6366f1", "--nb-color-danger": "#ef4444",
+        "--border-radius-sm": "0.5rem",
+      };
+      post({ jsonrpc: "2.0", method: "ui/themeChanged", params: { mode: darkMode ? "dark" : "light", tokens: tokens } });
+    });
+  </script>
+</body>
+</html>`;
+async function startPreview(options) {
+  const { serverCmd, serverPort, uiDir, uiPort, previewPort } = options;
+  const children = [];
+  console.log(`
+  Synapse Preview
+`);
+  console.log(`  [server] ${serverCmd}`);
+  const serverProc = spawn(serverCmd, {
+    shell: true,
+    stdio: ["ignore", "pipe", "pipe"]
+  });
+  children.push(serverProc);
+  serverProc.stdout?.on("data", (d) => process.stdout.write(`  [server] ${d}`));
+  serverProc.stderr?.on("data", (d) => process.stderr.write(`  [server] ${d}`));
+  const resolvedUi = resolve(uiDir);
+  if (!existsSync(join(resolvedUi, "package.json"))) {
+    console.error(`  [ui] Error: no package.json found at ${resolvedUi}`);
+    process.exit(1);
+  }
+  console.log(`  [ui] cd ${resolvedUi} && npx vite --port ${uiPort}`);
+  const uiProc = spawn("npx", ["vite", "--port", String(uiPort)], {
+    cwd: resolvedUi,
+    stdio: ["ignore", "pipe", "pipe"]
+  });
+  children.push(uiProc);
+  uiProc.stdout?.on("data", (d) => process.stdout.write(`  [ui] ${d}`));
+  uiProc.stderr?.on("data", (d) => process.stderr.write(`  [ui] ${d}`));
+  const html = HOST_HTML(uiPort, serverPort);
+  const host = createServer((_req, res) => {
+    res.writeHead(200, { "Content-Type": "text/html" });
+    res.end(html);
+  });
+  host.listen(previewPort, () => {
+    console.log(`
+  Preview:  http://localhost:${previewPort}`);
+    console.log(`  UI:       http://localhost:${uiPort}`);
+    console.log(`  Server:   http://localhost:${serverPort}`);
+    console.log(`
+  Press Ctrl+C to stop.
+`);
+  });
+  const shutdown = () => {
+    console.log("\n  Shutting down...");
+    host.close();
+    for (const child of children) {
+      try {
+        child.kill("SIGTERM");
+      } catch {
+      }
+    }
+    process.exit(0);
+  };
+  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", shutdown);
+}
+
+export { startPreview };
+//# sourceMappingURL=server-NNW54YW5.js.map
+//# sourceMappingURL=server-NNW54YW5.js.map

dist/server-NNW54YW5.js.map

+{"version":3,"sources":["../src/preview/server.ts"],"names":[],"mappings":"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","file":"server-NNW54YW5.js","sourcesContent":["/**\n * Synapse Preview — standalone dev harness for MCP apps with UIs.\n *\n * Starts the MCP server (HTTP mode) and a minimal bridge host page\n * that iframes the app UI and proxies tool calls to the server.\n *\n * Usage:\n *   npx synapse preview --server \"uv run uvicorn mcp_hello.server:app --port 8001\" --ui ./ui\n *   npx synapse preview --server \"node dist/index.js\" --ui ./ui --server-port 8001\n */\n\nimport { type ChildProcess, spawn } from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\nimport { createServer, type IncomingMessage, type ServerResponse } from \"node:http\";\nimport { join, resolve } from \"node:path\";\n\nexport interface PreviewOptions {\n  /** Shell command to start the MCP server in HTTP mode */\n  serverCmd: string;\n  /** Port the MCP server listens on (default: 8001) */\n  serverPort: number;\n  /** Path to the UI directory (must have package.json with dev script) */\n  uiDir: string;\n  /** Port for the UI Vite dev server (default: 5173) */\n  uiPort: number;\n  /** Port for the preview harness (default: 5180) */\n  previewPort: number;\n}\n\nconst HOST_HTML = (uiPort: number, serverPort: number) => `<!DOCTYPE html>\n<html>\n<head>\n  <meta charset=\"utf-8\" />\n  <title>Synapse Preview</title>\n  <style>\n    * { margin: 0; padding: 0; box-sizing: border-box; }\n    body { font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif; background: #0f172a; color: #e2e8f0; }\n    header { padding: 12px 20px; background: #1e293b; border-bottom: 1px solid #334155; display: flex; align-items: center; gap: 12px; }\n    header h1 { font-size: 14px; font-weight: 500; }\n    header .dot { width: 8px; height: 8px; border-radius: 50%; background: #22c55e; }\n    header .info { font-size: 12px; color: #94a3b8; margin-left: auto; }\n    .theme-toggle { background: #334155; border: none; color: #e2e8f0; padding: 4px 10px; border-radius: 4px; cursor: pointer; font-size: 12px; }\n    iframe { width: 100%; height: calc(100vh - 45px); border: none; }\n  </style>\n</head>\n<body>\n  <header>\n    <span class=\"dot\"></span>\n    <h1>Synapse Preview</h1>\n    <button class=\"theme-toggle\" id=\"toggle\">Toggle Dark/Light</button>\n    <span class=\"info\">MCP: localhost:${serverPort} | UI: localhost:${uiPort}</span>\n  </header>\n  <iframe id=\"app\" src=\"http://localhost:${uiPort}\"></iframe>\n\n  <script>\n    var iframe = document.getElementById(\"app\");\n    var darkMode = true;\n\n    // Minimal NimbleBrain bridge host — just enough to make Synapse work\n    var tokens = darkMode ? {\n      \"--color-background-primary\": \"#0f172a\", \"--color-text-primary\": \"#e2e8f0\",\n      \"--color-background-secondary\": \"#1e293b\", \"--color-text-primary\": \"#e2e8f0\",\n      \"--color-text-accent\": \"#6366f1\", \"--nb-color-accent-foreground\": \"#ffffff\",\n      \"--color-text-secondary\": \"#94a3b8\", \"--color-border-primary\": \"#334155\",\n      \"--color-ring-primary\": \"#6366f1\", \"--nb-color-danger\": \"#ef4444\",\n      \"--border-radius-sm\": \"0.5rem\",\n    } : {\n      \"--color-background-primary\": \"#ffffff\", \"--color-text-primary\": \"#1a1a1a\",\n      \"--color-background-secondary\": \"#f9fafb\", \"--color-text-primary\": \"#1a1a1a\",\n      \"--color-text-accent\": \"#6366f1\", \"--nb-color-accent-foreground\": \"#ffffff\",\n      \"--color-text-secondary\": \"#6b7280\", \"--color-border-primary\": \"#e5e7eb\",\n      \"--color-ring-primary\": \"#6366f1\", \"--nb-color-danger\": \"#ef4444\",\n      \"--border-radius-sm\": \"0.5rem\",\n    };\n\n    function post(msg) { iframe.contentWindow.postMessage(msg, \"*\"); }\n\n    window.addEventListener(\"message\", async function (event) {\n      if (event.source !== iframe.contentWindow) return;\n      var msg = event.data;\n      if (!msg || typeof msg !== \"object\") return;\n\n      // ext-apps handshake\n      if (msg.method === \"ui/initialize\" && msg.id) {\n        post({\n          jsonrpc: \"2.0\", id: msg.id,\n          result: {\n            protocolVersion: \"2026-01-26\",\n            serverInfo: { name: \"nimblebrain\", version: \"preview\" },\n            capabilities: { openLinks: {}, serverTools: {} },\n            hostContext: { theme: darkMode ? \"dark\" : \"light\", primaryColor: \"#6366f1\", tokens: tokens }\n          }\n        });\n        return;\n      }\n\n      if (msg.method === \"ui/notifications/initialized\") return;\n\n      // Tool call proxy — forward to the MCP server\n      if (msg.method === \"tools/call\" && msg.id) {\n        try {\n          var resp = await fetch(\"http://localhost:${serverPort}/mcp\", {\n            method: \"POST\",\n            headers: { \"Content-Type\": \"application/json\" },\n            body: JSON.stringify({\n              jsonrpc: \"2.0\", id: msg.id,\n              method: \"tools/call\",\n              params: { name: msg.params.name, arguments: msg.params.arguments || {} }\n            })\n          });\n          var result = await resp.json();\n          // Forward the JSON-RPC response back to the iframe\n          post(result);\n        } catch (err) {\n          post({ jsonrpc: \"2.0\", id: msg.id, error: { code: -32000, message: err.message || \"Server error\" } });\n        }\n        return;\n      }\n\n      // ui/chat — log to console\n      if (msg.method === \"ui/chat\") {\n        console.log(\"[chat]\", msg.params?.message);\n        return;\n      }\n\n      // ui/action — log to console\n      if (msg.method === \"ui/action\") {\n        console.log(\"[action]\", msg.params?.action, msg.params);\n        return;\n      }\n\n      // ui/keydown — ignore in preview\n      if (msg.method === \"ui/keydown\") return;\n\n      // ui/stateChanged — log\n      if (msg.method === \"ui/stateChanged\") {\n        console.log(\"[state]\", msg.params?.state);\n        post({ jsonrpc: \"2.0\", method: \"ui/stateAcknowledged\", params: { truncated: false } });\n        return;\n      }\n\n      console.log(\"[bridge] unhandled:\", msg.method, msg);\n    });\n\n    // Theme toggle\n    document.getElementById(\"toggle\").addEventListener(\"click\", function () {\n      darkMode = !darkMode;\n      document.body.style.background = darkMode ? \"#0f172a\" : \"#f1f5f9\";\n      tokens = darkMode ? {\n        \"--color-background-primary\": \"#0f172a\", \"--color-text-primary\": \"#e2e8f0\",\n        \"--color-background-secondary\": \"#1e293b\", \"--color-text-primary\": \"#e2e8f0\",\n        \"--color-text-accent\": \"#6366f1\", \"--nb-color-accent-foreground\": \"#ffffff\",\n        \"--color-text-secondary\": \"#94a3b8\", \"--color-border-primary\": \"#334155\",\n        \"--color-ring-primary\": \"#6366f1\", \"--nb-color-danger\": \"#ef4444\",\n        \"--border-radius-sm\": \"0.5rem\",\n      } : {\n        \"--color-background-primary\": \"#ffffff\", \"--color-text-primary\": \"#1a1a1a\",\n        \"--color-background-secondary\": \"#f9fafb\", \"--color-text-primary\": \"#1a1a1a\",\n        \"--color-text-accent\": \"#6366f1\", \"--nb-color-accent-foreground\": \"#ffffff\",\n        \"--color-text-secondary\": \"#6b7280\", \"--color-border-primary\": \"#e5e7eb\",\n        \"--color-ring-primary\": \"#6366f1\", \"--nb-color-danger\": \"#ef4444\",\n        \"--border-radius-sm\": \"0.5rem\",\n      };\n      post({ jsonrpc: \"2.0\", method: \"ui/themeChanged\", params: { mode: darkMode ? \"dark\" : \"light\", tokens: tokens } });\n    });\n  </script>\n</body>\n</html>`;\n\nexport async function startPreview(options: PreviewOptions): Promise<void> {\n  const { serverCmd, serverPort, uiDir, uiPort, previewPort } = options;\n  const children: ChildProcess[] = [];\n\n  console.log(`\\n  Synapse Preview\\n`);\n\n  // 1. Start MCP server\n  console.log(`  [server] ${serverCmd}`);\n  const serverProc = spawn(serverCmd, {\n    shell: true,\n    stdio: [\"ignore\", \"pipe\", \"pipe\"],\n  });\n  children.push(serverProc);\n  serverProc.stdout?.on(\"data\", (d: Buffer) => process.stdout.write(`  [server] ${d}`));\n  serverProc.stderr?.on(\"data\", (d: Buffer) => process.stderr.write(`  [server] ${d}`));\n\n  // 2. Start UI Vite dev server\n  const resolvedUi = resolve(uiDir);\n  if (!existsSync(join(resolvedUi, \"package.json\"))) {\n    console.error(`  [ui] Error: no package.json found at ${resolvedUi}`);\n    process.exit(1);\n  }\n  console.log(`  [ui] cd ${resolvedUi} && npx vite --port ${uiPort}`);\n  const uiProc = spawn(\"npx\", [\"vite\", \"--port\", String(uiPort)], {\n    cwd: resolvedUi,\n    stdio: [\"ignore\", \"pipe\", \"pipe\"],\n  });\n  children.push(uiProc);\n  uiProc.stdout?.on(\"data\", (d: Buffer) => process.stdout.write(`  [ui] ${d}`));\n  uiProc.stderr?.on(\"data\", (d: Buffer) => process.stderr.write(`  [ui] ${d}`));\n\n  // 3. Start preview host\n  const html = HOST_HTML(uiPort, serverPort);\n  const host = createServer((_req: IncomingMessage, res: ServerResponse) => {\n    res.writeHead(200, { \"Content-Type\": \"text/html\" });\n    res.end(html);\n  });\n  host.listen(previewPort, () => {\n    console.log(`\\n  Preview:  http://localhost:${previewPort}`);\n    console.log(`  UI:       http://localhost:${uiPort}`);\n    console.log(`  Server:   http://localhost:${serverPort}`);\n    console.log(`\\n  Press Ctrl+C to stop.\\n`);\n  });\n\n  // Shutdown\n  const shutdown = () => {\n    console.log(\"\\n  Shutting down...\");\n    host.close();\n    for (const child of children) {\n      try {\n        child.kill(\"SIGTERM\");\n      } catch {\n        /* already dead */\n      }\n    }\n    process.exit(0);\n  };\n  process.on(\"SIGINT\", shutdown);\n  process.on(\"SIGTERM\", shutdown);\n}\n"]}

dist/types-BL15lUqi.d.cts

+interface SynapseOptions {
+    /** App name — must match the bundle name registered with the host */
+    name: string;
+    /** Semver version string */
+    version: string;
+    /**
+     * Mark as internal NimbleBrain app. Enables cross-server tool calls.
+     * External apps MUST NOT set this.
+     */
+    internal?: boolean;
+    /** Key combos to forward from iframe to host. Default: all Ctrl/Cmd combos + Escape. */
+    forwardKeys?: KeyForwardConfig[];
+}
+interface SynapseTheme {
+    mode: "light" | "dark";
+    primaryColor: string;
+    tokens: Record<string, string>;
+}
+interface DataChangedEvent {
+    source: "agent";
+    server: string;
+    tool: string;
+}
+/**
+ * Built-in action types that Synapse handles natively.
+ *
+ * - `navigate` — select/focus a resource in the UI (e.g., a board, document, record)
+ * - `notify`   — display a transient message (toast/banner)
+ * - `refresh`  — force a full data refresh (heavier than datachanged)
+ * - `confirm`  — request user confirmation before the agent proceeds
+ *
+ * Apps may also receive custom string types for domain-specific actions.
+ */
+type BuiltinActionType = "navigate" | "notify" | "refresh" | "confirm";
+/**
+ * A typed, declarative action sent from the agent/server to the UI.
+ *
+ * Actions are deterministic side effects of tool execution — the tool decides
+ * what action to emit, not the LLM. The UI decides how to handle it.
+ *
+ * This mirrors Studio's ClientAction pattern, adapted for iframe postMessage.
+ */
+interface AgentAction<TPayload = Record<string, unknown>> {
+    /** Discriminator — a BuiltinActionType or custom string. */
+    type: BuiltinActionType | (string & {});
+    /** Typed payload — shape depends on `type`. */
+    payload: TPayload;
+    /** If true, the UI should confirm with the user before executing. */
+    requiresConfirmation?: boolean;
+    /** Human-readable label for confirmation dialogs or logs. */
+    label?: string;
+}
+/** Payload for the built-in "navigate" action. */
+interface NavigatePayload {
+    /** Entity type (e.g., "board", "document", "task"). */
+    entity: string;
+    /** Entity ID to select/focus. */
+    id: string;
+    /** Optional sub-view or section within the entity. */
+    view?: string;
+}
+/** Payload for the built-in "notify" action. */
+interface NotifyPayload {
+    message: string;
+    level?: "info" | "success" | "warning" | "error";
+}
+interface ToolCallResult<T = unknown> {
+    data: T;
+    isError: boolean;
+}
+interface Synapse {
+    readonly ready: Promise<void>;
+    readonly isNimbleBrainHost: boolean;
+    callTool<TInput = Record<string, unknown>, TOutput = unknown>(name: string, args?: TInput): Promise<ToolCallResult<TOutput>>;
+    onDataChanged(callback: (event: DataChangedEvent) => void): () => void;
+    /**
+     * Subscribe to agent actions — typed, declarative commands from the server.
+     *
+     * Actions are deterministic side effects of tool execution. The server/tool
+     * decides what action to emit; the UI decides how to handle it.
+     *
+     * The callback receives an AgentAction with a `type` discriminator and typed
+     * `payload`. Apps should handle known types and ignore unknown ones.
+     */
+    onAction(callback: (action: AgentAction) => void): () => void;
+    getTheme(): SynapseTheme;
+    onThemeChanged(callback: (theme: SynapseTheme) => void): () => void;
+    action(action: string, params?: Record<string, unknown>): void;
+    chat(message: string, context?: {
+        action?: string;
+        entity?: string;
+    }): void;
+    setVisibleState(state: Record<string, unknown>, summary?: string): void;
+    downloadFile(filename: string, content: string | Blob, mimeType?: string): void;
+    openLink(url: string): void;
+    /** @internal — used by createStore for ui/stateLoaded */
+    _onMessage(method: string, callback: (params: Record<string, unknown> | undefined) => void): () => void;
+    /** @internal — used by createStore for ui/persistState */
+    _request(method: string, params?: Record<string, unknown>): Promise<unknown>;
+    /** True after destroy() has been called. */
+    readonly destroyed: boolean;
+    destroy(): void;
+}
+interface VisibleState {
+    state: Record<string, unknown>;
+    summary?: string;
+}
+interface StateAcknowledgement {
+    truncated: boolean;
+}
+type ActionReducer<TState, TPayload = unknown> = (state: TState, payload: TPayload) => TState;
+interface StoreConfig<TState> {
+    initialState: TState;
+    actions: Record<string, ActionReducer<TState, any>>;
+    persist?: boolean;
+    visibleToAgent?: boolean;
+    summarize?: (state: TState) => string;
+    version?: number;
+    migrations?: Array<(oldState: any) => any>;
+}
+type StoreDispatch<TActions extends Record<string, ActionReducer<any, any>>> = {
+    [K in keyof TActions]: Parameters<TActions[K]>[1] extends undefined ? () => void : (payload: Parameters<TActions[K]>[1]) => void;
+};
+interface Store<TState, TActions extends Record<string, ActionReducer<TState, any>> = Record<string, ActionReducer<TState, any>>> {
+    getState(): TState;
+    subscribe(callback: (state: TState) => void): () => void;
+    dispatch: StoreDispatch<TActions>;
+    hydrate(state: TState): void;
+    destroy(): void;
+}
+interface KeyForwardConfig {
+    key: string;
+    ctrl?: boolean;
+    meta?: boolean;
+    shift?: boolean;
+    alt?: boolean;
+}
+interface ToolDefinition {
+    name: string;
+    description?: string;
+    inputSchema: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+}
+interface HostInfo {
+    isNimbleBrain: boolean;
+    serverName: string;
+    protocolVersion: string;
+    theme: SynapseTheme;
+}
+
+export type { ActionReducer as A, BuiltinActionType as B, DataChangedEvent as D, HostInfo as H, KeyForwardConfig as K, NavigatePayload as N, SynapseOptions as S, ToolCallResult as T, VisibleState as V, Synapse as a, StoreConfig as b, Store as c, AgentAction as d, NotifyPayload as e, StateAcknowledgement as f, StoreDispatch as g, SynapseTheme as h, ToolDefinition as i };

dist/types-BL15lUqi.d.ts

+interface SynapseOptions {
+    /** App name — must match the bundle name registered with the host */
+    name: string;
+    /** Semver version string */
+    version: string;
+    /**
+     * Mark as internal NimbleBrain app. Enables cross-server tool calls.
+     * External apps MUST NOT set this.
+     */
+    internal?: boolean;
+    /** Key combos to forward from iframe to host. Default: all Ctrl/Cmd combos + Escape. */
+    forwardKeys?: KeyForwardConfig[];
+}
+interface SynapseTheme {
+    mode: "light" | "dark";
+    primaryColor: string;
+    tokens: Record<string, string>;
+}
+interface DataChangedEvent {
+    source: "agent";
+    server: string;
+    tool: string;
+}
+/**
+ * Built-in action types that Synapse handles natively.
+ *
+ * - `navigate` — select/focus a resource in the UI (e.g., a board, document, record)
+ * - `notify`   — display a transient message (toast/banner)
+ * - `refresh`  — force a full data refresh (heavier than datachanged)
+ * - `confirm`  — request user confirmation before the agent proceeds
+ *
+ * Apps may also receive custom string types for domain-specific actions.
+ */
+type BuiltinActionType = "navigate" | "notify" | "refresh" | "confirm";
+/**
+ * A typed, declarative action sent from the agent/server to the UI.
+ *
+ * Actions are deterministic side effects of tool execution — the tool decides
+ * what action to emit, not the LLM. The UI decides how to handle it.
+ *
+ * This mirrors Studio's ClientAction pattern, adapted for iframe postMessage.
+ */
+interface AgentAction<TPayload = Record<string, unknown>> {
+    /** Discriminator — a BuiltinActionType or custom string. */
+    type: BuiltinActionType | (string & {});
+    /** Typed payload — shape depends on `type`. */
+    payload: TPayload;
+    /** If true, the UI should confirm with the user before executing. */
+    requiresConfirmation?: boolean;
+    /** Human-readable label for confirmation dialogs or logs. */
+    label?: string;
+}
+/** Payload for the built-in "navigate" action. */
+interface NavigatePayload {
+    /** Entity type (e.g., "board", "document", "task"). */
+    entity: string;
+    /** Entity ID to select/focus. */
+    id: string;
+    /** Optional sub-view or section within the entity. */
+    view?: string;
+}
+/** Payload for the built-in "notify" action. */
+interface NotifyPayload {
+    message: string;
+    level?: "info" | "success" | "warning" | "error";
+}
+interface ToolCallResult<T = unknown> {
+    data: T;
+    isError: boolean;
+}
+interface Synapse {
+    readonly ready: Promise<void>;
+    readonly isNimbleBrainHost: boolean;
+    callTool<TInput = Record<string, unknown>, TOutput = unknown>(name: string, args?: TInput): Promise<ToolCallResult<TOutput>>;
+    onDataChanged(callback: (event: DataChangedEvent) => void): () => void;
+    /**
+     * Subscribe to agent actions — typed, declarative commands from the server.
+     *
+     * Actions are deterministic side effects of tool execution. The server/tool
+     * decides what action to emit; the UI decides how to handle it.
+     *
+     * The callback receives an AgentAction with a `type` discriminator and typed
+     * `payload`. Apps should handle known types and ignore unknown ones.
+     */
+    onAction(callback: (action: AgentAction) => void): () => void;
+    getTheme(): SynapseTheme;
+    onThemeChanged(callback: (theme: SynapseTheme) => void): () => void;
+    action(action: string, params?: Record<string, unknown>): void;
+    chat(message: string, context?: {
+        action?: string;
+        entity?: string;
+    }): void;
+    setVisibleState(state: Record<string, unknown>, summary?: string): void;
+    downloadFile(filename: string, content: string | Blob, mimeType?: string): void;
+    openLink(url: string): void;
+    /** @internal — used by createStore for ui/stateLoaded */
+    _onMessage(method: string, callback: (params: Record<string, unknown> | undefined) => void): () => void;
+    /** @internal — used by createStore for ui/persistState */
+    _request(method: string, params?: Record<string, unknown>): Promise<unknown>;
+    /** True after destroy() has been called. */
+    readonly destroyed: boolean;
+    destroy(): void;
+}
+interface VisibleState {
+    state: Record<string, unknown>;
+    summary?: string;
+}
+interface StateAcknowledgement {
+    truncated: boolean;
+}
+type ActionReducer<TState, TPayload = unknown> = (state: TState, payload: TPayload) => TState;
+interface StoreConfig<TState> {
+    initialState: TState;
+    actions: Record<string, ActionReducer<TState, any>>;
+    persist?: boolean;
+    visibleToAgent?: boolean;
+    summarize?: (state: TState) => string;
+    version?: number;
+    migrations?: Array<(oldState: any) => any>;
+}
+type StoreDispatch<TActions extends Record<string, ActionReducer<any, any>>> = {
+    [K in keyof TActions]: Parameters<TActions[K]>[1] extends undefined ? () => void : (payload: Parameters<TActions[K]>[1]) => void;
+};
+interface Store<TState, TActions extends Record<string, ActionReducer<TState, any>> = Record<string, ActionReducer<TState, any>>> {
+    getState(): TState;
+    subscribe(callback: (state: TState) => void): () => void;
+    dispatch: StoreDispatch<TActions>;
+    hydrate(state: TState): void;
+    destroy(): void;
+}
+interface KeyForwardConfig {
+    key: string;
+    ctrl?: boolean;
+    meta?: boolean;
+    shift?: boolean;
+    alt?: boolean;
+}
+interface ToolDefinition {
+    name: string;
+    description?: string;
+    inputSchema: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+}
+interface HostInfo {
+    isNimbleBrain: boolean;
+    serverName: string;
+    protocolVersion: string;
+    theme: SynapseTheme;
+}
+
+export type { ActionReducer as A, BuiltinActionType as B, DataChangedEvent as D, HostInfo as H, KeyForwardConfig as K, NavigatePayload as N, SynapseOptions as S, ToolCallResult as T, VisibleState as V, Synapse as a, StoreConfig as b, Store as c, AgentAction as d, NotifyPayload as e, StateAcknowledgement as f, StoreDispatch as g, SynapseTheme as h, ToolDefinition as i };

dist/codegen/cli.cjs

@@ -61,3 +61,3 @@ #!/usr/bin/env node
 async function runPreview(args2) {
-  const { startPreview } = await import('../server-SEI7XI3B.cjs');
+  const { startPreview } = await import('../server-3BDZ5S72.cjs');
   const flags = parseFlags(args2, ["server", "ui", "server-port", "ui-port", "port"]);
@@ -64,0 +64,0 @@ if (!flags.server || !flags.ui) {

dist/codegen/cli.js

@@ -59,3 +59,3 @@ #!/usr/bin/env node
 async function runPreview(args2) {
-  const { startPreview } = await import('../server-RUCX2TIB.js');
+  const { startPreview } = await import('../server-NNW54YW5.js');
   const flags = parseFlags(args2, ["server", "ui", "server-port", "ui-port", "port"]);
@@ -62,0 +62,0 @@ if (!flags.server || !flags.ui) {

dist/codegen/index.d.cts

@@ -1,2 +0,2 @@
-import { g as ToolDefinition } from '../types-BP0SNrpo.cjs';
+import { i as ToolDefinition } from '../types-BL15lUqi.cjs';
 
@@ -3,0 +3,0 @@ /**

dist/codegen/index.d.ts

@@ -1,2 +0,2 @@
-import { g as ToolDefinition } from '../types-BP0SNrpo.js';
+import { i as ToolDefinition } from '../types-BL15lUqi.js';
 
@@ -3,0 +3,0 @@ /**

dist/index.cjs

 'use strict';
 
-var chunkQ7OSHSGZ_cjs = require('./chunk-Q7OSHSGZ.cjs');
+var chunkABJP7PL4_cjs = require('./chunk-ABJP7PL4.cjs');
 
@@ -83,3 +83,3 @@ // src/store.ts
   enumerable: true,
-  get: function () { return chunkQ7OSHSGZ_cjs.createSynapse; }
+  get: function () { return chunkABJP7PL4_cjs.createSynapse; }
 });
@@ -86,0 +86,0 @@ exports.createStore = createStore;

dist/index.d.cts

@@ -1,3 +0,3 @@
-import { S as SynapseOptions, a as Synapse, A as ActionReducer, b as StoreConfig, c as Store } from './types-BP0SNrpo.cjs';
-export { D as DataChangedEvent, H as HostInfo, K as KeyForwardConfig, d as StateAcknowledgement, e as StoreDispatch, f as SynapseTheme, T as ToolCallResult, g as ToolDefinition, V as VisibleState } from './types-BP0SNrpo.cjs';
+import { S as SynapseOptions, a as Synapse, A as ActionReducer, b as StoreConfig, c as Store } from './types-BL15lUqi.cjs';
+export { d as AgentAction, B as BuiltinActionType, D as DataChangedEvent, H as HostInfo, K as KeyForwardConfig, N as NavigatePayload, e as NotifyPayload, f as StateAcknowledgement, g as StoreDispatch, h as SynapseTheme, T as ToolCallResult, i as ToolDefinition, V as VisibleState } from './types-BL15lUqi.cjs';
 
@@ -4,0 +4,0 @@ /**

dist/index.d.ts

@@ -1,3 +0,3 @@
-import { S as SynapseOptions, a as Synapse, A as ActionReducer, b as StoreConfig, c as Store } from './types-BP0SNrpo.js';
-export { D as DataChangedEvent, H as HostInfo, K as KeyForwardConfig, d as StateAcknowledgement, e as StoreDispatch, f as SynapseTheme, T as ToolCallResult, g as ToolDefinition, V as VisibleState } from './types-BP0SNrpo.js';
+import { S as SynapseOptions, a as Synapse, A as ActionReducer, b as StoreConfig, c as Store } from './types-BL15lUqi.js';
+export { d as AgentAction, B as BuiltinActionType, D as DataChangedEvent, H as HostInfo, K as KeyForwardConfig, N as NavigatePayload, e as NotifyPayload, f as StateAcknowledgement, g as StoreDispatch, h as SynapseTheme, T as ToolCallResult, i as ToolDefinition, V as VisibleState } from './types-BL15lUqi.js';
 
@@ -4,0 +4,0 @@ /**

dist/index.js

@@ -1,2 +0,2 @@
-export { createSynapse } from './chunk-JZC3VC2C.js';
+export { createSynapse } from './chunk-BWSAQV3P.js';
 
@@ -3,0 +3,0 @@ // src/store.ts

dist/react/index.cjs

 'use strict';
 
-var chunkQ7OSHSGZ_cjs = require('../chunk-Q7OSHSGZ.cjs');
+var chunkABJP7PL4_cjs = require('../chunk-ABJP7PL4.cjs');
 var react = require('react');
@@ -10,11 +10,5 @@ var jsxRuntime = require('react/jsx-runtime');
   const ref = react.useRef(null);
-  if (ref.current === null) {
-    ref.current = chunkQ7OSHSGZ_cjs.createSynapse(options);
+  if (ref.current === null || ref.current.destroyed) {
+    ref.current = chunkABJP7PL4_cjs.createSynapse(options);
   }
-  react.useEffect(() => {
-    return () => {
-      ref.current?.destroy();
-      ref.current = null;
-    };
-  }, []);
   return /* @__PURE__ */ jsxRuntime.jsx(SynapseContext.Provider, { value: ref.current, children });
@@ -75,2 +69,10 @@ }
 }
+function useAgentAction(callback) {
+  const synapse = useSynapseContext();
+  const callbackRef = react.useRef(callback);
+  callbackRef.current = callback;
+  react.useEffect(() => {
+    return synapse.onAction((action) => callbackRef.current(action));
+  }, [synapse]);
+}
 function useTheme() {
@@ -117,2 +119,3 @@ const synapse = useSynapseContext();
 exports.useAction = useAction;
+exports.useAgentAction = useAgentAction;
 exports.useCallTool = useCallTool;
@@ -119,0 +122,0 @@ exports.useChat = useChat;

dist/react/index.cjs.map

@@ -1,1 +0,1 @@
-{"version":3,"sources":["../../src/react/provider.tsx","../../src/react/hooks.ts"],"names":["createContext","useRef","createSynapse","useEffect","useContext","useState","useCallback","useSyncExternalStore"],"mappings":"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","file":"index.cjs","sourcesContent":["import { createContext, type ReactNode, useContext, useEffect, useRef } from \"react\";\nimport { createSynapse } from \"../core.js\";\nimport type { Synapse, SynapseOptions } from \"../types.js\";\n\nconst SynapseContext = createContext<Synapse | null>(null);\n\nexport interface SynapseProviderProps extends SynapseOptions {\n  children: ReactNode;\n}\n\nexport function SynapseProvider({ children, ...options }: SynapseProviderProps) {\n  const ref = useRef<Synapse | null>(null);\n\n  if (ref.current === null) {\n    ref.current = createSynapse(options);\n  }\n\n  useEffect(() => {\n    // StrictMode: on double-mount, the ref may already have an instance.\n    // The ref was created synchronously above, so it's always valid here.\n    return () => {\n      ref.current?.destroy();\n      ref.current = null;\n    };\n  }, []);\n\n  return <SynapseContext.Provider value={ref.current}>{children}</SynapseContext.Provider>;\n}\n\nexport function useSynapseContext(): Synapse {\n  const ctx = useContext(SynapseContext);\n  if (!ctx) {\n    throw new Error(\n      \"useSynapse must be used within a <SynapseProvider>. \" +\n        \"Wrap your app component tree with <SynapseProvider>.\",\n    );\n  }\n  return ctx;\n}\n","import { useCallback, useEffect, useRef, useState, useSyncExternalStore } from \"react\";\nimport type {\n  ActionReducer,\n  DataChangedEvent,\n  Store,\n  StoreDispatch,\n  Synapse,\n  SynapseTheme,\n  ToolCallResult,\n} from \"../types.js\";\nimport { SynapseProvider, useSynapseContext } from \"./provider.js\";\n\n// Re-export provider components\nexport { SynapseProvider };\n\nexport function useSynapse(): Synapse {\n  return useSynapseContext();\n}\n\nexport function useCallTool<TOutput = unknown>(\n  toolName: string,\n): {\n  call: (args?: Record<string, unknown>) => Promise<ToolCallResult<TOutput>>;\n  isPending: boolean;\n  error: Error | null;\n  data: TOutput | null;\n} {\n  const synapse = useSynapseContext();\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [data, setData] = useState<TOutput | null>(null);\n  const callIdRef = useRef(0);\n\n  const call = useCallback(\n    async (args?: Record<string, unknown>): Promise<ToolCallResult<TOutput>> => {\n      const id = ++callIdRef.current;\n      setIsPending(true);\n      setError(null);\n\n      try {\n        const result = await synapse.callTool<Record<string, unknown>, TOutput>(toolName, args);\n        // Stale guard: only update if this is still the latest call\n        if (id === callIdRef.current) {\n          setData(result.data);\n          setIsPending(false);\n        }\n        return result;\n      } catch (err) {\n        if (id === callIdRef.current) {\n          const e = err instanceof Error ? err : new Error(String(err));\n          setError(e);\n          setIsPending(false);\n        }\n        throw err;\n      }\n    },\n    [synapse, toolName],\n  );\n\n  return { call, isPending, error, data };\n}\n\nexport function useDataSync(callback: (event: DataChangedEvent) => void): void {\n  const synapse = useSynapseContext();\n  const callbackRef = useRef(callback);\n  callbackRef.current = callback;\n\n  useEffect(() => {\n    return synapse.onDataChanged((event) => callbackRef.current(event));\n  }, [synapse]);\n}\n\nexport function useTheme(): SynapseTheme {\n  const synapse = useSynapseContext();\n  const [theme, setTheme] = useState<SynapseTheme>(() => synapse.getTheme());\n\n  useEffect(() => {\n    // Sync in case theme changed between render and effect\n    setTheme(synapse.getTheme());\n    return synapse.onThemeChanged(setTheme);\n  }, [synapse]);\n\n  return theme;\n}\n\nexport function useAction(): (action: string, params?: Record<string, unknown>) => void {\n  const synapse = useSynapseContext();\n  return useCallback(\n    (action: string, params?: Record<string, unknown>) => synapse.action(action, params),\n    [synapse],\n  );\n}\n\nexport function useChat(): (\n  message: string,\n  context?: { action?: string; entity?: string },\n) => void {\n  const synapse = useSynapseContext();\n  return useCallback(\n    (message: string, context?: { action?: string; entity?: string }) =>\n      synapse.chat(message, context),\n    [synapse],\n  );\n}\n\nexport function useVisibleState(): (state: Record<string, unknown>, summary?: string) => void {\n  const synapse = useSynapseContext();\n  return useCallback(\n    (state: Record<string, unknown>, summary?: string) => synapse.setVisibleState(state, summary),\n    [synapse],\n  );\n}\n\nexport function useStore<TState, TActions extends Record<string, ActionReducer<TState, any>>>(\n  store: Store<TState, TActions>,\n): {\n  state: TState;\n  dispatch: StoreDispatch<TActions>;\n} {\n  const state = useSyncExternalStore(\n    (onStoreChange) => store.subscribe(onStoreChange),\n    () => store.getState(),\n    () => store.getState(),\n  );\n\n  return { state, dispatch: store.dispatch };\n}\n"]}
+{"version":3,"sources":["../../src/react/provider.tsx","../../src/react/hooks.ts"],"names":["createContext","useRef","createSynapse","useContext","useState","useCallback","useEffect","useSyncExternalStore"],"mappings":"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","file":"index.cjs","sourcesContent":["import { createContext, type ReactNode, useContext, useRef } from \"react\";\nimport { createSynapse } from \"../core.js\";\nimport type { Synapse, SynapseOptions } from \"../types.js\";\n\nconst SynapseContext = createContext<Synapse | null>(null);\n\nexport interface SynapseProviderProps extends SynapseOptions {\n  children: ReactNode;\n}\n\nexport function SynapseProvider({ children, ...options }: SynapseProviderProps) {\n  // Use a ref so the same Synapse instance survives StrictMode's\n  // unmount/remount cycle. We intentionally do NOT destroy on unmount\n  // because StrictMode re-mounts immediately and the transport must\n  // stay alive. The instance is GC'd when the provider is truly removed.\n  const ref = useRef<Synapse | null>(null);\n\n  if (ref.current === null || ref.current.destroyed) {\n    ref.current = createSynapse(options);\n  }\n\n  return <SynapseContext.Provider value={ref.current}>{children}</SynapseContext.Provider>;\n}\n\nexport function useSynapseContext(): Synapse {\n  const ctx = useContext(SynapseContext);\n  if (!ctx) {\n    throw new Error(\n      \"useSynapse must be used within a <SynapseProvider>. \" +\n        \"Wrap your app component tree with <SynapseProvider>.\",\n    );\n  }\n  return ctx;\n}\n","import { useCallback, useEffect, useRef, useState, useSyncExternalStore } from \"react\";\nimport type {\n  ActionReducer,\n  AgentAction,\n  DataChangedEvent,\n  Store,\n  StoreDispatch,\n  Synapse,\n  SynapseTheme,\n  ToolCallResult,\n} from \"../types.js\";\nimport { SynapseProvider, useSynapseContext } from \"./provider.js\";\n\n// Re-export provider components\nexport { SynapseProvider };\n\nexport function useSynapse(): Synapse {\n  return useSynapseContext();\n}\n\nexport function useCallTool<TOutput = unknown>(\n  toolName: string,\n): {\n  call: (args?: Record<string, unknown>) => Promise<ToolCallResult<TOutput>>;\n  isPending: boolean;\n  error: Error | null;\n  data: TOutput | null;\n} {\n  const synapse = useSynapseContext();\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [data, setData] = useState<TOutput | null>(null);\n  const callIdRef = useRef(0);\n\n  const call = useCallback(\n    async (args?: Record<string, unknown>): Promise<ToolCallResult<TOutput>> => {\n      const id = ++callIdRef.current;\n      setIsPending(true);\n      setError(null);\n\n      try {\n        const result = await synapse.callTool<Record<string, unknown>, TOutput>(toolName, args);\n        // Stale guard: only update if this is still the latest call\n        if (id === callIdRef.current) {\n          setData(result.data);\n          setIsPending(false);\n        }\n        return result;\n      } catch (err) {\n        if (id === callIdRef.current) {\n          const e = err instanceof Error ? err : new Error(String(err));\n          setError(e);\n          setIsPending(false);\n        }\n        throw err;\n      }\n    },\n    [synapse, toolName],\n  );\n\n  return { call, isPending, error, data };\n}\n\nexport function useDataSync(callback: (event: DataChangedEvent) => void): void {\n  const synapse = useSynapseContext();\n  const callbackRef = useRef(callback);\n  callbackRef.current = callback;\n\n  useEffect(() => {\n    return synapse.onDataChanged((event) => callbackRef.current(event));\n  }, [synapse]);\n}\n\n/**\n * Subscribe to agent actions — typed, declarative commands from the server.\n *\n * Actions are emitted by tools as deterministic side effects (e.g., \"navigate\n * to the board I just created\"). The UI decides how to handle each action type.\n *\n * @example\n * ```tsx\n * useAgentAction((action) => {\n *   if (action.type === \"navigate\") {\n *     const { entity, id } = action.payload as NavigatePayload;\n *     if (entity === \"board\") setSelectedBoardId(id);\n *   }\n * });\n * ```\n */\nexport function useAgentAction(callback: (action: AgentAction) => void): void {\n  const synapse = useSynapseContext();\n  const callbackRef = useRef(callback);\n  callbackRef.current = callback;\n\n  useEffect(() => {\n    return synapse.onAction((action) => callbackRef.current(action));\n  }, [synapse]);\n}\n\nexport function useTheme(): SynapseTheme {\n  const synapse = useSynapseContext();\n  const [theme, setTheme] = useState<SynapseTheme>(() => synapse.getTheme());\n\n  useEffect(() => {\n    // Sync in case theme changed between render and effect\n    setTheme(synapse.getTheme());\n    return synapse.onThemeChanged(setTheme);\n  }, [synapse]);\n\n  return theme;\n}\n\nexport function useAction(): (action: string, params?: Record<string, unknown>) => void {\n  const synapse = useSynapseContext();\n  return useCallback(\n    (action: string, params?: Record<string, unknown>) => synapse.action(action, params),\n    [synapse],\n  );\n}\n\nexport function useChat(): (\n  message: string,\n  context?: { action?: string; entity?: string },\n) => void {\n  const synapse = useSynapseContext();\n  return useCallback(\n    (message: string, context?: { action?: string; entity?: string }) =>\n      synapse.chat(message, context),\n    [synapse],\n  );\n}\n\nexport function useVisibleState(): (state: Record<string, unknown>, summary?: string) => void {\n  const synapse = useSynapseContext();\n  return useCallback(\n    (state: Record<string, unknown>, summary?: string) => synapse.setVisibleState(state, summary),\n    [synapse],\n  );\n}\n\nexport function useStore<TState, TActions extends Record<string, ActionReducer<TState, any>>>(\n  store: Store<TState, TActions>,\n): {\n  state: TState;\n  dispatch: StoreDispatch<TActions>;\n} {\n  const state = useSyncExternalStore(\n    (onStoreChange) => store.subscribe(onStoreChange),\n    () => store.getState(),\n    () => store.getState(),\n  );\n\n  return { state, dispatch: store.dispatch };\n}\n"]}

dist/react/index.d.cts

@@ -1,2 +0,2 @@
-import { S as SynapseOptions, T as ToolCallResult, D as DataChangedEvent, A as ActionReducer, c as Store, e as StoreDispatch, a as Synapse, f as SynapseTheme } from '../types-BP0SNrpo.cjs';
+import { S as SynapseOptions, d as AgentAction, T as ToolCallResult, D as DataChangedEvent, A as ActionReducer, c as Store, g as StoreDispatch, a as Synapse, h as SynapseTheme } from '../types-BL15lUqi.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -18,2 +18,19 @@ import { ReactNode } from 'react';
 declare function useDataSync(callback: (event: DataChangedEvent) => void): void;
+/**
+ * Subscribe to agent actions — typed, declarative commands from the server.
+ *
+ * Actions are emitted by tools as deterministic side effects (e.g., "navigate
+ * to the board I just created"). The UI decides how to handle each action type.
+ *
+ * @example
+ * ```tsx
+ * useAgentAction((action) => {
+ *   if (action.type === "navigate") {
+ *     const { entity, id } = action.payload as NavigatePayload;
+ *     if (entity === "board") setSelectedBoardId(id);
+ *   }
+ * });
+ * ```
+ */
+declare function useAgentAction(callback: (action: AgentAction) => void): void;
 declare function useTheme(): SynapseTheme;
@@ -31,2 +48,2 @@ declare function useAction(): (action: string, params?: Record<string, unknown>) => void;
 
-export { SynapseProvider, type SynapseProviderProps, useAction, useCallTool, useChat, useDataSync, useStore, useSynapse, useTheme, useVisibleState };
+export { SynapseProvider, type SynapseProviderProps, useAction, useAgentAction, useCallTool, useChat, useDataSync, useStore, useSynapse, useTheme, useVisibleState };

dist/react/index.d.ts

@@ -1,2 +0,2 @@
-import { S as SynapseOptions, T as ToolCallResult, D as DataChangedEvent, A as ActionReducer, c as Store, e as StoreDispatch, a as Synapse, f as SynapseTheme } from '../types-BP0SNrpo.js';
+import { S as SynapseOptions, d as AgentAction, T as ToolCallResult, D as DataChangedEvent, A as ActionReducer, c as Store, g as StoreDispatch, a as Synapse, h as SynapseTheme } from '../types-BL15lUqi.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -18,2 +18,19 @@ import { ReactNode } from 'react';
 declare function useDataSync(callback: (event: DataChangedEvent) => void): void;
+/**
+ * Subscribe to agent actions — typed, declarative commands from the server.
+ *
+ * Actions are emitted by tools as deterministic side effects (e.g., "navigate
+ * to the board I just created"). The UI decides how to handle each action type.
+ *
+ * @example
+ * ```tsx
+ * useAgentAction((action) => {
+ *   if (action.type === "navigate") {
+ *     const { entity, id } = action.payload as NavigatePayload;
+ *     if (entity === "board") setSelectedBoardId(id);
+ *   }
+ * });
+ * ```
+ */
+declare function useAgentAction(callback: (action: AgentAction) => void): void;
 declare function useTheme(): SynapseTheme;
@@ -31,2 +48,2 @@ declare function useAction(): (action: string, params?: Record<string, unknown>) => void;
 
-export { SynapseProvider, type SynapseProviderProps, useAction, useCallTool, useChat, useDataSync, useStore, useSynapse, useTheme, useVisibleState };
+export { SynapseProvider, type SynapseProviderProps, useAction, useAgentAction, useCallTool, useChat, useDataSync, useStore, useSynapse, useTheme, useVisibleState };

dist/react/index.js

@@ -1,3 +0,3 @@
-import { createSynapse } from '../chunk-JZC3VC2C.js';
-import { createContext, useRef, useEffect, useState, useCallback, useSyncExternalStore, useContext } from 'react';
+import { createSynapse } from '../chunk-BWSAQV3P.js';
+import { createContext, useRef, useState, useCallback, useEffect, useSyncExternalStore, useContext } from 'react';
 import { jsx } from 'react/jsx-runtime';
@@ -8,11 +8,5 @@
   const ref = useRef(null);
-  if (ref.current === null) {
+  if (ref.current === null || ref.current.destroyed) {
     ref.current = createSynapse(options);
   }
-  useEffect(() => {
-    return () => {
-      ref.current?.destroy();
-      ref.current = null;
-    };
-  }, []);
   return /* @__PURE__ */ jsx(SynapseContext.Provider, { value: ref.current, children });
@@ -73,2 +67,10 @@ }
 }
+function useAgentAction(callback) {
+  const synapse = useSynapseContext();
+  const callbackRef = useRef(callback);
+  callbackRef.current = callback;
+  useEffect(() => {
+    return synapse.onAction((action) => callbackRef.current(action));
+  }, [synapse]);
+}
 function useTheme() {
@@ -113,4 +115,4 @@ const synapse = useSynapseContext();
 
-export { SynapseProvider, useAction, useCallTool, useChat, useDataSync, useStore, useSynapse, useTheme, useVisibleState };
+export { SynapseProvider, useAction, useAgentAction, useCallTool, useChat, useDataSync, useStore, useSynapse, useTheme, useVisibleState };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

dist/react/index.js.map

@@ -1,1 +0,1 @@
-{"version":3,"sources":["../../src/react/provider.tsx","../../src/react/hooks.ts"],"names":["useRef","useEffect"],"mappings":"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","file":"index.js","sourcesContent":["import { createContext, type ReactNode, useContext, useEffect, useRef } from \"react\";\nimport { createSynapse } from \"../core.js\";\nimport type { Synapse, SynapseOptions } from \"../types.js\";\n\nconst SynapseContext = createContext<Synapse | null>(null);\n\nexport interface SynapseProviderProps extends SynapseOptions {\n  children: ReactNode;\n}\n\nexport function SynapseProvider({ children, ...options }: SynapseProviderProps) {\n  const ref = useRef<Synapse | null>(null);\n\n  if (ref.current === null) {\n    ref.current = createSynapse(options);\n  }\n\n  useEffect(() => {\n    // StrictMode: on double-mount, the ref may already have an instance.\n    // The ref was created synchronously above, so it's always valid here.\n    return () => {\n      ref.current?.destroy();\n      ref.current = null;\n    };\n  }, []);\n\n  return <SynapseContext.Provider value={ref.current}>{children}</SynapseContext.Provider>;\n}\n\nexport function useSynapseContext(): Synapse {\n  const ctx = useContext(SynapseContext);\n  if (!ctx) {\n    throw new Error(\n      \"useSynapse must be used within a <SynapseProvider>. \" +\n        \"Wrap your app component tree with <SynapseProvider>.\",\n    );\n  }\n  return ctx;\n}\n","import { useCallback, useEffect, useRef, useState, useSyncExternalStore } from \"react\";\nimport type {\n  ActionReducer,\n  DataChangedEvent,\n  Store,\n  StoreDispatch,\n  Synapse,\n  SynapseTheme,\n  ToolCallResult,\n} from \"../types.js\";\nimport { SynapseProvider, useSynapseContext } from \"./provider.js\";\n\n// Re-export provider components\nexport { SynapseProvider };\n\nexport function useSynapse(): Synapse {\n  return useSynapseContext();\n}\n\nexport function useCallTool<TOutput = unknown>(\n  toolName: string,\n): {\n  call: (args?: Record<string, unknown>) => Promise<ToolCallResult<TOutput>>;\n  isPending: boolean;\n  error: Error | null;\n  data: TOutput | null;\n} {\n  const synapse = useSynapseContext();\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [data, setData] = useState<TOutput | null>(null);\n  const callIdRef = useRef(0);\n\n  const call = useCallback(\n    async (args?: Record<string, unknown>): Promise<ToolCallResult<TOutput>> => {\n      const id = ++callIdRef.current;\n      setIsPending(true);\n      setError(null);\n\n      try {\n        const result = await synapse.callTool<Record<string, unknown>, TOutput>(toolName, args);\n        // Stale guard: only update if this is still the latest call\n        if (id === callIdRef.current) {\n          setData(result.data);\n          setIsPending(false);\n        }\n        return result;\n      } catch (err) {\n        if (id === callIdRef.current) {\n          const e = err instanceof Error ? err : new Error(String(err));\n          setError(e);\n          setIsPending(false);\n        }\n        throw err;\n      }\n    },\n    [synapse, toolName],\n  );\n\n  return { call, isPending, error, data };\n}\n\nexport function useDataSync(callback: (event: DataChangedEvent) => void): void {\n  const synapse = useSynapseContext();\n  const callbackRef = useRef(callback);\n  callbackRef.current = callback;\n\n  useEffect(() => {\n    return synapse.onDataChanged((event) => callbackRef.current(event));\n  }, [synapse]);\n}\n\nexport function useTheme(): SynapseTheme {\n  const synapse = useSynapseContext();\n  const [theme, setTheme] = useState<SynapseTheme>(() => synapse.getTheme());\n\n  useEffect(() => {\n    // Sync in case theme changed between render and effect\n    setTheme(synapse.getTheme());\n    return synapse.onThemeChanged(setTheme);\n  }, [synapse]);\n\n  return theme;\n}\n\nexport function useAction(): (action: string, params?: Record<string, unknown>) => void {\n  const synapse = useSynapseContext();\n  return useCallback(\n    (action: string, params?: Record<string, unknown>) => synapse.action(action, params),\n    [synapse],\n  );\n}\n\nexport function useChat(): (\n  message: string,\n  context?: { action?: string; entity?: string },\n) => void {\n  const synapse = useSynapseContext();\n  return useCallback(\n    (message: string, context?: { action?: string; entity?: string }) =>\n      synapse.chat(message, context),\n    [synapse],\n  );\n}\n\nexport function useVisibleState(): (state: Record<string, unknown>, summary?: string) => void {\n  const synapse = useSynapseContext();\n  return useCallback(\n    (state: Record<string, unknown>, summary?: string) => synapse.setVisibleState(state, summary),\n    [synapse],\n  );\n}\n\nexport function useStore<TState, TActions extends Record<string, ActionReducer<TState, any>>>(\n  store: Store<TState, TActions>,\n): {\n  state: TState;\n  dispatch: StoreDispatch<TActions>;\n} {\n  const state = useSyncExternalStore(\n    (onStoreChange) => store.subscribe(onStoreChange),\n    () => store.getState(),\n    () => store.getState(),\n  );\n\n  return { state, dispatch: store.dispatch };\n}\n"]}
+{"version":3,"sources":["../../src/react/provider.tsx","../../src/react/hooks.ts"],"names":["useRef"],"mappings":"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","file":"index.js","sourcesContent":["import { createContext, type ReactNode, useContext, useRef } from \"react\";\nimport { createSynapse } from \"../core.js\";\nimport type { Synapse, SynapseOptions } from \"../types.js\";\n\nconst SynapseContext = createContext<Synapse | null>(null);\n\nexport interface SynapseProviderProps extends SynapseOptions {\n  children: ReactNode;\n}\n\nexport function SynapseProvider({ children, ...options }: SynapseProviderProps) {\n  // Use a ref so the same Synapse instance survives StrictMode's\n  // unmount/remount cycle. We intentionally do NOT destroy on unmount\n  // because StrictMode re-mounts immediately and the transport must\n  // stay alive. The instance is GC'd when the provider is truly removed.\n  const ref = useRef<Synapse | null>(null);\n\n  if (ref.current === null || ref.current.destroyed) {\n    ref.current = createSynapse(options);\n  }\n\n  return <SynapseContext.Provider value={ref.current}>{children}</SynapseContext.Provider>;\n}\n\nexport function useSynapseContext(): Synapse {\n  const ctx = useContext(SynapseContext);\n  if (!ctx) {\n    throw new Error(\n      \"useSynapse must be used within a <SynapseProvider>. \" +\n        \"Wrap your app component tree with <SynapseProvider>.\",\n    );\n  }\n  return ctx;\n}\n","import { useCallback, useEffect, useRef, useState, useSyncExternalStore } from \"react\";\nimport type {\n  ActionReducer,\n  AgentAction,\n  DataChangedEvent,\n  Store,\n  StoreDispatch,\n  Synapse,\n  SynapseTheme,\n  ToolCallResult,\n} from \"../types.js\";\nimport { SynapseProvider, useSynapseContext } from \"./provider.js\";\n\n// Re-export provider components\nexport { SynapseProvider };\n\nexport function useSynapse(): Synapse {\n  return useSynapseContext();\n}\n\nexport function useCallTool<TOutput = unknown>(\n  toolName: string,\n): {\n  call: (args?: Record<string, unknown>) => Promise<ToolCallResult<TOutput>>;\n  isPending: boolean;\n  error: Error | null;\n  data: TOutput | null;\n} {\n  const synapse = useSynapseContext();\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [data, setData] = useState<TOutput | null>(null);\n  const callIdRef = useRef(0);\n\n  const call = useCallback(\n    async (args?: Record<string, unknown>): Promise<ToolCallResult<TOutput>> => {\n      const id = ++callIdRef.current;\n      setIsPending(true);\n      setError(null);\n\n      try {\n        const result = await synapse.callTool<Record<string, unknown>, TOutput>(toolName, args);\n        // Stale guard: only update if this is still the latest call\n        if (id === callIdRef.current) {\n          setData(result.data);\n          setIsPending(false);\n        }\n        return result;\n      } catch (err) {\n        if (id === callIdRef.current) {\n          const e = err instanceof Error ? err : new Error(String(err));\n          setError(e);\n          setIsPending(false);\n        }\n        throw err;\n      }\n    },\n    [synapse, toolName],\n  );\n\n  return { call, isPending, error, data };\n}\n\nexport function useDataSync(callback: (event: DataChangedEvent) => void): void {\n  const synapse = useSynapseContext();\n  const callbackRef = useRef(callback);\n  callbackRef.current = callback;\n\n  useEffect(() => {\n    return synapse.onDataChanged((event) => callbackRef.current(event));\n  }, [synapse]);\n}\n\n/**\n * Subscribe to agent actions — typed, declarative commands from the server.\n *\n * Actions are emitted by tools as deterministic side effects (e.g., \"navigate\n * to the board I just created\"). The UI decides how to handle each action type.\n *\n * @example\n * ```tsx\n * useAgentAction((action) => {\n *   if (action.type === \"navigate\") {\n *     const { entity, id } = action.payload as NavigatePayload;\n *     if (entity === \"board\") setSelectedBoardId(id);\n *   }\n * });\n * ```\n */\nexport function useAgentAction(callback: (action: AgentAction) => void): void {\n  const synapse = useSynapseContext();\n  const callbackRef = useRef(callback);\n  callbackRef.current = callback;\n\n  useEffect(() => {\n    return synapse.onAction((action) => callbackRef.current(action));\n  }, [synapse]);\n}\n\nexport function useTheme(): SynapseTheme {\n  const synapse = useSynapseContext();\n  const [theme, setTheme] = useState<SynapseTheme>(() => synapse.getTheme());\n\n  useEffect(() => {\n    // Sync in case theme changed between render and effect\n    setTheme(synapse.getTheme());\n    return synapse.onThemeChanged(setTheme);\n  }, [synapse]);\n\n  return theme;\n}\n\nexport function useAction(): (action: string, params?: Record<string, unknown>) => void {\n  const synapse = useSynapseContext();\n  return useCallback(\n    (action: string, params?: Record<string, unknown>) => synapse.action(action, params),\n    [synapse],\n  );\n}\n\nexport function useChat(): (\n  message: string,\n  context?: { action?: string; entity?: string },\n) => void {\n  const synapse = useSynapseContext();\n  return useCallback(\n    (message: string, context?: { action?: string; entity?: string }) =>\n      synapse.chat(message, context),\n    [synapse],\n  );\n}\n\nexport function useVisibleState(): (state: Record<string, unknown>, summary?: string) => void {\n  const synapse = useSynapseContext();\n  return useCallback(\n    (state: Record<string, unknown>, summary?: string) => synapse.setVisibleState(state, summary),\n    [synapse],\n  );\n}\n\nexport function useStore<TState, TActions extends Record<string, ActionReducer<TState, any>>>(\n  store: Store<TState, TActions>,\n): {\n  state: TState;\n  dispatch: StoreDispatch<TActions>;\n} {\n  const state = useSyncExternalStore(\n    (onStoreChange) => store.subscribe(onStoreChange),\n    () => store.getState(),\n    () => store.getState(),\n  );\n\n  return { state, dispatch: store.dispatch };\n}\n"]}

dist/synapse-runtime.iife.global.js

@@ -1,1 +0,1 @@
-(function(){'use strict';var b={mode:"light",primaryColor:"#6366f1",tokens:{}};function E(r){let e=r,t=C(e?.serverInfo),n=typeof t?.name=="string"?t.name:"unknown",i=typeof e?.protocolVersion=="string"?e.protocolVersion:"unknown",s=C(e?.hostContext),l=K(s?.theme);return {isNimbleBrain:n==="nimblebrain",serverName:n,protocolVersion:i,theme:l}}function K(r){let e=C(r);if(!e)return {...b};let t=e.mode==="light"||e.mode==="dark"?e.mode:b.mode,n=typeof e.primaryColor=="string"?e.primaryColor:b.primaryColor,i=e.tokens!==null&&typeof e.tokens=="object"&&!Array.isArray(e.tokens)?e.tokens:{};return {mode:t,primaryColor:n,tokens:i}}function C(r){if(r!==null&&typeof r=="object"&&!Array.isArray(r))return r}var k=class{listener;destroyed=false;constructor(e,t){let n=t??null;this.listener=i=>{this.destroyed||this.shouldForward(i,n)&&(i.preventDefault(),e.send("ui/keydown",{key:i.key,ctrlKey:i.ctrlKey,metaKey:i.metaKey,shiftKey:i.shiftKey,altKey:i.altKey}));},document.addEventListener("keydown",this.listener);}destroy(){this.destroyed||(this.destroyed=true,document.removeEventListener("keydown",this.listener));}shouldForward(e,t){return t&&t.length===0?false:t?t.some(n=>e.key.toLowerCase()===n.key.toLowerCase()&&(n.ctrl===void 0||e.ctrlKey===n.ctrl)&&(n.meta===void 0||e.metaKey===n.meta)&&(n.shift===void 0||e.shiftKey===n.shift)&&(n.alt===void 0||e.altKey===n.alt)):!!(e.key==="Escape"||e.ctrlKey||e.metaKey)}};function M(r){return r==null?{data:null,isError:false}:A(r)?I(r):{data:r,isError:false}}function A(r){return r===null||typeof r!="object"||Array.isArray(r)?false:Array.isArray(r.content)}function H(r){if(r===null||typeof r!="object"||Array.isArray(r))return  false;let e=r;return e.type==="text"&&typeof e.text=="string"}function I(r){let e=r.isError===true,t=r.content;if(t.length===0)return {data:null,isError:e};let n=t.find(H);if(!n)return {data:t,isError:e};try{return {data:JSON.parse(n.text),isError:e}}catch{return {data:n.text,isError:e}}}var R=class{counter=0;destroyed=false;pending=new Map;handlers=new Map;listener;constructor(){this.listener=e=>this.handleMessage(e),window.addEventListener("message",this.listener);}send(e,t){if(this.destroyed)return;let n={jsonrpc:"2.0",method:e,...t!==void 0&&{params:t}};window.parent.postMessage(n,"*");}request(e,t){if(this.destroyed)return Promise.reject(new Error("Transport destroyed"));let n=`syn-${++this.counter}`,i={jsonrpc:"2.0",method:e,id:n,...t!==void 0&&{params:t}};return new Promise((s,l)=>{this.pending.set(n,{resolve:s,reject:l}),window.parent.postMessage(i,"*");})}onMessage(e,t){return this.handlers.has(e)||this.handlers.set(e,new Set),this.handlers.get(e)?.add(t),()=>{let n=this.handlers.get(e);n&&(n.delete(t),n.size===0&&this.handlers.delete(e));}}destroy(){if(this.destroyed)return;this.destroyed=true,window.removeEventListener("message",this.listener);let e=new Error("Transport destroyed");for(let t of this.pending.values())t.reject(e);this.pending.clear(),this.handlers.clear();}handleMessage(e){if(this.destroyed)return;let t=e.data;if(!(!t||t.jsonrpc!=="2.0")){if("id"in t&&t.id&&!("method"in t)){let n=t,i=this.pending.get(n.id);if(!i)return;if(this.pending.delete(n.id),n.error){let s=new Error(n.error.message);s.code=n.error.code,s.data=n.error.data,i.reject(s);}else i.resolve(n.result);return}if("method"in t&&!("id"in t&&t.id)){let n=t,i=this.handlers.get(n.method);if(i)for(let s of i)s(n.params);}}}};function j(r){let{name:e,version:t,internal:n=false,forwardKeys:i}=r,s=new R,l=null,u={mode:"light",primaryColor:"#6366f1",tokens:{}},w=false,y=null,T=null,v=s.request("ui/initialize",{protocolVersion:"2026-01-26",clientInfo:{name:e,version:t},capabilities:{}}).then(o=>{l=E(o),u=l.theme,s.send("ui/notifications/initialized",{}),T=new k(s,i);}),d=s.onMessage("ui/notifications/host-context-changed",o=>{if(!o)return;let a=o.theme==="dark"?"dark":"light",p=o.tokens&&typeof o.tokens=="object"?o.tokens:u.tokens;u={mode:a,primaryColor:u.primaryColor,tokens:p};for(let g of m)g(u);}),f=s.onMessage("ui/themeChanged",o=>{if(!o)return;let a=o.mode==="dark"||o.mode==="light"?o.mode:u.mode,p=o.tokens&&typeof o.tokens=="object"?o.tokens:u.tokens;u={mode:a,primaryColor:u.primaryColor,tokens:p};for(let g of m)g(u);}),m=new Set,h=new Set,S=s.onMessage("ui/datachanged",o=>{if(!o)return;let a={source:"agent",server:o.server??"",tool:o.tool??""};for(let p of h)p(a);}),c=()=>l?.isNimbleBrain===true;return {get ready(){return v},get isNimbleBrainHost(){return c()},async callTool(o,a){let p={name:o,arguments:a??{}};n&&(p.server=e);let g=await s.request("tools/call",p);return M(g)},onDataChanged(o){return h.add(o),()=>{h.delete(o);}},getTheme(){return {...u}},onThemeChanged(o){return m.add(o),()=>{m.delete(o);}},action(o,a){c()&&s.send("ui/action",{action:o,...a});},chat(o,a){c()&&s.send("ui/chat",{message:o,context:a});},setVisibleState(o,a){c()&&(y&&clearTimeout(y),y=setTimeout(()=>{s.send("ui/stateChanged",{state:o,...a!==void 0&&{summary:a}}),y=null;},250));},downloadFile(o,a,p){if(!c())return;let g=typeof a=="string"?a:"[Blob content not serializable]";s.send("ui/downloadFile",{data:g,filename:o,mimeType:p??"application/octet-stream"});},openLink(o){c()?s.send("ui/openLink",{url:o}):window.open(o,"_blank","noopener");},_onMessage(o,a){return s.onMessage(o,a)},_request(o,a){return s.request(o,a)},destroy(){w||(w=true,y&&clearTimeout(y),T?.destroy(),d(),f(),S(),m.clear(),h.clear(),s.destroy());}}}function x(r,e){let t=structuredClone(e.initialState),n=new Set,i=false,s=null,l={};for(let d of Object.keys(e.actions))l[d]=f=>{i||(t=e.actions[d](t,f),u());};function u(){for(let d of n)d(t);e.visibleToAgent&&w(),e.persist&&y();}function w(){let d=e.summarize?.(t);r.setVisibleState(t,d);}function y(){s&&clearTimeout(s),s=setTimeout(()=>{r._request("ui/persistState",{state:t,version:e.version}).catch(()=>{}),s=null;},500);}let T;e.persist&&(T=r._onMessage("ui/stateLoaded",d=>{if(!d?.state)return;let f=d.state,m=d.version??1,h=e.version??1;if(e.migrations&&m<h){let S=m-1;for(let c=S;c<e.migrations.length;c++)f=e.migrations[c](f);}v.hydrate(f);}));let v={getState(){return t},subscribe(d){return n.add(d),()=>{n.delete(d);}},dispatch:l,hydrate(d){t=d;for(let f of n)f(t);},destroy(){i||(i=true,s&&clearTimeout(s),n.clear(),T?.());}};return v}window.NbSynapse={createSynapse:j,createStore:x};})();
+(function(){'use strict';var C={mode:"light",primaryColor:"#6366f1",tokens:{}};function E(r){let e=r,n=A(e?.serverInfo),o=typeof n?.name=="string"?n.name:"unknown",i=typeof e?.protocolVersion=="string"?e.protocolVersion:"unknown",s=A(e?.hostContext),c=H(s?.theme);return {isNimbleBrain:o==="nimblebrain",serverName:o,protocolVersion:i,theme:c}}function H(r){let e=A(r);if(!e)return {...C};let n=e.mode==="light"||e.mode==="dark"?e.mode:C.mode,o=typeof e.primaryColor=="string"?e.primaryColor:C.primaryColor,i=e.tokens!==null&&typeof e.tokens=="object"&&!Array.isArray(e.tokens)?e.tokens:{};return {mode:n,primaryColor:o,tokens:i}}function A(r){if(r!==null&&typeof r=="object"&&!Array.isArray(r))return r}var S=class{listener;destroyed=false;constructor(e,n){let o=n??null;this.listener=i=>{this.destroyed||this.shouldForward(i,o)&&(i.preventDefault(),e.send("ui/keydown",{key:i.key,ctrlKey:i.ctrlKey,metaKey:i.metaKey,shiftKey:i.shiftKey,altKey:i.altKey}));},document.addEventListener("keydown",this.listener);}destroy(){this.destroyed||(this.destroyed=true,document.removeEventListener("keydown",this.listener));}shouldForward(e,n){return n&&n.length===0?false:n?n.some(o=>e.key.toLowerCase()===o.key.toLowerCase()&&(o.ctrl===void 0||e.ctrlKey===o.ctrl)&&(o.meta===void 0||e.metaKey===o.meta)&&(o.shift===void 0||e.shiftKey===o.shift)&&(o.alt===void 0||e.altKey===o.alt)):!!(e.key==="Escape"||e.ctrlKey||e.metaKey)}};function M(r){return r==null?{data:null,isError:false}:I(r)?N(r):{data:r,isError:false}}function I(r){return r===null||typeof r!="object"||Array.isArray(r)?false:Array.isArray(r.content)}function L(r){if(r===null||typeof r!="object"||Array.isArray(r))return  false;let e=r;return e.type==="text"&&typeof e.text=="string"}function N(r){let e=r.isError===true,n=r.content;if(n.length===0)return {data:null,isError:e};let o=n.find(L);if(!o)return {data:n,isError:e};try{return {data:JSON.parse(o.text),isError:e}}catch{return {data:o.text,isError:e}}}var b=class{counter=0;destroyed=false;pending=new Map;handlers=new Map;listener;constructor(){this.listener=e=>this.handleMessage(e),window.addEventListener("message",this.listener);}send(e,n){if(this.destroyed)return;let o={jsonrpc:"2.0",method:e,...n!==void 0&&{params:n}};window.parent.postMessage(o,"*");}request(e,n){if(this.destroyed)return Promise.reject(new Error("Transport destroyed"));let o=`syn-${++this.counter}`,i={jsonrpc:"2.0",method:e,id:o,...n!==void 0&&{params:n}};return new Promise((s,c)=>{this.pending.set(o,{resolve:s,reject:c}),window.parent.postMessage(i,"*");})}onMessage(e,n){return this.handlers.has(e)||this.handlers.set(e,new Set),this.handlers.get(e)?.add(n),()=>{let o=this.handlers.get(e);o&&(o.delete(n),o.size===0&&this.handlers.delete(e));}}destroy(){if(this.destroyed)return;this.destroyed=true,window.removeEventListener("message",this.listener);let e=new Error("Transport destroyed");for(let n of this.pending.values())n.reject(e);this.pending.clear(),this.handlers.clear();}handleMessage(e){if(this.destroyed)return;let n=e.data;if(!(!n||n.jsonrpc!=="2.0")){if("id"in n&&n.id&&!("method"in n)){let o=n,i=this.pending.get(o.id);if(!i)return;if(this.pending.delete(o.id),o.error){let s=new Error(o.error.message);s.code=o.error.code,s.data=o.error.data,i.reject(s);}else i.resolve(o.result);return}if("method"in n&&!("id"in n&&n.id)){let o=n,i=this.handlers.get(o.method);if(i)for(let s of i)s(o.params);}}}};function j(r){let{name:e,version:n,internal:o=false,forwardKeys:i}=r,s=new b,c=null,u={mode:"light",primaryColor:"#6366f1",tokens:{}},w=false,y=null,v=null,R=s.request("ui/initialize",{protocolVersion:"2026-01-26",clientInfo:{name:e,version:n},capabilities:{}}).then(t=>{c=E(t),u=c.theme,s.send("ui/notifications/initialized",{}),v=new S(s,i);}),d=s.onMessage("ui/notifications/host-context-changed",t=>{if(!t)return;let a=t.theme==="dark"?"dark":"light",l=t.tokens&&typeof t.tokens=="object"?t.tokens:u.tokens;u={mode:a,primaryColor:u.primaryColor,tokens:l};for(let g of p)g(u);}),f=s.onMessage("ui/themeChanged",t=>{if(!t)return;let a=t.mode==="dark"||t.mode==="light"?t.mode:u.mode,l=t.tokens&&typeof t.tokens=="object"?t.tokens:u.tokens;u={mode:a,primaryColor:u.primaryColor,tokens:l};for(let g of p)g(u);}),p=new Set,m=new Set,h=new Set,k=s.onMessage("ui/datachanged",t=>{if(!t)return;let a={source:"agent",server:t.server??"",tool:t.tool??""};for(let l of m)l(a);}),K=s.onMessage("ui/action",t=>{if(!t||typeof t.type!="string")return;let a={type:t.type,payload:t.payload??{},requiresConfirmation:t.requiresConfirmation===true,label:typeof t.label=="string"?t.label:void 0};for(let l of h)l(a);}),T=()=>c?.isNimbleBrain===true;return {get ready(){return R},get isNimbleBrainHost(){return T()},get destroyed(){return w},async callTool(t,a){let l={name:t,arguments:a??{}};o&&(l.server=e);let g=await s.request("tools/call",l);return M(g)},onDataChanged(t){return m.add(t),()=>{m.delete(t);}},onAction(t){return h.add(t),()=>{h.delete(t);}},getTheme(){return {...u}},onThemeChanged(t){return p.add(t),()=>{p.delete(t);}},action(t,a){T()&&s.send("ui/action",{action:t,...a});},chat(t,a){T()&&s.send("ui/chat",{message:t,context:a});},setVisibleState(t,a){T()&&(y&&clearTimeout(y),y=setTimeout(()=>{s.send("ui/stateChanged",{state:t,...a!==void 0&&{summary:a}}),y=null;},250));},downloadFile(t,a,l){if(!T())return;let g=typeof a=="string"?a:"[Blob content not serializable]";s.send("ui/downloadFile",{data:g,filename:t,mimeType:l??"application/octet-stream"});},openLink(t){T()?s.send("ui/openLink",{url:t}):window.open(t,"_blank","noopener");},_onMessage(t,a){return s.onMessage(t,a)},_request(t,a){return s.request(t,a)},destroy(){w||(w=true,y&&clearTimeout(y),v?.destroy(),d(),f(),k(),K(),p.clear(),m.clear(),h.clear(),s.destroy());}}}function x(r,e){let n=structuredClone(e.initialState),o=new Set,i=false,s=null,c={};for(let d of Object.keys(e.actions))c[d]=f=>{i||(n=e.actions[d](n,f),u());};function u(){for(let d of o)d(n);e.visibleToAgent&&w(),e.persist&&y();}function w(){let d=e.summarize?.(n);r.setVisibleState(n,d);}function y(){s&&clearTimeout(s),s=setTimeout(()=>{r._request("ui/persistState",{state:n,version:e.version}).catch(()=>{}),s=null;},500);}let v;e.persist&&(v=r._onMessage("ui/stateLoaded",d=>{if(!d?.state)return;let f=d.state,p=d.version??1,m=e.version??1;if(e.migrations&&p<m){let h=p-1;for(let k=h;k<e.migrations.length;k++)f=e.migrations[k](f);}R.hydrate(f);}));let R={getState(){return n},subscribe(d){return o.add(d),()=>{o.delete(d);}},dispatch:c,hydrate(d){n=d;for(let f of o)f(n);},destroy(){i||(i=true,s&&clearTimeout(s),o.clear(),v?.());}};return R}window.NbSynapse={createSynapse:j,createStore:x};})();

dist/vite/index.cjs

@@ -204,3 +204,3 @@ 'use strict';
   </header>
-  <iframe id="app" src="/"></iframe>
+  <iframe id="app"></iframe>
 
@@ -213,15 +213,15 @@ <script>
       return d ? {
-        "--nb-background":"#0f172a","--nb-foreground":"#e2e8f0",
-        "--nb-card":"#1e293b","--nb-card-foreground":"#e2e8f0",
-        "--nb-primary":"#6366f1","--nb-primary-foreground":"#fff",
-        "--nb-muted-foreground":"#94a3b8","--nb-border":"#334155",
-        "--nb-ring":"#6366f1","--nb-destructive":"#ef4444",
-        "--nb-radius":"0.5rem","--nb-font-sans":"-apple-system,BlinkMacSystemFont,sans-serif"
+        "--color-background-primary":"#0f172a","--color-text-primary":"#e2e8f0",
+        "--color-background-secondary":"#1e293b","--color-text-primary":"#e2e8f0",
+        "--color-text-accent":"#6366f1","--nb-color-accent-foreground":"#fff",
+        "--color-text-secondary":"#94a3b8","--color-border-primary":"#334155",
+        "--color-ring-primary":"#6366f1","--nb-color-danger":"#ef4444",
+        "--border-radius-sm":"0.5rem","--font-sans":"-apple-system,BlinkMacSystemFont,sans-serif"
       } : {
-        "--nb-background":"#ffffff","--nb-foreground":"#0f172a",
-        "--nb-card":"#f8fafc","--nb-card-foreground":"#0f172a",
-        "--nb-primary":"#6366f1","--nb-primary-foreground":"#fff",
-        "--nb-muted-foreground":"#64748b","--nb-border":"#e2e8f0",
-        "--nb-ring":"#6366f1","--nb-destructive":"#ef4444",
-        "--nb-radius":"0.5rem","--nb-font-sans":"-apple-system,BlinkMacSystemFont,sans-serif"
+        "--color-background-primary":"#ffffff","--color-text-primary":"#0f172a",
+        "--color-background-secondary":"#f8fafc","--color-text-primary":"#0f172a",
+        "--color-text-accent":"#6366f1","--nb-color-accent-foreground":"#fff",
+        "--color-text-secondary":"#64748b","--color-border-primary":"#e2e8f0",
+        "--color-ring-primary":"#6366f1","--nb-color-danger":"#ef4444",
+        "--border-radius-sm":"0.5rem","--font-sans":"-apple-system,BlinkMacSystemFont,sans-serif"
       };
@@ -260,2 +260,8 @@ }
           post(response);
+          // Notify the app that data changed so hooks auto-refresh
+          // Only for mutating operations (not list/search/get which are read-only)
+          var tn = msg.params.name || "";
+          if (!response.error && !tn.startsWith("list_") && !tn.startsWith("search_") && !tn.startsWith("get_") && !tn.startsWith("query_")) {
+            post({jsonrpc:"2.0",method:"ui/datachanged",params:{tool:tn,server:"preview"}});
+          }
         } catch(err) {
@@ -280,2 +286,6 @@ post({jsonrpc:"2.0",id:originalId,error:{code:-32000,message:err.message}});
     };
+
+    // Load the iframe AFTER the message listener is attached to avoid
+    // a race where the app sends ui/initialize before the bridge is ready.
+    iframe.src = "/";
   </script>
@@ -282,0 +292,0 @@ </body>

dist/vite/index.cjs.map

@@ -1,1 +0,1 @@
-{"version":3,"sources":["../../src/vite/plugin.ts"],"names":["resolve","existsSync","readFileSync","join","spawn"],"mappings":"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","file":"index.cjs","sourcesContent":["import { type ChildProcess, spawn } from \"node:child_process\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport type { Plugin, ViteDevServer } from \"vite\";\n\nexport interface SynapseVitePluginOptions {\n  /** App name. If omitted, reads from ../manifest.json */\n  appName?: string;\n  /** Path to manifest.json. Default: ../manifest.json (relative to ui/) */\n  manifest?: string;\n  /**\n   * Shell command to start the MCP server. If omitted, derived from manifest.\n   * The server runs in stdio mode — stdin/stdout JSON-RPC.\n   */\n  serverCmd?: string;\n  /** Set to false to disable the preview host page at /__preview */\n  preview?: boolean;\n}\n\ninterface Manifest {\n  name: string;\n  version?: string;\n  server?: {\n    type?: string;\n    entry_point?: string;\n    mcp_config?: {\n      command?: string;\n      args?: string[];\n    };\n  };\n}\n\n/**\n * Synapse Vite plugin — full local dev experience for MCP apps.\n *\n * What it does:\n * - Reads ../manifest.json to get app name and server config\n * - Spawns the MCP server as a child process (stdio mode)\n * - Serves a preview host page at /__preview that iframes your app\n * - Proxies tool calls from the iframe through POST /__mcp to the server\n * - Handles the ext-apps handshake so Synapse hooks work\n * - HMR works inside the iframe — edit .tsx, see changes instantly\n *\n * Usage in vite.config.ts:\n *   import { synapseVite } from \"@nimblebrain/synapse/vite\";\n *   export default { plugins: [react(), viteSingleFile(), synapseVite()] };\n *\n * Then: cd ui && npm run dev && open http://localhost:5173/__preview\n */\nexport function synapseVite(options: SynapseVitePluginOptions = {}): Plugin {\n  const enablePreview = options.preview !== false;\n  let manifest: Manifest | null = null;\n  let appName = options.appName ?? \"app\";\n  let serverProcess: ChildProcess | null = null;\n  const pendingRequests = new Map<\n    string,\n    { resolve: (v: unknown) => void; reject: (e: Error) => void }\n  >();\n  let serverBuffer = \"\";\n\n  function loadManifest(root: string): Manifest | null {\n    const manifestPath = options.manifest\n      ? resolve(options.manifest)\n      : resolve(root, \"..\", \"manifest.json\");\n\n    if (!existsSync(manifestPath)) return null;\n    try {\n      return JSON.parse(readFileSync(manifestPath, \"utf-8\"));\n    } catch {\n      return null;\n    }\n  }\n\n  function deriveServerCmd(m: Manifest, root: string): string | null {\n    if (options.serverCmd) return options.serverCmd;\n    const cfg = m.server?.mcp_config;\n    if (!cfg?.command) return null;\n\n    const serverDir = resolve(root, \"..\");\n    let cmd = cfg.command;\n    const args = cfg.args ?? [];\n\n    // Python projects: use `uv run` if pyproject.toml exists\n    if (cmd === \"python\" && existsSync(join(serverDir, \"pyproject.toml\"))) {\n      cmd = \"uv run python\";\n    }\n\n    return `cd ${JSON.stringify(serverDir)} && ${cmd} ${args.join(\" \")}`;\n  }\n\n  function startServer(cmd: string): void {\n    serverProcess = spawn(cmd, {\n      shell: true,\n      stdio: [\"pipe\", \"pipe\", \"pipe\"],\n    });\n\n    serverProcess.stderr?.on(\"data\", (d: Buffer) => {\n      process.stderr.write(`  [mcp] ${d}`);\n    });\n\n    serverProcess.stdout?.on(\"data\", (d: Buffer) => {\n      serverBuffer += d.toString();\n      // Parse line-delimited JSON-RPC responses\n      const lines = serverBuffer.split(\"\\n\");\n      serverBuffer = lines.pop() ?? \"\"; // keep incomplete line\n      for (const line of lines) {\n        if (!line.trim()) continue;\n        try {\n          const msg = JSON.parse(line);\n          if (msg.id && pendingRequests.has(msg.id)) {\n            const p = pendingRequests.get(msg.id);\n            pendingRequests.delete(msg.id);\n            p?.resolve(msg);\n          }\n        } catch {\n          // Not JSON — log it\n          process.stderr.write(`  [mcp] ${line}\\n`);\n        }\n      }\n    });\n\n    serverProcess.on(\"exit\", (code) => {\n      if (code !== null && code !== 0) {\n        console.error(`  [mcp] Server exited with code ${code}`);\n      }\n      serverProcess = null;\n    });\n\n    // Send initialize\n    sendToServer({\n      jsonrpc: \"2.0\",\n      id: \"init-1\",\n      method: \"initialize\",\n      params: {\n        protocolVersion: \"2024-11-05\",\n        capabilities: {},\n        clientInfo: { name: \"synapse-preview\", version: \"0.1.0\" },\n      },\n    });\n  }\n\n  function sendToServer(msg: Record<string, unknown>): void {\n    if (!serverProcess?.stdin?.writable) return;\n    serverProcess.stdin.write(`${JSON.stringify(msg)}\\n`);\n  }\n\n  function callServerTool(name: string, args: Record<string, unknown>): Promise<unknown> {\n    return new Promise((resolve, reject) => {\n      const id = `preview-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;\n      pendingRequests.set(id, { resolve, reject });\n      sendToServer({\n        jsonrpc: \"2.0\",\n        id,\n        method: \"tools/call\",\n        params: { name, arguments: args },\n      });\n      setTimeout(() => {\n        if (pendingRequests.has(id)) {\n          pendingRequests.delete(id);\n          reject(new Error(\"Tool call timed out (10s)\"));\n        }\n      }, 10000);\n    });\n  }\n\n  return {\n    name: \"synapse\",\n\n    config() {\n      return {\n        define: {\n          \"import.meta.env.SYNAPSE_APP_NAME\": JSON.stringify(appName),\n        },\n        server: {\n          hmr: {\n            protocol: \"ws\",\n            host: \"localhost\",\n          },\n        },\n      };\n    },\n\n    configResolved(config) {\n      manifest = loadManifest(config.root);\n      if (manifest?.name) {\n        appName = options.appName ?? manifest.name;\n      }\n    },\n\n    configureServer(server: ViteDevServer) {\n      // Start MCP server\n      if (enablePreview && manifest) {\n        const cmd = deriveServerCmd(manifest, server.config.root);\n        if (cmd) {\n          console.log(`\\n  [synapse] Starting MCP server: ${cmd}\\n`);\n          startServer(cmd);\n        }\n      }\n\n      server.middlewares.use((req, res, next) => {\n        // CORS for iframe communication\n        res.setHeader(\"Access-Control-Allow-Origin\", \"*\");\n        res.setHeader(\"Access-Control-Allow-Methods\", \"*\");\n        res.setHeader(\"Access-Control-Allow-Headers\", \"*\");\n\n        // /__preview — bridge host page\n        if (req.url === \"/__preview\" || req.url === \"/__preview/\") {\n          res.writeHead(200, { \"Content-Type\": \"text/html\" });\n          res.end(previewHostHtml(appName));\n          return;\n        }\n\n        // POST /__mcp — tool call proxy\n        if (req.method === \"POST\" && req.url === \"/__mcp\") {\n          let body = \"\";\n          req.on(\"data\", (chunk: Buffer) => {\n            body += chunk.toString();\n          });\n          req.on(\"end\", async () => {\n            try {\n              const msg = JSON.parse(body);\n              const result = await callServerTool(msg.params.name, msg.params.arguments || {});\n              res.writeHead(200, { \"Content-Type\": \"application/json\" });\n              res.end(JSON.stringify(result));\n            } catch (err) {\n              res.writeHead(200, { \"Content-Type\": \"application/json\" });\n              res.end(\n                JSON.stringify({\n                  jsonrpc: \"2.0\",\n                  id: JSON.parse(body).id,\n                  error: { code: -32000, message: (err as Error).message },\n                }),\n              );\n            }\n          });\n          return;\n        }\n\n        next();\n      });\n    },\n\n    buildEnd() {\n      // Kill server on build end (for production builds)\n      if (serverProcess) {\n        serverProcess.kill(\"SIGTERM\");\n        serverProcess = null;\n      }\n    },\n  };\n}\n\nfunction previewHostHtml(appName: string): string {\n  return `<!DOCTYPE html>\n<html>\n<head>\n  <meta charset=\"utf-8\" />\n  <title>${appName} — Synapse Preview</title>\n  <style>\n    * { margin: 0; padding: 0; box-sizing: border-box; }\n    body { font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif; background: #0f172a; color: #e2e8f0; }\n    header { padding: 10px 16px; background: #1e293b; border-bottom: 1px solid #334155; display: flex; align-items: center; gap: 10px; font-size: 13px; }\n    header .dot { width: 8px; height: 8px; border-radius: 50%; background: #22c55e; }\n    header .name { font-weight: 600; }\n    header .spacer { flex: 1; }\n    header button { background: #334155; border: none; color: #e2e8f0; padding: 3px 8px; border-radius: 4px; cursor: pointer; font-size: 12px; }\n    header .url { color: #64748b; font-size: 11px; font-family: monospace; }\n    iframe { width: 100%; height: calc(100vh - 41px); border: none; }\n  </style>\n</head>\n<body>\n  <header>\n    <span class=\"dot\"></span>\n    <span class=\"name\">${appName}</span>\n    <span class=\"spacer\"></span>\n    <button id=\"toggle\">Toggle Theme</button>\n    <span class=\"url\">Synapse Preview</span>\n  </header>\n  <iframe id=\"app\" src=\"/\"></iframe>\n\n  <script>\n    var iframe = document.getElementById(\"app\");\n    var dark = true;\n\n    function getTokens(d) {\n      return d ? {\n        \"--nb-background\":\"#0f172a\",\"--nb-foreground\":\"#e2e8f0\",\n        \"--nb-card\":\"#1e293b\",\"--nb-card-foreground\":\"#e2e8f0\",\n        \"--nb-primary\":\"#6366f1\",\"--nb-primary-foreground\":\"#fff\",\n        \"--nb-muted-foreground\":\"#94a3b8\",\"--nb-border\":\"#334155\",\n        \"--nb-ring\":\"#6366f1\",\"--nb-destructive\":\"#ef4444\",\n        \"--nb-radius\":\"0.5rem\",\"--nb-font-sans\":\"-apple-system,BlinkMacSystemFont,sans-serif\"\n      } : {\n        \"--nb-background\":\"#ffffff\",\"--nb-foreground\":\"#0f172a\",\n        \"--nb-card\":\"#f8fafc\",\"--nb-card-foreground\":\"#0f172a\",\n        \"--nb-primary\":\"#6366f1\",\"--nb-primary-foreground\":\"#fff\",\n        \"--nb-muted-foreground\":\"#64748b\",\"--nb-border\":\"#e2e8f0\",\n        \"--nb-ring\":\"#6366f1\",\"--nb-destructive\":\"#ef4444\",\n        \"--nb-radius\":\"0.5rem\",\"--nb-font-sans\":\"-apple-system,BlinkMacSystemFont,sans-serif\"\n      };\n    }\n\n    function post(msg) { iframe.contentWindow.postMessage(msg, \"*\"); }\n\n    window.addEventListener(\"message\", async function(e) {\n      if (e.source !== iframe.contentWindow) return;\n      var msg = e.data;\n      if (!msg || typeof msg !== \"object\") return;\n\n      // ext-apps handshake\n      if (msg.method === \"ui/initialize\" && msg.id) {\n        post({ jsonrpc:\"2.0\", id:msg.id, result: {\n          protocolVersion:\"2026-01-26\",\n          serverInfo:{name:\"nimblebrain\",version:\"preview\"},\n          capabilities:{openLinks:{},serverTools:{}},\n          hostContext:{theme:dark?\"dark\":\"light\",primaryColor:\"#6366f1\",tokens:getTokens(dark)}\n        }});\n        return;\n      }\n      if (msg.method === \"ui/notifications/initialized\") return;\n\n      // Tool calls — proxy via Vite middleware\n      if (msg.method === \"tools/call\" && msg.id) {\n        var originalId = msg.id;\n        try {\n          var r = await fetch(\"/__mcp\", {\n            method:\"POST\", headers:{\"Content-Type\":\"application/json\"},\n            body: JSON.stringify({jsonrpc:\"2.0\",id:msg.id,method:\"tools/call\",params:{name:msg.params.name,arguments:msg.params.arguments||{}}})\n          });\n          var response = await r.json();\n          response.id = originalId;\n          post(response);\n        } catch(err) {\n          post({jsonrpc:\"2.0\",id:originalId,error:{code:-32000,message:err.message}});\n        }\n        return;\n      }\n\n      // Log other messages\n      if (msg.method === \"ui/chat\") console.log(\"[chat]\", msg.params?.message);\n      else if (msg.method === \"ui/action\") console.log(\"[action]\", msg.params?.action, msg.params);\n      else if (msg.method === \"ui/stateChanged\") { console.log(\"[state]\", msg.params?.state); post({jsonrpc:\"2.0\",method:\"ui/stateAcknowledged\",params:{truncated:false}}); }\n      else if (msg.method === \"ui/keydown\") { /* ignore */ }\n      else if (msg.method) console.log(\"[bridge]\", msg.method, msg);\n    });\n\n    document.getElementById(\"toggle\").onclick = function() {\n      dark = !dark;\n      document.body.style.background = dark ? \"#0f172a\" : \"#f1f5f9\";\n      post({jsonrpc:\"2.0\",method:\"ui/themeChanged\",params:{mode:dark?\"dark\":\"light\",tokens:getTokens(dark)}});\n    };\n  </script>\n</body>\n</html>`;\n}\n"]}
+{"version":3,"sources":["../../src/vite/plugin.ts"],"names":["resolve","existsSync","readFileSync","join","spawn"],"mappings":"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","file":"index.cjs","sourcesContent":["import { type ChildProcess, spawn } from \"node:child_process\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport type { Plugin, ViteDevServer } from \"vite\";\n\nexport interface SynapseVitePluginOptions {\n  /** App name. If omitted, reads from ../manifest.json */\n  appName?: string;\n  /** Path to manifest.json. Default: ../manifest.json (relative to ui/) */\n  manifest?: string;\n  /**\n   * Shell command to start the MCP server. If omitted, derived from manifest.\n   * The server runs in stdio mode — stdin/stdout JSON-RPC.\n   */\n  serverCmd?: string;\n  /** Set to false to disable the preview host page at /__preview */\n  preview?: boolean;\n}\n\ninterface Manifest {\n  name: string;\n  version?: string;\n  server?: {\n    type?: string;\n    entry_point?: string;\n    mcp_config?: {\n      command?: string;\n      args?: string[];\n    };\n  };\n}\n\n/**\n * Synapse Vite plugin — full local dev experience for MCP apps.\n *\n * What it does:\n * - Reads ../manifest.json to get app name and server config\n * - Spawns the MCP server as a child process (stdio mode)\n * - Serves a preview host page at /__preview that iframes your app\n * - Proxies tool calls from the iframe through POST /__mcp to the server\n * - Handles the ext-apps handshake so Synapse hooks work\n * - HMR works inside the iframe — edit .tsx, see changes instantly\n *\n * Usage in vite.config.ts:\n *   import { synapseVite } from \"@nimblebrain/synapse/vite\";\n *   export default { plugins: [react(), viteSingleFile(), synapseVite()] };\n *\n * Then: cd ui && npm run dev && open http://localhost:5173/__preview\n */\nexport function synapseVite(options: SynapseVitePluginOptions = {}): Plugin {\n  const enablePreview = options.preview !== false;\n  let manifest: Manifest | null = null;\n  let appName = options.appName ?? \"app\";\n  let serverProcess: ChildProcess | null = null;\n  const pendingRequests = new Map<\n    string,\n    { resolve: (v: unknown) => void; reject: (e: Error) => void }\n  >();\n  let serverBuffer = \"\";\n\n  function loadManifest(root: string): Manifest | null {\n    const manifestPath = options.manifest\n      ? resolve(options.manifest)\n      : resolve(root, \"..\", \"manifest.json\");\n\n    if (!existsSync(manifestPath)) return null;\n    try {\n      return JSON.parse(readFileSync(manifestPath, \"utf-8\"));\n    } catch {\n      return null;\n    }\n  }\n\n  function deriveServerCmd(m: Manifest, root: string): string | null {\n    if (options.serverCmd) return options.serverCmd;\n    const cfg = m.server?.mcp_config;\n    if (!cfg?.command) return null;\n\n    const serverDir = resolve(root, \"..\");\n    let cmd = cfg.command;\n    const args = cfg.args ?? [];\n\n    // Python projects: use `uv run` if pyproject.toml exists\n    if (cmd === \"python\" && existsSync(join(serverDir, \"pyproject.toml\"))) {\n      cmd = \"uv run python\";\n    }\n\n    return `cd ${JSON.stringify(serverDir)} && ${cmd} ${args.join(\" \")}`;\n  }\n\n  function startServer(cmd: string): void {\n    serverProcess = spawn(cmd, {\n      shell: true,\n      stdio: [\"pipe\", \"pipe\", \"pipe\"],\n    });\n\n    serverProcess.stderr?.on(\"data\", (d: Buffer) => {\n      process.stderr.write(`  [mcp] ${d}`);\n    });\n\n    serverProcess.stdout?.on(\"data\", (d: Buffer) => {\n      serverBuffer += d.toString();\n      // Parse line-delimited JSON-RPC responses\n      const lines = serverBuffer.split(\"\\n\");\n      serverBuffer = lines.pop() ?? \"\"; // keep incomplete line\n      for (const line of lines) {\n        if (!line.trim()) continue;\n        try {\n          const msg = JSON.parse(line);\n          if (msg.id && pendingRequests.has(msg.id)) {\n            const p = pendingRequests.get(msg.id);\n            pendingRequests.delete(msg.id);\n            p?.resolve(msg);\n          }\n        } catch {\n          // Not JSON — log it\n          process.stderr.write(`  [mcp] ${line}\\n`);\n        }\n      }\n    });\n\n    serverProcess.on(\"exit\", (code) => {\n      if (code !== null && code !== 0) {\n        console.error(`  [mcp] Server exited with code ${code}`);\n      }\n      serverProcess = null;\n    });\n\n    // Send initialize\n    sendToServer({\n      jsonrpc: \"2.0\",\n      id: \"init-1\",\n      method: \"initialize\",\n      params: {\n        protocolVersion: \"2024-11-05\",\n        capabilities: {},\n        clientInfo: { name: \"synapse-preview\", version: \"0.1.0\" },\n      },\n    });\n  }\n\n  function sendToServer(msg: Record<string, unknown>): void {\n    if (!serverProcess?.stdin?.writable) return;\n    serverProcess.stdin.write(`${JSON.stringify(msg)}\\n`);\n  }\n\n  function callServerTool(name: string, args: Record<string, unknown>): Promise<unknown> {\n    return new Promise((resolve, reject) => {\n      const id = `preview-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;\n      pendingRequests.set(id, { resolve, reject });\n      sendToServer({\n        jsonrpc: \"2.0\",\n        id,\n        method: \"tools/call\",\n        params: { name, arguments: args },\n      });\n      setTimeout(() => {\n        if (pendingRequests.has(id)) {\n          pendingRequests.delete(id);\n          reject(new Error(\"Tool call timed out (10s)\"));\n        }\n      }, 10000);\n    });\n  }\n\n  return {\n    name: \"synapse\",\n\n    config() {\n      return {\n        define: {\n          \"import.meta.env.SYNAPSE_APP_NAME\": JSON.stringify(appName),\n        },\n        server: {\n          hmr: {\n            protocol: \"ws\",\n            host: \"localhost\",\n          },\n        },\n      };\n    },\n\n    configResolved(config) {\n      manifest = loadManifest(config.root);\n      if (manifest?.name) {\n        appName = options.appName ?? manifest.name;\n      }\n    },\n\n    configureServer(server: ViteDevServer) {\n      // Start MCP server\n      if (enablePreview && manifest) {\n        const cmd = deriveServerCmd(manifest, server.config.root);\n        if (cmd) {\n          console.log(`\\n  [synapse] Starting MCP server: ${cmd}\\n`);\n          startServer(cmd);\n        }\n      }\n\n      server.middlewares.use((req, res, next) => {\n        // CORS for iframe communication\n        res.setHeader(\"Access-Control-Allow-Origin\", \"*\");\n        res.setHeader(\"Access-Control-Allow-Methods\", \"*\");\n        res.setHeader(\"Access-Control-Allow-Headers\", \"*\");\n\n        // /__preview — bridge host page\n        if (req.url === \"/__preview\" || req.url === \"/__preview/\") {\n          res.writeHead(200, { \"Content-Type\": \"text/html\" });\n          res.end(previewHostHtml(appName));\n          return;\n        }\n\n        // POST /__mcp — tool call proxy\n        if (req.method === \"POST\" && req.url === \"/__mcp\") {\n          let body = \"\";\n          req.on(\"data\", (chunk: Buffer) => {\n            body += chunk.toString();\n          });\n          req.on(\"end\", async () => {\n            try {\n              const msg = JSON.parse(body);\n              const result = await callServerTool(msg.params.name, msg.params.arguments || {});\n              res.writeHead(200, { \"Content-Type\": \"application/json\" });\n              res.end(JSON.stringify(result));\n            } catch (err) {\n              res.writeHead(200, { \"Content-Type\": \"application/json\" });\n              res.end(\n                JSON.stringify({\n                  jsonrpc: \"2.0\",\n                  id: JSON.parse(body).id,\n                  error: { code: -32000, message: (err as Error).message },\n                }),\n              );\n            }\n          });\n          return;\n        }\n\n        next();\n      });\n    },\n\n    buildEnd() {\n      // Kill server on build end (for production builds)\n      if (serverProcess) {\n        serverProcess.kill(\"SIGTERM\");\n        serverProcess = null;\n      }\n    },\n  };\n}\n\nfunction previewHostHtml(appName: string): string {\n  return `<!DOCTYPE html>\n<html>\n<head>\n  <meta charset=\"utf-8\" />\n  <title>${appName} — Synapse Preview</title>\n  <style>\n    * { margin: 0; padding: 0; box-sizing: border-box; }\n    body { font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif; background: #0f172a; color: #e2e8f0; }\n    header { padding: 10px 16px; background: #1e293b; border-bottom: 1px solid #334155; display: flex; align-items: center; gap: 10px; font-size: 13px; }\n    header .dot { width: 8px; height: 8px; border-radius: 50%; background: #22c55e; }\n    header .name { font-weight: 600; }\n    header .spacer { flex: 1; }\n    header button { background: #334155; border: none; color: #e2e8f0; padding: 3px 8px; border-radius: 4px; cursor: pointer; font-size: 12px; }\n    header .url { color: #64748b; font-size: 11px; font-family: monospace; }\n    iframe { width: 100%; height: calc(100vh - 41px); border: none; }\n  </style>\n</head>\n<body>\n  <header>\n    <span class=\"dot\"></span>\n    <span class=\"name\">${appName}</span>\n    <span class=\"spacer\"></span>\n    <button id=\"toggle\">Toggle Theme</button>\n    <span class=\"url\">Synapse Preview</span>\n  </header>\n  <iframe id=\"app\"></iframe>\n\n  <script>\n    var iframe = document.getElementById(\"app\");\n    var dark = true;\n\n    function getTokens(d) {\n      return d ? {\n        \"--color-background-primary\":\"#0f172a\",\"--color-text-primary\":\"#e2e8f0\",\n        \"--color-background-secondary\":\"#1e293b\",\"--color-text-primary\":\"#e2e8f0\",\n        \"--color-text-accent\":\"#6366f1\",\"--nb-color-accent-foreground\":\"#fff\",\n        \"--color-text-secondary\":\"#94a3b8\",\"--color-border-primary\":\"#334155\",\n        \"--color-ring-primary\":\"#6366f1\",\"--nb-color-danger\":\"#ef4444\",\n        \"--border-radius-sm\":\"0.5rem\",\"--font-sans\":\"-apple-system,BlinkMacSystemFont,sans-serif\"\n      } : {\n        \"--color-background-primary\":\"#ffffff\",\"--color-text-primary\":\"#0f172a\",\n        \"--color-background-secondary\":\"#f8fafc\",\"--color-text-primary\":\"#0f172a\",\n        \"--color-text-accent\":\"#6366f1\",\"--nb-color-accent-foreground\":\"#fff\",\n        \"--color-text-secondary\":\"#64748b\",\"--color-border-primary\":\"#e2e8f0\",\n        \"--color-ring-primary\":\"#6366f1\",\"--nb-color-danger\":\"#ef4444\",\n        \"--border-radius-sm\":\"0.5rem\",\"--font-sans\":\"-apple-system,BlinkMacSystemFont,sans-serif\"\n      };\n    }\n\n    function post(msg) { iframe.contentWindow.postMessage(msg, \"*\"); }\n\n    window.addEventListener(\"message\", async function(e) {\n      if (e.source !== iframe.contentWindow) return;\n      var msg = e.data;\n      if (!msg || typeof msg !== \"object\") return;\n\n      // ext-apps handshake\n      if (msg.method === \"ui/initialize\" && msg.id) {\n        post({ jsonrpc:\"2.0\", id:msg.id, result: {\n          protocolVersion:\"2026-01-26\",\n          serverInfo:{name:\"nimblebrain\",version:\"preview\"},\n          capabilities:{openLinks:{},serverTools:{}},\n          hostContext:{theme:dark?\"dark\":\"light\",primaryColor:\"#6366f1\",tokens:getTokens(dark)}\n        }});\n        return;\n      }\n      if (msg.method === \"ui/notifications/initialized\") return;\n\n      // Tool calls — proxy via Vite middleware\n      if (msg.method === \"tools/call\" && msg.id) {\n        var originalId = msg.id;\n        try {\n          var r = await fetch(\"/__mcp\", {\n            method:\"POST\", headers:{\"Content-Type\":\"application/json\"},\n            body: JSON.stringify({jsonrpc:\"2.0\",id:msg.id,method:\"tools/call\",params:{name:msg.params.name,arguments:msg.params.arguments||{}}})\n          });\n          var response = await r.json();\n          response.id = originalId;\n          post(response);\n          // Notify the app that data changed so hooks auto-refresh\n          // Only for mutating operations (not list/search/get which are read-only)\n          var tn = msg.params.name || \"\";\n          if (!response.error && !tn.startsWith(\"list_\") && !tn.startsWith(\"search_\") && !tn.startsWith(\"get_\") && !tn.startsWith(\"query_\")) {\n            post({jsonrpc:\"2.0\",method:\"ui/datachanged\",params:{tool:tn,server:\"preview\"}});\n          }\n        } catch(err) {\n          post({jsonrpc:\"2.0\",id:originalId,error:{code:-32000,message:err.message}});\n        }\n        return;\n      }\n\n      // Log other messages\n      if (msg.method === \"ui/chat\") console.log(\"[chat]\", msg.params?.message);\n      else if (msg.method === \"ui/action\") console.log(\"[action]\", msg.params?.action, msg.params);\n      else if (msg.method === \"ui/stateChanged\") { console.log(\"[state]\", msg.params?.state); post({jsonrpc:\"2.0\",method:\"ui/stateAcknowledged\",params:{truncated:false}}); }\n      else if (msg.method === \"ui/keydown\") { /* ignore */ }\n      else if (msg.method) console.log(\"[bridge]\", msg.method, msg);\n    });\n\n    document.getElementById(\"toggle\").onclick = function() {\n      dark = !dark;\n      document.body.style.background = dark ? \"#0f172a\" : \"#f1f5f9\";\n      post({jsonrpc:\"2.0\",method:\"ui/themeChanged\",params:{mode:dark?\"dark\":\"light\",tokens:getTokens(dark)}});\n    };\n\n    // Load the iframe AFTER the message listener is attached to avoid\n    // a race where the app sends ui/initialize before the bridge is ready.\n    iframe.src = \"/\";\n  </script>\n</body>\n</html>`;\n}\n"]}

dist/vite/index.js

@@ -202,3 +202,3 @@ import { spawn } from 'child_process';
   </header>
-  <iframe id="app" src="/"></iframe>
+  <iframe id="app"></iframe>
 
@@ -211,15 +211,15 @@ <script>
       return d ? {
-        "--nb-background":"#0f172a","--nb-foreground":"#e2e8f0",
-        "--nb-card":"#1e293b","--nb-card-foreground":"#e2e8f0",
-        "--nb-primary":"#6366f1","--nb-primary-foreground":"#fff",
-        "--nb-muted-foreground":"#94a3b8","--nb-border":"#334155",
-        "--nb-ring":"#6366f1","--nb-destructive":"#ef4444",
-        "--nb-radius":"0.5rem","--nb-font-sans":"-apple-system,BlinkMacSystemFont,sans-serif"
+        "--color-background-primary":"#0f172a","--color-text-primary":"#e2e8f0",
+        "--color-background-secondary":"#1e293b","--color-text-primary":"#e2e8f0",
+        "--color-text-accent":"#6366f1","--nb-color-accent-foreground":"#fff",
+        "--color-text-secondary":"#94a3b8","--color-border-primary":"#334155",
+        "--color-ring-primary":"#6366f1","--nb-color-danger":"#ef4444",
+        "--border-radius-sm":"0.5rem","--font-sans":"-apple-system,BlinkMacSystemFont,sans-serif"
       } : {
-        "--nb-background":"#ffffff","--nb-foreground":"#0f172a",
-        "--nb-card":"#f8fafc","--nb-card-foreground":"#0f172a",
-        "--nb-primary":"#6366f1","--nb-primary-foreground":"#fff",
-        "--nb-muted-foreground":"#64748b","--nb-border":"#e2e8f0",
-        "--nb-ring":"#6366f1","--nb-destructive":"#ef4444",
-        "--nb-radius":"0.5rem","--nb-font-sans":"-apple-system,BlinkMacSystemFont,sans-serif"
+        "--color-background-primary":"#ffffff","--color-text-primary":"#0f172a",
+        "--color-background-secondary":"#f8fafc","--color-text-primary":"#0f172a",
+        "--color-text-accent":"#6366f1","--nb-color-accent-foreground":"#fff",
+        "--color-text-secondary":"#64748b","--color-border-primary":"#e2e8f0",
+        "--color-ring-primary":"#6366f1","--nb-color-danger":"#ef4444",
+        "--border-radius-sm":"0.5rem","--font-sans":"-apple-system,BlinkMacSystemFont,sans-serif"
       };
@@ -258,2 +258,8 @@ }
           post(response);
+          // Notify the app that data changed so hooks auto-refresh
+          // Only for mutating operations (not list/search/get which are read-only)
+          var tn = msg.params.name || "";
+          if (!response.error && !tn.startsWith("list_") && !tn.startsWith("search_") && !tn.startsWith("get_") && !tn.startsWith("query_")) {
+            post({jsonrpc:"2.0",method:"ui/datachanged",params:{tool:tn,server:"preview"}});
+          }
         } catch(err) {
@@ -278,2 +284,6 @@ post({jsonrpc:"2.0",id:originalId,error:{code:-32000,message:err.message}});
     };
+
+    // Load the iframe AFTER the message listener is attached to avoid
+    // a race where the app sends ui/initialize before the bridge is ready.
+    iframe.src = "/";
   </script>
@@ -280,0 +290,0 @@ </body>

dist/vite/index.js.map

@@ -1,1 +0,1 @@
-{"version":3,"sources":["../../src/vite/plugin.ts"],"names":["resolve"],"mappings":"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","file":"index.js","sourcesContent":["import { type ChildProcess, spawn } from \"node:child_process\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport type { Plugin, ViteDevServer } from \"vite\";\n\nexport interface SynapseVitePluginOptions {\n  /** App name. If omitted, reads from ../manifest.json */\n  appName?: string;\n  /** Path to manifest.json. Default: ../manifest.json (relative to ui/) */\n  manifest?: string;\n  /**\n   * Shell command to start the MCP server. If omitted, derived from manifest.\n   * The server runs in stdio mode — stdin/stdout JSON-RPC.\n   */\n  serverCmd?: string;\n  /** Set to false to disable the preview host page at /__preview */\n  preview?: boolean;\n}\n\ninterface Manifest {\n  name: string;\n  version?: string;\n  server?: {\n    type?: string;\n    entry_point?: string;\n    mcp_config?: {\n      command?: string;\n      args?: string[];\n    };\n  };\n}\n\n/**\n * Synapse Vite plugin — full local dev experience for MCP apps.\n *\n * What it does:\n * - Reads ../manifest.json to get app name and server config\n * - Spawns the MCP server as a child process (stdio mode)\n * - Serves a preview host page at /__preview that iframes your app\n * - Proxies tool calls from the iframe through POST /__mcp to the server\n * - Handles the ext-apps handshake so Synapse hooks work\n * - HMR works inside the iframe — edit .tsx, see changes instantly\n *\n * Usage in vite.config.ts:\n *   import { synapseVite } from \"@nimblebrain/synapse/vite\";\n *   export default { plugins: [react(), viteSingleFile(), synapseVite()] };\n *\n * Then: cd ui && npm run dev && open http://localhost:5173/__preview\n */\nexport function synapseVite(options: SynapseVitePluginOptions = {}): Plugin {\n  const enablePreview = options.preview !== false;\n  let manifest: Manifest | null = null;\n  let appName = options.appName ?? \"app\";\n  let serverProcess: ChildProcess | null = null;\n  const pendingRequests = new Map<\n    string,\n    { resolve: (v: unknown) => void; reject: (e: Error) => void }\n  >();\n  let serverBuffer = \"\";\n\n  function loadManifest(root: string): Manifest | null {\n    const manifestPath = options.manifest\n      ? resolve(options.manifest)\n      : resolve(root, \"..\", \"manifest.json\");\n\n    if (!existsSync(manifestPath)) return null;\n    try {\n      return JSON.parse(readFileSync(manifestPath, \"utf-8\"));\n    } catch {\n      return null;\n    }\n  }\n\n  function deriveServerCmd(m: Manifest, root: string): string | null {\n    if (options.serverCmd) return options.serverCmd;\n    const cfg = m.server?.mcp_config;\n    if (!cfg?.command) return null;\n\n    const serverDir = resolve(root, \"..\");\n    let cmd = cfg.command;\n    const args = cfg.args ?? [];\n\n    // Python projects: use `uv run` if pyproject.toml exists\n    if (cmd === \"python\" && existsSync(join(serverDir, \"pyproject.toml\"))) {\n      cmd = \"uv run python\";\n    }\n\n    return `cd ${JSON.stringify(serverDir)} && ${cmd} ${args.join(\" \")}`;\n  }\n\n  function startServer(cmd: string): void {\n    serverProcess = spawn(cmd, {\n      shell: true,\n      stdio: [\"pipe\", \"pipe\", \"pipe\"],\n    });\n\n    serverProcess.stderr?.on(\"data\", (d: Buffer) => {\n      process.stderr.write(`  [mcp] ${d}`);\n    });\n\n    serverProcess.stdout?.on(\"data\", (d: Buffer) => {\n      serverBuffer += d.toString();\n      // Parse line-delimited JSON-RPC responses\n      const lines = serverBuffer.split(\"\\n\");\n      serverBuffer = lines.pop() ?? \"\"; // keep incomplete line\n      for (const line of lines) {\n        if (!line.trim()) continue;\n        try {\n          const msg = JSON.parse(line);\n          if (msg.id && pendingRequests.has(msg.id)) {\n            const p = pendingRequests.get(msg.id);\n            pendingRequests.delete(msg.id);\n            p?.resolve(msg);\n          }\n        } catch {\n          // Not JSON — log it\n          process.stderr.write(`  [mcp] ${line}\\n`);\n        }\n      }\n    });\n\n    serverProcess.on(\"exit\", (code) => {\n      if (code !== null && code !== 0) {\n        console.error(`  [mcp] Server exited with code ${code}`);\n      }\n      serverProcess = null;\n    });\n\n    // Send initialize\n    sendToServer({\n      jsonrpc: \"2.0\",\n      id: \"init-1\",\n      method: \"initialize\",\n      params: {\n        protocolVersion: \"2024-11-05\",\n        capabilities: {},\n        clientInfo: { name: \"synapse-preview\", version: \"0.1.0\" },\n      },\n    });\n  }\n\n  function sendToServer(msg: Record<string, unknown>): void {\n    if (!serverProcess?.stdin?.writable) return;\n    serverProcess.stdin.write(`${JSON.stringify(msg)}\\n`);\n  }\n\n  function callServerTool(name: string, args: Record<string, unknown>): Promise<unknown> {\n    return new Promise((resolve, reject) => {\n      const id = `preview-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;\n      pendingRequests.set(id, { resolve, reject });\n      sendToServer({\n        jsonrpc: \"2.0\",\n        id,\n        method: \"tools/call\",\n        params: { name, arguments: args },\n      });\n      setTimeout(() => {\n        if (pendingRequests.has(id)) {\n          pendingRequests.delete(id);\n          reject(new Error(\"Tool call timed out (10s)\"));\n        }\n      }, 10000);\n    });\n  }\n\n  return {\n    name: \"synapse\",\n\n    config() {\n      return {\n        define: {\n          \"import.meta.env.SYNAPSE_APP_NAME\": JSON.stringify(appName),\n        },\n        server: {\n          hmr: {\n            protocol: \"ws\",\n            host: \"localhost\",\n          },\n        },\n      };\n    },\n\n    configResolved(config) {\n      manifest = loadManifest(config.root);\n      if (manifest?.name) {\n        appName = options.appName ?? manifest.name;\n      }\n    },\n\n    configureServer(server: ViteDevServer) {\n      // Start MCP server\n      if (enablePreview && manifest) {\n        const cmd = deriveServerCmd(manifest, server.config.root);\n        if (cmd) {\n          console.log(`\\n  [synapse] Starting MCP server: ${cmd}\\n`);\n          startServer(cmd);\n        }\n      }\n\n      server.middlewares.use((req, res, next) => {\n        // CORS for iframe communication\n        res.setHeader(\"Access-Control-Allow-Origin\", \"*\");\n        res.setHeader(\"Access-Control-Allow-Methods\", \"*\");\n        res.setHeader(\"Access-Control-Allow-Headers\", \"*\");\n\n        // /__preview — bridge host page\n        if (req.url === \"/__preview\" || req.url === \"/__preview/\") {\n          res.writeHead(200, { \"Content-Type\": \"text/html\" });\n          res.end(previewHostHtml(appName));\n          return;\n        }\n\n        // POST /__mcp — tool call proxy\n        if (req.method === \"POST\" && req.url === \"/__mcp\") {\n          let body = \"\";\n          req.on(\"data\", (chunk: Buffer) => {\n            body += chunk.toString();\n          });\n          req.on(\"end\", async () => {\n            try {\n              const msg = JSON.parse(body);\n              const result = await callServerTool(msg.params.name, msg.params.arguments || {});\n              res.writeHead(200, { \"Content-Type\": \"application/json\" });\n              res.end(JSON.stringify(result));\n            } catch (err) {\n              res.writeHead(200, { \"Content-Type\": \"application/json\" });\n              res.end(\n                JSON.stringify({\n                  jsonrpc: \"2.0\",\n                  id: JSON.parse(body).id,\n                  error: { code: -32000, message: (err as Error).message },\n                }),\n              );\n            }\n          });\n          return;\n        }\n\n        next();\n      });\n    },\n\n    buildEnd() {\n      // Kill server on build end (for production builds)\n      if (serverProcess) {\n        serverProcess.kill(\"SIGTERM\");\n        serverProcess = null;\n      }\n    },\n  };\n}\n\nfunction previewHostHtml(appName: string): string {\n  return `<!DOCTYPE html>\n<html>\n<head>\n  <meta charset=\"utf-8\" />\n  <title>${appName} — Synapse Preview</title>\n  <style>\n    * { margin: 0; padding: 0; box-sizing: border-box; }\n    body { font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif; background: #0f172a; color: #e2e8f0; }\n    header { padding: 10px 16px; background: #1e293b; border-bottom: 1px solid #334155; display: flex; align-items: center; gap: 10px; font-size: 13px; }\n    header .dot { width: 8px; height: 8px; border-radius: 50%; background: #22c55e; }\n    header .name { font-weight: 600; }\n    header .spacer { flex: 1; }\n    header button { background: #334155; border: none; color: #e2e8f0; padding: 3px 8px; border-radius: 4px; cursor: pointer; font-size: 12px; }\n    header .url { color: #64748b; font-size: 11px; font-family: monospace; }\n    iframe { width: 100%; height: calc(100vh - 41px); border: none; }\n  </style>\n</head>\n<body>\n  <header>\n    <span class=\"dot\"></span>\n    <span class=\"name\">${appName}</span>\n    <span class=\"spacer\"></span>\n    <button id=\"toggle\">Toggle Theme</button>\n    <span class=\"url\">Synapse Preview</span>\n  </header>\n  <iframe id=\"app\" src=\"/\"></iframe>\n\n  <script>\n    var iframe = document.getElementById(\"app\");\n    var dark = true;\n\n    function getTokens(d) {\n      return d ? {\n        \"--nb-background\":\"#0f172a\",\"--nb-foreground\":\"#e2e8f0\",\n        \"--nb-card\":\"#1e293b\",\"--nb-card-foreground\":\"#e2e8f0\",\n        \"--nb-primary\":\"#6366f1\",\"--nb-primary-foreground\":\"#fff\",\n        \"--nb-muted-foreground\":\"#94a3b8\",\"--nb-border\":\"#334155\",\n        \"--nb-ring\":\"#6366f1\",\"--nb-destructive\":\"#ef4444\",\n        \"--nb-radius\":\"0.5rem\",\"--nb-font-sans\":\"-apple-system,BlinkMacSystemFont,sans-serif\"\n      } : {\n        \"--nb-background\":\"#ffffff\",\"--nb-foreground\":\"#0f172a\",\n        \"--nb-card\":\"#f8fafc\",\"--nb-card-foreground\":\"#0f172a\",\n        \"--nb-primary\":\"#6366f1\",\"--nb-primary-foreground\":\"#fff\",\n        \"--nb-muted-foreground\":\"#64748b\",\"--nb-border\":\"#e2e8f0\",\n        \"--nb-ring\":\"#6366f1\",\"--nb-destructive\":\"#ef4444\",\n        \"--nb-radius\":\"0.5rem\",\"--nb-font-sans\":\"-apple-system,BlinkMacSystemFont,sans-serif\"\n      };\n    }\n\n    function post(msg) { iframe.contentWindow.postMessage(msg, \"*\"); }\n\n    window.addEventListener(\"message\", async function(e) {\n      if (e.source !== iframe.contentWindow) return;\n      var msg = e.data;\n      if (!msg || typeof msg !== \"object\") return;\n\n      // ext-apps handshake\n      if (msg.method === \"ui/initialize\" && msg.id) {\n        post({ jsonrpc:\"2.0\", id:msg.id, result: {\n          protocolVersion:\"2026-01-26\",\n          serverInfo:{name:\"nimblebrain\",version:\"preview\"},\n          capabilities:{openLinks:{},serverTools:{}},\n          hostContext:{theme:dark?\"dark\":\"light\",primaryColor:\"#6366f1\",tokens:getTokens(dark)}\n        }});\n        return;\n      }\n      if (msg.method === \"ui/notifications/initialized\") return;\n\n      // Tool calls — proxy via Vite middleware\n      if (msg.method === \"tools/call\" && msg.id) {\n        var originalId = msg.id;\n        try {\n          var r = await fetch(\"/__mcp\", {\n            method:\"POST\", headers:{\"Content-Type\":\"application/json\"},\n            body: JSON.stringify({jsonrpc:\"2.0\",id:msg.id,method:\"tools/call\",params:{name:msg.params.name,arguments:msg.params.arguments||{}}})\n          });\n          var response = await r.json();\n          response.id = originalId;\n          post(response);\n        } catch(err) {\n          post({jsonrpc:\"2.0\",id:originalId,error:{code:-32000,message:err.message}});\n        }\n        return;\n      }\n\n      // Log other messages\n      if (msg.method === \"ui/chat\") console.log(\"[chat]\", msg.params?.message);\n      else if (msg.method === \"ui/action\") console.log(\"[action]\", msg.params?.action, msg.params);\n      else if (msg.method === \"ui/stateChanged\") { console.log(\"[state]\", msg.params?.state); post({jsonrpc:\"2.0\",method:\"ui/stateAcknowledged\",params:{truncated:false}}); }\n      else if (msg.method === \"ui/keydown\") { /* ignore */ }\n      else if (msg.method) console.log(\"[bridge]\", msg.method, msg);\n    });\n\n    document.getElementById(\"toggle\").onclick = function() {\n      dark = !dark;\n      document.body.style.background = dark ? \"#0f172a\" : \"#f1f5f9\";\n      post({jsonrpc:\"2.0\",method:\"ui/themeChanged\",params:{mode:dark?\"dark\":\"light\",tokens:getTokens(dark)}});\n    };\n  </script>\n</body>\n</html>`;\n}\n"]}
+{"version":3,"sources":["../../src/vite/plugin.ts"],"names":["resolve"],"mappings":";;;;;AAiDO,SAAS,WAAA,CAAY,OAAA,GAAoC,EAAC,EAAW;AAC1E,EAAA,MAAM,aAAA,GAAgB,QAAQ,OAAA,KAAY,KAAA;AAC1C,EAAA,IAAI,QAAA,GAA4B,IAAA;AAChC,EAAA,IAAI,OAAA,GAAU,QAAQ,OAAA,IAAW,KAAA;AACjC,EAAA,IAAI,aAAA,GAAqC,IAAA;AACzC,EAAA,MAAM,eAAA,uBAAsB,GAAA,EAG1B;AACF,EAAA,IAAI,YAAA,GAAe,EAAA;AAEnB,EAAA,SAAS,aAAa,IAAA,EAA+B;AACnD,IAAA,MAAM,YAAA,GAAe,OAAA,CAAQ,QAAA,GACzB,OAAA,CAAQ,OAAA,CAAQ,QAAQ,CAAA,GACxB,OAAA,CAAQ,IAAA,EAAM,IAAA,EAAM,eAAe,CAAA;AAEvC,IAAA,IAAI,CAAC,UAAA,CAAW,YAAY,CAAA,EAAG,OAAO,IAAA;AACtC,IAAA,IAAI;AACF,MAAA,OAAO,IAAA,CAAK,KAAA,CAAM,YAAA,CAAa,YAAA,EAAc,OAAO,CAAC,CAAA;AAAA,IACvD,CAAA,CAAA,MAAQ;AACN,MAAA,OAAO,IAAA;AAAA,IACT;AAAA,EACF;AAEA,EAAA,SAAS,eAAA,CAAgB,GAAa,IAAA,EAA6B;AACjE,IAAA,IAAI,OAAA,CAAQ,SAAA,EAAW,OAAO,OAAA,CAAQ,SAAA;AACtC,IAAA,MAAM,GAAA,GAAM,EAAE,MAAA,EAAQ,UAAA;AACtB,IAAA,IAAI,CAAC,GAAA,EAAK,OAAA,EAAS,OAAO,IAAA;AAE1B,IAAA,MAAM,SAAA,GAAY,OAAA,CAAQ,IAAA,EAAM,IAAI,CAAA;AACpC,IAAA,IAAI,MAAM,GAAA,CAAI,OAAA;AACd,IAAA,MAAM,IAAA,GAAO,GAAA,CAAI,IAAA,IAAQ,EAAC;AAG1B,IAAA,IAAI,QAAQ,QAAA,IAAY,UAAA,CAAW,KAAK,SAAA,EAAW,gBAAgB,CAAC,CAAA,EAAG;AACrE,MAAA,GAAA,GAAM,eAAA;AAAA,IACR;AAEA,IAAA,OAAO,CAAA,GAAA,EAAM,IAAA,CAAK,SAAA,CAAU,SAAS,CAAC,CAAA,IAAA,EAAO,GAAG,CAAA,CAAA,EAAI,IAAA,CAAK,IAAA,CAAK,GAAG,CAAC,CAAA,CAAA;AAAA,EACpE;AAEA,EAAA,SAAS,YAAY,GAAA,EAAmB;AACtC,IAAA,aAAA,GAAgB,MAAM,GAAA,EAAK;AAAA,MACzB,KAAA,EAAO,IAAA;AAAA,MACP,KAAA,EAAO,CAAC,MAAA,EAAQ,MAAA,EAAQ,MAAM;AAAA,KAC/B,CAAA;AAED,IAAA,aAAA,CAAc,MAAA,EAAQ,EAAA,CAAG,MAAA,EAAQ,CAAC,CAAA,KAAc;AAC9C,MAAA,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,CAAA,QAAA,EAAW,CAAC,CAAA,CAAE,CAAA;AAAA,IACrC,CAAC,CAAA;AAED,IAAA,aAAA,CAAc,MAAA,EAAQ,EAAA,CAAG,MAAA,EAAQ,CAAC,CAAA,KAAc;AAC9C,MAAA,YAAA,IAAgB,EAAE,QAAA,EAAS;AAE3B,MAAA,MAAM,KAAA,GAAQ,YAAA,CAAa,KAAA,CAAM,IAAI,CAAA;AACrC,MAAA,YAAA,GAAe,KAAA,CAAM,KAAI,IAAK,EAAA;AAC9B,MAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,QAAA,IAAI,CAAC,IAAA,CAAK,IAAA,EAAK,EAAG;AAClB,QAAA,IAAI;AACF,UAAA,MAAM,GAAA,GAAM,IAAA,CAAK,KAAA,CAAM,IAAI,CAAA;AAC3B,UAAA,IAAI,IAAI,EAAA,IAAM,eAAA,CAAgB,GAAA,CAAI,GAAA,CAAI,EAAE,CAAA,EAAG;AACzC,YAAA,MAAM,CAAA,GAAI,eAAA,CAAgB,GAAA,CAAI,GAAA,CAAI,EAAE,CAAA;AACpC,YAAA,eAAA,CAAgB,MAAA,CAAO,IAAI,EAAE,CAAA;AAC7B,YAAA,CAAA,EAAG,QAAQ,GAAG,CAAA;AAAA,UAChB;AAAA,QACF,CAAA,CAAA,MAAQ;AAEN,UAAA,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,CAAA,QAAA,EAAW,IAAI;AAAA,CAAI,CAAA;AAAA,QAC1C;AAAA,MACF;AAAA,IACF,CAAC,CAAA;AAED,IAAA,aAAA,CAAc,EAAA,CAAG,MAAA,EAAQ,CAAC,IAAA,KAAS;AACjC,MAAA,IAAI,IAAA,KAAS,IAAA,IAAQ,IAAA,KAAS,CAAA,EAAG;AAC/B,QAAA,OAAA,CAAQ,KAAA,CAAM,CAAA,gCAAA,EAAmC,IAAI,CAAA,CAAE,CAAA;AAAA,MACzD;AACA,MAAA,aAAA,GAAgB,IAAA;AAAA,IAClB,CAAC,CAAA;AAGD,IAAA,YAAA,CAAa;AAAA,MACX,OAAA,EAAS,KAAA;AAAA,MACT,EAAA,EAAI,QAAA;AAAA,MACJ,MAAA,EAAQ,YAAA;AAAA,MACR,MAAA,EAAQ;AAAA,QACN,eAAA,EAAiB,YAAA;AAAA,QACjB,cAAc,EAAC;AAAA,QACf,UAAA,EAAY,EAAE,IAAA,EAAM,iBAAA,EAAmB,SAAS,OAAA;AAAQ;AAC1D,KACD,CAAA;AAAA,EACH;AAEA,EAAA,SAAS,aAAa,GAAA,EAAoC;AACxD,IAAA,IAAI,CAAC,aAAA,EAAe,KAAA,EAAO,QAAA,EAAU;AACrC,IAAA,aAAA,CAAc,MAAM,KAAA,CAAM,CAAA,EAAG,IAAA,CAAK,SAAA,CAAU,GAAG,CAAC;AAAA,CAAI,CAAA;AAAA,EACtD;AAEA,EAAA,SAAS,cAAA,CAAe,MAAc,IAAA,EAAiD;AACrF,IAAA,OAAO,IAAI,OAAA,CAAQ,CAACA,QAAAA,EAAS,MAAA,KAAW;AACtC,MAAA,MAAM,EAAA,GAAK,CAAA,QAAA,EAAW,IAAA,CAAK,GAAA,EAAK,CAAA,CAAA,EAAI,IAAA,CAAK,MAAA,EAAO,CAAE,SAAS,EAAE,CAAA,CAAE,KAAA,CAAM,CAAA,EAAG,CAAC,CAAC,CAAA,CAAA;AAC1E,MAAA,eAAA,CAAgB,IAAI,EAAA,EAAI,EAAE,OAAA,EAAAA,QAAAA,EAAS,QAAQ,CAAA;AAC3C,MAAA,YAAA,CAAa;AAAA,QACX,OAAA,EAAS,KAAA;AAAA,QACT,EAAA;AAAA,QACA,MAAA,EAAQ,YAAA;AAAA,QACR,MAAA,EAAQ,EAAE,IAAA,EAAM,SAAA,EAAW,IAAA;AAAK,OACjC,CAAA;AACD,MAAA,UAAA,CAAW,MAAM;AACf,QAAA,IAAI,eAAA,CAAgB,GAAA,CAAI,EAAE,CAAA,EAAG;AAC3B,UAAA,eAAA,CAAgB,OAAO,EAAE,CAAA;AACzB,UAAA,MAAA,CAAO,IAAI,KAAA,CAAM,2BAA2B,CAAC,CAAA;AAAA,QAC/C;AAAA,MACF,GAAG,GAAK,CAAA;AAAA,IACV,CAAC,CAAA;AAAA,EACH;AAEA,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,SAAA;AAAA,IAEN,MAAA,GAAS;AACP,MAAA,OAAO;AAAA,QACL,MAAA,EAAQ;AAAA,UACN,kCAAA,EAAoC,IAAA,CAAK,SAAA,CAAU,OAAO;AAAA,SAC5D;AAAA,QACA,MAAA,EAAQ;AAAA,UACN,GAAA,EAAK;AAAA,YACH,QAAA,EAAU,IAAA;AAAA,YACV,IAAA,EAAM;AAAA;AACR;AACF,OACF;AAAA,IACF,CAAA;AAAA,IAEA,eAAe,MAAA,EAAQ;AACrB,MAAA,QAAA,GAAW,YAAA,CAAa,OAAO,IAAI,CAAA;AACnC,MAAA,IAAI,UAAU,IAAA,EAAM;AAClB,QAAA,OAAA,GAAU,OAAA,CAAQ,WAAW,QAAA,CAAS,IAAA;AAAA,MACxC;AAAA,IACF,CAAA;AAAA,IAEA,gBAAgB,MAAA,EAAuB;AAErC,MAAA,IAAI,iBAAiB,QAAA,EAAU;AAC7B,QAAA,MAAM,GAAA,GAAM,eAAA,CAAgB,QAAA,EAAU,MAAA,CAAO,OAAO,IAAI,CAAA;AACxD,QAAA,IAAI,GAAA,EAAK;AACP,UAAA,OAAA,CAAQ,GAAA,CAAI;AAAA,iCAAA,EAAsC,GAAG;AAAA,CAAI,CAAA;AACzD,UAAA,WAAA,CAAY,GAAG,CAAA;AAAA,QACjB;AAAA,MACF;AAEA,MAAA,MAAA,CAAO,WAAA,CAAY,GAAA,CAAI,CAAC,GAAA,EAAK,KAAK,IAAA,KAAS;AAEzC,QAAA,GAAA,CAAI,SAAA,CAAU,+BAA+B,GAAG,CAAA;AAChD,QAAA,GAAA,CAAI,SAAA,CAAU,gCAAgC,GAAG,CAAA;AACjD,QAAA,GAAA,CAAI,SAAA,CAAU,gCAAgC,GAAG,CAAA;AAGjD,QAAA,IAAI,GAAA,CAAI,GAAA,KAAQ,YAAA,IAAgB,GAAA,CAAI,QAAQ,aAAA,EAAe;AACzD,UAAA,GAAA,CAAI,SAAA,CAAU,GAAA,EAAK,EAAE,cAAA,EAAgB,aAAa,CAAA;AAClD,UAAA,GAAA,CAAI,GAAA,CAAI,eAAA,CAAgB,OAAO,CAAC,CAAA;AAChC,UAAA;AAAA,QACF;AAGA,QAAA,IAAI,GAAA,CAAI,MAAA,KAAW,MAAA,IAAU,GAAA,CAAI,QAAQ,QAAA,EAAU;AACjD,UAAA,IAAI,IAAA,GAAO,EAAA;AACX,UAAA,GAAA,CAAI,EAAA,CAAG,MAAA,EAAQ,CAAC,KAAA,KAAkB;AAChC,YAAA,IAAA,IAAQ,MAAM,QAAA,EAAS;AAAA,UACzB,CAAC,CAAA;AACD,UAAA,GAAA,CAAI,EAAA,CAAG,OAAO,YAAY;AACxB,YAAA,IAAI;AACF,cAAA,MAAM,GAAA,GAAM,IAAA,CAAK,KAAA,CAAM,IAAI,CAAA;AAC3B,cAAA,MAAM,MAAA,GAAS,MAAM,cAAA,CAAe,GAAA,CAAI,MAAA,CAAO,MAAM,GAAA,CAAI,MAAA,CAAO,SAAA,IAAa,EAAE,CAAA;AAC/E,cAAA,GAAA,CAAI,SAAA,CAAU,GAAA,EAAK,EAAE,cAAA,EAAgB,oBAAoB,CAAA;AACzD,cAAA,GAAA,CAAI,GAAA,CAAI,IAAA,CAAK,SAAA,CAAU,MAAM,CAAC,CAAA;AAAA,YAChC,SAAS,GAAA,EAAK;AACZ,cAAA,GAAA,CAAI,SAAA,CAAU,GAAA,EAAK,EAAE,cAAA,EAAgB,oBAAoB,CAAA;AACzD,cAAA,GAAA,CAAI,GAAA;AAAA,gBACF,KAAK,SAAA,CAAU;AAAA,kBACb,OAAA,EAAS,KAAA;AAAA,kBACT,EAAA,EAAI,IAAA,CAAK,KAAA,CAAM,IAAI,CAAA,CAAE,EAAA;AAAA,kBACrB,OAAO,EAAE,IAAA,EAAM,KAAA,EAAQ,OAAA,EAAU,IAAc,OAAA;AAAQ,iBACxD;AAAA,eACH;AAAA,YACF;AAAA,UACF,CAAC,CAAA;AACD,UAAA;AAAA,QACF;AAEA,QAAA,IAAA,EAAK;AAAA,MACP,CAAC,CAAA;AAAA,IACH,CAAA;AAAA,IAEA,QAAA,GAAW;AAET,MAAA,IAAI,aAAA,EAAe;AACjB,QAAA,aAAA,CAAc,KAAK,SAAS,CAAA;AAC5B,QAAA,aAAA,GAAgB,IAAA;AAAA,MAClB;AAAA,IACF;AAAA,GACF;AACF;AAEA,SAAS,gBAAgB,OAAA,EAAyB;AAChD,EAAA,OAAO,CAAA;AAAA;AAAA;AAAA;AAAA,SAAA,EAIE,OAAO,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,uBAAA,EAgBO,OAAO,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,OAAA,CAAA;AA2FhC","file":"index.js","sourcesContent":["import { type ChildProcess, spawn } from \"node:child_process\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport type { Plugin, ViteDevServer } from \"vite\";\n\nexport interface SynapseVitePluginOptions {\n  /** App name. If omitted, reads from ../manifest.json */\n  appName?: string;\n  /** Path to manifest.json. Default: ../manifest.json (relative to ui/) */\n  manifest?: string;\n  /**\n   * Shell command to start the MCP server. If omitted, derived from manifest.\n   * The server runs in stdio mode — stdin/stdout JSON-RPC.\n   */\n  serverCmd?: string;\n  /** Set to false to disable the preview host page at /__preview */\n  preview?: boolean;\n}\n\ninterface Manifest {\n  name: string;\n  version?: string;\n  server?: {\n    type?: string;\n    entry_point?: string;\n    mcp_config?: {\n      command?: string;\n      args?: string[];\n    };\n  };\n}\n\n/**\n * Synapse Vite plugin — full local dev experience for MCP apps.\n *\n * What it does:\n * - Reads ../manifest.json to get app name and server config\n * - Spawns the MCP server as a child process (stdio mode)\n * - Serves a preview host page at /__preview that iframes your app\n * - Proxies tool calls from the iframe through POST /__mcp to the server\n * - Handles the ext-apps handshake so Synapse hooks work\n * - HMR works inside the iframe — edit .tsx, see changes instantly\n *\n * Usage in vite.config.ts:\n *   import { synapseVite } from \"@nimblebrain/synapse/vite\";\n *   export default { plugins: [react(), viteSingleFile(), synapseVite()] };\n *\n * Then: cd ui && npm run dev && open http://localhost:5173/__preview\n */\nexport function synapseVite(options: SynapseVitePluginOptions = {}): Plugin {\n  const enablePreview = options.preview !== false;\n  let manifest: Manifest | null = null;\n  let appName = options.appName ?? \"app\";\n  let serverProcess: ChildProcess | null = null;\n  const pendingRequests = new Map<\n    string,\n    { resolve: (v: unknown) => void; reject: (e: Error) => void }\n  >();\n  let serverBuffer = \"\";\n\n  function loadManifest(root: string): Manifest | null {\n    const manifestPath = options.manifest\n      ? resolve(options.manifest)\n      : resolve(root, \"..\", \"manifest.json\");\n\n    if (!existsSync(manifestPath)) return null;\n    try {\n      return JSON.parse(readFileSync(manifestPath, \"utf-8\"));\n    } catch {\n      return null;\n    }\n  }\n\n  function deriveServerCmd(m: Manifest, root: string): string | null {\n    if (options.serverCmd) return options.serverCmd;\n    const cfg = m.server?.mcp_config;\n    if (!cfg?.command) return null;\n\n    const serverDir = resolve(root, \"..\");\n    let cmd = cfg.command;\n    const args = cfg.args ?? [];\n\n    // Python projects: use `uv run` if pyproject.toml exists\n    if (cmd === \"python\" && existsSync(join(serverDir, \"pyproject.toml\"))) {\n      cmd = \"uv run python\";\n    }\n\n    return `cd ${JSON.stringify(serverDir)} && ${cmd} ${args.join(\" \")}`;\n  }\n\n  function startServer(cmd: string): void {\n    serverProcess = spawn(cmd, {\n      shell: true,\n      stdio: [\"pipe\", \"pipe\", \"pipe\"],\n    });\n\n    serverProcess.stderr?.on(\"data\", (d: Buffer) => {\n      process.stderr.write(`  [mcp] ${d}`);\n    });\n\n    serverProcess.stdout?.on(\"data\", (d: Buffer) => {\n      serverBuffer += d.toString();\n      // Parse line-delimited JSON-RPC responses\n      const lines = serverBuffer.split(\"\\n\");\n      serverBuffer = lines.pop() ?? \"\"; // keep incomplete line\n      for (const line of lines) {\n        if (!line.trim()) continue;\n        try {\n          const msg = JSON.parse(line);\n          if (msg.id && pendingRequests.has(msg.id)) {\n            const p = pendingRequests.get(msg.id);\n            pendingRequests.delete(msg.id);\n            p?.resolve(msg);\n          }\n        } catch {\n          // Not JSON — log it\n          process.stderr.write(`  [mcp] ${line}\\n`);\n        }\n      }\n    });\n\n    serverProcess.on(\"exit\", (code) => {\n      if (code !== null && code !== 0) {\n        console.error(`  [mcp] Server exited with code ${code}`);\n      }\n      serverProcess = null;\n    });\n\n    // Send initialize\n    sendToServer({\n      jsonrpc: \"2.0\",\n      id: \"init-1\",\n      method: \"initialize\",\n      params: {\n        protocolVersion: \"2024-11-05\",\n        capabilities: {},\n        clientInfo: { name: \"synapse-preview\", version: \"0.1.0\" },\n      },\n    });\n  }\n\n  function sendToServer(msg: Record<string, unknown>): void {\n    if (!serverProcess?.stdin?.writable) return;\n    serverProcess.stdin.write(`${JSON.stringify(msg)}\\n`);\n  }\n\n  function callServerTool(name: string, args: Record<string, unknown>): Promise<unknown> {\n    return new Promise((resolve, reject) => {\n      const id = `preview-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;\n      pendingRequests.set(id, { resolve, reject });\n      sendToServer({\n        jsonrpc: \"2.0\",\n        id,\n        method: \"tools/call\",\n        params: { name, arguments: args },\n      });\n      setTimeout(() => {\n        if (pendingRequests.has(id)) {\n          pendingRequests.delete(id);\n          reject(new Error(\"Tool call timed out (10s)\"));\n        }\n      }, 10000);\n    });\n  }\n\n  return {\n    name: \"synapse\",\n\n    config() {\n      return {\n        define: {\n          \"import.meta.env.SYNAPSE_APP_NAME\": JSON.stringify(appName),\n        },\n        server: {\n          hmr: {\n            protocol: \"ws\",\n            host: \"localhost\",\n          },\n        },\n      };\n    },\n\n    configResolved(config) {\n      manifest = loadManifest(config.root);\n      if (manifest?.name) {\n        appName = options.appName ?? manifest.name;\n      }\n    },\n\n    configureServer(server: ViteDevServer) {\n      // Start MCP server\n      if (enablePreview && manifest) {\n        const cmd = deriveServerCmd(manifest, server.config.root);\n        if (cmd) {\n          console.log(`\\n  [synapse] Starting MCP server: ${cmd}\\n`);\n          startServer(cmd);\n        }\n      }\n\n      server.middlewares.use((req, res, next) => {\n        // CORS for iframe communication\n        res.setHeader(\"Access-Control-Allow-Origin\", \"*\");\n        res.setHeader(\"Access-Control-Allow-Methods\", \"*\");\n        res.setHeader(\"Access-Control-Allow-Headers\", \"*\");\n\n        // /__preview — bridge host page\n        if (req.url === \"/__preview\" || req.url === \"/__preview/\") {\n          res.writeHead(200, { \"Content-Type\": \"text/html\" });\n          res.end(previewHostHtml(appName));\n          return;\n        }\n\n        // POST /__mcp — tool call proxy\n        if (req.method === \"POST\" && req.url === \"/__mcp\") {\n          let body = \"\";\n          req.on(\"data\", (chunk: Buffer) => {\n            body += chunk.toString();\n          });\n          req.on(\"end\", async () => {\n            try {\n              const msg = JSON.parse(body);\n              const result = await callServerTool(msg.params.name, msg.params.arguments || {});\n              res.writeHead(200, { \"Content-Type\": \"application/json\" });\n              res.end(JSON.stringify(result));\n            } catch (err) {\n              res.writeHead(200, { \"Content-Type\": \"application/json\" });\n              res.end(\n                JSON.stringify({\n                  jsonrpc: \"2.0\",\n                  id: JSON.parse(body).id,\n                  error: { code: -32000, message: (err as Error).message },\n                }),\n              );\n            }\n          });\n          return;\n        }\n\n        next();\n      });\n    },\n\n    buildEnd() {\n      // Kill server on build end (for production builds)\n      if (serverProcess) {\n        serverProcess.kill(\"SIGTERM\");\n        serverProcess = null;\n      }\n    },\n  };\n}\n\nfunction previewHostHtml(appName: string): string {\n  return `<!DOCTYPE html>\n<html>\n<head>\n  <meta charset=\"utf-8\" />\n  <title>${appName} — Synapse Preview</title>\n  <style>\n    * { margin: 0; padding: 0; box-sizing: border-box; }\n    body { font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif; background: #0f172a; color: #e2e8f0; }\n    header { padding: 10px 16px; background: #1e293b; border-bottom: 1px solid #334155; display: flex; align-items: center; gap: 10px; font-size: 13px; }\n    header .dot { width: 8px; height: 8px; border-radius: 50%; background: #22c55e; }\n    header .name { font-weight: 600; }\n    header .spacer { flex: 1; }\n    header button { background: #334155; border: none; color: #e2e8f0; padding: 3px 8px; border-radius: 4px; cursor: pointer; font-size: 12px; }\n    header .url { color: #64748b; font-size: 11px; font-family: monospace; }\n    iframe { width: 100%; height: calc(100vh - 41px); border: none; }\n  </style>\n</head>\n<body>\n  <header>\n    <span class=\"dot\"></span>\n    <span class=\"name\">${appName}</span>\n    <span class=\"spacer\"></span>\n    <button id=\"toggle\">Toggle Theme</button>\n    <span class=\"url\">Synapse Preview</span>\n  </header>\n  <iframe id=\"app\"></iframe>\n\n  <script>\n    var iframe = document.getElementById(\"app\");\n    var dark = true;\n\n    function getTokens(d) {\n      return d ? {\n        \"--color-background-primary\":\"#0f172a\",\"--color-text-primary\":\"#e2e8f0\",\n        \"--color-background-secondary\":\"#1e293b\",\"--color-text-primary\":\"#e2e8f0\",\n        \"--color-text-accent\":\"#6366f1\",\"--nb-color-accent-foreground\":\"#fff\",\n        \"--color-text-secondary\":\"#94a3b8\",\"--color-border-primary\":\"#334155\",\n        \"--color-ring-primary\":\"#6366f1\",\"--nb-color-danger\":\"#ef4444\",\n        \"--border-radius-sm\":\"0.5rem\",\"--font-sans\":\"-apple-system,BlinkMacSystemFont,sans-serif\"\n      } : {\n        \"--color-background-primary\":\"#ffffff\",\"--color-text-primary\":\"#0f172a\",\n        \"--color-background-secondary\":\"#f8fafc\",\"--color-text-primary\":\"#0f172a\",\n        \"--color-text-accent\":\"#6366f1\",\"--nb-color-accent-foreground\":\"#fff\",\n        \"--color-text-secondary\":\"#64748b\",\"--color-border-primary\":\"#e2e8f0\",\n        \"--color-ring-primary\":\"#6366f1\",\"--nb-color-danger\":\"#ef4444\",\n        \"--border-radius-sm\":\"0.5rem\",\"--font-sans\":\"-apple-system,BlinkMacSystemFont,sans-serif\"\n      };\n    }\n\n    function post(msg) { iframe.contentWindow.postMessage(msg, \"*\"); }\n\n    window.addEventListener(\"message\", async function(e) {\n      if (e.source !== iframe.contentWindow) return;\n      var msg = e.data;\n      if (!msg || typeof msg !== \"object\") return;\n\n      // ext-apps handshake\n      if (msg.method === \"ui/initialize\" && msg.id) {\n        post({ jsonrpc:\"2.0\", id:msg.id, result: {\n          protocolVersion:\"2026-01-26\",\n          serverInfo:{name:\"nimblebrain\",version:\"preview\"},\n          capabilities:{openLinks:{},serverTools:{}},\n          hostContext:{theme:dark?\"dark\":\"light\",primaryColor:\"#6366f1\",tokens:getTokens(dark)}\n        }});\n        return;\n      }\n      if (msg.method === \"ui/notifications/initialized\") return;\n\n      // Tool calls — proxy via Vite middleware\n      if (msg.method === \"tools/call\" && msg.id) {\n        var originalId = msg.id;\n        try {\n          var r = await fetch(\"/__mcp\", {\n            method:\"POST\", headers:{\"Content-Type\":\"application/json\"},\n            body: JSON.stringify({jsonrpc:\"2.0\",id:msg.id,method:\"tools/call\",params:{name:msg.params.name,arguments:msg.params.arguments||{}}})\n          });\n          var response = await r.json();\n          response.id = originalId;\n          post(response);\n          // Notify the app that data changed so hooks auto-refresh\n          // Only for mutating operations (not list/search/get which are read-only)\n          var tn = msg.params.name || \"\";\n          if (!response.error && !tn.startsWith(\"list_\") && !tn.startsWith(\"search_\") && !tn.startsWith(\"get_\") && !tn.startsWith(\"query_\")) {\n            post({jsonrpc:\"2.0\",method:\"ui/datachanged\",params:{tool:tn,server:\"preview\"}});\n          }\n        } catch(err) {\n          post({jsonrpc:\"2.0\",id:originalId,error:{code:-32000,message:err.message}});\n        }\n        return;\n      }\n\n      // Log other messages\n      if (msg.method === \"ui/chat\") console.log(\"[chat]\", msg.params?.message);\n      else if (msg.method === \"ui/action\") console.log(\"[action]\", msg.params?.action, msg.params);\n      else if (msg.method === \"ui/stateChanged\") { console.log(\"[state]\", msg.params?.state); post({jsonrpc:\"2.0\",method:\"ui/stateAcknowledged\",params:{truncated:false}}); }\n      else if (msg.method === \"ui/keydown\") { /* ignore */ }\n      else if (msg.method) console.log(\"[bridge]\", msg.method, msg);\n    });\n\n    document.getElementById(\"toggle\").onclick = function() {\n      dark = !dark;\n      document.body.style.background = dark ? \"#0f172a\" : \"#f1f5f9\";\n      post({jsonrpc:\"2.0\",method:\"ui/themeChanged\",params:{mode:dark?\"dark\":\"light\",tokens:getTokens(dark)}});\n    };\n\n    // Load the iframe AFTER the message listener is attached to avoid\n    // a race where the app sends ui/initialize before the bridge is ready.\n    iframe.src = \"/\";\n  </script>\n</body>\n</html>`;\n}\n"]}

package.json

 {
   "name": "@nimblebrain/synapse",
-  "version": "0.1.4",
-  "description": "Agent-aware app SDK for the NimbleBrain platform",
+  "version": "0.2.0",
+  "description": "Agent-aware app SDK for the MCP ext-apps protocol",
   "type": "module",
@@ -6,0 +6,0 @@ "exports": {

README.md

@@ -10,3 +10,3 @@ # @nimblebrain/synapse
 
-Agent-aware app SDK for the [NimbleBrain](https://nimblebrain.ai) platform. Typed tool calls, reactive state, and React hooks over the [MCP ext-apps](https://modelcontextprotocol.io/specification/2025-06-18/user-interaction/ext-apps) protocol.
+Agent-aware app SDK for the [MCP ext-apps](https://modelcontextprotocol.io/specification/2025-06-18/user-interaction/ext-apps) protocol. Typed tool calls, reactive data sync, and React hooks — works in any host that implements ext-apps (Claude Desktop, VS Code, ChatGPT, [NimbleBrain](https://nimblebrain.ai), or your own runtime).
 
@@ -26,2 +26,8 @@ ## What is Synapse?
 
+## Why Synapse?
+
+Raw ext-apps gives you an iframe and postMessage. That works — until the agent changes data and your UI goes stale, or the user filters a view and the agent can't see what they're looking at, or you spend an afternoon wiring up JSON-RPC request tracking for the third time.
+
+Synapse handles the plumbing so you can focus on the UI. See **[Why Synapse?](docs/WHY.md)** for before/after comparisons of each problem it solves.
+
 ## Install
@@ -28,0 +34,0 @@

dist/chunk-JZC3VC2C.js

-// src/detection.ts
-var DEFAULT_THEME = {
-  mode: "light",
-  primaryColor: "#6366f1",
-  tokens: {}
-};
-function detectHost(initResponse) {
-  const resp = initResponse;
-  const serverInfo = safeObj(resp?.serverInfo);
-  const serverName = typeof serverInfo?.name === "string" ? serverInfo.name : "unknown";
-  const protocolVersion = typeof resp?.protocolVersion === "string" ? resp.protocolVersion : "unknown";
-  const hostContext = safeObj(resp?.hostContext);
-  const theme = extractTheme(hostContext?.theme);
-  return {
-    isNimbleBrain: serverName === "nimblebrain",
-    serverName,
-    protocolVersion,
-    theme
-  };
-}
-function extractTheme(raw) {
-  const obj = safeObj(raw);
-  if (!obj) return { ...DEFAULT_THEME };
-  const mode = obj.mode === "light" || obj.mode === "dark" ? obj.mode : DEFAULT_THEME.mode;
-  const primaryColor = typeof obj.primaryColor === "string" ? obj.primaryColor : DEFAULT_THEME.primaryColor;
-  const tokens = obj.tokens !== null && typeof obj.tokens === "object" && !Array.isArray(obj.tokens) ? obj.tokens : {};
-  return { mode, primaryColor, tokens };
-}
-function safeObj(value) {
-  if (value !== null && typeof value === "object" && !Array.isArray(value)) {
-    return value;
-  }
-  return void 0;
-}
-
-// src/keyboard.ts
-var KeyboardForwarder = class {
-  listener;
-  destroyed = false;
-  constructor(transport, customKeys) {
-    const config = customKeys ?? null;
-    this.listener = (event) => {
-      if (this.destroyed) return;
-      if (this.shouldForward(event, config)) {
-        event.preventDefault();
-        transport.send("ui/keydown", {
-          key: event.key,
-          ctrlKey: event.ctrlKey,
-          metaKey: event.metaKey,
-          shiftKey: event.shiftKey,
-          altKey: event.altKey
-        });
-      }
-    };
-    document.addEventListener("keydown", this.listener);
-  }
-  destroy() {
-    if (this.destroyed) return;
-    this.destroyed = true;
-    document.removeEventListener("keydown", this.listener);
-  }
-  shouldForward(event, config) {
-    if (config && config.length === 0) return false;
-    if (config) {
-      return config.some(
-        (k) => event.key.toLowerCase() === k.key.toLowerCase() && (k.ctrl === void 0 || event.ctrlKey === k.ctrl) && (k.meta === void 0 || event.metaKey === k.meta) && (k.shift === void 0 || event.shiftKey === k.shift) && (k.alt === void 0 || event.altKey === k.alt)
-      );
-    }
-    if (event.key === "Escape") return true;
-    if (event.ctrlKey || event.metaKey) return true;
-    return false;
-  }
-};
-
-// src/result-parser.ts
-function parseToolResult(raw) {
-  if (raw == null) {
-    return { data: null, isError: false };
-  }
-  if (isCallToolResult(raw)) {
-    return parseCallToolResult(raw);
-  }
-  return { data: raw, isError: false };
-}
-function isCallToolResult(value) {
-  if (value === null || typeof value !== "object" || Array.isArray(value)) {
-    return false;
-  }
-  return Array.isArray(value.content);
-}
-function isTextBlock(block) {
-  if (block === null || typeof block !== "object" || Array.isArray(block)) {
-    return false;
-  }
-  const obj = block;
-  return obj.type === "text" && typeof obj.text === "string";
-}
-function parseCallToolResult(result) {
-  const isError = result.isError === true;
-  const content = result.content;
-  if (content.length === 0) {
-    return { data: null, isError };
-  }
-  const firstText = content.find(isTextBlock);
-  if (!firstText) {
-    return { data: content, isError };
-  }
-  try {
-    return { data: JSON.parse(firstText.text), isError };
-  } catch {
-    return { data: firstText.text, isError };
-  }
-}
-
-// src/transport.ts
-var SynapseTransport = class {
-  counter = 0;
-  destroyed = false;
-  pending = /* @__PURE__ */ new Map();
-  handlers = /* @__PURE__ */ new Map();
-  listener;
-  constructor() {
-    this.listener = (event) => this.handleMessage(event);
-    window.addEventListener("message", this.listener);
-  }
-  send(method, params) {
-    if (this.destroyed) return;
-    const msg = {
-      jsonrpc: "2.0",
-      method,
-      ...params !== void 0 && { params }
-    };
-    window.parent.postMessage(msg, "*");
-  }
-  request(method, params) {
-    if (this.destroyed) {
-      return Promise.reject(new Error("Transport destroyed"));
-    }
-    const id = `syn-${++this.counter}`;
-    const msg = {
-      jsonrpc: "2.0",
-      method,
-      id,
-      ...params !== void 0 && { params }
-    };
-    return new Promise((resolve, reject) => {
-      this.pending.set(id, { resolve, reject });
-      window.parent.postMessage(msg, "*");
-    });
-  }
-  onMessage(method, callback) {
-    if (!this.handlers.has(method)) {
-      this.handlers.set(method, /* @__PURE__ */ new Set());
-    }
-    this.handlers.get(method)?.add(callback);
-    return () => {
-      const set = this.handlers.get(method);
-      if (set) {
-        set.delete(callback);
-        if (set.size === 0) {
-          this.handlers.delete(method);
-        }
-      }
-    };
-  }
-  destroy() {
-    if (this.destroyed) return;
-    this.destroyed = true;
-    window.removeEventListener("message", this.listener);
-    const error = new Error("Transport destroyed");
-    for (const entry of this.pending.values()) {
-      entry.reject(error);
-    }
-    this.pending.clear();
-    this.handlers.clear();
-  }
-  handleMessage(event) {
-    if (this.destroyed) return;
-    const data = event.data;
-    if (!data || data.jsonrpc !== "2.0") return;
-    if ("id" in data && data.id && !("method" in data)) {
-      const response = data;
-      const entry = this.pending.get(response.id);
-      if (!entry) return;
-      this.pending.delete(response.id);
-      if (response.error) {
-        const err = new Error(response.error.message);
-        err.code = response.error.code;
-        err.data = response.error.data;
-        entry.reject(err);
-      } else {
-        entry.resolve(response.result);
-      }
-      return;
-    }
-    if ("method" in data && !("id" in data && data.id)) {
-      const notification = data;
-      const set = this.handlers.get(notification.method);
-      if (set) {
-        for (const handler of set) {
-          handler(notification.params);
-        }
-      }
-    }
-  }
-};
-
-// src/core.ts
-function createSynapse(options) {
-  const { name, version, internal = false, forwardKeys } = options;
-  const transport = new SynapseTransport();
-  let hostInfo = null;
-  let currentTheme = {
-    mode: "light",
-    primaryColor: "#6366f1",
-    tokens: {}
-  };
-  let destroyed = false;
-  let stateTimer = null;
-  let keyboard = null;
-  const ready = transport.request("ui/initialize", {
-    protocolVersion: "2026-01-26",
-    clientInfo: { name, version },
-    capabilities: {}
-  }).then((result) => {
-    hostInfo = detectHost(result);
-    currentTheme = hostInfo.theme;
-    transport.send("ui/notifications/initialized", {});
-    keyboard = new KeyboardForwarder(transport, forwardKeys);
-  });
-  const unsubTheme = transport.onMessage("ui/notifications/host-context-changed", (params) => {
-    if (!params) return;
-    const mode = params.theme === "dark" ? "dark" : "light";
-    const tokens = params.tokens && typeof params.tokens === "object" ? params.tokens : currentTheme.tokens;
-    currentTheme = { mode, primaryColor: currentTheme.primaryColor, tokens };
-    for (const cb of themeCallbacks) cb(currentTheme);
-  });
-  const unsubNbTheme = transport.onMessage("ui/themeChanged", (params) => {
-    if (!params) return;
-    const mode = params.mode === "dark" || params.mode === "light" ? params.mode : currentTheme.mode;
-    const tokens = params.tokens && typeof params.tokens === "object" ? params.tokens : currentTheme.tokens;
-    currentTheme = { mode, primaryColor: currentTheme.primaryColor, tokens };
-    for (const cb of themeCallbacks) cb(currentTheme);
-  });
-  const themeCallbacks = /* @__PURE__ */ new Set();
-  const dataCallbacks = /* @__PURE__ */ new Set();
-  const unsubData = transport.onMessage("ui/datachanged", (params) => {
-    if (!params) return;
-    const event = {
-      source: "agent",
-      server: params.server ?? "",
-      tool: params.tool ?? ""
-    };
-    for (const cb of dataCallbacks) cb(event);
-  });
-  const isNB = () => hostInfo?.isNimbleBrain === true;
-  const synapse = {
-    get ready() {
-      return ready;
-    },
-    get isNimbleBrainHost() {
-      return isNB();
-    },
-    async callTool(toolName, args) {
-      const params = {
-        name: toolName,
-        arguments: args ?? {}
-      };
-      if (internal) {
-        params.server = name;
-      }
-      const raw = await transport.request("tools/call", params);
-      return parseToolResult(raw);
-    },
-    onDataChanged(callback) {
-      dataCallbacks.add(callback);
-      return () => {
-        dataCallbacks.delete(callback);
-      };
-    },
-    getTheme() {
-      return { ...currentTheme };
-    },
-    onThemeChanged(callback) {
-      themeCallbacks.add(callback);
-      return () => {
-        themeCallbacks.delete(callback);
-      };
-    },
-    action(action, params) {
-      if (!isNB()) return;
-      transport.send("ui/action", { action, ...params });
-    },
-    chat(message, context) {
-      if (!isNB()) return;
-      transport.send("ui/chat", { message, context });
-    },
-    setVisibleState(state, summary) {
-      if (!isNB()) return;
-      if (stateTimer) clearTimeout(stateTimer);
-      stateTimer = setTimeout(() => {
-        transport.send("ui/stateChanged", {
-          state,
-          ...summary !== void 0 && { summary }
-        });
-        stateTimer = null;
-      }, 250);
-    },
-    downloadFile(filename, content, mimeType) {
-      if (!isNB()) return;
-      const data = typeof content === "string" ? content : "[Blob content not serializable]";
-      transport.send("ui/downloadFile", {
-        data,
-        filename,
-        mimeType: mimeType ?? "application/octet-stream"
-      });
-    },
-    openLink(url) {
-      if (isNB()) {
-        transport.send("ui/openLink", { url });
-      } else {
-        window.open(url, "_blank", "noopener");
-      }
-    },
-    _onMessage(method, callback) {
-      return transport.onMessage(method, callback);
-    },
-    _request(method, params) {
-      return transport.request(method, params);
-    },
-    destroy() {
-      if (destroyed) return;
-      destroyed = true;
-      if (stateTimer) clearTimeout(stateTimer);
-      keyboard?.destroy();
-      unsubTheme();
-      unsubNbTheme();
-      unsubData();
-      themeCallbacks.clear();
-      dataCallbacks.clear();
-      transport.destroy();
-    }
-  };
-  return synapse;
-}
-
-export { createSynapse };
-//# sourceMappingURL=chunk-JZC3VC2C.js.map
-//# sourceMappingURL=chunk-JZC3VC2C.js.map

dist/chunk-JZC3VC2C.js.map

-{"version":3,"sources":["../src/detection.ts","../src/keyboard.ts","../src/result-parser.ts","../src/transport.ts","../src/core.ts"],"names":[],"mappings":"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","file":"chunk-JZC3VC2C.js","sourcesContent":["import type { HostInfo, SynapseTheme } from \"./types\";\n\nconst DEFAULT_THEME: SynapseTheme = {\n  mode: \"light\",\n  primaryColor: \"#6366f1\",\n  tokens: {},\n};\n\n/**\n * Detect the host environment from the ext-apps `ui/initialize` response.\n *\n * Handles missing or malformed fields gracefully — never throws.\n */\nexport function detectHost(initResponse: unknown): HostInfo {\n  const resp = initResponse as Record<string, unknown> | null | undefined;\n\n  const serverInfo = safeObj(resp?.serverInfo);\n  const serverName = typeof serverInfo?.name === \"string\" ? serverInfo.name : \"unknown\";\n\n  const protocolVersion =\n    typeof resp?.protocolVersion === \"string\" ? resp.protocolVersion : \"unknown\";\n\n  const hostContext = safeObj(resp?.hostContext);\n  const theme = extractTheme(hostContext?.theme);\n\n  return {\n    isNimbleBrain: serverName === \"nimblebrain\",\n    serverName,\n    protocolVersion,\n    theme,\n  };\n}\n\nfunction extractTheme(raw: unknown): SynapseTheme {\n  const obj = safeObj(raw);\n  if (!obj) return { ...DEFAULT_THEME };\n\n  const mode = obj.mode === \"light\" || obj.mode === \"dark\" ? obj.mode : DEFAULT_THEME.mode;\n\n  const primaryColor =\n    typeof obj.primaryColor === \"string\" ? obj.primaryColor : DEFAULT_THEME.primaryColor;\n\n  const tokens =\n    obj.tokens !== null && typeof obj.tokens === \"object\" && !Array.isArray(obj.tokens)\n      ? (obj.tokens as Record<string, string>)\n      : {};\n\n  return { mode, primaryColor, tokens };\n}\n\nfunction safeObj(value: unknown): Record<string, unknown> | undefined {\n  if (value !== null && typeof value === \"object\" && !Array.isArray(value)) {\n    return value as Record<string, unknown>;\n  }\n  return undefined;\n}\n","import type { SynapseTransport } from \"./transport.js\";\nimport type { KeyForwardConfig } from \"./types.js\";\n\n/**\n * Forward keyboard shortcuts from the iframe document to the host.\n *\n * By default, forwards all Ctrl/Cmd+key combos and Escape.\n * Apps can customize via `forwardKeys` config.\n */\nexport class KeyboardForwarder {\n  private listener: (event: KeyboardEvent) => void;\n  private destroyed = false;\n\n  constructor(transport: SynapseTransport, customKeys?: KeyForwardConfig[]) {\n    const config = customKeys ?? null; // null = default behavior\n\n    this.listener = (event: KeyboardEvent) => {\n      if (this.destroyed) return;\n      if (this.shouldForward(event, config)) {\n        event.preventDefault();\n        transport.send(\"ui/keydown\", {\n          key: event.key,\n          ctrlKey: event.ctrlKey,\n          metaKey: event.metaKey,\n          shiftKey: event.shiftKey,\n          altKey: event.altKey,\n        });\n      }\n    };\n\n    document.addEventListener(\"keydown\", this.listener);\n  }\n\n  destroy(): void {\n    if (this.destroyed) return;\n    this.destroyed = true;\n    document.removeEventListener(\"keydown\", this.listener);\n  }\n\n  private shouldForward(event: KeyboardEvent, config: KeyForwardConfig[] | null): boolean {\n    // Empty array = forwarding disabled\n    if (config && config.length === 0) return false;\n\n    // Custom config: match exactly\n    if (config) {\n      return config.some(\n        (k) =>\n          event.key.toLowerCase() === k.key.toLowerCase() &&\n          (k.ctrl === undefined || event.ctrlKey === k.ctrl) &&\n          (k.meta === undefined || event.metaKey === k.meta) &&\n          (k.shift === undefined || event.shiftKey === k.shift) &&\n          (k.alt === undefined || event.altKey === k.alt),\n      );\n    }\n\n    // Default: forward all Ctrl/Cmd combos + Escape\n    if (event.key === \"Escape\") return true;\n    if (event.ctrlKey || event.metaKey) return true;\n    return false;\n  }\n}\n","import type { ToolCallResult } from \"./types.js\";\n\n/**\n * Normalize a raw tool call response into a consistent `ToolCallResult`.\n *\n * Handles three shapes:\n * 1. MCP `CallToolResult` — has a `content` array with typed blocks.\n * 2. Raw JSON object (NimbleBrain bridge) — used as-is.\n * 3. Null / undefined — returns `{ data: null, isError: false }`.\n */\nexport function parseToolResult(raw: unknown): ToolCallResult {\n  if (raw == null) {\n    return { data: null, isError: false };\n  }\n\n  if (isCallToolResult(raw)) {\n    return parseCallToolResult(raw);\n  }\n\n  // Raw JSON object — pass through.\n  return { data: raw, isError: false };\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\ninterface McpTextBlock {\n  type: \"text\";\n  text: string;\n}\n\ninterface McpCallToolResult {\n  content: unknown[];\n  isError?: boolean;\n}\n\nfunction isCallToolResult(value: unknown): value is McpCallToolResult {\n  if (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n    return false;\n  }\n  return Array.isArray((value as Record<string, unknown>).content);\n}\n\nfunction isTextBlock(block: unknown): block is McpTextBlock {\n  if (block === null || typeof block !== \"object\" || Array.isArray(block)) {\n    return false;\n  }\n  const obj = block as Record<string, unknown>;\n  return obj.type === \"text\" && typeof obj.text === \"string\";\n}\n\nfunction parseCallToolResult(result: McpCallToolResult): ToolCallResult {\n  const isError = result.isError === true;\n  const content = result.content;\n\n  if (content.length === 0) {\n    return { data: null, isError };\n  }\n\n  const firstText = content.find(isTextBlock);\n\n  if (!firstText) {\n    // No text blocks — return the full content array so callers can inspect it.\n    return { data: content, isError };\n  }\n\n  // Try to parse JSON from the text block.\n  try {\n    return { data: JSON.parse(firstText.text), isError };\n  } catch {\n    // Invalid JSON — return the raw string.\n    return { data: firstText.text, isError };\n  }\n}\n","import type {\n  JsonRpcMessage,\n  JsonRpcNotification,\n  JsonRpcRequest,\n  JsonRpcResponse,\n} from \"./types.js\";\n\ntype PendingEntry = {\n  resolve: (value: unknown) => void;\n  reject: (reason: unknown) => void;\n};\n\ntype MessageHandler = (params: Record<string, unknown> | undefined) => void;\n\nexport class SynapseTransport {\n  private counter = 0;\n  private destroyed = false;\n  private pending = new Map<string, PendingEntry>();\n  private handlers = new Map<string, Set<MessageHandler>>();\n  private listener: (event: MessageEvent) => void;\n\n  constructor() {\n    this.listener = (event: MessageEvent) => this.handleMessage(event);\n    window.addEventListener(\"message\", this.listener);\n  }\n\n  send(method: string, params?: Record<string, unknown>): void {\n    if (this.destroyed) return;\n\n    const msg: JsonRpcNotification = {\n      jsonrpc: \"2.0\",\n      method,\n      ...(params !== undefined && { params }),\n    };\n    window.parent.postMessage(msg, \"*\");\n  }\n\n  request(method: string, params?: Record<string, unknown>): Promise<unknown> {\n    if (this.destroyed) {\n      return Promise.reject(new Error(\"Transport destroyed\"));\n    }\n\n    const id = `syn-${++this.counter}`;\n    const msg: JsonRpcRequest = {\n      jsonrpc: \"2.0\",\n      method,\n      id,\n      ...(params !== undefined && { params }),\n    };\n\n    return new Promise<unknown>((resolve, reject) => {\n      this.pending.set(id, { resolve, reject });\n      window.parent.postMessage(msg, \"*\");\n    });\n  }\n\n  onMessage(method: string, callback: MessageHandler): () => void {\n    if (!this.handlers.has(method)) {\n      this.handlers.set(method, new Set());\n    }\n    this.handlers.get(method)?.add(callback);\n\n    return () => {\n      const set = this.handlers.get(method);\n      if (set) {\n        set.delete(callback);\n        if (set.size === 0) {\n          this.handlers.delete(method);\n        }\n      }\n    };\n  }\n\n  destroy(): void {\n    if (this.destroyed) return;\n    this.destroyed = true;\n\n    window.removeEventListener(\"message\", this.listener);\n\n    const error = new Error(\"Transport destroyed\");\n    for (const entry of this.pending.values()) {\n      entry.reject(error);\n    }\n    this.pending.clear();\n    this.handlers.clear();\n  }\n\n  private handleMessage(event: MessageEvent): void {\n    if (this.destroyed) return;\n\n    const data = event.data as JsonRpcMessage;\n    if (!data || data.jsonrpc !== \"2.0\") return;\n\n    // Response to a pending request\n    if (\"id\" in data && data.id && !(\"method\" in data)) {\n      const response = data as JsonRpcResponse;\n      const entry = this.pending.get(response.id);\n      if (!entry) return;\n      this.pending.delete(response.id);\n\n      if (response.error) {\n        const err = new Error(response.error.message);\n        (err as any).code = response.error.code;\n        (err as any).data = response.error.data;\n        entry.reject(err);\n      } else {\n        entry.resolve(response.result);\n      }\n      return;\n    }\n\n    // Incoming notification\n    if (\"method\" in data && !(\"id\" in data && data.id)) {\n      const notification = data as JsonRpcNotification;\n      const set = this.handlers.get(notification.method);\n      if (set) {\n        for (const handler of set) {\n          handler(notification.params);\n        }\n      }\n    }\n  }\n}\n","import { detectHost } from \"./detection.js\";\nimport { KeyboardForwarder } from \"./keyboard.js\";\nimport { parseToolResult } from \"./result-parser.js\";\nimport { SynapseTransport } from \"./transport.js\";\nimport type {\n  DataChangedEvent,\n  HostInfo,\n  Synapse,\n  SynapseOptions,\n  SynapseTheme,\n  ToolCallResult,\n} from \"./types.js\";\n\n/**\n * Create a Synapse instance.\n *\n * Wraps the ext-apps protocol handshake via `SynapseTransport` and provides\n * a typed, framework-agnostic API for calling tools, reacting to data changes,\n * dispatching actions, and pushing LLM-visible state.\n *\n * In non-NimbleBrain hosts, NB-specific methods degrade to no-ops.\n */\nexport function createSynapse(options: SynapseOptions): Synapse {\n  const { name, version, internal = false, forwardKeys } = options;\n\n  const transport = new SynapseTransport();\n  let hostInfo: HostInfo | null = null;\n  let currentTheme: SynapseTheme = {\n    mode: \"light\",\n    primaryColor: \"#6366f1\",\n    tokens: {},\n  };\n  let destroyed = false;\n\n  // --- Debounce for setVisibleState ---\n  let stateTimer: ReturnType<typeof setTimeout> | null = null;\n\n  // --- Keyboard forwarding ---\n  let keyboard: KeyboardForwarder | null = null;\n\n  // --- ext-apps handshake ---\n  // We send ui/initialize as a JSON-RPC request and wait for the response.\n  const ready = transport\n    .request(\"ui/initialize\", {\n      protocolVersion: \"2026-01-26\",\n      clientInfo: { name, version },\n      capabilities: {},\n    })\n    .then((result) => {\n      hostInfo = detectHost(result);\n      currentTheme = hostInfo.theme;\n\n      // Send initialized notification per ext-apps spec\n      transport.send(\"ui/notifications/initialized\", {});\n\n      // Set up keyboard forwarding after we know the host\n      keyboard = new KeyboardForwarder(transport, forwardKeys);\n    });\n\n  // Listen for theme changes from the host\n  const unsubTheme = transport.onMessage(\"ui/notifications/host-context-changed\", (params) => {\n    if (!params) return;\n    const mode = params.theme === \"dark\" ? \"dark\" : \"light\";\n    const tokens =\n      params.tokens && typeof params.tokens === \"object\"\n        ? (params.tokens as Record<string, string>)\n        : currentTheme.tokens;\n    currentTheme = { mode, primaryColor: currentTheme.primaryColor, tokens };\n    for (const cb of themeCallbacks) cb(currentTheme);\n  });\n\n  // Also listen for NB-specific theme change message\n  const unsubNbTheme = transport.onMessage(\"ui/themeChanged\", (params) => {\n    if (!params) return;\n    const mode =\n      params.mode === \"dark\" || params.mode === \"light\" ? params.mode : currentTheme.mode;\n    const tokens =\n      params.tokens && typeof params.tokens === \"object\"\n        ? (params.tokens as Record<string, string>)\n        : currentTheme.tokens;\n    currentTheme = { mode, primaryColor: currentTheme.primaryColor, tokens };\n    for (const cb of themeCallbacks) cb(currentTheme);\n  });\n\n  const themeCallbacks = new Set<(theme: SynapseTheme) => void>();\n  const dataCallbacks = new Set<(event: DataChangedEvent) => void>();\n\n  // Listen for data change events\n  const unsubData = transport.onMessage(\"ui/datachanged\", (params) => {\n    if (!params) return;\n    const event: DataChangedEvent = {\n      source: \"agent\",\n      server: (params.server as string) ?? \"\",\n      tool: (params.tool as string) ?? \"\",\n    };\n    for (const cb of dataCallbacks) cb(event);\n  });\n\n  const isNB = () => hostInfo?.isNimbleBrain === true;\n\n  const synapse: Synapse = {\n    get ready() {\n      return ready;\n    },\n\n    get isNimbleBrainHost() {\n      return isNB();\n    },\n\n    async callTool<TInput = Record<string, unknown>, TOutput = unknown>(\n      toolName: string,\n      args?: TInput,\n    ): Promise<ToolCallResult<TOutput>> {\n      const params: Record<string, unknown> = {\n        name: toolName,\n        arguments: args ?? {},\n      };\n      // Internal apps can cross-call\n      if (internal) {\n        params.server = name;\n      }\n      const raw = await transport.request(\"tools/call\", params);\n      return parseToolResult(raw) as ToolCallResult<TOutput>;\n    },\n\n    onDataChanged(callback: (event: DataChangedEvent) => void): () => void {\n      dataCallbacks.add(callback);\n      return () => {\n        dataCallbacks.delete(callback);\n      };\n    },\n\n    getTheme(): SynapseTheme {\n      return { ...currentTheme };\n    },\n\n    onThemeChanged(callback: (theme: SynapseTheme) => void): () => void {\n      themeCallbacks.add(callback);\n      return () => {\n        themeCallbacks.delete(callback);\n      };\n    },\n\n    action(action: string, params?: Record<string, unknown>): void {\n      if (!isNB()) return;\n      transport.send(\"ui/action\", { action, ...params });\n    },\n\n    chat(message: string, context?: { action?: string; entity?: string }): void {\n      if (!isNB()) return;\n      transport.send(\"ui/chat\", { message, context });\n    },\n\n    setVisibleState(state: Record<string, unknown>, summary?: string): void {\n      if (!isNB()) return;\n\n      // Debounce: 250ms\n      if (stateTimer) clearTimeout(stateTimer);\n      stateTimer = setTimeout(() => {\n        transport.send(\"ui/stateChanged\", {\n          state,\n          ...(summary !== undefined && { summary }),\n        });\n        stateTimer = null;\n      }, 250);\n    },\n\n    downloadFile(filename: string, content: string | Blob, mimeType?: string): void {\n      if (!isNB()) return;\n      const data = typeof content === \"string\" ? content : \"[Blob content not serializable]\";\n      transport.send(\"ui/downloadFile\", {\n        data,\n        filename,\n        mimeType: mimeType ?? \"application/octet-stream\",\n      });\n    },\n\n    openLink(url: string): void {\n      if (isNB()) {\n        transport.send(\"ui/openLink\", { url });\n      } else {\n        window.open(url, \"_blank\", \"noopener\");\n      }\n    },\n\n    _onMessage(\n      method: string,\n      callback: (params: Record<string, unknown> | undefined) => void,\n    ): () => void {\n      return transport.onMessage(method, callback);\n    },\n\n    _request(method: string, params?: Record<string, unknown>): Promise<unknown> {\n      return transport.request(method, params);\n    },\n\n    destroy(): void {\n      if (destroyed) return;\n      destroyed = true;\n\n      if (stateTimer) clearTimeout(stateTimer);\n      keyboard?.destroy();\n      unsubTheme();\n      unsubNbTheme();\n      unsubData();\n      themeCallbacks.clear();\n      dataCallbacks.clear();\n      transport.destroy();\n    },\n  };\n\n  return synapse;\n}\n"]}

dist/chunk-Q7OSHSGZ.cjs

-'use strict';
-
-// src/detection.ts
-var DEFAULT_THEME = {
-  mode: "light",
-  primaryColor: "#6366f1",
-  tokens: {}
-};
-function detectHost(initResponse) {
-  const resp = initResponse;
-  const serverInfo = safeObj(resp?.serverInfo);
-  const serverName = typeof serverInfo?.name === "string" ? serverInfo.name : "unknown";
-  const protocolVersion = typeof resp?.protocolVersion === "string" ? resp.protocolVersion : "unknown";
-  const hostContext = safeObj(resp?.hostContext);
-  const theme = extractTheme(hostContext?.theme);
-  return {
-    isNimbleBrain: serverName === "nimblebrain",
-    serverName,
-    protocolVersion,
-    theme
-  };
-}
-function extractTheme(raw) {
-  const obj = safeObj(raw);
-  if (!obj) return { ...DEFAULT_THEME };
-  const mode = obj.mode === "light" || obj.mode === "dark" ? obj.mode : DEFAULT_THEME.mode;
-  const primaryColor = typeof obj.primaryColor === "string" ? obj.primaryColor : DEFAULT_THEME.primaryColor;
-  const tokens = obj.tokens !== null && typeof obj.tokens === "object" && !Array.isArray(obj.tokens) ? obj.tokens : {};
-  return { mode, primaryColor, tokens };
-}
-function safeObj(value) {
-  if (value !== null && typeof value === "object" && !Array.isArray(value)) {
-    return value;
-  }
-  return void 0;
-}
-
-// src/keyboard.ts
-var KeyboardForwarder = class {
-  listener;
-  destroyed = false;
-  constructor(transport, customKeys) {
-    const config = customKeys ?? null;
-    this.listener = (event) => {
-      if (this.destroyed) return;
-      if (this.shouldForward(event, config)) {
-        event.preventDefault();
-        transport.send("ui/keydown", {
-          key: event.key,
-          ctrlKey: event.ctrlKey,
-          metaKey: event.metaKey,
-          shiftKey: event.shiftKey,
-          altKey: event.altKey
-        });
-      }
-    };
-    document.addEventListener("keydown", this.listener);
-  }
-  destroy() {
-    if (this.destroyed) return;
-    this.destroyed = true;
-    document.removeEventListener("keydown", this.listener);
-  }
-  shouldForward(event, config) {
-    if (config && config.length === 0) return false;
-    if (config) {
-      return config.some(
-        (k) => event.key.toLowerCase() === k.key.toLowerCase() && (k.ctrl === void 0 || event.ctrlKey === k.ctrl) && (k.meta === void 0 || event.metaKey === k.meta) && (k.shift === void 0 || event.shiftKey === k.shift) && (k.alt === void 0 || event.altKey === k.alt)
-      );
-    }
-    if (event.key === "Escape") return true;
-    if (event.ctrlKey || event.metaKey) return true;
-    return false;
-  }
-};
-
-// src/result-parser.ts
-function parseToolResult(raw) {
-  if (raw == null) {
-    return { data: null, isError: false };
-  }
-  if (isCallToolResult(raw)) {
-    return parseCallToolResult(raw);
-  }
-  return { data: raw, isError: false };
-}
-function isCallToolResult(value) {
-  if (value === null || typeof value !== "object" || Array.isArray(value)) {
-    return false;
-  }
-  return Array.isArray(value.content);
-}
-function isTextBlock(block) {
-  if (block === null || typeof block !== "object" || Array.isArray(block)) {
-    return false;
-  }
-  const obj = block;
-  return obj.type === "text" && typeof obj.text === "string";
-}
-function parseCallToolResult(result) {
-  const isError = result.isError === true;
-  const content = result.content;
-  if (content.length === 0) {
-    return { data: null, isError };
-  }
-  const firstText = content.find(isTextBlock);
-  if (!firstText) {
-    return { data: content, isError };
-  }
-  try {
-    return { data: JSON.parse(firstText.text), isError };
-  } catch {
-    return { data: firstText.text, isError };
-  }
-}
-
-// src/transport.ts
-var SynapseTransport = class {
-  counter = 0;
-  destroyed = false;
-  pending = /* @__PURE__ */ new Map();
-  handlers = /* @__PURE__ */ new Map();
-  listener;
-  constructor() {
-    this.listener = (event) => this.handleMessage(event);
-    window.addEventListener("message", this.listener);
-  }
-  send(method, params) {
-    if (this.destroyed) return;
-    const msg = {
-      jsonrpc: "2.0",
-      method,
-      ...params !== void 0 && { params }
-    };
-    window.parent.postMessage(msg, "*");
-  }
-  request(method, params) {
-    if (this.destroyed) {
-      return Promise.reject(new Error("Transport destroyed"));
-    }
-    const id = `syn-${++this.counter}`;
-    const msg = {
-      jsonrpc: "2.0",
-      method,
-      id,
-      ...params !== void 0 && { params }
-    };
-    return new Promise((resolve, reject) => {
-      this.pending.set(id, { resolve, reject });
-      window.parent.postMessage(msg, "*");
-    });
-  }
-  onMessage(method, callback) {
-    if (!this.handlers.has(method)) {
-      this.handlers.set(method, /* @__PURE__ */ new Set());
-    }
-    this.handlers.get(method)?.add(callback);
-    return () => {
-      const set = this.handlers.get(method);
-      if (set) {
-        set.delete(callback);
-        if (set.size === 0) {
-          this.handlers.delete(method);
-        }
-      }
-    };
-  }
-  destroy() {
-    if (this.destroyed) return;
-    this.destroyed = true;
-    window.removeEventListener("message", this.listener);
-    const error = new Error("Transport destroyed");
-    for (const entry of this.pending.values()) {
-      entry.reject(error);
-    }
-    this.pending.clear();
-    this.handlers.clear();
-  }
-  handleMessage(event) {
-    if (this.destroyed) return;
-    const data = event.data;
-    if (!data || data.jsonrpc !== "2.0") return;
-    if ("id" in data && data.id && !("method" in data)) {
-      const response = data;
-      const entry = this.pending.get(response.id);
-      if (!entry) return;
-      this.pending.delete(response.id);
-      if (response.error) {
-        const err = new Error(response.error.message);
-        err.code = response.error.code;
-        err.data = response.error.data;
-        entry.reject(err);
-      } else {
-        entry.resolve(response.result);
-      }
-      return;
-    }
-    if ("method" in data && !("id" in data && data.id)) {
-      const notification = data;
-      const set = this.handlers.get(notification.method);
-      if (set) {
-        for (const handler of set) {
-          handler(notification.params);
-        }
-      }
-    }
-  }
-};
-
-// src/core.ts
-function createSynapse(options) {
-  const { name, version, internal = false, forwardKeys } = options;
-  const transport = new SynapseTransport();
-  let hostInfo = null;
-  let currentTheme = {
-    mode: "light",
-    primaryColor: "#6366f1",
-    tokens: {}
-  };
-  let destroyed = false;
-  let stateTimer = null;
-  let keyboard = null;
-  const ready = transport.request("ui/initialize", {
-    protocolVersion: "2026-01-26",
-    clientInfo: { name, version },
-    capabilities: {}
-  }).then((result) => {
-    hostInfo = detectHost(result);
-    currentTheme = hostInfo.theme;
-    transport.send("ui/notifications/initialized", {});
-    keyboard = new KeyboardForwarder(transport, forwardKeys);
-  });
-  const unsubTheme = transport.onMessage("ui/notifications/host-context-changed", (params) => {
-    if (!params) return;
-    const mode = params.theme === "dark" ? "dark" : "light";
-    const tokens = params.tokens && typeof params.tokens === "object" ? params.tokens : currentTheme.tokens;
-    currentTheme = { mode, primaryColor: currentTheme.primaryColor, tokens };
-    for (const cb of themeCallbacks) cb(currentTheme);
-  });
-  const unsubNbTheme = transport.onMessage("ui/themeChanged", (params) => {
-    if (!params) return;
-    const mode = params.mode === "dark" || params.mode === "light" ? params.mode : currentTheme.mode;
-    const tokens = params.tokens && typeof params.tokens === "object" ? params.tokens : currentTheme.tokens;
-    currentTheme = { mode, primaryColor: currentTheme.primaryColor, tokens };
-    for (const cb of themeCallbacks) cb(currentTheme);
-  });
-  const themeCallbacks = /* @__PURE__ */ new Set();
-  const dataCallbacks = /* @__PURE__ */ new Set();
-  const unsubData = transport.onMessage("ui/datachanged", (params) => {
-    if (!params) return;
-    const event = {
-      source: "agent",
-      server: params.server ?? "",
-      tool: params.tool ?? ""
-    };
-    for (const cb of dataCallbacks) cb(event);
-  });
-  const isNB = () => hostInfo?.isNimbleBrain === true;
-  const synapse = {
-    get ready() {
-      return ready;
-    },
-    get isNimbleBrainHost() {
-      return isNB();
-    },
-    async callTool(toolName, args) {
-      const params = {
-        name: toolName,
-        arguments: args ?? {}
-      };
-      if (internal) {
-        params.server = name;
-      }
-      const raw = await transport.request("tools/call", params);
-      return parseToolResult(raw);
-    },
-    onDataChanged(callback) {
-      dataCallbacks.add(callback);
-      return () => {
-        dataCallbacks.delete(callback);
-      };
-    },
-    getTheme() {
-      return { ...currentTheme };
-    },
-    onThemeChanged(callback) {
-      themeCallbacks.add(callback);
-      return () => {
-        themeCallbacks.delete(callback);
-      };
-    },
-    action(action, params) {
-      if (!isNB()) return;
-      transport.send("ui/action", { action, ...params });
-    },
-    chat(message, context) {
-      if (!isNB()) return;
-      transport.send("ui/chat", { message, context });
-    },
-    setVisibleState(state, summary) {
-      if (!isNB()) return;
-      if (stateTimer) clearTimeout(stateTimer);
-      stateTimer = setTimeout(() => {
-        transport.send("ui/stateChanged", {
-          state,
-          ...summary !== void 0 && { summary }
-        });
-        stateTimer = null;
-      }, 250);
-    },
-    downloadFile(filename, content, mimeType) {
-      if (!isNB()) return;
-      const data = typeof content === "string" ? content : "[Blob content not serializable]";
-      transport.send("ui/downloadFile", {
-        data,
-        filename,
-        mimeType: mimeType ?? "application/octet-stream"
-      });
-    },
-    openLink(url) {
-      if (isNB()) {
-        transport.send("ui/openLink", { url });
-      } else {
-        window.open(url, "_blank", "noopener");
-      }
-    },
-    _onMessage(method, callback) {
-      return transport.onMessage(method, callback);
-    },
-    _request(method, params) {
-      return transport.request(method, params);
-    },
-    destroy() {
-      if (destroyed) return;
-      destroyed = true;
-      if (stateTimer) clearTimeout(stateTimer);
-      keyboard?.destroy();
-      unsubTheme();
-      unsubNbTheme();
-      unsubData();
-      themeCallbacks.clear();
-      dataCallbacks.clear();
-      transport.destroy();
-    }
-  };
-  return synapse;
-}
-
-exports.createSynapse = createSynapse;
-//# sourceMappingURL=chunk-Q7OSHSGZ.cjs.map
-//# sourceMappingURL=chunk-Q7OSHSGZ.cjs.map

dist/chunk-Q7OSHSGZ.cjs.map

-{"version":3,"sources":["../src/detection.ts","../src/keyboard.ts","../src/result-parser.ts","../src/transport.ts","../src/core.ts"],"names":[],"mappings":"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","file":"chunk-Q7OSHSGZ.cjs","sourcesContent":["import type { HostInfo, SynapseTheme } from \"./types\";\n\nconst DEFAULT_THEME: SynapseTheme = {\n  mode: \"light\",\n  primaryColor: \"#6366f1\",\n  tokens: {},\n};\n\n/**\n * Detect the host environment from the ext-apps `ui/initialize` response.\n *\n * Handles missing or malformed fields gracefully — never throws.\n */\nexport function detectHost(initResponse: unknown): HostInfo {\n  const resp = initResponse as Record<string, unknown> | null | undefined;\n\n  const serverInfo = safeObj(resp?.serverInfo);\n  const serverName = typeof serverInfo?.name === \"string\" ? serverInfo.name : \"unknown\";\n\n  const protocolVersion =\n    typeof resp?.protocolVersion === \"string\" ? resp.protocolVersion : \"unknown\";\n\n  const hostContext = safeObj(resp?.hostContext);\n  const theme = extractTheme(hostContext?.theme);\n\n  return {\n    isNimbleBrain: serverName === \"nimblebrain\",\n    serverName,\n    protocolVersion,\n    theme,\n  };\n}\n\nfunction extractTheme(raw: unknown): SynapseTheme {\n  const obj = safeObj(raw);\n  if (!obj) return { ...DEFAULT_THEME };\n\n  const mode = obj.mode === \"light\" || obj.mode === \"dark\" ? obj.mode : DEFAULT_THEME.mode;\n\n  const primaryColor =\n    typeof obj.primaryColor === \"string\" ? obj.primaryColor : DEFAULT_THEME.primaryColor;\n\n  const tokens =\n    obj.tokens !== null && typeof obj.tokens === \"object\" && !Array.isArray(obj.tokens)\n      ? (obj.tokens as Record<string, string>)\n      : {};\n\n  return { mode, primaryColor, tokens };\n}\n\nfunction safeObj(value: unknown): Record<string, unknown> | undefined {\n  if (value !== null && typeof value === \"object\" && !Array.isArray(value)) {\n    return value as Record<string, unknown>;\n  }\n  return undefined;\n}\n","import type { SynapseTransport } from \"./transport.js\";\nimport type { KeyForwardConfig } from \"./types.js\";\n\n/**\n * Forward keyboard shortcuts from the iframe document to the host.\n *\n * By default, forwards all Ctrl/Cmd+key combos and Escape.\n * Apps can customize via `forwardKeys` config.\n */\nexport class KeyboardForwarder {\n  private listener: (event: KeyboardEvent) => void;\n  private destroyed = false;\n\n  constructor(transport: SynapseTransport, customKeys?: KeyForwardConfig[]) {\n    const config = customKeys ?? null; // null = default behavior\n\n    this.listener = (event: KeyboardEvent) => {\n      if (this.destroyed) return;\n      if (this.shouldForward(event, config)) {\n        event.preventDefault();\n        transport.send(\"ui/keydown\", {\n          key: event.key,\n          ctrlKey: event.ctrlKey,\n          metaKey: event.metaKey,\n          shiftKey: event.shiftKey,\n          altKey: event.altKey,\n        });\n      }\n    };\n\n    document.addEventListener(\"keydown\", this.listener);\n  }\n\n  destroy(): void {\n    if (this.destroyed) return;\n    this.destroyed = true;\n    document.removeEventListener(\"keydown\", this.listener);\n  }\n\n  private shouldForward(event: KeyboardEvent, config: KeyForwardConfig[] | null): boolean {\n    // Empty array = forwarding disabled\n    if (config && config.length === 0) return false;\n\n    // Custom config: match exactly\n    if (config) {\n      return config.some(\n        (k) =>\n          event.key.toLowerCase() === k.key.toLowerCase() &&\n          (k.ctrl === undefined || event.ctrlKey === k.ctrl) &&\n          (k.meta === undefined || event.metaKey === k.meta) &&\n          (k.shift === undefined || event.shiftKey === k.shift) &&\n          (k.alt === undefined || event.altKey === k.alt),\n      );\n    }\n\n    // Default: forward all Ctrl/Cmd combos + Escape\n    if (event.key === \"Escape\") return true;\n    if (event.ctrlKey || event.metaKey) return true;\n    return false;\n  }\n}\n","import type { ToolCallResult } from \"./types.js\";\n\n/**\n * Normalize a raw tool call response into a consistent `ToolCallResult`.\n *\n * Handles three shapes:\n * 1. MCP `CallToolResult` — has a `content` array with typed blocks.\n * 2. Raw JSON object (NimbleBrain bridge) — used as-is.\n * 3. Null / undefined — returns `{ data: null, isError: false }`.\n */\nexport function parseToolResult(raw: unknown): ToolCallResult {\n  if (raw == null) {\n    return { data: null, isError: false };\n  }\n\n  if (isCallToolResult(raw)) {\n    return parseCallToolResult(raw);\n  }\n\n  // Raw JSON object — pass through.\n  return { data: raw, isError: false };\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\ninterface McpTextBlock {\n  type: \"text\";\n  text: string;\n}\n\ninterface McpCallToolResult {\n  content: unknown[];\n  isError?: boolean;\n}\n\nfunction isCallToolResult(value: unknown): value is McpCallToolResult {\n  if (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n    return false;\n  }\n  return Array.isArray((value as Record<string, unknown>).content);\n}\n\nfunction isTextBlock(block: unknown): block is McpTextBlock {\n  if (block === null || typeof block !== \"object\" || Array.isArray(block)) {\n    return false;\n  }\n  const obj = block as Record<string, unknown>;\n  return obj.type === \"text\" && typeof obj.text === \"string\";\n}\n\nfunction parseCallToolResult(result: McpCallToolResult): ToolCallResult {\n  const isError = result.isError === true;\n  const content = result.content;\n\n  if (content.length === 0) {\n    return { data: null, isError };\n  }\n\n  const firstText = content.find(isTextBlock);\n\n  if (!firstText) {\n    // No text blocks — return the full content array so callers can inspect it.\n    return { data: content, isError };\n  }\n\n  // Try to parse JSON from the text block.\n  try {\n    return { data: JSON.parse(firstText.text), isError };\n  } catch {\n    // Invalid JSON — return the raw string.\n    return { data: firstText.text, isError };\n  }\n}\n","import type {\n  JsonRpcMessage,\n  JsonRpcNotification,\n  JsonRpcRequest,\n  JsonRpcResponse,\n} from \"./types.js\";\n\ntype PendingEntry = {\n  resolve: (value: unknown) => void;\n  reject: (reason: unknown) => void;\n};\n\ntype MessageHandler = (params: Record<string, unknown> | undefined) => void;\n\nexport class SynapseTransport {\n  private counter = 0;\n  private destroyed = false;\n  private pending = new Map<string, PendingEntry>();\n  private handlers = new Map<string, Set<MessageHandler>>();\n  private listener: (event: MessageEvent) => void;\n\n  constructor() {\n    this.listener = (event: MessageEvent) => this.handleMessage(event);\n    window.addEventListener(\"message\", this.listener);\n  }\n\n  send(method: string, params?: Record<string, unknown>): void {\n    if (this.destroyed) return;\n\n    const msg: JsonRpcNotification = {\n      jsonrpc: \"2.0\",\n      method,\n      ...(params !== undefined && { params }),\n    };\n    window.parent.postMessage(msg, \"*\");\n  }\n\n  request(method: string, params?: Record<string, unknown>): Promise<unknown> {\n    if (this.destroyed) {\n      return Promise.reject(new Error(\"Transport destroyed\"));\n    }\n\n    const id = `syn-${++this.counter}`;\n    const msg: JsonRpcRequest = {\n      jsonrpc: \"2.0\",\n      method,\n      id,\n      ...(params !== undefined && { params }),\n    };\n\n    return new Promise<unknown>((resolve, reject) => {\n      this.pending.set(id, { resolve, reject });\n      window.parent.postMessage(msg, \"*\");\n    });\n  }\n\n  onMessage(method: string, callback: MessageHandler): () => void {\n    if (!this.handlers.has(method)) {\n      this.handlers.set(method, new Set());\n    }\n    this.handlers.get(method)?.add(callback);\n\n    return () => {\n      const set = this.handlers.get(method);\n      if (set) {\n        set.delete(callback);\n        if (set.size === 0) {\n          this.handlers.delete(method);\n        }\n      }\n    };\n  }\n\n  destroy(): void {\n    if (this.destroyed) return;\n    this.destroyed = true;\n\n    window.removeEventListener(\"message\", this.listener);\n\n    const error = new Error(\"Transport destroyed\");\n    for (const entry of this.pending.values()) {\n      entry.reject(error);\n    }\n    this.pending.clear();\n    this.handlers.clear();\n  }\n\n  private handleMessage(event: MessageEvent): void {\n    if (this.destroyed) return;\n\n    const data = event.data as JsonRpcMessage;\n    if (!data || data.jsonrpc !== \"2.0\") return;\n\n    // Response to a pending request\n    if (\"id\" in data && data.id && !(\"method\" in data)) {\n      const response = data as JsonRpcResponse;\n      const entry = this.pending.get(response.id);\n      if (!entry) return;\n      this.pending.delete(response.id);\n\n      if (response.error) {\n        const err = new Error(response.error.message);\n        (err as any).code = response.error.code;\n        (err as any).data = response.error.data;\n        entry.reject(err);\n      } else {\n        entry.resolve(response.result);\n      }\n      return;\n    }\n\n    // Incoming notification\n    if (\"method\" in data && !(\"id\" in data && data.id)) {\n      const notification = data as JsonRpcNotification;\n      const set = this.handlers.get(notification.method);\n      if (set) {\n        for (const handler of set) {\n          handler(notification.params);\n        }\n      }\n    }\n  }\n}\n","import { detectHost } from \"./detection.js\";\nimport { KeyboardForwarder } from \"./keyboard.js\";\nimport { parseToolResult } from \"./result-parser.js\";\nimport { SynapseTransport } from \"./transport.js\";\nimport type {\n  DataChangedEvent,\n  HostInfo,\n  Synapse,\n  SynapseOptions,\n  SynapseTheme,\n  ToolCallResult,\n} from \"./types.js\";\n\n/**\n * Create a Synapse instance.\n *\n * Wraps the ext-apps protocol handshake via `SynapseTransport` and provides\n * a typed, framework-agnostic API for calling tools, reacting to data changes,\n * dispatching actions, and pushing LLM-visible state.\n *\n * In non-NimbleBrain hosts, NB-specific methods degrade to no-ops.\n */\nexport function createSynapse(options: SynapseOptions): Synapse {\n  const { name, version, internal = false, forwardKeys } = options;\n\n  const transport = new SynapseTransport();\n  let hostInfo: HostInfo | null = null;\n  let currentTheme: SynapseTheme = {\n    mode: \"light\",\n    primaryColor: \"#6366f1\",\n    tokens: {},\n  };\n  let destroyed = false;\n\n  // --- Debounce for setVisibleState ---\n  let stateTimer: ReturnType<typeof setTimeout> | null = null;\n\n  // --- Keyboard forwarding ---\n  let keyboard: KeyboardForwarder | null = null;\n\n  // --- ext-apps handshake ---\n  // We send ui/initialize as a JSON-RPC request and wait for the response.\n  const ready = transport\n    .request(\"ui/initialize\", {\n      protocolVersion: \"2026-01-26\",\n      clientInfo: { name, version },\n      capabilities: {},\n    })\n    .then((result) => {\n      hostInfo = detectHost(result);\n      currentTheme = hostInfo.theme;\n\n      // Send initialized notification per ext-apps spec\n      transport.send(\"ui/notifications/initialized\", {});\n\n      // Set up keyboard forwarding after we know the host\n      keyboard = new KeyboardForwarder(transport, forwardKeys);\n    });\n\n  // Listen for theme changes from the host\n  const unsubTheme = transport.onMessage(\"ui/notifications/host-context-changed\", (params) => {\n    if (!params) return;\n    const mode = params.theme === \"dark\" ? \"dark\" : \"light\";\n    const tokens =\n      params.tokens && typeof params.tokens === \"object\"\n        ? (params.tokens as Record<string, string>)\n        : currentTheme.tokens;\n    currentTheme = { mode, primaryColor: currentTheme.primaryColor, tokens };\n    for (const cb of themeCallbacks) cb(currentTheme);\n  });\n\n  // Also listen for NB-specific theme change message\n  const unsubNbTheme = transport.onMessage(\"ui/themeChanged\", (params) => {\n    if (!params) return;\n    const mode =\n      params.mode === \"dark\" || params.mode === \"light\" ? params.mode : currentTheme.mode;\n    const tokens =\n      params.tokens && typeof params.tokens === \"object\"\n        ? (params.tokens as Record<string, string>)\n        : currentTheme.tokens;\n    currentTheme = { mode, primaryColor: currentTheme.primaryColor, tokens };\n    for (const cb of themeCallbacks) cb(currentTheme);\n  });\n\n  const themeCallbacks = new Set<(theme: SynapseTheme) => void>();\n  const dataCallbacks = new Set<(event: DataChangedEvent) => void>();\n\n  // Listen for data change events\n  const unsubData = transport.onMessage(\"ui/datachanged\", (params) => {\n    if (!params) return;\n    const event: DataChangedEvent = {\n      source: \"agent\",\n      server: (params.server as string) ?? \"\",\n      tool: (params.tool as string) ?? \"\",\n    };\n    for (const cb of dataCallbacks) cb(event);\n  });\n\n  const isNB = () => hostInfo?.isNimbleBrain === true;\n\n  const synapse: Synapse = {\n    get ready() {\n      return ready;\n    },\n\n    get isNimbleBrainHost() {\n      return isNB();\n    },\n\n    async callTool<TInput = Record<string, unknown>, TOutput = unknown>(\n      toolName: string,\n      args?: TInput,\n    ): Promise<ToolCallResult<TOutput>> {\n      const params: Record<string, unknown> = {\n        name: toolName,\n        arguments: args ?? {},\n      };\n      // Internal apps can cross-call\n      if (internal) {\n        params.server = name;\n      }\n      const raw = await transport.request(\"tools/call\", params);\n      return parseToolResult(raw) as ToolCallResult<TOutput>;\n    },\n\n    onDataChanged(callback: (event: DataChangedEvent) => void): () => void {\n      dataCallbacks.add(callback);\n      return () => {\n        dataCallbacks.delete(callback);\n      };\n    },\n\n    getTheme(): SynapseTheme {\n      return { ...currentTheme };\n    },\n\n    onThemeChanged(callback: (theme: SynapseTheme) => void): () => void {\n      themeCallbacks.add(callback);\n      return () => {\n        themeCallbacks.delete(callback);\n      };\n    },\n\n    action(action: string, params?: Record<string, unknown>): void {\n      if (!isNB()) return;\n      transport.send(\"ui/action\", { action, ...params });\n    },\n\n    chat(message: string, context?: { action?: string; entity?: string }): void {\n      if (!isNB()) return;\n      transport.send(\"ui/chat\", { message, context });\n    },\n\n    setVisibleState(state: Record<string, unknown>, summary?: string): void {\n      if (!isNB()) return;\n\n      // Debounce: 250ms\n      if (stateTimer) clearTimeout(stateTimer);\n      stateTimer = setTimeout(() => {\n        transport.send(\"ui/stateChanged\", {\n          state,\n          ...(summary !== undefined && { summary }),\n        });\n        stateTimer = null;\n      }, 250);\n    },\n\n    downloadFile(filename: string, content: string | Blob, mimeType?: string): void {\n      if (!isNB()) return;\n      const data = typeof content === \"string\" ? content : \"[Blob content not serializable]\";\n      transport.send(\"ui/downloadFile\", {\n        data,\n        filename,\n        mimeType: mimeType ?? \"application/octet-stream\",\n      });\n    },\n\n    openLink(url: string): void {\n      if (isNB()) {\n        transport.send(\"ui/openLink\", { url });\n      } else {\n        window.open(url, \"_blank\", \"noopener\");\n      }\n    },\n\n    _onMessage(\n      method: string,\n      callback: (params: Record<string, unknown> | undefined) => void,\n    ): () => void {\n      return transport.onMessage(method, callback);\n    },\n\n    _request(method: string, params?: Record<string, unknown>): Promise<unknown> {\n      return transport.request(method, params);\n    },\n\n    destroy(): void {\n      if (destroyed) return;\n      destroyed = true;\n\n      if (stateTimer) clearTimeout(stateTimer);\n      keyboard?.destroy();\n      unsubTheme();\n      unsubNbTheme();\n      unsubData();\n      themeCallbacks.clear();\n      dataCallbacks.clear();\n      transport.destroy();\n    },\n  };\n\n  return synapse;\n}\n"]}

dist/server-RUCX2TIB.js

-import { spawn } from 'child_process';
-import { existsSync } from 'fs';
-import { createServer } from 'http';
-import { resolve, join } from 'path';
-
-// src/preview/server.ts
-var HOST_HTML = (uiPort, serverPort) => `<!DOCTYPE html>
-<html>
-<head>
-  <meta charset="utf-8" />
-  <title>Synapse Preview</title>
-  <style>
-    * { margin: 0; padding: 0; box-sizing: border-box; }
-    body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; background: #0f172a; color: #e2e8f0; }
-    header { padding: 12px 20px; background: #1e293b; border-bottom: 1px solid #334155; display: flex; align-items: center; gap: 12px; }
-    header h1 { font-size: 14px; font-weight: 500; }
-    header .dot { width: 8px; height: 8px; border-radius: 50%; background: #22c55e; }
-    header .info { font-size: 12px; color: #94a3b8; margin-left: auto; }
-    .theme-toggle { background: #334155; border: none; color: #e2e8f0; padding: 4px 10px; border-radius: 4px; cursor: pointer; font-size: 12px; }
-    iframe { width: 100%; height: calc(100vh - 45px); border: none; }
-  </style>
-</head>
-<body>
-  <header>
-    <span class="dot"></span>
-    <h1>Synapse Preview</h1>
-    <button class="theme-toggle" id="toggle">Toggle Dark/Light</button>
-    <span class="info">MCP: localhost:${serverPort} | UI: localhost:${uiPort}</span>
-  </header>
-  <iframe id="app" src="http://localhost:${uiPort}"></iframe>
-
-  <script>
-    var iframe = document.getElementById("app");
-    var darkMode = true;
-
-    // Minimal NimbleBrain bridge host \u2014 just enough to make Synapse work
-    var tokens = darkMode ? {
-      "--nb-background": "#0f172a", "--nb-foreground": "#e2e8f0",
-      "--nb-card": "#1e293b", "--nb-card-foreground": "#e2e8f0",
-      "--nb-primary": "#6366f1", "--nb-primary-foreground": "#ffffff",
-      "--nb-muted-foreground": "#94a3b8", "--nb-border": "#334155",
-      "--nb-ring": "#6366f1", "--nb-destructive": "#ef4444",
-      "--nb-radius": "0.5rem",
-    } : {
-      "--nb-background": "#ffffff", "--nb-foreground": "#1a1a1a",
-      "--nb-card": "#f9fafb", "--nb-card-foreground": "#1a1a1a",
-      "--nb-primary": "#6366f1", "--nb-primary-foreground": "#ffffff",
-      "--nb-muted-foreground": "#6b7280", "--nb-border": "#e5e7eb",
-      "--nb-ring": "#6366f1", "--nb-destructive": "#ef4444",
-      "--nb-radius": "0.5rem",
-    };
-
-    function post(msg) { iframe.contentWindow.postMessage(msg, "*"); }
-
-    window.addEventListener("message", async function (event) {
-      if (event.source !== iframe.contentWindow) return;
-      var msg = event.data;
-      if (!msg || typeof msg !== "object") return;
-
-      // ext-apps handshake
-      if (msg.method === "ui/initialize" && msg.id) {
-        post({
-          jsonrpc: "2.0", id: msg.id,
-          result: {
-            protocolVersion: "2026-01-26",
-            serverInfo: { name: "nimblebrain", version: "preview" },
-            capabilities: { openLinks: {}, serverTools: {} },
-            hostContext: { theme: darkMode ? "dark" : "light", primaryColor: "#6366f1", tokens: tokens }
-          }
-        });
-        return;
-      }
-
-      if (msg.method === "ui/notifications/initialized") return;
-
-      // Tool call proxy \u2014 forward to the MCP server
-      if (msg.method === "tools/call" && msg.id) {
-        try {
-          var resp = await fetch("http://localhost:${serverPort}/mcp", {
-            method: "POST",
-            headers: { "Content-Type": "application/json" },
-            body: JSON.stringify({
-              jsonrpc: "2.0", id: msg.id,
-              method: "tools/call",
-              params: { name: msg.params.name, arguments: msg.params.arguments || {} }
-            })
-          });
-          var result = await resp.json();
-          // Forward the JSON-RPC response back to the iframe
-          post(result);
-        } catch (err) {
-          post({ jsonrpc: "2.0", id: msg.id, error: { code: -32000, message: err.message || "Server error" } });
-        }
-        return;
-      }
-
-      // ui/chat \u2014 log to console
-      if (msg.method === "ui/chat") {
-        console.log("[chat]", msg.params?.message);
-        return;
-      }
-
-      // ui/action \u2014 log to console
-      if (msg.method === "ui/action") {
-        console.log("[action]", msg.params?.action, msg.params);
-        return;
-      }
-
-      // ui/keydown \u2014 ignore in preview
-      if (msg.method === "ui/keydown") return;
-
-      // ui/stateChanged \u2014 log
-      if (msg.method === "ui/stateChanged") {
-        console.log("[state]", msg.params?.state);
-        post({ jsonrpc: "2.0", method: "ui/stateAcknowledged", params: { truncated: false } });
-        return;
-      }
-
-      console.log("[bridge] unhandled:", msg.method, msg);
-    });
-
-    // Theme toggle
-    document.getElementById("toggle").addEventListener("click", function () {
-      darkMode = !darkMode;
-      document.body.style.background = darkMode ? "#0f172a" : "#f1f5f9";
-      tokens = darkMode ? {
-        "--nb-background": "#0f172a", "--nb-foreground": "#e2e8f0",
-        "--nb-card": "#1e293b", "--nb-card-foreground": "#e2e8f0",
-        "--nb-primary": "#6366f1", "--nb-primary-foreground": "#ffffff",
-        "--nb-muted-foreground": "#94a3b8", "--nb-border": "#334155",
-        "--nb-ring": "#6366f1", "--nb-destructive": "#ef4444",
-        "--nb-radius": "0.5rem",
-      } : {
-        "--nb-background": "#ffffff", "--nb-foreground": "#1a1a1a",
-        "--nb-card": "#f9fafb", "--nb-card-foreground": "#1a1a1a",
-        "--nb-primary": "#6366f1", "--nb-primary-foreground": "#ffffff",
-        "--nb-muted-foreground": "#6b7280", "--nb-border": "#e5e7eb",
-        "--nb-ring": "#6366f1", "--nb-destructive": "#ef4444",
-        "--nb-radius": "0.5rem",
-      };
-      post({ jsonrpc: "2.0", method: "ui/themeChanged", params: { mode: darkMode ? "dark" : "light", tokens: tokens } });
-    });
-  </script>
-</body>
-</html>`;
-async function startPreview(options) {
-  const { serverCmd, serverPort, uiDir, uiPort, previewPort } = options;
-  const children = [];
-  console.log(`
-  Synapse Preview
-`);
-  console.log(`  [server] ${serverCmd}`);
-  const serverProc = spawn(serverCmd, {
-    shell: true,
-    stdio: ["ignore", "pipe", "pipe"]
-  });
-  children.push(serverProc);
-  serverProc.stdout?.on("data", (d) => process.stdout.write(`  [server] ${d}`));
-  serverProc.stderr?.on("data", (d) => process.stderr.write(`  [server] ${d}`));
-  const resolvedUi = resolve(uiDir);
-  if (!existsSync(join(resolvedUi, "package.json"))) {
-    console.error(`  [ui] Error: no package.json found at ${resolvedUi}`);
-    process.exit(1);
-  }
-  console.log(`  [ui] cd ${resolvedUi} && npx vite --port ${uiPort}`);
-  const uiProc = spawn("npx", ["vite", "--port", String(uiPort)], {
-    cwd: resolvedUi,
-    stdio: ["ignore", "pipe", "pipe"]
-  });
-  children.push(uiProc);
-  uiProc.stdout?.on("data", (d) => process.stdout.write(`  [ui] ${d}`));
-  uiProc.stderr?.on("data", (d) => process.stderr.write(`  [ui] ${d}`));
-  const html = HOST_HTML(uiPort, serverPort);
-  const host = createServer((_req, res) => {
-    res.writeHead(200, { "Content-Type": "text/html" });
-    res.end(html);
-  });
-  host.listen(previewPort, () => {
-    console.log(`
-  Preview:  http://localhost:${previewPort}`);
-    console.log(`  UI:       http://localhost:${uiPort}`);
-    console.log(`  Server:   http://localhost:${serverPort}`);
-    console.log(`
-  Press Ctrl+C to stop.
-`);
-  });
-  const shutdown = () => {
-    console.log("\n  Shutting down...");
-    host.close();
-    for (const child of children) {
-      try {
-        child.kill("SIGTERM");
-      } catch {
-      }
-    }
-    process.exit(0);
-  };
-  process.on("SIGINT", shutdown);
-  process.on("SIGTERM", shutdown);
-}
-
-export { startPreview };
-//# sourceMappingURL=server-RUCX2TIB.js.map
-//# sourceMappingURL=server-RUCX2TIB.js.map

dist/server-RUCX2TIB.js.map

-{"version":3,"sources":["../src/preview/server.ts"],"names":[],"mappings":"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","file":"server-RUCX2TIB.js","sourcesContent":["/**\n * Synapse Preview — standalone dev harness for MCP apps with UIs.\n *\n * Starts the MCP server (HTTP mode) and a minimal bridge host page\n * that iframes the app UI and proxies tool calls to the server.\n *\n * Usage:\n *   npx synapse preview --server \"uv run uvicorn mcp_hello.server:app --port 8001\" --ui ./ui\n *   npx synapse preview --server \"node dist/index.js\" --ui ./ui --server-port 8001\n */\n\nimport { type ChildProcess, spawn } from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\nimport { createServer, type IncomingMessage, type ServerResponse } from \"node:http\";\nimport { join, resolve } from \"node:path\";\n\nexport interface PreviewOptions {\n  /** Shell command to start the MCP server in HTTP mode */\n  serverCmd: string;\n  /** Port the MCP server listens on (default: 8001) */\n  serverPort: number;\n  /** Path to the UI directory (must have package.json with dev script) */\n  uiDir: string;\n  /** Port for the UI Vite dev server (default: 5173) */\n  uiPort: number;\n  /** Port for the preview harness (default: 5180) */\n  previewPort: number;\n}\n\nconst HOST_HTML = (uiPort: number, serverPort: number) => `<!DOCTYPE html>\n<html>\n<head>\n  <meta charset=\"utf-8\" />\n  <title>Synapse Preview</title>\n  <style>\n    * { margin: 0; padding: 0; box-sizing: border-box; }\n    body { font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif; background: #0f172a; color: #e2e8f0; }\n    header { padding: 12px 20px; background: #1e293b; border-bottom: 1px solid #334155; display: flex; align-items: center; gap: 12px; }\n    header h1 { font-size: 14px; font-weight: 500; }\n    header .dot { width: 8px; height: 8px; border-radius: 50%; background: #22c55e; }\n    header .info { font-size: 12px; color: #94a3b8; margin-left: auto; }\n    .theme-toggle { background: #334155; border: none; color: #e2e8f0; padding: 4px 10px; border-radius: 4px; cursor: pointer; font-size: 12px; }\n    iframe { width: 100%; height: calc(100vh - 45px); border: none; }\n  </style>\n</head>\n<body>\n  <header>\n    <span class=\"dot\"></span>\n    <h1>Synapse Preview</h1>\n    <button class=\"theme-toggle\" id=\"toggle\">Toggle Dark/Light</button>\n    <span class=\"info\">MCP: localhost:${serverPort} | UI: localhost:${uiPort}</span>\n  </header>\n  <iframe id=\"app\" src=\"http://localhost:${uiPort}\"></iframe>\n\n  <script>\n    var iframe = document.getElementById(\"app\");\n    var darkMode = true;\n\n    // Minimal NimbleBrain bridge host — just enough to make Synapse work\n    var tokens = darkMode ? {\n      \"--nb-background\": \"#0f172a\", \"--nb-foreground\": \"#e2e8f0\",\n      \"--nb-card\": \"#1e293b\", \"--nb-card-foreground\": \"#e2e8f0\",\n      \"--nb-primary\": \"#6366f1\", \"--nb-primary-foreground\": \"#ffffff\",\n      \"--nb-muted-foreground\": \"#94a3b8\", \"--nb-border\": \"#334155\",\n      \"--nb-ring\": \"#6366f1\", \"--nb-destructive\": \"#ef4444\",\n      \"--nb-radius\": \"0.5rem\",\n    } : {\n      \"--nb-background\": \"#ffffff\", \"--nb-foreground\": \"#1a1a1a\",\n      \"--nb-card\": \"#f9fafb\", \"--nb-card-foreground\": \"#1a1a1a\",\n      \"--nb-primary\": \"#6366f1\", \"--nb-primary-foreground\": \"#ffffff\",\n      \"--nb-muted-foreground\": \"#6b7280\", \"--nb-border\": \"#e5e7eb\",\n      \"--nb-ring\": \"#6366f1\", \"--nb-destructive\": \"#ef4444\",\n      \"--nb-radius\": \"0.5rem\",\n    };\n\n    function post(msg) { iframe.contentWindow.postMessage(msg, \"*\"); }\n\n    window.addEventListener(\"message\", async function (event) {\n      if (event.source !== iframe.contentWindow) return;\n      var msg = event.data;\n      if (!msg || typeof msg !== \"object\") return;\n\n      // ext-apps handshake\n      if (msg.method === \"ui/initialize\" && msg.id) {\n        post({\n          jsonrpc: \"2.0\", id: msg.id,\n          result: {\n            protocolVersion: \"2026-01-26\",\n            serverInfo: { name: \"nimblebrain\", version: \"preview\" },\n            capabilities: { openLinks: {}, serverTools: {} },\n            hostContext: { theme: darkMode ? \"dark\" : \"light\", primaryColor: \"#6366f1\", tokens: tokens }\n          }\n        });\n        return;\n      }\n\n      if (msg.method === \"ui/notifications/initialized\") return;\n\n      // Tool call proxy — forward to the MCP server\n      if (msg.method === \"tools/call\" && msg.id) {\n        try {\n          var resp = await fetch(\"http://localhost:${serverPort}/mcp\", {\n            method: \"POST\",\n            headers: { \"Content-Type\": \"application/json\" },\n            body: JSON.stringify({\n              jsonrpc: \"2.0\", id: msg.id,\n              method: \"tools/call\",\n              params: { name: msg.params.name, arguments: msg.params.arguments || {} }\n            })\n          });\n          var result = await resp.json();\n          // Forward the JSON-RPC response back to the iframe\n          post(result);\n        } catch (err) {\n          post({ jsonrpc: \"2.0\", id: msg.id, error: { code: -32000, message: err.message || \"Server error\" } });\n        }\n        return;\n      }\n\n      // ui/chat — log to console\n      if (msg.method === \"ui/chat\") {\n        console.log(\"[chat]\", msg.params?.message);\n        return;\n      }\n\n      // ui/action — log to console\n      if (msg.method === \"ui/action\") {\n        console.log(\"[action]\", msg.params?.action, msg.params);\n        return;\n      }\n\n      // ui/keydown — ignore in preview\n      if (msg.method === \"ui/keydown\") return;\n\n      // ui/stateChanged — log\n      if (msg.method === \"ui/stateChanged\") {\n        console.log(\"[state]\", msg.params?.state);\n        post({ jsonrpc: \"2.0\", method: \"ui/stateAcknowledged\", params: { truncated: false } });\n        return;\n      }\n\n      console.log(\"[bridge] unhandled:\", msg.method, msg);\n    });\n\n    // Theme toggle\n    document.getElementById(\"toggle\").addEventListener(\"click\", function () {\n      darkMode = !darkMode;\n      document.body.style.background = darkMode ? \"#0f172a\" : \"#f1f5f9\";\n      tokens = darkMode ? {\n        \"--nb-background\": \"#0f172a\", \"--nb-foreground\": \"#e2e8f0\",\n        \"--nb-card\": \"#1e293b\", \"--nb-card-foreground\": \"#e2e8f0\",\n        \"--nb-primary\": \"#6366f1\", \"--nb-primary-foreground\": \"#ffffff\",\n        \"--nb-muted-foreground\": \"#94a3b8\", \"--nb-border\": \"#334155\",\n        \"--nb-ring\": \"#6366f1\", \"--nb-destructive\": \"#ef4444\",\n        \"--nb-radius\": \"0.5rem\",\n      } : {\n        \"--nb-background\": \"#ffffff\", \"--nb-foreground\": \"#1a1a1a\",\n        \"--nb-card\": \"#f9fafb\", \"--nb-card-foreground\": \"#1a1a1a\",\n        \"--nb-primary\": \"#6366f1\", \"--nb-primary-foreground\": \"#ffffff\",\n        \"--nb-muted-foreground\": \"#6b7280\", \"--nb-border\": \"#e5e7eb\",\n        \"--nb-ring\": \"#6366f1\", \"--nb-destructive\": \"#ef4444\",\n        \"--nb-radius\": \"0.5rem\",\n      };\n      post({ jsonrpc: \"2.0\", method: \"ui/themeChanged\", params: { mode: darkMode ? \"dark\" : \"light\", tokens: tokens } });\n    });\n  </script>\n</body>\n</html>`;\n\nexport async function startPreview(options: PreviewOptions): Promise<void> {\n  const { serverCmd, serverPort, uiDir, uiPort, previewPort } = options;\n  const children: ChildProcess[] = [];\n\n  console.log(`\\n  Synapse Preview\\n`);\n\n  // 1. Start MCP server\n  console.log(`  [server] ${serverCmd}`);\n  const serverProc = spawn(serverCmd, {\n    shell: true,\n    stdio: [\"ignore\", \"pipe\", \"pipe\"],\n  });\n  children.push(serverProc);\n  serverProc.stdout?.on(\"data\", (d: Buffer) => process.stdout.write(`  [server] ${d}`));\n  serverProc.stderr?.on(\"data\", (d: Buffer) => process.stderr.write(`  [server] ${d}`));\n\n  // 2. Start UI Vite dev server\n  const resolvedUi = resolve(uiDir);\n  if (!existsSync(join(resolvedUi, \"package.json\"))) {\n    console.error(`  [ui] Error: no package.json found at ${resolvedUi}`);\n    process.exit(1);\n  }\n  console.log(`  [ui] cd ${resolvedUi} && npx vite --port ${uiPort}`);\n  const uiProc = spawn(\"npx\", [\"vite\", \"--port\", String(uiPort)], {\n    cwd: resolvedUi,\n    stdio: [\"ignore\", \"pipe\", \"pipe\"],\n  });\n  children.push(uiProc);\n  uiProc.stdout?.on(\"data\", (d: Buffer) => process.stdout.write(`  [ui] ${d}`));\n  uiProc.stderr?.on(\"data\", (d: Buffer) => process.stderr.write(`  [ui] ${d}`));\n\n  // 3. Start preview host\n  const html = HOST_HTML(uiPort, serverPort);\n  const host = createServer((_req: IncomingMessage, res: ServerResponse) => {\n    res.writeHead(200, { \"Content-Type\": \"text/html\" });\n    res.end(html);\n  });\n  host.listen(previewPort, () => {\n    console.log(`\\n  Preview:  http://localhost:${previewPort}`);\n    console.log(`  UI:       http://localhost:${uiPort}`);\n    console.log(`  Server:   http://localhost:${serverPort}`);\n    console.log(`\\n  Press Ctrl+C to stop.\\n`);\n  });\n\n  // Shutdown\n  const shutdown = () => {\n    console.log(\"\\n  Shutting down...\");\n    host.close();\n    for (const child of children) {\n      try {\n        child.kill(\"SIGTERM\");\n      } catch {\n        /* already dead */\n      }\n    }\n    process.exit(0);\n  };\n  process.on(\"SIGINT\", shutdown);\n  process.on(\"SIGTERM\", shutdown);\n}\n"]}

dist/server-SEI7XI3B.cjs

-'use strict';
-
-var child_process = require('child_process');
-var fs = require('fs');
-var http = require('http');
-var path = require('path');
-
-// src/preview/server.ts
-var HOST_HTML = (uiPort, serverPort) => `<!DOCTYPE html>
-<html>
-<head>
-  <meta charset="utf-8" />
-  <title>Synapse Preview</title>
-  <style>
-    * { margin: 0; padding: 0; box-sizing: border-box; }
-    body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; background: #0f172a; color: #e2e8f0; }
-    header { padding: 12px 20px; background: #1e293b; border-bottom: 1px solid #334155; display: flex; align-items: center; gap: 12px; }
-    header h1 { font-size: 14px; font-weight: 500; }
-    header .dot { width: 8px; height: 8px; border-radius: 50%; background: #22c55e; }
-    header .info { font-size: 12px; color: #94a3b8; margin-left: auto; }
-    .theme-toggle { background: #334155; border: none; color: #e2e8f0; padding: 4px 10px; border-radius: 4px; cursor: pointer; font-size: 12px; }
-    iframe { width: 100%; height: calc(100vh - 45px); border: none; }
-  </style>
-</head>
-<body>
-  <header>
-    <span class="dot"></span>
-    <h1>Synapse Preview</h1>
-    <button class="theme-toggle" id="toggle">Toggle Dark/Light</button>
-    <span class="info">MCP: localhost:${serverPort} | UI: localhost:${uiPort}</span>
-  </header>
-  <iframe id="app" src="http://localhost:${uiPort}"></iframe>
-
-  <script>
-    var iframe = document.getElementById("app");
-    var darkMode = true;
-
-    // Minimal NimbleBrain bridge host \u2014 just enough to make Synapse work
-    var tokens = darkMode ? {
-      "--nb-background": "#0f172a", "--nb-foreground": "#e2e8f0",
-      "--nb-card": "#1e293b", "--nb-card-foreground": "#e2e8f0",
-      "--nb-primary": "#6366f1", "--nb-primary-foreground": "#ffffff",
-      "--nb-muted-foreground": "#94a3b8", "--nb-border": "#334155",
-      "--nb-ring": "#6366f1", "--nb-destructive": "#ef4444",
-      "--nb-radius": "0.5rem",
-    } : {
-      "--nb-background": "#ffffff", "--nb-foreground": "#1a1a1a",
-      "--nb-card": "#f9fafb", "--nb-card-foreground": "#1a1a1a",
-      "--nb-primary": "#6366f1", "--nb-primary-foreground": "#ffffff",
-      "--nb-muted-foreground": "#6b7280", "--nb-border": "#e5e7eb",
-      "--nb-ring": "#6366f1", "--nb-destructive": "#ef4444",
-      "--nb-radius": "0.5rem",
-    };
-
-    function post(msg) { iframe.contentWindow.postMessage(msg, "*"); }
-
-    window.addEventListener("message", async function (event) {
-      if (event.source !== iframe.contentWindow) return;
-      var msg = event.data;
-      if (!msg || typeof msg !== "object") return;
-
-      // ext-apps handshake
-      if (msg.method === "ui/initialize" && msg.id) {
-        post({
-          jsonrpc: "2.0", id: msg.id,
-          result: {
-            protocolVersion: "2026-01-26",
-            serverInfo: { name: "nimblebrain", version: "preview" },
-            capabilities: { openLinks: {}, serverTools: {} },
-            hostContext: { theme: darkMode ? "dark" : "light", primaryColor: "#6366f1", tokens: tokens }
-          }
-        });
-        return;
-      }
-
-      if (msg.method === "ui/notifications/initialized") return;
-
-      // Tool call proxy \u2014 forward to the MCP server
-      if (msg.method === "tools/call" && msg.id) {
-        try {
-          var resp = await fetch("http://localhost:${serverPort}/mcp", {
-            method: "POST",
-            headers: { "Content-Type": "application/json" },
-            body: JSON.stringify({
-              jsonrpc: "2.0", id: msg.id,
-              method: "tools/call",
-              params: { name: msg.params.name, arguments: msg.params.arguments || {} }
-            })
-          });
-          var result = await resp.json();
-          // Forward the JSON-RPC response back to the iframe
-          post(result);
-        } catch (err) {
-          post({ jsonrpc: "2.0", id: msg.id, error: { code: -32000, message: err.message || "Server error" } });
-        }
-        return;
-      }
-
-      // ui/chat \u2014 log to console
-      if (msg.method === "ui/chat") {
-        console.log("[chat]", msg.params?.message);
-        return;
-      }
-
-      // ui/action \u2014 log to console
-      if (msg.method === "ui/action") {
-        console.log("[action]", msg.params?.action, msg.params);
-        return;
-      }
-
-      // ui/keydown \u2014 ignore in preview
-      if (msg.method === "ui/keydown") return;
-
-      // ui/stateChanged \u2014 log
-      if (msg.method === "ui/stateChanged") {
-        console.log("[state]", msg.params?.state);
-        post({ jsonrpc: "2.0", method: "ui/stateAcknowledged", params: { truncated: false } });
-        return;
-      }
-
-      console.log("[bridge] unhandled:", msg.method, msg);
-    });
-
-    // Theme toggle
-    document.getElementById("toggle").addEventListener("click", function () {
-      darkMode = !darkMode;
-      document.body.style.background = darkMode ? "#0f172a" : "#f1f5f9";
-      tokens = darkMode ? {
-        "--nb-background": "#0f172a", "--nb-foreground": "#e2e8f0",
-        "--nb-card": "#1e293b", "--nb-card-foreground": "#e2e8f0",
-        "--nb-primary": "#6366f1", "--nb-primary-foreground": "#ffffff",
-        "--nb-muted-foreground": "#94a3b8", "--nb-border": "#334155",
-        "--nb-ring": "#6366f1", "--nb-destructive": "#ef4444",
-        "--nb-radius": "0.5rem",
-      } : {
-        "--nb-background": "#ffffff", "--nb-foreground": "#1a1a1a",
-        "--nb-card": "#f9fafb", "--nb-card-foreground": "#1a1a1a",
-        "--nb-primary": "#6366f1", "--nb-primary-foreground": "#ffffff",
-        "--nb-muted-foreground": "#6b7280", "--nb-border": "#e5e7eb",
-        "--nb-ring": "#6366f1", "--nb-destructive": "#ef4444",
-        "--nb-radius": "0.5rem",
-      };
-      post({ jsonrpc: "2.0", method: "ui/themeChanged", params: { mode: darkMode ? "dark" : "light", tokens: tokens } });
-    });
-  </script>
-</body>
-</html>`;
-async function startPreview(options) {
-  const { serverCmd, serverPort, uiDir, uiPort, previewPort } = options;
-  const children = [];
-  console.log(`
-  Synapse Preview
-`);
-  console.log(`  [server] ${serverCmd}`);
-  const serverProc = child_process.spawn(serverCmd, {
-    shell: true,
-    stdio: ["ignore", "pipe", "pipe"]
-  });
-  children.push(serverProc);
-  serverProc.stdout?.on("data", (d) => process.stdout.write(`  [server] ${d}`));
-  serverProc.stderr?.on("data", (d) => process.stderr.write(`  [server] ${d}`));
-  const resolvedUi = path.resolve(uiDir);
-  if (!fs.existsSync(path.join(resolvedUi, "package.json"))) {
-    console.error(`  [ui] Error: no package.json found at ${resolvedUi}`);
-    process.exit(1);
-  }
-  console.log(`  [ui] cd ${resolvedUi} && npx vite --port ${uiPort}`);
-  const uiProc = child_process.spawn("npx", ["vite", "--port", String(uiPort)], {
-    cwd: resolvedUi,
-    stdio: ["ignore", "pipe", "pipe"]
-  });
-  children.push(uiProc);
-  uiProc.stdout?.on("data", (d) => process.stdout.write(`  [ui] ${d}`));
-  uiProc.stderr?.on("data", (d) => process.stderr.write(`  [ui] ${d}`));
-  const html = HOST_HTML(uiPort, serverPort);
-  const host = http.createServer((_req, res) => {
-    res.writeHead(200, { "Content-Type": "text/html" });
-    res.end(html);
-  });
-  host.listen(previewPort, () => {
-    console.log(`
-  Preview:  http://localhost:${previewPort}`);
-    console.log(`  UI:       http://localhost:${uiPort}`);
-    console.log(`  Server:   http://localhost:${serverPort}`);
-    console.log(`
-  Press Ctrl+C to stop.
-`);
-  });
-  const shutdown = () => {
-    console.log("\n  Shutting down...");
-    host.close();
-    for (const child of children) {
-      try {
-        child.kill("SIGTERM");
-      } catch {
-      }
-    }
-    process.exit(0);
-  };
-  process.on("SIGINT", shutdown);
-  process.on("SIGTERM", shutdown);
-}
-
-exports.startPreview = startPreview;
-//# sourceMappingURL=server-SEI7XI3B.cjs.map
-//# sourceMappingURL=server-SEI7XI3B.cjs.map

dist/server-SEI7XI3B.cjs.map

-{"version":3,"sources":["../src/preview/server.ts"],"names":["spawn","resolve","existsSync","join","createServer"],"mappings":"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","file":"server-SEI7XI3B.cjs","sourcesContent":["/**\n * Synapse Preview — standalone dev harness for MCP apps with UIs.\n *\n * Starts the MCP server (HTTP mode) and a minimal bridge host page\n * that iframes the app UI and proxies tool calls to the server.\n *\n * Usage:\n *   npx synapse preview --server \"uv run uvicorn mcp_hello.server:app --port 8001\" --ui ./ui\n *   npx synapse preview --server \"node dist/index.js\" --ui ./ui --server-port 8001\n */\n\nimport { type ChildProcess, spawn } from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\nimport { createServer, type IncomingMessage, type ServerResponse } from \"node:http\";\nimport { join, resolve } from \"node:path\";\n\nexport interface PreviewOptions {\n  /** Shell command to start the MCP server in HTTP mode */\n  serverCmd: string;\n  /** Port the MCP server listens on (default: 8001) */\n  serverPort: number;\n  /** Path to the UI directory (must have package.json with dev script) */\n  uiDir: string;\n  /** Port for the UI Vite dev server (default: 5173) */\n  uiPort: number;\n  /** Port for the preview harness (default: 5180) */\n  previewPort: number;\n}\n\nconst HOST_HTML = (uiPort: number, serverPort: number) => `<!DOCTYPE html>\n<html>\n<head>\n  <meta charset=\"utf-8\" />\n  <title>Synapse Preview</title>\n  <style>\n    * { margin: 0; padding: 0; box-sizing: border-box; }\n    body { font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif; background: #0f172a; color: #e2e8f0; }\n    header { padding: 12px 20px; background: #1e293b; border-bottom: 1px solid #334155; display: flex; align-items: center; gap: 12px; }\n    header h1 { font-size: 14px; font-weight: 500; }\n    header .dot { width: 8px; height: 8px; border-radius: 50%; background: #22c55e; }\n    header .info { font-size: 12px; color: #94a3b8; margin-left: auto; }\n    .theme-toggle { background: #334155; border: none; color: #e2e8f0; padding: 4px 10px; border-radius: 4px; cursor: pointer; font-size: 12px; }\n    iframe { width: 100%; height: calc(100vh - 45px); border: none; }\n  </style>\n</head>\n<body>\n  <header>\n    <span class=\"dot\"></span>\n    <h1>Synapse Preview</h1>\n    <button class=\"theme-toggle\" id=\"toggle\">Toggle Dark/Light</button>\n    <span class=\"info\">MCP: localhost:${serverPort} | UI: localhost:${uiPort}</span>\n  </header>\n  <iframe id=\"app\" src=\"http://localhost:${uiPort}\"></iframe>\n\n  <script>\n    var iframe = document.getElementById(\"app\");\n    var darkMode = true;\n\n    // Minimal NimbleBrain bridge host — just enough to make Synapse work\n    var tokens = darkMode ? {\n      \"--nb-background\": \"#0f172a\", \"--nb-foreground\": \"#e2e8f0\",\n      \"--nb-card\": \"#1e293b\", \"--nb-card-foreground\": \"#e2e8f0\",\n      \"--nb-primary\": \"#6366f1\", \"--nb-primary-foreground\": \"#ffffff\",\n      \"--nb-muted-foreground\": \"#94a3b8\", \"--nb-border\": \"#334155\",\n      \"--nb-ring\": \"#6366f1\", \"--nb-destructive\": \"#ef4444\",\n      \"--nb-radius\": \"0.5rem\",\n    } : {\n      \"--nb-background\": \"#ffffff\", \"--nb-foreground\": \"#1a1a1a\",\n      \"--nb-card\": \"#f9fafb\", \"--nb-card-foreground\": \"#1a1a1a\",\n      \"--nb-primary\": \"#6366f1\", \"--nb-primary-foreground\": \"#ffffff\",\n      \"--nb-muted-foreground\": \"#6b7280\", \"--nb-border\": \"#e5e7eb\",\n      \"--nb-ring\": \"#6366f1\", \"--nb-destructive\": \"#ef4444\",\n      \"--nb-radius\": \"0.5rem\",\n    };\n\n    function post(msg) { iframe.contentWindow.postMessage(msg, \"*\"); }\n\n    window.addEventListener(\"message\", async function (event) {\n      if (event.source !== iframe.contentWindow) return;\n      var msg = event.data;\n      if (!msg || typeof msg !== \"object\") return;\n\n      // ext-apps handshake\n      if (msg.method === \"ui/initialize\" && msg.id) {\n        post({\n          jsonrpc: \"2.0\", id: msg.id,\n          result: {\n            protocolVersion: \"2026-01-26\",\n            serverInfo: { name: \"nimblebrain\", version: \"preview\" },\n            capabilities: { openLinks: {}, serverTools: {} },\n            hostContext: { theme: darkMode ? \"dark\" : \"light\", primaryColor: \"#6366f1\", tokens: tokens }\n          }\n        });\n        return;\n      }\n\n      if (msg.method === \"ui/notifications/initialized\") return;\n\n      // Tool call proxy — forward to the MCP server\n      if (msg.method === \"tools/call\" && msg.id) {\n        try {\n          var resp = await fetch(\"http://localhost:${serverPort}/mcp\", {\n            method: \"POST\",\n            headers: { \"Content-Type\": \"application/json\" },\n            body: JSON.stringify({\n              jsonrpc: \"2.0\", id: msg.id,\n              method: \"tools/call\",\n              params: { name: msg.params.name, arguments: msg.params.arguments || {} }\n            })\n          });\n          var result = await resp.json();\n          // Forward the JSON-RPC response back to the iframe\n          post(result);\n        } catch (err) {\n          post({ jsonrpc: \"2.0\", id: msg.id, error: { code: -32000, message: err.message || \"Server error\" } });\n        }\n        return;\n      }\n\n      // ui/chat — log to console\n      if (msg.method === \"ui/chat\") {\n        console.log(\"[chat]\", msg.params?.message);\n        return;\n      }\n\n      // ui/action — log to console\n      if (msg.method === \"ui/action\") {\n        console.log(\"[action]\", msg.params?.action, msg.params);\n        return;\n      }\n\n      // ui/keydown — ignore in preview\n      if (msg.method === \"ui/keydown\") return;\n\n      // ui/stateChanged — log\n      if (msg.method === \"ui/stateChanged\") {\n        console.log(\"[state]\", msg.params?.state);\n        post({ jsonrpc: \"2.0\", method: \"ui/stateAcknowledged\", params: { truncated: false } });\n        return;\n      }\n\n      console.log(\"[bridge] unhandled:\", msg.method, msg);\n    });\n\n    // Theme toggle\n    document.getElementById(\"toggle\").addEventListener(\"click\", function () {\n      darkMode = !darkMode;\n      document.body.style.background = darkMode ? \"#0f172a\" : \"#f1f5f9\";\n      tokens = darkMode ? {\n        \"--nb-background\": \"#0f172a\", \"--nb-foreground\": \"#e2e8f0\",\n        \"--nb-card\": \"#1e293b\", \"--nb-card-foreground\": \"#e2e8f0\",\n        \"--nb-primary\": \"#6366f1\", \"--nb-primary-foreground\": \"#ffffff\",\n        \"--nb-muted-foreground\": \"#94a3b8\", \"--nb-border\": \"#334155\",\n        \"--nb-ring\": \"#6366f1\", \"--nb-destructive\": \"#ef4444\",\n        \"--nb-radius\": \"0.5rem\",\n      } : {\n        \"--nb-background\": \"#ffffff\", \"--nb-foreground\": \"#1a1a1a\",\n        \"--nb-card\": \"#f9fafb\", \"--nb-card-foreground\": \"#1a1a1a\",\n        \"--nb-primary\": \"#6366f1\", \"--nb-primary-foreground\": \"#ffffff\",\n        \"--nb-muted-foreground\": \"#6b7280\", \"--nb-border\": \"#e5e7eb\",\n        \"--nb-ring\": \"#6366f1\", \"--nb-destructive\": \"#ef4444\",\n        \"--nb-radius\": \"0.5rem\",\n      };\n      post({ jsonrpc: \"2.0\", method: \"ui/themeChanged\", params: { mode: darkMode ? \"dark\" : \"light\", tokens: tokens } });\n    });\n  </script>\n</body>\n</html>`;\n\nexport async function startPreview(options: PreviewOptions): Promise<void> {\n  const { serverCmd, serverPort, uiDir, uiPort, previewPort } = options;\n  const children: ChildProcess[] = [];\n\n  console.log(`\\n  Synapse Preview\\n`);\n\n  // 1. Start MCP server\n  console.log(`  [server] ${serverCmd}`);\n  const serverProc = spawn(serverCmd, {\n    shell: true,\n    stdio: [\"ignore\", \"pipe\", \"pipe\"],\n  });\n  children.push(serverProc);\n  serverProc.stdout?.on(\"data\", (d: Buffer) => process.stdout.write(`  [server] ${d}`));\n  serverProc.stderr?.on(\"data\", (d: Buffer) => process.stderr.write(`  [server] ${d}`));\n\n  // 2. Start UI Vite dev server\n  const resolvedUi = resolve(uiDir);\n  if (!existsSync(join(resolvedUi, \"package.json\"))) {\n    console.error(`  [ui] Error: no package.json found at ${resolvedUi}`);\n    process.exit(1);\n  }\n  console.log(`  [ui] cd ${resolvedUi} && npx vite --port ${uiPort}`);\n  const uiProc = spawn(\"npx\", [\"vite\", \"--port\", String(uiPort)], {\n    cwd: resolvedUi,\n    stdio: [\"ignore\", \"pipe\", \"pipe\"],\n  });\n  children.push(uiProc);\n  uiProc.stdout?.on(\"data\", (d: Buffer) => process.stdout.write(`  [ui] ${d}`));\n  uiProc.stderr?.on(\"data\", (d: Buffer) => process.stderr.write(`  [ui] ${d}`));\n\n  // 3. Start preview host\n  const html = HOST_HTML(uiPort, serverPort);\n  const host = createServer((_req: IncomingMessage, res: ServerResponse) => {\n    res.writeHead(200, { \"Content-Type\": \"text/html\" });\n    res.end(html);\n  });\n  host.listen(previewPort, () => {\n    console.log(`\\n  Preview:  http://localhost:${previewPort}`);\n    console.log(`  UI:       http://localhost:${uiPort}`);\n    console.log(`  Server:   http://localhost:${serverPort}`);\n    console.log(`\\n  Press Ctrl+C to stop.\\n`);\n  });\n\n  // Shutdown\n  const shutdown = () => {\n    console.log(\"\\n  Shutting down...\");\n    host.close();\n    for (const child of children) {\n      try {\n        child.kill(\"SIGTERM\");\n      } catch {\n        /* already dead */\n      }\n    }\n    process.exit(0);\n  };\n  process.on(\"SIGINT\", shutdown);\n  process.on(\"SIGTERM\", shutdown);\n}\n"]}

dist/types-BP0SNrpo.d.cts

-interface SynapseOptions {
-    /** App name — must match the bundle name registered with the host */
-    name: string;
-    /** Semver version string */
-    version: string;
-    /**
-     * Mark as internal NimbleBrain app. Enables cross-server tool calls.
-     * External apps MUST NOT set this.
-     */
-    internal?: boolean;
-    /** Key combos to forward from iframe to host. Default: all Ctrl/Cmd combos + Escape. */
-    forwardKeys?: KeyForwardConfig[];
-}
-interface SynapseTheme {
-    mode: "light" | "dark";
-    primaryColor: string;
-    tokens: Record<string, string>;
-}
-interface DataChangedEvent {
-    source: "agent";
-    server: string;
-    tool: string;
-}
-interface ToolCallResult<T = unknown> {
-    data: T;
-    isError: boolean;
-}
-interface Synapse {
-    readonly ready: Promise<void>;
-    readonly isNimbleBrainHost: boolean;
-    callTool<TInput = Record<string, unknown>, TOutput = unknown>(name: string, args?: TInput): Promise<ToolCallResult<TOutput>>;
-    onDataChanged(callback: (event: DataChangedEvent) => void): () => void;
-    getTheme(): SynapseTheme;
-    onThemeChanged(callback: (theme: SynapseTheme) => void): () => void;
-    action(action: string, params?: Record<string, unknown>): void;
-    chat(message: string, context?: {
-        action?: string;
-        entity?: string;
-    }): void;
-    setVisibleState(state: Record<string, unknown>, summary?: string): void;
-    downloadFile(filename: string, content: string | Blob, mimeType?: string): void;
-    openLink(url: string): void;
-    /** @internal — used by createStore for ui/stateLoaded */
-    _onMessage(method: string, callback: (params: Record<string, unknown> | undefined) => void): () => void;
-    /** @internal — used by createStore for ui/persistState */
-    _request(method: string, params?: Record<string, unknown>): Promise<unknown>;
-    destroy(): void;
-}
-interface VisibleState {
-    state: Record<string, unknown>;
-    summary?: string;
-}
-interface StateAcknowledgement {
-    truncated: boolean;
-}
-type ActionReducer<TState, TPayload = unknown> = (state: TState, payload: TPayload) => TState;
-interface StoreConfig<TState> {
-    initialState: TState;
-    actions: Record<string, ActionReducer<TState, any>>;
-    persist?: boolean;
-    visibleToAgent?: boolean;
-    summarize?: (state: TState) => string;
-    version?: number;
-    migrations?: Array<(oldState: any) => any>;
-}
-type StoreDispatch<TActions extends Record<string, ActionReducer<any, any>>> = {
-    [K in keyof TActions]: Parameters<TActions[K]>[1] extends undefined ? () => void : (payload: Parameters<TActions[K]>[1]) => void;
-};
-interface Store<TState, TActions extends Record<string, ActionReducer<TState, any>> = Record<string, ActionReducer<TState, any>>> {
-    getState(): TState;
-    subscribe(callback: (state: TState) => void): () => void;
-    dispatch: StoreDispatch<TActions>;
-    hydrate(state: TState): void;
-    destroy(): void;
-}
-interface KeyForwardConfig {
-    key: string;
-    ctrl?: boolean;
-    meta?: boolean;
-    shift?: boolean;
-    alt?: boolean;
-}
-interface ToolDefinition {
-    name: string;
-    description?: string;
-    inputSchema: Record<string, unknown>;
-    outputSchema?: Record<string, unknown>;
-}
-interface HostInfo {
-    isNimbleBrain: boolean;
-    serverName: string;
-    protocolVersion: string;
-    theme: SynapseTheme;
-}
-
-export type { ActionReducer as A, DataChangedEvent as D, HostInfo as H, KeyForwardConfig as K, SynapseOptions as S, ToolCallResult as T, VisibleState as V, Synapse as a, StoreConfig as b, Store as c, StateAcknowledgement as d, StoreDispatch as e, SynapseTheme as f, ToolDefinition as g };

dist/types-BP0SNrpo.d.ts

-interface SynapseOptions {
-    /** App name — must match the bundle name registered with the host */
-    name: string;
-    /** Semver version string */
-    version: string;
-    /**
-     * Mark as internal NimbleBrain app. Enables cross-server tool calls.
-     * External apps MUST NOT set this.
-     */
-    internal?: boolean;
-    /** Key combos to forward from iframe to host. Default: all Ctrl/Cmd combos + Escape. */
-    forwardKeys?: KeyForwardConfig[];
-}
-interface SynapseTheme {
-    mode: "light" | "dark";
-    primaryColor: string;
-    tokens: Record<string, string>;
-}
-interface DataChangedEvent {
-    source: "agent";
-    server: string;
-    tool: string;
-}
-interface ToolCallResult<T = unknown> {
-    data: T;
-    isError: boolean;
-}
-interface Synapse {
-    readonly ready: Promise<void>;
-    readonly isNimbleBrainHost: boolean;
-    callTool<TInput = Record<string, unknown>, TOutput = unknown>(name: string, args?: TInput): Promise<ToolCallResult<TOutput>>;
-    onDataChanged(callback: (event: DataChangedEvent) => void): () => void;
-    getTheme(): SynapseTheme;
-    onThemeChanged(callback: (theme: SynapseTheme) => void): () => void;
-    action(action: string, params?: Record<string, unknown>): void;
-    chat(message: string, context?: {
-        action?: string;
-        entity?: string;
-    }): void;
-    setVisibleState(state: Record<string, unknown>, summary?: string): void;
-    downloadFile(filename: string, content: string | Blob, mimeType?: string): void;
-    openLink(url: string): void;
-    /** @internal — used by createStore for ui/stateLoaded */
-    _onMessage(method: string, callback: (params: Record<string, unknown> | undefined) => void): () => void;
-    /** @internal — used by createStore for ui/persistState */
-    _request(method: string, params?: Record<string, unknown>): Promise<unknown>;
-    destroy(): void;
-}
-interface VisibleState {
-    state: Record<string, unknown>;
-    summary?: string;
-}
-interface StateAcknowledgement {
-    truncated: boolean;
-}
-type ActionReducer<TState, TPayload = unknown> = (state: TState, payload: TPayload) => TState;
-interface StoreConfig<TState> {
-    initialState: TState;
-    actions: Record<string, ActionReducer<TState, any>>;
-    persist?: boolean;
-    visibleToAgent?: boolean;
-    summarize?: (state: TState) => string;
-    version?: number;
-    migrations?: Array<(oldState: any) => any>;
-}
-type StoreDispatch<TActions extends Record<string, ActionReducer<any, any>>> = {
-    [K in keyof TActions]: Parameters<TActions[K]>[1] extends undefined ? () => void : (payload: Parameters<TActions[K]>[1]) => void;
-};
-interface Store<TState, TActions extends Record<string, ActionReducer<TState, any>> = Record<string, ActionReducer<TState, any>>> {
-    getState(): TState;
-    subscribe(callback: (state: TState) => void): () => void;
-    dispatch: StoreDispatch<TActions>;
-    hydrate(state: TState): void;
-    destroy(): void;
-}
-interface KeyForwardConfig {
-    key: string;
-    ctrl?: boolean;
-    meta?: boolean;
-    shift?: boolean;
-    alt?: boolean;
-}
-interface ToolDefinition {
-    name: string;
-    description?: string;
-    inputSchema: Record<string, unknown>;
-    outputSchema?: Record<string, unknown>;
-}
-interface HostInfo {
-    isNimbleBrain: boolean;
-    serverName: string;
-    protocolVersion: string;
-    theme: SynapseTheme;
-}
-
-export type { ActionReducer as A, DataChangedEvent as D, HostInfo as H, KeyForwardConfig as K, SynapseOptions as S, ToolCallResult as T, VisibleState as V, Synapse as a, StoreConfig as b, Store as c, StateAcknowledgement as d, StoreDispatch as e, SynapseTheme as f, ToolDefinition as g };

New alerts

Shell access

Supply chain risk

This module accesses the system shell. Accessing the system shell increases the risk of executing arbitrary code.

AI-detected potential code anomaly

Supply chain risk

AI has identified unusual behaviors that may pose a security risk.

Long strings

Supply chain risk

Contains long string literals, which may be a sign of obfuscated or packed code.

Fixed alerts

Shell access

Supply chain risk

This module accesses the system shell. Accessing the system shell increases the risk of executing arbitrary code.

AI-detected potential code anomaly

Supply chain risk

AI has identified unusual behaviors that may pose a security risk.

Long strings

Supply chain risk

Contains long string literals, which may be a sign of obfuscated or packed code.

Improved metrics

Total package byte prevSize

351919

5.59%

Lines of code

3075

4.81%

Number of lines in readme file

255

2.41%

No dependency changes