@calliopelabs/cli 3.0.0 → 3.2.0

package/dist/session-management/transfer.d.ts

@@ -0,0 +1,9 @@
+import * as storage from '../storage.js';
+import { type ConversationState } from '../sessions/index.js';
+import { type SessionActionOptions } from './permissions.js';
+export declare function exportSession(cwd: string, id: string, path: string, options?: SessionActionOptions): Promise<string>;
+export declare function importSession(cwd: string, path: string, options?: SessionActionOptions): Promise<{
+    session: storage.Session;
+    state: ConversationState;
+}>;
+//# sourceMappingURL=transfer.d.ts.map

package/dist/session-management/transfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer.d.ts","sourceRoot":"","sources":["../../src/session-management/transfer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,OAAO,MAAM,eAAe,CAAC;AACzC,OAAO,EAAwE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAIpI,OAAO,EAA0B,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGrF,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAK9H;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,CAAC,CAkBlK"}

package/dist/session-management/transfer.js

@@ -0,0 +1,39 @@
+import { realpathSync } from 'node:fs';
+import * as storage from '../storage.js';
+import { makeBundle, readToolState, toolStateHash, parseBundle, installBundle } from '../sessions/index.js';
+import { throwIfCancelled } from '../cancellation.js';
+import { RunLog } from '../runlog.js';
+import { sessionHistory, selectSession } from './actions.js';
+import { authorizeSessionAction } from './permissions.js';
+import { readSessionTransfer, writeSessionTransfer } from './files.js';
+export async function exportSession(cwd, id, path, options = {}) {
+    const session = selectSession(id, cwd), log = options.runlog ?? RunLog.open(session.id);
+    const replay = await sessionHistory(session.id, undefined, options.signal);
+    const bundle = makeBundle(replay, readToolState(storage.getSessionDirById(session.id)));
+    return writeSessionTransfer(cwd, path, JSON.stringify(bundle) + '\n', { ...options, runlog: log });
+}
+export async function importSession(cwd, path, options = {}) {
+    const root = realpathSync(cwd), text = await readSessionTransfer(root, path, options);
+    const { bundle } = await parseBundle(text, options.signal);
+    await authorizeSessionAction(root, 'session_import', { path: root, source: bundle.source, checksum: bundle.checksum }, options);
+    throwIfCancelled(options.signal);
+    const session = storage.createSession(root, { activate: false, lineage: { version: 1, toolStateHash: toolStateHash(bundle.toolState), kind: 'import', ...bundle.source, at: new Date().toISOString() } });
+    const log = RunLog.open(session.id);
+    try {
+        const replay = await installBundle(storage.getSessionDirById(session.id), session.id, text, options.signal);
+        storage.updateSessionSummary(session.id, replay.snapshot);
+        log.policyEvent({ tool: 'session_import', source: 'session-history', decision: 'allow', durationMs: 0,
+            reason: `source=${bundle.source.sessionId} revision=${bundle.source.revision} checksum=${bundle.checksum}` });
+        return { session: { ...session, messageCount: replay.snapshot.messages.length }, state: replay.snapshot };
+    }
+    catch (error) {
+        log.policyEvent({ tool: 'session_import', source: 'session-history', decision: 'deny', durationMs: 0, reason: 'Import failed; inactive partial session preserved.' });
+        if (options.signal?.aborted)
+            throw error;
+        throw new Error(`Import failed; inactive partial session ${session.id} was preserved. Retry into a new session.`);
+    }
+    finally {
+        await log.flush();
+    }
+}
+//# sourceMappingURL=transfer.js.map

package/dist/session-management/transfer.js.map

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

package/dist/sessions/context.d.ts

@@ -0,0 +1,4 @@
+/** Pin legacy session-scoped tools to the calling runtime, including parallel turns. */
+export declare function withSession<T>(id: string, action: () => T): T;
+export declare function activeSessionId(): string | undefined;
+//# sourceMappingURL=context.d.ts.map

package/dist/sessions/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/sessions/context.ts"],"names":[],"mappings":"AAGA,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAoC;AAClG,wBAAgB,eAAe,IAAI,MAAM,GAAG,SAAS,CAA+B"}

package/dist/sessions/context.js

@@ -0,0 +1,6 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+const session = new AsyncLocalStorage();
+/** Pin legacy session-scoped tools to the calling runtime, including parallel turns. */
+export function withSession(id, action) { return session.run(id, action); }
+export function activeSessionId() { return session.getStore(); }
+//# sourceMappingURL=context.js.map

package/dist/sessions/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/sessions/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAU,CAAC;AAChD,wFAAwF;AACxF,MAAM,UAAU,WAAW,CAAI,EAAU,EAAE,MAAe,IAAO,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;AAClG,MAAM,UAAU,eAAe,KAAyB,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC"}

package/dist/sessions/format.d.ts

@@ -0,0 +1,38 @@
+import type { Message } from '../types.js';
+export declare const MAX_SNAPSHOT_BYTES: number;
+export declare const MAX_SNAPSHOT_MESSAGES = 10000;
+export type RecoveryStatus = 'active' | 'completed' | 'cancelled' | 'interrupted' | 'waiting_for_user';
+export interface ConversationState {
+    revision: string | null;
+    messages: Message[];
+    status: RecoveryStatus;
+    droppedMessages: number;
+    history?: {
+        id: string;
+        hash: string;
+        sessionId: string;
+    };
+}
+export interface ConversationSnapshot extends ConversationState {
+    version: 1;
+    sessionId: string;
+    revision: string;
+    updatedAt: string;
+    checksum: string;
+}
+export declare class SessionRecoveryError extends Error {
+    readonly code: 'invalid' | 'conflict' | 'locked' | 'io';
+    constructor(code: 'invalid' | 'conflict' | 'locked' | 'io', message: string);
+}
+export declare const invalid: () => SessionRecoveryError;
+export declare const hash: (text: string) => string;
+export declare const object: (v: unknown) => v is Record<string, unknown>;
+export declare const statuses: RecoveryStatus[];
+/** Keep protocol-owned JSON opaque, while rejecting lossy or unbounded values. */
+export declare function validateMessages(value: unknown): asserts value is Message[];
+/** The count is a soft boundary: retain the initial system message and whole tool groups. */
+export declare function retainMessages(messages: Message[], cap: number): Message[];
+export declare function readPrivateSessionFile(file: string, limit?: number): string | null;
+/** A session directory must be a real, immediate child of the configured store. */
+export declare function assertSessionDirectory(dir: string): void;
+//# sourceMappingURL=format.d.ts.map

package/dist/sessions/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/sessions/format.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,eAAO,MAAM,kBAAkB,QAAmB,CAAC;AACnD,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAC3C,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,GAAG,aAAa,GAAG,kBAAkB,CAAC;AACvG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3D;AACD,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AACD,qBAAa,oBAAqB,SAAQ,KAAK;aACjB,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,IAAI;IAA1E,YAA4B,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,EAE1F;CACF;AACD,eAAO,MAAM,OAAO,4BAAwI,CAAC;AAC7J,eAAO,MAAM,IAAI,SAAU,MAAM,WAAoD,CAAC;AACtF,eAAO,MAAM,MAAM,MAAO,OAAO,KAAG,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAsD,CAAC;AACtH,eAAO,MAAM,QAAQ,EAAE,cAAc,EAA4E,CAAC;AAElH,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,EAAE,CAoC3E;AAED,6FAA6F;AAC7F,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,EAAE,CAO1E;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAqB,GAAG,MAAM,GAAG,IAAI,CAa9F;AAED,mFAAmF;AACnF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAIxD"}

package/dist/sessions/format.js

@@ -0,0 +1,116 @@
+import * as fs from 'node:fs';
+import { dirname } from 'node:path';
+import { createHash } from 'node:crypto';
+export const MAX_SNAPSHOT_BYTES = 16 * 1024 * 1024;
+export const MAX_SNAPSHOT_MESSAGES = 10000;
+export class SessionRecoveryError extends Error {
+    code;
+    constructor(code, message) {
+        super(`Session recovery: ${message}`);
+        this.code = code;
+        this.name = 'SessionRecoveryError';
+    }
+}
+export const invalid = () => new SessionRecoveryError('invalid', 'invalid or damaged snapshot; preserve the file and start /new or restore a known backup.');
+export const hash = (text) => createHash('sha256').update(text).digest('hex');
+export const object = (v) => !!v && typeof v === 'object' && !Array.isArray(v);
+export const statuses = ['active', 'completed', 'cancelled', 'interrupted', 'waiting_for_user'];
+/** Keep protocol-owned JSON opaque, while rejecting lossy or unbounded values. */
+export function validateMessages(value) {
+    if (!Array.isArray(value) || value.length > MAX_SNAPSHOT_MESSAGES)
+        throw invalid();
+    const pending = [{ value, depth: 0 }];
+    let nodes = 0, bytes = 0;
+    while (pending.length) {
+        const item = pending.pop();
+        if (++nodes > 1000000 || item.depth > 64)
+            throw invalid();
+        const v = item.value;
+        if (typeof v === 'string') {
+            bytes += Buffer.byteLength(v);
+            if (bytes > MAX_SNAPSHOT_BYTES)
+                throw new SessionRecoveryError('invalid', 'snapshot exceeds 16 MiB; compact the conversation or start /new.');
+            continue;
+        }
+        if (v === null || v === undefined || typeof v === 'boolean')
+            continue;
+        if (typeof v === 'number' && Number.isFinite(v))
+            continue;
+        if (typeof v !== 'object' || !Array.isArray(v) && Object.getPrototypeOf(v) !== Object.prototype)
+            throw invalid();
+        for (const child of Object.values(v))
+            pending.push({ value: child, depth: item.depth + 1 });
+    }
+    let calls = new Set(), results = new Set();
+    for (const m of value) {
+        if (!object(m) || !['user', 'assistant', 'system', 'tool'].includes(String(m.role)))
+            throw invalid();
+        if (typeof m.content !== 'string' && !(Array.isArray(m.content) && m.content.every(part => object(part) &&
+            (part.type === 'text' && typeof part.text === 'string' || part.type === 'image' && typeof part.data === 'string' &&
+                ['image/jpeg', 'image/png', 'image/gif', 'image/webp'].includes(String(part.mediaType))))))
+            throw invalid();
+        if (m.role === 'tool' && (typeof m.toolCallId !== 'string' || !m.toolCallId))
+            throw invalid();
+        if (m.providerMetadata !== undefined && !object(m.providerMetadata))
+            throw invalid();
+        if (m.toolCalls !== undefined && (m.role !== 'assistant' || !Array.isArray(m.toolCalls) || !m.toolCalls.every(call => object(call) && typeof call.id === 'string' && !!call.id && typeof call.name === 'string' && !!call.name && object(call.arguments))))
+            throw invalid();
+        if (Array.isArray(m.toolCalls) && new Set(m.toolCalls.map(call => call.id)).size !== m.toolCalls.length)
+            throw invalid();
+        if (m.role === 'tool') {
+            if (!calls.has(m.toolCallId) || results.has(m.toolCallId))
+                throw invalid();
+            results.add(m.toolCallId);
+        }
+        else {
+            calls = new Set(m.toolCalls?.map(call => call.id));
+            results = new Set();
+        }
+    }
+}
+/** The count is a soft boundary: retain the initial system message and whole tool groups. */
+export function retainMessages(messages, cap) {
+    if (!Number.isSafeInteger(cap) || cap < 1 || cap > MAX_SNAPSHOT_MESSAGES)
+        throw invalid();
+    if (messages.length <= cap)
+        return messages;
+    const system = messages[0]?.role === 'system';
+    let start = Math.max(system ? 1 : 0, messages.length - Math.max(1, cap - (system ? 1 : 0)));
+    while (start > 0 && messages[start]?.role === 'tool')
+        start--;
+    return system && start > 0 ? [messages[0], ...messages.slice(start)] : messages.slice(start);
+}
+export function readPrivateSessionFile(file, limit = MAX_SNAPSHOT_BYTES) {
+    let fd;
+    try {
+        fd = fs.openSync(file, fs.constants.O_RDONLY | fs.constants.O_NOFOLLOW | fs.constants.O_NONBLOCK);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return null;
+        throw invalid();
+    }
+    try {
+        const stat = fs.fstatSync(fd);
+        if (!stat.isFile() || stat.size > limit)
+            throw invalid();
+        const buffer = Buffer.alloc(stat.size + 1);
+        let size = 0, n = 0;
+        while (size < buffer.length && (n = fs.readSync(fd, buffer, size, buffer.length - size, null)) > 0)
+            size += n;
+        if (size !== stat.size)
+            throw invalid();
+        return buffer.subarray(0, size).toString('utf8');
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+}
+/** A session directory must be a real, immediate child of the configured store. */
+export function assertSessionDirectory(dir) {
+    const root = fs.realpathSync(dirname(dir));
+    const stat = fs.lstatSync(dir);
+    if (!stat.isDirectory() || stat.isSymbolicLink() || dirname(fs.realpathSync(dir)) !== root)
+        throw invalid();
+}
+//# sourceMappingURL=format.js.map

package/dist/sessions/format.js.map

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

package/dist/sessions/history.d.ts

@@ -0,0 +1,37 @@
+import { type ConversationState, type ConversationSnapshot, type RecoveryStatus } from './format.js';
+import type { Message } from '../types.js';
+export interface EventLink {
+    id: string;
+    hash: string;
+    sessionId: string;
+}
+export interface SessionEvent extends EventLink {
+    version: 1;
+    at: string;
+    parent: EventLink | null;
+    change: {
+        keep: number;
+        append: Message[];
+        status: RecoveryStatus;
+        droppedMessages: number;
+    };
+    stateHash: string;
+}
+export declare const MAX_HISTORY_EVENTS = 10000;
+export declare const MAX_HISTORY_BYTES: number;
+export declare const stateHash: (state: Pick<ConversationState, 'messages' | 'status' | 'droppedMessages'>) => string;
+export declare const eventLink: (event: SessionEvent) => EventLink;
+export declare function validateEvent(value: unknown, sessionId: string): SessionEvent;
+export declare function makeEvent(sessionId: string, previous: ConversationState | null, next: ConversationState, parent: EventLink | null, id?: `${string}-${string}-${string}-${string}-${string}`, at?: string): SessionEvent;
+export declare function readSessionEvent(dir: string, sessionId: string | undefined, id: string): SessionEvent;
+/** Caller holds messages.lock. Orphans count toward the budget and are never erased. */
+export declare function appendSessionEvents(dir: string, events: SessionEvent[], signal?: AbortSignal): void;
+export declare function applyEvent(previous: ConversationState | null, event: SessionEvent): ConversationSnapshot;
+export interface HistoryReplay {
+    snapshot: ConversationSnapshot;
+    events: SessionEvent[];
+}
+/** Pure deterministic projection; yields so cancellation can interrupt large histories. */
+export declare function replayEvents(events: SessionEvent[], head: EventLink, sessionId: string, signal?: AbortSignal): Promise<HistoryReplay>;
+export declare function replaySessionHistory(dir: string, sessionId: string, head: EventLink, signal?: AbortSignal): Promise<HistoryReplay>;
+//# sourceMappingURL=history.d.ts.map

package/dist/sessions/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/sessions/history.ts"],"names":[],"mappings":"AAKA,OAAO,EACwD,KAAK,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC3J,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,SAAS;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE;AAC1E,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC7C,OAAO,EAAE,CAAC,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QAAC,MAAM,EAAE,cAAc,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7F,SAAS,EAAE,MAAM,CAAC;CACnB;AACD,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AACxC,eAAO,MAAM,iBAAiB,QAAmB,CAAC;AAIlD,eAAO,MAAM,SAAS,UAAW,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,QAAQ,GAAG,iBAAiB,CAAC,KAAG,MACY,CAAC;AACnH,eAAO,MAAM,SAAS,UAAW,YAAY,KAAG,SAA6E,CAAC;AAE9H,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,CAiB7E;AAED,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,IAAI,EAAE,IAAI,EAAE,iBAAiB,EACtG,MAAM,EAAE,SAAS,GAAG,IAAI,EAAE,EAAE,sDAAe,EAAE,EAAE,SAA2B,GAAG,YAAY,CAQ1F;AAUD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,YAAY,CAWrG;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAyBnG;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,EAAE,KAAK,EAAE,YAAY,GAAG,oBAAoB,CAQxG;AAED,MAAM,WAAW,aAAa;IAAG,QAAQ,EAAE,oBAAoB,CAAC;IAAC,MAAM,EAAE,YAAY,EAAE,CAAA;CAAE;AACzF,2FAA2F;AAC3F,wBAAsB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAiC3I;AAED,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAYxI"}

package/dist/sessions/history.js

@@ -0,0 +1,197 @@
+/** Immutable delta records; messages.json commits the chosen history head. */
+import * as fs from 'node:fs';
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { throwIfCancelled } from '../cancellation.js';
+import { assertSessionDirectory, hash, invalid, object, readPrivateSessionFile, SessionRecoveryError, statuses, validateMessages, MAX_SNAPSHOT_BYTES, MAX_SNAPSHOT_MESSAGES } from './format.js';
+export const MAX_HISTORY_EVENTS = 10000;
+export const MAX_HISTORY_BYTES = 64 * 1024 * 1024;
+const uuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
+const digest = /^[0-9a-f]{64}$/;
+const fields = new Set(['version', 'id', 'hash', 'sessionId', 'at', 'parent', 'change', 'stateHash']);
+export const stateHash = (state) => hash(JSON.stringify({ messages: state.messages, status: state.status, droppedMessages: state.droppedMessages }));
+export const eventLink = (event) => ({ id: event.id, hash: event.hash, sessionId: event.sessionId });
+export function validateEvent(value, sessionId) {
+    if (!object(value))
+        throw invalid();
+    const event = value;
+    const link = (value) => object(value) && Object.keys(value).length === 3 && typeof value.sessionId === 'string' && /^[a-zA-Z0-9_-]{1,200}$/.test(value.sessionId) && typeof value.id === 'string' && uuid.test(value.id) && typeof value.hash === 'string' && digest.test(value.hash);
+    if (Object.keys(value).some(key => !fields.has(key)) || event.version !== 1 || event.sessionId !== sessionId || !/^[a-zA-Z0-9_-]{1,200}$/.test(event.sessionId) ||
+        typeof event.id !== 'string' || !uuid.test(event.id) || typeof event.at !== 'string' || !Number.isFinite(Date.parse(event.at)) ||
+        new Date(event.at).toISOString() !== event.at || event.parent !== null && !link(event.parent) ||
+        !object(event.change) || Object.keys(event.change).sort().join() !== 'append,droppedMessages,keep,status' ||
+        !Number.isSafeInteger(event.change.keep) || event.change.keep < 0 || event.change.keep > MAX_SNAPSHOT_MESSAGES ||
+        !Array.isArray(event.change.append) || event.change.append.length > MAX_SNAPSHOT_MESSAGES ||
+        !Number.isSafeInteger(event.change.droppedMessages) || event.change.droppedMessages < 0 ||
+        !statuses.includes(event.change.status) || !digest.test(event.stateHash) || !digest.test(event.hash))
+        throw invalid();
+    try {
+        const { hash: expected, ...body } = event;
+        if (hash(JSON.stringify(body)) !== expected)
+            throw invalid();
+    }
+    catch {
+        throw invalid();
+    }
+    return event;
+}
+export function makeEvent(sessionId, previous, next, parent, id = randomUUID(), at = new Date().toISOString()) {
+    validateMessages(next.messages);
+    let keep = 0;
+    if (previous && parent)
+        while (keep < Math.min(previous.messages.length, next.messages.length) &&
+            JSON.stringify(previous.messages[keep]) === JSON.stringify(next.messages[keep]))
+            keep++;
+    const body = { version: 1, id, sessionId, at, parent,
+        change: { keep, append: next.messages.slice(keep), status: next.status, droppedMessages: next.droppedMessages }, stateHash: stateHash(next) };
+    return validateEvent(JSON.parse(JSON.stringify({ ...body, hash: hash(JSON.stringify(body)) })), sessionId);
+}
+function historyDir(dir, create = false) {
+    assertSessionDirectory(dir);
+    const target = join(dir, 'events');
+    if (create && !fs.existsSync(target))
+        fs.mkdirSync(target, { mode: 0o700 });
+    if (!fs.lstatSync(target).isDirectory() || fs.lstatSync(target).isSymbolicLink())
+        throw invalid();
+    return target;
+}
+export function readSessionEvent(dir, sessionId, id) {
+    if (!uuid.test(id))
+        throw invalid();
+    const raw = readPrivateSessionFile(join(historyDir(dir), `${id}.json`), MAX_SNAPSHOT_BYTES + 4096);
+    if (raw === null)
+        throw invalid();
+    try {
+        const data = JSON.parse(raw);
+        if (!object(data) || typeof data.sessionId !== 'string')
+            throw invalid();
+        const event = validateEvent(data, sessionId ?? data.sessionId);
+        if (event.id !== id)
+            throw invalid();
+        return event;
+    }
+    catch {
+        throw invalid();
+    }
+}
+/** Caller holds messages.lock. Orphans count toward the budget and are never erased. */
+export function appendSessionEvents(dir, events, signal) {
+    throwIfCancelled(signal);
+    const target = historyDir(dir, true);
+    let bytes = 0, count = 0;
+    const entries = fs.opendirSync(target);
+    try {
+        let entry;
+        while ((entry = entries.readSync())) {
+            if (!entry.isFile())
+                throw invalid();
+            count++;
+            bytes += fs.lstatSync(join(target, entry.name)).size;
+            if (count > MAX_HISTORY_EVENTS || bytes > MAX_HISTORY_BYTES)
+                break;
+        }
+    }
+    finally {
+        entries.closeSync();
+    }
+    const records = events.map(event => JSON.stringify(validateEvent(event, event.sessionId)));
+    if (records.some(text => Buffer.byteLength(text) > MAX_SNAPSHOT_BYTES + 4096) || count + records.length > MAX_HISTORY_EVENTS ||
+        bytes + records.reduce((sum, text) => sum + Buffer.byteLength(text), 0) > MAX_HISTORY_BYTES)
+        throw new SessionRecoveryError('io', 'session history budget reached; create /branch or /new to continue while preserving existing history.');
+    for (let index = 0; index < events.length; index++) {
+        throwIfCancelled(signal);
+        const fd = fs.openSync(join(target, `${events[index].id}.json`), 'wx', 0o600);
+        try {
+            fs.writeFileSync(fd, records[index]);
+            fs.fsyncSync(fd);
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+    }
+    const fd = fs.openSync(target, 'r');
+    try {
+        fs.fsyncSync(fd);
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+}
+export function applyEvent(previous, event) {
+    if ((!previous && event.change.keep !== 0) || event.change.keep > (previous?.messages.length ?? 0))
+        throw invalid();
+    const messages = [...(previous?.messages.slice(0, event.change.keep) ?? []), ...event.change.append];
+    validateMessages(messages);
+    const body = { version: 1, sessionId: event.sessionId, revision: event.id, updatedAt: event.at,
+        status: event.change.status, droppedMessages: event.change.droppedMessages, messages, history: eventLink(event) };
+    if (stateHash(body) !== event.stateHash)
+        throw invalid();
+    return { ...body, checksum: hash(JSON.stringify(body)) };
+}
+/** Pure deterministic projection; yields so cancellation can interrupt large histories. */
+export async function replayEvents(events, head, sessionId, signal) {
+    if (!events.length || events.length > MAX_HISTORY_EVENTS)
+        throw invalid();
+    const byId = new Map();
+    let bytes = 0;
+    for (const event of events) {
+        throwIfCancelled(signal);
+        if (!object(event))
+            throw invalid();
+        validateEvent(event, event.sessionId);
+        bytes += Buffer.byteLength(JSON.stringify(event));
+        if (byId.has(event.id) || bytes > MAX_HISTORY_BYTES)
+            throw invalid();
+        byId.set(event.id, event);
+        if (byId.size % 32 === 0)
+            await new Promise(resolve => setImmediate(resolve));
+    }
+    const chain = [], seen = new Set();
+    let current = head;
+    while (current) {
+        throwIfCancelled(signal);
+        const event = byId.get(current.id);
+        if (!event || event.sessionId !== current.sessionId || event.hash !== current.hash || seen.has(event.id))
+            throw invalid();
+        seen.add(event.id);
+        chain.push(event);
+        current = event.parent;
+    }
+    chain.reverse();
+    let snapshot = null;
+    for (let index = 0; index < chain.length; index++) {
+        throwIfCancelled(signal);
+        snapshot = applyEvent(snapshot, chain[index]);
+        if (index % 16 === 0)
+            await new Promise(resolve => setImmediate(resolve));
+    }
+    throwIfCancelled(signal);
+    if (snapshot.sessionId !== sessionId) {
+        const { checksum: _checksum, ...body } = snapshot;
+        body.sessionId = sessionId;
+        snapshot = { ...body, checksum: hash(JSON.stringify(body)) };
+    }
+    return { snapshot: snapshot, events: chain };
+}
+export async function replaySessionHistory(dir, sessionId, head, signal) {
+    const events = [], seen = new Set();
+    let current = head, bytes = 0;
+    while (current) {
+        throwIfCancelled(signal);
+        if (seen.has(current.id) || events.length >= MAX_HISTORY_EVENTS)
+            throw invalid();
+        const event = readSessionEvent(dir, current.sessionId, current.id);
+        if (event.hash !== current.hash)
+            throw invalid();
+        bytes += Buffer.byteLength(JSON.stringify(event));
+        if (bytes > MAX_HISTORY_BYTES)
+            throw invalid();
+        events.push(event);
+        seen.add(event.id);
+        current = event.parent;
+        if (events.length % 16 === 0)
+            await new Promise(resolve => setImmediate(resolve));
+    }
+    return replayEvents(events, head, sessionId, signal);
+}
+//# sourceMappingURL=history.js.map

package/dist/sessions/history.js.map

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

package/dist/sessions/index.d.ts

@@ -0,0 +1,8 @@
+export * from './format.js';
+export * from './snapshot.js';
+export * from './context.js';
+export * from './history.js';
+export * from './tool-state.js';
+export * from './portable.js';
+export * from './output.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/sessions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sessions/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/sessions/index.js

@@ -0,0 +1,8 @@
+export * from './format.js';
+export * from './snapshot.js';
+export * from './context.js';
+export * from './history.js';
+export * from './tool-state.js';
+export * from './portable.js';
+export * from './output.js';
+//# sourceMappingURL=index.js.map

package/dist/sessions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sessions/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/sessions/output.d.ts

@@ -0,0 +1,31 @@
+export declare const MAX_TOOL_OUTPUT_CHARS = 65536;
+export declare const MAX_TOOL_OUTPUTS = 100;
+export declare const MAX_TOOL_OUTPUT_BYTES: number;
+export interface ToolOutputRecord {
+    version: 1;
+    id: string;
+    toolCallId: string;
+    tool: string;
+    channel: 'tool' | 'thinking';
+    content: string;
+    sourceChars: number;
+    truncated: boolean;
+    isError: boolean;
+    createdAt: string;
+    hash: string;
+}
+export interface CapturedToolOutput {
+    record: ToolOutputRecord;
+    saved: boolean;
+}
+export interface ToolOutputSnapshot {
+    version: 1;
+    dropped: number;
+    records: ToolOutputRecord[];
+    checksum: string;
+}
+export declare function makeToolOutput(toolCallId: string, tool: string, text: string, isError: boolean): ToolOutputRecord;
+export declare function validateToolOutputSnapshot(value: unknown): ToolOutputSnapshot;
+export declare function readToolOutputs(dir: string): ToolOutputSnapshot;
+export declare function saveToolOutput(dir: string, record: ToolOutputRecord, signal?: AbortSignal): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/sessions/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/sessions/output.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAC3C,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,qBAAqB,QAAkB,CAAC;AACrD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,CAAC,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC;IACvF,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;CAC7G;AACD,MAAM,WAAW,kBAAkB;IAAG,MAAM,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE;AAChF,MAAM,WAAW,kBAAkB;IAAG,OAAO,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AAIlH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAOjH;AAID,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAgB7E;AAKD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAE/D;AACD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CA4BhG"}