@agent-relay/sdk 3.2.3 → 3.2.5

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

@@ -0,0 +1,25 @@
+/**
+ * Bridge that connects an external A2A agent into a Relay workspace.
+ *
+ * - Registers a proxy agent on the Relay workspace
+ * - When Relay messages arrive for the proxy, forwards them as A2A JSON-RPC
+ *   message/send calls to the external agent
+ * - When A2A responses come back, forwards them as Relay DMs
+ */
+import { Relay } from './core.js';
+import { type A2AAgentCard } from './a2a-types.js';
+import type { RelayConfig } from './types.js';
+export declare class A2ABridge {
+    readonly relay: Relay;
+    readonly a2aAgentUrl: string;
+    readonly proxyName: string;
+    private _agentCard?;
+    private _started;
+    constructor(relayConfig: RelayConfig, a2aAgentUrl: string, proxyName: string);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    discoverAgent(): Promise<A2AAgentCard>;
+    sendA2AMessage(text: string): Promise<string | null>;
+    private _handleRelayMessage;
+}
+//# sourceMappingURL=a2a-bridge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-bridge.d.ts","sourceRoot":"","sources":["../../src/communicate/a2a-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,OAAO,EACL,KAAK,YAAY,EAElB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAW,WAAW,EAAE,MAAM,YAAY,CAAC;AAEvD,qBAAa,SAAS;IACpB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,OAAO,CAAC,UAAU,CAAC,CAAe;IAClC,OAAO,CAAC,QAAQ,CAAS;gBAGvB,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM;IAOb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrB,aAAa,IAAI,OAAO,CAAC,YAAY,CAAC;IAQtC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;YAkD5C,mBAAmB;CAMlC"}

package/dist/communicate/a2a-bridge.js

@@ -0,0 +1,89 @@
+/**
+ * Bridge that connects an external A2A agent into a Relay workspace.
+ *
+ * - Registers a proxy agent on the Relay workspace
+ * - When Relay messages arrive for the proxy, forwards them as A2A JSON-RPC
+ *   message/send calls to the external agent
+ * - When A2A responses come back, forwards them as Relay DMs
+ */
+import { randomUUID } from 'node:crypto';
+import { Relay } from './core.js';
+import { a2aAgentCardFromDict, } from './a2a-types.js';
+export class A2ABridge {
+    relay;
+    a2aAgentUrl;
+    proxyName;
+    _agentCard;
+    _started = false;
+    constructor(relayConfig, a2aAgentUrl, proxyName) {
+        this.relay = new Relay(proxyName, relayConfig);
+        this.a2aAgentUrl = a2aAgentUrl.replace(/\/+$/, '');
+        this.proxyName = proxyName;
+    }
+    async start() {
+        this.relay.onMessage((msg) => this._handleRelayMessage(msg));
+        this._started = true;
+    }
+    async stop() {
+        this._started = false;
+        await this.relay.close();
+    }
+    async discoverAgent() {
+        const url = `${this.a2aAgentUrl}/.well-known/agent.json`;
+        const response = await fetch(url);
+        const data = (await response.json());
+        this._agentCard = a2aAgentCardFromDict(data);
+        return this._agentCard;
+    }
+    async sendA2AMessage(text) {
+        const a2aMsg = {
+            role: 'user',
+            parts: [{ text }],
+            messageId: randomUUID(),
+        };
+        const jsonrpcRequest = {
+            jsonrpc: '2.0',
+            method: 'message/send',
+            params: { message: a2aMsg },
+            id: randomUUID(),
+        };
+        const targetUrl = this._agentCard?.url ?? this.a2aAgentUrl;
+        const response = await fetch(targetUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(jsonrpcRequest),
+        });
+        const data = (await response.json());
+        const result = (data.result ?? {});
+        // Extract response text from task status message
+        const status = (result.status ?? {});
+        const statusMsg = (status.message ?? {});
+        const statusParts = (statusMsg.parts ?? []);
+        if (statusParts.length > 0) {
+            const t = statusParts[0].text;
+            if (t)
+                return t;
+        }
+        // Try from messages list
+        const messages = (result.messages ?? []);
+        for (let i = messages.length - 1; i >= 0; i--) {
+            const msg = messages[i];
+            if (msg.role === 'agent') {
+                const msgParts = (msg.parts ?? []);
+                if (msgParts.length > 0) {
+                    const t = msgParts[0].text;
+                    if (t)
+                        return t;
+                }
+            }
+        }
+        return null;
+    }
+    async _handleRelayMessage(msg) {
+        const responseText = await this.sendA2AMessage(msg.text);
+        if (responseText) {
+            await this.relay.send(msg.sender, responseText);
+        }
+    }
+}
+//# sourceMappingURL=a2a-bridge.js.map

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

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

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

@@ -0,0 +1,31 @@
+/**
+ * A2A-compliant HTTP server that exposes a Relay agent as an A2A endpoint.
+ *
+ * Routes:
+ *   GET  /.well-known/agent.json  -> Agent Card
+ *   POST /                        -> JSON-RPC 2.0 dispatcher
+ */
+import { type A2AAgentCard, type A2AMessage, type A2ASkill, type A2ATask } from './a2a-types.js';
+export type A2AMessageHandler = (msg: A2AMessage) => A2AMessage | null | Promise<A2AMessage | null>;
+export declare class A2AServer {
+    readonly agentName: string;
+    readonly port: number;
+    readonly host: string;
+    readonly skills: A2ASkill[];
+    readonly tasks: Map<string, A2ATask>;
+    private _onMessage?;
+    private _server?;
+    private _actualPort?;
+    constructor(agentName: string, port?: number, host?: string, skills?: A2ASkill[]);
+    get url(): string;
+    onMessage(callback: A2AMessageHandler): void;
+    getAgentCard(): A2AAgentCard;
+    handleMessageSend(params: Record<string, unknown>): Promise<Record<string, unknown>>;
+    handleTasksGet(taskId: string): Promise<Record<string, unknown>>;
+    handleTasksCancel(taskId: string): Promise<Record<string, unknown>>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private _handleRequest;
+    private _handleJsonRpc;
+}
+//# sourceMappingURL=a2a-server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-server.d.ts","sourceRoot":"","sources":["../../src/communicate/a2a-server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,UAAU,EAEf,KAAK,QAAQ,EACb,KAAK,OAAO,EAMb,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,iBAAiB,GAAG,CAC9B,GAAG,EAAE,UAAU,KACZ,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;AAEpD,qBAAa,SAAS;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAa;IAEjD,OAAO,CAAC,UAAU,CAAC,CAAoB;IACvC,OAAO,CAAC,OAAO,CAAC,CAAc;IAC9B,OAAO,CAAC,WAAW,CAAC,CAAS;gBAG3B,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,MAAa,EACnB,IAAI,GAAE,MAAkB,EACxB,MAAM,GAAE,QAAQ,EAAO;IAQzB,IAAI,GAAG,IAAI,MAAM,CAGhB;IAED,SAAS,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAI5C,YAAY,IAAI,YAAY;IAStB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAkDpF,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAQhE,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IASnE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAYb,cAAc;YAiBd,cAAc;CAyD7B"}

package/dist/communicate/a2a-server.js

@@ -0,0 +1,220 @@
+/**
+ * A2A-compliant HTTP server that exposes a Relay agent as an A2A endpoint.
+ *
+ * Routes:
+ *   GET  /.well-known/agent.json  -> Agent Card
+ *   POST /                        -> JSON-RPC 2.0 dispatcher
+ */
+import { randomUUID } from 'node:crypto';
+import * as http from 'node:http';
+import { a2aAgentCardToDict, a2aMessageToDict, createA2AAgentCard, createA2ATaskStatus, } from './a2a-types.js';
+export class A2AServer {
+    agentName;
+    port;
+    host;
+    skills;
+    tasks = new Map();
+    _onMessage;
+    _server;
+    _actualPort;
+    constructor(agentName, port = 5000, host = '0.0.0.0', skills = []) {
+        this.agentName = agentName;
+        this.port = port;
+        this.host = host;
+        this.skills = skills;
+    }
+    get url() {
+        const p = this._actualPort ?? this.port;
+        return `http://${this.host}:${p}`;
+    }
+    onMessage(callback) {
+        this._onMessage = callback;
+    }
+    getAgentCard() {
+        return createA2AAgentCard(this.agentName, `Agent Relay agent: ${this.agentName}`, this.url, [...this.skills]);
+    }
+    async handleMessageSend(params) {
+        const messageData = (params.message ?? {});
+        const rawParts = (messageData.parts ?? []);
+        const parts = rawParts.map((p) => ({ text: p.text }));
+        const incoming = {
+            role: messageData.role ?? 'user',
+            parts,
+            messageId: messageData.messageId ?? randomUUID(),
+            contextId: messageData.contextId,
+            taskId: messageData.taskId,
+        };
+        // Create or find task
+        const taskId = incoming.taskId ?? randomUUID();
+        const contextId = incoming.contextId ?? randomUUID();
+        let task;
+        if (this.tasks.has(taskId)) {
+            task = this.tasks.get(taskId);
+            task.messages.push(incoming);
+            task.status = createA2ATaskStatus('working');
+        }
+        else {
+            task = {
+                id: taskId,
+                contextId,
+                status: createA2ATaskStatus('working'),
+                messages: [incoming],
+                artifacts: [],
+            };
+            this.tasks.set(taskId, task);
+        }
+        // Invoke callback
+        let responseMsg = null;
+        if (this._onMessage) {
+            const result = this._onMessage(incoming);
+            responseMsg = result instanceof Promise ? await result : result;
+        }
+        if (responseMsg) {
+            task.messages.push(responseMsg);
+            task.status = createA2ATaskStatus('completed', responseMsg);
+        }
+        else {
+            task.status = createA2ATaskStatus('completed');
+        }
+        return taskToDict(task);
+    }
+    async handleTasksGet(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            throw new Error(`Task not found: ${taskId}`);
+        }
+        return taskToDict(task);
+    }
+    async handleTasksCancel(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            throw new Error(`Task not found: ${taskId}`);
+        }
+        task.status = createA2ATaskStatus('canceled');
+        return taskToDict(task);
+    }
+    async start() {
+        return new Promise((resolve, reject) => {
+            const server = http.createServer((req, res) => {
+                void this._handleRequest(req, res);
+            });
+            server.on('error', reject);
+            server.listen(this.port, this.host, () => {
+                this._server = server;
+                const addr = server.address();
+                if (typeof addr === 'object' && addr) {
+                    this._actualPort = addr.port;
+                }
+                resolve();
+            });
+        });
+    }
+    async stop() {
+        if (this._server) {
+            await new Promise((resolve, reject) => {
+                this._server.close((err) => (err ? reject(err) : resolve()));
+            });
+            this._server = undefined;
+            this._actualPort = undefined;
+        }
+    }
+    // --- HTTP handlers ---
+    async _handleRequest(req, res) {
+        if (req.method === 'GET' && req.url === '/.well-known/agent.json') {
+            const card = this.getAgentCard();
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify(a2aAgentCardToDict(card)));
+            return;
+        }
+        if (req.method === 'POST' && (req.url === '/' || req.url === '')) {
+            await this._handleJsonRpc(req, res);
+            return;
+        }
+        res.writeHead(404, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: 'Not found' }));
+    }
+    async _handleJsonRpc(req, res) {
+        let body;
+        try {
+            const raw = await readBody(req);
+            body = JSON.parse(raw);
+        }
+        catch {
+            res.writeHead(400, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({
+                jsonrpc: '2.0',
+                error: { code: -32700, message: 'Parse error' },
+                id: null,
+            }));
+            return;
+        }
+        const method = (body.method ?? '');
+        const params = (body.params ?? {});
+        const rpcId = body.id ?? null;
+        try {
+            let result;
+            if (method === 'message/send') {
+                result = await this.handleMessageSend(params);
+            }
+            else if (method === 'tasks/get') {
+                const id = (params.id ?? params.taskId ?? '');
+                result = await this.handleTasksGet(id);
+            }
+            else if (method === 'tasks/cancel') {
+                const id = (params.id ?? params.taskId ?? '');
+                result = await this.handleTasksCancel(id);
+            }
+            else {
+                res.writeHead(400, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({
+                    jsonrpc: '2.0',
+                    error: { code: -32601, message: `Method not found: ${method}` },
+                    id: rpcId,
+                }));
+                return;
+            }
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ jsonrpc: '2.0', result, id: rpcId }));
+        }
+        catch (err) {
+            res.writeHead(404, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({
+                jsonrpc: '2.0',
+                error: { code: -32602, message: String(err) },
+                id: rpcId,
+            }));
+        }
+    }
+}
+// --- Helpers ---
+function 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);
+    });
+}
+function taskToDict(task) {
+    const statusDict = { state: task.status.state };
+    if (task.status.message) {
+        statusDict.message = a2aMessageToDict(task.status.message);
+    }
+    const messages = task.messages.map((m) => {
+        const md = {
+            role: m.role,
+            parts: m.parts.map((p) => ({ text: p.text })),
+        };
+        if (m.messageId)
+            md.messageId = m.messageId;
+        return md;
+    });
+    return {
+        id: task.id,
+        contextId: task.contextId,
+        status: statusDict,
+        messages,
+        artifacts: task.artifacts,
+    };
+}
+//# sourceMappingURL=a2a-server.js.map

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

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

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

@@ -0,0 +1,48 @@
+/**
+ * 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 type { Message, MessageCallback } from './types.js';
+import { type A2AAgentCard, type A2AConfig, type A2AMessage, type A2ATask } from './a2a-types.js';
+export declare class A2AError extends Error {
+    readonly code: number;
+    constructor(code: number, message: string);
+}
+export declare class A2ATransport {
+    readonly config: A2AConfig;
+    agentName?: string;
+    agentCard?: A2AAgentCard;
+    tasks: Map<string, A2ATask>;
+    private _messageCallbacks;
+    private _server?;
+    private _discoveredCards;
+    private _closing;
+    constructor(config: A2AConfig);
+    register(name: string): Promise<{
+        name: string;
+        url: string;
+        type: string;
+    }>;
+    unregister(): Promise<void>;
+    sendDm(target: string, text: string): Promise<Record<string, unknown>>;
+    listAgents(): Promise<Record<string, unknown>[]>;
+    onMessage(callback: MessageCallback): void;
+    connectWs(): Promise<void>;
+    private _handleRequest;
+    private _handleAgentCard;
+    private _handleJsonRpcHttp;
+    private _readBody;
+    private _dispatchJsonRpc;
+    private _handleMessageSend;
+    private _handleTasksGet;
+    private _handleTasksCancel;
+    private _discoverAgent;
+    static _relayMsgToA2A(text: string, _sender: string): A2AMessage;
+    static _a2aToRelayMsg(msg: A2AMessage, sender?: string): Message;
+    private _a2aResultToRelay;
+    private _invokeCallbacks;
+    private _authHeaders;
+}
+//# sourceMappingURL=a2a-transport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-transport.d.ts","sourceRoot":"","sources":["../../src/communicate/a2a-transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,OAAO,EAoBb,MAAM,gBAAgB,CAAC;AAExB,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAED,qBAAa,YAAY;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAE3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAa;IAExC,OAAO,CAAC,iBAAiB,CAAyB;IAClD,OAAO,CAAC,OAAO,CAAC,CAAc;IAC9B,OAAO,CAAC,gBAAgB,CAAwC;IAChE,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,SAAS;IAMvB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IA6B5E,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAkCtE,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAkBtD,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAIpC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;YAMlB,cAAc;YAed,gBAAgB;YAUhB,kBAAkB;IAoBhC,OAAO,CAAC,SAAS;YAWH,gBAAgB;YA2BhB,kBAAkB;YAoClB,eAAe;YAQf,kBAAkB;YAoBlB,cAAc;IAsB5B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU;IAQhE,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,GAAE,MAAkB,GAAG,OAAO;IAW3E,OAAO,CAAC,iBAAiB;YAsBX,gBAAgB;IAM9B,OAAO,CAAC,YAAY;CAWrB"}