@camstack/system 1.1.13 → 1.1.14

package/dist/builtins/device-manager/device-meta-actions.d.ts

@@ -1,4 +1,4 @@
-import { InferProvider, deviceManagerCapability, AddonContext } from '@camstack/types';
+import { AddonContext, deviceManagerCapability, InferProvider } from '@camstack/types';
 import { DeviceManagerSettings, DeviceMetaStore } from './device-meta-store.js';
 import { ProviderContext } from './device-provider-context.js';
 type IDeviceManagerProvider = InferProvider<typeof deviceManagerCapability>;

package/dist/index.js

@@ -92343,6 +92343,60 @@ async function getPidStats$1(pids) {
 		});
 	});
 }
+/**
+* Heavy runners (media / ML / native): frame data lives in shared memory (`@camstack/shm-ring`) and
+* native buffers, but these processes still allocate enough on the JS heap that shrinking V8's
+* young generation would add scavenge-GC churn, and a low old-space cap would risk OOM. They keep
+* V8 defaults. Everyone else is a lightweight, mostly-idle control-plane runner (providers, auth,
+* tunnels, storage, smtp, notifier, admin-ui) that over-reserves ~15 MB of young-gen it never uses.
+*
+* Matched by a substring of the addon package dir (e.g. `.../@camstack/addon-pipeline/dist`), so it
+* is robust to the addonId vs package-name distinction.
+*/
+var HEAVY_RUNNER_DIR_MARKERS = [
+	"addon-pipeline",
+	"addon-detection-pipeline",
+	"addon-pipeline-runner",
+	"addon-pipeline-orchestrator",
+	"addon-decoder",
+	"addon-benchmark",
+	"addon-audio-codec",
+	"addon-motion",
+	"addon-embedding",
+	"addon-model-studio",
+	"addon-analytics-suite",
+	"addon-provider-reolink",
+	"addon-provider-matter"
+];
+function isHeavyRunner(addons) {
+	return addons.some((a) => HEAVY_RUNNER_DIR_MARKERS.some((m) => a.addonDir.includes(m)));
+}
+/**
+* Per-placement V8 heap flags (Block D). LIGHT runners cap their young generation
+* (`--max-semi-space-size`) to reclaim V8's over-reservation — a measured ~15 MB/runner win.
+* HEAVY runners keep V8 defaults. The old-space cap is opt-in via env (unset = uncapped = no OOM
+* risk) so it can be enabled after before/after measurement on the real cluster.
+*
+* Kill-switch: `CAMSTACK_RUNNER_HEAP_TUNING=off` disables all flags (recover without a rebuild).
+* Overrides: `CAMSTACK_RUNNER_LIGHT_SEMI_SPACE_MB` (default 2), `CAMSTACK_RUNNER_LIGHT_MAX_OLD_MB`
+* (default unset = no old-space cap).
+*/
+function runnerHeapFlags(addons) {
+	if (process.env["CAMSTACK_RUNNER_HEAP_TUNING"] === "off") return [];
+	if (isHeavyRunner(addons)) return [];
+	const semiMb = positiveIntEnv("CAMSTACK_RUNNER_LIGHT_SEMI_SPACE_MB", 2);
+	const oldMb = positiveIntEnv("CAMSTACK_RUNNER_LIGHT_MAX_OLD_MB", 0);
+	const flags = [];
+	if (semiMb > 0) flags.push(`--max-semi-space-size=${semiMb}`);
+	if (oldMb > 0) flags.push(`--max-old-space-size=${oldMb}`);
+	return flags;
+}
+function positiveIntEnv(name, fallback) {
+	const raw = process.env[name];
+	if (raw === void 0) return fallback;
+	const n = Number.parseInt(raw, 10);
+	return Number.isFinite(n) && n >= 0 ? n : fallback;
+}
 var MAX_BACKOFF_MS = 3e4;
 var CRASH_WINDOW_MS = 6e4;
 var MAX_CRASHES_IN_WINDOW = 5;
@@ -92421,7 +92475,8 @@ function createProcessService(parentNodeId, dataDir, deps, parentTcpPort, parent
 			...parentUdsPath !== void 0 ? { CAMSTACK_PARENT_UDS_PATH: parentUdsPath } : {},
 			...env
 		};
-		const child = spawnFn(process.execPath, [runnerPath], {
+		const heapFlags = runnerHeapFlags(addons);
+		const child = spawnFn(process.execPath, [...heapFlags, runnerPath], {
 			env: childEnv,
 			stdio: [
 				"ignore",

package/dist/index.mjs

@@ -92335,6 +92335,60 @@ async function getPidStats$1(pids) {
 		});
 	});
 }
+/**
+* Heavy runners (media / ML / native): frame data lives in shared memory (`@camstack/shm-ring`) and
+* native buffers, but these processes still allocate enough on the JS heap that shrinking V8's
+* young generation would add scavenge-GC churn, and a low old-space cap would risk OOM. They keep
+* V8 defaults. Everyone else is a lightweight, mostly-idle control-plane runner (providers, auth,
+* tunnels, storage, smtp, notifier, admin-ui) that over-reserves ~15 MB of young-gen it never uses.
+*
+* Matched by a substring of the addon package dir (e.g. `.../@camstack/addon-pipeline/dist`), so it
+* is robust to the addonId vs package-name distinction.
+*/
+var HEAVY_RUNNER_DIR_MARKERS = [
+	"addon-pipeline",
+	"addon-detection-pipeline",
+	"addon-pipeline-runner",
+	"addon-pipeline-orchestrator",
+	"addon-decoder",
+	"addon-benchmark",
+	"addon-audio-codec",
+	"addon-motion",
+	"addon-embedding",
+	"addon-model-studio",
+	"addon-analytics-suite",
+	"addon-provider-reolink",
+	"addon-provider-matter"
+];
+function isHeavyRunner(addons) {
+	return addons.some((a) => HEAVY_RUNNER_DIR_MARKERS.some((m) => a.addonDir.includes(m)));
+}
+/**
+* Per-placement V8 heap flags (Block D). LIGHT runners cap their young generation
+* (`--max-semi-space-size`) to reclaim V8's over-reservation — a measured ~15 MB/runner win.
+* HEAVY runners keep V8 defaults. The old-space cap is opt-in via env (unset = uncapped = no OOM
+* risk) so it can be enabled after before/after measurement on the real cluster.
+*
+* Kill-switch: `CAMSTACK_RUNNER_HEAP_TUNING=off` disables all flags (recover without a rebuild).
+* Overrides: `CAMSTACK_RUNNER_LIGHT_SEMI_SPACE_MB` (default 2), `CAMSTACK_RUNNER_LIGHT_MAX_OLD_MB`
+* (default unset = no old-space cap).
+*/
+function runnerHeapFlags(addons) {
+	if (process.env["CAMSTACK_RUNNER_HEAP_TUNING"] === "off") return [];
+	if (isHeavyRunner(addons)) return [];
+	const semiMb = positiveIntEnv("CAMSTACK_RUNNER_LIGHT_SEMI_SPACE_MB", 2);
+	const oldMb = positiveIntEnv("CAMSTACK_RUNNER_LIGHT_MAX_OLD_MB", 0);
+	const flags = [];
+	if (semiMb > 0) flags.push(`--max-semi-space-size=${semiMb}`);
+	if (oldMb > 0) flags.push(`--max-old-space-size=${oldMb}`);
+	return flags;
+}
+function positiveIntEnv(name, fallback) {
+	const raw = process.env[name];
+	if (raw === void 0) return fallback;
+	const n = Number.parseInt(raw, 10);
+	return Number.isFinite(n) && n >= 0 ? n : fallback;
+}
 var MAX_BACKOFF_MS = 3e4;
 var CRASH_WINDOW_MS = 6e4;
 var MAX_CRASHES_IN_WINDOW = 5;
@@ -92413,7 +92467,8 @@ function createProcessService(parentNodeId, dataDir, deps, parentTcpPort, parent
 			...parentUdsPath !== void 0 ? { CAMSTACK_PARENT_UDS_PATH: parentUdsPath } : {},
 			...env
 		};
-		const child = spawnFn(process.execPath, [runnerPath], {
+		const heapFlags = runnerHeapFlags(addons);
+		const child = spawnFn(process.execPath, [...heapFlags, runnerPath], {
 			env: childEnv,
 			stdio: [
 				"ignore",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/system",
-  "version": "1.1.13",
+  "version": "1.1.14",
   "description": "Core addon for CamStack — builtins, pipeline, process management, auth, logging, events",
   "keywords": [
     "camstack",