@nimblebrain/synapse 0.19.0 → 0.20.0

package/dist/{detect-DZMJsyvZ.d.cts → detect-DVGaL2bH.d.cts}

@@ -1,26 +1,23 @@
-import { f as FontFaceDescriptor } from './types-CG08aO82.cjs';
-
 /**
  * Cross-host UI client — types and wire constants.
  *
  * The cross-host client (`connectUI`) renders one Synapse-authored component in
- * hosts that each speak a different bridge: ChatGPT (OpenAI Apps SDK), Claude
- * (mcp-ui), and plain/standalone. Apps code against `synapse.*` and never touch
- * a host protocol. This is a **push-first** surface: the tool output that spawned
+ * any MCP Apps host (ChatGPT, Claude, NimbleBrain) and standalone. Apps code
+ * against `synapse.*` and never touch the bridge. This is a **push-first** surface: the tool output that spawned
  * the widget is delivered at render (`data()` / `onData()`); `callTool()` is the
  * pull escape hatch, advertised per host via `capabilities()`.
  *
  * This layer intentionally has ZERO dependency on `@modelcontextprotocol/*` — the
- * ChatGPT / mcp-ui / inline bridges are pure `window.openai` + `postMessage`, so
- * the IIFE that apps inline stays tiny (no Zod, no ext-apps schemas).
+ * bridge is JSON-RPC over `postMessage`, spoken by hand, so the IIFE that apps
+ * inline stays tiny (no Zod, no ext-apps schemas).
  */
 /**
- * The host the client resolved to, as reported by `synapse.host()`. An escape
- * hatch — apps should rarely branch on it; `capabilities()` is the supported way
- * to feature-detect. `"nimblebrain"` is reserved for the runtime adapter (P3).
+ * The bridge the client resolved to, as reported by `synapse.host()`:
+ * `"mcp-apps"` in a frame, `"generic"` standalone. It names the bridge, not the
+ * product — every framing host speaks the same one. Apps should rarely branch on
+ * it; `capabilities()` is the supported way to feature-detect.
  */
-
-type HostKind = "chatgpt" | "claude" | "nimblebrain" | "generic";
+type HostKind = "mcp-apps" | "generic";
 /** Resolved theme. `mode` always resolves to light or dark. `tokens` are CSS
  *  custom properties the host publishes — the MCP Apps adapter reads them from
  *  `hostContext.styles.variables`; where a host sends none they stay empty and the
@@ -28,9 +25,6 @@ type HostKind = "chatgpt" | "claude" | "nimblebrain" | "generic";
 interface SynapseUITheme {
     mode: "light" | "dark";
     tokens: Record<string, string>;
-    /** Font faces the host wants loaded. Absent where the host sends none, which
-     *  leaves the SDK's web-safe fallbacks in force. See `FontFaceDescriptor`. */
-    fontFaces?: FontFaceDescriptor[];
 }
 /** What the active host actually supports. `data()`/`onData()`/`theme()`/
  *  `resize()` work everywhere; these three vary. */
@@ -46,6 +40,18 @@ interface HostCapabilities {
 declare class HostUnsupportedError extends Error {
     constructor(feature: string, host: HostKind);
 }
+/**
+ * Thrown by `callTool()` when the tool result says the call failed
+ * (`isError: true`). MCP reports a tool failure inside the result rather than as
+ * a JSON-RPC error, and a host reports a refusal the same way — ChatGPT answers a
+ * call to a tool the app may not see with an `isError` result — so without this a
+ * failure would resolve as if it were data. The message is the result's first
+ * text block; the whole result is on `result`.
+ */
+declare class ToolCallError extends Error {
+    readonly result: unknown;
+    constructor(name: string, result: unknown);
+}
 interface ConnectUIOptions {
     /** App name — informational; forwarded to hosts that accept an appInfo. */
     name?: string;
@@ -54,18 +60,17 @@ interface ConnectUIOptions {
     /**
      * Force a host adapter instead of auto-detecting. Used by preview harnesses,
      * SSR, and tests; production apps omit it and let the SDK feature-detect.
-     * `"claude"` → MCP Apps standard adapter, `"chatgpt"` → OpenAI Apps adapter,
-     * `"generic"` → inline adapter.
+     * `"mcp-apps"` → MCP Apps standard adapter, `"generic"` → inline adapter.
      */
     host?: HostKind;
     /**
      * `id` of the `<script type="application/json">` element carrying pushed data
-     * baked into the HTML (the mcp-ui / SSR path). Defaults to
+     * baked into the HTML (the SSR / standalone path). Defaults to
      * {@link SYNAPSE_DATA_ELEMENT_ID}.
      */
     dataElementId?: string;
     /**
-     * Auto-report content height to the host on layout changes (mcp-ui only).
+     * Auto-report content height to the host on layout changes (MCP Apps only).
      * Defaults to `true`. Set `false` to size manually via `resize()`.
      */
     autoResize?: boolean;
@@ -92,8 +97,10 @@ interface SynapseUIClient {
     /** Subscribe to theme changes. The client already applies the theme to the DOM
      *  (`data-theme` attribute + CSS variables) before this fires. */
     onTheme(cb: (theme: SynapseUITheme) => void): () => void;
-    /** Widget→server tool call. Rejects with {@link HostUnsupportedError} where the
-     *  host advertises no pull (`capabilities().pull === false`). */
+    /** Widget→server tool call. Resolves with the tool result. Rejects with
+     *  {@link ToolCallError} when the result reports failure (`isError: true`), and
+     *  with {@link HostUnsupportedError} where the host advertises no pull
+     *  (`capabilities().pull === false`). */
     callTool<O = unknown>(name: string, args?: Record<string, unknown>): Promise<O>;
     /** Send a follow-up message to the agent conversation. No-op where unsupported. */
     sendPrompt(text: string): void;
@@ -132,9 +139,9 @@ interface HostAdapter {
 declare const SYNAPSE_DATA_ELEMENT_ID = "synapse-ui-data";
 
 /**
- * Connect a Synapse-authored component to whatever host it renders in — ChatGPT
- * (OpenAI Apps SDK), Claude (MCP Apps standard), or a plain/standalone page — behind one
- * push-first API. Feature-detects the host, selects an adapter, and applies the
+ * Connect a Synapse-authored component to whatever host it renders in — any MCP
+ * Apps host, or a plain/standalone page — behind one push-first API. Detects
+ * whether it is framed, selects an adapter, and applies the
  * host theme to the DOM before returning.
  *
  * Synchronous: `data()` is populated from baked-in data (where present) on
@@ -153,20 +160,19 @@ declare function connectUI(options?: ConnectUIOptions): SynapseUIClient;
  * unit-testable with a plain object — no full `Window` fake required.
  */
 interface DetectableWindow {
-    openai?: unknown;
     parent?: unknown;
-    self?: unknown;
 }
 /**
- * Feature-detect the host from the browsing context.
+ * Detect the bridge from the browsing context.
  *
- *  - `window.openai` present → **chatgpt** (OpenAI Apps SDK).
- *  - otherwise, a nested browsing context (`parent !== self`, or a cross-origin
- *    access that throws) → **claude** (MCP Apps standard postMessage host).
+ *  - a nested browsing context (`parent !== self`, or a cross-origin access that
+ *    throws) → **mcp-apps**: every host that frames a component speaks the MCP
+ *    Apps standard.
  *  - top-level document → **generic** (inline / standalone).
  *
- * Returns the host *kind*; `chooseAdapter` maps it to a concrete adapter and
- * honors an explicit `options.host` override for previews/SSR/tests.
+ * Nothing on the window names the host. `window.openai` in particular does not:
+ * ChatGPT injects it into every frame it serves, whatever the component is.
+ * Which host answered is in the handshake, not here.
  */
 declare function detectHostKind(win: DetectableWindow): HostKind;
 /** Build the adapter for an explicit host kind (`options.host` or a detected one). */
@@ -174,4 +180,4 @@ declare function adapterForKind(kind: HostKind, win: Window & typeof globalThis,
 /** Select and construct the host adapter, honoring `options.host` when set. */
 declare function selectAdapter(win: Window & typeof globalThis, options: ConnectUIOptions): HostAdapter;
 
-export { type ConnectUIOptions as C, type HostAdapter as H, type SynapseUITheme as S, type HostCapabilities as a, type HostKind as b, HostUnsupportedError as c, SYNAPSE_DATA_ELEMENT_ID as d, type SynapseUIClient as e, adapterForKind as f, connectUI as g, detectHostKind as h, selectAdapter as s };
+export { type ConnectUIOptions as C, type HostAdapter as H, type SynapseUITheme as S, ToolCallError as T, type HostCapabilities as a, type HostKind as b, HostUnsupportedError as c, SYNAPSE_DATA_ELEMENT_ID as d, type SynapseUIClient as e, adapterForKind as f, connectUI as g, detectHostKind as h, selectAdapter as s };

package/dist/{detect-DBwc8a21.d.ts → detect-DVGaL2bH.d.ts}

@@ -1,26 +1,23 @@
-import { f as FontFaceDescriptor } from './types-CG08aO82.js';
-
 /**
  * Cross-host UI client — types and wire constants.
  *
  * The cross-host client (`connectUI`) renders one Synapse-authored component in
- * hosts that each speak a different bridge: ChatGPT (OpenAI Apps SDK), Claude
- * (mcp-ui), and plain/standalone. Apps code against `synapse.*` and never touch
- * a host protocol. This is a **push-first** surface: the tool output that spawned
+ * any MCP Apps host (ChatGPT, Claude, NimbleBrain) and standalone. Apps code
+ * against `synapse.*` and never touch the bridge. This is a **push-first** surface: the tool output that spawned
  * the widget is delivered at render (`data()` / `onData()`); `callTool()` is the
  * pull escape hatch, advertised per host via `capabilities()`.
  *
  * This layer intentionally has ZERO dependency on `@modelcontextprotocol/*` — the
- * ChatGPT / mcp-ui / inline bridges are pure `window.openai` + `postMessage`, so
- * the IIFE that apps inline stays tiny (no Zod, no ext-apps schemas).
+ * bridge is JSON-RPC over `postMessage`, spoken by hand, so the IIFE that apps
+ * inline stays tiny (no Zod, no ext-apps schemas).
  */
 /**
- * The host the client resolved to, as reported by `synapse.host()`. An escape
- * hatch — apps should rarely branch on it; `capabilities()` is the supported way
- * to feature-detect. `"nimblebrain"` is reserved for the runtime adapter (P3).
+ * The bridge the client resolved to, as reported by `synapse.host()`:
+ * `"mcp-apps"` in a frame, `"generic"` standalone. It names the bridge, not the
+ * product — every framing host speaks the same one. Apps should rarely branch on
+ * it; `capabilities()` is the supported way to feature-detect.
  */
-
-type HostKind = "chatgpt" | "claude" | "nimblebrain" | "generic";
+type HostKind = "mcp-apps" | "generic";
 /** Resolved theme. `mode` always resolves to light or dark. `tokens` are CSS
  *  custom properties the host publishes — the MCP Apps adapter reads them from
  *  `hostContext.styles.variables`; where a host sends none they stay empty and the
@@ -28,9 +25,6 @@ type HostKind = "chatgpt" | "claude" | "nimblebrain" | "generic";
 interface SynapseUITheme {
     mode: "light" | "dark";
     tokens: Record<string, string>;
-    /** Font faces the host wants loaded. Absent where the host sends none, which
-     *  leaves the SDK's web-safe fallbacks in force. See `FontFaceDescriptor`. */
-    fontFaces?: FontFaceDescriptor[];
 }
 /** What the active host actually supports. `data()`/`onData()`/`theme()`/
  *  `resize()` work everywhere; these three vary. */
@@ -46,6 +40,18 @@ interface HostCapabilities {
 declare class HostUnsupportedError extends Error {
     constructor(feature: string, host: HostKind);
 }
+/**
+ * Thrown by `callTool()` when the tool result says the call failed
+ * (`isError: true`). MCP reports a tool failure inside the result rather than as
+ * a JSON-RPC error, and a host reports a refusal the same way — ChatGPT answers a
+ * call to a tool the app may not see with an `isError` result — so without this a
+ * failure would resolve as if it were data. The message is the result's first
+ * text block; the whole result is on `result`.
+ */
+declare class ToolCallError extends Error {
+    readonly result: unknown;
+    constructor(name: string, result: unknown);
+}
 interface ConnectUIOptions {
     /** App name — informational; forwarded to hosts that accept an appInfo. */
     name?: string;
@@ -54,18 +60,17 @@ interface ConnectUIOptions {
     /**
      * Force a host adapter instead of auto-detecting. Used by preview harnesses,
      * SSR, and tests; production apps omit it and let the SDK feature-detect.
-     * `"claude"` → MCP Apps standard adapter, `"chatgpt"` → OpenAI Apps adapter,
-     * `"generic"` → inline adapter.
+     * `"mcp-apps"` → MCP Apps standard adapter, `"generic"` → inline adapter.
      */
     host?: HostKind;
     /**
      * `id` of the `<script type="application/json">` element carrying pushed data
-     * baked into the HTML (the mcp-ui / SSR path). Defaults to
+     * baked into the HTML (the SSR / standalone path). Defaults to
      * {@link SYNAPSE_DATA_ELEMENT_ID}.
      */
     dataElementId?: string;
     /**
-     * Auto-report content height to the host on layout changes (mcp-ui only).
+     * Auto-report content height to the host on layout changes (MCP Apps only).
      * Defaults to `true`. Set `false` to size manually via `resize()`.
      */
     autoResize?: boolean;
@@ -92,8 +97,10 @@ interface SynapseUIClient {
     /** Subscribe to theme changes. The client already applies the theme to the DOM
      *  (`data-theme` attribute + CSS variables) before this fires. */
     onTheme(cb: (theme: SynapseUITheme) => void): () => void;
-    /** Widget→server tool call. Rejects with {@link HostUnsupportedError} where the
-     *  host advertises no pull (`capabilities().pull === false`). */
+    /** Widget→server tool call. Resolves with the tool result. Rejects with
+     *  {@link ToolCallError} when the result reports failure (`isError: true`), and
+     *  with {@link HostUnsupportedError} where the host advertises no pull
+     *  (`capabilities().pull === false`). */
     callTool<O = unknown>(name: string, args?: Record<string, unknown>): Promise<O>;
     /** Send a follow-up message to the agent conversation. No-op where unsupported. */
     sendPrompt(text: string): void;
@@ -132,9 +139,9 @@ interface HostAdapter {
 declare const SYNAPSE_DATA_ELEMENT_ID = "synapse-ui-data";
 
 /**
- * Connect a Synapse-authored component to whatever host it renders in — ChatGPT
- * (OpenAI Apps SDK), Claude (MCP Apps standard), or a plain/standalone page — behind one
- * push-first API. Feature-detects the host, selects an adapter, and applies the
+ * Connect a Synapse-authored component to whatever host it renders in — any MCP
+ * Apps host, or a plain/standalone page — behind one push-first API. Detects
+ * whether it is framed, selects an adapter, and applies the
  * host theme to the DOM before returning.
  *
  * Synchronous: `data()` is populated from baked-in data (where present) on
@@ -153,20 +160,19 @@ declare function connectUI(options?: ConnectUIOptions): SynapseUIClient;
  * unit-testable with a plain object — no full `Window` fake required.
  */
 interface DetectableWindow {
-    openai?: unknown;
     parent?: unknown;
-    self?: unknown;
 }
 /**
- * Feature-detect the host from the browsing context.
+ * Detect the bridge from the browsing context.
  *
- *  - `window.openai` present → **chatgpt** (OpenAI Apps SDK).
- *  - otherwise, a nested browsing context (`parent !== self`, or a cross-origin
- *    access that throws) → **claude** (MCP Apps standard postMessage host).
+ *  - a nested browsing context (`parent !== self`, or a cross-origin access that
+ *    throws) → **mcp-apps**: every host that frames a component speaks the MCP
+ *    Apps standard.
  *  - top-level document → **generic** (inline / standalone).
  *
- * Returns the host *kind*; `chooseAdapter` maps it to a concrete adapter and
- * honors an explicit `options.host` override for previews/SSR/tests.
+ * Nothing on the window names the host. `window.openai` in particular does not:
+ * ChatGPT injects it into every frame it serves, whatever the component is.
+ * Which host answered is in the handshake, not here.
  */
 declare function detectHostKind(win: DetectableWindow): HostKind;
 /** Build the adapter for an explicit host kind (`options.host` or a detected one). */
@@ -174,4 +180,4 @@ declare function adapterForKind(kind: HostKind, win: Window & typeof globalThis,
 /** Select and construct the host adapter, honoring `options.host` when set. */
 declare function selectAdapter(win: Window & typeof globalThis, options: ConnectUIOptions): HostAdapter;
 
-export { type ConnectUIOptions as C, type HostAdapter as H, type SynapseUITheme as S, type HostCapabilities as a, type HostKind as b, HostUnsupportedError as c, SYNAPSE_DATA_ELEMENT_ID as d, type SynapseUIClient as e, adapterForKind as f, connectUI as g, detectHostKind as h, selectAdapter as s };
+export { type ConnectUIOptions as C, type HostAdapter as H, type SynapseUITheme as S, ToolCallError as T, type HostCapabilities as a, type HostKind as b, HostUnsupportedError as c, SYNAPSE_DATA_ELEMENT_ID as d, type SynapseUIClient as e, adapterForKind as f, connectUI as g, detectHostKind as h, selectAdapter as s };

package/dist/host/index.cjs

@@ -1,58 +1,57 @@
 'use strict';
 
-var chunkRU64F5RS_cjs = require('../chunk-RU64F5RS.cjs');
-require('../chunk-SZWHFTXV.cjs');
-require('../chunk-Q7SFCCGT.cjs');
+var chunkBNF352SA_cjs = require('../chunk-BNF352SA.cjs');
+require('../chunk-YSL7KJNU.cjs');
 
 
 
 Object.defineProperty(exports, "HostUnsupportedError", {
   enumerable: true,
-  get: function () { return chunkRU64F5RS_cjs.HostUnsupportedError; }
+  get: function () { return chunkBNF352SA_cjs.HostUnsupportedError; }
 });
 Object.defineProperty(exports, "SYNAPSE_DATA_ELEMENT_ID", {
   enumerable: true,
-  get: function () { return chunkRU64F5RS_cjs.SYNAPSE_DATA_ELEMENT_ID; }
+  get: function () { return chunkBNF352SA_cjs.SYNAPSE_DATA_ELEMENT_ID; }
+});
+Object.defineProperty(exports, "ToolCallError", {
+  enumerable: true,
+  get: function () { return chunkBNF352SA_cjs.ToolCallError; }
 });
 Object.defineProperty(exports, "adapterForKind", {
   enumerable: true,
-  get: function () { return chunkRU64F5RS_cjs.adapterForKind; }
+  get: function () { return chunkBNF352SA_cjs.adapterForKind; }
 });
 Object.defineProperty(exports, "applyHostTheme", {
   enumerable: true,
-  get: function () { return chunkRU64F5RS_cjs.applyHostTheme; }
+  get: function () { return chunkBNF352SA_cjs.applyHostTheme; }
 });
 Object.defineProperty(exports, "coerceMode", {
   enumerable: true,
-  get: function () { return chunkRU64F5RS_cjs.coerceMode; }
+  get: function () { return chunkBNF352SA_cjs.coerceMode; }
 });
 Object.defineProperty(exports, "connectUI", {
   enumerable: true,
-  get: function () { return chunkRU64F5RS_cjs.connectUI; }
-});
-Object.defineProperty(exports, "createChatGPTAdapter", {
-  enumerable: true,
-  get: function () { return chunkRU64F5RS_cjs.createChatGPTAdapter; }
+  get: function () { return chunkBNF352SA_cjs.connectUI; }
 });
 Object.defineProperty(exports, "createInlineAdapter", {
   enumerable: true,
-  get: function () { return chunkRU64F5RS_cjs.createInlineAdapter; }
+  get: function () { return chunkBNF352SA_cjs.createInlineAdapter; }
 });
 Object.defineProperty(exports, "createMcpAppsAdapter", {
   enumerable: true,
-  get: function () { return chunkRU64F5RS_cjs.createMcpAppsAdapter; }
+  get: function () { return chunkBNF352SA_cjs.createMcpAppsAdapter; }
 });
 Object.defineProperty(exports, "detectHostKind", {
   enumerable: true,
-  get: function () { return chunkRU64F5RS_cjs.detectHostKind; }
+  get: function () { return chunkBNF352SA_cjs.detectHostKind; }
 });
 Object.defineProperty(exports, "preferredMode", {
   enumerable: true,
-  get: function () { return chunkRU64F5RS_cjs.preferredMode; }
+  get: function () { return chunkBNF352SA_cjs.preferredMode; }
 });
 Object.defineProperty(exports, "selectAdapter", {
   enumerable: true,
-  get: function () { return chunkRU64F5RS_cjs.selectAdapter; }
+  get: function () { return chunkBNF352SA_cjs.selectAdapter; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/host/index.d.cts

@@ -1,18 +1,5 @@
-import { C as ConnectUIOptions, H as HostAdapter, S as SynapseUITheme } from '../detect-DZMJsyvZ.cjs';
-export { a as HostCapabilities, b as HostKind, c as HostUnsupportedError, d as SYNAPSE_DATA_ELEMENT_ID, e as SynapseUIClient, f as adapterForKind, g as connectUI, h as detectHostKind, s as selectAdapter } from '../detect-DZMJsyvZ.cjs';
-import '../types-CG08aO82.cjs';
-import '@modelcontextprotocol/ext-apps';
-import '@modelcontextprotocol/sdk/types.js';
-
-/**
- * ChatGPT (OpenAI Apps SDK) adapter.
- *
- * Data arrives on `window.openai.toolOutput` (available synchronously before the
- * widget script runs) and updates via the `openai:set_globals` event. Theme is a
- * mode string on the same surface. The host auto-sizes the iframe, so `resize()`
- * is a no-op. `callTool` is available when the host exposes `window.openai.callTool`.
- */
-declare function createChatGPTAdapter(win: Window & typeof globalThis, _options: ConnectUIOptions): HostAdapter;
+import { C as ConnectUIOptions, H as HostAdapter, S as SynapseUITheme } from '../detect-DVGaL2bH.cjs';
+export { a as HostCapabilities, b as HostKind, c as HostUnsupportedError, d as SYNAPSE_DATA_ELEMENT_ID, e as SynapseUIClient, T as ToolCallError, f as adapterForKind, g as connectUI, h as detectHostKind, s as selectAdapter } from '../detect-DVGaL2bH.cjs';
 
 /**
  * Inline / standalone fallback adapter.
@@ -26,8 +13,8 @@ declare function createChatGPTAdapter(win: Window & typeof globalThis, _options:
 declare function createInlineAdapter(win: Window & typeof globalThis, options: ConnectUIOptions): HostAdapter;
 
 /**
- * MCP Apps standard (SEP-1865) adapter — the convergence bridge for Claude
- * Desktop and other MCP Apps hosts.
+ * MCP Apps standard (SEP-1865) adapter — the bridge for every framed host.
+ * ChatGPT, Claude and NimbleBrain all implement the standard, so there is one.
  *
  * The View iframe is an MCP client speaking JSON-RPC 2.0 to `window.parent`:
  *
@@ -39,9 +26,7 @@ declare function createInlineAdapter(win: Window & typeof globalThis, options: C
  *     `ui/notifications/host-context-changed`.
  *
  * Actions go up as requests: `ui/open-link`, `ui/message` (follow-up), and
- * `tools/call` (pull). The legacy mcp-ui `ui-lifecycle-*` messages are sent and
- * accepted alongside so a pre-standard host still renders — a standard host drops
- * the non-JSON-RPC frames, and a legacy host ignores the JSON-RPC ones.
+ * `tools/call` (pull).
  */
 declare function createMcpAppsAdapter(win: Window & typeof globalThis, options: ConnectUIOptions): HostAdapter;
 
@@ -57,19 +42,18 @@ declare function createMcpAppsAdapter(win: Window & typeof globalThis, options:
  *    `@nimblebrain/synapse/ui` token components consume theme, backed by the
  *    SDK's neutral defaults so every referenced var resolves in both modes.
  *
- * Setting both means an app can use either convention (or a host that supplies
- * only a mode string, like the OpenAI Apps SDK, still themes correctly). SSR-safe.
+ * Setting both means an app can use either convention (and a host that supplies
+ * only a mode string still themes correctly). SSR-safe.
  *
- * Any `fontFaces` the host supplies are loaded here too — a token can name a
- * family but not load it, so the two travel together. A host that sends none
- * leaves the web-safe fallbacks in force.
+ * Fonts travel separately, as the host's `@font-face` CSS: see
+ * {@link injectHostFonts}.
  */
 declare function applyHostTheme(theme: SynapseUITheme): void;
 /** Read the OS-level color scheme as a sane default for hosts that don't push a
- *  theme until later (mcp-ui) or ever (standalone). */
+ *  theme until the handshake completes, or ever (standalone). */
 declare function preferredMode(win: Window | undefined): "light" | "dark";
 /** Coerce an arbitrary host-supplied theme signal to a mode. Accepts the string
  *  form (`"dark"`) both hosts use; anything else falls back. */
 declare function coerceMode(value: unknown, fallback: "light" | "dark"): "light" | "dark";
 
-export { ConnectUIOptions, HostAdapter, SynapseUITheme, applyHostTheme, coerceMode, createChatGPTAdapter, createInlineAdapter, createMcpAppsAdapter, preferredMode };
+export { ConnectUIOptions, HostAdapter, SynapseUITheme, applyHostTheme, coerceMode, createInlineAdapter, createMcpAppsAdapter, preferredMode };

package/dist/host/index.d.ts

@@ -1,18 +1,5 @@
-import { C as ConnectUIOptions, H as HostAdapter, S as SynapseUITheme } from '../detect-DBwc8a21.js';
-export { a as HostCapabilities, b as HostKind, c as HostUnsupportedError, d as SYNAPSE_DATA_ELEMENT_ID, e as SynapseUIClient, f as adapterForKind, g as connectUI, h as detectHostKind, s as selectAdapter } from '../detect-DBwc8a21.js';
-import '../types-CG08aO82.js';
-import '@modelcontextprotocol/ext-apps';
-import '@modelcontextprotocol/sdk/types.js';
-
-/**
- * ChatGPT (OpenAI Apps SDK) adapter.
- *
- * Data arrives on `window.openai.toolOutput` (available synchronously before the
- * widget script runs) and updates via the `openai:set_globals` event. Theme is a
- * mode string on the same surface. The host auto-sizes the iframe, so `resize()`
- * is a no-op. `callTool` is available when the host exposes `window.openai.callTool`.
- */
-declare function createChatGPTAdapter(win: Window & typeof globalThis, _options: ConnectUIOptions): HostAdapter;
+import { C as ConnectUIOptions, H as HostAdapter, S as SynapseUITheme } from '../detect-DVGaL2bH.js';
+export { a as HostCapabilities, b as HostKind, c as HostUnsupportedError, d as SYNAPSE_DATA_ELEMENT_ID, e as SynapseUIClient, T as ToolCallError, f as adapterForKind, g as connectUI, h as detectHostKind, s as selectAdapter } from '../detect-DVGaL2bH.js';
 
 /**
  * Inline / standalone fallback adapter.
@@ -26,8 +13,8 @@ declare function createChatGPTAdapter(win: Window & typeof globalThis, _options:
 declare function createInlineAdapter(win: Window & typeof globalThis, options: ConnectUIOptions): HostAdapter;
 
 /**
- * MCP Apps standard (SEP-1865) adapter — the convergence bridge for Claude
- * Desktop and other MCP Apps hosts.
+ * MCP Apps standard (SEP-1865) adapter — the bridge for every framed host.
+ * ChatGPT, Claude and NimbleBrain all implement the standard, so there is one.
  *
  * The View iframe is an MCP client speaking JSON-RPC 2.0 to `window.parent`:
  *
@@ -39,9 +26,7 @@ declare function createInlineAdapter(win: Window & typeof globalThis, options: C
  *     `ui/notifications/host-context-changed`.
  *
  * Actions go up as requests: `ui/open-link`, `ui/message` (follow-up), and
- * `tools/call` (pull). The legacy mcp-ui `ui-lifecycle-*` messages are sent and
- * accepted alongside so a pre-standard host still renders — a standard host drops
- * the non-JSON-RPC frames, and a legacy host ignores the JSON-RPC ones.
+ * `tools/call` (pull).
  */
 declare function createMcpAppsAdapter(win: Window & typeof globalThis, options: ConnectUIOptions): HostAdapter;
 
@@ -57,19 +42,18 @@ declare function createMcpAppsAdapter(win: Window & typeof globalThis, options:
  *    `@nimblebrain/synapse/ui` token components consume theme, backed by the
  *    SDK's neutral defaults so every referenced var resolves in both modes.
  *
- * Setting both means an app can use either convention (or a host that supplies
- * only a mode string, like the OpenAI Apps SDK, still themes correctly). SSR-safe.
+ * Setting both means an app can use either convention (and a host that supplies
+ * only a mode string still themes correctly). SSR-safe.
  *
- * Any `fontFaces` the host supplies are loaded here too — a token can name a
- * family but not load it, so the two travel together. A host that sends none
- * leaves the web-safe fallbacks in force.
+ * Fonts travel separately, as the host's `@font-face` CSS: see
+ * {@link injectHostFonts}.
  */
 declare function applyHostTheme(theme: SynapseUITheme): void;
 /** Read the OS-level color scheme as a sane default for hosts that don't push a
- *  theme until later (mcp-ui) or ever (standalone). */
+ *  theme until the handshake completes, or ever (standalone). */
 declare function preferredMode(win: Window | undefined): "light" | "dark";
 /** Coerce an arbitrary host-supplied theme signal to a mode. Accepts the string
  *  form (`"dark"`) both hosts use; anything else falls back. */
 declare function coerceMode(value: unknown, fallback: "light" | "dark"): "light" | "dark";
 
-export { ConnectUIOptions, HostAdapter, SynapseUITheme, applyHostTheme, coerceMode, createChatGPTAdapter, createInlineAdapter, createMcpAppsAdapter, preferredMode };
+export { ConnectUIOptions, HostAdapter, SynapseUITheme, applyHostTheme, coerceMode, createInlineAdapter, createMcpAppsAdapter, preferredMode };

package/dist/host/index.js

@@ -1,5 +1,4 @@
-export { HostUnsupportedError, SYNAPSE_DATA_ELEMENT_ID, adapterForKind, applyHostTheme, coerceMode, connectUI, createChatGPTAdapter, createInlineAdapter, createMcpAppsAdapter, detectHostKind, preferredMode, selectAdapter } from '../chunk-OYLZ5OCK.js';
-import '../chunk-DRLVEHCD.js';
-import '../chunk-PZ5AY32C.js';
+export { HostUnsupportedError, SYNAPSE_DATA_ELEMENT_ID, ToolCallError, adapterForKind, applyHostTheme, coerceMode, connectUI, createInlineAdapter, createMcpAppsAdapter, detectHostKind, preferredMode, selectAdapter } from '../chunk-UKP4W6DI.js';
+import '../chunk-DJS2FKBN.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.cjs

@@ -1,18 +1,17 @@
 'use strict';
 
-var chunkRU64F5RS_cjs = require('./chunk-RU64F5RS.cjs');
-var chunkQXDCA7QW_cjs = require('./chunk-QXDCA7QW.cjs');
-var chunkSZWHFTXV_cjs = require('./chunk-SZWHFTXV.cjs');
-require('./chunk-NP7ROSH2.cjs');
-require('./chunk-Q7SFCCGT.cjs');
+var chunkBNF352SA_cjs = require('./chunk-BNF352SA.cjs');
+var chunkHQLSVUOR_cjs = require('./chunk-HQLSVUOR.cjs');
+require('./chunk-YSL7KJNU.cjs');
+var chunkISV6HFQE_cjs = require('./chunk-ISV6HFQE.cjs');
 var extApps = require('@modelcontextprotocol/ext-apps');
 
 var BASE64_CHUNK = 32768;
 async function downloadFile(app, filename, content, mimeType) {
-  const internals = chunkQXDCA7QW_cjs.internalsFor(app);
-  if (internals.hostDownloadFileCapability === void 0) {
-    throw new Error("downloadFile is not supported in this host");
+  if (!app.hostCapabilities.downloadFile) {
+    throw new chunkHQLSVUOR_cjs.HostCapabilityError("downloadFile", "downloadFile");
   }
+  const internals = chunkHQLSVUOR_cjs.internalsFor(app);
   const resolvedMime = mimeType || (content instanceof Blob ? content.type : "") || "application/octet-stream";
   const uri = `file:///${filename}`;
   const resource = typeof content === "string" ? { uri, mimeType: resolvedMime, text: content } : { uri, mimeType: resolvedMime, blob: await toBase64(content) };
@@ -35,43 +34,55 @@ async function toBase64(blob) {
 
 Object.defineProperty(exports, "HostUnsupportedError", {
   enumerable: true,
-  get: function () { return chunkRU64F5RS_cjs.HostUnsupportedError; }
+  get: function () { return chunkBNF352SA_cjs.HostUnsupportedError; }
 });
 Object.defineProperty(exports, "SYNAPSE_DATA_ELEMENT_ID", {
   enumerable: true,
-  get: function () { return chunkRU64F5RS_cjs.SYNAPSE_DATA_ELEMENT_ID; }
+  get: function () { return chunkBNF352SA_cjs.SYNAPSE_DATA_ELEMENT_ID; }
+});
+Object.defineProperty(exports, "ToolCallError", {
+  enumerable: true,
+  get: function () { return chunkBNF352SA_cjs.ToolCallError; }
 });
 Object.defineProperty(exports, "connectUI", {
   enumerable: true,
-  get: function () { return chunkRU64F5RS_cjs.connectUI; }
+  get: function () { return chunkBNF352SA_cjs.connectUI; }
 });
 Object.defineProperty(exports, "detectHostKind", {
   enumerable: true,
-  get: function () { return chunkRU64F5RS_cjs.detectHostKind; }
+  get: function () { return chunkBNF352SA_cjs.detectHostKind; }
+});
+Object.defineProperty(exports, "HostCapabilityError", {
+  enumerable: true,
+  get: function () { return chunkHQLSVUOR_cjs.HostCapabilityError; }
 });
 Object.defineProperty(exports, "action", {
   enumerable: true,
-  get: function () { return chunkQXDCA7QW_cjs.action; }
+  get: function () { return chunkHQLSVUOR_cjs.action; }
 });
 Object.defineProperty(exports, "callToolAsTask", {
   enumerable: true,
-  get: function () { return chunkQXDCA7QW_cjs.callToolAsTask; }
+  get: function () { return chunkHQLSVUOR_cjs.callToolAsTask; }
 });
 Object.defineProperty(exports, "connect", {
   enumerable: true,
-  get: function () { return chunkQXDCA7QW_cjs.connect; }
+  get: function () { return chunkHQLSVUOR_cjs.connect; }
+});
+Object.defineProperty(exports, "hostSupports", {
+  enumerable: true,
+  get: function () { return chunkHQLSVUOR_cjs.hostSupports; }
 });
 Object.defineProperty(exports, "pickFile", {
   enumerable: true,
-  get: function () { return chunkQXDCA7QW_cjs.pickFile; }
+  get: function () { return chunkHQLSVUOR_cjs.pickFile; }
 });
 Object.defineProperty(exports, "pickFiles", {
   enumerable: true,
-  get: function () { return chunkQXDCA7QW_cjs.pickFiles; }
+  get: function () { return chunkHQLSVUOR_cjs.pickFiles; }
 });
-Object.defineProperty(exports, "FONT_FACES_CONTEXT_KEY", {
+Object.defineProperty(exports, "NIMBLEBRAIN_EXTENSIONS", {
   enumerable: true,
-  get: function () { return chunkSZWHFTXV_cjs.FONT_FACES_CONTEXT_KEY; }
+  get: function () { return chunkISV6HFQE_cjs.NIMBLEBRAIN_EXTENSIONS; }
 });
 exports.downloadFile = downloadFile;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/download-file.ts"],"names":["internalsFor","DOWNLOAD_FILE_METHOD"],"mappings":";;;;;;;;;AAqBA,IAAM,YAAA,GAAe,KAAA;AAqBrB,eAAsB,YAAA,CACpB,GAAA,EACA,QAAA,EACA,OAAA,EACA,QAAA,EACkC;AAClC,EAAA,MAAM,SAAA,GAAYA,+BAAa,GAAG,CAAA;AAClC,EAAA,IAAI,SAAA,CAAU,+BAA+B,MAAA,EAAW;AACtD,IAAA,MAAM,IAAI,MAAM,4CAA4C,CAAA;AAAA,EAC9D;AACA,EAAA,MAAM,eACJ,QAAA,KAAa,OAAA,YAAmB,IAAA,GAAO,OAAA,CAAQ,OAAO,EAAA,CAAA,IAAO,0BAAA;AAC/D,EAAA,MAAM,GAAA,GAAM,WAAW,QAAQ,CAAA,CAAA;AAC/B,EAAA,MAAM,WACJ,OAAO,OAAA,KAAY,WACf,EAAE,GAAA,EAAK,UAAU,YAAA,EAAc,IAAA,EAAM,SAAQ,GAC7C,EAAE,KAAK,QAAA,EAAU,YAAA,EAAc,MAAM,MAAM,QAAA,CAAS,OAAO,CAAA,EAAE;AACnE,EAAA,MAAM,MAAA,GAA6C;AAAA,IACjD,UAAU,CAAC,EAAE,IAAA,EAAM,UAAA,EAAY,UAAU;AAAA,GAC3C;AACA,EAAA,OAAQ,MAAM,SAAA,CAAU,OAAA;AAAA,IACtBC,4BAAA;AAAA,IACA;AAAA,GACF;AACF;AAEA,eAAe,SAAS,IAAA,EAA6B;AACnD,EAAA,MAAM,QAAQ,IAAI,UAAA,CAAW,MAAM,IAAA,CAAK,aAAa,CAAA;AACrD,EAAA,IAAI,MAAA,GAAS,EAAA;AACb,EAAA,KAAA,IAAS,IAAI,CAAA,EAAG,CAAA,GAAI,KAAA,CAAM,MAAA,EAAQ,KAAK,YAAA,EAAc;AACnD,IAAA,MAAA,IAAU,MAAA,CAAO,aAAa,GAAG,KAAA,CAAM,SAAS,CAAA,EAAG,CAAA,GAAI,YAAY,CAAC,CAAA;AAAA,EACtE;AACA,EAAA,OAAO,KAAK,MAAM,CAAA;AACpB","file":"index.cjs","sourcesContent":["/**\n * Hand the user a file to save, over the ext-apps `ui/download-file` request.\n *\n * A function over {@link App} rather than a method on it, like the helpers in\n * `extensions.ts` — but unlike them this is spec surface, so it is not gated on\n * the host identity. Any host that advertises `downloadFile` can answer it.\n *\n * The bytes always travel embedded. The spec also allows a `ResourceLink`, which\n * asks the host to fetch a URI the app names; a host holding the user's session\n * has every reason to refuse that, and the NimbleBrain host does.\n */\nimport {\n  DOWNLOAD_FILE_METHOD,\n  type McpUiDownloadFileRequest,\n  type McpUiDownloadFileResult,\n} from \"@modelcontextprotocol/ext-apps\";\nimport type { EmbeddedResource } from \"@modelcontextprotocol/sdk/types.js\";\nimport { internalsFor } from \"./internals.js\";\nimport type { App } from \"./types.js\";\n\n/** Bytes per `String.fromCharCode` spread — well under any engine's argument limit. */\nconst BASE64_CHUNK = 0x8000;\n\n/**\n * Hand the user a file to save.\n *\n * A string is sent as the resource's `text`; a `Blob` is read and sent as\n * base64 `blob`. Reading a `Blob` is asynchronous, which is why this returns a\n * promise.\n *\n * Precedence for the MIME type: the explicit argument, then the Blob's own\n * type, then `application/octet-stream`. An empty-string argument falls\n * through — a `\"\"` MIME is effectively \"no type\".\n *\n * The filename is the last segment of the resource's `file:///` URI, because an\n * embedded resource has no name field of its own.\n *\n * Resolves with the host's result: `{ isError: true }` when the host declined\n * or the user cancelled. Rejects, without sending, when the host did not\n * advertise the `downloadFile` capability — a host that does not implement the\n * request may never answer it, and a request has no deadline.\n */\nexport async function downloadFile(\n  app: App,\n  filename: string,\n  content: string | Blob,\n  mimeType?: string,\n): Promise<McpUiDownloadFileResult> {\n  const internals = internalsFor(app);\n  if (internals.hostDownloadFileCapability === undefined) {\n    throw new Error(\"downloadFile is not supported in this host\");\n  }\n  const resolvedMime =\n    mimeType || (content instanceof Blob ? content.type : \"\") || \"application/octet-stream\";\n  const uri = `file:///${filename}`;\n  const resource: EmbeddedResource[\"resource\"] =\n    typeof content === \"string\"\n      ? { uri, mimeType: resolvedMime, text: content }\n      : { uri, mimeType: resolvedMime, blob: await toBase64(content) };\n  const params: McpUiDownloadFileRequest[\"params\"] = {\n    contents: [{ type: \"resource\", resource }],\n  };\n  return (await internals.request(\n    DOWNLOAD_FILE_METHOD,\n    params as unknown as Record<string, unknown>,\n  )) as McpUiDownloadFileResult;\n}\n\nasync function toBase64(blob: Blob): Promise<string> {\n  const bytes = new Uint8Array(await blob.arrayBuffer());\n  let binary = \"\";\n  for (let i = 0; i < bytes.length; i += BASE64_CHUNK) {\n    binary += String.fromCharCode(...bytes.subarray(i, i + BASE64_CHUNK));\n  }\n  return btoa(binary);\n}\n"]}
+{"version":3,"sources":["../src/download-file.ts"],"names":["HostCapabilityError","internalsFor","DOWNLOAD_FILE_METHOD"],"mappings":";;;;;;;;AAsBA,IAAM,YAAA,GAAe,KAAA;AAqBrB,eAAsB,YAAA,CACpB,GAAA,EACA,QAAA,EACA,OAAA,EACA,QAAA,EACkC;AAClC,EAAA,IAAI,CAAC,GAAA,CAAI,gBAAA,CAAiB,YAAA,EAAc;AACtC,IAAA,MAAM,IAAIA,qCAAA,CAAoB,cAAA,EAAgB,cAAc,CAAA;AAAA,EAC9D;AACA,EAAA,MAAM,SAAA,GAAYC,+BAAa,GAAG,CAAA;AAClC,EAAA,MAAM,eACJ,QAAA,KAAa,OAAA,YAAmB,IAAA,GAAO,OAAA,CAAQ,OAAO,EAAA,CAAA,IAAO,0BAAA;AAC/D,EAAA,MAAM,GAAA,GAAM,WAAW,QAAQ,CAAA,CAAA;AAC/B,EAAA,MAAM,WACJ,OAAO,OAAA,KAAY,WACf,EAAE,GAAA,EAAK,UAAU,YAAA,EAAc,IAAA,EAAM,SAAQ,GAC7C,EAAE,KAAK,QAAA,EAAU,YAAA,EAAc,MAAM,MAAM,QAAA,CAAS,OAAO,CAAA,EAAE;AACnE,EAAA,MAAM,MAAA,GAA6C;AAAA,IACjD,UAAU,CAAC,EAAE,IAAA,EAAM,UAAA,EAAY,UAAU;AAAA,GAC3C;AACA,EAAA,OAAQ,MAAM,SAAA,CAAU,OAAA;AAAA,IACtBC,4BAAA;AAAA,IACA;AAAA,GACF;AACF;AAEA,eAAe,SAAS,IAAA,EAA6B;AACnD,EAAA,MAAM,QAAQ,IAAI,UAAA,CAAW,MAAM,IAAA,CAAK,aAAa,CAAA;AACrD,EAAA,IAAI,MAAA,GAAS,EAAA;AACb,EAAA,KAAA,IAAS,IAAI,CAAA,EAAG,CAAA,GAAI,KAAA,CAAM,MAAA,EAAQ,KAAK,YAAA,EAAc;AACnD,IAAA,MAAA,IAAU,MAAA,CAAO,aAAa,GAAG,KAAA,CAAM,SAAS,CAAA,EAAG,CAAA,GAAI,YAAY,CAAC,CAAA;AAAA,EACtE;AACA,EAAA,OAAO,KAAK,MAAM,CAAA;AACpB","file":"index.cjs","sourcesContent":["/**\n * Hand the user a file to save, over the ext-apps `ui/download-file` request.\n *\n * A function over {@link App} rather than a method on it, like the helpers in\n * `extensions.ts` — but unlike them this is spec surface, so it is not gated on\n * the host identity. Any host that advertises `downloadFile` can answer it.\n *\n * The bytes always travel embedded. The spec also allows a `ResourceLink`, which\n * asks the host to fetch a URI the app names; a host holding the user's session\n * has every reason to refuse that, and the NimbleBrain host does.\n */\nimport {\n  DOWNLOAD_FILE_METHOD,\n  type McpUiDownloadFileRequest,\n  type McpUiDownloadFileResult,\n} from \"@modelcontextprotocol/ext-apps\";\nimport type { EmbeddedResource } from \"@modelcontextprotocol/sdk/types.js\";\nimport { HostCapabilityError } from \"./errors.js\";\nimport { internalsFor } from \"./internals.js\";\nimport type { App } from \"./types.js\";\n\n/** Bytes per `String.fromCharCode` spread — well under any engine's argument limit. */\nconst BASE64_CHUNK = 0x8000;\n\n/**\n * Hand the user a file to save.\n *\n * A string is sent as the resource's `text`; a `Blob` is read and sent as\n * base64 `blob`. Reading a `Blob` is asynchronous, which is why this returns a\n * promise.\n *\n * Precedence for the MIME type: the explicit argument, then the Blob's own\n * type, then `application/octet-stream`. An empty-string argument falls\n * through — a `\"\"` MIME is effectively \"no type\".\n *\n * The filename is the last segment of the resource's `file:///` URI, because an\n * embedded resource has no name field of its own.\n *\n * Resolves with the host's result: `{ isError: true }` when the host declined\n * or the user cancelled. Rejects with `HostCapabilityError`, without sending,\n * when the host did not declare `downloadFile` — a host that does not implement\n * the request may never answer it, and a request has no deadline.\n */\nexport async function downloadFile(\n  app: App,\n  filename: string,\n  content: string | Blob,\n  mimeType?: string,\n): Promise<McpUiDownloadFileResult> {\n  if (!app.hostCapabilities.downloadFile) {\n    throw new HostCapabilityError(\"downloadFile\", \"downloadFile\");\n  }\n  const internals = internalsFor(app);\n  const resolvedMime =\n    mimeType || (content instanceof Blob ? content.type : \"\") || \"application/octet-stream\";\n  const uri = `file:///${filename}`;\n  const resource: EmbeddedResource[\"resource\"] =\n    typeof content === \"string\"\n      ? { uri, mimeType: resolvedMime, text: content }\n      : { uri, mimeType: resolvedMime, blob: await toBase64(content) };\n  const params: McpUiDownloadFileRequest[\"params\"] = {\n    contents: [{ type: \"resource\", resource }],\n  };\n  return (await internals.request(\n    DOWNLOAD_FILE_METHOD,\n    params as unknown as Record<string, unknown>,\n  )) as McpUiDownloadFileResult;\n}\n\nasync function toBase64(blob: Blob): Promise<string> {\n  const bytes = new Uint8Array(await blob.arrayBuffer());\n  let binary = \"\";\n  for (let i = 0; i < bytes.length; i += BASE64_CHUNK) {\n    binary += String.fromCharCode(...bytes.subarray(i, i + BASE64_CHUNK));\n  }\n  return btoa(binary);\n}\n"]}