@teaflask/assistant 0.0.0 → 0.3.0

package/dist/components/assistant-palette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-palette.d.ts","sourceRoot":"","sources":["../../src/components/assistant-palette.tsx"],"names":[],"mappings":"AAcA,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,+BAM5D"}

package/dist/components/assistant-palette.js

@@ -0,0 +1,39 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { lazy } from "react";
+import { useAssistantAppearance } from "./appearance-context.js";
+import { LazyBody } from "./lazy-body.js";
+import { SurfaceBoundary } from "./surface-boundary.js";
+import { TfDialog } from "./primitives/dialog.js";
+import { useRegisterAssistantSurface } from "./use-register-assistant-surface.js";
+// The body is code-split behind the first open, so mounting a closed
+// palette on every page ships no transcript (the bundle discipline).
+const AssistantPaletteBody = lazy(() => import("./assistant-palette-body.js"));
+/**
+ * The cmd-k overlay surface: the same conversation core as <AssistantPage/>
+ * in a native-dialog shell — current/new thread only. Controlled: whoever
+ * mounts it owns the trigger and open state; Esc and a backdrop click close
+ * it from inside. Closing drops the live stream on purpose: reopening
+ * remounts the transcript and the full replay-then-tail restores it exactly.
+ * The export is the boundary; degrade="silent" because an in-flow fallback
+ * card would land as a stray block on the host page.
+ */
+export function AssistantPalette(props) {
+    return (_jsx(SurfaceBoundary, { surface: "palette", degrade: "silent", children: _jsx(AssistantPaletteInner, { ...props }) }));
+}
+function AssistantPaletteInner({ open, onOpenChange }) {
+    // The provider's theme/mode props ride onto every data-tf-assistant root.
+    const { rootProps } = useAssistantAppearance();
+    // Announced only while open: the dialog root stays mounted while closed
+    // (rendering nothing), and a closed palette must not read as an active surface.
+    useRegisterAssistantSurface("transient", open);
+    return (_jsx(TfDialog, { open: open, onOpenChange: onOpenChange, "aria-label": "Assistant", "data-tf-assistant": "", "data-tf-glass": "", "data-tf-assistant-palette": "", ...rootProps, className: 
+        // Mobile: a near-full-screen sheet with a 4-step margin. Desktop: the
+        // cmd-k idiom — top-anchored, centered, fixed height. The scrim is 20%,
+        // not a classic 40%: the glass blurs its own backdrop; a heavy dim curdles it.
+        "tf:m-auto tf:h-[calc(100dvh-2rem)] tf:w-[calc(100vw-2rem)] tf:flex-col " +
+            "tf:overflow-hidden tf:rounded-tf tf:border " +
+            "tf:text-tf-foreground tf:backdrop:bg-black/20 " +
+            "tf:sm:mt-24 tf:sm:h-[calc(100dvh-12rem)] tf:sm:max-h-144 tf:sm:w-full tf:sm:max-w-2xl", children: open ? (_jsx(LazyBody, { children: _jsx(AssistantPaletteBody, { onOpenChange: onOpenChange }) })) : null }));
+}
+//# sourceMappingURL=assistant-palette.js.map

package/dist/components/assistant-palette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-palette.js","sourceRoot":"","sources":["../../src/components/assistant-palette.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAE7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAElF,qEAAqE;AACrE,qEAAqE;AACrE,MAAM,oBAAoB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,6BAA6B,CAAC,CAAC,CAAC;AAO/E;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAA4B;IAC3D,OAAO,CACL,KAAC,eAAe,IAAC,OAAO,EAAC,SAAS,EAAC,OAAO,EAAC,QAAQ,YACjD,KAAC,qBAAqB,OAAK,KAAK,GAAI,GACpB,CACnB,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,EAAE,IAAI,EAAE,YAAY,EAAyB;IAC1E,0EAA0E;IAC1E,MAAM,EAAE,SAAS,EAAE,GAAG,sBAAsB,EAAE,CAAC;IAC/C,wEAAwE;IACxE,gFAAgF;IAChF,2BAA2B,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAE/C,OAAO,CACL,KAAC,QAAQ,IACP,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,YAAY,gBACf,WAAW,uBACJ,EAAE,mBACN,EAAE,+BAIU,EAAE,KACxB,SAAS,EACb,SAAS;QACP,sEAAsE;QACtE,wEAAwE;QACxE,+EAA+E;QAC/E,yEAAyE;YACzE,6CAA6C;YAC7C,gDAAgD;YAChD,uFAAuF,YAKxF,IAAI,CAAC,CAAC,CAAC,CACN,KAAC,QAAQ,cACP,KAAC,oBAAoB,IAAC,YAAY,EAAE,YAAY,GAAI,GAC3C,CACZ,CAAC,CAAC,CAAC,IAAI,GACC,CACZ,CAAC;AACJ,CAAC"}

package/dist/components/assistant-transcript.d.ts

@@ -0,0 +1,104 @@
+import type { AbstractAgent } from "@ag-ui/client";
+import { type ComponentType, type ReactNode } from "react";
+import type { ApprovalCardModel } from "../core/approval-inbox.js";
+import { type MarkerBoundaries, type TranscriptRow } from "../core/transcript-rows.js";
+import type { TurnAttachment } from "../contract/threads.js";
+import { type MessageViewSlot, type ToolRowSlot, type TranscriptMarkerProps } from "./message-list.js";
+interface TranscriptSlotProps {
+    /** Styles the library's scroll element (a height-capped host puts its
+     *  max-h here — see MessageList's prop). */
+    scrollClassName?: string;
+    /** The host row fill — content only; the package keeps each row's
+     *  frame. Returning null/undefined falls through to the package
+     *  rendering per row. */
+    messageView?: MessageViewSlot;
+    /** The host tool-row fill — replaces exactly the package ToolRow;
+     *  receipt collapse, decision surfaces, and the frame's status word
+     *  stay package-owned outside it. */
+    toolRow?: ToolRowSlot;
+    /** In-flow input region under the scroll viewport (a composer).
+     *  Unfilled renders nothing: watch-only is the honest default (the
+     *  package Composer needs the session store an agent-mode host lacks;
+     *  the store binder composes its chrome as siblings). THE INPUT-REGION RULE:
+     *  this slot mounts its fill WITHOUT an error boundary — the input
+     *  region is the surface's ability to act, and a null-fallback latch
+     *  would turn a crash into a paused run that looks idle and cannot be
+     *  answered. A throw propagates to the host's own boundary on EVERY
+     *  binder, enforced at this one seam. The other four slots keep their
+     *  latching boundaries. */
+    input?: ReactNode;
+    /** Rendered in place of the row list when the log is genuinely empty.
+     *  Agent mode withholds it until the first snapshot arrives: a settled
+     *  run's fallback states a fact ("recorded no activity"), and stating
+     *  it during the connect window would be a falsehood every mount
+     *  flashes. Unfilled renders nothing — the package's own welcome
+     *  surfaces live a level up (conversation-view), which never mounts a
+     *  transcript while empty. */
+    welcomeScreen?: ReactNode;
+    /** Chrome beside the transcript, above the scroll viewport — never a
+     *  row source. Unfilled renders nothing. DELIBERATELY UNCONSUMED: the
+     *  slot is part of the surface's contract and ships with its filled
+     *  and unfilled tests; the package's ThreadHistory is the intended
+     *  filler. Not scaffolding to delete. */
+    threadList?: ReactNode;
+}
+export interface AgentTranscriptSource extends TranscriptSlotProps {
+    agent: AbstractAgent;
+    /** The stream's failure tap (pre-stream failures, verify errors, and
+     *  RUN_ERROR terminals — including replayed historical ones; the hosts
+     *  absorb those). */
+    onStreamError: (error: Error) => void;
+    /** Module-level composite of the host's marker rows, invoked before
+     *  and after every message block. */
+    markers?: ComponentType<TranscriptMarkerProps>;
+    /** Where the host's marker rows anchor — a marker splits folds and
+     *  delegation groups exactly as a visible row would. Omit ONLY where
+     *  no marker can fall between two delegation moments. */
+    markerBoundaries?: MarkerBoundaries;
+    /** The retry-marker anchor ids alone — never the merged boundary sets
+     *  above, which say nothing about an attempt restart. Tool calls left
+     *  open behind the last of these read severed instead of spinning
+     *  forever. */
+    resumeAnchoredIds?: ReadonlySet<string>;
+    /** The delivery-marker anchor ids — the turn-start boundary for
+     *  machine-initiated delivery turns, which begin with no user
+     *  message. The host's own marker draws the divider; the projection
+     *  renders none (the anchors ride in empty). */
+    deliveryAnchoredIds?: ReadonlySet<string>;
+    /** Each injected user message's attachments keyed by its stable id
+     *  (`user:{turnId}`) — the turn rows' side table; attachments never
+     *  ride the AG-UI Message itself. */
+    turnAttachments?: ReadonlyMap<string, TurnAttachment[]>;
+    /** True when the host's own chrome already states the run's liveness
+     *  for the whole live window (the run viewer's live line). The
+     *  package's standalone trailing claimants then yield in every state —
+     *  MessageList's liveness-ownership rule — so the frame never carries
+     *  two live claims. Content liveness (fold headlines, streaming prose)
+     *  is unaffected. */
+    frameClaimsLiveness?: boolean;
+    rows?: never;
+    cards?: never;
+    live?: never;
+    turnOpen?: never;
+    decisionSurfacesInShelf?: never;
+}
+export interface RowsTranscriptSource extends TranscriptSlotProps {
+    /** The host-projected flat rows (the store path). */
+    rows: readonly TranscriptRow[];
+    cards?: readonly ApprovalCardModel[];
+    live?: boolean;
+    turnOpen?: boolean;
+    decisionSurfacesInShelf?: boolean;
+    agent?: never;
+    onStreamError?: never;
+    markers?: never;
+    markerBoundaries?: never;
+    resumeAnchoredIds?: never;
+    deliveryAnchoredIds?: never;
+    turnAttachments?: never;
+    frameClaimsLiveness?: never;
+}
+export type AssistantTranscriptProps = AgentTranscriptSource | RowsTranscriptSource;
+export declare function AssistantTranscript(props: AssistantTranscriptProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=assistant-transcript.d.ts.map

package/dist/components/assistant-transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-transcript.d.ts","sourceRoot":"","sources":["../../src/components/assistant-transcript.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAIL,KAAK,aAAa,EAElB,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAuCnE,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,aAAa,EACnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC3B,MAAM,mBAAmB,CAAC;AAmB3B,UAAU,mBAAmB;IAC3B;gDAC4C;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;6BAEyB;IACzB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B;;yCAEqC;IACrC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;;;;;;;;;+BAS2B;IAC3B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;;;;kCAM8B;IAC9B,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B;;;;6CAIyC;IACzC,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB;AAED,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,KAAK,EAAE,aAAa,CAAC;IACrB;;yBAEqB;IACrB,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACtC;yCACqC;IACrC,OAAO,CAAC,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;IAC/C;;6DAEyD;IACzD,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC;;;mBAGe;IACf,iBAAiB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACxC;;;oDAGgD;IAChD,mBAAmB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C;;yCAEqC;IACrC,eAAe,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;IACxD;;;;;yBAKqB;IACrB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,uBAAuB,CAAC,EAAE,KAAK,CAAC;CACjC;AAED,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D,qDAAqD;IACrD,IAAI,EAAE,SAAS,aAAa,EAAE,CAAC;IAC/B,KAAK,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACrC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,aAAa,CAAC,EAAE,KAAK,CAAC;IACtB,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,gBAAgB,CAAC,EAAE,KAAK,CAAC;IACzB,iBAAiB,CAAC,EAAE,KAAK,CAAC;IAC1B,mBAAmB,CAAC,EAAE,KAAK,CAAC;IAC5B,eAAe,CAAC,EAAE,KAAK,CAAC;IACxB,mBAAmB,CAAC,EAAE,KAAK,CAAC;CAC7B;AAED,MAAM,MAAM,wBAAwB,GAClC,qBAAqB,GAAG,oBAAoB,CAAC;AAE/C,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,+BAQlE"}

package/dist/components/assistant-transcript.js

@@ -0,0 +1,200 @@
+"use client";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo, useState, } from "react";
+import { hostFillDeclines } from "../core/host-fill.js";
+import { connectionErrorRecorder, messagesSnapshotRecorder, } from "../core/messages-cell.js";
+import { EMPTY_TOOL_CALL_DISPLAY_ANCHORS, toolCallDisplayRecorder, withToolCallDisplayAnchored, } from "../core/tool-call-display-anchors.js";
+import { EMPTY_TOOL_CANCEL_ANCHORS, toolCancelRecorder, withToolCancelAnchored, } from "../core/tool-cancel-anchors.js";
+import { EMPTY_TOOL_ERROR_ANCHORS, toolErrorRecorder, withToolErrorAnchored, } from "../core/tool-error-anchors.js";
+import { EMPTY_TOOL_OFFLOAD_ANCHORS, toolOffloadRecorder, withToolOffloadAnchored, } from "../core/tool-offload-anchors.js";
+import { EMPTY_TOOL_DENIAL_LEDGER, toolDenialRecorder, withToolDenialMarkerFolded, } from "../core/tool-denial-anchors.js";
+import { EMPTY_TOOL_REFUSAL_ANCHORS, toolRefusalRecorder, withToolRefusalAnchored, } from "../core/tool-refusal-anchors.js";
+import { transcriptBlocksOf, } from "../core/transcript-rows.js";
+import { MessageList, } from "./message-list.js";
+import { HostSlotBoundary } from "./slot-boundary.js";
+import { useLatestRef } from "./use-latest-ref.js";
+export function AssistantTranscript(props) {
+    // Two internal components so each mode's hook list stays static;
+    // switching source kinds remounts, which is the honest lifecycle (an
+    // agent-mode mount owns a connection the rows mode never opened).
+    if (props.agent !== undefined) {
+        return _jsx(AgentModeTranscript, { ...props });
+    }
+    return _jsx(RowsModeTranscript, { ...props });
+}
+const EMPTY_SNAPSHOT = { messages: [], running: false };
+const NO_CARDS = [];
+const NO_IDS = new Set();
+// The anchor families this surface has no recorder for (the ./transcript
+// entry's scope note): passable empty by design — absent facts degrade
+// the rows honestly (no timing → "Worked", no memory attribution → no
+// footer), never crash.
+const NO_MAP = new Map();
+/** A recorder callback that folds its arguments into an anchor map:
+ *  `setter(previous => merge(previous, ...args))`, typed once for the
+ *  five anchor families the transcript records. */
+function anchorInto(setter, merge) {
+    return (...args) => {
+        setter((previous) => merge(previous, ...args));
+    };
+}
+/** The connection agent mode owns — recorders subscribed before connect,
+ *  unsubscribe-then-abort on teardown — and the snapshot and anchor maps
+ *  those recorders publish. */
+function useAgentRecording(agent, onStreamError) {
+    // Null until the recorder publishes its first snapshot — even an empty
+    // settled log delivers one (the synthesized RUN_STARTED), so null means
+    // exactly "still connecting" and gates the welcome screen.
+    const [snapshot, setSnapshot] = useState(null);
+    // Anchor maps for wire facts the message list does not carry as such:
+    // backend-authored display copy rides CUSTOM markers, never a message,
+    // and the tool-outcome extras reach agent.messages only as lifted
+    // metadata (core/tool-outcome.ts) — the recorders keep these maps as the
+    // read path, stable across remounts. First-wins merges return the
+    // previous map by identity on replayed re-delivery, so StrictMode reruns
+    // and reconnect replays no-op these setStates.
+    const [displayAnchors, setDisplayAnchors] = useState(EMPTY_TOOL_CALL_DISPLAY_ANCHORS);
+    const [errorAnchors, setErrorAnchors] = useState(EMPTY_TOOL_ERROR_ANCHORS);
+    const [cancelAnchors, setCancelAnchors] = useState(EMPTY_TOOL_CANCEL_ANCHORS);
+    // The offload stamp: an offloaded result's content is the offloader's
+    // model-facing replacement, not the tool's output — without this set
+    // the row would render that replacement as if the tool had said it.
+    const [offloadAnchors, setOffloadAnchors] = useState(EMPTY_TOOL_OFFLOAD_ANCHORS);
+    // The refusal signal: a door that answered and declined stamps
+    // `refused` (a sentence) INSTEAD of `error`, so a surface reading only
+    // `error` would render the refusal as a clean success whose Result pane
+    // shows the refusal envelope — and group a refused dispatch as a
+    // coworker that ran.
+    const [refusalAnchors, setRefusalAnchors] = useState(EMPTY_TOOL_REFUSAL_ANCHORS);
+    // The denial ledger: a member's denial reaches the wire as a
+    // `cancelled` result, so a surface reading only the cancel stamp
+    // renders it "Interrupted". The ledger joins approval_requested to
+    // approval_resolved{approved:false} by interrupt id; only its DENIED
+    // half reaches the snapshot, and the fold returns the same object when
+    // nothing changed, so replays no-op this setState too.
+    const [denialLedger, setDenialLedger] = useState(EMPTY_TOOL_DENIAL_LEDGER);
+    // The error tap rides a ref so a host handing a fresh closure per
+    // render never tears the connection down and replays it.
+    const streamErrorRef = useLatestRef(onStreamError);
+    useEffect(() => {
+        // Subscribe before connect: the recorders must see the replay's
+        // first event. Sibling recorder components (markers, approvals)
+        // render before this component in the hosts, so their effects — and
+        // therefore their subscriptions — run earlier still.
+        const taps = [
+            agent.subscribe(messagesSnapshotRecorder(setSnapshot)),
+            agent.subscribe(connectionErrorRecorder((error) => {
+                streamErrorRef.current(error);
+            })),
+            agent.subscribe(toolCallDisplayRecorder(anchorInto(setDisplayAnchors, withToolCallDisplayAnchored))),
+            agent.subscribe(toolErrorRecorder(anchorInto(setErrorAnchors, withToolErrorAnchored))),
+            agent.subscribe(toolCancelRecorder(anchorInto(setCancelAnchors, withToolCancelAnchored))),
+            agent.subscribe(toolOffloadRecorder(anchorInto(setOffloadAnchors, withToolOffloadAnchored))),
+            agent.subscribe(toolRefusalRecorder(anchorInto(setRefusalAnchors, withToolRefusalAnchored))),
+            agent.subscribe(toolDenialRecorder(anchorInto(setDenialLedger, withToolDenialMarkerFolded))),
+        ];
+        // The recorder carries connection failures (onRunFailed); the
+        // rejection here would only duplicate it.
+        agent.connectAgent().catch(() => undefined);
+        return () => {
+            // Unsubscribe BEFORE aborting: the teardown's own synthesized
+            // abort RUN_ERROR must never reach the error tap or repaint the
+            // message state.
+            for (const tap of taps) {
+                tap.unsubscribe();
+            }
+            agent.abortRun();
+            void agent.detachActiveRun().catch(() => undefined);
+        };
+    }, [agent, streamErrorRef]);
+    return {
+        snapshot,
+        displayAnchors,
+        errorAnchors,
+        cancelAnchors,
+        offloadAnchors,
+        refusalAnchors,
+        denialLedger,
+    };
+}
+function AgentModeTranscript({ agent, onStreamError, markers, markerBoundaries, resumeAnchoredIds = NO_IDS, deliveryAnchoredIds = NO_IDS, turnAttachments, frameClaimsLiveness, scrollClassName, messageView, toolRow, input, welcomeScreen, threadList, }) {
+    const { snapshot, displayAnchors, errorAnchors, cancelAnchors, offloadAnchors, refusalAnchors, denialLedger, } = useAgentRecording(agent, onStreamError);
+    const delivered = snapshot ?? EMPTY_SNAPSHOT;
+    // Where each declared value lands is enumerated in
+    // docs/transcript-surfaces.md, "The agent binder's declared values".
+    // The arms easiest to get wrong: deliveryAnchoredIds feeds BOTH the
+    // severance scan (presence-based) and MessageList's turnStartIds (the
+    // fold pass is ROW-based, so the empty arrays do not suffice);
+    // turnAttachments → transcriptBlocksOf's side-table join only;
+    // scrollClassName, the five slots → render only.
+    const anchors = useMemo(() => ({
+        // Presence drives the severance window; the payload is the host's
+        // marker state, not the projection's to read.
+        resumeAnchors: new Map([...resumeAnchoredIds].map((id) => [id, null])),
+        // Empty on purpose: a boundary without a row — the host's own
+        // marker draws the divider, so a projected one would double it (the
+        // row guard is `results.length > 0`). Every consumer that must see
+        // the delivery boundary reads the anchor MAP's keys or an explicit
+        // id set (the severance scan, the turnStartIds below); only the
+        // divider ROW rides the array length — the one thing suppressed.
+        subagentDeliveryAnchors: new Map([...deliveryAnchoredIds].map((id) => [id, []])),
+        toolErrorAnchors: errorAnchors,
+        toolCancelAnchors: cancelAnchors,
+        toolRefusalAnchors: refusalAnchors,
+        // The ledger's presentation half only; the ask map stays
+        // in the fold's own state.
+        toolDenialAnchors: denialLedger.denied,
+        toolCallDisplayAnchors: displayAnchors,
+        turnFailedAnchors: NO_MAP,
+        toolOffloadAnchors: offloadAnchors,
+        toolSchemaAnchors: NO_MAP,
+        blockTimingAnchors: NO_MAP,
+        turnUsageAnchors: NO_MAP,
+        memoryProvenanceAnchors: NO_MAP,
+        memoryAttributionAnchors: NO_MAP,
+    }), [
+        resumeAnchoredIds,
+        deliveryAnchoredIds,
+        errorAnchors,
+        cancelAnchors,
+        offloadAnchors,
+        refusalAnchors,
+        denialLedger.denied,
+        displayAnchors,
+    ]);
+    // Memoized on the snapshot AND the marker boundaries: marker positions
+    // are part of the block derivation (they split delegation groups), so
+    // a newly anchored marker legitimately re-runs the dedupe — a rare
+    // event, anchors move a handful of times per run.
+    const blocks = useMemo(() => transcriptBlocksOf(delivered.messages, anchors, delivered.running, undefined, {
+        markerBoundaries,
+        attachmentsByMessageId: turnAttachments,
+    }), [delivered, anchors, markerBoundaries, turnAttachments]);
+    const showWelcome = _welcomeMomentOf(snapshot, blocks.length, welcomeScreen);
+    return (_jsx(TranscriptFrame, { threadList: threadList, input: input, children: _jsx(MessageList, { blocks: blocks, cards: NO_CARDS, turnStartIds: deliveryAnchoredIds, 
+            // The dashboard wire has no turn-status cell: the snapshot's
+            // running bit is this surface's one liveness fact, so it carries
+            // both the live register and the open-tail fold regime.
+            live: delivered.running, turnOpen: delivered.running, markers: markers, markerBoundaries: markerBoundaries, frameClaimsLiveness: frameClaimsLiveness, scrollClassName: scrollClassName, messageView: messageView, toolRow: toolRow, emptyFallback: showWelcome ? (_jsx(HostSlotBoundary, { slot: "welcomeScreen", fallback: null, children: welcomeScreen })) : undefined }) }));
+}
+/** The welcome screen's moment: a connected, genuinely empty log with a
+ *  host welcome to show (agent mode waits for the first snapshot). */
+function _welcomeMomentOf(snapshot, blockCount, welcomeScreen) {
+    return (snapshot !== null && blockCount === 0 && !hostFillDeclines(welcomeScreen));
+}
+function RowsModeTranscript({ rows, cards = NO_CARDS, live, turnOpen, decisionSurfacesInShelf, scrollClassName, messageView, toolRow, input, welcomeScreen, threadList, }) {
+    const showWelcome = rows.length === 0 && !hostFillDeclines(welcomeScreen);
+    return (_jsx(TranscriptFrame, { threadList: threadList, input: input, children: _jsx(MessageList, { rows: rows, cards: cards, live: live, turnOpen: turnOpen, decisionSurfacesInShelf: decisionSurfacesInShelf, scrollClassName: scrollClassName, messageView: messageView, toolRow: toolRow, emptyFallback: showWelcome ? (_jsx(HostSlotBoundary, { slot: "welcomeScreen", fallback: null, children: welcomeScreen })) : undefined }) }));
+}
+/** The frame — a fragment, never a box: chrome above the log inside its
+ *  slot boundary, the input region below it deliberately unbounded (the
+ *  input-region rule above — a throw propagates to the host's own
+ *  boundary), each absent from the DOM entirely when unfilled. */
+function TranscriptFrame({ threadList, input, children, }) {
+    return (_jsxs(_Fragment, { children: [!hostFillDeclines(threadList) ? (
+            // The chrome hook div rides INSIDE the boundary (the keying law): it
+            // exists to be host-styled, so a latched-away fill takes it along
+            // rather than leave an empty strip wearing the host's padding.
+            _jsx(HostSlotBoundary, { slot: "threadList", fallback: null, children: _jsx("div", { "data-tf-transcript-chrome": "", children: threadList }) })) : null, children, input ?? null] }));
+}
+//# sourceMappingURL=assistant-transcript.js.map

package/dist/components/assistant-transcript.js.map

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

package/dist/components/attachment-chips.d.ts

@@ -0,0 +1,5 @@
+import type { TurnAttachment } from "../contract/threads.js";
+export declare function AttachmentChips({ attachments, }: {
+    attachments: readonly TurnAttachment[];
+}): import("react").JSX.Element | null;
+//# sourceMappingURL=attachment-chips.d.ts.map

package/dist/components/attachment-chips.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-chips.d.ts","sourceRoot":"","sources":["../../src/components/attachment-chips.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAY7D,wBAAgB,eAAe,CAAC,EAC9B,WAAW,GACZ,EAAE;IACD,WAAW,EAAE,SAAS,cAAc,EAAE,CAAC;CACxC,sCAeA"}

package/dist/components/attachment-chips.js

@@ -0,0 +1,84 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { humanFileSize } from "./human-file-size.js";
+import { FileIcon } from "./icons.js";
+import { useOptionalAssistantSession } from "./teaflask-assistant-provider.js";
+// A user message's attachments, the quiet register: images render inline
+// (an inset hairline contains uncontrolled customer imagery on any
+// ground — the org-logo law), everything else is a small muted chip
+// naming the file. Bytes are a download-url exchange away: the id is
+// stable, a URL is minted on mount and re-minted as it expires — a
+// widget stays open far longer than a URL lives, and nothing persists.
+export function AttachmentChips({ attachments, }) {
+    if (attachments.length === 0) {
+        return null;
+    }
+    return (_jsx("div", { className: "tf:flex tf:flex-wrap tf:justify-end tf:gap-2", children: attachments.map((attachment) => attachment.kind === "image" ? (_jsx(AttachmentImage, { attachment: attachment }, attachment.id)) : (_jsx(FileChip, { attachment: attachment }, attachment.id))) }));
+}
+function AttachmentImage({ attachment }) {
+    const url = useAttachmentUrl(attachment.id);
+    if (url === null) {
+        // The mint is in flight (or refused — a swept upload): the chip is
+        // the truthful fallback either way, and the image swaps in if the
+        // URL lands.
+        return _jsx(FileChip, { attachment: attachment });
+    }
+    return (_jsx("img", { src: url, alt: attachment.filename, loading: "lazy", className: "tf:max-h-48 tf:max-w-full tf:rounded-lg tf:ring-1 tf:ring-tf-border tf:ring-inset" }));
+}
+function FileChip({ attachment }) {
+    return (_jsxs("span", { className: "tf:inline-flex tf:max-w-full tf:items-center tf:gap-1.5 tf:rounded-lg " +
+            "tf:bg-tf-background tf:px-2.5 tf:py-1.5 tf:text-xs tf:text-tf-foreground " +
+            "tf:ring-1 tf:ring-tf-border tf:ring-inset", title: attachment.filename, children: [_jsx("span", { className: "tf:text-tf-muted-foreground", children: _jsx(FileIcon, {}) }), _jsx("span", { className: "tf:min-w-0 tf:truncate", children: attachment.filename }), _jsx("span", { className: "tf:shrink-0 tf:text-tf-muted-foreground", children: humanFileSize(attachment.byte_size) })] }));
+}
+// The fastest the hook ever goes back to the mint endpoint: the retry
+// delay after a blipped refresh, and the floor under the expiry timer —
+// a served TTL at or under the store's safety margin puts the expiry in
+// the past, which must slow the cadence, never become a tight loop.
+const URL_REFRESH_FLOOR_MS = 30_000;
+function useAttachmentUrl(attachmentId) {
+    const session = useOptionalAssistantSession();
+    const store = session?.store ?? null;
+    const [url, setUrl] = useState(null);
+    useEffect(() => {
+        if (store === null) {
+            return;
+        }
+        let cancelled = false;
+        let timer;
+        const mintAndScheduleRefresh = (isRefresh) => {
+            store.mintAttachmentDownloadUrl(attachmentId).then((minted) => {
+                if (cancelled) {
+                    return;
+                }
+                setUrl(minted.url);
+                // The URL dies at its short TTL while this mount may live for
+                // hours: re-mint as the expiry lands, so a lazy <img> that
+                // fetches late never holds an expired URL.
+                timer = setTimeout(() => {
+                    mintAndScheduleRefresh(true);
+                }, Math.max(URL_REFRESH_FLOOR_MS, minted.expiresAtMs - Date.now()));
+            }, () => {
+                if (cancelled) {
+                    return;
+                }
+                // A refused first mint (a swept upload) keeps the chip
+                // fallback — decoration never surfaces an error. A refused
+                // refresh is a blip on a URL that already worked: try again,
+                // or the image freezes on an expired URL.
+                if (isRefresh) {
+                    timer = setTimeout(() => {
+                        mintAndScheduleRefresh(true);
+                    }, URL_REFRESH_FLOOR_MS);
+                }
+            });
+        };
+        mintAndScheduleRefresh(false);
+        return () => {
+            cancelled = true;
+            clearTimeout(timer);
+        };
+    }, [store, attachmentId]);
+    return url;
+}
+//# sourceMappingURL=attachment-chips.js.map

package/dist/components/attachment-chips.js.map

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

package/dist/components/child-transcript.d.ts

@@ -0,0 +1,36 @@
+import { type ReactNode } from "react";
+type ChildStatus = "running" | "failed" | "finished";
+export declare function ChildTranscriptPanel({ threadId, childSessionId, variantIndex, opener, onBack, }: {
+    threadId: string;
+    childSessionId: string;
+    /** The coworker's deterministic color slot (coworkerIndicesOf) — the host
+     *  passes it so the panel wears the same variant as the row that
+     *  opened it; absent metadata disappears cleanly. */
+    variantIndex?: number;
+    /** The element Back restores focus to, captured by the host INSIDE the
+     *  opening click — before the commit that inerts the conversation box
+     *  blurs it to <body> (the floating-panel ordering; no effect, layout
+     *  or passive, runs early enough to capture it here). */
+    opener: HTMLElement | null;
+    onBack: () => void;
+}): import("react").JSX.Element;
+/** A compact read-only scan of the same child stream. It is mounted only
+ * while its roster row is hovered, focused, or tapped, so opening the
+ * roster itself remains a ledger-only operation. */
+export declare function ChildTranscriptPreview({ threadId, childSessionId, variantIndex, }: {
+    threadId: string;
+    childSessionId: string;
+    variantIndex?: number;
+}): import("react").JSX.Element;
+/** The preview's deterministic presentation shell, exported for the
+ * package's screenshot fixture. Production fills it with the live child
+ * driver below; the fixture fills it with canned transcript rows. */
+export declare function ChildTranscriptPreviewFrame({ label, status, duration, variantIndex, children, }: {
+    label: string;
+    status: ChildStatus;
+    duration?: string | null;
+    variantIndex?: number;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=child-transcript.d.ts.map

package/dist/components/child-transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-transcript.d.ts","sourceRoot":"","sources":["../../src/components/child-transcript.tsx"],"names":[],"mappings":"AAaA,OAAO,EAKL,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AAwBf,KAAK,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;AAErD,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,MAAM,EACN,MAAM,GACP,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB;;yDAEqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;6DAGyD;IACzD,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,+BAWA;AAED;;oDAEoD;AACpD,wBAAgB,sBAAsB,CAAC,EACrC,QAAQ,EACR,cAAc,EACd,YAAY,GACb,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,+BAWA;AAED;;qEAEqE;AACrE,wBAAgB,2BAA2B,CAAC,EAC1C,KAAK,EACL,MAAM,EACN,QAAQ,EACR,YAAY,EACZ,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,SAAS,CAAC;CACrB,+BAsDA"}