@perkos/perkos-a2a 0.8.35 → 0.9.1

package/dist/chat-store.js

@@ -0,0 +1,233 @@
+/**
+ * Append-only JSONL store for PerkOS chat conversations.
+ *
+ * Files live at:
+ *   <storeRoot>/<convId>/messages.jsonl
+ *   <storeRoot>/<convId>/metadata.json
+ *
+ * Privacy invariant: this is the canonical record of conversation content.
+ * The PerkOS cloud (Firestore) holds only metadata (title, participants,
+ * lastMessageAt). Bodies live exclusively here, on the agent's filesystem.
+ */
+import { createHash } from "node:crypto";
+import { createReadStream } from "node:fs";
+import { appendFile, mkdir, open, readFile, writeFile, } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+/** Sanitize a convId so it can safely become a directory name. */
+function safeConvId(convId) {
+    if (!/^[A-Za-z0-9_-]{1,128}$/.test(convId)) {
+        throw new Error(`invalid convId: ${convId}`);
+    }
+    return convId;
+}
+export class ChatStore {
+    root;
+    constructor(options = {}) {
+        this.root = options.storeRoot ?? join(homedir(), ".perkos", "conversations");
+    }
+    /** Directory for a single conversation. */
+    dirFor(convId) {
+        return join(this.root, safeConvId(convId));
+    }
+    /** Path to the JSONL log for a conv. */
+    jsonlPath(convId) {
+        return join(this.dirFor(convId), "messages.jsonl");
+    }
+    /** Path to the metadata file for a conv. */
+    metaPath(convId) {
+        return join(this.dirFor(convId), "metadata.json");
+    }
+    /** Ensure the conv directory exists. Idempotent. */
+    async ensureDir(convId) {
+        await mkdir(this.dirFor(convId), { recursive: true });
+    }
+    /**
+     * Write metadata for a conversation. Called on `channel_join` so the agent
+     * has a local record of which participants belong to a conv.
+     */
+    async writeMetadata(meta) {
+        await this.ensureDir(meta.convId);
+        await writeFile(this.metaPath(meta.convId), JSON.stringify(meta, null, 2));
+    }
+    async readMetadata(convId) {
+        try {
+            const raw = await readFile(this.metaPath(convId), "utf8");
+            return JSON.parse(raw);
+        }
+        catch (err) {
+            if (isNotFound(err))
+                return null;
+            throw err;
+        }
+    }
+    /**
+     * Append a message to the conversation log. The line written is exactly
+     * `JSON.stringify(msg) + "\n"`. The store does not validate ordering; if
+     * messages arrive out of timestamp order, that is recorded as-is.
+     */
+    async append(convId, msg) {
+        await this.ensureDir(convId);
+        await appendFile(this.jsonlPath(convId), JSON.stringify(msg) + "\n");
+    }
+    /**
+     * Read a history page, reverse-chronological. Returns messages with
+     * timestamp strictly less than `before` (if provided), up to `limit`.
+     *
+     * The output order is chronological ascending — i.e. callers can `concat`
+     * pages from oldest to newest without sorting.
+     */
+    async readPage(convId, opts) {
+        const limit = Math.max(1, Math.min(500, opts.limit));
+        const before = opts.before ?? null;
+        let lines;
+        try {
+            const raw = await readFile(this.jsonlPath(convId), "utf8");
+            lines = raw.split("\n").filter((l) => l.length > 0);
+        }
+        catch (err) {
+            if (isNotFound(err))
+                return { messages: [], hasMore: false };
+            throw err;
+        }
+        // Walk lines from newest (end) to oldest (start), collecting up to limit.
+        const collected = [];
+        let hasMore = false;
+        for (let i = lines.length - 1; i >= 0; i--) {
+            let msg;
+            try {
+                msg = JSON.parse(lines[i]);
+            }
+            catch {
+                continue;
+            }
+            if (before && msg.timestamp >= before)
+                continue;
+            if (collected.length >= limit) {
+                hasMore = true;
+                break;
+            }
+            collected.push(msg);
+        }
+        return { messages: collected.reverse(), hasMore };
+    }
+    /**
+     * Produce a tamper-evident summary of the conversation log for receipt
+     * issuance. Streams `messages.jsonl` through sha256 (followed by a
+     * separator + metadata.json content if present), so memory usage stays
+     * constant regardless of conv size.
+     *
+     * The hash is deterministic: same jsonl bytes → same hex string. A
+     * downstream verifier with the jsonl can recompute and confirm.
+     *
+     * Returns counts + first/last timestamps for the receipt manifest.
+     */
+    async computeReceipt(convId) {
+        const path = this.jsonlPath(convId);
+        // Probe existence first — createReadStream() defers ENOENT to the
+        // 'error' event, which would otherwise reject our Promise.
+        try {
+            const fd = await open(path, "r");
+            await fd.close();
+        }
+        catch (err) {
+            if (isNotFound(err))
+                return null;
+            throw err;
+        }
+        const stream = createReadStream(path, { encoding: "utf8", highWaterMark: 64 * 1024 });
+        const hash = createHash("sha256");
+        let messageCount = 0;
+        let firstMessageAt = null;
+        let lastMessageAt = null;
+        let leftover = "";
+        return new Promise((resolve, reject) => {
+            stream.on("data", (chunk) => {
+                const text = typeof chunk === "string" ? chunk : chunk.toString("utf8");
+                hash.update(text);
+                const combined = leftover + text;
+                const lines = combined.split("\n");
+                leftover = lines.pop() ?? "";
+                for (const line of lines) {
+                    if (!line)
+                        continue;
+                    messageCount++;
+                    try {
+                        const parsed = JSON.parse(line);
+                        const ts = parsed.timestamp;
+                        if (typeof ts === "string") {
+                            if (firstMessageAt === null || ts < firstMessageAt)
+                                firstMessageAt = ts;
+                            if (lastMessageAt === null || ts > lastMessageAt)
+                                lastMessageAt = ts;
+                        }
+                    }
+                    catch {
+                        /* malformed line — still counted toward hash */
+                    }
+                }
+            });
+            stream.on("end", async () => {
+                if (leftover.length > 0) {
+                    messageCount++;
+                    try {
+                        const parsed = JSON.parse(leftover);
+                        const ts = parsed.timestamp;
+                        if (typeof ts === "string") {
+                            if (firstMessageAt === null || ts < firstMessageAt)
+                                firstMessageAt = ts;
+                            if (lastMessageAt === null || ts > lastMessageAt)
+                                lastMessageAt = ts;
+                        }
+                    }
+                    catch { /* ignore */ }
+                }
+                // Fold metadata.json into the hash if present, so the receipt
+                // also commits to participant + historyHost. Use a 0x1E (record
+                // separator) byte as an unambiguous boundary.
+                try {
+                    const metaRaw = await readFile(this.metaPath(convId), "utf8");
+                    hash.update("\x1e");
+                    hash.update(metaRaw);
+                }
+                catch {
+                    /* metadata missing → still produce a receipt over the jsonl alone */
+                }
+                resolve({
+                    transcriptHash: hash.digest("hex"),
+                    hashAlgo: "sha256",
+                    messageCount,
+                    firstMessageAt,
+                    lastMessageAt,
+                });
+            });
+            stream.on("error", (err) => reject(err));
+        });
+    }
+    /**
+     * Return the number of messages in the log. Useful for tests and stats.
+     * Avoid using this on the hot path — it reads the full file.
+     */
+    async count(convId) {
+        let fd;
+        try {
+            fd = await open(this.jsonlPath(convId), "r");
+        }
+        catch (err) {
+            if (isNotFound(err))
+                return 0;
+            throw err;
+        }
+        try {
+            const raw = await fd.readFile({ encoding: "utf8" });
+            return raw.split("\n").filter((l) => l.length > 0).length;
+        }
+        finally {
+            await fd.close();
+        }
+    }
+}
+function isNotFound(err) {
+    return !!err && typeof err === "object" && err.code === "ENOENT";
+}
+//# sourceMappingURL=chat-store.js.map

package/dist/chat-store.js.map

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

package/dist/chat-types.d.ts

@@ -0,0 +1,166 @@
+/**
+ * PerkOS-Chat protocol types.
+ *
+ * Wire format spoken to `wss://chat.perkos.xyz/chat`. The chat server routes
+ * frames between users (browser, authenticated via Firebase ID token) and
+ * agents (this client, authenticated via the same relay API key issued
+ * during PerkOS-Transport pairing).
+ *
+ * Companion server: github.com/PerkOS-xyz/PerkOS-Chat
+ * Full spec: see that repo's docs/protocol.md
+ */
+/** Identity strings exchanged on the chat wire. */
+export type ChatIdentity = `user:${string}` | `agent:${string}`;
+/** A single persisted message in a conversation's jsonl. */
+export interface ChatMessage {
+    id: string;
+    from: ChatIdentity;
+    /** Message body. May be markdown. */
+    text: string;
+    /** ISO 8601 timestamp. */
+    timestamp: string;
+    /** Optional id of the message this one replies to. */
+    replyTo?: string | null;
+}
+/** Sent by this client immediately after the WS opens. */
+export interface AuthFrame {
+    type: "auth";
+    role: "agent";
+    agentName: string;
+    apiKey: string;
+}
+export interface AuthOkFrame {
+    type: "auth_ok";
+    session: {
+        agentName: string;
+        scopes: string[];
+    };
+}
+export interface AuthErrorFrame {
+    type: "auth_error";
+    code: string;
+    message: string;
+}
+/** Server → agent: a new user (or another agent) sent a message in this conv. */
+export interface ChatDeliverFrame {
+    type: "chat_deliver";
+    id: string;
+    convId: string;
+    from: ChatIdentity;
+    text: string;
+    timestamp: string;
+}
+/** Server → agent: another agent posted in a multi-participant channel. */
+export interface ChatMessageInboundFrame {
+    type: "chat_message";
+    id: string;
+    convId: string;
+    from: ChatIdentity;
+    text: string;
+    replyTo?: string | null;
+    timestamp: string;
+}
+/** Agent → server: reply to a conv. The server broadcasts as `chat_message`. */
+export interface ChatReplyFrame {
+    type: "chat_reply";
+    id?: string;
+    convId: string;
+    /** Required: tells the server which wallet's conv tree to look up. */
+    walletAddress: string;
+    text: string;
+    replyTo?: string | null;
+}
+/** Server → agent: please serve a history page. */
+export interface HistoryRequestFrame {
+    type: "history_request";
+    id: string;
+    convId: string;
+    forWallet: string;
+    /** ISO timestamp — return messages strictly older than this. */
+    before?: string | null;
+    limit: number;
+}
+/** Agent → server: history chunk response. */
+export interface HistoryChunkFrame {
+    type: "history_chunk";
+    id: string;
+    convId: string;
+    forWallet: string;
+    messages: ChatMessage[];
+    hasMore: boolean;
+}
+/** Server → agent: heads-up that this agent is now a participant in a conv. */
+export interface ChannelJoinFrame {
+    type: "channel_join";
+    convId: string;
+    participants: ChatIdentity[];
+    historyHost: ChatIdentity;
+}
+export interface TypingFrame {
+    type: "typing";
+    convId: string;
+    /** When echoed by the server, this is populated. */
+    from?: ChatIdentity;
+    state: "start" | "stop";
+}
+export interface AckFrame {
+    type: "ack";
+    id: string;
+    convId: string;
+    delivered: number;
+    timestamp: string;
+}
+/** Server → agent: please compute a tamper-evident hash of this conv. */
+export interface ReceiptRequestFrame {
+    type: "receipt_request";
+    id: string;
+    convId: string;
+    /** Wallet that the receipt is being issued for. */
+    forWallet: string;
+}
+/** Agent → server: hash + metadata. Server routes back to the wallet. */
+export interface ReceiptResponseFrame {
+    type: "receipt_response";
+    id: string;
+    convId: string;
+    forWallet: string;
+    /** sha256 hex of the canonical jsonl + metadata.json. */
+    transcriptHash: string;
+    hashAlgo: "sha256";
+    messageCount: number;
+    firstMessageAt: string | null;
+    lastMessageAt: string | null;
+    /** ISO timestamp the agent produced the hash. */
+    generatedAt: string;
+}
+export interface ChatErrorFrame {
+    type: "error";
+    code: string;
+    message: string;
+}
+export interface PingFrame {
+    type: "ping";
+}
+export interface PongFrame {
+    type: "pong";
+    ts: string;
+}
+export type ChatFrame = AuthFrame | AuthOkFrame | AuthErrorFrame | ChatDeliverFrame | ChatMessageInboundFrame | ChatReplyFrame | HistoryRequestFrame | HistoryChunkFrame | ChannelJoinFrame | TypingFrame | AckFrame | ChatErrorFrame | ReceiptRequestFrame | ReceiptResponseFrame | PingFrame | PongFrame;
+export interface ChatConfig {
+    /** Whether the chat client should connect at startup. Default: false. */
+    enabled: boolean;
+    /** WebSocket URL. Default: wss://chat.perkos.xyz/chat. */
+    url: string;
+    /** Relay API key for this agent (same key used for PerkOS-Transport pairing). */
+    apiKey: string;
+    /** Root directory for the JSONL stores. Default: ~/.perkos/conversations. */
+    storeRoot?: string;
+    /** Maximum messages returned per history page. Default: 50. */
+    defaultHistoryLimit?: number;
+    /** Reconnect floor/ceiling in ms. Defaults: 1000 / 60000. */
+    minReconnectMs?: number;
+    maxReconnectMs?: number;
+    /** Heartbeat interval ms. Default: 25000. */
+    heartbeatIntervalMs?: number;
+}
+//# sourceMappingURL=chat-types.d.ts.map

package/dist/chat-types.d.ts.map

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

package/dist/chat-types.js

@@ -0,0 +1,13 @@
+/**
+ * PerkOS-Chat protocol types.
+ *
+ * Wire format spoken to `wss://chat.perkos.xyz/chat`. The chat server routes
+ * frames between users (browser, authenticated via Firebase ID token) and
+ * agents (this client, authenticated via the same relay API key issued
+ * during PerkOS-Transport pairing).
+ *
+ * Companion server: github.com/PerkOS-xyz/PerkOS-Chat
+ * Full spec: see that repo's docs/protocol.md
+ */
+export {};
+//# sourceMappingURL=chat-types.js.map

package/dist/chat-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-types.js","sourceRoot":"","sources":["../src/chat-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

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"}

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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"}