@miragon/mcp-toolkit-ui 2.7.0 → 2.8.1

package/dist/app/builder/use-builder-catalogue.d.ts

@@ -1,4 +1,4 @@
-import type { AvailableStep, KeyCatalogEntry, PipelineContext, PipelineStepRef, ReachableWidget, UnreachableWidget } from "@miragon/mcp-toolkit-core";
+import type { AvailableStep, DisplayText, KeyCatalogEntry, PipelineContext, PipelineStepRef, ReachableWidget, UnreachableWidget } from "@miragon/mcp-toolkit-core";
 import { type KeyEntry } from "./builder-model.js";
 import type { RefreshStatus } from "./labels.js";
 /**
@@ -23,10 +23,13 @@ export declare function useBuilderCatalogue({ callTool, catalogueToolName, keyEn
     liveContext: PipelineContext;
     validationIssues: string[];
     status: RefreshStatus;
+    loaded: boolean;
     refreshError: string | null;
     retryCatalogue: () => void;
     widgetById: Map<string, ReachableWidget>;
     propsSchemaByWidgetId: Map<string, Record<string, unknown>>;
+    displayByWidgetId: Map<string, DisplayText>;
+    appDisplayByName: Map<string, DisplayText>;
     paletteByApp: [string, ReachableWidget[]][];
     liveKeyCount: number;
     stepsByApp: [string, AvailableStep[]][];

package/dist/app/builder/use-builder-catalogue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-builder-catalogue.d.ts","sourceRoot":"","sources":["../../../src/app/builder/use-builder-catalogue.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,iBAAiB,EAClB,MAAM,2BAA2B,CAAA;AAElC,OAAO,EAGL,KAAK,QAAQ,EAEd,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAQhD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,iBAAiB,EACjB,UAAU,EACV,WAAW,GACZ,EAAE;IACD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1D,iBAAiB,EAAE,MAAM,CAAA;IACzB,UAAU,EAAE,QAAQ,EAAE,CAAA;IACtB,WAAW,EAAE,eAAe,EAAE,CAAA;CAC/B;;;;;;;;;;;;;;;EAqJA"}
+{"version":3,"file":"use-builder-catalogue.d.ts","sourceRoot":"","sources":["../../../src/app/builder/use-builder-catalogue.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EAEb,WAAW,EACX,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,iBAAiB,EAClB,MAAM,2BAA2B,CAAA;AAElC,OAAO,EAGL,KAAK,QAAQ,EAEd,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAmBhD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,iBAAiB,EACjB,UAAU,EACV,WAAW,GACZ,EAAE;IACD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1D,iBAAiB,EAAE,MAAM,CAAA;IACzB,UAAU,EAAE,QAAQ,EAAE,CAAA;IACtB,WAAW,EAAE,eAAe,EAAE,CAAA;CAC/B;;;;;;;;;;;;;;;;;;EA6KA"}

package/dist/app/builder/use-builder-catalogue.js

@@ -22,6 +22,9 @@ export function useBuilderCatalogue({ callTool, catalogueToolName, keyEntries, s
     const [liveCatalog, setLiveCatalog] = useState([]);
     const [liveSteps, setLiveSteps] = useState([]);
     const [liveContext, setLiveContext] = useState(EMPTY_CONTEXT);
+    // The titled apps (the palette's group headings); the catalogue leaves the
+    // field out when no app has a title.
+    const [liveApps, setLiveApps] = useState([]);
     // Pipeline validation issues from the catalogue (Finding [10]/[6]). The
     // catalogue is fail-soft, but `render-view` is fail-hard, so we surface
     // these so the user sees — before committing — that the pipeline as
@@ -33,6 +36,31 @@ export function useBuilderCatalogue({ callTool, catalogueToolName, keyEntries, s
     // instead of only `console.warn`-ing, so the user knows the palette/context
     // may be stale. Cleared on the next successful refresh.
     const [refreshError, setRefreshError] = useState(null);
+    // The first fetch has settled (answer or failure). Until then the palette
+    // shows a loading state, not "no elements" (CI §9: a skeleton while loading).
+    const [loaded, setLoaded] = useState(false);
+    // Takes over what one catalogue response carries; a field it lacks keeps
+    // the last snapshot.
+    const applySnapshot = useCallback((sc) => {
+        if (sc?.reachableWidgets)
+            setLiveReachable(sc.reachableWidgets);
+        if (sc?.unreachableWidgets)
+            setLiveUnreachable(sc.unreachableWidgets);
+        if (sc?.availableSteps)
+            setLiveSteps(sc.availableSteps);
+        if (sc?.keyCatalog)
+            setLiveCatalog(sc.keyCatalog);
+        if (sc?.context)
+            setLiveContext(toPipelineContext(sc.context));
+        // Absent `apps` means no app has a title (not "unchanged").
+        if (sc)
+            setLiveApps(sc.apps ?? []);
+        // Pipeline issues are fail-soft in the catalogue but fail-hard in
+        // render-view; surface them so the user sees the render path wouldn't
+        // run as configured (Finding [10]/[6]). Coerce undefined → [] so a
+        // fixed pipeline clears a previously-shown warning.
+        setValidationIssues(sc?.validationIssues ?? []);
+    }, []);
     const refreshBuilder = useCallback(async () => {
         setStatus("refreshing");
         try {
@@ -40,22 +68,7 @@ export function useBuilderCatalogue({ callTool, catalogueToolName, keyEntries, s
                 keys: entriesToKeys(keyEntries),
                 steps: stepEntries.filter((s) => s.step.trim().length > 0),
             });
-            const sc = parseToolResult(result);
-            if (sc?.reachableWidgets)
-                setLiveReachable(sc.reachableWidgets);
-            if (sc?.unreachableWidgets)
-                setLiveUnreachable(sc.unreachableWidgets);
-            if (sc?.availableSteps)
-                setLiveSteps(sc.availableSteps);
-            if (sc?.keyCatalog)
-                setLiveCatalog(sc.keyCatalog);
-            if (sc?.context)
-                setLiveContext(toPipelineContext(sc.context));
-            // Pipeline issues are fail-soft in the catalogue but fail-hard in
-            // render-view; surface them so the user sees the render path wouldn't
-            // run as configured (Finding [10]/[6]). Coerce undefined → [] so a
-            // fixed pipeline clears a previously-shown warning.
-            setValidationIssues(sc?.validationIssues ?? []);
+            applySnapshot(parseToolResult(result));
             // A successful fetch clears any stale failure banner.
             setRefreshError(null);
         }
@@ -73,8 +86,9 @@ export function useBuilderCatalogue({ callTool, catalogueToolName, keyEntries, s
         }
         finally {
             setStatus("idle");
+            setLoaded(true);
         }
-    }, [catalogueToolName, callTool, keyEntries, stepEntries]);
+    }, [applySnapshot, catalogueToolName, callTool, keyEntries, stepEntries]);
     const refreshRef = useRef(refreshBuilder);
     useEffect(() => {
         refreshRef.current = refreshBuilder;
@@ -122,6 +136,16 @@ export function useBuilderCatalogue({ callTool, catalogueToolName, keyEntries, s
         }
         return map;
     }, [liveReachable, liveUnreachable]);
+    // Display text (title, summary, their keys) per widget id, from both lists:
+    // a canvas cell or the props sheet may name a widget the current keys do
+    // not reach.
+    const displayByWidgetId = useMemo(() => {
+        const map = new Map();
+        for (const w of [...liveUnreachable, ...liveReachable])
+            map.set(w.id, w);
+        return map;
+    }, [liveReachable, liveUnreachable]);
+    const appDisplayByName = useMemo(() => new Map(liveApps.map((app) => [app.name, app])), [liveApps]);
     const paletteByApp = useMemo(() => {
         const groups = new Map();
         for (const w of liveReachable) {
@@ -149,10 +173,13 @@ export function useBuilderCatalogue({ callTool, catalogueToolName, keyEntries, s
         liveContext,
         validationIssues,
         status,
+        loaded,
         refreshError,
         retryCatalogue,
         widgetById,
         propsSchemaByWidgetId,
+        displayByWidgetId,
+        appDisplayByName,
         paletteByApp,
         liveKeyCount,
         stepsByApp,

package/dist/app/builder/use-builder-catalogue.js.map

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

package/dist/app/builder/use-builder-session.d.ts

@@ -0,0 +1,30 @@
+import { type BuilderView, type DraftStatus } from "./builder-model.js";
+/**
+ * Which builder view is shown and whether advanced mode is on. The data
+ * sources (keys, steps, context ids) and the catalogue are technical, so they
+ * live behind "Advanced"; switching it off leaves a now hidden view for the
+ * layout.
+ */
+export declare function useBuilderMode(): {
+    advanced: boolean;
+    view: BuilderView;
+    setView: import("react").Dispatch<import("react").SetStateAction<BuilderView>>;
+    toggleAdvanced: () => void;
+    openDataSources: () => void;
+};
+/**
+ * Inline rename feedback. The reducer rejects duplicate tab labels and bumps
+ * `renameRejectedAt`; each bump shows "name already exists" until the inline
+ * editor closes (render-phase setState, the house pattern for derived state).
+ */
+export declare function useRenameFeedback(renameRejectedAt: number, editingTabIdx: number | null): boolean;
+/**
+ * Tracks the draft against the view before editing and the last saved
+ * dashboard (see `draftStatus`). `snapshot` is the current `builderSnapshot`;
+ * the first one is the pre-edit baseline.
+ */
+export declare function useDraftStatus(snapshot: string): DraftStatus & {
+    /** Records `saved` (the snapshot that went into a saved dashboard). */
+    markSaved: (saved: string) => void;
+};
+//# sourceMappingURL=use-builder-session.d.ts.map

package/dist/app/builder/use-builder-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-builder-session.d.ts","sourceRoot":"","sources":["../../../src/app/builder/use-builder-session.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,oBAAoB,CAAA;AAM3B;;;;;GAKG;AACH,wBAAgB,cAAc;;;;;;EAc7B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,gBAAgB,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAajG;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG;IAC9D,uEAAuE;IACvE,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACnC,CAKA"}

package/dist/app/builder/use-builder-session.js

@@ -0,0 +1,58 @@
+import { useCallback, useState } from "react";
+import { draftStatus, viewAfterAdvancedToggle, } from "./builder-model.js";
+// -------------------------------------------------------------------------- //
+// Builder session state that is not the draft itself
+// -------------------------------------------------------------------------- //
+/**
+ * Which builder view is shown and whether advanced mode is on. The data
+ * sources (keys, steps, context ids) and the catalogue are technical, so they
+ * live behind "Advanced"; switching it off leaves a now hidden view for the
+ * layout.
+ */
+export function useBuilderMode() {
+    const [advanced, setAdvanced] = useState(false);
+    const [view, setView] = useState("layout");
+    const toggleAdvanced = useCallback(() => {
+        const next = !advanced;
+        setAdvanced(next);
+        setView(viewAfterAdvancedToggle(view, next));
+    }, [advanced, view]);
+    /** The empty layout's one next step: show the data sources. */
+    const openDataSources = useCallback(() => {
+        setAdvanced(true);
+        setView("pipeline");
+    }, []);
+    return { advanced, view, setView, toggleAdvanced, openDataSources };
+}
+/**
+ * Inline rename feedback. The reducer rejects duplicate tab labels and bumps
+ * `renameRejectedAt`; each bump shows "name already exists" until the inline
+ * editor closes (render-phase setState, the house pattern for derived state).
+ */
+export function useRenameFeedback(renameRejectedAt, editingTabIdx) {
+    const [renameRejected, setRenameRejected] = useState(false);
+    const [prevRenameRejectedAt, setPrevRenameRejectedAt] = useState(renameRejectedAt);
+    if (renameRejectedAt !== prevRenameRejectedAt) {
+        setPrevRenameRejectedAt(renameRejectedAt);
+        setRenameRejected(true);
+    }
+    const [prevEditingTabIdx, setPrevEditingTabIdx] = useState(editingTabIdx);
+    if (editingTabIdx !== prevEditingTabIdx) {
+        setPrevEditingTabIdx(editingTabIdx);
+        if (editingTabIdx === null)
+            setRenameRejected(false);
+    }
+    return renameRejected;
+}
+/**
+ * Tracks the draft against the view before editing and the last saved
+ * dashboard (see `draftStatus`). `snapshot` is the current `builderSnapshot`;
+ * the first one is the pre-edit baseline.
+ */
+export function useDraftStatus(snapshot) {
+    const [baseline] = useState(snapshot);
+    const [saved, setSaved] = useState(null);
+    const markSaved = useCallback((value) => setSaved(value), []);
+    return { ...draftStatus(snapshot, baseline, saved), markSaved };
+}
+//# sourceMappingURL=use-builder-session.js.map

package/dist/app/builder/use-builder-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-builder-session.js","sourceRoot":"","sources":["../../../src/app/builder/use-builder-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAC7C,OAAO,EACL,WAAW,EACX,uBAAuB,GAGxB,MAAM,oBAAoB,CAAA;AAE3B,gFAAgF;AAChF,qDAAqD;AACrD,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC/C,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAc,QAAQ,CAAC,CAAA;IACvD,MAAM,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE;QACtC,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAA;QACtB,WAAW,CAAC,IAAI,CAAC,CAAA;QACjB,OAAO,CAAC,uBAAuB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;IAC9C,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAA;IACpB,+DAA+D;IAC/D,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE;QACvC,WAAW,CAAC,IAAI,CAAC,CAAA;QACjB,OAAO,CAAC,UAAU,CAAC,CAAA;IACrB,CAAC,EAAE,EAAE,CAAC,CAAA;IACN,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,CAAA;AACrE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,gBAAwB,EAAE,aAA4B;IACtF,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC3D,MAAM,CAAC,oBAAoB,EAAE,uBAAuB,CAAC,GAAG,QAAQ,CAAC,gBAAgB,CAAC,CAAA;IAClF,IAAI,gBAAgB,KAAK,oBAAoB,EAAE,CAAC;QAC9C,uBAAuB,CAAC,gBAAgB,CAAC,CAAA;QACzC,iBAAiB,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IACD,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAA;IACzE,IAAI,aAAa,KAAK,iBAAiB,EAAE,CAAC;QACxC,oBAAoB,CAAC,aAAa,CAAC,CAAA;QACnC,IAAI,aAAa,KAAK,IAAI;YAAE,iBAAiB,CAAC,KAAK,CAAC,CAAA;IACtD,CAAC;IACD,OAAO,cAAc,CAAA;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAI7C,MAAM,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAA;IACrC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAA;IACvD,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,KAAa,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAA;IACrE,OAAO,EAAE,GAAG,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,SAAS,EAAE,CAAA;AACjE,CAAC"}

package/dist/app/builder/use-display-resolver.d.ts

@@ -0,0 +1,17 @@
+import { type DisplayKeyResolver } from "./builder-model.js";
+/** What the builder needs to turn a definition's display text into words. */
+export interface DisplayResolver {
+    /** The locale the builder's own text is in (a `LocaleProvider`'s, else the host's). */
+    locale: string;
+    /** Resolves a `titleKey`/`summaryKey` through the `LocaleProvider`'s translator. */
+    resolveKey: DisplayKeyResolver;
+}
+/**
+ * Binds `displayLabel` / `propFieldText` to the builder's locale: inline
+ * per-locale titles follow the same language as the builder chrome around
+ * them, and i18n keys resolve through the nearest `LocaleProvider`'s
+ * translator (outside one, keys stay unknown and the inline text or the id
+ * shows instead).
+ */
+export declare function useDisplayResolver(): DisplayResolver;
+//# sourceMappingURL=use-display-resolver.d.ts.map

package/dist/app/builder/use-display-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-display-resolver.d.ts","sourceRoot":"","sources":["../../../src/app/builder/use-display-resolver.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAE7E,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,uFAAuF;IACvF,MAAM,EAAE,MAAM,CAAA;IACd,oFAAoF;IACpF,UAAU,EAAE,kBAAkB,CAAA;CAC/B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAIpD"}

package/dist/app/builder/use-display-resolver.js

@@ -0,0 +1,16 @@
+import { useMemo } from "react";
+import { useToolkitLocale, useTranslate } from "../../locale/locale-provider.js";
+import { keyResolverFrom } from "./builder-model.js";
+/**
+ * Binds `displayLabel` / `propFieldText` to the builder's locale: inline
+ * per-locale titles follow the same language as the builder chrome around
+ * them, and i18n keys resolve through the nearest `LocaleProvider`'s
+ * translator (outside one, keys stay unknown and the inline text or the id
+ * shows instead).
+ */
+export function useDisplayResolver() {
+    const locale = useToolkitLocale();
+    const translate = useTranslate();
+    return useMemo(() => ({ locale, resolveKey: keyResolverFrom(translate) }), [locale, translate]);
+}
+//# sourceMappingURL=use-display-resolver.js.map

package/dist/app/builder/use-display-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-display-resolver.js","sourceRoot":"","sources":["../../../src/app/builder/use-display-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAA;AAChF,OAAO,EAAE,eAAe,EAA2B,MAAM,oBAAoB,CAAA;AAU7E;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAA;IACjC,MAAM,SAAS,GAAG,YAAY,EAAE,CAAA;IAChC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAA;AACjG,CAAC"}

package/dist/app/index.d.ts

@@ -1,17 +1,22 @@
 export { McpAppView } from "./mcp-app-view.js";
-export type { McpAppViewProps, McpAppViewLabels, DescribeStep, DescribeViewError, ViewTitleLevel, ViewTitleMode, } from "./mcp-app-view.js";
+export type { McpAppViewProps, McpAppViewLabels, DescribeStep, DescribeViewError, ViewErrorKind, RecoveryPolicy, ViewTitleLevel, ViewTitleMode, } from "./mcp-app-view.js";
 export { McpToolkitApp, mountMcpToolkitApp } from "./mcp-toolkit-app.js";
+export { installToolResultObserver } from "../lib/tool-result-observer.js";
+export type { ToolObservation, ToolResultObserver } from "../lib/tool-result-observer.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, HostModelContext } from "./adapt-data-widget.js";
+export type { BuilderExitCommit } from "./builder/builder-model.js";
+export { adaptDataWidget } from "./adapt-data-widget.js";
+export { HostModelContext, useHostModelContext } from "./model-context.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, 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 { McpUseHostBridgeProvider } from "./mcp-use-host-bridge.js";
+export { useIsInsideMcpUseView } from "./model-context.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,EACV,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,aAAa,GACd,MAAM,mBAAmB,CAAA;AAC1B,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/app/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,cAAc,EACd,aAAa,GACd,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAIxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAA;AAC1E,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AACzF,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;AAClF,YAAY,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAInE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,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,MAAM,0BAA0B,CAAA;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAK1D,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,17 +1,23 @@
 export { McpAppView } from "./mcp-app-view.js";
 export { McpToolkitApp, mountMcpToolkitApp } from "./mcp-toolkit-app.js";
+// The passive host-lifecycle observer behind the stripped-result recovery
+// (toolkit#176): installed as the bundle evaluates; a custom shell may call it
+// explicitly before its own `bootstrapView`.
+export { installToolResultObserver } from "../lib/tool-result-observer.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, the 2.x
 // view hooks) — exported from this subpath only, never the root barrel.
-export { adaptDataWidget, HostModelContext } from "./adapt-data-widget.js";
+export { adaptDataWidget } from "./adapt-data-widget.js";
+export { HostModelContext, useHostModelContext } from "./model-context.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 mcp-use adapter imports
 // `mcp-use/react` — never the root barrel.
 export { HostBridgeProvider, useHostBridge, useHostBridgeOrNull, toHostBridge, createChatGptHostBridge, createStandaloneHostBridge, } from "./host-bridge.js";
-export { McpUseHostBridgeProvider, useIsInsideMcpUseView } from "./mcp-use-host-bridge.js";
+export { McpUseHostBridgeProvider } from "./mcp-use-host-bridge.js";
+export { useIsInsideMcpUseView } from "./model-context.js";
 // Storybook-style harness for developing widgets in isolation with fixture
 // data and a simulated HostBridge. Lives under ./app to keep every host-facing
 // surface on one subpath — never the root barrel.

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;AAS9C,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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/app/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAW9C,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACxE,0EAA0E;AAC1E,+EAA+E;AAC/E,6CAA6C;AAC7C,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAA;AAE1E,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,gBAAgB,GACjB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAInD,6EAA6E;AAC7E,wEAAwE;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,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,MAAM,0BAA0B,CAAA;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,2EAA2E;AAC3E,+EAA+E;AAC/E,kDAAkD;AAClD,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,cAAc,GACf,MAAM,qBAAqB,CAAA"}

package/dist/app/layout-builder.d.ts

@@ -1,4 +1,5 @@
 import type { LayoutConfig, PipelineStepRef } from "@miragon/mcp-toolkit-core";
+import { type BuilderExitCommit } from "./builder/builder-model.js";
 import type { LayoutBuilderLabels } from "./builder/labels.js";
 import { type WidgetComponent } from "./widget-renderer.js";
 export type { LayoutBuilderLabels } from "./builder/labels.js";
@@ -19,34 +20,21 @@ export interface LayoutBuilderProps {
         name: string;
     }) => void;
     /**
-     * Called when the user clicks "Done" / exits the builder. Receives
-     * the final draft so the parent can swap into the rendered view with
-     * the just-built layout. Omit `commit` to leave parent state untouched.
+     * Leaves the builder. "Apply" calls it WITH the final draft (`commit`) so
+     * the parent swaps the just-built layout into its view; "Discard" calls it
+     * WITHOUT one, so the parent keeps the view as it was before editing (after
+     * a confirmation when the draft changed it). Without `onExit` the builder
+     * has no Apply, and Discard resets the draft in place.
      */
-    onExit?: (commit?: {
-        layout: LayoutConfig;
-        keys?: Record<string, unknown>;
-        steps?: PipelineStepRef[];
-        title?: string;
-        context?: {
-            keys: Record<string, unknown>;
-            stepIds: string[];
-            stepData: Record<string, {
-                data: unknown;
-                keys: Record<string, unknown>;
-                _app: string;
-                _dataType: string;
-            }>;
-            errors: {
-                stepId: string;
-                reason: string;
-            }[];
-        };
-    }) => void;
+    onExit?: (commit?: BuilderExitCommit) => void;
 }
 /**
- * The visual view builder. Confirms a successful save with a toast (it mounts
- * a `ToastProvider` when none is above it — inside `McpAppView` it shares the
+ * The visual view builder. People see widgets and steps by their titles
+ * (`title`/`titleKey` of the definitions, else the id); the data sources, the
+ * catalogue and the technical ids sit behind "Advanced". "Apply" shows the
+ * draft in the view, "Save as dashboard" stores it, "Discard" restores the
+ * view as it was. Confirms a successful save with a toast (it mounts a
+ * `ToastProvider` when none is above it — inside `McpAppView` it shares the
  * view's). Every caption follows the active locale (`labels` overrides).
  */
 export declare function LayoutBuilder(props: LayoutBuilderProps): import("react").JSX.Element;

package/dist/app/layout-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layout-builder.d.ts","sourceRoot":"","sources":["../../src/app/layout-builder.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAuB,MAAM,2BAA2B,CAAA;AAOnG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAgB9D,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAO3D,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAM9D,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,EAAE,YAAY,CAAA;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,YAAY,CAAC,EAAE,eAAe,EAAE,CAAA;IAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IACxC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1D,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,mBAAmB,CAAA;IAC5B,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IACxD;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE;QACjB,MAAM,EAAE,YAAY,CAAA;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC9B,KAAK,CAAC,EAAE,eAAe,EAAE,CAAA;QACzB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,OAAO,CAAC,EAAE;YACR,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;YAC7B,OAAO,EAAE,MAAM,EAAE,CAAA;YACjB,QAAQ,EAAE,MAAM,CACd,MAAM,EACN;gBAAE,IAAI,EAAE,OAAO,CAAC;gBAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAAC,IAAI,EAAE,MAAM,CAAC;gBAAC,SAAS,EAAE,MAAM,CAAA;aAAE,CAClF,CAAA;YACD,MAAM,EAAE;gBAAE,MAAM,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,CAAA;aAAE,EAAE,CAAA;SAC7C,CAAA;KACF,KAAK,IAAI,CAAA;CACX;AAMD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,+BAMtD"}
+{"version":3,"file":"layout-builder.d.ts","sourceRoot":"","sources":["../../src/app/layout-builder.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAuB,MAAM,2BAA2B,CAAA;AACnG,OAAO,EAOL,KAAK,iBAAiB,EAEvB,MAAM,4BAA4B,CAAA;AAMnC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAmB9D,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAO3D,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAM9D,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,EAAE,YAAY,CAAA;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,YAAY,CAAC,EAAE,eAAe,EAAE,CAAA;IAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IACxC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1D,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,mBAAmB,CAAA;IAC5B,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IACxD;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAA;CAC9C;AAMD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,+BActD"}