libp2p-mesh 2026.6.14 → 2026.6.15

package/README.md

@@ -476,6 +476,18 @@ There are two sources:
 - `USER.md` tags are extracted read-only at gateway startup. The plugin never edits `USER.md`.
 - `user-profile.json` stores manually managed structured attributes such as group, project, role, skill, or a custom key.
 
+By default, `USER.md` is read from:
+
+```text
+~/.openclaw/workspace/USER.md
+```
+
+When `OPENCLAW_STATE_DIR` is set, the plugin reads:
+
+```text
+$OPENCLAW_STATE_DIR/workspace/USER.md
+```
+
 Run the profile wizard to manage structured attributes:
 
 ```bash

package/dist/src/user-md-attributes.d.ts

@@ -6,6 +6,7 @@ export type UserMdAttributeSource = {
         warn?: (message: string) => void;
     };
 };
+export declare function resolveUserMdPath(customPath?: string): string;
 export declare function extractUserMdTags(markdown: string): UserPublicAttribute[];
 export declare function createUserMdAttributeSource(options?: UserMdAttributeSource): {
     loadTags(): Promise<UserPublicAttribute[]>;

package/dist/src/user-md-attributes.js

@@ -1,4 +1,5 @@
 import { readFile } from "node:fs/promises";
+import { homedir } from "node:os";
 import path from "node:path";
 import { normalizeAttributeValue } from "./user-attributes.js";
 const MAX_TAGS = 10;
@@ -42,6 +43,16 @@ const ENGLISH_TAG_FIELDS = new Set([
     "interest",
     "interests",
 ]);
+export function resolveUserMdPath(customPath) {
+    if (customPath) {
+        return customPath;
+    }
+    const stateDir = process.env.OPENCLAW_STATE_DIR;
+    if (stateDir) {
+        return path.join(stateDir, "workspace", "USER.md");
+    }
+    return path.join(homedir(), ".openclaw", "workspace", "USER.md");
+}
 function isTemplateText(value) {
     const trimmed = value.trim();
     return trimmed.length === 0 || TEMPLATE_PATTERN.test(trimmed) || /^\[[^\]]+\]$/.test(trimmed);
@@ -183,7 +194,7 @@ export function extractUserMdTags(markdown) {
     return tags;
 }
 export function createUserMdAttributeSource(options) {
-    const filePath = options?.path ?? path.join(process.cwd(), "USER.md");
+    const filePath = resolveUserMdPath(options?.path);
     const logger = options?.logger;
     return {
         async loadTags() {

package/package.json

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

package/src/user-md-attributes.ts

@@ -1,4 +1,5 @@
 import { readFile } from "node:fs/promises";
+import { homedir } from "node:os";
 import path from "node:path";
 
 import type { UserPublicAttribute } from "./types.js";
@@ -59,6 +60,19 @@ export type UserMdAttributeSource = {
   };
 };
 
+export function resolveUserMdPath(customPath?: string): string {
+  if (customPath) {
+    return customPath;
+  }
+
+  const stateDir = process.env.OPENCLAW_STATE_DIR;
+  if (stateDir) {
+    return path.join(stateDir, "workspace", "USER.md");
+  }
+
+  return path.join(homedir(), ".openclaw", "workspace", "USER.md");
+}
+
 function isTemplateText(value: string): boolean {
   const trimmed = value.trim();
   return trimmed.length === 0 || TEMPLATE_PATTERN.test(trimmed) || /^\[[^\]]+\]$/.test(trimmed);
@@ -236,7 +250,7 @@ export function extractUserMdTags(markdown: string): UserPublicAttribute[] {
 export function createUserMdAttributeSource(options?: UserMdAttributeSource): {
   loadTags(): Promise<UserPublicAttribute[]>;
 } {
-  const filePath = options?.path ?? path.join(process.cwd(), "USER.md");
+  const filePath = resolveUserMdPath(options?.path);
   const logger = options?.logger;
 
   return {