antenna-fyi 1.2.2 → 1.2.3

package/bin/antenna.js

@@ -8,7 +8,9 @@ import {
   handleCheckin,
   handleMatches,
   handleDiscover,
+  handleEvent,
   handleBind,
+  handlePass,
   handleSetup,
   handleStatus,
   handleInstallSkill,
@@ -34,8 +36,12 @@ async function main() {
       return handleMatches(f);
     case "discover":
       return handleDiscover(f);
+    case "event":
+      return handleEvent(f);
     case "bind":
       return handleBind(f);
+    case "pass":
+      return handlePass(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 } from "./core.js";
+import { scan, getProfile, setProfile, accept, checkMatches, checkin, createBindToken, discover, createEvent, joinEvent, eventScan, pass as passUser } from "./core.js";
 import { createInterface } from "readline";
 import { existsSync, mkdirSync, copyFileSync } from "fs";
 import { join, dirname } from "path";
@@ -125,6 +125,50 @@ export async function handleDiscover(f) {
   });
 }
 
+export async function handleEvent(f) {
+  const sub = f._?.[0] || Object.keys(f).find(k => ["create", "join", "scan"].includes(k));
+
+  if (f.create || (!f.join && !f.scan && f.name)) {
+    if (!f.name) return console.error("Usage: antenna event --create --name 'AI Meetup'");
+    const result = await createEvent({ name: f.name, device_id: f.id || null, lat: f.lat ? +f.lat : undefined, lng: f.lng ? +f.lng : undefined });
+    console.log(`\n🎉 Event created!\n`);
+    console.log(`  Name: ${result.name}`);
+    console.log(`  Code: ${result.code}`);
+    console.log(`  URL:  ${result.url}`);
+    console.log(`  Ends: ${result.ends_at}\n`);
+    return;
+  }
+
+  if (f.join) {
+    if (!f.code || !f.id) return console.error("Usage: antenna event --join --code abc123 --id telegram:123");
+    const result = await joinEvent({ code: f.code, device_id: f.id });
+    if (result.joined) {
+      console.log(`\n✅ Joined "${result.name}" (${result.code})\n`);
+    } else {
+      console.log(`\n❌ ${result.error}\n`);
+    }
+    return;
+  }
+
+  if (f.scan) {
+    if (!f.code) return console.error("Usage: antenna event --scan --code abc123 [--id telegram:123]");
+    const result = await eventScan({ code: f.code, device_id: f.id || null });
+    if (result.count === 0) return console.log("\n🏟️ No participants yet.\n");
+    console.log(`\n🏟️ ${result.count} people in this event:\n`);
+    result.profiles.forEach((p) => {
+      console.log(`  ${p.emoji} ${p.name}`);
+      if (p.line1) console.log(`    ${p.line1}`);
+      console.log(`    ref: ${p.ref}\n`);
+    });
+    return;
+  }
+
+  console.log(`Usage:
+  antenna event --create --name 'AI Meetup' [--id telegram:123]
+  antenna event --join --code abc123 --id telegram:123
+  antenna event --scan --code abc123 [--id telegram:123]`);
+}
+
 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 });
@@ -134,6 +178,17 @@ export async function handleBind(f) {
   console.log();
 }
 
+export async function handlePass(f) {
+  if (!f.id) return console.error("Usage: antenna pass --id telegram:123 --target telegram:789");
+  if (!f.target && !f.ref) return console.error("Usage: antenna pass --id telegram:123 --target telegram:789 (or --ref 1)");
+  const result = await passUser({
+    device_id: f.id,
+    target_device_id: f.target,
+    ref: f.ref,
+  });
+  console.log("✅ " + (result.message || "Passed."));
+}
+
 export async function handleSetup(f) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
   const ask = (q) => new Promise((resolve) => rl.question(q, resolve));
@@ -303,7 +358,10 @@ Usage:
   antenna checkin    --id telegram:123 --lat 39.99 --lng 116.48
   antenna profile    --id telegram:123 [--name Yi --emoji 🦦 --line1 '...']
   antenna accept     --id telegram:123 --target telegram:789 [--contact 'WeChat: yi']
+  antenna pass       --id telegram:123 --target telegram:789 (or --ref 1)
   antenna matches    --id telegram:123
+  antenna discover   --id telegram:123
+  antenna event      --create --name 'AI Meetup' | --join --code abc123 | --scan --code abc123
   antenna bind       --id telegram:123
   antenna serve      Start MCP server (stdio transport)
   antenna setup      Interactive profile setup [--id telegram:123]

package/lib/hermes-plugin/__init__.py

@@ -13,15 +13,27 @@ from .tools import (
     handle_checkin,
     handle_check_matches,
     handle_bind,
+    handle_pass,
+    handle_discover,
+    handle_event_create,
+    handle_event_join,
+    handle_event_scan,
     _sb,
     _device_id,
     _my_device_ids,
+)
+from .schemas import (
     SCAN_SCHEMA,
     PROFILE_SCHEMA,
     ACCEPT_SCHEMA,
     CHECKIN_SCHEMA,
     CHECK_MATCHES_SCHEMA,
     BIND_SCHEMA,
+    PASS_SCHEMA,
+    DISCOVER_SCHEMA,
+    EVENT_CREATE_SCHEMA,
+    EVENT_JOIN_SCHEMA,
+    EVENT_SCAN_SCHEMA,
 )
 import re
 import time
@@ -44,6 +56,11 @@ def register(ctx):
     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)
+    ctx.register_tool("antenna_pass", PASS_SCHEMA, handle_pass)
+    ctx.register_tool("antenna_discover", DISCOVER_SCHEMA, handle_discover)
+    ctx.register_tool("antenna_event_create", EVENT_CREATE_SCHEMA, handle_event_create)
+    ctx.register_tool("antenna_event_join", EVENT_JOIN_SCHEMA, handle_event_join)
+    ctx.register_tool("antenna_event_scan", EVENT_SCAN_SCHEMA, handle_event_scan)
 
     # ── Hook: auto-detect location + check web GPS events ─────────
     def on_pre_llm(messages, **kwargs):

package/lib/hermes-plugin/schemas.py

@@ -134,3 +134,89 @@ BIND_SCHEMA = {
         "required": ["sender_id", "channel"],
     },
 }
+
+PASS_SCHEMA = {
+    "name": "antenna_pass",
+    "description": "Pass/skip a person. They won't be recommended again.",
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "sender_id": {"type": "string", "description": "The sender's user ID"},
+            "channel": {"type": "string", "description": "Platform name"},
+            "ref": {
+                "type": "string",
+                "description": "Ref number from scan/discover results (e.g. '1')",
+            },
+            "target_device_id": {
+                "type": "string",
+                "description": "Device ID (use ref instead when possible)",
+            },
+        },
+        "required": ["sender_id", "channel"],
+    },
+}
+
+DISCOVER_SCHEMA = {
+    "name": "antenna_discover",
+    "description": (
+        "Get today's global recommendation — the person most similar to you "
+        "worldwide. 1 per day, no repeats."
+    ),
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "sender_id": {"type": "string", "description": "The sender's user ID"},
+            "channel": {"type": "string", "description": "Platform name"},
+        },
+        "required": ["sender_id", "channel"],
+    },
+}
+
+EVENT_CREATE_SCHEMA = {
+    "name": "antenna_event_create",
+    "description": (
+        "Create an event. Returns a shareable link (antenna.fyi/e/CODE) "
+        "for participants to join."
+    ),
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "name": {"type": "string", "description": "Event name"},
+            "sender_id": {"type": "string", "description": "The sender's user ID"},
+            "channel": {"type": "string", "description": "Platform name"},
+            "lat": {"type": "number", "description": "Event latitude"},
+            "lng": {"type": "number", "description": "Event longitude"},
+            "starts_at": {"type": "string", "description": "Start time ISO"},
+            "ends_at": {"type": "string", "description": "End time ISO"},
+        },
+        "required": ["name", "sender_id", "channel"],
+    },
+}
+
+EVENT_JOIN_SCHEMA = {
+    "name": "antenna_event_join",
+    "description": "Join an event by its code from the event URL.",
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "code": {"type": "string", "description": "Event code"},
+            "sender_id": {"type": "string", "description": "The sender's user ID"},
+            "channel": {"type": "string", "description": "Platform name"},
+        },
+        "required": ["code", "sender_id", "channel"],
+    },
+}
+
+EVENT_SCAN_SCHEMA = {
+    "name": "antenna_event_scan",
+    "description": "Scan people in an event. No distance limit.",
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "code": {"type": "string", "description": "Event code"},
+            "sender_id": {"type": "string", "description": "The sender's user ID"},
+            "channel": {"type": "string", "description": "Platform name"},
+        },
+        "required": ["code", "sender_id", "channel"],
+    },
+}

package/lib/hermes-plugin/tools.py

@@ -8,6 +8,7 @@ import json
 import math
 import os
 import time
+import urllib.request
 
 try:
     from supabase import create_client
@@ -277,6 +278,173 @@ def handle_check_matches(params: dict) -> str:
 BASE_URL = "https://www.antenna.fyi"
 
 
+def handle_pass(params: dict) -> str:
+    sb = _sb()
+    did = _device_id(params["sender_id"], params["channel"])
+
+    ref = params.get("ref")
+    target = params.get("target_device_id")
+    if ref and ref in _last_ref_map:
+        target = _last_ref_map[ref]
+    if not target and ref:
+        # Try resolve via RPC
+        try:
+            resp = sb.rpc("resolve_ref", {"p_device_id": did, "p_ref": ref}).execute()
+            if resp.data:
+                target = resp.data.get("target_device_id")
+        except Exception:
+            pass
+    if not target:
+        return _ok({"error": "No target. Use 'ref' from scan/discover results or 'target_device_id'."})
+
+    sb.rpc("pass_user", {
+        "p_device_id": did,
+        "p_target_device_id": target,
+    }).execute()
+
+    return _ok({"passed": True, "message": "已跳过，不会再推荐这个人了。"})
+
+
+def handle_discover(params: dict) -> str:
+    sb = _sb()
+    did = _device_id(params["sender_id"], params["channel"])
+
+    resp = sb.rpc("global_discover", {"p_device_id": did}).execute()
+    results = resp.data or []
+
+    if not results:
+        return _ok({"count": 0, "message": "今天没有新的全球推荐了，明天再来看看。"})
+
+    global _last_ref_map
+    _last_ref_map = {}
+    profiles = []
+
+    # Get my profile for match reason
+    my_prof = sb.rpc("get_profile", {"p_device_id": did}).execute()
+    my_data = my_prof.data or {}
+    my_lines = [my_data.get("line1", ""), my_data.get("line2", ""), my_data.get("line3", "")]
+
+    for i, p in enumerate(results):
+        ref = str(i + 1)
+        _last_ref_map[ref] = p.get("device_id")
+
+        their_lines = [p.get("line1", ""), p.get("line2", ""), p.get("line3", "")]
+
+        # Generate match reason via Edge Function
+        match_reason = None
+        try:
+            req = urllib.request.Request(
+                f"{BUILTIN_URL}/functions/v1/generate-match-reason",
+                data=json.dumps({"my_lines": my_lines, "their_lines": their_lines}).encode(),
+                headers={"Content-Type": "application/json", "Authorization": f"Bearer {BUILTIN_KEY}"},
+            )
+            res = urllib.request.urlopen(req, timeout=10)
+            body = json.loads(res.read().decode())
+            match_reason = body.get("reason")
+        except Exception:
+            pass
+
+        profile = {
+            "ref": ref,
+            "emoji": p.get("emoji") or "\ud83d\udc64",
+            "name": p.get("display_name") or "匿名",
+            "line1": p.get("line1"),
+            "line2": p.get("line2"),
+            "line3": p.get("line3"),
+        }
+        if match_reason:
+            profile["match_reason"] = match_reason
+        profiles.append(profile)
+
+    return _ok({
+        "count": len(profiles),
+        "profiles": profiles,
+        "instruction": "这是全球推荐。根据你对用户的了解，判断是否值得推荐，写一句个性化的匹配理由。使用 ref 编号引用。",
+    })
+
+
+def handle_event_create(params: dict) -> str:
+    sb = _sb()
+    did = _device_id(params["sender_id"], params["channel"])
+
+    rpc_params = {
+        "p_device_id": did,
+        "p_name": params["name"],
+    }
+    if params.get("lat") is not None:
+        rpc_params["p_lat"] = params["lat"]
+    if params.get("lng") is not None:
+        rpc_params["p_lng"] = params["lng"]
+    if params.get("starts_at"):
+        rpc_params["p_starts_at"] = params["starts_at"]
+    if params.get("ends_at"):
+        rpc_params["p_ends_at"] = params["ends_at"]
+
+    resp = sb.rpc("create_event", rpc_params).execute()
+    data = resp.data or {}
+
+    code = data.get("code", "")
+    return _ok({
+        "created": True,
+        "name": params["name"],
+        "code": code,
+        "url": f"{BASE_URL}/e/{code}",
+        "message": f"活动已创建！分享链接给参加的人：{BASE_URL}/e/{code}",
+    })
+
+
+def handle_event_join(params: dict) -> str:
+    sb = _sb()
+    did = _device_id(params["sender_id"], params["channel"])
+
+    resp = sb.rpc("join_event", {
+        "p_device_id": did,
+        "p_code": params["code"],
+    }).execute()
+    data = resp.data or {}
+
+    if data.get("joined"):
+        return _ok({"joined": True, "name": data.get("name", ""), "message": f"已加入活动 \"{data.get('name', '')}\"！"})
+    return _ok({"joined": False, "error": data.get("error", "加入失败")})
+
+
+def handle_event_scan(params: dict) -> str:
+    sb = _sb()
+    did = _device_id(params["sender_id"], params["channel"])
+
+    resp = sb.rpc("event_participants_list", {
+        "p_code": params["code"],
+    }).execute()
+    results = resp.data or []
+
+    others = [p for p in results if p.get("device_id") != did]
+
+    if not others:
+        return _ok({"count": 0, "profiles": [], "message": "活动里还没有其他人。"})
+
+    global _last_ref_map
+    _last_ref_map = {}
+    profiles = []
+    for i, p in enumerate(others):
+        ref = str(i + 1)
+        _last_ref_map[ref] = p.get("device_id")
+        profiles.append({
+            "ref": ref,
+            "emoji": p.get("emoji") or "\ud83d\udc64",
+            "name": p.get("display_name") or "匿名",
+            "line1": p.get("line1"),
+            "line2": p.get("line2"),
+            "line3": p.get("line3"),
+            "source": "event",
+        })
+
+    return _ok({
+        "count": len(profiles),
+        "profiles": profiles,
+        "instruction": "这些是活动参加者。根据你对用户的了解，推荐值得认识的人。使用 ref 编号引用。",
+    })
+
+
 def handle_bind(params: dict) -> str:
     sb = _sb()
     did = _device_id(params["sender_id"], params["channel"])

package/package.json

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

package/skill/SKILL.md

@@ -122,6 +122,20 @@ Get today's global recommendation — the person most similar to you worldwide.
 - If all users have been recommended, returns a message saying "wait for new people"
 - Use this in the daily cron job, or when user asks "find someone interesting globally"
 
+### `antenna_pass`
+Pass/skip a person. They won't be recommended again.
+- `sender_id`, `channel`: from context
+- `ref`: ref number from scan/discover results (e.g. '1')
+- `target_device_id`: device ID (use ref instead when possible)
+- Use when the user says "skip", "pass", "not interested", etc.
+
+### `antenna_checkin`
+Check in at a location — update your position so others can find you when they scan.
+- `lat`, `lng`: coordinates (required)
+- `sender_id`, `channel`: from context
+- `place_name`: optional name of the place
+- Use when the user says "I'm at XX" or wants to be discoverable without scanning others
+
 ## Data Transparency — what Antenna sends
 
 Antenna only communicates with Supabase (bcudjloikmpcqwcptuyd.supabase.co) via HTTPS.