@camstack/system 1.0.6 → 1.0.8

package/dist/builtins/platform-probe/index.js

@@ -60,8 +60,8 @@ async function getAvailableRAM_MB() {
 				const match = readFileSync("/proc/meminfo", "utf8").match(/MemAvailable:\s+(\d+)\s+kB/);
 				if (match) return Math.round(parseInt(match[1]) / 1024);
 			}
-		} catch (err) {
-			console.debug(`RAM probe failed, using total RAM fallback: ${(0, _camstack_types.errMsg)(err)}`);
+		} catch (probeErr) {
+			console.debug(`RAM probe failed, using total RAM fallback: ${(0, _camstack_types.errMsg)(probeErr)}`);
 		}
 		return Math.round(node_os.totalmem() / 1024 / 1024);
 	}
@@ -73,10 +73,9 @@ var PlatformScorer = class {
 	* Path to the embedded portable Python (from `ctx.deps.ensurePython()`).
 	* The Docker hub ships NO system `python3` — inference runs on the
 	* downloaded portable build — so probing system `python3`/`python` would
-	* wrongly report "Python not found" and never surface coreml/openvino
-	* backends. When set, the Python module probes run against THIS binary;
-	* `null` falls back to a system `python3`/`python` lookup (dev / agent
-	* environments where Python is on PATH).
+	* wrongly report "Python not found". When set, the interpreter lookup
+	* tries THIS binary first; `null` falls back to a system `python3`/`python`
+	* lookup (dev / agent environments where Python is on PATH).
 	*/
 	embeddedPythonPath;
 	constructor(logger = noopLogger, embeddedPythonPath = null) {
@@ -84,14 +83,16 @@ var PlatformScorer = class {
 		this.embeddedPythonPath = embeddedPythonPath;
 	}
 	/**
-	* Probe hardware + runtimes and score all backend combos.
+	* Probe hardware + derive scores from pure rules and score all backend combos.
 	*
 	* An optional `onPhase` callback is invoked at each step so consumers
 	* (e.g. the platform-probe addon) can emit live progress events on
 	* the event bus. The callback takes a phase id + a typed payload; all
-	* phases fire in strict order: `started` → `hardware` → `node-backends`
-	* → `python-backends` → `scored` → `done`. On failure, `error` fires
-	* once with the exception. Cached after first call.
+	* phases fire in strict order: `started` → `hardware` → `scored` → `done`.
+	* On failure, `error` fires once with the exception. Cached after first call.
+	*
+	* Scores are hardware-driven only (no Python module import subprocess):
+	* `scoreRuntimes` from `@camstack/types` is the single source of truth.
 	*/
 	async probe(onPhase) {
 		if (this.cached) return this.cached;
@@ -109,19 +110,10 @@ var PlatformScorer = class {
 		if (hardware.gpu) this.logger.info("GPU detected", { meta: { name: hardware.gpu.name } });
 		if (hardware.npu) this.logger.info("NPU detected", { meta: { type: hardware.npu.type } });
 		onPhase?.("hardware", { hardware });
-		this.logger.info("Probing Python backends...");
-		const pythonInfo = await this.probePythonBackends();
-		if (pythonInfo.pythonPath) this.logger.info("Python backends detected", { meta: {
-			pythonPath: pythonInfo.pythonPath,
-			backends: pythonInfo.backends.filter((b) => b.available).map((b) => b.id)
-		} });
+		const { scores, best: bestScore } = (0, _camstack_types.scoreRuntimes)(hardware);
+		const pythonPath = await this.resolvePythonPath();
+		if (pythonPath) this.logger.info("Python interpreter located", { meta: { pythonPath } });
 		else this.logger.info("Python: not found");
-		onPhase?.("python-backends", {
-			pythonPath: pythonInfo.pythonPath,
-			backends: pythonInfo.backends
-		});
-		const scores = this.scoreBackends(hardware, pythonInfo.backends);
-		const bestScore = scores.find((s) => s.available) ?? scores[scores.length - 1];
 		const elapsed = Date.now() - start;
 		this.logger.info("Scoring complete", { meta: {
 			elapsedMs: elapsed,
@@ -144,9 +136,9 @@ var PlatformScorer = class {
 		} });
 		this.cached = {
 			hardware,
-			scores,
+			scores: [...scores],
 			bestScore,
-			pythonPath: pythonInfo.pythonPath
+			pythonPath
 		};
 		onPhase?.("scored", {
 			scores,
@@ -231,130 +223,26 @@ var PlatformScorer = class {
 			npu
 		};
 	}
-	async probePythonBackends() {
+	/**
+	* Locates a Python interpreter without importing any module.
+	*
+	* Tries: embedded path (if configured) → `python3` → `python`.
+	* Returns the first executable found, or `null` if none respond.
+	* MUST NOT run `-c "import ..."` — interpreter location only.
+	*/
+	async resolvePythonPath() {
 		const candidates = [
 			...this.embeddedPythonPath ? [this.embeddedPythonPath] : [],
 			"python3",
 			"python"
 		];
-		let pythonPath = null;
 		for (const cmd of candidates) try {
 			await execFileAsync$2(cmd, ["--version"], { timeout: 5e3 });
-			pythonPath = cmd;
-			break;
+			return cmd;
 		} catch (err) {
-			console.debug(`Python command "${cmd}" not found: ${(0, _camstack_types.errMsg)(err)}`);
+			this.logger.debug(`Python command "${cmd}" not found`, { meta: { error: (0, _camstack_types.errMsg)(err) } });
 		}
-		if (!pythonPath) return {
-			pythonPath: null,
-			backends: []
-		};
-		const results = await Promise.all([
-			[
-				"coremltools",
-				"coreml",
-				"coreml"
-			],
-			[
-				"openvino.runtime",
-				"openvino",
-				"openvino"
-			],
-			[
-				"torch",
-				"pytorch",
-				"onnx"
-			],
-			[
-				"onnxruntime",
-				"onnx-py",
-				"onnx"
-			]
-		].map(async ([mod, id, format]) => {
-			const probeStart = Date.now();
-			let available = false;
-			try {
-				await execFileAsync$2(pythonPath, ["-c", `import ${mod}`], { timeout: 3e4 });
-				available = true;
-				this.logger.info("Python backend confirmed", { meta: {
-					backend: id,
-					module: mod
-				} });
-			} catch (err) {
-				console.debug(`Python module "${mod}" not installed: ${(0, _camstack_types.errMsg)(err)}`);
-				if (id === "openvino") this.logger.info("Python backend not yet confirmed: openvino (may be pending proactive install on Intel hardware — falling back to onnx-cpu)", { meta: { module: mod } });
-			}
-			const probeMs = Date.now() - probeStart;
-			this.logger.debug("Python module probed", { meta: {
-				module: mod,
-				available,
-				probeMs
-			} });
-			return {
-				mod,
-				id,
-				format,
-				available
-			};
-		}));
-		const backends = [];
-		for (const r of results) if (r.id === "coreml" && node_os.platform() === "darwin") backends.push({
-			id: r.id,
-			format: r.format,
-			available: r.available
-		});
-		else if (r.available) backends.push({
-			id: r.id,
-			format: r.format,
-			available: r.available
-		});
-		return {
-			pythonPath,
-			backends
-		};
-	}
-	scoreBackends(hardware, pythonBackends) {
-		const scores = [];
-		if (hardware.platform === "darwin" && hardware.arch === "arm64") {
-			const pyCoreMl = pythonBackends.find((b) => b.id === "coreml");
-			if (pyCoreMl) scores.push({
-				runtime: "python",
-				backend: "coreml",
-				format: "coreml",
-				score: 95,
-				reason: "Apple Neural Engine (Python CoreML)",
-				available: pyCoreMl.available
-			});
-		}
-		if (hardware.gpu?.type === "nvidia") scores.push({
-			runtime: "python",
-			backend: "cuda",
-			format: "onnx",
-			score: 85,
-			reason: "NVIDIA CUDA (Python ONNX Runtime)",
-			available: true
-		});
-		const openvino = pythonBackends.find((b) => b.id === "openvino");
-		if (openvino) {
-			const score = hardware.npu?.type === "intel-npu" ? 90 : 80;
-			scores.push({
-				runtime: "python",
-				backend: "openvino",
-				format: "openvino",
-				score,
-				reason: "Intel OpenVINO",
-				available: openvino.available
-			});
-		}
-		scores.push({
-			runtime: "python",
-			backend: "cpu",
-			format: "onnx",
-			score: 50,
-			reason: "CPU (Python ONNX Runtime)",
-			available: true
-		});
-		return scores.toSorted((a, b) => b.score - a.score);
+		return null;
 	}
 };
 //#endregion

package/dist/builtins/platform-probe/index.mjs

@@ -1,5 +1,5 @@
 import * as fs from "node:fs";
-import { BaseAddon, EventCategory, errMsg, platformProbeCapability } from "@camstack/types";
+import { BaseAddon, EventCategory, errMsg, platformProbeCapability, scoreRuntimes } from "@camstack/types";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import * as os from "node:os";
@@ -53,8 +53,8 @@ async function getAvailableRAM_MB() {
 				const match = readFileSync("/proc/meminfo", "utf8").match(/MemAvailable:\s+(\d+)\s+kB/);
 				if (match) return Math.round(parseInt(match[1]) / 1024);
 			}
-		} catch (err) {
-			console.debug(`RAM probe failed, using total RAM fallback: ${errMsg(err)}`);
+		} catch (probeErr) {
+			console.debug(`RAM probe failed, using total RAM fallback: ${errMsg(probeErr)}`);
 		}
 		return Math.round(os.totalmem() / 1024 / 1024);
 	}
@@ -66,10 +66,9 @@ var PlatformScorer = class {
 	* Path to the embedded portable Python (from `ctx.deps.ensurePython()`).
 	* The Docker hub ships NO system `python3` — inference runs on the
 	* downloaded portable build — so probing system `python3`/`python` would
-	* wrongly report "Python not found" and never surface coreml/openvino
-	* backends. When set, the Python module probes run against THIS binary;
-	* `null` falls back to a system `python3`/`python` lookup (dev / agent
-	* environments where Python is on PATH).
+	* wrongly report "Python not found". When set, the interpreter lookup
+	* tries THIS binary first; `null` falls back to a system `python3`/`python`
+	* lookup (dev / agent environments where Python is on PATH).
 	*/
 	embeddedPythonPath;
 	constructor(logger = noopLogger, embeddedPythonPath = null) {
@@ -77,14 +76,16 @@ var PlatformScorer = class {
 		this.embeddedPythonPath = embeddedPythonPath;
 	}
 	/**
-	* Probe hardware + runtimes and score all backend combos.
+	* Probe hardware + derive scores from pure rules and score all backend combos.
 	*
 	* An optional `onPhase` callback is invoked at each step so consumers
 	* (e.g. the platform-probe addon) can emit live progress events on
 	* the event bus. The callback takes a phase id + a typed payload; all
-	* phases fire in strict order: `started` → `hardware` → `node-backends`
-	* → `python-backends` → `scored` → `done`. On failure, `error` fires
-	* once with the exception. Cached after first call.
+	* phases fire in strict order: `started` → `hardware` → `scored` → `done`.
+	* On failure, `error` fires once with the exception. Cached after first call.
+	*
+	* Scores are hardware-driven only (no Python module import subprocess):
+	* `scoreRuntimes` from `@camstack/types` is the single source of truth.
 	*/
 	async probe(onPhase) {
 		if (this.cached) return this.cached;
@@ -102,19 +103,10 @@ var PlatformScorer = class {
 		if (hardware.gpu) this.logger.info("GPU detected", { meta: { name: hardware.gpu.name } });
 		if (hardware.npu) this.logger.info("NPU detected", { meta: { type: hardware.npu.type } });
 		onPhase?.("hardware", { hardware });
-		this.logger.info("Probing Python backends...");
-		const pythonInfo = await this.probePythonBackends();
-		if (pythonInfo.pythonPath) this.logger.info("Python backends detected", { meta: {
-			pythonPath: pythonInfo.pythonPath,
-			backends: pythonInfo.backends.filter((b) => b.available).map((b) => b.id)
-		} });
+		const { scores, best: bestScore } = scoreRuntimes(hardware);
+		const pythonPath = await this.resolvePythonPath();
+		if (pythonPath) this.logger.info("Python interpreter located", { meta: { pythonPath } });
 		else this.logger.info("Python: not found");
-		onPhase?.("python-backends", {
-			pythonPath: pythonInfo.pythonPath,
-			backends: pythonInfo.backends
-		});
-		const scores = this.scoreBackends(hardware, pythonInfo.backends);
-		const bestScore = scores.find((s) => s.available) ?? scores[scores.length - 1];
 		const elapsed = Date.now() - start;
 		this.logger.info("Scoring complete", { meta: {
 			elapsedMs: elapsed,
@@ -137,9 +129,9 @@ var PlatformScorer = class {
 		} });
 		this.cached = {
 			hardware,
-			scores,
+			scores: [...scores],
 			bestScore,
-			pythonPath: pythonInfo.pythonPath
+			pythonPath
 		};
 		onPhase?.("scored", {
 			scores,
@@ -224,130 +216,26 @@ var PlatformScorer = class {
 			npu
 		};
 	}
-	async probePythonBackends() {
+	/**
+	* Locates a Python interpreter without importing any module.
+	*
+	* Tries: embedded path (if configured) → `python3` → `python`.
+	* Returns the first executable found, or `null` if none respond.
+	* MUST NOT run `-c "import ..."` — interpreter location only.
+	*/
+	async resolvePythonPath() {
 		const candidates = [
 			...this.embeddedPythonPath ? [this.embeddedPythonPath] : [],
 			"python3",
 			"python"
 		];
-		let pythonPath = null;
 		for (const cmd of candidates) try {
 			await execFileAsync$2(cmd, ["--version"], { timeout: 5e3 });
-			pythonPath = cmd;
-			break;
+			return cmd;
 		} catch (err) {
-			console.debug(`Python command "${cmd}" not found: ${errMsg(err)}`);
+			this.logger.debug(`Python command "${cmd}" not found`, { meta: { error: errMsg(err) } });
 		}
-		if (!pythonPath) return {
-			pythonPath: null,
-			backends: []
-		};
-		const results = await Promise.all([
-			[
-				"coremltools",
-				"coreml",
-				"coreml"
-			],
-			[
-				"openvino.runtime",
-				"openvino",
-				"openvino"
-			],
-			[
-				"torch",
-				"pytorch",
-				"onnx"
-			],
-			[
-				"onnxruntime",
-				"onnx-py",
-				"onnx"
-			]
-		].map(async ([mod, id, format]) => {
-			const probeStart = Date.now();
-			let available = false;
-			try {
-				await execFileAsync$2(pythonPath, ["-c", `import ${mod}`], { timeout: 3e4 });
-				available = true;
-				this.logger.info("Python backend confirmed", { meta: {
-					backend: id,
-					module: mod
-				} });
-			} catch (err) {
-				console.debug(`Python module "${mod}" not installed: ${errMsg(err)}`);
-				if (id === "openvino") this.logger.info("Python backend not yet confirmed: openvino (may be pending proactive install on Intel hardware — falling back to onnx-cpu)", { meta: { module: mod } });
-			}
-			const probeMs = Date.now() - probeStart;
-			this.logger.debug("Python module probed", { meta: {
-				module: mod,
-				available,
-				probeMs
-			} });
-			return {
-				mod,
-				id,
-				format,
-				available
-			};
-		}));
-		const backends = [];
-		for (const r of results) if (r.id === "coreml" && os.platform() === "darwin") backends.push({
-			id: r.id,
-			format: r.format,
-			available: r.available
-		});
-		else if (r.available) backends.push({
-			id: r.id,
-			format: r.format,
-			available: r.available
-		});
-		return {
-			pythonPath,
-			backends
-		};
-	}
-	scoreBackends(hardware, pythonBackends) {
-		const scores = [];
-		if (hardware.platform === "darwin" && hardware.arch === "arm64") {
-			const pyCoreMl = pythonBackends.find((b) => b.id === "coreml");
-			if (pyCoreMl) scores.push({
-				runtime: "python",
-				backend: "coreml",
-				format: "coreml",
-				score: 95,
-				reason: "Apple Neural Engine (Python CoreML)",
-				available: pyCoreMl.available
-			});
-		}
-		if (hardware.gpu?.type === "nvidia") scores.push({
-			runtime: "python",
-			backend: "cuda",
-			format: "onnx",
-			score: 85,
-			reason: "NVIDIA CUDA (Python ONNX Runtime)",
-			available: true
-		});
-		const openvino = pythonBackends.find((b) => b.id === "openvino");
-		if (openvino) {
-			const score = hardware.npu?.type === "intel-npu" ? 90 : 80;
-			scores.push({
-				runtime: "python",
-				backend: "openvino",
-				format: "openvino",
-				score,
-				reason: "Intel OpenVINO",
-				available: openvino.available
-			});
-		}
-		scores.push({
-			runtime: "python",
-			backend: "cpu",
-			format: "onnx",
-			score: 50,
-			reason: "CPU (Python ONNX Runtime)",
-			available: true
-		});
-		return scores.toSorted((a, b) => b.score - a.score);
+		return null;
 	}
 };
 //#endregion

package/dist/builtins/platform-probe/platform-scorer.d.ts

@@ -6,25 +6,32 @@ export declare class PlatformScorer {
      * Path to the embedded portable Python (from `ctx.deps.ensurePython()`).
      * The Docker hub ships NO system `python3` — inference runs on the
      * downloaded portable build — so probing system `python3`/`python` would
-     * wrongly report "Python not found" and never surface coreml/openvino
-     * backends. When set, the Python module probes run against THIS binary;
-     * `null` falls back to a system `python3`/`python` lookup (dev / agent
-     * environments where Python is on PATH).
+     * wrongly report "Python not found". When set, the interpreter lookup
+     * tries THIS binary first; `null` falls back to a system `python3`/`python`
+     * lookup (dev / agent environments where Python is on PATH).
      */
     private readonly embeddedPythonPath;
     constructor(logger?: IScopedLogger, embeddedPythonPath?: string | null);
     /**
-     * Probe hardware + runtimes and score all backend combos.
+     * Probe hardware + derive scores from pure rules and score all backend combos.
      *
      * An optional `onPhase` callback is invoked at each step so consumers
      * (e.g. the platform-probe addon) can emit live progress events on
      * the event bus. The callback takes a phase id + a typed payload; all
-     * phases fire in strict order: `started` → `hardware` → `node-backends`
-     * → `python-backends` → `scored` → `done`. On failure, `error` fires
-     * once with the exception. Cached after first call.
+     * phases fire in strict order: `started` → `hardware` → `scored` → `done`.
+     * On failure, `error` fires once with the exception. Cached after first call.
+     *
+     * Scores are hardware-driven only (no Python module import subprocess):
+     * `scoreRuntimes` from `@camstack/types` is the single source of truth.
      */
     probe(onPhase?: (phase: string, payload?: Record<string, unknown>) => void): Promise<PlatformCapabilities>;
     probeHardware(): Promise<HardwareInfo>;
-    private probePythonBackends;
-    private scoreBackends;
+    /**
+     * Locates a Python interpreter without importing any module.
+     *
+     * Tries: embedded path (if configured) → `python3` → `python`.
+     * Returns the first executable found, or `null` if none respond.
+     * MUST NOT run `-c "import ..."` — interpreter location only.
+     */
+    private resolvePythonPath;
 }

package/dist/builtins/storage-orchestrator/storage-orchestrator.addon.js

@@ -161,7 +161,7 @@ var StorageOrchestratorService = class {
 		const resolver = this.nodeLocalResolver;
 		if (!resolver) return;
 		let stamped = 0;
-		for (const [id, loc] of [...this.locations]) {
+		for (const [id, loc] of Array.from(this.locations)) {
 			if (loc.nodeId) continue;
 			if (resolver(loc.providerId) !== true) continue;
 			const updated = {
@@ -301,7 +301,7 @@ var StorageOrchestratorService = class {
 			this.logger.warn("storage-orchestrator: skipping prune — no location declarations loaded (fail-safe)");
 			return;
 		}
-		for (const [id, loc] of [...this.locations]) {
+		for (const [id, loc] of Array.from(this.locations)) {
 			if (this.registry.cardinalityOf(loc.type) !== null) continue;
 			if (loc.isSystem) {
 				this.locations.delete(id);

package/dist/builtins/storage-orchestrator/storage-orchestrator.addon.mjs

@@ -154,7 +154,7 @@ var StorageOrchestratorService = class {
 		const resolver = this.nodeLocalResolver;
 		if (!resolver) return;
 		let stamped = 0;
-		for (const [id, loc] of [...this.locations]) {
+		for (const [id, loc] of Array.from(this.locations)) {
 			if (loc.nodeId) continue;
 			if (resolver(loc.providerId) !== true) continue;
 			const updated = {
@@ -294,7 +294,7 @@ var StorageOrchestratorService = class {
 			this.logger.warn("storage-orchestrator: skipping prune — no location declarations loaded (fail-safe)");
 			return;
 		}
-		for (const [id, loc] of [...this.locations]) {
+		for (const [id, loc] of Array.from(this.locations)) {
 			if (this.registry.cardinalityOf(loc.type) !== null) continue;
 			if (loc.isSystem) {
 				this.locations.delete(id);

package/dist/custom-action-registry-BEXwC-oo.mjs

@@ -0,0 +1,38 @@
+//#region src/kernel/custom-action-registry.ts
+/**
+* CustomActionRegistry — per-process registry of addon custom actions.
+*
+* Populated at boot from each addon's `AddonInitResult.customActions` +
+* `handleCustomAction` handler. Rejects actions declared with scope other
+* than 'system' (today only 'system' is runtime-supported; the descriptor
+* allows future scopes for forward compat).
+*/
+var CustomActionRegistry = class {
+	byAddon = /* @__PURE__ */ new Map();
+	registerAddon(addonId, catalog, handler) {
+		const actions = /* @__PURE__ */ new Map();
+		for (const [name, spec] of Object.entries(catalog)) {
+			const scope = spec.scope ?? { kind: "system" };
+			if (scope.kind !== "system") throw new Error(`custom action '${addonId}.${name}' declared scope '${scope.kind}' — not yet implemented`);
+			actions.set(name, {
+				spec,
+				handler: (input) => handler(name, input)
+			});
+		}
+		this.byAddon.set(addonId, actions);
+	}
+	unregisterAddon(addonId) {
+		this.byAddon.delete(addonId);
+	}
+	resolve(addonId, action) {
+		return this.byAddon.get(addonId)?.get(action) ?? null;
+	}
+	listActions(addonId) {
+		return [...this.byAddon.get(addonId)?.keys() ?? []];
+	}
+	listAddons() {
+		return [...this.byAddon.keys()];
+	}
+};
+//#endregion
+export { CustomActionRegistry as t };

package/dist/custom-action-registry-vLYEFTtv.js

@@ -0,0 +1,43 @@
+//#region src/kernel/custom-action-registry.ts
+/**
+* CustomActionRegistry — per-process registry of addon custom actions.
+*
+* Populated at boot from each addon's `AddonInitResult.customActions` +
+* `handleCustomAction` handler. Rejects actions declared with scope other
+* than 'system' (today only 'system' is runtime-supported; the descriptor
+* allows future scopes for forward compat).
+*/
+var CustomActionRegistry = class {
+	byAddon = /* @__PURE__ */ new Map();
+	registerAddon(addonId, catalog, handler) {
+		const actions = /* @__PURE__ */ new Map();
+		for (const [name, spec] of Object.entries(catalog)) {
+			const scope = spec.scope ?? { kind: "system" };
+			if (scope.kind !== "system") throw new Error(`custom action '${addonId}.${name}' declared scope '${scope.kind}' — not yet implemented`);
+			actions.set(name, {
+				spec,
+				handler: (input) => handler(name, input)
+			});
+		}
+		this.byAddon.set(addonId, actions);
+	}
+	unregisterAddon(addonId) {
+		this.byAddon.delete(addonId);
+	}
+	resolve(addonId, action) {
+		return this.byAddon.get(addonId)?.get(action) ?? null;
+	}
+	listActions(addonId) {
+		return [...this.byAddon.get(addonId)?.keys() ?? []];
+	}
+	listAddons() {
+		return [...this.byAddon.keys()];
+	}
+};
+//#endregion
+Object.defineProperty(exports, "CustomActionRegistry", {
+	enumerable: true,
+	get: function() {
+		return CustomActionRegistry;
+	}
+});