@sagmans/dsh-tui 0.5.2 → 0.7.0

package/lib/transcript/message-content.d.ts

@@ -0,0 +1,21 @@
+/**
+ * What a durable message says, read out of its content blocks.
+ *
+ * A block is whatever the harness recorded — text, a thought, or a tool result
+ * that carries its model-facing content one level deeper — and a reader is shown
+ * only the few shapes this module recognises. It sits apart from the fold
+ * because reading a recorded message is the same whether the message arrived
+ * live or came back out of a log.
+ */
+/** The visible lines a content block list holds, thoughts excluded. */
+export declare function contentLinesOf(content: unknown): string[];
+/** The same lines as one string, for the callers that store text rather than rows. */
+export declare function textOfContent(content: unknown): string;
+/**
+ * The thoughts a durable message carries, in the order they were recorded.
+ *
+ * A recorded thought is the only path a resumed session has to the model's
+ * reasoning, and the live stream does not outlive the turn that produced it.
+ */
+export declare function reasoningTextsOf(content: unknown): string[];
+//# sourceMappingURL=message-content.d.ts.map

package/lib/transcript/message-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-content.d.ts","sourceRoot":"","sources":["../../src/transcript/message-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAezD;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAU3D"}

package/lib/transcript/message-content.js

@@ -0,0 +1,61 @@
+/**
+ * What a durable message says, read out of its content blocks.
+ *
+ * A block is whatever the harness recorded — text, a thought, or a tool result
+ * that carries its model-facing content one level deeper — and a reader is shown
+ * only the few shapes this module recognises. It sits apart from the fold
+ * because reading a recorded message is the same whether the message arrived
+ * live or came back out of a log.
+ */
+/** Narrowing for the structural event reads below; each reader keeps its own copy rather than sharing one. */
+function asRecord(value) {
+    return typeof value === 'object' && value !== null ? value : undefined;
+}
+/** The visible lines a content block list holds, thoughts excluded. */
+export function contentLinesOf(content) {
+    if (!Array.isArray(content))
+        return [];
+    const lines = [];
+    for (const block of content) {
+        const record = asRecord(block);
+        if (record === undefined)
+            continue;
+        // A thought is a row of its own; reading it here would hand the model's
+        // private reasoning to the reader as though it had been said out loud.
+        if (record.type === 'reasoning')
+            continue;
+        // Any block that carries text counts; a tool-result block also holds its
+        // model-facing content one level deeper.
+        if (typeof record.text === 'string')
+            lines.push(...record.text.split('\n'));
+        if (Array.isArray(record.content))
+            lines.push(...contentLinesOf(record.content));
+    }
+    return lines;
+}
+/** The same lines as one string, for the callers that store text rather than rows. */
+export function textOfContent(content) {
+    return contentLinesOf(content).join('\n');
+}
+/**
+ * The thoughts a durable message carries, in the order they were recorded.
+ *
+ * A recorded thought is the only path a resumed session has to the model's
+ * reasoning, and the live stream does not outlive the turn that produced it.
+ */
+export function reasoningTextsOf(content) {
+    if (!Array.isArray(content))
+        return [];
+    const thoughts = [];
+    for (const block of content) {
+        const record = asRecord(block);
+        if (record === undefined)
+            continue;
+        if (record.type === 'reasoning' && typeof record.text === 'string')
+            thoughts.push(record.text);
+        if (Array.isArray(record.content))
+            thoughts.push(...reasoningTextsOf(record.content));
+    }
+    return thoughts;
+}
+//# sourceMappingURL=message-content.js.map

package/lib/transcript/message-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-content.js","sourceRoot":"","sources":["../../src/transcript/message-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,8GAA8G;AAC9G,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAE,KAAiC,CAAC,CAAC,CAAC,SAAS,CAAA;AACrG,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAA;IACtC,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;QAC9B,IAAI,MAAM,KAAK,SAAS;YAAE,SAAQ;QAClC,wEAAwE;QACxE,uEAAuE;QACvE,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW;YAAE,SAAQ;QACzC,yEAAyE;QACzE,yCAAyC;QACzC,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;QAC3E,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;IAClF,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAA;IACtC,MAAM,QAAQ,GAAa,EAAE,CAAA;IAC7B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;QAC9B,IAAI,MAAM,KAAK,SAAS;YAAE,SAAQ;QAClC,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;YAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAC9F,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;IACvF,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/lib/transcript/tool-calls.d.ts

@@ -0,0 +1,106 @@
+import { type ToolCard, type ToolPresenter } from '../cards.ts';
+import type { TranscriptEntry } from '../transcript.ts';
+/** One second in milliseconds, which is the unit a duration is reported in. */
+export declare const SECOND_MS = 1000;
+/**
+ * What is known about one call the fold has seen requested and not answered.
+ *
+ * A settled call reads as nothing rather than as a zero elapsed time: "started
+ * now" and "waiting an unknown time" are different things to say, and only the
+ * fold can tell which one is true.
+ */
+export interface LiveCallState {
+    readonly running: boolean;
+    readonly elapsed: number;
+}
+/**
+ * The rows one folded tool event asks the transcript to commit.
+ *
+ * The fold never writes to the transcript: it holds the call-to-row bookkeeping
+ * that only tool events need, and hands back the rows it drew so the transcript
+ * stays the single owner of reading order and of what a row's index means.
+ */
+export interface ToolCallOutcome {
+    /** Rows to append, in the order the fold drew them. */
+    readonly appends: readonly TranscriptEntry[];
+    /** Rows to restate in place, at the index the fold recorded when it drew them. */
+    readonly replacements: readonly {
+        readonly index: number;
+        readonly entry: TranscriptEntry;
+    }[];
+}
+/**
+ * The tool rows a session's events fold into.
+ *
+ * A tool call is the one transcript row that is drawn before it is finished: the
+ * request lands a card, a nested dispatch restates it, and the result replaces
+ * it, so the fold has to remember where each call's row went. That bookkeeping —
+ * and the request-to-result clock it times a running row with — is the whole of
+ * this module; the ordering and the rows themselves belong to the transcript.
+ */
+export declare class ToolCallFold {
+    private readonly presenter;
+    private readonly clock;
+    /** Reads back the card a settled row holds, so a dispatch or a result restates the row it drew. */
+    private readonly cardAt;
+    private readonly pending;
+    /**
+     * Where each nested call landed on its root card.
+     *
+     * A dispatch logs a start and then a settle, so the second event has to find
+     * the row the first one drew instead of adding a second line for one call.
+     */
+    private readonly pendingSub;
+    constructor(presenter: ToolPresenter | undefined, clock: () => number, 
+    /** Reads back the card a settled row holds, so a dispatch or a result restates the row it drew. */
+    cardAt: (index: number) => ToolCard | undefined);
+    /** Fold one tool event, which is the only family of events that owns cross-event state. */
+    apply(type: string, data: Record<string, unknown>, landingIndex: number): ToolCallOutcome;
+    /**
+     * How long one call has been in flight, or that it is not.
+     *
+     * The fold owns the request-to-result window, so a renderer asks here rather
+     * than timing the row itself: a row read twice in one frame would otherwise
+     * report two durations for one call.
+     */
+    liveCall(callId: string): LiveCallState;
+    /**
+     * Drop the in-flight bookkeeping.
+     *
+     * The sub-call records name rows of the transcript being dropped, so they go
+     * with the transcript: an index kept across the reset would refuse a replayed
+     * call the row it is entitled to.
+     */
+    reset(): void;
+    /**
+     * Whole seconds since a moment the fold read the clock at.
+     *
+     * Floored, not rounded: a duration that claims a second it has not waited yet
+     * would tick up before the call has been waiting that long.
+     */
+    private secondsSince;
+    /** The row a requested call draws, which is the row its result later replaces. */
+    private rootCall;
+    /**
+     * Fold one nested PTC call onto the card of the run_code call that dispatched it.
+     *
+     * Dispatches are logged while the program runs, so the root is still pending;
+     * a dispatch whose root is not in this fold belongs to a window that starts
+     * mid-run, and attaching it to another card would claim a call that card
+     * never made.
+     */
+    private subCall;
+    /**
+     * The card a dispatched call's log answers with.
+     *
+     * A presenter can only rebuild the view it declared when the logged content is
+     * enough for it: a shell's output is, while a read's numbered window and a
+     * search's hits live in the metadata a dispatch does not carry. The fallback is
+     * the content the program was actually shown, so a row whose tool cannot be
+     * re-presented still opens to its outcome rather than to nothing.
+     */
+    private subCallResult;
+    /** The row a call's result settles into: the card it drew, restated with what answered it. */
+    private settleResult;
+}
+//# sourceMappingURL=tool-calls.d.ts.map

package/lib/transcript/tool-calls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-calls.d.ts","sourceRoot":"","sources":["../../src/transcript/tool-calls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AAE9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAGvD,+EAA+E;AAC/E,eAAO,MAAM,SAAS,OAAO,CAAA;AAkB7B;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAA;IAC5C,kFAAkF;IAClF,QAAQ,CAAC,YAAY,EAAE,SAAS;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;KAAE,EAAE,CAAA;CAC9F;AAKD;;;;;;;;GAQG;AACH,qBAAa,YAAY;IAWrB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,mGAAmG;IACnG,OAAO,CAAC,QAAQ,CAAC,MAAM;IAbzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiF;gBAGzF,SAAS,EAAE,aAAa,GAAG,SAAS,EACpC,KAAK,EAAE,MAAM,MAAM;IACpC,mGAAmG;IAClF,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,QAAQ,GAAG,SAAS;IAGlE,2FAA2F;IAC3F,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAAE,MAAM,GAAG,eAAe;IAezF;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;IAMvC;;;;;;OAMG;IACH,KAAK,IAAI,IAAI;IAKb;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAIpB,kFAAkF;IAClF,OAAO,CAAC,QAAQ;IAiBhB;;;;;;;OAOG;IACH,OAAO,CAAC,OAAO;IAwDf;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa;IAWrB,8FAA8F;IAC9F,OAAO,CAAC,YAAY;CAmDrB"}

package/lib/transcript/tool-calls.js

@@ -0,0 +1,254 @@
+import { cardFromLines } from "../cards.js";
+import { carriedFields, mergeCards, subCallRow, subCallRows, SUBCALL_MAX } from "../cards/composition.js";
+import { contentLinesOf } from "./message-content.js";
+/** One second in milliseconds, which is the unit a duration is reported in. */
+export const SECOND_MS = 1000;
+/** An event that changes no row. */
+const NOTHING = { appends: [], replacements: [] };
+/**
+ * The tool rows a session's events fold into.
+ *
+ * A tool call is the one transcript row that is drawn before it is finished: the
+ * request lands a card, a nested dispatch restates it, and the result replaces
+ * it, so the fold has to remember where each call's row went. That bookkeeping —
+ * and the request-to-result clock it times a running row with — is the whole of
+ * this module; the ordering and the rows themselves belong to the transcript.
+ */
+export class ToolCallFold {
+    presenter;
+    clock;
+    cardAt;
+    pending = new Map();
+    /**
+     * Where each nested call landed on its root card.
+     *
+     * A dispatch logs a start and then a settle, so the second event has to find
+     * the row the first one drew instead of adding a second line for one call.
+     */
+    pendingSub = new Map();
+    constructor(presenter, clock, 
+    /** Reads back the card a settled row holds, so a dispatch or a result restates the row it drew. */
+    cardAt) {
+        this.presenter = presenter;
+        this.clock = clock;
+        this.cardAt = cardAt;
+    }
+    /** Fold one tool event, which is the only family of events that owns cross-event state. */
+    apply(type, data, landingIndex) {
+        switch (type) {
+            case 'tool/call':
+                return this.rootCall(data, landingIndex);
+            case 'tool/ptc-dispatch-start':
+                return this.subCall(data, false);
+            case 'tool/ptc-dispatch':
+                return this.subCall(data, true);
+            case 'tool/result':
+                return this.settleResult(data);
+            default:
+                return NOTHING;
+        }
+    }
+    /**
+     * How long one call has been in flight, or that it is not.
+     *
+     * The fold owns the request-to-result window, so a renderer asks here rather
+     * than timing the row itself: a row read twice in one frame would otherwise
+     * report two durations for one call.
+     */
+    liveCall(callId) {
+        const call = callId === '' ? undefined : this.pending.get(callId);
+        if (call === undefined)
+            return { running: false, elapsed: 0 };
+        return { running: true, elapsed: this.secondsSince(call.startedAt) };
+    }
+    /**
+     * Drop the in-flight bookkeeping.
+     *
+     * The sub-call records name rows of the transcript being dropped, so they go
+     * with the transcript: an index kept across the reset would refuse a replayed
+     * call the row it is entitled to.
+     */
+    reset() {
+        this.pending.clear();
+        this.pendingSub.clear();
+    }
+    /**
+     * Whole seconds since a moment the fold read the clock at.
+     *
+     * Floored, not rounded: a duration that claims a second it has not waited yet
+     * would tick up before the call has been waiting that long.
+     */
+    secondsSince(startedAt) {
+        return Math.max(0, Math.floor((this.clock() - startedAt) / SECOND_MS));
+    }
+    /** The row a requested call draws, which is the row its result later replaces. */
+    rootCall(data, landingIndex) {
+        const name = typeof data.name === 'string' ? data.name : 'tool';
+        const argumentsJson = typeof data.arguments === 'string' ? data.arguments : '';
+        const callId = typeof data.callId === 'string' ? data.callId : '';
+        const card = this.presenter?.call(name, argumentsJson);
+        const entry = {
+            kind: 'tool',
+            // The id is what keeps a reader's click on this message after the
+            // result replaces the card: the entry object does not survive, the id does.
+            id: callId,
+            // Without a presenter the row still has to say what ran and with what.
+            card: card ?? cardFromLines('generic', name, name, argumentsJson === '' ? [] : argumentsJson.split('\n'), false),
+        };
+        if (callId !== '')
+            this.pending.set(callId, { name, argumentsJson, index: landingIndex, startedAt: this.clock(), subs: [] });
+        return { appends: [entry], replacements: [] };
+    }
+    /**
+     * Fold one nested PTC call onto the card of the run_code call that dispatched it.
+     *
+     * Dispatches are logged while the program runs, so the root is still pending;
+     * a dispatch whose root is not in this fold belongs to a window that starts
+     * mid-run, and attaching it to another card would claim a call that card
+     * never made.
+     */
+    subCall(data, settled) {
+        const rootCallId = typeof data.rootCallId === 'string' ? data.rootCallId : '';
+        const subCallId = typeof data.subCallId === 'string' ? data.subCallId : '';
+        const root = rootCallId === '' ? undefined : this.pending.get(rootCallId);
+        if (root === undefined || subCallId === '')
+            return NOTHING;
+        const card = this.cardAt(root.index);
+        if (card === undefined)
+            return NOTHING;
+        const name = typeof data.name === 'string' ? data.name : 'tool';
+        const argumentsJson = argumentsJsonOf(data.arguments);
+        // The call's own view is asked for once: it names the row and it is what the
+        // row shows of the call itself, so two asks could disagree about one call.
+        const view = this.presenter?.call(name, argumentsJson);
+        const isError = data.isError === true;
+        const result = settled ? this.subCallResult(name, argumentsJson, data, view) : undefined;
+        const output = result === undefined ? undefined : subCallRows(result);
+        // A call that answered has told the surface how it went, and that is what the
+        // row reports from then on — a program's calls are read by their outcomes.
+        const failed = settled && (isError || result?.failed === true);
+        const known = this.pendingSub.get(subCallId);
+        if (known !== undefined) {
+            // A settle restates the row its start drew: it ends the claim that the
+            // call is still in flight, adds the outcome a reader opens the row for, and
+            // a failure takes back what the call only declared. A call that produced
+            // nothing to open still has to be restated, or its row would keep saying it
+            // is running for as long as the card lives.
+            if (!settled || known.childIndex < 0)
+                return NOTHING;
+            const drawn = (card.subCalls ?? [])[known.childIndex];
+            if (!isError && output === undefined && drawn?.running !== true)
+                return NOTHING;
+            // A settle that reports nothing to open leaves the row's own outcome in
+            // place; only a failure takes it back, because the rows it drew as applied
+            // never happened.
+            const settledOutput = isError ? output : output ?? drawn?.output;
+            const subCalls = (card.subCalls ?? []).map((call, at) => at === known.childIndex
+                ? subCallRow(subCallId, name, argumentsJson, { view, output: settledOutput, status: result?.status, running: false, failed }, call)
+                : call);
+            return { appends: [], replacements: [{ index: root.index, entry: { kind: 'tool', id: rootCallId, card: { ...card, subCalls } } }] };
+        }
+        // A dispatch log arrives only once the call has settled, so a row that no
+        // settle has restated yet is the one still running.
+        const call = subCallRow(subCallId, name, argumentsJson, { view, output, status: result?.status, running: !settled, failed });
+        const kept = card.subCalls ?? [];
+        const total = (card.subCallsTotal ?? 0) + 1;
+        if (kept.length >= SUBCALL_MAX) {
+            // Retention keeps the head, where the calls that shaped the program are;
+            // the count still reports everything it dispatched. The id is remembered
+            // so a settle is not counted twice, and listed on the root so the root's
+            // own cleanup forgets it — an overflow row has no row to clean up after.
+            this.pendingSub.set(subCallId, { rootIndex: root.index, childIndex: -1 });
+            root.subs.push(subCallId);
+            return { appends: [], replacements: [{ index: root.index, entry: { kind: 'tool', id: rootCallId, card: { ...card, subCallsTotal: total } } }] };
+        }
+        root.subs.push(subCallId);
+        this.pendingSub.set(subCallId, { rootIndex: root.index, childIndex: kept.length });
+        return { appends: [], replacements: [{ index: root.index, entry: { kind: 'tool', id: rootCallId, card: { ...card, subCalls: [...kept, call], subCallsTotal: total } } }] };
+    }
+    /**
+     * The card a dispatched call's log answers with.
+     *
+     * A presenter can only rebuild the view it declared when the logged content is
+     * enough for it: a shell's output is, while a read's numbered window and a
+     * search's hits live in the metadata a dispatch does not carry. The fallback is
+     * the content the program was actually shown, so a row whose tool cannot be
+     * re-presented still opens to its outcome rather than to nothing.
+     */
+    subCallResult(name, argumentsJson, data, view) {
+        const failed = data.isError === true;
+        return this.presenter?.result(name, { argumentsJson, content: data.content, isError: failed, meta: data.meta })
+            ?? cardFromLines(view?.kind ?? 'generic', name, view?.title ?? name, contentLinesOf(data.content), failed);
+    }
+    /** The row a call's result settles into: the card it drew, restated with what answered it. */
+    settleResult(data) {
+        const message = asRecord(data.message);
+        const firstBlock = Array.isArray(message?.content) ? asRecord(message.content[0]) : undefined;
+        const callId = typeof firstBlock?.toolCallId === 'string' ? firstBlock.toolCallId : '';
+        const pending = callId === '' ? undefined : this.pending.get(callId);
+        if (callId !== '')
+            this.pending.delete(callId);
+        // The length of the run is readable here and nowhere else: the surface saw
+        // the call logged and now sees it answered, and this is the only moment the
+        // fold holds both readings of the clock.
+        const ranFor = pending === undefined ? undefined : this.secondsSince(pending.startedAt);
+        /** The card that reports this result, carrying the seconds the call took. */
+        const finished = (card) => (ranFor === undefined ? card : { ...card, elapsed: ranFor });
+        // The root is done dispatching, so its bookkeeping goes with it; the rows it
+        // already drew stay on the card.
+        if (pending !== undefined)
+            for (const sub of pending.subs)
+                this.pendingSub.delete(sub);
+        const name = pending?.name ?? 'tool';
+        const isError = message?.isError === true;
+        const result = this.presenter?.result(name, {
+            argumentsJson: pending?.argumentsJson ?? '',
+            content: message?.content,
+            isError,
+            meta: data.meta,
+        });
+        if (pending === undefined) {
+            // No matching call in this fold: a resumed transcript may start mid-call.
+            return {
+                appends: [{
+                        kind: 'tool',
+                        id: callId,
+                        card: result ?? cardFromLines('generic', name, name, contentLinesOf(message?.content), isError),
+                    }],
+                replacements: [],
+            };
+        }
+        const call = this.cardAt(pending.index);
+        if (result === undefined) {
+            // No presenter answered: the model-facing content is still what happened,
+            // and a reader without it would see a tool row that never reported back.
+            const reported = contentLinesOf(message?.content);
+            const base = call ?? cardFromLines('generic', name, name, [], false);
+            const rebuilt = reported.length === 0
+                ? { ...base, failed: isError }
+                : { ...cardFromLines(base.kind, base.tool, base.title, reported, isError), ...carriedFields(base) };
+            return { appends: [], replacements: [{ index: pending.index, entry: { kind: 'tool', id: callId, card: finished(rebuilt) } }] };
+        }
+        // Two readings decide this, and either is enough: the log says whether the tool
+        // raised, and the card the presenter built says how the call itself ended — a
+        // shell's non-zero exit is a failure the log's flag never carries.
+        const settledCard = mergeCards(call, { ...result, failed: result.failed || isError });
+        return { appends: [], replacements: [{ index: pending.index, entry: { kind: 'tool', id: callId, card: finished(settledCard) } }] };
+    }
+}
+/** The arguments a nested call was made with, as the shape a presenter is asked with. */
+function argumentsJsonOf(value) {
+    if (value === undefined)
+        return '';
+    try {
+        return JSON.stringify(value) ?? '';
+    }
+    catch {
+        return '';
+    }
+}
+/** Narrowing for the structural event reads above; each reader keeps its own copy rather than sharing one. */
+function asRecord(value) {
+    return typeof value === 'object' && value !== null ? value : undefined;
+}
+//# sourceMappingURL=tool-calls.js.map

package/lib/transcript/tool-calls.js.map

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

package/lib/transcript.d.ts

@@ -1,4 +1,5 @@
-import { type ToolCard, type ToolPresenter } from './cards.ts';
+import type { ToolCard, ToolPresenter } from './cards.ts';
+import { type LiveCallState } from './transcript/tool-calls.ts';
 /** One renderable transcript row. */
 export type TranscriptEntry = {
     readonly kind: 'user';
@@ -43,21 +44,17 @@ export interface FoldableEvent {
  * Durable events own the transcript: the live stream is decoration that a
  * repaint or a resume can drop without changing what the reader sees. Tool
  * rows come from the tool's own render intent, so the fold never learns a tool
- * name.
+ * name; the bookkeeping that a tool row's request, dispatch, and result share
+ * lives in the call fold this model routes those events to.
  */
 export declare class TranscriptModel {
-    private readonly presenter?;
-    /** Clock for "how long has this been thinking"; injected so a test can pin it. */
-    private readonly now;
-    private readonly settled;
-    private readonly pending;
     /**
-     * Where each nested call landed on its root card.
-     *
-     * A dispatch logs a start and then a settle, so the second event has to find
-     * the row the first one drew instead of adding a second line for one call.
+     * Clock for "how long has this been thinking or running"; injected so a test
+     * can pin it and reachable through {@link now} so a renderer keys its rows
+     * to the same one.
      */
-    private readonly pendingSub;
+    private readonly clock;
+    private readonly settled;
     private live;
     private liveReasoning;
     private reasoningStartedAt;
@@ -76,9 +73,23 @@ export declare class TranscriptModel {
      */
     private thoughtSeq;
     private liveReasoningId;
-    constructor(presenter?: ToolPresenter | undefined, 
-    /** Clock for "how long has this been thinking"; injected so a test can pin it. */
-    now?: () => number);
+    /** The call-to-row bookkeeping tool events share, told the clock and the rows this model holds. */
+    private readonly calls;
+    constructor(presenter?: ToolPresenter, 
+    /**
+     * Clock for "how long has this been thinking or running"; injected so a test
+     * can pin it and reachable through {@link now} so a renderer keys its rows
+     * to the same one.
+     */
+    clock?: () => number);
+    /**
+     * The clock every duration on a row is measured with.
+     *
+     * A renderer that caches rows has to know when a running row's duration would
+     * have changed, and reading the same clock the fold timed the call with is the
+     * only way for the number on screen and the cache key to agree.
+     */
+    now(): number;
     /** Rows to render: settled rows, the in-flight reasoning, then the in-flight text. */
     entries(): readonly TranscriptEntry[];
     /**
@@ -89,6 +100,14 @@ export declare class TranscriptModel {
      * changing.
      */
     settledCount(): number;
+    /**
+     * How long one call has been in flight, or that it is not.
+     *
+     * The call fold owns the request-to-result window, so a renderer asks here
+     * rather than timing the row itself: a row read twice in one frame would
+     * otherwise report two durations for one call.
+     */
+    liveCall(callId: string): LiveCallState;
     /** Whether any row exists, so a caller can decide to clear or redraw. */
     isEmpty(): boolean;
     reset(): void;
@@ -112,33 +131,9 @@ export declare class TranscriptModel {
     /** Settle the reasoning streamed so far into a row of its own. */
     private settleReasoning;
     apply(event: FoldableEvent): void;
-    /**
-     * Fold one nested PTC call onto the card of the run_code call that dispatched it.
-     *
-     * Dispatches are logged while the program runs, so the root is still pending;
-     * a dispatch whose root is not in this fold belongs to a window that starts
-     * mid-run, and attaching it to another card would claim a call that card
-     * never made.
-     */
-    private applySubCall;
-    /**
-     * The row a settle leaves behind, once the outcome the call produced is known.
-     *
-     * A row that failed keeps only what still holds: its declared change never
-     * happened, so those rows go with the outcome that never came, while the
-     * outcome stays because the reason it failed is what a reader opens it to read.
-     */
-    private settledSubCall;
-    /**
-     * The outcome a dispatched call opens to, from the view its result presented.
-     *
-     * A presenter can only rebuild the view it declared when the logged content is
-     * enough for it: a shell's output is, while a read's numbered window and a
-     * search's hits live in the metadata a dispatch does not carry. The fallback is
-     * the content the program was actually shown, so a row whose tool cannot be
-     * re-presented still opens to its outcome rather than to nothing.
-     */
-    private subCallOutcome;
-    private settleToolResult;
+    /** Commit the rows the call fold drew: appends in order, replacements in place. */
+    private commit;
+    /** The card a settled tool row holds, so the call fold can restate a row it drew earlier. */
+    private cardAt;
 }
 //# sourceMappingURL=transcript.d.ts.map

package/lib/transcript.d.ts.map

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