antenna-fyi 1.3.23 → 1.3.25

package/bin/antenna.js

@@ -15,6 +15,7 @@ import {
   handleSetup,
   handleConfig,
   handleStatus,
+  handleLinkAccount,
   handleInstallSkill,
   handleInstallPlugin,
   handleInstallHermesPlugin,
@@ -56,6 +57,8 @@ async function main() {
       return handleConfig(f);
     case "status":
       return handleStatus(f);
+    case "link-account":
+      return handleLinkAccount(f);
     case "install-skill":
       return handleInstallSkill();
     case "install-plugin":

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, verifyApiKey } 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, linkAccount, initialRecommendations } from "./core.js";
 import { createInterface } from "readline";
 import { existsSync, mkdirSync, copyFileSync, readFileSync, writeFileSync, unlinkSync, renameSync } from "fs";
 import path from "path";
@@ -401,9 +401,11 @@ export async function handleConfig(f) {
       const config = loadConfig();
       config.key = f.key;
       config.device_id = result.device_id;
+      config.user_id = result.user_id;
       config.display_name = result.display_name;
       saveConfig(config);
       console.log(`\n✅ Authenticated as ${result.display_name || 'Antenna user'}`);
+      console.log(`  User ID: ${result.user_id}`);
       console.log(`  Device ID: ${result.device_id}`);
       console.log(`  Config saved to ~/.antenna/config.json\n`);
     } catch (e) {
@@ -425,6 +427,26 @@ export async function handleConfig(f) {
   }
 }
 
+export async function handleLinkAccount(f) {
+  const id = resolveId(f);
+  const config = loadConfig();
+  const apiKey = f['api-key'] || f.apiKey || f.key || config.key;
+  if (!id) return console.error("Usage: antenna link-account --id <device_id> --api-key <ant_xxx>\n       Or: antenna link-account (uses config device_id + key)");
+  if (!apiKey) return console.error("❌ No API key. Run 'antenna config --key <your-key>' first, or pass --api-key <key>.");
+  try {
+    const result = await linkAccount({ device_id: id, api_key: apiKey });
+    if (result.error) {
+      console.error(`\n❌ ${result.message || result.error}`);
+    } else {
+      console.log(`\n✅ ${result.message || 'Account linked.'}`);
+      console.log(`  Device ID: ${id}`);
+      console.log(`  API Key: ${apiKey.slice(0, 10)}...\n`);
+    }
+  } catch (e) {
+    console.error(`\n❌ Failed: ${e.message}`);
+  }
+}
+
 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");

package/lib/core.js

@@ -917,13 +917,13 @@ export async function verifyApiKey({ key, supabaseUrl, supabaseKey }) {
   return data;
 }
 
-// ─── linkAccount (bind user_id to device_id) ─────────────────────────
+// ─── linkAccount (bind device_id to website account via API key) ─────
 
-export async function linkAccount({ device_id, user_id, supabaseUrl, supabaseKey }) {
+export async function linkAccount({ device_id, api_key, supabaseUrl, supabaseKey }) {
   const sb = getClient(supabaseUrl, supabaseKey);
   const { data, error } = await sb.rpc("bind_user_id", {
     p_device_id: device_id,
-    p_user_id: user_id,
+    p_api_key: api_key,
   });
   if (error) throw new Error(error.message);
   if (data?.error) return data;

package/lib/hermes-plugin/schemas.py

@@ -397,9 +397,9 @@ LINK_ACCOUNT_SCHEMA = {
             "sender_id": {"type": "string", "description": "The sender's user ID"},
             "channel": {"type": "string", "description": "Platform name"},
             "chat_id": {"type": "string", "description": "REQUIRED. Pass the chat/channel ID from message context."},
-            "user_id": {"type": "string", "description": "The user's antenna.fyi account UUID, visible on their dashboard"},
+            "api_key": {"type": "string", "description": "The user's Antenna API key (ant_xxx) from antenna.fyi/me"},
         },
-        "required": ["sender_id", "channel", "chat_id", "user_id"],
+        "required": ["sender_id", "channel", "chat_id", "api_key"],
     },
 }
 

package/lib/hermes-plugin/tools.py

@@ -726,7 +726,7 @@ def handle_link_account(params: dict) -> str:
 
     resp = sb.rpc("bind_user_id", {
         "p_device_id": did,
-        "p_user_id": params["user_id"],
+        "p_api_key": params["api_key"],
     }).execute()
 
     if resp.data and resp.data.get("error"):

package/lib/mcp.js

@@ -540,15 +540,15 @@ export async function startMcpServer() {
 
   server.tool(
     "antenna_link_account",
-    "Link your Antenna agent profile to your antenna.fyi website account. The user needs to provide their user_id from the dashboard (antenna.fyi/me). After linking, the dashboard will show the same profile and match history.",
+    "Link your Antenna agent profile to your antenna.fyi website account. Pass the user's API key — the server verifies it and extracts the user_id. The agent never needs to know or pass user_id directly.",
     {
       sender_id: z.string().describe("The sender's user ID"),
       channel: z.string().describe("Channel name"),
-      user_id: z.string().describe("The user's antenna.fyi account UUID, visible on their dashboard"),
+      api_key: z.string().describe("The user's Antenna API key (ant_xxx) from antenna.fyi/me"),
     },
-    async ({ sender_id, channel, user_id }) => {
+    async ({ sender_id, channel, api_key }) => {
       try {
-        const result = await linkAccount({ device_id: deriveDeviceId(sender_id, channel), user_id });
+        const result = await linkAccount({ device_id: deriveDeviceId(sender_id, channel), api_key });
         return jsonResult(result);
       } catch (e) { return jsonResult({ error: e.message }); }
     }

package/package.json

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

package/skill/SKILL.md

@@ -24,33 +24,39 @@ Antenna 帮你的用户发现值得认识的人。不只是"附近的人"--profi
 - 如果没有,用 CLI:`antenna <command> [flags]`。
 - **所有 tool 必须传 `chat_id`**--Antenna 用它发通知。
 
-## Onboarding - 装上后主动引导
+## Onboarding — 装上后主动引导
 
-Plugin 安装后,agent **主动**开始引导,不要等用户问。
+Plugin 安装后，agent **主动**开始引导，不要等用户问。
 
-**前置条件:** 用户需要先在 antenna.fyi 注册账号,从 Dashboard 获取 API key。如果没注册,引导去 antenna.fyi。
+**前置条件：** 用户需要先在 antenna.fyi 注册账号，从 Dashboard 获取 API key。如果没注册，引导去 antenna.fyi。
 
 ### 流程
 
-**第一步:打招呼 + 解释**
-> "嘿,你装了 Antenna--它能帮你发现有意思的人。先确认一下,你在 antenna.fyi 注册过了吗?拿到 API key 了吗?"
+**第一步：拿到 API key → 配置**
+> "嘿，你装了 Antenna——它能帮你发现有意思的人。先确认一下，你在 antenna.fyi 注册过了吗？拿到 API key 了吗？"
 
-**第二步:聊天收集 → 生成名片 → 确认**
+用户给了 API key 后，调 `antenna config --key <key>` 验证。这会返回 `user_id` 和 `device_id`。
 
-跟用户聊几句,了解他们是谁、做什么、想认识什么人。然后 agent 自己生成:
-- more_information(~200 字,给 agent 匹配用的私密上下文,不展示给别人)
+**⚠️ 之后所有操作必须用 API key 验证返回的 device_id（格式 `user:xxx`）。不要自己拼 `channel:sender_id`。** 这样 agent 创建的 profile 才能在 dashboard 上显示。
+
+**第二步：聊天收集 → 生成名片 → 确认**
+
+跟用户聊几句，了解他们是谁、做什么、想认识什么人。然后 agent 自己生成：
+- more_information（~200 字，给 agent 匹配用的私密上下文，不展示给别人）
 - 从中提炼 line1/2/3 + display_name
 
-展示预览给用户确认:
-> 你的名片:
+展示预览给用户确认：
+> 你的名片：
 > Yi
-> · Product Designer,做 AI 搜索体验
+> · Product Designer，做 AI 搜索体验
 > · 对 AI agent、音乐、游泳感兴趣
 > · 想认识做 AI 产品和独立创作的人
 >
-> 这样可以吗?要改哪里告诉我。
+> 这样可以吗？要改哪里告诉我。
+
+确认后用 config 里的 device_id 调 `antenna_profile(action="set")` 保存。**不要跳过确认。**
 
-确认后才调 `antenna_profile(action="set")` 保存。**不要跳过确认。**
+**⚠️ sender_id 用 config 里的 device_id，不要用 channel:sender_id。**
 
 **第三步:立刻推荐 2-3 个人**
 
@@ -79,8 +85,8 @@ openclaw cron add --every 1h --message "Check antenna matches: call antenna_chec
 ### Linking to antenna.fyi account
 
 如果用户之前通过 agent 创建过 profile(没有网站账号),现在注册了 antenna.fyi:
-1. 让用户从 antenna.fyi/me 复制 user ID
-2. 调 `antenna_link_account(user_id = "xxx")`
+1. 让用户从 antenna.fyi/me 复制 API key
+2. 调 `antenna_link_account(api_key = "ant_xxx")`
 3. 确认:"关联成功!你现在可以在 dashboard 上看到完整的 profile 和匹配记录了。"
 
 这把 agent 创建的 profile(带全部历史)关联到网站账号。
@@ -179,15 +185,15 @@ openclaw cron add --every 1h --message "Check antenna matches: call antenna_chec
 - 一次性操作
 
 ### `antenna_discover`
-全球推荐——每天 1 个最匹配的人。
+全球推荐--每天 1 个最匹配的人。
 - `sender_id`, `channel`, `chat_id`
 - 不需要 GPS
-- 如果所有人都推荐过了，返回“等新人加入”
+- 如果所有人都推荐过了,返回"等新人加入"
 
 ### `antenna_initial_recommendations`
-首次推荐——注册后立刻看到 2-3 个最匹配的人。
+首次推荐--注册后立刻看到 2-3 个最匹配的人。
 - `sender_id`, `channel`, `chat_id`: from context
-- One-time only — second call returns empty
+- One-time only - second call returns empty
 - Does NOT consume daily discover quota
 - Use in onboarding step 3, right after profile save