@camstack/addon-pipeline 1.0.8 → 1.1.1

package/dist/detection-pipeline/index.js

@@ -2,17 +2,261 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_model_download_service_C7AjBsX9 = require("../model-download-service-C7AjBsX9-rXY-VFDk.js");
-const require_dist = require("../dist-BLcTVvol.js");
+const require_model_download_service_C_IHWnXx = require("../model-download-service-C-IHWnXx-BnQ_awK4.js");
+const require_dist = require("../dist-DnD2tm7T.js");
 let node_fs = require("node:fs");
-node_fs = require_model_download_service_C7AjBsX9.__toESM(node_fs);
+node_fs = require_model_download_service_C_IHWnXx.__toESM(node_fs);
 let node_path = require("node:path");
-node_path = require_model_download_service_C7AjBsX9.__toESM(node_path);
+node_path = require_model_download_service_C_IHWnXx.__toESM(node_path);
 let node_os = require("node:os");
-node_os = require_model_download_service_C7AjBsX9.__toESM(node_os);
+node_os = require_model_download_service_C_IHWnXx.__toESM(node_os);
 let node_child_process = require("node:child_process");
 let sharp = require("sharp");
-sharp = require_model_download_service_C7AjBsX9.__toESM(sharp);
+sharp = require_model_download_service_C_IHWnXx.__toESM(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 require_dist.supportedRuntimes(envToHardwareInfo(env));
+}
+/**
+* Returns the device options for a given runtime and probed hardware.
+* Delegates to `@camstack/types` `runtimeDevices`.
+*/
+function runtimeDevices(id, hardware) {
+	return require_dist.runtimeDevices(id, probedToHardwareInfo(hardware));
+}
+/**
+* Returns the default device string for a given runtime.
+* Delegates to `@camstack/types` `defaultDeviceFor`.
+*/
+function defaultDeviceFor(id) {
+	return require_dist.defaultDeviceFor(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;
@@ -779,6 +1023,46 @@ var HF_REPO = "camstack/camstack-models";
 var HF_SCRYPTED = "scrypted/plugin-models";
 var hf = (path) => require_dist.hfModelUrl(HF_REPO, path);
 var hfScrypted = (path) => require_dist.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 } : {}
+	};
+};
+/**
+* Build a precision-variant catalog entry (OpenVINO-only) derived from a base
+* detection model. fp16 halves the weights (Intel iGPU/NPU sweet spot); int8 is
+* NNCF post-training-quantized (~4× smaller, fastest on CPU/iGPU at a small
+* accuracy cost). The IRs live next to the base `.xml` on HF as
+* `camstack-<id>-<precision>.xml`. Lets an operator scale the model to the node
+* (e.g. yolo26x-int8 on a 265K, yolo26n-int8 on an N100).
+*/
+var ovPrecisionVariant = (baseId, ovDir, baseName, precision, sizeMB) => ({
+	id: `${baseId}-${precision}`,
+	name: `${baseName} (${precision.toUpperCase()})`,
+	description: `${baseName} — OpenVINO ${precision.toUpperCase()} variant for Intel iGPU/NPU; scale by hardware`,
+	inputSize: {
+		width: 640,
+		height: 640
+	},
+	labels: [],
+	preprocessMode: "letterbox",
+	formats: { openvino: ovFormat(hf(`${ovDir}/camstack-${baseId}-${precision}.xml`), sizeMB) }
+});
 var MLPACKAGE_FILES = [
 	"Manifest.json",
 	"Data/com.apple.CoreML/model.mlmodel",
@@ -807,11 +1091,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)
 		}
 	},
 	{
@@ -836,11 +1116,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)
 		}
 	},
 	{
@@ -865,11 +1141,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)
 		}
 	},
 	{
@@ -894,11 +1166,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)
 		}
 	},
 	{
@@ -923,11 +1191,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)
 		}
 	},
 	{
@@ -952,11 +1216,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)
 		}
 	},
 	{
@@ -981,11 +1241,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)
 		}
 	},
 	{
@@ -1010,11 +1266,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)
 		}
 	},
 	{
@@ -1039,11 +1291,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)
 		}
 	},
 	{
@@ -1068,11 +1316,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)
 		}
 	},
 	{
@@ -1097,11 +1341,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)
 		}
 	},
 	{
@@ -1126,13 +1366,23 @@ 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)
 		}
-	}
+	},
+	ovPrecisionVariant("yolov9t", "objectDetection/yolov9/openvino", "YOLOv9 Tiny", "fp16", 5),
+	ovPrecisionVariant("yolov9t", "objectDetection/yolov9/openvino", "YOLOv9 Tiny", "int8", 3),
+	ovPrecisionVariant("yolov9s", "objectDetection/yolov9/openvino", "YOLOv9 Small", "fp16", 15),
+	ovPrecisionVariant("yolov9s", "objectDetection/yolov9/openvino", "YOLOv9 Small", "int8", 8),
+	ovPrecisionVariant("yolo26n", "objectDetection/yolo26/openvino", "YOLO26 Nano", "fp16", 5),
+	ovPrecisionVariant("yolo26n", "objectDetection/yolo26/openvino", "YOLO26 Nano", "int8", 3),
+	ovPrecisionVariant("yolo26s", "objectDetection/yolo26/openvino", "YOLO26 Small", "fp16", 19),
+	ovPrecisionVariant("yolo26s", "objectDetection/yolo26/openvino", "YOLO26 Small", "int8", 10),
+	ovPrecisionVariant("yolo26m", "objectDetection/yolo26/openvino", "YOLO26 Medium", "fp16", 41),
+	ovPrecisionVariant("yolo26m", "objectDetection/yolo26/openvino", "YOLO26 Medium", "int8", 21),
+	ovPrecisionVariant("yolo26l", "objectDetection/yolo26/openvino", "YOLO26 Large", "fp16", 50),
+	ovPrecisionVariant("yolo26l", "objectDetection/yolo26/openvino", "YOLO26 Large", "int8", 25),
+	ovPrecisionVariant("yolo26x", "objectDetection/yolo26/openvino", "YOLO26 XLarge", "fp16", 112),
+	ovPrecisionVariant("yolo26x", "objectDetection/yolo26/openvino", "YOLO26 XLarge", "int8", 56)
 ];
 var FACE_DETECTION_MODELS = [{
 	id: "scrfd-2.5g",
@@ -1159,11 +1409,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",
@@ -1190,11 +1436,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 = [{
@@ -1224,11 +1466,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",
@@ -1255,11 +1493,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 = [{
@@ -1287,11 +1521,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 = [{
@@ -1319,11 +1549,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 = [{
@@ -1352,11 +1578,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 = [{
@@ -1385,11 +1607,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"),
@@ -1423,11 +1641,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"),
@@ -1460,11 +1674,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 = [
@@ -1490,11 +1700,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)
 		}
 	},
 	{
@@ -1519,11 +1725,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)
 		}
 	},
 	{
@@ -1548,11 +1750,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)
 		}
 	}
 ];
@@ -1568,16 +1766,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"]
 		}
@@ -1635,7 +1829,7 @@ var ObjectDetectionStep = class {
 			"animal"
 		],
 		models: [...OBJECT_DETECTION_MODELS],
-		defaultModelId: "yolov9s",
+		defaultModelId: "yolo26n",
 		defaultConfidence: .5,
 		labels: require_dist.COCO_80_LABELS.map((l) => l.id),
 		classMap: require_dist.COCO_TO_MACRO
@@ -1884,9 +2078,9 @@ var STEP_VEHICLE_CLASSIFIER = new ClassifierWithMinConfidence({
 	enabledByDefault: false,
 	defaultConfidence: .3
 });
-var STEP_SEGMENTATION_REFINER = new PipelineStepBase({
-	id: "segmentation-refiner",
-	name: "Saliency Segmentation",
+var STEP_SEGMENTATION = new PipelineStepBase({
+	id: "segmentation",
+	name: "Segmentation",
 	slot: "refiner",
 	postprocessor: "saliency",
 	extractMode: "crop-roi",
@@ -1898,7 +2092,7 @@ var STEP_SEGMENTATION_REFINER = new PipelineStepBase({
 	defaultConfidence: 0,
 	group: "Segmentation"
 });
-var STEP_INSTANCE_SEGMENTATION = new PipelineStepBase({
+new PipelineStepBase({
 	id: "instance-segmentation",
 	name: "Instance Segmentation",
 	slot: "refiner",
@@ -1925,8 +2119,7 @@ var ALL_PIPELINE_STEPS = [
 	new AnimalClassifierStep(),
 	STEP_BIRD_CLASSIFIER,
 	STEP_VEHICLE_CLASSIFIER,
-	STEP_SEGMENTATION_REFINER,
-	STEP_INSTANCE_SEGMENTATION,
+	STEP_SEGMENTATION,
 	STEP_AUDIO_CLASSIFIER_INSTANCE
 ];
 /** Compat: flat array of StepDefinition for existing consumers */
@@ -2165,77 +2358,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([
@@ -3066,6 +3290,18 @@ function applyChildOutput(parent, childStep, output, stepLatencyMs, ctx) {
 			parent.mask = output.mask;
 			parent.maskWidth = output.maskWidth;
 			parent.maskHeight = output.maskHeight;
+			if (output.maskBbox !== void 0 && output.maskWidth > 0 && output.maskHeight > 0) {
+				const [px1, py1, px2, py2] = parent.bbox;
+				const parentW = px2 - px1;
+				const parentH = py2 - py1;
+				const [mbx, mby, mbw, mbh] = output.maskBbox;
+				parent.refinedBbox = [
+					px1 + mbx / output.maskWidth * parentW,
+					py1 + mby / output.maskHeight * parentH,
+					px1 + (mbx + mbw) / output.maskWidth * parentW,
+					py1 + (mby + mbh) / output.maskHeight * parentH
+				];
+			}
 			break;
 	}
 }
@@ -3116,6 +3352,12 @@ function buildFrameResult(input) {
 			macroClass: m.macroClass,
 			score: m.score,
 			bbox,
+			...m.refinedBbox !== void 0 ? { refinedBbox: bboxTupleToRect(m.refinedBbox) } : {},
+			...m.mask !== void 0 && m.maskWidth !== void 0 && m.maskHeight !== void 0 ? {
+				mask: m.mask,
+				maskWidth: m.maskWidth,
+				maskHeight: m.maskHeight
+			} : {},
 			labels,
 			...m.parentId !== void 0 ? { parentId: m.parentId } : {},
 			...embedding !== void 0 ? {
@@ -3547,338 +3789,97 @@ var PipelineExecutor = class {
 		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 require_dist.supportedRuntimes(envToHardwareInfo(env));
+	}
+};
+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
 /**
-* Returns the device options for a given runtime and probed hardware.
-* Delegates to `@camstack/types` `runtimeDevices`.
+* 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 runtimeDevices(id, hardware) {
-	return require_dist.runtimeDevices(id, probedToHardwareInfo(hardware));
+function buildExecutableTree(steps, getEngine) {
+	return { roots: steps.filter((s) => s.enabled).filter((s) => s.slot !== "audio-classifier").map((s) => buildNode(s, getEngine)) };
 }
-/**
-* Returns the default device string for a given runtime.
-* Delegates to `@camstack/types` `defaultDeviceFor`.
-*/
-function defaultDeviceFor(id) {
-	return require_dist.defaultDeviceFor(id);
+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 } : {}
+	};
 }
-/** 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.
+* 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 modelFormatFor(id) {
-	return RUNTIME_FORMAT[id];
-}
-function pythonRequirementsFor(id) {
-	return RUNTIME_DETAIL[id].pythonRequirements;
-}
-function tuningFor(id) {
-	return RUNTIME_DETAIL[id].tuning;
+function collectSchemaDefaults(stepId) {
+	const schema = getStep(stepId).getConfigSchema();
+	const out = {};
+	walkFieldsForDefaults(schema, out);
+	return out;
 }
-function runtimeLabel(id) {
-	return RUNTIME_DETAIL[id].label;
+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/registry/custom-models.ts
 /**
-* 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.
+* Group a flat list of custom-model descriptors (as returned by the
+* `custom-model-registry` collection cap) into a `stepId → entries` map for
+* the picker / resolution union. Pure; order within a step preserved.
 */
-function shouldInstallOpenvino(env) {
-	if (env.platform === "darwin") return false;
-	return env.gpu?.type === "intel" || env.npu?.type === "intel-npu";
+function groupCustomModelsByStep(descriptors) {
+	const byStep = /* @__PURE__ */ new Map();
+	for (const d of descriptors) {
+		const arr = byStep.get(d.stepId) ?? [];
+		arr.push(d.entry);
+		byStep.set(d.stepId, arr);
+	}
+	return byStep;
 }
-//#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
-		});
-		this.provision(this.generation, runtimeId, device);
-	}
-	dispose() {
-		this.generation++;
-		this.clearTimer();
-	}
-	clearTimer() {
-		if (this.cancelTimer !== null) {
-			this.cancelTimer();
-			this.cancelTimer = null;
-		}
-	}
-	transition(next) {
-		this.current = next;
-		this.fx.onChange(next);
-	}
-	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/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).
+* Union a step's static catalog models with operator-registered custom
+* models. On an `id` collision the static catalog entry wins — a custom
+* model can never shadow a built-in one.
 *
-* Device is always `defaultDeviceFor(chosen)`.
+* Pure + side-effect-free so it can be unit-tested in isolation and called
+* from the (free) `buildSchemaSlots` builder without any addon context.
 */
-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)
-	};
+function mergeCustomModels(staticModels, customModels) {
+	const seen = new Set(staticModels.map((m) => m.id));
+	const merged = [...staticModels];
+	for (const m of customModels) {
+		if (seen.has(m.id)) continue;
+		seen.add(m.id);
+		merged.push(m);
+	}
+	return merged;
 }
 //#endregion
 //#region src/detection-pipeline/provider.ts
@@ -4116,6 +4117,13 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 	/** Addon context — ctx.api resolves lazily (direct caller created after boot) */
 	addonCtx = null;
 	/**
+	* Short-lived cache of custom models pulled from the `custom-model-registry`
+	* collection cap, grouped by step id. TTL-bounded so the picker / resolution
+	* paths don't issue a cap round-trip on every call. Empty map = no provider
+	* (or a query failure) → behaviour identical to the static-catalog-only path.
+	*/
+	customModelsCache = null;
+	/**
 	* Per-device {@link DeviceProxy} cache used for zone gating at the
 	* runtime path. Reads `state.zones.value` + `state.zoneRules.value`
 	* synchronously per frame so detections inside an `exclude` zone
@@ -4161,6 +4169,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)
@@ -4193,7 +4208,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
@@ -4266,26 +4281,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;
@@ -4307,6 +4366,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,
@@ -4386,8 +4452,20 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 	* runtime through installing → verifying → ready.
 	*/
 	async onEngineSelectionChanged() {
+		const prev = this.currentEngine;
 		const stored = await this.loadEngine();
 		if (stored) this.currentEngine = stored;
+		if ((prev.runtime !== this.currentEngine.runtime || prev.backend !== this.currentEngine.backend || prev.format !== this.currentEngine.format || (prev.device ?? "") !== (this.currentEngine.device ?? "")) && this.engineFactory) {
+			this.log.info("engine selection changed — rebuilding pool in place", { meta: {
+				from: `${prev.backend}/${prev.device ?? "default"}`,
+				to: `${this.currentEngine.backend}/${this.currentEngine.device ?? "default"}`
+			} });
+			try {
+				await this.engineFactory.dispose();
+			} catch {}
+			this.engineFactory = null;
+			this.executor = null;
+		}
 		this.startProvisioningForCurrentEngine();
 	}
 	/**
@@ -4425,9 +4503,9 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 		if (!steps || steps.length === 0) return;
 		for (const step of flattenSteps(steps)) {
 			if (!step.enabled) continue;
-			const modelEntry = getStepDefinition(step.addonId).models.find((m) => m.id === step.modelId);
+			const modelEntry = await this.resolveModelEntry(step.addonId, step.modelId);
 			if (!modelEntry) continue;
-			if (require_model_download_service_C7AjBsX9.isModelDownloaded(this.modelsDir, modelEntry, format)) continue;
+			if (require_model_download_service_C_IHWnXx.isModelDownloaded(this.modelsDir, modelEntry, format)) continue;
 			await this.downloadWithRetry(modelEntry, format, 3);
 		}
 	}
@@ -4503,10 +4581,44 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 			return { hardware: null };
 		}
 	}
+	/**
+	* Pull custom models from the `custom-model-registry` collection cap,
+	* grouped by step id. 5s TTL cache. Fully graceful: when no provider is
+	* registered (or the query fails) it returns an empty map and logs at most
+	* a warning — callers then behave exactly like the static-catalog path.
+	*/
+	async getCustomModels() {
+		const now = Date.now();
+		if (this.customModelsCache && now - this.customModelsCache.at < 5e3) return this.customModelsCache.byStep;
+		let byStep = /* @__PURE__ */ new Map();
+		try {
+			const api = this.addonCtx?.api;
+			if (api) {
+				if ((await api.addons.listCapabilityProviders.query({ capName: "custom-model-registry" })).some((p) => p.isActive)) byStep = groupCustomModelsByStep(await api.customModelRegistry.listModels.query());
+			}
+		} catch (err) {
+			this.log.warn("custom-model-registry query failed — using static catalog only", { meta: { error: require_dist.errMsg(err) } });
+		}
+		this.customModelsCache = {
+			at: now,
+			byStep
+		};
+		return byStep;
+	}
+	/**
+	* Resolve a model id within a step to a catalog entry — static catalog
+	* first, then the custom registry. Returns undefined if neither has it.
+	*/
+	async resolveModelEntry(addonId, modelId) {
+		const fromCatalog = getStepDefinition(addonId).models.find((m) => m.id === modelId);
+		if (fromCatalog) return fromCatalog;
+		return (await this.getCustomModels()).get(addonId)?.find((m) => m.id === modelId);
+	}
 	async getSchema(engine) {
 		if (!engine || !engine.runtime) engine = await this.getSelectedEngine();
 		const format = engine.format;
-		const slots = buildSchemaSlots(format, this.modelsDir);
+		const customByStep = await this.getCustomModels();
+		const slots = buildSchemaSlots(format, this.modelsDir, customByStep);
 		const { hardware } = await this.fetchProbeGatingData();
 		const env = runtimeEnvFromProcess(toProbedHardware(hardware));
 		return {
@@ -4635,7 +4747,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 				const formats = {};
 				for (const [formatKey, entry] of Object.entries(m.formats)) {
 					if (!entry) continue;
-					const downloaded = require_model_download_service_C7AjBsX9.isModelDownloaded(this.modelsDir, m, formatKey);
+					const downloaded = require_model_download_service_C_IHWnXx.isModelDownloaded(this.modelsDir, m, formatKey);
 					formats[formatKey] = {
 						url: entry.url,
 						sizeMB: entry.sizeMB,
@@ -4693,7 +4805,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 	}
 	async downloadModel(input) {
 		const { modelId, format, addonId } = input;
-		const modelEntry = getStepDefinition(addonId).models.find((m) => m.id === modelId);
+		const modelEntry = await this.resolveModelEntry(addonId, modelId);
 		if (!modelEntry) throw new Error(`Model "${modelId}" not found in step "${addonId}" catalog`);
 		const formatEntry = modelEntry.formats[format];
 		if (!formatEntry) throw new Error(`Model "${modelId}" has no ${format} format. Available: ${Object.keys(modelEntry.formats).join(", ")}`);
@@ -4756,9 +4868,9 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 	}
 	async deleteModel(input) {
 		const { modelId, format, addonId } = input;
-		const modelEntry = getStepDefinition(addonId).models.find((m) => m.id === modelId);
+		const modelEntry = await this.resolveModelEntry(addonId, modelId);
 		if (!modelEntry) throw new Error(`Model "${modelId}" not found in step "${addonId}" catalog`);
-		if (!require_model_download_service_C7AjBsX9.deleteModelFromDisk(this.modelsDir, modelEntry, format)) throw new Error(`Model "${modelId}" (${format}) is not downloaded — nothing to delete`);
+		if (!require_model_download_service_C_IHWnXx.deleteModelFromDisk(this.modelsDir, modelEntry, format)) throw new Error(`Model "${modelId}" (${format}) is not downloaded — nothing to delete`);
 		this.log.info("Model deleted from disk", { meta: {
 			modelId,
 			format
@@ -5212,8 +5324,8 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 		const work = (async () => {
 			const format = this.currentEngine?.format ?? "onnx";
 			for (const step of needed) {
-				const modelEntry = getStepDefinition(step.addonId).models.find((m) => m.id === step.modelId);
-				if (modelEntry && !require_model_download_service_C7AjBsX9.isModelDownloaded(this.modelsDir, modelEntry, format)) {
+				const modelEntry = await this.resolveModelEntry(step.addonId, step.modelId);
+				if (modelEntry && !require_model_download_service_C_IHWnXx.isModelDownloaded(this.modelsDir, modelEntry, format)) {
 					this.log.info("Downloading model for step", { meta: {
 						modelId: step.modelId,
 						format,
@@ -5238,7 +5350,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 	/** Download a model with retry + exponential backoff */
 	async downloadWithRetry(entry, format, maxRetries, onProgress) {
 		for (let attempt = 1; attempt <= maxRetries; attempt++) try {
-			await require_model_download_service_C7AjBsX9.ensureModel(this.modelsDir, entry, format, onProgress);
+			await require_model_download_service_C_IHWnXx.ensureModel(this.modelsDir, entry, format, onProgress);
 			this.log.info("Model downloaded successfully", { meta: { modelId: entry.id } });
 			return;
 		} catch (err) {
@@ -5707,7 +5819,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 		const format = this.currentEngine.format;
 		const downloads = [];
 		for (const step of flattenSteps(steps)) {
-			const modelEntry = getStepDefinition(step.addonId).models.find((m) => m.id === step.modelId);
+			const modelEntry = await this.resolveModelEntry(step.addonId, step.modelId);
 			if (!modelEntry) {
 				this.log.warn("Model not found in step catalog — skipping download", { meta: {
 					modelId: step.modelId,
@@ -5715,11 +5827,11 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 				} });
 				continue;
 			}
-			if (!require_model_download_service_C7AjBsX9.isModelDownloaded(this.modelsDir, modelEntry, format)) this.log.info("Downloading model", { meta: {
+			if (!require_model_download_service_C_IHWnXx.isModelDownloaded(this.modelsDir, modelEntry, format)) this.log.info("Downloading model", { meta: {
 				modelId: step.modelId,
 				format
 			} });
-			downloads.push(require_model_download_service_C7AjBsX9.ensureModel(this.modelsDir, modelEntry, format).then(() => {}));
+			downloads.push(require_model_download_service_C_IHWnXx.ensureModel(this.modelsDir, modelEntry, format).then(() => {}));
 		}
 		await Promise.all(downloads);
 		await this.ensureBackendDeps(this.currentEngine);
@@ -6110,11 +6222,11 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 		}
 	}
 };
-function buildSchemaSlots(format, modelsDir) {
+function buildSchemaSlots(format, modelsDir, customByStep) {
 	const slotMap = /* @__PURE__ */ new Map();
 	for (const pipelineStep of ALL_PIPELINE_STEPS) {
 		const step = pipelineStep.definition;
-		const availableModels = step.models.filter((m) => m.formats[format]);
+		const availableModels = mergeCustomModels(step.models, customByStep?.get(step.id) ?? []).filter((m) => m.formats[format]);
 		if (availableModels.length === 0) continue;
 		const slot = step.slot;
 		if (!slotMap.has(slot)) slotMap.set(slot, []);
@@ -6130,7 +6242,7 @@ function buildSchemaSlots(format, modelsDir) {
 				id: m.id,
 				name: m.name,
 				formats: Object.fromEntries(Object.entries(m.formats).map(([f, entry]) => [f, {
-					downloaded: require_model_download_service_C7AjBsX9.isModelDownloaded(modelsDir, m, f),
+					downloaded: require_model_download_service_C_IHWnXx.isModelDownloaded(modelsDir, m, f),
 					sizeMB: entry.sizeMB
 				}]))
 			})),
@@ -6219,8 +6331,7 @@ function buildDefaultStepTree(format) {
 		makeStep("animal-classifier", [], { enabled: false }),
 		makeStep("bird-classifier", [], { enabled: false }),
 		makeStep("vehicle-classifier", [], { enabled: false }),
-		makeStep("segmentation-refiner", [], { enabled: false }),
-		makeStep("instance-segmentation", [], { enabled: false })
+		makeStep("segmentation", [], { enabled: false })
 	].filter((s) => s !== null));
 	const audioEngine = getDefaultModelForFormat("audio-classifier", format) === "apple-soundanalysis" ? {
 		runtime: "python",
@@ -6510,8 +6621,7 @@ var DetectionPipelineAddon = class extends require_dist.BaseAddon {
 					label: "Execution provider",
 					options: [...STATIC_BACKEND_OPTIONS],
 					default: DEFAULT_CONFIG.engineBackend,
-					immediate: true,
-					requiresRestart: true
+					immediate: true
 				}),
 				this.field({
 					type: "select",
@@ -6519,8 +6629,7 @@ var DetectionPipelineAddon = class extends require_dist.BaseAddon {
 					label: "Hardware device",
 					options: [...STATIC_DEFAULT_DEVICE_OPTIONS],
 					default: DEFAULT_CONFIG.engineDevice,
-					immediate: true,
-					requiresRestart: true
+					immediate: true
 				})
 			]
 		}, {
@@ -6559,8 +6668,7 @@ var DetectionPipelineAddon = class extends require_dist.BaseAddon {
 							"onnx",
 							"cpu"
 						]
-					},
-					requiresRestart: true
+					}
 				}),
 				this.field({
 					type: "slider",
@@ -6577,8 +6685,7 @@ var DetectionPipelineAddon = class extends require_dist.BaseAddon {
 					showWhen: {
 						field: "batchMode",
 						notEquals: "none"
-					},
-					requiresRestart: true
+					}
 				}),
 				this.field({
 					type: "slider",
@@ -6595,8 +6702,7 @@ var DetectionPipelineAddon = class extends require_dist.BaseAddon {
 					showWhen: {
 						field: "batchMode",
 						notEquals: "none"
-					},
-					requiresRestart: true
+					}
 				}),
 				this.field({
 					type: "slider",
@@ -6609,8 +6715,7 @@ var DetectionPipelineAddon = class extends require_dist.BaseAddon {
 					default: void 0,
 					showValue: true,
 					nullable: true,
-					nullLabel: "Auto",
-					requiresRestart: true
+					nullLabel: "Auto"
 				}),
 				this.field({
 					type: "slider",
@@ -6623,8 +6728,7 @@ var DetectionPipelineAddon = class extends require_dist.BaseAddon {
 					default: void 0,
 					showValue: true,
 					nullable: true,
-					nullLabel: "Auto",
-					requiresRestart: true
+					nullLabel: "Auto"
 				})
 			]
 		}] });
@@ -6887,6 +6991,9 @@ var DetectionPipelineAddon = class extends require_dist.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();
@@ -6994,16 +7101,17 @@ var DetectionPipelineAddon = class extends require_dist.BaseAddon {
 		return false;
 	}
 	/**
-	* BaseAddon calls `onConfigChanged` after every settings write.
-	* Group-runner addons can't honour the schema's `requiresRestart:
-	* true` flag (the restart cap returns "process not found" for
-	* processes spawned in a kernel group worker). To make tuning
-	* changes actually take effect, watch the pool-bound subset and
-	* respawn the provider in place when it flips.
-	*
-	* Engine cascade (`engineRuntime/Backend/Device`) and audio
-	* settings don't require this — those still rely on the addon
-	* lifecycle (engineFactory rebuild on next runPipeline).
+	* BaseAddon calls `onConfigChanged` after every settings write. This is the
+	* SOLE apply path for engine + tuning changes — none of those fields declare
+	* `requiresRestart` anymore (an addon restart re-probes hardware + reloads
+	* every model on every set, which is exactly what we want to avoid). Instead:
+	*  - Pool-bound tuning (`concurrency`/`batchMode`/`windowMs`/…) → in-place
+	*    pool respawn when the snapshot flips (`poolConfigChanged` below).
+	*  - Engine cascade (`engineBackend`/`engineDevice`) → the provider's
+	*    `onEngineSelectionChanged` disposes the device-bound factory so the next
+	*    runPipeline rebuilds the pool on the new selection, in place.
+	* Both apply optimistically — the inference gate stays closed for the short
+	* re-spin, frames are dropped (never crashed), no addon bounce.
 	*/
 	async onConfigChanged() {
 		await this.refreshNodeEngineFromStore();