libp2p-mesh 2026.6.21 → 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

@@ -6,9 +6,11 @@ import { createInstanceRouter } from "./instance-router.js";
 import { createMeshNetwork } from "./mesh.js";
 import { createPeerLabelStore } from "./peer-label-store.js";
 import { createUserMdAgentAttributeSource } from "./user-md-agent-attributes.js";
+import { createOpenClawUserMdAttributeExtractor } from "./user-md-openclaw-extractor.js";
 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);
 }
@@ -17,13 +19,17 @@ export function registerLibp2pMeshWithDeps(api, deps = {}) {
     let unsubscribeInbound;
     let serviceStarted = false;
     let startPromise;
+    let publicAttributeRefreshTimer;
     const mesh = (deps.createMeshNetwork ?? createMeshNetwork)({
         config,
         logger: api.logger,
     });
     const store = createInstancePeerStore({ logger: api.logger });
     const peerLabelStore = createPeerLabelStore({ logger: api.logger });
-    const userAttributeSource = createUserMdAgentAttributeSource({ logger: api.logger });
+    const userAttributeSource = createUserMdAgentAttributeSource({
+        logger: api.logger,
+        extractor: createOpenClawUserMdAttributeExtractor(api),
+    });
     const userProfileStore = createUserProfileStore({ logger: api.logger });
     const delivery = createOpenClawRuntimeInboundDelivery({
         config: api.config,
@@ -46,6 +52,7 @@ export function registerLibp2pMeshWithDeps(api, deps = {}) {
         userAttributeSource,
         userProfileStore,
         peerLabelStore,
+        publicAttributeRefreshInitiallyEnabled: false,
     });
     registerLibp2pMeshCli(api, {
         profile: {
@@ -87,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?.();
         }
@@ -145,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();
@@ -158,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.d.ts

@@ -0,0 +1,14 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk/core";
+import type { UserPublicAttribute } from "./types.js";
+import type { UserMdAttributeExtractor } from "./user-md-agent-attributes.js";
+export declare const USER_MD_ATTRIBUTE_EXTRACTION_PROMPT: string;
+type Logger = {
+    warn?: (message: string) => void;
+};
+export declare function extractLatestAssistantText(messages: unknown[]): string | undefined;
+export declare function parseUserMdAttributeResponse(text: string): UserPublicAttribute[];
+export declare function createOpenClawUserMdAttributeExtractor(api: OpenClawPluginApi, options?: {
+    timeoutMs?: number;
+    logger?: Logger;
+}): UserMdAttributeExtractor;
+export {};

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

@@ -0,0 +1,135 @@
+import { createHash, randomUUID } from "node:crypto";
+import { validateExtractedUserMdTags } from "./user-md-agent-attributes.js";
+const EXTRACTION_TIMEOUT_MS = 30000;
+const SESSION_HASH_LENGTH = 16;
+export const USER_MD_ATTRIBUTE_EXTRACTION_PROMPT = [
+    "你是 libp2p-mesh 的 USER.md 公开属性提取器。",
+    "",
+    "任务：从 USER.md 中提取少量适合公开广播的用户 tag。",
+    "",
+    "规则：",
+    "- 只输出 JSON 数组，不要输出解释、Markdown 或代码块。",
+    '- 每项必须是：{"kind":"tag","value":"...","label":"...","source":"USER.md"}',
+    "- 最多 10 个。",
+    "- 每个 value 不超过 40 个字符。",
+    "- 不要提取寒暄、联系方式提示、占位内容、完整句子。",
+    "- 不要提取“刚认识”“还在了解”“随时告诉我”这类无分类价值内容。",
+    "- 优先提取稳定身份、技术方向、项目方向、长期偏好。",
+].join("\n");
+function hashForSessionKey(value) {
+    return createHash("sha256").update(value, "utf8").digest("hex").slice(0, SESSION_HASH_LENGTH);
+}
+function buildUserMdExtractionMessage(markdown, sourcePath) {
+    return [
+        `sourcePath: ${sourcePath}`,
+        "",
+        "USER.md:",
+        "```md",
+        markdown,
+        "```",
+        "",
+        "只输出 JSON 数组。",
+    ].join("\n");
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function extractTextFromContent(content) {
+    if (typeof content === "string") {
+        return content;
+    }
+    if (!Array.isArray(content)) {
+        return undefined;
+    }
+    const parts = [];
+    for (const item of content) {
+        if (typeof item === "string") {
+            parts.push(item);
+            continue;
+        }
+        if (!isRecord(item)) {
+            continue;
+        }
+        if (typeof item.text === "string") {
+            parts.push(item.text);
+            continue;
+        }
+        if (typeof item.content === "string") {
+            parts.push(item.content);
+        }
+    }
+    return parts.length > 0 ? parts.join("") : undefined;
+}
+export function extractLatestAssistantText(messages) {
+    for (let index = messages.length - 1; index >= 0; index -= 1) {
+        const message = messages[index];
+        if (!isRecord(message) || message.role !== "assistant") {
+            continue;
+        }
+        const text = extractTextFromContent(message.content) ??
+            (typeof message.text === "string" ? message.text : undefined) ??
+            (typeof message.message === "string" ? message.message : undefined);
+        if (text?.trim()) {
+            return text;
+        }
+    }
+    return undefined;
+}
+function stripJsonFence(text) {
+    const trimmed = text.trim();
+    const fenced = trimmed.match(/^```(?:json)?\s*([\s\S]*?)\s*```$/i);
+    return fenced ? fenced[1].trim() : trimmed;
+}
+export function parseUserMdAttributeResponse(text) {
+    try {
+        return validateExtractedUserMdTags(JSON.parse(stripJsonFence(text)));
+    }
+    catch {
+        return [];
+    }
+}
+function unavailable(reason) {
+    return { unavailable: true, reason };
+}
+export function createOpenClawUserMdAttributeExtractor(api, options) {
+    const timeoutMs = options?.timeoutMs ?? EXTRACTION_TIMEOUT_MS;
+    const logger = options?.logger ?? api.logger;
+    return {
+        async extract({ markdown, sourcePath }) {
+            const subagent = api.runtime?.subagent;
+            if (!subagent?.run || !subagent.waitForRun || !subagent.getSessionMessages) {
+                return unavailable("OpenClaw subagent runtime is unavailable");
+            }
+            const sessionKey = `libp2p-mesh:user-md-attributes:${hashForSessionKey(sourcePath)}:${randomUUID()}`;
+            try {
+                await subagent.deleteSession?.({ sessionKey, deleteTranscript: true }).catch(() => undefined);
+                const { runId } = await subagent.run({
+                    sessionKey,
+                    message: buildUserMdExtractionMessage(markdown, sourcePath),
+                    extraSystemPrompt: USER_MD_ATTRIBUTE_EXTRACTION_PROMPT,
+                    lane: "libp2p-mesh-user-md-attributes",
+                    lightContext: true,
+                    deliver: false,
+                });
+                const waitResult = await subagent.waitForRun({ runId, timeoutMs });
+                if (waitResult.status !== "ok") {
+                    return unavailable(waitResult.error ?? `OpenClaw subagent extraction ${waitResult.status}`);
+                }
+                const { messages } = await subagent.getSessionMessages({ sessionKey, limit: 10 });
+                const text = extractLatestAssistantText(messages);
+                if (!text) {
+                    return [];
+                }
+                return parseUserMdAttributeResponse(text);
+            }
+            catch (error) {
+                const reason = error instanceof Error ? error.message : String(error);
+                logger?.warn?.(`[libp2p-mesh] USER.md agent extraction failed: ${reason}`);
+                return unavailable(reason);
+            }
+            finally {
+                await subagent.deleteSession?.({ sessionKey, deleteTranscript: true }).catch(() => undefined);
+            }
+        },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libp2p-mesh",
-  "version": "2026.6.21",
+  "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

@@ -7,12 +7,15 @@ import { createInstanceRouter } from "./instance-router.js";
 import { createMeshNetwork } from "./mesh.js";
 import { createPeerLabelStore } from "./peer-label-store.js";
 import { createUserMdAgentAttributeSource } from "./user-md-agent-attributes.js";
+import { createOpenClawUserMdAttributeExtractor } from "./user-md-openclaw-extractor.js";
 import { createUserProfileStore } from "./user-profile-store.js";
 import { buildP2PTools } from "./agent-tools.js";
 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;
@@ -30,13 +33,17 @@ 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,
   });
   const store = createInstancePeerStore({ logger: api.logger });
   const peerLabelStore = createPeerLabelStore({ logger: api.logger });
-  const userAttributeSource = createUserMdAgentAttributeSource({ logger: api.logger });
+  const userAttributeSource = createUserMdAgentAttributeSource({
+    logger: api.logger,
+    extractor: createOpenClawUserMdAttributeExtractor(api),
+  });
   const userProfileStore = createUserProfileStore({ logger: api.logger });
   const delivery = createOpenClawRuntimeInboundDelivery({
     config: api.config,
@@ -61,6 +68,7 @@ export function registerLibp2pMeshWithDeps(
     userAttributeSource,
     userProfileStore,
     peerLabelStore,
+    publicAttributeRefreshInitiallyEnabled: false,
   });
 
   registerLibp2pMeshCli(api, {
@@ -110,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) {
@@ -182,6 +214,7 @@ export function registerLibp2pMeshWithDeps(
             );
           }
           serviceStarted = true;
+          schedulePublicAttributeRefreshEnable();
         } catch (error) {
           await cleanupStartupFailure();
           throw error;
@@ -194,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

@@ -0,0 +1,171 @@
+import { createHash, randomUUID } from "node:crypto";
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk/core";
+import type { UserPublicAttribute } from "./types.js";
+import type {
+  UserMdAttributeExtractionUnavailable,
+  UserMdAttributeExtractor,
+} from "./user-md-agent-attributes.js";
+import { validateExtractedUserMdTags } from "./user-md-agent-attributes.js";
+
+const EXTRACTION_TIMEOUT_MS = 30000;
+const SESSION_HASH_LENGTH = 16;
+
+export const USER_MD_ATTRIBUTE_EXTRACTION_PROMPT = [
+  "你是 libp2p-mesh 的 USER.md 公开属性提取器。",
+  "",
+  "任务：从 USER.md 中提取少量适合公开广播的用户 tag。",
+  "",
+  "规则：",
+  "- 只输出 JSON 数组，不要输出解释、Markdown 或代码块。",
+  '- 每项必须是：{"kind":"tag","value":"...","label":"...","source":"USER.md"}',
+  "- 最多 10 个。",
+  "- 每个 value 不超过 40 个字符。",
+  "- 不要提取寒暄、联系方式提示、占位内容、完整句子。",
+  "- 不要提取“刚认识”“还在了解”“随时告诉我”这类无分类价值内容。",
+  "- 优先提取稳定身份、技术方向、项目方向、长期偏好。",
+].join("\n");
+
+type Logger = {
+  warn?: (message: string) => void;
+};
+
+function hashForSessionKey(value: string): string {
+  return createHash("sha256").update(value, "utf8").digest("hex").slice(0, SESSION_HASH_LENGTH);
+}
+
+function buildUserMdExtractionMessage(markdown: string, sourcePath: string): string {
+  return [
+    `sourcePath: ${sourcePath}`,
+    "",
+    "USER.md:",
+    "```md",
+    markdown,
+    "```",
+    "",
+    "只输出 JSON 数组。",
+  ].join("\n");
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null;
+}
+
+function extractTextFromContent(content: unknown): string | undefined {
+  if (typeof content === "string") {
+    return content;
+  }
+
+  if (!Array.isArray(content)) {
+    return undefined;
+  }
+
+  const parts: string[] = [];
+  for (const item of content) {
+    if (typeof item === "string") {
+      parts.push(item);
+      continue;
+    }
+    if (!isRecord(item)) {
+      continue;
+    }
+    if (typeof item.text === "string") {
+      parts.push(item.text);
+      continue;
+    }
+    if (typeof item.content === "string") {
+      parts.push(item.content);
+    }
+  }
+
+  return parts.length > 0 ? parts.join("") : undefined;
+}
+
+export function extractLatestAssistantText(messages: unknown[]): string | undefined {
+  for (let index = messages.length - 1; index >= 0; index -= 1) {
+    const message = messages[index];
+    if (!isRecord(message) || message.role !== "assistant") {
+      continue;
+    }
+
+    const text =
+      extractTextFromContent(message.content) ??
+      (typeof message.text === "string" ? message.text : undefined) ??
+      (typeof message.message === "string" ? message.message : undefined);
+    if (text?.trim()) {
+      return text;
+    }
+  }
+
+  return undefined;
+}
+
+function stripJsonFence(text: string): string {
+  const trimmed = text.trim();
+  const fenced = trimmed.match(/^```(?:json)?\s*([\s\S]*?)\s*```$/i);
+  return fenced ? fenced[1].trim() : trimmed;
+}
+
+export function parseUserMdAttributeResponse(text: string): UserPublicAttribute[] {
+  try {
+    return validateExtractedUserMdTags(JSON.parse(stripJsonFence(text)));
+  } catch {
+    return [];
+  }
+}
+
+function unavailable(reason: string): UserMdAttributeExtractionUnavailable {
+  return { unavailable: true, reason };
+}
+
+export function createOpenClawUserMdAttributeExtractor(
+  api: OpenClawPluginApi,
+  options?: {
+    timeoutMs?: number;
+    logger?: Logger;
+  },
+): UserMdAttributeExtractor {
+  const timeoutMs = options?.timeoutMs ?? EXTRACTION_TIMEOUT_MS;
+  const logger = options?.logger ?? api.logger;
+
+  return {
+    async extract({ markdown, sourcePath }) {
+      const subagent = api.runtime?.subagent;
+      if (!subagent?.run || !subagent.waitForRun || !subagent.getSessionMessages) {
+        return unavailable("OpenClaw subagent runtime is unavailable");
+      }
+
+      const sessionKey = `libp2p-mesh:user-md-attributes:${hashForSessionKey(sourcePath)}:${randomUUID()}`;
+
+      try {
+        await subagent.deleteSession?.({ sessionKey, deleteTranscript: true }).catch(() => undefined);
+        const { runId } = await subagent.run({
+          sessionKey,
+          message: buildUserMdExtractionMessage(markdown, sourcePath),
+          extraSystemPrompt: USER_MD_ATTRIBUTE_EXTRACTION_PROMPT,
+          lane: "libp2p-mesh-user-md-attributes",
+          lightContext: true,
+          deliver: false,
+        });
+
+        const waitResult = await subagent.waitForRun({ runId, timeoutMs });
+        if (waitResult.status !== "ok") {
+          return unavailable(waitResult.error ?? `OpenClaw subagent extraction ${waitResult.status}`);
+        }
+
+        const { messages } = await subagent.getSessionMessages({ sessionKey, limit: 10 });
+        const text = extractLatestAssistantText(messages);
+        if (!text) {
+          return [];
+        }
+
+        return parseUserMdAttributeResponse(text);
+      } catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        logger?.warn?.(`[libp2p-mesh] USER.md agent extraction failed: ${reason}`);
+        return unavailable(reason);
+      } finally {
+        await subagent.deleteSession?.({ sessionKey, deleteTranscript: true }).catch(() => undefined);
+      }
+    },
+  };
+}