@integrity-labs/agt-cli 0.15.7 → 0.15.9

package/dist/lib/manager-worker.js

@@ -22,7 +22,7 @@ import {
   resolveChannels,
   resolveDmTarget,
   wrapScheduledTaskPrompt
-} from "../chunk-WIW5FIRY.js";
+} from "../chunk-C6UBNLUC.js";
 import {
   findTaskByTemplate,
   getProjectDir,
@@ -46,11 +46,11 @@ import {
 
 // src/lib/manager-worker.ts
 import { createHash } from "crypto";
-import { readFileSync, writeFileSync, appendFileSync, mkdirSync, chmodSync, existsSync, rmSync, readdirSync, statSync, unlinkSync, copyFileSync } from "fs";
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, appendFileSync, mkdirSync as mkdirSync2, chmodSync, existsSync as existsSync2, rmSync as rmSync2, readdirSync as readdirSync2, statSync, unlinkSync, copyFileSync } from "fs";
 import https from "https";
 import { execFileSync as syncExecFile } from "child_process";
-import { join as join2, dirname } from "path";
-import { homedir as homedir2 } from "os";
+import { join as join3, dirname } from "path";
+import { homedir as homedir3 } from "os";
 import { fileURLToPath } from "url";
 
 // src/lib/plugin-context-render.ts
@@ -896,6 +896,135 @@ function withScheduleLinkFooter(opts) {
   return appendScheduleLinkFooter(opts.body, url, opts.medium);
 }
 
+// src/lib/restart-flags.ts
+import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "fs";
+import { homedir as homedir2 } from "os";
+import { join as join2 } from "path";
+import { randomUUID } from "crypto";
+function restartFlagsDir() {
+  return join2(homedir2(), ".augmented", "restart-flags");
+}
+function flagPath(codeName) {
+  return join2(restartFlagsDir(), `${codeName}.flag`);
+}
+function readRestartFlags() {
+  const dir = restartFlagsDir();
+  if (!existsSync(dir)) return [];
+  const out = [];
+  for (const entry of readdirSync(dir)) {
+    if (!entry.endsWith(".flag")) continue;
+    try {
+      const raw = readFileSync(join2(dir, entry), "utf8");
+      const parsed = JSON.parse(raw);
+      if (typeof parsed.codeName !== "string" || parsed.codeName.length === 0) {
+        parsed.codeName = entry.replace(/\.flag$/, "");
+      }
+      out.push(parsed);
+    } catch {
+      out.push({
+        codeName: entry.replace(/\.flag$/, ""),
+        source: "unknown",
+        ts: Date.now()
+      });
+    }
+  }
+  return out;
+}
+function deleteRestartFlag(codeName) {
+  const path = flagPath(codeName);
+  if (existsSync(path)) {
+    rmSync(path, { force: true });
+  }
+}
+
+// src/lib/restart-handler.ts
+async function processRestartFlags(opts) {
+  const flags = readRestartFlags();
+  if (flags.length === 0) return;
+  for (const flag of flags) {
+    try {
+      await processOne(flag, opts);
+    } catch (err) {
+      opts.log(`[restart-handler] Failed to process flag for '${flag.codeName}': ${err.message}`);
+      try {
+        await sendError(flag, opts, `\u274C Restart failed for \`${flag.codeName}\`: internal error. Check manager logs.`);
+      } catch (ackErr) {
+        opts.log(`[restart-handler] Error-ack send failed for '${flag.codeName}': ${ackErr.message}`);
+      }
+    } finally {
+      try {
+        deleteRestartFlag(flag.codeName);
+      } catch (err) {
+        opts.log(`[restart-handler] Failed to delete flag for '${flag.codeName}': ${err.message}`);
+      }
+    }
+  }
+}
+async function processOne(flag, opts) {
+  const framework = opts.resolveFramework(flag.codeName);
+  if (framework === null) {
+    opts.log(`[restart-handler] Ignoring /restart for unknown agent '${flag.codeName}'`);
+    await sendError(flag, opts, `Agent \`${flag.codeName}\` is not managed by this host.`);
+    return;
+  }
+  if (framework !== "claude-code") {
+    opts.log(`[restart-handler] Ignoring /restart for '${flag.codeName}' \u2014 framework is '${framework}', not claude-code`);
+    await sendError(flag, opts, `\`/restart\` is only supported for Claude Code agents (this agent runs on \`${framework}\`).`);
+    return;
+  }
+  opts.log(`[restart-handler] Restarting tmux session for '${flag.codeName}' (source: ${flag.source})`);
+  opts.stopSession(flag.codeName);
+  await sendAck(flag, opts, `\u{1F504} Restart initiated for \`${flag.codeName}\` \u2014 the replacement session is being created.`);
+}
+async function sendAck(flag, opts, text) {
+  if (flag.source === "telegram") {
+    const tokens = opts.getTelegramTokens(flag.codeName);
+    if (!tokens) {
+      opts.log(`[restart-handler] No telegram tokens cached for '${flag.codeName}' \u2014 skipping ack`);
+      return;
+    }
+    const chatId = flag.reply?.["chat_id"];
+    if (chatId == null) return;
+    const messageId = flag.reply?.["message_id"];
+    const body = { chat_id: chatId, text, parse_mode: "Markdown" };
+    if (messageId != null) body.reply_to_message_id = Number(messageId);
+    try {
+      const resp = await opts.sendTelegram(tokens.token, "sendMessage", body);
+      if (!resp.ok) {
+        opts.log(`[restart-handler] Telegram ack failed for '${flag.codeName}': ${resp.description ?? "unknown"}`);
+      }
+    } catch (err) {
+      opts.log(`[restart-handler] Telegram ack threw for '${flag.codeName}': ${err.message}`);
+    }
+    return;
+  }
+  if (flag.source === "slack") {
+    const token = opts.getSlackToken(flag.codeName);
+    if (!token) {
+      opts.log(`[restart-handler] No slack token cached for '${flag.codeName}' \u2014 skipping ack`);
+      return;
+    }
+    const channel = flag.reply?.["channel"];
+    if (channel == null) return;
+    const threadTs = flag.reply?.["thread_ts"];
+    const body = { channel, text };
+    if (threadTs != null) body.thread_ts = String(threadTs);
+    try {
+      const resp = await opts.sendSlack(token, body);
+      if (!resp.ok) {
+        opts.log(`[restart-handler] Slack ack failed for '${flag.codeName}': ${resp.error ?? "unknown"}`);
+      }
+    } catch (err) {
+      opts.log(`[restart-handler] Slack ack threw for '${flag.codeName}': ${err.message}`);
+    }
+    return;
+  }
+  opts.log(`[restart-handler] Unknown ack source '${flag.source}' for '${flag.codeName}' \u2014 skipping`);
+}
+async function sendError(flag, opts, text) {
+  await sendAck(flag, opts, text);
+}
+
 // src/lib/realtime-chat.ts
 import { createClient } from "@supabase/supabase-js";
 var client = null;
@@ -1220,8 +1349,8 @@ function stopRealtimeChat() {
 var GATEWAY_PORT_BASE = 18800;
 var GATEWAY_PORT_STEP = 10;
 var GATEWAY_PORT_MAX = 18899;
-var AUGMENTED_DIR = join2(process.env["HOME"] ?? "/tmp", ".augmented");
-var GATEWAY_PORTS_FILE = join2(AUGMENTED_DIR, "gateway-ports.json");
+var AUGMENTED_DIR = join3(process.env["HOME"] ?? "/tmp", ".augmented");
+var GATEWAY_PORTS_FILE = join3(AUGMENTED_DIR, "gateway-ports.json");
 var CHANNEL_SWEEP_INTERVAL_MS = (() => {
   const raw = parseInt(process.env["AGT_CHANNEL_SWEEP_INTERVAL_MS"] ?? "", 10);
   if (!Number.isFinite(raw)) return 5 * 60 * 1e3;
@@ -1313,7 +1442,7 @@ function resolveBrewPath(execFileSync2) {
   } catch {
   }
   const fallback = "/home/linuxbrew/.linuxbrew/bin/brew";
-  if (existsSync(fallback)) return fallback;
+  if (existsSync2(fallback)) return fallback;
   return null;
 }
 var toolkitCliEnsured = /* @__PURE__ */ new Set();
@@ -1459,7 +1588,7 @@ async function ensureFrameworkBinary(frameworkId) {
     }
     return runAsync(brewPath, args, opts);
   };
-  let claudeExists = existsSync("/home/linuxbrew/.linuxbrew/bin/claude");
+  let claudeExists = existsSync2("/home/linuxbrew/.linuxbrew/bin/claude");
   if (!claudeExists) {
     try {
       execFileSync2("which", ["claude"], { timeout: 5e3 });
@@ -1483,7 +1612,7 @@ async function ensureFrameworkBinary(frameworkId) {
     if (!process.env.PATH?.split(":").includes(brewBinDir)) {
       process.env.PATH = `${brewBinDir}:${process.env.PATH ?? ""}`;
     }
-    if (existsSync("/home/linuxbrew/.linuxbrew/bin/claude")) {
+    if (existsSync2("/home/linuxbrew/.linuxbrew/bin/claude")) {
       log("Claude Code installed successfully");
     } else {
       log("Claude Code install completed but binary not found at expected path \u2014 check brew logs");
@@ -1518,9 +1647,9 @@ async function checkAndUpdateCli() {
   const isDevMode = cliPath.includes("/src/") || cliPath.includes("tsx");
   if (isDevMode) return;
   if (!isHomebrew && !cliPath.includes("node_modules")) return;
-  const { homedir: homedir3 } = await import("os");
+  const { homedir: homedir4 } = await import("os");
   const { readFileSync: readF, writeFileSync: writeF } = await import("fs");
-  const markerPath = join2(homedir3(), ".augmented", ".last-update-check");
+  const markerPath = join3(homedir4(), ".augmented", ".last-update-check");
   try {
     const lastCheck = parseInt(readF(markerPath, "utf-8").trim(), 10);
     if (Date.now() - lastCheck < UPDATE_CHECK_INTERVAL_MS) return;
@@ -1603,12 +1732,12 @@ async function applyClaudeAuthToEnv(childEnv, label) {
       throw new Error("claude_auth_mode=api_key but /host/exchange returned no decrypted key");
     }
     childEnv.ANTHROPIC_API_KEY = exchange.anthropicApiKey;
-    const claudeDir = join2(homedir2(), ".claude");
+    const claudeDir = join3(homedir3(), ".claude");
     for (const filename of [".credentials.json", "credentials.json"]) {
-      const p = join2(claudeDir, filename);
-      if (existsSync(p)) {
+      const p = join3(claudeDir, filename);
+      if (existsSync2(p)) {
         try {
-          rmSync(p, { force: true });
+          rmSync2(p, { force: true });
           log(`[${label}] Removed ${p} (api_key mode \u2014 preventing OAuth fallback)`);
         } catch {
         }
@@ -1620,14 +1749,14 @@ async function applyClaudeAuthToEnv(childEnv, label) {
 }
 function loadGatewayPorts() {
   try {
-    return JSON.parse(readFileSync(GATEWAY_PORTS_FILE, "utf-8"));
+    return JSON.parse(readFileSync2(GATEWAY_PORTS_FILE, "utf-8"));
   } catch {
     return {};
   }
 }
 function saveGatewayPorts(ports) {
-  mkdirSync(AUGMENTED_DIR, { recursive: true });
-  writeFileSync(GATEWAY_PORTS_FILE, JSON.stringify(ports, null, 2));
+  mkdirSync2(AUGMENTED_DIR, { recursive: true });
+  writeFileSync2(GATEWAY_PORTS_FILE, JSON.stringify(ports, null, 2));
 }
 function allocatePort(codeName) {
   const ports = loadGatewayPorts();
@@ -1650,12 +1779,12 @@ function freePort(codeName) {
   }
 }
 function getStateFile() {
-  return join2(config?.configDir ?? join2(process.env["HOME"] ?? "/tmp", ".augmented"), "manager-state.json");
+  return join3(config?.configDir ?? join3(process.env["HOME"] ?? "/tmp", ".augmented"), "manager-state.json");
 }
 function send(msg) {
   if (msg.type === "state-update") {
     try {
-      writeFileSync(getStateFile(), JSON.stringify(msg.state, null, 2));
+      writeFileSync2(getStateFile(), JSON.stringify(msg.state, null, 2));
     } catch {
     }
   }
@@ -1685,9 +1814,9 @@ function log(msg) {
 `);
   try {
     if (!managerLogPath) {
-      managerLogPath = join2(homedir2(), ".augmented", "manager.log");
-      mkdirSync(dirname(managerLogPath), { recursive: true });
-      if (!existsSync(managerLogPath)) {
+      managerLogPath = join3(homedir3(), ".augmented", "manager.log");
+      mkdirSync2(dirname(managerLogPath), { recursive: true });
+      if (!existsSync2(managerLogPath)) {
         appendFileSync(managerLogPath, "", { mode: 384 });
       } else {
         chmodSync(managerLogPath, 384);
@@ -1703,7 +1832,7 @@ function sha256(content) {
 }
 function hashFile(filePath) {
   try {
-    const content = readFileSync(filePath, "utf-8");
+    const content = readFileSync2(filePath, "utf-8");
     return sha256(content);
   } catch {
     return null;
@@ -1727,13 +1856,13 @@ function parseSkillFrontmatter(content) {
   return out;
 }
 async function refreshSkillsIndexInClaudeMd(configDir, codeName, log2) {
-  const { readdirSync: readdirSync2, readFileSync: rfs, existsSync: ex, writeFileSync: writeFileSync2 } = await import("fs");
-  const skillsDir = join2(configDir, codeName, "project", ".claude", "skills");
-  const claudeMdPath = join2(configDir, codeName, "project", "CLAUDE.md");
+  const { readdirSync: readdirSync3, readFileSync: rfs, existsSync: ex, writeFileSync: writeFileSync3 } = await import("fs");
+  const skillsDir = join3(configDir, codeName, "project", ".claude", "skills");
+  const claudeMdPath = join3(configDir, codeName, "project", "CLAUDE.md");
   if (!ex(skillsDir) || !ex(claudeMdPath)) return;
   const entries = [];
-  for (const dir of readdirSync2(skillsDir).sort()) {
-    const skillFile = join2(skillsDir, dir, "SKILL.md");
+  for (const dir of readdirSync3(skillsDir).sort()) {
+    const skillFile = join3(skillsDir, dir, "SKILL.md");
     if (!ex(skillFile)) continue;
     try {
       const { name, description } = parseSkillFrontmatter(rfs(skillFile, "utf-8"));
@@ -1775,16 +1904,16 @@ ${SKILLS_INDEX_END}`;
     next = current.trimEnd() + "\n\n" + section + "\n";
   }
   if (next !== current) {
-    writeFileSync2(claudeMdPath, next, "utf-8");
+    writeFileSync3(claudeMdPath, next, "utf-8");
     log2(`Refreshed skills index in CLAUDE.md for '${codeName}' (${entries.length} skills)`);
   }
 }
 async function migrateToProfiles() {
   const homeDir = process.env["HOME"] ?? "/tmp";
-  const sharedConfigPath = join2(homeDir, ".openclaw", "openclaw.json");
+  const sharedConfigPath = join3(homeDir, ".openclaw", "openclaw.json");
   let sharedConfig;
   try {
-    sharedConfig = JSON.parse(readFileSync(sharedConfigPath, "utf-8"));
+    sharedConfig = JSON.parse(readFileSync2(sharedConfigPath, "utf-8"));
   } catch {
     return;
   }
@@ -1797,19 +1926,19 @@ async function migrateToProfiles() {
     const codeName = agentEntry["id"];
     if (!codeName) continue;
     if (codeName === "main") continue;
-    const profileDir = join2(homeDir, `.openclaw-${codeName}`);
-    if (existsSync(join2(profileDir, "openclaw.json"))) continue;
+    const profileDir = join3(homeDir, `.openclaw-${codeName}`);
+    if (existsSync2(join3(profileDir, "openclaw.json"))) continue;
     log(`Migrating agent '${codeName}' to per-agent profile`);
     if (adapter.seedProfileConfig) {
       adapter.seedProfileConfig(codeName);
     }
-    const sharedAuthDir = join2(homeDir, ".openclaw", "agents", codeName, "agent");
-    const profileAuthDir = join2(profileDir, "agents", codeName, "agent");
-    const authFile = join2(sharedAuthDir, "auth-profiles.json");
-    if (existsSync(authFile)) {
-      mkdirSync(profileAuthDir, { recursive: true });
-      const authContent = readFileSync(authFile, "utf-8");
-      writeFileSync(join2(profileAuthDir, "auth-profiles.json"), authContent);
+    const sharedAuthDir = join3(homeDir, ".openclaw", "agents", codeName, "agent");
+    const profileAuthDir = join3(profileDir, "agents", codeName, "agent");
+    const authFile = join3(sharedAuthDir, "auth-profiles.json");
+    if (existsSync2(authFile)) {
+      mkdirSync2(profileAuthDir, { recursive: true });
+      const authContent = readFileSync2(authFile, "utf-8");
+      writeFileSync2(join3(profileAuthDir, "auth-profiles.json"), authContent);
     }
     allocatePort(codeName);
     migrated++;
@@ -1847,7 +1976,7 @@ function readGatewayToken(codeName) {
   }
   const homeDir = process.env["HOME"] ?? "/tmp";
   try {
-    const cfg = JSON.parse(readFileSync(join2(homeDir, `.openclaw-${codeName}`, "openclaw.json"), "utf-8"));
+    const cfg = JSON.parse(readFileSync2(join3(homeDir, `.openclaw-${codeName}`, "openclaw.json"), "utf-8"));
     return cfg?.gateway?.auth?.token;
   } catch {
     return void 0;
@@ -1856,10 +1985,10 @@ function readGatewayToken(codeName) {
 var GATEWAY_HUNG_TIMEOUT_MS = 5 * 6e4;
 function isGatewayHung(codeName) {
   const homeDir = process.env["HOME"] ?? "/tmp";
-  const jobsPath = join2(homeDir, `.openclaw-${codeName}`, "cron", "jobs.json");
-  if (!existsSync(jobsPath)) return false;
+  const jobsPath = join3(homeDir, `.openclaw-${codeName}`, "cron", "jobs.json");
+  if (!existsSync2(jobsPath)) return false;
   try {
-    const data = JSON.parse(readFileSync(jobsPath, "utf-8"));
+    const data = JSON.parse(readFileSync2(jobsPath, "utf-8"));
     const jobs = data.jobs ?? data;
     if (!Array.isArray(jobs)) return false;
     const now = Date.now();
@@ -1892,19 +2021,19 @@ async function ensureGatewayRunning(codeName, adapter) {
       }
       await new Promise((r) => setTimeout(r, 2e3));
       const homeDir = process.env["HOME"] ?? "/tmp";
-      const cronJobsPath = join2(homeDir, `.openclaw-${codeName}`, "cron", "jobs.json");
+      const cronJobsPath = join3(homeDir, `.openclaw-${codeName}`, "cron", "jobs.json");
       clearStaleCronRunState(cronJobsPath);
     } else {
       if (status.port) {
         try {
           const homeDir = process.env["HOME"] ?? "/tmp";
-          const configPath = join2(homeDir, `.openclaw-${codeName}`, "openclaw.json");
-          if (existsSync(configPath)) {
-            const cfg = JSON.parse(readFileSync(configPath, "utf-8"));
+          const configPath = join3(homeDir, `.openclaw-${codeName}`, "openclaw.json");
+          if (existsSync2(configPath)) {
+            const cfg = JSON.parse(readFileSync2(configPath, "utf-8"));
             if (cfg.gateway?.port !== status.port) {
               if (!cfg.gateway) cfg.gateway = {};
               cfg.gateway.port = status.port;
-              writeFileSync(configPath, JSON.stringify(cfg, null, 2));
+              writeFileSync2(configPath, JSON.stringify(cfg, null, 2));
             }
           }
         } catch {
@@ -1924,12 +2053,12 @@ async function ensureGatewayRunning(codeName, adapter) {
     gatewaysStartedThisCycle.add(codeName);
     try {
       const homeDir = process.env["HOME"] ?? "/tmp";
-      const configPath = join2(homeDir, `.openclaw-${codeName}`, "openclaw.json");
-      if (existsSync(configPath)) {
-        const cfg = JSON.parse(readFileSync(configPath, "utf-8"));
+      const configPath = join3(homeDir, `.openclaw-${codeName}`, "openclaw.json");
+      if (existsSync2(configPath)) {
+        const cfg = JSON.parse(readFileSync2(configPath, "utf-8"));
         if (!cfg.gateway) cfg.gateway = {};
         cfg.gateway.port = port;
-        writeFileSync(configPath, JSON.stringify(cfg, null, 2));
+        writeFileSync2(configPath, JSON.stringify(cfg, null, 2));
       }
     } catch {
     }
@@ -2012,6 +2141,48 @@ Automatic restart failed: ${err.message}`
 async function pollCycle() {
   if (!config) return;
   if (restartAfterUpgrade) return;
+  try {
+    await processRestartFlags({
+      log,
+      resolveFramework: (codeName) => agentFrameworkCache.get(codeName) ?? null,
+      stopSession: (codeName) => {
+        stopPersistentSession(codeName, log);
+        persistentSessionAgents.delete(codeName);
+        claudeAuthTupleBySession.delete(codeName);
+      },
+      getTelegramTokens: (codeName) => {
+        const t = agentChannelTokens.get(codeName);
+        if (!t?.telegram) return null;
+        return { token: t.telegram, allowedChats: t.telegramAllowedChats };
+      },
+      sendTelegram: (botToken, method, body) => telegramApiCall(botToken, method, body),
+      getSlackToken: (codeName) => agentChannelTokens.get(codeName)?.slack ?? null,
+      sendSlack: async (botToken, body) => {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), 5e3);
+        try {
+          const res = await fetch("https://slack.com/api/chat.postMessage", {
+            method: "POST",
+            headers: {
+              "Content-Type": "application/json; charset=utf-8",
+              Authorization: `Bearer ${botToken}`
+            },
+            body: JSON.stringify(body),
+            signal: controller.signal
+          });
+          const data = await res.json();
+          return data;
+        } catch (err) {
+          const isAbort = err.name === "AbortError";
+          return { ok: false, error: isAbort ? "timeout" : err.message };
+        } finally {
+          clearTimeout(timer);
+        }
+      }
+    });
+  } catch (err) {
+    log(`[restart-handler] processRestartFlags threw: ${err.message}`);
+  }
   checkAndUpdateCli().catch((err) => log(`[self-update] Check failed: ${err.message}`));
   try {
     registeredAgentsCache.clear();
@@ -2135,7 +2306,7 @@ async function pollCycle() {
         const adapter = resolveAgentFramework(prev.codeName);
         await stopGatewayIfRunning(prev.codeName, adapter);
         freePort(prev.codeName);
-        const agentDir = join2(adapter.getAgentDir(prev.codeName), "provision");
+        const agentDir = join3(adapter.getAgentDir(prev.codeName), "provision");
         await cleanupAgentFiles(prev.codeName, agentDir);
         clearAgentCaches(prev.agentId, prev.codeName);
       }
@@ -2215,7 +2386,7 @@ async function processAgent(agent, agentStates) {
   }
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const adapter = resolveAgentFramework(agent.code_name);
-  let agentDir = join2(adapter.getAgentDir(agent.code_name), "provision");
+  let agentDir = join3(adapter.getAgentDir(agent.code_name), "provision");
   if (agent.status === "draft" || agent.status === "paused") {
     log(`Agent '${agent.code_name}' is ${agent.status}, skipping provisioning`);
     await stopGatewayIfRunning(agent.code_name, adapter);
@@ -2339,7 +2510,7 @@ async function processAgent(agent, agentStates) {
   const frameworkId = refreshData.agent.framework ?? "openclaw";
   agentFrameworkCache.set(agent.code_name, frameworkId);
   const frameworkAdapter = getFramework(frameworkId);
-  agentDir = join2(frameworkAdapter.getAgentDir(agent.code_name), "provision");
+  agentDir = join3(frameworkAdapter.getAgentDir(agent.code_name), "provision");
   cacheAgentDeliveryMetadata(agent.code_name, refreshData);
   if (frameworkAdapter.seedProfileConfig) {
     frameworkAdapter.seedProfileConfig(agent.code_name);
@@ -2367,9 +2538,9 @@ async function processAgent(agent, agentStates) {
   try {
     const artifacts = generateArtifacts(agent, refreshData, frameworkAdapter);
     const changedFiles = [];
-    mkdirSync(agentDir, { recursive: true });
+    mkdirSync2(agentDir, { recursive: true });
     for (const artifact of artifacts) {
-      const filePath = join2(agentDir, artifact.relativePath);
+      const filePath = join3(agentDir, artifact.relativePath);
       let existingHash;
       let newHash;
       let writeContent = artifact.content;
@@ -2381,8 +2552,8 @@ async function processAgent(agent, agentStates) {
         };
         newHash = sha256(stripDynamicSections(artifact.content));
         try {
-          const projectClaudeMd = join2(config.configDir, agent.code_name, "project", "CLAUDE.md");
-          const existing = readFileSync(projectClaudeMd, "utf-8");
+          const projectClaudeMd = join3(config.configDir, agent.code_name, "project", "CLAUDE.md");
+          const existing = readFileSync2(projectClaudeMd, "utf-8");
           existingHash = sha256(stripDynamicSections(existing));
         } catch {
           existingHash = null;
@@ -2400,7 +2571,7 @@ async function processAgent(agent, agentStates) {
         const generatorKeys = Object.keys(generatorServers);
         let existingRaw = "";
         try {
-          existingRaw = readFileSync(filePath, "utf-8");
+          existingRaw = readFileSync2(filePath, "utf-8");
         } catch {
         }
         const existingServers = parseMcp(existingRaw);
@@ -2422,22 +2593,22 @@ async function processAgent(agent, agentStates) {
       }
     }
     if (changedFiles.length > 0) {
-      const isFirst = !existsSync(join2(agentDir, "CHARTER.md"));
+      const isFirst = !existsSync2(join3(agentDir, "CHARTER.md"));
       const verb = isFirst ? "Provisioning" : "Updating";
       const fileNames = changedFiles.map((f) => f.relativePath).join(", ");
       log(`${verb} '${agent.code_name}': ${fileNames}`);
       for (const file of changedFiles) {
-        const filePath = join2(agentDir, file.relativePath);
-        mkdirSync(dirname(filePath), { recursive: true });
-        writeFileSync(filePath, file.content);
+        const filePath = join3(agentDir, file.relativePath);
+        mkdirSync2(dirname(filePath), { recursive: true });
+        writeFileSync2(filePath, file.content);
       }
       try {
-        const provSkillsDir = join2(agentDir, ".claude", "skills");
-        if (existsSync(provSkillsDir)) {
-          for (const folder of readdirSync(provSkillsDir)) {
+        const provSkillsDir = join3(agentDir, ".claude", "skills");
+        if (existsSync2(provSkillsDir)) {
+          for (const folder of readdirSync2(provSkillsDir)) {
             if (folder.startsWith("knowledge-")) {
               try {
-                rmSync(join2(provSkillsDir, folder), { recursive: true });
+                rmSync2(join3(provSkillsDir, folder), { recursive: true });
               } catch {
               }
             }
@@ -2450,7 +2621,7 @@ async function processAgent(agent, agentStates) {
       const trackedFiles2 = frameworkAdapter.driftTrackedFiles();
       const hashes = /* @__PURE__ */ new Map();
       for (const file of trackedFiles2) {
-        const h = hashFile(join2(agentDir, file));
+        const h = hashFile(join3(agentDir, file));
         if (h) hashes.set(file, h);
       }
       writtenHashes.set(agent.agent_id, hashes);
@@ -2494,10 +2665,10 @@ async function processAgent(agent, agentStates) {
   }
   let lastDriftCheckAt = now;
   const written = writtenHashes.get(agent.agent_id);
-  if (written && existsSync(agentDir)) {
+  if (written && existsSync2(agentDir)) {
     const driftedFiles = [];
     for (const [file, expectedHash] of written) {
-      const localHash = hashFile(join2(agentDir, file));
+      const localHash = hashFile(join3(agentDir, file));
       if (localHash && localHash !== expectedHash) {
         driftedFiles.push(file);
       }
@@ -2508,7 +2679,7 @@ async function processAgent(agent, agentStates) {
       try {
         const localHashes = {};
         for (const file of driftedFiles) {
-          localHashes[file] = hashFile(join2(agentDir, file));
+          localHashes[file] = hashFile(join3(agentDir, file));
         }
         await api.post("/host/drift", {
           agent_id: agent.agent_id,
@@ -2591,9 +2762,9 @@ async function processAgent(agent, agentStates) {
           const entry = refreshData.channel_configs[channelId];
           if (!entry || entry.status !== "active" && entry.status !== "pending") continue;
           try {
-            const installedPath = join2(homedir2(), ".claude", "plugins", "installed_plugins.json");
-            if (existsSync(installedPath)) {
-              const installed = JSON.parse(readFileSync(installedPath, "utf-8"));
+            const installedPath = join3(homedir3(), ".claude", "plugins", "installed_plugins.json");
+            if (existsSync2(installedPath)) {
+              const installed = JSON.parse(readFileSync2(installedPath, "utf-8"));
               const pluginKeys = Object.keys(installed.plugins ?? {});
               if (pluginKeys.some((k) => k.startsWith(`${pluginName}@`))) continue;
             }
@@ -2626,19 +2797,19 @@ async function processAgent(agent, agentStates) {
   if (agentSessionMode === "persistent" && (agentFrameworkCache.get(agent.code_name) ?? "openclaw") === "claude-code") {
     try {
       const agentProvisionDir = agentDir;
-      const projectDir = join2(homedir2(), ".augmented", agent.code_name, "project");
-      mkdirSync(agentProvisionDir, { recursive: true });
-      mkdirSync(projectDir, { recursive: true });
-      const provisionMcpPath = join2(agentProvisionDir, ".mcp.json");
-      const projectMcpPath = join2(projectDir, ".mcp.json");
+      const projectDir = join3(homedir3(), ".augmented", agent.code_name, "project");
+      mkdirSync2(agentProvisionDir, { recursive: true });
+      mkdirSync2(projectDir, { recursive: true });
+      const provisionMcpPath = join3(agentProvisionDir, ".mcp.json");
+      const projectMcpPath = join3(projectDir, ".mcp.json");
       let mcpConfig = { mcpServers: {} };
       try {
-        mcpConfig = JSON.parse(readFileSync(provisionMcpPath, "utf-8"));
+        mcpConfig = JSON.parse(readFileSync2(provisionMcpPath, "utf-8"));
         if (!mcpConfig.mcpServers) mcpConfig.mcpServers = {};
       } catch {
       }
-      const localDirectChatChannel = join2(homedir2(), ".augmented", "_mcp", "direct-chat-channel.js");
-      if (existsSync(localDirectChatChannel) && !mcpConfig.mcpServers["direct-chat"]) {
+      const localDirectChatChannel = join3(homedir3(), ".augmented", "_mcp", "direct-chat-channel.js");
+      if (existsSync2(localDirectChatChannel) && !mcpConfig.mcpServers["direct-chat"]) {
         mcpConfig.mcpServers["direct-chat"] = {
           command: "node",
           args: [localDirectChatChannel],
@@ -2649,14 +2820,14 @@ async function processAgent(agent, agentStates) {
           }
         };
         const serialized = JSON.stringify(mcpConfig, null, 2);
-        writeFileSync(provisionMcpPath, serialized);
-        writeFileSync(projectMcpPath, serialized);
+        writeFileSync2(provisionMcpPath, serialized);
+        writeFileSync2(projectMcpPath, serialized);
         log(`Channel credentials written for '${agent.code_name}/direct-chat'`);
       }
-      const staleChannelsPath = join2(projectDir, ".mcp-channels.json");
-      if (existsSync(staleChannelsPath)) {
+      const staleChannelsPath = join3(projectDir, ".mcp-channels.json");
+      if (existsSync2(staleChannelsPath)) {
         try {
-          rmSync(staleChannelsPath, { force: true });
+          rmSync2(staleChannelsPath, { force: true });
         } catch {
         }
       }
@@ -2769,8 +2940,8 @@ async function processAgent(agent, agentStates) {
             const mcpPath = frameworkAdapter.getMcpPath(agent.code_name);
             if (mcpPath) {
               try {
-                const { readFileSync: readFileSync2 } = await import("fs");
-                const mcpConfig = JSON.parse(readFileSync2(mcpPath, "utf-8"));
+                const { readFileSync: readFileSync3 } = await import("fs");
+                const mcpConfig = JSON.parse(readFileSync3(mcpPath, "utf-8"));
                 if (mcpConfig.mcpServers) {
                   const managedPrefixes = [
                     "composio_",
@@ -2862,8 +3033,8 @@ async function processAgent(agent, agentStates) {
   if (agent.status === "active") {
     if (frameworkAdapter.installPlugin) {
       try {
-        const pluginPath = join2(process.cwd(), "packages", "openclaw-plugin-augmented", "src", "index.ts");
-        if (existsSync(pluginPath)) {
+        const pluginPath = join3(process.cwd(), "packages", "openclaw-plugin-augmented", "src", "index.ts");
+        if (existsSync2(pluginPath)) {
           frameworkAdapter.installPlugin(agent.code_name, "augmented", pluginPath, {
             agtHost: requireHost(),
             agtApiKey: getApiKey() ?? void 0,
@@ -2924,25 +3095,25 @@ async function processAgent(agent, agentStates) {
         }
       }
       try {
-        const { readdirSync: readdirSync2, rmSync: rmSync2 } = await import("fs");
-        const { homedir: homedir3 } = await import("os");
+        const { readdirSync: readdirSync3, rmSync: rmSync3 } = await import("fs");
+        const { homedir: homedir4 } = await import("os");
         const frameworkId2 = frameworkAdapter.id;
         const candidateSkillDirs = [
           // Claude Code — framework runtime tree
-          join2(homedir3(), ".augmented", agent.code_name, "skills"),
+          join3(homedir4(), ".augmented", agent.code_name, "skills"),
           // Claude Code — project tree
-          join2(homedir3(), ".augmented", agent.code_name, "project", ".claude", "skills"),
+          join3(homedir4(), ".augmented", agent.code_name, "project", ".claude", "skills"),
           // OpenClaw — framework runtime tree
-          join2(homedir3(), `.openclaw-${agent.code_name}`, "skills"),
+          join3(homedir4(), `.openclaw-${agent.code_name}`, "skills"),
           // Defensive: legacy provision-side path, not currently an
           // install target but cheap to sweep.
-          join2(agentDir, ".claude", "skills")
+          join3(agentDir, ".claude", "skills")
         ];
-        const existingDirs = candidateSkillDirs.filter((d) => existsSync(d));
+        const existingDirs = candidateSkillDirs.filter((d) => existsSync2(d));
         const discoveredEntries = /* @__PURE__ */ new Set();
         for (const dir of existingDirs) {
           try {
-            for (const entry of readdirSync2(dir)) {
+            for (const entry of readdirSync3(dir)) {
               if (entry.startsWith("plugin-") || entry.startsWith("integration-")) {
                 discoveredEntries.add(entry);
               }
@@ -2952,9 +3123,9 @@ async function processAgent(agent, agentStates) {
         }
         const removeSkillFolder = (entry, reason) => {
           for (const dir of existingDirs) {
-            const p = join2(dir, entry);
-            if (existsSync(p)) {
-              rmSync2(p, { recursive: true, force: true });
+            const p = join3(dir, entry);
+            if (existsSync2(p)) {
+              rmSync3(p, { recursive: true, force: true });
             }
           }
           log(`Removed ${reason} '${entry}' for '${agent.code_name}' (framework=${frameworkId2})`);
@@ -3123,10 +3294,10 @@ async function processAgent(agent, agentStates) {
         lastWorkTriggerAt.set(agent.code_name, triggerTs);
         if (agentFw === "openclaw" && gatewayRunning && gatewayPort) {
           const homeDir = process.env["HOME"] ?? "/tmp";
-          const jobsPath = join2(homeDir, `.openclaw-${agent.code_name}`, "cron", "jobs.json");
-          if (existsSync(jobsPath)) {
+          const jobsPath = join3(homeDir, `.openclaw-${agent.code_name}`, "cron", "jobs.json");
+          if (existsSync2(jobsPath)) {
             try {
-              const jobsData = JSON.parse(readFileSync(jobsPath, "utf-8"));
+              const jobsData = JSON.parse(readFileSync2(jobsPath, "utf-8"));
               const kanbanJob = (jobsData.jobs ?? []).find(
                 (j) => typeof j.name === "string" && j.name.includes("kanban-work")
               );
@@ -3252,10 +3423,10 @@ In progress for ${age} minutes \u2014 auto-failed`).catch(() => {
     }
   }
   const trackedFiles = frameworkAdapter.driftTrackedFiles();
-  if (trackedFiles.length > 0 && existsSync(agentDir)) {
+  if (trackedFiles.length > 0 && existsSync2(agentDir)) {
     const hashes = /* @__PURE__ */ new Map();
     for (const file of trackedFiles) {
-      const h = hashFile(join2(agentDir, file));
+      const h = hashFile(join3(agentDir, file));
       if (h) hashes.set(file, h);
     }
     writtenHashes.set(agent.agent_id, hashes);
@@ -3289,19 +3460,19 @@ function cleanupStaleSessions(codeName) {
   lastCleanupAt.set(codeName, Date.now());
   const homeDir = process.env["HOME"] ?? "/tmp";
   for (const agentDir of ["main", codeName]) {
-    const sessionsDir = join2(homeDir, `.openclaw-${codeName}`, "agents", agentDir, "sessions");
+    const sessionsDir = join3(homeDir, `.openclaw-${codeName}`, "agents", agentDir, "sessions");
     cleanupCronSessions(sessionsDir, CRON_SESSION_KEEP_COUNT);
   }
-  const cronRunsDir = join2(homeDir, `.openclaw-${codeName}`, "cron", "runs");
+  const cronRunsDir = join3(homeDir, `.openclaw-${codeName}`, "cron", "runs");
   cleanupOldFiles(cronRunsDir, CRON_RUN_RETENTION_DAYS, ".jsonl");
-  const cronJobsPath = join2(homeDir, `.openclaw-${codeName}`, "cron", "jobs.json");
+  const cronJobsPath = join3(homeDir, `.openclaw-${codeName}`, "cron", "jobs.json");
   clearStaleCronRunState(cronJobsPath);
 }
 function cleanupCronSessions(sessionsDir, keepCount) {
-  const indexPath = join2(sessionsDir, "sessions.json");
-  if (!existsSync(indexPath)) return;
+  const indexPath = join3(sessionsDir, "sessions.json");
+  if (!existsSync2(indexPath)) return;
   try {
-    const raw = readFileSync(indexPath, "utf-8");
+    const raw = readFileSync2(indexPath, "utf-8");
     const index = JSON.parse(raw);
     const cronRunKeys = Object.keys(index).filter((k) => k.includes(":cron:") && k.includes(":run:")).map((k) => ({
       key: k,
@@ -3314,9 +3485,9 @@ function cleanupCronSessions(sessionsDir, keepCount) {
     for (const entry of toDelete) {
       delete index[entry.key];
       if (entry.sessionId) {
-        const sessionFile = join2(sessionsDir, `${entry.sessionId}.jsonl`);
+        const sessionFile = join3(sessionsDir, `${entry.sessionId}.jsonl`);
         try {
-          if (existsSync(sessionFile)) {
+          if (existsSync2(sessionFile)) {
             unlinkSync(sessionFile);
             deletedFiles++;
           }
@@ -3336,8 +3507,8 @@ function cleanupCronSessions(sessionsDir, keepCount) {
         delete index[parentKey];
         if (parentSessionId) {
           try {
-            const f = join2(sessionsDir, `${parentSessionId}.jsonl`);
-            if (existsSync(f)) {
+            const f = join3(sessionsDir, `${parentSessionId}.jsonl`);
+            if (existsSync2(f)) {
               unlinkSync(f);
               deletedFiles++;
             }
@@ -3346,7 +3517,7 @@ function cleanupCronSessions(sessionsDir, keepCount) {
         }
       }
     }
-    writeFileSync(indexPath, JSON.stringify(index));
+    writeFileSync2(indexPath, JSON.stringify(index));
     if (toDelete.length > 0) {
       log(`Cleaned ${toDelete.length} cron session(s) and ${deletedFiles} file(s) from ${sessionsDir}`);
     }
@@ -3355,9 +3526,9 @@ function cleanupCronSessions(sessionsDir, keepCount) {
 }
 var STALE_RUN_TIMEOUT_MS = 5 * 6e4;
 function clearStaleCronRunState(jobsPath) {
-  if (!existsSync(jobsPath)) return;
+  if (!existsSync2(jobsPath)) return;
   try {
-    const raw = readFileSync(jobsPath, "utf-8");
+    const raw = readFileSync2(jobsPath, "utf-8");
     const data = JSON.parse(raw);
     const jobs = data.jobs ?? data;
     if (!Array.isArray(jobs)) return;
@@ -3382,19 +3553,19 @@ function clearStaleCronRunState(jobsPath) {
       }
     }
     if (changed) {
-      writeFileSync(jobsPath, JSON.stringify(data, null, 2));
+      writeFileSync2(jobsPath, JSON.stringify(data, null, 2));
     }
   } catch {
   }
 }
 function cleanupOldFiles(dir, maxAgeDays, ext) {
-  if (!existsSync(dir)) return;
+  if (!existsSync2(dir)) return;
   const cutoff = Date.now() - maxAgeDays * 24 * 60 * 60 * 1e3;
   let removed = 0;
   try {
-    for (const f of readdirSync(dir)) {
+    for (const f of readdirSync2(dir)) {
       if (!f.endsWith(ext)) continue;
-      const fullPath = join2(dir, f);
+      const fullPath = join3(dir, f);
       try {
         const st = statSync(fullPath);
         if (st.mtimeMs < cutoff) {
@@ -3521,18 +3692,18 @@ async function finishRun(runId, outcome, options = {}) {
 }
 async function executeAndProcessClaudeTask(codeName, agentId, task, prompt) {
   const projectDir = getProjectDir(codeName);
-  const mcpConfigPath = join2(projectDir, ".mcp.json");
+  const mcpConfigPath = join3(projectDir, ".mcp.json");
   let runId = null;
   let kanbanItemId = null;
   let taskResult;
   sanitizeMcpJson(mcpConfigPath, requireHost());
   prompt = wrapScheduledTaskPrompt(prompt);
   try {
-    const claudeMdPath = join2(projectDir, "CLAUDE.md");
+    const claudeMdPath = join3(projectDir, "CLAUDE.md");
     const serverNames = [];
-    if (existsSync(mcpConfigPath)) {
+    if (existsSync2(mcpConfigPath)) {
       try {
-        const d = JSON.parse(readFileSync(mcpConfigPath, "utf-8"));
+        const d = JSON.parse(readFileSync2(mcpConfigPath, "utf-8"));
         if (d.mcpServers) serverNames.push(...Object.keys(d.mcpServers));
       } catch {
       }
@@ -3550,14 +3721,14 @@ async function executeAndProcessClaudeTask(codeName, agentId, task, prompt) {
       "--allowedTools",
       allowedTools
     ];
-    if (existsSync(claudeMdPath)) {
+    if (existsSync2(claudeMdPath)) {
       claudeArgs.push("--system-prompt-file", claudeMdPath);
     }
     const childEnv = { ...process.env };
-    const envIntPath = join2(projectDir, ".env.integrations");
-    if (existsSync(envIntPath)) {
+    const envIntPath = join3(projectDir, ".env.integrations");
+    if (existsSync2(envIntPath)) {
       try {
-        for (const line of readFileSync(envIntPath, "utf-8").split("\n")) {
+        for (const line of readFileSync2(envIntPath, "utf-8").split("\n")) {
           if (!line || line.startsWith("#") || !line.includes("=")) continue;
           const eqIdx = line.indexOf("=");
           childEnv[line.slice(0, eqIdx)] = line.slice(eqIdx + 1);
@@ -3739,8 +3910,8 @@ var claudeAuthTupleBySession = /* @__PURE__ */ new Map();
 async function ensurePersistentSession(agent, tasks, boardItems, refreshData) {
   const codeName = agent.code_name;
   const projectDir = getProjectDir2(codeName);
-  const mcpConfigPath = join2(projectDir, ".mcp.json");
-  const claudeMdPath = join2(projectDir, "CLAUDE.md");
+  const mcpConfigPath = join3(projectDir, ".mcp.json");
+  const claudeMdPath = join3(projectDir, "CLAUDE.md");
   const channelConfigs = refreshData.channel_configs;
   const channels = [];
   const devChannels = [];
@@ -4188,11 +4359,11 @@ async function processDirectChatMessage(agent, msg) {
     if (fw === "claude-code") {
       const { getProjectDir: ccProjectDir } = await import("../claude-scheduler-CLSMSF5W.js");
       const projDir = ccProjectDir(agent.codeName);
-      const mcpConfigPath = join2(projDir, ".mcp.json");
+      const mcpConfigPath = join3(projDir, ".mcp.json");
       const serverNames = [];
-      if (existsSync(mcpConfigPath)) {
+      if (existsSync2(mcpConfigPath)) {
         try {
-          const d = JSON.parse(readFileSync(mcpConfigPath, "utf-8"));
+          const d = JSON.parse(readFileSync2(mcpConfigPath, "utf-8"));
           if (d.mcpServers) serverNames.push(...Object.keys(d.mcpServers));
         } catch {
         }
@@ -4209,15 +4380,15 @@ async function processDirectChatMessage(agent, msg) {
         "--allowedTools",
         allowedTools
       ];
-      const chatClaudeMd = join2(projDir, "CLAUDE.md");
-      if (existsSync(chatClaudeMd)) {
+      const chatClaudeMd = join3(projDir, "CLAUDE.md");
+      if (existsSync2(chatClaudeMd)) {
         chatArgs.push("--system-prompt-file", chatClaudeMd);
       }
-      const envIntPath = join2(projDir, ".env.integrations");
+      const envIntPath = join3(projDir, ".env.integrations");
       const childEnv = { ...process.env };
-      if (existsSync(envIntPath)) {
+      if (existsSync2(envIntPath)) {
         try {
-          for (const line of readFileSync(envIntPath, "utf-8").split("\n")) {
+          for (const line of readFileSync2(envIntPath, "utf-8").split("\n")) {
             if (!line || line.startsWith("#") || !line.includes("=")) continue;
             const eqIdx = line.indexOf("=");
             childEnv[line.slice(0, eqIdx)] = line.slice(eqIdx + 1);
@@ -4498,12 +4669,12 @@ function getBuiltInSkillContent(skillId) {
   if (builtInSkillCache.has(skillId)) return builtInSkillCache.get(skillId);
   try {
     const candidates = [
-      join2(process.cwd(), "skills", skillId, "SKILL.md"),
-      join2(new URL(".", import.meta.url).pathname, "..", "..", "..", "..", "skills", skillId, "SKILL.md")
+      join3(process.cwd(), "skills", skillId, "SKILL.md"),
+      join3(new URL(".", import.meta.url).pathname, "..", "..", "..", "..", "skills", skillId, "SKILL.md")
     ];
     for (const candidate of candidates) {
-      if (existsSync(candidate)) {
-        const content = readFileSync(candidate, "utf-8");
+      if (existsSync2(candidate)) {
+        const content = readFileSync2(candidate, "utf-8");
         const files = [{ relativePath: "SKILL.md", content }];
         builtInSkillCache.set(skillId, files);
         return files;
@@ -5245,16 +5416,16 @@ function parseMemoryFile(raw, fallbackName) {
   };
 }
 async function syncMemories(agent, configDir, log2) {
-  const projectDir = join2(configDir, agent.code_name, "project");
-  const memoryDir = join2(projectDir, "memory");
-  if (existsSync(memoryDir)) {
+  const projectDir = join3(configDir, agent.code_name, "project");
+  const memoryDir = join3(projectDir, "memory");
+  if (existsSync2(memoryDir)) {
     const prevHashes = memoryFileHashes.get(agent.agent_id) ?? /* @__PURE__ */ new Map();
     const currentHashes = /* @__PURE__ */ new Map();
     const changedMemories = [];
-    for (const file of readdirSync(memoryDir)) {
+    for (const file of readdirSync2(memoryDir)) {
       if (!file.endsWith(".md")) continue;
       try {
-        const raw = readFileSync(join2(memoryDir, file), "utf-8");
+        const raw = readFileSync2(join3(memoryDir, file), "utf-8");
         const fileHash = createHash("sha256").update(raw).digest("hex").slice(0, 16);
         currentHashes.set(file, fileHash);
         if (prevHashes.get(file) === fileHash) continue;
@@ -5279,7 +5450,7 @@ async function syncMemories(agent, configDir, log2) {
       } catch (err) {
         for (const mem of changedMemories) {
           for (const [file] of currentHashes) {
-            const parsed = parseMemoryFile(readFileSync(join2(memoryDir, file), "utf-8"), file.replace(/\.md$/, ""));
+            const parsed = parseMemoryFile(readFileSync2(join3(memoryDir, file), "utf-8"), file.replace(/\.md$/, ""));
             if (parsed?.name === mem.name) currentHashes.delete(file);
           }
         }
@@ -5287,7 +5458,7 @@ async function syncMemories(agent, configDir, log2) {
       }
     }
   }
-  const localFiles = existsSync(memoryDir) ? readdirSync(memoryDir).filter((f) => f.endsWith(".md")).sort() : [];
+  const localFiles = existsSync2(memoryDir) ? readdirSync2(memoryDir).filter((f) => f.endsWith(".md")).sort() : [];
   const localListHash = createHash("sha256").update(localFiles.join(",")).digest("hex").slice(0, 16);
   const prevLocalHash = lastLocalFileHash.get(agent.agent_id);
   const prevDownload = lastDownloadHash.get(agent.agent_id);
@@ -5302,7 +5473,7 @@ async function syncMemories(agent, configDir, log2) {
     lastDownloadHash.set(agent.agent_id, responseHash);
     lastLocalFileHash.set(agent.agent_id, localListHash);
     if (dbMemories.memories?.length) {
-      mkdirSync(memoryDir, { recursive: true });
+      mkdirSync2(memoryDir, { recursive: true });
       const existingFileSet = new Set(localFiles.map((f) => f.replace(/\.md$/, "").toLowerCase()));
       let written = 0;
       for (const mem of dbMemories.memories) {
@@ -5317,11 +5488,11 @@ description: ${JSON.stringify(mem.content.slice(0, 200))}
 
 ${mem.content}
 `;
-        writeFileSync(join2(memoryDir, `${slug}.md`), fileContent);
+        writeFileSync2(join3(memoryDir, `${slug}.md`), fileContent);
         written++;
       }
       if (written > 0) {
-        const updatedFiles = readdirSync(memoryDir).filter((f) => f.endsWith(".md")).sort();
+        const updatedFiles = readdirSync2(memoryDir).filter((f) => f.endsWith(".md")).sort();
         lastLocalFileHash.set(agent.agent_id, createHash("sha256").update(updatedFiles.join(",")).digest("hex").slice(0, 16));
         log2(`Exported ${written} DB memories to local files for '${agent.code_name}'`);
       }
@@ -5331,9 +5502,9 @@ ${mem.content}
   }
 }
 async function cleanupAgentFiles(codeName, agentDir) {
-  if (existsSync(agentDir)) {
+  if (existsSync2(agentDir)) {
     try {
-      rmSync(agentDir, { recursive: true, force: true });
+      rmSync2(agentDir, { recursive: true, force: true });
       log(`Removed provision directory for '${codeName}'`);
     } catch (err) {
       log(`Failed to remove provision dir for '${codeName}': ${err.message}`);
@@ -5556,14 +5727,14 @@ function restartRunningChannelMcps(basenames) {
   }
 }
 function deployMcpAssets() {
-  const targetDir = join2(homedir2(), ".augmented", "_mcp");
-  mkdirSync(targetDir, { recursive: true });
+  const targetDir = join3(homedir3(), ".augmented", "_mcp");
+  mkdirSync2(targetDir, { recursive: true });
   const moduleDir = dirname(fileURLToPath(import.meta.url));
   let mcpSourceDir = "";
   let dir = moduleDir;
   for (let i = 0; i < 6; i++) {
-    const candidate = join2(dir, "mcp");
-    if (existsSync(join2(candidate, "index.js"))) {
+    const candidate = join3(dir, "mcp");
+    if (existsSync2(join3(candidate, "index.js"))) {
       mcpSourceDir = candidate;
       break;
     }
@@ -5578,8 +5749,8 @@ function deployMcpAssets() {
   const changedBasenames = [];
   const fileHash = (p) => {
     try {
-      if (!existsSync(p)) return null;
-      return createHash("sha256").update(readFileSync(p)).digest("hex");
+      if (!existsSync2(p)) return null;
+      return createHash("sha256").update(readFileSync2(p)).digest("hex");
     } catch {
       return null;
     }
@@ -5590,9 +5761,9 @@ function deployMcpAssets() {
     "telegram-channel.js"
   ]);
   for (const file of ["index.js", "slack-channel.js", "direct-chat-channel.js", "telegram-channel.js"]) {
-    const src = join2(mcpSourceDir, file);
-    const dst = join2(targetDir, file);
-    if (!existsSync(src)) continue;
+    const src = join3(mcpSourceDir, file);
+    const dst = join3(targetDir, file);
+    if (!existsSync2(src)) continue;
     const before = fileHash(dst);
     try {
       copyFileSync(src, dst);
@@ -5609,23 +5780,23 @@ function deployMcpAssets() {
     log(`[manager] Bundle(s) updated: ${changedBasenames.join(", ")} \u2014 signalling running instances to restart`);
     restartRunningChannelMcps(changedBasenames);
   }
-  const localMcpPath = join2(targetDir, "index.js");
+  const localMcpPath = join3(targetDir, "index.js");
   try {
-    const agentsDir = join2(homedir2(), ".augmented", "agents");
-    if (existsSync(agentsDir)) {
-      for (const entry of readdirSync(agentsDir, { withFileTypes: true })) {
+    const agentsDir = join3(homedir3(), ".augmented", "agents");
+    if (existsSync2(agentsDir)) {
+      for (const entry of readdirSync2(agentsDir, { withFileTypes: true })) {
         if (!entry.isDirectory()) continue;
         for (const subdir of ["provision", "project"]) {
-          const mcpJsonPath = join2(agentsDir, entry.name, subdir, ".mcp.json");
+          const mcpJsonPath = join3(agentsDir, entry.name, subdir, ".mcp.json");
           try {
-            const raw = readFileSync(mcpJsonPath, "utf-8");
+            const raw = readFileSync2(mcpJsonPath, "utf-8");
             if (!raw.includes("@integrity-labs/augmented-mcp")) continue;
             const mcpConfig = JSON.parse(raw);
             const augServer = mcpConfig.mcpServers?.["augmented"];
             if (!augServer) continue;
             augServer.command = "node";
             augServer.args = [localMcpPath];
-            writeFileSync(mcpJsonPath, JSON.stringify(mcpConfig, null, 2));
+            writeFileSync2(mcpJsonPath, JSON.stringify(mcpConfig, null, 2));
             log(`[manager] Patched ${entry.name}/${subdir}/.mcp.json: npx \u2192 node`);
           } catch {
           }