@camstack/system 1.1.13 → 1.1.15

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,76 @@ async function getPidStats$1(pids) {
 		});
 	});
 }
+/**
+* Resolve the declared heap profile for one addon by reading its package.json manifest
+* (`camstack.addons[].execution.heapProfile`). `addonDir` points at the addon's built `dist`, so the
+* manifest is one level up; we also try `addonDir` itself for layouts where it IS the package root.
+* Result is cached per (dir,id) — spawns are infrequent but a runner may re-spawn on crash/restart.
+* Returns `undefined` when the manifest is unreadable or declares no profile → treated as light.
+*/
+var heapProfileCache = /* @__PURE__ */ new Map();
+function readAddonHeapProfile(spec) {
+	const cacheKey = `${spec.addonDir}::${spec.addonId}`;
+	const cached = heapProfileCache.get(cacheKey);
+	if (cached !== void 0 || heapProfileCache.has(cacheKey)) return cached;
+	let profile;
+	for (const manifestPath of [node_path.join(spec.addonDir, "package.json"), node_path.join(node_path.dirname(spec.addonDir), "package.json")]) try {
+		const raw = node_fs.readFileSync(manifestPath, "utf8");
+		const parsed = JSON.parse(raw);
+		profile = extractHeapProfile(parsed, spec.addonId);
+		if (profile !== void 0) break;
+		if (manifestHasAddon(parsed, spec.addonId)) break;
+	} catch {}
+	heapProfileCache.set(cacheKey, profile);
+	return profile;
+}
+function manifestHasAddon(parsed, addonId) {
+	return readManifestAddons(parsed).some((a) => a.id === addonId);
+}
+function extractHeapProfile(parsed, addonId) {
+	const value = readManifestAddons(parsed).find((a) => a.id === addonId)?.execution?.heapProfile;
+	return value === "heavy" || value === "light" ? value : void 0;
+}
+function readManifestAddons(parsed) {
+	if (typeof parsed !== "object" || parsed === null) return [];
+	const camstack = parsed.camstack;
+	if (typeof camstack !== "object" || camstack === null) return [];
+	const addons = camstack.addons;
+	return Array.isArray(addons) ? addons : [];
+}
+/**
+* A runner is heavy if ANY co-located addon declares `heapProfile: 'heavy'` in its manifest.
+* Everything else (the un-annotated default) is a light control-plane runner. No hard-coded names.
+*/
+function isHeavyRunner(addons) {
+	return addons.some((a) => readAddonHeapProfile(a) === "heavy");
+}
+/**
+* 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 +92491,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,76 @@ async function getPidStats$1(pids) {
 		});
 	});
 }
+/**
+* Resolve the declared heap profile for one addon by reading its package.json manifest
+* (`camstack.addons[].execution.heapProfile`). `addonDir` points at the addon's built `dist`, so the
+* manifest is one level up; we also try `addonDir` itself for layouts where it IS the package root.
+* Result is cached per (dir,id) — spawns are infrequent but a runner may re-spawn on crash/restart.
+* Returns `undefined` when the manifest is unreadable or declares no profile → treated as light.
+*/
+var heapProfileCache = /* @__PURE__ */ new Map();
+function readAddonHeapProfile(spec) {
+	const cacheKey = `${spec.addonDir}::${spec.addonId}`;
+	const cached = heapProfileCache.get(cacheKey);
+	if (cached !== void 0 || heapProfileCache.has(cacheKey)) return cached;
+	let profile;
+	for (const manifestPath of [path$39.join(spec.addonDir, "package.json"), path$39.join(path$39.dirname(spec.addonDir), "package.json")]) try {
+		const raw = fs$17.readFileSync(manifestPath, "utf8");
+		const parsed = JSON.parse(raw);
+		profile = extractHeapProfile(parsed, spec.addonId);
+		if (profile !== void 0) break;
+		if (manifestHasAddon(parsed, spec.addonId)) break;
+	} catch {}
+	heapProfileCache.set(cacheKey, profile);
+	return profile;
+}
+function manifestHasAddon(parsed, addonId) {
+	return readManifestAddons(parsed).some((a) => a.id === addonId);
+}
+function extractHeapProfile(parsed, addonId) {
+	const value = readManifestAddons(parsed).find((a) => a.id === addonId)?.execution?.heapProfile;
+	return value === "heavy" || value === "light" ? value : void 0;
+}
+function readManifestAddons(parsed) {
+	if (typeof parsed !== "object" || parsed === null) return [];
+	const camstack = parsed.camstack;
+	if (typeof camstack !== "object" || camstack === null) return [];
+	const addons = camstack.addons;
+	return Array.isArray(addons) ? addons : [];
+}
+/**
+* A runner is heavy if ANY co-located addon declares `heapProfile: 'heavy'` in its manifest.
+* Everything else (the un-annotated default) is a light control-plane runner. No hard-coded names.
+*/
+function isHeavyRunner(addons) {
+	return addons.some((a) => readAddonHeapProfile(a) === "heavy");
+}
+/**
+* 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 +92483,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.15",
   "description": "Core addon for CamStack — builtins, pipeline, process management, auth, logging, events",
   "keywords": [
     "camstack",