@miragon/mcp-toolkit-ui 0.10.1

package/dist/app/mcp-app-view.d.ts

@@ -0,0 +1,43 @@
+import { type WidgetComponent } from "./widget-renderer.js";
+export interface McpAppViewLabels {
+    loading?: string;
+    refresh?: string;
+    refreshing?: string;
+    enterFullscreen?: string;
+    exitFullscreen?: string;
+    build?: string;
+}
+export interface McpAppViewProps {
+    /**
+     * Map of widget ID to React component. The consumer aggregates this from
+     * each module's widget exports and passes it in at the bundled `main.tsx`
+     * entry point. All widgets are host-bundled — the framework never fetches
+     * widget code at render time.
+     */
+    widgets: Record<string, WidgetComponent>;
+    /**
+     * Name of the MCP tool that the refresh button invokes. Consumers typically
+     * register this tool as a thin wrapper around `renderView(...)` from
+     * `@miragon/mcp-toolkit-core`. Defaults to `"refresh-view"`.
+     */
+    refreshToolName?: string;
+    /**
+     * Explicit override for the Build / edit (Pencil) affordance. Leave it
+     * `undefined` (the default) to let the shell follow the server's own
+     * signal — `render-view` reports `structuredContent.builderAvailable`,
+     * derived from `createFrameworkApp`'s `app.builder`, so the button appears
+     * only when the `get-builder-catalogue` tool is actually registered. Set it
+     * to `true` / `false` only to force the affordance on or off regardless of
+     * that signal (e.g. a custom server that registers the catalogue tool by
+     * hand). Even when forced on, the LayoutBuilder's catalogue fetch fails
+     * soft (no crash) if the tool is absent.
+     */
+    builderEnabled?: boolean;
+    /**
+     * Override UI strings (loading, refresh, fullscreen, build).
+     * Defaults to English.
+     */
+    labels?: McpAppViewLabels;
+}
+export declare function McpAppView({ widgets, refreshToolName, builderEnabled, labels, }: McpAppViewProps): import("react").JSX.Element;
+//# sourceMappingURL=mcp-app-view.d.ts.map

package/dist/app/mcp-app-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-app-view.d.ts","sourceRoot":"","sources":["../../src/app/mcp-app-view.tsx"],"names":[],"mappings":"AASA,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE3E,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAkDD,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IACxC;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;;;;;;;;;OAUG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,gBAAgB,CAAA;CAC1B;AAED,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,eAAgC,EAChC,cAAc,EACd,MAAM,GACP,EAAE,eAAe,+BAoQjB"}

package/dist/app/mcp-app-view.js

@@ -0,0 +1,169 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useCallback } from "react";
+import { useWidget } from "mcp-use/react";
+import { Maximize2, Minimize2, Pencil, RefreshCw } from "lucide-react";
+import { Skeleton } from "../primitives/skeleton.js";
+import { AppQueryProvider, queryClient } from "../providers/query-provider.js";
+import { useToolResultRecovery } from "../hooks/use-tool-result-recovery.js";
+import { parseToolResult } from "../lib/parse-tool-result.js";
+import { LayoutBuilder } from "./layout-builder.js";
+import { WidgetRenderer } from "./widget-renderer.js";
+const DEFAULT_LABELS = {
+    loading: "Waiting for pipeline result...",
+    refresh: "Refresh",
+    refreshing: "Loading...",
+    enterFullscreen: "Fullscreen",
+    exitFullscreen: "Collapse",
+    build: "Build",
+};
+/**
+ * A renderable view payload: the envelope `render-view`/`show_*` tools emit
+ * as `structuredContent`. Module-level so it is referentially stable as the
+ * recovery hook's `isValid` dependency.
+ */
+function isCompleteViewData(value) {
+    const v = value;
+    return Boolean(v?.context && v?.layout);
+}
+export function McpAppView({ widgets, refreshToolName = "refresh-view", builderEnabled, labels, }) {
+    const effectiveLabels = { ...DEFAULT_LABELS, ...labels };
+    const { props: initialViewData, isPending, callTool, displayMode: currentDisplayMode, requestDisplayMode, safeArea, toolInput, hostContext, } = useWidget();
+    const [viewData, setViewData] = useState(null);
+    const [displayMode, setDisplayMode] = useState(currentDisplayMode ?? "inline");
+    const [prevCurrentDisplayMode, setPrevCurrentDisplayMode] = useState(currentDisplayMode);
+    if (currentDisplayMode !== prevCurrentDisplayMode) {
+        setPrevCurrentDisplayMode(currentDisplayMode);
+        if (currentDisplayMode)
+            setDisplayMode(currentDisplayMode);
+    }
+    const [isRefreshing, setIsRefreshing] = useState(false);
+    // In-iframe build mode is purely a UI state — the LLM never sees the
+    // catalogue, the user toggles into build by clicking the toolbar button.
+    const [buildMode, setBuildMode] = useState(false);
+    // Sync host-provided initialViewData → local viewData via render-phase
+    // setState (rather than an effect) so the React Compiler doesn't flag a
+    // cascading render. The guard against transient empty toolOutput stays:
+    // widgetProps may briefly drop `context`/`layout` when displayMode toggles,
+    // and we don't want that to clobber a valid viewData.
+    //
+    // `prev` MUST start as `null`, not `initialViewData`: hosts that expose the
+    // complete tool output before the app's first render (e.g. window.openai
+    // globals injected ahead of script execution) would otherwise never trip the
+    // identity check — initialViewData never changes again, the sync never runs,
+    // and the app idles on the loading skeleton forever.
+    const [prevInitialViewData, setPrevInitialViewData] = useState(null);
+    if (initialViewData !== prevInitialViewData) {
+        setPrevInitialViewData(initialViewData);
+        if (!isPending && isCompleteViewData(initialViewData)) {
+            setViewData(initialViewData);
+        }
+    }
+    // Hosts that strip `structuredContent` from the tool-result notification
+    // (claude.ai / Claude Desktop) leave `initialViewData` empty forever; the
+    // recovery re-executes the originating tool once via `callTool` (responses
+    // carry `structuredContent` intact) and fills the gap. Conforming hosts
+    // deliver a valid payload up front, so this never fires there.
+    const recovery = useToolResultRecovery({
+        resultReady: !isPending,
+        props: initialViewData,
+        isValid: isCompleteViewData,
+        toolInput,
+        hostContext,
+        callTool,
+    });
+    const [prevRecovered, setPrevRecovered] = useState(null);
+    if (recovery.data !== prevRecovered) {
+        setPrevRecovered(recovery.data);
+        // The host-delivered payload always wins; recovery only fills the gap.
+        if (recovery.data && !viewData)
+            setViewData(recovery.data);
+    }
+    const toggleFullscreen = useCallback(async () => {
+        const newMode = displayMode === "fullscreen" ? "inline" : "fullscreen";
+        try {
+            const result = await requestDisplayMode(newMode);
+            setDisplayMode(result.mode);
+        }
+        catch (e) {
+            console.error("Failed to toggle display mode:", e);
+        }
+    }, [displayMode, requestDisplayMode]);
+    // Stable callTool callback (avoids a new object reference on every render)
+    const callToolFn = useCallback(async (name, args) => {
+        return callTool(name, args);
+    }, [callTool]);
+    const refreshView = useCallback(async () => {
+        if (!viewData?._refreshParams)
+            return;
+        setIsRefreshing(true);
+        try {
+            const result = await callTool(refreshToolName, viewData._refreshParams);
+            // Decode through the shared structured-first parser (one convention with
+            // `useToolQuery`); a refresh returns the view envelope as `structuredContent`.
+            const refreshed = parseToolResult(result);
+            if (refreshed?.context && refreshed?.layout) {
+                setViewData(refreshed);
+            }
+            void queryClient.invalidateQueries();
+        }
+        catch (e) {
+            console.error("Failed to refresh view:", e);
+        }
+        finally {
+            setIsRefreshing(false);
+        }
+    }, [callTool, refreshToolName, viewData]);
+    // Called by LayoutBuilder when the user clicks Done. Commits the draft
+    // layout (and any keys/steps edits) into the parent viewData so the
+    // WidgetRenderer takes over showing the just-built layout.
+    const exitBuildMode = useCallback((commit) => {
+        if (commit) {
+            setViewData((prev) => prev
+                ? {
+                    ...prev,
+                    layout: commit.layout,
+                    title: commit.title ?? prev.title,
+                    context: commit.context ?? prev.context,
+                    _refreshParams: {
+                        keys: commit.keys,
+                        steps: commit.steps,
+                        layout: commit.layout,
+                        title: commit.title ?? prev.title,
+                    },
+                }
+                : prev);
+        }
+        setBuildMode(false);
+    }, []);
+    if (isPending || !viewData) {
+        return (_jsxs("div", { className: "flex flex-col gap-4 p-4", children: [_jsx(Skeleton, { className: "h-8 w-48" }), _jsx(Skeleton, { className: "h-32 w-full" }), _jsx("p", { className: "text-muted-foreground text-sm", children: effectiveLabels.loading })] }));
+    }
+    const showHeader = !buildMode;
+    // Follow the server's own signal by default: render-view reports
+    // `builderAvailable` (derived from `app.builder`), so the Build button only
+    // shows when the catalogue/dashboard tools are actually registered. An
+    // explicit `builderEnabled` prop forces the affordance on or off.
+    const builderAvailable = builderEnabled ?? viewData.builderAvailable ?? false;
+    return (_jsxs("main", { style: {
+            // Fullscreen: the widget owns the viewport, so we take the full window
+            // and handle our own scrolling. Inline: the host (Claude, ChatGPT) owns
+            // sizing + scrolling and is notified of our intrinsic height via
+            // `McpUseProvider`, so we let content dictate height and avoid setting
+            // overflowY (which would clip our own content inside a host that's
+            // already auto-sized to us).
+            ...(displayMode === "fullscreen"
+                ? { minHeight: "100vh", overflowY: "auto" }
+                : null),
+            paddingTop: safeArea?.insets?.top,
+            paddingRight: safeArea?.insets?.right,
+            paddingBottom: safeArea?.insets?.bottom,
+            paddingLeft: safeArea?.insets?.left,
+        }, children: [showHeader && (_jsxs("div", { className: "mb-4 flex items-center justify-between", children: [viewData.title && _jsx("h2", { className: "text-xl font-bold", children: viewData.title }), _jsxs("div", { className: "ml-auto flex items-center gap-2", children: [viewData._refreshParams && viewData.layout && (_jsxs("button", { onClick: () => {
+                                    void refreshView();
+                                }, disabled: isRefreshing, className: "hover:bg-accent hover:text-accent-foreground inline-flex items-center gap-1.5 rounded-md border px-3 py-1.5 text-sm font-medium transition-colors disabled:opacity-50", children: [_jsx(RefreshCw, { "aria-hidden": "true", className: `h-4 w-4 ${isRefreshing ? "animate-spin" : ""}` }), isRefreshing ? effectiveLabels.refreshing : effectiveLabels.refresh] })), builderAvailable && viewData._refreshParams && (_jsxs("button", { onClick: () => setBuildMode(true), className: "hover:bg-accent hover:text-accent-foreground inline-flex items-center gap-1.5 rounded-md border px-3 py-1.5 text-sm font-medium transition-colors", children: [_jsx(Pencil, { className: "h-4 w-4" }), effectiveLabels.build] })), _jsxs("button", { onClick: () => {
+                                    void toggleFullscreen();
+                                }, className: "hover:bg-accent hover:text-accent-foreground inline-flex items-center gap-1.5 rounded-md border px-3 py-1.5 text-sm font-medium transition-colors", children: [displayMode === "fullscreen" ? (_jsx(Minimize2, { "aria-hidden": "true", className: "h-4 w-4" })) : (_jsx(Maximize2, { "aria-hidden": "true", className: "h-4 w-4" })), displayMode === "fullscreen"
+                                        ? effectiveLabels.exitFullscreen
+                                        : effectiveLabels.enterFullscreen] })] })] })), !buildMode && viewData.context.errors.length > 0 && (_jsx("div", { className: "mb-4 flex flex-col gap-2", children: viewData.context.errors.map((err) => (_jsxs("div", { className: "bg-destructive/10 text-destructive rounded-lg p-3 text-sm", children: [_jsxs("strong", { children: [err.stepId, ":"] }), " ", err.reason] }, err.stepId))) })), _jsx(AppQueryProvider, { callTool: callToolFn, children: buildMode ? (_jsx(LayoutBuilder, { initialLayout: viewData.layout, title: viewData.title, initialKeys: viewData._refreshParams?.keys, initialSteps: viewData._refreshParams?.steps, widgets: widgets, callTool: callToolFn, onExit: exitBuildMode })) : viewData.layout ? (_jsx(WidgetRenderer, { layout: viewData.layout, keys: viewData.context.keys, stepData: viewData.context.stepData, errors: viewData.context.errors, widgets: widgets })) : null })] }));
+}
+//# sourceMappingURL=mcp-app-view.js.map

package/dist/app/mcp-app-view.js.map

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

package/dist/app/mcp-toolkit-app.d.ts

@@ -0,0 +1,18 @@
+import { type McpAppViewProps } from "./mcp-app-view.js";
+/**
+ * Consumer-facing root for a toolkit-rendered MCP App. Wraps `McpAppView`
+ * in `McpUseProvider` so the host (Claude, ChatGPT Apps SDK) receives
+ * intrinsic-height notifications and the widget auto-sizes inside the
+ * host's inline container.
+ *
+ * Usage at the bundle entry point:
+ *
+ * ```tsx
+ * createRoot(root).render(<McpToolkitApp widgets={widgets} />)
+ * ```
+ *
+ * `McpUseProvider` also installs StrictMode, a default ErrorBoundary, and
+ * the theme plumbing used by the toolkit primitives.
+ */
+export declare function McpToolkitApp(props: McpAppViewProps): import("react").JSX.Element;
+//# sourceMappingURL=mcp-toolkit-app.d.ts.map

package/dist/app/mcp-toolkit-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-toolkit-app.d.ts","sourceRoot":"","sources":["../../src/app/mcp-toolkit-app.tsx"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAEpE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,+BAMnD"}

package/dist/app/mcp-toolkit-app.js

@@ -0,0 +1,22 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { McpUseProvider } from "mcp-use/react";
+import { McpAppView } from "./mcp-app-view.js";
+/**
+ * Consumer-facing root for a toolkit-rendered MCP App. Wraps `McpAppView`
+ * in `McpUseProvider` so the host (Claude, ChatGPT Apps SDK) receives
+ * intrinsic-height notifications and the widget auto-sizes inside the
+ * host's inline container.
+ *
+ * Usage at the bundle entry point:
+ *
+ * ```tsx
+ * createRoot(root).render(<McpToolkitApp widgets={widgets} />)
+ * ```
+ *
+ * `McpUseProvider` also installs StrictMode, a default ErrorBoundary, and
+ * the theme plumbing used by the toolkit primitives.
+ */
+export function McpToolkitApp(props) {
+    return (_jsx(McpUseProvider, { children: _jsx(McpAppView, { ...props }) }));
+}
+//# sourceMappingURL=mcp-toolkit-app.js.map

package/dist/app/mcp-toolkit-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-toolkit-app.js","sourceRoot":"","sources":["../../src/app/mcp-toolkit-app.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAwB,MAAM,mBAAmB,CAAA;AAEpE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,aAAa,CAAC,KAAsB;IAClD,OAAO,CACL,KAAC,cAAc,cACb,KAAC,UAAU,OAAK,KAAK,GAAI,GACV,CAClB,CAAA;AACH,CAAC"}

package/dist/app/use-host-actions.d.ts

@@ -0,0 +1,57 @@
+export interface HostActions {
+    /**
+     * Open an external URL in a new browser tab via the host bridge
+     * (`bridge.openLink` / `window.openai.openExternal`). Works inside the
+     * sandboxed iframe where raw `window.open` is blocked. Falls back to
+     * `window.open` only when no MCP host bridge is available (dev preview).
+     */
+    openLink: (url: string) => void;
+    /**
+     * Ask the host to render another tool's widget by sending a follow-up
+     * user message into the conversation (`bridge.sendMessage` /
+     * `window.openai.sendFollowUpMessage`). The agent interprets the prompt
+     * and invokes the matching tool, whose widget then appears as the next
+     * chat turn — the proper MCP-Apps pattern for in-widget navigation.
+     *
+     * The prompt should be natural language and include enough hints
+     * (preferably the tool name in parentheses) for the agent to pick the
+     * right tool unambiguously.
+     */
+    showWidget: (prompt: string) => void;
+    /**
+     * Hand an open-ended, judgment task to the agent in the conversation
+     * (`sendFollowUpMessage`) — root-cause analysis, "explain this", migration
+     * planning, ticket drafting. Same bridge as {@link HostActions.showWidget}
+     * but a distinct affordance: this crosses the UI→chat boundary deliberately,
+     * for things the deterministic UI cannot do. The prompt should be
+     * self-contained — inline the relevant IDs/keys rather than relying on
+     * ambient ModelContext alone.
+     */
+    askAi: (prompt: string) => void;
+}
+/**
+ * Builds the natural-language intent string passed to {@link HostActions.showWidget}.
+ * The host agent reads the trailing `(use <toolName>)` hint to pick the right
+ * tool unambiguously. Centralised so every in-widget navigation handoff phrases
+ * the hint identically (and a tool rename only has to flow through the imported
+ * `*_SHOW_*` tool-name constant).
+ *
+ * @example host.showWidget(buildShowWidgetIntent(SHOW_PROCESS_DETAIL, `Show the process detail for \`${key}\``))
+ */
+export declare function buildShowWidgetIntent(toolName: string, description: string): string;
+/**
+ * Bridge-aware host actions for widgets. A thin, intent-named facade over
+ * {@link useHostBridge}: `openLink` → `bridge.openExternal`, and both
+ * `showWidget` and `askAi` → `bridge.sendFollowup` (kept as two affordances
+ * because they cross the UI→chat boundary for different reasons — see above).
+ *
+ * Relationship to {@link useHostBridge}: this hook resolves the active bridge
+ * through `useHostBridge()`, so it honours an explicit `HostBridgeProvider`
+ * (ChatGPT / standalone) when one is present, and otherwise falls back to the
+ * default `mcp-use` bridge — exactly the behaviour widgets had before the bridge
+ * abstraction existed, so no existing widget or test breaks. Prefer
+ * `useHostBridge` directly in new portable widgets; `useHostActions` stays for
+ * its named affordances and backward compatibility.
+ */
+export declare function useHostActions(): HostActions;
+//# sourceMappingURL=use-host-actions.d.ts.map

package/dist/app/use-host-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-host-actions.d.ts","sourceRoot":"","sources":["../../src/app/use-host-actions.tsx"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B;;;;;;;;;;OAUG;IACH,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACpC;;;;;;;;OAQG;IACH,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;CAChC;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEnF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAyB5C"}

package/dist/app/use-host-actions.js

@@ -0,0 +1,42 @@
+import { useCallback } from "react";
+import { useHostBridge } from "./host-bridge.js";
+/**
+ * Builds the natural-language intent string passed to {@link HostActions.showWidget}.
+ * The host agent reads the trailing `(use <toolName>)` hint to pick the right
+ * tool unambiguously. Centralised so every in-widget navigation handoff phrases
+ * the hint identically (and a tool rename only has to flow through the imported
+ * `*_SHOW_*` tool-name constant).
+ *
+ * @example host.showWidget(buildShowWidgetIntent(SHOW_PROCESS_DETAIL, `Show the process detail for \`${key}\``))
+ */
+export function buildShowWidgetIntent(toolName, description) {
+    return `${description} (use ${toolName})`;
+}
+/**
+ * Bridge-aware host actions for widgets. A thin, intent-named facade over
+ * {@link useHostBridge}: `openLink` → `bridge.openExternal`, and both
+ * `showWidget` and `askAi` → `bridge.sendFollowup` (kept as two affordances
+ * because they cross the UI→chat boundary for different reasons — see above).
+ *
+ * Relationship to {@link useHostBridge}: this hook resolves the active bridge
+ * through `useHostBridge()`, so it honours an explicit `HostBridgeProvider`
+ * (ChatGPT / standalone) when one is present, and otherwise falls back to the
+ * default `mcp-use` bridge — exactly the behaviour widgets had before the bridge
+ * abstraction existed, so no existing widget or test breaks. Prefer
+ * `useHostBridge` directly in new portable widgets; `useHostActions` stays for
+ * its named affordances and backward compatibility.
+ */
+export function useHostActions() {
+    const bridge = useHostBridge();
+    const openLink = useCallback((url) => {
+        bridge.openExternal(url);
+    }, [bridge]);
+    const showWidget = useCallback((prompt) => {
+        bridge.sendFollowup(prompt);
+    }, [bridge]);
+    const askAi = useCallback((prompt) => {
+        bridge.sendFollowup(prompt);
+    }, [bridge]);
+    return { openLink, showWidget, askAi };
+}
+//# sourceMappingURL=use-host-actions.js.map

package/dist/app/use-host-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-host-actions.js","sourceRoot":"","sources":["../../src/app/use-host-actions.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAkChD;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB,EAAE,WAAmB;IACzE,OAAO,GAAG,WAAW,SAAS,QAAQ,GAAG,CAAA;AAC3C,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,MAAM,GAAG,aAAa,EAAE,CAAA;IAE9B,MAAM,QAAQ,GAAG,WAAW,CAC1B,CAAC,GAAW,EAAE,EAAE;QACd,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;IAC1B,CAAC,EACD,CAAC,MAAM,CAAC,CACT,CAAA;IAED,MAAM,UAAU,GAAG,WAAW,CAC5B,CAAC,MAAc,EAAE,EAAE;QACjB,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;IAC7B,CAAC,EACD,CAAC,MAAM,CAAC,CACT,CAAA;IAED,MAAM,KAAK,GAAG,WAAW,CACvB,CAAC,MAAc,EAAE,EAAE;QACjB,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;IAC7B,CAAC,EACD,CAAC,MAAM,CAAC,CACT,CAAA;IAED,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;AACxC,CAAC"}

package/dist/app/widget-fixture.d.ts

@@ -0,0 +1,180 @@
+import { type ComponentType, type ReactNode } from "react";
+import type { WidgetProps } from "@miragon/mcp-toolkit-core";
+/**
+ * Minimal shape of a tool-call response the harness hands back to widgets.
+ * Mirrors `mcp-use`'s `CallToolResponse` closely enough that both the toolkit's
+ * `parseToolResult` (structured-first) and `mcp-use`'s `useCallTool`
+ * (`result`/`content` text) can decode a fixture result without a real host.
+ *
+ * A fixture entry may also be a bare value: the registry wraps it into this
+ * envelope under `structuredContent`, which is what `parseToolResult` reads
+ * first — so a fixture can be written as just the data the widget expects.
+ */
+export interface FixtureToolResult {
+    structuredContent?: unknown;
+    content?: {
+        type: string;
+        text?: string;
+    }[];
+    isError?: boolean;
+    _meta?: Record<string, unknown>;
+}
+/**
+ * A handler fixture: invoked with the call args, may return a value or a
+ * promise (the registry `await`s it either way).
+ */
+export type FixtureToolHandler = (args: Record<string, unknown>) => unknown;
+/**
+ * A fixture for one tool: either a static result returned verbatim, or a
+ * {@link FixtureToolHandler} invoked with the call args. Handlers let a fixture
+ * react to the widget's input — e.g. echo back a filtered list. Any registered
+ * function is treated as a handler (so a fixture cannot itself *be* the data
+ * `Function`, which is never JSON tool output anyway).
+ */
+export type FixtureToolEntry = unknown;
+/**
+ * Pure, host-free registry of fake tool implementations. Drives every
+ * `callTool` path the harness exposes (`window.openai.callTool`, the toolkit's
+ * `AppQueryProvider` bridge). Kept free of React/DOM so its semantics are unit
+ * testable in a plain Node environment.
+ *
+ * Resolution rules:
+ * - A registered **function** entry is called with `args` and its return value
+ *   (awaited) is wrapped into a {@link FixtureToolResult}.
+ * - A registered **value** entry is returned as-is when it already looks like a
+ *   tool response (has `structuredContent`/`content`), otherwise wrapped under
+ *   `structuredContent` so widgets that read structured data Just Work.
+ * - An **unknown** tool rejects with a descriptive error. This is the
+ *   error-friendly path: the rejection flows into the widget's own error state
+ *   (TanStack Query `error`, `mcp-use` `isError`) instead of crashing the
+ *   harness, and the message names the missing tool so the gap is obvious.
+ */
+export declare class FixtureCallToolRegistry {
+    private readonly entries;
+    constructor(initial?: Record<string, FixtureToolEntry>);
+    /** Register (or overwrite) the fixture for a tool name. */
+    register(name: string, resultOrHandler: FixtureToolEntry): this;
+    /** True if a fixture is registered for `name`. */
+    has(name: string): boolean;
+    /** Registered tool names, for diagnostics / the harness log. */
+    names(): string[];
+    /**
+     * Resolve a tool call against the registered fixtures. Always returns a
+     * promise so callers can `await` uniformly regardless of whether the fixture
+     * was a static value or an async handler.
+     */
+    call(name: string, args?: Record<string, unknown>): Promise<FixtureToolResult>;
+}
+/**
+ * A host action a widget asked the host to perform, surfaced to the harness so
+ * it can render an activity log. Mirrors the `mcp-use` bridge verbs that
+ * {@link useHostActions} and `useWidget` route through `window.openai`.
+ */
+export type HostActionLog = {
+    type: "callTool";
+    name: string;
+    args: Record<string, unknown>;
+} | {
+    type: "sendFollowUpMessage";
+    prompt: string;
+} | {
+    type: "openExternal";
+    href: string;
+} | {
+    type: "requestDisplayMode";
+    mode: string;
+} | {
+    type: "setWidgetState";
+    state: Record<string, unknown>;
+};
+interface FixtureHostValue {
+    registry: FixtureCallToolRegistry;
+}
+/**
+ * Access the active fixture registry from inside a {@link WidgetFixtureHost}.
+ * Returns `null` outside a harness — callers should treat that as "no fixture
+ * host present" rather than an error.
+ */
+export declare function useFixtureHost(): FixtureHostValue | null;
+/**
+ * Either an `adaptDataWidget`-style component (receives {@link WidgetProps}) or
+ * a "raw" single-data component (`({ data }) | ({ keys })`). The harness builds
+ * a `WidgetProps` envelope from the fixture and spreads it so both shapes work
+ * without the author declaring which they wrote.
+ */
+export type FixtureWidget = ComponentType<WidgetProps> | ComponentType<Record<string, unknown>>;
+export interface WidgetFixtureHostProps {
+    /** The widget component under development. */
+    widget: FixtureWidget;
+    /**
+     * Fixture data for the widget. Shaped however the widget reads it:
+     * - widgets reading `keys["ns:thing"]` (the common pattern) → pass the keys map
+     * - `adaptDataWidget` components → also pass {@link WidgetFixtureHostProps.dataType}
+     *   so the harness seeds a matching pipeline step the adapter can find
+     * - raw `({ data })` widgets → the same object is forwarded as `data`
+     */
+    data?: Record<string, unknown>;
+    /**
+     * `dataType` to register the fixture step under, for `adaptDataWidget`
+     * components (which look up the step whose `_dataType` matches). When set,
+     * `data` is placed in `context.steps[<id>].data` so the adapter resolves it.
+     */
+    dataType?: string;
+    /**
+     * Tool fixtures keyed by tool name. Each value is a static result or a
+     * handler — see {@link FixtureToolEntry}. Drives both `mcp-use`'s
+     * `useCallTool` and the toolkit's `useToolQuery`.
+     */
+    tools?: Record<string, FixtureToolEntry>;
+    /**
+     * Host context globals to override (theme, displayMode, locale, …). Merged
+     * over {@link DEFAULT_GLOBALS}.
+     */
+    globals?: Record<string, unknown>;
+    /**
+     * Called with the serialized model-context string the widget reports via
+     * `<ModelContext>` / `modelContext.set`. This is exactly what the model would
+     * see in a real host — surfacing it in the harness is the didactic point.
+     */
+    onModelContext?: (text: string) => void;
+    /** Called for every host action the widget triggers (tool call, link, …). */
+    onHostAction?: (action: HostActionLog) => void;
+}
+/**
+ * Build the `WidgetProps` envelope the harness passes to the widget. Seeds a
+ * single pipeline step from `data` (keyed by `dataType` when given) and uses
+ * `data` as the `keys` map, so widgets that read `keys[...]` and adapted
+ * widgets that scan `context.steps` are both satisfied from one fixture.
+ *
+ * Exported for unit testing the envelope shape without rendering React.
+ */
+export declare function buildFixtureWidgetProps(data: Record<string, unknown>, dataType?: string): WidgetProps;
+/**
+ * Storybook-style harness for MCP widgets. Renders a single widget with fixture
+ * data and a mocked host environment so it can be developed in isolation —
+ * without booting a real MCP host or backend.
+ *
+ * ### What it mocks
+ * - **`window.openai`** — the `mcp-use` Apps-SDK bridge `useWidget`/`useCallTool`
+ *   read from. Installed on mount, removed on unmount. `callTool` is routed to a
+ *   {@link FixtureCallToolRegistry} built from `tools`; `sendFollowUpMessage`,
+ *   `openExternal`, etc. are reported to `onHostAction`.
+ * - **The toolkit `AppQueryProvider`** — so widgets that fetch via `useToolQuery`
+ *   (e.g. generated `use*` hooks) resolve against the same registry.
+ * - **`ModelContext`** — a flush handler captures the serialized context string
+ *   and forwards it to `onModelContext`, so you can *see* what the model would.
+ * - **A {@link HostBridge}** — a `createStandaloneHostBridge` over the same
+ *   registry and callbacks, provided via `HostBridgeProvider`, so widgets
+ *   written against `useHostBridge` (the host-portable pattern) are simulated
+ *   from the same single source as the `window.openai` shim above.
+ *
+ * ### Boundaries
+ * `mcp-use`'s hooks select their provider from `window.openai` presence; this
+ * harness deliberately drives the Apps-SDK path (sets `window.openai`) rather
+ * than the `postMessage` bridge, which only activates inside a cross-origin
+ * iframe. The shim is intentionally minimal — it is not a host, and host
+ * features beyond the bridge verbs above are out of scope.
+ */
+export declare function WidgetFixtureHost({ widget: Widget, data, dataType, tools, globals, onModelContext, onHostAction, }: WidgetFixtureHostProps): ReactNode;
+export {};
+//# sourceMappingURL=widget-fixture.d.ts.map

package/dist/app/widget-fixture.d.ts.map

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