libp2p-mesh 2026.5.18 → 2026.5.19

package/dist/src/mesh.js

@@ -77,6 +77,8 @@ export function createMeshNetwork(options) {
     const seenMessages = new Set();
     const messageHandlers = new Set();
     const topicHandlers = new Map();
+    const peerConnectHandlers = new Set();
+    const peerDisconnectHandlers = new Set();
     function getDHTService() {
         return state.node?.services?.dht;
     }
@@ -215,10 +217,22 @@ export function createMeshNetwork(options) {
         state.node.addEventListener("peer:connect", (evt) => {
             const peerIdStr = evt.detail.toString();
             logger?.info?.(`[libp2p-mesh] Peer connected: ${peerIdStr}`);
+            for (const handler of peerConnectHandlers) {
+                try {
+                    handler(peerIdStr);
+                }
+                catch { }
+            }
         });
         state.node.addEventListener("peer:disconnect", (evt) => {
             const peerIdStr = evt.detail.toString();
             logger?.info?.(`[libp2p-mesh] Peer disconnected: ${peerIdStr}`);
+            for (const handler of peerDisconnectHandlers) {
+                try {
+                    handler(peerIdStr);
+                }
+                catch { }
+            }
         });
         await state.node.handle(PROTOCOL, async ({ stream, connection }) => {
             try {
@@ -580,6 +594,14 @@ export function createMeshNetwork(options) {
         stop,
         sendToPeer,
         onMessage,
+        onPeerConnect(handler) {
+            peerConnectHandlers.add(handler);
+            return () => { peerConnectHandlers.delete(handler); };
+        },
+        onPeerDisconnect(handler) {
+            peerDisconnectHandlers.add(handler);
+            return () => { peerDisconnectHandlers.delete(handler); };
+        },
         publishToTopic,
         subscribeToTopic,
         getLocalPeerId,

package/dist/src/plugin.js

@@ -24,14 +24,15 @@ export function registerLibp2pMesh(api) {
         id: "libp2p-mesh",
         start: async () => {
             await mesh.start();
-            // Register local identity so remote peers can route messages back to us
+            // Gather local relay identity info
             const config = api.pluginConfig;
             const relayChannel = config?.relayChannel;
             const relayAccountId = config?.relayAccountId;
             const instanceIdentity = mesh.getInstanceIdentity();
             const localInstanceId = instanceIdentity?.id;
+            const localPeerId = mesh.getLocalPeerId();
+            // Register local identity so remote peers can route messages back to us
             if (relayChannel && relayAccountId) {
-                const localPeerId = mesh.getLocalPeerId();
                 const { buildAgentSessionKey } = await import("openclaw/plugin-sdk/core");
                 const sessionKey = buildAgentSessionKey({
                     agentId: api.name,
@@ -48,8 +49,7 @@ export function registerLibp2pMesh(api) {
                 api.logger.info?.(`[libp2p-mesh] Local identity registered: agent=${api.name}, channel=${relayChannel}, account=${relayAccountId}, instanceId=${localInstanceId}`);
                 // Announce identity to all currently-connected peers
                 const identityMsg = buildIdentityMessage(localPeerId, api.name, relayChannel, relayAccountId, localInstanceId);
-                const connectedPeers = mesh.getConnectedPeers();
-                for (const peerId of connectedPeers) {
+                for (const peerId of mesh.getConnectedPeers()) {
                     try {
                         await mesh.sendToPeer(peerId, JSON.stringify(identityMsg));
                     }
@@ -57,13 +57,24 @@ export function registerLibp2pMesh(api) {
                         // Best-effort; peer may be stale in the connection list
                     }
                 }
+                // When a new peer connects, send our identity to them
+                mesh.onPeerConnect((peerId) => {
+                    const msg = buildIdentityMessage(localPeerId, api.name, relayChannel, relayAccountId, localInstanceId);
+                    mesh.sendToPeer(peerId, JSON.stringify(msg)).catch(() => {
+                        // Best-effort
+                    });
+                });
+                // When a peer disconnects, clean up the identity map
+                mesh.onPeerDisconnect((peerId) => {
+                    peerIdentityMap.unregister(peerId);
+                });
             }
             // Wire up relay-aware message handler
             mesh.onMessage((msg) => {
                 handleP2PInbound(msg, buildInboundDeps());
             });
             const identity = mesh.getInstanceIdentity();
-            api.logger.info?.(`[libp2p-mesh] Service started. Peer ID: ${mesh.getLocalPeerId()}`);
+            api.logger.info?.(`[libp2p-mesh] Service started. Peer ID: ${localPeerId}`);
             if (identity) {
                 api.logger.info?.(`[libp2p-mesh] Instance Identity: ${identity.id}`);
             }

package/dist/src/types.d.ts

@@ -106,6 +106,8 @@ export interface MeshNetwork {
     stop(): Promise<void>;
     sendToPeer(peerId: string, message: string): Promise<void>;
     onMessage(handler: (msg: P2PMessage) => void): () => void;
+    onPeerConnect(handler: (peerId: string) => void): () => void;
+    onPeerDisconnect(handler: (peerId: string) => void): () => void;
     publishToTopic(topic: string, message: string): Promise<void>;
     subscribeToTopic(topic: string, handler: (msg: string) => void): Promise<void>;
     getLocalPeerId(): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libp2p-mesh",
-  "version": "2026.5.18",
+  "version": "2026.5.19",
   "description": "OpenClaw libp2p P2P mesh network plugin for cross-instance agent communication",
   "type": "module",
   "main": "dist/index.js",

package/src/mesh.ts

@@ -94,6 +94,8 @@ export function createMeshNetwork(options: {
   const seenMessages = new Set<string>();
   const messageHandlers = new Set<(msg: P2PMessage) => void>();
   const topicHandlers = new Map<string, Set<(msg: string) => void>>();
+  const peerConnectHandlers = new Set<(peerId: string) => void>();
+  const peerDisconnectHandlers = new Set<(peerId: string) => void>();
 
   function getDHTService(): ReturnType<typeof kadDHT> extends (components: infer C) => infer R ? R : never | undefined {
     return (state.node as any)?.services?.dht;
@@ -258,11 +260,17 @@ export function createMeshNetwork(options: {
     state.node.addEventListener("peer:connect", (evt) => {
       const peerIdStr = evt.detail.toString();
       logger?.info?.(`[libp2p-mesh] Peer connected: ${peerIdStr}`);
+      for (const handler of peerConnectHandlers) {
+        try { handler(peerIdStr); } catch {}
+      }
     });
 
     state.node.addEventListener("peer:disconnect", (evt) => {
       const peerIdStr = evt.detail.toString();
       logger?.info?.(`[libp2p-mesh] Peer disconnected: ${peerIdStr}`);
+      for (const handler of peerDisconnectHandlers) {
+        try { handler(peerIdStr); } catch {}
+      }
     });
 
     await state.node.handle(
@@ -667,6 +675,14 @@ export function createMeshNetwork(options: {
     stop,
     sendToPeer,
     onMessage,
+    onPeerConnect(handler: (peerId: string) => void): () => void {
+      peerConnectHandlers.add(handler);
+      return () => { peerConnectHandlers.delete(handler); };
+    },
+    onPeerDisconnect(handler: (peerId: string) => void): () => void {
+      peerDisconnectHandlers.add(handler);
+      return () => { peerDisconnectHandlers.delete(handler); };
+    },
     publishToTopic,
     subscribeToTopic,
     getLocalPeerId,

package/src/plugin.ts

@@ -33,14 +33,16 @@ export function registerLibp2pMesh(api: OpenClawPluginApi) {
     start: async () => {
       await mesh.start();
 
-      // Register local identity so remote peers can route messages back to us
+      // Gather local relay identity info
       const config = api.pluginConfig as MeshConfig | undefined;
       const relayChannel = config?.relayChannel;
       const relayAccountId = config?.relayAccountId;
       const instanceIdentity = mesh.getInstanceIdentity();
       const localInstanceId = instanceIdentity?.id;
+      const localPeerId = mesh.getLocalPeerId();
+
+      // Register local identity so remote peers can route messages back to us
       if (relayChannel && relayAccountId) {
-        const localPeerId = mesh.getLocalPeerId();
         const { buildAgentSessionKey } = await import("openclaw/plugin-sdk/core");
         const sessionKey = buildAgentSessionKey({
           agentId: api.name,
@@ -66,14 +68,32 @@ export function registerLibp2pMesh(api: OpenClawPluginApi) {
           relayAccountId,
           localInstanceId,
         );
-        const connectedPeers = mesh.getConnectedPeers();
-        for (const peerId of connectedPeers) {
+        for (const peerId of mesh.getConnectedPeers()) {
           try {
             await mesh.sendToPeer(peerId, JSON.stringify(identityMsg));
           } catch {
             // Best-effort; peer may be stale in the connection list
           }
         }
+
+        // When a new peer connects, send our identity to them
+        mesh.onPeerConnect((peerId: string) => {
+          const msg = buildIdentityMessage(
+            localPeerId,
+            api.name,
+            relayChannel,
+            relayAccountId,
+            localInstanceId,
+          );
+          mesh.sendToPeer(peerId, JSON.stringify(msg)).catch(() => {
+            // Best-effort
+          });
+        });
+
+        // When a peer disconnects, clean up the identity map
+        mesh.onPeerDisconnect((peerId: string) => {
+          peerIdentityMap.unregister(peerId);
+        });
       }
 
       // Wire up relay-aware message handler
@@ -82,7 +102,7 @@ export function registerLibp2pMesh(api: OpenClawPluginApi) {
       });
 
       const identity = mesh.getInstanceIdentity();
-      api.logger.info?.(`[libp2p-mesh] Service started. Peer ID: ${mesh.getLocalPeerId()}`);
+      api.logger.info?.(`[libp2p-mesh] Service started. Peer ID: ${localPeerId}`);
       if (identity) {
         api.logger.info?.(`[libp2p-mesh] Instance Identity: ${identity.id}`);
       }

package/src/types.ts

@@ -116,6 +116,8 @@ export interface MeshNetwork {
   stop(): Promise<void>;
   sendToPeer(peerId: string, message: string): Promise<void>;
   onMessage(handler: (msg: P2PMessage) => void): () => void;
+  onPeerConnect(handler: (peerId: string) => void): () => void;
+  onPeerDisconnect(handler: (peerId: string) => void): () => void;
   publishToTopic(topic: string, message: string): Promise<void>;
   subscribeToTopic(topic: string, handler: (msg: string) => void): Promise<void>;
   getLocalPeerId(): string;