@zooique/memora 2.0.0 → 3.0.0

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":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AACpG,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAO7C;;;GAGG;AACH,MAAM,wBAAwB,GAAG,gCAAgC,CAAC;AA0ElE;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAA4B;IAC5D,mDAAmD;IACnD,MAAM,kBAAkB,GAAa,EAAE,CAAC;IACxC,KACE,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAC3B,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,MAAM,GAAG,cAAc,CAAC,gBAAgB,EACrE,CAAC,EAAE,EACH,CAAC;QACD,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;YACjC,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,kDAAkD;IAClD,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,8CAA8C,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3F,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,sDAAsD;IACtD,MAAM,WAAW,GAAG,kBAAkB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAChD,IAAI,WAAW,CAAC,MAAM,GAAG,cAAc,CAAC,qBAAqB,EAAE,CAAC;QAC9D,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,0CAA0C;AAC1C,MAAM,OAAO,SAAS;IACS;IAA7B,YAA6B,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;IAAG,CAAC;IAEpD;;;OAGG;IACH,eAAe,CAAC,YAAgC;QAC9C,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,eAAe,KAAK,OAAO,EAAE,CAAC;YACxD,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjC,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC7C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,QAAQ,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YACrD,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAC;YAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC9C,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,CAAC,aAAa,CAClB,YAAgC,EAChC,QAAqB,EACrB,MAA+B,EAC/B,SAAiB;IACjB,yDAAyD;IACzD,QAAwB,QAAQ;QAEhC,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;QACtD,IAAI,WAAW,GAAG,EAAE,CAAC;QACrB,IAAI,SAAS,GAAyB,SAAS,CAAC;QAChD,IAAI,aAAa,GAAG,KAAK,CAAC;QAC1B,IAAI,SAAS,GAAiB,IAAI,CAAC;QACnC,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,oDAAoD;QACpD,IAAI,cAAc,GAAG,KAAK,CAAC;QAC3B,kEAAkE;QAClE,IAAI,cAAc,GAAG,EAAE,CAAC;QACxB,qDAAqD;QACrD,IAAI,YAAY,GAAG,KAAK,CAAC;QACzB,+DAA+D;QAC/D,IAAI,YAAY,GAAG,EAAE,CAAC;QACtB,0DAA0D;QAC1D,IAAI,YAAY,GAA6B,SAAS,CAAC;QACvD,oDAAoD;QACpD,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,4DAA4D;QAC5D,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,wEAAwE;QACxE,IAAI,cAAc,GAAG,KAAK,CAAC;QAC3B,4CAA4C;QAC5C,mDAAmD;QACnD,6CAA6C;QAC7C,MAAM,qBAAqB,GAAG,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAElE,iEAAiE;QACjE,MAAM,aAAa,GAAgB;YACjC,GAAG,QAAQ;YACX,MAAM;YACN,SAAS,EAAE,cAAc,CAAC,cAAc;SACzC,CAAC;QAEF,uDAAuD;QACvD,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,kBAAkB,KAAK,QAAQ,EAAE,CAAC;YAC5D,aAAa,CAAC,gBAAgB,GAAG,KAAK,CAAC;QACzC,CAAC;QAED,6CAA6C;QAC7C,MAAM,iBAAiB,GAAG,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;QAE7D,sBAAsB;QACtB,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,QAAQ,EAAE;YACrD,KAAK,EAAE,iBAAiB,CAAC,IAAI;YAC7B,YAAY,EAAE,YAAY,CAAC,MAAM;YACjC,SAAS;SACV,CAAC,CAAC;QACH,OAAO,CAAC,YAAY,CAAC,aAAa,EAAE,cAAc,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;QAEjF,gEAAgE;QAChE,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;YAC3B,MAAM,YAAY,GAAG,YAAY;iBAC9B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;iBAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;iBACrB,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,OAAO,CAAC,YAAY,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAC;QAC5E,CAAC;QAED,iBAAiB;QACjB,uDAAuD;QACvD,gCAAgC;QAChC,qDAAqD;QACrD,mEAAmE;QACnE,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;QAC7D,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,OAAO,CAAC,oBAAoB,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnF,MAAM,CAAC,KAAK,CACV,EAAE,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,YAAY,CAAC,MAAM,EAAE,EACpE,6BAA6B,KAAK,sBAAsB,CACzD,CAAC;YACF,OAAO,CAAC,eAAe,CAAC,IAAI,KAAK,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC,CAAC;YACxD,OAAO,CAAC,GAAG,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,GAAG,CAAC,CAAC;QACzD,CAAC;QAED,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,cAAc,CAAC,eAAe,EAAE,OAAO,EAAE,EAAE,CAAC;YAC3E,wBAAwB;YACxB,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,MAAM;YACR,CAAC;YAED,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAChB,KAAK,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;gBAC9D,wBAAwB;gBACxB,WAAW,GAAG,EAAE,CAAC;gBACjB,SAAS,GAAG,SAAS,CAAC;gBACtB,cAAc,GAAG,EAAE,CAAC;gBACpB,YAAY,GAAG,EAAE,CAAC;gBAClB,cAAc,GAAG,KAAK,CAAC;gBACvB,4DAA4D;gBAC5D,YAAY,GAAG,SAAS,CAAC;gBACzB,aAAa,GAAG,CAAC,CAAC;gBAClB,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;oBACpB,OAAO,GAAG,IAAI,CAAC;oBACf,MAAM;gBACR,CAAC;YACH,CAAC;YAED,IAAI,CAAC;gBACH,YAAY,EAAE,CAAC;gBACf,OAAO,CAAC,YAAY,EAAE,CAAC;gBACvB,OAAO,CAAC,gBAAgB,IAAI,cAAc,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;gBAExE,0DAA0D;gBAC1D,8EAA8E;gBAC9E,0DAA0D;gBAC1D,wDAAwD;gBACxD,yDAAyD;gBACzD,MAAM,eAAe,GAAc,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,iCAAiC;gBACvF,IAAI,cAAc,EAAE,CAAC;oBACnB,eAAe,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC,CAAC;gBAC9E,CAAC;gBACD,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,iBAAiB,CAAC,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,EAAE,CAAC;oBACjF,aAAa,GAAG,IAAI,CAAC;oBACrB,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;wBACpB,OAAO,GAAG,IAAI,CAAC;wBACf,MAAM;oBACR,CAAC;oBACD,yCAAyC;oBACzC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;wBAChB,OAAO,CAAC,iBAAiB,IAAI,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC;wBACrD,OAAO,CAAC,kBAAkB,IAAI,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC;wBACvD,OAAO,CAAC,YAAY,CAAC,mBAAmB,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;wBACnE,OAAO,CAAC,YAAY,CAAC,oBAAoB,EAAE,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;oBACvE,CAAC;oBACD,kDAAkD;oBAClD,uCAAuC;oBACvC,IAAI,KAAK,CAAC,YAAY;wBAAE,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;oBAC1D,IAAI,KAAK,CAAC,OAAO;wBAAE,aAAa,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;oBACzD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;wBAClB,WAAW,IAAI,KAAK,CAAC,OAAO,CAAC;wBAC7B,+CAA+C;wBAC/C,8CAA8C;wBAC9C,uCAAuC;wBACvC,IAAI,qBAAqB,IAAI,cAAc,IAAI,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;4BACvE,cAAc,IAAI,KAAK,CAAC,OAAO,CAAC;wBAClC,CAAC;6BAAM,CAAC;4BACN,YAAY,GAAG,IAAI,CAAC;4BACpB,YAAY,IAAI,KAAK,CAAC,OAAO,CAAC;4BAC9B,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;wBACxD,CAAC;oBACH,CAAC;oBACD,4DAA4D;oBAC5D,oDAAoD;oBACpD,iEAAiE;oBACjE,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;wBAClB,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;oBACpD,CAAC;oBACD,8CAA8C;oBAC9C,gEAAgE;oBAChE,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;wBAC1B,MAAM;4BACJ,IAAI,EAAE,cAAc;4BACpB,UAAU,EAAE,KAAK,CAAC,eAAe,CAAC,EAAE,IAAI,SAAS;4BACjD,IAAI,EAAE,KAAK,CAAC,eAAe,CAAC,IAAI;yBACjC,CAAC;oBACJ,CAAC;oBACD,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;wBACpB,iDAAiD;wBACjD,2DAA2D;wBAC3D,kDAAkD;wBAClD,gCAAgC;wBAChC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;wBAC1D,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BACxB,SAAS,GAAG,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC;wBAClD,CAAC;wBACD,mCAAmC;wBACnC,cAAc,GAAG,IAAI,CAAC;oBACxB,CAAC;gBACH,CAAC;gBACD,gBAAgB;gBAChB,OAAO,CAAC,iBAAiB,IAAI,cAAc,CAAC,cAAc,CAAC;oBACzD,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE;iBAC5C,CAAC,CAAC;gBACH,0BAA0B;gBAC1B,2DAA2D;gBAC3D,qDAAqD;gBACrD,oDAAoD;gBACpD,4DAA4D;gBAC5D,kDAAkD;gBAClD,MAAM,eAAe,GACnB,CAAC,OAAO;oBACR,CAAC,WAAW;oBACZ,CAAC,cAAc;oBACf,CAAC,YAAY;oBACb,CAAC,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;gBACzC,IAAI,eAAe,IAAI,OAAO,GAAG,cAAc,CAAC,eAAe,EAAE,CAAC;oBAChE,SAAS,GAAG,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;oBACnC,0DAA0D;oBAC1D,qDAAqD;oBACrD,6CAA6C;oBAC7C,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;wBAC9B,cAAc,GAAG,IAAI,CAAC;wBACtB,aAAa,CAAC,gBAAgB,GAAG,KAAK,CAAC;oBACzC,CAAC;oBACD,SAAS;gBACX,CAAC;gBACD,qDAAqD;gBACrD,8CAA8C;gBAC9C,yDAAyD;gBACzD,wDAAwD;gBACxD,gEAAgE;gBAChE,oEAAoE;gBACpE,6DAA6D;gBAC7D,8CAA8C;gBAC9C,IAAI,cAAc,IAAI,CAAC,OAAO,IAAI,CAAC,eAAe,EAAE,CAAC;oBACnD,OAAO,CAAC,uBAAuB,EAAE,CAAC;gBACpC,CAAC;gBACD,MAAM;YACR,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;gBACvB,SAAS,GAAG,CAAC,CAAC;gBAEd,0BAA0B;gBAC1B,wDAAwD;gBACxD,oEAAoE;gBACpE,yCAAyC;gBACzC,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;oBACtB,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;wBACpB,OAAO,GAAG,IAAI,CAAC;wBACf,MAAM;oBACR,CAAC;oBACD,MAAM,CAAC,IAAI,CACT,EAAE,GAAG,EAAE,CAAC,EAAE,EACV,yDAAyD,CAC1D,CAAC;oBACF,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;oBAC3B,OAAO,CAAC,GAAG,EAAE,CAAC;oBACd,MAAM,CAAC,CAAC;gBACV,CAAC;gBAED,qDAAqD;gBACrD,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,aAAa,KAAK,MAAM,EAAE,CAAC;oBACrD,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;oBAC3B,OAAO,CAAC,GAAG,EAAE,CAAC;oBACd,MAAM,SAAS,CAAC;gBAClB,CAAC;gBAED,IAAI,aAAa,EAAE,CAAC;oBAClB,6CAA6C;oBAC7C,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;wBACxD,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,wBAAwB,CAAC,CAAC;wBAClD,OAAO,CAAC,GAAG,EAAE,CAAC;wBACd,OAAO;4BACL,WAAW;4BACX,cAAc;4BACd,YAAY;4BACZ,SAAS,EAAE,SAAS;4BACpB,OAAO,EAAE,KAAK;4BACd,YAAY;4BACZ,YAAY;4BACZ,aAAa;4BACb,QAAQ,EAAE,YAAY;yBACvB,CAAC;oBACJ,CAAC;oBACD,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;oBAC3B,OAAO,CAAC,GAAG,EAAE,CAAC;oBACd,MAAM,SAAS,CAAC;gBAClB,CAAC;gBACD,IAAI,OAAO,IAAI,cAAc,CAAC,eAAe,EAAE,CAAC;oBAC9C,4BAA4B;oBAC5B,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;wBACxD,MAAM,WAAW,GAAG,sBAAsB,CAAC;wBAC3C,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;wBACzC,OAAO,CAAC,GAAG,EAAE,CAAC;wBACd,OAAO;4BACL,WAAW,EAAE,WAAW;4BACxB,cAAc;4BACd,YAAY;4BACZ,SAAS,EAAE,SAAS;4BACpB,OAAO,EAAE,KAAK;4BACd,YAAY;4BACZ,YAAY;4BACZ,aAAa;4BACb,QAAQ,EAAE,YAAY;yBACvB,CAAC;oBACJ,CAAC;oBACD,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;oBAC3B,OAAO,CAAC,GAAG,EAAE,CAAC;oBACd,MAAM,SAAS,CAAC;gBAClB,CAAC;gBACD,wBAAwB;YAC1B,CAAC;QACH,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,EAAE,CAAC;YACd,OAAO;gBACL,WAAW;gBACX,cAAc;gBACd,YAAY;gBACZ,SAAS;gBACT,OAAO,EAAE,IAAI;gBACb,YAAY;gBACZ,YAAY;gBACZ,aAAa;gBACb,QAAQ,EAAE,YAAY;aACvB,CAAC;QACJ,CAAC;QAED,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO;YACL,WAAW;YACX,cAAc;YACd,YAAY;YACZ,SAAS;YACT,OAAO,EAAE,KAAK;YACd,YAAY;YACZ,YAAY;YACZ,aAAa;YACb,QAAQ,EAAE,YAAY;SACvB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,CAAC,qBAAqB,CAC1B,OAAe,EACf,SAAuB,EACvB,MAA+B;QAE/B,MAAM,KAAK,GAAG,cAAc,CAAC,mBAAmB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;QAC5E,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC;QAC3E,MAAM;YACJ,IAAI,EAAE,OAAO;YACb,OAAO;YACP,UAAU,EAAE,cAAc,CAAC,eAAe;YAC1C,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,SAAS,EAAE,OAAO,IAAI,eAAe;SAC7C,CAAC;QACF,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBACpB,OAAO,EAAE,CAAC;gBACV,OAAO;YACT,CAAC;YACD,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,EAAE;gBACpC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC9C,OAAO,EAAE,CAAC;YACZ,CAAC,EAAE,KAAK,CAAC,CAAC;YACV,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC;YACF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,21 @@
+/**
+ * LLM Judge 高阶辅助函数：封装"流式累积 → parseLlmJson → 判 null → 抛 configError"三件套。
+ * 由 memoryInspector / memoryAdvisor 复用，消除重复。
+ * 统一异常：解析失败抛 configError（MemoraError 体系）；类型参数化，调用方指定返回类型 T。
+ */
+import type { LlmProvider, Message } from '../../llm/provider.js';
+/** LLM Judge 调用选项（流式 + 超时 + 取消信号） */
+export interface LlmJudgeOptions {
+    /** 流式响应最大 token 数（控制单次调用成本） */
+    maxTokens: number;
+    /** LLM 调用超时（ms），超时中止请求 */
+    timeoutMs: number;
+    /** 可选取消信号（与 timeoutMs 独立，任一触发即中止） */
+    signal?: AbortSignal;
+}
+/**
+ * 调用 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

@@ -0,0 +1 @@
+{"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"}

package/dist/agent/managers/llmJudgeHelper.js

@@ -0,0 +1,32 @@
+/**
+ * LLM Judge 高阶辅助函数：封装"流式累积 → parseLlmJson → 判 null → 抛 configError"三件套。
+ * 由 memoryInspector / memoryAdvisor 复用，消除重复。
+ * 统一异常：解析失败抛 configError（MemoraError 体系）；类型参数化，调用方指定返回类型 T。
+ */
+import { parseLlmJson } from '../../utils/json.js';
+import { configError } from '../../utils/errors.js';
+import { accumulateStream } from '../../agent/managers/streamAccumulator.js';
+/**
+ * 调用 LLM 流式累积响应并解析为 JSON 对象 T。
+ * 流式累积 → parseLlmJson（容错剥离代码块/修复错误/正则兜底）→ 解析失败抛 configError。
+ */
+export async function judgeWithLlm(provider, messages, options, errorTitle) {
+    // 流式累积 LLM 响应（复用 accumulateStream，消除重复）
+    const llmResponse = await accumulateStream(provider, messages, {
+        maxTokens: options.maxTokens,
+        temperature: 0,
+        timeoutMs: options.timeoutMs,
+        signal: options.signal,
+    });
+    // 解析 JSON，失败抛 configError（统一 MemoraError 体系）
+    const parsed = parseLlmJson(llmResponse.trim());
+    if (!parsed) {
+        throw configError(errorTitle, 'LLM 返回内容不是有效的 JSON（parseLlmJson 解析失败）', [
+            '检查 backgroundProvider 是否注入并可用',
+            '检查 LLM 模型是否输出预期的 JSON 结构',
+            '若问题持续，可降低候选数量或调整 prompt',
+        ]);
+    }
+    return parsed;
+}
+//# sourceMappingURL=llmJudgeHelper.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"llmJudgeHelper.js","sourceRoot":"","sources":["../../../src/agent/managers/llmJudgeHelper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAYzE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAqB,EACrB,QAAmB,EACnB,OAAwB,EACxB,UAAkB;IAElB,wCAAwC;IACxC,MAAM,WAAW,GAAG,MAAM,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE;QAC7D,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,WAAW,EAAE,CAAC;QACd,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IAEH,6CAA6C;IAC7C,MAAM,MAAM,GAAG,YAAY,CAAI,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IACnD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,WAAW,CAAC,UAAU,EAAE,uCAAuC,EAAE;YACrE,+BAA+B;YAC/B,0BAA0B;YAC1B,yBAAyB;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,58 @@
+/**
+ * AgentLoop 运行时指标纯状态容器
+ *
+ * 零 AgentLoop 依赖的自包含值对象：9 个计数字段 + 3 个派生 getter。
+ * 置入 `managers/` 而非 loop.ts 的理由：度量「定义」与度量「消费」应分离——
+ * loop 只负责 `this.metrics.xxx++`，指标结构本身不属于编排逻辑。
+ *
+ * 注：不设召回计数指标——记忆检索唯一入口 = search_memories 工具，耗时可看 TOOL_EXEC span。
+ */
+export declare class LoopMetrics {
+    llmCallCount: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    actualInputTokens: number;
+    actualOutputTokens: number;
+    toolCallCount: number;
+    toolFailureCount: number;
+    /** 空响应兜底次数（LLM 200 但 0 token）。为真说明用户看到英文兜底文案、
+     *  任务零产出却被 success 盖章——宿主据此识别「瞬态抽风」vs「模型拒绝」，不再被静默掩盖 */
+    emptyResponseCount: number;
+    /** 截断救回次数（截断型空响应换策略重试后成功产出）。与 emptyResponseCount 互补：
+     *  后者 = 最终仍空（救回失败），本计数 = 曾截断但被 T2 双轨救回（正文是真实模型产出，
+     *  不影响成功收尾）。「救回成功」的轮落盘无其它痕迹，无本计数则换策略重试的真机效力不可验。 */
+    truncationRecoveryCount: number;
+    /**
+     * 疑似工具调用但无原生 toolCalls 的文本意图数。
+     * 文本出口不再宣告可调用通道后，模型仍可能吐出 <tool_call>/<function=> 骨架——
+     * 本计数让「想干活却一步没干成」不再被静默盖章「完成」（宿主据此不显示 success）。
+     */
+    unparsedToolIntentCount: number;
+    /** 任务总执行次数（每次 processUserInput 算一次） */
+    taskTotalCount: number;
+    /** 任务成功次数 */
+    taskSuccessCount: number;
+    /** 任务失败次数（abort/超时/迭代耗尽） */
+    taskFailureCount: number;
+    /** 任务累计耗时（毫秒，用于计算平均耗时） */
+    taskTotalDurationMs: number;
+    /** 任务成功率（0-1） */
+    get taskSuccessRate(): number;
+    /** 平均任务耗时（毫秒） */
+    get taskAvgDurationMs(): number;
+    /** 累计调用 task_table_write 次数（= 任务表建表/重建次数） */
+    planTaskTableWriteCount: number;
+    /** 累计产出 plan_item_boundary 次数（= 思考折叠分块的边界数） */
+    planItemBoundaryCount: number;
+    /** 发送边界守卫命中次数（tool_call 批次成形违规被拒发）。健康态应恒 0——
+     *  命中 = 构造期散点回归（内核 bug 信号），见 toolCallHelpers.auditToolCallPairing */
+    llmPairingGuardFires: number;
+    /** read_file 覆盖度台账回显（分支② formatLedgerStub 命中）累计次数。
+     *  仅作观测基线：与「规避行为红旗」交叉判定防重是否过度顶替合法重读（见 AgentMetrics 该字段 JSDoc）。 */
+    ledgerStubEchoCount: number;
+    /** read_dedup 护栏硬拦命中（同主体重复获取且结果仍在上下文）累计次数。
+     *  与 ledgerStubEchoCount 互补：本计数 = L2 精确判重（模型乒乓信号，撞墙升级文案的量化基线），
+     *  后者 = L3 变体顶替；健康态应接近 0，持续增长 = 模型在同主体上反复重读。 */
+    readDedupBlockCount: number;
+}
+//# sourceMappingURL=loopMetrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loopMetrics.d.ts","sourceRoot":"","sources":["../../../src/agent/managers/loopMetrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACtB,YAAY,SAAK;IACjB,gBAAgB,SAAK;IACrB,iBAAiB,SAAK;IACtB,iBAAiB,SAAK;IACtB,kBAAkB,SAAK;IACvB,aAAa,SAAK;IAClB,gBAAgB,SAAK;IAErB;2DACuD;IACvD,kBAAkB,SAAK;IAEvB;;uDAEmD;IACnD,uBAAuB,SAAK;IAG5B;;;;OAIG;IACH,uBAAuB,SAAK;IAG5B,uCAAuC;IACvC,cAAc,SAAK;IACnB,aAAa;IACb,gBAAgB,SAAK;IACrB,4BAA4B;IAC5B,gBAAgB,SAAK;IACrB,0BAA0B;IAC1B,mBAAmB,SAAK;IAExB,iBAAiB;IACjB,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,iBAAiB;IACjB,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAGD,6CAA6C;IAC7C,uBAAuB,SAAK;IAC5B,+CAA+C;IAC/C,qBAAqB,SAAK;IAG1B;yEACqE;IACrE,oBAAoB,SAAK;IAGzB;sEACkE;IAClE,mBAAmB,SAAK;IAGxB;;oDAEgD;IAChD,mBAAmB,SAAK;CACzB"}

package/dist/agent/managers/loopMetrics.js

@@ -0,0 +1,68 @@
+/**
+ * AgentLoop 运行时指标纯状态容器
+ *
+ * 零 AgentLoop 依赖的自包含值对象：9 个计数字段 + 3 个派生 getter。
+ * 置入 `managers/` 而非 loop.ts 的理由：度量「定义」与度量「消费」应分离——
+ * loop 只负责 `this.metrics.xxx++`，指标结构本身不属于编排逻辑。
+ *
+ * 注：不设召回计数指标——记忆检索唯一入口 = search_memories 工具，耗时可看 TOOL_EXEC span。
+ */
+export class LoopMetrics {
+    llmCallCount = 0;
+    totalInputTokens = 0;
+    totalOutputTokens = 0;
+    actualInputTokens = 0;
+    actualOutputTokens = 0;
+    toolCallCount = 0;
+    toolFailureCount = 0;
+    /** 空响应兜底次数（LLM 200 但 0 token）。为真说明用户看到英文兜底文案、
+     *  任务零产出却被 success 盖章——宿主据此识别「瞬态抽风」vs「模型拒绝」，不再被静默掩盖 */
+    emptyResponseCount = 0;
+    /** 截断救回次数（截断型空响应换策略重试后成功产出）。与 emptyResponseCount 互补：
+     *  后者 = 最终仍空（救回失败），本计数 = 曾截断但被 T2 双轨救回（正文是真实模型产出，
+     *  不影响成功收尾）。「救回成功」的轮落盘无其它痕迹，无本计数则换策略重试的真机效力不可验。 */
+    truncationRecoveryCount = 0;
+    // ─── 未解析工具意图 ──────────────────────
+    /**
+     * 疑似工具调用但无原生 toolCalls 的文本意图数。
+     * 文本出口不再宣告可调用通道后，模型仍可能吐出 <tool_call>/<function=> 骨架——
+     * 本计数让「想干活却一步没干成」不再被静默盖章「完成」（宿主据此不显示 success）。
+     */
+    unparsedToolIntentCount = 0;
+    // ─── 任务级 SLO 度量 ──────────────────────
+    /** 任务总执行次数（每次 processUserInput 算一次） */
+    taskTotalCount = 0;
+    /** 任务成功次数 */
+    taskSuccessCount = 0;
+    /** 任务失败次数（abort/超时/迭代耗尽） */
+    taskFailureCount = 0;
+    /** 任务累计耗时（毫秒，用于计算平均耗时） */
+    taskTotalDurationMs = 0;
+    /** 任务成功率（0-1） */
+    get taskSuccessRate() {
+        return this.taskTotalCount > 0 ? this.taskSuccessCount / this.taskTotalCount : 0;
+    }
+    /** 平均任务耗时（毫秒） */
+    get taskAvgDurationMs() {
+        return this.taskTotalCount > 0 ? Math.round(this.taskTotalDurationMs / this.taskTotalCount) : 0;
+    }
+    // ─── 任务表触发观测量（先实证触发率，再决定修复是否起效）──
+    /** 累计调用 task_table_write 次数（= 任务表建表/重建次数） */
+    planTaskTableWriteCount = 0;
+    /** 累计产出 plan_item_boundary 次数（= 思考折叠分块的边界数） */
+    planItemBoundaryCount = 0;
+    // ─── 发送边界守卫 ───────────────────
+    /** 发送边界守卫命中次数（tool_call 批次成形违规被拒发）。健康态应恒 0——
+     *  命中 = 构造期散点回归（内核 bug 信号），见 toolCallHelpers.auditToolCallPairing */
+    llmPairingGuardFires = 0;
+    // ─── 读取防重的台账替身回显观测（观测防重是否过度拦截合法重读）──
+    /** read_file 覆盖度台账回显（分支② formatLedgerStub 命中）累计次数。
+     *  仅作观测基线：与「规避行为红旗」交叉判定防重是否过度顶替合法重读（见 AgentMetrics 该字段 JSDoc）。 */
+    ledgerStubEchoCount = 0;
+    // ─── 读取防重的 L2 硬拦观测 ──
+    /** read_dedup 护栏硬拦命中（同主体重复获取且结果仍在上下文）累计次数。
+     *  与 ledgerStubEchoCount 互补：本计数 = L2 精确判重（模型乒乓信号，撞墙升级文案的量化基线），
+     *  后者 = L3 变体顶替；健康态应接近 0，持续增长 = 模型在同主体上反复重读。 */
+    readDedupBlockCount = 0;
+}
+//# sourceMappingURL=loopMetrics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loopMetrics.js","sourceRoot":"","sources":["../../../src/agent/managers/loopMetrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,OAAO,WAAW;IACtB,YAAY,GAAG,CAAC,CAAC;IACjB,gBAAgB,GAAG,CAAC,CAAC;IACrB,iBAAiB,GAAG,CAAC,CAAC;IACtB,iBAAiB,GAAG,CAAC,CAAC;IACtB,kBAAkB,GAAG,CAAC,CAAC;IACvB,aAAa,GAAG,CAAC,CAAC;IAClB,gBAAgB,GAAG,CAAC,CAAC;IAErB;2DACuD;IACvD,kBAAkB,GAAG,CAAC,CAAC;IAEvB;;uDAEmD;IACnD,uBAAuB,GAAG,CAAC,CAAC;IAE5B,qCAAqC;IACrC;;;;OAIG;IACH,uBAAuB,GAAG,CAAC,CAAC;IAE5B,wCAAwC;IACxC,uCAAuC;IACvC,cAAc,GAAG,CAAC,CAAC;IACnB,aAAa;IACb,gBAAgB,GAAG,CAAC,CAAC;IACrB,4BAA4B;IAC5B,gBAAgB,GAAG,CAAC,CAAC;IACrB,0BAA0B;IAC1B,mBAAmB,GAAG,CAAC,CAAC;IAExB,iBAAiB;IACjB,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,CAAC;IAED,iBAAiB;IACjB,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClG,CAAC;IAED,mCAAmC;IACnC,6CAA6C;IAC7C,uBAAuB,GAAG,CAAC,CAAC;IAC5B,+CAA+C;IAC/C,qBAAqB,GAAG,CAAC,CAAC;IAE1B,iCAAiC;IACjC;yEACqE;IACrE,oBAAoB,GAAG,CAAC,CAAC;IAEzB,sCAAsC;IACtC;sEACkE;IAClE,mBAAmB,GAAG,CAAC,CAAC;IAExB,uBAAuB;IACvB;;oDAEgD;IAChD,mBAAmB,GAAG,CAAC,CAAC;CACzB"}