libp2p-mesh 2026.6.22 → 2026.6.23

package/dist/src/instance-router.js

@@ -121,6 +121,7 @@ export function createInstanceRouter(options) {
     const deliveryCache = new Map();
     const unsubs = [];
     const pendingAttributePeers = new Set();
+    let publicAttributeRefreshEnabled = options.publicAttributeRefreshInitiallyEnabled !== false;
     let attributeRefreshPromise;
     function localInstanceId() {
         const identity = mesh.getInstanceIdentity();
@@ -215,7 +216,9 @@ export function createInstanceRouter(options) {
         if (pendingAttributePeers.size === 0 && !attributeRefreshPromise) {
             return;
         }
-        drainAttributeRefresh();
+        if (publicAttributeRefreshEnabled) {
+            drainAttributeRefresh();
+        }
     }
     function drainAttributeRefresh() {
         if (!attributeRefreshPromise) {
@@ -233,6 +236,12 @@ export function createInstanceRouter(options) {
         }
         return attributeRefreshPromise;
     }
+    function enablePublicAttributeRefresh() {
+        publicAttributeRefreshEnabled = true;
+        if (pendingAttributePeers.size > 0) {
+            drainAttributeRefresh();
+        }
+    }
     async function announceToPeer(peerId) {
         if (!isNonEmptyString(peerId) || peerId === mesh.getLocalPeerId()) {
             return;
@@ -667,6 +676,7 @@ export function createInstanceRouter(options) {
         stop,
         handleMessage,
         announceToPeer,
+        enablePublicAttributeRefresh,
         refreshPublicAttributes,
         listInstances,
         resolveInstance,

package/dist/src/plugin.js

@@ -10,6 +10,7 @@ import { createOpenClawUserMdAttributeExtractor } from "./user-md-openclaw-extra
 import { createUserProfileStore } from "./user-profile-store.js";
 import { buildP2PTools } from "./agent-tools.js";
 import { registerLibp2pMeshCli } from "./profile-cli.js";
+const DEFAULT_PUBLIC_ATTRIBUTE_REFRESH_STARTUP_DELAY_MS = 10000;
 export function registerLibp2pMesh(api) {
     registerLibp2pMeshWithDeps(api);
 }
@@ -18,6 +19,7 @@ export function registerLibp2pMeshWithDeps(api, deps = {}) {
     let unsubscribeInbound;
     let serviceStarted = false;
     let startPromise;
+    let publicAttributeRefreshTimer;
     const mesh = (deps.createMeshNetwork ?? createMeshNetwork)({
         config,
         logger: api.logger,
@@ -50,6 +52,7 @@ export function registerLibp2pMeshWithDeps(api, deps = {}) {
         userAttributeSource,
         userProfileStore,
         peerLabelStore,
+        publicAttributeRefreshInitiallyEnabled: false,
     });
     registerLibp2pMeshCli(api, {
         profile: {
@@ -91,7 +94,28 @@ export function registerLibp2pMeshWithDeps(api, deps = {}) {
             }
         });
     }
+    function publicAttributeRefreshStartupDelayMs() {
+        const configured = config?.publicAttributeRefreshStartupDelayMs;
+        if (typeof configured === "number" && Number.isFinite(configured) && configured >= 0) {
+            return configured;
+        }
+        return DEFAULT_PUBLIC_ATTRIBUTE_REFRESH_STARTUP_DELAY_MS;
+    }
+    function clearPublicAttributeRefreshTimer() {
+        if (publicAttributeRefreshTimer) {
+            clearTimeout(publicAttributeRefreshTimer);
+            publicAttributeRefreshTimer = undefined;
+        }
+    }
+    function schedulePublicAttributeRefreshEnable() {
+        clearPublicAttributeRefreshTimer();
+        publicAttributeRefreshTimer = setTimeout(() => {
+            publicAttributeRefreshTimer = undefined;
+            router.enablePublicAttributeRefresh();
+        }, publicAttributeRefreshStartupDelayMs());
+    }
     async function cleanupStartupFailure() {
+        clearPublicAttributeRefreshTimer();
         try {
             unsubscribeInbound?.();
         }
@@ -149,6 +173,7 @@ export function registerLibp2pMeshWithDeps(api, deps = {}) {
                         api.logger.info?.(`[libp2p-mesh] Active relay reservations: ${nat.reservedRelays.join(", ")}`);
                     }
                     serviceStarted = true;
+                    schedulePublicAttributeRefreshEnable();
                 }
                 catch (error) {
                     await cleanupStartupFailure();
@@ -162,6 +187,7 @@ export function registerLibp2pMeshWithDeps(api, deps = {}) {
         },
         stop: async () => {
             await startPromise?.catch(() => undefined);
+            clearPublicAttributeRefreshTimer();
             unsubscribeInbound?.();
             unsubscribeInbound = undefined;
             await router.stop();

package/dist/src/prompt-config.js

@@ -40,7 +40,7 @@ export const LIBP2P_MESH_AGENT_PROMPT = `
 
    - \`source="USER.md"\` 表示 gateway 使用 OpenClaw 已配置的 agent/API 模型，从 USER.md 异步提取并公开广播的 tag。
    - \`source="profile"\` 表示用户通过 \`openclaw libp2p-mesh profile\` 手动配置的公开结构化属性。
-   - gateway 的基础 \`instance-announce\` 可能省略 \`userPublicAttributes\`；这表示本次 announce 没有携带属性，不一定表示该用户没有公开属性。按公开属性发送前先用 \`p2p_list_instances\` 查看当前实例记录。
+   - gateway 的基础 \`instance-announce\` 可能省略 \`userPublicAttributes\`；这表示本次 announce 没有携带属性，不一定表示该用户没有公开属性。启动后 USER.md 属性刷新可能会延迟数秒完成。按公开属性发送前先用 \`p2p_list_instances\` 查看当前实例记录。
    - 普通对话 agent 不应自己读取 USER.md 来决定公开属性。USER.md 属性提取是 gateway 后台职责。
 
 3. \`openclaw libp2p-mesh labels\` manages local labels for remote instances. These labels are stored in the local \`peer-labels.json\`, stay on this machine, and are used only when the send tool uses \`scope="local"\` or \`scope="all"\`.

package/dist/src/types.d.ts

@@ -216,6 +216,7 @@ export type InstanceRouterOptions = {
     peerLabelStore?: {
         listLabels(instanceId: string): Promise<LocalPeerLabelAttribute[]>;
     };
+    publicAttributeRefreshInitiallyEnabled?: boolean;
 };
 export interface InstanceRouter {
     attachHandlers(): void;
@@ -224,6 +225,7 @@ export interface InstanceRouter {
     stop(): Promise<void>;
     handleMessage(msg: P2PMessage): Promise<void>;
     announceToPeer(peerId: string): Promise<void>;
+    enablePublicAttributeRefresh(): void;
     refreshPublicAttributes(): Promise<void>;
     listInstances(): Promise<InstancePeerRecord[]>;
     resolveInstance(instanceId: string): Promise<InstancePeerRecord | undefined>;
@@ -246,6 +248,7 @@ export interface MeshConfig {
     bootstrapList?: string[];
     meshTopic?: string;
     announceLogDetail?: AnnounceLogDetail;
+    publicAttributeRefreshStartupDelayMs?: number;
     enableAgentSync?: boolean;
     enableWebSocket?: boolean;
     peerIdPath?: string;

package/dist/src/user-md-openclaw-extractor.js

@@ -1,4 +1,4 @@
-import { createHash } from "node:crypto";
+import { createHash, randomUUID } from "node:crypto";
 import { validateExtractedUserMdTags } from "./user-md-agent-attributes.js";
 const EXTRACTION_TIMEOUT_MS = 30000;
 const SESSION_HASH_LENGTH = 16;
@@ -100,7 +100,7 @@ export function createOpenClawUserMdAttributeExtractor(api, options) {
             if (!subagent?.run || !subagent.waitForRun || !subagent.getSessionMessages) {
                 return unavailable("OpenClaw subagent runtime is unavailable");
             }
-            const sessionKey = `libp2p-mesh:user-md-attributes:${hashForSessionKey(sourcePath)}`;
+            const sessionKey = `libp2p-mesh:user-md-attributes:${hashForSessionKey(sourcePath)}:${randomUUID()}`;
             try {
                 await subagent.deleteSession?.({ sessionKey, deleteTranscript: true }).catch(() => undefined);
                 const { runId } = await subagent.run({

package/package.json

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

package/src/instance-router.ts

@@ -218,6 +218,7 @@ export function createInstanceRouter(options: InstanceRouterOptions): InstanceRo
   const deliveryCache = new Map<string, DeliveryCacheEntry>();
   const unsubs: Array<() => void> = [];
   const pendingAttributePeers = new Set<string>();
+  let publicAttributeRefreshEnabled = options.publicAttributeRefreshInitiallyEnabled !== false;
   let attributeRefreshPromise: Promise<void> | undefined;
 
   function localInstanceId(): string {
@@ -335,7 +336,9 @@ export function createInstanceRouter(options: InstanceRouterOptions): InstanceRo
       return;
     }
 
-    drainAttributeRefresh();
+    if (publicAttributeRefreshEnabled) {
+      drainAttributeRefresh();
+    }
   }
 
   function drainAttributeRefresh(): Promise<void> {
@@ -358,6 +361,13 @@ export function createInstanceRouter(options: InstanceRouterOptions): InstanceRo
     return attributeRefreshPromise;
   }
 
+  function enablePublicAttributeRefresh(): void {
+    publicAttributeRefreshEnabled = true;
+    if (pendingAttributePeers.size > 0) {
+      drainAttributeRefresh();
+    }
+  }
+
   async function announceToPeer(peerId: string): Promise<void> {
     if (!isNonEmptyString(peerId) || peerId === mesh.getLocalPeerId()) {
       return;
@@ -896,6 +906,7 @@ export function createInstanceRouter(options: InstanceRouterOptions): InstanceRo
     stop,
     handleMessage,
     announceToPeer,
+    enablePublicAttributeRefresh,
     refreshPublicAttributes,
     listInstances,
     resolveInstance,

package/src/plugin.ts

@@ -14,6 +14,8 @@ import { registerLibp2pMeshCli } from "./profile-cli.js";
 import type { ChannelPlugin } from "openclaw/plugin-sdk/core";
 import type { MeshConfig } from "./types.js";
 
+const DEFAULT_PUBLIC_ATTRIBUTE_REFRESH_STARTUP_DELAY_MS = 10000;
+
 export type Libp2pMeshPluginDeps = {
   createMeshNetwork?: typeof createMeshNetwork;
   createInstanceRouter?: typeof createInstanceRouter;
@@ -31,6 +33,7 @@ export function registerLibp2pMeshWithDeps(
   let unsubscribeInbound: (() => void) | undefined;
   let serviceStarted = false;
   let startPromise: Promise<void> | undefined;
+  let publicAttributeRefreshTimer: ReturnType<typeof setTimeout> | undefined;
   const mesh = (deps.createMeshNetwork ?? createMeshNetwork)({
     config,
     logger: api.logger,
@@ -65,6 +68,7 @@ export function registerLibp2pMeshWithDeps(
     userAttributeSource,
     userProfileStore,
     peerLabelStore,
+    publicAttributeRefreshInitiallyEnabled: false,
   });
 
   registerLibp2pMeshCli(api, {
@@ -114,7 +118,31 @@ export function registerLibp2pMeshWithDeps(
     });
   }
 
+  function publicAttributeRefreshStartupDelayMs(): number {
+    const configured = config?.publicAttributeRefreshStartupDelayMs;
+    if (typeof configured === "number" && Number.isFinite(configured) && configured >= 0) {
+      return configured;
+    }
+    return DEFAULT_PUBLIC_ATTRIBUTE_REFRESH_STARTUP_DELAY_MS;
+  }
+
+  function clearPublicAttributeRefreshTimer(): void {
+    if (publicAttributeRefreshTimer) {
+      clearTimeout(publicAttributeRefreshTimer);
+      publicAttributeRefreshTimer = undefined;
+    }
+  }
+
+  function schedulePublicAttributeRefreshEnable(): void {
+    clearPublicAttributeRefreshTimer();
+    publicAttributeRefreshTimer = setTimeout(() => {
+      publicAttributeRefreshTimer = undefined;
+      router.enablePublicAttributeRefresh();
+    }, publicAttributeRefreshStartupDelayMs());
+  }
+
   async function cleanupStartupFailure(): Promise<void> {
+    clearPublicAttributeRefreshTimer();
     try {
       unsubscribeInbound?.();
     } catch (error) {
@@ -186,6 +214,7 @@ export function registerLibp2pMeshWithDeps(
             );
           }
           serviceStarted = true;
+          schedulePublicAttributeRefreshEnable();
         } catch (error) {
           await cleanupStartupFailure();
           throw error;
@@ -198,6 +227,7 @@ export function registerLibp2pMeshWithDeps(
     },
     stop: async () => {
       await startPromise?.catch(() => undefined);
+      clearPublicAttributeRefreshTimer();
       unsubscribeInbound?.();
       unsubscribeInbound = undefined;
       await router.stop();

package/src/prompt-config.ts

@@ -42,7 +42,7 @@ export const LIBP2P_MESH_AGENT_PROMPT = `
 
    - \`source="USER.md"\` 表示 gateway 使用 OpenClaw 已配置的 agent/API 模型，从 USER.md 异步提取并公开广播的 tag。
    - \`source="profile"\` 表示用户通过 \`openclaw libp2p-mesh profile\` 手动配置的公开结构化属性。
-   - gateway 的基础 \`instance-announce\` 可能省略 \`userPublicAttributes\`；这表示本次 announce 没有携带属性，不一定表示该用户没有公开属性。按公开属性发送前先用 \`p2p_list_instances\` 查看当前实例记录。
+   - gateway 的基础 \`instance-announce\` 可能省略 \`userPublicAttributes\`；这表示本次 announce 没有携带属性，不一定表示该用户没有公开属性。启动后 USER.md 属性刷新可能会延迟数秒完成。按公开属性发送前先用 \`p2p_list_instances\` 查看当前实例记录。
    - 普通对话 agent 不应自己读取 USER.md 来决定公开属性。USER.md 属性提取是 gateway 后台职责。
 
 3. \`openclaw libp2p-mesh labels\` manages local labels for remote instances. These labels are stored in the local \`peer-labels.json\`, stay on this machine, and are used only when the send tool uses \`scope="local"\` or \`scope="all"\`.

package/src/types.ts

@@ -244,6 +244,7 @@ export type InstanceRouterOptions = {
   peerLabelStore?: {
     listLabels(instanceId: string): Promise<LocalPeerLabelAttribute[]>;
   };
+  publicAttributeRefreshInitiallyEnabled?: boolean;
 };
 
 export interface InstanceRouter {
@@ -253,6 +254,7 @@ export interface InstanceRouter {
   stop(): Promise<void>;
   handleMessage(msg: P2PMessage): Promise<void>;
   announceToPeer(peerId: string): Promise<void>;
+  enablePublicAttributeRefresh(): void;
   refreshPublicAttributes(): Promise<void>;
   listInstances(): Promise<InstancePeerRecord[]>;
   resolveInstance(instanceId: string): Promise<InstancePeerRecord | undefined>;
@@ -280,6 +282,7 @@ export interface MeshConfig {
   bootstrapList?: string[];
   meshTopic?: string;
   announceLogDetail?: AnnounceLogDetail;
+  publicAttributeRefreshStartupDelayMs?: number;
   enableAgentSync?: boolean;
   enableWebSocket?: boolean;
   peerIdPath?: string;

package/src/user-md-openclaw-extractor.ts

@@ -1,4 +1,4 @@
-import { createHash } from "node:crypto";
+import { createHash, randomUUID } from "node:crypto";
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk/core";
 import type { UserPublicAttribute } from "./types.js";
 import type {
@@ -134,7 +134,7 @@ export function createOpenClawUserMdAttributeExtractor(
         return unavailable("OpenClaw subagent runtime is unavailable");
       }
 
-      const sessionKey = `libp2p-mesh:user-md-attributes:${hashForSessionKey(sourcePath)}`;
+      const sessionKey = `libp2p-mesh:user-md-attributes:${hashForSessionKey(sourcePath)}:${randomUUID()}`;
 
       try {
         await subagent.deleteSession?.({ sessionKey, deleteTranscript: true }).catch(() => undefined);