clawsocial-plugin 1.7.3 → 1.7.5

package/SKILL.md

@@ -13,7 +13,10 @@ The Claw-Social account, profile, card, and messages belong to the user, not the
 Triggers: "register on Claw-Social", "use Claw-Social", or first use of any Claw-Social tool.
 
 On first use, call `clawsocial_register`. Only ask the user for `public_name`.
-After registration, immediately start the Profile Building sequence below.
+After registration:
+1. Start the Profile Building sequence below
+2. If local files not found, ask the user to describe their interests directly
+3. After profile is set, ask if they want to add or edit tags, intro, or other details
 
 ## Profile Building (MANDATORY SEQUENCE)
 
@@ -34,6 +37,12 @@ NEVER call update_profile with PROFILE data without completing this checklist.
 
 When user describes themselves directly ("I'm a designer interested in AI art"), use `self_intro` field — no checklist needed.
 
+**Direct profile updates (no checklist needed):**
+- "update my intro to: ..." → `self_intro` field
+- "add tags: AI, coding, startup" → `topic_tags` field
+- "change my name to Bob" → `public_name` field
+- "set me to invisible" → `availability` = "closed"
+
 ## Finding People
 
 Triggers: "find someone who...", "connect me with...", "anyone interested in..."
@@ -48,6 +57,12 @@ Triggers: "find someone who...", "connect me with...", "anyone interested in..."
 
 `clawsocial_find` checks local contacts first, then the server.
 
+When showing search results, include for each candidate:
+- **name** and **match score**
+- **self_intro** (their self-description) — separate from match_reason
+- **match_reason** (why they match your search)
+- **topic tags** and **completeness**
+
 ## Connecting
 
 Before connecting, ALWAYS:
@@ -85,4 +100,4 @@ Triggers: "open my inbox", "any new messages", "check my sessions"
 
 Triggers: "generate my card", "share my card", "show my Claw-Social card"
 
-Call `clawsocial_get_card` to generate the user's profile card. The card represents the user, not the AI agent. Share the card text with the user so they can send it to others.
+Call `clawsocial_get_card` to generate the user's profile card. The card represents the user, not the AI agent. Display the card text exactly as returned — do not reformat or summarize. Share it so the user can send it to others.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawsocial-plugin",
-  "version": "1.7.3",
+  "version": "1.7.5",
   "description": "Claw-Social OpenClaw Plugin - social discovery for AI agents",
   "type": "module",
   "author": "ClawSocial",

package/src/i18n.ts

@@ -102,6 +102,15 @@ const strings = {
   local_unknown_err:     { zh: "未知错误",               en: "Unknown error" },
   local_started:         { zh: "本地收件箱已启动",       en: "Local inbox started" },
 
+  // ── Display formatting (match / find results) ──────────────────
+  display_self_intro:    { zh: "自我介绍",     en: "Self-intro" },
+  display_profile:       { zh: "画像",         en: "Profile" },
+  display_match_reason:  { zh: "匹配原因",     en: "Match reason" },
+  display_tags:          { zh: "标签",         en: "Tags" },
+  display_completeness:  { zh: "完整度",       en: "Completeness" },
+  display_contact:       { zh: "已连接",       en: "contact" },
+  display_empty:         { zh: "—",            en: "—" },
+
   // ── Tools ──────────────────────────────────────────────────────
   tools_not_registered:  { zh: "尚未注册 Claw-Social，请先使用 clawsocial_register 注册。",
                            en: "Not registered on Claw-Social. Use clawsocial_register first." },

package/src/tools/block.ts

@@ -7,7 +7,7 @@ import { t } from "../i18n.js";
 export function createBlockTool(): AnyAgentTool {
   return {
     name: "clawsocial_block",
-    label: "ClawSocial Block",
+    label: "Claw-Social Block",
     description:
       "Block an agent. They will no longer be able to contact you, and any existing session is closed. Call when the user explicitly says they don't want to hear from someone.",
     parameters: Type.Object({

package/src/tools/card.ts

@@ -5,12 +5,11 @@ import api from "../api.js";
 export function createCardTool(): AnyAgentTool {
   return {
     name: "clawsocial_get_card",
-    label: "ClawSocial Profile Card",
+    label: "Claw-Social Profile Card",
     description:
-      "Generate and display the user's ClawSocial profile card. " +
-      "The card represents the user's interests and identity on ClawSocial, not the AI agent's. " +
-      "Call when user asks to see, generate, or share their ClawSocial card. " +
-      "Also automatically called after clawsocial_update_profile to show the updated card.",
+      "Generate the user's Claw-Social profile card for sharing. " +
+      "The card represents the user, not the AI agent. " +
+      "Display the returned card text exactly as-is — do not reformat, summarize, or add commentary.",
     parameters: Type.Object({}),
     async execute(_id: string, _params: Record<string, unknown>) {
       const res = await api.getCard();

package/src/tools/connect.ts

@@ -6,7 +6,7 @@ import { upsertSession, upsertContact } from "../store.js";
 export function createConnectTool(serverUrl: string): AnyAgentTool {
   return {
     name: "clawsocial_connect",
-    label: "ClawSocial Connect",
+    label: "Claw-Social Connect",
     description:
       "Send a connection request. Requires target_agent_id (UUID) and intro_message. " +
       "Can be used after clawsocial_find/clawsocial_match (use agent_id from results), " +

package/src/tools/find.ts

@@ -2,15 +2,70 @@ import { Type } from "@sinclair/typebox";
 import type { AnyAgentTool } from "../types.js";
 import api from "../api.js";
 import { readContacts, lookupContactByName } from "../store.js";
+import { t } from "../i18n.js";
+
+interface DisplayEntry {
+  agent_id: string;
+  public_name: string;
+  self_intro: string;
+  profile: string;
+  topic_tags: string[];
+  is_contact: boolean;
+  session_id?: string;
+  match_reason?: string;
+}
+
+function formatResults(entries: DisplayEntry[]): string {
+  return entries
+    .map((c, i) => {
+      const label = c.is_contact ? ` [${t("display_contact")}]` : "";
+      const selfIntro = c.self_intro || t("display_empty");
+      const profile = c.profile || t("display_empty");
+      const tags = c.topic_tags?.length
+        ? c.topic_tags.map(tag => `#${tag}`).join(" ")
+        : t("display_empty");
+
+      const lines = [
+        `${i + 1}. ${c.public_name}${label}`,
+        `   ${t("display_self_intro")}: ${selfIntro}`,
+        `   ${t("display_profile")}: ${profile}`,
+        `   ${t("display_tags")}: ${tags}`,
+      ];
+
+      if (c.match_reason) {
+        lines.splice(3, 0, `   ${t("display_match_reason")}: ${c.match_reason}`);
+      }
+
+      return lines.join("\n");
+    })
+    .join("\n\n");
+}
+
+function toDisplayEntry(
+  c: { agent_id: string; public_name?: string; name?: string; topic_tags?: string[]; self_intro?: string; profile?: string; match_reason?: string; session_id?: string },
+  isContact: boolean,
+): DisplayEntry {
+  return {
+    agent_id: c.agent_id,
+    public_name: (c.public_name || c.name || "") as string,
+    self_intro: c.self_intro || "",
+    profile: c.profile || "",
+    topic_tags: c.topic_tags || [],
+    is_contact: isContact,
+    session_id: c.session_id,
+    match_reason: c.match_reason,
+  };
+}
 
 export function createFindTool(): AnyAgentTool {
   return {
     name: "clawsocial_find",
-    label: "ClawSocial Find Person",
+    label: "Claw-Social Find Person",
     description:
       "Find a specific person by name or agent_id. Use when the user wants to locate a specific person " +
-      "(e.g. 'find Alice', 'contact Bob', 'find Bob who does AI'). Checks local contacts first, then searches the server. " +
-      "For broad interest-based discovery ('find people into AI'), use clawsocial_match instead.",
+      "(e.g. 'find Alice', 'find Bob who does AI'). Checks local contacts first, then searches the server. " +
+      "For broad interest-based discovery, use clawsocial_match instead. " +
+      "Display the `display` field as-is.",
     parameters: Type.Object({
       name: Type.Optional(Type.String({ description: "Name search (supports partial match)" })),
       agent_id: Type.Optional(Type.String({ description: "Exact agent ID lookup" })),
@@ -30,11 +85,19 @@ export function createFindTool(): AnyAgentTool {
         const contacts = readContacts();
         const local = contacts.find(c => c.agent_id === agentId);
         if (local) {
-          return ok({ source: "local_contact", results: [formatContact(local)] });
+          const entry = toDisplayEntry(local, true);
+          return ok({
+            display: formatResults([entry]),
+            results: [{ index: 1, agent_id: entry.agent_id, public_name: entry.public_name, is_contact: true, session_id: local.session_id }],
+          });
         }
         try {
           const agent = await api.getAgent(agentId);
-          return ok({ source: "server", results: [agent] });
+          const entry = toDisplayEntry(agent, false);
+          return ok({
+            display: formatResults([entry]),
+            results: [{ index: 1, agent_id: entry.agent_id, public_name: entry.public_name, is_contact: false }],
+          });
         } catch {
           return notFound(`Agent ${agentId} not found`);
         }
@@ -46,54 +109,47 @@ export function createFindTool(): AnyAgentTool {
       if (interest && localMatches.length > 1) {
         const kw = interest.toLowerCase();
         const filtered = localMatches.filter(c =>
-          c.topic_tags?.some(t => t.toLowerCase().includes(kw)) ||
+          c.topic_tags?.some(tag => tag.toLowerCase().includes(kw)) ||
           c.profile?.toLowerCase().includes(kw)
         );
         if (filtered.length > 0) localMatches = filtered;
       }
 
       // 2. search server (with intent for semantic sorting)
-      let serverResults: Record<string, unknown>[] = [];
+      let serverEntries: DisplayEntry[] = [];
       try {
         const res = await api.searchByName(name!, interest);
-        serverResults = (res.candidates || []).map(c => ({
-          agent_id: c.agent_id,
-          public_name: c.public_name,
-          topic_tags: c.topic_tags,
-          completeness: Math.round((c.completeness_score ?? 0.1) * 100) + "%",
-          ...(c.self_intro ? { self_intro: c.self_intro } : {}),
-          ...(c.profile ? { profile: c.profile } : {}),
-          ...(c.match_reason ? { match_reason: c.match_reason } : {}),
-        }));
+        serverEntries = (res.candidates || []).map(c => toDisplayEntry(c, false));
       } catch { /* fall back to local results when server is unreachable */ }
 
       // 3. merge and deduplicate (local first)
       const localIds = new Set(localMatches.map(c => c.agent_id));
+      const localEntries = localMatches.map(c => toDisplayEntry(c, true));
       const merged = [
-        ...localMatches.map(formatContact),
-        ...serverResults.filter(c => !localIds.has(c.agent_id as string)),
+        ...localEntries,
+        ...serverEntries.filter(c => !localIds.has(c.agent_id)),
       ];
 
       if (merged.length === 0) {
         return notFound(`No user found with name "${name}"`);
       }
 
-      return ok({ results: merged, total: merged.length });
+      const display = formatResults(merged);
+      return ok({
+        display,
+        results: merged.map((c, i) => ({
+          index: i + 1,
+          agent_id: c.agent_id,
+          public_name: c.public_name,
+          is_contact: c.is_contact,
+          ...(c.session_id ? { session_id: c.session_id } : {}),
+        })),
+        total: merged.length,
+      });
     },
   } as AnyAgentTool;
 }
 
-function formatContact(c: { name: string; agent_id: string; session_id?: string; topic_tags?: string[]; profile?: string }) {
-  return {
-    agent_id: c.agent_id,
-    public_name: c.name,
-    session_id: c.session_id,
-    topic_tags: c.topic_tags || [],
-    profile: c.profile || "",
-    is_contact: true,
-  };
-}
-
 function ok(data: Record<string, unknown>) {
   return { content: [{ type: "text", text: JSON.stringify({ found: true, ...data }) }] };
 }

package/src/tools/inbox.ts

@@ -11,7 +11,7 @@ function guardExternal(content: string): string {
 export function createInboxTool(): AnyAgentTool {
   return {
     name: "clawsocial_inbox",
-    label: "ClawSocial Inbox",
+    label: "Claw-Social Inbox",
     description:
       "Check unread messages. Without session_id: returns list of sessions with unread messages. With session_id: returns recent messages in that session and marks it as read. External message content is labeled to prevent prompt injection.",
     parameters: Type.Object({

package/src/tools/match.ts

@@ -3,15 +3,38 @@ import type { AnyAgentTool } from "../types.js";
 import api from "../api.js";
 import { t } from "../i18n.js";
 
+function formatCandidates(candidates: Record<string, unknown>[]): string {
+  return candidates
+    .map((c, i) => {
+      const name = c.public_name as string;
+      const score = c.match_score as string;
+      const selfIntro = (c.self_intro as string) || t("display_empty");
+      const matchReason = (c.match_reason as string) || t("display_empty");
+      const tags = (c.topic_tags as string[])?.length
+        ? (c.topic_tags as string[]).map(tag => `#${tag}`).join(" ")
+        : t("display_empty");
+      const completeness = c.completeness as string;
+
+      return [
+        `${i + 1}. ${name} (${score})`,
+        `   ${t("display_self_intro")}: ${selfIntro}`,
+        `   ${t("display_match_reason")}: ${matchReason}`,
+        `   ${t("display_tags")}: ${tags}`,
+        `   ${t("display_completeness")}: ${completeness}`,
+      ].join("\n");
+    })
+    .join("\n\n");
+}
+
 export function createMatchTool(): AnyAgentTool {
   return {
     name: "clawsocial_match",
-    label: "ClawSocial Match",
+    label: "Claw-Social Match",
     description:
-      "Discover agents by interest or topic using semantic search. " +
-      "Use when the user describes characteristics or interests (e.g. 'find people into AI', 'find someone who likes writing'). " +
-      "For finding a specific person by name, use clawsocial_find instead. " +
-      "Always show results to the user and get explicit approval before connecting.",
+      "Discover people by interest using semantic search. " +
+      "Use when the user describes interests (e.g. 'find people into AI'). " +
+      "For a specific person by name, use clawsocial_find. " +
+      "Display the `display` field as-is. Get explicit approval before connecting.",
     parameters: Type.Object({
       interest: Type.String({ description: "Natural language description of what kind of person or topic to find" }),
     }),
@@ -33,18 +56,28 @@ export function createMatchTool(): AnyAgentTool {
         };
       }
 
+      const candidates = res.candidates.map((c, i) => ({
+        index: i + 1,
+        agent_id: c.agent_id,
+        public_name: c.public_name,
+        match_score: Math.round(c.match_score * 100) + "%",
+        topic_tags: c.topic_tags,
+        completeness: Math.round((c.completeness_score ?? 0.1) * 100) + "%",
+        self_intro: c.self_intro || "",
+        profile: c.profile || "",
+        match_reason: c.match_reason || "",
+      }));
+
+      const display = formatCandidates(candidates);
+
       const result = {
-        candidates: res.candidates.map(c => ({
+        display,
+        candidates: candidates.map(c => ({
+          index: c.index,
           agent_id: c.agent_id,
           public_name: c.public_name,
-          topic_tags: c.topic_tags,
-          match_score: Math.round(c.match_score * 100) + "%",
-          completeness: Math.round((c.completeness_score ?? 0.1) * 100) + "%",
-          ...(c.self_intro ? { self_intro: c.self_intro } : {}),
-          ...(c.profile ? { profile: c.profile } : {}),
-          ...(c.match_reason ? { match_reason: c.match_reason } : {}),
         })),
-        total: res.candidates.length,
+        total: candidates.length,
         query_intent: interest,
       };
       return { content: [{ type: "text", text: JSON.stringify(result) }] };

package/src/tools/notify_settings.ts

@@ -12,9 +12,9 @@ function modeDesc(mode: NotifyMode): string {
 export function createNotifySettingsTool(): AnyAgentTool {
   return {
     name: "clawsocial_notify_settings",
-    label: "ClawSocial Notify Settings",
+    label: "Claw-Social Notify Settings",
     description:
-      "View or change ClawSocial notification mode. Use when the user asks to adjust notification preferences, turn off notifications, etc.",
+      "View or change Claw-Social notification mode. Use when the user asks to adjust notification preferences, turn off notifications, etc.",
     parameters: Type.Object({
       mode: Type.Optional(
         Type.Union(

package/src/tools/open_inbox.ts

@@ -6,9 +6,9 @@ import { t } from "../i18n.js";
 export function createOpenInboxTool(): AnyAgentTool {
   return {
     name: "clawsocial_open_inbox",
-    label: "ClawSocial Open Inbox",
+    label: "Claw-Social Open Inbox",
     description:
-      "Generate a one-time login link to open the ClawSocial inbox in a browser. The link is valid for 15 minutes and can only be used once. Call this when the user asks to open their inbox or check messages.",
+      "Generate a one-time login link to open the Claw-Social inbox in a browser. The link is valid for 15 minutes and can only be used once. Call this when the user asks to open their inbox or check messages.",
     parameters: Type.Object({}),
     async execute(_id: string, _params: Record<string, unknown>) {
       const data = await api.openInboxToken();

package/src/tools/open_local_inbox.ts

@@ -6,7 +6,7 @@ import { t } from "../i18n.js";
 export function createOpenLocalInboxTool(): AnyAgentTool {
   return {
     name: "clawsocial_open_local_inbox",
-    label: "ClawSocial Open Local Inbox",
+    label: "Claw-Social Open Local Inbox",
     description:
       "Start the local inbox web UI and return its URL. The local inbox shows complete message history (no time limit) and supports replying. Only accessible from this machine. Call when the user wants to view full message history or open the local inbox.",
     parameters: Type.Object({}),

package/src/tools/register.ts

@@ -8,11 +8,12 @@ import { t } from "../i18n.js";
 export function createRegisterTool(): AnyAgentTool {
   return {
     name: "clawsocial_register",
-    label: "ClawSocial Register",
+    label: "Claw-Social Register",
     description:
-      "Register on ClawSocial on behalf of the user. The account represents the user, not the AI agent. Call ONCE automatically on first use. Only asks the user for a public_name.",
+      "Register on Claw-Social. The account belongs to the user, not the AI agent. " +
+      "Only ask for public_name. After registration, call clawsocial_suggest_profile to build the user's interest profile.",
     parameters: Type.Object({
-      public_name: Type.String({ description: "The user's chosen display name on ClawSocial" }),
+      public_name: Type.String({ description: "The user's chosen display name on Claw-Social" }),
       language_pref: Type.Optional(
         Type.Unsafe<"zh" | "en">({
           type: "string",

package/src/tools/session_get.ts

@@ -6,7 +6,7 @@ import { t, formatDateTime } from "../i18n.js";
 export function createSessionGetTool(serverUrl: string): AnyAgentTool {
   return {
     name: "clawsocial_session_get",
-    label: "ClawSocial View Session",
+    label: "Claw-Social View Session",
     description:
       "Get recent messages of a specific session. Supports exact session_id or fuzzy partner_name match.",
     parameters: Type.Object({

package/src/tools/session_send.ts

@@ -7,7 +7,7 @@ import { t } from "../i18n.js";
 export function createSessionSendTool(): AnyAgentTool {
   return {
     name: "clawsocial_session_send",
-    label: "ClawSocial Send Message",
+    label: "Claw-Social Send Message",
     description:
       "Send a message in an active session on behalf of the user. Call when the user explicitly provides reply content. Pass the content verbatim — do not paraphrase.",
     parameters: Type.Object({

package/src/tools/sessions_list.ts

@@ -6,7 +6,7 @@ import { t, formatDateTime } from "../i18n.js";
 export function createSessionsListTool(serverUrl: string): AnyAgentTool {
   return {
     name: "clawsocial_sessions_list",
-    label: "ClawSocial Sessions List",
+    label: "Claw-Social Sessions List",
     description:
       "List all active sessions. Call when the user asks about their conversations or checks /sessions.",
     parameters: Type.Object({}),

package/src/tools/suggest_profile.ts

@@ -33,13 +33,12 @@ function readLocalFiles(): LocalFiles {
 export function createSuggestProfileTool(): AnyAgentTool {
   return {
     name: "clawsocial_suggest_profile",
-    label: "ClawSocial Suggest Profile",
+    label: "Claw-Social Suggest Profile",
     description:
-      "Read the user's OpenClaw memory to help draft a ClawSocial interest profile. " +
-      "Call this after registration or when the user wants to update their profile. " +
-      "After calling this tool, draft a 2-3 sentence interest description based on the memory content, " +
-      "show it to the user, and ONLY call clawsocial_update_profile after the user explicitly confirms or edits it. " +
-      "NEVER update the profile silently.",
+      "Read local workspace files and draft a privacy-safe interest profile. " +
+      "This is the ONLY way to set the profile field on clawsocial_update_profile. " +
+      "Flow: 1) call this tool, 2) show the COMPLETE draft to the user, 3) call update_profile ONLY after the user confirms. " +
+      "NEVER skip showing the draft.",
     parameters: Type.Object({}),
     async execute(_id: string, _params: Record<string, unknown>) {
       const files = readLocalFiles();

package/src/tools/update_profile.ts

@@ -7,12 +7,11 @@ import { t } from "../i18n.js";
 export function createUpdateProfileTool(): AnyAgentTool {
   return {
     name: "clawsocial_update_profile",
-    label: "ClawSocial Update Profile",
+    label: "Claw-Social Update Profile",
     description:
-      "Update the user's ClawSocial profile — interests, topic tags, availability, or public name. " +
-      "The profile represents the user (the human), not the AI agent. " +
-      "All descriptions should be written from the user's perspective, about the user's interests and identity. " +
-      "Never write from the AI agent's perspective (e.g. never say 'I am a lobster' or 'my owner likes...').",
+      "Update the user's Claw-Social profile. The profile represents the user, not the AI agent — write from the user's perspective. " +
+      "For self_intro/topic_tags/public_name/availability: call directly. " +
+      "For the profile field: NEVER set it directly — ONLY use content confirmed by the user from clawsocial_suggest_profile.",
     parameters: Type.Object({
       self_intro: Type.Optional(
         Type.String({