@miragon/mcp-toolkit-ui 0.10.1 → 1.1.0

package/README.md

@@ -9,19 +9,19 @@ Published to the public npm registry under the `@miragon` scope — no `.npmrc`
 or token needed.
 
 ```sh
-pnpm add @miragon/mcp-toolkit-ui @miragon/mcp-toolkit-core mcp-use@1.34.1 react@19.2.7 react-dom@19.2.7 tailwindcss@4.3.1
+pnpm add @miragon/mcp-toolkit-ui @miragon/mcp-toolkit-core mcp-use@2.1.0 react@19.2.8 react-dom@19.2.8 tailwindcss@4.3.3
 ```
 
 Peer versions are pinned exactly — install the versions above.
 
 ## Import paths
 
-| Subpath                   | Key exports                                                                                                                                                                           | Constraint                                                                                               |
-| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
-| `@miragon/mcp-toolkit-ui` | Primitives (`Card`, `Table`, `Button`, …), composed components (`KpiGrid`, `WidgetHeader`, `FilterBar`), `useToolQuery`, `createTheme` / `ThemeProvider`, `cn`, `parseViewToolResult` | Free of `mcp-use/react` value imports (langchain transitive) — safe for apps that never mount the shell. |
-| `…-ui/app`                | `McpToolkitApp`, `McpAppView`, `WidgetRenderer`, `useHostBridge`, `adaptDataWidget`, `WidgetFixtureHost`                                                                              | The MCP app shell + host bridge — imports `mcp-use/react`. Never re-exported from the root barrel.       |
-| `…-ui/hooks`              | `useViewToolQuery`, `useViewData`, `useToolQuery`, `useToolMutation`                                                                                                                  | View-tool hooks.                                                                                         |
-| `…-ui/globals.css`        | Tailwind v4 theme + design tokens                                                                                                                                                     | Import once in the app entry.                                                                            |
+| Subpath                   | Key exports                                                                                                                                                                           | Constraint                                                                                                                     |
+| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
+| `@miragon/mcp-toolkit-ui` | Primitives (`Card`, `Table`, `Button`, …), composed components (`KpiGrid`, `WidgetHeader`, `FilterBar`), `useToolQuery`, `createTheme` / `ThemeProvider`, `cn`, `parseViewToolResult` | Free of `mcp-use/react` value imports (the view runtime + its ext-apps transitive) — safe for apps that never mount the shell. |
+| `…-ui/app`                | `mountMcpToolkitApp`, `McpToolkitApp`, `McpAppView`, `WidgetRenderer`, `useHostBridge`, `adaptDataWidget`, `WidgetFixtureHost`                                                        | The MCP app shell + host bridge — imports `mcp-use/react`. Never re-exported from the root barrel.                             |
+| `…-ui/hooks`              | `useViewToolQuery`, `useViewData`, `useToolQuery`, `useToolMutation`                                                                                                                  | View-tool hooks.                                                                                                               |
+| `…-ui/globals.css`        | Tailwind v4 theme + design tokens                                                                                                                                                     | Import once in the app entry.                                                                                                  |
 
 ## Component catalog
 

package/dist/app/adapt-data-widget.d.ts

@@ -1,4 +1,4 @@
-import type { ComponentType } from "react";
+import { type ComponentType, type ReactNode } from "react";
 import type { WidgetComponent } from "./widget-renderer.js";
 /**
  * Builds the model-context line for an adapted widget. Receives the resolved
@@ -7,6 +7,27 @@ import type { WidgetComponent } from "./widget-renderer.js";
  * `period` / `engine` on dashboard widgets) can be reported too.
  */
 export type DescribeForModel<T> = (data: NonNullable<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 declare function HostModelContext({ content, children, }: {
+    content: string;
+    children: ReactNode;
+}): ReactNode;
 /**
  * Wraps a "single-data" widget component (signature `({ data }: { data: T | null })`)
  * so it can be registered as a framework {@link WidgetComponent} (which receives
@@ -21,11 +42,11 @@ export type DescribeForModel<T> = (data: NonNullable<T>, props: Readonly<Record<
  * 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 declare function adaptDataWidget<T>(Widget: ComponentType<{
     data: T | null;

package/dist/app/adapt-data-widget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapt-data-widget.d.ts","sourceRoot":"","sources":["../../src/app/adapt-data-widget.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAG1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE3D;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAChC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EACpB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KACrC,MAAM,CAAA;AAEX;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,MAAM,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACnE,QAAQ,EAAE,MAAM,EAChB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,GACrC,eAAe,CAUjB"}
+{"version":3,"file":"adapt-data-widget.d.ts","sourceRoot":"","sources":["../../src/app/adapt-data-widget.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAKrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE3D;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAChC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EACpB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KACrC,MAAM,CAAA;AAEX;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,OAAO,EACP,QAAQ,GACT,EAAE;IACD,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,SAAS,CAAA;CACpB,GAAG,SAAS,CAIZ;AAWD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,MAAM,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACnE,QAAQ,EAAE,MAAM,EAChB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,GACrC,eAAe,CAcjB"}

package/dist/app/adapt-data-widget.js

@@ -1,5 +1,39 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect } from "react";
 import { ModelContext } from "mcp-use/react";
+import { useHostBridgeOrNull } from "./host-bridge.js";
+import { useIsInsideMcpUseView } from "./mcp-use-host-bridge.js";
+/**
+ * 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, }) {
+    const insideView = useIsInsideMcpUseView();
+    if (insideView)
+        return _jsx(ModelContext, { content: content, children: children });
+    return _jsx(BridgeModelContext, { content: content, children: children });
+}
+function BridgeModelContext({ content, children }) {
+    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
@@ -14,11 +48,11 @@ import { ModelContext } from "mcp-use/react";
  * 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(Widget, dataType, describeForModel) {
     function AdaptedWidget({ context, widgetProps }) {
@@ -27,7 +61,7 @@ export function adaptDataWidget(Widget, dataType, describeForModel) {
         const widget = _jsx(Widget, { ...(widgetProps ?? {}), data: data });
         if (data == null || !describeForModel)
             return widget;
-        return _jsx(ModelContext, { content: describeForModel(data, widgetProps ?? {}), children: widget });
+        return (_jsx(HostModelContext, { content: describeForModel(data, widgetProps ?? {}), children: widget }));
     }
     AdaptedWidget.displayName = `Adapted(${Widget.displayName ?? Widget.name ?? "Widget"})`;
     return AdaptedWidget;

package/dist/app/adapt-data-widget.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapt-data-widget.js","sourceRoot":"","sources":["../../src/app/adapt-data-widget.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAe5C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAmE,EACnE,QAAgB,EAChB,gBAAsC;IAEtC,SAAS,aAAa,CAAC,EAAE,OAAO,EAAE,WAAW,EAAe;QAC1D,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAA;QACrF,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,IAAI,IAAI,IAAI,CAAa,CAAA;QACnD,MAAM,MAAM,GAAG,KAAC,MAAM,OAAK,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,GAAI,CAAA;QAC9D,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,gBAAgB;YAAE,OAAO,MAAM,CAAA;QACpD,OAAO,KAAC,YAAY,IAAC,OAAO,EAAE,gBAAgB,CAAC,IAAI,EAAE,WAAW,IAAI,EAAE,CAAC,YAAG,MAAM,GAAgB,CAAA;IAClG,CAAC;IACD,aAAa,CAAC,WAAW,GAAG,WAAW,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,IAAI,QAAQ,GAAG,CAAA;IACvF,OAAO,aAAa,CAAA;AACtB,CAAC"}
+{"version":3,"file":"adapt-data-widget.js","sourceRoot":"","sources":["../../src/app/adapt-data-widget.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAsC,MAAM,OAAO,CAAA;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAE5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA;AAchE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAC/B,OAAO,EACP,QAAQ,GAIT;IACC,MAAM,UAAU,GAAG,qBAAqB,EAAE,CAAA;IAC1C,IAAI,UAAU;QAAE,OAAO,KAAC,YAAY,IAAC,OAAO,EAAE,OAAO,YAAG,QAAQ,GAAgB,CAAA;IAChF,OAAO,KAAC,kBAAkB,IAAC,OAAO,EAAE,OAAO,YAAG,QAAQ,GAAsB,CAAA;AAC9E,CAAC;AAED,SAAS,kBAAkB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAA4C;IACzF,MAAM,MAAM,GAAG,mBAAmB,EAAE,CAAA;IACpC,MAAM,eAAe,GAAG,MAAM,EAAE,eAAe,CAAA;IAC/C,SAAS,CAAC,GAAG,EAAE;QACb,eAAe,EAAE,CAAC,OAAO,CAAC,CAAA;IAC5B,CAAC,EAAE,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAA;IAC9B,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAmE,EACnE,QAAgB,EAChB,gBAAsC;IAEtC,SAAS,aAAa,CAAC,EAAE,OAAO,EAAE,WAAW,EAAe;QAC1D,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAA;QACrF,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,IAAI,IAAI,IAAI,CAAa,CAAA;QACnD,MAAM,MAAM,GAAG,KAAC,MAAM,OAAK,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,GAAI,CAAA;QAC9D,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,gBAAgB;YAAE,OAAO,MAAM,CAAA;QACpD,OAAO,CACL,KAAC,gBAAgB,IAAC,OAAO,EAAE,gBAAgB,CAAC,IAAI,EAAE,WAAW,IAAI,EAAE,CAAC,YACjE,MAAM,GACU,CACpB,CAAA;IACH,CAAC;IACD,aAAa,CAAC,WAAW,GAAG,WAAW,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,IAAI,QAAQ,GAAG,CAAA;IACvF,OAAO,aAAa,CAAA;AACtB,CAAC"}

package/dist/app/host-bridge.d.ts

@@ -4,7 +4,7 @@ import { type ReactNode } from "react";
  * host runtime. A `HostBridge` is the single seam a portable widget talks to:
  * write the widget against {@link useHostBridge} and it runs unchanged in our
  * own `mcp-use` host, inside ChatGPT (OpenAI Apps SDK), or as a standalone web
- * app driven directly by a `@modelcontextprotocol/sdk` client — only the
+ * app driven directly by a `@modelcontextprotocol/client` client — only the
  * surrounding adapter changes.
  *
  * This is deliberately the *minimum* a deterministic UI needs, not a mirror of
@@ -18,43 +18,40 @@ export interface HostBridge {
      * with `parseToolResult`. Rejects if the call fails so a widget's own error
      * state (TanStack Query, try/catch) can surface it.
      */
-    callTool(name: string, args: Record<string, unknown>): Promise<unknown>;
+    callTool: (name: string, args: Record<string, unknown>) => Promise<unknown>;
     /**
      * Hand a natural-language prompt back to the conversation to drive a new model
      * turn (navigate to another widget, ask the agent to analyse something). In
      * hosts without a conversation (standalone web app) this is a no-op unless an
      * `onFollowup` handler is supplied.
      */
-    sendFollowup(prompt: string): void;
+    sendFollowup: (prompt: string) => void;
     /**
      * Ask the host to open a URL outside the (often sandboxed) widget frame.
      * Falls back to `window.open` only where no host bridge mediates links.
      */
-    openExternal(url: string): void;
+    openExternal: (url: string) => void;
     /**
      * The structured data this widget was rendered with, if the host pushed any
      * (the tool result's `structuredContent` / `toolOutput`). Returns `null` when
      * the host delivers data another way (e.g. props) or has none.
      */
-    getWidgetData<T>(): T | null;
+    getWidgetData: <T>() => T | null;
     /**
      * Persist a short text the model should see on the next turn (selection,
      * filter, current view). Optional: not every host exposes model context, and
      * a standalone web app has no model at all — callers must guard its absence.
      */
-    setModelContext?(text: string): void;
+    setModelContext?: (text: string) => void;
     /** The host's colour-scheme preference, when it reports one. */
     theme?: "light" | "dark";
 }
 /**
  * Provide an explicit {@link HostBridge} to a subtree. Wrap a portable widget in
  * the adapter for the host it is running in — {@link createChatGptHostBridge},
- * {@link createStandaloneHostBridge}, or {@link createMcpUseHostBridge} — and
- * every `useHostBridge()` below resolves to it.
- *
- * Omitting the provider is supported: {@link useHostBridge} (and, for backward
- * compatibility, `useHostActions`) then fall back to the `mcp-use`/react default
- * bridge so existing widgets keep working without any wrapping.
+ * {@link createStandaloneHostBridge}, or (inside the toolkit's own mcp-use
+ * view) the `McpUseHostBridgeProvider` — and every `useHostBridge()` below
+ * resolves to it.
  */
 export declare function HostBridgeProvider({ bridge, children, }: {
     bridge: HostBridge;
@@ -68,47 +65,56 @@ export declare function HostBridgeProvider({ bridge, children, }: {
  */
 export declare function useHostBridgeOrNull(): HostBridge | null;
 /**
- * The {@link HostBridge} for the current subtree. Resolution order:
+ * The {@link HostBridge} for the current subtree — the nearest
+ * {@link HostBridgeProvider}'s bridge.
  *
- * 1. An explicit bridge from the nearest {@link HostBridgeProvider}.
- * 2. The default `mcp-use`/react bridge ({@link createMcpUseHostBridge}), so a
- *    widget mounted in our own host needs no provider.
+ * A provider is always present in the supported mounts: the toolkit shell
+ * (`McpToolkitApp` via `McpUseHostBridgeProvider`) installs the `mcp-use`
+ * bridge for every widget it renders, the `WidgetFixtureHost` harness installs
+ * a standalone bridge, and ChatGPT / standalone apps wrap their root in
+ * {@link createChatGptHostBridge} / {@link createStandaloneHostBridge}.
  *
- * The `mcp-use` hooks the default bridge wraps must run under an `mcp-use`
- * provider/host context; outside one (e.g. a bare unit test render) wrap the
- * widget in a `HostBridgeProvider` with a {@link createStandaloneHostBridge}
- * instead. This hook never returns `null`: a portable widget can always assume a
- * bridge exists.
+ * Since mcp-use 2.x there is no provider-less fallback: the `mcp-use` hooks
+ * only work inside a `bootstrapView`-mounted view, so a bare render without a
+ * provider cannot silently degrade — this hook throws with a pointer to the
+ * adapters instead.
  */
 export declare function useHostBridge(): HostBridge;
 /**
- * Build a {@link HostBridge} backed by `mcp-use`/react — the default for widgets
- * running in the toolkit's own host. Wraps `useWidget()` (host actions,
- * `toolOutput`, `theme`) and `useCallTool` so it preserves exactly the behaviour
- * widgets had before the bridge abstraction:
+ * Exactly the slice of `mcp-use`'s widget surface {@link toHostBridge} reads —
+ * declared structurally rather than imported from `mcp-use/react`.
  *
- * - `openExternal` routes through the host's `openExternal` and falls back to
- *   `window.open` when no host bridge is wired (local dev preview) — mirroring
- *   the original `useHostActions.openLink`.
- * - `sendFollowup` routes through `sendFollowUpMessage` and swallows rejections
- *   with a `console.warn`, as `useHostActions` did.
- *
- * Must be called inside an `mcp-use` host context (it calls `mcp-use` hooks).
- * Use {@link createMcpUseHostBridge} for the standalone factory variant.
+ * That indirection is the point: the mapping below is the behaviour widgets
+ * depend on, and pinning it against a local interface keeps it testable without
+ * a host, a DOM, or a React renderer. It also localises upstream churn — when
+ * the shape moves, this interface and the `McpUseHostBridgeProvider` (which
+ * composes the mcp-use 2.x view hooks into this surface) are what change, and
+ * {@link toHostBridge}'s tests still prove the bridge contract widgets see is
+ * unchanged. The 1.x `useWidget()` satisfied it directly; the 2.x composition
+ * lives in `mcp-use-host-bridge.tsx`.
  */
-export declare function useMcpUseHostBridge(): HostBridge;
+export interface McpUseWidgetSurface {
+    /** Invoke a tool on the connected server. */
+    callTool: (name: string, args: Record<string, unknown>) => Promise<unknown>;
+    /** Hand a prompt back to the conversation. Rejects are swallowed by the mapping. */
+    sendFollowUpMessage: (prompt: string) => Promise<unknown>;
+    /** Open a URL outside the widget frame. Throws when no host mediates links. */
+    openExternal: (url: string) => void;
+    /** The tool output the host rendered this widget with, when it pushed one. */
+    output?: unknown;
+    /** The host's reported colour scheme, in whatever spelling it uses. */
+    theme?: unknown;
+    /** Persist widget state; the model-context write rides on this. */
+    setState: (state: Record<string, unknown>) => Promise<unknown>;
+}
 /**
- * Factory form of {@link useMcpUseHostBridge} for symmetry with the other
- * adapters. Because the `mcp-use` bridge is hook-driven (it reads live host
- * context), the "factory" is really the hook itself — call it from a component.
+ * Map `mcp-use`'s widget surface onto the host-agnostic {@link HostBridge}.
  *
- * @example
- * function MyWidget() {
- *   const bridge = createMcpUseHostBridge() // === useMcpUseHostBridge()
- *   // …or rely on useHostBridge()'s default and skip the provider entirely.
- * }
+ * Pure and separately exported so the fail-soft behaviour is pinned by tests:
+ * every verb here has a documented failure mode that widgets rely on, and none
+ * of them may start throwing into widget render paths.
  */
-export declare const createMcpUseHostBridge: typeof useMcpUseHostBridge;
+export declare function toHostBridge(widget: McpUseWidgetSurface): HostBridge;
 /**
  * Minimal structural view of the OpenAI Apps SDK `window.openai` object this
  * adapter reads. Every field is optional: the real SDK shape varies across
@@ -158,7 +164,7 @@ export declare function createChatGptHostBridge(sdk?: OpenAiAppsSdk | null): Hos
 export interface StandaloneHostBridgeOptions {
     /**
      * The only required capability: how to call a tool on the server. In a
-     * standalone web app this typically wraps a `@modelcontextprotocol/sdk`
+     * standalone web app this typically wraps a `@modelcontextprotocol/client`
      * `Client.callTool({ name, arguments })`, but any function with this shape
      * works — that injection is the whole point: hand-built widgets render
      * against *any* existing MCP server without the toolkit's host runtime.
@@ -191,7 +197,7 @@ export interface StandaloneHostBridgeOptions {
 /**
  * Build a {@link HostBridge} for a standalone web app driven against an existing
  * MCP server — no toolkit host, no `createFrameworkApp`. You inject `callTool`
- * (usually a thin wrapper over a `@modelcontextprotocol/sdk` client); the
+ * (usually a thin wrapper over a `@modelcontextprotocol/client` client); the
  * conversation-shaped verbs (`sendFollowup`, `setModelContext`) are no-ops
  * unless you wire handlers, and `openExternal` defaults to `window.open`.
  *
@@ -201,7 +207,7 @@ export interface StandaloneHostBridgeOptions {
  * harness also builds on this factory so host simulation has a single source.
  *
  * @example
- * const client = new Client(…) // @modelcontextprotocol/sdk
+ * const client = new Client(…) // @modelcontextprotocol/client
  * const bridge = createStandaloneHostBridge({
  *   callTool: (name, args) => client.callTool({ name, arguments: args }),
  *   getData: () => currentRecord,

package/dist/app/host-bridge.d.ts.map

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

package/dist/app/host-bridge.js

@@ -1,16 +1,12 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { createContext, useContext, useMemo } from "react";
-import { useWidget } from "mcp-use/react";
+import { createContext, useContext } from "react";
 const HostBridgeContext = createContext(null);
 /**
  * Provide an explicit {@link HostBridge} to a subtree. Wrap a portable widget in
  * the adapter for the host it is running in — {@link createChatGptHostBridge},
- * {@link createStandaloneHostBridge}, or {@link createMcpUseHostBridge} — and
- * every `useHostBridge()` below resolves to it.
- *
- * Omitting the provider is supported: {@link useHostBridge} (and, for backward
- * compatibility, `useHostActions`) then fall back to the `mcp-use`/react default
- * bridge so existing widgets keep working without any wrapping.
+ * {@link createStandaloneHostBridge}, or (inside the toolkit's own mcp-use
+ * view) the `McpUseHostBridgeProvider` — and every `useHostBridge()` below
+ * resolves to it.
  */
 export function HostBridgeProvider({ bridge, children, }) {
     return _jsx(HostBridgeContext.Provider, { value: bridge, children: children });
@@ -25,45 +21,39 @@ export function useHostBridgeOrNull() {
     return useContext(HostBridgeContext);
 }
 /**
- * The {@link HostBridge} for the current subtree. Resolution order:
+ * The {@link HostBridge} for the current subtree — the nearest
+ * {@link HostBridgeProvider}'s bridge.
  *
- * 1. An explicit bridge from the nearest {@link HostBridgeProvider}.
- * 2. The default `mcp-use`/react bridge ({@link createMcpUseHostBridge}), so a
- *    widget mounted in our own host needs no provider.
+ * A provider is always present in the supported mounts: the toolkit shell
+ * (`McpToolkitApp` via `McpUseHostBridgeProvider`) installs the `mcp-use`
+ * bridge for every widget it renders, the `WidgetFixtureHost` harness installs
+ * a standalone bridge, and ChatGPT / standalone apps wrap their root in
+ * {@link createChatGptHostBridge} / {@link createStandaloneHostBridge}.
  *
- * The `mcp-use` hooks the default bridge wraps must run under an `mcp-use`
- * provider/host context; outside one (e.g. a bare unit test render) wrap the
- * widget in a `HostBridgeProvider` with a {@link createStandaloneHostBridge}
- * instead. This hook never returns `null`: a portable widget can always assume a
- * bridge exists.
+ * Since mcp-use 2.x there is no provider-less fallback: the `mcp-use` hooks
+ * only work inside a `bootstrapView`-mounted view, so a bare render without a
+ * provider cannot silently degrade — this hook throws with a pointer to the
+ * adapters instead.
  */
 export function useHostBridge() {
     const explicit = useContext(HostBridgeContext);
-    // Always call the default-bridge hook (Rules of Hooks): it's cheap and only
-    // *used* when no explicit bridge is provided. The mcp-use hooks underneath are
-    // host-context readers, safe to call even when their result goes unused.
-    const fallback = useMcpUseHostBridge();
-    return explicit ?? fallback;
+    if (!explicit) {
+        throw new Error("[host-bridge] useHostBridge() found no HostBridgeProvider. Wrap the widget in " +
+            "McpToolkitApp / McpUseHostBridgeProvider (toolkit host), WidgetFixtureHost (dev), " +
+            "or a HostBridgeProvider with createChatGptHostBridge / createStandaloneHostBridge.");
+    }
+    return explicit;
 }
 /**
- * Build a {@link HostBridge} backed by `mcp-use`/react — the default for widgets
- * running in the toolkit's own host. Wraps `useWidget()` (host actions,
- * `toolOutput`, `theme`) and `useCallTool` so it preserves exactly the behaviour
- * widgets had before the bridge abstraction:
- *
- * - `openExternal` routes through the host's `openExternal` and falls back to
- *   `window.open` when no host bridge is wired (local dev preview) — mirroring
- *   the original `useHostActions.openLink`.
- * - `sendFollowup` routes through `sendFollowUpMessage` and swallows rejections
- *   with a `console.warn`, as `useHostActions` did.
+ * Map `mcp-use`'s widget surface onto the host-agnostic {@link HostBridge}.
  *
- * Must be called inside an `mcp-use` host context (it calls `mcp-use` hooks).
- * Use {@link createMcpUseHostBridge} for the standalone factory variant.
+ * Pure and separately exported so the fail-soft behaviour is pinned by tests:
+ * every verb here has a documented failure mode that widgets rely on, and none
+ * of them may start throwing into widget render paths.
  */
-export function useMcpUseHostBridge() {
-    const widget = useWidget();
+export function toHostBridge(widget) {
     const { callTool, sendFollowUpMessage, openExternal, output, theme, setState } = widget;
-    return useMemo(() => ({
+    return {
         callTool: (name, args) => callTool(name, args),
         sendFollowup: (prompt) => {
             void sendFollowUpMessage(prompt).catch((err) => {
@@ -87,20 +77,8 @@ export function useMcpUseHostBridge() {
             });
         },
         theme: theme === "dark" ? "dark" : "light",
-    }), [callTool, sendFollowUpMessage, openExternal, output, theme, setState]);
+    };
 }
-/**
- * Factory form of {@link useMcpUseHostBridge} for symmetry with the other
- * adapters. Because the `mcp-use` bridge is hook-driven (it reads live host
- * context), the "factory" is really the hook itself — call it from a component.
- *
- * @example
- * function MyWidget() {
- *   const bridge = createMcpUseHostBridge() // === useMcpUseHostBridge()
- *   // …or rely on useHostBridge()'s default and skip the provider entirely.
- * }
- */
-export const createMcpUseHostBridge = useMcpUseHostBridge;
 /**
  * Resolve the `window.openai` object, or `null` outside a browser / when the SDK
  * is absent. Pulled out so the no-SDK fallback path is unit-testable by passing
@@ -195,7 +173,7 @@ export function createChatGptHostBridge(sdk) {
 /**
  * Build a {@link HostBridge} for a standalone web app driven against an existing
  * MCP server — no toolkit host, no `createFrameworkApp`. You inject `callTool`
- * (usually a thin wrapper over a `@modelcontextprotocol/sdk` client); the
+ * (usually a thin wrapper over a `@modelcontextprotocol/client` client); the
  * conversation-shaped verbs (`sendFollowup`, `setModelContext`) are no-ops
  * unless you wire handlers, and `openExternal` defaults to `window.open`.
  *
@@ -205,7 +183,7 @@ export function createChatGptHostBridge(sdk) {
  * harness also builds on this factory so host simulation has a single source.
  *
  * @example
- * const client = new Client(…) // @modelcontextprotocol/sdk
+ * const client = new Client(…) // @modelcontextprotocol/client
  * const bridge = createStandaloneHostBridge({
  *   callTool: (name, args) => client.callTool({ name, arguments: args }),
  *   getData: () => currentRecord,

package/dist/app/host-bridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"host-bridge.js","sourceRoot":"","sources":["../../src/app/host-bridge.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"host-bridge.js","sourceRoot":"","sources":["../../src/app/host-bridge.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAA;AAkDjE,MAAM,iBAAiB,GAAG,aAAa,CAAoB,IAAI,CAAC,CAAA;AAEhE;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,EACjC,MAAM,EACN,QAAQ,GAIT;IACC,OAAO,KAAC,iBAAiB,CAAC,QAAQ,IAAC,KAAK,EAAE,MAAM,YAAG,QAAQ,GAA8B,CAAA;AAC3F,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,UAAU,CAAC,iBAAiB,CAAC,CAAA;AACtC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,QAAQ,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAA;IAC9C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,gFAAgF;YAC9E,oFAAoF;YACpF,oFAAoF,CACvF,CAAA;IACH,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AA8BD;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,MAA2B;IACtD,MAAM,EAAE,QAAQ,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAA;IACvF,OAAO;QACL,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;QAC9C,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;YACvB,KAAK,mBAAmB,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;gBACtD,OAAO,CAAC,IAAI,CAAC,2CAA2C,EAAE,GAAG,CAAC,CAAA;YAChE,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE;YACpB,IAAI,CAAC;gBACH,YAAY,CAAC,GAAG,CAAC,CAAA;YACnB,CAAC;YAAC,MAAM,CAAC;gBACP,iEAAiE;gBACjE,IAAI,OAAO,MAAM,KAAK,WAAW;oBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAA;YAC3E,CAAC;QACH,CAAC;QACD,aAAa,EAAE,GAAO,EAAE,CAAE,MAAmB,IAAI,IAAI;QACrD,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,KAAK,QAAQ,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;gBAC9D,OAAO,CAAC,IAAI,CAAC,gDAAgD,EAAE,GAAG,CAAC,CAAA;YACrE,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;KAC3C,CAAA;AACH,CAAC;AA6BD;;;;GAIG;AACH,SAAS,aAAa,CAAC,QAA+B;IACpD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAA;IAC3C,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,IAAI,CAAA;IAC9C,MAAM,SAAS,GAAa,MAA+B,CAAC,MAAM,CAAA;IAClE,OAAO,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAA;AACtE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAA0B;IAChE,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;IAEjC,OAAO;QACL,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;YACvB,IAAI,OAAO,MAAM,EAAE,QAAQ,KAAK,UAAU,EAAE,CAAC;gBAC3C,OAAO,CAAC,IAAI,CAAC,gEAAgE,EAAE,IAAI,CAAC,CAAA;gBACpF,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CACP,yEAAyE,IAAI,IAAI,CAClF,CACF,CAAA;YACH,CAAC;YACD,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;QACrD,CAAC;QACD,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;YACvB,MAAM,EAAE,GAAG,MAAM,EAAE,mBAAmB,IAAI,MAAM,EAAE,mBAAmB,CAAA;YACrE,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;gBAC7B,OAAO,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAA;gBACnF,OAAM;YACR,CAAC;YACD,IAAI,CAAC;gBACH,sEAAsE;gBACtE,MAAM,MAAM,GAAY,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;gBACtC,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;oBAC9B,MAAM,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;wBAC5B,OAAO,CAAC,IAAI,CAAC,6CAA6C,EAAE,GAAG,CAAC,CAAA;oBAClE,CAAC,CAAC,CAAA;gBACJ,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC;oBACH,EAAE,CAAC,MAAM,CAAC,CAAA;gBACZ,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,CAAC,IAAI,CAAC,2CAA2C,EAAE,GAAG,CAAC,CAAA;gBAChE,CAAC;YACH,CAAC;QACH,CAAC;QACD,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE;YACpB,IAAI,OAAO,MAAM,EAAE,YAAY,KAAK,UAAU,EAAE,CAAC;gBAC/C,IAAI,CAAC;oBACH,MAAM,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAA;oBAClC,OAAM;gBACR,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,CAAC,IAAI,CAAC,kDAAkD,EAAE,GAAG,CAAC,CAAA;gBACvE,CAAC;YACH,CAAC;YACD,IAAI,OAAO,MAAM,KAAK,WAAW;gBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAA;QAC3E,CAAC;QACD,aAAa,EAAE,GAAO,EAAE;YACtB,MAAM,IAAI,GAAG,MAAM,EAAE,UAAU,IAAI,MAAM,EAAE,oBAAoB,CAAA;YAC/D,OAAQ,IAAiB,IAAI,IAAI,CAAA;QACnC,CAAC;QACD,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,IAAI,OAAO,MAAM,EAAE,cAAc,KAAK,UAAU,EAAE,CAAC;gBACjD,OAAO,CAAC,IAAI,CAAC,8EAA8E,CAAC,CAAA;gBAC5F,OAAM;YACR,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,CAAC,cAAc,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAA;YAClD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,sCAAsC,EAAE,GAAG,CAAC,CAAA;YAC3D,CAAC;QACH,CAAC;QACD,KAAK,EAAE,MAAM,EAAE,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;KAC3F,CAAA;AACH,CAAC;AAqCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAAoC;IAC7E,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,OAAO,CAAA;IACxF,OAAO;QACL,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;QAC9C,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;YACvB,IAAI,UAAU,EAAE,CAAC;gBACf,UAAU,CAAC,MAAM,CAAC,CAAA;gBAClB,OAAM;YACR,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,4EAA4E,CAAC,CAAA;QAC5F,CAAC;QACD,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE;YACpB,IAAI,cAAc,EAAE,CAAC;gBACnB,cAAc,CAAC,GAAG,CAAC,CAAA;gBACnB,OAAM;YACR,CAAC;YACD,IAAI,OAAO,MAAM,KAAK,WAAW;gBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAA;QAC3E,CAAC;QACD,aAAa,EAAE,GAAO,EAAE;YACtB,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,UAAU,CAAC,CAAC,CAAE,OAAyB,EAAE,CAAC,CAAC,CAAC,OAAO,CAAA;YACnF,OAAQ,IAAiB,IAAI,IAAI,CAAA;QACnC,CAAC;QACD,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,IAAI,cAAc,EAAE,CAAC;gBACnB,cAAc,CAAC,IAAI,CAAC,CAAA;gBACpB,OAAM;YACR,CAAC;YACD,OAAO,CAAC,IAAI,CACV,iFAAiF,CAClF,CAAA;QACH,CAAC;QACD,KAAK;KACN,CAAA;AACH,CAAC"}

package/dist/app/index.d.ts

@@ -1,16 +1,17 @@
 export { McpAppView } from "./mcp-app-view.js";
 export type { McpAppViewProps, McpAppViewLabels } from "./mcp-app-view.js";
-export { McpToolkitApp } from "./mcp-toolkit-app.js";
+export { McpToolkitApp, mountMcpToolkitApp } from "./mcp-toolkit-app.js";
 export { WidgetRenderer, WidgetErrorBoundary, RenderedWidget, contextHasNoData, } from "./widget-renderer.js";
 export type { WidgetRendererProps, WidgetComponent } from "./widget-renderer.js";
 export { LayoutBuilder } from "./layout-builder.js";
 export type { LayoutBuilderProps, LayoutBuilderLabels } from "./layout-builder.js";
-export { adaptDataWidget } from "./adapt-data-widget.js";
+export { adaptDataWidget, HostModelContext } from "./adapt-data-widget.js";
 export type { DescribeForModel } from "./adapt-data-widget.js";
 export { useHostActions, buildShowWidgetIntent } from "./use-host-actions.js";
 export type { HostActions } from "./use-host-actions.js";
-export { HostBridgeProvider, useHostBridge, useHostBridgeOrNull, useMcpUseHostBridge, createMcpUseHostBridge, createChatGptHostBridge, createStandaloneHostBridge, } from "./host-bridge.js";
-export type { HostBridge, OpenAiAppsSdk, StandaloneHostBridgeOptions } from "./host-bridge.js";
+export { HostBridgeProvider, useHostBridge, useHostBridgeOrNull, toHostBridge, createChatGptHostBridge, createStandaloneHostBridge, } from "./host-bridge.js";
+export type { HostBridge, McpUseWidgetSurface, OpenAiAppsSdk, StandaloneHostBridgeOptions, } from "./host-bridge.js";
+export { McpUseHostBridgeProvider, useIsInsideMcpUseView } from "./mcp-use-host-bridge.js";
 export { WidgetFixtureHost, FixtureCallToolRegistry, buildFixtureWidgetProps, useFixtureHost, } from "./widget-fixture.js";
 export type { WidgetFixtureHostProps, FixtureWidget, FixtureToolEntry, FixtureToolResult, HostActionLog, } from "./widget-fixture.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/app/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/app/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,gBAAgB,GACjB,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAIlF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7E,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAMxD,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAA;AACzB,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAA;AAK9F,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,cAAc,GACf,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EACV,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,GACd,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/app/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAC1E,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACxE,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,gBAAgB,GACjB,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAIlF,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC1E,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7E,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAMxD,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAA;AACzB,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,aAAa,EACb,2BAA2B,GAC5B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA;AAK1F,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,cAAc,GACf,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EACV,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,GACd,MAAM,qBAAqB,CAAA"}

package/dist/app/index.js

@@ -1,18 +1,19 @@
 export { McpAppView } from "./mcp-app-view.js";
-export { McpToolkitApp } from "./mcp-toolkit-app.js";
+export { McpToolkitApp, mountMcpToolkitApp } from "./mcp-toolkit-app.js";
 export { WidgetRenderer, WidgetErrorBoundary, RenderedWidget, contextHasNoData, } from "./widget-renderer.js";
 export { LayoutBuilder } from "./layout-builder.js";
-// App-level value modules that import `mcp-use/react` (ModelContext, useWidget)
-// — exported from this subpath only, never the root barrel.
-export { adaptDataWidget } from "./adapt-data-widget.js";
+// App-level value modules that import `mcp-use/react` (ModelContext, the 2.x
+// view hooks) — exported from this subpath only, never the root barrel.
+export { adaptDataWidget, HostModelContext } from "./adapt-data-widget.js";
 export { useHostActions, buildShowWidgetIntent } from "./use-host-actions.js";
 // Host-portability bridge: the seam that lets the same hand-built widget run in
 // our mcp-use host, ChatGPT (Apps SDK), or a standalone web app against an
-// existing MCP server. Lives under ./app because the default adapter imports
+// existing MCP server. Lives under ./app because the mcp-use adapter imports
 // `mcp-use/react` — never the root barrel.
-export { HostBridgeProvider, useHostBridge, useHostBridgeOrNull, useMcpUseHostBridge, createMcpUseHostBridge, createChatGptHostBridge, createStandaloneHostBridge, } from "./host-bridge.js";
+export { HostBridgeProvider, useHostBridge, useHostBridgeOrNull, toHostBridge, createChatGptHostBridge, createStandaloneHostBridge, } from "./host-bridge.js";
+export { McpUseHostBridgeProvider, useIsInsideMcpUseView } from "./mcp-use-host-bridge.js";
 // Storybook-style harness for developing widgets in isolation with fixture
-// data and a mocked host. Lives under ./app because it mocks the
-// `mcp-use/react` host bridge (window.openai) — never the root barrel.
+// data and a simulated HostBridge. Lives under ./app to keep every host-facing
+// surface on one subpath — never the root barrel.
 export { WidgetFixtureHost, FixtureCallToolRegistry, buildFixtureWidgetProps, useFixtureHost, } from "./widget-fixture.js";
 //# sourceMappingURL=index.js.map

package/dist/app/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/app/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,gBAAgB,GACjB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAGnD,gFAAgF;AAChF,4DAA4D;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAG7E,gFAAgF;AAChF,2EAA2E;AAC3E,6EAA6E;AAC7E,2CAA2C;AAC3C,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAA;AAGzB,2EAA2E;AAC3E,iEAAiE;AACjE,uEAAuE;AACvE,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,cAAc,GACf,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/app/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACxE,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,gBAAgB,GACjB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAGnD,6EAA6E;AAC7E,wEAAwE;AACxE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAE1E,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAG7E,gFAAgF;AAChF,2EAA2E;AAC3E,6EAA6E;AAC7E,2CAA2C;AAC3C,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAA;AAOzB,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA;AAE1F,2EAA2E;AAC3E,+EAA+E;AAC/E,kDAAkD;AAClD,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,cAAc,GACf,MAAM,qBAAqB,CAAA"}

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

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