ccompactor 0.1.0

package/dist/adapters/codex.js

@@ -0,0 +1,218 @@
+/**
+ * Codex CLI session adapter.
+ *
+ * The store is `~/.codex/sessions/YYYY/MM/DD/rollout-<ts>-<uuid>.jsonl`, one
+ * JSON object per line, each `{timestamp, type, payload}`.
+ *
+ * Two properties differ from Claude's format and both matter:
+ *
+ * 1. **The line order is the order.** Codex records a rollout, and a rollback
+ *    rewrites history by appending rather than by branching, so there is no
+ *    `parentUuid` to walk. Rollbacks are handled by the `compacted` and
+ *    `turn_aborted` markers instead.
+ *
+ * 2. **The user's words live in two places.** `event_msg` carries the human's
+ *    message; `response_item` carries the same turn as a model-input item. Only
+ *    the first is intent — reading both double-counts every request.
+ */
+import { homedir } from 'node:os';
+import { basename, join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { readdir, stat } from 'node:fs/promises';
+import { readLines } from './types.js';
+export function codexStore() {
+    return process.env['CODEX_HOME'] ? join(process.env['CODEX_HOME'], 'sessions') : join(homedir(), '.codex', 'sessions');
+}
+export class CodexAdapter {
+    kind = 'codex';
+    label = 'Codex CLI';
+    store() {
+        return codexStore();
+    }
+    available() {
+        return existsSync(this.store());
+    }
+    async list(options) {
+        const root = this.store();
+        const files = await walkJsonl(root, options.maxBytes);
+        const refs = [];
+        for (const { path, mtime, bytes } of files) {
+            const name = basename(path).replace(/\.jsonl(\.zst)?$/, '');
+            // `rollout-2026-01-01T00-00-00-<uuid>`: the uuid is the id, the rest is
+            // the timestamp the provider already encodes in the filename.
+            const id = name.replace(/^rollout-/, '');
+            refs.push({ agent: 'codex', id, path, mtime, bytes });
+        }
+        return refs.sort((a, b) => b.mtime - a.mtime);
+    }
+    async read(ref, _options = {}) {
+        const lines = await readLines(ref.path);
+        const diagnostics = [];
+        const messages = [];
+        const compactBoundaries = [];
+        const metadata = {};
+        const seenUserText = new Set();
+        for (const [index, line] of lines.entries()) {
+            let raw;
+            try {
+                raw = JSON.parse(line);
+            }
+            catch (error) {
+                diagnostics.push({ line: index + 1, message: `unparseable: ${error.message}` });
+                continue;
+            }
+            const payload = raw.payload ?? {};
+            if (raw.type === 'session_meta') {
+                for (const key of ['cwd', 'id', 'cli_version', 'originator']) {
+                    if (payload[key] !== undefined)
+                        metadata[key] = payload[key];
+                }
+                const git = payload['git'];
+                if (typeof git === 'object' && git !== null) {
+                    const branch = git['branch'];
+                    if (typeof branch === 'string')
+                        metadata['branch'] = branch;
+                }
+                continue;
+            }
+            if (raw.type === 'compacted') {
+                compactBoundaries.push(index);
+                messages.push({
+                    uuid: `evt-${index}`,
+                    role: 'attachment',
+                    text: typeof payload['message'] === 'string' ? payload['message'] : 'compacted',
+                    eventIndex: index,
+                    raw,
+                });
+                continue;
+            }
+            if (raw.type === 'event_msg') {
+                const kind = payload['type'];
+                if (kind === 'user_message') {
+                    const text = typeof payload['message'] === 'string' ? payload['message'] : '';
+                    if (text.trim().length === 0)
+                        continue;
+                    // The same turn reappears as a `response_item` message below; the
+                    // human said it once.
+                    seenUserText.add(text.trim());
+                    messages.push({
+                        uuid: `evt-${index}`,
+                        role: 'user',
+                        text,
+                        isHumanTurn: true,
+                        eventIndex: index,
+                        raw,
+                    });
+                }
+                continue;
+            }
+            if (raw.type === 'turn_context') {
+                const cwd = payload['cwd'];
+                if (typeof cwd === 'string' && metadata['cwd'] === undefined)
+                    metadata['cwd'] = cwd;
+                continue;
+            }
+            if (raw.type !== 'response_item')
+                continue;
+            const kind = payload['type'];
+            if (kind === 'message') {
+                const role = typeof payload['role'] === 'string' ? payload['role'] : 'assistant';
+                const text = contentText(payload['content']);
+                if (text.trim().length === 0)
+                    continue;
+                if (role === 'user') {
+                    if (seenUserText.has(text.trim()))
+                        continue;
+                    seenUserText.add(text.trim());
+                    messages.push({
+                        uuid: `evt-${index}`,
+                        role: 'user',
+                        text,
+                        isHumanTurn: true,
+                        eventIndex: index,
+                        raw,
+                    });
+                }
+                else {
+                    messages.push({ uuid: `evt-${index}`, role: 'assistant', text, eventIndex: index, raw });
+                }
+                continue;
+            }
+            if (kind === 'function_call') {
+                messages.push({
+                    uuid: `evt-${index}`,
+                    role: 'assistant',
+                    toolName: typeof payload['name'] === 'string' ? payload['name'] : undefined,
+                    toolUseId: typeof payload['call_id'] === 'string' ? payload['call_id'] : undefined,
+                    toolInput: parseArguments(payload['arguments']),
+                    eventIndex: index,
+                    raw,
+                });
+                continue;
+            }
+            if (kind === 'function_call_output') {
+                messages.push({
+                    uuid: `evt-${index}`,
+                    role: 'tool',
+                    toolUseId: typeof payload['call_id'] === 'string' ? payload['call_id'] : undefined,
+                    toolResult: payload['output'],
+                    text: typeof payload['output'] === 'string' ? payload['output'] : undefined,
+                    eventIndex: index,
+                    raw,
+                });
+            }
+        }
+        return { ref, messages, compactBoundaries, metadata, diagnostics };
+    }
+}
+function contentText(content) {
+    if (typeof content === 'string')
+        return content;
+    if (!Array.isArray(content))
+        return '';
+    const parts = [];
+    for (const block of content) {
+        if (typeof block !== 'object' || block === null)
+            continue;
+        const b = block;
+        for (const key of ['text', 'input_text', 'output_text']) {
+            if (typeof b[key] === 'string')
+                parts.push(b[key]);
+        }
+    }
+    return parts.join('\n\n');
+}
+function parseArguments(value) {
+    if (typeof value !== 'string')
+        return value;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+}
+async function walkJsonl(root, maxBytes) {
+    const out = [];
+    const stack = [root];
+    while (stack.length > 0) {
+        const dir = stack.pop();
+        for (const entry of await readdir(dir, { withFileTypes: true }).catch(() => [])) {
+            const path = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                stack.push(path);
+                continue;
+            }
+            if (!entry.name.endsWith('.jsonl'))
+                continue;
+            const info = await stat(path).catch(() => null);
+            if (!info?.isFile())
+                continue;
+            if (maxBytes !== undefined && info.size > maxBytes)
+                continue;
+            out.push({ path, mtime: info.mtimeMs, bytes: info.size });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=codex.js.map

package/dist/adapters/codex.js.map

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

package/dist/adapters/index.d.ts

@@ -0,0 +1,17 @@
+import type { AgentKind } from '../ir/types.js';
+import type { Adapter } from './types.js';
+import { ClaudeAdapter } from './claude.js';
+import { CodexAdapter } from './codex.js';
+import { PiAdapter } from './pi.js';
+/**
+ * The adapter registry.
+ *
+ * Adding an agent means adding one file here and nothing else — every later
+ * stage reads the canonical IR, not a provider format. Adapters whose store is
+ * absent are still listed, so `doctor` can say what it looked for and did not
+ * find rather than silently omitting a provider.
+ */
+export declare function adapters(): Adapter[];
+export declare function adapterFor(kind: AgentKind): Adapter | undefined;
+export { ClaudeAdapter, CodexAdapter, PiAdapter };
+export type { Adapter, ListOptions, ReadOptions } from './types.js';

package/dist/adapters/index.js

@@ -0,0 +1,19 @@
+import { ClaudeAdapter } from './claude.js';
+import { CodexAdapter } from './codex.js';
+import { PiAdapter } from './pi.js';
+/**
+ * The adapter registry.
+ *
+ * Adding an agent means adding one file here and nothing else — every later
+ * stage reads the canonical IR, not a provider format. Adapters whose store is
+ * absent are still listed, so `doctor` can say what it looked for and did not
+ * find rather than silently omitting a provider.
+ */
+export function adapters() {
+    return [new ClaudeAdapter(), new CodexAdapter(), new PiAdapter()];
+}
+export function adapterFor(kind) {
+    return adapters().find((a) => a.kind === kind);
+}
+export { ClaudeAdapter, CodexAdapter, PiAdapter };
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAEnC;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ;IACtB,OAAO,CAAC,IAAI,aAAa,EAAE,EAAE,IAAI,YAAY,EAAE,EAAE,IAAI,SAAS,EAAE,CAAC,CAAA;AACnE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAe;IACxC,OAAO,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;AAChD,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,CAAA"}

package/dist/adapters/pi.d.ts

@@ -0,0 +1,16 @@
+import type { AgentKind, SessionIR, SessionRef } from '../ir/types.js';
+import type { Adapter, ListOptions, ReadOptions } from './types.js';
+export declare function piStore(): string;
+/** How well a session was understood, so the artifact can say so. */
+export interface PiCoverage {
+    recognised: number;
+    unknown: number;
+}
+export declare class PiAdapter implements Adapter {
+    kind: AgentKind;
+    label: string;
+    store(): string;
+    available(): boolean;
+    list(options: ListOptions): Promise<SessionRef[]>;
+    read(ref: SessionRef, _options?: ReadOptions): Promise<SessionIR>;
+}

package/dist/adapters/pi.js

@@ -0,0 +1,213 @@
+/**
+ * Pi session adapter.
+ *
+ * The store is `~/.pi/agent/sessions/<slugified-project>/<timestamp>_<id>.jsonl`.
+ * Files are v1-v3 and the record types seen in the wild are `session`,
+ * `model_change`, `thinking_level_change`, `custom_message` and `message`, with
+ * message roles `user`, `assistant` and `toolResult`.
+ *
+ * `custom_message` is harness-injected context — a plugin feeding the session a
+ * block of text — and is recorded as an attachment rather than as a user turn.
+ * Treating it as intent would put a news feed into the handoff as something the
+ * human asked for.
+ *
+ * Unknown record types are counted and reported rather than skipped in silence,
+ * because a handoff that is quietly missing half a session is worse than one
+ * that says which half.
+ */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { readdir, stat } from 'node:fs/promises';
+import { readLines } from './types.js';
+export function piStore() {
+    return process.env['PI_HOME']
+        ? join(process.env['PI_HOME'], 'agent', 'sessions')
+        : join(homedir(), '.pi', 'agent', 'sessions');
+}
+export class PiAdapter {
+    kind = 'pi';
+    label = 'Pi';
+    store() {
+        return piStore();
+    }
+    available() {
+        return existsSync(this.store());
+    }
+    async list(options) {
+        const refs = [];
+        const root = this.store();
+        const stack = [root];
+        while (stack.length > 0) {
+            const dir = stack.pop();
+            for (const entry of await readdir(dir, { withFileTypes: true }).catch(() => [])) {
+                const path = join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    stack.push(path);
+                    continue;
+                }
+                if (!entry.name.endsWith('.jsonl'))
+                    continue;
+                const info = await stat(path).catch(() => null);
+                if (!info?.isFile())
+                    continue;
+                if (options.maxBytes !== undefined && info.size > options.maxBytes)
+                    continue;
+                refs.push({
+                    agent: 'pi',
+                    id: entry.name.replace(/\.jsonl$/, ''),
+                    path,
+                    projectPath: dir,
+                    mtime: info.mtimeMs,
+                    bytes: info.size,
+                });
+            }
+        }
+        return refs.sort((a, b) => b.mtime - a.mtime);
+    }
+    async read(ref, _options = {}) {
+        const lines = await readLines(ref.path);
+        const diagnostics = [];
+        const messages = [];
+        const compactBoundaries = [];
+        const metadata = {};
+        let unknown = 0;
+        for (const [index, line] of lines.entries()) {
+            let raw;
+            try {
+                raw = JSON.parse(line);
+            }
+            catch (error) {
+                diagnostics.push({ line: index + 1, message: `unparseable: ${error.message}` });
+                continue;
+            }
+            const type = typeof raw['type'] === 'string' ? raw['type'] : '';
+            const id = typeof raw['id'] === 'string' ? raw['id'] : `evt-${index}`;
+            const parentId = typeof raw['parentId'] === 'string' ? raw['parentId'] : undefined;
+            if (type === 'session') {
+                for (const key of ['cwd', 'id', 'version']) {
+                    if (raw[key] !== undefined)
+                        metadata[key] = raw[key];
+                }
+                continue;
+            }
+            if (type === 'model_change') {
+                if (typeof raw['modelId'] === 'string')
+                    metadata['model'] = raw['modelId'];
+                if (typeof raw['provider'] === 'string')
+                    metadata['provider'] = raw['provider'];
+                continue;
+            }
+            if (type === 'custom_message') {
+                // Harness-injected, never typed by the human.
+                messages.push({
+                    uuid: id,
+                    ...(parentId ? { parentUuid: parentId } : {}),
+                    role: 'attachment',
+                    text: typeof raw['content'] === 'string' ? raw['content'] : '',
+                    isMeta: true,
+                    eventIndex: index,
+                    raw,
+                });
+                continue;
+            }
+            if (type === 'compaction' || type === 'summary') {
+                compactBoundaries.push(index);
+                continue;
+            }
+            if (type !== 'message') {
+                unknown += 1;
+                continue;
+            }
+            const message = (raw['message'] ?? {});
+            const role = typeof message['role'] === 'string' ? message['role'] : '';
+            const text = contentText(message['content']);
+            const base = {
+                uuid: id,
+                ...(parentId ? { parentUuid: parentId } : {}),
+                ...(typeof raw['timestamp'] === 'string' ? { timestamp: raw['timestamp'] } : {}),
+                eventIndex: index,
+                raw,
+            };
+            if (role === 'user') {
+                if (text.trim().length === 0)
+                    continue;
+                messages.push({ ...base, role: 'user', text, isHumanTurn: true });
+                continue;
+            }
+            if (role === 'assistant') {
+                const toolCall = firstToolCall(message['content']);
+                messages.push({
+                    ...base,
+                    role: 'assistant',
+                    text: text || undefined,
+                    ...(toolCall?.name ? { toolName: toolCall.name } : {}),
+                    ...(toolCall?.id ? { toolUseId: toolCall.id } : {}),
+                    ...(toolCall?.args !== undefined ? { toolInput: toolCall.args } : {}),
+                });
+                continue;
+            }
+            if (role === 'toolResult' || role === 'tool') {
+                messages.push({
+                    ...base,
+                    role: 'tool',
+                    ...(typeof message['toolCallId'] === 'string' ? { toolUseId: message['toolCallId'] } : {}),
+                    ...(typeof message['toolName'] === 'string' ? { toolName: message['toolName'] } : {}),
+                    text,
+                    toolResult: message['content'],
+                    isError: message['isError'] === true,
+                });
+                continue;
+            }
+            unknown += 1;
+        }
+        metadata['piUnknownRecords'] = unknown;
+        if (unknown > 0) {
+            diagnostics.push({
+                line: 0,
+                message: `${unknown} record(s) matched no known Pi shape and were skipped`,
+            });
+        }
+        return { ref, messages, compactBoundaries, metadata, diagnostics };
+    }
+}
+function contentText(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 (typeof block !== 'object' || block === null)
+            continue;
+        const b = block;
+        if (typeof b['text'] === 'string')
+            parts.push(b['text']);
+        if (b['type'] === 'toolCall' && typeof b['name'] === 'string')
+            parts.push('');
+    }
+    return parts.join('\n\n');
+}
+function firstToolCall(content) {
+    if (!Array.isArray(content))
+        return undefined;
+    for (const block of content) {
+        if (typeof block !== 'object' || block === null)
+            continue;
+        const b = block;
+        if (b['type'] === 'toolCall' || b['type'] === 'tool_use') {
+            return {
+                ...(typeof b['name'] === 'string' ? { name: b['name'] } : {}),
+                ...(typeof b['id'] === 'string' ? { id: b['id'] } : {}),
+                ...(b['arguments'] !== undefined ? { args: b['arguments'] } : {}),
+                ...(b['input'] !== undefined ? { args: b['input'] } : {}),
+            };
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=pi.js.map

package/dist/adapters/pi.js.map

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

package/dist/adapters/types.d.ts

@@ -0,0 +1,31 @@
+import type { AgentKind, SessionIR, SessionRef } from '../ir/types.js';
+export interface ListOptions {
+    /** Restrict to sessions belonging to this project directory. */
+    project?: string;
+    /** Ignore the project filter and search every store. */
+    anyProject?: boolean;
+    /** Skip sessions whose transcript is larger than this, in bytes. */
+    maxBytes?: number;
+}
+export interface Adapter {
+    kind: AgentKind;
+    label: string;
+    /** Where this adapter looks. Shown by `doctor`. */
+    store(): string;
+    /** True when the store exists on this machine. */
+    available(): boolean;
+    list(options: ListOptions): Promise<SessionRef[]>;
+    read(ref: SessionRef, options?: ReadOptions): Promise<SessionIR>;
+}
+export interface ReadOptions {
+    /** Include subagent transcripts. Off by default: they are not this session. */
+    includeSidechains?: boolean;
+    /**
+     * Start after the provider's last compaction boundary. Off by default: the
+     * turns before a boundary are the record of what the human asked for, and the
+     * boundary is where the provider stopped *reading*, not where the work began.
+     */
+    sinceCompact?: boolean;
+}
+/** Shared by adapters: read a file, tolerate a bad line, count the bad ones. */
+export declare function readLines(path: string): Promise<string[]>;

package/dist/adapters/types.js

@@ -0,0 +1,7 @@
+/** Shared by adapters: read a file, tolerate a bad line, count the bad ones. */
+export async function readLines(path) {
+    const { readFile } = await import('node:fs/promises');
+    const text = await readFile(path, 'utf8');
+    return text.split('\n').filter((line) => line.trim().length > 0);
+}
+//# sourceMappingURL=types.js.map

package/dist/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAiCA,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY;IAC1C,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAA;IACrD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;AAClE,CAAC"}

package/dist/artifact/expand.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `[evt a–b]` → the events behind it.
+ *
+ * The pointer is the artifact's only claim-checking mechanism, so this has to
+ * mean exactly one thing: the events in that inclusive range, in source order.
+ * A range is delivered in exact, non-overlapping pages rather than one
+ * unbounded dump, and every page says how to reach the next one — a window that
+ * has already shown you events 1–200 owes you a way to reach 201.
+ */
+import type { SessionIR } from '../ir/types.js';
+export interface Page {
+    index: number;
+    tokens: number;
+}
+export interface ExpandOptions {
+    context?: number;
+    page?: Page;
+}
+export declare function expand(ir: SessionIR, ranges: Array<[number, number]>, options?: ExpandOptions): string;
+/** Consecutive, non-overlapping pages. A single oversized event is its own page. */
+export declare function paginate(messages: SessionIR['messages'], tokens: number): Array<SessionIR['messages']>;
+/** Parse the `4122..4381`, `4122..=4381` and `4122` forms an artifact prints. */
+export declare function parseRange(text: string): [number, number];

package/dist/artifact/expand.js

@@ -0,0 +1,71 @@
+export function expand(ir, ranges, options = {}) {
+    const out = [];
+    const context = options.context ?? 0;
+    for (const [from, to] of ranges) {
+        const start = Math.max(0, from - context);
+        const end = to + context;
+        const selected = ir.messages.filter((m) => m.eventIndex >= start && m.eventIndex <= end);
+        if (selected.length === 0) {
+            out.push(`=== evt ${start}–${end} ===\n(no events in this range)\n`);
+            continue;
+        }
+        if (!options.page) {
+            out.push(`=== evt ${start}–${end} ===\n${selected.map(renderEvent).join('\n')}\n`);
+            continue;
+        }
+        const pages = paginate(selected, options.page.tokens);
+        const index = Math.min(Math.max(1, options.page.index), pages.length);
+        const slice = pages[index - 1];
+        out.push(`=== evt ${start}–${end} · page ${index}/${pages.length} · evt ${slice[0].eventIndex}–${slice.at(-1).eventIndex} · ${slice.reduce((n, m) => n + Math.ceil((m.text?.length ?? 0) / 4), 0)} token(s) ===`);
+        out.push(slice.map(renderEvent).join('\n'));
+        if (pages.length > 1) {
+            const next = index === pages.length ? 1 : index + 1;
+            out.push(`\n--- page ${index} of ${pages.length}; page ${next} is \`ccompactor expand <ref> ${from}..${to} --page ${next}\` ---`);
+        }
+        out.push('');
+    }
+    return out.join('\n');
+}
+/** Consecutive, non-overlapping pages. A single oversized event is its own page. */
+export function paginate(messages, tokens) {
+    const pages = [];
+    let current = [];
+    let used = 0;
+    for (const message of messages) {
+        const cost = Math.ceil((message.text?.length ?? 0) / 4);
+        if (current.length > 0 && used + cost > tokens) {
+            pages.push(current);
+            current = [];
+            used = 0;
+        }
+        current.push(message);
+        used += cost;
+    }
+    if (current.length > 0)
+        pages.push(current);
+    return pages.length > 0 ? pages : [[]];
+}
+function renderEvent(message) {
+    const role = message.isHumanTurn ? 'user' : message.role;
+    const tag = message.toolName ? `${role}·${message.toolName}` : role;
+    const body = message.text ?? (message.toolInput ? JSON.stringify(message.toolInput) : '');
+    return `evt ${message.eventIndex} [${tag}] ${body.replace(/\s+/g, ' ').slice(0, 2_000)}`;
+}
+/** Parse the `4122..4381`, `4122..=4381` and `4122` forms an artifact prints. */
+export function parseRange(text) {
+    const trimmed = text.trim();
+    const match = /^(\d+)\s*\.\.\s*=?\s*(\d+)$/.exec(trimmed);
+    if (match) {
+        const from = Number.parseInt(match[1], 10);
+        const to = Number.parseInt(match[2], 10);
+        if (to < from)
+            throw new Error(`range \`${text}\` runs backwards`);
+        return [from, to];
+    }
+    if (/^\d+$/.test(trimmed)) {
+        const value = Number.parseInt(trimmed, 10);
+        return [value, value];
+    }
+    throw new Error(`\`${text}\` is not a range (expected \`4122..4381\` or \`4122\`)`);
+}
+//# sourceMappingURL=expand.js.map