autosnippet 3.2.9 → 3.2.11

package/dist/lib/service/agent/context/exploration/PlanTracker.js

@@ -0,0 +1,303 @@
+/**
+ * PlanTracker — 探索计划跟踪器
+ *
+ * 从 ExplorationTracker.js 提取的规划与质量评估逻辑。
+ * 管理首轮 plan elicitation、周期性 replan、计划进度匹配和质量评分。
+ *
+ * @module PlanTracker
+ */
+import { DEFAULT_REPLAN_INTERVAL } from './ExplorationStrategies.js';
+// ─── 常量 ──────────────────────────────────────────────
+/** 默认偏差阈值 */
+const DEFAULT_DEVIATION_THRESHOLD = 0.6;
+/** 最少经过 N 轮后才允许再次触发 replan（防止 replan 风暴） */
+const MIN_REPLAN_GAP = 3;
+export class PlanTracker {
+    /** @type {boolean} 等待 AI 输出 replan */
+    #pendingReplan = false;
+    /** @type {object} 计划进度 */
+    #planProgress = {
+        coveredSteps: 0,
+        totalSteps: 0,
+        deviationScore: 0,
+        unplannedActions: 0,
+        lastReplanIteration: null,
+        consecutiveOffPlan: 0,
+    };
+    /**
+     * 获取计划进度
+     * @returns {object}
+     */
+    get progress() {
+        return { ...this.#planProgress };
+    }
+    /**
+     * 检查是否需要触发规划 + 生成规划 nudge
+     *
+     * @param {object} state 从 ExplorationTracker 传入
+     * @param {number} state.iteration
+     * @param {object} state.budget
+     * @param {object} state.strategy
+     * @param {object|null} trace - ActiveContext 实例
+     * @returns {{ type: string, text: string }|null}
+     */
+    checkPlanning(state, trace) {
+        const { metrics, budget: b, strategy } = state;
+        const m = metrics;
+        // 第 1 轮: plan elicitation
+        if (m.iteration === 1) {
+            trace?.expectPlan?.();
+            return {
+                type: 'planning',
+                text: this.#buildPlanElicitationPrompt(b.maxIterations || 30),
+            };
+        }
+        // 有计划时: 检查 replan
+        const plan = trace?.getPlan?.();
+        if (!plan) {
+            return null;
+        }
+        const progress = this.#planProgress;
+        const interval = strategy.replanInterval || DEFAULT_REPLAN_INTERVAL;
+        const baseIteration = progress.lastReplanIteration || plan.createdAtIteration;
+        const periodicTrigger = interval > 0 && m.iteration > 1 && m.iteration - baseIteration >= interval;
+        const deviationTrigger = progress.consecutiveOffPlan >= 3 ||
+            (progress.totalSteps > 0 && progress.deviationScore > DEFAULT_DEVIATION_THRESHOLD);
+        if (!periodicTrigger && !deviationTrigger) {
+            return null;
+        }
+        // 冷却间隔
+        if (progress.lastReplanIteration &&
+            m.iteration - progress.lastReplanIteration < MIN_REPLAN_GAP) {
+            return null;
+        }
+        const remaining = b.maxIterations - m.iteration;
+        const parts = [];
+        if (deviationTrigger) {
+            parts.push(`📋 计划偏差检查 (第 ${m.iteration}/${b.maxIterations} 轮):`);
+            if (progress.consecutiveOffPlan >= 3) {
+                parts.push(`你的行为已连续 ${progress.consecutiveOffPlan} 轮偏离原定计划。`);
+            }
+        }
+        else {
+            parts.push(`📋 计划进度回顾 (第 ${m.iteration}/${b.maxIterations} 轮):`);
+        }
+        const doneSteps = plan.steps.filter((s) => s.status === 'done');
+        const pendingSteps = plan.steps.filter((s) => s.status === 'pending');
+        if (doneSteps.length > 0) {
+            parts.push(`\n✅ 已完成 (${doneSteps.length}/${plan.steps.length}):`);
+            for (const s of doneSteps) {
+                parts.push(`  - ${s.description}`);
+            }
+        }
+        if (pendingSteps.length > 0) {
+            parts.push(`\n⏳ 未完成 (${pendingSteps.length}/${plan.steps.length}):`);
+            for (const s of pendingSteps) {
+                parts.push(`  - ${s.description}`);
+            }
+        }
+        if (progress.unplannedActions > 0) {
+            parts.push(`\n⚡ 计划外行为: ${progress.unplannedActions} 次`);
+        }
+        parts.push(`\n剩余 ${remaining} 轮。请评估:`);
+        parts.push(`1. 未完成的步骤是否仍然相关？`);
+        parts.push(`2. 是否需要根据新发现调整后续步骤？`);
+        parts.push(`3. 请更新你的探索计划（用编号列表）。`);
+        progress.lastReplanIteration = m.iteration;
+        this.#pendingReplan = true;
+        trace?.expectPlan?.();
+        return { type: 'planning', text: parts.join('\n') };
+    }
+    /**
+     * 更新计划进度（从 ReasoningLayer 迁入）
+     * 将本轮工具调用与 plan 步骤进行模糊匹配
+     *
+     * @param {object|null} trace - ActiveContext 实例
+     */
+    updatePlanProgress(trace) {
+        const steps = trace?.getPlanStepsMutable?.() || [];
+        if (steps.length === 0) {
+            return;
+        }
+        // 处理 pending replan
+        if (this.#pendingReplan) {
+            const plan = trace?.getPlan?.();
+            if (plan) {
+                this.#planProgress.coveredSteps = plan.steps.filter((s) => s.status === 'done').length;
+                this.#planProgress.totalSteps = plan.steps.length;
+                this.#planProgress.unplannedActions = 0;
+                this.#planProgress.consecutiveOffPlan = 0;
+                this.#pendingReplan = false;
+            }
+        }
+        const actions = trace?.getCurrentRoundActions?.() || [];
+        if (actions.length === 0) {
+            return;
+        }
+        let matchedThisRound = false;
+        for (const action of actions) {
+            const matchedStep = this.#findMatchingStep(steps, action);
+            if (matchedStep) {
+                matchedStep.status = 'done';
+                matchedThisRound = true;
+            }
+            else {
+                this.#planProgress.unplannedActions++;
+            }
+        }
+        if (matchedThisRound) {
+            this.#planProgress.consecutiveOffPlan = 0;
+        }
+        else {
+            this.#planProgress.consecutiveOffPlan++;
+        }
+        this.#planProgress.coveredSteps = steps.filter((s) => s.status === 'done').length;
+        this.#planProgress.totalSteps = steps.length;
+        this.#planProgress.deviationScore =
+            steps.length > 0 ? 1 - this.#planProgress.coveredSteps / steps.length : 0;
+    }
+    /**
+     * 推理质量评分
+     * @param {object|null} trace
+     * @returns {{ score: number, breakdown: object }}
+     */
+    getQualityMetrics(trace) {
+        const stats = trace?.getStats?.() || {
+            totalRounds: 0,
+            thoughtCount: 0,
+            totalActions: 0,
+            totalObservations: 0,
+            reflectionCount: 0,
+        };
+        const totalRounds = stats.totalRounds || 1;
+        const thoughtRatio = stats.thoughtCount / totalRounds;
+        const reflectionRatio = stats.reflectionCount / totalRounds;
+        const actionEfficiency = Math.min(stats.totalActions / totalRounds / 3, 1);
+        const observationCoverage = stats.totalObservations > 0 ? 1 : 0;
+        const plan = trace?.getPlan?.();
+        const hasPlan = plan && plan.steps.length > 0;
+        let planScore = 0;
+        if (hasPlan) {
+            const completionRate = this.#planProgress.totalSteps > 0
+                ? this.#planProgress.coveredSteps / this.#planProgress.totalSteps
+                : 0;
+            const adherenceRate = 1 - (this.#planProgress.deviationScore || 0);
+            planScore = completionRate * 0.6 + adherenceRate * 0.4;
+        }
+        const score = hasPlan
+            ? Math.round((thoughtRatio * 0.3 +
+                reflectionRatio * 0.15 +
+                actionEfficiency * 0.15 +
+                observationCoverage * 0.15 +
+                planScore * 0.25) *
+                100)
+            : Math.round((thoughtRatio * 0.4 +
+                reflectionRatio * 0.2 +
+                actionEfficiency * 0.2 +
+                observationCoverage * 0.2) *
+                100);
+        const breakdown = {
+            ...stats,
+            thoughtRatio: Math.round(thoughtRatio * 100),
+            reflectionRatio: Math.round(reflectionRatio * 100),
+            actionEfficiency: Math.round(actionEfficiency * 100),
+            observationCoverage: Math.round(observationCoverage * 100),
+        };
+        if (hasPlan) {
+            breakdown.planCompletion = Math.round((this.#planProgress.totalSteps > 0
+                ? this.#planProgress.coveredSteps / this.#planProgress.totalSteps
+                : 0) * 100);
+            breakdown.planAdherence = Math.round((1 - (this.#planProgress.deviationScore || 0)) * 100);
+            breakdown.planScore = Math.round(planScore * 100);
+        }
+        return { score, breakdown };
+    }
+    // ─── 内部方法 ──────────────────────────────────
+    #buildPlanElicitationPrompt(maxIter) {
+        return [
+            `📋 在开始探索前，请先制定一个简要的探索计划。`,
+            ``,
+            `你有 ${maxIter} 轮工具调用机会。请在你的回复中用编号列表简述 3-6 个探索步骤:`,
+            `- 每个步骤应描述要搜索/阅读的目标（具体的类名、模式、文件路径）`,
+            `- 步骤应从宏观到微观递进（先概览 → 再搜索关键模式 → 再深入关键文件）`,
+            `- 最后一步应是"总结分析发现"`,
+            ``,
+            `例如:`,
+            `1. 获取项目概览和目录结构，识别核心模块`,
+            `2. 搜索网络请求相关类，分析请求模式`,
+            `3. 搜索错误处理和响应解析模式`,
+            `4. 深入阅读 3-5 个典型实现文件，确认关键细节`,
+            `5. 总结分析发现`,
+            ``,
+            `制定计划后请立即开始执行第 1 步（可在同一轮中同时输出计划文本并调用工具）。`,
+        ].join('\n');
+    }
+    /**
+     * 模糊匹配: 将工具调用匹配到 plan 步骤
+     * @param {Array} steps
+     * @param {object} action - { tool, params }
+     * @returns {object|null}
+     */
+    #findMatchingStep(steps, action) {
+        const toolName = action.tool;
+        const argsStr = JSON.stringify(action.params || {}).toLowerCase();
+        for (const step of steps) {
+            if (step.status === 'done') {
+                continue;
+            }
+            // 策略 1: 关键词匹配
+            if ((step.keywords?.length ?? 0) > 0) {
+                const matched = step.keywords.some((kw) => argsStr.includes(kw.toLowerCase()));
+                if (matched) {
+                    return step;
+                }
+            }
+            // 策略 2: 工具类型 → 步骤描述的语义匹配
+            const desc = step.description.toLowerCase();
+            if (toolName === 'get_project_overview' &&
+                (desc.includes('概览') ||
+                    desc.includes('overview') ||
+                    desc.includes('结构') ||
+                    desc.includes('项目'))) {
+                return step;
+            }
+            if (toolName === 'list_project_structure' &&
+                (desc.includes('目录') || desc.includes('结构') || desc.includes('structure'))) {
+                return step;
+            }
+            if ((toolName === 'get_class_info' || toolName === 'get_class_hierarchy') &&
+                (desc.includes('继承') ||
+                    desc.includes('类') ||
+                    desc.includes('hierarchy') ||
+                    desc.includes('class'))) {
+                return step;
+            }
+            if (toolName === 'read_project_file' &&
+                (desc.includes('阅读') ||
+                    desc.includes('read') ||
+                    desc.includes('深入') ||
+                    desc.includes('查看') ||
+                    desc.includes('文件'))) {
+                return step;
+            }
+            if (toolName === 'search_project_code' &&
+                (desc.includes('搜索') ||
+                    desc.includes('search') ||
+                    desc.includes('查找') ||
+                    desc.includes('分析'))) {
+                return step;
+            }
+            if ((toolName === 'query_code_graph' || toolName === 'query_call_graph') &&
+                (desc.includes('图谱') ||
+                    desc.includes('graph') ||
+                    desc.includes('调用') ||
+                    desc.includes('call') ||
+                    desc.includes('关系') ||
+                    desc.includes('依赖'))) {
+                return step;
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=PlanTracker.js.map

package/dist/lib/service/agent/context/exploration/PlanTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlanTracker.js","sourceRoot":"","sources":["../../../../../../lib/service/agent/context/exploration/PlanTracker.ts"],"names":[],"mappings":"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"}

package/dist/lib/service/agent/context/exploration/SignalDetector.d.ts

@@ -0,0 +1,38 @@
+/**
+ * SignalDetector — 工具调用信号检测器
+ *
+ * 从 ExplorationTracker.js 提取的信号收集逻辑。
+ * 检测每次工具调用是否产生了新信息（新文件、新搜索模式、新查询目标）。
+ *
+ * 设计原则:
+ *   - 持有对 tracker metrics 的引用（共享 Set 实例避免拷贝开销）
+ *   - 纯检测 + 副作用（更新 Sets），不涉及阶段管理
+ *   - 可被外部扩展新工具类型
+ *
+ * @module SignalDetector
+ */
+export declare const SEARCH_TOOLS: Set<string>;
+/** 信号检测所需的指标集合引用 */
+interface SignalMetrics {
+    uniqueFiles: Set<string>;
+    uniquePatterns: Set<string>;
+    uniqueQueries: Set<string>;
+}
+export declare class SignalDetector {
+    #private;
+    /**
+     * @param {{ uniqueFiles: Set<string>, uniquePatterns: Set<string>, uniqueQueries: Set<string> }} metrics
+     */
+    constructor(metrics: SignalMetrics);
+    /**
+     * 检测工具调用是否产生了新信息
+     *
+     * @param {string} toolName
+     * @param {object} args
+     * @param {*} result
+     * @returns {boolean} 是否包含新信息
+     */
+    detect(toolName: string, args: Record<string, unknown>, result: unknown): boolean;
+}
+export {};
+//# sourceMappingURL=SignalDetector.d.ts.map

package/dist/lib/service/agent/context/exploration/SignalDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignalDetector.d.ts","sourceRoot":"","sources":["../../../../../../lib/service/agent/context/exploration/SignalDetector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,eAAO,MAAM,YAAY,aAavB,CAAC;AAEH,oBAAoB;AACpB,UAAU,aAAa;IACrB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC5B;AAcD,qBAAa,cAAc;;IAOzB;;OAEG;gBACS,OAAO,EAAE,aAAa;IAIlC;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO;CAgIxE"}

package/dist/lib/service/agent/context/exploration/SignalDetector.js

@@ -0,0 +1,164 @@
+/**
+ * SignalDetector — 工具调用信号检测器
+ *
+ * 从 ExplorationTracker.js 提取的信号收集逻辑。
+ * 检测每次工具调用是否产生了新信息（新文件、新搜索模式、新查询目标）。
+ *
+ * 设计原则:
+ *   - 持有对 tracker metrics 的引用（共享 Set 实例避免拷贝开销）
+ *   - 纯检测 + 副作用（更新 Sets），不涉及阶段管理
+ *   - 可被外部扩展新工具类型
+ *
+ * @module SignalDetector
+ */
+// ─── 搜索工具白名单（用于判断"搜索轮次"）───────────────
+export const SEARCH_TOOLS = new Set([
+    'search_project_code',
+    'semantic_search_code',
+    'get_class_info',
+    'get_class_hierarchy',
+    'get_protocol_info',
+    'get_method_overrides',
+    'get_category_map',
+    'list_project_structure',
+    'get_project_overview',
+    'get_file_summary',
+    'query_code_graph',
+    'query_call_graph',
+]);
+export class SignalDetector {
+    /**
+     * @type {{ uniqueFiles: Set<string>, uniquePatterns: Set<string>, uniqueQueries: Set<string> }}
+     * 共享引用 — 指向 ExplorationTracker 的 metrics 中的三个 Set
+     */
+    #metrics;
+    /**
+     * @param {{ uniqueFiles: Set<string>, uniquePatterns: Set<string>, uniqueQueries: Set<string> }} metrics
+     */
+    constructor(metrics) {
+        this.#metrics = metrics;
+    }
+    /**
+     * 检测工具调用是否产生了新信息
+     *
+     * @param {string} toolName
+     * @param {object} args
+     * @param {*} result
+     * @returns {boolean} 是否包含新信息
+     */
+    detect(toolName, args, result) {
+        switch (toolName) {
+            case 'search_project_code':
+                return this.#detectSearchSignal(args, result);
+            case 'read_project_file':
+                return this.#detectFileReadSignal(args);
+            case 'list_project_structure':
+                return this.#detectListSignal(args);
+            case 'get_class_info':
+            case 'get_class_hierarchy':
+            case 'get_protocol_info':
+            case 'get_method_overrides':
+            case 'get_category_map':
+            case 'query_code_graph':
+            case 'query_call_graph':
+                return this.#detectQuerySignal(toolName, args);
+            case 'get_project_overview':
+                return this.#detectSingletonQuery('overview');
+            case 'submit_knowledge':
+            case 'submit_with_check':
+                // Submit 本身不算"新信息"（阶段转换由 submitCount 驱动）
+                return false;
+            default:
+                return this.#detectGenericSignal(toolName, args);
+        }
+    }
+    // ─── 内部检测方法 ──────────────────────────────
+    #detectSearchSignal(args, result) {
+        let foundNew = false;
+        const pattern = args?.pattern || '';
+        const patterns = args?.patterns || [];
+        // 单模式
+        if (pattern && !this.#metrics.uniquePatterns.has(pattern)) {
+            this.#metrics.uniquePatterns.add(pattern);
+            foundNew = true;
+        }
+        // 批量模式
+        for (const p of patterns) {
+            if (!this.#metrics.uniquePatterns.has(p)) {
+                this.#metrics.uniquePatterns.add(p);
+                foundNew = true;
+            }
+        }
+        // 检查搜索结果是否有新文件
+        if (result && typeof result === 'object') {
+            const r = result;
+            const matches = r.matches || [];
+            const batchResults = r.batchResults || {};
+            for (const m of matches) {
+                if (m.file && !this.#metrics.uniqueFiles.has(m.file)) {
+                    this.#metrics.uniqueFiles.add(m.file);
+                    foundNew = true;
+                }
+            }
+            for (const sub of Object.values(batchResults)) {
+                for (const m of sub.matches || []) {
+                    if (m.file && !this.#metrics.uniqueFiles.has(m.file)) {
+                        this.#metrics.uniqueFiles.add(m.file);
+                        foundNew = true;
+                    }
+                }
+            }
+        }
+        return foundNew;
+    }
+    #detectFileReadSignal(args) {
+        let foundNew = false;
+        const fp = args?.filePath || '';
+        const fps = args?.filePaths || [];
+        if (fp && !this.#metrics.uniqueFiles.has(fp)) {
+            this.#metrics.uniqueFiles.add(fp);
+            foundNew = true;
+        }
+        for (const f of fps) {
+            if (!this.#metrics.uniqueFiles.has(f)) {
+                this.#metrics.uniqueFiles.add(f);
+                foundNew = true;
+            }
+        }
+        return foundNew;
+    }
+    #detectListSignal(args) {
+        const dir = args?.directory || '/';
+        const qKey = `list:${dir}`;
+        if (!this.#metrics.uniqueQueries.has(qKey)) {
+            this.#metrics.uniqueQueries.add(qKey);
+            return true;
+        }
+        return false;
+    }
+    #detectQuerySignal(toolName, args) {
+        const queryTarget = args?.className || args?.protocolName || args?.name || '';
+        const qKey = `${toolName}:${queryTarget}`;
+        if (!this.#metrics.uniqueQueries.has(qKey)) {
+            this.#metrics.uniqueQueries.add(qKey);
+            return true;
+        }
+        return false;
+    }
+    #detectSingletonQuery(key) {
+        if (!this.#metrics.uniqueQueries.has(key)) {
+            this.#metrics.uniqueQueries.add(key);
+            return true;
+        }
+        return false;
+    }
+    #detectGenericSignal(toolName, args) {
+        const qKey = `${toolName}:${JSON.stringify(args || {}).substring(0, 80)}`;
+        if (!this.#metrics.uniqueQueries.has(qKey)) {
+            this.#metrics.uniqueQueries.add(qKey);
+            return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=SignalDetector.js.map

package/dist/lib/service/agent/context/exploration/SignalDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignalDetector.js","sourceRoot":"","sources":["../../../../../../lib/service/agent/context/exploration/SignalDetector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,yCAAyC;AAEzC,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAClC,qBAAqB;IACrB,sBAAsB;IACtB,gBAAgB;IAChB,qBAAqB;IACrB,mBAAmB;IACnB,sBAAsB;IACtB,kBAAkB;IAClB,wBAAwB;IACxB,sBAAsB;IACtB,kBAAkB;IAClB,kBAAkB;IAClB,kBAAkB;CACnB,CAAC,CAAC;AAqBH,MAAM,OAAO,cAAc;IACzB;;;OAGG;IACH,QAAQ,CAAgB;IAExB;;OAEG;IACH,YAAY,OAAsB;QAChC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,QAAgB,EAAE,IAA6B,EAAE,MAAe;QACrE,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,qBAAqB;gBACxB,OAAO,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAEhD,KAAK,mBAAmB;gBACtB,OAAO,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;YAE1C,KAAK,wBAAwB;gBAC3B,OAAO,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAEtC,KAAK,gBAAgB,CAAC;YACtB,KAAK,qBAAqB,CAAC;YAC3B,KAAK,mBAAmB,CAAC;YACzB,KAAK,sBAAsB,CAAC;YAC5B,KAAK,kBAAkB,CAAC;YACxB,KAAK,kBAAkB,CAAC;YACxB,KAAK,kBAAkB;gBACrB,OAAO,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAEjD,KAAK,sBAAsB;gBACzB,OAAO,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;YAEhD,KAAK,kBAAkB,CAAC;YACxB,KAAK,mBAAmB;gBACtB,yCAAyC;gBACzC,OAAO,KAAK,CAAC;YAEf;gBACE,OAAO,IAAI,CAAC,oBAAoB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,4CAA4C;IAE5C,mBAAmB,CAAC,IAA6B,EAAE,MAAe;QAChE,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,MAAM,OAAO,GAAI,IAAI,EAAE,OAAkB,IAAI,EAAE,CAAC;QAChD,MAAM,QAAQ,GAAI,IAAI,EAAE,QAAqB,IAAI,EAAE,CAAC;QACpD,MAAM;QACN,IAAI,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1D,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC1C,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;QACD,OAAO;QACP,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACpC,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;QACH,CAAC;QACD,eAAe;QACf,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YACzC,MAAM,CAAC,GAAG,MAAsB,CAAC;YACjC,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;YAChC,MAAM,YAAY,GAAsD,CAAC,CAAC,YAAY,IAAI,EAAE,CAAC;YAC7F,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;oBACrD,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;oBACtC,QAAQ,GAAG,IAAI,CAAC;gBAClB,CAAC;YACH,CAAC;YACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC9C,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;oBAClC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;wBACrD,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;wBACtC,QAAQ,GAAG,IAAI,CAAC;oBAClB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,qBAAqB,CAAC,IAA6B;QACjD,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,MAAM,EAAE,GAAI,IAAI,EAAE,QAAmB,IAAI,EAAE,CAAC;QAC5C,MAAM,GAAG,GAAI,IAAI,EAAE,SAAsB,IAAI,EAAE,CAAC;QAChD,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClC,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACjC,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,iBAAiB,CAAC,IAA6B;QAC7C,MAAM,GAAG,GAAI,IAAI,EAAE,SAAoB,IAAI,GAAG,CAAC;QAC/C,MAAM,IAAI,GAAG,QAAQ,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,kBAAkB,CAAC,QAAgB,EAAE,IAA6B;QAChE,MAAM,WAAW,GACd,IAAI,EAAE,SAAoB,IAAK,IAAI,EAAE,YAAuB,IAAK,IAAI,EAAE,IAAe,IAAI,EAAE,CAAC;QAChG,MAAM,IAAI,GAAG,GAAG,QAAQ,IAAI,WAAW,EAAE,CAAC;QAC1C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,qBAAqB,CAAC,GAAW;QAC/B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACrC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,oBAAoB,CAAC,QAAgB,EAAE,IAA6B;QAClE,MAAM,IAAI,GAAG,GAAG,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAC1E,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/lib/service/agent/core/ChatAgentPrompts.d.ts

@@ -0,0 +1,52 @@
+/**
+ * ChatAgentPrompts — Agent 提示词构建和文本处理方法
+ */
+import type { ServiceContainer } from '../tools/_shared.js';
+/** Options for buildNativeToolSystemPrompt */
+interface NativeToolPromptOptions {
+    currentSource: string;
+    projectBriefingCache: string;
+    memoryCoordinator?: {
+        buildStaticMemoryPrompt(opts: {
+            mode: string;
+        }): string;
+    } | null;
+    budget?: {
+        maxIterations?: number;
+        [key: string]: unknown;
+    };
+    soulPath?: string;
+}
+/** Options for buildProjectBriefing */
+interface ProjectBriefingOptions {
+    container?: ServiceContainer;
+}
+/**
+ * 构建原生函数调用模式的系统提示词
+ *
+ * @param {object} options
+ * @param {string} options.currentSource - 'user' | 'system'
+ * @param {string} options.projectBriefingCache 项目概况缓存文本
+ * @param {object} [options.memoryCoordinator] - MemoryCoordinator 实例
+ * @param {object} options.budget 预算配置
+ * @param {string} options.soulPath - SOUL.md 文件路径
+ * @returns {string}
+ */
+export declare function buildNativeToolSystemPrompt({ currentSource, projectBriefingCache, memoryCoordinator, budget, soulPath, }: NativeToolPromptOptions): string;
+/**
+ * 构建项目概况注入到系统提示词（每次 execute 刷新一次）
+ * 单次 SQL 聚合 < 5ms，静默降级
+ *
+ * @param {object} options
+ * @param {import('../../../injection/ServiceContainer.js').ServiceContainer} options.container
+ * @returns {Promise<string>}
+ */
+export declare function buildProjectBriefing({ container }: ProjectBriefingOptions): Promise<string>;
+/**
+ * 清理最终回答（去除 Thought/preamble + MEMORY 标签）
+ * @param {string} response
+ * @returns {string}
+ */
+export declare function cleanFinalAnswer(response: string): string;
+export {};
+//# sourceMappingURL=ChatAgentPrompts.d.ts.map

package/dist/lib/service/agent/core/ChatAgentPrompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatAgentPrompts.d.ts","sourceRoot":"","sources":["../../../../../lib/service/agent/core/ChatAgentPrompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,8CAA8C;AAC9C,UAAU,uBAAuB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE;QAAE,uBAAuB,CAAC,IAAI,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,GAAG,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACvF,MAAM,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,uCAAuC;AACvC,UAAU,sBAAsB;IAC9B,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAAC,EAC1C,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,MAAW,EACX,QAAQ,GACT,EAAE,uBAAuB,UAoEzB;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CAAC,EAAE,SAAS,EAAE,EAAE,sBAAsB,mBAkC/E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,UA0BhD"}