@nifrajs/coding-agent 3.2.0

package/dist/session-migration.js

@@ -0,0 +1,315 @@
+import { access, mkdir, readFile, rename, unlink, writeFile } from "node:fs/promises";
+import { basename, join, resolve } from "node:path";
+/** Version of the evidence-only legacy session file format. */
+export const SESSION_EVIDENCE_VERSION = 1;
+const HEX64 = /^[0-9a-f]{64}$/;
+const SESSION_TOKEN = /^[a-zA-Z0-9._:-]{1,128}$/;
+const EVENT_TYPE = /^[a-z][a-z0-9._:-]{0,63}$/;
+const MAX_SOURCE_BYTES = 64 * 1024 * 1024;
+export class SessionMigrationError extends Error {
+    code;
+    constructor(code, message) {
+        super(`session migration [${code}]: ${message}`);
+        this.code = code;
+        this.name = "SessionMigrationError";
+    }
+}
+/**
+ * Convert a legacy event type into a stable, content-free evidence code.
+ * Unknown event names are intentionally not copied to the target: their SHA-256 prefix gives a
+ * repeatable grouping key without disclosing an arbitrary source string.
+ */
+export async function stableSessionEventCode(type) {
+    if (KNOWN_EVENT_CODES.has(type))
+        return { code: type, replaced: false };
+    const digest = await sha256Hex(type);
+    return { code: `legacy.unknown.${digest.slice(0, 16)}`, replaced: true };
+}
+/** Parse one evidence record strictly. Payload-bearing or unknown fields are rejected. */
+export function parseSessionEvidenceRecord(value) {
+    if (!isRecord(value))
+        throw new SessionMigrationError("invalid_record", "record must be an object");
+    const allowed = ["version", "sessionId", "seq", "at", "code", "count", "digest", "pinned"];
+    for (const key of Object.keys(value))
+        if (!allowed.includes(key))
+            throw new SessionMigrationError("invalid_record", `unknown evidence field '${key}'`);
+    if (value.version !== SESSION_EVIDENCE_VERSION)
+        throw new SessionMigrationError("invalid_record", "unsupported evidence version");
+    const sessionId = requiredToken(value.sessionId, "sessionId");
+    const seq = nonNegativeInteger(value.seq, "seq");
+    const at = nonNegativeInteger(value.at, "at");
+    const code = requiredCode(value.code);
+    if (value.count !== 1)
+        throw new SessionMigrationError("invalid_record", "count must be 1");
+    const digest = value.digest;
+    if (typeof digest !== "string" || !HEX64.test(digest))
+        throw new SessionMigrationError("invalid_record", "digest must be sha256 hex");
+    if (value.pinned !== undefined && typeof value.pinned !== "boolean")
+        throw new SessionMigrationError("invalid_record", "pinned must be boolean");
+    return {
+        version: SESSION_EVIDENCE_VERSION,
+        sessionId,
+        seq,
+        at,
+        code,
+        count: 1,
+        digest,
+        ...(value.pinned === true ? { pinned: true } : {}),
+    };
+}
+/** Read, project, validate, and atomically commit one legacy local session. */
+export async function migrateLegacySession(options) {
+    assertNotAborted(options.signal);
+    const sourceRoot = resolve(options.sourceRoot);
+    const targetRoot = resolve(options.targetRoot);
+    const sessionId = validateSessionId(options.sessionId);
+    const maxSourceBytes = options.maxSourceBytes ?? MAX_SOURCE_BYTES;
+    if (!Number.isSafeInteger(maxSourceBytes) || maxSourceBytes < 1)
+        throw new SessionMigrationError("invalid_options", "maxSourceBytes must be positive");
+    if (sourceRoot === targetRoot ||
+        isWithin(sourceRoot, targetRoot) ||
+        isWithin(targetRoot, sourceRoot))
+        throw new SessionMigrationError("overlapping_roots", "sourceRoot and targetRoot must be separate directories");
+    const sourceEntries = await readLegacyEntries(sourceRoot, sessionId, maxSourceBytes);
+    const records = [];
+    const counts = Object.create(null);
+    const skippedByCode = Object.create(null);
+    let previousSeq = -1;
+    for (const entry of sourceEntries) {
+        assertNotAborted(options.signal);
+        if (entry.seq <= previousSeq)
+            throw new SessionMigrationError("invalid_source", "legacy sequence must increase strictly");
+        previousSeq = entry.seq;
+        const mapped = await stableSessionEventCode(entry.type);
+        const base = {
+            version: SESSION_EVIDENCE_VERSION,
+            sessionId,
+            seq: entry.seq,
+            at: entry.at,
+            code: mapped.code,
+            count: 1,
+            ...(entry.pinned === true ? { pinned: true } : {}),
+        };
+        const record = {
+            ...base,
+            digest: await sha256Hex(JSON.stringify(base)),
+        };
+        parseSessionEvidenceRecord(record);
+        records.push(Object.freeze(record));
+        counts[mapped.code] = (counts[mapped.code] ?? 0) + 1;
+        if (mapped.replaced)
+            skippedByCode[mapped.code] = (skippedByCode[mapped.code] ?? 0) + 1;
+    }
+    const lines = records.map((record) => JSON.stringify(record));
+    const content = lines.length === 0 ? "" : `${lines.join("\n")}\n`;
+    const digest = await sha256Hex(content);
+    const targetFile = join(targetRoot, `${sessionId}.jsonl`);
+    await commitTarget(targetRoot, targetFile, content, options.signal);
+    // Re-read the committed target and validate every line before the caller treats this as active.
+    const committed = await readEvidenceTarget(targetFile, sessionId);
+    if (committed.records.length !== records.length || (await sha256Hex(committed.raw)) !== digest)
+        throw new SessionMigrationError("target_validation", "committed evidence target changed");
+    for (let index = 0; index < committed.records.length; index++) {
+        const actual = committed.records[index];
+        const expected = records[index];
+        if (canonicalRecord(actual) !== canonicalRecord(expected))
+            throw new SessionMigrationError("target_validation", "committed evidence record differs");
+    }
+    const report = {
+        version: SESSION_EVIDENCE_VERSION,
+        sessionId,
+        records: records.length,
+        skipped: Object.values(skippedByCode).reduce((sum, value) => sum + value, 0),
+        skippedByCode: Object.freeze({ ...skippedByCode }),
+        counts: Object.freeze({ ...counts }),
+        ...(records[0] === undefined ? {} : { firstSeq: records[0].seq }),
+        ...(records.at(-1) === undefined ? {} : { lastSeq: records.at(-1).seq }),
+        digest,
+    };
+    return Object.freeze(report);
+}
+const KNOWN_EVENT_CODES = new Set([
+    "session.started",
+    "session.updated",
+    "turn.started",
+    "assistant.delta",
+    "assistant.message",
+    "tool.started",
+    "tool.delta",
+    "tool.completed",
+    "approval.required",
+    "approval.resolved",
+    "repair.required",
+    "verification.completed",
+    "memory.compacted",
+    "extension.reloaded",
+    "session.completed",
+    "session.failed",
+    "session.stopped",
+    "session.checkpoint",
+    "session.forked",
+]);
+async function readLegacyEntries(sourceRoot, sessionId, maxSourceBytes) {
+    const path = join(sourceRoot, `${sessionId}.jsonl`);
+    let text;
+    try {
+        const bytes = await readFile(path);
+        if (bytes.byteLength > maxSourceBytes)
+            throw new SessionMigrationError("source_too_large", "legacy session exceeds maxSourceBytes");
+        text = bytes.toString("utf8");
+    }
+    catch (error) {
+        if (isNotFound(error))
+            return Object.freeze([]);
+        throw error;
+    }
+    const entries = [];
+    const lines = text.split("\n");
+    for (let index = 0; index < lines.length; index++) {
+        const line = lines[index];
+        if (line.trim().length === 0)
+            continue;
+        let value;
+        try {
+            value = JSON.parse(line);
+        }
+        catch {
+            throw new SessionMigrationError("invalid_source", `legacy line ${index + 1} is not JSON`);
+        }
+        if (!isRecord(value))
+            throw new SessionMigrationError("invalid_source", `legacy line ${index + 1} is not an object`);
+        if (value.version !== 1 || value.sessionId !== sessionId)
+            throw new SessionMigrationError("invalid_source", `legacy line ${index + 1} has invalid identity`);
+        const seq = nonNegativeInteger(value.seq, `legacy line ${index + 1}.seq`);
+        const at = nonNegativeInteger(value.at, `legacy line ${index + 1}.at`);
+        if (typeof value.type !== "string" || !EVENT_TYPE.test(value.type))
+            throw new SessionMigrationError("invalid_source", `legacy line ${index + 1} has invalid type`);
+        if (value.pinned !== undefined && typeof value.pinned !== "boolean")
+            throw new SessionMigrationError("invalid_source", `legacy line ${index + 1} has invalid pinned flag`);
+        entries.push({
+            sessionId,
+            seq,
+            at,
+            type: value.type,
+            ...(value.pinned === true ? { pinned: true } : {}),
+        });
+    }
+    return Object.freeze(entries);
+}
+async function commitTarget(targetRoot, targetFile, content, signal) {
+    await mkdir(targetRoot, { recursive: true, mode: 0o700 });
+    try {
+        await access(targetFile);
+        throw new SessionMigrationError("target_exists", "migration target already exists");
+    }
+    catch (error) {
+        if (!(error instanceof SessionMigrationError) && !isNotFound(error))
+            throw error;
+        if (error instanceof SessionMigrationError)
+            throw error;
+    }
+    assertNotAborted(signal);
+    const temporary = join(targetRoot, `.${basename(targetFile)}.${process.pid}.${randomToken()}.tmp`);
+    try {
+        await writeFile(temporary, content, { encoding: "utf8", mode: 0o600, flag: "wx" });
+        assertNotAborted(signal);
+        // The target is created only after the complete temporary file exists. A pre-existing target
+        // was rejected above; callers must treat a concurrent target race as a failed migration.
+        try {
+            await access(targetFile);
+            throw new SessionMigrationError("target_exists", "migration target appeared during migration");
+        }
+        catch (error) {
+            if (error instanceof SessionMigrationError)
+                throw error;
+            if (!isNotFound(error))
+                throw error;
+        }
+        await rename(temporary, targetFile);
+    }
+    catch (error) {
+        await unlink(temporary).catch(() => undefined);
+        throw error;
+    }
+}
+async function readEvidenceTarget(path, sessionId) {
+    const raw = await readFile(path, "utf8");
+    const records = [];
+    let previousSeq = -1;
+    for (const line of raw.split("\n")) {
+        if (line.trim().length === 0)
+            continue;
+        const record = parseSessionEvidenceRecord(JSON.parse(line));
+        if (record.sessionId !== sessionId || record.seq <= previousSeq)
+            throw new SessionMigrationError("target_validation", "target identity or order is invalid");
+        const base = {
+            version: record.version,
+            sessionId: record.sessionId,
+            seq: record.seq,
+            at: record.at,
+            code: record.code,
+            count: record.count,
+            ...(record.pinned === true ? { pinned: true } : {}),
+        };
+        if ((await sha256Hex(JSON.stringify(base))) !== record.digest)
+            throw new SessionMigrationError("target_validation", "target record digest is invalid");
+        previousSeq = record.seq;
+        records.push(record);
+    }
+    return { records: Object.freeze(records), raw };
+}
+function validateSessionId(value) {
+    if (!SESSION_TOKEN.test(value))
+        throw new SessionMigrationError("invalid_options", "invalid sessionId");
+    return value;
+}
+function requiredToken(value, name) {
+    if (typeof value !== "string" || !SESSION_TOKEN.test(value))
+        throw new SessionMigrationError("invalid_record", `${name} must be a bounded token`);
+    return value;
+}
+function requiredCode(value) {
+    if (typeof value !== "string" ||
+        (!/^legacy\.[a-z0-9.-]+$/.test(value) && !KNOWN_EVENT_CODES.has(value)))
+        throw new SessionMigrationError("invalid_record", "code is invalid");
+    return value;
+}
+function nonNegativeInteger(value, name) {
+    if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0)
+        throw new SessionMigrationError("invalid_record", `${name} must be a non-negative integer`);
+    return value;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isNotFound(error) {
+    return error !== null && typeof error === "object" && "code" in error && error.code === "ENOENT";
+}
+function isWithin(parent, child) {
+    const prefix = parent.endsWith("/") ? parent : `${parent}/`;
+    return child.startsWith(prefix);
+}
+function assertNotAborted(signal) {
+    if (signal?.aborted)
+        throw new SessionMigrationError("aborted", "migration was interrupted");
+}
+function randomToken() {
+    return crypto.randomUUID().replaceAll("-", "");
+}
+async function sha256Hex(value) {
+    const hash = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(value));
+    return [...new Uint8Array(hash)].map((byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+function canonicalRecord(record) {
+    return JSON.stringify({
+        version: record.version,
+        sessionId: record.sessionId,
+        seq: record.seq,
+        at: record.at,
+        code: record.code,
+        count: record.count,
+        ...(record.pinned === true ? { pinned: true } : {}),
+        digest: record.digest,
+    });
+}
+//# sourceMappingURL=session-migration.js.map

package/dist/session-migration.js.map

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

package/dist/sessions.d.ts

@@ -0,0 +1,74 @@
+export interface SessionLogEntry {
+    readonly version: 1;
+    readonly sessionId: string;
+    readonly seq: number;
+    readonly at: number;
+    readonly type: string;
+    readonly payload?: unknown;
+    readonly pinned?: boolean;
+}
+export interface SessionStore {
+    append(sessionId: string, type: string, payload?: unknown, options?: {
+        readonly pinned?: boolean;
+    }): Promise<SessionLogEntry>;
+    read(sessionId: string): Promise<readonly SessionLogEntry[]>;
+    checkpoint(sessionId: string, payload: unknown): Promise<void>;
+    fork(sessionId: string, targetSessionId?: string): Promise<string>;
+}
+export interface FileSessionStoreOptions {
+    readonly root: string;
+    readonly maxEntryBytes?: number;
+}
+/**
+ * Small append-only JSONL store. It stores redacted, bounded event evidence rather than raw model
+ * transcripts, so session recovery is useful without turning the agent into a memory sink.
+ */
+export declare class FileSessionStore implements SessionStore {
+    private readonly root;
+    private readonly maxEntryBytes;
+    private readonly sequences;
+    constructor(options: FileSessionStoreOptions);
+    append(sessionId: string, type: string, payload?: unknown, options?: {
+        readonly pinned?: boolean;
+    }): Promise<SessionLogEntry>;
+    read(sessionId: string): Promise<readonly SessionLogEntry[]>;
+    checkpoint(sessionId: string, payload: unknown): Promise<void>;
+    fork(sessionId: string, targetSessionId?: string): Promise<string>;
+    private pathFor;
+    private nextSequence;
+}
+export interface ContextRecord {
+    readonly kind: string;
+    readonly content: string;
+    readonly pinned?: boolean;
+}
+export interface CompactionReport {
+    readonly before: number;
+    readonly after: number;
+    readonly removed: number;
+    readonly reason: "manual" | "threshold" | "overflow" | "workflow";
+}
+export interface ContextWindowOptions {
+    readonly maxTokens?: number;
+    readonly keepRecent?: number;
+    readonly maxSummaryChars?: number;
+    /** Optional extension-owned summary function. It cannot alter authoritative records. */
+    readonly summarize?: (records: readonly ContextRecord[], maxChars: number) => string;
+}
+/** In-memory prompt window with automatic, deterministic compaction and a hard size ceiling. */
+export declare class ContextWindow {
+    private readonly maxTokens;
+    private readonly keepRecent;
+    private readonly maxSummaryChars;
+    private readonly summarizeRecord;
+    private records;
+    constructor(options?: ContextWindowOptions);
+    get tokens(): number;
+    get size(): number;
+    snapshot(): readonly ContextRecord[];
+    /** Restore bounded prompt context from persisted evidence without bypassing compaction rules. */
+    restore(records: readonly ContextRecord[]): void;
+    append(record: ContextRecord): CompactionReport | undefined;
+    compact(reason?: CompactionReport["reason"]): CompactionReport;
+}
+//# sourceMappingURL=sessions.d.ts.map

package/dist/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../src/sessions.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;IACnB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GACtC,OAAO,CAAC,eAAe,CAAC,CAAA;IAC3B,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAAA;IAC5D,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9D,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACnE;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAChC;AAED;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;gBAE1C,OAAO,EAAE,uBAAuB;IAOtC,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,EACjB,OAAO,GAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAC1C,OAAO,CAAC,eAAe,CAAC;IAyBrB,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC;IAmB5D,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAe9D,IAAI,CACR,SAAS,EAAE,MAAM,EACjB,eAAe,SAAiD,GAC/D,OAAO,CAAC,MAAM,CAAC;IAclB,OAAO,CAAC,OAAO;YAID,YAAY;CAM3B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,CAAA;CAClE;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,wFAAwF;IACxF,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAA;CACrF;AAED,gGAAgG;AAChG,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiE;IACjG,OAAO,CAAC,OAAO,CAAsB;gBAEzB,OAAO,GAAE,oBAAyB;IAW9C,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,QAAQ,IAAI,SAAS,aAAa,EAAE;IAIpC,iGAAiG;IACjG,OAAO,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,IAAI;IAKhD,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,gBAAgB,GAAG,SAAS;IAU3D,OAAO,CAAC,MAAM,GAAE,gBAAgB,CAAC,QAAQ,CAAY,GAAG,gBAAgB;CA4BzE"}

package/dist/sessions.js

@@ -0,0 +1,222 @@
+import { appendFile, mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+/**
+ * Small append-only JSONL store. It stores redacted, bounded event evidence rather than raw model
+ * transcripts, so session recovery is useful without turning the agent into a memory sink.
+ */
+export class FileSessionStore {
+    root;
+    maxEntryBytes;
+    sequences = new Map();
+    constructor(options) {
+        this.root = options.root;
+        this.maxEntryBytes = options.maxEntryBytes ?? 256 * 1024;
+        if (!Number.isSafeInteger(this.maxEntryBytes) || this.maxEntryBytes < 1024)
+            throw new RangeError("session store: maxEntryBytes must be at least 1024");
+    }
+    async append(sessionId, type, payload, options = {}) {
+        validateToken(sessionId, "sessionId");
+        if (!/^[a-z][a-z0-9._:-]{0,63}$/.test(type))
+            throw new TypeError("session store: invalid event type");
+        await mkdir(this.root, { recursive: true });
+        const nextSeq = await this.nextSequence(sessionId);
+        const entry = Object.freeze({
+            version: 1,
+            sessionId,
+            seq: nextSeq,
+            at: Date.now(),
+            type,
+            ...(payload === undefined
+                ? {}
+                : { payload: boundValue(redactValue(payload), this.maxEntryBytes) }),
+            ...(options.pinned === true ? { pinned: true } : {}),
+        });
+        const line = JSON.stringify(entry);
+        if (Buffer.byteLength(line, "utf8") > this.maxEntryBytes)
+            throw new RangeError("session store: event exceeds maxEntryBytes");
+        await appendFile(this.pathFor(sessionId), `${line}\n`, "utf8");
+        this.sequences.set(sessionId, nextSeq);
+        return entry;
+    }
+    async read(sessionId) {
+        validateToken(sessionId, "sessionId");
+        try {
+            const text = await readFile(this.pathFor(sessionId), "utf8");
+            const entries = [];
+            for (const line of text.split("\n")) {
+                if (line.trim().length === 0)
+                    continue;
+                const value = JSON.parse(line);
+                if (isSessionLogEntry(value, sessionId))
+                    entries.push(Object.freeze(value));
+            }
+            const last = entries.at(-1)?.seq;
+            if (last !== undefined)
+                this.sequences.set(sessionId, last);
+            return Object.freeze(entries);
+        }
+        catch (error) {
+            if (isNotFound(error))
+                return Object.freeze([]);
+            throw error;
+        }
+    }
+    async checkpoint(sessionId, payload) {
+        validateToken(sessionId, "sessionId");
+        const target = join(this.root, `${sessionId}.checkpoint.json`);
+        const temporary = `${target}.${process.pid}.${Date.now()}.tmp`;
+        await mkdir(dirname(target), { recursive: true });
+        const content = JSON.stringify({
+            version: 1,
+            sessionId,
+            at: Date.now(),
+            payload: boundValue(redactValue(payload), this.maxEntryBytes),
+        });
+        await writeFile(temporary, content, "utf8");
+        await rename(temporary, target);
+    }
+    async fork(sessionId, targetSessionId = `${sessionId}:fork:${Date.now().toString(36)}`) {
+        validateToken(sessionId, "sessionId");
+        validateToken(targetSessionId, "targetSessionId");
+        const entries = await this.read(sessionId);
+        await mkdir(this.root, { recursive: true });
+        const target = this.pathFor(targetSessionId);
+        const lines = entries.map((entry, index) => JSON.stringify({ ...entry, sessionId: targetSessionId, seq: index }));
+        await writeFile(target, lines.length === 0 ? "" : `${lines.join("\n")}\n`, "utf8");
+        this.sequences.set(targetSessionId, Math.max(0, lines.length - 1));
+        return targetSessionId;
+    }
+    pathFor(sessionId) {
+        return join(this.root, `${sessionId}.jsonl`);
+    }
+    async nextSequence(sessionId) {
+        const cached = this.sequences.get(sessionId);
+        if (cached !== undefined)
+            return cached + 1;
+        const entries = await this.read(sessionId);
+        return (entries.at(-1)?.seq ?? -1) + 1;
+    }
+}
+/** In-memory prompt window with automatic, deterministic compaction and a hard size ceiling. */
+export class ContextWindow {
+    maxTokens;
+    keepRecent;
+    maxSummaryChars;
+    summarizeRecord;
+    records = [];
+    constructor(options = {}) {
+        this.maxTokens = options.maxTokens ?? 32_000;
+        this.keepRecent = options.keepRecent ?? 24;
+        this.maxSummaryChars = options.maxSummaryChars ?? 4_096;
+        this.summarizeRecord = options.summarize ?? summarize;
+        if (!Number.isSafeInteger(this.maxTokens) || this.maxTokens < 256)
+            throw new RangeError("context window: maxTokens must be at least 256");
+        if (!Number.isSafeInteger(this.keepRecent) || this.keepRecent < 1)
+            throw new RangeError("context window: keepRecent must be positive");
+    }
+    get tokens() {
+        return estimateTokens(this.records);
+    }
+    get size() {
+        return this.records.length;
+    }
+    snapshot() {
+        return Object.freeze(this.records.map((record) => Object.freeze({ ...record })));
+    }
+    /** Restore bounded prompt context from persisted evidence without bypassing compaction rules. */
+    restore(records) {
+        this.records = [];
+        for (const record of records.slice(-Math.max(this.keepRecent * 8, 256)))
+            this.append(record);
+    }
+    append(record) {
+        this.records.push({
+            kind: record.kind,
+            content: record.content.slice(0, this.maxSummaryChars),
+            ...(record.pinned === true ? { pinned: true } : {}),
+        });
+        if (this.tokens <= this.maxTokens)
+            return undefined;
+        return this.compact("threshold");
+    }
+    compact(reason = "manual") {
+        const before = this.tokens;
+        if (this.records.length <= this.keepRecent)
+            return { before, after: before, removed: 0, reason };
+        // A compacted summary is replaceable context, not authoritative evidence. Keeping old pinned
+        // summaries in `protectedRecords` would make every threshold compaction grow the live window.
+        const protectedRecords = this.records.filter((record) => record.kind !== "memory.summary" &&
+            (record.pinned === true || isAuthoritative(record.kind)));
+        const recent = this.records.slice(-this.keepRecent);
+        const retained = new Set([...protectedRecords, ...recent]);
+        const omitted = this.records.filter((record) => !retained.has(record));
+        if (omitted.length === 0)
+            return { before, after: before, removed: 0, reason };
+        const summary = this.summarizeRecord(omitted, this.maxSummaryChars).slice(0, this.maxSummaryChars);
+        this.records = [
+            ...protectedRecords,
+            { kind: "memory.summary", content: summary, pinned: true },
+            ...recent.filter((record) => record.kind !== "memory.summary" && !protectedRecords.includes(record)),
+        ];
+        const after = this.tokens;
+        return { before, after, removed: omitted.length, reason };
+    }
+}
+function validateToken(value, name) {
+    if (!/^[a-zA-Z0-9._:-]{1,128}$/.test(value))
+        throw new TypeError(`session store: ${name} must be a bounded token`);
+}
+function isNotFound(error) {
+    return error !== null && typeof error === "object" && "code" in error && error.code === "ENOENT";
+}
+function isSessionLogEntry(value, sessionId) {
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const record = value;
+    return (record.version === 1 &&
+        record.sessionId === sessionId &&
+        typeof record.seq === "number" &&
+        Number.isSafeInteger(record.seq) &&
+        typeof record.at === "number" &&
+        typeof record.type === "string");
+}
+function redactValue(value, key = "", depth = 0) {
+    if (depth > 5)
+        return "[depth-limited]";
+    if (/(?:secret|token|password|passwd|authorization|api[-_]?key|private[-_]?key)/i.test(key))
+        return "[redacted]";
+    if (typeof value === "string")
+        return value.length > 16_384 ? `${value.slice(0, 16_384)}…[truncated]` : value;
+    if (Array.isArray(value))
+        return value.slice(0, 256).map((item) => redactValue(item, "", depth + 1));
+    if (value !== null && typeof value === "object") {
+        const result = {};
+        for (const [childKey, childValue] of Object.entries(value).slice(0, 256))
+            result[childKey] = redactValue(childValue, childKey, depth + 1);
+        return result;
+    }
+    return value;
+}
+function boundValue(value, maxBytes) {
+    const text = JSON.stringify(value);
+    if (Buffer.byteLength(text, "utf8") <= maxBytes)
+        return value;
+    return "[payload-truncated]";
+}
+function estimateTokens(records) {
+    return Math.ceil(records.reduce((total, record) => total + record.kind.length + record.content.length, 0) / 4);
+}
+function isAuthoritative(kind) {
+    return (kind.startsWith("approval") || kind.startsWith("verification") || kind === "session.checkpoint");
+}
+function summarize(records, maxChars) {
+    const lines = [`Compacted ${records.length} earlier context entries.`];
+    for (const record of records.slice(-32)) {
+        const line = `- ${record.kind}: ${record.content.replace(/\s+/g, " ").slice(0, 180)}`;
+        if (lines.join("\n").length + line.length + 1 > maxChars)
+            break;
+        lines.push(line);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=sessions.js.map

package/dist/sessions.js.map

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