antenna-fyi 1.2.9 → 1.2.11

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";
@@ -63,7 +63,8 @@ export async function handleScan(f) {
 
 export async function handleProfile(f) {
   if (!f.id) return console.error("Usage: antenna profile --id telegram:123 [--name Yi --emoji 🦦 --line1 '...' --line2 '...' --line3 '...']");
-  if (f.name || f.line1 || f.line2 || f.line3) {
+  if (f.name || f.line1 || f.line2 || f.line3 || f.visible !== undefined || f.hide !== undefined) {
+    const visible = f.hide ? false : (f.visible !== undefined ? f.visible === 'true' || f.visible === true : undefined);
     const data = await setProfile({
       device_id: f.id,
       display_name: f.name,
@@ -71,6 +72,7 @@ export async function handleProfile(f) {
       line1: f.line1,
       line2: f.line2,
       line3: f.line3,
+      ...(visible !== undefined && { visible }),
     });
     console.log("✅ Profile saved");
     console.log(JSON.stringify(data, null, 2));
@@ -85,10 +87,11 @@ export async function handleProfile(f) {
 }
 
 export async function handleAccept(f) {
-  if (!f.id || !f.target) return console.error("Usage: antenna accept --id telegram:123 --target telegram:789 [--contact 'WeChat: yi']");
+  if (!f.id || (!f.target && !f.ref)) return console.error("Usage: antenna accept --id telegram:123 --ref 1 [--contact 'WeChat: yi']\n       antenna accept --id telegram:123 --target telegram:789 [--contact 'WeChat: yi']");
   const result = await accept({
     device_id: f.id,
-    target_device_id: f.target,
+    target_device_id: f.target || null,
+    ref: f.ref || null,
     contact_info: f.contact,
   });
   console.log("✅ " + result.message);
@@ -401,6 +404,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 +607,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/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 });

package/package.json

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