antenna-fyi 1.3.1 → 1.3.2

package/lib/core.js

@@ -146,7 +146,7 @@ export async function scan({ lat, lng, radius_m = 500, device_id, supabaseUrl, s
       radius_m,
       profiles: [],
       _ref_map: {},
-      message: `附近暂时没人，今天的全球推荐已经用完了。明天再来！`,
+      message: `附近暂时没人，今天的全球推荐也用完了。明天再来！提示：Antenna 每天有 1 次全球推荐（antenna_discover），下次可以试试。`,
     };
   }
 

package/lib/hermes-plugin/__init__.py

@@ -197,7 +197,7 @@ def register(ctx):
                 if resp.data:
                     for evt in resp.data:
                         hints.append(
-                            f"[Antenna] 📡 用户 {evt['device_id']} 通过网页分享了位置 "
+                            f"[Antenna] 📡 有用户通过网页分享了位置 "
                             f"({evt['lat']}, {evt['lng']})。"
                             f"请使用 antenna_scan 查看附近有谁。"
                         )

package/lib/hermes-plugin/schemas.py

@@ -23,8 +23,12 @@ SCAN_SCHEMA = {
                 "type": "string",
                 "description": "Platform name (any platform: telegram, discord, webchat, signal, slack, etc.)",
             },
+            "chat_id": {
+                "type": "string",
+                "description": "REQUIRED for notifications. Pass chat/channel ID from message context.",
+            },
         },
-        "required": ["sender_id", "channel"],
+        "required": ["sender_id", "channel", "chat_id"],
     },
 }
 
@@ -51,8 +55,9 @@ PROFILE_SCHEMA = {
             "line2": {"type": "string", "description": "What you're into"},
             "line3": {"type": "string", "description": "What you're looking for"},
             "visible": {"type": "boolean", "description": "Visible to others"},
+            "matching_context": {"type": "string", "description": "Free-form context for AI matching (interests, goals, etc.)"},
         },
-        "required": ["action", "sender_id", "channel"],
+        "required": ["action", "sender_id", "channel", "chat_id"],
     },
 }
 
@@ -81,7 +86,7 @@ ACCEPT_SCHEMA = {
                 "description": "Contact info to share (e.g. 'WeChat: yi')",
             },
         },
-        "required": ["sender_id", "channel"],
+        "required": ["sender_id", "channel", "chat_id"],
     },
 }
 
@@ -103,7 +108,7 @@ CHECKIN_SCHEMA = {
                 "description": "Name of the place (optional)",
             },
         },
-        "required": ["lat", "lng", "sender_id", "channel"],
+        "required": ["lat", "lng", "sender_id", "channel", "chat_id"],
     },
 }
 
@@ -119,7 +124,7 @@ CHECK_MATCHES_SCHEMA = {
             "channel": {"type": "string"},
             "chat_id": {"type": "string", "description": "REQUIRED for notifications. Pass chat/channel ID from message context."},
         },
-        "required": ["sender_id", "channel"],
+        "required": ["sender_id", "channel", "chat_id"],
     },
 }
 
@@ -137,7 +142,7 @@ BIND_SCHEMA = {
             "purpose": {"type": "string", "description": "'profile' (default) or 'event'"},
             "event_code": {"type": "string", "description": "Event code (when purpose=event)"},
         },
-        "required": ["sender_id", "channel"],
+        "required": ["sender_id", "channel", "chat_id"],
     },
 }
 
@@ -149,6 +154,7 @@ PASS_SCHEMA = {
         "properties": {
             "sender_id": {"type": "string", "description": "The sender's user ID"},
             "channel": {"type": "string", "description": "Platform name (any platform works)"},
+            "chat_id": {"type": "string", "description": "REQUIRED for notifications. Pass chat/channel ID from message context."},
             "ref": {
                 "type": "string",
                 "description": "Ref number from scan/discover results (e.g. '1')",
@@ -158,7 +164,7 @@ PASS_SCHEMA = {
                 "description": "Device ID (use ref instead when possible)",
             },
         },
-        "required": ["sender_id", "channel"],
+        "required": ["sender_id", "channel", "chat_id"],
     },
 }
 
@@ -173,8 +179,9 @@ DISCOVER_SCHEMA = {
         "properties": {
             "sender_id": {"type": "string", "description": "The sender's user ID"},
             "channel": {"type": "string", "description": "Platform name (any platform works)"},
+            "chat_id": {"type": "string", "description": "REQUIRED for notifications. Pass chat/channel ID from message context."},
         },
-        "required": ["sender_id", "channel"],
+        "required": ["sender_id", "channel", "chat_id"],
     },
 }
 
@@ -198,8 +205,9 @@ EVENT_CREATE_SCHEMA = {
             "og_image": {"type": "string", "description": "OG image URL for social sharing"},
             "requires_approval": {"type": "boolean", "description": "Require host approval to join (default false)"},
             "screening_questions": {"type": "array", "items": {"type": "string"}, "description": "Screening questions for applicants"},
+            "chat_id": {"type": "string", "description": "REQUIRED for notifications. Pass chat/channel ID from message context."},
         },
-        "required": ["name", "sender_id", "channel", "starts_at", "ends_at"],
+        "required": ["name", "sender_id", "channel", "starts_at", "ends_at", "chat_id"],
     },
 }
 
@@ -215,8 +223,9 @@ EVENT_JOIN_SCHEMA = {
             "lat": {"type": "number", "description": "Latitude (optional, for auto-checkin)"},
             "lng": {"type": "number", "description": "Longitude (optional, for auto-checkin)"},
             "application_context": {"type": "string", "description": "Application context from screening conversation"},
+            "chat_id": {"type": "string", "description": "REQUIRED for notifications. Pass chat/channel ID from message context."},
         },
-        "required": ["code", "sender_id", "channel"],
+        "required": ["code", "sender_id", "channel", "chat_id"],
     },
 }
 
@@ -229,8 +238,9 @@ EVENT_SCAN_SCHEMA = {
             "code": {"type": "string", "description": "Event code"},
             "sender_id": {"type": "string", "description": "The sender's user ID"},
             "channel": {"type": "string", "description": "Platform name (any platform works)"},
+            "chat_id": {"type": "string", "description": "REQUIRED for notifications. Pass chat/channel ID from message context."},
         },
-        "required": ["code", "sender_id", "channel"],
+        "required": ["code", "sender_id", "channel", "chat_id"],
     },
 }
 
@@ -243,8 +253,9 @@ EVENT_END_SCHEMA = {
             "code": {"type": "string", "description": "Event code"},
             "sender_id": {"type": "string", "description": "The sender's user ID"},
             "channel": {"type": "string", "description": "Platform name (any platform works)"},
+            "chat_id": {"type": "string", "description": "REQUIRED for notifications. Pass chat/channel ID from message context."},
         },
-        "required": ["code", "sender_id", "channel"],
+        "required": ["code", "sender_id", "channel", "chat_id"],
     },
 }
 
@@ -273,8 +284,9 @@ EVENT_CHECKIN_SCHEMA = {
             "channel": {"type": "string", "description": "Platform name (any platform works)"},
             "lat": {"type": "number", "description": "Latitude (optional)"},
             "lng": {"type": "number", "description": "Longitude (optional)"},
+            "chat_id": {"type": "string", "description": "REQUIRED for notifications. Pass chat/channel ID from message context."},
         },
-        "required": ["code", "sender_id", "channel"],
+        "required": ["code", "sender_id", "channel", "chat_id"],
     },
 }
 
@@ -296,7 +308,7 @@ EVENT_UPDATE_SCHEMA = {
             "starts_at": {"type": "string"},
             "ends_at": {"type": "string"},
         },
-        "required": ["code", "sender_id", "channel"],
+        "required": ["code", "sender_id", "channel", "chat_id"],
     },
 }
 
@@ -312,7 +324,7 @@ EVENT_APPROVE_SCHEMA = {
             "chat_id": {"type": "string", "description": "REQUIRED for notifications. Pass chat/channel ID from message context."},
             "ref": {"type": "string"},
         },
-        "required": ["code", "sender_id", "channel", "ref"],
+        "required": ["code", "sender_id", "channel", "ref", "chat_id"],
     },
 }
 
@@ -328,7 +340,7 @@ EVENT_REJECT_SCHEMA = {
             "chat_id": {"type": "string", "description": "REQUIRED for notifications. Pass chat/channel ID from message context."},
             "ref": {"type": "string"},
         },
-        "required": ["code", "sender_id", "channel", "ref"],
+        "required": ["code", "sender_id", "channel", "ref", "chat_id"],
     },
 }
 
@@ -344,6 +356,6 @@ EVENT_ADD_HOST_SCHEMA = {
             "chat_id": {"type": "string", "description": "REQUIRED for notifications. Pass chat/channel ID from message context."},
             "ref": {"type": "string"},
         },
-        "required": ["code", "sender_id", "channel", "ref"],
+        "required": ["code", "sender_id", "channel", "ref", "chat_id"],
     },
 }

package/lib/hermes-plugin/tools.py

@@ -85,7 +85,7 @@ def handle_scan(params: dict) -> str:
     # Rate limit
     now = time.time()
     if did in _last_scan and now - _last_scan[did] < SCAN_DEBOUNCE_S:
-        return _ok({"nearby": [], "message": "刚刚才扫描过，稍等一会儿再试。", "rate_limited": True})
+        return _ok({"profiles": [], "message": "刚刚才扫描过，稍等一会儿再试。", "rate_limited": True})
     _last_scan[did] = now
 
     lat = params.get("lat")
@@ -99,7 +99,7 @@ def handle_scan(params: dict) -> str:
             lat = loc["lat"]
             lng = loc["lng"]
         else:
-            return _ok({"nearby": [], "message": "还没有位置信息。请先通过链接分享位置，或者发送位置消息。"})
+            return _ok({"profiles": [], "message": "还没有位置信息。请先通过链接分享位置，或者发送位置消息。"})
 
     flat, flng = _fuzzy(lat, lng)
 
@@ -111,7 +111,7 @@ def handle_scan(params: dict) -> str:
     others = [p for p in (resp.data or []) if p.get("device_id") != did]
 
     if not others:
-        return _ok({"nearby": [], "message": f"在 {radius}m 范围内没有发现其他人。"})
+        return _ok({"profiles": [], "message": f"在 {radius}m 范围内没有发现其他人。"})
 
     # Build ref mapping — never expose device_id to agent/user
     global _last_ref_map
@@ -131,8 +131,8 @@ def handle_scan(params: dict) -> str:
         })
 
     return _ok({
-        "nearby": profiles,
-        "total": len(others),
+        "profiles": profiles,
+        "count": len(others),
         "radius_m": radius,
         "instruction": "根据你对用户的了解，判断哪些人值得推荐，为每个推荐写一句个性化的匹配理由。使用 ref 编号（如 '1', '2')来引用人员，不要显示 device_id。",
     })
@@ -149,7 +149,7 @@ def handle_profile(params: dict) -> str:
         return _ok({"exists": True, "profile": resp.data})
 
     # set
-    resp = sb.rpc("upsert_profile", {
+    rpc_params = {
         "p_device_id": did,
         "p_display_name": params.get("display_name"),
         "p_emoji": params.get("emoji"),
@@ -157,7 +157,10 @@ def handle_profile(params: dict) -> str:
         "p_line2": params.get("line2"),
         "p_line3": params.get("line3"),
         "p_visible": params.get("visible", True),
-    }).execute()
+    }
+    if params.get("matching_context") is not None:
+        rpc_params["p_matching_context"] = params["matching_context"]
+    resp = sb.rpc("upsert_profile", rpc_params).execute()
 
     if resp.data:
         return _ok({"updated": True, "profile": resp.data, "next_step": "IMPORTANT: Now call antenna_bind to generate a GPS link for the user. Do not skip this."})
@@ -225,45 +228,37 @@ def handle_check_matches(params: dict) -> str:
     sb = _sb()
     did = _device_id(params["sender_id"], params["channel"], params.get("chat_id"))
 
-    resp = sb.rpc("get_my_matches", {"p_device_id": did}).execute()
-    all_matches = resp.data or []
+    resp = sb.rpc("get_my_matches_with_profiles", {"p_device_id": did}).execute()
+    data = resp.data or {}
 
-    if not all_matches:
-        return _ok({"mutual_matches": [], "incoming_accepts": [], "message": "目前没有进行中的匹配。"})
+    raw_mutual = data.get("mutual_matches") or []
+    raw_incoming = data.get("incoming_accepts") or []
 
-    my = [m for m in all_matches if m.get("device_id_a") == did]
-    incoming = [m for m in all_matches if m.get("device_id_b") == did]
+    if not raw_mutual and not raw_incoming:
+        return _ok({"mutual_matches": [], "incoming_accepts": [], "message": "目前没有进行中的匹配。"})
 
-    # Mutual
     mutual = []
-    for m in my:
-        rev = next((i for i in incoming if i.get("device_id_a") == m.get("device_id_b")), None)
-        if rev:
-            prof = sb.rpc("get_profile", {"p_device_id": m["device_id_b"]}).execute()
-            p = prof.data or {}
-            mutual.append({
-                "ref": str(len(mutual) + 1),
-                "_device_id": m["device_id_b"],
-                "name": p.get("display_name") or "匿名",
-                "emoji": p.get("emoji") or "👤",
-                "their_contact": rev.get("contact_info_a"),
-                "you_shared": m.get("contact_info_a"),
-            })
-
-    # Incoming only
+    for i, m in enumerate(raw_mutual):
+        mutual.append({
+            "ref": str(i + 1),
+            "_device_id": m.get("target_id"),
+            "name": m.get("name") or "匿名",
+            "emoji": m.get("emoji") or "👤",
+            "their_contact": m.get("their_contact"),
+            "you_shared": m.get("you_shared"),
+        })
+
     inc_only = []
-    for m in incoming:
-        already = next((x for x in my if x.get("device_id_b") == m.get("device_id_a")), None)
-        if not already:
-            prof = sb.rpc("get_profile", {"p_device_id": m["device_id_a"]}).execute()
-            p = prof.data or {}
-            inc_only.append({
-                "ref": str(len(inc_only) + 1),
-                "_device_id": m["device_id_a"],
-                "name": p.get("display_name") or "匿名",
-                "emoji": p.get("emoji") or "👤",
-                "line1": p.get("line1"),
-            })
+    for i, m in enumerate(raw_incoming):
+        inc_only.append({
+            "ref": str(i + 1),
+            "_device_id": m.get("target_id"),
+            "name": m.get("name") or "匿名",
+            "emoji": m.get("emoji") or "👤",
+            "line1": m.get("line1"),
+            "line2": m.get("line2"),
+            "line3": m.get("line3"),
+        })
 
     msgs = []
     if mutual:
@@ -294,7 +289,7 @@ def handle_pass(params: dict) -> str:
     if not target and ref:
         # Try resolve via RPC
         try:
-            resp = sb.rpc("resolve_ref", {"p_device_id": did, "p_ref": ref}).execute()
+            resp = sb.rpc("resolve_ref", {"p_owner": did, "p_ref": ref}).execute()
             if resp.data:
                 target = resp.data.get("target_device_id")
         except Exception:
@@ -304,7 +299,7 @@ def handle_pass(params: dict) -> str:
 
     sb.rpc("pass_user", {
         "p_device_id": did,
-        "p_target_device_id": target,
+        "p_passed_device_id": target,
     }).execute()
 
     return _ok({"passed": True, "message": "已跳过，不会再推荐这个人了。"})
@@ -329,9 +324,11 @@ def handle_discover(params: dict) -> str:
     my_data = my_prof.data or {}
     my_lines = [my_data.get("line1", ""), my_data.get("line2", ""), my_data.get("line3", "")]
 
+    ref_map = {}
     for i, p in enumerate(results):
         ref = str(i + 1)
         _last_ref_map[ref] = p.get("device_id")
+        ref_map[ref] = p.get("device_id")
 
         their_lines = [p.get("line1", ""), p.get("line2", ""), p.get("line3", "")]
 
@@ -361,6 +358,17 @@ def handle_discover(params: dict) -> str:
             profile["match_reason"] = match_reason
         profiles.append(profile)
 
+    # Save refs and log recommendations
+    try:
+        sb.rpc("save_scan_refs", {"p_owner": did, "p_refs": ref_map}).execute()
+    except Exception:
+        pass
+    for p in results:
+        try:
+            sb.rpc("log_recommendation", {"p_device_id": did, "p_recommended_id": p["device_id"]}).execute()
+        except Exception:
+            pass
+
     return _ok({
         "count": len(profiles),
         "profiles": profiles,

package/package.json

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

package/skill/SKILL.md

@@ -230,7 +230,7 @@ Source code is open: https://github.com/H1an1/Antenna
 > "最后——你想被叫什么？再选个 emoji 代表你自己。"
 
 **第六步：确认**
-把名片组装好，展示给用户确认：
+把名片组装好，**确认三行都有内容后**展示给用户确认：
 > 你的名片：
 >
 > 🎸 **小林**
@@ -240,7 +240,8 @@ Source code is open: https://github.com/H1an1/Antenna
 >
 > 看看有没有要改的？OK 的话我就存了。
 
-用户说 OK → `antenna_profile` action="set" 保存。
+用户说 OK → **检查 line1、line2、line3 都不为空后** 调 `antenna_profile` action="set" 保存。
+如果某一行为空，先问用户补完再保存。后端会拒绝没有 line1 的新 profile，并对缺失的 line2/line3 返回 warning。
 用户说要改 → 改完再确认。
 
 **关键原则：**
@@ -253,6 +254,10 @@ Source code is open: https://github.com/H1an1/Antenna
 
 ### Showing results — 你来判断，不是服务器
 
+**第一次 scan 的新用户：** 简短一句解释："这是附近的人。Antenna 基于 AI 匹配，看到感兴趣的人 accept，双向匹配后交换联系方式。"
+
+**Profile 不完整时：** 如果用户的 profile 只有 1 行，提示："你的名片只填了一行，补完后匹配质量会更好。要现在补吗？"
+
 `antenna_scan` 返回的是附近所有人的名片，**没有打分、没有预匹配**。你需要：
 
 **全球推荐 fallback：** 如果 scan 结果里有 `global: true`，说明附近没人，这些是全球推荐。告诉用户“附近暂时没人，但全球有这几个有意思的人”，然后正常推荐。用户仍然可以 accept。