@perkos/perkos-a2a 0.8.34 → 0.9.0

package/README.md

@@ -2,6 +2,48 @@
 
 Agent-to-Agent (A2A) protocol plugin for [OpenClaw](https://openclaw.ai). Enables secure multi-agent communication using Google's A2A protocol specification with enterprise-grade relay infrastructure for NAT traversal.
 
+## How the agent connects
+
+This package ships in three deployment modes — same wire protocol, different runtime targets.
+
+```mermaid
+flowchart TB
+    subgraph A2A[" @perkos/perkos-a2a "]
+        Plugin["📦 OpenClaw plugin<br/>src/index.ts<br/>(auto-loads via openclaw.plugin.json)"]
+        Bridge["🌉 Standalone bridge<br/>bin/agent.ts<br/>(perkos-a2a-agent)"]
+        ChatClient["💬 ChatClient<br/>+ JSONL store + history paginator<br/>(shared across modes)"]
+    end
+
+    OpenClawRuntime["🦾 OpenClaw runtime<br/>(enqueueSystemEvent + tools)"]
+    HermesAPI["🤖 Hermes API server<br/>POST /v1/responses<br/>+ local /chat/reply listener"]
+    Custom["🛠 Custom LLM loop<br/>(any process)"]
+
+    Transport["transport.perkos.xyz/a2a<br/>A2A tasks + pairing"]
+    Chat["chat.perkos.xyz/chat<br/>conversations"]
+    Disk["~/.perkos/conversations/<br/>{convId}/messages.jsonl"]
+
+    Plugin -->|"runtime hook"| OpenClawRuntime
+    Bridge -->|"HTTP"| HermesAPI
+    Bridge -.->|"library use"| Custom
+
+    Plugin --> Transport
+    Plugin --> Chat
+    Bridge --> Transport
+    Bridge --> Chat
+
+    Plugin -.-> ChatClient
+    Bridge -.-> ChatClient
+    ChatClient --> Disk
+```
+
+**Three modes, one identity.** All three authenticate with the same `relayApiKey`
+(issued by the PerkOS MiniApp via `/api/agents/launch`, stored in Firestore
+`/agents/{name}`) and use it for both Transport and Chat:
+
+- **OpenClaw plugin** — declared in `openclaw.plugin.json`, loads automatically; tools like `perkos_a2a_send`, `perkos_chat_reply`, `perkos_chat_history` become available to the LLM.
+- **Hermes bridge** (`bin/agent.ts` → `perkos-a2a-agent`) — long-running Node process; multiplexes tasks + chat; opens `127.0.0.1:5060/chat/reply` so the Hermes side can POST replies back.
+- **Custom** — import `ChatClient` directly, wire your own LLM loop.
+
 ## 🔒 Security First
 
 **A2A communication MUST be secured.** Without authentication, anyone on your network can send tasks to your agent, potentially executing arbitrary commands.
@@ -106,6 +148,159 @@ openclaw perkos-a2a setup
 openclaw perkos-a2a status
 ```
 
+## Connect to PerkOS Transport
+
+Production PerkOS mesh traffic uses the shared relay endpoint:
+
+```txt
+wss://transport.perkos.xyz/a2a
+```
+
+Agents should connect with a **scoped relay credential** issued by the PerkOS
+pairing flow. Do not share one global relay key across production agents.
+
+### OpenClaw agent
+
+OpenClaw agents install `@perkos/perkos-a2a` as an OpenClaw plugin:
+
+```bash
+openclaw plugins install @perkos/perkos-a2a
+openclaw gateway restart
+```
+
+Then claim the PerkOS invite printed by the transport onboarding flow:
+
+```bash
+perkos-a2a-agent pair \
+  --invite https://transport.perkos.xyz/pairing/invites/inv_... \
+  --agent-name Alice \
+  --runtime openclaw \
+  --capabilities chat,code,research,tasks:receive,messages:send
+```
+
+Configure the plugin with the issued relay credential:
+
+```json
+{
+  "plugins": {
+    "entries": {
+      "perkos-a2a": {
+        "enabled": true,
+        "config": {
+          "agentName": "Alice",
+          "mode": "client-only",
+          "relay": {
+            "enabled": true,
+            "url": "wss://transport.perkos.xyz/a2a",
+            "apiKey": "<scoped-agent-relay-key>"
+          },
+          "runtime": {
+            "kind": "openclaw",
+            "sessionKey": "agent:main"
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+Restart OpenClaw and verify relay connectivity:
+
+```bash
+openclaw gateway restart
+openclaw perkos-a2a status
+```
+
+The transport service can also verify onboarding from the server side:
+
+```bash
+curl https://transport.perkos.xyz/api/agents/Alice/heartbeat
+```
+
+### Hermes agent
+
+Hermes does **not** load OpenClaw plugins directly. PerkOS ships a
+**Hermes-native plugin** with the same install ergonomics as the
+OpenClaw plugin: one install command, then a supervised service.
+
+#### Option A — one-shot service install (parity with `openclaw plugins install`)
+
+```bash
+npm install -g @perkos/perkos-a2a
+
+# Generate + activate a systemd unit (Linux) or launchd plist (macOS):
+npx -p @perkos/perkos-a2a install-hermes --write \
+  --agent-name Apollo \
+  --relay-url wss://transport.perkos.xyz/a2a \
+  --relay-key "$A2A_RELAY_API_KEY"
+
+# Linux:  sudo systemctl enable --now perkos-a2a-hermes
+# macOS:  launchctl load -w ~/Library/LaunchAgents/xyz.perkos.a2a-hermes.plist
+```
+
+The installer pre-flights the Hermes API for reachability before
+emitting the unit. Use `--emit` instead of `--write` to print the
+config to stdout for review/pipe-to-tee.
+
+#### Option B — programmatic embed
+
+Hosts that can `import()` ESM (Hermes plugin hosts, custom Node
+runtimes) embed the bridge directly:
+
+```ts
+import { createHermesPlugin } from "@perkos/perkos-a2a/hermes";
+
+const plugin = createHermesPlugin({
+  agentName: "Apollo",
+  port: 5060,
+  relay: {
+    url: "wss://transport.perkos.xyz/a2a",
+    apiKey: process.env.A2A_RELAY_API_KEY!,
+  },
+  hermes: { url: "http://127.0.0.1:8642", endpoint: "/v1/responses" },
+});
+
+await plugin.start();
+```
+
+`createHermesPlugin` returns a `{ start, stop, info }` lifecycle —
+intentionally shaped like the OpenClaw `registerService` contract so
+the two integrations feel identical to whoever ships them.
+
+#### Option C — direct CLI (long-running, no supervisor)
+
+```bash
+npm install -g @perkos/perkos-a2a
+perkos-a2a-agent pair \
+  --invite https://transport.perkos.xyz/pairing/invites/inv_... \
+  --agent-name Apollo \
+  --runtime hermes-api \
+  --capabilities chat,code,research,tasks:receive,messages:send
+
+perkos-a2a-hermes \
+  --agent-name Apollo \
+  --relay-url wss://transport.perkos.xyz/a2a \
+  --relay-key "$A2A_RELAY_API_KEY"
+```
+
+`perkos-a2a-hermes` is a thin shim over `perkos-a2a-agent` that
+presets `--runtime hermes-api` and reads Hermes config from the
+common env var names (`HERMES_API_URL`, `HERMES_API_KEY`,
+`HERMES_API_ENDPOINT`). For non-default workflows, drop down to
+`perkos-a2a-agent --config a2a.config.json`.
+
+Before connecting, validate the local Hermes API Server:
+
+```bash
+curl http://127.0.0.1:8642/health
+curl http://127.0.0.1:8642/v1/capabilities
+```
+
+A healthy bridge keeps an outbound WebSocket open to
+`wss://transport.perkos.xyz/a2a`, so Hermes agents can receive tasks behind NAT,
+Docker, or dynamic IPs without exposing inbound ports.
+
 ## Configuration Reference
 
 ```json

package/dist/agent.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * Standalone PerkOS A2A bridge.
+ *
+ * This is for runtimes that do not load OpenClaw plugins directly, especially
+ * Hermes Workspace. It runs the same A2A HTTP/relay server and delivers inbound
+ * tasks into a local runtime over that runtime's native wake/send API.
+ *
+ * Usage:
+ *   perkos-a2a-agent --config ./a2a.config.json
+ *   A2A_AGENT_NAME=hermes A2A_RUNTIME=hermes-api HERMES_API_URL=http://127.0.0.1:8642 perkos-a2a-agent
+ */
+export {};
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG"}

package/dist/agent.js

@@ -0,0 +1,363 @@
+#!/usr/bin/env node
+/**
+ * Standalone PerkOS A2A bridge.
+ *
+ * This is for runtimes that do not load OpenClaw plugins directly, especially
+ * Hermes Workspace. It runs the same A2A HTTP/relay server and delivers inbound
+ * tasks into a local runtime over that runtime's native wake/send API.
+ *
+ * Usage:
+ *   perkos-a2a-agent --config ./a2a.config.json
+ *   A2A_AGENT_NAME=hermes A2A_RUNTIME=hermes-api HERMES_API_URL=http://127.0.0.1:8642 perkos-a2a-agent
+ */
+import { readFileSync } from "fs";
+import { createHash, randomUUID } from "crypto";
+import net from "net";
+import { A2AServer } from "./server.js";
+import { completeTaskWithReply, generateRuntimeReply } from "./runtime-reply.js";
+import { tryHandleAgenticTask } from "./agentic-actions.js";
+import { buildClaimRequest, claimPairingInvite, defaultPairingPath, loadOrCreateIdentity, savePairingProfile } from "./pairing.js";
+function argValue(flag) {
+    const idx = process.argv.indexOf(flag);
+    if (idx === -1)
+        return undefined;
+    return process.argv[idx + 1];
+}
+function hasFlag(flag) {
+    return process.argv.includes(flag);
+}
+function printHelp() {
+    console.log(`PerkOS A2A standalone bridge
+
+Usage:
+  perkos-a2a-agent --config ./a2a.config.json
+  perkos-a2a-agent --setup
+  perkos-a2a-agent pair --invite https://swarm.perkos.xyz/pairing/invites/inv_... --agent-name Apollo --runtime hermes
+
+Config sources:
+  --config, -c, or A2A_CONFIG       JSON config file
+  A2A_AGENT_NAME                    Unique agent identity, e.g. Apollo-Hermes-OSX
+  A2A_PORT                          Unique local A2A port, e.g. 5060
+  A2A_BIND_HOST                     127.0.0.1 for same-host/local-only, 0.0.0.0 for containers
+  A2A_PUBLIC_URL                    Advertised base URL, e.g. http://127.0.0.1:5060
+  A2A_PEERS                         JSON map: {"Perkos-Claw-Tester":"http://127.0.0.1:5050"}
+  A2A_RELAY_ENABLED=true            Enable relay fallback/discovery
+  A2A_RELAY_URL=wss://...           Relay WebSocket URL
+  A2A_RUNTIME=hermes-api            Runtime delivery target
+  HERMES_API_URL=http://127.0.0.1:8642
+  HERMES_API_ENDPOINT=/v1/responses
+  API_SERVER_KEY=<key>
+
+Pairing:
+  pair                               Claim a system invitation and save local identity/credential
+  --invite                           Pairing invite URL ending in /pairing/invites/<inviteId>
+  --agent-name or A2A_AGENT_NAME     Agent display/registry name
+  --runtime or A2A_RUNTIME           Runtime kind: hermes-api, hermes, openclaw, custom
+  --capabilities                     Comma-separated capabilities/scopes to advertise
+  --public-url or A2A_PUBLIC_URL     Optional direct A2A public URL
+  --pairing-store                    Optional credential file path; defaults to ~/.perkos/a2a/agents/<agent>.json
+
+Same-host / same-IP rule:
+  IP address is transport only, not identity. If multiple agents share one macOS/LAN/public IP,
+  distinguish them by agentName + unique port. Prefer loopback peer URLs such as
+  http://127.0.0.1:<peer-port> for direct same-host routing; use relay by agentName as fallback.
+`);
+}
+async function isPortAvailable(port, host) {
+    return new Promise((resolve) => {
+        const srv = net.createServer();
+        srv.once("error", () => resolve(false));
+        srv.listen(port, host, () => srv.close(() => resolve(true)));
+    });
+}
+async function printSetup(config) {
+    const bindHost = config.bindHost || "0.0.0.0";
+    const port = config.port || 5050;
+    const loopbackUrl = `http://127.0.0.1:${port}/a2a/jsonrpc`;
+    const bindCheckHost = bindHost === "0.0.0.0" ? "127.0.0.1" : bindHost;
+    const portAvailable = await isPortAvailable(port, bindCheckHost);
+    console.log("PerkOS A2A setup check");
+    console.log(`Agent: ${config.agentName}`);
+    console.log(`Runtime: ${config.runtime?.kind || "hermes"}`);
+    console.log(`Bind: ${bindHost}:${port}`);
+    console.log(`Port available: ${portAvailable ? "yes" : "NO - choose a unique A2A_PORT"}`);
+    console.log(`Advertised publicUrl: ${config.publicUrl || "(not set)"}`);
+    console.log(`Local same-host URL: ${loopbackUrl}`);
+    console.log(`Relay: ${config.relay?.enabled ? "enabled" : "disabled"}${config.relay?.url ? ` (${config.relay.url})` : ""}`);
+    console.log(`Peers: ${Object.keys(config.peers || {}).join(", ") || "(none configured)"}`);
+    console.log("");
+    console.log("Same-host / same-IP guidance:");
+    console.log("- Do not identify agents by shared LAN/public IP.");
+    console.log("- Each local agent needs a unique agentName and port.");
+    console.log("- Configure direct same-host peers as http://127.0.0.1:<peer-port>.");
+    console.log("- Use relay for fallback/discovery by agentName when direct peer port is unknown.");
+    console.log("");
+    console.log("Example Apollo -> Morpheus peer map:");
+    console.log('  A2A_PEERS=\'{"Perkos-Claw-Tester":"http://127.0.0.1:5050"}\'');
+}
+function splitCsv(value, fallback = []) {
+    return value?.split(",").map((item) => item.trim()).filter(Boolean) || fallback;
+}
+function redactSecret(value, visible = 4) {
+    if (!value)
+        return "(none)";
+    if (value.length <= visible * 2)
+        return "***";
+    return `${value.slice(0, visible)}…${value.slice(-visible)}`;
+}
+function secretFingerprint(value) {
+    if (!value)
+        return "(none)";
+    return createHash("sha256").update(value).digest("hex").slice(0, 12);
+}
+function shellQuote(value) {
+    return `'${value.replace(/'/g, `'\''`)}'`;
+}
+async function runPairCommand() {
+    const inviteUrl = argValue("--invite") || process.env.A2A_PAIRING_URL;
+    if (!inviteUrl)
+        throw new Error("Missing --invite or A2A_PAIRING_URL");
+    const agentName = argValue("--agent-name") || process.env.A2A_AGENT_NAME || "agent";
+    const runtime = argValue("--runtime") || process.env.A2A_RUNTIME || "hermes";
+    const publicUrl = argValue("--public-url") || process.env.A2A_PUBLIC_URL;
+    const storePath = argValue("--pairing-store") || process.env.A2A_PAIRING_STORE || defaultPairingPath(agentName);
+    const capabilities = splitCsv(argValue("--capabilities") || process.env.A2A_CAPABILITIES, ["chat", "tasks:receive", "messages:send"]);
+    const identity = loadOrCreateIdentity(agentName, storePath);
+    const request = buildClaimRequest({ identity, runtime, capabilities, publicUrl });
+    const result = await claimPairingInvite(inviteUrl, request);
+    savePairingProfile({ identity: { ...identity, agentId: result.credential?.agentId || identity.agentId }, credential: result.credential, lastPairing: result }, storePath);
+    console.log("PerkOS A2A pairing result");
+    console.log(`Status: ${result.status}`);
+    console.log(`Invite: ${result.inviteId}`);
+    console.log(`Request: ${result.requestId}`);
+    console.log(`Stored: ${storePath}`);
+    if (result.pollUrl)
+        console.log(`Poll URL: ${result.pollUrl}`);
+    if (result.claimToken)
+        console.log(`Claim token: ${result.claimToken}`);
+    if (result.credential) {
+        console.log(`Agent ID: ${result.credential.agentId}`);
+        console.log(`System: ${result.credential.system}`);
+        console.log(`Relay: ${result.credential.relayUrl}`);
+        console.log(`Scopes: ${result.credential.scopes.join(", ") || "(none)"}`);
+        console.log(`Relay credential: saved locally (fingerprint ${secretFingerprint(result.credential.relayApiKey)}, redacted ${redactSecret(result.credential.relayApiKey)})`);
+        console.log("");
+        console.log("Credential saved. Do not paste or log the relay API key.");
+        console.log("Run bridge after exporting the stored credential from your local profile, or set A2A_RELAY_API_KEY securely via your secrets manager.");
+        console.log("Example without secrets:");
+        console.log(`A2A_AGENT_NAME=${shellQuote(result.credential.agentName)} \
+A2A_RELAY_ENABLED=true \
+A2A_RELAY_URL=${shellQuote(result.credential.relayUrl)} \
+A2A_RUNTIME=${shellQuote(runtime)} \
+perkos-a2a-agent`);
+    }
+    else {
+        console.log(result.message || "Waiting for approval in the inviting PerkOS system.");
+    }
+}
+function parseJsonEnv(name, fallback) {
+    const raw = process.env[name];
+    if (!raw)
+        return fallback;
+    try {
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`${name} must be valid JSON: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+function loadConfig() {
+    const configPath = argValue("--config") || argValue("-c") || process.env.A2A_CONFIG;
+    if (configPath) {
+        return JSON.parse(readFileSync(configPath, "utf8"));
+    }
+    const port = Number(process.env.A2A_PORT || "5050");
+    const relayEnabled = String(process.env.A2A_RELAY_ENABLED || "").toLowerCase() === "true";
+    return {
+        agentName: process.env.A2A_AGENT_NAME || "agent",
+        port,
+        bindHost: process.env.A2A_BIND_HOST || "0.0.0.0",
+        publicUrl: process.env.A2A_PUBLIC_URL,
+        mode: process.env.A2A_MODE || "auto",
+        skills: parseJsonEnv("A2A_SKILLS", []),
+        peers: parseJsonEnv("A2A_PEERS", {}),
+        peerAuth: parseJsonEnv("A2A_PEER_AUTH", {}),
+        auth: process.env.A2A_API_KEYS
+            ? { requireApiKey: true, apiKeys: process.env.A2A_API_KEYS.split(",").map((v) => v.trim()).filter(Boolean) }
+            : undefined,
+        relay: relayEnabled || process.env.A2A_RELAY_URL
+            ? {
+                enabled: relayEnabled || Boolean(process.env.A2A_RELAY_URL),
+                url: process.env.A2A_RELAY_URL || "",
+                apiKey: process.env.A2A_RELAY_API_KEY || "",
+                hubPort: process.env.A2A_RELAY_HUB_PORT ? Number(process.env.A2A_RELAY_HUB_PORT) : undefined,
+                hubApiKeys: process.env.A2A_RELAY_HUB_API_KEYS?.split(",").map((v) => v.trim()).filter(Boolean),
+            }
+            : undefined,
+        runtime: {
+            kind: process.env.A2A_RUNTIME || "hermes",
+            sessionKey: process.env.A2A_SESSION_KEY,
+            hermesUrl: process.env.HERMES_WORKSPACE_URL,
+            hermesToken: process.env.HERMES_WORKSPACE_TOKEN || process.env.HERMES_SESSION_TOKEN,
+            hermesEndpoint: process.env.HERMES_WORKSPACE_ENDPOINT,
+        },
+    };
+}
+function taskMarker(task) {
+    return `[A2A_RESULT:${task.id}]`;
+}
+function buildRuntimeMessage(task, text) {
+    const from = task.metadata?.fromAgent || "unknown";
+    const marker = taskMarker(task);
+    return [
+        marker,
+        `From: ${from}`,
+        `Task ID: ${task.id}`,
+        `Context ID: ${task.contextId}`,
+        "",
+        "Execute the following request and include the final answer in your assistant reply.",
+        `Your final answer must begin with exactly: ${marker}`,
+        "Return the useful final answer after that marker.",
+        "",
+        text,
+    ].join("\n");
+}
+async function deliverToHermes(config, message) {
+    const runtime = config.runtime || {};
+    const baseUrl = (runtime.hermesUrl || process.env.HERMES_API_URL || process.env.HERMES_WORKSPACE_URL || "http://127.0.0.1:8642").replace(/\/+$/, "");
+    const endpoint = runtime.hermesEndpoint || process.env.HERMES_API_ENDPOINT || process.env.HERMES_WORKSPACE_ENDPOINT || "/v1/responses";
+    const sessionKey = runtime.sessionKey || process.env.HERMES_SESSION_ID || process.env.HERMES_SESSION_KEY || "a2a";
+    const token = runtime.hermesToken || process.env.API_SERVER_KEY || process.env.HERMES_API_KEY || process.env.HERMES_WORKSPACE_TOKEN || process.env.HERMES_SESSION_TOKEN;
+    const url = `${baseUrl}${endpoint.startsWith("/") ? endpoint : `/${endpoint}`}`;
+    const headers = {
+        "content-type": "application/json",
+        "x-hermes-session-id": sessionKey,
+        "x-hermes-session-key": sessionKey,
+    };
+    if (token)
+        headers.authorization = `Bearer ${token}`;
+    const normalizedEndpoint = endpoint.replace(/^\/?/, "/");
+    const body = normalizedEndpoint.startsWith("/v1/chat/completions")
+        ? { model: process.env.HERMES_MODEL || "hermes-agent", messages: [{ role: "user", content: message }], stream: false }
+        : normalizedEndpoint.startsWith("/v1/runs")
+            ? { input: message, session_id: sessionKey }
+            : normalizedEndpoint.startsWith("/v1/responses")
+                ? { model: process.env.HERMES_MODEL || "hermes-agent", input: message, store: true }
+                : { sessionKey, message };
+    const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(body) });
+    if (!response.ok) {
+        const text = await response.text().catch(() => "");
+        throw new Error(`Hermes API delivery failed (${response.status}) at ${url}: ${text || response.statusText}`);
+    }
+}
+async function main() {
+    if (hasFlag("--help") || hasFlag("-h")) {
+        printHelp();
+        return;
+    }
+    if (process.argv[2] === "pair") {
+        await runPairCommand();
+        return;
+    }
+    const config = loadConfig();
+    if (hasFlag("--setup")) {
+        await printSetup(config);
+        return;
+    }
+    const logger = console;
+    const server = new A2AServer(config, logger);
+    server.setTaskResultHandler(async (task, text) => {
+        const runtimeKind = config.runtime?.kind || "hermes";
+        task.status = {
+            state: "working",
+            timestamp: new Date().toISOString(),
+            message: { role: "agent", parts: [{ kind: "text", text: `Task dispatched to ${runtimeKind} runtime.` }] },
+        };
+        const handledAgentically = await tryHandleAgenticTask({
+            selfName: config.agentName,
+            server,
+            task,
+            text,
+            logger,
+            runtimeResponder: (prompt, marker) => generateRuntimeReply(config, prompt, marker),
+        }).catch((err) => {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.error(`[perkos-a2a] Agentic task handler failed: ${msg}`);
+            return false;
+        });
+        if (handledAgentically)
+            return;
+        if ((runtimeKind === "hermes" || runtimeKind === "hermes-api")) {
+            try {
+                await deliverToHermes(config, buildRuntimeMessage(task, text));
+                server.recordRuntimeDelivery({
+                    ok: true,
+                    status: "delivered",
+                    taskId: task.id,
+                    runtimeKind,
+                    detail: "Delivered to Hermes API Server.",
+                });
+                task.artifacts.push({
+                    kind: "artifact",
+                    artifactId: randomUUID(),
+                    parts: [{ kind: "text", text: "Delivered to Hermes API Server." }],
+                });
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                logger.warn(`[perkos-a2a] Hermes API delivery unavailable; completing via PerkOS LLM fallback: ${msg}`);
+                server.recordRuntimeDelivery({
+                    ok: false,
+                    status: "failed",
+                    taskId: task.id,
+                    runtimeKind,
+                    detail: msg,
+                });
+                task.artifacts.push({
+                    kind: "artifact",
+                    artifactId: randomUUID(),
+                    parts: [{ kind: "text", text: `Hermes API delivery unavailable; completed via PerkOS LLM fallback. ${msg}` }],
+                });
+            }
+            const finalText = await generateRuntimeReply(config, text, taskMarker(task));
+            completeTaskWithReply(task, finalText);
+            return;
+        }
+        if (runtimeKind === "none") {
+            server.recordRuntimeDelivery({
+                ok: true,
+                status: "delivered",
+                taskId: task.id,
+                runtimeKind,
+                detail: "Runtime delivery disabled.",
+            });
+            task.artifacts.push({
+                kind: "artifact",
+                artifactId: randomUUID(),
+                parts: [{ kind: "text", text: "Runtime delivery disabled." }],
+            });
+            return;
+        }
+        throw new Error(`Standalone runtime '${runtimeKind}' is not supported yet. Use OpenClaw plugin mode for OpenClaw delivery.`);
+    });
+    server.setTaskFailureHandler((task, errorText) => {
+        task.status = {
+            state: "failed",
+            timestamp: new Date().toISOString(),
+            message: { role: "agent", parts: [{ kind: "text", text: errorText }] },
+        };
+    });
+    await server.start();
+    logger.info(`[perkos-a2a] standalone bridge running for ${config.agentName} (${config.runtime?.kind || "hermes"})`);
+    const stop = () => {
+        logger.info("[perkos-a2a] standalone bridge shutting down");
+        process.exit(0);
+    };
+    process.on("SIGINT", stop);
+    process.on("SIGTERM", stop);
+}
+main().catch((err) => {
+    console.error(`[perkos-a2a] standalone bridge failed: ${err instanceof Error ? err.stack || err.message : String(err)}`);
+    process.exit(1);
+});
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/hermes-cli.d.ts

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+/**
+ * perkos-a2a-hermes — opinionated CLI wrapper for Hermes deployments.
+ *
+ * Mirrors the OpenClaw "install one plugin, run it" ergonomics for
+ * Hermes users: presets the runtime to `hermes-api`, picks up the
+ * Hermes API URL/token/endpoint from the common env var names, and
+ * boots the same A2A bridge as `perkos-a2a-agent` — without requiring
+ * the operator to remember the runtime-specific flags.
+ *
+ * Usage:
+ *   perkos-a2a-hermes \
+ *     --agent-name Apollo \
+ *     --relay-url wss://transport.perkos.xyz/a2a \
+ *     --relay-key "$A2A_RELAY_API_KEY"
+ *
+ * Env vars consulted (precedence: flags > env):
+ *   A2A_AGENT_NAME           agent name
+ *   A2A_PORT                 local A2A port (default 5060)
+ *   A2A_BIND_HOST            bind host (default 0.0.0.0)
+ *   A2A_PUBLIC_URL           advertised base URL
+ *   A2A_RELAY_URL            transport WS URL
+ *   A2A_RELAY_API_KEY        transport relay API key
+ *   HERMES_API_URL           Hermes API base URL (default http://127.0.0.1:8642)
+ *   HERMES_API_ENDPOINT      Hermes API endpoint (default /v1/responses)
+ *   HERMES_API_KEY           Hermes API bearer token
+ *   A2A_HERMES_SESSION       Hermes session key (default a2a)
+ */
+export {};
+//# sourceMappingURL=hermes-cli.d.ts.map

package/dist/hermes-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes-cli.d.ts","sourceRoot":"","sources":["../src/hermes-cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG"}