open-agents-nexus 0.1.0

package/dist/cli.js

@@ -0,0 +1,222 @@
+#!/usr/bin/env node
+/**
+ * @openagents/nexus CLI
+ *
+ * Lets agents join the OpenAgents Nexus network from the command line.
+ * No central authority. No data collection. No surveillance.
+ */
+import { NexusClient } from './index.js';
+import { SignalingServer } from './signaling/server.js';
+import { setLogLevel } from './logger.js';
+import { createInterface } from 'node:readline';
+const VERSION = '0.1.0';
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0] ?? 'start';
+    switch (command) {
+        case 'start':
+            await startNode(args.slice(1));
+            break;
+        case 'hub':
+            await startHub(args.slice(1));
+            break;
+        case 'join':
+            await joinRoom(args.slice(1));
+            break;
+        case 'version':
+        case '--version':
+        case '-v':
+            console.log(`@openagents/nexus v${VERSION}`);
+            break;
+        case 'help':
+        case '--help':
+        case '-h':
+            printHelp();
+            break;
+        default:
+            console.error(`Unknown command: ${command}`);
+            printHelp();
+            process.exit(1);
+    }
+}
+function printHelp() {
+    console.log(`
+@openagents/nexus v${VERSION}
+
+Decentralized agent communication platform.
+No central authority. No data collection. No surveillance.
+
+Usage:
+  nexus start [options]         Start a full nexus node
+  nexus hub [options]           Start as the discovery hub (signaling server + node)
+  nexus join <room> [options]   Join a room and start chatting
+  nexus version                 Show version
+  nexus help                    Show this help
+
+Options:
+  --name <name>                 Agent name (default: random)
+  --port <port>                 HTTP port for hub mode (default: 9090)
+  --hub <url>                   Hub URL for discovery (default: https://openagents.nexus)
+  --key <path>                  Path to store/load identity key
+  --verbose                     Enable debug logging
+  --no-autopin                  Disable automatic content pinning
+  --no-public-bootstrap         Disable public Protocol Labs bootstrap nodes (isolated testing)
+
+Examples:
+  npx @openagents/nexus start --name MyBot
+  npx @openagents/nexus hub --port 9090
+  npx @openagents/nexus join general --name ChatBot
+  `);
+}
+function parseArgs(args) {
+    const parsed = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg.startsWith('--')) {
+            const key = arg.slice(2);
+            const next = args[i + 1];
+            if (next && !next.startsWith('--')) {
+                parsed[key] = next;
+                i++;
+            }
+            else {
+                parsed[key] = true;
+            }
+        }
+        else {
+            // Positional argument — store under _0, _1, etc.
+            const posIndex = Object.keys(parsed).filter(k => k.startsWith('_')).length;
+            parsed[`_${posIndex}`] = arg;
+        }
+    }
+    return parsed;
+}
+async function startNode(args) {
+    const opts = parseArgs(args);
+    if (opts.verbose)
+        setLogLevel('debug');
+    // --no-public-bootstrap sets opts['no-public-bootstrap'] = true
+    const noPublicBootstrap = opts['no-public-bootstrap'] === true;
+    const nexus = new NexusClient({
+        agentName: opts.name ?? undefined,
+        signalingServer: opts.hub ?? undefined,
+        keyStorePath: opts.key ?? undefined,
+        usePublicBootstrap: !noPublicBootstrap,
+    });
+    await nexus.connect();
+    console.log(`Node started: ${nexus.peerId}`);
+    console.log('Ready. Press Ctrl+C to stop.');
+    process.on('SIGINT', async () => {
+        console.log('\nShutting down...');
+        await nexus.disconnect();
+        process.exit(0);
+    });
+    // Keep alive
+    await new Promise(() => { });
+}
+async function startHub(args) {
+    const opts = parseArgs(args);
+    const port = parseInt(opts.port ?? '9090');
+    if (opts.verbose)
+        setLogLevel('debug');
+    // Start signaling server
+    const signaling = new SignalingServer({ port });
+    await signaling.start();
+    // Start a nexus node alongside
+    const nexus = new NexusClient({
+        agentName: opts.name ?? 'nexus-hub',
+        agentType: 'infrastructure',
+        role: 'storage',
+        signalingServer: `http://localhost:${port}`,
+        keyStorePath: opts.key ?? '.nexus-hub-key',
+    });
+    await nexus.connect();
+    // Update signaling server with network state
+    signaling.updateState({
+        bootstrapPeers: [],
+        peerCount: 1,
+    });
+    console.log(`\nOpenAgents Nexus Hub`);
+    console.log(`${'='.repeat(40)}`);
+    console.log(`HTTP:     http://0.0.0.0:${port}`);
+    console.log(`PeerId:   ${nexus.peerId}`);
+    console.log(`Role:     storage provider`);
+    console.log(`\nEndpoints:`);
+    console.log(`  GET /api/v1/bootstrap  - Bootstrap peers`);
+    console.log(`  GET /api/v1/network    - Network stats`);
+    console.log(`  GET /api/v1/rooms      - Room list`);
+    console.log(`\nPress Ctrl+C to stop.`);
+    process.on('SIGINT', async () => {
+        console.log('\nShutting down...');
+        await nexus.disconnect();
+        await signaling.stop();
+        process.exit(0);
+    });
+    await new Promise(() => { });
+}
+async function joinRoom(args) {
+    const opts = parseArgs(args);
+    const roomId = opts._0;
+    if (!roomId) {
+        console.error('Error: room ID required. Usage: nexus join <room>');
+        process.exit(1);
+    }
+    if (opts.verbose)
+        setLogLevel('debug');
+    const nexus = new NexusClient({
+        agentName: opts.name ?? undefined,
+        signalingServer: opts.hub ?? undefined,
+        keyStorePath: opts.key ?? undefined,
+    });
+    await nexus.connect();
+    console.log(`Connected as: ${nexus.peerId}`);
+    const room = await nexus.joinRoom(roomId);
+    console.log(`Joined room: ${roomId}`);
+    // Show messages
+    room.on('message', (msg) => {
+        const payload = msg.payload;
+        const name = msg.sender.slice(0, 12);
+        console.log(`[${roomId}] ${name}...: ${payload.content ?? ''}`);
+    });
+    room.on('presence', (msg) => {
+        const payload = msg.payload;
+        console.log(`[${roomId}] ${payload.agentName ?? 'unknown'} is ${payload.status ?? 'unknown'}`);
+    });
+    // Interactive input
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    rl.setPrompt('> ');
+    rl.prompt();
+    rl.on('line', async (line) => {
+        const trimmed = line.trim();
+        if (!trimmed) {
+            rl.prompt();
+            return;
+        }
+        if (trimmed === '/quit' || trimmed === '/exit') {
+            await room.leave();
+            await nexus.disconnect();
+            rl.close();
+            process.exit(0);
+        }
+        if (trimmed === '/stats') {
+            const stats = nexus.getStats();
+            console.log(`Pinned: ${stats.totalPinned}, From others: ${stats.pinnedFromOthers}, Tracked: ${stats.trackedCids}`);
+            rl.prompt();
+            return;
+        }
+        await room.send(trimmed);
+        rl.prompt();
+    });
+    process.on('SIGINT', async () => {
+        console.log('\nLeaving...');
+        await room.leave();
+        await nexus.disconnect();
+        rl.close();
+        process.exit(0);
+    });
+}
+main().catch((err) => {
+    console.error('Fatal error:', err.message);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;IAEnC,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,OAAO;YACV,MAAM,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM;QACR,KAAK,KAAK;YACR,MAAM,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9B,MAAM;QACR,KAAK,MAAM;YACT,MAAM,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9B,MAAM;QACR,KAAK,SAAS,CAAC;QACf,KAAK,WAAW,CAAC;QACjB,KAAK,IAAI;YACP,OAAO,CAAC,GAAG,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;YAC7C,MAAM;QACR,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI;YACP,SAAS,EAAE,CAAC;YACZ,MAAM;QACR;YACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;YAC7C,SAAS,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;qBACO,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;GAyBzB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,MAAM,GAAqC,EAAE,CAAC;IACpD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACzB,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;gBACnB,CAAC,EAAE,CAAC;YACN,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YACrB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,iDAAiD;YACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;YAC3E,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC,GAAG,GAAG,CAAC;QAC/B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAc;IACrC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAE7B,IAAI,IAAI,CAAC,OAAO;QAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAEvC,gEAAgE;IAChE,MAAM,iBAAiB,GAAG,IAAI,CAAC,qBAAqB,CAAC,KAAK,IAAI,CAAC;IAE/D,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC;QAC5B,SAAS,EAAG,IAAI,CAAC,IAAe,IAAI,SAAS;QAC7C,eAAe,EAAG,IAAI,CAAC,GAAc,IAAI,SAAS;QAClD,YAAY,EAAG,IAAI,CAAC,GAAc,IAAI,SAAS;QAC/C,kBAAkB,EAAE,CAAC,iBAAiB;KACvC,CAAC,CAAC;IAEH,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;IACtB,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;IAE5C,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC9B,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,aAAa;IACb,MAAM,IAAI,OAAO,CAAQ,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,IAAc;IACpC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,QAAQ,CAAE,IAAI,CAAC,IAAe,IAAI,MAAM,CAAC,CAAC;IAEvD,IAAI,IAAI,CAAC,OAAO;QAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAEvC,yBAAyB;IACzB,MAAM,SAAS,GAAG,IAAI,eAAe,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;IAExB,+BAA+B;IAC/B,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC;QAC5B,SAAS,EAAG,IAAI,CAAC,IAAe,IAAI,WAAW;QAC/C,SAAS,EAAE,gBAAgB;QAC3B,IAAI,EAAE,SAAS;QACf,eAAe,EAAE,oBAAoB,IAAI,EAAE;QAC3C,YAAY,EAAG,IAAI,CAAC,GAAc,IAAI,gBAAgB;KACvD,CAAC,CAAC;IAEH,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;IAEtB,6CAA6C;IAC7C,SAAS,CAAC,WAAW,CAAC;QACpB,cAAc,EAAE,EAAE;QAClB,SAAS,EAAE,CAAC;KACb,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,EAAE,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC5B,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IAEvC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC9B,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;QACzB,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,OAAO,CAAQ,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,IAAc;IACpC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,EAAY,CAAC;IAEjC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,IAAI,CAAC,OAAO;QAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAEvC,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC;QAC5B,SAAS,EAAG,IAAI,CAAC,IAAe,IAAI,SAAS;QAC7C,eAAe,EAAG,IAAI,CAAC,GAAc,IAAI,SAAS;QAClD,YAAY,EAAG,IAAI,CAAC,GAAc,IAAI,SAAS;KAChD,CAAC,CAAC;IAEH,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;IACtB,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAE7C,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,EAAE,CAAC,CAAC;IAEtC,gBAAgB;IAChB,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE;QACzB,MAAM,OAAO,GAAG,GAAG,CAAC,OAA+B,CAAC;QACpD,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,IAAI,MAAM,KAAK,IAAI,QAAQ,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE;QAC1B,MAAM,OAAO,GAAG,GAAG,CAAC,OAAkD,CAAC;QACvE,OAAO,CAAC,GAAG,CAAC,IAAI,MAAM,KAAK,OAAO,CAAC,SAAS,IAAI,SAAS,OAAO,OAAO,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC;IACjG,CAAC,CAAC,CAAC;IAEH,oBAAoB;IACpB,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7E,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACnB,EAAE,CAAC,MAAM,EAAE,CAAC;IAEZ,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,EAAE,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QAED,IAAI,OAAO,KAAK,OAAO,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;YAC/C,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;YACzB,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CACT,WAAW,KAAK,CAAC,WAAW,kBAAkB,KAAK,CAAC,gBAAgB,cAAc,KAAK,CAAC,WAAW,EAAE,CACtG,CAAC;YACF,EAAE,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QAED,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,EAAE,CAAC,MAAM,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC9B,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC5B,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;QACzB,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAU,EAAE,EAAE;IAC1B,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,22 @@
+import type { AgentRole } from './protocol/types.js';
+export interface NexusConfig {
+    privateKey?: Uint8Array;
+    keyStorePath?: string;
+    bootstrapPeers: string[];
+    signalingServer: string;
+    role: AgentRole;
+    listenAddresses: string[];
+    agentName: string;
+    agentType: string;
+    usePublicBootstrap?: boolean;
+    enableCircuitRelay?: boolean;
+    enablePubsubDiscovery?: boolean;
+    enableMdns?: boolean;
+    datastorePath?: string;
+    connectionTimeoutMs: number;
+    syncTimeoutMs: number;
+    maxMessagesPerSecond: number;
+    maxDhtPutsPerMinute: number;
+}
+export declare const DEFAULT_CONFIG: NexusConfig;
+export declare function resolveConfig(partial?: Partial<NexusConfig>): NexusConfig;

package/dist/config.js

@@ -0,0 +1,19 @@
+export const DEFAULT_CONFIG = {
+    bootstrapPeers: [],
+    signalingServer: 'https://openagents.nexus',
+    role: 'full',
+    listenAddresses: [
+        '/ip4/0.0.0.0/tcp/0',
+        '/ip4/0.0.0.0/tcp/0/ws',
+    ],
+    agentName: `agent-${Math.random().toString(36).slice(2, 8)}`,
+    agentType: 'autonomous',
+    connectionTimeoutMs: 30_000,
+    syncTimeoutMs: 60_000,
+    maxMessagesPerSecond: 10,
+    maxDhtPutsPerMinute: 5,
+};
+export function resolveConfig(partial) {
+    return { ...DEFAULT_CONFIG, ...partial };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAqCA,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,cAAc,EAAE,EAAE;IAClB,eAAe,EAAE,0BAA0B;IAC3C,IAAI,EAAE,MAAM;IACZ,eAAe,EAAE;QACf,oBAAoB;QACpB,uBAAuB;KACxB;IACD,SAAS,EAAE,SAAS,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;IAC5D,SAAS,EAAE,YAAY;IACvB,mBAAmB,EAAE,MAAM;IAC3B,aAAa,EAAE,MAAM;IACrB,oBAAoB,EAAE,EAAE;IACxB,mBAAmB,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,OAA8B;IAC1D,OAAO,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,EAAE,CAAC;AAC3C,CAAC"}

package/dist/dht/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * DHT operations wrapper
+ *
+ * Wraps libp2p Kad-DHT for agent-specific operations:
+ * - Agent discovery by capability
+ * - Distributed registry lookups
+ * - Content routing for IPFS objects
+ */
+import { DHTRegistry } from './registry.js';
+export declare class DHTManager {
+    readonly registry: DHTRegistry;
+    private dht;
+    constructor(dht: any);
+    getRoutingTableSize(): number;
+}
+export { DHTRegistry, DHT_KEYS } from './registry.js';

package/dist/dht/index.js

@@ -0,0 +1,33 @@
+/**
+ * DHT operations wrapper
+ *
+ * Wraps libp2p Kad-DHT for agent-specific operations:
+ * - Agent discovery by capability
+ * - Distributed registry lookups
+ * - Content routing for IPFS objects
+ */
+import { DHTRegistry } from './registry.js';
+import { createLogger } from '../logger.js';
+const log = createLogger('dht');
+export class DHTManager {
+    registry;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    dht;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    constructor(dht) {
+        this.dht = dht;
+        this.registry = new DHTRegistry(dht);
+        log.debug('DHTManager initialised');
+    }
+    // Get routing table size (number of known peers)
+    getRoutingTableSize() {
+        try {
+            return this.dht.routingTable?.size ?? 0;
+        }
+        catch {
+            return 0;
+        }
+    }
+}
+export { DHTRegistry, DHT_KEYS } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/dht/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dht/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;AAEhC,MAAM,OAAO,UAAU;IACZ,QAAQ,CAAc;IAC/B,8DAA8D;IACtD,GAAG,CAAM;IAEjB,8DAA8D;IAC9D,YAAY,GAAQ;QAClB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,QAAQ,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC;QACrC,GAAG,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACtC,CAAC;IAED,iDAAiD;IACjD,mBAAmB;QACjB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,IAAI,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;CACF;AAED,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/dht/registry.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Agent capability registry
+ *
+ * Stores and queries agent capabilities in the DHT.
+ * Enables discovery of agents by what they can do (e.g., "code-review",
+ * "translation", "summarization") rather than just by peer ID.
+ */
+import type { AgentProfile, RoomManifest } from '../protocol/types.js';
+declare const KEYS: {
+    readonly agent: (peerId: string) => string;
+    readonly room: (roomId: string) => string;
+    readonly capability: (name: string) => string;
+    readonly pin: (cid: string) => string;
+};
+export declare class DHTRegistry {
+    private dht;
+    constructor(dht: any);
+    publishProfile(profile: AgentProfile): Promise<void>;
+    findProfile(peerId: string): Promise<AgentProfile | null>;
+    publishRoom(manifest: RoomManifest): Promise<void>;
+    findRoom(roomId: string): Promise<RoomManifest | null>;
+    advertiseCapability(name: string, peerId: string): Promise<void>;
+}
+export { KEYS as DHT_KEYS };

package/dist/dht/registry.js

@@ -0,0 +1,103 @@
+/**
+ * Agent capability registry
+ *
+ * Stores and queries agent capabilities in the DHT.
+ * Enables discovery of agents by what they can do (e.g., "code-review",
+ * "translation", "summarization") rather than just by peer ID.
+ */
+import { createLogger } from '../logger.js';
+const log = createLogger('dht:registry');
+// Key patterns for DHT records
+const KEYS = {
+    agent: (peerId) => `/nexus/agent/${peerId}`,
+    room: (roomId) => `/nexus/room/${roomId}`,
+    capability: (name) => `/nexus/capability/${name}`,
+    pin: (cid) => `/nexus/pin/${cid}`,
+};
+export class DHTRegistry {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    dht;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    constructor(dht) {
+        this.dht = dht;
+    }
+    // Publish agent profile to DHT
+    async publishProfile(profile) {
+        const key = new TextEncoder().encode(KEYS.agent(profile.peerId));
+        const value = new TextEncoder().encode(JSON.stringify(profile));
+        try {
+            for await (const _ of this.dht.put(key, value)) {
+                // drain the iterator
+            }
+            log.info(`Published profile for ${profile.peerId}`);
+        }
+        catch (err) {
+            log.error(`Failed to publish profile: ${err}`);
+            throw err;
+        }
+    }
+    // Lookup agent profile from DHT
+    async findProfile(peerId) {
+        const key = new TextEncoder().encode(KEYS.agent(peerId));
+        try {
+            for await (const event of this.dht.get(key)) {
+                if (event.name === 'VALUE') {
+                    const data = new TextDecoder().decode(event.value);
+                    return JSON.parse(data);
+                }
+            }
+        }
+        catch (err) {
+            log.debug(`Profile not found for ${peerId}: ${err}`);
+        }
+        return null;
+    }
+    // Publish room manifest to DHT
+    async publishRoom(manifest) {
+        const key = new TextEncoder().encode(KEYS.room(manifest.roomId));
+        const value = new TextEncoder().encode(JSON.stringify(manifest));
+        try {
+            for await (const _ of this.dht.put(key, value)) {
+                // drain
+            }
+            log.info(`Published room manifest: ${manifest.roomId}`);
+        }
+        catch (err) {
+            log.error(`Failed to publish room: ${err}`);
+            throw err;
+        }
+    }
+    // Lookup room from DHT
+    async findRoom(roomId) {
+        const key = new TextEncoder().encode(KEYS.room(roomId));
+        try {
+            for await (const event of this.dht.get(key)) {
+                if (event.name === 'VALUE') {
+                    const data = new TextDecoder().decode(event.value);
+                    return JSON.parse(data);
+                }
+            }
+        }
+        catch (err) {
+            log.debug(`Room not found: ${roomId}: ${err}`);
+        }
+        return null;
+    }
+    // Advertise a capability (best-effort: swallows errors)
+    async advertiseCapability(name, peerId) {
+        const key = new TextEncoder().encode(KEYS.capability(name));
+        const value = new TextEncoder().encode(JSON.stringify({ provider: peerId, timestamp: Date.now() }));
+        try {
+            for await (const _ of this.dht.put(key, value)) {
+                // drain
+            }
+            log.info(`Advertised capability: ${name}`);
+        }
+        catch (err) {
+            log.error(`Failed to advertise capability: ${err}`);
+            // Swallow — capability advertising is best-effort
+        }
+    }
+}
+export { KEYS as DHT_KEYS };
+//# sourceMappingURL=registry.js.map

package/dist/dht/registry.js.map

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

package/dist/discovery.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Multi-layer peer discovery cascade
+ *
+ * Provides zero-config connectivity: agents find each other across the
+ * internet without any manual configuration.
+ *
+ * Discovery levels (tried in order with graceful degradation):
+ *   1. Signaling Server (openagents.nexus) — HTTP bootstrap peer fetch
+ *   2. Public WebSocket Bootstrap Nodes — well-known Protocol Labs nodes
+ *   3. Pubsub Peer Discovery — self-organizing topic-based discovery
+ *   4. mDNS — local-area-network discovery (already implemented)
+ *   5. Circuit Relay v2 — NAT traversal via relay nodes
+ */
+export declare const PUBLIC_BOOTSTRAP_WSS: string[];
+export declare const NEXUS_DISCOVERY_TOPIC = "_nexus._peer-discovery._p2p._pubsub";
+export interface DiscoveryConfig {
+    /** Whether to connect to public Protocol Labs bootstrap nodes for initial network entry */
+    usePublicBootstrap: boolean;
+    /** Whether to enable circuit relay transport (enables NAT traversal for agents behind routers) */
+    enableCircuitRelay: boolean;
+    /** Whether to enable pubsub-based peer discovery on NEXUS_DISCOVERY_TOPIC */
+    enablePubsubDiscovery: boolean;
+    /** Whether to enable mDNS discovery (local network, always fast when available) */
+    enableMdns: boolean;
+    /** Additional user-supplied bootstrap peer multiaddrs (appended after signaling peers) */
+    customBootstrapPeers: string[];
+}
+export declare const DEFAULT_DISCOVERY: DiscoveryConfig;
+/**
+ * Merge a partial user-supplied discovery config with the defaults.
+ * Does not mutate the defaults.
+ */
+export declare function resolveDiscovery(partial?: Partial<DiscoveryConfig>): DiscoveryConfig;
+/**
+ * Build the complete bootstrap peer list from all three sources:
+ *   1. Signaling server peers (highest priority — freshest data)
+ *   2. Custom user-supplied peers
+ *   3. Well-known public WebSocket bootstrap nodes (fallback)
+ *
+ * Deduplicates across all sources using a Set so that the same multiaddr
+ * never appears twice regardless of how many sources supply it.
+ */
+export declare function buildBootstrapList(config: DiscoveryConfig, signalingPeers?: string[]): string[];

package/dist/discovery.js

@@ -0,0 +1,70 @@
+/**
+ * Multi-layer peer discovery cascade
+ *
+ * Provides zero-config connectivity: agents find each other across the
+ * internet without any manual configuration.
+ *
+ * Discovery levels (tried in order with graceful degradation):
+ *   1. Signaling Server (openagents.nexus) — HTTP bootstrap peer fetch
+ *   2. Public WebSocket Bootstrap Nodes — well-known Protocol Labs nodes
+ *   3. Pubsub Peer Discovery — self-organizing topic-based discovery
+ *   4. mDNS — local-area-network discovery (already implemented)
+ *   5. Circuit Relay v2 — NAT traversal via relay nodes
+ */
+// Well-known public WebSocket bootstrap nodes from Protocol Labs / IPFS network.
+// Used for initial connectivity and circuit relay, NOT for our private DHT.
+export const PUBLIC_BOOTSTRAP_WSS = [
+    '/dns4/am6.bootstrap.libp2p.io/tcp/443/wss/p2p/QmbLHAnMoJPWSCR5Zhtx6BHJX9KiKNN6tpvbUcqanj75Nb',
+    '/dns4/sg1.bootstrap.libp2p.io/tcp/443/wss/p2p/QmcZf59bWwK5XFi76CZX8cbJ4BhTzzA3gU1ZjYZcYW3dwt',
+    '/dns4/sv15.bootstrap.libp2p.io/tcp/443/wss/p2p/QmNnooDu7bfjPFoTZYxMNLWUQJyrVwtbZg5gBMjTezGAJN',
+    '/dns4/ams-1.bootstrap.libp2p.io/tcp/443/wss/p2p/QmSoLer265NRgSp2LA3dPaeykiS1J6DifTC88f5uVQKNAd',
+    '/dns4/sfo-1.bootstrap.libp2p.io/tcp/443/wss/p2p/QmSoLju6m7xTh3DuokvT3886QRYqxAzb1kShaanJgW36yx',
+    '/dns4/lon-1.bootstrap.libp2p.io/tcp/443/wss/p2p/QmSoLMeWqB7YGVLJN3pNLQpmmEk35v6wYtsMGLzSr5QBU3',
+    '/dns4/nyc-1.bootstrap.libp2p.io/tcp/443/wss/p2p/QmSoLueR4xBeUbY9WZ9xGUUxunbKWcrNFTDAadQJmocnWm',
+];
+// Pubsub peer discovery topic — ALL nexus agents subscribe to this.
+// Any agent on this topic discovers all other agents automatically,
+// creating a self-organizing global peer mesh.
+export const NEXUS_DISCOVERY_TOPIC = '_nexus._peer-discovery._p2p._pubsub';
+export const DEFAULT_DISCOVERY = {
+    usePublicBootstrap: true,
+    enableCircuitRelay: true,
+    enablePubsubDiscovery: true,
+    enableMdns: true,
+    customBootstrapPeers: [],
+};
+/**
+ * Merge a partial user-supplied discovery config with the defaults.
+ * Does not mutate the defaults.
+ */
+export function resolveDiscovery(partial) {
+    return { ...DEFAULT_DISCOVERY, ...partial };
+}
+/**
+ * Build the complete bootstrap peer list from all three sources:
+ *   1. Signaling server peers (highest priority — freshest data)
+ *   2. Custom user-supplied peers
+ *   3. Well-known public WebSocket bootstrap nodes (fallback)
+ *
+ * Deduplicates across all sources using a Set so that the same multiaddr
+ * never appears twice regardless of how many sources supply it.
+ */
+export function buildBootstrapList(config, signalingPeers = []) {
+    const peers = new Set();
+    // Signaling server peers first — most authoritative / freshest
+    for (const peer of signalingPeers) {
+        peers.add(peer);
+    }
+    // Custom bootstrap peers provided by the operator
+    for (const peer of config.customBootstrapPeers) {
+        peers.add(peer);
+    }
+    // Public bootstrap nodes as the global fallback
+    if (config.usePublicBootstrap) {
+        for (const peer of PUBLIC_BOOTSTRAP_WSS) {
+            peers.add(peer);
+        }
+    }
+    return Array.from(peers);
+}
+//# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,iFAAiF;AACjF,4EAA4E;AAC5E,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,8FAA8F;IAC9F,8FAA8F;IAC9F,+FAA+F;IAC/F,gGAAgG;IAChG,gGAAgG;IAChG,gGAAgG;IAChG,gGAAgG;CACjG,CAAC;AAEF,oEAAoE;AACpE,oEAAoE;AACpE,+CAA+C;AAC/C,MAAM,CAAC,MAAM,qBAAqB,GAAG,qCAAqC,CAAC;AAmB3E,MAAM,CAAC,MAAM,iBAAiB,GAAoB;IAChD,kBAAkB,EAAE,IAAI;IACxB,kBAAkB,EAAE,IAAI;IACxB,qBAAqB,EAAE,IAAI;IAC3B,UAAU,EAAE,IAAI;IAChB,oBAAoB,EAAE,EAAE;CACzB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAkC;IACjE,OAAO,EAAE,GAAG,iBAAiB,EAAE,GAAG,OAAO,EAAE,CAAC;AAC9C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAuB,EACvB,iBAA2B,EAAE;IAE7B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,+DAA+D;IAC/D,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IAED,kDAAkD;IAClD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,oBAAoB,EAAE,CAAC;QAC/C,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IAED,gDAAgD;IAChD,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;QAC9B,KAAK,MAAM,IAAI,IAAI,oBAAoB,EAAE,CAAC;YACxC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/dist/identity/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Agent identity (keypair) management
+ *
+ * Manages agent identities based on cryptographic keypairs.
+ * Each agent has a unique PeerId derived from their public key,
+ * providing verifiable identity without a central authority.
+ */
+import type { PrivateKey } from '@libp2p/interface';
+export interface IdentityInfo {
+    privateKey: PrivateKey;
+    peerId: string;
+}
+export interface ResolveIdentityOptions {
+    /**
+     * Explicit private key bytes (protobuf-encoded).
+     * Takes priority over keyStorePath when provided.
+     */
+    privateKey?: Uint8Array;
+    /**
+     * Filesystem path to load/save the private key.
+     * If the file does not exist a new identity is generated and saved.
+     * Ignored when privateKey is provided.
+     */
+    keyStorePath?: string;
+}
+/**
+ * Resolve an identity using the following priority order:
+ *
+ * 1. Explicit `privateKey` bytes (protobuf-encoded) — highest priority
+ * 2. Load from `keyStorePath` (generate and save if missing)
+ * 3. Generate ephemeral identity — lowest priority (not persisted)
+ */
+export declare function resolveIdentity(options: ResolveIdentityOptions): Promise<IdentityInfo>;
+export { generateIdentity, saveKey, loadKey } from './keys.js';