attocode 0.2.4 → 0.2.5

package/dist/src/integrations/persistence/persistence.js

@@ -0,0 +1,197 @@
+/**
+ * Persistence Utilities
+ *
+ * Debug logging and checkpoint management for session persistence.
+ */
+import { logger } from '../utilities/logger.js';
+// =============================================================================
+// DEBUG LOGGER FOR PERSISTENCE OPERATIONS
+// =============================================================================
+/**
+ * Debug logger for persistence operations.
+ * Enabled via --debug flag. Shows data flow at each layer boundary.
+ * In TUI mode, logs are buffered instead of printed to avoid interfering with Ink.
+ */
+export class PersistenceDebugger {
+    enabled = false;
+    tuiMode = false;
+    buffer = [];
+    enable() {
+        this.enabled = true;
+        this.log('Persistence debug mode ENABLED');
+    }
+    enableTUIMode() {
+        this.tuiMode = true;
+    }
+    isEnabled() {
+        return this.enabled;
+    }
+    getBuffer() {
+        const logs = [...this.buffer];
+        this.buffer = [];
+        return logs;
+    }
+    log(message, data) {
+        if (!this.enabled)
+            return;
+        const timestamp = new Date().toISOString().split('T')[1].slice(0, 12);
+        const logLine = `[${timestamp}] ${message}`;
+        const dataLine = data !== undefined ? `    -> ${JSON.stringify(data, null, 2).split('\n').join('\n    ')}` : '';
+        if (this.tuiMode) {
+            // Buffer logs in TUI mode to avoid console interference
+            this.buffer.push(logLine);
+            if (dataLine)
+                this.buffer.push(dataLine);
+        }
+        else {
+            logger.debug(logLine);
+            if (dataLine)
+                logger.debug(dataLine);
+        }
+    }
+    error(message, err) {
+        if (!this.enabled)
+            return;
+        const timestamp = new Date().toISOString().split('T')[1].slice(0, 12);
+        const errLine = `[${timestamp}] ERROR: ${message}`;
+        let details = '';
+        if (err instanceof Error) {
+            details = `    -> ${err.message}`;
+            if (err.stack) {
+                details += `\n    -> Stack: ${err.stack.split('\n').slice(1, 3).join(' -> ')}`;
+            }
+        }
+        else {
+            details = `    -> ${String(err)}`;
+        }
+        if (this.tuiMode) {
+            this.buffer.push(errLine);
+            this.buffer.push(details);
+        }
+        else {
+            logger.error(errLine);
+            logger.error(details);
+        }
+    }
+    storeType(store) {
+        if ('saveCheckpoint' in store && typeof store.saveCheckpoint === 'function') {
+            return 'SQLiteStore';
+        }
+        return 'JSONLStore';
+    }
+}
+// Global debug instance - enabled via --debug flag
+export const persistenceDebug = new PersistenceDebugger();
+/**
+ * Save checkpoint to session store (works with both SQLite and JSONL).
+ * Now includes plan and memoryContext for full state restoration.
+ */
+export function saveCheckpointToStore(store, checkpoint) {
+    const storeType = persistenceDebug.storeType(store);
+    persistenceDebug.log(`saveCheckpointToStore called`, {
+        storeType,
+        checkpointId: checkpoint.id,
+        messageCount: checkpoint.messages?.length ?? 0,
+        hasLabel: !!checkpoint.label,
+        hasPlan: !!checkpoint.plan,
+    });
+    try {
+        if ('saveCheckpoint' in store && typeof store.saveCheckpoint === 'function') {
+            // SQLite store - check currentSessionId
+            const sqliteStore = store;
+            const currentSessionId = sqliteStore.getCurrentSessionId();
+            persistenceDebug.log(`SQLite saveCheckpoint`, {
+                currentSessionId,
+                hasCurrentSession: !!currentSessionId,
+            });
+            if (!currentSessionId) {
+                persistenceDebug.error('SQLite store has no currentSessionId!', new Error('No active session'));
+            }
+            const ckptId = store.saveCheckpoint({
+                id: checkpoint.id,
+                label: checkpoint.label,
+                messages: checkpoint.messages,
+                iteration: checkpoint.iteration,
+                metrics: checkpoint.metrics,
+                plan: checkpoint.plan,
+                memoryContext: checkpoint.memoryContext,
+            }, checkpoint.label || `auto-checkpoint-${checkpoint.id}`);
+            persistenceDebug.log(`SQLite checkpoint saved successfully`, { returnedId: ckptId });
+        }
+        else if ('appendEntry' in store && typeof store.appendEntry === 'function') {
+            // JSONL store - use appendEntry with checkpoint type
+            persistenceDebug.log(`JSONL appendEntry (checkpoint type)`);
+            store.appendEntry({
+                type: 'checkpoint',
+                data: {
+                    id: checkpoint.id,
+                    label: checkpoint.label,
+                    messages: checkpoint.messages,
+                    iteration: checkpoint.iteration,
+                    metrics: checkpoint.metrics,
+                    plan: checkpoint.plan,
+                    memoryContext: checkpoint.memoryContext,
+                    createdAt: new Date().toISOString(),
+                },
+            });
+            persistenceDebug.log(`JSONL checkpoint appended successfully`);
+        }
+        else {
+            persistenceDebug.error('No compatible save method found on store', { storeType });
+        }
+    }
+    catch (err) {
+        persistenceDebug.error(`Failed to save checkpoint`, err);
+        // Re-throw in debug mode so the error is visible
+        if (persistenceDebug.isEnabled()) {
+            throw err;
+        }
+    }
+}
+/**
+ * Load session state (checkpoint or messages) for resuming.
+ * Returns checkpoint data if found, or null.
+ */
+export async function loadSessionState(sessionStore, sessionId) {
+    persistenceDebug.log('Loading session state', { sessionId });
+    // Try SQLite's loadLatestCheckpoint first
+    if ('loadLatestCheckpoint' in sessionStore && typeof sessionStore.loadLatestCheckpoint === 'function') {
+        const sqliteCheckpoint = sessionStore.loadLatestCheckpoint(sessionId);
+        if (sqliteCheckpoint?.state) {
+            persistenceDebug.log('Loaded from SQLite checkpoint', {
+                messageCount: sqliteCheckpoint.state.messages?.length,
+            });
+            return sqliteCheckpoint.state;
+        }
+    }
+    // Fall back to entries-based lookup (for JSONL or if SQLite checkpoint not found)
+    try {
+        const entriesResult = sessionStore.loadSession(sessionId);
+        const entries = Array.isArray(entriesResult) ? entriesResult : await entriesResult;
+        // Try to find a checkpoint entry
+        const checkpoint = [...entries].reverse().find(e => e.type === 'checkpoint');
+        if (checkpoint?.data) {
+            persistenceDebug.log('Loaded from entries checkpoint', {
+                messageCount: checkpoint.data.messages?.length,
+            });
+            return checkpoint.data;
+        }
+        // No checkpoint, try to load messages directly from entries
+        const messages = entries
+            .filter((e) => e.type === 'message')
+            .map((e) => e.data);
+        if (messages.length > 0) {
+            persistenceDebug.log('Loaded messages from entries', { count: messages.length });
+            return {
+                id: `loaded-${sessionId}`,
+                messages,
+                iteration: 0,
+            };
+        }
+    }
+    catch (error) {
+        persistenceDebug.error('Failed to load session entries', error);
+    }
+    return null;
+}
+//# sourceMappingURL=persistence.js.map

package/dist/src/integrations/persistence/persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.js","sourceRoot":"","sources":["../../../../src/integrations/persistence/persistence.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAKhD,gFAAgF;AAChF,0CAA0C;AAC1C,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,OAAO,mBAAmB;IACtB,OAAO,GAAG,KAAK,CAAC;IAChB,OAAO,GAAG,KAAK,CAAC;IAChB,MAAM,GAAa,EAAE,CAAC;IAE9B,MAAM;QACJ,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;IAC7C,CAAC;IAED,aAAa;QACX,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,SAAS;QACP,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAC,OAAe,EAAE,IAAc;QACjC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtE,MAAM,OAAO,GAAG,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAEhH,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,wDAAwD;YACxD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC1B,IAAI,QAAQ;gBAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACtB,IAAI,QAAQ;gBAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAY;QACjC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtE,MAAM,OAAO,GAAG,IAAI,SAAS,YAAY,OAAO,EAAE,CAAC;QACnD,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YACzB,OAAO,GAAG,UAAU,GAAG,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;gBACd,OAAO,IAAI,mBAAmB,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACjF,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,UAAU,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACtB,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,SAAS,CAAC,KAAsB;QAC9B,IAAI,gBAAgB,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;YAC5E,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,OAAO,YAAY,CAAC;IACtB,CAAC;CACF;AAED,mDAAmD;AACnD,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,mBAAmB,EAAE,CAAC;AAmB1D;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAsB,EACtB,UAA0B;IAE1B,MAAM,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACpD,gBAAgB,CAAC,GAAG,CAAC,8BAA8B,EAAE;QACnD,SAAS;QACT,YAAY,EAAE,UAAU,CAAC,EAAE;QAC3B,YAAY,EAAE,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;QAC9C,QAAQ,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK;QAC5B,OAAO,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI;KAC3B,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,IAAI,gBAAgB,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;YAC5E,wCAAwC;YACxC,MAAM,WAAW,GAAG,KAAoB,CAAC;YACzC,MAAM,gBAAgB,GAAG,WAAW,CAAC,mBAAmB,EAAE,CAAC;YAC3D,gBAAgB,CAAC,GAAG,CAAC,uBAAuB,EAAE;gBAC5C,gBAAgB;gBAChB,iBAAiB,EAAE,CAAC,CAAC,gBAAgB;aACtC,CAAC,CAAC;YAEH,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACtB,gBAAgB,CAAC,KAAK,CAAC,uCAAuC,EAAE,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;YAClG,CAAC;YAED,MAAM,MAAM,GAAG,KAAK,CAAC,cAAc,CACjC;gBACE,EAAE,EAAE,UAAU,CAAC,EAAE;gBACjB,KAAK,EAAE,UAAU,CAAC,KAAK;gBACvB,QAAQ,EAAE,UAAU,CAAC,QAAQ;gBAC7B,SAAS,EAAE,UAAU,CAAC,SAAS;gBAC/B,OAAO,EAAE,UAAU,CAAC,OAAO;gBAC3B,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,aAAa,EAAE,UAAU,CAAC,aAAa;aACxC,EACD,UAAU,CAAC,KAAK,IAAI,mBAAmB,UAAU,CAAC,EAAE,EAAE,CACvD,CAAC;YACF,gBAAgB,CAAC,GAAG,CAAC,sCAAsC,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;QACvF,CAAC;aAAM,IAAI,aAAa,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;YAC7E,qDAAqD;YACrD,gBAAgB,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;YAC5D,KAAK,CAAC,WAAW,CAAC;gBAChB,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE;oBACJ,EAAE,EAAE,UAAU,CAAC,EAAE;oBACjB,KAAK,EAAE,UAAU,CAAC,KAAK;oBACvB,QAAQ,EAAE,UAAU,CAAC,QAAQ;oBAC7B,SAAS,EAAE,UAAU,CAAC,SAAS;oBAC/B,OAAO,EAAE,UAAU,CAAC,OAAO;oBAC3B,IAAI,EAAE,UAAU,CAAC,IAAI;oBACrB,aAAa,EAAE,UAAU,CAAC,aAAa;oBACvC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC;aACF,CAAC,CAAC;YACH,gBAAgB,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,gBAAgB,CAAC,KAAK,CAAC,0CAA0C,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,gBAAgB,CAAC,KAAK,CAAC,2BAA2B,EAAE,GAAG,CAAC,CAAC;QACzD,iDAAiD;QACjD,IAAI,gBAAgB,CAAC,SAAS,EAAE,EAAE,CAAC;YACjC,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,YAA6B,EAC7B,SAAiB;IAEjB,gBAAgB,CAAC,GAAG,CAAC,uBAAuB,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IAE7D,0CAA0C;IAC1C,IAAI,sBAAsB,IAAI,YAAY,IAAI,OAAO,YAAY,CAAC,oBAAoB,KAAK,UAAU,EAAE,CAAC;QACtG,MAAM,gBAAgB,GAAG,YAAY,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;QACtE,IAAI,gBAAgB,EAAE,KAAK,EAAE,CAAC;YAC5B,gBAAgB,CAAC,GAAG,CAAC,+BAA+B,EAAE;gBACpD,YAAY,EAAG,gBAAgB,CAAC,KAAa,CAAC,QAAQ,EAAE,MAAM;aAC/D,CAAC,CAAC;YACH,OAAO,gBAAgB,CAAC,KAAkC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,kFAAkF;IAClF,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,YAAY,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,aAAa,CAAC;QAEnF,iCAAiC;QACjC,MAAM,UAAU,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;QAC7E,IAAI,UAAU,EAAE,IAAI,EAAE,CAAC;YACrB,gBAAgB,CAAC,GAAG,CAAC,gCAAgC,EAAE;gBACrD,YAAY,EAAG,UAAU,CAAC,IAAY,CAAC,QAAQ,EAAE,MAAM;aACxD,CAAC,CAAC;YACH,OAAO,UAAU,CAAC,IAAsB,CAAC;QAC3C,CAAC;QAED,4DAA4D;QAC5D,MAAM,QAAQ,GAAG,OAAO;aACrB,MAAM,CAAC,CAAC,CAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC;aACrD,GAAG,CAAC,CAAC,CAAoB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAEzC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,gBAAgB,CAAC,GAAG,CAAC,8BAA8B,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YACjF,OAAO;gBACL,EAAE,EAAE,UAAU,SAAS,EAAE;gBACzB,QAAQ;gBACR,SAAS,EAAE,CAAC;aACb,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,gBAAgB,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/integrations/persistence/session-repository.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Session Repository
+ *
+ * Session CRUD operations, entries, checkpoints, cost tracking,
+ * session hierarchy, pending plans, remembered permissions, migration,
+ * and session manifest export.
+ *
+ * Extracted from sqlite-store.ts as part of Phase 3c restructuring.
+ */
+import type { Message, ToolCall } from '../../types.js';
+import type { SessionEntry } from './session-store.js';
+import type { PendingPlan } from '../tasks/pending-plan.js';
+import type { SessionMetadata, SessionManifest, UsageLog, SessionType, SQLiteStoreDeps } from './sqlite-store.js';
+/**
+ * Create a new session.
+ */
+export declare function createSession(deps: SQLiteStoreDeps, name?: string): string;
+/**
+ * Append an entry to the current session.
+ */
+export declare function appendEntry(deps: SQLiteStoreDeps, entry: Omit<SessionEntry, 'timestamp'>): void;
+/**
+ * Append a message to the current session.
+ */
+export declare function appendMessage(deps: SQLiteStoreDeps, message: Message): void;
+/**
+ * Append a tool call to the current session.
+ */
+export declare function appendToolCall(deps: SQLiteStoreDeps, toolCall: ToolCall): void;
+/**
+ * Append a tool result to the current session.
+ */
+export declare function appendToolResult(deps: SQLiteStoreDeps, callId: string, result: unknown): void;
+/**
+ * Append a compaction summary.
+ */
+export declare function appendCompaction(deps: SQLiteStoreDeps, summary: string, compactedCount: number): void;
+/**
+ * Load a session by ID.
+ */
+export declare function loadSession(deps: SQLiteStoreDeps, sessionId: string): SessionEntry[];
+/**
+ * Reconstruct messages from session entries.
+ */
+export declare function loadSessionMessages(deps: SQLiteStoreDeps, sessionId: string): Message[];
+/**
+ * Delete a session.
+ */
+export declare function deleteSession(deps: SQLiteStoreDeps, sessionId: string): void;
+/**
+ * List all sessions.
+ */
+export declare function listSessions(deps: SQLiteStoreDeps): SessionMetadata[];
+/**
+ * Get the most recent session.
+ */
+export declare function getRecentSession(deps: SQLiteStoreDeps): SessionMetadata | null;
+/**
+ * Get session metadata by ID.
+ */
+export declare function getSessionMetadata(deps: SQLiteStoreDeps, sessionId: string): SessionMetadata | undefined;
+/**
+ * Update session metadata.
+ */
+export declare function updateSessionMetadata(deps: SQLiteStoreDeps, sessionId: string, updates: Partial<Pick<SessionMetadata, 'name' | 'summary' | 'tokenCount'>>): void;
+/**
+ * Save a checkpoint for state restoration.
+ */
+export declare function saveCheckpoint(deps: SQLiteStoreDeps, state: Record<string, unknown>, description?: string): string;
+/**
+ * Load the latest checkpoint for a session.
+ */
+export declare function loadLatestCheckpoint(deps: SQLiteStoreDeps, sessionId: string): {
+    id: string;
+    state: Record<string, unknown>;
+    createdAt: string;
+    description?: string;
+} | null;
+/**
+ * Query entries with SQL (advanced usage).
+ */
+export declare function query<T = unknown>(deps: SQLiteStoreDeps, sql: string, params?: unknown[]): T[];
+/**
+ * Get database statistics.
+ */
+export declare function getStats(deps: SQLiteStoreDeps): {
+    sessionCount: number;
+    entryCount: number;
+    toolCallCount: number;
+    checkpointCount: number;
+    dbSizeBytes: number;
+};
+/**
+ * Log API usage for cost tracking.
+ * Inserts a usage log entry and updates session totals atomically.
+ */
+export declare function logUsage(deps: SQLiteStoreDeps, usage: UsageLog): void;
+/**
+ * Get aggregated usage for a session.
+ */
+export declare function getSessionUsage(deps: SQLiteStoreDeps, sessionId: string): {
+    promptTokens: number;
+    completionTokens: number;
+    costUsd: number;
+};
+/**
+ * Create a child session linked to a parent.
+ */
+export declare function createChildSession(deps: SQLiteStoreDeps, parentId: string, name?: string, type?: SessionType): string;
+/**
+ * Get all direct child sessions of a parent.
+ */
+export declare function getChildSessions(deps: SQLiteStoreDeps, parentId: string): SessionMetadata[];
+/**
+ * Get the full session tree starting from a root session.
+ * Uses a recursive CTE to traverse the hierarchy.
+ */
+export declare function getSessionTree(deps: SQLiteStoreDeps, rootId: string): SessionMetadata[];
+/**
+ * Save a pending plan to the database.
+ */
+export declare function savePendingPlan(deps: SQLiteStoreDeps, plan: PendingPlan, sessionId?: string): void;
+/**
+ * Get the pending plan for a session.
+ * Returns the most recent pending plan, or null if none.
+ */
+export declare function getPendingPlan(deps: SQLiteStoreDeps, sessionId?: string): PendingPlan | null;
+/**
+ * Update the status of a pending plan.
+ */
+export declare function updatePlanStatus(deps: SQLiteStoreDeps, planId: string, status: 'approved' | 'rejected' | 'partially_approved'): void;
+/**
+ * Delete a pending plan.
+ */
+export declare function deletePendingPlan(deps: SQLiteStoreDeps, planId: string): void;
+/**
+ * Remember a permission decision.
+ */
+export declare function rememberPermission(deps: SQLiteStoreDeps, toolName: string, decision: 'always' | 'never', pattern?: string): void;
+/**
+ * Get a remembered permission decision.
+ */
+export declare function getRememberedPermission(deps: SQLiteStoreDeps, toolName: string, pattern?: string): {
+    decision: 'always' | 'never';
+    pattern?: string;
+} | undefined;
+/**
+ * List all remembered permission decisions.
+ */
+export declare function listRememberedPermissions(deps: SQLiteStoreDeps): Array<{
+    toolName: string;
+    pattern?: string;
+    decision: 'always' | 'never';
+    createdAt: string;
+}>;
+/**
+ * Remove a remembered permission decision.
+ */
+export declare function forgetPermission(deps: SQLiteStoreDeps, toolName: string, pattern?: string): void;
+/**
+ * Clear all remembered permissions for a tool or all tools.
+ */
+export declare function clearRememberedPermissions(deps: SQLiteStoreDeps, toolName?: string): void;
+/**
+ * Callbacks for manifest export.
+ * These are provided by the SQLiteStore class to bridge to goal/worker repositories.
+ */
+export interface ManifestCallbacks {
+    listGoals(sessionId?: string): Array<{
+        id: string;
+        goalText: string;
+        status: string;
+        priority: number;
+        progressCurrent: number;
+        progressTotal?: number;
+        completedAt?: string;
+    }>;
+    listJunctures(sessionId?: string, limit?: number): Array<{
+        type: string;
+        description: string;
+        outcome?: string;
+        createdAt: string;
+    }>;
+    listWorkerResults(sessionId?: string): Array<{
+        id: string;
+        taskDescription: string;
+        status: string;
+        summary?: string;
+        modelUsed?: string;
+    }>;
+}
+/**
+ * Export a complete session manifest for handoff.
+ * Contains all information needed for another agent/human to pick up the work.
+ */
+export declare function exportSessionManifest(deps: SQLiteStoreDeps, callbacks: ManifestCallbacks, sessionId?: string): SessionManifest | undefined;
+/**
+ * Export session as human-readable markdown.
+ */
+export declare function exportSessionMarkdown(deps: SQLiteStoreDeps, callbacks: ManifestCallbacks, sessionId?: string): string;
+/**
+ * Migrate sessions from JSONL format to SQLite.
+ */
+export declare function migrateFromJSONL(deps: SQLiteStoreDeps, jsonlDir: string): Promise<{
+    migrated: number;
+    failed: number;
+}>;
+/**
+ * Prune old sessions if over limit.
+ */
+export declare function pruneOldSessions(deps: SQLiteStoreDeps): void;
+//# sourceMappingURL=session-repository.d.ts.map

package/dist/src/integrations/persistence/session-repository.d.ts.map

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