@teaflask/assistant 0.0.0 → 0.3.0

package/dist/components/use-answer-list-fold.d.ts

@@ -0,0 +1,7 @@
+import { type RefObject } from "react";
+export declare function useAnswerListFold(cursor: number, openDescription: string | null, customText: string): {
+    answersRef: RefObject<HTMLDivElement | null>;
+    foldBelow: boolean;
+    declareFold: () => void;
+};
+//# sourceMappingURL=use-answer-list-fold.d.ts.map

package/dist/components/use-answer-list-fold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-answer-list-fold.d.ts","sourceRoot":"","sources":["../../src/components/use-answer-list-fold.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAKf,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,GAAG,IAAI,EAC9B,UAAU,EAAE,MAAM,GACjB;IACD,UAAU,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC7C,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB,CA4BA"}

package/dist/components/use-answer-list-fold.js

@@ -0,0 +1,35 @@
+"use client";
+import { useCallback, useEffect, useRef, useState, } from "react";
+// The fold cue: the answer list is the panel's one scroller under the
+// well's height budget, so it declares when rows sit below the fold
+// (the Scroll-Well Rule) — re-measured on scroll and on content growth.
+export function useAnswerListFold(cursor, openDescription, customText) {
+    const [foldBelow, setFoldBelow] = useState(false);
+    const answersRef = useRef(null);
+    const declareFold = useCallback(() => {
+        const list = answersRef.current;
+        if (list === null) {
+            return;
+        }
+        const overflowing = list.scrollHeight > list.clientHeight + 1;
+        const atEnd = list.scrollTop + list.clientHeight >= list.scrollHeight - 4;
+        setFoldBelow(overflowing && !atEnd);
+    }, []);
+    useEffect(() => {
+        declareFold();
+        const list = answersRef.current;
+        if (list === null || typeof ResizeObserver === "undefined") {
+            return;
+        }
+        const observer = new ResizeObserver(declareFold);
+        observer.observe(list);
+        for (const child of list.children) {
+            observer.observe(child);
+        }
+        return () => {
+            observer.disconnect();
+        };
+    }, [declareFold, cursor, openDescription, customText]);
+    return { answersRef, foldBelow, declareFold };
+}
+//# sourceMappingURL=use-answer-list-fold.js.map

package/dist/components/use-answer-list-fold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-answer-list-fold.js","sourceRoot":"","sources":["../../src/components/use-answer-list-fold.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EACL,WAAW,EACX,SAAS,EACT,MAAM,EACN,QAAQ,GAET,MAAM,OAAO,CAAC;AAEf,sEAAsE;AACtE,oEAAoE;AACpE,wEAAwE;AACxE,MAAM,UAAU,iBAAiB,CAC/B,MAAc,EACd,eAA8B,EAC9B,UAAkB;IAMlB,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE;QACnC,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC;QAChC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QAC1E,YAAY,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,SAAS,CAAC,GAAG,EAAE;QACb,WAAW,EAAE,CAAC;QACd,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC;QAChC,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,cAAc,KAAK,WAAW,EAAE,CAAC;YAC3D,OAAO;QACT,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,WAAW,CAAC,CAAC;QACjD,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;QACD,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC,CAAC;IACvD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;AAChD,CAAC"}

package/dist/components/use-assistant-activity.d.ts

@@ -0,0 +1,11 @@
+import type { AssistantActivitySnapshot } from "../core/activity.js";
+/**
+ * The read-only activity feed of the shared conversation core: enough to
+ * render presence — a busy pulse, a pending-approval badge, the last
+ * result — without mounting (or bundling) the transcript. Any component
+ * under <TeaflaskAssistantProvider> may subscribe; the feed reads the
+ * same store every chrome writes through, so a turn started in the page
+ * pulses here too.
+ */
+export declare function useAssistantActivity(): AssistantActivitySnapshot;
+//# sourceMappingURL=use-assistant-activity.d.ts.map

package/dist/components/use-assistant-activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-assistant-activity.d.ts","sourceRoot":"","sources":["../../src/components/use-assistant-activity.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAIrE;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,IAAI,yBAAyB,CAGhE"}

package/dist/components/use-assistant-activity.js

@@ -0,0 +1,16 @@
+"use client";
+import { useAssistantSession } from "./teaflask-assistant-provider.js";
+import { useCell } from "./use-store-cell.js";
+/**
+ * The read-only activity feed of the shared conversation core: enough to
+ * render presence — a busy pulse, a pending-approval badge, the last
+ * result — without mounting (or bundling) the transcript. Any component
+ * under <TeaflaskAssistantProvider> may subscribe; the feed reads the
+ * same store every chrome writes through, so a turn started in the page
+ * pulses here too.
+ */
+export function useAssistantActivity() {
+    const { store } = useAssistantSession();
+    return useCell(store.activity);
+}
+//# sourceMappingURL=use-assistant-activity.js.map

package/dist/components/use-assistant-activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-assistant-activity.js","sourceRoot":"","sources":["../../src/components/use-assistant-activity.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,EAAE,KAAK,EAAE,GAAG,mBAAmB,EAAE,CAAC;IACxC,OAAO,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC"}

package/dist/components/use-assistant-conversation.d.ts

@@ -0,0 +1,32 @@
+import type { ServingAssistantThread } from "../contract/threads.js";
+import type { ActiveConversation, ComposerContract } from "../core/conversation-store.js";
+import type { PendingDecisionGap } from "../core/pending-decision-gap.js";
+import type { ServingApiError } from "../transport/serving-error.js";
+/** The surface-facing view of the shared conversation core — exactly what
+ *  the chromes render, nothing the store keeps to itself. */
+export interface AssistantConversation {
+    setupError: ServingApiError | null;
+    conversation: ActiveConversation | null;
+    threads: ServingAssistantThread[];
+    historyExpected: boolean;
+    threadOpening: boolean;
+    reconnectNonce: number;
+    composerContract: ComposerContract;
+    sendError: string | null;
+    turnFailure: string | null;
+    showInterruptionBanner: boolean;
+    pendingDecisionGap: PendingDecisionGap | null;
+    retryStream: () => void;
+    refreshConversation: () => Promise<void>;
+    openThread: (thread: ServingAssistantThread) => void;
+    startNewConversation: () => void;
+    resumeStoredThread: () => void;
+}
+/**
+ * The React binding of the shared conversation store: every mounted
+ * surface subscribing here reads the SAME store — one thread, one resume
+ * state, one send path — so surfaces are pure chrome over one live
+ * conversation. The engine itself lives in core/conversation-store.
+ */
+export declare function useAssistantConversation(): AssistantConversation;
+//# sourceMappingURL=use-assistant-conversation.d.ts.map

package/dist/components/use-assistant-conversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-assistant-conversation.d.ts","sourceRoot":"","sources":["../../src/components/use-assistant-conversation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAIrE;6DAC6D;AAC7D,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;IACnC,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACxC,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,sBAAsB,EAAE,OAAO,CAAC;IAIhC,kBAAkB,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC9C,WAAW,EAAE,MAAM,IAAI,CAAC;IAGxB,mBAAmB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,UAAU,EAAE,CAAC,MAAM,EAAE,sBAAsB,KAAK,IAAI,CAAC;IACrD,oBAAoB,EAAE,MAAM,IAAI,CAAC;IAIjC,kBAAkB,EAAE,MAAM,IAAI,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,qBAAqB,CAuBhE"}

package/dist/components/use-assistant-conversation.js

@@ -0,0 +1,33 @@
+"use client";
+import { useAssistantSession } from "./teaflask-assistant-provider.js";
+import { useCell } from "./use-store-cell.js";
+/**
+ * The React binding of the shared conversation store: every mounted
+ * surface subscribing here reads the SAME store — one thread, one resume
+ * state, one send path — so surfaces are pure chrome over one live
+ * conversation. The engine itself lives in core/conversation-store.
+ */
+export function useAssistantConversation() {
+    const { setupError, store } = useAssistantSession();
+    const conversation = useCell(store.conversation);
+    const composerContract = useCell(store.composer);
+    return {
+        setupError,
+        conversation: conversation.active,
+        threads: conversation.threads,
+        historyExpected: conversation.historyExpected,
+        threadOpening: conversation.threadOpening,
+        reconnectNonce: conversation.reconnectNonce,
+        composerContract,
+        sendError: conversation.sendError,
+        turnFailure: conversation.turnFailure,
+        showInterruptionBanner: conversation.showInterruptionBanner,
+        pendingDecisionGap: conversation.pendingDecisionGap,
+        retryStream: store.retryStream,
+        refreshConversation: store.refreshConversation,
+        openThread: store.openThread,
+        startNewConversation: store.startNewConversation,
+        resumeStoredThread: store.resumeStoredThread,
+    };
+}
+//# sourceMappingURL=use-assistant-conversation.js.map

package/dist/components/use-assistant-conversation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-assistant-conversation.js","sourceRoot":"","sources":["../../src/components/use-assistant-conversation.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AASb,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AA+B9C;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB;IACtC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,mBAAmB,EAAE,CAAC;IACpD,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACjD,MAAM,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEjD,OAAO;QACL,UAAU;QACV,YAAY,EAAE,YAAY,CAAC,MAAM;QACjC,OAAO,EAAE,YAAY,CAAC,OAAO;QAC7B,eAAe,EAAE,YAAY,CAAC,eAAe;QAC7C,aAAa,EAAE,YAAY,CAAC,aAAa;QACzC,cAAc,EAAE,YAAY,CAAC,cAAc;QAC3C,gBAAgB;QAChB,SAAS,EAAE,YAAY,CAAC,SAAS;QACjC,WAAW,EAAE,YAAY,CAAC,WAAW;QACrC,sBAAsB,EAAE,YAAY,CAAC,sBAAsB;QAC3D,kBAAkB,EAAE,YAAY,CAAC,kBAAkB;QACnD,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;QAC9C,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;QAChD,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;KAC7C,CAAC;AACJ,CAAC"}

package/dist/components/use-assistant-surface-presence.d.ts

@@ -0,0 +1,3 @@
+import { type AssistantSurfacePresence } from "../core/surface-registry.js";
+export declare function useAssistantSurfacePresence(): AssistantSurfacePresence;
+//# sourceMappingURL=use-assistant-surface-presence.d.ts.map

package/dist/components/use-assistant-surface-presence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-assistant-surface-presence.d.ts","sourceRoot":"","sources":["../../src/components/use-assistant-surface-presence.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,6BAA6B,CAAC;AAOrC,wBAAgB,2BAA2B,IAAI,wBAAwB,CAMtE"}

package/dist/components/use-assistant-surface-presence.js

@@ -0,0 +1,11 @@
+"use client";
+import { useSyncExternalStore } from "react";
+import { assistantSurfaceRegistry, } from "../core/surface-registry.js";
+// Arrow wrappers on purpose: the registry's methods are instance
+// methods, and useSyncExternalStore calls what it's given unbound. The
+// registry never registers on the server, so the live getter doubles as
+// the server snapshot (the frozen all-false presence).
+export function useAssistantSurfacePresence() {
+    return useSyncExternalStore((listener) => assistantSurfaceRegistry.subscribe(listener), () => assistantSurfaceRegistry.getSnapshot(), () => assistantSurfaceRegistry.getSnapshot());
+}
+//# sourceMappingURL=use-assistant-surface-presence.js.map

package/dist/components/use-assistant-surface-presence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-assistant-surface-presence.js","sourceRoot":"","sources":["../../src/components/use-assistant-surface-presence.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,EACL,wBAAwB,GAEzB,MAAM,6BAA6B,CAAC;AAErC,iEAAiE;AACjE,uEAAuE;AACvE,wEAAwE;AACxE,uDAAuD;AAEvD,MAAM,UAAU,2BAA2B;IACzC,OAAO,oBAAoB,CACzB,CAAC,QAAQ,EAAE,EAAE,CAAC,wBAAwB,CAAC,SAAS,CAAC,QAAQ,CAAC,EAC1D,GAAG,EAAE,CAAC,wBAAwB,CAAC,WAAW,EAAE,EAC5C,GAAG,EAAE,CAAC,wBAAwB,CAAC,WAAW,EAAE,CAC7C,CAAC;AACJ,CAAC"}

package/dist/components/use-child-replay-stream.d.ts

@@ -0,0 +1,21 @@
+import type { Message } from "@ag-ui/core";
+import { type ThreadDispatch } from "../contract/dispatches.js";
+import type { MarkerAnchorsSnapshot } from "../core/connection-epoch.js";
+import type { TokenSession } from "../transport/token-session.js";
+type ChildStreamEnd = "open" | "clean" | "error";
+interface ChildReplayStream {
+    messages: readonly Message[];
+    streamEnd: ChildStreamEnd;
+    tailed: boolean;
+    slotDenied: boolean;
+    anchors: MarkerAnchorsSnapshot;
+    retry: () => void;
+}
+export declare function useChildReplayStream({ session, threadId, childSessionId, refreshLedger, }: {
+    session: TokenSession;
+    threadId: string;
+    childSessionId: string;
+    refreshLedger: () => Promise<ThreadDispatch | undefined>;
+}): ChildReplayStream;
+export {};
+//# sourceMappingURL=use-child-replay-stream.d.ts.map

package/dist/components/use-child-replay-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-child-replay-stream.d.ts","sourceRoot":"","sources":["../../src/components/use-child-replay-stream.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAa3C,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAKnC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAkBzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAqElE,KAAK,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAEjD,UAAU,iBAAiB;IACzB,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,SAAS,EAAE,cAAc,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,qBAAqB,CAAC;IAC/B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,wBAAgB,oBAAoB,CAAC,EACnC,OAAO,EACP,QAAQ,EACR,cAAc,EACd,aAAa,GACd,EAAE;IACD,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;CAC1D,GAAG,iBAAiB,CAiGpB"}

package/dist/components/use-child-replay-stream.js

@@ -0,0 +1,331 @@
+"use client";
+import { useEffect, useId, useMemo, useRef, useState, useSyncExternalStore, } from "react";
+import { dispatchHasSettled, } from "../contract/dispatches.js";
+import { blockTimingRecorder, foldBlockTimingObserved, } from "../core/block-timing-anchors.js";
+import { messagesRecorder, streamErrorRecorder, } from "../core/messages-cell.js";
+import { TailSlotPool } from "../core/tail-slot-pool.js";
+import { toolCancelRecorder, withToolCancelAnchored, } from "../core/tool-cancel-anchors.js";
+import { toolErrorRecorder, withToolErrorAnchored, } from "../core/tool-error-anchors.js";
+import { ServingReplayStreamAgent } from "../transport/replay-stream-agent.js";
+import { streamUrlForChild } from "../transport/serving-api.js";
+import { resumeMarkerRecorder } from "../transport/stream-resume.js";
+// A child's log carries no THREAD markers — turn-level receipts are the
+// parent conversation's story. Tool errors and cancellations are
+// different: per-tool-call wire facts any run emits, recorded live below
+// so an errored search reads output-error, never a clean result. Resume
+// markers are the child's own too: a retried run activity writes
+// run_resumed under the CHILD's session id, and without the anchor the
+// severed attempt's open calls would read as running forever. Display
+// annotations stay empty deliberately: children run the worker's
+// toolbelt, not the client's annotated tools.
+const THREADLESS_ANCHORS = {
+    turnFailedAnchors: new Map(),
+    subagentDeliveryAnchors: new Map(),
+    toolCallDisplayAnchors: new Map(),
+    // Schema anchors stay empty deliberately, the same law as the
+    // display annotations above: children run the worker's toolbelt (no
+    // display hook, so no tool_call_annotated markers) and render no
+    // approval cards, so a live recorder here would be dead code.
+    toolSchemaAnchors: new Map(),
+    // Offload anchors stay empty deliberately, like display annotations:
+    // children run bespoke subagent harnesses that never mount the context
+    // offloader (only the agent/v1 compiler produces context "auto"), so a
+    // live recorder here would be dead code.
+    toolOffloadAnchors: new Set(),
+    // Refusal anchors stay empty deliberately: the doors that refuse (the
+    // subagent family) never extend a child's belt — a child never
+    // dispatches, parks, or queries — so a live recorder here would be
+    // dead code, like the offload tap above.
+    toolRefusalAnchors: new Map(),
+    // Decision anchors stay empty deliberately: a coworker's thread
+    // carries no member decisions — approvals and asks pause the PARENT
+    // turn, and their cards anchor to the parent's calls — so no decision
+    // marker can name a child call and no hold can go unheld here. Stated
+    // explicitly even though the snapshot field is optional (optional for
+    // the ./transcript composition surface's additivity): this ledger
+    // records a decision per family, and an omission reads as an
+    // oversight where an empty value reads as a ruling.
+    toolDecisionAnchors: new Set(),
+    // Denial anchors stay empty for the same reason: with no approval
+    // ever anchored to a child call, no member can decline one — the same
+    // ruling as the decision line above, recorded rather than omitted.
+    toolDenialAnchors: new Set(),
+    // Usage and provenance anchors stay empty: the drill-in panel renders
+    // no usage or provenance rows of its own — the parent transcript owns
+    // those reads. Block timing is different: the panel's run folds render
+    // "Worked for …" from it, so a live recorder folds it below beside the
+    // error/cancel taps.
+    turnUsageAnchors: new Map(),
+    memoryProvenanceAnchors: new Map(),
+    memoryAttributionAnchors: new Map(),
+};
+// The page-wide child-stream budget: ONE live child tail beside the parent
+// stream and the 10s dispatches poll — under the browser's six-per-origin
+// cap. Module-scoped: the budget is the origin's. The pool QUEUES, it never
+// evicts: hosts mount ONE preview at a time, so switching cards UNMOUNTS the
+// previous preview — its cleanup unsubscribes every tap BEFORE abortRun(),
+// so a handoff never reaches the error funnel — and an overlapping second
+// host waits its turn. Capacity 1 stands: cards are ROWS fed by the one open
+// stream, not streams.
+const CHILD_TAIL_SLOTS = new TailSlotPool(1);
+export function useChildReplayStream({ session, threadId, childSessionId, refreshLedger, }) {
+    // ONE fact drives every flag below: how this panel's stream ended. The
+    // end-state table, the QUIET-ending rule (a body closing with no
+    // terminal is a dropped connection; REST is the authority, judged ONCE
+    // and LATCHED) and the UNREAD row (only an affirmative
+    // dispatchHasSettled reads clean) are in docs/transcript-surfaces.md,
+    // "The child panel's end-state table". The judge orders itself: on an
+    // error the ledger is caught up FIRST (the settle tap), then streamEnd
+    // lands "error", so an honest RUN_ERROR already reads failed when the
+    // banner question is asked. Any non-"open" end returns the tail slot;
+    // Retry re-opens. Deferred setters guard on the PANEL's lifetime
+    // (disposedRef), never the stream effect's own teardown — the ending
+    // trips that teardown itself, so an effect-scoped flag would drop the
+    // very verdict being delivered.
+    const [messages, setMessages] = useState([]);
+    const [streamEnd, setStreamEnd] = useState("open");
+    const [attempt, setAttempt] = useState(0);
+    const disposedRef = useRef(false);
+    useEffect(() => {
+        disposedRef.current = false;
+        return () => {
+            disposedRef.current = true;
+        };
+    }, []);
+    const [toolErrors, setToolErrors] = useState(() => new Map());
+    const [toolCancels, setToolCancels] = useState(() => new Set());
+    // Resume anchors: the run_resumed marker a retried run activity
+    // writes under the child's own session id, anchored to the retry's
+    // first message. Copy-on-write like its siblings; never reset across
+    // Retry — re-anchoring the same message id is an idempotent re-set.
+    const [resumeAnchors, setResumeAnchors] = useState(() => new Map());
+    // Block timing: the child's stored events carry the same emit-side
+    // server timestamps as the parent's, so its folds render a real
+    // "Worked for …" — never the unknown register on a surface that simply
+    // forgot to record. Copy-on-write like the error/cancel anchors above,
+    // deliberately NOT the parent store's mutate-in-place map: that idiom
+    // exists because a parent history is unbounded, while this panel
+    // replays one dispatch's bounded run — identity stays the change
+    // signal and no revision counter is needed. Never reset across Retry:
+    // the fold reduction is min/max idempotent, so a re-replayed sequence
+    // changes nothing.
+    const [blockTimings, setBlockTimings] = useState(() => new Map());
+    const { tailed, slotDenied } = useChildTailLease(streamEnd);
+    useEffect(() => {
+        if (!tailed) {
+            return;
+        }
+        return openChildReplayStream({
+            session,
+            threadId,
+            childSessionId,
+            refreshLedger,
+            disposedRef,
+            setStreamEnd,
+            record: {
+                setMessages,
+                setToolErrors,
+                setToolCancels,
+                setResumeAnchors,
+                setBlockTimings,
+            },
+        });
+    }, [session, threadId, childSessionId, tailed, attempt, refreshLedger]);
+    const anchors = useMemo(() => ({
+        ...THREADLESS_ANCHORS,
+        resumeAnchors,
+        toolErrorAnchors: toolErrors,
+        toolCancelAnchors: toolCancels,
+        blockTimingAnchors: blockTimings,
+    }), [resumeAnchors, toolErrors, toolCancels, blockTimings]);
+    return {
+        messages,
+        streamEnd,
+        tailed,
+        slotDenied,
+        anchors,
+        retry: () => {
+            setStreamEnd("open");
+            setAttempt((known) => known + 1);
+        },
+    };
+}
+// The lease lives exactly as long as the connection could (the
+// stop-wanting posture): acquired at mount — a settled
+// child's REPLAY still dials the stream door, so even it owes the
+// budget while its connection is in flight (the recorded adjudication)
+// — and released the moment the stream ENDS, not when the panel
+// closes, so a finished replay frees the capacity-1 slot in moments
+// instead of parking it for the length of the visit. Keyed by the
+// PANEL, never the child (the rows' own-toolCallId posture) — two
+// surfaces drilled into the SAME child are two streams, and a shared
+// id would collapse them into one holder whose first release kills the
+// survivor's tail with no waiter to promote.
+function useChildTailLease(streamEnd) {
+    const leaseId = useId();
+    useEffect(() => {
+        if (streamEnd !== "open") {
+            return;
+        }
+        CHILD_TAIL_SLOTS.acquire(leaseId);
+        return () => {
+            CHILD_TAIL_SLOTS.release(leaseId);
+        };
+    }, [leaseId, streamEnd]);
+    const tailed = useSyncExternalStore(CHILD_TAIL_SLOTS.subscribe, () => CHILD_TAIL_SLOTS.holds(leaseId), () => false);
+    // Asked and DENIED — queued behind a full pool. False both before the
+    // lease effect asks and after a promotion, so the waiting copy can
+    // never flash on an uncontended open (the acquire announces its own
+    // enqueue).
+    const slotDenied = useSyncExternalStore(CHILD_TAIL_SLOTS.subscribe, () => CHILD_TAIL_SLOTS.waiting(leaseId), () => false);
+    return { tailed, slotDenied };
+}
+// One attempt at the child stream: the agent, its taps, and the ending
+// judge. Returns the teardown — every tap unsubscribed BEFORE the abort,
+// so a handoff never reaches the error funnel.
+function openChildReplayStream({ session, threadId, childSessionId, refreshLedger, disposedRef, setStreamEnd, record, }) {
+    const agent = new ServingReplayStreamAgent({
+        streamUrl: streamUrlForChild(session, threadId, childSessionId),
+        streamThreadId: childSessionId,
+        authorizedFetch: session.authorizedFetch,
+    });
+    const unsubscribeAnchorTaps = subscribeAnchorTaps(agent, record);
+    // The chassis splits this stream's two error shapes: a served
+    // RUN_ERROR (the child's honest terminal, verbatim or synthesized by
+    // the door) arrives as onRunErrorEvent WITH the connect promise
+    // still resolving, while only a transport death reaches onRunFailed
+    // (streamErrorRecorder; our own aborts are filtered there). Both are
+    // this stream's error ending, funneled once — and they OWN it: the
+    // settle handler may claim "clean" only when no error was seen, or
+    // it would overwrite the verdict a moment after it landed.
+    let sawError = false;
+    const endWithError = () => {
+        if (sawError) {
+            return;
+        }
+        sawError = true;
+        // A RUN_ERROR mid-watch is usually the child's HONEST terminal,
+        // not a dropped connection — but the ledger only learns on its
+        // 10s tick. Catch it up first, and only then land the error end
+        // (the table's judge order). Guarded on the PANEL's disposal:
+        // this very ending tears the stream effect down (end → lease
+        // released → tailed false), so an effect-scoped flag would drop
+        // the verdict — the unreachable-banner regression.
+        void refreshLedger().finally(() => {
+            if (!disposedRef.current) {
+                setStreamEnd("error");
+            }
+        });
+    };
+    const errorTap = agent.subscribe(streamErrorRecorder(endWithError));
+    // The two facts the ending judge reads: whether THIS wire carried a
+    // terminal, and whether this effect run has already been torn down.
+    // `torn` guards ONLY the then-handler: an effect re-run's (or
+    // StrictMode's) aborted predecessor resolves through the client's
+    // swallowed-abort path and must not judge the successor's stream —
+    // while the error funnel above keeps its PANEL-lifetime guard, per
+    // the table's judge order (the unreachable-banner regression).
+    let sawTerminal = false;
+    let torn = false;
+    const terminalTap = agent.subscribe({
+        onRunFinishedEvent() {
+            sawTerminal = true;
+        },
+        onRunErrorEvent({ event }) {
+            // The chassis synthesizes a RUN_ERROR coded "abort" when the body
+            // read is aborted — ours or the browser's. Never a served terminal
+            // (the door sets no code), so it is not this stream's verdict: the
+            // quiet-ending judge below reads the ledger instead. Matched on
+            // the code only — a child's honest sentence may say "aborted".
+            if (event.code === "abort") {
+                return;
+            }
+            sawTerminal = true;
+            endWithError();
+        },
+    });
+    agent
+        .connectAgent()
+        .then(() => {
+        if (disposedRef.current || torn || sawError) {
+            return;
+        }
+        if (sawTerminal) {
+            // A clean ending is the settle signal: the ledger catches up
+            // now, not at the next tick, and the ended stream returns its
+            // tail slot (a waiting sibling panel is promoted) — the error
+            // path does the same through the funnel above, after its
+            // catch-up.
+            void refreshLedger();
+            setStreamEnd("clean");
+            return;
+        }
+        // The QUIET ending (the table's quiet rows): the body closed with
+        // no terminal at all. Ledger first — the tap resolves with the row
+        // it landed — then the verdict is judged ONCE against that row
+        // and LATCHED as an ordinary ending. The question is AFFIRMATIVE
+        // (the table's UNREAD row): only a ledger that says settled reads
+        // clean; a still-dispatched row and no row at all both read as
+        // the error ending, banner and Retry. Never left to a live
+        // render-time read of the row, which un-painted the banner on the
+        // next ledger tick over a replay truncated at the drop;
+        // the error ending has always latched this way.
+        void refreshLedger().then((row) => {
+            if (disposedRef.current || torn) {
+                return;
+            }
+            setStreamEnd(dispatchHasSettled(row) ? "clean" : "error");
+        });
+    })
+        .catch(() => undefined);
+    return () => {
+        torn = true;
+        unsubscribeAnchorTaps();
+        errorTap.unsubscribe();
+        terminalTap.unsubscribe();
+        agent.abortRun();
+        void agent.detachActiveRun().catch(() => undefined);
+    };
+}
+// The recorders that turn the child's wire into anchored state: messages,
+// tool errors, tool cancellations, resume markers, block timing. Returns
+// the one unsubscribe for all five taps.
+function subscribeAnchorTaps(agent, record) {
+    const messagesTap = agent.subscribe(messagesRecorder(record.setMessages));
+    const errorAnchorTap = agent.subscribe(toolErrorRecorder((toolCallId, errorText) => {
+        record.setToolErrors((previous) => withToolErrorAnchored(previous, toolCallId, errorText));
+    }));
+    const cancelAnchorTap = agent.subscribe(toolCancelRecorder((toolCallId) => {
+        record.setToolCancels((previous) => withToolCancelAnchored(previous, toolCallId));
+    }));
+    const resumeAnchorTap = agent.subscribe(
+    // The run id (the STORE-side arbitration key's first component)
+    // is unused here on purpose: this preview's agent is never
+    // snapshot-seeded — every open is a full replay into fresh
+    // component state — so the seeded-replay re-delivery window does
+    // not exist and the message-id gate below stays sufficient.
+    resumeMarkerRecorder((_runId, messageId, markerValue) => {
+        // Identity is the publish gate, like the sibling anchor taps: a
+        // replayed re-anchor of the same message id (StrictMode's double
+        // mount, Retry) must not re-derive the whole row projection.
+        record.setResumeAnchors((previous) => previous.has(messageId)
+            ? previous
+            : new Map(previous).set(messageId, markerValue));
+    }));
+    const timingAnchorTap = agent.subscribe(blockTimingRecorder((blockId, observedAtMs) => {
+        record.setBlockTimings((previous) => {
+            const next = new Map(previous);
+            return foldBlockTimingObserved(next, blockId, observedAtMs)
+                ? next
+                : previous;
+        });
+    }));
+    return () => {
+        messagesTap.unsubscribe();
+        errorAnchorTap.unsubscribe();
+        cancelAnchorTap.unsubscribe();
+        resumeAnchorTap.unsubscribe();
+        timingAnchorTap.unsubscribe();
+    };
+}
+//# sourceMappingURL=use-child-replay-stream.js.map

package/dist/components/use-child-replay-stream.js.map

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

package/dist/components/use-latest-ref.d.ts

@@ -0,0 +1,6 @@
+import { type RefObject } from "react";
+/** A ref that holds the latest committed value: written at commit time
+ *  (every commit, never during render), so an effect that must reach the
+ *  newest callback or label without re-running reads it from here. */
+export declare function useLatestRef<T>(value: T): RefObject<T>;
+//# sourceMappingURL=use-latest-ref.d.ts.map

package/dist/components/use-latest-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-latest-ref.d.ts","sourceRoot":"","sources":["../../src/components/use-latest-ref.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE1D;;sEAEsE;AACtE,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAMtD"}

package/dist/components/use-latest-ref.js

@@ -0,0 +1,13 @@
+"use client";
+import { useEffect, useRef } from "react";
+/** A ref that holds the latest committed value: written at commit time
+ *  (every commit, never during render), so an effect that must reach the
+ *  newest callback or label without re-running reads it from here. */
+export function useLatestRef(value) {
+    const ref = useRef(value);
+    useEffect(() => {
+        ref.current = value;
+    });
+    return ref;
+}
+//# sourceMappingURL=use-latest-ref.js.map

package/dist/components/use-latest-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-latest-ref.js","sourceRoot":"","sources":["../../src/components/use-latest-ref.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,MAAM,EAAkB,MAAM,OAAO,CAAC;AAE1D;;sEAEsE;AACtE,MAAM,UAAU,YAAY,CAAI,KAAQ;IACtC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,SAAS,CAAC,GAAG,EAAE;QACb,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC;IACtB,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC"}