@teaflask/assistant 0.3.0 → 0.6.0

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

package/dist/components/subagent-delivery-divider.d.ts

@@ -3,4 +3,3 @@ export declare function deliveryDividerLabelOf(results: readonly DeliveredResult
 export declare function SubagentDeliveryDivider({ results, }: {
     results: readonly DeliveredResult[];
 }): import("react").JSX.Element;
-//# sourceMappingURL=subagent-delivery-divider.d.ts.map

package/dist/components/subagent-delivery-divider.js

@@ -1,20 +1,11 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-// A subagent_results_delivered CUSTOM event never becomes a message: it
-// is the head of a machine-started delivery run, the answer to "why is
-// the assistant talking again". The store-side recorder
-// (core/subagent-delivery-anchors) anchors it to the run's first
-// message; the row interleave (core/transcript-rows) places this divider
-// before that message, and the label names the settled dispatches off
-// the anchored payload.
 import { activityTitleOf } from "../core/activity-title.js";
 import { AgentIdentityMark } from "./agent-identity-mark.js";
 export function deliveryDividerLabelOf(results) {
     const failed = results.filter((result) => !result.succeeded).length;
     const succeeded = results.length - failed;
     const first = results.find((result) => result.label !== "")?.label;
-    // The title's terminal punctuation is the brief's own delimiter; mid-line
-    // it would read "… exports. done", so the subject drops it.
     const subject = results.length === 1 && first
         ? `Subagent ${activityTitleOf(first).replace(/[.!?]+$/, "")}`
         : `${String(results.length)} ${results.length === 1 ? "subagent" : "subagents"}`;
@@ -27,17 +18,5 @@ export function deliveryDividerLabelOf(results) {
     return `${subject} · ${String(succeeded)} done · ${String(failed)} failed`;
 }
 export function SubagentDeliveryDivider({ results, }) {
-    return (
-    // The completed-background-handoff notice (TVC-132): a trusted
-    // system-originated event wears explicit system semantics — role
-    // and accessible name — over a compact right-aligned pill that
-    // carries the subagent identity mark, so it can never read as
-    // assistant prose or a member's message. The visible "System
-    // notification" line is aria-hidden: the container's accessible
-    // name already says it once. The pill's copy is the client's own
-    // read of the typed marker — the dispatch brief compacted through
-    // activityTitleOf, the full labels inspectable in the title — and
-    // no raw event payload renders.
-    _jsxs("div", { "data-tf-system-notice": "", role: "note", "aria-label": "System notification", className: "tf:flex tf:flex-col tf:items-end tf:gap-1.5 tf:py-3 tf:text-xs tf:text-tf-muted-foreground", children: [_jsx("span", { "aria-hidden": true, children: "System notification" }), _jsxs("span", { className: "tf:flex tf:max-w-full tf:items-center tf:gap-2 tf:rounded-full tf:bg-tf-muted tf:px-3 tf:py-2", title: results.map((result) => result.label).join("; "), children: [_jsx("span", { "aria-hidden": true, children: _jsx(AgentIdentityMark, { register: "subagent" }) }), _jsx("span", { className: "tf:min-w-0 tf:truncate", children: deliveryDividerLabelOf(results) })] })] }));
+    return (_jsxs("div", { "data-tf-system-notice": "", role: "note", "aria-label": "System notification", className: "tf:flex tf:flex-col tf:items-end tf:gap-1.5 tf:py-3 tf:text-xs tf:text-tf-muted-foreground", children: [_jsx("span", { "aria-hidden": true, children: "System notification" }), _jsxs("span", { className: "tf:flex tf:max-w-full tf:items-center tf:gap-2 tf:rounded-full tf:bg-tf-muted tf:px-3 tf:py-2", title: results.map((result) => result.label).join("; "), children: [_jsx("span", { "aria-hidden": true, children: _jsx(AgentIdentityMark, { register: "subagent" }) }), _jsx("span", { className: "tf:min-w-0 tf:truncate", children: deliveryDividerLabelOf(results) })] })] }));
 }
-//# sourceMappingURL=subagent-delivery-divider.js.map

package/dist/components/subagent-drill-in.d.ts

@@ -1,21 +1,8 @@
 export interface SubagentDrillIn {
     open: (childSessionId: string, opener: HTMLElement | null) => void;
-    /** Close any open drill-in — the arm a sibling preview surface (the
-     *  count pill's roster) uses when it supersedes the preview:
-     *  at most one child preview surface is open at a time, so the
-     *  roster's defocus blur and the capacity-1 tail lease never contend
-     *  with a preview nobody can reach. Focus returns to the opener
-     *  exactly when the popover still holds it; focus already
-     *  moved elsewhere stays where the reader put it. */
     dismiss: () => void;
-    /** The child whose preview is open (null when none) — rows derive
-     *  their aria-expanded from it, so the value changes on open/close by
-     *  design. */
     openChildSessionId: string | null;
-    /** The shared preview popover's DOM id — rows reference it via
-     *  aria-controls while their child's preview is open. */
     previewId: string;
 }
 export declare const SubagentDrillInContext: import("react").Context<SubagentDrillIn | null>;
 export declare function useSubagentDrillIn(): SubagentDrillIn | null;
-//# sourceMappingURL=subagent-drill-in.d.ts.map

package/dist/components/subagent-drill-in.js

@@ -1,18 +1,6 @@
 "use client";
-// The drill-in seam: how a roster or tree row asks the conversation
-// surface to open one subagent's own transcript. A context rather than a
-// prop chain because the rows live deep inside the message list; the
-// null default keeps bare-rendered rows (tests, hosts without the panel)
-// honestly non-interactive.
-//
-// The caller hands its own element over as the opener focus returns to
-// on close/dismiss — never inferred from document.activeElement, which
-// lies twice: at a shadow boundary it retargets to the host element
-// (the script-tag distribution mounts in an open shadow root), and
-// Safari doesn't focus a clicked button at all.
 import { createContext, useContext } from "react";
 export const SubagentDrillInContext = createContext(null);
 export function useSubagentDrillIn() {
     return useContext(SubagentDrillInContext);
 }
-//# sourceMappingURL=subagent-drill-in.js.map

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

@@ -1,4 +1,3 @@
 import type { CoworkerExecutionWork } from "../core/coworker-execution-work.js";
 export declare const SubagentExecutionWorkContext: import("react").Context<ReadonlyMap<number, CoworkerExecutionWork>>;
 export declare function useSubagentExecutionWork(): ReadonlyMap<number, CoworkerExecutionWork>;
-//# sourceMappingURL=subagent-execution-work.d.ts.map

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

@@ -1,15 +1,7 @@
 "use client";
-// The coworker-work seam: what the member owes each coworker — an action
-// their browser performs or a decision on an approval — keyed by ordinal,
-// for the delegation group row. Fed from the store's coworkerWork cell
-// (the execution inbox's coworker entries and the approval inbox's
-// coworker cards, folded), never from a child stream — the drill-in-only
-// current-work seam beside it stays its own. A host rendering rows bare
-// gets the empty map and a quiet line.
 import { createContext, useContext } from "react";
 const EMPTY_WORK = new Map();
 export const SubagentExecutionWorkContext = createContext(EMPTY_WORK);
 export function useSubagentExecutionWork() {
     return useContext(SubagentExecutionWorkContext);
 }
-//# sourceMappingURL=subagent-execution-work.js.map

package/dist/components/subagent-group-row.d.ts

@@ -1,14 +1,6 @@
 import { type ThreadDispatch } from "../contract/dispatches.js";
 import { type SubagentGroupEntry, type SubagentGroupRow as SubagentGroupRowModel } from "../core/subagent-rows.js";
 import type { CoworkerExecutionWork } from "../core/coworker-execution-work.js";
-/** The thread's ledger rows keyed by ORDINAL — the ask's identity.
- *  child_session_id is not unique (a resume chain shares the handle),
- *  so a session-keyed map would let the resume row overwrite the
- *  original and every receipt after it render the wrong ask; the
- *  ordinal is unique within the thread's one parent_run_id namespace
- *  and rides the wire receipt itself (clipped receipts included). The
- *  empty default keeps a host without the read rendering honest
- *  receipt-only groups. */
 export interface SubagentDispatchesJoin {
     byOrdinal: ReadonlyMap<number, ThreadDispatch>;
 }
@@ -20,38 +12,15 @@ export interface ResolvedSubagentEntry {
     failed: boolean;
     cancelled: boolean;
     note: string | null;
-    /** The drill-in key: the receipt's child session id exactly when the
-     *  ledger vouches for it — a receipt-only row has no provable family
-     *  membership to stream by, so it stays null. */
     childSessionId: string | null;
-    /** The coworker's identity token (law 10, TVC-091) — derived from the
-     *  vouched child session, so an unvouched row wears no mark (typed
-     *  evidence, never synthesis), and the roster's mark for the same
-     *  coworker is the identical token. */
     identityToken: string | null;
-    /** The ask's identity — the receipt's ordinal, the browser-work join
-     *  key; null on a receiptless row. */
     ordinal: number | null;
-    /** The ledger says the coworker is paused for an answer only the
-     *  member's browser can give. */
     paused: boolean;
-    /** The ledger row's timestamps — null on receipt-only rows (the wire
-     *  receipt carries no timing), and settledAt null while running. */
     startedAt: string | null;
     settledAt: string | null;
 }
-/** One entry's truth: the ledger row outranks the wire receipt wherever
- *  both speak (the dashboard row's resolve, with the vouched child
- *  session id in place of its ledger handle). */
 export declare function resolvedSubagentEntryOf(entry: SubagentGroupEntry, byOrdinal: ReadonlyMap<number, ThreadDispatch>): ResolvedSubagentEntry;
 export declare function SubagentGroupRow({ row }: {
     row: SubagentGroupRowModel;
 }): import("react").JSX.Element;
-/** What the member owes this coworker — an action in their browser or a
- *  decision on an approval; the asker named by the row it sits on, never
- *  as the assistant's tool call. Null unless the ledger says the row is
- *  paused: a resumed coworker's entry stays in the inbox (still
- *  "reported") until the next conversation read, and must not speak over
- *  the row's own live work meanwhile. */
 export declare function coworkerWorkLabelOf(work: CoworkerExecutionWork | undefined, paused: boolean): string | null;
-//# sourceMappingURL=subagent-group-row.d.ts.map

package/dist/components/subagent-group-row.js

@@ -1,15 +1,5 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-// The transcript's delegation moment: one disclosure per run of dispatch
-// calls, a row per coworker — wire receipts refined by the thread's
-// dispatch ledger where the host provides it, so a child that outlives
-// its turn reads settled instead of spinning on its frozen receipt. The
-// ledger row outranks the wire wherever both speak; cancelled stays
-// wire-only (the ledger has no cancelled status). A ledgered row is a
-// button that opens the child's own transcript preview. The rows carry
-// the drill-in-fed current-work line and the settled "Worked for …" span;
-// dashboard-only facts (model badge, live elapsed) and the final summary
-// stay off this surface — the child's full report is one drill-in away.
 import { activityTitleOf } from "../core/activity-title.js";
 import { ChevronRightIcon } from "lucide-react";
 import { createContext, useContext } from "react";
@@ -31,15 +21,8 @@ const EMPTY_SUBAGENT_DISPATCHES = {
     byOrdinal: new Map(),
 };
 export const SubagentDispatchesContext = createContext(EMPTY_SUBAGENT_DISPATCHES);
-/** One entry's truth: the ledger row outranks the wire receipt wherever
- *  both speak (the dashboard row's resolve, with the vouched child
- *  session id in place of its ledger handle). */
 export function resolvedSubagentEntryOf(entry, byOrdinal) {
-    // Ordinal, not child session id: a resume chain shares one handle
-    // across rows, and each receipt must stay bound to the ask that
-    // launched it.
     const ledger = entry.receipt != null ? byOrdinal.get(entry.receipt.ordinal) : undefined;
-    // An empty ledger label must not blank a good wire label.
     const ledgerLabel = ledger !== undefined && ledger.label !== "" ? ledger.label : null;
     const childSessionId = ledger !== undefined && entry.receipt?.childSessionId != null
         ? entry.receipt.childSessionId
@@ -51,8 +34,6 @@ export function resolvedSubagentEntryOf(entry, byOrdinal) {
         label: ledgerLabel ?? entry.label,
         running,
         failed,
-        // Cancellation is a wire fact (a cancelled tool call); the ledger
-        // never speaks it and must not override it.
         cancelled: entry.cancelled,
         note: (ledger !== undefined && dispatchFailed(ledger) ? ledger.error : null) ??
             entry.note,
@@ -68,26 +49,10 @@ export function SubagentGroupRow({ row }) {
     const join = useContext(SubagentDispatchesContext);
     const resolved = row.entries.map((entry) => resolvedSubagentEntryOf(entry, join.byOrdinal));
     const counts = subagentOutcomeCountsOf(resolved);
-    // The deterministic color variants (law 10) — the same pure ledger
-    // read the roster makes, so one coworker wears one color on every
-    // surface.
     const variantIndices = coworkerIndicesOf(join.byOrdinal.values());
-    // The open drill-in stream's live-operation feed (TVC-072) — empty on
-    // hosts without the delegation surface, and empty for every child
-    // nobody is watching: the line below disappears cleanly.
     const currentWork = useSubagentCurrentWork();
     const executionWork = useSubagentExecutionWork();
-    return (
-    // The group hook (TVC-070): the wrapper's x-origin IS the group's —
-    // the Disclosure inside adds no inline-start spacing of its own, so
-    // the child entries' one-rail-level indent is measured against it.
-    _jsx("div", { "data-tf-subagent-group": "", className: "tf:relative tf:w-full", children: _jsx(Disclosure, { variant: "bare", className: "tf:my-1.5 tf:w-full", 
-            // The reasoning-row idiom: forced open while coworkers work, the
-            // member's own toggle once everything settled.
-            open: counts.running > 0 || undefined, summaryClassName: "tf:flex tf:w-fit tf:items-center tf:gap-2 tf:py-1.5 tf:text-tf-label tf:text-tf-muted-foreground tf:hover:text-tf-foreground", 
-            // The tree nodes own their indentation: each line carries its
-            // own trunk-and-elbow connectors, so the body stays flush.
-            bodyClassName: "tf:flex tf:flex-col tf:pt-1 tf:pb-2", summary: _jsxs(_Fragment, { children: [_jsxs("span", { "aria-hidden": true, className: "tf:relative tf:flex tf:size-6 tf:shrink-0 tf:items-center tf:justify-center", children: [_jsx(AgentIdentityMark, { register: "subagent", size: "md" }), counts.failed > 0 ? (_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] }), counts.running > 0 ? (_jsx(ShimmerText, { children: subagentGroupHeadlineOf(counts) })) : (_jsx("span", { children: subagentGroupHeadlineOf(counts) })), _jsx(DisclosureChevron, { revealOnInteraction: true })] }), children: _jsx("ul", { className: "tf:m-0 tf:flex tf:list-none tf:flex-col tf:ps-0", children: resolved.map((entry, index) => (_jsx(CoworkerLine, { entry: entry, variantIndex: entry.childSessionId !== null
+    return (_jsx("div", { "data-tf-subagent-group": "", className: "tf:relative tf:w-full", children: _jsx(Disclosure, { variant: "bare", className: "tf:my-1.5 tf:w-full", open: counts.running > 0 || undefined, summaryClassName: "tf:flex tf:w-fit tf:items-center tf:gap-2 tf:py-1.5 tf:text-tf-label tf:text-tf-muted-foreground tf:hover:text-tf-foreground", bodyClassName: "tf:flex tf:flex-col tf:pt-1 tf:pb-2", summary: _jsxs(_Fragment, { children: [_jsxs("span", { "aria-hidden": true, className: "tf:relative tf:flex tf:size-6 tf:shrink-0 tf:items-center tf:justify-center", children: [_jsx(AgentIdentityMark, { register: "subagent", size: "md" }), counts.failed > 0 ? (_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] }), counts.running > 0 ? (_jsx(ShimmerText, { children: subagentGroupHeadlineOf(counts) })) : (_jsx("span", { children: subagentGroupHeadlineOf(counts) })), _jsx(DisclosureChevron, { revealOnInteraction: true })] }), children: _jsx("ul", { className: "tf:m-0 tf:flex tf:list-none tf:flex-col tf:ps-0", children: resolved.map((entry, index) => (_jsx(CoworkerLine, { entry: entry, variantIndex: entry.childSessionId !== null
                         ? variantIndices.get(entry.childSessionId)
                         : undefined, currentWorkView: entry.childSessionId !== null
                         ? currentWork.get(entry.childSessionId)
@@ -97,30 +62,14 @@ export function SubagentGroupRow({ row }) {
 }
 function CoworkerLine({ entry, variantIndex, currentWorkView, coworkerWork, last, }) {
     const drillIn = useSubagentDrillIn();
-    // The drill-in address rides the resolved entry itself (childSessionId
-    // is non-null exactly when the ledger vouches for the row).
     const drillInKey = entry.childSessionId;
-    // The resolved note: a failed ledger row's error sentence, a settled
-    // receipt's note, or a refused call's failure sentence — the row's
-    // whole explanation on this surface.
     const note = entry.note;
-    // Settled server math only (the roster's own law): the line renders
-    // exactly when the ledger measured a span; a running child never ticks
-    // here, and a receipt-only row (no timestamps) shows nothing.
     const workedLabel = entry.startedAt !== null
         ? settledWorkedLabelOf(entry.startedAt, entry.settledAt)
         : null;
     const EntrySurface = drillIn !== null && drillInKey !== null ? TfButton : "span";
     const drillable = drillIn !== null && drillInKey !== null;
-    return (
-    // ps-7 IS one rail level (TVC-070): the operations rail's measured
-    // icon→label step — the size-4 mark plus the summary's gap-3 — which
-    // is also the tool rows' own ps-7 body indent. The entry hook sits
-    // on the content span below (the li's box origin is the group's;
-    // its PADDING is the indent). The row's vertical padding rides the
-    // entry surface, not the li, so the drill-in's hover plate covers
-    // the whole row and its radius never bites the leading mark.
-    _jsxs("li", { className: "tf:relative tf:flex tf:ps-7 tf:text-tf-label tf:text-tf-foreground", children: [_jsx(CoworkerLineConnectors, { last: last }), _jsxs(EntrySurface, { "data-tf-subagent-entry": "", "data-tf-subagent-identity": entry.identityToken ?? undefined, className: "tf:group/subagent tf:flex tf:min-w-0 tf:flex-1 tf:items-start tf:justify-start tf:gap-2 tf:py-3 tf:text-start tf:text-tf-label tf:font-normal", ...(drillIn !== null && drillInKey !== null
+    return (_jsxs("li", { className: "tf:relative tf:flex tf:ps-7 tf:text-tf-label tf:text-tf-foreground", children: [_jsx(CoworkerLineConnectors, { last: last }), _jsxs(EntrySurface, { "data-tf-subagent-entry": "", "data-tf-subagent-identity": entry.identityToken ?? undefined, className: "tf:group/subagent tf:flex tf:min-w-0 tf:flex-1 tf:items-start tf:justify-start tf:gap-2 tf:py-3 tf:text-start tf:text-tf-label tf:font-normal", ...(drillIn !== null && drillInKey !== null
                     ? {
                         variant: "bare",
                         "aria-haspopup": "dialog",
@@ -135,72 +84,26 @@ function CoworkerLine({ entry, variantIndex, currentWorkView, coworkerWork, last
                                 drillIn.open(drillInKey, event.currentTarget);
                         },
                     }
-                    : {}), children: [_jsx(CoworkerLineOrnaments, { entry: entry, variantIndex: variantIndex, working: currentWorkView !== undefined }), _jsxs("span", { className: "tf:flex tf:min-w-0 tf:flex-1 tf:flex-col tf:gap-1", children: [_jsx(CoworkerLineLabel, { entry: entry, drillable: drillable }), entry.running ? (_jsx(CoworkerLineWork, { currentWorkView: currentWorkView, coworkerWork: coworkerWork, paused: entry.paused })) : null, workedLabel !== null ? (
-                            // Settled cost in the settled-fold register ("Worked for
-                            // <1s", never "0s" — TVC-073's ladder), from the ledger's
-                            // own timestamps.
-                            _jsx("span", { "data-tf-subagent-worked": "", className: "tf:m-0 tf:truncate tf:text-xs tf:text-tf-muted-foreground", children: workedLabel })) : null, !entry.running && note !== null ? (
-                            // title carries the whole sentence: the drill-in shows the
-                            // full transcript, but a truncated failure reason must still
-                            // be readable in place.
-                            _jsx("span", { "data-tf-subagent-note": "", title: note, 
-                                // m-0 like every sibling line: the widget ships no
-                                // preflight (the <ul> comment above), so a bare <p> stacks
-                                // the UA margin on the flex gap and the note detaches from
-                                // its row.
-                                className: "tf:m-0 tf:truncate tf:text-xs tf:text-tf-muted-foreground", children: note })) : null] })] })] }));
+                    : {}), children: [_jsx(CoworkerLineOrnaments, { entry: entry, variantIndex: variantIndex, working: currentWorkView !== undefined }), _jsxs("span", { className: "tf:flex tf:min-w-0 tf:flex-1 tf:flex-col tf:gap-1", children: [_jsx(CoworkerLineLabel, { entry: entry, drillable: drillable }), entry.running ? (_jsx(CoworkerLineWork, { currentWorkView: currentWorkView, coworkerWork: coworkerWork, paused: entry.paused })) : null, workedLabel !== null ? (_jsx("span", { "data-tf-subagent-worked": "", className: "tf:m-0 tf:truncate tf:text-xs tf:text-tf-muted-foreground", children: workedLabel })) : null, !entry.running && note !== null ? (_jsx("span", { "data-tf-subagent-note": "", title: note, className: "tf:m-0 tf:truncate tf:text-xs tf:text-tf-muted-foreground", children: note })) : null] })] })] }));
 }
-/** The tree's connectors: the trunk (stopping at the last row's own
- *  elbow) and the elbow riding the label line's center. */
 function CoworkerLineConnectors({ last }) {
     return (_jsxs(_Fragment, { children: [_jsx("span", { "aria-hidden": true, className: last
                     ? "tf:pointer-events-none tf:absolute tf:start-2 tf:top-0 tf:h-5.5 tf:w-px tf:bg-tf-border"
                     : "tf:pointer-events-none tf:absolute tf:start-2 tf:top-0 tf:h-full tf:w-px tf:bg-tf-border" }), _jsx("span", { "aria-hidden": true, className: "tf:pointer-events-none tf:absolute tf:start-2 tf:top-5.5 tf:h-px tf:w-4 tf:bg-tf-border" })] }));
 }
-/** The fixed-size status+identity cluster beside the label column. */
 function CoworkerLineOrnaments({ entry, variantIndex, working, }) {
-    return (
-    // data-tf-subagent-ornaments: TVC-075's measurement hook — the
-    // fixed-size ornament cluster whose center must ride the label
-    // line, never the row's whole stack.
-    _jsxs("span", { "data-tf-subagent-ornaments": "", className: "tf:flex tf:min-h-5 tf:shrink-0 tf:items-center tf:gap-2", children: [entry.running && working ? (_jsx("span", { className: "tf:sr-only", children: "Working" })) : !entry.running && !entry.failed && !entry.cancelled ? (_jsx("span", { className: "tf:sr-only", children: "Finished" })) : null, _jsx("span", { "aria-hidden": true, children: _jsx(AgentIdentityMark, { register: "subagent", variantIndex: variantIndex, className: "tf:text-tf-muted-foreground" }) })] }));
+    return (_jsxs("span", { "data-tf-subagent-ornaments": "", className: "tf:flex tf:min-h-5 tf:shrink-0 tf:items-center tf:gap-2", children: [entry.running && working ? (_jsx("span", { className: "tf:sr-only", children: "Working" })) : !entry.running && !entry.failed && !entry.cancelled ? (_jsx("span", { className: "tf:sr-only", children: "Finished" })) : null, _jsx("span", { "aria-hidden": true, children: _jsx(AgentIdentityMark, { register: "subagent", variantIndex: variantIndex, className: "tf:text-tf-muted-foreground" }) })] }));
 }
-/** The label line: the coworker's task title (shimmering while live,
- *  with the drill-in chevron where the row is a button) and the failed
- *  or interrupted pill. */
 function CoworkerLineLabel({ entry, drillable, }) {
-    return (_jsxs("span", { className: "tf:flex tf:min-w-0 tf:items-center tf:gap-2", children: [drillable ? (_jsxs("span", { className: "tf:flex tf:min-w-0 tf:items-center tf:gap-1.5", children: [entry.running ? (
-                    // The live row's liveness claim: the label itself shimmers,
-                    // in the muted live-work ink every moving label wears. The
-                    // measurement hook sits OUTSIDE the shimmer: the primitive
-                    // stacks its children twice (base + aria-hidden highlight),
-                    // and a hook inside would match twice per running row (only
-                    // current-work, which must read verbatim, keeps the inside
-                    // placement). Truncation follows the current-work pattern:
-                    // the ellipsis lives on the blockified span inside the atomic inline-grid.
-                    _jsx("span", { "data-tf-subagent-label": "", title: entry.label ?? undefined, className: "tf:min-w-0 tf:text-tf-muted-foreground", children: _jsx(ShimmerText, { className: "tf:max-w-full tf:grid-cols-1", children: _jsx("span", { className: "tf:block tf:truncate", children: activityTitleOf(entry.label ?? "Delegated task") }) }) })) : (_jsx("span", { "data-tf-subagent-label": "", title: entry.label ?? undefined, className: "tf:min-w-0 tf:truncate", children: activityTitleOf(entry.label ?? "Delegated task") })), _jsx(ChevronRightIcon, { "aria-hidden": true, className: "tf:size-3.5 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:group-aria-expanded/subagent:opacity-100 tf:pointer-coarse:opacity-100" }), _jsx("span", { className: "tf:sr-only", children: "Open this subagent's transcript" })] })) : entry.running ? (
-            // The passive twin of the drill-in arm above: same live
-            // shimmer, same hook-outside-the-shimmer placement, same
-            // truncation shape, no affordance.
-            _jsx("span", { "data-tf-subagent-label": "", title: entry.label ?? undefined, className: "tf:min-w-0 tf:text-tf-muted-foreground", children: _jsx(ShimmerText, { className: "tf:max-w-full tf:grid-cols-1", children: _jsx("span", { className: "tf:block tf:truncate", children: activityTitleOf(entry.label ?? "Delegated task") }) }) })) : (_jsx("span", { "data-tf-subagent-label": "", title: entry.label ?? undefined, className: "tf:min-w-0 tf:truncate", children: activityTitleOf(entry.label ?? "Delegated task") })), entry.failed ? (_jsx(StatePill, { destructive: true, children: "Failed" })) : entry.cancelled && !entry.running ? (_jsx(StatePill, { children: "Interrupted" })) : null] }));
+    return (_jsxs("span", { className: "tf:flex tf:min-w-0 tf:items-center tf:gap-2", children: [drillable ? (_jsxs("span", { className: "tf:flex tf:min-w-0 tf:items-center tf:gap-1.5", children: [entry.running ? (_jsx("span", { "data-tf-subagent-label": "", title: entry.label ?? undefined, className: "tf:min-w-0 tf:text-tf-muted-foreground", children: _jsx(ShimmerText, { className: "tf:max-w-full tf:grid-cols-1", children: _jsx("span", { className: "tf:block tf:truncate", children: activityTitleOf(entry.label ?? "Delegated task") }) }) })) : (_jsx("span", { "data-tf-subagent-label": "", title: entry.label ?? undefined, className: "tf:min-w-0 tf:truncate", children: activityTitleOf(entry.label ?? "Delegated task") })), _jsx(ChevronRightIcon, { "aria-hidden": true, className: "tf:size-3.5 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:group-aria-expanded/subagent:opacity-100 tf:pointer-coarse:opacity-100" }), _jsx("span", { className: "tf:sr-only", children: "Open this subagent's transcript" })] })) : entry.running ? (_jsx("span", { "data-tf-subagent-label": "", title: entry.label ?? undefined, className: "tf:min-w-0 tf:text-tf-muted-foreground", children: _jsx(ShimmerText, { className: "tf:max-w-full tf:grid-cols-1", children: _jsx("span", { className: "tf:block tf:truncate", children: activityTitleOf(entry.label ?? "Delegated task") }) }) })) : (_jsx("span", { "data-tf-subagent-label": "", title: entry.label ?? undefined, className: "tf:min-w-0 tf:truncate", children: activityTitleOf(entry.label ?? "Delegated task") })), entry.failed ? (_jsx(StatePill, { destructive: true, children: "Failed" })) : entry.cancelled && !entry.running ? (_jsx(StatePill, { children: "Interrupted" })) : null] }));
 }
-/** What the member owes this coworker — an action in their browser or a
- *  decision on an approval; the asker named by the row it sits on, never
- *  as the assistant's tool call. Null unless the ledger says the row is
- *  paused: a resumed coworker's entry stays in the inbox (still
- *  "reported") until the next conversation read, and must not speak over
- *  the row's own live work meanwhile. */
 export function coworkerWorkLabelOf(work, paused) {
     if (!paused) {
         return null;
     }
     if (work !== undefined) {
-        // An approval's tool name is best-effort on the contract (null when the
-        // pause stopped no tool call); an execution's is required. An unnamed
-        // approval keeps its sentence and drops the "to run X" clause.
         const name = work.toolName === null ? "" : humanizedToolName(work.toolName);
         if (work.via === "approval") {
-            // The member owes a decision, not the browser an action.
             switch (work.status) {
                 case "pending":
                 case "executing":
@@ -233,22 +136,10 @@ export function coworkerWorkLabelOf(work, paused) {
     }
     return "Paused, waiting on you";
 }
-/** The live status line under a running coworker's label. */
 function CoworkerLineWork({ currentWorkView, coworkerWork, paused, }) {
     const workLabel = coworkerWorkLabelOf(coworkerWork, paused);
     if (workLabel !== null) {
         return (_jsx("span", { className: "tf:m-0 tf:text-xs tf:text-tf-muted-foreground", children: _jsx(ShimmerText, { className: "tf:max-w-full tf:grid-cols-1", children: _jsx("span", { "data-tf-subagent-coworker-work": "", className: "tf:block tf:truncate", children: workLabel }) }) }));
     }
-    return (
-    // The live status line: the presenter's currentWorkLabel
-    // (TVC-072 — the one headline ladder's RUNNING arm, never a
-    // locally respelled frame) while the drill-in stream feeds
-    // it, the plain word "Working" otherwise — a running row
-    // must state its state in visible words (the roster row's
-    // rule), because reduced motion collapses the label's
-    // shimmer to plain text and the ornament slot is
-    // deliberately empty. Through the one shared shimmer either
-    // way.
-    _jsx("span", { className: "tf:m-0 tf:text-xs tf:text-tf-muted-foreground", children: _jsx(ShimmerText, { className: "tf:max-w-full tf:grid-cols-1", children: currentWorkView !== undefined ? (_jsx("span", { "data-tf-subagent-current-work": "", className: "tf:block tf:truncate", children: toolCallPresentationOf(currentWorkView).currentWorkLabel })) : (_jsx("span", { className: "tf:block tf:truncate", children: "Working" })) }) }));
+    return (_jsx("span", { className: "tf:m-0 tf:text-xs tf:text-tf-muted-foreground", children: _jsx(ShimmerText, { className: "tf:max-w-full tf:grid-cols-1", children: currentWorkView !== undefined ? (_jsx("span", { "data-tf-subagent-current-work": "", className: "tf:block tf:truncate", children: toolCallPresentationOf(currentWorkView).currentWorkLabel })) : (_jsx("span", { className: "tf:block tf:truncate", children: "Working" })) }) }));
 }
-//# sourceMappingURL=subagent-group-row.js.map

package/dist/components/subagent-preview-popover.d.ts

@@ -1,11 +1,8 @@
 import { type ReactNode, type RefObject } from "react";
 export declare function SubagentPreviewPopover({ id, anchorRef, previewRef, label, children, }: {
     id: string;
-    /** The element the preview floats beside — the roster card, or the
-     *  inline row's own drill-in button. */
     anchorRef: RefObject<HTMLElement | null>;
     previewRef: RefObject<HTMLDivElement | null>;
     label: string;
     children: ReactNode;
 }): import("react").JSX.Element;
-//# sourceMappingURL=subagent-preview-popover.d.ts.map

package/dist/components/subagent-preview-popover.js

@@ -1,11 +1,5 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-// The child-transcript preview's floating shell, extracted from the
-// count pill so the inline delegation rows and the roster rows share
-// ONE surface: the browser top layer, so real assistant hosts may keep
-// their rounded, overflow-hidden shells without clipping the preview.
-// Placement prefers the requested right side, then the left, then the
-// larger vertical side on a narrow viewport.
 import { useEffect } from "react";
 export function SubagentPreviewPopover({ id, anchorRef, previewRef, label, children, }) {
     useEffect(() => {
@@ -21,20 +15,10 @@ export function SubagentPreviewPopover({ id, anchorRef, previewRef, label, child
         if (view === null) {
             return;
         }
-        // Re-placement guards against a HIDDEN anchor: a delegation row
-        // inside a <details> group that collapses while the preview is up
-        // keeps a connected but boxless button, and placing against an
-        // all-zeros rect lands the preview at the viewport's top-left
-        // corner on the next scroll/resize tick. The INITIAL placement
-        // stays unconditional — an anchor is visible at open by
-        // construction (a boxless control cannot be activated), and jsdom's
-        // layoutless world (every rect zero) keeps its opening path.
         let placedOnce = false;
         const place = () => {
             const anchorRect = anchor.getBoundingClientRect();
             if (placedOnce && anchorRect.width === 0 && anchorRect.height === 0) {
-                // Keep the last good placement; the preview stays where the
-                // reader left it until they dismiss it or the anchor returns.
                 return;
             }
             placedOnce = true;
@@ -61,9 +45,6 @@ export function SubagentPreviewPopover({ id, anchorRef, previewRef, label, child
     }, [anchorRef, previewRef]);
     return (_jsxs("div", { ref: previewRef, id: id, role: "dialog", "aria-label": `Conversation preview: ${label}`, popover: "manual", tabIndex: -1, className: "tf:fixed tf:m-0 tf:overflow-visible tf:border-0 tf:bg-transparent tf:p-0 tf:text-tf-foreground tf:focus-visible:outline-2 tf:focus-visible:outline-offset-2 tf:focus-visible:outline-tf-ring", children: [_jsx("span", { "aria-hidden": true, "data-tf-subagent-preview-hover-bridge": "", className: "tf:pointer-events-auto tf:absolute tf:-inset-2" }), _jsx("div", { className: "tf:relative tf:h-full tf:w-full", children: children })] }));
 }
-/** Beside the anchor on the right when it fits, else the left, else
- *  centered over it on whichever vertical side has room — always inside
- *  the viewport gutter. */
 function _previewPlacementOf(anchorRect, viewportWidth, viewportHeight) {
     const gutter = 16;
     const gap = 8;
@@ -95,4 +76,3 @@ function _previewPlacementOf(anchorRect, viewportWidth, viewportHeight) {
     }
     return { left, top, width, height };
 }
-//# sourceMappingURL=subagent-preview-popover.js.map