@darqlabs/curator-sdk-react 0.6.1 → 0.7.0

package/dist/cjs/mcpApps/hostBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostBridge.d.ts","sourceRoot":"","sources":["../../../src/mcpApps/hostBridge.ts"],"names":[],"mappings":"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"}

package/dist/cjs/mcpApps/hostBridge.js

@@ -0,0 +1,306 @@
+"use strict";
+/**
+ * Host side of the MCP Apps (SEP-1865) bridge: JSON-RPC 2.0 over a message
+ * transport, from the widget to one rendered view.
+ *
+ * Pure. Knows nothing about React, iframes or the network: the caller hands
+ * it a `post` function to reach the view and feeds it every message the view
+ * sends. Everything the view may ask for is a `handlers` callback, so the
+ * whole protocol can be exercised in a unit test with a fake view.
+ *
+ * What the view may do, and what this bridge does with it:
+ *
+ *   ui/initialize                   → handshake; answers with host info,
+ *                                     capabilities and context
+ *   ui/notifications/initialized    → view is ready; deliver the tool input,
+ *                                     then the tool result once known
+ *   tools/call                      → handlers.callTool (the Curator data plane)
+ *   ui/message                      → handlers.sendMessage (app-reported text)
+ *   ui/update-model-context         → handlers.updateModelContext (surfaced only)
+ *   ui/open-link                    → handlers.openLink (http(s) only)
+ *   ui/request-display-mode         → always `inline` in v1
+ *   ui/notifications/size-changed   → handlers.onSizeChange
+ *   notifications/message           → handlers.onLog
+ *   ping                            → {}
+ *   anything else                   → JSON-RPC "method not found"
+ *
+ * Method names are the ones ext-apps 2.0 emits (`ui/…`). The deprecated
+ * `notifications/…` spellings assistant-ui also accepts are NOT supported:
+ * fewer names to reason about, and our reference view uses the current SDK.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpAppHostBridge = exports.MCP_APPS_PROTOCOL_VERSION = void 0;
+exports.extractMessageText = extractMessageText;
+exports.isOpenableUrl = isOpenableUrl;
+exports.MCP_APPS_PROTOCOL_VERSION = "2026-01-26";
+const ERR = { invalidRequest: -32600, methodNotFound: -32601, invalidParams: -32602, internal: -32603 };
+const DEFAULT_MAX_MESSAGE_CHARS = 2048;
+// Control characters except tab / newline / carriage return.
+// eslint-disable-next-line no-control-regex
+const CONTROL_CHARS = /[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/g;
+function isRecord(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+/**
+ * The text of a spec-shaped `ui/message`: `{ role, content: [{type:"text", text}] }`.
+ * Also accepts a bare `{ text }` for lenient views. Control characters are
+ * stripped and the length capped; the result is plain text, never markup.
+ */
+function extractMessageText(params, maxChars = DEFAULT_MAX_MESSAGE_CHARS) {
+    if (!isRecord(params))
+        return null;
+    let text = null;
+    if (Array.isArray(params.content)) {
+        text = params.content
+            .filter((c) => isRecord(c) && c.type === "text" && typeof c.text === "string")
+            .map((c) => c.text)
+            .join("\n");
+    }
+    else if (typeof params.text === "string") {
+        text = params.text;
+    }
+    if (text === null)
+        return null;
+    const clean = text.replace(CONTROL_CHARS, "").slice(0, maxChars).trim();
+    return clean.length > 0 ? clean : null;
+}
+/** Only web links leave the sandbox. */
+function isOpenableUrl(url) {
+    if (typeof url !== "string")
+        return false;
+    try {
+        const u = new URL(url);
+        return u.protocol === "https:" || u.protocol === "http:";
+    }
+    catch {
+        return false;
+    }
+}
+class McpAppHostBridge {
+    post;
+    handlers;
+    hostInfo;
+    hostContext;
+    maxMessageChars;
+    initialized = false;
+    closed = false;
+    nextId = 1;
+    pending = new Map();
+    /** Tool input, delivered on `initialized` (or immediately when already ready). */
+    toolInput;
+    toolInputSent = false;
+    /** Tool result, delivered after input once known. */
+    toolResult;
+    toolResultSent = false;
+    constructor(opts) {
+        this.post = opts.post;
+        this.handlers = opts.handlers;
+        this.hostInfo = opts.hostInfo ?? { name: "Curator", version: "1" };
+        this.hostContext = {
+            platform: "web",
+            displayMode: "inline",
+            availableDisplayModes: ["inline"],
+            ...opts.hostContext,
+        };
+        this.maxMessageChars = opts.maxMessageChars ?? DEFAULT_MAX_MESSAGE_CHARS;
+    }
+    get isInitialized() {
+        return this.initialized;
+    }
+    // ── host → view ─────────────────────────────────────────────────────────
+    setToolInput(args) {
+        this.toolInput = args;
+        this.flush();
+    }
+    setToolResult(result) {
+        this.toolResult = result;
+        this.flush();
+    }
+    notifyToolCancelled(reason) {
+        this.notify("ui/notifications/tool-cancelled", { reason });
+    }
+    updateHostContext(patch) {
+        this.hostContext = { ...this.hostContext, ...patch };
+        if (this.initialized)
+            this.notify("ui/notifications/host-context-changed", patch);
+    }
+    /** Ask the view to tear down; resolves when it answers or after `timeoutMs`. */
+    async teardown(timeoutMs = 500) {
+        if (this.closed)
+            return;
+        if (this.initialized) {
+            await Promise.race([
+                this.request("ui/resource-teardown", {}).catch(() => undefined),
+                new Promise((r) => setTimeout(r, timeoutMs)),
+            ]);
+        }
+        this.close();
+    }
+    close() {
+        this.closed = true;
+        for (const p of this.pending.values())
+            p.reject(new Error("bridge closed"));
+        this.pending.clear();
+    }
+    // ── view → host ─────────────────────────────────────────────────────────
+    /** Feed one message received from the view. Non-JSON-RPC traffic is ignored. */
+    onMessage(data) {
+        if (this.closed || !isRecord(data) || data.jsonrpc !== "2.0")
+            return;
+        if ("method" in data && typeof data.method === "string") {
+            if ("id" in data && (typeof data.id === "string" || typeof data.id === "number")) {
+                void this.handleRequest(data);
+            }
+            else {
+                this.handleNotification(data);
+            }
+            return;
+        }
+        if ("id" in data && (typeof data.id === "string" || typeof data.id === "number")) {
+            const pending = this.pending.get(data.id);
+            if (!pending)
+                return;
+            this.pending.delete(data.id);
+            const res = data;
+            if (res.error)
+                pending.reject(new Error(res.error.message));
+            else
+                pending.resolve(res.result);
+        }
+    }
+    async handleRequest(req) {
+        const params = isRecord(req.params) ? req.params : {};
+        try {
+            switch (req.method) {
+                case "ui/initialize": {
+                    const requested = typeof params.protocolVersion === "string" ? params.protocolVersion : exports.MCP_APPS_PROTOCOL_VERSION;
+                    this.respond(req.id, {
+                        protocolVersion: requested,
+                        hostInfo: this.hostInfo,
+                        hostCapabilities: {
+                            openLinks: {},
+                            serverTools: {},
+                            message: { text: {} },
+                            updateModelContext: { text: {}, structuredContent: {} },
+                            logging: {},
+                        },
+                        hostContext: this.hostContext,
+                    });
+                    return;
+                }
+                case "ping":
+                    this.respond(req.id, {});
+                    return;
+                case "tools/call": {
+                    if (typeof params.name !== "string" || !params.name) {
+                        this.error(req.id, ERR.invalidParams, "`name` is required");
+                        return;
+                    }
+                    const args = isRecord(params.arguments) ? params.arguments : {};
+                    const meta = isRecord(params._meta) ? params._meta : undefined;
+                    const result = await this.handlers.callTool({
+                        name: params.name,
+                        arguments: args,
+                        ...(meta ? { _meta: meta } : {}),
+                    });
+                    this.respond(req.id, result);
+                    return;
+                }
+                case "ui/message": {
+                    const text = extractMessageText(params, this.maxMessageChars);
+                    if (!text) {
+                        this.error(req.id, ERR.invalidParams, "ui/message needs text content");
+                        return;
+                    }
+                    const accepted = await this.handlers.sendMessage(text);
+                    this.respond(req.id, accepted ? {} : { isError: true });
+                    return;
+                }
+                case "ui/update-model-context": {
+                    this.handlers.updateModelContext?.({
+                        content: params.content,
+                        structuredContent: params.structuredContent,
+                    });
+                    this.respond(req.id, {});
+                    return;
+                }
+                case "ui/open-link": {
+                    const ok = isOpenableUrl(params.url) && (this.handlers.openLink?.(params.url) ?? false);
+                    this.respond(req.id, ok ? {} : { isError: true });
+                    return;
+                }
+                case "ui/request-display-mode":
+                    // Inline only in v1; the host has final authority per spec.
+                    this.respond(req.id, { mode: "inline" });
+                    return;
+                default:
+                    this.error(req.id, ERR.methodNotFound, `${req.method} is not supported by this host`);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            this.handlers.onError?.(err instanceof Error ? err : new Error(message));
+            // A refused/failed tool call is still a well-formed JSON-RPC error; the
+            // view decides how to show it.
+            this.error(req.id, ERR.internal, message);
+        }
+    }
+    handleNotification(n) {
+        const params = isRecord(n.params) ? n.params : {};
+        switch (n.method) {
+            case "ui/notifications/initialized":
+                this.initialized = true;
+                this.handlers.onInitialized?.();
+                this.flush();
+                return;
+            case "ui/notifications/size-changed":
+                this.handlers.onSizeChange?.({
+                    ...(typeof params.width === "number" ? { width: params.width } : {}),
+                    ...(typeof params.height === "number" ? { height: params.height } : {}),
+                });
+                return;
+            case "notifications/message":
+                this.handlers.onLog?.(params);
+                return;
+            default:
+                return;
+        }
+    }
+    // ── plumbing ────────────────────────────────────────────────────────────
+    flush() {
+        if (!this.initialized || this.closed)
+            return;
+        if (this.toolInput !== undefined && !this.toolInputSent) {
+            this.notify("ui/notifications/tool-input", { arguments: this.toolInput });
+            this.toolInputSent = true;
+        }
+        if (this.toolResult !== undefined && !this.toolResultSent) {
+            this.notify("ui/notifications/tool-result", this.toolResult);
+            this.toolResultSent = true;
+        }
+    }
+    notify(method, params) {
+        if (this.closed)
+            return;
+        this.post({ jsonrpc: "2.0", method, params });
+    }
+    request(method, params) {
+        const id = this.nextId++;
+        return new Promise((resolve, reject) => {
+            this.pending.set(id, { resolve, reject });
+            this.post({ jsonrpc: "2.0", id, method, params });
+        });
+    }
+    respond(id, result) {
+        if (this.closed)
+            return;
+        this.post({ jsonrpc: "2.0", id, result });
+    }
+    error(id, code, message) {
+        if (this.closed)
+            return;
+        this.post({ jsonrpc: "2.0", id, error: { code, message } });
+    }
+}
+exports.McpAppHostBridge = McpAppHostBridge;
+//# sourceMappingURL=hostBridge.js.map

package/dist/cjs/mcpApps/hostBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostBridge.js","sourceRoot":"","sources":["../../../src/mcpApps/hostBridge.ts"],"names":[],"mappings":"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"}

package/dist/esm/CuratorAdapter.d.ts

@@ -19,7 +19,33 @@
  */
 import type { CuratorAttachmentAdapter } from "./CuratorAttachmentAdapter.js";
 import type { ChatModelAdapter } from "@assistant-ui/react";
-import type { AssistantMessage, Chat, CuratorError, StreamState, StreamPlanProgress } from "@darqlabs/curator-sdk";
+import type { AssistantMessage, Chat, CuratorError, McpCallToolResult, StreamState, StreamPlanProgress } from "@darqlabs/curator-sdk";
+/**
+ * A tool-call part as assistant-ui renders it. `mcp.app.serverId` carries the
+ * Curator APP SESSION, not a server id: it is the opaque routing key the view
+ * renderer threads through every data-plane call, and a session is exactly
+ * "which server, which tool call, for whom".
+ */
+/** JSON as assistant-ui types a tool call's arguments. Stream arguments ARE JSON (they were parsed from it). */
+export type JsonValue = string | number | boolean | null | readonly JsonValue[] | JsonObject;
+export type JsonObject = {
+    readonly [k: string]: JsonValue;
+};
+export interface McpAppToolCallPart {
+    type: "tool-call";
+    toolCallId: string;
+    toolName: string;
+    args: JsonObject;
+    argsText: string;
+    result?: McpCallToolResult;
+    isError?: boolean;
+    mcp: {
+        app: {
+            resourceUri: string;
+            serverId: string;
+        };
+    };
+}
 export interface CuratorAdapterCallbacks {
     /** Fired once per successfully-returned assistant message. */
     onMessage?: (message: AssistantMessage) => void;

package/dist/esm/CuratorAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CuratorAdapter.d.ts","sourceRoot":"","sources":["../../src/CuratorAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAA;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,qBAAqB,CAAA;AAC/E,OAAO,KAAK,EACV,gBAAgB,EAChB,IAAI,EACJ,YAAY,EACZ,WAAW,EACX,kBAAkB,EACnB,MAAM,uBAAuB,CAAA;AAE9B,MAAM,WAAW,uBAAuB;IACtC,8DAA8D;IAC9D,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAA;IAC/C;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;IACtC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,CAAA;IACvD,gEAAgE;IAChE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,GAAG,KAAK,KAAK,IAAI,CAAA;CAChD;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,IAAI,EACV,SAAS,GAAE,uBAA4B;AACvC;;;;GAIG;AACH,WAAW,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,gBAAgB,CAAC,GAC7D,gBAAgB,CA4KlB"}
+{"version":3,"file":"CuratorAdapter.d.ts","sourceRoot":"","sources":["../../src/CuratorAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAA;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,qBAAqB,CAAA;AAC/E,OAAO,KAAK,EACV,gBAAgB,EAChB,IAAI,EACJ,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,kBAAkB,EACnB,MAAM,uBAAuB,CAAA;AAG9B;;;;;GAKG;AACH,gHAAgH;AAChH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,SAAS,EAAE,GAAG,UAAU,CAAA;AAC5F,MAAM,MAAM,UAAU,GAAG;IAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AAE5D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,WAAW,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,iBAAiB,CAAA;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,GAAG,EAAE;QAAE,GAAG,EAAE;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAA;CACxD;AAKD,MAAM,WAAW,uBAAuB;IACtC,8DAA8D;IAC9D,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAA;IAC/C;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;IACtC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,CAAA;IACvD,gEAAgE;IAChE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,GAAG,KAAK,KAAK,IAAI,CAAA;CAChD;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,IAAI,EACV,SAAS,GAAE,uBAA4B;AACvC;;;;GAIG;AACH,WAAW,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,gBAAgB,CAAC,GAC7D,gBAAgB,CAyPlB"}

package/dist/esm/CuratorAdapter.js

@@ -17,6 +17,7 @@
  * mounted CuratorChat / launcher panel) so multi-turn context stays
  * intact across runs.
  */
+import { APP_SESSION_METADATA_KEY } from "./mcpApps/McpAppContext.js";
 export function createCuratorAdapter(chat, callbacks = {}, 
 /**
  * Supplies the storage references for this turn's attachments. Absent when
@@ -30,6 +31,11 @@ attachments) {
             const files = attachments
                 ? attachments.takeReferences(latestUserAttachmentIds(messages))
                 : [];
+            // MCP Apps: a turn a rendered VIEW sent (`ui/message`). The session it was
+            // rendered under rides on the message metadata and goes to the server as
+            // `app_session`, which validates it and stores the row with a `source`
+            // marker — the record says a view sent it, never that a person typed it.
+            const appSession = latestUserAppSession(messages);
             // A file with no caption is a complete message — the SDK accepts content
             // OR files, and a bill of lading dropped in with nothing typed is the
             // single most common way this widget is used. Returning early on empty
@@ -46,16 +52,41 @@ attachments) {
             // then `done` (whose message is the terminal reply ALONE) replaced the
             // whole thing — so the user watched a paragraph appear and then get
             // overwritten by different text. Segments keep every token the user saw.
-            const segments = [];
+            // Ordered list of settled parts — text segments and MCP App tool-call
+            // parts interleaved in arrival order — plus the in-flight text.
+            const settled = [];
+            /** Live tool-call parts by id, so completed/failed can update in place. */
+            const appParts = new Map();
             let acc = "";
-            /** Completed segments plus the in-flight one, as assistant-ui parts. */
+            /** Settled parts plus the in-flight text, as assistant-ui parts. */
             const partsWith = (trailing) => {
-                const texts = [...segments, trailing].filter((t) => t.length > 0);
+                const out = [...settled];
+                if (trailing.length > 0)
+                    out.push({ type: "text", text: trailing });
                 // assistant-ui expects at least one part; an empty run yields empty text.
-                return (texts.length > 0 ? texts : [""]).map((text) => ({
-                    type: "text",
-                    text,
-                }));
+                return out.length > 0 ? out : [{ type: "text", text: "" }];
+            };
+            /** Settle the in-flight text as its own segment, if there is any. */
+            const settleText = () => {
+                if (acc.trim().length > 0)
+                    settled.push({ type: "text", text: acc });
+                acc = "";
+            };
+            /**
+             * A view whose call never got a terminal event would spin forever. Give
+             * every unresolved app part a valid error result so the frame receives a
+             * terminal tool-result.
+             */
+            const interruptUnresolvedApps = (text) => {
+                for (const [id, p] of appParts) {
+                    if (p.result !== undefined)
+                        continue;
+                    const updated = { ...p, isError: true, result: { isError: true, content: [{ type: "text", text }] } };
+                    appParts.set(id, updated);
+                    const idx = settled.indexOf(p);
+                    if (idx >= 0)
+                        settled[idx] = updated;
+                }
             };
             try {
                 // The options object is now always passed, including when there are no
@@ -70,9 +101,11 @@ attachments) {
                 // the local stream and left the agent running to completion — burning
                 // tokens for a reply nobody would ever see. Checking an abort is not
                 // the same as acting on it.
-                const stream = files.length
-                    ? chat.stream(userText, { files, signal: abortSignal })
-                    : chat.stream(userText, { signal: abortSignal });
+                const stream = chat.stream(userText, {
+                    ...(files.length ? { files } : {}),
+                    ...(appSession ? { appSession } : {}),
+                    signal: abortSignal,
+                });
                 for await (const event of stream) {
                     if (abortSignal.aborted)
                         return;
@@ -89,14 +122,58 @@ attachments) {
                         // Turn boundary: anything streamed before this belongs to the turn
                         // that decided to call a tool. Settle it so the next turn's tokens
                         // start a new part instead of extending someone else's sentence.
-                        if (acc.trim().length > 0) {
-                            segments.push(acc);
-                            acc = "";
+                        // (Whitespace-only narration is dropped by settleText.)
+                        const hadText = acc.trim().length > 0;
+                        settleText();
+                        // MCP Apps: a call that renders a view becomes a tool-call part.
+                        // Only when the server minted a session for it — a plain tool call
+                        // stays what it always was, a boundary and nothing rendered.
+                        if (event.app) {
+                            const partForApp = {
+                                type: "tool-call",
+                                toolCallId: event.toolCallId,
+                                toolName: event.toolName,
+                                args: (event.arguments ?? {}),
+                                argsText: JSON.stringify(event.arguments ?? {}),
+                                mcp: { app: { resourceUri: event.app.resourceUri, serverId: event.app.session } },
+                            };
+                            appParts.set(event.toolCallId, partForApp);
+                            settled.push(partForApp);
                             yield { content: partsWith(acc) };
                         }
-                        else {
-                            // Silent tool call — drop whitespace-only narration.
-                            acc = "";
+                        else if (hadText) {
+                            yield { content: partsWith(acc) };
+                        }
+                        continue;
+                    }
+                    if (event.type === "tool_call.completed" || event.type === "tool_call.failed") {
+                        // Only MCP App parts exist to update; every other tool call was a
+                        // boundary. Idempotent: a duplicate terminal event for the same id
+                        // is a no-op once the result is set.
+                        const existing = appParts.get(event.toolCallId);
+                        if (existing && existing.result === undefined) {
+                            const idx = settled.indexOf(existing);
+                            const updated = event.type === "tool_call.completed"
+                                ? { ...existing, result: event.result ?? { content: [] }, isError: event.result?.isError === true }
+                                : {
+                                    ...existing,
+                                    isError: true,
+                                    result: event.result ?? {
+                                        isError: true,
+                                        content: [
+                                            {
+                                                type: "text",
+                                                text: event.reason === "policy_denied"
+                                                    ? "This action was not allowed."
+                                                    : "The tool could not complete.",
+                                            },
+                                        ],
+                                    },
+                                };
+                            appParts.set(event.toolCallId, updated);
+                            if (idx >= 0)
+                                settled[idx] = updated;
+                            yield { content: partsWith(acc) };
                         }
                         continue;
                     }
@@ -114,6 +191,7 @@ attachments) {
                         // `done` carries the TERMINAL reply only, so it replaces the
                         // in-flight segment — never the settled ones.
                         const finalText = event.message?.content ?? acc;
+                        interruptUnresolvedApps("The turn ended before this view received a result.");
                         yield {
                             content: partsWith(finalText),
                             status: { type: "complete", reason: "stop" },
@@ -123,8 +201,9 @@ attachments) {
                         return;
                     }
                     if (event.type === "error") {
+                        interruptUnresolvedApps("The agent failed before this view received a result.");
                         yield {
-                            content: [{ type: "text", text: event.message }],
+                            content: [...settled.filter((p) => p.type === "tool-call"), { type: "text", text: event.message }],
                             status: { type: "incomplete", reason: "error" },
                         };
                         callbacks.onError?.(new Error(event.message));
@@ -167,10 +246,11 @@ attachments) {
                 //
                 // Anything already streamed is kept — partial text the user watched
                 // arrive is real — and the status marks the turn incomplete.
-                const partial = [...segments, acc].filter((t) => t.length > 0);
+                const hadAnything = settled.some((p) => p.type === "text") || acc.length > 0;
                 const truncatedNotice = "The connection to the agent ended unexpectedly. Please try again.";
+                interruptUnresolvedApps("The stream was interrupted before this view received a result.");
                 yield {
-                    content: partsWith(partial.length > 0 ? acc : truncatedNotice),
+                    content: partsWith(hadAnything ? acc : truncatedNotice),
                     status: { type: "incomplete", reason: "error" },
                 };
                 callbacks.onError?.(new Error("Stream ended without a terminal event"));
@@ -203,6 +283,20 @@ function latestUserAttachmentIds(messages) {
     }
     return [];
 }
+/**
+ * The app session on the latest user turn, when a rendered view sent it.
+ * Stamped by `McpAppToolPart` on `metadata.custom`; absent for typed turns.
+ */
+function latestUserAppSession(messages) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const m = messages[i];
+        if (m.role !== "user")
+            continue;
+        const v = m.metadata?.custom?.[APP_SESSION_METADATA_KEY];
+        return typeof v === "string" && v ? v : undefined;
+    }
+    return undefined;
+}
 /**
  * Pull the latest user-turn text out of assistant-ui's structured
  * message array. Text parts are concatenated with newlines; other

package/dist/esm/CuratorAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"CuratorAdapter.js","sourceRoot":"","sources":["../../src/CuratorAdapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"CuratorAdapter.js","sourceRoot":"","sources":["../../src/CuratorAdapter.ts"],"names":[],"mappings":"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"}

package/dist/esm/CuratorChat.d.ts

@@ -11,6 +11,7 @@
  */
 import { type CSSProperties, type ReactNode } from "react";
 import type { AssistantMessage, Curator, CuratorError, Environment, StreamState, StreamPlanProgress } from "@darqlabs/curator-sdk";
+import { type McpAppsOptions } from "./mcpApps/McpAppContext.js";
 /**
  * A starter prompt offered in the empty thread.
  *
@@ -103,6 +104,13 @@ export interface CuratorChatProps {
     onPlanProgress?: (progress: StreamPlanProgress) => void;
     /** Fired on any terminal stream error or thrown exception. */
     onError?: (error: CuratorError | Error) => void;
+    /**
+     * MCP Apps (SEP-1865). When an attached MCP tool declares a `ui://` view AND
+     * the deployment's admin exposed its call data, the agent's call renders as
+     * an interactive view inline in the transcript, sandboxed on a separate
+     * origin. Default: enabled. See `McpAppsOptions`.
+     */
+    mcpApps?: McpAppsOptions;
     /**
      * Show a retry (↻) button under the latest assistant message. Default:
      * off. Retry re-sends the preceding user message through the SDK — note