open-agents-nexus 0.2.0 → 0.3.0

package/dist/config.d.ts

@@ -12,6 +12,8 @@ export interface NexusConfig {
     enableCircuitRelay?: boolean;
     enablePubsubDiscovery?: boolean;
     enableMdns?: boolean;
+    useDnsaddr?: boolean;
+    useTcpBootstrap?: boolean;
     datastorePath?: string;
     connectionTimeoutMs: number;
     syncTimeoutMs: number;

package/dist/config.js.map

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

@@ -1,43 +1,82 @@
 /**
- * Multi-layer peer discovery cascade
+ * Multi-layer peer discovery cascade with comprehensive free fallbacks
  *
- * Provides zero-config connectivity: agents find each other across the
- * internet without any manual configuration.
+ * Agents find each other across the internet with zero configuration.
+ * Every discovery method is free, public, and requires no accounts.
  *
- * 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
+ * Discovery levels (all active simultaneously, graceful degradation):
+ *
+ *   Level 1: Signaling Server (openagents.nexus)
+ *     → HTTP fetch for bootstrap peers from the nexus hub
+ *     → Fails gracefully if hub is down
+ *
+ *   Level 2: Public WebSocket Bootstrap Nodes (Protocol Labs + IPFS)
+ *     → 15+ well-known nodes across 3 continents
+ *     → Both /dns4/.../wss and /dnsaddr/ formats for maximum compatibility
+ *     → These are free public infrastructure maintained by Protocol Labs
+ *
+ *   Level 3: Pubsub Peer Discovery (multiple redundant topics)
+ *     → 3 discovery topics — if one is congested, others still work
+ *     → Any nexus agent on ANY topic discovers ALL others
+ *     → Self-organizing: more agents = more reliable discovery
+ *
+ *   Level 4: mDNS (LAN)
+ *     → Zero-config local network discovery
+ *     → Works without internet
+ *
+ *   Level 5: Circuit Relay v2 (NAT traversal)
+ *     → Agents behind NAT relay through public nodes
+ *     → Full/storage nodes serve as free relays for the network
+ *
+ *   Level 6: DHT Random Walk
+ *     → Once connected to ANY peer, DHT walking finds more
+ *     → Our private /nexus/kad/1.0.0 DHT self-discovers
  */
 export declare const PUBLIC_BOOTSTRAP_WSS: string[];
+export declare const PUBLIC_BOOTSTRAP_DNSADDR: string[];
+export declare const PUBLIC_BOOTSTRAP_TCP: string[];
+export declare const ALL_PUBLIC_BOOTSTRAP: string[];
 export declare const NEXUS_DISCOVERY_TOPIC = "_nexus._peer-discovery._p2p._pubsub";
+export declare const NEXUS_DISCOVERY_TOPICS: string[];
 export interface DiscoveryConfig {
-    /** Whether to connect to public Protocol Labs bootstrap nodes for initial network entry */
+    /** Connect to public Protocol Labs bootstrap nodes (free, global) */
     usePublicBootstrap: boolean;
-    /** Whether to enable circuit relay transport (enables NAT traversal for agents behind routers) */
+    /** Enable circuit relay v2 (NAT traversal via free public relays) */
     enableCircuitRelay: boolean;
-    /** Whether to enable pubsub-based peer discovery on NEXUS_DISCOVERY_TOPIC */
+    /** Enable pubsub-based peer discovery on all NEXUS_DISCOVERY_TOPICS */
     enablePubsubDiscovery: boolean;
-    /** Whether to enable mDNS discovery (local network, always fast when available) */
+    /** Enable mDNS (LAN discovery, no internet needed) */
     enableMdns: boolean;
-    /** Additional user-supplied bootstrap peer multiaddrs (appended after signaling peers) */
+    /** Use DNS-based bootstrap addresses (more resilient to IP changes) */
+    useDnsaddr: boolean;
+    /** Use TCP bootstrap nodes (server-to-server, no WSS overhead) */
+    useTcpBootstrap: boolean;
+    /** Additional user-supplied bootstrap peers */
     customBootstrapPeers: string[];
+    /** Pubsub discovery interval in ms (lower = faster discovery, more bandwidth) */
+    pubsubDiscoveryIntervalMs: number;
 }
 export declare const DEFAULT_DISCOVERY: DiscoveryConfig;
 /**
- * Merge a partial user-supplied discovery config with the defaults.
- * Does not mutate the defaults.
+ * Merge partial discovery config with defaults (does not mutate 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)
+ * Build the complete bootstrap peer list from all available sources.
+ * Sources (in priority order):
+ *   1. Signaling server peers (freshest, most relevant)
  *   2. Custom user-supplied peers
- *   3. Well-known public WebSocket bootstrap nodes (fallback)
+ *   3. Public WSS bootstrap nodes (global, free)
+ *   4. Public dnsaddr bootstrap nodes (resilient to IP changes)
+ *   5. Public TCP bootstrap nodes (server-to-server)
  *
- * Deduplicates across all sources using a Set so that the same multiaddr
- * never appears twice regardless of how many sources supply it.
+ * Deduplicates by PeerId to avoid connecting to the same node twice
+ * even when it appears with different transport multiaddrs.
  */
 export declare function buildBootstrapList(config: DiscoveryConfig, signalingPeers?: string[]): string[];
+/**
+ * Get the list of pubsub discovery topics for this node.
+ * Using multiple topics provides redundancy — if one mesh is fragmented,
+ * agents can still discover each other through the other topics.
+ */
+export declare function getDiscoveryTopics(): string[];

package/dist/discovery.js

@@ -1,70 +1,152 @@
 /**
- * Multi-layer peer discovery cascade
+ * Multi-layer peer discovery cascade with comprehensive free fallbacks
  *
- * Provides zero-config connectivity: agents find each other across the
- * internet without any manual configuration.
+ * Agents find each other across the internet with zero configuration.
+ * Every discovery method is free, public, and requires no accounts.
  *
- * 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
+ * Discovery levels (all active simultaneously, graceful degradation):
+ *
+ *   Level 1: Signaling Server (openagents.nexus)
+ *     → HTTP fetch for bootstrap peers from the nexus hub
+ *     → Fails gracefully if hub is down
+ *
+ *   Level 2: Public WebSocket Bootstrap Nodes (Protocol Labs + IPFS)
+ *     → 15+ well-known nodes across 3 continents
+ *     → Both /dns4/.../wss and /dnsaddr/ formats for maximum compatibility
+ *     → These are free public infrastructure maintained by Protocol Labs
+ *
+ *   Level 3: Pubsub Peer Discovery (multiple redundant topics)
+ *     → 3 discovery topics — if one is congested, others still work
+ *     → Any nexus agent on ANY topic discovers ALL others
+ *     → Self-organizing: more agents = more reliable discovery
+ *
+ *   Level 4: mDNS (LAN)
+ *     → Zero-config local network discovery
+ *     → Works without internet
+ *
+ *   Level 5: Circuit Relay v2 (NAT traversal)
+ *     → Agents behind NAT relay through public nodes
+ *     → Full/storage nodes serve as free relays for the network
+ *
+ *   Level 6: DHT Random Walk
+ *     → Once connected to ANY peer, DHT walking finds more
+ *     → Our private /nexus/kad/1.0.0 DHT self-discovers
  */
-// Well-known public WebSocket bootstrap nodes from Protocol Labs / IPFS network.
-// Used for initial connectivity and circuit relay, NOT for our private DHT.
+// ═══════════════════════════════════════════════════════════════════
+// PUBLIC BOOTSTRAP NODES — Free, maintained by Protocol Labs / IPFS
+// ═══════════════════════════════════════════════════════════════════
+// WebSocket Secure (WSS) bootstrap nodes — work from both Node.js and browsers
 export const PUBLIC_BOOTSTRAP_WSS = [
+    // Protocol Labs Amino DHT bootstrappers (WebSocket on port 443)
     '/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',
+    // Protocol Labs geographic bootstrap nodes (WSS)
     '/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/sfo-2.bootstrap.libp2p.io/tcp/443/wss/p2p/QmSoLnSGccFuZQJzRadHn95W2CrSFmZuTdDWP8HXaHca9z',
+    '/dns4/sfo-3.bootstrap.libp2p.io/tcp/443/wss/p2p/QmSoLPppuBtQSGwKDZT2M73ULpjvfd3aZ6ha4oFGL1KrGM',
+    '/dns4/sgp-1.bootstrap.libp2p.io/tcp/443/wss/p2p/QmSoLSafTMBsPKadTEgaXctDQVcqN88CNLHXMkTNwMKPnu',
     '/dns4/nyc-1.bootstrap.libp2p.io/tcp/443/wss/p2p/QmSoLueR4xBeUbY9WZ9xGUUxunbKWcrNFTDAadQJmocnWm',
+    '/dns4/nyc-2.bootstrap.libp2p.io/tcp/443/wss/p2p/QmSoLV4Bbm51jM9C4gDYZQ9Cy3U6aXMJDAbzgu2fzaDs64',
+];
+// DNS-based bootstrap (dnsaddr records — auto-resolve to current IPs)
+// These are more resilient than hardcoded IPs because Protocol Labs can
+// update the underlying addresses without requiring a package update.
+export const PUBLIC_BOOTSTRAP_DNSADDR = [
+    '/dnsaddr/bootstrap.libp2p.io/p2p/QmNnooDu7bfjPFoTZYxMNLWUQJyrVwtbZg5gBMjTezGAJN',
+    '/dnsaddr/bootstrap.libp2p.io/p2p/QmQCU2EcMqAqQPR2i9bChDtGNJchTbq5TbXJJ16u19uLTa',
+    '/dnsaddr/bootstrap.libp2p.io/p2p/QmbLHAnMoJPWSCR5Zhtx6BHJX9KiKNN6tpvbUcqanj75Nb',
+    '/dnsaddr/bootstrap.libp2p.io/p2p/QmcZf59bWwK5XFi76CZX8cbJ4BhTzzA3gU1ZjYZcYW3dwt',
+];
+// TCP bootstrap nodes (for server-to-server when WSS isn't needed)
+export const PUBLIC_BOOTSTRAP_TCP = [
+    '/ip4/104.131.131.82/tcp/4001/p2p/QmaCpDMGvV2BGHeYERUEnRQAwe3N8SzbUtfsmvsqQLuvuJ',
 ];
-// 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.
+// Combined: all free public bootstrap nodes
+export const ALL_PUBLIC_BOOTSTRAP = [
+    ...PUBLIC_BOOTSTRAP_WSS,
+    ...PUBLIC_BOOTSTRAP_DNSADDR,
+    ...PUBLIC_BOOTSTRAP_TCP,
+];
+// ═══════════════════════════════════════════════════════════════════
+// PUBSUB DISCOVERY TOPICS — Multiple for redundancy
+// ═══════════════════════════════════════════════════════════════════
+// Primary discovery topic — all nexus agents subscribe here
 export const NEXUS_DISCOVERY_TOPIC = '_nexus._peer-discovery._p2p._pubsub';
+// Redundant discovery topics — if one is congested or has issues, others work
+// Using multiple topics ensures agents can always find each other even if
+// some GossipSub meshes are fragmented
+export const NEXUS_DISCOVERY_TOPICS = [
+    '_nexus._peer-discovery._p2p._pubsub', // Primary
+    'nexus:agents:discovery:v1', // Alternate namespace
+    '_open-agents._nexus._discovery', // Fallback
+];
 export const DEFAULT_DISCOVERY = {
     usePublicBootstrap: true,
     enableCircuitRelay: true,
     enablePubsubDiscovery: true,
     enableMdns: true,
+    useDnsaddr: true,
+    useTcpBootstrap: true,
     customBootstrapPeers: [],
+    pubsubDiscoveryIntervalMs: 10_000,
 };
 /**
- * Merge a partial user-supplied discovery config with the defaults.
- * Does not mutate the defaults.
+ * Merge partial discovery config with defaults (does not mutate 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)
+ * Build the complete bootstrap peer list from all available sources.
+ * Sources (in priority order):
+ *   1. Signaling server peers (freshest, most relevant)
  *   2. Custom user-supplied peers
- *   3. Well-known public WebSocket bootstrap nodes (fallback)
+ *   3. Public WSS bootstrap nodes (global, free)
+ *   4. Public dnsaddr bootstrap nodes (resilient to IP changes)
+ *   5. Public TCP bootstrap nodes (server-to-server)
  *
- * Deduplicates across all sources using a Set so that the same multiaddr
- * never appears twice regardless of how many sources supply it.
+ * Deduplicates by PeerId to avoid connecting to the same node twice
+ * even when it appears with different transport multiaddrs.
  */
 export function buildBootstrapList(config, signalingPeers = []) {
     const peers = new Set();
-    // Signaling server peers first — most authoritative / freshest
+    // 1. Signaling server peers (highest priority)
     for (const peer of signalingPeers) {
         peers.add(peer);
     }
-    // Custom bootstrap peers provided by the operator
+    // 2. Custom peers
     for (const peer of config.customBootstrapPeers) {
         peers.add(peer);
     }
-    // Public bootstrap nodes as the global fallback
+    // 3. Public WSS bootstrap nodes
     if (config.usePublicBootstrap) {
         for (const peer of PUBLIC_BOOTSTRAP_WSS) {
             peers.add(peer);
         }
     }
+    // 4. DNS-based bootstrap (auto-resolving)
+    if (config.useDnsaddr) {
+        for (const peer of PUBLIC_BOOTSTRAP_DNSADDR) {
+            peers.add(peer);
+        }
+    }
+    // 5. TCP bootstrap nodes
+    if (config.useTcpBootstrap) {
+        for (const peer of PUBLIC_BOOTSTRAP_TCP) {
+            peers.add(peer);
+        }
+    }
     return Array.from(peers);
 }
+/**
+ * Get the list of pubsub discovery topics for this node.
+ * Using multiple topics provides redundancy — if one mesh is fragmented,
+ * agents can still discover each other through the other topics.
+ */
+export function getDiscoveryTopics() {
+    return [...NEXUS_DISCOVERY_TOPICS];
+}
 //# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

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

package/dist/node.js

@@ -29,7 +29,7 @@ import { ping } from '@libp2p/ping';
 import { circuitRelayTransport, circuitRelayServer } from '@libp2p/circuit-relay-v2';
 import { pubsubPeerDiscovery } from '@libp2p/pubsub-peer-discovery';
 import { msgIdFn as nexusMsgIdFn, PROTOCOLS } from './protocol/index.js';
-import { resolveDiscovery, buildBootstrapList, NEXUS_DISCOVERY_TOPIC, } from './discovery.js';
+import { resolveDiscovery, buildBootstrapList, getDiscoveryTopics, } from './discovery.js';
 import { createLogger } from './logger.js';
 const log = createLogger('node');
 /**
@@ -59,6 +59,8 @@ export async function createNexusNode(config, privateKey, discoveryConfig, signa
         enableCircuitRelay: config.enableCircuitRelay,
         enablePubsubDiscovery: config.enablePubsubDiscovery,
         enableMdns: config.enableMdns,
+        useDnsaddr: config.useDnsaddr,
+        useTcpBootstrap: config.useTcpBootstrap,
         ...discoveryConfig,
     });
     // Build the combined bootstrap peer list from all sources
@@ -74,11 +76,15 @@ export async function createNexusNode(config, privateKey, discoveryConfig, signa
         peerDiscovery.push(mdns());
     }
     if (discovery.enablePubsubDiscovery) {
+        // Subscribe to ALL discovery topics for maximum redundancy.
+        // If one mesh is fragmented, agents still find each other via the others.
+        const topics = getDiscoveryTopics();
         peerDiscovery.push(pubsubPeerDiscovery({
-            interval: 10_000, // Re-announce every 10 seconds
-            topics: [NEXUS_DISCOVERY_TOPIC],
+            interval: discovery.pubsubDiscoveryIntervalMs ?? 10_000,
+            topics,
             listenOnly: false,
         }));
+        log.info(`Pubsub discovery on ${topics.length} topics: ${topics.join(', ')}`);
     }
     // Build transport list — always include circuit relay transport so we can
     // both dial and receive relay-mediated connections.

package/dist/node.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "open-agents-nexus",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Zero-config decentralized agent-to-agent communication. Agents npm install, connect, and talk — no servers, no accounts, no surveillance. Built on libp2p + IPFS with encrypted P2P mesh networking, viral content pinning, and automatic peer discovery.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",