@agent-relay/sdk 3.2.3 → 3.2.4

package/dist/communicate/a2a-transport.js

@@ -0,0 +1,302 @@
+/**
+ * A2A (Agent-to-Agent) protocol transport implementation.
+ *
+ * Client side: sends JSON-RPC 2.0 to external A2A agent endpoints.
+ * Server side: runs a local HTTP server accepting A2A JSON-RPC calls.
+ */
+import { randomUUID } from 'node:crypto';
+import * as http from 'node:http';
+import { A2A_TASK_NOT_CANCELABLE, A2A_TASK_NOT_FOUND, JSONRPC_INTERNAL_ERROR, JSONRPC_INVALID_PARAMS, JSONRPC_METHOD_NOT_FOUND, JSONRPC_PARSE_ERROR, a2aAgentCardFromDict, a2aAgentCardToDict, a2aMessageFromDict, a2aMessageGetText, a2aMessageToDict, a2aTaskToDict, createA2AAgentCard, createA2ATaskStatus, makeJsonRpcError, makeJsonRpcRequest, makeJsonRpcResponse, } from './a2a-types.js';
+export class A2AError extends Error {
+    code;
+    constructor(code, message) {
+        super(`A2A error ${code}: ${message}`);
+        this.name = 'A2AError';
+        this.code = code;
+    }
+}
+export class A2ATransport {
+    config;
+    agentName;
+    agentCard;
+    tasks = new Map();
+    _messageCallbacks = [];
+    _server;
+    _discoveredCards = new Map();
+    _closing = false;
+    constructor(config) {
+        this.config = config;
+    }
+    // === Transport interface ===
+    async register(name) {
+        this.agentName = name;
+        const host = this.config.serverHost ?? '0.0.0.0';
+        const port = this.config.serverPort ?? 5000;
+        this.agentCard = createA2AAgentCard(name, this.config.agentDescription ?? `Agent Relay agent: ${name}`, `http://${host}:{PORT}`, this.config.skills ?? []);
+        return new Promise((resolve, reject) => {
+            const server = http.createServer((req, res) => {
+                void this._handleRequest(req, res);
+            });
+            server.on('error', reject);
+            server.listen(port, host, () => {
+                this._server = server;
+                const addr = server.address();
+                const actualPort = typeof addr === 'object' && addr ? addr.port : port;
+                this.agentCard.url = `http://${host}:${actualPort}`;
+                resolve({ name, url: this.agentCard.url, type: 'a2a' });
+            });
+        });
+    }
+    async unregister() {
+        this._closing = true;
+        if (this._server) {
+            await new Promise((resolve, reject) => {
+                this._server.close((err) => (err ? reject(err) : resolve()));
+            });
+            this._server = undefined;
+        }
+        this._closing = false;
+    }
+    async sendDm(target, text) {
+        const card = await this._discoverAgent(target);
+        const message = {
+            role: 'user',
+            parts: [{ text }],
+            messageId: randomUUID(),
+        };
+        const rpcRequest = makeJsonRpcRequest('message/send', {
+            message: a2aMessageToDict(message),
+        });
+        const headers = {
+            'Content-Type': 'application/json',
+            ...this._authHeaders(),
+        };
+        const response = await fetch(card.url, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(rpcRequest),
+        });
+        const body = (await response.json());
+        if (body.error) {
+            throw new A2AError(body.error.code, body.error.message);
+        }
+        const result = (body.result ?? {});
+        return this._a2aResultToRelay(result, card.name);
+    }
+    async listAgents() {
+        const agents = [];
+        for (const url of this.config.registry ?? []) {
+            try {
+                const card = await this._discoverAgent(url);
+                agents.push({
+                    name: card.name,
+                    url: card.url,
+                    description: card.description,
+                    skills: card.skills.map((s) => ({ id: s.id, name: s.name, description: s.description })),
+                });
+            }
+            catch {
+                continue;
+            }
+        }
+        return agents;
+    }
+    onMessage(callback) {
+        this._messageCallbacks.push(callback);
+    }
+    async connectWs() {
+        // A2A uses HTTP, not WebSocket. No-op.
+    }
+    // === HTTP request handler ===
+    async _handleRequest(req, res) {
+        if (req.method === 'GET' && req.url === '/.well-known/agent.json') {
+            await this._handleAgentCard(res);
+            return;
+        }
+        if (req.method === 'POST' && (req.url === '/' || req.url === '')) {
+            await this._handleJsonRpcHttp(req, res);
+            return;
+        }
+        res.writeHead(404, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: 'Not found' }));
+    }
+    async _handleAgentCard(res) {
+        if (!this.agentCard) {
+            res.writeHead(503, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: 'Not registered' }));
+            return;
+        }
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify(a2aAgentCardToDict(this.agentCard)));
+    }
+    async _handleJsonRpcHttp(req, res) {
+        let body;
+        try {
+            const raw = await this._readBody(req);
+            body = JSON.parse(raw);
+        }
+        catch {
+            const error = makeJsonRpcError(JSONRPC_PARSE_ERROR, 'Parse error', null);
+            res.writeHead(400, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify(error));
+            return;
+        }
+        const result = await this._dispatchJsonRpc(body);
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify(result));
+    }
+    _readBody(req) {
+        return new Promise((resolve, reject) => {
+            const chunks = [];
+            req.on('data', (chunk) => chunks.push(chunk));
+            req.on('end', () => resolve(Buffer.concat(chunks).toString()));
+            req.on('error', reject);
+        });
+    }
+    // === JSON-RPC dispatch ===
+    async _dispatchJsonRpc(request) {
+        const rpcId = (request.id ?? null);
+        const method = (request.method ?? '');
+        const params = (request.params ?? {});
+        const handlers = {
+            'message/send': (p) => this._handleMessageSend(p),
+            'tasks/get': (p) => this._handleTasksGet(p),
+            'tasks/cancel': (p) => this._handleTasksCancel(p),
+        };
+        const handler = handlers[method];
+        if (!handler) {
+            return makeJsonRpcError(JSONRPC_METHOD_NOT_FOUND, `Method not found: ${method}`, rpcId);
+        }
+        try {
+            const result = await handler(params);
+            return makeJsonRpcResponse(result, rpcId);
+        }
+        catch (err) {
+            if (err instanceof A2AError) {
+                return makeJsonRpcError(err.code, err.message, rpcId);
+            }
+            return makeJsonRpcError(JSONRPC_INTERNAL_ERROR, String(err), rpcId);
+        }
+    }
+    async _handleMessageSend(params) {
+        const msgData = params.message;
+        if (!msgData) {
+            throw new A2AError(JSONRPC_INVALID_PARAMS, "Missing 'message' in params");
+        }
+        const a2aMsg = a2aMessageFromDict(msgData);
+        const taskId = a2aMsg.taskId ?? randomUUID();
+        const contextId = a2aMsg.contextId ?? randomUUID();
+        let task;
+        if (this.tasks.has(taskId)) {
+            task = this.tasks.get(taskId);
+            task.messages.push(a2aMsg);
+            task.status = createA2ATaskStatus('working');
+        }
+        else {
+            task = {
+                id: taskId,
+                contextId,
+                status: createA2ATaskStatus('working'),
+                messages: [a2aMsg],
+                artifacts: [],
+            };
+            this.tasks.set(taskId, task);
+        }
+        // Convert to Relay message and invoke callbacks
+        const relayMsg = A2ATransport._a2aToRelayMsg(a2aMsg, 'a2a-client');
+        await this._invokeCallbacks(relayMsg);
+        // Mark completed
+        task.status = createA2ATaskStatus('completed');
+        return a2aTaskToDict(task);
+    }
+    async _handleTasksGet(params) {
+        const taskId = params.id ?? '';
+        if (!taskId || !this.tasks.has(taskId)) {
+            throw new A2AError(A2A_TASK_NOT_FOUND, `Task not found: ${taskId}`);
+        }
+        return a2aTaskToDict(this.tasks.get(taskId));
+    }
+    async _handleTasksCancel(params) {
+        const taskId = params.id ?? '';
+        if (!taskId || !this.tasks.has(taskId)) {
+            throw new A2AError(A2A_TASK_NOT_FOUND, `Task not found: ${taskId}`);
+        }
+        const task = this.tasks.get(taskId);
+        if (['completed', 'failed', 'canceled'].includes(task.status.state)) {
+            throw new A2AError(A2A_TASK_NOT_CANCELABLE, `Task ${taskId} is already ${task.status.state}`);
+        }
+        task.status = createA2ATaskStatus('canceled');
+        return a2aTaskToDict(task);
+    }
+    // === Agent discovery ===
+    async _discoverAgent(url) {
+        const normalizedUrl = url.replace(/\/+$/, '');
+        if (this._discoveredCards.has(normalizedUrl)) {
+            return this._discoveredCards.get(normalizedUrl);
+        }
+        const cardUrl = `${normalizedUrl}/.well-known/agent.json`;
+        const response = await fetch(cardUrl);
+        if (!response.ok) {
+            throw new A2AError(-1, `Failed to discover agent at ${cardUrl}: HTTP ${response.status}`);
+        }
+        const data = (await response.json());
+        const card = a2aAgentCardFromDict(data);
+        this._discoveredCards.set(normalizedUrl, card);
+        return card;
+    }
+    // === Message conversion ===
+    static _relayMsgToA2A(text, _sender) {
+        return {
+            role: 'user',
+            parts: [{ text }],
+            messageId: randomUUID(),
+        };
+    }
+    static _a2aToRelayMsg(msg, sender = 'unknown') {
+        const text = a2aMessageGetText(msg);
+        return {
+            sender,
+            text,
+            channel: undefined,
+            threadId: msg.contextId,
+            messageId: msg.messageId,
+        };
+    }
+    _a2aResultToRelay(result, sender) {
+        const messages = result.messages ?? [];
+        let text = '';
+        if (messages.length > 0) {
+            const lastMsg = messages[messages.length - 1];
+            const parts = lastMsg.parts ?? [];
+            text = parts
+                .filter((p) => p.text)
+                .map((p) => p.text)
+                .join(' ');
+        }
+        return {
+            sender,
+            text,
+            task_id: result.id,
+            status: result.status?.state,
+        };
+    }
+    // === Internal helpers ===
+    async _invokeCallbacks(msg) {
+        for (const cb of this._messageCallbacks) {
+            await cb(msg);
+        }
+    }
+    _authHeaders() {
+        const headers = {};
+        if (this.config.authToken) {
+            if (this.config.authScheme === 'api_key') {
+                headers['X-API-Key'] = this.config.authToken;
+            }
+            else {
+                headers['Authorization'] = `Bearer ${this.config.authToken}`;
+            }
+        }
+        return headers;
+    }
+}
+//# sourceMappingURL=a2a-transport.js.map

package/dist/communicate/a2a-transport.js.map

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

package/dist/communicate/a2a-types.d.ts

@@ -0,0 +1,107 @@
+/**
+ * A2A (Agent-to-Agent) protocol data model types.
+ */
+export interface A2APart {
+    text?: string;
+    file?: Record<string, unknown>;
+    data?: Record<string, unknown>;
+}
+export interface A2AMessage {
+    role: 'user' | 'agent';
+    parts: A2APart[];
+    messageId?: string;
+    contextId?: string;
+    taskId?: string;
+}
+export type A2ATaskState = 'submitted' | 'working' | 'completed' | 'failed' | 'canceled';
+export declare const VALID_TASK_STATES: ReadonlySet<string>;
+export interface A2ATaskStatus {
+    state: A2ATaskState;
+    message?: A2AMessage;
+    timestamp?: string;
+}
+export interface A2ATask {
+    id: string;
+    contextId?: string;
+    status: A2ATaskStatus;
+    messages: A2AMessage[];
+    artifacts: Record<string, unknown>[];
+}
+export interface A2ASkill {
+    id: string;
+    name: string;
+    description: string;
+}
+export interface A2AAgentCard {
+    name: string;
+    description: string;
+    url: string;
+    version: string;
+    capabilities: Record<string, unknown>;
+    skills: A2ASkill[];
+    defaultInputModes: string[];
+    defaultOutputModes: string[];
+}
+export interface A2AConfig {
+    /** Server mode */
+    serverPort?: number;
+    serverHost?: string;
+    /** Client mode */
+    targetUrl?: string;
+    /** Agent Card registry (known A2A agent URLs) */
+    registry?: string[];
+    /** Auth */
+    authScheme?: 'bearer' | 'api_key' | string;
+    authToken?: string;
+    /** Agent metadata */
+    agentDescription?: string;
+    skills?: A2ASkill[];
+}
+export declare function createA2APart(text?: string): A2APart;
+export declare function createA2AMessage(role: 'user' | 'agent', parts: A2APart[], opts?: {
+    messageId?: string;
+    contextId?: string;
+    taskId?: string;
+}): A2AMessage;
+export declare function createA2ATaskStatus(state: A2ATaskState, message?: A2AMessage): A2ATaskStatus;
+export declare function createA2ATask(id: string, contextId?: string): A2ATask;
+export declare function createA2AAgentCard(name: string, description: string, url: string, skills?: A2ASkill[]): A2AAgentCard;
+export declare function a2aPartToDict(part: A2APart): Record<string, unknown>;
+export declare function a2aPartFromDict(d: Record<string, unknown>): A2APart;
+export declare function a2aMessageToDict(msg: A2AMessage): Record<string, unknown>;
+export declare function a2aMessageFromDict(d: Record<string, unknown>): A2AMessage;
+export declare function a2aMessageGetText(msg: A2AMessage): string;
+export declare function a2aTaskStatusToDict(status: A2ATaskStatus): Record<string, unknown>;
+export declare function a2aTaskStatusFromDict(d: Record<string, unknown>): A2ATaskStatus;
+export declare function a2aTaskToDict(task: A2ATask): Record<string, unknown>;
+export declare function a2aTaskFromDict(d: Record<string, unknown>): A2ATask;
+export declare function a2aSkillToDict(skill: A2ASkill): Record<string, unknown>;
+export declare function a2aSkillFromDict(d: Record<string, unknown>): A2ASkill;
+export declare function a2aAgentCardToDict(card: A2AAgentCard): Record<string, unknown>;
+export declare function a2aAgentCardFromDict(d: Record<string, unknown>): A2AAgentCard;
+export interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    method: string;
+    params: Record<string, unknown>;
+    id: string | number;
+}
+export interface JsonRpcResponse {
+    jsonrpc: '2.0';
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+    };
+    id: string | number | null;
+}
+export declare function makeJsonRpcRequest(method: string, params: Record<string, unknown>, id?: string | number): JsonRpcRequest;
+export declare function makeJsonRpcResponse(result: unknown, id: string | number): JsonRpcResponse;
+export declare function makeJsonRpcError(code: number, message: string, id: string | number | null): JsonRpcResponse;
+export declare const JSONRPC_PARSE_ERROR = -32700;
+export declare const JSONRPC_INVALID_REQUEST = -32600;
+export declare const JSONRPC_METHOD_NOT_FOUND = -32601;
+export declare const JSONRPC_INVALID_PARAMS = -32602;
+export declare const JSONRPC_INTERNAL_ERROR = -32603;
+export declare const A2A_TASK_NOT_FOUND = -32001;
+export declare const A2A_TASK_NOT_CANCELABLE = -32002;
+//# sourceMappingURL=a2a-types.d.ts.map

package/dist/communicate/a2a-types.d.ts.map

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

package/dist/communicate/a2a-types.js

@@ -0,0 +1,209 @@
+/**
+ * A2A (Agent-to-Agent) protocol data model types.
+ */
+import { randomUUID } from 'node:crypto';
+export const VALID_TASK_STATES = new Set([
+    'submitted',
+    'working',
+    'completed',
+    'failed',
+    'canceled',
+]);
+// --- Factories ---
+export function createA2APart(text) {
+    const part = {};
+    if (text !== undefined)
+        part.text = text;
+    return part;
+}
+export function createA2AMessage(role, parts, opts) {
+    return {
+        role,
+        parts,
+        messageId: opts?.messageId ?? randomUUID(),
+        contextId: opts?.contextId,
+        taskId: opts?.taskId,
+    };
+}
+export function createA2ATaskStatus(state, message) {
+    return {
+        state,
+        message,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function createA2ATask(id, contextId) {
+    return {
+        id,
+        contextId,
+        status: createA2ATaskStatus('submitted'),
+        messages: [],
+        artifacts: [],
+    };
+}
+export function createA2AAgentCard(name, description, url, skills = []) {
+    return {
+        name,
+        description,
+        url,
+        version: '1.0.0',
+        capabilities: { streaming: true, pushNotifications: false },
+        skills,
+        defaultInputModes: ['text'],
+        defaultOutputModes: ['text'],
+    };
+}
+// --- Serialization helpers ---
+export function a2aPartToDict(part) {
+    const d = {};
+    if (part.text !== undefined)
+        d.text = part.text;
+    if (part.file !== undefined)
+        d.file = part.file;
+    if (part.data !== undefined)
+        d.data = part.data;
+    return d;
+}
+export function a2aPartFromDict(d) {
+    return {
+        text: d.text,
+        file: d.file,
+        data: d.data,
+    };
+}
+export function a2aMessageToDict(msg) {
+    const d = {
+        role: msg.role,
+        parts: msg.parts.map(a2aPartToDict),
+    };
+    if (msg.messageId !== undefined)
+        d.messageId = msg.messageId;
+    if (msg.contextId !== undefined)
+        d.contextId = msg.contextId;
+    if (msg.taskId !== undefined)
+        d.taskId = msg.taskId;
+    return d;
+}
+export function a2aMessageFromDict(d) {
+    const parts = (d.parts ?? []).map(a2aPartFromDict);
+    return {
+        role: d.role,
+        parts,
+        messageId: d.messageId,
+        contextId: d.contextId,
+        taskId: d.taskId,
+    };
+}
+export function a2aMessageGetText(msg) {
+    return msg.parts
+        .filter((p) => p.text)
+        .map((p) => p.text)
+        .join(' ');
+}
+export function a2aTaskStatusToDict(status) {
+    const d = { state: status.state };
+    if (status.message !== undefined)
+        d.message = a2aMessageToDict(status.message);
+    if (status.timestamp !== undefined)
+        d.timestamp = status.timestamp;
+    return d;
+}
+export function a2aTaskStatusFromDict(d) {
+    let message;
+    if (d.message !== undefined && d.message !== null) {
+        message = a2aMessageFromDict(d.message);
+    }
+    return {
+        state: d.state,
+        message,
+        timestamp: d.timestamp,
+    };
+}
+export function a2aTaskToDict(task) {
+    return {
+        id: task.id,
+        contextId: task.contextId,
+        status: a2aTaskStatusToDict(task.status),
+        messages: task.messages.map(a2aMessageToDict),
+        artifacts: task.artifacts,
+    };
+}
+export function a2aTaskFromDict(d) {
+    const status = d.status
+        ? a2aTaskStatusFromDict(d.status)
+        : createA2ATaskStatus('submitted');
+    const messages = (d.messages ?? []).map(a2aMessageFromDict);
+    return {
+        id: d.id,
+        contextId: d.contextId,
+        status,
+        messages,
+        artifacts: d.artifacts ?? [],
+    };
+}
+export function a2aSkillToDict(skill) {
+    return { id: skill.id, name: skill.name, description: skill.description };
+}
+export function a2aSkillFromDict(d) {
+    return {
+        id: d.id,
+        name: d.name,
+        description: d.description,
+    };
+}
+export function a2aAgentCardToDict(card) {
+    return {
+        name: card.name,
+        description: card.description,
+        url: card.url,
+        version: card.version,
+        capabilities: card.capabilities,
+        skills: card.skills.map(a2aSkillToDict),
+        defaultInputModes: card.defaultInputModes,
+        defaultOutputModes: card.defaultOutputModes,
+    };
+}
+export function a2aAgentCardFromDict(d) {
+    const skills = (d.skills ?? []).map(a2aSkillFromDict);
+    return {
+        name: d.name,
+        description: d.description,
+        url: d.url,
+        version: d.version ?? '1.0.0',
+        capabilities: d.capabilities ?? {
+            streaming: true,
+            pushNotifications: false,
+        },
+        skills,
+        defaultInputModes: d.defaultInputModes ?? ['text'],
+        defaultOutputModes: d.defaultOutputModes ?? ['text'],
+    };
+}
+export function makeJsonRpcRequest(method, params, id) {
+    return {
+        jsonrpc: '2.0',
+        method,
+        params,
+        id: id ?? randomUUID(),
+    };
+}
+export function makeJsonRpcResponse(result, id) {
+    return { jsonrpc: '2.0', result, id };
+}
+export function makeJsonRpcError(code, message, id) {
+    return {
+        jsonrpc: '2.0',
+        error: { code, message },
+        id,
+    };
+}
+// Standard JSON-RPC error codes
+export const JSONRPC_PARSE_ERROR = -32700;
+export const JSONRPC_INVALID_REQUEST = -32600;
+export const JSONRPC_METHOD_NOT_FOUND = -32601;
+export const JSONRPC_INVALID_PARAMS = -32602;
+export const JSONRPC_INTERNAL_ERROR = -32603;
+// A2A-specific error codes
+export const A2A_TASK_NOT_FOUND = -32001;
+export const A2A_TASK_NOT_CANCELABLE = -32002;
+//# sourceMappingURL=a2a-types.js.map

package/dist/communicate/a2a-types.js.map

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