@cicctencent/agent-core 0.1.20 → 0.1.22

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

@@ -5,4 +5,8 @@ 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';
+export { RestA2AClient } from './rest-client.js';
+export type { RestCapabilityCard, RestCapabilityResult, RestSSEEvent, RestTaskStatus, RestA2AClientOptions, } from './rest-client.js';
+export { createRestA2ARemoteRunner } from './rest-runner.js';
+export type { RestA2ARemoteRunnerConfig } from './rest-runner.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,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"}
+{"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;AAGrB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/cjs/a2a/index.js

@@ -3,7 +3,7 @@
 // A2A 模块统一导出
 // ============================================================
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mapAgentEventToA2AEvent = exports.createA2AMessage = exports.createA2AAgentCard = exports.InMemoryA2ATaskStore = exports.A2AServerHandler = exports.extractTextFromMessage = exports.createA2ARemoteRunner = exports.buildAuthHeaders = exports.A2AClient = void 0;
+exports.createRestA2ARemoteRunner = exports.RestA2AClient = 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; } });
@@ -16,4 +16,9 @@ Object.defineProperty(exports, "InMemoryA2ATaskStore", { enumerable: true, get:
 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; } });
+// ---- REST 风格 A2A ----
+var rest_client_ts_1 = require("./rest-client.js");
+Object.defineProperty(exports, "RestA2AClient", { enumerable: true, get: function () { return rest_client_ts_1.RestA2AClient; } });
+var rest_runner_ts_1 = require("./rest-runner.js");
+Object.defineProperty(exports, "createRestA2ARemoteRunner", { enumerable: true, get: function () { return rest_runner_ts_1.createRestA2ARemoteRunner; } });
 //# 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,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"}
+{"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;AAUzB,wBAAwB;AACxB,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AAQtB,mDAA6D;AAApD,2HAAA,yBAAyB,OAAA"}

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

@@ -0,0 +1,111 @@
+import { type AuthConfig } from './client.js';
+/** REST 风格 A2A Capability Card */
+export interface RestCapabilityCard {
+    capability_id: string;
+    capability_name?: string;
+    description?: string;
+    input_schema?: Record<string, unknown>;
+    output_schema?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/** REST 风格 A2A 能力执行结果 */
+export interface RestCapabilityResult {
+    capability_id: string;
+    capability_name?: string;
+    status: string;
+    result?: {
+        summary?: string;
+        strengths?: string[];
+        weaknesses?: string[];
+        risks?: string[];
+        analysis_findings?: string[];
+        final_text?: string;
+        [key: string]: unknown;
+    };
+    task_id?: string;
+    error?: string;
+    [key: string]: unknown;
+}
+/** REST 风格 A2A SSE 事件 */
+export interface RestSSEEvent {
+    /** 事件类型：status / stage / tool_call / tool_result / message_chunk / result / error */
+    event: string;
+    /** 事件数据（已解析的 JSON 对象） */
+    data: Record<string, unknown>;
+}
+/** REST 风格 A2A 异步任务状态 */
+export interface RestTaskStatus {
+    task_id: string;
+    capability_id?: string;
+    capability_name?: string;
+    status: string;
+    caller_agent_id?: string;
+    created_at?: string;
+    updated_at?: string;
+    error_code?: string | null;
+    result?: RestCapabilityResult['result'];
+    [key: string]: unknown;
+}
+export interface RestA2AClientOptions {
+    /** 请求超时（毫秒），默认 300000（5分钟） */
+    timeout?: number;
+    /** SSE 连接超时（毫秒），默认 30000（30秒） */
+    connectTimeout?: number;
+    /** SSE 逐 chunk 读取超时（毫秒），默认 60000 */
+    chunkTimeout?: number;
+    /** 自定义 fetch 实现（默认使用 globalThis.fetch） */
+    fetch?: typeof fetch;
+    /** 自定义请求头 */
+    headers?: Record<string, string>;
+    /** 认证配置 */
+    auth?: AuthConfig;
+}
+/**
+ * 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 declare class RestA2AClient {
+    private timeout;
+    private connectTimeout;
+    private chunkTimeout;
+    private fetchFn;
+    private headers;
+    constructor(options?: RestA2AClientOptions);
+    /** 获取 Capability Card：GET /capabilities/{capabilityId}，失败时尝试 :stream 探测 */
+    discoverCapability(baseUrl: string, capabilityId: string): Promise<RestCapabilityCard>;
+    /** 同步调用：POST /api/v1/a2a/capabilities/{capabilityId}:invoke */
+    invoke(baseUrl: string, capabilityId: string, input: Record<string, unknown>): Promise<RestCapabilityResult>;
+    /**
+     * 流式调用：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）
+     */
+    invokeStreaming(baseUrl: string, capabilityId: string, input: Record<string, unknown>, onEvent?: (event: RestSSEEvent) => void, abortSignal?: AbortSignal): Promise<RestCapabilityResult | null>;
+    /** 异步提交：POST /api/v1/a2a/capabilities/{capabilityId}:submit */
+    submit(baseUrl: string, capabilityId: string, input: Record<string, unknown>): Promise<{
+        task_id: string;
+        [key: string]: unknown;
+    }>;
+    /** 查询任务状态：GET /api/v1/a2a/tasks/{taskId} */
+    getTask(baseUrl: string, taskId: string): Promise<RestTaskStatus>;
+    /** 构建 Capability URL */
+    private buildCapabilityUrl;
+    /** 带 chunkTimeout 的 reader.read() */
+    private readChunkWithTimeout;
+    /** 带超时的 fetch */
+    private fetchWithTimeout;
+}
+//# sourceMappingURL=rest-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rest-client.d.ts","sourceRoot":"","sources":["../../../src/a2a/rest-client.ts"],"names":[],"mappings":"AAYA,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAIhE,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,yBAAyB;AACzB,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,yBAAyB;AACzB,MAAM,WAAW,YAAY;IAC3B,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,yBAAyB;AACzB,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAID,MAAM,WAAW,oBAAoB;IACnC,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,aAAa;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,WAAW;IACX,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAID;;;;;;;GAOG;AACH,qBAAa,aAAa;IACxB,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,oBAAyB;IAU9C,2EAA2E;IACrE,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAuE5F,+DAA+D;IACzD,MAAM,CACV,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,oBAAoB,CAAC;IAiBhC;;;;;;;;;;;;;OAaG;IACG,eAAe,CACnB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,EACvC,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAsGvC,+DAA+D;IACzD,MAAM,CACV,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAavD,4CAA4C;IACtC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAYvE,wBAAwB;IACxB,OAAO,CAAC,kBAAkB;IAc1B,qCAAqC;YACvB,oBAAoB;IAgBlC,iBAAiB;YACH,gBAAgB;CAyB/B"}

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

@@ -0,0 +1,342 @@
+"use strict";
+// ============================================================
+// 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 请求头
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RestA2AClient = void 0;
+const client_ts_1 = require("./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', { ... });
+ */
+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 = { ...(0, client_ts_1.buildAuthHeaders)(options.auth), ...(options.headers ?? {}) };
+    }
+    // ---- Capability 发现 ----
+    /** 获取 Capability Card：GET /capabilities/{capabilityId}，失败时尝试 :stream 探测 */
+    async discoverCapability(baseUrl, capabilityId) {
+        const url = this.buildCapabilityUrl(baseUrl, capabilityId);
+        console.log(`[REST-A2A] discoverCapability -> GET ${url}`);
+        try {
+            const res = await this.fetchWithTimeout(url, { method: 'GET' });
+            const contentType = res.headers.get('content-type') || '';
+            console.log(`[REST-A2A] discoverCapability response: HTTP ${res.status}, content-type: ${contentType}`);
+            if (res.ok && contentType.includes('application/json')) {
+                return (await res.json());
+            }
+            const bodyText = await res.text().catch(() => '');
+            console.warn(`[REST-A2A] discoverCapability GET not JSON: HTTP ${res.status}, content-type: ${contentType}, body: ${bodyText.slice(0, 200)}`);
+        }
+        catch (err) {
+            console.warn(`[REST-A2A] discoverCapability GET error: ${err?.message}`);
+        }
+        // GET 失败，尝试 POST :stream 发送空请求，读取第一个 SSE data 行提取 capability 信息
+        console.log(`[REST-A2A] discoverCapability fallback -> POST :stream (read first event only)`);
+        try {
+            const streamUrl = this.buildCapabilityUrl(baseUrl, capabilityId, 'stream');
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), 10_000);
+            const res = await this.fetchFn(streamUrl, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json', ...this.headers },
+                body: JSON.stringify({}),
+                signal: controller.signal,
+            });
+            console.log(`[REST-A2A] discoverCapability stream response: HTTP ${res.status}, content-type: ${res.headers.get('content-type') || ''}`);
+            if (res.ok && res.body) {
+                const reader = res.body.getReader();
+                const decoder = new TextDecoder();
+                let buffer = '';
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done)
+                        break;
+                    buffer += decoder.decode(value, { stream: true });
+                    // 尝试从已收到的数据中解析第一个 data: 行
+                    const dataMatch = buffer.match(/data:\s*(\{.+\})/);
+                    if (dataMatch) {
+                        reader.cancel().catch(() => { });
+                        clearTimeout(timer);
+                        const parsed = JSON.parse(dataMatch[1]);
+                        console.log(`[REST-A2A] discoverCapability stream first event: ${JSON.stringify(parsed).slice(0, 300)}`);
+                        return {
+                            capability_id: String(parsed.capability_id || capabilityId),
+                            capability_name: String(parsed.capability_name || ''),
+                            description: String(parsed.description || parsed.result?.summary || ''),
+                            ...parsed,
+                        };
+                    }
+                    // 如果积累太多数据还没找到 data 行，放弃
+                    if (buffer.length > 10000)
+                        break;
+                }
+                reader.cancel().catch(() => { });
+                clearTimeout(timer);
+                console.warn(`[REST-A2A] discoverCapability stream: no data event found in stream`);
+            }
+            else {
+                const bodyText = await res.text().catch(() => '');
+                console.warn(`[REST-A2A] discoverCapability stream fallback failed: HTTP ${res.status}, body: ${bodyText.slice(0, 200)}`);
+            }
+        }
+        catch (err) {
+            console.warn(`[REST-A2A] discoverCapability stream fallback error: ${err?.message}`);
+        }
+        // 所有方式都失败，返回最小化 card
+        return { capability_id: capabilityId, capability_name: capabilityId };
+    }
+    // ---- 同步调用 ----
+    /** 同步调用：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.trim().replace(/\/+$/, '');
+        // 如果 baseUrl 已包含 /capabilities/ 路径，保留原始路径前缀，仅替换 capabilityId 和 action
+        const capMatch = trimmed.match(/^(.+?\/capabilities\/)[^:/]+(?::\w+)?\/?$/);
+        if (capMatch) {
+            const prefix = capMatch[1];
+            const base = `${prefix}${capabilityId}`;
+            return action ? `${base}:${action}` : base;
+        }
+        // 标准拼接
+        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 });
+        }
+        catch (err) {
+            const msg = err?.message || String(err);
+            // 提供更友好的错误信息
+            if (err?.name === 'AbortError') {
+                throw new Error(`REST A2A request timeout after ${this.timeout}ms: ${url}`);
+            }
+            if (err?.cause?.code === 'ECONNREFUSED') {
+                throw new Error(`REST A2A connection refused: ${url} (is the server running?)`);
+            }
+            if (err?.cause?.code === 'ENOTFOUND' || msg.includes('getaddrinfo')) {
+                throw new Error(`REST A2A DNS resolution failed: ${url}`);
+            }
+            if (err?.cause?.code === 'ECONNRESET') {
+                throw new Error(`REST A2A connection reset: ${url}`);
+            }
+            throw new Error(`REST A2A fetch failed: ${url} — ${msg} (cause: ${err?.cause?.code || err?.cause?.message || 'unknown'})`);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+exports.RestA2AClient = RestA2AClient;
+//# sourceMappingURL=rest-client.js.map

package/dist/cjs/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/cjs/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/cjs/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"}