@nimblebrain/synapse 0.11.0 → 0.12.0

package/dist/detect-DSnLT-_m.d.cts

@@ -0,0 +1,171 @@
+/**
+ * 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
+ * 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).
+ */
+/**
+ * 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).
+ */
+type HostKind = "chatgpt" | "claude" | "nimblebrain" | "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
+ *  SDK's neutral defaults back them. */
+interface SynapseUITheme {
+    mode: "light" | "dark";
+    tokens: Record<string, string>;
+}
+/** What the active host actually supports. `data()`/`onData()`/`theme()`/
+ *  `resize()` work everywhere; these three vary. */
+interface HostCapabilities {
+    /** `callTool()` can reach the server (widget→server fetch). */
+    pull: boolean;
+    /** `sendPrompt()` reaches the agent conversation. */
+    sendPrompt: boolean;
+    /** `openLink()` opens an external URL through the host. */
+    openLink: boolean;
+}
+/** Thrown by `callTool()` when the active host offers no widget→server call. */
+declare class HostUnsupportedError extends Error {
+    constructor(feature: string, host: HostKind);
+}
+interface ConnectUIOptions {
+    /** App name — informational; forwarded to hosts that accept an appInfo. */
+    name?: string;
+    /** App semver — informational. */
+    version?: string;
+    /**
+     * 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.
+     */
+    host?: HostKind;
+    /**
+     * `id` of the `<script type="application/json">` element carrying pushed data
+     * baked into the HTML (the mcp-ui / SSR path). Defaults to
+     * {@link SYNAPSE_DATA_ELEMENT_ID}.
+     */
+    dataElementId?: string;
+    /**
+     * Auto-report content height to the host on layout changes (mcp-ui only).
+     * Defaults to `true`. Set `false` to size manually via `resize()`.
+     */
+    autoResize?: boolean;
+    /** Window to bind to. Defaults to the global `window`. Injectable for tests. */
+    window?: Window & typeof globalThis;
+}
+/**
+ * The public cross-host client. Bound to `synapse` by convention.
+ *
+ * ```ts
+ * const synapse = connectUI();
+ * synapse.onData(render);          // future pushes/updates
+ * render(synapse.data());          // current value (may be null → empty state)
+ * ```
+ */
+interface SynapseUIClient {
+    /** The current pushed data, or `null` before anything has been delivered. */
+    data<T = unknown>(): T | null;
+    /** Subscribe to data updates (NOT replayed — read `data()` for the current
+     *  value). Returns an unsubscribe. */
+    onData<T = unknown>(cb: (data: T) => void): () => void;
+    /** The current resolved theme. */
+    theme(): SynapseUITheme;
+    /** 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`). */
+    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;
+    /** Open an external URL through the host (falls back to `window.open`). */
+    openLink(url: string): void;
+    /** Report content height to the host. Omit `height` to measure `document.body`. */
+    resize(height?: number): void;
+    /** What the active host supports. */
+    capabilities(): HostCapabilities;
+    /** The resolved host — an escape hatch; prefer `capabilities()`. */
+    host(): HostKind;
+    /** Tear down listeners/observers. */
+    destroy(): void;
+}
+/**
+ * Internal adapter contract. One per host bridge; the client is a thin façade
+ * over the selected adapter.
+ */
+interface HostAdapter {
+    readonly host: HostKind;
+    getData<T = unknown>(): T | null;
+    onData<T = unknown>(cb: (data: T) => void): () => void;
+    getTheme(): SynapseUITheme;
+    onTheme(cb: (theme: SynapseUITheme) => void): () => void;
+    callTool<O = unknown>(name: string, args?: Record<string, unknown>): Promise<O>;
+    sendPrompt(text: string): void;
+    openLink(url: string): void;
+    resize(height?: number): void;
+    capabilities(): HostCapabilities;
+    /** Begin listening / send the ready handshake / read baked-in data. Called once
+     *  by `connectUI` synchronously so `getData()` is populated on return. */
+    start(): void;
+    destroy(): void;
+}
+/** Default `id` of the baked-in data `<script type="application/json">`. */
+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
+ * host theme to the DOM before returning.
+ *
+ * Synchronous: `data()` is populated from baked-in data (where present) on
+ * return, and pushed updates arrive via `onData`. Bind the result to `synapse`:
+ *
+ * ```ts
+ * const synapse = connectUI({ name: "my-widget", version: "1.0.0" });
+ * synapse.onData(render);        // future pushes/updates
+ * render(synapse.data());        // current value (null → empty state)
+ * ```
+ */
+declare function connectUI(options?: ConnectUIOptions): SynapseUIClient;
+
+/**
+ * Minimal window shape the detector inspects. Kept structural so detection is
+ * 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.
+ *
+ *  - `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).
+ *  - 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.
+ */
+declare function detectHostKind(win: DetectableWindow): HostKind;
+/** Build the adapter for an explicit host kind (`options.host` or a detected one). */
+declare function adapterForKind(kind: HostKind, win: Window & typeof globalThis, options: ConnectUIOptions): HostAdapter;
+/** 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 HostCapabilities as H, SYNAPSE_DATA_ELEMENT_ID as S, type HostKind as a, HostUnsupportedError as b, type SynapseUIClient as c, type SynapseUITheme as d, connectUI as e, detectHostKind as f, type HostAdapter as g, adapterForKind as h, selectAdapter as s };

package/dist/detect-DSnLT-_m.d.ts

@@ -0,0 +1,171 @@
+/**
+ * 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
+ * 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).
+ */
+/**
+ * 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).
+ */
+type HostKind = "chatgpt" | "claude" | "nimblebrain" | "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
+ *  SDK's neutral defaults back them. */
+interface SynapseUITheme {
+    mode: "light" | "dark";
+    tokens: Record<string, string>;
+}
+/** What the active host actually supports. `data()`/`onData()`/`theme()`/
+ *  `resize()` work everywhere; these three vary. */
+interface HostCapabilities {
+    /** `callTool()` can reach the server (widget→server fetch). */
+    pull: boolean;
+    /** `sendPrompt()` reaches the agent conversation. */
+    sendPrompt: boolean;
+    /** `openLink()` opens an external URL through the host. */
+    openLink: boolean;
+}
+/** Thrown by `callTool()` when the active host offers no widget→server call. */
+declare class HostUnsupportedError extends Error {
+    constructor(feature: string, host: HostKind);
+}
+interface ConnectUIOptions {
+    /** App name — informational; forwarded to hosts that accept an appInfo. */
+    name?: string;
+    /** App semver — informational. */
+    version?: string;
+    /**
+     * 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.
+     */
+    host?: HostKind;
+    /**
+     * `id` of the `<script type="application/json">` element carrying pushed data
+     * baked into the HTML (the mcp-ui / SSR path). Defaults to
+     * {@link SYNAPSE_DATA_ELEMENT_ID}.
+     */
+    dataElementId?: string;
+    /**
+     * Auto-report content height to the host on layout changes (mcp-ui only).
+     * Defaults to `true`. Set `false` to size manually via `resize()`.
+     */
+    autoResize?: boolean;
+    /** Window to bind to. Defaults to the global `window`. Injectable for tests. */
+    window?: Window & typeof globalThis;
+}
+/**
+ * The public cross-host client. Bound to `synapse` by convention.
+ *
+ * ```ts
+ * const synapse = connectUI();
+ * synapse.onData(render);          // future pushes/updates
+ * render(synapse.data());          // current value (may be null → empty state)
+ * ```
+ */
+interface SynapseUIClient {
+    /** The current pushed data, or `null` before anything has been delivered. */
+    data<T = unknown>(): T | null;
+    /** Subscribe to data updates (NOT replayed — read `data()` for the current
+     *  value). Returns an unsubscribe. */
+    onData<T = unknown>(cb: (data: T) => void): () => void;
+    /** The current resolved theme. */
+    theme(): SynapseUITheme;
+    /** 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`). */
+    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;
+    /** Open an external URL through the host (falls back to `window.open`). */
+    openLink(url: string): void;
+    /** Report content height to the host. Omit `height` to measure `document.body`. */
+    resize(height?: number): void;
+    /** What the active host supports. */
+    capabilities(): HostCapabilities;
+    /** The resolved host — an escape hatch; prefer `capabilities()`. */
+    host(): HostKind;
+    /** Tear down listeners/observers. */
+    destroy(): void;
+}
+/**
+ * Internal adapter contract. One per host bridge; the client is a thin façade
+ * over the selected adapter.
+ */
+interface HostAdapter {
+    readonly host: HostKind;
+    getData<T = unknown>(): T | null;
+    onData<T = unknown>(cb: (data: T) => void): () => void;
+    getTheme(): SynapseUITheme;
+    onTheme(cb: (theme: SynapseUITheme) => void): () => void;
+    callTool<O = unknown>(name: string, args?: Record<string, unknown>): Promise<O>;
+    sendPrompt(text: string): void;
+    openLink(url: string): void;
+    resize(height?: number): void;
+    capabilities(): HostCapabilities;
+    /** Begin listening / send the ready handshake / read baked-in data. Called once
+     *  by `connectUI` synchronously so `getData()` is populated on return. */
+    start(): void;
+    destroy(): void;
+}
+/** Default `id` of the baked-in data `<script type="application/json">`. */
+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
+ * host theme to the DOM before returning.
+ *
+ * Synchronous: `data()` is populated from baked-in data (where present) on
+ * return, and pushed updates arrive via `onData`. Bind the result to `synapse`:
+ *
+ * ```ts
+ * const synapse = connectUI({ name: "my-widget", version: "1.0.0" });
+ * synapse.onData(render);        // future pushes/updates
+ * render(synapse.data());        // current value (null → empty state)
+ * ```
+ */
+declare function connectUI(options?: ConnectUIOptions): SynapseUIClient;
+
+/**
+ * Minimal window shape the detector inspects. Kept structural so detection is
+ * 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.
+ *
+ *  - `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).
+ *  - 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.
+ */
+declare function detectHostKind(win: DetectableWindow): HostKind;
+/** Build the adapter for an explicit host kind (`options.host` or a detected one). */
+declare function adapterForKind(kind: HostKind, win: Window & typeof globalThis, options: ConnectUIOptions): HostAdapter;
+/** 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 HostCapabilities as H, SYNAPSE_DATA_ELEMENT_ID as S, type HostKind as a, HostUnsupportedError as b, type SynapseUIClient as c, type SynapseUITheme as d, connectUI as e, detectHostKind as f, type HostAdapter as g, adapterForKind as h, selectAdapter as s };

package/dist/host/index.cjs

@@ -0,0 +1,57 @@
+'use strict';
+
+var chunkANUZ7WFQ_cjs = require('../chunk-ANUZ7WFQ.cjs');
+require('../chunk-KTXASIFJ.cjs');
+
+
+
+Object.defineProperty(exports, "HostUnsupportedError", {
+  enumerable: true,
+  get: function () { return chunkANUZ7WFQ_cjs.HostUnsupportedError; }
+});
+Object.defineProperty(exports, "SYNAPSE_DATA_ELEMENT_ID", {
+  enumerable: true,
+  get: function () { return chunkANUZ7WFQ_cjs.SYNAPSE_DATA_ELEMENT_ID; }
+});
+Object.defineProperty(exports, "adapterForKind", {
+  enumerable: true,
+  get: function () { return chunkANUZ7WFQ_cjs.adapterForKind; }
+});
+Object.defineProperty(exports, "applyHostTheme", {
+  enumerable: true,
+  get: function () { return chunkANUZ7WFQ_cjs.applyHostTheme; }
+});
+Object.defineProperty(exports, "coerceMode", {
+  enumerable: true,
+  get: function () { return chunkANUZ7WFQ_cjs.coerceMode; }
+});
+Object.defineProperty(exports, "connectUI", {
+  enumerable: true,
+  get: function () { return chunkANUZ7WFQ_cjs.connectUI; }
+});
+Object.defineProperty(exports, "createChatGPTAdapter", {
+  enumerable: true,
+  get: function () { return chunkANUZ7WFQ_cjs.createChatGPTAdapter; }
+});
+Object.defineProperty(exports, "createInlineAdapter", {
+  enumerable: true,
+  get: function () { return chunkANUZ7WFQ_cjs.createInlineAdapter; }
+});
+Object.defineProperty(exports, "createMcpAppsAdapter", {
+  enumerable: true,
+  get: function () { return chunkANUZ7WFQ_cjs.createMcpAppsAdapter; }
+});
+Object.defineProperty(exports, "detectHostKind", {
+  enumerable: true,
+  get: function () { return chunkANUZ7WFQ_cjs.detectHostKind; }
+});
+Object.defineProperty(exports, "preferredMode", {
+  enumerable: true,
+  get: function () { return chunkANUZ7WFQ_cjs.preferredMode; }
+});
+Object.defineProperty(exports, "selectAdapter", {
+  enumerable: true,
+  get: function () { return chunkANUZ7WFQ_cjs.selectAdapter; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/host/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/host/index.d.cts

@@ -0,0 +1,68 @@
+import { C as ConnectUIOptions, g as HostAdapter, d as SynapseUITheme } from '../detect-DSnLT-_m.cjs';
+export { H as HostCapabilities, a as HostKind, b as HostUnsupportedError, S as SYNAPSE_DATA_ELEMENT_ID, c as SynapseUIClient, h as adapterForKind, e as connectUI, f as detectHostKind, s as selectAdapter } from '../detect-DSnLT-_m.cjs';
+
+/**
+ * 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;
+
+/**
+ * Inline / standalone fallback adapter.
+ *
+ * No live host bridge — used for SSR, previews, and a plain browser render. Data
+ * comes only from the baked-in `<script type="application/json">` blob; there is
+ * nothing to push, so `onData` never fires after `start()`. Theme follows the OS
+ * color scheme and tracks `prefers-color-scheme` changes. `openLink` opens a new
+ * tab; `sendPrompt`/`callTool` have no destination.
+ */
+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.
+ *
+ * The View iframe is an MCP client speaking JSON-RPC 2.0 to `window.parent`:
+ *
+ *  1. posts `ui/initialize` and awaits the host context (theme, style variables);
+ *  2. posts `ui/notifications/initialized`, then a `size-changed` — a host keeps
+ *     the frame hidden until it has both the handshake and a size;
+ *  3. receives data via `ui/notifications/tool-result` (`params` IS the
+ *     `CallToolResult`, so data is at `params.structuredContent`) and theme via
+ *     `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.
+ */
+declare function createMcpAppsAdapter(win: Window & typeof globalThis, options: ConnectUIOptions): HostAdapter;
+
+/**
+ * Apply a resolved theme to the DOM for the cross-host client.
+ *
+ * Two conventions coexist across Synapse components, so the client drives both:
+ *
+ *  - `document.documentElement[data-theme="light"|"dark"]` — how self-contained
+ *    HTML components (Bassethound's report) gate their `--var` palettes, and the
+ *    lever a host's light/dark signal actually flips.
+ *  - CSS custom properties via {@link applyThemeVariables} — how the
+ *    `@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.
+ */
+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). */
+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 };

package/dist/host/index.d.ts

@@ -0,0 +1,68 @@
+import { C as ConnectUIOptions, g as HostAdapter, d as SynapseUITheme } from '../detect-DSnLT-_m.js';
+export { H as HostCapabilities, a as HostKind, b as HostUnsupportedError, S as SYNAPSE_DATA_ELEMENT_ID, c as SynapseUIClient, h as adapterForKind, e as connectUI, f as detectHostKind, s as selectAdapter } from '../detect-DSnLT-_m.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;
+
+/**
+ * Inline / standalone fallback adapter.
+ *
+ * No live host bridge — used for SSR, previews, and a plain browser render. Data
+ * comes only from the baked-in `<script type="application/json">` blob; there is
+ * nothing to push, so `onData` never fires after `start()`. Theme follows the OS
+ * color scheme and tracks `prefers-color-scheme` changes. `openLink` opens a new
+ * tab; `sendPrompt`/`callTool` have no destination.
+ */
+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.
+ *
+ * The View iframe is an MCP client speaking JSON-RPC 2.0 to `window.parent`:
+ *
+ *  1. posts `ui/initialize` and awaits the host context (theme, style variables);
+ *  2. posts `ui/notifications/initialized`, then a `size-changed` — a host keeps
+ *     the frame hidden until it has both the handshake and a size;
+ *  3. receives data via `ui/notifications/tool-result` (`params` IS the
+ *     `CallToolResult`, so data is at `params.structuredContent`) and theme via
+ *     `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.
+ */
+declare function createMcpAppsAdapter(win: Window & typeof globalThis, options: ConnectUIOptions): HostAdapter;
+
+/**
+ * Apply a resolved theme to the DOM for the cross-host client.
+ *
+ * Two conventions coexist across Synapse components, so the client drives both:
+ *
+ *  - `document.documentElement[data-theme="light"|"dark"]` — how self-contained
+ *    HTML components (Bassethound's report) gate their `--var` palettes, and the
+ *    lever a host's light/dark signal actually flips.
+ *  - CSS custom properties via {@link applyThemeVariables} — how the
+ *    `@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.
+ */
+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). */
+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 };

package/dist/host/index.js

@@ -0,0 +1,4 @@
+export { HostUnsupportedError, SYNAPSE_DATA_ELEMENT_ID, adapterForKind, applyHostTheme, coerceMode, connectUI, createChatGPTAdapter, createInlineAdapter, createMcpAppsAdapter, detectHostKind, preferredMode, selectAdapter } from '../chunk-JVKQNMAP.js';
+import '../chunk-VXTMI266.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/host/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/index.cjs

@@ -1,6 +1,8 @@
 'use strict';
 
-var chunk74EGUVGE_cjs = require('./chunk-74EGUVGE.cjs');
+var chunkANUZ7WFQ_cjs = require('./chunk-ANUZ7WFQ.cjs');
+var chunkA4ENX6XW_cjs = require('./chunk-A4ENX6XW.cjs');
+require('./chunk-KTXASIFJ.cjs');
 
 // src/store.ts
 function createStore(synapse, config) {
@@ -78,13 +80,29 @@ function createStore(synapse, config) {
   return store;
 }
 
+Object.defineProperty(exports, "HostUnsupportedError", {
+  enumerable: true,
+  get: function () { return chunkANUZ7WFQ_cjs.HostUnsupportedError; }
+});
+Object.defineProperty(exports, "SYNAPSE_DATA_ELEMENT_ID", {
+  enumerable: true,
+  get: function () { return chunkANUZ7WFQ_cjs.SYNAPSE_DATA_ELEMENT_ID; }
+});
+Object.defineProperty(exports, "connectUI", {
+  enumerable: true,
+  get: function () { return chunkANUZ7WFQ_cjs.connectUI; }
+});
+Object.defineProperty(exports, "detectHostKind", {
+  enumerable: true,
+  get: function () { return chunkANUZ7WFQ_cjs.detectHostKind; }
+});
 Object.defineProperty(exports, "connect", {
   enumerable: true,
-  get: function () { return chunk74EGUVGE_cjs.connect; }
+  get: function () { return chunkA4ENX6XW_cjs.connect; }
 });
 Object.defineProperty(exports, "createSynapse", {
   enumerable: true,
-  get: function () { return chunk74EGUVGE_cjs.createSynapse; }
+  get: function () { return chunkA4ENX6XW_cjs.createSynapse; }
 });
 exports.createStore = createStore;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/store.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type { ActionReducer, Store, StoreConfig, StoreDispatch, Synapse } from \"./types.js\";\n\n/**\n * Create a typed state store with optional persistence and agent visibility.\n *\n * - `persist: true` — state survives iframe reloads via host storage\n * - `visibleToAgent: true` — state is pushed to the LLM context\n * - Both are independent and can be enabled separately\n */\nexport function createStore<\n  TState,\n  TActions extends Record<string, ActionReducer<TState, any>> = Record<\n    string,\n    ActionReducer<TState, any>\n  >,\n>(synapse: Synapse, config: StoreConfig<TState> & { actions: TActions }): Store<TState, TActions> {\n  let state = structuredClone(config.initialState);\n  const subscribers = new Set<(state: TState) => void>();\n  let destroyed = false;\n  let persistTimer: ReturnType<typeof setTimeout> | null = null;\n\n  // Build dispatch object from action reducers\n  const dispatch = {} as StoreDispatch<TActions>;\n  for (const key of Object.keys(config.actions)) {\n    (dispatch as any)[key] = (payload: unknown) => {\n      if (destroyed) return;\n      state = config.actions[key](state, payload);\n      notify();\n    };\n  }\n\n  function notify(): void {\n    for (const cb of subscribers) cb(state);\n    if (config.visibleToAgent) pushToAgent();\n    if (config.persist) schedulePersist();\n  }\n\n  function pushToAgent(): void {\n    const summary = config.summarize?.(state);\n    synapse.setVisibleState(state as unknown as Record<string, unknown>, summary);\n  }\n\n  function schedulePersist(): void {\n    if (persistTimer) clearTimeout(persistTimer);\n    persistTimer = setTimeout(() => {\n      synapse\n        ._request(\"synapse/persist-state\", {\n          state: state as unknown as Record<string, unknown>,\n          version: config.version,\n        })\n        .catch(() => {\n          // Silently ignore persist failures (host may not support it)\n        });\n      persistTimer = null;\n    }, 500);\n  }\n\n  // Listen for state loaded from host (on init)\n  let unsubStateLoaded: (() => void) | undefined;\n  if (config.persist) {\n    unsubStateLoaded = synapse._onMessage(\"synapse/state-loaded\", (params) => {\n      if (!params?.state) return;\n      let loaded = params.state as TState;\n      const loadedVersion = (params.version as number) ?? 1;\n      const currentVersion = config.version ?? 1;\n\n      // Run migrations if needed\n      if (config.migrations && loadedVersion < currentVersion) {\n        const startIdx = loadedVersion - 1;\n        for (let i = startIdx; i < config.migrations.length; i++) {\n          loaded = config.migrations[i](loaded);\n        }\n      }\n\n      store.hydrate(loaded);\n    });\n  }\n\n  const store: Store<TState, TActions> = {\n    getState(): TState {\n      return state;\n    },\n\n    subscribe(callback: (state: TState) => void): () => void {\n      subscribers.add(callback);\n      return () => {\n        subscribers.delete(callback);\n      };\n    },\n\n    dispatch,\n\n    hydrate(newState: TState): void {\n      state = newState;\n      for (const cb of subscribers) cb(state);\n    },\n\n    destroy(): void {\n      if (destroyed) return;\n      destroyed = true;\n      if (persistTimer) clearTimeout(persistTimer);\n      subscribers.clear();\n      unsubStateLoaded?.();\n    },\n  };\n\n  return store;\n}\n"]}
+{"version":3,"sources":["../src/store.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type { ActionReducer, Store, StoreConfig, StoreDispatch, Synapse } from \"./types.js\";\n\n/**\n * Create a typed state store with optional persistence and agent visibility.\n *\n * - `persist: true` — state survives iframe reloads via host storage\n * - `visibleToAgent: true` — state is pushed to the LLM context\n * - Both are independent and can be enabled separately\n */\nexport function createStore<\n  TState,\n  TActions extends Record<string, ActionReducer<TState, any>> = Record<\n    string,\n    ActionReducer<TState, any>\n  >,\n>(synapse: Synapse, config: StoreConfig<TState> & { actions: TActions }): Store<TState, TActions> {\n  let state = structuredClone(config.initialState);\n  const subscribers = new Set<(state: TState) => void>();\n  let destroyed = false;\n  let persistTimer: ReturnType<typeof setTimeout> | null = null;\n\n  // Build dispatch object from action reducers\n  const dispatch = {} as StoreDispatch<TActions>;\n  for (const key of Object.keys(config.actions)) {\n    (dispatch as any)[key] = (payload: unknown) => {\n      if (destroyed) return;\n      state = config.actions[key](state, payload);\n      notify();\n    };\n  }\n\n  function notify(): void {\n    for (const cb of subscribers) cb(state);\n    if (config.visibleToAgent) pushToAgent();\n    if (config.persist) schedulePersist();\n  }\n\n  function pushToAgent(): void {\n    const summary = config.summarize?.(state);\n    synapse.setVisibleState(state as unknown as Record<string, unknown>, summary);\n  }\n\n  function schedulePersist(): void {\n    if (persistTimer) clearTimeout(persistTimer);\n    persistTimer = setTimeout(() => {\n      synapse\n        ._request(\"synapse/persist-state\", {\n          state: state as unknown as Record<string, unknown>,\n          version: config.version,\n        })\n        .catch(() => {\n          // Silently ignore persist failures (host may not support it)\n        });\n      persistTimer = null;\n    }, 500);\n  }\n\n  // Listen for state loaded from host (on init)\n  let unsubStateLoaded: (() => void) | undefined;\n  if (config.persist) {\n    unsubStateLoaded = synapse._onMessage(\"synapse/state-loaded\", (params) => {\n      if (!params?.state) return;\n      let loaded = params.state as TState;\n      const loadedVersion = (params.version as number) ?? 1;\n      const currentVersion = config.version ?? 1;\n\n      // Run migrations if needed\n      if (config.migrations && loadedVersion < currentVersion) {\n        const startIdx = loadedVersion - 1;\n        for (let i = startIdx; i < config.migrations.length; i++) {\n          loaded = config.migrations[i](loaded);\n        }\n      }\n\n      store.hydrate(loaded);\n    });\n  }\n\n  const store: Store<TState, TActions> = {\n    getState(): TState {\n      return state;\n    },\n\n    subscribe(callback: (state: TState) => void): () => void {\n      subscribers.add(callback);\n      return () => {\n        subscribers.delete(callback);\n      };\n    },\n\n    dispatch,\n\n    hydrate(newState: TState): void {\n      state = newState;\n      for (const cb of subscribers) cb(state);\n    },\n\n    destroy(): void {\n      if (destroyed) return;\n      destroyed = true;\n      if (persistTimer) clearTimeout(persistTimer);\n      subscribers.clear();\n      unsubStateLoaded?.();\n    },\n  };\n\n  return store;\n}\n"]}

package/dist/index.d.cts

@@ -1,6 +1,7 @@
 export { CreateTaskResult, ReadResourceRequest, ReadResourceResult, Task, TaskStatus } 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-C9utGXv_.cjs';
 export { e as AgentAction, f as AppEventName, B as BuiltinActionType, g as CallToolAsTaskOptions, D as DataChangedEvent, h as Dimensions, F as FileResult, H as HostInfo, K as KeyForwardConfig, N as NavigatePayload, i as NotifyPayload, R as RequestFileOptions, j as StateAcknowledgement, k as StoreDispatch, l as SynapseTheme, m as TaskHandle, n as TasksCapability, o as Theme, p as ToolCallResult, T as ToolDefinition, q as ToolResultData, V as VisibleState } from './types-C9utGXv_.cjs';
+export { C as ConnectUIOptions, H as HostCapabilities, a as HostKind, b as HostUnsupportedError, S as SYNAPSE_DATA_ELEMENT_ID, c as SynapseUIClient, d as SynapseUITheme, e as connectUI, f as detectHostKind } from './detect-DSnLT-_m.cjs';
 import '@modelcontextprotocol/ext-apps';
 
 /**

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { CreateTaskResult, ReadResourceRequest, ReadResourceResult, Task, TaskStatus } 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-C9utGXv_.js';
 export { e as AgentAction, f as AppEventName, B as BuiltinActionType, g as CallToolAsTaskOptions, D as DataChangedEvent, h as Dimensions, F as FileResult, H as HostInfo, K as KeyForwardConfig, N as NavigatePayload, i as NotifyPayload, R as RequestFileOptions, j as StateAcknowledgement, k as StoreDispatch, l as SynapseTheme, m as TaskHandle, n as TasksCapability, o as Theme, p as ToolCallResult, T as ToolDefinition, q as ToolResultData, V as VisibleState } from './types-C9utGXv_.js';
+export { C as ConnectUIOptions, H as HostCapabilities, a as HostKind, b as HostUnsupportedError, S as SYNAPSE_DATA_ELEMENT_ID, c as SynapseUIClient, d as SynapseUITheme, e as connectUI, f as detectHostKind } from './detect-DSnLT-_m.js';
 import '@modelcontextprotocol/ext-apps';
 
 /**

package/dist/index.js

@@ -1,4 +1,6 @@
-export { connect, createSynapse } from './chunk-S7QIWD46.js';
+export { HostUnsupportedError, SYNAPSE_DATA_ELEMENT_ID, connectUI, detectHostKind } from './chunk-JVKQNMAP.js';
+export { connect, createSynapse } from './chunk-XGJAADVV.js';
+import './chunk-VXTMI266.js';
 
 // src/store.ts
 function createStore(synapse, config) {