antenna-fyi 1.3.10 → 1.3.12

package/bin/antenna.js

@@ -13,6 +13,7 @@ import {
   handlePass,
   handleWatch,
   handleSetup,
+  handleConfig,
   handleStatus,
   handleInstallSkill,
   handleInstallPlugin,
@@ -51,6 +52,8 @@ async function main() {
     }
     case "setup":
       return handleSetup(f);
+    case "config":
+      return handleConfig(f);
     case "status":
       return handleStatus(f);
     case "install-skill":

package/lib/cli.js

@@ -1,6 +1,6 @@
 // antenna CLI command handlers
 
-import { scan, getProfile, setProfile, accept, checkMatches, checkin, createBindToken, discover, createEvent, endEvent, eventCheckin, joinEvent, eventScan, pass as passUser, uploadEventImage, updateEvent, approveParticipant, rejectParticipant, addCohost, sendEventMessage, getMyEventMessages, getClient } from "./core.js";
+import { scan, getProfile, setProfile, accept, checkMatches, checkin, createBindToken, discover, createEvent, endEvent, eventCheckin, joinEvent, eventScan, pass as passUser, uploadEventImage, updateEvent, approveParticipant, rejectParticipant, addCohost, sendEventMessage, getMyEventMessages, getClient, verifyApiKey } from "./core.js";
 import { createInterface } from "readline";
 import { existsSync, mkdirSync, copyFileSync, readFileSync, writeFileSync, unlinkSync, renameSync } from "fs";
 import path from "path";
@@ -31,12 +31,13 @@ export function parseFlags(args) {
 }
 
 export async function handleScan(f) {
-  if (!f.lat && !f.lng && !f.id) return console.error("Usage: antenna scan --lat 39.99 --lng 116.48 [--radius 500] (max 1000) [--id <platform>:<user_id>]\n  Or just: antenna scan --id <platform>:<user_id> (uses saved location from GPS bind)");
+  const _scanId = resolveId(f);
+  if (!f.lat && !f.lng && !_scanId) return console.error("Usage: antenna scan --lat 39.99 --lng 116.48 [--radius 500] (max 1000) [--id <platform>:<user_id>]\n  Or just: antenna scan --id <platform>:<user_id> (uses saved location from GPS bind)");
   const result = await scan({
     lat: f.lat ? +f.lat : undefined,
     lng: f.lng ? +f.lng : undefined,
     radius_m: +(f.radius || 500),
-    device_id: f.id || null,
+    device_id: _scanId || null,
   });
   if (result.count === 0) return console.log(result.message || "📡 No one nearby");
   if (result.global) {
@@ -64,10 +65,11 @@ export async function handleScan(f) {
 }
 
 export async function handleProfile(f) {
-  if (!f.id) return console.error("Usage: antenna profile --id <platform>:<user_id> [--name Yi --emoji 🦦 --line1 '...' --line2 '...' --line3 '...']");
+  const id = resolveId(f);
+  if (!id) return console.error("Usage: antenna profile --id <platform>:<user_id> [--name Yi --emoji 🦦 --line1 '...' --line2 '...' --line3 '...']");
   if (f.name || f.line1 || f.line2 || f.line3 || f.visible !== undefined || f.hide !== undefined) {
     const visible = f.hide ? false : (f.visible !== undefined ? f.visible === 'true' || f.visible === true : undefined);
-    const payload = { device_id: f.id };
+    const payload = { device_id: id };
     if (f.name) payload.display_name = f.name;
     if (f.emoji) payload.emoji = f.emoji;
     if (f.line1 !== undefined) payload.line1 = f.line1;
@@ -78,7 +80,7 @@ export async function handleProfile(f) {
     console.log("✅ Profile saved");
     console.log(JSON.stringify(data, null, 2));
   } else {
-    const data = await getProfile({ device_id: f.id });
+    const data = await getProfile({ device_id: 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}`);
@@ -88,9 +90,10 @@ export async function handleProfile(f) {
 }
 
 export async function handleAccept(f) {
-  if (!f.id || (!f.target && !f.ref)) return console.error("Usage: antenna accept --id <platform>:<user_id> --ref 1 [--contact 'WeChat: yi']\n       antenna accept --id <platform>:<user_id> --target <ref_or_device_id> [--contact 'WeChat: yi']");
+  const id = resolveId(f);
+  if (!id || (!f.target && !f.ref)) return console.error("Usage: antenna accept --id <platform>:<user_id> --ref 1 [--contact 'WeChat: yi']\n       antenna accept --id <platform>:<user_id> --target <ref_or_device_id> [--contact 'WeChat: yi']");
   const result = await accept({
-    device_id: f.id,
+    device_id: id,
     target_device_id: f.target || null,
     ref: f.ref || null,
     contact_info: f.contact,
@@ -100,18 +103,20 @@ export async function handleAccept(f) {
 }
 
 export async function handleCheckin(f) {
-  if (!f.id || !f.lat || !f.lng) return console.error("Usage: antenna checkin --id <platform>:<user_id> --lat 39.99 --lng 116.48 [--place '三里屯']");
+  const id = resolveId(f);
+  if (!id || !f.lat || !f.lng) return console.error("Usage: antenna checkin --id <platform>:<user_id> --lat 39.99 --lng 116.48 [--place '三里屯']");
   const result = await checkin({
     lat: +f.lat,
     lng: +f.lng,
-    device_id: f.id,
+    device_id: 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 <platform>:<user_id>");
-  const result = await checkMatches({ device_id: f.id });
+  const id = resolveId(f);
+  if (!id) return console.error("Usage: antenna matches --id <platform>:<user_id>");
+  const result = await checkMatches({ device_id: id });
   if (!result.mutual_matches.length && !result.incoming_accepts.length) {
     return console.log(result.message);
   }
@@ -130,8 +135,9 @@ export async function handleMatches(f) {
 }
 
 export async function handleDiscover(f) {
-  if (!f.id) return console.error("Usage: antenna discover --id <platform>:<user_id>");
-  const result = await discover({ device_id: f.id });
+  const id = resolveId(f);
+  if (!id) return console.error("Usage: antenna discover --id <platform>:<user_id>");
+  const result = await discover({ device_id: id });
   if (result.count === 0) return console.log(result.message || "🌍 No global recommendation available right now.");
   console.log(`🌍 Global discover:\n`);
   result.profiles.forEach((p) => {
@@ -145,6 +151,7 @@ export async function handleDiscover(f) {
 }
 
 export async function handleEvent(f) {
+  f.id = f.id || resolveId(f);
   const sub = f._?.[0] || Object.keys(f).find(k => ["create", "join", "scan", "end", "checkin", "upload-image"].includes(k));
 
   if (f['upload-image']) {
@@ -180,7 +187,8 @@ export async function handleEvent(f) {
 
   if (f.create || (!f.join && !f.scan && !f.end && !f.update && !f.approve && !f.reject && !f['add-host'] && f.name)) {
     if (!f.name) return console.error("Usage: antenna event --create --name 'AI Meetup' --id <platform>:<user_id> --starts-at '2026-04-19T14:00' --ends-at '2026-04-19T18:00' [--lat 34.05 --lng -118.25] [--desc 'description'] [--og-image 'url'] [--requires-approval] [--screening-questions 'Q1|Q2']");
-    if (!f.id) return console.error("❌ --id is required (e.g. --id <platform>:<user_id>). Creator identity needed to manage the event.");
+    const id = resolveId(f);
+    if (!id) return console.error("❌ --id is required (e.g. --id <platform>:<user_id>). Creator identity needed to manage the event.");
     if (!f['starts-at'] || !f['ends-at']) return console.error("❌ --starts-at and --ends-at are required. Example: --starts-at '2026-04-19T14:00' --ends-at '2026-04-19T18:00'");
     const result = await createEvent({ name: f.name, device_id: f.id, lat: f.lat ? +f.lat : undefined, lng: f.lng ? +f.lng : undefined, starts_at: f['starts-at'], ends_at: f['ends-at'], description: f.desc || undefined, og_image: f['og-image'] || undefined, requires_approval: f['requires-approval'] === true || f['requires-approval'] === 'true' || undefined, screening_questions: f['screening-questions'] ? f['screening-questions'].split('|') : undefined });
     console.log(`\n🎉 Event created!\n`);
@@ -294,8 +302,9 @@ export async function handleEvent(f) {
 }
 
 export async function handleBind(f) {
-  if (!f.id) return console.error("Usage: antenna bind --id <platform>:<user_id>");
-  const result = await createBindToken({ device_id: f.id });
+  const id = resolveId(f);
+  if (!id) return console.error("Usage: antenna bind --id <platform>:<user_id>");
+  const result = await createBindToken({ device_id: 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.");
@@ -303,10 +312,11 @@ export async function handleBind(f) {
 }
 
 export async function handlePass(f) {
-  if (!f.id) return console.error("Usage: antenna pass --id <platform>:<user_id> --target <ref_or_device_id>");
+  const id = resolveId(f);
+  if (!id) return console.error("Usage: antenna pass --id <platform>:<user_id> --target <ref_or_device_id>");
   if (!f.target && !f.ref) return console.error("Usage: antenna pass --id <platform>:<user_id> --target <ref_or_device_id> (or --ref 1)");
   const result = await passUser({
-    device_id: f.id,
+    device_id: id,
     target_device_id: f.target,
     ref: f.ref,
   });
@@ -347,6 +357,70 @@ export async function handleSetup(f) {
   console.log();
 }
 
+// ─── Config file helpers ─────────────────────────────────────────────
+
+const CONFIG_DIR = path.join(os.homedir(), '.antenna');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+
+export function loadConfig() {
+  try {
+    if (existsSync(CONFIG_FILE)) {
+      return JSON.parse(readFileSync(CONFIG_FILE, 'utf8'));
+    }
+  } catch {}
+  return {};
+}
+
+function saveConfig(config) {
+  if (!existsSync(CONFIG_DIR)) mkdirSync(CONFIG_DIR, { recursive: true });
+  writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2) + '\n');
+}
+
+/** Resolve device_id: --id flag > config file > null */
+function resolveId(f) {
+  if (f.id) return f.id;
+  const config = loadConfig();
+  if (config.device_id) return config.device_id;
+  return null;
+}
+
+export async function handleConfig(f) {
+  if (f.key) {
+    // Verify the key against Supabase
+    console.log('\n📡 Verifying API key...');
+    try {
+      const result = await verifyApiKey({ key: f.key });
+      if (!result.valid) {
+        console.error(`\n❌ ${result.error || 'Invalid API key'}`);
+        process.exit(1);
+      }
+      const config = loadConfig();
+      config.key = f.key;
+      config.device_id = result.device_id;
+      config.display_name = result.display_name;
+      saveConfig(config);
+      console.log(`\n✅ Authenticated as ${result.display_name || 'Antenna user'}`);
+      console.log(`  Device ID: ${result.device_id}`);
+      console.log(`  Config saved to ~/.antenna/config.json\n`);
+    } catch (e) {
+      console.error(`\n❌ Failed to verify key: ${e.message}`);
+      process.exit(1);
+    }
+  } else {
+    // Show current config
+    const config = loadConfig();
+    if (config.key) {
+      console.log('\n📡 Antenna Config\n');
+      console.log(`  Key: ${config.key.slice(0, 10)}...${config.key.slice(-4)}`);
+      console.log(`  Device ID: ${config.device_id || '(unknown)'}`);
+      console.log(`  Name: ${config.display_name || '(unknown)'}\n`);
+    } else {
+      console.log('\n📡 No API key configured.');
+      console.log('  Run: antenna config --key <your-api-key>\n');
+    }
+  }
+}
+
 export async function handleStatus(f) {
   const supabaseUrl = process.env.ANTENNA_SUPABASE_URL || process.env.ANTENNA_URL || "https://bcudjloikmpcqwcptuyd.supabase.co";
   console.log("\n📡 Antenna Status\n");
@@ -907,6 +981,7 @@ Usage:
   antenna bind       --id <platform>:<user_id>
   antenna serve      Start MCP server (stdio transport)
   antenna setup      Interactive profile setup [--id <platform>:<user_id>]
+  antenna config     Configure API key [--key <ant_...>]
   antenna status     Show config & status [--id <platform>:<user_id>]
   antenna install-skill    Install SKILL.md (detects OpenClaw + Hermes)
   antenna install-plugin   Copy OpenClaw plugin template to cwd

package/lib/core.js

@@ -181,6 +181,16 @@ export async function scan({ lat, lng, radius_m = 500, device_id, supabaseUrl, s
   };
 }
 
+// ─── Profile field metadata (self-describing API) ───────────────────
+
+export const PROFILE_FIELDS = {
+  display_name: { label: "显示名称", description: "How you want to be called" },
+  line1: { label: "个人描述", description: "Who you are and what you do", maxLength: 220, required: true },
+  line2: { label: "想认识的人", description: "The kind of people you want to meet", maxLength: 140 },
+  line3: { label: "想要的交流方式", description: "The type of conversations you want", maxLength: 160 },
+  matching_context: { label: "匹配上下文", description: "Agent-generated rich context for better matching (not shown to others)", maxLength: 1000 },
+};
+
 // ─── getProfile ──────────────────────────────────────────────────────
 
 export async function getProfile({ device_id, supabaseUrl, supabaseKey }) {
@@ -725,3 +735,12 @@ export async function getMyEventMessages({ device_id, supabaseUrl, supabaseKey }
     count: (data || []).length,
   };
 }
+
+// ─── verifyApiKey ────────────────────────────────────────────────────
+
+export async function verifyApiKey({ key, supabaseUrl, supabaseKey }) {
+  const sb = getClient(supabaseUrl, supabaseKey);
+  const { data, error } = await sb.rpc("verify_api_key", { p_key: key });
+  if (error) throw new Error(error.message);
+  return data;
+}

package/lib/mcp.js

@@ -25,6 +25,7 @@ import {
   addCohost,
   sendEventMessage,
   deriveDeviceId,
+  PROFILE_FIELDS,
 } from "./core.js";
 
 export async function startMcpServer() {
@@ -104,17 +105,17 @@ export async function startMcpServer() {
 
   server.tool(
     "antenna_profile",
-    "Get or set the user's Antenna profile card.",
+    "Get or set the user's Antenna profile card. The profile has a display name and three descriptions: personal description, looking for, and conversation style.",
     {
       action: z.enum(["get", "set"]).describe("'get' to read, 'set' to write"),
       sender_id: z.string().describe("The sender's user ID"),
       channel: z.string().describe("Channel name"),
-      display_name: z.string().optional(),
-      emoji: z.string().optional(),
-      line1: z.string().optional(),
-      line2: z.string().optional(),
-      line3: z.string().optional(),
-      matching_context: z.string().optional().describe("Agent-generated rich context for better matching (not shown to others)"),
+      display_name: z.string().optional().describe("Display name"),
+      emoji: z.string().optional().describe("Profile emoji (stored but not displayed on card)"),
+      line1: z.string().optional().describe("Personal description — who you are and what you do (max 220 chars)"),
+      line2: z.string().optional().describe("Looking for — the kind of people you want to meet (max 140 chars)"),
+      line3: z.string().optional().describe("Conversation style — the type of conversations you want (max 160 chars)"),
+      matching_context: z.string().optional().describe("Agent-generated rich context for embedding-based matching (not shown to others, max 1000 chars). Generate this FIRST, then derive the three descriptions from it."),
       visible: z.boolean().optional().default(true),
     },
     async ({ action, sender_id, channel, display_name, emoji, line1, line2, line3, matching_context, visible }) => {
@@ -122,7 +123,9 @@ export async function startMcpServer() {
       try {
         if (action === "get") {
           const data = await getProfile({ device_id: deviceId });
-          const result = data ? { profile: data } : { profile: null, message: "还没有名片，帮你创建一个？" };
+          const result = data
+            ? { profile: data, fields: PROFILE_FIELDS }
+            : { profile: null, message: "还没有名片。跟用户聊聊他们是谁、做什么、想认识什么人，然后帮他们创建。", fields: PROFILE_FIELDS };
           return jsonResult(await withMatchNotifications(deviceId, result));
         }
         const data = await setProfile({ device_id: deviceId, display_name, emoji, line1, line2, line3, matching_context, visible });

package/package.json

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