@pentoshi/clai 4.18.0 → 5.0.0

package/dist/store/history/session-frames.d.ts

@@ -0,0 +1,74 @@
+import type { TranscriptItem } from "../../app/ports/transcript-item.js";
+import type { ChatMessage } from "../../types.js";
+import { type HistorySummary } from "../history-index.js";
+import type { HistoryRecord } from "./recovery.js";
+export declare const SESSION_FRAME_VERSION = 1;
+export type HistoryRecordHead = Omit<HistoryRecord, "messages" | "transcript">;
+export interface SessionLogState {
+    readonly seq: number;
+    readonly head: HistoryRecordHead;
+    readonly summary: HistorySummary;
+    readonly messageDigests: readonly string[];
+    readonly transcriptDigests: readonly string[] | undefined;
+    readonly baseBytes: number;
+    readonly deltaCount: number;
+}
+export interface PlannedFrame {
+    readonly kind: "base" | "delta";
+    readonly line: string;
+    readonly bytes: number;
+    readonly state: SessionLogState;
+}
+interface ArrayPatch<T> {
+    readonly keep: number;
+    readonly append: T[];
+}
+interface BaseFrame {
+    readonly t: "base";
+    readonly seq: number;
+    readonly summary: HistorySummary;
+    readonly record: HistoryRecord;
+}
+interface DeltaFrame {
+    readonly t: "delta";
+    readonly seq: number;
+    readonly summary: HistorySummary;
+    readonly head: HistoryRecordHead;
+    readonly messages: ArrayPatch<ChatMessage>;
+    readonly transcript: ArrayPatch<TranscriptItem> | {
+        readonly absent: true;
+    };
+}
+export type SessionFrame = BaseFrame | DeltaFrame;
+export declare function digestJson(json: string): string;
+export declare function recordHead(record: HistoryRecord): HistoryRecordHead;
+export declare function planBaseFrame(seq: number, record: HistoryRecord): PlannedFrame;
+export declare function planSessionFrame(previous: SessionLogState | undefined, record: HistoryRecord, options?: {
+    readonly forceBase?: boolean;
+}): PlannedFrame;
+export declare function parseSessionFrame(text: string, sessionId: string): SessionFrame | undefined;
+export interface ReplayedSession {
+    readonly record: HistoryRecord;
+    readonly seq: number;
+    readonly summary: HistorySummary;
+    readonly baseBytes: number;
+    readonly deltaCount: number;
+}
+export declare class SessionReplay {
+    private readonly sessionId;
+    private messages;
+    private transcript;
+    private head;
+    private summary;
+    private seq;
+    private baseBytes;
+    private deltaCount;
+    private stopped;
+    constructor(sessionId: string);
+    get halted(): boolean;
+    accept(text: string, bytes: number): boolean;
+    private applies;
+    result(): ReplayedSession | undefined;
+}
+export declare function stateFromReplay(replayed: ReplayedSession): SessionLogState;
+export {};

package/dist/store/history/session-frames.js

@@ -0,0 +1,234 @@
+import { hash } from "node:crypto";
+import { historySummary } from "../history-index.js";
+export const SESSION_FRAME_VERSION = 1;
+const DELTA_BASE_RATIO = 0.5;
+const encodedElements = new WeakMap();
+export function digestJson(json) {
+    return hash("sha1", json, "base64");
+}
+function encodeElement(value) {
+    const cacheable = typeof value === "object" && value !== null;
+    const cached = cacheable ? encodedElements.get(value) : undefined;
+    if (cached)
+        return cached;
+    const json = JSON.stringify(value) ?? "null";
+    const encoded = { json, digest: digestJson(json) };
+    if (cacheable)
+        encodedElements.set(value, encoded);
+    return encoded;
+}
+function encodeList(values) {
+    const encoded = values.map(encodeElement);
+    return { json: encoded.map((element) => element.json), digests: encoded.map((element) => element.digest) };
+}
+function jsonArray(json) {
+    return `[${json.join(",")}]`;
+}
+export function recordHead(record) {
+    const { messages: _messages, transcript: _transcript, ...head } = record;
+    return head;
+}
+function recordJson(head, messages, transcript) {
+    const body = JSON.stringify(head).slice(1, -1);
+    const arrays = [`"messages":${jsonArray(messages)}`];
+    if (transcript)
+        arrays.push(`"transcript":${jsonArray(transcript)}`);
+    return `{${body}${body ? "," : ""}${arrays.join(",")}}`;
+}
+function frameHeader(kind, seq, summary) {
+    return `{"v":${SESSION_FRAME_VERSION},"t":"${kind}","seq":${seq},"summary":${JSON.stringify(summary)}`;
+}
+function commonPrefix(previous, next) {
+    const limit = Math.min(previous.length, next.length);
+    let index = 0;
+    while (index < limit && previous[index] === next[index])
+        index += 1;
+    return index;
+}
+function buildBase(seq, record, messages, transcript) {
+    const head = recordHead(record);
+    const summary = historySummary(record);
+    const line = `${frameHeader("base", seq, summary)},"record":${recordJson(head, messages.json, transcript?.json)}}\n`;
+    const bytes = Buffer.byteLength(line);
+    return {
+        kind: "base",
+        line,
+        bytes,
+        state: {
+            seq,
+            head,
+            summary,
+            messageDigests: messages.digests,
+            transcriptDigests: transcript?.digests,
+            baseBytes: bytes,
+            deltaCount: 0,
+        },
+    };
+}
+export function planBaseFrame(seq, record) {
+    return buildBase(seq, record, encodeList(record.messages), record.transcript ? encodeList(record.transcript) : undefined);
+}
+export function planSessionFrame(previous, record, options = {}) {
+    const messages = encodeList(record.messages);
+    const transcript = record.transcript ? encodeList(record.transcript) : undefined;
+    if (!previous || options.forceBase)
+        return buildBase(previous ? previous.seq + 1 : 0, record, messages, transcript);
+    const seq = previous.seq + 1;
+    const head = recordHead(record);
+    const summary = historySummary(record);
+    const messageKeep = commonPrefix(previous.messageDigests, messages.digests);
+    const transcriptKeep = transcript ? commonPrefix(previous.transcriptDigests ?? [], transcript.digests) : 0;
+    const transcriptPatch = transcript
+        ? `{"keep":${transcriptKeep},"append":${jsonArray(transcript.json.slice(transcriptKeep))}}`
+        : `{"absent":true}`;
+    const line = `${frameHeader("delta", seq, summary)},"head":${JSON.stringify(head)},` +
+        `"messages":{"keep":${messageKeep},"append":${jsonArray(messages.json.slice(messageKeep))}},` +
+        `"transcript":${transcriptPatch}}\n`;
+    const bytes = Buffer.byteLength(line);
+    const baseEstimate = messages.json.reduce((total, json) => total + json.length, 0) +
+        (transcript?.json.reduce((total, json) => total + json.length, 0) ?? 0);
+    if (bytes > baseEstimate * DELTA_BASE_RATIO && bytes > 4096)
+        return buildBase(seq, record, messages, transcript);
+    return {
+        kind: "delta",
+        line,
+        bytes,
+        state: {
+            seq,
+            head,
+            summary,
+            messageDigests: messages.digests,
+            transcriptDigests: transcript?.digests,
+            baseBytes: previous.baseBytes,
+            deltaCount: previous.deltaCount + 1,
+        },
+    };
+}
+function isObject(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isSeq(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
+function isPatch(value) {
+    return isObject(value) && isSeq(value.keep) && Array.isArray(value.append);
+}
+function isSummary(value, id) {
+    return isObject(value) && value.id === id;
+}
+export function parseSessionFrame(text, sessionId) {
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+    if (!isObject(value) || value.v !== SESSION_FRAME_VERSION || !isSeq(value.seq) || !isSummary(value.summary, sessionId))
+        return undefined;
+    if (value.t === "base") {
+        const record = value.record;
+        if (!isObject(record) || record.id !== sessionId || !Array.isArray(record.messages))
+            return undefined;
+        if (record.transcript !== undefined && !Array.isArray(record.transcript))
+            return undefined;
+        return value;
+    }
+    if (value.t === "delta") {
+        const head = value.head;
+        if (!isObject(head) || head.id !== sessionId || !isPatch(value.messages))
+            return undefined;
+        const transcript = value.transcript;
+        if (!(isObject(transcript) && transcript.absent === true) && !isPatch(transcript))
+            return undefined;
+        return value;
+    }
+    return undefined;
+}
+export class SessionReplay {
+    sessionId;
+    messages = [];
+    transcript;
+    head;
+    summary;
+    seq = -1;
+    baseBytes = 0;
+    deltaCount = 0;
+    stopped = false;
+    constructor(sessionId) {
+        this.sessionId = sessionId;
+    }
+    get halted() {
+        return this.stopped;
+    }
+    accept(text, bytes) {
+        if (this.stopped)
+            return false;
+        const frame = parseSessionFrame(text, this.sessionId);
+        if (!frame || !this.applies(frame)) {
+            this.stopped = true;
+            return false;
+        }
+        if (frame.t === "base") {
+            const { messages, transcript } = frame.record;
+            this.head = recordHead(frame.record);
+            this.messages = messages;
+            this.transcript = transcript;
+            this.baseBytes = bytes;
+            this.deltaCount = 0;
+        }
+        else {
+            this.head = frame.head;
+            this.messages = this.messages.slice(0, frame.messages.keep).concat(frame.messages.append);
+            if ("absent" in frame.transcript)
+                this.transcript = undefined;
+            else
+                this.transcript = (this.transcript ?? []).slice(0, frame.transcript.keep).concat(frame.transcript.append);
+            this.deltaCount += 1;
+        }
+        this.summary = frame.summary;
+        this.seq = frame.seq;
+        return true;
+    }
+    applies(frame) {
+        if (this.seq < 0)
+            return frame.t === "base";
+        if (frame.seq !== this.seq + 1)
+            return false;
+        if (frame.t === "base")
+            return true;
+        if (frame.messages.keep > this.messages.length)
+            return false;
+        if ("absent" in frame.transcript)
+            return true;
+        return frame.transcript.keep <= (this.transcript?.length ?? 0);
+    }
+    result() {
+        if (!this.head || !this.summary)
+            return undefined;
+        return {
+            record: {
+                ...this.head,
+                messages: this.messages,
+                ...(this.transcript ? { transcript: this.transcript } : {}),
+            },
+            seq: this.seq,
+            summary: this.summary,
+            baseBytes: this.baseBytes,
+            deltaCount: this.deltaCount,
+        };
+    }
+}
+export function stateFromReplay(replayed) {
+    const { record } = replayed;
+    return {
+        seq: replayed.seq,
+        head: recordHead(record),
+        summary: replayed.summary,
+        messageDigests: encodeList(record.messages).digests,
+        transcriptDigests: record.transcript ? encodeList(record.transcript).digests : undefined,
+        baseBytes: replayed.baseBytes,
+        deltaCount: replayed.deltaCount,
+    };
+}
+//# sourceMappingURL=session-frames.js.map

package/dist/store/history/session-frames.js.map

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

package/dist/store/history/session-index.d.ts

@@ -0,0 +1,13 @@
+import type { HistorySummary } from "../history-index.js";
+import { type LogStamp } from "./session-log.js";
+export interface SessionIndexEntry {
+    readonly key: string;
+    readonly size: number;
+    readonly mtimeMs: number;
+    readonly summary: HistorySummary;
+}
+export type SessionIndexPatch = ReadonlyMap<string, SessionIndexEntry | undefined>;
+export declare function indexEntryFor(sessionId: string, stamp: LogStamp, summary: HistorySummary): SessionIndexEntry;
+export declare function readSessionIndex(): Promise<Map<string, SessionIndexEntry> | undefined>;
+export declare function patchSessionIndex(patch: SessionIndexPatch): Promise<void>;
+export declare function listIndexedSessions(): Promise<Map<string, SessionIndexEntry>>;

package/dist/store/history/session-index.js

@@ -0,0 +1,135 @@
+import { randomBytes } from "node:crypto";
+import { mkdir, readdir, readFile, rm, writeFile } from "node:fs/promises";
+import { fixOwner } from "../../os/permissions.js";
+import { acquireStorageWriteLock } from "./jsonl-lock.js";
+import { loadSessionLog, loadSessionLogForKey, readSessionTailSummary, replaceFile, readTailSummaryForKey, statSessionLog } from "./session-log.js";
+import { isSessionKey, sessionIndexLockPath, sessionIndexPath, sessionKey, sessionsDirPath } from "./session-paths.js";
+const INDEX_SCHEMA_VERSION = 1;
+const STAMP_TOLERANCE_MS = 1;
+export function indexEntryFor(sessionId, stamp, summary) {
+    return { key: sessionKey(sessionId), size: stamp.size, mtimeMs: stamp.mtimeMs, summary };
+}
+function validEntry(id, entry) {
+    if (!entry || typeof entry !== "object")
+        return false;
+    const candidate = entry;
+    return typeof candidate.key === "string" &&
+        Number.isSafeInteger(candidate.size) &&
+        typeof candidate.mtimeMs === "number" &&
+        candidate.summary?.id === id;
+}
+export async function readSessionIndex() {
+    try {
+        const parsed = JSON.parse(await readFile(sessionIndexPath(), "utf8"));
+        if (parsed.schemaVersion !== INDEX_SCHEMA_VERSION || !parsed.entries || typeof parsed.entries !== "object")
+            return undefined;
+        const entries = new Map();
+        for (const [id, entry] of Object.entries(parsed.entries)) {
+            if (validEntry(id, entry))
+                entries.set(id, entry);
+        }
+        return entries;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function writeSessionIndex(entries) {
+    await mkdir(sessionsDirPath(), { recursive: true, mode: 0o700 });
+    await fixOwner(sessionsDirPath());
+    const body = { schemaVersion: INDEX_SCHEMA_VERSION, entries: Object.fromEntries(entries) };
+    const path = sessionIndexPath();
+    const temporary = `${path}.${process.pid}.${randomBytes(6).toString("hex")}.tmp`;
+    try {
+        await writeFile(temporary, `${JSON.stringify(body)}\n`, { mode: 0o600, flag: "wx" });
+        await fixOwner(temporary);
+        await replaceFile(temporary, path);
+    }
+    finally {
+        await rm(temporary, { force: true }).catch(() => undefined);
+    }
+}
+export async function patchSessionIndex(patch) {
+    if (patch.size === 0)
+        return;
+    const release = await acquireStorageWriteLock(sessionIndexLockPath(), "session index");
+    try {
+        const entries = (await readSessionIndex()) ?? await scanSessionSummaries();
+        for (const [id, entry] of patch) {
+            if (entry)
+                entries.set(id, entry);
+            else
+                entries.delete(id);
+        }
+        await writeSessionIndex(entries);
+    }
+    finally {
+        await release();
+    }
+}
+async function sessionKeysOnDisk() {
+    const names = await readdir(sessionsDirPath(), { withFileTypes: true }).catch(() => []);
+    return new Set(names.filter((entry) => entry.isDirectory() && isSessionKey(entry.name)).map((entry) => entry.name));
+}
+async function entryForKey(key) {
+    const tail = await readTailSummaryForKey(key);
+    if (tail)
+        return indexEntryFor(tail.summary.id, tail.stamp, tail.summary);
+    const loaded = await loadSessionLogForKey(key).catch(() => undefined);
+    return loaded ? indexEntryFor(loaded.replayed.summary.id, loaded.stamp, loaded.replayed.summary) : undefined;
+}
+async function entryForSession(sessionId) {
+    const tail = await readSessionTailSummary(sessionId);
+    if (tail)
+        return indexEntryFor(sessionId, tail.stamp, tail.summary);
+    const loaded = await loadSessionLog(sessionId).catch(() => undefined);
+    return loaded ? indexEntryFor(sessionId, loaded.stamp, loaded.replayed.summary) : undefined;
+}
+async function scanSessionSummaries() {
+    const entries = new Map();
+    const found = await Promise.all([...await sessionKeysOnDisk()].map(entryForKey));
+    for (const entry of found)
+        if (entry)
+            entries.set(entry.summary.id, entry);
+    return entries;
+}
+function stampMatches(entry, stamp) {
+    return stamp !== undefined && stamp.size === entry.size && Math.abs(stamp.mtimeMs - entry.mtimeMs) <= STAMP_TOLERANCE_MS;
+}
+export async function listIndexedSessions() {
+    const [indexed, keys] = await Promise.all([readSessionIndex(), sessionKeysOnDisk()]);
+    const entries = indexed ?? new Map();
+    const patch = new Map();
+    const seenKeys = new Set();
+    await Promise.all([...entries].map(async ([id, entry]) => {
+        if (!keys.has(entry.key)) {
+            entries.delete(id);
+            patch.set(id, undefined);
+            return;
+        }
+        seenKeys.add(entry.key);
+        const stamp = await statSessionLog(id);
+        if (stampMatches(entry, stamp))
+            return;
+        const refreshed = await entryForSession(id);
+        if (!refreshed) {
+            entries.delete(id);
+            patch.set(id, undefined);
+            return;
+        }
+        entries.set(id, refreshed);
+        patch.set(id, refreshed);
+    }));
+    const unindexed = [...keys].filter((key) => !seenKeys.has(key));
+    const discovered = await Promise.all(unindexed.map(entryForKey));
+    for (const entry of discovered) {
+        if (!entry)
+            continue;
+        entries.set(entry.summary.id, entry);
+        patch.set(entry.summary.id, entry);
+    }
+    if (patch.size > 0)
+        await patchSessionIndex(patch).catch(() => undefined);
+    return entries;
+}
+//# sourceMappingURL=session-index.js.map

package/dist/store/history/session-index.js.map

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

package/dist/store/history/session-log.d.ts

@@ -0,0 +1,44 @@
+import type { HistorySummary } from "../history-index.js";
+import { type ReplayedSession, type SessionLogState } from "./session-frames.js";
+export interface LogStamp {
+    readonly size: number;
+    readonly mtimeMs: number;
+    readonly ino: number;
+}
+export interface LoadedSessionLog {
+    readonly replayed: ReplayedSession;
+    readonly stamp: LogStamp;
+    readonly validEnd: number;
+    readonly path: string;
+}
+export declare function stampOf(info: {
+    size: number;
+    mtimeMs: number;
+    ino: number;
+}): LogStamp;
+export declare function sameStamp(left: LogStamp | undefined, right: LogStamp | undefined): boolean;
+export declare function stampKey(stamp: LogStamp): string;
+export declare function statSessionLog(sessionId: string): Promise<LogStamp | undefined>;
+export declare function cachedSessionState(sessionId: string, stamp: LogStamp | undefined): SessionLogState | undefined;
+export declare function rememberSessionState(sessionId: string, stamp: LogStamp, state: SessionLogState): void;
+export declare function forgetSessionState(sessionId?: string): void;
+export declare function loadSessionLogForKey(key: string): Promise<LoadedSessionLog | undefined>;
+export declare function loadSessionLog(sessionId: string): Promise<LoadedSessionLog | undefined>;
+export declare function loadSessionStateForWrite(sessionId: string): Promise<{
+    state: SessionLogState | undefined;
+    stamp: LogStamp | undefined;
+    loaded?: LoadedSessionLog | undefined;
+}>;
+export declare function appendSessionFrame(sessionId: string, line: string, expectedSize: number): Promise<LogStamp>;
+export declare function replaceFile(temporary: string, path: string): Promise<void>;
+export declare function rewriteSessionLog(sessionId: string, line: string): Promise<LogStamp>;
+export declare function removeSessionDirectory(sessionId: string): Promise<boolean>;
+export declare function readSessionTailSummary(sessionId: string): Promise<{
+    summary: HistorySummary;
+    stamp: LogStamp;
+} | undefined>;
+export declare function readTailSummaryForKey(key: string): Promise<{
+    summary: HistorySummary;
+    stamp: LogStamp;
+} | undefined>;
+export declare function readSessionLogBytes(sessionId: string): Promise<string>;