@nimblebrain/synapse 0.17.1 → 0.19.0

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

@@ -1,4 +1,4 @@
-import { g as FontFaceDescriptor } from './types-uEO4VFJ2.js';
+import { f as FontFaceDescriptor } from './types-CG08aO82.js';
 
 /**
  * Cross-host UI client — types and wire constants.
@@ -174,4 +174,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 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 };
+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 };

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

@@ -1,4 +1,4 @@
-import { g as FontFaceDescriptor } from './types-uEO4VFJ2.cjs';
+import { f as FontFaceDescriptor } from './types-CG08aO82.cjs';
 
 /**
  * Cross-host UI client — types and wire constants.
@@ -174,4 +174,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 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 };
+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 };

package/dist/host/index.cjs

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

package/dist/host/index.d.cts

@@ -1,6 +1,6 @@
-import { C as ConnectUIOptions, g as HostAdapter, d as SynapseUITheme } from '../detect-BHYg26_d.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-BHYg26_d.cjs';
-import '../types-uEO4VFJ2.cjs';
+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';
 

package/dist/host/index.d.ts

@@ -1,6 +1,6 @@
-import { C as ConnectUIOptions, g as HostAdapter, d as SynapseUITheme } from '../detect-Bf8Q_0dK.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-Bf8Q_0dK.js';
-import '../types-uEO4VFJ2.js';
+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';
 

package/dist/host/index.js

@@ -1,4 +1,5 @@
-export { HostUnsupportedError, SYNAPSE_DATA_ELEMENT_ID, adapterForKind, applyHostTheme, coerceMode, connectUI, createChatGPTAdapter, createInlineAdapter, createMcpAppsAdapter, detectHostKind, preferredMode, selectAdapter } from '../chunk-SRQNQ26I.js';
-import '../chunk-UPDBDXQB.js';
+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';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.cjs

@@ -1,54 +1,78 @@
 'use strict';
 
-var chunkEHLQWCYV_cjs = require('./chunk-EHLQWCYV.cjs');
-var chunkFDMRJZKT_cjs = require('./chunk-FDMRJZKT.cjs');
-var chunkTXJMGQYF_cjs = require('./chunk-TXJMGQYF.cjs');
-
+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 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");
+  }
+  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) };
+  const params = {
+    contents: [{ type: "resource", resource }]
+  };
+  return await internals.request(
+    extApps.DOWNLOAD_FILE_METHOD,
+    params
+  );
+}
+async function toBase64(blob) {
+  const bytes = new Uint8Array(await blob.arrayBuffer());
+  let binary = "";
+  for (let i = 0; i < bytes.length; i += BASE64_CHUNK) {
+    binary += String.fromCharCode(...bytes.subarray(i, i + BASE64_CHUNK));
+  }
+  return btoa(binary);
+}
 
 Object.defineProperty(exports, "HostUnsupportedError", {
   enumerable: true,
-  get: function () { return chunkEHLQWCYV_cjs.HostUnsupportedError; }
+  get: function () { return chunkRU64F5RS_cjs.HostUnsupportedError; }
 });
 Object.defineProperty(exports, "SYNAPSE_DATA_ELEMENT_ID", {
   enumerable: true,
-  get: function () { return chunkEHLQWCYV_cjs.SYNAPSE_DATA_ELEMENT_ID; }
+  get: function () { return chunkRU64F5RS_cjs.SYNAPSE_DATA_ELEMENT_ID; }
 });
 Object.defineProperty(exports, "connectUI", {
   enumerable: true,
-  get: function () { return chunkEHLQWCYV_cjs.connectUI; }
+  get: function () { return chunkRU64F5RS_cjs.connectUI; }
 });
 Object.defineProperty(exports, "detectHostKind", {
   enumerable: true,
-  get: function () { return chunkEHLQWCYV_cjs.detectHostKind; }
+  get: function () { return chunkRU64F5RS_cjs.detectHostKind; }
 });
 Object.defineProperty(exports, "action", {
   enumerable: true,
-  get: function () { return chunkFDMRJZKT_cjs.action; }
+  get: function () { return chunkQXDCA7QW_cjs.action; }
 });
 Object.defineProperty(exports, "callToolAsTask", {
   enumerable: true,
-  get: function () { return chunkFDMRJZKT_cjs.callToolAsTask; }
+  get: function () { return chunkQXDCA7QW_cjs.callToolAsTask; }
 });
 Object.defineProperty(exports, "connect", {
   enumerable: true,
-  get: function () { return chunkFDMRJZKT_cjs.connect; }
-});
-Object.defineProperty(exports, "downloadFile", {
-  enumerable: true,
-  get: function () { return chunkFDMRJZKT_cjs.downloadFile; }
+  get: function () { return chunkQXDCA7QW_cjs.connect; }
 });
 Object.defineProperty(exports, "pickFile", {
   enumerable: true,
-  get: function () { return chunkFDMRJZKT_cjs.pickFile; }
+  get: function () { return chunkQXDCA7QW_cjs.pickFile; }
 });
 Object.defineProperty(exports, "pickFiles", {
   enumerable: true,
-  get: function () { return chunkFDMRJZKT_cjs.pickFiles; }
+  get: function () { return chunkQXDCA7QW_cjs.pickFiles; }
 });
 Object.defineProperty(exports, "FONT_FACES_CONTEXT_KEY", {
   enumerable: true,
-  get: function () { return chunkTXJMGQYF_cjs.FONT_FACES_CONTEXT_KEY; }
+  get: function () { return chunkSZWHFTXV_cjs.FONT_FACES_CONTEXT_KEY; }
 });
+exports.downloadFile = downloadFile;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}
+{"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"]}

package/dist/index.d.cts

@@ -1,18 +1,21 @@
 export { CreateTaskResult, ReadResourceRequest, ReadResourceResult, Task, TaskStatus } from '@modelcontextprotocol/sdk/types.js';
-import { C as ConnectOptions, A as App, R as RequestFileOptions, F as FileResult, a as CallToolAsTaskOptions, T as TaskHandle } from './types-uEO4VFJ2.cjs';
-export { h as AgentAction, i as AppEventName, B as BuiltinActionType, c as CallToolOptions, D as DataChangedEvent, j as Dimensions, k as FontDisplayValue, g as FontFaceDescriptor, H as HostInfo, K as KeyForwardConfig, M as ModelContext, N as NavigatePayload, l as NotifyPayload, m as TasksCapability, d as Theme, b as ToolCallResult, f as ToolDefinition, e as ToolResultData } from './types-uEO4VFJ2.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-BHYg26_d.cjs';
+import { C as ConnectOptions, A as App, R as RequestFileOptions, F as FileResult, a as CallToolAsTaskOptions, T as TaskHandle } from './types-CG08aO82.cjs';
+export { g as AppEventName, D as Dimensions, h as FontDisplayValue, f as FontFaceDescriptor, K as KeyForwardConfig, M as ModelContext, i as TasksCapability, c as Theme, b as ToolCallResult, e as ToolDefinition, d as ToolResultData } from './types-CG08aO82.cjs';
+import { McpUiDownloadFileResult } from '@modelcontextprotocol/ext-apps';
 export { McpUiHostContext } from '@modelcontextprotocol/ext-apps';
+export { C as ConnectUIOptions, a as HostCapabilities, b as HostKind, c as HostUnsupportedError, d as SYNAPSE_DATA_ELEMENT_ID, e as SynapseUIClient, S as SynapseUITheme, g as connectUI, h as detectHostKind } from './detect-DZMJsyvZ.cjs';
 
 /**
  * Connect to an MCP Apps host.
  *
- * The one entry point: owns the ext-apps handshake, theme injection, content
- * parsing, resize management, and event routing, and resolves to a ready
- * {@link App}.
+ * The one entry point. The protocol underneath is the spec's own client,
+ * `@modelcontextprotocol/ext-apps`'s `App`: it owns the transport, the
+ * handshake and the wire schemas. What this adds is the framework on top —
+ * theme injection, the parsed payloads, multi-subscriber events, resize, and
+ * the NimbleBrain extensions — and it resolves to a ready {@link App}.
  *
  * The `App` it returns stays deliberately small. NimbleBrain's own extensions
- * (`action`, the file picker, `downloadFile`) and the MCP tasks utility are
+ * (`action`, the file picker), `downloadFile` and the MCP tasks utility are
  * composable functions over it — import them from the package root.
  */
 declare function connect(options: ConnectOptions): Promise<App>;
@@ -30,21 +33,45 @@ declare function connect(options: ConnectOptions): Promise<App>;
 declare const FONT_FACES_CONTEXT_KEY = "synapse/fontFaces";
 
 /**
- * Trigger a host-side action.
+ * Hand the user a file to save, over the ext-apps `ui/download-file` request.
+ *
+ * A function over {@link App} rather than a method on it, like the helpers in
+ * `extensions.ts` — but unlike them this is spec surface, so it is not gated on
+ * the host identity. Any host that advertises `downloadFile` can answer it.
  *
- * The inverse direction of the `action` event: this sends a command *to* the
- * host (navigate, open a panel), where `app.on("action", …)` receives the ones
- * a tool emits. No-op off a NimbleBrain host.
+ * The bytes always travel embedded. The spec also allows a `ResourceLink`, which
+ * asks the host to fetch a URI the app names; a host holding the user's session
+ * has every reason to refuse that, and the NimbleBrain host does.
  */
-declare function action(app: App, name: string, params?: Record<string, unknown>): void;
+
 /**
  * Hand the user a file to save.
  *
+ * A string is sent as the resource's `text`; a `Blob` is read and sent as
+ * base64 `blob`. Reading a `Blob` is asynchronous, which is why this returns a
+ * promise.
+ *
  * Precedence for the MIME type: the explicit argument, then the Blob's own
  * type, then `application/octet-stream`. An empty-string argument falls
  * through — a `""` MIME is effectively "no type".
+ *
+ * The filename is the last segment of the resource's `file:///` URI, because an
+ * embedded resource has no name field of its own.
+ *
+ * Resolves with the host's result: `{ isError: true }` when the host declined
+ * or the user cancelled. Rejects, without sending, when the host did not
+ * advertise the `downloadFile` capability — a host that does not implement the
+ * request may never answer it, and a request has no deadline.
  */
-declare function downloadFile(app: App, filename: string, content: string | Blob, mimeType?: string): void;
+declare function downloadFile(app: App, filename: string, content: string | Blob, mimeType?: string): Promise<McpUiDownloadFileResult>;
+
+/**
+ * Trigger a host-side action.
+ *
+ * Sends a command *to* the host (navigate, open a panel). No-op off a
+ * NimbleBrain host.
+ */
+declare function action(app: App, name: string, params?: Record<string, unknown>): void;
 /**
  * Request one file from the user via the host's native file picker.
  *

package/dist/index.d.ts

@@ -1,18 +1,21 @@
 export { CreateTaskResult, ReadResourceRequest, ReadResourceResult, Task, TaskStatus } from '@modelcontextprotocol/sdk/types.js';
-import { C as ConnectOptions, A as App, R as RequestFileOptions, F as FileResult, a as CallToolAsTaskOptions, T as TaskHandle } from './types-uEO4VFJ2.js';
-export { h as AgentAction, i as AppEventName, B as BuiltinActionType, c as CallToolOptions, D as DataChangedEvent, j as Dimensions, k as FontDisplayValue, g as FontFaceDescriptor, H as HostInfo, K as KeyForwardConfig, M as ModelContext, N as NavigatePayload, l as NotifyPayload, m as TasksCapability, d as Theme, b as ToolCallResult, f as ToolDefinition, e as ToolResultData } from './types-uEO4VFJ2.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-Bf8Q_0dK.js';
+import { C as ConnectOptions, A as App, R as RequestFileOptions, F as FileResult, a as CallToolAsTaskOptions, T as TaskHandle } from './types-CG08aO82.js';
+export { g as AppEventName, D as Dimensions, h as FontDisplayValue, f as FontFaceDescriptor, K as KeyForwardConfig, M as ModelContext, i as TasksCapability, c as Theme, b as ToolCallResult, e as ToolDefinition, d as ToolResultData } from './types-CG08aO82.js';
+import { McpUiDownloadFileResult } from '@modelcontextprotocol/ext-apps';
 export { McpUiHostContext } from '@modelcontextprotocol/ext-apps';
+export { C as ConnectUIOptions, a as HostCapabilities, b as HostKind, c as HostUnsupportedError, d as SYNAPSE_DATA_ELEMENT_ID, e as SynapseUIClient, S as SynapseUITheme, g as connectUI, h as detectHostKind } from './detect-DBwc8a21.js';
 
 /**
  * Connect to an MCP Apps host.
  *
- * The one entry point: owns the ext-apps handshake, theme injection, content
- * parsing, resize management, and event routing, and resolves to a ready
- * {@link App}.
+ * The one entry point. The protocol underneath is the spec's own client,
+ * `@modelcontextprotocol/ext-apps`'s `App`: it owns the transport, the
+ * handshake and the wire schemas. What this adds is the framework on top —
+ * theme injection, the parsed payloads, multi-subscriber events, resize, and
+ * the NimbleBrain extensions — and it resolves to a ready {@link App}.
  *
  * The `App` it returns stays deliberately small. NimbleBrain's own extensions
- * (`action`, the file picker, `downloadFile`) and the MCP tasks utility are
+ * (`action`, the file picker), `downloadFile` and the MCP tasks utility are
  * composable functions over it — import them from the package root.
  */
 declare function connect(options: ConnectOptions): Promise<App>;
@@ -30,21 +33,45 @@ declare function connect(options: ConnectOptions): Promise<App>;
 declare const FONT_FACES_CONTEXT_KEY = "synapse/fontFaces";
 
 /**
- * Trigger a host-side action.
+ * Hand the user a file to save, over the ext-apps `ui/download-file` request.
+ *
+ * A function over {@link App} rather than a method on it, like the helpers in
+ * `extensions.ts` — but unlike them this is spec surface, so it is not gated on
+ * the host identity. Any host that advertises `downloadFile` can answer it.
  *
- * The inverse direction of the `action` event: this sends a command *to* the
- * host (navigate, open a panel), where `app.on("action", …)` receives the ones
- * a tool emits. No-op off a NimbleBrain host.
+ * The bytes always travel embedded. The spec also allows a `ResourceLink`, which
+ * asks the host to fetch a URI the app names; a host holding the user's session
+ * has every reason to refuse that, and the NimbleBrain host does.
  */
-declare function action(app: App, name: string, params?: Record<string, unknown>): void;
+
 /**
  * Hand the user a file to save.
  *
+ * A string is sent as the resource's `text`; a `Blob` is read and sent as
+ * base64 `blob`. Reading a `Blob` is asynchronous, which is why this returns a
+ * promise.
+ *
  * Precedence for the MIME type: the explicit argument, then the Blob's own
  * type, then `application/octet-stream`. An empty-string argument falls
  * through — a `""` MIME is effectively "no type".
+ *
+ * The filename is the last segment of the resource's `file:///` URI, because an
+ * embedded resource has no name field of its own.
+ *
+ * Resolves with the host's result: `{ isError: true }` when the host declined
+ * or the user cancelled. Rejects, without sending, when the host did not
+ * advertise the `downloadFile` capability — a host that does not implement the
+ * request may never answer it, and a request has no deadline.
  */
-declare function downloadFile(app: App, filename: string, content: string | Blob, mimeType?: string): void;
+declare function downloadFile(app: App, filename: string, content: string | Blob, mimeType?: string): Promise<McpUiDownloadFileResult>;
+
+/**
+ * Trigger a host-side action.
+ *
+ * Sends a command *to* the host (navigate, open a panel). No-op off a
+ * NimbleBrain host.
+ */
+declare function action(app: App, name: string, params?: Record<string, unknown>): void;
 /**
  * Request one file from the user via the host's native file picker.
  *

package/dist/index.js

@@ -1,5 +1,37 @@
-export { HostUnsupportedError, SYNAPSE_DATA_ELEMENT_ID, connectUI, detectHostKind } from './chunk-SRQNQ26I.js';
-export { action, callToolAsTask, connect, downloadFile, pickFile, pickFiles } from './chunk-VYR6V47N.js';
-export { FONT_FACES_CONTEXT_KEY } from './chunk-UPDBDXQB.js';
+export { HostUnsupportedError, SYNAPSE_DATA_ELEMENT_ID, connectUI, detectHostKind } from './chunk-OYLZ5OCK.js';
+import { internalsFor } from './chunk-P5DBJFSQ.js';
+export { action, callToolAsTask, connect, pickFile, pickFiles } from './chunk-P5DBJFSQ.js';
+export { FONT_FACES_CONTEXT_KEY } from './chunk-DRLVEHCD.js';
+import './chunk-54W6IAHM.js';
+import './chunk-PZ5AY32C.js';
+import { DOWNLOAD_FILE_METHOD } from '@modelcontextprotocol/ext-apps';
+
+var BASE64_CHUNK = 32768;
+async function downloadFile(app, filename, content, mimeType) {
+  const internals = internalsFor(app);
+  if (internals.hostDownloadFileCapability === void 0) {
+    throw new Error("downloadFile is not supported in this host");
+  }
+  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) };
+  const params = {
+    contents: [{ type: "resource", resource }]
+  };
+  return await internals.request(
+    DOWNLOAD_FILE_METHOD,
+    params
+  );
+}
+async function toBase64(blob) {
+  const bytes = new Uint8Array(await blob.arrayBuffer());
+  let binary = "";
+  for (let i = 0; i < bytes.length; i += BASE64_CHUNK) {
+    binary += String.fromCharCode(...bytes.subarray(i, i + BASE64_CHUNK));
+  }
+  return btoa(binary);
+}
+
+export { downloadFile };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}
+{"version":3,"sources":["../src/download-file.ts"],"names":[],"mappings":";;;;;;;;AAqBA,IAAM,YAAA,GAAe,KAAA;AAqBrB,eAAsB,YAAA,CACpB,GAAA,EACA,QAAA,EACA,OAAA,EACA,QAAA,EACkC;AAClC,EAAA,MAAM,SAAA,GAAY,aAAa,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,IACtB,oBAAA;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.js","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"]}

package/dist/react/index.cjs

@@ -1,7 +1,9 @@
 'use strict';
 
-var chunkFDMRJZKT_cjs = require('../chunk-FDMRJZKT.cjs');
-require('../chunk-TXJMGQYF.cjs');
+var chunkQXDCA7QW_cjs = require('../chunk-QXDCA7QW.cjs');
+require('../chunk-SZWHFTXV.cjs');
+var chunkNP7ROSH2_cjs = require('../chunk-NP7ROSH2.cjs');
+require('../chunk-Q7SFCCGT.cjs');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
@@ -13,7 +15,7 @@ function AppProvider({ children, ...options }) {
   react.useEffect(() => {
     if (connectingRef.current) return;
     connectingRef.current = true;
-    chunkFDMRJZKT_cjs.connect(options).then(setApp, (err) => {
+    chunkQXDCA7QW_cjs.connect(options).then(setApp, (err) => {
       setError(err instanceof Error ? err : new Error(String(err)));
     });
   }, []);
@@ -78,12 +80,12 @@ function useCallTool(toolName) {
   const [data, setData] = react.useState(null);
   const callIdRef = react.useRef(0);
   const call = react.useCallback(
-    async (args, options) => {
+    async (args) => {
       const id = ++callIdRef.current;
       setIsPending(true);
       setError(null);
       try {
-        const result = await app.callTool(toolName, args, options);
+        const result = await app.callTool(toolName, args);
         if (id === callIdRef.current) {
           setData(result.data);
           setIsPending(false);
@@ -107,7 +109,7 @@ function useDataSync(callback) {
   const callbackRef = react.useRef(callback);
   callbackRef.current = callback;
   react.useEffect(() => {
-    return app.on("data-changed", (event) => callbackRef.current(event));
+    return app.on(chunkNP7ROSH2_cjs.RESOURCE_LIST_CHANGED_METHOD, (params) => callbackRef.current(params ?? {}));
   }, [app]);
 }
 var MODEL_CONTEXT_DEBOUNCE_MS = 250;
@@ -148,7 +150,7 @@ function useSendMessage() {
 function useAction() {
   const app = useAppContext();
   return react.useCallback(
-    (name, params) => chunkFDMRJZKT_cjs.action(app, name, params),
+    (name, params) => chunkQXDCA7QW_cjs.action(app, name, params),
     [app]
   );
 }
@@ -159,7 +161,7 @@ function useFileUpload() {
     async (options) => {
       setIsPending(true);
       try {
-        return await chunkFDMRJZKT_cjs.pickFile(app, options);
+        return await chunkQXDCA7QW_cjs.pickFile(app, options);
       } finally {
         setIsPending(false);
       }
@@ -170,7 +172,7 @@ function useFileUpload() {
     async (options) => {
       setIsPending(true);
       try {
-        return await chunkFDMRJZKT_cjs.pickFiles(app, options);
+        return await chunkQXDCA7QW_cjs.pickFiles(app, options);
       } finally {
         setIsPending(false);
       }
@@ -255,7 +257,7 @@ function useCallToolAsTask(toolName) {
       refreshFailureCountRef.current = 0;
       let handle;
       try {
-        handle = await chunkFDMRJZKT_cjs.callToolAsTask(app, toolName, args, options);
+        handle = await chunkQXDCA7QW_cjs.callToolAsTask(app, toolName, args, options);
       } catch (err) {
         if (gen !== genRef.current) throw err;
         const e = err instanceof Error ? err : new Error(String(err));