@nimblebrain/synapse 0.1.3 → 0.2.0

package/README.md

@@ -7,7 +7,7 @@
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue)](https://www.typescriptlang.org/)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org/)
 
-Agent-aware app SDK for the [NimbleBrain](https://nimblebrain.ai) platform. Typed tool calls, reactive state, and React hooks over the [MCP ext-apps](https://modelcontextprotocol.io/specification/2025-06-18/user-interaction/ext-apps) protocol.
+Agent-aware app SDK for the [MCP ext-apps](https://modelcontextprotocol.io/specification/2025-06-18/user-interaction/ext-apps) protocol. Typed tool calls, reactive data sync, and React hooks — works in any host that implements ext-apps (Claude Desktop, VS Code, ChatGPT, [NimbleBrain](https://nimblebrain.ai), or your own runtime).
 
 ## What is Synapse?
 
@@ -22,6 +22,12 @@ Synapse is an optional enhancement layer over `@modelcontextprotocol/ext-apps`.
 
 In non-NimbleBrain hosts (Claude Desktop, VS Code, ChatGPT), NB-specific features degrade gracefully to no-ops while ext-apps baseline behavior is preserved.
 
+## Why Synapse?
+
+Raw ext-apps gives you an iframe and postMessage. That works — until the agent changes data and your UI goes stale, or the user filters a view and the agent can't see what they're looking at, or you spend an afternoon wiring up JSON-RPC request tracking for the third time.
+
+Synapse handles the plumbing so you can focus on the UI. See **[Why Synapse?](docs/WHY.md)** for before/after comparisons of each problem it solves.
+
 ## Install
 
 ```bash

package/dist/{chunk-Q7OSHSGZ.cjs → chunk-ABJP7PL4.cjs}

@@ -246,6 +246,7 @@ function createSynapse(options) {
   });
   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 = {
@@ -255,6 +256,16 @@ function createSynapse(options) {
     };
     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() {
@@ -263,6 +274,9 @@ function createSynapse(options) {
     get isNimbleBrainHost() {
       return isNB();
     },
+    get destroyed() {
+      return destroyed;
+    },
     async callTool(toolName, args) {
       const params = {
         name: toolName,
@@ -280,6 +294,12 @@ function createSynapse(options) {
         dataCallbacks.delete(callback);
       };
     },
+    onAction(callback) {
+      actionCallbacks.add(callback);
+      return () => {
+        actionCallbacks.delete(callback);
+      };
+    },
     getTheme() {
       return { ...currentTheme };
     },
@@ -338,8 +358,10 @@ function createSynapse(options) {
       unsubTheme();
       unsubNbTheme();
       unsubData();
+      unsubAction();
       themeCallbacks.clear();
       dataCallbacks.clear();
+      actionCallbacks.clear();
       transport.destroy();
     }
   };
@@ -347,5 +369,5 @@ function createSynapse(options) {
 }
 
 exports.createSynapse = createSynapse;
-//# sourceMappingURL=chunk-Q7OSHSGZ.cjs.map
-//# sourceMappingURL=chunk-Q7OSHSGZ.cjs.map
+//# sourceMappingURL=chunk-ABJP7PL4.cjs.map
+//# sourceMappingURL=chunk-ABJP7PL4.cjs.map

package/dist/chunk-ABJP7PL4.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/detection.ts","../src/keyboard.ts","../src/result-parser.ts","../src/transport.ts","../src/core.ts"],"names":[],"mappings":";;;AAEA,IAAM,aAAA,GAA8B;AAAA,EAClC,IAAA,EAAM,OAAA;AAAA,EACN,YAAA,EAAc,SAAA;AAAA,EACd,QAAQ;AACV,CAAA;AAOO,SAAS,WAAW,YAAA,EAAiC;AAC1D,EAAA,MAAM,IAAA,GAAO,YAAA;AAEb,EAAA,MAAM,UAAA,GAAa,OAAA,CAAQ,IAAA,EAAM,UAAU,CAAA;AAC3C,EAAA,MAAM,aAAa,OAAO,UAAA,EAAY,IAAA,KAAS,QAAA,GAAW,WAAW,IAAA,GAAO,SAAA;AAE5E,EAAA,MAAM,kBACJ,OAAO,IAAA,EAAM,eAAA,KAAoB,QAAA,GAAW,KAAK,eAAA,GAAkB,SAAA;AAErE,EAAA,MAAM,WAAA,GAAc,OAAA,CAAQ,IAAA,EAAM,WAAW,CAAA;AAC7C,EAAA,MAAM,KAAA,GAAQ,YAAA,CAAa,WAAA,EAAa,KAAK,CAAA;AAE7C,EAAA,OAAO;AAAA,IACL,eAAe,UAAA,KAAe,aAAA;AAAA,IAC9B,UAAA;AAAA,IACA,eAAA;AAAA,IACA;AAAA,GACF;AACF;AAEA,SAAS,aAAa,GAAA,EAA4B;AAChD,EAAA,MAAM,GAAA,GAAM,QAAQ,GAAG,CAAA;AACvB,EAAA,IAAI,CAAC,GAAA,EAAK,OAAO,EAAE,GAAG,aAAA,EAAc;AAEpC,EAAA,MAAM,IAAA,GAAO,IAAI,IAAA,KAAS,OAAA,IAAW,IAAI,IAAA,KAAS,MAAA,GAAS,GAAA,CAAI,IAAA,GAAO,aAAA,CAAc,IAAA;AAEpF,EAAA,MAAM,eACJ,OAAO,GAAA,CAAI,iBAAiB,QAAA,GAAW,GAAA,CAAI,eAAe,aAAA,CAAc,YAAA;AAE1E,EAAA,MAAM,SACJ,GAAA,CAAI,MAAA,KAAW,IAAA,IAAQ,OAAO,IAAI,MAAA,KAAW,QAAA,IAAY,CAAC,KAAA,CAAM,QAAQ,GAAA,CAAI,MAAM,CAAA,GAC7E,GAAA,CAAI,SACL,EAAC;AAEP,EAAA,OAAO,EAAE,IAAA,EAAM,YAAA,EAAc,MAAA,EAAO;AACtC;AAEA,SAAS,QAAQ,KAAA,EAAqD;AACpE,EAAA,IAAI,KAAA,KAAU,QAAQ,OAAO,KAAA,KAAU,YAAY,CAAC,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG;AACxE,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,OAAO,MAAA;AACT;;;AC9CO,IAAM,oBAAN,MAAwB;AAAA,EACrB,QAAA;AAAA,EACA,SAAA,GAAY,KAAA;AAAA,EAEpB,WAAA,CAAY,WAA6B,UAAA,EAAiC;AACxE,IAAA,MAAM,SAAS,UAAA,IAAc,IAAA;AAE7B,IAAA,IAAA,CAAK,QAAA,GAAW,CAAC,KAAA,KAAyB;AACxC,MAAA,IAAI,KAAK,SAAA,EAAW;AACpB,MAAA,IAAI,IAAA,CAAK,aAAA,CAAc,KAAA,EAAO,MAAM,CAAA,EAAG;AACrC,QAAA,KAAA,CAAM,cAAA,EAAe;AACrB,QAAA,SAAA,CAAU,KAAK,YAAA,EAAc;AAAA,UAC3B,KAAK,KAAA,CAAM,GAAA;AAAA,UACX,SAAS,KAAA,CAAM,OAAA;AAAA,UACf,SAAS,KAAA,CAAM,OAAA;AAAA,UACf,UAAU,KAAA,CAAM,QAAA;AAAA,UAChB,QAAQ,KAAA,CAAM;AAAA,SACf,CAAA;AAAA,MACH;AAAA,IACF,CAAA;AAEA,IAAA,QAAA,CAAS,gBAAA,CAAiB,SAAA,EAAW,IAAA,CAAK,QAAQ,CAAA;AAAA,EACpD;AAAA,EAEA,OAAA,GAAgB;AACd,IAAA,IAAI,KAAK,SAAA,EAAW;AACpB,IAAA,IAAA,CAAK,SAAA,GAAY,IAAA;AACjB,IAAA,QAAA,CAAS,mBAAA,CAAoB,SAAA,EAAW,IAAA,CAAK,QAAQ,CAAA;AAAA,EACvD;AAAA,EAEQ,aAAA,CAAc,OAAsB,MAAA,EAA4C;AAEtF,IAAA,IAAI,MAAA,IAAU,MAAA,CAAO,MAAA,KAAW,CAAA,EAAG,OAAO,KAAA;AAG1C,IAAA,IAAI,MAAA,EAAQ;AACV,MAAA,OAAO,MAAA,CAAO,IAAA;AAAA,QACZ,CAAC,CAAA,KACC,KAAA,CAAM,GAAA,CAAI,WAAA,OAAkB,CAAA,CAAE,GAAA,CAAI,WAAA,EAAY,KAC7C,EAAE,IAAA,KAAS,MAAA,IAAa,KAAA,CAAM,OAAA,KAAY,EAAE,IAAA,CAAA,KAC5C,CAAA,CAAE,IAAA,KAAS,MAAA,IAAa,MAAM,OAAA,KAAY,CAAA,CAAE,IAAA,CAAA,KAC5C,CAAA,CAAE,UAAU,MAAA,IAAa,KAAA,CAAM,QAAA,KAAa,CAAA,CAAE,WAC9C,CAAA,CAAE,GAAA,KAAQ,MAAA,IAAa,KAAA,CAAM,WAAW,CAAA,CAAE,GAAA;AAAA,OAC/C;AAAA,IACF;AAGA,IAAA,IAAI,KAAA,CAAM,GAAA,KAAQ,QAAA,EAAU,OAAO,IAAA;AACnC,IAAA,IAAI,KAAA,CAAM,OAAA,IAAW,KAAA,CAAM,OAAA,EAAS,OAAO,IAAA;AAC3C,IAAA,OAAO,KAAA;AAAA,EACT;AACF,CAAA;;;AClDO,SAAS,gBAAgB,GAAA,EAA8B;AAC5D,EAAA,IAAI,OAAO,IAAA,EAAM;AACf,IAAA,OAAO,EAAE,IAAA,EAAM,IAAA,EAAM,OAAA,EAAS,KAAA,EAAM;AAAA,EACtC;AAEA,EAAA,IAAI,gBAAA,CAAiB,GAAG,CAAA,EAAG;AACzB,IAAA,OAAO,oBAAoB,GAAG,CAAA;AAAA,EAChC;AAGA,EAAA,OAAO,EAAE,IAAA,EAAM,GAAA,EAAK,OAAA,EAAS,KAAA,EAAM;AACrC;AAgBA,SAAS,iBAAiB,KAAA,EAA4C;AACpE,EAAA,IAAI,KAAA,KAAU,QAAQ,OAAO,KAAA,KAAU,YAAY,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG;AACvE,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,OAAO,KAAA,CAAM,OAAA,CAAS,KAAA,CAAkC,OAAO,CAAA;AACjE;AAEA,SAAS,YAAY,KAAA,EAAuC;AAC1D,EAAA,IAAI,KAAA,KAAU,QAAQ,OAAO,KAAA,KAAU,YAAY,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG;AACvE,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,MAAM,GAAA,GAAM,KAAA;AACZ,EAAA,OAAO,GAAA,CAAI,IAAA,KAAS,MAAA,IAAU,OAAO,IAAI,IAAA,KAAS,QAAA;AACpD;AAEA,SAAS,oBAAoB,MAAA,EAA2C;AACtE,EAAA,MAAM,OAAA,GAAU,OAAO,OAAA,KAAY,IAAA;AACnC,EAAA,MAAM,UAAU,MAAA,CAAO,OAAA;AAEvB,EAAA,IAAI,OAAA,CAAQ,WAAW,CAAA,EAAG;AACxB,IAAA,OAAO,EAAE,IAAA,EAAM,IAAA,EAAM,OAAA,EAAQ;AAAA,EAC/B;AAEA,EAAA,MAAM,SAAA,GAAY,OAAA,CAAQ,IAAA,CAAK,WAAW,CAAA;AAE1C,EAAA,IAAI,CAAC,SAAA,EAAW;AAEd,IAAA,OAAO,EAAE,IAAA,EAAM,OAAA,EAAS,OAAA,EAAQ;AAAA,EAClC;AAGA,EAAA,IAAI;AACF,IAAA,OAAO,EAAE,IAAA,EAAM,IAAA,CAAK,MAAM,SAAA,CAAU,IAAI,GAAG,OAAA,EAAQ;AAAA,EACrD,CAAA,CAAA,MAAQ;AAEN,IAAA,OAAO,EAAE,IAAA,EAAM,SAAA,CAAU,IAAA,EAAM,OAAA,EAAQ;AAAA,EACzC;AACF;;;AC5DO,IAAM,mBAAN,MAAuB;AAAA,EACpB,OAAA,GAAU,CAAA;AAAA,EACV,SAAA,GAAY,KAAA;AAAA,EACZ,OAAA,uBAAc,GAAA,EAA0B;AAAA,EACxC,QAAA,uBAAe,GAAA,EAAiC;AAAA,EAChD,QAAA;AAAA,EAER,WAAA,GAAc;AACZ,IAAA,IAAA,CAAK,QAAA,GAAW,CAAC,KAAA,KAAwB,IAAA,CAAK,cAAc,KAAK,CAAA;AACjE,IAAA,MAAA,CAAO,gBAAA,CAAiB,SAAA,EAAW,IAAA,CAAK,QAAQ,CAAA;AAAA,EAClD;AAAA,EAEA,IAAA,CAAK,QAAgB,MAAA,EAAwC;AAC3D,IAAA,IAAI,KAAK,SAAA,EAAW;AAEpB,IAAA,MAAM,GAAA,GAA2B;AAAA,MAC/B,OAAA,EAAS,KAAA;AAAA,MACT,MAAA;AAAA,MACA,GAAI,MAAA,KAAW,MAAA,IAAa,EAAE,MAAA;AAAO,KACvC;AACA,IAAA,MAAA,CAAO,MAAA,CAAO,WAAA,CAAY,GAAA,EAAK,GAAG,CAAA;AAAA,EACpC;AAAA,EAEA,OAAA,CAAQ,QAAgB,MAAA,EAAoD;AAC1E,IAAA,IAAI,KAAK,SAAA,EAAW;AAClB,MAAA,OAAO,OAAA,CAAQ,MAAA,CAAO,IAAI,KAAA,CAAM,qBAAqB,CAAC,CAAA;AAAA,IACxD;AAEA,IAAA,MAAM,EAAA,GAAK,CAAA,IAAA,EAAO,EAAE,IAAA,CAAK,OAAO,CAAA,CAAA;AAChC,IAAA,MAAM,GAAA,GAAsB;AAAA,MAC1B,OAAA,EAAS,KAAA;AAAA,MACT,MAAA;AAAA,MACA,EAAA;AAAA,MACA,GAAI,MAAA,KAAW,MAAA,IAAa,EAAE,MAAA;AAAO,KACvC;AAEA,IAAA,OAAO,IAAI,OAAA,CAAiB,CAAC,OAAA,EAAS,MAAA,KAAW;AAC/C,MAAA,IAAA,CAAK,QAAQ,GAAA,CAAI,EAAA,EAAI,EAAE,OAAA,EAAS,QAAQ,CAAA;AACxC,MAAA,MAAA,CAAO,MAAA,CAAO,WAAA,CAAY,GAAA,EAAK,GAAG,CAAA;AAAA,IACpC,CAAC,CAAA;AAAA,EACH;AAAA,EAEA,SAAA,CAAU,QAAgB,QAAA,EAAsC;AAC9D,IAAA,IAAI,CAAC,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,MAAM,CAAA,EAAG;AAC9B,MAAA,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,MAAA,kBAAQ,IAAI,KAAK,CAAA;AAAA,IACrC;AACA,IAAA,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,MAAM,CAAA,EAAG,IAAI,QAAQ,CAAA;AAEvC,IAAA,OAAO,MAAM;AACX,MAAA,MAAM,GAAA,GAAM,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,MAAM,CAAA;AACpC,MAAA,IAAI,GAAA,EAAK;AACP,QAAA,GAAA,CAAI,OAAO,QAAQ,CAAA;AACnB,QAAA,IAAI,GAAA,CAAI,SAAS,CAAA,EAAG;AAClB,UAAA,IAAA,CAAK,QAAA,CAAS,OAAO,MAAM,CAAA;AAAA,QAC7B;AAAA,MACF;AAAA,IACF,CAAA;AAAA,EACF;AAAA,EAEA,OAAA,GAAgB;AACd,IAAA,IAAI,KAAK,SAAA,EAAW;AACpB,IAAA,IAAA,CAAK,SAAA,GAAY,IAAA;AAEjB,IAAA,MAAA,CAAO,mBAAA,CAAoB,SAAA,EAAW,IAAA,CAAK,QAAQ,CAAA;AAEnD,IAAA,MAAM,KAAA,GAAQ,IAAI,KAAA,CAAM,qBAAqB,CAAA;AAC7C,IAAA,KAAA,MAAW,KAAA,IAAS,IAAA,CAAK,OAAA,CAAQ,MAAA,EAAO,EAAG;AACzC,MAAA,KAAA,CAAM,OAAO,KAAK,CAAA;AAAA,IACpB;AACA,IAAA,IAAA,CAAK,QAAQ,KAAA,EAAM;AACnB,IAAA,IAAA,CAAK,SAAS,KAAA,EAAM;AAAA,EACtB;AAAA,EAEQ,cAAc,KAAA,EAA2B;AAC/C,IAAA,IAAI,KAAK,SAAA,EAAW;AAEpB,IAAA,MAAM,OAAO,KAAA,CAAM,IAAA;AACnB,IAAA,IAAI,CAAC,IAAA,IAAQ,IAAA,CAAK,OAAA,KAAY,KAAA,EAAO;AAGrC,IAAA,IAAI,QAAQ,IAAA,IAAQ,IAAA,CAAK,EAAA,IAAM,EAAE,YAAY,IAAA,CAAA,EAAO;AAClD,MAAA,MAAM,QAAA,GAAW,IAAA;AACjB,MAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,SAAS,EAAE,CAAA;AAC1C,MAAA,IAAI,CAAC,KAAA,EAAO;AACZ,MAAA,IAAA,CAAK,OAAA,CAAQ,MAAA,CAAO,QAAA,CAAS,EAAE,CAAA;AAE/B,MAAA,IAAI,SAAS,KAAA,EAAO;AAClB,QAAA,MAAM,GAAA,GAAM,IAAI,KAAA,CAAM,QAAA,CAAS,MAAM,OAAO,CAAA;AAC5C,QAAC,GAAA,CAAY,IAAA,GAAO,QAAA,CAAS,KAAA,CAAM,IAAA;AACnC,QAAC,GAAA,CAAY,IAAA,GAAO,QAAA,CAAS,KAAA,CAAM,IAAA;AACnC,QAAA,KAAA,CAAM,OAAO,GAAG,CAAA;AAAA,MAClB,CAAA,MAAO;AACL,QAAA,KAAA,CAAM,OAAA,CAAQ,SAAS,MAAM,CAAA;AAAA,MAC/B;AACA,MAAA;AAAA,IACF;AAGA,IAAA,IAAI,YAAY,IAAA,IAAQ,EAAE,IAAA,IAAQ,IAAA,IAAQ,KAAK,EAAA,CAAA,EAAK;AAClD,MAAA,MAAM,YAAA,GAAe,IAAA;AACrB,MAAA,MAAM,GAAA,GAAM,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,aAAa,MAAM,CAAA;AACjD,MAAA,IAAI,GAAA,EAAK;AACP,QAAA,KAAA,MAAW,WAAW,GAAA,EAAK;AACzB,UAAA,OAAA,CAAQ,aAAa,MAAM,CAAA;AAAA,QAC7B;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF,CAAA;;;ACnGO,SAAS,cAAc,OAAA,EAAkC;AAC9D,EAAA,MAAM,EAAE,IAAA,EAAM,OAAA,EAAS,QAAA,GAAW,KAAA,EAAO,aAAY,GAAI,OAAA;AAEzD,EAAA,MAAM,SAAA,GAAY,IAAI,gBAAA,EAAiB;AACvC,EAAA,IAAI,QAAA,GAA4B,IAAA;AAChC,EAAA,IAAI,YAAA,GAA6B;AAAA,IAC/B,IAAA,EAAM,OAAA;AAAA,IACN,YAAA,EAAc,SAAA;AAAA,IACd,QAAQ;AAAC,GACX;AACA,EAAA,IAAI,SAAA,GAAY,KAAA;AAGhB,EAAA,IAAI,UAAA,GAAmD,IAAA;AAGvD,EAAA,IAAI,QAAA,GAAqC,IAAA;AAIzC,EAAA,MAAM,KAAA,GAAQ,SAAA,CACX,OAAA,CAAQ,eAAA,EAAiB;AAAA,IACxB,eAAA,EAAiB,YAAA;AAAA,IACjB,UAAA,EAAY,EAAE,IAAA,EAAM,OAAA,EAAQ;AAAA,IAC5B,cAAc;AAAC,GAChB,CAAA,CACA,IAAA,CAAK,CAAC,MAAA,KAAW;AAChB,IAAA,QAAA,GAAW,WAAW,MAAM,CAAA;AAC5B,IAAA,YAAA,GAAe,QAAA,CAAS,KAAA;AAGxB,IAAA,SAAA,CAAU,IAAA,CAAK,8BAAA,EAAgC,EAAE,CAAA;AAGjD,IAAA,QAAA,GAAW,IAAI,iBAAA,CAAkB,SAAA,EAAW,WAAW,CAAA;AAAA,EACzD,CAAC,CAAA;AAGH,EAAA,MAAM,UAAA,GAAa,SAAA,CAAU,SAAA,CAAU,uCAAA,EAAyC,CAAC,MAAA,KAAW;AAC1F,IAAA,IAAI,CAAC,MAAA,EAAQ;AACb,IAAA,MAAM,IAAA,GAAO,MAAA,CAAO,KAAA,KAAU,MAAA,GAAS,MAAA,GAAS,OAAA;AAChD,IAAA,MAAM,MAAA,GACJ,OAAO,MAAA,IAAU,OAAO,OAAO,MAAA,KAAW,QAAA,GACrC,MAAA,CAAO,MAAA,GACR,YAAA,CAAa,MAAA;AACnB,IAAA,YAAA,GAAe,EAAE,IAAA,EAAM,YAAA,EAAc,YAAA,CAAa,cAAc,MAAA,EAAO;AACvE,IAAA,KAAA,MAAW,EAAA,IAAM,cAAA,EAAgB,EAAA,CAAG,YAAY,CAAA;AAAA,EAClD,CAAC,CAAA;AAGD,EAAA,MAAM,YAAA,GAAe,SAAA,CAAU,SAAA,CAAU,iBAAA,EAAmB,CAAC,MAAA,KAAW;AACtE,IAAA,IAAI,CAAC,MAAA,EAAQ;AACb,IAAA,MAAM,IAAA,GACJ,OAAO,IAAA,KAAS,MAAA,IAAU,OAAO,IAAA,KAAS,OAAA,GAAU,MAAA,CAAO,IAAA,GAAO,YAAA,CAAa,IAAA;AACjF,IAAA,MAAM,MAAA,GACJ,OAAO,MAAA,IAAU,OAAO,OAAO,MAAA,KAAW,QAAA,GACrC,MAAA,CAAO,MAAA,GACR,YAAA,CAAa,MAAA;AACnB,IAAA,YAAA,GAAe,EAAE,IAAA,EAAM,YAAA,EAAc,YAAA,CAAa,cAAc,MAAA,EAAO;AACvE,IAAA,KAAA,MAAW,EAAA,IAAM,cAAA,EAAgB,EAAA,CAAG,YAAY,CAAA;AAAA,EAClD,CAAC,CAAA;AAED,EAAA,MAAM,cAAA,uBAAqB,GAAA,EAAmC;AAC9D,EAAA,MAAM,aAAA,uBAAoB,GAAA,EAAuC;AACjE,EAAA,MAAM,eAAA,uBAAsB,GAAA,EAAmC;AAG/D,EAAA,MAAM,SAAA,GAAY,SAAA,CAAU,SAAA,CAAU,gBAAA,EAAkB,CAAC,MAAA,KAAW;AAClE,IAAA,IAAI,CAAC,MAAA,EAAQ;AACb,IAAA,MAAM,KAAA,GAA0B;AAAA,MAC9B,MAAA,EAAQ,OAAA;AAAA,MACR,MAAA,EAAS,OAAO,MAAA,IAAqB,EAAA;AAAA,MACrC,IAAA,EAAO,OAAO,IAAA,IAAmB;AAAA,KACnC;AACA,IAAA,KAAA,MAAW,EAAA,IAAM,aAAA,EAAe,EAAA,CAAG,KAAK,CAAA;AAAA,EAC1C,CAAC,CAAA;AAGD,EAAA,MAAM,WAAA,GAAc,SAAA,CAAU,SAAA,CAAU,WAAA,EAAa,CAAC,MAAA,KAAW;AAC/D,IAAA,IAAI,CAAC,MAAA,IAAU,OAAO,MAAA,CAAO,SAAS,QAAA,EAAU;AAChD,IAAA,MAAM,MAAA,GAAsB;AAAA,MAC1B,MAAM,MAAA,CAAO,IAAA;AAAA,MACb,OAAA,EAAU,MAAA,CAAO,OAAA,IAAuC,EAAC;AAAA,MACzD,oBAAA,EAAsB,OAAO,oBAAA,KAAyB,IAAA;AAAA,MACtD,OAAO,OAAO,MAAA,CAAO,KAAA,KAAU,QAAA,GAAW,OAAO,KAAA,GAAQ;AAAA,KAC3D;AACA,IAAA,KAAA,MAAW,EAAA,IAAM,eAAA,EAAiB,EAAA,CAAG,MAAM,CAAA;AAAA,EAC7C,CAAC,CAAA;AAED,EAAA,MAAM,IAAA,GAAO,MAAM,QAAA,EAAU,aAAA,KAAkB,IAAA;AAE/C,EAAA,MAAM,OAAA,GAAmB;AAAA,IACvB,IAAI,KAAA,GAAQ;AACV,MAAA,OAAO,KAAA;AAAA,IACT,CAAA;AAAA,IAEA,IAAI,iBAAA,GAAoB;AACtB,MAAA,OAAO,IAAA,EAAK;AAAA,IACd,CAAA;AAAA,IAEA,IAAI,SAAA,GAAY;AACd,MAAA,OAAO,SAAA;AAAA,IACT,CAAA;AAAA,IAEA,MAAM,QAAA,CACJ,QAAA,EACA,IAAA,EACkC;AAClC,MAAA,MAAM,MAAA,GAAkC;AAAA,QACtC,IAAA,EAAM,QAAA;AAAA,QACN,SAAA,EAAW,QAAQ;AAAC,OACtB;AAEA,MAAA,IAAI,QAAA,EAAU;AACZ,QAAA,MAAA,CAAO,MAAA,GAAS,IAAA;AAAA,MAClB;AACA,MAAA,MAAM,GAAA,GAAM,MAAM,SAAA,CAAU,OAAA,CAAQ,cAAc,MAAM,CAAA;AACxD,MAAA,OAAO,gBAAgB,GAAG,CAAA;AAAA,IAC5B,CAAA;AAAA,IAEA,cAAc,QAAA,EAAyD;AACrE,MAAA,aAAA,CAAc,IAAI,QAAQ,CAAA;AAC1B,MAAA,OAAO,MAAM;AACX,QAAA,aAAA,CAAc,OAAO,QAAQ,CAAA;AAAA,MAC/B,CAAA;AAAA,IACF,CAAA;AAAA,IAEA,SAAS,QAAA,EAAqD;AAC5D,MAAA,eAAA,CAAgB,IAAI,QAAQ,CAAA;AAC5B,MAAA,OAAO,MAAM;AACX,QAAA,eAAA,CAAgB,OAAO,QAAQ,CAAA;AAAA,MACjC,CAAA;AAAA,IACF,CAAA;AAAA,IAEA,QAAA,GAAyB;AACvB,MAAA,OAAO,EAAE,GAAG,YAAA,EAAa;AAAA,IAC3B,CAAA;AAAA,IAEA,eAAe,QAAA,EAAqD;AAClE,MAAA,cAAA,CAAe,IAAI,QAAQ,CAAA;AAC3B,MAAA,OAAO,MAAM;AACX,QAAA,cAAA,CAAe,OAAO,QAAQ,CAAA;AAAA,MAChC,CAAA;AAAA,IACF,CAAA;AAAA,IAEA,MAAA,CAAO,QAAgB,MAAA,EAAwC;AAC7D,MAAA,IAAI,CAAC,MAAK,EAAG;AACb,MAAA,SAAA,CAAU,KAAK,WAAA,EAAa,EAAE,MAAA,EAAQ,GAAG,QAAQ,CAAA;AAAA,IACnD,CAAA;AAAA,IAEA,IAAA,CAAK,SAAiB,OAAA,EAAsD;AAC1E,MAAA,IAAI,CAAC,MAAK,EAAG;AACb,MAAA,SAAA,CAAU,IAAA,CAAK,SAAA,EAAW,EAAE,OAAA,EAAS,SAAS,CAAA;AAAA,IAChD,CAAA;AAAA,IAEA,eAAA,CAAgB,OAAgC,OAAA,EAAwB;AACtE,MAAA,IAAI,CAAC,MAAK,EAAG;AAGb,MAAA,IAAI,UAAA,eAAyB,UAAU,CAAA;AACvC,MAAA,UAAA,GAAa,WAAW,MAAM;AAC5B,QAAA,SAAA,CAAU,KAAK,iBAAA,EAAmB;AAAA,UAChC,KAAA;AAAA,UACA,GAAI,OAAA,KAAY,MAAA,IAAa,EAAE,OAAA;AAAQ,SACxC,CAAA;AACD,QAAA,UAAA,GAAa,IAAA;AAAA,MACf,GAAG,GAAG,CAAA;AAAA,IACR,CAAA;AAAA,IAEA,YAAA,CAAa,QAAA,EAAkB,OAAA,EAAwB,QAAA,EAAyB;AAC9E,MAAA,IAAI,CAAC,MAAK,EAAG;AACb,MAAA,MAAM,IAAA,GAAO,OAAO,OAAA,KAAY,QAAA,GAAW,OAAA,GAAU,iCAAA;AACrD,MAAA,SAAA,CAAU,KAAK,iBAAA,EAAmB;AAAA,QAChC,IAAA;AAAA,QACA,QAAA;AAAA,QACA,UAAU,QAAA,IAAY;AAAA,OACvB,CAAA;AAAA,IACH,CAAA;AAAA,IAEA,SAAS,GAAA,EAAmB;AAC1B,MAAA,IAAI,MAAK,EAAG;AACV,QAAA,SAAA,CAAU,IAAA,CAAK,aAAA,EAAe,EAAE,GAAA,EAAK,CAAA;AAAA,MACvC,CAAA,MAAO;AACL,QAAA,MAAA,CAAO,IAAA,CAAK,GAAA,EAAK,QAAA,EAAU,UAAU,CAAA;AAAA,MACvC;AAAA,IACF,CAAA;AAAA,IAEA,UAAA,CACE,QACA,QAAA,EACY;AACZ,MAAA,OAAO,SAAA,CAAU,SAAA,CAAU,MAAA,EAAQ,QAAQ,CAAA;AAAA,IAC7C,CAAA;AAAA,IAEA,QAAA,CAAS,QAAgB,MAAA,EAAoD;AAC3E,MAAA,OAAO,SAAA,CAAU,OAAA,CAAQ,MAAA,EAAQ,MAAM,CAAA;AAAA,IACzC,CAAA;AAAA,IAEA,OAAA,GAAgB;AACd,MAAA,IAAI,SAAA,EAAW;AACf,MAAA,SAAA,GAAY,IAAA;AAEZ,MAAA,IAAI,UAAA,eAAyB,UAAU,CAAA;AACvC,MAAA,QAAA,EAAU,OAAA,EAAQ;AAClB,MAAA,UAAA,EAAW;AACX,MAAA,YAAA,EAAa;AACb,MAAA,SAAA,EAAU;AACV,MAAA,WAAA,EAAY;AACZ,MAAA,cAAA,CAAe,KAAA,EAAM;AACrB,MAAA,aAAA,CAAc,KAAA,EAAM;AACpB,MAAA,eAAA,CAAgB,KAAA,EAAM;AACtB,MAAA,SAAA,CAAU,OAAA,EAAQ;AAAA,IACpB;AAAA,GACF;AAEA,EAAA,OAAO,OAAA;AACT","file":"chunk-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"]}

package/dist/{chunk-JZC3VC2C.js → chunk-BWSAQV3P.js}

@@ -244,6 +244,7 @@ function createSynapse(options) {
   });
   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 = {
@@ -253,6 +254,16 @@ function createSynapse(options) {
     };
     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() {
@@ -261,6 +272,9 @@ function createSynapse(options) {
     get isNimbleBrainHost() {
       return isNB();
     },
+    get destroyed() {
+      return destroyed;
+    },
     async callTool(toolName, args) {
       const params = {
         name: toolName,
@@ -278,6 +292,12 @@ function createSynapse(options) {
         dataCallbacks.delete(callback);
       };
     },
+    onAction(callback) {
+      actionCallbacks.add(callback);
+      return () => {
+        actionCallbacks.delete(callback);
+      };
+    },
     getTheme() {
       return { ...currentTheme };
     },
@@ -336,8 +356,10 @@ function createSynapse(options) {
       unsubTheme();
       unsubNbTheme();
       unsubData();
+      unsubAction();
       themeCallbacks.clear();
       dataCallbacks.clear();
+      actionCallbacks.clear();
       transport.destroy();
     }
   };
@@ -345,5 +367,5 @@ function createSynapse(options) {
 }
 
 export { createSynapse };
-//# sourceMappingURL=chunk-JZC3VC2C.js.map
-//# sourceMappingURL=chunk-JZC3VC2C.js.map
+//# sourceMappingURL=chunk-BWSAQV3P.js.map
+//# sourceMappingURL=chunk-BWSAQV3P.js.map

package/dist/chunk-BWSAQV3P.js.map

@@ -0,0 +1 @@
+{"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"]}

package/dist/codegen/cli.cjs

@@ -58,7 +58,7 @@ async function runCodegen(args2) {
   }
 }
 async function runPreview(args2) {
-  const { startPreview } = await import('../server-SEI7XI3B.cjs');
+  const { startPreview } = await import('../server-3BDZ5S72.cjs');
   const flags = parseFlags(args2, ["server", "ui", "server-port", "ui-port", "port"]);
   if (!flags.server || !flags.ui) {
     console.error("Usage:");

package/dist/codegen/cli.js

@@ -56,7 +56,7 @@ async function runCodegen(args2) {
   }
 }
 async function runPreview(args2) {
-  const { startPreview } = await import('../server-RUCX2TIB.js');
+  const { startPreview } = await import('../server-NNW54YW5.js');
   const flags = parseFlags(args2, ["server", "ui", "server-port", "ui-port", "port"]);
   if (!flags.server || !flags.ui) {
     console.error("Usage:");

package/dist/codegen/index.d.cts

@@ -1,4 +1,4 @@
-import { g as ToolDefinition } from '../types-BP0SNrpo.cjs';
+import { i as ToolDefinition } from '../types-BL15lUqi.cjs';
 
 /**
  * Read tool definitions from a manifest.json file.

package/dist/codegen/index.d.ts

@@ -1,4 +1,4 @@
-import { g as ToolDefinition } from '../types-BP0SNrpo.js';
+import { i as ToolDefinition } from '../types-BL15lUqi.js';
 
 /**
  * Read tool definitions from a manifest.json file.

package/dist/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkQ7OSHSGZ_cjs = require('./chunk-Q7OSHSGZ.cjs');
+var chunkABJP7PL4_cjs = require('./chunk-ABJP7PL4.cjs');
 
 // src/store.ts
 function createStore(synapse, config) {
@@ -80,7 +80,7 @@ function createStore(synapse, config) {
 
 Object.defineProperty(exports, "createSynapse", {
   enumerable: true,
-  get: function () { return chunkQ7OSHSGZ_cjs.createSynapse; }
+  get: function () { return chunkABJP7PL4_cjs.createSynapse; }
 });
 exports.createStore = createStore;
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

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

package/dist/index.d.ts

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

package/dist/index.js

@@ -1,4 +1,4 @@
-export { createSynapse } from './chunk-JZC3VC2C.js';
+export { createSynapse } from './chunk-BWSAQV3P.js';
 
 // src/store.ts
 function createStore(synapse, config) {

package/dist/react/index.cjs

@@ -1,21 +1,15 @@
 'use strict';
 
-var chunkQ7OSHSGZ_cjs = require('../chunk-Q7OSHSGZ.cjs');
+var chunkABJP7PL4_cjs = require('../chunk-ABJP7PL4.cjs');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
 var SynapseContext = react.createContext(null);
 function SynapseProvider({ children, ...options }) {
   const ref = react.useRef(null);
-  if (ref.current === null) {
-    ref.current = chunkQ7OSHSGZ_cjs.createSynapse(options);
+  if (ref.current === null || ref.current.destroyed) {
+    ref.current = chunkABJP7PL4_cjs.createSynapse(options);
   }
-  react.useEffect(() => {
-    return () => {
-      ref.current?.destroy();
-      ref.current = null;
-    };
-  }, []);
   return /* @__PURE__ */ jsxRuntime.jsx(SynapseContext.Provider, { value: ref.current, children });
 }
 function useSynapseContext() {
@@ -71,6 +65,14 @@ function useDataSync(callback) {
     return synapse.onDataChanged((event) => callbackRef.current(event));
   }, [synapse]);
 }
+function useAgentAction(callback) {
+  const synapse = useSynapseContext();
+  const callbackRef = react.useRef(callback);
+  callbackRef.current = callback;
+  react.useEffect(() => {
+    return synapse.onAction((action) => callbackRef.current(action));
+  }, [synapse]);
+}
 function useTheme() {
   const synapse = useSynapseContext();
   const [theme, setTheme] = react.useState(() => synapse.getTheme());
@@ -112,6 +114,7 @@ function useStore(store) {
 
 exports.SynapseProvider = SynapseProvider;
 exports.useAction = useAction;
+exports.useAgentAction = useAgentAction;
 exports.useCallTool = useCallTool;
 exports.useChat = useChat;
 exports.useDataSync = useDataSync;

package/dist/react/index.cjs.map

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

package/dist/react/index.d.cts

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

package/dist/react/index.d.ts

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

package/dist/react/index.js

@@ -1,19 +1,13 @@
-import { createSynapse } from '../chunk-JZC3VC2C.js';
-import { createContext, useRef, useEffect, useState, useCallback, useSyncExternalStore, useContext } from 'react';
+import { createSynapse } from '../chunk-BWSAQV3P.js';
+import { createContext, useRef, useState, useCallback, useEffect, useSyncExternalStore, useContext } from 'react';
 import { jsx } from 'react/jsx-runtime';
 
 var SynapseContext = createContext(null);
 function SynapseProvider({ children, ...options }) {
   const ref = useRef(null);
-  if (ref.current === null) {
+  if (ref.current === null || ref.current.destroyed) {
     ref.current = createSynapse(options);
   }
-  useEffect(() => {
-    return () => {
-      ref.current?.destroy();
-      ref.current = null;
-    };
-  }, []);
   return /* @__PURE__ */ jsx(SynapseContext.Provider, { value: ref.current, children });
 }
 function useSynapseContext() {
@@ -69,6 +63,14 @@ function useDataSync(callback) {
     return synapse.onDataChanged((event) => callbackRef.current(event));
   }, [synapse]);
 }
+function useAgentAction(callback) {
+  const synapse = useSynapseContext();
+  const callbackRef = useRef(callback);
+  callbackRef.current = callback;
+  useEffect(() => {
+    return synapse.onAction((action) => callbackRef.current(action));
+  }, [synapse]);
+}
 function useTheme() {
   const synapse = useSynapseContext();
   const [theme, setTheme] = useState(() => synapse.getTheme());
@@ -108,6 +110,6 @@ function useStore(store) {
   return { state, dispatch: store.dispatch };
 }
 
-export { SynapseProvider, useAction, useCallTool, useChat, useDataSync, useStore, useSynapse, useTheme, useVisibleState };
+export { SynapseProvider, useAction, useAgentAction, useCallTool, useChat, useDataSync, useStore, useSynapse, useTheme, useVisibleState };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map