@teaflask/assistant 0.3.0 → 0.7.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.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.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.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.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.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: "glassChip", 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": [
@@ -141,7 +87,7 @@ function SubagentRosterLine({ entry, variantIndex, previewable, previewOpen, onP
                 entry.failed ? entry.note : null,
             ]
                 .filter((part) => part !== null)
-                .join(" — "), className: "tf:group/subagent tf:min-h-11 tf:w-full tf:justify-start tf:px-2 tf:py-1.5 tf:hover:bg-tf-accent", onPointerEnter: (event) => {
+                .join(" — "), className: "tf:group/subagent tf:min-h-11 tf:w-full tf:justify-start tf:px-2 tf:py-1.5 tf:hover:bg-tf-accent tf:hover:text-tf-accent-foreground", onPointerEnter: (event) => {
                 if (event.pointerType !== "touch") {
                     onPreviewOpener(event.currentTarget);
                     onPreviewChange(true);
@@ -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.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.js

@@ -1,36 +1,11 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-// The conversation's drill-in host: the provider that makes the inline
-// delegation rows' affordance reachable. A row's click hands over its
-// child session and its own element (the opener focus returns to — never
-// an activeElement read); this surface floats the SAME preview shell the
-// roster uses (subagent-preview-popover.tsx → ChildTranscriptPreview),
-// so the drill-in reuses the shipped child driver rather than growing a
-// second one. The popover is top-layer content: nothing here adds a
-// scroll region, covers the composer, or touches the follow machinery
-// (TVC-120/122 stay the pill's and the shelf's laws). This surface also
-// OWNS the current-work map (subagent-current-work.tsx): the open
-// preview's stream publishes its newest live call here, the group rows
-// read it — one writer, zero extra streams. The surface's failure-mode
-// ledger — every way this lifecycle can move, its outcome and its named
-// test, modes 1–15 cited below by number — is
-// docs/subagent-delegation-surface.md.
 import { useCallback, useEffect, useId, useMemo, useRef, useState, } from "react";
 import { coworkerIndicesOf, sameCurrentWorkView, } from "../core/subagent-presence.js";
 import { ChildTranscriptPreview } from "./child-transcript.js";
 import { SubagentCurrentWorkContext, SubagentCurrentWorkPublisherContext, } from "./subagent-current-work.js";
 import { SubagentDrillInContext, } from "./subagent-drill-in.js";
 import { SubagentPreviewPopover } from "./subagent-preview-popover.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 function focusIfRestorable(opener) {
     if (!opener?.isConnected) {
         return;
@@ -68,63 +43,19 @@ export function SubagentDelegationSurface({ dispatches, threadId, renderPreview,
         : null;
     return (_jsx(SubagentDrillInContext.Provider, { value: drillIn, children: _jsx(SubagentCurrentWorkPublisherContext.Provider, { value: publishCurrentWork, children: _jsxs(SubagentCurrentWorkContext.Provider, { value: currentWork, children: [children, activeDrillIn !== null && threadId !== undefined ? (_jsx(SubagentPreviewPopover, { id: previewId, anchorRef: anchorRef, previewRef: previewRef, label: label ?? "Delegated task", children: renderPreview !== undefined ? (renderPreview(activeDrillIn.childSessionId, coworkerIndicesOf(dispatches.values()).get(activeDrillIn.childSessionId))) : (_jsx(ChildTranscriptPreview, { threadId: threadId, childSessionId: activeDrillIn.childSessionId, variantIndex: coworkerIndicesOf(dispatches.values()).get(activeDrillIn.childSessionId) })) }, activeDrillIn.childSessionId)) : null] }) }) }));
 }
-/** The drill-in lifecycle: open, the per-visit staleness stamp, close
- *  with focus restoration, sibling dismiss, and the open preview's Esc
- *  and light-dismiss listeners. */
 function useSubagentDrillInController(threadId) {
     const previewId = useId();
     const [openDrillIn, setOpenDrillIn] = useState(null);
-    // The visit token (failure-mode ledger, mode 8): one fresh object
-    // identity per CONTIGUOUS thread visit — it changes on A→B and again
-    // on B→A, so a stale drill-in can never revive when a thread id
-    // recurs (a thread-id stamp matched again on the way back).
-    // Residual, accepted: React may in principle discard a useMemo
-    // cache, which would mint a new token mid-visit and close an OPEN
-    // drill-in — the fail-safe direction, never a revival. The threadId
-    // inside is a debug fact; the token is the identity.
     const visitToken = useMemo(() => ({ threadId }), [threadId]);
-    // Thread switch (failure-mode ledger, mode 8): a drill-in opened over
-    // one thread must not stay afloat over the next — the held
-    // childSessionId belongs to the OLD thread's ledger, and rendering it
-    // against the new threadId would dial a cross-thread stream URL.
-    // Staleness is DERIVED (the visit-token stamp), never an effect's
-    // setState, so there is no cascading render and no focus restore on
-    // this arm — the opener row left with its conversation. The stale
-    // state itself is overwritten by the next open. In the SHIPPED host
-    // this arm is second-line defense: conversation-view keys Transcript
-    // by thread.id#reconnectNonce, so the surface remounts per thread and
-    // per reconnect — the stamp is what keeps an unkeyed host honest.
     const activeDrillIn = openDrillIn !== null && openDrillIn.forVisit === visitToken
         ? openDrillIn
         : null;
-    // The popover anchors to the opener element itself (the row's button):
-    // a ref-shaped memo over the open state, the shape the shared popover
-    // shell reads — never a ref written during render.
     const anchorRef = useMemo(() => ({ current: activeDrillIn?.opener ?? null }), [activeDrillIn]);
     const previewRef = useRef(null);
     const close = useCallback(() => {
-        // Focus returns to the opener exactly when it survived the visit
-        // AND is still visible (focusIfRestorable: isConnected alone does
-        // not test visibility, and a collapsed group's hidden row would
-        // swallow the focus silently). OUTSIDE the setState updater on
-        // purpose: updaters must stay pure (StrictMode double-invokes them,
-        // and React may re-run an interrupted queue), so the focus move
-        // rides the callback itself. Re-entrancy premise: two close() calls
-        // in one tick both read this render's activeDrillIn — focus() on
-        // the same element is idempotent and the second
-        // setOpenDrillIn(null) bails on Object.is.
         focusIfRestorable(activeDrillIn?.opener ?? null);
         setOpenDrillIn(null);
     }, [activeDrillIn]);
-    // The sibling-surface dismiss (failure-mode ledger mode 14). A
-    // no-restore rule would weigh only the pointer reader: the open
-    // effect focuses the popover for EVERY drill-in, so a bare unmount
-    // strands focus on <body> — the exact failure the pill's own
-    // pointer-leave guard exists to prevent. The opener is restored
-    // exactly when the popover CONTAINS focus at dismiss time; focus
-    // already elsewhere (a keyboard reader mid-route to the superseding
-    // surface — the pill's own focus-open arm) means someone moved it
-    // deliberately, and it stays where they put it.
     const dismiss = useCallback(() => {
         const preview = previewRef.current;
         const root = preview?.getRootNode();
@@ -136,12 +67,6 @@ function useSubagentDrillInController(threadId) {
         }
         setOpenDrillIn(null);
     }, [activeDrillIn]);
-    // The drill-in seam's value. Without a thread id there is no child
-    // stream door to open, so the rows stay honestly non-interactive (the
-    // null default). The value changes on open/close BY DESIGN:
-    // rows read openChildSessionId for their aria-expanded, so
-    // the affected rows must re-render — the row count is the fan-out's,
-    // small by construction.
     const drillIn = useMemo(() => threadId === undefined
         ? null
         : {
@@ -152,18 +77,6 @@ function useSubagentDrillInController(threadId) {
             openChildSessionId: activeDrillIn?.childSessionId ?? null,
             previewId,
         }, [threadId, visitToken, dismiss, activeDrillIn, previewId]);
-    // An explicitly activated dialog takes focus (unlike the roster's
-    // hover preview, whose reader is mid-hover): Escape then works from
-    // inside, and close() hands focus back to the opener. Esc rides the
-    // PREVIEW ELEMENT natively and stops propagation — the roster card's
-    // idiom, and load-bearing: a document-level listener never
-    // runs inside the companion drawer, whose own Esc-to-close is a React
-    // onKeyDown dispatched from the ROOT CONTAINER — an ancestor of this
-    // popover but a descendant of document — so the drawer would minimize
-    // with the preview still open. Attached deeper than the root
-    // container, this handler runs first and one keystroke performs one
-    // action. Light dismissal is judged by composedPath(), never
-    // contains(), for the script-tag shadow-root distribution.
     useEffect(() => {
         if (activeDrillIn === null) {
             return;
@@ -202,8 +115,6 @@ function useSubagentDrillInController(threadId) {
     }, [close, activeDrillIn]);
     return { previewId, activeDrillIn, anchorRef, previewRef, drillIn };
 }
-/** The current-work map this surface owns: the open preview's stream
- *  publishes its newest live call, the group rows read it. */
 function useCurrentWorkPublisher() {
     const [currentWork, setCurrentWork] = useState(() => new Map());
     const publishCurrentWork = useCallback((childSessionId, view) => {
@@ -217,16 +128,6 @@ function useCurrentWorkPublisher() {
                 next.delete(childSessionId);
                 return next;
             }
-            // Equal-evidence bail-out, by VALUE, never reference: the child
-            // transcript derives a FRESH view object from every streamed
-            // delta (newestToolCallViewOf), so a reference check never
-            // fires. This one fires on every delta that leaves the newest
-            // live call's label evidence unchanged — prose/reasoning deltas,
-            // the same call's argument streaming — returning `previous` so
-            // React bails and no group row re-renders. It stops firing (and
-            // publishes) when a different call becomes newest, the display
-            // annotation's caption or progressText lands or changes, or the
-            // child settles (the null arm above).
             if (held !== undefined && sameCurrentWorkView(held, view)) {
                 return previous;
             }
@@ -240,4 +141,3 @@ function useCurrentWorkPublisher() {
 function _drillInLabelOf(dispatches, childSessionId) {
     return ([...dispatches.values()].find((dispatch) => dispatch.child_session_id === childSessionId && dispatch.label !== "")?.label ?? "Delegated task");
 }
-//# sourceMappingURL=subagent-delegation-surface.js.map