nextclaw 0.2.2 → 0.2.4

package/dist/cli/index.js

@@ -22,7 +22,16 @@ import {
 
 // src/cli/index.ts
 import { Command } from "commander";
-import { existsSync as existsSync6, mkdirSync as mkdirSync5, readFileSync as readFileSync5, writeFileSync as writeFileSync4, cpSync, rmSync } from "fs";
+import {
+  existsSync as existsSync6,
+  mkdirSync as mkdirSync5,
+  readFileSync as readFileSync5,
+  writeFileSync as writeFileSync4,
+  cpSync,
+  rmSync,
+  openSync,
+  closeSync
+} from "fs";
 import { join as join6, resolve } from "path";
 import { spawn, spawnSync } from "child_process";
 import { createInterface } from "readline";
@@ -3101,7 +3110,25 @@ program.command("ui").description(`Start the ${APP_NAME} UI with gateway`).optio
   }
   await startGateway({ uiOverrides, allowMissingProvider: true });
 });
-program.command("start").description(`Start the ${APP_NAME} gateway + UI (backend + optional frontend)`).option("--ui-host <host>", "UI host").option("--ui-port <port>", "UI port").option("--frontend", "Start UI frontend dev server", false).option("--frontend-port <port>", "UI frontend dev server port").option("--no-open", "Disable opening browser").action(async (opts) => {
+program.command("start").description(`Start the ${APP_NAME} gateway + UI in the background`).option("--ui-host <host>", "UI host").option("--ui-port <port>", "UI port").option("--frontend", "Start UI frontend dev server", false).option("--frontend-port <port>", "UI frontend dev server port").option("--open", "Open browser after start", false).action(async (opts) => {
+  const uiOverrides = {
+    enabled: true,
+    open: false
+  };
+  if (opts.uiHost) {
+    uiOverrides.host = String(opts.uiHost);
+  }
+  if (opts.uiPort) {
+    uiOverrides.port = Number(opts.uiPort);
+  }
+  await startService({
+    uiOverrides,
+    frontend: Boolean(opts.frontend),
+    frontendPort: Number(opts.frontendPort),
+    open: Boolean(opts.open)
+  });
+});
+program.command("serve").description(`Run the ${APP_NAME} gateway + UI in the foreground`).option("--ui-host <host>", "UI host").option("--ui-port <port>", "UI port").option("--frontend", "Start UI frontend dev server", false).option("--frontend-port <port>", "UI frontend dev server port").option("--open", "Open browser after start", false).action(async (opts) => {
   const uiOverrides = {
     enabled: true,
     open: false
@@ -3126,15 +3153,12 @@ program.command("start").description(`Start the ${APP_NAME} gateway + UI (backen
       dir: frontendDir
     });
     frontendUrl = frontend?.url ?? null;
-  } else if (shouldStartFrontend && !frontendDir && !staticDir) {
+  } else if (shouldStartFrontend && !frontendDir) {
     console.log("Warning: UI frontend not found. Start it separately.");
   }
   if (!frontendUrl && staticDir) {
     frontendUrl = resolveUiApiBase(uiConfig.host, uiConfig.port);
   }
-  if (!frontendUrl && staticDir) {
-    frontendUrl = resolveUiApiBase(uiConfig.host, uiConfig.port);
-  }
   if (opts.open && frontendUrl) {
     openBrowser(frontendUrl);
   } else if (opts.open && !frontendUrl) {
@@ -3142,6 +3166,9 @@ program.command("start").description(`Start the ${APP_NAME} gateway + UI (backen
   }
   await startGateway({ uiOverrides, allowMissingProvider: true, uiStaticDir: staticDir ?? void 0 });
 });
+program.command("stop").description(`Stop the ${APP_NAME} background service`).action(async () => {
+  await stopService();
+});
 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) => {
   const config = loadConfig();
   const bus = new MessageBus();
@@ -3418,6 +3445,154 @@ function resolveUiApiBase(host, port) {
   const normalizedHost = host === "0.0.0.0" || host === "::" ? "127.0.0.1" : host;
   return `http://${normalizedHost}:${port}`;
 }
+async function startService(options) {
+  const config = loadConfig();
+  const uiConfig = resolveUiConfig(config, options.uiOverrides);
+  const uiUrl = resolveUiApiBase(uiConfig.host, uiConfig.port);
+  const apiUrl = `${uiUrl}/api`;
+  const staticDir = resolveUiStaticDir();
+  const existing = readServiceState();
+  if (existing && isProcessRunning(existing.pid)) {
+    console.log(`\u2713 ${APP_NAME} is already running (PID ${existing.pid})`);
+    console.log(`UI: ${existing.uiUrl}`);
+    console.log(`API: ${existing.apiUrl}`);
+    console.log(`Logs: ${existing.logPath}`);
+    console.log(`Stop: ${APP_NAME} stop`);
+    return;
+  }
+  if (existing) {
+    clearServiceState();
+  }
+  if (!staticDir && !options.frontend) {
+    console.log("Warning: UI frontend not found. Use --frontend to start the dev server.");
+  }
+  const logPath = resolveServiceLogPath();
+  const logDir = resolve(logPath, "..");
+  mkdirSync5(logDir, { recursive: true });
+  const logFd = openSync(logPath, "a");
+  const serveArgs = buildServeArgs({
+    uiHost: uiConfig.host,
+    uiPort: uiConfig.port,
+    frontend: options.frontend,
+    frontendPort: options.frontendPort
+  });
+  const child = spawn(process.execPath, [...process.execArgv, ...serveArgs], {
+    env: process.env,
+    stdio: ["ignore", logFd, logFd],
+    detached: true
+  });
+  closeSync(logFd);
+  if (!child.pid) {
+    console.error("Error: Failed to start background service.");
+    return;
+  }
+  child.unref();
+  const state = {
+    pid: child.pid,
+    startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    uiUrl,
+    apiUrl,
+    logPath
+  };
+  writeServiceState(state);
+  console.log(`\u2713 ${APP_NAME} started in background (PID ${state.pid})`);
+  console.log(`UI: ${uiUrl}`);
+  console.log(`API: ${apiUrl}`);
+  console.log(`Logs: ${logPath}`);
+  console.log(`Stop: ${APP_NAME} stop`);
+  if (options.open) {
+    openBrowser(uiUrl);
+  }
+}
+async function stopService() {
+  const state = readServiceState();
+  if (!state) {
+    console.log("No running service found.");
+    return;
+  }
+  if (!isProcessRunning(state.pid)) {
+    console.log("Service is not running. Cleaning up state.");
+    clearServiceState();
+    return;
+  }
+  console.log(`Stopping ${APP_NAME} (PID ${state.pid})...`);
+  try {
+    process.kill(state.pid, "SIGTERM");
+  } catch (error) {
+    console.error(`Failed to stop service: ${String(error)}`);
+    return;
+  }
+  const stopped = await waitForExit(state.pid, 3e3);
+  if (!stopped) {
+    try {
+      process.kill(state.pid, "SIGKILL");
+    } catch (error) {
+      console.error(`Failed to force stop service: ${String(error)}`);
+      return;
+    }
+    await waitForExit(state.pid, 2e3);
+  }
+  clearServiceState();
+  console.log(`\u2713 ${APP_NAME} stopped`);
+}
+function buildServeArgs(options) {
+  const cliPath = fileURLToPath(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;
+}
+function readServiceState() {
+  const path = resolveServiceStatePath();
+  if (!existsSync6(path)) {
+    return null;
+  }
+  try {
+    const raw = readFileSync5(path, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+function writeServiceState(state) {
+  const path = resolveServiceStatePath();
+  mkdirSync5(resolve(path, ".."), { recursive: true });
+  writeFileSync4(path, JSON.stringify(state, null, 2));
+}
+function clearServiceState() {
+  const path = resolveServiceStatePath();
+  if (existsSync6(path)) {
+    rmSync(path, { force: true });
+  }
+}
+function resolveServiceStatePath() {
+  return resolve(getDataDir(), "run", "service.json");
+}
+function resolveServiceLogPath() {
+  return resolve(getDataDir(), "logs", "service.log");
+}
+function isProcessRunning(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function waitForExit(pid, timeoutMs) {
+  const start = Date.now();
+  while (Date.now() - start < timeoutMs) {
+    if (!isProcessRunning(pid)) {
+      return true;
+    }
+    await new Promise((resolve2) => setTimeout(resolve2, 200));
+  }
+  return !isProcessRunning(pid);
+}
 function resolveUiStaticDir() {
   const candidates = [];
   const envDir = process.env.NEXTCLAW_UI_STATIC_DIR;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nextclaw",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Lightweight personal AI assistant with CLI, multi-provider routing, and channel integrations.",
   "private": false,
   "type": "module",