@miragon/pulse-widget-shell 0.24.2 → 0.25.0

package/dist/ui/view-root.d.ts

@@ -0,0 +1,26 @@
+import { type CallObserver } from "./call-observer.js";
+import { type HostWidgets } from "./host-widgets.js";
+import type { ViewComponent, ViewMap } from "./views.js";
+export interface MountViewOptions {
+    /** The view's name (= its show tool's name); the stripped-result recovery re-runs it. */
+    name: string | undefined;
+    view: ViewComponent | undefined;
+    hostWidgets?: HostWidgets;
+}
+export interface MountViewsOptions {
+    views: ViewMap;
+    hostWidgets?: HostWidgets;
+}
+/** One view, no map: the observer listens BEFORE the runtime connects, so it sees every notification. */
+export declare function mountView(options: MountViewOptions): void;
+/** The view the document's prelude names; an unknown name renders the "can't show" state. */
+export declare function mountViews({ views, hostWidgets }: MountViewsOptions): void;
+/**
+ * The provider order is load-bearing: the host first (every hook below reads it), ONE query client
+ * per document, the document layer (theme, fonts, the inline budget box), the gate that resolves
+ * the locale from the host context, then the kit's icon stroke and toasts.
+ */
+export declare function ViewRoot({ name, view, hostWidgets, observer, }: MountViewOptions & {
+    observer: CallObserver | null;
+}): import("react").JSX.Element;
+//# sourceMappingURL=view-root.d.ts.map

package/dist/ui/view-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-root.d.ts","sourceRoot":"","sources":["../../src/ui/view-root.tsx"],"names":[],"mappings":"AAWA,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAG3E,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAKzE,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAExD,MAAM,WAAW,gBAAgB;IAC/B,yFAAyF;IACzF,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;IACxB,IAAI,EAAE,aAAa,GAAG,SAAS,CAAA;IAC/B,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,OAAO,CAAA;IACd,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAID,yGAAyG;AACzG,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAMzD;AAED,6FAA6F;AAC7F,wBAAgB,UAAU,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,iBAAiB,GAAG,IAAI,CAI1E;AAUD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,EACvB,IAAI,EACJ,IAAI,EACJ,WAAW,EACX,QAAQ,GACT,EAAE,gBAAgB,GAAG;IAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAA;CAAE,+BAqBtD"}

package/dist/ui/view-root.js

@@ -0,0 +1,48 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * The bundle root (the second widget-shell file that imports `mcp-use/react`; the other is
+ * `mcp-use-host.tsx`). `mountViews` picks the view the document's prelude names; `mountView`
+ * mounts one view without a map, the entry a per-view build would call.
+ */
+import { StrictMode, useState } from "react";
+import { QueryClientProvider } from "@tanstack/react-query";
+import { ToastProvider, ICON_STROKE } from "@miragon/pulse-ui";
+import { LucideProvider } from "lucide-react";
+import { bootstrapView } from "mcp-use/react";
+import { readViewName } from "../protocol/view-name.js";
+import { installCallObserver } from "./call-observer.js";
+import { SHELL_VIEW_CONFIG } from "./display-mode-toggle.js";
+import { HostDocument } from "./host-document.js";
+import { HostWidgetsProvider } from "./host-widgets.js";
+import { McpUseViewHost, useMcpUseViewCall } from "./mcp-use-host.js";
+import { LocaleGate } from "./locale-gate.js";
+import { createViewQueryClient } from "./tool-query.js";
+import { ViewFrame } from "./view-frame.js";
+const NO_WIDGETS = {};
+/** One view, no map: the observer listens BEFORE the runtime connects, so it sees every notification. */
+export function mountView(options) {
+    const observer = installCallObserver();
+    bootstrapView({
+        default: () => _jsx(ViewRoot, { ...options, observer: observer }),
+        viewConfig: SHELL_VIEW_CONFIG,
+    });
+}
+/** The view the document's prelude names; an unknown name renders the "can't show" state. */
+export function mountViews({ views, hostWidgets }) {
+    const name = readViewName();
+    const view = name !== undefined && Object.hasOwn(views, name) ? views[name] : undefined;
+    mountView({ name, view, hostWidgets });
+}
+function McpUseViewFrame({ name, view, observer, }) {
+    return _jsx(ViewFrame, { call: useMcpUseViewCall(name, observer), view: view });
+}
+/**
+ * The provider order is load-bearing: the host first (every hook below reads it), ONE query client
+ * per document, the document layer (theme, fonts, the inline budget box), the gate that resolves
+ * the locale from the host context, then the kit's icon stroke and toasts.
+ */
+export function ViewRoot({ name, view, hostWidgets, observer, }) {
+    const [client] = useState(createViewQueryClient);
+    return (_jsx(StrictMode, { children: _jsx(McpUseViewHost, { children: _jsx(QueryClientProvider, { client: client, children: _jsx(HostDocument, { children: _jsx(LocaleGate, { children: _jsx(LucideProvider, { strokeWidth: ICON_STROKE, children: _jsx(ToastProvider, { children: _jsx(HostWidgetsProvider, { widgets: hostWidgets ?? NO_WIDGETS, children: _jsx(McpUseViewFrame, { name: name, view: view, observer: observer }) }) }) }) }) }) }) }) }));
+}
+//# sourceMappingURL=view-root.js.map

package/dist/ui/view-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-root.js","sourceRoot":"","sources":["../../src/ui/view-root.tsx"],"names":[],"mappings":";AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,EAAE,mBAAmB,EAAqB,MAAM,oBAAoB,CAAA;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,mBAAmB,EAAoB,MAAM,mBAAmB,CAAA;AACzE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAe3C,MAAM,UAAU,GAAgB,EAAE,CAAA;AAElC,yGAAyG;AACzG,MAAM,UAAU,SAAS,CAAC,OAAyB;IACjD,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAA;IACtC,aAAa,CAAC;QACZ,OAAO,EAAE,GAAG,EAAE,CAAC,KAAC,QAAQ,OAAK,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAI;QAC5D,UAAU,EAAE,iBAAiB;KAC9B,CAAC,CAAA;AACJ,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,UAAU,CAAC,EAAE,KAAK,EAAE,WAAW,EAAqB;IAClE,MAAM,IAAI,GAAG,YAAY,EAAE,CAAA;IAC3B,MAAM,IAAI,GAAG,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IACvF,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAA;AACxC,CAAC;AAED,SAAS,eAAe,CAAC,EACvB,IAAI,EACJ,IAAI,EACJ,QAAQ,GACkE;IAC1E,OAAO,KAAC,SAAS,IAAC,IAAI,EAAE,iBAAiB,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,GAAI,CAAA;AAC3E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,EACvB,IAAI,EACJ,IAAI,EACJ,WAAW,EACX,QAAQ,GAC6C;IACrD,MAAM,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,qBAAqB,CAAC,CAAA;IAChD,OAAO,CACL,KAAC,UAAU,cACT,KAAC,cAAc,cACb,KAAC,mBAAmB,IAAC,MAAM,EAAE,MAAM,YACjC,KAAC,YAAY,cACX,KAAC,UAAU,cACT,KAAC,cAAc,IAAC,WAAW,EAAE,WAAW,YACtC,KAAC,aAAa,cACZ,KAAC,mBAAmB,IAAC,OAAO,EAAE,WAAW,IAAI,UAAU,YACrD,KAAC,eAAe,IAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,GAAI,GAC3C,GACR,GACD,GACN,GACA,GACK,GACP,GACN,CACd,CAAA;AACH,CAAC"}

package/dist/ui/views.d.ts

@@ -0,0 +1,17 @@
+import { type ReactNode } from "react";
+/** A view gets its show tool's `structuredContent` as `data`; it composes its own widgets. */
+export interface ViewProps<TData> {
+    data: TData;
+}
+/** A function type (contravariant in `data`), so every `ViewComponent<X>` is a `ViewComponent`. */
+export type ViewComponent<TData = never> = (props: ViewProps<TData>) => ReactNode;
+/** Key = view name = show tool name (`showToolBinding`). */
+export type ViewMap = Readonly<Record<string, ViewComponent>>;
+/**
+ * The static-layout helper: full-width rows, each widget in its own shell. Every row sits in its
+ * own error boundary, so one crashing widget shows its fallback while its siblings stay up.
+ */
+export declare function ViewStack({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+//# sourceMappingURL=views.d.ts.map

package/dist/ui/views.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"views.d.ts","sourceRoot":"","sources":["../../src/ui/views.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAGhE,8FAA8F;AAC9F,MAAM,WAAW,SAAS,CAAC,KAAK;IAC9B,IAAI,EAAE,KAAK,CAAA;CACZ;AAED,mGAAmG;AACnG,MAAM,MAAM,aAAa,CAAC,KAAK,GAAG,KAAK,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,KAAK,SAAS,CAAA;AAEjF,4DAA4D;AAC5D,MAAM,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAA;AAE7D;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,+BAU9D"}

package/dist/ui/views.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Children, isValidElement } from "react";
+import { ViewErrorBoundary } from "./view-error-boundary.js";
+/**
+ * The static-layout helper: full-width rows, each widget in its own shell. Every row sits in its
+ * own error boundary, so one crashing widget shows its fallback while its siblings stay up.
+ */
+export function ViewStack({ children }) {
+    return (_jsx("div", { className: "flex min-w-0 flex-col gap-4", children: Children.toArray(children).map((child, index) => (_jsx(ViewErrorBoundary, { children: child }, isValidElement(child) ? child.key : index))) }));
+}
+//# sourceMappingURL=views.js.map

package/dist/ui/views.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"views.js","sourceRoot":"","sources":["../../src/ui/views.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAkB,MAAM,OAAO,CAAA;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAa5D;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,EAAE,QAAQ,EAA2B;IAC7D,OAAO,CACL,cAAK,SAAS,EAAC,6BAA6B,YACzC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAChD,KAAC,iBAAiB,cACf,KAAK,IADgB,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAE7C,CACrB,CAAC,GACE,CACP,CAAA;AACH,CAAC"}

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

@@ -1,22 +1,10 @@
 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.
- */
+/** Every child may shrink (`min-w-0`), so a wide table scrolls in its own region instead of widening the document. */
 export declare function WidgetShell({ children, className }: {
     children: ReactNode;
     className?: string;

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

@@ -1 +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"}
+{"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;AASjE,wBAAgB,mBAAmB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,+BAE5F;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,sHAAsH;AACtH,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,+BAoB/F"}

package/dist/ui/widget-shell.js

@@ -1,46 +1,21 @@
 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.
- */
+import { cn } from "@miragon/pulse-ui";
+/** Without this flag every embedded widget would stack a second background and padding 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.
- */
+/** mcp-use 2.x's `useDisplayMode` only works under `bootstrapView`, so the bundle root provides it. */
 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.
- */
+/** Every child may shrink (`min-w-0`), so a wide table scrolls in its own region 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.
+    // Nested: keep the section stack; widgets rely on the shell's gap.
     if (nested) {
         return _jsx("div", { className: cn("flex min-w-0 flex-col gap-6", className), children: children });
     }

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

@@ -1 +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"}
+{"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,mBAAmB,CAAA;AAEtC,4GAA4G;AAC5G,MAAM,kBAAkB,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;AAE/C,uGAAuG;AACvG,MAAM,kBAAkB,GAAG,aAAa,CAAS,QAAQ,CAAC,CAAA;AAE1D,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,MAAM,UAAU,kBAAkB;IAChC,OAAO,UAAU,CAAC,kBAAkB,CAAC,CAAA;AACvC,CAAC;AAED,sHAAsH;AACtH,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,mEAAmE;IACnE,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/view-bundle.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The packages a host's view bundle must resolve to ONE instance: spread it into Vite's
+ * `resolve.dedupe` (`dedupe: [...VIEW_BUNDLE_DEDUPE]`) in every server that bundles views.
+ *
+ * pnpm installs a package once per peer set, so the connectors, your own modules and the app
+ * can each see their own copy of these. Each copy carries its own React context or module
+ * state: the view root (widget-shell's copy) provides the view host and the ONE `QueryClient`,
+ * but a widget that reads another copy finds no host and no client, and every in-widget query
+ * hangs on "Loading…". The same holds for the view runtime in `mcp-use/react`, the locale and
+ * toast contexts of `@miragon/pulse-ui`, the view runtime of this package and the
+ * `LucideProvider` of `lucide-react` (dedupe a 1.x copy: 0.x has no `LucideProvider`).
+ * A version bump of this package ships a change to the list; never trim it in a host.
+ */
+export declare const VIEW_BUNDLE_DEDUPE: readonly ["react", "react-dom", "@tanstack/react-query", "mcp-use", "@miragon/pulse-ui", "@miragon/pulse-widget-shell", "lucide-react"];
+//# sourceMappingURL=view-bundle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"view-bundle.d.ts","sourceRoot":"","sources":["../src/view-bundle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,yIAQrB,CAAA"}

package/dist/view-bundle.js

@@ -0,0 +1,23 @@
+/**
+ * The packages a host's view bundle must resolve to ONE instance: spread it into Vite's
+ * `resolve.dedupe` (`dedupe: [...VIEW_BUNDLE_DEDUPE]`) in every server that bundles views.
+ *
+ * pnpm installs a package once per peer set, so the connectors, your own modules and the app
+ * can each see their own copy of these. Each copy carries its own React context or module
+ * state: the view root (widget-shell's copy) provides the view host and the ONE `QueryClient`,
+ * but a widget that reads another copy finds no host and no client, and every in-widget query
+ * hangs on "Loading…". The same holds for the view runtime in `mcp-use/react`, the locale and
+ * toast contexts of `@miragon/pulse-ui`, the view runtime of this package and the
+ * `LucideProvider` of `lucide-react` (dedupe a 1.x copy: 0.x has no `LucideProvider`).
+ * A version bump of this package ships a change to the list; never trim it in a host.
+ */
+export const VIEW_BUNDLE_DEDUPE = [
+    "react",
+    "react-dom",
+    "@tanstack/react-query",
+    "mcp-use",
+    "@miragon/pulse-ui",
+    "@miragon/pulse-widget-shell",
+    "lucide-react",
+];
+//# sourceMappingURL=view-bundle.js.map

package/dist/view-bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-bundle.js","sourceRoot":"","sources":["../src/view-bundle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO;IACP,WAAW;IACX,uBAAuB;IACvB,SAAS;IACT,mBAAmB;IACnB,6BAA6B;IAC7B,cAAc;CACN,CAAA"}

package/dist/view-results.d.ts

@@ -1,26 +1,20 @@
-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.
+ * A type alias, NOT an interface: TypeScript synthesizes the index signature mcp-use's tool
+ * callback expects for anonymous types only.
  */
-/**
- * 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 = {
+export 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. */
+/**
+ * A show tool's result: `structuredContent` IS the data its view renders (the view is picked by
+ * its name, the tool's name); the text is what the model reads: a short summary or, where the
+ * model needs the figures, the result as compact JSON.
+ */
+export declare function buildViewResult(data: object, summary: string): ViewResult;
 type FeedResult = {
     content: {
         type: "text";
@@ -28,14 +22,9 @@ type FeedResult = {
     }[];
 };
 /**
- * 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.
+ * No widget `_meta`: a widget-tool result would be rendered by the host instead
+ * of reaching the in-widget `callTool()`. Text only: hosts may strip
+ * `structuredContent`, and sending both doubled every feed.
  */
 export declare const buildDataFeedResult: (data: Record<string, unknown>) => FeedResult;
 export {};

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

@@ -1 +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"}
+{"version":3,"file":"view-results.d.ts","sourceRoot":"","sources":["../src/view-results.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,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;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAKzE;AAED,KAAK,UAAU,GAAG;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAAA;AAE/D;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,UAElE,CAAA"}

package/dist/view-results.js

@@ -1,15 +1,18 @@
-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.
+ * A show tool's result: `structuredContent` IS the data its view renders (the view is picked by
+ * its name, the tool's name); the text is what the model reads: a short summary or, where the
+ * model needs the figures, the result as compact JSON.
+ */
+export function buildViewResult(data, summary) {
+    return {
+        content: [{ type: "text", text: summary }],
+        structuredContent: data,
+    };
+}
+/**
+ * No widget `_meta`: a widget-tool result would be rendered by the host instead
+ * of reaching the in-widget `callTool()`. Text only: hosts may strip
+ * `structuredContent`, and sending both doubled every feed.
  */
 export const buildDataFeedResult = (data) => ({
     content: [{ type: "text", text: JSON.stringify(data) }],

package/dist/view-results.js.map

@@ -1 +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"}
+{"version":3,"file":"view-results.js","sourceRoot":"","sources":["../src/view-results.ts"],"names":[],"mappings":"AASA;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,OAAe;IAC3D,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC1C,iBAAiB,EAAE,IAA+B;KACnD,CAAA;AACH,CAAC;AAID;;;;GAIG;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-tool-bindings.d.ts

@@ -1,28 +1,12 @@
 import { z } from "zod";
+/** mcp-use's scheme for view resources; it exports none, and the widget-contract e2e pins it. */
+export declare const VIEW_RESOURCE_URI_PREFIX = "ui://views/";
+export declare function viewResourceUri(viewName: string): string;
 /**
- * The two spreads every module's raw `server.tool()` widget registrations
- * compose — the wire-contract halves of architecture invariant 5. One
- * implementation for all modules (they were byte-identical copies before):
- * a module that hand-rolls these drifts out of the widget-contract e2e test's
- * expectations on the first mcp-use change.
- */
-/**
- * View binding + Apps-SDK `_meta` half for a widget-RENDERING (model-visible)
- * tool — spread into the `server.tool` definition of every `show_*` tool. The
- * view name IS the tool name: mcp-use derives the entire MCP Apps half of the
- * wire contract (`_meta.ui.resourceUri`, flat `ui/resourceUri`, resource CSP)
- * from the first-class `view` binding — never stamp `ui` keys by hand, mcp-use
- * overwrites that namespace on `tools/list`. What mcp-use does NOT derive is
- * the OpenAI Apps SDK half (`openai/*`): `appsSdkMeta` builds it, pointing
- * `openai/outputTemplate` at the same `ui://views/<name>.html` resource. The
- * `outputSchema` is required by mcp-use for any view-bound tool; `passthrough`
- * matches the free-form `structuredContent` the view builders return without
- * stripping keys on SDK-side validation.
- *
- * The view resource carries its title as `description` (hosts that list
- * resources show it) and asks the host for a border (`prefersBorder`, owner
- * decision 2026-10-12, #344 N159): the cards draw none of their own, so a
- * frame sets them off from the chat around them.
+ * mcp-use derives the MCP Apps half of `_meta` from `view` and overwrites `ui` on tools/list; this
+ * stamps only the OpenAI Apps SDK half (`openai/*`), in the wire order hosts read. mcp-use requires
+ * an `outputSchema`; `passthrough` keeps free-form `structuredContent` intact. `prefersBorder`: the
+ * cards draw no frame of their own (#344).
  */
 export declare function showToolBinding(name: string, title: string): {
     view: {
@@ -31,36 +15,23 @@ export declare function showToolBinding(name: string, title: string): {
         prefersBorder: boolean;
     };
     outputSchema: z.ZodObject<{}, z.core.$loose>;
-    _meta: Record<string, unknown>;
+    _meta: {
+        "openai/outputTemplate": string;
+        "openai/toolInvocation/invoking": string;
+        "openai/toolInvocation/invoked": string;
+        "openai/widgetAccessible": boolean;
+        "openai/resultCanProduceWidget": boolean;
+    };
 };
 /**
- * The strict input schema every raw `server.tool()` registration declares —
- * the twin of the toolkit registrar's `strictInput` option for the widget
- * path, which registers outside the registrar. A non-strict `z.object` lets
- * mcp-use STRIP an unknown key before the handler runs: a misnamed optional
- * filter then silently widens the result (#329). Strict, the schema is
- * advertised with `additionalProperties: false`, and an unknown key fails
- * validation with the toolkit's own message — every unknown key plus every
- * valid one — as an `isError` result the model can correct in one retry.
- *
- * The message mirrors the toolkit's `unknownKeysMessage` (not exported);
- * `widget-tool-bindings.test.ts` pins the two to the same text.
+ * A non-strict `z.object` lets mcp-use STRIP an unknown key, so a misnamed
+ * filter silently widens the result (#329). The registrar and every raw
+ * registration take this one schema.
  */
 export declare function strictToolInput<TShape extends z.ZodRawShape>(shape: TShape): z.ZodObject<{ -readonly [P in keyof TShape]: TShape[P]; }, z.core.$strict>;
 /**
- * App-only marker for the internal `*_data` feeds — spread into each feed's
- * `server.tool` definition. `visibility: "app"` is mcp-use 2's first-class
- * field (emitted as SEP-1865 `_meta.ui.visibility: ["app"]`): conforming hosts
- * hide these tools from the LLM tool surface while keeping them callable from
- * widgets via `callTool`; the "Internal JSON feed" descriptions stay as
- * fallback for non-conforming hosts. Deliberately no `view` binding — the
- * feeds must return JSON, not render UI.
- *
- * `openai/widgetAccessible` covers the Apps-SDK half of the dual contract:
- * those hosts only allow in-widget callTool on tools carrying the key — a
- * feed without it renders fine but every pagination/search/refresh is denied.
- * The key does NOT render anything (no outputTemplate), so the feeds stay
- * JSON-only. mcp-use passes non-`ui` `_meta` entries through untouched.
+ * SEP-1865 hosts hide `visibility: "app"` tools from the LLM. Apps-SDK hosts
+ * deny in-widget callTool without `openai/widgetAccessible`; it renders nothing.
  */
 export declare const appOnly: {
     visibility: "app";

package/dist/widget-tool-bindings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"widget-tool-bindings.d.ts","sourceRoot":"","sources":["../src/widget-tool-bindings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;;;;;;EAM1D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,MAAM,SAAS,CAAC,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,8EAM1E;AAUD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,OAAO;;;;;CAGnB,CAAA"}
+{"version":3,"file":"widget-tool-bindings.d.ts","sourceRoot":"","sources":["../src/widget-tool-bindings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,iGAAiG;AACjG,eAAO,MAAM,wBAAwB,gBAAgB,CAAA;AAErD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;;;;;;;;;;;;EAY1D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,SAAS,CAAC,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,8EAM1E;AAUD;;;GAGG;AACH,eAAO,MAAM,OAAO;;;;;CAGnB,CAAA"}

package/dist/widget-tool-bindings.js

@@ -1,49 +1,32 @@
 import { z } from "zod";
-import { appsSdkMeta, viewResourceUri } from "@miragon/mcp-toolkit-core";
-/**
- * The two spreads every module's raw `server.tool()` widget registrations
- * compose — the wire-contract halves of architecture invariant 5. One
- * implementation for all modules (they were byte-identical copies before):
- * a module that hand-rolls these drifts out of the widget-contract e2e test's
- * expectations on the first mcp-use change.
- */
+/** mcp-use's scheme for view resources; it exports none, and the widget-contract e2e pins it. */
+export const VIEW_RESOURCE_URI_PREFIX = "ui://views/";
+export function viewResourceUri(viewName) {
+    return `${VIEW_RESOURCE_URI_PREFIX}${viewName}.html`;
+}
 /**
- * View binding + Apps-SDK `_meta` half for a widget-RENDERING (model-visible)
- * tool — spread into the `server.tool` definition of every `show_*` tool. The
- * view name IS the tool name: mcp-use derives the entire MCP Apps half of the
- * wire contract (`_meta.ui.resourceUri`, flat `ui/resourceUri`, resource CSP)
- * from the first-class `view` binding — never stamp `ui` keys by hand, mcp-use
- * overwrites that namespace on `tools/list`. What mcp-use does NOT derive is
- * the OpenAI Apps SDK half (`openai/*`): `appsSdkMeta` builds it, pointing
- * `openai/outputTemplate` at the same `ui://views/<name>.html` resource. The
- * `outputSchema` is required by mcp-use for any view-bound tool; `passthrough`
- * matches the free-form `structuredContent` the view builders return without
- * stripping keys on SDK-side validation.
- *
- * The view resource carries its title as `description` (hosts that list
- * resources show it) and asks the host for a border (`prefersBorder`, owner
- * decision 2026-10-12, #344 N159): the cards draw none of their own, so a
- * frame sets them off from the chat around them.
+ * mcp-use derives the MCP Apps half of `_meta` from `view` and overwrites `ui` on tools/list; this
+ * stamps only the OpenAI Apps SDK half (`openai/*`), in the wire order hosts read. mcp-use requires
+ * an `outputSchema`; `passthrough` keeps free-form `structuredContent` intact. `prefersBorder`: the
+ * cards draw no frame of their own (#344).
  */
 export function showToolBinding(name, title) {
     return {
         view: { name, description: title, prefersBorder: true },
         outputSchema: z.object({}).passthrough(),
-        _meta: appsSdkMeta({ resourceUri: viewResourceUri(name), title }),
+        _meta: {
+            "openai/outputTemplate": viewResourceUri(name),
+            "openai/toolInvocation/invoking": `Loading ${title}…`,
+            "openai/toolInvocation/invoked": `${title} ready`,
+            "openai/widgetAccessible": true,
+            "openai/resultCanProduceWidget": true,
+        },
     };
 }
 /**
- * The strict input schema every raw `server.tool()` registration declares —
- * the twin of the toolkit registrar's `strictInput` option for the widget
- * path, which registers outside the registrar. A non-strict `z.object` lets
- * mcp-use STRIP an unknown key before the handler runs: a misnamed optional
- * filter then silently widens the result (#329). Strict, the schema is
- * advertised with `additionalProperties: false`, and an unknown key fails
- * validation with the toolkit's own message — every unknown key plus every
- * valid one — as an `isError` result the model can correct in one retry.
- *
- * The message mirrors the toolkit's `unknownKeysMessage` (not exported);
- * `widget-tool-bindings.test.ts` pins the two to the same text.
+ * A non-strict `z.object` lets mcp-use STRIP an unknown key, so a misnamed
+ * filter silently widens the result (#329). The registrar and every raw
+ * registration take this one schema.
  */
 export function strictToolInput(shape) {
     const valid = Object.keys(shape);
@@ -59,19 +42,8 @@ function unknownKeysMessage(unknown, valid) {
         : `${head} Valid keys: ${quote(valid)}.`;
 }
 /**
- * App-only marker for the internal `*_data` feeds — spread into each feed's
- * `server.tool` definition. `visibility: "app"` is mcp-use 2's first-class
- * field (emitted as SEP-1865 `_meta.ui.visibility: ["app"]`): conforming hosts
- * hide these tools from the LLM tool surface while keeping them callable from
- * widgets via `callTool`; the "Internal JSON feed" descriptions stay as
- * fallback for non-conforming hosts. Deliberately no `view` binding — the
- * feeds must return JSON, not render UI.
- *
- * `openai/widgetAccessible` covers the Apps-SDK half of the dual contract:
- * those hosts only allow in-widget callTool on tools carrying the key — a
- * feed without it renders fine but every pagination/search/refresh is denied.
- * The key does NOT render anything (no outputTemplate), so the feeds stay
- * JSON-only. mcp-use passes non-`ui` `_meta` entries through untouched.
+ * SEP-1865 hosts hide `visibility: "app"` tools from the LLM. Apps-SDK hosts
+ * deny in-widget callTool without `openai/widgetAccessible`; it renders nothing.
  */
 export const appOnly = {
     visibility: "app",

package/dist/widget-tool-bindings.js.map

@@ -1 +1 @@
-{"version":3,"file":"widget-tool-bindings.js","sourceRoot":"","sources":["../src/widget-tool-bindings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAExE;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,KAAa;IACzD,OAAO;QACL,IAAI,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE;QACvD,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE;QACxC,KAAK,EAAE,WAAW,CAAC,EAAE,WAAW,EAAE,eAAe,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC;KAClE,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAA+B,KAAa;IACzE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAChC,OAAO,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE;QAC3B,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,KAAK,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;KACzF,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,OAA0B,EAAE,KAAwB;IAC9E,MAAM,KAAK,GAAG,CAAC,IAAuB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC5F,MAAM,IAAI,GAAG,cAAc,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAA;IAC/E,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;QACvB,CAAC,CAAC,GAAG,IAAI,gCAAgC;QACzC,CAAC,CAAC,GAAG,IAAI,gBAAgB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAA;AAC5C,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,UAAU,EAAE,KAAc;IAC1B,KAAK,EAAE,EAAE,yBAAyB,EAAE,IAAI,EAAE;CAC3C,CAAA"}
+{"version":3,"file":"widget-tool-bindings.js","sourceRoot":"","sources":["../src/widget-tool-bindings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,iGAAiG;AACjG,MAAM,CAAC,MAAM,wBAAwB,GAAG,aAAa,CAAA;AAErD,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,GAAG,wBAAwB,GAAG,QAAQ,OAAO,CAAA;AACtD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,KAAa;IACzD,OAAO;QACL,IAAI,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE;QACvD,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE;QACxC,KAAK,EAAE;YACL,uBAAuB,EAAE,eAAe,CAAC,IAAI,CAAC;YAC9C,gCAAgC,EAAE,WAAW,KAAK,GAAG;YACrD,+BAA+B,EAAE,GAAG,KAAK,QAAQ;YACjD,yBAAyB,EAAE,IAAI;YAC/B,+BAA+B,EAAE,IAAI;SACtC;KACF,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAA+B,KAAa;IACzE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAChC,OAAO,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE;QAC3B,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,KAAK,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;KACzF,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,OAA0B,EAAE,KAAwB;IAC9E,MAAM,KAAK,GAAG,CAAC,IAAuB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC5F,MAAM,IAAI,GAAG,cAAc,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAA;IAC/E,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;QACvB,CAAC,CAAC,GAAG,IAAI,gCAAgC;QACzC,CAAC,CAAC,GAAG,IAAI,gBAAgB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAA;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,UAAU,EAAE,KAAc;IAC1B,KAAK,EAAE,EAAE,yBAAyB,EAAE,IAAI,EAAE;CAC3C,CAAA"}