nextclaw 0.4.15 → 0.4.17

package/dist/cli/index.js

@@ -21,6 +21,7 @@ import {
   MessageBus,
   AgentLoop,
   LiteLLMProvider,
+  LLMProvider,
   ProviderManager,
   ChannelManager,
   SessionManager,
@@ -81,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) {
@@ -127,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();
@@ -297,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");
 }
@@ -460,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,
@@ -482,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() {
@@ -527,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,
@@ -563,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,
@@ -578,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,
@@ -589,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";
@@ -847,6 +812,21 @@ function unsetAtConfigPath(root, pathSegments) {
   delete record[last];
   return true;
 }
+var MissingProvider = class extends LLMProvider {
+  constructor(defaultModel) {
+    super(null, null);
+    this.defaultModel = defaultModel;
+  }
+  setDefaultModel(model) {
+    this.defaultModel = model;
+  }
+  async chat() {
+    throw new Error("No API key configured yet. Configure provider credentials in UI and retry.");
+  }
+  getDefaultModel() {
+    return this.defaultModel;
+  }
+};
 var ConfigReloader = class {
   constructor(options) {
     this.options = options;
@@ -863,6 +843,9 @@ var ConfigReloader = class {
   getChannels() {
     return this.channels;
   }
+  setApplyAgentRuntimeConfig(callback) {
+    this.options.applyAgentRuntimeConfig = callback;
+  }
   async applyReloadPlan(nextConfig) {
     const changedPaths = diffConfigPaths(this.currentConfig, nextConfig);
     if (!changedPaths.length) {
@@ -872,9 +855,15 @@ var ConfigReloader = class {
     const plan = buildReloadPlan(changedPaths);
     if (plan.restartChannels) {
       await this.reloadChannels(nextConfig);
+      console.log("Config reload: channels restarted.");
     }
     if (plan.reloadProviders) {
       await this.reloadProvider(nextConfig);
+      console.log("Config reload: provider settings applied.");
+    }
+    if (plan.reloadAgent) {
+      this.options.applyAgentRuntimeConfig?.(nextConfig);
+      console.log("Config reload: agent defaults applied.");
     }
     if (plan.restartRequired.length > 0) {
       this.options.onRestartRequired(plan.restartRequired);
@@ -961,12 +950,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 = state.uiHost ?? "127.0.0.1";
+      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" });
@@ -1063,35 +1115,8 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     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)
     });
   }
@@ -1122,29 +1147,8 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     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)
     });
   }
@@ -1403,7 +1407,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);
@@ -1429,9 +1433,12 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       return;
     }
     saveConfig(config2);
-    console.log(`Updated ${pathExpr}. Restart the gateway to apply.`);
+    await this.requestRestart({
+      reason: `config.set ${pathExpr}`,
+      manualMessage: `Updated ${pathExpr}. Restart the gateway to apply.`
+    });
   }
-  configUnset(pathExpr) {
+  async configUnset(pathExpr) {
     let parsedPath;
     try {
       parsedPath = parseRequiredConfigPath(pathExpr);
@@ -1448,19 +1455,28 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       return;
     }
     saveConfig(config2);
-    console.log(`Removed ${pathExpr}. Restart the gateway to apply.`);
+    await this.requestRestart({
+      reason: `config.unset ${pathExpr}`,
+      manualMessage: `Removed ${pathExpr}. Restart the gateway to apply.`
+    });
   }
-  pluginsEnable(id) {
+  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();
@@ -1557,7 +1573,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);
@@ -1586,7 +1605,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({
@@ -1610,7 +1632,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) {
@@ -1642,7 +1667,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();
@@ -1732,7 +1760,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");
@@ -1783,7 +1811,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));
@@ -1986,7 +2017,7 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     this.logPluginDiagnostics(pluginRegistry);
     const bus = new MessageBus();
     const provider = options.allowMissingProvider === true ? this.makeProvider(config2, { allowMissing: true }) : this.makeProvider(config2);
-    const providerManager = provider ? new ProviderManager(provider) : null;
+    const providerManager = new ProviderManager(provider ?? this.makeMissingProvider(config2));
     const sessionManager = new SessionManager(workspace);
     const cronStorePath = join3(getDataDir2(), "cron", "jobs.json");
     const cron2 = new CronService(cronStorePath);
@@ -1994,11 +2025,7 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     const uiConfig = resolveUiConfig(config2, options.uiOverrides);
     const uiStaticDir = options.uiStaticDir === void 0 ? resolveUiStaticDir() : options.uiStaticDir;
     if (!provider) {
-      this.startUiIfEnabled(uiConfig, uiStaticDir);
-      console.log("Warning: No API key configured. UI server only.");
-      await new Promise(() => {
-      });
-      return;
+      console.warn("Warning: No API key configured. The gateway is running, but agent replies are disabled until provider config is set.");
     }
     const channels2 = new ChannelManager(config2, bus, sessionManager, extensionRegistry.channels);
     const reloader = new ConfigReloader({
@@ -2007,11 +2034,15 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       bus,
       sessionManager,
       providerManager,
-      makeProvider: (nextConfig) => this.makeProvider(nextConfig, { allowMissing: true }),
+      makeProvider: (nextConfig) => this.makeProvider(nextConfig, { allowMissing: true }) ?? this.makeMissingProvider(nextConfig),
       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({
@@ -2019,11 +2050,20 @@ ${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,
-      providerManager: providerManager ?? new ProviderManager(provider),
+      providerManager,
       workspace,
       model: config2.agents.defaults.model,
       maxIterations: config2.agents.defaults.maxToolIterations,
@@ -2043,6 +2083,7 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
         accountId
       })
     });
+    reloader.setApplyAgentRuntimeConfig((nextConfig) => agent.applyRuntimeConfig(nextConfig));
     const pluginChannelBindings = getPluginChannelBindings(pluginRegistry);
     setPluginRuntimeBridge({
       loadConfig: () => this.toPluginConfigView(loadConfig(), pluginChannelBindings),
@@ -2191,34 +2232,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) {
@@ -2232,6 +2253,28 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       console.log(`\u2713 ${APP_NAME} is already running (PID ${existing.pid})`);
       console.log(`UI: ${existing.uiUrl}`);
       console.log(`API: ${existing.apiUrl}`);
+      const parsedUi = (() => {
+        try {
+          const parsed = new URL(existing.uiUrl);
+          const port = Number(parsed.port || 80);
+          return {
+            host: existing.uiHost ?? parsed.hostname,
+            port: Number.isFinite(port) ? port : existing.uiPort ?? 18791
+          };
+        } catch {
+          return {
+            host: existing.uiHost ?? "127.0.0.1",
+            port: existing.uiPort ?? 18791
+          };
+        }
+      })();
+      await this.printPublicUiUrls(parsedUi.host, parsedUi.port);
+      if (parsedUi.host !== uiConfig.host || parsedUi.port !== uiConfig.port) {
+        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(`Logs: ${existing.logPath}`);
       console.log(`Stop: ${APP_NAME} stop`);
       return;
@@ -2239,8 +2282,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, "..");
@@ -2248,9 +2291,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,
@@ -2268,6 +2309,8 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       startedAt: (/* @__PURE__ */ new Date()).toISOString(),
       uiUrl,
       apiUrl,
+      uiHost: uiConfig.host,
+      uiPort: uiConfig.port,
       logPath
     };
     writeServiceState(state);
@@ -2324,6 +2367,9 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     const normalized = answer.trim().toLowerCase();
     return normalized === "y" || normalized === "yes";
   }
+  makeMissingProvider(config2) {
+    return new MissingProvider(config2.agents.defaults.model);
+  }
   makeProvider(config2, options) {
     const provider = getProvider(config2);
     const model = config2.agents.defaults.model;
@@ -2548,9 +2594,9 @@ program.command("onboard").description(`Initialize ${APP_NAME2} configuration an
 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("start").description(`Start the ${APP_NAME2} gateway + UI in the background`).option("--ui-host <host>", "UI host").option("--ui-port <port>", "UI 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("--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("--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("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));