@firstperson/firstperson 2026.1.35 → 2026.1.37

package/.claude/settings.local.json

@@ -10,7 +10,8 @@
       "Bash(npm install:*)",
       "Bash(npm run build:*)",
       "Bash(npx tsc:*)",
-      "Bash(npm run:*)"
+      "Bash(npm run:*)",
+      "Bash(npm test:*)"
     ]
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@firstperson/firstperson",
-  "version": "2026.1.35",
+  "version": "2026.1.37",
   "type": "module",
   "description": "OpenClaw channel plugin for the First Person iOS app",
   "main": "index.ts",

package/src/channel.ts

@@ -14,6 +14,30 @@ import type { FirstPersonConfig, ResolvedFirstPersonAccount, CoreConfig } from "
 
 const DEFAULT_RELAY_URL = "wss://chat.firstperson.ai";
 
+// Dedupe cache to track recently processed messages (20-minute window matches OpenClaw)
+const DEDUPE_WINDOW_MS = 20 * 60 * 1000; // 20 minutes
+const processedMessages = new Map<string, number>(); // messageId -> timestamp
+
+function isDuplicateMessage(messageId: string): boolean {
+  const now = Date.now();
+
+  // Clean up old entries
+  for (const [id, timestamp] of processedMessages) {
+    if (now - timestamp > DEDUPE_WINDOW_MS) {
+      processedMessages.delete(id);
+    }
+  }
+
+  // Check if this message was already processed
+  if (processedMessages.has(messageId)) {
+    return true;
+  }
+
+  // Mark as processed
+  processedMessages.set(messageId, now);
+  return false;
+}
+
 const meta = {
   id: "firstperson",
   label: "First Person",
@@ -294,7 +318,7 @@ export const firstPersonPlugin: ChannelPlugin<ResolvedFirstPersonAccount> = {
         lastError: null,
       });
 
-      const { startRelayConnection, sendStatusUpdate } = await import("./relay-client.js");
+      const { startRelayConnection, sendStatusUpdate, pushProfileToRelay } = await import("./relay-client.js");
 
       return startRelayConnection({
         relayUrl: account.relayUrl,
@@ -311,6 +335,22 @@ export const firstPersonPlugin: ChannelPlugin<ResolvedFirstPersonAccount> = {
             lastError: null,
           });
           log?.info(`[firstperson:${account.accountId}] relay connected`);
+
+          // Push agent profile to relay on connection
+          const globalRuntime = getFirstPersonRuntime();
+          const identity = (globalRuntime as any).agent?.identity?.get?.();
+          if (identity) {
+            pushProfileToRelay({
+              relayUrl: account.relayUrl,
+              token: account.token!,
+              identity,
+              log,
+            }).catch((err) => {
+              log?.warn(`[firstperson:${account.accountId}] profile push failed: ${err.message}`);
+            });
+          } else {
+            log?.info(`[firstperson:${account.accountId}] no agent identity available, skipping profile push`);
+          }
         },
         onDisconnected: (error) => {
           setStatus({
@@ -325,6 +365,20 @@ export const firstPersonPlugin: ChannelPlugin<ResolvedFirstPersonAccount> = {
         onMessage: async (message) => {
           log?.info(`[fp] 1. received: ${message.messageId} from ${message.deviceId}`);
 
+          // Check for duplicate message (dedupe within 20-minute window)
+          if (isDuplicateMessage(message.messageId)) {
+            log?.info(`[fp] skipping duplicate message: ${message.messageId}`);
+            // Send "skipped" status instead of processing
+            sendStatusUpdate({
+              to: message.deviceId,
+              messageId: message.messageId,
+              status: "completed", // Use completed but with skip indication in details
+              message: "Message already processed (duplicate)",
+              details: { skipped: true, reason: "duplicate" },
+            });
+            return;
+          }
+
           // Track timing for status updates
           const dispatchStartTime = Date.now();
 

package/src/relay-client.ts

@@ -1,5 +1,62 @@
 import WebSocket from "ws";
 
+/**
+ * Agent identity from OpenClaw runtime
+ */
+export interface AgentIdentity {
+  agentId: string;
+  name?: string;
+  avatar?: string;
+}
+
+/**
+ * Push the agent's profile to the relay.
+ * Called on startup after relay connection is established.
+ */
+export async function pushProfileToRelay(params: {
+  relayUrl: string;
+  token: string;
+  identity: AgentIdentity;
+  log?: Logger;
+}): Promise<void> {
+  const { relayUrl, token, identity, log } = params;
+
+  // Convert WebSocket URL to HTTP URL for API call
+  const httpUrl = relayUrl.replace(/^wss:\/\//, "https://").replace(/^ws:\/\//, "http://");
+  const profileUrl = `${httpUrl}/api/v1/profile`;
+
+  // Map OpenClaw identity to relay profile format
+  // Only include avatar_url if it's actually an HTTPS URL (relay validates this)
+  const avatarUrl = identity.avatar?.startsWith("https://") ? identity.avatar : "";
+
+  const profile = {
+    name: identity.name ?? identity.agentId,
+    bio: "",
+    avatar_url: avatarUrl,
+  };
+
+  try {
+    const response = await fetch(profileUrl, {
+      method: "PUT",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${token}`,
+      },
+      body: JSON.stringify(profile),
+    });
+
+    if (!response.ok) {
+      const errorText = await response.text().catch(() => "unknown error");
+      log?.warn(`[relay-client] Failed to push profile: ${response.status} ${errorText}`);
+      return;
+    }
+
+    log?.info(`[relay-client] Profile pushed to relay: ${profile.name}`);
+  } catch (err) {
+    log?.warn(`[relay-client] Failed to push profile: ${(err as Error).message}`);
+  }
+}
+
 export interface Logger {
   info: (msg: string) => void;
   warn: (msg: string) => void;