antenna-openclaw-plugin 0.9.0 → 0.11.0

package/index.ts

@@ -275,7 +275,29 @@ export default function register(api: any) {
       const others = (nearby ?? []).filter((p: Profile) => p.device_id !== deviceId);
 
       if (others.length === 0) {
-        return ok({ nearby: [], message: `在 ${radius}m 范围内没有发现其他人。试试扩大范围？` });
+        // Fallback to global discover
+        const { data: globalData } = await supabase.rpc("global_discover", {
+          p_device_id: deviceId, p_limit: 1,
+        });
+        const globalOthers = globalData || [];
+        if (globalOthers.length > 0) {
+          const gRefMap: Record<string, string> = {};
+          const gProfiles = globalOthers.map((p: any, i: number) => {
+            const ref = String(i + 1);
+            gRefMap[ref] = p.device_id;
+            return { ref, emoji: p.emoji || "👤", name: p.display_name || "匿名", line1: p.line1, line2: p.line2, line3: p.line3 };
+          });
+          (api as any)._antennaRefMap = gRefMap;
+          try { await supabase.rpc("save_scan_refs", { p_owner: deviceId, p_refs: JSON.stringify(gRefMap) }); } catch {}
+          for (const p of globalOthers) {
+            try { await supabase.rpc("log_recommendation", { p_device_id: deviceId, p_recommended_id: p.device_id }); } catch {}
+          }
+          return ok({
+            nearby: gProfiles, total: gProfiles.length, radius_m: radius, global: true,
+            message: `附近 ${radius}m 暂时没人。今天的全球推荐——这个人跟你可能聊得来。（每天 1 次）`,
+          });
+        }
+        return ok({ nearby: [], message: `附近暂时没人，今天的全球推荐已经用完了。明天再来！` });
       }
 
       // Build ref mapping — never expose device_id
@@ -293,8 +315,11 @@ export default function register(api: any) {
         };
       });
 
-      // Store ref map for accept
+      // Store ref map for accept — memory + DB
       (api as any)._antennaRefMap = _refMap;
+      try {
+        await supabase.rpc("save_scan_refs", { p_owner: deviceId, p_refs: JSON.stringify(_refMap) });
+      } catch { /* best effort */ }
 
       return ok({
         nearby: profiles,
@@ -432,13 +457,15 @@ export default function register(api: any) {
       const supabase = getSupabase(cfg);
       const deviceId = deriveDeviceId(params.sender_id, params.channel);
 
-      // Resolve ref to device_id
+      // Resolve ref to device_id — try DB first, then memory fallback
       let targetId = params.target_device_id;
-      if (params.ref && (api as any)._antennaRefMap?.[params.ref]) {
-        targetId = (api as any)._antennaRefMap[params.ref];
+      if (!targetId && params.ref) {
+        // Try DB
+        const { data: resolved } = await supabase.rpc("resolve_ref", { p_owner: deviceId, p_ref: params.ref });
+        targetId = resolved || (api as any)._antennaRefMap?.[params.ref];
       }
       if (!targetId) {
-        return ok({ error: "No target. Use 'ref' from scan results or 'target_device_id'." });
+        return ok({ error: "No target. Ref may have expired — try scanning again." });
       }
 
       const { error } = await supabase.rpc("upsert_match", {
@@ -516,6 +543,58 @@ export default function register(api: any) {
     },
   });
 
+  // ═══════════════════════════════════════════════════════════════════
+  // Tool: antenna_discover
+  // ═══════════════════════════════════════════════════════════════════
+  api.registerTool({
+    name: "antenna_discover",
+    description:
+      "Get today's global recommendation — the person most similar to you worldwide. 1 per day, no repeats.",
+    parameters: {
+      type: "object",
+      properties: {
+        sender_id: { type: "string", description: "The sender's user ID" },
+        channel: { type: "string", description: "The channel name" },
+      },
+      required: ["sender_id", "channel"],
+    },
+    async execute(_id: string, params: any) {
+      const cfg = getConfig(api);
+      const supabase = getSupabase(cfg);
+      const deviceId = deriveDeviceId(params.sender_id, params.channel);
+
+      const { data: globalData } = await supabase.rpc("global_discover", {
+        p_device_id: deviceId, p_limit: 1,
+      });
+
+      const results = globalData || [];
+      if (results.length === 0) {
+        return ok({ count: 0, profiles: [], message: "今天的全球推荐已用完，或者你已经看过所有人了。等新人加入！" });
+      }
+
+      const _refMap: Record<string, string> = {};
+      const profiles = results.map((p: any, i: number) => {
+        const ref = String(i + 1);
+        _refMap[ref] = p.device_id;
+        return { ref, emoji: p.emoji || "👤", name: p.display_name || "匿名", line1: p.line1, line2: p.line2, line3: p.line3 };
+      });
+
+      // Persist refs + log recommendation
+      (api as any)._antennaRefMap = { ...(api as any)._antennaRefMap, ..._refMap };
+      try {
+        await supabase.rpc("save_scan_refs", { p_owner: deviceId, p_refs: JSON.stringify(_refMap) });
+      } catch { /* best effort */ }
+      for (const p of results) {
+        await supabase.rpc("log_recommendation", { p_device_id: deviceId, p_recommended_id: p.device_id });
+      }
+
+      return ok({
+        count: profiles.length, profiles, global: true,
+        message: "🌍 今天的全球推荐——这个人跟你可能聊得来。",
+      });
+    },
+  });
+
   // ═══════════════════════════════════════════════════════════════════
   // Tool: antenna_check_matches
   // ═══════════════════════════════════════════════════════════════════

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "antenna-openclaw-plugin",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "Antenna — agent-mediated nearby people discovery for OpenClaw",
   "openclaw": {
     "extensions": ["./index.ts"]

package/skills/antenna/SKILL.md

@@ -43,9 +43,17 @@ onboarding 完成后，帮用户设置一个每小时自动检查匹配的 cron
 
 示例（Hermes）：
 ```
-hermes cron add --every 1h --message "Check antenna matches: call antenna_check_matches. If there are new mutual matches or incoming accepts, tell the user. If nothing new, reply HEARTBEAT_OK."
+hermes cron add --every 1h --message "Check antenna matches: call antenna_check_matches. If there are new mutual matches or incoming accepts, tell the user. Also call antenna_discover once per day to get a global recommendation. If nothing new, reply HEARTBEAT_OK."
 ```
 
+**第五步：问用户要不要全球推荐**
+
+cron 设完后，问用户一句：
+> "要我每天帮你找一个全球最像你的人吗？"
+
+用户说要 → cron 每天调 `antenna_discover` 推送。
+用户说不要 → 只在 scan 没人时 fallback。
+
 ## When to use
 
 - **首次安装后**: 主动开始 onboarding（名片 → 位置）
@@ -101,6 +109,13 @@ Generate a GPS binding link. **You MUST call this immediately after saving a pro
 - Send this link to the user — they open it on their phone, allow GPS, and their location is automatically shared
 - **MANDATORY after profile save. Do not wait for user to ask.**
 
+### `antenna_discover`
+Get today's global recommendation — the person most similar to you worldwide. 1 per day, no repeats.
+- `sender_id`, `channel`: from context
+- Returns 1 profile (embedding similarity match) that hasn't been recommended before
+- If all users have been recommended, returns a message saying "wait for new people"
+- Use this in the daily cron job, or when user asks "find someone interesting globally"
+
 ## Behavior guidelines
 
 ### First-time user — 聊天式引导（不要让用户填表）