antenna-openclaw-plugin 0.3.1 → 0.4.0

package/index.ts

@@ -1,4 +1,5 @@
 import { createClient, SupabaseClient } from "@supabase/supabase-js";
+import { execSync } from "child_process";
 
 // ─── Built-in Supabase config (shared backend, zero config) ─────────
 
@@ -106,6 +107,90 @@ function ok(data: any) {
   return { content: [{ type: "text", text: JSON.stringify(data) }] };
 }
 
+// ─── Cron helpers ────────────────────────────────────────────────────
+
+const FOLLOW_UP_INTERVAL_MS = 15 * 60 * 1000; // 15 minutes
+const FOLLOW_UP_MAX_DURATION_MS = 2 * 60 * 60 * 1000; // 2 hours
+const _activeFollowUps = new Map<string, string>(); // "deviceA→deviceB" → cronJobId
+
+function cronJobId(deviceA: string, deviceB: string): string {
+  // Stable, filesystem-safe id
+  const safe = (s: string) => s.replace(/[^a-zA-Z0-9_-]/g, "_");
+  return `antenna-follow-${safe(deviceA)}-${safe(deviceB)}`;
+}
+
+function startFollowUpCron(
+  deviceId: string,
+  targetDeviceId: string,
+  channel: string,
+  userId: string,
+  targetName: string,
+  logger: any,
+): void {
+  const jobId = cronJobId(deviceId, targetDeviceId);
+  const key = `${deviceId}→${targetDeviceId}`;
+
+  // Already tracking this pair
+  if (_activeFollowUps.has(key)) return;
+
+  const message = [
+    `[Antenna follow-up] 检查匹配状态：`,
+    `运行 antenna_check_matches（sender_id="${userId}", channel="${channel}"）。`,
+    `如果 ${targetName}（${targetDeviceId}）已经 mutual match，`,
+    `用 message tool 通知用户：「${targetName} 也接受了你的匹配！」并附上对方的联系方式（如果有）。`,
+    `然后运行：openclaw cron remove ${jobId}`,
+    `如果还没有 mutual，回复 HEARTBEAT_OK。`,
+  ].join(" ");
+
+  // Schedule: expire after 2h using --at for auto-cleanup
+  const expiresAt = new Date(Date.now() + FOLLOW_UP_MAX_DURATION_MS).toISOString();
+
+  try {
+    // Create recurring 15-min job
+    execSync(
+      `openclaw cron add` +
+      ` --name "Antenna: 等待 ${targetName} 回应"` +
+      ` --every 15m` +
+      ` --session isolated` +
+      ` --message ${JSON.stringify(message)}` +
+      ` --announce` +
+      ` --channel ${channel}` +
+      ` --to "${userId}"`,
+      { timeout: 10_000, encoding: "utf-8" },
+    );
+
+    _activeFollowUps.set(key, jobId);
+    logger.info(`Antenna: follow-up cron created for ${key} (job: ${jobId})`);
+
+    // Schedule auto-cleanup after 2 hours
+    setTimeout(() => {
+      try {
+        execSync(`openclaw cron remove ${jobId}`, { timeout: 5_000 });
+        logger.info(`Antenna: follow-up expired for ${key}`);
+      } catch {
+        // Job may already be removed
+      }
+      _activeFollowUps.delete(key);
+    }, FOLLOW_UP_MAX_DURATION_MS);
+  } catch (err: any) {
+    logger.warn(`Antenna: failed to create follow-up cron: ${err.message}`);
+  }
+}
+
+function stopFollowUpCron(deviceA: string, deviceB: string, logger: any): void {
+  const key = `${deviceA}→${deviceB}`;
+  const jobId = _activeFollowUps.get(key);
+  if (!jobId) return;
+
+  try {
+    execSync(`openclaw cron remove ${jobId}`, { timeout: 5_000 });
+    logger.info(`Antenna: follow-up stopped for ${key}`);
+  } catch {
+    // Already removed
+  }
+  _activeFollowUps.delete(key);
+}
+
 // ─── Plugin ──────────────────────────────────────────────────────────
 
 export default function register(api: any) {
@@ -233,6 +318,53 @@ export default function register(api: any) {
     },
   });
 
+  // ═══════════════════════════════════════════════════════════════════
+  // Tool: antenna_checkin
+  // ═══════════════════════════════════════════════════════════════════
+  api.registerTool({
+    name: "antenna_checkin",
+    description:
+      "Check in at a location — update your position so others can find you when they scan. Use when the user says 'I'm at XX' or wants to be discoverable without scanning others. Also works with place names (agent should geocode first).",
+    parameters: {
+      type: "object",
+      properties: {
+        lat: { type: "number", description: "Latitude" },
+        lng: { type: "number", description: "Longitude" },
+        sender_id: { type: "string", description: "The sender's user ID" },
+        channel: { type: "string", description: "The channel name" },
+        place_name: { type: "string", description: "Optional: name of the place (for confirmation message)" },
+      },
+      required: ["lat", "lng", "sender_id", "channel"],
+    },
+    async execute(_id: string, params: any) {
+      const cfg = getConfig(api);
+      const supabase = getSupabase(cfg);
+      const deviceId = deriveDeviceId(params.sender_id, params.channel);
+      const fuzzy = fuzzyCoords(params.lat, params.lng);
+
+      // Check if user has a profile first
+      const { data: profile } = await supabase.rpc("get_profile", { p_device_id: deviceId });
+      if (!profile) {
+        return ok({
+          checked_in: false,
+          message: "你还没有名片，别人看到你也不知道你是谁。先创建一个名片吧（告诉我你的名字、emoji、三句话介绍自己）。",
+        });
+      }
+
+      const { error } = await supabase.rpc("upsert_profile_location", {
+        p_device_id: deviceId, p_lng: fuzzy.lng, p_lat: fuzzy.lat,
+      });
+
+      if (error) return ok({ error: error.message });
+
+      const place = params.place_name ? ` (${params.place_name})` : "";
+      return ok({
+        checked_in: true,
+        message: `已签到${place} 📍 现在附近的人扫描就能看到你了。`,
+      });
+    },
+  });
+
   // ═══════════════════════════════════════════════════════════════════
   // Tool: antenna_accept
   // ═══════════════════════════════════════════════════════════════════
@@ -268,6 +400,10 @@ export default function register(api: any) {
       );
 
       if (reverse) {
+        // Mutual match! Stop any follow-up cron for this pair
+        stopFollowUpCron(deviceId, params.target_device_id, logger);
+        stopFollowUpCron(params.target_device_id, deviceId, logger);
+
         return ok({
           accepted: true, mutual: true,
           their_contact: reverse.contact_info_a || null,
@@ -277,7 +413,19 @@ export default function register(api: any) {
         });
       }
 
-      return ok({ accepted: true, mutual: false, message: "已接受。等对方也接受后，你们就可以交换联系方式了。" });
+      // Not mutual yet — start a follow-up cron (check every 15min for 2h)
+      const { data: targetProfile } = await supabase.rpc("get_profile", { p_device_id: params.target_device_id });
+      const targetName = targetProfile?.display_name || "对方";
+
+      startFollowUpCron(
+        deviceId, params.target_device_id,
+        params.channel, params.sender_id, targetName, logger,
+      );
+
+      return ok({
+        accepted: true, mutual: false,
+        message: "已接受。我会在接下来 2 小时内每 15 分钟检查一次对方是否回应，有消息第一时间告诉你。",
+      });
     },
   });
 
@@ -319,6 +467,10 @@ export default function register(api: any) {
           (m: any) => m.device_id_a === match.device_id_b
         );
         if (reverse) {
+          // Clean up follow-up crons for this mutual pair
+          stopFollowUpCron(deviceId, match.device_id_b, logger);
+          stopFollowUpCron(match.device_id_b, deviceId, logger);
+
           const { data: profile } = await supabase.rpc("get_profile", { p_device_id: match.device_id_b });
           mutualMatches.push({
             device_id: match.device_id_b,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "antenna-openclaw-plugin",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Antenna — agent-mediated nearby people discovery for OpenClaw",
   "openclaw": {
     "extensions": ["./index.ts"]

package/skills/antenna/SKILL.md

@@ -139,10 +139,13 @@ Check for mutual matches and contact info updates.
 ### Accepting & contact exchange
 When the user wants to accept a match:
 1. Call `antenna_accept` with the target's device_id
-2. Ask: "想分享你的联系方式吗？比如微信号、Telegram、手机号"
-3. If user shares, call `antenna_accept` again with `contact_info`
-4. If mutual match, tell the user the other person's contact info (if they shared)
-5. If not mutual yet, tell the user to wait
+2. **立刻问**："想分享什么联系方式给对方？微信号、Telegram、手机号、Instagram……随便哪个都行"
+3. 用户给了联系方式 → call `antenna_accept` again with `contact_info`
+4. 用户不想分享 → "也行，先 accept 着，以后想分享再说"
+5. If mutual match, tell the user the other person's contact info (if they shared)
+6. If not mutual yet, tell the user: "已发出，等对方回应"
+
+**不要跳过第 2 步。** 联系方式是最终目标——不然 accept 了也没用，两个人找不到对方。
 
 ### Checking match status
 Use `antenna_check_matches` when: