nextclaw 0.4.16 → 0.5.0

package/dist/cli/index.js

@@ -82,7 +82,7 @@ import {
 import { existsSync, mkdirSync, readFileSync, writeFileSync, rmSync } from "fs";
 import { join, resolve } from "path";
 import { spawn } from "child_process";
-import { createServer, isIP } from "net";
+import { isIP } from "net";
 import { fileURLToPath } from "url";
 import { getDataDir, getPackageVersion as getCorePackageVersion } from "@nextclaw/core";
 function resolveUiConfig(config2, overrides) {
@@ -128,48 +128,9 @@ async function resolvePublicIp(timeoutMs = 1500) {
   }
   return null;
 }
-function isDevRuntime() {
-  return import.meta.url.includes("/src/cli/") || process.env.NEXTCLAW_DEV === "1";
-}
-function normalizeHostForPortCheck(host) {
-  return host === "0.0.0.0" || host === "::" ? "127.0.0.1" : host;
-}
-async function findAvailablePort(port, host, attempts = 20) {
-  const basePort = Number.isFinite(port) ? port : 0;
-  let candidate = basePort;
-  for (let i = 0; i < attempts; i += 1) {
-    const ok = await isPortAvailable(candidate, host);
-    if (ok) {
-      return candidate;
-    }
-    candidate += 1;
-  }
-  return basePort;
-}
-async function isPortAvailable(port, host) {
-  const checkHost = normalizeHostForPortCheck(host);
-  return await canBindPort(port, checkHost);
-}
-async function canBindPort(port, host) {
-  return await new Promise((resolve5) => {
-    const server = createServer();
-    server.unref();
-    server.once("error", () => resolve5(false));
-    server.listen({ port, host }, () => {
-      server.close(() => resolve5(true));
-    });
-  });
-}
 function buildServeArgs(options) {
   const cliPath = fileURLToPath(new URL("./index.js", import.meta.url));
-  const args = [cliPath, "serve", "--ui-host", options.uiHost, "--ui-port", String(options.uiPort)];
-  if (options.frontend) {
-    args.push("--frontend");
-  }
-  if (Number.isFinite(options.frontendPort)) {
-    args.push("--frontend-port", String(options.frontendPort));
-  }
-  return args;
+  return [cliPath, "serve", "--ui-host", options.uiHost, "--ui-port", String(options.uiPort)];
 }
 function readServiceState() {
   const path = resolveServiceStatePath();
@@ -298,64 +259,6 @@ function getPackageVersion() {
   const cliDir = resolve(fileURLToPath(new URL(".", import.meta.url)));
   return resolveVersionFromPackageTree(cliDir, "nextclaw") ?? resolveVersionFromPackageTree(cliDir) ?? getCorePackageVersion();
 }
-function startUiFrontend(options) {
-  const uiDir = options.dir ?? resolveUiFrontendDir();
-  if (!uiDir) {
-    return null;
-  }
-  const runner = resolveUiFrontendRunner();
-  if (!runner) {
-    console.log("Warning: pnpm/npm not found. Skipping UI frontend.");
-    return null;
-  }
-  const args = [...runner.args];
-  if (options.port) {
-    if (runner.useArgSeparator) {
-      args.push("--");
-    }
-    args.push("--port", String(options.port));
-  }
-  const env = { ...process.env, VITE_API_BASE: options.apiBase };
-  const child = spawn(runner.cmd, args, { cwd: uiDir, stdio: "inherit", env });
-  child.on("exit", (code) => {
-    if (code && code !== 0) {
-      console.log(`UI frontend exited with code ${code}`);
-    }
-  });
-  const url = `http://127.0.0.1:${options.port}`;
-  console.log(`\u2713 UI frontend: ${url}`);
-  return { url, dir: uiDir };
-}
-function resolveUiFrontendRunner() {
-  if (which("pnpm")) {
-    return { cmd: "pnpm", args: ["dev"], useArgSeparator: false };
-  }
-  if (which("npm")) {
-    return { cmd: "npm", args: ["run", "dev"], useArgSeparator: true };
-  }
-  return null;
-}
-function resolveUiFrontendDir() {
-  const candidates = [];
-  const envDir = process.env.NEXTCLAW_UI_DIR;
-  if (envDir) {
-    candidates.push(envDir);
-  }
-  const cwd = process.cwd();
-  candidates.push(join(cwd, "packages", "nextclaw-ui"));
-  candidates.push(join(cwd, "nextclaw-ui"));
-  const cliDir = resolve(fileURLToPath(new URL(".", import.meta.url)));
-  const pkgRoot = resolve(cliDir, "..", "..");
-  candidates.push(join(pkgRoot, "..", "nextclaw-ui"));
-  candidates.push(join(pkgRoot, "..", "..", "packages", "nextclaw-ui"));
-  candidates.push(join(pkgRoot, "..", "..", "nextclaw-ui"));
-  for (const dir of candidates) {
-    if (existsSync(join(dir, "package.json"))) {
-      return dir;
-    }
-  }
-  return null;
-}
 function printAgentResponse(response) {
   console.log("\n" + response + "\n");
 }
@@ -461,17 +364,21 @@ var mergeDeep = (base, patch) => {
   }
   return next;
 };
-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;
   }
+  async requestRestart(options) {
+    if (this.deps.requestRestart) {
+      await this.deps.requestRestart(options);
+      return;
+    }
+    const delay = typeof options?.delayMs === "number" && Number.isFinite(options.delayMs) ? Math.max(0, options.delayMs) : 100;
+    console.log(`Gateway restart requested via tool${options?.reason ? ` (${options.reason})` : ""}.`);
+    setTimeout(() => {
+      process.exit(0);
+    }, delay);
+  }
   status() {
     return {
       channels: this.deps.reloader.getChannels().enabledChannels,
@@ -483,7 +390,7 @@ var GatewayControllerImpl = class {
     return this.deps.reloader.reloadConfig(reason);
   }
   async restart(options) {
-    scheduleRestart(options?.delayMs, options?.reason);
+    await this.requestRestart(options);
     return "Restart scheduled";
   }
   async getConfig() {
@@ -528,7 +435,7 @@ var GatewayControllerImpl = class {
     }
     this.deps.saveConfig(validated);
     const delayMs = params.restartDelayMs ?? 0;
-    scheduleRestart(delayMs, "config.apply");
+    await this.requestRestart({ delayMs, reason: "config.apply" });
     return {
       ok: true,
       note: params.note ?? null,
@@ -564,7 +471,7 @@ var GatewayControllerImpl = class {
     }
     this.deps.saveConfig(validated);
     const delayMs = params.restartDelayMs ?? 0;
-    scheduleRestart(delayMs, "config.patch");
+    await this.requestRestart({ delayMs, reason: "config.patch" });
     return {
       ok: true,
       note: params.note ?? null,
@@ -579,7 +486,7 @@ var GatewayControllerImpl = class {
       return { ok: false, error: result.error ?? "update failed", steps: result.steps };
     }
     const delayMs = params.restartDelayMs ?? 0;
-    scheduleRestart(delayMs, "update.run");
+    await this.requestRestart({ delayMs, reason: "update.run" });
     return {
       ok: true,
       note: params.note ?? null,
@@ -590,6 +497,63 @@ var GatewayControllerImpl = class {
   }
 };
 
+// src/cli/restart-coordinator.ts
+var RestartCoordinator = class {
+  constructor(deps) {
+    this.deps = deps;
+  }
+  restartingService = false;
+  exitScheduled = false;
+  async requestRestart(request) {
+    const reason = request.reason.trim() || "config changed";
+    const strategy = request.strategy ?? "background-service-or-manual";
+    if (strategy !== "exit-process") {
+      const state = this.deps.readServiceState();
+      const serviceRunning = Boolean(state && this.deps.isProcessRunning(state.pid));
+      const managedByCurrentProcess = Boolean(state && state.pid === this.deps.currentPid());
+      if (serviceRunning && !managedByCurrentProcess) {
+        if (this.restartingService) {
+          return {
+            status: "restart-in-progress",
+            message: "Restart already in progress; skipping duplicate request."
+          };
+        }
+        this.restartingService = true;
+        try {
+          const restarted = await this.deps.restartBackgroundService(reason);
+          if (restarted) {
+            return {
+              status: "service-restarted",
+              message: `Restarted background service to apply changes (${reason}).`
+            };
+          }
+        } finally {
+          this.restartingService = false;
+        }
+      }
+    }
+    if (strategy === "background-service-or-exit" || strategy === "exit-process") {
+      if (this.exitScheduled) {
+        return {
+          status: "exit-scheduled",
+          message: "Restart already scheduled; skipping duplicate request."
+        };
+      }
+      const delay = typeof request.delayMs === "number" && Number.isFinite(request.delayMs) ? Math.max(0, Math.floor(request.delayMs)) : 100;
+      this.exitScheduled = true;
+      this.deps.scheduleProcessExit(delay, reason);
+      return {
+        status: "exit-scheduled",
+        message: `Restart scheduled (${reason}).`
+      };
+    }
+    return {
+      status: "manual-required",
+      message: request.manualMessage ?? "Restart the gateway to apply changes."
+    };
+  }
+};
+
 // src/cli/skills/clawhub.ts
 import { spawnSync as spawnSync2 } from "child_process";
 import { existsSync as existsSync3 } from "fs";
@@ -663,6 +627,7 @@ function buildClawHubArgs(slug, options) {
 // src/cli/runtime.ts
 var LOGO = "\u{1F916}";
 var EXIT_COMMANDS = /* @__PURE__ */ new Set(["exit", "quit", "/exit", "/quit", ":q"]);
+var FORCED_PUBLIC_UI_HOST = "0.0.0.0";
 function isIndexSegment(raw) {
   return /^[0-9]+$/.test(raw);
 }
@@ -986,12 +951,75 @@ var ConfigReloader = class {
 };
 var CliRuntime = class {
   logo;
+  restartCoordinator;
+  serviceRestartTask = null;
   constructor(options = {}) {
     this.logo = options.logo ?? LOGO;
+    this.restartCoordinator = new RestartCoordinator({
+      readServiceState,
+      isProcessRunning,
+      currentPid: () => process.pid,
+      restartBackgroundService: async (reason) => this.restartBackgroundService(reason),
+      scheduleProcessExit: (delayMs, reason) => this.scheduleProcessExit(delayMs, reason)
+    });
   }
   get version() {
     return getPackageVersion();
   }
+  scheduleProcessExit(delayMs, reason) {
+    console.warn(`Gateway restart requested (${reason}).`);
+    setTimeout(() => {
+      process.exit(0);
+    }, delayMs);
+  }
+  async restartBackgroundService(reason) {
+    if (this.serviceRestartTask) {
+      return this.serviceRestartTask;
+    }
+    this.serviceRestartTask = (async () => {
+      const state = readServiceState();
+      if (!state || !isProcessRunning(state.pid) || state.pid === process.pid) {
+        return false;
+      }
+      const uiHost = FORCED_PUBLIC_UI_HOST;
+      const uiPort = typeof state.uiPort === "number" && Number.isFinite(state.uiPort) ? state.uiPort : 18791;
+      console.log(`Applying changes (${reason}): restarting ${APP_NAME} background service...`);
+      await this.stopService();
+      await this.startService({
+        uiOverrides: {
+          enabled: true,
+          host: uiHost,
+          port: uiPort
+        },
+        open: false
+      });
+      return true;
+    })();
+    try {
+      return await this.serviceRestartTask;
+    } finally {
+      this.serviceRestartTask = null;
+    }
+  }
+  async requestRestart(params) {
+    const result = await this.restartCoordinator.requestRestart({
+      reason: params.reason,
+      strategy: params.strategy,
+      delayMs: params.delayMs,
+      manualMessage: params.manualMessage
+    });
+    if (result.status === "manual-required" || result.status === "restart-in-progress") {
+      console.log(result.message);
+      return;
+    }
+    if (result.status === "service-restarted") {
+      if (!params.silentOnServiceRestart) {
+        console.log(result.message);
+      }
+      return;
+    }
+    console.warn(result.message);
+  }
   async onboard() {
     console.warn(`Warning: ${APP_NAME} onboard is deprecated. Use "${APP_NAME} init" instead.`);
     await this.init({ source: "onboard" });
@@ -1036,87 +1064,43 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     }
   }
   async gateway(opts) {
-    const uiOverrides = {};
+    const uiOverrides = {
+      host: FORCED_PUBLIC_UI_HOST
+    };
     if (opts.ui) {
       uiOverrides.enabled = true;
     }
-    if (opts.uiHost) {
-      uiOverrides.host = String(opts.uiHost);
-    }
     if (opts.uiPort) {
       uiOverrides.port = Number(opts.uiPort);
     }
     if (opts.uiOpen) {
       uiOverrides.open = true;
     }
-    if (opts.public) {
-      uiOverrides.enabled = true;
-      if (!opts.uiHost) {
-        uiOverrides.host = "0.0.0.0";
-      }
-    }
     await this.startGateway({ uiOverrides });
   }
   async ui(opts) {
     const uiOverrides = {
       enabled: true,
+      host: FORCED_PUBLIC_UI_HOST,
       open: Boolean(opts.open)
     };
-    if (opts.host) {
-      uiOverrides.host = String(opts.host);
-    }
     if (opts.port) {
       uiOverrides.port = Number(opts.port);
     }
-    if (opts.public && !opts.host) {
-      uiOverrides.host = "0.0.0.0";
-    }
     await this.startGateway({ uiOverrides, allowMissingProvider: true });
   }
   async start(opts) {
     await this.init({ source: "start", auto: true });
     const uiOverrides = {
       enabled: true,
+      host: FORCED_PUBLIC_UI_HOST,
       open: false
     };
-    if (opts.uiHost) {
-      uiOverrides.host = String(opts.uiHost);
-    }
     if (opts.uiPort) {
       uiOverrides.port = Number(opts.uiPort);
     }
-    if (opts.public && !opts.uiHost) {
-      uiOverrides.host = "0.0.0.0";
-    }
-    const devMode = isDevRuntime();
-    if (devMode) {
-      const requestedUiPort = Number.isFinite(Number(opts.uiPort)) ? Number(opts.uiPort) : 18792;
-      const requestedFrontendPort = Number.isFinite(Number(opts.frontendPort)) ? Number(opts.frontendPort) : 5174;
-      const uiHost = uiOverrides.host ?? "127.0.0.1";
-      const devUiPort = await findAvailablePort(requestedUiPort, uiHost);
-      const shouldStartFrontend = opts.frontend === void 0 ? true : Boolean(opts.frontend);
-      const devFrontendPort = shouldStartFrontend ? await findAvailablePort(requestedFrontendPort, "127.0.0.1") : requestedFrontendPort;
-      uiOverrides.port = devUiPort;
-      if (requestedUiPort !== devUiPort) {
-        console.log(`Dev mode: UI port ${requestedUiPort} is in use, switched to ${devUiPort}.`);
-      }
-      if (shouldStartFrontend && requestedFrontendPort !== devFrontendPort) {
-        console.log(`Dev mode: Frontend port ${requestedFrontendPort} is in use, switched to ${devFrontendPort}.`);
-      }
-      console.log(`Dev mode: UI ${devUiPort}, Frontend ${devFrontendPort}`);
-      console.log("Dev mode runs in the foreground (Ctrl+C to stop).");
-      await this.runForeground({
-        uiOverrides,
-        frontend: shouldStartFrontend,
-        frontendPort: devFrontendPort,
-        open: Boolean(opts.open)
-      });
-      return;
-    }
     await this.startService({
       uiOverrides,
-      frontend: Boolean(opts.frontend),
-      frontendPort: Number(opts.frontendPort),
       open: Boolean(opts.open)
     });
   }
@@ -1136,40 +1120,14 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
   async serve(opts) {
     const uiOverrides = {
       enabled: true,
+      host: FORCED_PUBLIC_UI_HOST,
       open: false
     };
-    if (opts.uiHost) {
-      uiOverrides.host = String(opts.uiHost);
-    }
     if (opts.uiPort) {
       uiOverrides.port = Number(opts.uiPort);
     }
-    if (opts.public && !opts.uiHost) {
-      uiOverrides.host = "0.0.0.0";
-    }
-    const devMode = isDevRuntime();
-    if (devMode && uiOverrides.port === void 0) {
-      uiOverrides.port = 18792;
-    }
-    const shouldStartFrontend = Boolean(opts.frontend);
-    const defaultFrontendPort = devMode ? 5174 : 5173;
-    const requestedFrontendPort = Number.isFinite(Number(opts.frontendPort)) ? Number(opts.frontendPort) : defaultFrontendPort;
-    if (devMode && uiOverrides.port !== void 0) {
-      const uiHost = uiOverrides.host ?? "127.0.0.1";
-      const uiPort = await findAvailablePort(uiOverrides.port, uiHost);
-      if (uiPort !== uiOverrides.port) {
-        console.log(`Dev mode: UI port ${uiOverrides.port} is in use, switched to ${uiPort}.`);
-        uiOverrides.port = uiPort;
-      }
-    }
-    const frontendPort = devMode && shouldStartFrontend ? await findAvailablePort(requestedFrontendPort, "127.0.0.1") : requestedFrontendPort;
-    if (devMode && shouldStartFrontend && frontendPort !== requestedFrontendPort) {
-      console.log(`Dev mode: Frontend port ${requestedFrontendPort} is in use, switched to ${frontendPort}.`);
-    }
     await this.runForeground({
       uiOverrides,
-      frontend: shouldStartFrontend,
-      frontendPort,
       open: Boolean(opts.open)
     });
   }
@@ -1189,6 +1147,10 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       bus,
       providerManager,
       workspace,
+      model: config2.agents.defaults.model,
+      maxIterations: config2.agents.defaults.maxToolIterations,
+      maxTokens: config2.agents.defaults.maxTokens,
+      temperature: config2.agents.defaults.temperature,
       braveApiKey: config2.tools.web.search.apiKey || void 0,
       execConfig: config2.tools.exec,
       restrictToWorkspace: config2.tools.restrictToWorkspace,
@@ -1428,7 +1390,7 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     }
     console.log(JSON.stringify(result.value ?? null, null, 2));
   }
-  configSet(pathExpr, value, opts = {}) {
+  async configSet(pathExpr, value, opts = {}) {
     let parsedPath;
     try {
       parsedPath = parseRequiredConfigPath(pathExpr);
@@ -1445,18 +1407,24 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       process.exit(1);
       return;
     }
-    const config2 = loadConfig();
+    const prevConfig = loadConfig();
+    const nextConfig = structuredClone(prevConfig);
     try {
-      setAtConfigPath(config2, parsedPath, parsedValue);
+      setAtConfigPath(nextConfig, parsedPath, parsedValue);
     } catch (error) {
       console.error(String(error));
       process.exit(1);
       return;
     }
-    saveConfig(config2);
-    console.log(`Updated ${pathExpr}. Restart the gateway to apply.`);
+    saveConfig(nextConfig);
+    await this.requestRestartForConfigDiff({
+      prevConfig,
+      nextConfig,
+      reason: `config.set ${pathExpr}`,
+      manualMessage: `Updated ${pathExpr}. Restart the gateway to apply.`
+    });
   }
-  configUnset(pathExpr) {
+  async configUnset(pathExpr) {
     let parsedPath;
     try {
       parsedPath = parseRequiredConfigPath(pathExpr);
@@ -1465,27 +1433,53 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       process.exit(1);
       return;
     }
-    const config2 = loadConfig();
-    const removed = unsetAtConfigPath(config2, parsedPath);
+    const prevConfig = loadConfig();
+    const nextConfig = structuredClone(prevConfig);
+    const removed = unsetAtConfigPath(nextConfig, parsedPath);
     if (!removed) {
       console.error(`Config path not found: ${pathExpr}`);
       process.exit(1);
       return;
     }
-    saveConfig(config2);
-    console.log(`Removed ${pathExpr}. Restart the gateway to apply.`);
+    saveConfig(nextConfig);
+    await this.requestRestartForConfigDiff({
+      prevConfig,
+      nextConfig,
+      reason: `config.unset ${pathExpr}`,
+      manualMessage: `Removed ${pathExpr}. Restart the gateway to apply.`
+    });
   }
-  pluginsEnable(id) {
+  async requestRestartForConfigDiff(params) {
+    const changedPaths = diffConfigPaths(params.prevConfig, params.nextConfig);
+    if (!changedPaths.length) {
+      return;
+    }
+    const plan = buildReloadPlan(changedPaths);
+    if (plan.restartRequired.length === 0) {
+      return;
+    }
+    await this.requestRestart({
+      reason: `${params.reason} (${plan.restartRequired.join(", ")})`,
+      manualMessage: params.manualMessage
+    });
+  }
+  async pluginsEnable(id) {
     const config2 = loadConfig();
     const next = enablePluginInConfig(config2, id);
     saveConfig(next);
-    console.log(`Enabled plugin "${id}". Restart the gateway to apply.`);
+    await this.requestRestart({
+      reason: `plugin enabled: ${id}`,
+      manualMessage: `Enabled plugin "${id}". Restart the gateway to apply.`
+    });
   }
-  pluginsDisable(id) {
+  async pluginsDisable(id) {
     const config2 = loadConfig();
     const next = disablePluginInConfig(config2, id);
     saveConfig(next);
-    console.log(`Disabled plugin "${id}". Restart the gateway to apply.`);
+    await this.requestRestart({
+      reason: `plugin disabled: ${id}`,
+      manualMessage: `Disabled plugin "${id}". Restart the gateway to apply.`
+    });
   }
   async pluginsUninstall(id, opts = {}) {
     const config2 = loadConfig();
@@ -1582,7 +1576,10 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       removed.push("directory");
     }
     console.log(`Uninstalled plugin "${pluginId}". Removed: ${removed.length > 0 ? removed.join(", ") : "nothing"}.`);
-    console.log("Restart the gateway to apply changes.");
+    await this.requestRestart({
+      reason: `plugin uninstalled: ${pluginId}`,
+      manualMessage: "Restart the gateway to apply changes."
+    });
   }
   async pluginsInstall(pathOrSpec, opts = {}) {
     const fileSpec = this.resolveFileNpmSpecToLocalPath(pathOrSpec);
@@ -1611,7 +1608,10 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
         });
         saveConfig(next3);
         console.log(`Linked plugin path: ${resolved}`);
-        console.log("Restart the gateway to load plugins.");
+        await this.requestRestart({
+          reason: `plugin linked: ${probe.pluginId}`,
+          manualMessage: "Restart the gateway to load plugins."
+        });
         return;
       }
       const result2 = await installPluginFromPath({
@@ -1635,7 +1635,10 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       });
       saveConfig(next2);
       console.log(`Installed plugin: ${result2.pluginId}`);
-      console.log("Restart the gateway to load plugins.");
+      await this.requestRestart({
+        reason: `plugin installed: ${result2.pluginId}`,
+        manualMessage: "Restart the gateway to load plugins."
+      });
       return;
     }
     if (opts.link) {
@@ -1667,7 +1670,10 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     });
     saveConfig(next);
     console.log(`Installed plugin: ${result.pluginId}`);
-    console.log("Restart the gateway to load plugins.");
+    await this.requestRestart({
+      reason: `plugin installed: ${result.pluginId}`,
+      manualMessage: "Restart the gateway to load plugins."
+    });
   }
   pluginsDoctor() {
     const config2 = loadConfig();
@@ -1757,7 +1763,7 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       console.error(`Bridge failed: ${result.status ?? 1}`);
     }
   }
-  channelsAdd(opts) {
+  async channelsAdd(opts) {
     const channelId = opts.channel?.trim();
     if (!channelId) {
       console.error("--channel is required");
@@ -1808,7 +1814,10 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     next = enablePluginInConfig(next, binding.pluginId);
     saveConfig(next);
     console.log(`Configured channel "${binding.channelId}" via plugin "${binding.pluginId}".`);
-    console.log("Restart the gateway to apply changes.");
+    await this.requestRestart({
+      reason: `channel configured via plugin: ${binding.pluginId}`,
+      manualMessage: "Restart the gateway to apply changes."
+    });
   }
   toPluginConfigView(config2, bindings) {
     const view = JSON.parse(JSON.stringify(config2));
@@ -2032,7 +2041,11 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       loadConfig,
       getExtensionChannels: () => extensionRegistry.channels,
       onRestartRequired: (paths) => {
-        console.warn(`Config changes require restart: ${paths.join(", ")}`);
+        void this.requestRestart({
+          reason: `config reload requires restart: ${paths.join(", ")}`,
+          manualMessage: `Config changes require restart: ${paths.join(", ")}`,
+          strategy: "background-service-or-manual"
+        });
       }
     });
     const gatewayController = new GatewayControllerImpl({
@@ -2040,7 +2053,16 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       cron: cron2,
       getConfigPath,
       saveConfig,
-      getPluginUiMetadata: () => pluginUiMetadata
+      getPluginUiMetadata: () => pluginUiMetadata,
+      requestRestart: async (options2) => {
+        await this.requestRestart({
+          reason: options2?.reason ?? "gateway tool restart",
+          manualMessage: "Restart the gateway to apply changes.",
+          strategy: "background-service-or-exit",
+          delayMs: options2?.delayMs,
+          silentOnServiceRestart: true
+        });
+      }
     });
     const agent = new AgentLoop({
       bus,
@@ -2048,6 +2070,8 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       workspace,
       model: config2.agents.defaults.model,
       maxIterations: config2.agents.defaults.maxToolIterations,
+      maxTokens: config2.agents.defaults.maxTokens,
+      temperature: config2.agents.defaults.temperature,
       braveApiKey: config2.tools.web.search.apiKey || void 0,
       execConfig: config2.tools.exec,
       cronService: cron2,
@@ -2178,7 +2202,7 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
   }
   async printPublicUiUrls(host, port) {
     if (isLoopbackHost(host)) {
-      console.log('Public URL: disabled (UI host is loopback). Use "--public" or "--ui-host 0.0.0.0" to expose it.');
+      console.log("Public URL: disabled (UI host is loopback). Current release expects public exposure; run nextclaw restart.");
       return;
     }
     const publicIp = await resolvePublicIp();
@@ -2213,34 +2237,14 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
   async runForeground(options) {
     const config2 = loadConfig();
     const uiConfig = resolveUiConfig(config2, options.uiOverrides);
-    const shouldStartFrontend = options.frontend;
-    const frontendPort = Number.isFinite(options.frontendPort) ? options.frontendPort : 5173;
-    const frontendDir = shouldStartFrontend ? resolveUiFrontendDir() : null;
-    const staticDir = resolveUiStaticDir();
-    let frontendUrl = null;
-    if (shouldStartFrontend && frontendDir) {
-      const frontend = startUiFrontend({
-        apiBase: resolveUiApiBase(uiConfig.host, uiConfig.port),
-        port: frontendPort,
-        dir: frontendDir
-      });
-      frontendUrl = frontend?.url ?? null;
-    } else if (shouldStartFrontend && !frontendDir) {
-      console.log("Warning: UI frontend not found. Start it separately.");
-    }
-    if (!frontendUrl && staticDir) {
-      frontendUrl = resolveUiApiBase(uiConfig.host, uiConfig.port);
-    }
-    if (options.open && frontendUrl) {
-      openBrowser(frontendUrl);
-    } else if (options.open && !frontendUrl) {
-      console.log("Warning: UI frontend not started. Browser not opened.");
+    const uiUrl = resolveUiApiBase(uiConfig.host, uiConfig.port);
+    if (options.open) {
+      openBrowser(uiUrl);
     }
-    const uiStaticDir = shouldStartFrontend && frontendDir ? null : staticDir;
     await this.startGateway({
       uiOverrides: options.uiOverrides,
       allowMissingProvider: true,
-      uiStaticDir
+      uiStaticDir: resolveUiStaticDir()
     });
   }
   async startService(options) {
@@ -2274,7 +2278,7 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
         console.log(
           `Note: requested UI bind (${uiConfig.host}:${uiConfig.port}) differs from running service (${parsedUi.host}:${parsedUi.port}).`
         );
-        console.log(`Run: ${APP_NAME} restart${uiConfig.host === "0.0.0.0" ? " --public" : ""}`);
+        console.log(`Run: ${APP_NAME} restart`);
       }
       console.log(`Logs: ${existing.logPath}`);
       console.log(`Stop: ${APP_NAME} stop`);
@@ -2283,8 +2287,8 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     if (existing) {
       clearServiceState();
     }
-    if (!staticDir && !options.frontend) {
-      console.log("Warning: UI frontend not found. Use --frontend to start the dev server.");
+    if (!staticDir) {
+      console.log("Warning: UI frontend not found in package assets.");
     }
     const logPath = resolveServiceLogPath();
     const logDir = resolve4(logPath, "..");
@@ -2292,9 +2296,7 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     const logFd = openSync(logPath, "a");
     const serveArgs = buildServeArgs({
       uiHost: uiConfig.host,
-      uiPort: uiConfig.port,
-      frontend: options.frontend,
-      frontendPort: options.frontendPort
+      uiPort: uiConfig.port
     });
     const child = spawn2(process.execPath, [...process.execArgv, ...serveArgs], {
       env: process.env,
@@ -2595,11 +2597,11 @@ 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`).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).option("--public", "Expose UI on 0.0.0.0 and print public URL", 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").option("--public", "Expose UI on 0.0.0.0 and print public URL", false).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).option("--public", "Expose UI on 0.0.0.0 and print public URL", false).action(async (opts) => runtime.start(opts));
-program.command("restart").description(`Restart the ${APP_NAME2} background service`).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 restart", false).option("--public", "Expose UI on 0.0.0.0 and print public URL", false).action(async (opts) => runtime.restart(opts));
-program.command("serve").description(`Run the ${APP_NAME2} gateway + UI in the foreground`).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).option("--public", "Expose UI on 0.0.0.0 and print public URL", false).action(async (opts) => runtime.serve(opts));
+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-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("--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-port <port>", "UI port").option("--open", "Open browser after start", false).action(async (opts) => runtime.start(opts));
+program.command("restart").description(`Restart the ${APP_NAME2} background service`).option("--ui-port <port>", "UI port").option("--open", "Open browser after restart", false).action(async (opts) => runtime.restart(opts));
+program.command("serve").description(`Run the ${APP_NAME2} gateway + UI in the foreground`).option("--ui-port <port>", "UI port").option("--open", "Open browser after start", false).action(async (opts) => runtime.serve(opts));
 program.command("stop").description(`Stop the ${APP_NAME2} background service`).action(async () => runtime.stop());
 program.command("agent").description("Interact with the agent directly").option("-m, --message <message>", "Message to send to the agent").option("-s, --session <session>", "Session ID", "cli:default").option("--no-markdown", "Disable Markdown rendering").action(async (opts) => runtime.agent(opts));
 program.command("update").description(`Update ${APP_NAME2}`).option("--timeout <ms>", "Update command timeout in milliseconds").action(async (opts) => runtime.update(opts));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nextclaw",
-  "version": "0.4.16",
+  "version": "0.5.0",
   "description": "Lightweight personal AI assistant with CLI, multi-provider routing, and channel integrations.",
   "private": false,
   "type": "module",
@@ -38,9 +38,9 @@
   "dependencies": {
     "chokidar": "^3.6.0",
     "commander": "^12.1.0",
-    "@nextclaw/core": "^0.4.14",
-    "@nextclaw/server": "^0.3.5",
-    "@nextclaw/openclaw-compat": "^0.1.2"
+    "@nextclaw/core": "^0.5.0",
+    "@nextclaw/server": "^0.3.6",
+    "@nextclaw/openclaw-compat": "^0.1.3"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",