antenna-fyi 0.7.0 → 0.8.1

package/bin/antenna.js

@@ -7,6 +7,7 @@ import {
   handleAccept,
   handleCheckin,
   handleMatches,
+  handleBind,
   handleSetup,
   handleStatus,
   handleInstallSkill,
@@ -30,6 +31,8 @@ async function main() {
       return handleCheckin(f);
     case "matches":
       return handleMatches(f);
+    case "bind":
+      return handleBind(f);
     case "serve": {
       const { startMcpServer } = await import("../lib/mcp.js");
       return startMcpServer();

package/lib/cli.js

@@ -1,6 +1,6 @@
 // antenna CLI command handlers
 
-import { scan, getProfile, setProfile, accept, checkMatches, checkin } from "./core.js";
+import { scan, getProfile, setProfile, accept, checkMatches, checkin, createBindToken } from "./core.js";
 import { createInterface } from "readline";
 import { existsSync, mkdirSync, copyFileSync } from "fs";
 import { join, dirname } from "path";
@@ -106,6 +106,15 @@ export async function handleMatches(f) {
   }
 }
 
+export async function handleBind(f) {
+  if (!f.id) return console.error("Usage: antenna bind --id telegram:123");
+  const result = await createBindToken({ device_id: f.id });
+  console.log("\n🔗 GPS Binding Link:\n");
+  console.log(`  ${result.url}\n`);
+  console.log("Send this to the user. Opening it on their phone will share GPS with their agent.");
+  console.log();
+}
+
 export async function handleSetup(f) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
   const ask = (q) => new Promise((resolve) => rl.question(q, resolve));
@@ -276,6 +285,7 @@ Usage:
   antenna profile    --id telegram:123 [--name Yi --emoji 🦦 --line1 '...']
   antenna accept     --id telegram:123 --target telegram:789 [--contact 'WeChat: yi']
   antenna matches    --id telegram:123
+  antenna bind       --id telegram:123
   antenna serve      Start MCP server (stdio transport)
   antenna setup      Interactive profile setup [--id telegram:123]
   antenna status     Show config & status [--id telegram:123]

package/lib/core.js

@@ -245,3 +245,17 @@ export async function checkMatches({ device_id, supabaseUrl, supabaseKey }) {
     message: messages.join("；"),
   };
 }
+
+// ─── createBindToken ─────────────────────────────────────────────
+
+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 });
+  if (error) throw new Error(error.message);
+  const baseUrl = "https://www.antenna.fyi";
+  return {
+    token: data.token,
+    url: `${baseUrl}/locate?token=${data.token}`,
+    message: "发送这个链接给用户，在手机浏览器打开即可共享位置。",
+  };
+}

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/
 """
@@ -12,13 +12,22 @@ from .tools import (
     handle_accept,
     handle_checkin,
     handle_check_matches,
+    handle_bind,
+    _sb,
+    _device_id,
     SCAN_SCHEMA,
     PROFILE_SCHEMA,
     ACCEPT_SCHEMA,
     CHECKIN_SCHEMA,
     CHECK_MATCHES_SCHEMA,
+    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):
@@ -28,40 +37,59 @@ def register(ctx):
     ctx.register_tool("antenna_accept", ACCEPT_SCHEMA, handle_accept)
     ctx.register_tool("antenna_checkin", CHECKIN_SCHEMA, handle_checkin)
     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/lib/hermes-plugin/schemas.py

@@ -115,3 +115,19 @@ CHECK_MATCHES_SCHEMA = {
         "required": ["sender_id", "channel"],
     },
 }
+
+BIND_SCHEMA = {
+    "name": "antenna_bind",
+    "description": (
+        "Generate a GPS binding link. Send this URL to the user so they can "
+        "share their phone's location via the web browser."
+    ),
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "sender_id": {"type": "string"},
+            "channel": {"type": "string"},
+        },
+        "required": ["sender_id", "channel"],
+    },
+}

package/lib/hermes-plugin/tools.py

@@ -242,3 +242,22 @@ def handle_check_matches(params: dict) -> str:
         "incoming_accepts": inc_only,
         "message": "；".join(msgs),
     })
+
+
+BASE_URL = "https://www.antenna.fyi"
+
+
+def handle_bind(params: dict) -> str:
+    sb = _sb()
+    did = _device_id(params["sender_id"], params["channel"])
+
+    resp = sb.rpc("create_bind_token", {"p_device_id": did}).execute()
+    if not resp.data:
+        return _ok({"error": "Failed to create bind token"})
+
+    token = resp.data.get("token")
+    return _ok({
+        "token": token,
+        "url": f"{BASE_URL}/locate?token={token}",
+        "message": "发送这个链接给用户，在手机浏览器打开即可共享位置。",
+    })

package/lib/mcp.js

@@ -10,6 +10,7 @@ import {
   accept,
   checkMatches,
   checkin,
+  createBindToken,
   deriveDeviceId,
 } from "./core.js";
 
@@ -143,6 +144,25 @@ export async function startMcpServer() {
     }
   );
 
+  // ─── antenna_bind ────────────────────────────────────────────
+
+  server.tool(
+    "antenna_bind",
+    "Generate a GPS binding link. Send this to the user so they can share their phone's location via the web.",
+    {
+      sender_id: z.string().describe("The sender's user ID"),
+      channel: z.string().describe("Channel name"),
+    },
+    async ({ sender_id, channel }) => {
+      try {
+        const result = await createBindToken({ device_id: deriveDeviceId(sender_id, channel) });
+        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.7.0",
+  "version": "0.8.1",
   "description": "Antenna — nearby people discovery. CLI + MCP server + OpenClaw skill & plugin, all in one package.",
   "type": "module",
   "bin": {