antenna-fyi 0.9.2 → 0.10.1

package/lib/cli.js

@@ -24,7 +24,7 @@ export function parseFlags(args) {
 }
 
 export async function handleScan(f) {
-  if (!f.lat || !f.lng) return console.error("Usage: antenna scan --lat 39.99 --lng 116.48 [--radius 500] [--id telegram:123]");
+  if (!f.lat || !f.lng) return console.error("Usage: antenna scan --lat 39.99 --lng 116.48 [--radius 500] (max 1000) [--id telegram:123]");
   const result = await scan({
     lat: +f.lat,
     lng: +f.lng,
@@ -280,7 +280,7 @@ export function printHelp() {
   console.log(`📡 Antenna — nearby people discovery
 
 Usage:
-  antenna scan       --lat 39.99 --lng 116.48 [--radius 500] [--id telegram:123]
+  antenna scan       --lat 39.99 --lng 116.48 [--radius 500] (max 1000) [--id telegram:123]
   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']

package/lib/core.js

@@ -35,6 +35,7 @@ export function fuzzyCoord(lat, lng) {
 
 export async function scan({ lat, lng, radius_m = 500, device_id, supabaseUrl, supabaseKey }) {
   const sb = getClient(supabaseUrl, supabaseKey);
+  radius_m = Math.min(radius_m, 1000); // server caps at 1km too
 
   // If no lat/lng provided, read from profile (web GPS bind scenario)
   if ((lat == null || lng == null) && device_id) {
@@ -69,18 +70,27 @@ export async function scan({ lat, lng, radius_m = 500, device_id, supabaseUrl, s
     ? (data || []).filter((p) => p.device_id !== device_id)
     : data || [];
 
-  return {
-    count: others.length,
-    radius_m,
-    profiles: others.map((p) => ({
-      device_id: p.device_id,
+  // Build ref mapping (1-indexed) so device_id is never exposed to the agent/user
+  const _refMap = {};
+  const profiles = others.map((p, i) => {
+    const ref = String(i + 1);
+    _refMap[ref] = p.device_id;
+    return {
+      ref,
       name: p.display_name || "匿名",
       emoji: p.emoji || "👤",
       line1: p.line1,
       line2: p.line2,
       line3: p.line3,
       distance_m: p.distance_m ?? p.dist_meters ?? null,
-    })),
+    };
+  });
+
+  return {
+    count: others.length,
+    radius_m,
+    profiles,
+    _ref_map: _refMap,
   };
 }
 

package/lib/hermes-plugin/schemas.py

@@ -13,7 +13,7 @@ SCAN_SCHEMA = {
             "lng": {"type": "number", "description": "Longitude (optional if location was shared via web)"},
             "radius_m": {
                 "type": "number",
-                "description": "Search radius in meters (default: 500)",
+                "description": "Search radius in meters (default 500, max 1000)",
             },
             "sender_id": {
                 "type": "string",
@@ -58,24 +58,28 @@ PROFILE_SCHEMA = {
 ACCEPT_SCHEMA = {
     "name": "antenna_accept",
     "description": (
-        "Accept a match. Optionally share contact info. "
-        "If both sides accept, they can exchange contact info."
+        "Accept a match. Use 'ref' from scan results (e.g. '1', '2') or target_device_id. "
+        "Optionally share contact info."
     ),
     "parameters": {
         "type": "object",
         "properties": {
             "sender_id": {"type": "string"},
             "channel": {"type": "string"},
+            "ref": {
+                "type": "string",
+                "description": "Ref number from scan results (e.g. '1')",
+            },
             "target_device_id": {
                 "type": "string",
-                "description": "Device ID of the person to accept",
+                "description": "Device ID (use ref instead when possible)",
             },
             "contact_info": {
                 "type": "string",
                 "description": "Contact info to share (e.g. 'WeChat: yi')",
             },
         },
-        "required": ["sender_id", "channel", "target_device_id"],
+        "required": ["sender_id", "channel"],
     },
 }
 

package/lib/hermes-plugin/tools.py

@@ -28,6 +28,7 @@ _client = None
 _client_url = None
 _last_scan: dict[str, float] = {}
 SCAN_DEBOUNCE_S = 30
+_last_ref_map: dict[str, str] = {}  # ref → device_id from last scan
 
 
 def _get_url():
@@ -106,21 +107,27 @@ def handle_scan(params: dict) -> str:
     if not others:
         return _ok({"nearby": [], "message": f"在 {radius}m 范围内没有发现其他人。"})
 
+    # Build ref mapping — never expose device_id to agent/user
+    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 "👤",
+            "name": p.get("display_name") or "匿名",
+            "line1": p.get("line1"),
+            "line2": p.get("line2"),
+            "line3": p.get("line3"),
+        })
+
     return _ok({
-        "nearby": [
-            {
-                "device_id": p.get("device_id"),
-                "emoji": p.get("emoji") or "👤",
-                "name": p.get("display_name") or "匿名",
-                "line1": p.get("line1"),
-                "line2": p.get("line2"),
-                "line3": p.get("line3"),
-            }
-            for p in others
-        ],
+        "nearby": profiles,
         "total": len(others),
         "radius_m": radius,
-        "instruction": "根据你对用户的了解，判断哪些人值得推荐，为每个推荐写一句个性化的匹配理由。",
+        "instruction": "根据你对用户的了解，判断哪些人值得推荐，为每个推荐写一句个性化的匹配理由。使用 ref 编号（如 '1', '2')来引用人员，不要显示 device_id。",
     })
 
 
@@ -153,7 +160,14 @@ def handle_profile(params: dict) -> str:
 def handle_accept(params: dict) -> str:
     sb = _sb()
     did = _device_id(params["sender_id"], params["channel"])
-    target = params["target_device_id"]
+
+    # Resolve ref to device_id
+    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:
+        return _ok({"error": "No target. Use 'ref' from scan results or 'target_device_id'."})
 
     sb.rpc("upsert_match", {
         "p_device_id_a": did,

package/lib/mcp.js

@@ -17,7 +17,7 @@ import {
 export async function startMcpServer() {
   const server = new McpServer({
     name: "Antenna",
-    version: "0.5.0",
+    version: "0.9.2",
     description:
       "Nearby people discovery — scan for people around you, set up your profile card, accept matches, and check match status.",
   });
@@ -26,22 +26,27 @@ export async function startMcpServer() {
     return { content: [{ type: "text", text: JSON.stringify(obj) }] };
   }
 
+  // Store last scan ref map for resolving refs in accept
+  let _lastRefMap = {};
+
   // ─── antenna_scan ──────────────────────────────────────────────────
 
   server.tool(
     "antenna_scan",
-    "Scan for nearby people. If lat/lng are omitted, uses the location from the user's web GPS binding.",
+    "Scan for nearby people. Returns profiles with 'ref' numbers (1, 2, 3...) for privacy. Use these ref numbers when calling antenna_accept.",
     {
       lat: z.number().optional().describe("Latitude (optional if location was shared via web)"),
       lng: z.number().optional().describe("Longitude (optional if location was shared via web)"),
-      radius_m: z.number().optional().default(500).describe("Search radius in meters"),
+      radius_m: z.number().optional().default(500).describe("Search radius in meters (default 500, max 1000)"),
       sender_id: z.string().describe("The sender's user ID"),
-      channel: z.string().describe("Channel name (telegram, whatsapp, discord, etc.)"),
+      channel: z.string().describe("Channel name"),
     },
     async ({ lat, lng, radius_m, sender_id, channel }) => {
       try {
         const result = await scan({ lat, lng, radius_m, device_id: deriveDeviceId(sender_id, channel) });
-        return jsonResult(result);
+        _lastRefMap = result._ref_map || {};
+        const { _ref_map, ...clean } = result;
+        return jsonResult(clean);
       } catch (e) {
         return jsonResult({ error: e.message });
       }
@@ -83,16 +88,24 @@ export async function startMcpServer() {
 
   server.tool(
     "antenna_accept",
-    "Accept a match with another person.",
+    "Accept a match. Use 'ref' from scan results (e.g. '1', '2') OR target_device_id directly.",
     {
       sender_id: z.string().describe("The sender's user ID"),
       channel: z.string().describe("Channel name"),
-      target_device_id: z.string().describe("Device ID of the person to accept"),
+      ref: z.string().optional().describe("Ref number from scan results (e.g. '1')"),
+      target_device_id: z.string().optional().describe("Device ID (use ref instead when possible)"),
       contact_info: z.string().optional().describe("Contact info to share"),
     },
-    async ({ sender_id, channel, target_device_id, contact_info }) => {
+    async ({ sender_id, channel, ref, target_device_id, contact_info }) => {
       try {
-        const result = await accept({ device_id: deriveDeviceId(sender_id, channel), target_device_id, contact_info });
+        let targetId = target_device_id;
+        if (ref && _lastRefMap[ref]) {
+          targetId = _lastRefMap[ref];
+        }
+        if (!targetId) {
+          return jsonResult({ error: "No target specified. Use 'ref' from scan results or 'target_device_id'." });
+        }
+        const result = await accept({ device_id: deriveDeviceId(sender_id, channel), target_device_id: targetId, contact_info });
         return jsonResult(result);
       } catch (e) {
         return jsonResult({ error: e.message });
@@ -144,7 +157,7 @@ export async function startMcpServer() {
     }
   );
 
-  // ─── antenna_bind ────────────────────────────────────────────
+  // ─── antenna_bind ──────────────────────────────────────────────────
 
   server.tool(
     "antenna_bind",

package/package.json

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

package/skill/SKILL.md

@@ -46,7 +46,7 @@ Plugin 安装后，agent 应该**主动**开始引导，不要等用户问"怎
 ### `antenna_scan`
 Scan for nearby people. Returns **raw profile cards** — no scores, no pre-matching. **You are the matching engine.**
 - `lat`, `lng`: coordinates (from `LocationLat`/`LocationLon` context, or geocoded from user input)
-- `radius_m`: search radius (default 500m)
+- `radius_m`: search radius in meters (default 500, max 1000)
 - `sender_id`: the user's id from message context
 - `channel`: the channel name (telegram, whatsapp, discord, etc.)