@nimblebrain/synapse 0.1.0

package/dist/react/index.js

@@ -0,0 +1,113 @@
+import { createSynapse } from '../chunk-JZC3VC2C.js';
+import { createContext, useRef, useEffect, useState, useCallback, 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) {
+    ref.current = createSynapse(options);
+  }
+  useEffect(() => {
+    return () => {
+      ref.current?.destroy();
+      ref.current = null;
+    };
+  }, []);
+  return /* @__PURE__ */ jsx(SynapseContext.Provider, { value: ref.current, children });
+}
+function useSynapseContext() {
+  const ctx = useContext(SynapseContext);
+  if (!ctx) {
+    throw new Error(
+      "useSynapse must be used within a <SynapseProvider>. Wrap your app component tree with <SynapseProvider>."
+    );
+  }
+  return ctx;
+}
+
+// src/react/hooks.ts
+function useSynapse() {
+  return useSynapseContext();
+}
+function useCallTool(toolName) {
+  const synapse = useSynapseContext();
+  const [isPending, setIsPending] = useState(false);
+  const [error, setError] = useState(null);
+  const [data, setData] = useState(null);
+  const callIdRef = useRef(0);
+  const call = useCallback(
+    async (args) => {
+      const id = ++callIdRef.current;
+      setIsPending(true);
+      setError(null);
+      try {
+        const result = await synapse.callTool(toolName, args);
+        if (id === callIdRef.current) {
+          setData(result.data);
+          setIsPending(false);
+        }
+        return result;
+      } catch (err) {
+        if (id === callIdRef.current) {
+          const e = err instanceof Error ? err : new Error(String(err));
+          setError(e);
+          setIsPending(false);
+        }
+        throw err;
+      }
+    },
+    [synapse, toolName]
+  );
+  return { call, isPending, error, data };
+}
+function useDataSync(callback) {
+  const synapse = useSynapseContext();
+  const callbackRef = useRef(callback);
+  callbackRef.current = callback;
+  useEffect(() => {
+    return synapse.onDataChanged((event) => callbackRef.current(event));
+  }, [synapse]);
+}
+function useTheme() {
+  const synapse = useSynapseContext();
+  const [theme, setTheme] = useState(() => synapse.getTheme());
+  useEffect(() => {
+    setTheme(synapse.getTheme());
+    return synapse.onThemeChanged(setTheme);
+  }, [synapse]);
+  return theme;
+}
+function useAction() {
+  const synapse = useSynapseContext();
+  return useCallback(
+    (action, params) => synapse.action(action, params),
+    [synapse]
+  );
+}
+function useChat() {
+  const synapse = useSynapseContext();
+  return useCallback(
+    (message, context) => synapse.chat(message, context),
+    [synapse]
+  );
+}
+function useVisibleState() {
+  const synapse = useSynapseContext();
+  return useCallback(
+    (state, summary) => synapse.setVisibleState(state, summary),
+    [synapse]
+  );
+}
+function useStore(store) {
+  const state = useSyncExternalStore(
+    (onStoreChange) => store.subscribe(onStoreChange),
+    () => store.getState(),
+    () => store.getState()
+  );
+  return { state, dispatch: store.dispatch };
+}
+
+export { SynapseProvider, useAction, useCallTool, useChat, useDataSync, useStore, useSynapse, useTheme, useVisibleState };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/provider.tsx","../../src/react/hooks.ts"],"names":["useRef","useEffect"],"mappings":";;;;AAIA,IAAM,cAAA,GAAiB,cAA8B,IAAI,CAAA;AAMlD,SAAS,eAAA,CAAgB,EAAE,QAAA,EAAU,GAAG,SAAQ,EAAyB;AAC9E,EAAA,MAAM,GAAA,GAAM,OAAuB,IAAI,CAAA;AAEvC,EAAA,IAAI,GAAA,CAAI,YAAY,IAAA,EAAM;AACxB,IAAA,GAAA,CAAI,OAAA,GAAU,cAAc,OAAO,CAAA;AAAA,EACrC;AAEA,EAAA,SAAA,CAAU,MAAM;AAGd,IAAA,OAAO,MAAM;AACX,MAAA,GAAA,CAAI,SAAS,OAAA,EAAQ;AACrB,MAAA,GAAA,CAAI,OAAA,GAAU,IAAA;AAAA,IAChB,CAAA;AAAA,EACF,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,2BAAQ,cAAA,CAAe,QAAA,EAAf,EAAwB,KAAA,EAAO,GAAA,CAAI,SAAU,QAAA,EAAS,CAAA;AAChE;AAEO,SAAS,iBAAA,GAA6B;AAC3C,EAAA,MAAM,GAAA,GAAM,WAAW,cAAc,CAAA;AACrC,EAAA,IAAI,CAAC,GAAA,EAAK;AACR,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KAEF;AAAA,EACF;AACA,EAAA,OAAO,GAAA;AACT;;;ACvBO,SAAS,UAAA,GAAsB;AACpC,EAAA,OAAO,iBAAA,EAAkB;AAC3B;AAEO,SAAS,YACd,QAAA,EAMA;AACA,EAAA,MAAM,UAAU,iBAAA,EAAkB;AAClC,EAAA,MAAM,CAAC,SAAA,EAAW,YAAY,CAAA,GAAI,SAAS,KAAK,CAAA;AAChD,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAI,SAAuB,IAAI,CAAA;AACrD,EAAA,MAAM,CAAC,IAAA,EAAM,OAAO,CAAA,GAAI,SAAyB,IAAI,CAAA;AACrD,EAAA,MAAM,SAAA,GAAYA,OAAO,CAAC,CAAA;AAE1B,EAAA,MAAM,IAAA,GAAO,WAAA;AAAA,IACX,OAAO,IAAA,KAAqE;AAC1E,MAAA,MAAM,EAAA,GAAK,EAAE,SAAA,CAAU,OAAA;AACvB,MAAA,YAAA,CAAa,IAAI,CAAA;AACjB,MAAA,QAAA,CAAS,IAAI,CAAA;AAEb,MAAA,IAAI;AACF,QAAA,MAAM,MAAA,GAAS,MAAM,OAAA,CAAQ,QAAA,CAA2C,UAAU,IAAI,CAAA;AAEtF,QAAA,IAAI,EAAA,KAAO,UAAU,OAAA,EAAS;AAC5B,UAAA,OAAA,CAAQ,OAAO,IAAI,CAAA;AACnB,UAAA,YAAA,CAAa,KAAK,CAAA;AAAA,QACpB;AACA,QAAA,OAAO,MAAA;AAAA,MACT,SAAS,GAAA,EAAK;AACZ,QAAA,IAAI,EAAA,KAAO,UAAU,OAAA,EAAS;AAC5B,UAAA,MAAM,CAAA,GAAI,eAAe,KAAA,GAAQ,GAAA,GAAM,IAAI,KAAA,CAAM,MAAA,CAAO,GAAG,CAAC,CAAA;AAC5D,UAAA,QAAA,CAAS,CAAC,CAAA;AACV,UAAA,YAAA,CAAa,KAAK,CAAA;AAAA,QACpB;AACA,QAAA,MAAM,GAAA;AAAA,MACR;AAAA,IACF,CAAA;AAAA,IACA,CAAC,SAAS,QAAQ;AAAA,GACpB;AAEA,EAAA,OAAO,EAAE,IAAA,EAAM,SAAA,EAAW,KAAA,EAAO,IAAA,EAAK;AACxC;AAEO,SAAS,YAAY,QAAA,EAAmD;AAC7E,EAAA,MAAM,UAAU,iBAAA,EAAkB;AAClC,EAAA,MAAM,WAAA,GAAcA,OAAO,QAAQ,CAAA;AACnC,EAAA,WAAA,CAAY,OAAA,GAAU,QAAA;AAEtB,EAAAC,UAAU,MAAM;AACd,IAAA,OAAO,QAAQ,aAAA,CAAc,CAAC,UAAU,WAAA,CAAY,OAAA,CAAQ,KAAK,CAAC,CAAA;AAAA,EACpE,CAAA,EAAG,CAAC,OAAO,CAAC,CAAA;AACd;AAEO,SAAS,QAAA,GAAyB;AACvC,EAAA,MAAM,UAAU,iBAAA,EAAkB;AAClC,EAAA,MAAM,CAAC,OAAO,QAAQ,CAAA,GAAI,SAAuB,MAAM,OAAA,CAAQ,UAAU,CAAA;AAEzE,EAAAA,UAAU,MAAM;AAEd,IAAA,QAAA,CAAS,OAAA,CAAQ,UAAU,CAAA;AAC3B,IAAA,OAAO,OAAA,CAAQ,eAAe,QAAQ,CAAA;AAAA,EACxC,CAAA,EAAG,CAAC,OAAO,CAAC,CAAA;AAEZ,EAAA,OAAO,KAAA;AACT;AAEO,SAAS,SAAA,GAAwE;AACtF,EAAA,MAAM,UAAU,iBAAA,EAAkB;AAClC,EAAA,OAAO,WAAA;AAAA,IACL,CAAC,MAAA,EAAgB,MAAA,KAAqC,OAAA,CAAQ,MAAA,CAAO,QAAQ,MAAM,CAAA;AAAA,IACnF,CAAC,OAAO;AAAA,GACV;AACF;AAEO,SAAS,OAAA,GAGN;AACR,EAAA,MAAM,UAAU,iBAAA,EAAkB;AAClC,EAAA,OAAO,WAAA;AAAA,IACL,CAAC,OAAA,EAAiB,OAAA,KAChB,OAAA,CAAQ,IAAA,CAAK,SAAS,OAAO,CAAA;AAAA,IAC/B,CAAC,OAAO;AAAA,GACV;AACF;AAEO,SAAS,eAAA,GAA8E;AAC5F,EAAA,MAAM,UAAU,iBAAA,EAAkB;AAClC,EAAA,OAAO,WAAA;AAAA,IACL,CAAC,KAAA,EAAgC,OAAA,KAAqB,OAAA,CAAQ,eAAA,CAAgB,OAAO,OAAO,CAAA;AAAA,IAC5F,CAAC,OAAO;AAAA,GACV;AACF;AAEO,SAAS,SACd,KAAA,EAIA;AACA,EAAA,MAAM,KAAA,GAAQ,oBAAA;AAAA,IACZ,CAAC,aAAA,KAAkB,KAAA,CAAM,SAAA,CAAU,aAAa,CAAA;AAAA,IAChD,MAAM,MAAM,QAAA,EAAS;AAAA,IACrB,MAAM,MAAM,QAAA;AAAS,GACvB;AAEA,EAAA,OAAO,EAAE,KAAA,EAAO,QAAA,EAAU,KAAA,CAAM,QAAA,EAAS;AAC3C","file":"index.js","sourcesContent":["import { createContext, type ReactNode, useContext, useEffect, useRef } from \"react\";\nimport { createSynapse } from \"../core.js\";\nimport type { Synapse, SynapseOptions } from \"../types.js\";\n\nconst SynapseContext = createContext<Synapse | null>(null);\n\nexport interface SynapseProviderProps extends SynapseOptions {\n  children: ReactNode;\n}\n\nexport function SynapseProvider({ children, ...options }: SynapseProviderProps) {\n  const ref = useRef<Synapse | null>(null);\n\n  if (ref.current === null) {\n    ref.current = createSynapse(options);\n  }\n\n  useEffect(() => {\n    // StrictMode: on double-mount, the ref may already have an instance.\n    // The ref was created synchronously above, so it's always valid here.\n    return () => {\n      ref.current?.destroy();\n      ref.current = null;\n    };\n  }, []);\n\n  return <SynapseContext.Provider value={ref.current}>{children}</SynapseContext.Provider>;\n}\n\nexport function useSynapseContext(): Synapse {\n  const ctx = useContext(SynapseContext);\n  if (!ctx) {\n    throw new Error(\n      \"useSynapse must be used within a <SynapseProvider>. \" +\n        \"Wrap your app component tree with <SynapseProvider>.\",\n    );\n  }\n  return ctx;\n}\n","import { useCallback, useEffect, useRef, useState, useSyncExternalStore } from \"react\";\nimport type {\n  ActionReducer,\n  DataChangedEvent,\n  Store,\n  StoreDispatch,\n  Synapse,\n  SynapseTheme,\n  ToolCallResult,\n} from \"../types.js\";\nimport { SynapseProvider, useSynapseContext } from \"./provider.js\";\n\n// Re-export provider components\nexport { SynapseProvider };\n\nexport function useSynapse(): Synapse {\n  return useSynapseContext();\n}\n\nexport function useCallTool<TOutput = unknown>(\n  toolName: string,\n): {\n  call: (args?: Record<string, unknown>) => Promise<ToolCallResult<TOutput>>;\n  isPending: boolean;\n  error: Error | null;\n  data: TOutput | null;\n} {\n  const synapse = useSynapseContext();\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [data, setData] = useState<TOutput | null>(null);\n  const callIdRef = useRef(0);\n\n  const call = useCallback(\n    async (args?: Record<string, unknown>): Promise<ToolCallResult<TOutput>> => {\n      const id = ++callIdRef.current;\n      setIsPending(true);\n      setError(null);\n\n      try {\n        const result = await synapse.callTool<Record<string, unknown>, TOutput>(toolName, args);\n        // Stale guard: only update if this is still the latest call\n        if (id === callIdRef.current) {\n          setData(result.data);\n          setIsPending(false);\n        }\n        return result;\n      } catch (err) {\n        if (id === callIdRef.current) {\n          const e = err instanceof Error ? err : new Error(String(err));\n          setError(e);\n          setIsPending(false);\n        }\n        throw err;\n      }\n    },\n    [synapse, toolName],\n  );\n\n  return { call, isPending, error, data };\n}\n\nexport function useDataSync(callback: (event: DataChangedEvent) => void): void {\n  const synapse = useSynapseContext();\n  const callbackRef = useRef(callback);\n  callbackRef.current = callback;\n\n  useEffect(() => {\n    return synapse.onDataChanged((event) => callbackRef.current(event));\n  }, [synapse]);\n}\n\nexport function useTheme(): SynapseTheme {\n  const synapse = useSynapseContext();\n  const [theme, setTheme] = useState<SynapseTheme>(() => synapse.getTheme());\n\n  useEffect(() => {\n    // Sync in case theme changed between render and effect\n    setTheme(synapse.getTheme());\n    return synapse.onThemeChanged(setTheme);\n  }, [synapse]);\n\n  return theme;\n}\n\nexport function useAction(): (action: string, params?: Record<string, unknown>) => void {\n  const synapse = useSynapseContext();\n  return useCallback(\n    (action: string, params?: Record<string, unknown>) => synapse.action(action, params),\n    [synapse],\n  );\n}\n\nexport function useChat(): (\n  message: string,\n  context?: { action?: string; entity?: string },\n) => void {\n  const synapse = useSynapseContext();\n  return useCallback(\n    (message: string, context?: { action?: string; entity?: string }) =>\n      synapse.chat(message, context),\n    [synapse],\n  );\n}\n\nexport function useVisibleState(): (state: Record<string, unknown>, summary?: string) => void {\n  const synapse = useSynapseContext();\n  return useCallback(\n    (state: Record<string, unknown>, summary?: string) => synapse.setVisibleState(state, summary),\n    [synapse],\n  );\n}\n\nexport function useStore<TState, TActions extends Record<string, ActionReducer<TState, any>>>(\n  store: Store<TState, TActions>,\n): {\n  state: TState;\n  dispatch: StoreDispatch<TActions>;\n} {\n  const state = useSyncExternalStore(\n    (onStoreChange) => store.subscribe(onStoreChange),\n    () => store.getState(),\n    () => store.getState(),\n  );\n\n  return { state, dispatch: store.dispatch };\n}\n"]}

package/dist/synapse-runtime.iife.global.js

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

package/dist/types-BP0SNrpo.d.cts

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

package/dist/types-BP0SNrpo.d.ts

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

package/dist/vite/index.cjs

@@ -0,0 +1,49 @@
+'use strict';
+
+// src/vite/plugin.ts
+function synapseVite(options) {
+  const { appName, platformUrl = "http://localhost:4321", injectBridge = true } = options;
+  return {
+    name: "synapse",
+    config() {
+      return {
+        define: {
+          "import.meta.env.SYNAPSE_PLATFORM_URL": JSON.stringify(platformUrl),
+          "import.meta.env.SYNAPSE_APP_NAME": JSON.stringify(appName)
+        },
+        server: {
+          hmr: {
+            // Required for HMR inside sandboxed iframe
+            protocol: "ws",
+            host: "localhost"
+          }
+        }
+      };
+    },
+    configureServer(server) {
+      server.middlewares.use((_req, res, next) => {
+        res.setHeader("Access-Control-Allow-Origin", "*");
+        res.setHeader("Access-Control-Allow-Methods", "*");
+        res.setHeader("Access-Control-Allow-Headers", "*");
+        next();
+      });
+    },
+    transformIndexHtml(html) {
+      if (!injectBridge) return html;
+      const bridgeScript = `
+<script type="module">
+  import { createSynapse } from "@nimblebrain/synapse";
+  window.__synapse = createSynapse({
+    name: ${JSON.stringify(appName)},
+    version: "0.0.0-dev",
+  });
+</script>`;
+      return html.replace("</head>", `${bridgeScript}
+</head>`);
+    }
+  };
+}
+
+exports.synapseVite = synapseVite;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/vite/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/vite/plugin.ts"],"names":[],"mappings":";;;AAmBO,SAAS,YAAY,OAAA,EAA2C;AACrE,EAAA,MAAM,EAAE,OAAA,EAAS,WAAA,GAAc,uBAAA,EAAyB,YAAA,GAAe,MAAK,GAAI,OAAA;AAEhF,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,SAAA;AAAA,IAEN,MAAA,GAAS;AACP,MAAA,OAAO;AAAA,QACL,MAAA,EAAQ;AAAA,UACN,sCAAA,EAAwC,IAAA,CAAK,SAAA,CAAU,WAAW,CAAA;AAAA,UAClE,kCAAA,EAAoC,IAAA,CAAK,SAAA,CAAU,OAAO;AAAA,SAC5D;AAAA,QACA,MAAA,EAAQ;AAAA,UACN,GAAA,EAAK;AAAA;AAAA,YAEH,QAAA,EAAU,IAAA;AAAA,YACV,IAAA,EAAM;AAAA;AACR;AACF,OACF;AAAA,IACF,CAAA;AAAA,IAEA,gBAAgB,MAAA,EAAuB;AAErC,MAAA,MAAA,CAAO,WAAA,CAAY,GAAA,CAAI,CAAC,IAAA,EAAM,KAAK,IAAA,KAAS;AAC1C,QAAA,GAAA,CAAI,SAAA,CAAU,+BAA+B,GAAG,CAAA;AAChD,QAAA,GAAA,CAAI,SAAA,CAAU,gCAAgC,GAAG,CAAA;AACjD,QAAA,GAAA,CAAI,SAAA,CAAU,gCAAgC,GAAG,CAAA;AACjD,QAAA,IAAA,EAAK;AAAA,MACP,CAAC,CAAA;AAAA,IACH,CAAA;AAAA,IAEA,mBAAmB,IAAA,EAAc;AAC/B,MAAA,IAAI,CAAC,cAAc,OAAO,IAAA;AAE1B,MAAA,MAAM,YAAA,GAAe;AAAA;AAAA;AAAA;AAAA,UAAA,EAIf,IAAA,CAAK,SAAA,CAAU,OAAO,CAAC,CAAA;AAAA;AAAA;AAAA,SAAA,CAAA;AAM7B,MAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,SAAA,EAAW,CAAA,EAAG,YAAY;AAAA,OAAA,CAAW,CAAA;AAAA,IAC3D;AAAA,GACF;AACF","file":"index.cjs","sourcesContent":["import type { Plugin, ViteDevServer } from \"vite\";\n\nexport interface SynapseVitePluginOptions {\n  /** App name (must match manifest) */\n  appName: string;\n  /** Platform API URL (default: http://localhost:4321) */\n  platformUrl?: string;\n  /** Auto-inject bridge runtime into HTML entry (default: true) */\n  injectBridge?: boolean;\n}\n\n/**\n * Vite plugin for Synapse app development.\n *\n * - Configures CORS for cross-origin iframe communication\n * - Injects ext-apps bridge runtime if `injectBridge` is true\n * - Sets up HMR WebSocket to work inside iframe sandbox\n * - Exposes platform URL as `import.meta.env.SYNAPSE_PLATFORM_URL`\n */\nexport function synapseVite(options: SynapseVitePluginOptions): Plugin {\n  const { appName, platformUrl = \"http://localhost:4321\", injectBridge = true } = options;\n\n  return {\n    name: \"synapse\",\n\n    config() {\n      return {\n        define: {\n          \"import.meta.env.SYNAPSE_PLATFORM_URL\": JSON.stringify(platformUrl),\n          \"import.meta.env.SYNAPSE_APP_NAME\": JSON.stringify(appName),\n        },\n        server: {\n          hmr: {\n            // Required for HMR inside sandboxed iframe\n            protocol: \"ws\",\n            host: \"localhost\",\n          },\n        },\n      };\n    },\n\n    configureServer(server: ViteDevServer) {\n      // Add CORS headers for cross-origin iframe communication\n      server.middlewares.use((_req, res, next) => {\n        res.setHeader(\"Access-Control-Allow-Origin\", \"*\");\n        res.setHeader(\"Access-Control-Allow-Methods\", \"*\");\n        res.setHeader(\"Access-Control-Allow-Headers\", \"*\");\n        next();\n      });\n    },\n\n    transformIndexHtml(html: string) {\n      if (!injectBridge) return html;\n\n      const bridgeScript = `\n<script type=\"module\">\n  import { createSynapse } from \"@nimblebrain/synapse\";\n  window.__synapse = createSynapse({\n    name: ${JSON.stringify(appName)},\n    version: \"0.0.0-dev\",\n  });\n</script>`;\n\n      // Inject before closing </head> tag\n      return html.replace(\"</head>\", `${bridgeScript}\\n</head>`);\n    },\n  };\n}\n"]}

package/dist/vite/index.d.cts

@@ -0,0 +1,21 @@
+import { Plugin } from 'vite';
+
+interface SynapseVitePluginOptions {
+    /** App name (must match manifest) */
+    appName: string;
+    /** Platform API URL (default: http://localhost:4321) */
+    platformUrl?: string;
+    /** Auto-inject bridge runtime into HTML entry (default: true) */
+    injectBridge?: boolean;
+}
+/**
+ * Vite plugin for Synapse app development.
+ *
+ * - Configures CORS for cross-origin iframe communication
+ * - Injects ext-apps bridge runtime if `injectBridge` is true
+ * - Sets up HMR WebSocket to work inside iframe sandbox
+ * - Exposes platform URL as `import.meta.env.SYNAPSE_PLATFORM_URL`
+ */
+declare function synapseVite(options: SynapseVitePluginOptions): Plugin;
+
+export { type SynapseVitePluginOptions, synapseVite };

package/dist/vite/index.d.ts

@@ -0,0 +1,21 @@
+import { Plugin } from 'vite';
+
+interface SynapseVitePluginOptions {
+    /** App name (must match manifest) */
+    appName: string;
+    /** Platform API URL (default: http://localhost:4321) */
+    platformUrl?: string;
+    /** Auto-inject bridge runtime into HTML entry (default: true) */
+    injectBridge?: boolean;
+}
+/**
+ * Vite plugin for Synapse app development.
+ *
+ * - Configures CORS for cross-origin iframe communication
+ * - Injects ext-apps bridge runtime if `injectBridge` is true
+ * - Sets up HMR WebSocket to work inside iframe sandbox
+ * - Exposes platform URL as `import.meta.env.SYNAPSE_PLATFORM_URL`
+ */
+declare function synapseVite(options: SynapseVitePluginOptions): Plugin;
+
+export { type SynapseVitePluginOptions, synapseVite };

package/dist/vite/index.js

@@ -0,0 +1,47 @@
+// src/vite/plugin.ts
+function synapseVite(options) {
+  const { appName, platformUrl = "http://localhost:4321", injectBridge = true } = options;
+  return {
+    name: "synapse",
+    config() {
+      return {
+        define: {
+          "import.meta.env.SYNAPSE_PLATFORM_URL": JSON.stringify(platformUrl),
+          "import.meta.env.SYNAPSE_APP_NAME": JSON.stringify(appName)
+        },
+        server: {
+          hmr: {
+            // Required for HMR inside sandboxed iframe
+            protocol: "ws",
+            host: "localhost"
+          }
+        }
+      };
+    },
+    configureServer(server) {
+      server.middlewares.use((_req, res, next) => {
+        res.setHeader("Access-Control-Allow-Origin", "*");
+        res.setHeader("Access-Control-Allow-Methods", "*");
+        res.setHeader("Access-Control-Allow-Headers", "*");
+        next();
+      });
+    },
+    transformIndexHtml(html) {
+      if (!injectBridge) return html;
+      const bridgeScript = `
+<script type="module">
+  import { createSynapse } from "@nimblebrain/synapse";
+  window.__synapse = createSynapse({
+    name: ${JSON.stringify(appName)},
+    version: "0.0.0-dev",
+  });
+</script>`;
+      return html.replace("</head>", `${bridgeScript}
+</head>`);
+    }
+  };
+}
+
+export { synapseVite };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/vite/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/vite/plugin.ts"],"names":[],"mappings":";AAmBO,SAAS,YAAY,OAAA,EAA2C;AACrE,EAAA,MAAM,EAAE,OAAA,EAAS,WAAA,GAAc,uBAAA,EAAyB,YAAA,GAAe,MAAK,GAAI,OAAA;AAEhF,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,SAAA;AAAA,IAEN,MAAA,GAAS;AACP,MAAA,OAAO;AAAA,QACL,MAAA,EAAQ;AAAA,UACN,sCAAA,EAAwC,IAAA,CAAK,SAAA,CAAU,WAAW,CAAA;AAAA,UAClE,kCAAA,EAAoC,IAAA,CAAK,SAAA,CAAU,OAAO;AAAA,SAC5D;AAAA,QACA,MAAA,EAAQ;AAAA,UACN,GAAA,EAAK;AAAA;AAAA,YAEH,QAAA,EAAU,IAAA;AAAA,YACV,IAAA,EAAM;AAAA;AACR;AACF,OACF;AAAA,IACF,CAAA;AAAA,IAEA,gBAAgB,MAAA,EAAuB;AAErC,MAAA,MAAA,CAAO,WAAA,CAAY,GAAA,CAAI,CAAC,IAAA,EAAM,KAAK,IAAA,KAAS;AAC1C,QAAA,GAAA,CAAI,SAAA,CAAU,+BAA+B,GAAG,CAAA;AAChD,QAAA,GAAA,CAAI,SAAA,CAAU,gCAAgC,GAAG,CAAA;AACjD,QAAA,GAAA,CAAI,SAAA,CAAU,gCAAgC,GAAG,CAAA;AACjD,QAAA,IAAA,EAAK;AAAA,MACP,CAAC,CAAA;AAAA,IACH,CAAA;AAAA,IAEA,mBAAmB,IAAA,EAAc;AAC/B,MAAA,IAAI,CAAC,cAAc,OAAO,IAAA;AAE1B,MAAA,MAAM,YAAA,GAAe;AAAA;AAAA;AAAA;AAAA,UAAA,EAIf,IAAA,CAAK,SAAA,CAAU,OAAO,CAAC,CAAA;AAAA;AAAA;AAAA,SAAA,CAAA;AAM7B,MAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,SAAA,EAAW,CAAA,EAAG,YAAY;AAAA,OAAA,CAAW,CAAA;AAAA,IAC3D;AAAA,GACF;AACF","file":"index.js","sourcesContent":["import type { Plugin, ViteDevServer } from \"vite\";\n\nexport interface SynapseVitePluginOptions {\n  /** App name (must match manifest) */\n  appName: string;\n  /** Platform API URL (default: http://localhost:4321) */\n  platformUrl?: string;\n  /** Auto-inject bridge runtime into HTML entry (default: true) */\n  injectBridge?: boolean;\n}\n\n/**\n * Vite plugin for Synapse app development.\n *\n * - Configures CORS for cross-origin iframe communication\n * - Injects ext-apps bridge runtime if `injectBridge` is true\n * - Sets up HMR WebSocket to work inside iframe sandbox\n * - Exposes platform URL as `import.meta.env.SYNAPSE_PLATFORM_URL`\n */\nexport function synapseVite(options: SynapseVitePluginOptions): Plugin {\n  const { appName, platformUrl = \"http://localhost:4321\", injectBridge = true } = options;\n\n  return {\n    name: \"synapse\",\n\n    config() {\n      return {\n        define: {\n          \"import.meta.env.SYNAPSE_PLATFORM_URL\": JSON.stringify(platformUrl),\n          \"import.meta.env.SYNAPSE_APP_NAME\": JSON.stringify(appName),\n        },\n        server: {\n          hmr: {\n            // Required for HMR inside sandboxed iframe\n            protocol: \"ws\",\n            host: \"localhost\",\n          },\n        },\n      };\n    },\n\n    configureServer(server: ViteDevServer) {\n      // Add CORS headers for cross-origin iframe communication\n      server.middlewares.use((_req, res, next) => {\n        res.setHeader(\"Access-Control-Allow-Origin\", \"*\");\n        res.setHeader(\"Access-Control-Allow-Methods\", \"*\");\n        res.setHeader(\"Access-Control-Allow-Headers\", \"*\");\n        next();\n      });\n    },\n\n    transformIndexHtml(html: string) {\n      if (!injectBridge) return html;\n\n      const bridgeScript = `\n<script type=\"module\">\n  import { createSynapse } from \"@nimblebrain/synapse\";\n  window.__synapse = createSynapse({\n    name: ${JSON.stringify(appName)},\n    version: \"0.0.0-dev\",\n  });\n</script>`;\n\n      // Inject before closing </head> tag\n      return html.replace(\"</head>\", `${bridgeScript}\\n</head>`);\n    },\n  };\n}\n"]}

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "@nimblebrain/synapse",
+  "version": "0.1.0",
+  "description": "Agent-aware app SDK for the NimbleBrain platform",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js",
+      "require": "./dist/react/index.cjs"
+    },
+    "./vite": {
+      "types": "./dist/vite/index.d.ts",
+      "import": "./dist/vite/index.js",
+      "require": "./dist/vite/index.cjs"
+    },
+    "./codegen": {
+      "types": "./dist/codegen/index.d.ts",
+      "import": "./dist/codegen/index.js",
+      "require": "./dist/codegen/index.cjs"
+    }
+  },
+  "bin": {
+    "synapse": "./dist/codegen/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "format": "biome format --write .",
+    "ci": "npm run lint && npm run typecheck && npm run build && npm run test",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NimbleBrainInc/synapse.git"
+  },
+  "homepage": "https://github.com/NimbleBrainInc/synapse#readme",
+  "bugs": {
+    "url": "https://github.com/NimbleBrainInc/synapse/issues"
+  },
+  "author": "NimbleBrain Inc.",
+  "peerDependencies": {
+    "@modelcontextprotocol/ext-apps": "^1.3.1",
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.9",
+    "@modelcontextprotocol/ext-apps": "^1.3.1",
+    "@testing-library/react": "^16.0.0",
+    "@types/node": "^22.19.15",
+    "@types/react": "^19.0.0",
+    "happy-dom": "^15.0.0",
+    "react": "^19.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "vite": "^6.0.0",
+    "vitest": "^3.0.0"
+  },
+  "license": "MIT",
+  "keywords": [
+    "nimblebrain",
+    "synapse",
+    "mcp",
+    "ext-apps",
+    "agent",
+    "sdk",
+    "model-context-protocol",
+    "ai",
+    "react",
+    "vite"
+  ]
+}