@zooique/memora 2.0.3 → 3.0.1

package/dist/agent/managers/llmCaller.d.ts

@@ -0,0 +1,124 @@
+/**
+ * LLM 调用族 — 模型触碰面（重试 / 任务类型路由 / 流式分类）
+ *
+ * 本族的 loop 私有 state 触点**全是「可注入的协作者」**（metrics / strategy / contextManager /
+ * tracer / opts），没有一个是「loop 自己的可变状态」，故经构造注入取值器（getter）取用即可，
+ * 属「换位置仍自治」；而工具编排本体（`executeToolCalls`，多处写 loop 状态）不在此族。
+ *
+ * ## 两条不可回退的纪律
+ *
+ * 1. **必须传 getter 而非快照**：`strategy` / `provider` 均为运行时可热切换
+ *    （`setStrategy` 浅合并新对象、`setProvider` 改 `opts.provider`），且
+ *    `strategy.errorHandling` 在**重试循环体内**被读 3 次——传快照会在重试中途读到旧值。
+ * 2. **`routeCache` 由 loop 持有并跨族共享**：它在**每轮 turn 入口**（`processUserInput`）
+ *    被 `clear()`，而 turn 内单轮问答查表即中——若改为本类实例字段且调用方逐次新建实例，
+ *    **每轮都重算路由**（跨轮缓存失效），而缓存的语义是「单轮内复用，跨轮重置」。故 Map 归
+ *    loop，本类只经读写回调操作它。
+ */
+import type { LlmProvider, Message, ChatOptions } from '../../llm/provider.js';
+import type { ProviderRouter, TaskType, LlmChunk } from '../../llm/types.js';
+import type { AgentChunk, TextChunkStage } from '../../agent/types.js';
+import type { ITracer } from '../../agent/tracer.js';
+import type { LoopMetrics } from '../../agent/managers/loopMetrics.js';
+/** 上下文估算能力窄面（`ContextManager.estimateTokens`） */
+export interface TokenEstimator {
+    estimateTokens(messages: readonly Message[]): number;
+}
+/**
+ * 多模型路由所需的 loop 侧能力子集。
+ * 全部为**取值器 / 回调**而非值快照——保证热切换（`setProvider` / `setStrategy`）即时生效。
+ */
+export interface LlmCallerDeps {
+    /** 运行时指标容器（loop 持有，引用共享；搬走不影响计数正确性） */
+    readonly metrics: LoopMetrics;
+    /** 当前 L2 策略。**必须是 getter**：`errorHandling` 在重试循环内被读 3 次 */
+    readonly getStrategy: () => LlmCallerStrategyView;
+    /** 当前 Provider。**必须是 getter**：`setProvider` 为热切换 */
+    readonly getProvider: () => LlmProvider;
+    /** 任务类型路由回调；未注入时走固定 Provider */
+    readonly getProviderRouter: () => ProviderRouter | undefined;
+    /** 路由缓存读（Map 归 loop 持有，见文件头纪律 2） */
+    readonly getCachedProvider: (taskType: TaskType) => LlmProvider | undefined;
+    /** 路由缓存写 */
+    readonly setCachedProvider: (taskType: TaskType, provider: LlmProvider) => void;
+    /** 上下文管理器（token 估算） */
+    readonly contextManager: TokenEstimator;
+    /** 追踪器 */
+    readonly tracer: ITracer;
+    /** 本闭环是否已执行过工具。**必须是 getter**：同一 turn 内会被 set true */
+    readonly hasToolExecutedThisTurn: () => boolean;
+}
+/** `LlmCaller` 实际读取的策略字段（避免整体依赖 `L2RuntimeStrategy` 造成接口面膨胀） */
+export interface LlmCallerStrategyView {
+    /** 出错处理：'stop' 立即抛出 / 'degrade' 降级为已生成文本 / 其余走重试 */
+    readonly errorHandling: string;
+    /** 'manual' → 强制低推理深度（provider 支持时） */
+    readonly multiStepReasoning: string;
+    /** 'fixed' → 跳过路由，固定用默认 Provider */
+    readonly providerRouting: string;
+}
+/** LLM 调用结果（loop 侧消费者：`_callAndRoute` / `handleToolCalls` / `handleAskUser` /
+ *  `handleTextResponse`，均在本族之外，故为导出类型） */
+export interface LlmCallResult {
+    fullContent: string;
+    toolCalls: Message['toolCalls'];
+    aborted: boolean;
+    /**
+     * 文本通道剥离缓冲：工具轮叙述文本（本闭环已执行过工具后的整条消息文本，
+     * 或收到 toolCalls 信号后后续/同条的 content）累积于此。结果路由据此发射
+     * narrate 事件，不进回答正文；纯文本闭环（无工具史）正文保持按流式实时 yield。
+     */
+    pendingNarrate: string;
+    /**
+     * 本轮正文是否曾逐字流式 yield（工具闭环内延迟分类的消息未 yield → false）。
+     * 结果路由据此在纯文本/中断路径补发整段 text，避免缓冲文本对 UI 不可见。
+     */
+    textStreamed: boolean;
+    /**
+     * 回抽：本闭环内逐字流式 yield 进正文区的**原文**（stage='answer'）。
+     *
+     * 首轮（无工具史）消息级分类前无法预判工具轮 → 文本已实时流式进正文；一旦收到 toolCalls，
+     * 结果路由据此发 `narrate.withdrawn` 告知消费者「该段其实属过程叙述，先撤回再渲染」。
+     * 纯文本闭环（正文即最终交付）与工具闭环内延迟分类路径（未 yield）恒为空串。
+     */
+    streamedText: string;
+    /**
+     * 末次 chat 尝试回传的 finish_reason（诊断分型证据）。
+     * `'length'` = 输出预算截断（思考/生成吃满上限），loop 据此把空响应判「截断型」；
+     * 中转不回传则 undefined = 按「瞬态型」降级（降级不劣化，维持现状文案）。
+     */
+    finishReason?: LlmChunk['finishReason'];
+    /** 末次 chat 尝试的 thinking 字符数（reasoning_content 增量累计；无思考模型恒 0。重试重置，取末次口径） */
+    thinkingChars: number;
+    /** 收场前的 chat 尝试总数（1 = 首试即收场；空响应重试累加。重试属同一步内的多次尝试，非多个 step） */
+    attempts: number;
+}
+/**
+ * 确定当前回合任务类型（多模型路由）：含代码块→code；长文本(>500字符)→reasoning；其余→simple
+ *
+ * 纯函数（零 state 触点），独立导出便于单测与复用。
+ */
+export declare function determineTaskType(messages: readonly Message[]): TaskType;
+/** LLM 调用执行器：多模型路由 + 指数退避重试 + 流式文本通道分类 */
+export declare class LlmCaller {
+    private readonly deps;
+    constructor(deps: LlmCallerDeps);
+    /**
+     * 多模型路由：按任务类型选 Provider；单轮内缓存同一 taskType 结果，避免重复路由计算。
+     * 三分支收敛：strategy='fixed' → 默认 Provider；有 providerRouter → 路由 + 缓存；否则 fallback 默认。
+     */
+    resolveProvider(safeMessages: readonly Message[]): LlmProvider;
+    /**
+     * 调用 LLM（带指数退避重试，仅在流式输出前失败时重试；流式已开始则直接上抛，因用户已看到部分结果）。
+     * 经 providerRouter 按任务类型路由到对应 Provider。
+     */
+    callWithRetry(safeMessages: readonly Message[], chatOpts: ChatOptions, signal: AbortSignal | undefined, iteration: number, 
+    /** 流式文本阶段标识（默认正常交付 'answer'；自审查应答由调用方传 'self_review'） */
+    stage?: TextChunkStage): AsyncGenerator<AgentChunk, LlmCallResult, unknown>;
+    /**
+     * 重试延迟 + abort 支持：发射 retry chunk，等待指数退避延迟（支持中途 abort）；
+     * 调用方在延迟后自行检查 signal.aborted 决定是否退出重试循环
+     */
+    waitForRetryWithAbort(attempt: number, lastError: Error | null, signal: AbortSignal | undefined): AsyncGenerator<AgentChunk, void, unknown>;
+}
+//# sourceMappingURL=llmCaller.d.ts.map

package/dist/agent/managers/llmCaller.d.ts.map

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

package/dist/agent/managers/llmCaller.js

@@ -0,0 +1,417 @@
+/**
+ * LLM 调用族 — 模型触碰面（重试 / 任务类型路由 / 流式分类）
+ *
+ * 本族的 loop 私有 state 触点**全是「可注入的协作者」**（metrics / strategy / contextManager /
+ * tracer / opts），没有一个是「loop 自己的可变状态」，故经构造注入取值器（getter）取用即可，
+ * 属「换位置仍自治」；而工具编排本体（`executeToolCalls`，多处写 loop 状态）不在此族。
+ *
+ * ## 两条不可回退的纪律
+ *
+ * 1. **必须传 getter 而非快照**：`strategy` / `provider` 均为运行时可热切换
+ *    （`setStrategy` 浅合并新对象、`setProvider` 改 `opts.provider`），且
+ *    `strategy.errorHandling` 在**重试循环体内**被读 3 次——传快照会在重试中途读到旧值。
+ * 2. **`routeCache` 由 loop 持有并跨族共享**：它在**每轮 turn 入口**（`processUserInput`）
+ *    被 `clear()`，而 turn 内单轮问答查表即中——若改为本类实例字段且调用方逐次新建实例，
+ *    **每轮都重算路由**（跨轮缓存失效），而缓存的语义是「单轮内复用，跨轮重置」。故 Map 归
+ *    loop，本类只经读写回调操作它。
+ */
+import { NOOP_TRACER, TRACE_SPANS } from '../../agent/tracer.js';
+import { LOOP_CONSTANTS } from '../../agent/constants.js';
+import { filterCallableToolCalls, auditToolCallPairing } from '../../agent/managers/toolCallHelpers.js';
+import { isAbortError } from '../../utils/errors.js';
+import { toError } from '../../utils/toError.js';
+import { sha256Fingerprint } from '../../utils/hash.js';
+import { safeSetTimeout } from '../../utils/safeTimer.js';
+import { logger } from '../../logging/logger.js';
+/**
+ * 截断型空响应的换策略纠正提示（一次性注入消息尾）：模型面向的协议级指令，
+ * 与 degrade 降级文案同为内联中文常量——非 UI 文案，不进 UIMessages（宿主可覆盖面不膨胀）。
+ */
+const TRUNCATION_RECOVERY_HINT = '上一次回复因思考耗尽输出预算被截断，请直接给出结论或工具调用';
+/**
+ * 确定当前回合任务类型（多模型路由）：含代码块→code；长文本(>500字符)→reasoning；其余→simple
+ *
+ * 纯函数（零 state 触点），独立导出便于单测与复用。
+ */
+export function determineTaskType(messages) {
+    // 从后向前取最近 N 条 user 消息作为检测窗口（多轮对话中真正含代码的请求可能不在最后一条）
+    const recentUserContents = [];
+    for (let i = messages.length - 1; i >= 0 && recentUserContents.length < LOOP_CONSTANTS.TASK_TYPE_WINDOW; i--) {
+        if (messages[i]?.role === 'user') {
+            recentUserContents.push(messages[i].content ?? '');
+        }
+    }
+    // 代码相关关键词检测：窗口内任一条含代码块标记 → code（避免含代码请求被后续追问稀释误判）
+    if (recentUserContents.some((c) => /```(?:ts|js|py|go|rust|java|css|html|sql)\b/i.test(c))) {
+        return 'code';
+    }
+    // 长文本复杂推理判定（以最近一条 user 消息反映当前轮意图；阈值归入 LOOP_CONSTANTS）
+    const lastContent = recentUserContents[0] ?? '';
+    if (lastContent.length > LOOP_CONSTANTS.REASONING_INPUT_CHARS) {
+        return 'reasoning';
+    }
+    return 'simple';
+}
+/** LLM 调用执行器：多模型路由 + 指数退避重试 + 流式文本通道分类 */
+export class LlmCaller {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * 多模型路由：按任务类型选 Provider；单轮内缓存同一 taskType 结果，避免重复路由计算。
+     * 三分支收敛：strategy='fixed' → 默认 Provider；有 providerRouter → 路由 + 缓存；否则 fallback 默认。
+     */
+    resolveProvider(safeMessages) {
+        if (this.deps.getStrategy().providerRouting === 'fixed') {
+            return this.deps.getProvider();
+        }
+        const router = this.deps.getProviderRouter();
+        if (router) {
+            const taskType = determineTaskType(safeMessages);
+            const cached = this.deps.getCachedProvider(taskType);
+            if (cached)
+                return cached;
+            const routed = router(taskType);
+            this.deps.setCachedProvider(taskType, routed);
+            return routed;
+        }
+        return this.deps.getProvider();
+    }
+    /**
+     * 调用 LLM（带指数退避重试，仅在流式输出前失败时重试；流式已开始则直接上抛，因用户已看到部分结果）。
+     * 经 providerRouter 按任务类型路由到对应 Provider。
+     */
+    async *callWithRetry(safeMessages, chatOpts, signal, iteration, 
+    /** 流式文本阶段标识（默认正常交付 'answer'；自审查应答由调用方传 'self_review'） */
+    stage = 'answer') {
+        const { metrics, contextManager, tracer } = this.deps;
+        let fullContent = '';
+        let toolCalls = undefined;
+        let streamStarted = false;
+        let lastError = null;
+        let aborted = false;
+        // 文本通道剥离：是否已进入「工具调用轮」（收到 toolCalls 信号后后续 text 均属叙述）
+        let isToolCallTurn = false;
+        // 叙述累积：工具轮 text（同条 content + 信号后的后续 content），route 时作为 narrate 发射
+        let pendingNarrate = '';
+        /** 本轮是否曾逐字流式 yield 过正文（纯文本闭环逐字；工具闭环延迟分类则全程 false） */
+        let textStreamed = false;
+        /** 回抽：已流式 yield 进正文的原文（供工具轮撤回；见 LlmCallResult.streamedText） */
+        let streamedText = '';
+        /** 末次 chat 尝试的 finish_reason（诊断分型证据：'length' = 输出预算截断） */
+        let finishReason = undefined;
+        /** 末次 chat 尝试的 thinking 字符数（诊断证据：截断型常伴随思考吃满输出预算） */
+        let thinkingChars = 0;
+        /** 实际进行过的 chat 尝试计数（attempt 为 for 作用域变量、出循环不可见；此计数器全程可读） */
+        let attemptsMade = 0;
+        /** 截断型换策略标记（粘性）：空响应且 finish_reason='length' 后置真，后续尝试全程降推理深度 + 携带纠正提示 */
+        let truncatedRetry = false;
+        // 消息级延迟分类：本闭环已执行过工具（toolExecutedThisTurn）后，
+        // 后续 LLM 消息的文本整段缓冲到消息结束再分类——工具轮 → narrate（含信号前全文），
+        // 纯文本 → 由路由补发 text。单轮问答/首轮（无工具史）保持逐字流式，不受影响。
+        const deferTextToMessageEnd = this.deps.hasToolExecutedThisTurn();
+        // 将 AbortSignal 与超时传入 provider，确保 fetch 与 SSE 流读取能被及时中断（用户取消/超时）
+        const effectiveOpts = {
+            ...chatOpts,
+            signal,
+            timeoutMs: LOOP_CONSTANTS.LLM_TIMEOUT_MS,
+        };
+        // multiStepReasoning='manual' → 强制低推理深度（若 Provider 支持）
+        if (this.deps.getStrategy().multiStepReasoning === 'manual') {
+            effectiveOpts.reasoning_effort = 'low';
+        }
+        // 多模型路由：按任务类型选 Provider（resolveProvider，含缓存）
+        const effectiveProvider = this.resolveProvider(safeMessages);
+        // LLM 调用 Span（涵盖重试循环）
+        const llmSpan = tracer.startSpan(TRACE_SPANS.LLM_CALL, {
+            model: effectiveProvider.name,
+            messageCount: safeMessages.length,
+            iteration,
+        });
+        llmSpan.setAttribute('inputTokens', contextManager.estimateTokens(safeMessages));
+        // 记录"模型看到了什么"的系统提示指纹（只记 hash 不记内容，可观测性职责；仅真实 Tracer 时计算避免热路径开销）
+        if (tracer !== NOOP_TRACER) {
+            const systemPrompt = safeMessages
+                .filter((m) => m.role === 'system')
+                .map((m) => m.content)
+                .join('\n');
+            llmSpan.setAttribute('systemPromptHash', sha256Fingerprint(systemPrompt));
+        }
+        // ─── 发送边界守卫 ───
+        // 坏批次（assistant.tool_calls 未成形）绝不上线路：在发往前拦截、fail-fast。
+        // 健康态散点已按构造保证成形，故此处**健康态恒零命中**；
+        // 命中 = 某散点回归（内核 bug 信号），须响亮暴露而非静默吞/重试（坏批次重试无益且掩盖根因），
+        // 故抛**非临时错误**，经 loop（processUserInput rethrow）外显到宿主出错面，止损本轮 token。
+        const pairingViolations = auditToolCallPairing(safeMessages);
+        if (pairingViolations.length > 0) {
+            metrics.llmPairingGuardFires++;
+            const cause = pairingViolations.map((v) => `${v.kind}:${v.toolCallId}`).join(', ');
+            logger.error({ violations: pairingViolations, messageCount: safeMessages.length }, `发送边界守卫拒绝：tool_call 批次成形违规（${cause}），将不发送本请求（= 构造期散点回归）`);
+            llmSpan.recordException(new Error(`发送边界守卫拒绝：${cause}`));
+            llmSpan.end();
+            throw new Error(`发送边界守卫拒绝：tool_call 批次成形违规（${cause}）`);
+        }
+        for (let attempt = 0; attempt <= LOOP_CONSTANTS.MAX_LLM_RETRIES; attempt++) {
+            // 每次重试前检查是否已被取消（用户点击停止）
+            if (signal?.aborted) {
+                aborted = true;
+                break;
+            }
+            if (attempt > 0) {
+                yield* this.waitForRetryWithAbort(attempt, lastError, signal);
+                // 重试后重置流式状态，避免沿用上次的累积输出
+                fullContent = '';
+                toolCalls = undefined;
+                pendingNarrate = '';
+                streamedText = '';
+                isToolCallTurn = false;
+                // 诊断证据同口径重置：finishReason/thinkingChars 取末次尝试值（与结果路由读到的收场同源）
+                finishReason = undefined;
+                thinkingChars = 0;
+                if (signal?.aborted) {
+                    aborted = true;
+                    break;
+                }
+            }
+            try {
+                attemptsMade++;
+                metrics.llmCallCount++;
+                metrics.totalInputTokens += contextManager.estimateTokens(safeMessages);
+                // 截断型换策略（双轨，方案 T2）：①降推理深度已在下方 empty 分支随 truncatedRetry 置入
+                // effectiveOpts.reasoning_effort='low'（复用 multiStepReasoning='manual' 既有转达通道，
+                // provider 支持才生效）；②纠正提示注入消息尾（提示保底——reasoning_effort 被中转无视
+                // 也不劣化，模型仍收到「直接给结论或工具调用」的指令）。**每请求恰一条**：requestMessages
+                // 每次从 safeMessages 重建、提示不进历史，多轮重试恒 1 条（一次性 = 不堆叠，非只注首次）。
+                const requestMessages = [...safeMessages]; // 浅拷贝为可变数组，避免类型断言（readonly → 可变）
+                if (truncatedRetry) {
+                    requestMessages.push({ role: 'system', content: TRUNCATION_RECOVERY_HINT });
+                }
+                for await (const chunk of effectiveProvider.chat(requestMessages, effectiveOpts)) {
+                    streamStarted = true;
+                    if (signal?.aborted) {
+                        aborted = true;
+                        break;
+                    }
+                    // 捕获实际 API token 用量（Provider 支持 usage 时）
+                    if (chunk.usage) {
+                        metrics.actualInputTokens += chunk.usage.inputTokens;
+                        metrics.actualOutputTokens += chunk.usage.outputTokens;
+                        llmSpan.setAttribute('actualInputTokens', chunk.usage.inputTokens);
+                        llmSpan.setAttribute('actualOutputTokens', chunk.usage.outputTokens);
+                    }
+                    // 诊断证据采集（末次口径）：finish_reason 随尾 chunk 回传（末条覆盖为准），
+                    // thinking 字符数按增量累计——空响应分型（截断/瞬态）的裁决依据
+                    if (chunk.finishReason)
+                        finishReason = chunk.finishReason;
+                    if (chunk.thought)
+                        thinkingChars += chunk.thought.length;
+                    if (chunk.content) {
+                        fullContent += chunk.content;
+                        // 文本通道剥离：① 工具闭环内消息整段缓冲（deferTextToMessageEnd）；
+                        // ② 工具轮（已见 toolCalls 信号或同条携带）的文本归叙述缓冲，不进回答正文。
+                        // ③ 纯文本闭环保持流式实时 yield（stage 供宿主自审查分段）。
+                        if (deferTextToMessageEnd || isToolCallTurn || chunk.toolCalls?.length) {
+                            pendingNarrate += chunk.content;
+                        }
+                        else {
+                            textStreamed = true;
+                            streamedText += chunk.content;
+                            yield { type: 'text', content: chunk.content, stage };
+                        }
+                    }
+                    // 模型思考内容（thought）：实时透传展示，**永不拼入 fullContent**（CoT 防护，双轨隔离——
+                    // 正文轨与记忆轨不碰 thought，仅展示轨消费）。增量片段，宿主自行累积。命名用 thought
+                    // 避开多模型路由任务 TaskType='reasoning' 与 ProcessEvent 既有相位 'thinking'。
+                    if (chunk.thought) {
+                        yield { type: 'thought', content: chunk.thought };
+                    }
+                    // 工具意图预告：tool_call name 成形即透传，宿主提前渲染「准备中」工具行。
+                    // 瞬态展示轨：不落 ProcessEvent（宿主侧据此不 emitEvent）；id 可能为空串（provider 未发）
+                    if (chunk.partialToolCall) {
+                        yield {
+                            type: 'tool_pending',
+                            toolCallId: chunk.partialToolCall.id || undefined,
+                            name: chunk.partialToolCall.name,
+                        };
+                    }
+                    if (chunk.toolCalls) {
+                        // 只收可发出的调用：模型偶发的「只有 id、无 function 载荷」条目若写入历史，下一次
+                        // 请求必被服务端以 400 拒绝。丢弃在**写入历史之前**，故 assistant.tool_calls 与随后
+                        // 逐项回填的 tool 消息仍同源同长（配对不变量不破）；整批皆非法时 toolCalls 保持
+                        // undefined，自然落回既有纯文本路径（无需新分支）。
+                        const callable = filterCallableToolCalls(chunk.toolCalls);
+                        if (callable.length > 0) {
+                            toolCalls = [...(toolCalls ?? []), ...callable];
+                        }
+                        // 文本分流按**原始** chunk 置位：叙述归类不因丢弃而改变
+                        isToolCallTurn = true;
+                    }
+                }
+                // 成功时累计输出 token
+                metrics.totalOutputTokens += contextManager.estimateTokens([
+                    { role: 'assistant', content: fullContent },
+                ]);
+                // 空响应重试（真机空响应一次定生死，不入重试）：
+                // 若 for await 正常结束后无论内容是否空都 `break` 跳出，空响应（200 但 0 token 的
+                // provider 瞬态抽风）直接落到 loop 的英文兜底文案，用户被迫重发——与「网络错误会重试」
+                // 不对称。此处在未耗尽重试次数时把「全空结果」视为一次失败，`continue` 走既有 retry
+                // 退避（attempt++ → waitForRetryWithAbort + 重置流式状态），给瞬态一次纠偏机会。
+                // 耗尽仍空则照常 break，交 loop 兜底。不把「模型拒绝/静默空」错当合法产出反复重试。
+                const isEmptyResponse = !aborted &&
+                    !fullContent &&
+                    !pendingNarrate &&
+                    !streamedText &&
+                    (!toolCalls || toolCalls.length === 0);
+                if (isEmptyResponse && attempt < LOOP_CONSTANTS.MAX_LLM_RETRIES) {
+                    lastError = new Error('LLM 返回空响应');
+                    // 截断型判定（末次 finish_reason）：'length' = 思考/生成吃满输出预算——同参重试必再炸
+                    // （真机 3 连空实证），换策略重试（双轨见上方 requestMessages 注释），粘性至收场；
+                    // 无 finishReason（中转不回传）= 瞬态型 → 维持同参重试（降级不劣化）
+                    if (finishReason === 'length') {
+                        truncatedRetry = true;
+                        effectiveOpts.reasoning_effort = 'low';
+                    }
+                    continue;
+                }
+                // 截断救回计数（诚实信号族，镜像 emptyResponseCount）：曾判截断换策略、本次收场非空
+                // = 双轨救回成功——救回轮正文是真实产出（不影响成功收尾），但「曾发生截断」只在此留痕
+                // （empty_response 证据只在最终仍空时落）。每 call 恒 ≤1（粘性标记单调，成功即收场）。
+                // 早退路径（degrade 降级文案 / 抛错 / aborted）不经此点，不计入——降级文本非模型产出。
+                // aborted 显式排除（真机修正）：`isEmptyResponse` 判据以 `!aborted` 为前提，用户中止时
+                // 它恒为 false ⇒ 「truncatedRetry && !isEmptyResponse」会把**用户放弃**误记为救回成功
+                //（真机 round-1790686368607：全程无正文/无工具产出却 recov=1）。救回 = 模型的真实产出，
+                // 中止 = 未有产出，两者分类互斥，故此处补 `!aborted` 兑现注释声明的纪律。
+                if (truncatedRetry && !aborted && !isEmptyResponse) {
+                    metrics.truncationRecoveryCount++;
+                }
+                break;
+            }
+            catch (err) {
+                const e = toError(err);
+                lastError = e;
+                // AbortError 语义分裂（假中断守卫）：
+                //  - signal（宿主 / 插话控制器合并信号）已被 abort → 真实用户取消/插话，不重试直接退出
+                //  - signal 未被 abort 却捕获 AbortError → provider/网络层内部中断（连接被抽断/代理异常），
+                //    并非用户取消；抛出以示「连接中断」，避免内核谎报为「用户取消了对话」。
+                if (isAbortError(err)) {
+                    if (signal?.aborted) {
+                        aborted = true;
+                        break;
+                    }
+                    logger.warn({ err: e }, 'LLM 请求被非用户消原因 AbortError 中断（host signal 未 abort），判为连接中断');
+                    llmSpan.recordException(e);
+                    llmSpan.end();
+                    throw e;
+                }
+                // errorHandling='stop' → 立即抛出，不重试（热切换安全：每处重读 getter）
+                if (this.deps.getStrategy().errorHandling === 'stop') {
+                    llmSpan.recordException(e);
+                    llmSpan.end();
+                    throw lastError;
+                }
+                if (streamStarted) {
+                    // 流式已开始输出，不能重试（用户已看到部分结果）；'degrade' 降级为已生成文本
+                    if (this.deps.getStrategy().errorHandling === 'degrade') {
+                        logger.warn({ err: e }, 'LLM 流式中途失败，降级为已生成的文本内容');
+                        llmSpan.end();
+                        return {
+                            fullContent,
+                            pendingNarrate,
+                            streamedText,
+                            toolCalls: undefined,
+                            aborted: false,
+                            textStreamed,
+                            finishReason,
+                            thinkingChars,
+                            attempts: attemptsMade,
+                        };
+                    }
+                    llmSpan.recordException(e);
+                    llmSpan.end();
+                    throw lastError;
+                }
+                if (attempt >= LOOP_CONSTANTS.MAX_LLM_RETRIES) {
+                    // 重试次数耗尽；'degrade' 降级为纯文本回复
+                    if (this.deps.getStrategy().errorHandling === 'degrade') {
+                        const degradedMsg = '抱歉，AI 服务暂时不可用，请稍后重试。';
+                        logger.warn({ err: e }, 'LLM 重试耗尽，降级回复');
+                        llmSpan.end();
+                        return {
+                            fullContent: degradedMsg,
+                            pendingNarrate,
+                            streamedText,
+                            toolCalls: undefined,
+                            aborted: false,
+                            textStreamed,
+                            finishReason,
+                            thinkingChars,
+                            attempts: attemptsMade,
+                        };
+                    }
+                    llmSpan.recordException(e);
+                    llmSpan.end();
+                    throw lastError;
+                }
+                // 流式开始前失败可继续重试（超时/网络错误）
+            }
+        }
+        if (aborted) {
+            llmSpan.end();
+            return {
+                fullContent,
+                pendingNarrate,
+                streamedText,
+                toolCalls,
+                aborted: true,
+                textStreamed,
+                finishReason,
+                thinkingChars,
+                attempts: attemptsMade,
+            };
+        }
+        llmSpan.end();
+        return {
+            fullContent,
+            pendingNarrate,
+            streamedText,
+            toolCalls,
+            aborted: false,
+            textStreamed,
+            finishReason,
+            thinkingChars,
+            attempts: attemptsMade,
+        };
+    }
+    /**
+     * 重试延迟 + abort 支持：发射 retry chunk，等待指数退避延迟（支持中途 abort）；
+     * 调用方在延迟后自行检查 signal.aborted 决定是否退出重试循环
+     */
+    async *waitForRetryWithAbort(attempt, lastError, signal) {
+        const delay = LOOP_CONSTANTS.RETRY_BASE_DELAY_MS * Math.pow(2, attempt - 1);
+        logger.warn({ attempt, delay, error: lastError?.message }, 'LLM 调用失败，重试中');
+        yield {
+            type: 'retry',
+            attempt,
+            maxRetries: LOOP_CONSTANTS.MAX_LLM_RETRIES,
+            delayMs: delay,
+            error: lastError?.message ?? 'unknown error',
+        };
+        await new Promise((resolve) => {
+            if (signal?.aborted) {
+                resolve();
+                return;
+            }
+            const timeoutId = safeSetTimeout(() => {
+                signal?.removeEventListener('abort', onAbort);
+                resolve();
+            }, delay);
+            const onAbort = () => {
+                clearTimeout(timeoutId);
+                resolve();
+            };
+            signal?.addEventListener('abort', onAbort, { once: true });
+        });
+    }
+}
+//# sourceMappingURL=llmCaller.js.map

package/dist/agent/managers/llmCaller.js.map

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

package/dist/agent/managers/llmJudgeHelper.d.ts

@@ -1,38 +1,21 @@
 /**
- * LLM Judge 高阶辅助函数
- *
- * 抽象"流式累积 → parseLlmJson → 判 null → 抛 configError"三件套模式。
- * 用于 memoryInspector / memoryDecayScheduler / memoryAdvisor 三个 Manager 的 LLM 判断流程，
- * 消除 3 处重复模式（ADR-017 枝叶层 2 次提取原则）。
- *
- * 设计要点：
- *   - 流式累积：与 TextPolishManager / SessionArchiver 同模式
- *   - 统一异常：parseLlmJson 返回 null 时抛 configError（统一 MemoraError 体系，避免裸 throw Error）
- *   - 类型参数化：调用方传入期望的返回类型 T
+ * LLM Judge 高阶辅助函数：封装"流式累积 → parseLlmJson → 判 null → 抛 configError"三件套。
+ * 由 memoryInspector / memoryAdvisor 复用，消除重复。
+ * 统一异常：解析失败抛 configError（MemoraError 体系）；类型参数化，调用方指定返回类型 T。
  */
 import type { LlmProvider, Message } from '../../llm/provider.js';
 /** LLM Judge 调用选项（流式 + 超时 + 取消信号） */
 export interface LlmJudgeOptions {
-    /** 流式响应的最大 token 数（控制单次调用成本） */
+    /** 流式响应最大 token 数（控制单次调用成本） */
     maxTokens: number;
-    /** LLM 调用超时（ms），超时后中止请求 */
+    /** LLM 调用超时（ms），超时中止请求 */
     timeoutMs: number;
-    /** 可选的取消信号（与 timeoutMs 互相独立，任一触发即中止） */
+    /** 可选取消信号（与 timeoutMs 独立，任一触发即中止） */
     signal?: AbortSignal;
 }
 /**
- * 调用 LLM 流式累积响应并解析为 JSON 对象
- *
- * 三件套模式封装：
- *   1. 流式累积 LLM 响应（chunk.content 拼接）
- *   2. parseLlmJson 解析为对象 T（容错：剥离代码块、修复常见错误、正则兜底）
- *   3. 解析失败抛 configError（统一 MemoraError 体系，附带排查建议）
- *
- * @param provider LLM Provider 实例（通常为 backgroundProvider）
- * @param messages LLM 消息数组（system + user）
- * @param options 调用选项（maxTokens / timeoutMs / signal）
- * @param errorTitle 解析失败时抛出 configError 的标题（中文简短）
- * @returns 解析后的对象（类型由调用方指定）
+ * 调用 LLM 流式累积响应并解析为 JSON 对象 T。
+ * 流式累积 → parseLlmJson（容错剥离代码块/修复错误/正则兜底）→ 解析失败抛 configError。
  */
 export declare function judgeWithLlm<T extends object>(provider: LlmProvider, messages: Message[], options: LlmJudgeOptions, errorTitle: string): Promise<T>;
 //# sourceMappingURL=llmJudgeHelper.d.ts.map

package/dist/agent/managers/llmJudgeHelper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llmJudgeHelper.d.ts","sourceRoot":"","sources":["../../../src/agent/managers/llmJudgeHelper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAK9D,qCAAqC;AACrC,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,YAAY,CAAC,CAAC,SAAS,MAAM,EACjD,QAAQ,EAAE,WAAW,EACrB,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,EAAE,eAAe,EACxB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC,CAwBZ"}
+{"version":3,"file":"llmJudgeHelper.d.ts","sourceRoot":"","sources":["../../../src/agent/managers/llmJudgeHelper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAK9D,qCAAqC;AACrC,MAAM,WAAW,eAAe;IAC9B,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,CAAC,SAAS,MAAM,EACjD,QAAQ,EAAE,WAAW,EACrB,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,EAAE,eAAe,EACxB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC,CAoBZ"}