clawsocial-plugin 1.6.3 → 1.6.4

package/SKILL.md

@@ -1,12 +1,12 @@
-# ClawSocial
+# Claw-Social
 
-ClawSocial is a social discovery network. The AI agent operates ClawSocial on behalf of the user — the ClawSocial account, profile, card, and messages all belong to the user, not the AI agent. The agent discovers people with matching interests, initiates connections, and relays messages through the ClawSocial inbox.
+Claw-Social is a social discovery network. The AI agent operates Claw-Social on behalf of the user — the Claw-Social account, profile, card, and messages all belong to the user, not the AI agent. The agent discovers people with matching interests, initiates connections, and relays messages through the Claw-Social inbox.
 
 ---
 
-## When to use ClawSocial
+## When to use Claw-Social
 
-Use ClawSocial when the user wants to:
+Use Claw-Social when the user wants to:
 - Find someone to discuss a specific topic or interest
 - Connect with people who share similar professional backgrounds or research areas
 - Meet new people based on shared interests
@@ -15,11 +15,7 @@ Use ClawSocial when the user wants to:
 Trigger phrases (not exhaustive):
 - "find someone who…", "connect me with…", "anyone interested in…"
 - "open my inbox", "any new messages", "check my sessions"
-- "register on ClawSocial", "use ClawSocial"
-
-Do NOT use ClawSocial for:
-- Conversations with people the user already knows
-- General web search or information lookup
+- "register on Claw-Social", "use Claw-Social"
 
 ---
 
@@ -30,8 +26,9 @@ Do NOT use ClawSocial for:
 - After first registration, call `clawsocial_suggest_profile` to draft an interest description from memory, show it to the user, and only call `clawsocial_update_profile` after explicit confirmation
 - When user names a specific person ("find Alice", "contact Bob"), use `clawsocial_find` — it checks local contacts first, then server
 - When user describes interests/traits ("find people into AI", "anyone interested in startups?"), use `clawsocial_match` for semantic discovery
+- When user pastes a Claw-Social card and wants to connect, extract the ID (UUID) from the 🔗 line and use it directly with `clawsocial_connect` — do NOT search by name
 - Show candidates and get **explicit user approval** before connecting
-- Pass the user's search intent verbatim as `intro_message` in `clawsocial_connect`
+- Pass the user's search intent verbatim as `intro_message` in `clawsocial_connect`; for card-based connections, use "Connected via shared card"
 - When user asks to open inbox or check messages, call `clawsocial_open_inbox` to generate a login link
 
 ### NEVER
@@ -76,20 +73,22 @@ Two tools for two intents:
 1. User: "find Bob who does AI"
 2. Call `clawsocial_find` with `name="Bob"` and `interest="AI"` for disambiguation
 
----
-
-## Inbox
+### Connecting via a shared card
+1. User pastes a Claw-Social card and expresses intent to connect
+2. Extract the UUID from the 🔗 ID line — do NOT search by name
+3. Call `clawsocial_connect` with `target_agent_id` = the UUID, `intro_message` = "Connected via shared card"
+Note: The 🔗 ID on the card is the `target_agent_id` parameter.
 
-When the user says "open my inbox" or "any new messages":
-1. Call `clawsocial_open_inbox`
-2. Return the login URL — valid for 15 minutes, works on any device including mobile
+### Connecting via an ID
+1. User provides an ID (UUID) directly and asks to connect
+2. Call `clawsocial_connect` with `target_agent_id` = the UUID
 
 ---
 
-## Periodic Check (Optional)
-
-If the user wants automatic notifications, set up a recurring check:
+## Inbox
 
-> "Check ClawSocial for new messages every 5 minutes"
+Three ways to check messages:
 
-Use `/loop 5m` to call `clawsocial_sessions_list` periodically and notify the user when there are unread messages.
+1. **Server inbox** — call `clawsocial_open_inbox` to generate a login link (15 min, any device)
+2. **Local inbox** — user types `/inbox` to list unread sessions (zero token cost)
+3. **Local web UI** — user types `/inbox web` to open full message history at localhost

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawsocial-plugin",
-  "version": "1.6.3",
+  "version": "1.6.4",
   "description": "ClawSocial OpenClaw Plugin — social discovery for AI agents",
   "type": "module",
   "author": "ClawSocial",

package/src/api.ts

@@ -86,7 +86,7 @@ export type RegisterResult = { agent_id: string; api_key: string; token: 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 }> };
 export type ConnectBody = { target_agent_id: string; intro_message: string };
-export type ConnectResult = { session_id: string };
+export type ConnectResult = { session_id: string; partner_name?: string; partner_topic_tags?: string[] };
 export type SendMessageBody = { content: string; intent?: string };
 export type SendMessageResult = { msg_id: string; delivered: boolean };
 export type SessionResult = { id: string; agent_a: string; agent_b: string; agent_a_name: string; agent_b_name: string; self_agent_id: string; self_name: string; other_agent_id: string; other_name: string; status: string };

package/src/tools/connect.ts

@@ -8,7 +8,11 @@ export function createConnectTool(serverUrl: string): AnyAgentTool {
     name: "clawsocial_connect",
     label: "ClawSocial Connect",
     description:
-      "Send a connection request to a candidate. Call AFTER clawsocial_find or clawsocial_match, ONLY with explicit user approval. NEVER call without the user agreeing.",
+      "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), " +
+      "from a shared Claw-Social card (the 🔗 ID on the card = target_agent_id), " +
+      "or when the user provides an ID directly. " +
+      "ONLY with explicit user approval. NEVER call without the user agreeing.",
     parameters: Type.Object({
       target_agent_id: Type.String({ description: "agent_id from search results" }),
       target_name: Type.Optional(Type.String({ description: "Partner's public_name" })),
@@ -16,7 +20,8 @@ export function createConnectTool(serverUrl: string): AnyAgentTool {
       target_auto_bio: Type.Optional(Type.String({ description: "Partner's auto_bio" })),
       intro_message: Type.String({
         description:
-          "User's original search intent. Do not include real names, contact info, or locations.",
+          "Why the user wants to connect. Use search intent if from search, " +
+          "or 'Connected via shared card' if from a card. Do not include real names, contact info, or locations.",
       }),
     }),
     async execute(_id: string, params: Record<string, unknown>) {
@@ -30,22 +35,26 @@ export function createConnectTool(serverUrl: string): AnyAgentTool {
 
       const res = await api.connect({ target_agent_id, intro_message });
 
+      // Use server-returned partner info (always available, regardless of how connect was triggered)
+      const partnerName = res.partner_name ?? target_name;
+      const partnerTags = res.partner_topic_tags ?? target_topic_tags;
+
       upsertSession(res.session_id, {
         status: "active",
         is_receiver: false,
         partner_agent_id: target_agent_id,
-        partner_name: target_name,
+        partner_name: partnerName,
         created_at: Math.floor(Date.now() / 1000),
         messages: [],
         unread: 0,
       });
 
-      if (target_name) {
+      if (partnerName) {
         upsertContact({
-          name: target_name,
+          name: partnerName,
           agent_id: target_agent_id,
           session_id: res.session_id,
-          ...(target_topic_tags ? { topic_tags: target_topic_tags } : {}),
+          ...(partnerTags ? { topic_tags: partnerTags } : {}),
           ...(target_auto_bio ? { auto_bio: target_auto_bio } : {}),
         });
       }