@cicctencent/agent-core 0.1.14 → 0.1.16
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cjs/a2a/client.d.ts +32 -2
- package/dist/cjs/a2a/client.d.ts.map +1 -1
- package/dist/cjs/a2a/client.js +59 -10
- package/dist/cjs/a2a/client.js.map +1 -1
- package/dist/cjs/a2a/index.d.ts +2 -1
- package/dist/cjs/a2a/index.d.ts.map +1 -1
- package/dist/cjs/a2a/index.js +2 -1
- package/dist/cjs/a2a/index.js.map +1 -1
- package/dist/cjs/a2a/runner.d.ts +11 -0
- package/dist/cjs/a2a/runner.d.ts.map +1 -1
- package/dist/cjs/a2a/runner.js +157 -53
- package/dist/cjs/a2a/runner.js.map +1 -1
- package/dist/cjs/agent/history-manager.d.ts +8 -2
- package/dist/cjs/agent/history-manager.d.ts.map +1 -1
- package/dist/cjs/agent/history-manager.js +6 -6
- package/dist/cjs/agent/history-manager.js.map +1 -1
- package/dist/cjs/agent/types.d.ts +17 -0
- package/dist/cjs/agent/types.d.ts.map +1 -1
- package/dist/cjs/agent/types.js +43 -0
- package/dist/cjs/agent/types.js.map +1 -1
- package/dist/cjs/index.d.ts +7 -5
- package/dist/cjs/index.d.ts.map +1 -1
- package/dist/cjs/index.js +11 -6
- package/dist/cjs/index.js.map +1 -1
- package/dist/cjs/memory/types.d.ts +48 -0
- package/dist/cjs/memory/types.d.ts.map +1 -1
- package/dist/cjs/memory/types.js +52 -0
- package/dist/cjs/memory/types.js.map +1 -1
- package/dist/cjs/security/guard.d.ts +11 -0
- package/dist/cjs/security/guard.d.ts.map +1 -1
- package/dist/cjs/security/guard.js +46 -0
- package/dist/cjs/security/guard.js.map +1 -1
- package/dist/cjs/tool/registry.d.ts +51 -1
- package/dist/cjs/tool/registry.d.ts.map +1 -1
- package/dist/cjs/tool/registry.js +28 -0
- package/dist/cjs/tool/registry.js.map +1 -1
- package/dist/esm/a2a/client.d.ts +32 -2
- package/dist/esm/a2a/client.d.ts.map +1 -1
- package/dist/esm/a2a/client.js +58 -10
- package/dist/esm/a2a/client.js.map +1 -1
- package/dist/esm/a2a/index.d.ts +2 -1
- package/dist/esm/a2a/index.d.ts.map +1 -1
- package/dist/esm/a2a/index.js +1 -1
- package/dist/esm/a2a/index.js.map +1 -1
- package/dist/esm/a2a/runner.d.ts +11 -0
- package/dist/esm/a2a/runner.d.ts.map +1 -1
- package/dist/esm/a2a/runner.js +157 -53
- package/dist/esm/a2a/runner.js.map +1 -1
- package/dist/esm/agent/history-manager.d.ts +8 -2
- package/dist/esm/agent/history-manager.d.ts.map +1 -1
- package/dist/esm/agent/history-manager.js +6 -6
- package/dist/esm/agent/history-manager.js.map +1 -1
- package/dist/esm/agent/types.d.ts +17 -0
- package/dist/esm/agent/types.d.ts.map +1 -1
- package/dist/esm/agent/types.js +42 -1
- package/dist/esm/agent/types.js.map +1 -1
- package/dist/esm/index.d.ts +7 -5
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js +3 -1
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/memory/types.d.ts +48 -0
- package/dist/esm/memory/types.d.ts.map +1 -1
- package/dist/esm/memory/types.js +50 -1
- package/dist/esm/memory/types.js.map +1 -1
- package/dist/esm/security/guard.d.ts +11 -0
- package/dist/esm/security/guard.d.ts.map +1 -1
- package/dist/esm/security/guard.js +46 -0
- package/dist/esm/security/guard.js.map +1 -1
- package/dist/esm/tool/registry.d.ts +51 -1
- package/dist/esm/tool/registry.d.ts.map +1 -1
- package/dist/esm/tool/registry.js +28 -0
- package/dist/esm/tool/registry.js.map +1 -1
- package/package.json +1 -1
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { ToolDefinition, ToolExecutor, ToolContext, RegisteredTool, ToolCategory } from './types.js';
|
|
2
|
-
/** defineTool
|
|
2
|
+
/** defineTool 简化参数(OpenAI Function Calling 格式) */
|
|
3
3
|
export interface DefineToolOptions {
|
|
4
4
|
name: string;
|
|
5
5
|
description: string;
|
|
@@ -7,6 +7,44 @@ export interface DefineToolOptions {
|
|
|
7
7
|
executor: ToolExecutor;
|
|
8
8
|
category?: ToolCategory;
|
|
9
9
|
concurrent?: boolean;
|
|
10
|
+
metadata?: Record<string, unknown>;
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* defineFlatTool 简化参数(扁平格式,兼容 BI 项目风格)
|
|
14
|
+
*
|
|
15
|
+
* 扁平格式更直观:直接声明 id / name / description / parameters / execute,
|
|
16
|
+
* 内部自动转换为 OpenAI Function Calling 格式。
|
|
17
|
+
*
|
|
18
|
+
* @example
|
|
19
|
+
* registry.defineFlatTool({
|
|
20
|
+
* id: 'web_search',
|
|
21
|
+
* name: '网络搜索',
|
|
22
|
+
* description: 'Search the web for information',
|
|
23
|
+
* parameters: {
|
|
24
|
+
* type: 'object',
|
|
25
|
+
* properties: { query: { type: 'string', description: '...' } },
|
|
26
|
+
* required: ['query'],
|
|
27
|
+
* },
|
|
28
|
+
* execute: async (input, ctx) => { ... },
|
|
29
|
+
* });
|
|
30
|
+
*/
|
|
31
|
+
export interface FlatToolOptions {
|
|
32
|
+
/** 工具唯一标识(将作为 OpenAI function name) */
|
|
33
|
+
id: string;
|
|
34
|
+
/** 工具显示名(仅用于展示,不影响 LLM 调用) */
|
|
35
|
+
name?: string;
|
|
36
|
+
/** 工具描述(给 LLM 理解用途) */
|
|
37
|
+
description: string;
|
|
38
|
+
/** 参数 Schema(JSON Schema 子集) */
|
|
39
|
+
parameters: ToolDefinition['function']['parameters'];
|
|
40
|
+
/** 执行函数 */
|
|
41
|
+
execute: ToolExecutor;
|
|
42
|
+
/** 工具分类 */
|
|
43
|
+
category?: ToolCategory;
|
|
44
|
+
/** 是否支持并行执行 */
|
|
45
|
+
concurrent?: boolean;
|
|
46
|
+
/** 扩展元数据 */
|
|
47
|
+
metadata?: Record<string, unknown>;
|
|
10
48
|
}
|
|
11
49
|
export declare class ToolRegistry {
|
|
12
50
|
private tools;
|
|
@@ -28,6 +66,18 @@ export declare class ToolRegistry {
|
|
|
28
66
|
* });
|
|
29
67
|
*/
|
|
30
68
|
defineTool(options: DefineToolOptions): void;
|
|
69
|
+
/**
|
|
70
|
+
* 扁平格式注册(兼容 BI 项目风格,内部自动转换为 OpenAI Function Calling 格式)
|
|
71
|
+
*
|
|
72
|
+
* @example
|
|
73
|
+
* registry.defineFlatTool({
|
|
74
|
+
* id: 'search_data_sources',
|
|
75
|
+
* description: '搜索候选数据源',
|
|
76
|
+
* parameters: { type: 'object', properties: { query: { type: 'string', description: '...' } } },
|
|
77
|
+
* execute: async (args, ctx) => { ... },
|
|
78
|
+
* });
|
|
79
|
+
*/
|
|
80
|
+
defineFlatTool(options: FlatToolOptions): void;
|
|
31
81
|
/** 批量注册 */
|
|
32
82
|
registerAll(tools: RegisteredTool[]): void;
|
|
33
83
|
/** 注销工具 */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/tool/registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1G,
|
|
1
|
+
{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/tool/registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1G,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC;IACrD,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,UAAU,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC;IACrD,WAAW;IACX,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW;IACX,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,eAAe;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAqC;IAElD,WAAW;IACX,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAKpC;;;;;;;;;;;;;;OAcG;IACH,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAiB5C;;;;;;;;;;OAUG;IACH,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAiB9C,WAAW;IACX,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,IAAI;IAM1C,WAAW;IACX,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9B,aAAa;IACb,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI7C,uBAAuB;IACvB,cAAc,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,YAAY,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,cAAc,EAAE;IAcxF,gCAAgC;IAC1B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAM7F,kBAAkB;IAClB,SAAS,IAAI,MAAM,EAAE;IAIrB,eAAe;IACf,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAG3B"}
|
|
@@ -39,6 +39,34 @@ class ToolRegistry {
|
|
|
39
39
|
executor: options.executor,
|
|
40
40
|
category: options.category ?? 'custom',
|
|
41
41
|
concurrent: options.concurrent,
|
|
42
|
+
metadata: options.metadata,
|
|
43
|
+
});
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* 扁平格式注册(兼容 BI 项目风格,内部自动转换为 OpenAI Function Calling 格式)
|
|
47
|
+
*
|
|
48
|
+
* @example
|
|
49
|
+
* registry.defineFlatTool({
|
|
50
|
+
* id: 'search_data_sources',
|
|
51
|
+
* description: '搜索候选数据源',
|
|
52
|
+
* parameters: { type: 'object', properties: { query: { type: 'string', description: '...' } } },
|
|
53
|
+
* execute: async (args, ctx) => { ... },
|
|
54
|
+
* });
|
|
55
|
+
*/
|
|
56
|
+
defineFlatTool(options) {
|
|
57
|
+
this.register({
|
|
58
|
+
definition: {
|
|
59
|
+
type: 'function',
|
|
60
|
+
function: {
|
|
61
|
+
name: options.id,
|
|
62
|
+
description: options.description,
|
|
63
|
+
parameters: options.parameters,
|
|
64
|
+
},
|
|
65
|
+
},
|
|
66
|
+
executor: options.execute,
|
|
67
|
+
category: options.category ?? 'custom',
|
|
68
|
+
concurrent: options.concurrent,
|
|
69
|
+
metadata: { ...options.metadata, ...(options.name ? { displayName: options.name } : {}) },
|
|
42
70
|
});
|
|
43
71
|
}
|
|
44
72
|
/** 批量注册 */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/tool/registry.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,yBAAyB;AACzB,+DAA+D;;;
|
|
1
|
+
{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/tool/registry.ts"],"names":[],"mappings":"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"}
|
package/dist/esm/a2a/client.d.ts
CHANGED
|
@@ -1,12 +1,33 @@
|
|
|
1
1
|
import type { A2AAgentCard, A2ASendTaskParams, A2ATask, A2ATaskEvent } from './types.js';
|
|
2
|
+
/**
|
|
3
|
+
* 认证配置(统一 bearer / basic / apiKey / custom 四种方式)
|
|
4
|
+
*
|
|
5
|
+
* value 支持 `${env.VAR_NAME}` 模板,运行时从环境变量读取敏感凭证。
|
|
6
|
+
*/
|
|
7
|
+
export interface AuthConfig {
|
|
8
|
+
/** 认证方式 */
|
|
9
|
+
type: 'bearer' | 'basic' | 'apiKey' | 'custom';
|
|
10
|
+
/** 认证凭证值(支持 `${env.VAR_NAME}` 模板语法) */
|
|
11
|
+
value: string;
|
|
12
|
+
/** apiKey/custom 模式下的 header 名称(如 X-API-Key) */
|
|
13
|
+
name?: string;
|
|
14
|
+
}
|
|
15
|
+
/** 将 AuthConfig 转为 HTTP 请求头 */
|
|
16
|
+
export declare function buildAuthHeaders(auth?: AuthConfig | null): Record<string, string>;
|
|
2
17
|
/** A2A 客户端配置 */
|
|
3
18
|
export interface A2AClientOptions {
|
|
4
19
|
/** 请求超时(毫秒),默认 300000(5分钟) */
|
|
5
20
|
timeout?: number;
|
|
21
|
+
/** SSE 连接超时(毫秒),默认 30000(30秒) */
|
|
22
|
+
connectTimeout?: number;
|
|
23
|
+
/** SSE 逐 chunk 读取超时(毫秒),默认 60000(60秒无数据视为流中断) */
|
|
24
|
+
chunkTimeout?: number;
|
|
6
25
|
/** 自定义 fetch 实现(默认使用 globalThis.fetch) */
|
|
7
26
|
fetch?: typeof fetch;
|
|
8
27
|
/** 自定义请求头(如认证 token) */
|
|
9
28
|
headers?: Record<string, string>;
|
|
29
|
+
/** 认证配置(自动转为 headers,与 headers 合并) */
|
|
30
|
+
auth?: AuthConfig;
|
|
10
31
|
}
|
|
11
32
|
/**
|
|
12
33
|
* 轻量 A2A 协议客户端
|
|
@@ -18,6 +39,8 @@ export interface A2AClientOptions {
|
|
|
18
39
|
*/
|
|
19
40
|
export declare class A2AClient {
|
|
20
41
|
private timeout;
|
|
42
|
+
private connectTimeout;
|
|
43
|
+
private chunkTimeout;
|
|
21
44
|
private fetchFn;
|
|
22
45
|
private headers;
|
|
23
46
|
constructor(options?: A2AClientOptions);
|
|
@@ -31,6 +54,13 @@ export declare class A2AClient {
|
|
|
31
54
|
/**
|
|
32
55
|
* 流式发送任务(tasks/sendSubscribe),通过回调逐步接收事件
|
|
33
56
|
* 返回最后一个 status-update 事件(通常为 final 事件),用于提取最终结果
|
|
57
|
+
*
|
|
58
|
+
* 增强特性:
|
|
59
|
+
* - connectTimeout: SSE 连接超时(默认 30s)
|
|
60
|
+
* - chunkTimeout: 逐 chunk 读取超时(默认 60s 无数据视为流中断)
|
|
61
|
+
* - 外部 AbortSignal 联动(前端断开时中止连接和读取)
|
|
62
|
+
* - 流异常时保留已接收事件(优雅降级)
|
|
63
|
+
*
|
|
34
64
|
* @param abortSignal 外部中止信号(前端断开时中止 SSE 读取)
|
|
35
65
|
*/
|
|
36
66
|
sendTaskStreaming(agentUrl: string, params: A2ASendTaskParams, onEvent?: (event: A2ATaskEvent) => void, abortSignal?: AbortSignal): Promise<A2ATaskEvent | null>;
|
|
@@ -42,8 +72,8 @@ export declare class A2AClient {
|
|
|
42
72
|
private resolveAgentCardUrl;
|
|
43
73
|
/** 发送 JSON-RPC 请求 */
|
|
44
74
|
private jsonRpcCall;
|
|
45
|
-
/**
|
|
46
|
-
private
|
|
75
|
+
/** 带 chunkTimeout 的 reader.read()(每次读取单独计时,收到数据即重置) */
|
|
76
|
+
private readChunkWithTimeout;
|
|
47
77
|
/** 带超时的 fetch */
|
|
48
78
|
private fetchWithTimeout;
|
|
49
79
|
}
|
|
@@ -1 +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;
|
|
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;;;;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/esm/a2a/client.js
CHANGED
|
@@ -7,6 +7,19 @@ let rpcIdCounter = 0;
|
|
|
7
7
|
function nextRpcId() {
|
|
8
8
|
return `a2a_${++rpcIdCounter}_${Date.now()}`;
|
|
9
9
|
}
|
|
10
|
+
/** 将 AuthConfig 转为 HTTP 请求头 */
|
|
11
|
+
export function buildAuthHeaders(auth) {
|
|
12
|
+
if (!auth?.value)
|
|
13
|
+
return {};
|
|
14
|
+
const val = auth.value.replace(/\$\{env\.(\w+)\}/g, (_, name) => process.env[name] || '');
|
|
15
|
+
switch (auth.type) {
|
|
16
|
+
case 'bearer': return { 'Authorization': `Bearer ${val}` };
|
|
17
|
+
case 'basic': return { 'Authorization': `Basic ${val}` };
|
|
18
|
+
case 'apiKey': return { [auth.name || 'X-API-Key']: val };
|
|
19
|
+
case 'custom': return { [auth.name || 'X-Custom-Auth']: val };
|
|
20
|
+
default: return {};
|
|
21
|
+
}
|
|
22
|
+
}
|
|
10
23
|
/**
|
|
11
24
|
* 轻量 A2A 协议客户端
|
|
12
25
|
*
|
|
@@ -17,12 +30,16 @@ function nextRpcId() {
|
|
|
17
30
|
*/
|
|
18
31
|
export class A2AClient {
|
|
19
32
|
timeout;
|
|
33
|
+
connectTimeout;
|
|
34
|
+
chunkTimeout;
|
|
20
35
|
fetchFn;
|
|
21
36
|
headers;
|
|
22
37
|
constructor(options = {}) {
|
|
23
38
|
this.timeout = options.timeout ?? 300_000;
|
|
39
|
+
this.connectTimeout = options.connectTimeout ?? 30_000;
|
|
40
|
+
this.chunkTimeout = options.chunkTimeout ?? 60_000;
|
|
24
41
|
this.fetchFn = options.fetch ?? globalThis.fetch.bind(globalThis);
|
|
25
|
-
this.headers = options.headers ?? {};
|
|
42
|
+
this.headers = { ...buildAuthHeaders(options.auth), ...(options.headers ?? {}) };
|
|
26
43
|
}
|
|
27
44
|
// ---- Agent 发现 ----
|
|
28
45
|
/**
|
|
@@ -53,6 +70,13 @@ export class A2AClient {
|
|
|
53
70
|
/**
|
|
54
71
|
* 流式发送任务(tasks/sendSubscribe),通过回调逐步接收事件
|
|
55
72
|
* 返回最后一个 status-update 事件(通常为 final 事件),用于提取最终结果
|
|
73
|
+
*
|
|
74
|
+
* 增强特性:
|
|
75
|
+
* - connectTimeout: SSE 连接超时(默认 30s)
|
|
76
|
+
* - chunkTimeout: 逐 chunk 读取超时(默认 60s 无数据视为流中断)
|
|
77
|
+
* - 外部 AbortSignal 联动(前端断开时中止连接和读取)
|
|
78
|
+
* - 流异常时保留已接收事件(优雅降级)
|
|
79
|
+
*
|
|
56
80
|
* @param abortSignal 外部中止信号(前端断开时中止 SSE 读取)
|
|
57
81
|
*/
|
|
58
82
|
async sendTaskStreaming(agentUrl, params, onEvent, abortSignal) {
|
|
@@ -62,20 +86,36 @@ export class A2AClient {
|
|
|
62
86
|
method: 'tasks/sendSubscribe',
|
|
63
87
|
params: params,
|
|
64
88
|
};
|
|
65
|
-
//
|
|
89
|
+
// 连接阶段:使用独立 AbortController + connectTimeout + 外部 signal 联动
|
|
90
|
+
const connectAbort = new AbortController();
|
|
91
|
+
const connectTimer = setTimeout(() => connectAbort.abort(), this.connectTimeout);
|
|
92
|
+
if (abortSignal) {
|
|
93
|
+
if (abortSignal.aborted) {
|
|
94
|
+
connectAbort.abort();
|
|
95
|
+
}
|
|
96
|
+
else {
|
|
97
|
+
abortSignal.addEventListener('abort', () => connectAbort.abort(), { once: true });
|
|
98
|
+
}
|
|
99
|
+
}
|
|
66
100
|
let res;
|
|
67
101
|
try {
|
|
68
102
|
res = await this.fetchFn(agentUrl, {
|
|
69
103
|
method: 'POST',
|
|
70
104
|
headers: { 'Content-Type': 'application/json', ...this.headers },
|
|
71
105
|
body: JSON.stringify(request),
|
|
72
|
-
signal:
|
|
106
|
+
signal: connectAbort.signal,
|
|
73
107
|
});
|
|
74
108
|
}
|
|
75
109
|
catch (fetchErr) {
|
|
76
110
|
if (abortSignal?.aborted)
|
|
77
111
|
return null;
|
|
78
|
-
|
|
112
|
+
if (fetchErr?.name === 'AbortError') {
|
|
113
|
+
throw new Error(`A2A streaming connect timeout (${this.connectTimeout}ms) → ${agentUrl}`);
|
|
114
|
+
}
|
|
115
|
+
throw new Error(`A2A streaming connect error → ${agentUrl}: ${fetchErr?.message || fetchErr}`);
|
|
116
|
+
}
|
|
117
|
+
finally {
|
|
118
|
+
clearTimeout(connectTimer);
|
|
79
119
|
}
|
|
80
120
|
if (!res.ok) {
|
|
81
121
|
let bodyText = '';
|
|
@@ -98,7 +138,7 @@ export class A2AClient {
|
|
|
98
138
|
while (true) {
|
|
99
139
|
if (abortSignal?.aborted)
|
|
100
140
|
break;
|
|
101
|
-
const { done, value } = await this.
|
|
141
|
+
const { done, value } = await this.readChunkWithTimeout(reader);
|
|
102
142
|
if (done)
|
|
103
143
|
break;
|
|
104
144
|
buffer += decoder.decode(value, { stream: true });
|
|
@@ -124,12 +164,20 @@ export class A2AClient {
|
|
|
124
164
|
}
|
|
125
165
|
}
|
|
126
166
|
catch (streamErr) {
|
|
167
|
+
// 流异常时保留已接收事件(优雅降级)
|
|
127
168
|
if (abortSignal?.aborted)
|
|
128
169
|
return lastStatusUpdate;
|
|
170
|
+
if (lastStatusUpdate) {
|
|
171
|
+
console.warn(`[A2A-Client] SSE stream error but have events, returning partial: ${streamErr?.message}`);
|
|
172
|
+
return lastStatusUpdate;
|
|
173
|
+
}
|
|
129
174
|
throw streamErr;
|
|
130
175
|
}
|
|
131
176
|
finally {
|
|
132
|
-
|
|
177
|
+
try {
|
|
178
|
+
reader.releaseLock();
|
|
179
|
+
}
|
|
180
|
+
catch { /* ignore */ }
|
|
133
181
|
}
|
|
134
182
|
return lastStatusUpdate;
|
|
135
183
|
}
|
|
@@ -179,13 +227,13 @@ export class A2AClient {
|
|
|
179
227
|
}
|
|
180
228
|
return (await res.json());
|
|
181
229
|
}
|
|
182
|
-
/**
|
|
183
|
-
async
|
|
230
|
+
/** 带 chunkTimeout 的 reader.read()(每次读取单独计时,收到数据即重置) */
|
|
231
|
+
async readChunkWithTimeout(reader) {
|
|
184
232
|
let timer;
|
|
185
233
|
const timeout = new Promise((_, reject) => {
|
|
186
234
|
timer = setTimeout(() => {
|
|
187
|
-
reject(new Error(`A2A streaming
|
|
188
|
-
}, this.
|
|
235
|
+
reject(new Error(`A2A streaming chunk timeout: no data for ${this.chunkTimeout}ms`));
|
|
236
|
+
}, this.chunkTimeout);
|
|
189
237
|
});
|
|
190
238
|
try {
|
|
191
239
|
return await Promise.race([reader.read(), timeout]);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/a2a/client.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,2BAA2B;AAC3B,8BAA8B;AAC9B,+DAA+D;AAa/D,2BAA2B;AAC3B,IAAI,YAAY,GAAG,CAAC,CAAC;AAErB,SAAS,SAAS;IAChB,OAAO,OAAO,EAAE,YAAY,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;AAC/C,CAAC;
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/a2a/client.ts"],"names":[],"mappings":"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"}
|
package/dist/esm/a2a/index.d.ts
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
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';
|
|
2
|
-
export { A2AClient } from './client.js';
|
|
2
|
+
export { A2AClient, buildAuthHeaders } from './client.js';
|
|
3
|
+
export type { AuthConfig, A2AClientOptions } from './client.js';
|
|
3
4
|
export { createA2ARemoteRunner, extractTextFromMessage } from './runner.js';
|
|
4
5
|
export type { A2ARemoteRunnerConfig } from './runner.js';
|
|
5
6
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +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;
|
|
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"}
|
package/dist/esm/a2a/index.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
// ============================================================
|
|
2
2
|
// A2A 模块统一导出
|
|
3
3
|
// ============================================================
|
|
4
|
-
export { A2AClient } from "./client.js";
|
|
4
|
+
export { A2AClient, buildAuthHeaders } from "./client.js";
|
|
5
5
|
export { createA2ARemoteRunner, extractTextFromMessage } from "./runner.js";
|
|
6
6
|
//# sourceMappingURL=index.js.map
|
|
@@ -1 +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,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;
|
|
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,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG1D,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC"}
|
package/dist/esm/a2a/runner.d.ts
CHANGED
|
@@ -17,6 +17,17 @@ export interface A2ARemoteRunnerConfig {
|
|
|
17
17
|
client: A2AClient;
|
|
18
18
|
/** 可选的 skillId,供服务端路由到对应的 specialist profile */
|
|
19
19
|
skillId?: string;
|
|
20
|
+
/** 流式失败时是否自动回退到同步模式,默认 true */
|
|
21
|
+
fallbackToSync?: boolean;
|
|
22
|
+
/** 智能事件过滤配置(控制 SSE 事件转发粒度) */
|
|
23
|
+
eventFilter?: {
|
|
24
|
+
/** thinking 累积多少字符后批量转发,默认 100 */
|
|
25
|
+
thinkingFlushThreshold?: number;
|
|
26
|
+
/** thinking 批量转发间隔(毫秒),默认 3000 */
|
|
27
|
+
thinkingFlushInterval?: number;
|
|
28
|
+
/** content 增量过滤:文本增长多少字符后才转发,默认 30 */
|
|
29
|
+
contentMinDelta?: number;
|
|
30
|
+
};
|
|
20
31
|
}
|
|
21
32
|
/**
|
|
22
33
|
* 创建远程 A2A Agent 的 SubAgentRunner
|
|
@@ -1 +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;
|
|
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;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"}
|