openhorse 0.1.5

package/dist/services/llm.js

@@ -0,0 +1,376 @@
+"use strict";
+/**
+ * openhorse - LLM 服务层
+ *
+ * 封装 OpenAI 兼容 API，支持流式和非流式调用。
+ * 兼容 OpenAI、Claude (via proxy)、本地 Ollama 等。
+ * 支持工具调用（function calling）和 agentic 循环。
+ * 支持重试机制和 fallback model。
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMService = exports.FallbackTriggeredError = void 0;
+const openai_1 = __importDefault(require("openai"));
+/** Fallback 触发错误 */
+class FallbackTriggeredError extends Error {
+    constructor(originalModel, fallbackModel) {
+        super(`Fallback triggered: ${originalModel} -> ${fallbackModel}`);
+        this.originalModel = originalModel;
+        this.fallbackModel = fallbackModel;
+        this.name = 'FallbackTriggeredError';
+    }
+}
+exports.FallbackTriggeredError = FallbackTriggeredError;
+// ============================================================================
+// 重试机制
+// ============================================================================
+/** 默认重试配置 */
+const DEFAULT_RETRY_CONFIG = {
+    maxRetries: 3,
+    baseDelayMs: 500,
+    maxDelayMs: 10000,
+};
+/** 529 错误最大重试次数（触发 fallback） */
+const MAX_529_RETRIES = 3;
+/** 判断错误是否可重试 */
+function isRetryableError(error) {
+    if (!error)
+        return false;
+    if (error instanceof openai_1.default.APIError) {
+        const status = error.status;
+        return status === 429 || status === 500 || status === 502 || status === 503 || status === 504 || status === 529;
+    }
+    if (error instanceof Error) {
+        const msg = error.message.toLowerCase();
+        return msg.includes('timeout') || msg.includes('connection') || msg.includes('econnreset') || msg.includes('epipe');
+    }
+    return false;
+}
+/** 判断是否为 529 错误 */
+function is529Error(error) {
+    return error instanceof openai_1.default.APIError && error.status === 529;
+}
+/** 从错误中提取 retry-after 时间 */
+function getRetryAfterMs(error) {
+    if (error instanceof openai_1.default.APIError && error.headers) {
+        const headers = error.headers;
+        let retryAfter = null;
+        // headers may be Headers object or plain object
+        if (headers && typeof headers === 'object') {
+            if ('get' in headers && typeof headers.get === 'function') {
+                retryAfter = headers.get('retry-after');
+            }
+            else if ('retry-after' in headers) {
+                retryAfter = headers['retry-after'];
+            }
+        }
+        if (retryAfter) {
+            const seconds = parseInt(retryAfter, 10);
+            if (!isNaN(seconds))
+                return seconds * 1000;
+        }
+    }
+    return null;
+}
+/** 指数退避计算 */
+function exponentialBackoff(attempt, baseDelayMs, maxDelayMs) {
+    const delay = baseDelayMs * Math.pow(2, attempt - 1);
+    return maxDelayMs ? Math.min(delay, maxDelayMs) : delay;
+}
+/** Sleep 函数 */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/** 带重试的操作 */
+async function withRetry(operation, config) {
+    let lastError;
+    for (let attempt = 1; attempt <= config.maxRetries + 1; attempt++) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            if (!isRetryableError(error)) {
+                throw lastError;
+            }
+            if (attempt > config.maxRetries) {
+                throw lastError;
+            }
+            let delayMs = exponentialBackoff(attempt, config.baseDelayMs, config.maxDelayMs);
+            const retryAfter = getRetryAfterMs(error);
+            if (retryAfter !== null) {
+                delayMs = retryAfter;
+            }
+            config.onRetry?.(attempt, lastError, delayMs);
+            await sleep(delayMs);
+        }
+    }
+    throw lastError ?? new Error('Unknown error');
+}
+// ============================================================================
+// LLMService
+// ============================================================================
+class LLMService {
+    constructor(config) {
+        this.consecutive529Errors = 0;
+        this.usingFallback = false;
+        this.client = new openai_1.default({
+            apiKey: config.apiKey,
+            baseURL: config.baseUrl,
+            timeout: config.timeout ?? 60000,
+            dangerouslyAllowBrowser: true,
+        });
+        this.config = {
+            model: config.model,
+            fallbackModel: config.fallbackModel ?? '',
+            maxTokens: config.maxTokens ?? 4096,
+            temperature: config.temperature ?? 0.7,
+            timeout: config.timeout ?? 60000,
+            maxRetries: config.maxRetries ?? DEFAULT_RETRY_CONFIG.maxRetries,
+            retryBaseDelay: config.retryBaseDelay ?? DEFAULT_RETRY_CONFIG.baseDelayMs,
+        };
+    }
+    /** 是否正在使用 fallback model */
+    isUsingFallback() {
+        return this.usingFallback;
+    }
+    /** 触发 fallback */
+    triggerFallback() {
+        if (this.config.fallbackModel && !this.usingFallback) {
+            this.usingFallback = true;
+            this.config.model = this.config.fallbackModel;
+            this.consecutive529Errors = 0;
+        }
+    }
+    /** 重置为原始 model */
+    resetToPrimary() {
+        this.usingFallback = false;
+        this.consecutive529Errors = 0;
+    }
+    /**
+     * 非流式对话
+     */
+    async chat(messages, tools) {
+        const params = {
+            model: this.config.model,
+            messages: this.toOpenAIMessages(messages),
+            max_tokens: this.config.maxTokens,
+            temperature: this.config.temperature,
+        };
+        if (tools && tools.length > 0) {
+            params.tools = tools;
+        }
+        const response = await this.client.chat.completions.create(params);
+        const message = response.choices?.[0]?.message;
+        const content = message?.content ?? '';
+        const toolCalls = message?.tool_calls?.map(tc => ({
+            id: tc.id,
+            type: 'function',
+            function: {
+                name: tc.function.name,
+                arguments: tc.function.arguments,
+            },
+        }));
+        const usage = response.usage
+            ? {
+                promptTokens: response.usage.prompt_tokens,
+                completionTokens: response.usage.completion_tokens,
+            }
+            : undefined;
+        return {
+            content,
+            usage,
+            model: response.model,
+            toolCalls,
+        };
+    }
+    /**
+     * 流式对话（带重试）
+     */
+    async chatStream(messages, callbacks, tools) {
+        const onChunk = typeof callbacks === 'function' ? callbacks : callbacks?.onChunk;
+        const onThinking = typeof callbacks === 'object' ? callbacks?.onThinking : undefined;
+        const retryConfig = {
+            maxRetries: this.config.maxRetries,
+            baseDelayMs: this.config.retryBaseDelay,
+            maxDelayMs: 10000,
+            onRetry: (_attempt, error, _delayMs) => {
+                // 529 错误计数
+                if (is529Error(error)) {
+                    this.consecutive529Errors++;
+                    if (this.consecutive529Errors >= MAX_529_RETRIES && this.config.fallbackModel) {
+                        this.triggerFallback();
+                    }
+                }
+            },
+        };
+        return withRetry(async () => {
+            const params = {
+                model: this.config.model,
+                messages: this.toOpenAIMessages(messages),
+                max_tokens: this.config.maxTokens,
+                temperature: this.config.temperature,
+                stream: true,
+                stream_options: { include_usage: true },
+            };
+            if (tools && tools.length > 0) {
+                params.tools = tools;
+            }
+            onThinking?.();
+            const stream = await this.client.chat.completions.create(params);
+            let content = '';
+            let usedModel = this.config.model;
+            let usage;
+            const toolCallsMap = new Map();
+            for await (const chunk of stream) {
+                const delta = chunk.choices?.[0]?.delta;
+                const text = delta?.content ?? '';
+                if (text) {
+                    content += text;
+                    onChunk?.(text);
+                }
+                const tc = delta?.tool_calls?.[0];
+                if (tc?.id) {
+                    toolCallsMap.set(tc.index ?? 0, {
+                        id: tc.id,
+                        type: 'function',
+                        function: { name: tc.function?.name ?? '', arguments: '' },
+                    });
+                }
+                else if (tc?.function?.arguments) {
+                    const entry = toolCallsMap.get(tc.index ?? 0);
+                    if (entry) {
+                        entry.function.arguments += tc.function.arguments;
+                    }
+                }
+                if (chunk.usage) {
+                    usage = {
+                        promptTokens: chunk.usage.prompt_tokens ?? 0,
+                        completionTokens: chunk.usage.completion_tokens ?? 0,
+                    };
+                }
+                if (chunk.model) {
+                    usedModel = chunk.model;
+                }
+            }
+            const toolCalls = Array.from(toolCallsMap.values());
+            for (const tc of toolCalls) {
+                if (!tc.function.arguments || tc.function.arguments.trim() === '') {
+                    tc.function.arguments = '{}';
+                }
+                else {
+                    try {
+                        const parsed = JSON.parse(tc.function.arguments);
+                        tc.function.arguments = JSON.stringify(parsed);
+                    }
+                    catch {
+                        tc.function.arguments = '{}';
+                    }
+                }
+            }
+            return {
+                content,
+                model: usedModel,
+                usage,
+                toolCalls: toolCalls.length > 0 ? toolCalls : undefined,
+            };
+        }, retryConfig);
+    }
+    /**
+     * 带工具调用的 agentic 循环
+     */
+    async chatWithTools(messages, tools, toolExecutor, callbacks, maxIterations = 10) {
+        let iteration = 0;
+        while (iteration < maxIterations) {
+            iteration++;
+            const response = await this.chatStream(messages, {
+                onChunk: callbacks?.onChunk,
+                onThinking: iteration === 1 ? callbacks?.onThinking : undefined,
+            }, tools);
+            const assistantMsg = {
+                role: 'assistant',
+                content: response.content,
+            };
+            if (response.toolCalls) {
+                assistantMsg.tool_calls = response.toolCalls;
+            }
+            messages.push(assistantMsg);
+            if (response.toolCalls && response.toolCalls.length > 0) {
+                for (const tc of response.toolCalls) {
+                    const result = await toolExecutor(tc.function.name, JSON.parse(tc.function.arguments));
+                    messages.push({
+                        role: 'tool',
+                        content: result,
+                        tool_call_id: tc.id,
+                    });
+                }
+                continue;
+            }
+            return response;
+        }
+        return {
+            content: '达到了最大执行步数限制，未能完成。请简化任务。',
+            model: this.config.model,
+        };
+    }
+    /**
+     * 切换模型
+     */
+    setModel(model) {
+        this.config.model = model;
+    }
+    /**
+     * 获取当前模型
+     */
+    getModel() {
+        return this.config.model;
+    }
+    /**
+     * 获取当前配置摘要
+     */
+    getConfigSummary() {
+        return {
+            model: this.config.model,
+            fallback: this.config.fallbackModel || '(none)',
+            maxTokens: String(this.config.maxTokens),
+            temperature: String(this.config.temperature),
+            timeout: String(this.config.timeout),
+            maxRetries: String(this.config.maxRetries),
+        };
+    }
+    // ---- Internal ----
+    /** 转换为 OpenAI SDK 消息格式 */
+    toOpenAIMessages(messages) {
+        return messages.map(msg => {
+            if (msg.role === 'tool') {
+                return {
+                    role: 'tool',
+                    content: msg.content,
+                    tool_call_id: msg.tool_call_id ?? '',
+                };
+            }
+            if (msg.tool_calls && msg.tool_calls.length > 0) {
+                return {
+                    role: 'assistant',
+                    content: msg.content,
+                    tool_calls: msg.tool_calls.map(tc => ({
+                        id: tc.id,
+                        type: 'function',
+                        function: {
+                            name: tc.function.name,
+                            arguments: tc.function.arguments,
+                        },
+                    })),
+                };
+            }
+            return {
+                role: msg.role,
+                content: msg.content,
+            };
+        });
+    }
+}
+exports.LLMService = LLMService;
+//# sourceMappingURL=llm.js.map

package/dist/services/llm.js.map

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

package/dist/services/memory.d.ts

@@ -0,0 +1,39 @@
+/**
+ * openhorse - Memory 文件加载
+ *
+ * Memory 层级：Local > Project > User
+ * 后加载覆盖前加载。
+ */
+import { MemoryType } from './config-dir';
+/** Memory 内容 */
+export interface MemoryContent {
+    /** Memory 类型 */
+    type: MemoryType;
+    /** 文件路径 */
+    path: string;
+    /** 内容文本 */
+    content: string;
+}
+/**
+ * 加载单个 Memory 文件
+ */
+export declare function loadMemoryFile(type: MemoryType, cwd?: string): MemoryContent | null;
+/**
+ * 加载所有存在的 Memory 文件
+ * 按 Local > Project > User 顺序返回
+ */
+export declare function loadAllMemory(cwd?: string): MemoryContent[];
+/**
+ * 合并所有 Memory 内容
+ * Local 覆盖 Project，Project 覆盖 User
+ */
+export declare function mergeMemoryContent(cwd?: string): string;
+/**
+ * 获取 Memory 摘要（用于显示）
+ */
+export declare function getMemorySummary(cwd?: string): string[];
+/**
+ * 将 Memory 内容附加到系统 Prompt
+ */
+export declare function augmentSystemPrompt(basePrompt: string, cwd?: string): string;
+//# sourceMappingURL=memory.d.ts.map

package/dist/services/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/services/memory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAyC,UAAU,EAAE,MAAM,cAAc,CAAC;AAMjF,gBAAgB;AAChB,MAAM,WAAW,aAAa;IAC5B,gBAAgB;IAChB,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAanF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CAY3D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CASvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAGvD;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAa5E"}

package/dist/services/memory.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * openhorse - Memory 文件加载
+ *
+ * Memory 层级：Local > Project > User
+ * 后加载覆盖前加载。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadMemoryFile = loadMemoryFile;
+exports.loadAllMemory = loadAllMemory;
+exports.mergeMemoryContent = mergeMemoryContent;
+exports.getMemorySummary = getMemorySummary;
+exports.augmentSystemPrompt = augmentSystemPrompt;
+const fs_1 = require("fs");
+const config_dir_1 = require("./config-dir");
+// ============================================================================
+// 加载 Memory
+// ============================================================================
+/**
+ * 加载单个 Memory 文件
+ */
+function loadMemoryFile(type, cwd) {
+    const path = (0, config_dir_1.getMemoryPath)(type, cwd);
+    if (!(0, fs_1.existsSync)(path)) {
+        return null;
+    }
+    try {
+        const content = (0, fs_1.readFileSync)(path, 'utf-8');
+        return { type, path, content };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 加载所有存在的 Memory 文件
+ * 按 Local > Project > User 顺序返回
+ */
+function loadAllMemory(cwd) {
+    const types = ['Local', 'Project', 'User'];
+    const memories = [];
+    for (const type of types) {
+        const memory = loadMemoryFile(type, cwd);
+        if (memory) {
+            memories.push(memory);
+        }
+    }
+    return memories;
+}
+/**
+ * 合并所有 Memory 内容
+ * Local 覆盖 Project，Project 覆盖 User
+ */
+function mergeMemoryContent(cwd) {
+    const memories = loadAllMemory(cwd);
+    if (memories.length === 0) {
+        return '';
+    }
+    // 按 Local > Project > User 顺序合并
+    // 后面的内容追加到前面
+    return memories.map(m => m.content).join('\n\n---\n\n');
+}
+/**
+ * 获取 Memory 摘要（用于显示）
+ */
+function getMemorySummary(cwd) {
+    const memories = loadAllMemory(cwd);
+    return memories.map(m => `${m.type}: ${m.path}`);
+}
+// ============================================================================
+// 系统 Prompt 集成
+// ============================================================================
+/**
+ * 将 Memory 内容附加到系统 Prompt
+ */
+function augmentSystemPrompt(basePrompt, cwd) {
+    const memoryContent = mergeMemoryContent(cwd);
+    if (!memoryContent) {
+        return basePrompt;
+    }
+    return `${basePrompt}
+
+---
+# Memory (User Context)
+
+${memoryContent}`;
+}
+//# sourceMappingURL=memory.js.map

package/dist/services/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/services/memory.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AA0BH,wCAaC;AAMD,sCAYC;AAMD,gDASC;AAKD,4CAGC;AASD,kDAaC;AApGD,2BAA8C;AAC9C,6CAAiF;AAgBjF,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E;;GAEG;AACH,SAAgB,cAAc,CAAC,IAAgB,EAAE,GAAY;IAC3D,MAAM,IAAI,GAAG,IAAA,0BAAa,EAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAEtC,IAAI,CAAC,IAAA,eAAU,EAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAA,iBAAY,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,GAAY;IACxC,MAAM,KAAK,GAAiB,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAoB,EAAE,CAAC;IAErC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACzC,IAAI,MAAM,EAAE,CAAC;YACX,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,GAAY;IAC7C,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,gCAAgC;IAChC,aAAa;IACb,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,GAAY;IAC3C,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACpC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E;;GAEG;AACH,SAAgB,mBAAmB,CAAC,UAAkB,EAAE,GAAY;IAClE,MAAM,aAAa,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAE9C,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,GAAG,UAAU;;;;;EAKpB,aAAa,EAAE,CAAC;AAClB,CAAC"}

package/dist/services/session-storage.d.ts

@@ -0,0 +1,136 @@
+/**
+ * openhorse - 会话存储
+ *
+ * 使用 JSONL 格式存储会话历史和对话记录。
+ * 参考 OpenClaude 的 history.jsonl 和 sessions/ 目录。
+ */
+import type { Message } from './llm';
+/** 工具调用记录（用于 assistant 消息） */
+export interface ToolCallRecord {
+    /** 调用 ID */
+    id: string;
+    /** 类型 */
+    type: 'function';
+    /** 函数信息 */
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+/** 会话元数据 */
+export interface SessionMeta {
+    /** 会话 ID */
+    id: string;
+    /** 项目路径 */
+    projectPath: string;
+    /** 使用的模型 */
+    model: string;
+    /** 开始时间 (timestamp ms) */
+    startTime: number;
+    /** 结束时间 (timestamp ms) */
+    endTime?: number;
+    /** token 数 */
+    tokenCount: number;
+    /** 成本 (USD) */
+    cost: number;
+    /** 任务摘要 */
+    taskSummary?: string;
+    /** 使用过的工具列表 */
+    toolsUsed?: string[];
+    /** 修改过的文件列表 */
+    filesModified?: string[];
+}
+/** 历史记录条目 */
+export interface HistoryEntry {
+    /** 显示文本 */
+    display: string;
+    /** 时间戳 (ms) */
+    timestamp: number;
+    /** 项目路径 */
+    project: string;
+    /** 会话 ID */
+    sessionId: string;
+    /** 角色 */
+    role: 'user' | 'assistant';
+}
+/** 对话消息 */
+export interface SessionMessage {
+    /** 角色 */
+    role: 'user' | 'assistant' | 'system' | 'tool';
+    /** 内容 */
+    content: string;
+    /** 时间戳 (ms) */
+    timestamp: number;
+    /** 工具调用 ID (tool role) */
+    toolCallId?: string;
+    /** 工具调用列表 (assistant role) */
+    tool_calls?: ToolCallRecord[];
+}
+/**
+ * 创建新会话
+ */
+export declare function createSession(projectPath: string, model: string): SessionMeta;
+/**
+ * 保存会话元数据
+ */
+export declare function saveSessionMeta(session: SessionMeta): void;
+/**
+ * 加载会话元数据
+ */
+export declare function loadSessionMeta(sessionId: string): SessionMeta | null;
+/**
+ * 更新会话统计
+ */
+export declare function updateSessionStats(sessionId: string, tokens: number, cost: number): void;
+/**
+ * 结束会话
+ */
+export declare function endSession(sessionId: string): void;
+/**
+ * 更新会话任务摘要
+ * 从会话消息中提取关键信息并更新元数据
+ */
+export declare function updateSessionSummary(sessionId: string, messages: SessionMessage[]): void;
+/**
+ * 获取项目最近的会话
+ */
+export declare function getLastSession(projectPath: string): SessionMeta | null;
+/**
+ * 追加历史记录
+ */
+export declare function appendHistory(entry: HistoryEntry): void;
+/**
+ * 读取历史记录
+ * @param limit 最大条数（从最新开始）
+ */
+export declare function readHistory(limit?: number): HistoryEntry[];
+/**
+ * 按项目过滤历史记录
+ */
+export declare function readProjectHistory(projectPath: string, limit?: number): HistoryEntry[];
+/**
+ * 追加会话消息
+ */
+export declare function appendSessionMessage(sessionId: string, message: SessionMessage): void;
+/**
+ * 追加多条会话消息
+ */
+export declare function appendSessionMessages(sessionId: string, messages: SessionMessage[]): void;
+/**
+ * 读取会话消息
+ */
+export declare function readSessionMessages(sessionId: string): SessionMessage[];
+/**
+ * 读取会话消息并转换为 Message 格式（用于恢复对话历史）
+ * 包含完整的 tool_calls 信息，确保 LLM 能理解之前的工具调用
+ */
+export declare function loadSessionHistory(sessionId: string): Message[];
+/**
+ * 列出所有会话
+ */
+export declare function listSessions(limit?: number): SessionMeta[];
+/**
+ * 删除会话
+ */
+export declare function deleteSession(sessionId: string): boolean;
+//# sourceMappingURL=session-storage.d.ts.map

package/dist/services/session-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-storage.d.ts","sourceRoot":"","sources":["../../src/services/session-storage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAMrC,8BAA8B;AAC9B,MAAM,WAAW,cAAc;IAC7B,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,SAAS;IACT,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW;IACX,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,YAAY;AACZ,MAAM,WAAW,WAAW;IAC1B,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe;IACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe;IACf,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,aAAa;AACb,MAAM,WAAW,YAAY;IAC3B,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS;IACT,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;CAC5B;AAED,WAAW;AACX,MAAM,WAAW,cAAc;IAC7B,SAAS;IACT,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,SAAS;IACT,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;CAC/B;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAc7E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAI1D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAarE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAOxF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAMlD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,IAAI,CAsCxF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CA2BtE;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAKvD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAkB1D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAItF;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAKrF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,IAAI,CAKzF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE,CAcvE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE,CAoB/D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CAyB1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAiBxD"}