@teaflask/assistant 0.0.0 → 0.3.0

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

@@ -0,0 +1,70 @@
+/** The fields both wires share — AgentDispatchResponse and ThreadDispatch
+ *  are each a superset of this shape. */
+export interface RosterSourceDispatch {
+    ordinal: number;
+    label: string;
+    error: string | null;
+    child_session_id: string;
+    created_at: string;
+    updated_at: string;
+}
+/** The caller's status vocabulary, injected so no status literal lives in
+ *  this module. Completed is derived: neither running nor failed. */
+export interface RosterStatusPredicates<D extends RosterSourceDispatch> {
+    isRunning: (dispatch: D) => boolean;
+    hasFailed: (dispatch: D) => boolean;
+}
+export interface SubagentRosterEntry {
+    /** The RENDER key — one entry per ASK, unique across the surface: a
+     *  resume chain shares child_session_id, so a session-keyed list
+     *  would render duplicate React keys and count one coworker per ask. */
+    key: string;
+    /** The drill-in address — the child SESSION the entry's stream and
+     *  page live under; a resume chain's entries share it on purpose (one
+     *  extended transcript). */
+    childSessionId: string;
+    ordinal: number;
+    /** Never empty: a whitespace-clipped ledger label falls back here, the
+     *  same sentence the tree rows use. */
+    label: string;
+    running: boolean;
+    failed: boolean;
+    /** The failure's human sentence — null on running and completed rows. */
+    note: string | null;
+    startedAt: string;
+    /** The ledger's settle timestamp (updated_at doubles as it) — null
+     *  while the child is still running. */
+    settledAt: string | null;
+}
+/** The roster, bucketed by outcome. The ledger has no cancelled status
+ *  (cancellation is a wire fact that never opens a dispatch row), so the
+ *  buckets are exactly these three. */
+export interface SubagentRoster {
+    running: SubagentRosterEntry[];
+    completed: SubagentRosterEntry[];
+    failed: SubagentRosterEntry[];
+    /** Per-ASK row count — what the roster list renders. */
+    total: number;
+    /** Distinct COWORKERS (distinct childSessionId) — what the pill's
+     *  noun counts: a resume chain is several asks of
+     *  ONE subagent, and "3 subagents" for one coworker asked three
+     *  things is a lie the per-ask rows must not tell. */
+    distinctSessions: number;
+    /** Coworkers whose NEWEST ask failed — the pill's loss count: the label
+     *  speaks coworkers in every arm, so a failed dispatch superseded by a
+     *  succeeded resume is not a lost coworker, and a chain that failed twice
+     *  is one. The per-ask rows still name each lost ask individually. */
+    failedSessions: number;
+}
+export declare function rosterEntriesOf<D extends RosterSourceDispatch>(dispatches: Iterable<D>, predicates: RosterStatusPredicates<D>): SubagentRosterEntry[];
+export declare function subagentRosterOf(entries: readonly SubagentRosterEntry[]): SubagentRoster;
+/** The pill's copy: null when the conversation has no subagents, the live
+ *  count while any child runs, the total once everything settled — with the
+ *  losses named (the group headline's suffix vocabulary): the pill is the
+ *  roster's collapsed form, and the one loud fact must survive the collapse. */
+export declare function subagentPillLabelOf(roster: SubagentRoster): string | null;
+/** A settled row's duration in the house ladder (segment-timing's
+ *  durationLabelOf: "<1s" floor, "0s" unrenderable) — null while running (a
+ *  live clock is the dashboard's ElapsedTime concern) and on bad timestamps. */
+export declare function settledDurationLabelOf(startedAt: string, settledAt: string | null): string | null;
+//# sourceMappingURL=subagent-roster.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-roster.d.ts","sourceRoot":"","sources":["../../src/core/subagent-roster.ts"],"names":[],"mappings":"AAQA;yCACyC;AACzC,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;qEACqE;AACrE,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS,oBAAoB;IACpE,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,OAAO,CAAC;IACpC,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,mBAAmB;IAClC;;4EAEwE;IACxE,GAAG,EAAE,MAAM,CAAC;IACZ;;gCAE4B;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB;2CACuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,yEAAyE;IACzE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB;4CACwC;IACxC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;uCAEuC;AACvC,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd;;;0DAGsD;IACtD,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;0EAGsE;IACtE,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS,oBAAoB,EAC5D,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,EACvB,UAAU,EAAE,sBAAsB,CAAC,CAAC,CAAC,GACpC,mBAAmB,EAAE,CAgCvB;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,mBAAmB,EAAE,GACtC,cAAc,CAmChB;AAED;;;gFAGgF;AAChF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAsBzE;AAED;;gFAEgF;AAChF,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,MAAM,GAAG,IAAI,CAMf"}

package/dist/core/subagent-roster.js

@@ -0,0 +1,111 @@
+// The conversation-wide subagent roster: the dispatch ledger's
+// rows bucketed for the count pill and its hover roster; the dashboard's
+// conversations pill imports it through agent-run/roster.ts. Status never
+// enters as a string: callers inject their own tree's predicates.
+import { durationLabelOf } from "./segment-timing.js";
+import { settledSpanMsOf } from "./subagent-presence.js";
+export function rosterEntriesOf(dispatches, predicates) {
+    const entries = [];
+    for (const dispatch of dispatches) {
+        const running = predicates.isRunning(dispatch);
+        const failed = predicates.hasFailed(dispatch);
+        entries.push({
+            key: `${dispatch.child_session_id}:${String(dispatch.ordinal)}`,
+            childSessionId: dispatch.child_session_id,
+            ordinal: dispatch.ordinal,
+            label: dispatch.label === "" ? "Delegated task" : dispatch.label,
+            running,
+            failed,
+            // A failed row must carry a reason: error is nullable and the roster
+            // has no wire receipt to fall through to — the constant sentence is the
+            // guard every neighbouring surface keeps (dispatchRunOutcomeOf).
+            note: failed
+                ? (dispatch.error ?? "The subagent failed before it could report back.")
+                : null,
+            startedAt: dispatch.created_at,
+            settledAt: running ? null : dispatch.updated_at,
+        });
+    }
+    // Dispatch order, not settle order: the roster reads as the fan-outs the
+    // parent authored. One thread has ONE parent run, so ordinal is unique
+    // across the roster — the invariant the group rows' byOrdinal join depends
+    // on; startedAt leads the sort, ordinal is the deterministic tiebreak.
+    entries.sort((a, b) => Date.parse(a.startedAt) - Date.parse(b.startedAt) ||
+        a.ordinal - b.ordinal);
+    return entries;
+}
+export function subagentRosterOf(entries) {
+    // One coworker = one chain: its NEWEST ask (highest ordinal — chains
+    // never span parent runs) is its current state, the same
+    // newest-supersedes posture every other surface keeps.
+    const newestBySession = new Map();
+    for (const entry of entries) {
+        const held = newestBySession.get(entry.childSessionId);
+        if (held === undefined || entry.ordinal > held.ordinal) {
+            newestBySession.set(entry.childSessionId, entry);
+        }
+    }
+    let failedSessions = 0;
+    for (const newest of newestBySession.values()) {
+        if (newest.failed) {
+            failedSessions += 1;
+        }
+    }
+    const roster = {
+        running: [],
+        completed: [],
+        failed: [],
+        total: entries.length,
+        distinctSessions: newestBySession.size,
+        failedSessions,
+    };
+    for (const entry of entries) {
+        if (entry.running) {
+            roster.running.push(entry);
+        }
+        else if (entry.failed) {
+            roster.failed.push(entry);
+        }
+        else {
+            roster.completed.push(entry);
+        }
+    }
+    return roster;
+}
+/** The pill's copy: null when the conversation has no subagents, the live
+ *  count while any child runs, the total once everything settled — with the
+ *  losses named (the group headline's suffix vocabulary): the pill is the
+ *  roster's collapsed form, and the one loud fact must survive the collapse. */
+export function subagentPillLabelOf(roster) {
+    if (roster.total === 0) {
+        return null;
+    }
+    // The loss suffix rides BOTH arms (the group headline's rule): a live
+    // fan-out that already lost a coworker must not read clean while someone
+    // watches the pill. It counts COWORKERS like every other number here — a
+    // coworker is lost when its NEWEST ask failed, recovered by a later resume.
+    const failedSuffix = roster.failedSessions > 0
+        ? ` · ${String(roster.failedSessions)} failed`
+        : "";
+    if (roster.running.length > 0) {
+        // Per-ask is per-coworker here: one chain holds at most one live
+        // row (the one-live-run law), so running.length counts coworkers.
+        return `${String(roster.running.length)} running${failedSuffix}`;
+    }
+    // The noun counts COWORKERS, never asks: a resumed
+    // child is one subagent asked again, and the pill's word must mean
+    // what it says even while the roster honestly lists every ask.
+    const noun = roster.distinctSessions === 1 ? "subagent" : "subagents";
+    return `${String(roster.distinctSessions)} ${noun}${failedSuffix}`;
+}
+/** A settled row's duration in the house ladder (segment-timing's
+ *  durationLabelOf: "<1s" floor, "0s" unrenderable) — null while running (a
+ *  live clock is the dashboard's ElapsedTime concern) and on bad timestamps. */
+export function settledDurationLabelOf(startedAt, settledAt) {
+    const durationMs = settledSpanMsOf(startedAt, settledAt);
+    if (durationMs === null) {
+        return null;
+    }
+    return durationLabelOf(durationMs);
+}
+//# sourceMappingURL=subagent-roster.js.map

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

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

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

@@ -0,0 +1,108 @@
+export declare const DISPATCH_SUBAGENT_TOOL_NAME = "dispatch_subagent";
+/** One dispatch tool call, normalized from either tree's row shape by the
+ *  caller — the dashboard's status union and the package's state union
+ *  name the same facts differently, so each tree adapts its own. */
+export interface DispatchCall {
+    toolCallId: string;
+    /** The call settled on the wire: a result or failure was recorded. */
+    settled: boolean;
+    failed: boolean;
+    cancelled: boolean;
+    result: string | undefined;
+    /** The wire's failure sentence, present only on failed calls — a
+     *  dispatcher failure's only explanation, since its result is prose,
+     *  never a receipt. (A door REFUSAL never reaches this module:
+     *  the projection keeps a refused dispatch out of the grouping,
+     *  because no child exists.) */
+    errorText: string | undefined;
+    /** The raw streamed arguments JSON text — the label fallback while the
+     *  receipt hasn't landed. */
+    argsText: string;
+}
+/** The dispatch receipt as the tool result carries it (the backend's
+ *  DispatchReceipt, read leniently — a truncated result or a failure
+ *  sentence parses to null fields, never throws). The wire's settled.status collapses to
+ *  a boolean right here, so no surface ever compares status words. */
+export interface DispatchReceipt {
+    outcome: "launched" | "attached" | "already_settled";
+    ordinal: number;
+    label: string;
+    childSessionId: string | null;
+    settled: {
+        failed: boolean;
+        note: string | null;
+    } | null;
+}
+export interface SubagentGroupEntry {
+    toolCallId: string;
+    receipt: DispatchReceipt | null;
+    /** The parent-authored label: the receipt's when it landed, else a
+     *  best-effort read of the streamed task text. */
+    label: string | null;
+    /** Still working, as far as the wire alone can tell — a ledger join
+     *  (where the surface has one) refines this. */
+    running: boolean;
+    failed: boolean;
+    cancelled: boolean;
+    /** The row's explanation: the settled receipt's note, or a failed
+     *  call's failure sentence. A ledger join (where the surface has one)
+     *  may outrank it. */
+    note: string | null;
+}
+export interface SubagentGroupRow {
+    kind: "subagent-group";
+    key: string;
+    entries: SubagentGroupEntry[];
+}
+/** The outcome tallies a group's summary line and trigger icon read. */
+export interface SubagentOutcomeCounts {
+    running: number;
+    failed: number;
+    cancelled: number;
+    total: number;
+}
+export declare function subagentOutcomeCountsOf(entries: readonly {
+    running: boolean;
+    failed: boolean;
+    cancelled: boolean;
+}[]): SubagentOutcomeCounts;
+/**
+ * The group's summary line — the feature's most visible sentence, shared
+ * so the dashboard and the widget can never phrase it differently. Every
+ * settled outcome survives collapse: failures and interruptions ride the
+ * suffix, and "Ran" counts only the calls that actually ran — a cancelled
+ * dispatch never did, and a severed one's receipt never landed. The
+ * suffix word is "interrupted", the word the entry pills already wear
+ * for both shapes — never "cancelled", which would assert a
+ * cancellation nobody performed on a retry-severed call.
+ * (String() wrappers throughout, satisfying the package's
+ * template-expression lint.)
+ */
+export declare function subagentGroupHeadlineOf(counts: SubagentOutcomeCounts): string;
+/**
+ * Collapse consecutive dispatch calls into group rows, leaving every
+ * other row untouched. Grouping is strictly adjacent within the given
+ * rows (one message's): parallel dispatches share one assistant turn and
+ * read as one delegation moment; anything between two dispatches splits
+ * them into two honest moments.
+ */
+export declare function withSubagentGroups<Row>(rows: readonly Row[], asDispatchCall: (row: Row) => DispatchCall | null, keyOf: (row: Row) => string): (Row | SubagentGroupRow)[];
+/**
+ * The receipt out of a dispatch call's result text: null for failure
+ * sentences, garbage, and results still streaming. A truncated receipt
+ * (the transcript store's overflow clip) recovers what its surviving
+ * prefix carries — the backend orders outcome/ordinal/label first for
+ * exactly this read.
+ */
+export declare function dispatchReceiptOf(result: string | undefined): DispatchReceipt | null;
+/**
+ * The parent-authored task as a label while no receipt exists yet: read
+ * from the streamed arguments, whitespace-collapsed and clipped like the
+ * ledger's excerpt. Tolerant of mid-stream JSON — a partial "task" string
+ * still reads.
+ */
+export declare function taskExcerptOf(argsText: string): string | null;
+/** The parent-authored task exactly as dispatched, unclipped — the
+ *  child's opening brief. Tolerant of mid-stream JSON like the excerpt. */
+export declare function dispatchedTaskOf(argsText: string): string | null;
+//# sourceMappingURL=subagent-rows.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-rows.d.ts","sourceRoot":"","sources":["../../src/core/subagent-rows.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,2BAA2B,sBAAsB,CAAC;AAM/D;;oEAEoE;AACpE,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B;;;;oCAIgC;IAChC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B;iCAC6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;sEAGsE;AACtE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,UAAU,GAAG,UAAU,GAAG,iBAAiB,CAAC;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,OAAO,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CAC1D;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IAChC;sDACkD;IAClD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;oDACgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB;;0BAEsB;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,gBAAgB,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAED,wEAAwE;AACxE,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,SAAS;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB,EAAE,GACF,qBAAqB,CAgBvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAqB7E;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EACpC,IAAI,EAAE,SAAS,GAAG,EAAE,EACpB,cAAc,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,YAAY,GAAG,IAAI,EACjD,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,GAC1B,CAAC,GAAG,GAAG,gBAAgB,CAAC,EAAE,CAqB5B;AA+BD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,eAAe,GAAG,IAAI,CAgCxB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO7D;AAED;2EAC2E;AAC3E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYhE"}

package/dist/core/subagent-rows.js

@@ -0,0 +1,253 @@
+// The transcript's subagent grouping: consecutive
+// dispatch_subagent tool calls inside one assistant message collapse into
+// one "Running N subagents" group row, each dispatch read from its
+// receipt. Pure and import-free; public via ./transcript, which the
+// dashboard imports rather than keeping a fork.
+export const DISPATCH_SUBAGENT_TOOL_NAME = "dispatch_subagent";
+/** The stored label's bound, mirrored from the ledger's question_excerpt
+ *  clip — a streamed-args fallback must never out-length the real label. */
+const MAX_LABEL_CHARS = 200;
+export function subagentOutcomeCountsOf(entries) {
+    let running = 0;
+    let failed = 0;
+    let cancelled = 0;
+    for (const entry of entries) {
+        if (entry.running) {
+            running += 1;
+        }
+        if (entry.failed) {
+            failed += 1;
+        }
+        if (entry.cancelled) {
+            cancelled += 1;
+        }
+    }
+    return { running, failed, cancelled, total: entries.length };
+}
+/**
+ * The group's summary line — the feature's most visible sentence, shared
+ * so the dashboard and the widget can never phrase it differently. Every
+ * settled outcome survives collapse: failures and interruptions ride the
+ * suffix, and "Ran" counts only the calls that actually ran — a cancelled
+ * dispatch never did, and a severed one's receipt never landed. The
+ * suffix word is "interrupted", the word the entry pills already wear
+ * for both shapes — never "cancelled", which would assert a
+ * cancellation nobody performed on a retry-severed call.
+ * (String() wrappers throughout, satisfying the package's
+ * template-expression lint.)
+ */
+export function subagentGroupHeadlineOf(counts) {
+    const nounOf = (count) => (count === 1 ? "subagent" : "subagents");
+    const suffixParts = [];
+    if (counts.failed > 0) {
+        suffixParts.push(`${String(counts.failed)} failed`);
+    }
+    if (counts.cancelled > 0) {
+        suffixParts.push(`${String(counts.cancelled)} interrupted`);
+    }
+    const suffix = suffixParts.length > 0 ? ` · ${suffixParts.join(" · ")}` : "";
+    if (counts.running > 0) {
+        if (counts.running === counts.total) {
+            return `Running ${String(counts.total)} ${nounOf(counts.total)}`;
+        }
+        return `Running ${String(counts.running)} of ${String(counts.total)} ${nounOf(counts.total)}${suffix}`;
+    }
+    if (counts.cancelled === counts.total) {
+        return `${String(counts.total)} ${nounOf(counts.total)} interrupted`;
+    }
+    const ranCount = counts.total - counts.cancelled;
+    return `Ran ${String(ranCount)} ${nounOf(ranCount)}${suffix}`;
+}
+/**
+ * Collapse consecutive dispatch calls into group rows, leaving every
+ * other row untouched. Grouping is strictly adjacent within the given
+ * rows (one message's): parallel dispatches share one assistant turn and
+ * read as one delegation moment; anything between two dispatches splits
+ * them into two honest moments.
+ */
+export function withSubagentGroups(rows, asDispatchCall, keyOf) {
+    const out = [];
+    let group = null;
+    for (const row of rows) {
+        const call = asDispatchCall(row);
+        if (call === null) {
+            group = null;
+            out.push(row);
+            continue;
+        }
+        if (group === null) {
+            group = {
+                kind: "subagent-group",
+                key: `subagents:${keyOf(row)}`,
+                entries: [],
+            };
+            out.push(group);
+        }
+        group.entries.push(_entryOf(call));
+    }
+    return out;
+}
+function _entryOf(call) {
+    const receipt = dispatchReceiptOf(call.result);
+    // A landed receipt outranks the wire's call status: the dispatch tool
+    // answers immediately (the receipt is never the report), so a settled
+    // call whose receipt says "launched" names a child still working.
+    // already_settled means the child settled BY DEFINITION: a truncated
+    // receipt loses its settled payload (and its child_session_id, so no
+    // ledger join can correct it) — without the outcome check a coworker
+    // that already failed would spin forever.
+    const stillDispatched = receipt !== null
+        ? receipt.settled === null && receipt.outcome !== "already_settled"
+        : !call.settled;
+    // A truncated receipt can carry an EMPTY label — fall through to the
+    // streamed task text rather than rendering a blank row.
+    const receiptLabel = receipt !== null && receipt.label !== "" ? receipt.label : null;
+    return {
+        toolCallId: call.toolCallId,
+        receipt,
+        label: receiptLabel ?? taskExcerptOf(call.argsText),
+        running: !call.failed && !call.cancelled && stillDispatched,
+        failed: call.failed || receipt?.settled?.failed === true,
+        cancelled: call.cancelled,
+        note: receipt?.settled?.note ?? (call.failed ? (call.errorText ?? null) : null),
+    };
+}
+/**
+ * The receipt out of a dispatch call's result text: null for failure
+ * sentences, garbage, and results still streaming. A truncated receipt
+ * (the transcript store's overflow clip) recovers what its surviving
+ * prefix carries — the backend orders outcome/ordinal/label first for
+ * exactly this read.
+ */
+export function dispatchReceiptOf(result) {
+    if (result === undefined || result === "") {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(result);
+    }
+    catch {
+        return _receiptFromTruncatedPrefix(result);
+    }
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+        return null;
+    }
+    const record = parsed;
+    const outcome = record.outcome;
+    const ordinal = record.ordinal;
+    const label = record.label;
+    if (!_isOutcome(outcome) ||
+        typeof ordinal !== "number" ||
+        typeof label !== "string") {
+        return null;
+    }
+    const childSessionId = record.child_session_id;
+    return {
+        outcome,
+        ordinal,
+        label,
+        childSessionId: typeof childSessionId === "string" ? childSessionId : null,
+        settled: _settledOf(record.settled),
+    };
+}
+/**
+ * The parent-authored task as a label while no receipt exists yet: read
+ * from the streamed arguments, whitespace-collapsed and clipped like the
+ * ledger's excerpt. Tolerant of mid-stream JSON — a partial "task" string
+ * still reads.
+ */
+export function taskExcerptOf(argsText) {
+    const task = dispatchedTaskOf(argsText);
+    if (task === null) {
+        return null;
+    }
+    const collapsed = task.split(/\s+/).filter(Boolean).join(" ");
+    return collapsed === "" ? null : collapsed.slice(0, MAX_LABEL_CHARS);
+}
+/** The parent-authored task exactly as dispatched, unclipped — the
+ *  child's opening brief. Tolerant of mid-stream JSON like the excerpt. */
+export function dispatchedTaskOf(argsText) {
+    try {
+        const parsed = JSON.parse(argsText);
+        if (parsed === null || typeof parsed !== "object") {
+            return null;
+        }
+        const value = parsed.task;
+        return typeof value === "string" ? value : null;
+    }
+    catch {
+        const match = /"task"\s*:\s*"((?:[^"\\]|\\.)*)/.exec(argsText);
+        return match === null ? null : _unescaped(match[1]);
+    }
+}
+function _isOutcome(value) {
+    return (value === "launched" || value === "attached" || value === "already_settled");
+}
+// The wire's settled-status words as data, not comparisons — identifier
+// keys on purpose: status vocabulary is compared only inside lib/status,
+// and this seam collapses it to a boolean instead.
+const _SETTLED_STATUS_FAILED = {
+    succeeded: false,
+    failed: true,
+};
+function _settledOf(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        return null;
+    }
+    const record = value;
+    // Own-key lookup only: a bare record read reaches Object.prototype, so
+    // an unrecognized status word like "constructor" would come back
+    // truthy instead of falling to the lenient-parse null. (The long form,
+    // not Object.hasOwn — the lib-es6 spelling the deleted dashboard fork
+    // imposed; kept because changing it buys nothing.)
+    const status = String(record.status);
+    const failed = Object.prototype.hasOwnProperty.call(_SETTLED_STATUS_FAILED, status)
+        ? _SETTLED_STATUS_FAILED[status]
+        : undefined;
+    if (failed === undefined) {
+        return null;
+    }
+    const note = record.note;
+    return { failed, note: typeof note === "string" ? note : null };
+}
+// The truncation-proof read, mirrored from the backend's receipt prefix
+// law: compact JSON in declaration order, outcome and ordinal always
+// inside the surviving prefix.
+const _TRUNCATED_RECEIPT_PREFIX = /^\{"outcome":"(launched|attached|already_settled)","ordinal":(\d+)(?:,"label":"((?:[^"\\]|\\.)*))?/;
+function _receiptFromTruncatedPrefix(result) {
+    const match = _TRUNCATED_RECEIPT_PREFIX.exec(result);
+    if (match === null) {
+        return null;
+    }
+    const outcome = match[1];
+    if (!_isOutcome(outcome)) {
+        return null;
+    }
+    // The label group may be absent on a very short prefix; typed as
+    // possibly-undefined explicitly rather than trusting the index read.
+    const labelBody = match[3];
+    return {
+        outcome,
+        ordinal: Number(match[2]),
+        label: labelBody === undefined ? "" : (_unescaped(labelBody) ?? ""),
+        childSessionId: null,
+        settled: null,
+    };
+}
+function _unescaped(jsonStringBody) {
+    try {
+        return JSON.parse(`"${jsonStringBody}"`);
+    }
+    catch {
+        // A prefix cut mid-escape: drop the dangling backslash and try once
+        // more — better a readable label than none.
+        try {
+            return JSON.parse(`"${jsonStringBody.replace(/\\$/, "")}"`);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=subagent-rows.js.map

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

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

package/dist/core/surface-registry.d.ts

@@ -0,0 +1,31 @@
+export type AssistantSurfaceKind = "full-surface" | "transient";
+export interface AssistantSurfacePresence {
+    /** An AssistantPage-class chrome is mounted somewhere on the page. */
+    readonly fullSurfaceMounted: boolean;
+    /** A modal/transient chrome (the palette) is open somewhere. */
+    readonly transientOpen: boolean;
+}
+/**
+ * Tracks which chromes are announced and derives a presence snapshot — the
+ * useSyncExternalStore subscribe/getSnapshot pair. The snapshot object is
+ * replaced only when the derived booleans change, so no-op registrations
+ * (a second page, StrictMode's double mount) neither swap nor notify.
+ * Registrations are unique tokens, not per-kind flags, so any interleaving
+ * of register/unregister resolves correctly.
+ */
+export declare class AssistantSurfaceRegistry {
+    private readonly tokens;
+    private readonly listeners;
+    private snapshot;
+    /** Returns the matching unregister; calling it twice is a no-op. A
+     *  full surface taking the floor also closes the companion drawer for
+     *  good — leaving that surface by hand lands on the bare mark; a
+     *  transient chrome (the palette) never touches the flag. */
+    register(kind: AssistantSurfaceKind): () => void;
+    subscribe(listener: () => void): () => void;
+    getSnapshot(): AssistantSurfacePresence;
+    private _publishIfPresenceChanged;
+    private _derivePresence;
+}
+export declare const assistantSurfaceRegistry: AssistantSurfaceRegistry;
+//# sourceMappingURL=surface-registry.d.ts.map

package/dist/core/surface-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-registry.d.ts","sourceRoot":"","sources":["../../src/core/surface-registry.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG,WAAW,CAAC;AAEhE,MAAM,WAAW,wBAAwB;IACvC,sEAAsE;IACtE,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,gEAAgE;IAChE,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAWD;;;;;;;GAOG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAyC;IAEzD;;;iEAG6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAahD,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAO3C,WAAW,IAAI,wBAAwB;IAIvC,OAAO,CAAC,yBAAyB;IAgBjC,OAAO,CAAC,eAAe;CAYxB;AAED,eAAO,MAAM,wBAAwB,0BAAiC,CAAC"}