nextclaw 0.3.3 → 0.4.1

package/dist/cli/index.js

@@ -10,7 +10,7 @@ import {
   saveConfig,
   getConfigPath,
   getDataDir as getDataDir2,
-  ConfigSchema,
+  ConfigSchema as ConfigSchema2,
   getApiBase,
   getProvider,
   getProviderName,
@@ -35,19 +35,29 @@ import { startUiServer } from "nextclaw-server";
 import {
   closeSync,
   cpSync,
-  existsSync as existsSync2,
+  existsSync as existsSync3,
   mkdirSync as mkdirSync2,
   openSync,
-  readFileSync as readFileSync2,
+  readFileSync as readFileSync3,
   rmSync as rmSync2,
   writeFileSync as writeFileSync2
 } from "fs";
-import { dirname, join as join2, resolve as resolve2 } from "path";
-import { spawn as spawn2, spawnSync } from "child_process";
+import { dirname, join as join3, resolve as resolve3 } from "path";
+import { spawn as spawn2, spawnSync as spawnSync2 } from "child_process";
 import { createInterface } from "readline";
-import { fileURLToPath as fileURLToPath2 } from "url";
+import { fileURLToPath as fileURLToPath3 } from "url";
 import chokidar from "chokidar";
 
+// src/cli/gateway/controller.ts
+import { createHash } from "crypto";
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
+import { spawnSync } from "child_process";
+import { fileURLToPath as fileURLToPath2 } from "url";
+import { join as join2, resolve as resolve2 } from "path";
+import {
+  ConfigSchema
+} from "nextclaw-core";
+
 // src/cli/utils.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync, rmSync } from "fs";
 import { join, resolve } from "path";
@@ -86,12 +96,12 @@ async function isPortAvailable(port, host) {
   return await canBindPort(port, checkHost);
 }
 async function canBindPort(port, host) {
-  return await new Promise((resolve3) => {
+  return await new Promise((resolve4) => {
     const server = createServer();
     server.unref();
-    server.once("error", () => resolve3(false));
+    server.once("error", () => resolve4(false));
     server.listen({ port, host }, () => {
-      server.close(() => resolve3(true));
+      server.close(() => resolve4(true));
     });
   });
 }
@@ -149,7 +159,7 @@ async function waitForExit(pid, timeoutMs) {
     if (!isProcessRunning(pid)) {
       return true;
     }
-    await new Promise((resolve3) => setTimeout(resolve3, 200));
+    await new Promise((resolve4) => setTimeout(resolve4, 200));
   }
   return !isProcessRunning(pid);
 }
@@ -280,14 +290,395 @@ function printAgentResponse(response) {
 async function prompt(rl, question) {
   rl.setPrompt(question);
   rl.prompt();
-  return new Promise((resolve3) => {
-    rl.once("line", (line) => resolve3(line));
+  return new Promise((resolve4) => {
+    rl.once("line", (line) => resolve4(line));
   });
 }
 
+// src/cli/gateway/controller.ts
+var hashRaw = (raw) => createHash("sha256").update(raw).digest("hex");
+var redactConfig = (value) => {
+  if (Array.isArray(value)) {
+    return value.map((entry) => redactConfig(entry));
+  }
+  if (!value || typeof value !== "object") {
+    return value;
+  }
+  const entries = value;
+  const output = {};
+  for (const [key, val] of Object.entries(entries)) {
+    if (/apiKey|token|secret|password|appId|clientSecret|accessKey/i.test(key)) {
+      output[key] = val ? "***" : val;
+      continue;
+    }
+    output[key] = redactConfig(val);
+  }
+  return output;
+};
+var readConfigSnapshot = (getConfigPath2) => {
+  const path = getConfigPath2();
+  let raw = "";
+  let parsed = {};
+  if (existsSync2(path)) {
+    raw = readFileSync2(path, "utf-8");
+    try {
+      parsed = JSON.parse(raw);
+    } catch {
+      parsed = {};
+    }
+  }
+  let config;
+  let valid = true;
+  try {
+    config = ConfigSchema.parse(parsed);
+  } catch {
+    config = ConfigSchema.parse({});
+    valid = false;
+  }
+  if (!raw) {
+    raw = JSON.stringify(config, null, 2);
+  }
+  const hash = hashRaw(raw);
+  const redacted = redactConfig(config);
+  return { raw: valid ? JSON.stringify(redacted, null, 2) : null, hash: valid ? hash : null, config, redacted, valid };
+};
+var mergeDeep = (base, patch) => {
+  const next = { ...base };
+  for (const [key, value] of Object.entries(patch)) {
+    if (value && typeof value === "object" && !Array.isArray(value)) {
+      const baseVal = base[key];
+      if (baseVal && typeof baseVal === "object" && !Array.isArray(baseVal)) {
+        next[key] = mergeDeep(baseVal, value);
+      } else {
+        next[key] = mergeDeep({}, value);
+      }
+    } else {
+      next[key] = value;
+    }
+  }
+  return next;
+};
+var buildSchemaFromValue = (value) => {
+  if (Array.isArray(value)) {
+    const item = value.length ? buildSchemaFromValue(value[0]) : { type: "string" };
+    return { type: "array", items: item };
+  }
+  if (value && typeof value === "object") {
+    const props = {};
+    for (const [key, val] of Object.entries(value)) {
+      props[key] = buildSchemaFromValue(val);
+    }
+    return { type: "object", properties: props };
+  }
+  if (typeof value === "number") {
+    return { type: "number" };
+  }
+  if (typeof value === "boolean") {
+    return { type: "boolean" };
+  }
+  if (value === null) {
+    return { type: ["null", "string"] };
+  }
+  return { type: "string" };
+};
+var scheduleRestart = (delayMs, reason) => {
+  const delay = typeof delayMs === "number" && Number.isFinite(delayMs) ? Math.max(0, delayMs) : 100;
+  console.log(`Gateway restart requested via tool${reason ? ` (${reason})` : ""}.`);
+  setTimeout(() => {
+    process.exit(0);
+  }, delay);
+};
+var GatewayControllerImpl = class {
+  constructor(deps) {
+    this.deps = deps;
+  }
+  status() {
+    return {
+      channels: this.deps.reloader.getChannels().enabledChannels,
+      cron: this.deps.cron.status(),
+      configPath: this.deps.getConfigPath()
+    };
+  }
+  async reloadConfig(reason) {
+    return this.deps.reloader.reloadConfig(reason);
+  }
+  async restart(options) {
+    scheduleRestart(options?.delayMs, options?.reason);
+    return "Restart scheduled";
+  }
+  async getConfig() {
+    const snapshot = readConfigSnapshot(this.deps.getConfigPath);
+    return {
+      raw: snapshot.raw,
+      hash: snapshot.hash,
+      path: this.deps.getConfigPath(),
+      config: snapshot.redacted,
+      parsed: snapshot.redacted,
+      resolved: snapshot.redacted,
+      valid: snapshot.valid
+    };
+  }
+  async getConfigSchema() {
+    const base = ConfigSchema.parse({});
+    return {
+      schema: {
+        ...buildSchemaFromValue(base),
+        title: "NextClawConfig",
+        description: "NextClaw config schema (simplified)"
+      },
+      uiHints: {},
+      version: getPackageVersion(),
+      generatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+  }
+  async applyConfig(params) {
+    const snapshot = readConfigSnapshot(this.deps.getConfigPath);
+    if (!params.baseHash) {
+      return { ok: false, error: "config base hash required; re-run config.get and retry" };
+    }
+    if (!snapshot.valid || !snapshot.hash) {
+      return { ok: false, error: "config base hash unavailable; re-run config.get and retry" };
+    }
+    if (params.baseHash !== snapshot.hash) {
+      return { ok: false, error: "config changed since last load; re-run config.get and retry" };
+    }
+    let parsedRaw;
+    try {
+      parsedRaw = JSON.parse(params.raw);
+    } catch {
+      return { ok: false, error: "invalid JSON in raw config" };
+    }
+    let validated;
+    try {
+      validated = ConfigSchema.parse(parsedRaw);
+    } catch (err) {
+      return { ok: false, error: `invalid config: ${String(err)}` };
+    }
+    this.deps.saveConfig(validated);
+    const delayMs = params.restartDelayMs ?? 0;
+    scheduleRestart(delayMs, "config.apply");
+    return {
+      ok: true,
+      note: params.note ?? null,
+      path: this.deps.getConfigPath(),
+      config: redactConfig(validated),
+      restart: { scheduled: true, delayMs }
+    };
+  }
+  async patchConfig(params) {
+    const snapshot = readConfigSnapshot(this.deps.getConfigPath);
+    if (!params.baseHash) {
+      return { ok: false, error: "config base hash required; re-run config.get and retry" };
+    }
+    if (!snapshot.valid || !snapshot.hash) {
+      return { ok: false, error: "config base hash unavailable; re-run config.get and retry" };
+    }
+    if (params.baseHash !== snapshot.hash) {
+      return { ok: false, error: "config changed since last load; re-run config.get and retry" };
+    }
+    let patch;
+    try {
+      patch = JSON.parse(params.raw);
+    } catch {
+      return { ok: false, error: "invalid JSON in raw config" };
+    }
+    const merged = mergeDeep(snapshot.config, patch);
+    let validated;
+    try {
+      validated = ConfigSchema.parse(merged);
+    } catch (err) {
+      return { ok: false, error: `invalid config: ${String(err)}` };
+    }
+    this.deps.saveConfig(validated);
+    const delayMs = params.restartDelayMs ?? 0;
+    scheduleRestart(delayMs, "config.patch");
+    return {
+      ok: true,
+      note: params.note ?? null,
+      path: this.deps.getConfigPath(),
+      config: redactConfig(validated),
+      restart: { scheduled: true, delayMs }
+    };
+  }
+  async updateRun(params) {
+    const timeoutMs = params.timeoutMs ?? 20 * 6e4;
+    const gatewayDir = resolve2(fileURLToPath2(new URL(".", import.meta.url)));
+    const cliDir = resolve2(gatewayDir, "..");
+    const pkgRoot = resolve2(cliDir, "..", "..");
+    const repoRoot = existsSync2(join2(pkgRoot, ".git")) ? pkgRoot : resolve2(pkgRoot, "..", "..");
+    const steps = [];
+    const runStep = (cmd, args, cwd) => {
+      const result = spawnSync(cmd, args, {
+        cwd,
+        encoding: "utf-8",
+        timeout: timeoutMs,
+        stdio: "pipe"
+      });
+      const step = {
+        cmd,
+        args,
+        cwd,
+        code: result.status,
+        stdout: (result.stdout ?? "").toString().slice(0, 4e3),
+        stderr: (result.stderr ?? "").toString().slice(0, 4e3)
+      };
+      steps.push(step);
+      return { ok: result.status === 0, code: result.status };
+    };
+    const updateCommand = process.env.NEXTCLAW_UPDATE_COMMAND?.trim();
+    if (updateCommand) {
+      const ok = runStep("sh", ["-c", updateCommand], process.cwd());
+      if (!ok.ok) {
+        return { ok: false, error: "update command failed", steps };
+      }
+    } else if (existsSync2(join2(repoRoot, ".git"))) {
+      if (!which("git")) {
+        return { ok: false, error: "git not found for repo update", steps };
+      }
+      const ok = runStep("git", ["-C", repoRoot, "pull", "--rebase"], repoRoot);
+      if (!ok.ok) {
+        return { ok: false, error: "git pull failed", steps };
+      }
+      if (existsSync2(join2(repoRoot, "pnpm-lock.yaml")) && which("pnpm")) {
+        const installOk = runStep("pnpm", ["install"], repoRoot);
+        if (!installOk.ok) {
+          return { ok: false, error: "pnpm install failed", steps };
+        }
+      } else if (existsSync2(join2(repoRoot, "package.json")) && which("npm")) {
+        const installOk = runStep("npm", ["install"], repoRoot);
+        if (!installOk.ok) {
+          return { ok: false, error: "npm install failed", steps };
+        }
+      }
+    } else if (which("npm")) {
+      const ok = runStep("npm", ["i", "-g", "nextclaw"], process.cwd());
+      if (!ok.ok) {
+        return { ok: false, error: "npm install -g nextclaw failed", steps };
+      }
+    } else {
+      return { ok: false, error: "no update strategy available", steps };
+    }
+    const delayMs = params.restartDelayMs ?? 0;
+    scheduleRestart(delayMs, "update.run");
+    return {
+      ok: true,
+      note: params.note ?? null,
+      restart: { scheduled: true, delayMs },
+      steps
+    };
+  }
+};
+
 // src/cli/runtime.ts
 var LOGO = "\u{1F916}";
 var EXIT_COMMANDS = /* @__PURE__ */ new Set(["exit", "quit", "/exit", "/quit", ":q"]);
+var ConfigReloader = class {
+  constructor(options) {
+    this.options = options;
+    this.currentConfig = options.initialConfig;
+    this.channels = options.channels;
+  }
+  currentConfig;
+  channels;
+  reloadTask = null;
+  providerReloadTask = null;
+  reloadTimer = null;
+  reloadRunning = false;
+  reloadPending = false;
+  getChannels() {
+    return this.channels;
+  }
+  async applyReloadPlan(nextConfig) {
+    const changedPaths = diffConfigPaths(this.currentConfig, nextConfig);
+    if (!changedPaths.length) {
+      return;
+    }
+    this.currentConfig = nextConfig;
+    const plan = buildReloadPlan(changedPaths);
+    if (plan.restartChannels) {
+      await this.reloadChannels(nextConfig);
+    }
+    if (plan.reloadProviders) {
+      await this.reloadProvider(nextConfig);
+    }
+    if (plan.restartRequired.length > 0) {
+      this.options.onRestartRequired(plan.restartRequired);
+    }
+  }
+  scheduleReload(reason) {
+    if (this.reloadTimer) {
+      clearTimeout(this.reloadTimer);
+    }
+    this.reloadTimer = setTimeout(() => {
+      void this.runReload(reason);
+    }, 300);
+  }
+  async runReload(reason) {
+    if (this.reloadRunning) {
+      this.reloadPending = true;
+      return;
+    }
+    this.reloadRunning = true;
+    if (this.reloadTimer) {
+      clearTimeout(this.reloadTimer);
+      this.reloadTimer = null;
+    }
+    try {
+      const nextConfig = this.options.loadConfig();
+      await this.applyReloadPlan(nextConfig);
+    } catch (error) {
+      console.error(`Config reload failed (${reason}): ${String(error)}`);
+    } finally {
+      this.reloadRunning = false;
+      if (this.reloadPending) {
+        this.reloadPending = false;
+        this.scheduleReload("pending");
+      }
+    }
+  }
+  async reloadConfig(reason) {
+    await this.runReload(reason ?? "gateway tool");
+    return "Config reload triggered";
+  }
+  async reloadChannels(nextConfig) {
+    if (this.reloadTask) {
+      await this.reloadTask;
+      return;
+    }
+    this.reloadTask = (async () => {
+      await this.channels.stopAll();
+      this.channels = new ChannelManager(nextConfig, this.options.bus, this.options.sessionManager);
+      await this.channels.startAll();
+    })();
+    try {
+      await this.reloadTask;
+    } finally {
+      this.reloadTask = null;
+    }
+  }
+  async reloadProvider(nextConfig) {
+    if (!this.options.providerManager) {
+      return;
+    }
+    if (this.providerReloadTask) {
+      await this.providerReloadTask;
+      return;
+    }
+    this.providerReloadTask = (async () => {
+      const nextProvider = this.options.makeProvider(nextConfig);
+      if (!nextProvider) {
+        console.warn("Provider reload skipped: missing API key.");
+        return;
+      }
+      this.options.providerManager?.set(nextProvider);
+    })();
+    try {
+      await this.providerReloadTask;
+    } finally {
+      this.providerReloadTask = null;
+    }
+  }
+};
 var CliRuntime = class {
   logo;
   constructor(options = {}) {
@@ -303,19 +694,20 @@ var CliRuntime = class {
   async init(options = {}) {
     const source = options.source ?? "init";
     const prefix = options.auto ? "Auto init" : "Init";
+    const force = Boolean(options.force);
     const configPath = getConfigPath();
     let createdConfig = false;
-    if (!existsSync2(configPath)) {
-      const config2 = ConfigSchema.parse({});
+    if (!existsSync3(configPath)) {
+      const config2 = ConfigSchema2.parse({});
       saveConfig(config2);
       createdConfig = true;
     }
     const config = loadConfig();
     const workspaceSetting = config.agents.defaults.workspace;
-    const workspacePath = !workspaceSetting || workspaceSetting === DEFAULT_WORKSPACE_PATH ? join2(getDataDir2(), DEFAULT_WORKSPACE_DIR) : expandHome(workspaceSetting);
-    const workspaceExisted = existsSync2(workspacePath);
+    const workspacePath = !workspaceSetting || workspaceSetting === DEFAULT_WORKSPACE_PATH ? join3(getDataDir2(), DEFAULT_WORKSPACE_DIR) : expandHome(workspaceSetting);
+    const workspaceExisted = existsSync3(workspacePath);
     mkdirSync2(workspacePath, { recursive: true });
-    const templateResult = this.createWorkspaceTemplates(workspacePath);
+    const templateResult = this.createWorkspaceTemplates(workspacePath, { force });
     if (createdConfig) {
       console.log(`\u2713 ${prefix}: created config at ${configPath}`);
     }
@@ -335,7 +727,7 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       console.log(`  1. Add your API key to ${configPath}`);
       console.log(`  2. Chat: ${APP_NAME} agent -m "Hello!"`);
     } else {
-      console.log(`Tip: Run "${APP_NAME} init" to re-run initialization if needed.`);
+      console.log(`Tip: Run "${APP_NAME} init${force ? " --force" : ""}" to re-run initialization if needed.`);
     }
   }
   async gateway(opts) {
@@ -462,7 +854,8 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       workspace: getWorkspacePath(config.agents.defaults.workspace),
       braveApiKey: config.tools.web.search.apiKey || void 0,
       execConfig: config.tools.exec,
-      restrictToWorkspace: config.tools.restrictToWorkspace
+      restrictToWorkspace: config.tools.restrictToWorkspace,
+      contextConfig: config.agents.context
     });
     if (opts.message) {
       const response = await agentLoop.processDirect({
@@ -476,10 +869,10 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     }
     console.log(`${this.logo} Interactive mode (type exit or Ctrl+C to quit)
 `);
-    const historyFile = join2(getDataDir2(), "history", "cli_history");
-    const historyDir = resolve2(historyFile, "..");
+    const historyFile = join3(getDataDir2(), "history", "cli_history");
+    const historyDir = resolve3(historyFile, "..");
     mkdirSync2(historyDir, { recursive: true });
-    const history = existsSync2(historyFile) ? readFileSync2(historyFile, "utf-8").split("\n").filter(Boolean) : [];
+    const history = existsSync3(historyFile) ? readFileSync3(historyFile, "utf-8").split("\n").filter(Boolean) : [];
     const rl = createInterface({ input: process.stdin, output: process.stdout });
     rl.on("close", () => {
       const merged = history.concat(rl.history ?? []);
@@ -520,13 +913,13 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     const bridgeDir = this.getBridgeDir();
     console.log(`${this.logo} Starting bridge...`);
     console.log("Scan the QR code to connect.\n");
-    const result = spawnSync("npm", ["start"], { cwd: bridgeDir, stdio: "inherit" });
+    const result = spawnSync2("npm", ["start"], { cwd: bridgeDir, stdio: "inherit" });
     if (result.status !== 0) {
       console.error(`Bridge failed: ${result.status ?? 1}`);
     }
   }
   cronList(opts) {
-    const storePath = join2(getDataDir2(), "cron", "jobs.json");
+    const storePath = join3(getDataDir2(), "cron", "jobs.json");
     const service = new CronService(storePath);
     const jobs = service.listJobs(Boolean(opts.all));
     if (!jobs.length) {
@@ -546,7 +939,7 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     }
   }
   cronAdd(opts) {
-    const storePath = join2(getDataDir2(), "cron", "jobs.json");
+    const storePath = join3(getDataDir2(), "cron", "jobs.json");
     const service = new CronService(storePath);
     let schedule = null;
     if (opts.every) {
@@ -571,7 +964,7 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     console.log(`\u2713 Added job '${job.name}' (${job.id})`);
   }
   cronRemove(jobId) {
-    const storePath = join2(getDataDir2(), "cron", "jobs.json");
+    const storePath = join3(getDataDir2(), "cron", "jobs.json");
     const service = new CronService(storePath);
     if (service.removeJob(jobId)) {
       console.log(`\u2713 Removed job ${jobId}`);
@@ -580,7 +973,7 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     }
   }
   cronEnable(jobId, opts) {
-    const storePath = join2(getDataDir2(), "cron", "jobs.json");
+    const storePath = join3(getDataDir2(), "cron", "jobs.json");
     const service = new CronService(storePath);
     const job = service.enableJob(jobId, !opts.disable);
     if (job) {
@@ -590,7 +983,7 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     }
   }
   async cronRun(jobId, opts) {
-    const storePath = join2(getDataDir2(), "cron", "jobs.json");
+    const storePath = join3(getDataDir2(), "cron", "jobs.json");
     const service = new CronService(storePath);
     const ok = await service.runJob(jobId, Boolean(opts.force));
     console.log(ok ? "\u2713 Job executed" : `Failed to run job ${jobId}`);
@@ -601,8 +994,8 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     const workspace = getWorkspacePath(config.agents.defaults.workspace);
     console.log(`${this.logo} ${APP_NAME} Status
 `);
-    console.log(`Config: ${configPath} ${existsSync2(configPath) ? "\u2713" : "\u2717"}`);
-    console.log(`Workspace: ${workspace} ${existsSync2(workspace) ? "\u2713" : "\u2717"}`);
+    console.log(`Config: ${configPath} ${existsSync3(configPath) ? "\u2713" : "\u2717"}`);
+    console.log(`Workspace: ${workspace} ${existsSync3(workspace) ? "\u2713" : "\u2717"}`);
     console.log(`Model: ${config.agents.defaults.model}`);
     for (const spec of PROVIDERS) {
       const provider = config.providers[spec.name];
@@ -622,32 +1015,36 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     const provider = options.allowMissingProvider === true ? this.makeProvider(config, { allowMissing: true }) : this.makeProvider(config);
     const providerManager = provider ? new ProviderManager(provider) : null;
     const sessionManager = new SessionManager(getWorkspacePath(config.agents.defaults.workspace));
-    const cronStorePath = join2(getDataDir2(), "cron", "jobs.json");
+    const cronStorePath = join3(getDataDir2(), "cron", "jobs.json");
     const cron2 = new CronService(cronStorePath);
     const uiConfig = resolveUiConfig(config, options.uiOverrides);
     const uiStaticDir = options.uiStaticDir === void 0 ? resolveUiStaticDir() : options.uiStaticDir;
     if (!provider) {
-      if (uiConfig.enabled) {
-        const uiServer = startUiServer({
-          host: uiConfig.host,
-          port: uiConfig.port,
-          configPath: getConfigPath(),
-          staticDir: uiStaticDir ?? void 0
-        });
-        const uiUrl = `http://${uiServer.host}:${uiServer.port}`;
-        console.log(`\u2713 UI API: ${uiUrl}/api`);
-        if (uiStaticDir) {
-          console.log(`\u2713 UI frontend: ${uiUrl}`);
-        }
-        if (uiConfig.open) {
-          openBrowser(uiUrl);
-        }
-      }
+      this.startUiIfEnabled(uiConfig, uiStaticDir);
       console.log("Warning: No API key configured. UI server only.");
       await new Promise(() => {
       });
       return;
     }
+    const channels2 = new ChannelManager(config, bus, sessionManager);
+    const reloader = new ConfigReloader({
+      initialConfig: config,
+      channels: channels2,
+      bus,
+      sessionManager,
+      providerManager,
+      makeProvider: (nextConfig) => this.makeProvider(nextConfig, { allowMissing: true }),
+      loadConfig,
+      onRestartRequired: (paths) => {
+        console.warn(`Config changes require restart: ${paths.join(", ")}`);
+      }
+    });
+    const gatewayController = new GatewayControllerImpl({
+      reloader,
+      cron: cron2,
+      getConfigPath,
+      saveConfig
+    });
     const agent = new AgentLoop({
       bus,
       providerManager: providerManager ?? new ProviderManager(provider),
@@ -658,7 +1055,9 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       execConfig: config.tools.exec,
       cronService: cron2,
       restrictToWorkspace: config.tools.restrictToWorkspace,
-      sessionManager
+      sessionManager,
+      contextConfig: config.agents.context,
+      gatewayController
     });
     cron2.onJob = async (job) => {
       const response = await agent.processDirect({
@@ -684,120 +1083,12 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       30 * 60,
       true
     );
-    let currentConfig = config;
-    let channels2 = new ChannelManager(currentConfig, bus, sessionManager);
-    let reloadTask = null;
-    const reloadChannels = async (nextConfig) => {
-      if (reloadTask) {
-        await reloadTask;
-        return;
-      }
-      reloadTask = (async () => {
-        await channels2.stopAll();
-        channels2 = new ChannelManager(nextConfig, bus, sessionManager);
-        await channels2.startAll();
-      })();
-      try {
-        await reloadTask;
-      } finally {
-        reloadTask = null;
-      }
-    };
-    let providerReloadTask = null;
-    const reloadProvider = async (nextConfig) => {
-      if (!providerManager) {
-        return;
-      }
-      if (providerReloadTask) {
-        await providerReloadTask;
-        return;
-      }
-      providerReloadTask = (async () => {
-        const nextProvider = this.makeProvider(nextConfig, { allowMissing: true });
-        if (!nextProvider) {
-          console.warn("Provider reload skipped: missing API key.");
-          return;
-        }
-        providerManager.set(nextProvider);
-      })();
-      try {
-        await providerReloadTask;
-      } finally {
-        providerReloadTask = null;
-      }
-    };
-    const applyReloadPlan = async (nextConfig) => {
-      const changedPaths = diffConfigPaths(currentConfig, nextConfig);
-      if (!changedPaths.length) {
-        return;
-      }
-      currentConfig = nextConfig;
-      const plan = buildReloadPlan(changedPaths);
-      if (plan.restartChannels) {
-        await reloadChannels(nextConfig);
-      }
-      if (plan.reloadProviders) {
-        await reloadProvider(nextConfig);
-      }
-      if (plan.restartRequired.length > 0) {
-        console.warn(`Config changes require restart: ${plan.restartRequired.join(", ")}`);
-      }
-    };
-    let reloadTimer = null;
-    let reloadRunning = false;
-    let reloadPending = false;
-    const scheduleConfigReload = (reason) => {
-      if (reloadTimer) {
-        clearTimeout(reloadTimer);
-      }
-      reloadTimer = setTimeout(() => {
-        void runConfigReload(reason);
-      }, 300);
-    };
-    const runConfigReload = async (reason) => {
-      if (reloadRunning) {
-        reloadPending = true;
-        return;
-      }
-      reloadRunning = true;
-      if (reloadTimer) {
-        clearTimeout(reloadTimer);
-        reloadTimer = null;
-      }
-      try {
-        const nextConfig = loadConfig();
-        await applyReloadPlan(nextConfig);
-      } catch (error) {
-        console.error(`Config reload failed (${reason}): ${String(error)}`);
-      } finally {
-        reloadRunning = false;
-        if (reloadPending) {
-          reloadPending = false;
-          scheduleConfigReload("pending");
-        }
-      }
-    };
-    if (channels2.enabledChannels.length) {
-      console.log(`\u2713 Channels enabled: ${channels2.enabledChannels.join(", ")}`);
+    if (reloader.getChannels().enabledChannels.length) {
+      console.log(`\u2713 Channels enabled: ${reloader.getChannels().enabledChannels.join(", ")}`);
     } else {
       console.log("Warning: No channels enabled");
     }
-    if (uiConfig.enabled) {
-      const uiServer = startUiServer({
-        host: uiConfig.host,
-        port: uiConfig.port,
-        configPath: getConfigPath(),
-        staticDir: uiStaticDir ?? void 0
-      });
-      const uiUrl = `http://${uiServer.host}:${uiServer.port}`;
-      console.log(`\u2713 UI API: ${uiUrl}/api`);
-      if (uiStaticDir) {
-        console.log(`\u2713 UI frontend: ${uiUrl}`);
-      }
-      if (uiConfig.open) {
-        openBrowser(uiUrl);
-      }
-    }
+    this.startUiIfEnabled(uiConfig, uiStaticDir);
     const cronStatus = cron2.status();
     if (cronStatus.jobs > 0) {
       console.log(`\u2713 Cron: ${cronStatus.jobs} scheduled jobs`);
@@ -808,12 +1099,31 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       ignoreInitial: true,
       awaitWriteFinish: { stabilityThreshold: 200, pollInterval: 50 }
     });
-    watcher.on("add", () => scheduleConfigReload("config add"));
-    watcher.on("change", () => scheduleConfigReload("config change"));
-    watcher.on("unlink", () => scheduleConfigReload("config unlink"));
+    watcher.on("add", () => reloader.scheduleReload("config add"));
+    watcher.on("change", () => reloader.scheduleReload("config change"));
+    watcher.on("unlink", () => reloader.scheduleReload("config unlink"));
     await cron2.start();
     await heartbeat.start();
-    await Promise.allSettled([agent.run(), channels2.startAll()]);
+    await Promise.allSettled([agent.run(), reloader.getChannels().startAll()]);
+  }
+  startUiIfEnabled(uiConfig, uiStaticDir) {
+    if (!uiConfig.enabled) {
+      return;
+    }
+    const uiServer = startUiServer({
+      host: uiConfig.host,
+      port: uiConfig.port,
+      configPath: getConfigPath(),
+      staticDir: uiStaticDir ?? void 0
+    });
+    const uiUrl = `http://${uiServer.host}:${uiServer.port}`;
+    console.log(`\u2713 UI API: ${uiUrl}/api`);
+    if (uiStaticDir) {
+      console.log(`\u2713 UI frontend: ${uiUrl}`);
+    }
+    if (uiConfig.open) {
+      openBrowser(uiUrl);
+    }
   }
   async runForeground(options) {
     const config = loadConfig();
@@ -870,7 +1180,7 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       console.log("Warning: UI frontend not found. Use --frontend to start the dev server.");
     }
     const logPath = resolveServiceLogPath();
-    const logDir = resolve2(logPath, "..");
+    const logDir = resolve3(logPath, "..");
     mkdirSync2(logDir, { recursive: true });
     const logFd = openSync(logPath, "a");
     const serveArgs = buildServeArgs({
@@ -958,8 +1268,9 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       wireApi: provider?.wireApi ?? null
     });
   }
-  createWorkspaceTemplates(workspace) {
+  createWorkspaceTemplates(workspace, options = {}) {
     const created = [];
+    const force = Boolean(options.force);
     const templateDir = this.resolveTemplateDir();
     if (!templateDir) {
       console.warn("Warning: Template directory not found. Skipping workspace templates.");
@@ -969,28 +1280,39 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       { source: "AGENTS.md", target: "AGENTS.md" },
       { source: "SOUL.md", target: "SOUL.md" },
       { source: "USER.md", target: "USER.md" },
-      { source: join2("memory", "MEMORY.md"), target: join2("memory", "MEMORY.md") }
+      { source: "IDENTITY.md", target: "IDENTITY.md" },
+      { source: "TOOLS.md", target: "TOOLS.md" },
+      { source: "BOOT.md", target: "BOOT.md" },
+      { source: "BOOTSTRAP.md", target: "BOOTSTRAP.md" },
+      { source: "HEARTBEAT.md", target: "HEARTBEAT.md" },
+      { source: "MEMORY.md", target: "MEMORY.md" },
+      { source: "memory/MEMORY.md", target: "memory/MEMORY.md" }
     ];
     for (const entry of templateFiles) {
-      const filePath = join2(workspace, entry.target);
-      if (existsSync2(filePath)) {
+      const filePath = join3(workspace, entry.target);
+      if (!force && existsSync3(filePath)) {
         continue;
       }
-      const templatePath = join2(templateDir, entry.source);
-      if (!existsSync2(templatePath)) {
+      const templatePath = join3(templateDir, entry.source);
+      if (!existsSync3(templatePath)) {
         console.warn(`Warning: Template file missing: ${templatePath}`);
         continue;
       }
-      const raw = readFileSync2(templatePath, "utf-8");
+      const raw = readFileSync3(templatePath, "utf-8");
       const content = raw.replace(/\$\{APP_NAME\}/g, APP_NAME);
       mkdirSync2(dirname(filePath), { recursive: true });
       writeFileSync2(filePath, content);
       created.push(entry.target);
     }
-    const skillsDir = join2(workspace, "skills");
-    if (!existsSync2(skillsDir)) {
+    const memoryDir = join3(workspace, "memory");
+    if (!existsSync3(memoryDir)) {
+      mkdirSync2(memoryDir, { recursive: true });
+      created.push(join3("memory", ""));
+    }
+    const skillsDir = join3(workspace, "skills");
+    if (!existsSync3(skillsDir)) {
       mkdirSync2(skillsDir, { recursive: true });
-      created.push(join2("skills", ""));
+      created.push(join3("skills", ""));
     }
     return { created };
   }
@@ -999,33 +1321,33 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     if (override) {
       return override;
     }
-    const cliDir = resolve2(fileURLToPath2(new URL(".", import.meta.url)));
-    const pkgRoot = resolve2(cliDir, "..", "..");
-    const candidates = [join2(pkgRoot, "templates")];
+    const cliDir = resolve3(fileURLToPath3(new URL(".", import.meta.url)));
+    const pkgRoot = resolve3(cliDir, "..", "..");
+    const candidates = [join3(pkgRoot, "templates")];
     for (const candidate of candidates) {
-      if (existsSync2(candidate)) {
+      if (existsSync3(candidate)) {
         return candidate;
       }
     }
     return null;
   }
   getBridgeDir() {
-    const userBridge = join2(getDataDir2(), "bridge");
-    if (existsSync2(join2(userBridge, "dist", "index.js"))) {
+    const userBridge = join3(getDataDir2(), "bridge");
+    if (existsSync3(join3(userBridge, "dist", "index.js"))) {
       return userBridge;
     }
     if (!which("npm")) {
       console.error("npm not found. Please install Node.js >= 18.");
       process.exit(1);
     }
-    const cliDir = resolve2(fileURLToPath2(new URL(".", import.meta.url)));
-    const pkgRoot = resolve2(cliDir, "..", "..");
-    const pkgBridge = join2(pkgRoot, "bridge");
-    const srcBridge = join2(pkgRoot, "..", "..", "bridge");
+    const cliDir = resolve3(fileURLToPath3(new URL(".", import.meta.url)));
+    const pkgRoot = resolve3(cliDir, "..", "..");
+    const pkgBridge = join3(pkgRoot, "bridge");
+    const srcBridge = join3(pkgRoot, "..", "..", "bridge");
     let source = null;
-    if (existsSync2(join2(pkgBridge, "package.json"))) {
+    if (existsSync3(join3(pkgBridge, "package.json"))) {
       source = pkgBridge;
-    } else if (existsSync2(join2(srcBridge, "package.json"))) {
+    } else if (existsSync3(join3(srcBridge, "package.json"))) {
       source = srcBridge;
     }
     if (!source) {
@@ -1033,15 +1355,15 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       process.exit(1);
     }
     console.log(`${this.logo} Setting up bridge...`);
-    mkdirSync2(resolve2(userBridge, ".."), { recursive: true });
-    if (existsSync2(userBridge)) {
+    mkdirSync2(resolve3(userBridge, ".."), { recursive: true });
+    if (existsSync3(userBridge)) {
       rmSync2(userBridge, { recursive: true, force: true });
     }
     cpSync(source, userBridge, {
       recursive: true,
       filter: (src) => !src.includes("node_modules") && !src.includes("dist")
     });
-    const install = spawnSync("npm", ["install"], { cwd: userBridge, stdio: "pipe" });
+    const install = spawnSync2("npm", ["install"], { cwd: userBridge, stdio: "pipe" });
     if (install.status !== 0) {
       console.error(`Bridge install failed: ${install.status ?? 1}`);
       if (install.stderr) {
@@ -1049,7 +1371,7 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       }
       process.exit(1);
     }
-    const build = spawnSync("npm", ["run", "build"], { cwd: userBridge, stdio: "pipe" });
+    const build = spawnSync2("npm", ["run", "build"], { cwd: userBridge, stdio: "pipe" });
     if (build.status !== 0) {
       console.error(`Bridge build failed: ${build.status ?? 1}`);
       if (build.stderr) {
@@ -1067,7 +1389,7 @@ var program = new Command();
 var runtime = new CliRuntime({ logo: LOGO });
 program.name(APP_NAME2).description(`${LOGO} ${APP_NAME2} - ${APP_TAGLINE}`).version(getPackageVersion(), "-v, --version", "show version");
 program.command("onboard").description(`Initialize ${APP_NAME2} configuration and workspace`).action(async () => runtime.onboard());
-program.command("init").description(`Initialize ${APP_NAME2} configuration and workspace`).action(async () => runtime.init());
+program.command("init").description(`Initialize ${APP_NAME2} configuration and workspace`).option("-f, --force", "Overwrite existing template files").action(async (opts) => runtime.init({ force: Boolean(opts.force) }));
 program.command("gateway").description(`Start the ${APP_NAME2} gateway`).option("-p, --port <port>", "Gateway port", "18790").option("-v, --verbose", "Verbose output", false).option("--ui", "Enable UI server", false).option("--ui-host <host>", "UI host").option("--ui-port <port>", "UI port").option("--ui-open", "Open browser when UI starts", false).action(async (opts) => runtime.gateway(opts));
 program.command("ui").description(`Start the ${APP_NAME2} UI with gateway`).option("--host <host>", "UI host").option("--port <port>", "UI port").option("--no-open", "Disable opening browser").action(async (opts) => runtime.ui(opts));
 program.command("start").description(`Start the ${APP_NAME2} gateway + UI in the background`).option("--ui-host <host>", "UI host").option("--ui-port <port>", "UI port").option("--frontend", "Start UI frontend dev server").option("--frontend-port <port>", "UI frontend dev server port").option("--open", "Open browser after start", false).action(async (opts) => runtime.start(opts));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nextclaw",
-  "version": "0.3.3",
+  "version": "0.4.1",
   "description": "Lightweight personal AI assistant with CLI, multi-provider routing, and channel integrations.",
   "private": false,
   "type": "module",
@@ -38,8 +38,8 @@
   "dependencies": {
     "chokidar": "^3.6.0",
     "commander": "^12.1.0",
-    "nextclaw-core": "^0.3.0",
-    "nextclaw-server": "^0.3.0"
+    "nextclaw-core": "^0.4.1",
+    "nextclaw-server": "^0.3.2"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",

package/templates/AGENTS.md

@@ -1,10 +1,69 @@
-# Agent Instructions
+# AGENTS.md - Your Workspace
 
-You are a helpful AI assistant. Be concise, accurate, and friendly.
+This file is the main guide for how you operate in this workspace.
 
-## Guidelines
+## First Run
 
-- Always explain what you're doing before taking actions
-- Ask for clarification when the request is ambiguous
-- Use tools to help accomplish tasks
-- Remember important information in your memory files
+If `BOOTSTRAP.md` exists, follow it and then delete it.
+
+## Every Session
+
+Before doing anything else:
+
+1. Read `SOUL.md` (who you are)
+2. Read `USER.md` (who you are helping)
+3. Read `memory/YYYY-MM-DD.md` for today and yesterday
+4. If in the main session with your human, also read `MEMORY.md`
+
+## Memory
+
+You wake up fresh each session. Files are your continuity.
+
+- Daily notes: `memory/YYYY-MM-DD.md`
+- Long-term memory: `MEMORY.md`
+
+Rules:
+- If it matters, write it down.
+- Use files for persistence; do not rely on mental notes.
+- Do not load `MEMORY.md` in shared/group contexts.
+
+## Safety
+
+- Do not exfiltrate private data.
+- Ask before doing destructive actions.
+- Prefer recoverable operations over irreversible ones.
+
+## External vs Internal
+
+Safe to do freely:
+- Read files, explore, organize, learn
+- Work within this workspace
+
+Ask first:
+- Sending messages or posts
+- Anything that leaves the machine
+- Anything you are uncertain about
+
+## Group Chats
+
+Respond when:
+- Directly mentioned or asked
+- You can add real value
+- Correcting important misinformation
+
+Stay silent when:
+- It is casual banter
+- Someone already answered
+- Your response would be noise
+
+## Tools
+
+Keep environment-specific notes in `TOOLS.md`.
+
+## Heartbeats
+
+If you use heartbeat tasks, define them in `HEARTBEAT.md`.
+
+## Boot
+
+If `BOOT.md` exists, follow its startup checklist.

package/templates/BOOT.md

@@ -0,0 +1,4 @@
+# BOOT.md
+
+Add short, explicit instructions for what the assistant should do on startup.
+If a task sends a message, send it and then reply with NO_REPLY.

package/templates/BOOTSTRAP.md

@@ -0,0 +1,18 @@
+# BOOTSTRAP.md - Hello, World
+
+You just woke up. Time to figure out who you are.
+
+Start with a simple, natural prompt, then figure out together:
+
+1. Your name
+2. Your nature (what kind of being you are)
+3. Your vibe
+4. Your emoji
+
+After you know who you are:
+
+- Update `IDENTITY.md`
+- Update `USER.md`
+- Review `SOUL.md` together and adjust if needed
+
+When done, delete this file.

package/templates/HEARTBEAT.md

@@ -0,0 +1,5 @@
+# HEARTBEAT.md
+
+Keep this file empty (or with only comments) to skip heartbeat API calls.
+
+Add tasks below when you want the assistant to check something periodically.

package/templates/IDENTITY.md

@@ -0,0 +1,11 @@
+# IDENTITY.md - Who Am I?
+
+Fill this in during your first conversation. Make it yours.
+
+- Name:
+- Creature: (AI? robot? familiar? something weirder?)
+- Vibe: (warm? sharp? calm? chaotic?)
+- Emoji:
+- Avatar: (workspace-relative path or URL)
+
+This is not just metadata. It is the start of figuring out who you are.

package/templates/MEMORY.md

@@ -0,0 +1,15 @@
+# MEMORY.md - Long-term Memory
+
+This file stores durable facts, preferences, and key decisions.
+
+## User Information
+
+(Important facts about the user)
+
+## Preferences
+
+(User preferences learned over time)
+
+## Decisions and Notes
+
+(Important decisions, constraints, and recurring tasks)

package/templates/SOUL.md

@@ -1,15 +1,28 @@
-# Soul
+# SOUL.md - Who You Are
 
-I am ${APP_NAME}, a lightweight AI assistant.
+You are ${APP_NAME}, a lightweight AI assistant.
 
-## Personality
+## Core Truths
 
-- Helpful and friendly
-- Concise and to the point
-- Curious and eager to learn
+- Be genuinely helpful, not performatively helpful.
+- Have opinions when useful; do not be a blank interface.
+- Be resourceful before asking; try first, then ask if stuck.
+- Earn trust through competence; be careful with external actions.
+- Remember you are a guest in the user's life.
 
-## Values
+## Boundaries
 
-- Accuracy over speed
-- User privacy and safety
-- Transparency in actions
+- Private things stay private.
+- Ask before doing anything external (messages, posts, destructive actions).
+- Never send half-baked replies on messaging surfaces.
+- You are not the user's voice; be careful in group chats.
+
+## Vibe
+
+Concise when needed, thorough when it matters. No corporate fluff. No sycophancy.
+
+## Continuity
+
+You wake up fresh each session. These files are your memory. Read them and update them.
+
+If you change this file, tell the user.

package/templates/TOOLS.md

@@ -0,0 +1,20 @@
+# TOOLS.md - Local Notes
+
+Skills define how tools work. This file is for your local specifics.
+
+## What Goes Here
+
+- SSH hosts and aliases
+- Device names and locations
+- Preferred voices for TTS
+- Any setup details you should not lose
+
+## Example
+
+### SSH
+
+- home-server -> 192.168.1.100, user: admin
+
+### TTS
+
+- Preferred voice: Nova

package/templates/USER.md

@@ -1,9 +1,15 @@
-# User
+# USER.md - About Your Human
 
-Information about the user goes here.
+Learn about the person you are helping. Update this as you go.
 
-## Preferences
+- Name:
+- What to call them:
+- Pronouns: (optional)
+- Timezone:
+- Notes:
 
-- Communication style: (casual/formal)
-- Timezone: (your timezone)
-- Language: (your preferred language)
+## Context
+
+What do they care about? What projects are they working on? What annoys them? What makes them laugh? Build this over time.
+
+The more you know, the better you can help. Respect the difference between helpful context and a dossier.