@darqlabs/curator-sdk-react 0.6.1 → 0.8.0

package/dist/esm/mcpApps/McpAppToolPart.js

@@ -0,0 +1,271 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The tool-call part renderer for MCP Apps.
+ *
+ * Two shapes, decided by whether the part carries `mcp.app` with a session:
+ *
+ *   live view     `tool_call.started` on THIS stream carried an app session →
+ *                 load the view's HTML through the Curator data plane, mount it
+ *                 in a sandboxed frame (safe-content-frame: hashed third-party
+ *                 origin), and run the SEP-1865 host bridge against it.
+ *   static card   anything else — a call reloaded from history, a call whose
+ *                 session could not be minted, or MCP Apps disabled → a
+ *                 non-interactive card with the tool's title and status. No
+ *                 arguments, no result, no session ever reach the DOM here.
+ *
+ * Credentials never enter the frame: every host call runs in the parent
+ * through the SDK, which holds the API key and end-user JWT.
+ */
+import { useEffect, useMemo, useRef, useState } from "react";
+import { useAui } from "@assistant-ui/react";
+import { SafeContentFrame } from "safe-content-frame";
+import { McpAppHostBridge } from "./hostBridge.js";
+import { APP_SESSION_METADATA_KEY, APP_TOOL_METADATA_KEY, useMcpAppContext, } from "./McpAppContext.js";
+const DEFAULT_MAX_HEIGHT = 480;
+const INITIAL_HEIGHT = 160;
+const INIT_TIMEOUT_MS = 8_000;
+function appOf(part) {
+    const app = part.mcp?.app;
+    if (!app || typeof app.resourceUri !== "string" || !app.resourceUri.startsWith("ui://"))
+        return undefined;
+    return app;
+}
+/**
+ * "pick_customer" / "mcp_mcps_d86199d7ac64_pick_customer" → "Pick customer".
+ * Sanitized MCP names are `mcp_<server_id>_<tool>` and server ids are
+ * themselves `mcps_<hex>`, so two prefixes come off, not one — one left the
+ * card titled "D86199d7ac64 pick customer".
+ */
+export function humanizeToolName(name) {
+    const tail = name.replace(/^mcp_(?:mcps_)?[a-z0-9]+_/i, "");
+    const spaced = tail.replace(/[_-]+/g, " ").trim();
+    return spaced ? spaced.charAt(0).toUpperCase() + spaced.slice(1) : name;
+}
+function resultText(result) {
+    if (!result || typeof result !== "object")
+        return null;
+    const content = result.content;
+    if (!Array.isArray(content))
+        return null;
+    const first = content.find((c) => c && typeof c === "object" && c.type === "text");
+    return typeof first?.text === "string" && first.text ? first.text : null;
+}
+export function McpAppToolPart(part) {
+    const ctx = useMcpAppContext();
+    const app = appOf(part);
+    const session = app?.serverId;
+    const live = !!ctx && ctx.options.enabled !== false && !!app && !!session;
+    if (!live)
+        return _jsx(StaticToolCard, { part: part });
+    return _jsx(LiveMcpAppView, { part: part, ctx: ctx, session: session, resourceUri: app.resourceUri });
+}
+// ── static card ──────────────────────────────────────────────────────────
+function StaticToolCard({ part }) {
+    const title = humanizeToolName(part.toolName);
+    const failed = part.isError === true;
+    const text = resultText(part.result) ?? (failed ? "The tool could not complete." : "Interactive view expired");
+    return (_jsxs("div", { "data-curator-part": "mcp-app-card", style: cardStyle, children: [_jsx("span", { style: cardTitleStyle, children: title }), _jsx("span", { style: cardMetaStyle, children: text })] }));
+}
+function LiveMcpAppView({ part, ctx, session, resourceUri, }) {
+    const aui = useAui();
+    const containerRef = useRef(null);
+    const bridgeRef = useRef(null);
+    const inFlightMessageRef = useRef(false);
+    const [state, setState] = useState({ kind: "loading" });
+    const [height, setHeight] = useState(INITIAL_HEIGHT);
+    const maxHeight = ctx.options.maxHeight ?? DEFAULT_MAX_HEIGHT;
+    // Latest part fields, readable from the long-lived bridge without
+    // re-creating it: the frame must survive re-renders, and the part updates
+    // several times (args → result) during one turn.
+    const latest = useRef({ part, ctx });
+    latest.current = { part, ctx };
+    const title = useMemo(() => humanizeToolName(part.toolName), [part.toolName]);
+    useEffect(() => {
+        const container = containerRef.current;
+        if (!container)
+            return;
+        let cancelled = false;
+        let rendered = null;
+        let bridge = null;
+        let onWindowMessage = null;
+        let initTimer;
+        const teardown = () => {
+            if (onWindowMessage)
+                window.removeEventListener("message", onWindowMessage);
+            if (initTimer)
+                clearTimeout(initTimer);
+            const b = bridge;
+            bridge = null;
+            bridgeRef.current = null;
+            const r = rendered;
+            rendered = null;
+            if (b)
+                void b.teardown(300).finally(() => r?.dispose());
+            else
+                r?.dispose();
+        };
+        (async () => {
+            let resource;
+            try {
+                resource = await ctx.chat.mcpApps.readResource({ session, uri: resourceUri });
+            }
+            catch (err) {
+                if (!cancelled)
+                    setState({ kind: "error", message: err?.message || "The view could not be loaded." });
+                return;
+            }
+            if (cancelled)
+                return;
+            const frame = new SafeContentFrame(ctx.options.sandboxProduct ?? "curator", {
+                sandbox: ["allow-forms"],
+            });
+            try {
+                rendered = await frame.renderHtml(resource.html, container);
+            }
+            catch (err) {
+                if (!cancelled)
+                    setState({ kind: "error", message: err?.message || "The view could not be shown." });
+                return;
+            }
+            if (cancelled) {
+                rendered.dispose();
+                return;
+            }
+            const r = rendered;
+            bridge = new McpAppHostBridge({
+                post: (m) => r.sendMessage(m),
+                hostInfo: { name: "Curator", version: "1" },
+                hostContext: {
+                    theme: ctx.theme,
+                    displayMode: "inline",
+                    availableDisplayModes: ["inline"],
+                    platform: "web",
+                    locale: typeof navigator !== "undefined" ? navigator.language : undefined,
+                    containerDimensions: { width: container.clientWidth || undefined, maxHeight },
+                },
+                handlers: {
+                    callTool: async ({ name, arguments: args, _meta }) => {
+                        const idempotencyKey = typeof _meta?.idempotencyKey === "string" ? _meta.idempotencyKey : undefined;
+                        const result = await latest.current.ctx.chat.mcpApps.callTool({
+                            session,
+                            name,
+                            arguments: args ?? {},
+                            ...(idempotencyKey ? { idempotencyKey } : {}),
+                        });
+                        return result;
+                    },
+                    sendMessage: async (text) => {
+                        // One app message in flight per view: a double-fire from the view
+                        // becomes one turn, and the server dedupes the rest.
+                        if (inFlightMessageRef.current)
+                            return false;
+                        inFlightMessageRef.current = true;
+                        setTimeout(() => {
+                            inFlightMessageRef.current = false;
+                        }, 2_000);
+                        aui.thread.append({
+                            role: "user",
+                            content: [{ type: "text", text }],
+                            metadata: {
+                                custom: {
+                                    [APP_SESSION_METADATA_KEY]: session,
+                                    [APP_TOOL_METADATA_KEY]: latest.current.part.toolName,
+                                },
+                            },
+                        });
+                        return true;
+                    },
+                    updateModelContext: (params) => {
+                        latest.current.ctx.options.onModelContextUpdate?.({
+                            toolCallId: latest.current.part.toolCallId,
+                            session,
+                            content: params.content,
+                            structuredContent: params.structuredContent,
+                        });
+                    },
+                    openLink: (url) => {
+                        window.open(url, "_blank", "noopener,noreferrer");
+                        return true;
+                    },
+                    onSizeChange: ({ height: h }) => {
+                        if (typeof h === "number" && h > 0)
+                            setHeight(Math.min(Math.max(48, Math.round(h)), maxHeight));
+                    },
+                    onInitialized: () => {
+                        if (initTimer)
+                            clearTimeout(initTimer);
+                        setState({ kind: "ready" });
+                    },
+                    onLog: () => undefined,
+                    onError: () => undefined,
+                },
+            });
+            bridgeRef.current = bridge;
+            onWindowMessage = (e) => {
+                if (e.source !== r.iframe.contentWindow || e.origin !== r.origin)
+                    return;
+                bridge?.onMessage(e.data);
+            };
+            window.addEventListener("message", onWindowMessage);
+            // Input is known now; the result may already be, or arrives later.
+            const args = latest.current.part.args;
+            bridge.setToolInput(args && typeof args === "object" ? args : {});
+            const res = latest.current.part.result;
+            if (res && typeof res === "object" && Array.isArray(res.content)) {
+                bridge.setToolResult(res);
+            }
+            initTimer = setTimeout(() => {
+                if (!cancelled && !bridge?.isInitialized) {
+                    setState({ kind: "error", message: "The view did not initialize." });
+                }
+            }, INIT_TIMEOUT_MS);
+        })();
+        return () => {
+            cancelled = true;
+            teardown();
+        };
+        // The frame is bound to one session for its whole life; a new session is a
+        // new part, hence a new component instance.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [session, resourceUri]);
+    // Deliver the result when it lands after mount.
+    const result = part.result;
+    useEffect(() => {
+        const b = bridgeRef.current;
+        if (!b)
+            return;
+        if (result && typeof result === "object" && Array.isArray(result.content)) {
+            b.setToolResult(result);
+        }
+    }, [result]);
+    // Theme changes reach the view as a host-context update.
+    useEffect(() => {
+        bridgeRef.current?.updateHostContext({ theme: ctx.theme });
+    }, [ctx.theme]);
+    return (_jsxs("div", { "data-curator-part": "mcp-app", style: viewWrapStyle, children: [_jsxs("div", { "data-curator-part": "mcp-app-header", style: viewHeaderStyle, children: [_jsx("span", { style: cardTitleStyle, children: title }), state.kind === "loading" && _jsx("span", { style: cardMetaStyle, children: "Loading\u2026" }), state.kind === "error" && _jsx("span", { style: cardMetaStyle, children: state.message })] }), _jsx("div", { ref: containerRef, "data-curator-part": "mcp-app-frame", style: { ...frameContainerStyle, height: state.kind === "error" ? 0 : height } })] }));
+}
+// ── styles ───────────────────────────────────────────────────────────────
+const cardStyle = {
+    display: "flex",
+    flexDirection: "column",
+    gap: 2,
+    padding: "8px 10px",
+    margin: "4px 0",
+    borderRadius: 8,
+    border: "1px solid var(--curator-border, rgba(0,0,0,0.12))",
+    background: "var(--curator-surface, transparent)",
+    fontSize: 13,
+};
+const cardTitleStyle = { fontWeight: 600 };
+const cardMetaStyle = { opacity: 0.7, fontSize: 12 };
+const viewWrapStyle = { ...cardStyle, padding: 0, overflow: "hidden" };
+const viewHeaderStyle = {
+    display: "flex",
+    justifyContent: "space-between",
+    alignItems: "baseline",
+    gap: 8,
+    padding: "6px 10px",
+    borderBottom: "1px solid var(--curator-border, rgba(0,0,0,0.08))",
+};
+const frameContainerStyle = { width: "100%", transition: "height 200ms ease-out" };
+//# sourceMappingURL=McpAppToolPart.js.map

package/dist/esm/mcpApps/McpAppToolPart.js.map

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

package/dist/esm/mcpApps/hostBridge.d.ts

@@ -0,0 +1,127 @@
+/**
+ * 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.
+ */
+export declare const MCP_APPS_PROTOCOL_VERSION = "2026-01-26";
+export interface CallToolResultLike {
+    content: Array<Record<string, unknown>>;
+    structuredContent?: Record<string, unknown>;
+    isError?: boolean;
+    _meta?: Record<string, unknown>;
+}
+export interface HostContext {
+    theme?: "light" | "dark";
+    displayMode?: "inline";
+    availableDisplayModes?: Array<"inline">;
+    platform?: "web";
+    locale?: string;
+    styles?: {
+        variables?: Record<string, string>;
+    };
+    containerDimensions?: {
+        width?: number;
+        maxHeight?: number;
+    };
+    [k: string]: unknown;
+}
+export interface HostBridgeHandlers {
+    callTool: (params: {
+        name: string;
+        arguments?: Record<string, unknown>;
+        _meta?: Record<string, unknown>;
+    }) => Promise<CallToolResultLike>;
+    /** App-reported text from the view. Return false to refuse. */
+    sendMessage: (text: string) => Promise<boolean>;
+    updateModelContext?: (params: {
+        content?: unknown;
+        structuredContent?: unknown;
+    }) => void;
+    openLink?: (url: string) => boolean;
+    onSizeChange?: (size: {
+        width?: number;
+        height?: number;
+    }) => void;
+    onLog?: (params: unknown) => void;
+    onInitialized?: () => void;
+    onError?: (error: Error) => void;
+}
+export interface HostBridgeOptions {
+    post: (message: unknown) => void;
+    handlers: HostBridgeHandlers;
+    hostInfo?: {
+        name: string;
+        version: string;
+    };
+    hostContext?: HostContext;
+    /** Cap on the text a view may put in the transcript. */
+    maxMessageChars?: number;
+}
+/**
+ * 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.
+ */
+export declare function extractMessageText(params: unknown, maxChars?: number): string | null;
+/** Only web links leave the sandbox. */
+export declare function isOpenableUrl(url: unknown): url is string;
+export declare class McpAppHostBridge {
+    private readonly post;
+    private readonly handlers;
+    private readonly hostInfo;
+    private hostContext;
+    private readonly maxMessageChars;
+    private initialized;
+    private closed;
+    private nextId;
+    private readonly pending;
+    /** Tool input, delivered on `initialized` (or immediately when already ready). */
+    private toolInput;
+    private toolInputSent;
+    /** Tool result, delivered after input once known. */
+    private toolResult;
+    private toolResultSent;
+    constructor(opts: HostBridgeOptions);
+    get isInitialized(): boolean;
+    setToolInput(args: Record<string, unknown>): void;
+    setToolResult(result: CallToolResultLike): void;
+    notifyToolCancelled(reason: string): void;
+    updateHostContext(patch: HostContext): void;
+    /** Ask the view to tear down; resolves when it answers or after `timeoutMs`. */
+    teardown(timeoutMs?: number): Promise<void>;
+    close(): void;
+    /** Feed one message received from the view. Non-JSON-RPC traffic is ignored. */
+    onMessage(data: unknown): void;
+    private handleRequest;
+    private handleNotification;
+    private flush;
+    private notify;
+    private request;
+    private respond;
+    private error;
+}
+//# sourceMappingURL=hostBridge.d.ts.map

package/dist/esm/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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"}