charness 0.0.0-stage → 3.1.0

package/dist/utils/claudeStreamJson.js

@@ -0,0 +1,364 @@
+"use strict";
+/**
+ * @description Pure parser for the `claude` CLI's
+ * `--output-format stream-json` protocol (the `claude-json-stream` adapter's
+ * event core). Kept dependency-free and side-effect-free so it is unit-testable
+ * against REAL captured stream-json samples (see `claudeStreamJson.test.ts`):
+ * the adapter feeds every stdout chunk through {@link ClaudeStreamLineReader}
+ * (partial-line buffering across chunks) and each complete line through
+ * {@link classifyClaudeStreamMessage}, which maps ONE stream-json message to a
+ * list of backend-neutral {@link ClaudeStreamAction}s the adapter then turns
+ * into `AgentAdapter` events.
+ *
+ * The wire format was reverse-engineered from a live `claude -p
+ * --input-format stream-json --output-format stream-json` run (v2.1.201) and
+ * cross-read against `@anthropic-ai/claude-agent-sdk` `sdk.d.ts` /`sdk.mjs`.
+ * Every event type below is backed by a captured sample.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClaudeStreamLineReader = void 0;
+exports.checkIsStreamRecord = checkIsStreamRecord;
+exports.parseStreamJsonLine = parseStreamJsonLine;
+exports.classifyClaudeStreamMessage = classifyClaudeStreamMessage;
+exports.buildCanUseToolAllow = buildCanUseToolAllow;
+exports.buildCanUseToolDeny = buildCanUseToolDeny;
+/** Narrow an untyped `JSON.parse` result to a plain object (parse-boundary
+ *  pattern for untrusted process output; mirrors `checkIsRecord` elsewhere). */
+function checkIsStreamRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * @description Newline-delimited-JSON reader with partial-line buffering. The
+ * CLI writes one JSON object per line, but a stdout chunk can split a line at
+ * any byte (a mid-line truncation), so a naive `chunk.split('\n')` would try to
+ * `JSON.parse` half a line. {@link push} returns only the COMPLETE lines seen so
+ * far and retains the trailing partial in {@link buffer} until its newline
+ * arrives in a later chunk.
+ */
+class ClaudeStreamLineReader {
+    buffer = '';
+    /** Feed a stdout chunk; return every complete (newline-terminated) line it
+     *  completed, retaining any trailing partial for the next call. Blank lines
+     *  are dropped. */
+    push(chunk) {
+        this.buffer += chunk;
+        const lines = [];
+        let nl;
+        while ((nl = this.buffer.indexOf('\n')) >= 0) {
+            const line = this.buffer.slice(0, nl);
+            this.buffer = this.buffer.slice(nl + 1);
+            if (line.trim())
+                lines.push(line);
+        }
+        return lines;
+    }
+    /** Any buffered, not-yet-terminated content (diagnostic only). */
+    get pending() {
+        return this.buffer;
+    }
+}
+exports.ClaudeStreamLineReader = ClaudeStreamLineReader;
+/** Parse one NDJSON line to a record, or `null` for blank / malformed
+ *  (a torn line that slipped past the reader) — never throws. */
+function parseStreamJsonLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        return null;
+    }
+    return checkIsStreamRecord(parsed) ? parsed : null;
+}
+/**
+ * @description Whether a non-tool-result `user` line is the
+ * `--replay-user-messages` echo of a message the bot wrote. The stream also
+ * carries `user` lines the CLI produced on its own, and counting one of those as
+ * our echo marks a message still waiting mid-turn as taken in (live
+ * `stdout.jsonl` logs): `isSynthetic` lines (a skill being loaded, the summary
+ * that opens a compacted session, `isReplay:false`), a sub-agent's own prompt
+ * and markers (`parent_tool_use_id` set), and a replayed background-task
+ * notification (`origin` set). Only POSITIVE evidence excludes a line, so a CLI
+ * that stamps none of these fields keeps counting every echo rather than none.
+ */
+function checkIsOwnInputEcho(msg) {
+    return msg.parent_tool_use_id == null
+        && msg.isSynthetic !== true
+        && msg.isReplay !== false
+        && msg.origin === undefined;
+}
+/** Read a non-negative integer field, defaulting an ABSENT field to 0 and
+ *  rejecting any other shape (`null`). */
+function readTokenCount(rec, key) {
+    const value = rec[key];
+    if (value === undefined)
+        return 0;
+    return typeof value === 'number' && Number.isInteger(value) && value >= 0 ? value : null;
+}
+/** Parse `result.usage`; `null` when absent or when any present count is malformed
+ *  (a half-read accounting would mislead the cache check — better no line). */
+function readResultUsage(usage) {
+    if (!checkIsStreamRecord(usage))
+        return null;
+    const inputTokens = readTokenCount(usage, 'input_tokens');
+    const cacheReadTokens = readTokenCount(usage, 'cache_read_input_tokens');
+    const cacheWriteTokens = readTokenCount(usage, 'cache_creation_input_tokens');
+    const outputTokens = readTokenCount(usage, 'output_tokens');
+    if (inputTokens === null || cacheReadTokens === null || cacheWriteTokens === null || outputTokens === null)
+        return null;
+    return { inputTokens, cacheReadTokens, cacheWriteTokens, outputTokens };
+}
+/** The turn's total over `result.modelUsage` (one entry per model used); `null` when absent or any entry is malformed. */
+function readModelUsageTotal(modelUsage) {
+    if (!checkIsStreamRecord(modelUsage))
+        return null;
+    const total = { inputTokens: 0, cacheReadTokens: 0, cacheWriteTokens: 0, outputTokens: 0 };
+    for (const entry of Object.values(modelUsage)) {
+        if (!checkIsStreamRecord(entry))
+            return null;
+        const inputTokens = readTokenCount(entry, 'inputTokens');
+        const cacheReadTokens = readTokenCount(entry, 'cacheReadInputTokens');
+        const cacheWriteTokens = readTokenCount(entry, 'cacheCreationInputTokens');
+        const outputTokens = readTokenCount(entry, 'outputTokens');
+        if (inputTokens === null || cacheReadTokens === null || cacheWriteTokens === null || outputTokens === null)
+            return null;
+        total.inputTokens += inputTokens;
+        total.cacheReadTokens += cacheReadTokens;
+        total.cacheWriteTokens += cacheWriteTokens;
+        total.outputTokens += outputTokens;
+    }
+    return total;
+}
+function checkIsZeroUsage(usage) {
+    return usage.inputTokens === 0 && usage.cacheReadTokens === 0 && usage.cacheWriteTokens === 0 && usage.outputTokens === 0;
+}
+/** The turn's accounting: `result.usage`, or the `modelUsage` total when `usage` is all zero (a `/compact` turn). */
+function readTurnUsage(usage, modelUsage) {
+    const resultUsage = readResultUsage(usage);
+    if (resultUsage === null || !checkIsZeroUsage(resultUsage))
+        return resultUsage;
+    return readModelUsageTotal(modelUsage) ?? resultUsage;
+}
+/** The `task_id`s of a `background_tasks_changed` frame's `tasks` list; an
+ *  entry without a string id is skipped (it cannot be matched to anything). */
+function readBackgroundTaskIds(tasks) {
+    if (!Array.isArray(tasks))
+        return [];
+    const taskIds = [];
+    for (const task of tasks) {
+        if (checkIsStreamRecord(task) && typeof task.task_id === 'string')
+            taskIds.push(task.task_id);
+    }
+    return taskIds;
+}
+/** Read a string field, or null. */
+function readString(rec, key) {
+    const value = rec[key];
+    return typeof value === 'string' ? value : null;
+}
+/** Concatenate the text of a tool_result `content` (string, or array of
+ *  `{type:'text',text}` / `{type:'tool_result'…}` blocks). */
+function extractToolResultOutput(content) {
+    if (typeof content === 'string')
+        return content;
+    if (!Array.isArray(content))
+        return '';
+    const parts = [];
+    for (const block of content) {
+        if (typeof block === 'string') {
+            parts.push(block);
+            continue;
+        }
+        if (checkIsStreamRecord(block) && typeof block.text === 'string')
+            parts.push(block.text);
+    }
+    return parts.join('');
+}
+/**
+ * @description Map ONE parsed stream-json message to zero or more
+ * {@link ClaudeStreamAction}s. Pure: no accumulation, no timers, no IO. An
+ * unrecognized / uninteresting message (status, thinking_tokens, message_start,
+ * content_block_start/stop, …) yields `[]`.
+ */
+function classifyClaudeStreamMessage(msg) {
+    const type = msg.type;
+    const isSubagent = msg.parent_tool_use_id != null;
+    if (type === 'system' && msg.subtype === 'init') {
+        return [{
+                kind: 'init',
+                sessionId: readString(msg, 'session_id'),
+                model: readString(msg, 'model'),
+                apiKeySource: readString(msg, 'apiKeySource'),
+                claudeCodeVersion: readString(msg, 'claude_code_version'),
+            }];
+    }
+    if (type === 'system' && msg.subtype === 'background_tasks_changed') {
+        return [{ kind: 'backgroundTasks', taskIds: readBackgroundTaskIds(msg.tasks) }];
+    }
+    if (type === 'system' && msg.subtype === 'status') {
+        // A `/compact` turn reports its outcome on a status frame carrying
+        // `compact_result` (e.g. "success") and, on failure, `compact_error`. Every
+        // other status frame (a plain `status` string) is not interesting.
+        if ('compact_result' in msg || 'compact_error' in msg) {
+            return [{ kind: 'compactStatus', result: readString(msg, 'compact_result'), error: readString(msg, 'compact_error') }];
+        }
+        return [];
+    }
+    if (type === 'system' && msg.subtype === 'compact_boundary') {
+        const meta = checkIsStreamRecord(msg.compact_metadata) ? msg.compact_metadata : {};
+        return [{
+                kind: 'compactBoundary',
+                trigger: readString(meta, 'trigger'),
+                preTokens: typeof meta.pre_tokens === 'number' ? meta.pre_tokens : null,
+                postTokens: typeof meta.post_tokens === 'number' ? meta.post_tokens : null,
+            }];
+    }
+    if (type === 'system' && msg.subtype === 'api_retry') {
+        // The retry carries an `error` description (documented category enum + text).
+        const text = readString(msg, 'error') ?? readString(msg, 'message') ?? JSON.stringify(msg);
+        return [{ kind: 'apiRetry', text }];
+    }
+    if (type === 'rate_limit_event') {
+        const info = checkIsStreamRecord(msg.rate_limit_info) ? msg.rate_limit_info : {};
+        // `resetsAt` is epoch SECONDS on the frame (measured 2026-10: `1791202200`).
+        const readResetMs = (value) => (typeof value === 'number' && Number.isFinite(value) ? value * 1000 : null);
+        const windows = [];
+        if (checkIsStreamRecord(info.unifiedWindows)) {
+            for (const [name, window] of Object.entries(info.unifiedWindows)) {
+                if (!checkIsStreamRecord(window) || typeof window.utilization !== 'number')
+                    continue;
+                windows.push({ name, utilization: window.utilization, resetsAtMs: readResetMs(window.resetsAt) });
+            }
+        }
+        return [{
+                kind: 'rateLimit',
+                rateLimitType: readString(info, 'rateLimitType'),
+                utilization: typeof info.utilization === 'number' ? info.utilization : null,
+                status: readString(info, 'status'),
+                resetsAtMs: readResetMs(info.resetsAt),
+                windows,
+            }];
+    }
+    if (type === 'stream_event') {
+        const event = checkIsStreamRecord(msg.event) ? msg.event : null;
+        if (!event || event.type !== 'content_block_delta')
+            return [];
+        const delta = checkIsStreamRecord(event.delta) ? event.delta : null;
+        if (!delta)
+            return [];
+        if (delta.type === 'text_delta' && typeof delta.text === 'string') {
+            return delta.text ? [{ kind: 'textDelta', text: delta.text, isSubagent }] : [];
+        }
+        if (delta.type === 'thinking_delta' && typeof delta.thinking === 'string') {
+            return delta.thinking ? [{ kind: 'thinkingDelta', text: delta.thinking, isSubagent }] : [];
+        }
+        return [];
+    }
+    if (type === 'assistant') {
+        // The settled assistant message. Text/thinking already streamed via deltas;
+        // here we only surface tool_use blocks (transient tool status).
+        const message = checkIsStreamRecord(msg.message) ? msg.message : null;
+        const content = message && Array.isArray(message.content) ? message.content : [];
+        const actions = [];
+        for (const block of content) {
+            if (!checkIsStreamRecord(block))
+                continue;
+            if (block.type === 'tool_use' && typeof block.name === 'string' && typeof block.id === 'string') {
+                actions.push({ kind: 'toolUse', tool: block.name, toolUseId: block.id, isSubagent });
+            }
+        }
+        return actions;
+    }
+    if (type === 'user') {
+        // Either a `--replay-user-messages` echo OR a tool_result fed back to the model.
+        const message = checkIsStreamRecord(msg.message) ? msg.message : null;
+        const content = message ? message.content : undefined;
+        if (Array.isArray(content)) {
+            const actions = [];
+            for (const block of content) {
+                if (checkIsStreamRecord(block) && block.type === 'tool_result' && typeof block.tool_use_id === 'string') {
+                    actions.push({ kind: 'toolResult', toolUseId: block.tool_use_id, output: extractToolResultOutput(block.content), isSubagent });
+                }
+            }
+            if (actions.length > 0)
+                return actions;
+        }
+        return checkIsOwnInputEcho(msg) ? [{ kind: 'userEcho' }] : [];
+    }
+    if (type === 'result') {
+        return [{
+                kind: 'turnEnd',
+                isError: msg.is_error === true,
+                errorText: readString(msg, 'api_error_status') ?? (msg.is_error === true ? (readString(msg, 'result') ?? 'API error') : null),
+                resultText: readString(msg, 'result'),
+                usage: readTurnUsage(msg.usage, msg.modelUsage),
+            }];
+    }
+    if (type === 'control_request') {
+        const request = checkIsStreamRecord(msg.request) ? msg.request : null;
+        const requestId = readString(msg, 'request_id');
+        const subtype = request ? readString(request, 'subtype') : null;
+        if (!request || !requestId || !subtype)
+            return [];
+        const action = { kind: 'controlRequest', requestId, subtype };
+        const toolName = readString(request, 'tool_name');
+        if (toolName)
+            action.toolName = toolName;
+        if (checkIsStreamRecord(request.input))
+            action.input = request.input;
+        const toolUseId = readString(request, 'tool_use_id');
+        if (toolUseId)
+            action.toolUseId = toolUseId;
+        const dialogKind = readString(request, 'dialog_kind');
+        if (dialogKind)
+            action.dialogKind = dialogKind;
+        return [action];
+    }
+    if (type === 'control_response') {
+        // Measured shape: `{response:{subtype:'success'|'error', request_id,
+        // response?:{…}}}` — the OUTER `response` carries the verdict + the id to
+        // match, the INNER one the returned record (present for `mcp_status`,
+        // ABSENT for a plain `mcp_reconnect` ack). Without a `request_id` the frame
+        // cannot be matched to the request it answers, so it is not actionable —
+        // same defensive rule as the `control_request` branch above.
+        const response = checkIsStreamRecord(msg.response) ? msg.response : null;
+        const requestId = response ? readString(response, 'request_id') : null;
+        if (!response || !requestId)
+            return [];
+        return [{
+                kind: 'controlResponse',
+                requestId,
+                isSuccess: readString(response, 'subtype') === 'success',
+                payload: checkIsStreamRecord(response.response) ? response.response : null,
+            }];
+    }
+    return [];
+}
+/**
+ * @description Build the `allow` body of a `can_use_tool` control_response.
+ *
+ * The CLI's control-response schema REQUIRES `updatedInput` to be a record on an
+ * allow — omit it and the CLI rejects the whole response ("Tool permission
+ * request failed: ZodError"), which silently blocks the tool it was meant to
+ * permit. This builder makes that field impossible to forget: `input` is echoed
+ * unchanged (`{}` when the request carried none). Used for the generic auto-allow
+ * of ordinary tools and for the empty-question fast-path.
+ */
+function buildCanUseToolAllow(input, toolUseId) {
+    const response = { behavior: 'allow', updatedInput: input ?? {} };
+    if (toolUseId)
+        response.toolUseID = toolUseId;
+    return response;
+}
+/** Build the `deny` body of a `can_use_tool` control_response (schema requires
+ *  `message`). Used when the user declines / abandons an AskUserQuestion. */
+function buildCanUseToolDeny(message, toolUseId) {
+    const response = { behavior: 'deny', message };
+    if (toolUseId)
+        response.toolUseID = toolUseId;
+    return response;
+}
+//# sourceMappingURL=claudeStreamJson.js.map

package/dist/utils/claudeStreamJson.js.map

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

package/dist/utils/claudeSubagentTail.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @description Pure decision logic for tailing Claude's on-disk SUB-AGENT
+ * transcripts (`/subagent full` on the Claude backend, plan
+ * 2026-06-11-subagent-claude-and-progress-flood S3). Claude writes each
+ * Task-tool child transcript to
+ * `<projectsRoot>/<slug>/<claudeSessionId>/subagents/agent-<agentId>.jsonl`;
+ * the adapter's poll loop scans that directory and feeds file sizes /
+ * appended bytes in — this module owns every decision (what to read, what to
+ * emit) and never touches the filesystem, so the rules are unit-testable
+ * without tmux or a real transcript dir.
+ *
+ * Locked rules:
+ * - the FIRST scan of a session seeds every existing file's offset to its
+ *   current size and emits NOTHING — resuming/adopting a session must never
+ *   replay an old sub-agent's backlog (a fresh session's dir is empty, so
+ *   nothing is lost there);
+ * - mode ≠ `full` fast-forwards offsets to the current size WITHOUT the
+ *   caller reading file contents, so a mid-run flip to `full` streams from
+ *   that moment, not from history;
+ * - only `text` blocks of `assistant` entries are extracted — child reasoning
+ *   (`thinking`) and `tool_use` blocks are never rendered (parity with the
+ *   OpenCode sub-agent matrix in `subagentRender.ts`).
+ */
+import type { DisplayVerbosityMode } from '../types';
+/**
+ * @description Tail bookkeeping for ONE sub-agent transcript file.
+ */
+export interface SubagentFileTail {
+    /** Bytes of this transcript already consumed (or deliberately skipped). */
+    offsetBytes: number;
+    /** Trailing partial line carried into the next appended read. */
+    carry: string;
+}
+/**
+ * @description Per-session sub-agent tail state. Created fresh on every
+ * session object (start / resume / adopt) so the first-scan seeding rule
+ * applies per session lifetime. Bounded by the session's sub-agent count —
+ * no eviction needed (the transcript dir is scoped to one `claudeSessionId`).
+ */
+export interface SubagentTailState {
+    /** Flips on the very first scan, which only seeds offsets and never reads. */
+    isFirstScanDone: boolean;
+    /** Per transcript-file tail, keyed by file name (unique within the dir). */
+    fileTails: Map<string, SubagentFileTail>;
+}
+/** One transcript file observed by a directory scan: its name + current size. */
+export interface SubagentScanFile {
+    fileName: string;
+    sizeBytes: number;
+}
+/** A byte range the caller must read and feed to
+ * {@link extractAppendedSubagentTexts}: `[startOffset..endOffset)`. */
+export interface SubagentTailRead {
+    fileName: string;
+    /** First byte to read (inclusive). */
+    startOffset: number;
+    /** Byte to stop at (exclusive) — the file's size at scan time. */
+    endOffset: number;
+}
+export declare function createSubagentTailState(): SubagentTailState;
+/**
+ * @description Is `fileName` a sub-agent transcript (`agent-*.jsonl`)?
+ * Filters out the sibling `agent-*.meta.json` files and anything else the
+ * directory may grow in future Claude versions.
+ */
+export declare function checkIsSubagentTranscriptName(fileName: string): boolean;
+/**
+ * @description Decide which byte ranges the caller must read this scan,
+ * advancing per-file offsets. Offsets advance OPTIMISTICALLY (to the scanned
+ * size) even before the read happens: if the caller's read then fails, those
+ * bytes are skipped rather than replayed — drop-over-resend, same tradeoff as
+ * the relay window.
+ *
+ * - First scan ever → seed every file's offset to its size, return no reads
+ *   (no backlog replay on resume/adopt).
+ * - Mode ≠ `full` → fast-forward offsets to the current size, return no reads
+ *   (the carry is dropped too: its line's remainder was skipped with the jump).
+ * - Mode = `full` → return `[offset..size)` for every grown file; a file first
+ *   seen AFTER the first scan starts at offset 0 (it belongs to work started
+ *   under this session).
+ * - A file SMALLER than its recorded offset (truncated/rewritten — should not
+ *   happen for append-only transcripts) is re-seeded to its new EOF.
+ */
+export declare function getSubagentTailReads(state: SubagentTailState, scannedFiles: readonly SubagentScanFile[], mode: DisplayVerbosityMode): SubagentTailRead[];
+/**
+ * @description Turn the bytes appended to one transcript (the range a
+ * {@link getSubagentTailReads} entry asked for) into the ordered list of
+ * renderable sub-agent text blocks. Prepends the file's carried partial line,
+ * splits on `\n`, keeps the new trailing partial line as the carry, and
+ * extracts via {@link getAssistantTextBlocks}.
+ */
+export declare function extractAppendedSubagentTexts(state: SubagentTailState, fileName: string, appendedText: string): string[];
+//# sourceMappingURL=claudeSubagentTail.d.ts.map

package/dist/utils/claudeSubagentTail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claudeSubagentTail.d.ts","sourceRoot":"","sources":["../../src/utils/claudeSubagentTail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAMrD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,eAAe,EAAE,OAAO,CAAC;IACzB,4EAA4E;IAC5E,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC1C;AAED,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;uEACuE;AACvE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,uBAAuB,IAAI,iBAAiB,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvE;AAWD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,iBAAiB,EACxB,YAAY,EAAE,SAAS,gBAAgB,EAAE,EACzC,IAAI,EAAE,oBAAoB,GACzB,gBAAgB,EAAE,CAkCpB;AAiCD;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,iBAAiB,EACxB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,MAAM,EAAE,CAWV"}

package/dist/utils/claudeSubagentTail.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSubagentTailState = createSubagentTailState;
+exports.checkIsSubagentTranscriptName = checkIsSubagentTranscriptName;
+exports.getSubagentTailReads = getSubagentTailReads;
+exports.extractAppendedSubagentTexts = extractAppendedSubagentTexts;
+/** Claude's sub-agent transcript filename shape (`agent-<agentId>.jsonl`).
+ * The sibling `agent-<agentId>.meta.json` files must NOT match. */
+const subagentTranscriptNamePattern = /^agent-.+\.jsonl$/;
+function createSubagentTailState() {
+    return { isFirstScanDone: false, fileTails: new Map() };
+}
+/**
+ * @description Is `fileName` a sub-agent transcript (`agent-*.jsonl`)?
+ * Filters out the sibling `agent-*.meta.json` files and anything else the
+ * directory may grow in future Claude versions.
+ */
+function checkIsSubagentTranscriptName(fileName) {
+    return subagentTranscriptNamePattern.test(fileName);
+}
+/**
+ * @description Narrow an untyped `JSON.parse` result to a plain object so its
+ * fields can be read with `typeof` guards instead of casts (parse-boundary
+ * pattern for untrusted on-disk data; mirrors `isRecord` in `state.ts`).
+ */
+function checkIsRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * @description Decide which byte ranges the caller must read this scan,
+ * advancing per-file offsets. Offsets advance OPTIMISTICALLY (to the scanned
+ * size) even before the read happens: if the caller's read then fails, those
+ * bytes are skipped rather than replayed — drop-over-resend, same tradeoff as
+ * the relay window.
+ *
+ * - First scan ever → seed every file's offset to its size, return no reads
+ *   (no backlog replay on resume/adopt).
+ * - Mode ≠ `full` → fast-forward offsets to the current size, return no reads
+ *   (the carry is dropped too: its line's remainder was skipped with the jump).
+ * - Mode = `full` → return `[offset..size)` for every grown file; a file first
+ *   seen AFTER the first scan starts at offset 0 (it belongs to work started
+ *   under this session).
+ * - A file SMALLER than its recorded offset (truncated/rewritten — should not
+ *   happen for append-only transcripts) is re-seeded to its new EOF.
+ */
+function getSubagentTailReads(state, scannedFiles, mode) {
+    if (!state.isFirstScanDone) {
+        state.isFirstScanDone = true;
+        for (const { fileName, sizeBytes } of scannedFiles) {
+            state.fileTails.set(fileName, { offsetBytes: sizeBytes, carry: '' });
+        }
+        return [];
+    }
+    const reads = [];
+    for (const { fileName, sizeBytes } of scannedFiles) {
+        const tail = state.fileTails.get(fileName);
+        if (!tail) {
+            state.fileTails.set(fileName, { offsetBytes: sizeBytes, carry: '' });
+            if (mode === 'full' && sizeBytes > 0) {
+                reads.push({ fileName, startOffset: 0, endOffset: sizeBytes });
+            }
+            continue;
+        }
+        if (sizeBytes < tail.offsetBytes) {
+            tail.offsetBytes = sizeBytes;
+            tail.carry = '';
+            continue;
+        }
+        if (sizeBytes === tail.offsetBytes)
+            continue;
+        if (mode !== 'full') {
+            tail.offsetBytes = sizeBytes;
+            tail.carry = '';
+            continue;
+        }
+        reads.push({ fileName, startOffset: tail.offsetBytes, endOffset: sizeBytes });
+        tail.offsetBytes = sizeBytes;
+    }
+    return reads;
+}
+/**
+ * @description Pull the renderable text out of ONE transcript JSONL line.
+ * Only `assistant` entries contribute, and only their `text` content blocks —
+ * `thinking` / `tool_use` blocks and `user` / `attachment` entries are
+ * dropped (locked parity with OpenCode sub-agent rendering). A line that is
+ * not valid JSON (torn write caught mid-append) is skipped silently — the
+ * next complete line still parses.
+ */
+function getAssistantTextBlocks(line) {
+    const trimmedLine = line.trim();
+    if (!trimmedLine)
+        return [];
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmedLine);
+    }
+    catch {
+        return [];
+    }
+    if (!checkIsRecord(parsed) || parsed.type !== 'assistant')
+        return [];
+    const message = parsed.message;
+    if (!checkIsRecord(message))
+        return [];
+    const content = message.content;
+    if (!Array.isArray(content))
+        return [];
+    const texts = [];
+    for (const block of content) {
+        if (checkIsRecord(block) && block.type === 'text' && typeof block.text === 'string' && block.text.trim()) {
+            texts.push(block.text);
+        }
+    }
+    return texts;
+}
+/**
+ * @description Turn the bytes appended to one transcript (the range a
+ * {@link getSubagentTailReads} entry asked for) into the ordered list of
+ * renderable sub-agent text blocks. Prepends the file's carried partial line,
+ * splits on `\n`, keeps the new trailing partial line as the carry, and
+ * extracts via {@link getAssistantTextBlocks}.
+ */
+function extractAppendedSubagentTexts(state, fileName, appendedText) {
+    const tail = state.fileTails.get(fileName);
+    if (!tail)
+        return [];
+    const combined = tail.carry + appendedText;
+    const lines = combined.split('\n');
+    tail.carry = lines.pop() ?? '';
+    const texts = [];
+    for (const line of lines) {
+        texts.push(...getAssistantTextBlocks(line));
+    }
+    return texts;
+}
+//# sourceMappingURL=claudeSubagentTail.js.map

package/dist/utils/claudeSubagentTail.js.map

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