antenna-fyi 1.3.39 → 1.3.41

package/README.md

@@ -11,6 +11,10 @@ npm install -g antenna-fyi
 ## CLI Usage
 
 ```bash
+# Find people by intent (agent-facing search)
+antenna find --id <platform>:<user_id> --query "想找一个懂 consumer social 增长的人"
+antenna find-people --id <platform>:<user_id> --query "find someone building AI hardware" --limit 3
+
 # Create your profile card
 antenna setup --id <platform>:<user_id>
 
@@ -48,6 +52,7 @@ This starts a stdio-based MCP server with tools:
 - `antenna_checkin` — Check in at a location
 - `antenna_accept` — Accept a match
 - `antenna_check_matches` — Check match status
+- `antenna_find_people` — Find 1-3 people from a free-form user intent. Use when the user says "I want to meet/find someone who..."; returns refs and safe profile fields, not contact info or raw device IDs.
 
 ## Hermes Agent Integration
 
@@ -103,9 +108,10 @@ The plugin adds automatic location-triggered scanning, match polling, and real-t
 ## 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
+2. **Find by intent** — users can say "I want someone who understands X"; agents call `antenna_find_people` / `antenna find`
+3. **Scan nearby** — find people within radius at your location
+4. **Accept matches** — if both sides accept, exchange contact info
+5. **Everything expires in 24h** — ephemeral by design
 
 ## License
 

package/lib/cli.js

@@ -1098,6 +1098,12 @@ export async function handleDrift(f) {
 export function printHelp() {
   console.log(`📡 Antenna — nearby people discovery
 
+Agent shortcuts:
+  antenna find       Find 1-3 people by intent, e.g. "想找一个懂 consumer social 增长的人"
+  antenna discover   Get today's global recommendation
+  antenna scan       Find nearby people after GPS is available
+  antenna accept     Use a returned ref/profile_slug when the user wants an intro
+
 Usage:
   antenna scan       --lat 39.99 --lng 116.48 [--radius 500] (max 1000) [--id <platform>:<user_id>]
   antenna checkin    --id <platform>:<user_id> --lat 39.99 --lng 116.48
@@ -1107,6 +1113,7 @@ Usage:
   antenna matches    --id <platform>:<user_id>
   antenna discover   --id <platform>:<user_id>
   antenna find       --id <platform>:<user_id> --query '想找一个懂 consumer social 增长的人' [--limit 3]
+  antenna find-people --id <platform>:<user_id> --query 'find someone building AI hardware' [--limit 3]
   antenna event      --create --name 'AI Meetup' --starts-at '...' --ends-at '...' [--lat 34.05 --lng -118.25] [--desc '...'] [--og-image 'url'] [--requires-approval] [--screening-questions 'Q1|Q2'] | --join --code abc123 | --scan --code abc123 | --end --code abc123 --id <platform>:<user_id> | --upload-image --code abc123 --file /path/to/image.png | --update --code abc123 --name 'New Name' | --approve --code abc123 --ref 1 | --reject --code abc123 --ref 1 | --add-host --code abc123 --ref 1
   antenna drift      --throw --message 'hello' | --pick | --reply --bottle-id <uuid> --message 'reply' | --check | --my-bottles  --id <platform>:<user_id>
   antenna watch       --id <platform>:<user_id> [--push hermes|openclaw|terminal]  Watch for new matches in real-time (Ctrl+C to stop)
@@ -1126,5 +1133,5 @@ Environment:
   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`);
+Or:       npx antenna-fyi find --id <platform>:<user_id> --query 'AI hardware builders'`);
 }

package/lib/core.js

@@ -2,6 +2,7 @@
 // All three import this instead of duplicating Supabase calls.
 
 import { createClient } from "@supabase/supabase-js";
+import { createHash } from "node:crypto";
 
 const DEFAULT_URL = "https://bcudjloikmpcqwcptuyd.supabase.co";
 const DEFAULT_KEY =
@@ -55,6 +56,17 @@ function mapSearchProfile(p, ref, query) {
   };
 }
 
+function profileSlugCandidate(displayName, deviceId) {
+  const fromName = String(displayName || "")
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-|-$/g, "")
+    .substring(0, 30);
+  if (fromName) return fromName;
+  const hash = createHash("sha1").update(String(deviceId || "antenna-user")).digest("hex").slice(0, 10);
+  return `user-${hash}`;
+}
+
 async function generateMatchReason(myLines, theirLines) {
   try {
     const res = await fetch(`${_url || DEFAULT_URL}/functions/v1/generate-match-reason`, {
@@ -227,15 +239,15 @@ 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" },
-  personal_description: { label: "个人描述", description: "Who you are and what you do", maxLength: 220, required: true },
-  looking_for: { label: "想认识的人", description: "The kind of people you want to meet", maxLength: 140 },
-  conversation_style: { label: "想要的交流方式", description: "The type of conversations you want", maxLength: 160 },
-  more_information: { label: "更多信息", description: "Agent-generated rich context for better matching (not shown to others)", maxLength: 1000 },
-  interest_tags: { label: "兴趣标签", description: "Interest/topic tags shown on the card (up to 5)", maxItems: 5 },
-  city: { label: "国家/地区", description: "Country or region" },
-  links: { label: "社交链接", description: "Social links shown on the card footer (up to 3)", maxItems: 3 },
-  is_active: { label: "状态", description: "Whether the profile is active or quiet" },
+  display_name: { label: "显示名称", i18n: { en: "Display name", zh: "显示名称" }, description: "How you want to be called" },
+  personal_description: { label: "个人描述", i18n: { en: "Personal description", zh: "个人描述" }, description: "Who you are and what you do", maxLength: 220, required: true },
+  looking_for: { label: "想认识的人", i18n: { en: "Looking for", zh: "想认识的人" }, description: "The kind of people you want to meet", maxLength: 140 },
+  conversation_style: { label: "想要的交流方式", i18n: { en: "Conversation style", zh: "想要的交流方式" }, description: "The type of conversations you want", maxLength: 160 },
+  more_information: { label: "更多信息", i18n: { en: "More information", zh: "更多信息" }, description: "Agent-generated rich context for better matching (not shown to others)", maxLength: 1000 },
+  interest_tags: { label: "兴趣标签", i18n: { en: "Interest tags", zh: "兴趣标签" }, description: "Interest/topic tags shown on the card (up to 5)", maxItems: 5 },
+  city: { label: "国家/地区", i18n: { en: "Country/region", zh: "国家/地区" }, description: "Country or region" },
+  links: { label: "社交链接", i18n: { en: "Social links", zh: "社交链接" }, description: "Social links shown on the card footer (up to 3)", maxItems: 3 },
+  is_active: { label: "状态", i18n: { en: "Status", zh: "状态" }, description: "Whether the profile is active or quiet" },
 };
 
 // ─── getProfile ──────────────────────────────────────────────────────
@@ -335,7 +347,7 @@ export async function setProfile({
     p_visible: visible,
     p_matching_context: contextJson || null,
     p_contact_info: contact_info || null,
-    ...(api_key ? { p_api_key: api_key } : {}),
+    p_api_key: api_key || null,
   });
   if (error) throw new Error(error.message);
 
@@ -366,9 +378,9 @@ export async function setProfile({
     const profile = await getProfile({ device_id, supabaseUrl, supabaseKey });
     profileSlug = profile?.profile_slug || null;
     // Use explicitly passed slug, or auto-generate from display_name
-    const targetSlug = profile_slug || (!profileSlug && display_name ? display_name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").substring(0, 30) : null);
+    const targetSlug = profile_slug || (!profileSlug ? profileSlugCandidate(display_name, device_id) : null);
     if (targetSlug && targetSlug !== profileSlug) {
-      const { data: slugResult } = await sb.rpc("set_profile_slug", { p_device_id: device_id, p_slug: targetSlug });
+      const { data: slugResult } = await sb.rpc("set_profile_slug", { p_device_id: device_id, p_slug: targetSlug, p_api_key: api_key || null });
       if (slugResult?.set) profileSlug = targetSlug;
     }
     if (profileSlug) {

package/lib/hermes-plugin/tools.py

@@ -5,6 +5,7 @@ shared backend if no env vars are set.
 """
 
 import json
+import hashlib
 import math
 import os
 import time
@@ -33,6 +34,15 @@ _last_ref_map: dict[str, str] = {}  # ref → device_id from last scan
 _my_device_ids: set[str] = set()  # track this user's device_ids for match checking
 
 
+def _profile_slug_candidate(display_name: str | None, device_id: str) -> str:
+    raw = "".join(ch.lower() if ch.isalnum() and ch.isascii() else "-" for ch in (display_name or ""))
+    slug = "-".join(part for part in raw.split("-") if part)[:30].strip("-")
+    if slug:
+        return slug
+    digest = hashlib.sha1(device_id.encode("utf-8")).hexdigest()[:10]
+    return f"user-{digest}"
+
+
 def _get_url():
     return os.environ.get("ANTENNA_SUPABASE_URL") or os.environ.get("ANTENNA_URL") or BUILTIN_URL
 
@@ -192,10 +202,30 @@ def handle_profile(params: dict) -> str:
     }
     if params.get("matching_context") is not None:
         rpc_params["p_matching_context"] = params["matching_context"]
+    rpc_params["p_api_key"] = params.get("api_key")
     resp = sb.rpc("upsert_profile", rpc_params).execute()
 
     if resp.data:
-        return _ok({"updated": True, "profile": resp.data, "next_step": "IMPORTANT: Now call antenna_bind to generate a GPS link for the user. Do not skip this."})
+        public_url = None
+        try:
+            profile_resp = sb.rpc("get_profile", {"p_device_id": did}).execute()
+            profile = profile_resp.data or {}
+            profile_slug = profile.get("profile_slug")
+            if not profile_slug:
+                target_slug = _profile_slug_candidate(params.get("display_name"), did)
+                slug_resp = sb.rpc("set_profile_slug", {"p_device_id": did, "p_slug": target_slug, "p_api_key": params.get("api_key")}).execute()
+                if isinstance(slug_resp.data, dict) and slug_resp.data.get("set"):
+                    profile_slug = target_slug
+            if profile_slug:
+                public_url = f"https://www.antenna.fyi/p/{profile_slug}"
+        except Exception:
+            public_url = None
+        return _ok({
+            "updated": True,
+            "profile": resp.data,
+            "public_url": public_url,
+            "next_step": "IMPORTANT: 1) Send public_url to the user — this is their shareable profile link. 2) Call antenna_bind to generate a GPS link. Do not skip either step.",
+        })
     return _ok({"error": "upsert_profile failed"})
 
 

package/lib/mcp.js

@@ -113,7 +113,7 @@ export async function startMcpServer() {
 
   server.tool(
     "antenna_profile",
-    "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.",
+    "Get or set the user's Antenna profile card. After setting a profile, send profile.public_url to the user as their public profile link, then send the GPS bind link.",
     {
       action: z.enum(["get", "set"]).describe("'get' to read, 'set' to write"),
       sender_id: z.string().describe("The sender's user ID"),

package/lib/plugin-template/index.ts

@@ -1,5 +1,6 @@
 import { createClient, SupabaseClient } from "@supabase/supabase-js";
 import { execSync } from "child_process";
+import { createHash } from "crypto";
 
 // ─── Built-in Supabase config (shared backend, zero config) ─────────
 
@@ -66,6 +67,16 @@ function getSupabase(cfg: AntennaConfig): SupabaseClient {
   return _supabaseClient;
 }
 
+function profileSlugCandidate(displayName: string | null | undefined, deviceId: string) {
+  const fromName = String(displayName || "")
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-|-$/g, "")
+    .substring(0, 30);
+  if (fromName) return fromName;
+  return `user-${createHash("sha1").update(deviceId).digest("hex").slice(0, 10)}`;
+}
+
 function isRateLimited(deviceId: string): boolean {
   const now = Date.now();
   const last = _lastScanTime.get(deviceId);
@@ -425,14 +436,29 @@ export default function register(api: any) {
         p_display_name: params.display_name ?? null, p_emoji: null,
         p_line1: params.line1 ?? null, p_line2: params.line2 ?? null,
         p_line3: params.line3 ?? null, p_visible: params.visible ?? true,
+        p_api_key: null,
       });
 
       if (error) return ok({ error: error.message });
 
+      let publicUrl = null;
+      try {
+        const { data: profile } = await supabase.rpc("get_profile", { p_device_id: deviceId });
+        let profileSlug = profile?.profile_slug || null;
+        if (!profileSlug) {
+          const targetSlug = profileSlugCandidate(params.display_name, deviceId);
+          const { data: slugResult } = await supabase.rpc("set_profile_slug", { p_device_id: deviceId, p_slug: targetSlug, p_api_key: null });
+          if (slugResult?.set) profileSlug = targetSlug;
+        }
+        if (profileSlug) publicUrl = `https://www.antenna.fyi/p/${profileSlug}`;
+      } catch {}
+
       return ok({
         updated: true,
         profile: { display_name: data.display_name,
           line1: data.line1, line2: data.line2, line3: data.line3, visible: data.visible },
+        public_url: publicUrl,
+        next_step: "IMPORTANT: Send the public_url to the user — this is their shareable profile link. Then call antenna_bind to generate a GPS link. Do not skip either step.",
       });
     },
   });

package/package.json

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

package/skill/SKILL.md

@@ -23,6 +23,8 @@ Antenna 帮你的用户发现值得认识的人。不只是"附近的人"--profi
 
 - 如果有 Antenna plugin tools(antenna_scan, antenna_profile 等),直接用。
 - 如果没有,用 CLI:`antenna <command> [flags]`。
+- 用户说"我想找一个 xxx 的人"、"find someone who..."、"有没有做 X 的人"时,优先用 `antenna_find_people`。CLI 等价命令是:
+  `antenna find --id <platform>:<user_id> --query "<用户原话>" --limit 3`
 - **所有 tool 必须传 `chat_id`**--Antenna 用它发通知。
 
 ## Onboarding - 装上后主动引导
@@ -69,10 +71,12 @@ Plugin 安装后,agent **主动**开始引导,不要等用户问。
 
 **第四步:发公开链接给用户**
 
-Profile 存好后,返回里会有 `public_url`(如 `antenna.fyi/p/yi`)。**必须发给用户:**
+Profile 存好后,返回里会有 `public_url`(如 `antenna.fyi/p/yi`)。**必须立刻发给用户。不要只说"保存好了"。**
 > "这是你的公开名片链接:[public_url]
 > 你可以把它发给别人,对方的 agent 看到链接就能直接 accept 你。"
 
+如果 `public_url` 为空,说明 profile link 生成失败。立刻重试保存 profile 或提示错误,不要进入下一步。
+
 **第五步:调 antenna_bind 获取 GPS 链接**
 
 **强制。** 名片存好后**必须立刻**调用 `antenna_bind` 生成链接并发给用户:
@@ -128,6 +132,8 @@ openclaw cron add --every 1h --message "Check antenna matches: call antenna_chec
 - 不返回联系方式或 raw `device_id`
 - 你仍然要结合上下文判断是否推荐,不要机械展示所有结果
 - 用户想认识某人时,用 `ref` 调 `antenna_accept`
+- 没有 plugin tool 时,用 CLI:
+  `antenna find --id <platform>:<user_id> --query "想找一个懂 consumer social 增长的人" --limit 3`
 
 ### 4. Profile 链接
 用户收到 `antenna.fyi/p/xxx` 链接时:
@@ -166,6 +172,8 @@ openclaw cron add --every 1h --message "Check antenna matches: call antenna_chec
 - **conversation_style**:想要的交流方式
 - **matching_context**(more_information,不展示给别人):agent 基于对用户的了解生成的详细描述,~200 字。**这是匹配的核心数据源。** personal_description/looking_for/conversation_style 从它提炼出来,不是反过来。
 
+**i18n:** 用户填写的内容按原文保存和展示,不要自动翻译用户的 profile 文本。Antenna 的网页 UI 会切换中文/英文标签; profile 内容本身保持用户选择的语言。保存后返回的 `public_url` 必须发给用户。
+
 ### `antenna_accept`
 接受一个匹配。**不需要先 scan**--任何发现路径都可以触发 accept。
 - `sender_id`, `channel`, `chat_id`:必填