@cicctencent/agent-core 0.1.20 → 0.1.22

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

@@ -0,0 +1,185 @@
+// ============================================================
+// REST 风格 A2A Remote Runner — 将 REST 风格远程 Agent 包装为 SubAgentRunner
+// 供 delegate_task 使用，与标准 JSON-RPC A2A Runner 并行存在
+// ============================================================
+/**
+ * 创建 REST 风格远程 A2A Agent 的 SubAgentRunner
+ *
+ * 核心逻辑：
+ *   - streaming=true && ctx.emitSubEvent 存在 → invokeStreaming + 事件转发
+ *   - 否则 → invoke 同步阻塞
+ *
+ * 事件映射：
+ *   - status(running) → start
+ *   - stage → progress
+ *   - tool_call → tool_call
+ *   - tool_result → tool_result
+ *   - message_chunk → content
+ *   - result → done（由 runStreaming 提取最终文本）
+ *   - error → error
+ */
+export function createRestA2ARemoteRunner(config) {
+    const { baseUrl, capabilityId, name: runnerName, description: runnerDesc, client, staticFields = {}, taskField = 'analysis_focus', streaming = true, fallbackToSync = true, } = config;
+    /** 将 task 字符串构建为请求输入 */
+    function buildInput(task) {
+        return { ...staticFields, [taskField]: task };
+    }
+    /** 从 RestCapabilityResult 中提取最终文本 */
+    function extractResultText(result) {
+        if (result.result?.final_text)
+            return result.result.final_text;
+        if (result.result?.summary)
+            return result.result.summary;
+        // 降级：JSON 序列化整个 result
+        return JSON.stringify(result.result || result, null, 2);
+    }
+    // ---- 同步执行 ----
+    const runSync = async (task) => {
+        try {
+            const result = await client.invoke(baseUrl, capabilityId, buildInput(task));
+            if (result.status === 'failed' || result.error) {
+                const errMsg = result.error || 'Unknown error';
+                console.error(`[REST-A2A] '${runnerName}' sync failed: ${errMsg}`);
+                return `[REST A2A '${runnerName}'] Error: ${errMsg}`;
+            }
+            return extractResultText(result);
+        }
+        catch (err) {
+            console.error(`[REST-A2A] '${runnerName}' sync error: ${err?.message || err}`);
+            return `[REST A2A '${runnerName}'] Error: ${err.message || err}`;
+        }
+    };
+    // ---- 流式执行 ----
+    const runStreaming = async (task, ctx) => {
+        const emit = ctx.emitSubEvent;
+        const parentCallId = ctx.currentToolCallId || `rest_a2a_${Date.now()}`;
+        emitStart(emit, parentCallId, runnerName, task);
+        try {
+            const finalResult = await client.invokeStreaming(baseUrl, capabilityId, buildInput(task), (event) => forwardRestSSEEvent(emit, parentCallId, runnerName, event), ctx.abortSignal);
+            if (finalResult?.status === 'failed' || finalResult?.error) {
+                const errMsg = finalResult.error || 'Remote agent returned error';
+                console.error(`[REST-A2A] '${runnerName}' failed: ${errMsg}`);
+                emitError(emit, parentCallId, runnerName, errMsg);
+                return `[REST A2A '${runnerName}'] Error: ${errMsg}`;
+            }
+            const resultText = finalResult
+                ? extractResultText(finalResult)
+                : 'Task completed with no output.';
+            emitDone(emit, parentCallId, runnerName, resultText.length);
+            return resultText;
+        }
+        catch (err) {
+            const errMsg = err?.message || String(err);
+            console.error(`[REST-A2A] '${runnerName}' streaming error: ${errMsg}`);
+            // 流式失败，自动回退到同步模式
+            if (fallbackToSync) {
+                console.log(`[REST-A2A] '${runnerName}' falling back to sync`);
+                return runSync(task);
+            }
+            emitError(emit, parentCallId, runnerName, errMsg);
+            return `[REST A2A '${runnerName}'] Error: ${errMsg}`;
+        }
+    };
+    return {
+        name: runnerName,
+        description: runnerDesc,
+        run: async (task, ctx, _options) => {
+            return streaming && ctx?.emitSubEvent
+                ? runStreaming(task, ctx)
+                : runSync(task);
+        },
+    };
+}
+// ---- 事件转发辅助函数 ----
+function emitStart(emit, parentCallId, agentName, task) {
+    emit?.({
+        parentToolCallId: parentCallId,
+        agentName,
+        eventType: 'start',
+        data: { agentName, task, source: 'rest-a2a-streaming' },
+    });
+}
+function emitDone(emit, parentCallId, agentName, contentLength) {
+    emit?.({
+        parentToolCallId: parentCallId,
+        agentName,
+        eventType: 'done',
+        data: { contentLength },
+    });
+}
+function emitError(emit, parentCallId, agentName, error) {
+    emit?.({
+        parentToolCallId: parentCallId,
+        agentName,
+        eventType: 'error',
+        data: { error },
+    });
+}
+/**
+ * 将 REST 风格 SSE 事件转发为 SubAgentEvent
+ *
+ * 事件映射：
+ *   status(running)  → progress
+ *   stage            → progress
+ *   tool_call        → tool_call
+ *   tool_result      → tool_result
+ *   message_chunk    → content
+ *   result           → (由 runStreaming 处理，不转发)
+ *   error            → error
+ */
+function forwardRestSSEEvent(emit, parentCallId, agentName, event) {
+    const { event: eventType, data } = event;
+    switch (eventType) {
+        case 'status':
+            // running → progress；completed → 由 result 事件处理
+            if (data.status === 'running') {
+                emit?.({
+                    parentToolCallId: parentCallId,
+                    agentName,
+                    eventType: 'progress',
+                    data: { status: 'running', trace_id: data.trace_id },
+                });
+            }
+            break;
+        case 'stage':
+            emit?.({
+                parentToolCallId: parentCallId,
+                agentName,
+                eventType: 'progress',
+                data: { stage: data.stage, trace_id: data.trace_id },
+            });
+            break;
+        case 'tool_call':
+            emit?.({
+                parentToolCallId: parentCallId,
+                agentName,
+                eventType: 'tool_call',
+                data,
+            });
+            break;
+        case 'tool_result':
+            emit?.({
+                parentToolCallId: parentCallId,
+                agentName,
+                eventType: 'tool_result',
+                data,
+            });
+            break;
+        case 'message_chunk':
+            emit?.({
+                parentToolCallId: parentCallId,
+                agentName,
+                eventType: 'content',
+                data: { content: data.content },
+            });
+            break;
+        // result 和 error 由 runStreaming 的 finalResult 处理，不在此转发
+        case 'result':
+        case 'error':
+            break;
+        default:
+            // 未知事件类型 → 丢弃
+            break;
+    }
+}
+//# sourceMappingURL=rest-runner.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rest-runner.js","sourceRoot":"","sources":["../../../src/a2a/rest-runner.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,mEAAmE;AACnE,kDAAkD;AAClD,+DAA+D;AA4B/D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAiC;IACzE,MAAM,EACJ,OAAO,EACP,YAAY,EACZ,IAAI,EAAE,UAAU,EAChB,WAAW,EAAE,UAAU,EACvB,MAAM,EACN,YAAY,GAAG,EAAE,EACjB,SAAS,GAAG,gBAAgB,EAC5B,SAAS,GAAG,IAAI,EAChB,cAAc,GAAG,IAAI,GACtB,GAAG,MAAM,CAAC;IAEX,wBAAwB;IACxB,SAAS,UAAU,CAAC,IAAY;QAC9B,OAAO,EAAE,GAAG,YAAY,EAAE,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;IAChD,CAAC;IAED,qCAAqC;IACrC,SAAS,iBAAiB,CAAC,MAA4B;QACrD,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU;YAAE,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;QAC/D,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO;YAAE,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;QACzD,uBAAuB;QACvB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,iBAAiB;IACjB,MAAM,OAAO,GAAG,KAAK,EAAE,IAAY,EAAmB,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;YAC5E,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,IAAI,eAAe,CAAC;gBAC/C,OAAO,CAAC,KAAK,CAAC,eAAe,UAAU,kBAAkB,MAAM,EAAE,CAAC,CAAC;gBACnE,OAAO,cAAc,UAAU,aAAa,MAAM,EAAE,CAAC;YACvD,CAAC;YACD,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO,CAAC,KAAK,CAAC,eAAe,UAAU,iBAAiB,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC;YAC/E,OAAO,cAAc,UAAU,aAAa,GAAG,CAAC,OAAO,IAAI,GAAG,EAAE,CAAC;QACnE,CAAC;IACH,CAAC,CAAC;IAEF,iBAAiB;IACjB,MAAM,YAAY,GAAG,KAAK,EAAE,IAAY,EAAE,GAAgB,EAAmB,EAAE;QAC7E,MAAM,IAAI,GAAG,GAAG,CAAC,YAAY,CAAC;QAC9B,MAAM,YAAY,GAAG,GAAG,CAAC,iBAAiB,IAAI,YAAY,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAEvE,SAAS,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;QAEhD,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,eAAe,CAC9C,OAAO,EACP,YAAY,EACZ,UAAU,CAAC,IAAI,CAAC,EAChB,CAAC,KAAK,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,CAAC,EACrE,GAAG,CAAC,WAAW,CAChB,CAAC;YAEF,IAAI,WAAW,EAAE,MAAM,KAAK,QAAQ,IAAI,WAAW,EAAE,KAAK,EAAE,CAAC;gBAC3D,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,IAAI,6BAA6B,CAAC;gBAClE,OAAO,CAAC,KAAK,CAAC,eAAe,UAAU,aAAa,MAAM,EAAE,CAAC,CAAC;gBAC9D,SAAS,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;gBAClD,OAAO,cAAc,UAAU,aAAa,MAAM,EAAE,CAAC;YACvD,CAAC;YAED,MAAM,UAAU,GAAG,WAAW;gBAC5B,CAAC,CAAC,iBAAiB,CAAC,WAAW,CAAC;gBAChC,CAAC,CAAC,gCAAgC,CAAC;YACrC,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;YAC5D,OAAO,UAAU,CAAC;QACpB,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,MAAM,MAAM,GAAG,GAAG,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC;YAC3C,OAAO,CAAC,KAAK,CAAC,eAAe,UAAU,sBAAsB,MAAM,EAAE,CAAC,CAAC;YACvE,iBAAiB;YACjB,IAAI,cAAc,EAAE,CAAC;gBACnB,OAAO,CAAC,GAAG,CAAC,eAAe,UAAU,wBAAwB,CAAC,CAAC;gBAC/D,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;YACD,SAAS,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;YAClD,OAAO,cAAc,UAAU,aAAa,MAAM,EAAE,CAAC;QACvD,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,UAAU;QACvB,GAAG,EAAE,KAAK,EAAE,IAAY,EAAE,GAAG,EAAE,QAAQ,EAAmB,EAAE;YAC1D,OAAO,SAAS,IAAI,GAAG,EAAE,YAAY;gBACnC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC;gBACzB,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,qBAAqB;AAErB,SAAS,SAAS,CAChB,IAAsC,EACtC,YAAoB,EACpB,SAAiB,EACjB,IAAY;IAEZ,IAAI,EAAE,CAAC;QACL,gBAAgB,EAAE,YAAY;QAC9B,SAAS;QACT,SAAS,EAAE,OAAO;QAClB,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,oBAAoB,EAAE;KACxD,CAAC,CAAC;AACL,CAAC;AAED,SAAS,QAAQ,CACf,IAAsC,EACtC,YAAoB,EACpB,SAAiB,EACjB,aAAqB;IAErB,IAAI,EAAE,CAAC;QACL,gBAAgB,EAAE,YAAY;QAC9B,SAAS;QACT,SAAS,EAAE,MAAM;QACjB,IAAI,EAAE,EAAE,aAAa,EAAE;KACxB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,SAAS,CAChB,IAAsC,EACtC,YAAoB,EACpB,SAAiB,EACjB,KAAa;IAEb,IAAI,EAAE,CAAC;QACL,gBAAgB,EAAE,YAAY;QAC9B,SAAS;QACT,SAAS,EAAE,OAAO;QAClB,IAAI,EAAE,EAAE,KAAK,EAAE;KAChB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,mBAAmB,CAC1B,IAAsC,EACtC,YAAoB,EACpB,SAAiB,EACjB,KAAmB;IAEnB,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IAEzC,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,QAAQ;YACX,+CAA+C;YAC/C,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC9B,IAAI,EAAE,CAAC;oBACL,gBAAgB,EAAE,YAAY;oBAC9B,SAAS;oBACT,SAAS,EAAE,UAAU;oBACrB,IAAI,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE;iBACrD,CAAC,CAAC;YACL,CAAC;YACD,MAAM;QAER,KAAK,OAAO;YACV,IAAI,EAAE,CAAC;gBACL,gBAAgB,EAAE,YAAY;gBAC9B,SAAS;gBACT,SAAS,EAAE,UAAU;gBACrB,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE;aACrD,CAAC,CAAC;YACH,MAAM;QAER,KAAK,WAAW;YACd,IAAI,EAAE,CAAC;gBACL,gBAAgB,EAAE,YAAY;gBAC9B,SAAS;gBACT,SAAS,EAAE,WAAW;gBACtB,IAAI;aACL,CAAC,CAAC;YACH,MAAM;QAER,KAAK,aAAa;YAChB,IAAI,EAAE,CAAC;gBACL,gBAAgB,EAAE,YAAY;gBAC9B,SAAS;gBACT,SAAS,EAAE,aAAa;gBACxB,IAAI;aACL,CAAC,CAAC;YACH,MAAM;QAER,KAAK,eAAe;YAClB,IAAI,EAAE,CAAC;gBACL,gBAAgB,EAAE,YAAY;gBAC9B,SAAS;gBACT,SAAS,EAAE,SAAS;gBACpB,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;aAChC,CAAC,CAAC;YACH,MAAM;QAER,uDAAuD;QACvD,KAAK,QAAQ,CAAC;QACd,KAAK,OAAO;YACV,MAAM;QAER;YACE,cAAc;YACd,MAAM;IACV,CAAC;AACH,CAAC"}

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

@@ -68,6 +68,23 @@ export declare class AgentEngine {
     private resolveSkill;
     /** 构建初始消息列表（system + history + user） */
     private buildInitialMessages;
+    /**
+     * 将对话历史压缩为摘要，用 <conversation_history> XML 标签包裹，
+     * 注入为 user 消息 + assistant 确认对。
+     *
+     * 摘要是陈述句，当前消息是指令句，语义上天然区分。
+     * ≤2 条消息时直接拼接，省去 LLM 调用；LLM 失败时回退到简单拼接。
+     *
+     * @param history 历史消息列表
+     * @param currentText 当前用户消息文本（用于排除最后一条匹配的 user 消息，null 表示全部纳入摘要）
+     * @returns 摘要消息对 [user: <conversation_history>..., assistant: 确认]
+     */
+    private buildHistoryMessages;
+    /**
+     * 通过轻量 LLM 调用将多轮对话历史压缩为 ≤800 字的陈述句摘要。
+     * LLM 失败时回退到简单拼接。
+     */
+    private summarizeHistory;
     /** 获取工具定义列表（含预过滤 + 渐进式发现） */
     private resolveToolDefs;
     /** 构建 ToolContext */

package/dist/esm/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/esm/agent/engine.js

@@ -36,6 +36,43 @@ function buildSkillCatalog(skillManager) {
     const lines = manifests.map(m => `- \`${m.id}\`: ${m.name} — ${m.description || '(no description)'}`);
     return `## Available Skills\n\nYou have access to the following skills. Use \`load_skill(skill_id="<id>")\` to load full instructions when a task matches a skill's purpose.\n\n${lines.join('\n')}`;
 }
+/**
+ * 生成工具调用的简短摘要（用于历史摘要）。
+ * 保留工具名和关键参数，让 LLM 在后续轮次中能复用之前的调用参数。
+ */
+function summarizeToolCall(name, args) {
+    switch (name) {
+        case 'send_email': {
+            const to = Array.isArray(args.to) ? args.to.join(',') : (args.to || '');
+            const subject = (args.subject || '').slice(0, 60);
+            const hasAttachments = Array.isArray(args.attachments) && args.attachments.length > 0;
+            return `send_email(to=${to}, subject="${subject}"${hasAttachments ? ', with_attachments' : ''})`;
+        }
+        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(', ')})`;
+        }
+    }
+}
 export class AgentEngine {
     config;
     /** sessionId → AgentStatus */
@@ -214,7 +251,7 @@ export class AgentEngine {
         return { actualMessage: options.message, skillMatched: false };
     }
     /** 构建初始消息列表（system + history + user） */
-    buildInitialMessages(options, skillContent, actualMessage, skillMatched) {
+    async buildInitialMessages(options, skillContent, actualMessage, skillMatched) {
         const { sessionId } = options;
         let systemPrompt = this.config.basePrompt || '';
         if (options.systemPromptOverride) {
@@ -257,8 +294,9 @@ export class AgentEngine {
                 systemPrompt += PROGRESS_NARRATION_RULES;
             }
         }
-        // 去重：如果历史最后一条已经是当前用户消息（由 buildThreadHistory 从 DB 恢复），
-        // 则不再重复追加，避免 LLM 看到两条连续相同的 user 消息导致意图理解偏差
+        // 去重检测：如果历史最后一条已经是当前用户消息（由 buildThreadHistory 从 DB 恢复），
+        // 则在构建历史摘要时排除该消息，但仍需将当前用户消息作为 userMessage 传入。
+        // 之前的实现将 userMessage 设为 undefined，导致 LLM 收不到用户实际请求 → 空响应。
         const history = this.historyManager.getHistory(sessionId);
         const lastMsg = history.length > 0 ? history[history.length - 1] : null;
         // 多模态消息去重：比较文本内容
@@ -266,17 +304,158 @@ export class AgentEngine {
         const isDuplicateUserMessage = lastMsg?.role === 'user'
             && 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`);
+        }
         // 非破坏性上下文投影（Context Collapse）：
         // 当历史 token 超过预算时，使用投影而非破坏性压缩，保留原始历史完整
         const maxContextTokens = this.config.contextBudget?.maxContextTokens ?? 100000;
         const projectedHistory = this.historyManager.getProjectedHistory
             ? this.historyManager.getProjectedHistory(sessionId, maxContextTokens)
             : history;
+        // 历史摘要 + XML 标签：将多轮对话历史压缩为 ≤300 字摘要，
+        // 用 <conversation_history> 标签包裹注入为 user+assistant 消息对。
+        // 摘要是陈述句，当前消息是指令句，语义上天然区分，从结构上消除混淆。
+        // 当 isDuplicateUserMessage 时，buildHistoryMessages 会从摘要中排除当前消息，
+        // 然后通过 userMessage 参数重新追加，确保 LLM 能看到用户的实际请求。
+        const historyMessages = isDuplicateUserMessage
+            ? await this.buildHistoryMessages(projectedHistory, actualText)
+            : await this.buildHistoryMessages(projectedHistory, null);
         return this.config.contextManager.buildMessages({
             systemPrompt,
-            history: projectedHistory,
-            userMessage: isDuplicateUserMessage ? undefined : actualMessage,
+            history: historyMessages,
+            userMessage: actualMessage,
+        });
+    }
+    /**
+     * 将对话历史压缩为摘要，用 <conversation_history> XML 标签包裹，
+     * 注入为 user 消息 + assistant 确认对。
+     *
+     * 摘要是陈述句，当前消息是指令句，语义上天然区分。
+     * ≤2 条消息时直接拼接，省去 LLM 调用；LLM 失败时回退到简单拼接。
+     *
+     * @param history 历史消息列表
+     * @param currentText 当前用户消息文本（用于排除最后一条匹配的 user 消息，null 表示全部纳入摘要）
+     * @returns 摘要消息对 [user: <conversation_history>..., assistant: 确认]
+     */
+    async buildHistoryMessages(history, currentText) {
+        if (history.length === 0)
+            return [];
+        // 排除最后一条与当前消息匹配的 user 消息（避免重复）
+        let effectiveHistory = history;
+        if (currentText) {
+            for (let i = history.length - 1; i >= 0; i--) {
+                if (history[i].role === 'user') {
+                    const text = typeof history[i].content === 'string'
+                        ? history[i].content
+                        : extractTextFromContent(history[i].content);
+                    if (text === currentText) {
+                        effectiveHistory = history.slice(0, i);
+                    }
+                    break;
+                }
+            }
+        }
+        if (effectiveHistory.length === 0)
+            return [];
+        // 提取纯文本用于摘要（包含工具调用和工具结果，否则 LLM 丢失关键上下文）
+        const textHistory = effectiveHistory
+            .map(m => {
+            if (m.role === 'tool') {
+                // 工具结果消息：保留状态和摘要
+                const text = typeof m.content === 'string'
+                    ? m.content
+                    : extractTextFromContent(m.content);
+                // 保留 artifact URL（关键！否则后续 send_email 无法引用已生成的报告）
+                const urlMatch = text.match(/(?:URL|url|artifact)[：:]\s*(\/api\/[^\s"']+)/i);
+                const urlInfo = urlMatch ? ` [artifact_url: ${urlMatch[1]}]` : '';
+                const truncated = text.length > 150
+                    ? text.slice(0, 150) + '...' + urlInfo
+                    : text + urlInfo;
+                return `[工具结果]: ${truncated}`;
+            }
+            const text = typeof m.content === 'string'
+                ? m.content
+                : extractTextFromContent(m.content);
+            // 为 assistant 消息附加工具调用摘要（关键！否则 send_email 等参数完全丢失）
+            let toolInfo = '';
+            if (m.role === 'assistant' && m.tool_calls?.length) {
+                const callSummaries = m.tool_calls.map(tc => {
+                    let args = {};
+                    try {
+                        args = JSON.parse(tc.function.arguments);
+                    }
+                    catch { /* ignore */ }
+                    return summarizeToolCall(tc.function.name, args);
+                });
+                toolInfo = ` [调用: ${callSummaries.join('; ')}]`;
+            }
+            // 截断过长的内容（assistant 保留较短，因为工具调用信息更重要）
+            const maxLen = m.role === 'assistant' ? 150 : 200;
+            const truncated = text.length > maxLen
+                ? text.slice(0, maxLen) + '...'
+                : text;
+            return `${m.role === 'user' ? '用户' : '助手'}: ${truncated}${toolInfo}`;
         });
+        if (textHistory.length === 0)
+            return [];
+        // ≤2 条消息直接拼接，省去 LLM 调用
+        let summary;
+        if (textHistory.length <= 2) {
+            summary = textHistory.join('\n');
+        }
+        else {
+            summary = await this.summarizeHistory(textHistory);
+        }
+        // 用 XML 标签包裹，注入为 user + assistant 确认对
+        return [
+            {
+                role: 'user',
+                content: `<conversation_history>\n${summary}\n</conversation_history>`,
+            },
+            {
+                role: 'assistant',
+                content: '好的，我已了解之前的对话内容。请告诉我您现在的需求。',
+            },
+        ];
+    }
+    /**
+     * 通过轻量 LLM 调用将多轮对话历史压缩为 ≤800 字的陈述句摘要。
+     * LLM 失败时回退到简单拼接。
+     */
+    async summarizeHistory(textHistory) {
+        try {
+            const provider = this.config.llmProvider;
+            const prompt = `请将以下对话历史压缩为不超过800字的陈述句摘要。必须保留：
+1. 用户的核心请求和意图
+2. 助手调用了哪些工具（工具名+关键参数，如收件人邮箱、邮件主题等）
+3. 工具调用的结果（成功/失败）
+4. 已生成的内容摘要（如报告主题、数据要点）
+5. **artifact URL**（格式如 /api/work/artifacts/...），这是后续发送邮件等操作的关键引用
+
+不要添加任何评价或建议，只做客观压缩：
+
+${textHistory.join('\n')}`;
+            const response = await provider.chat({
+                messages: [
+                    { role: 'system', content: '你是一个对话摘要助手。将对话历史压缩为简洁的陈述句摘要，不超过800字。务必保留工具调用名称和关键参数（如邮箱地址、邮件主题等），因为这些是后续操作的重要上下文。' },
+                    { role: 'user', content: prompt },
+                ],
+                temperature: 0.3,
+                maxTokens: 1000,
+            });
+            const rawContent = response.choices?.[0]?.message?.content;
+            const summary = typeof rawContent === 'string' ? rawContent.trim() : '';
+            if (summary && summary.length > 0) {
+                return summary.length > 800 ? summary.slice(0, 800) + '...' : summary;
+            }
+        }
+        catch (e) {
+            console.warn('[Engine] summarizeHistory failed, falling back to concatenation:', e?.message || e);
+        }
+        // 回退：简单拼接，截断到 800 字
+        const fallback = textHistory.join('\n');
+        return fallback.length > 800 ? fallback.slice(0, 800) + '...' : fallback;
     }
     // ---- 工具定义 ----
     /** 获取工具定义列表（含预过滤 + 渐进式发现） */
@@ -342,7 +521,7 @@ export class AgentEngine {
         console.log(`[Engine] session=${options.sessionId} tools(${toolDefs.length}): ${toolDefs.map(t => t.function.name).join(', ') || '(none)'}`);
         return {
             sessionId: options.sessionId,
-            messages: this.buildInitialMessages(options, skillContent, actualMessage, skillMatched),
+            messages: await this.buildInitialMessages(options, skillContent, actualMessage, skillMatched),
             toolDefs,
             toolContext: this.buildToolContext(options, internalAbort),
             internalAbort,
@@ -363,7 +542,6 @@ export class AgentEngine {
     async *agentLoop(state) {
         while (state.iteration < this.config.maxIterations) {
             state.iteration++;
-            state.lastIterationHadToolCalls = false; // 每轮迭代重置，工具执行后才置 true
             // 中断检查
             if (state.internalAbort.signal.aborted) {
                 yield this.emitDone(state);
@@ -422,13 +600,29 @@ export class AgentEngine {
                 state.totalUsage.totalTokens += usage.totalTokens || 0;
             }
             if (!assistant) {
-                // LLM 返回 null（上下文过长/错误）后，如果上一轮有工具调用，注入提示重试
-                if (state.lastIterationHadToolCalls && state.continuationNudges < 2) {
-                    state.continuationNudges++;
-                    console.log(`[Engine] LLM returned null after tool calls, injecting continuation nudge #${state.continuationNudges} at iteration ${state.iteration}`);
-                    this.injectContinuationNudge(state);
+                // 所有 LLM provider 均已失败（callWithRetry 内部已重试+降级），
+                // 不再发 done 事件（callWithRetry 已发出带详细错误信息的 error 事件），
+                // 仅完成清理，避免 done 事件覆盖前端已展示的错误消息
+                console.warn(`[Engine] All LLM providers exhausted at iteration ${state.iteration}, stopping agent loop`);
+                this.statusMap.set(state.sessionId, 'idle');
+                // 记录 Token 用量到 UsageTracker
+                if (this.config.usageTracker && state.totalUsage) {
+                    const modelInfo = this.config.llmProvider.getModel();
+                    this.config.usageTracker.record({
+                        sessionId: state.sessionId,
+                        provider: modelInfo.provider,
+                        model: modelInfo.model,
+                        usage: state.totalUsage,
+                        iterations: state.iteration,
+                    });
                 }
-                continue;
+                this.runHooks('on_complete', {
+                    sessionId: state.sessionId,
+                    iteration: state.iteration,
+                    totalIterations: state.iteration,
+                    usage: state.totalUsage,
+                }).catch(() => { });
+                return;
             }
             // Hook: after_ll_call
             await this.runHooks('after_ll_call', {
@@ -454,6 +648,7 @@ export class AgentEngine {
             if (!assistant.tool_calls?.length) {
                 if (state.lastIterationHadToolCalls && state.continuationNudges < 2) {
                     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}`);
                     this.injectContinuationNudge(state);
                     // 不退出，继续下一轮迭代让 LLM 继续执行任务