evolclaw 2.1.2 → 2.3.0

package/dist/core/session/adapters/gemini-session-file-adapter.js

@@ -0,0 +1,177 @@
+/**
+ * Gemini SessionFileAdapter
+ *
+ * Reads Gemini CLI session files from ~/.gemini/tmp/{project}/chats/.
+ * Gemini stores sessions as JSON files with naming convention:
+ *   session-{YYYY-MM-DDTHH-mm}-{uuid-prefix}.json
+ *
+ * Each file contains:
+ *   { sessionId, projectHash, startTime, lastUpdated, messages, kind }
+ *
+ * Messages have type: 'user' | 'gemini' (not 'role').
+ */
+import { logger } from '../../../utils/logger.js';
+import path from 'path';
+import fs from 'fs';
+import os from 'os';
+export class GeminiSessionFileAdapter {
+    agentId = 'gemini';
+    getGeminiHome() {
+        return path.join(os.homedir(), '.gemini');
+    }
+    /**
+     * Resolve Gemini project key for a project path.
+     * Priority:
+     * 1. ~/.gemini/projects.json explicit mapping
+     * 2. .project_root file content match under ~/.gemini/tmp/<project-key>/
+     * 3. basename(projectPath) fallback
+     */
+    resolveProjectKey(projectPath) {
+        const geminiHome = this.getGeminiHome();
+        const projectsPath = path.join(geminiHome, 'projects.json');
+        try {
+            if (fs.existsSync(projectsPath)) {
+                const data = JSON.parse(fs.readFileSync(projectsPath, 'utf-8'));
+                const mapped = data?.projects?.[projectPath];
+                if (typeof mapped === 'string' && mapped.trim())
+                    return mapped;
+            }
+        }
+        catch (error) {
+            logger.debug('[GeminiAdapter] Failed to read projects.json:', error);
+        }
+        const tmpDir = path.join(geminiHome, 'tmp');
+        if (fs.existsSync(tmpDir)) {
+            try {
+                for (const entry of fs.readdirSync(tmpDir, { withFileTypes: true })) {
+                    if (!entry.isDirectory())
+                        continue;
+                    const rootFile = path.join(tmpDir, entry.name, '.project_root');
+                    if (!fs.existsSync(rootFile))
+                        continue;
+                    try {
+                        const content = fs.readFileSync(rootFile, 'utf-8').trim();
+                        if (content === projectPath)
+                            return entry.name;
+                    }
+                    catch {
+                        // ignore broken .project_root
+                    }
+                }
+            }
+            catch (error) {
+                logger.debug('[GeminiAdapter] Failed to scan tmp project roots:', error);
+            }
+        }
+        return path.basename(projectPath);
+    }
+    /**
+     * Resolve the Gemini chats directory for a given project path.
+     */
+    resolveChatsDir(projectPath) {
+        const geminiHome = this.getGeminiHome();
+        const projectKey = this.resolveProjectKey(projectPath);
+        return path.join(geminiHome, 'tmp', projectKey, 'chats');
+    }
+    /**
+     * Find the session file matching a given session UUID.
+     * Gemini files are named session-{date}-{uuid-prefix}.json where
+     * uuid-prefix is the first 8 chars of the session UUID.
+     */
+    findSessionFile(projectPath, agentSessionId) {
+        const chatsDir = this.resolveChatsDir(projectPath);
+        if (!fs.existsSync(chatsDir))
+            return null;
+        const uuidPrefix = agentSessionId.substring(0, 8);
+        try {
+            const files = fs.readdirSync(chatsDir);
+            const match = files.find(f => f.includes(uuidPrefix) && f.endsWith('.json'));
+            return match ? path.join(chatsDir, match) : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    readSessionData(projectPath, agentSessionId) {
+        const filePath = this.findSessionFile(projectPath, agentSessionId);
+        if (!filePath)
+            return null;
+        try {
+            return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+        }
+        catch (error) {
+            logger.warn(`[GeminiAdapter] Failed to read session file: ${filePath}`, error);
+            return null;
+        }
+    }
+    checkExists(projectPath, agentSessionId) {
+        return this.findSessionFile(projectPath, agentSessionId) !== null;
+    }
+    getFileInfo(projectPath, agentSessionId) {
+        const data = this.readSessionData(projectPath, agentSessionId);
+        if (!data)
+            return { turns: 0 };
+        const msgs = data.messages || [];
+        const userTurns = msgs.filter((m) => m.type === 'user').length;
+        // Extract title from first user message
+        let title;
+        const firstUser = msgs.find((m) => m.type === 'user');
+        if (firstUser) {
+            const text = Array.isArray(firstUser.content)
+                ? firstUser.content[0]?.text || ''
+                : String(firstUser.content || '');
+            title = text.substring(0, 50).trim() || undefined;
+        }
+        return { turns: userTurns, title };
+    }
+    readFirstMessage(projectPath, agentSessionId) {
+        return this.readUserMessage(projectPath, agentSessionId, 'first');
+    }
+    readLastUserMessage(projectPath, agentSessionId) {
+        return this.readUserMessage(projectPath, agentSessionId, 'last');
+    }
+    scanCliSessions(projectPath) {
+        const chatsDir = this.resolveChatsDir(projectPath);
+        if (!fs.existsSync(chatsDir))
+            return [];
+        try {
+            const files = fs.readdirSync(chatsDir)
+                .filter(f => f.startsWith('session-') && f.endsWith('.json'))
+                .map(f => {
+                const filePath = path.join(chatsDir, f);
+                const stat = fs.statSync(filePath);
+                // Extract UUID from filename: session-{date}-{uuid-prefix}.json
+                // Read the file to get full UUID
+                try {
+                    const data = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+                    return { uuid: data.sessionId, mtime: stat.mtimeMs };
+                }
+                catch {
+                    return null;
+                }
+            })
+                .filter((e) => e !== null)
+                .sort((a, b) => b.mtime - a.mtime)
+                .slice(0, 10);
+            return files;
+        }
+        catch (error) {
+            logger.warn('[GeminiAdapter] scanCliSessions failed:', error);
+            return [];
+        }
+    }
+    readUserMessage(projectPath, agentSessionId, which) {
+        const data = this.readSessionData(projectPath, agentSessionId);
+        if (!data)
+            return null;
+        const msgs = (data.messages || []).filter((m) => m.type === 'user');
+        if (msgs.length === 0)
+            return null;
+        const msg = which === 'first' ? msgs[0] : msgs[msgs.length - 1];
+        const text = Array.isArray(msg.content)
+            ? msg.content[0]?.text || ''
+            : String(msg.content || '');
+        const trimmed = text.trim().replace(/\s+/g, ' ');
+        return trimmed.substring(0, 50) + (trimmed.length > 50 ? '...' : '');
+    }
+}

package/dist/core/session/session-file-adapter.js

@@ -0,0 +1,7 @@
+/**
+ * SessionFileAdapter — 会话文件操作的 Agent 抽象层
+ *
+ * 不同 Agent 后端（Claude / Codex）使用不同的会话文件存储格式和路径。
+ * 此接口将文件操作抽象为统一 API，由各 Agent 适配器分别实现。
+ */
+export {};

package/dist/core/session/session-file-health.js

@@ -0,0 +1,45 @@
+import fsPromises from 'fs/promises';
+import { logger } from '../../utils/logger.js';
+/**
+ * 检查会话文件健康度（接收完整文件路径）
+ */
+export async function checkSessionFile(sessionFile) {
+    const issues = [];
+    try {
+        const stats = await fsPromises.stat(sessionFile);
+        const sizeMB = stats.size / (1024 * 1024);
+        if (stats.size > 50 * 1024 * 1024) {
+            issues.push(`会话文件过大: ${sizeMB.toFixed(1)}MB`);
+        }
+        const content = await fsPromises.readFile(sessionFile, 'utf-8');
+        const lines = content.split('\n').filter(l => l.trim());
+        for (let i = 0; i < lines.length; i++) {
+            try {
+                JSON.parse(lines[i]);
+            }
+            catch (e) {
+                issues.push(`会话文件格式损坏（第 ${i + 1} 行）`);
+                return { healthy: false, issues, corrupt: true, fileSize: stats.size };
+            }
+        }
+        return {
+            healthy: issues.length === 0,
+            issues,
+            fileSize: stats.size
+        };
+    }
+    catch (error) {
+        logger.error('[SessionFileHealth] Check failed:', error);
+        issues.push(`文件读取失败: ${error.message}`);
+        return { healthy: false, issues, corrupt: true };
+    }
+}
+/**
+ * 备份单个会话文件（在同目录下创建 .bak 副本）
+ */
+export async function backupSessionFile(sessionFile) {
+    const backupPath = `${sessionFile}.bak-${Date.now()}`;
+    await fsPromises.copyFile(sessionFile, backupPath);
+    logger.info(`[SessionFileHealth] Backup created: ${backupPath}`);
+    return backupPath;
+}