@cicctencent/agent-core 1.0.16 → 1.0.18

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

@@ -0,0 +1,26 @@
+import type { ToolDefinition } from '../tool/types.js';
+/**
+ * 生成工具调用的简短摘要（用于历史摘要）。
+ * 保留工具名和关键参数，让 LLM 在后续轮次中能复用之前的调用参数。
+ *
+ * @param name 工具名
+ * @param args 工具参数
+ */
+export declare function summarizeToolCall(name: string, args: Record<string, unknown>): string;
+/** 工具定义摘要选项 */
+export interface SummarizeToolDefOptions {
+    /** 摘要范围：'mcp'=仅 MCP 工具摘要, 'all'=所有传入工具摘要, null=保持原样 */
+    scope: 'mcp' | 'all' | null;
+    /** 最大描述长度（默认 100） */
+    maxDesc?: number;
+    /** 判断工具分类的回调（由调用方注入 ToolRegistry 依赖，保持此处无硬依赖） */
+    getCategory?: (name: string) => string | undefined;
+}
+/**
+ * 将工具定义转为摘要形式（截断 description + 清空 parameters）。
+ *
+ * @param def 原始工具定义
+ * @param options 摘要选项（含 category 查询注入）
+ */
+export declare function summarizeToolDef(def: ToolDefinition, options: SummarizeToolDefOptions): ToolDefinition;
+//# sourceMappingURL=compaction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../../src/agent/compaction.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAkBvD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CA0BrF;AAED,eAAe;AACf,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,KAAK,EAAE,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC;IAC5B,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACpD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,uBAAuB,GAC/B,cAAc,CAoBhB"}

package/dist/cjs/agent/compaction.js

@@ -0,0 +1,95 @@
+"use strict";
+// ============================================================
+// Compaction — 历史压缩纯逻辑（从 engine.ts 抽离）
+// ============================================================
+//
+// 本文件承载 AgentEngine 历史压缩相关的「纯函数」部分，与运行时/LLM 调用解耦，
+// 以便独立单元测试。拆分目标：在重构 engine.ts（~2000 行）前，先锁定这些
+// 可被精确断言的纯逻辑行为，避免拆分引入隐性回归。
+//
+// 依赖说明：
+// - summarizeToolCall: 无外部依赖，纯字符串变换
+// - summarizeToolDef: 需要 ToolRegistry 判断 category（保留轻量依赖）
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.summarizeToolCall = summarizeToolCall;
+exports.summarizeToolDef = summarizeToolDef;
+/**
+ * 安全序列化值为字符串（处理 JSON.stringify 的边界情况）。
+ * - undefined / function / Symbol → String(v)
+ * - 循环引用 → '[Circular]'
+ */
+function safeSerialize(v) {
+    if (v === undefined || typeof v === 'function' || typeof v === 'symbol') {
+        return String(v);
+    }
+    try {
+        return JSON.stringify(v) ?? String(v);
+    }
+    catch {
+        return '[Circular]';
+    }
+}
+/**
+ * 生成工具调用的简短摘要（用于历史摘要）。
+ * 保留工具名和关键参数，让 LLM 在后续轮次中能复用之前的调用参数。
+ *
+ * @param name 工具名
+ * @param args 工具参数
+ */
+function summarizeToolCall(name, args) {
+    switch (name) {
+        case 'delegate_task': {
+            const agent = args.agent || '';
+            const task = typeof args.task === 'string' ? args.task.slice(0, 80) : '';
+            return `delegate_task(agent=${agent}, task="${task}...")`;
+        }
+        case 'create_report':
+        case 'create_presentation':
+        case 'create_document':
+        case 'create_pdf':
+        case 'save_artifact': {
+            const filename = (args.filename || args.title || '').slice(0, 60);
+            return `${name}(filename="${filename}")`;
+        }
+        default: {
+            // 通用：展示前 3 个参数的键名和值摘要
+            const keys = Object.keys(args).slice(0, 3);
+            const parts = keys.map(k => {
+                const v = args[k];
+                const s = typeof v === 'string' ? v.slice(0, 50) : safeSerialize(v).slice(0, 50);
+                return `${k}=${s}`;
+            });
+            return `${name}(${parts.join(', ')})`;
+        }
+    }
+}
+/**
+ * 将工具定义转为摘要形式（截断 description + 清空 parameters）。
+ *
+ * @param def 原始工具定义
+ * @param options 摘要选项（含 category 查询注入）
+ */
+function summarizeToolDef(def, options) {
+    const { scope, maxDesc = 100, getCategory } = options;
+    if (scope === null)
+        return def;
+    if (scope === 'mcp' && getCategory?.(def.function.name) !== 'mcp')
+        return def;
+    const desc = def.function.description.length > maxDesc
+        ? def.function.description.slice(0, maxDesc) + '...'
+        : def.function.description;
+    return {
+        ...def,
+        type: 'function',
+        function: {
+            name: def.function.name,
+            description: desc + ` (use read_tool_doc to get full schema before calling; use read_tool_doc(tool_name="list") to see all available tools)`,
+            parameters: {
+                type: 'object',
+                properties: {},
+                required: [],
+            },
+        },
+    };
+}
+//# sourceMappingURL=compaction.js.map

package/dist/cjs/agent/compaction.js.map

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

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

@@ -140,8 +140,7 @@ export declare class AgentEngine {
     private resolveToolDefs;
     /**
      * 将工具定义转为摘要形式（截断 description + 清空 parameters）。
-     * @param def 原始工具定义
-     * @param scope 摘要范围：'mcp'=仅MCP工具摘要, 'all'=所有传入工具摘要, null=保持原样
+     * 实现抽离至 ./compaction.ts，保持单一来源。
      */
     private summarizeToolDef;
     /** 构建 ToolContext */
@@ -167,16 +166,16 @@ export declare class AgentEngine {
      * - 且这些调用**全部失败** → 最终产出的数据必然来自模型记忆（真实历史或编造，执行层无法区分）；
      * - → 追加「未经实时核验」声明。
      *
-     * 不触发（正确放行）：
-     * - 从未调用外部数据工具（纯本地/推理任务）→ 无需水印；
-     * - 外部数据工具**有成功** → 数据已核验，无需水印。
-     *
-     * @returns 需要追加的声明文本；无需水印时返回空串
-     */
-    private buildProvenanceNotice;
     /**
      * 对最终回复应用数据出处水印（幂等）。
      * 仅当有实际文本内容、需要水印、且尚未包含水印标记时追加。
+     *
+     * 触发（添加水印）：
+     * - 本轮调用过外部数据获取工具且全部失败 → 最终回复中的数据必然来自记忆 → 需要声明；
+     *
+     * 不触发（正确放行）：
+     * - 从未调用外部数据工具（纯本地/推理任务）→ 无需水印；
+     * - 外部数据工具**有成功** → 数据已核验，无需水印。
      */
     private applyProvenanceNotice;
     /**

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

@@ -12,6 +12,7 @@ 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 rate_limit_manager_ts_1 = require("./rate-limit-manager.js");
+const compaction_ts_1 = require("./compaction.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.`;
 /**
@@ -49,7 +50,7 @@ When using tools, you MUST provide brief visible narration for the user:
 - When the task is complete, always end with a clear summary of what was accomplished.
 - DO NOT output tool calls without accompanying text narration.
 - **delegate_task / sub-agent output**: When a delegated sub-agent completes, its full output has ALREADY been streamed to the user in real-time. Do NOT repeat or re-output the sub-agent's content. Only write ONE brief sentence summarizing the outcome, then continue with next steps or conclude.
-- **Reusing delegate_task results**: When you need data from a previous delegate_task call in later turns, use \`read_tool_result(call_id="...")\` to retrieve the saved result instead of re-running delegate_task. Re-running delegate_task is expensive (a full sub-agent execution) and may produce inconsistent results. The call_id is the tool_call_id of the delegate_task's tool result message. If the result has been compressed to a placeholder or offload tag, the call_id is included in the tag text.
+- **Reusing delegate_task results (CRITICAL)**: When the conversation history contains a section marked "[delegate_task 完整分析结果]", **use that data directly** — do NOT re-run delegate_task. Re-running delegate_task is expensive (a full sub-agent execution), may produce inconsistent results, and is strictly prohibited when the analysis data is already available in the conversation history. If the result has been compressed to a placeholder, use \`read_tool_result(call_id="...")\` to retrieve it.
 `;
 /** 数据出处水印标记（隐藏 HTML 注释，用于幂等判定，避免重复注入） */
 const PROVENANCE_MARKER = '<!--provenance-unverified-->';
@@ -71,42 +72,27 @@ function buildSkillCatalog(skillManager) {
     const manifests = skillManager.getAllManifests();
     if (manifests.length === 0)
         return null;
+    let hasResources = false;
     const lines = manifests.map(m => {
         const aliases = m.aliases?.length ? ` (also known as: ${m.aliases.join(', ')})` : '';
-        return `- \`${m.id}\`: ${m.name}${aliases} — ${m.description || '(no description)'}`;
+        // 标注标准目录包资源（脚本/参考文档/静态资源），引导 agent 按需访问
+        const res = m.resources;
+        const badges = [];
+        if (res?.scripts?.length)
+            badges.push(`${res.scripts.length} scripts`);
+        if (res?.references?.length)
+            badges.push(`${res.references.length} refs`);
+        if (res?.assets?.length)
+            badges.push(`${res.assets.length} assets`);
+        if (badges.length)
+            hasResources = true;
+        const resBadge = badges.length ? ` [resources: ${badges.join(', ')}]` : '';
+        return `- \`${m.id}\`: ${m.name}${aliases} — ${m.description || '(no description)'}${resBadge}`;
     });
-    return `## Available Skills\n\nYou have access to the following skills. **Before using any tools, ALWAYS check if the user's request matches one of these skills first.** If a skill is relevant, call \`load_skill(skill_id="<id>")\` to load its full instructions, then follow those instructions. Skill names and aliases may not exactly match the user's wording - use semantic judgment to identify matches.\n\n${lines.join('\n')}`;
-}
-/**
- * 生成工具调用的简短摘要（用于历史摘要）。
- * 保留工具名和关键参数，让 LLM 在后续轮次中能复用之前的调用参数。
- */
-function summarizeToolCall(name, args) {
-    switch (name) {
-        case 'delegate_task': {
-            const agent = args.agent || '';
-            const task = typeof args.task === 'string' ? args.task.slice(0, 80) : '';
-            return `delegate_task(agent=${agent}, task="${task}...")`;
-        }
-        case 'create_report':
-        case 'create_presentation':
-        case 'create_document':
-        case 'create_pdf':
-        case 'save_artifact': {
-            const filename = (args.filename || args.title || '').slice(0, 60);
-            return `${name}(filename="${filename}")`;
-        }
-        default: {
-            // 通用：展示前 3 个参数的键名和值摘要
-            const keys = Object.keys(args).slice(0, 3);
-            const parts = keys.map(k => {
-                const v = args[k];
-                const s = typeof v === 'string' ? v.slice(0, 50) : JSON.stringify(v)?.slice(0, 50);
-                return `${k}=${s}`;
-            });
-            return `${name}(${parts.join(', ')})`;
-        }
-    }
+    const resourceGuide = hasResources
+        ? `\n\nSkills marked with [resources: ...] are standard packages bundling docs and scripts. After loading such a skill with load_skill, read bundled reference docs on demand via \`read_skill_reference(skill_id, path)\` and execute bundled scripts via \`run_skill_script(skill_id, script, args)\` — do NOT read all resources upfront.`
+        : '';
+    return `## Available Skills\n\nYou have access to the following skills. **Before using any tools, ALWAYS check if the user's request matches one of these skills first.** If a skill is relevant, call \`load_skill(skill_id="<id>")\` to load its full instructions, then follow those instructions. Skill names and aliases may not exactly match the user's wording - use semantic judgment to identify matches.\n\n${lines.join('\n')}${resourceGuide}`;
 }
 class AgentEngine {
     config;
@@ -514,6 +500,8 @@ class AgentEngine {
         }
         if (effectiveHistory.length === 0)
             return [];
+        // 收集 delegate_task 完整结果（在 800 字摘要之外单独追加，避免被截断）
+        const delegateTaskResults = [];
         // 提取纯文本用于摘要（包含工具调用和工具结果，否则 LLM 丢失关键上下文）
         const textHistory = effectiveHistory
             .map(m => {
@@ -525,9 +513,23 @@ class AgentEngine {
                 // 保留 artifact URL（关键！否则后续引用已生成的报告/文件时丢失链接）
                 const urlMatch = text.match(/(?:URL|url|artifact)[：:]\s*(\/api\/[^\s"']+)/i);
                 const urlInfo = urlMatch ? ` [artifact_url: ${urlMatch[1]}]` : '';
-                // delegate_task 结果保留更多上下文（500 字符），因为重新生成成本极高，
-                // 摘要中保留更多分析数据可减少 LLM 因"看不到数据"而重跑 delegate_task 的倾向
                 const toolName = history_manager_ts_1.HistoryManager.findToolNameForCallId(m.tool_call_id || '', effectiveHistory);
+                const callIdMatch = text.match(/\[call_id:\s*"([^"]+)"\]/);
+                const extractedCallId = callIdMatch?.[1] || m.tool_call_id || '';
+                // delegate_task 结果：在 textHistory 中仅保留短占位符，
+                // 完整结果在摘要构建后单独追加（不受 800 字摘要截断影响）
+                if (toolName === 'delegate_task' && extractedCallId && this.config.toolResultStore) {
+                    const fullResult = this.config.toolResultStore.read(extractedCallId);
+                    if (fullResult) {
+                        const MAX_DELEGATE_INJECT = 4000;
+                        const injected = fullResult.length > MAX_DELEGATE_INJECT
+                            ? fullResult.slice(0, MAX_DELEGATE_INJECT) + '\n...(已截断，完整结果可用 read_tool_result 检索)'
+                            : fullResult;
+                        delegateTaskResults.push(`[delegate_task 完整分析结果]:\n${injected}`);
+                        return `[工具结果] [delegate_task] 分析完成，完整结果见下方 [delegate_task 完整分析结果] 部分`;
+                    }
+                }
+                // 其他工具结果保留截断摘要
                 const toolResultLimit = toolName === 'delegate_task' ? 500 : 150;
                 const truncated = text.length > toolResultLimit
                     ? text.slice(0, toolResultLimit) + '...' + urlInfo
@@ -546,7 +548,7 @@ class AgentEngine {
                         args = JSON.parse(tc.function.arguments);
                     }
                     catch { /* ignore */ }
-                    return summarizeToolCall(tc.function.name, args);
+                    return (0, compaction_ts_1.summarizeToolCall)(tc.function.name, args);
                 });
                 toolInfo = ` [调用: ${callSummaries.join('; ')}]`;
             }
@@ -586,6 +588,12 @@ class AgentEngine {
                 }
             }
         }
+        // 在 800 字摘要之后追加 delegate_task 完整分析结果（不受摘要截断影响）。
+        // 这是确保后续轮次能直接复用分析数据的关键机制，
+        // 避免 LLM 因"看不到数据"而重新调用 delegate_task。
+        if (delegateTaskResults.length > 0) {
+            summary += `\n\n${delegateTaskResults.join('\n\n---\n\n')}`;
+        }
         // 确保 delegate_task 的 call_id 始终可见（不受摘要截断/LLM压缩影响）。
         // 从 effectiveHistory 的 tool 消息中直接提取 tool_call_id（OpenAI 元数据，始终存在），
         // 不依赖 processToolOutput 的 [call_id:...] 前缀或摘要保留。
@@ -707,31 +715,14 @@ ${textHistory.join('\n')}`;
     }
     /**
      * 将工具定义转为摘要形式（截断 description + 清空 parameters）。
-     * @param def 原始工具定义
-     * @param scope 摘要范围：'mcp'=仅MCP工具摘要, 'all'=所有传入工具摘要, null=保持原样
+     * 实现抽离至 ./compaction.ts，保持单一来源。
      */
     summarizeToolDef(def, scope) {
-        if (scope === null)
-            return def;
-        const tool = this.config.toolRegistry.get(def.function.name);
-        if (scope === 'mcp' && tool?.category !== 'mcp')
-            return def;
-        const maxDesc = this.config.toolSummaryMaxDesc ?? 100;
-        const desc = def.function.description.length > maxDesc
-            ? def.function.description.slice(0, maxDesc) + '...'
-            : def.function.description;
-        return {
-            type: 'function',
-            function: {
-                name: def.function.name,
-                description: desc + ` (use read_tool_doc to get full schema before calling; use read_tool_doc(tool_name="list") to see all available tools)`,
-                parameters: {
-                    type: 'object',
-                    properties: {},
-                    required: [],
-                },
-            },
-        };
+        return (0, compaction_ts_1.summarizeToolDef)(def, {
+            scope,
+            maxDesc: this.config.toolSummaryMaxDesc ?? 100,
+            getCategory: (name) => this.config.toolRegistry.get(name)?.category,
+        });
     }
     // ---- 准备阶段（续） ----
     /** 构建 ToolContext */
@@ -1164,32 +1155,25 @@ ${textHistory.join('\n')}`;
      * - 且这些调用**全部失败** → 最终产出的数据必然来自模型记忆（真实历史或编造，执行层无法区分）；
      * - → 追加「未经实时核验」声明。
      *
-     * 不触发（正确放行）：
-     * - 从未调用外部数据工具（纯本地/推理任务）→ 无需水印；
-     * - 外部数据工具**有成功** → 数据已核验，无需水印。
-     *
-     * @returns 需要追加的声明文本；无需水印时返回空串
-     */
-    buildProvenanceNotice(state) {
-        const externalCalls = state.toolCallRecords.filter(r => this.externalDataFetchTools.has(r.tool));
-        if (externalCalls.length === 0)
-            return ''; // 未尝试外部数据源 → 不判定
-        if (externalCalls.some(r => !r.isError))
-            return ''; // 有成功获取 → 视为已核验
-        return PROVENANCE_UNVERIFIED_NOTICE; // 尝试过但全失败 → 数据来自记忆
-    }
     /**
      * 对最终回复应用数据出处水印（幂等）。
      * 仅当有实际文本内容、需要水印、且尚未包含水印标记时追加。
+     *
+     * 触发（添加水印）：
+     * - 本轮调用过外部数据获取工具且全部失败 → 最终回复中的数据必然来自记忆 → 需要声明；
+     *
+     * 不触发（正确放行）：
+     * - 从未调用外部数据工具（纯本地/推理任务）→ 无需水印；
+     * - 外部数据工具**有成功** → 数据已核验，无需水印。
      */
     applyProvenanceNotice(state, content) {
         if (!content || content.includes(PROVENANCE_MARKER))
             return content;
-        const notice = this.buildProvenanceNotice(state);
-        if (!notice)
+        const externalCalls = state.toolCallRecords.filter(r => this.externalDataFetchTools.has(r.tool));
+        if (externalCalls.length === 0 || externalCalls.some(r => !r.isError))
             return content;
-        (0, logger_ts_1.logEvent)({ event: 'engine.provenance_notice', sessionId: state.sessionId, level: 'warn', data: { iteration: state.iteration, externalCalls: state.toolCallRecords.filter(r => this.externalDataFetchTools.has(r.tool)).length } });
-        return content + notice;
+        (0, logger_ts_1.logEvent)({ event: 'engine.provenance_notice', sessionId: state.sessionId, level: 'warn', data: { iteration: state.iteration, externalCalls: externalCalls.length } });
+        return content + PROVENANCE_UNVERIFIED_NOTICE;
     }
     /**
      * 生成兜底总结（当 LLM 调用失败或无内容输出时使用）。