@windagency/valora 2.0.1

package/dist/session/session-exporter.js

@@ -0,0 +1,274 @@
+/**
+ * Session export/import functionality with ZIP archives
+ *
+ */
+import * as crypto from 'crypto';
+import * as fs from 'fs/promises';
+import { getLogger } from '../output/logger.js';
+import * as path from 'path';
+import { SessionError } from '../utils/error-handler.js';
+export class SessionExporter {
+    sessionStore;
+    archiveAdapter;
+    constructor(sessionStore, archiveAdapter) {
+        this.sessionStore = sessionStore;
+        this.archiveAdapter = archiveAdapter;
+    }
+    /**
+     * Export a session as a ZIP archive
+     */
+    async exportSession(sessionId, options = {}) {
+        const logger = getLogger();
+        const includeArtifacts = options.includeArtifacts ?? true;
+        try {
+            // Load session
+            const session = await this.sessionStore.loadSession(sessionId);
+            // Determine output path
+            const outputPath = options.outputPath ?? path.join(process.cwd(), `session-${sessionId}-${Date.now()}.zip`);
+            // Prepare archive entries
+            const entries = [];
+            const checksums = {};
+            // Add session.json
+            const sessionJson = JSON.stringify(session, null, 2);
+            entries.push({ content: sessionJson, name: 'session.json' });
+            checksums['session.json'] = this.calculateChecksum(sessionJson);
+            // Add artifacts if they exist and includeArtifacts is true
+            if (includeArtifacts) {
+                const sessionDir = path.join(this.sessionStore.getSessionsDir(), sessionId);
+                try {
+                    const stats = await fs.stat(sessionDir);
+                    if (stats.isDirectory()) {
+                        const files = await fs.readdir(sessionDir);
+                        // Process artifacts
+                        await Promise.all(files
+                            .filter((file) => !file.endsWith('.json')) // Skip session.json
+                            .map(async (file) => {
+                            const filePath = path.join(sessionDir, file);
+                            try {
+                                const fileStats = await fs.stat(filePath);
+                                if (fileStats.isFile()) {
+                                    const content = await fs.readFile(filePath);
+                                    entries.push({ content, name: `artifacts/${file}` });
+                                    checksums[`artifacts/${file}`] = this.calculateChecksum(content.toString());
+                                }
+                            }
+                            catch (error) {
+                                logger.warn(`Failed to read artifact ${file}`, { error, sessionId });
+                            }
+                        }));
+                    }
+                }
+                catch {
+                    // Session directory doesn't exist - that's okay
+                    logger.debug('No artifacts directory found for session', { sessionId });
+                }
+            }
+            // Add metadata
+            const metadata = {
+                checksums,
+                exportedAt: new Date().toISOString(),
+                sessionId: session.session_id,
+                version: '1.0.0'
+            };
+            entries.push({ content: JSON.stringify(metadata, null, 2), name: 'metadata.json' });
+            // Create archive using adapter
+            const result = await this.archiveAdapter.createArchive(outputPath, entries, { compressionLevel: 9 });
+            logger.info('Session exported successfully', {
+                outputPath: result.outputPath,
+                sessionId,
+                size: result.size
+            });
+            return result.outputPath;
+        }
+        catch (error) {
+            logger.error('Failed to export session', error, { sessionId });
+            throw new SessionError(`Failed to export session: ${error.message}`, {
+                error: error.message,
+                sessionId
+            });
+        }
+    }
+    /**
+     * Read and parse metadata from extracted archive
+     */
+    async readMetadata(tempDir) {
+        const logger = getLogger();
+        const metadataPath = path.join(tempDir, 'metadata.json');
+        try {
+            const metadataContent = await fs.readFile(metadataPath, 'utf-8');
+            return JSON.parse(metadataContent);
+        }
+        catch {
+            logger.warn('No metadata found in archive, proceeding without validation');
+            return null;
+        }
+    }
+    /**
+     * Read and verify session data
+     */
+    async readAndVerifySession(tempDir, metadata) {
+        const sessionPath = path.join(tempDir, 'session.json');
+        const sessionContent = await fs.readFile(sessionPath, 'utf-8');
+        const session = JSON.parse(sessionContent);
+        // Verify checksum if metadata exists
+        if (metadata?.checksums?.['session.json']) {
+            const actualChecksum = this.calculateChecksum(sessionContent);
+            if (actualChecksum !== metadata.checksums['session.json']) {
+                throw new SessionError('Session file checksum mismatch - file may be corrupted');
+            }
+        }
+        return session;
+    }
+    /**
+     * Import artifacts from extracted archive
+     */
+    async importArtifacts(tempDir, targetSessionId, metadata) {
+        const logger = getLogger();
+        const artifactsDir = path.join(tempDir, 'artifacts');
+        try {
+            const stats = await fs.stat(artifactsDir);
+            if (!stats.isDirectory()) {
+                return;
+            }
+            const targetArtifactsDir = path.join(this.sessionStore.getSessionsDir(), targetSessionId);
+            await fs.mkdir(targetArtifactsDir, { recursive: true });
+            const files = await fs.readdir(artifactsDir);
+            // Process and verify artifacts using functional pattern
+            await Promise.all(files.map(async (file) => {
+                const sourcePath = path.join(artifactsDir, file);
+                const targetPath = path.join(targetArtifactsDir, file);
+                // Verify checksum if metadata exists
+                if (metadata?.checksums?.[`artifacts/${file}`]) {
+                    const content = await fs.readFile(sourcePath, 'utf-8');
+                    const actualChecksum = this.calculateChecksum(content);
+                    if (actualChecksum !== metadata.checksums[`artifacts/${file}`]) {
+                        logger.warn(`Artifact ${file} checksum mismatch, skipping`, {
+                            file,
+                            sessionId: targetSessionId
+                        });
+                        return; // Skip this file
+                    }
+                }
+                await fs.copyFile(sourcePath, targetPath);
+            }));
+            logger.debug('Artifacts imported', {
+                count: files.length,
+                sessionId: targetSessionId
+            });
+        }
+        catch {
+            // No artifacts directory - that's okay
+            logger.debug('No artifacts found in archive', { sessionId: targetSessionId });
+        }
+    }
+    /**
+     * Import a session from a ZIP archive
+     */
+    async importSession(zipPath, options = {}) {
+        const logger = getLogger();
+        try {
+            // Verify file exists
+            await fs.access(zipPath);
+            // Create temporary extraction directory
+            const tempDir = path.join(this.sessionStore.getSessionsDir(), '.temp-import-' + Date.now());
+            await fs.mkdir(tempDir, { recursive: true });
+            try {
+                // Extract ZIP using adapter
+                await this.archiveAdapter.extractArchive(zipPath, tempDir);
+                // Read metadata
+                const metadata = await this.readMetadata(tempDir);
+                // Read and verify session
+                const session = await this.readAndVerifySession(tempDir, metadata);
+                // Determine target session ID
+                const targetSessionId = options.targetSessionId ?? session.session_id;
+                // Check if session already exists
+                const exists = await this.sessionStore.sessionExists(targetSessionId);
+                if (exists && !options.overwrite) {
+                    throw new SessionError(`Session ${targetSessionId} already exists. Use --overwrite to replace it.`, {
+                        sessionId: targetSessionId
+                    });
+                }
+                // Update session ID if different
+                if (targetSessionId !== session.session_id) {
+                    session.session_id = targetSessionId;
+                }
+                // Save session
+                await this.sessionStore.saveSession(session);
+                // Import artifacts if they exist
+                await this.importArtifacts(tempDir, targetSessionId, metadata);
+                logger.info('Session imported successfully', {
+                    sessionId: targetSessionId,
+                    sourcePath: zipPath
+                });
+                return session;
+            }
+            finally {
+                // Clean up temp directory
+                await fs.rm(tempDir, { force: true, recursive: true });
+            }
+        }
+        catch (error) {
+            logger.error('Failed to import session', error, { zipPath });
+            throw new SessionError(`Failed to import session: ${error.message}`, {
+                error: error.message,
+                zipPath
+            });
+        }
+    }
+    /**
+     * Calculate SHA-256 checksum of content
+     */
+    calculateChecksum(content) {
+        return crypto.createHash('sha256').update(content).digest('hex');
+    }
+    /**
+     * Get export statistics
+     */
+    async getExportStats(zipPath) {
+        try {
+            const stats = await fs.stat(zipPath);
+            // Create temporary extraction directory
+            const tempDir = path.join(this.sessionStore.getSessionsDir(), '.temp-stats-' + Date.now());
+            await fs.mkdir(tempDir, { recursive: true });
+            try {
+                // Extract using adapter
+                await this.archiveAdapter.extractArchive(zipPath, tempDir);
+                // Read metadata
+                const metadataPath = path.join(tempDir, 'metadata.json');
+                const metadataContent = await fs.readFile(metadataPath, 'utf-8');
+                const metadata = JSON.parse(metadataContent);
+                // Read session
+                const sessionPath = path.join(tempDir, 'session.json');
+                const sessionContent = await fs.readFile(sessionPath, 'utf-8');
+                const session = JSON.parse(sessionContent);
+                // Count artifacts
+                let artifactCount = 0;
+                const artifactsDir = path.join(tempDir, 'artifacts');
+                try {
+                    const files = await fs.readdir(artifactsDir);
+                    artifactCount = files.length;
+                }
+                catch {
+                    // No artifacts
+                }
+                return {
+                    artifactCount,
+                    commandCount: session.commands.length,
+                    exportedAt: metadata.exportedAt,
+                    sessionId: metadata.sessionId,
+                    size: stats.size
+                };
+            }
+            finally {
+                await fs.rm(tempDir, { force: true, recursive: true });
+            }
+        }
+        catch (error) {
+            throw new SessionError(`Failed to get export stats: ${error.message}`, {
+                error: error.message,
+                zipPath
+            });
+        }
+    }
+}
+//# sourceMappingURL=session-exporter.js.map

package/dist/session/session-exporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-exporter.js","sourceRoot":"","sources":["../../src/session/session-exporter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAsBnD,MAAM,OAAO,eAAe;IAElB;IACA;IAFT,YACS,YAA0B,EAC1B,cAA8B;QAD9B,iBAAY,GAAZ,YAAY,CAAc;QAC1B,mBAAc,GAAd,cAAc,CAAgB;IACpC,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,SAAiB,EAAE,UAAyB,EAAE;QACjE,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,IAAI,CAAC;QAE1D,IAAI,CAAC;YACJ,eAAe;YACf,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;YAE/D,wBAAwB;YACxB,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAE5G,0BAA0B;YAC1B,MAAM,OAAO,GAAmB,EAAE,CAAC;YACnC,MAAM,SAAS,GAA2B,EAAE,CAAC;YAE7C,mBAAmB;YACnB,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACrD,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;YAC7D,SAAS,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;YAEhE,2DAA2D;YAC3D,IAAI,gBAAgB,EAAE,CAAC;gBACtB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,cAAc,EAAE,EAAE,SAAS,CAAC,CAAC;gBAC5E,IAAI,CAAC;oBACJ,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;oBACxC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;wBACzB,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;wBAE3C,oBAAoB;wBACpB,MAAM,OAAO,CAAC,GAAG,CAChB,KAAK;6BACH,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,oBAAoB;6BAC9D,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;4BACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;4BAC7C,IAAI,CAAC;gCACJ,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gCAC1C,IAAI,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;oCACxB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;oCAC5C,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,IAAI,EAAE,EAAE,CAAC,CAAC;oCACrD,SAAS,CAAC,aAAa,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;gCAC7E,CAAC;4BACF,CAAC;4BAAC,OAAO,KAAK,EAAE,CAAC;gCAChB,MAAM,CAAC,IAAI,CAAC,2BAA2B,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;4BACtE,CAAC;wBACF,CAAC,CAAC,CACH,CAAC;oBACH,CAAC;gBACF,CAAC;gBAAC,MAAM,CAAC;oBACR,gDAAgD;oBAChD,MAAM,CAAC,KAAK,CAAC,0CAA0C,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;gBACzE,CAAC;YACF,CAAC;YAED,eAAe;YACf,MAAM,QAAQ,GAAmB;gBAChC,SAAS;gBACT,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACpC,SAAS,EAAE,OAAO,CAAC,UAAU;gBAC7B,OAAO,EAAE,OAAO;aAChB,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;YAEpF,+BAA+B;YAC/B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,gBAAgB,EAAE,CAAC,EAAE,CAAC,CAAC;YAErG,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE;gBAC5C,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,SAAS;gBACT,IAAI,EAAE,MAAM,CAAC,IAAI;aACjB,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC,UAAU,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAc,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;YACxE,MAAM,IAAI,YAAY,CAAC,6BAA8B,KAAe,CAAC,OAAO,EAAE,EAAE;gBAC/E,KAAK,EAAG,KAAe,CAAC,OAAO;gBAC/B,SAAS;aACT,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY,CAAC,OAAe;QACzC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QAEzD,IAAI,CAAC;YACJ,MAAM,eAAe,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACjE,OAAO,IAAI,CAAC,KAAK,CAAC,eAAe,CAAmB,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACR,MAAM,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;YAC3E,OAAO,IAAI,CAAC;QACb,CAAC;IACF,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,oBAAoB,CAAC,OAAe,EAAE,QAA+B;QAClF,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QACvD,MAAM,cAAc,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAY,CAAC;QAEtD,qCAAqC;QACrC,IAAI,QAAQ,EAAE,SAAS,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC;YAC3C,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;YAC9D,IAAI,cAAc,KAAK,QAAQ,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,CAAC;gBAC3D,MAAM,IAAI,YAAY,CAAC,wDAAwD,CAAC,CAAC;YAClF,CAAC;QACF,CAAC;QAED,OAAO,OAAO,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe,CAC5B,OAAe,EACf,eAAuB,EACvB,QAA+B;QAE/B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAErD,IAAI,CAAC;YACJ,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC1C,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC1B,OAAO;YACR,CAAC;YAED,MAAM,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,cAAc,EAAE,EAAE,eAAe,CAAC,CAAC;YAC1F,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAkB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAExD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YAE7C,wDAAwD;YACxD,MAAM,OAAO,CAAC,GAAG,CAChB,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;gBACxB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;gBACjD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;gBAEvD,qCAAqC;gBACrC,IAAI,QAAQ,EAAE,SAAS,EAAE,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE,CAAC;oBAChD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;oBACvD,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;oBACvD,IAAI,cAAc,KAAK,QAAQ,CAAC,SAAS,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE,CAAC;wBAChE,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,8BAA8B,EAAE;4BAC3D,IAAI;4BACJ,SAAS,EAAE,eAAe;yBAC1B,CAAC,CAAC;wBACH,OAAO,CAAC,iBAAiB;oBAC1B,CAAC;gBACF,CAAC;gBAED,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YAC3C,CAAC,CAAC,CACF,CAAC;YAEF,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE;gBAClC,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,SAAS,EAAE,eAAe;aAC1B,CAAC,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACR,uCAAuC;YACvC,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC,CAAC;QAC/E,CAAC;IACF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,OAAe,EAAE,UAAyB,EAAE;QAC/D,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAE3B,IAAI,CAAC;YACJ,qBAAqB;YACrB,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAEzB,wCAAwC;YACxC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,cAAc,EAAE,EAAE,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YAC5F,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAE7C,IAAI,CAAC;gBACJ,4BAA4B;gBAC5B,MAAM,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAE3D,gBAAgB;gBAChB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;gBAElD,0BAA0B;gBAC1B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;gBAEnE,8BAA8B;gBAC9B,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,UAAU,CAAC;gBAEtE,kCAAkC;gBAClC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;gBACtE,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;oBAClC,MAAM,IAAI,YAAY,CAAC,WAAW,eAAe,iDAAiD,EAAE;wBACnG,SAAS,EAAE,eAAe;qBAC1B,CAAC,CAAC;gBACJ,CAAC;gBAED,iCAAiC;gBACjC,IAAI,eAAe,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC;oBAC5C,OAAO,CAAC,UAAU,GAAG,eAAe,CAAC;gBACtC,CAAC;gBAED,eAAe;gBACf,MAAM,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;gBAE7C,iCAAiC;gBACjC,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC;gBAE/D,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE;oBAC5C,SAAS,EAAE,eAAe;oBAC1B,UAAU,EAAE,OAAO;iBACnB,CAAC,CAAC;gBAEH,OAAO,OAAO,CAAC;YAChB,CAAC;oBAAS,CAAC;gBACV,0BAA0B;gBAC1B,MAAM,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,CAAC;QACF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAc,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;YACtE,MAAM,IAAI,YAAY,CAAC,6BAA8B,KAAe,CAAC,OAAO,EAAE,EAAE;gBAC/E,KAAK,EAAG,KAAe,CAAC,OAAO;gBAC/B,OAAO;aACP,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,OAAe;QACxC,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,OAAe;QAOnC,IAAI,CAAC;YACJ,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAErC,wCAAwC;YACxC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,cAAc,EAAE,EAAE,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YAC3F,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAE7C,IAAI,CAAC;gBACJ,wBAAwB;gBACxB,MAAM,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAE3D,gBAAgB;gBAChB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;gBACzD,MAAM,eAAe,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;gBACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAmB,CAAC;gBAE/D,eAAe;gBACf,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;gBACvD,MAAM,cAAc,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;gBAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAY,CAAC;gBAEtD,kBAAkB;gBAClB,IAAI,aAAa,GAAG,CAAC,CAAC;gBACtB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;gBACrD,IAAI,CAAC;oBACJ,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;oBAC7C,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC;gBAC9B,CAAC;gBAAC,MAAM,CAAC;oBACR,eAAe;gBAChB,CAAC;gBAED,OAAO;oBACN,aAAa;oBACb,YAAY,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM;oBACrC,UAAU,EAAE,QAAQ,CAAC,UAAU;oBAC/B,SAAS,EAAE,QAAQ,CAAC,SAAS;oBAC7B,IAAI,EAAE,KAAK,CAAC,IAAI;iBAChB,CAAC;YACH,CAAC;oBAAS,CAAC;gBACV,MAAM,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,CAAC;QACF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,YAAY,CAAC,+BAAgC,KAAe,CAAC,OAAO,EAAE,EAAE;gBACjF,KAAK,EAAG,KAAe,CAAC,OAAO;gBAC/B,OAAO;aACP,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;CACD"}

package/dist/session/store.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Session store - file-based persistence
+ */
+import type { Session, SessionCommand, SessionSummary } from '../types/session.types.js';
+import type { SessionCleanupScheduler } from './cleanup-scheduler.js';
+/**
+ * Session Snapshot - lightweight version of session for fast resume
+ * Contains only essential data needed to quickly restore session state
+ */
+export interface SessionSnapshot {
+    created_at: string;
+    last_command?: string;
+    session_id: string;
+    status: Session['status'];
+    total_tokens_used?: number;
+    updated_at: string;
+    /** Last N commands for quick context */
+    recent_commands: SessionCommand[];
+    /** Essential context keys for optimization */
+    essential_context: {
+        _loaderCache?: unknown;
+        _stageOutputs?: unknown;
+    };
+    /** Snapshot metadata */
+    full_command_count: number;
+    snapshot_version: number;
+}
+/**
+ * Session Store - File-based session persistence with automatic cleanup
+ *
+ * IMPORTANT: Background cleanup is managed by the unified cleanup coordinator.
+ * The coordinator initializes both log and session cleanup schedulers together.
+ * The scheduler will:
+ * - Run every N hours (configured in config.json: cleanup_interval_hours)
+ * - Compress sessions older than compress_after_days
+ * - Delete sessions older than max_age_days
+ * - Enforce max_count and max_size_mb limits
+ *
+ * To disable automatic cleanup:
+ * - Set NODE_ENV=test or AI_TEST_MODE=true environment variables
+ * - Set sessions.enabled=false in config.json
+ * - MCP mode automatically disables cleanup
+ *
+ * See: documentation/architecture/session-optimization.md for full documentation
+ * See: cleanup/coordinator.ts for unified scheduler initialization
+ */
+export declare class SessionStore {
+    private initialized;
+    private sessionsDir;
+    constructor(sessionsDir?: string);
+    /**
+     * Defer initialization to prevent race conditions
+     */
+    private deferInitialize;
+    /**
+     * Initialize session store
+     *
+     * Note: Cleanup scheduler is initialized separately via cleanup/coordinator.ts
+     */
+    private initialize;
+    /**
+     * Create a new session
+     */
+    createSession(sessionId?: string): Promise<Session>;
+    /**
+     * Load a session by ID
+     */
+    loadSession(sessionId: string): Promise<Session>;
+    /**
+     * Save a session
+     */
+    saveSession(session: Session): Promise<void>;
+    /**
+     * Delete a session
+     */
+    deleteSession(sessionId: string): Promise<void>;
+    /**
+     * List all sessions
+     */
+    listSessions(): Promise<SessionSummary[]>;
+    /**
+     * Check if a session exists
+     */
+    sessionExists(sessionId: string): Promise<boolean>;
+    /**
+     * Get the most recent session
+     */
+    getRecentSession(): Promise<null | Session>;
+    /**
+     * Archive old sessions
+     */
+    archiveSessions(beforeDate: Date): Promise<number>;
+    /**
+     * Clean up completed sessions older than specified days
+     */
+    cleanupOldSessions(daysOld?: number): Promise<number>;
+    /**
+     * Get session file path
+     */
+    private getSessionPath;
+    /**
+     * Get snapshot file path
+     */
+    private getSnapshotPath;
+    /**
+     * Get sessions directory
+     */
+    getSessionsDir(): string;
+    /**
+     * Get the session cleanup scheduler instance
+     * Note: Scheduler is now initialized via cleanup/coordinator.ts
+     */
+    getCleanupScheduler(): null | SessionCleanupScheduler;
+    /**
+     * Create a snapshot from a full session
+     * Snapshots contain lightweight data for fast resume
+     */
+    private createSnapshot;
+    /**
+     * Save a session snapshot for fast resume
+     */
+    saveSnapshot(session: Session): Promise<void>;
+    /**
+     * Load a session snapshot (fast resume)
+     * Returns null if snapshot doesn't exist or is invalid
+     */
+    loadSnapshot(sessionId: string): Promise<null | SessionSnapshot>;
+    /**
+     * Check if a snapshot is sufficient for the current operation
+     * Snapshots are sufficient for quick context access, but not for full history
+     */
+    isSnapshotSufficient(snapshot: SessionSnapshot, needsFullHistory: boolean): boolean;
+    /**
+     * Delete a session snapshot
+     */
+    deleteSnapshot(sessionId: string): Promise<void>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/session/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/session/store.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAYnF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAEnE;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,8CAA8C;IAC9C,iBAAiB,EAAE;QAClB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,aAAa,CAAC,EAAE,OAAO,CAAC;KACxB,CAAC;IACF,wBAAwB;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;CACzB;AAOD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,YAAY;IACxB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,CAAC,EAAE,MAAM;IAMhC;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACG,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBzD;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkDtD;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAmDlD;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBrD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAmD/C;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYxD;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC;IAWjD;;OAEG;IACG,eAAe,CAAC,UAAU,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBxD;;OAEG;IACG,kBAAkB,CAAC,OAAO,SAAuB,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBzE;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;;OAGG;IACH,mBAAmB,IAAI,IAAI,GAAG,uBAAuB;IAKrD;;;OAGG;IACH,OAAO,CAAC,cAAc;IA2BtB;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBnD;;;OAGG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,eAAe,CAAC;IA8BtE;;;OAGG;IACH,oBAAoB,CAAC,QAAQ,EAAE,eAAe,EAAE,gBAAgB,EAAE,OAAO,GAAG,OAAO;IAUnF;;OAEG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAUtD"}