@camstack/addon-pipeline 1.1.0 → 1.1.1

package/dist/detection-pipeline/index.js

@@ -2,17 +2,17 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_model_download_service_RxAOiYvX = require("../model-download-service-RxAOiYvX-C8rTRJy_.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_RxAOiYvX.__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_RxAOiYvX.__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_RxAOiYvX.__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_RxAOiYvX.__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.
@@ -1043,6 +1043,26 @@ var ovFormat = (url, sizeMB) => {
 		...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",
@@ -1348,7 +1368,21 @@ var OBJECT_DETECTION_MODELS = [
 			},
 			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",
@@ -1795,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
@@ -2044,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",
@@ -2058,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",
@@ -2085,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 */
@@ -3257,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;
 	}
 }
@@ -3307,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 ? {
@@ -3797,6 +3848,40 @@ function walkFieldsForDefaults(fields, out) {
 	}
 }
 //#endregion
+//#region src/detection-pipeline/registry/custom-models.ts
+/**
+* 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 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;
+}
+/**
+* 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.
+*
+* Pure + side-effect-free so it can be unit-tested in isolation and called
+* from the (free) `buildSchemaSlots` builder without any addon context.
+*/
+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
 /**
 * DetectionPipelineProvider — implements IPipelineExecutorProvider.
@@ -4032,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
@@ -4360,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();
 	}
 	/**
@@ -4399,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_RxAOiYvX.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);
 		}
 	}
@@ -4477,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 {
@@ -4609,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_RxAOiYvX.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,
@@ -4667,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(", ")}`);
@@ -4730,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_RxAOiYvX.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
@@ -5186,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_RxAOiYvX.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,
@@ -5212,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_RxAOiYvX.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) {
@@ -5681,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,
@@ -5689,11 +5827,11 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 				} });
 				continue;
 			}
-			if (!require_model_download_service_RxAOiYvX.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_RxAOiYvX.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);
@@ -6084,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, []);
@@ -6104,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_RxAOiYvX.isModelDownloaded(modelsDir, m, f),
+					downloaded: require_model_download_service_C_IHWnXx.isModelDownloaded(modelsDir, m, f),
 					sizeMB: entry.sizeMB
 				}]))
 			})),
@@ -6193,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",
@@ -6484,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",
@@ -6493,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
 				})
 			]
 		}, {
@@ -6533,8 +6668,7 @@ var DetectionPipelineAddon = class extends require_dist.BaseAddon {
 							"onnx",
 							"cpu"
 						]
-					},
-					requiresRestart: true
+					}
 				}),
 				this.field({
 					type: "slider",
@@ -6551,8 +6685,7 @@ var DetectionPipelineAddon = class extends require_dist.BaseAddon {
 					showWhen: {
 						field: "batchMode",
 						notEquals: "none"
-					},
-					requiresRestart: true
+					}
 				}),
 				this.field({
 					type: "slider",
@@ -6569,8 +6702,7 @@ var DetectionPipelineAddon = class extends require_dist.BaseAddon {
 					showWhen: {
 						field: "batchMode",
 						notEquals: "none"
-					},
-					requiresRestart: true
+					}
 				}),
 				this.field({
 					type: "slider",
@@ -6583,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",
@@ -6597,8 +6728,7 @@ var DetectionPipelineAddon = class extends require_dist.BaseAddon {
 					default: void 0,
 					showValue: true,
 					nullable: true,
-					nullLabel: "Auto",
-					requiresRestart: true
+					nullLabel: "Auto"
 				})
 			]
 		}] });
@@ -6971,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();