@cicctencent/agent-core 0.1.7 → 0.1.9

package/README.md

@@ -2,7 +2,7 @@
 
 > **内部库，仅供项目内部使用，不对外发布。**
 
-AI Agent 核心引擎，提供 ReAct 循环编排、多 LLM 供应商抽象、工具注册与执行、MCP 协议集成、Skill 路由、安全守卫、渐进式记忆管道，以及工具风险评估、审批管理、运行注册表、引擎复用池、JSON 存储、可观测性日志等应用级能力。
+AI Agent 核心引擎，提供 ReAct 循环编排、多 LLM 供应商抽象、工具注册与执行、MCP 协议集成、Skill 路由、安全守卫、渐进式记忆管道、A2A 协议互操作，以及工具风险评估、审批管理、运行注册表、引擎复用池、JSON 存储、可观测性日志等应用级能力。
 
 ## 文档
 

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

@@ -0,0 +1,47 @@
+import type { A2AAgentCard, A2ASendTaskParams, A2ATask, A2ATaskEvent } from './types.ts';
+/** A2A 客户端配置 */
+export interface A2AClientOptions {
+    /** 请求超时（毫秒），默认 300000（5分钟） */
+    timeout?: number;
+    /** 自定义 fetch 实现（默认使用 globalThis.fetch） */
+    fetch?: typeof fetch;
+    /** 自定义请求头（如认证 token） */
+    headers?: Record<string, string>;
+}
+/**
+ * 轻量 A2A 协议客户端
+ *
+ * 用法：
+ *   const client = new A2AClient();
+ *   const card = await client.discoverAgent('https://example.com');
+ *   const task = await client.sendTask(card.url, { message: ... });
+ */
+export declare class A2AClient {
+    private timeout;
+    private fetchFn;
+    private headers;
+    constructor(options?: A2AClientOptions);
+    /**
+     * 通过 base URL 发现远程 Agent
+     * 自动请求 /.well-known/agent.json 并返回 AgentCard
+     */
+    discoverAgent(baseUrl: string): Promise<A2AAgentCard>;
+    /** 同步发送任务（tasks/send），等待完成后返回完整 Task */
+    sendTask(agentUrl: string, params: A2ASendTaskParams): Promise<A2ATask>;
+    /**
+     * 流式发送任务（tasks/sendSubscribe），通过回调逐步接收事件
+     * 返回所有收集到的事件列表
+     */
+    sendTaskStreaming(agentUrl: string, params: A2ASendTaskParams, onEvent?: (event: A2ATaskEvent) => void): Promise<A2ATaskEvent[]>;
+    /** 查询任务状态（tasks/get） */
+    getTask(agentUrl: string, taskId: string, historyLength?: number): Promise<A2ATask>;
+    /** 取消任务（tasks/cancel） */
+    cancelTask(agentUrl: string, taskId: string): Promise<A2ATask>;
+    /** 解析 Agent Card URL */
+    private resolveAgentCardUrl;
+    /** 发送 JSON-RPC 请求 */
+    private jsonRpcCall;
+    /** 带超时的 fetch */
+    private fetchWithTimeout;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +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;;;OAGG;IACG,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GACtC,OAAO,CAAC,YAAY,EAAE,CAAC;IA6D1B,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;IAO3B,qBAAqB;YACP,WAAW;IAyBzB,iBAAiB;YACH,gBAAgB;CAS/B"}

package/dist/cjs/a2a/client.js

@@ -0,0 +1,178 @@
+"use strict";
+// ============================================================
+// A2AClient — 轻量 A2A 协议客户端
+// 支持 Agent 发现、同步/流式任务、取消等核心方法
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A2AClient = void 0;
+/** JSON-RPC 请求 ID 自增计数器 */
+let rpcIdCounter = 0;
+function nextRpcId() {
+    return `a2a_${++rpcIdCounter}_${Date.now()}`;
+}
+/**
+ * 轻量 A2A 协议客户端
+ *
+ * 用法：
+ *   const client = new A2AClient();
+ *   const card = await client.discoverAgent('https://example.com');
+ *   const task = await client.sendTask(card.url, { message: ... });
+ */
+class A2AClient {
+    timeout;
+    fetchFn;
+    headers;
+    constructor(options = {}) {
+        this.timeout = options.timeout ?? 300_000;
+        this.fetchFn = options.fetch ?? globalThis.fetch.bind(globalThis);
+        this.headers = options.headers ?? {};
+    }
+    // ---- Agent 发现 ----
+    /**
+     * 通过 base URL 发现远程 Agent
+     * 自动请求 /.well-known/agent.json 并返回 AgentCard
+     */
+    async discoverAgent(baseUrl) {
+        const url = this.resolveAgentCardUrl(baseUrl);
+        const res = await this.fetchWithTimeout(url, { method: 'GET' });
+        if (!res.ok) {
+            throw new Error(`A2A discover failed: HTTP ${res.status} from ${url}`);
+        }
+        const card = (await res.json());
+        if (!card.name || !card.url) {
+            throw new Error(`Invalid Agent Card from ${url}: missing name or url`);
+        }
+        return card;
+    }
+    // ---- 任务操作 ----
+    /** 同步发送任务（tasks/send），等待完成后返回完整 Task */
+    async sendTask(agentUrl, params) {
+        const response = await this.jsonRpcCall(agentUrl, 'tasks/send', params);
+        if (response.error) {
+            throw new Error(`A2A tasks/send error [${response.error.code}]: ${response.error.message}`);
+        }
+        return response.result;
+    }
+    /**
+     * 流式发送任务（tasks/sendSubscribe），通过回调逐步接收事件
+     * 返回所有收集到的事件列表
+     */
+    async sendTaskStreaming(agentUrl, params, onEvent) {
+        const request = {
+            jsonrpc: '2.0',
+            id: nextRpcId(),
+            method: 'tasks/sendSubscribe',
+            params: params,
+        };
+        const res = await this.fetchWithTimeout(agentUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', ...this.headers },
+            body: JSON.stringify(request),
+        });
+        if (!res.ok) {
+            throw new Error(`A2A streaming failed: HTTP ${res.status}`);
+        }
+        const events = [];
+        const body = res.body;
+        if (!body) {
+            throw new Error('A2A streaming: empty response body');
+        }
+        // SSE 解析：逐行读取 data: 前缀的 JSON 事件
+        const reader = body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = '';
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                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('data:')) {
+                        const jsonStr = trimmed.slice(5).trim();
+                        if (!jsonStr || jsonStr === '[DONE]')
+                            continue;
+                        try {
+                            const event = JSON.parse(jsonStr);
+                            events.push(event);
+                            onEvent?.(event);
+                        }
+                        catch {
+                            // 跳过非 JSON 行
+                        }
+                    }
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+        return events;
+    }
+    /** 查询任务状态（tasks/get） */
+    async getTask(agentUrl, taskId, historyLength) {
+        const params = { id: taskId };
+        if (historyLength !== undefined)
+            params.historyLength = historyLength;
+        const response = await this.jsonRpcCall(agentUrl, 'tasks/get', params);
+        if (response.error) {
+            throw new Error(`A2A tasks/get error [${response.error.code}]: ${response.error.message}`);
+        }
+        return response.result;
+    }
+    /** 取消任务（tasks/cancel） */
+    async cancelTask(agentUrl, taskId) {
+        const params = { id: taskId };
+        const response = await this.jsonRpcCall(agentUrl, 'tasks/cancel', params);
+        if (response.error) {
+            throw new Error(`A2A tasks/cancel error [${response.error.code}]: ${response.error.message}`);
+        }
+        return response.result;
+    }
+    // ---- 内部方法 ----
+    /** 解析 Agent Card URL */
+    resolveAgentCardUrl(baseUrl) {
+        const trimmed = baseUrl.replace(/\/+$/, '');
+        if (trimmed.includes('/.well-known/agent.json'))
+            return trimmed;
+        if (trimmed.endsWith('/a2a'))
+            return `${trimmed}/.well-known/agent.json`;
+        return `${trimmed}/.well-known/agent.json`;
+    }
+    /** 发送 JSON-RPC 请求 */
+    async jsonRpcCall(url, method, params) {
+        const request = {
+            jsonrpc: '2.0',
+            id: nextRpcId(),
+            method,
+            params,
+        };
+        const res = await this.fetchWithTimeout(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', ...this.headers },
+            body: JSON.stringify(request),
+        });
+        if (!res.ok) {
+            throw new Error(`A2A JSON-RPC ${method} failed: HTTP ${res.status}`);
+        }
+        return (await res.json());
+    }
+    /** 带超时的 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);
+        }
+    }
+}
+exports.A2AClient = A2AClient;
+//# sourceMappingURL=client.js.map

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

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

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

@@ -0,0 +1,5 @@
+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.ts';
+export { A2AClient } from './client.ts';
+export { createA2ARemoteRunner, extractTextFromMessage } from './runner.ts';
+export type { A2ARemoteRunnerConfig } from './runner.ts';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/cjs/a2a/index.js

@@ -0,0 +1,12 @@
+"use strict";
+// ============================================================
+// A2A 模块统一导出
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractTextFromMessage = exports.createA2ARemoteRunner = exports.A2AClient = void 0;
+var client_ts_1 = require("./client.js");
+Object.defineProperty(exports, "A2AClient", { enumerable: true, get: function () { return client_ts_1.A2AClient; } });
+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; } });
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,34 @@
+import type { SubAgentRunner } from '../tool/delegate.ts';
+import type { A2AMessage } from './types.ts';
+import { A2AClient } from './client.ts';
+/** 从 A2A Message 中提取文本内容 */
+export declare function extractTextFromMessage(message?: A2AMessage): string;
+/** createA2ARemoteRunner 配置项 */
+export interface A2ARemoteRunnerConfig {
+    /** 远程 Agent 的 A2A 端点 URL（Agent Card 中的 url 字段） */
+    agentUrl: string;
+    /** Runner 标识名（展示用，如 "[Remote] MyAgent"） */
+    name: string;
+    /** Runner 能力描述（供 LLM 理解） */
+    description: string;
+    /** 是否启用流式（tasks/sendSubscribe）；false 则走同步（tasks/send） */
+    streaming?: boolean;
+    /** A2A 客户端实例（外部注入，便于复用和自定义配置） */
+    client: A2AClient;
+}
+/**
+ * 创建远程 A2A Agent 的 SubAgentRunner
+ *
+ * 核心逻辑：
+ *   - streaming=true && ctx.emitSubEvent 存在 → sendTaskStreaming + 事件转发
+ *   - 否则 → sendTask 同步阻塞
+ *
+ * 转发的事件类型：
+ *   - start:    runner 开始执行
+ *   - progress: 远程 Agent 返回 working 状态
+ *   - artifact: 远程 Agent 生成文件产物
+ *   - done:     任务完成
+ *   - error:    任务失败或网络异常
+ */
+export declare function createA2ARemoteRunner(config: A2ARemoteRunnerConfig): SubAgentRunner;
+//# sourceMappingURL=runner.d.ts.map

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

@@ -0,0 +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,EAA0C,MAAM,YAAY,CAAC;AACrF,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;CACnB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,cAAc,CAgFnF"}

package/dist/cjs/a2a/runner.js

@@ -0,0 +1,148 @@
+"use strict";
+// ============================================================
+// A2A Remote Runner 工厂 — 将远程 A2A Agent 包装为 SubAgentRunner
+// 纯协议适配逻辑，不依赖任何持久化/缓存/路由设施
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractTextFromMessage = extractTextFromMessage;
+exports.createA2ARemoteRunner = createA2ARemoteRunner;
+/** 从 A2A Message 中提取文本内容 */
+function extractTextFromMessage(message) {
+    if (!message?.parts)
+        return '';
+    return message.parts
+        .filter((p) => p.kind === 'text')
+        .map(p => p.text)
+        .join('\n');
+}
+/**
+ * 创建远程 A2A Agent 的 SubAgentRunner
+ *
+ * 核心逻辑：
+ *   - streaming=true && ctx.emitSubEvent 存在 → sendTaskStreaming + 事件转发
+ *   - 否则 → sendTask 同步阻塞
+ *
+ * 转发的事件类型：
+ *   - start:    runner 开始执行
+ *   - progress: 远程 Agent 返回 working 状态
+ *   - artifact: 远程 Agent 生成文件产物
+ *   - done:     任务完成
+ *   - error:    任务失败或网络异常
+ */
+function createA2ARemoteRunner(config) {
+    const { agentUrl, name: runnerName, description: runnerDesc, streaming, client } = config;
+    // ---- 流式执行（tasks/sendSubscribe + 事件转发）----
+    const runStreaming = async (task, ctx) => {
+        const emit = ctx.emitSubEvent;
+        const parentCallId = ctx.currentToolCallId || `a2a_${Date.now()}`;
+        const taskId = crypto.randomUUID();
+        emitStart(emit, parentCallId, runnerName, task);
+        try {
+            const events = await client.sendTaskStreaming(agentUrl, {
+                id: taskId,
+                message: {
+                    kind: 'message',
+                    role: 'user',
+                    messageId: crypto.randomUUID(),
+                    parts: [{ kind: 'text', text: task }],
+                },
+            }, (event) => forwardSSEEvent(emit, parentCallId, runnerName, event));
+            // 提取最终结果
+            const statusEvents = events
+                .filter((e) => e.kind === 'status-update');
+            const finalEvent = statusEvents.find(e => e.final === true) || statusEvents[statusEvents.length - 1];
+            if (finalEvent?.status?.state === 'failed') {
+                const errorText = extractTextFromMessage(finalEvent.status?.message);
+                const msg = errorText || 'Remote agent returned error';
+                emitError(emit, parentCallId, runnerName, msg);
+                return `[A2A Remote Agent '${runnerName}'] Error: ${msg}`;
+            }
+            const resultText = extractTextFromMessage(finalEvent?.status?.message) || 'Task completed with no output.';
+            emitDone(emit, parentCallId, runnerName, resultText.length);
+            return resultText;
+        }
+        catch (err) {
+            emitError(emit, parentCallId, runnerName, err.message || err);
+            return `[A2A Remote Agent '${runnerName}'] Error: ${err.message || err}`;
+        }
+    };
+    // ---- 同步执行（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 }],
+                },
+            });
+            const textParts = result.status?.message?.parts
+                ?.filter((p) => p.kind === 'text')
+                .map(p => p.text) ?? [];
+            if (textParts.length > 0)
+                return textParts.join('\n');
+            return `[A2A Remote Agent '${runnerName}'] Task ${result.id} completed with state: ${result.status?.state || 'unknown'}`;
+        }
+        catch (err) {
+            return `[A2A Remote Agent '${runnerName}'] Error: ${err.message || err}`;
+        }
+    };
+    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: 'a2a-streaming' },
+    });
+}
+function forwardSSEEvent(emit, parentCallId, agentName, event) {
+    if (event.kind === 'status-update') {
+        const state = event.status?.state;
+        if (state === 'working') {
+            emit?.({
+                parentToolCallId: parentCallId,
+                agentName,
+                eventType: 'progress',
+                data: { state, timestamp: event.status?.timestamp },
+            });
+        }
+    }
+    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,
+        agentName,
+        eventType: 'done',
+        data: { contentLength },
+    });
+}
+function emitError(emit, parentCallId, agentName, error) {
+    emit?.({
+        parentToolCallId: parentCallId,
+        agentName,
+        eventType: 'error',
+        data: { error },
+    });
+}
+//# sourceMappingURL=runner.js.map

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

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

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

@@ -0,0 +1,149 @@
+/** Agent 技能描述 */
+export interface A2AAgentSkill {
+    id: string;
+    name: string;
+    description: string;
+    tags?: string[];
+    examples?: string[];
+    inputModes?: string[];
+    outputModes?: string[];
+}
+/** Agent 能力声明 */
+export interface A2AAgentCapabilities {
+    streaming: boolean;
+    pushNotifications: boolean;
+    stateTransitionHistory?: boolean;
+}
+/** Agent Card — 通过 /.well-known/agent.json 发布 */
+export interface A2AAgentCard {
+    name: string;
+    description: string;
+    url: string;
+    version: string;
+    provider?: {
+        organization: string;
+        url?: string;
+    };
+    capabilities: A2AAgentCapabilities;
+    skills: A2AAgentSkill[];
+    defaultInputModes: string[];
+    defaultOutputModes: string[];
+    supportsAuthenticatedExtendedCard?: boolean;
+}
+export interface A2ATextPart {
+    kind: 'text';
+    text: string;
+}
+export interface A2AFilePart {
+    kind: 'file';
+    file: {
+        name?: string;
+        mimeType?: string;
+        bytes?: string;
+        uri?: string;
+    };
+}
+export interface A2ADataPart {
+    kind: 'data';
+    data: Record<string, unknown>;
+}
+export type A2APart = A2ATextPart | A2AFilePart | A2ADataPart;
+export interface A2AMessage {
+    kind: 'message';
+    role: 'user' | 'agent';
+    messageId: string;
+    parts: A2APart[];
+    taskId?: string;
+    contextId?: string;
+    referenceTaskIds?: string[];
+    metadata?: Record<string, unknown>;
+}
+export type A2ATaskState = 'submitted' | 'working' | 'input-required' | 'completed' | 'failed' | 'canceled' | 'unknown';
+export interface A2ATaskStatus {
+    state: A2ATaskState;
+    message?: A2AMessage;
+    timestamp?: string;
+}
+export interface A2AArtifact {
+    artifactId: string;
+    name?: string;
+    description?: string;
+    parts: A2APart[];
+    metadata?: Record<string, unknown>;
+}
+export interface A2ATask {
+    id: string;
+    contextId: string;
+    status: A2ATaskStatus;
+    artifacts?: A2AArtifact[];
+    history?: A2AMessage[];
+    metadata?: Record<string, unknown>;
+}
+export interface A2ATaskStatusUpdateEvent {
+    kind: 'status-update';
+    taskId: string;
+    contextId: string;
+    status: A2ATaskStatus;
+    final: boolean;
+    metadata?: Record<string, unknown>;
+}
+export interface A2ATaskArtifactUpdateEvent {
+    kind: 'artifact-update';
+    taskId: string;
+    contextId: string;
+    artifact: A2AArtifact;
+    metadata?: Record<string, unknown>;
+}
+export type A2ATaskEvent = A2ATaskStatusUpdateEvent | A2ATaskArtifactUpdateEvent;
+export interface A2AJsonRpcRequest {
+    jsonrpc: '2.0';
+    id: string;
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface A2AJsonRpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+export interface A2AJsonRpcResponse {
+    jsonrpc: '2.0';
+    id: string;
+    result?: unknown;
+    error?: A2AJsonRpcError;
+}
+/** tasks/send 参数 */
+export interface A2ASendTaskParams {
+    id: string;
+    contextId?: string;
+    message: A2AMessage;
+    acceptedOutputModes?: string[];
+    pushNotificationConfig?: {
+        url: string;
+        token?: string;
+    };
+    metadata?: Record<string, unknown>;
+}
+/** tasks/sendSubscribe 参数（同 tasks/send，但返回 SSE 流） */
+export type A2ASendSubscribeParams = A2ASendTaskParams;
+/** tasks/get 参数 */
+export interface A2AGetTaskParams {
+    id: string;
+    historyLength?: number;
+}
+/** tasks/cancel 参数 */
+export interface A2ACancelTaskParams {
+    id: string;
+}
+/** 存储在 data/a2a-remotes.json 中的远程 Agent 配置 */
+export interface A2ARemoteAgentConfig {
+    id: string;
+    name: string;
+    url: string;
+    agentCardUrl: string;
+    enabled: boolean;
+    discoveredAt?: string;
+    lastCheckedAt?: string;
+    card?: A2AAgentCard;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/cjs/a2a/types.js

@@ -0,0 +1,8 @@
+"use strict";
+// ============================================================
+// A2A (Agent-to-Agent) 协议核心类型定义
+// 基于 A2A Protocol v1.x（Linux Foundation / Google）
+// JSON-RPC 2.0 over HTTP(S)
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/a2a/types.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,gCAAgC;AAChC,kDAAkD;AAClD,4BAA4B;AAC5B,+DAA+D"}

package/dist/cjs/index.d.ts

@@ -71,4 +71,7 @@ export type { PipelineOptions, PipelineResult } from './memory/pipeline.ts';
 export { getDataPath, getProjectDataPath, ensureDataDir, ensureProjectDataDir, expandEnvVars, setAppName, getAppName, } from './utils/data-dir.ts';
 export { collectEngineOutput } from './utils/event-collector.ts';
 export type { EngineRunResult } from './utils/event-collector.ts';
+export { A2AClient, createA2ARemoteRunner, extractTextFromMessage, } from './a2a/index.ts';
+export type { A2ARemoteRunnerConfig, } from './a2a/index.ts';
+export type { A2AAgentCard, A2AAgentSkill, A2AAgentCapabilities, A2APart, A2ATextPart, A2AFilePart, A2ADataPart, A2AMessage, A2ATaskState, A2ATaskStatus, A2AArtifact, A2ATask, A2ATaskStatusUpdateEvent, A2ATaskArtifactUpdateEvent, A2ATaskEvent, A2AJsonRpcRequest, A2AJsonRpcResponse, A2AJsonRpcError, A2ASendTaskParams, A2ASendSubscribeParams, A2AGetTaskParams, A2ACancelTaskParams, A2ARemoteAgentConfig, } from './a2a/index.ts';
 //# sourceMappingURL=index.d.ts.map