open-agents-nexus 0.1.0

package/dist/signaling/server.js.map

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

package/dist/storage/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * IPFS/Helia storage layer
+ *
+ * Provides content-addressed storage using Helia (IPFS in JS).
+ * Supports storing and retrieving files, JSON, strings, and DAG structures.
+ */
+import { PinManager } from './pin.js';
+import { MirrorManager } from './mirror.js';
+import { ContentPropagation } from './propagation.js';
+export declare class StorageManager {
+    private helia;
+    private jsonStore;
+    private stringStore;
+    private dagJsonStore;
+    readonly pins: PinManager;
+    readonly mirrors: MirrorManager;
+    readonly propagation: ContentPropagation;
+    constructor();
+    start(libp2pNode: any): Promise<void>;
+    stop(): Promise<void>;
+    storeJSON(data: unknown): Promise<string>;
+    retrieveJSON(cidString: string): Promise<unknown>;
+    storeString(data: string): Promise<string>;
+    retrieveString(cidString: string): Promise<string>;
+    storeDAG(data: unknown): Promise<string>;
+    retrieveDAG(cidString: string): Promise<unknown>;
+    get isStarted(): boolean;
+}
+export { PinManager } from './pin.js';
+export { MirrorManager } from './mirror.js';
+export { ContentPropagation } from './propagation.js';

package/dist/storage/index.js

@@ -0,0 +1,103 @@
+/**
+ * IPFS/Helia storage layer
+ *
+ * Provides content-addressed storage using Helia (IPFS in JS).
+ * Supports storing and retrieving files, JSON, strings, and DAG structures.
+ */
+import { createHelia } from 'helia';
+import { json } from '@helia/json';
+import { strings } from '@helia/strings';
+import { dagJson } from '@helia/dag-json';
+import { PinManager } from './pin.js';
+import { MirrorManager } from './mirror.js';
+import { ContentPropagation } from './propagation.js';
+import { createLogger } from '../logger.js';
+const log = createLogger('storage');
+export class StorageManager {
+    helia = null;
+    jsonStore = null;
+    stringStore = null;
+    dagJsonStore = null;
+    pins;
+    mirrors;
+    propagation;
+    constructor() {
+        // PinManager and MirrorManager will be initialized when helia starts
+        this.pins = null;
+        this.mirrors = null;
+        this.propagation = new ContentPropagation();
+    }
+    async start(libp2pNode) {
+        // Create Helia node using the existing libp2p node
+        this.helia = await createHelia({
+            libp2p: libp2pNode,
+        });
+        this.jsonStore = json(this.helia);
+        this.stringStore = strings(this.helia);
+        this.dagJsonStore = dagJson(this.helia);
+        this.pins = new PinManager(this.helia);
+        this.mirrors = new MirrorManager(this.helia);
+        // Wire the pin callback so ContentPropagation can auto-pin via PinManager
+        this.propagation.setPinCallback((cid) => this.pins.pin(cid));
+        log.info('Storage manager started');
+    }
+    async stop() {
+        if (this.helia) {
+            await this.helia.stop();
+            this.helia = null;
+            log.info('Storage manager stopped');
+        }
+    }
+    // Store a JSON object, returns CID string
+    async storeJSON(data) {
+        if (!this.jsonStore)
+            throw new Error('Storage not started');
+        const cid = await this.jsonStore.add(data);
+        return cid.toString();
+    }
+    // Retrieve a JSON object by CID string
+    async retrieveJSON(cidString) {
+        if (!this.jsonStore)
+            throw new Error('Storage not started');
+        const { CID } = await import('multiformats/cid');
+        const cid = CID.parse(cidString);
+        return this.jsonStore.get(cid);
+    }
+    // Store a string, returns CID string
+    async storeString(data) {
+        if (!this.stringStore)
+            throw new Error('Storage not started');
+        const cid = await this.stringStore.add(data);
+        return cid.toString();
+    }
+    // Retrieve a string by CID string
+    async retrieveString(cidString) {
+        if (!this.stringStore)
+            throw new Error('Storage not started');
+        const { CID } = await import('multiformats/cid');
+        const cid = CID.parse(cidString);
+        return this.stringStore.get(cid);
+    }
+    // Store a DAG-JSON object (supports CID links), returns CID string
+    async storeDAG(data) {
+        if (!this.dagJsonStore)
+            throw new Error('Storage not started');
+        const cid = await this.dagJsonStore.add(data);
+        return cid.toString();
+    }
+    // Retrieve a DAG-JSON object by CID string
+    async retrieveDAG(cidString) {
+        if (!this.dagJsonStore)
+            throw new Error('Storage not started');
+        const { CID } = await import('multiformats/cid');
+        const cid = CID.parse(cidString);
+        return this.dagJsonStore.get(cid);
+    }
+    get isStarted() {
+        return this.helia !== null;
+    }
+}
+export { PinManager } from './pin.js';
+export { MirrorManager } from './mirror.js';
+export { ContentPropagation } from './propagation.js';
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

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

package/dist/storage/mirror.d.ts

@@ -0,0 +1,9 @@
+export declare class MirrorManager {
+    private mirroredRooms;
+    private helia;
+    constructor(helia: any);
+    mirrorRoom(roomId: string): Promise<void>;
+    stopMirroring(roomId: string): Promise<void>;
+    getMirroredRooms(): string[];
+    isMirroring(roomId: string): boolean;
+}

package/dist/storage/mirror.js

@@ -0,0 +1,24 @@
+import { createLogger } from '../logger.js';
+const log = createLogger('storage:mirror');
+export class MirrorManager {
+    mirroredRooms = new Set();
+    helia;
+    constructor(helia) {
+        this.helia = helia;
+    }
+    async mirrorRoom(roomId) {
+        this.mirroredRooms.add(roomId);
+        log.info(`Started mirroring room: ${roomId}`);
+    }
+    async stopMirroring(roomId) {
+        this.mirroredRooms.delete(roomId);
+        log.info(`Stopped mirroring room: ${roomId}`);
+    }
+    getMirroredRooms() {
+        return Array.from(this.mirroredRooms);
+    }
+    isMirroring(roomId) {
+        return this.mirroredRooms.has(roomId);
+    }
+}
+//# sourceMappingURL=mirror.js.map

package/dist/storage/mirror.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mirror.js","sourceRoot":"","sources":["../../src/storage/mirror.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,GAAG,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC;AAE3C,MAAM,OAAO,aAAa;IAChB,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,CAAM;IAEnB,YAAY,KAAU;QACpB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAc;QAC7B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/B,GAAG,CAAC,IAAI,CAAC,2BAA2B,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,MAAc;QAChC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAClC,GAAG,CAAC,IAAI,CAAC,2BAA2B,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,gBAAgB;QACd,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACxC,CAAC;IAED,WAAW,CAAC,MAAc;QACxB,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/storage/pin.d.ts

@@ -0,0 +1,8 @@
+export declare class PinManager {
+    private helia;
+    private pinnedCids;
+    constructor(helia: any);
+    pin(cidString: string): Promise<void>;
+    unpin(cidString: string): Promise<void>;
+    getPinnedCids(): string[];
+}

package/dist/storage/pin.js

@@ -0,0 +1,42 @@
+import { createLogger } from '../logger.js';
+const log = createLogger('storage:pin');
+export class PinManager {
+    helia;
+    pinnedCids = new Set();
+    constructor(helia) {
+        this.helia = helia;
+    }
+    async pin(cidString) {
+        try {
+            const { CID } = await import('multiformats/cid');
+            const cid = CID.parse(cidString);
+            for await (const _ of this.helia.pins.add(cid)) {
+                // drain
+            }
+            this.pinnedCids.add(cidString);
+            log.info(`Pinned: ${cidString}`);
+        }
+        catch (err) {
+            log.error(`Failed to pin ${cidString}: ${err}`);
+            throw err;
+        }
+    }
+    async unpin(cidString) {
+        try {
+            const { CID } = await import('multiformats/cid');
+            const cid = CID.parse(cidString);
+            for await (const _ of this.helia.pins.rm(cid)) {
+                // drain
+            }
+            this.pinnedCids.delete(cidString);
+            log.info(`Unpinned: ${cidString}`);
+        }
+        catch (err) {
+            log.error(`Failed to unpin ${cidString}: ${err}`);
+        }
+    }
+    getPinnedCids() {
+        return Array.from(this.pinnedCids);
+    }
+}
+//# sourceMappingURL=pin.js.map

package/dist/storage/pin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pin.js","sourceRoot":"","sources":["../../src/storage/pin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,GAAG,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;AAExC,MAAM,OAAO,UAAU;IACb,KAAK,CAAM;IACX,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IAEvC,YAAY,KAAU;QACpB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,SAAiB;QACzB,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;YACjD,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAEjC,IAAI,KAAK,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC/C,QAAQ;YACV,CAAC;YACD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC/B,GAAG,CAAC,IAAI,CAAC,WAAW,SAAS,EAAE,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,KAAK,CAAC,iBAAiB,SAAS,KAAK,GAAG,EAAE,CAAC,CAAC;YAChD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,SAAiB;QAC3B,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;YACjD,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAEjC,IAAI,KAAK,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9C,QAAQ;YACV,CAAC;YACD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAClC,GAAG,CAAC,IAAI,CAAC,aAAa,SAAS,EAAE,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,KAAK,CAAC,mBAAmB,SAAS,KAAK,GAAG,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,aAAa;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/storage/propagation.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Viral content propagation — automatic pinning of received content
+ *
+ * When Agent A receives content from Agent B (a chat message referencing CIDs,
+ * or content retrieved from the network), Agent A automatically pins those CIDs.
+ * This creates organic growth in content redundancy: popular content gets pinned
+ * by more agents proportional to how widely it is shared.
+ */
+export interface PropagationStats {
+    totalPinned: number;
+    pinnedFromOthers: number;
+    pinnedByOthers: number;
+    cidPopularity: Map<string, number>;
+}
+export declare class ContentPropagation {
+    private localPins;
+    private cidSources;
+    private autopinEnabled;
+    private pinCallback;
+    constructor();
+    setPinCallback(cb: (cid: string) => Promise<void>): void;
+    setAutopin(enabled: boolean): void;
+    onContentReceived(cids: string[], sourcePeerId: string): Promise<void>;
+    trackLocalContent(cid: string): void;
+    getPopularity(cid: string): number;
+    getStats(): {
+        totalPinned: number;
+        pinnedFromOthers: number;
+        trackedCids: number;
+    };
+    getLocalPins(): string[];
+}

package/dist/storage/propagation.js

@@ -0,0 +1,89 @@
+/**
+ * Viral content propagation — automatic pinning of received content
+ *
+ * When Agent A receives content from Agent B (a chat message referencing CIDs,
+ * or content retrieved from the network), Agent A automatically pins those CIDs.
+ * This creates organic growth in content redundancy: popular content gets pinned
+ * by more agents proportional to how widely it is shared.
+ */
+import { createLogger } from '../logger.js';
+const log = createLogger('storage:propagation');
+export class ContentPropagation {
+    localPins = new Set();
+    cidSources = new Map(); // CID -> set of peerIds that have it
+    autopinEnabled = true;
+    pinCallback = null;
+    constructor() { }
+    // Set the callback that actually pins content (connected to StorageManager)
+    setPinCallback(cb) {
+        this.pinCallback = cb;
+    }
+    // Enable/disable automatic pinning of received content
+    setAutopin(enabled) {
+        this.autopinEnabled = enabled;
+        log.info(`Autopin ${enabled ? 'enabled' : 'disabled'}`);
+    }
+    // Called when we receive a message that references CIDs.
+    // This is the viral mechanism: seeing content = pinning content.
+    async onContentReceived(cids, sourcePeerId) {
+        if (!this.autopinEnabled || !this.pinCallback) {
+            // Even when disabled, track sources so we know what is popular
+            if (cids.length > 0) {
+                for (const cid of cids) {
+                    if (!this.cidSources.has(cid)) {
+                        this.cidSources.set(cid, new Set());
+                    }
+                    this.cidSources.get(cid).add(sourcePeerId);
+                }
+            }
+            return;
+        }
+        for (const cid of cids) {
+            // Track who has this content
+            if (!this.cidSources.has(cid)) {
+                this.cidSources.set(cid, new Set());
+            }
+            this.cidSources.get(cid).add(sourcePeerId);
+            // Auto-pin if we haven't already
+            if (!this.localPins.has(cid)) {
+                try {
+                    await this.pinCallback(cid);
+                    this.localPins.add(cid);
+                    log.info(`Auto-pinned ${cid} (from ${sourcePeerId.slice(0, 12)}...)`);
+                }
+                catch (err) {
+                    log.debug(`Failed to auto-pin ${cid}: ${err}`);
+                }
+            }
+        }
+    }
+    // Called when we store our own content locally
+    trackLocalContent(cid) {
+        this.localPins.add(cid);
+    }
+    // Get popularity of a CID (number of known pinners: local + peers)
+    getPopularity(cid) {
+        const sources = this.cidSources.get(cid);
+        let count = sources?.size ?? 0;
+        if (this.localPins.has(cid))
+            count++;
+        return count;
+    }
+    // Get aggregate stats
+    getStats() {
+        const pinnedFromOthers = Array.from(this.localPins).filter(cid => {
+            const sources = this.cidSources.get(cid);
+            return sources && sources.size > 0;
+        }).length;
+        return {
+            totalPinned: this.localPins.size,
+            pinnedFromOthers,
+            trackedCids: this.cidSources.size,
+        };
+    }
+    // Get all locally pinned CIDs
+    getLocalPins() {
+        return Array.from(this.localPins);
+    }
+}
+//# sourceMappingURL=propagation.js.map

package/dist/storage/propagation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"propagation.js","sourceRoot":"","sources":["../../src/storage/propagation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,GAAG,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAC;AAShD,MAAM,OAAO,kBAAkB;IACrB,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,UAAU,GAAG,IAAI,GAAG,EAAuB,CAAC,CAAC,qCAAqC;IAClF,cAAc,GAAG,IAAI,CAAC;IACtB,WAAW,GAA4C,IAAI,CAAC;IAEpE,gBAAe,CAAC;IAEhB,4EAA4E;IAC5E,cAAc,CAAC,EAAkC;QAC/C,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;IACxB,CAAC;IAED,uDAAuD;IACvD,UAAU,CAAC,OAAgB;QACzB,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;QAC9B,GAAG,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,yDAAyD;IACzD,iEAAiE;IACjE,KAAK,CAAC,iBAAiB,CAAC,IAAc,EAAE,YAAoB;QAC1D,IAAI,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YAC9C,+DAA+D;YAC/D,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;oBACvB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;wBAC9B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;oBACtC,CAAC;oBACD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;gBAC9C,CAAC;YACH,CAAC;YACD,OAAO;QACT,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,6BAA6B;YAC7B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;YACtC,CAAC;YACD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YAE5C,iCAAiC;YACjC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7B,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;oBAC5B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBACxB,GAAG,CAAC,IAAI,CAAC,eAAe,GAAG,UAAU,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;gBACxE,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,GAAG,CAAC,KAAK,CAAC,sBAAsB,GAAG,KAAK,GAAG,EAAE,CAAC,CAAC;gBACjD,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,iBAAiB,CAAC,GAAW;QAC3B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED,mEAAmE;IACnE,aAAa,CAAC,GAAW;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,KAAK,GAAG,OAAO,EAAE,IAAI,IAAI,CAAC,CAAC;QAC/B,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,KAAK,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,sBAAsB;IACtB,QAAQ;QACN,MAAM,gBAAgB,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;YAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACzC,OAAO,OAAO,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC,MAAM,CAAC;QAEV,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI;YAChC,gBAAgB;YAChB,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI;SAClC,CAAC;IACJ,CAAC;IAED,8BAA8B;IAC9B,YAAY;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;CACF"}

package/package.json

@@ -0,0 +1,122 @@
+{
+  "name": "open-agents-nexus",
+  "version": "0.1.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",
+  "type": "module",
+  "bin": {
+    "nexus": "./dist/cli.js",
+    "open-agents-nexus": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "dist/**/*.js.map",
+    "!dist/**/__tests__/**",
+    "!dist/**/*.test.*",
+    "LICENSE",
+    "README.md",
+    "ARCHITECTURE.md"
+  ],
+  "scripts": {
+    "dev": "node --import tsx src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/robit-man/openagents.nexus.git"
+  },
+  "keywords": [
+    "agent",
+    "agents",
+    "ai-agent",
+    "autonomous-agent",
+    "multi-agent",
+    "agent-communication",
+    "agent-framework",
+    "agent-protocol",
+    "agent-to-agent",
+    "agentic",
+    "decentralized",
+    "p2p",
+    "peer-to-peer",
+    "distributed",
+    "mesh-network",
+    "libp2p",
+    "ipfs",
+    "helia",
+    "dht",
+    "kademlia",
+    "gossipsub",
+    "pubsub",
+    "chat",
+    "real-time",
+    "encrypted",
+    "e2e-encryption",
+    "noise-protocol",
+    "privacy",
+    "zero-config",
+    "nat-traversal",
+    "circuit-relay",
+    "content-addressed",
+    "content-pinning",
+    "openagents",
+    "nexus",
+    "no-server",
+    "serverless",
+    "self-sovereign",
+    "web3",
+    "mcp",
+    "tool-use",
+    "llm",
+    "swarm",
+    "collaborative-agents"
+  ],
+  "author": "",
+  "license": "AGPL-3.0",
+  "bugs": {
+    "url": "https://github.com/robit-man/openagents.nexus/issues"
+  },
+  "homepage": "https://github.com/robit-man/openagents.nexus#readme",
+  "dependencies": {
+    "@chainsafe/libp2p-noise": "^17.0.0",
+    "@chainsafe/libp2p-yamux": "^8.0.1",
+    "@helia/dag-json": "^5.0.7",
+    "@helia/json": "^5.0.7",
+    "@helia/strings": "^5.0.7",
+    "@helia/unixfs": "^7.0.4",
+    "@libp2p/bootstrap": "^12.0.14",
+    "@libp2p/circuit-relay-v2": "^4.1.6",
+    "@libp2p/gossipsub": "^15.0.15",
+    "@libp2p/identify": "^4.0.13",
+    "@libp2p/kad-dht": "^16.1.6",
+    "@libp2p/mdns": "^12.0.14",
+    "@libp2p/pubsub-peer-discovery": "^12.0.0",
+    "@libp2p/tcp": "^11.0.13",
+    "@libp2p/webrtc": "^6.0.14",
+    "@libp2p/websockets": "^10.1.6",
+    "helia": "^6.0.21",
+    "libp2p": "^3.1.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0"
+  }
+}