antenna-fyi 1.2.11 → 1.2.13

package/lib/cli.js

@@ -179,7 +179,7 @@ export async function handleEvent(f) {
 
   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 });
+    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, requires_approval: f['requires-approval'] === true || f['requires-approval'] === 'true' || undefined, screening_questions: f['screening-questions'] ? f['screening-questions'].split('|') : undefined });
     console.log(`\n🎉 Event created!\n`);
     console.log(`  Name: ${result.name}`);
     console.log(`  Code: ${result.code}`);
@@ -190,7 +190,7 @@ export async function handleEvent(f) {
 
   if (f.join) {
     if (!f.code || !f.id) return console.error("Usage: antenna event --join --code abc123 --id telegram:123");
-    const result = await joinEvent({ code: f.code, device_id: f.id });
+    const result = await joinEvent({ code: f.code, device_id: f.id, lat: f.lat ? +f.lat : undefined, lng: f.lng ? +f.lng : undefined, application_context: f['application-context'] || undefined });
     if (result.joined) {
       console.log(`\n✅ Joined "${result.name}" (${result.code})\n`);
     } else {

package/lib/core.js

@@ -490,7 +490,7 @@ export async function uploadEventImage({ image_data, content_type, event_code, s
   return data.publicUrl;
 }
 
-export async function createEvent({ name, lat, lng, device_id, starts_at, ends_at, description, og_image, supabaseUrl, supabaseKey }) {
+export async function createEvent({ name, lat, lng, device_id, starts_at, ends_at, description, og_image, requires_approval, screening_questions, supabaseUrl, supabaseKey }) {
   const sb = getClient(supabaseUrl, supabaseKey);
   const { data, error } = await sb.rpc("create_event", {
     p_name: name,
@@ -501,6 +501,8 @@ export async function createEvent({ name, lat, lng, device_id, starts_at, ends_a
     p_ends_at: ends_at || new Date(Date.now() + 12 * 60 * 60 * 1000).toISOString(),
     p_description: description || null,
     p_og_image: og_image || null,
+    p_requires_approval: requires_approval || false,
+    p_screening_questions: screening_questions || null,
   });
   if (error) throw new Error(error.message);
   return data;
@@ -533,10 +535,71 @@ export async function eventCheckin({ code, device_id, lat, lng, supabaseUrl, sup
   return data;
 }
 
-export async function joinEvent({ code, device_id, supabaseUrl, supabaseKey }) {
+export async function joinEvent({ code, device_id, lat, lng, application_context, supabaseUrl, supabaseKey }) {
   const sb = getClient(supabaseUrl, supabaseKey);
-  const { data, error } = await sb.rpc("join_event", { p_code: code, p_device_id: device_id });
+
+  // Profile gate: check if user has a profile before joining
+  const profile = await getProfile({ device_id, supabaseUrl, supabaseKey });
+  if (!profile) {
+    return { joined: false, error: "Create a profile first before joining events" };
+  }
+
+  // Auto-read profile location if not provided
+  if (lat == null || lng == null) {
+    try {
+      const { data: loc } = await sb.rpc("get_profile_location", { p_device_id: device_id });
+      if (loc?.lat && loc?.lng) { lat = loc.lat; lng = loc.lng; }
+    } catch {}
+  }
+
+  const { data, error } = await sb.rpc("join_event", {
+    p_code: code,
+    p_device_id: device_id,
+    p_lat: (lat != null && lng != null) ? fuzzyCoord(lat, lng).lat : null,
+    p_lng: (lat != null && lng != null) ? fuzzyCoord(lat, lng).lng : null,
+    p_application_context: application_context || null,
+  });
   if (error) throw new Error(error.message);
+  if (!data?.joined) return data;
+
+  // Auto-checkin if event has already started and we have GPS
+  if (lat != null && lng != null) {
+    try {
+      const event = await getEvent({ code, supabaseUrl, supabaseKey });
+      const startsAt = event?.starts_at ? new Date(event.starts_at) : null;
+      if (startsAt && startsAt <= new Date()) {
+        // Event has started — attempt auto-checkin
+        if (event.lat != null && event.lng != null) {
+          // Calculate distance (Haversine)
+          const R = 6371000;
+          const dLat = (event.lat - lat) * Math.PI / 180;
+          const dLng = (event.lng - lng) * Math.PI / 180;
+          const a = Math.sin(dLat/2)**2 + Math.cos(lat*Math.PI/180)*Math.cos(event.lat*Math.PI/180)*Math.sin(dLng/2)**2;
+          const dist = R * 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1-a));
+
+          if (dist <= 1000) {
+            await eventCheckin({ code, device_id, lat, lng, supabaseUrl, supabaseKey });
+            data.checked_in = true;
+          } else {
+            data.checked_in = false;
+            data.checkin_reason = "too far";
+            data.distance_m = Math.round(dist);
+          }
+        } else {
+          // Event has no GPS — checkin without distance check
+          await eventCheckin({ code, device_id, lat, lng, supabaseUrl, supabaseKey });
+          data.checked_in = true;
+        }
+      } else {
+        data.checked_in = false;
+        data.checkin_reason = "event not started yet";
+      }
+    } catch {
+      data.checked_in = false;
+      data.checkin_reason = "checkin failed";
+    }
+  }
+
   return data;
 }
 
@@ -586,6 +649,39 @@ export async function getEvent({ code, supabaseUrl, supabaseKey }) {
   return data;
 }
 
+export async function updateEvent({ code, device_id, name, description, og_image, lat, lng, starts_at, ends_at, supabaseUrl, supabaseKey }) {
+  const sb = getClient(supabaseUrl, supabaseKey);
+  const { data, error } = await sb.rpc("update_event", {
+    p_code: code, p_device_id: device_id,
+    p_name: name || null, p_description: description || null,
+    p_og_image: og_image || null, p_lat: lat || null, p_lng: lng || null,
+    p_starts_at: starts_at || null, p_ends_at: ends_at || null,
+  });
+  if (error) throw new Error(error.message);
+  return data;
+}
+
+export async function approveParticipant({ code, device_id, ref, supabaseUrl, supabaseKey }) {
+  const sb = getClient(supabaseUrl, supabaseKey);
+  const { data, error } = await sb.rpc("approve_participant", { p_code: code, p_device_id: device_id, p_target_ref: ref });
+  if (error) throw new Error(error.message);
+  return data;
+}
+
+export async function rejectParticipant({ code, device_id, ref, supabaseUrl, supabaseKey }) {
+  const sb = getClient(supabaseUrl, supabaseKey);
+  const { data, error } = await sb.rpc("reject_participant", { p_code: code, p_device_id: device_id, p_target_ref: ref });
+  if (error) throw new Error(error.message);
+  return data;
+}
+
+export async function addCohost({ code, device_id, ref, supabaseUrl, supabaseKey }) {
+  const sb = getClient(supabaseUrl, supabaseKey);
+  const { data, error } = await sb.rpc("add_cohost", { p_code: code, p_device_id: device_id, p_target_ref: ref });
+  if (error) throw new Error(error.message);
+  return data;
+}
+
 export async function createBindToken({ device_id, purpose, event_code, supabaseUrl, supabaseKey }) {
   const sb = getClient(supabaseUrl, supabaseKey);
   const { data, error } = await sb.rpc("create_bind_token", {

package/lib/hermes-plugin/__init__.py

@@ -21,6 +21,10 @@ from .tools import (
     handle_event_end,
     handle_event_checkin,
     handle_event_upload_image,
+    handle_event_update,
+    handle_event_approve,
+    handle_event_reject,
+    handle_event_add_host,
     _sb,
     _device_id,
     _my_device_ids,
@@ -40,6 +44,10 @@ from .schemas import (
     EVENT_END_SCHEMA,
     EVENT_CHECKIN_SCHEMA,
     EVENT_UPLOAD_IMAGE_SCHEMA,
+    EVENT_UPDATE_SCHEMA,
+    EVENT_APPROVE_SCHEMA,
+    EVENT_REJECT_SCHEMA,
+    EVENT_ADD_HOST_SCHEMA,
 )
 import re
 import time
@@ -70,6 +78,10 @@ def register(ctx):
     ctx.register_tool("antenna_event_end", EVENT_END_SCHEMA, handle_event_end)
     ctx.register_tool("antenna_event_checkin", EVENT_CHECKIN_SCHEMA, handle_event_checkin)
     ctx.register_tool("antenna_event_upload_image", EVENT_UPLOAD_IMAGE_SCHEMA, handle_event_upload_image)
+    ctx.register_tool("antenna_event_update", EVENT_UPDATE_SCHEMA, handle_event_update)
+    ctx.register_tool("antenna_event_approve", EVENT_APPROVE_SCHEMA, handle_event_approve)
+    ctx.register_tool("antenna_event_reject", EVENT_REJECT_SCHEMA, handle_event_reject)
+    ctx.register_tool("antenna_event_add_host", EVENT_ADD_HOST_SCHEMA, handle_event_add_host)
 
     # ── Hook: auto-detect location + check web GPS events ─────────
     def on_pre_llm(messages, **kwargs):

package/lib/hermes-plugin/schemas.py

@@ -176,7 +176,7 @@ DISCOVER_SCHEMA = {
 EVENT_CREATE_SCHEMA = {
     "name": "antenna_event_create",
     "description": (
-        "Create an event. Returns a shareable link (antenna.fyi/e/CODE) "
+        "Create an event. Returns a shareable link (antenna.fyi/events/CODE) "
         "for participants to join. Optionally include a description and OG image URL."
     ),
     "parameters": {
@@ -191,6 +191,8 @@ EVENT_CREATE_SCHEMA = {
             "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"},
+            "requires_approval": {"type": "boolean", "description": "Require host approval to join (default false)"},
+            "screening_questions": {"type": "array", "items": {"type": "string"}, "description": "Screening questions for applicants"},
         },
         "required": ["name", "sender_id", "channel"],
     },
@@ -198,13 +200,16 @@ EVENT_CREATE_SCHEMA = {
 
 EVENT_JOIN_SCHEMA = {
     "name": "antenna_event_join",
-    "description": "Join an event by its code from the event URL.",
+    "description": "Join an event by its code from the event URL. Auto-checks in if event has started and you're within 1km.",
     "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, for auto-checkin)"},
+            "lng": {"type": "number", "description": "Longitude (optional, for auto-checkin)"},
+            "application_context": {"type": "string", "description": "Application context from screening conversation"},
         },
         "required": ["code", "sender_id", "channel"],
     },
@@ -267,3 +272,69 @@ EVENT_CHECKIN_SCHEMA = {
         "required": ["code", "sender_id", "channel"],
     },
 }
+
+EVENT_UPDATE_SCHEMA = {
+    "name": "antenna_event_update",
+    "description": "Update event info. Only creator or co-host can update.",
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "code": {"type": "string"},
+            "sender_id": {"type": "string"},
+            "channel": {"type": "string"},
+            "name": {"type": "string"},
+            "description": {"type": "string"},
+            "og_image": {"type": "string"},
+            "lat": {"type": "number"},
+            "lng": {"type": "number"},
+            "starts_at": {"type": "string"},
+            "ends_at": {"type": "string"},
+        },
+        "required": ["code", "sender_id", "channel"],
+    },
+}
+
+EVENT_APPROVE_SCHEMA = {
+    "name": "antenna_event_approve",
+    "description": "Approve a pending participant. Only creator or co-host.",
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "code": {"type": "string"},
+            "sender_id": {"type": "string"},
+            "channel": {"type": "string"},
+            "ref": {"type": "string"},
+        },
+        "required": ["code", "sender_id", "channel", "ref"],
+    },
+}
+
+EVENT_REJECT_SCHEMA = {
+    "name": "antenna_event_reject",
+    "description": "Reject a pending participant. Only creator or co-host.",
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "code": {"type": "string"},
+            "sender_id": {"type": "string"},
+            "channel": {"type": "string"},
+            "ref": {"type": "string"},
+        },
+        "required": ["code", "sender_id", "channel", "ref"],
+    },
+}
+
+EVENT_ADD_HOST_SCHEMA = {
+    "name": "antenna_event_add_host",
+    "description": "Add a co-host to the event. Only creator can add.",
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "code": {"type": "string"},
+            "sender_id": {"type": "string"},
+            "channel": {"type": "string"},
+            "ref": {"type": "string"},
+        },
+        "required": ["code", "sender_id", "channel", "ref"],
+    },
+}

package/lib/hermes-plugin/tools.py

@@ -383,6 +383,10 @@ def handle_event_create(params: dict) -> str:
         rpc_params["p_description"] = params["description"]
     if params.get("og_image"):
         rpc_params["p_og_image"] = params["og_image"]
+    if params.get("requires_approval"):
+        rpc_params["p_requires_approval"] = params["requires_approval"]
+    if params.get("screening_questions"):
+        rpc_params["p_screening_questions"] = params["screening_questions"]
 
     resp = sb.rpc("create_event", rpc_params).execute()
     data = resp.data or {}
@@ -392,8 +396,8 @@ def handle_event_create(params: dict) -> str:
         "created": True,
         "name": params["name"],
         "code": code,
-        "url": f"{BASE_URL}/e/{code}",
-        "message": f"活动已创建！分享链接给参加的人：{BASE_URL}/e/{code}",
+        "url": f"{BASE_URL}/events/{code}",
+        "message": f"活动已创建！分享链接给参加的人：{BASE_URL}/events/{code}",
     })
 
 
@@ -401,15 +405,81 @@ def handle_event_join(params: dict) -> str:
     sb = _sb()
     did = _device_id(params["sender_id"], params["channel"])
 
+    # Profile gate
+    prof = sb.rpc("get_profile", {"p_device_id": did}).execute()
+    if not prof.data:
+        return _ok({"joined": False, "error": "Create a profile first before joining events"})
+
+    lat = params.get("lat")
+    lng = params.get("lng")
+
+    # Auto-read profile location if not provided
+    if lat is None or lng is None:
+        try:
+            loc_resp = sb.rpc("get_profile_location", {"p_device_id": did}).execute()
+            loc = loc_resp.data if loc_resp.data else {}
+            if loc.get("found"):
+                lat = loc["lat"]
+                lng = loc["lng"]
+        except Exception:
+            pass
+
     resp = sb.rpc("join_event", {
         "p_device_id": did,
         "p_code": params["code"],
+        "p_lat": lat,
+        "p_lng": lng,
+        "p_application_context": params.get("application_context"),
     }).execute()
     data = resp.data or {}
 
-    if data.get("joined"):
-        return _ok({"joined": True, "name": data.get("name", ""), "message": f"已加入活动 \"{data.get('name', '')}\"！"})
-    return _ok({"joined": False, "error": data.get("error", "加入失败")})
+    if not data.get("joined"):
+        return _ok({"joined": False, "error": data.get("error", "加入失败")})
+
+    # Auto-checkin if event started and we have GPS
+    if lat is not None and lng is not None:
+        try:
+            evt_resp = sb.rpc("get_event", {"p_code": params["code"]}).execute()
+            evt = evt_resp.data or {}
+            import datetime
+            starts_at = evt.get("starts_at")
+            if starts_at:
+                # Parse ISO datetime
+                sa = datetime.datetime.fromisoformat(starts_at.replace("Z", "+00:00"))
+                now = datetime.datetime.now(datetime.timezone.utc)
+                if sa <= now:
+                    evt_lat = evt.get("lat")
+                    evt_lng = evt.get("lng")
+                    do_checkin = True
+                    if evt_lat is not None and evt_lng is not None:
+                        # Haversine distance
+                        R = 6371000
+                        d_lat = math.radians(evt_lat - lat)
+                        d_lng = math.radians(evt_lng - lng)
+                        a = math.sin(d_lat/2)**2 + math.cos(math.radians(lat))*math.cos(math.radians(evt_lat))*math.sin(d_lng/2)**2
+                        dist = R * 2 * math.atan2(math.sqrt(a), math.sqrt(1-a))
+                        if dist > 1000:
+                            do_checkin = False
+                            data["checked_in"] = False
+                            data["checkin_reason"] = "too far"
+                            data["distance_m"] = round(dist)
+                    if do_checkin:
+                        flat, flng = _fuzzy(lat, lng)
+                        sb.rpc("event_checkin", {
+                            "p_code": params["code"],
+                            "p_device_id": did,
+                            "p_lat": flat,
+                            "p_lng": flng,
+                        }).execute()
+                        data["checked_in"] = True
+                else:
+                    data["checked_in"] = False
+                    data["checkin_reason"] = "event not started yet"
+        except Exception:
+            data["checked_in"] = False
+            data["checkin_reason"] = "checkin failed"
+
+    return _ok(data)
 
 
 def handle_event_scan(params: dict) -> str:
@@ -522,3 +592,43 @@ def handle_event_checkin(params: dict) -> str:
         "p_lng": flng,
     }).execute()
     return _ok(resp.data or {})
+
+
+def handle_event_update(params: dict) -> str:
+    sb = _sb()
+    did = _device_id(params["sender_id"], params["channel"])
+    resp = sb.rpc("update_event", {
+        "p_code": params["code"], "p_device_id": did,
+        "p_name": params.get("name"), "p_description": params.get("description"),
+        "p_og_image": params.get("og_image"), "p_lat": params.get("lat"),
+        "p_lng": params.get("lng"), "p_starts_at": params.get("starts_at"),
+        "p_ends_at": params.get("ends_at"),
+    }).execute()
+    return _ok(resp.data or {"error": "update failed"})
+
+
+def handle_event_approve(params: dict) -> str:
+    sb = _sb()
+    did = _device_id(params["sender_id"], params["channel"])
+    resp = sb.rpc("approve_participant", {
+        "p_code": params["code"], "p_device_id": did, "p_target_ref": params["ref"],
+    }).execute()
+    return _ok(resp.data or {"error": "approve failed"})
+
+
+def handle_event_reject(params: dict) -> str:
+    sb = _sb()
+    did = _device_id(params["sender_id"], params["channel"])
+    resp = sb.rpc("reject_participant", {
+        "p_code": params["code"], "p_device_id": did, "p_target_ref": params["ref"],
+    }).execute()
+    return _ok(resp.data or {"error": "reject failed"})
+
+
+def handle_event_add_host(params: dict) -> str:
+    sb = _sb()
+    did = _device_id(params["sender_id"], params["channel"])
+    resp = sb.rpc("add_cohost", {
+        "p_code": params["code"], "p_device_id": did, "p_target_ref": params["ref"],
+    }).execute()
+    return _ok(resp.data or {"error": "add_cohost failed"})

package/lib/mcp.js

@@ -19,6 +19,10 @@ import {
   joinEvent,
   eventScan,
   uploadEventImage,
+  updateEvent,
+  approveParticipant,
+  rejectParticipant,
+  addCohost,
   deriveDeviceId,
 } from "./core.js";
 
@@ -270,7 +274,7 @@ export async function startMcpServer() {
 
   server.tool(
     "antenna_event_create",
-    "Create an event. Returns a shareable link (antenna.fyi/e/CODE) for participants to join.",
+    "Create an event. Returns a shareable link (antenna.fyi/events/CODE) for participants to join.",
     {
       name: z.string().describe("Event name"),
       sender_id: z.string().describe("Creator's user ID"),
@@ -281,10 +285,12 @@ export async function startMcpServer() {
       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"),
+      requires_approval: z.boolean().optional().describe("Require host approval to join (default false)"),
+      screening_questions: z.array(z.string()).optional().describe("Screening questions for applicants"),
     },
-    async ({ name, sender_id, channel, lat, lng, starts_at, ends_at, description, og_image }) => {
+    async ({ name, sender_id, channel, lat, lng, starts_at, ends_at, description, og_image, requires_approval, screening_questions }) => {
       try {
-        const result = await createEvent({ name, lat, lng, device_id: deriveDeviceId(sender_id, channel), starts_at, ends_at, description, og_image });
+        const result = await createEvent({ name, lat, lng, device_id: deriveDeviceId(sender_id, channel), starts_at, ends_at, description, og_image, requires_approval, screening_questions });
         return jsonResult(result);
       } catch (e) { return jsonResult({ error: e.message }); }
     }
@@ -330,15 +336,18 @@ export async function startMcpServer() {
 
   server.tool(
     "antenna_event_join",
-    "Join an event by its code. The code is from the event URL (antenna.fyi/e/CODE).",
+    "Join an event by its code. The code is from the event URL (antenna.fyi/events/CODE). Auto-checks in if the event has already started and you're within 1km.",
     {
       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, for auto-checkin)"),
+      lng: z.number().optional().describe("Longitude (optional, for auto-checkin)"),
+      application_context: z.string().optional().describe("Application context from screening conversation"),
     },
-    async ({ code, sender_id, channel }) => {
+    async ({ code, sender_id, channel, lat, lng, application_context }) => {
       try {
-        const result = await joinEvent({ code, device_id: deriveDeviceId(sender_id, channel) });
+        const result = await joinEvent({ code, device_id: deriveDeviceId(sender_id, channel), lat, lng, application_context });
         return jsonResult(result);
       } catch (e) { return jsonResult({ error: e.message }); }
     }
@@ -387,6 +396,88 @@ export async function startMcpServer() {
     }
   );
 
+  // ─── antenna_event_update ──────────────────────────────────
+
+  server.tool(
+    "antenna_event_update",
+    "Update event info. Only the creator or co-host can update.",
+    {
+      code: z.string().describe("Event code"),
+      sender_id: z.string().describe("The sender's user ID"),
+      channel: z.string().describe("Channel name"),
+      name: z.string().optional().describe("New event name"),
+      description: z.string().optional().describe("New event description"),
+      og_image: z.string().optional().describe("New OG image URL"),
+      lat: z.number().optional().describe("New event latitude"),
+      lng: z.number().optional().describe("New event longitude"),
+      starts_at: z.string().optional().describe("New start time ISO"),
+      ends_at: z.string().optional().describe("New end time ISO"),
+    },
+    async ({ code, sender_id, channel, name, description, og_image, lat, lng, starts_at, ends_at }) => {
+      try {
+        const result = await updateEvent({ code, device_id: deriveDeviceId(sender_id, channel), name, description, og_image, lat, lng, starts_at, ends_at });
+        return jsonResult(result);
+      } catch (e) { return jsonResult({ error: e.message }); }
+    }
+  );
+
+  // ─── antenna_event_approve ─────────────────────────────────
+
+  server.tool(
+    "antenna_event_approve",
+    "Approve a pending participant. Only the creator or co-host can approve.",
+    {
+      code: z.string().describe("Event code"),
+      sender_id: z.string().describe("The sender's user ID"),
+      channel: z.string().describe("Channel name"),
+      ref: z.string().describe("Ref number of the participant to approve"),
+    },
+    async ({ code, sender_id, channel, ref }) => {
+      try {
+        const result = await approveParticipant({ code, device_id: deriveDeviceId(sender_id, channel), ref });
+        return jsonResult(result);
+      } catch (e) { return jsonResult({ error: e.message }); }
+    }
+  );
+
+  // ─── antenna_event_reject ──────────────────────────────────
+
+  server.tool(
+    "antenna_event_reject",
+    "Reject a pending participant. Only the creator or co-host can reject.",
+    {
+      code: z.string().describe("Event code"),
+      sender_id: z.string().describe("The sender's user ID"),
+      channel: z.string().describe("Channel name"),
+      ref: z.string().describe("Ref number of the participant to reject"),
+    },
+    async ({ code, sender_id, channel, ref }) => {
+      try {
+        const result = await rejectParticipant({ code, device_id: deriveDeviceId(sender_id, channel), ref });
+        return jsonResult(result);
+      } catch (e) { return jsonResult({ error: e.message }); }
+    }
+  );
+
+  // ─── antenna_event_add_host ────────────────────────────────
+
+  server.tool(
+    "antenna_event_add_host",
+    "Add a co-host to an event. Only the creator can add co-hosts.",
+    {
+      code: z.string().describe("Event code"),
+      sender_id: z.string().describe("The sender's user ID"),
+      channel: z.string().describe("Channel name"),
+      ref: z.string().describe("Ref number of the participant to make co-host"),
+    },
+    async ({ code, sender_id, channel, ref }) => {
+      try {
+        const result = await addCohost({ code, device_id: deriveDeviceId(sender_id, channel), ref });
+        return jsonResult(result);
+      } catch (e) { return jsonResult({ error: e.message }); }
+    }
+  );
+
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }

package/package.json

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

package/skill/EVENTS.md

@@ -0,0 +1,96 @@
+---
+name: antenna-events
+description: "Antenna Event Mode — create events, manage participants, GPS check-in. Use when a user wants to create an event, join an event, check in, scan event participants, or manage event settings."
+tools:
+  - antenna_event_create
+  - antenna_event_join
+  - antenna_event_scan
+  - antenna_event_end
+  - antenna_event_checkin
+  - antenna_event_upload_image
+  - antenna_bind
+---
+
+# Antenna Event Mode
+
+Create real-world events where everyone's AI agent handles the networking.
+
+## Quick Start
+
+1. **Create**: `antenna_event_create(name, description)` → get shareable link
+2. **Share**: Send `antenna.fyi/events/CODE` to attendees
+3. **Join**: Attendees' agents call `antenna_event_join(code)`
+4. **Check in**: At the venue, `antenna_event_checkin(code)` — GPS verified ≤1km
+5. **Discover**: `antenna_event_scan(code)` — no distance limit inside events
+
+## Tools
+
+### `antenna_event_create`
+Create an event. Returns a shareable link (antenna.fyi/events/CODE).
+- `name`: event name
+- `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
+
+**GPS flow for events:** If the user doesn't provide coordinates, generate a bind link (`antenna_bind` with `purpose="event"` and `event_code`) and ask them to open it at the event location. The GPS will update the event's coordinates, NOT the user's profile.
+
+### `antenna_event_join`
+Join an event by code. Auto-checks in if event already started and user GPS is within 1km.
+- `code`: from the event URL (antenna.fyi/events/CODE)
+- `sender_id`, `channel`: from context
+- **Requires profile** — user must have a profile before joining
+- If event has started + user has GPS + within 1km → auto check-in
+
+### `antenna_event_scan`
+Scan people in an event. No distance limit — returns all participants.
+- `code`: event code
+- `sender_id`, `channel`: from context
+- Returns profiles with `checked_in` status and `role` (creator/participant)
+- Header shows "X joined, Y checked in"
+
+### `antenna_event_end`
+End an event. Only the creator can end it.
+- `code`: event code
+- `sender_id`, `channel`: from context
+
+### `antenna_event_checkin`
+Check in at an event — marks you as present at the event location.
+- `code`: event code
+- `sender_id`, `channel`: from context
+- `lat`, `lng`: optional GPS (auto-reads profile location if not provided)
+- GPS verified: must be within 1km of event location
+- Event must have GPS set for check-in to work
+
+### `antenna_event_upload_image`
+Upload an image for an event OG preview. Returns a public URL.
+- `image_base64`: base64-encoded image data
+- `content_type`: MIME type (default image/png)
+- `event_code`: event code
+
+### `antenna_bind` (for events)
+Generate a GPS link for setting event location.
+- `purpose`: set to `"event"`
+- `event_code`: the event code
+- GPS from this link writes to the event, not the user's profile
+
+## Agent Behavior
+
+### When someone says "create an event"
+1. Ask for event name (required) and description (optional)
+2. Call `antenna_event_create`
+3. If no GPS provided, call `antenna_bind(purpose="event", event_code=CODE)` and send the link
+4. Share the event URL with the user
+
+### When someone shares an event link
+1. Extract the code from `antenna.fyi/events/CODE`
+2. Call `antenna_event_join(code)` — this will auto-check in if applicable
+3. If join fails with "Create a profile first", guide profile creation then retry
+
+### When someone says "who's here" at an event
+1. Call `antenna_event_scan(code)`
+2. Analyze profiles against what you know about the user
+3. Recommend who they should meet and why
+4. Creator appears with organizer badge
+

package/skill/SKILL.md

@@ -73,6 +73,24 @@ Scan for nearby people **and events**. Returns raw profile cards + active events
 - `channel`: the channel name (telegram, whatsapp, discord, etc.)
 - Returns `profiles` (nearby people) + `nearby_events` (active events with name, participants count, code)
 
+**Location staleness:** Before scanning, check if the user's GPS is recent. If `last_seen_at` is older than 2 hours, prompt the user to update their location (`antenna_bind` or `antenna_checkin`). Stale GPS = wrong results.
+
+## GPS Logic
+
+**Profile GPS** — the user's location ("where am I")
+- Updated via `antenna_bind(purpose="profile")` or `antenna_checkin`
+- Fuzzy-hashed to ~150m for privacy
+- Used for: `antenna_scan` (nearby people/events), `antenna_event_checkin` (distance check)
+- Has `last_seen_at` timestamp. **Expires conceptually after 2h** — agent should prompt refresh
+
+**Event GPS** — the event's location ("where is the event")
+- Set via `antenna_bind(purpose="event")` or `antenna_event_create(lat, lng)`
+- Precise coordinates (NOT blurred)
+- Used for: check-in distance verification (≤1km), `nearby_events` discovery (5km)
+- Does not expire — event location is fixed
+
+**Relationship:** check-in = compare profile GPS vs event GPS. scan = use profile GPS to find nearby people + events.
+
 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
 - Compare each nearby person's three-line card against your understanding of the user
@@ -277,7 +295,7 @@ Plugin 自带后台服务，每 10 分钟轮询一次 Supabase 查新的 mutual
 用户不需要主动问，agent 会自动收到通知。
 
 ### `antenna_event_create`
-Create an event. Returns a shareable link (antenna.fyi/e/CODE).
+Create an event. Returns a shareable link (antenna.fyi/events/CODE).
 - `name`: event name
 - `sender_id`, `channel`: from context
 - `lat`, `lng`: optional event location
@@ -294,7 +312,7 @@ End an event. Only the creator can end it.
 
 ### `antenna_event_join`
 Join an event by code.
-- `code`: from the event URL (antenna.fyi/e/CODE)
+- `code`: from the event URL (antenna.fyi/events/CODE)
 - `sender_id`, `channel`: from context
 
 ### `antenna_event_scan`
@@ -314,3 +332,27 @@ Upload an image for an event OG preview. Returns a public URL.
 - `image_base64`: base64-encoded image data
 - `content_type`: MIME type (default image/png)
 - `event_code`: event code
+
+### `antenna_event_update`
+Update event info. Only creator or co-host can update.
+- `code`: event code
+- `sender_id`, `channel`: from context
+- `name`, `description`, `og_image`, `lat`, `lng`, `starts_at`, `ends_at`: all optional, only provided fields are updated
+
+### `antenna_event_approve`
+Approve a pending participant. Only creator or co-host.
+- `code`: event code
+- `sender_id`, `channel`: from context
+- `ref`: participant ref number from scan
+
+### `antenna_event_reject`
+Reject a pending participant. Only creator or co-host.
+- `code`: event code
+- `sender_id`, `channel`: from context
+- `ref`: participant ref number from scan
+
+### `antenna_event_add_host`
+Add a co-host to the event. Only creator can add.
+- `code`: event code
+- `sender_id`, `channel`: from context
+- `ref`: participant ref number to promote to co-host