antenna-fyi 0.5.0

package/README.md

@@ -0,0 +1,89 @@
+# 📡 Antenna
+
+Nearby people discovery — find interesting people around you.
+
+## Install
+
+```bash
+npm install -g antenna-fyi
+```
+
+## CLI Usage
+
+```bash
+# Create your profile card
+antenna setup --id telegram:123
+
+# Scan for nearby people
+antenna scan --lat 39.99 --lng 116.48 --radius 500 --id telegram:123
+
+# Check in at a location
+antenna checkin --id telegram:123 --lat 39.99 --lng 116.48
+
+# View/edit your profile
+antenna profile --id telegram:123
+antenna profile --id telegram:123 --name Yi --emoji 🦦 --line1 'Product Designer'
+
+# Accept a match
+antenna accept --id telegram:123 --target telegram:789 --contact 'WeChat: yi'
+
+# Check match status
+antenna matches --id telegram:123
+
+# Show status
+antenna status --id telegram:123
+```
+
+## MCP Server
+
+Start the MCP server for AI agent integration:
+
+```bash
+antenna serve
+```
+
+This starts a stdio-based MCP server with tools:
+- `antenna_scan` — Scan for nearby people
+- `antenna_profile` — Get/set profile card
+- `antenna_checkin` — Check in at a location
+- `antenna_accept` — Accept a match
+- `antenna_check_matches` — Check match status
+
+## OpenClaw Integration
+
+### Install Skill (recommended)
+
+```bash
+antenna install-skill
+```
+
+Copies the SKILL.md to `~/.openclaw/skills/antenna/` so your agent knows how to use Antenna.
+
+### Install Plugin (advanced)
+
+```bash
+mkdir my-antenna-plugin && cd my-antenna-plugin
+antenna install-plugin
+npm install
+openclaw plugins install .
+```
+
+The plugin adds automatic location-triggered scanning, match polling, and real-time notifications.
+
+## Environment Variables
+
+| Variable | Description | Default |
+|---|---|---|
+| `ANTENNA_SUPABASE_URL` | Supabase project URL | Built-in |
+| `ANTENNA_SUPABASE_KEY` | Supabase anon key | Built-in |
+
+## How It Works
+
+1. **Create a profile card** — emoji, name, 3 lines about you
+2. **Scan nearby** — find people within radius at your location
+3. **Accept matches** — if both sides accept, exchange contact info
+4. **Everything expires in 24h** — ephemeral by design
+
+## License
+
+MIT

package/bin/antenna.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+
+import {
+  parseFlags,
+  handleScan,
+  handleProfile,
+  handleAccept,
+  handleCheckin,
+  handleMatches,
+  handleSetup,
+  handleStatus,
+  handleInstallSkill,
+  handleInstallPlugin,
+  printHelp,
+} from "../lib/cli.js";
+
+const [,, cmd, ...args] = process.argv;
+const f = parseFlags(args);
+
+async function main() {
+  switch (cmd) {
+    case "scan":
+      return handleScan(f);
+    case "profile":
+      return handleProfile(f);
+    case "accept":
+      return handleAccept(f);
+    case "checkin":
+      return handleCheckin(f);
+    case "matches":
+      return handleMatches(f);
+    case "serve": {
+      const { startMcpServer } = await import("../lib/mcp.js");
+      return startMcpServer();
+    }
+    case "setup":
+      return handleSetup(f);
+    case "status":
+      return handleStatus(f);
+    case "install-skill":
+      return handleInstallSkill();
+    case "install-plugin":
+      return handleInstallPlugin();
+    case "help":
+    default:
+      return printHelp();
+  }
+}
+
+main().catch((e) => {
+  console.error(e.message);
+  process.exit(1);
+});

package/install.js

@@ -0,0 +1,19 @@
+// 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    ║
+╚══════════════════════════════════════════════════╝
+`);

package/lib/cli.js

@@ -0,0 +1,221 @@
+// antenna CLI command handlers
+
+import { scan, getProfile, setProfile, accept, checkMatches, checkin } from "./core.js";
+import { createInterface } from "readline";
+import { existsSync, mkdirSync, copyFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { homedir } from "os";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+export function parseFlags(args) {
+  const flags = {};
+  for (let i = 0; i < args.length; i++) {
+    if (args[i].startsWith("--")) {
+      const key = args[i].slice(2);
+      flags[key] = args[i + 1] || true;
+      i++;
+    }
+  }
+  return flags;
+}
+
+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]");
+  const result = await scan({
+    lat: +f.lat,
+    lng: +f.lng,
+    radius_m: +(f.radius || 500),
+    device_id: f.id || null,
+  });
+  if (result.count === 0) return console.log("📡 No one nearby within " + result.radius_m + "m");
+  console.log(`📡 ${result.count} people within ${result.radius_m}m:\n`);
+  result.profiles.forEach((p) => {
+    console.log(`  ${p.emoji} ${p.name}${p.distance_m != null ? ` (${Math.round(p.distance_m)}m)` : ""}`);
+    if (p.line1) console.log(`    ${p.line1}`);
+    if (p.line2) console.log(`    ${p.line2}`);
+    if (p.line3) console.log(`    ${p.line3}`);
+    console.log(`    id: ${p.device_id}\n`);
+  });
+}
+
+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) {
+    const data = await setProfile({
+      device_id: f.id,
+      display_name: f.name,
+      emoji: f.emoji || "👤",
+      line1: f.line1,
+      line2: f.line2,
+      line3: f.line3,
+    });
+    console.log("✅ Profile saved");
+    console.log(JSON.stringify(data, null, 2));
+  } else {
+    const data = await getProfile({ device_id: f.id });
+    if (!data) return console.log("No profile yet. Create one with --name and --line1/2/3");
+    console.log(`${data.emoji || "👤"} ${data.display_name || "Anonymous"}`);
+    if (data.line1) console.log(`  ${data.line1}`);
+    if (data.line2) console.log(`  ${data.line2}`);
+    if (data.line3) console.log(`  ${data.line3}`);
+  }
+}
+
+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']");
+  const result = await accept({
+    device_id: f.id,
+    target_device_id: f.target,
+    contact_info: f.contact,
+  });
+  console.log("✅ " + result.message);
+  if (result.mutual && result.their_contact) console.log("📇 Their contact: " + result.their_contact);
+}
+
+export async function handleCheckin(f) {
+  if (!f.id || !f.lat || !f.lng) return console.error("Usage: antenna checkin --id telegram:123 --lat 39.99 --lng 116.48 [--place '三里屯']");
+  const result = await checkin({
+    lat: +f.lat,
+    lng: +f.lng,
+    device_id: f.id,
+  });
+  console.log(result.checked_in ? "✅ " + result.message : "❌ " + result.message);
+}
+
+export async function handleMatches(f) {
+  if (!f.id) return console.error("Usage: antenna matches --id telegram:123");
+  const result = await checkMatches({ device_id: f.id });
+  if (!result.mutual_matches.length && !result.incoming_accepts.length) {
+    return console.log(result.message);
+  }
+  for (const m of result.mutual_matches) {
+    console.log(`🎉 MUTUAL: ${m.emoji} ${m.name}`);
+    if (m.their_contact) console.log(`   Their contact: ${m.their_contact}`);
+    if (m.you_shared) console.log(`   You shared: ${m.you_shared}`);
+    console.log();
+  }
+  for (const m of result.incoming_accepts) {
+    console.log(`📩 WANTS TO MEET YOU: ${m.emoji} ${m.name}`);
+    if (m.line1) console.log(`   ${m.line1}`);
+    console.log(`   Accept: antenna accept --id ${f.id} --target ${m.device_id}`);
+    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));
+
+  console.log("\n📡 Antenna Setup — 创建你的名片\n");
+
+  const id = f.id || await ask("Your device ID (e.g. telegram:123): ");
+  if (!id) { rl.close(); return console.error("Device ID is required."); }
+
+  const name = await ask("Display name: ");
+  const emoji = (await ask("Emoji (default 👤): ")) || "👤";
+  const line1 = await ask("Line 1 — who you are / what you do: ");
+  const line2 = await ask("Line 2 — what you're into: ");
+  const line3 = await ask("Line 3 — what you're looking for: ");
+
+  rl.close();
+
+  const data = await setProfile({
+    device_id: id,
+    display_name: name || null,
+    emoji,
+    line1: line1 || null,
+    line2: line2 || null,
+    line3: line3 || null,
+  });
+
+  console.log("\n✅ Profile saved!\n");
+  console.log(`  ${emoji} ${name || "Anonymous"}`);
+  if (line1) console.log(`    ${line1}`);
+  if (line2) console.log(`    ${line2}`);
+  if (line3) console.log(`    ${line3}`);
+  console.log();
+}
+
+export async function handleStatus(f) {
+  const supabaseUrl = process.env.ANTENNA_SUPABASE_URL || process.env.ANTENNA_URL || "https://bcudjloikmpcqwcptuyd.supabase.co";
+  console.log("📡 Antenna Status\n");
+  console.log(`  Supabase URL: ${supabaseUrl}`);
+
+  if (f.id) {
+    const profile = await getProfile({ device_id: f.id });
+    if (profile) {
+      console.log(`  Profile: ✅ ${profile.emoji || "👤"} ${profile.display_name || "Anonymous"}`);
+    } else {
+      console.log("  Profile: ❌ Not created yet");
+    }
+    const matches = await checkMatches({ device_id: f.id });
+    console.log(`  Mutual matches: ${matches.mutual_matches.length}`);
+    console.log(`  Incoming accepts: ${matches.incoming_accepts.length}`);
+  } else {
+    console.log("  Profile: (pass --id to check)");
+    console.log("  Matches: (pass --id to check)");
+  }
+  console.log();
+}
+
+export function handleInstallSkill() {
+  const skillDir = join(homedir(), ".openclaw", "skills", "antenna");
+  const skillSrc = join(__dirname, "..", "skill", "SKILL.md");
+
+  if (!existsSync(skillDir)) {
+    mkdirSync(skillDir, { recursive: true });
+  }
+
+  copyFileSync(skillSrc, join(skillDir, "SKILL.md"));
+  console.log("✅ SKILL.md installed to ~/.openclaw/skills/antenna/");
+  console.log("   Restart OpenClaw to pick it up.");
+}
+
+export function handleInstallPlugin() {
+  const templateDir = join(__dirname, "plugin-template");
+  const files = ["index.ts", "openclaw.plugin.json", "package.json"];
+
+  for (const file of files) {
+    const src = join(templateDir, file);
+    const dest = join(process.cwd(), file);
+    if (existsSync(dest)) {
+      console.log(`⚠️  ${file} already exists, skipping.`);
+    } else {
+      copyFileSync(src, dest);
+      console.log(`📄 Copied ${file}`);
+    }
+  }
+
+  console.log("\n✅ Plugin template files 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 printHelp() {
+  console.log(`📡 Antenna — nearby people discovery
+
+Usage:
+  antenna scan       --lat 39.99 --lng 116.48 [--radius 500] [--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']
+  antenna matches    --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]
+  antenna install-skill    Install SKILL.md to ~/.openclaw/skills/antenna/
+  antenna install-plugin   Copy plugin template to current directory
+  antenna help       Show this help
+
+Environment:
+  ANTENNA_SUPABASE_URL   Supabase project URL (optional, has default)
+  ANTENNA_SUPABASE_KEY   Supabase anon key (optional, has default)
+
+Install:  npm install -g antenna-fyi
+Or:       npx antenna-fyi scan --lat 39.99 --lng 116.48`);
+}

package/lib/core.js

@@ -0,0 +1,247 @@
+// antenna-core — shared logic for CLI, MCP, and Plugin
+// All three import this instead of duplicating Supabase calls.
+
+import { createClient } from "@supabase/supabase-js";
+
+const DEFAULT_URL = "https://bcudjloikmpcqwcptuyd.supabase.co";
+const DEFAULT_KEY =
+  "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImJjdWRqbG9pa21wY3F3Y3B0dXlkIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzQ0MTg1NDgsImV4cCI6MjA4OTk5NDU0OH0.FaoC3QfpfHP1npNGjRchJAoAp2PdZtQe_WhP-t-GN1o";
+
+let _client = null;
+let _url = null;
+
+export function getClient(url, key) {
+  const u = url || process.env.ANTENNA_SUPABASE_URL || process.env.ANTENNA_URL || DEFAULT_URL;
+  const k = key || process.env.ANTENNA_SUPABASE_KEY || process.env.ANTENNA_KEY || DEFAULT_KEY;
+  if (!_client || _url !== u) {
+    _client = createClient(u, k);
+    _url = u;
+  }
+  return _client;
+}
+
+export function deriveDeviceId(senderId, channel) {
+  return `${channel}:${senderId}`;
+}
+
+export function fuzzyCoord(lat, lng) {
+  return {
+    lat: Math.round(lat * 1000) / 1000,
+    lng: Math.round(lng * 1000) / 1000,
+  };
+}
+
+// ─── scan ────────────────────────────────────────────────────────────
+
+export async function scan({ lat, lng, radius_m = 500, device_id, supabaseUrl, supabaseKey }) {
+  const sb = getClient(supabaseUrl, supabaseKey);
+  const fuzzy = fuzzyCoord(lat, lng);
+
+  if (device_id) {
+    await sb.rpc("upsert_profile_location", {
+      p_device_id: device_id,
+      p_lng: fuzzy.lng,
+      p_lat: fuzzy.lat,
+    });
+  }
+
+  const { data, error } = await sb.rpc("nearby_profiles", {
+    p_lat: fuzzy.lat,
+    p_lng: fuzzy.lng,
+    p_radius_m: radius_m,
+  });
+
+  if (error) throw new Error(error.message);
+
+  const others = device_id
+    ? (data || []).filter((p) => p.device_id !== device_id)
+    : data || [];
+
+  return {
+    count: others.length,
+    radius_m,
+    profiles: others.map((p) => ({
+      device_id: p.device_id,
+      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,
+    })),
+  };
+}
+
+// ─── getProfile ──────────────────────────────────────────────────────
+
+export async function getProfile({ device_id, supabaseUrl, supabaseKey }) {
+  const sb = getClient(supabaseUrl, supabaseKey);
+  const { data, error } = await sb.rpc("get_profile", { p_device_id: device_id });
+  if (error) throw new Error(error.message);
+  return data || null;
+}
+
+// ─── setProfile ──────────────────────────────────────────────────────
+
+export async function setProfile({
+  device_id,
+  display_name,
+  emoji = "👤",
+  line1,
+  line2,
+  line3,
+  visible = true,
+  supabaseUrl,
+  supabaseKey,
+}) {
+  const sb = getClient(supabaseUrl, supabaseKey);
+  const { data, error } = await sb.rpc("upsert_profile", {
+    p_device_id: device_id,
+    p_display_name: display_name || null,
+    p_emoji: emoji,
+    p_line1: line1 || null,
+    p_line2: line2 || null,
+    p_line3: line3 || null,
+    p_visible: visible,
+  });
+  if (error) throw new Error(error.message);
+  return data;
+}
+
+// ─── accept ──────────────────────────────────────────────────────────
+
+export async function accept({
+  device_id,
+  target_device_id,
+  contact_info,
+  supabaseUrl,
+  supabaseKey,
+}) {
+  const sb = getClient(supabaseUrl, supabaseKey);
+
+  const { error } = await sb.rpc("upsert_match", {
+    p_device_id_a: device_id,
+    p_device_id_b: target_device_id,
+    p_reason: "",
+    p_score: 0,
+    p_status: "accepted",
+    p_contact_info: contact_info || null,
+    p_expires_hours: 24,
+  });
+  if (error) throw new Error(error.message);
+
+  // Check mutual
+  const { data: reverse } = await sb
+    .from("matches")
+    .select("status, contact_info_a")
+    .eq("device_id_a", target_device_id)
+    .eq("device_id_b", device_id)
+    .eq("status", "accepted")
+    .single();
+
+  const mutual = !!reverse;
+
+  return {
+    accepted: true,
+    mutual,
+    their_contact: mutual ? reverse?.contact_info_a || null : null,
+    message: mutual
+      ? "双向匹配成功！🎉"
+      : "已接受。等对方也接受后，你们就可以交换联系方式了。",
+  };
+}
+
+// ─── checkin ─────────────────────────────────────────────────────────
+
+export async function checkin({ lat, lng, device_id, supabaseUrl, supabaseKey }) {
+  const sb = getClient(supabaseUrl, supabaseKey);
+  const fuzzy = fuzzyCoord(lat, lng);
+
+  // Check profile exists
+  const profile = await getProfile({ device_id, supabaseUrl, supabaseKey });
+  if (!profile) {
+    return {
+      checked_in: false,
+      message: "你还没有名片，先创建一个吧。",
+    };
+  }
+
+  const { error } = await sb.rpc("upsert_profile_location", {
+    p_device_id: device_id,
+    p_lng: fuzzy.lng,
+    p_lat: fuzzy.lat,
+  });
+  if (error) throw new Error(error.message);
+
+  return {
+    checked_in: true,
+    message: "已签到 📍 现在附近的人扫描就能看到你了。",
+  };
+}
+
+// ─── checkMatches ────────────────────────────────────────────────────
+
+export async function checkMatches({ device_id, supabaseUrl, supabaseKey }) {
+  const sb = getClient(supabaseUrl, supabaseKey);
+
+  const { data: allMatches, error } = await sb.rpc("get_my_matches", { p_device_id: device_id });
+  if (error) throw new Error(error.message);
+
+  if (!allMatches?.length) {
+    return {
+      mutual_matches: [],
+      incoming_accepts: [],
+      message: "目前没有进行中的匹配。",
+    };
+  }
+
+  const myMatches = allMatches.filter((m) => m.device_id_a === device_id);
+  const incomingMatches = allMatches.filter((m) => m.device_id_b === device_id);
+
+  // Mutual
+  const mutualMatches = [];
+  for (const match of myMatches) {
+    const reverse = incomingMatches.find((m) => m.device_id_a === match.device_id_b);
+    if (reverse) {
+      const profile = await getProfile({ device_id: match.device_id_b, supabaseUrl, supabaseKey });
+      mutualMatches.push({
+        device_id: match.device_id_b,
+        name: profile?.display_name || "匿名",
+        emoji: profile?.emoji || "👤",
+        line1: profile?.line1,
+        line2: profile?.line2,
+        line3: profile?.line3,
+        their_contact: reverse.contact_info_a || null,
+        you_shared: match.contact_info_a || null,
+      });
+    }
+  }
+
+  // Incoming only
+  const incomingAccepts = [];
+  for (const match of incomingMatches) {
+    const iAccepted = myMatches.find((m) => m.device_id_b === match.device_id_a);
+    if (!iAccepted) {
+      const profile = await getProfile({ device_id: match.device_id_a, supabaseUrl, supabaseKey });
+      incomingAccepts.push({
+        device_id: match.device_id_a,
+        name: profile?.display_name || "匿名",
+        emoji: profile?.emoji || "👤",
+        line1: profile?.line1,
+        line2: profile?.line2,
+        line3: profile?.line3,
+      });
+    }
+  }
+
+  const messages = [];
+  if (mutualMatches.length > 0) messages.push(`${mutualMatches.length} 个双向匹配！可以交换联系方式了`);
+  if (incomingAccepts.length > 0) messages.push(`${incomingAccepts.length} 个人想认识你，等你回应`);
+  if (messages.length === 0) messages.push("你接受了一些匹配，但对方还没有回应。耐心等等 ⏳");
+
+  return {
+    mutual_matches: mutualMatches,
+    incoming_accepts: incomingAccepts,
+    message: messages.join("；"),
+  };
+}