libp2p-mesh 2026.6.16 → 2026.6.18

package/README.md

@@ -572,7 +572,7 @@ Use `p2p_send_user_attribute_message` for attribute-based group messages. Always
 
 ```text
 p2p_send_user_attribute_message({
-  "match": { "kind": "structured", "key": "project", "value": "openclaw" },
+  "selector": "project=openclaw",
   "message": "今晚同步一下进展",
   "dryRun": true
 })
@@ -582,17 +582,17 @@ After confirming the dry-run targets:
 
 ```text
 p2p_send_user_attribute_message({
-  "match": { "kind": "structured", "key": "project", "value": "openclaw" },
+  "selector": "project=openclaw",
   "message": "今晚同步一下进展",
   "dryRun": false
 })
 ```
 
-Tag matches use only the tag value:
+Selectors use `key=value` for structured profile attributes. Tag matches use `tag:value` or `#value`. Bare selectors such as `实验室` are rejected because they are ambiguous; use `group=实验室` for a structured group or `tag:实验室` for a USER.md tag.
 
 ```text
 p2p_send_user_attribute_message({
-  "match": { "kind": "tag", "value": "libp2p" },
+  "selector": "#libp2p",
   "message": "libp2p 方向有个问题想确认",
   "dryRun": true
 })

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

@@ -1,5 +1,6 @@
 import type { DeliveryTargetResult, InstanceRouter, MeshNetwork, UserPublicAttribute } from "./types.js";
 type SendUserAttributeToolParams = {
+    selector?: unknown;
     match?: {
         kind?: unknown;
         key?: unknown;
@@ -25,6 +26,7 @@ export declare function buildP2PTools(mesh: MeshNetwork, router?: InstanceRouter
             };
             topic?: undefined;
             instanceId?: undefined;
+            selector?: undefined;
             match?: undefined;
             dryRun?: undefined;
         };
@@ -73,6 +75,7 @@ export declare function buildP2PTools(mesh: MeshNetwork, router?: InstanceRouter
             };
             peerId?: undefined;
             instanceId?: undefined;
+            selector?: undefined;
             match?: undefined;
             dryRun?: undefined;
         };
@@ -115,6 +118,7 @@ export declare function buildP2PTools(mesh: MeshNetwork, router?: InstanceRouter
             message?: undefined;
             topic?: undefined;
             instanceId?: undefined;
+            selector?: undefined;
             match?: undefined;
             dryRun?: undefined;
         };
@@ -156,6 +160,7 @@ export declare function buildP2PTools(mesh: MeshNetwork, router?: InstanceRouter
             message?: undefined;
             topic?: undefined;
             instanceId?: undefined;
+            selector?: undefined;
             match?: undefined;
             dryRun?: undefined;
         };
@@ -206,6 +211,7 @@ export declare function buildP2PTools(mesh: MeshNetwork, router?: InstanceRouter
             message?: undefined;
             topic?: undefined;
             instanceId?: undefined;
+            selector?: undefined;
             match?: undefined;
             dryRun?: undefined;
         };
@@ -249,6 +255,7 @@ export declare function buildP2PTools(mesh: MeshNetwork, router?: InstanceRouter
             message?: undefined;
             topic?: undefined;
             instanceId?: undefined;
+            selector?: undefined;
             match?: undefined;
             dryRun?: undefined;
         };
@@ -316,6 +323,7 @@ export declare function buildP2PTools(mesh: MeshNetwork, router?: InstanceRouter
             peerId?: undefined;
             message?: undefined;
             topic?: undefined;
+            selector?: undefined;
             match?: undefined;
             dryRun?: undefined;
         };
@@ -393,6 +401,7 @@ export declare function buildP2PTools(mesh: MeshNetwork, router?: InstanceRouter
             };
             peerId?: undefined;
             topic?: undefined;
+            selector?: undefined;
             match?: undefined;
             dryRun?: undefined;
         };
@@ -463,8 +472,13 @@ export declare function buildP2PTools(mesh: MeshNetwork, router?: InstanceRouter
     parameters: {
         type: "object";
         properties: {
+            selector: {
+                type: "string";
+                description: string;
+            };
             match: {
                 type: "object";
+                deprecated: boolean;
                 description: string;
                 oneOf: ({
                     type: "object";

package/dist/src/agent-tools.js

@@ -37,10 +37,37 @@ function formatUserAttributeResults(results) {
         return `${instanceTargetLabel(result)}：${status}`;
     });
 }
+function normalizeUserAttributeSelector(selector) {
+    const value = typeof selector === "string" ? selector.trim() : "";
+    if (!value) {
+        return "selector is required.";
+    }
+    if (value.startsWith("#")) {
+        const tagValue = value.slice(1).trim();
+        return tagValue ? { kind: "tag", value: tagValue } : "selector tag value is required.";
+    }
+    const tagMatch = /^tag\s*:\s*(.+)$/i.exec(value);
+    if (tagMatch) {
+        const tagValue = tagMatch[1].trim();
+        return tagValue ? { kind: "tag", value: tagValue } : "selector tag value is required.";
+    }
+    const structuredMatch = /^([A-Za-z][A-Za-z0-9_-]*)\s*=\s*(.+)$/.exec(value);
+    if (structuredMatch) {
+        const key = structuredMatch[1].trim();
+        const attributeValue = structuredMatch[2].trim();
+        return key && attributeValue
+            ? { kind: "structured", key, value: attributeValue }
+            : "selector key and value are required.";
+    }
+    return `selector "${value}" is ambiguous. Use "group=${value}" for structured group matching or "tag:${value}" for USER.md tags.`;
+}
 function normalizeUserAttributeMatch(params) {
+    if (params.selector !== undefined) {
+        return normalizeUserAttributeSelector(params.selector);
+    }
     const match = params.match;
     if (!match || typeof match !== "object") {
-        return "match is required.";
+        return "selector is required.";
     }
     if (match.kind === "tag") {
         const value = typeof match.value === "string" ? match.value.trim() : "";
@@ -415,13 +442,18 @@ export function buildP2PTools(mesh, router) {
         {
             name: "p2p_send_user_attribute_message",
             label: "P2P Send User Attribute Message",
-            description: "Send a user message to discovered OpenClaw instances matching a public user attribute. Always run a dry run with dryRun=true first and ask the user to confirm targets before group sending.",
+            description: 'Send a user message to discovered OpenClaw instances matching a public user attribute selector. Use selectors like "group=实验室", "project=小龙虾", "tag:P2P", or "#P2P". Always run a dry run with dryRun=true first and ask the user to confirm targets before group sending.',
             parameters: {
                 type: "object",
                 properties: {
+                    selector: {
+                        type: "string",
+                        description: 'Public attribute selector. Use "key=value" for structured profile attributes such as "group=实验室" or "project=小龙虾"; use "tag:value" or "#value" for USER.md tags. Bare values are rejected as ambiguous.',
+                    },
                     match: {
                         type: "object",
-                        description: 'User public attribute match. Use { "kind": "tag", "value": "..." } for USER.md tags or { "kind": "structured", "key": "...", "value": "..." } for profile attributes.',
+                        deprecated: true,
+                        description: 'Deprecated compatibility field. Prefer selector. Use { "kind": "tag", "value": "..." } for USER.md tags or { "kind": "structured", "key": "...", "value": "..." } for profile attributes.',
                         oneOf: [
                             {
                                 type: "object",
@@ -462,7 +494,7 @@ export function buildP2PTools(mesh, router) {
                         description: "Preview matching instances without sending. Run this before group sending.",
                     },
                 },
-                required: ["match", "message"],
+                required: ["selector", "message"],
             },
             async execute(_toolCallId, params) {
                 if (!router) {

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

@@ -80,11 +80,14 @@ function isTemplateText(value) {
     return trimmed.length === 0 || TEMPLATE_PATTERN.test(trimmed) || /^\[[^\]]+\]$/.test(trimmed);
 }
 function stripMarkdown(line) {
+    return stripMarkdownSyntax(line).replace(FIELD_PREFIX_PATTERN, "").trim();
+}
+function stripMarkdownSyntax(line) {
     return line
-        .replace(FIELD_PREFIX_PATTERN, "")
         .replace(/`([^`]+)`/g, "$1")
         .replace(/\[([^\]]+)\]\([^)]+\)/g, "$1")
         .replace(/[*_~#>]/g, " ")
+        .replace(/\s+/g, " ")
         .trim();
 }
 function trimCandidate(value) {
@@ -128,13 +131,14 @@ function looksLikeSentence(value) {
     return /[。.!?]/.test(value) || value.split(/\s+/).filter(Boolean).length > 4;
 }
 function fieldValue(line) {
-    const match = line.match(FIELD_LINE_PATTERN);
+    const normalized = stripMarkdownSyntax(line);
+    const match = normalized.match(FIELD_LINE_PATTERN);
     if (!match) {
         return undefined;
     }
     return {
         field: (match[1] ?? "").toLowerCase(),
-        value: stripMarkdown(match[2] ?? ""),
+        value: stripMarkdownSyntax(match[2] ?? ""),
     };
 }
 function isStableEnglishCandidate(value) {

package/package.json

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

package/src/agent-tools.ts

@@ -59,6 +59,7 @@ function formatUserAttributeResults(results: UserAttributeMessageDeliveryResult[
 }
 
 type SendUserAttributeToolParams = {
+  selector?: unknown;
   match?: {
     kind?: unknown;
     key?: unknown;
@@ -68,10 +69,43 @@ type SendUserAttributeToolParams = {
   dryRun?: unknown;
 };
 
+function normalizeUserAttributeSelector(selector: unknown): UserAttributeMatch | string {
+  const value = typeof selector === "string" ? selector.trim() : "";
+  if (!value) {
+    return "selector is required.";
+  }
+
+  if (value.startsWith("#")) {
+    const tagValue = value.slice(1).trim();
+    return tagValue ? { kind: "tag", value: tagValue } : "selector tag value is required.";
+  }
+
+  const tagMatch = /^tag\s*:\s*(.+)$/i.exec(value);
+  if (tagMatch) {
+    const tagValue = tagMatch[1].trim();
+    return tagValue ? { kind: "tag", value: tagValue } : "selector tag value is required.";
+  }
+
+  const structuredMatch = /^([A-Za-z][A-Za-z0-9_-]*)\s*=\s*(.+)$/.exec(value);
+  if (structuredMatch) {
+    const key = structuredMatch[1].trim();
+    const attributeValue = structuredMatch[2].trim();
+    return key && attributeValue
+      ? { kind: "structured", key, value: attributeValue }
+      : "selector key and value are required.";
+  }
+
+  return `selector "${value}" is ambiguous. Use "group=${value}" for structured group matching or "tag:${value}" for USER.md tags.`;
+}
+
 function normalizeUserAttributeMatch(params: SendUserAttributeToolParams): UserAttributeMatch | string {
+  if (params.selector !== undefined) {
+    return normalizeUserAttributeSelector(params.selector);
+  }
+
   const match = params.match;
   if (!match || typeof match !== "object") {
-    return "match is required.";
+    return "selector is required.";
   }
 
   if (match.kind === "tag") {
@@ -452,14 +486,20 @@ export function buildP2PTools(mesh: MeshNetwork, router?: InstanceRouter) {
       name: "p2p_send_user_attribute_message",
       label: "P2P Send User Attribute Message",
       description:
-        "Send a user message to discovered OpenClaw instances matching a public user attribute. Always run a dry run with dryRun=true first and ask the user to confirm targets before group sending.",
+        'Send a user message to discovered OpenClaw instances matching a public user attribute selector. Use selectors like "group=实验室", "project=小龙虾", "tag:P2P", or "#P2P". Always run a dry run with dryRun=true first and ask the user to confirm targets before group sending.',
       parameters: {
         type: "object" as const,
         properties: {
+          selector: {
+            type: "string" as const,
+            description:
+              'Public attribute selector. Use "key=value" for structured profile attributes such as "group=实验室" or "project=小龙虾"; use "tag:value" or "#value" for USER.md tags. Bare values are rejected as ambiguous.',
+          },
           match: {
             type: "object" as const,
+            deprecated: true,
             description:
-              'User public attribute match. Use { "kind": "tag", "value": "..." } for USER.md tags or { "kind": "structured", "key": "...", "value": "..." } for profile attributes.',
+              'Deprecated compatibility field. Prefer selector. Use { "kind": "tag", "value": "..." } for USER.md tags or { "kind": "structured", "key": "...", "value": "..." } for profile attributes.',
             oneOf: [
               {
                 type: "object" as const,
@@ -500,7 +540,7 @@ export function buildP2PTools(mesh: MeshNetwork, router?: InstanceRouter) {
             description: "Preview matching instances without sending. Run this before group sending.",
           },
         },
-        required: ["match", "message"],
+        required: ["selector", "message"],
       },
       async execute(_toolCallId: string, params: SendUserAttributeToolParams) {
         if (!router) {

package/src/user-md-attributes.ts

@@ -101,11 +101,15 @@ function isTemplateText(value: string): boolean {
 }
 
 function stripMarkdown(line: string): string {
+  return stripMarkdownSyntax(line).replace(FIELD_PREFIX_PATTERN, "").trim();
+}
+
+function stripMarkdownSyntax(line: string): string {
   return line
-    .replace(FIELD_PREFIX_PATTERN, "")
     .replace(/`([^`]+)`/g, "$1")
     .replace(/\[([^\]]+)\]\([^)]+\)/g, "$1")
     .replace(/[*_~#>]/g, " ")
+    .replace(/\s+/g, " ")
     .trim();
 }
 
@@ -162,14 +166,15 @@ function looksLikeSentence(value: string): boolean {
 }
 
 function fieldValue(line: string): { field: string; value: string } | undefined {
-  const match = line.match(FIELD_LINE_PATTERN);
+  const normalized = stripMarkdownSyntax(line);
+  const match = normalized.match(FIELD_LINE_PATTERN);
   if (!match) {
     return undefined;
   }
 
   return {
     field: (match[1] ?? "").toLowerCase(),
-    value: stripMarkdown(match[2] ?? ""),
+    value: stripMarkdownSyntax(match[2] ?? ""),
   };
 }