antenna-fyi 0.6.1 → 0.8.0

package/bin/antenna.js

@@ -7,6 +7,7 @@ import {
   handleAccept,
   handleCheckin,
   handleMatches,
+  handleBind,
   handleSetup,
   handleStatus,
   handleInstallSkill,
@@ -30,6 +31,8 @@ async function main() {
       return handleCheckin(f);
     case "matches":
       return handleMatches(f);
+    case "bind":
+      return handleBind(f);
     case "serve": {
       const { startMcpServer } = await import("../lib/mcp.js");
       return startMcpServer();

package/install.js

@@ -1,19 +1,78 @@
-// postinstall — welcome banner
-
-console.log(`
-╔══════════════════════════════════════════════════╗
-║  📡  Antenna — Nearby People Discovery           ║
-╠══════════════════════════════════════════════════╣
-║                                                  ║
-║  Quick start:                                    ║
-║    antenna setup              Create your card   ║
-║    antenna scan --lat … --lng …   Find people    ║
-║    antenna serve              Start MCP server   ║
-║                                                  ║
-║  OpenClaw integration:                           ║
-║    antenna install-skill      Install SKILL.md   ║
-║    antenna install-plugin     Get plugin files   ║
-║                                                  ║
-║  antenna help                 Full usage info    ║
-╚══════════════════════════════════════════════════╝
-`);
+// postinstall — auto-detect agent platforms and install
+
+import { existsSync, mkdirSync, copyFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { homedir } from "os";
+import { execSync } from "child_process";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const home = homedir();
+let installed = [];
+
+console.log("\n📡 Antenna — Nearby People Discovery\n");
+
+// ── Hermes ────────────────────────────────────────────────────────
+const hermesHome = join(home, ".hermes");
+if (existsSync(hermesHome)) {
+  try {
+    // Plugin
+    const pluginDir = join(hermesHome, "plugins", "antenna");
+    const templateDir = join(__dirname, "lib", "hermes-plugin");
+    if (!existsSync(pluginDir)) mkdirSync(pluginDir, { recursive: true });
+    for (const f of ["plugin.yaml", "__init__.py", "schemas.py", "tools.py"]) {
+      const src = join(templateDir, f);
+      if (existsSync(src)) copyFileSync(src, join(pluginDir, f));
+    }
+
+    // Skill
+    const skillDir = join(hermesHome, "skills", "antenna");
+    if (!existsSync(skillDir)) mkdirSync(skillDir, { recursive: true });
+    copyFileSync(join(__dirname, "skill", "SKILL.md"), join(skillDir, "SKILL.md"));
+
+    // Deps
+    const hermesAgent = join(hermesHome, "hermes-agent");
+    if (existsSync(hermesAgent)) {
+      try {
+        execSync("uv pip install supabase", { cwd: hermesAgent, stdio: "ignore", timeout: 60_000 });
+      } catch {
+        try {
+          execSync("pip install supabase", { stdio: "ignore", timeout: 60_000 });
+        } catch { /* user can install manually */ }
+      }
+    }
+
+    installed.push("Hermes (Plugin + Skill + deps)");
+  } catch (e) {
+    console.log(`  ⚠️  Hermes detected but setup failed: ${e.message}`);
+  }
+}
+
+// ── OpenClaw ──────────────────────────────────────────────────────
+const openclawHome = join(home, ".openclaw");
+if (existsSync(openclawHome)) {
+  try {
+    const skillDir = join(openclawHome, "skills", "antenna");
+    if (!existsSync(skillDir)) mkdirSync(skillDir, { recursive: true });
+    copyFileSync(join(__dirname, "skill", "SKILL.md"), join(skillDir, "SKILL.md"));
+    installed.push("OpenClaw (Skill)");
+  } catch (e) {
+    console.log(`  ⚠️  OpenClaw detected but setup failed: ${e.message}`);
+  }
+}
+
+// ── Result ────────────────────────────────────────────────────────
+if (installed.length > 0) {
+  console.log("  ✅ Auto-configured for: " + installed.join(", "));
+  console.log("     Restart your agent to activate.\n");
+} else {
+  console.log("  No agent platform detected (~/.hermes or ~/.openclaw).");
+  console.log("  You can still use the CLI: antenna help\n");
+}
+
+console.log("  Quick start:");
+console.log("    antenna setup              Create your card");
+console.log("    antenna scan --lat … --lng …   Find people");
+console.log("    antenna serve              Start MCP server");
+console.log("    antenna help               Full usage\n");

package/lib/cli.js

@@ -1,6 +1,6 @@
 // antenna CLI command handlers
 
-import { scan, getProfile, setProfile, accept, checkMatches, checkin } from "./core.js";
+import { scan, getProfile, setProfile, accept, checkMatches, checkin, createBindToken } from "./core.js";
 import { createInterface } from "readline";
 import { existsSync, mkdirSync, copyFileSync } from "fs";
 import { join, dirname } from "path";
@@ -106,6 +106,15 @@ export async function handleMatches(f) {
   }
 }
 
+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 });
+  console.log("\n🔗 GPS Binding Link:\n");
+  console.log(`  ${result.url}\n`);
+  console.log("Send this to the user. Opening it on their phone will share GPS with their agent.");
+  console.log();
+}
+
 export async function handleSetup(f) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
   const ask = (q) => new Promise((resolve) => rl.question(q, resolve));
@@ -276,6 +285,7 @@ Usage:
   antenna profile    --id telegram:123 [--name Yi --emoji 🦦 --line1 '...']
   antenna accept     --id telegram:123 --target telegram:789 [--contact 'WeChat: yi']
   antenna matches    --id telegram:123
+  antenna bind       --id telegram:123
   antenna serve      Start MCP server (stdio transport)
   antenna setup      Interactive profile setup [--id telegram:123]
   antenna status     Show config & status [--id telegram:123]

package/lib/core.js

@@ -245,3 +245,17 @@ export async function checkMatches({ device_id, supabaseUrl, supabaseKey }) {
     message: messages.join("；"),
   };
 }
+
+// ─── createBindToken ─────────────────────────────────────────────
+
+export async function createBindToken({ device_id, supabaseUrl, supabaseKey }) {
+  const sb = getClient(supabaseUrl, supabaseKey);
+  const { data, error } = await sb.rpc("create_bind_token", { p_device_id: device_id });
+  if (error) throw new Error(error.message);
+  const baseUrl = "https://www.antenna.fyi";
+  return {
+    token: data.token,
+    url: `${baseUrl}/locate?token=${data.token}`,
+    message: "发送这个链接给用户，在手机浏览器打开即可共享位置。",
+  };
+}

package/lib/hermes-plugin/__init__.py

@@ -12,11 +12,13 @@ from .tools import (
     handle_accept,
     handle_checkin,
     handle_check_matches,
+    handle_bind,
     SCAN_SCHEMA,
     PROFILE_SCHEMA,
     ACCEPT_SCHEMA,
     CHECKIN_SCHEMA,
     CHECK_MATCHES_SCHEMA,
+    BIND_SCHEMA,
 )
 import re
 
@@ -28,6 +30,7 @@ def register(ctx):
     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)
+    ctx.register_tool("antenna_bind", BIND_SCHEMA, handle_bind)
 
     # ── Hook: auto-detect location in messages ────────────────────
     def on_pre_llm(messages, **kwargs):

package/lib/hermes-plugin/schemas.py

@@ -115,3 +115,19 @@ CHECK_MATCHES_SCHEMA = {
         "required": ["sender_id", "channel"],
     },
 }
+
+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."
+    ),
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "sender_id": {"type": "string"},
+            "channel": {"type": "string"},
+        },
+        "required": ["sender_id", "channel"],
+    },
+}

package/lib/hermes-plugin/tools.py

@@ -242,3 +242,22 @@ def handle_check_matches(params: dict) -> str:
         "incoming_accepts": inc_only,
         "message": "；".join(msgs),
     })
+
+
+BASE_URL = "https://www.antenna.fyi"
+
+
+def handle_bind(params: dict) -> str:
+    sb = _sb()
+    did = _device_id(params["sender_id"], params["channel"])
+
+    resp = sb.rpc("create_bind_token", {"p_device_id": did}).execute()
+    if not resp.data:
+        return _ok({"error": "Failed to create bind token"})
+
+    token = resp.data.get("token")
+    return _ok({
+        "token": token,
+        "url": f"{BASE_URL}/locate?token={token}",
+        "message": "发送这个链接给用户，在手机浏览器打开即可共享位置。",
+    })

package/lib/mcp.js

@@ -10,6 +10,7 @@ import {
   accept,
   checkMatches,
   checkin,
+  createBindToken,
   deriveDeviceId,
 } from "./core.js";
 
@@ -143,6 +144,25 @@ export async function startMcpServer() {
     }
   );
 
+  // ─── antenna_bind ────────────────────────────────────────────
+
+  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.",
+    {
+      sender_id: z.string().describe("The sender's user ID"),
+      channel: z.string().describe("Channel name"),
+    },
+    async ({ sender_id, channel }) => {
+      try {
+        const result = await createBindToken({ device_id: deriveDeviceId(sender_id, channel) });
+        return jsonResult(result);
+      } catch (e) {
+        return jsonResult({ error: e.message });
+      }
+    }
+  );
+
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }

package/package.json

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