antenna-fyi 0.5.2 → 0.6.0

package/README.md

@@ -49,6 +49,38 @@ This starts a stdio-based MCP server with tools:
 - `antenna_accept` — Accept a match
 - `antenna_check_matches` — Check match status
 
+## Hermes Agent Integration
+
+### Option 1: MCP Server (recommended)
+
+Add to `~/.hermes/config.yaml`:
+
+```yaml
+mcp_servers:
+  antenna:
+    command: "antenna"
+    args: ["serve"]
+```
+
+Hermes will auto-discover `mcp_antenna_scan`, `mcp_antenna_profile`, etc.
+
+### Option 2: Plugin (full auto-scan)
+
+```bash
+antenna install-hermes
+cd ~/.hermes/hermes-agent && uv pip install supabase
+```
+
+Restarts Hermes. The plugin registers tools + `pre_llm_call` hook for auto location detection.
+
+### Option 3: Skill only
+
+```bash
+antenna install-skill
+```
+
+Copies SKILL.md to `~/.hermes/skills/antenna/`.
+
 ## OpenClaw Integration
 
 ### Install Skill (recommended)

package/bin/antenna.js

@@ -11,6 +11,7 @@ import {
   handleStatus,
   handleInstallSkill,
   handleInstallPlugin,
+  handleInstallHermesPlugin,
   printHelp,
 } from "../lib/cli.js";
 
@@ -41,6 +42,8 @@ async function main() {
       return handleInstallSkill();
     case "install-plugin":
       return handleInstallPlugin();
+    case "install-hermes":
+      return handleInstallHermesPlugin();
     case "help":
     default:
       return printHelp();

package/lib/cli.js

@@ -162,16 +162,36 @@ export async function handleStatus(f) {
 }
 
 export function handleInstallSkill() {
-  const skillDir = join(homedir(), ".openclaw", "skills", "antenna");
   const skillSrc = join(__dirname, "..", "skill", "SKILL.md");
+  let installed = 0;
 
-  if (!existsSync(skillDir)) {
-    mkdirSync(skillDir, { recursive: true });
+  // OpenClaw
+  const openclawDir = join(homedir(), ".openclaw", "skills", "antenna");
+  if (existsSync(join(homedir(), ".openclaw"))) {
+    if (!existsSync(openclawDir)) mkdirSync(openclawDir, { recursive: true });
+    copyFileSync(skillSrc, join(openclawDir, "SKILL.md"));
+    console.log("✅ SKILL.md installed to ~/.openclaw/skills/antenna/");
+    installed++;
   }
 
-  copyFileSync(skillSrc, join(skillDir, "SKILL.md"));
-  console.log("✅ SKILL.md installed to ~/.openclaw/skills/antenna/");
-  console.log("   Restart OpenClaw to pick it up.");
+  // Hermes
+  const hermesDir = join(homedir(), ".hermes", "skills", "antenna");
+  if (existsSync(join(homedir(), ".hermes"))) {
+    if (!existsSync(hermesDir)) mkdirSync(hermesDir, { recursive: true });
+    copyFileSync(skillSrc, join(hermesDir, "SKILL.md"));
+    console.log("✅ SKILL.md installed to ~/.hermes/skills/antenna/");
+    installed++;
+  }
+
+  if (installed === 0) {
+    // Neither found, default to OpenClaw path
+    if (!existsSync(openclawDir)) mkdirSync(openclawDir, { recursive: true });
+    copyFileSync(skillSrc, join(openclawDir, "SKILL.md"));
+    console.log("✅ SKILL.md installed to ~/.openclaw/skills/antenna/");
+    console.log("   (Neither ~/.openclaw nor ~/.hermes detected — defaulted to OpenClaw)");
+  }
+
+  console.log("   Restart your agent to pick it up.");
 }
 
 export function handleInstallPlugin() {
@@ -189,13 +209,42 @@ export function handleInstallPlugin() {
     }
   }
 
-  console.log("\n✅ Plugin template files copied to current directory.");
+  console.log("\n✅ OpenClaw Plugin template copied to current directory.");
   console.log("   Next steps:");
   console.log("   1. Run: npm install");
   console.log("   2. Run: openclaw plugins install .");
   console.log();
 }
 
+export function handleInstallHermesPlugin() {
+  const templateDir = join(__dirname, "hermes-plugin");
+  const targetDir = join(homedir(), ".hermes", "plugins", "antenna");
+  const files = ["plugin.yaml", "__init__.py", "schemas.py", "tools.py"];
+
+  if (!existsSync(join(homedir(), ".hermes"))) {
+    console.error("❌ ~/.hermes not found. Is Hermes Agent installed?");
+    console.error("   Install: curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash");
+    return;
+  }
+
+  if (!existsSync(targetDir)) mkdirSync(targetDir, { recursive: true });
+
+  for (const file of files) {
+    const src = join(templateDir, file);
+    const dest = join(targetDir, file);
+    if (existsSync(src)) {
+      copyFileSync(src, dest);
+      console.log(`📄 ${file}`);
+    }
+  }
+
+  console.log("\n✅ Hermes Plugin installed to ~/.hermes/plugins/antenna/");
+  console.log("   Note: requires supabase-py. Run:");
+  console.log("   cd ~/.hermes/hermes-agent && uv pip install supabase");
+  console.log("   Then restart Hermes.");
+  console.log();
+}
+
 export function printHelp() {
   console.log(`📡 Antenna — nearby people discovery
 
@@ -208,8 +257,9 @@ Usage:
   antenna serve      Start MCP server (stdio transport)
   antenna setup      Interactive profile setup [--id telegram:123]
   antenna status     Show config & status [--id telegram:123]
-  antenna install-skill    Install SKILL.md to ~/.openclaw/skills/antenna/
-  antenna install-plugin   Copy plugin template to current directory
+  antenna install-skill    Install SKILL.md (detects OpenClaw + Hermes)
+  antenna install-plugin   Copy OpenClaw plugin template to cwd
+  antenna install-hermes   Install Hermes plugin to ~/.hermes/plugins/antenna/
   antenna help       Show this help
 
 Environment:

package/lib/hermes-plugin/__init__.py

@@ -0,0 +1,69 @@
+"""Antenna — Hermes Agent Plugin
+
+Nearby people discovery. Registers 5 tools and a pre_llm_call hook
+that auto-detects location data and prompts the agent to scan.
+
+Drop this directory into ~/.hermes/plugins/antenna/
+"""
+
+from .tools import (
+    handle_scan,
+    handle_profile,
+    handle_accept,
+    handle_checkin,
+    handle_check_matches,
+    SCAN_SCHEMA,
+    PROFILE_SCHEMA,
+    ACCEPT_SCHEMA,
+    CHECKIN_SCHEMA,
+    CHECK_MATCHES_SCHEMA,
+)
+import re
+
+
+def register(ctx):
+    # ── Tools ─────────────────────────────────────────────────────
+    ctx.register_tool("antenna_scan", SCAN_SCHEMA, handle_scan)
+    ctx.register_tool("antenna_profile", PROFILE_SCHEMA, handle_profile)
+    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)
+
+    # ── Hook: auto-detect location in messages ────────────────────
+    def on_pre_llm(messages, **kwargs):
+        """Check last user message for location data and inject scan hint."""
+        if not messages:
+            return None
+
+        last_msg = messages[-1] if isinstance(messages[-1], dict) else {}
+        content = last_msg.get("content", "")
+        if not isinstance(content, str):
+            return None
+
+        # Pattern 1: Hermes gateway may serialize location as text
+        # e.g. "📍 Location shared: 39.9908, 116.4872"
+        loc_match = re.search(
+            r"[Ll]ocation.*?(-?\d+\.?\d*)[,\s]+(-?\d+\.?\d*)", content
+        )
+
+        # Pattern 2: raw coordinates in message
+        if not loc_match:
+            loc_match = re.search(
+                r"(-?\d{1,3}\.\d{3,})[,\s]+(-?\d{1,3}\.\d{3,})", content
+            )
+
+        if loc_match:
+            lat, lng = loc_match.group(1), loc_match.group(2)
+            return {
+                "context": (
+                    f"\n\n[Antenna] 📍 检测到位置 ({lat}, {lng})。"
+                    f"请使用 antenna_scan 工具查看附近有谁。"
+                    f"参数：lat={lat}, lng={lng}，sender_id 和 channel 从消息上下文获取。"
+                )
+            }
+
+        return None
+
+    ctx.register_hook("pre_llm_call", on_pre_llm)
+
+    print("[Antenna] Plugin loaded 📡")

package/lib/hermes-plugin/plugin.yaml

@@ -0,0 +1,7 @@
+name: antenna
+version: "0.5.2"
+description: |
+  Nearby people discovery — scan for people around you, set up your profile card,
+  accept matches, and check match status. Uses Supabase as shared backend.
+  Triggers automatically when location data is detected.
+requires_env: []

package/lib/hermes-plugin/schemas.py

@@ -0,0 +1,117 @@
+"""Antenna tool schemas — what the LLM sees."""
+
+SCAN_SCHEMA = {
+    "name": "antenna_scan",
+    "description": (
+        "Scan for nearby people at a given location. Returns raw profile cards "
+        "of nearby people — the agent should read these cards and decide who to "
+        "recommend based on its understanding of the user."
+    ),
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "lat": {"type": "number", "description": "Latitude"},
+            "lng": {"type": "number", "description": "Longitude"},
+            "radius_m": {
+                "type": "number",
+                "description": "Search radius in meters (default: 500)",
+            },
+            "sender_id": {
+                "type": "string",
+                "description": "The sender's user ID (from message context)",
+            },
+            "channel": {
+                "type": "string",
+                "description": "Platform name (telegram, discord, etc.)",
+            },
+        },
+        "required": ["lat", "lng", "sender_id", "channel"],
+    },
+}
+
+PROFILE_SCHEMA = {
+    "name": "antenna_profile",
+    "description": (
+        "View or update the user's Antenna profile (name card). "
+        "The profile has a display name, emoji, and three lines."
+    ),
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "action": {
+                "type": "string",
+                "enum": ["get", "set"],
+                "description": "'get' to view, 'set' to update",
+            },
+            "sender_id": {"type": "string"},
+            "channel": {"type": "string"},
+            "display_name": {"type": "string", "description": "Display name"},
+            "emoji": {"type": "string", "description": "Profile emoji"},
+            "line1": {"type": "string", "description": "Who you are / what you do"},
+            "line2": {"type": "string", "description": "What you're into"},
+            "line3": {"type": "string", "description": "What you're looking for"},
+            "visible": {"type": "boolean", "description": "Visible to others"},
+        },
+        "required": ["action", "sender_id", "channel"],
+    },
+}
+
+ACCEPT_SCHEMA = {
+    "name": "antenna_accept",
+    "description": (
+        "Accept a match. Optionally share contact info. "
+        "If both sides accept, they can exchange contact info."
+    ),
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "sender_id": {"type": "string"},
+            "channel": {"type": "string"},
+            "target_device_id": {
+                "type": "string",
+                "description": "Device ID of the person to accept",
+            },
+            "contact_info": {
+                "type": "string",
+                "description": "Contact info to share (e.g. 'WeChat: yi')",
+            },
+        },
+        "required": ["sender_id", "channel", "target_device_id"],
+    },
+}
+
+CHECKIN_SCHEMA = {
+    "name": "antenna_checkin",
+    "description": (
+        "Check in at a location — update your position so others can find you."
+    ),
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "lat": {"type": "number", "description": "Latitude"},
+            "lng": {"type": "number", "description": "Longitude"},
+            "sender_id": {"type": "string"},
+            "channel": {"type": "string"},
+            "place_name": {
+                "type": "string",
+                "description": "Name of the place (optional)",
+            },
+        },
+        "required": ["lat", "lng", "sender_id", "channel"],
+    },
+}
+
+CHECK_MATCHES_SCHEMA = {
+    "name": "antenna_check_matches",
+    "description": (
+        "Check for mutual matches and incoming accepts."
+    ),
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "sender_id": {"type": "string"},
+            "channel": {"type": "string"},
+        },
+        "required": ["sender_id", "channel"],
+    },
+}

package/lib/hermes-plugin/tools.py

@@ -0,0 +1,244 @@
+"""Antenna tool handlers — what runs when called.
+
+Uses the Supabase REST API via supabase-py. Falls back to the built-in
+shared backend if no env vars are set.
+"""
+
+import json
+import math
+import os
+import time
+
+try:
+    from supabase import create_client
+except ImportError:
+    create_client = None  # Will fail at runtime with helpful message
+
+# ─── Config ───────────────────────────────────────────────────────────
+
+BUILTIN_URL = "https://bcudjloikmpcqwcptuyd.supabase.co"
+BUILTIN_KEY = (
+    "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9."
+    "eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImJjdWRqbG9pa21wY3F3Y3B0dXlkIiwi"
+    "cm9sZSI6ImFub24iLCJpYXQiOjE3NzQ0MTg1NDgsImV4cCI6MjA4OTk5NDU0OH0."
+    "FaoC3QfpfHP1npNGjRchJAoAp2PdZtQe_WhP-t-GN1o"
+)
+
+_client = None
+_client_url = None
+_last_scan: dict[str, float] = {}
+SCAN_DEBOUNCE_S = 30
+
+
+def _get_url():
+    return os.environ.get("ANTENNA_SUPABASE_URL") or os.environ.get("ANTENNA_URL") or BUILTIN_URL
+
+
+def _get_key():
+    return os.environ.get("ANTENNA_SUPABASE_KEY") or os.environ.get("ANTENNA_KEY") or BUILTIN_KEY
+
+
+def _sb():
+    global _client, _client_url
+    if create_client is None:
+        raise RuntimeError(
+            "supabase-py not installed. Run: pip install supabase"
+        )
+    url = _get_url()
+    if _client is None or _client_url != url:
+        _client = create_client(url, _get_key())
+        _client_url = url
+    return _client
+
+
+def _device_id(sender_id: str, channel: str) -> str:
+    return f"{channel}:{sender_id}"
+
+
+def _fuzzy(lat: float, lng: float) -> tuple[float, float]:
+    return round(lat * 1000) / 1000, round(lng * 1000) / 1000
+
+
+def _ok(data) -> str:
+    return json.dumps(data, ensure_ascii=False)
+
+
+# ─── Handlers ─────────────────────────────────────────────────────────
+
+def handle_scan(params: dict) -> str:
+    sb = _sb()
+    did = _device_id(params["sender_id"], params["channel"])
+    radius = params.get("radius_m", 500)
+
+    # Rate limit
+    now = time.time()
+    if did in _last_scan and now - _last_scan[did] < SCAN_DEBOUNCE_S:
+        return _ok({"nearby": [], "message": "刚刚才扫描过，稍等一会儿再试。", "rate_limited": True})
+    _last_scan[did] = now
+
+    flat, flng = _fuzzy(params["lat"], params["lng"])
+
+    # Update own location
+    sb.rpc("upsert_profile_location", {
+        "p_device_id": did, "p_lng": flng, "p_lat": flat,
+    }).execute()
+
+    # Query nearby
+    resp = sb.rpc("nearby_profiles", {
+        "p_lat": flat, "p_lng": flng, "p_radius_m": radius,
+    }).execute()
+
+    others = [p for p in (resp.data or []) if p.get("device_id") != did]
+
+    if not others:
+        return _ok({"nearby": [], "message": f"在 {radius}m 范围内没有发现其他人。"})
+
+    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
+        ],
+        "total": len(others),
+        "radius_m": radius,
+        "instruction": "根据你对用户的了解，判断哪些人值得推荐，为每个推荐写一句个性化的匹配理由。",
+    })
+
+
+def handle_profile(params: dict) -> str:
+    sb = _sb()
+    did = _device_id(params["sender_id"], params["channel"])
+
+    if params["action"] == "get":
+        resp = sb.rpc("get_profile", {"p_device_id": did}).execute()
+        if not resp.data:
+            return _ok({"exists": False, "message": "你还没有名片。告诉我你的名字、emoji、三句话，我帮你创建。"})
+        return _ok({"exists": True, "profile": resp.data})
+
+    # set
+    resp = sb.rpc("upsert_profile", {
+        "p_device_id": did,
+        "p_display_name": params.get("display_name"),
+        "p_emoji": params.get("emoji"),
+        "p_line1": params.get("line1"),
+        "p_line2": params.get("line2"),
+        "p_line3": params.get("line3"),
+        "p_visible": params.get("visible", True),
+    }).execute()
+
+    if resp.data:
+        return _ok({"updated": True, "profile": resp.data})
+    return _ok({"error": "upsert_profile failed"})
+
+
+def handle_accept(params: dict) -> str:
+    sb = _sb()
+    did = _device_id(params["sender_id"], params["channel"])
+    target = params["target_device_id"]
+
+    sb.rpc("upsert_match", {
+        "p_device_id_a": did,
+        "p_device_id_b": target,
+        "p_status": "accepted",
+        "p_contact_info": params.get("contact_info"),
+    }).execute()
+
+    # Check mutual
+    resp = sb.rpc("get_my_matches", {"p_device_id": did}).execute()
+    matches = resp.data or []
+    reverse = next(
+        (m for m in matches if m.get("device_id_a") == target and m.get("device_id_b") == did),
+        None,
+    )
+
+    if reverse:
+        contact = reverse.get("contact_info_a")
+        msg = f"双方都接受了！对方分享的联系方式：{contact}" if contact else "双方都接受了！但对方还没有分享联系方式。"
+        return _ok({"accepted": True, "mutual": True, "their_contact": contact, "message": msg})
+
+    return _ok({
+        "accepted": True,
+        "mutual": False,
+        "message": "已接受。等对方也接受后，你们就可以交换联系方式了。",
+    })
+
+
+def handle_checkin(params: dict) -> str:
+    sb = _sb()
+    did = _device_id(params["sender_id"], params["channel"])
+    flat, flng = _fuzzy(params["lat"], params["lng"])
+
+    # Check profile exists
+    prof = sb.rpc("get_profile", {"p_device_id": did}).execute()
+    if not prof.data:
+        return _ok({"checked_in": False, "message": "你还没有名片，先创建一个吧。"})
+
+    sb.rpc("upsert_profile_location", {
+        "p_device_id": did, "p_lng": flng, "p_lat": flat,
+    }).execute()
+
+    place = f" ({params['place_name']})" if params.get("place_name") else ""
+    return _ok({"checked_in": True, "message": f"已签到{place} 📍 现在附近的人扫描就能看到你了。"})
+
+
+def handle_check_matches(params: dict) -> str:
+    sb = _sb()
+    did = _device_id(params["sender_id"], params["channel"])
+
+    resp = sb.rpc("get_my_matches", {"p_device_id": did}).execute()
+    all_matches = resp.data or []
+
+    if not all_matches:
+        return _ok({"mutual_matches": [], "incoming_accepts": [], "message": "目前没有进行中的匹配。"})
+
+    my = [m for m in all_matches if m.get("device_id_a") == did]
+    incoming = [m for m in all_matches if m.get("device_id_b") == did]
+
+    # Mutual
+    mutual = []
+    for m in my:
+        rev = next((i for i in incoming if i.get("device_id_a") == m.get("device_id_b")), None)
+        if rev:
+            prof = sb.rpc("get_profile", {"p_device_id": m["device_id_b"]}).execute()
+            p = prof.data or {}
+            mutual.append({
+                "device_id": m["device_id_b"],
+                "name": p.get("display_name") or "匿名",
+                "emoji": p.get("emoji") or "👤",
+                "their_contact": rev.get("contact_info_a"),
+                "you_shared": m.get("contact_info_a"),
+            })
+
+    # Incoming only
+    inc_only = []
+    for m in incoming:
+        already = next((x for x in my if x.get("device_id_b") == m.get("device_id_a")), None)
+        if not already:
+            prof = sb.rpc("get_profile", {"p_device_id": m["device_id_a"]}).execute()
+            p = prof.data or {}
+            inc_only.append({
+                "device_id": m["device_id_a"],
+                "name": p.get("display_name") or "匿名",
+                "emoji": p.get("emoji") or "👤",
+                "line1": p.get("line1"),
+            })
+
+    msgs = []
+    if mutual:
+        msgs.append(f"{len(mutual)} 个双向匹配！可以交换联系方式了")
+    if inc_only:
+        msgs.append(f"{len(inc_only)} 个人想认识你，等你回应")
+    if not msgs:
+        msgs.append("你接受了一些匹配，但对方还没有回应。耐心等等 ⏳")
+
+    return _ok({
+        "mutual_matches": mutual,
+        "incoming_accepts": inc_only,
+        "message": "；".join(msgs),
+    })

package/package.json

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