libp2p-mesh 2026.5.32 → 2026.6.2

package/dist/src/agent-tools.d.ts

@@ -1,5 +1,5 @@
-import type { MeshNetwork } from "./types.js";
-export declare function buildP2PTools(mesh: MeshNetwork): ({
+import type { InstanceRouter, MeshNetwork } from "./types.js";
+export declare function buildP2PTools(mesh: MeshNetwork, router?: InstanceRouter): ({
     name: string;
     label: string;
     description: string;
@@ -14,8 +14,8 @@ export declare function buildP2PTools(mesh: MeshNetwork): ({
                 type: "string";
                 description: string;
             };
-            instanceId?: undefined;
             topic?: undefined;
+            instanceId?: undefined;
         };
         required: string[];
     };
@@ -52,7 +52,7 @@ export declare function buildP2PTools(mesh: MeshNetwork): ({
     parameters: {
         type: "object";
         properties: {
-            instanceId: {
+            topic: {
                 type: "string";
                 description: string;
             };
@@ -61,46 +61,59 @@ export declare function buildP2PTools(mesh: MeshNetwork): ({
                 description: string;
             };
             peerId?: undefined;
-            topic?: undefined;
+            instanceId?: undefined;
         };
         required: string[];
     };
     execute(_toolCallId: string, params: {
-        instanceId: string;
+        topic: string;
         message: string;
-    }, _ctx: any): Promise<{
+    }): Promise<{
         content: {
             type: "text";
             text: string;
         }[];
         details: {
-            sent: boolean;
-            error: string;
-            instanceId?: undefined;
-            peerId?: undefined;
+            broadcast: boolean;
+            topic: string;
+            error?: undefined;
         };
-        isError: boolean;
+        isError?: undefined;
     } | {
         content: {
             type: "text";
             text: string;
         }[];
         details: {
-            sent: boolean;
-            instanceId: string;
-            error?: undefined;
-            peerId?: undefined;
+            broadcast: boolean;
+            topic: string;
+            error: string;
         };
         isError: boolean;
-    } | {
+    }>;
+} | {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {
+            peerId?: undefined;
+            message?: undefined;
+            topic?: undefined;
+            instanceId?: undefined;
+        };
+        required?: undefined;
+    };
+    execute(_toolCallId: string): Promise<{
         content: {
             type: "text";
             text: string;
         }[];
         details: {
-            sent: boolean;
-            instanceId: string;
-            peerId: any;
+            localPeerId: string;
+            connectedPeers: string[];
+            count: number;
             error?: undefined;
         };
         isError?: undefined;
@@ -110,10 +123,10 @@ export declare function buildP2PTools(mesh: MeshNetwork): ({
             text: string;
         }[];
         details: {
-            sent: boolean;
-            instanceId: string;
             error: string;
-            peerId?: undefined;
+            localPeerId?: undefined;
+            connectedPeers?: undefined;
+            count?: undefined;
         };
         isError: boolean;
     }>;
@@ -124,30 +137,32 @@ export declare function buildP2PTools(mesh: MeshNetwork): ({
     parameters: {
         type: "object";
         properties: {
-            topic: {
-                type: "string";
-                description: string;
-            };
-            message: {
-                type: "string";
-                description: string;
-            };
             peerId?: undefined;
+            message?: undefined;
+            topic?: undefined;
             instanceId?: undefined;
         };
-        required: string[];
+        required?: undefined;
     };
-    execute(_toolCallId: string, params: {
-        topic: string;
-        message: string;
-    }): Promise<{
+    execute(_toolCallId: string): Promise<{
         content: {
             type: "text";
             text: string;
         }[];
         details: {
-            broadcast: boolean;
-            topic: string;
+            initialized: boolean;
+            identity?: undefined;
+            error?: undefined;
+        };
+        isError?: undefined;
+    } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        details: {
+            identity: import("./types.js").InstanceIdentity;
+            initialized?: undefined;
             error?: undefined;
         };
         isError?: undefined;
@@ -157,9 +172,9 @@ export declare function buildP2PTools(mesh: MeshNetwork): ({
             text: string;
         }[];
         details: {
-            broadcast: boolean;
-            topic: string;
             error: string;
+            initialized?: undefined;
+            identity?: undefined;
         };
         isError: boolean;
     }>;
@@ -172,22 +187,21 @@ export declare function buildP2PTools(mesh: MeshNetwork): ({
         properties: {
             peerId?: undefined;
             message?: undefined;
-            instanceId?: undefined;
             topic?: undefined;
+            instanceId?: undefined;
         };
         required?: undefined;
     };
-    execute(_toolCallId: string, _params: any, ctx: any): Promise<{
+    execute(_toolCallId: string): Promise<{
         content: {
             type: "text";
             text: string;
         }[];
         details: {
-            peers: {
-                peerId: string;
-                instanceId: any;
-                channel: any;
-            }[];
+            peerId: string;
+            instanceId: string | undefined;
+            listenAddrs: string[];
+            connectedPeers: string[];
             error?: undefined;
         };
         isError?: undefined;
@@ -198,7 +212,10 @@ export declare function buildP2PTools(mesh: MeshNetwork): ({
         }[];
         details: {
             error: string;
-            peers?: undefined;
+            peerId?: undefined;
+            instanceId?: undefined;
+            listenAddrs?: undefined;
+            connectedPeers?: undefined;
         };
         isError: boolean;
     }>;
@@ -211,8 +228,8 @@ export declare function buildP2PTools(mesh: MeshNetwork): ({
         properties: {
             peerId?: undefined;
             message?: undefined;
-            instanceId?: undefined;
             topic?: undefined;
+            instanceId?: undefined;
         };
         required?: undefined;
     };
@@ -223,17 +240,29 @@ export declare function buildP2PTools(mesh: MeshNetwork): ({
         }[];
         details: {
             initialized: boolean;
-            identity?: undefined;
+            instances?: undefined;
+            count?: undefined;
             error?: undefined;
         };
-        isError?: undefined;
+        isError: boolean;
     } | {
         content: {
             type: "text";
             text: string;
         }[];
         details: {
-            identity: import("./types.js").InstanceIdentity;
+            instances: {
+                connected: boolean;
+                instanceId: string;
+                peerId: string;
+                instanceName?: string;
+                multiaddrs: string[];
+                pubkey?: string;
+                lastSeenAt: number;
+                lastAnnouncedAt: number;
+                source: "announce";
+            }[];
+            count: number;
             initialized?: undefined;
             error?: undefined;
         };
@@ -246,7 +275,8 @@ export declare function buildP2PTools(mesh: MeshNetwork): ({
         details: {
             error: string;
             initialized?: undefined;
-            identity?: undefined;
+            instances?: undefined;
+            count?: undefined;
         };
         isError: boolean;
     }>;
@@ -257,26 +287,31 @@ export declare function buildP2PTools(mesh: MeshNetwork): ({
     parameters: {
         type: "object";
         properties: {
+            instanceId: {
+                type: "string";
+                description: string;
+            };
             peerId?: undefined;
             message?: undefined;
-            instanceId?: undefined;
             topic?: undefined;
         };
-        required?: undefined;
+        required: string[];
     };
-    execute(_toolCallId: string): Promise<{
+    execute(_toolCallId: string, params: {
+        instanceId: string;
+    }): Promise<{
         content: {
             type: "text";
             text: string;
         }[];
         details: {
-            peerId: string;
-            instanceId: string | undefined;
-            listenAddrs: string[];
-            connectedPeers: string[];
+            initialized: boolean;
             error?: undefined;
+            instanceId?: undefined;
+            found?: undefined;
+            route?: undefined;
         };
-        isError?: undefined;
+        isError: boolean;
     } | {
         content: {
             type: "text";
@@ -284,12 +319,38 @@ export declare function buildP2PTools(mesh: MeshNetwork): ({
         }[];
         details: {
             error: string;
-            peerId?: undefined;
+            initialized?: undefined;
             instanceId?: undefined;
-            listenAddrs?: undefined;
-            connectedPeers?: undefined;
+            found?: undefined;
+            route?: undefined;
         };
         isError: boolean;
+    } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        details: {
+            instanceId: string;
+            found: boolean;
+            initialized?: undefined;
+            error?: undefined;
+            route?: undefined;
+        };
+        isError: boolean;
+    } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        details: {
+            found: boolean;
+            route: import("./types.js").InstancePeerRecord;
+            initialized?: undefined;
+            error?: undefined;
+            instanceId?: undefined;
+        };
+        isError?: undefined;
     }>;
 } | {
     name: string;
@@ -298,31 +359,71 @@ export declare function buildP2PTools(mesh: MeshNetwork): ({
     parameters: {
         type: "object";
         properties: {
+            instanceId: {
+                type: "string";
+                description: string;
+            };
+            message: {
+                type: "string";
+                description: string;
+            };
             peerId?: undefined;
-            message?: undefined;
-            instanceId?: undefined;
             topic?: undefined;
         };
-        required?: undefined;
+        required: string[];
     };
-    execute(_toolCallId: string, _params: {}, _ctx: any): Promise<{
+    execute(_toolCallId: string, params: {
+        instanceId: string;
+        message: string;
+    }): Promise<{
         content: {
             type: "text";
             text: string;
         }[];
         details: {
-            localPeerId: string;
-            localInstanceId: any;
-            connectedPeers: number;
-            knownPeers: {
-                peerId: string;
-                agentId: string;
-                channel: string;
-                instanceId?: string;
-                sessionKey: string;
-                status: string;
-                lastSeen?: number;
-            }[];
+            initialized: boolean;
+            error?: undefined;
+        };
+        isError: boolean;
+    } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        details: {
+            error: string;
+            initialized?: undefined;
         };
+        isError: boolean;
+    } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        details: {
+            sent: boolean;
+            delivered: boolean;
+            toInstanceId: string;
+            toPeerId: string;
+            ackMessageId?: string;
+            inboundChannel?: string;
+            error?: string;
+        };
+        isError: boolean;
+    } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        details: {
+            sent: boolean;
+            delivered: boolean;
+            toInstanceId: string;
+            toPeerId: string;
+            ackMessageId?: string;
+            inboundChannel?: string;
+            error?: string;
+        };
+        isError?: undefined;
     }>;
 })[];