antenna-openclaw-plugin 1.2.11 → 1.2.12

package/index.ts

@@ -640,7 +640,7 @@ export default function register(api: any) {
   // ═══════════════════════════════════════════════════════════════════
   api.registerTool({
     name: "antenna_event_create",
-    description: "Create an event. Returns a shareable link (antenna.fyi/e/CODE) for participants to join.",
+    description: "Create an event. Returns a shareable link (antenna.fyi/events/CODE) for participants to join.",
     parameters: {
       type: "object",
       properties: {
@@ -653,6 +653,8 @@ export default function register(api: any) {
         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"],
     },
@@ -669,6 +671,8 @@ export default function register(api: any) {
         p_ends_at: params.ends_at || new Date(Date.now() + 12*60*60*1000).toISOString(),
         p_description: params.description || null,
         p_og_image: params.og_image || null,
+        p_requires_approval: params.requires_approval || false,
+        p_screening_questions: params.screening_questions || null,
       });
       if (error) return ok({ error: error.message });
       return ok(data);
@@ -708,13 +712,16 @@ export default function register(api: any) {
   // ═══════════════════════════════════════════════════════════════════
   api.registerTool({
     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" },
         channel: { type: "string" },
+        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"],
     },
@@ -722,8 +729,64 @@ export default function register(api: any) {
       const cfg = getConfig(api);
       const supabase = getSupabase(cfg);
       const deviceId = deriveDeviceId(params.sender_id, params.channel);
-      const { data, error } = await supabase.rpc("join_event", { p_code: params.code, p_device_id: deviceId });
+
+      // Profile gate
+      const { data: profile } = await supabase.rpc("get_profile", { p_device_id: deviceId });
+      if (!profile) {
+        return ok({ joined: false, error: "Create a profile first before joining events" });
+      }
+
+      let lat = params.lat;
+      let lng = params.lng;
+
+      // Auto-read profile location if not provided
+      if (lat == null || lng == null) {
+        try {
+          const { data: loc } = await supabase.rpc("get_profile_location", { p_device_id: deviceId });
+          if (loc?.found) { lat = loc.lat; lng = loc.lng; }
+        } catch {}
+      }
+
+      const { data, error } = await supabase.rpc("join_event", { p_code: params.code, p_device_id: deviceId, p_application_context: params.application_context || null });
       if (error) return ok({ error: error.message });
+      if (!data?.joined) return ok(data);
+
+      // Auto-checkin if event started and we have GPS
+      if (lat != null && lng != null) {
+        try {
+          const { data: evt } = await supabase.rpc("get_event", { p_code: params.code });
+          const startsAt = evt?.starts_at ? new Date(evt.starts_at) : null;
+          if (startsAt && startsAt <= new Date()) {
+            if (evt.lat != null && evt.lng != null) {
+              const R = 6371000;
+              const dLat = (evt.lat - lat) * Math.PI / 180;
+              const dLng = (evt.lng - lng) * Math.PI / 180;
+              const a = Math.sin(dLat/2)**2 + Math.cos(lat*Math.PI/180)*Math.cos(evt.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) {
+                const fuzzy = fuzzyCoords(lat, lng);
+                await supabase.rpc("event_checkin", { p_code: params.code, p_device_id: deviceId, p_lat: fuzzy.lat, p_lng: fuzzy.lng });
+                data.checked_in = true;
+              } else {
+                data.checked_in = false;
+                data.checkin_reason = "too far";
+                data.distance_m = Math.round(dist);
+              }
+            } else {
+              const fuzzy = fuzzyCoords(lat, lng);
+              await supabase.rpc("event_checkin", { p_code: params.code, p_device_id: deviceId, p_lat: fuzzy.lat, p_lng: fuzzy.lng });
+              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 ok(data);
     },
   });
@@ -943,6 +1006,127 @@ export default function register(api: any) {
     },
   });
 
+  // ═══════════════════════════════════════════════════════════════════
+  // Tool: antenna_event_update
+  // ═══════════════════════════════════════════════════════════════════
+  api.registerTool({
+    name: "antenna_event_update",
+    description: "Update event info. Only the creator or co-host can update.",
+    parameters: {
+      type: "object",
+      properties: {
+        code: { type: "string", description: "Event code" },
+        sender_id: { type: "string" },
+        channel: { type: "string" },
+        name: { type: "string", description: "New event name" },
+        description: { type: "string", description: "New event description" },
+        og_image: { type: "string", description: "New OG image URL" },
+        lat: { type: "number", description: "New event latitude" },
+        lng: { type: "number", description: "New event longitude" },
+        starts_at: { type: "string", description: "New start time ISO" },
+        ends_at: { type: "string", description: "New end time ISO" },
+      },
+      required: ["code", "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 { data, error } = await supabase.rpc("update_event", {
+        p_code: params.code, p_device_id: deviceId,
+        p_name: params.name || null, p_description: params.description || null,
+        p_og_image: params.og_image || null, p_lat: params.lat || null, p_lng: params.lng || null,
+        p_starts_at: params.starts_at || null, p_ends_at: params.ends_at || null,
+      });
+      if (error) return ok({ error: error.message });
+      return ok(data);
+    },
+  });
+
+  // ═══════════════════════════════════════════════════════════════════
+  // Tool: antenna_event_approve
+  // ═══════════════════════════════════════════════════════════════════
+  api.registerTool({
+    name: "antenna_event_approve",
+    description: "Approve a pending participant. Only the creator or co-host can approve.",
+    parameters: {
+      type: "object",
+      properties: {
+        code: { type: "string", description: "Event code" },
+        sender_id: { type: "string" },
+        channel: { type: "string" },
+        ref: { type: "string", description: "Ref number of the participant to approve" },
+      },
+      required: ["code", "sender_id", "channel", "ref"],
+    },
+    async execute(_id: string, params: any) {
+      const cfg = getConfig(api);
+      const supabase = getSupabase(cfg);
+      const deviceId = deriveDeviceId(params.sender_id, params.channel);
+      const { data, error } = await supabase.rpc("approve_participant", {
+        p_code: params.code, p_device_id: deviceId, p_target_ref: params.ref,
+      });
+      if (error) return ok({ error: error.message });
+      return ok(data);
+    },
+  });
+
+  // ═══════════════════════════════════════════════════════════════════
+  // Tool: antenna_event_reject
+  // ═══════════════════════════════════════════════════════════════════
+  api.registerTool({
+    name: "antenna_event_reject",
+    description: "Reject a pending participant. Only the creator or co-host can reject.",
+    parameters: {
+      type: "object",
+      properties: {
+        code: { type: "string", description: "Event code" },
+        sender_id: { type: "string" },
+        channel: { type: "string" },
+        ref: { type: "string", description: "Ref number of the participant to reject" },
+      },
+      required: ["code", "sender_id", "channel", "ref"],
+    },
+    async execute(_id: string, params: any) {
+      const cfg = getConfig(api);
+      const supabase = getSupabase(cfg);
+      const deviceId = deriveDeviceId(params.sender_id, params.channel);
+      const { data, error } = await supabase.rpc("reject_participant", {
+        p_code: params.code, p_device_id: deviceId, p_target_ref: params.ref,
+      });
+      if (error) return ok({ error: error.message });
+      return ok(data);
+    },
+  });
+
+  // ═══════════════════════════════════════════════════════════════════
+  // Tool: antenna_event_add_host
+  // ═══════════════════════════════════════════════════════════════════
+  api.registerTool({
+    name: "antenna_event_add_host",
+    description: "Add a co-host to an event. Only the creator can add co-hosts.",
+    parameters: {
+      type: "object",
+      properties: {
+        code: { type: "string", description: "Event code" },
+        sender_id: { type: "string" },
+        channel: { type: "string" },
+        ref: { type: "string", description: "Ref number of the participant to make co-host" },
+      },
+      required: ["code", "sender_id", "channel", "ref"],
+    },
+    async execute(_id: string, params: any) {
+      const cfg = getConfig(api);
+      const supabase = getSupabase(cfg);
+      const deviceId = deriveDeviceId(params.sender_id, params.channel);
+      const { data, error } = await supabase.rpc("add_cohost", {
+        p_code: params.code, p_device_id: deviceId, p_target_ref: params.ref,
+      });
+      if (error) return ok({ error: error.message });
+      return ok(data);
+    },
+  });
+
   // ═══════════════════════════════════════════════════════════════════
   // Service: poll for new matches every 10 minutes → notify instantly
   // ═══════════════════════════════════════════════════════════════════

package/package.json

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

package/skills/antenna/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/skills/antenna/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