@camstack/addon-pipeline 1.2.328 → 1.2.329

package/THIRD_PARTY_MODELS.md

@@ -134,7 +134,7 @@ entry kept resolvable for a saved selection but no longer offered.
 
 | Catalog ids | Upstream | Code / weights | Training data | CamStack changes | Downloaded from |
 | --- | --- | --- | --- | --- | --- |
-| `yunet-2023mar` (default) | [OpenCV Zoo YuNet](https://github.com/opencv/opencv_zoo/tree/main/models/face_detection_yunet) | BSD-3-Clause (`BSD-3-Clause.txt`) / MIT (`MIT-yunet-reference.txt`) | WIDER FACE: research-oriented terms; images CC BY-NC-ND | input contract baked into the graph (the pool RGB /255 becomes the upstream BGR 0..255: Mul(255) plus a channel Gather); internal tensor names cleared in the OpenVINO IR; ONNX fp32, OpenVINO IR fp32, CoreML fp16 (scripts/build-yunet-model.py) | mirror `faceDetection/yunet` |
+| `yunet-2023mar` (default) | [OpenCV Zoo YuNet](https://github.com/opencv/opencv_zoo/tree/main/models/face_detection_yunet) | BSD-3-Clause (`BSD-3-Clause.txt`) / MIT (`MIT-yunet-reference.txt`) | WIDER FACE: research-oriented terms; images CC BY-NC-ND | input contract baked into the graph (the pool RGB /255 becomes the upstream BGR 0..255: Mul(255) plus a channel Gather); internal tensor names cleared in the OpenVINO IR; ONNX fp32, OpenVINO IR fp32, CoreML fp16 (scripts/build-yunet-model.py); Edge TPU build: the bake folded into the first Conv, full-integer int8 post-training quantisation calibrated on CamStack person crops, compiled with edgetpu_compiler 14 (scripts/build-yunet-edgetpu.py) | mirror `faceDetection/yunet` |
 
 ### Face recognition
 
@@ -146,7 +146,7 @@ entry kept resolvable for a saved selection but no longer offered.
 
 | Catalog ids | Upstream | Code / weights | Training data | CamStack changes | Downloaded from |
 | --- | --- | --- | --- | --- | --- |
-| `yolox-tiny-plate` (default) | [open-lpr models (faisalthaheem/open-lpr-models), YOLOX-tiny](https://huggingface.co/faisalthaheem/open-lpr-models) | Apache-2.0 / Apache-2.0 (`Apache-2.0.txt`) | Simanno annotated plate corpus plus community-contributed photographs, pseudo-labelled by a teacher model (not published; the upstream NOTICE says the photographs were uploaded without consent obtained): UNKNOWN | input contract baked into the graph (static 1x3x640x640 RGB /255 becomes the upstream BGR 0..255: Mul(255) plus a channel Gather) and the output reshaped to the YOLOv8 layout (cx, cy, w, h, obj*cls); ONNX fp32, OpenVINO IR fp16, CoreML fp16 (scripts/build-yolox-plate-model.py) | mirror `plateDetection/yolox-tiny-plate` |
+| `yolox-tiny-plate` (default) | [open-lpr models (faisalthaheem/open-lpr-models), YOLOX-tiny](https://huggingface.co/faisalthaheem/open-lpr-models) | Apache-2.0 / Apache-2.0 (`Apache-2.0.txt`) | Simanno annotated plate corpus plus community-contributed photographs, pseudo-labelled by a teacher model (not published; the upstream NOTICE says the photographs were uploaded without consent obtained): UNKNOWN | input contract baked into the graph (static 1x3x640x640 RGB /255 becomes the upstream BGR 0..255: Mul(255) plus a channel Gather) and the output reshaped to the YOLOv8 layout (cx, cy, w, h, obj*cls); ONNX fp32, OpenVINO IR fp16, CoreML fp16 (scripts/build-yolox-plate-model.py); Edge TPU build: the Focus stem rewritten as the equivalent 6x6 stride-2 Conv with the input bake folded into it, the graph cut before the grid decode (raw per-stride head), full-integer int8 post-training quantisation calibrated on CamStack vehicle crops, compiled with edgetpu_compiler 14 (scripts/build-yolox-plate-edgetpu.py) | mirror `plateDetection/yolox-tiny-plate` |
 
 ### Licence plate reading
 

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-wJO7mXeO.js");
-const require_process_memory = require("../process-memory-iUJuTpXs.js");
+const require_dist = require("../dist-BlIWhjnu.js");
+const require_process_memory = require("../process-memory-BW06vOIQ.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 { An as hydrateSchema, F as PoolMemoryWatchdog, J as audioAnalysisCapability, Pn as nodePin, Sn as BaseAddon, Tn as audioChunkBytesPerSample, Y as audioAnalyzerCapability, Zn as EventCategory, bn as errMsg, en as resolvePoolMemoryPolicy, k as HF_BASE_URL, kn as expandAudioChunkToF32le, kt as mapAudioLabelToMacro, m as DEFAULT_AUDIO_ANALYZER_CONFIG, r as AUDIO_BACKEND_CHOICES } from "../dist-Bpub2VcJ.mjs";
-import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-BaKQ8u2G.mjs";
+import { An as hydrateSchema, F as PoolMemoryWatchdog, J as audioAnalysisCapability, Pn as nodePin, Sn as BaseAddon, Tn as audioChunkBytesPerSample, Y as audioAnalyzerCapability, Zn as EventCategory, bn as errMsg, en as resolvePoolMemoryPolicy, k as HF_BASE_URL, kn as expandAudioChunkToF32le, kt as mapAudioLabelToMacro, m as DEFAULT_AUDIO_ANALYZER_CONFIG, r as AUDIO_BACKEND_CHOICES } from "../dist-0HoA3wAi.mjs";
+import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-DuF8pa2w.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-1SadEKsW.js → default-detection-model-ChH7Y219.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-wJO7mXeO.js");
+const require_dist = require("./dist-BlIWhjnu.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
@@ -90,7 +90,7 @@ var YUNET_MIT = {
 	},
 	url: "https://github.com/opencv/opencv_zoo/blob/main/models/face_detection_yunet/LICENSE",
 	attribution: "YuNet weights Copyright (c) 2020 Shiqi Yu, MIT. Training code: ShiqiYu/libfacedetection.train, BSD-3-Clause.",
-	modifications: "input contract baked into the graph (the pool RGB /255 becomes the upstream BGR 0..255: Mul(255) plus a channel Gather); internal tensor names cleared in the OpenVINO IR; ONNX fp32, OpenVINO IR fp32, CoreML fp16 (scripts/build-yunet-model.py)",
+	modifications: "input contract baked into the graph (the pool RGB /255 becomes the upstream BGR 0..255: Mul(255) plus a channel Gather); internal tensor names cleared in the OpenVINO IR; ONNX fp32, OpenVINO IR fp32, CoreML fp16 (scripts/build-yunet-model.py); Edge TPU build: the bake folded into the first Conv, full-integer int8 post-training quantisation calibrated on CamStack person crops, compiled with edgetpu_compiler 14 (scripts/build-yunet-edgetpu.py)",
 	hosting: "camstack-hf"
 };
 var AURAFACE_APACHE = {
@@ -125,7 +125,7 @@ var OPEN_LPR_YOLOX_APACHE = {
 	},
 	url: "https://huggingface.co/faisalthaheem/open-lpr-models/blob/aed0df35ec2891c5a90437041ebeadb592cc516b/LICENSE",
 	attribution: "open-lpr models, Copyright the open-lpr contributors, Apache-2.0 (https://huggingface.co/faisalthaheem/open-lpr-models, tag detector-2026.10.1). YOLOX architecture and COCO pretraining by Megvii (https://github.com/Megvii-BaseDetection/YOLOX), Apache-2.0. The upstream NOTICE is reproduced verbatim (`NOTICE-open-lpr.txt`).",
-	modifications: "input contract baked into the graph (static 1x3x640x640 RGB /255 becomes the upstream BGR 0..255: Mul(255) plus a channel Gather) and the output reshaped to the YOLOv8 layout (cx, cy, w, h, obj*cls); ONNX fp32, OpenVINO IR fp16, CoreML fp16 (scripts/build-yolox-plate-model.py)",
+	modifications: "input contract baked into the graph (static 1x3x640x640 RGB /255 becomes the upstream BGR 0..255: Mul(255) plus a channel Gather) and the output reshaped to the YOLOv8 layout (cx, cy, w, h, obj*cls); ONNX fp32, OpenVINO IR fp16, CoreML fp16 (scripts/build-yolox-plate-model.py); Edge TPU build: the Focus stem rewritten as the equivalent 6x6 stride-2 Conv with the input bake folded into it, the graph cut before the grid decode (raw per-stride head), full-integer int8 post-training quantisation calibrated on CamStack vehicle crops, compiled with edgetpu_compiler 14 (scripts/build-yolox-plate-edgetpu.py)",
 	hosting: "camstack-hf"
 };
 var FAST_PLATE_OCR_MIT = {
@@ -752,7 +752,12 @@ var FACE_DETECTION_MODELS = [{
 			files: [...MLPACKAGE_FILES],
 			runtimes: ["python"]
 		},
-		openvino: ovFormat(hf("faceDetection/yunet/openvino/camstack-yunet-2023mar.xml"), .36)
+		openvino: ovFormat(hf("faceDetection/yunet/openvino/camstack-yunet-2023mar.xml"), .36),
+		tflite: {
+			url: hf("faceDetection/yunet/tflite/camstack-yunet-2023mar_edgetpu.tflite"),
+			sizeMB: .7,
+			runtimes: ["python"]
+		}
 	}
 }];
 var FACE_EMBEDDING_MODELS = [{
@@ -812,7 +817,12 @@ var PLATE_DETECTION_MODELS = [{
 			files: [...MLPACKAGE_FILES],
 			runtimes: ["python"]
 		},
-		openvino: ovFormat(hf("plateDetection/yolox-tiny-plate/openvino/camstack-yolox-tiny-plate.xml"), 10)
+		openvino: ovFormat(hf("plateDetection/yolox-tiny-plate/openvino/camstack-yolox-tiny-plate.xml"), 10),
+		tflite: {
+			url: hf("plateDetection/yolox-tiny-plate/tflite/camstack-yolox-tiny-plate_edgetpu.tflite"),
+			sizeMB: 6.9,
+			runtimes: ["python"]
+		}
 	}
 }];
 var PACKAGE_DETECTION_MODELS = [{

package/dist/{default-detection-model-CMeVTcPZ.mjs → default-detection-model-j0nBpRoB.mjs}

@@ -1,4 +1,4 @@
-import { A as LABEL_LINK_POLICIES, Ct as inferModelProvider, E as FILLABLE_STEP_VOCABULARIES, St as hfModelUrl, X as audioKindId, b as DEVICE_BACKEND_TO_FORMAT, f as COCO_80_LABELS, i as AUDIO_MACRO_LABELS, j as LABEL_LINK_SETTING_KEY, p as COCO_TO_MACRO, rn as stepModelRunsOnFormat, v as DEFAULT_LABEL_LINK_POLICY } from "./dist-Bpub2VcJ.mjs";
+import { A as LABEL_LINK_POLICIES, Ct as inferModelProvider, E as FILLABLE_STEP_VOCABULARIES, St as hfModelUrl, X as audioKindId, b as DEVICE_BACKEND_TO_FORMAT, f as COCO_80_LABELS, i as AUDIO_MACRO_LABELS, j as LABEL_LINK_SETTING_KEY, p as COCO_TO_MACRO, rn as stepModelRunsOnFormat, v as DEFAULT_LABEL_LINK_POLICY } from "./dist-0HoA3wAi.mjs";
 import { t as isWorkerReply } from "./worker-protocol-D_NzPcnh.mjs";
 import { randomUUID } from "node:crypto";
 //#region src/detection-pipeline/registry/effective-confidence.ts
@@ -90,7 +90,7 @@ var YUNET_MIT = {
 	},
 	url: "https://github.com/opencv/opencv_zoo/blob/main/models/face_detection_yunet/LICENSE",
 	attribution: "YuNet weights Copyright (c) 2020 Shiqi Yu, MIT. Training code: ShiqiYu/libfacedetection.train, BSD-3-Clause.",
-	modifications: "input contract baked into the graph (the pool RGB /255 becomes the upstream BGR 0..255: Mul(255) plus a channel Gather); internal tensor names cleared in the OpenVINO IR; ONNX fp32, OpenVINO IR fp32, CoreML fp16 (scripts/build-yunet-model.py)",
+	modifications: "input contract baked into the graph (the pool RGB /255 becomes the upstream BGR 0..255: Mul(255) plus a channel Gather); internal tensor names cleared in the OpenVINO IR; ONNX fp32, OpenVINO IR fp32, CoreML fp16 (scripts/build-yunet-model.py); Edge TPU build: the bake folded into the first Conv, full-integer int8 post-training quantisation calibrated on CamStack person crops, compiled with edgetpu_compiler 14 (scripts/build-yunet-edgetpu.py)",
 	hosting: "camstack-hf"
 };
 var AURAFACE_APACHE = {
@@ -125,7 +125,7 @@ var OPEN_LPR_YOLOX_APACHE = {
 	},
 	url: "https://huggingface.co/faisalthaheem/open-lpr-models/blob/aed0df35ec2891c5a90437041ebeadb592cc516b/LICENSE",
 	attribution: "open-lpr models, Copyright the open-lpr contributors, Apache-2.0 (https://huggingface.co/faisalthaheem/open-lpr-models, tag detector-2026.10.1). YOLOX architecture and COCO pretraining by Megvii (https://github.com/Megvii-BaseDetection/YOLOX), Apache-2.0. The upstream NOTICE is reproduced verbatim (`NOTICE-open-lpr.txt`).",
-	modifications: "input contract baked into the graph (static 1x3x640x640 RGB /255 becomes the upstream BGR 0..255: Mul(255) plus a channel Gather) and the output reshaped to the YOLOv8 layout (cx, cy, w, h, obj*cls); ONNX fp32, OpenVINO IR fp16, CoreML fp16 (scripts/build-yolox-plate-model.py)",
+	modifications: "input contract baked into the graph (static 1x3x640x640 RGB /255 becomes the upstream BGR 0..255: Mul(255) plus a channel Gather) and the output reshaped to the YOLOv8 layout (cx, cy, w, h, obj*cls); ONNX fp32, OpenVINO IR fp16, CoreML fp16 (scripts/build-yolox-plate-model.py); Edge TPU build: the Focus stem rewritten as the equivalent 6x6 stride-2 Conv with the input bake folded into it, the graph cut before the grid decode (raw per-stride head), full-integer int8 post-training quantisation calibrated on CamStack vehicle crops, compiled with edgetpu_compiler 14 (scripts/build-yolox-plate-edgetpu.py)",
 	hosting: "camstack-hf"
 };
 var FAST_PLATE_OCR_MIT = {
@@ -752,7 +752,12 @@ var FACE_DETECTION_MODELS = [{
 			files: [...MLPACKAGE_FILES],
 			runtimes: ["python"]
 		},
-		openvino: ovFormat(hf("faceDetection/yunet/openvino/camstack-yunet-2023mar.xml"), .36)
+		openvino: ovFormat(hf("faceDetection/yunet/openvino/camstack-yunet-2023mar.xml"), .36),
+		tflite: {
+			url: hf("faceDetection/yunet/tflite/camstack-yunet-2023mar_edgetpu.tflite"),
+			sizeMB: .7,
+			runtimes: ["python"]
+		}
 	}
 }];
 var FACE_EMBEDDING_MODELS = [{
@@ -812,7 +817,12 @@ var PLATE_DETECTION_MODELS = [{
 			files: [...MLPACKAGE_FILES],
 			runtimes: ["python"]
 		},
-		openvino: ovFormat(hf("plateDetection/yolox-tiny-plate/openvino/camstack-yolox-tiny-plate.xml"), 10)
+		openvino: ovFormat(hf("plateDetection/yolox-tiny-plate/openvino/camstack-yolox-tiny-plate.xml"), 10),
+		tflite: {
+			url: hf("plateDetection/yolox-tiny-plate/tflite/camstack-yolox-tiny-plate_edgetpu.tflite"),
+			sizeMB: 6.9,
+			runtimes: ["python"]
+		}
 	}
 }];
 var PACKAGE_DETECTION_MODELS = [{

package/dist/detection-pipeline/index.js

@@ -3,11 +3,11 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../chunk-emK7D4bc.js");
-const require_dist = require("../dist-wJO7mXeO.js");
-const require_node = require("../node-BCrqaejt.js");
-const require_default_detection_model = require("../default-detection-model-1SadEKsW.js");
+const require_dist = require("../dist-BlIWhjnu.js");
+const require_node = require("../node-BPpVMnZy.js");
+const require_default_detection_model = require("../default-detection-model-ChH7Y219.js");
 const require_lazy_sharp = require("../lazy-sharp-BuwKlQLR.js");
-const require_process_memory = require("../process-memory-iUJuTpXs.js");
+const require_process_memory = require("../process-memory-BW06vOIQ.js");
 let node_os = require("node:os");
 node_os = require_chunk.__toESM(node_os);
 let node_fs = require("node:fs");
@@ -2816,6 +2816,8 @@ var PipelineModelManager = class {
 			stepId,
 			modelId,
 			poolIndex: index,
+			path: config.path,
+			...settings !== void 0 ? { settings } : {},
 			lruTick: ++this.lruClock,
 			decode
 		};
@@ -2823,6 +2825,56 @@ var PipelineModelManager = class {
 		return entry;
 	}
 	/**
+	* Reload every resident slot whose model FILE is no longer the one
+	* `buildConfig` names — a Coral pool that switched co-compiled set (D724).
+	* The new slot is loaded BEFORE the old one is unloaded and the entry is
+	* replaced in between, so a lookup always finds a loaded index. Returns the
+	* `(step, model)` pairs reloaded. A failed reload keeps the old slot (it
+	* still serves, from the file it was loaded from) and is logged.
+	*/
+	async reloadChangedPaths() {
+		const reloaded = [];
+		for (const [stepId, perStep] of this.loaded) for (const entry of perStep.values()) {
+			const config = this.source.buildConfig(stepId, entry.modelId, entry.settings);
+			if (config.path === entry.path) continue;
+			const index = this.pool.allocateIndex();
+			try {
+				await this.pool.loadModel(index, config);
+			} catch (err) {
+				this.pool.releaseIndex(index);
+				this.log.error("Step variant reload from another model file failed — the old file keeps serving", { meta: {
+					step: stepId,
+					modelId: entry.modelId,
+					deviceKey: this.deviceKey,
+					from: entry.path,
+					to: config.path,
+					error: err instanceof Error ? err.message : String(err)
+				} });
+				continue;
+			}
+			perStep.set(entry.modelId, {
+				...entry,
+				poolIndex: index,
+				path: config.path,
+				decode: poolDecodeSettingsOf(config)
+			});
+			await this.pool.unloadModel(entry.poolIndex);
+			this.log.info("Step variant reloaded from another model file", { meta: {
+				step: stepId,
+				modelId: entry.modelId,
+				deviceKey: this.deviceKey,
+				from: entry.path,
+				to: config.path,
+				poolIndex: index
+			} });
+			reloaded.push({
+				stepId,
+				modelId: entry.modelId
+			});
+		}
+		return reloaded;
+	}
+	/**
 	* Push a retuned decode setting into ONE already-loaded slot.
 	*
 	* Scope is the point: `reconfigure` names a single pool index, so a slider
@@ -2981,6 +3033,251 @@ function deviceKeyOf(engine) {
 	return engine.device ? `${engine.backend}:${engine.device}` : engine.backend;
 }
 //#endregion
+//#region src/detection-pipeline/engine/coral-cocompiled-set.ts
+var ROOT_DETECTOR_STEP_ID = "object-detection";
+/** The models a dispatch places on the pool that runs it: every enabled video step. */
+function placedModelsOf(steps) {
+	return flattenEnabledVideoSteps(steps).map((s) => ({
+		stepId: s.addonId,
+		modelId: s.modelId
+	}));
+}
+var sameModel = (a, b) => a.stepId === b.stepId && a.modelId === b.modelId;
+/**
+* The set for `placed`, or why there is none.
+*
+* 1. A set that reserves the cache for the root detector is eligible only when
+*    the root is placed here, and a rootless set only when it is not: a root
+*    set on a pool without the root wastes the cache the root would have had,
+*    and a rootless set beside a root makes the root swap.
+* 2. A set must stand for at least two placed models — one model alone is
+*    better off with the whole cache (its separately compiled file).
+* 3. Most placed models covered wins; then the set with fewest members nobody
+*    placed (they hold cache for nothing); then declaration order.
+*/
+function selectCoCompiledSet(placed, sets) {
+	if (placed.length === 0) return {
+		kind: "separate",
+		reason: "nothing-placed"
+	};
+	if (placed.length === 1) return {
+		kind: "separate",
+		reason: "single-model"
+	};
+	const hostsRoot = placed.some((p) => p.stepId === ROOT_DETECTOR_STEP_ID);
+	let best = null;
+	for (const set of sets) {
+		if (set.hostsRoot !== hostsRoot) continue;
+		const covered = placed.filter((p) => set.members.some((m) => sameModel(m, p)));
+		if (covered.length < 2) continue;
+		const idle = set.members.length - covered.length;
+		if (best === null || covered.length > best.covered.length || covered.length === best.covered.length && idle < best.idle) best = {
+			set,
+			covered,
+			idle
+		};
+	}
+	if (best === null) return {
+		kind: "separate",
+		reason: "no-set-covers-two"
+	};
+	const { set, covered } = best;
+	return {
+		kind: "set",
+		set,
+		covered,
+		uncovered: placed.filter((p) => !covered.some((c) => sameModel(c, p)))
+	};
+}
+/** The member a selection loads `(stepId, modelId)` from, or `null` (its own `formats.tflite`). */
+function setMemberFor(selection, stepId, modelId) {
+	if (selection.kind !== "set") return null;
+	return selection.set.members.find((m) => m.stepId === stepId && m.modelId === modelId) ?? null;
+}
+/**
+* `entry` with its `tflite` build pointed at the set's file. Everything else —
+* labels, postprocessor, input contract, licence — is the entry's own: a
+* member is the same model, compiled together with others.
+*/
+function withSetBuild(entry, member) {
+	return {
+		...entry,
+		formats: {
+			...entry.formats,
+			tflite: {
+				url: member.url,
+				sizeMB: member.sizeMB,
+				runtimes: ["python"]
+			}
+		}
+	};
+}
+/** Identity of a selection for change detection: the set AND what it leaves out. */
+var selectionKey = (s) => s.kind === "set" ? `${s.set.id}|${s.uncovered.map((u) => `${u.stepId}/${u.modelId}`).toSorted().join(",")}` : `separate:${s.reason}`;
+/**
+* The placement of ONE Coral pool and the set it loads. Lives exactly as long
+* as the pool (the factory owns it).
+*/
+var CoralSetPlanner = class {
+	sets;
+	placed = [];
+	current = {
+		kind: "separate",
+		reason: "nothing-placed"
+	};
+	constructor(sets) {
+		this.sets = sets;
+	}
+	/** Add the models a dispatch places on this pool; say whether the set changed. */
+	note(models) {
+		let grew = false;
+		for (const m of models) {
+			if (this.placed.some((p) => sameModel(p, m))) continue;
+			this.placed.push({
+				stepId: m.stepId,
+				modelId: m.modelId
+			});
+			grew = true;
+		}
+		if (!grew) return { kind: "unchanged" };
+		const next = selectCoCompiledSet(this.placed, this.sets);
+		if (selectionKey(next) === selectionKey(this.current)) {
+			this.current = next;
+			return { kind: "unchanged" };
+		}
+		const from = this.current;
+		this.current = next;
+		return {
+			kind: "changed",
+			from,
+			to: next,
+			placed: [...this.placed]
+		};
+	}
+	selection() {
+		return this.current;
+	}
+	/** `entry` as this pool must load it: from the set when the set stands for it. */
+	entryFor(stepId, entry) {
+		const member = setMemberFor(this.current, stepId, entry.id);
+		return member === null ? entry : withSetBuild(entry, member);
+	}
+};
+//#endregion
+//#region src/detection-pipeline/registry/edgetpu-cocompiled-sets.ts
+/**
+* Co-compiled Edge TPU sets — pool-level artifacts, not models (D724).
+*
+* A Coral holds ~6.9 MiB of parameter cache. Two separately compiled models
+* carry two different cache tokens, so every alternation between them on one
+* Coral flushes the cache and re-streams the incoming model's parameters over
+* USB (D710). `edgetpu_compiler` given several models at once allocates the
+* cache between them, in command-line order, under ONE token: loaded from the
+* same set, they never evict each other — whatever does not fit is streamed on
+* every invoke of THAT model instead.
+*
+* Each member is the SAME model as its catalog entry's `formats.tflite` (same
+* `modelId`, same int8 graph, same labels and licence record), compiled
+* together with the other members (D710: a Coral build is a format of the
+* survivor; the set is where it is placed, not a new model). A Coral pool picks
+* at most one set from the models placed on it (`coral-cocompiled-set.ts`) and
+* falls back to the separately compiled `formats.tflite` for everything else.
+*
+* Built by `scripts/build-edgetpu-sets.py` (compile order = `members` order =
+* cache priority) and hosted under `edgetpuSets/<id>/`. Only sets whose
+* measured cost is acceptable are listed here: a set that would make the root
+* detector stream parameters on every frame (root + YuNet at 640: the root
+* keeps 3.34 of its 6.39 MiB, YuNet's activations take the rest) is
+* deliberately absent.
+*/
+var HF_REPO = "camstack/camstack-models";
+var setFile = (setId, file) => require_dist.hfModelUrl(HF_REPO, `edgetpuSets/${setId}/${setId}__${file}`);
+var SSD = "ssd-mobilenet-v2-coco-edgetpu";
+var YUNET = "yunet-2023mar";
+var YOLOX = "yolox-tiny-plate";
+var BIRD = "bird-classifier";
+var EDGETPU_COCOMPILED_SETS = [
+	{
+		id: "root-plate-bird",
+		hostsRoot: true,
+		members: [
+			{
+				stepId: "object-detection",
+				modelId: SSD,
+				url: setFile("root-plate-bird", "ssd_mobilenet_v2_coco_quant_postprocess_edgetpu.tflite"),
+				sizeMB: 6.9,
+				onChipMiB: 6.39,
+				streamedMiB: 0
+			},
+			{
+				stepId: "plate-detection",
+				modelId: YOLOX,
+				url: setFile("root-plate-bird", "camstack-yolox-tiny-plate_int8_edgetpu.tflite"),
+				sizeMB: 6.9,
+				onChipMiB: .08,
+				streamedMiB: 5.41
+			},
+			{
+				stepId: "bird-classifier",
+				modelId: BIRD,
+				url: setFile("root-plate-bird", "mobilenet_v2_1.0_224_inat_bird_quant_edgetpu.tflite"),
+				sizeMB: 4.9,
+				onChipMiB: 0,
+				streamedMiB: 4.54
+			}
+		]
+	},
+	{
+		id: "face-plate-bird",
+		hostsRoot: false,
+		members: [
+			{
+				stepId: "face-detection",
+				modelId: YUNET,
+				url: setFile("face-plate-bird", "camstack-yunet-2023mar_int8_edgetpu.tflite"),
+				sizeMB: .7,
+				onChipMiB: .11,
+				streamedMiB: 0
+			},
+			{
+				stepId: "plate-detection",
+				modelId: YOLOX,
+				url: setFile("face-plate-bird", "camstack-yolox-tiny-plate_int8_edgetpu.tflite"),
+				sizeMB: 6.9,
+				onChipMiB: 3.23,
+				streamedMiB: 2.27
+			},
+			{
+				stepId: "bird-classifier",
+				modelId: BIRD,
+				url: setFile("face-plate-bird", "mobilenet_v2_1.0_224_inat_bird_quant_edgetpu.tflite"),
+				sizeMB: 4.9,
+				onChipMiB: 0,
+				streamedMiB: 4.54
+			}
+		]
+	},
+	{
+		id: "plate-bird",
+		hostsRoot: false,
+		members: [{
+			stepId: "plate-detection",
+			modelId: YOLOX,
+			url: setFile("plate-bird", "camstack-yolox-tiny-plate_int8_edgetpu.tflite"),
+			sizeMB: 6.9,
+			onChipMiB: 5.55,
+			streamedMiB: 0
+		}, {
+			stepId: "bird-classifier",
+			modelId: BIRD,
+			url: setFile("plate-bird", "mobilenet_v2_1.0_224_inat_bird_quant_edgetpu.tflite"),
+			sizeMB: 4.1,
+			onChipMiB: .92,
+			streamedMiB: 2.8
+		}]
+	}
+];
+//#endregion
 //#region src/detection-pipeline/engine/engine-factory.ts
 var BACKEND_TO_POOL_RUNTIME = {
 	coreml: "coreml",
@@ -3074,11 +3371,45 @@ var EngineFactory = class {
 	* trying to be.
 	*/
 	resolvedProvisioning;
+	/**
+	* A Coral pool's placement and the co-compiled set it loads (D724); `null`
+	* on every other runtime. Lives exactly as long as this factory — a new
+	* pool starts from nothing placed.
+	*/
+	coralSets;
 	constructor(opts) {
 		this.opts = opts;
 		this.log = opts.logger;
 		this.deviceKey = deviceKeyOf(opts.engine);
 		this.resolvedProvisioning = resolvePoolProvisioning(opts.engine, opts.provisioning);
+		this.coralSets = BACKEND_TO_POOL_RUNTIME[opts.engine.backend] === "edgetpu" ? new CoralSetPlanner(opts.coCompiledSets ?? EDGETPU_COCOMPILED_SETS) : null;
+	}
+	/**
+	* Record the models a dispatch places on this pool. On a Coral pool the
+	* answer says whether the co-compiled set it loads from changed; on any
+	* other pool nothing is placed and nothing changes.
+	*/
+	notePlacement(models) {
+		return this.coralSets?.note(models) ?? { kind: "unchanged" };
+	}
+	/** The co-compiled set this pool loads from, or why none (`null`: not a Coral pool). */
+	coralSetSelection() {
+		return this.coralSets?.selection() ?? null;
+	}
+	/**
+	* The catalog entry as THIS pool must download and load it: on a Coral pool
+	* whose set stands for the model, the `tflite` build is the set's file.
+	* Every other entry is returned unchanged.
+	*/
+	entryForPool(stepId, entry) {
+		return this.coralSets?.entryFor(stepId, entry) ?? entry;
+	}
+	/**
+	* Reload every resident model whose file this pool no longer names — after
+	* the Coral set changed. The caller has already downloaded the new files.
+	*/
+	async reloadChangedModelFiles() {
+		return this.poolManager?.reloadChangedPaths() ?? [];
 	}
 	/**
 	* The provisioning this factory's pool runs with — resolved from the pool's
@@ -3340,6 +3671,7 @@ var EngineFactory = class {
 			stepSettings,
 			device: this.opts.engine.device,
 			resolveCustomModel: this.opts.resolveCustomModel,
+			entryForPool: (sid, entry) => this.entryForPool(sid, entry),
 			onClassMapDrop: ({ stepId: sid, modelId: mid, unmappedLabels }) => {
 				const key = `${sid}::${mid}`;
 				if (this.classMapDropLogged.has(key)) return;
@@ -3365,8 +3697,9 @@ var EngineFactory = class {
 function buildPoolModelConfigForStep(inputs) {
 	const { stepId, modelId, poolRuntime, modelsDir } = inputs;
 	const def = require_default_detection_model.getStepDefinition(stepId);
-	const modelEntry = def.models.find((m) => m.id === modelId) ?? inputs.resolveCustomModel?.(stepId, modelId);
-	if (!modelEntry) throw new Error(`Model "${modelId}" not found in step "${stepId}" catalog (static or custom registry)`);
+	const resolvedEntry = def.models.find((m) => m.id === modelId) ?? inputs.resolveCustomModel?.(stepId, modelId);
+	if (!resolvedEntry) throw new Error(`Model "${modelId}" not found in step "${stepId}" catalog (static or custom registry)`);
+	const modelEntry = inputs.entryForPool?.(stepId, resolvedEntry) ?? resolvedEntry;
 	const format = RUNTIME_TO_FORMAT[poolRuntime];
 	if (!format) throw new Error(`No format mapping for pool runtime "${poolRuntime}"`);
 	const dropWarning = collectClassMapDropWarning(def, modelEntry);
@@ -9432,6 +9765,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 	*/
 	async loadDispatchModels(steps, factory, format, context, policy) {
 		const failures = [];
+		if (factory !== null) await this.noteCoralPlacement(steps, factory, format, context);
 		const walk = async (nodes, root) => {
 			for (const step of nodes) {
 				if (!step.enabled || step.slot === "audio-classifier") continue;
@@ -9456,6 +9790,69 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 		await walk(steps, true);
 		return failures;
 	}
+	/**
+	* Tell a Coral pool which models this dispatch places on it, and act on a
+	* change of the co-compiled set it loads from (D724): download the set's
+	* files for the models already resident and reload them — queued behind the
+	* pool's other loads, so nothing loads from the old file meanwhile. Logged
+	* once per change, tagged with the camera whose dispatch moved it.
+	*/
+	async noteCoralPlacement(steps, factory, format, context) {
+		const change = factory.notePlacement(placedModelsOf(steps));
+		if (change.kind === "unchanged") return;
+		const deviceKey = context.deviceKey ?? deviceKeyOf(this.currentEngine);
+		const tags = context.deviceId !== void 0 ? { tags: { deviceId: context.deviceId } } : {};
+		const placed = change.placed.map((p) => `${p.stepId}/${p.modelId}`);
+		if (change.to.kind === "set") this.log.info("Coral pool loads a co-compiled set — the models placed on it share the parameter cache", {
+			...tags,
+			meta: {
+				deviceKey,
+				set: change.to.set.id,
+				placed,
+				fromSet: change.to.covered.map((p) => `${p.stepId}/${p.modelId}`),
+				separatelyCompiled: change.to.uncovered.map((p) => `${p.stepId}/${p.modelId}`),
+				previous: change.from.kind === "set" ? change.from.set.id : null
+			}
+		});
+		else if (change.to.reason === "no-set-covers-two") this.log.warn("Coral pool has no co-compiled set for the models placed on it — each is compiled alone, so they evict each other from the parameter cache on every alternation", {
+			...tags,
+			meta: {
+				deviceKey,
+				placed,
+				previous: change.from.kind === "set" ? change.from.set.id : null,
+				hint: "keep the extra step off this Coral with its jumpDeviceKey, or place a combination a published set covers"
+			}
+		});
+		const pool = factory;
+		const previous = this.modelLoadTail.get(pool) ?? Promise.resolve();
+		const tail = (async () => {
+			await previous;
+			for (const loaded of factory.listLoaded()) {
+				const resolved = await this.resolveModelEntry(loaded.stepId, loaded.modelId);
+				if (resolved === void 0) continue;
+				const entry = factory.entryForPool(loaded.stepId, resolved);
+				if (!(0, _camstack_system_addon_utils.isModelDownloaded)(this.modelsDir, entry, format)) await this.downloadWithRetry(entry, format, 3);
+			}
+			const reloaded = await factory.reloadChangedModelFiles();
+			if (reloaded.length > 0) this.log.info("Coral pool reloaded its resident models from the new set", {
+				...tags,
+				meta: {
+					deviceKey,
+					reloaded: reloaded.map((r) => `${r.stepId}/${r.modelId}`)
+				}
+			});
+		})().catch((err) => {
+			this.log.error("Coral pool could not move its resident models to the new set — they keep serving from the old files", {
+				...tags,
+				meta: {
+					deviceKey,
+					error: require_dist.errMsg(err)
+				}
+			});
+		});
+		this.modelLoadTail.set(pool, tail);
+		await tail;
+	}
 	/** Ensure all models needed by steps are downloaded and loaded in the engine pool.
 	* `factory`/`format` default to the node's engine; a per-device dispatch passes
 	* that device's factory + format (Phase 2 multi-device). `context` names the
@@ -9553,7 +9950,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 			const refusal = this.loadRefusal(pool, deviceKey, models);
 			if (refusal !== null) throw refusal;
 			try {
-				await this.downloadNeededModels(needed, format);
+				await this.downloadNeededModels(needed, format, factory);
 				this.log.info("Loading additional models for benchmark", { meta: {
 					count: needed.length,
 					models,
@@ -9617,16 +10014,21 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 		});
 	}
 	/** Download any model of `needed` missing in `format` (the device's). */
-	async downloadNeededModels(needed, format) {
+	async downloadNeededModels(needed, format, factory = null) {
 		for (const step of needed) try {
-			await this.ensureStepModelArtifact(step, format);
+			await this.ensureStepModelArtifact(step, format, factory);
 		} catch (err) {
 			throw new StepModelArtifactError(step.addonId, step.modelId, err);
 		}
 	}
-	/** Make one step's model artifact present on disk for `format`, or say why it cannot be. */
-	async ensureStepModelArtifact(step, format) {
-		const modelEntry = await this.resolveModelEntry(step.addonId, step.modelId);
+	/**
+	* Make one step's model artifact present on disk for `format`, or say why it
+	* cannot be. The entry is the one `factory`'s pool will LOAD — on a Coral
+	* pool, a co-compiled set's file when the set stands for the model (D724).
+	*/
+	async ensureStepModelArtifact(step, format, factory = null) {
+		const resolved = await this.resolveModelEntry(step.addonId, step.modelId);
+		const modelEntry = resolved && factory !== null ? factory.entryForPool(step.addonId, resolved) : resolved;
 		if (modelEntry && !(0, _camstack_system_addon_utils.isModelDownloaded)(this.modelsDir, modelEntry, format)) {
 			if (modelEntry.formats[format] === void 0) throw new Error(`Model "${modelEntry.id}" has no ${format} format build (available: ${Object.keys(modelEntry.formats).join(", ") || "none"}) — not retrying a permanent format mismatch`);
 			if (modelEntry.formats[format]?.url.startsWith("camstack-local://") === true) throw new Error(`Custom model "${modelEntry.id}" (${format}) is not present in this node's models directory — distribute it to this node from Model Studio before selecting it here`);