@nimblebrain/synapse 0.18.0 → 0.20.0

package/dist/index.d.cts

@@ -1,60 +1,132 @@
 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-BxPfGHKO.cjs';
+export { f as AppEventName, D as Dimensions, K as KeyForwardConfig, M as ModelContext, g as TasksCapability, c as Theme, b as ToolCallResult, e as ToolDefinition, d as ToolResultData } from './types-BxPfGHKO.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, T as ToolCallError, g as connectUI, h as detectHostKind } from './detect-DVGaL2bH.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>;
 
 /**
- * Host-context key carrying `@font-face` descriptors.
- *
- * A NimbleBrain extension (`synapse/` prefix), because the ext-apps spec has no
- * equivalent: `styles.variables` is a flat `Record<McpUiStyleVariableKey, string>`
- * that can name a font family but cannot carry the rule that loads it.
- * `McpUiHostContext` declares `[key: string]: unknown` for forward
- * compatibility, so riding an extra key is spec-legal, and hosts that don't send
- * it degrade to the web-safe token fallbacks.
- */
-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.
  *
- * 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.
+ * 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 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 with `HostCapabilityError`, without sending,
+ * when the host did not declare `downloadFile` — 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): Promise<McpUiDownloadFileResult>;
+
+/**
+ * Thrown when an app asks for something the host did not declare in
+ * `ui/initialize`.
+ *
+ * The request is never sent. A host that does not implement a request may never
+ * answer it, and this SDK's requests carry no deadline, so sending anyway would
+ * leave the caller waiting forever rather than failing.
+ *
+ * `capability` names what was missing, as the host would have declared it: a
+ * `hostCapabilities` field (`serverTools`, `downloadFile`) or an extension
+ * identifier (`ai.nimblebrain/request-file`, `io.modelcontextprotocol/tasks`).
+ */
+declare class HostCapabilityError extends Error {
+    readonly capability: string;
+    constructor(feature: string, capability: string);
+}
+
+/**
+ * The NimbleBrain host extensions. This is the complete list; anything else an
+ * app sends is spec.
+ *
+ * Each extension has one name, used both as its method and as the identifier a
+ * host declares in `hostCapabilities.experimental` to offer it. The ext-apps
+ * host capability type has no field for extensions, and a spec client parses
+ * the `ui/initialize` result against that type, so `experimental` is the one
+ * slot whose contents reach the app. The MCP tasks capability travels the same
+ * way, for the same reason.
+ *
+ * The gate is the declaration, not the host's name. A host that implements an
+ * extension says so; a host that does not is never sent it.
+ */
+declare const NIMBLEBRAIN_EXTENSIONS: {
+    /** App → host notification: run a host action (navigate, open a panel). */
+    readonly action: {
+        readonly method: "ai.nimblebrain/action";
+        readonly capability: "ai.nimblebrain/action";
+    };
+    /** App → host request: the host's file picker, answered `{ files }`. */
+    readonly requestFile: {
+        readonly method: "ai.nimblebrain/request-file";
+        readonly capability: "ai.nimblebrain/request-file";
+    };
+    /** App → host notification: a keyboard shortcut pressed inside the frame. */
+    readonly keydown: {
+        readonly method: "ai.nimblebrain/keydown";
+        readonly capability: "ai.nimblebrain/keydown";
+    };
+};
+type NimbleBrainExtension = keyof typeof NIMBLEBRAIN_EXTENSIONS;
+
+/**
+ * Whether the host declared a NimbleBrain extension. Use it to decide what to
+ * offer, e.g. to hide an upload button on a host with no file picker.
  */
-declare function downloadFile(app: App, filename: string, content: string | Blob, mimeType?: string): void;
+declare function hostSupports(app: App, extension: NimbleBrainExtension): boolean;
+/**
+ * Trigger a host-side action.
+ *
+ * Sends a command *to* the host (navigate, open a panel). A no-op when the host
+ * did not declare `ai.nimblebrain/action`.
+ */
+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.
  *
- * Resolves `null` if the user cancels. Throws off a NimbleBrain host.
+ * Resolves `null` if the user cancels. Rejects with `HostCapabilityError` when
+ * the host did not declare `ai.nimblebrain/request-file`.
  */
 declare function pickFile(app: App, options?: RequestFileOptions): Promise<FileResult | null>;
 /**
  * Request several files from the user.
  *
- * Resolves `[]` if the user cancels. Throws off a NimbleBrain host.
+ * Resolves `[]` if the user cancels. Rejects with `HostCapabilityError` when
+ * the host did not declare `ai.nimblebrain/request-file`.
  */
 declare function pickFiles(app: App, options?: RequestFileOptions): Promise<FileResult[]>;
 
@@ -72,10 +144,11 @@ declare function pickFiles(app: App, options?: RequestFileOptions): Promise<File
  * const result = await handle.result();
  * ```
  *
- * Throws if the host did not advertise `tasks.requests.tools.call` — per spec
- * a requestor MUST NOT task-augment without matching receiver capability.
- * Fall back to `app.callTool`.
+ * Rejects with `HostCapabilityError` if the host did not advertise
+ * `tasks.requests.tools.call` — per spec a requestor MUST NOT task-augment
+ * without matching receiver capability. Check `app.supportsTasks` first, and
+ * fall back to `app.callTool`.
  */
 declare function callToolAsTask<TOutput = unknown>(app: App, toolName: string, args?: unknown, options?: CallToolAsTaskOptions): Promise<TaskHandle<TOutput>>;
 
-export { App, CallToolAsTaskOptions, ConnectOptions, FONT_FACES_CONTEXT_KEY, FileResult, RequestFileOptions, TaskHandle, action, callToolAsTask, connect, downloadFile, pickFile, pickFiles };
+export { App, CallToolAsTaskOptions, ConnectOptions, FileResult, HostCapabilityError, NIMBLEBRAIN_EXTENSIONS, type NimbleBrainExtension, RequestFileOptions, TaskHandle, action, callToolAsTask, connect, downloadFile, hostSupports, pickFile, pickFiles };

package/dist/index.d.ts

@@ -1,60 +1,132 @@
 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-BxPfGHKO.js';
+export { f as AppEventName, D as Dimensions, K as KeyForwardConfig, M as ModelContext, g as TasksCapability, c as Theme, b as ToolCallResult, e as ToolDefinition, d as ToolResultData } from './types-BxPfGHKO.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, T as ToolCallError, g as connectUI, h as detectHostKind } from './detect-DVGaL2bH.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>;
 
 /**
- * Host-context key carrying `@font-face` descriptors.
- *
- * A NimbleBrain extension (`synapse/` prefix), because the ext-apps spec has no
- * equivalent: `styles.variables` is a flat `Record<McpUiStyleVariableKey, string>`
- * that can name a font family but cannot carry the rule that loads it.
- * `McpUiHostContext` declares `[key: string]: unknown` for forward
- * compatibility, so riding an extra key is spec-legal, and hosts that don't send
- * it degrade to the web-safe token fallbacks.
- */
-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.
  *
- * 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.
+ * 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 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 with `HostCapabilityError`, without sending,
+ * when the host did not declare `downloadFile` — 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): Promise<McpUiDownloadFileResult>;
+
+/**
+ * Thrown when an app asks for something the host did not declare in
+ * `ui/initialize`.
+ *
+ * The request is never sent. A host that does not implement a request may never
+ * answer it, and this SDK's requests carry no deadline, so sending anyway would
+ * leave the caller waiting forever rather than failing.
+ *
+ * `capability` names what was missing, as the host would have declared it: a
+ * `hostCapabilities` field (`serverTools`, `downloadFile`) or an extension
+ * identifier (`ai.nimblebrain/request-file`, `io.modelcontextprotocol/tasks`).
+ */
+declare class HostCapabilityError extends Error {
+    readonly capability: string;
+    constructor(feature: string, capability: string);
+}
+
+/**
+ * The NimbleBrain host extensions. This is the complete list; anything else an
+ * app sends is spec.
+ *
+ * Each extension has one name, used both as its method and as the identifier a
+ * host declares in `hostCapabilities.experimental` to offer it. The ext-apps
+ * host capability type has no field for extensions, and a spec client parses
+ * the `ui/initialize` result against that type, so `experimental` is the one
+ * slot whose contents reach the app. The MCP tasks capability travels the same
+ * way, for the same reason.
+ *
+ * The gate is the declaration, not the host's name. A host that implements an
+ * extension says so; a host that does not is never sent it.
+ */
+declare const NIMBLEBRAIN_EXTENSIONS: {
+    /** App → host notification: run a host action (navigate, open a panel). */
+    readonly action: {
+        readonly method: "ai.nimblebrain/action";
+        readonly capability: "ai.nimblebrain/action";
+    };
+    /** App → host request: the host's file picker, answered `{ files }`. */
+    readonly requestFile: {
+        readonly method: "ai.nimblebrain/request-file";
+        readonly capability: "ai.nimblebrain/request-file";
+    };
+    /** App → host notification: a keyboard shortcut pressed inside the frame. */
+    readonly keydown: {
+        readonly method: "ai.nimblebrain/keydown";
+        readonly capability: "ai.nimblebrain/keydown";
+    };
+};
+type NimbleBrainExtension = keyof typeof NIMBLEBRAIN_EXTENSIONS;
+
+/**
+ * Whether the host declared a NimbleBrain extension. Use it to decide what to
+ * offer, e.g. to hide an upload button on a host with no file picker.
  */
-declare function downloadFile(app: App, filename: string, content: string | Blob, mimeType?: string): void;
+declare function hostSupports(app: App, extension: NimbleBrainExtension): boolean;
+/**
+ * Trigger a host-side action.
+ *
+ * Sends a command *to* the host (navigate, open a panel). A no-op when the host
+ * did not declare `ai.nimblebrain/action`.
+ */
+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.
  *
- * Resolves `null` if the user cancels. Throws off a NimbleBrain host.
+ * Resolves `null` if the user cancels. Rejects with `HostCapabilityError` when
+ * the host did not declare `ai.nimblebrain/request-file`.
  */
 declare function pickFile(app: App, options?: RequestFileOptions): Promise<FileResult | null>;
 /**
  * Request several files from the user.
  *
- * Resolves `[]` if the user cancels. Throws off a NimbleBrain host.
+ * Resolves `[]` if the user cancels. Rejects with `HostCapabilityError` when
+ * the host did not declare `ai.nimblebrain/request-file`.
  */
 declare function pickFiles(app: App, options?: RequestFileOptions): Promise<FileResult[]>;
 
@@ -72,10 +144,11 @@ declare function pickFiles(app: App, options?: RequestFileOptions): Promise<File
  * const result = await handle.result();
  * ```
  *
- * Throws if the host did not advertise `tasks.requests.tools.call` — per spec
- * a requestor MUST NOT task-augment without matching receiver capability.
- * Fall back to `app.callTool`.
+ * Rejects with `HostCapabilityError` if the host did not advertise
+ * `tasks.requests.tools.call` — per spec a requestor MUST NOT task-augment
+ * without matching receiver capability. Check `app.supportsTasks` first, and
+ * fall back to `app.callTool`.
  */
 declare function callToolAsTask<TOutput = unknown>(app: App, toolName: string, args?: unknown, options?: CallToolAsTaskOptions): Promise<TaskHandle<TOutput>>;
 
-export { App, CallToolAsTaskOptions, ConnectOptions, FONT_FACES_CONTEXT_KEY, FileResult, RequestFileOptions, TaskHandle, action, callToolAsTask, connect, downloadFile, pickFile, pickFiles };
+export { App, CallToolAsTaskOptions, ConnectOptions, FileResult, HostCapabilityError, NIMBLEBRAIN_EXTENSIONS, type NimbleBrainExtension, RequestFileOptions, TaskHandle, action, callToolAsTask, connect, downloadFile, hostSupports, pickFile, pickFiles };

package/dist/index.js

@@ -1,5 +1,36 @@
-export { HostUnsupportedError, SYNAPSE_DATA_ELEMENT_ID, connectUI, detectHostKind } from './chunk-ZLASWV4N.js';
-export { action, callToolAsTask, connect, downloadFile, pickFile, pickFiles } from './chunk-3YSXPBEQ.js';
-export { FONT_FACES_CONTEXT_KEY } from './chunk-HKRTDGXN.js';
+export { HostUnsupportedError, SYNAPSE_DATA_ELEMENT_ID, ToolCallError, connectUI, detectHostKind } from './chunk-UKP4W6DI.js';
+import { HostCapabilityError, internalsFor } from './chunk-TR2YNWZ5.js';
+export { HostCapabilityError, action, callToolAsTask, connect, hostSupports, pickFile, pickFiles } from './chunk-TR2YNWZ5.js';
+import './chunk-DJS2FKBN.js';
+export { NIMBLEBRAIN_EXTENSIONS } from './chunk-H3INUKA3.js';
+import { DOWNLOAD_FILE_METHOD } from '@modelcontextprotocol/ext-apps';
+
+var BASE64_CHUNK = 32768;
+async function downloadFile(app, filename, content, mimeType) {
+  if (!app.hostCapabilities.downloadFile) {
+    throw new HostCapabilityError("downloadFile", "downloadFile");
+  }
+  const internals = 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) };
+  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":";;;;;;;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,IAAI,mBAAA,CAAoB,cAAA,EAAgB,cAAc,CAAA;AAAA,EAC9D;AACA,EAAA,MAAM,SAAA,GAAY,aAAa,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,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 { 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"]}

package/dist/react/index.cjs

@@ -1,7 +1,8 @@
 'use strict';
 
-var chunkFB7GPBEM_cjs = require('../chunk-FB7GPBEM.cjs');
-require('../chunk-LPWEQCZV.cjs');
+var chunkHQLSVUOR_cjs = require('../chunk-HQLSVUOR.cjs');
+require('../chunk-YSL7KJNU.cjs');
+var chunkISV6HFQE_cjs = require('../chunk-ISV6HFQE.cjs');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
@@ -13,7 +14,7 @@ function AppProvider({ children, ...options }) {
   react.useEffect(() => {
     if (connectingRef.current) return;
     connectingRef.current = true;
-    chunkFB7GPBEM_cjs.connect(options).then(setApp, (err) => {
+    chunkHQLSVUOR_cjs.connect(options).then(setApp, (err) => {
       setError(err instanceof Error ? err : new Error(String(err)));
     });
   }, []);
@@ -78,12 +79,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 +108,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(chunkISV6HFQE_cjs.RESOURCE_LIST_CHANGED_METHOD, (params) => callbackRef.current(params ?? {}));
   }, [app]);
 }
 var MODEL_CONTEXT_DEBOUNCE_MS = 250;
@@ -148,7 +149,7 @@ function useSendMessage() {
 function useAction() {
   const app = useAppContext();
   return react.useCallback(
-    (name, params) => chunkFB7GPBEM_cjs.action(app, name, params),
+    (name, params) => chunkHQLSVUOR_cjs.action(app, name, params),
     [app]
   );
 }
@@ -159,7 +160,7 @@ function useFileUpload() {
     async (options) => {
       setIsPending(true);
       try {
-        return await chunkFB7GPBEM_cjs.pickFile(app, options);
+        return await chunkHQLSVUOR_cjs.pickFile(app, options);
       } finally {
         setIsPending(false);
       }
@@ -170,7 +171,7 @@ function useFileUpload() {
     async (options) => {
       setIsPending(true);
       try {
-        return await chunkFB7GPBEM_cjs.pickFiles(app, options);
+        return await chunkHQLSVUOR_cjs.pickFiles(app, options);
       } finally {
         setIsPending(false);
       }
@@ -255,7 +256,7 @@ function useCallToolAsTask(toolName) {
       refreshFailureCountRef.current = 0;
       let handle;
       try {
-        handle = await chunkFB7GPBEM_cjs.callToolAsTask(app, toolName, args, options);
+        handle = await chunkHQLSVUOR_cjs.callToolAsTask(app, toolName, args, options);
       } catch (err) {
         if (gen !== genRef.current) throw err;
         const e = err instanceof Error ? err : new Error(String(err));