@firstperson/firstperson 2026.1.37 → 2026.1.39

package/.claude/settings.local.json

@@ -11,7 +11,10 @@
       "Bash(npm run build:*)",
       "Bash(npx tsc:*)",
       "Bash(npm run:*)",
-      "Bash(npm test:*)"
+      "Bash(npm test:*)",
+      "Bash(npm version:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)"
     ]
   }
 }

package/index.ts

@@ -1,9 +1,19 @@
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
 import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
+import { Type } from "@sinclair/typebox";
 
 import { firstPersonPlugin } from "./src/channel.js";
 import { setFirstPersonRuntime } from "./src/runtime.js";
 
+// TypeBox schemas for profile tools
+const UpdateProfileSchema = Type.Object({
+  name: Type.String({ description: "Your display name (1-50 characters, required)" }),
+  bio: Type.Optional(Type.String({ description: "A short bio or description (up to 160 characters)" })),
+  avatar_url: Type.Optional(Type.String({ description: "HTTPS URL to your avatar image" })),
+});
+
+const GetProfileSchema = Type.Object({});
+
 const plugin = {
   id: "firstperson",
   name: "First Person",
@@ -12,6 +22,79 @@ const plugin = {
   register(api: OpenClawPluginApi) {
     setFirstPersonRuntime(api.runtime);
     api.registerChannel({ plugin: firstPersonPlugin });
+
+    // Profile management tools for bot agency
+    api.registerTool((ctx) => {
+      const channelConfig = ctx.config?.channels?.firstperson as { token?: string; relayUrl?: string } | undefined;
+      const relayToken = channelConfig?.token;
+      const relayUrl = channelConfig?.relayUrl ?? "https://chat.firstperson.ai";
+
+      if (!relayToken) {
+        return null; // Tool not available without token
+      }
+
+      return {
+        name: "firstperson_update_profile",
+        description: "Update your profile on the First Person app. Use this to set or change your display name, bio, or avatar that users see in the iOS app.",
+        parameters: UpdateProfileSchema,
+        execute: async (_toolCallId: string, args: { name: string; bio?: string; avatar_url?: string }) => {
+          const { name, bio = "", avatar_url = "" } = args;
+
+          const res = await fetch(`${relayUrl}/api/v1/profile`, {
+            method: "PUT",
+            headers: {
+              Authorization: `Bearer ${relayToken}`,
+              "Content-Type": "application/json",
+            },
+            body: JSON.stringify({ name, bio, avatar_url }),
+          });
+
+          if (!res.ok) {
+            const errorText = await res.text().catch(() => "Unknown error");
+            return { success: false, error: `Failed to update profile: ${res.status} - ${errorText}` };
+          }
+
+          const data = await res.json();
+          return { success: true, profile: data.profile };
+        },
+      };
+    }, { name: "firstperson_update_profile" });
+
+    api.registerTool((ctx) => {
+      const channelConfig = ctx.config?.channels?.firstperson as { token?: string; relayUrl?: string } | undefined;
+      const relayToken = channelConfig?.token;
+      const relayUrl = channelConfig?.relayUrl ?? "https://chat.firstperson.ai";
+
+      if (!relayToken) {
+        return null; // Tool not available without token
+      }
+
+      return {
+        name: "firstperson_get_profile",
+        description: "Get your current profile from the First Person app. Use this to check what name, bio, and avatar users currently see.",
+        parameters: GetProfileSchema,
+        execute: async () => {
+          const res = await fetch(`${relayUrl}/api/v1/profile`, {
+            method: "GET",
+            headers: {
+              Authorization: `Bearer ${relayToken}`,
+              "Content-Type": "application/json",
+            },
+          });
+
+          if (!res.ok) {
+            if (res.status === 404) {
+              return { success: true, profile: null, message: "No profile set yet" };
+            }
+            const errorText = await res.text().catch(() => "Unknown error");
+            return { success: false, error: `Failed to get profile: ${res.status} - ${errorText}` };
+          }
+
+          const data = await res.json();
+          return { success: true, profile: data.profile };
+        },
+      };
+    }, { name: "firstperson_get_profile" });
   },
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@firstperson/firstperson",
-  "version": "2026.1.37",
+  "version": "2026.1.39",
   "type": "module",
   "description": "OpenClaw channel plugin for the First Person iOS app",
   "main": "index.ts",
@@ -39,6 +39,7 @@
     }
   },
   "dependencies": {
+    "@sinclair/typebox": "^0.34.0",
     "ws": "^8.16.0",
     "zod": "^4.0.0"
   },

package/src/channel.ts

@@ -318,7 +318,7 @@ export const firstPersonPlugin: ChannelPlugin<ResolvedFirstPersonAccount> = {
         lastError: null,
       });
 
-      const { startRelayConnection, sendStatusUpdate, pushProfileToRelay } = await import("./relay-client.js");
+      const { startRelayConnection, sendStatusUpdate } = await import("./relay-client.js");
 
       return startRelayConnection({
         relayUrl: account.relayUrl,
@@ -335,22 +335,6 @@ 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({

package/src/relay-client.ts

@@ -1,62 +1,5 @@
 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;