@zooique/memora 0.1.0

package/dist/llm/embedding.js

@@ -0,0 +1,162 @@
+/**
+ * Embedding Provider — 调用 OpenAI 兼容的 /embeddings 端点
+ *
+ * M-206：语义检索的核心能力
+ * - 将文本转为向量（embedding）
+ * - 支持批量嵌入（减少 API 调用次数）
+ * - 向量维度由模型决定（如 text-embedding-3-small: 1536 维）
+ *
+ * 设计原则：
+ * - 复用 OpenAI 兼容协议（与 chat 共用 baseUrl/apiKey）
+ * - 0 新 npm 依赖（纯 fetch 调用）
+ * - 缓存机制：相同文本不重复调用 API
+ *
+ * 详见 ADR-003 · LLM 适配层使用 OpenAI Chat Completions 兼容协议
+ */
+import { logger } from '../logging/logger.js';
+import { networkError, configError, toError } from '../utils/errors.js';
+/**
+ * Embedding Provider
+ *
+ * 调用 /embeddings 端点将文本转为向量
+ * 支持批量嵌入和本地缓存
+ */
+export class EmbeddingProvider {
+    config;
+    /** 缓存最大条目数（LRU 上限，防止无界增长导致内存泄漏） */
+    static CACHE_MAX_SIZE = 1000;
+    /** 本地缓存：text → vector（LRU，Map 迭代顺序 = 最近访问顺序） */
+    cache = new Map();
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * LRU 读取：命中时把条目移到末尾，标记为最近访问
+     * Map 保持插入顺序，末尾即最近访问，首部即最久未访问（淘汰候选）
+     */
+    getCached(text) {
+        const vector = this.cache.get(text);
+        if (vector === undefined)
+            return undefined;
+        // 删除后重新插入，移到末尾
+        this.cache.delete(text);
+        this.cache.set(text, vector);
+        return vector;
+    }
+    /**
+     * LRU 写入：超过容量时淘汰最旧条目（首部）
+     */
+    setCache(text, vector) {
+        if (this.cache.size >= EmbeddingProvider.CACHE_MAX_SIZE) {
+            const oldest = this.cache.keys().next().value;
+            if (oldest !== undefined)
+                this.cache.delete(oldest);
+        }
+        this.cache.set(text, vector);
+    }
+    /**
+     * 嵌入单条文本
+     * @param text 待嵌入的文本
+     * @returns 向量
+     */
+    async embed(text) {
+        // 缓存命中
+        const cached = this.getCached(text);
+        if (cached)
+            return cached;
+        const results = await this.batchEmbed([text]);
+        const first = results[0];
+        if (!first)
+            throw new Error('embed: batchEmbed 返回空结果');
+        return first.vector;
+    }
+    /**
+     * 批量嵌入多条文本
+     * OpenAI 兼容 API 支持一次请求嵌入多条文本，减少 API 调用
+     * @param texts 待嵌入的文本数组
+     * @returns 嵌入结果数组（顺序与输入一致）
+     */
+    async batchEmbed(texts) {
+        // 过滤已缓存的
+        const uncached = [];
+        const uncachedIndices = [];
+        const results = texts.map((text, i) => {
+            const cached = this.getCached(text);
+            if (cached)
+                return { text, vector: cached };
+            uncached.push(text);
+            uncachedIndices.push(i);
+            return null;
+        });
+        // 全部命中缓存
+        if (uncached.length === 0) {
+            return results;
+        }
+        // 调用 /embeddings API
+        if (!this.config.apiKey) {
+            throw configError('Embedding API Key 未配置', 'embedding 需要 LLM API Key', [
+                '检查 ~/.memora/config.json 的 llm.apiKey 字段',
+            ]);
+        }
+        const url = `${this.config.baseUrl}/embeddings`;
+        let response;
+        try {
+            response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${this.config.apiKey}`,
+                },
+                body: JSON.stringify({
+                    model: this.config.model,
+                    input: uncached,
+                }),
+            });
+        }
+        catch (err) {
+            const e = toError(err);
+            throw networkError('Embedding 服务连接失败', `无法访问 ${url}：${e.message}`, ['检查网络连接', '确认 baseUrl 配置正确'], e);
+        }
+        if (!response.ok) {
+            const body = await response.text().catch(() => '');
+            throw networkError('Embedding 请求失败', `HTTP ${response.status}: ${body.slice(0, 200)}`, [
+                '检查 API Key 是否有效',
+                '确认 embedding 模型名称正确',
+            ]);
+        }
+        const data = (await response.json());
+        // 按 index 排序（API 不保证顺序）
+        const sorted = data.data.sort((a, b) => a.index - b.index);
+        // 填充结果 + 更新缓存
+        for (let i = 0; i < uncached.length; i++) {
+            // QC-17 移除非空断言：循环条件保证索引有效，null 检查兜底
+            const text = uncached[i];
+            if (!text)
+                continue;
+            const vector = sorted[i]?.embedding;
+            if (!vector) {
+                logger.warn({ text: text.slice(0, 50), index: i }, 'Embedding 缺失，跳过');
+                continue;
+            }
+            this.setCache(text, vector);
+            // QC-17 移除非空断言：null 检查兜底
+            const idx = uncachedIndices[i];
+            if (idx !== undefined)
+                results[idx] = { text, vector };
+        }
+        return results.filter((r) => r !== null);
+    }
+    /**
+     * 获取缓存大小（调试用）
+     */
+    get cacheSize() {
+        return this.cache.size;
+    }
+    /**
+     * 清空缓存
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+}
+//# sourceMappingURL=embedding.js.map

package/dist/llm/embedding.js.map

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

package/dist/llm/factory.d.ts

@@ -0,0 +1,39 @@
+/**
+ * LLM Provider 工厂
+ * 根据配置选择具体的 LLM 实现
+ * 详见 ADR-003
+ */
+import type { Config } from '../config/loader.js';
+import { LlmProvider } from '../llm/provider.js';
+/**
+ * 单个 Provider 配置（用于 createProviderFromConfig）
+ */
+export interface ProviderConfig {
+    provider: string;
+    model: string;
+    baseUrl?: string;
+    apiKey?: string;
+}
+/**
+ * 从单个 Provider 配置创建 LlmProvider 实例
+ *
+ * 与 createLlmProvider 逻辑相同，但接收的是单个 Provider 配置而非完整 Config。
+ * 用于多 Provider 管理场景：Agent 为 providers 映射表中的每个条目调用此函数。
+ *
+ * @param name - Provider 别名（如 "deepseek"、"openai"）
+ * @param providerConfig - 单个 Provider 的配置
+ * @returns LlmProvider 实例
+ */
+export declare function createProviderFromConfig(name: string, providerConfig: ProviderConfig): LlmProvider;
+/**
+ * 创建 LLM Provider（从完整 Config）
+ *
+ * 兼容两种配置格式：
+ *   1. 新格式：llm.providers + llm.active → 使用指定 Provider
+ *   2. 旧格式：llm.provider + llm.model + ... → 单 Provider 扁平字段
+ *
+ * @param config 完整配置
+ * @returns 当前激活的 LlmProvider 实例
+ */
+export declare function createLlmProvider(config: Config): LlmProvider;
+//# sourceMappingURL=factory.d.ts.map

package/dist/llm/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/llm/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAYhD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,cAAc,GAC7B,WAAW,CAiDb;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAyB7D"}

package/dist/llm/factory.js

@@ -0,0 +1,108 @@
+import { LlmProvider } from '../llm/provider.js';
+import { OpenAICompatibleProvider } from '../llm/openaiCompatible.js';
+import { logger } from '../logging/logger.js';
+import { configError } from '../utils/errors.js';
+// 预设 Provider 的默认 baseUrl 和 model（开箱即用）
+const presets = {
+    deepseek: { baseUrl: 'https://api.deepseek.com/v1', defaultModel: 'deepseek-chat' },
+    doubao: { baseUrl: 'https://ark.cn-beijing.volces.com/api/v3', defaultModel: 'doubao-pro-32k' },
+    openai: { baseUrl: 'https://api.openai.com/v1', defaultModel: 'gpt-4o-mini' },
+};
+/**
+ * 从单个 Provider 配置创建 LlmProvider 实例
+ *
+ * 与 createLlmProvider 逻辑相同，但接收的是单个 Provider 配置而非完整 Config。
+ * 用于多 Provider 管理场景：Agent 为 providers 映射表中的每个条目调用此函数。
+ *
+ * @param name - Provider 别名（如 "deepseek"、"openai"）
+ * @param providerConfig - 单个 Provider 的配置
+ * @returns LlmProvider 实例
+ */
+export function createProviderFromConfig(name, providerConfig) {
+    const { provider, apiKey, baseUrl, model } = providerConfig;
+    if (provider === 'mock') {
+        logger.warn({ provider: 'mock' }, '使用 Mock LLM Provider（仅用于测试）');
+        return new MockProvider();
+    }
+    // 国产模型均走 OpenAI 兼容协议
+    const preset = presets[provider];
+    const resolvedBaseUrl = (baseUrl ?? preset?.baseUrl)?.replace(/\/chat\/completions\/?$/, '');
+    const resolvedModel = model ?? preset?.defaultModel;
+    if (!resolvedBaseUrl) {
+        throw configError('未知的 LLM provider', `provider "${provider}" 未在预设中，且未配置 baseUrl`, [
+            '在配置文件中显式设置 baseUrl 和 model',
+            `或使用预设 provider：${Object.keys(presets).join(', ')}`,
+            '详见 ADR-003 扩展点说明',
+        ]);
+    }
+    if (!resolvedModel) {
+        throw configError('未知的 LLM provider', `provider "${provider}" 未在预设中，且未配置 model`, [
+            `在配置文件中显式设置 model，或使用预设 provider：${Object.keys(presets).join(', ')}`,
+        ]);
+    }
+    // apiKey 缺失尽早报错（比等 chat() 失败更友好）
+    if (!apiKey) {
+        throw configError('LLM API Key 未配置', `provider "${name}" (${provider}) 缺少 apiKey`, [
+            `设置环境变量 MEMORA_LLM_API_KEY`,
+            '或在配置文件中配置 apiKey（支持 ${ENV_VAR} 占位符）',
+            '详见 config.example.md',
+        ]);
+    }
+    logger.info({ provider, baseUrl: resolvedBaseUrl, model: resolvedModel }, `创建 LLM Provider: ${name}`);
+    return new OpenAICompatibleProvider(name, {
+        baseUrl: resolvedBaseUrl,
+        apiKey,
+        defaultModel: resolvedModel,
+    });
+}
+/**
+ * 创建 LLM Provider（从完整 Config）
+ *
+ * 兼容两种配置格式：
+ *   1. 新格式：llm.providers + llm.active → 使用指定 Provider
+ *   2. 旧格式：llm.provider + llm.model + ... → 单 Provider 扁平字段
+ *
+ * @param config 完整配置
+ * @returns 当前激活的 LlmProvider 实例
+ */
+export function createLlmProvider(config) {
+    const { llm } = config;
+    // 优先使用新的多 Provider 格式
+    if (llm.providers && Object.keys(llm.providers).length > 0) {
+        // QC-17 移除非空断言：Object.keys 已检查 length > 0
+        const active = llm.active ?? Object.keys(llm.providers)[0] ?? '';
+        const providerConfig = llm.providers[active];
+        if (!providerConfig) {
+            throw configError('无效的 active Provider', `active="${active}" 不在 providers 映射表中`, [
+                `可用的 Provider：${Object.keys(llm.providers).join(', ')}`,
+                `在配置文件中设置 llm.active 为其中之一`,
+                '或使用 `memora config llm use <name>` 切换',
+            ]);
+        }
+        return createProviderFromConfig(active, providerConfig);
+    }
+    // 旧格式：复用 createProviderFromConfig（DRY，避免重复 preset 解析逻辑）
+    return createProviderFromConfig(llm.provider, {
+        provider: llm.provider,
+        model: llm.model,
+        baseUrl: llm.baseUrl,
+        apiKey: llm.apiKey,
+    });
+}
+/**
+ * Mock LLM Provider
+ * 用于测试和开发
+ */
+class MockProvider extends LlmProvider {
+    name = 'mock';
+    async *chat(messages) {
+        const lastUser = [...messages].reverse().find((m) => m.role === 'user');
+        const reply = `Mock 响应：${lastUser?.content ?? '(empty)'}`;
+        for (const char of reply) {
+            yield { content: char };
+            await new Promise((r) => setTimeout(r, 5));
+        }
+        yield { finishReason: 'stop' };
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/llm/factory.js.map

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

package/dist/llm/openaiCompatible.d.ts

@@ -0,0 +1,63 @@
+/**
+ * OpenAI Chat Completions 兼容实现
+ *
+ * 适用于：DeepSeek / 豆包 / 通义 / Ollama / 任何兼容 OpenAI 协议的 API
+ * 详见 ADR-003
+ */
+import { LlmProvider } from '../llm/provider.js';
+import type { Message, ChatOptions } from '../llm/provider.js';
+import type { LlmChunk } from '../llm/types.js';
+export interface OpenAICompatibleConfig {
+    baseUrl: string;
+    apiKey: string;
+    defaultModel: string;
+}
+/**
+ * 通用 OpenAI 兼容 Provider
+ * 通过 baseUrl 适配不同厂商
+ */
+export declare class OpenAICompatibleProvider extends LlmProvider {
+    private readonly config;
+    readonly name: string;
+    constructor(name: string, config: OpenAICompatibleConfig);
+    /** 默认请求超时：120 秒 */
+    private static readonly DEFAULT_TIMEOUT_MS;
+    chat(messages: Message[], opts?: ChatOptions): AsyncIterable<LlmChunk>;
+    /**
+     * 处理 HTTP 错误响应
+     *
+     * 消费并释放 body，根据状态码抛出相应的错误类型。
+     */
+    private handleResponseError;
+    /**
+     * 格式化消息为 OpenAI 协议格式
+     *
+     * 关键兼容性处理：
+     *   - assistant 消息带 tool_calls 时，若 content 为空字符串，转为 null
+     *     （部分 LLM provider 对空字符串 content 处理异常，导致请求挂起或报错）
+     *   - tool 消息必须包含 tool_call_id 关联对应的工具调用
+     */
+    private formatMessages;
+    /**
+     * 解析 SSE 流
+     * OpenAI 协议：data: {...}\n\n
+     *
+     * 支持解析 tool_calls delta（流式工具调用）：
+     * OpenAI 协议中 tool_calls 以 delta 形式分片传输，
+     * 需要跨 chunk 累积 function.name 和 function.arguments，
+     * 在 finish_reason='tool_calls' 或流结束时输出完整的 toolCalls。
+     *
+     * @param body - SSE 响应流
+     * @param signal - 中止信号（超时/用户取消），中断 reader.read() 等待
+     */
+    private parseSseStream;
+    /**
+     * 从累积器构建完整的 toolCalls 数组（用于 finish_reason='tool_calls' 场景）
+     */
+    private buildToolCallsFromAccumulators;
+    /**
+     * 从累积器构建 LlmChunk（用于流结束时的兜底输出）
+     */
+    private buildToolCallsChunk;
+}
+//# sourceMappingURL=openaiCompatible.d.ts.map

package/dist/llm/openaiCompatible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openaiCompatible.d.ts","sourceRoot":"","sources":["../../src/llm/openaiCompatible.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAY,MAAM,gBAAgB,CAAC;AAIzD,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,wBAAyB,SAAQ,WAAW;IAKrD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAGpB,IAAI,EAAE,MAAM,EACK,MAAM,EAAE,sBAAsB;IAMjD,mBAAmB;IACnB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAW;IAE9C,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,GAAE,WAAgB,GAAG,aAAa,CAAC,QAAQ,CAAC;IA0HjF;;;;OAIG;YACW,mBAAmB;IAuCjC;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IAkBtB;;;;;;;;;;;OAWG;YACY,cAAc;IA4H7B;;OAEG;IACH,OAAO,CAAC,8BAA8B;IActC;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAQ5B"}