@teaflask/assistant 0.3.0 → 0.6.0

package/dist/components/scroll-follow-guards.js

@@ -1,17 +1,6 @@
 "use client";
 import { useEffect } from "react";
 import { useStickToBottomContext, } from "use-stick-to-bottom";
-// Repairs to use-stick-to-bottom's follow contract, all through its
-// public context — no fork, no patched internals. The library observes
-// only its CONTENT element and trusts its own scroll handler for
-// escapes AND re-engages; the three holes that leaves, and each
-// guard's reasoning, are docs/scroll-follow-guards.md. stopScroll() is
-// the library's complete escape primitive: it sets escapedFromLock and
-// clears isAtBottom, which aborts any in-flight follow.
-// Accumulated upward travel that counts as the visitor taking over
-// (guard 3): above the per-frame jitter a horizontal trackpad pan chains
-// into the transcript (reset every mid-stream growth frame), below the
-// smallest deliberate gesture (an arrow key is ~40px, PageUp a viewport).
 const TAKEOVER_TRAVEL_PX = 16;
 export function ScrollFollowGuards() {
     const { scrollRef, state, stopScroll, scrollToBottom } = useStickToBottomContext();
@@ -30,30 +19,10 @@ export function ScrollFollowGuards() {
                 teardown();
             }
         };
-        // Every dependency is identity-stable in the library (state is a
-        // mount-scoped memo; the callbacks close over stable refs), so this
-        // installs once per mounted scroller.
     }, [scrollRef, scrollToBottom, state, stopScroll]);
     return null;
 }
-// Guard 1 — viewport shrink re-follow, keyed to the SCROLL element's
-// height so content settles never trip it. state.isAtBottom is the
-// ONLY flag consulted (escapedFromLock sits stale-true on the escape
-// → jump → follow path). The landing write is synchronous — after two
-// rAFs the transcript is at its bottom — and goes through the
-// library's state.scrollTop setter, never the raw property (it forces
-// scroll-behavior:auto and records the echo in ignoreScrollToTop);
-// the trailing scrollToBottom keeps the library's bookkeeping coherent.
 function _installShrinkRefollow(scrollElement, state, scrollToBottom) {
-    // The follow-liveness proof. PREMISE: guard 1 may re-land a reader
-    // only on a page whose clock advances across frames — under a pinned
-    // clock the library's wait:true follows never complete and
-    // state.isAtBottom sits stale-true at the top of history. The probe
-    // reads Date.now() across frames and nothing else (never a follow's
-    // settlement, never a write). A shrink seen before the proof is
-    // remembered, not dropped: both paths that reach it are in
-    // docs/scroll-follow-guards.md; the latch counts are in the
-    // scroll-follow guard latch measurement record.
     const clockStart = Date.now();
     let clockProven = false;
     let shrinkPendingProof = false;
@@ -68,8 +37,6 @@ function _installShrinkRefollow(scrollElement, state, scrollToBottom) {
     let proofFrame = requestAnimationFrame(function proveClock() {
         if (Date.now() > clockStart) {
             clockProven = true;
-            // The reader must still be followed at flush time — an escape
-            // between the remembered shrink and the proof wins.
             if (shrinkPendingProof && state.isAtBottom) {
                 shrinkPendingProof = false;
                 landAtBottom();
@@ -87,9 +54,6 @@ function _installShrinkRefollow(scrollElement, state, scrollToBottom) {
         if (!viewportShrank || !state.isAtBottom) {
             return;
         }
-        // The proof's verdict: until the clock is proven, isAtBottom is
-        // not honest and no re-land is safe — a shrink that beats the
-        // first proving frame is remembered, never dropped.
         if (!clockProven) {
             shrinkPendingProof = true;
             return;
@@ -102,17 +66,8 @@ function _installShrinkRefollow(scrollElement, state, scrollToBottom) {
         observer.disconnect();
     };
 }
-// Guard 2 — the wheel escape, minus the library's dead zone (it bails
-// unless the first overflow:auto ancestor IS the scroller). We escape
-// unless something between the pointer and the scroller will consume
-// the upward wheel — an inner scroller that can still scroll up; one
-// at its own top chains the wheel to the transcript, so it escapes.
 function _installWheelEscape(scrollElement, state, stopScroll) {
     const handleWheel = (event) => {
-        // Vertical dominance, not just a negative deltaY: a trackpad's
-        // horizontal pan carries small negative deltaY jitter beside a large
-        // deltaX, and panning a long code line mid-stream must not release
-        // the lock. |deltaY| > |deltaX| is the browser's own axis call.
         const wheelingUp = event.deltaY < 0 && Math.abs(event.deltaY) > Math.abs(event.deltaX);
         const transcriptOverflows = scrollElement.scrollHeight > scrollElement.clientHeight;
         if (wheelingUp &&
@@ -132,29 +87,6 @@ function _installWheelEscape(scrollElement, state, stopScroll) {
         });
     };
 }
-// Guards 3 and 4 — the non-wheel escape and its mirror, which the
-// library cannot deliver from inside its resizeDifference gate.
-// Capture on an ANCESTOR is load-bearing: scroll events capture-
-// descend, and the library's at-target listener synchronously clears
-// ignoreScrollToTop — running before it is the only way to tell its
-// writes from the visitor's. The ancestor is the scroller's root node,
-// not window: scroll is neither bubbling nor composed, so in the
-// embeds' open shadow root a window listener would never fire.
-//
-// Escape (guard 3): accumulated upward travel that is not a library
-// write, not the browser clamping under a content shrink, and not
-// overscroll settle at the bottom. The ACCUMULATOR (not a per-event
-// threshold) is what lets chained pan jitter never accrue — the
-// follow resets it every growth frame — while a slow drag still
-// crosses TAKEOVER_TRAVEL_PX within a move or two.
-//
-// Re-engage (guard 4): a downward move that CLOSES the gap and LANDS
-// at the bottom while unfollowed. The landing gate (bottomGap <= 1)
-// is load-bearing: our scrollToBottom repositions, and doing so
-// anywhere inside the near-bottom band would fight a scrollbar or
-// touch drag (snap down, pointer pulls up, guard 3 escapes, repeat);
-// at bottomGap <= 1 it is a pure re-arm. "Closes the gap" rules out
-// scroll anchoring, which bumps scrollTop while holding the gap.
 function _installTravelGuards(scrollElement, state, stopScroll, scrollToBottom) {
     let lastScrollTop = scrollElement.scrollTop;
     let lastScrollHeight = scrollElement.scrollHeight;
@@ -210,12 +142,6 @@ function _installTravelGuards(scrollElement, state, stopScroll, scrollToBottom)
         });
     };
 }
-// True when an element between the wheel's target and the scroller
-// (inclusive of the target) would consume an upward wheel itself: it can
-// still scroll up AND its overflow-y actually scrolls. Mirrors native
-// scroll chaining — the browser only hands the wheel to the transcript
-// once every inner scroller is at its top. The geometry reads come first
-// so getComputedStyle stays off the hot path.
 function wheelConsumedBelow(target, scrollElement) {
     let element = target instanceof Element ? target : null;
     while (element !== null && element !== scrollElement) {
@@ -228,4 +154,3 @@ function wheelConsumedBelow(target, scrollElement) {
     }
     return false;
 }
-//# sourceMappingURL=scroll-follow-guards.js.map

package/dist/components/served-suggestions.d.ts

@@ -1,10 +1,3 @@
 import type { ServedSuggestionsConfig } from "../contract/assistant-config.js";
 import type { AssistantSuggestion } from "./conversation-view.js";
-/**
- * The longest-prefix route's set, or the default set when no route
- * covers the path. A matched route's EMPTY set is honored — it authors
- * "no suggestions on this route" — which is why this never falls back
- * from a match.
- */
 export declare function servedSuggestionsForPath(config: ServedSuggestionsConfig, pathname: string): readonly AssistantSuggestion[];
-//# sourceMappingURL=served-suggestions.d.ts.map

package/dist/components/served-suggestions.js

@@ -1,14 +1,3 @@
-// Picking the served suggestion set for the page the visitor is on.
-// Lives beside the drawer body so it rides the drawer's lazy chunk —
-// the eager element shell never pays for it. Matching is computed per
-// render from the pathname the caller reads; the package deliberately
-// holds no route subscription.
-/**
- * The longest-prefix route's set, or the default set when no route
- * covers the path. A matched route's EMPTY set is honored — it authors
- * "no suggestions on this route" — which is why this never falls back
- * from a match.
- */
 export function servedSuggestionsForPath(config, pathname) {
     const route = _longestCoveringRoute(config.routes ?? [], pathname);
     const items = route === null ? (config.default ?? []) : (route.suggestions ?? []);
@@ -22,8 +11,6 @@ function _longestCoveringRoute(routes, pathname) {
         if (!_aFenceCovers(fence, pathname)) {
             continue;
         }
-        // Strictly longer wins; a duplicate-length tie keeps the first
-        // (duplicates are unstorable anyway — the write gate rejects them).
         if (fence.length > coveringLength) {
             covering = route;
             coveringLength = fence.length;
@@ -31,9 +18,6 @@ function _longestCoveringRoute(routes, pathname) {
     }
     return covering;
 }
-// The navigate fence's grammar (mirrors _a_prefix_covers in the backend):
-// segment-aware — "/docs" covers "/docs/x", never "/docsy"; a trailing
-// slash on the prefix is cosmetic; an all-slash prefix covers everything.
 function _fenceOf(prefix) {
     return prefix.replace(/\/+$/, "");
 }
@@ -43,4 +27,3 @@ function _aFenceCovers(fence, pathname) {
     }
     return pathname === fence || pathname.startsWith(fence + "/");
 }
-//# sourceMappingURL=served-suggestions.js.map

package/dist/components/slot-boundary.d.ts

@@ -1,28 +1,11 @@
 import { type ReactNode } from "react";
 export declare function HostSlotBoundary({ slot, fallback, children, }: {
-    /** Which slot this isolates — names the failure in the console line. */
     slot: string;
     fallback: ReactNode;
     children: ReactNode;
 }): import("react").JSX.Element;
-/** The fill decision, made INSIDE the boundary: the render callback runs
- *  here so a synchronous throw is caught, and a null/undefined return
- *  falls through to the same package default the boundary would fall back
- *  to — one default, two routes to it.
- *
- *  THE KEYING LAW: frame behavior attached to a slot must key on the fill
- *  having ACTUALLY RENDERED, never on the prop having been supplied —
- *  both fallback routes land on the package default, which carries its
- *  own signals, and a prop-keyed extra would double them. The per-slot
- *  enumeration is in docs/transcript-surfaces.md, "The keying law". The
- *  toolRow annex (filledAnnex, the status word) weakens no isolation law:
- *  fill rendered → the annex, package-rendered and unreachable by the
- *  fill; null return or throw → the package ToolRow's own state pill. */
 export declare function SlotOrDefault({ render, fallback, filledAnnex, }: {
     render: () => ReactNode;
     fallback: ReactNode;
-    /** Package-owned content rendered beside the fill exactly when the
-     *  fill rendered — never beside the fallback. */
     filledAnnex?: ReactNode;
 }): import("react").JSX.Element;
-//# sourceMappingURL=slot-boundary.d.ts.map

package/dist/components/slot-boundary.js

@@ -3,17 +3,7 @@ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-run
 import { Component } from "react";
 import { hostFillDeclines } from "../core/host-fill.js";
 import { useOptionalAssistantSession } from "./teaflask-assistant-provider.js";
-// The host-slot isolation wrapper: every host-supplied slot on
-// AssistantTranscript EXCEPT `input` mounts inside one of these (the
-// input-region rule — that slot is deliberately unbounded), so a throwing
-// fill costs its own slot and nothing else. Two laws by construction: the
-// FALLBACK is the package's own rendering, rendered by this boundary and
-// never as a sibling inside the children (mandatory frame elements render
-// OUTSIDE it at the call site), so a broken fill cannot take the default
-// with it; and a slot that threw is latched for that mount — a new row's key gets a fresh boundary.
 export function HostSlotBoundary({ slot, fallback, children, }) {
-    // Tolerant on purpose: agent-mode hosts (the run viewer, the playground)
-    // mount with no session provider; the console line is the report there.
     const session = useOptionalAssistantSession();
     return (_jsx(_SlotCatch, { slot: slot, fallback: fallback, reportError: session?.reportError, children: children }));
 }
@@ -24,8 +14,6 @@ class _SlotCatch extends Component {
     }
     componentDidCatch(error) {
         const shaped = error instanceof Error ? error : new Error(String(error));
-        // The host's observer hears it, and the console names the slot for
-        // whoever is actually debugging the page.
         this.props.reportError?.(shaped);
         console.error(`[teaflask-assistant] The host "${this.props.slot}" slot threw; the package rendering took over.`, shaped);
     }
@@ -36,27 +24,10 @@ class _SlotCatch extends Component {
         return _jsx(_Fragment, { children: this.props.children });
     }
 }
-/** The fill decision, made INSIDE the boundary: the render callback runs
- *  here so a synchronous throw is caught, and a null/undefined return
- *  falls through to the same package default the boundary would fall back
- *  to — one default, two routes to it.
- *
- *  THE KEYING LAW: frame behavior attached to a slot must key on the fill
- *  having ACTUALLY RENDERED, never on the prop having been supplied —
- *  both fallback routes land on the package default, which carries its
- *  own signals, and a prop-keyed extra would double them. The per-slot
- *  enumeration is in docs/transcript-surfaces.md, "The keying law". The
- *  toolRow annex (filledAnnex, the status word) weakens no isolation law:
- *  fill rendered → the annex, package-rendered and unreachable by the
- *  fill; null return or throw → the package ToolRow's own state pill. */
 export function SlotOrDefault({ render, fallback, filledAnnex, }) {
     const filled = render();
-    // THE FALL-THROUGH RULE (core/host-fill.ts): null, undefined and both
-    // booleans decline; renderable emptiness is the host's deliberate
-    // choice of empty content and counts as filled.
     if (hostFillDeclines(filled)) {
         return _jsx(_Fragment, { children: fallback });
     }
     return (_jsxs(_Fragment, { children: [filled, filledAnnex] }));
 }
-//# sourceMappingURL=slot-boundary.js.map

package/dist/components/standing-poll.d.ts

@@ -0,0 +1 @@
+export declare function pollStanding(refresh: () => void, onExhausted?: () => void): () => void;

package/dist/components/standing-poll.js

@@ -0,0 +1,25 @@
+const STANDING_POLL_MS = 4000;
+const MAX_STANDING_POLL_ATTEMPTS = 5;
+export function pollStanding(refresh, onExhausted) {
+    let attempts = 0;
+    let timer;
+    const arm = () => {
+        timer = window.setTimeout(() => {
+            if (attempts === MAX_STANDING_POLL_ATTEMPTS) {
+                onExhausted?.();
+                return;
+            }
+            attempts += 1;
+            refresh();
+            if (attempts < MAX_STANDING_POLL_ATTEMPTS || onExhausted) {
+                arm();
+            }
+        }, STANDING_POLL_MS);
+    };
+    arm();
+    return () => {
+        if (timer !== undefined) {
+            window.clearTimeout(timer);
+        }
+    };
+}

package/dist/components/streaming-states.d.ts

@@ -5,12 +5,8 @@ export declare function ShimmerText({ children, className, }: {
     className?: string;
 }): import("react").JSX.Element;
 export declare function Spinner({ label, }: {
-    /** The state the motion stands for — always rendered as visible text,
-     *  so the spinner never spins wordlessly and reduced motion loses
-     *  nothing. */
     label: string;
 }): import("react").JSX.Element;
 export declare function StreamingLine({ children }: {
     children: string;
 }): import("react").JSX.Element;
-//# sourceMappingURL=streaming-states.d.ts.map

package/dist/components/streaming-states.js

@@ -1,33 +1,6 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { cx } from "./primitives/cx.js";
-// The adopted register — bake-off 2026-07-30 (assistant-ui): a single pulsing dot where the next
-// message will land — the ChatGPT idiom assistant-ui ships as its
-// working indicator — and muted status text rendered as a moving gradient
-// (the active-reasoning treatment; its animation lives in styles.css under
-// [data-tf-shimmer-highlight]).
-//
-// THE MOTION PRIMITIVES (contract law 11). This module owns the
-// migration's two motion primitives, and they are the only two:
-//
-//   - ShimmerText — THE active-text shimmer. Every surface whose words
-//     move while work is live (fold headlines, process-row labels,
-//     subagent presence) renders through it; nothing forks its markup
-//     or keyframes (TVC-013 pins the fold, TVC-100 its reduced-motion
-//     collapse).
-//   - Spinner — THE indeterminate spinner, under [data-tf-spinner]. Its
-//     label is REQUIRED and always visible: the hook is never valueless,
-//     so reduced motion always leaves state text behind (TVC-101).
-//     Today's only surface is the decision cards' submitting beat
-//     ("Sending…"); run-state liveness everywhere else is ShimmerText.
-//
-// Both collapse under BOTH switches — the OS prefers-reduced-motion query
-// and the host kill switch (data-reduce-motion="true" on any ancestor; the
-// script-tag element reflects it across its shadow boundary) — and both
-// are proven inside the custom element's constructed-stylesheet shadow
-// root under a strict CSP (TVC-102). A lane needing motion beyond these
-// must mint its own reduced-motion law; three shimmer implementations is a
-// failure of contract law 11.
 export function TypingIndicator() {
     return (_jsx("span", { "data-tf-working-dot": "", className: "tf:animate-tf-pulse tf:text-tf-body tf:text-tf-foreground tf:motion-reduce:animate-none", role: "status", "aria-label": "The assistant is working", children: "●" }));
 }
@@ -40,4 +13,3 @@ export function Spinner({ label, }) {
 export function StreamingLine({ children }) {
     return (_jsx(ShimmerText, { className: "tf:text-tf-label tf:text-tf-muted-foreground", children: children }));
 }
-//# sourceMappingURL=streaming-states.js.map

package/dist/components/subagent-count-pill.d.ts

@@ -4,7 +4,5 @@ import { type SubagentRosterEntry } from "../core/subagent-roster.js";
 export declare function SubagentCountPill({ dispatches, threadId, renderPreview, }: {
     dispatches: ReadonlyMap<number, ThreadDispatch>;
     threadId?: string;
-    /** Deterministic preview seam for the package screenshot fixture. */
     renderPreview?: (entry: SubagentRosterEntry) => ReactNode;
 }): import("react").JSX.Element | null;
-//# sourceMappingURL=subagent-count-pill.d.ts.map

package/dist/components/subagent-count-pill.js

@@ -1,17 +1,5 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-// The conversation's subagent-count pill: a quiet outline pill on the
-// composer's column whenever the thread's dispatch ledger has any rows,
-// opening a floating roster on hover, focus, or tap. The roster is a
-// read of the ledger the transcript already polls — opening it fetches
-// nothing and never opens a child stream. Hovering, focusing, or tapping
-// a roster row opens that child's compact transcript preview beside the
-// roster; the conversation itself stays in place.
-//
-// The card is the pill wrapper's LAST child: the package ships no
-// z-index, so among positioned boxes document order is the paint order
-// (the companion-header-disclosure law), and a card mounted after the
-// pill paints over the transcript's own positioned bubbles.
 import { activityTitleOf } from "../core/activity-title.js";
 import { ChevronRightIcon } from "lucide-react";
 import { useRef } from "react";
@@ -35,36 +23,16 @@ export function SubagentCountPill({ dispatches, threadId, renderPreview, }) {
     const roster = subagentRosterOf(rosterEntriesOf(dispatches.values(), _ROSTER_PREDICATES));
     const label = subagentPillLabelOf(roster);
     if (label === null) {
-        // No subagents, no pill — the control exists only once the
-        // conversation has delegated.
         return null;
     }
-    // The deterministic color variants (law 10): a pure read of the same
-    // ledger the roster is, so the same coworker wears the same color
-    // here, on the inline group row, and in the child preview.
     const variantIndices = coworkerIndicesOf(dispatches.values());
-    return (
-    // The pill is the interactive boundary inside the composer's
-    // pointer-pass-through overlay. It paints as one compact floating
-    // object; there is no in-flow activity row behind it.
-    _jsxs("div", { ref: wrapperRef, "data-tf-subagent-pill": "", "data-tf-shelf-item": "", className: "tf:pointer-events-auto tf:relative tf:w-fit", onPointerEnter: onWrapperPointerEnter, onPointerLeave: onWrapperPointerLeave, onBlur: onWrapperBlur, children: [_jsxs(TfButton, { ref: triggerRef, "data-tf-glass": "", variant: "outline", className: "tf:min-h-11 tf:px-3 tf:md:px-2.5", "aria-label": `Subagents: ${label}`, "aria-expanded": open, "aria-controls": open ? rosterId : undefined, onPointerDown: onTriggerPointerDown, onPointerCancel: onTriggerPointerCancel, onFocus: onTriggerFocus, onClick: onTriggerClick, onKeyDown: onTriggerKeyDown, children: [_jsx(AgentIdentityMark, { register: "subagent", size: "md", className: "tf:text-tf-muted-foreground" }), roster.failed.length > 0 ? (_jsx("span", { "aria-hidden": true, className: "tf:size-1.5 tf:shrink-0 tf:rounded-full tf:bg-tf-destructive" })) : null, roster.running.length > 0 ? (
-                    // The muted live-work ink on purpose: every moving label wears
-                    // it, and the button's foreground base would leave the
-                    // highlight band no headroom in dark.
-                    _jsx(ShimmerText, { className: "tf:text-tf-muted-foreground", children: label })) : (label)] }), open ? (_jsx(SubagentRosterCard, { id: rosterId, roster: roster, variantIndices: variantIndices, threadId: threadId, renderPreview: renderPreview, triggerRef: triggerRef, onClose: close, refocusTrigger: refocusTrigger })) : null] }));
+    return (_jsxs("div", { ref: wrapperRef, "data-tf-subagent-pill": "", "data-tf-shelf-item": "", className: "tf:pointer-events-auto tf:relative tf:w-fit", onPointerEnter: onWrapperPointerEnter, onPointerLeave: onWrapperPointerLeave, onBlur: onWrapperBlur, children: [_jsxs(TfButton, { ref: triggerRef, "data-tf-glass": "", variant: "outline", className: "tf:min-h-11 tf:px-3 tf:md:px-2.5", "aria-label": `Subagents: ${label}`, "aria-expanded": open, "aria-controls": open ? rosterId : undefined, onPointerDown: onTriggerPointerDown, onPointerCancel: onTriggerPointerCancel, onFocus: onTriggerFocus, onClick: onTriggerClick, onKeyDown: onTriggerKeyDown, children: [_jsx(AgentIdentityMark, { register: "subagent", size: "md", className: "tf:text-tf-muted-foreground" }), roster.failed.length > 0 ? (_jsx("span", { "aria-hidden": true, className: "tf:size-1.5 tf:shrink-0 tf:rounded-full tf:bg-tf-destructive" })) : null, roster.running.length > 0 ? (_jsx(ShimmerText, { className: "tf:text-tf-muted-foreground", children: label })) : (label)] }), open ? (_jsx(SubagentRosterCard, { id: rosterId, roster: roster, variantIndices: variantIndices, threadId: threadId, renderPreview: renderPreview, triggerRef: triggerRef, onClose: close, refocusTrigger: refocusTrigger })) : null] }));
 }
-/** The floating roster: grouped by outcome, capped and scrolled. Mounted
- *  only while open — unmounting is the close, no state survives. Its
- *  rows open the adjacent transcript preview when a thread id is known;
- *  the card itself stays focusable so a click on its passive ink keeps
- *  focus within the pair instead of dropping it to body. */
 function SubagentRosterCard({ id, roster, variantIndices, threadId, renderPreview, triggerRef, onClose, refocusTrigger, }) {
     const cardRef = useRef(null);
     const floatingRef = useRef(null);
     const { previewKey, setPreviewKey, previewRef, previewOpenerRef, mutePreviewFocusOpenRef, onPreviewChange, onPreviewOpener, onPreviewFocus, focusPreview, } = usePreviewChoreography();
     useFloatingDismiss(floatingRef, triggerRef, onClose);
-    // Group headers earn their ink only when there is more than one bucket
-    // to tell apart — a single-bucket roster is just its rows.
     const buckets = [
         { title: "Running", entries: roster.running },
         { title: "Completed", entries: roster.completed },
@@ -86,25 +54,12 @@ function SubagentRosterCard({ id, roster, variantIndices, threadId, renderPrevie
         onClose,
         refocusTrigger,
     });
-    return (
-    // The pb-2 lives on the positioner, not a margin on the card, so the
-    // pointer's travel from pill to card never leaves the hover surface.
-    _jsxs("div", { ref: floatingRef, "data-tf-subagent-disclosure": "", className: "tf:absolute tf:bottom-full tf:start-1/2 tf:-translate-x-1/2 tf:pb-2", children: [_jsx("div", { ref: cardRef, id: id, role: "dialog", "aria-label": "Subagents", 
-                // Focusable on purpose (the dashboard twin gets this from Radix's
-                // FocusScope): a click or tap on passive card ink moves focus HERE
-                // instead of dropping it to body, so the wrapper's blur guard sees
-                // focus staying inside the pair and the roster survives being read.
-                tabIndex: -1, "data-tf-glass": "", className: "tf:flex tf:w-72 tf:flex-col tf:overflow-hidden tf:rounded-2xl tf:border tf:focus-visible:outline-2 tf:focus-visible:outline-offset-2 tf:focus-visible:outline-tf-ring", children: _jsx(RosterBucketList, { buckets: buckets, withHeaders: withHeaders, variantIndices: variantIndices, previewable: threadId !== undefined || renderPreview !== undefined, previewKey: previewKey, previewId: `${id}-preview`, onPreviewChange: onPreviewChange, onPreviewOpener: onPreviewOpener, onPreviewFocus: onPreviewFocus, focusPreview: focusPreview }) }), previewEntry !== null &&
+    return (_jsxs("div", { ref: floatingRef, "data-tf-subagent-disclosure": "", className: "tf:absolute tf:bottom-full tf:start-1/2 tf:-translate-x-1/2 tf:pb-2", children: [_jsx("div", { ref: cardRef, id: id, role: "dialog", "aria-label": "Subagents", tabIndex: -1, "data-tf-glass": "", className: "tf:flex tf:w-72 tf:flex-col tf:overflow-hidden tf:rounded-2xl tf:border tf:focus-visible:outline-2 tf:focus-visible:outline-offset-2 tf:focus-visible:outline-tf-ring", children: _jsx(RosterBucketList, { buckets: buckets, withHeaders: withHeaders, variantIndices: variantIndices, previewable: threadId !== undefined || renderPreview !== undefined, previewKey: previewKey, previewId: `${id}-preview`, onPreviewChange: onPreviewChange, onPreviewOpener: onPreviewOpener, onPreviewFocus: onPreviewFocus, focusPreview: focusPreview }) }), previewEntry !== null &&
                 (threadId !== undefined || renderPreview !== undefined) ? (_jsx(RosterPreview, { entry: previewEntry, id: id, anchorRef: cardRef, previewRef: previewRef, threadId: threadId, renderPreview: renderPreview, variantIndices: variantIndices }, previewEntry.key)) : null] }));
 }
-/** The adjacent transcript preview for the row under the pointer or
- *  focus — the host's deterministic renderer when it supplies one, the
- *  child's own transcript otherwise. */
 function RosterPreview({ entry, id, anchorRef, previewRef, threadId, renderPreview, variantIndices, }) {
     return (_jsx(SubagentPreviewPopover, { id: `${id}-preview`, anchorRef: anchorRef, previewRef: previewRef, label: entry.label, children: renderPreview !== undefined ? (renderPreview(entry)) : threadId !== undefined ? (_jsx(ChildTranscriptPreview, { threadId: threadId, childSessionId: entry.childSessionId, variantIndex: variantIndices.get(entry.childSessionId) }, entry.key)) : null }, entry.key));
 }
-/** The card's scrolled list: one bucket per outcome, headed only when
- *  there is more than one, each row a roster line. */
 function RosterBucketList({ buckets, withHeaders, variantIndices, previewable, previewKey, previewId, onPreviewChange, onPreviewOpener, onPreviewFocus, focusPreview, }) {
     return (_jsx("ul", { className: "tf:m-0 tf:flex tf:max-h-64 tf:list-none tf:flex-col tf:overflow-y-auto tf:p-2 tf:ps-2", children: buckets.map((bucket) => (_jsxs("li", { className: "tf:flex tf:flex-col", children: [withHeaders ? (_jsx("p", { className: "tf:m-0 tf:px-2 tf:pt-1.5 tf:pb-0.5 tf:text-xs tf:font-medium tf:text-tf-muted-foreground", children: bucket.title })) : null, _jsx("ul", { className: "tf:m-0 tf:flex tf:list-none tf:flex-col tf:ps-0", children: bucket.entries.map((entry) => (_jsx(SubagentRosterLine, { entry: entry, variantIndex: variantIndices.get(entry.childSessionId), previewable: previewable, previewOpen: previewKey === entry.key, onPreviewChange: (nextOpen) => {
                             onPreviewChange(entry.key, nextOpen);
@@ -113,14 +68,6 @@ function RosterBucketList({ buckets, withHeaders, variantIndices, previewable, p
                         }, focusPreview: focusPreview, previewId: previewId }, entry.key))) })] }, bucket.title))) }));
 }
 function SubagentRosterLine({ entry, variantIndex, previewable, previewOpen, onPreviewChange, onPreviewOpener, onPreviewFocus, focusPreview, previewId, }) {
-    // Pure server math (the roster law): a settled row reads its recorded
-    // span in the COMPACT register ("3m 04s", "<1s" — settledDurationLabelOf,
-    // on the house ladder, TVC-073) because the visible status word beside it
-    // already owns the verb; "Finished · Worked for 3m 04s" would say it
-    // twice. The sentence register ("Worked for …") belongs to the standalone
-    // metadata lines (fold headlines, the inline group row). A running row
-    // shows no clock — live ticking is the dashboard's ElapsedTime concern,
-    // never this surface's. Null disappears cleanly.
     const workedLabel = settledDurationLabelOf(entry.startedAt, entry.settledAt);
     const statusWord = entry.running
         ? "Working"
@@ -129,7 +76,6 @@ function SubagentRosterLine({ entry, variantIndex, previewable, previewOpen, onP
             : "Finished";
     const line = (_jsx(RosterLineBody, { entry: entry, variantIndex: variantIndex, previewable: previewable, previewOpen: previewOpen, workedLabel: workedLabel, statusWord: statusWord }));
     if (!previewable) {
-        // No thread id on this host: the row stays passive ink.
         return (_jsx("li", { className: "tf:flex tf:flex-col tf:gap-0.5 tf:text-tf-label tf:text-tf-foreground", children: _jsx("span", { className: "tf:flex tf:items-center tf:px-2 tf:py-1.5", children: line }) }));
     }
     return (_jsx("li", { className: "tf:flex tf:flex-col tf:gap-0.5 tf:text-tf-label tf:text-tf-foreground", children: _jsx(TfButton, { variant: "bare", "aria-haspopup": "dialog", "aria-expanded": previewOpen, "aria-controls": previewOpen ? previewId : undefined, "aria-label": [
@@ -159,20 +105,8 @@ function SubagentRosterLine({ entry, variantIndex, previewable, previewOpen, onP
                 focusPreview();
             }, children: line }) }));
 }
-/** One roster row's ink: the identity mark with its failure badge beside
- *  the label column — label and chevron, the status word with the settled
- *  span, and a failed row's reason. */
 function RosterLineBody({ entry, variantIndex, previewable, previewOpen, workedLabel, statusWord, }) {
-    return (
-    // items-start, not items-center: the row grew from one line to two or
-    // three, and centering the fixed-size identity mark and chevron
-    // against the whole STACK slid them off the label they belong to — the
-    // same cross-axis shape the inline row solved. The mark and the
-    // min-h-6 label row are equal-height boxes at the stack's top, so
-    // their centers coincide exactly; the chevron rides INSIDE the label
-    // row for the same reason.
-    _jsxs("span", { className: "tf:flex tf:w-full tf:items-start tf:gap-2", children: [_jsxs("span", { "data-tf-subagent-identity": subagentIdentityTokenOf(entry.childSessionId), className: "tf:relative tf:flex tf:h-6 tf:min-w-6 tf:shrink-0 tf:items-center tf:justify-center tf:px-1", children: [_jsx(AgentIdentityMark, { register: "subagent", variantIndex: variantIndex }), entry.failed ? (_jsx("span", { "aria-hidden": true, className: "tf:absolute tf:-end-0.5 tf:-bottom-0.5 tf:size-2 tf:rounded-full tf:border tf:border-tf-background tf:bg-tf-destructive" })) : null] }), _jsxs("span", { className: "tf:flex tf:min-w-0 tf:flex-1 tf:flex-col tf:items-start tf:gap-0.5", children: [_jsxs("span", { className: "tf:flex tf:min-h-6 tf:w-full tf:min-w-0 tf:items-center tf:gap-2", children: [_jsx("span", { "data-tf-subagent-label": "", className: "tf:min-w-0 tf:flex-1 tf:truncate tf:text-start", title: entry.label, children: activityTitleOf(entry.label) }), previewable ? (_jsx(ChevronRightIcon, { "aria-hidden": true, className: previewOpen
+    return (_jsxs("span", { className: "tf:flex tf:w-full tf:items-start tf:gap-2", children: [_jsxs("span", { "data-tf-subagent-identity": subagentIdentityTokenOf(entry.childSessionId), className: "tf:relative tf:flex tf:h-6 tf:min-w-6 tf:shrink-0 tf:items-center tf:justify-center tf:px-1", children: [_jsx(AgentIdentityMark, { register: "subagent", variantIndex: variantIndex }), entry.failed ? (_jsx("span", { "aria-hidden": true, className: "tf:absolute tf:-end-0.5 tf:-bottom-0.5 tf:size-2 tf:rounded-full tf:border tf:border-tf-background tf:bg-tf-destructive" })) : null] }), _jsxs("span", { className: "tf:flex tf:min-w-0 tf:flex-1 tf:flex-col tf:items-start tf:gap-0.5", children: [_jsxs("span", { className: "tf:flex tf:min-h-6 tf:w-full tf:min-w-0 tf:items-center tf:gap-2", children: [_jsx("span", { "data-tf-subagent-label": "", className: "tf:min-w-0 tf:flex-1 tf:truncate tf:text-start", title: entry.label, children: activityTitleOf(entry.label) }), previewable ? (_jsx(ChevronRightIcon, { "aria-hidden": true, className: previewOpen
                                     ? "tf:size-4 tf:shrink-0 tf:text-tf-muted-foreground tf:opacity-100 tf:transition-opacity"
                                     : "tf:size-4 tf:shrink-0 tf:text-tf-muted-foreground tf:opacity-0 tf:transition-opacity tf:group-hover/subagent:opacity-100 tf:group-focus-visible/subagent:opacity-100 tf:pointer-coarse:opacity-100" })) : null] }), _jsxs("span", { className: "tf:flex tf:w-full tf:min-w-0 tf:items-baseline tf:gap-1.5 tf:text-xs tf:text-tf-muted-foreground", children: [_jsx("span", { "data-tf-subagent-status": "", className: entry.failed ? "tf:text-tf-destructive" : undefined, children: entry.running ? (_jsx(ShimmerText, { children: statusWord })) : (statusWord) }), workedLabel !== null ? (_jsx("span", { "data-tf-subagent-worked": "", className: "tf:truncate", children: `· ${workedLabel}` })) : null] }), entry.failed && entry.note !== null ? (_jsx("span", { "data-tf-subagent-note": "", className: "tf:w-full tf:min-w-0 tf:truncate tf:text-start tf:text-xs tf:text-tf-muted-foreground", title: entry.note, children: entry.note })) : null] })] }));
 }
-//# sourceMappingURL=subagent-count-pill.js.map

package/dist/components/subagent-current-work.d.ts

@@ -1,14 +1,6 @@
 import type { ToolCallViewModel } from "../core/tool-call-display.js";
-/** childSessionId → the newest LIVE tool-call view the open drill-in
- *  stream has seen (core/subagent-presence.ts's newestToolCallViewOf).
- *  The empty default keeps bare-rendered rows honestly quiet. */
 export declare const SubagentCurrentWorkContext: import("react").Context<ReadonlyMap<string, ToolCallViewModel>>;
 export type SubagentCurrentWorkPublisher = (childSessionId: string, view: ToolCallViewModel | null) => void;
-/** The write side: the child transcript publishes while its stream is
- *  live and clears on settle/unmount. The no-op default keeps a child
- *  transcript mounted outside the delegation surface (tests, bare hosts)
- *  side-effect free. */
 export declare const SubagentCurrentWorkPublisherContext: import("react").Context<SubagentCurrentWorkPublisher>;
 export declare function useSubagentCurrentWork(): ReadonlyMap<string, ToolCallViewModel>;
 export declare function useSubagentCurrentWorkPublisher(): SubagentCurrentWorkPublisher;
-//# sourceMappingURL=subagent-current-work.d.ts.map

package/dist/components/subagent-current-work.js

@@ -1,28 +1,8 @@
 "use client";
-// The inline current-work seam (TVC-072): how a running child's newest
-// live operation reaches the delegation group row. The ONLY honest
-// writer is an open child drill-in stream — the dispatches poll carries
-// no per-operation evidence, and populating this from anywhere else
-// would mean opening child streams the roster is forbidden to open
-// (replay-metadata-contract.md: current operation is drill-in-only). A
-// child nobody is watching simply has no entry, and the row's
-// current-work line disappears cleanly.
-//
-// Two contexts, not one: the read side (the map) changes on every
-// published operation, while the write side (the publisher) must stay
-// referentially stable so the child transcript's publish effect never
-// re-runs because a sibling updated the map.
 import { createContext, useContext } from "react";
 const EMPTY_CURRENT_WORK = new Map();
-/** childSessionId → the newest LIVE tool-call view the open drill-in
- *  stream has seen (core/subagent-presence.ts's newestToolCallViewOf).
- *  The empty default keeps bare-rendered rows honestly quiet. */
 export const SubagentCurrentWorkContext = createContext(EMPTY_CURRENT_WORK);
 const NOOP_PUBLISHER = () => undefined;
-/** The write side: the child transcript publishes while its stream is
- *  live and clears on settle/unmount. The no-op default keeps a child
- *  transcript mounted outside the delegation surface (tests, bare hosts)
- *  side-effect free. */
 export const SubagentCurrentWorkPublisherContext = createContext(NOOP_PUBLISHER);
 export function useSubagentCurrentWork() {
     return useContext(SubagentCurrentWorkContext);
@@ -30,4 +10,3 @@ export function useSubagentCurrentWork() {
 export function useSubagentCurrentWorkPublisher() {
     return useContext(SubagentCurrentWorkPublisherContext);
 }
-//# sourceMappingURL=subagent-current-work.js.map

package/dist/components/subagent-delegation-surface.d.ts

@@ -1,23 +1,9 @@
 import { type ReactNode } from "react";
 import type { ThreadDispatch } from "../contract/dispatches.js";
-/** Focus restoration with an HONEST guard: isConnected does
- *  NOT test visibility — a collapsed <details> group keeps its row
- *  connected but boxless, and focus() on a hidden element silently
- *  no-ops. The opener is focused only when connected AND visible;
- *  checkVisibility is feature-tested (jsdom defines none; absent ⇒
- *  visible) and its visibility/opacity options are load-bearing — the
- *  bare call defaults them OFF and a `visibility: hidden` opener reads
- *  as visible. Hidden by a group collapse, the group's summary takes
- *  the focus; hidden by the activity slot yielding to scrollback, the
- *  merged jump affordance does. */
 export declare function focusIfRestorable(opener: HTMLElement | null): void;
 export declare function SubagentDelegationSurface({ dispatches, threadId, renderPreview, children, }: {
     dispatches: ReadonlyMap<number, ThreadDispatch>;
     threadId: string | undefined;
-    /** Deterministic preview seam for the package fixture (the count
-     *  pill's own renderPreview precedent) — production leaves it unset
-     *  and gets the live ChildTranscriptPreview. */
     renderPreview?: (childSessionId: string, variantIndex?: number) => ReactNode;
     children: ReactNode;
 }): import("react").JSX.Element;
-//# sourceMappingURL=subagent-delegation-surface.d.ts.map