@teaflask/assistant 0.0.0 → 0.3.0

package/dist/core/stop-settle.js

@@ -0,0 +1,32 @@
+import { SETTLE_REFRESH_DELAY_MS } from "./settle-refresh.js";
+// How many SETTLE_REFRESH_DELAY_MS beats a stop's fallback re-read keeps
+// probing for the ~2s stop exit before releasing the "Stopping…" lock.
+// Its own constant on purpose: the sibling probe budgets (restart
+// reclaim, delivery claim) answer different questions and may be retuned
+// without silently changing how long a stop narrates.
+export const STOP_SETTLE_PROBES = 10;
+/**
+ * The stop's bounded fallback probe: the workflow's stop exit lands
+ * turn_stopped plus a quiet RUN_FINISHED on the stream (~2s), which the
+ * ordinary settle machinery adopts — this loop is the dead-stream corner's
+ * fallback, one re-read per beat until the settle shows up or the budget
+ * runs out. `stillAwaitsSettle` is read fresh behind every await (thread
+ * switches and the settle machinery move the owner's fields while the
+ * probe sleeps). Returns true when the budget is exhausted with the stop
+ * still unsettled — the caller releases its "Stopping…" lock; false when
+ * the settle landed (or the stop lost its thread) mid-probe.
+ */
+export async function probeStopSettle(deps) {
+    if (!deps.stillAwaitsSettle()) {
+        return false;
+    }
+    for (let probe = 0; probe < STOP_SETTLE_PROBES; probe += 1) {
+        await new Promise((resolve) => setTimeout(resolve, SETTLE_REFRESH_DELAY_MS));
+        if (!deps.stillAwaitsSettle()) {
+            return false;
+        }
+        await deps.refresh();
+    }
+    return deps.stillAwaitsSettle();
+}
+//# sourceMappingURL=stop-settle.js.map

package/dist/core/stop-settle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-settle.js","sourceRoot":"","sources":["../../src/core/stop-settle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,yEAAyE;AACzE,uEAAuE;AACvE,kEAAkE;AAClE,yEAAyE;AACzE,sDAAsD;AACtD,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAErC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAGrC;IACC,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,kBAAkB,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAC5B,UAAU,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAC7C,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;IACD,OAAO,IAAI,CAAC,iBAAiB,EAAE,CAAC;AAClC,CAAC"}

package/dist/core/stream-trouble.d.ts

@@ -0,0 +1,6 @@
+import type { AssistantConversationStore } from "./conversation-store.js";
+export declare function handleStreamErrorFromStore(store: AssistantConversationStore, error: Error): void;
+export declare function handleStreamClosedQuietlyFromStore(store: AssistantConversationStore, stillStreaming: () => boolean): void;
+export declare function retryStreamFromStore(store: AssistantConversationStore): void;
+export declare function handleWorkflowRestartedFromStore(store: AssistantConversationStore): void;
+//# sourceMappingURL=stream-trouble.d.ts.map

package/dist/core/stream-trouble.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-trouble.d.ts","sourceRoot":"","sources":["../../src/core/stream-trouble.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAQ1E,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,0BAA0B,EACjC,KAAK,EAAE,KAAK,GACX,IAAI,CA2BN;AAUD,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,0BAA0B,EACjC,cAAc,EAAE,MAAM,OAAO,GAC5B,IAAI,CA4BN;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,0BAA0B,GAAG,IAAI,CAK5E;AASD,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,0BAA0B,GAChC,IAAI,CAyBN"}

package/dist/core/stream-trouble.js

@@ -0,0 +1,129 @@
+// Stream trouble: what the store does when the live stream misbehaves —
+// a wire error, a terminal-free quiet close, the member's retry, and the
+// post-restart reconnect that waits for a restarted workflow to reclaim
+// its parked turn.
+import { streamFailureClassOf } from "../contract/telemetry.js";
+import { getAssistantThread } from "../transport/serving-api.js";
+import { adoptRefreshedDetail, refreshThreads, } from "./conversation-adoption.js";
+import { settlesFor } from "./conversation-refresh.js";
+import { publishStore } from "./conversation-publish.js";
+import { SETTLE_REFRESH_DELAY_MS } from "./settle-refresh.js";
+// How many SETTLE_REFRESH_DELAY_MS beats the post-restart reconnect will
+// wait for the restarted workflow to reclaim its parked turn before
+// reconnecting regardless.
+const RESTART_RECLAIM_PROBES = 10;
+export function handleStreamErrorFromStore(store, error) {
+    store._streamInterrupted = true;
+    publishStore(store);
+    // The failure, classified for the host's analytics: where the
+    // wire died and the cursors that locate it. Deliberately no run content.
+    // sawBodyBytes' premise: the scanner sets it on the first SSE body chunk
+    // of a connection — keepalive comments included, so a live-but-idle
+    // resumed stream still reads as mid-stream when the edge cuts it — and
+    // headers alone never set it. The store connects ONCE per epoch (a fresh
+    // scanner per connection), so the flag is a fact about THIS connection.
+    store.deps.onTelemetry({
+        name: "assistant_stream_failed",
+        properties: {
+            failure_class: streamFailureClassOf(error, {
+                sawBodyBytes: store._epoch?.agent.sawBodyBytes ?? false,
+            }),
+            status: _httpStatusOf(error),
+            thread_id: store._active?.thread.id ?? null,
+            resume_cursor: store._active?.resume.snapshot?.afterId ?? null,
+            last_committed_sse_id: store._epoch?.agent.resumeCursor ?? null,
+        },
+    });
+    // Re-read the truth: a RUN_ERROR that settled the turn failed shows
+    // up as busy=false + the turn's failure sentence, which suppresses
+    // the interruption banner in favor of the honest failure notice.
+    store._scheduleSettleRefresh();
+    store.deps.reportError(error);
+}
+// A stream that ends without a terminal event is either a parked turn
+// (the designed quiet close) or a dropped connection wearing the
+// same wire shape — REST is the authority. The re-read alone is most of
+// the answer: it unlocks the composer after a live park (busy rides
+// thread.busy, and parking released the thread pointer) and renders any
+// settled outcome honestly (turnFailure for failed; superseded stays
+// banner-free — its receipt row is the honest rendering). Only a turn
+// the workflow still owns means the connection died under us.
+export function handleStreamClosedQuietlyFromStore(store, stillStreaming) {
+    const active = store._active;
+    if (active === null) {
+        return;
+    }
+    getAssistantThread(store.deps.session, active.thread.id)
+        .then((detail) => {
+        adoptRefreshedDetail(store, detail);
+        // The detail is stale once the visitor moves to another thread
+        // mid-flight — its verdict must not raise a banner over the new
+        // one. stillStreaming is read after the round-trip on purpose: a
+        // detach-and-reconnect (StrictMode's double connect) ends the
+        // first run terminal-free, but by now the replacement is
+        // running and no banner belongs.
+        if (store._active?.thread.id === detail.thread.id &&
+            _workflowStillOwnsTurn(detail.turns.at(-1)?.status) &&
+            !stillStreaming()) {
+            store._streamInterrupted = true;
+            publishStore(store);
+        }
+        void refreshThreads(store);
+    })
+        .catch(() => {
+        // A blip here self-heals like every other refresh: the
+        // visitor's next action re-reads the thread.
+    });
+}
+export function retryStreamFromStore(store) {
+    store._streamInterrupted = false;
+    store._automaticReconnects = 0;
+    store._reconnectNonce += 1;
+    publishStore(store);
+}
+// Answering a parked card restarts its workflow, and only a fresh
+// connection can tail the restarted run — but the reconnect must not race
+// the workflow's reclaim (parked → working is a worker pickup after the
+// endpoint returns): a stream connected while the turn still reads parked
+// closes quietly again and freezes on the stale pause. So wait for REST to
+// show the turn moving, bounded — the restart is durably started, and on
+// exhaustion the reconnect happens anyway (full replay is always correct).
+export function handleWorkflowRestartedFromStore(store) {
+    const active = store._active;
+    if (active === null) {
+        return;
+    }
+    const threadId = active.thread.id;
+    void (async () => {
+        for (let probe = 0; probe < RESTART_RECLAIM_PROBES; probe += 1) {
+            await settlesFor(SETTLE_REFRESH_DELAY_MS);
+            if (store._disposed || store._active?.thread.id !== threadId) {
+                return;
+            }
+            try {
+                const detail = await getAssistantThread(store.deps.session, threadId);
+                if (detail.turns.at(-1)?.status !== "parked") {
+                    break;
+                }
+            }
+            catch {
+                // Keep probing; the reconnect below is the recovery either way.
+            }
+        }
+        if (!store._disposed && store._active?.thread.id === threadId) {
+            store.retryStream();
+        }
+    })();
+}
+// The statuses a live workflow still owns; parked is deliberately not one
+// of them (the workflow exited, the turn waits for its late answer).
+function _workflowStillOwnsTurn(status) {
+    return (status === "queued" || status === "working" || status === "awaiting_input");
+}
+// runHttpRequest stamps the response status on a non-2xx error; a
+// pre-response failure carries none.
+function _httpStatusOf(error) {
+    const status = error.status;
+    return typeof status === "number" ? status : null;
+}
+//# sourceMappingURL=stream-trouble.js.map

package/dist/core/stream-trouble.js.map

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

package/dist/core/subagent-brief.d.ts

@@ -0,0 +1,7 @@
+import type { Message } from "@ag-ui/core";
+/** The task the parent dispatched to this child, or null while the
+ *  parent's call or its receipt has not landed. */
+export declare function openingBriefOf(parentMessages: readonly Message[], childSessionId: string): string | null;
+/** The child's messages led by its brief, when there is one. */
+export declare function withOpeningBrief(childMessages: readonly Message[], brief: string | null, childSessionId: string): readonly Message[];
+//# sourceMappingURL=subagent-brief.d.ts.map

package/dist/core/subagent-brief.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-brief.d.ts","sourceRoot":"","sources":["../../src/core/subagent-brief.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAQ3C;mDACmD;AACnD,wBAAgB,cAAc,CAC5B,cAAc,EAAE,SAAS,OAAO,EAAE,EAClC,cAAc,EAAE,MAAM,GACrB,MAAM,GAAG,IAAI,CAcf;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,SAAS,OAAO,EAAE,EACjC,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,cAAc,EAAE,MAAM,GACrB,SAAS,OAAO,EAAE,CAQpB"}

package/dist/core/subagent-brief.js

@@ -0,0 +1,46 @@
+// A child's opening brief as its transcript's first user row. The child's
+// log carries only the assistant's side (the parent's user side comes
+// from turn rows); the brief's full text lives on the parent's
+// dispatch_subagent call, joined to the child by its receipt.
+import { DISPATCH_SUBAGENT_TOOL_NAME, dispatchedTaskOf, dispatchReceiptOf, } from "./subagent-rows.js";
+/** The task the parent dispatched to this child, or null while the
+ *  parent's call or its receipt has not landed. */
+export function openingBriefOf(parentMessages, childSessionId) {
+    const results = _toolResultsByCallIdOf(parentMessages);
+    for (const message of parentMessages) {
+        if (message.role !== "assistant") {
+            continue;
+        }
+        for (const call of message.toolCalls ?? []) {
+            if (_isDispatchOfChild(call, results.get(call.id), childSessionId)) {
+                const task = dispatchedTaskOf(call.function.arguments);
+                return task === null || task.trim() === "" ? null : task;
+            }
+        }
+    }
+    return null;
+}
+/** The child's messages led by its brief, when there is one. */
+export function withOpeningBrief(childMessages, brief, childSessionId) {
+    if (brief === null) {
+        return childMessages;
+    }
+    return [
+        { id: `brief:${childSessionId}`, role: "user", content: brief },
+        ...childMessages,
+    ];
+}
+function _toolResultsByCallIdOf(messages) {
+    const results = new Map();
+    for (const message of messages) {
+        if (message.role === "tool" && typeof message.content === "string") {
+            results.set(message.toolCallId, message.content);
+        }
+    }
+    return results;
+}
+function _isDispatchOfChild(call, result, childSessionId) {
+    return (call.function.name === DISPATCH_SUBAGENT_TOOL_NAME &&
+        dispatchReceiptOf(result)?.childSessionId === childSessionId);
+}
+//# sourceMappingURL=subagent-brief.js.map

package/dist/core/subagent-brief.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-brief.js","sourceRoot":"","sources":["../../src/core/subagent-brief.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,sEAAsE;AACtE,+DAA+D;AAC/D,8DAA8D;AAI9D,OAAO,EACL,2BAA2B,EAC3B,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B;mDACmD;AACnD,MAAM,UAAU,cAAc,CAC5B,cAAkC,EAClC,cAAsB;IAEtB,MAAM,OAAO,GAAG,sBAAsB,CAAC,cAAc,CAAC,CAAC;IACvD,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACjC,SAAS;QACX,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;YAC3C,IAAI,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,cAAc,CAAC,EAAE,CAAC;gBACnE,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;gBACvD,OAAO,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;YAC3D,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,gBAAgB,CAC9B,aAAiC,EACjC,KAAoB,EACpB,cAAsB;IAEtB,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,OAAO;QACL,EAAE,EAAE,EAAE,SAAS,cAAc,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE;QAC/D,GAAG,aAAa;KACjB,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAC7B,QAA4B;IAE5B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACnE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,kBAAkB,CACzB,IAAoC,EACpC,MAA0B,EAC1B,cAAsB;IAEtB,OAAO,CACL,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,2BAA2B;QAClD,iBAAiB,CAAC,MAAM,CAAC,EAAE,cAAc,KAAK,cAAc,CAC7D,CAAC;AACJ,CAAC"}

package/dist/core/subagent-delivery-anchors.d.ts

@@ -0,0 +1,41 @@
+import type { AgentSubscriber } from "@ag-ui/client";
+export interface DeliveredResult {
+    ordinal: number;
+    label: string;
+    succeeded: boolean;
+}
+export declare const EMPTY_SUBAGENT_DELIVERY_ANCHORS: ReadonlyMap<string, DeliveredResult[]>;
+/**
+ * Narrow a subagent_results_delivered CUSTOM event's wire value (any by
+ * contract). Entries without a numeric ordinal are dropped; a missing
+ * label degrades to "" and a missing succeeded to true (the wire's own
+ * default). Null when nothing valid survives — the contract's "clients
+ * MUST ignore events and fields they do not recognize".
+ */
+export declare function deliveredResultsOf(value: unknown): DeliveredResult[] | null;
+/**
+ * First anchor wins, ever: the marker is emitted at most once per
+ * delivery run, so a second anchoring under the same message id is a
+ * replay's re-delivery, never new information.
+ */
+export declare function withSubagentDeliveryAnchored(previous: ReadonlyMap<string, DeliveredResult[]>, messageId: string, results: DeliveredResult[]): ReadonlyMap<string, DeliveredResult[]>;
+/**
+ * A defensive copy for seeding transcript state from the resume store:
+ * entries that do not hold well-formed results are dropped rather than
+ * rendered (or crashed on). The store is in-memory today, so every entry
+ * it holds passed the payload narrower — this seam is where any future
+ * persisted form of the store must degrade gracefully instead of wedging
+ * the resume path: a dropped receipt reappears on the next full replay.
+ */
+export declare function wellFormedDeliveryAnchorsOf(stored: ReadonlyMap<string, DeliveredResult[]>): ReadonlyMap<string, DeliveredResult[]>;
+/**
+ * Anchors each subagent_results_delivered marker to the first message
+ * that appears after it — the delivery run's first assistant message,
+ * since the marker is the run's first stored row and a delivery turn
+ * has no user bubble. Run-bounded: a pending marker never leaks onto a
+ * later run's first message, and the run id rides to the caller so the
+ * store can anchor once per delivery run no matter where each
+ * connection's message list has drifted to at flush time.
+ */
+export declare function subagentDeliveryMarkerRecorder(onDeliveryAnchored: (deliveryRunId: string, messageId: string, results: DeliveredResult[]) => void): AgentSubscriber;
+//# sourceMappingURL=subagent-delivery-anchors.d.ts.map

package/dist/core/subagent-delivery-anchors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-delivery-anchors.d.ts","sourceRoot":"","sources":["../../src/core/subagent-delivery-anchors.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAYrD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,+BAA+B,EAAE,WAAW,CACvD,MAAM,EACN,eAAe,EAAE,CACN,CAAC;AAEd;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,GAAG,IAAI,CA2B3E;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,EAChD,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,eAAe,EAAE,GACzB,WAAW,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAOxC;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,GAC7C,WAAW,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAsBxC;AAED;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAC5C,kBAAkB,EAAE,CAClB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,eAAe,EAAE,KACvB,IAAI,GACR,eAAe,CAwCjB"}

package/dist/core/subagent-delivery-anchors.js

@@ -0,0 +1,139 @@
+// The delivery-receipt anchor model, pure of React: a
+// machine-started delivery turn opens its run with a
+// subagent_results_delivered marker naming the settled dispatches it
+// pushes. The recorder anchors each marker to the run's first message,
+// the transcript renders a quiet divider before it, and the resume
+// store holds the anchors across remounts (a snapshot-seeded reconnect
+// replays only past the cursor, so historical receipts never re-arrive
+// on the wire).
+import { SUBAGENT_RESULTS_DELIVERED_EVENT_NAME, } from "../contract/events.js";
+// The label is the dispatch's bounded excerpt today, but the narrower
+// distrusts the wire by contract; a runaway string is retained capped,
+// never unbounded.
+const LABEL_MAX_CHARS = 200;
+export const EMPTY_SUBAGENT_DELIVERY_ANCHORS = new Map();
+/**
+ * Narrow a subagent_results_delivered CUSTOM event's wire value (any by
+ * contract). Entries without a numeric ordinal are dropped; a missing
+ * label degrades to "" and a missing succeeded to true (the wire's own
+ * default). Null when nothing valid survives — the contract's "clients
+ * MUST ignore events and fields they do not recognize".
+ */
+export function deliveredResultsOf(value) {
+    if (typeof value !== "object" || value === null) {
+        return null;
+    }
+    const payload = value;
+    if (!Array.isArray(payload.results)) {
+        return null;
+    }
+    const results = [];
+    for (const entry of payload.results) {
+        if (typeof entry !== "object" || entry === null) {
+            continue;
+        }
+        const result = entry;
+        if (typeof result.ordinal !== "number") {
+            continue;
+        }
+        results.push({
+            ordinal: result.ordinal,
+            label: typeof result.label === "string"
+                ? result.label.slice(0, LABEL_MAX_CHARS)
+                : "",
+            succeeded: result.succeeded !== false,
+        });
+    }
+    return results.length > 0 ? results : null;
+}
+/**
+ * First anchor wins, ever: the marker is emitted at most once per
+ * delivery run, so a second anchoring under the same message id is a
+ * replay's re-delivery, never new information.
+ */
+export function withSubagentDeliveryAnchored(previous, messageId, results) {
+    if (previous.has(messageId)) {
+        return previous;
+    }
+    const next = new Map(previous);
+    next.set(messageId, results);
+    return next;
+}
+/**
+ * A defensive copy for seeding transcript state from the resume store:
+ * entries that do not hold well-formed results are dropped rather than
+ * rendered (or crashed on). The store is in-memory today, so every entry
+ * it holds passed the payload narrower — this seam is where any future
+ * persisted form of the store must degrade gracefully instead of wedging
+ * the resume path: a dropped receipt reappears on the next full replay.
+ */
+export function wellFormedDeliveryAnchorsOf(stored) {
+    const seeded = new Map();
+    // The narrowing deliberately distrusts the map's own types: this seam
+    // is what turns a stale shape into missing rows instead of a crash.
+    const entries = stored;
+    for (const [messageId, anchored] of entries) {
+        if (!Array.isArray(anchored)) {
+            continue;
+        }
+        const results = anchored.filter((entry) => typeof entry === "object" &&
+            entry !== null &&
+            typeof entry.ordinal === "number" &&
+            typeof entry.label === "string" &&
+            typeof entry.succeeded === "boolean");
+        if (results.length > 0) {
+            seeded.set(messageId, results);
+        }
+    }
+    return seeded;
+}
+/**
+ * Anchors each subagent_results_delivered marker to the first message
+ * that appears after it — the delivery run's first assistant message,
+ * since the marker is the run's first stored row and a delivery turn
+ * has no user bubble. Run-bounded: a pending marker never leaks onto a
+ * later run's first message, and the run id rides to the caller so the
+ * store can anchor once per delivery run no matter where each
+ * connection's message list has drifted to at flush time.
+ */
+export function subagentDeliveryMarkerRecorder(onDeliveryAnchored) {
+    let pending = null;
+    let currentRunId = null;
+    return {
+        // One agent can be connected more than once (StrictMode detaches
+        // the first run terminal-free and starts over): a marker a dead
+        // connection collected but never flushed must not ride into the
+        // replacement's flush.
+        onRunInitialized() {
+            pending = null;
+            currentRunId = null;
+        },
+        onRunStartedEvent({ event }) {
+            currentRunId = event.runId;
+        },
+        onCustomEvent({ event }) {
+            if (event.name !== SUBAGENT_RESULTS_DELIVERED_EVENT_NAME) {
+                return;
+            }
+            const results = deliveredResultsOf(event.value);
+            if (results !== null && currentRunId !== null) {
+                pending = { runId: currentRunId, results };
+            }
+        },
+        onMessagesChanged({ messages }) {
+            const newestMessage = messages.at(-1);
+            if (pending === null || newestMessage === undefined) {
+                return;
+            }
+            const marker = pending;
+            pending = null;
+            onDeliveryAnchored(marker.runId, newestMessage.id, marker.results);
+        },
+        // A pathological message-less delivery run must not carry its
+        // divider into the next run's first message.
+        onRunFinishedEvent() {
+            pending = null;
+        },
+    };
+}
+//# sourceMappingURL=subagent-delivery-anchors.js.map

package/dist/core/subagent-delivery-anchors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-delivery-anchors.js","sourceRoot":"","sources":["../../src/core/subagent-delivery-anchors.ts"],"names":[],"mappings":"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"}

package/dist/core/subagent-presence.d.ts

@@ -0,0 +1,38 @@
+import type { ToolCallViewModel } from "./tool-call-display.js";
+import type { TranscriptRow } from "./transcript-rows.js";
+/** The deterministic per-coworker palette index (law 10): distinct children
+ *  wear distinct colors, and the SAME child keeps the SAME color across the
+ *  inline group, the roster, the child transcript, a reconnect and a full
+ *  replay. Replay-stable by construction: coworkers rank by their FIRST
+ *  ask's ordinal — a durable wire fact — so arrival and settle order can
+ *  never permute it, and a resume chain keeps one index. 1-based. */
+export declare function coworkerIndicesOf(dispatches: Iterable<{
+    ordinal: number;
+    child_session_id: string;
+}>): ReadonlyMap<string, number>;
+/** A child transcript's newest LIVE tool call, as the presenter's view shape
+ *  — the evidence behind the inline current-work line (TVC-072). Rows sit in
+ *  TOOL_CALL_START order while results land in COMPLETION order, and every
+ *  result-less call is input-available while the run streams (bar the
+ *  retry-severed), so several live calls at once are normal: the
+ *  scan walks past settled rows to the newest LIVE one, null when none is.
+ *  Only `input-available` counts — `input-streaming` is never live here. */
+export declare function newestToolCallViewOf(rows: readonly TranscriptRow[]): ToolCallViewModel | null;
+/** Whether two published live views carry the same current-work EVIDENCE —
+ *  the fields the running-arm headline reads: the model's `caption`, else
+ *  the authored `progressText` when the wire annotated the call, else the
+ *  tool name. The publish path
+ *  may treat equal-evidence views as one fact; a consumer reading payload
+ *  fields off the map must extend this comparison first. */
+export declare function sameCurrentWorkView(a: ToolCallViewModel, b: ToolCallViewModel): boolean;
+/** A settled dispatch's span in milliseconds — the ONE timestamp read behind
+ *  both duration registers: null while the child runs and on unparseable
+ *  timestamps (hidden, never invented); clock skew clamps to a measured
+ *  zero, which the ladder renders "<1s" (TVC-073). */
+export declare function settledSpanMsOf(startedAt: string, settledAt: string | null): number | null;
+/** A settled dispatch's duration in the settled-fold register (law 2):
+ *  "Worked for 12s" / "Worked for <1s" — sentence AND ladder come from
+ *  settledFoldHeadlineOf, so "Worked for 0s" is unrenderable (TVC-073).
+ *  Null while the child runs and on unparseable timestamps — never invents. */
+export declare function settledWorkedLabelOf(startedAt: string, settledAt: string | null): string | null;
+//# sourceMappingURL=subagent-presence.d.ts.map

package/dist/core/subagent-presence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-presence.d.ts","sourceRoot":"","sources":["../../src/core/subagent-presence.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;qEAKqE;AACrE,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,QAAQ,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAAC,GAClE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAgB7B;AAED;;;;;;4EAM4E;AAC5E,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,SAAS,aAAa,EAAE,GAC7B,iBAAiB,GAAG,IAAI,CAW1B;AAED;;;;;4DAK4D;AAC5D,wBAAgB,mBAAmB,CACjC,CAAC,EAAE,iBAAiB,EACpB,CAAC,EAAE,iBAAiB,GACnB,OAAO,CAOT;AAwBD;;;sDAGsD;AACtD,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,MAAM,GAAG,IAAI,CAUf;AAED;;;+EAG+E;AAC/E,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,MAAM,GAAG,IAAI,CAMf"}

package/dist/core/subagent-presence.js

@@ -0,0 +1,99 @@
+// Subagent presence derivations: the pure reads behind the
+// agent-identity variants, the inline current-work line and the roster's
+// settled-duration copy. Kept OUTSIDE subagent-roster.ts — these pull in
+// run-folds and tool-call-display; the roster imports from here, never back.
+import { settledFoldHeadlineOf } from "./run-folds.js";
+/** The deterministic per-coworker palette index (law 10): distinct children
+ *  wear distinct colors, and the SAME child keeps the SAME color across the
+ *  inline group, the roster, the child transcript, a reconnect and a full
+ *  replay. Replay-stable by construction: coworkers rank by their FIRST
+ *  ask's ordinal — a durable wire fact — so arrival and settle order can
+ *  never permute it, and a resume chain keeps one index. 1-based. */
+export function coworkerIndicesOf(dispatches) {
+    const firstOrdinalBySession = new Map();
+    for (const dispatch of dispatches) {
+        const held = firstOrdinalBySession.get(dispatch.child_session_id);
+        if (held === undefined || dispatch.ordinal < held) {
+            firstOrdinalBySession.set(dispatch.child_session_id, dispatch.ordinal);
+        }
+    }
+    const ranked = [...firstOrdinalBySession.entries()].sort((a, b) => a[1] - b[1]);
+    const indices = new Map();
+    ranked.forEach(([childSessionId], position) => {
+        indices.set(childSessionId, position + 1);
+    });
+    return indices;
+}
+/** A child transcript's newest LIVE tool call, as the presenter's view shape
+ *  — the evidence behind the inline current-work line (TVC-072). Rows sit in
+ *  TOOL_CALL_START order while results land in COMPLETION order, and every
+ *  result-less call is input-available while the run streams (bar the
+ *  retry-severed), so several live calls at once are normal: the
+ *  scan walks past settled rows to the newest LIVE one, null when none is.
+ *  Only `input-available` counts — `input-streaming` is never live here. */
+export function newestToolCallViewOf(rows) {
+    for (let rowIndex = rows.length - 1; rowIndex >= 0; rowIndex -= 1) {
+        const row = rows[rowIndex];
+        if (row.kind === "tool-call") {
+            const view = _liveViewOf(row);
+            if (view !== null) {
+                return view;
+            }
+        }
+    }
+    return null;
+}
+/** Whether two published live views carry the same current-work EVIDENCE —
+ *  the fields the running-arm headline reads: the model's `caption`, else
+ *  the authored `progressText` when the wire annotated the call, else the
+ *  tool name. The publish path
+ *  may treat equal-evidence views as one fact; a consumer reading payload
+ *  fields off the map must extend this comparison first. */
+export function sameCurrentWorkView(a, b) {
+    return (a.toolName === b.toolName &&
+        a.state === b.state &&
+        a.display?.caption === b.display?.caption &&
+        a.display?.progressText === b.display?.progressText);
+}
+function _liveViewOf(row) {
+    if (row.state !== "input-available") {
+        return null;
+    }
+    // The label-bearing fields only: currentWorkLabel derives from the
+    // headline ladder (display text → humanized tool name), never from the
+    // payload panes, so output stays off this narrow view.
+    return {
+        toolName: row.toolName,
+        state: row.state,
+        input: row.argsText,
+        errorText: row.errorText,
+        display: row.display,
+    };
+}
+/** A settled dispatch's span in milliseconds — the ONE timestamp read behind
+ *  both duration registers: null while the child runs and on unparseable
+ *  timestamps (hidden, never invented); clock skew clamps to a measured
+ *  zero, which the ladder renders "<1s" (TVC-073). */
+export function settledSpanMsOf(startedAt, settledAt) {
+    if (settledAt === null) {
+        return null;
+    }
+    const started = new Date(startedAt).getTime();
+    const ended = new Date(settledAt).getTime();
+    if (!Number.isFinite(started) || !Number.isFinite(ended)) {
+        return null;
+    }
+    return Math.max(0, ended - started);
+}
+/** A settled dispatch's duration in the settled-fold register (law 2):
+ *  "Worked for 12s" / "Worked for <1s" — sentence AND ladder come from
+ *  settledFoldHeadlineOf, so "Worked for 0s" is unrenderable (TVC-073).
+ *  Null while the child runs and on unparseable timestamps — never invents. */
+export function settledWorkedLabelOf(startedAt, settledAt) {
+    const durationMs = settledSpanMsOf(startedAt, settledAt);
+    if (durationMs === null) {
+        return null;
+    }
+    return settledFoldHeadlineOf({ kind: "measured", durationMs });
+}
+//# sourceMappingURL=subagent-presence.js.map

package/dist/core/subagent-presence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-presence.js","sourceRoot":"","sources":["../../src/core/subagent-presence.ts"],"names":[],"mappings":"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"}