@cicctencent/agent-core 0.1.19 → 0.1.21

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

@@ -0,0 +1,250 @@
+// ============================================================
+// RestA2AClient — REST 风格 A2A 协议客户端
+// 适用于非标准 JSON-RPC 的 A2A 实现（如 capability invoke/stream 风格）
+// 协议特征：
+//   发现：GET  /api/v1/a2a/capabilities/{capabilityId}
+//   同步：POST /api/v1/a2a/capabilities/{capabilityId}:invoke
+//   流式：POST /api/v1/a2a/capabilities/{capabilityId}:stream (SSE)
+//   异步：POST /api/v1/a2a/capabilities/{capabilityId}:submit
+//   查询：GET  /api/v1/a2a/tasks/{taskId}
+//   认证：X-Service-Token 请求头
+// ============================================================
+import { buildAuthHeaders } from "./client.js";
+// ---- RestA2AClient ----
+/**
+ * REST 风格 A2A 协议客户端
+ *
+ * 用法：
+ *   const client = new RestA2AClient({ auth: { type: 'custom', name: 'X-Service-Token', value: 'xxx' } });
+ *   const card = await client.discoverCapability('http://localhost:8000', 'competitive_review');
+ *   const result = await client.invoke('http://localhost:8000', 'competitive_review', { ... });
+ */
+export class RestA2AClient {
+    timeout;
+    connectTimeout;
+    chunkTimeout;
+    fetchFn;
+    headers;
+    constructor(options = {}) {
+        this.timeout = options.timeout ?? 300_000;
+        this.connectTimeout = options.connectTimeout ?? 30_000;
+        this.chunkTimeout = options.chunkTimeout ?? 60_000;
+        this.fetchFn = options.fetch ?? globalThis.fetch.bind(globalThis);
+        this.headers = { ...buildAuthHeaders(options.auth), ...(options.headers ?? {}) };
+    }
+    // ---- Capability 发现 ----
+    /** 获取 Capability Card：GET /api/v1/a2a/capabilities/{capabilityId} */
+    async discoverCapability(baseUrl, capabilityId) {
+        const url = this.buildCapabilityUrl(baseUrl, capabilityId);
+        const res = await this.fetchWithTimeout(url, { method: 'GET' });
+        if (!res.ok) {
+            throw new Error(`REST A2A discover failed: HTTP ${res.status} from ${url}`);
+        }
+        return (await res.json());
+    }
+    // ---- 同步调用 ----
+    /** 同步调用：POST /api/v1/a2a/capabilities/{capabilityId}:invoke */
+    async invoke(baseUrl, capabilityId, input) {
+        const url = this.buildCapabilityUrl(baseUrl, capabilityId, 'invoke');
+        const res = await this.fetchWithTimeout(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', ...this.headers },
+            body: JSON.stringify(input),
+        });
+        if (!res.ok) {
+            let bodyText = '';
+            try {
+                bodyText = await res.text();
+            }
+            catch { /* ignore */ }
+            throw new Error(`REST A2A invoke failed: HTTP ${res.status} from ${url}: ${bodyText.slice(0, 200)}`);
+        }
+        return (await res.json());
+    }
+    // ---- 流式调用 ----
+    /**
+     * 流式调用：POST /api/v1/a2a/capabilities/{capabilityId}:stream (SSE)
+     *
+     * SSE 事件格式（标准 text/event-stream）：
+     *   event: status      data: {"status":"running","trace_id":"..."}
+     *   event: stage       data: {"stage":"loading_skill",...}
+     *   event: tool_call   data: {"tool_name":"...","args":{...}}
+     *   event: tool_result data: {"tool_name":"..."}
+     *   event: message_chunk data: {"content":"..."}
+     *   event: result      data: {"capability_id":"...","status":"completed","result":{...}}
+     *   event: error        data: {"error":"..."}
+     *
+     * @returns 最后一个 result 事件的数据，或 null（流中断且无 result）
+     */
+    async invokeStreaming(baseUrl, capabilityId, input, onEvent, abortSignal) {
+        const url = this.buildCapabilityUrl(baseUrl, capabilityId, 'stream');
+        // 连接阶段：独立 AbortController + connectTimeout + 外部 signal 联动
+        const connectAbort = new AbortController();
+        const connectTimer = setTimeout(() => connectAbort.abort(), this.connectTimeout);
+        if (abortSignal) {
+            if (abortSignal.aborted) {
+                connectAbort.abort();
+            }
+            else {
+                abortSignal.addEventListener('abort', () => connectAbort.abort(), { once: true });
+            }
+        }
+        let res;
+        try {
+            res = await this.fetchFn(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json', ...this.headers },
+                body: JSON.stringify(input),
+                signal: connectAbort.signal,
+            });
+        }
+        catch (fetchErr) {
+            if (abortSignal?.aborted)
+                return null;
+            if (fetchErr?.name === 'AbortError') {
+                throw new Error(`REST A2A streaming connect timeout (${this.connectTimeout}ms) → ${url}`);
+            }
+            throw new Error(`REST A2A streaming connect error → ${url}: ${fetchErr?.message || fetchErr}`);
+        }
+        finally {
+            clearTimeout(connectTimer);
+        }
+        if (!res.ok) {
+            let bodyText = '';
+            try {
+                bodyText = await res.text();
+            }
+            catch { /* ignore */ }
+            console.error(`[REST-A2A-Client] HTTP ${res.status} from ${url}: ${bodyText.slice(0, 200)}`);
+            throw new Error(`REST A2A streaming failed: HTTP ${res.status} from ${url}`);
+        }
+        const body = res.body;
+        if (!body)
+            throw new Error('REST A2A streaming: empty response body');
+        let lastResult = null;
+        const reader = body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = '';
+        let currentEvent = '';
+        try {
+            while (true) {
+                if (abortSignal?.aborted)
+                    break;
+                const { done, value } = await this.readChunkWithTimeout(reader);
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split('\n');
+                buffer = lines.pop() || '';
+                for (const line of lines) {
+                    const trimmed = line.trim();
+                    if (!trimmed || trimmed.startsWith(':'))
+                        continue;
+                    if (trimmed.startsWith('event:')) {
+                        currentEvent = trimmed.slice(6).trim();
+                    }
+                    else if (trimmed.startsWith('data:')) {
+                        const jsonStr = trimmed.slice(5).trim();
+                        if (!jsonStr || jsonStr === '[DONE]') {
+                            currentEvent = '';
+                            continue;
+                        }
+                        try {
+                            const data = JSON.parse(jsonStr);
+                            const sseEvent = { event: currentEvent || 'message', data };
+                            onEvent?.(sseEvent);
+                            // 捕获最终结果
+                            if (sseEvent.event === 'result') {
+                                lastResult = data;
+                            }
+                            else if (sseEvent.event === 'error') {
+                                lastResult = {
+                                    capability_id: capabilityId,
+                                    status: 'failed',
+                                    error: data.error || JSON.stringify(data),
+                                };
+                            }
+                        }
+                        catch { /* skip non-JSON */ }
+                        currentEvent = '';
+                    }
+                }
+            }
+        }
+        catch (streamErr) {
+            // 流异常时保留已接收结果（优雅降级）
+            if (abortSignal?.aborted)
+                return lastResult;
+            if (lastResult) {
+                console.warn(`[REST-A2A-Client] SSE stream error but have result, returning partial: ${streamErr?.message}`);
+                return lastResult;
+            }
+            throw streamErr;
+        }
+        finally {
+            try {
+                reader.releaseLock();
+            }
+            catch { /* ignore */ }
+        }
+        return lastResult;
+    }
+    // ---- 异步任务 ----
+    /** 异步提交：POST /api/v1/a2a/capabilities/{capabilityId}:submit */
+    async submit(baseUrl, capabilityId, input) {
+        const url = this.buildCapabilityUrl(baseUrl, capabilityId, 'submit');
+        const res = await this.fetchWithTimeout(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', ...this.headers },
+            body: JSON.stringify(input),
+        });
+        if (!res.ok) {
+            throw new Error(`REST A2A submit failed: HTTP ${res.status} from ${url}`);
+        }
+        return (await res.json());
+    }
+    /** 查询任务状态：GET /api/v1/a2a/tasks/{taskId} */
+    async getTask(baseUrl, taskId) {
+        const trimmed = baseUrl.replace(/\/+$/, '');
+        const url = `${trimmed}/api/v1/a2a/tasks/${taskId}`;
+        const res = await this.fetchWithTimeout(url, { method: 'GET' });
+        if (!res.ok) {
+            throw new Error(`REST A2A getTask failed: HTTP ${res.status} from ${url}`);
+        }
+        return (await res.json());
+    }
+    // ---- 内部方法 ----
+    /** 构建 Capability URL */
+    buildCapabilityUrl(baseUrl, capabilityId, action) {
+        const trimmed = baseUrl.replace(/\/+$/, '');
+        const base = `${trimmed}/api/v1/a2a/capabilities/${capabilityId}`;
+        return action ? `${base}:${action}` : base;
+    }
+    /** 带 chunkTimeout 的 reader.read() */
+    async readChunkWithTimeout(reader) {
+        let timer;
+        const timeout = new Promise((_, reject) => {
+            timer = setTimeout(() => {
+                reject(new Error(`REST A2A streaming chunk timeout: no data for ${this.chunkTimeout}ms`));
+            }, this.chunkTimeout);
+        });
+        try {
+            return await Promise.race([reader.read(), timeout]);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /** 带超时的 fetch */
+    async fetchWithTimeout(url, init) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            return await this.fetchFn(url, { ...init, signal: controller.signal });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=rest-client.js.map

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

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

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

@@ -0,0 +1,41 @@
+import type { SubAgentRunner } from '../tool/delegate.js';
+import type { RestA2AClient } from './rest-client.js';
+/** createRestA2ARemoteRunner 配置项 */
+export interface RestA2ARemoteRunnerConfig {
+    /** 远程 Agent 的 base URL（如 http://localhost:8000） */
+    baseUrl: string;
+    /** Capability ID（如 'competitive_review'） */
+    capabilityId: string;
+    /** Runner 标识名（展示用） */
+    name: string;
+    /** Runner 能力描述（供 LLM 理解） */
+    description: string;
+    /** REST A2A 客户端实例 */
+    client: RestA2AClient;
+    /** 静态输入字段（如 { caller_agent_id: 'agent-alpha', business_line: '固定收益' }） */
+    staticFields?: Record<string, string>;
+    /** 任务字符串映射到的字段名（默认 'analysis_focus'） */
+    taskField?: string;
+    /** 是否启用流式（默认 true） */
+    streaming?: boolean;
+    /** 流式失败时是否自动回退到同步模式，默认 true */
+    fallbackToSync?: boolean;
+}
+/**
+ * 创建 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 declare function createRestA2ARemoteRunner(config: RestA2ARemoteRunnerConfig): SubAgentRunner;
+//# sourceMappingURL=rest-runner.d.ts.map

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

@@ -0,0 +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,CA4F3F"}

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":"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"}

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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"}