@cloudless-ai/node-agent 0.0.13 → 0.0.15

package/README.md

@@ -19,10 +19,11 @@ During install, the script:
 
 ```bash
 cloudless-node start
+cloudless-node start --interactive
 cloudless-node menubar
+cloudless-node stop
 cloudless-node set-api-key
-cloudless-node configure --router http://router-host:8080 --token YOUR_KEY
-cloudless-node paths
+cloudless-node configure
 ```
 
 ## Non-interactive install
@@ -35,4 +36,7 @@ CLOUDLESS_NODE_API_KEY=your_key CLOUDLESS_ROUTER_URL=http://router-host:8080 npm
 
 - By default binaries are installed to `~/.cloudless/bin`.
 - Configuration is written to `~/.cloudless/agent.yaml`.
+- `cloudless-node start` launches the node + menubar in the background by default.
+- Use `cloudless-node start --interactive` to keep it attached to your terminal.
 - Installation has no GitHub release dependency; binaries are bundled in the npm tarball.
+- For internet demos, set `router.advertise_address` in `~/.cloudless/agent.yaml` (or `CLOUDLESS_AGENT_ADVERTISE_ADDRESS`) to a public tunnel URL so router/dashboard can reach this node.

package/bin/cloudless-node.js

@@ -0,0 +1,255 @@
+#!/usr/bin/env node
+const { spawn, spawnSync } = require("node:child_process");
+const fs = require("node:fs");
+const path = require("node:path");
+
+const {
+  AGENT_BINARY_NAME,
+  MENUBAR_BINARY_NAME,
+  BIN_DIR,
+  CLOUDLESS_ROOT,
+  promptSecret,
+  promptLine,
+  writeOrUpdateConfig,
+  CONFIG_PATH,
+} = require("../scripts/common");
+
+const agentBin = path.join(BIN_DIR, AGENT_BINARY_NAME);
+const menubarBin = path.join(BIN_DIR, MENUBAR_BINARY_NAME);
+const supervisorPidFile = path.join(CLOUDLESS_ROOT, "cloudless-node-supervisor.pid");
+
+function withDefaultConfig(args) {
+  const hasConfigArg = args.includes("--config");
+  if (hasConfigArg) {
+    return args;
+  }
+  if (!fs.existsSync(CONFIG_PATH)) {
+    return args;
+  }
+  return [...args, "--config", CONFIG_PATH];
+}
+
+function checkBinary(bin) {
+  if (!fs.existsSync(bin)) {
+    process.stderr.write(
+      `cloudless-node: binary not found at ${bin}\n` +
+      `Re-run \`npm install -g @cloudless-ai/node-agent\` to reinstall.\n`
+    );
+    process.exit(1);
+  }
+}
+
+function runBinary(bin, args) {
+  checkBinary(bin);
+  const result = spawnSync(bin, withDefaultConfig(args), { stdio: "inherit" });
+  if (result.error) {
+    process.stderr.write(`cloudless-node: ${result.error.message}\n`);
+    process.exit(1);
+  }
+  process.exit(result.status ?? 0);
+}
+
+function stopProcess(pid) {
+  try {
+    process.kill(pid, "SIGTERM");
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function readSupervisorPid() {
+  if (!fs.existsSync(supervisorPidFile)) {
+    return null;
+  }
+  const raw = fs.readFileSync(supervisorPidFile, "utf8").trim();
+  if (!raw) {
+    return null;
+  }
+  const pid = Number(raw);
+  if (!Number.isInteger(pid) || pid <= 0) {
+    return null;
+  }
+  try {
+    process.kill(pid, 0);
+    return pid;
+  } catch {
+    return null;
+  }
+}
+
+function writeSupervisorPid() {
+  fs.mkdirSync(path.dirname(supervisorPidFile), { recursive: true });
+  fs.writeFileSync(supervisorPidFile, `${process.pid}\n`, "utf8");
+}
+
+function clearSupervisorPid() {
+  try {
+    fs.unlinkSync(supervisorPidFile);
+  } catch {}
+}
+
+function runSupervisor(agentArgs) {
+  checkBinary(agentBin);
+
+  const isMac = process.platform === "darwin";
+  const startTime = Date.now();
+
+  const agent = spawn(agentBin, withDefaultConfig(agentArgs), { stdio: "inherit" });
+
+  let menubar = null;
+  if (isMac) {
+    if (fs.existsSync(menubarBin)) {
+      menubar = spawn(menubarBin, [], { stdio: "ignore" });
+    }
+  }
+
+  writeSupervisorPid();
+
+  let shuttingDown = false;
+  function shutdown() {
+    if (shuttingDown) {
+      return;
+    }
+    shuttingDown = true;
+    agent.kill();
+    if (menubar) menubar.kill();
+  }
+
+  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", shutdown);
+  process.on("exit", clearSupervisorPid);
+
+  agent.on("exit", (code) => {
+    const exitedQuickly = Date.now() - startTime < 5000;
+    if (menubar && code !== 0 && code !== null && exitedQuickly) {
+      process.stderr.write(
+        "cloudless-node: agent failed to start, keeping menubar attached to existing local agent if available\n"
+      );
+      return;
+    }
+    if (menubar) menubar.kill();
+    clearSupervisorPid();
+    process.exit(code ?? 0);
+  });
+
+  if (menubar) {
+    menubar.on("exit", () => {
+      agent.kill();
+      clearSupervisorPid();
+      process.exit(0);
+    });
+    menubar.on("exit", (code) => {
+      if (code !== 0 && code !== null) {
+        process.stderr.write(`cloudless-node: menubar exited with code ${code}\n`);
+      }
+    });
+  }
+}
+
+function parseStartArgs(args) {
+  let interactive = false;
+  const agentArgs = [];
+  for (const arg of args) {
+    if (arg === "--interactive") {
+      interactive = true;
+      continue;
+    }
+    agentArgs.push(arg);
+  }
+  return { interactive, agentArgs };
+}
+
+function startDetached(agentArgs) {
+  const existing = readSupervisorPid();
+  if (existing) {
+    process.stdout.write(`cloudless-node: already running (supervisor pid ${existing})\n`);
+    return;
+  }
+  const child = spawn(process.execPath, [__filename, "run-supervised", ...agentArgs], {
+    detached: true,
+    stdio: "ignore",
+  });
+  child.unref();
+  process.stdout.write(`cloudless-node: started in background (supervisor pid ${child.pid})\n`);
+}
+
+function stopSupervisor() {
+  const pid = readSupervisorPid();
+  if (!pid) {
+    process.stdout.write("cloudless-node: not running\n");
+    return;
+  }
+  if (!stopProcess(pid)) {
+    clearSupervisorPid();
+    process.stdout.write("cloudless-node: not running\n");
+    return;
+  }
+  process.stdout.write("cloudless-node: stop signal sent\n");
+}
+
+async function configure() {
+  const defaultURL = "http://localhost:8080";
+  process.stdout.write("Cloudless AI node configuration\n\n");
+
+  const routerURL =
+    (await promptLine(`Router URL [${defaultURL}]: `)) || defaultURL;
+  process.stdout.write(
+    "API key: create a node-scoped key in the Cloudless AI dashboard (Admin → API Keys → node scope).\n"
+  );
+  const apiKey = await promptSecret("Router API key (hidden): ");
+
+  if (!apiKey) {
+    process.stderr.write("API key is required.\n");
+    process.exit(1);
+  }
+
+  writeOrUpdateConfig({ routerURL, token: apiKey });
+  process.stdout.write(`\nConfig saved to ${CONFIG_PATH}\n`);
+  process.stdout.write("Run `cloudless-node start` to launch the node agent.\n");
+}
+
+const [, , cmd, ...rest] = process.argv;
+
+switch (cmd) {
+  case "configure":
+  case "set-api-key":
+    configure().catch((err) => {
+      process.stderr.write(`${err.message}\n`);
+      process.exit(1);
+    });
+    break;
+
+  case "menubar":
+  case "start": {
+    const { interactive, agentArgs } = parseStartArgs(rest);
+    if (interactive) {
+      runSupervisor(agentArgs);
+      break;
+    }
+    startDetached(agentArgs);
+    break;
+  }
+
+  case "run-supervised":
+    runSupervisor(rest);
+    break;
+
+  case "stop":
+    stopSupervisor();
+    break;
+
+  case undefined: {
+    const { interactive, agentArgs } = parseStartArgs(rest);
+    if (interactive) {
+      runSupervisor(agentArgs);
+      break;
+    }
+    startDetached(agentArgs);
+    break;
+  }
+
+  default:
+    // Pass unknown subcommands/flags straight to the agent binary
+    runBinary(agentBin, [cmd, ...rest]);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudless-ai/node-agent",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "description": "Cloudless AI node agent installer and launcher",
   "license": "MIT",
   "homepage": "https://cloudless-ai.app",

package/scripts/common.js

@@ -112,6 +112,7 @@ function defaultAgentConfig(routerURL, token) {
   discover_interval: "1m"
   servers_file: "${HOME}/.cloudless/router-servers.json"
   manual_servers: []
+  # advertise_address: "https://my-node-demo.example.com"
 
 inference:
   backend: "llamacpp"

package/scripts/postinstall.js

@@ -54,7 +54,7 @@ async function promptConfig() {
   }
   if (!apiKey) {
     process.stdout.write("\nNo API key provided during install.\n");
-    process.stdout.write("Run `cloudless-node set-api-key` to configure it later.\n");
+    process.stdout.write("Run `cloudless-node configure` to set up your router URL and API key.\n");
     return;
   }
   writeOrUpdateConfig({ routerURL, token: apiKey });