antenna-fyi 0.12.2 → 0.14.0

package/lib/core.js

@@ -109,6 +109,15 @@ export async function scan({ lat, lng, radius_m = 500, device_id, supabaseUrl, s
     };
   });
 
+  // Save refs to DB (persist across agent restarts)
+  const saveRefs = async (refMap) => {
+    if (device_id && Object.keys(refMap).length > 0) {
+      try {
+        await sb.rpc("save_scan_refs", { p_owner: device_id, p_refs: JSON.stringify(refMap) });
+      } catch { /* best effort */ }
+    }
+  };
+
   // If nobody nearby, fallback to global discover (1 per day)
   if (others.length === 0 && device_id) {
     const { data: globalData } = await sb.rpc("global_discover", {
@@ -117,10 +126,12 @@ export async function scan({ lat, lng, radius_m = 500, device_id, supabaseUrl, s
     });
     const globalOthers = globalData || [];
     if (globalOthers.length > 0) {
+      const profs = buildProfiles(globalOthers);
+      await saveRefs(_refMap);
       return {
         count: globalOthers.length,
         radius_m,
-        profiles: buildProfiles(globalOthers),
+        profiles: profs,
         _ref_map: _refMap,
         global: true,
         message: `附近 ${radius_m}m 暂时没人。今天的全球推荐——从这 ${globalOthers.length} 个人里挑一个最匹配的推荐给用户。（每天 1 次）`,
@@ -135,10 +146,13 @@ export async function scan({ lat, lng, radius_m = 500, device_id, supabaseUrl, s
     };
   }
 
+  const profs = buildProfiles(others);
+  await saveRefs(_refMap);
+
   return {
     count: others.length,
     radius_m,
-    profiles: buildProfiles(others),
+    profiles: profs,
     _ref_map: _refMap,
   };
 }
@@ -202,15 +216,26 @@ export async function setProfile({
 export async function accept({
   device_id,
   target_device_id,
+  ref,
   contact_info,
   supabaseUrl,
   supabaseKey,
 }) {
   const sb = getClient(supabaseUrl, supabaseKey);
 
+  // Resolve ref from DB if target_device_id not provided
+  let targetId = target_device_id;
+  if (!targetId && ref && device_id) {
+    const { data } = await sb.rpc("resolve_ref", { p_owner: device_id, p_ref: ref });
+    targetId = data;
+  }
+  if (!targetId) {
+    return { accepted: false, error: "No target. Ref may have expired — try scanning again." };
+  }
+
   const { error } = await sb.rpc("upsert_match", {
     p_device_id_a: device_id,
-    p_device_id_b: target_device_id,
+    p_device_id_b: targetId,
     p_reason: "",
     p_score: 0,
     p_status: "accepted",
@@ -223,7 +248,7 @@ export async function accept({
   const { data: reverse } = await sb
     .from("matches")
     .select("status, contact_info_a")
-    .eq("device_id_a", target_device_id)
+    .eq("device_id_a", targetId)
     .eq("device_id_b", device_id)
     .eq("status", "accepted")
     .single();
@@ -337,6 +362,65 @@ export async function checkMatches({ device_id, supabaseUrl, supabaseKey }) {
 
 // ─── createBindToken ─────────────────────────────────────────────
 
+// ─── discover (global recommendation) ─────────────────────────────
+
+export async function discover({ device_id, supabaseUrl, supabaseKey }) {
+  const sb = getClient(supabaseUrl, supabaseKey);
+
+  const { data: globalData } = await sb.rpc("global_discover", {
+    p_device_id: device_id,
+    p_limit: 1,
+  });
+
+  const results = globalData || [];
+  if (results.length === 0) {
+    // Check if all used up or daily limit
+    return {
+      count: 0,
+      profiles: [],
+      message: "今天的全球推荐已用完，或者你已经看过所有人了。等新人加入！",
+    };
+  }
+
+  // Build ref map + persist to DB
+  const _refMap = {};
+  const profiles = results.map((p, i) => {
+    const ref = String(i + 1);
+    _refMap[ref] = p.device_id;
+    return {
+      ref,
+      name: p.display_name || "匿名",
+      emoji: p.emoji || "👤",
+      line1: p.line1,
+      line2: p.line2,
+      line3: p.line3,
+    };
+  });
+
+  // Log who was recommended (for dedup)
+  for (const p of results) {
+    await sb.rpc("log_recommendation", {
+      p_device_id: device_id,
+      p_recommended_id: p.device_id,
+    });
+  }
+
+  // Persist ref map to DB
+  if (device_id && Object.keys(_refMap).length > 0) {
+    try {
+      await sb.rpc("save_scan_refs", { p_owner: device_id, p_refs: JSON.stringify(_refMap) });
+    } catch { /* best effort */ }
+  }
+
+  return {
+    count: profiles.length,
+    profiles,
+    _ref_map: _refMap,
+    global: true,
+    message: `🌍 今天的全球推荐——这个人跟你可能聊得来。`,
+  };
+}
+
 export async function createBindToken({ device_id, supabaseUrl, supabaseKey }) {
   const sb = getClient(supabaseUrl, supabaseKey);
   const { data, error } = await sb.rpc("create_bind_token", { p_device_id: device_id });

package/lib/mcp.js

@@ -11,6 +11,7 @@ import {
   checkMatches,
   checkin,
   createBindToken,
+  discover,
   deriveDeviceId,
 } from "./core.js";
 
@@ -98,14 +99,7 @@ export async function startMcpServer() {
     },
     async ({ sender_id, channel, ref, target_device_id, contact_info }) => {
       try {
-        let targetId = target_device_id;
-        if (ref && _lastRefMap[ref]) {
-          targetId = _lastRefMap[ref];
-        }
-        if (!targetId) {
-          return jsonResult({ error: "No target specified. Use 'ref' from scan results or 'target_device_id'." });
-        }
-        const result = await accept({ device_id: deriveDeviceId(sender_id, channel), target_device_id: targetId, contact_info });
+        const result = await accept({ device_id: deriveDeviceId(sender_id, channel), target_device_id, ref, contact_info });
         return jsonResult(result);
       } catch (e) {
         return jsonResult({ error: e.message });
@@ -176,6 +170,30 @@ export async function startMcpServer() {
     }
   );
 
+  // ─── antenna_discover ────────────────────────────────────────
+
+  server.tool(
+    "antenna_discover",
+    "Get today's global recommendation — the person most similar to you worldwide. 1 per day, no repeats.",
+    {
+      sender_id: z.string().describe("The sender's user ID"),
+      channel: z.string().describe("Channel name"),
+    },
+    async ({ sender_id, channel }) => {
+      try {
+        const result = await discover({ device_id: deriveDeviceId(sender_id, channel) });
+        if (result._ref_map) {
+          _lastRefMap = result._ref_map;
+          const { _ref_map, ...clean } = result;
+          return jsonResult(clean);
+        }
+        return jsonResult(result);
+      } catch (e) {
+        return jsonResult({ error: e.message });
+      }
+    }
+  );
+
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "antenna-fyi",
-  "version": "0.12.2",
+  "version": "0.14.0",
   "description": "Antenna — nearby people discovery. CLI + MCP server + OpenClaw skill & plugin, all in one package.",
   "type": "module",
   "bin": {

package/skill/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 — 聊天式引导（不要让用户填表）