axon-code 2.4.0

package/dist/context/session-memory.js

@@ -0,0 +1,542 @@
+/**
+ * Session Memory 模块
+ *
+ * 实现官方的 session-memory 功能
+ * 将对话摘要写入 ~/.axon/projects/{sanitized-project-path}/{session-id}/session-memory/summary.md
+ *
+ * 基于官方源码实现，feature flag 写死为启用
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { estimateTokens } from '../utils/token-estimate.js';
+// ============================================================================
+// 路径函数
+// ============================================================================
+/**
+ * 获取项目基础目录
+ * 官方: QV(o1()) -> ~/.axon/projects/{sanitized-project-path}
+ */
+function getProjectBaseDir(projectPath) {
+    const claudeDir = process.env.AXON_CONFIG_DIR || path.join(os.homedir(), '.axon');
+    const sanitizedPath = sanitizeProjectPath(projectPath);
+    return path.join(claudeDir, 'projects', sanitizedPath);
+}
+/**
+ * 清理项目路径用于目录名
+ * 将路径中的特殊字符替换为安全字符
+ */
+function sanitizeProjectPath(projectPath) {
+    // 移除驱动器号（Windows）
+    let sanitized = projectPath.replace(/^[a-zA-Z]:/, '');
+    // 替换路径分隔符和特殊字符
+    sanitized = sanitized.replace(/[\\/:*?"<>|]/g, '-');
+    // 移除开头和结尾的连字符
+    sanitized = sanitized.replace(/^-+|-+$/g, '');
+    // 限制长度
+    if (sanitized.length > 100) {
+        sanitized = sanitized.substring(0, 100);
+    }
+    return sanitized || 'default';
+}
+/**
+ * 获取 session memory 目录
+ * 官方: lz1() -> ~/.axon/projects/{path}/{session-id}/session-memory/
+ */
+export function getSessionMemoryDir(projectPath, sessionId) {
+    return path.join(getProjectBaseDir(projectPath), sessionId, 'session-memory');
+}
+/**
+ * 获取 summary.md 文件路径
+ * 官方: VhA() -> ~/.axon/projects/{path}/{session-id}/session-memory/summary.md
+ */
+export function getSummaryPath(projectPath, sessionId) {
+    return path.join(getSessionMemoryDir(projectPath, sessionId), 'summary.md');
+}
+// ============================================================================
+// Session Memory 模板
+// ============================================================================
+/**
+ * 默认的 session memory 模板
+ * 官方: w97
+ */
+export const SESSION_MEMORY_TEMPLATE = `
+# Session Title
+_A short and distinctive 5-10 word descriptive title for the session. Super info dense, no filler_
+
+# Current State
+_What is actively being worked on right now? Pending tasks not yet completed. Immediate next steps._
+
+# Task specification
+_What did the user ask to build? Any design decisions or other explanatory context_
+
+# Files and Functions
+_What are the important files? In short, what do they contain and why are they relevant?_
+
+# Workflow
+_What bash commands are usually run and in what order? How to interpret their output if not obvious?_
+
+# Errors & Corrections
+_Errors encountered and how they were fixed. What did the user correct? What approaches failed and should not be tried again?_
+
+# Codebase and System Documentation
+_What are the important system components? How do they work/fit together?_
+
+# Learnings
+_What has worked well? What has not? What to avoid? Do not duplicate items from other sections_
+
+# Key results
+_If the user asked a specific output such as an answer to a question, a table, or other document, repeat the exact result here_
+
+# Worklog
+_Step by step, what was attempted, done? Very terse summary for each step_
+`.trim();
+/**
+ * 每个章节的最大 token 数
+ * 官方: Ls2 = 2000
+ */
+export const MAX_SECTION_TOKENS = 2000;
+// ============================================================================
+// Session Memory 更新提示词
+// ============================================================================
+/**
+ * 获取 session memory 更新提示词
+ * 官方: L97() / O97()
+ *
+ * @param currentNotes 当前的 notes 内容
+ * @param notesPath summary.md 文件路径
+ * @returns 更新提示词
+ */
+export function getUpdatePrompt(currentNotes, notesPath) {
+    const sectionWarnings = getSectionWarnings(currentNotes);
+    return `IMPORTANT: This message and these instructions are NOT part of the actual user conversation. Do NOT include any references to "note-taking", "session notes extraction", or these update instructions in the notes content.
+
+Based on the user conversation above (EXCLUDING this note-taking instruction message as well as system prompt, claude.md entries, or any past session summaries), update the session notes file.
+
+The file ${notesPath} has already been read for you. Here are its current contents:
+<current_notes_content>
+${currentNotes}
+</current_notes_content>
+
+Your ONLY task is to use the Edit tool to update the notes file, then stop. You can make multiple edits (update every section as needed) - make all Edit tool calls in parallel in a single message. Do not call any other tools.
+
+CRITICAL RULES FOR EDITING:
+- The file must maintain its exact structure with all sections, headers, and italic descriptions intact
+-- NEVER modify, delete, or add section headers (the lines starting with '#' like # Task specification)
+-- NEVER modify or delete the italic _section description_ lines (these are the lines in italics immediately following each header - they start and end with underscores)
+-- The italic _section descriptions_ are TEMPLATE INSTRUCTIONS that must be preserved exactly as-is - they guide what content belongs in each section
+-- ONLY update the actual content that appears BELOW the italic _section descriptions_ within each existing section
+-- Do NOT add any new sections, summaries, or information outside the existing structure
+- Do NOT reference this note-taking process or instructions anywhere in the notes
+- It's OK to skip updating a section if there are no substantial new insights to add. Do not add filler content like "No info yet", just leave sections blank/unedited if appropriate.
+- Write DETAILED, INFO-DENSE content for each section - include specifics like file paths, function names, error messages, exact commands, technical details, etc.
+- For "Key results", include the complete, exact output the user requested (e.g., full table, full answer, etc.)
+- Do not include information that's already in the AXON.md files included in the context
+- Keep each section under ~${MAX_SECTION_TOKENS} tokens/words - if a section is approaching this limit, condense it by cycling out less important details while preserving the most critical information
+- Focus on actionable, specific information that would help someone understand or recreate the work discussed in the conversation
+- IMPORTANT: Always update "Current State" to reflect the most recent work - this is critical for continuity after compaction
+
+Use the Edit tool with file_path: ${notesPath}
+
+STRUCTURE PRESERVATION REMINDER:
+Each section has TWO parts that must be preserved exactly as they appear in the current file:
+1. The section header (line starting with #)
+2. The italic description line (the _italicized text_ immediately after the header - this is a template instruction)
+
+You ONLY update the actual content that comes AFTER these two preserved lines. The italic description lines starting and ending with underscores are part of the template structure, NOT content to be edited or removed.
+
+REMEMBER: Use the Edit tool in parallel and stop. Do not continue after the edits. Only include insights from the actual user conversation, never from these note-taking instructions. Do not delete or change section headers or italic _section descriptions_.${sectionWarnings}`;
+}
+/**
+ * 获取章节长度警告
+ * 官方: R97()
+ */
+function getSectionWarnings(content) {
+    const sectionTokens = estimateSectionTokens(content);
+    const warnings = Object.entries(sectionTokens)
+        .filter(([_, tokens]) => tokens > MAX_SECTION_TOKENS)
+        .map(([section, tokens]) => `- The "${section}" section is currently ~${tokens} tokens and growing long. Consider condensing it a bit while keeping all important details.`);
+    if (warnings.length === 0)
+        return '';
+    return '\n\n' + warnings.join('\n');
+}
+/**
+ * 估算每个章节的 token 数
+ * 官方: M97()
+ */
+function estimateSectionTokens(content) {
+    const sections = {};
+    const lines = content.split('\n');
+    let currentSection = '';
+    let sectionContent = [];
+    for (const line of lines) {
+        if (line.startsWith('# ')) {
+            if (currentSection && sectionContent.length > 0) {
+                const text = sectionContent.join('\n').trim();
+                sections[currentSection] = estimateTokens(text);
+            }
+            currentSection = line;
+            sectionContent = [];
+        }
+        else {
+            sectionContent.push(line);
+        }
+    }
+    // 处理最后一个章节
+    if (currentSection && sectionContent.length > 0) {
+        const text = sectionContent.join('\n').trim();
+        sections[currentSection] = estimateTokens(text);
+    }
+    return sections;
+}
+// ============================================================================
+// Session Memory 读写函数
+// ============================================================================
+/**
+ * 确保目录存在
+ */
+function ensureDir(dirPath) {
+    if (!fs.existsSync(dirPath)) {
+        fs.mkdirSync(dirPath, { recursive: true, mode: 0o700 });
+    }
+}
+/**
+ * 初始化 session memory 文件
+ * 如果不存在则创建模板文件
+ *
+ * @param projectPath 项目路径
+ * @param sessionId 会话 ID
+ * @returns 是否成功初始化
+ */
+export function initSessionMemory(projectPath, sessionId) {
+    try {
+        const summaryPath = getSummaryPath(projectPath, sessionId);
+        // 如果文件已存在，不需要初始化
+        if (fs.existsSync(summaryPath)) {
+            return true;
+        }
+        // 确保目录存在
+        const dir = path.dirname(summaryPath);
+        ensureDir(dir);
+        // 尝试加载自定义模板
+        const template = loadTemplate(projectPath) || SESSION_MEMORY_TEMPLATE;
+        // 写入模板
+        fs.writeFileSync(summaryPath, template, { encoding: 'utf-8', mode: 0o600 });
+        console.log(`[SessionMemory] Initialized session memory: ${summaryPath}`);
+        return true;
+    }
+    catch (error) {
+        console.error('[SessionMemory] Initialization failed:', error);
+        return false;
+    }
+}
+/**
+ * 读取 session memory 内容
+ * 官方: Ks2()
+ *
+ * @param projectPath 项目路径
+ * @param sessionId 会话 ID
+ * @returns 内容或 null
+ */
+export function readSessionMemory(projectPath, sessionId) {
+    try {
+        const summaryPath = getSummaryPath(projectPath, sessionId);
+        if (!fs.existsSync(summaryPath)) {
+            return null;
+        }
+        return fs.readFileSync(summaryPath, { encoding: 'utf-8' });
+    }
+    catch (error) {
+        console.error('[SessionMemory] Read failed:', error);
+        return null;
+    }
+}
+/**
+ * 写入 session memory 内容
+ *
+ * @param projectPath 项目路径
+ * @param sessionId 会话 ID
+ * @param content 内容
+ * @returns 是否成功
+ */
+export function writeSessionMemory(projectPath, sessionId, content) {
+    try {
+        const summaryPath = getSummaryPath(projectPath, sessionId);
+        const dir = path.dirname(summaryPath);
+        ensureDir(dir);
+        fs.writeFileSync(summaryPath, content, { encoding: 'utf-8', mode: 0o600 });
+        return true;
+    }
+    catch (error) {
+        console.error('[SessionMemory] Write failed:', error);
+        return false;
+    }
+}
+/**
+ * 加载自定义模板
+ * 官方: vL0()
+ *
+ * @param projectPath 项目路径
+ * @returns 自定义模板或 null
+ */
+function loadTemplate(projectPath) {
+    try {
+        const claudeDir = process.env.AXON_CONFIG_DIR || path.join(os.homedir(), '.axon');
+        const customTemplatePath = path.join(claudeDir, 'session-memory', 'config', 'template.md');
+        if (fs.existsSync(customTemplatePath)) {
+            return fs.readFileSync(customTemplatePath, { encoding: 'utf-8' });
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 检查 session memory 是否为空模板
+ * 官方: Os2()
+ *
+ * @param content session memory 内容
+ * @returns 是否为空模板
+ */
+export function isEmptyTemplate(content) {
+    const template = SESSION_MEMORY_TEMPLATE;
+    return content.trim() === template.trim();
+}
+// ============================================================================
+// Session Memory 列表函数
+// ============================================================================
+/**
+ * 获取所有 session memory 文件
+ * 官方: Wq7()
+ *
+ * @param projectPath 项目路径
+ * @param sinceTime 可选，只返回此时间之后修改的文件
+ * @returns session memory 文件路径列表（按修改时间倒序）
+ */
+export function listSessionMemories(projectPath, sinceTime) {
+    try {
+        const projectDir = getProjectBaseDir(projectPath);
+        if (!fs.existsSync(projectDir)) {
+            return [];
+        }
+        const minTime = sinceTime ? sinceTime.getTime() : 0;
+        const results = [];
+        const entries = fs.readdirSync(projectDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const summaryPath = path.join(projectDir, entry.name, 'session-memory', 'summary.md');
+            try {
+                const stat = fs.statSync(summaryPath);
+                if (stat.mtimeMs > minTime) {
+                    results.push({
+                        id: entry.name,
+                        mtime: stat.mtimeMs,
+                        path: summaryPath,
+                    });
+                }
+            }
+            catch {
+                // 文件不存在，跳过
+            }
+        }
+        // 按修改时间倒序排列
+        results.sort((a, b) => b.mtime - a.mtime);
+        return results;
+    }
+    catch {
+        return [];
+    }
+}
+// ============================================================================
+// Feature Flag 函数（写死为启用）
+// ============================================================================
+/**
+ * 检查 session memory 是否启用
+ * 官方: rF1() - 写死为 true
+ *
+ * @returns 始终返回 true
+ */
+export function isSessionMemoryEnabled() {
+    // 官方检查 ROA("tengu_session_memory") && ROA("tengu_sm_compact")
+    // 我们直接写死为 true
+    return true;
+}
+/**
+ * 默认配置
+ * 官方: oF1
+ */
+export const DEFAULT_SESSION_MEMORY_CONFIG = {
+    minTokens: 10000,
+    minTextBlockMessages: 5,
+    maxTokens: 40000,
+};
+/**
+ * 默认更新配置
+ * 官方: WhA
+ */
+export const DEFAULT_UPDATE_CONFIG = {
+    minimumMessageTokensToInit: 10000,
+    minimumTokensBetweenUpdate: 5000,
+    toolCallsBetweenUpdates: 3,
+};
+/** 默认 key（CLI 单会话模式） */
+const DEFAULT_SESSION_KEY = '__default__';
+/** 按 sessionId 隔离的状态存储 */
+const stateMap = new Map();
+/** 创建初始状态 */
+function createInitialState() {
+    return {
+        lastCompactedUuid: undefined,
+        isWriting: false,
+        totalInputTokens: 0,
+        totalMessageTokens: 0,
+        lastUpdateTokens: 0,
+        isInitialized: false,
+    };
+}
+/** 获取指定会话的状态，不存在则创建 */
+function getState(sessionId) {
+    const key = sessionId || DEFAULT_SESSION_KEY;
+    let state = stateMap.get(key);
+    if (!state) {
+        state = createInitialState();
+        stateMap.set(key, state);
+    }
+    return state;
+}
+/**
+ * 获取上次压缩的 UUID
+ * 官方: Xs2()
+ */
+export function getLastCompactedUuid(sessionId) {
+    return getState(sessionId).lastCompactedUuid;
+}
+/**
+ * 设置上次压缩的 UUID
+ * 官方: oEA()
+ */
+export function setLastCompactedUuid(uuid, sessionId) {
+    getState(sessionId).lastCompactedUuid = uuid;
+}
+/**
+ * 标记开始写入
+ * 官方: Is2()
+ */
+export function markWriteStart(sessionId) {
+    getState(sessionId).isWriting = true;
+}
+/**
+ * 标记写入结束
+ * 官方: Ds2()
+ */
+export function markWriteEnd(sessionId) {
+    getState(sessionId).isWriting = false;
+}
+/**
+ * 等待写入完成
+ * 官方: Ws2()
+ */
+export async function waitForWrite(timeout = 15000, sessionId) {
+    const state = getState(sessionId);
+    const startTime = Date.now();
+    const maxWait = 60000;
+    while (state.isWriting) {
+        if (Date.now() - startTime > maxWait)
+            return;
+        if (Date.now() - startTime > timeout)
+            return;
+        await new Promise(resolve => setTimeout(resolve, 1000));
+    }
+}
+/**
+ * 增加输入 token 数
+ * 官方: Hs2()
+ */
+export function addInputTokens(tokens, sessionId) {
+    getState(sessionId).totalInputTokens += tokens;
+}
+/**
+ * 增加消息 token 数
+ * 官方: Es2()
+ */
+export function addMessageTokens(tokens, sessionId) {
+    getState(sessionId).totalMessageTokens += tokens;
+}
+/**
+ * 记录上次更新的 token 数
+ * 官方: zs2()
+ */
+export function recordUpdateTokens(sessionId) {
+    const state = getState(sessionId);
+    state.lastUpdateTokens = state.totalInputTokens;
+}
+/**
+ * 检查是否已初始化
+ * 官方: $s2()
+ */
+export function isInitialized(sessionId) {
+    return getState(sessionId).isInitialized;
+}
+/**
+ * 标记已初始化
+ * 官方: Cs2()
+ */
+export function markInitialized(sessionId) {
+    getState(sessionId).isInitialized = true;
+}
+/**
+ * 检查是否应该初始化
+ * 官方: Us2()
+ */
+export function shouldInit(config = DEFAULT_UPDATE_CONFIG, sessionId) {
+    return getState(sessionId).totalMessageTokens >= config.minimumMessageTokensToInit;
+}
+/**
+ * 检查是否应该更新
+ * 官方: qs2()
+ */
+export function shouldUpdate(config = DEFAULT_UPDATE_CONFIG, sessionId) {
+    const state = getState(sessionId);
+    return state.totalInputTokens - state.lastUpdateTokens >= config.minimumTokensBetweenUpdate;
+}
+/**
+ * 重置指定会话的状态
+ */
+export function resetState(sessionId) {
+    const key = sessionId || DEFAULT_SESSION_KEY;
+    stateMap.delete(key);
+}
+/**
+ * 清除所有会话状态（用于测试）
+ */
+export function resetAllStates() {
+    stateMap.clear();
+}
+// ============================================================================
+// 格式化 Session Memory 用于显示
+// ============================================================================
+/**
+ * 格式化 session memory 用于系统提示
+ * 官方: u51()
+ *
+ * @param content session memory 内容
+ * @param isCompact 是否为 compact 模式
+ * @param notesPath summary.md 路径
+ * @param includeReadPrompt 是否包含读取提示
+ * @returns 格式化后的内容
+ */
+export function formatForSystemPrompt(content, isCompact = false, notesPath, includeReadPrompt = false) {
+    const lines = [
+        '<session-notes>',
+        content,
+        '</session-notes>',
+    ];
+    if (isCompact && notesPath && includeReadPrompt) {
+        lines.push('');
+        lines.push(`To read the full session notes, use: Read tool with path "${notesPath}"`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=session-memory.js.map

package/dist/context/session-memory.js.map

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

package/dist/context/summarizer.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 智能摘要生成器
+ * 使用 Claude API 生成对话摘要
+ *
+ * 基于官方源码 cli.js fW7() 函数实现
+ */
+import type { Message } from '../types/index.js';
+import type { ConversationTurn, TokenUsage } from './index.js';
+/**
+ * Claude API 客户端接口（避免循环依赖）
+ */
+export interface SummarizerClient {
+    createMessage(messages: Message[], tools?: any[], systemPrompt?: string, options?: any): Promise<{
+        content: any[];
+        usage?: TokenUsage;
+    }>;
+}
+/**
+ * 使用 Claude API 生成智能摘要
+ *
+ * @param turns 对话轮次数组
+ * @param client Claude API 客户端
+ * @param contextBudget 可用的上下文预算（tokens）
+ * @returns 生成的摘要文本
+ */
+export declare function generateAISummary(turns: ConversationTurn[], client: SummarizerClient, contextBudget: number): Promise<string>;
+//# sourceMappingURL=summarizer.d.ts.map

package/dist/context/summarizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarizer.d.ts","sourceRoot":"","sources":["../../src/context/summarizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAO/D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CACX,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,CAAC,EAAE,GAAG,EAAE,EACb,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,GAAG,GACZ,OAAO,CAAC;QACT,OAAO,EAAE,GAAG,EAAE,CAAC;QACf,KAAK,CAAC,EAAE,UAAU,CAAC;KACpB,CAAC,CAAC;CACJ;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,gBAAgB,EAAE,EACzB,MAAM,EAAE,gBAAgB,EACxB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAkDjB"}