@perkos/perkos-a2a 0.8.35 → 0.9.0

package/dist/hermes-cli.js

@@ -0,0 +1,120 @@
+#!/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)
+ */
+import { createHermesPlugin } from "./hermes-plugin.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-hermes — A2A bridge with Hermes API delivery preset.
+
+Required:
+  --agent-name <name>       Or A2A_AGENT_NAME
+
+Common flags:
+  --port <n>                A2A HTTP port (default 5060)
+  --bind-host <host>        0.0.0.0 (default) or 127.0.0.1
+  --public-url <url>        Advertised base URL
+  --relay-url <wss>         Transport relay URL (A2A_RELAY_URL)
+  --relay-key <key>         Transport relay API key (A2A_RELAY_API_KEY)
+  --hermes-url <url>        Hermes API base URL (HERMES_API_URL)
+  --hermes-endpoint <path>  Hermes API endpoint (HERMES_API_ENDPOINT)
+  --hermes-token <token>    Hermes API bearer token (HERMES_API_KEY)
+  --hermes-session <key>    Hermes session key (default a2a)
+  --info                    Print resolved config + exit (no server boot)
+  -h, --help
+
+This is the Hermes-flavoured sibling of \`perkos-a2a-agent\`. For full
+config control, use \`perkos-a2a-agent --config a2a.config.json\`.
+`);
+}
+function resolveConfig() {
+    const agentName = argValue("--agent-name") || process.env.A2A_AGENT_NAME;
+    if (!agentName) {
+        console.error("perkos-a2a-hermes: --agent-name (or A2A_AGENT_NAME) is required\n");
+        printHelp();
+        process.exit(2);
+    }
+    const port = Number(argValue("--port") || process.env.A2A_PORT || 5060);
+    if (!Number.isFinite(port) || port <= 0) {
+        console.error(`perkos-a2a-hermes: invalid port ${argValue("--port")}`);
+        process.exit(2);
+    }
+    const relayUrl = argValue("--relay-url") || process.env.A2A_RELAY_URL;
+    const relayKey = argValue("--relay-key") || process.env.A2A_RELAY_API_KEY;
+    const relay = relayUrl && relayKey
+        ? { url: relayUrl, apiKey: relayKey, enabled: true }
+        : undefined;
+    return {
+        agentName,
+        port,
+        bindHost: argValue("--bind-host") || process.env.A2A_BIND_HOST,
+        publicUrl: argValue("--public-url") || process.env.A2A_PUBLIC_URL,
+        relay,
+        hermes: {
+            url: argValue("--hermes-url") || process.env.HERMES_API_URL,
+            endpoint: argValue("--hermes-endpoint") || process.env.HERMES_API_ENDPOINT,
+            sessionKey: argValue("--hermes-session") || process.env.A2A_HERMES_SESSION || "a2a",
+            token: argValue("--hermes-token") || process.env.HERMES_API_KEY,
+        },
+    };
+}
+async function main() {
+    if (hasFlag("-h") || hasFlag("--help")) {
+        printHelp();
+        return;
+    }
+    const config = resolveConfig();
+    const plugin = createHermesPlugin(config);
+    if (hasFlag("--info")) {
+        const info = plugin.info();
+        console.log(JSON.stringify({ ...info, relayConfigured: Boolean(config.relay) }, null, 2));
+        return;
+    }
+    await plugin.start();
+    process.on("SIGINT", async () => {
+        await plugin.stop();
+        process.exit(0);
+    });
+    process.on("SIGTERM", async () => {
+        await plugin.stop();
+        process.exit(0);
+    });
+    console.log(`[perkos-a2a/hermes] running as ${config.agentName} on port ${config.port ?? 5060}`);
+}
+main().catch((err) => {
+    console.error("[perkos-a2a/hermes] fatal:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=hermes-cli.js.map

package/dist/hermes-cli.js.map

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

package/dist/hermes-plugin.d.ts

@@ -0,0 +1,91 @@
+/**
+ * PerkOS A2A — Hermes native plugin (parity with the OpenClaw plugin).
+ *
+ * The OpenClaw integration is a plugin loaded directly by the OpenClaw
+ * runtime (`openclaw plugins install @perkos/perkos-a2a`). Hermes doesn't
+ * load OpenClaw plugins, so its native integration is the standalone
+ * `perkos-a2a-agent` bridge that delivers inbound tasks into the Hermes
+ * API Server (`POST /v1/responses` by default).
+ *
+ * This module exposes the bridge as a programmatic API so Hermes — or
+ * any other host that can `import()` ESM — can embed it without spawning
+ * a subprocess. The lifecycle shape matches OpenClaw's `registerService`
+ * contract (`start()` / `stop()` / `info()`) so the two integrations
+ * feel the same from a deploy standpoint.
+ *
+ * Usage from Hermes (or any embedding host):
+ *
+ *   import { createHermesPlugin } from "@perkos/perkos-a2a/hermes";
+ *   const plugin = createHermesPlugin({
+ *     agentName: "Apollo",
+ *     port: 5060,
+ *     relay: { url: "wss://transport.perkos.xyz/a2a", apiKey: "…", enabled: true },
+ *     hermes: { url: "http://127.0.0.1:8642", endpoint: "/v1/responses" },
+ *   });
+ *   await plugin.start();
+ *
+ * The same bridge is also runnable as a CLI:
+ *
+ *   perkos-a2a-hermes --agent-name Apollo --port 5060 \
+ *     --relay-url wss://transport.perkos.xyz/a2a \
+ *     --relay-key "$A2A_RELAY_API_KEY"
+ */
+import type { AgentSkill, PeerConfig } from "./types.js";
+type Logger = {
+    info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+};
+export type HermesPluginConfig = {
+    agentName: string;
+    /** Local port the A2A HTTP server binds to. Default 5060. */
+    port?: number;
+    /** Bind host. Default 0.0.0.0. */
+    bindHost?: string;
+    /** Externally reachable URL advertised in the Agent Card. */
+    publicUrl?: string;
+    /** Skills surfaced on the Agent Card. */
+    skills?: AgentSkill[];
+    /** Peer agent name → base URL map. */
+    peers?: PeerConfig;
+    /** PerkOS-Transport relay config. */
+    relay?: {
+        url: string;
+        apiKey: string;
+        enabled?: boolean;
+    };
+    /** Hermes API Server delivery target. */
+    hermes?: {
+        /** Default: http://127.0.0.1:8642 */
+        url?: string;
+        /** Default: /v1/responses */
+        endpoint?: string;
+        /** Default: a2a */
+        sessionKey?: string;
+        /** Optional bearer token for the Hermes API. */
+        token?: string;
+    };
+    /** Logger to use. Defaults to console-prefixed. */
+    logger?: Logger;
+};
+export type HermesPluginHandle = {
+    start: () => Promise<void>;
+    stop: () => Promise<void>;
+    info: () => {
+        agentName: string;
+        port: number;
+        runtime: "hermes-api";
+        relayConnected: boolean;
+        hermesUrl: string;
+        hermesEndpoint: string;
+    };
+};
+/**
+ * Create a Hermes-native A2A plugin instance.
+ *
+ * Symmetric to OpenClaw's `register(api)` entry, but driven by a
+ * direct config object rather than the OpenClaw plugin host API.
+ */
+export declare function createHermesPlugin(config: HermesPluginConfig): HermesPluginHandle;
+export {};
+//# sourceMappingURL=hermes-plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hermes-plugin.d.ts","sourceRoot":"","sources":["../src/hermes-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAKH,OAAO,KAAK,EAAmB,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE1E,KAAK,MAAM,GAAG;IACZ,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACrC,CAAC;AAQF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,sCAAsC;IACtC,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,qCAAqC;IACrC,KAAK,CAAC,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,yCAAyC;IACzC,MAAM,CAAC,EAAE;QACP,qCAAqC;QACrC,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,6BAA6B;QAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,mBAAmB;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,gDAAgD;QAChD,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,EAAE,MAAM;QACV,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,YAAY,CAAC;QACtB,cAAc,EAAE,OAAO,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH,CAAC;AAqEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,CAyFjF"}

package/dist/hermes-plugin.js

@@ -0,0 +1,196 @@
+/**
+ * PerkOS A2A — Hermes native plugin (parity with the OpenClaw plugin).
+ *
+ * The OpenClaw integration is a plugin loaded directly by the OpenClaw
+ * runtime (`openclaw plugins install @perkos/perkos-a2a`). Hermes doesn't
+ * load OpenClaw plugins, so its native integration is the standalone
+ * `perkos-a2a-agent` bridge that delivers inbound tasks into the Hermes
+ * API Server (`POST /v1/responses` by default).
+ *
+ * This module exposes the bridge as a programmatic API so Hermes — or
+ * any other host that can `import()` ESM — can embed it without spawning
+ * a subprocess. The lifecycle shape matches OpenClaw's `registerService`
+ * contract (`start()` / `stop()` / `info()`) so the two integrations
+ * feel the same from a deploy standpoint.
+ *
+ * Usage from Hermes (or any embedding host):
+ *
+ *   import { createHermesPlugin } from "@perkos/perkos-a2a/hermes";
+ *   const plugin = createHermesPlugin({
+ *     agentName: "Apollo",
+ *     port: 5060,
+ *     relay: { url: "wss://transport.perkos.xyz/a2a", apiKey: "…", enabled: true },
+ *     hermes: { url: "http://127.0.0.1:8642", endpoint: "/v1/responses" },
+ *   });
+ *   await plugin.start();
+ *
+ * The same bridge is also runnable as a CLI:
+ *
+ *   perkos-a2a-hermes --agent-name Apollo --port 5060 \
+ *     --relay-url wss://transport.perkos.xyz/a2a \
+ *     --relay-key "$A2A_RELAY_API_KEY"
+ */
+import { A2AServer } from "./server.js";
+import { completeTaskWithReply, generateRuntimeReply } from "./runtime-reply.js";
+import { tryHandleAgenticTask } from "./agentic-actions.js";
+const defaultLogger = {
+    info: (...args) => console.log("[perkos-a2a/hermes]", ...args),
+    warn: (...args) => console.warn("[perkos-a2a/hermes]", ...args),
+    error: (...args) => console.error("[perkos-a2a/hermes]", ...args),
+};
+function buildPluginConfig(cfg) {
+    const hermes = cfg.hermes ?? {};
+    return {
+        agentName: cfg.agentName,
+        port: cfg.port ?? 5060,
+        bindHost: cfg.bindHost ?? "0.0.0.0",
+        publicUrl: cfg.publicUrl,
+        skills: cfg.skills ?? [],
+        peers: cfg.peers ?? {},
+        mode: "client-only",
+        runtime: {
+            kind: "hermes-api",
+            sessionKey: hermes.sessionKey ?? "a2a",
+            hermesUrl: hermes.url,
+            hermesEndpoint: hermes.endpoint,
+            hermesToken: hermes.token,
+        },
+        relay: cfg.relay
+            ? {
+                url: cfg.relay.url,
+                apiKey: cfg.relay.apiKey,
+                enabled: cfg.relay.enabled !== false,
+            }
+            : undefined,
+    };
+}
+async function deliverToHermes(cfg, message, logger) {
+    const runtime = cfg.runtime || {};
+    const baseUrl = (runtime.hermesUrl || "http://127.0.0.1:8642").replace(/\/+$/, "");
+    const endpoint = runtime.hermesEndpoint || "/v1/responses";
+    const sessionKey = runtime.sessionKey || "a2a";
+    const token = runtime.hermesToken;
+    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}`;
+    // Match the format used by the standalone bridge (src/agent.ts).
+    const normalizedEndpoint = endpoint.replace(/^\/?/, "/");
+    const body = normalizedEndpoint.startsWith("/v1/chat/completions")
+        ? { model: "hermes-agent", messages: [{ role: "user", content: message }], stream: false }
+        : normalizedEndpoint.startsWith("/v1/runs")
+            ? { input: message, session_id: sessionKey }
+            : normalizedEndpoint.startsWith("/v1/responses")
+                ? { 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}`);
+    }
+    logger.info(`Delivered inbound A2A task to Hermes session ${sessionKey} via ${url}`);
+}
+/**
+ * Create a Hermes-native A2A plugin instance.
+ *
+ * Symmetric to OpenClaw's `register(api)` entry, but driven by a
+ * direct config object rather than the OpenClaw plugin host API.
+ */
+export function createHermesPlugin(config) {
+    if (!config.agentName)
+        throw new Error("createHermesPlugin: agentName is required");
+    const logger = config.logger ?? defaultLogger;
+    const pluginConfig = buildPluginConfig(config);
+    const server = new A2AServer(pluginConfig, logger);
+    server.setTaskResultHandler(async (task, text) => {
+        const marker = `[A2A_RESULT:${task.id}]`;
+        const from = task.metadata?.fromAgent || "unknown";
+        const eventText = [
+            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}`,
+            "",
+            text,
+        ].join("\n");
+        task.status = {
+            state: "working",
+            timestamp: new Date().toISOString(),
+            message: {
+                role: "agent",
+                parts: [{ kind: "text", text: "Task dispatched to Hermes runtime." }],
+            },
+        };
+        const handledAgentically = await tryHandleAgenticTask({
+            selfName: pluginConfig.agentName,
+            server,
+            task,
+            text,
+            logger,
+            runtimeResponder: (prompt, m) => generateRuntimeReply(pluginConfig, prompt, m),
+        }).catch((err) => {
+            logger.error(`agentic task handler failed: ${err instanceof Error ? err.message : String(err)}`);
+            return false;
+        });
+        if (handledAgentically)
+            return;
+        try {
+            await deliverToHermes(pluginConfig, eventText, logger);
+            const final = await generateRuntimeReply(pluginConfig, text, marker);
+            completeTaskWithReply(task, final);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.warn(`Hermes API delivery failed; falling back to PerkOS LLM: ${msg}`);
+            const final = await generateRuntimeReply(pluginConfig, text, marker);
+            completeTaskWithReply(task, final);
+        }
+    });
+    server.setTaskFailureHandler(async (task, errorText) => {
+        task.status = {
+            state: "failed",
+            timestamp: new Date().toISOString(),
+            message: { role: "agent", parts: [{ kind: "text", text: errorText }] },
+        };
+    });
+    let started = false;
+    return {
+        async start() {
+            if (started)
+                return;
+            server.start();
+            started = true;
+            logger.info(`A2A server started for ${pluginConfig.agentName} on :${pluginConfig.port}`);
+        },
+        async stop() {
+            if (!started)
+                return;
+            // A2AServer doesn't expose stop() directly today; closing the relay
+            // socket is the meaningful signal we can offer until that lands.
+            started = false;
+            logger.info(`A2A server stop requested for ${pluginConfig.agentName}`);
+        },
+        info() {
+            return {
+                agentName: pluginConfig.agentName,
+                port: pluginConfig.port,
+                runtime: "hermes-api",
+                relayConnected: server.isRelayConnected(),
+                hermesUrl: pluginConfig.runtime?.hermesUrl || "http://127.0.0.1:8642",
+                hermesEndpoint: pluginConfig.runtime?.hermesEndpoint || "/v1/responses",
+            };
+        },
+    };
+}
+//# sourceMappingURL=hermes-plugin.js.map

package/dist/hermes-plugin.js.map

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

package/dist/index.d.ts

@@ -10,6 +10,8 @@
 export { A2AServer, detectNetworking } from "./server.js";
 export { RelayHub } from "./relay.js";
 export { RelayClient } from "./relay-client.js";
+export { ChatClient } from "./chat-client.js";
+export { ChatStore } from "./chat-store.js";
 export * from "./types.js";
 export default function register(api: any): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,cAAc,YAAY,CAAC;AA0E3B,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,GAAG,QA8hBxC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,cAAc,YAAY,CAAC;AAiF3B,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,GAAG,QA2vBxC"}