@rookdaemon/agora 0.1.0

package/dist/transport/http.js

@@ -0,0 +1,99 @@
+import { createEnvelope, verifyEnvelope } from '../message/envelope.js';
+/**
+ * Send a signed envelope to a peer via HTTP webhook.
+ * Creates the envelope, signs it, and POSTs to the peer's /hooks/agent endpoint.
+ * Returns the HTTP status code.
+ */
+export async function sendToPeer(config, peerPublicKey, type, payload, inReplyTo) {
+    // Look up peer config
+    const peer = config.peers.get(peerPublicKey);
+    if (!peer) {
+        return { ok: false, status: 0, error: 'Unknown peer' };
+    }
+    // Create and sign the envelope
+    const envelope = createEnvelope(type, config.identity.publicKey, config.identity.privateKey, payload, inReplyTo);
+    // Encode envelope as base64url
+    const envelopeJson = JSON.stringify(envelope);
+    const envelopeBase64 = Buffer.from(envelopeJson).toString('base64url');
+    // Construct webhook payload
+    const webhookPayload = {
+        message: `[AGORA_ENVELOPE]${envelopeBase64}`,
+        name: 'Agora',
+        sessionKey: `agora:${envelope.sender.substring(0, 16)}`,
+        deliver: false,
+    };
+    // Send HTTP POST
+    try {
+        const response = await fetch(`${peer.url}/agent`, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${peer.token}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(webhookPayload),
+        });
+        return {
+            ok: response.ok,
+            status: response.status,
+            error: response.ok ? undefined : await response.text(),
+        };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            status: 0,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+/**
+ * Decode and verify an inbound Agora envelope from a webhook message.
+ * Expects the message to start with [AGORA_ENVELOPE] followed by base64.
+ * Returns the verified envelope or an error.
+ */
+export function decodeInboundEnvelope(message, knownPeers) {
+    // Check for AGORA_ENVELOPE prefix
+    const prefix = '[AGORA_ENVELOPE]';
+    if (!message.startsWith(prefix)) {
+        return { ok: false, reason: 'not_agora_message' };
+    }
+    // Extract base64 payload
+    const base64Payload = message.substring(prefix.length);
+    // Check for empty payload
+    if (!base64Payload) {
+        return { ok: false, reason: 'invalid_base64' };
+    }
+    // Decode base64
+    let envelopeJson;
+    try {
+        const decoded = Buffer.from(base64Payload, 'base64url');
+        // Check if decoded buffer is empty or contains invalid data
+        if (decoded.length === 0) {
+            return { ok: false, reason: 'invalid_base64' };
+        }
+        envelopeJson = decoded.toString('utf-8');
+    }
+    catch {
+        return { ok: false, reason: 'invalid_base64' };
+    }
+    // Parse JSON
+    let envelope;
+    try {
+        envelope = JSON.parse(envelopeJson);
+    }
+    catch {
+        return { ok: false, reason: 'invalid_json' };
+    }
+    // Verify envelope integrity
+    const verification = verifyEnvelope(envelope);
+    if (!verification.valid) {
+        return { ok: false, reason: verification.reason || 'verification_failed' };
+    }
+    // Check if sender is a known peer
+    const senderKnown = knownPeers.has(envelope.sender);
+    if (!senderKnown) {
+        return { ok: false, reason: 'unknown_sender' };
+    }
+    return { ok: true, envelope };
+}
+//# sourceMappingURL=http.js.map

package/dist/transport/http.js.map

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

package/dist/transport/peer-config.d.ts

@@ -0,0 +1,33 @@
+export interface PeerConfigFile {
+    identity: {
+        publicKey: string;
+        privateKey: string;
+    };
+    peers: Record<string, {
+        url: string;
+        token: string;
+        publicKey: string;
+        name?: string;
+    }>;
+}
+/**
+ * Load peer configuration from a JSON file.
+ * @param path - Path to the config file
+ * @returns The parsed configuration
+ * @throws Error if file doesn't exist or contains invalid JSON
+ */
+export declare function loadPeerConfig(path: string): PeerConfigFile;
+/**
+ * Save peer configuration to a JSON file.
+ * @param path - Path to the config file
+ * @param config - The configuration to save
+ */
+export declare function savePeerConfig(path: string, config: PeerConfigFile): void;
+/**
+ * Initialize peer configuration, generating a new keypair if the file doesn't exist.
+ * If the file exists, loads and returns it.
+ * @param path - Path to the config file
+ * @returns The configuration (loaded or newly created)
+ */
+export declare function initPeerConfig(path: string): PeerConfigFile;
+//# sourceMappingURL=peer-config.d.ts.map

package/dist/transport/peer-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-config.d.ts","sourceRoot":"","sources":["../../src/transport/peer-config.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;QACpB,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAG3D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAGzE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAc3D"}

package/dist/transport/peer-config.js

@@ -0,0 +1,41 @@
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { generateKeyPair } from '../identity/keypair.js';
+/**
+ * Load peer configuration from a JSON file.
+ * @param path - Path to the config file
+ * @returns The parsed configuration
+ * @throws Error if file doesn't exist or contains invalid JSON
+ */
+export function loadPeerConfig(path) {
+    const content = readFileSync(path, 'utf-8');
+    return JSON.parse(content);
+}
+/**
+ * Save peer configuration to a JSON file.
+ * @param path - Path to the config file
+ * @param config - The configuration to save
+ */
+export function savePeerConfig(path, config) {
+    const content = JSON.stringify(config, null, 2);
+    writeFileSync(path, content, 'utf-8');
+}
+/**
+ * Initialize peer configuration, generating a new keypair if the file doesn't exist.
+ * If the file exists, loads and returns it.
+ * @param path - Path to the config file
+ * @returns The configuration (loaded or newly created)
+ */
+export function initPeerConfig(path) {
+    if (existsSync(path)) {
+        return loadPeerConfig(path);
+    }
+    // Generate new keypair and create initial config
+    const identity = generateKeyPair();
+    const config = {
+        identity,
+        peers: {},
+    };
+    savePeerConfig(path, config);
+    return config;
+}
+//# sourceMappingURL=peer-config.js.map

package/dist/transport/peer-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-config.js","sourceRoot":"","sources":["../../src/transport/peer-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAezD;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAmB,CAAC;AAC/C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,MAAsB;IACjE,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAChD,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACxC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,iDAAiD;IACjD,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;IACnC,MAAM,MAAM,GAAmB;QAC7B,QAAQ;QACR,KAAK,EAAE,EAAE;KACV,CAAC;IAEF,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@rookdaemon/agora",
+  "version": "0.1.0",
+  "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",
+    "@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"
+  }
+}