@camstack/addon-pipeline 1.0.8 → 1.1.0

package/dist/detection-pipeline/index.mjs

@@ -1,11 +1,255 @@
 import { t as __require } from "../chunk-BdkLduGY.mjs";
 import { A as nodePin, B as BaseAddon, C as detectionPipelineCapability, J as hydrateSchema, L as supportedRuntimes$1, P as runtimeDevices$1, T as hfModelUrl, W as EventCategory, Z as parseJsonUnknown, a as COCO_TO_MACRO, et as sleep, i as COCO_80_LABELS, j as pipelineExecutorCapability, p as YAMNET_TO_MACRO, q as createEvent, r as AUDIO_MACRO_LABELS, t as APPLE_SA_TO_MACRO, w as evaluateZoneRules, x as defaultDeviceFor$1, z as errMsg } from "../dist-BA6DR_jV.mjs";
-import { a as isModelDownloaded, i as ensureModel, n as deleteModelFromDisk } from "../model-download-service-C7AjBsX9-B0ekM6dF.mjs";
+import { a as isModelDownloaded, i as ensureModel, n as deleteModelFromDisk } from "../model-download-service-RxAOiYvX-CMAvhgO7.mjs";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";
 import * as os from "node:os";
 import { spawn } from "node:child_process";
 import sharp from "sharp";
+//#region src/detection-pipeline/engine-store-keys.ts
+/**
+* Per-node scoping for the detection-pipeline engine cascade.
+*
+* The detection addon's settings store is a single CLUSTER-SHARED blob (the
+* settings-store cap is hub-resident; every node's detection instance reads and
+* writes the same keys). That is correct for node-agnostic settings (pipeline
+* steps, tuning) but WRONG for the engine cascade — `engineBackend` /
+* `engineDevice` / `probedBestEngine` are hardware-specific, so the hub (NPU)
+* and a remote agent (iGPU, or no accelerator at all) must hold INDEPENDENT
+* selections. Sharing them lets one node's pick (e.g. `openvino/npu`) override
+* another node that has no NPU.
+*
+* These three keys are therefore persisted node-scoped as `<key>@<nodeId>`.
+* Everything else in the store stays shared. A legacy un-scoped value (written
+* before this change, or by an older build) is read as a migration fallback and
+* re-persisted under the node-scoped key on the next write.
+*/
+var ENGINE_CASCADE_KEYS = [
+	"engineBackend",
+	"engineDevice",
+	"probedBestEngine"
+];
+function isEngineCascadeKey(key) {
+	return ENGINE_CASCADE_KEYS.includes(key);
+}
+/**
+* Normalise a raw kernel node id to the bare node id used for scoping.
+* `localNodeId` can carry a `<node>/<addon>` suffix; the engine selection is
+* per-NODE, so strip the addon segment. Falls back to `hub`.
+*/
+function normalizeEngineNodeId(rawNodeId) {
+	const raw = rawNodeId ?? "hub";
+	return raw.includes("/") ? raw.split("/")[0] ?? "hub" : raw;
+}
+/** The node-scoped store key for an engine cascade field. */
+function nodeEngineKey(base, nodeId) {
+	return `${base}@${normalizeEngineNodeId(nodeId)}`;
+}
+/**
+* Read an engine cascade value for a node: the node-scoped key if present,
+* otherwise the legacy un-scoped value (migration), otherwise undefined.
+*/
+function readNodeEngineValue(store, base, nodeId) {
+	const scoped = store[nodeEngineKey(base, nodeId)];
+	return scoped !== void 0 ? scoped : store[base];
+}
+/**
+* Project a raw store onto the plain engine cascade keys for THIS node, so the
+* UI schema (whose field keys are the bare `engineBackend` etc.) hydrates from
+* the node's own selection. Non-engine keys are left untouched. Node-scoped
+* keys for OTHER nodes are dropped from the projection (not relevant to this
+* node's form).
+*/
+function projectNodeEngine(store, nodeId) {
+	const out = {};
+	const scopedForAnyNode = /* @__PURE__ */ new Set();
+	for (const key of Object.keys(store)) {
+		const atIdx = key.indexOf("@");
+		if (isEngineCascadeKey(atIdx >= 0 ? key.slice(0, atIdx) : key)) {
+			scopedForAnyNode.add(key);
+			continue;
+		}
+		out[key] = store[key];
+	}
+	for (const base of ENGINE_CASCADE_KEYS) {
+		const value = readNodeEngineValue(store, base, nodeId);
+		if (value !== void 0) out[base] = value;
+	}
+	return out;
+}
+//#endregion
+//#region src/detection-pipeline/runtimes.ts
+var KNOWN_PLATFORMS = [
+	"darwin",
+	"linux",
+	"win32"
+];
+var KNOWN_ARCHES = ["arm64", "x64"];
+var KNOWN_GPU_TYPES = [
+	"nvidia",
+	"amd",
+	"intel",
+	"apple"
+];
+var KNOWN_NPU_TYPES = ["apple-ane", "intel-npu"];
+function toKnownPlatform(p) {
+	return KNOWN_PLATFORMS.find((v) => v === p) ?? "linux";
+}
+function toKnownArch(a) {
+	return KNOWN_ARCHES.find((v) => v === a) ?? "x64";
+}
+function gpuInfoFrom(hw) {
+	if (!hw.gpu) return null;
+	const type = KNOWN_GPU_TYPES.find((v) => v === hw.gpu?.type);
+	if (!type) return null;
+	return {
+		type,
+		name: ""
+	};
+}
+function npuInfoFrom(hw) {
+	if (!hw.npu) return null;
+	const type = KNOWN_NPU_TYPES.find((v) => v === hw.npu?.type);
+	if (!type) return null;
+	return { type };
+}
+function envToHardwareInfo(env) {
+	if (!env.hardware) return null;
+	return {
+		platform: toKnownPlatform(env.platform),
+		arch: toKnownArch(env.arch),
+		cpuModel: "",
+		cpuCores: 0,
+		totalRAM_MB: 0,
+		availableRAM_MB: 0,
+		gpu: gpuInfoFrom(env.hardware),
+		npu: npuInfoFrom(env.hardware)
+	};
+}
+function probedToHardwareInfo(hw) {
+	if (!hw) return null;
+	return {
+		platform: toKnownPlatform(process.platform),
+		arch: toKnownArch(process.arch),
+		cpuModel: "",
+		cpuCores: 0,
+		totalRAM_MB: 0,
+		availableRAM_MB: 0,
+		gpu: gpuInfoFrom(hw),
+		npu: npuInfoFrom(hw)
+	};
+}
+var RUNTIME_DETAIL = {
+	onnx: {
+		label: "ONNX Runtime",
+		pythonRequirements: ["requirements.txt", "requirements-onnxruntime.txt"],
+		tuning: {
+			concurrency: 4,
+			batchMode: "list",
+			maxBatchSize: 8,
+			intraOpThreads: 0
+		}
+	},
+	openvino: {
+		label: "OpenVINO",
+		pythonRequirements: ["requirements.txt", "requirements-openvino.txt"],
+		tuning: {
+			concurrency: 1,
+			batchMode: "none",
+			numStreams: 0
+		}
+	},
+	coreml: {
+		label: "CoreML",
+		pythonRequirements: ["requirements.txt", "requirements-coreml.txt"],
+		tuning: {
+			concurrency: 1,
+			batchMode: "none",
+			windowMs: 8,
+			maxBatchSize: 8,
+			numWorkers: 1
+		}
+	}
+};
+/**
+* Returns the list of supported runtime IDs for the given hardware env.
+* Delegates to `@camstack/types` `supportedRuntimes`.
+*/
+function supportedRuntimes(env) {
+	return supportedRuntimes$1(envToHardwareInfo(env));
+}
+/**
+* Returns the device options for a given runtime and probed hardware.
+* Delegates to `@camstack/types` `runtimeDevices`.
+*/
+function runtimeDevices(id, hardware) {
+	return runtimeDevices$1(id, probedToHardwareInfo(hardware));
+}
+/**
+* Returns the default device string for a given runtime.
+* Delegates to `@camstack/types` `defaultDeviceFor`.
+*/
+function defaultDeviceFor(id) {
+	return defaultDeviceFor$1(id);
+}
+/** Model format for each inference runtime supported by the detection pipeline. */
+var RUNTIME_FORMAT = {
+	onnx: "onnx",
+	openvino: "openvino",
+	coreml: "coreml"
+};
+/**
+* Returns the model format required for a given runtime.
+* Returns the locally-typed format string ('onnx' | 'openvino' | 'coreml')
+* matching the engine-provisioner's own ModelFormat type.
+*/
+function modelFormatFor(id) {
+	return RUNTIME_FORMAT[id];
+}
+function pythonRequirementsFor(id) {
+	return RUNTIME_DETAIL[id].pythonRequirements;
+}
+function tuningFor(id) {
+	return RUNTIME_DETAIL[id].tuning;
+}
+function runtimeLabel(id) {
+	return RUNTIME_DETAIL[id].label;
+}
+/**
+* Proactive-install hint kept for back-compat (re-exported from index.ts).
+* Intel on Linux warrants installing openvino; coremltools covers macOS;
+* openvino has no AMD/NVIDIA backend.
+*/
+function shouldInstallOpenvino(env) {
+	if (env.platform === "darwin") return false;
+	return env.gpu?.type === "intel" || env.npu?.type === "intel-npu";
+}
+//#endregion
+//#region src/detection-pipeline/auto-pick.ts
+var PREFERENCE = [
+	"coreml",
+	"openvino",
+	"onnx"
+];
+/**
+* Pure function — picks the best supported runtime for the given hardware env.
+*
+* Logic:
+* 1. If `bestBackendHint` is in the supported set, use it.
+* 2. Otherwise, walk PREFERENCE order and pick the first supported runtime.
+* 3. Floor to `'onnx'` (always supported).
+*
+* Device is always `defaultDeviceFor(chosen)`.
+*/
+function pickBestRuntime(env, bestBackendHint) {
+	const supported = supportedRuntimes(env);
+	const chosen = supported.find((id) => id === bestBackendHint) ?? PREFERENCE.find((id) => supported.includes(id)) ?? "onnx";
+	return {
+		runtimeId: chosen,
+		device: defaultDeviceFor(chosen)
+	};
+}
+//#endregion
 //#region src/detection-pipeline/engine/shared-inference-pool.ts
 var MSG_COMMAND = 0;
 var MSG_INFER_JPEG = 1;
@@ -772,6 +1016,26 @@ var HF_REPO = "camstack/camstack-models";
 var HF_SCRYPTED = "scrypted/plugin-models";
 var hf = (path) => hfModelUrl(HF_REPO, path);
 var hfScrypted = (path) => hfModelUrl(HF_SCRYPTED, path);
+/**
+* Build an OpenVINO format entry (always python runtime).
+*
+* OpenVINO IR is a two-file bundle: a `.xml` topology + a sibling `.bin`
+* weights file with the same basename. We declare the `.bin` in `files` so
+* the (format-agnostic) downloader fetches it alongside the `.xml` — without
+* the weights, OpenVINO compile fails with "Empty weights data in bin file".
+* A plain `.onnx` run through the OpenVINO runtime (e.g. yamnet) has no
+* sibling, so none is added.
+*/
+var ovFormat = (url, sizeMB) => {
+	const base = url.split("/").pop() ?? "";
+	const files = base.endsWith(".xml") ? [base.replace(/\.xml$/, ".bin")] : void 0;
+	return {
+		url,
+		sizeMB,
+		runtimes: ["python"],
+		...files ? { files } : {}
+	};
+};
 var MLPACKAGE_FILES = [
 	"Manifest.json",
 	"Data/com.apple.CoreML/model.mlmodel",
@@ -800,11 +1064,7 @@ var OBJECT_DETECTION_MODELS = [
 				files: [...MLPACKAGE_FILES],
 				runtimes: ["python"]
 			},
-			openvino: {
-				url: hf("objectDetection/yolov9/openvino/camstack-yolov9t.xml"),
-				sizeMB: 6,
-				runtimes: ["python"]
-			}
+			openvino: ovFormat(hf("objectDetection/yolov9/openvino/camstack-yolov9t.xml"), 6)
 		}
 	},
 	{
@@ -829,11 +1089,7 @@ var OBJECT_DETECTION_MODELS = [
 				files: [...MLPACKAGE_FILES],
 				runtimes: ["python"]
 			},
-			openvino: {
-				url: hf("objectDetection/yolov9/openvino/camstack-yolov9s.xml"),
-				sizeMB: 16,
-				runtimes: ["python"]
-			}
+			openvino: ovFormat(hf("objectDetection/yolov9/openvino/camstack-yolov9s.xml"), 16)
 		}
 	},
 	{
@@ -858,11 +1114,7 @@ var OBJECT_DETECTION_MODELS = [
 				files: [...MLPACKAGE_FILES],
 				runtimes: ["python"]
 			},
-			openvino: {
-				url: hf("objectDetection/yolov9/openvino/camstack-yolov9c.xml"),
-				sizeMB: 49,
-				runtimes: ["python"]
-			}
+			openvino: ovFormat(hf("objectDetection/yolov9/openvino/camstack-yolov9c.xml"), 49)
 		}
 	},
 	{
@@ -887,11 +1139,7 @@ var OBJECT_DETECTION_MODELS = [
 				files: [...MLPACKAGE_FILES],
 				runtimes: ["python"]
 			},
-			openvino: {
-				url: hf("objectDetection/yolo26/openvino/camstack-yolo26n.xml"),
-				sizeMB: 9,
-				runtimes: ["python"]
-			}
+			openvino: ovFormat(hf("objectDetection/yolo26/openvino/camstack-yolo26n.xml"), 9)
 		}
 	},
 	{
@@ -916,11 +1164,7 @@ var OBJECT_DETECTION_MODELS = [
 				files: [...MLPACKAGE_FILES],
 				runtimes: ["python"]
 			},
-			openvino: {
-				url: hf("objectDetection/yolo26/openvino/camstack-yolo26s.xml"),
-				sizeMB: 36,
-				runtimes: ["python"]
-			}
+			openvino: ovFormat(hf("objectDetection/yolo26/openvino/camstack-yolo26s.xml"), 36)
 		}
 	},
 	{
@@ -945,11 +1189,7 @@ var OBJECT_DETECTION_MODELS = [
 				files: [...MLPACKAGE_FILES],
 				runtimes: ["python"]
 			},
-			openvino: {
-				url: hf("objectDetection/yolo26/openvino/camstack-yolo26m.xml"),
-				sizeMB: 78,
-				runtimes: ["python"]
-			}
+			openvino: ovFormat(hf("objectDetection/yolo26/openvino/camstack-yolo26m.xml"), 78)
 		}
 	},
 	{
@@ -974,11 +1214,7 @@ var OBJECT_DETECTION_MODELS = [
 				files: [...MLPACKAGE_FILES],
 				runtimes: ["python"]
 			},
-			openvino: {
-				url: hf("objectDetection/yolo26/openvino/camstack-yolo26l.xml"),
-				sizeMB: 95,
-				runtimes: ["python"]
-			}
+			openvino: ovFormat(hf("objectDetection/yolo26/openvino/camstack-yolo26l.xml"), 95)
 		}
 	},
 	{
@@ -1003,11 +1239,7 @@ var OBJECT_DETECTION_MODELS = [
 				files: [...MLPACKAGE_FILES],
 				runtimes: ["python"]
 			},
-			openvino: {
-				url: hf("objectDetection/yolo26/openvino/camstack-yolo26x.xml"),
-				sizeMB: 213,
-				runtimes: ["python"]
-			}
+			openvino: ovFormat(hf("objectDetection/yolo26/openvino/camstack-yolo26x.xml"), 213)
 		}
 	},
 	{
@@ -1032,11 +1264,7 @@ var OBJECT_DETECTION_MODELS = [
 				files: [...MLPACKAGE_FILES],
 				runtimes: ["python"]
 			},
-			openvino: {
-				url: hfScrypted("openvino/scrypted_yolov9t_relu/best.xml"),
-				sizeMB: 6,
-				runtimes: ["python"]
-			}
+			openvino: ovFormat(hf("objectDetection/scrypted-yolov9-relu/openvino/scrypted_yolov9t_relu.xml"), 6)
 		}
 	},
 	{
@@ -1061,11 +1289,7 @@ var OBJECT_DETECTION_MODELS = [
 				files: [...MLPACKAGE_FILES],
 				runtimes: ["python"]
 			},
-			openvino: {
-				url: hfScrypted("openvino/scrypted_yolov9s_relu/best.xml"),
-				sizeMB: 16,
-				runtimes: ["python"]
-			}
+			openvino: ovFormat(hf("objectDetection/scrypted-yolov9-relu/openvino/scrypted_yolov9s_relu.xml"), 16)
 		}
 	},
 	{
@@ -1090,11 +1314,7 @@ var OBJECT_DETECTION_MODELS = [
 				files: [...MLPACKAGE_FILES],
 				runtimes: ["python"]
 			},
-			openvino: {
-				url: hfScrypted("openvino/scrypted_yolov9c_relu/best.xml"),
-				sizeMB: 49,
-				runtimes: ["python"]
-			}
+			openvino: ovFormat(hf("objectDetection/scrypted-yolov9-relu/openvino/scrypted_yolov9c_relu.xml"), 49)
 		}
 	},
 	{
@@ -1119,11 +1339,7 @@ var OBJECT_DETECTION_MODELS = [
 				files: [...MLPACKAGE_FILES],
 				runtimes: ["python"]
 			},
-			openvino: {
-				url: hfScrypted("openvino/scrypted_yolov9m_relu/best.xml"),
-				sizeMB: 38,
-				runtimes: ["python"]
-			}
+			openvino: ovFormat(hf("objectDetection/scrypted-yolov9-relu/openvino/scrypted_yolov9m_relu.xml"), 38)
 		}
 	}
 ];
@@ -1152,11 +1368,7 @@ var FACE_DETECTION_MODELS = [{
 			files: [...MLPACKAGE_FILES],
 			runtimes: ["python"]
 		},
-		openvino: {
-			url: hf("faceDetection/scrfd/openvino/camstack-scrfd-2.5g.xml"),
-			sizeMB: 1.8,
-			runtimes: ["python"]
-		}
+		openvino: ovFormat(hf("faceDetection/scrfd/openvino/camstack-scrfd-2.5g.xml"), 1.8)
 	}
 }, {
 	id: "scrypted-yolov9t-face",
@@ -1183,11 +1395,7 @@ var FACE_DETECTION_MODELS = [{
 			files: [...MLPACKAGE_FILES],
 			runtimes: ["python"]
 		},
-		openvino: {
-			url: hfScrypted("openvino/scrypted_yolov9t_relu_face/best.xml"),
-			sizeMB: 6,
-			runtimes: ["python"]
-		}
+		openvino: ovFormat(hf("faceDetection/scrypted-yolov9-face/openvino/scrypted_yolov9t_relu_face.xml"), 6)
 	}
 }];
 var FACE_EMBEDDING_MODELS = [{
@@ -1217,11 +1425,7 @@ var FACE_EMBEDDING_MODELS = [{
 			files: [...MLPACKAGE_FILES],
 			runtimes: ["python"]
 		},
-		openvino: {
-			url: hf("faceRecognition/arcface/openvino/camstack-arcface-r100.xml"),
-			sizeMB: 65,
-			runtimes: ["python"]
-		}
+		openvino: ovFormat(hf("faceRecognition/arcface/openvino/camstack-arcface-r100.xml"), 65)
 	}
 }, {
 	id: "inception-resnet-v1",
@@ -1248,11 +1452,7 @@ var FACE_EMBEDDING_MODELS = [{
 			files: [...MLPACKAGE_FILES],
 			runtimes: ["python"]
 		},
-		openvino: {
-			url: hfScrypted("openvino/inception_resnet_v1/best.xml"),
-			sizeMB: 45,
-			runtimes: ["python"]
-		}
+		openvino: ovFormat(hf("faceRecognition/inception-resnet-v1/openvino/camstack-inception-resnet-v1.xml"), 45)
 	}
 }];
 var PLATE_DETECTION_MODELS = [{
@@ -1280,11 +1480,7 @@ var PLATE_DETECTION_MODELS = [{
 			files: [...MLPACKAGE_FILES],
 			runtimes: ["python"]
 		},
-		openvino: {
-			url: hf("plateDetection/yolov8-plate/openvino/camstack-yolov8n-plate.xml"),
-			sizeMB: 6.1,
-			runtimes: ["python"]
-		}
+		openvino: ovFormat(hf("plateDetection/yolov8-plate/openvino/camstack-yolov8n-plate.xml"), 6.1)
 	}
 }];
 var PLATE_OCR_MODELS = [{
@@ -1312,11 +1508,7 @@ var PLATE_OCR_MODELS = [{
 			files: [...MLPACKAGE_FILES],
 			runtimes: ["python"]
 		},
-		openvino: {
-			url: hfScrypted("openvino/vgg_english_g2/best.xml"),
-			sizeMB: 7.2,
-			runtimes: ["python"]
-		}
+		openvino: ovFormat(hf("plateRecognition/vgg_english_g2/openvino/vgg_english_g2.xml"), 7.2)
 	}
 }];
 var ANIMAL_CLASSIFIER_MODELS = [{
@@ -1345,11 +1537,7 @@ var ANIMAL_CLASSIFIER_MODELS = [{
 			files: [...MLPACKAGE_FILES],
 			runtimes: ["python"]
 		},
-		openvino: {
-			url: hf("animalClassification/animals-10/openvino/camstack-animals-10.xml"),
-			sizeMB: 164,
-			runtimes: ["python"]
-		}
+		openvino: ovFormat(hf("animalClassification/animals-10/openvino/camstack-animals-10.xml"), 164)
 	}
 }];
 var BIRD_CLASSIFIER_MODELS = [{
@@ -1378,11 +1566,7 @@ var BIRD_CLASSIFIER_MODELS = [{
 			files: [...MLPACKAGE_FILES],
 			runtimes: ["python"]
 		},
-		openvino: {
-			url: hf("animalClassification/bird-nabirds/openvino/camstack-bird-nabirds-404.xml"),
-			sizeMB: 47,
-			runtimes: ["python"]
-		}
+		openvino: ovFormat(hf("animalClassification/bird-nabirds/openvino/camstack-bird-nabirds-404.xml"), 47)
 	},
 	extraFiles: [{
 		url: hf("animalClassification/bird-nabirds/onnx/camstack-bird-nabirds-404-labels.json"),
@@ -1416,11 +1600,7 @@ var VEHICLE_CLASSIFIER_MODELS = [{
 			files: [...MLPACKAGE_FILES],
 			runtimes: ["python"]
 		},
-		openvino: {
-			url: hf("vehicleClassification/efficientnet/openvino/camstack-vehicle-type-efficientnet.xml"),
-			sizeMB: 68,
-			runtimes: ["python"]
-		}
+		openvino: ovFormat(hf("vehicleClassification/efficientnet/openvino/camstack-vehicle-type-efficientnet.xml"), 68)
 	},
 	extraFiles: [{
 		url: hf("vehicleClassification/efficientnet/camstack-vehicle-type-labels.json"),
@@ -1453,11 +1633,7 @@ var SEGMENTATION_REFINER_MODELS = [{
 			files: [...MLPACKAGE_FILES],
 			runtimes: ["python"]
 		},
-		openvino: {
-			url: hf("segmentationRefiner/u2netp/openvino/camstack-u2netp.xml"),
-			sizeMB: 2.5,
-			runtimes: ["python"]
-		}
+		openvino: ovFormat(hf("segmentationRefiner/u2netp/openvino/camstack-u2netp.xml"), 2.5)
 	}
 }];
 var INSTANCE_SEGMENTATION_MODELS = [
@@ -1483,11 +1659,7 @@ var INSTANCE_SEGMENTATION_MODELS = [
 				files: [...MLPACKAGE_FILES],
 				runtimes: ["python"]
 			},
-			openvino: {
-				url: hf("segmentation/yolo26-seg/openvino/camstack-yolo26n-seg.xml"),
-				sizeMB: 11,
-				runtimes: ["python"]
-			}
+			openvino: ovFormat(hf("segmentation/yolo26-seg/openvino/camstack-yolo26n-seg.xml"), 11)
 		}
 	},
 	{
@@ -1512,11 +1684,7 @@ var INSTANCE_SEGMENTATION_MODELS = [
 				files: [...MLPACKAGE_FILES],
 				runtimes: ["python"]
 			},
-			openvino: {
-				url: hf("segmentation/yolo26-seg/openvino/camstack-yolo26s-seg.xml"),
-				sizeMB: 40,
-				runtimes: ["python"]
-			}
+			openvino: ovFormat(hf("segmentation/yolo26-seg/openvino/camstack-yolo26s-seg.xml"), 40)
 		}
 	},
 	{
@@ -1541,11 +1709,7 @@ var INSTANCE_SEGMENTATION_MODELS = [
 				files: [...MLPACKAGE_FILES],
 				runtimes: ["python"]
 			},
-			openvino: {
-				url: hf("segmentation/yolo26-seg/openvino/camstack-yolo26m-seg.xml"),
-				sizeMB: 90,
-				runtimes: ["python"]
-			}
+			openvino: ovFormat(hf("segmentation/yolo26-seg/openvino/camstack-yolo26m-seg.xml"), 90)
 		}
 	}
 ];
@@ -1561,16 +1725,12 @@ var AUDIO_CLASSIFIER_MODELS = [{
 	preprocessMode: "resize",
 	formats: {
 		onnx: {
-			url: hf("audioClassifier/yamnet/onnx/camstack-yamnet.onnx"),
+			url: hf("audioClassification/yamnet/onnx/camstack-yamnet.onnx"),
 			sizeMB: 3.2
 		},
-		openvino: {
-			url: hf("audioClassifier/yamnet/onnx/camstack-yamnet.onnx"),
-			sizeMB: 3.2,
-			runtimes: ["python"]
-		},
+		openvino: ovFormat(hf("audioClassification/yamnet/openvino/camstack-yamnet.xml"), 3.2),
 		coreml: {
-			url: hf("audioClassifier/yamnet/onnx/camstack-yamnet.onnx"),
+			url: hf("audioClassification/yamnet/onnx/camstack-yamnet.onnx"),
 			sizeMB: 3.2,
 			runtimes: ["python"]
 		}
@@ -2158,77 +2318,108 @@ var EngineFactory = class {
 	}
 };
 //#endregion
-//#region src/detection-pipeline/engine-store-keys.ts
-/**
-* Per-node scoping for the detection-pipeline engine cascade.
-*
-* The detection addon's settings store is a single CLUSTER-SHARED blob (the
-* settings-store cap is hub-resident; every node's detection instance reads and
-* writes the same keys). That is correct for node-agnostic settings (pipeline
-* steps, tuning) but WRONG for the engine cascade — `engineBackend` /
-* `engineDevice` / `probedBestEngine` are hardware-specific, so the hub (NPU)
-* and a remote agent (iGPU, or no accelerator at all) must hold INDEPENDENT
-* selections. Sharing them lets one node's pick (e.g. `openvino/npu`) override
-* another node that has no NPU.
-*
-* These three keys are therefore persisted node-scoped as `<key>@<nodeId>`.
-* Everything else in the store stays shared. A legacy un-scoped value (written
-* before this change, or by an older build) is read as a migration fallback and
-* re-persisted under the node-scoped key on the next write.
-*/
-var ENGINE_CASCADE_KEYS = [
-	"engineBackend",
-	"engineDevice",
-	"probedBestEngine"
+//#region src/detection-pipeline/engine-provisioner.ts
+/** Incremental backoff growing to a ~5 min cap; retries indefinitely at cap. */
+var BACKOFF_SCHEDULE_MS = [
+	5e3,
+	15e3,
+	3e4,
+	6e4,
+	12e4,
+	3e5
 ];
-function isEngineCascadeKey(key) {
-	return ENGINE_CASCADE_KEYS.includes(key);
-}
-/**
-* Normalise a raw kernel node id to the bare node id used for scoping.
-* `localNodeId` can carry a `<node>/<addon>` suffix; the engine selection is
-* per-NODE, so strip the addon segment. Falls back to `hub`.
-*/
-function normalizeEngineNodeId(rawNodeId) {
-	const raw = rawNodeId ?? "hub";
-	return raw.includes("/") ? raw.split("/")[0] ?? "hub" : raw;
-}
-/** The node-scoped store key for an engine cascade field. */
-function nodeEngineKey(base, nodeId) {
-	return `${base}@${normalizeEngineNodeId(nodeId)}`;
-}
-/**
-* Read an engine cascade value for a node: the node-scoped key if present,
-* otherwise the legacy un-scoped value (migration), otherwise undefined.
-*/
-function readNodeEngineValue(store, base, nodeId) {
-	const scoped = store[nodeEngineKey(base, nodeId)];
-	return scoped !== void 0 ? scoped : store[base];
-}
-/**
-* Project a raw store onto the plain engine cascade keys for THIS node, so the
-* UI schema (whose field keys are the bare `engineBackend` etc.) hydrates from
-* the node's own selection. Non-engine keys are left untouched. Node-scoped
-* keys for OTHER nodes are dropped from the projection (not relevant to this
-* node's form).
-*/
-function projectNodeEngine(store, nodeId) {
-	const out = {};
-	const scopedForAnyNode = /* @__PURE__ */ new Set();
-	for (const key of Object.keys(store)) {
-		const atIdx = key.indexOf("@");
-		if (isEngineCascadeKey(atIdx >= 0 ? key.slice(0, atIdx) : key)) {
-			scopedForAnyNode.add(key);
-			continue;
+var IDLE_STATE = {
+	runtimeId: null,
+	device: null,
+	state: "idle"
+};
+var EngineProvisioner = class {
+	fx;
+	current = IDLE_STATE;
+	/** Bumped on every select/dispose — stale async results (old generation) are ignored. */
+	generation = 0;
+	cancelTimer = null;
+	retryIndex = 0;
+	constructor(fx) {
+		this.fx = fx;
+	}
+	get state() {
+		return this.current;
+	}
+	isReady() {
+		return this.current.state === "ready";
+	}
+	select(runtimeId, device) {
+		this.generation++;
+		this.retryIndex = 0;
+		this.clearTimer();
+		this.transition({
+			runtimeId,
+			device,
+			state: "installing",
+			progress: 0
+		});
+		this.provision(this.generation, runtimeId, device);
+	}
+	dispose() {
+		this.generation++;
+		this.clearTimer();
+	}
+	clearTimer() {
+		if (this.cancelTimer !== null) {
+			this.cancelTimer();
+			this.cancelTimer = null;
 		}
-		out[key] = store[key];
 	}
-	for (const base of ENGINE_CASCADE_KEYS) {
-		const value = readNodeEngineValue(store, base, nodeId);
-		if (value !== void 0) out[base] = value;
+	transition(next) {
+		this.current = next;
+		this.fx.onChange(next);
 	}
-	return out;
-}
+	async provision(gen, runtimeId, device) {
+		try {
+			await Promise.all([this.fx.installRequirements(this.fx.requirementsFor(runtimeId)), this.fx.ensureModelForFormat(this.fx.modelFormatFor(runtimeId))]);
+			if (gen !== this.generation) return;
+			this.transition({
+				runtimeId,
+				device,
+				state: "verifying",
+				progress: 100
+			});
+			await this.fx.verify(runtimeId, device);
+			if (gen !== this.generation) return;
+			this.retryIndex = 0;
+			this.transition({
+				runtimeId,
+				device,
+				state: "ready"
+			});
+		} catch (err) {
+			if (gen !== this.generation) return;
+			const message = err instanceof Error ? err.message : String(err);
+			const delay = BACKOFF_SCHEDULE_MS[Math.min(this.retryIndex, BACKOFF_SCHEDULE_MS.length - 1)];
+			this.retryIndex++;
+			const nextRetryAt = this.fx.now() + delay;
+			this.transition({
+				runtimeId,
+				device,
+				state: "failed",
+				error: message,
+				nextRetryAt
+			});
+			this.cancelTimer = this.fx.setTimer(delay, () => {
+				if (gen !== this.generation) return;
+				this.cancelTimer = null;
+				this.transition({
+					runtimeId,
+					device,
+					state: "installing",
+					progress: 0
+				});
+				this.provision(gen, runtimeId, device);
+			});
+		}
+	}
+};
 //#endregion
 //#region src/detection-pipeline/postprocess/dispatch.ts
 var VALID_KINDS = new Set([
@@ -3416,463 +3607,188 @@ var PipelineExecutor = class {
 				inferenceMs: Date.now() - inferenceStart,
 				postprocessMs: 0,
 				inputType,
-				inputWidth,
-				inputHeight,
-				parentDetection: parentClass,
-				output: errorOutput,
-				error: errorMsg
-			});
-			stepTimings.push({
-				source: step.stepId,
-				modelId: step.modelId,
-				ms: Date.now() - preprocessStart,
-				detectionCount: 0
-			});
-			throw new Error(`Inference failed for step "${step.stepId}": ${errorMsg}`, { cause: err });
-		}
-		const structured = engineOutput.structured ?? {};
-		const inferenceMs = typeof structured.inferenceMs === "number" ? structured.inferenceMs : Date.now() - inferenceStart;
-		if (typeof structured.preprocessMs === "number") poolAgg.preprocessMs += structured.preprocessMs;
-		if (typeof structured.predictMs === "number") poolAgg.predictMs += structured.predictMs;
-		if (typeof structured.batchSize === "number" && structured.batchSize > poolAgg.batchSize) poolAgg.batchSize = structured.batchSize;
-		const postprocessStart = Date.now();
-		const output = dispatchPostprocess(engineOutput, step.definition);
-		const postprocessMs = Date.now() - postprocessStart;
-		stepTimings.push({
-			source: step.stepId,
-			modelId: step.modelId,
-			ms: preprocessMs + inferenceMs + postprocessMs,
-			detectionCount: output.kind === "detections" ? output.detections.length : 0
-		});
-		if (traceBuilder.isActive) traceBuilder.addStep({
-			stepId: step.stepId,
-			modelId: step.modelId,
-			slot: step.definition.slot,
-			postprocessor: step.definition.postprocessor,
-			preprocessMs,
-			inferenceMs,
-			postprocessMs,
-			inputType,
-			inputWidth,
-			inputHeight,
-			parentDetection: parentClass,
-			output
-		});
-		return output;
-	}
-	async executeChildren(children, parentDetection, fullFrameJpegProvider, imageWidth, imageHeight, traceBuilder, stepTimings, ctx, poolAgg) {
-		for (const child of children) {
-			if (!this.matchesInputClasses(parentDetection.macroClass, child.inputClasses)) continue;
-			const minParentScore = child.settings?.minParentScore ?? child.definition?.defaultMinParentScore;
-			if (typeof minParentScore === "number" && parentDetection.score < minParentScore) continue;
-			if (isBboxDegenerate(parentDetection.bbox)) continue;
-			try {
-				const childStart = Date.now();
-				const fullFrameJpeg = await fullFrameJpegProvider();
-				const modelEntry = child.definition.models.find((m) => m.id === child.modelId);
-				let cropJpegBuf;
-				let cropW;
-				let cropH;
-				if (modelEntry?.faceAlignment) {
-					const minFaceSize = typeof child.settings?.["minFaceSize"] === "number" ? child.settings["minFaceSize"] : DEFAULT_MIN_FACE_SIZE_PX;
-					if (bboxShortSide(parentDetection.bbox) < minFaceSize) continue;
-					const lms = parentDetection.landmarks;
-					if (lms && lms.length >= 5) {
-						const aligned = await alignFaceCrop(fullFrameJpeg, parentDetection.bbox, lms, imageWidth, imageHeight, { outSize: modelEntry.inputSize.width });
-						cropJpegBuf = aligned.jpeg;
-						cropW = aligned.width;
-						cropH = aligned.height;
-					} else {
-						const crop = await cropJpeg(fullFrameJpeg, parentDetection.bbox, imageWidth, imageHeight);
-						cropJpegBuf = crop.jpeg;
-						cropW = crop.width;
-						cropH = crop.height;
-					}
-				} else {
-					const crop = await cropJpeg(fullFrameJpeg, parentDetection.bbox, imageWidth, imageHeight);
-					cropJpegBuf = crop.jpeg;
-					cropW = crop.width;
-					cropH = crop.height;
-				}
-				const childOutput = await this.executeStep(child, {
-					kind: "jpeg",
-					data: cropJpegBuf
-				}, cropW, cropH, "crop-roi", parentDetection.bbox, parentDetection.macroClass, traceBuilder, stepTimings, poolAgg);
-				const childMs = Date.now() - childStart;
-				const detailsBefore = ctx.details.length;
-				applyChildOutput(parentDetection, child, childOutput, childMs, ctx);
-				if (childOutput.kind === "detections" && child.children.length > 0) {
-					const newDetails = ctx.details.slice(detailsBefore);
-					for (const detail of newDetails) {
-						detail.bbox = transformBboxToImageSpace(detail.bbox, parentDetection.bbox);
-						if (detail.landmarks) {
-							const [px1, py1] = parentDetection.bbox;
-							detail.landmarks = detail.landmarks.map((l) => ({
-								x: l.x + px1,
-								y: l.y + py1
-							}));
-						}
-						await this.executeChildren(child.children, detail, fullFrameJpegProvider, imageWidth, imageHeight, traceBuilder, stepTimings, ctx, poolAgg);
-					}
-				}
-			} catch {}
-		}
-	}
-	matchesInputClasses(className, inputClasses) {
-		if (inputClasses.length === 0) return true;
-		return inputClasses.includes(className);
-	}
-	/**
-	* Apply the object-detection step's macro filter + per-macro
-	* minConfidence sliders introduced in the Phase 6 step rework.
-	*
-	* Expected `settings` shape:
-	*   - `enabledMacroClasses`: readonly string[] (e.g. ['person','vehicle','animal']).
-	*     Empty array = all allowed (legacy behaviour).
-	*   - `minConfidence<Macro>`: number (e.g. `minConfidencePerson: 0.5`)
-	*/
-	matchesMacroFilter(macroClass, score, settings) {
-		if (!settings) return true;
-		const enabled = settings["enabledMacroClasses"];
-		if (Array.isArray(enabled) && enabled.length > 0) {
-			if (!enabled.includes(macroClass)) return false;
-		}
-		const perMacroThreshold = settings[`minConfidence${capitalize(macroClass)}`];
-		if (typeof perMacroThreshold === "number" && score < perMacroThreshold) return false;
-		return true;
-	}
-};
-function capitalize(s) {
-	if (s.length === 0) return s;
-	return s.charAt(0).toUpperCase() + s.slice(1);
-}
-//#endregion
-//#region src/detection-pipeline/pipeline/tree-builder.ts
-/**
-* Build an executable tree from user config.
-*
-* @param steps - User-configured pipeline steps (from PipelineDefaultStep[])
-* @param getEngine - Function that returns an IInferenceEngine for a step ID.
-*                    Throws if step not loaded.
-*/
-function buildExecutableTree(steps, getEngine) {
-	return { roots: steps.filter((s) => s.enabled).filter((s) => s.slot !== "audio-classifier").map((s) => buildNode(s, getEngine)) };
-}
-function buildNode(step, getEngine) {
-	const definition = getStepDefinition(step.addonId);
-	const engine = getEngine(step.addonId);
-	const children = (step.children ?? []).filter((c) => c.enabled).map((c) => buildNode(c, getEngine));
-	const mergedSettings = {
-		...collectSchemaDefaults(step.addonId),
-		...step.settings
-	};
-	return {
-		stepId: step.addonId,
-		definition,
-		engine,
-		modelId: step.modelId,
-		inputClasses: definition.inputClasses ?? [],
-		enabled: step.enabled,
-		children,
-		...Object.keys(mergedSettings).length > 0 ? { settings: mergedSettings } : {}
-	};
-}
-/**
-* Walk the step's declared `getConfigSchema()` and collect every field
-* with a primitive `default` value into a plain record. Group fields
-* are flattened — a nested `{ type: 'group', fields: [...] }` is
-* entered recursively. Fields without a declared default are skipped.
-*/
-function collectSchemaDefaults(stepId) {
-	const schema = getStep(stepId).getConfigSchema();
-	const out = {};
-	walkFieldsForDefaults(schema, out);
-	return out;
-}
-function walkFieldsForDefaults(fields, out) {
-	for (const field of fields) {
-		if ("type" in field && field.type === "group" && "fields" in field) {
-			walkFieldsForDefaults(field.fields, out);
-			continue;
-		}
-		if ("key" in field && "default" in field && field.default !== void 0) out[field.key] = field.default;
-	}
-}
-//#endregion
-//#region src/detection-pipeline/runtimes.ts
-var KNOWN_PLATFORMS = [
-	"darwin",
-	"linux",
-	"win32"
-];
-var KNOWN_ARCHES = ["arm64", "x64"];
-var KNOWN_GPU_TYPES = [
-	"nvidia",
-	"amd",
-	"intel",
-	"apple"
-];
-var KNOWN_NPU_TYPES = ["apple-ane", "intel-npu"];
-function toKnownPlatform(p) {
-	return KNOWN_PLATFORMS.find((v) => v === p) ?? "linux";
-}
-function toKnownArch(a) {
-	return KNOWN_ARCHES.find((v) => v === a) ?? "x64";
-}
-function gpuInfoFrom(hw) {
-	if (!hw.gpu) return null;
-	const type = KNOWN_GPU_TYPES.find((v) => v === hw.gpu?.type);
-	if (!type) return null;
-	return {
-		type,
-		name: ""
-	};
-}
-function npuInfoFrom(hw) {
-	if (!hw.npu) return null;
-	const type = KNOWN_NPU_TYPES.find((v) => v === hw.npu?.type);
-	if (!type) return null;
-	return { type };
-}
-function envToHardwareInfo(env) {
-	if (!env.hardware) return null;
-	return {
-		platform: toKnownPlatform(env.platform),
-		arch: toKnownArch(env.arch),
-		cpuModel: "",
-		cpuCores: 0,
-		totalRAM_MB: 0,
-		availableRAM_MB: 0,
-		gpu: gpuInfoFrom(env.hardware),
-		npu: npuInfoFrom(env.hardware)
-	};
-}
-function probedToHardwareInfo(hw) {
-	if (!hw) return null;
-	return {
-		platform: toKnownPlatform(process.platform),
-		arch: toKnownArch(process.arch),
-		cpuModel: "",
-		cpuCores: 0,
-		totalRAM_MB: 0,
-		availableRAM_MB: 0,
-		gpu: gpuInfoFrom(hw),
-		npu: npuInfoFrom(hw)
-	};
-}
-var RUNTIME_DETAIL = {
-	onnx: {
-		label: "ONNX Runtime",
-		pythonRequirements: ["requirements.txt", "requirements-onnxruntime.txt"],
-		tuning: {
-			concurrency: 4,
-			batchMode: "list",
-			maxBatchSize: 8,
-			intraOpThreads: 0
-		}
-	},
-	openvino: {
-		label: "OpenVINO",
-		pythonRequirements: ["requirements.txt", "requirements-openvino.txt"],
-		tuning: {
-			concurrency: 1,
-			batchMode: "none",
-			numStreams: 0
-		}
-	},
-	coreml: {
-		label: "CoreML",
-		pythonRequirements: ["requirements.txt", "requirements-coreml.txt"],
-		tuning: {
-			concurrency: 1,
-			batchMode: "none",
-			windowMs: 8,
-			maxBatchSize: 8,
-			numWorkers: 1
-		}
-	}
-};
-/**
-* Returns the list of supported runtime IDs for the given hardware env.
-* Delegates to `@camstack/types` `supportedRuntimes`.
-*/
-function supportedRuntimes(env) {
-	return supportedRuntimes$1(envToHardwareInfo(env));
-}
-/**
-* Returns the device options for a given runtime and probed hardware.
-* Delegates to `@camstack/types` `runtimeDevices`.
-*/
-function runtimeDevices(id, hardware) {
-	return runtimeDevices$1(id, probedToHardwareInfo(hardware));
-}
-/**
-* Returns the default device string for a given runtime.
-* Delegates to `@camstack/types` `defaultDeviceFor`.
-*/
-function defaultDeviceFor(id) {
-	return defaultDeviceFor$1(id);
-}
-/** Model format for each inference runtime supported by the detection pipeline. */
-var RUNTIME_FORMAT = {
-	onnx: "onnx",
-	openvino: "openvino",
-	coreml: "coreml"
-};
-/**
-* Returns the model format required for a given runtime.
-* Returns the locally-typed format string ('onnx' | 'openvino' | 'coreml')
-* matching the engine-provisioner's own ModelFormat type.
-*/
-function modelFormatFor(id) {
-	return RUNTIME_FORMAT[id];
-}
-function pythonRequirementsFor(id) {
-	return RUNTIME_DETAIL[id].pythonRequirements;
-}
-function tuningFor(id) {
-	return RUNTIME_DETAIL[id].tuning;
-}
-function runtimeLabel(id) {
-	return RUNTIME_DETAIL[id].label;
-}
-/**
-* Proactive-install hint kept for back-compat (re-exported from index.ts).
-* Intel on Linux warrants installing openvino; coremltools covers macOS;
-* openvino has no AMD/NVIDIA backend.
-*/
-function shouldInstallOpenvino(env) {
-	if (env.platform === "darwin") return false;
-	return env.gpu?.type === "intel" || env.npu?.type === "intel-npu";
-}
-//#endregion
-//#region src/detection-pipeline/engine-provisioner.ts
-/** Incremental backoff growing to a ~5 min cap; retries indefinitely at cap. */
-var BACKOFF_SCHEDULE_MS = [
-	5e3,
-	15e3,
-	3e4,
-	6e4,
-	12e4,
-	3e5
-];
-var IDLE_STATE = {
-	runtimeId: null,
-	device: null,
-	state: "idle"
-};
-var EngineProvisioner = class {
-	fx;
-	current = IDLE_STATE;
-	/** Bumped on every select/dispose — stale async results (old generation) are ignored. */
-	generation = 0;
-	cancelTimer = null;
-	retryIndex = 0;
-	constructor(fx) {
-		this.fx = fx;
-	}
-	get state() {
-		return this.current;
-	}
-	isReady() {
-		return this.current.state === "ready";
-	}
-	select(runtimeId, device) {
-		this.generation++;
-		this.retryIndex = 0;
-		this.clearTimer();
-		this.transition({
-			runtimeId,
-			device,
-			state: "installing",
-			progress: 0
+				inputWidth,
+				inputHeight,
+				parentDetection: parentClass,
+				output: errorOutput,
+				error: errorMsg
+			});
+			stepTimings.push({
+				source: step.stepId,
+				modelId: step.modelId,
+				ms: Date.now() - preprocessStart,
+				detectionCount: 0
+			});
+			throw new Error(`Inference failed for step "${step.stepId}": ${errorMsg}`, { cause: err });
+		}
+		const structured = engineOutput.structured ?? {};
+		const inferenceMs = typeof structured.inferenceMs === "number" ? structured.inferenceMs : Date.now() - inferenceStart;
+		if (typeof structured.preprocessMs === "number") poolAgg.preprocessMs += structured.preprocessMs;
+		if (typeof structured.predictMs === "number") poolAgg.predictMs += structured.predictMs;
+		if (typeof structured.batchSize === "number" && structured.batchSize > poolAgg.batchSize) poolAgg.batchSize = structured.batchSize;
+		const postprocessStart = Date.now();
+		const output = dispatchPostprocess(engineOutput, step.definition);
+		const postprocessMs = Date.now() - postprocessStart;
+		stepTimings.push({
+			source: step.stepId,
+			modelId: step.modelId,
+			ms: preprocessMs + inferenceMs + postprocessMs,
+			detectionCount: output.kind === "detections" ? output.detections.length : 0
 		});
-		this.provision(this.generation, runtimeId, device);
-	}
-	dispose() {
-		this.generation++;
-		this.clearTimer();
+		if (traceBuilder.isActive) traceBuilder.addStep({
+			stepId: step.stepId,
+			modelId: step.modelId,
+			slot: step.definition.slot,
+			postprocessor: step.definition.postprocessor,
+			preprocessMs,
+			inferenceMs,
+			postprocessMs,
+			inputType,
+			inputWidth,
+			inputHeight,
+			parentDetection: parentClass,
+			output
+		});
+		return output;
 	}
-	clearTimer() {
-		if (this.cancelTimer !== null) {
-			this.cancelTimer();
-			this.cancelTimer = null;
+	async executeChildren(children, parentDetection, fullFrameJpegProvider, imageWidth, imageHeight, traceBuilder, stepTimings, ctx, poolAgg) {
+		for (const child of children) {
+			if (!this.matchesInputClasses(parentDetection.macroClass, child.inputClasses)) continue;
+			const minParentScore = child.settings?.minParentScore ?? child.definition?.defaultMinParentScore;
+			if (typeof minParentScore === "number" && parentDetection.score < minParentScore) continue;
+			if (isBboxDegenerate(parentDetection.bbox)) continue;
+			try {
+				const childStart = Date.now();
+				const fullFrameJpeg = await fullFrameJpegProvider();
+				const modelEntry = child.definition.models.find((m) => m.id === child.modelId);
+				let cropJpegBuf;
+				let cropW;
+				let cropH;
+				if (modelEntry?.faceAlignment) {
+					const minFaceSize = typeof child.settings?.["minFaceSize"] === "number" ? child.settings["minFaceSize"] : DEFAULT_MIN_FACE_SIZE_PX;
+					if (bboxShortSide(parentDetection.bbox) < minFaceSize) continue;
+					const lms = parentDetection.landmarks;
+					if (lms && lms.length >= 5) {
+						const aligned = await alignFaceCrop(fullFrameJpeg, parentDetection.bbox, lms, imageWidth, imageHeight, { outSize: modelEntry.inputSize.width });
+						cropJpegBuf = aligned.jpeg;
+						cropW = aligned.width;
+						cropH = aligned.height;
+					} else {
+						const crop = await cropJpeg(fullFrameJpeg, parentDetection.bbox, imageWidth, imageHeight);
+						cropJpegBuf = crop.jpeg;
+						cropW = crop.width;
+						cropH = crop.height;
+					}
+				} else {
+					const crop = await cropJpeg(fullFrameJpeg, parentDetection.bbox, imageWidth, imageHeight);
+					cropJpegBuf = crop.jpeg;
+					cropW = crop.width;
+					cropH = crop.height;
+				}
+				const childOutput = await this.executeStep(child, {
+					kind: "jpeg",
+					data: cropJpegBuf
+				}, cropW, cropH, "crop-roi", parentDetection.bbox, parentDetection.macroClass, traceBuilder, stepTimings, poolAgg);
+				const childMs = Date.now() - childStart;
+				const detailsBefore = ctx.details.length;
+				applyChildOutput(parentDetection, child, childOutput, childMs, ctx);
+				if (childOutput.kind === "detections" && child.children.length > 0) {
+					const newDetails = ctx.details.slice(detailsBefore);
+					for (const detail of newDetails) {
+						detail.bbox = transformBboxToImageSpace(detail.bbox, parentDetection.bbox);
+						if (detail.landmarks) {
+							const [px1, py1] = parentDetection.bbox;
+							detail.landmarks = detail.landmarks.map((l) => ({
+								x: l.x + px1,
+								y: l.y + py1
+							}));
+						}
+						await this.executeChildren(child.children, detail, fullFrameJpegProvider, imageWidth, imageHeight, traceBuilder, stepTimings, ctx, poolAgg);
+					}
+				}
+			} catch {}
 		}
 	}
-	transition(next) {
-		this.current = next;
-		this.fx.onChange(next);
+	matchesInputClasses(className, inputClasses) {
+		if (inputClasses.length === 0) return true;
+		return inputClasses.includes(className);
 	}
-	async provision(gen, runtimeId, device) {
-		try {
-			await Promise.all([this.fx.installRequirements(this.fx.requirementsFor(runtimeId)), this.fx.ensureModelForFormat(this.fx.modelFormatFor(runtimeId))]);
-			if (gen !== this.generation) return;
-			this.transition({
-				runtimeId,
-				device,
-				state: "verifying",
-				progress: 100
-			});
-			await this.fx.verify(runtimeId, device);
-			if (gen !== this.generation) return;
-			this.retryIndex = 0;
-			this.transition({
-				runtimeId,
-				device,
-				state: "ready"
-			});
-		} catch (err) {
-			if (gen !== this.generation) return;
-			const message = err instanceof Error ? err.message : String(err);
-			const delay = BACKOFF_SCHEDULE_MS[Math.min(this.retryIndex, BACKOFF_SCHEDULE_MS.length - 1)];
-			this.retryIndex++;
-			const nextRetryAt = this.fx.now() + delay;
-			this.transition({
-				runtimeId,
-				device,
-				state: "failed",
-				error: message,
-				nextRetryAt
-			});
-			this.cancelTimer = this.fx.setTimer(delay, () => {
-				if (gen !== this.generation) return;
-				this.cancelTimer = null;
-				this.transition({
-					runtimeId,
-					device,
-					state: "installing",
-					progress: 0
-				});
-				this.provision(gen, runtimeId, device);
-			});
+	/**
+	* Apply the object-detection step's macro filter + per-macro
+	* minConfidence sliders introduced in the Phase 6 step rework.
+	*
+	* Expected `settings` shape:
+	*   - `enabledMacroClasses`: readonly string[] (e.g. ['person','vehicle','animal']).
+	*     Empty array = all allowed (legacy behaviour).
+	*   - `minConfidence<Macro>`: number (e.g. `minConfidencePerson: 0.5`)
+	*/
+	matchesMacroFilter(macroClass, score, settings) {
+		if (!settings) return true;
+		const enabled = settings["enabledMacroClasses"];
+		if (Array.isArray(enabled) && enabled.length > 0) {
+			if (!enabled.includes(macroClass)) return false;
 		}
+		const perMacroThreshold = settings[`minConfidence${capitalize(macroClass)}`];
+		if (typeof perMacroThreshold === "number" && score < perMacroThreshold) return false;
+		return true;
 	}
 };
+function capitalize(s) {
+	if (s.length === 0) return s;
+	return s.charAt(0).toUpperCase() + s.slice(1);
+}
 //#endregion
-//#region src/detection-pipeline/auto-pick.ts
-var PREFERENCE = [
-	"coreml",
-	"openvino",
-	"onnx"
-];
+//#region src/detection-pipeline/pipeline/tree-builder.ts
 /**
-* Pure function — picks the best supported runtime for the given hardware env.
-*
-* Logic:
-* 1. If `bestBackendHint` is in the supported set, use it.
-* 2. Otherwise, walk PREFERENCE order and pick the first supported runtime.
-* 3. Floor to `'onnx'` (always supported).
+* Build an executable tree from user config.
 *
-* Device is always `defaultDeviceFor(chosen)`.
+* @param steps - User-configured pipeline steps (from PipelineDefaultStep[])
+* @param getEngine - Function that returns an IInferenceEngine for a step ID.
+*                    Throws if step not loaded.
 */
-function pickBestRuntime(env, bestBackendHint) {
-	const supported = supportedRuntimes(env);
-	const chosen = supported.find((id) => id === bestBackendHint) ?? PREFERENCE.find((id) => supported.includes(id)) ?? "onnx";
+function buildExecutableTree(steps, getEngine) {
+	return { roots: steps.filter((s) => s.enabled).filter((s) => s.slot !== "audio-classifier").map((s) => buildNode(s, getEngine)) };
+}
+function buildNode(step, getEngine) {
+	const definition = getStepDefinition(step.addonId);
+	const engine = getEngine(step.addonId);
+	const children = (step.children ?? []).filter((c) => c.enabled).map((c) => buildNode(c, getEngine));
+	const mergedSettings = {
+		...collectSchemaDefaults(step.addonId),
+		...step.settings
+	};
 	return {
-		runtimeId: chosen,
-		device: defaultDeviceFor(chosen)
+		stepId: step.addonId,
+		definition,
+		engine,
+		modelId: step.modelId,
+		inputClasses: definition.inputClasses ?? [],
+		enabled: step.enabled,
+		children,
+		...Object.keys(mergedSettings).length > 0 ? { settings: mergedSettings } : {}
 	};
 }
+/**
+* Walk the step's declared `getConfigSchema()` and collect every field
+* with a primitive `default` value into a plain record. Group fields
+* are flattened — a nested `{ type: 'group', fields: [...] }` is
+* entered recursively. Fields without a declared default are skipped.
+*/
+function collectSchemaDefaults(stepId) {
+	const schema = getStep(stepId).getConfigSchema();
+	const out = {};
+	walkFieldsForDefaults(schema, out);
+	return out;
+}
+function walkFieldsForDefaults(fields, out) {
+	for (const field of fields) {
+		if ("type" in field && field.type === "group" && "fields" in field) {
+			walkFieldsForDefaults(field.fields, out);
+			continue;
+		}
+		if ("key" in field && "default" in field && field.default !== void 0) out[field.key] = field.default;
+	}
+}
 //#endregion
 //#region src/detection-pipeline/provider.ts
 /**
@@ -4154,6 +4070,13 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 	*/
 	needsAutoPick = false;
 	/**
+	* Unsubscribe handle for the deferred-auto-pick `platform-probe` ready
+	* listener (armed in `setApi` when the probe isn't ready yet). Cleared once
+	* the engine is resolved — either by the listener firing or by the boot
+	* safety-net `ensureBootEngineProvisioned`.
+	*/
+	deferredAutoPickUnsub = null;
+	/**
 	* Warm cache for benchmark engine-override runs.
 	*
 	* Each override rebuild costs a full Python pool spin-up (~300-500ms)
@@ -4186,7 +4109,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 		this.writeStore = (patch) => settings.writeAddonStore(patch);
 		this.readDeviceStore = settings.readDeviceStore ?? (async () => ({}));
 		this.currentEngine = ONNX_FLOOR;
-		this.log.info("Engine selected (default)", { meta: {
+		this.log.info("Engine pick pending (placeholder until probe / persisted selection)", { meta: {
 			runtime: this.currentEngine.runtime,
 			backend: this.currentEngine.backend,
 			format: this.currentEngine.format
@@ -4259,26 +4182,70 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 			this.needsAutoPick = false;
 			this.startProvisioningForCurrentEngine();
 		} else {
-			this.startProvisioningForCurrentEngine();
 			const unsubscribe = this.addonCtx.onCapabilityStateChange("platform-probe", { type: "global" }, (state) => {
 				if (state !== "ready") return;
-				unsubscribe();
+				this.cancelDeferredAutoPick();
 				if (!this.needsAutoPick) return;
 				this.autoPickAndPersist().then(() => {
 					this.needsAutoPick = false;
 					this.startProvisioningForCurrentEngine();
 				});
 			});
-			this.addonCtx.addDisposer(unsubscribe);
+			this.deferredAutoPickUnsub = unsubscribe;
+			this.addonCtx.addDisposer(() => this.cancelDeferredAutoPick());
 		}
 		else this.startProvisioningForCurrentEngine();
 	}
+	/** Tear down the deferred-auto-pick probe listener, if still armed. */
+	cancelDeferredAutoPick() {
+		if (this.deferredAutoPickUnsub) {
+			this.deferredAutoPickUnsub();
+			this.deferredAutoPickUnsub = null;
+		}
+	}
+	/**
+	* Boot safety-net: deterministically provision the hardware-probed engine.
+	*
+	* Called from the addon's `onInitialize` right after `reprobeEngine` has
+	* written this node's probe-driven selection (e.g. `engineBackend=openvino`)
+	* to the store. When first-boot auto-pick was DEFERRED (probe not ready at
+	* `setApi`), the engine would otherwise stay `idle` — selected but never
+	* provisioned — because the `onCapabilityStateChange('platform-probe')` ready
+	* edge can be missed when the cap is already 'ready' by the time we subscribe
+	* (the old eager-onnx-floor masked this; removing it surfaced a node that
+	* boots with no engine at all). This loads the now-persisted selection and
+	* starts provisioning it, so the node reliably comes up on its real best
+	* engine (openvino on Intel) with no onnx floor and no missed boot. No-op
+	* when provisioning already started (persisted-engine path / listener fired)
+	* or when nothing has been selected yet.
+	*/
+	async ensureBootEngineProvisioned() {
+		if (this.getEngineProvisioning().state !== "idle") return;
+		const stored = await this.loadEngine();
+		if (!stored) return;
+		this.currentEngine = stored;
+		this.needsAutoPick = false;
+		this.cancelDeferredAutoPick();
+		this.log.info("Boot engine provisioning from probed selection", { meta: {
+			runtime: stored.runtime,
+			backend: stored.backend,
+			device: stored.device ?? null
+		} });
+		this.startProvisioningForCurrentEngine();
+	}
 	/**
 	* Auto-pick the best supported runtime at first boot (no stored engine).
 	* Uses the platform-probe cap's hardware + bestScore hint when available;
 	* falls back to platform/arch when the probe cap is not yet reachable.
+	*
 	* Persists the selection as `engineBackend` + `engineDevice` so subsequent
-	* boots load it via `loadEngine()` and skip this path.
+	* boots load it via `loadEngine()` and skip this path — but ONLY when the
+	* probe actually answered (real `hardware` or a `bestScore` hint). If the
+	* probe query failed (cold-start race, cap momentarily unreachable), the
+	* pick floors to onnx purely for lack of information; persisting that would
+	* LOCK onnx and skip auto-pick on every future boot even after the
+	* accelerator surfaces. In that case we set the in-memory floor for liveness
+	* but leave the store untouched so the next boot re-attempts the pick.
 	*/
 	async autoPickAndPersist() {
 		let hardware = null;
@@ -4300,6 +4267,13 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 			device: pick.device
 		};
 		this.currentEngine = engine;
+		if (!(hardware !== null || bestBackendHint !== null)) {
+			this.log.warn("Auto-pick: probe returned no hardware/hint — using onnx floor WITHOUT persisting", { meta: {
+				backend: pick.runtimeId,
+				device: pick.device
+			} });
+			return;
+		}
 		const apNode = this.localProbeNodeId();
 		await this.writeStore({
 			[nodeEngineKey("engineBackend", apNode)]: pick.runtimeId,
@@ -6880,6 +6854,9 @@ var DetectionPipelineAddon = class extends BaseAddon {
 		if (!this.nodeProbedBestEngine) await this.provider.reprobeEngine().catch((err) => {
 			this.ctx.logger.warn("auto-reprobe engine failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
 		});
+		await this.provider.ensureBootEngineProvisioned().catch((err) => {
+			this.ctx.logger.warn("ensureBootEngineProvisioned failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
+		});
 		await this.provider.warmPool();
 		this.engineMetricsTimer = setInterval(() => this.emitEngineMetricsSnapshot(), ENGINE_METRICS_SNAPSHOT_INTERVAL_MS);
 		this.lastAppliedPoolConfig = this.snapshotPoolConfig();