@orion-agents/orion-code 0.1.0

package/dist/services/session-storage.js

@@ -0,0 +1,1026 @@
+"use strict";
+/**
+ * orion code - 会话存储
+ *
+ * 使用 JSONL 格式存储会话历史和对话记录。
+ * 参考 OpenClaude 的 history.jsonl 和 sessions/ 目录。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SESSION_SIDECAR_SUFFIXES = exports.redactTraceText = void 0;
+exports.resolveProjectPath = resolveProjectPath;
+exports.getProjectKey = getProjectKey;
+exports.isSessionMetaFile = isSessionMetaFile;
+exports.createSession = createSession;
+exports.saveSessionMeta = saveSessionMeta;
+exports.loadSessionMeta = loadSessionMeta;
+exports.updateSessionStats = updateSessionStats;
+exports.resumeSession = resumeSession;
+exports.updateSessionHarnessState = updateSessionHarnessState;
+exports.loadSessionHarnessState = loadSessionHarnessState;
+exports.updateSessionSkills = updateSessionSkills;
+exports.markSessionTranscriptDisplayStart = markSessionTranscriptDisplayStart;
+exports.persistSessionCompactHistory = persistSessionCompactHistory;
+exports.loadSessionCompactCheckpoint = loadSessionCompactCheckpoint;
+exports.commitSessionCompactCheckpoint = commitSessionCompactCheckpoint;
+exports.loadSessionTranscriptMessages = loadSessionTranscriptMessages;
+exports.endSession = endSession;
+exports.updateSessionSummary = updateSessionSummary;
+exports.getLastSession = getLastSession;
+exports.appendHistory = appendHistory;
+exports.readHistory = readHistory;
+exports.readProjectHistory = readProjectHistory;
+exports.appendSessionMessage = appendSessionMessage;
+exports.appendSessionMessages = appendSessionMessages;
+exports.truncateSessionToLastComplete = truncateSessionToLastComplete;
+exports.removeLastIncompleteAssistantMessage = removeLastIncompleteAssistantMessage;
+exports.readSessionMessages = readSessionMessages;
+exports.appendSessionTraceEvent = appendSessionTraceEvent;
+exports.readSessionTraceEvents = readSessionTraceEvents;
+exports.loadSessionHistory = loadSessionHistory;
+exports.listSessions = listSessions;
+exports.listProjectSessions = listProjectSessions;
+exports.findSession = findSession;
+exports.lookupSessionRef = lookupSessionRef;
+exports.renameSession = renameSession;
+exports.deleteSession = deleteSession;
+const fs_1 = require("fs");
+const crypto_1 = require("crypto");
+const child_process_1 = require("child_process");
+const path_1 = require("path");
+const config_dir_1 = require("./config-dir");
+const atomic_write_1 = require("./atomic-write");
+const session_index_1 = require("./session-index");
+const redaction_1 = require("./redaction");
+const harness_1 = require("../harness");
+var redaction_2 = require("./redaction");
+Object.defineProperty(exports, "redactTraceText", { enumerable: true, get: function () { return redaction_2.redactTraceText; } });
+function sanitizeTraceEvent(event) {
+    const sanitized = { ...event };
+    for (const key of [
+        'argsSummary',
+        'error',
+        'note',
+        'permissionReason',
+        'continuationHint',
+    ]) {
+        if (typeof sanitized[key] === 'string') {
+            sanitized[key] = (0, redaction_1.redactTraceText)(sanitized[key]);
+        }
+    }
+    if (sanitized.workspaceFiles) {
+        sanitized.workspaceFiles = sanitized.workspaceFiles.map(redaction_1.redactTraceText);
+    }
+    if (sanitized.checkpointFiles) {
+        sanitized.checkpointFiles = sanitized.checkpointFiles.map(redaction_1.redactTraceText);
+    }
+    if (sanitized.promptSections) {
+        sanitized.promptSections = sanitized.promptSections.map(redaction_1.redactTraceText);
+    }
+    if (sanitized.promptIncludedEvidence) {
+        sanitized.promptIncludedEvidence = sanitized.promptIncludedEvidence.map(redaction_1.redactTraceText);
+    }
+    if (sanitized.promptOmittedEvidence) {
+        sanitized.promptOmittedEvidence = sanitized.promptOmittedEvidence.map(redaction_1.redactTraceText);
+    }
+    if (sanitized.workspaceChangedByTurn) {
+        sanitized.workspaceChangedByTurn = sanitized.workspaceChangedByTurn.map(redaction_1.redactTraceText);
+    }
+    if (sanitized.workspaceNewByTurn) {
+        sanitized.workspaceNewByTurn = sanitized.workspaceNewByTurn.map(redaction_1.redactTraceText);
+    }
+    if (sanitized.workspaceModifiedPreExistingByTurn) {
+        sanitized.workspaceModifiedPreExistingByTurn =
+            sanitized.workspaceModifiedPreExistingByTurn.map(redaction_1.redactTraceText);
+    }
+    if (sanitized.workspaceResolvedByTurn) {
+        sanitized.workspaceResolvedByTurn = sanitized.workspaceResolvedByTurn.map(redaction_1.redactTraceText);
+    }
+    if (sanitized.verificationCommands) {
+        sanitized.verificationCommands = sanitized.verificationCommands.map(redaction_1.redactTraceText);
+    }
+    if (typeof sanitized.verificationCommand === 'string') {
+        sanitized.verificationCommand = (0, redaction_1.redactTraceText)(sanitized.verificationCommand);
+    }
+    if (sanitized.providerRetryErrorTypes) {
+        sanitized.providerRetryErrorTypes = sanitized.providerRetryErrorTypes.map(redaction_1.redactTraceText);
+    }
+    for (const key of [
+        'providerLastRetryErrorType',
+        'providerFallbackFromModel',
+        'providerFallbackToModel',
+        'providerFinalModel',
+    ]) {
+        if (typeof sanitized[key] === 'string') {
+            sanitized[key] = (0, redaction_1.redactTraceText)(sanitized[key]);
+        }
+    }
+    if (sanitized.verificationChangedFiles) {
+        sanitized.verificationChangedFiles = sanitized.verificationChangedFiles.map(redaction_1.redactTraceText);
+    }
+    if (sanitized.verificationPassedCommands) {
+        sanitized.verificationPassedCommands =
+            sanitized.verificationPassedCommands.map(redaction_1.redactTraceText);
+    }
+    if (sanitized.verificationFailedCommands) {
+        sanitized.verificationFailedCommands =
+            sanitized.verificationFailedCommands.map(redaction_1.redactTraceText);
+    }
+    if (sanitized.verificationMissingCommands) {
+        sanitized.verificationMissingCommands =
+            sanitized.verificationMissingCommands.map(redaction_1.redactTraceText);
+    }
+    return sanitized;
+}
+// ============================================================================
+// Project helpers
+// ============================================================================
+const MAX_CACHE_SIZE = 256;
+/**
+ * Evict the oldest entries when a Map exceeds MAX_CACHE_SIZE.
+ * Simple LRU approximation: delete the first (oldest) entries until
+ * the map is within bounds. Called after each insertion.
+ */
+function evictOldest(map, maxSize) {
+    while (map.size > maxSize) {
+        const firstKey = map.keys().next().value;
+        if (firstKey !== undefined)
+            map.delete(firstKey);
+        else
+            break;
+    }
+}
+const resolvedProjectPathCache = new Map();
+/**
+ * Resolve a working directory to the project identity used for session storage.
+ * Git repositories share sessions from the repository root; non-git folders use
+ * their real absolute path.
+ */
+function resolveProjectPath(cwd = process.cwd()) {
+    const absolute = (0, path_1.resolve)(cwd);
+    const cached = resolvedProjectPathCache.get(absolute);
+    if (cached) {
+        return cached;
+    }
+    let resolvedPath = absolute;
+    if ((0, fs_1.existsSync)(absolute)) {
+        try {
+            const root = (0, child_process_1.execFileSync)('git', ['-C', absolute, 'rev-parse', '--show-toplevel'], {
+                encoding: 'utf-8',
+                stdio: ['ignore', 'pipe', 'ignore'],
+            }).trim();
+            if (root) {
+                resolvedPath = (0, fs_1.realpathSync)(root);
+                resolvedProjectPathCache.set(absolute, resolvedPath);
+                evictOldest(resolvedProjectPathCache, MAX_CACHE_SIZE);
+                return resolvedPath;
+            }
+        }
+        catch {
+            // Not a git worktree, or git is unavailable.
+        }
+    }
+    try {
+        resolvedPath = (0, fs_1.realpathSync)(absolute);
+    }
+    catch {
+        resolvedPath = absolute;
+    }
+    resolvedProjectPathCache.set(absolute, resolvedPath);
+    evictOldest(resolvedProjectPathCache, MAX_CACHE_SIZE);
+    return resolvedPath;
+}
+function getProjectKey(projectPath) {
+    return (0, config_dir_1.encodeProjectPath)(resolveProjectPath(projectPath));
+}
+function getGitBranch(projectPath) {
+    if (!(0, fs_1.existsSync)(projectPath)) {
+        return undefined;
+    }
+    try {
+        const branch = (0, child_process_1.execFileSync)('git', ['-C', projectPath, 'rev-parse', '--abbrev-ref', 'HEAD'], {
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        return branch || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function normalizeSessionMeta(session) {
+    const projectPath = resolveProjectPath(session.projectPath);
+    const startTime = session.startTime ?? Date.now();
+    const updatedAt = session.updatedAt ?? session.endTime ?? startTime;
+    return {
+        ...session,
+        projectPath,
+        projectKey: session.projectKey ?? (0, config_dir_1.encodeProjectPath)(projectPath),
+        cwd: session.cwd ?? projectPath,
+        startTime,
+        createdAt: session.createdAt ?? new Date(startTime).toISOString(),
+        updatedAt,
+        updatedAtIso: session.updatedAtIso ?? new Date(updatedAt).toISOString(),
+        messageCount: session.messageCount ?? 0,
+        historySizeBytes: computeSessionHistorySizeBytes({ id: session.id, projectPath }),
+        tokenCount: session.tokenCount ?? 0,
+        cost: session.cost ?? 0,
+        gitBranch: session.gitBranch ?? getGitBranch(projectPath),
+    };
+}
+function uniquePaths(paths) {
+    return [...new Set(paths)];
+}
+function parseSessionMetaFile(path) {
+    try {
+        const content = (0, fs_1.readFileSync)(path, 'utf-8');
+        const parsed = JSON.parse(content);
+        if (typeof parsed.id !== 'string' || !parsed.id) {
+            console.warn(`[session-storage] meta file missing valid id: ${path}`);
+            return null;
+        }
+        if (typeof parsed.projectPath !== 'string' || !parsed.projectPath) {
+            console.warn(`[session-storage] meta file missing valid projectPath: ${path}`);
+            return null;
+        }
+        return parsed;
+    }
+    catch (err) {
+        console.warn(`[session-storage] failed to parse meta file ${path}: ${err instanceof Error ? err.message : err}`);
+        return null;
+    }
+}
+function isSessionMetaFile(file) {
+    return file.endsWith('.json') && !exports.SESSION_SIDECAR_SUFFIXES.some(s => file.endsWith(s));
+}
+/** Shared exclusion list for session sidecar files. */
+exports.SESSION_SIDECAR_SUFFIXES = [
+    '.messages.json',
+    '.harness.json',
+    '.compact.json',
+    '.runtime.json',
+    '.trace.json',
+    '.goal.json',
+    '.index.json',
+];
+function parseHarnessSidecarFile(path) {
+    try {
+        const content = (0, fs_1.readFileSync)(path, 'utf-8');
+        const parsed = JSON.parse(content);
+        return parsed?.version === 2 && parsed.state ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function parseCompactCheckpointFile(path) {
+    try {
+        const parsed = JSON.parse((0, fs_1.readFileSync)(path, 'utf-8'));
+        if (parsed?.version !== 1 ||
+            !parsed.checkpointId ||
+            !parsed.sessionId ||
+            !Array.isArray(parsed.modelHistory) ||
+            !Number.isInteger(parsed.sourceMessageCount) ||
+            parsed.sourceMessageCount < 0 ||
+            !parsed.summary ||
+            typeof parsed.summary.text !== 'string') {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function upsertNewestSession(sessionsById, session) {
+    const existing = sessionsById.get(session.id);
+    const existingTime = existing ? (existing.updatedAt ?? existing.startTime) : 0;
+    const nextTime = session.updatedAt ?? session.startTime;
+    if (!existing || nextTime >= existingTime) {
+        sessionsById.set(session.id, session);
+    }
+}
+function sortSessionsNewestFirst(sessions) {
+    return sessions.sort((a, b) => (b.updatedAt ?? b.startTime) - (a.updatedAt ?? a.startTime));
+}
+function safeFileSize(path) {
+    try {
+        return (0, fs_1.existsSync)(path) ? (0, fs_1.statSync)(path).size : null;
+    }
+    catch {
+        return null;
+    }
+}
+function computeSessionHistorySizeBytes(session) {
+    return safeFileSize((0, config_dir_1.getProjectSessionMessagesPath)(session.projectPath, session.id)) ?? 0;
+}
+// ============================================================================
+// 会话管理
+// ============================================================================
+/**
+ * 创建新会话
+ */
+function createSession(projectPath, model) {
+    (0, config_dir_1.ensureConfigDir)();
+    const canonicalProjectPath = resolveProjectPath(projectPath);
+    const now = Date.now();
+    const session = {
+        id: (0, crypto_1.randomUUID)(),
+        projectPath: canonicalProjectPath,
+        projectKey: (0, config_dir_1.encodeProjectPath)(canonicalProjectPath),
+        cwd: (0, path_1.resolve)(projectPath),
+        model,
+        startTime: now,
+        createdAt: new Date(now).toISOString(),
+        updatedAt: now,
+        updatedAtIso: new Date(now).toISOString(),
+        messageCount: 0,
+        gitBranch: getGitBranch(canonicalProjectPath),
+        tokenCount: 0,
+        cost: 0,
+    };
+    saveSessionMeta(session);
+    return session;
+}
+/**
+ * 保存会话元数据
+ */
+function saveSessionMeta(session) {
+    (0, config_dir_1.ensureConfigDir)();
+    const normalized = normalizeSessionMeta(session);
+    const payload = JSON.stringify(normalized, null, 2);
+    (0, config_dir_1.ensureProjectDir)(normalized.projectPath);
+    (0, atomic_write_1.atomicWriteFileSync)((0, config_dir_1.getProjectSessionMetaPath)(normalized.projectPath, normalized.id), payload, {
+        mode: 0o600,
+    });
+}
+/**
+ * 加载会话元数据
+ */
+function loadSessionMeta(sessionId) {
+    const projectsDir = (0, config_dir_1.getProjectsDir)();
+    if ((0, fs_1.existsSync)(projectsDir)) {
+        for (const projectKey of (0, fs_1.readdirSync)(projectsDir)) {
+            const path = (0, path_1.join)(projectsDir, projectKey, 'sessions', `${sessionId}.json`);
+            if (!(0, fs_1.existsSync)(path))
+                continue;
+            const session = parseSessionMetaFile(path);
+            if (session) {
+                return normalizeSessionMeta(session);
+            }
+        }
+    }
+    return null;
+}
+/**
+ * 更新会话统计
+ */
+function updateSessionStats(sessionId, tokens, cost) {
+    const session = loadSessionMeta(sessionId);
+    if (!session)
+        return;
+    session.tokenCount += tokens;
+    session.cost += cost;
+    session.updatedAt = Date.now();
+    session.updatedAtIso = new Date(session.updatedAt).toISOString();
+    saveSessionMeta(session);
+}
+function touchSession(sessionId, messageDelta = 0) {
+    const session = loadSessionMeta(sessionId);
+    if (!session)
+        return null;
+    session.updatedAt = Date.now();
+    session.updatedAtIso = new Date(session.updatedAt).toISOString();
+    session.messageCount = (session.messageCount ?? 0) + messageDelta;
+    saveSessionMeta(session);
+    return session;
+}
+/**
+ * Mark a saved session as active again and refresh project metadata.
+ */
+function resumeSession(sessionId) {
+    const session = loadSessionMeta(sessionId);
+    if (!session)
+        return null;
+    session.endTime = undefined;
+    session.gitBranch = getGitBranch(session.projectPath);
+    session.updatedAt = Date.now();
+    session.updatedAtIso = new Date(session.updatedAt).toISOString();
+    saveSessionMeta(session);
+    return session;
+}
+/**
+ * 更新会话 Harness 状态。
+ */
+function updateSessionHarnessState(sessionId, harnessState) {
+    const session = loadSessionMeta(sessionId);
+    if (!session)
+        return;
+    const fullState = (0, harness_1.upgradeHarnessState)(harnessState, { cwd: session.cwd ?? session.projectPath });
+    const sidecar = {
+        version: 2,
+        sessionId,
+        projectPath: session.projectPath,
+        state: fullState,
+        contextCapsule: fullState.capsule,
+        updatedAt: Date.now(),
+        diagnostics: fullState.diagnostics,
+    };
+    (0, config_dir_1.ensureProjectDir)(session.projectPath);
+    (0, atomic_write_1.atomicWriteFileSync)((0, config_dir_1.getProjectSessionHarnessPath)(session.projectPath, sessionId), JSON.stringify(sidecar, null, 2), { mode: 0o600 });
+    session.harnessState = (0, harness_1.summarizeHarnessStateForMeta)(fullState);
+    session.contextCapsule = fullState.capsule;
+    session.updatedAt = Date.now();
+    session.updatedAtIso = new Date(session.updatedAt).toISOString();
+    saveSessionMeta(session);
+}
+function loadSessionHarnessState(sessionId) {
+    const session = loadSessionMeta(sessionId);
+    if (!session)
+        return null;
+    const sidecarPath = (0, config_dir_1.getProjectSessionHarnessPath)(session.projectPath, sessionId);
+    if ((0, fs_1.existsSync)(sidecarPath)) {
+        const sidecar = parseHarnessSidecarFile(sidecarPath);
+        if (sidecar?.state) {
+            return (0, harness_1.upgradeHarnessState)(sidecar.state, {
+                cwd: session.cwd ?? session.projectPath,
+                messages: readSessionMessages(sessionId),
+            });
+        }
+    }
+    if (session.harnessState) {
+        return (0, harness_1.upgradeHarnessState)(session.harnessState, {
+            cwd: session.cwd ?? session.projectPath,
+            messages: readSessionMessages(sessionId),
+        });
+    }
+    const messages = readSessionMessages(sessionId);
+    if (messages.length > 0) {
+        return (0, harness_1.upgradeHarnessState)(null, {
+            cwd: session.cwd ?? session.projectPath,
+            messages,
+        });
+    }
+    return null;
+}
+function updateSessionSkills(sessionId, skills) {
+    if (skills.length === 0)
+        return;
+    const session = loadSessionMeta(sessionId);
+    if (!session)
+        return;
+    session.skillsUsed = [...new Set([...(session.skillsUsed || []), ...skills])];
+    session.updatedAt = Date.now();
+    session.updatedAtIso = new Date(session.updatedAt).toISOString();
+    saveSessionMeta(session);
+}
+function markSessionTranscriptDisplayStart(sessionId, timestamp = Date.now()) {
+    const session = loadSessionMeta(sessionId);
+    if (!session)
+        return null;
+    session.transcriptDisplayStartTime = timestamp;
+    session.updatedAt = timestamp;
+    session.updatedAtIso = new Date(timestamp).toISOString();
+    saveSessionMeta(session);
+    return session;
+}
+function persistSessionCompactHistory(sessionId, messages, timestamp = Date.now()) {
+    const session = loadSessionMeta(sessionId);
+    if (!session)
+        return null;
+    const compactMessages = messages.map(message => ({
+        role: message.role,
+        content: message.content,
+        timestamp,
+        toolCallId: message.tool_call_id,
+        tool_calls: message.tool_calls,
+    }));
+    appendSessionMessages(sessionId, compactMessages);
+    return markSessionTranscriptDisplayStart(sessionId, timestamp);
+}
+function loadSessionCompactCheckpoint(sessionId) {
+    const session = loadSessionMeta(sessionId);
+    if (!session)
+        return null;
+    const checkpoint = parseCompactCheckpointFile((0, config_dir_1.getProjectSessionCompactPath)(session.projectPath, sessionId));
+    if (!checkpoint || checkpoint.sessionId !== sessionId)
+        return null;
+    if (session.activeCompactCheckpointId !== checkpoint.checkpointId) {
+        return null;
+    }
+    const rawCount = readSessionMessages(sessionId).length;
+    if (checkpoint.sourceMessageCount > rawCount)
+        return null;
+    return checkpoint;
+}
+function commitSessionCompactCheckpoint(input) {
+    const session = loadSessionMeta(input.sessionId);
+    if (!session)
+        throw new Error(`Session not found: ${input.sessionId}`);
+    const rawCount = readSessionMessages(input.sessionId).length;
+    if (input.sourceMessageCount < 0 || input.sourceMessageCount > rawCount) {
+        throw new Error(`Invalid compact source boundary ${input.sourceMessageCount}; transcript has ${rawCount} messages`);
+    }
+    const createdAt = input.createdAt ?? Date.now();
+    const checkpoint = {
+        version: 1,
+        checkpointId: (0, crypto_1.randomUUID)(),
+        sessionId: input.sessionId,
+        createdAt,
+        mode: input.mode,
+        modelId: input.modelId,
+        sourceMessageCount: input.sourceMessageCount,
+        transcriptStartMessageIndex: Math.max(0, Math.min(input.sourceMessageCount, input.transcriptStartMessageIndex)),
+        modelHistory: input.modelHistory
+            .filter(message => message.role !== 'system')
+            .map(message => ({ ...message })),
+        summary: {
+            ...input.summary,
+            sourceMessageCount: input.sourceMessageCount,
+        },
+        beforeUsage: { ...input.beforeUsage },
+        afterUsage: { ...input.afterUsage },
+    };
+    const previousId = session.activeCompactCheckpointId;
+    const previousTime = session.lastCompactAt;
+    session.activeCompactCheckpointId = checkpoint.checkpointId;
+    session.lastCompactAt = createdAt;
+    session.updatedAt = createdAt;
+    session.updatedAtIso = new Date(createdAt).toISOString();
+    // Commit the pointer before replacing the atomic sidecar. If the process
+    // crashes between writes, the loader safely uses the last valid sidecar.
+    saveSessionMeta(session);
+    try {
+        (0, atomic_write_1.atomicWriteFileSync)((0, config_dir_1.getProjectSessionCompactPath)(session.projectPath, input.sessionId), JSON.stringify(checkpoint, null, 2), { mode: 0o600 });
+    }
+    catch (error) {
+        session.activeCompactCheckpointId = previousId;
+        session.lastCompactAt = previousTime;
+        saveSessionMeta(session);
+        throw error;
+    }
+    return checkpoint;
+}
+function loadSessionTranscriptMessages(sessionId) {
+    const messages = readSessionMessages(sessionId);
+    const checkpoint = loadSessionCompactCheckpoint(sessionId);
+    if (checkpoint) {
+        return messages.slice(checkpoint.transcriptStartMessageIndex);
+    }
+    const session = loadSessionMeta(sessionId);
+    const displayStartTime = session?.transcriptDisplayStartTime;
+    return typeof displayStartTime === 'number'
+        ? messages.filter(message => (message.timestamp ?? 0) >= displayStartTime)
+        : messages;
+}
+function hasPersistedCompactContext(messages) {
+    return messages.some(message => message.content.includes('[Orion Code Context State v2]') ||
+        message.content.includes('[Context Summary]') ||
+        message.content.includes('## Context Capsule'));
+}
+/**
+ * 结束会话
+ */
+function endSession(sessionId) {
+    const session = loadSessionMeta(sessionId);
+    if (!session)
+        return;
+    session.endTime = Date.now();
+    session.updatedAt = session.endTime;
+    session.updatedAtIso = new Date(session.updatedAt).toISOString();
+    saveSessionMeta(session);
+}
+/**
+ * 更新会话任务摘要
+ * 从会话消息中提取关键信息并更新元数据
+ */
+function updateSessionSummary(sessionId, messages) {
+    const session = loadSessionMeta(sessionId);
+    if (!session)
+        return;
+    // 提取工具使用列表
+    const toolsUsed = [];
+    const filesModified = [];
+    for (const msg of messages) {
+        if (msg.role === 'assistant' && msg.tool_calls) {
+            for (const tc of msg.tool_calls) {
+                toolsUsed.push(tc.function.name);
+                // 从 write_file, edit_file 工具参数中提取文件路径
+                if (tc.function.name === 'write_file' || tc.function.name === 'edit_file') {
+                    try {
+                        const args = JSON.parse(tc.function.arguments);
+                        if (args.path) {
+                            filesModified.push(args.path);
+                        }
+                    }
+                    catch {
+                        // ignore parse errors
+                    }
+                }
+            }
+        }
+    }
+    // 提取任务摘要（从第一个用户消息）
+    const firstUserMsg = messages.find(m => m.role === 'user' && m.content);
+    const taskSummary = (0, redaction_1.redactTraceText)(firstUserMsg?.content ?? '').slice(0, 100);
+    // 更新 session
+    session.toolsUsed = [...new Set(toolsUsed)]; // unique
+    session.filesModified = [...new Set(filesModified)]; // unique
+    session.taskSummary = taskSummary.length > 100 ? taskSummary.slice(0, 100) + '...' : taskSummary;
+    session.messageCount = messages.length;
+    session.updatedAt = Date.now();
+    session.updatedAtIso = new Date(session.updatedAt).toISOString();
+    saveSessionMeta(session);
+}
+/**
+ * 获取项目最近的会话
+ */
+function getLastSession(projectPath) {
+    const sessions = listProjectSessions(projectPath).filter(session => (session.messageCount ?? 0) > 0);
+    return sessions[0] ?? null;
+}
+// ============================================================================
+// 历史记录 (JSONL)
+// ============================================================================
+/**
+ * 追加历史记录
+ */
+function appendHistory(entry) {
+    (0, config_dir_1.ensureConfigDir)();
+    const path = (0, config_dir_1.getHistoryPath)();
+    const line = JSON.stringify(entry) + '\n';
+    (0, fs_1.appendFileSync)(path, line, { mode: 0o600 });
+}
+/**
+ * 读取历史记录
+ * @param limit 最大条数（从最新开始）
+ */
+function readHistory(limit) {
+    const path = (0, config_dir_1.getHistoryPath)();
+    if (!(0, fs_1.existsSync)(path)) {
+        return [];
+    }
+    try {
+        const content = (0, fs_1.readFileSync)(path, 'utf-8');
+        const lines = content.trim().split('\n').filter(Boolean);
+        // Parse each line individually — skip corrupted lines instead of losing all history.
+        const entries = [];
+        for (const line of lines) {
+            try {
+                entries.push(JSON.parse(line));
+            }
+            catch {
+                // Skip corrupted line, preserve remaining valid entries.
+            }
+        }
+        // 从最新开始
+        const reversed = entries.reverse();
+        return limit ? reversed.slice(0, limit) : reversed;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 按项目过滤历史记录
+ */
+function readProjectHistory(projectPath, limit) {
+    const all = readHistory();
+    const filtered = all.filter(e => e.project === projectPath);
+    return limit ? filtered.slice(0, limit) : filtered;
+}
+// ============================================================================
+// 会话对话记录 (JSONL)
+// ============================================================================
+/**
+ * 追加会话消息
+ */
+function appendSessionMessage(sessionId, message) {
+    (0, config_dir_1.ensureConfigDir)();
+    const line = JSON.stringify(message) + '\n';
+    const session = touchSession(sessionId, 1);
+    if (!session)
+        return;
+    (0, config_dir_1.ensureProjectDir)(session.projectPath);
+    (0, fs_1.appendFileSync)((0, config_dir_1.getProjectSessionMessagesPath)(session.projectPath, sessionId), line, {
+        mode: 0o600,
+    });
+    // Update session index for fast search
+    (0, session_index_1.updateSessionIndex)(sessionId, session.projectPath, message);
+}
+/**
+ * 追加多条会话消息
+ */
+function appendSessionMessages(sessionId, messages) {
+    if (messages.length === 0)
+        return;
+    (0, config_dir_1.ensureConfigDir)();
+    const lines = messages.map(m => JSON.stringify(m)).join('\n') + '\n';
+    const session = touchSession(sessionId, messages.length);
+    if (!session)
+        return;
+    (0, config_dir_1.ensureProjectDir)(session.projectPath);
+    (0, fs_1.appendFileSync)((0, config_dir_1.getProjectSessionMessagesPath)(session.projectPath, sessionId), lines, {
+        mode: 0o600,
+    });
+    for (const message of messages) {
+        (0, session_index_1.updateSessionIndex)(sessionId, session.projectPath, message);
+    }
+}
+function isFinalAssistantMessage(message) {
+    return message.role === 'assistant' && (!message.tool_calls || message.tool_calls.length === 0);
+}
+function findLastCompleteBoundary(messages) {
+    const lastUserIndex = messages.map(message => message.role).lastIndexOf('user');
+    if (lastUserIndex < 0) {
+        return messages.length;
+    }
+    const tail = messages.slice(lastUserIndex + 1);
+    return tail.some(isFinalAssistantMessage) ? messages.length : lastUserIndex;
+}
+function overwriteSessionMessages(sessionId, messages) {
+    (0, config_dir_1.ensureConfigDir)();
+    const session = loadSessionMeta(sessionId);
+    if (!session)
+        return;
+    const content = messages.length > 0 ? messages.map(message => JSON.stringify(message)).join('\n') + '\n' : '';
+    (0, config_dir_1.ensureProjectDir)(session.projectPath);
+    (0, atomic_write_1.atomicWriteFileSync)((0, config_dir_1.getProjectSessionMessagesPath)(session.projectPath, sessionId), content, {
+        mode: 0o600,
+    });
+    (0, session_index_1.deleteSessionIndex)(sessionId, session.projectPath);
+    for (const message of messages) {
+        (0, session_index_1.updateSessionIndex)(sessionId, session.projectPath, message);
+    }
+    session.messageCount = messages.length;
+    session.updatedAt = Date.now();
+    session.updatedAtIso = new Date(session.updatedAt).toISOString();
+    saveSessionMeta(session);
+}
+/**
+ * Remove a trailing incomplete turn from the persisted session transcript.
+ *
+ * A complete turn ends with a final assistant message without tool calls. If an
+ * abort happens after the user message, or after assistant/tool intermediates
+ * but before the final assistant answer, the tail is removed so resume does not
+ * resurrect partial state.
+ */
+function truncateSessionToLastComplete(sessionId) {
+    const messages = readSessionMessages(sessionId);
+    const boundary = findLastCompleteBoundary(messages);
+    if (boundary === messages.length) {
+        return messages;
+    }
+    const truncated = messages.slice(0, boundary);
+    overwriteSessionMessages(sessionId, truncated);
+    return truncated;
+}
+function removeLastIncompleteAssistantMessage(sessionId) {
+    return truncateSessionToLastComplete(sessionId);
+}
+/**
+ * 读取会话消息
+ */
+function readSessionMessages(sessionId) {
+    const session = loadSessionMeta(sessionId);
+    if (!session)
+        return [];
+    const path = (0, config_dir_1.getProjectSessionMessagesPath)(session.projectPath, sessionId);
+    if (!(0, fs_1.existsSync)(path))
+        return [];
+    try {
+        const content = (0, fs_1.readFileSync)(path, 'utf-8');
+        const lines = content.trim().split('\n').filter(Boolean);
+        const messages = [];
+        for (let i = 0; i < lines.length; i++) {
+            try {
+                messages.push(JSON.parse(lines[i]));
+            }
+            catch {
+                // A missing turn can orphan later tool results, so only restore the valid prefix.
+                break;
+            }
+        }
+        return messages;
+    }
+    catch {
+        return [];
+    }
+}
+function appendSessionTraceEvent(sessionId, event) {
+    const session = loadSessionMeta(sessionId);
+    if (!session)
+        return null;
+    (0, config_dir_1.ensureConfigDir)();
+    const safeEvent = sanitizeTraceEvent(event);
+    const traceEvent = {
+        ...safeEvent,
+        sessionId,
+        turnId: String(safeEvent.turnId),
+        timestamp: safeEvent.timestamp ?? Date.now(),
+    };
+    (0, fs_1.appendFileSync)((0, config_dir_1.getProjectSessionTracePath)(session.projectPath, sessionId), `${JSON.stringify(traceEvent)}\n`, { mode: 0o600 });
+    return traceEvent;
+}
+function readSessionTraceEvents(sessionId) {
+    const session = loadSessionMeta(sessionId);
+    if (!session)
+        return [];
+    const path = (0, config_dir_1.getProjectSessionTracePath)(session.projectPath, sessionId);
+    if (!(0, fs_1.existsSync)(path))
+        return [];
+    try {
+        const content = (0, fs_1.readFileSync)(path, 'utf-8');
+        return content
+            .trim()
+            .split('\n')
+            .filter(Boolean)
+            .flatMap(line => {
+            try {
+                const parsed = JSON.parse(line);
+                if (!parsed.type || !parsed.turnId || !parsed.timestamp)
+                    return [];
+                const sanitized = sanitizeTraceEvent({
+                    ...parsed,
+                    turnId: String(parsed.turnId),
+                });
+                return [
+                    {
+                        ...sanitized,
+                        sessionId,
+                        turnId: String(sanitized.turnId),
+                    },
+                ];
+            }
+            catch {
+                return [];
+            }
+        });
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 读取会话消息并转换为 Message 格式（用于恢复对话历史）
+ * 包含完整的 tool_calls 信息，确保 LLM 能理解之前的工具调用
+ */
+function loadSessionHistory(sessionId) {
+    const messages = readSessionMessages(sessionId);
+    const checkpoint = loadSessionCompactCheckpoint(sessionId);
+    if (checkpoint) {
+        return [
+            ...checkpoint.modelHistory.map(message => ({ ...message })),
+            ...messages.slice(checkpoint.sourceMessageCount).map(sessionMessageToModelMessage),
+        ];
+    }
+    const session = loadSessionMeta(sessionId);
+    const displayStartTime = session?.transcriptDisplayStartTime;
+    let modelVisibleMessages = messages;
+    if (typeof displayStartTime === 'number') {
+        const afterDisplayStart = messages.filter(message => (message.timestamp ?? 0) >= displayStartTime);
+        modelVisibleMessages = hasPersistedCompactContext(afterDisplayStart)
+            ? afterDisplayStart
+            : messages;
+    }
+    return modelVisibleMessages.map(sessionMessageToModelMessage);
+}
+function sessionMessageToModelMessage(message) {
+    const result = {
+        role: message.role,
+        content: message.modelVisibleContent ?? message.content,
+    };
+    if (message.role === 'tool' && message.toolCallId) {
+        result.tool_call_id = message.toolCallId;
+    }
+    if (message.role === 'assistant' && message.tool_calls && message.tool_calls.length > 0) {
+        result.tool_calls = message.tool_calls;
+    }
+    return result;
+}
+/**
+ * 列出所有会话
+ */
+function listSessions(limit) {
+    (0, config_dir_1.ensureConfigDir)();
+    const sessionsById = new Map();
+    const projectsDir = (0, config_dir_1.getProjectsDir)();
+    if ((0, fs_1.existsSync)(projectsDir)) {
+        for (const projectKey of (0, fs_1.readdirSync)(projectsDir)) {
+            const projectSessionsDir = (0, path_1.join)(projectsDir, projectKey, 'sessions');
+            if (!(0, fs_1.existsSync)(projectSessionsDir))
+                continue;
+            const files = (0, fs_1.readdirSync)(projectSessionsDir).filter(isSessionMetaFile);
+            for (const file of files) {
+                const rawSession = parseSessionMetaFile((0, path_1.join)(projectSessionsDir, file));
+                if (rawSession) {
+                    upsertNewestSession(sessionsById, normalizeSessionMeta(rawSession));
+                }
+            }
+        }
+    }
+    const sessions = sortSessionsNewestFirst(Array.from(sessionsById.values()));
+    return limit ? sessions.slice(0, limit) : sessions;
+}
+/**
+ * List sessions for a single canonical project.
+ */
+function listProjectSessions(projectPath, limit) {
+    const canonicalProjectPath = resolveProjectPath(projectPath);
+    const sessionsById = new Map();
+    const projectSessionsDir = (0, config_dir_1.getProjectSessionsDir)(canonicalProjectPath);
+    if ((0, fs_1.existsSync)(projectSessionsDir)) {
+        const files = (0, fs_1.readdirSync)(projectSessionsDir).filter(isSessionMetaFile);
+        for (const file of files) {
+            const rawSession = parseSessionMetaFile((0, path_1.join)(projectSessionsDir, file));
+            if (rawSession) {
+                upsertNewestSession(sessionsById, normalizeSessionMeta(rawSession));
+            }
+        }
+    }
+    const sessions = sortSessionsNewestFirst(Array.from(sessionsById.values()));
+    return limit ? sessions.slice(0, limit) : sessions;
+}
+/**
+ * Find a session by full id, id prefix, or exact name. Project sessions are
+ * searched by default; pass allProjects when the user explicitly asks.
+ */
+function findSession(ref, projectPath, options = {}) {
+    const result = lookupSessionRef(ref, projectPath, options);
+    return result.status === 'found' ? result.session : null;
+}
+/**
+ * Resolve a session reference and preserve ambiguity details for user-facing
+ * conflict prompts.
+ */
+function lookupSessionRef(ref, projectPath, options = {}) {
+    const query = ref.trim();
+    if (!query)
+        return { status: 'not_found' };
+    const candidates = options.allProjects || !projectPath ? listSessions() : listProjectSessions(projectPath);
+    const exactId = candidates.find(session => session.id === query);
+    if (exactId)
+        return { status: 'found', session: exactId };
+    const exactNameMatches = candidates.filter(session => session.name === query);
+    if (exactNameMatches.length === 1) {
+        return { status: 'found', session: exactNameMatches[0] };
+    }
+    if (exactNameMatches.length > 1) {
+        return { status: 'ambiguous', matches: exactNameMatches };
+    }
+    const prefixMatches = candidates.filter(session => session.id.startsWith(query) || session.name?.startsWith(query));
+    if (prefixMatches.length === 1) {
+        return { status: 'found', session: prefixMatches[0] };
+    }
+    if (prefixMatches.length > 1) {
+        return { status: 'ambiguous', matches: prefixMatches };
+    }
+    return { status: 'not_found' };
+}
+/**
+ * Rename a session for easier picker/resume targeting.
+ */
+function renameSession(sessionId, name) {
+    const session = loadSessionMeta(sessionId);
+    if (!session)
+        return null;
+    const trimmed = name.trim();
+    session.name = trimmed || undefined;
+    session.updatedAt = Date.now();
+    session.updatedAtIso = new Date(session.updatedAt).toISOString();
+    saveSessionMeta(session);
+    return session;
+}
+/**
+ * 删除会话
+ */
+function deleteSession(sessionId) {
+    const session = loadSessionMeta(sessionId);
+    if (!session)
+        return false;
+    let deleted = false;
+    const paths = [
+        (0, config_dir_1.getProjectSessionMetaPath)(session.projectPath, sessionId),
+        (0, config_dir_1.getProjectSessionMessagesPath)(session.projectPath, sessionId),
+        (0, config_dir_1.getProjectSessionHarnessPath)(session.projectPath, sessionId),
+        (0, config_dir_1.getProjectSessionCompactPath)(session.projectPath, sessionId),
+        (0, config_dir_1.getProjectSessionTracePath)(session.projectPath, sessionId),
+    ];
+    // v0.2.24: also delete goal sidecar.
+    const goalPath = (0, path_1.join)((0, config_dir_1.getProjectSessionsDir)(session.projectPath), `${sessionId}.goal.json`);
+    if ((0, fs_1.existsSync)(goalPath)) {
+        try {
+            (0, fs_1.unlinkSync)(goalPath);
+            deleted = true;
+        }
+        catch { /* ok */ }
+    }
+    (0, session_index_1.deleteSessionIndex)(sessionId, session.projectPath);
+    for (const path of uniquePaths(paths)) {
+        if ((0, fs_1.existsSync)(path)) {
+            (0, fs_1.unlinkSync)(path);
+            deleted = true;
+        }
+    }
+    return deleted;
+}
+//# sourceMappingURL=session-storage.js.map