@nimblebrain/synapse - npm Package Compare versions

Comparing version 0.2.0 to 0.2.1

dist/chunk-7KEYXJWD.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) {
+      const key = event.key.toLowerCase();
+      if (key === "c" || key === "v" || key === "x" || key === "a") return false;
+      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) {
+      const textBlock = { type: "text", text: message };
+      if (isNB() && context) {
+        textBlock._meta = { context };
+      }
+      transport.send("ui/message", {
+        role: "user",
+        content: [textBlock]
+      });
+    },
+    setVisibleState(state, summary) {
+      if (stateTimer) clearTimeout(stateTimer);
+      stateTimer = setTimeout(() => {
+        transport.send("ui/update-model-context", {
+          structuredContent: state,
+          ...summary !== void 0 && {
+            content: [{ type: "text", text: summary }]
+          }
+        });
+        stateTimer = null;
+      }, 250);
+    },
+    downloadFile(filename, content, mimeType) {
+      if (!isNB()) return;
+      const data = typeof content === "string" ? content : "[Blob content not serializable]";
+      transport.send("ui/download-file", {
+        data,
+        filename,
+        mimeType: mimeType ?? "application/octet-stream"
+      });
+    },
+    openLink(url) {
+      transport.send("ui/open-link", { url });
+      if (!isNB()) {
+        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-7KEYXJWD.js.map
+//# sourceMappingURL=chunk-7KEYXJWD.js.map

dist/chunk-7KEYXJWD.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-7KEYXJWD.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    // EXCEPT clipboard shortcuts (c, v, x, a) which the browser must handle natively.\n    if (event.key === \"Escape\") return true;\n    if (event.ctrlKey || event.metaKey) {\n      const key = event.key.toLowerCase();\n      if (key === \"c\" || key === \"v\" || key === \"x\" || key === \"a\") return false;\n      return true;\n    }\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      const textBlock: Record<string, unknown> = { type: \"text\", text: message };\n      if (isNB() && context) {\n        textBlock._meta = { context };\n      }\n      transport.send(\"ui/message\", {\n        role: \"user\",\n        content: [textBlock],\n      });\n    },\n\n    setVisibleState(state: Record<string, unknown>, summary?: string): void {\n      // Debounce: 250ms\n      if (stateTimer) clearTimeout(stateTimer);\n      stateTimer = setTimeout(() => {\n        transport.send(\"ui/update-model-context\", {\n          structuredContent: state,\n          ...(summary !== undefined && {\n            content: [{ type: \"text\", text: summary }],\n          }),\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/download-file\", {\n        data,\n        filename,\n        mimeType: mimeType ?? \"application/octet-stream\",\n      });\n    },\n\n    openLink(url: string): void {\n      transport.send(\"ui/open-link\", { url });\n      if (!isNB()) {\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-Y4ZDNAYQ.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) {
+      const key = event.key.toLowerCase();
+      if (key === "c" || key === "v" || key === "x" || key === "a") return false;
+      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) {
+      const textBlock = { type: "text", text: message };
+      if (isNB() && context) {
+        textBlock._meta = { context };
+      }
+      transport.send("ui/message", {
+        role: "user",
+        content: [textBlock]
+      });
+    },
+    setVisibleState(state, summary) {
+      if (stateTimer) clearTimeout(stateTimer);
+      stateTimer = setTimeout(() => {
+        transport.send("ui/update-model-context", {
+          structuredContent: state,
+          ...summary !== void 0 && {
+            content: [{ type: "text", text: summary }]
+          }
+        });
+        stateTimer = null;
+      }, 250);
+    },
+    downloadFile(filename, content, mimeType) {
+      if (!isNB()) return;
+      const data = typeof content === "string" ? content : "[Blob content not serializable]";
+      transport.send("ui/download-file", {
+        data,
+        filename,
+        mimeType: mimeType ?? "application/octet-stream"
+      });
+    },
+    openLink(url) {
+      transport.send("ui/open-link", { url });
+      if (!isNB()) {
+        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-Y4ZDNAYQ.cjs.map
+//# sourceMappingURL=chunk-Y4ZDNAYQ.cjs.map

dist/chunk-Y4ZDNAYQ.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-Y4ZDNAYQ.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    // EXCEPT clipboard shortcuts (c, v, x, a) which the browser must handle natively.\n    if (event.key === \"Escape\") return true;\n    if (event.ctrlKey || event.metaKey) {\n      const key = event.key.toLowerCase();\n      if (key === \"c\" || key === \"v\" || key === \"x\" || key === \"a\") return false;\n      return true;\n    }\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      const textBlock: Record<string, unknown> = { type: \"text\", text: message };\n      if (isNB() && context) {\n        textBlock._meta = { context };\n      }\n      transport.send(\"ui/message\", {\n        role: \"user\",\n        content: [textBlock],\n      });\n    },\n\n    setVisibleState(state: Record<string, unknown>, summary?: string): void {\n      // Debounce: 250ms\n      if (stateTimer) clearTimeout(stateTimer);\n      stateTimer = setTimeout(() => {\n        transport.send(\"ui/update-model-context\", {\n          structuredContent: state,\n          ...(summary !== undefined && {\n            content: [{ type: \"text\", text: summary }],\n          }),\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/download-file\", {\n        data,\n        filename,\n        mimeType: mimeType ?? \"application/octet-stream\",\n      });\n    },\n\n    openLink(url: string): void {\n      transport.send(\"ui/open-link\", { url });\n      if (!isNB()) {\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/types-DElq_otH.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;
+    /** NimbleBrain-only: trigger a host-side action. No-op in other hosts. */
+    action(action: string, params?: Record<string, unknown>): void;
+    /**
+     * Send a user message into the agent conversation (ext-apps `ui/message`).
+     *
+     * @param context NimbleBrain-specific metadata, included as `_meta.context`
+     *   on the content block. Ignored by non-NimbleBrain hosts.
+     */
+    chat(message: string, context?: {
+        action?: string;
+        entity?: string;
+    }): void;
+    /**
+     * Push the app's current visible state to the agent (ext-apps `ui/update-model-context`).
+     *
+     * The `summary` string is what the LLM reads as a text content block.
+     * The `state` object is included as `structuredContent` for tools that need IDs/values.
+     * Debounced at 250ms. Each call overwrites the previous context.
+     */
+    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-DElq_otH.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;
+    /** NimbleBrain-only: trigger a host-side action. No-op in other hosts. */
+    action(action: string, params?: Record<string, unknown>): void;
+    /**
+     * Send a user message into the agent conversation (ext-apps `ui/message`).
+     *
+     * @param context NimbleBrain-specific metadata, included as `_meta.context`
+     *   on the content block. Ignored by non-NimbleBrain hosts.
+     */
+    chat(message: string, context?: {
+        action?: string;
+        entity?: string;
+    }): void;
+    /**
+     * Push the app's current visible state to the agent (ext-apps `ui/update-model-context`).
+     *
+     * The `summary` string is what the LLM reads as a text content block.
+     * The `state` object is included as `structuredContent` for tools that need IDs/values.
+     * Debounced at 250ms. Each call overwrites the previous context.
+     */
+    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/index.d.cts

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

dist/codegen/index.d.ts

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

dist/index.cjs

 'use strict';
 
-var chunkABJP7PL4_cjs = require('./chunk-ABJP7PL4.cjs');
+var chunkY4ZDNAYQ_cjs = require('./chunk-Y4ZDNAYQ.cjs');
 
@@ -83,3 +83,3 @@ // src/store.ts
   enumerable: true,
-  get: function () { return chunkABJP7PL4_cjs.createSynapse; }
+  get: function () { return chunkY4ZDNAYQ_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-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';
+import { S as SynapseOptions, a as Synapse, A as ActionReducer, b as StoreConfig, c as Store } from './types-DElq_otH.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-DElq_otH.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-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';
+import { S as SynapseOptions, a as Synapse, A as ActionReducer, b as StoreConfig, c as Store } from './types-DElq_otH.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-DElq_otH.js';
 
@@ -4,0 +4,0 @@ /**

dist/index.js

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

dist/react/index.cjs

 'use strict';
 
-var chunkABJP7PL4_cjs = require('../chunk-ABJP7PL4.cjs');
+var chunkY4ZDNAYQ_cjs = require('../chunk-Y4ZDNAYQ.cjs');
 var react = require('react');
@@ -11,3 +11,3 @@ var jsxRuntime = require('react/jsx-runtime');
   if (ref.current === null || ref.current.destroyed) {
-    ref.current = chunkABJP7PL4_cjs.createSynapse(options);
+    ref.current = chunkY4ZDNAYQ_cjs.createSynapse(options);
   }
@@ -100,8 +100,16 @@ return /* @__PURE__ */ jsxRuntime.jsx(SynapseContext.Provider, { value: ref.current, children });
 }
-function useVisibleState() {
+function useVisibleState(factory, deps) {
   const synapse = useSynapseContext();
-  return react.useCallback(
+  const push = react.useCallback(
     (state, summary) => synapse.setVisibleState(state, summary),
     [synapse]
   );
+  const factoryRef = react.useRef(factory);
+  factoryRef.current = factory;
+  react.useEffect(() => {
+    if (!factoryRef.current) return;
+    const { state, summary } = factoryRef.current();
+    push(state, summary);
+  }, [...deps ?? [], push]);
+  if (!factory) return push;
 }
@@ -108,0 +116,0 @@ function useStore(store) {

dist/react/index.cjs.map

@@ -1,1 +0,1 @@
-{"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"]}
+{"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\n/**\n * Push the app's visible state to the agent via ext-apps `ui/update-model-context`.\n *\n * **Imperative** (no args) — returns a push function you call manually:\n * ```tsx\n * const push = useVisibleState();\n * push({ board: selectedBoard }, \"Viewing board X\");\n * ```\n *\n * **Declarative** (factory + deps) — auto-pushes when deps change:\n * ```tsx\n * useVisibleState(() => ({\n *   state: { board: selectedBoard },\n *   summary: `Viewing \"${selectedBoard?.name}\"`,\n * }), [selectedBoard]);\n * ```\n */\nexport function useVisibleState(): (state: Record<string, unknown>, summary?: string) => void;\nexport function useVisibleState(\n  factory: () => { state: Record<string, unknown>; summary?: string },\n  deps: unknown[],\n): void;\nexport function useVisibleState(\n  factory?: () => { state: Record<string, unknown>; summary?: string },\n  deps?: unknown[],\n): ((state: Record<string, unknown>, summary?: string) => void) | undefined {\n  const synapse = useSynapseContext();\n  const push = useCallback(\n    (state: Record<string, unknown>, summary?: string) => synapse.setVisibleState(state, summary),\n    [synapse],\n  );\n\n  // Declarative mode: auto-push when deps change.\n  // The deps array is caller-provided (mirrors useMemo/useEffect pattern).\n  const factoryRef = useRef(factory);\n  factoryRef.current = factory;\n  useEffect(() => {\n    if (!factoryRef.current) return;\n    const { state, summary } = factoryRef.current();\n    push(state, summary);\n  }, [...(deps ?? []), push]);\n\n  if (!factory) return push;\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, 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 { 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-DElq_otH.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -41,3 +41,24 @@ import { ReactNode } from 'react';
 }) => void;
+/**
+ * Push the app's visible state to the agent via ext-apps `ui/update-model-context`.
+ *
+ * **Imperative** (no args) — returns a push function you call manually:
+ * ```tsx
+ * const push = useVisibleState();
+ * push({ board: selectedBoard }, "Viewing board X");
+ * ```
+ *
+ * **Declarative** (factory + deps) — auto-pushes when deps change:
+ * ```tsx
+ * useVisibleState(() => ({
+ *   state: { board: selectedBoard },
+ *   summary: `Viewing "${selectedBoard?.name}"`,
+ * }), [selectedBoard]);
+ * ```
+ */
 declare function useVisibleState(): (state: Record<string, unknown>, summary?: string) => void;
+declare function useVisibleState(factory: () => {
+    state: Record<string, unknown>;
+    summary?: string;
+}, deps: unknown[]): void;
 declare function useStore<TState, TActions extends Record<string, ActionReducer<TState, any>>>(store: Store<TState, TActions>): {
@@ -44,0 +65,0 @@ state: TState;

dist/react/index.d.ts

@@ -1,2 +0,2 @@
-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 { 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-DElq_otH.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -41,3 +41,24 @@ import { ReactNode } from 'react';
 }) => void;
+/**
+ * Push the app's visible state to the agent via ext-apps `ui/update-model-context`.
+ *
+ * **Imperative** (no args) — returns a push function you call manually:
+ * ```tsx
+ * const push = useVisibleState();
+ * push({ board: selectedBoard }, "Viewing board X");
+ * ```
+ *
+ * **Declarative** (factory + deps) — auto-pushes when deps change:
+ * ```tsx
+ * useVisibleState(() => ({
+ *   state: { board: selectedBoard },
+ *   summary: `Viewing "${selectedBoard?.name}"`,
+ * }), [selectedBoard]);
+ * ```
+ */
 declare function useVisibleState(): (state: Record<string, unknown>, summary?: string) => void;
+declare function useVisibleState(factory: () => {
+    state: Record<string, unknown>;
+    summary?: string;
+}, deps: unknown[]): void;
 declare function useStore<TState, TActions extends Record<string, ActionReducer<TState, any>>>(store: Store<TState, TActions>): {
@@ -44,0 +65,0 @@ state: TState;

dist/react/index.js

@@ -1,2 +0,2 @@
-import { createSynapse } from '../chunk-BWSAQV3P.js';
+import { createSynapse } from '../chunk-7KEYXJWD.js';
 import { createContext, useRef, useState, useCallback, useEffect, useSyncExternalStore, useContext } from 'react';
@@ -97,8 +97,16 @@ import { jsx } from 'react/jsx-runtime';
 }
-function useVisibleState() {
+function useVisibleState(factory, deps) {
   const synapse = useSynapseContext();
-  return useCallback(
+  const push = useCallback(
     (state, summary) => synapse.setVisibleState(state, summary),
     [synapse]
   );
+  const factoryRef = useRef(factory);
+  factoryRef.current = factory;
+  useEffect(() => {
+    if (!factoryRef.current) return;
+    const { state, summary } = factoryRef.current();
+    push(state, summary);
+  }, [...deps ?? [], push]);
+  if (!factory) return push;
 }
@@ -105,0 +113,0 @@ function useStore(store) {

dist/react/index.js.map

@@ -1,1 +0,1 @@
-{"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"]}
+{"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\n/**\n * Push the app's visible state to the agent via ext-apps `ui/update-model-context`.\n *\n * **Imperative** (no args) — returns a push function you call manually:\n * ```tsx\n * const push = useVisibleState();\n * push({ board: selectedBoard }, \"Viewing board X\");\n * ```\n *\n * **Declarative** (factory + deps) — auto-pushes when deps change:\n * ```tsx\n * useVisibleState(() => ({\n *   state: { board: selectedBoard },\n *   summary: `Viewing \"${selectedBoard?.name}\"`,\n * }), [selectedBoard]);\n * ```\n */\nexport function useVisibleState(): (state: Record<string, unknown>, summary?: string) => void;\nexport function useVisibleState(\n  factory: () => { state: Record<string, unknown>; summary?: string },\n  deps: unknown[],\n): void;\nexport function useVisibleState(\n  factory?: () => { state: Record<string, unknown>; summary?: string },\n  deps?: unknown[],\n): ((state: Record<string, unknown>, summary?: string) => void) | undefined {\n  const synapse = useSynapseContext();\n  const push = useCallback(\n    (state: Record<string, unknown>, summary?: string) => synapse.setVisibleState(state, summary),\n    [synapse],\n  );\n\n  // Declarative mode: auto-push when deps change.\n  // The deps array is caller-provided (mirrors useMemo/useEffect pattern).\n  const factoryRef = useRef(factory);\n  factoryRef.current = factory;\n  useEffect(() => {\n    if (!factoryRef.current) return;\n    const { state, summary } = factoryRef.current();\n    push(state, summary);\n  }, [...(deps ?? []), push]);\n\n  if (!factory) return push;\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 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};})();
+(function(){'use strict';var C={mode:"light",primaryColor:"#6366f1",tokens:{}};function x(r){let e=r,o=A(e?.serverInfo),t=typeof o?.name=="string"?o.name:"unknown",i=typeof e?.protocolVersion=="string"?e.protocolVersion:"unknown",s=A(e?.hostContext),c=H(s?.theme);return {isNimbleBrain:t==="nimblebrain",serverName:t,protocolVersion:i,theme:c}}function H(r){let e=A(r);if(!e)return {...C};let o=e.mode==="light"||e.mode==="dark"?e.mode:C.mode,t=typeof e.primaryColor=="string"?e.primaryColor:C.primaryColor,i=e.tokens!==null&&typeof e.tokens=="object"&&!Array.isArray(e.tokens)?e.tokens:{};return {mode:o,primaryColor:t,tokens:i}}function A(r){if(r!==null&&typeof r=="object"&&!Array.isArray(r))return r}var S=class{listener;destroyed=false;constructor(e,o){let t=o??null;this.listener=i=>{this.destroyed||this.shouldForward(i,t)&&(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,o){if(o&&o.length===0)return  false;if(o)return o.some(t=>e.key.toLowerCase()===t.key.toLowerCase()&&(t.ctrl===void 0||e.ctrlKey===t.ctrl)&&(t.meta===void 0||e.metaKey===t.meta)&&(t.shift===void 0||e.shiftKey===t.shift)&&(t.alt===void 0||e.altKey===t.alt));if(e.key==="Escape")return  true;if(e.ctrlKey||e.metaKey){let t=e.key.toLowerCase();return !(t==="c"||t==="v"||t==="x"||t==="a")}return  false}};function E(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,o=r.content;if(o.length===0)return {data:null,isError:e};let t=o.find(L);if(!t)return {data:o,isError:e};try{return {data:JSON.parse(t.text),isError:e}}catch{return {data:t.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,o){if(this.destroyed)return;let t={jsonrpc:"2.0",method:e,...o!==void 0&&{params:o}};window.parent.postMessage(t,"*");}request(e,o){if(this.destroyed)return Promise.reject(new Error("Transport destroyed"));let t=`syn-${++this.counter}`,i={jsonrpc:"2.0",method:e,id:t,...o!==void 0&&{params:o}};return new Promise((s,c)=>{this.pending.set(t,{resolve:s,reject:c}),window.parent.postMessage(i,"*");})}onMessage(e,o){return this.handlers.has(e)||this.handlers.set(e,new Set),this.handlers.get(e)?.add(o),()=>{let t=this.handlers.get(e);t&&(t.delete(o),t.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 o of this.pending.values())o.reject(e);this.pending.clear(),this.handlers.clear();}handleMessage(e){if(this.destroyed)return;let o=e.data;if(!(!o||o.jsonrpc!=="2.0")){if("id"in o&&o.id&&!("method"in o)){let t=o,i=this.pending.get(t.id);if(!i)return;if(this.pending.delete(t.id),t.error){let s=new Error(t.error.message);s.code=t.error.code,s.data=t.error.data,i.reject(s);}else i.resolve(t.result);return}if("method"in o&&!("id"in o&&o.id)){let t=o,i=this.handlers.get(t.method);if(i)for(let s of i)s(t.params);}}}};function M(r){let{name:e,version:o,internal:t=false,forwardKeys:i}=r,s=new b,c=null,l={mode:"light",primaryColor:"#6366f1",tokens:{}},w=false,y=null,T=null,R=s.request("ui/initialize",{protocolVersion:"2026-01-26",clientInfo:{name:e,version:o},capabilities:{}}).then(n=>{c=x(n),l=c.theme,s.send("ui/notifications/initialized",{}),T=new S(s,i);}),d=s.onMessage("ui/notifications/host-context-changed",n=>{if(!n)return;let a=n.theme==="dark"?"dark":"light",u=n.tokens&&typeof n.tokens=="object"?n.tokens:l.tokens;l={mode:a,primaryColor:l.primaryColor,tokens:u};for(let g of p)g(l);}),f=s.onMessage("ui/themeChanged",n=>{if(!n)return;let a=n.mode==="dark"||n.mode==="light"?n.mode:l.mode,u=n.tokens&&typeof n.tokens=="object"?n.tokens:l.tokens;l={mode:a,primaryColor:l.primaryColor,tokens:u};for(let g of p)g(l);}),p=new Set,m=new Set,h=new Set,k=s.onMessage("ui/datachanged",n=>{if(!n)return;let a={source:"agent",server:n.server??"",tool:n.tool??""};for(let u of m)u(a);}),K=s.onMessage("ui/action",n=>{if(!n||typeof n.type!="string")return;let a={type:n.type,payload:n.payload??{},requiresConfirmation:n.requiresConfirmation===true,label:typeof n.label=="string"?n.label:void 0};for(let u of h)u(a);}),v=()=>c?.isNimbleBrain===true;return {get ready(){return R},get isNimbleBrainHost(){return v()},get destroyed(){return w},async callTool(n,a){let u={name:n,arguments:a??{}};t&&(u.server=e);let g=await s.request("tools/call",u);return E(g)},onDataChanged(n){return m.add(n),()=>{m.delete(n);}},onAction(n){return h.add(n),()=>{h.delete(n);}},getTheme(){return {...l}},onThemeChanged(n){return p.add(n),()=>{p.delete(n);}},action(n,a){v()&&s.send("ui/action",{action:n,...a});},chat(n,a){let u={type:"text",text:n};v()&&a&&(u._meta={context:a}),s.send("ui/message",{role:"user",content:[u]});},setVisibleState(n,a){y&&clearTimeout(y),y=setTimeout(()=>{s.send("ui/update-model-context",{structuredContent:n,...a!==void 0&&{content:[{type:"text",text:a}]}}),y=null;},250);},downloadFile(n,a,u){if(!v())return;let g=typeof a=="string"?a:"[Blob content not serializable]";s.send("ui/download-file",{data:g,filename:n,mimeType:u??"application/octet-stream"});},openLink(n){s.send("ui/open-link",{url:n}),v()||window.open(n,"_blank","noopener");},_onMessage(n,a){return s.onMessage(n,a)},_request(n,a){return s.request(n,a)},destroy(){w||(w=true,y&&clearTimeout(y),T?.destroy(),d(),f(),k(),K(),p.clear(),m.clear(),h.clear(),s.destroy());}}}function j(r,e){let o=structuredClone(e.initialState),t=new Set,i=false,s=null,c={};for(let d of Object.keys(e.actions))c[d]=f=>{i||(o=e.actions[d](o,f),l());};function l(){for(let d of t)d(o);e.visibleToAgent&&w(),e.persist&&y();}function w(){let d=e.summarize?.(o);r.setVisibleState(o,d);}function y(){s&&clearTimeout(s),s=setTimeout(()=>{r._request("ui/persistState",{state:o,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,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 o},subscribe(d){return t.add(d),()=>{t.delete(d);}},dispatch:c,hydrate(d){o=d;for(let f of t)f(o);},destroy(){i||(i=true,s&&clearTimeout(s),t.clear(),T?.());}};return R}window.NbSynapse={createSynapse:M,createStore:j};})();

package.json

 {
   "name": "@nimblebrain/synapse",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Agent-aware app SDK for the MCP ext-apps protocol",
@@ -5,0 +5,0 @@ "type": "module",

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":"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","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/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 };

New alerts

AI-detected potential code anomaly

Supply chain risk

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

Fixed alerts

AI-detected potential code anomaly

Supply chain risk

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

Improved metrics

Total package byte prevSize

360950

2.57%

Lines of code

3146

2.31%

No dependency changes