@zooique/memora 2.0.3 → 3.0.1

package/dist/llm/openaiCompatible.js

@@ -2,37 +2,52 @@
  * OpenAI Chat Completions 兼容实现
  *
  * 适用于：DeepSeek / 豆包 / 通义 / Ollama / 任何兼容 OpenAI 协议的 API
- * 详见 ADR-003
  */
 import { LlmProvider } from '../llm/provider.js';
-import { llmError, networkError, configError, toError } from '../utils/errors.js';
+import { llmError, networkError, configError, isAbortError, isTimeoutError, } from '../utils/errors.js';
+import { toError } from '../utils/toError.js';
 import { logger } from '../logging/logger.js';
 import { mergeAbortSignals } from '../llm/abortSignal.js';
+/** 错误响应体截断长度（字符数）：统一 4 处 errorText.slice(0,200) 的常量，避免魔法数字 */
+const MAX_ERROR_BODY_LEN = 200;
+// ─── LLM 请求参数边界（外部注入防失控） ─────────────────
+/** timeoutMs 上限：5 分钟，防配置超大值导致请求等待失控（下限不设，测试/调试用小值模拟超时） */
+const MAX_TIMEOUT_MS = 300_000;
 /**
- * 错误响应体截断长度（字符数）。
- *
- * handleResponseError 中 4 处 errorText.slice(0, 200) 的统一常量，
- * 避免魔法数字散落，便于后续调整截断策略。
+ * 归一化 maxTokens：仅做**形态防御**——正整数才透传（向下取整），零/负/非数值返回 undefined
+ * （不传，让服务端默认）。
+ * **上限不裁决**（有意为之，勿加回）：真实上限由模型/服务端决定，超限值原样透传、由服务端
+ * 可见报错——本地任何一层静默丢弃都会造出「UI 显示值 ≠ 真实生效值」的坑（同一裁决见
+ * contextWindow：宿主护栏是输入边界的唯一可见裁决点，内核只防形态）。
  */
-const MAX_ERROR_BODY_LEN = 200;
+function normalizeMaxTokens(value) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return undefined;
+    if (value < 1)
+        return undefined;
+    return Math.floor(value);
+}
 /**
- * chunk 级读超时区分首 chunk 与 chunk 间（reasoning 模型适配）
- *
- * 背景：reasoning 模型（DeepSeek-R1/o1/QwQ 等）首 chunk 前需完成思维链推理，
- *   可能耗时 30-90s；chunk 间正常停顿 < 10s，但复杂推理节点可能短暂停顿。
- *
- * 策略：
- *   - 首 chunk 超时 120s：与请求级超时一致，给 reasoning 模型足够思考时间
- *   - chunk 间超时 60s：首 chunk 已到说明连接正常，60s 足以覆盖正常停顿
- *
- * 判定依据：firstChunkReceived 标志位区分两种阶段
+ * 归一化 timeoutMs：合法（≤MAX_TIMEOUT_MS 且 >0）返回原值，越界/非法回退默认。
+ * 防超大值等待失控；不设下限以保留测试用小超时值。
  */
-const FIRST_CHUNK_TIMEOUT_MS = 120_000;
-const INTER_CHUNK_TIMEOUT_MS = 60_000;
+function normalizeTimeoutMs(value, fallback) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return fallback;
+    if (value <= 0 || value > MAX_TIMEOUT_MS)
+        return fallback;
+    return value;
+}
 /**
- * 通用 OpenAI 兼容 Provider
- * 通过 baseUrl 适配不同厂商
+ * chunk 级读超时区分首 chunk 与 chunk 间（reasoning 适配）：
+ * 首 chunk 前可能思考 30-90s（DeepSeek-R1/o1/QwQ 等）→ 120s；连接正常后停顿 <10s → 60s
  */
+const FIRST_CHUNK_TIMEOUT_MS = 120_000;
+const INTER_CHUNK_TIMEOUT_MS = 60_000;
+/** 有效 SSE 事件停滞超时：即便有字节持续到达（keep-alive/代理心跳），只要长时间无 `data:` 事件，
+ *  也判超时——补 chunk 级超时（按 read 重置）对「有字节无进展」的真空区，防止连接半挂永久等待。 */
+const EVENT_STALL_TIMEOUT_MS = 120_000;
+/** 通用 OpenAI 兼容 Provider：通过 baseUrl 适配不同厂商 */
 export class OpenAICompatibleProvider extends LlmProvider {
     config;
     name;
@@ -40,14 +55,32 @@ export class OpenAICompatibleProvider extends LlmProvider {
         super();
         this.config = config;
         this.name = name;
+        this._setCapabilities(config);
+    }
+    /**
+     * 能力位赋值（内置为只读，外部不可改）：默认 true 保留存量云 LLM「有工具集即走原生 FC」行为，
+     * 本地运行时（Ollama/LM Studio 等）无原生 FC 须在宿主配置时显式置 false。
+     * @param config 构造时的能力位声明（undefined → 回落默认）
+     */
+    _setCapabilities(config) {
+        this.supportsToolCalling =
+            config.supportsToolCalling ?? true;
+        this.supportsStructuredOutput =
+            config.supportsStructuredOutput ?? false;
     }
     /** 默认请求超时：120 秒 */
     static DEFAULT_TIMEOUT_MS = 120_000;
+    /** tool_call id 兜底的自增序列：id 缺失时给出**跨批唯一**的占位——
+     *  本批内下标 `call_${idx}` 会让同一 turn 的两次迭代各产 `call_0`，
+     *  服务端按 tool_call_id 配对时错位。实例级自增，杜绝模块级全局态（架构约束）。 */
+    toolCallIdSeq = 0;
     async *chat(messages, opts = {}) {
         const url = `${this.config.baseUrl}/chat/completions`;
         const model = opts.model ?? this.config.defaultModel;
-        // 请求超时控制：默认 120s，可通过 opts.timeoutMs 覆盖
-        const timeoutMs = opts.timeoutMs ?? OpenAICompatibleProvider.DEFAULT_TIMEOUT_MS;
+        // 请求超时控制：默认 120s，可通过 opts.timeoutMs 覆盖（越界回退默认，防超大值等待失控）
+        const timeoutMs = normalizeTimeoutMs(opts.timeoutMs, OpenAICompatibleProvider.DEFAULT_TIMEOUT_MS);
+        // maxTokens 形态归一：正整数透传（零/负/非数值忽略，让服务端默认）；上限不裁决（超限原样发，服务端可见报错）
+        const maxTokens = normalizeMaxTokens(opts.maxTokens);
         const body = {
             model,
             messages: this.formatMessages(messages),
@@ -57,15 +90,16 @@ export class OpenAICompatibleProvider extends LlmProvider {
         };
         if (opts.tools)
             body['tools'] = opts.tools;
-        if (opts.maxTokens)
-            body['max_tokens'] = opts.maxTokens;
-        // 结构化输出约束：透传 response_format 到请求 body
-        // 供未来非 tool_call 场景使用（如归档摘要强制 JSON、配置建议提取）
-        // 注意：不能与 tools 同时使用（OpenAI 协议限制），调用方需自行保证互斥
+        if (maxTokens !== undefined)
+            body['max_tokens'] = maxTokens;
+        // 透传 response_format；不能与 tools 同时使用（OpenAI 协议限制），调用方保证互斥
         if (opts.response_format)
             body['response_format'] = opts.response_format;
-        // 合并 AbortSignal：外部取消信号 + 超时信号（mergeAbortSignals 集中维护，ADR-017 枝叶层 2 次提取）
-        // 确保用户取消和请求超时都能中断 fetch 和流读取
+        // 透传推理深度（reasoning_effort）：loop 在 multiStepReasoning='manual' 时设置 'low'
+        // 实现快速回答，必须转达给 provider 才生效（只声明+消费而不转达 = 契约断裂）
+        if (opts.reasoning_effort)
+            body['reasoning_effort'] = opts.reasoning_effort;
+        // 合并外部取消 + 超时信号，确保用户取消和请求超时都能中断 fetch 和流读取
         const abort = mergeAbortSignals(opts.signal, timeoutMs, 'LLM 请求超时');
         let response;
         try {
@@ -82,8 +116,8 @@ export class OpenAICompatibleProvider extends LlmProvider {
         catch (err) {
             abort.dispose();
             const e = toError(err);
-            // 区分超时错误和网络错误
-            if (e.name === 'AbortError' || e.name === 'TimeoutError') {
+            // 区分超时错误和网络错误（复用 errors.ts 探测器 SSOT，避免手写 name 判断双源漂移）
+            if (isAbortError(e) || isTimeoutError(e)) {
                 throw networkError('LLM 请求超时', `${this.config.baseUrl} 请求超过 ${timeoutMs / 1000}s 未响应`, [
                     '检查网络连接稳定性',
                     '如频繁超时，考虑切换 provider 或在 config.json 调整 timeoutMs',
@@ -96,11 +130,8 @@ export class OpenAICompatibleProvider extends LlmProvider {
                 '如使用 VPN/代理，检查代理设置',
             ], e);
         }
-        // fetch 成功后保留 optsSignal 监听：用户在 SSE 流式阶段取消时，
-        // 仍需通过 mergeAbortSignals 内部的 onOptsAbort 触发 abort 中断 reader.read()。
-        // 注意：{ once: true } 仅在 optsSignal 自身 abort 时移除监听器；
-        // 正常完成或异常路径必须显式 dispose()，否则监听器常驻泄漏。
-        // 下方外层 try-finally 统一调用 abort.dispose()，覆盖所有抛错路径。
+        // fetch 成功后保留 optsSignal 监听，使用户在 SSE 阶段取消也能中断 reader.read()；
+        // 正常完成/异常路径须显式 dispose()，否则监听器常驻泄漏（外层 try-finally 统一调用）
         try {
             if (!response.ok) {
                 await this.handleResponseError(response);
@@ -111,23 +142,18 @@ export class OpenAICompatibleProvider extends LlmProvider {
                     '如持续出现，联系厂商',
                 ]);
             }
-            // fetch 成功且响应正常：清除请求级总超时
-            // SSE 阶段由 chunk 级超时（FIRST_CHUNK_TIMEOUT_MS / INTER_CHUNK_TIMEOUT_MS）独立保护
-            // 若保留总超时，长文生成（>timeoutMs）会被错误中断
+            // fetch 成功后清除请求级总超时，SSE 阶段由 chunk 级超时独立保护，否则长文生成（>timeoutMs）会被错误中断
             abort.clearTimer();
             try {
-                // 将 abort.signal 传入 SSE 解析器，使超时/取消能中断流读取
                 yield* this.parseSseStream(response.body, abort.signal);
             }
             catch (err) {
-                // SSE 解析异常时也要 cancel stream（Node 24 + undici 同上）
+                // SSE 解析异常时也 cancel stream 释放底层连接
                 await this.safeCancelBody(response);
-                // DOMException（AbortError/TimeoutError）是 LLM 中断协议：
-                // 上游 AgentLoop/contextManager/agent.ts 按 err.name === 'AbortError' 识别，
-                // 必须原样传播，不能包装为 MemoraError（否则中断协议失效）
+                // DOMException（AbortError/TimeoutError）是 LLM 中断协议，按 err.name==='AbortError' 识别，须原样传播不能包装为 MemoraError
                 if (err instanceof DOMException)
                     throw err;
-                // 其他未知流读取异常统一包装为 MemoraError（避免裸 throw 逃逸非 MemoraError）
+                // 其他未知流异常统一包装为 MemoraError，避免裸 throw 逃逸非 MemoraError
                 throw networkError('LLM 流读取异常', toError(err).message, ['稍后重试', '如持续出现，检查网络稳定性或切换 provider'], toError(err));
             }
         }
@@ -136,18 +162,14 @@ export class OpenAICompatibleProvider extends LlmProvider {
             abort.dispose();
         }
     }
-    /**
-     * 处理 HTTP 错误响应
-     *
-     * 消费并释放 body，根据状态码抛出相应的错误类型。
-     */
+    /** 处理 HTTP 错误响应：消费并释放 body，按状态码抛相应错误类型 */
     async handleResponseError(response) {
         const errorText = await response.text().catch(() => '<无法读取响应体>');
         await this.safeCancelBody(response);
         const status = response.status;
         if (status === 401 || status === 403) {
             throw configError('LLM API Key 无效', `HTTP ${status}：${errorText.slice(0, MAX_ERROR_BODY_LEN)}`, [
-                '检查 API Key 是否正确（注意 ${MEMORA_LLM_API_KEY} 占位符是否已展开）',
+                '检查 API Key 是否正确（注意 ${MEMORA_API_KEY} 占位符是否已展开）',
                 '确认 Key 未过期',
                 '如使用 DeepSeek/豆包，确认 Key 来自对应平台',
             ]);
@@ -171,14 +193,7 @@ export class OpenAICompatibleProvider extends LlmProvider {
             '可在 config.json 切换 provider 兜底',
         ]);
     }
-    /**
-     * 安全取消 response.body
-     *
-     * 在 SSE 异常和 HTTP 错误处理路径中均需 cancel response.body 释放底层连接，
-     * cancel 本身失败不应阻塞后续错误抛出，仅 debug 记录。
-     *
-     * @param response - HTTP 响应对象
-     */
+    /** 安全取消 response.body：cancel 失败不阻塞后续错误抛出，仅 debug 记录 */
     async safeCancelBody(response) {
         try {
             await response.body?.cancel();
@@ -188,12 +203,8 @@ export class OpenAICompatibleProvider extends LlmProvider {
         }
     }
     /**
-     * 格式化消息为 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
      */
     formatMessages(messages) {
         return messages.map((m) => {
@@ -203,8 +214,7 @@ export class OpenAICompatibleProvider extends LlmProvider {
             if (m.role === 'assistant' && m.toolCalls) {
                 return {
                     role: 'assistant',
-                    // OpenAI 协议：有 tool_calls 时 content 应为 null（而非空字符串），
-                    // 空字符串会导致部分 provider 请求异常或无响应
+                    // OpenAI 协议：有 tool_calls 时 content 应为 null（空串会致部分 provider 请求异常）
                     content: m.content && m.content.length > 0 ? m.content : null,
                     tool_calls: m.toolCalls,
                 };
@@ -213,60 +223,82 @@ export class OpenAICompatibleProvider extends LlmProvider {
         });
     }
     /**
-     * 解析 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
      */
     async *parseSseStream(body, signal) {
         const reader = body.getReader();
         const decoder = new TextDecoder();
         let buffer = '';
-        // 流式 tool_calls 累积器：按 index 分片累积 name + arguments
-        // OpenAI 协议：同一个 tool_call 的 name/arguments 可能跨多个 delta 分片到达
+        // 流式 tool_calls 累积器：同一 tool_call 的 name/arguments 可能跨多个 delta 分片到达
         const toolCallAccumulators = new Map();
-        // chunk 级读超时区分首 chunk 与 chunk 间
-        // reader.read() 阻塞时若无超时，连接半挂（NAT/代理/服务端慢响应不关 TCP）会永久等待
-        // 采用 setTimeout + reader.cancel：超时则 cancel reader 让 read() reject 退出
+        // 已发射过「工具意图预告」的累积器 idx：同一工具只提前上报一次，防 delta 风暴。
+        // 必须是本生成器局部变量——随流结束/中断自然回收，防跨请求泄漏。
+        const emittedPendingIndexes = new Set();
+        // chunk 级读超时：无超时则连接半挂（NAT/代理不关 TCP）会永久等待；
+        // 区分首 chunk（reasoning 思考数十秒，120s）与 chunk 间（连接已正常，60s）；
+        // 另有有效事件停滞监视（收到任意 data: 行即重置），补 chunk 超时漏掉的
+        // 「服务端持续发 keep-alive 字节但无进展」真空区。
         //
-        // 区分首 chunk 与 chunk 间（reasoning 模型适配）：
-        //   - 首 chunk 前 LLM 可能思考数十秒（reasoning 模型），用 FIRST_CHUNK_TIMEOUT_MS(120s)
-        //   - 首 chunk 到达后连接已正常，chunk 间停顿用 INTER_CHUNK_TIMEOUT_MS(60s)
+        // ⚠️ **超时必须经竞速闸 reject，不得用 `reader.cancel()` 表达——本看门狗成立的前提，勿回改**：
+        // `reader.cancel(reason)` 的语义是「关闭流并让**挂起的 read() 以 `{done:true}` 收尾**」，
+        // reason **不会**出现在任何抛出物上（WHATWG 规范行为；Node 22 / undici 实测：cancel 后
+        // read 产 `{done:true}`；对照 `AbortController.abort(reason)` 才会让 read reject reason）。
+        // 若把 cancel 当作「让 read 抛错」→ 超时被读成「流正常结束且零产出」→ 落「空响应重试」
+        // 通道 → **超时被静默吞成重试**（坑）。真机故障实证（`round-1789462982489`）：
+        // 中断源在 reasoning 结束后停摆，60s（chunk 间）+120s+120s
+        // （两次重试首 chunk）三段超时全被吞成静默重试，期间**零 UI 事件**（tokenOut 恒 0），
+        // 用户干等 5 分 5 秒后手动取消。
+        // 故看门狗只负责「以真超时驳回当前读」；底层连接的释放仍由 finally 的 reader.cancel() 负责。
+        /** 看门狗已到期的超时（竞速闸未挂起时的落账处：下一轮读之前立即抛，账面不丢） */
+        let overdueTimeout = null;
+        /** 竞速闸的驳回句柄（仅在一次读的存活期内非空） */
+        let pendingReadReject = null;
+        /** 看门狗统一出口：以真超时驳回当前读；两读之间到期则记账，由循环顶部补抛 */
+        const failCurrentRead = (reason) => {
+            overdueTimeout ??= new DOMException(reason, 'TimeoutError');
+            pendingReadReject?.(overdueTimeout);
+        };
+        let stallTimer = null;
+        const stallReset = () => {
+            if (stallTimer)
+                clearTimeout(stallTimer);
+            stallTimer = setTimeout(() => {
+                failCurrentRead('LLM 流长时间无有效事件（有字节但无 data 事件）');
+            }, EVENT_STALL_TIMEOUT_MS);
+        };
+        // 进入流读取即启动停滞监视（首事件前的“有字节无事件”同样覆盖）
+        stallReset();
         let firstChunkReceived = false;
         try {
             while (true) {
-                // 检查中止信号：超时或用户取消时立即退出
-                // 注意：此处刻意抛 DOMException 而非 MemoraError——
-                // AbortError 是 LLM 中断协议，上游（AgentLoop/contextManager/agent.ts）按
-                // err.name === 'AbortError' 识别用户取消/超时，包装为 MemoraError 会破坏协议
+                // 检查中止信号：刻意抛 DOMException（AbortError）而非 MemoraError——它是 LLM 中断协议，上游按 err.name==='AbortError' 识别
                 if (signal?.aborted) {
                     throw new DOMException('LLM 流读取被中止', signal.reason?.name ?? 'AbortError');
                 }
-                // chunk 级读超时：根据是否收到首 chunk 选择不同超时阈值
-                // reader.cancel() 会让 pending 的 reader.read() 抛 AbortError（DOMException）
-                const chunkTimeoutMs = firstChunkReceived
-                    ? INTER_CHUNK_TIMEOUT_MS
-                    : FIRST_CHUNK_TIMEOUT_MS;
+                // 两读之间到期的超时不丢账：读之前先补抛
+                if (overdueTimeout)
+                    throw overdueTimeout;
+                // 根据是否收到首 chunk 选不同超时阈值（到期经 failCurrentRead 驳回当前读，见上方注释）
+                const chunkTimeoutMs = firstChunkReceived ? INTER_CHUNK_TIMEOUT_MS : FIRST_CHUNK_TIMEOUT_MS;
                 const chunkTimer = setTimeout(() => {
-                    // cancel 失败也不影响（reader 可能已 done 或被其他路径 cancel），记日志便于排查偶发连接泄漏
-                    const reason = firstChunkReceived ? 'LLM chunk 间读取超时' : 'LLM 首 chunk 读取超时';
-                    reader.cancel(new DOMException(reason, 'TimeoutError')).catch((err) => {
-                        logger.debug({ err: toError(err).message }, 'reader.cancel 失败（超时清理路径）');
-                    });
+                    failCurrentRead(firstChunkReceived ? 'LLM chunk 间读取超时' : 'LLM 首 chunk 读取超时');
                 }, chunkTimeoutMs);
+                // 超时竞速闸：read 与超时赛跑。超时先到 → 本读以真超时 reject；被落空的 read 仍挂起，
+                // 待 finally 释放连接时自然收尾，其无人观察的 resolve 无副作用。
+                const timeoutGate = new Promise((_, reject) => {
+                    pendingReadReject = reject;
+                });
+                // 兜底观察者：闸被「已被真实数据抢先的读」落空时，其拒绝不得变成无人处理的拒绝
+                void timeoutGate.catch(() => undefined);
                 let readResult;
                 try {
-                    readResult = await reader.read();
+                    readResult = await Promise.race([reader.read(), timeoutGate]);
                 }
                 finally {
-                    // read 完成（无论成功/失败）都清理 chunk timer，避免泄漏
+                    // read 完成（无论成功/失败）都清理 chunk timer 与竞速闸句柄，避免泄漏
                     clearTimeout(chunkTimer);
+                    pendingReadReject = null;
                 }
                 const { done, value } = readResult;
                 if (done)
@@ -282,6 +314,8 @@ export class OpenAICompatibleProvider extends LlmProvider {
                     const trimmed = line.trim();
                     if (!trimmed.startsWith('data:'))
                         continue;
+                    // 有效事件停滞重置：收到 data 行即代表服务端仍在推进（即便内容暂无可输出）
+                    stallReset();
                     const data = trimmed.slice(5).trim();
                     if (data === '[DONE]') {
                         // 流结束：输出累积的 tool_calls（如果有）
@@ -292,14 +326,32 @@ export class OpenAICompatibleProvider extends LlmProvider {
                     }
                     try {
                         const json = JSON.parse(data);
+                        // 提取 usage 数据（部分 Provider 在流式响应末尾携带 token 用量统计）
+                        const usage = json.usage
+                            ? {
+                                inputTokens: json.usage.prompt_tokens ?? 0,
+                                outputTokens: json.usage.completion_tokens ?? 0,
+                                totalTokens: json.usage.total_tokens,
+                            }
+                            : undefined;
                         const choice = json.choices?.[0];
-                        if (!choice)
+                        // 纯 usage 事件（末尾统计块，choices 为空数组）：单独 yield，跳过 choices 处理
+                        if (!choice) {
+                            if (usage)
+                                yield { usage };
                             continue;
+                        }
                         const chunk = {};
-                        // delta.content 可能为 null（tool_calls 场景），!= null 排除 null/undefined
-                        // 空字符串在流式中极少出现，但不影响语义，保持原有 truthy 检查即可
+                        // usage 与 choices 并存时合并到同一 chunk（单出口，防同事件双 yield 致 content 重复）
+                        if (usage)
+                            chunk.usage = usage;
+                        // delta.content 可能为 null（tool_calls 场景），truthy 检查即可
                         if (choice.delta?.content)
                             chunk.content = choice.delta.content;
+                        // 模型思考（协议字段 reasoning_content → LlmChunk.thought）：增量透传，与 content 并列
+                        // 增量语义：消费侧自行累积。thought 命名避开路由 TaskType='reasoning' 与相位 'thinking'。
+                        if (choice.delta?.reasoning_content)
+                            chunk.thought = choice.delta.reasoning_content;
                         // 累积 tool_calls delta
                         if (choice.delta?.tool_calls) {
                             for (const tc of choice.delta.tool_calls) {
@@ -312,6 +364,17 @@ export class OpenAICompatibleProvider extends LlmProvider {
                                 if (tc.function?.arguments)
                                     acc.arguments += tc.function.arguments;
                                 toolCallAccumulators.set(idx, acc);
+                                // 工具意图预告：name 首次由空变非空即上报，不必等 finish_reason——
+                                // 写文件等大参数工具的参数生成段可能数十秒，UI 需提前显示「准备中」工具行。
+                                // 每 idx 只发一次（emittedPendingIndexes 去重防风暴）；id 缺失时按与最终构建
+                                // 同一规则合成并**写回 acc.id**（acc.id || `call_${seq}`），保证 finish_reason
+                                // 时 buildToolCallsFromAccumulators 复用同一 id，宿主侧可按 id 配对升级。
+                                if (acc.name && !emittedPendingIndexes.has(idx)) {
+                                    emittedPendingIndexes.add(idx);
+                                    if (!acc.id)
+                                        acc.id = `call_${this.toolCallIdSeq++}`;
+                                    chunk.partialToolCall = { id: acc.id, name: acc.name };
+                                }
                             }
                         }
                         // finish_reason='tool_calls' 时输出完整的 toolCalls
@@ -320,8 +383,7 @@ export class OpenAICompatibleProvider extends LlmProvider {
                             toolCallAccumulators.clear();
                         }
                         else if (choice.finish_reason && toolCallAccumulators.size > 0) {
-                            // finish_reason 为 stop/length 等非 tool_calls 值时，清空累积器防止污染下一次调用
-                            // （某些模型可能在 stop 时残留不完整的 tool_calls 碎片）
+                            // 非 tool_calls 的 finish_reason（stop/length 等）时清空累积器，防残留碎片污染下一次调用
                             toolCallAccumulators.clear();
                         }
                         if (choice.finish_reason) {
@@ -336,36 +398,33 @@ export class OpenAICompatibleProvider extends LlmProvider {
             }
         }
         finally {
-            // reader.cancel() 彻底释放底层 TCP 连接（releaseLock 仅释放锁不取消流，
-            // 无法避免 generator 提前 break 时底层连接悬挂；也是 CallLlmWithRetry
-            // 无 finally 触发 abort 时的兜底）
-            // 已 done/cancel 的 reader 调 cancel 是 no-op，安全
+            // 清理事件停滞监视（流已结束，不再需要 stall 兜底）
+            if (stallTimer)
+                clearTimeout(stallTimer);
+            // reader.cancel() 彻底释放底层 TCP 连接（releaseLock 仅释放锁不取消流，防止 break 时连接悬挂）；已 done 的 cancel 是 no-op
             try {
                 await reader.cancel();
             }
             catch (err) {
-                // cancel 失败不阻塞，reader 会被 GC 回收；记日志便于排查偶发连接泄漏
+                // cancel 失败不阻塞，reader 会被 GC 回收；记日志排查偶发连接泄漏
                 logger.debug({ err: toError(err).message }, 'reader.cancel 失败（finally 清理路径）');
             }
         }
     }
-    /**
-     * 从累积器构建完整的 toolCalls 数组（用于 finish_reason='tool_calls' 场景）
-     */
+    /** 从累积器构建完整 toolCalls 数组（finish_reason='tool_calls' 场景）。
+     *  id 缺失时兜底为 `call_<toolCallIdSeq++>`（跨批唯一），不因两次迭代都缺 id 而产出重复 id。 */
     buildToolCallsFromAccumulators(accs) {
         const calls = [];
-        for (const [idx, acc] of accs) {
+        for (const [, acc] of accs) {
             calls.push({
-                id: acc.id || `call_${idx}`,
+                id: acc.id || `call_${this.toolCallIdSeq++}`,
                 type: 'function',
                 function: { name: acc.name, arguments: acc.arguments },
             });
         }
         return calls;
     }
-    /**
-     * 从累积器构建 LlmChunk（用于流结束时的兜底输出）
-     */
+    /** 从累积器构建 LlmChunk（流结束时的兜底输出） */
     buildToolCallsChunk(accs) {
         return {
             toolCalls: this.buildToolCallsFromAccumulators(accs),

package/dist/llm/openaiCompatible.js.map

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

package/dist/llm/provider.d.ts

@@ -1,12 +1,16 @@
-/**
- * LLM Provider 抽象接口
- * 所有 LLM 实现（DeepSeek / 豆包 / OpenAI / Mock）必须实现此接口
- * 详见 ADR-003
- */
+/** LLM Provider 抽象接口：所有 LLM 实现（DeepSeek/豆包/OpenAI/Mock）必须实现 */
 import type { LlmChunk } from '../llm/types.js';
 export interface Message {
     role: 'system' | 'user' | 'assistant' | 'tool';
     content: string;
+    /**
+     * 轮次 ID（可选）：标识该消息归属的「问答轮次」。
+     * 由 loop 在写入 user/assistant/tool 消息时附上当前 currentRoundId，
+     * 作为替换式压缩（第一级 LRU）取 round-summary 的单一真理源——
+     * roundId 随消息携带，不依赖任何外部序列的尾部对齐，杜绝错位替换。
+     */
+    roundId?: string;
+    name?: string;
     toolCalls?: Array<{
         id: string;
         type: 'function';
@@ -30,11 +34,10 @@ export interface ChatOptions {
         };
     }>;
     /**
-     * 结构化输出约束（OpenAI response_format 兼容协议）
-     *
-     * 当 Provider 支持 structured output 且工具定义标记 strict 时，
-     * AgentLoop 自动生成 json_schema 约束，强制 LLM 输出合法 tool_call。
-     * 不支持的 Provider 静默跳过，fallback 到纯文本 tool_call 模式。
+     * 结构化输出约束（OpenAI Function Calling 响应格式约束）。
+     * 注意：response_format 不能与 tools 同时使用（OpenAI 协议限制），故 AgentLoop 默认不生成它
+     * （见 loop.ts buildChatOptions 注释）——此处仅为调用方显式传入时的可选能力孔，不宣称任何
+     * 「fallback 到纯文本 tool_call」的静默降级（文本出口不是可调用通道）。
      */
     response_format?: {
         type: 'json_schema';
@@ -44,48 +47,32 @@ export interface ChatOptions {
             schema: Record<string, unknown>;
         };
     };
-    /**
-     * 强制不使用流式（预留字段，当前无消费者）
-     *
-     * openaiCompatible 始终以 stream:true 发起请求（chat() 返回 AsyncIterable）。
-     * 本字段保留用于未来"非流式回退"场景（如低延迟短回复或 Provider 不支持 SSE 时）。
-     * 保留在公共 API 中以维持 ChatOptions 契约稳定。
-     */
-    stream?: boolean;
-    /**
-     * 中止信号：用于取消正在进行的 LLM 请求
-     *
-     * AgentLoop 在用户取消对话时传入 AbortSignal，
-     * Provider 应将 signal 传给底层 fetch/stream 读取，确保请求可被中断。
-     */
+    /** 推理深度控制：'low'|'medium'|'high'，Provider 不支持时静默忽略 */
+    reasoning_effort?: 'low' | 'medium' | 'high';
+    /** 中止信号：用户取消时传入，Provider 应传给底层 fetch/stream 以支持中断 */
     signal?: AbortSignal;
-    /**
-     * 请求超时（毫秒）。默认 120 秒。
-     * 超时后抛出 networkError，由 callLlmWithRetry 决定是否重试。
-     */
+    /** 请求超时（毫秒，默认 120s）：超时抛 networkError，由 callLlmWithRetry 决定是否重试 */
     timeoutMs?: number;
 }
-/**
- * LLM Provider 抽象类
- * 实现类需实现 chat() 流式方法
- */
+/** LLM Provider 抽象类：实现类需实现 chat() 流式方法 */
 export declare abstract class LlmProvider {
     abstract readonly name: string;
     /**
-     * 是否支持结构化输出（response_format json_schema）
+     * 是否支持原生工具调用（OpenAI Function Calling 的 tools 协议）。
      *
-     * 默认 false，子类可覆盖。用于非 tool_call 场景的结构化输出约束
-     * （如归档摘要强制 JSON、配置建议提取等）。调用方在构造 ChatOptions
-     * 时显式传入 response_format，Provider 应将其透传到请求 body。
+     * 与 supportsStructuredOutput 互斥（response_format 不能与 tools 同时使用，OpenAI 协议限制）：
+     * - 支持 tools → loop 走原生工具通道（列工具 + 传 tools 参数）。
+     * - 支持 structured → loop 传 response_format（JSON mode 回落）。
+     * - 两者皆 false → 无工具能力，loop 收起工具清单并显式告知（可观测，不静默）。
      *
-     * 注意：response_format 不能与 tools 同时使用（OpenAI 协议限制），
-     * tool_calls 走独立的 SSE delta 流式协议，无需此约束。
+     * 默认 **true**（存量行为）：云 LLM 绝大多数支持原生 FC（有工具集就传 tools，与历史一致）。
+     * 本地运行时（Ollama/LM Studio 等）是否支持原生 FC 无法从 baseUrl 推断，须在宿主配置时
+     * 显式置 false（互斥双能力位）。
      */
+    readonly supportsToolCalling: boolean;
+    /** 是否支持结构化输出（默认 false）。注意：response_format 不能与 tools 同时使用（OpenAI 协议限制） */
     readonly supportsStructuredOutput: boolean;
-    /**
-     * 流式对话
-     * 返回 AsyncIterable，每项是一个增量块
-     */
+    /** 流式对话：返回 AsyncIterable，每项是一个增量块 */
     abstract chat(messages: Message[], opts?: ChatOptions): AsyncIterable<LlmChunk>;
 }
 //# sourceMappingURL=provider.d.ts.map