@galdor/a2a 0.3.0 → 0.3.1

package/README.md

@@ -0,0 +1,56 @@
+# @galdor/a2a
+
+A [Google Agent-to-Agent](https://github.com/google/A2A) (A2A) protocol client
+and server for [galdor](https://github.com/YasserCR/galdor-bun) — JSON-RPC 2.0
+over HTTP. Publish a galdor agent so other agents can call it, or drive a remote
+A2A agent as a client.
+
+Serves the Agent Card at `/.well-known/agent.json`, implements `tasks/send` and
+`tasks/get`, the six spec `TaskState`s, task history/artifacts/sessions, and an
+SSRF guard on the client (same-host redirects only, bounded body, configurable
+deadline).
+
+## Install
+
+```bash
+bun add @galdor/a2a   # or: npm install @galdor/a2a
+```
+
+## Server
+
+```ts
+import { newServer, handlerFunc, agentText, type AgentCard } from "@galdor/a2a";
+
+const card: AgentCard = {
+  name: "greeter",
+  description: "Greets people.",
+  url: "http://localhost:4000",
+  version: "1.0.0",
+  capabilities: {},
+  skills: [],
+};
+
+const server = newServer(card, handlerFunc(async (task) => {
+  const name = task.message.parts.map((p) => p.text ?? "").join(" ");
+  return agentText(`Hello, ${name}!`);
+}));
+
+Bun.serve({ port: 4000, fetch: server.fetch }); // Node: pass server.fetch to your HTTP layer
+```
+
+## Client
+
+```ts
+import { Client, userText } from "@galdor/a2a";
+
+const client = new Client("http://localhost:4000");
+// const client = new Client(url, { timeoutMs: 0, fetch: customFetch }); // optional
+
+const card = await client.fetchAgentCard();
+const task = await client.sendTask(userText("Ada"));
+console.log(task.status.state, task.history?.at(-1)?.parts);
+```
+
+## License
+
+Apache-2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galdor/a2a",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "type": "module",
   "description": "galdor-bun a2a: Google Agent-to-Agent (A2A) protocol — JSON-RPC 2.0 over HTTP client + server.",
   "author": {
@@ -31,6 +31,6 @@
     "bun": ">=1.3"
   },
   "dependencies": {
-    "@galdor/core": "0.3.0"
+    "@galdor/core": "0.3.1"
   }
 }