@miragon/mcp-toolkit-ui 0.10.1 → 1.1.0

package/dist/app/widget-fixture.js

@@ -1,15 +1,7 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { createContext, useContext, useEffect, useMemo, useRef, useSyncExternalStore, } from "react";
-import { useWidget } from "mcp-use/react";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo } from "react";
 import { AppQueryProvider } from "../providers/query-provider.js";
 import { HostBridgeProvider, createStandaloneHostBridge } from "./host-bridge.js";
-/**
- * Key `mcp-use` writes the serialized model-context string under when it flushes
- * to `window.openai.setWidgetState`. Mirrors `MODEL_CONTEXT_KEY` in
- * `mcp-use/react` (not exported, so duplicated here). The harness intercepts
- * `setWidgetState` and reads this field to surface what the model would see.
- */
-const MODEL_CONTEXT_KEY = "__model_context";
 /**
  * Pure, host-free registry of fake tool implementations. Drives every
  * `callTool` path the harness exposes (`window.openai.callTool`, the toolkit's
@@ -89,9 +81,10 @@ export function useFixtureHost() {
     return useContext(FixtureHostContext);
 }
 /**
- * Default host-context globals a widget sees in the harness. Chosen to be
- * harmless and inert: inline display, light theme, desktop, no safe-area
- * insets. Overridable per-mount via {@link WidgetFixtureHostProps.globals}.
+ * Default host-context values the harness reports. Only `theme` is read since
+ * the mcp-use 2.x move (the other host globals were consumed by the 1.x
+ * `window.openai` shim); the object keeps its shape so existing playground
+ * setups that spread overrides keep compiling.
  */
 const DEFAULT_GLOBALS = {
     theme: "light",
@@ -104,60 +97,6 @@ const DEFAULT_GLOBALS = {
         capabilities: { hover: true, touch: false },
     },
 };
-/**
- * Build the `window.openai` shim the `mcp-use` React hooks read from. Routes
- * `callTool` through the fixture registry and reports every other bridge verb
- * to `onHostAction`. Returns `null` outside a browser-like environment (SSR)
- * so the harness degrades to a plain render rather than throwing.
- */
-function buildOpenAiShim(registry, toolOutput, toolInput, globals, onHostAction, onModelContext) {
-    if (typeof window === "undefined")
-        return null;
-    return {
-        ...DEFAULT_GLOBALS,
-        ...globals,
-        toolInput,
-        toolOutput,
-        toolResponseMetadata: null,
-        widgetState: null,
-        callTool: async (name, args) => {
-            onHostAction?.({ type: "callTool", name, args });
-            return registry.call(name, args);
-        },
-        sendFollowUpMessage: (args) => {
-            onHostAction?.({ type: "sendFollowUpMessage", prompt: args.prompt });
-            return Promise.resolve();
-        },
-        openExternal: (payload) => {
-            onHostAction?.({ type: "openExternal", href: payload.href });
-        },
-        requestDisplayMode: (args) => {
-            onHostAction?.({ type: "requestDisplayMode", mode: args.mode });
-            return Promise.resolve({ mode: args.mode });
-        },
-        setWidgetState: (state) => {
-            onHostAction?.({ type: "setWidgetState", state });
-            // `mcp-use` flushes the serialized `<ModelContext>` tree through
-            // setWidgetState under MODEL_CONTEXT_KEY — surface it as the model view.
-            const ctx = state?.[MODEL_CONTEXT_KEY];
-            if (typeof ctx === "string")
-                onModelContext?.(ctx);
-            return Promise.resolve();
-        },
-        notifyIntrinsicHeight: () => Promise.resolve(),
-    };
-}
-/**
- * Renders nothing but mounts a `useWidget()` so `mcp-use` registers its
- * model-context flush handler — even for widgets that never call `useWidget`
- * themselves (e.g. a simple `({ keys })` card). Without this, a widget's
- * `<ModelContext>` would render but never flush, and `onModelContext` would
- * stay silent. The flush routes through our `setWidgetState` shim above.
- */
-function ModelContextPump() {
-    useWidget();
-    return null;
-}
 /**
  * Build the `WidgetProps` envelope the harness passes to the widget. Seeds a
  * single pipeline step from `data` (keyed by `dataType` when given) and uses
@@ -186,66 +125,37 @@ export function buildFixtureWidgetProps(data, dataType) {
  * 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`.
+ * - **A {@link HostBridge}** — a `createStandaloneHostBridge` over the fixture
+ *   registry and callbacks, provided via `HostBridgeProvider`. `callTool`
+ *   resolves against the {@link FixtureCallToolRegistry} built from `tools`;
+ *   `sendFollowup` / `openExternal` are reported to `onHostAction`;
+ *   `setModelContext` feeds `onModelContext`, so you can *see* what the model
+ *   would (adapted widgets report through this bridge outside a real view).
  * - **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.
+ * The harness simulates the **host-portable pattern** (`useHostBridge`,
+ * `useToolQuery`) — the surface the toolkit's skills teach. It does not
+ * simulate the mcp-use 2.x view runtime: since 2.x the `mcp-use/react` hooks
+ * only run under a `bootstrapView`-mounted view speaking the ext-apps
+ * postMessage protocol (the 1.x `window.openai` shim this harness used to
+ * install has no equivalent seam). A widget that calls `mcp-use/react` hooks
+ * directly must be exercised against a real host — or rewritten against
+ * `useHostBridge`, which is the portable contract anyway.
  */
 export function WidgetFixtureHost({ widget: Widget, data = {}, dataType, tools, globals, onModelContext, onHostAction, }) {
     // One registry per `tools` identity. Rebuilt when the fixture map changes so
     // edits in the playground take effect without a full remount.
     const registry = useMemo(() => new FixtureCallToolRegistry(tools), [tools]);
-    // Latest callbacks without re-installing the shim on every render. Updated in
-    // an effect (not during render) so the shim's closures always see the newest
-    // handler while the `window.openai` install effect stays stable.
-    const onHostActionRef = useRef(onHostAction);
-    const onModelContextRef = useRef(onModelContext);
-    useEffect(() => {
-        onHostActionRef.current = onHostAction;
-        onModelContextRef.current = onModelContext;
-    });
     const widgetProps = useMemo(() => buildFixtureWidgetProps(data, dataType), [data, dataType]);
-    // Install the `window.openai` shim for the lifetime of this mount. Wake any
-    // already-mounted `mcp-use` hooks via the `set_globals` event they listen for.
-    useEffect(() => {
-        if (typeof window === "undefined")
-            return;
-        const shim = buildOpenAiShim(registry, data ?? null, data ?? {}, globals ?? {}, (action) => onHostActionRef.current?.(action), (text) => onModelContextRef.current?.(text));
-        if (!shim)
-            return;
-        const prev = window.openai;
-        window.openai = shim;
-        window.dispatchEvent(new CustomEvent("openai:set_globals", { detail: { globals: shim } }));
-        return () => {
-            ;
-            window.openai = prev;
-        };
-    }, [registry, data, globals]);
     const callTool = useMemo(() => async (name, args) => registry.call(name, args ?? {}), [registry]);
-    // A standalone host bridge over the same registry + callbacks, so portable
-    // widgets written against `useHostBridge` (rather than the `mcp-use` host
-    // hooks) are simulated from the *same* source as the `window.openai` shim.
-    // It logs through the same `HostActionLog` channel, so the playground's
-    // activity log shows tool calls, follow-ups, and links identically whether the
-    // widget uses the mcp-use path or the host bridge. Reading globals.theme keeps
-    // the bridge's reported theme in sync with the shim. Depends on the callback
-    // props directly (not the refs) — a fresh Provider value on callback change is
-    // fine for a dev harness, and keeps the bridge's closures pure of ref reads.
+    // The standalone host bridge is the harness's single simulation source: it
+    // logs every verb through the `HostActionLog` channel for the playground's
+    // activity log. Depends on the callback props directly — a fresh Provider
+    // value on callback change is fine for a dev harness. Only `globals.theme`
+    // still influences the simulated host (the remaining globals fed the 1.x
+    // `window.openai` shim).
     const bridgeTheme = (globals?.theme ?? DEFAULT_GLOBALS.theme) === "dark" ? "dark" : "light";
     const bridge = useMemo(() => createStandaloneHostBridge({
         callTool: (name, args) => {
@@ -259,15 +169,9 @@ export function WidgetFixtureHost({ widget: Widget, data = {}, dataType, tools,
         theme: bridgeTheme,
     }), [registry, data, bridgeTheme, onHostAction, onModelContext]);
     const value = useMemo(() => ({ registry }), [registry]);
-    // Mount the model-context pump only on the client. The pump calls `mcp-use`'s
-    // `useWidget`, whose `useSyncExternalStore` lacks a server snapshot and throws
-    // under `react-dom/server` — gating it keeps the harness (and any widget
-    // rendered through it) SSR-safe. `useSyncExternalStore` with a `false` server
-    // snapshot is the idiomatic "are we on the client?" check (no setState-in-effect).
-    const isClient = useSyncExternalStore(() => () => { }, () => true, () => false);
     // Spread `widgetProps` (keys/context) AND a `data` alias so both adapted
     // widgets and raw `({ data })` widgets read their fixture from one mount.
     const RenderWidget = Widget;
-    return (_jsxs(FixtureHostContext.Provider, { value: value, children: [isClient && _jsx(ModelContextPump, {}), _jsx(HostBridgeProvider, { bridge: bridge, children: _jsx(AppQueryProvider, { callTool: callTool, children: _jsx(RenderWidget, { ...widgetProps, data: data }) }) })] }));
+    return (_jsx(FixtureHostContext.Provider, { value: value, children: _jsx(HostBridgeProvider, { bridge: bridge, children: _jsx(AppQueryProvider, { callTool: callTool, children: _jsx(RenderWidget, { ...widgetProps, data: data }) }) }) }));
 }
 //# sourceMappingURL=widget-fixture.js.map

package/dist/app/widget-fixture.js.map

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

package/dist/hooks/use-tool-result-recovery.d.ts

@@ -1,37 +1,62 @@
 /**
  * Recovery for hosts that deliver the `ui/notifications/tool-result`
  * notification without `structuredContent` (observed on claude.ai and Claude
- * Desktop, which forward only the model-facing `content` blocks). The
- * mcp-use bridge then hands the widget an empty props object and the shell
- * would idle on its loading skeleton forever.
+ * Desktop, which forward only the model-facing `content` blocks). Since
+ * mcp-use 2.x such a result is not even observable: the `useToolContext`
+ * latch ignores content-only successes, so the tool status stays `"pending"`
+ * forever and the shell would idle on its loading skeleton.
  *
- * When the result is ready but the payload is invalid, the hook re-executes
- * the originating tool once via the host bridge's official `callTool` —
- * tool-call RESPONSES carry `structuredContent` intact on those hosts — and
- * exposes the decoded payload. Spec-conforming hosts (e.g. the mcp-use
- * inspector) deliver a valid payload up front, so the recovery never fires
- * there.
+ * Because the stripped notification is invisible, readiness is inferred two
+ * ways: the hard `resultReady` signal (the latch fired but the payload is
+ * invalid), or a grace timer — once the originating tool is known and no
+ * result has latched within
+ * {@link ToolResultRecoveryOptions.assumeStrippedAfterMs}, the result is
+ * assumed delivered-but-stripped. Either way the hook re-executes the
+ * originating tool once via the host bridge's official `callTool` — tool-call
+ * RESPONSES carry `structuredContent` intact on those hosts — and exposes the
+ * decoded payload. Spec-conforming hosts (e.g. the mcp-use inspector) deliver
+ * a valid payload up front, so the recovery never fires there.
  *
  * Assumes the originating tool is a read-only render pipeline (true for all
  * toolkit `render-view`/`show_*` tools) — the re-execution must be safe to
- * repeat.
+ * repeat, and may rarely run concurrently with the original invocation when
+ * the grace timer beats a slow but conforming host.
  */
+/**
+ * Default grace period before a silent latch counts as a stripped result.
+ * Long enough for a conforming host to latch a typical render tool first,
+ * short enough that users on stripping hosts are not left staring at the
+ * skeleton noticeably.
+ */
+export declare const DEFAULT_ASSUME_STRIPPED_AFTER_MS = 2500;
 export interface ToolResultRecoveryOptions {
-    /** `!isPending` from `useWidget` — the host reported a finished tool call. */
+    /**
+     * The latch fired (`useToolContext().status !== "pending"`) — a structured
+     * result or tool error arrived. On hosts that strip `structuredContent`
+     * this never turns true; the grace timer below covers that case.
+     */
     resultReady: boolean;
-    /** The props the host delivered (`useWidget().props`). */
+    /** The payload the host delivered (`useToolContext().toolOutput`). */
     props: unknown;
     /**
      * Validates a candidate payload. MUST be referentially stable (module-level
      * function or memoised) — it is an effect dependency.
      */
     isValid: (value: unknown) => boolean;
-    /** The tool arguments from `ui/notifications/tool-input` (`useWidget().toolInput`). */
+    /** The tool arguments from `ui/notifications/tool-input` (`useToolContext().toolInput`). */
     toolInput: Record<string, unknown> | null | undefined;
-    /** Raw host context (`useWidget().hostContext`); `toolInfo` names the originating tool. */
+    /** Raw host context (`useHostContext().hostContext`); `toolInfo` names the originating tool. */
     hostContext: Record<string, unknown> | null | undefined;
-    /** The bridge's `callTool` (`useWidget().callTool`). */
+    /** The host bridge's `callTool`. */
     callTool: (name: string, args: Record<string, unknown>) => Promise<unknown>;
+    /**
+     * Grace period in ms after which a silent latch counts as a stripped
+     * result. Armed once the originating tool is known while `resultReady` is
+     * still false; re-armed on every `toolInput` update, because streaming
+     * arguments mean the invocation may not have finished yet. Defaults to
+     * {@link DEFAULT_ASSUME_STRIPPED_AFTER_MS}.
+     */
+    assumeStrippedAfterMs?: number;
 }
 export interface ToolResultRecoveryState<T> {
     /** The recovered payload, `null` until the re-execution resolved (or when it failed). */

package/dist/hooks/use-tool-result-recovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-tool-result-recovery.d.ts","sourceRoot":"","sources":["../../src/hooks/use-tool-result-recovery.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,yBAAyB;IACxC,8EAA8E;IAC9E,WAAW,EAAE,OAAO,CAAA;IACpB,0DAA0D;IAC1D,KAAK,EAAE,OAAO,CAAA;IACd;;;OAGG;IACH,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAA;IACpC,uFAAuF;IACvF,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAA;IACrD,2FAA2F;IAC3F,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAA;IACvD,wDAAwD;IACxD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC5E;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACxC,yFAAyF;IACzF,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;IACd,oGAAoG;IACpG,MAAM,EAAE,OAAO,CAAA;CAChB;AAID;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAehF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,GACnC,CAAC,GAAG,IAAI,CAQV;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,OAAO,EAAE,yBAAyB,GACjC,uBAAuB,CAAC,CAAC,CAAC,CAqD5B"}
+{"version":3,"file":"use-tool-result-recovery.d.ts","sourceRoot":"","sources":["../../src/hooks/use-tool-result-recovery.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,OAAO,CAAA;AAEpD,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,WAAW,EAAE,OAAO,CAAA;IACpB,sEAAsE;IACtE,KAAK,EAAE,OAAO,CAAA;IACd;;;OAGG;IACH,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAA;IACpC,4FAA4F;IAC5F,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAA;IACrD,gGAAgG;IAChG,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAA;IACvD,oCAAoC;IACpC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3E;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACxC,yFAAyF;IACzF,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;IACd,oGAAoG;IACpG,MAAM,EAAE,OAAO,CAAA;CAChB;AAID;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAehF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,GACnC,CAAC,GAAG,IAAI,CAQV;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,OAAO,EAAE,yBAAyB,GACjC,uBAAuB,CAAC,CAAC,CAAC,CAmF5B"}

package/dist/hooks/use-tool-result-recovery.js

@@ -1,5 +1,36 @@
 import { useEffect, useRef, useState } from "react";
 import { parseToolResult } from "../lib/parse-tool-result.js";
+/**
+ * Recovery for hosts that deliver the `ui/notifications/tool-result`
+ * notification without `structuredContent` (observed on claude.ai and Claude
+ * Desktop, which forward only the model-facing `content` blocks). Since
+ * mcp-use 2.x such a result is not even observable: the `useToolContext`
+ * latch ignores content-only successes, so the tool status stays `"pending"`
+ * forever and the shell would idle on its loading skeleton.
+ *
+ * Because the stripped notification is invisible, readiness is inferred two
+ * ways: the hard `resultReady` signal (the latch fired but the payload is
+ * invalid), or a grace timer — once the originating tool is known and no
+ * result has latched within
+ * {@link ToolResultRecoveryOptions.assumeStrippedAfterMs}, the result is
+ * assumed delivered-but-stripped. Either way the hook re-executes the
+ * originating tool once via the host bridge's official `callTool` — tool-call
+ * RESPONSES carry `structuredContent` intact on those hosts — and exposes the
+ * decoded payload. Spec-conforming hosts (e.g. the mcp-use inspector) deliver
+ * a valid payload up front, so the recovery never fires there.
+ *
+ * Assumes the originating tool is a read-only render pipeline (true for all
+ * toolkit `render-view`/`show_*` tools) — the re-execution must be safe to
+ * repeat, and may rarely run concurrently with the original invocation when
+ * the grace timer beats a slow but conforming host.
+ */
+/**
+ * Default grace period before a silent latch counts as a stripped result.
+ * Long enough for a conforming host to latch a typical render tool first,
+ * short enough that users on stripping hosts are not left staring at the
+ * skeleton noticeably.
+ */
+export const DEFAULT_ASSUME_STRIPPED_AFTER_MS = 2500;
 const IDLE = { data: null, failed: false };
 /**
  * Resolves the originating tool name from the host context's `toolInfo`.
@@ -40,7 +71,7 @@ export function decodeRecoveredResult(result, isValid) {
     return decoded !== null && isValid(decoded) ? decoded : null;
 }
 export function useToolResultRecovery(options) {
-    const { resultReady, props, isValid, toolInput, hostContext, callTool } = options;
+    const { resultReady, props, isValid, toolInput, hostContext, callTool, assumeStrippedAfterMs = DEFAULT_ASSUME_STRIPPED_AFTER_MS, } = options;
     const [state, setState] = useState(IDLE);
     // Single-flight: the promise ref survives StrictMode's dev-mode
     // effect re-run (cleanup + setup on the same instance), so the re-run
@@ -48,16 +79,38 @@ export function useToolResultRecovery(options) {
     const flightRef = useRef(null);
     const flightInputRef = useRef(null);
     const toolName = resolveRecoveryToolName(hostContext);
+    // A stripped result is unobservable (the 2.x latch ignores content-only
+    // results), so infer it: once a recovery could fire but the latch has been
+    // silent for the grace period, treat the result as delivered-but-stripped.
+    // Re-armed on every toolInput identity change — streaming arguments mean
+    // the invocation may still be running, so the grace period starts over.
+    // The re-arm is a render-phase reset (not an effect) so the cascading-
+    // render lint stays satisfied; the timer effect below restarts anyway
+    // because toolInput is one of its dependencies.
+    const [assumedReady, setAssumedReady] = useState(false);
+    const [prevTimerInput, setPrevTimerInput] = useState(toolInput);
+    if (prevTimerInput !== toolInput) {
+        setPrevTimerInput(toolInput);
+        if (assumedReady)
+            setAssumedReady(false);
+    }
+    useEffect(() => {
+        if (resultReady || toolName === undefined)
+            return;
+        const timer = setTimeout(() => setAssumedReady(true), assumeStrippedAfterMs);
+        return () => clearTimeout(timer);
+    }, [resultReady, toolName, toolInput, assumeStrippedAfterMs]);
+    const ready = resultReady || assumedReady;
     useEffect(() => {
         // A new tool run (result no longer ready, or fresh tool-input identity)
         // invalidates any previous recovery attempt and re-arms the single-flight.
-        if (flightRef.current && (!resultReady || flightInputRef.current !== toolInput)) {
+        if (flightRef.current && (!ready || flightInputRef.current !== toolInput)) {
             flightRef.current = null;
             setState((prev) => (prev.data === null && !prev.failed ? prev : IDLE));
         }
         // Never fire on conforming hosts (valid payload) or before the
         // originating tool is known.
-        if (!resultReady || isValid(props) || toolName === undefined)
+        if (!ready || isValid(props) || toolName === undefined)
             return;
         if (!flightRef.current) {
             flightInputRef.current = toolInput;
@@ -87,7 +140,7 @@ export function useToolResultRecovery(options) {
         return () => {
             stale = true;
         };
-    }, [resultReady, props, isValid, toolName, toolInput, callTool]);
+    }, [ready, props, isValid, toolName, toolInput, callTool]);
     return state;
 }
 //# sourceMappingURL=use-tool-result-recovery.js.map

package/dist/hooks/use-tool-result-recovery.js.map

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

package/dist/index.js

@@ -49,7 +49,7 @@ export { LocaleProvider, useLocale, useTranslate } from "./locale/index.js";
 // NOTE: MCP App shell (McpAppView, WidgetRenderer) is exported from the
 // `./app` subpath only. Keeping it out of the main barrel prevents consumers
 // that only need primitives (e.g. an admin portal) from pulling `mcp-use/react`
-// and its langchain transitive peer into their Vite bundle.
+// — the 2.x view runtime and its ext-apps transitive — into their Vite bundle.
 // Utils
 export { cn } from "./lib/utils.js";
 export { parseToolResult, parseViewToolResult } from "./lib/parse-tool-result.js";

package/dist/index.js.map

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

package/package.json

@@ -1,7 +1,12 @@
 {
   "name": "@miragon/mcp-toolkit-ui",
-  "version": "0.10.1",
+  "version": "1.1.0",
   "description": "React UI for MCP servers: shadcn primitives, composite components, TanStack Query hooks, and the MCP App shell (McpAppView + WidgetRenderer).",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Miragon/mcp-toolkit.git",
+    "directory": "packages/ui"
+  },
   "type": "module",
   "sideEffects": [
     "**/*.css"
@@ -33,11 +38,11 @@
     "access": "public"
   },
   "peerDependencies": {
-    "mcp-use": "1.34.5",
+    "mcp-use": "2.1.0",
     "react": "19.2.8",
     "react-dom": "19.2.8",
     "tailwindcss": "4.3.3",
-    "@miragon/mcp-toolkit-core": "0.10.1"
+    "@miragon/mcp-toolkit-core": "1.1.0"
   },
   "dependencies": {
     "@base-ui/react": "1.6.0",
@@ -45,21 +50,24 @@
     "@tanstack/react-query": "5.101.4",
     "class-variance-authority": "0.7.1",
     "clsx": "2.1.1",
-    "lucide-react": "1.25.0",
+    "lucide-react": "0.562.0",
     "radix-ui": "1.6.7",
     "tailwind-merge": "3.6.0",
     "tw-animate-css": "1.4.0"
   },
   "devDependencies": {
-    "@types/react": "19.2.17",
-    "@types/react-dom": "19.2.3",
-    "mcp-use": "1.34.5",
+    "@types/react": "19.2.18",
+    "@types/react-dom": "19.2.4",
+    "mcp-use": "2.1.0",
     "react": "19.2.8",
     "react-dom": "19.2.8",
     "tailwindcss": "4.3.3",
     "typescript": "6.0.3",
     "vitest": "4.1.10",
-    "@miragon/mcp-toolkit-core": "0.10.1"
+    "@miragon/mcp-toolkit-core": "1.1.0"
+  },
+  "engines": {
+    "node": ">=22.22.2"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",

package/src/app/adapt-data-widget.tsx

@@ -1,6 +1,8 @@
-import type { ComponentType } from "react"
+import { useEffect, type ComponentType, type ReactNode } from "react"
 import { ModelContext } from "mcp-use/react"
 import type { WidgetProps } from "@miragon/mcp-toolkit-core"
+import { useHostBridgeOrNull } from "./host-bridge.js"
+import { useIsInsideMcpUseView } from "./mcp-use-host-bridge.js"
 import type { WidgetComponent } from "./widget-renderer.js"
 
 /**
@@ -14,6 +16,44 @@ export type DescribeForModel<T> = (
   props: Readonly<Record<string, unknown>>,
 ) => string
 
+/**
+ * Model-context reporting that works on every host — the host-portable
+ * replacement for rendering `mcp-use/react`'s `ModelContext` directly.
+ *
+ * mcp-use 2.x's `ModelContext` registers with the view runtime and THROWS
+ * outside a `bootstrapView` mount, so it is only rendered inside an mcp-use
+ * view (where it aggregates nested nodes into one tree). Everywhere else —
+ * ChatGPT via `createChatGptHostBridge`, the `WidgetFixtureHost` harness,
+ * standalone apps — the description flows through the bridge's
+ * `setModelContext` instead (last-writer-wins; fine for the single-widget
+ * mounts those hosts render).
+ *
+ * Widgets that self-fetch and report their own context (cockpit views like
+ * `TasksBoard`) must use this instead of importing `ModelContext` from
+ * `mcp-use/react` — the direct import crashes the widget in every non-view
+ * mount, starting with the widget playground.
+ */
+export function HostModelContext({
+  content,
+  children,
+}: {
+  content: string
+  children: ReactNode
+}): ReactNode {
+  const insideView = useIsInsideMcpUseView()
+  if (insideView) return <ModelContext content={content}>{children}</ModelContext>
+  return <BridgeModelContext content={content}>{children}</BridgeModelContext>
+}
+
+function BridgeModelContext({ content, children }: { content: string; children: ReactNode }) {
+  const bridge = useHostBridgeOrNull()
+  const setModelContext = bridge?.setModelContext
+  useEffect(() => {
+    setModelContext?.(content)
+  }, [setModelContext, content])
+  return children
+}
+
 /**
  * Wraps a "single-data" widget component (signature `({ data }: { data: T | null })`)
  * so it can be registered as a framework {@link WidgetComponent} (which receives
@@ -28,11 +68,11 @@ export type DescribeForModel<T> = (
  * times in one view with different scoping (e.g. one tab per process key).
  *
  * When `describeForModel` is provided the adapter wraps the widget in a
- * `ModelContext` so the model knows what the user is looking at (view identity,
- * active filters, headline numbers) without per-widget boilerplate. The
- * description is only rendered once the step data is present; widgets that
+ * `HostModelContext` so the model knows what the user is looking at (view
+ * identity, active filters, headline numbers) without per-widget boilerplate.
+ * The description is only rendered once the step data is present; widgets that
  * self-fetch when the adapter has no data (cockpit views) must render their own
- * `<ModelContext>` instead.
+ * `<HostModelContext>` instead.
  */
 export function adaptDataWidget<T>(
   Widget: ComponentType<{ data: T | null } & Record<string, unknown>>,
@@ -44,7 +84,11 @@ export function adaptDataWidget<T>(
     const data = (stepResult?.data ?? null) as T | null
     const widget = <Widget {...(widgetProps ?? {})} data={data} />
     if (data == null || !describeForModel) return widget
-    return <ModelContext content={describeForModel(data, widgetProps ?? {})}>{widget}</ModelContext>
+    return (
+      <HostModelContext content={describeForModel(data, widgetProps ?? {})}>
+        {widget}
+      </HostModelContext>
+    )
   }
   AdaptedWidget.displayName = `Adapted(${Widget.displayName ?? Widget.name ?? "Widget"})`
   return AdaptedWidget