antenna-fyi 0.8.2 → 0.9.1

package/lib/core.js

@@ -35,6 +35,18 @@ export function fuzzyCoord(lat, lng) {
 
 export async function scan({ lat, lng, radius_m = 500, device_id, supabaseUrl, supabaseKey }) {
   const sb = getClient(supabaseUrl, supabaseKey);
+
+  // If no lat/lng provided, read from profile (web GPS bind scenario)
+  if ((lat == null || lng == null) && device_id) {
+    const { data: loc } = await sb.rpc("get_profile_location", { p_device_id: device_id });
+    if (loc?.found) {
+      lat = loc.lat;
+      lng = loc.lng;
+    } else {
+      return { count: 0, radius_m, profiles: [], message: "还没有位置信息。请先通过链接分享位置，或者发送位置消息。" };
+    }
+  }
+
   const fuzzy = fuzzyCoord(lat, lng);
 
   if (device_id) {
@@ -105,7 +117,7 @@ export async function setProfile({
     p_visible: visible,
   });
   if (error) throw new Error(error.message);
-  return data;
+  return { ...data, next_step: "IMPORTANT: Now call antenna_bind to generate a GPS link for the user. Do not skip this." };
 }
 
 // ─── accept ──────────────────────────────────────────────────────────

package/lib/hermes-plugin/schemas.py

@@ -3,15 +3,14 @@
 SCAN_SCHEMA = {
     "name": "antenna_scan",
     "description": (
-        "Scan for nearby people at a given location. Returns raw profile cards "
-        "of nearby people — the agent should read these cards and decide who to "
-        "recommend based on its understanding of the user."
+        "Scan for nearby people. If lat/lng are omitted, uses the location "
+        "from the user's web GPS binding (antenna.fyi/locate)."
     ),
     "parameters": {
         "type": "object",
         "properties": {
-            "lat": {"type": "number", "description": "Latitude"},
-            "lng": {"type": "number", "description": "Longitude"},
+            "lat": {"type": "number", "description": "Latitude (optional if location was shared via web)"},
+            "lng": {"type": "number", "description": "Longitude (optional if location was shared via web)"},
             "radius_m": {
                 "type": "number",
                 "description": "Search radius in meters (default: 500)",
@@ -25,7 +24,7 @@ SCAN_SCHEMA = {
                 "description": "Platform name (telegram, discord, etc.)",
             },
         },
-        "required": ["lat", "lng", "sender_id", "channel"],
+        "required": ["sender_id", "channel"],
     },
 }
 

package/lib/hermes-plugin/tools.py

@@ -76,7 +76,20 @@ def handle_scan(params: dict) -> str:
         return _ok({"nearby": [], "message": "刚刚才扫描过，稍等一会儿再试。", "rate_limited": True})
     _last_scan[did] = now
 
-    flat, flng = _fuzzy(params["lat"], params["lng"])
+    lat = params.get("lat")
+    lng = params.get("lng")
+
+    # If no coordinates, read from profile (web GPS bind)
+    if lat is None or lng is None:
+        loc_resp = sb.rpc("get_profile_location", {"p_device_id": did}).execute()
+        loc = loc_resp.data if loc_resp.data else {}
+        if loc.get("found"):
+            lat = loc["lat"]
+            lng = loc["lng"]
+        else:
+            return _ok({"nearby": [], "message": "还没有位置信息。请先通过链接分享位置，或者发送位置消息。"})
+
+    flat, flng = _fuzzy(lat, lng)
 
     # Update own location
     sb.rpc("upsert_profile_location", {
@@ -133,7 +146,7 @@ def handle_profile(params: dict) -> str:
     }).execute()
 
     if resp.data:
-        return _ok({"updated": True, "profile": 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."})
     return _ok({"error": "upsert_profile failed"})
 
 

package/lib/mcp.js

@@ -30,10 +30,10 @@ export async function startMcpServer() {
 
   server.tool(
     "antenna_scan",
-    "Scan for nearby people at a given location.",
+    "Scan for nearby people. If lat/lng are omitted, uses the location from the user's web GPS binding.",
     {
-      lat: z.number().describe("Latitude"),
-      lng: z.number().describe("Longitude"),
+      lat: z.number().optional().describe("Latitude (optional if location was shared via web)"),
+      lng: z.number().optional().describe("Longitude (optional if location was shared via web)"),
       radius_m: z.number().optional().default(500).describe("Search radius in meters"),
       sender_id: z.string().describe("The sender's user ID"),
       channel: z.string().describe("Channel name (telegram, whatsapp, discord, etc.)"),

package/package.json

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

package/skill/SKILL.md

@@ -19,21 +19,18 @@ Plugin 安装后，agent 应该**主动**开始引导，不要等用户问"怎
 
 **第二步：聊天式填名片**（见下方详细流程）
 
-**第三步：名片存好后，要位置**
+**第三步：名片存好后，立刻调 antenna_bind**
 
-名片保存后，**立刻**帮用户获取位置。有两种方式，优先用第一种：
+**这一步是强制的。** 名片保存成功后，你**必须立刻**调用 `antenna_bind` 生成链接并发给用户。不要问用户要不要，不要等用户说什么，直接调。
 
-**方式 1：生成绑定链接（推荐）**
 调用 `antenna_bind` 生成链接，发给用户：
 > "名片存好了 ✅ 点这个链接，在手机浏览器打开，允许定位就行：
 > [链接]
 > 我收到你的位置后会自动帮你看看附近有谁。"
 
-**方式 2：直接发位置消息**
-如果用户在 Telegram/WhatsApp 里，可以直接发位置：
-> "或者你也可以直接在聊天里点位置分享发给我。"
+备选：如果用户在 Telegram/WhatsApp 里，也可以直接发位置消息。但优先用链接。
 
-**关键：名片存好后必须主动要位置，不要等用户问。**
+**⚠️ 如果你保存了名片但没有调 antenna_bind，你就没有完成 onboarding。**
 
 ## When to use
 
@@ -84,11 +81,11 @@ Check for mutual matches and contact info updates.
 - Returns mutual matches with any contact info the other person shared
 
 ### `antenna_bind`
-Generate a GPS binding link. Call this after profile is created to get the user's location.
+Generate a GPS binding link. **You MUST call this immediately after saving a profile.** Do not skip this step.
 - `sender_id`, `channel`: from context
 - Returns a URL like `https://www.antenna.fyi/locate?token=xxx`
-- Send this link to the user — they open it on their phone, allow GPS, and their location is automatically shared with Supabase
-- **Always call this right after saving the profile** — don't wait for the user to ask
+- 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.**
 
 ## Behavior guidelines