ccompactor 0.1.0

package/dist/discover/index.d.ts

@@ -0,0 +1,40 @@
+import type { AgentKind, SessionIR, SessionRef } from '../ir/types.js';
+export interface DiscoverOptions {
+    project?: string;
+    anyProject?: boolean;
+    agents?: AgentKind[];
+}
+/** Every session every adapter can see, newest first. */
+export declare function listSessions(options?: DiscoverOptions): Promise<SessionRef[]>;
+/**
+ * Turn a reference into exactly one session, or explain why it is not exactly
+ * one. A prefix that matches several sessions is a question for the human, not
+ * something to guess at — the wrong session means a handoff for the wrong work.
+ */
+export declare function resolveSession(reference: string, options?: DiscoverOptions): Promise<SessionRef>;
+export declare class AmbiguousError extends Error {
+    readonly reference: string;
+    readonly candidates: SessionRef[];
+    readonly exitCode = 3;
+    constructor(reference: string, candidates: SessionRef[]);
+}
+/** Read a resolved session into the canonical IR. */
+export declare function readSession(ref: SessionRef, options?: {
+    includeSidechains?: boolean;
+}): Promise<SessionIR>;
+/**
+ * Subsequence scoring, highest first.
+ *
+ * A dependency-free fuzzy matcher: every character of the query must appear in
+ * order, and consecutive matches and matches at word boundaries score higher.
+ * It is enough to find a session by a fragment of its first message, which is
+ * the only search anyone actually performs here.
+ */
+export declare function fuzzyScore(query: string, target: string): number;
+/** Search sessions by anything cheaply knowable, without parsing them fully. */
+export declare function findSessions(query: string, options?: DiscoverOptions): Promise<Array<{
+    ref: SessionRef;
+    score: number;
+    snippet?: string;
+}>>;
+export { parseReference, UsageError } from './reference.js';

package/dist/discover/index.js

@@ -0,0 +1,164 @@
+import { adapters } from '../adapters/index.js';
+import { parseReference, UsageError } from './reference.js';
+/** Every session every adapter can see, newest first. */
+export async function listSessions(options = {}) {
+    const chosen = adapters().filter((a) => !options.agents || options.agents.includes(a.kind));
+    const all = [];
+    for (const adapter of chosen) {
+        if (!adapter.available())
+            continue;
+        const refs = await adapter.list({
+            ...(options.project ? { project: options.project } : {}),
+            ...(options.anyProject ? { anyProject: options.anyProject } : {}),
+        });
+        all.push(...refs);
+    }
+    return all.sort((a, b) => b.mtime - a.mtime);
+}
+/**
+ * Turn a reference into exactly one session, or explain why it is not exactly
+ * one. A prefix that matches several sessions is a question for the human, not
+ * something to guess at — the wrong session means a handoff for the wrong work.
+ */
+export async function resolveSession(reference, options = {}) {
+    const parsed = parseReference(reference);
+    if (parsed.path) {
+        return {
+            agent: parsed.agent ?? 'generic',
+            id: parsed.selector,
+            path: parsed.path,
+            mtime: Date.now(),
+        };
+    }
+    const candidates = (await listSessions(options)).filter((ref) => !parsed.agent || ref.agent === parsed.agent);
+    if (candidates.length === 0) {
+        throw new UsageError(`no sessions found${parsed.agent ? ` for ${parsed.agent}` : ''}. Run \`ccompactor doctor\`.`);
+    }
+    if (parsed.selector === 'last')
+        return candidates[0];
+    const exact = candidates.find((ref) => ref.id === parsed.selector);
+    if (exact)
+        return exact;
+    const matches = candidates.filter((ref) => ref.id.startsWith(parsed.selector));
+    if (matches.length === 0) {
+        throw new UsageError(`no session matches \`${parsed.selector}\``);
+    }
+    if (matches.length > 1) {
+        throw new AmbiguousError(parsed.selector, matches);
+    }
+    return matches[0];
+}
+export class AmbiguousError extends Error {
+    reference;
+    candidates;
+    exitCode = 3;
+    constructor(reference, candidates) {
+        super(`\`${reference}\` matched ${candidates.length} sessions`);
+        this.reference = reference;
+        this.candidates = candidates;
+    }
+}
+/** Read a resolved session into the canonical IR. */
+export async function readSession(ref, options = {}) {
+    const adapter = adapters().find((a) => a.kind === ref.agent);
+    if (!adapter) {
+        throw new UsageError(`no adapter for agent \`${ref.agent}\``);
+    }
+    return adapter.read(ref, options);
+}
+/**
+ * Subsequence scoring, highest first.
+ *
+ * A dependency-free fuzzy matcher: every character of the query must appear in
+ * order, and consecutive matches and matches at word boundaries score higher.
+ * It is enough to find a session by a fragment of its first message, which is
+ * the only search anyone actually performs here.
+ */
+export function fuzzyScore(query, target) {
+    if (query.length === 0)
+        return 1;
+    const q = query.toLowerCase();
+    const t = target.toLowerCase();
+    let score = 0;
+    let cursor = 0;
+    let streak = 0;
+    for (const char of q) {
+        const found = t.indexOf(char, cursor);
+        if (found === -1)
+            return 0;
+        streak = found === cursor ? streak + 1 : 0;
+        score += 1 + streak;
+        // A match right after a separator is the start of a word, which is what
+        // someone typing an abbreviation means.
+        if (found === 0 || /[\s/_.:-]/.test(t[found - 1] ?? ''))
+            score += 2;
+        cursor = found + 1;
+    }
+    return score;
+}
+/** Search sessions by anything cheaply knowable, without parsing them fully. */
+export async function findSessions(query, options = {}) {
+    const refs = await listSessions(options);
+    const hits = [];
+    for (const ref of refs) {
+        const haystack = [ref.id, ref.title ?? '', ref.projectPath ?? '', ref.path].join(' ');
+        let score = fuzzyScore(query, haystack);
+        // The first human turn is the session's real title far more often than
+        // anything the provider recorded, so it is worth a header read.
+        if (score === 0 && ref.bytes !== undefined && ref.bytes < 64 * 1024 * 1024) {
+            const snippet = await firstHumanTurn(ref);
+            if (snippet) {
+                const snippetScore = fuzzyScore(query, snippet);
+                if (snippetScore > 0) {
+                    hits.push({ ref, score: snippetScore, snippet });
+                    continue;
+                }
+            }
+        }
+        if (score > 0)
+            hits.push({ ref, score });
+    }
+    return hits.sort((a, b) => b.score - a.score || b.ref.mtime - a.ref.mtime);
+}
+async function firstHumanTurn(ref) {
+    const { createReadStream } = await import('node:fs');
+    const { createInterface } = await import('node:readline');
+    const stream = createReadStream(ref.path, { encoding: 'utf8' });
+    const rl = createInterface({ input: stream, crlfDelay: Infinity });
+    try {
+        for await (const line of rl) {
+            try {
+                const raw = JSON.parse(line);
+                if (raw.type !== 'user' || raw.isMeta)
+                    continue;
+                const text = plainText(raw.message?.content);
+                if (text && text.trim().length > 0)
+                    return text.slice(0, 400);
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    finally {
+        rl.close();
+        stream.close();
+    }
+    return undefined;
+}
+function plainText(content) {
+    if (typeof content === 'string')
+        return content;
+    if (!Array.isArray(content))
+        return undefined;
+    for (const block of content) {
+        if (typeof block === 'object' && block !== null) {
+            const b = block;
+            if (b['type'] === 'text' && typeof b['text'] === 'string')
+                return b['text'];
+        }
+    }
+    return undefined;
+}
+export { parseReference, UsageError } from './reference.js';
+//# sourceMappingURL=index.js.map

package/dist/discover/index.js.map

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

package/dist/discover/reference.d.ts

@@ -0,0 +1,21 @@
+import type { AgentKind } from '../ir/types.js';
+export interface ParsedReference {
+    /** Undefined when the reference did not name an agent. */
+    agent?: AgentKind;
+    /** A session id, an id prefix, or `last`. */
+    selector: string;
+    /** Set when the reference was a filesystem path rather than a store lookup. */
+    path?: string;
+}
+/**
+ * Parse a session reference.
+ *
+ * Accepts `claude:7c1e8f82`, `codex:last`, a bare `last`, and a path to a
+ * transcript on disk. A path is accepted because the answer to "which session"
+ * is often "this file", and refusing it would make the tool unusable in a
+ * script that already knows the path.
+ */
+export declare function parseReference(text: string): ParsedReference;
+export declare class UsageError extends Error {
+    readonly exitCode = 2;
+}

package/dist/discover/reference.js

@@ -0,0 +1,44 @@
+import { basename } from 'node:path';
+const KNOWN = ['claude', 'openclaude', 'codex', 'pi', 'opencode', 'deepseek', 'generic'];
+/**
+ * Parse a session reference.
+ *
+ * Accepts `claude:7c1e8f82`, `codex:last`, a bare `last`, and a path to a
+ * transcript on disk. A path is accepted because the answer to "which session"
+ * is often "this file", and refusing it would make the tool unusable in a
+ * script that already knows the path.
+ */
+export function parseReference(text) {
+    const trimmed = text.trim();
+    if (trimmed.length === 0)
+        throw new UsageError('empty session reference');
+    if (trimmed.includes('/') || trimmed.endsWith('.jsonl') || trimmed.endsWith('.jsonl.zst')) {
+        return { agent: inferFromPath(trimmed), selector: basename(trimmed).replace(/\.jsonl(\.zst)?$/, ''), path: trimmed };
+    }
+    const colon = trimmed.indexOf(':');
+    if (colon === -1) {
+        return { selector: trimmed };
+    }
+    const head = trimmed.slice(0, colon);
+    const rest = trimmed.slice(colon + 1);
+    if (!KNOWN.includes(head)) {
+        throw new UsageError(`unknown agent \`${head}\` (expected one of ${KNOWN.join(', ')})`);
+    }
+    if (rest.length === 0)
+        throw new UsageError(`\`${trimmed}\` names an agent but no session`);
+    return { agent: head, selector: rest };
+}
+/** A path in a Claude store is a Claude session; anything else is a guess. */
+function inferFromPath(path) {
+    if (path.includes('/.claude/'))
+        return 'claude';
+    if (path.includes('/.codex/'))
+        return 'codex';
+    if (path.includes('/.pi/'))
+        return 'pi';
+    return undefined;
+}
+export class UsageError extends Error {
+    exitCode = 2;
+}
+//# sourceMappingURL=reference.js.map

package/dist/discover/reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.js","sourceRoot":"","sources":["../../src/discover/reference.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAYpC,MAAM,KAAK,GAAgB,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,CAAC,CAAA;AAErG;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IAC3B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,yBAAyB,CAAC,CAAA;IAEzE,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QAC1F,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;IACtH,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAClC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;IAC9B,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;IACpC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;IACrC,IAAI,CAAE,KAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,UAAU,CAClB,mBAAmB,IAAI,uBAAuB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAClE,CAAA;IACH,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,KAAK,OAAO,kCAAkC,CAAC,CAAA;IAC3F,OAAO,EAAE,KAAK,EAAE,IAAiB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;AACrD,CAAC;AAED,8EAA8E;AAC9E,SAAS,aAAa,CAAC,IAAY;IACjC,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAO,QAAQ,CAAA;IAC/C,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,OAAO,CAAA;IAC7C,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAA;IACvC,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,QAAQ,GAAG,CAAC,CAAA;CACtB"}

package/dist/extract.d.ts

@@ -0,0 +1,26 @@
+import type { SessionRef } from './ir/types.js';
+import { type DiscoverOptions } from './discover/index.js';
+import { type Ledgers } from './ledgers/index.js';
+import { type Constraint } from './triage.js';
+import { type Rendered } from './artifact/render.js';
+import { type Selection } from './llm/index.js';
+export interface ExtractOptions extends DiscoverOptions {
+    outDir?: string;
+    llm?: Selection;
+    focus?: string;
+    instructions?: string;
+    /** Write nothing; return what would be written. */
+    dryRun?: boolean;
+}
+export interface Extraction {
+    ref: SessionRef;
+    ledgers: Ledgers;
+    constraints: Constraint[];
+    rendered: Rendered;
+    engine: string;
+    llm: string;
+    /** Absolute paths written, empty on a dry run. */
+    written: string[];
+    elapsedMs: number;
+}
+export declare function extractSession(reference: string, options?: ExtractOptions, progress?: (stage: string, message: string) => void): Promise<Extraction>;

package/dist/extract.js

@@ -0,0 +1,103 @@
+/**
+ * The extraction pipeline.
+ *
+ * Deliberately a straight line: resolve, read, ledger, triage, optionally
+ * summarise, render, write. Each stage is a pure function over the previous
+ * one's output, so the whole thing is testable without a filesystem, a network,
+ * or a terminal.
+ */
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { readSession, resolveSession } from './discover/index.js';
+import { buildLedgers } from './ledgers/index.js';
+import { extractConstraints } from './triage.js';
+import { render } from './artifact/render.js';
+import { build, resolveAuto, selectionLabel } from './llm/index.js';
+import { summarise } from './compact/engine.js';
+import { redact, summarize } from './redact.js';
+export async function extractSession(reference, options = {}, progress = () => { }) {
+    const started = Date.now();
+    const ref = await resolveSession(reference, options);
+    progress('resolve', `${ref.agent}:${ref.id} → ${ref.path}`);
+    const ir = await readSession(ref, { includeSidechains: false });
+    progress('parse', `${ir.messages.length} message(s), ${ir.compactBoundaries.length} compact boundary(ies), ${ir.diagnostics.length} diagnostic(s)`);
+    const ledgers = buildLedgers(ir);
+    progress('ledgers', `${ledgers.files.length} files, ${ledgers.commands.length} commands, ${ledgers.errors.length} error signatures`);
+    const constraints = extractConstraints(ir);
+    progress('triage', `${constraints.length} standing instruction(s)`);
+    const selection = options.llm ?? resolveAuto();
+    let summary;
+    let engine = 'deterministic';
+    if (selection.kind !== 'none') {
+        const backend = build(selection);
+        if (backend) {
+            progress('summary', `asking ${selectionLabel(selection)} for the continuation summary`);
+            const produced = await summarise({ ir, ledgers, constraints }, backend, options);
+            summary = produced;
+            engine = selectionLabel(selection);
+            progress('summary', `${produced.length} characters returned`);
+        }
+    }
+    else {
+        progress('summary', 'skipped: --llm none. The deterministic artifact is still complete.');
+    }
+    const compactInput = {};
+    const rendered = render({
+        ir,
+        ledgers,
+        constraints,
+        engine,
+        ...(summary ? { summary } : {}),
+        ...(options.focus ? { focus: options.focus } : {}),
+    });
+    // Redacted again on the way out. Two passes over the same text is not
+    // redundancy: the first stops a secret reaching a provider, the second stops
+    // one reaching the disk, and they fail independently.
+    const markdown = redact(rendered.markdown);
+    const json = JSON.parse(redact(JSON.stringify(rendered.json)).text);
+    rendered.markdown = markdown.text;
+    rendered.json = json;
+    const redactionCounts = { ...markdown.counts, ...(compactInput.redactionCounts ?? {}) };
+    if (Object.keys(redactionCounts).length > 0) {
+        rendered.json['redaction'] = { counts: redactionCounts, summary: summarize(redactionCounts) };
+        progress('redact', `replaced ${summarize(redactionCounts)}`);
+    }
+    const written = [];
+    if (!options.dryRun) {
+        const outDir = options.outDir ?? '.ccompactor';
+        await mkdir(outDir, { recursive: true });
+        const write = async (name, body) => {
+            const path = join(outDir, name);
+            await writeFile(path, body, 'utf8');
+            written.push(path);
+        };
+        await write('handoff.md', rendered.markdown);
+        await write('handoff.json', `${JSON.stringify(rendered.json, null, 2)}\n`);
+        await write('ledgers.json', `${JSON.stringify(ledgers, null, 2)}\n`);
+        await write('provenance.json', `${JSON.stringify({
+            schema: 'ccompactor.provenance/v1',
+            source: ref.path,
+            events: ir.messages.length,
+            constraints: constraints.map((c) => ({ evt: c.evt, text: c.text })),
+        }, null, 2)}\n`);
+        await write('state.json', `${JSON.stringify({
+            schema: 'ccompactor.state/v1',
+            engine,
+            constraintsFound: constraints.length,
+            redaction: redactionCounts,
+            diagnostics: ir.diagnostics,
+        }, null, 2)}\n`);
+        progress('write', written.join(', '));
+    }
+    return {
+        ref,
+        ledgers,
+        constraints,
+        rendered,
+        engine,
+        llm: selectionLabel(selection),
+        written,
+        elapsedMs: Date.now() - started,
+    };
+}
+//# sourceMappingURL=extract.js.map

package/dist/extract.js.map

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

package/dist/handoff/index.d.ts

@@ -0,0 +1,12 @@
+export type Target = 'claude' | 'openclaude' | 'codex' | 'pi' | 'generic';
+export interface Launch {
+    target: Target;
+    program: string;
+    argv: string[];
+    /** What to tell the human when the target cannot take a file directly. */
+    note?: string;
+    display: string;
+}
+export declare function plan(target: Target, artifactPath: string, cwd: string): Launch;
+/** Which targets actually exist on this machine. */
+export declare function installed(): Target[];

package/dist/handoff/index.js

@@ -0,0 +1,67 @@
+/**
+ * Launching a target agent with the handoff preloaded.
+ *
+ * The mechanism is an instruction plus a file path, never an injection into
+ * another tool's database. Flags here were verified against installed versions
+ * rather than assumed, because a wrong flag is a spawn that silently drops the
+ * context — the one failure this command exists to prevent.
+ *
+ * Verified: claude 2.1.268 `--append-system-prompt-file`, pi 0.85.1
+ * `--append-system-prompt`. Codex has no equivalent, so it gets a pointer and
+ * the instruction to read it first.
+ */
+import { resolve } from 'node:path';
+import * as childProcess from 'node:child_process';
+export function plan(target, artifactPath, cwd) {
+    const path = resolve(artifactPath);
+    const instruction = `Read ${path} first. It is a handoff from an earlier session on this project; build on that work rather than re-deriving it, and treat its "Hard constraints" as binding.`;
+    switch (target) {
+        case 'claude':
+        case 'openclaude':
+            return {
+                target,
+                program: target === 'claude' ? 'claude' : 'openclaude',
+                argv: ['--append-system-prompt-file', path],
+                display: `${target} --append-system-prompt-file ${path}`,
+            };
+        case 'pi':
+            return {
+                target,
+                program: 'pi',
+                argv: ['--append-system-prompt', path],
+                display: `pi --append-system-prompt ${path}`,
+            };
+        case 'codex':
+            return {
+                target,
+                program: 'codex',
+                argv: [instruction],
+                note: 'codex has no --append-system-prompt; it is given the instruction as its opening prompt',
+                display: `codex "${instruction}"`,
+            };
+        default:
+            return {
+                target: 'generic',
+                program: '',
+                argv: [],
+                note: instruction,
+                display: instruction,
+            };
+    }
+}
+/** Which targets actually exist on this machine. */
+export function installed() {
+    const { execFileSync } = childProcess;
+    const found = [];
+    for (const target of ['claude', 'codex', 'pi']) {
+        try {
+            execFileSync('which', [target], { stdio: 'ignore' });
+            found.push(target);
+        }
+        catch {
+            continue;
+        }
+    }
+    return found;
+}
+//# sourceMappingURL=index.js.map

package/dist/handoff/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/handoff/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAA;AAalD,MAAM,UAAU,IAAI,CAAC,MAAc,EAAE,YAAoB,EAAE,GAAW;IACpE,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IAClC,MAAM,WAAW,GAAG,QAAQ,IAAI,8JAA8J,CAAA;IAE9L,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,QAAQ,CAAC;QACd,KAAK,YAAY;YACf,OAAO;gBACL,MAAM;gBACN,OAAO,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY;gBACtD,IAAI,EAAE,CAAC,6BAA6B,EAAE,IAAI,CAAC;gBAC3C,OAAO,EAAE,GAAG,MAAM,gCAAgC,IAAI,EAAE;aACzD,CAAA;QACH,KAAK,IAAI;YACP,OAAO;gBACL,MAAM;gBACN,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,CAAC,wBAAwB,EAAE,IAAI,CAAC;gBACtC,OAAO,EAAE,6BAA6B,IAAI,EAAE;aAC7C,CAAA;QACH,KAAK,OAAO;YACV,OAAO;gBACL,MAAM;gBACN,OAAO,EAAE,OAAO;gBAChB,IAAI,EAAE,CAAC,WAAW,CAAC;gBACnB,IAAI,EAAE,wFAAwF;gBAC9F,OAAO,EAAE,UAAU,WAAW,GAAG;aAClC,CAAA;QACH;YACE,OAAO;gBACL,MAAM,EAAE,SAAS;gBACjB,OAAO,EAAE,EAAE;gBACX,IAAI,EAAE,EAAE;gBACR,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,WAAW;aACrB,CAAA;IACL,CAAC;AACH,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,SAAS;IACvB,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAA;IACrC,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,MAAM,MAAM,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAU,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,YAAY,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;YACpD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,SAAQ;QACV,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/ir/tokens.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Token estimation.
+ *
+ * Four bytes per token, the same approximation sctxx uses and for the same
+ * reason: every budget in the tool is an order-of-magnitude decision, and a
+ * tokeniser dependency costs more than it improves that. It is stated as an
+ * estimate everywhere it is shown, never as a measurement.
+ */
+export declare function approxTokens(text: string): number;
+export declare function approxBytes(tokens: number): number;
+/** Middle-truncate to a token budget, keeping a head and a tail. */
+export declare function truncateMiddle(text: string, maxTokens: number, marker?: string): string;
+/** Hard-wrap a long line so a terminal can show a path without it vanishing. */
+export declare function wrapHard(text: string, width: number): string[];

package/dist/ir/tokens.js

@@ -0,0 +1,36 @@
+/**
+ * Token estimation.
+ *
+ * Four bytes per token, the same approximation sctxx uses and for the same
+ * reason: every budget in the tool is an order-of-magnitude decision, and a
+ * tokeniser dependency costs more than it improves that. It is stated as an
+ * estimate everywhere it is shown, never as a measurement.
+ */
+const BYTES_PER_TOKEN = 4;
+export function approxTokens(text) {
+    return Math.ceil(text.length / BYTES_PER_TOKEN);
+}
+export function approxBytes(tokens) {
+    return tokens * BYTES_PER_TOKEN;
+}
+/** Middle-truncate to a token budget, keeping a head and a tail. */
+export function truncateMiddle(text, maxTokens, marker = ' … ') {
+    const max = approxBytes(maxTokens);
+    if (text.length <= max)
+        return text;
+    if (max <= marker.length + 2)
+        return marker.trim();
+    const left = Math.floor((max - marker.length) / 2);
+    const right = max - marker.length - left;
+    return text.slice(0, left) + marker + text.slice(text.length - right);
+}
+/** Hard-wrap a long line so a terminal can show a path without it vanishing. */
+export function wrapHard(text, width) {
+    if (width <= 0)
+        return [text];
+    const out = [];
+    for (let i = 0; i < text.length; i += width)
+        out.push(text.slice(i, i + width));
+    return out.length > 0 ? out : [''];
+}
+//# sourceMappingURL=tokens.js.map

package/dist/ir/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/ir/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,eAAe,GAAG,CAAC,CAAA;AAEzB,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,CAAA;AACjD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO,MAAM,GAAG,eAAe,CAAA;AACjC,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,SAAiB,EAAE,MAAM,GAAG,KAAK;IAC5E,MAAM,GAAG,GAAG,WAAW,CAAC,SAAS,CAAC,CAAA;IAClC,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,CAAA;IACnC,IAAI,GAAG,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAA;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;IAClD,MAAM,KAAK,GAAG,GAAG,GAAG,MAAM,CAAC,MAAM,GAAG,IAAI,CAAA;IACxC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAA;AACvE,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,KAAa;IAClD,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7B,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,KAAK;QAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAA;IAC/E,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;AACpC,CAAC"}

package/dist/ir/types.d.ts

@@ -0,0 +1,82 @@
+/**
+ * The canonical internal representation.
+ *
+ * Every adapter normalises a provider's transcript into these types, and every
+ * later stage reads only these types. That is what makes a Codex session and a
+ * Claude session the same problem downstream — and it is the only reason adding
+ * an agent is a file rather than a fork.
+ *
+ * Spec: docs/SPEC.md §5.
+ */
+export type AgentKind = 'claude' | 'openclaude' | 'codex' | 'pi' | 'opencode' | 'deepseek' | 'generic';
+/** A session as discovered, before it is parsed. Cheap to produce. */
+export interface SessionRef {
+    agent: AgentKind;
+    /** Native id: a uuid for Claude, a rollout id for Codex, a filename stem for Pi. */
+    id: string;
+    /** Absolute path to the transcript on disk. */
+    path: string;
+    /** The project the session belongs to, when the store encodes one. */
+    projectPath?: string;
+    /** Modification time in epoch milliseconds. */
+    mtime: number;
+    /** Human label, when the format carries one. */
+    title?: string;
+    /** Cheap size estimate, from stat or a head parse. */
+    bytes?: number;
+    eventCount?: number;
+    approxTokens?: number;
+    /** Session files that belong to this session but are not the main transcript. */
+    siblings?: string[];
+}
+export type Role = 'user' | 'assistant' | 'system' | 'tool' | 'attachment';
+/** One normalised event. `eventIndex` is the provenance handle. */
+export interface IRMessage {
+    /** Provider uuid when the format has one; otherwise synthesised from index. */
+    uuid: string;
+    parentUuid?: string;
+    role: Role;
+    timestamp?: string;
+    text?: string;
+    toolName?: string;
+    toolUseId?: string;
+    /** The tool's arguments. The ledgers are built from these, not from prose. */
+    toolInput?: unknown;
+    toolResult?: unknown;
+    /** Harness-injected rather than typed by the human. Never treated as intent. */
+    isMeta?: boolean;
+    /** True when the human actually typed this. The only source of user intent. */
+    isHumanTurn?: boolean;
+    /** Provider said this event failed. */
+    isError?: boolean;
+    /** The original parsed record, for `expand` and for provenance. */
+    raw?: unknown;
+    /** Stable index in the source transcript. Never reassigned. */
+    eventIndex: number;
+}
+export interface SessionIR {
+    ref: SessionRef;
+    messages: IRMessage[];
+    /** Event indices where the provider compacted. Everything before one is already summarised. */
+    compactBoundaries: number[];
+    /** Provider-reported facts worth carrying: cwd, branch, model, versions. */
+    metadata: Record<string, unknown>;
+    /** Malformed lines, so a bad adapter is diagnosable rather than silent. */
+    diagnostics: Diagnostic[];
+}
+export interface Diagnostic {
+    line: number;
+    message: string;
+}
+/** `evt 12` or `evt 12–19`. The artifact's only pointer syntax. */
+export declare function evtLabel(from: number, to?: number): string;
+/**
+ * The transcript content after the last compact boundary, plus everything when
+ * there is none. A provider compaction already summarised what came before, so
+ * re-reading it means summarising a summary.
+ */
+export declare function afterLastBoundary(ir: SessionIR): IRMessage[];
+/** Events the human actually typed. Intent lives here and nowhere else. */
+export declare function humanTurns(ir: SessionIR): IRMessage[];
+/** Cwd recorded by the provider, if any. */
+export declare function sessionCwd(ir: SessionIR): string | undefined;