antenna-fyi 1.2.4 → 1.2.6

package/lib/cli.js

@@ -1,6 +1,6 @@
 // antenna CLI command handlers
 
-import { scan, getProfile, setProfile, accept, checkMatches, checkin, createBindToken, discover, createEvent, joinEvent, eventScan, pass as passUser } from "./core.js";
+import { scan, getProfile, setProfile, accept, checkMatches, checkin, createBindToken, discover, createEvent, endEvent, eventCheckin, joinEvent, eventScan, pass as passUser } from "./core.js";
 import { createInterface } from "readline";
 import { existsSync, mkdirSync, copyFileSync } from "fs";
 import { join, dirname } from "path";
@@ -47,8 +47,18 @@ export async function handleScan(f) {
     if (p.line1) console.log(`    ${p.line1}`);
     if (p.line2) console.log(`    ${p.line2}`);
     if (p.line3) console.log(`    ${p.line3}`);
-    console.log(`    id: ${p.device_id}\n`);
+    console.log(`    ref: ${p.ref}\n`);
   });
+
+  // Show nearby events
+  if (result.nearby_events?.length) {
+    console.log(`🎉 Nearby events:\n`);
+    result.nearby_events.forEach((e) => {
+      console.log(`  ${e.name} — ${e.participants} people`);
+      if (e.description) console.log(`    ${e.description}`);
+      console.log(`    Join: antenna event --join --code ${e.code}\n`);
+    });
+  }
 }
 
 export async function handleProfile(f) {
@@ -131,11 +141,29 @@ export async function handleDiscover(f) {
 }
 
 export async function handleEvent(f) {
-  const sub = f._?.[0] || Object.keys(f).find(k => ["create", "join", "scan"].includes(k));
+  const sub = f._?.[0] || Object.keys(f).find(k => ["create", "join", "scan", "end", "checkin"].includes(k));
+
+  if (f.end) {
+    if (!f.code || !f.id) return console.error("Usage: antenna event --end --code abc123 --id telegram:123");
+    const result = await endEvent({ code: f.code, device_id: f.id });
+    if (result.ended) {
+      console.log(`\n✅ Event ended.\n`);
+    } else {
+      console.log(`\n❌ ${result.error || 'Failed to end event'}\n`);
+    }
+    return;
+  }
+
+  if (f.checkin) {
+    if (!f.code || !f.id) return console.error("Usage: antenna event --checkin --code abc123 --id telegram:123 [--lat 34.05 --lng -118.24]");
+    const result = await eventCheckin({ code: f.code, device_id: f.id, lat: f.lat ? +f.lat : undefined, lng: f.lng ? +f.lng : undefined });
+    console.log(`\n✅ Checked in to event.\n`);
+    return;
+  }
 
-  if (f.create || (!f.join && !f.scan && f.name)) {
-    if (!f.name) return console.error("Usage: antenna event --create --name 'AI Meetup'");
-    const result = await createEvent({ name: f.name, device_id: f.id || null, lat: f.lat ? +f.lat : undefined, lng: f.lng ? +f.lng : undefined });
+  if (f.create || (!f.join && !f.scan && !f.end && f.name)) {
+    if (!f.name) return console.error("Usage: antenna event --create --name 'AI Meetup' [--desc 'description'] [--og-image 'url']");
+    const result = await createEvent({ name: f.name, device_id: f.id || null, lat: f.lat ? +f.lat : undefined, lng: f.lng ? +f.lng : undefined, description: f.desc || undefined, og_image: f['og-image'] || undefined });
     console.log(`\n🎉 Event created!\n`);
     console.log(`  Name: ${result.name}`);
     console.log(`  Code: ${result.code}`);
@@ -169,9 +197,11 @@ export async function handleEvent(f) {
   }
 
   console.log(`Usage:
-  antenna event --create --name 'AI Meetup' [--id telegram:123]
+  antenna event --create --name 'AI Meetup' [--id telegram:123] [--desc 'description'] [--og-image 'url']
   antenna event --join --code abc123 --id telegram:123
-  antenna event --scan --code abc123 [--id telegram:123]`);
+  antenna event --scan --code abc123 [--id telegram:123]
+  antenna event --checkin --code abc123 --id telegram:123 [--lat 34.05 --lng -118.24]
+  antenna event --end --code abc123 --id telegram:123`);
 }
 
 export async function handleBind(f) {
@@ -366,7 +396,7 @@ Usage:
   antenna pass       --id telegram:123 --target telegram:789 (or --ref 1)
   antenna matches    --id telegram:123
   antenna discover   --id telegram:123
-  antenna event      --create --name 'AI Meetup' | --join --code abc123 | --scan --code abc123
+  antenna event      --create --name 'AI Meetup' [--desc '...'] [--og-image 'url'] | --join --code abc123 | --scan --code abc123 | --end --code abc123 --id telegram:123
   antenna bind       --id telegram:123
   antenna serve      Start MCP server (stdio transport)
   antenna setup      Interactive profile setup [--id telegram:123]

package/lib/core.js

@@ -161,11 +161,21 @@ export async function scan({ lat, lng, radius_m = 500, device_id, supabaseUrl, s
   const profs = buildProfiles(others);
   await saveRefs(_refMap);
 
+  // Fetch nearby events
+  let nearby_events = [];
+  if (lat != null && lng != null) {
+    try {
+      const { data: evts } = await sb.rpc("nearby_events", { p_lat: lat, p_lng: lng, p_radius_m: 5000 });
+      nearby_events = evts || [];
+    } catch { /* best effort */ }
+  }
+
   return {
     count: others.length,
     radius_m,
     profiles: profs,
     _ref_map: _refMap,
+    nearby_events,
   };
 }
 
@@ -469,7 +479,7 @@ export async function pass({ device_id, target_device_id, ref, supabaseUrl, supa
 
 // ─── events ─────────────────────────────────────────────────────────
 
-export async function createEvent({ name, lat, lng, device_id, starts_at, ends_at, supabaseUrl, supabaseKey }) {
+export async function createEvent({ name, lat, lng, device_id, starts_at, ends_at, description, og_image, supabaseUrl, supabaseKey }) {
   const sb = getClient(supabaseUrl, supabaseKey);
   const { data, error } = await sb.rpc("create_event", {
     p_name: name,
@@ -478,6 +488,26 @@ export async function createEvent({ name, lat, lng, device_id, starts_at, ends_a
     p_created_by: device_id || null,
     p_starts_at: starts_at || new Date().toISOString(),
     p_ends_at: ends_at || new Date(Date.now() + 12 * 60 * 60 * 1000).toISOString(),
+    p_description: description || null,
+    p_og_image: og_image || null,
+  });
+  if (error) throw new Error(error.message);
+  return data;
+}
+
+export async function endEvent({ code, device_id, supabaseUrl, supabaseKey }) {
+  const sb = getClient(supabaseUrl, supabaseKey);
+  const { data, error } = await sb.rpc("end_event", { p_code: code, p_device_id: device_id });
+  if (error) throw new Error(error.message);
+  return data;
+}
+
+export async function eventCheckin({ code, device_id, lat, lng, supabaseUrl, supabaseKey }) {
+  const sb = getClient(supabaseUrl, supabaseKey);
+  const fuzzy = (lat != null && lng != null) ? fuzzyCoord(lat, lng) : { lat: null, lng: null };
+  const { data, error } = await sb.rpc("event_checkin", {
+    p_code: code, p_device_id: device_id,
+    p_lat: fuzzy.lat, p_lng: fuzzy.lng,
   });
   if (error) throw new Error(error.message);
   return data;

package/lib/hermes-plugin/__init__.py

@@ -18,6 +18,8 @@ from .tools import (
     handle_event_create,
     handle_event_join,
     handle_event_scan,
+    handle_event_end,
+    handle_event_checkin,
     _sb,
     _device_id,
     _my_device_ids,
@@ -34,6 +36,8 @@ from .schemas import (
     EVENT_CREATE_SCHEMA,
     EVENT_JOIN_SCHEMA,
     EVENT_SCAN_SCHEMA,
+    EVENT_END_SCHEMA,
+    EVENT_CHECKIN_SCHEMA,
 )
 import re
 import time
@@ -61,6 +65,8 @@ def register(ctx):
     ctx.register_tool("antenna_event_create", EVENT_CREATE_SCHEMA, handle_event_create)
     ctx.register_tool("antenna_event_join", EVENT_JOIN_SCHEMA, handle_event_join)
     ctx.register_tool("antenna_event_scan", EVENT_SCAN_SCHEMA, handle_event_scan)
+    ctx.register_tool("antenna_event_end", EVENT_END_SCHEMA, handle_event_end)
+    ctx.register_tool("antenna_event_checkin", EVENT_CHECKIN_SCHEMA, handle_event_checkin)
 
     # ── Hook: auto-detect location + check web GPS events ─────────
     def on_pre_llm(messages, **kwargs):

package/lib/hermes-plugin/schemas.py

@@ -176,7 +176,7 @@ EVENT_CREATE_SCHEMA = {
     "name": "antenna_event_create",
     "description": (
         "Create an event. Returns a shareable link (antenna.fyi/e/CODE) "
-        "for participants to join."
+        "for participants to join. Optionally include a description and OG image URL."
     ),
     "parameters": {
         "type": "object",
@@ -188,6 +188,8 @@ EVENT_CREATE_SCHEMA = {
             "lng": {"type": "number", "description": "Event longitude"},
             "starts_at": {"type": "string", "description": "Start time ISO"},
             "ends_at": {"type": "string", "description": "End time ISO"},
+            "description": {"type": "string", "description": "Event description"},
+            "og_image": {"type": "string", "description": "OG image URL for social sharing"},
         },
         "required": ["name", "sender_id", "channel"],
     },
@@ -220,3 +222,33 @@ EVENT_SCAN_SCHEMA = {
         "required": ["code", "sender_id", "channel"],
     },
 }
+
+EVENT_END_SCHEMA = {
+    "name": "antenna_event_end",
+    "description": "End an event. Only the creator can end it.",
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "code": {"type": "string", "description": "Event code"},
+            "sender_id": {"type": "string", "description": "The sender's user ID"},
+            "channel": {"type": "string", "description": "Platform name"},
+        },
+        "required": ["code", "sender_id", "channel"],
+    },
+}
+
+EVENT_CHECKIN_SCHEMA = {
+    "name": "antenna_event_checkin",
+    "description": "Check in at an event \u2014 marks you as present at the event location. Optionally updates GPS.",
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "code": {"type": "string", "description": "Event code"},
+            "sender_id": {"type": "string", "description": "The sender's user ID"},
+            "channel": {"type": "string", "description": "Platform name"},
+            "lat": {"type": "number", "description": "Latitude (optional)"},
+            "lng": {"type": "number", "description": "Longitude (optional)"},
+        },
+        "required": ["code", "sender_id", "channel"],
+    },
+}

package/lib/hermes-plugin/tools.py

@@ -379,6 +379,10 @@ def handle_event_create(params: dict) -> str:
         rpc_params["p_starts_at"] = params["starts_at"]
     if params.get("ends_at"):
         rpc_params["p_ends_at"] = params["ends_at"]
+    if params.get("description"):
+        rpc_params["p_description"] = params["description"]
+    if params.get("og_image"):
+        rpc_params["p_og_image"] = params["og_image"]
 
     resp = sb.rpc("create_event", rpc_params).execute()
     data = resp.data or {}
@@ -459,3 +463,38 @@ def handle_bind(params: dict) -> str:
         "url": f"{BASE_URL}/locate?token={token}",
         "message": "发送这个链接给用户，在手机浏览器打开即可共享位置。",
     })
+
+
+def handle_event_end(params: dict) -> str:
+    sb = _sb()
+    did = _device_id(params["sender_id"], params["channel"])
+
+    resp = sb.rpc("end_event", {
+        "p_code": params["code"],
+        "p_device_id": did,
+    }).execute()
+    data = resp.data or {}
+
+    if data.get("ended"):
+        return _ok({"ended": True, "message": f"活动已结束。"})
+    return _ok({"ended": False, "error": data.get("error", "结束活动失败")})
+
+
+def handle_event_checkin(params: dict) -> str:
+    sb = _sb()
+    did = _device_id(params["sender_id"], params["channel"])
+
+    lat = params.get("lat")
+    lng = params.get("lng")
+    if lat is not None and lng is not None:
+        flat, flng = _fuzzy(lat, lng)
+    else:
+        flat, flng = None, None
+
+    resp = sb.rpc("event_checkin", {
+        "p_code": params["code"],
+        "p_device_id": did,
+        "p_lat": flat,
+        "p_lng": flng,
+    }).execute()
+    return _ok(resp.data or {})

package/lib/mcp.js

@@ -14,6 +14,8 @@ import {
   createBindToken,
   discover,
   createEvent,
+  endEvent,
+  eventCheckin,
   joinEvent,
   eventScan,
   deriveDeviceId,
@@ -233,10 +235,30 @@ export async function startMcpServer() {
       lng: z.number().optional().describe("Event longitude"),
       starts_at: z.string().optional().describe("Start time ISO string"),
       ends_at: z.string().optional().describe("End time ISO string"),
+      description: z.string().optional().describe("Event description"),
+      og_image: z.string().optional().describe("OG image URL for social sharing"),
     },
-    async ({ name, sender_id, channel, lat, lng, starts_at, ends_at }) => {
+    async ({ name, sender_id, channel, lat, lng, starts_at, ends_at, description, og_image }) => {
       try {
-        const result = await createEvent({ name, lat, lng, device_id: deriveDeviceId(sender_id, channel), starts_at, ends_at });
+        const result = await createEvent({ name, lat, lng, device_id: deriveDeviceId(sender_id, channel), starts_at, ends_at, description, og_image });
+        return jsonResult(result);
+      } catch (e) { return jsonResult({ error: e.message }); }
+    }
+  );
+
+  // ─── antenna_event_end ───────────────────────────────────────
+
+  server.tool(
+    "antenna_event_end",
+    "End an event. Only the creator can end it.",
+    {
+      code: z.string().describe("Event code"),
+      sender_id: z.string().describe("The sender's user ID"),
+      channel: z.string().describe("Channel name"),
+    },
+    async ({ code, sender_id, channel }) => {
+      try {
+        const result = await endEvent({ code, device_id: deriveDeviceId(sender_id, channel) });
         return jsonResult(result);
       } catch (e) { return jsonResult({ error: e.message }); }
     }
@@ -260,6 +282,26 @@ export async function startMcpServer() {
     }
   );
 
+  // ─── antenna_event_checkin ─────────────────────────────────
+
+  server.tool(
+    "antenna_event_checkin",
+    "Check in at an event — marks you as present at the event location. Optionally updates GPS.",
+    {
+      code: z.string().describe("Event code"),
+      sender_id: z.string().describe("The sender's user ID"),
+      channel: z.string().describe("Channel name"),
+      lat: z.number().optional().describe("Latitude (optional)"),
+      lng: z.number().optional().describe("Longitude (optional)"),
+    },
+    async ({ code, sender_id, channel, lat, lng }) => {
+      try {
+        const result = await eventCheckin({ code, device_id: deriveDeviceId(sender_id, channel), lat, lng });
+        return jsonResult(result);
+      } catch (e) { return jsonResult({ error: e.message }); }
+    }
+  );
+
   // ─── antenna_event_scan ────────────────────────────────────
 
   server.tool(

package/package.json

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

package/skill/SKILL.md

@@ -66,11 +66,12 @@ cron 设完后，问用户一句：
 ## Tools
 
 ### `antenna_scan`
-Scan for nearby people. Returns **raw profile cards** — no scores, no pre-matching. **You are the matching engine.**
+Scan for nearby people **and events**. Returns raw profile cards + active events within 5km.
 - `lat`, `lng`: coordinates (from `LocationLat`/`LocationLon` context, or geocoded from user input)
-- `radius_m`: search radius in meters (default 500, max 1000)
+- `radius_m`: search radius in meters (default 500, max 1000) for people; events search uses 5km
 - `sender_id`: the user's id from message context
 - `channel`: the channel name (telegram, whatsapp, discord, etc.)
+- Returns `profiles` (nearby people) + `nearby_events` (active events with name, participants count, code)
 
 After receiving the nearby profiles, **you decide** who to recommend:
 - Use everything you know about the user: their SOUL.md, memory, recent conversations, interests, current mood
@@ -278,6 +279,13 @@ Create an event. Returns a shareable link (antenna.fyi/e/CODE).
 - `sender_id`, `channel`: from context
 - `lat`, `lng`: optional event location
 - `starts_at`, `ends_at`: optional time range (default: now to +12h)
+- `description`: optional event description
+- `og_image`: optional OG image URL for social sharing preview
+
+### `antenna_event_end`
+End an event. Only the creator can end it.
+- `code`: event code
+- `sender_id`, `channel`: from context
 
 ### `antenna_event_join`
 Join an event by code.
@@ -289,3 +297,9 @@ Scan people in an event. No distance limit — returns all participants.
 - `code`: event code
 - `sender_id`, `channel`: from context
 - Returns profiles with `source: "event"` tag
+
+### `antenna_event_checkin`
+Check in at an event — marks you as present at the event location. Optionally updates GPS.
+- `code`: event code
+- `sender_id`, `channel`: from context
+- `lat`, `lng`: optional GPS coordinates