@vendoai/ui 0.4.0

package/dist/chrome/vendo-palette.d.ts

@@ -0,0 +1,29 @@
+import { type VendoCommand } from "./overlay-registry.js";
+import { type PaletteHotkey } from "./palette-hotkey.js";
+export type { VendoCommand } from "./overlay-registry.js";
+/** 08-ui §4 — the ⌘K entry point, one-surface edition (ui-lane-entry pick P-C).
+ *
+ * The palette no longer renders a dialog of its own: ⌘K opens the SAME
+ * conversation overlay the launcher opens (toggling it closed on a second
+ * press), and the palette's commands render as the overlay's chip strip above
+ * the composer. Typed text that matches no command was never anything but a
+ * question — now it simply IS the message, so the "No matching commands" dead
+ * end no longer exists.
+ *
+ * What remains here is everything that made VendoPalette safe to drop into a
+ * host, unchanged in behavior:
+ * - the host-collision-safe singleton keybinding (ENG-222): one shared
+ *   document listener no matter how many palettes mount, a configurable /
+ *   disable-able `hotkey` chord, and no keystroke stolen from a focused host
+ *   input;
+ * - the programmatic opener seam (ENG-223): `openVendoPalette()` still works
+ *   and now opens the conversation surface;
+ * - command routing: a host `onCommand` receives every chip activation;
+ *   without one, conversation commands self-route through the overlay
+ *   registry and the rest hint in dev instead of dying silently.
+ */
+export declare function VendoPalette({ onCommand, hotkey }: {
+    onCommand?(command: VendoCommand): void;
+    hotkey?: PaletteHotkey;
+}): null;
+//# sourceMappingURL=vendo-palette.d.ts.map

package/dist/chrome/vendo-palette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendo-palette.d.ts","sourceRoot":"","sources":["../../src/chrome/vendo-palette.tsx"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAwF,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAI/I,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE;IAAE,SAAS,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,aAAa,CAAA;CAAE,QAoEtH"}

package/dist/chrome/vendo-palette.js

@@ -0,0 +1,95 @@
+import { useEffect, useMemo } from "react";
+import { useApps } from "../hooks/use-apps.js";
+import { developmentMode } from "./dev-mode.js";
+import { openVendoConversation, registerConversationCommands, } from "./overlay-registry.js";
+import { isEditableTarget, registerPaletteHotkey, registerPaletteOpener, resolveHotkeyMatcher } from "./palette-hotkey.js";
+/** 08-ui §4 — the ⌘K entry point, one-surface edition (ui-lane-entry pick P-C).
+ *
+ * The palette no longer renders a dialog of its own: ⌘K opens the SAME
+ * conversation overlay the launcher opens (toggling it closed on a second
+ * press), and the palette's commands render as the overlay's chip strip above
+ * the composer. Typed text that matches no command was never anything but a
+ * question — now it simply IS the message, so the "No matching commands" dead
+ * end no longer exists.
+ *
+ * What remains here is everything that made VendoPalette safe to drop into a
+ * host, unchanged in behavior:
+ * - the host-collision-safe singleton keybinding (ENG-222): one shared
+ *   document listener no matter how many palettes mount, a configurable /
+ *   disable-able `hotkey` chord, and no keystroke stolen from a focused host
+ *   input;
+ * - the programmatic opener seam (ENG-223): `openVendoPalette()` still works
+ *   and now opens the conversation surface;
+ * - command routing: a host `onCommand` receives every chip activation;
+ *   without one, conversation commands self-route through the overlay
+ *   registry and the rest hint in dev instead of dying silently.
+ */
+export function VendoPalette({ onCommand, hotkey }) {
+    const { apps } = useApps();
+    const commands = useMemo(() => [
+        { id: "new-conversation", label: "New conversation", kind: "new-conversation" },
+        ...apps.map(app => ({ id: `open-${app.id}`, label: `Open ${app.name}`, kind: "open-app", appId: app.id })),
+        { id: "show-activity", label: "Show activity", kind: "show-activity" },
+    ], [apps]);
+    // Publish the command set for the overlay's chip strip. Routing preserves
+    // the old select() semantics exactly — host onCommand wins outright; the
+    // self-sufficient default opens a fresh conversation in the mounted overlay.
+    useEffect(() => registerConversationCommands({
+        commands,
+        select(command) {
+            if (onCommand) {
+                // The old palette dialog closed on select; mirror that for host-routed
+                // commands so navigation (show-activity etc.) never lands behind the
+                // open modal (cubic PR#391 finding).
+                openVendoConversation({ close: true });
+                onCommand(command);
+                return;
+            }
+            if (command.kind === "new-conversation") {
+                const opened = openVendoConversation({ newConversation: true });
+                if (!opened && developmentMode()) {
+                    console.warn("[vendo] VendoPalette: \"New conversation\" opens the conversation surface — mount a VendoOverlay for it to land in (or supply onCommand).");
+                }
+                return;
+            }
+            if (developmentMode()) {
+                console.warn(`[vendo] VendoPalette: "${command.label}" needs an onCommand handler to route (kind "${command.kind}").`);
+            }
+        },
+    }), [commands, onCommand]);
+    // ENG-223 — the programmatic opener seam. Open-only (no toggle): a CTA that
+    // finds the surface already open should leave it open, not dismiss it.
+    useEffect(() => registerPaletteOpener(() => {
+        const opened = openVendoConversation();
+        if (!opened && developmentMode()) {
+            console.warn("[vendo] VendoPalette: nothing to open — mount a VendoOverlay for the conversation surface to land in.");
+        }
+    }), []);
+    // The singleton keybinding (ENG-222). ⌘K TOGGLES the overlay — the
+    // one-surface replacement for the old dialog toggle. The editable-target
+    // guard is unconditional now (the palette no longer tracks an open state);
+    // closing from inside the overlay's composer stays on Escape.
+    const matcher = useMemo(() => resolveHotkeyMatcher(hotkey), [hotkey]);
+    useEffect(() => {
+        if (hotkey === false)
+            return;
+        const handler = (event) => {
+            if (!matcher(event))
+                return;
+            // Never steal a keystroke a HOST input owns — but the overlay's own
+            // composer is ours: ⌘K from inside the open surface toggles it closed
+            // (the old dialog's while-open behavior, one-surface edition).
+            const insideOverlay = event.target instanceof HTMLElement && event.target.closest("#vendo-overlay-dialog") !== null;
+            if (isEditableTarget(event.target) && !insideOverlay)
+                return;
+            event.preventDefault();
+            const opened = openVendoConversation({ toggle: true });
+            if (!opened && developmentMode()) {
+                console.warn("[vendo] VendoPalette: ⌘K opens the conversation surface — mount a VendoOverlay for it to land in.");
+            }
+        };
+        return registerPaletteHotkey(handler);
+    }, [matcher, hotkey]);
+    return null;
+}
+//# sourceMappingURL=vendo-palette.js.map

package/dist/chrome/vendo-palette.js.map

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

package/dist/chrome/vendo-slot.d.ts

@@ -0,0 +1,79 @@
+import type { Json, ToolOutcome, UIPayload } from "@vendoai/core";
+import { type ReactNode } from "react";
+/** A generated view pinned into a slot (08-ui §4 — "or a pinned component").
+ *  Unlike an app (a whole document), a pin is a single `vendo-genui/v2` tree the
+ *  user authored and pinned in place; it mounts through the same tree renderer +
+ *  error boundary, falling back to the host's original markup if it throws. */
+export interface VendoSlotPin {
+    /** The pinned generated view (a `vendo-genui/v2` tree payload). */
+    payload: UIPayload;
+    /** Live data overriding the tree's embedded data model (08-ui §5). */
+    data?: Record<string, Json>;
+    /** Action dispatch for the pinned component; defaults to the tree renderer's
+     *  fail-soft no-op when a pin carries no live handler. */
+    onAction?(req: {
+        nodeId: string;
+        action: string;
+        payload?: Json;
+    }): Promise<ToolOutcome>;
+}
+/** 08-ui §4; 06-apps §8 — inline mount that never sacrifices host fallback content.
+ *
+ *  Three states:
+ *  - empty: no `appId`, no `pin`, no `children` → the ghost with a REAL CTA button
+ *    that opens the authoring surface (`onAuthor`, else the mounted ⌘K palette);
+ *  - app: `appId` → the whole app document mounts (via the single-app transport);
+ *  - pinned component: `pin` → the authored `vendo-genui/v2` view mounts in place.
+ *
+ *  In both filled states the swap morphs through the ENG-205 render slot, using
+ *  the host's own markup as the exit frame, and the PinMount error boundary keeps
+ *  the original `children` as the visible recovery path (06-apps §8). Without any
+ *  of the three, the children render UNTOUCHED (no wrapper — hosts may inline
+ *  slots anywhere). */
+export declare function VendoSlot({ id, appId: appIdProp, pin, onAuthor, remix, remixPrompt, discover, emptyState, children }: {
+    id: string;
+    appId?: string;
+    pin?: VendoSlotPin;
+    /** Invoked when the empty-state CTA is activated — the seam to open a thread
+     *  or palette to author the view. Defaults to opening a mounted VendoPalette. */
+    onAuthor?(slotId: string): void;
+    /** Pass `false` to stand pin self-discovery down even with no `appId`/`pin`
+     *  prop — for hosts that resolve the pin themselves (e.g. via useSlotApp
+     *  for a layout decision) and must not start a second poll. */
+    discover?: boolean;
+    /** Remix folds into Slot as a flag (ui-usage-dx §2): show the hover Remix
+     *  affordance on the slot's content. Gesture-owned forking (2026-07-21):
+     *  activating it on an EMPTY slot forks the captured component
+     *  DETERMINISTICALLY (the engine copies the trusted source and records the
+     *  pin — no model call, no model fork decision) and the fork mounts in
+     *  place; on a slot already holding an app it opens the overlay composer
+     *  prefilled so the instruction rides an ordinary edit. The slot id should
+     *  match a registered (remixable) host component so sync has captured its
+     *  source — init/doctor verify the flag against catalog registrations. */
+    remix?: boolean;
+    /** Override for the composer prefill when remixing a slot that already
+     *  holds an app; defaults to a prompt naming the slot's component. (The
+     *  empty-slot gesture itself never sends text to the model.) */
+    remixPrompt?: string;
+    /** Empty-state invitation config (ui-lane-entry pick S-A×S-D). Every string
+     *  is host-customizable with white-label defaults; suggestions are 3
+     *  host-aware prompts (generic fallbacks otherwise) whose tap PREFILLS the
+     *  conversation composer — never sends. */
+    emptyState?: {
+        /** Default "This space builds itself". */
+        title?: string;
+        /** Default "describe a view — it renders here, live on your data". */
+        subtitle?: string;
+        /** Up to 3 prompt chips. Default: generic view-authoring prompts. */
+        suggestions?: string[];
+        /** Primary button label (layout "button"). Default "Design a view". */
+        ctaLabel?: string;
+        /** "button" (chips + primary CTA, default) or "chips-first" (chips are
+         *  the actions; a quiet "or describe your own…" link opens the composer). */
+        layout?: "button" | "chips-first";
+        /** Optional mark above the title. Default "none" (Yousef's pick). */
+        mark?: "none" | "sparkle" | "tile";
+    };
+    children?: ReactNode;
+}): import("react").JSX.Element;
+//# sourceMappingURL=vendo-slot.d.ts.map

package/dist/chrome/vendo-slot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendo-slot.d.ts","sourceRoot":"","sources":["../../src/chrome/vendo-slot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAgC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAwDrE;;;+EAG+E;AAC/E,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,OAAO,EAAE,SAAS,CAAC;IACnB,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5B;8DAC0D;IAC1D,QAAQ,CAAC,CAAC,GAAG,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC1F;AAED;;;;;;;;;;;;uBAYuB;AACvB,wBAAgB,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAa,EAAE,WAAW,EAAE,QAAe,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE;IACpI,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,YAAY,CAAC;IACnB;qFACiF;IACjF,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;;mEAE+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;;8EAQ0E;IAC1E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;oEAEgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;+CAG2C;IAC3C,UAAU,CAAC,EAAE;QACX,0CAA0C;QAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,sEAAsE;QACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,qEAAqE;QACrE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,uEAAuE;QACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB;qFAC6E;QAC7E,MAAM,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;QAClC,qEAAqE;QACrE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;KACpC,CAAC;IACF,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,+BA4KA"}

package/dist/chrome/vendo-slot.js

@@ -0,0 +1,153 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useEffect, useMemo, useState } from "react";
+import { useVendoContext } from "../context.js";
+import { useApp } from "../hooks/use-app.js";
+import { useSlotApp } from "../hooks/use-slot-app.js";
+import { FluidReveal } from "../tree/fluid-reveal.js";
+import { AppFrame, PinMount } from "../tree/frames.js";
+import { ChromeRoot } from "./chrome-root.js";
+import { developmentMode } from "./dev-mode.js";
+import { defaultSlotSuggestions } from "./discoverability.js";
+import { openVendoConversation } from "./overlay-registry.js";
+import { openVendoPalette } from "./palette-hotkey.js";
+/** The faint skeleton behind the ghost/empty states — decorative only. */
+function GhostSkeleton() {
+    return (_jsxs("span", { className: "fl-slot-skel", "aria-hidden": "true", children: [_jsx("span", { className: "fl-skel-line", style: { width: "54%" } }), _jsx("span", { className: "fl-skel-line", style: { width: "78%" } }), _jsx("span", { className: "fl-skel-line", style: { width: "42%" } }), _jsxs("span", { className: "fl-skel-bars", children: [_jsx("span", { style: { height: "42%" } }), _jsx("span", { style: { height: "68%" } }), _jsx("span", { style: { height: "52%" } }), _jsx("span", { style: { height: "84%" } }), _jsx("span", { style: { height: "62%" } })] })] }));
+}
+function SlotGhost({ label, detail, loading = false }) {
+    return (_jsxs("div", { className: "fl-slot-ghost", role: loading ? "status" : undefined, "aria-live": loading ? "polite" : undefined, children: [_jsx(GhostSkeleton, {}), _jsxs("span", { className: "fl-slot-cta", children: [_jsx("span", { className: "fl-slot-cta-label", children: label }), detail ? _jsx("small", { children: detail }) : null] })] }));
+}
+function MountedApp({ appId }) {
+    const { client, components } = useVendoContext();
+    const { surface, refresh } = useApp(appId);
+    // Wave 7 H2 — the served-surface keepalive: user activity pings the machine
+    // (host-proxied) so an embedded served app doesn't idle out under the user;
+    // a "woke" ping re-opens for the fresh machine URL.
+    const keepalive = useMemo(() => ({ ping: () => client.apps.pingMachine(appId), reopen: refresh }), [appId, client, refresh]);
+    if (!surface)
+        return _jsx(SlotGhost, { label: "Loading app\u2026", loading: true });
+    return _jsx(AppFrame, { surface: surface, components: components, keepalive: keepalive, onAction: ({ action, payload }) => client.apps.call(appId, action, payload ?? {}) }, appId);
+}
+/** 08-ui §4; 06-apps §8 — inline mount that never sacrifices host fallback content.
+ *
+ *  Three states:
+ *  - empty: no `appId`, no `pin`, no `children` → the ghost with a REAL CTA button
+ *    that opens the authoring surface (`onAuthor`, else the mounted ⌘K palette);
+ *  - app: `appId` → the whole app document mounts (via the single-app transport);
+ *  - pinned component: `pin` → the authored `vendo-genui/v2` view mounts in place.
+ *
+ *  In both filled states the swap morphs through the ENG-205 render slot, using
+ *  the host's own markup as the exit frame, and the PinMount error boundary keeps
+ *  the original `children` as the visible recovery path (06-apps §8). Without any
+ *  of the three, the children render UNTOUCHED (no wrapper — hosts may inline
+ *  slots anywhere). */
+export function VendoSlot({ id, appId: appIdProp, pin, onAuthor, remix = false, remixPrompt, discover = true, emptyState, children }) {
+    const { client, components } = useVendoContext();
+    // Self-discovery (ui-usage-dx §2): with no explicit `appId`/`pin`, the slot
+    // resolves its own pinned app — hosts never write the polling dance.
+    const discovery = useSlotApp(id, { enabled: discover && appIdProp === undefined && pin === undefined });
+    const appId = appIdProp ?? (pin === undefined ? discovery.appId : undefined);
+    const [remixBusy, setRemixBusy] = useState(false);
+    // Latch: a fork that RESOLVED but has not surfaced as `appId` yet. With
+    // discover={false} the parent manages appId on its own poll cadence, so the
+    // slot still looks empty after the fast wire fork returns — and the wire
+    // fork is not idempotent, so a second tap would mint a duplicate app.
+    const [forkPending, setForkPending] = useState(false);
+    useEffect(() => {
+        if (appId !== undefined)
+            setForkPending(false);
+    }, [appId]);
+    const remixLatched = remixBusy || (forkPending && appId === undefined);
+    // Dev rail: the remix gesture forks the component captured under this slot's
+    // registered name — an unregistered name means there is nothing to fork.
+    // (The client can't see catalog `remixable` flags; init verifies those.)
+    useEffect(() => {
+        if (!remix || !developmentMode() || components[id] !== undefined)
+            return;
+        console.warn(`[vendo] VendoSlot "${id}" sets remix, but no host component is registered under that name — register it (marked remixable) so sync captures the source the Remix gesture forks.`);
+    }, [remix, id, components]);
+    const author = () => {
+        if (onAuthor) {
+            onAuthor(id);
+            return;
+        }
+        // One-surface model (pick P-C): authoring opens the conversation overlay
+        // with the composer focused. The palette-opener fallback keeps hosts that
+        // mounted only a VendoPalette (custom onCommand routing) working.
+        if (!openVendoConversation())
+            openVendoPalette();
+    };
+    // Suggestion chips prefill the composer — never send (safe on any prompt).
+    // No palette-opener fallback here: it cannot carry the prompt, so it would
+    // open an empty surface and silently drop the chip's text (cubic PR#391
+    // finding). Without an overlay the chip is a dev-warned no-op instead.
+    const suggest = (prompt) => {
+        const opened = openVendoConversation({ prompt, send: false });
+        if (!opened && developmentMode()) {
+            console.warn(`[vendo] VendoSlot "${id}": suggestions open the conversation surface — mount a VendoOverlay for them to land in.`);
+        }
+    };
+    // Gesture-owned forking (2026-07-21): the Remix gesture on an EMPTY slot
+    // executes the fork DETERMINISTICALLY through the wire (the engine copies
+    // the captured source and records the pin — no model call, and the model
+    // never decides to fork); the fork then mounts via slot discovery. On a
+    // slot already holding an app the fork exists, so the gesture opens the
+    // composer prefilled — the instruction rides an ordinary edit.
+    const startRemix = () => {
+        // A slot is FILLED when it holds an app OR a host-supplied pin (the pin
+        // branch mounts through AppFrame the same way) — either way the fork
+        // already exists, so the gesture opens the composer, never the wire fork.
+        if (appId !== undefined || pin !== undefined) {
+            const prompt = remixPrompt ?? `Update my ${id} remix: `;
+            const opened = openVendoConversation({ prompt, send: false });
+            if (!opened && developmentMode()) {
+                console.warn(`[vendo] VendoSlot "${id}": remix opens the conversation surface — mount a VendoOverlay for it to land in.`);
+            }
+            return;
+        }
+        if (remixLatched)
+            return;
+        setRemixBusy(true);
+        client.apps.forkPin({ slot: id })
+            .then(() => {
+            setForkPending(true);
+            return discovery.refresh();
+        })
+            .catch((error) => {
+            if (developmentMode()) {
+                console.warn(`[vendo] VendoSlot "${id}": the remix fork failed — ${error instanceof Error ? error.message : String(error)}`);
+            }
+        })
+            .finally(() => setRemixBusy(false));
+    };
+    const remixButton = remix ? (_jsxs("button", { type: "button", className: "fl-slot-remix", "aria-label": `Remix ${id} with Vendo`, "aria-busy": remixLatched || undefined, disabled: remixLatched, onClick: startRemix, children: [_jsx("svg", { width: "12", height: "12", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { d: "m12 3 1.5 4.5L18 9l-4.5 1.5L12 15l-1.5-4.5L6 9l4.5-1.5L12 3Z" }) }), remixLatched ? "Remixing…" : "Remix"] })) : null;
+    if (!appId && !pin) {
+        if (children !== undefined) {
+            if (remixButton === null)
+                return _jsx(_Fragment, { children: children });
+            // The affordance needs a positioned boundary over the host's own markup;
+            // the inline wrapper stays layout-neutral (the ChromeRoot child is an
+            // empty block carrying only the absolutely-positioned button).
+            return (_jsxs("div", { "data-vendo-slot": id, style: { position: "relative", height: "100%" }, children: [_jsx(ChromeRoot, { automaticPolicyNotice: false, children: remixButton }), children] }));
+        }
+        // The invitation (pick S-A×S-D): accent-washed surface, real copy, up to
+        // three concrete suggestion chips, and (layout "button") a primary CTA.
+        // The skeleton stays behind at low opacity so it still reads as "a view
+        // goes here". No icon by default.
+        const invite = {
+            title: emptyState?.title ?? "This space builds itself",
+            subtitle: emptyState?.subtitle ?? "describe a view — it renders here, live on your data",
+            suggestions: (emptyState?.suggestions ?? defaultSlotSuggestions).slice(0, 3),
+            ctaLabel: emptyState?.ctaLabel ?? "Design a view",
+            layout: emptyState?.layout ?? "button",
+            mark: emptyState?.mark ?? "none",
+        };
+        return (_jsx(ChromeRoot, { children: _jsx("div", { className: "fl-slot", "data-vendo-slot": id, children: _jsxs("div", { className: "fl-slot-ghost fl-slot-invite", children: [_jsx(GhostSkeleton, {}), _jsxs("div", { className: "fl-slot-cta", role: "group", "aria-label": invite.title, children: [invite.mark !== "none" ? (_jsx("span", { className: `fl-invite-mark${invite.mark === "tile" ? " fl-invite-mark-tile" : ""}`, "aria-hidden": "true", children: _jsxs("svg", { width: "19", height: "19", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: [_jsx("path", { d: "m12 3 1.4 4.1L17.5 8.5l-4.1 1.4L12 14l-1.4-4.1-4.1-1.4 4.1-1.4L12 3Z" }), _jsx("path", { d: "m18 14 .8 2.2L21 17l-2.2.8L18 20l-.8-2.2L15 17l2.2-.8L18 14Z" })] }) })) : null, _jsx("span", { className: "fl-invite-title", children: invite.title }), _jsx("small", { className: "fl-invite-sub", children: invite.subtitle }), invite.suggestions.length > 0 ? (_jsxs(_Fragment, { children: [_jsx("span", { className: "fl-invite-try", children: "Try one" }), _jsx("div", { className: "fl-invite-chips", children: invite.suggestions.map((prompt, i) => (_jsx("button", { type: "button", className: "fl-invite-chip", onClick: () => suggest(prompt), children: prompt }, `${i}-${prompt}`))) })] })) : null, invite.layout === "button" ? (_jsx("button", { type: "button", className: "fl-invite-btn", onClick: author, children: invite.ctaLabel })) : (_jsx("button", { type: "button", className: "fl-invite-own", onClick: author, children: "or describe your own\u2026" }))] })] }) }) }));
+    }
+    const Fallback = () => _jsx(_Fragment, { children: children });
+    const mounted = appId
+        ? _jsx(MountedApp, { appId: appId })
+        : _jsx(AppFrame, { surface: { kind: "tree", payload: pin.payload }, components: components, data: pin.data, onAction: pin.onAction });
+    return (_jsx(ChromeRoot, { children: _jsxs("div", { className: "fl-slot", "data-vendo-slot": id, children: [remixButton, _jsx("div", { className: "fl-slot-filled", children: _jsx(FluidReveal, { stateKey: appId ? `app:${appId}` : `pin:${id}`, initialExit: children, children: _jsx(PinMount, { slot: id, fallback: Fallback, children: mounted }) }) })] }) }));
+}
+//# sourceMappingURL=vendo-slot.js.map

package/dist/chrome/vendo-slot.js.map

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

package/dist/chrome/vendo-toasts.d.ts

@@ -0,0 +1,40 @@
+/** ENG-225 — VendoToasts: the delivery surface for moments that land while the
+    user is elsewhere on the page (an automation finishing, an approval parking).
+    One fixed stack (.fl-toasts), portaled to <body> so no host stacking context
+    can trap it, carrying its own theme boundary like MorphToast.
+
+    Two feeds compose it:
+    - `vendoToast(...)` — the imperative host API (module singleton, works from
+      any code path; automations delivery wires through this).
+    - `approvals` — opt-in polling of pending approvals: a NEWLY parked approval
+      raises an approval-required toast, decidable in place. */
+import { type ReactNode } from "react";
+export interface VendoToastAction {
+    label: string;
+    onAction(): void;
+    /** Primary renders as the filled approve-style button. */
+    primary?: boolean;
+}
+export interface VendoToastInput {
+    text: string;
+    kind?: "info" | "approval-required";
+    state?: "info" | "error";
+    hint?: string;
+    actions?: VendoToastAction[];
+    /** Auto-dismiss after this many ms; 0 keeps the toast until dismissed.
+        Defaults to 6000, or sticky for approval-required. */
+    durationMs?: number;
+}
+/** Withdraw every queued toast (host page teardown, tests). */
+export declare function dismissAllVendoToasts(): void;
+/** Raise a toast. Returns a dismiss handle. */
+export declare function vendoToast(input: VendoToastInput): () => void;
+export interface VendoToastsProps {
+    placement?: "bottom-right" | "bottom-left" | "top-right";
+    /** Also surface newly parked approvals as toasts (polls /approvals/pending). */
+    approvals?: boolean;
+    pollMs?: number;
+}
+/** 08-ui §4 chrome — mount once per page. */
+export declare function VendoToasts({ placement, approvals, pollMs }?: VendoToastsProps): ReactNode;
+//# sourceMappingURL=vendo-toasts.d.ts.map

package/dist/chrome/vendo-toasts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendo-toasts.d.ts","sourceRoot":"","sources":["../../src/chrome/vendo-toasts.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;+DAS+D;AAC/D,OAAO,EAA2C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAQhF,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,IAAI,IAAI,CAAC;IACjB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B;6DACyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA2BD,+DAA+D;AAC/D,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,+CAA+C;AAC/C,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,IAAI,CAO7D;AAyED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,cAAc,GAAG,aAAa,GAAG,WAAW,CAAC;IACzD,gFAAgF;IAChF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,6CAA6C;AAC7C,wBAAgB,WAAW,CAAC,EAAE,SAA0B,EAAE,SAAiB,EAAE,MAAc,EAAE,GAAE,gBAAqB,GAAG,SAAS,CA8D/H"}

package/dist/chrome/vendo-toasts.js

@@ -0,0 +1,135 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/** ENG-225 — VendoToasts: the delivery surface for moments that land while the
+    user is elsewhere on the page (an automation finishing, an approval parking).
+    One fixed stack (.fl-toasts), portaled to <body> so no host stacking context
+    can trap it, carrying its own theme boundary like MorphToast.
+
+    Two feeds compose it:
+    - `vendoToast(...)` — the imperative host API (module singleton, works from
+      any code path; automations delivery wires through this).
+    - `approvals` — opt-in polling of pending approvals: a NEWLY parked approval
+      raises an approval-required toast, decidable in place. */
+import { useEffect, useRef, useSyncExternalStore } from "react";
+import { createPortal } from "react-dom";
+import { useVendoContext } from "../context.js";
+import { useApprovals } from "../hooks/use-approvals.js";
+import { themeCssVariables } from "../theme.js";
+import { ensureChromeStyles } from "./chrome-root.js";
+import { toolTitle } from "./humanize.js";
+// Module singleton so `vendoToast` works from any code path, not only under a
+// provider. Every mounted <VendoToasts> renders the same queue.
+let nextToastId = 1;
+let queue = [];
+const listeners = new Set();
+const timers = new Map();
+function notify() {
+    for (const listener of listeners)
+        listener();
+}
+function removeToast(id) {
+    const timer = timers.get(id);
+    if (timer !== undefined)
+        clearTimeout(timer);
+    timers.delete(id);
+    if (queue.some(toast => toast.id === id)) {
+        queue = queue.filter(toast => toast.id !== id);
+        notify();
+    }
+}
+/** Withdraw every queued toast (host page teardown, tests). */
+export function dismissAllVendoToasts() {
+    for (const toast of [...queue])
+        removeToast(toast.id);
+}
+/** Raise a toast. Returns a dismiss handle. */
+export function vendoToast(input) {
+    const id = nextToastId++;
+    queue = [...queue, { ...input, id }];
+    const duration = input.durationMs ?? (input.kind === "approval-required" ? 0 : 6_000);
+    if (duration > 0)
+        timers.set(id, setTimeout(() => removeToast(id), duration));
+    notify();
+    return () => removeToast(id);
+}
+function subscribe(listener) {
+    listeners.add(listener);
+    return () => listeners.delete(listener);
+}
+const EMPTY = [];
+function useToastQueue() {
+    return useSyncExternalStore(subscribe, () => queue, () => EMPTY);
+}
+/** Opt-in approval feed: raises a toast for every approval that parks AFTER
+    mount (the pre-existing backlog belongs to the WaitingQueue, not to a toast
+    storm on page load), and withdraws it once decided elsewhere. */
+function ApprovalToasts({ pollMs }) {
+    const { tools } = useVendoContext();
+    const { pending, isLoading, decide } = useApprovals({ pollMs });
+    // null until the first fetch settles — that first batch is baseline, not news.
+    const seenRef = useRef(null);
+    const dismissersRef = useRef(new Map());
+    useEffect(() => {
+        const dismissers = dismissersRef.current;
+        if (seenRef.current === null) {
+            // The hook's initial [] (fetch still in flight) is not the baseline —
+            // waiting for it would toast the whole pre-existing backlog on load.
+            if (isLoading)
+                return;
+            seenRef.current = new Set(pending.map(approval => approval.id));
+            return;
+        }
+        const seen = seenRef.current;
+        for (const approval of pending) {
+            if (seen.has(approval.id) || dismissers.has(approval.id))
+                continue;
+            seen.add(approval.id);
+            const dismiss = vendoToast({
+                kind: "approval-required",
+                text: `Waiting on you: ${toolTitle(approval.call.tool, tools[approval.call.tool])}`,
+                hint: "recorded in Activity",
+                actions: [{
+                        label: "Approve",
+                        primary: true,
+                        onAction: () => {
+                            void decide(approval.id, { approve: true }).then(() => {
+                                dismissers.get(approval.id)?.();
+                                dismissers.delete(approval.id);
+                            }).catch(() => {
+                                // The decide failed — the approval is still parked server-side.
+                                // Keep the toast so Approve stays retryable, and un-see the id
+                                // so a later poll can re-raise it once this card is gone.
+                                seen.delete(approval.id);
+                            });
+                        },
+                    }],
+            });
+            dismissers.set(approval.id, dismiss);
+        }
+        // Decided (or expired) elsewhere: withdraw the stale toast.
+        const pendingIds = new Set(pending.map(approval => approval.id));
+        for (const [id, dismiss] of dismissers) {
+            if (!pendingIds.has(id)) {
+                dismiss();
+                dismissers.delete(id);
+            }
+        }
+    }, [pending, isLoading, decide, tools]);
+    useEffect(() => () => {
+        for (const dismiss of dismissersRef.current.values())
+            dismiss();
+        dismissersRef.current.clear();
+    }, []);
+    return null;
+}
+/** 08-ui §4 chrome — mount once per page. */
+export function VendoToasts({ placement = "bottom-right", approvals = false, pollMs = 5_000 } = {}) {
+    const { theme } = useVendoContext();
+    const toasts = useToastQueue();
+    // The stack portals out of any ChromeRoot subtree, so it owns its own style
+    // injection — a page that mounts ONLY VendoToasts still renders styled.
+    useEffect(ensureChromeStyles, []);
+    if (typeof document === "undefined")
+        return null;
+    return (_jsxs(_Fragment, { children: [approvals ? _jsx(ApprovalToasts, { pollMs: pollMs }) : null, toasts.length > 0 ? createPortal(_jsx("div", { className: "vendo-root", "data-vendo-motion": theme.motion, "data-vendo-density": theme.density, style: themeCssVariables(theme), children: _jsx("div", { className: "fl-toasts", "data-placement": placement, role: "region", "aria-label": "Notifications", children: toasts.map(toast => (_jsxs("div", { className: "fl-toasts-card", "data-kind": toast.kind ?? "info", "data-state": toast.state ?? "info", role: "status", children: [_jsx("span", { className: "fl-toasts-icon", "aria-hidden": "true", children: toast.kind === "approval-required" ? (_jsxs("svg", { width: "14", height: "14", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: [_jsx("circle", { cx: "12", cy: "12", r: "10" }), _jsx("path", { d: "M12 6v6l4 2" })] })) : (_jsxs("svg", { width: "14", height: "14", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: [_jsx("circle", { cx: "12", cy: "12", r: "10" }), _jsx("path", { d: "M12 16v-4M12 8h.01" })] })) }), _jsxs("div", { className: "fl-toasts-body", children: [_jsx("div", { className: "fl-toasts-text", children: toast.text }), _jsxs("div", { className: "fl-toasts-actions", children: [(toast.actions ?? []).map(action => (_jsx("button", { type: "button", className: action.primary === true ? "fl-toasts-approve" : "fl-toasts-view", onClick: action.onAction, children: action.label }, action.label))), toast.hint !== undefined ? _jsx("span", { className: "fl-toasts-hint", children: toast.hint }) : null, _jsx("button", { type: "button", className: "fl-toasts-dismiss", "aria-label": "Dismiss notification", onClick: () => removeToast(toast.id), children: "\u00D7" })] })] })] }, toast.id))) }) }), document.body) : null] }));
+}
+//# sourceMappingURL=vendo-toasts.js.map

package/dist/chrome/vendo-toasts.js.map

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

package/dist/chrome/vendo-trigger.d.ts

@@ -0,0 +1,24 @@
+import type { ReactNode } from "react";
+export interface VendoTriggerProps {
+    /** The prompt preloaded into the conversation composer — prefilled, never
+     *  auto-sent, so a trigger is safe even on destructive prompts. */
+    prompt: string;
+    /** Optional context appended to the prompt (blank-line separated) — the
+     *  record or state on screen, so the agent starts oriented. */
+    context?: string;
+    /** Button label. Default "Ask Vendo". */
+    children?: ReactNode;
+}
+/**
+ * The shelf's "do it with AI" button (ui-usage-dx §2): every host affordance
+ * that hands a task to the agent is this piece. Activation opens the most
+ * recently mounted conversation surface (the VendoOverlay) with the prompt
+ * seeded into the composer.
+ *
+ * Hosts that want their own element as the trigger skip this component and
+ * call `openVendoConversation({ prompt })` from it directly — the same
+ * programmatic seam this button uses (the repo's idiom; there is deliberately
+ * no render-prop API on chrome, ui-usage-dx §4).
+ */
+export declare function VendoTrigger({ prompt, context, children }: VendoTriggerProps): import("react").JSX.Element;
+//# sourceMappingURL=vendo-trigger.d.ts.map

package/dist/chrome/vendo-trigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendo-trigger.d.ts","sourceRoot":"","sources":["../../src/chrome/vendo-trigger.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,MAAM,WAAW,iBAAiB;IAChC;uEACmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf;mEAC+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,iBAAiB,+BA2B5E"}