clawsocial-plugin 1.7.0 → 1.7.1

package/package.json

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

package/src/api.ts

@@ -84,8 +84,8 @@ async function request<T = unknown>(
 
 export type RegisterBody = { public_name: string; availability?: string; language_pref?: string };
 export type RegisterResult = { agent_id: string; api_key: string; token: string; public_name: string };
-export type SearchBody = { intent: string; topic_tags?: string[]; top_k?: number };
-export type SearchResult = { candidates: Array<{ agent_id: string; public_name: string; topic_tags?: string[]; match_score: number; availability?: string; manual_intro?: string; auto_bio?: string; match_reason?: string; completeness_score?: number }> };
+export type SearchBody = { intent: string; topic_tags?: string[] };
+export type SearchResult = { candidates: Array<{ agent_id: string; public_name: string; topic_tags?: string[]; match_score: number; availability?: string; self_intro?: string; profile?: string; match_reason?: string; completeness_score?: number }> };
 export type ConnectBody = { target_agent_id: string; intro_message: string };
 export type ConnectResult = { session_id: string; partner_name?: string; partner_topic_tags?: string[] };
 export type SendMessageBody = { content: string; intent?: string };
@@ -104,7 +104,7 @@ const api = {
     if (intent) params.set("intent", intent);
     return request<SearchResult>("GET", `/agents/search/name?${params.toString()}`);
   },
-  getAgent: (id: string) => request<{ agent_id: string; public_name: string; topic_tags: string[]; availability: string; manual_intro: string; auto_bio: string }>("GET", `/agents/${id}`),
+  getAgent: (id: string) => request<{ agent_id: string; public_name: string; topic_tags: string[]; availability: string; self_intro: string; profile: string }>("GET", `/agents/${id}`),
   connect: (body: ConnectBody) => request<ConnectResult>("POST", "/sessions/connect", body),
   sendMessage: (id: string, body: SendMessageBody) =>
     request<SendMessageResult>("POST", `/sessions/${id}/messages`, body),

package/src/store.ts

@@ -252,7 +252,7 @@ export type Contact = {
   agent_id: string;
   session_id?: string;
   topic_tags?: string[];
-  auto_bio?: string;
+  profile?: string;
   added_at: number;
 };
 

package/src/tools/connect.ts

@@ -17,7 +17,7 @@ export function createConnectTool(serverUrl: string): AnyAgentTool {
       target_agent_id: Type.String({ description: "agent_id from search results" }),
       target_name: Type.Optional(Type.String({ description: "Partner's public_name" })),
       target_topic_tags: Type.Optional(Type.Array(Type.String(), { description: "Partner's topic_tags" })),
-      target_auto_bio: Type.Optional(Type.String({ description: "Partner's auto_bio" })),
+      target_profile: Type.Optional(Type.String({ description: "Partner's profile" })),
       intro_message: Type.String({
         description:
           "Why the user wants to connect. Use search intent if from search, " +
@@ -28,7 +28,7 @@ export function createConnectTool(serverUrl: string): AnyAgentTool {
       const target_agent_id = params.target_agent_id as string;
       const target_name = params.target_name as string | undefined;
       const target_topic_tags = params.target_topic_tags as string[] | undefined;
-      const target_auto_bio = params.target_auto_bio as string | undefined;
+      const target_profile = params.target_profile as string | undefined;
       const intro_message = params.intro_message as string;
       if (!target_agent_id) throw new Error("target_agent_id is required");
       if (!intro_message) throw new Error("intro_message is required — briefly explain the reason for connecting");
@@ -55,7 +55,7 @@ export function createConnectTool(serverUrl: string): AnyAgentTool {
           agent_id: target_agent_id,
           session_id: res.session_id,
           ...(partnerTags ? { topic_tags: partnerTags } : {}),
-          ...(target_auto_bio ? { auto_bio: target_auto_bio } : {}),
+          ...(target_profile ? { profile: target_profile } : {}),
         });
       }
 

package/src/tools/find.ts

@@ -47,7 +47,7 @@ export function createFindTool(): AnyAgentTool {
         const kw = interest.toLowerCase();
         const filtered = localMatches.filter(c =>
           c.topic_tags?.some(t => t.toLowerCase().includes(kw)) ||
-          c.auto_bio?.toLowerCase().includes(kw)
+          c.profile?.toLowerCase().includes(kw)
         );
         if (filtered.length > 0) localMatches = filtered;
       }
@@ -60,10 +60,10 @@ export function createFindTool(): AnyAgentTool {
           agent_id: c.agent_id,
           public_name: c.public_name,
           topic_tags: c.topic_tags,
-          availability: c.availability,
-          manual_intro: c.manual_intro || "",
-          auto_bio: c.auto_bio || "",
-          match_reason: c.match_reason || "name match",
+          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 } : {}),
         }));
       } catch { /* fall back to local results when server is unreachable */ }
 
@@ -83,13 +83,13 @@ export function createFindTool(): AnyAgentTool {
   } as AnyAgentTool;
 }
 
-function formatContact(c: { name: string; agent_id: string; session_id?: string; topic_tags?: string[]; auto_bio?: string }) {
+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 || [],
-    auto_bio: c.auto_bio || "",
+    profile: c.profile || "",
     is_contact: true,
   };
 }

package/src/tools/match.ts

@@ -14,7 +14,6 @@ export function createMatchTool(): AnyAgentTool {
       "Always show results to the user and get explicit approval before connecting.",
     parameters: Type.Object({
       interest: Type.String({ description: "Natural language description of what kind of person or topic to find" }),
-      top_k: Type.Optional(Type.Number({ description: "Number of results to return, default 5", minimum: 1, maximum: 20 })),
     }),
     async execute(_id: string, params: Record<string, unknown>) {
       const interest = params.interest as string;
@@ -23,7 +22,6 @@ export function createMatchTool(): AnyAgentTool {
       const res = await api.search({
         intent: interest,
         topic_tags: [],
-        top_k: (params.top_k as number) ?? 5,
       });
 
       if (!res.candidates || res.candidates.length === 0) {
@@ -42,8 +40,8 @@ export function createMatchTool(): AnyAgentTool {
           topic_tags: c.topic_tags,
           match_score: Math.round(c.match_score * 100) + "%",
           completeness: Math.round((c.completeness_score ?? 0.1) * 100) + "%",
-          ...(c.manual_intro ? { manual_intro: c.manual_intro } : {}),
-          ...(c.auto_bio ? { auto_bio: c.auto_bio } : {}),
+          ...(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,

package/src/tools/suggest_profile.ts

@@ -74,7 +74,7 @@ export function createSuggestProfileTool(): AnyAgentTool {
                 "Extract interest topics, personality traits, work style, and focus areas from these files. " +
                 "Strip all names, companies, locations, and credentials. " +
                 "Draft a 2-3 sentence description. Show it to the user and ask for confirmation. " +
-                "Only call clawsocial_update_profile after explicit user approval. Pass: auto_bio (the drafted description) and topic_tags (array of extracted interest keywords, e.g. [\"AI\", \"Web3\", \"product design\"]). Do NOT use interest_text. Completeness is calculated server-side — do not pass completeness_score.",
+                "Only call clawsocial_update_profile after explicit user approval. Pass: profile (the drafted description) and topic_tags (array of extracted interest keywords, e.g. [\"AI\", \"Web3\", \"product design\"]). Do NOT use self_intro. Completeness is calculated server-side — do not pass completeness_score.",
             }),
           },
         ],

package/src/tools/update_profile.ts

@@ -14,7 +14,7 @@ export function createUpdateProfileTool(): AnyAgentTool {
       "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...').",
     parameters: Type.Object({
-      interest_text: Type.Optional(
+      self_intro: Type.Optional(
         Type.String({
           description:
             "A description of the user (the human) — shown to others as self-intro. " +
@@ -23,11 +23,11 @@ export function createUpdateProfileTool(): AnyAgentTool {
             "Never describe the AI agent — always describe the human user.",
         }),
       ),
-      auto_bio: Type.Optional(
+      profile: Type.Optional(
         Type.String({
           description:
             "Interest description extracted from local OpenClaw files (not typed by user directly). " +
-            "Use this instead of interest_text when the content comes from SOUL.md / MEMORY.md / USER.md.",
+            "Use this instead of self_intro when the content comes from SOUL.md / MEMORY.md / USER.md.",
         }),
       ),
       topic_tags: Type.Optional(
@@ -63,8 +63,8 @@ export function createUpdateProfileTool(): AnyAgentTool {
       }
 
       const body: Record<string, unknown> = {};
-      if (params.interest_text) body.interest_text = params.interest_text;
-      if (params.auto_bio) body.auto_bio = params.auto_bio;
+      if (params.self_intro) body.self_intro = params.self_intro;
+      if (params.profile) body.profile = params.profile;
       if (params.topic_tags) body.topic_tags = params.topic_tags;
       if (params.public_name) body.public_name = params.public_name;
       if (params.availability) body.availability = params.availability;