nextclaw 0.4.14 → 0.4.16

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 } from "net";
+import { createServer, isIP } from "net";
 import { fileURLToPath } from "url";
 import { getDataDir, getPackageVersion as getCorePackageVersion } from "@nextclaw/core";
 function resolveUiConfig(config2, overrides) {
@@ -92,6 +93,41 @@ function resolveUiApiBase(host, port) {
   const normalizedHost = host === "0.0.0.0" || host === "::" ? "127.0.0.1" : host;
   return `http://${normalizedHost}:${port}`;
 }
+function isLoopbackHost(host) {
+  const normalized = host.trim().toLowerCase();
+  return normalized === "127.0.0.1" || normalized === "localhost" || normalized === "::1";
+}
+var PUBLIC_IP_CHECK_URLS = ["https://api.ipify.org", "https://ifconfig.me/ip"];
+async function fetchPublicIpFrom(url, timeoutMs) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const response = await fetch(url, {
+      signal: controller.signal,
+      headers: {
+        Accept: "text/plain"
+      }
+    });
+    if (!response.ok) {
+      return null;
+    }
+    const text = (await response.text()).trim();
+    return isIP(text) ? text : null;
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function resolvePublicIp(timeoutMs = 1500) {
+  for (const endpoint of PUBLIC_IP_CHECK_URLS) {
+    const candidate = await fetchPublicIpFrom(endpoint, timeoutMs);
+    if (candidate) {
+      return candidate;
+    }
+  }
+  return null;
+}
 function isDevRuntime() {
   return import.meta.url.includes("/src/cli/") || process.env.NEXTCLAW_DEV === "1";
 }
@@ -812,6 +848,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;
@@ -828,6 +879,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) {
@@ -837,9 +891,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);
@@ -989,6 +1049,12 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     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) {
@@ -1002,6 +1068,9 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     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) {
@@ -1016,6 +1085,9 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     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;
@@ -1072,6 +1144,9 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     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;
@@ -1936,7 +2011,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);
@@ -1944,11 +2019,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({
@@ -1957,7 +2028,7 @@ ${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) => {
@@ -1973,7 +2044,7 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     });
     const agent = new AgentLoop({
       bus,
-      providerManager: providerManager ?? new ProviderManager(provider),
+      providerManager,
       workspace,
       model: config2.agents.defaults.model,
       maxIterations: config2.agents.defaults.maxToolIterations,
@@ -1993,6 +2064,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),
@@ -2104,6 +2176,20 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       setPluginRuntimeBridge(null);
     }
   }
+  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.');
+      return;
+    }
+    const publicIp = await resolvePublicIp();
+    if (!publicIp) {
+      console.log("Public URL: UI is exposed, but automatic public IP detection failed.");
+      return;
+    }
+    const publicBase = `http://${publicIp}:${port}`;
+    console.log(`Public UI (if firewall/NAT allows): ${publicBase}`);
+    console.log(`Public API (if firewall/NAT allows): ${publicBase}/api`);
+  }
   startUiIfEnabled(uiConfig, uiStaticDir) {
     if (!uiConfig.enabled) {
       return;
@@ -2119,6 +2205,7 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     if (uiStaticDir) {
       console.log(`\u2713 UI frontend: ${uiUrl}`);
     }
+    void this.printPublicUiUrls(uiServer.host, uiServer.port);
     if (uiConfig.open) {
       openBrowser(uiUrl);
     }
@@ -2167,6 +2254,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;
@@ -2203,12 +2312,15 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       startedAt: (/* @__PURE__ */ new Date()).toISOString(),
       uiUrl,
       apiUrl,
+      uiHost: uiConfig.host,
+      uiPort: uiConfig.port,
       logPath
     };
     writeServiceState(state);
     console.log(`\u2713 ${APP_NAME} started in background (PID ${state.pid})`);
     console.log(`UI: ${uiUrl}`);
     console.log(`API: ${apiUrl}`);
+    await this.printPublicUiUrls(uiConfig.host, uiConfig.port);
     console.log(`Logs: ${logPath}`);
     console.log(`Stop: ${APP_NAME} stop`);
     if (options.open) {
@@ -2258,6 +2370,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;
@@ -2480,11 +2595,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).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));
-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).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).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-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("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.14",
+  "version": "0.4.16",
   "description": "Lightweight personal AI assistant with CLI, multi-provider routing, and channel integrations.",
   "private": false,
   "type": "module",
@@ -38,7 +38,7 @@
   "dependencies": {
     "chokidar": "^3.6.0",
     "commander": "^12.1.0",
-    "@nextclaw/core": "^0.4.10",
+    "@nextclaw/core": "^0.4.14",
     "@nextclaw/server": "^0.3.5",
     "@nextclaw/openclaw-compat": "^0.1.2"
   },