@camstack/core 0.1.15 → 0.1.16

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

@@ -0,0 +1,530 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { BaseAddon, EventCategory, errMsg, platformProbeCapability } from "@camstack/types";
+import * as os from "node:os";
+//#region src/builtins/platform-probe/platform-scorer.ts
+/**
+* Promisified `execFile`. Used across the scorer so every subprocess
+* spawn yields the event loop — critical at boot because a single sync
+* spawn of a missing Python module hits its 30s timeout and freezes the
+* entire Node process (WS handshakes, tRPC subscriptions, metrics — all
+* stalled). Keeping it async turns the probe into a true background task.
+*/
+var execFileAsync = promisify(execFile);
+/** Minimal no-op logger for default parameter */
+var noopLogger = {
+	debug() {},
+	info() {},
+	warn() {},
+	error() {},
+	child() {
+		return noopLogger;
+	},
+	withTags() {
+		return noopLogger;
+	}
+};
+/**
+* Get reliable "available" RAM in MB, cross-platform.
+* os.freemem() is unreliable on macOS (reports ~200MB on a 36GB system).
+* Uses systeminformation when available, falls back to native commands.
+*/
+async function getAvailableRAM_MB() {
+	try {
+		const mem = await (await import("systeminformation")).mem();
+		return Math.round(mem.available / 1024 / 1024);
+	} catch (err) {
+		console.debug(`systeminformation not available, using platform-specific RAM probe: ${errMsg(err)}`);
+		const platform = os.platform();
+		try {
+			if (platform === "darwin") {
+				const { stdout: output } = await execFileAsync("vm_stat", [], {
+					encoding: "utf8",
+					timeout: 3e3
+				});
+				const pageSize = parseInt(output.match(/page size of (\d+)/)?.[1] ?? "16384");
+				const free = parseInt(output.match(/Pages free:\s+(\d+)/)?.[1] ?? "0");
+				const inactive = parseInt(output.match(/Pages inactive:\s+(\d+)/)?.[1] ?? "0");
+				const purgeable = parseInt(output.match(/Pages purgeable:\s+(\d+)/)?.[1] ?? "0");
+				return Math.round((free + inactive + purgeable) * pageSize / 1024 / 1024);
+			} else if (platform === "linux") {
+				const { readFileSync } = await import("node:fs");
+				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)}`);
+		}
+		return Math.round(os.totalmem() / 1024 / 1024);
+	}
+}
+var PlatformScorer = class {
+	cached = null;
+	logger;
+	constructor(logger = noopLogger) {
+		this.logger = logger;
+	}
+	/**
+	* Probe hardware + runtimes 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.
+	*/
+	async probe(onPhase) {
+		if (this.cached) return this.cached;
+		const start = Date.now();
+		onPhase?.("started", {});
+		this.logger.info("Probing hardware...");
+		const hardware = await this.probeHardware();
+		this.logger.info("Hardware detected", { meta: {
+			platform: hardware.platform,
+			arch: hardware.arch,
+			cpuModel: hardware.cpuModel,
+			cpuCores: hardware.cpuCores,
+			ramGB: Math.round(hardware.totalRAM_MB / 1024)
+		} });
+		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 Node.js backends...");
+		const nodeBackends = await this.probeNodeBackends();
+		this.logger.info("Node backends detected", { meta: { backends: nodeBackends.map((b) => b.id) } });
+		onPhase?.("node-backends", { backends: nodeBackends });
+		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)
+		} });
+		else this.logger.info("Python: not found");
+		onPhase?.("python-backends", {
+			pythonPath: pythonInfo.pythonPath,
+			backends: pythonInfo.backends
+		});
+		const scores = this.scoreBackends(hardware, nodeBackends, 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,
+			combos: scores.length
+		} });
+		this.logger.info("Best backend selected", { meta: {
+			runtime: bestScore.runtime,
+			backend: bestScore.backend,
+			format: bestScore.format,
+			reason: bestScore.reason,
+			score: bestScore.score
+		} });
+		for (const s of scores) this.logger.debug("Score entry", { meta: {
+			available: s.available,
+			runtime: s.runtime,
+			backend: s.backend,
+			format: s.format,
+			score: s.score,
+			reason: s.reason
+		} });
+		this.cached = {
+			hardware,
+			scores,
+			bestScore,
+			pythonPath: pythonInfo.pythonPath
+		};
+		onPhase?.("scored", {
+			scores,
+			bestScore,
+			elapsedMs: elapsed
+		});
+		onPhase?.("done", { capabilities: this.cached });
+		return this.cached;
+	}
+	async probeHardware() {
+		const platform = os.platform();
+		const arch = os.arch();
+		const cpus = os.cpus();
+		const cpuModel = cpus[0]?.model ?? "unknown";
+		const cpuCores = cpus.length;
+		const totalRAM_MB = Math.round(os.totalmem() / 1024 / 1024);
+		const availableRAM_MB = await getAvailableRAM_MB();
+		this.logger.debug("RAM probed", { meta: {
+			totalRAM_MB,
+			availableRAM_MB
+		} });
+		let gpu = null;
+		let npu = null;
+		if (platform === "darwin" && arch === "arm64") {
+			gpu = {
+				type: "apple",
+				name: "Apple Silicon GPU"
+			};
+			npu = { type: "apple-ane" };
+		}
+		if (platform === "linux") try {
+			const { stdout } = await execFileAsync("nvidia-smi", ["--query-gpu=name,memory.total", "--format=csv,noheader"], {
+				encoding: "utf8",
+				timeout: 5e3
+			});
+			const output = stdout.trim();
+			if (output) {
+				const [name, mem] = output.split(",").map((s) => s.trim());
+				gpu = {
+					type: "nvidia",
+					name: name ?? "NVIDIA GPU",
+					memoryMB: parseInt(mem ?? "0")
+				};
+			}
+		} catch (err) {
+			this.logger.debug("NVIDIA GPU detection failed", { meta: { error: errMsg(err) } });
+		}
+		return {
+			platform,
+			arch,
+			cpuModel,
+			cpuCores,
+			totalRAM_MB,
+			availableRAM_MB,
+			gpu,
+			npu
+		};
+	}
+	async probeNodeBackends() {
+		const backends = [{
+			id: "cpu",
+			available: true
+		}];
+		try {
+			const providers = (await import("onnxruntime-node")).InferenceSession?.getAvailableProviders?.() ?? [];
+			for (const p of providers) {
+				const n = p.toLowerCase().replace("executionprovider", "");
+				if (n === "coreml") backends.push({
+					id: "coreml",
+					available: true
+				});
+				else if (n === "cuda") backends.push({
+					id: "cuda",
+					available: true
+				});
+				else if (n === "tensorrt") backends.push({
+					id: "tensorrt",
+					available: true
+				});
+			}
+		} catch (err) {
+			this.logger.debug("onnxruntime-node not available", { meta: { error: errMsg(err) } });
+		}
+		if (os.platform() === "darwin" && !backends.some((b) => b.id === "coreml")) backends.push({
+			id: "coreml",
+			available: true
+		});
+		return backends;
+	}
+	async probePythonBackends() {
+		let pythonPath = null;
+		for (const cmd of ["python3", "python"]) try {
+			await execFileAsync(cmd, ["--version"], { timeout: 5e3 });
+			pythonPath = cmd;
+			break;
+		} catch (err) {
+			console.debug(`Python command "${cmd}" not found: ${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(pythonPath, ["-c", `import ${mod}`], { timeout: 3e4 });
+				available = true;
+			} catch (err) {
+				console.debug(`Python module "${mod}" not installed: ${errMsg(err)}`);
+			}
+			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, nodeBackends, 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
+			});
+			const nodeCoreMl = nodeBackends.find((b) => b.id === "coreml");
+			if (nodeCoreMl) scores.push({
+				runtime: "node",
+				backend: "coreml",
+				format: "onnx",
+				score: 90,
+				reason: "CoreML via ONNX Runtime",
+				available: nodeCoreMl.available
+			});
+		}
+		if (hardware.gpu?.type === "nvidia") {
+			if (nodeBackends.find((b) => b.id === "tensorrt")) scores.push({
+				runtime: "node",
+				backend: "tensorrt",
+				format: "onnx",
+				score: 95,
+				reason: "NVIDIA TensorRT",
+				available: true
+			});
+			if (nodeBackends.find((b) => b.id === "cuda")) scores.push({
+				runtime: "node",
+				backend: "cuda",
+				format: "onnx",
+				score: 85,
+				reason: "NVIDIA CUDA",
+				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: "node",
+			backend: "cpu",
+			format: "onnx",
+			score: 50,
+			reason: "CPU (ONNX Runtime Node)",
+			available: true
+		});
+		const pyOnnx = pythonBackends.find((b) => b.id === "onnx-py");
+		if (pyOnnx) scores.push({
+			runtime: "python",
+			backend: "cpu",
+			format: "onnx",
+			score: 45,
+			reason: "CPU (Python ONNX)",
+			available: pyOnnx.available
+		});
+		return scores.sort((a, b) => b.score - a.score);
+	}
+};
+//#endregion
+//#region src/builtins/platform-probe/inference-config-resolver.ts
+var InferenceConfigResolver = class {
+	constructor(scores, hardware) {
+		this.scores = scores;
+		this.hardware = hardware;
+	}
+	/**
+	* Compute accuracy/backend weights based on available system RAM.
+	* availableRAM_MB is now sourced from systeminformation (reliable cross-platform),
+	* not os.freemem() which is broken on macOS.
+	*
+	* - > 16 GB available: prefer larger, more accurate models (accuracy 0.6, backend 0.4)
+	* - > 8 GB available:  balanced (accuracy 0.5, backend 0.5)
+	* - <= 8 GB available: prefer speed (accuracy 0.4, backend 0.6)
+	*/
+	getWeights() {
+		const ramMB = this.hardware.availableRAM_MB;
+		if (ramMB > 16384) return {
+			accuracyWeight: .6,
+			backendWeight: .4
+		};
+		if (ramMB > 8192) return {
+			accuracyWeight: .5,
+			backendWeight: .5
+		};
+		return {
+			accuracyWeight: .4,
+			backendWeight: .6
+		};
+	}
+	/**
+	* Given an addon's model requirements, pick the best model + runtime + backend.
+	*
+	* Algorithm:
+	* 1. Filter models by available RAM (minRAM_MB < 25% of available RAM)
+	* 2. For each remaining model, find the best platform score whose format
+	*    is available in the model's formats
+	* 3. Pick the model with the highest combined score using RAM-adaptive weights:
+	*    - High RAM (>16 GB): accuracy × 0.6 + backend × 0.4  (prefer accuracy)
+	*    - Mid RAM  (>8 GB):  accuracy × 0.5 + backend × 0.5  (balanced)
+	*    - Low RAM  (<=8 GB): accuracy × 0.4 + backend × 0.6  (prefer speed)
+	*/
+	resolve(requirements) {
+		if (requirements.length === 0) return {
+			modelId: "",
+			runtime: "node",
+			backend: "cpu",
+			format: "onnx",
+			reason: "No models declared"
+		};
+		const ramBudget = this.hardware.availableRAM_MB * .25;
+		const { accuracyWeight, backendWeight } = this.getWeights();
+		console.log(`[InferenceConfigResolver] availableRAM: ${this.hardware.availableRAM_MB}MB, budget: ${Math.round(ramBudget)}MB, weights: accuracy=${accuracyWeight}, backend=${backendWeight}`);
+		const fits = requirements.filter((m) => m.minRAM_MB < ramBudget);
+		const candidates = fits.length > 0 ? fits : [requirements[0]];
+		console.log(`[InferenceConfigResolver] ${candidates.length}/${requirements.length} models fit RAM budget`);
+		let bestCombo = null;
+		for (const model of candidates) for (const score of this.scores) {
+			if (!score.available) continue;
+			if (!model.formats.includes(score.format)) continue;
+			const combined = model.accuracyScore * accuracyWeight + score.score * backendWeight;
+			if (!bestCombo || combined > bestCombo.combined) {
+				console.log(`[InferenceConfigResolver] New best: ${model.modelId} (accuracy=${model.accuracyScore}) + ${score.backend}/${score.format} (score=${score.score}) → combined=${Math.round(combined)}`);
+				bestCombo = {
+					model,
+					score,
+					combined
+				};
+			}
+		}
+		if (!bestCombo) return {
+			modelId: candidates[0].modelId,
+			runtime: "node",
+			backend: "cpu",
+			format: "onnx",
+			reason: "No compatible backend — CPU fallback"
+		};
+		return {
+			modelId: bestCombo.model.modelId,
+			runtime: bestCombo.score.runtime,
+			backend: bestCombo.score.backend,
+			format: bestCombo.score.format,
+			reason: `${bestCombo.model.name} on ${bestCombo.score.reason} (score: ${Math.round(bestCombo.combined)})`
+		};
+	}
+};
+//#endregion
+//#region src/builtins/platform-probe/index.ts
+var PlatformProbeNativeAddon = class extends BaseAddon {
+	scorer = null;
+	cachedCaps = null;
+	constructor() {
+		super({});
+	}
+	async onInitialize() {
+		this.scorer = new PlatformScorer(this.ctx.logger);
+		const emitPhase = (phase, payload) => {
+			this.ctx.eventBus?.emit({
+				id: `platform-probe-${phase}-${Date.now()}`,
+				timestamp: /* @__PURE__ */ new Date(),
+				source: {
+					type: "core",
+					id: "platform-probe-native"
+				},
+				category: EventCategory.PlatformProbePhase,
+				data: {
+					type: "platform-probe.phase",
+					phase,
+					...payload ?? {}
+				}
+			});
+		};
+		const probePromise = this.scorer.probe(emitPhase).then((caps) => {
+			this.cachedCaps = caps;
+			this.ctx.logger.info("Platform probe complete", { meta: {
+				cpuModel: caps.hardware.cpuModel,
+				arch: caps.hardware.arch,
+				totalRAM_MB: caps.hardware.totalRAM_MB,
+				gpu: caps.hardware.gpu?.name ?? "none",
+				bestReason: caps.bestScore.reason,
+				bestScore: caps.bestScore.score
+			} });
+			return caps;
+		}).catch((err) => {
+			const msg = errMsg(err);
+			this.ctx.logger.error("Platform probe failed", { meta: { error: msg } });
+			emitPhase("error", { message: msg });
+			throw err;
+		});
+		const getCaps = async () => {
+			return this.cachedCaps ?? probePromise;
+		};
+		return [{
+			capability: platformProbeCapability,
+			provider: {
+				getCapabilities: async () => {
+					return getCaps();
+				},
+				getHardware: async () => {
+					return (await getCaps()).hardware;
+				},
+				resolveInferenceConfig: async (input) => {
+					const caps = await getCaps();
+					return new InferenceConfigResolver(caps.scores, caps.hardware).resolve(input.requirements);
+				},
+				resolveHwAccel: async (input) => {
+					const hwaccel = this.ctx.kernel.hwaccel;
+					if (!hwaccel) return { preferred: [] };
+					return { preferred: (await hwaccel.resolve(input.prefer ?? null)).preferred };
+				}
+			}
+		}];
+	}
+	async onShutdown() {
+		this.scorer = null;
+		this.cachedCaps = null;
+	}
+};
+//#endregion
+export { InferenceConfigResolver, PlatformProbeNativeAddon, PlatformProbeNativeAddon as default, PlatformScorer };
+
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/builtins/platform-probe/platform-scorer.ts","../../../src/builtins/platform-probe/inference-config-resolver.ts","../../../src/builtins/platform-probe/index.ts"],"sourcesContent":["import * as os from 'node:os'\nimport { execFile } from 'node:child_process'\nimport { promisify } from 'node:util'\nimport { errMsg } from '@camstack/types'\nimport type { HardwareInfo, GpuInfo, NpuInfo, PlatformScore, PlatformCapabilities, IScopedLogger } from '@camstack/types'\n\n/**\n * Promisified `execFile`. Used across the scorer so every subprocess\n * spawn yields the event loop — critical at boot because a single sync\n * spawn of a missing Python module hits its 30s timeout and freezes the\n * entire Node process (WS handshakes, tRPC subscriptions, metrics — all\n * stalled). Keeping it async turns the probe into a true background task.\n */\nconst execFileAsync = promisify(execFile)\n\n/** Minimal no-op logger for default parameter */\nconst noopLogger: IScopedLogger = {\n  debug() {},\n  info() {},\n  warn() {},\n  error() {},\n  child() { return noopLogger },\n  withTags() { return noopLogger },\n}\n\n/**\n * Get reliable \"available\" RAM in MB, cross-platform.\n * os.freemem() is unreliable on macOS (reports ~200MB on a 36GB system).\n * Uses systeminformation when available, falls back to native commands.\n */\nasync function getAvailableRAM_MB(): Promise<number> {\n  try {\n    const si = await import('systeminformation')\n    const mem = await si.mem()\n    return Math.round(mem.available / 1024 / 1024)\n  } catch (err) {\n    console.debug(`systeminformation not available, using platform-specific RAM probe: ${errMsg(err)}`)\n    const platform = os.platform()\n    try {\n      if (platform === 'darwin') {\n        // Parse vm_stat: (free + inactive + purgeable) * pageSize\n        const { stdout: output } = await execFileAsync('vm_stat', [], { encoding: 'utf8', timeout: 3000 })\n        const pageSize = parseInt(output.match(/page size of (\\d+)/)?.[1] ?? '16384')\n        const free = parseInt(output.match(/Pages free:\\s+(\\d+)/)?.[1] ?? '0')\n        const inactive = parseInt(output.match(/Pages inactive:\\s+(\\d+)/)?.[1] ?? '0')\n        const purgeable = parseInt(output.match(/Pages purgeable:\\s+(\\d+)/)?.[1] ?? '0')\n        return Math.round((free + inactive + purgeable) * pageSize / 1024 / 1024)\n      } else if (platform === 'linux') {\n        // Parse /proc/meminfo: MemAvailable\n        const { readFileSync } = await import('node:fs')\n        const meminfo = readFileSync('/proc/meminfo', 'utf8')\n        const match = meminfo.match(/MemAvailable:\\s+(\\d+)\\s+kB/)\n        if (match) return Math.round(parseInt(match[1]!) / 1024)\n      }\n    } catch (err) { console.debug(`RAM probe failed, using total RAM fallback: ${errMsg(err)}`) }\n    // Ultimate fallback: total RAM (conservative but safe)\n    return Math.round(os.totalmem() / 1024 / 1024)\n  }\n}\n\nexport class PlatformScorer {\n  private cached: PlatformCapabilities | null = null\n  private readonly logger: IScopedLogger\n\n  constructor(logger: IScopedLogger = noopLogger) {\n    this.logger = logger\n  }\n\n  /**\n   * Probe hardware + runtimes and score all backend combos.\n   *\n   * An optional `onPhase` callback is invoked at each step so consumers\n   * (e.g. the platform-probe addon) can emit live progress events on\n   * the event bus. The callback takes a phase id + a typed payload; all\n   * phases fire in strict order: `started` → `hardware` → `node-backends`\n   * → `python-backends` → `scored` → `done`. On failure, `error` fires\n   * once with the exception. Cached after first call.\n   */\n  async probe(onPhase?: (phase: string, payload?: Record<string, unknown>) => void): Promise<PlatformCapabilities> {\n    if (this.cached) return this.cached\n\n    const start = Date.now()\n    onPhase?.('started', {})\n    this.logger.info('Probing hardware...')\n    const hardware = await this.probeHardware()\n    this.logger.info('Hardware detected', {\n      meta: {\n        platform: hardware.platform,\n        arch: hardware.arch,\n        cpuModel: hardware.cpuModel,\n        cpuCores: hardware.cpuCores,\n        ramGB: Math.round(hardware.totalRAM_MB / 1024),\n      },\n    })\n    if (hardware.gpu) this.logger.info('GPU detected', { meta: { name: hardware.gpu.name } })\n    if (hardware.npu) this.logger.info('NPU detected', { meta: { type: hardware.npu.type } })\n    onPhase?.('hardware', { hardware })\n\n    this.logger.info('Probing Node.js backends...')\n    const nodeBackends = await this.probeNodeBackends()\n    this.logger.info('Node backends detected', { meta: { backends: nodeBackends.map(b => b.id) } })\n    onPhase?.('node-backends', { backends: nodeBackends })\n\n    this.logger.info('Probing Python backends...')\n    const pythonInfo = await this.probePythonBackends()\n    if (pythonInfo.pythonPath) {\n      this.logger.info('Python backends detected', {\n        meta: {\n          pythonPath: pythonInfo.pythonPath,\n          backends: pythonInfo.backends.filter(b => b.available).map(b => b.id),\n        },\n      })\n    } else {\n      this.logger.info('Python: not found')\n    }\n    onPhase?.('python-backends', { pythonPath: pythonInfo.pythonPath, backends: pythonInfo.backends })\n\n    const scores = this.scoreBackends(hardware, nodeBackends, pythonInfo.backends)\n    const bestScore = scores.find(s => s.available) ?? scores[scores.length - 1]!\n\n    const elapsed = Date.now() - start\n    this.logger.info('Scoring complete', { meta: { elapsedMs: elapsed, combos: scores.length } })\n    this.logger.info('Best backend selected', {\n      meta: {\n        runtime: bestScore.runtime,\n        backend: bestScore.backend,\n        format: bestScore.format,\n        reason: bestScore.reason,\n        score: bestScore.score,\n      },\n    })\n    for (const s of scores) {\n      this.logger.debug('Score entry', {\n        meta: {\n          available: s.available,\n          runtime: s.runtime,\n          backend: s.backend,\n          format: s.format,\n          score: s.score,\n          reason: s.reason,\n        },\n      })\n    }\n\n    this.cached = {\n      hardware,\n      scores,\n      bestScore,\n      pythonPath: pythonInfo.pythonPath,\n    }\n    onPhase?.('scored', { scores, bestScore, elapsedMs: elapsed })\n    onPhase?.('done', { capabilities: this.cached })\n    return this.cached\n  }\n\n  async probeHardware(): Promise<HardwareInfo> {\n    const platform = os.platform() as HardwareInfo['platform']\n    const arch = os.arch() as HardwareInfo['arch']\n    const cpus = os.cpus()\n    const cpuModel = cpus[0]?.model ?? 'unknown'\n    const cpuCores = cpus.length\n    const totalRAM_MB = Math.round(os.totalmem() / 1024 / 1024)\n    const availableRAM_MB = await getAvailableRAM_MB()\n    this.logger.debug('RAM probed', { meta: { totalRAM_MB, availableRAM_MB } })\n\n    let gpu: GpuInfo | null = null\n    let npu: NpuInfo | null = null\n\n    // macOS Apple Silicon\n    if (platform === 'darwin' && arch === 'arm64') {\n      gpu = { type: 'apple', name: 'Apple Silicon GPU' }\n      npu = { type: 'apple-ane' }\n    }\n\n    // Linux NVIDIA\n    if (platform === 'linux') {\n      try {\n        const { stdout } = await execFileAsync('nvidia-smi', ['--query-gpu=name,memory.total', '--format=csv,noheader'], {\n          encoding: 'utf8', timeout: 5000,\n        })\n        const output = stdout.trim()\n        if (output) {\n          const [name, mem] = output.split(',').map(s => s.trim())\n          gpu = {\n            type: 'nvidia',\n            name: name ?? 'NVIDIA GPU',\n            memoryMB: parseInt(mem ?? '0'),\n          }\n        }\n      } catch (err) { this.logger.debug('NVIDIA GPU detection failed', { meta: { error: errMsg(err) } }) }\n    }\n\n    return { platform, arch, cpuModel, cpuCores, totalRAM_MB, availableRAM_MB, gpu, npu }\n  }\n\n  private async probeNodeBackends(): Promise<Array<{ id: string; available: boolean }>> {\n    const backends: Array<{ id: string; available: boolean }> = [\n      { id: 'cpu', available: true },\n    ]\n\n    try {\n      const ort = await import('onnxruntime-node') as { InferenceSession?: { getAvailableProviders?: () => string[] } }\n      const providers: string[] = ort.InferenceSession?.getAvailableProviders?.() ?? []\n      for (const p of providers) {\n        const n = p.toLowerCase().replace('executionprovider', '')\n        if (n === 'coreml') backends.push({ id: 'coreml', available: true })\n        else if (n === 'cuda') backends.push({ id: 'cuda', available: true })\n        else if (n === 'tensorrt') backends.push({ id: 'tensorrt', available: true })\n      }\n    } catch (err) { this.logger.debug('onnxruntime-node not available', { meta: { error: errMsg(err) } }) }\n\n    // macOS always has CoreML potential\n    if (os.platform() === 'darwin' && !backends.some(b => b.id === 'coreml')) {\n      backends.push({ id: 'coreml', available: true })\n    }\n\n    return backends\n  }\n\n  private async probePythonBackends(): Promise<{ pythonPath: string | null; backends: Array<{ id: string; format: string; available: boolean }> }> {\n    let pythonPath: string | null = null\n    for (const cmd of ['python3', 'python']) {\n      try {\n        await execFileAsync(cmd, ['--version'], { timeout: 5000 })\n        pythonPath = cmd\n        break\n      } catch (err) { console.debug(`Python command \"${cmd}\" not found: ${errMsg(err)}`) }\n    }\n\n    if (!pythonPath) return { pythonPath: null, backends: [] }\n\n    const checks: Array<[string, string, string]> = [\n      // [pythonModule, backendId, modelFormat]\n      ['coremltools', 'coreml', 'coreml'],\n      ['openvino.runtime', 'openvino', 'openvino'],\n      ['torch', 'pytorch', 'onnx'],\n      ['onnxruntime', 'onnx-py', 'onnx'],\n    ]\n\n    // Run all module probes in parallel. Each probe is independent and a\n    // missing module spends 30s waiting on its own timeout — serial would\n    // add up to ~50s of cumulative wait. Parallel caps it at the slowest\n    // probe. The execFile promise yields the event loop, so WS handshakes\n    // and tRPC calls continue to flow during the wait.\n    const results = await Promise.all(checks.map(async ([mod, id, format]) => {\n      const probeStart = Date.now()\n      let available = false\n      try {\n        await execFileAsync(pythonPath!, ['-c', `import ${mod}`], { timeout: 30000 })\n        available = true\n      } catch (err) { console.debug(`Python module \"${mod}\" not installed: ${errMsg(err)}`) }\n      const probeMs = Date.now() - probeStart\n      this.logger.debug('Python module probed', { meta: { module: mod, available, probeMs } })\n      return { mod, id, format, available }\n    }))\n\n    const backends: Array<{ id: string; format: string; available: boolean }> = []\n    for (const r of results) {\n      // Always show CoreML on macOS even if not installed\n      if (r.id === 'coreml' && os.platform() === 'darwin') {\n        backends.push({ id: r.id, format: r.format, available: r.available })\n      } else if (r.available) {\n        backends.push({ id: r.id, format: r.format, available: r.available })\n      }\n    }\n\n    return { pythonPath, backends }\n  }\n\n  private scoreBackends(\n    hardware: HardwareInfo,\n    nodeBackends: Array<{ id: string; available: boolean }>,\n    pythonBackends: Array<{ id: string; format: string; available: boolean }>,\n  ): PlatformScore[] {\n    const scores: PlatformScore[] = []\n\n    // macOS Apple Silicon\n    if (hardware.platform === 'darwin' && hardware.arch === 'arm64') {\n      const pyCoreMl = pythonBackends.find(b => b.id === 'coreml')\n      if (pyCoreMl) {\n        scores.push({ runtime: 'python', backend: 'coreml', format: 'coreml', score: 95, reason: 'Apple Neural Engine (Python CoreML)', available: pyCoreMl.available })\n      }\n      const nodeCoreMl = nodeBackends.find(b => b.id === 'coreml')\n      if (nodeCoreMl) {\n        scores.push({ runtime: 'node', backend: 'coreml', format: 'onnx', score: 90, reason: 'CoreML via ONNX Runtime', available: nodeCoreMl.available })\n      }\n    }\n\n    // NVIDIA\n    if (hardware.gpu?.type === 'nvidia') {\n      const tensorrt = nodeBackends.find(b => b.id === 'tensorrt')\n      if (tensorrt) scores.push({ runtime: 'node', backend: 'tensorrt', format: 'onnx', score: 95, reason: 'NVIDIA TensorRT', available: true })\n      const cuda = nodeBackends.find(b => b.id === 'cuda')\n      if (cuda) scores.push({ runtime: 'node', backend: 'cuda', format: 'onnx', score: 85, reason: 'NVIDIA CUDA', available: true })\n    }\n\n    // Intel OpenVINO\n    const openvino = pythonBackends.find(b => b.id === 'openvino')\n    if (openvino) {\n      const score = hardware.npu?.type === 'intel-npu' ? 90 : 80\n      scores.push({ runtime: 'python', backend: 'openvino', format: 'openvino', score, reason: 'Intel OpenVINO', available: openvino.available })\n    }\n\n    // CPU fallbacks\n    scores.push({ runtime: 'node', backend: 'cpu', format: 'onnx', score: 50, reason: 'CPU (ONNX Runtime Node)', available: true })\n    const pyOnnx = pythonBackends.find(b => b.id === 'onnx-py')\n    if (pyOnnx) {\n      scores.push({ runtime: 'python', backend: 'cpu', format: 'onnx', score: 45, reason: 'CPU (Python ONNX)', available: pyOnnx.available })\n    }\n\n    return scores.sort((a, b) => b.score - a.score)\n  }\n}\n","import type { PlatformScore, HardwareInfo, ModelRequirement, ResolvedInferenceConfig } from '@camstack/types'\n\nexport class InferenceConfigResolver {\n  constructor(\n    private readonly scores: readonly PlatformScore[],\n    private readonly hardware: HardwareInfo,\n  ) {}\n\n  /**\n   * Compute accuracy/backend weights based on available system RAM.\n   * availableRAM_MB is now sourced from systeminformation (reliable cross-platform),\n   * not os.freemem() which is broken on macOS.\n   *\n   * - > 16 GB available: prefer larger, more accurate models (accuracy 0.6, backend 0.4)\n   * - > 8 GB available:  balanced (accuracy 0.5, backend 0.5)\n   * - <= 8 GB available: prefer speed (accuracy 0.4, backend 0.6)\n   */\n  private getWeights(): { accuracyWeight: number; backendWeight: number } {\n    const ramMB = this.hardware.availableRAM_MB\n    if (ramMB > 16_384) return { accuracyWeight: 0.6, backendWeight: 0.4 }\n    if (ramMB > 8_192) return { accuracyWeight: 0.5, backendWeight: 0.5 }\n    return { accuracyWeight: 0.4, backendWeight: 0.6 }\n  }\n\n  /**\n   * Given an addon's model requirements, pick the best model + runtime + backend.\n   *\n   * Algorithm:\n   * 1. Filter models by available RAM (minRAM_MB < 25% of available RAM)\n   * 2. For each remaining model, find the best platform score whose format\n   *    is available in the model's formats\n   * 3. Pick the model with the highest combined score using RAM-adaptive weights:\n   *    - High RAM (>16 GB): accuracy × 0.6 + backend × 0.4  (prefer accuracy)\n   *    - Mid RAM  (>8 GB):  accuracy × 0.5 + backend × 0.5  (balanced)\n   *    - Low RAM  (<=8 GB): accuracy × 0.4 + backend × 0.6  (prefer speed)\n   */\n  resolve(requirements: readonly ModelRequirement[]): ResolvedInferenceConfig {\n    if (requirements.length === 0) {\n      return { modelId: '', runtime: 'node', backend: 'cpu', format: 'onnx', reason: 'No models declared' }\n    }\n\n    // Budget: 25% of available RAM (now reliable via systeminformation)\n    const ramBudget = this.hardware.availableRAM_MB * 0.25\n    const { accuracyWeight, backendWeight } = this.getWeights()\n\n    console.log(`[InferenceConfigResolver] availableRAM: ${this.hardware.availableRAM_MB}MB, budget: ${Math.round(ramBudget)}MB, weights: accuracy=${accuracyWeight}, backend=${backendWeight}`)\n\n    // Filter models that fit in memory\n    const fits = requirements.filter(m => m.minRAM_MB < ramBudget)\n    const candidates = fits.length > 0 ? fits : [requirements[0]!] // fallback to first/smallest\n\n    console.log(`[InferenceConfigResolver] ${candidates.length}/${requirements.length} models fit RAM budget`)\n\n    // For each model, find best compatible platform score\n    let bestCombo: { model: ModelRequirement; score: PlatformScore; combined: number } | null = null\n\n    for (const model of candidates) {\n      for (const score of this.scores) {\n        if (!score.available) continue\n        if (!model.formats.includes(score.format)) continue\n\n        const combined = model.accuracyScore * accuracyWeight + score.score * backendWeight\n\n        if (!bestCombo || combined > bestCombo.combined) {\n          console.log(`[InferenceConfigResolver] New best: ${model.modelId} (accuracy=${model.accuracyScore}) + ${score.backend}/${score.format} (score=${score.score}) → combined=${Math.round(combined)}`)\n          bestCombo = { model, score, combined }\n        }\n      }\n    }\n\n    if (!bestCombo) {\n      return {\n        modelId: candidates[0]!.modelId,\n        runtime: 'node',\n        backend: 'cpu',\n        format: 'onnx',\n        reason: 'No compatible backend — CPU fallback',\n      }\n    }\n\n    return {\n      modelId: bestCombo.model.modelId,\n      runtime: bestCombo.score.runtime,\n      backend: bestCombo.score.backend,\n      format: bestCombo.score.format,\n      reason: `${bestCombo.model.name} on ${bestCombo.score.reason} (score: ${Math.round(bestCombo.combined)})`,\n    }\n  }\n}\n","/**\n * Platform-probe core builtin.\n *\n * Infra addon — probes hardware + inference runtimes on the local node and\n * exposes the result via the `platform-probe` capability (singleton per\n * node). Promoted from `@camstack/addon-platform-probe-native` (separate\n * npm package) to a core builtin in Phase B of the bundles refactor —\n * lives here because every node already pulls `@camstack/core`, removing\n * a redundant package from REQUIRED_PACKAGES / AGENT_PACKAGES.\n *\n * Inference addons consume the cap via `ctx.api.platformProbe.*`.\n */\nimport type {\n  ProviderRegistration,\n  IPlatformProbeProvider,\n  PlatformCapabilities,\n  HardwareInfo,\n  ModelRequirement,\n  ResolvedInferenceConfig,\n  HwAccelBackend,\n} from '@camstack/types'\nimport { BaseAddon, platformProbeCapability, errMsg, EventCategory } from '@camstack/types'\nimport { PlatformScorer } from './platform-scorer.js'\nimport { InferenceConfigResolver } from './inference-config-resolver.js'\n\nexport { PlatformScorer } from './platform-scorer.js'\nexport { InferenceConfigResolver } from './inference-config-resolver.js'\n\nexport class PlatformProbeNativeAddon extends BaseAddon {\n  private scorer: PlatformScorer | null = null\n  private cachedCaps: PlatformCapabilities | null = null\n\n  constructor() { super({}) }\n\n  protected async onInitialize(): Promise<ProviderRegistration[]> {\n    this.scorer = new PlatformScorer(this.ctx.logger)\n\n    // Kick off the probe in the background — provider methods await the\n    // promise so early consumers block until capabilities are ready.\n    // Each phase emits a `platform-probe.phase` event on the bus so the\n    // benchmark UI (and any other consumer) can render live progress via\n    // `live.onEvent({ category: EventCategory.PlatformProbePhase })`.\n    const emitPhase = (phase: string, payload?: Record<string, unknown>): void => {\n      this.ctx.eventBus?.emit({\n        id: `platform-probe-${phase}-${Date.now()}`,\n        timestamp: new Date(),\n        source: { type: 'core', id: 'platform-probe-native' },\n        category: EventCategory.PlatformProbePhase,\n        data: { type: 'platform-probe.phase', phase, ...(payload ?? {}) },\n      })\n    }\n\n    const probePromise: Promise<PlatformCapabilities> = this.scorer\n      .probe(emitPhase)\n      .then((caps) => {\n        this.cachedCaps = caps\n        this.ctx.logger.info('Platform probe complete', {\n          meta: {\n            cpuModel: caps.hardware.cpuModel,\n            arch: caps.hardware.arch,\n            totalRAM_MB: caps.hardware.totalRAM_MB,\n            gpu: caps.hardware.gpu?.name ?? 'none',\n            bestReason: caps.bestScore.reason,\n            bestScore: caps.bestScore.score,\n          },\n        })\n        return caps\n      })\n      .catch((err: unknown) => {\n        const msg = errMsg(err)\n        this.ctx.logger.error('Platform probe failed', { meta: { error: msg } })\n        emitPhase('error', { message: msg })\n        throw err\n      })\n\n    const getCaps = async (): Promise<PlatformCapabilities> => {\n      return this.cachedCaps ?? probePromise\n    }\n\n    const provider: IPlatformProbeProvider = {\n      getCapabilities: async (): Promise<PlatformCapabilities> => {\n        return getCaps()\n      },\n      getHardware: async (): Promise<HardwareInfo> => {\n        const caps = await getCaps()\n        return caps.hardware\n      },\n      resolveInferenceConfig: async (input: {\n        readonly requirements: readonly ModelRequirement[]\n      }): Promise<ResolvedInferenceConfig> => {\n        const caps = await getCaps()\n        const resolver = new InferenceConfigResolver(caps.scores, caps.hardware)\n        return resolver.resolve(input.requirements)\n      },\n      resolveHwAccel: async (input: {\n        readonly prefer?: string | null\n        readonly nodeId?: string\n      }): Promise<{ preferred: readonly string[] }> => {\n        const hwaccel = this.ctx.kernel.hwaccel\n        if (!hwaccel) {\n          return { preferred: [] }\n        }\n        const res = await hwaccel.resolve((input.prefer as HwAccelBackend | 'none' | null) ?? null)\n        return { preferred: res.preferred }\n      },\n    }\n\n    return [{ capability: platformProbeCapability, provider }]\n  }\n\n  protected async onShutdown(): Promise<void> {\n    this.scorer = null\n    this.cachedCaps = null\n  }\n}\n\nexport default PlatformProbeNativeAddon\n"],"mappings":"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"}

package/dist/builtins/platform-probe/inference-config-resolver.d.ts

@@ -0,0 +1,30 @@
+import { PlatformScore, HardwareInfo, ModelRequirement, ResolvedInferenceConfig } from '@camstack/types';
+export declare class InferenceConfigResolver {
+    private readonly scores;
+    private readonly hardware;
+    constructor(scores: readonly PlatformScore[], hardware: HardwareInfo);
+    /**
+     * Compute accuracy/backend weights based on available system RAM.
+     * availableRAM_MB is now sourced from systeminformation (reliable cross-platform),
+     * not os.freemem() which is broken on macOS.
+     *
+     * - > 16 GB available: prefer larger, more accurate models (accuracy 0.6, backend 0.4)
+     * - > 8 GB available:  balanced (accuracy 0.5, backend 0.5)
+     * - <= 8 GB available: prefer speed (accuracy 0.4, backend 0.6)
+     */
+    private getWeights;
+    /**
+     * Given an addon's model requirements, pick the best model + runtime + backend.
+     *
+     * Algorithm:
+     * 1. Filter models by available RAM (minRAM_MB < 25% of available RAM)
+     * 2. For each remaining model, find the best platform score whose format
+     *    is available in the model's formats
+     * 3. Pick the model with the highest combined score using RAM-adaptive weights:
+     *    - High RAM (>16 GB): accuracy × 0.6 + backend × 0.4  (prefer accuracy)
+     *    - Mid RAM  (>8 GB):  accuracy × 0.5 + backend × 0.5  (balanced)
+     *    - Low RAM  (<=8 GB): accuracy × 0.4 + backend × 0.6  (prefer speed)
+     */
+    resolve(requirements: readonly ModelRequirement[]): ResolvedInferenceConfig;
+}
+//# sourceMappingURL=inference-config-resolver.d.ts.map

package/dist/builtins/platform-probe/inference-config-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inference-config-resolver.d.ts","sourceRoot":"","sources":["../../../src/builtins/platform-probe/inference-config-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AAE7G,qBAAa,uBAAuB;IAEhC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADR,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,QAAQ,EAAE,YAAY;IAGzC;;;;;;;;OAQG;IACH,OAAO,CAAC,UAAU;IAOlB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,YAAY,EAAE,SAAS,gBAAgB,EAAE,GAAG,uBAAuB;CAoD5E"}

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

@@ -0,0 +1,22 @@
+import { HardwareInfo, PlatformCapabilities, IScopedLogger } from '@camstack/types';
+export declare class PlatformScorer {
+    private cached;
+    private readonly logger;
+    constructor(logger?: IScopedLogger);
+    /**
+     * Probe hardware + runtimes 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.
+     */
+    probe(onPhase?: (phase: string, payload?: Record<string, unknown>) => void): Promise<PlatformCapabilities>;
+    probeHardware(): Promise<HardwareInfo>;
+    private probeNodeBackends;
+    private probePythonBackends;
+    private scoreBackends;
+}
+//# sourceMappingURL=platform-scorer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"platform-scorer.d.ts","sourceRoot":"","sources":["../../../src/builtins/platform-probe/platform-scorer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAmC,oBAAoB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAwDzH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,MAAM,GAAE,aAA0B;IAI9C;;;;;;;;;OASG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA6E1G,aAAa,IAAI,OAAO,CAAC,YAAY,CAAC;YAwC9B,iBAAiB;YAwBjB,mBAAmB;IAkDjC,OAAO,CAAC,aAAa;CA2CtB"}

package/dist/builtins/remote-access-orchestrator/index.d.ts

@@ -0,0 +1,2 @@
+export { RemoteAccessOrchestratorAddon, default } from './remote-access-orchestrator.addon.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/builtins/remote-access-orchestrator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builtins/remote-access-orchestrator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAA"}

package/dist/builtins/remote-access-orchestrator/index.js

@@ -0,0 +1,7 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+const require_builtins_remote_access_orchestrator_remote_access_orchestrator_addon = require("./remote-access-orchestrator.addon.js");
+exports.RemoteAccessOrchestratorAddon = require_builtins_remote_access_orchestrator_remote_access_orchestrator_addon.RemoteAccessOrchestratorAddon;
+exports.default = require_builtins_remote_access_orchestrator_remote_access_orchestrator_addon.RemoteAccessOrchestratorAddon;