@roackb2/heddle 1.3.0 → 1.5.0

package/dist/src/core/chat/engine/sessions/repository/file-chat-session-repository.js

@@ -1,476 +1,205 @@
 /**
  * File-backed chat session repository.
  *
- * Owns file paths, migration, serialization, deserialization, and orphan-file
- * cleanup for chat sessions. Session services should depend on this module
- * rather than embedding file I/O logic themselves.
+ * Owns file paths, serialization, deserialization, and orphan-file cleanup for
+ * chat sessions. Session services should depend on this class rather than
+ * embedding file I/O logic themselves.
  *
  * Current compromise:
- * some older host or test paths may still import repository functions directly.
+ * some older host or test paths still instantiate this repository directly.
  * The intended direction is host -> service -> repository -> files.
  */
 import { existsSync, mkdirSync, readdirSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
 import { basename, dirname, join } from 'node:path';
-import { createChatSession, createInitialMessages } from '../session-record.js';
-export function createFileChatSessionRepository(args) {
-    const { sessionStoragePath } = args;
-    return {
-        list(apiKeyPresent) {
-            return loadChatSessions(sessionStoragePath, apiKeyPresent);
-        },
-        readCatalog() {
-            return readChatSessionCatalog(sessionStoragePath);
-        },
-        read(sessionId, apiKeyPresent) {
-            return readChatSession(sessionStoragePath, sessionId, apiKeyPresent);
-        },
-        migrateLegacy(apiKeyPresent) {
-            return migrateLegacyChatSessions(sessionStoragePath, apiKeyPresent);
-        },
-        save(sessions) {
-            saveChatSessions(sessionStoragePath, sessions);
-        },
-        deriveStoragePaths() {
-            return deriveSessionStoragePaths(sessionStoragePath);
-        },
-    };
-}
-export function loadChatSessions(sessionsPath, apiKeyPresent) {
-    const resolved = loadChatSessionsFromCurrentStorage(sessionsPath, apiKeyPresent);
-    if (resolved.length > 0) {
-        return resolved;
-    }
-    const migrated = migrateLegacyChatSessions(sessionsPath, apiKeyPresent);
-    if (migrated.length > 0) {
-        return migrated;
-    }
-    return [
-        createChatSession({
-            id: 'session-1',
-            name: 'Session 1',
-            apiKeyPresent,
-        }),
-    ];
-}
-export function readChatSessionCatalog(sessionsPath) {
-    const paths = deriveSessionStoragePaths(sessionsPath);
-    const catalog = readCatalog(paths.catalogPath);
-    return catalog?.sessions.sort((left, right) => right.updatedAt.localeCompare(left.updatedAt)) ?? [];
-}
-export function readChatSession(sessionsPath, sessionId, apiKeyPresent) {
-    const paths = deriveSessionStoragePaths(sessionsPath);
-    const catalog = readCatalog(paths.catalogPath);
-    const entry = catalog?.sessions.find((candidate) => candidate.id === sessionId);
-    if (!entry) {
-        return undefined;
-    }
-    return readSessionFile(paths.sessionsDir, entry, apiKeyPresent)[0];
-}
-export function migrateLegacyChatSessions(sessionsPath, apiKeyPresent) {
-    const legacySessions = loadLegacyChatSessions(sessionsPath, apiKeyPresent);
-    if (legacySessions.length === 0) {
-        return [];
-    }
-    saveChatSessions(sessionsPath, legacySessions);
-    return legacySessions.sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
-}
-export function saveChatSessions(sessionsPath, sessions) {
-    mkdirSync(dirname(sessionsPath), { recursive: true });
-    const paths = deriveSessionStoragePaths(sessionsPath);
-    mkdirSync(paths.sessionsDir, { recursive: true });
-    const sorted = dedupeSessionsById(sessions).sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
-    const previousCatalog = readCatalog(paths.catalogPath);
-    const previousSessionBodies = new Map();
-    for (const entry of previousCatalog?.sessions ?? []) {
-        const body = readSessionFileContents(paths.sessionsDir, entry.id);
-        if (body !== undefined) {
-            previousSessionBodies.set(entry.id, body);
+import { ChatSessionRecords } from '../records/index.js';
+import { ChatSessionCodec } from './chat-session-codec.js';
+export class FileChatSessionRepository {
+    sessionStoragePath;
+    storagePaths;
+    constructor(args) {
+        this.sessionStoragePath = args.sessionStoragePath;
+        this.storagePaths = FileChatSessionRepository.deriveStoragePaths(args.sessionStoragePath);
+    }
+    list(apiKeyPresent) {
+        const resolved = this.loadFromCurrentStorage(apiKeyPresent);
+        if (resolved.length > 0) {
+            return resolved;
         }
+        return [
+            ChatSessionRecords.create({
+                id: 'session-1',
+                name: 'Session 1',
+                apiKeyPresent,
+            }),
+        ];
+    }
+    readCatalog() {
+        const catalog = FileChatSessionRepository.readCatalogFile(this.deriveStoragePaths().catalogPath);
+        return catalog?.sessions.sort((left, right) => right.updatedAt.localeCompare(left.updatedAt)) ?? [];
+    }
+    read(sessionId, apiKeyPresent) {
+        const paths = this.deriveStoragePaths();
+        const catalog = FileChatSessionRepository.readCatalogFile(paths.catalogPath);
+        const entry = catalog?.sessions.find((candidate) => candidate.id === sessionId);
+        if (!entry) {
+            return undefined;
+        }
+        return FileChatSessionRepository.readSessionFile(paths.sessionsDir, entry, apiKeyPresent)[0];
     }
-    for (const session of sorted) {
-        writeSessionFileIfChanged(paths.sessionsDir, session, previousSessionBodies.get(session.id));
-    }
-    const catalog = {
-        version: 1,
-        sessions: sorted.map((session) => projectCatalogEntry(session)),
-    };
-    writeCatalogIfChanged(paths.catalogPath, catalog, previousCatalog);
-    removeOrphanedSessionFiles(paths.sessionsDir, catalog.sessions.map((session) => session.id));
-}
-export function deriveSessionStoragePaths(storagePath) {
-    const stateDir = dirname(storagePath);
-    const fileName = basename(storagePath);
-    const catalogSuffix = '.catalog.json';
-    const legacySuffix = '.json';
-    if (fileName.endsWith(catalogSuffix)) {
-        const catalogStem = fileName.slice(0, -catalogSuffix.length);
-        return {
-            // Current layout: preserve the configured catalog path exactly.
-            catalogPath: storagePath,
-            // Legacy fallback: older callers may still look for a flat JSON file.
-            legacyPath: join(stateDir, `${catalogStem}${legacySuffix}`),
-            sessionsDir: join(stateDir, catalogStem),
+    save(sessions) {
+        mkdirSync(dirname(this.sessionStoragePath), { recursive: true });
+        const paths = this.deriveStoragePaths();
+        mkdirSync(paths.sessionsDir, { recursive: true });
+        const sorted = FileChatSessionRepository.dedupeSessionsById(sessions)
+            .sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
+        const previousCatalog = FileChatSessionRepository.readCatalogFile(paths.catalogPath);
+        const previousSessionBodies = new Map();
+        for (const entry of previousCatalog?.sessions ?? []) {
+            const body = FileChatSessionRepository.readSessionFileContents(paths.sessionsDir, entry.id);
+            if (body !== undefined) {
+                previousSessionBodies.set(entry.id, body);
+            }
+        }
+        for (const session of sorted) {
+            FileChatSessionRepository.writeSessionFileIfChanged(paths.sessionsDir, session, previousSessionBodies.get(session.id));
+        }
+        const catalog = {
+            version: 1,
+            sessions: sorted.map((session) => ChatSessionCodec.projectCatalogEntry(session)),
         };
-    }
-    if (fileName.endsWith(legacySuffix)) {
-        const catalogStem = fileName.slice(0, -legacySuffix.length);
+        FileChatSessionRepository.writeCatalogIfChanged(paths.catalogPath, catalog, previousCatalog);
+        FileChatSessionRepository.removeOrphanedSessionFiles(paths.sessionsDir, catalog.sessions.map((session) => session.id));
+    }
+    deriveStoragePaths() {
+        return this.storagePaths;
+    }
+    static deriveStoragePaths(storagePath) {
+        const stateDir = dirname(storagePath);
+        const fileName = basename(storagePath);
+        const catalogSuffix = '.catalog.json';
+        if (fileName.endsWith(catalogSuffix)) {
+            const catalogStem = fileName.slice(0, -catalogSuffix.length);
+            return {
+                // Current layout: preserve the configured catalog path exactly.
+                catalogPath: storagePath,
+                sessionsDir: join(stateDir, catalogStem),
+            };
+        }
         return {
-            // Current layout: upgrade legacy flat JSON paths to sibling catalog files.
-            catalogPath: join(stateDir, `${catalogStem}${catalogSuffix}`),
-            // Legacy fallback: keep reading and migrating from the original flat JSON path.
-            legacyPath: storagePath,
-            sessionsDir: join(stateDir, catalogStem),
+            // Non-standard inputs are explicit catalog paths. Preserve them without
+            // scanning sibling files or trying to upgrade older layouts.
+            catalogPath: storagePath,
+            sessionsDir: join(stateDir, fileName),
         };
     }
-    return {
-        // Non-JSON inputs are already explicit. Preserve them without inventing
-        // extra fallback paths.
-        catalogPath: storagePath,
-        legacyPath: storagePath,
-        sessionsDir: join(stateDir, fileName),
-    };
-}
-function loadChatSessionsFromCurrentStorage(sessionsPath, apiKeyPresent) {
-    const paths = deriveSessionStoragePaths(sessionsPath);
-    return loadSessionsFromCatalog(paths, apiKeyPresent);
-}
-function loadSessionsFromCatalog(paths, apiKeyPresent) {
-    if (!existsSync(paths.catalogPath)) {
-        return [];
+    loadFromCurrentStorage(apiKeyPresent) {
+        return this.loadSessionsFromCatalog(this.deriveStoragePaths(), apiKeyPresent);
     }
-    try {
-        const raw = JSON.parse(readFileSync(paths.catalogPath, 'utf8'));
-        const catalog = parseCatalog(raw);
-        if (!catalog) {
+    loadSessionsFromCatalog(paths, apiKeyPresent) {
+        if (!existsSync(paths.catalogPath)) {
+            return [];
+        }
+        try {
+            const raw = JSON.parse(readFileSync(paths.catalogPath, 'utf8'));
+            const catalog = ChatSessionCodec.parseCatalog(raw);
+            if (!catalog) {
+                return [];
+            }
+            const sessions = catalog.sessions.flatMap((entry) => FileChatSessionRepository.readSessionFile(paths.sessionsDir, entry, apiKeyPresent));
+            return sessions.sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
+        }
+        catch (error) {
+            process.stderr.write(`Failed to load chat session catalog from ${paths.catalogPath}: ${error instanceof Error ? error.message : String(error)}\n`);
             return [];
         }
-        const sessions = catalog.sessions.flatMap((entry) => readSessionFile(paths.sessionsDir, entry, apiKeyPresent));
-        return sessions.sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
-    }
-    catch (error) {
-        process.stderr.write(`Failed to load chat session catalog from ${paths.catalogPath}: ${error instanceof Error ? error.message : String(error)}\n`);
-        return [];
     }
-}
-function loadLegacyChatSessions(sessionsPath, apiKeyPresent) {
-    try {
-        if (!existsSync(sessionsPath)) {
+    static readSessionFile(sessionsDir, entry, apiKeyPresent) {
+        const path = FileChatSessionRepository.sessionFilePath(sessionsDir, entry.id);
+        if (!existsSync(path)) {
             return [];
         }
-        const raw = readFileSync(sessionsPath, 'utf8');
-        const parsed = JSON.parse(raw);
-        if (!Array.isArray(parsed)) {
-            throw new Error('Expected session array');
+        try {
+            const parsed = JSON.parse(readFileSync(path, 'utf8'));
+            return ChatSessionCodec.parseSessionBody(parsed, { entry, apiKeyPresent });
         }
-        return parsed
-            .flatMap((value) => parseSavedSession(value, apiKeyPresent))
-            .sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
-    }
-    catch (error) {
-        process.stderr.write(`Failed to load chat sessions from ${sessionsPath}: ${error instanceof Error ? error.message : String(error)}\n`);
-        return [];
-    }
-}
-function parseCatalog(value) {
-    if (!value || typeof value !== 'object' || Array.isArray(value)) {
-        return undefined;
-    }
-    const candidate = value;
-    if (candidate.version !== 1 || !Array.isArray(candidate.sessions)) {
-        return undefined;
-    }
-    const sessions = candidate.sessions.flatMap(parseCatalogEntry);
-    return { version: 1, sessions };
-}
-function parseCatalogEntry(value) {
-    if (!value || typeof value !== 'object' || Array.isArray(value)) {
-        return [];
-    }
-    const candidate = value;
-    if (typeof candidate.id !== 'string' || typeof candidate.name !== 'string') {
-        return [];
-    }
-    const createdAt = typeof candidate.createdAt === 'string' ? candidate.createdAt : new Date().toISOString();
-    const updatedAt = typeof candidate.updatedAt === 'string' ? candidate.updatedAt : createdAt;
-    return [{
-            id: candidate.id,
-            name: candidate.name,
-            retention: parseRetention(candidate.retention),
-            workspaceId: typeof candidate.workspaceId === 'string' ? candidate.workspaceId : undefined,
-            createdAt,
-            updatedAt,
-            model: typeof candidate.model === 'string' ? candidate.model : undefined,
-            reasoningEffort: candidate.reasoningEffort === 'low' || candidate.reasoningEffort === 'medium' || candidate.reasoningEffort === 'high' || candidate.reasoningEffort === 'ultrahigh' ?
-                candidate.reasoningEffort
-                : undefined,
-            driftEnabled: typeof candidate.driftEnabled === 'boolean' ? candidate.driftEnabled : false,
-            lastContinuePrompt: typeof candidate.lastContinuePrompt === 'string' ? candidate.lastContinuePrompt : undefined,
-            context: isChatContextStats(candidate.context) ? candidate.context : undefined,
-            archives: Array.isArray(candidate.archives) ? candidate.archives.flatMap(parseArchiveRecord) : undefined,
-            lease: parseLease(candidate.lease),
-        }];
-}
-function projectCatalogEntry(session) {
-    return {
-        id: session.id,
-        name: session.name,
-        retention: session.retention,
-        workspaceId: session.workspaceId,
-        createdAt: session.createdAt,
-        updatedAt: session.updatedAt,
-        model: session.model,
-        reasoningEffort: session.reasoningEffort,
-        driftEnabled: session.driftEnabled,
-        lastContinuePrompt: session.lastContinuePrompt,
-        context: session.context,
-        archives: session.archives,
-        lease: session.lease,
-    };
-}
-function readSessionFile(sessionsDir, entry, apiKeyPresent) {
-    const path = sessionFilePath(sessionsDir, entry.id);
-    if (!existsSync(path)) {
-        return [];
-    }
-    try {
-        const parsed = JSON.parse(readFileSync(path, 'utf8'));
-        const payload = readObjectRecord(parsed);
-        if (!payload) {
+        catch (error) {
+            process.stderr.write(`Failed to load chat session file ${path}: ${error instanceof Error ? error.message : String(error)}\n`);
             return [];
         }
-        return [{
-                id: entry.id,
-                name: entry.name,
-                retention: entry.retention,
-                workspaceId: entry.workspaceId,
-                createdAt: entry.createdAt,
-                updatedAt: entry.updatedAt,
-                model: entry.model,
-                reasoningEffort: entry.reasoningEffort,
-                driftEnabled: entry.driftEnabled,
-                lastContinuePrompt: entry.lastContinuePrompt,
-                context: entry.context,
-                archives: entry.archives,
-                lease: entry.lease,
-                history: Array.isArray(payload.history) ? payload.history : [],
-                messages: Array.isArray(payload.messages) && payload.messages.length > 0 ?
-                    payload.messages.filter(isConversationLine)
-                    : createInitialMessages(apiKeyPresent),
-                turns: Array.isArray(payload.turns) ? payload.turns.filter(isTurnSummary) : [],
-            }];
-    }
-    catch (error) {
-        process.stderr.write(`Failed to load chat session file ${path}: ${error instanceof Error ? error.message : String(error)}\n`);
-        return [];
-    }
-}
-function writeSessionFileIfChanged(sessionsDir, session, previousContent) {
-    const path = sessionFilePath(sessionsDir, session.id);
-    const nextContent = serializeSessionBody(session);
-    if (previousContent === nextContent) {
-        return;
     }
-    writeFileSync(path, nextContent);
-}
-function writeCatalogIfChanged(catalogPath, catalog, previousCatalog) {
-    const nextContent = `${JSON.stringify(catalog, null, 2)}\n`;
-    const previousContent = previousCatalog ? `${JSON.stringify(previousCatalog, null, 2)}\n` : undefined;
-    if (previousContent === nextContent) {
-        return;
-    }
-    writeFileSync(catalogPath, nextContent);
-}
-function serializeSessionBody(session) {
-    return `${JSON.stringify({
-        id: session.id,
-        retention: session.retention,
-        workspaceId: session.workspaceId,
-        history: session.history,
-        messages: session.messages,
-        turns: session.turns,
-        archives: session.archives,
-        lease: session.lease,
-    }, null, 2)}\n`;
-}
-function readSessionFileContents(sessionsDir, sessionId) {
-    const path = sessionFilePath(sessionsDir, sessionId);
-    if (!existsSync(path)) {
-        return undefined;
-    }
-    try {
-        return readFileSync(path, 'utf8');
-    }
-    catch {
-        return undefined;
-    }
-}
-function readCatalog(catalogPath) {
-    if (!existsSync(catalogPath)) {
-        return undefined;
-    }
-    try {
-        return parseCatalog(JSON.parse(readFileSync(catalogPath, 'utf8')));
-    }
-    catch {
-        return undefined;
-    }
-}
-function dedupeSessionsById(sessions) {
-    const seen = new Set();
-    const deduped = [];
-    for (const session of sessions) {
-        if (seen.has(session.id)) {
-            continue;
+    static writeSessionFileIfChanged(sessionsDir, session, previousContent) {
+        const path = FileChatSessionRepository.sessionFilePath(sessionsDir, session.id);
+        const nextContent = ChatSessionCodec.serializeSessionBody(session);
+        if (previousContent === nextContent) {
+            return;
         }
-        seen.add(session.id);
-        deduped.push(session);
+        writeFileSync(path, nextContent);
     }
-    return deduped;
-}
-function sessionFilePath(sessionsDir, sessionId) {
-    return join(sessionsDir, `${sessionId}.json`);
-}
-function removeOrphanedSessionFiles(sessionsDir, activeSessionIds) {
-    if (!existsSync(sessionsDir)) {
-        return;
-    }
-    const allowed = new Set(activeSessionIds.map((id) => `${id}.json`));
-    for (const name of safeReadDirFiles(sessionsDir)) {
-        if (allowed.has(name) || !name.endsWith('.json')) {
-            continue;
+    static writeCatalogIfChanged(catalogPath, catalog, previousCatalog) {
+        const nextContent = ChatSessionCodec.serializeCatalog(catalog);
+        const previousContent = previousCatalog ? ChatSessionCodec.serializeCatalog(previousCatalog) : undefined;
+        if (previousContent === nextContent) {
+            return;
         }
-        unlinkSync(join(sessionsDir, name));
-    }
-}
-function safeReadDirFiles(path) {
-    try {
-        return readdirSync(path);
-    }
-    catch {
-        return [];
-    }
-}
-function parseSavedSession(value, apiKeyPresent) {
-    if (!value || typeof value !== 'object' || Array.isArray(value)) {
-        return [];
-    }
-    const candidate = value;
-    if (typeof candidate.id !== 'string' || typeof candidate.name !== 'string') {
-        return [];
+        writeFileSync(catalogPath, nextContent);
     }
-    const createdAt = typeof candidate.createdAt === 'string' ? candidate.createdAt : new Date().toISOString();
-    const updatedAt = typeof candidate.updatedAt === 'string' ? candidate.updatedAt : createdAt;
-    return [{
-            id: candidate.id,
-            name: candidate.name,
-            retention: parseRetention(candidate.retention),
-            workspaceId: typeof candidate.workspaceId === 'string' ? candidate.workspaceId : undefined,
-            history: Array.isArray(candidate.history) ? candidate.history : [],
-            messages: Array.isArray(candidate.messages) && candidate.messages.length > 0 ?
-                candidate.messages.filter(isConversationLine)
-                : createInitialMessages(apiKeyPresent),
-            turns: Array.isArray(candidate.turns) ? candidate.turns.filter(isTurnSummary) : [],
-            createdAt,
-            updatedAt,
-            model: typeof candidate.model === 'string' ? candidate.model : undefined,
-            reasoningEffort: candidate.reasoningEffort === 'low' || candidate.reasoningEffort === 'medium' || candidate.reasoningEffort === 'high' || candidate.reasoningEffort === 'ultrahigh' ?
-                candidate.reasoningEffort
-                : undefined,
-            driftEnabled: typeof candidate.driftEnabled === 'boolean' ? candidate.driftEnabled : false,
-            lastContinuePrompt: typeof candidate.lastContinuePrompt === 'string' ? candidate.lastContinuePrompt : undefined,
-            context: isChatContextStats(candidate.context) ? candidate.context : undefined,
-            archives: Array.isArray(candidate.archives) ? candidate.archives.flatMap(parseArchiveRecord) : undefined,
-            lease: parseLease(candidate.lease),
-        }];
-}
-function parseRetention(value) {
-    return value === 'reusable' || value === 'one_off' ? value : undefined;
-}
-function parseLease(value) {
-    if (!value || typeof value !== 'object' || Array.isArray(value)) {
-        return undefined;
-    }
-    const candidate = value;
-    if ((candidate.ownerKind !== 'tui' && candidate.ownerKind !== 'daemon' && candidate.ownerKind !== 'ask') ||
-        typeof candidate.ownerId !== 'string' ||
-        typeof candidate.acquiredAt !== 'string' ||
-        typeof candidate.lastSeenAt !== 'string') {
-        return undefined;
+    static readSessionFileContents(sessionsDir, sessionId) {
+        const path = FileChatSessionRepository.sessionFilePath(sessionsDir, sessionId);
+        if (!existsSync(path)) {
+            return undefined;
+        }
+        try {
+            return readFileSync(path, 'utf8');
+        }
+        catch {
+            return undefined;
+        }
     }
-    return {
-        ownerKind: candidate.ownerKind,
-        ownerId: candidate.ownerId,
-        acquiredAt: candidate.acquiredAt,
-        lastSeenAt: candidate.lastSeenAt,
-        clientLabel: typeof candidate.clientLabel === 'string' ? candidate.clientLabel : undefined,
-    };
-}
-function isConversationLine(value) {
-    if (!value || typeof value !== 'object' || Array.isArray(value)) {
-        return false;
+    static readCatalogFile(catalogPath) {
+        if (!existsSync(catalogPath)) {
+            return undefined;
+        }
+        try {
+            return ChatSessionCodec.parseCatalog(JSON.parse(readFileSync(catalogPath, 'utf8')));
+        }
+        catch {
+            return undefined;
+        }
     }
-    const candidate = value;
-    return (typeof candidate.id === 'string' &&
-        (candidate.role === 'user' || candidate.role === 'assistant') &&
-        typeof candidate.text === 'string');
-}
-function isTurnSummary(value) {
-    if (!value || typeof value !== 'object' || Array.isArray(value)) {
-        return false;
+    static dedupeSessionsById(sessions) {
+        const seen = new Set();
+        const deduped = [];
+        for (const session of sessions) {
+            if (seen.has(session.id)) {
+                continue;
+            }
+            seen.add(session.id);
+            deduped.push(session);
+        }
+        return deduped;
     }
-    const candidate = value;
-    return (typeof candidate.id === 'string' &&
-        typeof candidate.prompt === 'string' &&
-        typeof candidate.outcome === 'string' &&
-        typeof candidate.summary === 'string' &&
-        typeof candidate.steps === 'number' &&
-        typeof candidate.traceFile === 'string' &&
-        Array.isArray(candidate.events) &&
-        candidate.events.every((event) => typeof event === 'string'));
-}
-function isChatContextStats(value) {
-    if (!value || typeof value !== 'object' || Array.isArray(value)) {
-        return false;
+    static sessionFilePath(sessionsDir, sessionId) {
+        return join(sessionsDir, `${sessionId}.json`);
     }
-    const candidate = value;
-    return (typeof candidate.estimatedHistoryTokens === 'number' &&
-        (candidate.estimatedRequestTokens === undefined || typeof candidate.estimatedRequestTokens === 'number') &&
-        (candidate.lastRunInputTokens === undefined || typeof candidate.lastRunInputTokens === 'number') &&
-        (candidate.lastRunOutputTokens === undefined || typeof candidate.lastRunOutputTokens === 'number') &&
-        (candidate.lastRunTotalTokens === undefined || typeof candidate.lastRunTotalTokens === 'number') &&
-        (candidate.cachedInputTokens === undefined || typeof candidate.cachedInputTokens === 'number') &&
-        (candidate.reasoningTokens === undefined || typeof candidate.reasoningTokens === 'number') &&
-        (candidate.compactedMessages === undefined || typeof candidate.compactedMessages === 'number') &&
-        (candidate.compactedAt === undefined || typeof candidate.compactedAt === 'string') &&
-        (candidate.compactionStatus === undefined || candidate.compactionStatus === 'idle' || candidate.compactionStatus === 'running' || candidate.compactionStatus === 'failed') &&
-        (candidate.compactionError === undefined || typeof candidate.compactionError === 'string') &&
-        (candidate.archiveCount === undefined || typeof candidate.archiveCount === 'number') &&
-        (candidate.currentSummaryPath === undefined || typeof candidate.currentSummaryPath === 'string') &&
-        (candidate.lastArchivePath === undefined || typeof candidate.lastArchivePath === 'string'));
-}
-function parseArchiveRecord(value) {
-    if (!value || typeof value !== 'object' || Array.isArray(value)) {
-        return [];
+    static removeOrphanedSessionFiles(sessionsDir, activeSessionIds) {
+        if (!existsSync(sessionsDir)) {
+            return;
+        }
+        const allowed = new Set(activeSessionIds.map((id) => `${id}.json`));
+        for (const name of FileChatSessionRepository.safeReadDirFiles(sessionsDir)) {
+            if (allowed.has(name) || !name.endsWith('.json')) {
+                continue;
+            }
+            unlinkSync(join(sessionsDir, name));
+        }
     }
-    const candidate = value;
-    if (typeof candidate.id !== 'string'
-        || typeof candidate.path !== 'string'
-        || typeof candidate.summaryPath !== 'string'
-        || typeof candidate.messageCount !== 'number'
-        || typeof candidate.createdAt !== 'string') {
-        return [];
+    static safeReadDirFiles(path) {
+        try {
+            return readdirSync(path);
+        }
+        catch {
+            return [];
+        }
     }
-    return [{
-            id: candidate.id,
-            path: candidate.path,
-            summaryPath: candidate.summaryPath,
-            shortDescription: typeof candidate.shortDescription === 'string' ? candidate.shortDescription : undefined,
-            messageCount: candidate.messageCount,
-            createdAt: candidate.createdAt,
-            summaryModel: typeof candidate.summaryModel === 'string' ? candidate.summaryModel : undefined,
-        }];
-}
-function readObjectRecord(value) {
-    return value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
 }
 //# sourceMappingURL=file-chat-session-repository.js.map