@nimblebrain/synapse 0.4.4 → 0.6.0

package/dist/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk5CTTHX5Q_cjs = require('./chunk-5CTTHX5Q.cjs');
+var chunkELB55672_cjs = require('./chunk-ELB55672.cjs');
 
 // src/store.ts
 function createStore(synapse, config) {
@@ -80,11 +80,11 @@ function createStore(synapse, config) {
 
 Object.defineProperty(exports, "connect", {
   enumerable: true,
-  get: function () { return chunk5CTTHX5Q_cjs.connect; }
+  get: function () { return chunkELB55672_cjs.connect; }
 });
 Object.defineProperty(exports, "createSynapse", {
   enumerable: true,
-  get: function () { return chunk5CTTHX5Q_cjs.createSynapse; }
+  get: function () { return chunkELB55672_cjs.createSynapse; }
 });
 exports.createStore = createStore;
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

@@ -1,6 +1,7 @@
 export { ReadResourceRequest, ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
-import { C as ConnectOptions, A as App, S as SynapseOptions, a as Synapse, b as ActionReducer, c as StoreConfig, d as Store } from './types-DOfuRVJX.cjs';
-export { e as AgentAction, f as AppEventName, B as BuiltinActionType, D as DataChangedEvent, g as Dimensions, F as FileResult, H as HostInfo, K as KeyForwardConfig, N as NavigatePayload, h as NotifyPayload, R as RequestFileOptions, i as StateAcknowledgement, j as StoreDispatch, k as SynapseTheme, l as Theme, m as ToolCallResult, T as ToolDefinition, n as ToolResultData, V as VisibleState } from './types-DOfuRVJX.cjs';
+import { C as ConnectOptions, A as App, S as SynapseOptions, a as Synapse, b as ActionReducer, c as StoreConfig, d as Store } from './types-C3CQXGwh.cjs';
+export { e as AgentAction, f as AppEventName, B as BuiltinActionType, D as DataChangedEvent, g as Dimensions, F as FileResult, H as HostInfo, K as KeyForwardConfig, N as NavigatePayload, h as NotifyPayload, R as RequestFileOptions, i as StateAcknowledgement, j as StoreDispatch, k as SynapseTheme, l as Theme, m as ToolCallResult, T as ToolDefinition, n as ToolResultData, V as VisibleState } from './types-C3CQXGwh.cjs';
+import '@modelcontextprotocol/ext-apps';
 
 /**
  * Connect to a MCP Apps host.

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { ReadResourceRequest, ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
-import { C as ConnectOptions, A as App, S as SynapseOptions, a as Synapse, b as ActionReducer, c as StoreConfig, d as Store } from './types-DOfuRVJX.js';
-export { e as AgentAction, f as AppEventName, B as BuiltinActionType, D as DataChangedEvent, g as Dimensions, F as FileResult, H as HostInfo, K as KeyForwardConfig, N as NavigatePayload, h as NotifyPayload, R as RequestFileOptions, i as StateAcknowledgement, j as StoreDispatch, k as SynapseTheme, l as Theme, m as ToolCallResult, T as ToolDefinition, n as ToolResultData, V as VisibleState } from './types-DOfuRVJX.js';
+import { C as ConnectOptions, A as App, S as SynapseOptions, a as Synapse, b as ActionReducer, c as StoreConfig, d as Store } from './types-C3CQXGwh.js';
+export { e as AgentAction, f as AppEventName, B as BuiltinActionType, D as DataChangedEvent, g as Dimensions, F as FileResult, H as HostInfo, K as KeyForwardConfig, N as NavigatePayload, h as NotifyPayload, R as RequestFileOptions, i as StateAcknowledgement, j as StoreDispatch, k as SynapseTheme, l as Theme, m as ToolCallResult, T as ToolDefinition, n as ToolResultData, V as VisibleState } from './types-C3CQXGwh.js';
+import '@modelcontextprotocol/ext-apps';
 
 /**
  * Connect to a MCP Apps host.

package/dist/index.js

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

package/dist/react/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk5CTTHX5Q_cjs = require('../chunk-5CTTHX5Q.cjs');
+var chunkELB55672_cjs = require('../chunk-ELB55672.cjs');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
@@ -11,7 +11,7 @@ function AppProvider({ children, name, version, autoResize }) {
   react.useEffect(() => {
     if (connectingRef.current) return;
     connectingRef.current = true;
-    chunk5CTTHX5Q_cjs.connect({ name, version, autoResize }).then((a) => {
+    chunkELB55672_cjs.connect({ name, version, autoResize }).then((a) => {
       setApp(a);
     });
   }, []);
@@ -71,7 +71,7 @@ var SynapseContext = react.createContext(null);
 function SynapseProvider({ children, ...options }) {
   const ref = react.useRef(null);
   if (ref.current === null || ref.current.destroyed) {
-    ref.current = chunk5CTTHX5Q_cjs.createSynapse(options);
+    ref.current = chunkELB55672_cjs.createSynapse(options);
   }
   return /* @__PURE__ */ jsxRuntime.jsxs(SynapseContext.Provider, { value: ref.current, children: [
     /* @__PURE__ */ jsxRuntime.jsx(ThemeInjector, { synapse: ref.current }),
@@ -155,6 +155,15 @@ function useAgentAction(callback) {
     return synapse.onAction((action) => callbackRef.current(action));
   }, [synapse]);
 }
+function useHostContext() {
+  const synapse = useSynapseContext();
+  const [ctx, setCtx] = react.useState(() => synapse.getHostContext());
+  react.useEffect(() => {
+    setCtx(synapse.getHostContext());
+    return synapse.onHostContextChanged((c) => setCtx(c));
+  }, [synapse]);
+  return ctx;
+}
 function useTheme() {
   const synapse = useSynapseContext();
   const [theme, setTheme] = react.useState(() => synapse.getTheme());
@@ -239,6 +248,7 @@ exports.useChat = useChat;
 exports.useConnectTheme = useConnectTheme;
 exports.useDataSync = useDataSync;
 exports.useFileUpload = useFileUpload;
+exports.useHostContext = useHostContext;
 exports.useResize = useResize;
 exports.useStore = useStore;
 exports.useSynapse = useSynapse;

package/dist/react/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/react/app-provider.tsx","../../src/react/connect-hooks.ts","../../src/react/provider.tsx","../../src/react/hooks.ts"],"names":["createContext","useState","useRef","useEffect","connect","useContext","useCallback","createSynapse","jsx","useSyncExternalStore"],"mappings":"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","file":"index.cjs","sourcesContent":["import { createContext, type ReactNode, useContext, useEffect, useRef, useState } from \"react\";\nimport { connect } from \"../connect.js\";\nimport type { App, ConnectOptions } from \"../types.js\";\n\nconst AppContext = createContext<App | null>(null);\n\nexport interface AppProviderProps extends ConnectOptions {\n  children: ReactNode;\n}\n\nexport function AppProvider({ children, name, version, autoResize }: AppProviderProps) {\n  const [app, setApp] = useState<App | null>(null);\n  const connectingRef = useRef(false);\n\n  // biome-ignore lint/correctness/useExhaustiveDependencies: connect once on mount\n  useEffect(() => {\n    if (connectingRef.current) return;\n    connectingRef.current = true;\n\n    connect({ name, version, autoResize }).then((a) => {\n      setApp(a);\n    });\n  }, []);\n\n  if (!app) return null; // Don't render children until connected\n\n  return <AppContext.Provider value={app}>{children}</AppContext.Provider>;\n}\n\nexport function useAppContext(): App {\n  const ctx = useContext(AppContext);\n  if (!ctx) {\n    throw new Error(\n      \"useApp must be used within an <AppProvider>. Wrap your component tree with <AppProvider>.\",\n    );\n  }\n  return ctx;\n}\n","import { useCallback, useEffect, useState } from \"react\";\nimport type { App, Theme, ToolResultData } from \"../types.js\";\nimport { AppProvider, useAppContext } from \"./app-provider.js\";\n\nexport { AppProvider };\n\nexport function useApp(): App {\n  return useAppContext();\n}\n\nexport function useToolResult(): ToolResultData | null {\n  const app = useAppContext();\n  const [data, setData] = useState<ToolResultData | null>(null);\n\n  useEffect(() => {\n    return app.on(\"tool-result\", (result: ToolResultData) => {\n      setData(result);\n    });\n  }, [app]);\n\n  return data;\n}\n\nexport function useToolInput(): Record<string, unknown> | null {\n  const app = useAppContext();\n  const [input, setInput] = useState<Record<string, unknown> | null>(null);\n\n  useEffect(() => {\n    return app.on(\"tool-input\", (args: Record<string, unknown>) => {\n      setInput(args);\n    });\n  }, [app]);\n\n  return input;\n}\n\nexport function useConnectTheme(): Theme {\n  const app = useAppContext();\n  const [theme, setTheme] = useState<Theme>(() => app.theme);\n\n  useEffect(() => {\n    setTheme(app.theme); // Sync in case it changed between render and effect\n    return app.on(\"theme-changed\", (t: Theme) => {\n      setTheme(t);\n    });\n  }, [app]);\n\n  return theme;\n}\n\nexport function useResize(): (width?: number, height?: number) => void {\n  const app = useAppContext();\n  return useCallback((width?: number, height?: number) => app.resize(width, height), [app]);\n}\n","import { createContext, type ReactNode, useContext, useEffect, useRef, useState } from \"react\";\nimport { createSynapse } from \"../core.js\";\nimport type { Synapse, SynapseOptions, SynapseTheme } 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 (\n    <SynapseContext.Provider value={ref.current}>\n      <ThemeInjector synapse={ref.current} />\n      {children}\n    </SynapseContext.Provider>\n  );\n}\n\n/** Injects theme CSS variables onto document.documentElement whenever the theme changes. */\nfunction ThemeInjector({ synapse }: { synapse: Synapse }) {\n  const [theme, setTheme] = useState<SynapseTheme>(() => synapse.getTheme());\n\n  useEffect(() => {\n    setTheme(synapse.getTheme());\n    return synapse.onThemeChanged(setTheme);\n  }, [synapse]);\n\n  useEffect(() => {\n    if (theme.tokens) {\n      const style = document.documentElement.style;\n      for (const [k, v] of Object.entries(theme.tokens)) {\n        style.setProperty(k, v);\n      }\n    }\n  }, [theme]);\n\n  return null;\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  FileResult,\n  RequestFileOptions,\n  Store,\n  StoreDispatch,\n  Synapse,\n  SynapseTheme,\n  ToolCallResult,\n} from \"../types.js\";\nimport { SynapseProvider, useSynapseContext } from \"./provider.js\";\n\n// Re-export provider components\nexport { SynapseProvider };\n\nexport function useSynapse(): Synapse {\n  return useSynapseContext();\n}\n\nexport function useCallTool<TOutput = unknown>(\n  toolName: string,\n): {\n  call: (args?: Record<string, unknown>) => Promise<ToolCallResult<TOutput>>;\n  isPending: boolean;\n  error: Error | null;\n  data: TOutput | null;\n} {\n  const synapse = useSynapseContext();\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [data, setData] = useState<TOutput | null>(null);\n  const callIdRef = useRef(0);\n\n  const call = useCallback(\n    async (args?: Record<string, unknown>): Promise<ToolCallResult<TOutput>> => {\n      const id = ++callIdRef.current;\n      setIsPending(true);\n      setError(null);\n\n      try {\n        const result = await synapse.callTool<Record<string, unknown>, TOutput>(toolName, args);\n        // Stale guard: only update if this is still the latest call\n        if (id === callIdRef.current) {\n          setData(result.data);\n          setIsPending(false);\n        }\n        return result;\n      } catch (err) {\n        if (id === callIdRef.current) {\n          const e = err instanceof Error ? err : new Error(String(err));\n          setError(e);\n          setIsPending(false);\n        }\n        throw err;\n      }\n    },\n    [synapse, toolName],\n  );\n\n  return { call, isPending, error, data };\n}\n\nexport function useDataSync(callback: (event: DataChangedEvent) => void): void {\n  const synapse = useSynapseContext();\n  const callbackRef = useRef(callback);\n  callbackRef.current = callback;\n\n  useEffect(() => {\n    return synapse.onDataChanged((event) => callbackRef.current(event));\n  }, [synapse]);\n}\n\n/**\n * Subscribe to agent actions — typed, declarative commands from the server.\n *\n * Actions are emitted by tools as deterministic side effects (e.g., \"navigate\n * to the board I just created\"). The UI decides how to handle each action type.\n *\n * @example\n * ```tsx\n * useAgentAction((action) => {\n *   if (action.type === \"navigate\") {\n *     const { entity, id } = action.payload as NavigatePayload;\n *     if (entity === \"board\") setSelectedBoardId(id);\n *   }\n * });\n * ```\n */\nexport function useAgentAction(callback: (action: AgentAction) => void): void {\n  const synapse = useSynapseContext();\n  const callbackRef = useRef(callback);\n  callbackRef.current = callback;\n\n  useEffect(() => {\n    return synapse.onAction((action) => callbackRef.current(action));\n  }, [synapse]);\n}\n\nexport function useTheme(): SynapseTheme {\n  const synapse = useSynapseContext();\n  const [theme, setTheme] = useState<SynapseTheme>(() => synapse.getTheme());\n\n  useEffect(() => {\n    // Sync in case theme changed between render and effect\n    setTheme(synapse.getTheme());\n    return synapse.onThemeChanged(setTheme);\n  }, [synapse]);\n\n  return theme;\n}\n\nexport function useAction(): (action: string, params?: Record<string, unknown>) => void {\n  const synapse = useSynapseContext();\n  return useCallback(\n    (action: string, params?: Record<string, unknown>) => synapse.action(action, params),\n    [synapse],\n  );\n}\n\nexport function useChat(): (\n  message: string,\n  context?: { action?: string; entity?: string },\n) => void {\n  const synapse = useSynapseContext();\n  return useCallback(\n    (message: string, context?: { action?: string; entity?: string }) =>\n      synapse.chat(message, context),\n    [synapse],\n  );\n}\n\n/**\n * Push the app's visible state to the agent via ext-apps `ui/update-model-context`.\n *\n * **Imperative** (no args) — returns a push function you call manually:\n * ```tsx\n * const push = useVisibleState();\n * push({ board: selectedBoard }, \"Viewing board X\");\n * ```\n *\n * **Declarative** (factory + deps) — auto-pushes when deps change:\n * ```tsx\n * useVisibleState(() => ({\n *   state: { board: selectedBoard },\n *   summary: `Viewing \"${selectedBoard?.name}\"`,\n * }), [selectedBoard]);\n * ```\n */\nexport function useVisibleState(): (state: Record<string, unknown>, summary?: string) => void;\nexport function useVisibleState(\n  factory: () => { state: Record<string, unknown>; summary?: string },\n  deps: unknown[],\n): void;\nexport function useVisibleState(\n  factory?: () => { state: Record<string, unknown>; summary?: string },\n  deps?: unknown[],\n): ((state: Record<string, unknown>, summary?: string) => void) | undefined {\n  const synapse = useSynapseContext();\n  const push = useCallback(\n    (state: Record<string, unknown>, summary?: string) => synapse.setVisibleState(state, summary),\n    [synapse],\n  );\n\n  // Declarative mode: auto-push when deps change.\n  // The deps array is caller-provided (mirrors useMemo/useEffect pattern).\n  const factoryRef = useRef(factory);\n  factoryRef.current = factory;\n  useEffect(() => {\n    if (!factoryRef.current) return;\n    const { state, summary } = factoryRef.current();\n    push(state, summary);\n  }, [...(deps ?? []), push]);\n\n  if (!factory) return push;\n}\n\nexport function useFileUpload(): {\n  pickFile: (options?: RequestFileOptions) => Promise<FileResult | null>;\n  pickFiles: (options?: RequestFileOptions) => Promise<FileResult[]>;\n  isPending: boolean;\n} {\n  const synapse = useSynapseContext();\n  const [isPending, setIsPending] = useState(false);\n\n  const pickFile = useCallback(\n    async (options?: RequestFileOptions) => {\n      setIsPending(true);\n      try {\n        return await synapse.pickFile(options);\n      } finally {\n        setIsPending(false);\n      }\n    },\n    [synapse],\n  );\n\n  const pickFiles = useCallback(\n    async (options?: RequestFileOptions) => {\n      setIsPending(true);\n      try {\n        return await synapse.pickFiles(options);\n      } finally {\n        setIsPending(false);\n      }\n    },\n    [synapse],\n  );\n\n  return { pickFile, pickFiles, isPending };\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/app-provider.tsx","../../src/react/connect-hooks.ts","../../src/react/provider.tsx","../../src/react/hooks.ts"],"names":["createContext","useState","useRef","useEffect","connect","useContext","useCallback","createSynapse","jsx","useSyncExternalStore"],"mappings":"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","file":"index.cjs","sourcesContent":["import { createContext, type ReactNode, useContext, useEffect, useRef, useState } from \"react\";\nimport { connect } from \"../connect.js\";\nimport type { App, ConnectOptions } from \"../types.js\";\n\nconst AppContext = createContext<App | null>(null);\n\nexport interface AppProviderProps extends ConnectOptions {\n  children: ReactNode;\n}\n\nexport function AppProvider({ children, name, version, autoResize }: AppProviderProps) {\n  const [app, setApp] = useState<App | null>(null);\n  const connectingRef = useRef(false);\n\n  // biome-ignore lint/correctness/useExhaustiveDependencies: connect once on mount\n  useEffect(() => {\n    if (connectingRef.current) return;\n    connectingRef.current = true;\n\n    connect({ name, version, autoResize }).then((a) => {\n      setApp(a);\n    });\n  }, []);\n\n  if (!app) return null; // Don't render children until connected\n\n  return <AppContext.Provider value={app}>{children}</AppContext.Provider>;\n}\n\nexport function useAppContext(): App {\n  const ctx = useContext(AppContext);\n  if (!ctx) {\n    throw new Error(\n      \"useApp must be used within an <AppProvider>. Wrap your component tree with <AppProvider>.\",\n    );\n  }\n  return ctx;\n}\n","import { useCallback, useEffect, useState } from \"react\";\nimport type { App, Theme, ToolResultData } from \"../types.js\";\nimport { AppProvider, useAppContext } from \"./app-provider.js\";\n\nexport { AppProvider };\n\nexport function useApp(): App {\n  return useAppContext();\n}\n\nexport function useToolResult(): ToolResultData | null {\n  const app = useAppContext();\n  const [data, setData] = useState<ToolResultData | null>(null);\n\n  useEffect(() => {\n    return app.on(\"tool-result\", (result: ToolResultData) => {\n      setData(result);\n    });\n  }, [app]);\n\n  return data;\n}\n\nexport function useToolInput(): Record<string, unknown> | null {\n  const app = useAppContext();\n  const [input, setInput] = useState<Record<string, unknown> | null>(null);\n\n  useEffect(() => {\n    return app.on(\"tool-input\", (args: Record<string, unknown>) => {\n      setInput(args);\n    });\n  }, [app]);\n\n  return input;\n}\n\nexport function useConnectTheme(): Theme {\n  const app = useAppContext();\n  const [theme, setTheme] = useState<Theme>(() => app.theme);\n\n  useEffect(() => {\n    setTheme(app.theme); // Sync in case it changed between render and effect\n    return app.on(\"theme-changed\", (t: Theme) => {\n      setTheme(t);\n    });\n  }, [app]);\n\n  return theme;\n}\n\nexport function useResize(): (width?: number, height?: number) => void {\n  const app = useAppContext();\n  return useCallback((width?: number, height?: number) => app.resize(width, height), [app]);\n}\n","import { createContext, type ReactNode, useContext, useEffect, useRef, useState } from \"react\";\nimport { createSynapse } from \"../core.js\";\nimport type { Synapse, SynapseOptions, SynapseTheme } 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 (\n    <SynapseContext.Provider value={ref.current}>\n      <ThemeInjector synapse={ref.current} />\n      {children}\n    </SynapseContext.Provider>\n  );\n}\n\n/** Injects theme CSS variables onto document.documentElement whenever the theme changes. */\nfunction ThemeInjector({ synapse }: { synapse: Synapse }) {\n  const [theme, setTheme] = useState<SynapseTheme>(() => synapse.getTheme());\n\n  useEffect(() => {\n    setTheme(synapse.getTheme());\n    return synapse.onThemeChanged(setTheme);\n  }, [synapse]);\n\n  useEffect(() => {\n    if (theme.tokens) {\n      const style = document.documentElement.style;\n      for (const [k, v] of Object.entries(theme.tokens)) {\n        style.setProperty(k, v);\n      }\n    }\n  }, [theme]);\n\n  return null;\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 type { McpUiHostContext } from \"@modelcontextprotocol/ext-apps\";\nimport { useCallback, useEffect, useRef, useState, useSyncExternalStore } from \"react\";\nimport type {\n  ActionReducer,\n  AgentAction,\n  DataChangedEvent,\n  FileResult,\n  RequestFileOptions,\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\n/**\n * Subscribe to the full ext-apps host context.\n *\n * Returns the host context bag — spec-standardized fields (`theme`, `styles`,\n * `displayMode`, `toolInfo`) plus any host extensions. Re-renders on every\n * `ui/notifications/host-context-changed` notification.\n *\n * Prefer `useTheme()` when only theming matters (it filters no-op fires and\n * returns a typed `SynapseTheme`). Reach for `useHostContext()` for non-theme\n * fields like host-specific extensions, e.g. on NimbleBrain:\n *\n * ```tsx\n * const { workspace } = useHostContext<{ workspace?: { id: string } }>();\n * ```\n */\nexport function useHostContext<T extends McpUiHostContext = McpUiHostContext>(): T {\n  const synapse = useSynapseContext();\n  const [ctx, setCtx] = useState<T>(() => synapse.getHostContext() as T);\n\n  useEffect(() => {\n    // Sync in case context changed between render and effect\n    setCtx(synapse.getHostContext() as T);\n    return synapse.onHostContextChanged((c) => setCtx(c as T));\n  }, [synapse]);\n\n  return ctx;\n}\n\n/**\n * Re-renders only when the derived `SynapseTheme` actually changes (mode,\n * primaryColor, or any token value). Routes through `synapse.onThemeChanged`\n * — which is itself a `themesEqual`-filtered selector over the unified host\n * context — so a host-context update that doesn't move the theme (e.g. a\n * workspace switch) does NOT cause this hook's consumers to re-render.\n *\n * Building this on `useHostContext` instead would skip the filter: every\n * host-context-changed notification produces a new context reference, which\n * would propagate through `useState` and force a re-render even when the\n * derived theme is unchanged.\n */\nexport function useTheme(): SynapseTheme {\n  const synapse = useSynapseContext();\n  const [theme, setTheme] = useState<SynapseTheme>(() => synapse.getTheme());\n\n  useEffect(() => {\n    // Sync in case theme changed between render and effect\n    setTheme(synapse.getTheme());\n    return synapse.onThemeChanged(setTheme);\n  }, [synapse]);\n\n  return theme;\n}\n\nexport function useAction(): (action: string, params?: Record<string, unknown>) => void {\n  const synapse = useSynapseContext();\n  return useCallback(\n    (action: string, params?: Record<string, unknown>) => synapse.action(action, params),\n    [synapse],\n  );\n}\n\nexport function useChat(): (\n  message: string,\n  context?: { action?: string; entity?: string },\n) => void {\n  const synapse = useSynapseContext();\n  return useCallback(\n    (message: string, context?: { action?: string; entity?: string }) =>\n      synapse.chat(message, context),\n    [synapse],\n  );\n}\n\n/**\n * Push the app's visible state to the agent via ext-apps `ui/update-model-context`.\n *\n * **Imperative** (no args) — returns a push function you call manually:\n * ```tsx\n * const push = useVisibleState();\n * push({ board: selectedBoard }, \"Viewing board X\");\n * ```\n *\n * **Declarative** (factory + deps) — auto-pushes when deps change:\n * ```tsx\n * useVisibleState(() => ({\n *   state: { board: selectedBoard },\n *   summary: `Viewing \"${selectedBoard?.name}\"`,\n * }), [selectedBoard]);\n * ```\n */\nexport function useVisibleState(): (state: Record<string, unknown>, summary?: string) => void;\nexport function useVisibleState(\n  factory: () => { state: Record<string, unknown>; summary?: string },\n  deps: unknown[],\n): void;\nexport function useVisibleState(\n  factory?: () => { state: Record<string, unknown>; summary?: string },\n  deps?: unknown[],\n): ((state: Record<string, unknown>, summary?: string) => void) | undefined {\n  const synapse = useSynapseContext();\n  const push = useCallback(\n    (state: Record<string, unknown>, summary?: string) => synapse.setVisibleState(state, summary),\n    [synapse],\n  );\n\n  // Declarative mode: auto-push when deps change.\n  // The deps array is caller-provided (mirrors useMemo/useEffect pattern).\n  const factoryRef = useRef(factory);\n  factoryRef.current = factory;\n  useEffect(() => {\n    if (!factoryRef.current) return;\n    const { state, summary } = factoryRef.current();\n    push(state, summary);\n  }, [...(deps ?? []), push]);\n\n  if (!factory) return push;\n}\n\nexport function useFileUpload(): {\n  pickFile: (options?: RequestFileOptions) => Promise<FileResult | null>;\n  pickFiles: (options?: RequestFileOptions) => Promise<FileResult[]>;\n  isPending: boolean;\n} {\n  const synapse = useSynapseContext();\n  const [isPending, setIsPending] = useState(false);\n\n  const pickFile = useCallback(\n    async (options?: RequestFileOptions) => {\n      setIsPending(true);\n      try {\n        return await synapse.pickFile(options);\n      } finally {\n        setIsPending(false);\n      }\n    },\n    [synapse],\n  );\n\n  const pickFiles = useCallback(\n    async (options?: RequestFileOptions) => {\n      setIsPending(true);\n      try {\n        return await synapse.pickFiles(options);\n      } finally {\n        setIsPending(false);\n      }\n    },\n    [synapse],\n  );\n\n  return { pickFile, pickFiles, isPending };\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,6 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { C as ConnectOptions, A as App, l as Theme, n as ToolResultData, S as SynapseOptions, e as AgentAction, m as ToolCallResult, D as DataChangedEvent, R as RequestFileOptions, F as FileResult, b as ActionReducer, d as Store, j as StoreDispatch, a as Synapse, k as SynapseTheme } from '../types-DOfuRVJX.cjs';
+import { C as ConnectOptions, A as App, l as Theme, n as ToolResultData, S as SynapseOptions, e as AgentAction, m as ToolCallResult, D as DataChangedEvent, R as RequestFileOptions, F as FileResult, b as ActionReducer, d as Store, j as StoreDispatch, a as Synapse, k as SynapseTheme } from '../types-C3CQXGwh.cjs';
+import { McpUiHostContext } from '@modelcontextprotocol/ext-apps';
 import '@modelcontextprotocol/sdk/types.js';
 
 interface AppProviderProps extends ConnectOptions {
@@ -44,6 +45,34 @@ declare function useDataSync(callback: (event: DataChangedEvent) => void): void;
  * ```
  */
 declare function useAgentAction(callback: (action: AgentAction) => void): void;
+/**
+ * Subscribe to the full ext-apps host context.
+ *
+ * Returns the host context bag — spec-standardized fields (`theme`, `styles`,
+ * `displayMode`, `toolInfo`) plus any host extensions. Re-renders on every
+ * `ui/notifications/host-context-changed` notification.
+ *
+ * Prefer `useTheme()` when only theming matters (it filters no-op fires and
+ * returns a typed `SynapseTheme`). Reach for `useHostContext()` for non-theme
+ * fields like host-specific extensions, e.g. on NimbleBrain:
+ *
+ * ```tsx
+ * const { workspace } = useHostContext<{ workspace?: { id: string } }>();
+ * ```
+ */
+declare function useHostContext<T extends McpUiHostContext = McpUiHostContext>(): T;
+/**
+ * Re-renders only when the derived `SynapseTheme` actually changes (mode,
+ * primaryColor, or any token value). Routes through `synapse.onThemeChanged`
+ * — which is itself a `themesEqual`-filtered selector over the unified host
+ * context — so a host-context update that doesn't move the theme (e.g. a
+ * workspace switch) does NOT cause this hook's consumers to re-render.
+ *
+ * Building this on `useHostContext` instead would skip the filter: every
+ * host-context-changed notification produces a new context reference, which
+ * would propagate through `useState` and force a re-render even when the
+ * derived theme is unchanged.
+ */
 declare function useTheme(): SynapseTheme;
 declare function useAction(): (action: string, params?: Record<string, unknown>) => void;
 declare function useChat(): (message: string, context?: {
@@ -82,4 +111,4 @@ declare function useStore<TState, TActions extends Record<string, ActionReducer<
     dispatch: StoreDispatch<TActions>;
 };
 
-export { AppProvider, type AppProviderProps, SynapseProvider, type SynapseProviderProps, useAction, useAgentAction, useApp, useCallTool, useChat, useConnectTheme, useDataSync, useFileUpload, useResize, useStore, useSynapse, useTheme, useToolInput, useToolResult, useVisibleState };
+export { AppProvider, type AppProviderProps, SynapseProvider, type SynapseProviderProps, useAction, useAgentAction, useApp, useCallTool, useChat, useConnectTheme, useDataSync, useFileUpload, useHostContext, useResize, useStore, useSynapse, useTheme, useToolInput, useToolResult, useVisibleState };

package/dist/react/index.d.ts

@@ -1,6 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { C as ConnectOptions, A as App, l as Theme, n as ToolResultData, S as SynapseOptions, e as AgentAction, m as ToolCallResult, D as DataChangedEvent, R as RequestFileOptions, F as FileResult, b as ActionReducer, d as Store, j as StoreDispatch, a as Synapse, k as SynapseTheme } from '../types-DOfuRVJX.js';
+import { C as ConnectOptions, A as App, l as Theme, n as ToolResultData, S as SynapseOptions, e as AgentAction, m as ToolCallResult, D as DataChangedEvent, R as RequestFileOptions, F as FileResult, b as ActionReducer, d as Store, j as StoreDispatch, a as Synapse, k as SynapseTheme } from '../types-C3CQXGwh.js';
+import { McpUiHostContext } from '@modelcontextprotocol/ext-apps';
 import '@modelcontextprotocol/sdk/types.js';
 
 interface AppProviderProps extends ConnectOptions {
@@ -44,6 +45,34 @@ declare function useDataSync(callback: (event: DataChangedEvent) => void): void;
  * ```
  */
 declare function useAgentAction(callback: (action: AgentAction) => void): void;
+/**
+ * Subscribe to the full ext-apps host context.
+ *
+ * Returns the host context bag — spec-standardized fields (`theme`, `styles`,
+ * `displayMode`, `toolInfo`) plus any host extensions. Re-renders on every
+ * `ui/notifications/host-context-changed` notification.
+ *
+ * Prefer `useTheme()` when only theming matters (it filters no-op fires and
+ * returns a typed `SynapseTheme`). Reach for `useHostContext()` for non-theme
+ * fields like host-specific extensions, e.g. on NimbleBrain:
+ *
+ * ```tsx
+ * const { workspace } = useHostContext<{ workspace?: { id: string } }>();
+ * ```
+ */
+declare function useHostContext<T extends McpUiHostContext = McpUiHostContext>(): T;
+/**
+ * Re-renders only when the derived `SynapseTheme` actually changes (mode,
+ * primaryColor, or any token value). Routes through `synapse.onThemeChanged`
+ * — which is itself a `themesEqual`-filtered selector over the unified host
+ * context — so a host-context update that doesn't move the theme (e.g. a
+ * workspace switch) does NOT cause this hook's consumers to re-render.
+ *
+ * Building this on `useHostContext` instead would skip the filter: every
+ * host-context-changed notification produces a new context reference, which
+ * would propagate through `useState` and force a re-render even when the
+ * derived theme is unchanged.
+ */
 declare function useTheme(): SynapseTheme;
 declare function useAction(): (action: string, params?: Record<string, unknown>) => void;
 declare function useChat(): (message: string, context?: {
@@ -82,4 +111,4 @@ declare function useStore<TState, TActions extends Record<string, ActionReducer<
     dispatch: StoreDispatch<TActions>;
 };
 
-export { AppProvider, type AppProviderProps, SynapseProvider, type SynapseProviderProps, useAction, useAgentAction, useApp, useCallTool, useChat, useConnectTheme, useDataSync, useFileUpload, useResize, useStore, useSynapse, useTheme, useToolInput, useToolResult, useVisibleState };
+export { AppProvider, type AppProviderProps, SynapseProvider, type SynapseProviderProps, useAction, useAgentAction, useApp, useCallTool, useChat, useConnectTheme, useDataSync, useFileUpload, useHostContext, useResize, useStore, useSynapse, useTheme, useToolInput, useToolResult, useVisibleState };

package/dist/react/index.js

@@ -1,4 +1,4 @@
-import { connect, createSynapse } from '../chunk-VBL7H4C7.js';
+import { connect, createSynapse } from '../chunk-XOCMQYQX.js';
 import { createContext, useState, useRef, useEffect, useCallback, useSyncExternalStore, useContext } from 'react';
 import { jsx, jsxs } from 'react/jsx-runtime';
 
@@ -153,6 +153,15 @@ function useAgentAction(callback) {
     return synapse.onAction((action) => callbackRef.current(action));
   }, [synapse]);
 }
+function useHostContext() {
+  const synapse = useSynapseContext();
+  const [ctx, setCtx] = useState(() => synapse.getHostContext());
+  useEffect(() => {
+    setCtx(synapse.getHostContext());
+    return synapse.onHostContextChanged((c) => setCtx(c));
+  }, [synapse]);
+  return ctx;
+}
 function useTheme() {
   const synapse = useSynapseContext();
   const [theme, setTheme] = useState(() => synapse.getTheme());
@@ -227,6 +236,6 @@ function useStore(store) {
   return { state, dispatch: store.dispatch };
 }
 
-export { AppProvider, SynapseProvider, useAction, useAgentAction, useApp, useCallTool, useChat, useConnectTheme, useDataSync, useFileUpload, useResize, useStore, useSynapse, useTheme, useToolInput, useToolResult, useVisibleState };
+export { AppProvider, SynapseProvider, useAction, useAgentAction, useApp, useCallTool, useChat, useConnectTheme, useDataSync, useFileUpload, useHostContext, useResize, useStore, useSynapse, useTheme, useToolInput, useToolResult, useVisibleState };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/react/app-provider.tsx","../../src/react/connect-hooks.ts","../../src/react/provider.tsx","../../src/react/hooks.ts"],"names":["useState","useEffect","createContext","useRef","jsx","useContext","useCallback"],"mappings":";;;;AAIA,IAAM,UAAA,GAAa,cAA0B,IAAI,CAAA;AAM1C,SAAS,YAAY,EAAE,QAAA,EAAU,IAAA,EAAM,OAAA,EAAS,YAAW,EAAqB;AACrF,EAAA,MAAM,CAAC,GAAA,EAAK,MAAM,CAAA,GAAI,SAAqB,IAAI,CAAA;AAC/C,EAAA,MAAM,aAAA,GAAgB,OAAO,KAAK,CAAA;AAGlC,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,cAAc,OAAA,EAAS;AAC3B,IAAA,aAAA,CAAc,OAAA,GAAU,IAAA;AAExB,IAAA,OAAA,CAAQ,EAAE,MAAM,OAAA,EAAS,UAAA,EAAY,CAAA,CAAE,IAAA,CAAK,CAAC,CAAA,KAAM;AACjD,MAAA,MAAA,CAAO,CAAC,CAAA;AAAA,IACV,CAAC,CAAA;AAAA,EACH,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,IAAI,CAAC,KAAK,OAAO,IAAA;AAEjB,EAAA,2BAAQ,UAAA,CAAW,QAAA,EAAX,EAAoB,KAAA,EAAO,KAAM,QAAA,EAAS,CAAA;AACpD;AAEO,SAAS,aAAA,GAAqB;AACnC,EAAA,MAAM,GAAA,GAAM,WAAW,UAAU,CAAA;AACjC,EAAA,IAAI,CAAC,GAAA,EAAK;AACR,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AACA,EAAA,OAAO,GAAA;AACT;;;AC/BO,SAAS,MAAA,GAAc;AAC5B,EAAA,OAAO,aAAA,EAAc;AACvB;AAEO,SAAS,aAAA,GAAuC;AACrD,EAAA,MAAM,MAAM,aAAA,EAAc;AAC1B,EAAA,MAAM,CAAC,IAAA,EAAM,OAAO,CAAA,GAAIA,SAAgC,IAAI,CAAA;AAE5D,EAAAC,UAAU,MAAM;AACd,IAAA,OAAO,GAAA,CAAI,EAAA,CAAG,aAAA,EAAe,CAAC,MAAA,KAA2B;AACvD,MAAA,OAAA,CAAQ,MAAM,CAAA;AAAA,IAChB,CAAC,CAAA;AAAA,EACH,CAAA,EAAG,CAAC,GAAG,CAAC,CAAA;AAER,EAAA,OAAO,IAAA;AACT;AAEO,SAAS,YAAA,GAA+C;AAC7D,EAAA,MAAM,MAAM,aAAA,EAAc;AAC1B,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAID,SAAyC,IAAI,CAAA;AAEvE,EAAAC,UAAU,MAAM;AACd,IAAA,OAAO,GAAA,CAAI,EAAA,CAAG,YAAA,EAAc,CAAC,IAAA,KAAkC;AAC7D,MAAA,QAAA,CAAS,IAAI,CAAA;AAAA,IACf,CAAC,CAAA;AAAA,EACH,CAAA,EAAG,CAAC,GAAG,CAAC,CAAA;AAER,EAAA,OAAO,KAAA;AACT;AAEO,SAAS,eAAA,GAAyB;AACvC,EAAA,MAAM,MAAM,aAAA,EAAc;AAC1B,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,IAAID,QAAAA,CAAgB,MAAM,IAAI,KAAK,CAAA;AAEzD,EAAAC,UAAU,MAAM;AACd,IAAA,QAAA,CAAS,IAAI,KAAK,CAAA;AAClB,IAAA,OAAO,GAAA,CAAI,EAAA,CAAG,eAAA,EAAiB,CAAC,CAAA,KAAa;AAC3C,MAAA,QAAA,CAAS,CAAC,CAAA;AAAA,IACZ,CAAC,CAAA;AAAA,EACH,CAAA,EAAG,CAAC,GAAG,CAAC,CAAA;AAER,EAAA,OAAO,KAAA;AACT;AAEO,SAAS,SAAA,GAAuD;AACrE,EAAA,MAAM,MAAM,aAAA,EAAc;AAC1B,EAAA,OAAO,WAAA,CAAY,CAAC,KAAA,EAAgB,MAAA,KAAoB,GAAA,CAAI,MAAA,CAAO,KAAA,EAAO,MAAM,CAAA,EAAG,CAAC,GAAG,CAAC,CAAA;AAC1F;ACjDA,IAAM,cAAA,GAAiBC,cAA8B,IAAI,CAAA;AAMlD,SAAS,eAAA,CAAgB,EAAE,QAAA,EAAU,GAAG,SAAQ,EAAyB;AAK9E,EAAA,MAAM,GAAA,GAAMC,OAAuB,IAAI,CAAA;AAEvC,EAAA,IAAI,GAAA,CAAI,OAAA,KAAY,IAAA,IAAQ,GAAA,CAAI,QAAQ,SAAA,EAAW;AACjD,IAAA,GAAA,CAAI,OAAA,GAAU,cAAc,OAAO,CAAA;AAAA,EACrC;AAEA,EAAA,4BACG,cAAA,CAAe,QAAA,EAAf,EAAwB,KAAA,EAAO,IAAI,OAAA,EAClC,QAAA,EAAA;AAAA,oBAAAC,GAAAA,CAAC,aAAA,EAAA,EAAc,OAAA,EAAS,GAAA,CAAI,OAAA,EAAS,CAAA;AAAA,IACpC;AAAA,GAAA,EACH,CAAA;AAEJ;AAGA,SAAS,aAAA,CAAc,EAAE,OAAA,EAAQ,EAAyB;AACxD,EAAA,MAAM,CAAC,OAAO,QAAQ,CAAA,GAAIJ,SAAuB,MAAM,OAAA,CAAQ,UAAU,CAAA;AAEzE,EAAAC,UAAU,MAAM;AACd,IAAA,QAAA,CAAS,OAAA,CAAQ,UAAU,CAAA;AAC3B,IAAA,OAAO,OAAA,CAAQ,eAAe,QAAQ,CAAA;AAAA,EACxC,CAAA,EAAG,CAAC,OAAO,CAAC,CAAA;AAEZ,EAAAA,UAAU,MAAM;AACd,IAAA,IAAI,MAAM,MAAA,EAAQ;AAChB,MAAA,MAAM,KAAA,GAAQ,SAAS,eAAA,CAAgB,KAAA;AACvC,MAAA,KAAA,MAAW,CAAC,GAAG,CAAC,CAAA,IAAK,OAAO,OAAA,CAAQ,KAAA,CAAM,MAAM,CAAA,EAAG;AACjD,QAAA,KAAA,CAAM,WAAA,CAAY,GAAG,CAAC,CAAA;AAAA,MACxB;AAAA,IACF;AAAA,EACF,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AAEV,EAAA,OAAO,IAAA;AACT;AAEO,SAAS,iBAAA,GAA6B;AAC3C,EAAA,MAAM,GAAA,GAAMI,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;;;ACzCO,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,GAAIL,SAAS,KAAK,CAAA;AAChD,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,SAAuB,IAAI,CAAA;AACrD,EAAA,MAAM,CAAC,IAAA,EAAM,OAAO,CAAA,GAAIA,SAAyB,IAAI,CAAA;AACrD,EAAA,MAAM,SAAA,GAAYG,OAAO,CAAC,CAAA;AAE1B,EAAA,MAAM,IAAA,GAAOG,WAAAA;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,GAAcH,OAAO,QAAQ,CAAA;AACnC,EAAA,WAAA,CAAY,OAAA,GAAU,QAAA;AAEtB,EAAAF,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;AAkBO,SAAS,eAAe,QAAA,EAA+C;AAC5E,EAAA,MAAM,UAAU,iBAAA,EAAkB;AAClC,EAAA,MAAM,WAAA,GAAcE,OAAO,QAAQ,CAAA;AACnC,EAAA,WAAA,CAAY,OAAA,GAAU,QAAA;AAEtB,EAAAF,UAAU,MAAM;AACd,IAAA,OAAO,QAAQ,QAAA,CAAS,CAAC,WAAW,WAAA,CAAY,OAAA,CAAQ,MAAM,CAAC,CAAA;AAAA,EACjE,CAAA,EAAG,CAAC,OAAO,CAAC,CAAA;AACd;AAEO,SAAS,QAAA,GAAyB;AACvC,EAAA,MAAM,UAAU,iBAAA,EAAkB;AAClC,EAAA,MAAM,CAAC,OAAO,QAAQ,CAAA,GAAID,SAAuB,MAAM,OAAA,CAAQ,UAAU,CAAA;AAEzE,EAAAC,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,OAAOK,WAAAA;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,OAAOA,WAAAA;AAAA,IACL,CAAC,OAAA,EAAiB,OAAA,KAChB,OAAA,CAAQ,IAAA,CAAK,SAAS,OAAO,CAAA;AAAA,IAC/B,CAAC,OAAO;AAAA,GACV;AACF;AAwBO,SAAS,eAAA,CACd,SACA,IAAA,EAC0E;AAC1E,EAAA,MAAM,UAAU,iBAAA,EAAkB;AAClC,EAAA,MAAM,IAAA,GAAOA,WAAAA;AAAA,IACX,CAAC,KAAA,EAAgC,OAAA,KAAqB,OAAA,CAAQ,eAAA,CAAgB,OAAO,OAAO,CAAA;AAAA,IAC5F,CAAC,OAAO;AAAA,GACV;AAIA,EAAA,MAAM,UAAA,GAAaH,OAAO,OAAO,CAAA;AACjC,EAAA,UAAA,CAAW,OAAA,GAAU,OAAA;AACrB,EAAAF,UAAU,MAAM;AACd,IAAA,IAAI,CAAC,WAAW,OAAA,EAAS;AACzB,IAAA,MAAM,EAAE,KAAA,EAAO,OAAA,EAAQ,GAAI,WAAW,OAAA,EAAQ;AAC9C,IAAA,IAAA,CAAK,OAAO,OAAO,CAAA;AAAA,EACrB,GAAG,CAAC,GAAI,QAAQ,EAAC,EAAI,IAAI,CAAC,CAAA;AAE1B,EAAA,IAAI,CAAC,SAAS,OAAO,IAAA;AACvB;AAEO,SAAS,aAAA,GAId;AACA,EAAA,MAAM,UAAU,iBAAA,EAAkB;AAClC,EAAA,MAAM,CAAC,SAAA,EAAW,YAAY,CAAA,GAAID,SAAS,KAAK,CAAA;AAEhD,EAAA,MAAM,QAAA,GAAWM,WAAAA;AAAA,IACf,OAAO,OAAA,KAAiC;AACtC,MAAA,YAAA,CAAa,IAAI,CAAA;AACjB,MAAA,IAAI;AACF,QAAA,OAAO,MAAM,OAAA,CAAQ,QAAA,CAAS,OAAO,CAAA;AAAA,MACvC,CAAA,SAAE;AACA,QAAA,YAAA,CAAa,KAAK,CAAA;AAAA,MACpB;AAAA,IACF,CAAA;AAAA,IACA,CAAC,OAAO;AAAA,GACV;AAEA,EAAA,MAAM,SAAA,GAAYA,WAAAA;AAAA,IAChB,OAAO,OAAA,KAAiC;AACtC,MAAA,YAAA,CAAa,IAAI,CAAA;AACjB,MAAA,IAAI;AACF,QAAA,OAAO,MAAM,OAAA,CAAQ,SAAA,CAAU,OAAO,CAAA;AAAA,MACxC,CAAA,SAAE;AACA,QAAA,YAAA,CAAa,KAAK,CAAA;AAAA,MACpB;AAAA,IACF,CAAA;AAAA,IACA,CAAC,OAAO;AAAA,GACV;AAEA,EAAA,OAAO,EAAE,QAAA,EAAU,SAAA,EAAW,SAAA,EAAU;AAC1C;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, useState } from \"react\";\nimport { connect } from \"../connect.js\";\nimport type { App, ConnectOptions } from \"../types.js\";\n\nconst AppContext = createContext<App | null>(null);\n\nexport interface AppProviderProps extends ConnectOptions {\n  children: ReactNode;\n}\n\nexport function AppProvider({ children, name, version, autoResize }: AppProviderProps) {\n  const [app, setApp] = useState<App | null>(null);\n  const connectingRef = useRef(false);\n\n  // biome-ignore lint/correctness/useExhaustiveDependencies: connect once on mount\n  useEffect(() => {\n    if (connectingRef.current) return;\n    connectingRef.current = true;\n\n    connect({ name, version, autoResize }).then((a) => {\n      setApp(a);\n    });\n  }, []);\n\n  if (!app) return null; // Don't render children until connected\n\n  return <AppContext.Provider value={app}>{children}</AppContext.Provider>;\n}\n\nexport function useAppContext(): App {\n  const ctx = useContext(AppContext);\n  if (!ctx) {\n    throw new Error(\n      \"useApp must be used within an <AppProvider>. Wrap your component tree with <AppProvider>.\",\n    );\n  }\n  return ctx;\n}\n","import { useCallback, useEffect, useState } from \"react\";\nimport type { App, Theme, ToolResultData } from \"../types.js\";\nimport { AppProvider, useAppContext } from \"./app-provider.js\";\n\nexport { AppProvider };\n\nexport function useApp(): App {\n  return useAppContext();\n}\n\nexport function useToolResult(): ToolResultData | null {\n  const app = useAppContext();\n  const [data, setData] = useState<ToolResultData | null>(null);\n\n  useEffect(() => {\n    return app.on(\"tool-result\", (result: ToolResultData) => {\n      setData(result);\n    });\n  }, [app]);\n\n  return data;\n}\n\nexport function useToolInput(): Record<string, unknown> | null {\n  const app = useAppContext();\n  const [input, setInput] = useState<Record<string, unknown> | null>(null);\n\n  useEffect(() => {\n    return app.on(\"tool-input\", (args: Record<string, unknown>) => {\n      setInput(args);\n    });\n  }, [app]);\n\n  return input;\n}\n\nexport function useConnectTheme(): Theme {\n  const app = useAppContext();\n  const [theme, setTheme] = useState<Theme>(() => app.theme);\n\n  useEffect(() => {\n    setTheme(app.theme); // Sync in case it changed between render and effect\n    return app.on(\"theme-changed\", (t: Theme) => {\n      setTheme(t);\n    });\n  }, [app]);\n\n  return theme;\n}\n\nexport function useResize(): (width?: number, height?: number) => void {\n  const app = useAppContext();\n  return useCallback((width?: number, height?: number) => app.resize(width, height), [app]);\n}\n","import { createContext, type ReactNode, useContext, useEffect, useRef, useState } from \"react\";\nimport { createSynapse } from \"../core.js\";\nimport type { Synapse, SynapseOptions, SynapseTheme } 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 (\n    <SynapseContext.Provider value={ref.current}>\n      <ThemeInjector synapse={ref.current} />\n      {children}\n    </SynapseContext.Provider>\n  );\n}\n\n/** Injects theme CSS variables onto document.documentElement whenever the theme changes. */\nfunction ThemeInjector({ synapse }: { synapse: Synapse }) {\n  const [theme, setTheme] = useState<SynapseTheme>(() => synapse.getTheme());\n\n  useEffect(() => {\n    setTheme(synapse.getTheme());\n    return synapse.onThemeChanged(setTheme);\n  }, [synapse]);\n\n  useEffect(() => {\n    if (theme.tokens) {\n      const style = document.documentElement.style;\n      for (const [k, v] of Object.entries(theme.tokens)) {\n        style.setProperty(k, v);\n      }\n    }\n  }, [theme]);\n\n  return null;\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  FileResult,\n  RequestFileOptions,\n  Store,\n  StoreDispatch,\n  Synapse,\n  SynapseTheme,\n  ToolCallResult,\n} from \"../types.js\";\nimport { SynapseProvider, useSynapseContext } from \"./provider.js\";\n\n// Re-export provider components\nexport { SynapseProvider };\n\nexport function useSynapse(): Synapse {\n  return useSynapseContext();\n}\n\nexport function useCallTool<TOutput = unknown>(\n  toolName: string,\n): {\n  call: (args?: Record<string, unknown>) => Promise<ToolCallResult<TOutput>>;\n  isPending: boolean;\n  error: Error | null;\n  data: TOutput | null;\n} {\n  const synapse = useSynapseContext();\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [data, setData] = useState<TOutput | null>(null);\n  const callIdRef = useRef(0);\n\n  const call = useCallback(\n    async (args?: Record<string, unknown>): Promise<ToolCallResult<TOutput>> => {\n      const id = ++callIdRef.current;\n      setIsPending(true);\n      setError(null);\n\n      try {\n        const result = await synapse.callTool<Record<string, unknown>, TOutput>(toolName, args);\n        // Stale guard: only update if this is still the latest call\n        if (id === callIdRef.current) {\n          setData(result.data);\n          setIsPending(false);\n        }\n        return result;\n      } catch (err) {\n        if (id === callIdRef.current) {\n          const e = err instanceof Error ? err : new Error(String(err));\n          setError(e);\n          setIsPending(false);\n        }\n        throw err;\n      }\n    },\n    [synapse, toolName],\n  );\n\n  return { call, isPending, error, data };\n}\n\nexport function useDataSync(callback: (event: DataChangedEvent) => void): void {\n  const synapse = useSynapseContext();\n  const callbackRef = useRef(callback);\n  callbackRef.current = callback;\n\n  useEffect(() => {\n    return synapse.onDataChanged((event) => callbackRef.current(event));\n  }, [synapse]);\n}\n\n/**\n * Subscribe to agent actions — typed, declarative commands from the server.\n *\n * Actions are emitted by tools as deterministic side effects (e.g., \"navigate\n * to the board I just created\"). The UI decides how to handle each action type.\n *\n * @example\n * ```tsx\n * useAgentAction((action) => {\n *   if (action.type === \"navigate\") {\n *     const { entity, id } = action.payload as NavigatePayload;\n *     if (entity === \"board\") setSelectedBoardId(id);\n *   }\n * });\n * ```\n */\nexport function useAgentAction(callback: (action: AgentAction) => void): void {\n  const synapse = useSynapseContext();\n  const callbackRef = useRef(callback);\n  callbackRef.current = callback;\n\n  useEffect(() => {\n    return synapse.onAction((action) => callbackRef.current(action));\n  }, [synapse]);\n}\n\nexport function useTheme(): SynapseTheme {\n  const synapse = useSynapseContext();\n  const [theme, setTheme] = useState<SynapseTheme>(() => synapse.getTheme());\n\n  useEffect(() => {\n    // Sync in case theme changed between render and effect\n    setTheme(synapse.getTheme());\n    return synapse.onThemeChanged(setTheme);\n  }, [synapse]);\n\n  return theme;\n}\n\nexport function useAction(): (action: string, params?: Record<string, unknown>) => void {\n  const synapse = useSynapseContext();\n  return useCallback(\n    (action: string, params?: Record<string, unknown>) => synapse.action(action, params),\n    [synapse],\n  );\n}\n\nexport function useChat(): (\n  message: string,\n  context?: { action?: string; entity?: string },\n) => void {\n  const synapse = useSynapseContext();\n  return useCallback(\n    (message: string, context?: { action?: string; entity?: string }) =>\n      synapse.chat(message, context),\n    [synapse],\n  );\n}\n\n/**\n * Push the app's visible state to the agent via ext-apps `ui/update-model-context`.\n *\n * **Imperative** (no args) — returns a push function you call manually:\n * ```tsx\n * const push = useVisibleState();\n * push({ board: selectedBoard }, \"Viewing board X\");\n * ```\n *\n * **Declarative** (factory + deps) — auto-pushes when deps change:\n * ```tsx\n * useVisibleState(() => ({\n *   state: { board: selectedBoard },\n *   summary: `Viewing \"${selectedBoard?.name}\"`,\n * }), [selectedBoard]);\n * ```\n */\nexport function useVisibleState(): (state: Record<string, unknown>, summary?: string) => void;\nexport function useVisibleState(\n  factory: () => { state: Record<string, unknown>; summary?: string },\n  deps: unknown[],\n): void;\nexport function useVisibleState(\n  factory?: () => { state: Record<string, unknown>; summary?: string },\n  deps?: unknown[],\n): ((state: Record<string, unknown>, summary?: string) => void) | undefined {\n  const synapse = useSynapseContext();\n  const push = useCallback(\n    (state: Record<string, unknown>, summary?: string) => synapse.setVisibleState(state, summary),\n    [synapse],\n  );\n\n  // Declarative mode: auto-push when deps change.\n  // The deps array is caller-provided (mirrors useMemo/useEffect pattern).\n  const factoryRef = useRef(factory);\n  factoryRef.current = factory;\n  useEffect(() => {\n    if (!factoryRef.current) return;\n    const { state, summary } = factoryRef.current();\n    push(state, summary);\n  }, [...(deps ?? []), push]);\n\n  if (!factory) return push;\n}\n\nexport function useFileUpload(): {\n  pickFile: (options?: RequestFileOptions) => Promise<FileResult | null>;\n  pickFiles: (options?: RequestFileOptions) => Promise<FileResult[]>;\n  isPending: boolean;\n} {\n  const synapse = useSynapseContext();\n  const [isPending, setIsPending] = useState(false);\n\n  const pickFile = useCallback(\n    async (options?: RequestFileOptions) => {\n      setIsPending(true);\n      try {\n        return await synapse.pickFile(options);\n      } finally {\n        setIsPending(false);\n      }\n    },\n    [synapse],\n  );\n\n  const pickFiles = useCallback(\n    async (options?: RequestFileOptions) => {\n      setIsPending(true);\n      try {\n        return await synapse.pickFiles(options);\n      } finally {\n        setIsPending(false);\n      }\n    },\n    [synapse],\n  );\n\n  return { pickFile, pickFiles, isPending };\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/app-provider.tsx","../../src/react/connect-hooks.ts","../../src/react/provider.tsx","../../src/react/hooks.ts"],"names":["useState","useEffect","createContext","useRef","jsx","useContext","useCallback"],"mappings":"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","file":"index.js","sourcesContent":["import { createContext, type ReactNode, useContext, useEffect, useRef, useState } from \"react\";\nimport { connect } from \"../connect.js\";\nimport type { App, ConnectOptions } from \"../types.js\";\n\nconst AppContext = createContext<App | null>(null);\n\nexport interface AppProviderProps extends ConnectOptions {\n  children: ReactNode;\n}\n\nexport function AppProvider({ children, name, version, autoResize }: AppProviderProps) {\n  const [app, setApp] = useState<App | null>(null);\n  const connectingRef = useRef(false);\n\n  // biome-ignore lint/correctness/useExhaustiveDependencies: connect once on mount\n  useEffect(() => {\n    if (connectingRef.current) return;\n    connectingRef.current = true;\n\n    connect({ name, version, autoResize }).then((a) => {\n      setApp(a);\n    });\n  }, []);\n\n  if (!app) return null; // Don't render children until connected\n\n  return <AppContext.Provider value={app}>{children}</AppContext.Provider>;\n}\n\nexport function useAppContext(): App {\n  const ctx = useContext(AppContext);\n  if (!ctx) {\n    throw new Error(\n      \"useApp must be used within an <AppProvider>. Wrap your component tree with <AppProvider>.\",\n    );\n  }\n  return ctx;\n}\n","import { useCallback, useEffect, useState } from \"react\";\nimport type { App, Theme, ToolResultData } from \"../types.js\";\nimport { AppProvider, useAppContext } from \"./app-provider.js\";\n\nexport { AppProvider };\n\nexport function useApp(): App {\n  return useAppContext();\n}\n\nexport function useToolResult(): ToolResultData | null {\n  const app = useAppContext();\n  const [data, setData] = useState<ToolResultData | null>(null);\n\n  useEffect(() => {\n    return app.on(\"tool-result\", (result: ToolResultData) => {\n      setData(result);\n    });\n  }, [app]);\n\n  return data;\n}\n\nexport function useToolInput(): Record<string, unknown> | null {\n  const app = useAppContext();\n  const [input, setInput] = useState<Record<string, unknown> | null>(null);\n\n  useEffect(() => {\n    return app.on(\"tool-input\", (args: Record<string, unknown>) => {\n      setInput(args);\n    });\n  }, [app]);\n\n  return input;\n}\n\nexport function useConnectTheme(): Theme {\n  const app = useAppContext();\n  const [theme, setTheme] = useState<Theme>(() => app.theme);\n\n  useEffect(() => {\n    setTheme(app.theme); // Sync in case it changed between render and effect\n    return app.on(\"theme-changed\", (t: Theme) => {\n      setTheme(t);\n    });\n  }, [app]);\n\n  return theme;\n}\n\nexport function useResize(): (width?: number, height?: number) => void {\n  const app = useAppContext();\n  return useCallback((width?: number, height?: number) => app.resize(width, height), [app]);\n}\n","import { createContext, type ReactNode, useContext, useEffect, useRef, useState } from \"react\";\nimport { createSynapse } from \"../core.js\";\nimport type { Synapse, SynapseOptions, SynapseTheme } 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 (\n    <SynapseContext.Provider value={ref.current}>\n      <ThemeInjector synapse={ref.current} />\n      {children}\n    </SynapseContext.Provider>\n  );\n}\n\n/** Injects theme CSS variables onto document.documentElement whenever the theme changes. */\nfunction ThemeInjector({ synapse }: { synapse: Synapse }) {\n  const [theme, setTheme] = useState<SynapseTheme>(() => synapse.getTheme());\n\n  useEffect(() => {\n    setTheme(synapse.getTheme());\n    return synapse.onThemeChanged(setTheme);\n  }, [synapse]);\n\n  useEffect(() => {\n    if (theme.tokens) {\n      const style = document.documentElement.style;\n      for (const [k, v] of Object.entries(theme.tokens)) {\n        style.setProperty(k, v);\n      }\n    }\n  }, [theme]);\n\n  return null;\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 type { McpUiHostContext } from \"@modelcontextprotocol/ext-apps\";\nimport { useCallback, useEffect, useRef, useState, useSyncExternalStore } from \"react\";\nimport type {\n  ActionReducer,\n  AgentAction,\n  DataChangedEvent,\n  FileResult,\n  RequestFileOptions,\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\n/**\n * Subscribe to the full ext-apps host context.\n *\n * Returns the host context bag — spec-standardized fields (`theme`, `styles`,\n * `displayMode`, `toolInfo`) plus any host extensions. Re-renders on every\n * `ui/notifications/host-context-changed` notification.\n *\n * Prefer `useTheme()` when only theming matters (it filters no-op fires and\n * returns a typed `SynapseTheme`). Reach for `useHostContext()` for non-theme\n * fields like host-specific extensions, e.g. on NimbleBrain:\n *\n * ```tsx\n * const { workspace } = useHostContext<{ workspace?: { id: string } }>();\n * ```\n */\nexport function useHostContext<T extends McpUiHostContext = McpUiHostContext>(): T {\n  const synapse = useSynapseContext();\n  const [ctx, setCtx] = useState<T>(() => synapse.getHostContext() as T);\n\n  useEffect(() => {\n    // Sync in case context changed between render and effect\n    setCtx(synapse.getHostContext() as T);\n    return synapse.onHostContextChanged((c) => setCtx(c as T));\n  }, [synapse]);\n\n  return ctx;\n}\n\n/**\n * Re-renders only when the derived `SynapseTheme` actually changes (mode,\n * primaryColor, or any token value). Routes through `synapse.onThemeChanged`\n * — which is itself a `themesEqual`-filtered selector over the unified host\n * context — so a host-context update that doesn't move the theme (e.g. a\n * workspace switch) does NOT cause this hook's consumers to re-render.\n *\n * Building this on `useHostContext` instead would skip the filter: every\n * host-context-changed notification produces a new context reference, which\n * would propagate through `useState` and force a re-render even when the\n * derived theme is unchanged.\n */\nexport function useTheme(): SynapseTheme {\n  const synapse = useSynapseContext();\n  const [theme, setTheme] = useState<SynapseTheme>(() => synapse.getTheme());\n\n  useEffect(() => {\n    // Sync in case theme changed between render and effect\n    setTheme(synapse.getTheme());\n    return synapse.onThemeChanged(setTheme);\n  }, [synapse]);\n\n  return theme;\n}\n\nexport function useAction(): (action: string, params?: Record<string, unknown>) => void {\n  const synapse = useSynapseContext();\n  return useCallback(\n    (action: string, params?: Record<string, unknown>) => synapse.action(action, params),\n    [synapse],\n  );\n}\n\nexport function useChat(): (\n  message: string,\n  context?: { action?: string; entity?: string },\n) => void {\n  const synapse = useSynapseContext();\n  return useCallback(\n    (message: string, context?: { action?: string; entity?: string }) =>\n      synapse.chat(message, context),\n    [synapse],\n  );\n}\n\n/**\n * Push the app's visible state to the agent via ext-apps `ui/update-model-context`.\n *\n * **Imperative** (no args) — returns a push function you call manually:\n * ```tsx\n * const push = useVisibleState();\n * push({ board: selectedBoard }, \"Viewing board X\");\n * ```\n *\n * **Declarative** (factory + deps) — auto-pushes when deps change:\n * ```tsx\n * useVisibleState(() => ({\n *   state: { board: selectedBoard },\n *   summary: `Viewing \"${selectedBoard?.name}\"`,\n * }), [selectedBoard]);\n * ```\n */\nexport function useVisibleState(): (state: Record<string, unknown>, summary?: string) => void;\nexport function useVisibleState(\n  factory: () => { state: Record<string, unknown>; summary?: string },\n  deps: unknown[],\n): void;\nexport function useVisibleState(\n  factory?: () => { state: Record<string, unknown>; summary?: string },\n  deps?: unknown[],\n): ((state: Record<string, unknown>, summary?: string) => void) | undefined {\n  const synapse = useSynapseContext();\n  const push = useCallback(\n    (state: Record<string, unknown>, summary?: string) => synapse.setVisibleState(state, summary),\n    [synapse],\n  );\n\n  // Declarative mode: auto-push when deps change.\n  // The deps array is caller-provided (mirrors useMemo/useEffect pattern).\n  const factoryRef = useRef(factory);\n  factoryRef.current = factory;\n  useEffect(() => {\n    if (!factoryRef.current) return;\n    const { state, summary } = factoryRef.current();\n    push(state, summary);\n  }, [...(deps ?? []), push]);\n\n  if (!factory) return push;\n}\n\nexport function useFileUpload(): {\n  pickFile: (options?: RequestFileOptions) => Promise<FileResult | null>;\n  pickFiles: (options?: RequestFileOptions) => Promise<FileResult[]>;\n  isPending: boolean;\n} {\n  const synapse = useSynapseContext();\n  const [isPending, setIsPending] = useState(false);\n\n  const pickFile = useCallback(\n    async (options?: RequestFileOptions) => {\n      setIsPending(true);\n      try {\n        return await synapse.pickFile(options);\n      } finally {\n        setIsPending(false);\n      }\n    },\n    [synapse],\n  );\n\n  const pickFiles = useCallback(\n    async (options?: RequestFileOptions) => {\n      setIsPending(true);\n      try {\n        return await synapse.pickFiles(options);\n      } finally {\n        setIsPending(false);\n      }\n    },\n    [synapse],\n  );\n\n  return { pickFile, pickFiles, isPending };\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"]}