antenna-fyi 1.2.8 → 1.2.10

package/bin/antenna.js

@@ -11,6 +11,7 @@ import {
   handleEvent,
   handleBind,
   handlePass,
+  handleWatch,
   handleSetup,
   handleStatus,
   handleInstallSkill,
@@ -42,6 +43,8 @@ async function main() {
       return handleBind(f);
     case "pass":
       return handlePass(f);
+    case "watch":
+      return handleWatch(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, createBindToken, discover, createEvent, endEvent, eventCheckin, joinEvent, eventScan, pass as passUser, uploadEventImage } from "./core.js";
+import { scan, getProfile, setProfile, accept, checkMatches, checkin, createBindToken, discover, createEvent, endEvent, eventCheckin, joinEvent, eventScan, pass as passUser, uploadEventImage, getClient } from "./core.js";
 import { createInterface } from "readline";
 import { existsSync, mkdirSync, copyFileSync, readFileSync } from "fs";
 import { join, dirname, extname } from "path";
@@ -401,6 +401,197 @@ export function handleInstallHermesPlugin() {
   console.log();
 }
 
+export async function handleWatch(f) {
+  const id = f.id;
+  if (!id) {
+    console.error("❌ --id required (e.g. --id telegram:123)");
+    process.exit(1);
+  }
+
+  const sb = getClient();
+  const notified = new Set();
+
+  // Detect local agent framework for push notifications
+  let pushMethod = "terminal"; // default: just print
+  try {
+    execSync("which openclaw", { stdio: "pipe" });
+    // Verify gateway is running
+    try {
+      execSync("openclaw gateway health", { stdio: "pipe", timeout: 5000 });
+      pushMethod = "openclaw";
+    } catch { /* gateway not running */ }
+  } catch { /* openclaw not installed */ }
+
+  if (pushMethod === "terminal") {
+    try {
+      execSync("which hermes", { stdio: "pipe" });
+      try {
+        execSync("hermes gateway status", { stdio: "pipe", timeout: 5000 });
+        pushMethod = "hermes";
+      } catch { /* hermes gateway not running */ }
+    } catch { /* hermes not installed */ }
+  }
+
+  console.log(`📡 Watching for new matches for ${id}...`);
+  if (pushMethod === "openclaw") {
+    console.log(`   🔗 Detected OpenClaw — will push notifications to your channel.`);
+  } else if (pushMethod === "hermes") {
+    console.log(`   🔗 Detected Hermes — will push notifications to your channel.`);
+  } else {
+    console.log(`   ℹ️  No agent framework detected — notifications will print here.`);
+  }
+  console.log(`   Press Ctrl+C to stop.\n`);
+
+  // Push notification helper
+  function pushNotify(message) {
+    console.log(message); // always print to terminal
+
+    if (pushMethod === "openclaw") {
+      try {
+        const parts = id.split(":");
+        const channel = parts[0];
+        const userId = parts.slice(1).join(":");
+        execSync(
+          `openclaw agent` +
+          ` --message ${JSON.stringify(message)}` +
+          ` --deliver` +
+          ` --reply-channel ${channel}` +
+          ` --reply-to "${userId}"`,
+          { timeout: 30_000, stdio: "pipe" }
+        );
+      } catch (err) {
+        // silent — terminal output is the fallback
+      }
+    } else if (pushMethod === "hermes") {
+      try {
+        // Use hermes cron to create a one-shot notification
+        const parts = id.split(":");
+        const channel = parts[0];
+        execSync(
+          `hermes cron create` +
+          ` --name "Antenna notification"` +
+          ` --run-now` +
+          ` --once` +
+          ` --message ${JSON.stringify(message)}` +
+          ` --deliver ${channel}`,
+          { timeout: 30_000, stdio: "pipe" }
+        );
+      } catch (err) {
+        // silent — terminal output is the fallback
+      }
+    }
+  }
+
+  // Initial check
+  const initial = await checkMatches({ device_id: id });
+  if (initial.mutual_matches?.length) {
+    console.log(`🎉 You have ${initial.mutual_matches.length} mutual match(es)!`);
+    for (const m of initial.mutual_matches) {
+      const key = `mutual:${m.device_id}`;
+      notified.add(key);
+      console.log(`   ${m.emoji || "👤"} ${m.name}${m.their_contact ? " — contact: " + m.their_contact : ""}`);
+    }
+    console.log();
+  }
+  if (initial.incoming_accepts?.length) {
+    console.log(`📩 ${initial.incoming_accepts.length} person(s) want to meet you!`);
+    for (const m of initial.incoming_accepts) {
+      const key = `incoming:${m.device_id}`;
+      notified.add(key);
+      console.log(`   ${m.emoji || "👤"} ${m.name} — ${m.line1 || ""}`);
+    }
+    console.log();
+  }
+
+  // Subscribe to realtime changes on matches table
+  const channel = sb
+    .channel("antenna-cli-watch")
+    .on("postgres_changes",
+      { event: "INSERT", schema: "public", table: "matches" },
+      async (payload) => {
+        try {
+          const row = payload.new;
+          if (!row) return;
+
+          // Someone accepted me
+          if (row.device_id_b === id) {
+            const key = `incoming:${row.device_id_a}`;
+            if (notified.has(key)) return;
+            notified.add(key);
+
+            const profile = await getProfile({ device_id: row.device_id_a });
+            const name = profile?.display_name || "Someone";
+            const emoji = profile?.emoji || "👤";
+
+            // Check if mutual
+            const matches = await checkMatches({ device_id: id });
+            const isMutual = matches.mutual_matches?.some(m => m.device_id === row.device_id_a);
+
+            if (isMutual) {
+              const mutualKey = `mutual:${row.device_id_a}`;
+              notified.add(mutualKey);
+              const contact = row.contact_info_a;
+              pushNotify(`🎉 MUTUAL MATCH! ${emoji} ${name} also accepted you!${contact ? " Contact: " + contact : ""}`);
+            } else {
+              pushNotify(`📩 ${emoji} ${name} wants to meet you! Run: antenna accept --id ${id} --target ${row.device_id_a}`);
+            }
+          }
+
+          // I accepted someone and they also accepted me
+          if (row.device_id_a === id) {
+            const matches = await checkMatches({ device_id: id });
+            const mutual = matches.mutual_matches?.find(m => m.device_id === row.device_id_b);
+            if (mutual) {
+              const mutualKey = `mutual:${row.device_id_b}`;
+              if (!notified.has(mutualKey)) {
+                notified.add(mutualKey);
+                pushNotify(`🎉 MUTUAL MATCH! ${mutual.emoji || "👤"} ${mutual.name}!${mutual.their_contact ? " Contact: " + mutual.their_contact : ""}`);
+              }
+            }
+          }
+        } catch (err) {
+          // silent
+        }
+      }
+    )
+    .subscribe((status) => {
+      if (status === "SUBSCRIBED") {
+        console.log("✅ Connected — listening for matches in real-time.");
+      } else if (status === "CHANNEL_ERROR" || status === "TIMED_OUT") {
+        console.log(`⚠️  Connection issue (${status}), retrying...`);
+      }
+    });
+
+  // Keep alive — also poll every 2 minutes as fallback
+  const pollInterval = setInterval(async () => {
+    try {
+      const result = await checkMatches({ device_id: id });
+      for (const m of (result.mutual_matches || [])) {
+        const key = `mutual:${m.device_id}`;
+        if (!notified.has(key)) {
+          notified.add(key);
+          pushNotify(`🎉 MUTUAL MATCH! ${m.emoji || "👤"} ${m.name}!${m.their_contact ? " Contact: " + m.their_contact : ""}`);
+        }
+      }
+      for (const m of (result.incoming_accepts || [])) {
+        const key = `incoming:${m.device_id}`;
+        if (!notified.has(key)) {
+          notified.add(key);
+          pushNotify(`📩 ${m.emoji || "👤"} ${m.name} wants to meet you!`);
+        }
+      }
+    } catch { /* silent */ }
+  }, 2 * 60 * 1000);
+
+  // Handle Ctrl+C
+  process.on("SIGINT", () => {
+    console.log("\n👋 Stopped watching.");
+    clearInterval(pollInterval);
+    sb.removeChannel(channel);
+    process.exit(0);
+  });
+}
+
 export function printHelp() {
   console.log(`📡 Antenna — nearby people discovery
 
@@ -413,6 +604,7 @@ Usage:
   antenna matches    --id telegram:123
   antenna discover   --id telegram:123
   antenna event      --create --name 'AI Meetup' [--desc '...'] [--og-image 'url'] | --join --code abc123 | --scan --code abc123 | --end --code abc123 --id telegram:123 | --upload-image --code abc123 --file /path/to/image.png
+  antenna watch       --id telegram:123  Watch for new matches in real-time (Ctrl+C to stop)
   antenna bind       --id telegram:123
   antenna serve      Start MCP server (stdio transport)
   antenna setup      Interactive profile setup [--id telegram:123]

package/lib/core.js

@@ -515,6 +515,15 @@ export async function endEvent({ code, device_id, supabaseUrl, supabaseKey }) {
 
 export async function eventCheckin({ code, device_id, lat, lng, supabaseUrl, supabaseKey }) {
   const sb = getClient(supabaseUrl, supabaseKey);
+
+  // Auto-read profile location if not provided
+  if (lat == null || lng == null) {
+    try {
+      const { data: loc } = await sb.rpc("get_profile_location", { p_device_id: device_id });
+      if (loc?.lat && loc?.lng) { lat = loc.lat; lng = loc.lng; }
+    } catch {}
+  }
+
   const fuzzy = (lat != null && lng != null) ? fuzzyCoord(lat, lng) : { lat: null, lng: null };
   const { data, error } = await sb.rpc("event_checkin", {
     p_code: code, p_device_id: device_id,
@@ -577,14 +586,21 @@ export async function getEvent({ code, supabaseUrl, supabaseKey }) {
   return data;
 }
 
-export async function createBindToken({ device_id, supabaseUrl, supabaseKey }) {
+export async function createBindToken({ device_id, purpose, event_code, supabaseUrl, supabaseKey }) {
   const sb = getClient(supabaseUrl, supabaseKey);
-  const { data, error } = await sb.rpc("create_bind_token", { p_device_id: device_id });
+  const { data, error } = await sb.rpc("create_bind_token", {
+    p_device_id: device_id,
+    p_purpose: purpose || "profile",
+    p_event_code: event_code || null,
+  });
   if (error) throw new Error(error.message);
   const baseUrl = "https://www.antenna.fyi";
   return {
     token: data.token,
     url: `${baseUrl}/locate?token=${data.token}`,
-    message: "发送这个链接给用户，在手机浏览器打开即可共享位置。",
+    purpose: purpose || "profile",
+    message: purpose === "event"
+      ? "发送这个链接给活动创建者，在活动地点打开即可设定活动位置。"
+      : "发送这个链接给用户，在手机浏览器打开即可共享位置。",
   };
 }

package/lib/hermes-plugin/schemas.py

@@ -122,14 +122,15 @@ CHECK_MATCHES_SCHEMA = {
 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."
+        "Generate a GPS binding link. Use purpose='event' + event_code when setting an event's location."
     ),
     "parameters": {
         "type": "object",
         "properties": {
             "sender_id": {"type": "string"},
             "channel": {"type": "string"},
+            "purpose": {"type": "string", "description": "'profile' (default) or 'event'"},
+            "event_code": {"type": "string", "description": "Event code (when purpose=event)"},
         },
         "required": ["sender_id", "channel"],
     },

package/lib/hermes-plugin/tools.py

@@ -452,16 +452,28 @@ def handle_event_scan(params: dict) -> str:
 def handle_bind(params: dict) -> str:
     sb = _sb()
     did = _device_id(params["sender_id"], params["channel"])
+    purpose = params.get("purpose", "profile")
+    event_code = params.get("event_code")
 
-    resp = sb.rpc("create_bind_token", {"p_device_id": did}).execute()
+    resp = sb.rpc("create_bind_token", {
+        "p_device_id": did,
+        "p_purpose": purpose,
+        "p_event_code": event_code,
+    }).execute()
     if not resp.data:
         return _ok({"error": "Failed to create bind token"})
 
     token = resp.data.get("token")
+    msg = (
+        "发送这个链接给活动创建者，在活动地点打开即可设定活动位置。"
+        if purpose == "event"
+        else "发送这个链接给用户，在手机浏览器打开即可共享位置。"
+    )
     return _ok({
         "token": token,
         "url": f"{BASE_URL}/locate?token={token}",
-        "message": "发送这个链接给用户，在手机浏览器打开即可共享位置。",
+        "purpose": purpose,
+        "message": msg,
     })
 
 

package/lib/mcp.js

@@ -37,6 +37,39 @@ export async function startMcpServer() {
   // Store last scan ref map for resolving refs in accept
   let _lastRefMap = {};
 
+  // Track known device_ids and last notified matches for piggyback notifications
+  const _knownDeviceIds = new Set();
+  const _notifiedMatches = new Set();
+
+  // Piggyback match check: append pending notifications to any tool response
+  async function withMatchNotifications(deviceId, result) {
+    _knownDeviceIds.add(deviceId);
+    try {
+      const matches = await checkMatches({ device_id: deviceId });
+      const notifications = [];
+
+      for (const m of (matches.mutual_matches || [])) {
+        const key = `mutual:${m.device_id}`;
+        if (!_notifiedMatches.has(key)) {
+          _notifiedMatches.add(key);
+          notifications.push(`🎉 双向匹配！${m.emoji || "👤"} ${m.name} 也接受了你！${m.their_contact ? "联系方式：" + m.their_contact : ""}`);
+        }
+      }
+      for (const m of (matches.incoming_accepts || [])) {
+        const key = `incoming:${m.device_id}`;
+        if (!_notifiedMatches.has(key)) {
+          _notifiedMatches.add(key);
+          notifications.push(`📩 ${m.emoji || "👤"} ${m.name} 想认识你！用 antenna_check_matches 查看详情。`);
+        }
+      }
+
+      if (notifications.length > 0) {
+        result._pending_notifications = notifications;
+      }
+    } catch { /* silent */ }
+    return result;
+  }
+
   // ─── antenna_scan ──────────────────────────────────────────────────
 
   server.tool(
@@ -51,10 +84,11 @@ export async function startMcpServer() {
     },
     async ({ lat, lng, radius_m, sender_id, channel }) => {
       try {
-        const result = await scan({ lat, lng, radius_m, device_id: deriveDeviceId(sender_id, channel) });
+        const deviceId = deriveDeviceId(sender_id, channel);
+        const result = await scan({ lat, lng, radius_m, device_id: deviceId });
         _lastRefMap = result._ref_map || {};
         const { _ref_map, ...clean } = result;
-        return jsonResult(clean);
+        return jsonResult(await withMatchNotifications(deviceId, clean));
       } catch (e) {
         return jsonResult({ error: e.message });
       }
@@ -83,10 +117,11 @@ export async function startMcpServer() {
       try {
         if (action === "get") {
           const data = await getProfile({ device_id: deviceId });
-          return jsonResult(data ? { profile: data } : { profile: null, message: "还没有名片，帮你创建一个？" });
+          const result = data ? { profile: data } : { profile: null, message: "还没有名片，帮你创建一个？" };
+          return jsonResult(await withMatchNotifications(deviceId, result));
         }
         const data = await setProfile({ device_id: deviceId, display_name, emoji, line1, line2, line3, matching_context, visible });
-        return jsonResult({ saved: true, profile: data });
+        return jsonResult(await withMatchNotifications(deviceId, { saved: true, profile: data }));
       } catch (e) {
         return jsonResult({ error: e.message });
       }
@@ -107,8 +142,9 @@ export async function startMcpServer() {
     },
     async ({ sender_id, channel, ref, target_device_id, contact_info }) => {
       try {
-        const result = await accept({ device_id: deriveDeviceId(sender_id, channel), target_device_id, ref, contact_info });
-        return jsonResult(result);
+        const deviceId = deriveDeviceId(sender_id, channel);
+        const result = await accept({ device_id: deviceId, target_device_id, ref, contact_info });
+        return jsonResult(await withMatchNotifications(deviceId, result));
       } catch (e) {
         return jsonResult({ error: e.message });
       }
@@ -129,11 +165,12 @@ export async function startMcpServer() {
     },
     async ({ lat, lng, sender_id, channel, place_name }) => {
       try {
-        const result = await checkin({ lat, lng, device_id: deriveDeviceId(sender_id, channel) });
+        const deviceId = deriveDeviceId(sender_id, channel);
+        const result = await checkin({ lat, lng, device_id: deviceId });
         if (result.checked_in && place_name) {
           result.message = `已签到 (${place_name}) 📍 现在附近的人扫描就能看到你了。`;
         }
-        return jsonResult(result);
+        return jsonResult(await withMatchNotifications(deviceId, result));
       } catch (e) {
         return jsonResult({ error: e.message });
       }
@@ -151,7 +188,11 @@ export async function startMcpServer() {
     },
     async ({ sender_id, channel }) => {
       try {
-        const result = await checkMatches({ device_id: deriveDeviceId(sender_id, channel) });
+        const deviceId = deriveDeviceId(sender_id, channel);
+        const result = await checkMatches({ device_id: deviceId });
+        // Mark all as notified since user explicitly checked
+        for (const m of (result.mutual_matches || [])) _notifiedMatches.add(`mutual:${m.device_id}`);
+        for (const m of (result.incoming_accepts || [])) _notifiedMatches.add(`incoming:${m.device_id}`);
         return jsonResult(result);
       } catch (e) {
         return jsonResult({ error: e.message });
@@ -163,14 +204,16 @@ export async function startMcpServer() {
 
   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.",
+    "Generate a GPS binding link. Send this to the user so they can share their phone's location via the web. Use purpose='event' + event_code when creating a link for setting an event's location.",
     {
       sender_id: z.string().describe("The sender's user ID"),
       channel: z.string().describe("Channel name"),
+      purpose: z.string().optional().describe("'profile' (default) or 'event'"),
+      event_code: z.string().optional().describe("Event code (required when purpose=event)"),
     },
-    async ({ sender_id, channel }) => {
+    async ({ sender_id, channel, purpose, event_code }) => {
       try {
-        const result = await createBindToken({ device_id: deriveDeviceId(sender_id, channel) });
+        const result = await createBindToken({ device_id: deriveDeviceId(sender_id, channel), purpose, event_code });
         return jsonResult(result);
       } catch (e) {
         return jsonResult({ error: e.message });

package/package.json

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

package/skill/SKILL.md

@@ -112,9 +112,12 @@ Check for mutual matches and contact info updates.
 ### `antenna_bind`
 Generate a GPS binding link. **You MUST call this immediately after saving a profile.** Do not skip this step.
 - `sender_id`, `channel`: from context
+- `purpose`: optional — `'profile'` (default) updates user location; `'event'` sets event location
+- `event_code`: required when `purpose='event'`
 - 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
 - **MANDATORY after profile save. Do not wait for user to ask.**
+- **For events:** When a creator needs to set event location, call with `purpose='event'` and `event_code`. The GPS will update the event's coordinates, NOT the user's profile.
 
 ### `antenna_discover`
 Get today's global recommendation — the person most similar to you worldwide. 1 per day, no repeats.
@@ -282,7 +285,7 @@ Create an event. Returns a shareable link (antenna.fyi/e/CODE).
 - `description`: optional event description
 - `og_image`: optional OG image URL for social sharing preview
 
-**GPS flow for events:** If the user doesn't provide coordinates, generate a bind link (`antenna_bind`) and ask them to open it at the event location. Once GPS comes in, use those coordinates for `lat`/`lng`. Don't use profile location — the user may create an event at a different place.
+**GPS flow for events:** If the user doesn't provide coordinates, generate a bind link (`antenna_bind`) and ask them to open it at the event location. Once GPS comes in, use those coordinates for the event's `lat`/`lng` — do NOT treat this as the user's personal location. The bind link GPS for event creation goes to the event, not the user's profile. Only use `antenna_checkin` when the user wants to update their own location.
 
 ### `antenna_event_end`
 End an event. Only the creator can end it.