antenna-fyi 0.8.0 → 0.8.2

package/lib/hermes-plugin/__init__.py

@@ -1,7 +1,7 @@
 """Antenna — Hermes Agent Plugin
 
-Nearby people discovery. Registers 5 tools and a pre_llm_call hook
-that auto-detects location data and prompts the agent to scan.
+Nearby people discovery. Registers 6 tools and a pre_llm_call hook
+that auto-detects location data (from messages + web GPS events).
 
 Drop this directory into ~/.hermes/plugins/antenna/
 """
@@ -13,6 +13,8 @@ from .tools import (
     handle_checkin,
     handle_check_matches,
     handle_bind,
+    _sb,
+    _device_id,
     SCAN_SCHEMA,
     PROFILE_SCHEMA,
     ACCEPT_SCHEMA,
@@ -21,6 +23,11 @@ from .tools import (
     BIND_SCHEMA,
 )
 import re
+import time
+
+# Track last checked timestamp for location events
+_last_event_check = 0
+_EVENT_CHECK_INTERVAL = 30  # seconds
 
 
 def register(ctx):
@@ -32,39 +39,57 @@ def register(ctx):
     ctx.register_tool("antenna_check_matches", CHECK_MATCHES_SCHEMA, handle_check_matches)
     ctx.register_tool("antenna_bind", BIND_SCHEMA, handle_bind)
 
-    # ── Hook: auto-detect location in messages ────────────────────
+    # ── Hook: auto-detect location + check web GPS events ─────────
     def on_pre_llm(messages, **kwargs):
-        """Check last user message for location data and inject scan hint."""
-        if not messages:
-            return None
-
-        last_msg = messages[-1] if isinstance(messages[-1], dict) else {}
-        content = last_msg.get("content", "")
-        if not isinstance(content, str):
-            return None
+        """Check for location data in messages AND pending web GPS events."""
+        global _last_event_check
+        hints = []
 
-        # Pattern 1: Hermes gateway may serialize location as text
-        # e.g. "📍 Location shared: 39.9908, 116.4872"
-        loc_match = re.search(
-            r"[Ll]ocation.*?(-?\d+\.?\d*)[,\s]+(-?\d+\.?\d*)", content
-        )
-
-        # Pattern 2: raw coordinates in message
-        if not loc_match:
-            loc_match = re.search(
-                r"(-?\d{1,3}\.\d{3,})[,\s]+(-?\d{1,3}\.\d{3,})", content
-            )
+        # 1. Check location_events table (web GPS updates)
+        now = time.time()
+        if now - _last_event_check > _EVENT_CHECK_INTERVAL:
+            _last_event_check = now
+            try:
+                sb = _sb()
+                resp = (
+                    sb.from_("location_events")
+                    .select("device_id, lat, lng")
+                    .gt("created_at", "now() - interval '2 minutes'")
+                    .order("created_at", desc=True)
+                    .limit(5)
+                    .execute()
+                )
+                if resp.data:
+                    for evt in resp.data:
+                        hints.append(
+                            f"[Antenna] 📡 用户 {evt['device_id']} 通过网页分享了位置 "
+                            f"({evt['lat']}, {evt['lng']})。"
+                            f"请使用 antenna_scan 查看附近有谁。"
+                        )
+            except Exception:
+                pass
 
-        if loc_match:
-            lat, lng = loc_match.group(1), loc_match.group(2)
-            return {
-                "context": (
-                    f"\n\n[Antenna] 📍 检测到位置 ({lat}, {lng})。"
-                    f"请使用 antenna_scan 工具查看附近有谁。"
-                    f"参数：lat={lat}, lng={lng}，sender_id 和 channel 从消息上下文获取。"
+        # 2. Check message content for coordinates
+        if messages:
+            last_msg = messages[-1] if isinstance(messages[-1], dict) else {}
+            content = last_msg.get("content", "")
+            if isinstance(content, str):
+                loc_match = re.search(
+                    r"[Ll]ocation.*?(-?\d+\.?\d*)[,\s]+(-?\d+\.?\d*)", content
                 )
-            }
+                if not loc_match:
+                    loc_match = re.search(
+                        r"(-?\d{1,3}\.\d{3,})[,\s]+(-?\d{1,3}\.\d{3,})", content
+                    )
+                if loc_match:
+                    lat, lng = loc_match.group(1), loc_match.group(2)
+                    hints.append(
+                        f"[Antenna] 📍 检测到位置 ({lat}, {lng})。"
+                        f"请使用 antenna_scan 查看附近有谁。"
+                    )
 
+        if hints:
+            return {"context": "\n".join(hints)}
         return None
 
     ctx.register_hook("pre_llm_call", on_pre_llm)

package/package.json

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

package/skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: antenna
-description: "Nearby people discovery via Antenna. Use when a user shares location, asks who's nearby, wants to set up their profile card, or interacts with match results. Handles location-based social discovery through the antenna_scan, antenna_profile, antenna_accept, and antenna_check_matches tools."
+description: "Nearby people discovery via Antenna. Use when a user shares location, asks who's nearby, wants to set up their profile card, or interacts with match results. Handles location-based social discovery through the antenna_scan, antenna_profile, antenna_accept, antenna_check_matches, and antenna_bind tools."
 metadata: { "openclaw": { "always": true } }
 ---
 
@@ -20,9 +20,20 @@ Plugin 安装后，agent 应该**主动**开始引导，不要等用户问"怎
 **第二步：聊天式填名片**（见下方详细流程）
 
 **第三步：名片存好后，要位置**
-> "名片存好了 ✅ 现在发个位置给我——在 Telegram/WhatsApp 里点位置分享就行。我帮你看看附近有谁值得认识。"
 
-**关键：名片先于位置。** 没有名片就扫描，附近的人看不到你的信息，匹配质量也差。
+名片保存后，**立刻**帮用户获取位置。有两种方式，优先用第一种：
+
+**方式 1：生成绑定链接（推荐）**
+调用 `antenna_bind` 生成链接，发给用户：
+> "名片存好了 ✅ 点这个链接，在手机浏览器打开，允许定位就行：
+> [链接]
+> 我收到你的位置后会自动帮你看看附近有谁。"
+
+**方式 2：直接发位置消息**
+如果用户在 Telegram/WhatsApp 里，可以直接发位置：
+> "或者你也可以直接在聊天里点位置分享发给我。"
+
+**关键：名片存好后必须主动要位置，不要等用户问。**
 
 ## When to use
 
@@ -72,6 +83,13 @@ Check for mutual matches and contact info updates.
 - `sender_id`, `channel`
 - 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.
+- `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
+
 ## Behavior guidelines
 
 ### First-time user — 聊天式引导（不要让用户填表）