antenna-fyi 1.3.9 → 1.3.11

package/lib/cli.js

@@ -67,15 +67,14 @@ export async function handleProfile(f) {
   if (!f.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 data = await setProfile({
-      device_id: f.id,
-      display_name: f.name,
-      emoji: f.emoji || "👤",
-      line1: f.line1,
-      line2: f.line2,
-      line3: f.line3,
-      ...(visible !== undefined && { visible }),
-    });
+    const payload = { device_id: f.id };
+    if (f.name) payload.display_name = f.name;
+    if (f.emoji) payload.emoji = f.emoji;
+    if (f.line1 !== undefined) payload.line1 = f.line1;
+    if (f.line2 !== undefined) payload.line2 = f.line2;
+    if (f.line3 !== undefined) payload.line3 = f.line3;
+    if (visible !== undefined) payload.visible = visible;
+    const data = await setProfile(payload);
     console.log("✅ Profile saved");
     console.log(JSON.stringify(data, null, 2));
   } else {

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 }) {
@@ -195,7 +205,7 @@ export async function getProfile({ device_id, supabaseUrl, supabaseKey }) {
 export async function setProfile({
   device_id,
   display_name,
-  emoji = "👤",
+  emoji,
   line1,
   line2,
   line3,
@@ -208,7 +218,7 @@ export async function setProfile({
   const { data, error } = await sb.rpc("upsert_profile", {
     p_device_id: device_id,
     p_display_name: display_name || null,
-    p_emoji: emoji,
+    p_emoji: emoji || null,
     p_line1: line1 || null,
     p_line2: line2 || null,
     p_line3: line3 || null,

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.9",
+  "version": "1.3.11",
   "description": "Antenna \u2014 nearby people discovery. CLI + MCP server + OpenClaw skill & plugin, all in one package.",
   "type": "module",
   "bin": {