@zooique/memora 2.0.0 → 3.0.0

package/dist/agent/contextManager.js

@@ -7,6 +7,8 @@
  *   3. 关键消息提取（extractKeyMessages）—— 按重要性权重贪心选取
  *   4. 上下文摘要生成（generateContextSummary）—— LLM 生成"遗忘补偿"
  *   5. 摘要缓存管理（getOrCreateSummary）—— 缓存 TTL + 过期重生成
+ *   6. 软上限判定（shouldInjectSoftLimitWrapup）—— 摘要层饱和注入收尾信号（自 AgentLoop 迁入）
+ *   7. 压力预警（shouldInjectContextPressureHint）—— 容量到线但摘要健康的前一级提示
  *
  * 设计理由：AgentLoop 1151 行超阈值，上下文管理是独立职责，
  * 拆分后 AgentLoop 聚焦对话循环，ContextManager 聚焦上下文窗口管理。
@@ -17,6 +19,11 @@
 import { LOOP_CONSTANTS } from '../agent/constants.js';
 import { logger } from '../logging/logger.js';
 import { NOOP_TRACER, TRACE_SPANS } from '../agent/tracer.js';
+import { isAbortError } from '../utils/errors.js';
+/** 软上限摘要化判定标记：第一级替换产物文案前缀（compaction.ts ReplaceRoundsStrategy） */
+export const SOFT_LIMIT_SUMMARY_MARKER_ROUND = 'Round summary · roundId:';
+/** 软上限摘要化判定标记：第二级压缩产物文案前缀（loop.compressContext） */
+export const SOFT_LIMIT_SUMMARY_MARKER_COMPRESS = 'Compressed context';
 /**
  * 判断字符是否为 CJK 字符（中文适配）
  *
@@ -62,6 +69,45 @@ function countCjkAndOther(str) {
     }
     return { cjkChars, otherChars };
 }
+/**
+ * 估算消息序列 token 数（CJK 感知，零状态纯函数）。
+ *
+ * 单一真理源：先累计全部字符、最后一次向上取整——与逐条取整再求和**不等价**
+ * （后者系统性高估）。运行时（`ContextManager.estimateTokens` / contextPreparer
+ * 各层计量）与宿主历史会话占用重算共用本函数，两端口径不漂移。
+ *
+ * @param messages 待估算的消息序列（content 计入，toolCalls 序列化后计入）
+ * @returns token 数（按 CJK/其他字符分轨估算后向上取整）
+ */
+export function estimateTokensMessages(messages) {
+    let cjkChars = 0;
+    let otherChars = 0;
+    for (const m of messages) {
+        const contentCounts = countCjkAndOther(m.content);
+        cjkChars += contentCounts.cjkChars;
+        otherChars += contentCounts.otherChars;
+        if (m.toolCalls) {
+            const toolCallsCounts = countCjkAndOther(JSON.stringify(m.toolCalls));
+            cjkChars += toolCallsCounts.cjkChars;
+            otherChars += toolCallsCounts.otherChars;
+        }
+    }
+    return Math.ceil(cjkChars / LOOP_CONSTANTS.CJK_CHARS_PER_TOKEN + otherChars / LOOP_CONSTANTS.CHARS_PER_TOKEN);
+}
+/**
+ * 估算单段文本 token 数（CJK 感知，零状态纯函数）。
+ *
+ * 供「单段文本」场景使用（如宿主对一条记忆正文的独立计量）。
+ * 计量**消息序列**须用 `estimateTokensMessages`：本函数逐条调用再求和会放大
+ * 取整误差，与本函数同口径但结果不等价。
+ *
+ * @param text 待估算文本
+ * @returns token 数（按 CJK/其他字符分轨估算后向上取整）
+ */
+export function estimateTokensText(text) {
+    const { cjkChars, otherChars } = countCjkAndOther(text);
+    return Math.ceil(cjkChars / LOOP_CONSTANTS.CJK_CHARS_PER_TOKEN + otherChars / LOOP_CONSTANTS.CHARS_PER_TOKEN);
+}
 /**
  * 上下文窗口管理器
  *
@@ -69,149 +115,185 @@ function countCjkAndOther(str) {
  * 从 AgentLoop 提取，保持无状态设计（不持有 messages 引用）。
  */
 export class ContextManager {
-    /** 上下文窗口 token 上限（readonly，构造时传入） */
+    // 组合 root 统一注入为字段，类内不承担 Provider 选址逻辑。
+    // 非 readonly：模型热切换（Agent.setContextWindow）后经 setMaxContextTokens 更新，
+    // 截断阈值 / 软上限 / 召回注入警戒线随新窗口同步重算。
     maxContextTokens;
-    /** LLM Provider（用于 generateContextSummary） */
     provider;
-    /** 截断占位消息文案函数 */
+    providerRouter;
     contextTruncatedFn;
-    /** 可观测性 Tracer（用于 generateContextSummary span 埋点，默认 NOOP） */
     tracer;
-    /** 上下文摘要缓存（首次截断后生成，后续截断复用） */
     contextSummary = null;
-    /** 摘要缓存生成时的消息数量，用于判断缓存是否过期 */
     contextSummaryMsgCount = 0;
-    /** 截断次数统计（truncateMessages 实际触发截断 +1，供 getMetrics 读取） */
     _truncationCount = 0;
+    onContextTruncated;
+    roundSummaryLoader;
+    minRecentRounds;
     constructor(opts) {
         this.maxContextTokens = opts.maxContextTokens;
         this.provider = opts.provider;
+        this.providerRouter = opts.providerRouter;
         this.contextTruncatedFn = opts.contextTruncatedFn;
-        // 未注入 tracer 时降级为 NOOP_TRACER（零开销）
+        this.onContextTruncated = opts.onContextTruncated;
+        this.roundSummaryLoader = opts.roundSummaryLoader;
+        this.minRecentRounds = Math.max(0, Math.floor(opts.minRecentRounds ?? 0));
         this.tracer = opts.tracer ?? NOOP_TRACER;
     }
-    /** 截断次数（供 AgentLoop.getMetrics 读取） */
-    get truncationCount() {
-        return this._truncationCount;
-    }
     /**
-     * 估算消息数组的 token 数（CJK 中文适配）
+     * 运行时更新上下文窗口上限（token）
      *
-     * 区分 CJK 与非 CJK 字符分别估算：
-     *   - CJK 字符（中文/日文/韩文）：cjkChars / CJK_CHARS_PER_TOKEN（1.5）
-     *   - 非 CJK 字符（英文/数字/符号）：otherChars / CHARS_PER_TOKEN（3）
-     * 统一字符估算会严重低估中文（4 字符 ≈ 1.3 token，实际约 4-8 token）。
+     * 截断判定 / 软上限 / 召回注入警戒线均内读本字段，更新即刻生效。
      *
-     * toolCalls 的 JSON 序列化字符数也计入（同样区分 CJK/非 CJK）。
-     *
-     * @param messages 消息数组
-     * @returns 估算的 token 数
+     * @param tokens 新窗口 token 数
      */
-    estimateTokens(messages) {
-        let cjkChars = 0;
-        let otherChars = 0;
-        for (const m of messages) {
-            // 消息内容：区分 CJK 与非 CJK 字符
-            const contentCounts = countCjkAndOther(m.content);
-            cjkChars += contentCounts.cjkChars;
-            otherChars += contentCounts.otherChars;
-            // toolCalls 的 JSON 序列化字符数（同样区分 CJK/非 CJK）
-            if (m.toolCalls) {
-                const toolCallsCounts = countCjkAndOther(JSON.stringify(m.toolCalls));
-                cjkChars += toolCallsCounts.cjkChars;
-                otherChars += toolCallsCounts.otherChars;
-            }
-        }
-        // CJK 与非 CJK 分别按各自密度估算后求和
-        return Math.ceil(cjkChars / LOOP_CONSTANTS.CJK_CHARS_PER_TOKEN +
-            otherChars / LOOP_CONSTANTS.CHARS_PER_TOKEN);
+    setMaxContextTokens(tokens) {
+        this.maxContextTokens = tokens;
+    }
+    get truncationCount() {
+        return this._truncationCount;
     }
     /**
-     * 检查是否需要截断（token 超阈值 + 消息数 > 3）
+     * 估算消息 token 数。
      *
-     * @param messages 消息数组
-     * @returns 是否需要截断
+     * CJK（中/日/韩）与其它字符密度不同需分开估算：
+     * 统一按 3 字符/token 会严重低估中文（实际约 1.5 字符/token）。
+     * toolCalls 序列化字符同样计入。
      */
+    estimateTokens(messages) {
+        return estimateTokensMessages(messages);
+    }
+    /** token 超阈值且消息数 > 3（避免单条消息触发截断）时才需要截断 */
     shouldTruncate(messages) {
         return this.estimateTokens(messages) > this.maxContextTokens && messages.length > 3;
     }
     /**
-     * 截断消息数组以适配上下文窗口
+     * 软上限判定：上下文逼近容量上限（≥ 缓冲阈值）且摘要层 token 占比过高时，注入收尾信号让 LLM 收敛。
+     * 从 AgentLoop._shouldInjectSoftLimitWrapup 迁入（与 estimateTokens/maxContextTokens 同属上下文预算层）。
      *
-     * 策略：保留下方、裁中间、提取关键消息。
-     * - messages[0]（system prompt）始终保留（这是 Agent 的"灵魂"）
-     * - 从尾部向前取最近的消息对（user + assistant + tool），直到估算 token 接近上限
-     * - 从被裁剪的消息中按重要性权重提取关键用户消息，插入到 placeholder 之前
-     * - 头部被裁剪的消息替换为一条摘要占位消息
+     * 精确检测摘要层 token 占用（替代原"存在标记即触发"的近似判断）：
+     *   - 过滤出标记为摘要的消息（Round summary / Compressed context）
+     *   - 计算摘要层 token 占用
+     *   - 当摘要层 token ≥ maxContextTokens × SUMMARY_LAYER_TOKEN_RATIO 时判定为"摘要层达容量上限"
      *
-     * 重要性权重：user 消息 > tool 结果 > assistant 回复
-     * 被裁剪的用户消息中，内容较长的（信息量大）优先保留
+     * @param messages 当前工作记忆（读型判定，不修改）
+     * @returns 是否应注入软上限收尾信号
+     */
+    shouldInjectSoftLimitWrapup(messages) {
+        // 容量阈值：上下文逼近 maxContextTokens 警戒线（≥ CONTEXT_TOKENS_BUFFER_RATIO）
+        const currentTokens = this.estimateTokens(messages);
+        if (currentTokens < this.maxContextTokens * LOOP_CONSTANTS.CONTEXT_TOKENS_BUFFER_RATIO) {
+            return false;
+        }
+        // 精确检测：计算摘要层 token 占用（仅统计标记为摘要的消息）
+        const summaryMessages = messages.filter((m) => m.content.includes(SOFT_LIMIT_SUMMARY_MARKER_ROUND) ||
+            m.content.includes(SOFT_LIMIT_SUMMARY_MARKER_COMPRESS));
+        if (summaryMessages.length === 0) {
+            return false;
+        }
+        // 摘要层 token 占容量阈值比例（≥ SUMMARY_LAYER_TOKEN_RATIO = 30%）
+        const summaryTokens = this.estimateTokens(summaryMessages);
+        return summaryTokens >= this.maxContextTokens * LOOP_CONSTANTS.SUMMARY_LAYER_TOKEN_RATIO;
+    }
+    /**
+     * 上下文压力预警判定：容量表达警戒线（≥ CONTEXT_TOKENS_BUFFER_RATIO）但
+     * 摘要层未饱和（低于 SUMMARY_LAYER_TOKEN_RATIO）时 → 可注入温和提示（压缩/收敛引导）。
+     *
+     * 与 shouldInjectSoftLimitWrapup 互补——同一容量闸的两级：
+     *   摘要层饱和       → shouldInjectSoftLimitWrapup（收尾信号）
+     *   容量到线但摘要健康 → shouldInjectContextPressureHint（软上限的前一级预警）
      *
-     * 如果 system prompt 本身就超过 maxContextTokens，不做截断（让 LLM API 报错，
-     * 开发者需要缩减 bootstrapMemories 或 toolDefinitions）。
+     * @param messages 当前工作记忆（读型判定，不修改）
+     * @returns 是否应注入上下文空间预警提示
+     */
+    shouldInjectContextPressureHint(messages) {
+        // 容量阈值：上下文逼警戒线（≥ CONTEXT_TOKENS_BUFFER_RATIO）
+        const currentTokens = this.estimateTokens(messages);
+        if (currentTokens < this.maxContextTokens * LOOP_CONSTANTS.CONTEXT_TOKENS_BUFFER_RATIO) {
+            return false;
+        }
+        // 摘要层已达饱和 → 归软上限收尾路径，不重复预警（避免与收尾信号叠加）
+        if (this.shouldInjectSoftLimitWrapup(messages)) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * 截断消息数组以适配上下文窗口。
      *
-     * @param messages 完整消息数组
-     * @param summary 可选的上下文摘要（注入到 system prompt 和 placeholder 之间）
-     * @returns 截断后的消息数组（可能是原数组引用，无修改时）
+     * 策略：保留下方（最近）、裁中间、头部折叠成占位消息。
+     * - messages[0]（system prompt）始终保留；
+     * - 从被裁剪段按重要性（user > tool > assistant）提取关键消息；
+     * - 若 system prompt 本身已超窗口则不截断（配置问题，交由 LLM API 报错）。
      */
     truncateMessages(messages, summary) {
         const estimated = this.estimateTokens(messages);
         if (estimated <= this.maxContextTokens || messages.length <= 3) {
-            return messages; // 未超阈值，无需截断
+            return messages;
         }
-        // system prompt 单独保留
         const systemMsg = messages[0];
         if (!systemMsg || systemMsg.role !== 'system') {
-            return messages; // 异常：没有 system prompt，不截断
+            return messages;
         }
         const systemTokens = this.estimateTokens([systemMsg]);
         if (systemTokens >= this.maxContextTokens) {
-            // system prompt 本身就超了——这是配置问题，不应该截断
             logger.warn({ systemTokens, maxContextTokens: this.maxContextTokens }, 'system prompt 已超过上下文窗口上限，请缩减 bootstrapMemories 或 toolDefinitions');
             return messages;
         }
-        // 剩余可用 token 数（留 10% 缓冲给 LLM 响应）
+        // 留 10% 缓冲给 LLM 响应
         const availableTokens = Math.floor(this.maxContextTokens * LOOP_CONSTANTS.CONTEXT_TOKENS_BUFFER_RATIO) - systemTokens;
-        // 从尾部向前收集消息（最近的最重要）
+        // 从尾部向前收集最近消息（tail 区）；cutIndex 记录裁剪起始
         const tail = [];
         let tailTokens = 0;
-        let cutIndex = messages.length; // 被裁剪区域的起始索引
+        let cutIndex = messages.length;
+        // 强制保留最近 minRecentRounds 轮原始对话，不被摘要替代（0=不强制）
+        let forcedTailCount = 0;
+        if (this.minRecentRounds > 0) {
+            let userSeen = 0;
+            for (let i = messages.length - 1; i >= 1; i--) {
+                const msg = messages[i];
+                if (!msg)
+                    break;
+                if (msg.role === 'user')
+                    userSeen++;
+                if (userSeen > this.minRecentRounds)
+                    break;
+                forcedTailCount++;
+            }
+        }
         for (let i = messages.length - 1; i >= 1; i--) {
-            // QC-17 移除非空断言：循环条件保证索引有效，null 检查兜底
             const msg = messages[i];
             if (!msg)
                 break;
             const msgTokens = this.estimateTokens([msg]);
-            if (tailTokens + msgTokens > availableTokens) {
-                cutIndex = i + 1; // cutIndex 是第一条被保留的尾部消息
-                break; // 再加这条就超了
+            // 强制保留区不计入 token 上限；超出该区才按 token 截断
+            const inForced = tail.length < forcedTailCount;
+            if (!inForced && tailTokens + msgTokens > availableTokens) {
+                cutIndex = i + 1;
+                break;
             }
-            tail.unshift(msg); // 保持顺序：从尾部取，但插入时保持时间顺序
+            tail.unshift(msg);
             tailTokens += msgTokens;
             cutIndex = i;
         }
-        // 计算被裁剪的消息
-        const skipped = cutIndex - 1; // -1 是 system prompt
+        // 去掉 system prompt（-1）；裁剪数为 0 说明全部保留
+        const skipped = cutIndex - 1;
         if (skipped <= 0) {
-            return messages; // 全部保留
+            return messages;
         }
-        // 截断次数统计：确实发生了截断（skipped > 0）
         this._truncationCount++;
-        // 从被裁剪的消息中按重要性提取关键消息
-        // 重要性权重：user > tool > assistant；内容较长的用户消息优先
+        this.onContextTruncated?.(skipped, tail.length);
+        // 从被裁剪段按重要性提取关键消息（保留信息量最高的用户输入）
         const cutMessages = messages.slice(1, cutIndex);
         const keyMessages = this.extractKeyMessages(cutMessages, availableTokens - tailTokens);
-        // 构造一条占位消息，让 LLM 知道有历史被裁剪了
+        // 占位消息：告知 LLM 有历史被裁剪
         const placeholder = {
             role: 'system',
             content: this.contextTruncatedFn(skipped, tail.length),
         };
         const truncated = [systemMsg];
-        // 如果有摘要，插入到 system prompt 和 placeholder 之间
         if (summary) {
             truncated.push({ role: 'system', content: summary });
         }
-        // 插入从被裁剪区域提取的关键消息
         truncated.push(...keyMessages);
         truncated.push(placeholder);
         truncated.push(...tail);
@@ -227,37 +309,24 @@ export class ContextManager {
         return truncated;
     }
     /**
-     * 从被裁剪的消息中按重要性提取关键消息
-     *
-     * 重要性权重：
-     * - user 消息：权重 3（用户输入信息量最高）
-     * - tool 消息：权重 2（工具结果有参考价值）
-     * - assistant 消息：权重 1（助手回复可从上下文推断）
-     *
-     * 贪心选取：按权重降序 + 内容长度降序排列，逐条选取直到 token 用完。
-     * 最终按原始顺序返回（保持时间线一致性）。
-     *
-     * @param cutMessages 被裁剪的消息数组
-     * @param availableTokens 可用 token 数
-     * @returns 提取的关键消息数组（按原始顺序）
+     * 从被裁剪段按重要性贪心选取关键消息，保留信息量最高的用户输入。
+     * 权重：user=3 > tool=2 > assistant=1，同级按内容长度；最后恢复原始顺序。
      */
     extractKeyMessages(cutMessages, availableTokens) {
         if (availableTokens <= 0 || cutMessages.length === 0)
             return [];
-        // 计算每条消息的权重和 token 数
         const weighted = cutMessages.map((msg, index) => ({
             msg,
-            index, // 原始顺序索引
+            index, // 原始顺序索引（最终恢复用）
             weight: this.messageImportance(msg),
             tokens: this.estimateTokens([msg]),
         }));
-        // 按权重降序 + 内容长度降序排列
         weighted.sort((a, b) => {
             if (b.weight !== a.weight)
                 return b.weight - a.weight;
             return b.msg.content.length - a.msg.content.length;
         });
-        // 贪心选取，直到 token 用完
+        // 贪心选取直到 token 用完
         const selected = [];
         let usedTokens = 0;
         for (const item of weighted) {
@@ -266,16 +335,11 @@ export class ContextManager {
             selected.push(item);
             usedTokens += item.tokens;
         }
-        // 恢复原始顺序（保持时间线一致性）
+        // 恢复原始顺序，保持时间线一致
         selected.sort((a, b) => a.index - b.index);
         return selected.map((item) => item.msg);
     }
-    /**
-     * 评估单条消息的重要性权重
-     *
-     * @param msg 消息
-     * @returns 权重值（user=3, tool=2, assistant=1）
-     */
+    /** 消息重要性权重：user>tool>assistant */
     messageImportance(msg) {
         if (msg.role === 'user')
             return 3;
@@ -284,60 +348,63 @@ export class ContextManager {
         return 1;
     }
     /**
-     * 获取或创建上下文摘要（带缓存管理）
+     * 作废摘要缓存
      *
-     * 缓存 TTL：消息数增长超过 SUMMARY_CACHE_TTL_MSGS 时缓存过期，需重新生成。
-     * 首次调用时生成摘要并缓存，后续调用复用缓存直到过期。
+     * 缓存过期靠 `messages.length - contextSummaryMsgCount > TTL` 这个**单向**数值判断，
+     * 只覆盖「消息增长」。当消息集合被整体替换（`AgentLoop.restoreHistory` 恢复检查点）
+     * 且新历史更短时，差值为负 → 陈旧摘要永不过期，会把上一段会话的摘要注入新上下文。
      *
-     * signal 参数让摘要生成可被用户取消中断，
-     * 避免摘要 LLM 调用卡住时 generator 永久挂起（与 executeToolCalls 同源问题）。
+     * 修法不是把条件改成 `Math.abs`：truncateMessages 的正常裁剪同样让消息变少，
+     * 而那时摘要恰恰更该保留（它描述的就是被裁掉的历史）。真理源是「消息集合是否被替换」
+     * 这一事实，故由替换方显式作废，而非从长度差反推。
+     */
+    resetSummary() {
+        this.contextSummary = null;
+        this.contextSummaryMsgCount = 0;
+    }
+    /**
+     * 获取或创建上下文摘要（带缓存）。
      *
-     * @param messages 当前消息数组（用于生成摘要和判断缓存过期）
-     * @param signal 可选的 AbortSignal，中断摘要生成
-     * @returns 摘要字符串（失败/中断时返回空字符串，降级为无摘要）
+     * 缓存 TTL：消息数增长超 SUMMARY_CACHE_TTL_MSGS 即过期重生成。
+     * signal 使摘要 LLM 可被中断，避免其卡住时挂起调用方。
      */
     async getOrCreateSummary(messages, signal) {
-        // 检查缓存是否有效
         const summaryExpired = this.contextSummary !== null &&
             messages.length - this.contextSummaryMsgCount > LOOP_CONSTANTS.SUMMARY_CACHE_TTL_MSGS;
         if (this.contextSummary && !summaryExpired) {
             return this.contextSummary;
         }
-        // 生成新摘要（传入 signal 支持中断）
         const summary = await this.generateContextSummary(messages, signal);
         this.contextSummary = summary;
         this.contextSummaryMsgCount = messages.length;
         return summary;
     }
     /**
-     * 生成上下文摘要（enableContextSummary 时调用）
-     *
-     * 在首次截断时，提取即将被裁剪的消息中最近几条用户/助手对话，
-     * 调用 provider 生成一句摘要，作为"遗忘补偿"注入到 system prompt 中。
-     *
-     * 通过 tracer span 埋点（TRACE_SPANS.CONTEXT_SUMMARY），
-     * 让宿主监控面板能观察截断频率、摘要生成耗时与失败率。
+     * 生成上下文摘要：把被裁剪段压缩成"遗忘补偿"注入 system prompt。
      *
-     * signal 参数传入 provider.chat 的 ChatOptions，
-     * 让 fetch 请求和 SSE 流读取都能被 abort 中断；
-     * for await 循环中也检查 signal.aborted 提前退出。
-     *
-     * @param messages 当前消息数组
-     * @param signal 可选的 AbortSignal
-     * @returns 摘要字符串（失败/中断时返回空字符串，降级为无摘要）
+     * 策略：
+     * - 优先复用已存的 round-summary（每轮后台生成的零成本产物），仅无已存摘要才调 LLM；
+     * - 走 providerRouter 的 'summary' 路由（轻量模型），未配置则回退主 provider；
+     * - abort 或失败一律降级为空串返回，不影响主流程。
      */
     async generateContextSummary(messages, signal) {
-        // 启动 CONTEXT_SUMMARY span，记录摘要生成的耗时与异常
         const summarySpan = this.tracer.startSpan(TRACE_SPANS.CONTEXT_SUMMARY, {
             messageCount: messages.length,
             summarizingMessages: Math.min(messages.length - 1, LOOP_CONSTANTS.SUMMARY_MSG_COUNT),
         });
         try {
-            // signal 已 abort 时直接返回空，不发起 LLM 调用
             if (signal?.aborted) {
                 summarySpan.setAttribute('aborted', true);
                 return '';
             }
+            if (this.roundSummaryLoader) {
+                const existing = this.roundSummaryLoader();
+                if (existing) {
+                    summarySpan.setAttribute('source', 'round-summary');
+                    logger.debug('上下文截断复用已存 round-summary，跳过 LLM 摘要生成');
+                    return existing;
+                }
+            }
             const messagesToSummarize = messages.slice(1);
             const recentMessages = messagesToSummarize
                 .filter((m) => m.role === 'user' || (m.role === 'assistant' && typeof m.content === 'string'))
@@ -348,8 +415,8 @@ export class ContextManager {
                 summarySpan.setAttribute('skipped', true);
                 return '';
             }
-            // 将 signal 注入 ChatOptions，让 provider 的 fetch/SSE 能被 abort 中断
-            const stream = this.provider.chat([
+            const summaryProvider = this.providerRouter ? this.providerRouter('summary') : this.provider;
+            const stream = summaryProvider.chat([
                 {
                     role: 'system',
                     content: 'Summarize the following conversation excerpt in 1-2 sentences. Focus on key facts, decisions, and user preferences. Be concise.',
@@ -362,7 +429,6 @@ export class ContextManager {
             });
             let summary = '';
             for await (const chunk of stream) {
-                // 流读取过程中检查 abort，提前退出（provider 收到 abort 会抛 AbortError 进入 catch）
                 if (signal?.aborted) {
                     summarySpan.setAttribute('aborted', true);
                     break;
@@ -370,7 +436,6 @@ export class ContextManager {
                 if (chunk.content)
                     summary += chunk.content;
             }
-            // 被中断时返回空字符串（降级为无摘要），不缓存
             if (signal?.aborted) {
                 return '';
             }
@@ -379,20 +444,17 @@ export class ContextManager {
             return `[Context summary of earlier conversation]\n${summary}`;
         }
         catch (err) {
-            // AbortError 是用户主动取消，降级为无摘要，不当作错误
-            const isAbort = err instanceof Error && err.name === 'AbortError';
-            if (isAbort) {
+            // AbortError 是用户主动取消，降级为无摘要而非错误
+            if (isAbortError(err)) {
                 summarySpan.setAttribute('aborted', true);
                 logger.debug('上下文摘要生成被中断，降级为无摘要');
                 return '';
             }
-            // 记录异常到 span（不中断 span，标记错误状态）
             summarySpan.recordException(err instanceof Error ? err : new Error(String(err)));
             logger.warn({ err }, '上下文摘要生成失败，降级为无摘要');
             return '';
         }
         finally {
-            // 无论成功/失败都结束 span
             summarySpan.end();
         }
     }

package/dist/agent/contextManager.js.map

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

package/dist/agent/contextPreparer.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Agent 输入增强管线 — 外部输入 → 上下文装配
+ *
+ * 职责：
+ *   - assembleContext：上下文装配（预算派生 + 对话层注入 + 占用快照）。
+ *     每轮无自动记忆召回（memory-tool-recall-design §3/§4），检索由 LLM 经 search_memories 工具主动触发。
+ *   - 角色包只能手动切换，无 autoMatch / LLM 语义兜底（无角色自动匹配）
+ *
+ * 设计原则：
+ *   - 只依赖 Agent 注入的稳定能力（deps），不反向依赖 Agent 私有状态（与 AgentHooks 同构）
+ *   - 管线逻辑单一真理源：对话层注入/占用快照随管线走
+ *   - Agent 门面保留编排骨架（thinking 阶段 yield 与调用点），叶子逻辑在此唯一实现
+ *   - 事件发射（inputTooLarge）经 emit 回调由 Agent 承接
+ */
+import type { AgentLoop } from '../agent/loop.js';
+import type { RolePackManager } from '../role-pack/rolePackManager.js';
+import type { IMemoryStorage } from '../memory/storageInterface.js';
+import type { UIMessages } from '../agent/types.js';
+import { type AgentEventName } from '../utils/eventEmitter.js';
+import type { ITracer } from '../agent/tracer.js';
+/**
+ * 输入增强管线的依赖注入接口（Agent 稳定能力的窄面）
+ *
+ * 边界：只传 Agent 的稳定能力（组件引用 / 配置 / 事件发射），
+ * 不传可变私有状态。
+ */
+export interface ContextPreparerDeps {
+    /** AgentLoop（最近对话注入 + 召回互斥排除集派生） */
+    loop: AgentLoop;
+    /** 角色包管理器（策略来源；可为空） */
+    rolePackManager: RolePackManager | null;
+    /** 懒取项目记忆索引（requirePctx.index 等价物，避免持有可变 ProjectContext 引用） */
+    getIndex: () => IMemoryStorage;
+    /** 宿主可观测性 / 存储 / 文案配置 */
+    config: {
+        /** 可观测性 Tracer（可选，缺省 Noop） */
+        tracer: ITracer | null;
+        /** 界面文案（最近对话 / 用户 / 助手标签） */
+        messages: UIMessages | undefined;
+        /** 上下文窗口容量（token）：唯一真理源 = 宿主在构造内核前经 resolveContextWindow(window) 解析注入的单一数字（per-LLM 窗口，缺失回退默认 120K）。内核预算路径只消费单一数字，不认 provider/用户双层来源 */
+        maxContextTokens: number;
+    };
+    /** 事件发射（桥接到 Agent 强类型 emit） */
+    emit: (event: AgentEventName, data: unknown) => void;
+}
+/**
+ * 输入增强管线协调器
+ *
+ * 承载 chat() 回答前的输入增强：记忆召回 + 固定轮次注入。Agent.prepareChatContext
+ * 保留编排骨架，本类唯一实现叶子逻辑。
+ */
+export declare class ContextPreparer {
+    /** 依赖注入集合（Agent 稳定能力窄面） */
+    private readonly deps;
+    constructor(deps: ContextPreparerDeps);
+    /**
+     * 运行时更新上下文窗口上限（token）
+     *
+     * 模型热切换（Agent.setContextWindow）后调用：deps.config.maxContextTokens 为装配期
+     * 值拷贝，须显式同步——否则每轮 prepare 的预算派生（computeContextBudget）与占用快照
+     * （recordOccupancy 的 totalTokens / outputReserve / free）仍用旧窗口。
+     *
+     * @param tokens 新窗口 token 数
+     */
+    setMaxContextTokens(tokens: number): void;
+    /**
+     * 上下文装配（纯上下文装配，无自动召回）
+     *
+     * 记忆检索由 LLM 经 search_memories 工具主动触发（builtinToolHandlers.searchMemories），
+     * 本方法不代模型猜测"此刻需要什么记忆"，只做纯**上下文装配**：预算派生 + roundId 互斥 +
+     * 对话层注入 + 上下文占用快照，不返回任何自动召回的注入记忆。
+     * 对话层注入恒走 hybrid（最近对话摘要注入），无 fixed/query 分支。
+     *
+     * @param input 用户输入（仅作顶级锚点预算估算，不再作为召回 query）
+     */
+    assembleContext(input: string): Promise<void>;
+}
+//# sourceMappingURL=contextPreparer.d.ts.map