@vendoai/ui 0.4.0

package/dist/eject-templates/thread/scrolling.ts

@@ -0,0 +1,223 @@
+/**
+ * Ejected from @vendoai/ui v0.4.0 — yours to edit.
+ * Presentation only: data and wire logic still flow through @vendoai/ui
+ * imports, so protocol updates keep working while these pixels are yours.
+ */
+import type { UIMessage } from "ai";
+import { useEffect, useLayoutEffect, useRef, useState } from "react";
+
+/** ENG-218 — windowing for long threads. Rendering a reopened 200-turn thread
+    mounts every turn's DOM (and runs every entrance animation) at once. Instead
+    we render only a trailing window of the most recent messages and reveal older
+    ones in chunks when the reader scrolls to the top — the DOM stays bounded, so
+    scroll and paint stay smooth no matter how long the transcript is.
+
+    The trailing window is what stick-to-bottom and jump-to-latest already care
+    about (both operate at the end), so those behaviors are untouched. Only the
+    unseen head of a genuinely long thread is deferred. */
+const WINDOW_INITIAL = 60;
+const WINDOW_STEP = 40;
+const NEAR_TOP_PX = 200;
+
+export function useMessageWindow(messages: UIMessage[], listRef: React.RefObject<HTMLDivElement | null>, threadKey?: string) {
+  // How many trailing messages to render. Grows (never shrinks the head back
+  // out from under the reader) as they scroll up; resets when the thread swaps.
+  const [count, setCount] = useState(WINDOW_INITIAL);
+  useEffect(() => { setCount(WINDOW_INITIAL); }, [threadKey]);
+
+  const start = Math.max(0, messages.length - count);
+  const windowed = start === 0 ? messages : messages.slice(start);
+  const hasOlder = start > 0;
+
+  // Anchor the viewport across a window growth: prepending older turns balloons
+  // scrollHeight, which would otherwise yank the reader. Capture distance-from-
+  // bottom at expand time and restore it after the new nodes lay out.
+  const anchorRef = useRef<number | null>(null);
+  const loadOlder = () => {
+    if (start === 0) return;
+    const node = listRef.current;
+    anchorRef.current = node ? node.scrollHeight - node.scrollTop : null;
+    setCount(current => current + WINDOW_STEP);
+  };
+  useLayoutEffect(() => {
+    const node = listRef.current;
+    if (anchorRef.current === null || !node) return;
+    node.scrollTop = node.scrollHeight - anchorRef.current;
+    anchorRef.current = null;
+  });
+
+  // Reveal more when the reader reaches the top of the rendered window.
+  const onNearTop = () => {
+    const node = listRef.current;
+    if (node && node.scrollTop <= NEAR_TOP_PX) loadOlder();
+  };
+
+  return { windowed, hasOlder, olderCount: start, loadOlder, onNearTop };
+}
+
+/** Within this many pixels of the end the reader counts as "at the bottom" —
+    a paragraph of slack so sub-line wobble (fractional scroll positions,
+    entrance easing) never breaks the stick. */
+const BOTTOM_SLACK_PX = 32;
+
+/** ENG-213 — scroll management for the message list.
+
+    Stick-to-bottom: while the reader is at the end, every content change
+    (history load, streamed deltas, tool chips, approvals) keeps the latest
+    content in view. The moment the reader scrolls up, the stick releases —
+    streaming must never yank them — and it re-arms when they return to the
+    bottom on their own. Jump-to-latest: when new content lands while the
+    reader is scrolled up, the stylesheet's .fl-jump affordance appears;
+    activating it scrolls to the latest turn and re-sticks. */
+export function useStickToBottom(messages: UIMessage[], threadKey?: string, contentRevision?: unknown) {
+  const listRef = useRef<HTMLDivElement>(null);
+  // The stick is a ref, not state: it flips inside scroll/effect timing and
+  // must be readable synchronously without re-render races.
+  const stuckRef = useRef(true);
+  const lastScrollHeightRef = useRef(0);
+  const [unseen, setUnseen] = useState(false);
+  // Lane pick 3A — the jump affordance grew into a bar with a COUNT of turns
+  // that landed while scrolled away and a snippet of the newest text. Count =
+  // messages appended since the stick released; snippet = the latest turn's
+  // trailing text (best-effort, purely presentational).
+  const [unseenCount, setUnseenCount] = useState(0);
+  const seenLengthRef = useRef(messages.length);
+
+  // A different conversation is a different reader position: when the caller
+  // switches the hook to another thread, re-arm the stick and forget the
+  // previous thread's growth baseline — otherwise a scroll-up in the old
+  // thread would keep the new one from opening at its latest turn.
+  const previousThreadKeyRef = useRef(threadKey);
+  useEffect(() => {
+    const previousKey = previousThreadKeyRef.current;
+    previousThreadKeyRef.current = threadKey;
+    // ENG-222 id mint is NOT a thread switch: a conversation started without
+    // an id gets its server-minted thr_ fed back mid-first-stream (VendoPage's
+    // onThreadId loop), flipping this key while the reader is mid-read. The
+    // messages are the same conversation — KEEP the growth baseline: zeroing
+    // it makes previousHeight === 0 read as "at bottom by definition", so the
+    // next streamed chunk yanks a reader who had scrolled up (deterministic on
+    // slow runners — the "streaming must never yank" conformance failure).
+    // Re-arm the stick and clear the bar though: with the real baseline
+    // intact, the next mutation's previous-height guard releases a genuinely
+    // scrolled-up reader, while a bottom reader stays pinned instead of
+    // leaking a transient new-replies bar.
+    if (previousKey === undefined && threadKey !== undefined && messages.length > 0) {
+      stuckRef.current = true;
+      setUnseen(false);
+      setUnseenCount(0);
+      return;
+    }
+    stuckRef.current = true;
+    lastScrollHeightRef.current = 0;
+    setUnseen(false);
+    setUnseenCount(0);
+    // messages.length is deliberately unlisted: this effect keys on identity
+    // changes only, and the mint guard needs the length at flip time.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [threadKey]);
+
+  const atBottom = (node: HTMLElement) =>
+    node.scrollHeight - node.scrollTop - node.clientHeight <= BOTTOM_SLACK_PX;
+
+  const onScroll = () => {
+    const node = listRef.current;
+    if (!node) return;
+    // Both user scrolls and our own programmatic sticks land here; either way
+    // the reader's actual position is the single source of truth.
+    stuckRef.current = atBottom(node);
+    if (stuckRef.current) {
+      setUnseen(false);
+      setUnseenCount(0);
+      seenLengthRef.current = messages.length;
+    }
+  };
+
+  const jumpToLatest = () => {
+    const node = listRef.current;
+    if (!node) return;
+    stuckRef.current = true;
+    setUnseen(false);
+    setUnseenCount(0);
+    seenLengthRef.current = messages.length;
+    node.scrollTop = node.scrollHeight;
+  };
+
+  // After every content change: stick if the reader is at the bottom, or flag
+  // the new content if they've scrolled away. Layout effects would run before
+  // paint, but streamed markdown re-renders arrive in bursts — post-paint is
+  // indistinguishable here and cheaper.
+  useEffect(() => {
+    const node = listRef.current;
+    if (!node) return;
+    const previousHeight = lastScrollHeightRef.current;
+    const grew = node.scrollHeight > previousHeight;
+    lastScrollHeightRef.current = node.scrollHeight;
+    // The scroll event that releases the stick is ASYNC: a reader who just
+    // scrolled up can have content land before onScroll flips stuckRef, and
+    // trusting the stale ref would yank them back down ("streaming must never
+    // yank"). Their position against the PREVIOUS content height is ground
+    // truth: stuck growth leaves scrollTop at the old bottom; a scroll-up
+    // puts it well above. Release the stick here instead of yanking.
+    const atPreviousBottom = previousHeight === 0
+      || previousHeight - node.scrollTop - node.clientHeight <= BOTTOM_SLACK_PX;
+    // …unless they are at the CURRENT bottom: when content SHRINKS (a connect
+    // card or generated view swaps out), scrollTop can no longer equal the old
+    // taller bottom, and the previous-height test alone misreads the reader as
+    // scrolled-up — releasing the stick and leaking a new-replies bar on the
+    // next turn even though they never moved. At-current-bottom is at bottom.
+    if (stuckRef.current && !atPreviousBottom && !atBottom(node)) stuckRef.current = false;
+    if (stuckRef.current) {
+      node.scrollTop = node.scrollHeight;
+      seenLengthRef.current = messages.length;
+    } else if (grew) {
+      setUnseen(true);
+      setUnseenCount(Math.max(1, messages.length - seenLengthRef.current));
+    }
+    // contentRevision — ENG-215: turn-actions (Edit/Regenerate) mount below the
+    // last turn the instant a stream settles (busy→false), adding height AFTER
+    // the message-driven stick already ran. Re-run so the reader stays pinned.
+  }, [messages, contentRevision]);
+
+  // A generated view mounts and grows AFTER the messages effect runs (the jail
+  // renders async; logos/images load late). Without watching actual size, the
+  // stick fires before the growth and the newest content — the approval card,
+  // the closing line — lands below the fold. Observe the content box and
+  // re-stick whenever it grows while the reader is at the bottom.
+  useEffect(() => {
+    const node = listRef.current;
+    if (!node || typeof ResizeObserver === "undefined") return;
+    const observer = new ResizeObserver(() => {
+      // Same async-scroll-event guard as the messages effect: only re-stick a
+      // reader who was actually at the bottom of the previous content.
+      const previousHeight = lastScrollHeightRef.current;
+      const atPreviousBottom = previousHeight === 0
+        || previousHeight - node.scrollTop - node.clientHeight <= BOTTOM_SLACK_PX;
+      lastScrollHeightRef.current = node.scrollHeight;
+      if (stuckRef.current && !atPreviousBottom && !atBottom(node)) stuckRef.current = false;
+      if (stuckRef.current) node.scrollTop = node.scrollHeight;
+    });
+    for (const child of Array.from(node.children)) observer.observe(child);
+    const mutation = new MutationObserver(() => {
+      for (const child of Array.from(node.children)) observer.observe(child);
+    });
+    mutation.observe(node, { childList: true, subtree: true });
+    return () => {
+      observer.disconnect();
+      mutation.disconnect();
+    };
+  }, []);
+
+  // 3A snippet: trailing text of the newest message (bounded; presentational).
+  const lastMessage = messages.at(-1);
+  const snippet = unseen && lastMessage
+    ? lastMessage.parts
+        .filter((part): part is Extract<typeof part, { type: "text" }> => part.type === "text")
+        .map(part => part.text)
+        .join(" ")
+        .trim()
+        .slice(0, 120)
+    : "";
+
+  return { listRef, onScroll, jumpToLatest, showJump: unseen, unseenCount, snippet };
+}

package/dist/embeds.d.ts

@@ -0,0 +1,28 @@
+import type { VendoAppRef, VendoApprovalRef } from "@vendoai/core";
+/**
+ * Existing-agents contract — prop shapes for the three embeds a BYO chat
+ * surface renders from `vendo_*` tool outputs (Wave 0 freeze; Wave 1 Lane B
+ * builds the components behind them on the existing slot / build-beat /
+ * approval-card machinery, inside the same `VendoProvider`).
+ * Frozen in `docs/superpowers/specs/2026-07-20-existing-agents-contracts.md`.
+ */
+/** Inline generated app: build-beat while the build streams, then the live
+ *  app. In-app interactions go over the wire, not through the host loop. */
+export interface VendoAppEmbedProps {
+    refValue: VendoAppRef;
+}
+/** Where an approval embed can be, in the order it gets there. The wire owns
+ *  the state; the embed only renders it — resolving in place to the executed
+ *  outcome, "declined", or "expired" (the existing failed/expired vocabulary,
+ *  never a silent blank). */
+export type VendoApprovalEmbedState = "pending" | "executed" | "declined" | "expired";
+/** Approve/deny for a parked guarded call. */
+export interface VendoApprovalEmbedProps {
+    refValue: VendoApprovalRef;
+}
+/** The dispatcher: give it any `vendo_*` tool output and it renders the right
+ *  embed by `parseVendoToolEnvelope`, or nothing for plain data. */
+export interface VendoToolResultProps {
+    output: unknown;
+}
+//# sourceMappingURL=embeds.d.ts.map

package/dist/embeds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeds.d.ts","sourceRoot":"","sources":["../src/embeds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEnE;;;;;;GAMG;AAEH;4EAC4E;AAC5E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,WAAW,CAAC;CACvB;AAED;;;6BAG6B;AAC7B,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAEtF,8CAA8C;AAC9C,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED;oEACoE;AACpE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,OAAO,CAAC;CACjB"}

package/dist/embeds.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=embeds.js.map

package/dist/embeds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeds.js","sourceRoot":"","sources":["../src/embeds.ts"],"names":[],"mappings":""}

package/dist/hooks/index.d.ts

@@ -0,0 +1,18 @@
+/** Complete headless hook surface (08-ui §3). */
+export { useActivity } from "./use-activity.js";
+export { useApp } from "./use-app.js";
+export { useApps } from "./use-apps.js";
+export { useApprovals } from "./use-approvals.js";
+export { useAutomations } from "./use-automations.js";
+export { useConnections } from "./use-connections.js";
+export { useConnectorCatalog } from "./use-connector-catalog.js";
+export { useGrants } from "./use-grants.js";
+export { useMobileTakeover, type MobileTakeover } from "./use-mobile-takeover.js";
+export { type PollOptions } from "./use-resource.js";
+export { useSlotApp } from "./use-slot-app.js";
+export { useThreads } from "./use-threads.js";
+export { useVendoOverlay, type VendoOverlayController } from "./use-vendo-overlay.js";
+export { useVendoStatus } from "./use-vendo-status.js";
+export { useVendoThread, type VendoThreadApproval } from "./use-vendo-thread.js";
+export { ScriptedTransport, type DirectorCue, type DirectorScript } from "./scripted-transport.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAClF,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,19 @@
+/** Complete headless hook surface (08-ui §3). */
+export { useActivity } from "./use-activity.js";
+export { useApp } from "./use-app.js";
+export { useApps } from "./use-apps.js";
+export { useApprovals } from "./use-approvals.js";
+export { useAutomations } from "./use-automations.js";
+export { useConnections } from "./use-connections.js";
+export { useConnectorCatalog } from "./use-connector-catalog.js";
+export { useGrants } from "./use-grants.js";
+// Deliberately public (lane pick 1-H): the ejected thread surface imports it,
+// and hosts placing their own approval chrome need the same breakpoint truth.
+export { useMobileTakeover } from "./use-mobile-takeover.js";
+export { useSlotApp } from "./use-slot-app.js";
+export { useThreads } from "./use-threads.js";
+export { useVendoOverlay } from "./use-vendo-overlay.js";
+export { useVendoStatus } from "./use-vendo-status.js";
+export { useVendoThread } from "./use-vendo-thread.js";
+export { ScriptedTransport } from "./scripted-transport.js";
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,8EAA8E;AAC9E,8EAA8E;AAC9E,OAAO,EAAE,iBAAiB,EAAuB,MAAM,0BAA0B,CAAC;AAElF,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAA+B,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAA4B,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAyC,MAAM,yBAAyB,CAAC"}

package/dist/hooks/scripted-transport.d.ts

@@ -0,0 +1,44 @@
+import type { ChatTransport, UIMessage, UIMessageChunk } from "ai";
+/**
+ * Director mode: a chat transport that replays an authored (or recorded)
+ * sequence of UI-message chunks at scripted pacing instead of calling the
+ * agent. The thread, beats, reveals, approvals, and morphs downstream are the
+ * REAL components rendering a real part stream — only the source of the
+ * stream is scripted. Demo/capture tooling only; hosts opt in explicitly by
+ * passing it through the provider (`VendoProvider transport`), it is never a
+ * default.
+ *
+ * A cue's `chunk` is exactly one SSE `data:` payload of the live wire
+ * (`UIMessageChunk`), so a recording of a real build replays verbatim — see
+ * the recorder hook in `use-vendo-thread.ts` (`__vendoDirectorRecord`).
+ */
+export interface DirectorCue {
+    /** Milliseconds to wait after the previous cue before emitting this chunk. */
+    delay: number;
+    chunk: UIMessageChunk;
+}
+export interface DirectorScript {
+    /** Single-turn form. */
+    cues?: DirectorCue[];
+    /**
+     * Multi-turn form: each sendMessages call (initial send, then each
+     * approval-driven resume) plays the next turn in order; the last turn
+     * repeats if the surface asks again.
+     */
+    turns?: Array<{
+        cues: DirectorCue[];
+    }>;
+}
+export declare class ScriptedTransport implements ChatTransport<UIMessage> {
+    private readonly script;
+    private readonly options;
+    private turnIndex;
+    constructor(script: DirectorScript, options?: {
+        speed?: number;
+    });
+    sendMessages(options: {
+        abortSignal: AbortSignal | undefined;
+    }): Promise<ReadableStream<UIMessageChunk>>;
+    reconnectToStream(): Promise<ReadableStream<UIMessageChunk> | null>;
+}
+//# sourceMappingURL=scripted-transport.d.ts.map

package/dist/hooks/scripted-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripted-transport.d.ts","sourceRoot":"","sources":["../../src/hooks/scripted-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AAEnE;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,WAAW;IAC1B,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,cAAc,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;IACrB;;;;OAIG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,WAAW,EAAE,CAAA;KAAE,CAAC,CAAC;CACxC;AAED,qBAAa,iBAAkB,YAAW,aAAa,CAAC,SAAS,CAAC;IAI9D,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,OAAO,CAAC,SAAS,CAAK;gBAGH,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;IAGnD,YAAY,CAAC,OAAO,EAAE;QAAE,WAAW,EAAE,WAAW,GAAG,SAAS,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;IA8CxG,iBAAiB,IAAI,OAAO,CAAC,cAAc,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;CAGpE"}

package/dist/hooks/scripted-transport.js

@@ -0,0 +1,58 @@
+export class ScriptedTransport {
+    script;
+    options;
+    turnIndex = 0;
+    constructor(script, options = {}) {
+        this.script = script;
+        this.options = options;
+    }
+    sendMessages(options) {
+        const turns = this.script.turns ?? [{ cues: this.script.cues ?? [] }];
+        // Past the last authored turn, close gracefully — REPLAYING a turn would
+        // emit tool outputs for calls that live in earlier messages and corrupt
+        // the transcript.
+        const turn = this.turnIndex < turns.length
+            ? turns[this.turnIndex]
+            : {
+                cues: [
+                    { delay: 0, chunk: { type: "start" } },
+                    { delay: 100, chunk: { type: "text-start", id: "director_end" } },
+                    { delay: 50, chunk: { type: "text-delta", id: "director_end", delta: "This directed take is finished — reload the page to play it again." } },
+                    { delay: 50, chunk: { type: "text-end", id: "director_end" } },
+                    { delay: 50, chunk: { type: "finish" } },
+                ],
+            };
+        this.turnIndex += 1;
+        const cues = turn.cues;
+        const speed = this.options.speed ?? 1;
+        const signal = options.abortSignal;
+        return Promise.resolve(new ReadableStream({
+            async start(controller) {
+                for (const cue of cues) {
+                    if (signal?.aborted)
+                        break;
+                    if (cue.delay > 0) {
+                        await new Promise(resolve => setTimeout(resolve, cue.delay / speed));
+                    }
+                    if (signal?.aborted)
+                        break;
+                    controller.enqueue(cue.chunk);
+                    // Staging hook: host surfaces (the dashboard slot) can react to
+                    // the finished view landing — e.g. swapping the original
+                    // component in place — without a wire round-trip.
+                    if (typeof window !== "undefined" && cue.chunk.type === "data-vendo-view") {
+                        const data = cue.chunk.data;
+                        if (data?.payload && data.payload.streaming !== true) {
+                            window.dispatchEvent(new CustomEvent("vendo-director:view-final", { detail: data }));
+                        }
+                    }
+                }
+                controller.close();
+            },
+        }));
+    }
+    reconnectToStream() {
+        return Promise.resolve(null);
+    }
+}
+//# sourceMappingURL=scripted-transport.js.map

package/dist/hooks/scripted-transport.js.map

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

package/dist/hooks/use-activity.d.ts

@@ -0,0 +1,17 @@
+/** Self-scoped audit activity transport (08-ui §3). */
+import type { AuditEvent } from "@vendoai/core";
+import { type PollOptions } from "./use-resource.js";
+export declare function useActivity(options?: PollOptions): {
+    /** Back-compat alias for `data` (contract §3). */
+    events: AuditEvent[];
+    data: AuditEvent[];
+    error: Error | undefined;
+    isLoading: boolean;
+    /** Whether another page may still exist. Flips to `false` once a fetched page
+        is empty or repeats only already-seen rows, so the panel can show a proper
+        end-of-list state instead of a "Load more" that fetches nothing new. */
+    hasMore: boolean;
+    loadMore(): Promise<void>;
+    refresh(): Promise<void>;
+};
+//# sourceMappingURL=use-activity.d.ts.map

package/dist/hooks/use-activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-activity.d.ts","sourceRoot":"","sources":["../../src/hooks/use-activity.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAoBlE,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG;IAClD,kDAAkD;IAClD,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB;;+EAE2E;IAC3E,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B,CAgCA"}

package/dist/hooks/use-activity.js

@@ -0,0 +1,50 @@
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { useVendoContext } from "../context.js";
+import { useResource } from "./use-resource.js";
+function dedupe(events) {
+    const seen = new Set();
+    return events.filter(event => !seen.has(event.id) && seen.add(event.id));
+}
+/** The store pages audit rows on `(at, id)` behind an opaque base64url `{c,i}`
+    cursor. `/activity` returns a bare `AuditEvent[]` (09 §3), so the client
+    reconstructs that cursor from the oldest event it holds to fetch the next
+    page — the raw event id alone is not a decodable cursor. */
+function pageCursor(event) {
+    if (event === undefined)
+        return undefined;
+    const json = JSON.stringify({ c: event.at, i: event.id });
+    const base64 = typeof btoa === "function"
+        ? btoa(json)
+        : Buffer.from(json, "utf8").toString("base64");
+    return base64.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+export function useActivity(options) {
+    const { client } = useVendoContext();
+    const list = useCallback(() => client.activity.list(), [client]);
+    const { data: firstPage, error, isLoading, refresh } = useResource(list, [], options);
+    // Pages appended by loadMore; a refresh (manual or poll) reloads the first
+    // page rather than appending, so a fresh first page resets pagination and
+    // loadMore continues from the reset head.
+    const [extra, setExtra] = useState([]);
+    const [ended, setEnded] = useState(false);
+    useEffect(() => {
+        setExtra([]);
+        setEnded(false);
+    }, [firstPage]);
+    const events = useMemo(() => dedupe([...firstPage, ...extra]), [firstPage, extra]);
+    // An empty first page is already the end; a full one may have more behind
+    // the cursor, proven (or disproven) by the next loadMore.
+    const hasMore = !ended && (isLoading || firstPage.length > 0);
+    const loadMore = useCallback(async () => {
+        const cursor = pageCursor(events.at(-1));
+        const next = await client.activity.list(cursor === undefined ? undefined : { cursor });
+        const known = new Set(events.map(event => event.id));
+        const added = next.filter(event => !known.has(event.id));
+        setExtra(current => [...current, ...added]);
+        // No page, or a page that surfaced nothing new, means there is nothing
+        // older left to fetch — we have reached the end of the audit history.
+        setEnded(added.length === 0);
+    }, [client, events]);
+    return { events, data: events, error, isLoading, hasMore, loadMore, refresh };
+}
+//# sourceMappingURL=use-activity.js.map

package/dist/hooks/use-activity.js.map

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

package/dist/hooks/use-app.d.ts

@@ -0,0 +1,19 @@
+/** Single-app transport (08-ui §3). */
+import type { AppDocument, AppId, Json, ToolOutcome } from "@vendoai/core";
+import type { EditResult, OpenSurface, VersionEntry } from "../wire-types.js";
+export declare function useApp(appId: AppId): {
+    app: AppDocument | undefined;
+    /** Alias for `app` — the consistent `data` field across data hooks (§3). */
+    data: AppDocument | undefined;
+    surface: OpenSurface | undefined;
+    error: Error | undefined;
+    isLoading: boolean;
+    call(ref: string, args: Json): Promise<ToolOutcome>;
+    edit(instruction: string): Promise<EditResult>;
+    history: {
+        list(): Promise<VersionEntry[]>;
+        undo(): Promise<AppDocument>;
+    };
+    refresh(): Promise<void>;
+};
+//# sourceMappingURL=use-app.d.ts.map

package/dist/hooks/use-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-app.d.ts","sourceRoot":"","sources":["../../src/hooks/use-app.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG3E,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE9E,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG;IACpC,GAAG,EAAE,WAAW,GAAG,SAAS,CAAC;IAC7B,4EAA4E;IAC5E,IAAI,EAAE,WAAW,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACpD,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C,OAAO,EAAE;QAAE,IAAI,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QAAC,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,CAAA;KAAE,CAAC;IAC3E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B,CAkEA"}

package/dist/hooks/use-app.js

@@ -0,0 +1,66 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { useVendoContext } from "../context.js";
+export function useApp(appId) {
+    const { client } = useVendoContext();
+    const [app, setApp] = useState();
+    const [surface, setSurface] = useState();
+    const [error, setError] = useState();
+    const [isLoading, setIsLoading] = useState(true);
+    const generationRef = useRef(0);
+    // Reset per appId (below), so `isLoading` reflects only the first load of the
+    // current app — an edit/undo refresh does not flicker it true→false.
+    const loadedRef = useRef(false);
+    const refresh = useCallback(async () => {
+        // Mirror useResource: bump per call, so overlapping refreshes (manual +
+        // edit + undo) can never let a stale response clobber newer app state.
+        const generation = (generationRef.current += 1);
+        if (!loadedRef.current)
+            setIsLoading(true);
+        try {
+            const [nextApp, nextSurface] = await Promise.all([client.apps.get(appId), client.apps.open(appId)]);
+            if (generation !== generationRef.current)
+                return;
+            setApp(nextApp);
+            setSurface(nextSurface);
+            setError(undefined);
+            loadedRef.current = true;
+        }
+        catch (reason) {
+            if (generation !== generationRef.current)
+                return;
+            setError(reason instanceof Error ? reason : new Error(String(reason)));
+        }
+        finally {
+            if (generation === generationRef.current)
+                setIsLoading(false);
+        }
+    }, [appId, client]);
+    useEffect(() => {
+        loadedRef.current = false;
+        setApp(undefined);
+        setSurface(undefined);
+        setError(undefined);
+        void refresh();
+        // Bump the generation on unmount / appId change so an in-flight response
+        // can't land on a stale (or torn-down) app.
+        return () => {
+            generationRef.current += 1;
+        };
+    }, [refresh]);
+    const call = useCallback((ref, args) => client.apps.call(appId, ref, args), [appId, client]);
+    const edit = useCallback(async (instruction) => {
+        const result = await client.apps.edit(appId, instruction);
+        await refresh();
+        return result;
+    }, [appId, client, refresh]);
+    const history = useMemo(() => ({
+        list: () => client.apps.history(appId),
+        undo: async () => {
+            const result = await client.apps.undo(appId);
+            await refresh();
+            return result;
+        },
+    }), [appId, client, refresh]);
+    return { app, data: app, surface, error, isLoading, call, edit, history, refresh };
+}
+//# sourceMappingURL=use-app.js.map

package/dist/hooks/use-app.js.map

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

package/dist/hooks/use-approvals.d.ts

@@ -0,0 +1,13 @@
+/** Pending approval transport (08-ui §3). */
+import type { ApprovalDecision, ApprovalId, ApprovalRequest } from "@vendoai/core";
+import { type PollOptions } from "./use-resource.js";
+export declare function useApprovals(options?: PollOptions): {
+    /** Back-compat alias for `data` (contract §3). */
+    pending: ApprovalRequest[];
+    data: ApprovalRequest[];
+    error: Error | undefined;
+    isLoading: boolean;
+    refresh(): Promise<void>;
+    decide(ids: ApprovalId | ApprovalId[], decision: ApprovalDecision): Promise<void>;
+};
+//# sourceMappingURL=use-approvals.d.ts.map

package/dist/hooks/use-approvals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-approvals.d.ts","sourceRoot":"","sources":["../../src/hooks/use-approvals.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGnF,OAAO,EAAE,KAAK,WAAW,EAAe,MAAM,mBAAmB,CAAC;AAElE,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG;IACnD,kDAAkD;IAClD,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,UAAU,EAAE,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnF,CAcA"}

package/dist/hooks/use-approvals.js

@@ -0,0 +1,14 @@
+import { useCallback } from "react";
+import { useVendoContext } from "../context.js";
+import { useResource } from "./use-resource.js";
+export function useApprovals(options) {
+    const { client } = useVendoContext();
+    const list = useCallback(() => client.approvals.pending(), [client]);
+    const { data, error, isLoading, refresh } = useResource(list, [], options);
+    const decide = useCallback(async (ids, decision) => {
+        await client.approvals.decide(ids, decision);
+        await refresh();
+    }, [client, refresh]);
+    return { pending: data, data, error, isLoading, refresh, decide };
+}
+//# sourceMappingURL=use-approvals.js.map