@cicctencent/agent-core 0.1.27 → 0.1.30

package/dist/cjs/a2a/rest-runner.d.ts

@@ -1,5 +1,13 @@
 import type { SubAgentRunner } from '../tool/delegate.js';
 import type { RestA2AClient } from './rest-client.js';
+/** 远程 Capability 的 input_schema 片段（供 runner 拆解 JSON 打包的 task） */
+export interface RestInputSchema {
+    type?: string;
+    /** input_schema.required 字段名列表 */
+    required?: string[];
+    /** input_schema.properties，值为各字段的 schema 定义（含 type/description/enum 等） */
+    properties?: Record<string, unknown>;
+}
 /** createRestA2ARemoteRunner 配置项 */
 export interface RestA2ARemoteRunnerConfig {
     /** 远程 Agent 的 base URL（如 http://localhost:8000） */
@@ -16,6 +24,14 @@ export interface RestA2ARemoteRunnerConfig {
     staticFields?: Record<string, string>;
     /** 任务字符串映射到的字段名（默认 'analysis_focus'） */
     taskField?: string;
+    /**
+     * 允许 LLM 动态填写的字段名列表（来自 input_schema 的 properties 键）。
+     * - 缺省时仅 taskField 为动态，其余走 staticFields（与旧行为一致）。
+     * - 配置后，当 LLM 把 task 打包成 JSON 对象时，这些键会被合并进最终 input。
+     */
+    dynamicFields?: string[];
+    /** 远程 Capability 的 input_schema 片段，用于校验/白名单动态字段及生成 LLM 引导文案 */
+    inputSchema?: RestInputSchema;
     /** 是否启用流式（默认 true） */
     streaming?: boolean;
     /** 流式失败时是否自动回退到同步模式，默认 true */

package/dist/cjs/a2a/rest-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rest-runner.d.ts","sourceRoot":"","sources":["../../../src/a2a/rest-runner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAsC,MAAM,kBAAkB,CAAC;AAE1F,oCAAoC;AACpC,MAAM,WAAW,yBAAyB;IACxC,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+BAA+B;IAC/B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,yBAAyB,GAAG,cAAc,CA8F3F"}
+{"version":3,"file":"rest-runner.d.ts","sourceRoot":"","sources":["../../../src/a2a/rest-runner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAsC,MAAM,kBAAkB,CAAC;AAE1F,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,oCAAoC;AACpC,MAAM,WAAW,yBAAyB;IACxC,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,sBAAsB;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+BAA+B;IAC/B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,yBAAyB,GAAG,cAAc,CAsK3F"}

package/dist/cjs/a2a/rest-runner.js

@@ -22,11 +22,61 @@ exports.createRestA2ARemoteRunner = createRestA2ARemoteRunner;
  *   - error → error
  */
 function createRestA2ARemoteRunner(config) {
-    const { baseUrl, capabilityId, name: runnerName, description: runnerDesc, client, staticFields = {}, taskField = 'analysis_focus', streaming = true, fallbackToSync = true, } = config;
-    /** 将 task 字符串构建为请求输入 */
+    const { baseUrl, capabilityId, name: runnerName, description: runnerDesc, client, staticFields = {}, taskField = 'analysis_focus', dynamicFields, inputSchema, streaming = true, fallbackToSync = true, } = config;
+    /**
+     * 允许 LLM 动态填写的字段白名单。
+     * - 优先用 dynamicFields；
+     * - 缺省时退化为 inputSchema 的所有 properties 键；
+     * - 都没有则只保留 taskField。
+     * taskField 永远视为动态字段。
+     */
+    const allowedDynamicFields = Array.from(new Set([
+        taskField,
+        ...(dynamicFields && dynamicFields.length
+            ? dynamicFields
+            : (inputSchema?.properties ? Object.keys(inputSchema.properties) : [])),
+    ]));
+    /**
+     * 将 task 字符串构建为请求输入。
+     *
+     * 支持两种形态：
+     * 1. task 为普通字符串 → 映射到 taskField（旧行为，向后兼容）。
+     * 2. task 为 JSON 对象字符串（如 '{"analysis_focus":"...","competitors":"..."}'）
+     *    → 解析后把属于 allowedDynamicFields 的键合并进 input（覆盖静态默认值），
+     *      其余键忽略，避免污染请求体。
+     *
+     * 静态字段始终作为基础值先行铺底，动态字段在后覆盖。
+     */
     function buildInput(task) {
-        const input = { ...staticFields, [taskField]: task };
-        console.log(`[REST-A2A] '${runnerName}' buildInput:\n  baseUrl: ${baseUrl}\n  capabilityId: ${capabilityId}\n  taskField: ${taskField}\n  task (value): ${JSON.stringify(task)}\n  staticFields: ${JSON.stringify(staticFields)}\n  => final input: ${JSON.stringify(input, null, 2)}`);
+        const input = { ...staticFields };
+        const trimmed = (task ?? '').trim();
+        const looksLikeJson = trimmed.startsWith('{') && trimmed.endsWith('}');
+        let parsedTask = null;
+        if (looksLikeJson) {
+            try {
+                const parsed = JSON.parse(trimmed);
+                if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+                    parsedTask = parsed;
+                }
+            }
+            catch { /* 非法 JSON，按纯文本处理 */ }
+        }
+        if (parsedTask) {
+            for (const key of allowedDynamicFields) {
+                if (parsedTask[key] !== undefined && parsedTask[key] !== null) {
+                    input[key] = parsedTask[key];
+                }
+            }
+            // 若解析出的对象未命中任何动态字段，则把整段原文回填到 taskField，避免丢内容
+            const hitAny = allowedDynamicFields.some(k => parsedTask[k] !== undefined && parsedTask[k] !== null);
+            if (!hitAny) {
+                input[taskField] = task;
+            }
+        }
+        else {
+            input[taskField] = task;
+        }
+        console.log(`[REST-A2A] '${runnerName}' buildInput:\n  baseUrl: ${baseUrl}\n  capabilityId: ${capabilityId}\n  taskField: ${taskField}\n  dynamicFields: [${allowedDynamicFields.join(', ')}]\n  task (value): ${JSON.stringify(task)}\n  staticFields: ${JSON.stringify(staticFields)}\n  => final input: ${JSON.stringify(input, null, 2)}`);
         return input;
     }
     /** 从 RestCapabilityResult 中提取最终文本 */
@@ -85,9 +135,26 @@ function createRestA2ARemoteRunner(config) {
             return `[REST A2A '${runnerName}'] Error: ${errMsg}`;
         }
     };
+    // 暴露给 delegate_task 用于生成 LLM 引导文案的动态字段元数据。
+    // 仅当存在多个动态字段（>1，即不止 taskField）时才填充，避免单字段场景产生噪音。
+    const inputFields = allowedDynamicFields.length > 1
+        ? allowedDynamicFields.map(name => {
+            const prop = inputSchema?.properties?.[name];
+            const propDef = (prop && typeof prop === 'object' ? prop : {});
+            const rawType = propDef.type;
+            const type = Array.isArray(rawType) ? rawType.filter(Boolean).join('|') : (typeof rawType === 'string' ? rawType : 'string');
+            return {
+                name,
+                required: inputSchema?.required?.includes(name) ?? false,
+                description: typeof propDef.description === 'string' ? propDef.description : '',
+                type,
+            };
+        })
+        : undefined;
     return {
         name: runnerName,
         description: runnerDesc,
+        inputFields,
         run: async (task, ctx, _options) => {
             return streaming && ctx?.emitSubEvent
                 ? runStreaming(task, ctx)

package/dist/cjs/a2a/rest-runner.js.map

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

package/dist/cjs/agent/engine.d.ts

@@ -16,12 +16,16 @@ export declare class AgentEngine {
     private llmCaller;
     /** 子模块：工具执行器 */
     private toolExecutor;
-    /** 历史摘要缓存：sessionId → { summary, lastSummarizedCount } */
+    /** 历史摘要缓存：sessionId → { summary, lastSummarizedCount }（LRU 限制防止内存泄漏） */
     private summaryCache;
+    /** 摘要缓存上限 */
+    private static readonly SUMMARY_CACHE_MAX;
     /** 数据获取类工具集合（用于循环检测） */
     private dataFetchTools;
     /** 产出型工具集合（有这些调用时不触发数据获取循环检测） */
     private outputTools;
+    /** Guard 策略配置（阈值可注入，不硬编码业务逻辑） */
+    private guardConfig;
     constructor(config: AgentConfig);
     /** 获取当前 Agent 的 ToolRegistry（供 read_tool_doc 等内置工具使用） */
     getToolRegistry(): ToolRegistry;

package/dist/cjs/agent/engine.d.ts.map

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

package/dist/cjs/agent/engine.js

@@ -10,10 +10,11 @@ const types_ts_1 = require("../types.js");
 const history_manager_ts_1 = require("./history-manager.js");
 const llm_caller_ts_1 = require("./llm-caller.js");
 const tool_executor_ts_1 = require("./tool-executor.js");
+const logger_ts_1 = require("../observability/logger.js");
 /** 默认系统提示词 */
 const DEFAULT_BASE_PROMPT = `You are a helpful AI assistant with access to tools. Use tools when needed to accomplish tasks. Always explain your actions clearly.`;
-/** 进度叙述规则（追加到 system prompt，引导 LLM 在工具调用间输出可见文本） */
-const PROGRESS_NARRATION_RULES = `
+/** 进度叙述规则（追加到 system prompt，引导 LLM 在工具调用间输出可见文本）— 可通过 AgentConfig.progressNarrationRules 覆盖 */
+const DEFAULT_PROGRESS_NARRATION_RULES = `
 
 ## Progress Narration Rules
 
@@ -90,12 +91,16 @@ class AgentEngine {
     llmCaller;
     /** 子模块：工具执行器 */
     toolExecutor;
-    /** 历史摘要缓存：sessionId → { summary, lastSummarizedCount } */
+    /** 历史摘要缓存：sessionId → { summary, lastSummarizedCount }（LRU 限制防止内存泄漏） */
     summaryCache = new Map();
+    /** 摘要缓存上限 */
+    static SUMMARY_CACHE_MAX = 100;
     /** 数据获取类工具集合（用于循环检测） */
     dataFetchTools;
     /** 产出型工具集合（有这些调用时不触发数据获取循环检测） */
     outputTools;
+    /** Guard 策略配置（阈值可注入，不硬编码业务逻辑） */
+    guardConfig;
     constructor(config) {
         this.config = {
             ...config,
@@ -141,6 +146,19 @@ class AgentEngine {
             'delegate_task', 'create_presentation', 'create_document',
             'create_pdf', 'show_widget', 'save_artifact',
         ]);
+        // 初始化 Guard 策略配置（阈值可注入，不硬编码业务逻辑）
+        const gc = config.guardConfig ?? {};
+        this.guardConfig = {
+            iterationGuardThreshold: gc.iterationGuardThreshold ?? 0.35,
+            maxContinuationNudges: gc.maxContinuationNudges ?? 2,
+            consecutiveSilentThreshold: gc.consecutiveSilentThreshold ?? 2,
+            consecutiveAllFailThreshold: gc.consecutiveAllFailThreshold ?? 3,
+            dataFetchLoopMinCount: gc.dataFetchLoopMinCount ?? 3,
+            consecutiveFailMinCount: gc.consecutiveFailMinCount ?? 5,
+            consecutiveFailErrorThreshold: gc.consecutiveFailErrorThreshold ?? 4,
+            delegateTargets: gc.delegateTargets ?? {},
+            iterationGuardPrompt: gc.iterationGuardPrompt ?? '',
+        };
     }
     /** 获取当前 Agent 的 ToolRegistry（供 read_tool_doc 等内置工具使用） */
     getToolRegistry() {
@@ -292,11 +310,11 @@ class AgentEngine {
         if (options.context?.terminalOutput) {
             systemPrompt += `\n\n## Recent Terminal Output\n\n\`\`\`\n${options.context.terminalOutput}\n\`\`\``;
         }
-        // 注入进度叙述规则（仅在有工具可用时）
+        // 注入进度叙述规则（仅在有工具可用时）— P1 #6: 可通过 config 覆盖
         if (this.config.toolRegistry) {
             const toolCount = this.config.toolRegistry.getDefinitions().length;
             if (toolCount > 0) {
-                systemPrompt += PROGRESS_NARRATION_RULES;
+                systemPrompt += this.config.progressNarrationRules ?? DEFAULT_PROGRESS_NARRATION_RULES;
             }
         }
         // 去重检测：如果历史最后一条已经是当前用户消息（由 buildThreadHistory 从 DB 恢复），
@@ -310,7 +328,7 @@ class AgentEngine {
             && typeof lastMsg.content === 'string'
             && lastMsg.content === actualText;
         if (isDuplicateUserMessage) {
-            console.log(`[Engine] Detected duplicate user message in history (likely restored from DB), excluding from summary and re-appending as userMessage`);
+            (0, logger_ts_1.logEvent)({ event: 'engine.duplicate_user_message', sessionId, data: { action: 'excluded_from_summary' } });
         }
         // 非破坏性上下文投影（Context Collapse）：
         // 当历史 token 超过预算时，使用投影而非破坏性压缩，保留原始历史完整
@@ -480,7 +498,7 @@ ${textHistory.join('\n')}`;
             }
         }
         catch (e) {
-            console.warn('[Engine] summarizeHistory failed, falling back to concatenation:', e?.message || e);
+            (0, logger_ts_1.logEvent)({ event: 'engine.summarize_failed', level: 'warn', data: { error: e?.message || String(e) } });
         }
         // 回退：简单拼接，截断到 800 字
         const fallback = textHistory.join('\n');
@@ -495,6 +513,12 @@ ${textHistory.join('\n')}`;
     async refreshSummaryCache(sessionId, textHistory) {
         try {
             const summary = await this.summarizeHistory(textHistory);
+            // P2 #11: LRU 淘汰 — 超过上限时移除最旧的条目
+            if (this.summaryCache.size >= AgentEngine.SUMMARY_CACHE_MAX) {
+                const oldestKey = this.summaryCache.keys().next().value;
+                if (oldestKey !== undefined)
+                    this.summaryCache.delete(oldestKey);
+            }
             this.summaryCache.set(sessionId, {
                 summary,
                 lastSummarizedCount: textHistory.length,
@@ -565,7 +589,7 @@ ${textHistory.join('\n')}`;
     async prepareRun(options, internalAbort) {
         const { skillContent, actualMessage, skillMatched } = await this.resolveSkill(options, options.sessionId);
         const toolDefs = this.resolveToolDefs(options);
-        console.log(`[Engine] session=${options.sessionId} tools(${toolDefs.length}): ${toolDefs.map(t => t.function.name).join(', ') || '(none)'}`);
+        (0, logger_ts_1.logEvent)({ event: 'engine.prepare', sessionId: options.sessionId, data: { toolCount: toolDefs.length, tools: toolDefs.map(t => t.function.name) } });
         return {
             sessionId: options.sessionId,
             messages: await this.buildInitialMessages(options, skillContent, actualMessage, skillMatched),
@@ -599,7 +623,7 @@ ${textHistory.join('\n')}`;
                 const budgetCheck = this.config.usageTracker.checkBudget(state.sessionId, this.config.tokenBudget);
                 if (budgetCheck.exceeded) {
                     if (this.config.tokenBudget.onExceed === 'abort') {
-                        console.warn(`[Engine] Token budget exceeded: ${budgetCheck.currentTokens}/${budgetCheck.maxTokens}, aborting session ${state.sessionId}`);
+                        (0, logger_ts_1.logEvent)({ event: 'engine.token_budget_exceeded', sessionId: state.sessionId, level: 'warn', data: { current: budgetCheck.currentTokens, max: budgetCheck.maxTokens, action: 'abort' } });
                         yield this.createEvent(state.sessionId, {
                             type: 'error',
                             error: `Token budget exceeded (${budgetCheck.currentTokens}/${budgetCheck.maxTokens} tokens). Task aborted to prevent cost overrun.`,
@@ -609,7 +633,7 @@ ${textHistory.join('\n')}`;
                         return;
                     }
                     else {
-                        console.warn(`[Engine] Token budget warning: ${budgetCheck.currentTokens}/${budgetCheck.maxTokens} for session ${state.sessionId}`);
+                        (0, logger_ts_1.logEvent)({ event: 'engine.token_budget_warning', sessionId: state.sessionId, level: 'warn', data: { current: budgetCheck.currentTokens, max: budgetCheck.maxTokens } });
                     }
                 }
             }
@@ -650,7 +674,7 @@ ${textHistory.join('\n')}`;
                 // 所有 LLM provider 均已失败（callWithRetry 内部已重试+降级），
                 // 不再发 done 事件（callWithRetry 已发出带详细错误信息的 error 事件），
                 // 仅完成清理，避免 done 事件覆盖前端已展示的错误消息
-                console.warn(`[Engine] All LLM providers exhausted at iteration ${state.iteration}, stopping agent loop`);
+                (0, logger_ts_1.logEvent)({ event: 'engine.llm_exhausted', sessionId: state.sessionId, level: 'warn', data: { iteration: state.iteration } });
                 this.statusMap.set(state.sessionId, 'idle');
                 // 记录 Token 用量到 UsageTracker
                 if (this.config.usageTracker && state.totalUsage) {
@@ -693,10 +717,10 @@ ${textHistory.join('\n')}`;
             }
             // 无 tool_calls → 检查是否提前停止（上一轮有工具调用，说明任务可能未完成）
             if (!assistant.tool_calls?.length) {
-                if (state.lastIterationHadToolCalls && state.continuationNudges < 2) {
+                if (state.lastIterationHadToolCalls && state.continuationNudges < this.guardConfig.maxContinuationNudges) {
                     state.continuationNudges++;
                     state.lastIterationHadToolCalls = false; // 已消费标记，避免重复注入
-                    console.log(`[Engine] LLM stopped after tool calls without new tool_calls, injecting continuation nudge #${state.continuationNudges} at iteration ${state.iteration}`);
+                    (0, logger_ts_1.logEvent)({ event: 'engine.continuation_nudge', sessionId: state.sessionId, data: { nudge: state.continuationNudges, iteration: state.iteration } });
                     this.injectContinuationNudge(state);
                     // 不退出，继续下一轮迭代让 LLM 继续执行任务
                     continue;
@@ -709,7 +733,7 @@ ${textHistory.join('\n')}`;
             // 检测连续静默迭代（有 tool_calls 但无 content），超过阈值自动注入提醒
             if (!assistant.content) {
                 state.consecutiveSilentIterations++;
-                if (state.consecutiveSilentIterations >= 2) {
+                if (state.consecutiveSilentIterations >= this.guardConfig.consecutiveSilentThreshold) {
                     this.injectProgressNudge(state);
                     state.consecutiveSilentIterations = 0;
                 }
@@ -723,8 +747,8 @@ ${textHistory.join('\n')}`;
                 const allFailed = newRecords.every(r => r.isError);
                 if (allFailed) {
                     state.consecutiveAllFailIterations++;
-                    if (state.consecutiveAllFailIterations >= 3) {
-                        console.warn(`[Engine] Global early stop: ${state.consecutiveAllFailIterations} consecutive all-fail iterations at iteration ${state.iteration}`);
+                    if (state.consecutiveAllFailIterations >= this.guardConfig.consecutiveAllFailThreshold) {
+                        (0, logger_ts_1.logEvent)({ event: 'engine.global_fail_breaker', sessionId: state.sessionId, level: 'warn', data: { consecutiveFails: state.consecutiveAllFailIterations, iteration: state.iteration } });
                         yield this.emitDone(state);
                         return;
                     }
@@ -793,7 +817,7 @@ ${textHistory.join('\n')}`;
         };
         state.messages.push(msg);
         this.historyManager.addHistory(state.sessionId, msg);
-        console.log(`[Engine] Progress nudge injected at iteration ${state.iteration}`);
+        (0, logger_ts_1.logEvent)({ event: 'engine.progress_nudge', sessionId: state.sessionId, data: { iteration: state.iteration } });
     }
     /**
      * 迭代预算提醒
@@ -807,32 +831,35 @@ ${textHistory.join('\n')}`;
         const cur = state.iteration;
         const remaining = max - cur;
         const ratio = cur / max;
-        if (ratio >= 0.35 && remaining > 0) {
+        if (ratio >= this.guardConfig.iterationGuardThreshold && remaining > 0) {
             state.iterationGuardInjected = true;
             const toolCallCount = state.toolCallRecords.length;
-            const msg = {
-                role: 'user',
-                content: [
-                    `[SYSTEM ITERATION BUDGET: iteration ${cur}/${max}, ${remaining} remaining]`,
-                    '',
-                    `⚠️ You have used ${cur} of ${max} iterations (${toolCallCount} tool calls). Budget is running low.`,
-                    '',
-                    '**MANDATORY rules for remaining iterations — violating these will result in task failure:**',
-                    '1. **STOP all data gathering immediately.** You already have enough data from previous tool calls.',
-                    '2. **DO NOT call web_fetch, execute_command, write_file, or run_script again.**',
-                    '3. **NOW delegate remaining work:**',
-                    '   - For reports/dashboards: call `delegate_task` with agent "报表创作助手".',
-                    '   - For documents: call `delegate_task` with agent "文档创作助手".',
-                    '   - For PPT: call `delegate_task` with agent "文档创作助手".',
-                    '   - For direct output: call `create_presentation`/`create_document`/`show_widget` directly.',
-                    '4. If you cannot delegate, produce the final output NOW with the data you have.',
-                    '',
-                    'Do NOT write any more scripts or fetch any more data. Your data collection phase is OVER.',
-                ].join('\n'),
-            };
+            const targets = this.guardConfig.delegateTargets;
+            const reportAgent = targets.report ? `"${targets.report}"` : 'the appropriate report agent';
+            const docAgent = targets.document ? `"${targets.document}"` : 'the appropriate document agent';
+            const pptAgent = targets.presentation ? `"${targets.presentation}"` : docAgent;
+            // P1 #6: 使用可配置的提示文本，默认为通用英文提示（不绑定业务 Agent 名称）
+            const promptText = this.guardConfig.iterationGuardPrompt || [
+                `[SYSTEM ITERATION BUDGET: iteration ${cur}/${max}, ${remaining} remaining]`,
+                '',
+                `⚠️ You have used ${cur} of ${max} iterations (${toolCallCount} tool calls). Budget is running low.`,
+                '',
+                '**MANDATORY rules for remaining iterations — violating these will result in task failure:**',
+                '1. **STOP all data gathering immediately.** You already have enough data from previous tool calls.',
+                '2. **DO NOT call web_fetch, execute_command, write_file, or run_script again.**',
+                `3. **NOW delegate remaining work:**`,
+                `   - For reports/dashboards: call \`delegate_task\` with agent ${reportAgent}.`,
+                `   - For documents: call \`delegate_task\` with agent ${docAgent}.`,
+                `   - For PPT: call \`delegate_task\` with agent ${pptAgent}.`,
+                '   - For direct output: call `create_presentation`/`create_document`/`show_widget` directly.',
+                '4. If you cannot delegate, produce the final output NOW with the data you have.',
+                '',
+                'Do NOT write any more scripts or fetch any more data. Your data collection phase is OVER.',
+            ].join('\n');
+            const msg = { role: 'user', content: promptText };
             state.messages.push(msg);
             this.historyManager.addHistory(state.sessionId, msg);
-            console.log(`[Engine] Iteration guard injected at ${cur}/${max}`);
+            (0, logger_ts_1.logEvent)({ event: 'engine.iteration_guard', sessionId: state.sessionId, data: { iteration: cur, max } });
         }
     }
     /**
@@ -853,19 +880,21 @@ ${textHistory.join('\n')}`;
         if (hasOutput)
             return; // 已调用过产出型工具，不再干预
         const recent = state.toolCallRecords.slice(-6);
-        // --- 条件 1：数据获取循环（最近 3+ 条全是数据获取类） ---
-        if (recent.length >= 3) {
-            const last3 = recent.slice(-3);
-            const allDataFetch = last3.every(r => DATA_FETCH_TOOLS.has(r.tool));
+        // --- 条件 1：数据获取循环（最近 N+ 条全是数据获取类） ---
+        const loopMin = this.guardConfig.dataFetchLoopMinCount;
+        if (recent.length >= loopMin) {
+            const lastN = recent.slice(-loopMin);
+            const allDataFetch = lastN.every(r => DATA_FETCH_TOOLS.has(r.tool));
             if (allDataFetch) {
                 this.injectDataFetchGuard(state, recent, 'loop');
                 return;
             }
         }
-        // --- 条件 2：连续失败熔断（最近 5+ 条中 4+ 条失败） ---
-        if (recent.length >= 5) {
+        // --- 条件 2：连续失败熔断（最近 N+ 条中 M+ 条失败） ---
+        const failMin = this.guardConfig.consecutiveFailMinCount;
+        if (recent.length >= failMin) {
             const errorCount = recent.filter(r => r.isError).length;
-            if (errorCount >= 4) {
+            if (errorCount >= this.guardConfig.consecutiveFailErrorThreshold) {
                 this.injectDataFetchGuard(state, recent, 'failures');
                 return;
             }
@@ -903,7 +932,7 @@ ${textHistory.join('\n')}`;
         };
         state.messages.push(msg);
         this.historyManager.addHistory(state.sessionId, msg);
-        console.log(`[Engine] Data-fetch guard (${reason}) injected at iteration ${state.iteration}, recent: ${toolSummary}`);
+        (0, logger_ts_1.logEvent)({ event: 'engine.data_fetch_guard', sessionId: state.sessionId, data: { reason, iteration: state.iteration, recent: toolSummary } });
     }
     /**
      * 任务继续提示
@@ -930,7 +959,7 @@ ${textHistory.join('\n')}`;
         };
         state.messages.push(msg);
         this.historyManager.addHistory(state.sessionId, msg);
-        console.log(`[Engine] Continuation nudge injected at iteration ${state.iteration} (nudge #${state.continuationNudges})`);
+        (0, logger_ts_1.logEvent)({ event: 'engine.continuation_nudge_injected', sessionId: state.sessionId, data: { iteration: state.iteration, nudge: state.continuationNudges } });
     }
     /**
      * 渐进式结果交付
@@ -959,7 +988,7 @@ ${textHistory.join('\n')}`;
         };
         state.messages.push(msg);
         this.historyManager.addHistory(state.sessionId, msg);
-        console.log(`[Engine] Progressive delivery nudge injected at iteration ${state.iteration} (${delegateCalls.length} parallel delegates)`);
+        (0, logger_ts_1.logEvent)({ event: 'engine.progressive_nudge', sessionId: state.sessionId, data: { iteration: state.iteration, delegates: delegateCalls.length } });
     }
     // ---- Hooks ----
     /** 执行指定事件类型的所有 Hook */