nextclaw 0.4.14 → 0.4.15

package/dist/cli/index.js

@@ -81,7 +81,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 +92,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";
 }
@@ -989,6 +1024,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 +1043,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 +1060,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 +1119,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;
@@ -2104,6 +2154,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 +2183,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);
     }
@@ -2209,6 +2274,7 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     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) {
@@ -2480,11 +2546,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.15",
   "description": "Lightweight personal AI assistant with CLI, multi-provider routing, and channel integrations.",
   "private": false,
   "type": "module",