autosnippet 3.2.10 → 3.2.12

package/dist/lib/service/agent/core/ChatAgentPrompts.js

@@ -0,0 +1,151 @@
+/**
+ * ChatAgentPrompts — Agent 提示词构建和文本处理方法
+ */
+import fs from 'node:fs';
+/**
+ * 构建原生函数调用模式的系统提示词
+ *
+ * @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 function buildNativeToolSystemPrompt({ currentSource, projectBriefingCache, memoryCoordinator, budget = {}, soulPath, }) {
+    // 用户对话模式: 完整提示词（含 SOUL、Memory、项目概况）
+    if (currentSource !== 'system') {
+        let soulSection = '';
+        try {
+            if (soulPath && fs.existsSync(soulPath)) {
+                soulSection = `\n${fs.readFileSync(soulPath, 'utf-8').trim()}\n`;
+            }
+        }
+        catch {
+            /* SOUL.md not available */
+        }
+        // v5.0: 通过 coordinator 构建静态记忆 section
+        let memorySection = '';
+        if (memoryCoordinator) {
+            memorySection = memoryCoordinator.buildStaticMemoryPrompt({ mode: 'user' });
+        }
+        return `${soulSection}
+你是 AutoSnippet 项目的统一 AI 中心。项目内所有 AI 推理和分析都通过你执行。
+${projectBriefingCache}${memorySection}
+
+## 使用规则
+1. 当需要查询数据时，直接调用相应工具。
+2. 工具参数严格按照工具声明中的 schema 传递。
+3. 对于代码分析任务，先 search_project_code 搜索，再 read_project_file 读取。
+4. 当工具返回错误时，尝试不同参数或方法。`;
+    }
+    // Bootstrap 系统模式: LLM 以领域大脑的能力处理任务
+    return `你以「领域大脑」的能力来处理任务 — 你对软件工程领域拥有深厚的专家知识。
+你将分析一个真实项目，自主发现其中有价值的代码知识。
+${projectBriefingCache}
+
+## 你的能力定位
+你具备深度技术洞察力，能够理解代码背后的设计意图。
+你知道什么知识对开发团队最有价值 — 不是显而易见的样板代码，
+而是体现项目独有设计决策、架构模式和工程智慧的知识。
+
+## 你的工作方式
+1. **全局感知** → list_project_structure 了解项目结构
+2. **定向探索** → get_file_summary 快速了解文件角色
+3. **深入研读** → search_project_code / read_project_file 获取真实代码
+4. **语义发现** → semantic_search_code 在知识库查找相关知识
+5. **知识产出** → submit_knowledge 提交有价值的发现
+
+## 高效使用工具（节省轮次）
+- **批量搜索**: search_project_code({ patterns: ["keywordA", "keywordB", "keywordC"] })
+- **批量读文件**: read_project_file({ filePaths: ["path/a.m", "path/b.m"] })
+- 合并同类请求为一次调用，避免逐个搜索/读取浪费轮次。
+
+## 「项目特写」= 基本用法 + 项目特征融合
+submit_knowledge 的 code 字段必须是「项目特写」— 将技术的基本用法与本项目的特征融合为一体:
+1. **项目选择了什么**: 采用了哪种写法/模式/约定
+2. **为什么这样选**: 统计数据（N 个文件、占比 M%）
+3. **项目禁止什么**: 被放弃的写法、反模式、显式禁用标记
+4. **新代码怎么写**: 可直接复制使用的代码模板
+
+## 核心原则
+- 代码必须真实，来自工具返回，不可编造
+- 引用具体类名、方法名、数字，禁止「本模块」「该文件」等泛化描述
+- 质量优先于数量，证据不足宁可不提交
+- 高效利用步数 (≤${budget.maxIterations} 轮)
+
+## 严禁透传指令
+你会收到系统发来的进度提醒和阶段引导，这些是行为指令，不是问题。
+**绝对禁止**在回复中复制、改写或引用这些系统指令的任何文字。
+你的回复必须只包含你自己的分析内容或工具调用。`;
+}
+/**
+ * 构建项目概况注入到系统提示词（每次 execute 刷新一次）
+ * 单次 SQL 聚合 < 5ms，静默降级
+ *
+ * @param {object} options
+ * @param {import('../../../injection/ServiceContainer.js').ServiceContainer} options.container
+ * @returns {Promise<string>}
+ */
+export async function buildProjectBriefing({ container }) {
+    try {
+        const db = container?.get?.('database');
+        if (!db) {
+            return '';
+        }
+        // knowledgeType → kind 映射:
+        //   rule: code-standard, code-style, best-practice, boundary-constraint
+        //   pattern: code-pattern, architecture, solution
+        //   fact: code-relation, inheritance, call-chain, data-flow, module-dependency
+        // V3: knowledge_entries 统一表（candidates 已合并，lifecycle 替代 status）
+        const stats = db
+            .prepare(`
+        SELECT
+          (SELECT COUNT(*) FROM knowledge_entries WHERE lifecycle = 'active') as recipeCount,
+          (SELECT COUNT(*) FROM knowledge_entries WHERE lifecycle = 'active' AND knowledgeType IN ('code-standard','code-style','best-practice','boundary-constraint')) as ruleCount,
+          (SELECT COUNT(*) FROM knowledge_entries WHERE lifecycle = 'active' AND knowledgeType IN ('code-pattern','architecture','solution')) as patternCount,
+          (SELECT COUNT(*) FROM knowledge_entries WHERE lifecycle = 'active' AND knowledgeType IN ('code-relation','inheritance','call-chain','data-flow','module-dependency')) as factCount,
+          (SELECT COUNT(*) FROM knowledge_entries WHERE lifecycle = 'active' AND knowledgeType = 'boundary-constraint') as guardRuleCount,
+          (SELECT COUNT(*) FROM knowledge_entries WHERE lifecycle = 'pending') as pendingCandidates,
+          (SELECT COUNT(*) FROM knowledge_entries) as totalCandidates
+      `)
+            .get();
+        if (!stats || stats.recipeCount === 0) {
+            return '\n## 项目状态\n⚠️ 知识库为空。建议先执行冷启动（bootstrap_knowledge）。\n';
+        }
+        let section = `\n## 项目状态\n- 知识库: ${stats.recipeCount} 条 Recipe（${stats.ruleCount || 0} rule / ${stats.patternCount || 0} pattern / ${stats.factCount || 0} fact）\n- Guard 规则: ${stats.guardRuleCount || 0} 条\n- 候选: ${stats.pendingCandidates} 条待审 / ${stats.totalCandidates} 条总计\n`;
+        if (stats.pendingCandidates > 10) {
+            section += `\n⚠️ 有 ${stats.pendingCandidates} 条候选积压，建议执行批量审核。\n`;
+        }
+        return section;
+    }
+    catch {
+        return ''; // DB 不可用时静默降级
+    }
+}
+/**
+ * 清理最终回答（去除 Thought/preamble + MEMORY 标签）
+ * @param {string} response
+ * @returns {string}
+ */
+export function cleanFinalAnswer(response) {
+    if (!response) {
+        return '';
+    }
+    return (response
+        .replace(/^(Final Answer|最终回答|Answer)\s*[:：]\s*/i, '')
+        .replace(/\[MEMORY:\w+\]\s*[\s\S]*?\s*\[\/MEMORY\]/g, '')
+        // v5.1: 清理 AI 回显的 nudge 指令（常见于 force-exit 场景）
+        .replace(/^>\s*(?:searchHints|remainingTasks|candidateCount|crossRefs|keyFindings|gaps)\s*[:：][^\n]*\n?/gm, '')
+        .replace(/^\*{0,2}(?:请在|请直接|请确保|请务必|现在开始|输出你的|不要输出|不要再|不要包含|重要\s*[：:]).*(?:分析文本|分析总结|JSON|工具|输出|文本|报告)\*{0,2}[。.]?\s*$/gm, '')
+        .replace(/^注意[：:]\s*到达第\s*\d+\s*轮时.*$/gm, '')
+        .replace(/^第\s*\d+\/\d+\s*轮\s*\|[^\n]*$/gm, '')
+        // v5.2: 移除 dimensionDigest JSON 剥离
+        // 之前会把 SUMMARIZE 阶段 LLM 按要求产出的 dimensionDigest JSON 全部删掉 → 0 chars
+        // dimensionDigest 是 SUMMARIZE 的预期输出，不应被 cleanFinalAnswer 清理
+        // Analyst 策略的 SUMMARIZE 使用自然语言 Markdown（不含 dimensionDigest），不受影响
+        .replace(/\n{3,}/g, '\n\n')
+        .trim());
+}
+//# sourceMappingURL=ChatAgentPrompts.js.map

package/dist/lib/service/agent/core/ChatAgentPrompts.js.map

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

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

@@ -0,0 +1,32 @@
+/**
+ * LLMResultType — LLM 调用结果类型枚举
+ *
+ * 替代 `{ __continue: true }` 魔术值，提供显式的类型安全控制流。
+ *
+ * 使用场景:
+ *   - #callLLM() 返回值标记
+ *   - #handleAiError() 返回值标记
+ *   - ReAct 循环中的分支判断
+ *
+ * @module LLMResultType
+ */
+export declare const LLMResultType: Readonly<{
+    /** 继续循环 — 空响应重试、错误恢复后重试 */
+    CONTINUE: "continue";
+    /** 文本响应 */
+    TEXT: "text";
+    /** 工具调用 */
+    TOOL_CALLS: "tool_calls";
+    /** 可恢复错误 (已处理，可继续) */
+    ERROR: "error";
+    /** 不可恢复错误 (应退出循环) */
+    FATAL: "fatal";
+}>;
+/**
+ * 创建 CONTINUE 类型的结果
+ * @returns {{ type: 'continue' }}
+ */
+export declare function continueResult(): {
+    type: "continue";
+};
+//# sourceMappingURL=LLMResultType.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LLMResultType.d.ts","sourceRoot":"","sources":["../../../../../lib/service/agent/core/LLMResultType.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,aAAa;IACxB,2BAA2B;;IAE3B,WAAW;;IAEX,WAAW;;IAEX,sBAAsB;;IAEtB,qBAAqB;;EAErB,CAAC;AAEH;;;GAGG;AACH,wBAAgB,cAAc;;EAE7B"}

package/dist/lib/service/agent/core/LLMResultType.js

@@ -0,0 +1,32 @@
+/**
+ * LLMResultType — LLM 调用结果类型枚举
+ *
+ * 替代 `{ __continue: true }` 魔术值，提供显式的类型安全控制流。
+ *
+ * 使用场景:
+ *   - #callLLM() 返回值标记
+ *   - #handleAiError() 返回值标记
+ *   - ReAct 循环中的分支判断
+ *
+ * @module LLMResultType
+ */
+export const LLMResultType = Object.freeze({
+    /** 继续循环 — 空响应重试、错误恢复后重试 */
+    CONTINUE: 'continue',
+    /** 文本响应 */
+    TEXT: 'text',
+    /** 工具调用 */
+    TOOL_CALLS: 'tool_calls',
+    /** 可恢复错误 (已处理，可继续) */
+    ERROR: 'error',
+    /** 不可恢复错误 (应退出循环) */
+    FATAL: 'fatal',
+});
+/**
+ * 创建 CONTINUE 类型的结果
+ * @returns {{ type: 'continue' }}
+ */
+export function continueResult() {
+    return { type: LLMResultType.CONTINUE };
+}
+//# sourceMappingURL=LLMResultType.js.map

package/dist/lib/service/agent/core/LLMResultType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LLMResultType.js","sourceRoot":"","sources":["../../../../../lib/service/agent/core/LLMResultType.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IACzC,2BAA2B;IAC3B,QAAQ,EAAE,UAAU;IACpB,WAAW;IACX,IAAI,EAAE,MAAM;IACZ,WAAW;IACX,UAAU,EAAE,YAAY;IACxB,sBAAsB;IACtB,KAAK,EAAE,OAAO;IACd,qBAAqB;IACrB,KAAK,EAAE,OAAO;CACf,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,EAAE,IAAI,EAAE,aAAa,CAAC,QAAQ,EAAE,CAAC;AAC1C,CAAC"}

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

@@ -0,0 +1,158 @@
+/**
+ * LoopContext — reactLoop 单次执行的完整状态
+ *
+ * 封装原 reactLoop 内散落的 10+ 局部变量:
+ *   - 注入依赖 (messages, tracker, trace, memoryCoordinator, sharedState)
+ *   - 循环状态 (iteration, lastReply, toolCalls, tokenUsage)
+ *   - 错误恢复 (consecutiveAiErrors, consecutiveEmptyResponses)
+ *   - 配置 (source, budget, capabilities, baseSystemPrompt, toolSchemas, prompt)
+ *
+ * 使 reactLoop 的提取方法只需接收一个 ctx 参数。
+ *
+ * @module core/LoopContext
+ */
+import type { Capability } from '../capabilities.js';
+import type { ContextWindow } from '../context/ContextWindow.js';
+import type { ExplorationTracker } from '../context/ExplorationTracker.js';
+import type { ActiveContext } from '../memory/ActiveContext.js';
+import type { MemoryCoordinator } from '../memory/MemoryCoordinator.js';
+import type { MessageAdapter } from './MessageAdapter.js';
+/** Tool call hook type */
+type ToolCallHook = (name: string, params: Record<string, unknown>, result: unknown) => void;
+type ToolCallHookLike = (...args: any[]) => void;
+/** Token usage returned by AI providers */
+interface TokenUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+}
+/** Shared state between pipeline stages */
+interface SharedState {
+    submittedTitles?: Set<string>;
+    submittedPatterns?: Set<string>;
+    submitToolName?: string;
+    _dimensionMeta?: {
+        id?: string;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+/** Budget configuration */
+interface BudgetConfig {
+    maxIterations?: number;
+    timeoutMs?: number;
+    maxTokens?: number;
+    temperature?: number;
+    [key: string]: unknown;
+}
+/** LoopContext configuration — accepts both concrete and duck-typed inputs from callers */
+interface LoopContextConfig {
+    messages: MessageAdapter;
+    tracker?: ExplorationTracker | Record<string, unknown> | null;
+    trace?: ActiveContext | Record<string, unknown> | null;
+    memoryCoordinator?: MemoryCoordinator | Record<string, unknown> | null;
+    sharedState?: SharedState | Record<string, unknown> | null;
+    source?: string;
+    budget: BudgetConfig;
+    capabilities: Capability[];
+    baseSystemPrompt: string;
+    toolSchemas: Array<Record<string, unknown>>;
+    prompt: string;
+    onToolCall?: ToolCallHook | ToolCallHookLike | null;
+    context?: Record<string, unknown>;
+    contextWindow?: ContextWindow | null;
+    toolChoiceOverride?: string | null;
+}
+/**
+ * @typedef {Object} LoopContextConfig
+ * @property {import('./MessageAdapter.js').MessageAdapter} messages 统一消息适配器
+ * @property {Object|null} [tracker] - ExplorationTracker 实例
+ * @property {Object|null} [trace] - ActiveContext 实例
+ * @property {Object|null} [memoryCoordinator] - MemoryCoordinator 实例
+ * @property {Object|null} [sharedState] 共享状态 { submittedTitles, submittedPatterns }
+ * @property {string} [source] - 'user' | 'system'
+ * @property {Object} budget 预算配置
+ * @property {import('../capabilities.js').Capability[]} capabilities 本轮使用的 capabilities
+ * @property {string} baseSystemPrompt 基础系统提示词
+ * @property {Array} toolSchemas 工具 schema 列表
+ * @property {string} prompt 原始用户提示
+ * @property {Function|null} [onToolCall] 本轮工具调用钩子
+ * @property {Object} [context] 额外上下文
+ * @property {import('../context/ContextWindow.js').ContextWindow|null} [contextWindow] 原始 ContextWindow (供 forced-summary 等外部逻辑)
+ */
+export declare class LoopContext {
+    /** @type {import('./MessageAdapter.js').MessageAdapter} 统一消息适配器 */
+    messages: MessageAdapter;
+    /** @type {Object|null} ExplorationTracker 实例 */
+    tracker: ExplorationTracker | null;
+    /** @type {Object|null} ActiveContext 实例 */
+    trace: ActiveContext | null;
+    /** @type {Object|null} MemoryCoordinator 实例 */
+    memoryCoordinator: MemoryCoordinator | null;
+    /** @type {Object|null} 共享状态 */
+    sharedState: SharedState | null;
+    /** @type {number} 当前迭代次数 */
+    iteration: number;
+    /** @type {string} 最终回复文本 */
+    lastReply: string;
+    /** @type {Array} 本轮工具调用记录 */
+    toolCalls: any[];
+    /** @type {{input: number, output: number}} 本轮 token 用量 */
+    tokenUsage: {
+        input: number;
+        output: number;
+    };
+    /** @type {number} 循环开始时间戳 */
+    loopStartTime: number;
+    /** @type {number} 连续 AI 错误计数 (2-strike 策略) */
+    consecutiveAiErrors: number;
+    /** @type {number} 连续空响应计数 */
+    consecutiveEmptyResponses: number;
+    /** @type {string} 来源 'user' | 'system' */
+    source: string;
+    /** @type {Object} 预算配置 */
+    budget: BudgetConfig;
+    /** @type {import('../capabilities.js').Capability[]} */
+    capabilities: Capability[];
+    /** @type {string} 基础系统提示词 */
+    baseSystemPrompt: string;
+    /** @type {Array} 工具 schemas */
+    toolSchemas: Array<Record<string, unknown>>;
+    /** @type {string} 原始用户提示 */
+    prompt: string;
+    /** @type {Function|null} 工具调用钩子 */
+    onToolCall: ToolCallHook | null;
+    /** @type {Object} 额外上下文 */
+    context: Record<string, unknown>;
+    /** @type {import('../context/ContextWindow.js').ContextWindow|null} 原始 ContextWindow 引用 */
+    contextWindow: ContextWindow | null;
+    /** @type {string|null} 首轮 toolChoice 覆盖 ('required'/'auto'/'none') */
+    toolChoiceOverride: string | null;
+    /**
+     * @param {LoopContextConfig} config
+     */
+    constructor(config: LoopContextConfig);
+    /** 是否为 system 场景 */
+    get isSystem(): boolean;
+    /** 最大迭代数 */
+    get maxIterations(): number;
+    /**
+     * 累加 token 用量到循环级统计
+     * @param {Object} usage - { inputTokens, outputTokens }
+     */
+    addTokenUsage(usage: TokenUsage | null | undefined): void;
+    /**
+     * 构建循环返回值
+     * @returns {{ reply: string, toolCalls: Array, tokenUsage: Object, iterations: number }}
+     */
+    buildResult(): {
+        reply: string;
+        toolCalls: any[];
+        tokenUsage: {
+            input: number;
+            output: number;
+        };
+        iterations: number;
+    };
+}
+export {};
+//# sourceMappingURL=LoopContext.d.ts.map

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

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

package/dist/lib/service/agent/core/LoopContext.js

@@ -0,0 +1,139 @@
+/**
+ * LoopContext — reactLoop 单次执行的完整状态
+ *
+ * 封装原 reactLoop 内散落的 10+ 局部变量:
+ *   - 注入依赖 (messages, tracker, trace, memoryCoordinator, sharedState)
+ *   - 循环状态 (iteration, lastReply, toolCalls, tokenUsage)
+ *   - 错误恢复 (consecutiveAiErrors, consecutiveEmptyResponses)
+ *   - 配置 (source, budget, capabilities, baseSystemPrompt, toolSchemas, prompt)
+ *
+ * 使 reactLoop 的提取方法只需接收一个 ctx 参数。
+ *
+ * @module core/LoopContext
+ */
+/**
+ * @typedef {Object} LoopContextConfig
+ * @property {import('./MessageAdapter.js').MessageAdapter} messages 统一消息适配器
+ * @property {Object|null} [tracker] - ExplorationTracker 实例
+ * @property {Object|null} [trace] - ActiveContext 实例
+ * @property {Object|null} [memoryCoordinator] - MemoryCoordinator 实例
+ * @property {Object|null} [sharedState] 共享状态 { submittedTitles, submittedPatterns }
+ * @property {string} [source] - 'user' | 'system'
+ * @property {Object} budget 预算配置
+ * @property {import('../capabilities.js').Capability[]} capabilities 本轮使用的 capabilities
+ * @property {string} baseSystemPrompt 基础系统提示词
+ * @property {Array} toolSchemas 工具 schema 列表
+ * @property {string} prompt 原始用户提示
+ * @property {Function|null} [onToolCall] 本轮工具调用钩子
+ * @property {Object} [context] 额外上下文
+ * @property {import('../context/ContextWindow.js').ContextWindow|null} [contextWindow] 原始 ContextWindow (供 forced-summary 等外部逻辑)
+ */
+export class LoopContext {
+    // ─── 注入依赖 ───
+    /** @type {import('./MessageAdapter.js').MessageAdapter} 统一消息适配器 */
+    messages;
+    /** @type {Object|null} ExplorationTracker 实例 */
+    tracker;
+    /** @type {Object|null} ActiveContext 实例 */
+    trace;
+    /** @type {Object|null} MemoryCoordinator 实例 */
+    memoryCoordinator;
+    /** @type {Object|null} 共享状态 */
+    sharedState;
+    // ─── 循环状态 ───
+    /** @type {number} 当前迭代次数 */
+    iteration = 0;
+    /** @type {string} 最终回复文本 */
+    lastReply = '';
+    /** @type {Array} 本轮工具调用记录 */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- tool call entries have varying shapes (ToolCallEntry, ToolCallRecord, etc.) across callers; no common structural type satisfies all consumers
+    toolCalls = [];
+    /** @type {{input: number, output: number}} 本轮 token 用量 */
+    tokenUsage = { input: 0, output: 0 };
+    /** @type {number} 循环开始时间戳 */
+    loopStartTime = 0;
+    // ─── 错误恢复 ───
+    /** @type {number} 连续 AI 错误计数 (2-strike 策略) */
+    consecutiveAiErrors = 0;
+    /** @type {number} 连续空响应计数 */
+    consecutiveEmptyResponses = 0;
+    // ─── 配置 (只读) ───
+    /** @type {string} 来源 'user' | 'system' */
+    source;
+    /** @type {Object} 预算配置 */
+    budget;
+    /** @type {import('../capabilities.js').Capability[]} */
+    capabilities;
+    /** @type {string} 基础系统提示词 */
+    baseSystemPrompt;
+    /** @type {Array} 工具 schemas */
+    toolSchemas;
+    /** @type {string} 原始用户提示 */
+    prompt;
+    /** @type {Function|null} 工具调用钩子 */
+    onToolCall;
+    /** @type {Object} 额外上下文 */
+    context;
+    /** @type {import('../context/ContextWindow.js').ContextWindow|null} 原始 ContextWindow 引用 */
+    contextWindow;
+    /** @type {string|null} 首轮 toolChoice 覆盖 ('required'/'auto'/'none') */
+    toolChoiceOverride;
+    /**
+     * @param {LoopContextConfig} config
+     */
+    constructor(config) {
+        this.messages = config.messages;
+        this.tracker = (config.tracker || null);
+        this.trace = (config.trace || null);
+        this.memoryCoordinator = (config.memoryCoordinator || null);
+        this.sharedState = (config.sharedState || null);
+        this.source = config.source || 'user';
+        this.budget = config.budget;
+        this.capabilities = config.capabilities;
+        this.baseSystemPrompt = config.baseSystemPrompt;
+        this.toolSchemas = config.toolSchemas;
+        this.prompt = config.prompt;
+        this.onToolCall = (config.onToolCall || null);
+        this.context = config.context || {};
+        this.contextWindow = config.contextWindow || null;
+        this.toolChoiceOverride = config.toolChoiceOverride || null;
+        this.loopStartTime = Date.now();
+    }
+    // ─── 计算属性 ───
+    /** 是否为 system 场景 */
+    get isSystem() {
+        return this.source === 'system';
+    }
+    /** 最大迭代数 */
+    get maxIterations() {
+        return this.budget.maxIterations || 20;
+    }
+    // ─── Token 累计辅助 ───
+    /**
+     * 累加 token 用量到循环级统计
+     * @param {Object} usage - { inputTokens, outputTokens }
+     */
+    addTokenUsage(usage) {
+        if (!usage) {
+            return;
+        }
+        const inTok = usage.inputTokens || 0;
+        const outTok = usage.outputTokens || 0;
+        this.tokenUsage.input += inTok;
+        this.tokenUsage.output += outTok;
+    }
+    // ─── 结果构建 ───
+    /**
+     * 构建循环返回值
+     * @returns {{ reply: string, toolCalls: Array, tokenUsage: Object, iterations: number }}
+     */
+    buildResult() {
+        return {
+            reply: this.lastReply,
+            toolCalls: [...this.toolCalls],
+            tokenUsage: { ...this.tokenUsage },
+            iterations: this.iteration,
+        };
+    }
+}
+//# sourceMappingURL=LoopContext.js.map

package/dist/lib/service/agent/core/LoopContext.js.map

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