@cicctencent/agent-core 0.1.15 → 0.1.17

package/README.md

@@ -8,6 +8,7 @@ AI Agent 核心引擎，提供 ReAct 循环编排、多 LLM 供应商抽象、
 
 - [完整 API 文档](./docs/API.md) — 所有模块的接口说明和使用示例
 - [v0.2 升级指南](./docs/UPGRADE_v0.2.md) — 新增 12 个下沉模块的集成指南
+- [Runtime 下沉与迁移指南](./docs/RUNTIME_AND_MIGRATION.md) — Runtime Builder、RunController、默认沙箱、A2A Server Helper 与使用方迁移边界
 
 ## 快速开始
 

package/dist/cjs/a2a/client.d.ts

@@ -1,12 +1,33 @@
 import type { A2AAgentCard, A2ASendTaskParams, A2ATask, A2ATaskEvent } from './types.js';
+/**
+ * 认证配置（统一 bearer / basic / apiKey / custom 四种方式）
+ *
+ * value 支持 `${env.VAR_NAME}` 模板，运行时从环境变量读取敏感凭证。
+ */
+export interface AuthConfig {
+    /** 认证方式 */
+    type: 'bearer' | 'basic' | 'apiKey' | 'custom';
+    /** 认证凭证值（支持 `${env.VAR_NAME}` 模板语法） */
+    value: string;
+    /** apiKey/custom 模式下的 header 名称（如 X-API-Key） */
+    name?: string;
+}
+/** 将 AuthConfig 转为 HTTP 请求头 */
+export declare function buildAuthHeaders(auth?: AuthConfig | null): Record<string, string>;
 /** A2A 客户端配置 */
 export interface A2AClientOptions {
     /** 请求超时（毫秒），默认 300000（5分钟） */
     timeout?: number;
+    /** SSE 连接超时（毫秒），默认 30000（30秒） */
+    connectTimeout?: number;
+    /** SSE 逐 chunk 读取超时（毫秒），默认 60000（60秒无数据视为流中断） */
+    chunkTimeout?: number;
     /** 自定义 fetch 实现（默认使用 globalThis.fetch） */
     fetch?: typeof fetch;
     /** 自定义请求头（如认证 token） */
     headers?: Record<string, string>;
+    /** 认证配置（自动转为 headers，与 headers 合并） */
+    auth?: AuthConfig;
 }
 /**
  * 轻量 A2A 协议客户端
@@ -18,6 +39,8 @@ export interface A2AClientOptions {
  */
 export declare class A2AClient {
     private timeout;
+    private connectTimeout;
+    private chunkTimeout;
     private fetchFn;
     private headers;
     constructor(options?: A2AClientOptions);
@@ -31,6 +54,13 @@ export declare class A2AClient {
     /**
      * 流式发送任务（tasks/sendSubscribe），通过回调逐步接收事件
      * 返回最后一个 status-update 事件（通常为 final 事件），用于提取最终结果
+     *
+     * 增强特性：
+     * - connectTimeout: SSE 连接超时（默认 30s）
+     * - chunkTimeout: 逐 chunk 读取超时（默认 60s 无数据视为流中断）
+     * - 外部 AbortSignal 联动（前端断开时中止连接和读取）
+     * - 流异常时保留已接收事件（优雅降级）
+     *
      * @param abortSignal 外部中止信号（前端断开时中止 SSE 读取）
      */
     sendTaskStreaming(agentUrl: string, params: A2ASendTaskParams, onEvent?: (event: A2ATaskEvent) => void, abortSignal?: AbortSignal): Promise<A2ATaskEvent | null>;
@@ -42,8 +72,8 @@ export declare class A2AClient {
     private resolveAgentCardUrl;
     /** 发送 JSON-RPC 请求 */
     private jsonRpcCall;
-    /** 带超时的 reader.read()（每次读取单独计时，收到数据即重置） */
-    private readWithTimeout;
+    /** 带 chunkTimeout 的 reader.read()（每次读取单独计时，收到数据即重置） */
+    private readChunkWithTimeout;
     /** 带超时的 fetch */
     private fetchWithTimeout;
 }

package/dist/cjs/a2a/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/a2a/client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,YAAY,EAGZ,iBAAiB,EACjB,OAAO,EACP,YAAY,EAGb,MAAM,YAAY,CAAC;AASpB,gBAAgB;AAChB,MAAM,WAAW,gBAAgB;IAC/B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,OAAO,CAAyB;gBAE5B,OAAO,GAAE,gBAAqB;IAQ1C;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAe3D,wCAAwC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ7E;;;;OAIG;IACG,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,EACvC,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IA0E/B,wBAAwB;IAClB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUzF,yBAAyB;IACnB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWpE,wBAAwB;IACxB,OAAO,CAAC,mBAAmB;IAM3B,qBAAqB;YACP,WAAW;IAyBzB,2CAA2C;YAC7B,eAAe;IAgB7B,iBAAiB;YACH,gBAAgB;CAS/B"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/a2a/client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,YAAY,EAGZ,iBAAiB,EACjB,OAAO,EACP,YAAY,EAGb,MAAM,YAAY,CAAC;AASpB;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW;IACX,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC/C,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,+BAA+B;AAC/B,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUjF;AAED,gBAAgB;AAChB,MAAM,WAAW,gBAAgB;IAC/B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,sCAAsC;IACtC,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,OAAO,CAAyB;gBAE5B,OAAO,GAAE,gBAAqB;IAU1C;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAe3D,wCAAwC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ7E;;;;;;;;;;;OAWG;IACG,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,EACvC,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IA2F/B,wBAAwB;IAClB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUzF,yBAAyB;IACnB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWpE,wBAAwB;IACxB,OAAO,CAAC,mBAAmB;IAM3B,qBAAqB;YACP,WAAW;IAyBzB,uDAAuD;YACzC,oBAAoB;IAgBlC,iBAAiB;YACH,gBAAgB;CAS/B"}

package/dist/cjs/a2a/client.js

@@ -5,11 +5,25 @@
 // ============================================================
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.A2AClient = void 0;
+exports.buildAuthHeaders = buildAuthHeaders;
 /** JSON-RPC 请求 ID 自增计数器 */
 let rpcIdCounter = 0;
 function nextRpcId() {
     return `a2a_${++rpcIdCounter}_${Date.now()}`;
 }
+/** 将 AuthConfig 转为 HTTP 请求头 */
+function buildAuthHeaders(auth) {
+    if (!auth?.value)
+        return {};
+    const val = auth.value.replace(/\$\{env\.(\w+)\}/g, (_, name) => process.env[name] || '');
+    switch (auth.type) {
+        case 'bearer': return { 'Authorization': `Bearer ${val}` };
+        case 'basic': return { 'Authorization': `Basic ${val}` };
+        case 'apiKey': return { [auth.name || 'X-API-Key']: val };
+        case 'custom': return { [auth.name || 'X-Custom-Auth']: val };
+        default: return {};
+    }
+}
 /**
  * 轻量 A2A 协议客户端
  *
@@ -20,12 +34,16 @@ function nextRpcId() {
  */
 class A2AClient {
     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 = options.headers ?? {};
+        this.headers = { ...buildAuthHeaders(options.auth), ...(options.headers ?? {}) };
     }
     // ---- Agent 发现 ----
     /**
@@ -56,6 +74,13 @@ class A2AClient {
     /**
      * 流式发送任务（tasks/sendSubscribe），通过回调逐步接收事件
      * 返回最后一个 status-update 事件（通常为 final 事件），用于提取最终结果
+     *
+     * 增强特性：
+     * - connectTimeout: SSE 连接超时（默认 30s）
+     * - chunkTimeout: 逐 chunk 读取超时（默认 60s 无数据视为流中断）
+     * - 外部 AbortSignal 联动（前端断开时中止连接和读取）
+     * - 流异常时保留已接收事件（优雅降级）
+     *
      * @param abortSignal 外部中止信号（前端断开时中止 SSE 读取）
      */
     async sendTaskStreaming(agentUrl, params, onEvent, abortSignal) {
@@ -65,20 +90,36 @@ class A2AClient {
             method: 'tasks/sendSubscribe',
             params: params,
         };
-        // 流式请求不使用全局超时，改用逐次读取超时（收到任何数据含心跳即重置）
+        // 连接阶段：使用独立 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(agentUrl, {
                 method: 'POST',
                 headers: { 'Content-Type': 'application/json', ...this.headers },
                 body: JSON.stringify(request),
-                signal: abortSignal,
+                signal: connectAbort.signal,
             });
         }
         catch (fetchErr) {
             if (abortSignal?.aborted)
                 return null;
-            throw new Error(`A2A streaming network error: ${fetchErr?.message || fetchErr} (url=${agentUrl})`);
+            if (fetchErr?.name === 'AbortError') {
+                throw new Error(`A2A streaming connect timeout (${this.connectTimeout}ms) → ${agentUrl}`);
+            }
+            throw new Error(`A2A streaming connect error → ${agentUrl}: ${fetchErr?.message || fetchErr}`);
+        }
+        finally {
+            clearTimeout(connectTimer);
         }
         if (!res.ok) {
             let bodyText = '';
@@ -101,7 +142,7 @@ class A2AClient {
             while (true) {
                 if (abortSignal?.aborted)
                     break;
-                const { done, value } = await this.readWithTimeout(reader);
+                const { done, value } = await this.readChunkWithTimeout(reader);
                 if (done)
                     break;
                 buffer += decoder.decode(value, { stream: true });
@@ -127,12 +168,20 @@ class A2AClient {
             }
         }
         catch (streamErr) {
+            // 流异常时保留已接收事件（优雅降级）
             if (abortSignal?.aborted)
                 return lastStatusUpdate;
+            if (lastStatusUpdate) {
+                console.warn(`[A2A-Client] SSE stream error but have events, returning partial: ${streamErr?.message}`);
+                return lastStatusUpdate;
+            }
             throw streamErr;
         }
         finally {
-            reader.releaseLock();
+            try {
+                reader.releaseLock();
+            }
+            catch { /* ignore */ }
         }
         return lastStatusUpdate;
     }
@@ -182,13 +231,13 @@ class A2AClient {
         }
         return (await res.json());
     }
-    /** 带超时的 reader.read()（每次读取单独计时，收到数据即重置） */
-    async readWithTimeout(reader) {
+    /** 带 chunkTimeout 的 reader.read()（每次读取单独计时，收到数据即重置） */
+    async readChunkWithTimeout(reader) {
         let timer;
         const timeout = new Promise((_, reject) => {
             timer = setTimeout(() => {
-                reject(new Error(`A2A streaming read timeout: no data for ${this.timeout}ms`));
-            }, this.timeout);
+                reject(new Error(`A2A streaming chunk timeout: no data for ${this.chunkTimeout}ms`));
+            }, this.chunkTimeout);
         });
         try {
             return await Promise.race([reader.read(), timeout]);

package/dist/cjs/a2a/client.js.map

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

package/dist/cjs/a2a/index.d.ts

@@ -1,5 +1,8 @@
 export type { A2AAgentCard, A2AAgentSkill, A2AAgentCapabilities, A2ATextPart, A2AFilePart, A2ADataPart, A2APart, A2AMessage, A2ATaskState, A2ATaskStatus, A2AArtifact, A2ATask, A2ATaskStatusUpdateEvent, A2ATaskArtifactUpdateEvent, A2ATaskEvent, A2AJsonRpcRequest, A2AJsonRpcResponse, A2AJsonRpcError, A2ASendTaskParams, A2ASendSubscribeParams, A2AGetTaskParams, A2ACancelTaskParams, A2ARemoteAgentConfig, } from './types.js';
-export { A2AClient } from './client.js';
+export { A2AClient, buildAuthHeaders } from './client.js';
+export type { AuthConfig, A2AClientOptions } from './client.js';
 export { createA2ARemoteRunner, extractTextFromMessage } from './runner.js';
 export type { A2ARemoteRunnerConfig } from './runner.js';
+export { A2AServerHandler, InMemoryA2ATaskStore, createA2AAgentCard, createA2AMessage, mapAgentEventToA2AEvent, } from './server.js';
+export type { A2AHandlerResponse, A2AServerAgentConfig, A2AServerHandlerOptions, A2AStreamingJsonRpcResponse, A2ATaskStore, } from './server.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/a2a/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/a2a/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,WAAW,EACX,WAAW,EACX,WAAW,EACX,OAAO,EACP,UAAU,EACV,YAAY,EACZ,aAAa,EACb,WAAW,EACX,OAAO,EACP,wBAAwB,EACxB,0BAA0B,EAC1B,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC5E,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/a2a/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,WAAW,EACX,WAAW,EACX,WAAW,EACX,OAAO,EACP,UAAU,EACV,YAAY,EACZ,aAAa,EACb,WAAW,EACX,OAAO,EACP,wBAAwB,EACxB,0BAA0B,EAC1B,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC1D,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEhE,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC5E,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,2BAA2B,EAC3B,YAAY,GACb,MAAM,aAAa,CAAC"}

package/dist/cjs/a2a/index.js

@@ -3,10 +3,17 @@
 // A2A 模块统一导出
 // ============================================================
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.extractTextFromMessage = exports.createA2ARemoteRunner = exports.A2AClient = void 0;
+exports.mapAgentEventToA2AEvent = exports.createA2AMessage = exports.createA2AAgentCard = exports.InMemoryA2ATaskStore = exports.A2AServerHandler = exports.extractTextFromMessage = exports.createA2ARemoteRunner = exports.buildAuthHeaders = exports.A2AClient = void 0;
 var client_ts_1 = require("./client.js");
 Object.defineProperty(exports, "A2AClient", { enumerable: true, get: function () { return client_ts_1.A2AClient; } });
+Object.defineProperty(exports, "buildAuthHeaders", { enumerable: true, get: function () { return client_ts_1.buildAuthHeaders; } });
 var runner_ts_1 = require("./runner.js");
 Object.defineProperty(exports, "createA2ARemoteRunner", { enumerable: true, get: function () { return runner_ts_1.createA2ARemoteRunner; } });
 Object.defineProperty(exports, "extractTextFromMessage", { enumerable: true, get: function () { return runner_ts_1.extractTextFromMessage; } });
+var server_ts_1 = require("./server.js");
+Object.defineProperty(exports, "A2AServerHandler", { enumerable: true, get: function () { return server_ts_1.A2AServerHandler; } });
+Object.defineProperty(exports, "InMemoryA2ATaskStore", { enumerable: true, get: function () { return server_ts_1.InMemoryA2ATaskStore; } });
+Object.defineProperty(exports, "createA2AAgentCard", { enumerable: true, get: function () { return server_ts_1.createA2AAgentCard; } });
+Object.defineProperty(exports, "createA2AMessage", { enumerable: true, get: function () { return server_ts_1.createA2AMessage; } });
+Object.defineProperty(exports, "mapAgentEventToA2AEvent", { enumerable: true, get: function () { return server_ts_1.mapAgentEventToA2AEvent; } });
 //# sourceMappingURL=index.js.map

package/dist/cjs/a2a/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/a2a/index.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,aAAa;AACb,+DAA+D;;;AA4B/D,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAElB,yCAA4E;AAAnE,kHAAA,qBAAqB,OAAA;AAAE,mHAAA,sBAAsB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/a2a/index.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,aAAa;AACb,+DAA+D;;;AA4B/D,yCAA0D;AAAjD,sGAAA,SAAS,OAAA;AAAE,6GAAA,gBAAgB,OAAA;AAGpC,yCAA4E;AAAnE,kHAAA,qBAAqB,OAAA;AAAE,mHAAA,sBAAsB,OAAA;AAGtD,yCAMqB;AALnB,6GAAA,gBAAgB,OAAA;AAChB,iHAAA,oBAAoB,OAAA;AACpB,+GAAA,kBAAkB,OAAA;AAClB,6GAAA,gBAAgB,OAAA;AAChB,oHAAA,uBAAuB,OAAA"}

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

@@ -17,6 +17,17 @@ export interface A2ARemoteRunnerConfig {
     client: A2AClient;
     /** 可选的 skillId，供服务端路由到对应的 specialist profile */
     skillId?: string;
+    /** 流式失败时是否自动回退到同步模式，默认 true */
+    fallbackToSync?: boolean;
+    /** 智能事件过滤配置（控制 SSE 事件转发粒度） */
+    eventFilter?: {
+        /** thinking 累积多少字符后批量转发，默认 100 */
+        thinkingFlushThreshold?: number;
+        /** thinking 批量转发间隔（毫秒），默认 3000 */
+        thinkingFlushInterval?: number;
+        /** content 增量过滤：文本增长多少字符后才转发，默认 30 */
+        contentMinDelta?: number;
+    };
 }
 /**
  * 创建远程 A2A Agent 的 SubAgentRunner

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

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/a2a/runner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,4BAA4B;AAC5B,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM,CAMnE;AAED,gCAAgC;AAChC,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iCAAiC;IACjC,MAAM,EAAE,SAAS,CAAC;IAClB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,cAAc,CAoFnF"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/a2a/runner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,4BAA4B;AAC5B,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM,CAMnE;AAED,gCAAgC;AAChC,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iCAAiC;IACjC,MAAM,EAAE,SAAS,CAAC;IAClB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,8BAA8B;IAC9B,WAAW,CAAC,EAAE;QACZ,kCAAkC;QAClC,sBAAsB,CAAC,EAAE,MAAM,CAAC;QAChC,kCAAkC;QAClC,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,sCAAsC;QACtC,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,cAAc,CAuGnF"}

package/dist/cjs/a2a/runner.js

@@ -30,14 +30,47 @@ function extractTextFromMessage(message) {
  *   - error:    任务失败或网络异常
  */
 function createA2ARemoteRunner(config) {
-    const { agentUrl, name: runnerName, description: runnerDesc, streaming, client, skillId } = config;
+    const { agentUrl, name: runnerName, description: runnerDesc, streaming, client, skillId, fallbackToSync = true } = config;
     // 构建请求元数据，包含 skillId 供服务端路由到正确的 specialist
     const metadata = skillId ? { skillId } : undefined;
-    // ---- 流式执行（tasks/sendSubscribe + 事件转发）----
+    // 事件过滤配置
+    const filterCfg = {
+        thinkingFlushThreshold: config.eventFilter?.thinkingFlushThreshold ?? 100,
+        thinkingFlushInterval: config.eventFilter?.thinkingFlushInterval ?? 3000,
+        contentMinDelta: config.eventFilter?.contentMinDelta ?? 30,
+    };
+    // ---- 同步执行（tasks/send，无事件转发）----
+    const runSync = async (task) => {
+        try {
+            const result = await client.sendTask(agentUrl, {
+                id: crypto.randomUUID(),
+                message: {
+                    kind: 'message',
+                    role: 'user',
+                    messageId: crypto.randomUUID(),
+                    parts: [{ kind: 'text', text: task }],
+                },
+                metadata,
+            });
+            const textParts = result.status?.message?.parts
+                ?.filter((p) => p.kind === 'text')
+                .map(p => p.text) ?? [];
+            return textParts.length > 0
+                ? textParts.join('\n')
+                : `[A2A Remote Agent '${runnerName}'] Task ${result.id} completed with state: ${result.status?.state || 'unknown'}`;
+        }
+        catch (err) {
+            console.error(`[A2A] '${runnerName}' 同步执行异常: ${err?.message || err}`);
+            return `[A2A Remote Agent '${runnerName}'] Error: ${err.message || err}`;
+        }
+    };
+    // ---- 流式执行（tasks/sendSubscribe + 智能事件过滤）----
     const runStreaming = async (task, ctx) => {
         const emit = ctx.emitSubEvent;
         const parentCallId = ctx.currentToolCallId || `a2a_${Date.now()}`;
         const taskId = crypto.randomUUID();
+        // 智能事件过滤器状态
+        const filterState = createEventFilterState();
         emitStart(emit, parentCallId, runnerName, task);
         try {
             const finalEvent = await client.sendTaskStreaming(agentUrl, {
@@ -49,7 +82,9 @@ function createA2ARemoteRunner(config) {
                     parts: [{ kind: 'text', text: task }],
                 },
                 metadata,
-            }, (event) => forwardSSEEvent(emit, parentCallId, runnerName, event), ctx.abortSignal);
+            }, (event) => forwardSSEEventFiltered(emit, parentCallId, runnerName, event, filterState, filterCfg), ctx.abortSignal);
+            // 刷出 thinking 缓冲
+            flushThinking(emit, parentCallId, runnerName, filterState);
             if (finalEvent?.kind === 'status-update' && finalEvent.status?.state === 'failed') {
                 const msg = extractTextFromMessage(finalEvent.status?.message) || 'Remote agent returned error';
                 console.error(`[A2A] '${runnerName}' 远程Agent失败: ${msg}`);
@@ -63,35 +98,15 @@ function createA2ARemoteRunner(config) {
         catch (err) {
             const errMsg = err?.message || String(err);
             console.error(`[A2A] '${runnerName}' 流式执行异常: ${errMsg}`);
+            // 流式失败，自动回退到同步模式
+            if (fallbackToSync) {
+                console.log(`[A2A] '${runnerName}' 回退到同步模式`);
+                return runSync(task);
+            }
             emitError(emit, parentCallId, runnerName, errMsg);
             return `[A2A Remote Agent '${runnerName}'] Error: ${errMsg}`;
         }
     };
-    // ---- 同步执行（tasks/send，无事件转发）----
-    const runSync = async (task) => {
-        try {
-            const result = await client.sendTask(agentUrl, {
-                id: crypto.randomUUID(),
-                message: {
-                    kind: 'message',
-                    role: 'user',
-                    messageId: crypto.randomUUID(),
-                    parts: [{ kind: 'text', text: task }],
-                },
-                metadata,
-            });
-            const textParts = result.status?.message?.parts
-                ?.filter((p) => p.kind === 'text')
-                .map(p => p.text) ?? [];
-            return textParts.length > 0
-                ? textParts.join('\n')
-                : `[A2A Remote Agent '${runnerName}'] Task ${result.id} completed with state: ${result.status?.state || 'unknown'}`;
-        }
-        catch (err) {
-            console.error(`[A2A] '${runnerName}' 同步执行异常: ${err?.message || err}`);
-            return `[A2A Remote Agent '${runnerName}'] Error: ${err.message || err}`;
-        }
-    };
     return {
         name: runnerName,
         description: runnerDesc,
@@ -111,46 +126,6 @@ function emitStart(emit, parentCallId, agentName, task) {
         data: { agentName, task, source: 'a2a-streaming' },
     });
 }
-/**
- * 透传 A2A 事件为 SubAgent 事件
- *
- * A2A 服务端将 SubAgentEvent 平铺到 metadata（metadata.type 直接为事件类型），
- * 接收端直接还原为与本地 Agent 一致的平铺结构。
- */
-function forwardSSEEvent(emit, parentCallId, agentName, event) {
-    if (event.kind === 'status-update') {
-        const meta = event.metadata;
-        // 平铺 metadata：type 为实际事件类型，其余字段即为事件 data
-        if (meta?.type) {
-            const { type, ...rest } = meta;
-            emit?.({
-                parentToolCallId: parentCallId,
-                agentName,
-                eventType: type,
-                data: rest,
-            });
-            return;
-        }
-        // 普通 A2A 事件（无 type metadata）
-        const hasMessage = !!event.status?.message;
-        emit?.({
-            parentToolCallId: parentCallId,
-            agentName,
-            eventType: hasMessage ? 'content' : 'progress',
-            data: {
-                ...(hasMessage ? { content: extractTextFromMessage(event.status.message) } : {}),
-            },
-        });
-    }
-    else if (event.kind === 'artifact-update') {
-        emit?.({
-            parentToolCallId: parentCallId,
-            agentName,
-            eventType: 'artifact',
-            data: { artifactId: event.artifact?.artifactId, name: event.artifact?.name },
-        });
-    }
-}
 function emitDone(emit, parentCallId, agentName, contentLength) {
     emit?.({
         parentToolCallId: parentCallId,
@@ -167,4 +142,118 @@ function emitError(emit, parentCallId, agentName, error) {
         data: { error },
     });
 }
+function createEventFilterState() {
+    return { lastTextLen: -1, thinkingBuf: '', lastThinkingEmit: 0, forwarded: 0, skipped: 0 };
+}
+/** 刷出累积的 thinking 内容为一个事件 */
+function flushThinking(emit, parentCallId, agentName, state) {
+    if (!state.thinkingBuf)
+        return;
+    emit?.({
+        parentToolCallId: parentCallId,
+        agentName,
+        eventType: 'thinking',
+        data: { content: state.thinkingBuf },
+    });
+    state.thinkingBuf = '';
+    state.lastThinkingEmit = Date.now();
+    state.forwarded++;
+}
+/**
+ * 智能事件过滤转发
+ *
+ * 将远程 Agent 的 SSE 事件精简为有意义的 UI 事件：
+ * - thinking：累积后批量转发（达到字符阈值或时间间隔）
+ * - content：仅在文本增长 ≥ contentMinDelta 字符时转发
+ * - tool_call / tool_result / start / done / error：始终转发
+ * - artifact：始终转发
+ * - heartbeat / 空事件：丢弃
+ *
+ * A2A 服务端将 SubAgentEvent 平铺到 metadata（metadata.type 直接为事件类型），
+ * 接收端直接还原为与本地 Agent 一致的平铺结构。
+ */
+function forwardSSEEventFiltered(emit, parentCallId, agentName, event, state, cfg) {
+    // artifact-update 始终转发
+    if (event.kind === 'artifact-update') {
+        emit?.({
+            parentToolCallId: parentCallId,
+            agentName,
+            eventType: 'artifact',
+            data: { artifactId: event.artifact?.artifactId, name: event.artifact?.name },
+        });
+        state.forwarded++;
+        return;
+    }
+    if (event.kind !== 'status-update')
+        return;
+    const eventState = event.status?.state;
+    const messageText = extractTextFromMessage(event.status?.message);
+    const meta = event.metadata;
+    // 终态：completed / failed — 始终转发，并刷出 thinking 缓冲
+    if (eventState === 'completed' || eventState === 'failed') {
+        flushThinking(emit, parentCallId, agentName, state);
+        return; // done/error 由 runStreaming 的 finalEvent 处理
+    }
+    // 非 working 状态丢弃
+    if (eventState !== 'working') {
+        state.skipped++;
+        return;
+    }
+    // 解包 metadata：type 为实际事件类型
+    const metaType = meta?.type;
+    let eventData = {};
+    let effectiveText = messageText;
+    if (metaType) {
+        const { type: _t, ...rest } = meta;
+        eventData = rest;
+        if (metaType === 'content' && rest.content) {
+            effectiveText = rest.content;
+        }
+    }
+    // 1. 始终转发：start / done / error / tool_call / tool_result
+    if (metaType === 'start' || metaType === 'done' || metaType === 'error'
+        || metaType === 'tool_call' || metaType === 'tool_result') {
+        if (metaType === 'tool_call')
+            flushThinking(emit, parentCallId, agentName, state);
+        emit?.({
+            parentToolCallId: parentCallId,
+            agentName,
+            eventType: metaType,
+            data: eventData,
+        });
+        state.forwarded++;
+        return;
+    }
+    // 2. Thinking：累积后批量转发
+    if (metaType === 'thinking') {
+        state.thinkingBuf += (eventData.content || '');
+        const now = Date.now();
+        if (state.thinkingBuf.length >= cfg.thinkingFlushThreshold
+            || (state.thinkingBuf.length > 0 && now - state.lastThinkingEmit >= cfg.thinkingFlushInterval)) {
+            flushThinking(emit, parentCallId, agentName, state);
+        }
+        state.skipped++;
+        return;
+    }
+    // 3. Content：累积式文本更新，仅在显著增长时转发
+    if (metaType === 'content' || (!metaType && messageText)) {
+        const textLen = (effectiveText || '').length;
+        if (textLen > 0 && (state.lastTextLen < 0 || textLen - state.lastTextLen >= cfg.contentMinDelta)) {
+            emit?.({
+                parentToolCallId: parentCallId,
+                agentName,
+                eventType: 'content',
+                data: { content: effectiveText },
+            });
+            state.lastTextLen = textLen;
+            state.forwarded++;
+        }
+        else {
+            state.skipped++;
+        }
+        return;
+    }
+    // 4. 其余事件（heartbeat / 纯时间戳更新 / 未知类型）→ 丢弃
+    state.skipped++;
+}
 //# sourceMappingURL=runner.js.map