@miragon/pulse-widget-shell 0.0.0-stage → 0.22.0

package/dist/ui/view-meta.test.js

@@ -0,0 +1,92 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// @vitest-environment happy-dom
+import { afterEach, describe, expect, it } from "vitest";
+import { cleanup, render } from "@testing-library/react";
+import { catalogTextFindings } from "../testing/index.js";
+import { setFormatLocale } from "./format.js";
+import { VIEW_META_LABELS, ViewMeta, formatLookback, formatViewMeta } from "./view-meta.js";
+afterEach(() => {
+    cleanup();
+    setFormatLocale(undefined);
+});
+const NOW = new Date("2026-10-10T12:40:00.000Z");
+const AS_OF = "2026-10-10T12:32:00.000Z";
+/** The formatters keep a number and its unit together with a non-breaking space. */
+const plain = (s) => s.replace(/\u00a0/g, " ");
+const german = () => setFormatLocale({ language: "de", locale: "de-DE", timeZone: "Europe/Berlin" });
+const english = () => setFormatLocale({ language: "en", locale: "en-GB", timeZone: "Europe/Berlin" });
+describe("formatLookback — a period token as the frame of a view", () => {
+    it("names the last n units in German and English", () => {
+        german();
+        expect(plain(formatLookback("7d"))).toBe("Letzte 7 Tage");
+        expect(plain(formatLookback("30d"))).toBe("Letzte 30 Tage");
+        expect(plain(formatLookback("2w"))).toBe("Letzte 2 Wochen");
+        english();
+        expect(plain(formatLookback("7d"))).toBe("Last 7 days");
+        expect(plain(formatLookback("14d"))).toBe("Last 14 days");
+    });
+    it("reads a single day or week as its length, never as yesterday or last week", () => {
+        german();
+        expect(plain(formatLookback("1d"))).toBe("Letzte 24 Stunden");
+        expect(plain(formatLookback("1w"))).toBe("Letzte 7 Tage");
+        expect(plain(formatLookback("1h"))).toBe("Letzte Stunde");
+        expect(plain(formatLookback("1m"))).toBe("Letzte Minute");
+        english();
+        expect(plain(formatLookback("1d"))).toBe("Last 24 hours");
+        expect(plain(formatLookback("1H"))).toBe("Last hour");
+        expect(plain(formatLookback("1m"))).toBe("Last minute");
+    });
+    it("passes a custom window through and renders nothing for no period", () => {
+        english();
+        expect(plain(formatLookback("since Monday"))).toBe("since Monday");
+        expect(plain(formatLookback(undefined))).toBe("");
+        expect(plain(formatLookback(""))).toBe("");
+    });
+});
+describe("formatViewMeta — period · engines · as-of", () => {
+    it("joins the known parts in German (the U7 reference line)", () => {
+        german();
+        expect(plain(formatViewMeta({ period: formatLookback("7d"), engines: { count: 6, silent: 3 }, asOf: AS_OF }, NOW))).toBe("Letzte 7 Tage · 6 Engines (3 ohne Metriken) · Stand 14:32");
+    });
+    it("joins the known parts in English, the subject first", () => {
+        english();
+        expect(plain(formatViewMeta({
+            subject: "order",
+            period: formatLookback("14d"),
+            engines: { count: 1 },
+            asOf: AS_OF,
+        }, NOW))).toBe("order · Last 14 days · 1 engine · As of 14:32");
+    });
+    it("leaves out what is unknown: no silent count, no period, a broken timestamp", () => {
+        german();
+        expect(formatViewMeta({ engines: { count: 2, silent: 0 }, asOf: "kaputt" }, NOW)).toBe("2 Engines");
+        expect(formatViewMeta({ engines: { count: 1, silent: null } }, NOW)).toBe("1 Engine");
+        expect(formatViewMeta({}, NOW)).toBe("");
+    });
+    it("dates an as-of time that is not from today", () => {
+        german();
+        expect(formatViewMeta({ asOf: "2026-10-08T07:05:00.000Z" }, NOW)).toBe("Stand 8.10.2026, 09:05");
+    });
+});
+describe("ViewMeta", () => {
+    it("renders the line as quiet text", () => {
+        english();
+        const { container } = render(_jsx(ViewMeta, { engines: { count: 3, silent: 1 } }));
+        const line = container.querySelector("[data-view-meta]");
+        expect(line?.textContent).toBe("3 engines (1 without metrics)");
+        expect(line?.className).toContain("text-muted-foreground");
+    });
+    it("renders nothing when no part is known", () => {
+        const { container } = render(_jsx(ViewMeta, { period: null }));
+        expect(container.innerHTML).toBe("");
+    });
+});
+describe("the meta line's words follow the voice rules", () => {
+    it.each([
+        ["de", VIEW_META_LABELS.de],
+        ["en", VIEW_META_LABELS.en],
+    ])("%s", (language, catalog) => {
+        expect(catalogTextFindings(catalog, { language })).toEqual([]);
+    });
+});
+//# sourceMappingURL=view-meta.test.js.map

package/dist/ui/view-meta.test.js.map

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

package/dist/ui/view-refresh-state.d.ts

@@ -0,0 +1,26 @@
+import type { ViewDataResult } from "@miragon/mcp-toolkit-ui/hooks";
+/** What a seeded view knows about re-reading the data it shows. */
+export interface ViewRefreshState {
+    /**
+     * A REFETCH of the data on screen failed: the view can no longer confirm it
+     * is current (an instance that ended answers 404 now). Set from the
+     * refetch's FIRST failed attempt — the toolkit's `failureReason`, while the
+     * client still retries (TanStack's default: 3 retries, ~7 s) — not only
+     * once `error` lands, so a view gating its writes on it never offers them
+     * on an unconfirmed state for the length of the backoff. Null while the
+     * data is the feed's latest answer, and null without data (that failure is
+     * the load error).
+     */
+    refreshError: Error | null;
+    /** A refetch of the data on screen is in flight. */
+    refreshing: boolean;
+}
+/**
+ * The refresh half of a view whose tool result SEEDS a live feed (the
+ * toolkit's `useViewData(…, { initialDataMode: "seed" })`): the toolkit hands
+ * out the raw query state (`error`, `failureReason`, `isFetching`), this is
+ * the house rule over it — the one place that decides when shown data counts
+ * as unconfirmed (`useDetailView`, the engine overview).
+ */
+export declare function viewRefreshState(view: Pick<ViewDataResult<unknown>, "data" | "error" | "failureReason" | "isFetching">): ViewRefreshState;
+//# sourceMappingURL=view-refresh-state.d.ts.map

package/dist/ui/view-refresh-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-refresh-state.d.ts","sourceRoot":"","sources":["../../src/ui/view-refresh-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAEnE,mEAAmE;AACnE,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;OASG;IACH,YAAY,EAAE,KAAK,GAAG,IAAI,CAAA;IAC1B,oDAAoD;IACpD,UAAU,EAAE,OAAO,CAAA;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,eAAe,GAAG,YAAY,CAAC,GACrF,gBAAgB,CAMlB"}

package/dist/ui/view-refresh-state.js

@@ -0,0 +1,15 @@
+/**
+ * The refresh half of a view whose tool result SEEDS a live feed (the
+ * toolkit's `useViewData(…, { initialDataMode: "seed" })`): the toolkit hands
+ * out the raw query state (`error`, `failureReason`, `isFetching`), this is
+ * the house rule over it — the one place that decides when shown data counts
+ * as unconfirmed (`useDetailView`, the engine overview).
+ */
+export function viewRefreshState(view) {
+    const shown = view.data !== null;
+    return {
+        refreshError: shown ? (view.error ?? view.failureReason) : null,
+        refreshing: shown && view.isFetching,
+    };
+}
+//# sourceMappingURL=view-refresh-state.js.map

package/dist/ui/view-refresh-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-refresh-state.js","sourceRoot":"","sources":["../../src/ui/view-refresh-state.ts"],"names":[],"mappings":"AAmBA;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAsF;IAEtF,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAA;IAChC,OAAO;QACL,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI;QAC/D,UAAU,EAAE,KAAK,IAAI,IAAI,CAAC,UAAU;KACrC,CAAA;AACH,CAAC"}

package/dist/ui/widget-shell.d.ts

@@ -0,0 +1,24 @@
+import { type ReactNode } from "react";
+/** Provide the host-reported display mode to the widget tree (bundle root only). */
+export declare function DisplayModeProvider({ mode, children }: {
+    mode: string;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** The host-reported display mode for this subtree (`"inline"` outside a host). */
+export declare function useHostDisplayMode(): string;
+/**
+ * Top-level container for a Miragon-styled widget. Sets max-width, padding,
+ * background, and the default text/font conventions used by all dashboards.
+ * Nesting-aware: an inner WidgetShell keeps only the section stack (gap), so a
+ * widget that owns a shell can be embedded under an app-level shell unchanged.
+ *
+ * Padding on the CI grid: 24 px, 16 px below 640 px (an inline view on a
+ * phone or in a narrow chat column). Every child may shrink below its content
+ * (`min-w-0`), so a wide table scrolls inside its own region (`ListTable`)
+ * instead of widening the document.
+ */
+export declare function WidgetShell({ children, className }: {
+    children: ReactNode;
+    className?: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=widget-shell.d.ts.map

package/dist/ui/widget-shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-shell.d.ts","sourceRoot":"","sources":["../../src/ui/widget-shell.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAoBjE,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,+BAE5F;AAED,mFAAmF;AACnF,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,+BAsB/F"}

package/dist/ui/widget-shell.js

@@ -0,0 +1,50 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from "react";
+import { cn } from "@miragon/mcp-toolkit-ui";
+/**
+ * True below an already-rendered WidgetShell. Widgets wrap themselves in a
+ * shell so they work standalone; composed hosts (the cockpit) also wrap the
+ * whole app in one — without this flag every embedded widget would stack a
+ * second layer of background, padding and max-width inside the first.
+ */
+const InsideShellContext = createContext(false);
+/**
+ * The host's display mode for the current render. mcp-use 2.x's
+ * `useDisplayMode` only works inside a `bootstrapView`-mounted view, so the
+ * value is provided from the bundle root (where that hook is legal) and
+ * defaults to `"inline"` everywhere else (unit renders, fixtures, standalone
+ * embeds) — exactly the pre-2.x fallback behaviour.
+ */
+const DisplayModeContext = createContext("inline");
+/** Provide the host-reported display mode to the widget tree (bundle root only). */
+export function DisplayModeProvider({ mode, children }) {
+    return _jsx(DisplayModeContext.Provider, { value: mode, children: children });
+}
+/** The host-reported display mode for this subtree (`"inline"` outside a host). */
+export function useHostDisplayMode() {
+    return useContext(DisplayModeContext);
+}
+/**
+ * Top-level container for a Miragon-styled widget. Sets max-width, padding,
+ * background, and the default text/font conventions used by all dashboards.
+ * Nesting-aware: an inner WidgetShell keeps only the section stack (gap), so a
+ * widget that owns a shell can be embedded under an app-level shell unchanged.
+ *
+ * Padding on the CI grid: 24 px, 16 px below 640 px (an inline view on a
+ * phone or in a narrow chat column). Every child may shrink below its content
+ * (`min-w-0`), so a wide table scrolls inside its own region (`ListTable`)
+ * instead of widening the document.
+ */
+export function WidgetShell({ children, className }) {
+    const nested = useContext(InsideShellContext);
+    const displayMode = useContext(DisplayModeContext);
+    // Nested: drop background, padding, max-width and centering (the outer shell
+    // owns those), but keep the internal section stack — widgets rely on the
+    // shell's gap for the spacing between their own header/KPIs/tables.
+    if (nested) {
+        return _jsx("div", { className: cn("flex min-w-0 flex-col gap-6", className), children: children });
+    }
+    const isFullscreen = displayMode === "fullscreen";
+    return (_jsx(InsideShellContext.Provider, { value: true, children: _jsx("div", { className: cn("bg-card text-card-foreground min-h-full min-w-0", className), children: _jsx("div", { className: `mx-auto flex min-w-0 flex-col gap-6 p-4 sm:p-6 ${isFullscreen ? "max-w-full" : "max-w-7xl"}`, children: children }) }) }));
+}
+//# sourceMappingURL=widget-shell.js.map

package/dist/ui/widget-shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-shell.js","sourceRoot":"","sources":["../../src/ui/widget-shell.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAA;AACjE,OAAO,EAAE,EAAE,EAAE,MAAM,yBAAyB,CAAA;AAE5C;;;;;GAKG;AACH,MAAM,kBAAkB,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;AAE/C;;;;;;GAMG;AACH,MAAM,kBAAkB,GAAG,aAAa,CAAS,QAAQ,CAAC,CAAA;AAE1D,oFAAoF;AACpF,MAAM,UAAU,mBAAmB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAyC;IAC3F,OAAO,KAAC,kBAAkB,CAAC,QAAQ,IAAC,KAAK,EAAE,IAAI,YAAG,QAAQ,GAA+B,CAAA;AAC3F,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,kBAAkB;IAChC,OAAO,UAAU,CAAC,kBAAkB,CAAC,CAAA;AACvC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,EAAE,QAAQ,EAAE,SAAS,EAA+C;IAC9F,MAAM,MAAM,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAA;IAC7C,MAAM,WAAW,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAA;IAClD,6EAA6E;IAC7E,yEAAyE;IACzE,oEAAoE;IACpE,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,cAAK,SAAS,EAAE,EAAE,CAAC,6BAA6B,EAAE,SAAS,CAAC,YAAG,QAAQ,GAAO,CAAA;IACvF,CAAC;IAED,MAAM,YAAY,GAAG,WAAW,KAAK,YAAY,CAAA;IACjD,OAAO,CACL,KAAC,kBAAkB,CAAC,QAAQ,IAAC,KAAK,EAAE,IAAI,YACtC,cAAK,SAAS,EAAE,EAAE,CAAC,iDAAiD,EAAE,SAAS,CAAC,YAC9E,cACE,SAAS,EAAE,kDAAkD,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,EAAE,YAEvG,QAAQ,GACL,GACF,GACsB,CAC/B,CAAA;AACH,CAAC"}

package/dist/ui/widget-shell.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=widget-shell.test.d.ts.map

package/dist/ui/widget-shell.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-shell.test.d.ts","sourceRoot":"","sources":["../../src/ui/widget-shell.test.tsx"],"names":[],"mappings":""}

package/dist/ui/widget-shell.test.js

@@ -0,0 +1,41 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+// @vitest-environment happy-dom
+import { afterEach, describe, expect, it } from "vitest";
+import { cleanup, render, screen } from "@testing-library/react";
+import { DisplayModeProvider, WidgetShell, useHostDisplayMode } from "./widget-shell.js";
+afterEach(cleanup);
+/** The frame div that carries the max-width — the content's direct parent. */
+const frameOf = (testId) => screen.getByTestId(testId).parentElement;
+describe("WidgetShell", () => {
+    it("caps the width inline and lets a fullscreen host have it all", () => {
+        render(_jsxs(_Fragment, { children: [_jsx(WidgetShell, { children: _jsx("p", { "data-testid": "inline", children: "a" }) }), _jsx(DisplayModeProvider, { mode: "fullscreen", children: _jsx(WidgetShell, { children: _jsx("p", { "data-testid": "fullscreen", children: "b" }) }) })] }));
+        expect(frameOf("inline").className).toContain("max-w-7xl");
+        expect(frameOf("fullscreen").className).toContain("max-w-full");
+    });
+    it("pads on the CI grid (24 px, 16 px below 640 px) and lets its content shrink", () => {
+        render(_jsx(WidgetShell, { children: _jsx("p", { "data-testid": "content", children: "a" }) }));
+        const frame = frameOf("content").className.split(" ");
+        expect(frame).toEqual(expect.arrayContaining(["p-4", "sm:p-6", "min-w-0"]));
+        expect(frame).not.toContain("px-9");
+        expect(frameOf("content").parentElement.className).toContain("min-w-0");
+    });
+    it("nested under another shell keeps only the section stack", () => {
+        render(_jsx(WidgetShell, { children: _jsx(WidgetShell, { className: "extra", children: _jsx("p", { "data-testid": "inner", children: "c" }) }) }));
+        const inner = frameOf("inner");
+        expect(inner.className).toBe("flex min-w-0 flex-col gap-6 extra");
+        // Exactly one card surface: the outer shell's.
+        expect(document.querySelectorAll(".bg-card")).toHaveLength(1);
+    });
+});
+describe("useHostDisplayMode", () => {
+    function Mode() {
+        return _jsx("span", { "data-testid": "mode", children: useHostDisplayMode() });
+    }
+    it('defaults to "inline" outside a host and reports the provided mode inside one', () => {
+        render(_jsxs(_Fragment, { children: [_jsx(Mode, {}), _jsx(DisplayModeProvider, { mode: "pip", children: _jsx(Mode, {}) })] }));
+        const [outside, inside] = screen.getAllByTestId("mode");
+        expect(outside.textContent).toBe("inline");
+        expect(inside.textContent).toBe("pip");
+    });
+});
+//# sourceMappingURL=widget-shell.test.js.map

package/dist/ui/widget-shell.test.js.map

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

package/dist/view-results.d.ts

@@ -0,0 +1,42 @@
+import { type ComposedViewInput, type SingleWidgetViewInput } from "@miragon/mcp-toolkit-core";
+/**
+ * The tool results every module returns, in one module of their own so the
+ * shell's own tools (`shell-settings.ts`) use them without importing the
+ * `/server` barrel that re-exports them.
+ */
+/**
+ * mcp-use's raw `server.tool()` callback expects a result with an implicit
+ * string index signature, which TypeScript synthesizes for anonymous object
+ * types but NOT for the toolkit's named `ViewToolResult` interface. Re-annotate
+ * the builders' return as that anonymous shape (the runtime value is the
+ * toolkit's, unchanged) so the eager `*_show_*` handlers stay assignable.
+ */
+type ViewResult = {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: Record<string, unknown>;
+};
+export declare const buildSingleWidgetView: (input: SingleWidgetViewInput) => ViewResult;
+export declare const buildComposedView: (input: ComposedViewInput) => ViewResult;
+/** An app-only feed's result: the payload once, as compact JSON text. */
+type FeedResult = {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+/**
+ * Plain (no-UI) tool result for an app-only `*_data` feed: the JSON payload
+ * ONCE, as compact text, deliberately free of widget `_meta` keys — a
+ * widget-tool result (`ui.resourceUri`) would be rendered by the host instead
+ * of being returned to the in-widget `callTool()` (architecture invariant 5).
+ * Text, not `structuredContent`: the widgets read either (the toolkit's
+ * `parseToolResult` falls back to the JSON text), a host that strips
+ * `structuredContent` keeps text, and sending both doubled every feed.
+ * The single shared implementation for every module's data feeds.
+ */
+export declare const buildDataFeedResult: (data: Record<string, unknown>) => FeedResult;
+export {};
+//# sourceMappingURL=view-results.d.ts.map

package/dist/view-results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-results.d.ts","sourceRoot":"","sources":["../src/view-results.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC3B,MAAM,2BAA2B,CAAA;AAElC;;;;GAIG;AAEH;;;;;;GAMG;AACH,KAAK,UAAU,GAAG;IAChB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACzC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC3C,CAAA;AAED,eAAO,MAAM,qBAAqB,GAAI,OAAO,qBAAqB,KAAG,UACnC,CAAA;AAElC,eAAO,MAAM,iBAAiB,GAAI,OAAO,iBAAiB,KAAG,UAC/B,CAAA;AAE9B,yEAAyE;AACzE,KAAK,UAAU,GAAG;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAAA;AAE/D;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,UAElE,CAAA"}

package/dist/view-results.js

@@ -0,0 +1,17 @@
+import { buildComposedView as buildComposedViewCore, buildSingleWidgetView as buildSingleWidgetViewCore, } from "@miragon/mcp-toolkit-core";
+export const buildSingleWidgetView = (input) => buildSingleWidgetViewCore(input);
+export const buildComposedView = (input) => buildComposedViewCore(input);
+/**
+ * Plain (no-UI) tool result for an app-only `*_data` feed: the JSON payload
+ * ONCE, as compact text, deliberately free of widget `_meta` keys — a
+ * widget-tool result (`ui.resourceUri`) would be rendered by the host instead
+ * of being returned to the in-widget `callTool()` (architecture invariant 5).
+ * Text, not `structuredContent`: the widgets read either (the toolkit's
+ * `parseToolResult` falls back to the JSON text), a host that strips
+ * `structuredContent` keeps text, and sending both doubled every feed.
+ * The single shared implementation for every module's data feeds.
+ */
+export const buildDataFeedResult = (data) => ({
+    content: [{ type: "text", text: JSON.stringify(data) }],
+});
+//# sourceMappingURL=view-results.js.map

package/dist/view-results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-results.js","sourceRoot":"","sources":["../src/view-results.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,IAAI,qBAAqB,EAC1C,qBAAqB,IAAI,yBAAyB,GAGnD,MAAM,2BAA2B,CAAA;AAoBlC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAA4B,EAAc,EAAE,CAChF,yBAAyB,CAAC,KAAK,CAAC,CAAA;AAElC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAwB,EAAc,EAAE,CACxE,qBAAqB,CAAC,KAAK,CAAC,CAAA;AAK9B;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAA6B,EAAc,EAAE,CAAC,CAAC;IACjF,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;CACxD,CAAC,CAAA"}

package/dist/widget-meta-defaults.d.ts

@@ -0,0 +1,48 @@
+/**
+ * The app-level widget defaults (`createFrameworkApp`'s `app.csp`) on EVERY
+ * view-bound tool, not only on the framework's own `render-view`.
+ *
+ * The toolkit threads them into each plugin's `registerWidgetTools(server,
+ * metaDefaults)` and leaves it to the plugin to forward them; the modules
+ * here register their `*_show_*` tools through `showToolBinding`, which knows
+ * nothing about the app. Instead of threading the defaults through every
+ * module and call site, `createComposedServer` wraps each plugin once
+ * ({@link honorWidgetMetaDefaults}, a Proxy that keeps the plugin as each
+ * hook's `this`): the server its hook receives merges the
+ * view CSP into each `view` binding (`_meta.ui.csp` on the view resource,
+ * `resources/list` included) and the Apps SDK CSP into each widget tool's
+ * `openai/widgetCSP` — so a custom module in a composed server advertises
+ * the same contract without an edit. What the tool states itself comes
+ * first; the defaults are appended, each origin once.
+ */
+import type { AppPlugin } from "@miragon/mcp-toolkit-core";
+import type { MCPServer } from "mcp-use";
+/** The defaults the toolkit hands to `registerWidgetTools` (not exported by the toolkit). */
+export type WidgetMetaDefaults = NonNullable<Parameters<NonNullable<AppPlugin["registerWidgetTools"]>>[1]>;
+/** A CSP shape: lists of origins by directive (`AppResourceCsp`, the Apps SDK `WidgetCspMeta`). */
+type DomainLists = object;
+/** Each list of `defaults` appended to the same list of `own`, each entry once. */
+export declare function mergeDomainLists<T extends DomainLists>(own: T | undefined, defaults: T): T;
+/**
+ * A view of `server` whose `tool()` registrations carry `defaults` (see the
+ * module comment). Without defaults it is `server` itself. A Proxy, not a
+ * copy: every other member is the real server's, bound to it, so mcp-use's
+ * internals and the toolkit's per-module tool owner keep working.
+ */
+export declare function withWidgetMetaDefaults(server: MCPServer, defaults: WidgetMetaDefaults | undefined): MCPServer;
+/**
+ * `plugin`, its `registerWidgetTools` handed a server that applies the
+ * defaults the toolkit passes it ({@link withWidgetMetaDefaults}).
+ *
+ * A Proxy, not a copy: a spread keeps only own enumerable properties, so a
+ * class-based module would lose its prototype hooks (`registerTools`) without
+ * a warning. Every hook, the wrapped one included, runs with the plugin
+ * itself as `this` — as when the toolkit calls it on the original object —
+ * so `this` reads and writes, private fields and method shorthand keep
+ * working. The Proxy's target is a child of the plugin, not the plugin, so
+ * a frozen plugin can still be wrapped (a Proxy over it could not report a
+ * different `registerWidgetTools`).
+ */
+export declare function honorWidgetMetaDefaults(plugin: AppPlugin<MCPServer>): AppPlugin<MCPServer>;
+export {};
+//# sourceMappingURL=widget-meta-defaults.d.ts.map

package/dist/widget-meta-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-meta-defaults.d.ts","sourceRoot":"","sources":["../src/widget-meta-defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,2BAA2B,CAAA;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAExC,6FAA6F;AAC7F,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAC1C,UAAU,CAAC,WAAW,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAC7D,CAAA;AAID,mGAAmG;AACnG,KAAK,WAAW,GAAG,MAAM,CAAA;AAOzB,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,WAAW,EAAE,GAAG,EAAE,CAAC,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAQ1F;AA0BD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,kBAAkB,GAAG,SAAS,GACvC,SAAS,CAcX;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,SAAS,CAAC,CAa1F"}

package/dist/widget-meta-defaults.js

@@ -0,0 +1,80 @@
+/** The Apps SDK key a widget-rendering tool carries (`appsSdkMeta`) — feeds never do. */
+const OUTPUT_TEMPLATE = "openai/outputTemplate";
+const WIDGET_CSP = "openai/widgetCSP";
+/** Each list of `defaults` appended to the same list of `own`, each entry once. */
+export function mergeDomainLists(own, defaults) {
+    const mine = (own ?? {});
+    const merged = { ...mine };
+    for (const [key, domains] of Object.entries(defaults)) {
+        if (!domains?.length)
+            continue;
+        merged[key] = [...new Set([...(mine[key] ?? []), ...domains])];
+    }
+    return merged;
+}
+const hasDomains = (lists) => lists !== undefined && Object.values(lists).some((domains) => (domains?.length ?? 0) > 0);
+/** `definition` with the defaults merged in — a copy; the caller's object stays as it was. */
+function withDefaults(definition, defaults) {
+    const { view, _meta: meta } = definition;
+    const next = { ...definition };
+    if (view && defaults.viewCsp && hasDomains(defaults.viewCsp)) {
+        next.view = { ...view, csp: mergeDomainLists(view.csp, defaults.viewCsp) };
+    }
+    if (meta?.[OUTPUT_TEMPLATE] !== undefined &&
+        defaults.widgetCSP &&
+        hasDomains(defaults.widgetCSP)) {
+        const own = meta[WIDGET_CSP];
+        next._meta = { ...meta, [WIDGET_CSP]: mergeDomainLists(own, defaults.widgetCSP) };
+    }
+    return next;
+}
+/**
+ * A view of `server` whose `tool()` registrations carry `defaults` (see the
+ * module comment). Without defaults it is `server` itself. A Proxy, not a
+ * copy: every other member is the real server's, bound to it, so mcp-use's
+ * internals and the toolkit's per-module tool owner keep working.
+ */
+export function withWidgetMetaDefaults(server, defaults) {
+    if (!defaults || (!hasDomains(defaults.viewCsp) && !hasDomains(defaults.widgetCSP))) {
+        return server;
+    }
+    return new Proxy(server, {
+        get(target, property) {
+            if (property === "tool") {
+                return (definition, callback) => target.tool(withDefaults(definition, defaults), callback);
+            }
+            const value = Reflect.get(target, property, target);
+            return typeof value === "function" ? value.bind(target) : value;
+        },
+    });
+}
+/**
+ * `plugin`, its `registerWidgetTools` handed a server that applies the
+ * defaults the toolkit passes it ({@link withWidgetMetaDefaults}).
+ *
+ * A Proxy, not a copy: a spread keeps only own enumerable properties, so a
+ * class-based module would lose its prototype hooks (`registerTools`) without
+ * a warning. Every hook, the wrapped one included, runs with the plugin
+ * itself as `this` — as when the toolkit calls it on the original object —
+ * so `this` reads and writes, private fields and method shorthand keep
+ * working. The Proxy's target is a child of the plugin, not the plugin, so
+ * a frozen plugin can still be wrapped (a Proxy over it could not report a
+ * different `registerWidgetTools`).
+ */
+export function honorWidgetMetaDefaults(plugin) {
+    const register = plugin.registerWidgetTools;
+    if (!register)
+        return plugin;
+    const registerWidgetTools = (server, defaults) => {
+        register.call(plugin, withWidgetMetaDefaults(server, defaults), defaults);
+    };
+    return new Proxy(Object.create(plugin), {
+        get(_child, property) {
+            if (property === "registerWidgetTools")
+                return registerWidgetTools;
+            const value = Reflect.get(plugin, property, plugin);
+            return typeof value === "function" ? value.bind(plugin) : value;
+        },
+    });
+}
+//# sourceMappingURL=widget-meta-defaults.js.map

package/dist/widget-meta-defaults.js.map

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

package/dist/widget-meta-defaults.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=widget-meta-defaults.test.d.ts.map

package/dist/widget-meta-defaults.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-meta-defaults.test.d.ts","sourceRoot":"","sources":["../src/widget-meta-defaults.test.ts"],"names":[],"mappings":""}