@camstack/addon-pipeline 1.2.618 → 1.2.620

package/dist/audio-analyzer/index.js

@@ -3,9 +3,9 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../chunk-emK7D4bc.js");
-const require_dist = require("../dist-CGDR6bSg.js");
-const require_model_catalogs = require("../model-catalogs-DV562sqJ.js");
-const require_process_memory = require("../process-memory-CJEkTpRM.js");
+const require_dist = require("../dist-CoLjAw2z.js");
+const require_model_catalogs = require("../model-catalogs-BstZN0ZA.js");
+const require_process_memory = require("../process-memory-C5Cw8Cxz.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,7 +1,7 @@
 import { n as __require } from "../chunk-DnnnRqeS.mjs";
-import { $ as audioAnalyzerCapability, F as PoolMemoryWatchdog, Kn as hydrateSchema, Mn as errMsg, Pn as BaseAddon, Q as audioAnalysisCapability, Qn as nodePin, Rt as mapAudioLabelToMacro, Wn as expandAudioChunkToF32le, h as DEFAULT_AUDIO_ANALYZER_CONFIG, hr as EventCategory, ln as resolvePoolMemoryPolicy, r as AUDIO_BACKEND_CHOICES, zn as audioChunkBytesPerSample } from "../dist-OImyOnr3.mjs";
-import { n as AUDIO_CLASSIFIER_MODELS } from "../model-catalogs-Cj101H8x.mjs";
-import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-DjIov9TF.mjs";
+import { $ as audioAnalyzerCapability, F as PoolMemoryWatchdog, Kn as hydrateSchema, Mn as errMsg, Pn as BaseAddon, Q as audioAnalysisCapability, Qn as nodePin, Rt as mapAudioLabelToMacro, Wn as expandAudioChunkToF32le, h as DEFAULT_AUDIO_ANALYZER_CONFIG, hr as EventCategory, ln as resolvePoolMemoryPolicy, r as AUDIO_BACKEND_CHOICES, zn as audioChunkBytesPerSample } from "../dist-mOyFhoa8.mjs";
+import { n as AUDIO_CLASSIFIER_MODELS } from "../model-catalogs-PmNZKpMR.mjs";
+import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-DXbuHvOX.mjs";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";
 import { ensureModel } from "@camstack/system/addon-utils";

package/dist/{custom-model-catalog-BT8HKaes.mjs → custom-model-catalog-BW0-xhwJ.mjs}

@@ -1,5 +1,5 @@
-import { Mt as inferModelProvider, b as DEVICE_BACKEND_TO_FORMAT, et as audioKindId, f as COCO_80_LABELS, hn as stepModelRunsOnFormat, i as AUDIO_MACRO_LABELS, k as LABEL_SUPPLY_VOCABULARIES, p as COCO_TO_MACRO } from "./dist-OImyOnr3.mjs";
-import { a as FACE_DETECTION_MODELS, c as OBJECT_DETECTION_MODELS, d as PLATE_OCR_MODELS, f as SEGMENTATION_REFINER_MODELS, i as CLIP_EMBEDDING_MODELS, l as PACKAGE_DETECTION_MODELS, n as AUDIO_CLASSIFIER_MODELS, o as FACE_EMBEDDING_MODELS, p as VEHICLE_CLASSIFIER_MODELS, r as BIRD_CLASSIFIER_MODELS, s as INSTANCE_SEGMENTATION_MODELS, t as ANIMAL_CLASSIFIER_MODELS, u as PLATE_DETECTION_MODELS } from "./model-catalogs-Cj101H8x.mjs";
+import { Mt as inferModelProvider, b as DEVICE_BACKEND_TO_FORMAT, et as audioKindId, f as COCO_80_LABELS, hn as stepModelRunsOnFormat, i as AUDIO_MACRO_LABELS, k as LABEL_SUPPLY_VOCABULARIES, p as COCO_TO_MACRO } from "./dist-mOyFhoa8.mjs";
+import { a as FACE_DETECTION_MODELS, c as OBJECT_DETECTION_MODELS, d as PLATE_OCR_MODELS, f as SEGMENTATION_REFINER_MODELS, i as CLIP_EMBEDDING_MODELS, l as PACKAGE_DETECTION_MODELS, n as AUDIO_CLASSIFIER_MODELS, o as FACE_EMBEDDING_MODELS, p as VEHICLE_CLASSIFIER_MODELS, r as BIRD_CLASSIFIER_MODELS, s as INSTANCE_SEGMENTATION_MODELS, t as ANIMAL_CLASSIFIER_MODELS, u as PLATE_DETECTION_MODELS } from "./model-catalogs-PmNZKpMR.mjs";
 import { t as isWorkerReply } from "./worker-protocol-D_NzPcnh.mjs";
 import { randomUUID } from "node:crypto";
 //#region src/detection-pipeline/registry/effective-confidence.ts

package/dist/{custom-model-catalog-Yu1sxc4A.js → custom-model-catalog-YxQheit5.js}

@@ -1,5 +1,5 @@
-const require_dist = require("./dist-CGDR6bSg.js");
-const require_model_catalogs = require("./model-catalogs-DV562sqJ.js");
+const require_dist = require("./dist-CoLjAw2z.js");
+const require_model_catalogs = require("./model-catalogs-BstZN0ZA.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

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-CGDR6bSg.js");
-const require_node = require("../node-CSFdbFlw.js");
-const require_custom_model_catalog = require("../custom-model-catalog-Yu1sxc4A.js");
+const require_dist = require("../dist-CoLjAw2z.js");
+const require_node = require("../node-CzmiyMnw.js");
+const require_custom_model_catalog = require("../custom-model-catalog-YxQheit5.js");
 const require_lazy_sharp = require("../lazy-sharp-BuwKlQLR.js");
-const require_process_memory = require("../process-memory-CJEkTpRM.js");
+const require_process_memory = require("../process-memory-C5Cw8Cxz.js");
 let node_os = require("node:os");
 node_os = require_chunk.__toESM(node_os);
 let node_fs = require("node:fs");
@@ -1221,6 +1221,39 @@ async function terminateChild(proc, graceMs) {
 		}, graceMs);
 	});
 }
+/**
+* How long a POISONED worker is given to write its stack after SIGUSR1,
+* before SIGTERM. `faulthandler` writes from a C signal handler, so a dump
+* takes milliseconds even while a native call holds the GIL; the bound is
+* there for the worker that cannot answer at all. Never more than ~2 s: the
+* recycle it delays is the one that hands the device back to the budget.
+*/
+var POOL_STACK_DUMP_WAIT_MS = 1500;
+/**
+* Ask a hung worker for every thread's Python stack (SIGUSR1, registered by
+* the pool with `faulthandler` → its stderr, which the host logs under the
+* worker label), then wait up to `waitMs` — or until it exits — so the dump
+* is written before the caller terminates it. Exported for tests.
+*/
+async function requestStackDump(proc, waitMs, platform = process.platform) {
+	if (platform === "win32") return "unsupported";
+	if (proc.exitCode !== null || proc.signalCode !== null) return "already-exited";
+	try {
+		proc.kill("SIGUSR1");
+	} catch {
+		return "signal-failed";
+	}
+	await new Promise((resolve) => {
+		const done = () => {
+			clearTimeout(timer);
+			proc.removeListener("exit", done);
+			resolve();
+		};
+		const timer = setTimeout(done, waitMs);
+		proc.once("exit", done);
+	});
+	return "signalled";
+}
 var PoolWorker = class {
 	process = null;
 	receiveBuffer = Buffer.alloc(0);
@@ -2012,7 +2045,30 @@ var PoolWorker = class {
 		if (this.recycling || this.exited || this.process === null) return;
 		this.recycling = true;
 		if (this.recycleBackstop) clearTimeout(this.recycleBackstop);
-		terminateChild(this.process, POOL_WORKER_TERM_GRACE_MS);
+		const proc = this.process;
+		this.dumpStackOfPoisoned(proc).then(() => terminateChild(proc, POOL_WORKER_TERM_GRACE_MS));
+	}
+	/**
+	* Before a POISONED worker is killed, ask it where it hung (SIGUSR1 →
+	* `faulthandler`, bounded by {@link POOL_STACK_DUMP_WAIT_MS}) and say where
+	* the answer went: the worker's stderr, which this host logs line by line as
+	* `[<worker label>] …` warnings just before the exit line. A hang that is
+	* killed without this leaves "it hung" as the whole record.
+	*/
+	async dumpStackOfPoisoned(proc) {
+		if (this.poisonVerdict === null) return;
+		const outcome = await requestStackDump(proc, POOL_STACK_DUMP_WAIT_MS);
+		this.log.warn("poisoned pool worker asked for its stack before SIGTERM", { meta: {
+			worker: this.opts.workerLabel,
+			pid: proc.pid ?? null,
+			runtime: this.opts.poolRuntime,
+			device: this.opts.device ?? "default",
+			reason: this.poisonVerdict.reason,
+			outcome,
+			signal: "SIGUSR1",
+			waitedMs: outcome === "signalled" ? POOL_STACK_DUMP_WAIT_MS : 0,
+			dumpWrittenTo: outcome === "signalled" ? `worker stderr — this log, lines prefixed [${this.opts.workerLabel}]` : "none"
+		} });
 	}
 	rejectAll(err) {
 		const entries = [...this.pending.values()];
@@ -4359,6 +4415,53 @@ var InferenceDeviceLivenessSupervisor = class {
 	}
 };
 //#endregion
+//#region src/detection-pipeline/engine/frame-device-reelection.ts
+function routeLiveFrameDevice(input) {
+	const requested = input.requestedDeviceKey;
+	if (requested === void 0) return {
+		kind: "as-elected",
+		deviceKey: void 0
+	};
+	const from = input.unusable(requested);
+	if (from === null) return {
+		kind: "as-elected",
+		deviceKey: requested
+	};
+	if (requested === input.defaultDeviceKey || input.unusable(input.defaultDeviceKey) !== null) return {
+		kind: "no-alternative",
+		deviceKey: requested,
+		from
+	};
+	return {
+		kind: "re-elected",
+		deviceKey: void 0,
+		from,
+		to: input.defaultDeviceKey
+	};
+}
+/**
+* Per camera, the routing last said — so a 6 fps camera says "re-elected"
+* once, not six times a second, and says it again when it is back.
+*/
+var FrameReelectionNotes = class {
+	said = /* @__PURE__ */ new Map();
+	note(deviceId, routing) {
+		const previous = this.said.get(deviceId);
+		if (routing.kind === "as-elected") {
+			if (previous === void 0) return null;
+			this.said.delete(deviceId);
+			return routing.deviceKey !== void 0 ? {
+				kind: "restored",
+				deviceKey: routing.deviceKey
+			} : null;
+		}
+		const state = `${routing.kind}|${routing.from.deviceKey}|${routing.from.state}`;
+		if (previous === state) return null;
+		this.said.set(deviceId, state);
+		return routing;
+	}
+};
+//#endregion
 //#region src/detection-pipeline/engine/pool-memory-guard.ts
 function createDetectionPoolMemoryGuard(source, logger) {
 	const log = logger.child("pool-memory");
@@ -9729,9 +9832,10 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 			emit(`Image: ${imageWidth}×${imageHeight}`);
 		}
 		decodeMs = performance.now() - decodeT0;
+		const liveDeviceKey = isRuntime && input.replay !== true && input.deviceId !== void 0 && input.sessionId === void 0 ? this.routeLiveFrameDevice(input.deviceKey, input.deviceId) : input.deviceKey;
 		const dispatchResolution = this.resolveStepsForDispatch({
 			steps: input.steps,
-			deviceKey: input.deviceKey,
+			deviceKey: liveDeviceKey,
 			deviceId: input.deviceId,
 			plane: input.plane
 		});
@@ -10871,6 +10975,49 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 	* (`encodeModelByte`) that pool could never have served inference again even
 	* if its worker had come back.
 	*/
+	/** Per camera, the last live-frame re-election said (see `frame-device-reelection.ts`). */
+	frameReelections = new FrameReelectionNotes();
+	/**
+	* The deviceKey a live frame dispatches on: the elected one while it is
+	* usable, else the node default pool. Each change is said once per camera,
+	* naming the device — a camera whose frames silently moved pool, or were
+	* silently refused, is the failure this exists to end.
+	*/
+	routeLiveFrameDevice(requestedDeviceKey, deviceId) {
+		const routing = routeLiveFrameDevice({
+			requestedDeviceKey,
+			defaultDeviceKey: require_custom_model_catalog.deviceKeyOf(this.currentEngine),
+			unusable: (key) => this.deviceLiveness.unusableReason(key)
+		});
+		const note = this.frameReelections.note(deviceId, routing);
+		if (note !== null) {
+			const tags = { tags: { deviceId } };
+			if (note.kind === "re-elected") this.log.warn("elected inference device unusable — frames re-elected onto the default pool", {
+				...tags,
+				meta: {
+					deviceKey: note.from.deviceKey,
+					state: note.from.state,
+					deaths: note.from.deaths,
+					lastError: note.from.lastError,
+					reElectedTo: note.to
+				}
+			});
+			else if (note.kind === "no-alternative") this.log.warn("elected inference device unusable and no other pool here — frames refused", {
+				...tags,
+				meta: {
+					deviceKey: note.from.deviceKey,
+					state: note.from.state,
+					deaths: note.from.deaths,
+					lastError: note.from.lastError
+				}
+			});
+			else this.log.info("elected inference device usable again — frames back on it", {
+				...tags,
+				meta: { deviceKey: note.deviceKey }
+			});
+		}
+		return routing.deviceKey;
+	}
 	refuseIfDeviceUnusable(deviceKey) {
 		const unhealthy = this.deviceLiveness.unusableReason(deviceKey);
 		if (unhealthy) throw new InferenceDeviceUnusableError(unhealthy);

package/dist/detection-pipeline/index.mjs

@@ -1,9 +1,9 @@
 import { n as __require } from "../chunk-DnnnRqeS.mjs";
-import { Bn as createEvent, Ct as evaluateZoneRules, F as PoolMemoryWatchdog, Gn as hfModelUrl, It as loadContributionCapability, Jt as pickClusterStepSettings, Kn as hydrateSchema, Kt as overlayClusterStepSettings, Mn as errMsg$1, O as LABEL_SUPPLY_MACRO, Pn as BaseAddon, Pt as linkedLabelStepId, Qn as nodePin, St as enumerateInferenceDevices, Wt as modelBindingKey, X as applyModelBoundSettings, Zt as pipelineExecutorCapability, _t as detectionPipelineCapability, bn as supportedRuntimes$1, ct as containingParentIndex, d as CLUSTER_MODEL_SCOPED_STEPS, fn as rootSuppliesOf, ft as defaultDeviceFor$1, g as DEFAULT_CLUSTER_STEP_SETTINGS, hn as stepModelRunsOnFormat, hr as EventCategory, in as resolveClusterStepModelId, ir as array, ln as resolvePoolMemoryPolicy, mr as union, n as APPLE_SA_TO_MACRO, pn as runtimeDevices$1, pr as string, q as YAMNET_TO_MACRO, st as collectModelBoundKeys, tr as sleep, ur as object, yt as edgetpuDelegateDevice } from "../dist-OImyOnr3.mjs";
-import { c as readProcessCost } from "../node-DciF_ZRl.mjs";
-import { C as resolveModelDefaultConfidence, S as landmarkPrecisionVerdict, _ as ALL_STEPS, b as getStepDefinition, f as localFrameRegistry, g as ALL_PIPELINE_STEPS, l as resolveDefaultDetectionModel, n as mergeCustomModels, o as deviceKeyOf, r as buildSubtreeCanRun, s as resolveDeviceEngine, t as CustomModelCatalog, u as macroGateVerdict, v as getDefaultModelForFormat, x as resolveModelForFormat, y as getStep } from "../custom-model-catalog-BT8HKaes.mjs";
+import { Bn as createEvent, Ct as evaluateZoneRules, F as PoolMemoryWatchdog, Gn as hfModelUrl, It as loadContributionCapability, Jt as pickClusterStepSettings, Kn as hydrateSchema, Kt as overlayClusterStepSettings, Mn as errMsg$1, O as LABEL_SUPPLY_MACRO, Pn as BaseAddon, Pt as linkedLabelStepId, Qn as nodePin, St as enumerateInferenceDevices, Wt as modelBindingKey, X as applyModelBoundSettings, Zt as pipelineExecutorCapability, _t as detectionPipelineCapability, bn as supportedRuntimes$1, ct as containingParentIndex, d as CLUSTER_MODEL_SCOPED_STEPS, fn as rootSuppliesOf, ft as defaultDeviceFor$1, g as DEFAULT_CLUSTER_STEP_SETTINGS, hn as stepModelRunsOnFormat, hr as EventCategory, in as resolveClusterStepModelId, ir as array, ln as resolvePoolMemoryPolicy, mr as union, n as APPLE_SA_TO_MACRO, pn as runtimeDevices$1, pr as string, q as YAMNET_TO_MACRO, st as collectModelBoundKeys, tr as sleep, ur as object, yt as edgetpuDelegateDevice } from "../dist-mOyFhoa8.mjs";
+import { c as readProcessCost } from "../node-Qmp6FkS2.mjs";
+import { C as resolveModelDefaultConfidence, S as landmarkPrecisionVerdict, _ as ALL_STEPS, b as getStepDefinition, f as localFrameRegistry, g as ALL_PIPELINE_STEPS, l as resolveDefaultDetectionModel, n as mergeCustomModels, o as deviceKeyOf, r as buildSubtreeCanRun, s as resolveDeviceEngine, t as CustomModelCatalog, u as macroGateVerdict, v as getDefaultModelForFormat, x as resolveModelForFormat, y as getStep } from "../custom-model-catalog-BW0-xhwJ.mjs";
 import { t as getSharp } from "../lazy-sharp-DXsqwpph.mjs";
-import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-DjIov9TF.mjs";
+import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-DXbuHvOX.mjs";
 import * as os$1 from "node:os";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";
@@ -1214,6 +1214,39 @@ async function terminateChild(proc, graceMs) {
 		}, graceMs);
 	});
 }
+/**
+* How long a POISONED worker is given to write its stack after SIGUSR1,
+* before SIGTERM. `faulthandler` writes from a C signal handler, so a dump
+* takes milliseconds even while a native call holds the GIL; the bound is
+* there for the worker that cannot answer at all. Never more than ~2 s: the
+* recycle it delays is the one that hands the device back to the budget.
+*/
+var POOL_STACK_DUMP_WAIT_MS = 1500;
+/**
+* Ask a hung worker for every thread's Python stack (SIGUSR1, registered by
+* the pool with `faulthandler` → its stderr, which the host logs under the
+* worker label), then wait up to `waitMs` — or until it exits — so the dump
+* is written before the caller terminates it. Exported for tests.
+*/
+async function requestStackDump(proc, waitMs, platform = process.platform) {
+	if (platform === "win32") return "unsupported";
+	if (proc.exitCode !== null || proc.signalCode !== null) return "already-exited";
+	try {
+		proc.kill("SIGUSR1");
+	} catch {
+		return "signal-failed";
+	}
+	await new Promise((resolve) => {
+		const done = () => {
+			clearTimeout(timer);
+			proc.removeListener("exit", done);
+			resolve();
+		};
+		const timer = setTimeout(done, waitMs);
+		proc.once("exit", done);
+	});
+	return "signalled";
+}
 var PoolWorker = class {
 	process = null;
 	receiveBuffer = Buffer.alloc(0);
@@ -2005,7 +2038,30 @@ var PoolWorker = class {
 		if (this.recycling || this.exited || this.process === null) return;
 		this.recycling = true;
 		if (this.recycleBackstop) clearTimeout(this.recycleBackstop);
-		terminateChild(this.process, POOL_WORKER_TERM_GRACE_MS);
+		const proc = this.process;
+		this.dumpStackOfPoisoned(proc).then(() => terminateChild(proc, POOL_WORKER_TERM_GRACE_MS));
+	}
+	/**
+	* Before a POISONED worker is killed, ask it where it hung (SIGUSR1 →
+	* `faulthandler`, bounded by {@link POOL_STACK_DUMP_WAIT_MS}) and say where
+	* the answer went: the worker's stderr, which this host logs line by line as
+	* `[<worker label>] …` warnings just before the exit line. A hang that is
+	* killed without this leaves "it hung" as the whole record.
+	*/
+	async dumpStackOfPoisoned(proc) {
+		if (this.poisonVerdict === null) return;
+		const outcome = await requestStackDump(proc, POOL_STACK_DUMP_WAIT_MS);
+		this.log.warn("poisoned pool worker asked for its stack before SIGTERM", { meta: {
+			worker: this.opts.workerLabel,
+			pid: proc.pid ?? null,
+			runtime: this.opts.poolRuntime,
+			device: this.opts.device ?? "default",
+			reason: this.poisonVerdict.reason,
+			outcome,
+			signal: "SIGUSR1",
+			waitedMs: outcome === "signalled" ? POOL_STACK_DUMP_WAIT_MS : 0,
+			dumpWrittenTo: outcome === "signalled" ? `worker stderr — this log, lines prefixed [${this.opts.workerLabel}]` : "none"
+		} });
 	}
 	rejectAll(err) {
 		const entries = [...this.pending.values()];
@@ -4352,6 +4408,53 @@ var InferenceDeviceLivenessSupervisor = class {
 	}
 };
 //#endregion
+//#region src/detection-pipeline/engine/frame-device-reelection.ts
+function routeLiveFrameDevice(input) {
+	const requested = input.requestedDeviceKey;
+	if (requested === void 0) return {
+		kind: "as-elected",
+		deviceKey: void 0
+	};
+	const from = input.unusable(requested);
+	if (from === null) return {
+		kind: "as-elected",
+		deviceKey: requested
+	};
+	if (requested === input.defaultDeviceKey || input.unusable(input.defaultDeviceKey) !== null) return {
+		kind: "no-alternative",
+		deviceKey: requested,
+		from
+	};
+	return {
+		kind: "re-elected",
+		deviceKey: void 0,
+		from,
+		to: input.defaultDeviceKey
+	};
+}
+/**
+* Per camera, the routing last said — so a 6 fps camera says "re-elected"
+* once, not six times a second, and says it again when it is back.
+*/
+var FrameReelectionNotes = class {
+	said = /* @__PURE__ */ new Map();
+	note(deviceId, routing) {
+		const previous = this.said.get(deviceId);
+		if (routing.kind === "as-elected") {
+			if (previous === void 0) return null;
+			this.said.delete(deviceId);
+			return routing.deviceKey !== void 0 ? {
+				kind: "restored",
+				deviceKey: routing.deviceKey
+			} : null;
+		}
+		const state = `${routing.kind}|${routing.from.deviceKey}|${routing.from.state}`;
+		if (previous === state) return null;
+		this.said.set(deviceId, state);
+		return routing;
+	}
+};
+//#endregion
 //#region src/detection-pipeline/engine/pool-memory-guard.ts
 function createDetectionPoolMemoryGuard(source, logger) {
 	const log = logger.child("pool-memory");
@@ -9722,9 +9825,10 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 			emit(`Image: ${imageWidth}×${imageHeight}`);
 		}
 		decodeMs = performance.now() - decodeT0;
+		const liveDeviceKey = isRuntime && input.replay !== true && input.deviceId !== void 0 && input.sessionId === void 0 ? this.routeLiveFrameDevice(input.deviceKey, input.deviceId) : input.deviceKey;
 		const dispatchResolution = this.resolveStepsForDispatch({
 			steps: input.steps,
-			deviceKey: input.deviceKey,
+			deviceKey: liveDeviceKey,
 			deviceId: input.deviceId,
 			plane: input.plane
 		});
@@ -10864,6 +10968,49 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 	* (`encodeModelByte`) that pool could never have served inference again even
 	* if its worker had come back.
 	*/
+	/** Per camera, the last live-frame re-election said (see `frame-device-reelection.ts`). */
+	frameReelections = new FrameReelectionNotes();
+	/**
+	* The deviceKey a live frame dispatches on: the elected one while it is
+	* usable, else the node default pool. Each change is said once per camera,
+	* naming the device — a camera whose frames silently moved pool, or were
+	* silently refused, is the failure this exists to end.
+	*/
+	routeLiveFrameDevice(requestedDeviceKey, deviceId) {
+		const routing = routeLiveFrameDevice({
+			requestedDeviceKey,
+			defaultDeviceKey: deviceKeyOf(this.currentEngine),
+			unusable: (key) => this.deviceLiveness.unusableReason(key)
+		});
+		const note = this.frameReelections.note(deviceId, routing);
+		if (note !== null) {
+			const tags = { tags: { deviceId } };
+			if (note.kind === "re-elected") this.log.warn("elected inference device unusable — frames re-elected onto the default pool", {
+				...tags,
+				meta: {
+					deviceKey: note.from.deviceKey,
+					state: note.from.state,
+					deaths: note.from.deaths,
+					lastError: note.from.lastError,
+					reElectedTo: note.to
+				}
+			});
+			else if (note.kind === "no-alternative") this.log.warn("elected inference device unusable and no other pool here — frames refused", {
+				...tags,
+				meta: {
+					deviceKey: note.from.deviceKey,
+					state: note.from.state,
+					deaths: note.from.deaths,
+					lastError: note.from.lastError
+				}
+			});
+			else this.log.info("elected inference device usable again — frames back on it", {
+				...tags,
+				meta: { deviceKey: note.deviceKey }
+			});
+		}
+		return routing.deviceKey;
+	}
 	refuseIfDeviceUnusable(deviceKey) {
 		const unhealthy = this.deviceLiveness.unusableReason(deviceKey);
 		if (unhealthy) throw new InferenceDeviceUnusableError(unhealthy);