switchboard-router 0.9.60 → 0.9.61

package/app/package.json

@@ -1,6 +1,6 @@
 {
   "name": "switchboard-app",
-  "version": "0.9.60",
+  "version": "0.9.61",
   "description": "Switchboard — intelligent model routing dashboard",
   "private": true,
   "engines": {

package/cli.js

@@ -11,6 +11,7 @@ const { DEFAULT_HOST, DEFAULT_PORT, formatHelp, isLoopbackHost, parseCliArgs } =
 const processTools = require("./src/cli/processManager");
 const { findListeningPids, observeChildExit } = processTools;
 const { probeSwitchboard, probeTcp, startHealthWatchdog, waitForSwitchboard } = require("./src/cli/serverStatus");
+const { maxOldSpaceArgs } = require("./src/shared/heapSize");
 
 // Subcommands (`switchboard xai video …`) run against an already-running
 // gateway and skip the launcher flow (no arg parsing, no server spawn).
@@ -672,7 +673,10 @@ function startServer(latestVersion) {
     // Boot failures abandon after maxBootFailures; watchdog respawns keep
     // everHealthy so transient overload does not permanently quit the launcher.
     if (resetEverHealthy) everHealthy = false;
-    const child = spawn(RUNTIME, ["--max-old-space-size=6144", serverPath], {
+    // Heap sized to host RAM (6144 MB on ≥12 GB hosts, less on small ones);
+    // a fixed 6144 gets kernel-OOM-killed on small VPS hosts. Skipped when
+    // the operator set their own flag via NODE_OPTIONS.
+    const child = spawn(RUNTIME, [...maxOldSpaceArgs(), serverPath], {
       cwd: standaloneDir,
       stdio: ["ignore", "pipe", "pipe"],
       detached: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "switchboard-router",
-  "version": "0.9.60",
+  "version": "0.9.61",
   "description": "Switchboard CLI — local AI routing gateway (install: npm i -g switchboard-router; run: switchboard)",
   "bin": {
     "switchboard": "./cli.js",

package/src/shared/heapSize.js

@@ -0,0 +1,35 @@
+// Host-aware V8 old-space sizing. Mirror of scripts/heapSizing.mjs — the CLI
+// package is packed separately and cannot import from the app repo, so keep
+// the semantics identical: explicit SWITCHBOARD_MAX_OLD_SPACE_MB wins, else
+// half of host RAM clamped to [512, 6144] MB. A fixed 6144 invites the kernel
+// OOM killer on small hosts long before V8 feels GC pressure.
+const os = require("node:os");
+
+function nodeOptionsHasMaxOldSpace(env = process.env) {
+  return /--max-old-space-size(?:=|\s)/.test((env && env.NODE_OPTIONS) || "");
+}
+
+function resolveMaxOldSpaceMb({ env = process.env, totalMemBytes } = {}) {
+  const override = Number.parseInt((env && env.SWITCHBOARD_MAX_OLD_SPACE_MB) || "", 10);
+  if (Number.isFinite(override) && override >= 256) return override;
+
+  let total = Number.isFinite(totalMemBytes) && totalMemBytes > 0 ? totalMemBytes : null;
+  if (!total) {
+    try {
+      const detected = os.totalmem();
+      if (Number.isFinite(detected) && detected > 0) total = detected;
+    } catch { /* fall through to fallback */ }
+  }
+  if (!total) return 2048;
+  const halfMb = Math.floor(total / (1024 * 1024) / 2);
+  return Math.min(6144, Math.max(512, halfMb));
+}
+
+/** Node CLI args to prepend, or [] when the operator already set a heap flag. */
+function maxOldSpaceArgs(options = {}) {
+  const env = options.env ?? process.env;
+  if (nodeOptionsHasMaxOldSpace(env)) return [];
+  return [`--max-old-space-size=${resolveMaxOldSpaceMb(options)}`];
+}
+
+module.exports = { resolveMaxOldSpaceMb, nodeOptionsHasMaxOldSpace, maxOldSpaceArgs };