@perkos/perkos-a2a 0.3.1

package/dist/index.js

@@ -0,0 +1,236 @@
+/**
+ * @perkos/a2a — OpenClaw Plugin
+ *
+ * Agent-to-Agent (A2A) protocol communication plugin.
+ * Adds tools for agents to discover peers, send tasks, and check task status.
+ * Runs an A2A-compliant HTTP server alongside the OpenClaw gateway.
+ */
+import { A2AServer } from "./server.js";
+export { A2AServer } from "./server.js";
+export * from "./types.js";
+export default function register(api) {
+    const pluginConfig = api.config?.plugins?.entries?.["perkos-a2a"]?.config || {
+        agentName: "agent",
+        port: 5050,
+        skills: [],
+        peers: {},
+    };
+    const logger = api.logger || console;
+    const server = new A2AServer(pluginConfig, logger);
+    // Start A2A server as background service
+    api.registerService({
+        id: "perkos-a2a",
+        start: () => {
+            server.start();
+            logger.info(`[perkos-a2a] A2A server started for ${pluginConfig.agentName}`);
+        },
+        stop: () => {
+            logger.info("[perkos-a2a] A2A server stopping");
+        },
+    });
+    // Tool: Send a task to a peer agent
+    api.registerTool({
+        name: "a2a_send_task",
+        description: "Send a task to another agent in the council via A2A protocol. " +
+            "Use this to delegate work to a peer agent.",
+        parameters: {
+            type: "object",
+            properties: {
+                target: {
+                    type: "string",
+                    description: "Name of the target agent (e.g. 'mimir', 'tyr', 'bragi', 'idunn')",
+                },
+                message: {
+                    type: "string",
+                    description: "The task message to send to the agent",
+                },
+            },
+            required: ["target", "message"],
+        },
+        async execute(_id, params) {
+            try {
+                const result = await server.sendTask(params.target, params.message);
+                if (result.error) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Failed to send task to ${params.target}: ${result.error.message}`,
+                            },
+                        ],
+                    };
+                }
+                const task = result.result;
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: [
+                                `Task sent to ${params.target} successfully.`,
+                                `Task ID: ${task?.id}`,
+                                `Status: ${task?.status?.state}`,
+                            ].join("\n"),
+                        },
+                    ],
+                };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return {
+                    content: [{ type: "text", text: `Error sending task: ${msg}` }],
+                };
+            }
+        },
+    });
+    // Tool: Discover peer agents
+    api.registerTool({
+        name: "a2a_discover",
+        description: "Discover all peer agents in the council and their capabilities. " +
+            "Returns each agent's status, name, description, and skills.",
+        parameters: {
+            type: "object",
+            properties: {},
+        },
+        async execute() {
+            try {
+                const peers = await server.discoverPeers();
+                const lines = ["## Council Agents\n"];
+                for (const [name, info] of Object.entries(peers)) {
+                    if (info.status === "online" && info.card) {
+                        lines.push(`### ${info.card.name} (${name})`);
+                        lines.push(`- **Status:** online`);
+                        lines.push(`- **Description:** ${info.card.description}`);
+                        lines.push(`- **Skills:** ${info.card.skills.map((s) => s.name).join(", ")}`);
+                        lines.push("");
+                    }
+                    else {
+                        lines.push(`### ${name}`);
+                        lines.push(`- **Status:** offline`);
+                        lines.push("");
+                    }
+                }
+                return {
+                    content: [{ type: "text", text: lines.join("\n") }],
+                };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return {
+                    content: [{ type: "text", text: `Error discovering peers: ${msg}` }],
+                };
+            }
+        },
+    });
+    // Tool: Get task status
+    api.registerTool({
+        name: "a2a_task_status",
+        description: "Get the status of a previously sent A2A task by its ID.",
+        parameters: {
+            type: "object",
+            properties: {
+                target: {
+                    type: "string",
+                    description: "Name of the agent that received the task",
+                },
+                taskId: {
+                    type: "string",
+                    description: "The task ID returned from a2a_send_task",
+                },
+            },
+            required: ["target", "taskId"],
+        },
+        async execute(_id, params) {
+            const targetUrl = pluginConfig.peers[params.target];
+            if (!targetUrl) {
+                return {
+                    content: [
+                        { type: "text", text: `Unknown agent: ${params.target}` },
+                    ],
+                };
+            }
+            try {
+                const response = await fetch(`${targetUrl}/a2a/jsonrpc`, {
+                    method: "POST",
+                    headers: { "Content-Type": "application/json" },
+                    body: JSON.stringify({
+                        jsonrpc: "2.0",
+                        method: "tasks/get",
+                        id: crypto.randomUUID(),
+                        params: { id: params.taskId },
+                    }),
+                });
+                const data = (await response.json());
+                if (data.error) {
+                    return {
+                        content: [
+                            { type: "text", text: `Error: ${data.error.message}` },
+                        ],
+                    };
+                }
+                const task = data.result;
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: [
+                                `**Task:** ${task.id}`,
+                                `**Status:** ${task.status.state}`,
+                                `**Updated:** ${task.status.timestamp}`,
+                                task.artifacts?.length
+                                    ? `**Artifacts:** ${task.artifacts.length}`
+                                    : "",
+                            ]
+                                .filter(Boolean)
+                                .join("\n"),
+                        },
+                    ],
+                };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return {
+                    content: [{ type: "text", text: `Error: ${msg}` }],
+                };
+            }
+        },
+    });
+    // Gateway RPC method
+    api.registerGatewayMethod("a2a.status", ({ respond }) => {
+        respond(true, {
+            agent: pluginConfig.agentName,
+            port: pluginConfig.port,
+            peers: Object.keys(pluginConfig.peers),
+            protocol: "a2a",
+            version: "0.3.0",
+        });
+    });
+    // CLI command
+    api.registerCli(({ program }) => {
+        const cmd = program.command("a2a").description("A2A protocol tools");
+        cmd
+            .command("status")
+            .description("Show A2A agent status")
+            .action(async () => {
+            console.log(`Agent: ${pluginConfig.agentName}`);
+            console.log(`Port: ${pluginConfig.port}`);
+            console.log(`Peers: ${Object.keys(pluginConfig.peers).join(", ")}`);
+        });
+        cmd
+            .command("discover")
+            .description("Discover peer agents")
+            .action(async () => {
+            const peers = await server.discoverPeers();
+            for (const [name, info] of Object.entries(peers)) {
+                console.log(`${name}: ${info.status}${info.card ? ` — ${info.card.description}` : ""}`);
+            }
+        });
+        cmd
+            .command("send <target> <message>")
+            .description("Send a task to a peer agent")
+            .action(async (target, message) => {
+            const result = await server.sendTask(target, message);
+            console.log(JSON.stringify(result, null, 2));
+        });
+    }, { commands: ["perkos-a2a"] });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,cAAc,YAAY,CAAC;AAE3B,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAQ;IACvC,MAAM,YAAY,GAAoB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,IAAI;QAC5F,SAAS,EAAE,OAAO;QAClB,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,EAAE;QACV,KAAK,EAAE,EAAE;KACV,CAAC;IAEF,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAEnD,yCAAyC;IACzC,GAAG,CAAC,eAAe,CAAC;QAClB,EAAE,EAAE,YAAY;QAChB,KAAK,EAAE,GAAG,EAAE;YACV,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,uCAAuC,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC;QAC/E,CAAC;QACD,IAAI,EAAE,GAAG,EAAE;YACT,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QAClD,CAAC;KACF,CAAC,CAAC;IAEH,oCAAoC;IACpC,GAAG,CAAC,YAAY,CAAC;QACf,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,gEAAgE;YAChE,4CAA4C;QAC9C,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,kEAAkE;iBACrE;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,uCAAuC;iBACrD;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;SAChC;QACD,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,MAA2C;YACpE,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;gBACpE,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;oBACjB,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,0BAA0B,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;6BACzE;yBACF;qBACF,CAAC;gBACJ,CAAC;gBACD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAa,CAAC;gBAClC,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE;gCACJ,gBAAgB,MAAM,CAAC,MAAM,gBAAgB;gCAC7C,YAAY,IAAI,EAAE,EAAE,EAAE;gCACtB,WAAW,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE;6BACjC,CAAC,IAAI,CAAC,IAAI,CAAC;yBACb;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7D,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,GAAG,EAAE,EAAE,CAAC;iBAChE,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,6BAA6B;IAC7B,GAAG,CAAC,YAAY,CAAC;QACf,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,kEAAkE;YAClE,6DAA6D;QAC/D,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;QACD,KAAK,CAAC,OAAO;YACX,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;gBAC3C,MAAM,KAAK,GAAa,CAAC,qBAAqB,CAAC,CAAC;gBAChD,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBACjD,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;wBAC1C,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,GAAG,CAAC,CAAC;wBAC9C,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;wBACnC,KAAK,CAAC,IAAI,CAAC,sBAAsB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;wBAC1D,KAAK,CAAC,IAAI,CACR,iBAAiB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClE,CAAC;wBACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBACjB,CAAC;yBAAM,CAAC;wBACN,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;wBAC1B,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;wBACpC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBACjB,CAAC;gBACH,CAAC;gBACD,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;iBACpD,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7D,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,4BAA4B,GAAG,EAAE,EAAE,CAAC;iBACrE,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,wBAAwB;IACxB,GAAG,CAAC,YAAY,CAAC;QACf,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,yDAAyD;QACtE,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0CAA0C;iBACxD;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yCAAyC;iBACvD;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;SAC/B;QACD,KAAK,CAAC,OAAO,CACX,GAAW,EACX,MAA0C;YAE1C,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACpD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO;oBACL,OAAO,EAAE;wBACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,MAAM,CAAC,MAAM,EAAE,EAAE;qBAC1D;iBACF,CAAC;YACJ,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,SAAS,cAAc,EAAE;oBACvD,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;oBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,OAAO,EAAE,KAAK;wBACd,MAAM,EAAE,WAAW;wBACnB,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;wBACvB,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE;qBAC9B,CAAC;iBACH,CAAC,CAAC;gBAEH,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAQ,CAAC;gBAC5C,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;oBACf,OAAO;wBACL,OAAO,EAAE;4BACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE;yBACvD;qBACF,CAAC;gBACJ,CAAC;gBAED,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;gBACzB,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE;gCACJ,aAAa,IAAI,CAAC,EAAE,EAAE;gCACtB,eAAe,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE;gCAClC,gBAAgB,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE;gCACvC,IAAI,CAAC,SAAS,EAAE,MAAM;oCACpB,CAAC,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE;oCAC3C,CAAC,CAAC,EAAE;6BACP;iCACE,MAAM,CAAC,OAAO,CAAC;iCACf,IAAI,CAAC,IAAI,CAAC;yBACd;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7D,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,EAAE,EAAE,CAAC;iBACnD,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,qBAAqB;IACrB,GAAG,CAAC,qBAAqB,CAAC,YAAY,EAAE,CAAC,EAAE,OAAO,EAAO,EAAE,EAAE;QAC3D,OAAO,CAAC,IAAI,EAAE;YACZ,KAAK,EAAE,YAAY,CAAC,SAAS;YAC7B,IAAI,EAAE,YAAY,CAAC,IAAI;YACvB,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;YACtC,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,cAAc;IACd,GAAG,CAAC,WAAW,CACb,CAAC,EAAE,OAAO,EAAO,EAAE,EAAE;QACnB,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC;QAErE,GAAG;aACA,OAAO,CAAC,QAAQ,CAAC;aACjB,WAAW,CAAC,uBAAuB,CAAC;aACpC,MAAM,CAAC,KAAK,IAAI,EAAE;YACjB,OAAO,CAAC,GAAG,CAAC,UAAU,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,SAAS,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtE,CAAC,CAAC,CAAC;QAEL,GAAG;aACA,OAAO,CAAC,UAAU,CAAC;aACnB,WAAW,CAAC,sBAAsB,CAAC;aACnC,MAAM,CAAC,KAAK,IAAI,EAAE;YACjB,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;YAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,OAAO,CAAC,GAAG,CACT,GAAG,IAAI,KAAK,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3E,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;QAEL,GAAG;aACA,OAAO,CAAC,yBAAyB,CAAC;aAClC,WAAW,CAAC,6BAA6B,CAAC;aAC1C,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,OAAe,EAAE,EAAE;YAChD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACtD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACP,CAAC,EACD,EAAE,QAAQ,EAAE,CAAC,YAAY,CAAC,EAAE,CAC7B,CAAC;AACJ,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,36 @@
+/**
+ * A2A Protocol Server
+ * Express-based JSON-RPC 2.0 server with Agent Card discovery
+ */
+import express from "express";
+import type { AgentCard, JsonRpcResponse, A2APluginConfig } from "./types.js";
+export declare class A2AServer {
+    private app;
+    private tasks;
+    private agentCard;
+    private config;
+    private logger;
+    constructor(config: A2APluginConfig, logger?: {
+        info: (...args: unknown[]) => void;
+        error: (...args: unknown[]) => void;
+    });
+    private setupRoutes;
+    private handleSendMessage;
+    private processTask;
+    private handleGetTask;
+    private handleListTasks;
+    private handleCancelTask;
+    /** Send a task to a peer agent via A2A protocol */
+    sendTask(targetAgent: string, messageText: string): Promise<JsonRpcResponse>;
+    /** Discover all peer agents */
+    discoverPeers(): Promise<Record<string, {
+        status: string;
+        card?: AgentCard;
+    }>>;
+    private success;
+    private error;
+    start(): void;
+    private tryListen;
+    getExpressApp(): express.Express;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAG9B,OAAO,KAAK,EACV,SAAS,EAGT,eAAe,EACf,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,qBAAa,SAAS;IACpB,OAAO,CAAC,GAAG,CAAkB;IAC7B,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,MAAM,CAA8E;gBAG1F,MAAM,EAAE,eAAe,EACvB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;QAAC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;KAAE;IAsBtF,OAAO,CAAC,WAAW;YAgFL,iBAAiB;YA+BjB,WAAW;IA4DzB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,gBAAgB;IAaxB,mDAAmD;IAC7C,QAAQ,CACZ,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,CAAC;IAgC3B,+BAA+B;IACzB,aAAa,IAAI,OAAO,CAC5B,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC,CACrD;IAeD,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,KAAK;IAIb,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,SAAS;IA2BjB,aAAa,IAAI,OAAO,CAAC,OAAO;CAGjC"}

package/dist/server.js

@@ -0,0 +1,287 @@
+/**
+ * A2A Protocol Server
+ * Express-based JSON-RPC 2.0 server with Agent Card discovery
+ */
+import express from "express";
+import { randomUUID } from "crypto";
+import { homedir } from "os";
+export class A2AServer {
+    app;
+    tasks = new Map();
+    agentCard;
+    config;
+    logger;
+    constructor(config, logger) {
+        this.config = config;
+        this.logger = logger || { info: console.log, error: console.error };
+        this.app = express();
+        this.app.use(express.json());
+        this.agentCard = {
+            name: config.agentName,
+            description: `PerkOS agent: ${config.agentName}`,
+            protocolVersion: "0.3.0",
+            version: "1.0.0",
+            url: `http://localhost:${config.port}/a2a/jsonrpc`,
+            skills: config.skills || [],
+            capabilities: { pushNotifications: false },
+            defaultInputModes: ["text"],
+            defaultOutputModes: ["text"],
+        };
+        this.setupRoutes();
+    }
+    setupRoutes() {
+        // Agent Card discovery
+        this.app.get("/.well-known/agent-card.json", (_req, res) => {
+            res.json(this.agentCard);
+        });
+        // Health check
+        this.app.get("/health", (_req, res) => {
+            res.json({
+                ok: true,
+                agent: this.config.agentName,
+                protocol: "a2a",
+                version: "0.3.0",
+                peers: Object.keys(this.config.peers),
+                taskCount: this.tasks.size,
+            });
+        });
+        // JSON-RPC 2.0 endpoint
+        this.app.post("/a2a/jsonrpc", async (req, res) => {
+            const { method, params, id } = req.body;
+            try {
+                let result;
+                switch (method) {
+                    case "message/send":
+                        result = await this.handleSendMessage(params, id);
+                        break;
+                    case "tasks/get":
+                        result = this.handleGetTask(params, id);
+                        break;
+                    case "tasks/list":
+                        result = this.handleListTasks(id);
+                        break;
+                    case "tasks/cancel":
+                        result = this.handleCancelTask(params, id);
+                        break;
+                    case "agent/card":
+                        result = this.success(id, this.agentCard);
+                        break;
+                    default:
+                        result = this.error(id, -32601, `Method not found: ${method}`);
+                }
+                res.json(result);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                this.logger.error(`[a2a] RPC error: ${msg}`);
+                res.json(this.error(id, -32603, msg));
+            }
+        });
+        // Peer discovery
+        this.app.get("/a2a/peers", async (_req, res) => {
+            const results = {};
+            for (const [name, url] of Object.entries(this.config.peers)) {
+                try {
+                    const r = await fetch(`${url}/.well-known/agent-card.json`, {
+                        signal: AbortSignal.timeout(3000),
+                    });
+                    results[name] = { status: "online", card: await r.json() };
+                }
+                catch {
+                    results[name] = { status: "offline" };
+                }
+            }
+            res.json(results);
+        });
+        // Send task to peer (REST convenience)
+        this.app.post("/a2a/send", async (req, res) => {
+            const { target, message } = req.body;
+            try {
+                const result = await this.sendTask(target, message);
+                res.json({ ok: true, result });
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                res.status(500).json({ ok: false, error: msg });
+            }
+        });
+    }
+    async handleSendMessage(params, rpcId) {
+        const message = params.message;
+        const taskId = randomUUID();
+        const contextId = message?.contextId || randomUUID();
+        const task = {
+            kind: "task",
+            id: taskId,
+            contextId,
+            status: { state: "submitted", timestamp: new Date().toISOString() },
+            messages: [message],
+            artifacts: [],
+            metadata: {
+                fromAgent: message?.metadata?.fromAgent || "unknown",
+            },
+        };
+        this.tasks.set(taskId, task);
+        this.logger.info(`[a2a] Task ${taskId} received from ${task.metadata?.fromAgent}`);
+        // Process asynchronously
+        this.processTask(task);
+        return this.success(rpcId, task);
+    }
+    async processTask(task) {
+        task.status = { state: "working", timestamp: new Date().toISOString() };
+        const textParts = task.messages
+            .flatMap((m) => m.parts || [])
+            .filter((p) => p.kind === "text")
+            .map((p) => p.text)
+            .join("\n");
+        // Write task to workspace for OpenClaw agent to process
+        try {
+            const fs = await import("fs");
+            const taskDir = this.config.workspacePath
+                || `${process.env.HOME || homedir()}/.openclaw/workspace/memory`;
+            if (!fs.existsSync(taskDir)) {
+                fs.mkdirSync(taskDir, { recursive: true });
+            }
+            const taskFile = `${taskDir}/a2a-task-${task.id}.md`;
+            const content = [
+                "# A2A Task",
+                "",
+                `**From:** ${task.metadata?.fromAgent}`,
+                `**Task ID:** ${task.id}`,
+                `**Time:** ${new Date().toISOString()}`,
+                "",
+                "## Message",
+                "",
+                textParts,
+                "",
+            ].join("\n");
+            fs.writeFileSync(taskFile, content);
+            task.artifacts.push({
+                kind: "artifact",
+                artifactId: randomUUID(),
+                parts: [{ kind: "text", text: `Task queued: ${taskFile}` }],
+            });
+            task.status = {
+                state: "completed",
+                timestamp: new Date().toISOString(),
+            };
+            this.logger.info(`[a2a] Task ${task.id} completed`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            task.status = {
+                state: "failed",
+                timestamp: new Date().toISOString(),
+                message: {
+                    role: "agent",
+                    parts: [{ kind: "text", text: msg }],
+                },
+            };
+            this.logger.error(`[a2a] Task ${task.id} failed: ${msg}`);
+        }
+    }
+    handleGetTask(params, rpcId) {
+        const task = this.tasks.get(params?.id);
+        if (!task)
+            return this.error(rpcId, 404, "Task not found");
+        return this.success(rpcId, task);
+    }
+    handleListTasks(rpcId) {
+        const allTasks = Array.from(this.tasks.values()).sort((a, b) => new Date(b.status.timestamp).getTime() -
+            new Date(a.status.timestamp).getTime());
+        return this.success(rpcId, { tasks: allTasks, nextPageToken: "" });
+    }
+    handleCancelTask(params, rpcId) {
+        const task = this.tasks.get(params?.id);
+        if (!task)
+            return this.error(rpcId, 404, "Task not found");
+        if (["completed", "failed", "canceled"].includes(task.status.state)) {
+            return this.error(rpcId, 409, "Task not cancelable");
+        }
+        task.status = { state: "canceled", timestamp: new Date().toISOString() };
+        return this.success(rpcId, task);
+    }
+    /** Send a task to a peer agent via A2A protocol */
+    async sendTask(targetAgent, messageText) {
+        const targetUrl = this.config.peers[targetAgent];
+        if (!targetUrl) {
+            throw new Error(`Unknown peer: ${targetAgent}. Known peers: ${Object.keys(this.config.peers).join(", ")}`);
+        }
+        const payload = {
+            jsonrpc: "2.0",
+            method: "message/send",
+            id: randomUUID(),
+            params: {
+                message: {
+                    kind: "message",
+                    messageId: randomUUID(),
+                    role: "user",
+                    parts: [{ kind: "text", text: messageText }],
+                    metadata: { fromAgent: this.config.agentName },
+                },
+            },
+        };
+        const response = await fetch(`${targetUrl}/a2a/jsonrpc`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(payload),
+        });
+        return (await response.json());
+    }
+    /** Discover all peer agents */
+    async discoverPeers() {
+        const results = {};
+        for (const [name, url] of Object.entries(this.config.peers)) {
+            try {
+                const r = await fetch(`${url}/.well-known/agent-card.json`, {
+                    signal: AbortSignal.timeout(3000),
+                });
+                results[name] = { status: "online", card: (await r.json()) };
+            }
+            catch {
+                results[name] = { status: "offline" };
+            }
+        }
+        return results;
+    }
+    success(id, result) {
+        return { jsonrpc: "2.0", id, result };
+    }
+    error(id, code, message) {
+        return { jsonrpc: "2.0", id, error: { code, message } };
+    }
+    start() {
+        this.tryListen(this.config.port);
+    }
+    tryListen(port, attempt = 1) {
+        const maxAttempts = 3;
+        try {
+            const srv = this.app.listen(port, "0.0.0.0", () => {
+                this.logger.info(`[a2a] ${this.config.agentName} server on port ${port}`);
+                // Update agent card URL to reflect actual port
+                this.agentCard.url = `http://localhost:${port}/a2a/jsonrpc`;
+            });
+            srv.on("error", (err) => {
+                if (err.code === "EADDRINUSE" && attempt < maxAttempts) {
+                    const nextPort = port + 1;
+                    this.logger.info(`[a2a] Port ${port} in use, trying ${nextPort}`);
+                    this.tryListen(nextPort, attempt + 1);
+                }
+                else if (err.code === "EADDRINUSE") {
+                    this.logger.error(`[a2a] Ports ${this.config.port}-${port} all in use, giving up`);
+                }
+                else {
+                    this.logger.error(`[a2a] Server error: ${err.message}`);
+                }
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            this.logger.error(`[a2a] Failed to start server: ${msg}`);
+        }
+    }
+    getExpressApp() {
+        return this.app;
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,78 @@
+/** A2A Protocol types (v0.3.0) */
+export interface AgentCard {
+    name: string;
+    description: string;
+    protocolVersion: string;
+    version: string;
+    url: string;
+    skills: AgentSkill[];
+    capabilities: {
+        pushNotifications: boolean;
+    };
+    defaultInputModes: string[];
+    defaultOutputModes: string[];
+}
+export interface AgentSkill {
+    id: string;
+    name: string;
+    description: string;
+    tags: string[];
+}
+export interface Part {
+    kind: "text" | "file" | "data";
+    text?: string;
+    mimeType?: string;
+    data?: unknown;
+}
+export interface Message {
+    kind: "message";
+    messageId: string;
+    role: "user" | "agent";
+    parts: Part[];
+    contextId?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface TaskStatus {
+    state: "submitted" | "working" | "completed" | "failed" | "canceled";
+    timestamp: string;
+    message?: Partial<Message>;
+}
+export interface Artifact {
+    kind: "artifact";
+    artifactId: string;
+    parts: Part[];
+}
+export interface Task {
+    kind: "task";
+    id: string;
+    contextId: string;
+    status: TaskStatus;
+    messages: Message[];
+    artifacts: Artifact[];
+    metadata?: Record<string, unknown>;
+}
+export interface JsonRpcRequest {
+    jsonrpc: "2.0";
+    method: string;
+    params: Record<string, unknown>;
+    id: string;
+}
+export interface JsonRpcResponse {
+    jsonrpc: "2.0";
+    id: string;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+    };
+}
+export interface PeerConfig {
+    [agentName: string]: string;
+}
+export interface A2APluginConfig {
+    agentName: string;
+    port: number;
+    skills: AgentSkill[];
+    peers: PeerConfig;
+}
+//# sourceMappingURL=types.d.ts.map