@nimblebrain/synapse 0.16.0 → 0.17.1

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

@@ -1,6 +1,6 @@
-(function(){'use strict';var be=new Set(["auto","block","swap","fallback","optional"]),ke={"--color-background-primary":"#ffffff","--color-background-secondary":"#fafafa","--color-background-tertiary":"#f3f4f6","--color-text-primary":"#111827","--color-text-secondary":"#6b7280","--color-text-tertiary":"#9ca3af","--color-text-accent":"#2563eb","--nb-color-accent-foreground":"#ffffff","--color-border-primary":"#e5e7eb","--color-border-secondary":"#d1d5db","--color-ring-primary":"#2563eb","--nb-color-danger":"#dc2626","--nb-color-success":"#059669","--nb-color-warning":"#f59e0b","--nb-color-processing":"#7c3aed","--nb-color-processing-light":"#f3eeff","--nb-color-info-light":"#eef4ff"},Pe={"--color-background-primary":"#18181b","--color-background-secondary":"#27272a","--color-background-tertiary":"#2f2f34","--color-text-primary":"#fafafa","--color-text-secondary":"#a1a1aa","--color-text-tertiary":"#71717a","--color-text-accent":"#818cf8","--nb-color-accent-foreground":"#ffffff","--color-border-primary":"#3f3f46","--color-border-secondary":"#52525b","--color-ring-primary":"#818cf8","--nb-color-danger":"#f87171","--nb-color-success":"#34d399","--nb-color-warning":"#fbbf24","--nb-color-processing":"#a78bfa","--nb-color-processing-light":"#2a2440","--nb-color-info-light":"#1e2a44"},Ee={light:ke,dark:Pe},Ie="synapse-defaults",G="synapse-theme-defaults",W=new Set;function ve(){return typeof document<"u"&&typeof document.getElementById=="function"&&typeof document.createElement=="function"&&typeof document.head?.prepend=="function"}function Ce(e){if(!ve())return;let o=Object.entries(Ee[e]).map(([a,p])=>`    ${a}: ${p};`).join(`
+(function(){'use strict';var be=new Set(["auto","block","swap","fallback","optional"]),ke={"--color-background-primary":"#ffffff","--color-background-secondary":"#fafafa","--color-background-tertiary":"#f3f4f6","--color-text-primary":"#111827","--color-text-secondary":"#6b7280","--color-text-tertiary":"#9ca3af","--color-text-accent":"#2563eb","--nb-color-accent-foreground":"#ffffff","--color-border-primary":"#e5e7eb","--color-border-secondary":"#d1d5db","--color-ring-primary":"#2563eb","--nb-color-danger":"#dc2626","--nb-color-success":"#059669","--nb-color-warning":"#f59e0b","--nb-color-processing":"#7c3aed","--nb-color-processing-light":"#f3eeff","--nb-color-info-light":"#eef4ff"},Pe={"--color-background-primary":"#18181b","--color-background-secondary":"#27272a","--color-background-tertiary":"#2f2f34","--color-text-primary":"#fafafa","--color-text-secondary":"#a1a1aa","--color-text-tertiary":"#71717a","--color-text-accent":"#818cf8","--nb-color-accent-foreground":"#ffffff","--color-border-primary":"#3f3f46","--color-border-secondary":"#52525b","--color-ring-primary":"#818cf8","--nb-color-danger":"#f87171","--nb-color-success":"#34d399","--nb-color-warning":"#fbbf24","--nb-color-processing":"#a78bfa","--nb-color-processing-light":"#2a2440","--nb-color-info-light":"#1e2a44"},Ee={light:ke,dark:Pe},Ie="synapse-defaults",G="synapse-theme-defaults",W=new Set;function ve(){return typeof document<"u"&&typeof document.getElementById=="function"&&typeof document.createElement=="function"&&typeof document.head?.prepend=="function"}function we(e){if(!ve())return;let o=Object.entries(Ee[e]).map(([a,p])=>`    ${a}: ${p};`).join(`
 `),n=`@layer ${Ie} {
   :root {
 ${o}
   }
-}`,s=document.getElementById(G);if(s){s.textContent!==n&&(s.textContent=n);return}let i=document.createElement("style");i.id=G,i.textContent=n,document.head.prepend(i);}function we(e,o){if(typeof document>"u")return;Ce(e);let n={};if(o&&typeof o=="object")for(let[i,a]of Object.entries(o))typeof i=="string"&&typeof a=="string"&&(n[i]=a);let s=document.documentElement.style;if(typeof s.removeProperty=="function")for(let i of W)i in n||s.removeProperty(i);for(let[i,a]of Object.entries(n))s.setProperty(i,a);W=new Set(Object.keys(n));}var F=new Set,Y="";function A(e){return Array.isArray(e)?JSON.stringify(e.map(o=>[o.family,o.src,o.weight,o.style,o.display])):""}function M(e){if(!Array.isArray(e))return;let o=e.filter(Oe);if(!(e.length>0&&o.length===0))return o}function Ae(e){let o=M(e);if(o===void 0||typeof document>"u"||!document.fonts||typeof FontFace>"u")return;let n=A(o);if(n!==Y){Y=n;for(let s of F)try{document.fonts.delete(s);}catch{}F.clear();for(let s of o)try{let i=new FontFace(s.family,s.src,{weight:s.weight,style:s.style,display:s.display&&be.has(s.display)?s.display:"swap"});document.fonts.add(i),F.add(i);}catch{}}}function Oe(e){if(!e||typeof e!="object")return  false;let o=e;return typeof o.family=="string"&&typeof o.src=="string"}function V(e,o,n){we(e,o),Ae(n);}function R(e){typeof document<"u"&&document.documentElement.setAttribute("data-theme",e.mode),V(e.mode,e.tokens,e.fontFaces);}function O(e){try{if(e?.matchMedia?.("(prefers-color-scheme: dark)").matches)return "dark"}catch{}return "light"}function h(e,o){return e==="light"||e==="dark"?e:o}var T=class extends Error{constructor(o,n){super(`"${o}" is not supported by the "${n}" host`),this.name="HostUnsupportedError";}},_="synapse-ui-data",Z="ui-lifecycle-iframe-ready",$="ui-lifecycle-iframe-render-data",B="ui-size-change",q="link",Q="prompt",U="openai:set_globals",X="2026-01-26",J="ui/initialize",ee="ui/notifications/initialized",te="ui/notifications/tool-result",ne="ui/notifications/host-context-changed",oe="ui/notifications/size-changed",re="ui/open-link",se="ui/message",ie="ui/resource-teardown",ae="tools/call";function ce(e,o){let n=()=>e.openai,s=n()?.toolOutput??null,i={mode:h(n()?.theme,"light"),tokens:{}},a=new Set,p=new Set,f=false,m=c=>{if(f)return;let l=c.detail?.globals;if(l){if("toolOutput"in l&&l.toolOutput!=null){s=l.toolOutput;for(let u of a)u(s);}if("theme"in l&&l.theme!=null){let u=h(l.theme,i.mode);if(u!==i.mode){i={mode:u,tokens:{}};for(let b of p)b(i);}}}};return {host:"chatgpt",getData:()=>s,onData(c){return a.add(c),()=>a.delete(c)},getTheme:()=>i,onTheme(c){return p.add(c),()=>p.delete(c)},async callTool(c,l){let u=n()?.callTool;if(!u)throw new T("callTool","chatgpt");return await u(c,l??{})},sendPrompt(c){let l=n();(l?.sendFollowUpMessage??l?.sendFollowupMessage)?.({prompt:c});},openLink(c){let l=n()?.openExternal;l?l({href:c}):e.open(c,"_blank","noopener,noreferrer");},resize(){},capabilities(){let c=n();return {pull:typeof c?.callTool=="function",sendPrompt:typeof c?.sendFollowUpMessage=="function"||typeof c?.sendFollowupMessage=="function",openLink:true}},start(){e.addEventListener(U,m,{passive:true}),s=n()?.toolOutput??s;},destroy(){f||(f=true,e.removeEventListener(U,m),a.clear(),p.clear());}}}function S(e,o){if(!e)return null;let s=e.getElementById(o)?.textContent;if(!s)return null;try{return JSON.parse(s)??null}catch{return null}}function L(e){if(e==null||typeof e!="object")return null;let o=e,n=o.renderData,s=n!=null&&typeof n=="object"?n:o;return s.toolOutput!=null?s.toolOutput:s.structuredContent!=null?s.structuredContent:s}function le(e,o){let n=o.dataElementId??_,s=null,i={mode:O(e),tokens:{}},a=new Set,p=false,f=null,m=c=>{if(p)return;let l=h(c.matches?"dark":"light",i.mode);if(l!==i.mode){i={mode:l,tokens:{}};for(let u of a)u(i);}};return {host:"generic",getData:()=>s,onData(){return ()=>{}},getTheme:()=>i,onTheme(c){return a.add(c),()=>a.delete(c)},async callTool(c){throw new T("callTool","generic")},sendPrompt(){},openLink(c){e.open(c,"_blank","noopener,noreferrer");},resize(){},capabilities(){return {pull:false,sendPrompt:false,openLink:true}},start(){s=S(e.document,n);try{f=e.matchMedia?.("(prefers-color-scheme: dark)")??null,f?.addEventListener?.("change",m);}catch{f=null;}},destroy(){p||(p=true,f?.removeEventListener?.("change",m),f=null,a.clear());}}}var _e="synapse/fontFaces";function Se(e){return M(e?.[_e])}function de(e,o){return Se(o)??e}var xe=3e4;function pe(e,o){let n=o.dataElementId??_,s=o.autoResize!==false,i=null,a={mode:O(e),tokens:{}},p=new Set,f=new Set,m=false,c=false,l=1,u=new Map,b=-1,v=null,k=null,H=()=>e.parent??e;function P(t){H().postMessage(t,"*");}function x(t){c||P(t);}function N(t,r){P({jsonrpc:"2.0",method:t,params:r??{}});}function C(t,r){let d=l++;return new Promise((y,g)=>{let I=setTimeout(()=>{u.delete(d),g(new Error(`"${t}" timed out`));},xe);u.set(d,{resolve:y,reject:g,timer:I}),P({jsonrpc:"2.0",id:d,method:t,params:r??{}});})}function z(t){if(t!=null){i=t;for(let r of p)r(t);}}function D(t){if(!t||typeof t!="object")return;let{mode:r,tokens:d,fontFaces:y}=a,g=false;if(t.theme!=null){let w=h(t.theme,r);w!==r&&(r=w,g=true);}let I=t.styles;I?.variables&&typeof I.variables=="object"&&(d={...d,...I.variables},g=true);let K=de(y,t);if(A(K)!==A(y)&&(y=K,g=true),g){a={mode:r,tokens:d,...y?{fontFaces:y}:{}};for(let w of f)w(a);}}function E(t){if(m)return;let r=typeof t=="number"?t:Math.ceil(e.document.body.scrollHeight);r!==b&&(b=r,N(oe,{height:r}),x({type:B,payload:{height:r}}));}function me(t){let r=Number(t.id),d=u.get(r);if(d)if(u.delete(r),clearTimeout(d.timer),t.error!=null){let y=t.error;d.reject(new Error(y.message??"request failed"));}else d.resolve(t.result);}function ye(t,r){if(t===te){let d=r.structuredContent;z(d??L(r));}else t===ne&&D(r);}function ge(t){t.method===ie&&P({jsonrpc:"2.0",id:t.id,result:{}});}function he(t){if(t.type===$||t.type==="renderData"){let{theme:r,...d}=t.payload??{};r!=null&&D({theme:r}),Object.keys(d).length>0&&z(L(d));}}let j=t=>{if(m||t.source&&t.source!==H())return;let r=t.data;if(!(!r||typeof r!="object")){if(r.jsonrpc!=="2.0"){he(r);return}r.id!=null&&("result"in r||"error"in r)?me(r):typeof r.method=="string"&&(r.id!=null?ge(r):ye(r.method,r.params??{}));}};function Te(){k=()=>E(),e.addEventListener("resize",k),typeof e.ResizeObserver<"u"&&(v=new e.ResizeObserver(()=>E()),v.observe(e.document.body));}return {host:"claude",getData:()=>i,onData(t){return p.add(t),()=>p.delete(t)},getTheme:()=>a,onTheme(t){return f.add(t),()=>f.delete(t)},async callTool(t,r){return await C(ae,{name:t,arguments:r??{}})},sendPrompt(t){C(se,{role:"user",content:[{type:"text",text:t}]}).catch(()=>{}),x({type:Q,payload:{prompt:t}});},openLink(t){C(re,{url:t}).catch(()=>{}),x({type:q,payload:{url:t}});},resize(t){E(t);},capabilities(){return {pull:true,sendPrompt:true,openLink:true}},start(){e.addEventListener("message",j),i=S(e.document,n),s&&Te(),P({type:Z}),C(J,{appInfo:{name:o.name??"synapse-ui",version:o.version??"0.0.0"},appCapabilities:{availableDisplayModes:["inline"]},protocolVersion:X}).then(t=>{m||(c=true,D(t?.hostContext),N(ee,{}),b=-1,E());}).catch(()=>{}),E();},destroy(){if(!m){m=true,e.removeEventListener("message",j),k&&e.removeEventListener("resize",k),k=null,v?.disconnect(),v=null;for(let t of u.values())clearTimeout(t.timer),t.reject(new Error("adapter destroyed"));u.clear(),p.clear(),f.clear();}}}}function De(e){if(e.openai!=null)return "chatgpt";try{if(e.parent!=null&&e.parent!==e)return "claude"}catch{return "claude"}return "generic"}function Fe(e,o,n){switch(e){case "chatgpt":return ce(o);case "claude":case "nimblebrain":return pe(o,n);default:return le(o,n)}}function ue(e,o){let n=o.host??De(e);return Fe(n,e,o)}function fe(e={}){let o=e.window??globalThis,n=ue(o,e);R(n.getTheme());let s=n.onTheme(R);n.start();let i=false;return {data:()=>n.getData(),onData:a=>n.onData(a),theme:()=>n.getTheme(),onTheme:a=>n.onTheme(a),callTool:(a,p)=>n.callTool(a,p),sendPrompt:a=>n.sendPrompt(a),openLink:a=>n.openLink(a),resize:a=>n.resize(a),capabilities:()=>n.capabilities(),host:()=>n.host,destroy(){i||(i=true,s(),n.destroy());}}}globalThis.SynapseUI={connect:fe};})();
+}`,s=document.getElementById(G);if(s){s.textContent!==n&&(s.textContent=n);return}let i=document.createElement("style");i.id=G,i.textContent=n,document.head.prepend(i);}function Ae(e,o){if(typeof document>"u")return;we(e);let n={};if(o&&typeof o=="object")for(let[i,a]of Object.entries(o))typeof i=="string"&&typeof a=="string"&&(n[i]=a);let s=document.documentElement.style;if(typeof s.removeProperty=="function")for(let i of W)i in n||s.removeProperty(i);for(let[i,a]of Object.entries(n))s.setProperty(i,a);W=new Set(Object.keys(n));}var F=new Set,Y="";function C(e){return Array.isArray(e)?JSON.stringify(e.map(o=>[o.family,o.src,o.weight,o.style,o.display])):""}function M(e){if(!Array.isArray(e))return;let o=e.filter(Oe);if(!(e.length>0&&o.length===0))return o}function Ce(e){let o=M(e);if(o===void 0||typeof document>"u"||!document.fonts||typeof FontFace>"u")return;let n=C(o);if(n!==Y){Y=n;for(let s of F)try{document.fonts.delete(s);}catch{}F.clear();for(let s of o)try{let i=new FontFace(s.family,s.src,{weight:s.weight,style:s.style,display:s.display&&be.has(s.display)?s.display:"swap"});document.fonts.add(i),F.add(i);}catch{}}}function Oe(e){if(!e||typeof e!="object")return  false;let o=e;return typeof o.family=="string"&&typeof o.src=="string"}function V(e,o,n){Ae(e,o),Ce(n);}function R(e){typeof document<"u"&&document.documentElement.setAttribute("data-theme",e.mode),V(e.mode,e.tokens,e.fontFaces);}function O(e){try{if(e?.matchMedia?.("(prefers-color-scheme: dark)").matches)return "dark"}catch{}return "light"}function h(e,o){return e==="light"||e==="dark"?e:o}var T=class extends Error{constructor(o,n){super(`"${o}" is not supported by the "${n}" host`),this.name="HostUnsupportedError";}},_="synapse-ui-data",Z="ui-lifecycle-iframe-ready",$="ui-lifecycle-iframe-render-data",B="ui-size-change",q="link",Q="prompt",U="openai:set_globals",X="2026-01-26",J="ui/initialize",ee="ui/notifications/initialized",te="ui/notifications/tool-result",ne="ui/notifications/host-context-changed",oe="ui/notifications/size-changed",re="ui/open-link",se="ui/message",ie="ui/resource-teardown",ae="tools/call";function ce(e,o){let n=()=>e.openai,s=n()?.toolOutput??null,i={mode:h(n()?.theme,"light"),tokens:{}},a=new Set,p=new Set,f=false,m=c=>{if(f)return;let l=c.detail?.globals;if(l){if("toolOutput"in l&&l.toolOutput!=null){s=l.toolOutput;for(let u of a)u(s);}if("theme"in l&&l.theme!=null){let u=h(l.theme,i.mode);if(u!==i.mode){i={mode:u,tokens:{}};for(let b of p)b(i);}}}};return {host:"chatgpt",getData:()=>s,onData(c){return a.add(c),()=>a.delete(c)},getTheme:()=>i,onTheme(c){return p.add(c),()=>p.delete(c)},async callTool(c,l){let u=n()?.callTool;if(!u)throw new T("callTool","chatgpt");return await u(c,l??{})},sendPrompt(c){let l=n();(l?.sendFollowUpMessage??l?.sendFollowupMessage)?.({prompt:c});},openLink(c){let l=n()?.openExternal;l?l({href:c}):e.open(c,"_blank","noopener,noreferrer");},resize(){},capabilities(){let c=n();return {pull:typeof c?.callTool=="function",sendPrompt:typeof c?.sendFollowUpMessage=="function"||typeof c?.sendFollowupMessage=="function",openLink:true}},start(){e.addEventListener(U,m,{passive:true}),s=n()?.toolOutput??s;},destroy(){f||(f=true,e.removeEventListener(U,m),a.clear(),p.clear());}}}function x(e,o){if(!e)return null;let s=e.getElementById(o)?.textContent;if(!s)return null;try{return JSON.parse(s)??null}catch{return null}}function L(e){if(e==null||typeof e!="object")return null;let o=e,n=o.renderData,s=n!=null&&typeof n=="object"?n:o;return s.toolOutput!=null?s.toolOutput:s.structuredContent!=null?s.structuredContent:s}function le(e,o){let n=o.dataElementId??_,s=null,i={mode:O(e),tokens:{}},a=new Set,p=false,f=null,m=c=>{if(p)return;let l=h(c.matches?"dark":"light",i.mode);if(l!==i.mode){i={mode:l,tokens:{}};for(let u of a)u(i);}};return {host:"generic",getData:()=>s,onData(){return ()=>{}},getTheme:()=>i,onTheme(c){return a.add(c),()=>a.delete(c)},async callTool(c){throw new T("callTool","generic")},sendPrompt(){},openLink(c){e.open(c,"_blank","noopener,noreferrer");},resize(){},capabilities(){return {pull:false,sendPrompt:false,openLink:true}},start(){s=x(e.document,n);try{f=e.matchMedia?.("(prefers-color-scheme: dark)")??null,f?.addEventListener?.("change",m);}catch{f=null;}},destroy(){p||(p=true,f?.removeEventListener?.("change",m),f=null,a.clear());}}}var _e="synapse/fontFaces";function xe(e){return M(e?.[_e])}function de(e,o){return xe(o)??e}var De=3e4;function pe(e,o){let n=o.dataElementId??_,s=o.autoResize!==false,i=null,a={mode:O(e),tokens:{}},p=new Set,f=new Set,m=false,c=false,l=1,u=new Map,b=-1,v=null,k=null,H=()=>e.parent??e;function P(t){H().postMessage(t,"*");}function D(t){c||P(t);}function N(t,r){P({jsonrpc:"2.0",method:t,params:r??{}});}function w(t,r){let d=l++;return new Promise((y,g)=>{let I=setTimeout(()=>{u.delete(d),g(new Error(`"${t}" timed out`));},De);u.set(d,{resolve:y,reject:g,timer:I}),P({jsonrpc:"2.0",id:d,method:t,params:r??{}});})}function z(t){if(t!=null){i=t;for(let r of p)r(t);}}function S(t){if(!t||typeof t!="object")return;let{mode:r,tokens:d,fontFaces:y}=a,g=false;if(t.theme!=null){let A=h(t.theme,r);A!==r&&(r=A,g=true);}let I=t.styles;I?.variables&&typeof I.variables=="object"&&(d={...d,...I.variables},g=true);let K=de(y,t);if(C(K)!==C(y)&&(y=K,g=true),g){a={mode:r,tokens:d,...y?{fontFaces:y}:{}};for(let A of f)A(a);}}function E(t){if(m)return;let r=typeof t=="number"?t:Math.ceil(e.document.body.scrollHeight);r!==b&&(b=r,N(oe,{height:r}),D({type:B,payload:{height:r}}));}function me(t){let r=Number(t.id),d=u.get(r);if(d)if(u.delete(r),clearTimeout(d.timer),t.error!=null){let y=t.error;d.reject(new Error(y.message??"request failed"));}else d.resolve(t.result);}function ye(t,r){if(t===te){let d=r.structuredContent;z(d??L(r));}else t===ne&&S(r);}function ge(t){t.method===ie&&P({jsonrpc:"2.0",id:t.id,result:{}});}function he(t){if(t.type===$||t.type==="renderData"){let{theme:r,...d}=t.payload??{};r!=null&&S({theme:r}),Object.keys(d).length>0&&z(L(d));}}let j=t=>{if(m||t.source&&t.source!==H())return;let r=t.data;if(!(!r||typeof r!="object")){if(r.jsonrpc!=="2.0"){he(r);return}r.id!=null&&("result"in r||"error"in r)?me(r):typeof r.method=="string"&&(r.id!=null?ge(r):ye(r.method,r.params??{}));}};function Te(){k=()=>E(),e.addEventListener("resize",k),typeof e.ResizeObserver<"u"&&(v=new e.ResizeObserver(()=>E()),v.observe(e.document.body));}return {host:"claude",getData:()=>i,onData(t){return p.add(t),()=>p.delete(t)},getTheme:()=>a,onTheme(t){return f.add(t),()=>f.delete(t)},async callTool(t,r){return await w(ae,{name:t,arguments:r??{}})},sendPrompt(t){w(se,{role:"user",content:[{type:"text",text:t}]}).catch(()=>{}),D({type:Q,payload:{prompt:t}});},openLink(t){w(re,{url:t}).catch(()=>{}),D({type:q,payload:{url:t}});},resize(t){E(t);},capabilities(){return {pull:true,sendPrompt:true,openLink:true}},start(){e.addEventListener("message",j),i=x(e.document,n),s&&Te(),P({type:Z}),w(J,{appInfo:{name:o.name??"synapse-ui",version:o.version??"0.0.0"},appCapabilities:{availableDisplayModes:["inline"]},protocolVersion:X}).then(t=>{m||(c=true,S(t?.hostContext),N(ee,{}),b=-1,E());}).catch(()=>{}),E();},destroy(){if(!m){m=true,e.removeEventListener("message",j),k&&e.removeEventListener("resize",k),k=null,v?.disconnect(),v=null;for(let t of u.values())clearTimeout(t.timer),t.reject(new Error("adapter destroyed"));u.clear(),p.clear(),f.clear();}}}}function Se(e){if(e.openai!=null)return "chatgpt";try{if(e.parent!=null&&e.parent!==e)return "claude"}catch{return "claude"}return "generic"}function Fe(e,o,n){switch(e){case "chatgpt":return ce(o);case "claude":case "nimblebrain":return pe(o,n);default:return le(o,n)}}function ue(e,o){let n=o.host??Se(e);return Fe(n,e,o)}function fe(e={}){let o=e.window??globalThis,n=ue(o,e);R(n.getTheme());let s=n.onTheme(R);n.start();let i=false;return {data:()=>n.getData(),onData:a=>n.onData(a),theme:()=>n.getTheme(),onTheme:a=>n.onTheme(a),callTool:(a,p)=>n.callTool(a,p),sendPrompt:a=>n.sendPrompt(a),openLink:a=>n.openLink(a),resize:a=>n.resize(a),capabilities:()=>n.capabilities(),host:()=>n.host,destroy(){i||(i=true,s(),n.destroy());}}}globalThis.SynapseUI={connect:fe};})();

package/dist/{types-BSZasM8q.d.cts → types-uEO4VFJ2.d.cts}

@@ -100,19 +100,6 @@ interface TaskHandle<TOutput = unknown> {
     onStatus(cb: (task: Task) => void): () => void;
 }
 
-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[];
-}
 /**
  * One `@font-face` a host asks the app to load.
  *
@@ -143,9 +130,8 @@ interface FontFaceDescriptor {
 }
 /** The CSS `font-display` values. Closed set — anything else is ignored. */
 type FontDisplayValue = "auto" | "block" | "swap" | "fallback" | "optional";
-interface SynapseTheme {
+interface Theme {
     mode: "light" | "dark";
-    primaryColor: string;
     tokens: Record<string, string>;
     /**
      * Font faces the host wants loaded into the app document. Optional — a host
@@ -248,149 +234,13 @@ interface RequestFileOptions {
     /** Allow multiple file selection. Default: false */
     multiple?: boolean;
 }
-interface Synapse {
-    readonly ready: Promise<void>;
-    readonly isNimbleBrainHost: boolean;
-    callTool<TInput = Record<string, unknown>, TOutput = unknown>(name: string, args?: TInput): Promise<ToolCallResult<TOutput>>;
-    /**
-     * Task-augmented variant of `callTool` per MCP 2025-11-25. Sends
-     * `tools/call` with a `task` param; the receiver returns a
-     * `CreateTaskResult` promptly and the actual `CallToolResult` lands
-     * via `tasks/result`. Returns a `TaskHandle` that exposes
-     * `result()`/`refresh()`/`cancel()`/`onStatus()`.
-     *
-     * Throws if the host did not advertise `tasks.requests.tools.call` in
-     * its init-response capabilities — requestors MUST NOT task-augment
-     * without matching receiver capability.
-     */
-    callToolAsTask<TInput = Record<string, unknown>, TOutput = unknown>(name: string, args?: TInput, options?: CallToolAsTaskOptions): Promise<TaskHandle<TOutput>>;
-    /**
-     * Read an MCP resource from the originating server via the host bridge
-     * (ext-apps `resources/read`).
-     *
-     * Use this to resolve `resource_link` content blocks returned by tools, or
-     * to fetch any known resource URI exposed by the MCP server. The host
-     * proxies the request to the server and forwards the result unchanged.
-     *
-     * @param uri The resource URI (e.g. `"videos://bunny-1mb"`).
-     * @returns The server's `ReadResourceResult` — `contents` is an array of
-     *   blocks, each with a `uri`, optional `mimeType`, and either `text` or
-     *   `blob` (base64).
-     */
-    readResource(uri: string): Promise<ReadResourceResult>;
-    onDataChanged(callback: (event: DataChangedEvent) => void): () => void;
-    /**
-     * Subscribe to agent actions — typed, declarative commands from the server.
-     *
-     * Actions are deterministic side effects of tool execution. The server/tool
-     * decides what action to emit; the UI decides how to handle it.
-     *
-     * The callback receives an AgentAction with a `type` discriminator and typed
-     * `payload`. Apps should handle known types and ignore unknown ones.
-     */
-    onAction(callback: (action: AgentAction) => void): () => void;
-    /**
-     * Read the current ext-apps host context as last received from the host.
-     *
-     * Spec-standardized fields (`theme`, `styles`, `displayMode`, `toolInfo`)
-     * are typed; the open `[key: string]: unknown` allows hosts to publish
-     * extensions (e.g. NimbleBrain populates `workspace`). Apps reading
-     * host-specific fields should treat them as optional and tolerate
-     * missing values when running on other hosts.
-     *
-     * Returns the empty object before the `ui/initialize` handshake completes.
-     */
-    getHostContext(): McpUiHostContext;
-    /**
-     * Subscribe to host-context updates. Fires once per
-     * `ui/notifications/host-context-changed` notification (which carries a
-     * full snapshot, not a delta) and once on handshake completion.
-     *
-     * `getTheme`/`onThemeChanged` are typed selectors over this same state —
-     * prefer them when only theming matters, since they filter no-op fires.
-     */
-    onHostContextChanged(callback: (ctx: McpUiHostContext) => void): () => void;
-    getTheme(): SynapseTheme;
-    onThemeChanged(callback: (theme: SynapseTheme) => void): () => void;
-    /** NimbleBrain-only: trigger a host-side action. No-op in other hosts. */
-    action(action: string, params?: Record<string, unknown>): void;
-    /**
-     * Send a user message into the agent conversation (ext-apps `ui/message`).
-     *
-     * @param context NimbleBrain-specific metadata, included as `_meta.context`
-     *   on the content block. Ignored by non-NimbleBrain hosts.
-     */
-    chat(message: string, context?: {
-        action?: string;
-        entity?: string;
-    }): void;
-    /**
-     * Push the app's current visible state to the agent (ext-apps `ui/update-model-context`).
-     *
-     * The `summary` string is what the LLM reads as a text content block.
-     * The `state` object is included as `structuredContent` for tools that need IDs/values.
-     * Debounced at 250ms. Each call overwrites the previous context.
-     */
-    setVisibleState(state: Record<string, unknown>, summary?: string): void;
-    downloadFile(filename: string, content: string | Blob, mimeType?: string): void;
-    openLink(url: string): void;
-    /**
-     * Request a file from the user via the host's native file picker.
-     * NimbleBrain-only: throws in non-NimbleBrain hosts.
-     * Returns null if the user cancels.
-     */
-    pickFile(options?: RequestFileOptions): Promise<FileResult | null>;
-    /**
-     * Pick multiple files from the user.
-     * NimbleBrain-only: throws in non-NimbleBrain hosts.
-     * Returns empty array if the user cancels.
-     */
-    pickFiles(options?: RequestFileOptions): Promise<FileResult[]>;
-    /** @internal — used by createStore for synapse/state-loaded */
-    _onMessage(method: string, callback: (params: Record<string, unknown> | undefined) => void): () => void;
-    /** @internal — used by createStore for synapse/persist-state */
-    _request(method: string, params?: Record<string, unknown>): Promise<unknown>;
-    /**
-     * @internal — host's declared `tasks` capability from the `ui/initialize`
-     * response, or `undefined` if absent. Read by the task-augmented tool call
-     * path (future `callToolAsTask`) to decide whether task augmentation is
-     * negotiated. `null` before the handshake completes.
-     *
-     * Requestors MUST NOT task-augment a tool call unless this is defined and
-     * carries `requests.tools.call` per MCP 2025-11-25.
-     */
-    readonly _hostTasksCapability: TasksCapability | undefined | null;
-    /** True after destroy() has been called. */
-    readonly destroyed: boolean;
-    destroy(): void;
-}
-interface VisibleState {
+/** What `useModelContext`'s declarative factory returns. */
+interface ModelContext {
+    /** Structured state the agent's tools can read ids and values out of. */
     state: Record<string, unknown>;
+    /** The one line the model actually reads. */
     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;
@@ -410,19 +260,35 @@ interface HostInfo {
     protocolVersion: string;
 }
 interface ConnectOptions {
+    /** App name — must match the bundle name registered with the host. */
     name: string;
+    /** Semver version string. */
     version: string;
+    /** Track the document height and re-send `size-changed` as it moves. */
     autoResize?: boolean;
+    /**
+     * Mark as an internal NimbleBrain app. Enables cross-server tool calls:
+     * `callTool` carries a `server` param so the host can route the call to a
+     * sibling server. External apps MUST NOT set this.
+     */
+    internal?: boolean;
+    /**
+     * Forward keyboard shortcuts from this iframe up to the host, so the host's
+     * own shortcuts still fire while focus is inside the app.
+     *
+     * `true` forwards the default set (Escape plus every Ctrl/Cmd combo except
+     * the clipboard keys the browser must handle itself); an array forwards
+     * exactly the listed combos. Absent means no forwarding.
+     *
+     * Only a NimbleBrain host consumes `synapse/keydown`, so forwarding stays
+     * off everywhere else — a `preventDefault` on a host that does nothing with
+     * the key would swallow it for no one's benefit.
+     */
+    forwardKeys?: boolean | KeyForwardConfig[];
     /** Pre-register event handlers before the handshake completes.
      *  These are wired before `initialized` is sent, so no messages are lost. */
     on?: Record<string, (data: any) => void>;
 }
-interface Theme {
-    mode: "light" | "dark";
-    tokens: Record<string, string>;
-    /** Font faces the host wants loaded. See {@link FontFaceDescriptor}. */
-    fontFaces?: FontFaceDescriptor[];
-}
 interface Dimensions {
     width?: number;
     height?: number;
@@ -434,8 +300,27 @@ interface ToolResultData {
     structuredContent: unknown;
     raw: Record<string, unknown>;
 }
-/** Known short event names for App.on() */
-type AppEventName = "tool-result" | "tool-input" | "tool-input-partial" | "tool-cancelled" | "theme-changed" | "teardown";
+/** Per-call overrides for {@link App.callTool}. */
+interface CallToolOptions {
+    /**
+     * Route the call to a sibling MCP server rather than the app's own.
+     * Internal apps only — the host rejects it otherwise. Defaults to this
+     * app's name when `connect({ internal: true })` was used, which is what
+     * makes a plain `callTool` work for an internal app.
+     */
+    server?: string;
+}
+/** Known short event names for {@link App.on}. */
+type AppEventName = "tool-result" | "tool-input" | "tool-input-partial" | "tool-cancelled" | "theme-changed" | "host-context-changed" | "data-changed" | "action" | "teardown";
+/**
+ * A connected app — what `connect()` resolves to, and the only runtime object
+ * this SDK hands out.
+ *
+ * Deliberately small: it carries the ext-apps spec surface plus the state the
+ * handshake established. NimbleBrain's own extensions (the file picker,
+ * `action`, `downloadFile`) and the MCP tasks utility are composable functions
+ * over this object rather than more methods on it.
+ */
 interface App {
     readonly theme: Theme;
     readonly hostInfo: {
@@ -446,21 +331,57 @@ interface App {
         tool: Record<string, unknown>;
     } | null;
     readonly containerDimensions: Dimensions | null;
+    /**
+     * The current host context: the handshake's, with every
+     * `host-context-changed` delta merged into it. Spec fields (`theme`,
+     * `styles`, `displayMode`, `toolInfo`) are typed; the open index signature
+     * carries host extensions — NimbleBrain publishes `workspace` here. Read
+     * host-specific fields as optional; another host will not send them.
+     */
+    readonly hostContext: McpUiHostContext;
+    /** True when the host identified itself as NimbleBrain in the handshake. */
+    readonly isNimbleBrainHost: boolean;
+    /** True after `destroy()` has been called. */
+    readonly destroyed: boolean;
+    /**
+     * Whether the host negotiated the MCP tasks utility for `tools/call`.
+     *
+     * `callToolAsTask` throws when this is false — per MCP 2025-11-25 a
+     * requestor MUST NOT task-augment a call the receiver did not advertise. Read
+     * it to decide whether to offer a long-running action at all, rather than to
+     * discover the answer from an exception.
+     */
+    readonly supportsTasks: boolean;
     on(event: "tool-input", handler: (args: Record<string, unknown>) => void): () => void;
     on(event: "tool-result", handler: (data: ToolResultData) => void): () => void;
     on(event: "theme-changed", handler: (theme: Theme) => void): () => void;
+    /** Fires with the merged snapshot — the same value as `hostContext`. For the
+     *  notification exactly as sent, subscribe to the wire method instead:
+     *  `on("ui/notifications/host-context-changed", …)`. */
+    on(event: "host-context-changed", handler: (ctx: McpUiHostContext) => void): () => void;
+    on(event: "data-changed", handler: (event: DataChangedEvent) => void): () => void;
+    on(event: "action", handler: (action: AgentAction) => void): () => void;
     on(event: "teardown", handler: () => void): () => void;
-    on(event: string, handler: (params: unknown) => void): () => void;
+    on(event: string, handler: (params: any) => void): () => void;
     resize(width?: number, height?: number): void;
     openLink(url: string): void;
+    /**
+     * Push the app's visible state to the agent (ext-apps
+     * `ui/update-model-context`). `summary` is what the model reads as text;
+     * `state` rides along as `structuredContent` for tools that need the ids.
+     *
+     * Sends immediately. Callers that push on every keystroke or selection
+     * change want `useModelContext`, which debounces.
+     */
     updateModelContext(state: Record<string, unknown>, summary?: string): void;
-    callTool(name: string, args?: Record<string, unknown>): Promise<ToolCallResult>;
+    callTool<TOutput = unknown>(name: string, args?: Record<string, unknown>, options?: CallToolOptions): Promise<ToolCallResult<TOutput>>;
     /**
      * Read an MCP resource from the originating server via the host bridge
      * (ext-apps `resources/read`). Named to mirror the ext-apps spec's
      * `App.readServerResource`.
      */
     readServerResource(params: ReadResourceRequest["params"]): Promise<ReadResourceResult>;
+    /** Send a user message into the agent conversation (ext-apps `ui/message`). */
     sendMessage(text: string, context?: {
         action?: string;
         entity?: string;
@@ -468,4 +389,4 @@ interface App {
     destroy(): void;
 }
 
-export type { App as A, BuiltinActionType as B, ConnectOptions as C, DataChangedEvent as D, FontFaceDescriptor as F, HostInfo as H, KeyForwardConfig as K, NavigatePayload as N, RequestFileOptions as R, SynapseOptions as S, ToolDefinition as T, VisibleState as V, Synapse as a, ActionReducer as b, StoreConfig as c, Store as d, AgentAction as e, AppEventName as f, CallToolAsTaskOptions as g, Dimensions as h, FileResult as i, FontDisplayValue as j, NotifyPayload as k, StateAcknowledgement as l, StoreDispatch as m, SynapseTheme as n, TaskHandle as o, TasksCapability as p, Theme as q, ToolCallResult as r, ToolResultData as s };
+export type { App as A, BuiltinActionType as B, ConnectOptions as C, DataChangedEvent as D, FileResult as F, HostInfo as H, KeyForwardConfig as K, ModelContext as M, NavigatePayload as N, RequestFileOptions as R, TaskHandle as T, CallToolAsTaskOptions as a, ToolCallResult as b, CallToolOptions as c, Theme as d, ToolResultData as e, ToolDefinition as f, FontFaceDescriptor as g, AgentAction as h, AppEventName as i, Dimensions as j, FontDisplayValue as k, NotifyPayload as l, TasksCapability as m };