squad-openclaw 2026.2.1816 → 2026.2.1901

package/dist/index.d.ts

@@ -3,7 +3,7 @@
  *
  * Provides:
  *   - In-memory entity registry with filesystem watching (entity_list, entity_search, entity_sync)
- *   - Filesystem tools for remote clients (fs_read, fs_write, fs_list)
+ *   - Filesystem tools for remote clients (fs_read, fs_write, fs_list, fs_delete)
  *   - Version check and self-update gateway methods (squad.version.*)
  *   - Cloud relay client for remote browser access (relay-client)
  */

package/dist/index.js

@@ -20,6 +20,20 @@ function debounced(key, fn) {
     }, DEBOUNCE_MS)
   );
 }
+var fsDebounceTimers = /* @__PURE__ */ new Map();
+var FS_DEBOUNCE_MS = 300;
+function debouncedFs(relPath, action, fn) {
+  const key = `fs:${action}:${relPath}`;
+  const existing = fsDebounceTimers.get(key);
+  if (existing) clearTimeout(existing);
+  fsDebounceTimers.set(
+    key,
+    setTimeout(() => {
+      fsDebounceTimers.delete(key);
+      fn();
+    }, FS_DEBOUNCE_MS)
+  );
+}
 function isWorkspaceIdentity(filePath, configDir) {
   const rel = path.relative(configDir, filePath);
   const match = rel.match(/^(workspace(?:-([^/]+))?)\/IDENTITY\.md$/);
@@ -126,7 +140,7 @@ function updatePlugin(pluginDirName, configDir) {
     registryDelete(`plugin:${pluginDirName}`);
   }
 }
-function startWatcher(configDir) {
+function startWatcher(configDir, onFsChange) {
   const watcher = chokidar.watch(configDir, {
     persistent: true,
     usePolling: false,
@@ -141,7 +155,15 @@ function startWatcher(configDir) {
       "**/data/**"
     ]
   });
-  const handleChange = (filePath) => {
+  const emitFsChange = (action, filePath) => {
+    if (!onFsChange) return;
+    const rel = path.relative(configDir, filePath);
+    debouncedFs(rel, action, () => {
+      onFsChange({ action, path: rel });
+    });
+  };
+  const handleChange = (filePath, action) => {
+    emitFsChange(action, filePath);
     const identity = isWorkspaceIdentity(filePath, configDir);
     if (identity) {
       debounced(
@@ -172,6 +194,7 @@ function startWatcher(configDir) {
     }
   };
   const handleAddDir = (dirPath) => {
+    emitFsChange("addDir", dirPath);
     const globalSkill = isGlobalSkillDir(dirPath, configDir);
     if (globalSkill) {
       debounced(
@@ -195,6 +218,7 @@ function startWatcher(configDir) {
     }
   };
   const handleUnlinkDir = (dirPath) => {
+    emitFsChange("unlinkDir", dirPath);
     const rel = path.relative(configDir, dirPath);
     const wsMatch = rel.match(/^workspace(?:-([^/]+))?$/);
     if (wsMatch) {
@@ -213,9 +237,9 @@ function startWatcher(configDir) {
       return;
     }
   };
-  watcher.on("add", handleChange);
-  watcher.on("change", handleChange);
-  watcher.on("unlink", handleChange);
+  watcher.on("add", (fp) => handleChange(fp, "add"));
+  watcher.on("change", (fp) => handleChange(fp, "change"));
+  watcher.on("unlink", (fp) => handleChange(fp, "unlink"));
   watcher.on("addDir", handleAddDir);
   watcher.on("unlinkDir", handleUnlinkDir);
   return () => {
@@ -223,6 +247,10 @@ function startWatcher(configDir) {
       clearTimeout(timer);
     }
     debounceTimers.clear();
+    for (const timer of fsDebounceTimers.values()) {
+      clearTimeout(timer);
+    }
+    fsDebounceTimers.clear();
     watcher.close();
   };
 }
@@ -500,7 +528,7 @@ function fullScan(configDir) {
   scanTools(configDir);
   scanMedia(configDir);
 }
-function registerEntityTools(api) {
+function registerEntityTools(api, onFsChange) {
   const configDir = process.env.HOME + "/.openclaw";
   api.registerTool({
     name: "entity_list",
@@ -576,7 +604,7 @@ function registerEntityTools(api) {
   }
   let stopWatcher = null;
   try {
-    stopWatcher = startWatcher(configDir);
+    stopWatcher = startWatcher(configDir, onFsChange);
   } catch (err2) {
     console.error("[squad-openclaw] Watcher failed to start:", err2);
   }
@@ -773,6 +801,69 @@ function registerFilesystemTools(api) {
       }
     }
   });
+  api.registerTool({
+    name: "fs_mkdir",
+    label: "Create Directory",
+    description: "Create a directory on the server filesystem. Creates parent directories as needed. Supports ~ for home directory expansion.",
+    parameters: {
+      type: "object",
+      properties: {
+        path: {
+          type: "string",
+          description: "Absolute or ~-prefixed path of the directory to create"
+        }
+      },
+      required: ["path"]
+    },
+    async execute(_id, params) {
+      try {
+        const targetPath = validatePath(params.path, allowedRoots);
+        fs3.mkdirSync(targetPath, { recursive: true });
+        return ok({
+          path: targetPath,
+          created: true
+        });
+      } catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return err(`fs_mkdir failed: ${msg}`);
+      }
+    }
+  });
+  api.registerTool({
+    name: "fs_delete",
+    label: "Delete File or Directory",
+    description: "Delete a file or directory from the server filesystem. For directories, removes recursively. Supports ~ for home directory expansion.",
+    parameters: {
+      type: "object",
+      properties: {
+        path: {
+          type: "string",
+          description: "Absolute or ~-prefixed path to the file or directory to delete"
+        }
+      },
+      required: ["path"]
+    },
+    async execute(_id, params) {
+      try {
+        const targetPath = validatePath(params.path, allowedRoots);
+        const stat = fs3.statSync(targetPath);
+        const wasDirectory = stat.isDirectory();
+        if (wasDirectory) {
+          fs3.rmSync(targetPath, { recursive: true });
+        } else {
+          fs3.unlinkSync(targetPath);
+        }
+        return ok({
+          path: targetPath,
+          deleted: true,
+          type: wasDirectory ? "directory" : "file"
+        });
+      } catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return err(`fs_delete failed: ${msg}`);
+      }
+    }
+  });
 }
 
 // src/version.ts
@@ -973,7 +1064,8 @@ function readOperatorToken() {
     return null;
   }
 }
-var RELAY_STATE_PATH = path5.join(os.homedir(), ".openclaw", "squad-relay.json");
+var RELAY_DATA_DIR = path5.join(os.homedir(), ".openclaw", "squad-ceo-data");
+var RELAY_STATE_PATH = path5.join(RELAY_DATA_DIR, "squad-relay.json");
 function readRelayState() {
   try {
     const raw = fs5.readFileSync(RELAY_STATE_PATH, "utf-8");
@@ -983,9 +1075,8 @@ function readRelayState() {
   }
 }
 function writeRelayState(state) {
-  const dir = path5.dirname(RELAY_STATE_PATH);
-  if (!fs5.existsSync(dir)) {
-    fs5.mkdirSync(dir, { recursive: true });
+  if (!fs5.existsSync(RELAY_DATA_DIR)) {
+    fs5.mkdirSync(RELAY_DATA_DIR, { recursive: true });
   }
   fs5.writeFileSync(RELAY_STATE_PATH, JSON.stringify(state, null, 2), { mode: 384 });
 }
@@ -1485,6 +1576,28 @@ var RelayClient = class {
     } catch {
     }
   }
+  /** Broadcast an event to all connected users, E2E encrypted per-user */
+  broadcastToUsers(event, payload) {
+    const msg = { type: "event", event, payload };
+    for (const [userId, conn] of this.userConnections) {
+      if (!conn.connectHandshakeComplete) continue;
+      let innerMsg = msg;
+      if (conn.e2e) {
+        try {
+          const encrypted = conn.e2e.encrypt(JSON.stringify(msg));
+          innerMsg = { _e2e: true, ...encrypted };
+        } catch (err2) {
+          console.error(`[relay-client] E2E encrypt error for broadcast to ${userId}:`, err2);
+          innerMsg = msg;
+        }
+      }
+      this.sendToRelay({
+        type: "relay.forward",
+        userId,
+        inner: innerMsg
+      });
+    }
+  }
 };
 var relayClient = null;
 function startRelayClient(api, relayUrl) {
@@ -1512,6 +1625,9 @@ function startRelayClient(api, relayUrl) {
   process.on("SIGTERM", cleanup);
   process.on("SIGINT", cleanup);
 }
+function broadcastToUsers(event, payload) {
+  relayClient?.broadcastToUsers(event, payload);
+}
 
 // src/index.ts
 function squadAppPlugin(api) {
@@ -1523,7 +1639,8 @@ function squadAppPlugin(api) {
     }
     return origRegisterTool(toolDef);
   };
-  registerEntityTools(api);
+  const onFsChange = (evt) => broadcastToUsers("fs.change", evt);
+  registerEntityTools(api, onFsChange);
   registerFilesystemTools(api);
   registerVersionMethods(api);
   api.registerGatewayMethod(

package/openclaw.plugin.json

@@ -9,7 +9,7 @@
       "fs.allowedRoots": {
         "type": "array",
         "items": { "type": "string" },
-        "description": "Restrict fs_read/fs_write/fs_list to these directories. Empty or omitted = allow all."
+        "description": "Restrict fs_read/fs_write/fs_list/fs_delete to these directories. Empty or omitted = allow all."
       },
       "relay.enabled": {
         "type": "boolean",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "squad-openclaw",
-  "version": "2026.2.1816",
+  "version": "2026.2.1901",
   "description": "Entity registry, filesystem tools, and version management plugin for OpenClaw gateway",
   "type": "module",
   "main": "./dist/index.js",