@miragon/mcp-toolkit-ui 2.6.0 → 2.8.0

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

@@ -1,24 +1,26 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 /**
- * Presentational chrome for `McpAppView` — the pre-payload placeholder, the
- * toolbar, the pipeline error list, and the build/render body — plus the
- * view-envelope types they share.
- * Split out of `mcp-app-view.tsx` so the shell component keeps only the
- * host-sync and state logic while this file stays hook-free.
+ * Presentational chrome for `McpAppView` — the toolbar, the failed-steps
+ * alert, and the build/render body — plus the view-envelope types they share.
+ * The pre-payload states (waiting / error / cancelled) live in
+ * `mcp-app-view-states.tsx`. Split out of `mcp-app-view.tsx` so the shell
+ * component keeps only the host-sync and state logic while these files stay
+ * hook-light.
  */
-import { Maximize2, Minimize2, Pencil, RefreshCw } from "lucide-react";
-import { Skeleton } from "../primitives/skeleton.js";
-import { LayoutBuilder } from "./layout-builder.js";
+import { createElement } from "react";
+import { LucideProvider, Maximize2, Minimize2, Pencil, RefreshCw } from "lucide-react";
+import { ErrorState } from "../components/ErrorState.js";
+import { DENSE_ICON_STROKE } from "../lib/icon-stroke.js";
+import { TOOLKIT_MESSAGES } from "../locale/toolkit-messages.js";
+import { Button } from "../primitives/button.js";
+import { LayoutBuilder, } from "./layout-builder.js";
 import { WidgetRenderer } from "./widget-renderer.js";
-export const DEFAULT_LABELS = {
-    loading: "Waiting for pipeline result...",
-    cancelled: "Tool call was cancelled.",
-    refresh: "Refresh",
-    refreshing: "Loading...",
-    enterFullscreen: "Fullscreen",
-    exitFullscreen: "Collapse",
-    build: "Build",
-};
+/**
+ * English chrome strings.
+ * @deprecated Read the active locale's strings with `useToolkitMessages().view`
+ * (or `TOOLKIT_MESSAGES.en.view`); this alias stays for existing imports.
+ */
+export const DEFAULT_LABELS = TOOLKIT_MESSAGES.en.view;
 /**
  * A renderable view payload: the envelope `render-view`/`show_*` tools emit
  * as `structuredContent`. Module-level so it is referentially stable as the
@@ -28,35 +30,118 @@ export function isCompleteViewData(value) {
     const v = value;
     return Boolean(v?.context && v?.layout);
 }
-// -------------------------------------------------------------------------- //
-// Placeholder: shown until a view payload exists
-// -------------------------------------------------------------------------- //
-export function ViewPlaceholder({ cancelled, labels, }) {
-    if (cancelled) {
-        return (_jsx("div", { className: "p-4", children: _jsx("p", { className: "text-muted-foreground text-sm", children: labels.cancelled }) }));
-    }
-    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: labels.loading })] }));
+/**
+ * Commit the builder's draft into the view payload so the renderer shows the
+ * just-built layout and Refresh re-issues it. Exported for tests.
+ */
+export function applyBuilderCommit(prev, commit) {
+    const title = commit.title ?? prev.title;
+    return {
+        ...prev,
+        layout: commit.layout,
+        title,
+        context: commit.context ?? prev.context,
+        _refreshParams: { keys: commit.keys, steps: commit.steps, layout: commit.layout, title },
+    };
+}
+/**
+ * Whether the Fullscreen toggle may render: the host offers fullscreen
+ * (mcp-use's negotiated `availableDisplayModes`, toolkit#178 K22), or the view
+ * is already there (its exit toggle must stay).
+ */
+export function fullscreenAvailable(displayMode, availableDisplayModes) {
+    return displayMode === "fullscreen" || availableDisplayModes.includes("fullscreen");
+}
+/** The toolbar title per {@link ViewTitleMode}: a heading, the consumer's slot, or nothing. */
+function ToolbarTitle({ title, mode, level, renderTitle, }) {
+    if (mode === "slot")
+        return _jsx("div", { className: "min-w-0 flex-1", children: renderTitle?.(title) });
+    if (mode === "hide" || !title)
+        return null;
+    return createElement(`h${level}`, { className: "min-w-0 flex-1 truncate text-lg font-semibold tracking-tight" }, title);
+}
+/**
+ * The title, and under it the stamp of data the view re-loaded itself. The
+ * stamp is a second line of the title column, never an item beside the
+ * controls: the title keeps the row's width (it is the user's orientation),
+ * and the stamp truncates only against its own column. Its words carry its
+ * meaning, so it needs no tooltip that touch and keyboard users never reach.
+ * Without a stamp the title renders as before, straight in the row.
+ */
+function ToolbarHeading({ title, mode, level, renderTitle, stamp, }) {
+    const heading = _jsx(ToolbarTitle, { title: title, mode: mode, level: level, renderTitle: renderTitle });
+    if (!stamp)
+        return heading;
+    return (_jsxs("div", { "data-slot": "view-heading", className: "min-w-0 flex-1", children: [heading, _jsx("p", { "data-slot": "view-data-as-of", className: "text-muted-foreground truncate text-sm", children: stamp })] }));
+}
+/** Which toolbar controls render — pure, so the gates are unit-testable. */
+export function toolbarControls(input) {
+    const refreshable = Boolean(input.viewData._refreshParams && input.viewData.layout);
+    const edit = input.builderAvailable && Boolean(input.viewData._refreshParams);
+    const title = input.titleMode === "slot" || (input.titleMode === "show" && Boolean(input.viewData.title));
+    return {
+        title,
+        refresh: refreshable,
+        edit,
+        fullscreen: input.canFullscreen,
+        any: title || refreshable || edit || input.canFullscreen,
+    };
+}
+/**
+ * The CI §8 chrome button (Icon-Button, Chrome): surface, `--cd-linie` border,
+ * shadow-1, blue on hover. The `outline` variant brings the surface, the
+ * border and the blue hover (it is also CI §8's secondary button, which has no
+ * shadow), so the chrome adds `shadow-1` on top instead of changing it.
+ */
+const CHROME_BUTTON = { variant: "outline", className: "shadow-1" };
+function RefreshButton({ isRefreshing, labels, onRefresh, }) {
+    const label = isRefreshing ? labels.refreshing : labels.refresh;
+    return (_jsx(Button, { type: "button", ...CHROME_BUTTON, size: "icon-sm", "aria-label": label, title: label, disabled: isRefreshing, onClick: () => {
+            void onRefresh();
+        }, children: _jsx(RefreshCw, { "aria-hidden": "true", className: isRefreshing ? "motion-safe:animate-spin" : undefined }) }));
 }
-export function ViewToolbar({ hidden, viewData, builderAvailable, isFullscreen, isRefreshing, labels, onRefresh, onEnterBuildMode, onToggleFullscreen, }) {
-    if (hidden)
+function FullscreenButton({ isFullscreen, labels, onToggle, }) {
+    const label = isFullscreen ? labels.exitFullscreen : labels.enterFullscreen;
+    const Icon = isFullscreen ? Minimize2 : Maximize2;
+    return (_jsx(Button, { type: "button", ...CHROME_BUTTON, size: "icon-sm", "aria-label": label, title: label, onClick: () => {
+            void onToggle();
+        }, children: _jsx(Icon, { "aria-hidden": "true" }) }));
+}
+/**
+ * The view toolbar: the title (per {@link ViewTitleMode}, so a widget that
+ * renders its own heading is not titled twice), then Edit, Refresh and
+ * Fullscreen. Refresh and Fullscreen are 32 px icon buttons named by
+ * `aria-label`; Fullscreen renders only when the host offers it. All three are
+ * chrome buttons in the CI pattern (CI §8: surface, border, shadow-1, blue
+ * hover; {@link CHROME_BUTTON}). A 16 px inset keeps the bar off the frame
+ * edge, also in fullscreen. The controls never shrink; the stamp of re-loaded
+ * data sits under the title ({@link ToolbarHeading}), so neither the title
+ * nor the stamp competes with the controls for width.
+ */
+export function ViewToolbar({ hidden, viewData, builderAvailable, isFullscreen, canFullscreen, isRefreshing, labels, titleMode, titleLevel, renderTitle, onRefresh, onEnterBuildMode, onToggleFullscreen, dataAsOf, }) {
+    const show = toolbarControls({ viewData, builderAvailable, canFullscreen, titleMode });
+    if (hidden || (!show.any && !dataAsOf))
         return null;
-    return (_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 onRefresh();
-                        }, 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 ? labels.refreshing : labels.refresh] })), builderAvailable && viewData._refreshParams && (_jsxs("button", { onClick: onEnterBuildMode, 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" }), labels.build] })), _jsxs("button", { onClick: () => {
-                            void onToggleFullscreen();
-                        }, 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: [isFullscreen ? (_jsx(Minimize2, { "aria-hidden": "true", className: "h-4 w-4" })) : (_jsx(Maximize2, { "aria-hidden": "true", className: "h-4 w-4" })), isFullscreen ? labels.exitFullscreen : labels.enterFullscreen] })] })] }));
+    return (_jsx(LucideProvider, { strokeWidth: DENSE_ICON_STROKE, children: _jsxs("div", { "data-slot": "view-toolbar", className: "flex min-h-12 items-center gap-2 px-4 py-2", children: [_jsx(ToolbarHeading, { title: viewData.title, mode: titleMode, level: titleLevel, renderTitle: renderTitle, stamp: dataAsOf ? labels.dataAsOf(dataAsOf) : undefined }), _jsxs("div", { className: "ml-auto flex shrink-0 items-center gap-1", children: [show.edit && (_jsxs(Button, { type: "button", ...CHROME_BUTTON, size: "sm", "data-slot": "view-edit", onClick: onEnterBuildMode, children: [_jsx(Pencil, { "aria-hidden": "true" }), labels.build] })), show.refresh && (_jsx(RefreshButton, { isRefreshing: isRefreshing, labels: labels, onRefresh: onRefresh })), show.fullscreen && (_jsx(FullscreenButton, { isFullscreen: isFullscreen, labels: labels, onToggle: onToggleFullscreen }))] })] }) }));
 }
-// -------------------------------------------------------------------------- //
-// Pipeline error list
-// -------------------------------------------------------------------------- //
-export function StepErrors({ hidden, errors, }) {
+/**
+ * The failed data steps as ONE inline alert: what happened (the title), which
+ * data is affected (each step by its human title, else its step id), what you
+ * can do (retry, or ask in the chat when the view cannot refresh). The raw
+ * step reasons stay under "Details", out of the user copy.
+ */
+export function StepErrors({ hidden, errors, steps, labels, describeStep, onRetry, }) {
     if (hidden || errors.length === 0)
         return null;
-    return (_jsx("div", { className: "mb-4 flex flex-col gap-2", children: 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))) }));
+    const failed = errors.map((err) => {
+        const ref = { id: err.stepId, step: steps?.find((s) => s.id === err.stepId)?.step };
+        return { ref, human: describeStep?.(ref), reason: err.reason };
+    });
+    return (_jsx("div", { className: "px-4 pb-4", children: _jsx(ErrorState, { variant: "inline", title: labels.stepErrorsTitle, retryLabel: labels.retry, onRetry: onRetry, detailsLabel: labels.errorDetails, details: failed.map(({ ref, reason }) => `${ref.step ?? ref.id}: ${reason}`).join("\n"), description: _jsxs(_Fragment, { children: [_jsx("ul", { className: "flex flex-col gap-1", children: failed.map(({ ref, human }) => (_jsx("li", { className: "break-words", children: human ? (_jsx("span", { className: "font-medium", children: human })) : (_jsx("span", { className: "text-small font-mono", children: ref.step ?? ref.id })) }, ref.id))) }), _jsx("p", { className: "mt-1", children: onRetry ? labels.stepErrorsHint : labels.errorHintNoRetry })] }) }) }));
 }
-export function ViewBody({ buildMode, viewData, widgets, callTool, onExit }) {
+export function ViewBody({ buildMode, viewData, widgets, callTool, onExit, builderLabels, }) {
     if (buildMode) {
-        return (_jsx(LayoutBuilder, { initialLayout: viewData.layout, title: viewData.title, initialKeys: viewData._refreshParams?.keys, initialSteps: viewData._refreshParams?.steps, widgets: widgets, callTool: callTool, onExit: onExit }));
+        return (_jsx(LayoutBuilder, { initialLayout: viewData.layout, title: viewData.title, initialKeys: viewData._refreshParams?.keys, initialSteps: viewData._refreshParams?.steps, widgets: widgets, callTool: callTool, labels: builderLabels, onExit: onExit }));
     }
     if (!viewData.layout)
         return null;

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

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

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

@@ -0,0 +1,23 @@
+import type { McpAppViewLabels } from "./mcp-app-view-chrome.js";
+import type { ViewErrorKind, ViewLifecycle } from "./view-lifecycle.js";
+export type { ViewErrorKind } from "./view-lifecycle.js";
+/**
+ * Human text for a raw error reason (e.g. map "503" to "the engine is down").
+ * `info.kind` tells a failure (`"failed"`) from a result the chat did not pass
+ * to the view (`"blocked"`, no reason); return `undefined` to keep the
+ * toolkit's words for that state.
+ */
+export type DescribeViewError = (reason: string | undefined, info?: {
+    kind: ViewErrorKind;
+}) => {
+    title?: string;
+    description?: string;
+} | undefined;
+export declare function ViewPlaceholder({ lifecycle, labels, onRetry, describeError, }: {
+    /** The current phase; `result` renders nothing (the view takes over). */
+    lifecycle: ViewLifecycle;
+    labels: Required<McpAppViewLabels>;
+    onRetry: () => void;
+    describeError?: DescribeViewError;
+}): import("react").JSX.Element | null;
+//# sourceMappingURL=mcp-app-view-states.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-app-view-states.d.ts","sourceRoot":"","sources":["../../src/app/mcp-app-view-states.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEvE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,CAAC,EAAE;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,KAC3B;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAA;AAEzD,wBAAgB,eAAe,CAAC,EAC9B,SAAS,EACT,MAAM,EACN,OAAO,EACP,aAAa,GACd,EAAE;IACD,yEAAyE;IACzE,SAAS,EAAE,aAAa,CAAA;IACxB,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAA;IAClC,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,aAAa,CAAC,EAAE,iBAAiB,CAAA;CAClC,sCA0BA"}

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

@@ -0,0 +1,55 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The pre-payload states of `McpAppView`, one per lifecycle phase
+ * (`view-lifecycle.ts`): waiting (skeleton + status line + slow hint),
+ * cancelled, and error (icon, title, what to do, raw reason under "Details",
+ * retry when the originating tool is known). A `blocked` error is a notice in
+ * the info tone, not a failure: the tool ran, but the chat did not pass its
+ * result to the view. Hook-free and SSR-renderable, so each phase is pinned
+ * by a test.
+ */
+import { ErrorState } from "../components/ErrorState.js";
+import { Skeleton } from "../primitives/skeleton.js";
+export function ViewPlaceholder({ lifecycle, labels, onRetry, describeError, }) {
+    switch (lifecycle.phase) {
+        case "result":
+            return null;
+        case "cancelled":
+            return (_jsx("div", { className: "px-4 py-4", children: _jsx("p", { role: "status", className: "text-muted-foreground text-sm", children: labels.cancelled }) }));
+        case "error":
+            return (_jsx(ViewErrorState, { kind: lifecycle.kind, reason: lifecycle.reason, canRetry: lifecycle.canRetry, labels: labels, onRetry: onRetry, describeError: describeError }));
+        case "waiting":
+            return _jsx(ViewWaiting, { slow: lifecycle.slow, labels: labels });
+    }
+}
+function ViewWaiting({ slow, labels }) {
+    // No aria-busy on an ancestor of the live region: assistive technology may
+    // hold back changes inside a busy subtree, and the slow hint is one.
+    return (_jsxs("div", { className: "flex flex-col gap-4 px-4 py-4", children: [_jsx(Skeleton, { "aria-hidden": "true", className: "h-8 w-48" }), _jsx(Skeleton, { "aria-hidden": "true", className: "h-32 w-full" }), _jsxs("div", { role: "status", className: "text-muted-foreground flex flex-col gap-1 text-sm", children: [_jsx("p", { children: labels.loading }), slow && _jsx("p", { "data-slot": "slow-hint", children: labels.slowHint })] })] }));
+}
+/** The words and tone of an error phase; the hint never promises a retry the state does not offer. */
+function errorStateCopy(kind, canRetry, labels) {
+    if (kind === "blocked") {
+        // Nothing failed: a quiet notice that says what happened and what to do.
+        return {
+            tone: "info",
+            role: "status",
+            title: labels.blockedTitle,
+            hint: canRetry ? labels.blockedHint : labels.blockedHintNoRetry,
+            retry: labels.blockedRetry,
+        };
+    }
+    return {
+        tone: "danger",
+        role: "alert",
+        title: labels.errorTitle,
+        hint: canRetry ? labels.errorHint : labels.errorHintNoRetry,
+        retry: labels.retry,
+    };
+}
+function ViewErrorState({ kind = "failed", reason, canRetry, labels, onRetry, describeError, }) {
+    const human = describeError?.(reason, { kind });
+    const copy = errorStateCopy(kind, canRetry, labels);
+    return (_jsx("div", { className: "px-4 py-4", children: _jsx(ErrorState, { tone: copy.tone, role: copy.role, title: human?.title ?? copy.title, description: human?.description ?? copy.hint, details: reason, detailsLabel: labels.errorDetails, retryLabel: copy.retry, onRetry: canRetry ? onRetry : undefined }) }));
+}
+//# sourceMappingURL=mcp-app-view-states.js.map

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

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

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

@@ -1,6 +1,13 @@
-import { type McpAppViewLabels } from "./mcp-app-view-chrome.js";
+import { type ReactNode } from "react";
+import { type RecoveryPolicy } from "../hooks/use-tool-result-recovery.js";
+import { type DescribeStep, type McpAppViewLabels, type ViewTitleLevel, type ViewTitleMode } from "./mcp-app-view-chrome.js";
+import { type DescribeViewError } from "./mcp-app-view-states.js";
+import type { LayoutBuilderLabels } from "./layout-builder.js";
 import type { WidgetComponent } from "./widget-renderer.js";
-export type { McpAppViewLabels } from "./mcp-app-view-chrome.js";
+export type { McpAppViewLabels, ViewTitleLevel, ViewTitleMode } from "./mcp-app-view-chrome.js";
+export type { DescribeStep } from "./mcp-app-view-chrome.js";
+export type { DescribeViewError, ViewErrorKind } from "./mcp-app-view-states.js";
+export type { RecoveryPolicy } from "../hooks/use-tool-result-recovery.js";
 export interface McpAppViewProps {
     /**
      * Map of widget ID to React component. The consumer aggregates this from
@@ -28,10 +35,70 @@ export interface McpAppViewProps {
      */
     builderEnabled?: boolean;
     /**
-     * Override UI strings (loading, refresh, fullscreen, build).
-     * Defaults to English.
+     * Override chrome strings (loading, error, refresh, fullscreen, edit, …).
+     * Defaults to the active locale's toolkit catalog: the nearest
+     * `LocaleProvider`, else the host's locale (`en`/`de`, English otherwise).
      */
     labels?: McpAppViewLabels;
+    /** Override strings of the embedded view builder (defaults: the locale's catalog). */
+    builderLabels?: LayoutBuilderLabels;
+    /**
+     * How the toolbar shows the view title, so a view carries ONE title:
+     * `"show"` (default) renders it as a heading, `"hide"` leaves the title to
+     * the widget's own header, `"slot"` renders {@link McpAppViewProps.renderTitle}.
+     */
+    titleMode?: ViewTitleMode;
+    /** Heading level of the toolbar title in `"show"` mode. Default `2`. */
+    titleLevel?: ViewTitleLevel;
+    /** Renders the toolbar title in `"slot"` mode; receives the view's title. */
+    renderTitle?: (title: string | undefined) => ReactNode;
+    /** Delay before the loading placeholder adds its "taking longer" hint. Default 8000 ms. */
+    slowHintAfterMs?: number;
+    /**
+     * Map a raw rendering error (the tool's `isError` text) onto human text.
+     * The raw reason always stays available under "Details".
+     */
+    describeError?: DescribeViewError;
+    /** Human title of a pipeline step in the failed-steps alert (default: the step id). */
+    describeStep?: DescribeStep;
+    /**
+     * Which originating tools the view may re-execute on its own when the host
+     * strips the result's `structuredContent` (claude.ai, Claude Desktop).
+     * `"auto"` (default): any tool the host does not report as writing
+     * (`readOnlyHint: false` or `destructiveHint: true`); `"read-only"`: only
+     * tools reported with `readOnlyHint: true`; `"never"`: none. A recovery
+     * the policy forbids shows a note that the chat did not pass the result to
+     * the view. It offers to load the view only for a tool the host does not
+     * report as writing; for a writing tool it asks for the current state in
+     * the chat, so one click never runs the write a second time.
+     */
+    recoverStrippedResult?: RecoveryPolicy;
+    /**
+     * Grace period (ms) after which a silent call counts as a stripped result.
+     * Only used where the view could not watch the host's notifications from
+     * the start (e.g. a custom shell mounted under its own `bootstrapView`
+     * without `installToolResultObserver`); a view mounted by
+     * `mountMcpToolkitApp` sees the stripped result itself and never guesses,
+     * so a slow tool is never re-run. Default 2500 ms.
+     */
+    strippedResultGraceMs?: number;
+    /**
+     * Put the tool name into the cache keys of the data hooks inside the view
+     * (`[...queryKey, toolName, args]`, see `toolQueryKey`), so two tools never
+     * share an entry. Omitted: an enclosing `AppQueryProvider`'s setting, else
+     * the 2.x key `[...queryKey, args]`. The next major makes it the default.
+     */
+    toolNameInQueryKey?: boolean;
 }
-export declare function McpAppView({ widgets, refreshToolName, builderEnabled, labels, }: McpAppViewProps): import("react").JSX.Element;
+/**
+ * The toolkit's MCP App view: lifecycle placeholder (waiting / error /
+ * cancelled), toolbar, failed-steps alert and the rendered layout (or the
+ * builder). Mounts a `ToastProvider` and binds the toolkit's own strings to
+ * the host's locale unless a `LocaleProvider` sets one, so the chrome follows
+ * the host language; `useLocale()` in consumer widgets is unaffected. Lucide
+ * icons draw at the CI stroke (2.5) throughout, the toast stack included.
+ * The widgets' data hooks fetch through an enclosing `AppQueryProvider`'s
+ * client, else the toolkit's shared `queryClient`.
+ */
+export declare function McpAppView(props: McpAppViewProps): import("react").JSX.Element;
 //# sourceMappingURL=mcp-app-view.d.ts.map

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":"AAOA,OAAO,EAOL,KAAK,gBAAgB,EAEtB,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE3D,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAEhE,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,+BA+MjB"}
+{"version":3,"file":"mcp-app-view.d.ts","sourceRoot":"","sources":["../../src/app/mcp-app-view.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAYjF,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,sCAAsC,CAAA;AAK7C,OAAO,EAOL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EAErB,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAClF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAW9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE3D,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAC/F,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAChF,YAAY,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAA;AAE1E,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;;;;OAIG;IACH,MAAM,CAAC,EAAE,gBAAgB,CAAA;IACzB,sFAAsF;IACtF,aAAa,CAAC,EAAE,mBAAmB,CAAA;IACnC;;;;OAIG;IACH,SAAS,CAAC,EAAE,aAAa,CAAA;IACzB,wEAAwE;IACxE,UAAU,CAAC,EAAE,cAAc,CAAA;IAC3B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,SAAS,CAAA;IACtD,2FAA2F;IAC3F,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;;OAGG;IACH,aAAa,CAAC,EAAE,iBAAiB,CAAA;IACjC,uFAAuF;IACvF,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B;;;;;;;;;;OAUG;IACH,qBAAqB,CAAC,EAAE,cAAc,CAAA;IACtC;;;;;;;OAOG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,+BAYhD"}