@yahaha-studio/focus-forwarder 0.0.1-alpha.16 → 0.0.1-alpha.17

package/index.ts

@@ -555,28 +555,26 @@ const plugin = {
 
     api.registerTool({
       name: "focus_join",
-      description: "Join Focus world with mateId, the current OpenClaw name, and a short self-description",
+      description: "Join Focus world with mateId, the current bot name, and a short bio",
       parameters: {
         type: "object",
         properties: {
           mateId: { type: "string", description: "Mate ID to join Focus world" },
-          openclawName: {
+          botName: {
             type: "string",
-            description: "Current OpenClaw name to include in the join message",
+            description: "Current bot name to include in the join message",
           },
-          openclawDescription: {
+          bio: {
             type: "string",
-            description: "Short self-description covering OpenClaw personality and role",
+            description: "Short bio covering OpenClaw personality and role",
           },
         },
-        required: ["openclawName", "openclawDescription"],
+        required: ["botName", "bio"],
       },
       execute: async (_toolCallId, params) => {
         let mateId = (params as { mateId?: string } | null)?.mateId;
-        const openclawName = (params as { openclawName?: string } | null)?.openclawName?.trim();
-        const openclawDescription = (
-          params as { openclawDescription?: string } | null
-        )?.openclawDescription?.trim();
+        const botName = (params as { botName?: string } | null)?.botName?.trim();
+        const bio = (params as { bio?: string } | null)?.bio?.trim();
         if (!mateId) {
           try {
             const identity = JSON.parse(fs.readFileSync(IDENTITY_PATH, "utf-8")) as {
@@ -589,13 +587,13 @@ const plugin = {
         if (!mateId) {
           return { success: false, error: "No mateId" };
         }
-        if (!openclawName) {
-          return { success: false, error: "No openclawName" };
+        if (!botName) {
+          return { success: false, error: "No botName" };
         }
-        if (!openclawDescription) {
-          return { success: false, error: "No openclawDescription" };
+        if (!bio) {
+          return { success: false, error: "No bio" };
         }
-        const result = await service?.join(mateId, openclawName, openclawDescription);
+        const result = await service?.join(mateId, botName, bio);
         return result ? { success: true, authKey: result } : { success: false, error: "Failed" };
       },
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yahaha-studio/focus-forwarder",
-  "version": "0.0.1-alpha.16",
+  "version": "0.0.1-alpha.17",
   "description": "Forward OpenClaw agent events to external WebSocket server for visualization",
   "type": "module",
   "main": "index.ts",

package/skills/focus-forwarder/SKILL.md

@@ -25,7 +25,7 @@ Before installing the plugin, save `mateId` to the `identity.json` file under th
 Then install and enable the plugin:
 
 ```bash
-openclaw plugins install @yahaha-studio/focus-forwarder@0.0.1-alpha.16
+openclaw plugins install @yahaha-studio/focus-forwarder@0.0.1-alpha.17
 openclaw plugins enable focus-forwarder
 ```
 
@@ -53,18 +53,21 @@ If the user wants recurring note board checks:
 
 ### focus_join
 
-Join Focus World with a `mateId`, your OpenClaw name, and a short self-description.
+Join Focus World with your agent identity.
 
 ```text
-focus_join(mateId: "your-mate-id", openclawName: "OpenClaw", openclawDescription: "A pragmatic coding agent focused on implementation and debugging")
+focus_join(mateId: "your-mate-id", botName: "<from IDENTITY.md>", bio: "<from SOUL.md>")
 ```
 
-Always include `openclawName` and `openclawDescription`.
+Parameters:
+- `mateId`: Focus World mate ID (optional if saved in `identity.json`)
+- `botName`: Read from your `IDENTITY.md` file
+- `bio`: Read from your `SOUL.md` file
 
-If `mateId` already exists in the home-directory `identity.json` file, you can call:
+If `mateId` exists in `identity.json`:
 
 ```text
-focus_join(openclawName: "OpenClaw", openclawDescription: "A pragmatic coding agent focused on implementation and debugging")
+focus_join(botName: "<from IDENTITY.md>", bio: "<from SOUL.md>")
 ```
 
 After a successful join, `identity.json` is updated to:

package/src/service.ts

@@ -57,19 +57,19 @@ export class FocusForwarderService {
 
   async join(
     mateId: string,
-    openclawName: string,
-    openclawDescription: string,
+    botName: string,
+    bio: string,
   ): Promise<string | null> {
     return new Promise((resolve) => {
       this.identity = { mateId };
       this.joinResolve = resolve;
       const sendJoin = () =>
-        this.ws?.send(JSON.stringify({ type: "join", mateId, openclawName, openclawDescription }));
+        this.ws?.send(JSON.stringify({ type: "join", mateId, botName, bio }));
       if (this.ws?.readyState === WebSocket.OPEN) {
         sendJoin();
       } else {
-        this.ws?.once("open", sendJoin);
-      }
+        this.ws?.once("open", sendJoin);
+      }
       setTimeout(() => { if (this.joinResolve) { this.joinResolve = null; resolve(null); } }, 10000);
     });
   }

package/src/types.ts

@@ -36,8 +36,8 @@ export type FocusErrorResult = {
 export type JoinPayload = {
   type: "join";
   mateId: string;
-  openclawName: string;
-  openclawDescription: string;
+  botName: string;
+  bio: string;
 };
 
 export type JoinAckPayload = {