@zooique/memora 2.0.0 → 3.0.0

package/dist/llm/factory.js

@@ -3,97 +3,62 @@ import { OpenAICompatibleProvider } from '../llm/openaiCompatible.js';
 import { logger } from '../logging/logger.js';
 import { configError } from '../utils/errors.js';
 import { safeSetTimeout } from '../utils/safeTimer.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 实例
- */
+/** 从单个 Provider 配置创建 LlmProvider 实例（多 Provider 管理场景：为 providers 映射表中每个条目调用） */
 export function createProviderFromConfig(name, providerConfig) {
-    const { provider, apiKey, baseUrl, model } = providerConfig;
+    const { baseUrl, model, apiKey, provider } = 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;
+    // baseUrl 和 model 是内核的直接需求，不做过多的回退逻辑
+    const resolvedBaseUrl = (baseUrl || '').replace(/\/chat\/completions\/?$/, '');
     if (!resolvedBaseUrl) {
-        throw configError('未知的 LLM provider', `provider "${provider}" 未在预设中，且未配置 baseUrl`, [
-            '在配置文件中显式设置 baseUrl 和 model',
-            `或使用预设 provider：${Object.keys(presets).join(', ')}`,
-            '详见 ADR-003 扩展点说明',
+        throw configError('LLM baseUrl 未配置', `provider "${name}" 缺少 baseUrl`, [
+            '在宿主层填充 baseUrl（如 "https://api.xiaomimimo.com/v1"）',
         ]);
     }
-    if (!resolvedModel) {
-        throw configError('未知的 LLM provider', `provider "${provider}" 未在预设中，且未配置 model`, [
-            `在配置文件中显式设置 model，或使用预设 provider：${Object.keys(presets).join(', ')}`,
+    if (!model) {
+        throw configError('LLM model 未配置', `provider "${name}" 缺少 model`, [
+            '在宿主层填充 model（如 "deepseek-chat"）',
         ]);
     }
-    // apiKey 缺失尽早报错（比等 chat() 失败更友好）
-    if (!apiKey) {
-        throw configError('LLM API Key 未配置', `provider "${name}" (${provider}) 缺少 apiKey`, [
-            `设置环境变量 MEMORA_LLM_API_KEY`,
-            '或在配置文件中配置 apiKey（支持 ${ENV_VAR} 占位符）',
-            '详见 config.example.json',
-        ]);
-    }
-    logger.info({ provider, baseUrl: resolvedBaseUrl, model: resolvedModel }, `创建 LLM Provider: ${name}`);
+    logger.info({ provider: provider ?? name, baseUrl: resolvedBaseUrl, model }, `创建 LLM Provider: ${name}`);
     return new OpenAICompatibleProvider(name, {
         baseUrl: resolvedBaseUrl,
-        apiKey,
-        defaultModel: resolvedModel,
+        apiKey: apiKey ?? '',
+        defaultModel: model,
+        // 能力位透传：未填（undefined）由 OpenAICompatibleProvider 内按**各自方向**回落——
+        // supportsToolCalling → true，supportsStructuredOutput → false（见上方字段文档；勿读成「默认都开」）。
+        supportsToolCalling: providerConfig.supportsToolCalling,
+        supportsStructuredOutput: providerConfig.supportsStructuredOutput,
     });
 }
 /**
  * 创建 LLM Provider（从完整 Config）
- *
- * 兼容两种配置格式：
- *   1. 新格式：llm.providers + llm.active → 使用指定 Provider
- *   2. 旧格式：llm.provider + llm.model + ... → 单 Provider 扁平字段
- *
- * @param config 完整配置
- * @returns 当前激活的 LlmProvider 实例
+ * 唯一配置格式：providers 映射表 + active，宿主应确保 baseUrl+model 已显式设置
  */
 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);
+    if (!llm.providers || Object.keys(llm.providers).length === 0) {
+        throw configError('LLM providers 未配置', 'llm.providers 映射表为空或未定义', [
+            '在配置文件中配置 llm.providers（如 deepseek/openai 等）',
+        ]);
+    }
+    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>` 切换',
+        ]);
     }
-    // 旧格式：复用 createProviderFromConfig（DRY，避免重复 preset 解析逻辑）
-    return createProviderFromConfig(llm.provider, {
-        provider: llm.provider,
-        model: llm.model,
-        baseUrl: llm.baseUrl,
-        apiKey: llm.apiKey,
+    return createProviderFromConfig(active, {
+        ...providerConfig,
+        baseUrl: providerConfig.baseUrl ?? '',
     });
 }
-/**
- * Mock LLM Provider
- * 用于测试和开发
- */
+/** Mock LLM Provider：用于测试和开发 */
 class MockProvider extends LlmProvider {
     name = 'mock';
     async *chat(messages) {

package/dist/llm/factory.js.map

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

package/dist/llm/openaiCompatible.d.ts

@@ -2,7 +2,6 @@
  * OpenAI Chat Completions 兼容实现
  *
  * 适用于：DeepSeek / 豆包 / 通义 / Ollama / 任何兼容 OpenAI 协议的 API
- * 详见 ADR-003
  */
 import { LlmProvider } from '../llm/provider.js';
 import type { Message, ChatOptions } from '../llm/provider.js';
@@ -11,62 +10,48 @@ export interface OpenAICompatibleConfig {
     baseUrl: string;
     apiKey: string;
     defaultModel: string;
+    /** 是否支持原生工具调用（OpenAI Function Calling tools 协议）。三态透传：仅 undefined 回落默认 true，
+     *  显式 false 保留关闭工具通道（本地 LLM 如 Ollama/LM Studio 无原生 FC 时由宿主配置 false）。 */
+    supportsToolCalling?: boolean;
+    /** 是否支持结构化输出（response_format / JSON mode），默认 false */
+    supportsStructuredOutput?: boolean;
 }
-/**
- * 通用 OpenAI 兼容 Provider
- * 通过 baseUrl 适配不同厂商
- */
+/** 通用 OpenAI 兼容 Provider：通过 baseUrl 适配不同厂商 */
 export declare class OpenAICompatibleProvider extends LlmProvider {
     private readonly config;
     readonly name: string;
     constructor(name: string, config: OpenAICompatibleConfig);
+    /**
+     * 能力位赋值（内置为只读，外部不可改）：默认 true 保留存量云 LLM「有工具集即走原生 FC」行为，
+     * 本地运行时（Ollama/LM Studio 等）无原生 FC 须在宿主配置时显式置 false。
+     * @param config 构造时的能力位声明（undefined → 回落默认）
+     */
+    private _setCapabilities;
     /** 默认请求超时：120 秒 */
     private static readonly DEFAULT_TIMEOUT_MS;
+    /** tool_call id 兜底的自增序列：id 缺失时给出**跨批唯一**的占位——
+     *  本批内下标 `call_${idx}` 会让同一 turn 的两次迭代各产 `call_0`，
+     *  服务端按 tool_call_id 配对时错位。实例级自增，杜绝模块级全局态（架构约束）。 */
+    private toolCallIdSeq;
     chat(messages: Message[], opts?: ChatOptions): AsyncIterable<LlmChunk>;
-    /**
-     * 处理 HTTP 错误响应
-     *
-     * 消费并释放 body，根据状态码抛出相应的错误类型。
-     */
+    /** 处理 HTTP 错误响应：消费并释放 body，按状态码抛相应错误类型 */
     private handleResponseError;
-    /**
-     * 安全取消 response.body
-     *
-     * 在 SSE 异常和 HTTP 错误处理路径中均需 cancel response.body 释放底层连接，
-     * cancel 本身失败不应阻塞后续错误抛出，仅 debug 记录。
-     *
-     * @param response - HTTP 响应对象
-     */
+    /** 安全取消 response.body：cancel 失败不阻塞后续错误抛出，仅 debug 记录 */
     private safeCancelBody;
     /**
-     * 格式化消息为 OpenAI 协议格式
-     *
-     * 关键兼容性处理：
-     *   - assistant 消息带 tool_calls 时，若 content 为空字符串，转为 null
-     *     （部分 LLM provider 对空字符串 content 处理异常，导致请求挂起或报错）
-     *   - tool 消息必须包含 tool_call_id 关联对应的工具调用
+     * 格式化消息为 OpenAI 协议格式：assistant 带 tool_calls 时 content 空串转 null
+     * （部分 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() 等待
+     * 解析 SSE 流（data: {...}\n\n）。tool_calls 以 delta 分片传输，
+     * 需跨 chunk 累积 name/arguments，在 finish_reason='tool_calls' 或流结束时输出完整 toolCalls
      */
     private parseSseStream;
-    /**
-     * 从累积器构建完整的 toolCalls 数组（用于 finish_reason='tool_calls' 场景）
-     */
+    /** 从累积器构建完整 toolCalls 数组（finish_reason='tool_calls' 场景）。
+     *  id 缺失时兜底为 `call_<toolCallIdSeq++>`（跨批唯一），不因两次迭代都缺 id 而产出重复 id。 */
     private buildToolCallsFromAccumulators;
-    /**
-     * 从累积器构建 LlmChunk（用于流结束时的兜底输出）
-     */
+    /** 从累积器构建 LlmChunk（流结束时的兜底输出） */
     private buildToolCallsChunk;
 }
 //# sourceMappingURL=openaiCompatible.d.ts.map

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

@@ -1 +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;AAKzD,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAyBD;;;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;IA2HjF;;;;OAIG;YACW,mBAAmB;IAmCjC;;;;;;;OAOG;YACW,cAAc;IAQ5B;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IAkBtB;;;;;;;;;;;OAWG;YACY,cAAc;IA8I7B;;OAEG;IACH,OAAO,CAAC,8BAA8B;IActC;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAQ5B"}
+{"version":3,"file":"openaiCompatible.d.ts","sourceRoot":"","sources":["../../src/llm/openaiCompatible.ts"],"names":[],"mappings":"AAAA;;;;GAIG;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;AAYzD,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB;4EACwE;IACxE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,sDAAsD;IACtD,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AA2CD,8CAA8C;AAC9C,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;IAOjD;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAOxB,mBAAmB;IACnB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAW;IAErD;;wDAEoD;IACpD,OAAO,CAAC,aAAa,CAAK;IAEnB,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,GAAE,WAAgB,GAAG,aAAa,CAAC,QAAQ,CAAC;IA4GjF,0CAA0C;YAC5B,mBAAmB;IA2CjC,uDAAuD;YACzC,cAAc;IAQ5B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAiBtB;;;OAGG;YACY,cAAc;IAkN7B;yEACqE;IACrE,OAAO,CAAC,8BAA8B;IActC,iCAAiC;IACjC,OAAO,CAAC,mBAAmB;CAQ5B"}