@excitedjs/agent-runtime-claude-code 0.5.0-beta.168 → 0.5.0

package/dist/transcript/reader.js

@@ -0,0 +1,476 @@
+import { budgetTranscriptTurns, isTranscriptTurnCount, readTranscriptBytesAt, renderTranscriptValue, } from '@excitedjs/dreamux-utils';
+import { hasAssistantWithoutHumanBoundary, hasCompletionEvidence, hasOpenTail, isHumanPrompt, } from './completion.js';
+import { claudeQueryFingerprint, decodeClaudeCursor, digest, encodeClaudeCursor, } from './cursor.js';
+import { ClaudeTranscriptError } from './error.js';
+import { openClaudeTranscript, validateClaudeSessionEvidence, } from './opened-file.js';
+import { recoverParallelToolBranches } from './parallel-tools.js';
+import { locateClaudeTranscript, } from './path.js';
+import { applyNativeRewrites } from './rewrites.js';
+const MAX_DECODED_BYTES = 8_388_608;
+const MAX_NATIVE_RECORDS = 20_000;
+const MAX_ELAPSED_MS = 2_000;
+export async function readClaudeTranscript(query, context, testHooks = {}) {
+    if (!isTranscriptTurnCount(query.turns)) {
+        throw new ClaudeTranscriptError('invalid', 'Claude Code transcript query turns must be an integer in 1..50');
+    }
+    const checkpoint = context.checkpoint;
+    if (checkpoint === null) {
+        throw new ClaudeTranscriptError('checkpoint_missing', 'Claude Code transcript is unavailable before a session is established');
+    }
+    const includeTools = query.includeTools ?? true;
+    const env = effectiveEnvironment(context);
+    const located = await locateClaudeTranscript({
+        sessionId: checkpoint.id,
+        cwd: context.cwd,
+        locator: checkpoint.transcript_locator,
+        env,
+    });
+    await testHooks.afterLocate?.();
+    const opened = await openClaudeTranscript(located.path, located.root);
+    if (opened.dev !== located.dev || opened.ino !== located.ino) {
+        await opened.handle.close();
+        throw new ClaudeTranscriptError('unreadable', 'Claude Code transcript changed after validation');
+    }
+    try {
+        await validateClaudeSessionEvidence(opened, checkpoint.id, {
+            ...(testHooks.maxReadChunkBytes !== undefined
+                ? { maxReadChunkBytes: testHooks.maxReadChunkBytes }
+                : {}),
+        });
+        const fingerprint = claudeQueryFingerprint(includeTools);
+        const cursor = query.cursor === undefined
+            ? null
+            : decodeClaudeCursor(query.cursor, fingerprint);
+        const endOffset = Math.min(cursor?.pos ?? opened.size, opened.size);
+        const rewriteEvidence = await verifyRewriteEvidence(opened, cursor, testHooks.maxReadChunkBytes);
+        if (cursor !== null) {
+            await verifyCursorBoundaryDigest(opened, cursor.pos, cursor.bd, testHooks.maxReadChunkBytes);
+        }
+        const window = await readWindow(opened, endOffset, testHooks.maxReadChunkBytes);
+        const parsed = parseEntries(window.bytes, window.startOffset, checkpoint.id);
+        const logical = applyNativeRewrites(parsed.entries);
+        const chain = recoverParallelToolBranches(logical, buildSelectedChain(logical));
+        const nativeTurns = groupTurns(chain, includeTools);
+        const candidates = nativeTurns.slice(-query.turns).reverse();
+        const openTailOnly = cursor === null &&
+            candidates.length === 0 &&
+            (!hasCompletionEvidence(chain) || hasOpenTail(chain));
+        if (candidates.length === 0 &&
+            !openTailOnly &&
+            parsed.boundReached &&
+            hasCompletionEvidence(chain) &&
+            hasAssistantWithoutHumanBoundary(chain)) {
+            throw new ClaudeTranscriptError('scan_unsupported', 'Claude Code completed turn exceeds the bounded scan limit');
+        }
+        const budgeted = budgetTranscriptTurns(candidates.map((candidate) => candidate.turn), context.outputBudgetBytes);
+        const consumed = candidates.slice(0, budgeted.consumed);
+        const hasOlder = !openTailOnly &&
+            (consumed.at(-1)?.start ?? endOffset) > 0 &&
+            (nativeTurns.length > consumed.length || parsed.boundReached);
+        const boundary = consumed.at(-1) ??
+            (hasOlder && candidates.length === 0 ? parsed.oldestProcessed : null);
+        if (boundary !== null &&
+            cursor !== null &&
+            boundary.start >= cursor.pos) {
+            throw new ClaudeTranscriptError('scan_unsupported', 'Claude Code transcript pagination cannot make safe progress');
+        }
+        const nextCursor = boundary !== null && hasOlder
+            ? encodeClaudeCursor({
+                fingerprint,
+                generation: rewriteGeneration(rewriteEvidence),
+                position: boundary.start,
+                boundaryDigest: 'boundaryDigest' in boundary
+                    ? boundary.boundaryDigest
+                    : digest(boundary.boundaryBytes),
+                rewriteWatermark: rewriteEvidence.watermark,
+                rewritePosition: rewriteEvidence.position,
+                rewriteDigest: rewriteEvidence.digest,
+            })
+            : null;
+        return {
+            turns: [...budgeted.turnsNewestFirst].reverse(),
+            nextCursor,
+            truncated: budgeted.truncated,
+        };
+    }
+    finally {
+        await opened.handle.close();
+    }
+}
+async function readWindow(opened, endOffset, maxReadChunkBytes) {
+    const startOffset = Math.max(0, endOffset - MAX_DECODED_BYTES);
+    const length = endOffset - startOffset;
+    const bytes = await readTranscriptBytesAt(opened.handle, startOffset, length, {
+        ...(maxReadChunkBytes !== undefined
+            ? { maxChunkBytes: maxReadChunkBytes }
+            : {}),
+    });
+    return { bytes, startOffset };
+}
+function parseEntries(bytes, baseOffset, sessionId) {
+    const deadline = Date.now() + MAX_ELAPSED_MS;
+    const entriesNewestFirst = [];
+    const firstBoundary = baseOffset === 0 ? 0 : Math.max(0, bytes.indexOf(0x0a) + 1);
+    let lineEnd = bytes.length;
+    if (lineEnd > 0 && bytes[lineEnd - 1] !== 0x0a) {
+        lineEnd = bytes.lastIndexOf(0x0a, lineEnd - 1) + 1;
+    }
+    let cursor = lineEnd;
+    while (cursor > firstBoundary &&
+        entriesNewestFirst.length < MAX_NATIVE_RECORDS &&
+        Date.now() <= deadline) {
+        const previousNewline = bytes.lastIndexOf(0x0a, cursor - 2);
+        const lineStart = Math.max(firstBoundary, previousNewline + 1);
+        const rawEnd = cursor - 1;
+        const raw = bytes.subarray(lineStart, rawEnd).toString('utf8');
+        const value = parseRecord(raw);
+        if (value === null && raw.trim() !== '') {
+            throw new ClaudeTranscriptError('invalid', 'Claude Code transcript contains an invalid native record');
+        }
+        if (value !== null) {
+            const nativeSessionId = stringValue(value['sessionId']);
+            if (nativeSessionId !== null) {
+                if (sessionId !== null && nativeSessionId !== sessionId) {
+                    throw new ClaudeTranscriptError('session_mismatch', 'Claude Code transcript does not belong to the selected session');
+                }
+            }
+            if (isProjectableRecord(value) && nativeSessionId === null) {
+                throw new ClaudeTranscriptError('invalid', 'Claude Code conversation record has no native session id');
+            }
+            entriesNewestFirst.push({
+                start: baseOffset + lineStart,
+                end: baseOffset + cursor,
+                raw,
+                boundaryBytes: bytes.subarray(lineStart, cursor),
+                value,
+            });
+        }
+        cursor = lineStart;
+    }
+    const entries = entriesNewestFirst.reverse();
+    return {
+        entries,
+        oldestProcessed: entries[0] ?? null,
+        boundReached: baseOffset > 0 ||
+            cursor > firstBoundary ||
+            entriesNewestFirst.length >= MAX_NATIVE_RECORDS ||
+            Date.now() > deadline,
+    };
+}
+function buildSelectedChain(entries) {
+    const byId = new Map();
+    const parents = new Set();
+    for (const entry of entries) {
+        const uuid = stringValue(entry.value['uuid']);
+        if (uuid === null)
+            continue;
+        byId.set(uuid, entry);
+        const parent = stringValue(entry.value['parentUuid']);
+        if (parent !== null)
+            parents.add(parent);
+    }
+    const leaf = [...entries]
+        .reverse()
+        .find((entry) => {
+        const uuid = stringValue(entry.value['uuid']);
+        return (uuid !== null &&
+            !parents.has(uuid) &&
+            isConversationParticipant(entry.value));
+    }) ?? null;
+    if (leaf === null)
+        return [];
+    const chain = [];
+    const seen = new Set();
+    let current = leaf;
+    while (current !== undefined && chain.length < MAX_NATIVE_RECORDS) {
+        const uuid = stringValue(current.value['uuid']);
+        if (uuid === null || seen.has(uuid))
+            break;
+        seen.add(uuid);
+        chain.push(current);
+        const parent = stringValue(current.value['parentUuid']) ??
+            stringValue(current.value['logicalParentUuid']);
+        current = parent === null ? undefined : byId.get(parent);
+    }
+    return chain.reverse();
+}
+function groupTurns(chain, includeTools) {
+    const turns = [];
+    let current = [];
+    for (const entry of chain) {
+        if (isHumanPrompt(entry.value)) {
+            commitCurrentTurn(turns, current, includeTools);
+            current = [entry];
+        }
+        else if (current.length > 0) {
+            current.push(entry);
+        }
+    }
+    commitCurrentTurn(turns, current, includeTools);
+    return turns;
+}
+function commitCurrentTurn(turns, entries, includeTools) {
+    if (entries.length === 0 ||
+        !hasCompletionEvidence(entries)) {
+        return;
+    }
+    const blocks = [];
+    const tools = new Map();
+    let startedAt = null;
+    let endedAt = null;
+    for (const entry of entries) {
+        const timestamp = timestampMs(entry.value['timestamp']);
+        startedAt ??= timestamp;
+        endedAt = timestamp ?? endedAt;
+        const type = entry.value['type'];
+        const message = recordValue(entry.value['message']);
+        const content = message?.['content'];
+        if (type === 'user' && isHumanPrompt(entry.value)) {
+            const text = visibleText(content, 'text');
+            if (text !== '') {
+                blocks.push({
+                    kind: 'message',
+                    role: 'user',
+                    text,
+                    truncated: false,
+                });
+            }
+        }
+        else if (type === 'assistant') {
+            if (!Array.isArray(content))
+                continue;
+            const text = visibleText(content, 'text');
+            if (text !== '') {
+                blocks.push({
+                    kind: 'message',
+                    role: 'assistant',
+                    text,
+                    truncated: false,
+                });
+            }
+            for (const nativeBlock of content) {
+                const block = recordValue(nativeBlock);
+                if (block?.['type'] !== 'tool_use')
+                    continue;
+                const id = stringValue(block['id']);
+                const name = stringValue(block['name']);
+                if (id === null || name === null)
+                    continue;
+                const publicIndex = includeTools ? blocks.length : -1;
+                tools.set(id, {
+                    index: publicIndex,
+                    name,
+                    input: renderTranscriptValue(block['input']),
+                    output: null,
+                    status: 'error',
+                });
+                if (includeTools) {
+                    blocks.push({
+                        kind: 'tool',
+                        name,
+                        input: renderTranscriptValue(block['input']),
+                        output: null,
+                        status: 'error',
+                        inputTruncated: false,
+                        outputTruncated: false,
+                    });
+                }
+            }
+        }
+        else if (type === 'user' && Array.isArray(content)) {
+            for (const nativeBlock of content) {
+                const block = recordValue(nativeBlock);
+                if (block?.['type'] !== 'tool_result')
+                    continue;
+                const toolUseId = stringValue(block['tool_use_id']);
+                if (toolUseId === null)
+                    continue;
+                const tool = tools.get(toolUseId);
+                if (tool === undefined)
+                    continue;
+                tool.output = renderToolResult(block['content']);
+                tool.status = block['is_error'] === true ? 'error' : 'ok';
+                if (includeTools) {
+                    const publicBlock = blocks[tool.index];
+                    if (publicBlock?.kind === 'tool') {
+                        publicBlock.output = tool.output;
+                        publicBlock.status = tool.status;
+                    }
+                }
+            }
+        }
+    }
+    turns.push({
+        start: entries[0].start,
+        boundaryDigest: digest(entries[0].boundaryBytes),
+        turn: { startedAt, endedAt, blocks },
+    });
+}
+async function verifyCursorBoundaryDigest(opened, position, expected, maxReadChunkBytes) {
+    const length = Math.min(MAX_DECODED_BYTES, Math.max(0, opened.size - position));
+    const bytes = await readTranscriptBytesAt(opened.handle, position, length, {
+        ...(maxReadChunkBytes !== undefined
+            ? { maxChunkBytes: maxReadChunkBytes }
+            : {}),
+    });
+    const newline = bytes.indexOf(0x0a, 0);
+    if (bytes.length === 0) {
+        throw new ClaudeTranscriptError('cursor_stale', 'Claude Code transcript cursor is stale');
+    }
+    if (newline < 0) {
+        throw new ClaudeTranscriptError('scan_unsupported', 'Claude Code cursor boundary record exceeds the bounded scan limit');
+    }
+    const boundaryBytes = bytes.subarray(0, newline + 1);
+    if (digest(boundaryBytes) !== expected) {
+        throw new ClaudeTranscriptError('cursor_stale', 'Claude Code transcript cursor is stale');
+    }
+}
+function isConversationParticipant(value) {
+    if (value['isSidechain'] === true || value['isMeta'] === true)
+        return false;
+    return (value['type'] === 'user' ||
+        value['type'] === 'assistant' ||
+        (value['type'] === 'system' &&
+            (value['subtype'] === 'compact_boundary' ||
+                value['subtype'] === 'turn_duration')));
+}
+function isProjectableRecord(value) {
+    return (value['type'] === 'user' ||
+        value['type'] === 'assistant' ||
+        (value['type'] === 'system' && value['subtype'] === 'turn_duration'));
+}
+async function verifyRewriteEvidence(opened, cursor, maxReadChunkBytes) {
+    if (cursor === null) {
+        const start = Math.max(0, opened.size - MAX_DECODED_BYTES);
+        return scanRewriteEvidence(opened, start, opened.size, start === 0, maxReadChunkBytes);
+    }
+    if (cursor.gen !==
+        rewriteGeneration({
+            watermark: cursor.rw,
+            position: cursor.rp,
+            digest: cursor.rd,
+        })) {
+        throw new ClaudeTranscriptError('cursor_stale', 'Claude Code transcript cursor is stale');
+    }
+    if (cursor.rw > opened.size) {
+        throw new ClaudeTranscriptError('cursor_stale', 'Claude Code transcript cursor is stale');
+    }
+    if (cursor.rp !== null && cursor.rd !== null) {
+        await verifyCursorBoundaryDigest(opened, cursor.rp, cursor.rd, maxReadChunkBytes);
+    }
+    const appended = await scanRewriteEvidence(opened, cursor.rw, opened.size, true, maxReadChunkBytes);
+    if (appended.position !== null) {
+        throw new ClaudeTranscriptError('cursor_stale', 'Claude Code transcript cursor is stale');
+    }
+    return {
+        watermark: appended.watermark,
+        position: cursor.rp,
+        digest: cursor.rd,
+    };
+}
+async function scanRewriteEvidence(opened, start, end, startsAtBoundary, maxReadChunkBytes) {
+    const length = end - start;
+    if (length > MAX_DECODED_BYTES) {
+        throw new ClaudeTranscriptError('scan_unsupported', 'Claude Code rewrite interval exceeds the bounded scan limit');
+    }
+    const data = await readTranscriptBytesAt(opened.handle, start, length, {
+        ...(maxReadChunkBytes !== undefined
+            ? { maxChunkBytes: maxReadChunkBytes }
+            : {}),
+    });
+    let position = null;
+    let evidenceDigest = null;
+    let cursor = startsAtBoundary
+        ? 0
+        : data.indexOf(0x0a) + 1;
+    if (cursor === 0 && !startsAtBoundary && data.length > 0) {
+        throw new ClaudeTranscriptError('scan_unsupported', 'Claude Code rewrite scan cannot find a bounded record boundary');
+    }
+    while (cursor < data.length) {
+        const newline = data.indexOf(0x0a, cursor);
+        if (newline < 0)
+            break;
+        const raw = data.subarray(cursor, newline).toString('utf8');
+        const value = parseRecord(raw);
+        if (value === null && raw.trim() !== '') {
+            throw new ClaudeTranscriptError('invalid', 'Claude Code transcript contains an invalid native record');
+        }
+        if (value !== null && isRewriteRecord(value)) {
+            position = start + cursor;
+            evidenceDigest = digest(data.subarray(cursor, newline + 1));
+        }
+        cursor = newline + 1;
+    }
+    return {
+        watermark: start + cursor,
+        position,
+        digest: evidenceDigest,
+    };
+}
+function rewriteGeneration(evidence) {
+    return digest(JSON.stringify({
+        watermark: evidence.watermark,
+        position: evidence.position,
+        digest: evidence.digest,
+    }));
+}
+function isRewriteRecord(value) {
+    return (value['type'] === 'summary' ||
+        (value['type'] === 'system' &&
+            value['subtype'] === 'compact_boundary') ||
+        value['snipMetadata'] !== undefined);
+}
+function visibleText(value, type) {
+    if (typeof value === 'string')
+        return value;
+    if (!Array.isArray(value))
+        return '';
+    return value
+        .flatMap((entry) => {
+        const block = recordValue(entry);
+        return block?.['type'] === type && typeof block['text'] === 'string'
+            ? [block['text']]
+            : [];
+    })
+        .join('');
+}
+function renderToolResult(value) {
+    if (typeof value === 'string')
+        return value;
+    if (Array.isArray(value)) {
+        const text = visibleText(value, 'text');
+        if (text !== '')
+            return text;
+    }
+    return renderTranscriptValue(value);
+}
+function parseRecord(raw) {
+    try {
+        return recordValue(JSON.parse(raw));
+    }
+    catch {
+        return null;
+    }
+}
+function effectiveEnvironment(context) {
+    return {
+        ...process.env,
+        ...(context.injectEnv ?? {}),
+        ...context.config.extra_env,
+    };
+}
+function timestampMs(value) {
+    if (typeof value !== 'string')
+        return null;
+    const parsed = Date.parse(value);
+    return Number.isNaN(parsed) ? null : parsed;
+}
+function recordValue(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : null;
+}
+function stringValue(value) {
+    return typeof value === 'string' ? value : null;
+}
+//# sourceMappingURL=reader.js.map

package/dist/transcript/reader.js.map

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

package/dist/transcript/rewrites.d.ts

@@ -0,0 +1,5 @@
+export interface ClaudeRewriteEntry {
+    value: Record<string, unknown>;
+}
+export declare function applyNativeRewrites<TEntry extends ClaudeRewriteEntry>(entries: readonly TEntry[]): TEntry[];
+//# sourceMappingURL=rewrites.d.ts.map

package/dist/transcript/rewrites.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewrites.d.ts","sourceRoot":"","sources":["../../src/transcript/rewrites.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,wBAAgB,mBAAmB,CAAC,MAAM,SAAS,kBAAkB,EACnE,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,MAAM,EAAE,CAqDV"}

package/dist/transcript/rewrites.js

@@ -0,0 +1,65 @@
+export function applyNativeRewrites(entries) {
+    const removed = new Set();
+    for (const entry of entries) {
+        const metadata = recordValue(entry.value['snipMetadata']);
+        const uuids = metadata?.['removedUuids'];
+        if (Array.isArray(uuids)) {
+            for (const uuid of uuids) {
+                if (typeof uuid === 'string')
+                    removed.add(uuid);
+            }
+        }
+    }
+    const byId = new Map();
+    const parentById = new Map();
+    for (const entry of entries) {
+        const uuid = stringValue(entry.value['uuid']);
+        if (uuid === null)
+            continue;
+        parentById.set(uuid, stringValue(entry.value['parentUuid']));
+        if (!removed.has(uuid))
+            byId.set(uuid, entry);
+    }
+    if (removed.size === 0)
+        return [...byId.values()];
+    const resolvedParents = new Map();
+    const resolveParent = (uuid) => {
+        if (resolvedParents.has(uuid))
+            return resolvedParents.get(uuid) ?? null;
+        const path = [];
+        const seen = new Set();
+        let current = uuid;
+        while (current !== null &&
+            removed.has(current) &&
+            !seen.has(current)) {
+            seen.add(current);
+            path.push(current);
+            if (resolvedParents.has(current)) {
+                current = resolvedParents.get(current) ?? null;
+                break;
+            }
+            current = parentById.get(current) ?? null;
+        }
+        const resolved = current !== null && seen.has(current) ? null : current;
+        for (const removedUuid of path) {
+            resolvedParents.set(removedUuid, resolved);
+        }
+        return resolved;
+    };
+    for (const entry of byId.values()) {
+        let parent = stringValue(entry.value['parentUuid']);
+        if (parent !== null && removed.has(parent))
+            parent = resolveParent(parent);
+        entry.value['parentUuid'] = parent;
+    }
+    return [...byId.values()];
+}
+function recordValue(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : null;
+}
+function stringValue(value) {
+    return typeof value === 'string' ? value : null;
+}
+//# sourceMappingURL=rewrites.js.map

package/dist/transcript/rewrites.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewrites.js","sourceRoot":"","sources":["../../src/transcript/rewrites.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,mBAAmB,CACjC,OAA0B;IAE1B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC,cAAc,CAAC,CAAC;QACzC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,OAAO,IAAI,KAAK,QAAQ;oBAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAyB,CAAC;IACpD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAC9C,IAAI,IAAI,KAAK,IAAI;YAAE,SAAS;QAC5B,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC7D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAElD,MAAM,eAAe,GAAG,IAAI,GAAG,EAAyB,CAAC;IACzD,MAAM,aAAa,GAAG,CAAC,IAAY,EAAiB,EAAE;QACpD,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;QACxE,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,IAAI,OAAO,GAAkB,IAAI,CAAC;QAClC,OACE,OAAO,KAAK,IAAI;YAChB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;YACpB,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAClB,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAClB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACnB,IAAI,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBACjC,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;gBAC/C,MAAM;YACR,CAAC;YACD,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;QAC5C,CAAC;QACD,MAAM,QAAQ,GAAG,OAAO,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;QACxE,KAAK,MAAM,WAAW,IAAI,IAAI,EAAE,CAAC;YAC/B,eAAe,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QAClC,IAAI,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;QACpD,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QAC3E,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;IACrC,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzE,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC"}

package/dist/types.d.ts

@@ -13,6 +13,7 @@ export type ParsedLine = {
     kind: 'init';
     sessionId: string | null;
     model: string | null;
+    capabilities: readonly string[];
     raw: JsonObject;
 } | {
     kind: 'assistant';
@@ -23,6 +24,11 @@ export type ParsedLine = {
     kind: 'result';
     outcome: ResultEnvelope;
     raw: JsonObject;
+} | {
+    kind: 'command_lifecycle';
+    commandUuid: string | null;
+    state: CommandLifecycleState | null;
+    raw: JsonObject;
 } | {
     kind: 'control_request';
     requestId: string | null;
@@ -45,6 +51,7 @@ export type ParsedLine = {
     kind: 'parse_error';
     raw: string;
 };
+export type CommandLifecycleState = 'queued' | 'started' | 'completed' | 'cancelled' | 'discarded' | 'refused';
 /** The terminal `result` envelope, reduced to what the runtime records per turn. */
 export interface ResultEnvelope {
     /** `success` or one of the `error_*` subtypes. Unknown subtypes pass through. */
@@ -53,6 +60,17 @@ export interface ResultEnvelope {
     /** The success-path final text (`result`); `null` for error subtypes. */
     readonly text: string | null;
     readonly sessionId: string | null;
+    /**
+     * The `uuid` of the inbound user message this result answers
+     * (`result.user_message_uuid`), or `null` on builds that omit it.
+     *
+     * This is an optional attribution hint on the wire: `result` carries no
+     * `command_uuid`, its own `uuid` is server-generated, and `session_id` is
+     * shared by every execution window of the resident session. The RPC layer
+     * validates a present value against submitted commands; started lifecycle
+     * facts own attribution when this field is absent.
+     */
+    readonly userMessageUuid: string | null;
     /** Error subtypes may carry a message list; empty otherwise. */
     readonly errors: readonly string[];
     /**
@@ -119,7 +137,19 @@ export interface ClaudeCodeSessionSpec {
     onRemoteControlUrl?: (url: string) => void;
     /** Diagnostic logger for protocol-level events (parse errors, control answers). */
     log?: (level: 'info' | 'warn' | 'error', msg: string, err?: unknown) => void;
+    onProtocolEvent?: (event: ClaudeProtocolEvent) => void;
 }
+export type ClaudeProtocolEvent = {
+    readonly kind: 'command_lifecycle';
+    readonly commandUuid: string;
+    readonly state: CommandLifecycleState;
+} | {
+    readonly kind: 'stream';
+    readonly line: ParsedLine;
+} | {
+    readonly kind: 'result';
+    readonly outcome: TurnOutcome;
+};
 /**
  * A resident Claude Code session. Full turns are serialized by the caller;
  * `steerTurn` is the one allowed concurrent write, used to steer the active
@@ -128,10 +158,10 @@ export interface ClaudeCodeSessionSpec {
 export interface ClaudeCodeSession {
     /** Spawn the child and resolve once it is up (reject on spawn error). */
     start(): Promise<void>;
-    /** Submit one user turn; resolve with the outcome when `result` lands. */
-    submitTurn(prompt: string, options?: TurnSubmitOptions): Promise<TurnOutcome>;
+    /** Submit one user turn; resolve once all accepted commands have drained. */
+    submitTurn(prompt: string, options?: TurnSubmitOptions, commandUuid?: string): Promise<void>;
     /** Send a user message into the active turn without awaiting a separate result. */
-    steerTurn(prompt: string, options?: TurnSubmitOptions): Promise<void>;
+    steerTurn(prompt: string, options?: TurnSubmitOptions, commandUuid?: string): Promise<void>;
     /** Whether the child is currently alive. */
     isAlive(): boolean;
     /**