zevairouter 1.0.155 → 1.0.157

package/cli/app/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Unreleased
 
+# v1.0.157 (2026-07-28)
+
+## Fixes
+- **Reliable macOS installer cutover**: desktop updates allow slow Next.js shutdowns to finish, wait after a forced stop, and report an explicit error instead of silently aborting between runtime preparation and LaunchAgent restart.
+
+# v1.0.156 (2026-07-28)
+
+## Fixes
+- **Reliable npm release completion**: release verification now tolerates bounded registry propagation delays, and package metadata uses npm's canonical bin and repository forms without publish-time rewrites.
+- **Persistent desktop bind address**: tray autostart now records the selected host alongside its port, and the Unix installer accepts an explicit `ZEVAI_HOST=0.0.0.0` for LAN-accessible Mac or desktop installs without weakening the localhost default.
+
 # v1.0.155 (2026-07-28)
 
 ## Fixes

package/cli/app/package.json

@@ -1,9 +1,9 @@
 {
   "name": "zevairouter",
-  "version": "1.0.155",
+  "version": "1.0.157",
   "description": "Self-hosted AI router: many providers, one OpenAI-compatible /v1 endpoint and dashboard",
   "bin": {
-    "zevai": "./cli/cli.js"
+    "zevai": "cli/cli.js"
   },
   "files": [
     "cli/cli.js",
@@ -111,7 +111,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Verifiedlabs/zevairouter"
+    "url": "git+https://github.com/Verifiedlabs/zevairouter.git"
   },
   "bugs": {
     "url": "https://github.com/Verifiedlabs/zevairouter/issues"

package/cli/cli.js

@@ -1635,6 +1635,7 @@ function startServer(latestVersion) {
       const { initTray } = require("./src/cli/tray/tray");
       initTray({
         port,
+        host,
         onQuit: () => {
           isShuttingDown = true;
           console.log("\n👋 Shutting down from tray...");
@@ -1743,7 +1744,7 @@ function startServer(latestVersion) {
             // Enable auto startup on OS boot
           try {
             const { enableAutoStart } = require("./src/cli/tray/autostart");
-            enableAutoStart(__filename, { port });
+            enableAutoStart(__filename, { port, host });
           } catch (e) { }
 
           if (process.platform === "darwin") {

package/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zevairouter-cli",
-  "version": "1.0.155",
+  "version": "1.0.157",
   "private": true,
   "description": "ZevaiRouter CLI - Start and manage ZevaiRouter server",
   "bin": {

package/cli/src/cli/tray/autostart.js

@@ -2,10 +2,12 @@ const fs = require("fs");
 const path = require("path");
 const os = require("os");
 const { execFileSync } = require("child_process");
+const { normalizeHost } = require("../updateRuntimeState");
 
 const APP_NAME = "zevai";
 const APP_LABEL = "com.zevairouter.autostart";
 const DEFAULT_PORT = 1997;
+const DEFAULT_HOST = "127.0.0.1";
 
 function normalizePort(value) {
   const port = Number(value);
@@ -33,7 +35,27 @@ function escapeXml(value) {
 }
 
 function desktopExecArg(value) {
-  return `"${String(value).replaceAll("\\", "\\\\").replaceAll('"', '\\"').replaceAll("`", "\\`").replaceAll("$", "\\$")}"`;
+  return `"${String(value).replaceAll("%", "%%").replaceAll("\\", "\\\\").replaceAll('"', '\\"').replaceAll("`", "\\`").replaceAll("$", "\\$")}"`;
+}
+
+function renderWindowsVbs(nodePath, routerScript, port, host) {
+  // WshShell.Run expands paired %NAME% references before launching.
+  if (host.indexOf("%") !== host.lastIndexOf("%")) return null;
+  return `Set WshShell = CreateObject("WScript.Shell")
+WshShell.Run """${nodePath}"" ""${routerScript}"" --tray --skip-update --port ${port} --host ""${host}""", 0, False
+`;
+}
+
+function renderLinuxDesktop(nodePath, routerScript, port, host) {
+  return `[Desktop Entry]
+Type=Application
+Name=ZevaiRouter
+Comment=ZevaiRouter API Proxy
+Exec=${desktopExecArg(nodePath)} ${desktopExecArg(routerScript)} --tray --skip-update --port ${port} --host ${desktopExecArg(host)}
+Hidden=false
+NoDisplay=false
+X-GNOME-Autostart-enabled=true
+`;
 }
 
 /**
@@ -72,20 +94,21 @@ function getCliJsPath(cliPath) {
 /**
  * Enable auto startup on OS boot
  * @param {string} cliPath - Optional path to cli.js (defaults to auto-detect)
- * @param {{port?: number|string}} options - Runtime options to persist
+ * @param {{port?: number|string, host?: string}} options - Runtime options to persist
  * @returns {boolean} success
  */
 function enableAutoStart(cliPath, options = {}) {
   const platform = process.platform;
   const port = normalizePort(options.port);
+  const host = normalizeHost(options.host ?? DEFAULT_HOST);
 
-  if (!["darwin", "win32", "linux"].includes(platform)) return false;
+  if (!host || !["darwin", "win32", "linux"].includes(platform)) return false;
   if (platform === "linux" && !process.env.DISPLAY) return false;
 
   try {
-    if (platform === "darwin") return enableMacOS(cliPath, port);
-    if (platform === "win32") return enableWindows(cliPath, port);
-    if (platform === "linux") return enableLinux(cliPath, port);
+    if (platform === "darwin") return enableMacOS(cliPath, port, host);
+    if (platform === "win32") return enableWindows(cliPath, port, host);
+    if (platform === "linux") return enableLinux(cliPath, port, host);
   } catch (err) {
     // Silent fail — autostart is optional
   }
@@ -170,7 +193,7 @@ function isAgentSelfMacOS() {
   }
 }
 
-function enableMacOS(cliPath, port) {
+function enableMacOS(cliPath, port, host) {
   const launchAgentsDir = path.join(os.homedir(), "Library", "LaunchAgents");
   const plistPath = path.join(launchAgentsDir, `${APP_LABEL}.plist`);
 
@@ -205,6 +228,8 @@ function enableMacOS(cliPath, port) {
         <string>--skip-update</string>
         <string>--port</string>
         <string>${port}</string>
+        <string>--host</string>
+        <string>${escapeXml(host)}</string>
     </array>
     <key>EnvironmentVariables</key>
     <dict>
@@ -270,7 +295,7 @@ function disableMacOS() {
 
 // ============ Windows ============
 
-function enableWindows(cliPath, port) {
+function enableWindows(cliPath, port, host) {
   const startupDir = path.join(process.env.APPDATA || "", "Microsoft", "Windows", "Start Menu", "Programs", "Startup");
   const vbsPath = path.join(startupDir, `${APP_NAME}.vbs`);
 
@@ -282,9 +307,8 @@ function enableWindows(cliPath, port) {
 
   // Run node + cli.js directly, hidden window. Avoids the fragile
   // `zevairouter.cmd` lookup that depended on the npm prefix path.
-  const vbsContent = `Set WshShell = CreateObject("WScript.Shell")
-WshShell.Run """${nodePath}"" ""${routerScript}"" --tray --skip-update --port ${port}", 0, False
-`;
+  const vbsContent = renderWindowsVbs(nodePath, routerScript, port, host);
+  if (!vbsContent) return false;
   writeAtomic(vbsPath, `\uFEFF${vbsContent}`, { encoding: "utf16le" });
   return true;
 }
@@ -299,7 +323,7 @@ function disableWindows() {
 
 // ============ Linux ============
 
-function enableLinux(cliPath, port) {
+function enableLinux(cliPath, port, host) {
   const autostartDir = path.join(os.homedir(), ".config", "autostart");
   const desktopPath = path.join(autostartDir, `${APP_NAME}.desktop`);
 
@@ -312,15 +336,7 @@ function enableLinux(cliPath, port) {
   const routerScript = getCliJsPath(cliPath);
   if (!routerScript) return false;
 
-  const desktopContent = `[Desktop Entry]
-Type=Application
-Name=ZevaiRouter
-Comment=ZevaiRouter API Proxy
-Exec=${desktopExecArg(nodePath)} ${desktopExecArg(routerScript)} --tray --skip-update --port ${port}
-Hidden=false
-NoDisplay=false
-X-GNOME-Autostart-enabled=true
-`;
+  const desktopContent = renderLinuxDesktop(nodePath, routerScript, port, host);
   writeAtomic(desktopPath, desktopContent);
   return true;
 }
@@ -336,5 +352,9 @@ function disableLinux() {
 module.exports = {
   enableAutoStart,
   disableAutoStart,
-  isAutoStartEnabled
+  isAutoStartEnabled,
+  _test: {
+    renderLinuxDesktop,
+    renderWindowsVbs,
+  },
 };

package/cli/src/cli/tray/tray.js

@@ -38,7 +38,7 @@ function isTraySupported() {
 
 /**
  * Initialize system tray with menu
- * @param {Object} options - { port, onQuit, onOpenDashboard }
+ * @param {Object} options - { port, host, onQuit, onOpenDashboard }
  * @returns {Object|null} tray instance or null if not supported/failed
  */
 function initTray(options) {
@@ -88,7 +88,7 @@ function getAutostartEnabled() {
  * Handle menu item click (shared logic)
  */
 function handleClick(index, options, onAutostartToggle) {
-  const { onQuit, onOpenDashboard, port } = options;
+  const { onQuit, onOpenDashboard, port, host } = options;
   if (index === MENU_INDEX.DASHBOARD) {
     if (onOpenDashboard) onOpenDashboard();
     else openBrowser(`http://localhost:${port}/dashboard`);
@@ -97,7 +97,7 @@ function handleClick(index, options, onAutostartToggle) {
     try {
       const { enableAutoStart, disableAutoStart } = require("./autostart");
       if (enabled) disableAutoStart();
-      else enableAutoStart(undefined, { port });
+      else enableAutoStart(undefined, { port, host });
       onAutostartToggle(!enabled);
     } catch (e) {}
   } else if (index === MENU_INDEX.QUIT) {

package/cli/src/cli/updateRuntimeState.js

@@ -511,6 +511,21 @@ function parseMacAutostart(plistText, options) {
   };
 }
 
+function decodeDesktopExecFieldCodes(command) {
+  const source = String(command || "");
+  let decoded = "";
+  for (let index = 0; index < source.length; index += 1) {
+    if (source[index] !== "%") {
+      decoded += source[index];
+      continue;
+    }
+    if (source[index + 1] !== "%") return null;
+    decoded += "%";
+    index += 1;
+  }
+  return decoded;
+}
+
 function parseLinuxAutostart(desktopText, options) {
   if (typeof desktopText !== "string" || !desktopText.trim()) return null;
   const values = new Map();
@@ -520,7 +535,9 @@ function parseLinuxAutostart(desktopText, options) {
   }
   if (/^true$/i.test(values.get("Hidden") || "")) return null;
   if (/^false$/i.test(values.get("X-GNOME-Autostart-enabled") || "")) return null;
-  const tokens = splitCommandLine(values.get("Exec") || "");
+  const execCommand = decodeDesktopExecFieldCodes(values.get("Exec") || "");
+  if (execCommand == null) return null;
+  const tokens = splitCommandLine(execCommand);
   const cliArgs = cliArgsFromTokens(tokens, options.cliPath, options.canonicalizePath);
   if (!cliArgs || !hasTrayArg(cliArgs)) return null;
   const portOption = readPortOption(cliArgs);

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "zevairouter",
-  "version": "1.0.155",
+  "version": "1.0.157",
   "description": "Self-hosted AI router: many providers, one OpenAI-compatible /v1 endpoint and dashboard",
   "bin": {
-    "zevai": "./cli/cli.js"
+    "zevai": "cli/cli.js"
   },
   "files": [
     "cli/cli.js",
@@ -111,7 +111,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Verifiedlabs/zevairouter"
+    "url": "git+https://github.com/Verifiedlabs/zevairouter.git"
   },
   "bugs": {
     "url": "https://github.com/Verifiedlabs/zevairouter/issues"