antenna-fyi 0.7.0 → 0.8.0

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

@@ -12,11 +12,13 @@ from .tools import (
     handle_accept,
     handle_checkin,
     handle_check_matches,
+    handle_bind,
     SCAN_SCHEMA,
     PROFILE_SCHEMA,
     ACCEPT_SCHEMA,
     CHECKIN_SCHEMA,
     CHECK_MATCHES_SCHEMA,
+    BIND_SCHEMA,
 )
 import re
 
@@ -28,6 +30,7 @@ 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 ────────────────────
     def on_pre_llm(messages, **kwargs):

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.0",
   "description": "Antenna — nearby people discovery. CLI + MCP server + OpenClaw skill & plugin, all in one package.",
   "type": "module",
   "bin": {