@orka-js/a2a 1.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Orka Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,263 @@
+'use strict';
+
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/a2a-server.ts
+var A2AServer = class {
+  agent;
+  cardConfig;
+  baseUrl;
+  constructor(config) {
+    this.agent = config.agent;
+    this.cardConfig = config.card;
+    this.baseUrl = config.baseUrl ?? "http://localhost:3000";
+  }
+  getAgentCard() {
+    return {
+      ...this.cardConfig,
+      url: this.baseUrl
+    };
+  }
+  /**
+   * Returns an Express middleware (Router) that handles A2A protocol requests.
+   */
+  handler() {
+    const { Router } = __require("express");
+    const router = Router();
+    router.get("/.well-known/agent.json", (_req, res) => {
+      res.json(this.getAgentCard());
+    });
+    router.post("/", async (req, res) => {
+      const body = req.body;
+      if (body.jsonrpc !== "2.0" || !body.method) {
+        res.json(this.rpcError(body.id ?? 0, -32600, "Invalid Request"));
+        return;
+      }
+      switch (body.method) {
+        case "tasks/send":
+          await this.handleTaskSend(body, res);
+          break;
+        case "tasks/sendSubscribe":
+          await this.handleTaskSubscribe(body, req, res);
+          break;
+        default:
+          res.json(this.rpcError(body.id, -32601, `Method not found: ${body.method}`));
+      }
+    });
+    return router;
+  }
+  async handleTaskSend(req, res) {
+    const task = req.params;
+    const input = task.message.parts.map((p) => p.text).join("\n");
+    try {
+      const result = await this.agent.run(input);
+      const taskState = {
+        id: task.id,
+        sessionId: task.sessionId,
+        status: { state: "completed", timestamp: (/* @__PURE__ */ new Date()).toISOString() },
+        artifacts: [{
+          parts: [{ type: "text", text: result.output }]
+        }]
+      };
+      const response = {
+        jsonrpc: "2.0",
+        id: req.id,
+        result: taskState
+      };
+      res.json(response);
+    } catch (error) {
+      res.json(this.rpcError(req.id, -32e3, error.message));
+    }
+  }
+  async handleTaskSubscribe(req, _expressReq, res) {
+    const task = req.params;
+    const input = task.message.parts.map((p) => p.text).join("\n");
+    res.setHeader("Content-Type", "text/event-stream");
+    res.setHeader("Cache-Control", "no-cache");
+    res.setHeader("Connection", "keep-alive");
+    res.flushHeaders();
+    const sendEvent = (data) => {
+      res.write(`data: ${JSON.stringify(data)}
+
+`);
+    };
+    sendEvent({
+      jsonrpc: "2.0",
+      id: req.id,
+      result: {
+        id: task.id,
+        status: { state: "working", timestamp: (/* @__PURE__ */ new Date()).toISOString() }
+      }
+    });
+    try {
+      if (typeof this.agent.runStream === "function") {
+        const streamAgent = this.agent;
+        let fullContent = "";
+        for await (const event of streamAgent.runStream(input)) {
+          if (event.type === "token" && event.token) {
+            fullContent += event.token;
+            sendEvent({
+              jsonrpc: "2.0",
+              id: req.id,
+              result: {
+                id: task.id,
+                status: {
+                  state: "working",
+                  message: { role: "agent", parts: [{ type: "text", text: fullContent }] },
+                  timestamp: (/* @__PURE__ */ new Date()).toISOString()
+                }
+              }
+            });
+          } else if (event.type === "done") {
+            fullContent = event.content ?? fullContent;
+          }
+        }
+        sendEvent({
+          jsonrpc: "2.0",
+          id: req.id,
+          result: {
+            id: task.id,
+            status: { state: "completed", timestamp: (/* @__PURE__ */ new Date()).toISOString() },
+            artifacts: [{ parts: [{ type: "text", text: fullContent }] }]
+          }
+        });
+      } else {
+        const result = await this.agent.run(input);
+        sendEvent({
+          jsonrpc: "2.0",
+          id: req.id,
+          result: {
+            id: task.id,
+            status: { state: "completed", timestamp: (/* @__PURE__ */ new Date()).toISOString() },
+            artifacts: [{ parts: [{ type: "text", text: result.output }] }]
+          }
+        });
+      }
+    } catch (error) {
+      sendEvent(this.rpcError(req.id, -32e3, error.message));
+    } finally {
+      res.end();
+    }
+  }
+  rpcError(id, code, message) {
+    return { jsonrpc: "2.0", id, error: { code, message } };
+  }
+};
+
+// src/a2a-client.ts
+var _idCounter = 1;
+var A2AClient = class {
+  baseUrl;
+  timeoutMs;
+  constructor(config) {
+    this.baseUrl = config.baseUrl.replace(/\/$/, "");
+    this.timeoutMs = config.timeoutMs ?? 6e4;
+  }
+  /** Fetch the agent card from the remote agent. */
+  async getAgentCard() {
+    const res = await fetch(`${this.baseUrl}/.well-known/agent.json`);
+    if (!res.ok) {
+      throw new Error(`Failed to fetch agent card: ${res.status}`);
+    }
+    return res.json();
+  }
+  /**
+   * Send a task and wait for the completed result (non-streaming).
+   */
+  async sendTask(input, sessionId) {
+    const task = {
+      id: `task-${Date.now()}`,
+      sessionId,
+      message: { role: "user", parts: [{ type: "text", text: input }] }
+    };
+    const rpcReq = {
+      jsonrpc: "2.0",
+      id: _idCounter++,
+      method: "tasks/send",
+      params: task
+    };
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+    let res;
+    try {
+      res = await fetch(this.baseUrl, {
+        method: "POST",
+        signal: controller.signal,
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(rpcReq)
+      });
+    } finally {
+      clearTimeout(timeout);
+    }
+    if (!res.ok) {
+      throw new Error(`A2A request failed: ${res.status}`);
+    }
+    const rpcRes = await res.json();
+    if (rpcRes.error) {
+      throw new Error(`A2A error ${rpcRes.error.code}: ${rpcRes.error.message}`);
+    }
+    return rpcRes.result;
+  }
+  /**
+   * Send a task with streaming (SSE) and yield task state updates.
+   */
+  async *sendTaskStream(input, sessionId) {
+    const task = {
+      id: `task-${Date.now()}`,
+      sessionId,
+      message: { role: "user", parts: [{ type: "text", text: input }] }
+    };
+    const rpcReq = {
+      jsonrpc: "2.0",
+      id: _idCounter++,
+      method: "tasks/sendSubscribe",
+      params: task
+    };
+    const res = await fetch(this.baseUrl, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(rpcReq)
+    });
+    if (!res.ok || !res.body) {
+      throw new Error(`A2A stream request failed: ${res.status}`);
+    }
+    const reader = res.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) {
+          if (!line.startsWith("data: ")) continue;
+          try {
+            const rpcRes = JSON.parse(line.slice(6));
+            if (rpcRes.error) {
+              throw new Error(`A2A error ${rpcRes.error.code}: ${rpcRes.error.message}`);
+            }
+            if (rpcRes.result) {
+              yield rpcRes.result;
+            }
+          } catch (e) {
+            if (e.message.includes("A2A error")) throw e;
+          }
+        }
+      }
+    } finally {
+      reader.releaseLock();
+    }
+  }
+};
+
+exports.A2AClient = A2AClient;
+exports.A2AServer = A2AServer;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/a2a-server.ts","../src/a2a-client.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type { BaseAgent } from '@orka-js/agent';\nimport type {\n  AgentCard,\n  A2ATask,\n  A2ATaskState,\n  JsonRpcRequest,\n  JsonRpcResponse,\n} from './types.js';\n\nexport interface A2AServerConfig {\n  agent: BaseAgent;\n  card: Omit<AgentCard, 'url'>;\n  /** Base URL where this server is accessible (used in agent card) */\n  baseUrl?: string;\n}\n\n/**\n * Exposes an OrkaJS agent via the Google A2A protocol (JSON-RPC 2.0 over HTTP).\n *\n * Endpoints:\n * - `GET /.well-known/agent.json` — Agent Card\n * - `POST /` — `tasks/send` and `tasks/sendSubscribe` (SSE)\n *\n * @example\n * ```typescript\n * import express from 'express';\n * import { A2AServer } from '@orka-js/a2a';\n *\n * const server = new A2AServer({\n *   agent: myAgent,\n *   card: { name: 'Assistant', description: '...', version: '1.0.0', capabilities: {...}, skills: [] },\n *   baseUrl: 'http://localhost:3000',\n * });\n *\n * const app = express();\n * app.use(server.handler());\n * app.listen(3000);\n * ```\n */\nexport class A2AServer {\n  private agent: BaseAgent;\n  private cardConfig: Omit<AgentCard, 'url'>;\n  private baseUrl: string;\n\n  constructor(config: A2AServerConfig) {\n    this.agent = config.agent;\n    this.cardConfig = config.card;\n    this.baseUrl = config.baseUrl ?? 'http://localhost:3000';\n  }\n\n  getAgentCard(): AgentCard {\n    return {\n      ...this.cardConfig,\n      url: this.baseUrl,\n    };\n  }\n\n  /**\n   * Returns an Express middleware (Router) that handles A2A protocol requests.\n   */\n  handler(): import('express').Router {\n    const { Router } = require('express') as typeof import('express');\n    const router = Router();\n\n    // Agent Card endpoint\n    router.get('/.well-known/agent.json', (_req: import('express').Request, res: import('express').Response) => {\n      res.json(this.getAgentCard());\n    });\n\n    // JSON-RPC 2.0 endpoint\n    router.post('/', async (req: import('express').Request, res: import('express').Response) => {\n      const body = req.body as JsonRpcRequest;\n\n      if (body.jsonrpc !== '2.0' || !body.method) {\n        res.json(this.rpcError(body.id ?? 0, -32600, 'Invalid Request'));\n        return;\n      }\n\n      switch (body.method) {\n        case 'tasks/send':\n          await this.handleTaskSend(body, res);\n          break;\n        case 'tasks/sendSubscribe':\n          await this.handleTaskSubscribe(body, req, res);\n          break;\n        default:\n          res.json(this.rpcError(body.id, -32601, `Method not found: ${body.method}`));\n      }\n    });\n\n    return router;\n  }\n\n  private async handleTaskSend(\n    req: JsonRpcRequest,\n    res: import('express').Response,\n  ): Promise<void> {\n    const task = req.params as A2ATask;\n    const input = task.message.parts.map(p => p.text).join('\\n');\n\n    try {\n      const result = await this.agent.run(input);\n\n      const taskState: A2ATaskState = {\n        id: task.id,\n        sessionId: task.sessionId,\n        status: { state: 'completed', timestamp: new Date().toISOString() },\n        artifacts: [{\n          parts: [{ type: 'text', text: result.output }],\n        }],\n      };\n\n      const response: JsonRpcResponse = {\n        jsonrpc: '2.0',\n        id: req.id,\n        result: taskState,\n      };\n      res.json(response);\n    } catch (error) {\n      res.json(this.rpcError(req.id, -32000, (error as Error).message));\n    }\n  }\n\n  private async handleTaskSubscribe(\n    req: JsonRpcRequest,\n    _expressReq: import('express').Request,\n    res: import('express').Response,\n  ): Promise<void> {\n    const task = req.params as A2ATask;\n    const input = task.message.parts.map(p => p.text).join('\\n');\n\n    res.setHeader('Content-Type', 'text/event-stream');\n    res.setHeader('Cache-Control', 'no-cache');\n    res.setHeader('Connection', 'keep-alive');\n    res.flushHeaders();\n\n    const sendEvent = (data: unknown) => {\n      res.write(`data: ${JSON.stringify(data)}\\n\\n`);\n    };\n\n    // Send \"working\" status\n    sendEvent({\n      jsonrpc: '2.0',\n      id: req.id,\n      result: {\n        id: task.id,\n        status: { state: 'working', timestamp: new Date().toISOString() },\n      } satisfies A2ATaskState,\n    });\n\n    try {\n      if (typeof (this.agent as { runStream?: unknown }).runStream === 'function') {\n        const streamAgent = this.agent as unknown as { runStream(input: string): AsyncIterable<{ type: string; token?: string; content?: string }> };\n        let fullContent = '';\n\n        for await (const event of streamAgent.runStream(input)) {\n          if (event.type === 'token' && event.token) {\n            fullContent += event.token;\n            sendEvent({\n              jsonrpc: '2.0',\n              id: req.id,\n              result: {\n                id: task.id,\n                status: {\n                  state: 'working',\n                  message: { role: 'agent', parts: [{ type: 'text', text: fullContent }] },\n                  timestamp: new Date().toISOString(),\n                },\n              } satisfies A2ATaskState,\n            });\n          } else if (event.type === 'done') {\n            fullContent = event.content ?? fullContent;\n          }\n        }\n\n        sendEvent({\n          jsonrpc: '2.0',\n          id: req.id,\n          result: {\n            id: task.id,\n            status: { state: 'completed', timestamp: new Date().toISOString() },\n            artifacts: [{ parts: [{ type: 'text', text: fullContent }] }],\n          } satisfies A2ATaskState,\n        });\n      } else {\n        const result = await this.agent.run(input);\n        sendEvent({\n          jsonrpc: '2.0',\n          id: req.id,\n          result: {\n            id: task.id,\n            status: { state: 'completed', timestamp: new Date().toISOString() },\n            artifacts: [{ parts: [{ type: 'text', text: result.output }] }],\n          } satisfies A2ATaskState,\n        });\n      }\n    } catch (error) {\n      sendEvent(this.rpcError(req.id, -32000, (error as Error).message));\n    } finally {\n      res.end();\n    }\n  }\n\n  private rpcError(id: string | number, code: number, message: string): JsonRpcResponse {\n    return { jsonrpc: '2.0', id, error: { code, message } };\n  }\n}\n","import type {\n  AgentCard,\n  A2ATask,\n  A2ATaskState,\n  JsonRpcRequest,\n  JsonRpcResponse,\n} from './types.js';\n\nexport interface A2AClientConfig {\n  /** Base URL of the remote A2A agent */\n  baseUrl: string;\n  timeoutMs?: number;\n}\n\nlet _idCounter = 1;\n\n/**\n * Client for communicating with remote A2A-compatible agents.\n *\n * @example\n * ```typescript\n * const client = new A2AClient({ baseUrl: 'http://remote-agent:3000' });\n * const card = await client.getAgentCard();\n * const result = await client.sendTask('What is the weather in Paris?');\n * console.log(result.artifacts?.[0].parts[0].text);\n * ```\n */\nexport class A2AClient {\n  private baseUrl: string;\n  private timeoutMs: number;\n\n  constructor(config: A2AClientConfig) {\n    this.baseUrl = config.baseUrl.replace(/\\/$/, '');\n    this.timeoutMs = config.timeoutMs ?? 60_000;\n  }\n\n  /** Fetch the agent card from the remote agent. */\n  async getAgentCard(): Promise<AgentCard> {\n    const res = await fetch(`${this.baseUrl}/.well-known/agent.json`);\n    if (!res.ok) {\n      throw new Error(`Failed to fetch agent card: ${res.status}`);\n    }\n    return res.json() as Promise<AgentCard>;\n  }\n\n  /**\n   * Send a task and wait for the completed result (non-streaming).\n   */\n  async sendTask(\n    input: string,\n    sessionId?: string,\n  ): Promise<A2ATaskState> {\n    const task: A2ATask = {\n      id: `task-${Date.now()}`,\n      sessionId,\n      message: { role: 'user', parts: [{ type: 'text', text: input }] },\n    };\n\n    const rpcReq: JsonRpcRequest = {\n      jsonrpc: '2.0',\n      id: _idCounter++,\n      method: 'tasks/send',\n      params: task,\n    };\n\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);\n\n    let res: Response;\n    try {\n      res = await fetch(this.baseUrl, {\n        method: 'POST',\n        signal: controller.signal,\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify(rpcReq),\n      });\n    } finally {\n      clearTimeout(timeout);\n    }\n\n    if (!res.ok) {\n      throw new Error(`A2A request failed: ${res.status}`);\n    }\n\n    const rpcRes = await res.json() as JsonRpcResponse;\n    if (rpcRes.error) {\n      throw new Error(`A2A error ${rpcRes.error.code}: ${rpcRes.error.message}`);\n    }\n\n    return rpcRes.result as A2ATaskState;\n  }\n\n  /**\n   * Send a task with streaming (SSE) and yield task state updates.\n   */\n  async *sendTaskStream(\n    input: string,\n    sessionId?: string,\n  ): AsyncIterable<A2ATaskState> {\n    const task: A2ATask = {\n      id: `task-${Date.now()}`,\n      sessionId,\n      message: { role: 'user', parts: [{ type: 'text', text: input }] },\n    };\n\n    const rpcReq: JsonRpcRequest = {\n      jsonrpc: '2.0',\n      id: _idCounter++,\n      method: 'tasks/sendSubscribe',\n      params: task,\n    };\n\n    const res = await fetch(this.baseUrl, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify(rpcReq),\n    });\n\n    if (!res.ok || !res.body) {\n      throw new Error(`A2A stream request failed: ${res.status}`);\n    }\n\n    const reader = res.body.getReader();\n    const decoder = new TextDecoder();\n    let buffer = '';\n\n    try {\n      while (true) {\n        const { done, value } = await reader.read();\n        if (done) break;\n\n        buffer += decoder.decode(value, { stream: true });\n        const lines = buffer.split('\\n');\n        buffer = lines.pop() ?? '';\n\n        for (const line of lines) {\n          if (!line.startsWith('data: ')) continue;\n          try {\n            const rpcRes = JSON.parse(line.slice(6)) as JsonRpcResponse;\n            if (rpcRes.error) {\n              throw new Error(`A2A error ${rpcRes.error.code}: ${rpcRes.error.message}`);\n            }\n            if (rpcRes.result) {\n              yield rpcRes.result as A2ATaskState;\n            }\n          } catch (e) {\n            if ((e as Error).message.includes('A2A error')) throw e;\n            // Skip malformed SSE lines\n          }\n        }\n      }\n    } finally {\n      reader.releaseLock();\n    }\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,150 @@
+import * as express from 'express';
+import { BaseAgent } from '@orka-js/agent';
+
+/**
+ * A2A Protocol types — based on Google's Agent-to-Agent open specification.
+ * @see https://github.com/google/A2A
+ */
+interface AgentCard {
+    name: string;
+    description: string;
+    version: string;
+    url: string;
+    capabilities: {
+        streaming: boolean;
+        tools: boolean;
+        multiModal: boolean;
+    };
+    skills: AgentSkill[];
+}
+interface AgentSkill {
+    id: string;
+    name: string;
+    description: string;
+    inputModes?: string[];
+    outputModes?: string[];
+}
+interface A2AMessagePart {
+    type: 'text';
+    text: string;
+}
+interface A2AMessage {
+    role: 'user' | 'agent';
+    parts: A2AMessagePart[];
+}
+interface A2ATask {
+    id: string;
+    sessionId?: string;
+    message: A2AMessage;
+}
+interface A2AArtifact {
+    name?: string;
+    parts: A2AMessagePart[];
+}
+type A2ATaskStatus = 'submitted' | 'working' | 'completed' | 'failed' | 'canceled';
+interface A2ATaskState {
+    id: string;
+    sessionId?: string;
+    status: {
+        state: A2ATaskStatus;
+        message?: A2AMessage;
+        timestamp?: string;
+    };
+    artifacts?: A2AArtifact[];
+}
+/** JSON-RPC 2.0 request */
+interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    id: string | number;
+    method: string;
+    params?: unknown;
+}
+/** JSON-RPC 2.0 response */
+interface JsonRpcResponse {
+    jsonrpc: '2.0';
+    id: string | number;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+
+interface A2AServerConfig {
+    agent: BaseAgent;
+    card: Omit<AgentCard, 'url'>;
+    /** Base URL where this server is accessible (used in agent card) */
+    baseUrl?: string;
+}
+/**
+ * Exposes an OrkaJS agent via the Google A2A protocol (JSON-RPC 2.0 over HTTP).
+ *
+ * Endpoints:
+ * - `GET /.well-known/agent.json` — Agent Card
+ * - `POST /` — `tasks/send` and `tasks/sendSubscribe` (SSE)
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { A2AServer } from '@orka-js/a2a';
+ *
+ * const server = new A2AServer({
+ *   agent: myAgent,
+ *   card: { name: 'Assistant', description: '...', version: '1.0.0', capabilities: {...}, skills: [] },
+ *   baseUrl: 'http://localhost:3000',
+ * });
+ *
+ * const app = express();
+ * app.use(server.handler());
+ * app.listen(3000);
+ * ```
+ */
+declare class A2AServer {
+    private agent;
+    private cardConfig;
+    private baseUrl;
+    constructor(config: A2AServerConfig);
+    getAgentCard(): AgentCard;
+    /**
+     * Returns an Express middleware (Router) that handles A2A protocol requests.
+     */
+    handler(): express.Router;
+    private handleTaskSend;
+    private handleTaskSubscribe;
+    private rpcError;
+}
+
+interface A2AClientConfig {
+    /** Base URL of the remote A2A agent */
+    baseUrl: string;
+    timeoutMs?: number;
+}
+/**
+ * Client for communicating with remote A2A-compatible agents.
+ *
+ * @example
+ * ```typescript
+ * const client = new A2AClient({ baseUrl: 'http://remote-agent:3000' });
+ * const card = await client.getAgentCard();
+ * const result = await client.sendTask('What is the weather in Paris?');
+ * console.log(result.artifacts?.[0].parts[0].text);
+ * ```
+ */
+declare class A2AClient {
+    private baseUrl;
+    private timeoutMs;
+    constructor(config: A2AClientConfig);
+    /** Fetch the agent card from the remote agent. */
+    getAgentCard(): Promise<AgentCard>;
+    /**
+     * Send a task and wait for the completed result (non-streaming).
+     */
+    sendTask(input: string, sessionId?: string): Promise<A2ATaskState>;
+    /**
+     * Send a task with streaming (SSE) and yield task state updates.
+     */
+    sendTaskStream(input: string, sessionId?: string): AsyncIterable<A2ATaskState>;
+}
+
+export { type A2AArtifact, A2AClient, type A2AClientConfig, type A2AMessage, type A2AMessagePart, A2AServer, type A2AServerConfig, type A2ATask, type A2ATaskState, type A2ATaskStatus, type AgentCard, type AgentSkill, type JsonRpcRequest, type JsonRpcResponse };

package/dist/index.d.ts

@@ -0,0 +1,150 @@
+import * as express from 'express';
+import { BaseAgent } from '@orka-js/agent';
+
+/**
+ * A2A Protocol types — based on Google's Agent-to-Agent open specification.
+ * @see https://github.com/google/A2A
+ */
+interface AgentCard {
+    name: string;
+    description: string;
+    version: string;
+    url: string;
+    capabilities: {
+        streaming: boolean;
+        tools: boolean;
+        multiModal: boolean;
+    };
+    skills: AgentSkill[];
+}
+interface AgentSkill {
+    id: string;
+    name: string;
+    description: string;
+    inputModes?: string[];
+    outputModes?: string[];
+}
+interface A2AMessagePart {
+    type: 'text';
+    text: string;
+}
+interface A2AMessage {
+    role: 'user' | 'agent';
+    parts: A2AMessagePart[];
+}
+interface A2ATask {
+    id: string;
+    sessionId?: string;
+    message: A2AMessage;
+}
+interface A2AArtifact {
+    name?: string;
+    parts: A2AMessagePart[];
+}
+type A2ATaskStatus = 'submitted' | 'working' | 'completed' | 'failed' | 'canceled';
+interface A2ATaskState {
+    id: string;
+    sessionId?: string;
+    status: {
+        state: A2ATaskStatus;
+        message?: A2AMessage;
+        timestamp?: string;
+    };
+    artifacts?: A2AArtifact[];
+}
+/** JSON-RPC 2.0 request */
+interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    id: string | number;
+    method: string;
+    params?: unknown;
+}
+/** JSON-RPC 2.0 response */
+interface JsonRpcResponse {
+    jsonrpc: '2.0';
+    id: string | number;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+
+interface A2AServerConfig {
+    agent: BaseAgent;
+    card: Omit<AgentCard, 'url'>;
+    /** Base URL where this server is accessible (used in agent card) */
+    baseUrl?: string;
+}
+/**
+ * Exposes an OrkaJS agent via the Google A2A protocol (JSON-RPC 2.0 over HTTP).
+ *
+ * Endpoints:
+ * - `GET /.well-known/agent.json` — Agent Card
+ * - `POST /` — `tasks/send` and `tasks/sendSubscribe` (SSE)
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { A2AServer } from '@orka-js/a2a';
+ *
+ * const server = new A2AServer({
+ *   agent: myAgent,
+ *   card: { name: 'Assistant', description: '...', version: '1.0.0', capabilities: {...}, skills: [] },
+ *   baseUrl: 'http://localhost:3000',
+ * });
+ *
+ * const app = express();
+ * app.use(server.handler());
+ * app.listen(3000);
+ * ```
+ */
+declare class A2AServer {
+    private agent;
+    private cardConfig;
+    private baseUrl;
+    constructor(config: A2AServerConfig);
+    getAgentCard(): AgentCard;
+    /**
+     * Returns an Express middleware (Router) that handles A2A protocol requests.
+     */
+    handler(): express.Router;
+    private handleTaskSend;
+    private handleTaskSubscribe;
+    private rpcError;
+}
+
+interface A2AClientConfig {
+    /** Base URL of the remote A2A agent */
+    baseUrl: string;
+    timeoutMs?: number;
+}
+/**
+ * Client for communicating with remote A2A-compatible agents.
+ *
+ * @example
+ * ```typescript
+ * const client = new A2AClient({ baseUrl: 'http://remote-agent:3000' });
+ * const card = await client.getAgentCard();
+ * const result = await client.sendTask('What is the weather in Paris?');
+ * console.log(result.artifacts?.[0].parts[0].text);
+ * ```
+ */
+declare class A2AClient {
+    private baseUrl;
+    private timeoutMs;
+    constructor(config: A2AClientConfig);
+    /** Fetch the agent card from the remote agent. */
+    getAgentCard(): Promise<AgentCard>;
+    /**
+     * Send a task and wait for the completed result (non-streaming).
+     */
+    sendTask(input: string, sessionId?: string): Promise<A2ATaskState>;
+    /**
+     * Send a task with streaming (SSE) and yield task state updates.
+     */
+    sendTaskStream(input: string, sessionId?: string): AsyncIterable<A2ATaskState>;
+}
+
+export { type A2AArtifact, A2AClient, type A2AClientConfig, type A2AMessage, type A2AMessagePart, A2AServer, type A2AServerConfig, type A2ATask, type A2ATaskState, type A2ATaskStatus, type AgentCard, type AgentSkill, type JsonRpcRequest, type JsonRpcResponse };

package/dist/index.js

@@ -0,0 +1,260 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/a2a-server.ts
+var A2AServer = class {
+  agent;
+  cardConfig;
+  baseUrl;
+  constructor(config) {
+    this.agent = config.agent;
+    this.cardConfig = config.card;
+    this.baseUrl = config.baseUrl ?? "http://localhost:3000";
+  }
+  getAgentCard() {
+    return {
+      ...this.cardConfig,
+      url: this.baseUrl
+    };
+  }
+  /**
+   * Returns an Express middleware (Router) that handles A2A protocol requests.
+   */
+  handler() {
+    const { Router } = __require("express");
+    const router = Router();
+    router.get("/.well-known/agent.json", (_req, res) => {
+      res.json(this.getAgentCard());
+    });
+    router.post("/", async (req, res) => {
+      const body = req.body;
+      if (body.jsonrpc !== "2.0" || !body.method) {
+        res.json(this.rpcError(body.id ?? 0, -32600, "Invalid Request"));
+        return;
+      }
+      switch (body.method) {
+        case "tasks/send":
+          await this.handleTaskSend(body, res);
+          break;
+        case "tasks/sendSubscribe":
+          await this.handleTaskSubscribe(body, req, res);
+          break;
+        default:
+          res.json(this.rpcError(body.id, -32601, `Method not found: ${body.method}`));
+      }
+    });
+    return router;
+  }
+  async handleTaskSend(req, res) {
+    const task = req.params;
+    const input = task.message.parts.map((p) => p.text).join("\n");
+    try {
+      const result = await this.agent.run(input);
+      const taskState = {
+        id: task.id,
+        sessionId: task.sessionId,
+        status: { state: "completed", timestamp: (/* @__PURE__ */ new Date()).toISOString() },
+        artifacts: [{
+          parts: [{ type: "text", text: result.output }]
+        }]
+      };
+      const response = {
+        jsonrpc: "2.0",
+        id: req.id,
+        result: taskState
+      };
+      res.json(response);
+    } catch (error) {
+      res.json(this.rpcError(req.id, -32e3, error.message));
+    }
+  }
+  async handleTaskSubscribe(req, _expressReq, res) {
+    const task = req.params;
+    const input = task.message.parts.map((p) => p.text).join("\n");
+    res.setHeader("Content-Type", "text/event-stream");
+    res.setHeader("Cache-Control", "no-cache");
+    res.setHeader("Connection", "keep-alive");
+    res.flushHeaders();
+    const sendEvent = (data) => {
+      res.write(`data: ${JSON.stringify(data)}
+
+`);
+    };
+    sendEvent({
+      jsonrpc: "2.0",
+      id: req.id,
+      result: {
+        id: task.id,
+        status: { state: "working", timestamp: (/* @__PURE__ */ new Date()).toISOString() }
+      }
+    });
+    try {
+      if (typeof this.agent.runStream === "function") {
+        const streamAgent = this.agent;
+        let fullContent = "";
+        for await (const event of streamAgent.runStream(input)) {
+          if (event.type === "token" && event.token) {
+            fullContent += event.token;
+            sendEvent({
+              jsonrpc: "2.0",
+              id: req.id,
+              result: {
+                id: task.id,
+                status: {
+                  state: "working",
+                  message: { role: "agent", parts: [{ type: "text", text: fullContent }] },
+                  timestamp: (/* @__PURE__ */ new Date()).toISOString()
+                }
+              }
+            });
+          } else if (event.type === "done") {
+            fullContent = event.content ?? fullContent;
+          }
+        }
+        sendEvent({
+          jsonrpc: "2.0",
+          id: req.id,
+          result: {
+            id: task.id,
+            status: { state: "completed", timestamp: (/* @__PURE__ */ new Date()).toISOString() },
+            artifacts: [{ parts: [{ type: "text", text: fullContent }] }]
+          }
+        });
+      } else {
+        const result = await this.agent.run(input);
+        sendEvent({
+          jsonrpc: "2.0",
+          id: req.id,
+          result: {
+            id: task.id,
+            status: { state: "completed", timestamp: (/* @__PURE__ */ new Date()).toISOString() },
+            artifacts: [{ parts: [{ type: "text", text: result.output }] }]
+          }
+        });
+      }
+    } catch (error) {
+      sendEvent(this.rpcError(req.id, -32e3, error.message));
+    } finally {
+      res.end();
+    }
+  }
+  rpcError(id, code, message) {
+    return { jsonrpc: "2.0", id, error: { code, message } };
+  }
+};
+
+// src/a2a-client.ts
+var _idCounter = 1;
+var A2AClient = class {
+  baseUrl;
+  timeoutMs;
+  constructor(config) {
+    this.baseUrl = config.baseUrl.replace(/\/$/, "");
+    this.timeoutMs = config.timeoutMs ?? 6e4;
+  }
+  /** Fetch the agent card from the remote agent. */
+  async getAgentCard() {
+    const res = await fetch(`${this.baseUrl}/.well-known/agent.json`);
+    if (!res.ok) {
+      throw new Error(`Failed to fetch agent card: ${res.status}`);
+    }
+    return res.json();
+  }
+  /**
+   * Send a task and wait for the completed result (non-streaming).
+   */
+  async sendTask(input, sessionId) {
+    const task = {
+      id: `task-${Date.now()}`,
+      sessionId,
+      message: { role: "user", parts: [{ type: "text", text: input }] }
+    };
+    const rpcReq = {
+      jsonrpc: "2.0",
+      id: _idCounter++,
+      method: "tasks/send",
+      params: task
+    };
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+    let res;
+    try {
+      res = await fetch(this.baseUrl, {
+        method: "POST",
+        signal: controller.signal,
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(rpcReq)
+      });
+    } finally {
+      clearTimeout(timeout);
+    }
+    if (!res.ok) {
+      throw new Error(`A2A request failed: ${res.status}`);
+    }
+    const rpcRes = await res.json();
+    if (rpcRes.error) {
+      throw new Error(`A2A error ${rpcRes.error.code}: ${rpcRes.error.message}`);
+    }
+    return rpcRes.result;
+  }
+  /**
+   * Send a task with streaming (SSE) and yield task state updates.
+   */
+  async *sendTaskStream(input, sessionId) {
+    const task = {
+      id: `task-${Date.now()}`,
+      sessionId,
+      message: { role: "user", parts: [{ type: "text", text: input }] }
+    };
+    const rpcReq = {
+      jsonrpc: "2.0",
+      id: _idCounter++,
+      method: "tasks/sendSubscribe",
+      params: task
+    };
+    const res = await fetch(this.baseUrl, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(rpcReq)
+    });
+    if (!res.ok || !res.body) {
+      throw new Error(`A2A stream request failed: ${res.status}`);
+    }
+    const reader = res.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) {
+          if (!line.startsWith("data: ")) continue;
+          try {
+            const rpcRes = JSON.parse(line.slice(6));
+            if (rpcRes.error) {
+              throw new Error(`A2A error ${rpcRes.error.code}: ${rpcRes.error.message}`);
+            }
+            if (rpcRes.result) {
+              yield rpcRes.result;
+            }
+          } catch (e) {
+            if (e.message.includes("A2A error")) throw e;
+          }
+        }
+      }
+    } finally {
+      reader.releaseLock();
+    }
+  }
+};
+
+export { A2AClient, A2AServer };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/a2a-server.ts","../src/a2a-client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { BaseAgent } from '@orka-js/agent';\nimport type {\n  AgentCard,\n  A2ATask,\n  A2ATaskState,\n  JsonRpcRequest,\n  JsonRpcResponse,\n} from './types.js';\n\nexport interface A2AServerConfig {\n  agent: BaseAgent;\n  card: Omit<AgentCard, 'url'>;\n  /** Base URL where this server is accessible (used in agent card) */\n  baseUrl?: string;\n}\n\n/**\n * Exposes an OrkaJS agent via the Google A2A protocol (JSON-RPC 2.0 over HTTP).\n *\n * Endpoints:\n * - `GET /.well-known/agent.json` — Agent Card\n * - `POST /` — `tasks/send` and `tasks/sendSubscribe` (SSE)\n *\n * @example\n * ```typescript\n * import express from 'express';\n * import { A2AServer } from '@orka-js/a2a';\n *\n * const server = new A2AServer({\n *   agent: myAgent,\n *   card: { name: 'Assistant', description: '...', version: '1.0.0', capabilities: {...}, skills: [] },\n *   baseUrl: 'http://localhost:3000',\n * });\n *\n * const app = express();\n * app.use(server.handler());\n * app.listen(3000);\n * ```\n */\nexport class A2AServer {\n  private agent: BaseAgent;\n  private cardConfig: Omit<AgentCard, 'url'>;\n  private baseUrl: string;\n\n  constructor(config: A2AServerConfig) {\n    this.agent = config.agent;\n    this.cardConfig = config.card;\n    this.baseUrl = config.baseUrl ?? 'http://localhost:3000';\n  }\n\n  getAgentCard(): AgentCard {\n    return {\n      ...this.cardConfig,\n      url: this.baseUrl,\n    };\n  }\n\n  /**\n   * Returns an Express middleware (Router) that handles A2A protocol requests.\n   */\n  handler(): import('express').Router {\n    const { Router } = require('express') as typeof import('express');\n    const router = Router();\n\n    // Agent Card endpoint\n    router.get('/.well-known/agent.json', (_req: import('express').Request, res: import('express').Response) => {\n      res.json(this.getAgentCard());\n    });\n\n    // JSON-RPC 2.0 endpoint\n    router.post('/', async (req: import('express').Request, res: import('express').Response) => {\n      const body = req.body as JsonRpcRequest;\n\n      if (body.jsonrpc !== '2.0' || !body.method) {\n        res.json(this.rpcError(body.id ?? 0, -32600, 'Invalid Request'));\n        return;\n      }\n\n      switch (body.method) {\n        case 'tasks/send':\n          await this.handleTaskSend(body, res);\n          break;\n        case 'tasks/sendSubscribe':\n          await this.handleTaskSubscribe(body, req, res);\n          break;\n        default:\n          res.json(this.rpcError(body.id, -32601, `Method not found: ${body.method}`));\n      }\n    });\n\n    return router;\n  }\n\n  private async handleTaskSend(\n    req: JsonRpcRequest,\n    res: import('express').Response,\n  ): Promise<void> {\n    const task = req.params as A2ATask;\n    const input = task.message.parts.map(p => p.text).join('\\n');\n\n    try {\n      const result = await this.agent.run(input);\n\n      const taskState: A2ATaskState = {\n        id: task.id,\n        sessionId: task.sessionId,\n        status: { state: 'completed', timestamp: new Date().toISOString() },\n        artifacts: [{\n          parts: [{ type: 'text', text: result.output }],\n        }],\n      };\n\n      const response: JsonRpcResponse = {\n        jsonrpc: '2.0',\n        id: req.id,\n        result: taskState,\n      };\n      res.json(response);\n    } catch (error) {\n      res.json(this.rpcError(req.id, -32000, (error as Error).message));\n    }\n  }\n\n  private async handleTaskSubscribe(\n    req: JsonRpcRequest,\n    _expressReq: import('express').Request,\n    res: import('express').Response,\n  ): Promise<void> {\n    const task = req.params as A2ATask;\n    const input = task.message.parts.map(p => p.text).join('\\n');\n\n    res.setHeader('Content-Type', 'text/event-stream');\n    res.setHeader('Cache-Control', 'no-cache');\n    res.setHeader('Connection', 'keep-alive');\n    res.flushHeaders();\n\n    const sendEvent = (data: unknown) => {\n      res.write(`data: ${JSON.stringify(data)}\\n\\n`);\n    };\n\n    // Send \"working\" status\n    sendEvent({\n      jsonrpc: '2.0',\n      id: req.id,\n      result: {\n        id: task.id,\n        status: { state: 'working', timestamp: new Date().toISOString() },\n      } satisfies A2ATaskState,\n    });\n\n    try {\n      if (typeof (this.agent as { runStream?: unknown }).runStream === 'function') {\n        const streamAgent = this.agent as unknown as { runStream(input: string): AsyncIterable<{ type: string; token?: string; content?: string }> };\n        let fullContent = '';\n\n        for await (const event of streamAgent.runStream(input)) {\n          if (event.type === 'token' && event.token) {\n            fullContent += event.token;\n            sendEvent({\n              jsonrpc: '2.0',\n              id: req.id,\n              result: {\n                id: task.id,\n                status: {\n                  state: 'working',\n                  message: { role: 'agent', parts: [{ type: 'text', text: fullContent }] },\n                  timestamp: new Date().toISOString(),\n                },\n              } satisfies A2ATaskState,\n            });\n          } else if (event.type === 'done') {\n            fullContent = event.content ?? fullContent;\n          }\n        }\n\n        sendEvent({\n          jsonrpc: '2.0',\n          id: req.id,\n          result: {\n            id: task.id,\n            status: { state: 'completed', timestamp: new Date().toISOString() },\n            artifacts: [{ parts: [{ type: 'text', text: fullContent }] }],\n          } satisfies A2ATaskState,\n        });\n      } else {\n        const result = await this.agent.run(input);\n        sendEvent({\n          jsonrpc: '2.0',\n          id: req.id,\n          result: {\n            id: task.id,\n            status: { state: 'completed', timestamp: new Date().toISOString() },\n            artifacts: [{ parts: [{ type: 'text', text: result.output }] }],\n          } satisfies A2ATaskState,\n        });\n      }\n    } catch (error) {\n      sendEvent(this.rpcError(req.id, -32000, (error as Error).message));\n    } finally {\n      res.end();\n    }\n  }\n\n  private rpcError(id: string | number, code: number, message: string): JsonRpcResponse {\n    return { jsonrpc: '2.0', id, error: { code, message } };\n  }\n}\n","import type {\n  AgentCard,\n  A2ATask,\n  A2ATaskState,\n  JsonRpcRequest,\n  JsonRpcResponse,\n} from './types.js';\n\nexport interface A2AClientConfig {\n  /** Base URL of the remote A2A agent */\n  baseUrl: string;\n  timeoutMs?: number;\n}\n\nlet _idCounter = 1;\n\n/**\n * Client for communicating with remote A2A-compatible agents.\n *\n * @example\n * ```typescript\n * const client = new A2AClient({ baseUrl: 'http://remote-agent:3000' });\n * const card = await client.getAgentCard();\n * const result = await client.sendTask('What is the weather in Paris?');\n * console.log(result.artifacts?.[0].parts[0].text);\n * ```\n */\nexport class A2AClient {\n  private baseUrl: string;\n  private timeoutMs: number;\n\n  constructor(config: A2AClientConfig) {\n    this.baseUrl = config.baseUrl.replace(/\\/$/, '');\n    this.timeoutMs = config.timeoutMs ?? 60_000;\n  }\n\n  /** Fetch the agent card from the remote agent. */\n  async getAgentCard(): Promise<AgentCard> {\n    const res = await fetch(`${this.baseUrl}/.well-known/agent.json`);\n    if (!res.ok) {\n      throw new Error(`Failed to fetch agent card: ${res.status}`);\n    }\n    return res.json() as Promise<AgentCard>;\n  }\n\n  /**\n   * Send a task and wait for the completed result (non-streaming).\n   */\n  async sendTask(\n    input: string,\n    sessionId?: string,\n  ): Promise<A2ATaskState> {\n    const task: A2ATask = {\n      id: `task-${Date.now()}`,\n      sessionId,\n      message: { role: 'user', parts: [{ type: 'text', text: input }] },\n    };\n\n    const rpcReq: JsonRpcRequest = {\n      jsonrpc: '2.0',\n      id: _idCounter++,\n      method: 'tasks/send',\n      params: task,\n    };\n\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);\n\n    let res: Response;\n    try {\n      res = await fetch(this.baseUrl, {\n        method: 'POST',\n        signal: controller.signal,\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify(rpcReq),\n      });\n    } finally {\n      clearTimeout(timeout);\n    }\n\n    if (!res.ok) {\n      throw new Error(`A2A request failed: ${res.status}`);\n    }\n\n    const rpcRes = await res.json() as JsonRpcResponse;\n    if (rpcRes.error) {\n      throw new Error(`A2A error ${rpcRes.error.code}: ${rpcRes.error.message}`);\n    }\n\n    return rpcRes.result as A2ATaskState;\n  }\n\n  /**\n   * Send a task with streaming (SSE) and yield task state updates.\n   */\n  async *sendTaskStream(\n    input: string,\n    sessionId?: string,\n  ): AsyncIterable<A2ATaskState> {\n    const task: A2ATask = {\n      id: `task-${Date.now()}`,\n      sessionId,\n      message: { role: 'user', parts: [{ type: 'text', text: input }] },\n    };\n\n    const rpcReq: JsonRpcRequest = {\n      jsonrpc: '2.0',\n      id: _idCounter++,\n      method: 'tasks/sendSubscribe',\n      params: task,\n    };\n\n    const res = await fetch(this.baseUrl, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify(rpcReq),\n    });\n\n    if (!res.ok || !res.body) {\n      throw new Error(`A2A stream request failed: ${res.status}`);\n    }\n\n    const reader = res.body.getReader();\n    const decoder = new TextDecoder();\n    let buffer = '';\n\n    try {\n      while (true) {\n        const { done, value } = await reader.read();\n        if (done) break;\n\n        buffer += decoder.decode(value, { stream: true });\n        const lines = buffer.split('\\n');\n        buffer = lines.pop() ?? '';\n\n        for (const line of lines) {\n          if (!line.startsWith('data: ')) continue;\n          try {\n            const rpcRes = JSON.parse(line.slice(6)) as JsonRpcResponse;\n            if (rpcRes.error) {\n              throw new Error(`A2A error ${rpcRes.error.code}: ${rpcRes.error.message}`);\n            }\n            if (rpcRes.result) {\n              yield rpcRes.result as A2ATaskState;\n            }\n          } catch (e) {\n            if ((e as Error).message.includes('A2A error')) throw e;\n            // Skip malformed SSE lines\n          }\n        }\n      }\n    } finally {\n      reader.releaseLock();\n    }\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@orka-js/a2a",
+  "version": "1.5.0",
+  "description": "Google A2A (Agent-to-Agent) protocol implementation for OrkaJS",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@orka-js/core": "1.5.0",
+    "@orka-js/agent": "1.5.2"
+  },
+  "peerDependencies": {
+    "express": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "vitest": "^1.6.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}