open-agents-nexus 0.1.0

package/dist/identity/index.js

@@ -0,0 +1,46 @@
+/**
+ * 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 { privateKeyFromProtobuf } from '@libp2p/crypto/keys';
+import { peerIdFromPrivateKey } from '@libp2p/peer-id';
+import { generateIdentity, saveKey, loadKey } from './keys.js';
+import { createLogger } from '../logger.js';
+const log = createLogger('identity');
+/**
+ * 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 async function resolveIdentity(options) {
+    // Priority 1: Explicit private key provided as protobuf-encoded bytes
+    if (options.privateKey) {
+        const key = privateKeyFromProtobuf(options.privateKey);
+        const peerId = peerIdFromPrivateKey(key).toString();
+        log.info(`Using provided key, PeerId: ${peerId}`);
+        return { privateKey: key, peerId };
+    }
+    // Priority 2: Load from keystore path (generate + persist if missing)
+    if (options.keyStorePath) {
+        const existing = await loadKey(options.keyStorePath);
+        if (existing) {
+            const peerId = peerIdFromPrivateKey(existing).toString();
+            log.info(`Loaded existing identity: ${peerId}`);
+            return { privateKey: existing, peerId };
+        }
+        // Generate fresh identity and persist it
+        const { privateKey, peerId } = await generateIdentity();
+        await saveKey(privateKey, options.keyStorePath);
+        return { privateKey, peerId };
+    }
+    // Priority 3: Ephemeral identity — not written to disk
+    log.info('Generating ephemeral identity (not persisted)');
+    return generateIdentity();
+}
+export { generateIdentity, saveKey, loadKey } from './keys.js';
+//# sourceMappingURL=index.js.map

package/dist/identity/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/identity/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;AAqBrC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAA+B;IACnE,sEAAsE;IACtE,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,sBAAsB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;QACpD,GAAG,CAAC,IAAI,CAAC,+BAA+B,MAAM,EAAE,CAAC,CAAC;QAClD,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IACrC,CAAC;IAED,sEAAsE;IACtE,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACrD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;YACzD,GAAG,CAAC,IAAI,CAAC,6BAA6B,MAAM,EAAE,CAAC,CAAC;YAChD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAC1C,CAAC;QACD,yCAAyC;QACzC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,gBAAgB,EAAE,CAAC;QACxD,MAAM,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QAChD,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAChC,CAAC;IAED,uDAAuD;IACvD,GAAG,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;IAC1D,OAAO,gBAAgB,EAAE,CAAC;AAC5B,CAAC;AAED,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/dist/identity/keys.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Key generation and storage
+ *
+ * Handles Ed25519 keypair generation, secure storage, import/export,
+ * and key rotation for agent identities.
+ */
+import type { PrivateKey } from '@libp2p/interface';
+export interface GeneratedIdentity {
+    privateKey: PrivateKey;
+    peerId: string;
+}
+/**
+ * Generate a new Ed25519 keypair and derive a PeerId from it.
+ */
+export declare function generateIdentity(): Promise<GeneratedIdentity>;
+/**
+ * Persist a private key to the filesystem using protobuf encoding.
+ * The file is written with mode 0o600 (owner read/write only).
+ * Intermediate directories are created automatically.
+ */
+export declare function saveKey(privateKey: PrivateKey, filePath: string): Promise<void>;
+/**
+ * Load a private key from the filesystem.
+ * Returns null if the file does not exist.
+ */
+export declare function loadKey(filePath: string): Promise<PrivateKey | null>;

package/dist/identity/keys.js

@@ -0,0 +1,49 @@
+/**
+ * Key generation and storage
+ *
+ * Handles Ed25519 keypair generation, secure storage, import/export,
+ * and key rotation for agent identities.
+ */
+import { generateKeyPair, privateKeyFromProtobuf, privateKeyToProtobuf } from '@libp2p/crypto/keys';
+import { peerIdFromPrivateKey } from '@libp2p/peer-id';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { createLogger } from '../logger.js';
+const log = createLogger('identity:keys');
+/**
+ * Generate a new Ed25519 keypair and derive a PeerId from it.
+ */
+export async function generateIdentity() {
+    const privateKey = await generateKeyPair('Ed25519');
+    const peerId = peerIdFromPrivateKey(privateKey).toString();
+    log.info(`Generated new identity: ${peerId}`);
+    return { privateKey, peerId };
+}
+/**
+ * Persist a private key to the filesystem using protobuf encoding.
+ * The file is written with mode 0o600 (owner read/write only).
+ * Intermediate directories are created automatically.
+ */
+export async function saveKey(privateKey, filePath) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    const encoded = privateKeyToProtobuf(privateKey);
+    fs.writeFileSync(filePath, Buffer.from(encoded), { mode: 0o600 });
+    log.info(`Saved key to ${filePath}`);
+}
+/**
+ * Load a private key from the filesystem.
+ * Returns null if the file does not exist.
+ */
+export async function loadKey(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return null;
+    }
+    const buf = fs.readFileSync(filePath);
+    const privateKey = privateKeyFromProtobuf(new Uint8Array(buf));
+    log.info(`Loaded key from ${filePath}`);
+    return privateKey;
+}
+//# sourceMappingURL=keys.js.map

package/dist/identity/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../src/identity/keys.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,GAAG,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;AAO1C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC3D,GAAG,CAAC,IAAI,CAAC,2BAA2B,MAAM,EAAE,CAAC,CAAC;IAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,UAAsB,EAAE,QAAgB;IACpE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,MAAM,OAAO,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACjD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAClE,GAAG,CAAC,IAAI,CAAC,gBAAgB,QAAQ,EAAE,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,QAAgB;IAC5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,sBAAsB,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,GAAG,CAAC,IAAI,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;IACxC,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @openagents/nexus — Main entry point
+ *
+ * Exports the NexusClient class and the full public API for the decentralized
+ * agent communication platform.
+ */
+import { DHTManager } from './dht/index.js';
+import { StorageManager } from './storage/index.js';
+import type { AgentProfile, RoomInfo, ContributeOptions, AgentRole } from './protocol/types.js';
+import { NexusRoom } from './chat/index.js';
+export interface NexusClientOptions {
+    privateKey?: Uint8Array;
+    keyStorePath?: string;
+    bootstrapPeers?: string[];
+    signalingServer?: string;
+    role?: AgentRole;
+    listenAddresses?: string[];
+    agentName?: string;
+    agentType?: string;
+    datastorePath?: string;
+    usePublicBootstrap?: boolean;
+    enableCircuitRelay?: boolean;
+    enablePubsubDiscovery?: boolean;
+    enableMdns?: boolean;
+}
+export interface CreateRoomOptions {
+    roomId: string;
+    name: string;
+    description?: string;
+    type?: 'persistent' | 'ephemeral';
+    access?: 'public';
+}
+type NexusEventMap = {
+    'peer:discovered': string;
+    'peer:connected': string;
+    'peer:disconnected': string;
+    'error': Error;
+};
+type NexusEventListener<K extends keyof NexusEventMap> = (value: NexusEventMap[K]) => void;
+export declare class NexusClient {
+    private config;
+    private identity;
+    private node;
+    private roomManager;
+    private dhtManager;
+    private storageManager;
+    private _isConnected;
+    private listeners;
+    constructor(options?: NexusClientOptions);
+    on<K extends keyof NexusEventMap>(event: K, listener: NexusEventListener<K>): this;
+    off<K extends keyof NexusEventMap>(event: K, listener: NexusEventListener<K>): this;
+    private emit;
+    get peerId(): string;
+    get isConnected(): boolean;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    joinRoom(roomId: string): Promise<NexusRoom>;
+    createRoom(options: CreateRoomOptions): Promise<NexusRoom>;
+    listRooms(): Promise<RoomInfo[]>;
+    findAgent(peerId: string): Promise<AgentProfile | null>;
+    store(data: Uint8Array | string | object): Promise<string>;
+    retrieve(cidString: string): Promise<unknown>;
+    contribute(options: ContributeOptions): void;
+    getStats(): {
+        totalPinned: number;
+        pinnedFromOthers: number;
+        trackedCids: number;
+    };
+    private ensureConnected;
+    get network(): {
+        node: any;
+        dht: DHTManager | null;
+        storage: StorageManager;
+    };
+}
+export { NexusRoom } from './chat/index.js';
+export { SignalingServer } from './signaling/server.js';
+export { createLogger, setLogLevel } from './logger.js';
+export { resolveConfig, DEFAULT_CONFIG } from './config.js';
+export type { NexusConfig } from './config.js';
+export type { NexusMessage, AgentProfile, RoomManifest, RoomInfo, ChatPayload, PresencePayload, MetaPayload, CapabilityDefinition, ContributeOptions, MessageType, PresenceStatus, AgentRole, RoomType, ContentFormat, BootstrapResponse, NetworkResponse, } from './protocol/types.js';
+export { PROTOCOL_VERSION, PROTOCOLS, TOPICS, uuidv7, createMessage, encodeMessage, decodeMessage, roomTopic, ephemeralTopic, } from './protocol/index.js';
+export { ContentPropagation } from './storage/index.js';

package/dist/index.js

@@ -0,0 +1,299 @@
+/**
+ * @openagents/nexus — Main entry point
+ *
+ * Exports the NexusClient class and the full public API for the decentralized
+ * agent communication platform.
+ */
+import { resolveConfig } from './config.js';
+import { resolveIdentity } from './identity/index.js';
+import { createNexusNode } from './node.js';
+import { RoomManager } from './chat/index.js';
+import { createMetaMessage } from './chat/messages.js';
+import { DHTManager } from './dht/index.js';
+import { StorageManager } from './storage/index.js';
+import { fetchBootstrapPeers } from './signaling/onboarding.js';
+import { resolveDiscovery, buildBootstrapList } from './discovery.js';
+import { createLogger } from './logger.js';
+import { encodeMessage, roomTopic, TOPICS } from './protocol/index.js';
+const log = createLogger('nexus');
+// ---------------------------------------------------------------------------
+// NexusClient
+// ---------------------------------------------------------------------------
+export class NexusClient {
+    config;
+    identity = null;
+    node = null; // libp2p node
+    roomManager = null;
+    dhtManager = null;
+    storageManager;
+    _isConnected = false;
+    listeners = new Map();
+    constructor(options) {
+        this.config = resolveConfig(options);
+        this.storageManager = new StorageManager();
+    }
+    // --- Event emitter ---
+    on(event, listener) {
+        if (!this.listeners.has(event)) {
+            this.listeners.set(event, new Set());
+        }
+        this.listeners.get(event).add(listener);
+        return this;
+    }
+    off(event, listener) {
+        this.listeners.get(event)?.delete(listener);
+        return this;
+    }
+    emit(event, value) {
+        this.listeners.get(event)?.forEach(fn => fn(value));
+    }
+    // --- Properties ---
+    get peerId() {
+        if (!this.identity)
+            throw new Error('Not connected');
+        return this.identity.peerId;
+    }
+    get isConnected() {
+        return this._isConnected;
+    }
+    // --- Lifecycle ---
+    async connect() {
+        if (this._isConnected)
+            return;
+        log.info('Connecting to OpenAgents Nexus...');
+        // 1. Resolve identity
+        this.identity = await resolveIdentity({
+            privateKey: this.config.privateKey,
+            keyStorePath: this.config.keyStorePath,
+        });
+        log.info(`Identity: ${this.identity.peerId}`);
+        // 2. Fetch bootstrap peers from signaling server (Level 1 discovery cascade)
+        let signalingPeers = [];
+        try {
+            const bootstrapResponse = await fetchBootstrapPeers(this.config.signalingServer);
+            signalingPeers = bootstrapResponse.peers;
+            if (signalingPeers.length > 0) {
+                log.info(`Signaling server provided ${signalingPeers.length} bootstrap peer(s)`);
+            }
+        }
+        catch (err) {
+            log.warn(`Could not reach signaling server: ${err}`);
+            // Continue — lower-level discovery (public bootstrap / mDNS) will handle connectivity
+        }
+        // Build the discovery config from NexusConfig fields
+        const discovery = resolveDiscovery({
+            usePublicBootstrap: this.config.usePublicBootstrap,
+            enableCircuitRelay: this.config.enableCircuitRelay,
+            enablePubsubDiscovery: this.config.enablePubsubDiscovery,
+            enableMdns: this.config.enableMdns,
+        });
+        // Merge all bootstrap sources and update config so createNexusNode sees them
+        const allBootstrap = buildBootstrapList(discovery, [
+            ...signalingPeers,
+            ...this.config.bootstrapPeers,
+        ]);
+        this.config = resolveConfig({
+            ...this.config,
+            bootstrapPeers: allBootstrap,
+        });
+        // 3. Create and start libp2p node
+        // Pass signalingPeers separately so createNexusNode can correctly place them
+        // at the front of the bootstrap list (highest priority).
+        this.node = await createNexusNode(this.config, this.identity.privateKey, discovery, signalingPeers);
+        // 4. Set up peer events
+        this.node.addEventListener('peer:connect', (evt) => {
+            const remotePeerId = evt.detail.toString();
+            log.info(`Peer connected: ${remotePeerId}`);
+            this.emit('peer:connected', remotePeerId);
+        });
+        this.node.addEventListener('peer:disconnect', (evt) => {
+            const remotePeerId = evt.detail.toString();
+            log.info(`Peer disconnected: ${remotePeerId}`);
+            this.emit('peer:disconnected', remotePeerId);
+        });
+        // 5. Initialize managers
+        const pubsub = this.node.services.pubsub;
+        const dht = this.node.services.dht;
+        // Wire ContentPropagation through RoomManager so rooms auto-pin received CIDs
+        this.roomManager = new RoomManager(this.identity.peerId, pubsub, {
+            name: this.config.agentName,
+            type: this.config.agentType,
+            capabilities: [],
+            version: '0.1.0',
+        }, this.storageManager.propagation);
+        this.dhtManager = new DHTManager(dht);
+        // 6. Subscribe to meta topic for network-wide announcements
+        pubsub.subscribe(TOPICS.META);
+        // 7. Publish agent profile to DHT
+        const profile = {
+            schema: 'nexus:agent-profile:v1',
+            peerId: this.identity.peerId,
+            name: this.config.agentName,
+            description: '',
+            type: this.config.agentType,
+            capabilities: [],
+            role: this.config.role,
+            transports: this.node.getMultiaddrs().map((a) => a.toString()),
+            createdAt: Date.now(),
+            updatedAt: Date.now(),
+            previousVersion: null,
+        };
+        // Don't await DHT publish — it may take time to find peers
+        this.dhtManager.registry.publishProfile(profile).catch((err) => {
+            log.debug(`DHT profile publish deferred: ${err.message}`);
+        });
+        this._isConnected = true;
+        log.info('Connected to OpenAgents Nexus');
+        log.info(`Listening on: ${this.node
+            .getMultiaddrs()
+            .map((a) => a.toString())
+            .join(', ')}`);
+    }
+    async disconnect() {
+        if (!this._isConnected)
+            return;
+        log.info('Disconnecting...');
+        // Leave all rooms
+        if (this.roomManager) {
+            await this.roomManager.leaveAll();
+        }
+        // Stop storage
+        await this.storageManager.stop();
+        // Stop libp2p node
+        if (this.node) {
+            await this.node.stop();
+            this.node = null;
+        }
+        this._isConnected = false;
+        log.info('Disconnected');
+    }
+    // --- Rooms ---
+    async joinRoom(roomId) {
+        this.ensureConnected();
+        return this.roomManager.joinRoom(roomId);
+    }
+    async createRoom(options) {
+        this.ensureConnected();
+        // Create room manifest
+        const manifest = {
+            schema: 'nexus:room-manifest:v1',
+            roomId: options.roomId,
+            topic: roomTopic(options.roomId),
+            name: options.name,
+            description: options.description ?? '',
+            createdBy: this.identity.peerId,
+            createdAt: Date.now(),
+            type: options.type ?? 'persistent',
+            access: options.access ?? 'public',
+            retention: {
+                policy: 'community-pinned',
+                minPinners: 3,
+                archiveAfterMs: 604_800_000, // 7 days
+            },
+            historyRoot: null,
+            memberCount: 0,
+            previousVersion: null,
+        };
+        // Publish room manifest to DHT
+        await this.dhtManager.registry.publishRoom(manifest);
+        // Announce room creation on meta topic
+        const metaMsg = createMetaMessage(this.identity.peerId, 'room:created', {
+            roomId: options.roomId,
+        });
+        const pubsub = this.node.services.pubsub;
+        await pubsub.publish(TOPICS.META, encodeMessage(metaMsg));
+        // Join the room
+        return this.roomManager.joinRoom(options.roomId);
+    }
+    async listRooms() {
+        // For now, return locally known rooms.
+        // In the future, query DHT and signaling server.
+        const joinedRooms = this.roomManager?.getJoinedRooms() ?? [];
+        return joinedRooms.map(roomId => ({
+            roomId,
+            name: roomId,
+            topic: roomTopic(roomId),
+            memberCount: 0,
+            type: 'persistent',
+            access: 'public',
+            manifest: '',
+        }));
+    }
+    // --- Agent discovery ---
+    async findAgent(peerId) {
+        this.ensureConnected();
+        return this.dhtManager.registry.findProfile(peerId);
+    }
+    // --- Storage ---
+    async store(data) {
+        this.ensureConnected();
+        if (!this.storageManager.isStarted) {
+            await this.storageManager.start(this.node);
+        }
+        let cid;
+        if (typeof data === 'string') {
+            cid = await this.storageManager.storeString(data);
+        }
+        else if (data instanceof Uint8Array) {
+            cid = await this.storageManager.storeString(new TextDecoder().decode(data));
+        }
+        else {
+            cid = await this.storageManager.storeJSON(data);
+        }
+        // Track locally stored content for popularity accounting
+        this.storageManager.propagation.trackLocalContent(cid);
+        return cid;
+    }
+    async retrieve(cidString) {
+        this.ensureConnected();
+        if (!this.storageManager.isStarted) {
+            await this.storageManager.start(this.node);
+        }
+        // Try JSON first, fallback to string
+        try {
+            return await this.storageManager.retrieveJSON(cidString);
+        }
+        catch {
+            return await this.storageManager.retrieveString(cidString);
+        }
+    }
+    // --- Contribution ---
+    contribute(options) {
+        this.ensureConnected();
+        if (options.mirror) {
+            for (const roomId of options.mirror) {
+                this.storageManager.mirrors.mirrorRoom(roomId);
+            }
+        }
+        log.info(`Contributing: storage=${options.storage ?? false}, relay=${options.relay ?? false}, mirror=${options.mirror?.join(',') ?? 'none'}`);
+    }
+    // --- Stats ---
+    getStats() {
+        return this.storageManager.propagation.getStats();
+    }
+    // --- Internal ---
+    ensureConnected() {
+        if (!this._isConnected) {
+            throw new Error('Not connected. Call connect() first.');
+        }
+    }
+    // Access to underlying managers for advanced usage
+    get network() {
+        return {
+            node: this.node,
+            dht: this.dhtManager,
+            storage: this.storageManager,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Re-export all public types and utilities
+// ---------------------------------------------------------------------------
+// Named export before export * (NodeNext ESM import order requirement)
+export { NexusRoom } from './chat/index.js';
+export { SignalingServer } from './signaling/server.js';
+export { createLogger, setLogLevel } from './logger.js';
+export { resolveConfig, DEFAULT_CONFIG } from './config.js';
+export { PROTOCOL_VERSION, PROTOCOLS, TOPICS, uuidv7, createMessage, encodeMessage, decodeMessage, roomTopic, ephemeralTopic, } from './protocol/index.js';
+export { ContentPropagation } from './storage/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,8 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export declare function setLogLevel(level: LogLevel): void;
+export declare function createLogger(scope: string): {
+    debug: (msg: string, ...args: unknown[]) => void;
+    info: (msg: string, ...args: unknown[]) => void;
+    warn: (msg: string, ...args: unknown[]) => void;
+    error: (msg: string, ...args: unknown[]) => void;
+};

package/dist/logger.js

@@ -0,0 +1,32 @@
+const LEVELS = { debug: 0, info: 1, warn: 2, error: 3 };
+let currentLevel = 'info';
+export function setLogLevel(level) {
+    currentLevel = level;
+}
+function shouldLog(level) {
+    return LEVELS[level] >= LEVELS[currentLevel];
+}
+function format(level, scope, msg) {
+    return `[${new Date().toISOString()}] [${level.toUpperCase()}] [${scope}] ${msg}`;
+}
+export function createLogger(scope) {
+    return {
+        debug: (msg, ...args) => {
+            if (shouldLog('debug'))
+                console.debug(format('debug', scope, msg), ...args);
+        },
+        info: (msg, ...args) => {
+            if (shouldLog('info'))
+                console.info(format('info', scope, msg), ...args);
+        },
+        warn: (msg, ...args) => {
+            if (shouldLog('warn'))
+                console.warn(format('warn', scope, msg), ...args);
+        },
+        error: (msg, ...args) => {
+            if (shouldLog('error'))
+                console.error(format('error', scope, msg), ...args);
+        },
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAA6B,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAElF,IAAI,YAAY,GAAa,MAAM,CAAC;AAEpC,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,YAAY,GAAG,KAAK,CAAC;AACvB,CAAC;AAED,SAAS,SAAS,CAAC,KAAe;IAChC,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,MAAM,CAAC,KAAe,EAAE,KAAa,EAAE,GAAW;IACzD,OAAO,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,CAAC,WAAW,EAAE,MAAM,KAAK,KAAK,GAAG,EAAE,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO;QACL,KAAK,EAAE,CAAC,GAAW,EAAE,GAAG,IAAe,EAAE,EAAE;YACzC,IAAI,SAAS,CAAC,OAAO,CAAC;gBAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QAC9E,CAAC;QACD,IAAI,EAAE,CAAC,GAAW,EAAE,GAAG,IAAe,EAAE,EAAE;YACxC,IAAI,SAAS,CAAC,MAAM,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,EAAE,CAAC,GAAW,EAAE,GAAG,IAAe,EAAE,EAAE;YACxC,IAAI,SAAS,CAAC,MAAM,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QAC3E,CAAC;QACD,KAAK,EAAE,CAAC,GAAW,EAAE,GAAG,IAAe,EAAE,EAAE;YACzC,IAAI,SAAS,CAAC,OAAO,CAAC;gBAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QAC9E,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/node.d.ts

@@ -0,0 +1,47 @@
+/**
+ * libp2p node creation and configuration
+ *
+ * Responsible for creating and configuring the libp2p node with:
+ * - Transport: TCP, WebSockets, Circuit Relay v2
+ * - Encryption: Noise
+ * - Muxer: Yamux
+ * - Discovery: mDNS, Bootstrap (when peers provided), Pubsub Peer Discovery
+ * - Services: Identify, KadDHT (/nexus/kad/1.0.0), GossipSub, Circuit Relay Server
+ *
+ * Discovery cascade (in priority order):
+ *   1. Signaling Server peers — callers must pass these in via signalingPeers
+ *   2. Public bootstrap WSS nodes — enabled by discoveryConfig.usePublicBootstrap
+ *   3. Pubsub peer discovery — all agents subscribe to NEXUS_DISCOVERY_TOPIC
+ *   4. mDNS — local-network zero-config discovery
+ *   5. Circuit Relay v2 — NAT traversal (enabled for non-light roles)
+ */
+import type { PrivateKey } from '@libp2p/interface';
+import type { NexusConfig } from './config.js';
+import { type DiscoveryConfig } from './discovery.js';
+/**
+ * Create and start a fully-configured libp2p nexus node.
+ *
+ * The node uses:
+ *   - TCP + WebSockets + Circuit Relay v2 transports
+ *   - Noise connection encryption
+ *   - Yamux stream multiplexing
+ *   - Identify service for protocol/address exchange
+ *   - KadDHT on the /nexus/kad/1.0.0 protocol (client mode for 'light' role)
+ *   - GossipSub for pub/sub messaging
+ *   - Pubsub peer discovery on the global nexus discovery topic
+ *   - mDNS for local-network peer discovery (controllable via discoveryConfig)
+ *   - Bootstrap peer discovery (when the resolved bootstrap list is non-empty)
+ *   - Circuit relay server for non-light roles (helps NAT'd peers connect)
+ *
+ * @param config         - Nexus node configuration
+ * @param privateKey     - Ed25519 private key for this node's identity
+ * @param discoveryConfig - Optional discovery cascade settings (defaults applied)
+ * @param signalingPeers - Bootstrap peers fetched from the signaling server (Level 1)
+ */
+export declare function createNexusNode(config: NexusConfig, privateKey: PrivateKey, discoveryConfig?: Partial<DiscoveryConfig>, signalingPeers?: string[]): Promise<import("libp2p").Libp2p<{
+    relay?: import("@libp2p/circuit-relay-v2").CircuitRelayService;
+    identify: import("@libp2p/identify").Identify;
+    ping: import("@libp2p/ping").Ping;
+    dht: import("@libp2p/kad-dht").KadDHT;
+    pubsub: import("@libp2p/gossipsub").GossipSub;
+}>>;