@rookdaemon/agora 0.1.5 → 0.2.1

package/dist/service.js

@@ -0,0 +1,132 @@
+import { getDefaultConfigPath, loadAgoraConfigAsync } from './config.js';
+import { RelayClient } from './relay/client.js';
+import { decodeInboundEnvelope, sendToPeer } from './transport/http.js';
+/**
+ * High-level Agora service: send by peer name, decode inbound, relay lifecycle.
+ */
+export class AgoraService {
+    config;
+    relayClient = null;
+    relayMessageHandler = null;
+    logger;
+    relayClientFactory;
+    constructor(config, logger, relayClientFactory) {
+        this.config = config;
+        this.logger = logger ?? null;
+        this.relayClientFactory = relayClientFactory ?? null;
+    }
+    /**
+     * Send a signed message to a named peer.
+     */
+    async sendMessage(options) {
+        const peer = this.config.peers.get(options.peerName);
+        if (!peer) {
+            return {
+                ok: false,
+                status: 0,
+                error: `Unknown peer: ${options.peerName}`,
+            };
+        }
+        const transportConfig = {
+            identity: {
+                publicKey: this.config.identity.publicKey,
+                privateKey: this.config.identity.privateKey,
+            },
+            peers: new Map([[peer.publicKey, peer]]),
+        };
+        return sendToPeer(transportConfig, peer.publicKey, options.type, options.payload, options.inReplyTo);
+    }
+    /**
+     * Decode and verify an inbound envelope from a webhook message.
+     */
+    async decodeInbound(message) {
+        const peersByPubKey = new Map();
+        for (const peer of this.config.peers.values()) {
+            peersByPubKey.set(peer.publicKey, peer);
+        }
+        const result = decodeInboundEnvelope(message, peersByPubKey);
+        if (result.ok) {
+            return { ok: true, envelope: result.envelope };
+        }
+        return { ok: false, reason: result.reason };
+    }
+    getPeers() {
+        return Array.from(this.config.peers.keys());
+    }
+    getPeerConfig(name) {
+        return this.config.peers.get(name);
+    }
+    /**
+     * Connect to the relay server.
+     */
+    async connectRelay(url) {
+        if (this.relayClient) {
+            return;
+        }
+        const maxReconnectDelay = this.config.relay?.reconnectMaxMs ?? 300000;
+        const name = this.config.identity.name ?? this.config.relay?.name;
+        const opts = {
+            relayUrl: url,
+            publicKey: this.config.identity.publicKey,
+            privateKey: this.config.identity.privateKey,
+            name,
+            pingInterval: 30000,
+            maxReconnectDelay,
+        };
+        if (this.relayClientFactory) {
+            this.relayClient = this.relayClientFactory(opts);
+        }
+        else {
+            this.relayClient = new RelayClient(opts);
+        }
+        this.relayClient.on('error', (error) => {
+            this.logger?.debug(`Agora relay error: ${error.message}`);
+        });
+        this.relayClient.on('message', (envelope) => {
+            if (this.relayMessageHandler) {
+                this.relayMessageHandler(envelope);
+            }
+        });
+        try {
+            await this.relayClient.connect();
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.logger?.debug(`Agora relay connect failed (${url}): ${message}`);
+            this.relayClient = null;
+        }
+    }
+    setRelayMessageHandler(handler) {
+        this.relayMessageHandler = handler;
+    }
+    async disconnectRelay() {
+        if (this.relayClient) {
+            this.relayClient.disconnect();
+            this.relayClient = null;
+        }
+    }
+    isRelayConnected() {
+        return this.relayClient?.connected() ?? false;
+    }
+    /**
+     * Load Agora configuration and return service config (peers as Map).
+     */
+    static async loadConfig(path) {
+        const configPath = path ?? getDefaultConfigPath();
+        const loaded = await loadAgoraConfigAsync(configPath);
+        const peers = new Map();
+        for (const [name, p] of Object.entries(loaded.peers)) {
+            peers.set(name, {
+                publicKey: p.publicKey,
+                url: p.url,
+                token: p.token,
+            });
+        }
+        return {
+            identity: loaded.identity,
+            peers,
+            relay: loaded.relay,
+        };
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Get a short display version of a public key using the last 8 characters.
+ * Ed25519 public keys all share the same OID prefix, so the last 8 characters
+ * are more distinguishable than the first 8.
+ *
+ * @param publicKey - The full public key hex string
+ * @returns The last 8 characters of the key followed by "..."
+ */
+export declare function shortKey(publicKey: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/utils.js

@@ -0,0 +1,12 @@
+/**
+ * Get a short display version of a public key using the last 8 characters.
+ * Ed25519 public keys all share the same OID prefix, so the last 8 characters
+ * are more distinguishable than the first 8.
+ *
+ * @param publicKey - The full public key hex string
+ * @returns The last 8 characters of the key followed by "..."
+ */
+export function shortKey(publicKey) {
+    return publicKey.slice(-8) + "...";
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,SAAiB;IACxC,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AACrC,CAAC"}

package/package.json

@@ -1 +1,43 @@
-{"name":"@rookdaemon/agora","version":"0.1.5","description":"A coordination network for AI agents","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","bin":{"agora":"./dist/cli.js"},"scripts":{"build":"tsc","test":"node --import tsx --test test/*.test.ts","lint":"eslint src test --ext .ts","prepublishOnly":"npm run lint && npm run build && npm test"},"files":["dist","README.md","LICENSE"],"keywords":["agent","coordination","distributed","p2p"],"author":"","license":"MIT","devDependencies":{"@types/node":"^25.1.0","@types/ws":"^8.18.1","@typescript-eslint/eslint-plugin":"^8.54.0","@typescript-eslint/parser":"^8.54.0","eslint":"^9.39.2","tsx":"^4.21.0","typescript":"^5.9.3"},"dependencies":{"ws":"^8.19.0"}}
+{
+  "name": "@rookdaemon/agora",
+  "version": "0.2.1",
+  "description": "A coordination network for AI agents",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "agora": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "node --import tsx --test test/*.test.ts",
+    "lint": "eslint src test --ext .ts",
+    "prepublishOnly": "npm run lint && npm run build && npm test",
+    "pretest": "npm run build"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "agent",
+    "coordination",
+    "distributed",
+    "p2p"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^25.1.0",
+    "@types/ws": "^8.18.1",
+    "@typescript-eslint/eslint-plugin": "^8.54.0",
+    "@typescript-eslint/parser": "^8.54.0",
+    "eslint": "^9.39.2",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "ws": "^8.19.0"
+  }
+}