@camstack/addon-pipeline 1.2.332 → 1.2.334

package/THIRD_PARTY_MODELS.md

@@ -48,7 +48,7 @@ under [Non-commercial models](#non-commercial-models).
 
 Training data under attribution terms:
 
-- **COCO 2017** (training data of `yolo26n` and 50 more): annotations CC-BY-4.0; images under their Flickr owners' terms. https://cocodataset.org/#termsofuse
+- **COCO 2017** (training data of `yolo26n-seg` and 50 more): annotations CC-BY-4.0; images under their Flickr owners' terms. https://cocodataset.org/#termsofuse
 - **WIDER FACE** (training data of `yunet-2023mar`): research-oriented terms; images CC BY-NC-ND. http://shuoyang1213.me/WIDERFACE/
 - **Open Images V7** (training data of `animal-classifier`): annotations CC-BY-4.0 (Google LLC); images listed as CC-BY-2.0, no warranty. https://storage.googleapis.com/openimages/web/factsfigures_v7.html
 - **DrBimmer/vehicle-classification** (training data of `vehicle-type-v1`): CC-BY-NC-4.0 — treated as binding the trained weights (conservative reading). https://huggingface.co/datasets/DrBimmer/vehicle-classification
@@ -62,7 +62,7 @@ Training data under attribution terms:
   cards link here instead of repeating it.
 -->
 
-The folders `objectDetection/yolo26`, `objectDetection/yolov9` and `segmentation/yolo26-seg` of the model mirror hold Ultralytics weights,
+The folders `segmentation/yolo26-seg`, `objectDetection/yolo26` and `objectDetection/yolov9` of the model mirror hold Ultralytics weights,
 modified by CamStack and distributed under AGPL-3.0. Their Corresponding Source
 is published in the mirror itself, in its **`source/`** folder,
 **https://huggingface.co/camstack/camstack-models/tree/main/source**, together
@@ -120,6 +120,7 @@ entry kept resolvable for a saved selection but no longer offered.
 
 | Catalog ids | Upstream | Code / weights | Training data | CamStack changes | Downloaded from |
 | --- | --- | --- | --- | --- | --- |
+| `yolo26n-seg`, `yolo26s-seg`, `yolo26m-seg` | [Ultralytics](https://github.com/ultralytics/ultralytics) | AGPL-3.0 / AGPL-3.0 (`AGPL-3.0.txt`) | COCO 2017: annotations CC-BY-4.0; images under their Flickr owners' terms | exported to ONNX, OpenVINO IR and CoreML | mirror `segmentation/yolo26-seg` |
 | `yolo26n` (default), `yolo26s`, `yolo26m`, `yolo26l`, `yolo26x` (hidden), `yolo26n-fp16` (hidden), `yolo26n-int8`, `yolo26s-fp16` (hidden), `yolo26s-int8`, `yolo26m-fp16` (hidden), `yolo26m-int8`, `yolo26l-fp16` (hidden), `yolo26l-int8`, `yolo26n-320`, `yolo26n-320-int8`, `yolo26n-256`, `yolo26n-256-int8`, `yolo26s-320`, `yolo26s-320-int8`, `yolo26s-256`, `yolo26s-256-int8`, `yolo26m-320`, `yolo26m-320-int8`, `yolo26m-256`, `yolo26m-256-int8`, `yolo26l-320`, `yolo26l-320-int8`, `yolo26l-256`, `yolo26l-256-int8`, `yolo26x-fp16` (hidden), `yolo26x-int8` (hidden) | [Ultralytics](https://github.com/ultralytics/ultralytics) | AGPL-3.0 / AGPL-3.0 (`AGPL-3.0.txt`) | COCO 2017: annotations CC-BY-4.0; images under their Flickr owners' terms | exported to ONNX, OpenVINO IR and CoreML (scripts/build-camstack-models.py); OpenVINO FP16 export; exported to OpenVINO IR, then OpenVINO NNCF INT8 post-training quantisation; re-exported at 320×320 to ONNX, OpenVINO IR and CoreML; re-exported at 320×320 to OpenVINO IR; OpenVINO NNCF INT8 post-training quantisation; re-exported at 256×256 to ONNX, OpenVINO IR and CoreML; re-exported at 256×256 to OpenVINO IR; OpenVINO NNCF INT8 post-training quantisation | mirror `objectDetection/yolo26` |
 | `ssd-mobilenet-v2-coco-edgetpu` (default) | [Google Coral test_data](https://github.com/google-coral/test_data) | Apache-2.0 / Apache-2.0 (`Apache-2.0.txt`) | COCO 2017: annotations CC-BY-4.0; images under their Flickr owners' terms | none | https://github.com/google-coral/test_data |
 | `yolov9t-320`, `yolov9t-320-int8`, `yolov9t-640`, `yolov9t-640-int8`, `yolov9s-320`, `yolov9s-320-int8`, `yolov9s-640`, `yolov9s-640-int8`, `yolov9m-320`, `yolov9m-320-int8`, `yolov9m-640`, `yolov9m-640-int8`, `yolov9c-320`, `yolov9c-320-int8`, `yolov9c-640`, `yolov9c-640-int8` | [Ultralytics](https://github.com/ultralytics/ultralytics) | AGPL-3.0 / AGPL-3.0 (`AGPL-3.0.txt`) | COCO 2017: annotations CC-BY-4.0; images under their Flickr owners' terms | exported at 320×320 to ONNX, OpenVINO IR FP16 and CoreML; exported at 320×320 to OpenVINO IR; OpenVINO NNCF INT8 post-training quantisation; exported at 640×640 to ONNX, OpenVINO IR FP16 and CoreML; exported at 640×640 to OpenVINO IR; OpenVINO NNCF INT8 post-training quantisation | mirror `objectDetection/yolov9` |
@@ -190,12 +191,6 @@ entry kept resolvable for a saved selection but no longer offered.
 | --- | --- | --- | --- | --- | --- |
 | `u2netp` (default) | [xuebinqin/U-2-Net](https://github.com/xuebinqin/U-2-Net) | Apache-2.0 / Apache-2.0 (`Apache-2.0.txt`) | DUTS-TR: not checked | converted to ONNX, OpenVINO IR and CoreML | mirror `segmentationRefiner/u2netp` |
 
-### Instance segmentation (dormant step)
-
-| Catalog ids | Upstream | Code / weights | Training data | CamStack changes | Downloaded from |
-| --- | --- | --- | --- | --- | --- |
-| `yolo26n-seg`, `yolo26s-seg`, `yolo26m-seg` | [Ultralytics](https://github.com/ultralytics/ultralytics) | AGPL-3.0 / AGPL-3.0 (`AGPL-3.0.txt`) | COCO 2017: annotations CC-BY-4.0; images under their Flickr owners' terms | exported to ONNX, OpenVINO IR and CoreML | mirror `segmentation/yolo26-seg` |
-
 ### Audio
 
 | Catalog ids | Upstream | Code / weights | Training data | CamStack changes | Downloaded from |

package/dist/audio-analyzer/index.js

@@ -3,8 +3,8 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../chunk-emK7D4bc.js");
-const require_dist = require("../dist-DJV7Z6Bb.js");
-const require_process_memory = require("../process-memory-BJb7Ihdp.js");
+const require_dist = require("../dist-C7v30DMP.js");
+const require_process_memory = require("../process-memory-CaDpfUdM.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
 let node_path = require("node:path");

package/dist/audio-analyzer/index.mjs

@@ -1,6 +1,6 @@
 import { n as __require } from "../chunk-DnnnRqeS.mjs";
-import { Cn as errMsg, D as HF_BASE_URL, J as audioAnalysisCapability, Ln as nodePin, Mn as expandAudioChunkToF32le, N as PoolMemoryWatchdog, Nn as hydrateSchema, On as audioChunkBytesPerSample, Tn as BaseAddon, Y as audioAnalyzerCapability, er as EventCategory, h as DEFAULT_AUDIO_ANALYZER_CONFIG, jt as mapAudioLabelToMacro, r as AUDIO_BACKEND_CHOICES, tn as resolvePoolMemoryPolicy } from "../dist-BsT15i7i.mjs";
-import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-1mAUV8S1.mjs";
+import { Cn as errMsg, D as HF_BASE_URL, J as audioAnalysisCapability, Ln as nodePin, Mn as expandAudioChunkToF32le, N as PoolMemoryWatchdog, Nn as hydrateSchema, On as audioChunkBytesPerSample, Tn as BaseAddon, Y as audioAnalyzerCapability, er as EventCategory, h as DEFAULT_AUDIO_ANALYZER_CONFIG, jt as mapAudioLabelToMacro, r as AUDIO_BACKEND_CHOICES, tn as resolvePoolMemoryPolicy } from "../dist-Dn3knu_K.mjs";
+import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-Dp-4bFOp.mjs";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";
 import { downloadFile } from "@camstack/system/addon-utils";

package/dist/{default-detection-model-Biwf5-ML.js → custom-model-catalog-CVeosmYm.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-DJV7Z6Bb.js");
+const require_dist = require("./dist-C7v30DMP.js");
 const require_worker_protocol = require("./worker-protocol-C-G8qmye.js");
 let node_crypto = require("node:crypto");
 //#region src/detection-pipeline/registry/effective-confidence.ts
@@ -447,6 +447,10 @@ var yolo26Reduced = (tier, res, sizes) => {
 		formats: { openvino: ovFormat(hf(`objectDetection/yolo26/openvino/camstack-yolo26${tier}-${res}-int8.xml`), sizes.ovInt8) }
 	}];
 };
+/** Variant family of the YOLO26 builds with an instance-segmentation head. */
+var YOLO26_SEG_FAMILY = "yolo26-seg";
+/** What choosing a seg build as the root means, in the catalog's own words. */
+var YOLO26_SEG_ROOT_NOTE = "As the root model it detects like YOLO26 and also supplies the Segmentation step its masks (detection + masks, slightly heavier).";
 var OBJECT_DETECTION_MODELS = [
 	{
 		id: "yolo26n",
@@ -617,6 +621,102 @@ var OBJECT_DETECTION_MODELS = [
 			runtimes: ["python"]
 		} }
 	},
+	{
+		id: "yolo26n-seg",
+		license: licensed(ULTRALYTICS_AGPL, { modifications: "exported to ONNX, OpenVINO IR and CoreML" }),
+		group: {
+			family: YOLO26_SEG_FAMILY,
+			tier: "n",
+			resolution: 640
+		},
+		name: "YOLO26-seg Nano",
+		description: `YOLO26 Nano with its instance-segmentation head — ultra-lightweight. ${YOLO26_SEG_ROOT_NOTE}`,
+		inputSize: {
+			width: 640,
+			height: 640
+		},
+		labels: [],
+		preprocessMode: "letterbox",
+		postprocessor: "yolo-seg",
+		formats: {
+			onnx: {
+				url: hf("segmentation/yolo26-seg/onnx/camstack-yolo26n-seg.onnx"),
+				sizeMB: 11
+			},
+			coreml: {
+				url: hf("segmentation/yolo26-seg/coreml/camstack-yolo26n-seg.mlpackage"),
+				sizeMB: 6,
+				isDirectory: true,
+				files: [...MLPACKAGE_FILES],
+				runtimes: ["python"]
+			},
+			openvino: ovFormat(hf("segmentation/yolo26-seg/openvino/camstack-yolo26n-seg.xml"), 11)
+		}
+	},
+	{
+		id: "yolo26s-seg",
+		license: licensed(ULTRALYTICS_AGPL, { modifications: "exported to ONNX, OpenVINO IR and CoreML" }),
+		group: {
+			family: YOLO26_SEG_FAMILY,
+			tier: "s",
+			resolution: 640
+		},
+		name: "YOLO26-seg Small",
+		description: `YOLO26 Small with its instance-segmentation head — balanced. ${YOLO26_SEG_ROOT_NOTE}`,
+		inputSize: {
+			width: 640,
+			height: 640
+		},
+		labels: [],
+		preprocessMode: "letterbox",
+		postprocessor: "yolo-seg",
+		formats: {
+			onnx: {
+				url: hf("segmentation/yolo26-seg/onnx/camstack-yolo26s-seg.onnx"),
+				sizeMB: 40
+			},
+			coreml: {
+				url: hf("segmentation/yolo26-seg/coreml/camstack-yolo26s-seg.mlpackage"),
+				sizeMB: 20,
+				isDirectory: true,
+				files: [...MLPACKAGE_FILES],
+				runtimes: ["python"]
+			},
+			openvino: ovFormat(hf("segmentation/yolo26-seg/openvino/camstack-yolo26s-seg.xml"), 40)
+		}
+	},
+	{
+		id: "yolo26m-seg",
+		license: licensed(ULTRALYTICS_AGPL, { modifications: "exported to ONNX, OpenVINO IR and CoreML" }),
+		group: {
+			family: YOLO26_SEG_FAMILY,
+			tier: "m",
+			resolution: 640
+		},
+		name: "YOLO26-seg Medium",
+		description: `YOLO26 Medium with its instance-segmentation head — high accuracy. ${YOLO26_SEG_ROOT_NOTE}`,
+		inputSize: {
+			width: 640,
+			height: 640
+		},
+		labels: [],
+		preprocessMode: "letterbox",
+		postprocessor: "yolo-seg",
+		formats: {
+			onnx: {
+				url: hf("segmentation/yolo26-seg/onnx/camstack-yolo26m-seg.onnx"),
+				sizeMB: 90
+			},
+			coreml: {
+				url: hf("segmentation/yolo26-seg/coreml/camstack-yolo26m-seg.mlpackage"),
+				sizeMB: 45,
+				isDirectory: true,
+				files: [...MLPACKAGE_FILES],
+				runtimes: ["python"]
+			},
+			openvino: ovFormat(hf("segmentation/yolo26-seg/openvino/camstack-yolo26m-seg.xml"), 90)
+		}
+	},
 	ovPrecisionVariant("yolo26n", "objectDetection/yolo26/openvino", "YOLO26 Nano", "fp16", 5, true),
 	ovPrecisionVariant("yolo26n", "objectDetection/yolo26/openvino", "YOLO26 Nano", "int8", 3),
 	ovPrecisionVariant("yolo26s", "objectDetection/yolo26/openvino", "YOLO26 Small", "fp16", 19, true),
@@ -1030,86 +1130,13 @@ var SEGMENTATION_REFINER_MODELS = [{
 		openvino: ovFormat(hf("segmentationRefiner/u2netp/openvino/camstack-u2netp.xml"), 2.5)
 	}
 }];
-var INSTANCE_SEGMENTATION_MODELS = [
-	{
-		id: "yolo26n-seg",
-		license: licensed(ULTRALYTICS_AGPL, { modifications: "exported to ONNX, OpenVINO IR and CoreML" }),
-		name: "YOLO26 Nano Seg",
-		description: "YOLO26 Nano Segmentation — ultra-lightweight instance segmentation with masks",
-		inputSize: {
-			width: 640,
-			height: 640
-		},
-		labels: [],
-		preprocessMode: "letterbox",
-		formats: {
-			onnx: {
-				url: hf("segmentation/yolo26-seg/onnx/camstack-yolo26n-seg.onnx"),
-				sizeMB: 11
-			},
-			coreml: {
-				url: hf("segmentation/yolo26-seg/coreml/camstack-yolo26n-seg.mlpackage"),
-				sizeMB: 6,
-				isDirectory: true,
-				files: [...MLPACKAGE_FILES],
-				runtimes: ["python"]
-			},
-			openvino: ovFormat(hf("segmentation/yolo26-seg/openvino/camstack-yolo26n-seg.xml"), 11)
-		}
-	},
-	{
-		id: "yolo26s-seg",
-		license: licensed(ULTRALYTICS_AGPL, { modifications: "exported to ONNX, OpenVINO IR and CoreML" }),
-		name: "YOLO26 Small Seg",
-		description: "YOLO26 Small Segmentation — balanced instance segmentation",
-		inputSize: {
-			width: 640,
-			height: 640
-		},
-		labels: [],
-		preprocessMode: "letterbox",
-		formats: {
-			onnx: {
-				url: hf("segmentation/yolo26-seg/onnx/camstack-yolo26s-seg.onnx"),
-				sizeMB: 40
-			},
-			coreml: {
-				url: hf("segmentation/yolo26-seg/coreml/camstack-yolo26s-seg.mlpackage"),
-				sizeMB: 20,
-				isDirectory: true,
-				files: [...MLPACKAGE_FILES],
-				runtimes: ["python"]
-			},
-			openvino: ovFormat(hf("segmentation/yolo26-seg/openvino/camstack-yolo26s-seg.xml"), 40)
-		}
-	},
-	{
-		id: "yolo26m-seg",
-		license: licensed(ULTRALYTICS_AGPL, { modifications: "exported to ONNX, OpenVINO IR and CoreML" }),
-		name: "YOLO26 Medium Seg",
-		description: "YOLO26 Medium Segmentation — high-accuracy instance segmentation",
-		inputSize: {
-			width: 640,
-			height: 640
-		},
-		labels: [],
-		preprocessMode: "letterbox",
-		formats: {
-			onnx: {
-				url: hf("segmentation/yolo26-seg/onnx/camstack-yolo26m-seg.onnx"),
-				sizeMB: 90
-			},
-			coreml: {
-				url: hf("segmentation/yolo26-seg/coreml/camstack-yolo26m-seg.mlpackage"),
-				sizeMB: 45,
-				isDirectory: true,
-				files: [...MLPACKAGE_FILES],
-				runtimes: ["python"]
-			},
-			openvino: ovFormat(hf("segmentation/yolo26-seg/openvino/camstack-yolo26m-seg.xml"), 90)
-		}
-	}
-];
+/**
+* The dormant `instance-segmentation` step's catalog: the YOLO26-seg entries of
+* {@link OBJECT_DETECTION_MODELS}, by reference. One entry per model (D703) —
+* the artifact lives once, in the root's catalog, where it can be selected as
+* the camera root and supply the `segmentation` step's masks (D737).
+*/
+var INSTANCE_SEGMENTATION_MODELS = OBJECT_DETECTION_MODELS.filter((m) => m.group?.family === YOLO26_SEG_FAMILY);
 var CLIP_EMBEDDING_MODELS = [{
 	id: "siglip2-b16-224",
 	license: SIGLIP2_APACHE,
@@ -1391,7 +1418,7 @@ var AnimalClassifierStep = class {
 		labelTier: 1,
 		models: [...ANIMAL_CLASSIFIER_MODELS],
 		defaultModelId: "animal-classifier",
-		enabledByDefault: false,
+		enabledByDefault: true,
 		defaultConfidence: .5,
 		labels: [...ANIMAL_10_LABELS],
 		cadence: {
@@ -1705,7 +1732,7 @@ var STEP_VEHICLE_CLASSIFIER = new VehicleClassifierStep({
 	labelTier: 1,
 	models: [...VEHICLE_CLASSIFIER_MODELS],
 	defaultModelId: "vehicle-type-v1",
-	enabledByDefault: false,
+	enabledByDefault: true,
 	defaultConfidence: .5,
 	cadence: {
 		trigger: "once",
@@ -2959,6 +2986,120 @@ function rootObjectGate(steps) {
 	return (steps?.find((s) => s.enabled !== false))?.settings;
 }
 //#endregion
+//#region src/detection-pipeline/default-detection-model.ts
+/** The object-detection step id — the only slot this resolver applies to. */
+var OBJECT_DETECTION_STEP_ID = "object-detection";
+/**
+* Balanced default object-detection model per accelerator class. `'cpu'` maps to
+* `null` → the caller substitutes the step's own `defaultModelId` (`yolo26n`).
+* INTEL NPU + iGPU default to the Ultralytics YOLOv9 re-export (int8 @320): yolo26 does NOT compile on
+* the Intel NPU (arch incompat → 0 frames), while yolov9 runs on it (~298 fps
+* measured). Apple ANE uses the CoreML yolov9 @320 build.
+*
+* Do **not** promote these ids to `yolov9m-640` / `*-640`. The controlled
+* evaluation recovered 0/3 misses at the current 0.50 threshold and failed the
+* false-positive and capacity gates — see
+* `docs/benchmarks/pipeline-frame-model-eval.md`. 640 remains an explicit
+* operator pick, not a hardware-aware default.
+*/
+var MODEL_BY_CLASS = {
+	"apple-ane": "yolov9m-320",
+	"intel-npu": "yolov9m-320-int8",
+	"intel-gpu": "yolov9m-320-int8",
+	cpu: null
+};
+/**
+* Classify a node's engine into an {@link AcceleratorClass} from its resolved
+* `backend` + `device`. Pure, total, never throws.
+*
+* OpenVINO's default device is `'auto'` (the python pool resolves NPU > GPU >
+* CPU at load). Because OpenVINO is only ever OFFERED when an Intel iGPU is
+* present, the GPU is the guaranteed accelerator while the NPU is an explicit
+* opt-in — so `'auto'` (and any non-cpu/non-npu device) is treated as
+* GPU-class conservatively. An operator who explicitly pins `device: 'npu'`
+* gets the NPU-tuned m-320.
+*
+* Also accepts the accelerator carried in the `backend` slot (e.g. `'ane'`,
+* `'mps'`, `'npu'`, `'intel-gpu'`) so a caller passing a device-style backend
+* still classifies correctly — real callers pass onnx/openvino/coreml.
+*/
+function classifyAccelerator(backend, device) {
+	const b = backend.toLowerCase();
+	const d = device?.toLowerCase() ?? null;
+	if (b === "coreml" || b === "ane" || b === "mps") return "apple-ane";
+	if (b === "openvino") {
+		if (d === "npu") return "intel-npu";
+		if (d === "cpu") return "cpu";
+		return "intel-gpu";
+	}
+	if (b === "npu" || b === "intel-npu") return "intel-npu";
+	if (b === "gpu" || b === "intel-gpu" || b === "gpu-openvino") return "intel-gpu";
+	return "cpu";
+}
+/**
+* Resolve the hardware-aware default object-detection model id for a node's
+* engine `(backend, device, format)`.
+*
+* Guarantees:
+*   - never throws (hot default-tree path);
+*   - never returns a model id without a build for `format` (unless the step
+*     has ZERO builds for `format`, which is unloadable regardless of pick and
+*     flagged by `collectZeroBuildIssues`) — an unmapped backend, a `'cpu'`
+*     class, a mapped id missing from the catalog, or a mapped id without a
+*     `format` build all fall back to the step's PER-FORMAT default
+*     (`getDefaultModelForFormatFromDef`), NOT the bare `defaultModelId`.
+*
+* `getStepDef` is injectable (defaults to the real catalog lookup) so the
+* missing-build fallback branch is unit-testable without a live catalog —
+* mirrors `collectZeroBuildIssues`' injection seam.
+*/
+function resolveDefaultDetectionModel(backend, device, format, getStepDef = getStepDefinition) {
+	let def;
+	try {
+		def = getStepDef(OBJECT_DETECTION_STEP_ID);
+	} catch {
+		return "yolo26n";
+	}
+	const candidate = MODEL_BY_CLASS[classifyAccelerator(backend, device)];
+	if (candidate !== null) {
+		const entry = def.models.find((m) => m.id === candidate);
+		if (entry && entry.formats[format] !== void 0) return candidate;
+	}
+	return getDefaultModelForFormatFromDef(def, format);
+}
+//#endregion
+//#region src/detection-pipeline/engine/resolve-device-engine.ts
+/**
+* Resolve a Phase-1 device key (`<backend>:<device>`, or bare `cpu`) into the
+* {@link PipelineEngineChoice} used to build that device's inference pool.
+* Throws on an unknown backend token so a bad `deviceKey` fails loud rather
+* than silently building a wrong pool. Format comes from the shared
+* {@link DEVICE_BACKEND_TO_FORMAT} SSOT (`@camstack/types`) — no local copy.
+*/
+function resolveDeviceEngine(deviceKey) {
+	const colon = deviceKey.indexOf(":");
+	const backend = colon >= 0 ? deviceKey.slice(0, colon) : deviceKey;
+	const device = colon >= 0 ? deviceKey.slice(colon + 1) : deviceKey;
+	const format = require_dist.DEVICE_BACKEND_TO_FORMAT[backend];
+	if (format === void 0) throw new Error(`resolveDeviceEngine: unknown backend "${backend}" in deviceKey "${deviceKey}"`);
+	return {
+		runtime: "python",
+		backend,
+		format,
+		device
+	};
+}
+/**
+* The inverse of {@link resolveDeviceEngine}: the `<backend>:<device>` key that
+* names the pool an engine belongs to. Every pool-level log line carries this —
+* without it a default pool logs anonymously and six hours of logs cannot tell
+* "the NPU is unused" from "the NPU IS the anonymous default pool".
+* Falls back to the bare backend when the engine carries no device.
+*/
+function deviceKeyOf(engine) {
+	return engine.device ? `${engine.backend}:${engine.device}` : engine.backend;
+}
+//#endregion
 //#region src/pipeline-runner/device-jump.ts
 /**
 * Step-tree device jump (same-node, phase 1) — the PURE resolution core.
@@ -3268,88 +3409,6 @@ var CustomModelCatalog = class {
 	stepDefinition = (stepId) => mergedStepDefinition(stepId, this.byStep);
 };
 //#endregion
-//#region src/detection-pipeline/default-detection-model.ts
-/** The object-detection step id — the only slot this resolver applies to. */
-var OBJECT_DETECTION_STEP_ID = "object-detection";
-/**
-* Balanced default object-detection model per accelerator class. `'cpu'` maps to
-* `null` → the caller substitutes the step's own `defaultModelId` (`yolo26n`).
-* INTEL NPU + iGPU default to the Ultralytics YOLOv9 re-export (int8 @320): yolo26 does NOT compile on
-* the Intel NPU (arch incompat → 0 frames), while yolov9 runs on it (~298 fps
-* measured). Apple ANE uses the CoreML yolov9 @320 build.
-*
-* Do **not** promote these ids to `yolov9m-640` / `*-640`. The controlled
-* evaluation recovered 0/3 misses at the current 0.50 threshold and failed the
-* false-positive and capacity gates — see
-* `docs/benchmarks/pipeline-frame-model-eval.md`. 640 remains an explicit
-* operator pick, not a hardware-aware default.
-*/
-var MODEL_BY_CLASS = {
-	"apple-ane": "yolov9m-320",
-	"intel-npu": "yolov9m-320-int8",
-	"intel-gpu": "yolov9m-320-int8",
-	cpu: null
-};
-/**
-* Classify a node's engine into an {@link AcceleratorClass} from its resolved
-* `backend` + `device`. Pure, total, never throws.
-*
-* OpenVINO's default device is `'auto'` (the python pool resolves NPU > GPU >
-* CPU at load). Because OpenVINO is only ever OFFERED when an Intel iGPU is
-* present, the GPU is the guaranteed accelerator while the NPU is an explicit
-* opt-in — so `'auto'` (and any non-cpu/non-npu device) is treated as
-* GPU-class conservatively. An operator who explicitly pins `device: 'npu'`
-* gets the NPU-tuned m-320.
-*
-* Also accepts the accelerator carried in the `backend` slot (e.g. `'ane'`,
-* `'mps'`, `'npu'`, `'intel-gpu'`) so a caller passing a device-style backend
-* still classifies correctly — real callers pass onnx/openvino/coreml.
-*/
-function classifyAccelerator(backend, device) {
-	const b = backend.toLowerCase();
-	const d = device?.toLowerCase() ?? null;
-	if (b === "coreml" || b === "ane" || b === "mps") return "apple-ane";
-	if (b === "openvino") {
-		if (d === "npu") return "intel-npu";
-		if (d === "cpu") return "cpu";
-		return "intel-gpu";
-	}
-	if (b === "npu" || b === "intel-npu") return "intel-npu";
-	if (b === "gpu" || b === "intel-gpu" || b === "gpu-openvino") return "intel-gpu";
-	return "cpu";
-}
-/**
-* Resolve the hardware-aware default object-detection model id for a node's
-* engine `(backend, device, format)`.
-*
-* Guarantees:
-*   - never throws (hot default-tree path);
-*   - never returns a model id without a build for `format` (unless the step
-*     has ZERO builds for `format`, which is unloadable regardless of pick and
-*     flagged by `collectZeroBuildIssues`) — an unmapped backend, a `'cpu'`
-*     class, a mapped id missing from the catalog, or a mapped id without a
-*     `format` build all fall back to the step's PER-FORMAT default
-*     (`getDefaultModelForFormatFromDef`), NOT the bare `defaultModelId`.
-*
-* `getStepDef` is injectable (defaults to the real catalog lookup) so the
-* missing-build fallback branch is unit-testable without a live catalog —
-* mirrors `collectZeroBuildIssues`' injection seam.
-*/
-function resolveDefaultDetectionModel(backend, device, format, getStepDef = getStepDefinition) {
-	let def;
-	try {
-		def = getStepDef(OBJECT_DETECTION_STEP_ID);
-	} catch {
-		return "yolo26n";
-	}
-	const candidate = MODEL_BY_CLASS[classifyAccelerator(backend, device)];
-	if (candidate !== null) {
-		const entry = def.models.find((m) => m.id === candidate);
-		if (entry && entry.formats[format] !== void 0) return candidate;
-	}
-	return getDefaultModelForFormatFromDef(def, format);
-}
-//#endregion
 Object.defineProperty(exports, "ALL_PIPELINE_STEPS", {
 	enumerable: true,
 	get: function() {
@@ -3386,6 +3445,12 @@ Object.defineProperty(exports, "createSessionDecodeCoordinator", {
 		return createSessionDecodeCoordinator;
 	}
 });
+Object.defineProperty(exports, "deviceKeyOf", {
+	enumerable: true,
+	get: function() {
+		return deviceKeyOf;
+	}
+});
 Object.defineProperty(exports, "getDefaultModelForFormat", {
 	enumerable: true,
 	get: function() {
@@ -3446,6 +3511,12 @@ Object.defineProperty(exports, "resolveDefaultDetectionModel", {
 		return resolveDefaultDetectionModel;
 	}
 });
+Object.defineProperty(exports, "resolveDeviceEngine", {
+	enumerable: true,
+	get: function() {
+		return resolveDeviceEngine;
+	}
+});
 Object.defineProperty(exports, "resolveFrameViewGeometry", {
 	enumerable: true,
 	get: function() {