@gkorepanov/ccodex 0.5.0-rc.2 → 0.5.0-rc.21

package/dist/claude/native/pages.js

@@ -0,0 +1,271 @@
+/**
+ * Owns paged reads of a Claude transcript. History is projected from windows read back from the end of the file, as
+ * far as a page needs, never the whole file: Desktop pages a thread (`thread/turns/list`, `thread/items/list`) and
+ * a transcript grows to hundreds of megabytes.
+ */
+import { open, stat } from "node:fs/promises";
+import { backgroundEnds, projectTranscript } from "./projector.js";
+import { parseTranscriptLine } from "./records.js";
+const CHUNK_BYTES = 1 << 20;
+/** Turns the live window keeps beyond what was asked: the next page of a scroll back needs no read. */
+const KEPT_TURNS = 12;
+/** Windows kept while the file stays as it is: Desktop asks each turn of a page for its items right after the page. */
+const RECENT_WINDOWS = 4;
+function emptyWindow(end) {
+    return { start: end, end, records: [], positions: [], offsets: new Map() };
+}
+async function readRange(path, from, to) {
+    const handle = await open(path, "r");
+    try {
+        const bytes = Buffer.alloc(to - from);
+        const { bytesRead } = await handle.read(bytes, 0, bytes.length, from);
+        return bytes.subarray(0, bytesRead);
+    }
+    finally {
+        await handle.close();
+    }
+}
+/** Complete lines of `bytes` (read at `at`) from `first` up to the last newline: records with their line offsets. */
+function parseLines(bytes, at, first) {
+    const records = [];
+    const positions = [];
+    let line = first;
+    for (let newline = bytes.indexOf(0x0a, line); newline !== -1; newline = bytes.indexOf(0x0a, line)) {
+        const record = parseTranscriptLine(bytes.subarray(line, newline));
+        if (record) {
+            records.push(record);
+            positions.push(at + line);
+        }
+        line = newline + 1;
+    }
+    return { records, positions, end: at + line };
+}
+function uuidOf(record) {
+    return "uuid" in record && typeof record.uuid === "string" ? record.uuid : undefined;
+}
+/** Extends the window back by up to `chunk` bytes; false when no whole line fits in them (a longer chunk will). */
+async function readBack(path, window, chunk, ends) {
+    const from = Math.max(0, window.start - chunk);
+    const bytes = await readRange(path, from, window.start);
+    const first = from === 0 ? 0 : bytes.indexOf(0x0a) + 1;
+    if (first === 0 && from > 0)
+        return false;
+    const parsed = parseLines(bytes, from, first);
+    // A window opened at the end of the file ends at its last whole line (Claude may be writing the next one).
+    if (window.start === window.end)
+        window.end = parsed.end;
+    else if (parsed.end !== window.start)
+        throw new Error(`${path}: a line runs past a window's start`);
+    window.start = from + first;
+    backgroundEnds(parsed.records, ends);
+    window.records.unshift(...parsed.records);
+    window.positions.unshift(...parsed.positions);
+    parsed.records.forEach((record, index) => {
+        const uuid = uuidOf(record);
+        if (uuid && !window.offsets.has(uuid))
+            window.offsets.set(uuid, parsed.positions[index]);
+    });
+    return true;
+}
+/** Appends what Claude wrote since the window's end. */
+async function readForward(path, window, size, ends) {
+    if (size <= window.end || !window.records.length)
+        return;
+    const parsed = parseLines(await readRange(path, window.end, size), window.end, 0);
+    backgroundEnds(parsed.records, ends);
+    window.end = parsed.end;
+    window.records.push(...parsed.records);
+    window.positions.push(...parsed.positions);
+    parsed.records.forEach((record, index) => {
+        const uuid = uuidOf(record);
+        if (uuid)
+            window.offsets.set(uuid, parsed.positions[index]);
+    });
+}
+/** Where the line after `uuid`'s starts. */
+function after(window, uuid) {
+    const offset = window.offsets.get(uuid);
+    let low = 0;
+    let high = window.positions.length;
+    while (low < high) {
+        const middle = (low + high) >> 1;
+        if (window.positions[middle] <= offset)
+            low = middle + 1;
+        else
+            high = middle;
+    }
+    return window.positions[low] ?? window.end;
+}
+/** Drops the window's records before `offset`. */
+function trim(window, offset) {
+    const index = window.positions.findIndex((position) => position >= offset);
+    if (index <= 0)
+        return;
+    window.records.splice(0, index);
+    window.positions.splice(0, index);
+    window.start = window.positions[0];
+    for (const [uuid, position] of window.offsets)
+        if (position < window.start)
+            window.offsets.delete(uuid);
+}
+export class TranscriptPages {
+    chunkBytes;
+    /** The newest part of the file; follows Claude's writes. */
+    live;
+    places = new Map();
+    /**
+     * How background commands ended, from every part of the file read. A turn is read after the turns that follow it
+     * (pages go back from the end), so its commands' ends are known by then.
+     */
+    ends = new Map();
+    /** Windows projected lately, newest first, for the file as it was (`key`). */
+    recent = { key: "", windows: [] };
+    queue = Promise.resolve();
+    constructor(chunkBytes = CHUNK_BYTES) {
+        this.chunkBytes = chunkBytes;
+    }
+    /** The newest turns: at least `count` of them unless history is shorter. */
+    newest(source, count) {
+        return this.serial(() => this.liveWindow(source, (turns) => turns.length >= count, count));
+    }
+    /** The window of `turnId` (the last of its turns unless it is the newest) with at least `before` turns before it. */
+    around(source, turnId, before) {
+        return this.serial(async () => {
+            const reaches = (turns) => turns.findIndex((turn) => turn.id === turnId) >= before;
+            let place = this.places.get(turnId);
+            if (!place) {
+                // Not paged to yet (a cursor from before a restart): back from the end until it shows.
+                const found = await this.liveWindow(source, (turns) => turns.some((turn) => turn.id === turnId), 1);
+                if (!found.turns.some((turn) => turn.id === turnId))
+                    throw new Error(`turn not found: ${turnId}`);
+                place = this.places.get(turnId);
+            }
+            if (place.end === undefined)
+                return this.liveWindow(source, reaches, 1);
+            const { physical, end, lastUuid } = place;
+            const { ino, size } = await stat(source.path);
+            // A turn alone (its items) reads the same in any window holding it whole; a page's turns before it do not: where
+            // history starts depends on where the window was read from (a compaction).
+            const known = before === 0 && this.recentWindows(source, ino, size).find((window) => reaches(window.turns));
+            if (known)
+                return known;
+            return this.remember(await this.fill(source, emptyWindow(end), lastUuid, true, reaches, physical));
+        });
+    }
+    /** The newest turns back to the one holding the record at `offset` (bytes into the file). */
+    reaching(source, offset) {
+        return this.serial(() => this.liveWindow(source, (_turns, start) => start !== undefined && start <= offset, 1));
+    }
+    /** The newest turns back to `turnId`. */
+    since(source, turnId) {
+        return this.serial(() => this.liveWindow(source, (turns) => turns.some((turn) => turn.id === turnId), 1));
+    }
+    /** The last record of the turn before `turnId` (of `turnId` itself when `inclusive`); null before the first turn. */
+    async boundary(source, turnId, inclusive) {
+        if (!this.places.has(turnId))
+            await this.around(source, turnId, 0);
+        const place = this.places.get(turnId);
+        return inclusive ? place.boundary : place.previousBoundary;
+    }
+    /** The windows projected lately, while the file is as it was then. */
+    recentWindows(source, ino, size) {
+        const key = `${ino}:${size}:${source.leafUuid ?? ""}:${source.peersVersion}`;
+        if (this.recent.key !== key)
+            this.recent = { key, windows: [] };
+        return this.recent.windows;
+    }
+    remember(window) {
+        this.recent.windows = [window, ...this.recent.windows.filter((entry) => entry !== window)].slice(0, RECENT_WINDOWS);
+        return window;
+    }
+    serial(work) {
+        const run = this.queue.then(work, work);
+        this.queue = run.catch(() => undefined);
+        return run;
+    }
+    async liveWindow(source, enough, keep) {
+        const { ino, size } = await stat(source.path);
+        if (!this.live || this.live.ino !== ino || size < this.live.end) {
+            this.live = { ...emptyWindow(size), ino };
+            this.places.clear();
+            this.ends.clear();
+        }
+        const live = this.live;
+        this.recentWindows(source, ino, size);
+        await readForward(source.path, live, size, this.ends);
+        const key = `${live.start}:${live.end}:${source.leafUuid ?? ""}:${source.peersVersion}`;
+        if (live.cache?.key === key && (!live.cache.window.older || enough(live.cache.window.turns)))
+            return this.remember(live.cache.window);
+        const window = this.remember(await this.fill(source, live, source.leafUuid, false, enough));
+        // The window stays a few pages long: it starts again at the turn before the kept ones (their context).
+        const kept = Math.max(keep, KEPT_TURNS);
+        const cut = window.projection.turnBoundaries.at(-kept - 1)?.firstUuid;
+        if (window.turns.length > 2 * kept && cut && enough(window.turns.slice(-kept)))
+            trim(live, live.offsets.get(cut));
+        else
+            live.cache = { key, window };
+        return window;
+    }
+    /** Reads the window back until its turns are `enough` or history starts in it. */
+    async fill(source, window, leafUuid, continues, enough, physical = false) {
+        for (let chunk = this.chunkBytes;; chunk *= 2) {
+            if (window.records.length && (!leafUuid || window.offsets.has(leafUuid))) {
+                const projection = await projectTranscript({
+                    sessionId: source.sessionId, path: source.path, records: window.records, header: source.header,
+                    peers: source.peers, continues, physical, backgroundEnds: this.ends, ...(leafUuid ? { leafUuid } : {}),
+                });
+                // Cut off from its start, the first turn lacks what came before it (a steer's queue, the prompt of the answer it
+                // goes on after): only the turns after it are whole.
+                const older = window.start > 0 && (projection.truncated || projection.selectedLeafUuid === null);
+                // A turn Claude goes on from mid-message: the window of the one before it holds the message's later blocks, the
+                // start of this turn only (past the leaf).
+                const leafAt = projection.selectedLeafUuid ? window.offsets.get(projection.selectedLeafUuid) : window.end;
+                const partial = projection.turnBoundaries.findIndex((bound) => window.offsets.get(bound.firstUuid) > leafAt);
+                const whole = partial < 0 ? projection.turns.length : partial;
+                const turns = projection.turns.slice(older ? 1 : 0, whole);
+                const first = projection.turnBoundaries[older ? 1 : 0];
+                if (!older || enough(turns, first && window.offsets.get(first.firstUuid)) && !projection.partialCompaction) {
+                    this.index(window, projection, older, continues, physical, whole);
+                    return { turns, older, projection };
+                }
+            }
+            else if (window.start === 0) {
+                if (!leafUuid)
+                    return { turns: [], older: false, projection: await projectTranscript({ sessionId: source.sessionId, path: source.path, records: [], header: source.header }) };
+                throw new Error(`${source.path}: record ${leafUuid} not found`);
+            }
+            await readBack(source.path, window, chunk, this.ends);
+        }
+    }
+    index(window, projection, older, continues, physical, whole) {
+        const bounds = projection.turnBoundaries.slice(0, whole);
+        const order = new Map([...projection.selectedRecordUuids].map((uuid, index) => [uuid, index]));
+        const physicalFrom = projection.physicalFrom ? order.get(projection.physicalFrom) : -1;
+        // Where each record's API message ends: a turn Claude goes on from mid-message needs the message's later blocks.
+        const messageOf = new Map();
+        const messageEnds = new Map();
+        window.records.forEach((record, index) => {
+            if (record.type !== "assistant" || !record.message.id)
+                return;
+            messageOf.set(record.uuid, record.message.id);
+            messageEnds.set(record.message.id, window.positions[index + 1] ?? window.end);
+        });
+        bounds.forEach((bound, index) => {
+            if (older && index === 0)
+                return;
+            const next = bounds[index + 1];
+            this.places.set(bound.turnId, {
+                start: window.offsets.get(bound.firstUuid),
+                // Its records end where the next turn starts, unless Claude grouped a later one into it (one API message).
+                end: next
+                    ? Math.max(window.offsets.get(next.firstUuid), after(window, bound.lastUuid), messageEnds.get(messageOf.get(bound.lastUuid)) ?? 0)
+                    : continues ? window.end : undefined,
+                lastUuid: bound.lastUuid,
+                boundary: bound.messageUuid,
+                previousBoundary: bounds[index - 1]?.messageUuid ?? null,
+                physical: physical || order.get(bound.lastUuid) < physicalFrom,
+            });
+        });
+    }
+}
+//# sourceMappingURL=pages.js.map

package/dist/claude/native/pages.js.map

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

package/dist/claude/native/projector.d.ts

@@ -1,6 +1,6 @@
 import type { Thread, ThreadItem, TokenUsageBreakdown, Turn } from "../../protocol/codex.js";
 import { type PeerDirectory } from "../peers.js";
-import { type ActiveTool } from "../toolMapper.js";
+import { type ActiveTool, type BackgroundEnd } from "../toolMapper.js";
 import { type SelectedHistory } from "./history.js";
 import { type ToolResultBlock, type TranscriptRecord, type UserRecord } from "./records.js";
 import { type TranscriptHeader } from "./summary.js";
@@ -19,11 +19,22 @@ export interface ProjectTranscriptInput {
         readonly nickname: string;
         readonly depth: number;
     };
+    /** The records end where a later turn starts (a page of history): their last turn is not the thread's last. */
+    readonly continues?: boolean;
+    /** The leaf lies past a later compaction: see `selectHistory`. */
+    readonly physical?: boolean;
+    /** How background commands ended further on in the transcript than `records` reach (a page of history). */
+    readonly backgroundEnds?: ReadonlyMap<string, BackgroundEnd>;
 }
-/** Last chain record of a projected turn; the native rollback anchor. */
+/** How background commands ended, by task id: Claude's task notifications and its stops of them (TaskStop). */
+export declare function backgroundEnds(records: readonly TranscriptRecord[], ends?: Map<string, BackgroundEnd>): Map<string, BackgroundEnd>;
+/** Chain records bounding a projected turn: `messageUuid` is the native rollback anchor. */
 export interface TurnProviderBoundary {
     readonly turnId: string;
     readonly messageUuid: string;
+    readonly firstUuid: string;
+    /** The turn's last record: a trailing compaction included, unless the `/compact` turn next takes it. */
+    readonly lastUuid: string;
 }
 export interface TranscriptProjection {
     readonly thread: Thread;
@@ -38,6 +49,11 @@ export interface TranscriptProjection {
     readonly turnBoundaries: readonly TurnProviderBoundary[];
     readonly selectedLeafUuid: string | null;
     readonly selectedRecordUuids: ReadonlySet<string>;
+    /** Projected from a window of the transcript whose history goes on before it. */
+    readonly truncated: boolean;
+    /** A compaction in it keeps messages from before the window. */
+    readonly partialCompaction: boolean;
+    readonly physicalFrom: string | null;
 }
 export interface ToolCompletion {
     readonly record: Pick<UserRecord, "toolUseResult" | "toolDenialKind">;

package/dist/claude/native/projector.js

@@ -1,13 +1,37 @@
 /** Owns pure projection of selected Claude transcript history into Codex protocol objects. */
 import { isAbsolute, resolve } from "node:path";
+import { parseCommands } from "../commandActions.js";
 import { CODEX_MCP_TOOLS, codexMcpItems } from "../codexRollout.js";
 import { normalizeClaudeModelIdentifier } from "../modelSelection.js";
-import { NO_PEERS, peerMessageItem, peerOrigin, sentMessageItem } from "../peers.js";
-import { projectToolCompletion, startTool, } from "../toolMapper.js";
+import { NO_PEERS, peerMessageItem, peerOrigin, sentMessageItem, subagentFiles } from "../peers.js";
+import { endedBackground, killedCommand, projectToolCompletion, taskOutputFile, startTool, stoppedCommand, taskNotification, } from "../toolMapper.js";
 import { selectHistory } from "./history.js";
 import { ANSWER_CHARS, assistantBlockItemId, continuationTurnId } from "./ids.js";
 import { isCompactBoundary, readTranscriptRecords, } from "./records.js";
 import { slashCommand, startsTurn, summarizeTranscript, timestampSeconds, userText, } from "./summary.js";
+/** How background commands ended, by task id: Claude's task notifications and its stops of them (TaskStop). */
+export function backgroundEnds(records, ends = new Map()) {
+    for (const record of records) {
+        // A command Stop killed: Claude queues its notification but never sends it (a sent one, later, tells more).
+        const killed = record.type === "queue-operation" && record.operation === "enqueue"
+            ? taskNotification(record.content ?? "", Date.parse(record.timestamp ?? "")) : undefined;
+        if (killed) {
+            ends.set(killed.taskId, killed.end);
+            if (killed.toolUseId)
+                ends.set(killed.toolUseId, { ...killed.end, taskId: killed.taskId });
+        }
+        if (record.type !== "user")
+            continue;
+        const atMs = Date.parse(record.timestamp);
+        const notified = record.origin?.kind === "task-notification" ? taskNotification(userText(record), atMs) : undefined;
+        if (notified)
+            ends.set(notified.taskId, notified.end);
+        const stopped = stoppedCommand(record.toolUseResult);
+        if (stopped)
+            ends.set(stopped, { status: "stopped", summary: "", atMs });
+    }
+    return ends;
+}
 /** Claude's token use over a history, and of its last request (Desktop's context meter). */
 function projectedUsage(records) {
     const total = {
@@ -86,6 +110,13 @@ function assistantBlocks(record) {
         return [];
     return record.message.content.filter((block) => block !== null && typeof block === "object");
 }
+/** Claude Code's filler reply to a turn cut off mid-way, written when the session resumes; its own UI hides it. */
+function resumeFiller(record) {
+    if (record.type !== "assistant" || record.isApiErrorMessage === true || record.message.model !== "<synthetic>")
+        return false;
+    const blocks = assistantBlocks(record);
+    return blocks.length === 1 && blocks[0].text === "No response requested.";
+}
 function outputText(value) {
     if (typeof value === "string")
         return value;
@@ -167,14 +198,30 @@ function activeTool(index, block, cwd, threadId, timestamp) {
     }
     return startTool(index, block, cwd, threadId);
 }
-function projectTool(block, blockIndex, record, cwd, threadId, completions, peers) {
+function projectTool(block, blockIndex, record, cwd, threadId, completions, peers, ends) {
     const started = activeTool(blockIndex, block, cwd, threadId, record.timestamp);
     const completion = completions.get(block.id);
     const result = completion?.record.toolUseResult;
     const item = sentMessageItem(started.item, started.state.input, result, peers);
     if (!completion)
         return item;
-    return completedToolItem({ state: { ...started.state, startedAtMs: Date.parse(record.timestamp) }, item }, { ...completion, record: { ...completion.record, toolUseResult: { ...result, duration_ms: typeof result?.duration_ms === "number" ? result.duration_ms : 0 } } }, cwd);
+    // An MCP tool's result is its content (text or blocks), not an object of fields.
+    const fields = typeof result === "object" && !Array.isArray(result) ? result : undefined;
+    const startedAtMs = Date.parse(record.timestamp);
+    const completed = completedToolItem({ state: { ...started.state, startedAtMs }, item }, { ...completion, record: { ...completion.record, toolUseResult: { ...fields, duration_ms: typeof fields?.duration_ms === "number" ? fields.duration_ms : 0 } } }, cwd);
+    // A background command runs on past its turn: it ends as its task notification (or a stop) tells. With neither, its
+    // Claude process ended first (a running one shows live).
+    const taskId = typeof fields?.backgroundTaskId === "string" ? fields.backgroundTaskId : undefined;
+    const output = (end, task) => end.outputFile ?? taskOutputFile(cwd, record.sessionId, task);
+    const killed = taskId ? undefined : ends.get(block.id);
+    if (killed?.taskId)
+        return killedCommand(completed, output(killed, killed.taskId));
+    if (!taskId || completed.type !== "commandExecution")
+        return completed;
+    const background = { ...completed, processId: taskId };
+    const end = ends.get(taskId);
+    return end ? endedBackground(background, { ...end, outputFile: output(end, taskId) }, startedAtMs)
+        : { ...background, status: "failed", exitCode: null, aggregatedOutput: null };
 }
 /** A started tool item completed by its tool_result; shared by history projection and the live stream. */
 export function completedToolItem(started, completion, cwd) {
@@ -219,26 +266,27 @@ function responseHasTools(records) {
     }
     return result;
 }
+/**
+ * A block's item id: its API message and block index. A record without the index (older Claude Code; 0.4's restored
+ * turns, whose messages all share one id) is named by its own uuid, a synthetic reply by its message id as live names it.
+ */
+function blockItemId(record, position) {
+    if (record.apiBlockIndex !== undefined)
+        return assistantBlockItemId(record.message.id, record.apiBlockIndex + position);
+    return assistantBlockItemId(record.message.model === "<synthetic>" ? record.message.id : record.uuid, position);
+}
 function responseBlocks(records) {
     const ordered = records
         .map((record, order) => ({ record, order }))
         .sort((left, right) => (left.record.apiBlockIndex ?? left.order) - (right.record.apiBlockIndex ?? right.order));
-    let fallbackIndex = 0;
-    return ordered.flatMap(({ record }) => assistantBlocks(record).map((block, blockIndex) => {
-        const apiBlockIndex = record.apiBlockIndex === undefined
-            ? fallbackIndex
-            : record.apiBlockIndex + blockIndex;
-        fallbackIndex = Math.max(fallbackIndex, apiBlockIndex + 1);
-        return { record, block, apiBlockIndex };
-    }));
+    return ordered.flatMap(({ record }) => assistantBlocks(record).map((block, position) => ({ record, block, index: (record.apiBlockIndex ?? 0) + position, id: blockItemId(record, position) })));
 }
-function assistantItems(records, cwd, threadId, completions, toolResponses, codexCalls, peers) {
+function assistantItems(records, cwd, threadId, completions, toolResponses, codexCalls, peers, ends) {
     let reasoning;
-    return responseBlocks(records).flatMap(({ record, block, apiBlockIndex }) => {
-        const messageId = record.message.id;
+    return responseBlocks(records).flatMap(({ record, block, index, id }) => {
         if (block.type === "text" && typeof block.text === "string")
             return [{
-                    type: "agentMessage", id: assistantBlockItemId(messageId, apiBlockIndex), text: block.text,
+                    type: "agentMessage", id, text: block.text,
                     phase: record.message.id && toolResponses.has(record.message.id) ? "commentary" : "final_answer",
                     memoryCitation: null, delivery: null, questions: null,
                 }];
@@ -248,17 +296,21 @@ function assistantItems(records, cwd, threadId, completions, toolResponses, code
                 return [];
             }
             const item = {
-                type: "reasoning", id: assistantBlockItemId(messageId, apiBlockIndex), summary: [block.thinking], content: [],
+                type: "reasoning", id, summary: [block.thinking], content: [],
             };
             reasoning = item;
             return [item];
         }
         if (["tool_use", "server_tool_use", "mcp_tool_use"].includes(String(block.type))
             && typeof block.id === "string" && typeof block.name === "string") {
-            const item = projectTool(block, apiBlockIndex, record, cwd, threadId, completions, peers);
+            const completion = completions.get(block.id);
+            // Stopping a background command shows on the command (stock's Ctrl-C), not as a call of its own.
+            if (stoppedCommand(completion?.record.toolUseResult))
+                return [];
+            const item = projectTool(block, index, record, cwd, threadId, completions, peers, ends);
             if (!CODEX_MCP_TOOLS.has(block.name))
                 return [item];
-            const result = completions.get(block.id)?.block.content;
+            const result = completion?.block.content;
             return [item, ...codexMcpItems(block.id, object(block.input) ?? {}, result === undefined ? undefined : outputText(result), codexCalls)];
         }
         return [];
@@ -267,7 +319,7 @@ function assistantItems(records, cwd, threadId, completions, toolResponses, code
 function turnStatus(records, hasFollowingTurn) {
     const failed = records.some((record) => record.type === "system" && record.subtype === "api_error"
         || record.type === "assistant" && (record.isApiErrorMessage === true || Boolean(record.error)));
-    const interrupted = records.some((record) => record.type === "user" && (record.interruptedByShutdown === true
+    const interrupted = records.some((record) => resumeFiller(record) || record.type === "user" && (record.interruptedByShutdown === true
         || record.toolUseResult?.interrupted === true || /^\[Request interrupted by user(?: for tool use)?\]$/u.test(userText(record))));
     if (interrupted)
         return "interrupted";
@@ -348,7 +400,7 @@ function turnStarts(records, subagentPromptUuid, steered) {
             assistantBlocks(record).forEach((block, position) => {
                 if (answer)
                     goOn(index);
-                lastBlock = assistantBlockItemId(record.message.id, (record.apiBlockIndex ?? 0) + position);
+                lastBlock = blockItemId(record, position);
                 answer = block.type === "text" && typeof block.text === "string" && block.text.length >= ANSWER_CHARS;
             });
         }
@@ -373,22 +425,18 @@ function turnStarts(records, subagentPromptUuid, steered) {
     });
     return starts;
 }
-/** The session's sub-agents, from the results of the calls that started them. */
-function subagentIds(completions) {
-    return new Set([...completions.values()].flatMap(({ record }) => string(record.toolUseResult?.agentId) ?? []));
-}
-function projectTurns(records, cwd, threadId, subagentPromptUuid, steered, directory) {
+function projectTurns(records, cwd, threadId, subagentPromptUuid, steered, directory, continues, path, ends) {
     const starts = turnStarts(records, subagentPromptUuid, steered);
     const completions = toolCompletions(records);
-    const peers = { directory, children: subagentIds(completions) };
+    // As live: a window of history lacks the calls that started earlier sub-agents.
+    const peers = { directory, children: subagentFiles(path) };
     const toolResponses = responseHasTools(records);
     const codexCalls = new Map();
     const turns = starts.map(({ index: start, id, prompt }, turnIndex) => {
         const end = starts[turnIndex + 1]?.index ?? records.length;
         const turnRecords = records.slice(start, end);
         const input = prompt ? userInputs(prompt) : [];
-        const hiddenCommand = input.length === 1 && input[0]?.type === "text"
-            && /^\/(?:compact(?:\s|$)|goal clear$)/u.test(input[0].text);
+        const hiddenCommand = input.length === 1 && input[0]?.type === "text" && /^\/compact(?:\s|$)/u.test(input[0].text);
         const peer = peerOrigin(prompt?.origin);
         const items = peer ? [peerMessageItem(prompt.uuid, peer, userText(prompt), peers)]
             : hiddenCommand || !prompt ? []
@@ -404,22 +452,26 @@ function projectTurns(records, cwd, threadId, subagentPromptUuid, steered, direc
         }
         const projectedResponses = new Set();
         for (const record of prompt ? turnRecords.slice(1) : turnRecords) {
+            if (resumeFiller(record))
+                continue;
             if (record.type === "assistant") {
                 const messageId = record.message.id;
                 if (projectedResponses.has(messageId))
                     continue;
                 projectedResponses.add(messageId);
-                items.push(...assistantItems(responses.get(messageId), cwd, threadId, completions, toolResponses, codexCalls, peers));
+                items.push(...assistantItems(responses.get(messageId), cwd, threadId, completions, toolResponses, codexCalls, peers, ends));
             }
             else if (record.type === "user" && peerOrigin(record.origin)) {
                 items.push(peerMessageItem(record.uuid, peerOrigin(record.origin), userText(record), peers));
             }
+            // A steer's id is the client's own (Desktop shows a message of a turn after its first only with it).
             else if (record.type === "user" && steered.has(record.uuid)) {
-                items.push({ type: "userMessage", id: record.uuid, clientId: null, content: userInputs(record) });
+                items.push({ type: "userMessage", id: record.uuid, clientId: record.uuid, content: userInputs(record) });
             }
             else if (record.type === "system" && record.subtype === "local_command" && typeof record.content === "string") {
                 const text = record.content.replace(/<\/?local-command-std(?:out|err)>/gu, "").trim();
-                if (text)
+                // Claude's own word on `/goal` ("Goal set: …"): Codex clients show goals themselves.
+                if (text && record.commandRun?.command !== "goal")
                     items.push({ type: "agentMessage", id: record.uuid, text, phase: "commentary", memoryCitation: null });
             }
             else if (isCompactBoundary(record))
@@ -431,19 +483,17 @@ function projectTurns(records, cwd, threadId, subagentPromptUuid, steered, direc
                 if (attachment?.type === "queued_command" && peer) {
                     items.push(peerMessageItem(string(attachment.source_uuid) ?? record.uuid, peer, string(attachment.prompt) ?? "", peers));
                 }
-                else if (attachment?.type === "queued_command" && attachment.commandMode === "prompt" && typeof attachment.prompt === "string") {
-                    items.push({
-                        type: "userMessage", id: string(attachment.source_uuid) ?? record.uuid, clientId: null,
-                        content: [{ type: "text", text: attachment.prompt, text_elements: [] }],
-                    });
+                else if (attachment?.type === "queued_command" && attachment.commandMode === "prompt" && (typeof attachment.prompt === "string" || Array.isArray(attachment.prompt))) {
+                    const id = string(attachment.source_uuid) ?? record.uuid;
+                    items.push({ type: "userMessage", id, clientId: id, content: userInputs({ message: { content: attachment.prompt } }) });
                 }
             }
         }
-        const status = turnStatus(turnRecords, turnIndex + 1 < starts.length);
+        const status = turnStatus(turnRecords, continues || turnIndex + 1 < starts.length);
         const startedAt = timestampSeconds(turnRecords[0].timestamp);
-        // A later local command (a model switch) trails the turn in the transcript without extending it.
-        const last = turnRecords.findLast((record) => record.type !== "user" || record === turnRecords[0]
-            || record.isMeta !== true && !/^<(?:command-name|local-command-)/u.test(userText(record)));
+        // A later local command (a model switch) or compaction trails the turn in the transcript without extending it.
+        const last = turnRecords.findLast((record) => record === turnRecords[0] || !isCompactBoundary(record) && (record.type !== "user"
+            || record.isMeta !== true && record.isCompactSummary !== true && !/^<(?:command-name|local-command-)/u.test(userText(record))));
         const completedAt = status === "inProgress" ? null : timestampSeconds(last?.timestamp);
         return {
             id,
@@ -467,14 +517,16 @@ function projectTurns(records, cwd, threadId, subagentPromptUuid, steered, direc
     });
     return turns;
 }
-function projectTurnBoundaries(records, subagentPromptUuid, steered) {
+function projectTurnBoundaries(records, subagentPromptUuid, steered, turns) {
     const starts = turnStarts(records, subagentPromptUuid, steered);
     return starts.map(({ index: start, id }, turnIndex) => {
         const range = records.slice(start + 1, starts[turnIndex + 1]?.index ?? records.length);
         // A compaction that ends the turn (the next turn is the `/compact`) is not part of it: forks stay uncompacted.
         const compaction = range.findLastIndex((record) => isCompactBoundary(record));
         const kept = compaction >= 0 && !range.slice(compaction).some((record) => record.type === "assistant") ? range.slice(0, compaction) : range;
-        return { turnId: id, messageUuid: (kept.at(-1) ?? records[start]).uuid };
+        // A `/compact` turn next took the compaction (see `projectTurns`): this turn's records end before it.
+        const last = compaction >= 0 && turns[turnIndex + 1]?.items[0]?.id === range[compaction].uuid ? kept : range;
+        return { turnId: id, messageUuid: (kept.at(-1) ?? records[start]).uuid, firstUuid: records[start].uuid, lastUuid: (last.at(-1) ?? records[start]).uuid };
     });
 }
 /** The Codex thread for a native session header (list rows, reads, live responses). */
@@ -534,11 +586,14 @@ export async function projectTranscript(input) {
         skippedLines = reader.skippedLines;
         rawRecords = loaded;
     }
-    const history = input.history ?? selectHistory(rawRecords, input.leafUuid);
+    const history = input.history ?? selectHistory(rawRecords, input.leafUuid, input.physical);
     const selected = history.records;
+    await parseCommands(selected.flatMap((record) => record.type === "assistant"
+        ? assistantBlocks(record).flatMap((block) => block.type === "tool_use" && block.name === "Bash" ? string(object(block.input)?.command) ?? [] : [])
+        : []));
     const header = input.header ?? summarizeTranscript(rawRecords, input.subagent?.promptRecordUuid);
     const steered = steeredPrompts(rawRecords);
-    const turns = projectTurns(selected, header.cwd, input.sessionId, input.subagent?.promptRecordUuid, steered, input.peers ?? NO_PEERS.directory);
+    const turns = projectTurns(selected, header.cwd, input.sessionId, input.subagent?.promptRecordUuid, steered, input.peers ?? NO_PEERS.directory, input.continues ?? false, input.path, backgroundEnds(rawRecords, new Map(input.backgroundEnds)));
     const nickname = input.subagent?.nickname ?? null;
     const parentThreadId = input.parentThreadId ?? null;
     const status = turns.at(-1)?.status === "inProgress"
@@ -557,9 +612,12 @@ export async function projectTranscript(input) {
         tokenUsage: projectedUsage(selected),
         skippedLines,
         compactionBoundaries: history.compactionBoundaries,
-        turnBoundaries: projectTurnBoundaries(selected, input.subagent?.promptRecordUuid, steered),
+        turnBoundaries: projectTurnBoundaries(selected, input.subagent?.promptRecordUuid, steered, turns),
         selectedLeafUuid: history.leafUuid,
         selectedRecordUuids: new Set(selected.map((record) => record.uuid)),
+        truncated: history.truncated,
+        partialCompaction: history.partialCompaction,
+        physicalFrom: history.physicalFrom,
     };
 }
 //# sourceMappingURL=projector.js.map