@camstack/addon-pipeline 1.2.231 → 1.2.233

package/dist/pipeline-runner/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-p5lZW8pr.js");
-const require_node = require("../node-CGVUk5S9.js");
-const require_default_detection_model = require("../default-detection-model-C7fsHtHQ.js");
+const require_dist = require("../dist-NX0e_oWp.js");
+const require_node = require("../node-BgM4n8D4.js");
+const require_default_detection_model = require("../default-detection-model-CDhXxOJQ.js");
 const require_worker_protocol = require("../worker-protocol-B2MfQLlu.js");
 const require_hub_hostname = require("../hub-hostname-DAJXlOgV.js");
 const require_lazy_sharp = require("../lazy-sharp-BuwKlQLR.js");
@@ -2096,6 +2096,73 @@ function startSessionDecodePump(deps) {
 		iterator.return().catch(() => {});
 	};
 }
+/**
+* Read the camera's `detectionSources`.
+*
+* ABSENT is the pipeline — a runner or an attach older than the field behaves
+* exactly as it always did. EMPTY is not the same thing and must never be
+* widened into "everything": it is a camera an operator left with no root
+* detector, and inventing one for them is how a default acts without anybody
+* choosing it.
+*/
+function planDetectionSources(sources) {
+	if (sources === void 0) return {
+		runsPipeline: true,
+		runsOnboard: false
+	};
+	return {
+		runsPipeline: sources.includes("pipeline"),
+		runsOnboard: sources.includes("onboard")
+	};
+}
+/** Clamp a denormalised box into the frame; a firmware box may exceed it. */
+function clamp(value, max) {
+	return Math.max(0, Math.min(value, max));
+}
+/**
+* Pair the camera's last detections with a decoded frame, in the FRAME's pixel
+* space.
+*
+* The old converter denormalised against a nominal 1000×1000 when the push
+* carried no dimensions, and documented that consumers should treat a native
+* bbox as relative. That was survivable while nothing cut pixels from it. Here
+* the boxes travel with a real frame and a real handle, so they are scaled to
+* that frame — the same space every other detection on this plane lives in.
+*/
+function onboardRootDetections(slot, frame) {
+	if (slot === null || slot.detections.length === 0) return { kind: "none" };
+	const ageMs = Math.abs(frame.timestamp - slot.at);
+	if (ageMs > 1e3) return {
+		kind: "expired",
+		ageMs
+	};
+	const boxed = slot.detections.filter((d) => d.bbox != null);
+	if (boxed.length === 0) return {
+		kind: "no-geometry",
+		classes: slot.detections.map((d) => d.class)
+	};
+	return {
+		kind: "paired",
+		detections: boxed.map((d, i) => {
+			const [nx, ny, nw, nh] = d.bbox;
+			const x = clamp(nx * frame.width, frame.width);
+			const y = clamp(ny * frame.height, frame.height);
+			return {
+				id: `onboard-${String(slot.at)}-${String(i)}`,
+				kind: "first-level",
+				macroClass: d.class,
+				score: d.confidence ?? 1,
+				labels: [],
+				bbox: {
+					x,
+					y,
+					width: clamp(nw * frame.width, frame.width - x),
+					height: clamp(nh * frame.height, frame.height - y)
+				}
+			};
+		})
+	};
+}
 //#endregion
 //#region src/pipeline-runner/bench-step-schema.ts
 /**
@@ -5644,6 +5711,8 @@ var PipelineRunner = class {
 	cameras = /* @__PURE__ */ new Map();
 	semaphore;
 	resultCallbacks = [];
+	/** Last report per `deviceId:reason` for {@link noteOnboardRootIdle}. */
+	onboardIdleReportedAt = /* @__PURE__ */ new Map();
 	defaultRoundRobinKeys = [];
 	defaultRoundRobinIndex = 0;
 	intervalHandle = null;
@@ -5724,6 +5793,7 @@ var PipelineRunner = class {
 		const initialPhase = registration.detectionMode === "disabled" ? "idle" : registration.detectionMode === "always-on" ? "active" : "watching";
 		const state = {
 			registration,
+			onboardSlot: null,
 			motionQueue,
 			detectionQueue,
 			preRollQueue: new PreRollLane({
@@ -6200,6 +6270,15 @@ var PipelineRunner = class {
 		const { frame, handle } = entry;
 		state.inflight += 1;
 		const enqueuedAt = frame._enqueuedAt ?? pickedAt;
+		const plan = planDetectionSources(state.registration.detectionSources);
+		if (!plan.runsPipeline) {
+			try {
+				await this.processOnboardRoot(deviceId, entry, state, streamType, plan);
+			} finally {
+				state.inflight -= 1;
+			}
+			return;
+		}
 		const rawRelease = await this.semaphore.acquire();
 		let released = false;
 		const release = () => {
@@ -6223,7 +6302,7 @@ var PipelineRunner = class {
 			state.processedCount++;
 			if (result) {
 				if (result.shed === true) state.shedFrames++;
-				await this.notifyCallbacks(deviceId, frame, result, streamType, handle);
+				await this.notifyCallbacks(deviceId, frame, result, streamType, handle, "pipeline");
 				frameReleaseReason = "success";
 				const emittedAt = Date.now();
 				const capturedAt = frame.capturedAt;
@@ -6250,6 +6329,96 @@ var PipelineRunner = class {
 		}
 	}
 	/**
+	* The CAMERA is this camera's root step.
+	*
+	* Same shape as the pipeline path and deliberately so: one decoded frame, one
+	* `FrameResult`, the same `notifyCallbacks`, the same handle, the same
+	* retention release. Everything downstream — subject tiles, birth evidence,
+	* the `detailSteps` announce, the overlay, the tracker — cannot tell which
+	* detector produced the boxes, which is the entire point. What it does NOT do
+	* is take an inference permit: the accelerator is never asked.
+	*
+	* A frame with no fresh onboard detection produces NO result rather than an
+	* empty one. An empty `FrameResult` is a positive statement ("I looked and
+	* there was nothing"), and this path did not look — it decoded a frame while
+	* the camera happened to be silent. Emitting emptiness would tell the
+	* tracker every silent frame is evidence of absence and coast every subject
+	* to death between two pushes.
+	*/
+	async processOnboardRoot(deviceId, entry, state, streamType, plan) {
+		const { frame, handle } = entry;
+		let frameReleaseReason = "drop";
+		try {
+			if (!plan.runsOnboard) {
+				this.noteOnboardRootIdle(deviceId, "no-source");
+				return;
+			}
+			const pairing = onboardRootDetections(state.onboardSlot, {
+				timestamp: Date.now(),
+				width: frame.width,
+				height: frame.height
+			});
+			if (pairing.kind !== "paired") {
+				this.noteOnboardRootIdle(deviceId, pairing.kind);
+				return;
+			}
+			state.onboardSlot = null;
+			state.processedCount++;
+			const result = {
+				kind: "frame",
+				frameId: `onboard-${String(deviceId)}-${String(frame.timestamp)}`,
+				deviceId,
+				timestamp: Date.now(),
+				width: frame.width,
+				height: frame.height,
+				detections: pairing.detections
+			};
+			state.lastResultDetections = pairing.detections.length;
+			await this.notifyCallbacks(deviceId, frame, result, streamType, handle, "onboard");
+			frameReleaseReason = "success";
+		} catch {
+			frameReleaseReason = "error";
+		} finally {
+			try {
+				if (frameReleaseReason === "success" && handle && isContinuousRetainEnabled()) await this.config.hydrateRetainedFrame?.(handle);
+			} catch {}
+			if (handle) this.config.releaseRetention?.(handle, frameReleaseReason);
+			if (frame.frameRef) this.config.releaseFrameRef?.(frame.frameRef, frameReleaseReason);
+		}
+	}
+	/**
+	* Report — once per camera per interval — that the onboard root step decoded
+	* a frame and produced nothing, with WHICH of the reasons it was. Sampled
+	* because it fires at detection fps on a silent camera, which is most of the
+	* time and is not itself a fault.
+	*/
+	noteOnboardRootIdle(deviceId, reason) {
+		const now = Date.now();
+		const key = `${String(deviceId)}:${reason}`;
+		if (now - (this.onboardIdleReportedAt.get(key) ?? 0) < 6e4) return;
+		this.onboardIdleReportedAt.set(key, now);
+		this.logger?.info("onboard root step produced nothing for a decoded frame", {
+			tags: { deviceId },
+			meta: { reason }
+		});
+	}
+	/**
+	* The camera spoke. Held until a decoded frame can be paired with it.
+	*
+	* Gated by the CALLER on `detectionSources` — this method is the mechanism,
+	* not the policy, and a camera that does not name `onboard` never reaches it.
+	*/
+	reportNativeDetection(deviceId, detections, frameWidth, frameHeight) {
+		const state = this.cameras.get(deviceId);
+		if (!state) return;
+		state.onboardSlot = {
+			at: Date.now(),
+			detections,
+			...frameWidth !== void 0 ? { frameWidth } : {},
+			...frameHeight !== void 0 ? { frameHeight } : {}
+		};
+	}
+	/**
 	* Await `processFrame` with a hard bound. On expiry the permit is released
 	* immediately (via the caller's release-once closure) and {@link TIMED_OUT}
 	* is returned; the underlying call is left to settle into the void, since
@@ -6334,9 +6503,9 @@ var PipelineRunner = class {
 			});
 		}
 	}
-	async notifyCallbacks(deviceId, frame, result, streamType, handle) {
+	async notifyCallbacks(deviceId, frame, result, streamType, handle, source) {
 		for (const callback of this.resultCallbacks) try {
-			await callback(deviceId, frame, result, streamType, handle);
+			await callback(deviceId, frame, result, streamType, handle, source);
 		} catch {}
 	}
 	pickNextDetectionFrame() {
@@ -7160,6 +7329,7 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 	/** Last runtime-label failure, so only a CHANGE is logged (D463). */
 	lastRuntimeInfoFailure = null;
 	unsubMotionEvents = null;
+	unsubNativeDetections = null;
 	/** Devices we have positively observed reporting `battery.sleeping: true`.
 	*  Absent = unknown or awake; both mean "do not gate" (D49). Fed only by
 	*  `BatteryOnStatusChanged`, so consulting it costs nothing and can never
@@ -7416,11 +7586,11 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 		this.runner.onDetectionStreamChange((deviceId, action) => {
 			this.handleDetectionStreamChange(deviceId, action);
 		});
-		this.runner.onResult(async (deviceId, frame, result, _streamType, handle) => {
+		this.runner.onResult(async (deviceId, frame, result, _streamType, handle, source) => {
 			this.retention?.noteInferenceResult(deviceId, handle, result);
 			this.cutSubjectTiles(deviceId, result, handle);
 			const carried = await this.attachBirthEvidence(deviceId, frame, result);
-			this.emitInferenceResult(deviceId, frame, carried, handle);
+			this.emitInferenceResult(deviceId, frame, carried, handle, source);
 			const detectionCount = result.detections?.length ?? 0;
 			this.runner?.noteDetectionResult(deviceId, detectionCount);
 			if (detectionCount > 0 && this.occupancyBurstInFlight.has(deviceId)) this.occupancyBurstFound.add(deviceId);
@@ -7444,13 +7614,26 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 			if (source === "analyzer" && cameraOwnsMotionViaSensor(attachment.config.motionSources)) return;
 			this.runner?.reportMotion(deviceId, data.detected, source, data.regions ? [...data.regions] : void 0);
 		});
-		if (this.ctx.eventBus) this.unsubBatteryEvents = this.ctx.eventBus.subscribe({ category: require_dist.EventCategory.BatteryOnStatusChanged }, (event) => {
-			const data = event.data;
-			const deviceId = data.deviceId;
-			if (typeof deviceId !== "number") return;
-			if (data.status?.sleeping === true) this.sleepingBatteryDevices.add(deviceId);
-			else this.sleepingBatteryDevices.delete(deviceId);
-		});
+		if (this.ctx.eventBus) {
+			this.unsubNativeDetections = this.ctx.eventBus.subscribe({ category: require_dist.EventCategory.DetectionCameraNative }, (event) => {
+				const data = event.data;
+				const deviceId = data.cameraId;
+				if (typeof deviceId !== "number") return;
+				const attachment = this.attached.get(deviceId);
+				if (!attachment) return;
+				if (!planDetectionSources(attachment.config.detectionSources).runsOnboard) return;
+				const detections = data.detections;
+				if (!detections || detections.length === 0) return;
+				this.runner?.reportNativeDetection(deviceId, detections, data.frameWidth, data.frameHeight);
+			});
+			this.unsubBatteryEvents = this.ctx.eventBus.subscribe({ category: require_dist.EventCategory.BatteryOnStatusChanged }, (event) => {
+				const data = event.data;
+				const deviceId = data.deviceId;
+				if (typeof deviceId !== "number") return;
+				if (data.status?.sleeping === true) this.sleepingBatteryDevices.add(deviceId);
+				else this.sleepingBatteryDevices.delete(deviceId);
+			});
+		}
 		this.metricsSnapshotTimer = setInterval(() => this.emitMetricsSnapshot(), METRICS_SNAPSHOT_INTERVAL_MS);
 		return {
 			providers: [
@@ -7499,6 +7682,10 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 			this.unsubMotionEvents();
 			this.unsubMotionEvents = null;
 		}
+		if (this.unsubNativeDetections) {
+			this.unsubNativeDetections();
+			this.unsubNativeDetections = null;
+		}
 		if (this.unsubBatteryEvents) {
 			this.unsubBatteryEvents();
 			this.unsubBatteryEvents = null;
@@ -10611,7 +10798,7 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 			teardown();
 		}
 	}
-	emitInferenceResult(deviceId, frame, result, handle) {
+	emitInferenceResult(deviceId, frame, result, handle, source) {
 		if (!this.ctx?.eventBus) return;
 		const capturedAt = frame.capturedAt;
 		const detailSteps = this.attached.get(deviceId)?.detailSteps;
@@ -10622,7 +10809,8 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 			frameHandle: handle,
 			emittedAt: Date.now(),
 			...typeof capturedAt === "number" && capturedAt > 0 ? { capturedAt } : {},
-			...detailSteps && detailSteps.length > 0 ? { detailSteps } : {}
+			...detailSteps && detailSteps.length > 0 ? { detailSteps } : {},
+			source
 		};
 		this.ctx.eventBus.emit(require_dist.createEvent(require_dist.EventCategory.PipelineInferenceResult, {
 			type: "device",

package/dist/pipeline-runner/index.mjs

@@ -1,6 +1,6 @@
-import { B as customAction, G as deriveDetailCropRect, Kt as BaseAddon, S as NativeLeaseSettingsSchema, St as pipelineRunnerCapability, U as defineCustomActions, Zt as createEvent, _ as FailureCounters, b as MOTION_CLOSE_AFTER_MS, bn as EventCategory, bt as pickNativeLeaseOverride, cn as _enum, fn as lazy, hn as object, ln as array, m as DEVICE_BACKEND_TO_FORMAT, mn as number, ot as loadContributionCapability, p as DEFAULT_NATIVE_LEASE_SETTINGS, pn as literal, rn as nodePin, tt as failureContributionCapability, u as DEFAULT_DETAIL_CROP_CONVENTION, un as boolean, vn as string, x as NativeLeaseAdmissionSchema, yt as pickDetailCropConvention, zt as errMsg } from "../dist-DTPYOq7J.mjs";
-import { i as NO_COST_CLAIM, t as ChildCostRegistry } from "../node-Cz92fVGW.mjs";
-import { i as resolveFrameViewGeometry, l as getStepDefinition, r as localFrameRegistry } from "../default-detection-model-DC4yVaFM.mjs";
+import { B as customAction, G as deriveDetailCropRect, Kt as BaseAddon, S as NativeLeaseSettingsSchema, St as pipelineRunnerCapability, U as defineCustomActions, Zt as createEvent, _ as FailureCounters, b as MOTION_CLOSE_AFTER_MS, bn as EventCategory, bt as pickNativeLeaseOverride, cn as _enum, fn as lazy, hn as object, ln as array, m as DEVICE_BACKEND_TO_FORMAT, mn as number, ot as loadContributionCapability, p as DEFAULT_NATIVE_LEASE_SETTINGS, pn as literal, rn as nodePin, tt as failureContributionCapability, u as DEFAULT_DETAIL_CROP_CONVENTION, un as boolean, vn as string, x as NativeLeaseAdmissionSchema, yt as pickDetailCropConvention, zt as errMsg } from "../dist-But4XMDJ.mjs";
+import { i as NO_COST_CLAIM, t as ChildCostRegistry } from "../node-BHxRrsoX.mjs";
+import { i as resolveFrameViewGeometry, l as getStepDefinition, r as localFrameRegistry } from "../default-detection-model-I8kuDTEi.mjs";
 import { t as isWorkerReply } from "../worker-protocol-C_W-P_g-.mjs";
 import { t as resolveHubHostname } from "../hub-hostname-cCknRYKj.mjs";
 import { t as getSharp } from "../lazy-sharp-DXsqwpph.mjs";
@@ -2089,6 +2089,73 @@ function startSessionDecodePump(deps) {
 		iterator.return().catch(() => {});
 	};
 }
+/**
+* Read the camera's `detectionSources`.
+*
+* ABSENT is the pipeline — a runner or an attach older than the field behaves
+* exactly as it always did. EMPTY is not the same thing and must never be
+* widened into "everything": it is a camera an operator left with no root
+* detector, and inventing one for them is how a default acts without anybody
+* choosing it.
+*/
+function planDetectionSources(sources) {
+	if (sources === void 0) return {
+		runsPipeline: true,
+		runsOnboard: false
+	};
+	return {
+		runsPipeline: sources.includes("pipeline"),
+		runsOnboard: sources.includes("onboard")
+	};
+}
+/** Clamp a denormalised box into the frame; a firmware box may exceed it. */
+function clamp(value, max) {
+	return Math.max(0, Math.min(value, max));
+}
+/**
+* Pair the camera's last detections with a decoded frame, in the FRAME's pixel
+* space.
+*
+* The old converter denormalised against a nominal 1000×1000 when the push
+* carried no dimensions, and documented that consumers should treat a native
+* bbox as relative. That was survivable while nothing cut pixels from it. Here
+* the boxes travel with a real frame and a real handle, so they are scaled to
+* that frame — the same space every other detection on this plane lives in.
+*/
+function onboardRootDetections(slot, frame) {
+	if (slot === null || slot.detections.length === 0) return { kind: "none" };
+	const ageMs = Math.abs(frame.timestamp - slot.at);
+	if (ageMs > 1e3) return {
+		kind: "expired",
+		ageMs
+	};
+	const boxed = slot.detections.filter((d) => d.bbox != null);
+	if (boxed.length === 0) return {
+		kind: "no-geometry",
+		classes: slot.detections.map((d) => d.class)
+	};
+	return {
+		kind: "paired",
+		detections: boxed.map((d, i) => {
+			const [nx, ny, nw, nh] = d.bbox;
+			const x = clamp(nx * frame.width, frame.width);
+			const y = clamp(ny * frame.height, frame.height);
+			return {
+				id: `onboard-${String(slot.at)}-${String(i)}`,
+				kind: "first-level",
+				macroClass: d.class,
+				score: d.confidence ?? 1,
+				labels: [],
+				bbox: {
+					x,
+					y,
+					width: clamp(nw * frame.width, frame.width - x),
+					height: clamp(nh * frame.height, frame.height - y)
+				}
+			};
+		})
+	};
+}
 //#endregion
 //#region src/pipeline-runner/bench-step-schema.ts
 /**
@@ -5636,6 +5703,8 @@ var PipelineRunner = class {
 	cameras = /* @__PURE__ */ new Map();
 	semaphore;
 	resultCallbacks = [];
+	/** Last report per `deviceId:reason` for {@link noteOnboardRootIdle}. */
+	onboardIdleReportedAt = /* @__PURE__ */ new Map();
 	defaultRoundRobinKeys = [];
 	defaultRoundRobinIndex = 0;
 	intervalHandle = null;
@@ -5716,6 +5785,7 @@ var PipelineRunner = class {
 		const initialPhase = registration.detectionMode === "disabled" ? "idle" : registration.detectionMode === "always-on" ? "active" : "watching";
 		const state = {
 			registration,
+			onboardSlot: null,
 			motionQueue,
 			detectionQueue,
 			preRollQueue: new PreRollLane({
@@ -6192,6 +6262,15 @@ var PipelineRunner = class {
 		const { frame, handle } = entry;
 		state.inflight += 1;
 		const enqueuedAt = frame._enqueuedAt ?? pickedAt;
+		const plan = planDetectionSources(state.registration.detectionSources);
+		if (!plan.runsPipeline) {
+			try {
+				await this.processOnboardRoot(deviceId, entry, state, streamType, plan);
+			} finally {
+				state.inflight -= 1;
+			}
+			return;
+		}
 		const rawRelease = await this.semaphore.acquire();
 		let released = false;
 		const release = () => {
@@ -6215,7 +6294,7 @@ var PipelineRunner = class {
 			state.processedCount++;
 			if (result) {
 				if (result.shed === true) state.shedFrames++;
-				await this.notifyCallbacks(deviceId, frame, result, streamType, handle);
+				await this.notifyCallbacks(deviceId, frame, result, streamType, handle, "pipeline");
 				frameReleaseReason = "success";
 				const emittedAt = Date.now();
 				const capturedAt = frame.capturedAt;
@@ -6242,6 +6321,96 @@ var PipelineRunner = class {
 		}
 	}
 	/**
+	* The CAMERA is this camera's root step.
+	*
+	* Same shape as the pipeline path and deliberately so: one decoded frame, one
+	* `FrameResult`, the same `notifyCallbacks`, the same handle, the same
+	* retention release. Everything downstream — subject tiles, birth evidence,
+	* the `detailSteps` announce, the overlay, the tracker — cannot tell which
+	* detector produced the boxes, which is the entire point. What it does NOT do
+	* is take an inference permit: the accelerator is never asked.
+	*
+	* A frame with no fresh onboard detection produces NO result rather than an
+	* empty one. An empty `FrameResult` is a positive statement ("I looked and
+	* there was nothing"), and this path did not look — it decoded a frame while
+	* the camera happened to be silent. Emitting emptiness would tell the
+	* tracker every silent frame is evidence of absence and coast every subject
+	* to death between two pushes.
+	*/
+	async processOnboardRoot(deviceId, entry, state, streamType, plan) {
+		const { frame, handle } = entry;
+		let frameReleaseReason = "drop";
+		try {
+			if (!plan.runsOnboard) {
+				this.noteOnboardRootIdle(deviceId, "no-source");
+				return;
+			}
+			const pairing = onboardRootDetections(state.onboardSlot, {
+				timestamp: Date.now(),
+				width: frame.width,
+				height: frame.height
+			});
+			if (pairing.kind !== "paired") {
+				this.noteOnboardRootIdle(deviceId, pairing.kind);
+				return;
+			}
+			state.onboardSlot = null;
+			state.processedCount++;
+			const result = {
+				kind: "frame",
+				frameId: `onboard-${String(deviceId)}-${String(frame.timestamp)}`,
+				deviceId,
+				timestamp: Date.now(),
+				width: frame.width,
+				height: frame.height,
+				detections: pairing.detections
+			};
+			state.lastResultDetections = pairing.detections.length;
+			await this.notifyCallbacks(deviceId, frame, result, streamType, handle, "onboard");
+			frameReleaseReason = "success";
+		} catch {
+			frameReleaseReason = "error";
+		} finally {
+			try {
+				if (frameReleaseReason === "success" && handle && isContinuousRetainEnabled()) await this.config.hydrateRetainedFrame?.(handle);
+			} catch {}
+			if (handle) this.config.releaseRetention?.(handle, frameReleaseReason);
+			if (frame.frameRef) this.config.releaseFrameRef?.(frame.frameRef, frameReleaseReason);
+		}
+	}
+	/**
+	* Report — once per camera per interval — that the onboard root step decoded
+	* a frame and produced nothing, with WHICH of the reasons it was. Sampled
+	* because it fires at detection fps on a silent camera, which is most of the
+	* time and is not itself a fault.
+	*/
+	noteOnboardRootIdle(deviceId, reason) {
+		const now = Date.now();
+		const key = `${String(deviceId)}:${reason}`;
+		if (now - (this.onboardIdleReportedAt.get(key) ?? 0) < 6e4) return;
+		this.onboardIdleReportedAt.set(key, now);
+		this.logger?.info("onboard root step produced nothing for a decoded frame", {
+			tags: { deviceId },
+			meta: { reason }
+		});
+	}
+	/**
+	* The camera spoke. Held until a decoded frame can be paired with it.
+	*
+	* Gated by the CALLER on `detectionSources` — this method is the mechanism,
+	* not the policy, and a camera that does not name `onboard` never reaches it.
+	*/
+	reportNativeDetection(deviceId, detections, frameWidth, frameHeight) {
+		const state = this.cameras.get(deviceId);
+		if (!state) return;
+		state.onboardSlot = {
+			at: Date.now(),
+			detections,
+			...frameWidth !== void 0 ? { frameWidth } : {},
+			...frameHeight !== void 0 ? { frameHeight } : {}
+		};
+	}
+	/**
 	* Await `processFrame` with a hard bound. On expiry the permit is released
 	* immediately (via the caller's release-once closure) and {@link TIMED_OUT}
 	* is returned; the underlying call is left to settle into the void, since
@@ -6326,9 +6495,9 @@ var PipelineRunner = class {
 			});
 		}
 	}
-	async notifyCallbacks(deviceId, frame, result, streamType, handle) {
+	async notifyCallbacks(deviceId, frame, result, streamType, handle, source) {
 		for (const callback of this.resultCallbacks) try {
-			await callback(deviceId, frame, result, streamType, handle);
+			await callback(deviceId, frame, result, streamType, handle, source);
 		} catch {}
 	}
 	pickNextDetectionFrame() {
@@ -7152,6 +7321,7 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 	/** Last runtime-label failure, so only a CHANGE is logged (D463). */
 	lastRuntimeInfoFailure = null;
 	unsubMotionEvents = null;
+	unsubNativeDetections = null;
 	/** Devices we have positively observed reporting `battery.sleeping: true`.
 	*  Absent = unknown or awake; both mean "do not gate" (D49). Fed only by
 	*  `BatteryOnStatusChanged`, so consulting it costs nothing and can never
@@ -7408,11 +7578,11 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 		this.runner.onDetectionStreamChange((deviceId, action) => {
 			this.handleDetectionStreamChange(deviceId, action);
 		});
-		this.runner.onResult(async (deviceId, frame, result, _streamType, handle) => {
+		this.runner.onResult(async (deviceId, frame, result, _streamType, handle, source) => {
 			this.retention?.noteInferenceResult(deviceId, handle, result);
 			this.cutSubjectTiles(deviceId, result, handle);
 			const carried = await this.attachBirthEvidence(deviceId, frame, result);
-			this.emitInferenceResult(deviceId, frame, carried, handle);
+			this.emitInferenceResult(deviceId, frame, carried, handle, source);
 			const detectionCount = result.detections?.length ?? 0;
 			this.runner?.noteDetectionResult(deviceId, detectionCount);
 			if (detectionCount > 0 && this.occupancyBurstInFlight.has(deviceId)) this.occupancyBurstFound.add(deviceId);
@@ -7436,13 +7606,26 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 			if (source === "analyzer" && cameraOwnsMotionViaSensor(attachment.config.motionSources)) return;
 			this.runner?.reportMotion(deviceId, data.detected, source, data.regions ? [...data.regions] : void 0);
 		});
-		if (this.ctx.eventBus) this.unsubBatteryEvents = this.ctx.eventBus.subscribe({ category: EventCategory.BatteryOnStatusChanged }, (event) => {
-			const data = event.data;
-			const deviceId = data.deviceId;
-			if (typeof deviceId !== "number") return;
-			if (data.status?.sleeping === true) this.sleepingBatteryDevices.add(deviceId);
-			else this.sleepingBatteryDevices.delete(deviceId);
-		});
+		if (this.ctx.eventBus) {
+			this.unsubNativeDetections = this.ctx.eventBus.subscribe({ category: EventCategory.DetectionCameraNative }, (event) => {
+				const data = event.data;
+				const deviceId = data.cameraId;
+				if (typeof deviceId !== "number") return;
+				const attachment = this.attached.get(deviceId);
+				if (!attachment) return;
+				if (!planDetectionSources(attachment.config.detectionSources).runsOnboard) return;
+				const detections = data.detections;
+				if (!detections || detections.length === 0) return;
+				this.runner?.reportNativeDetection(deviceId, detections, data.frameWidth, data.frameHeight);
+			});
+			this.unsubBatteryEvents = this.ctx.eventBus.subscribe({ category: EventCategory.BatteryOnStatusChanged }, (event) => {
+				const data = event.data;
+				const deviceId = data.deviceId;
+				if (typeof deviceId !== "number") return;
+				if (data.status?.sleeping === true) this.sleepingBatteryDevices.add(deviceId);
+				else this.sleepingBatteryDevices.delete(deviceId);
+			});
+		}
 		this.metricsSnapshotTimer = setInterval(() => this.emitMetricsSnapshot(), METRICS_SNAPSHOT_INTERVAL_MS);
 		return {
 			providers: [
@@ -7491,6 +7674,10 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 			this.unsubMotionEvents();
 			this.unsubMotionEvents = null;
 		}
+		if (this.unsubNativeDetections) {
+			this.unsubNativeDetections();
+			this.unsubNativeDetections = null;
+		}
 		if (this.unsubBatteryEvents) {
 			this.unsubBatteryEvents();
 			this.unsubBatteryEvents = null;
@@ -10603,7 +10790,7 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 			teardown();
 		}
 	}
-	emitInferenceResult(deviceId, frame, result, handle) {
+	emitInferenceResult(deviceId, frame, result, handle, source) {
 		if (!this.ctx?.eventBus) return;
 		const capturedAt = frame.capturedAt;
 		const detailSteps = this.attached.get(deviceId)?.detailSteps;
@@ -10614,7 +10801,8 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 			frameHandle: handle,
 			emittedAt: Date.now(),
 			...typeof capturedAt === "number" && capturedAt > 0 ? { capturedAt } : {},
-			...detailSteps && detailSteps.length > 0 ? { detailSteps } : {}
+			...detailSteps && detailSteps.length > 0 ? { detailSteps } : {},
+			source
 		};
 		this.ctx.eventBus.emit(createEvent(EventCategory.PipelineInferenceResult, {
 			type: "device",

package/dist/{process-memory-BwijtYhM.mjs → process-memory-C3-EOjjf.mjs}

@@ -1,4 +1,4 @@
-import { gt as parseProcStatus } from "./dist-DTPYOq7J.mjs";
+import { gt as parseProcStatus } from "./dist-But4XMDJ.mjs";
 import * as fs from "node:fs";
 import { execFile } from "node:child_process";
 //#region src/shared/node-topology-platform.ts

package/dist/{process-memory-COypUeEc.js → process-memory-C5_Mo9TI.js}

@@ -1,5 +1,5 @@
 const require_chunk = require("./chunk-emK7D4bc.js");
-const require_dist = require("./dist-p5lZW8pr.js");
+const require_dist = require("./dist-NX0e_oWp.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
 let node_child_process = require("node:child_process");

package/dist/recorder/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-p5lZW8pr.js");
-const require_node = require("../node-CGVUk5S9.js");
+const require_dist = require("../dist-NX0e_oWp.js");
+const require_node = require("../node-BgM4n8D4.js");
 const require_hub_hostname = require("../hub-hostname-DAJXlOgV.js");
 const require_restream_intent = require("../restream-intent-C4adO0P8.js");
 const require_retire_root_keys = require("../retire-root-keys-Csb8z2f3.js");
@@ -10905,6 +10905,7 @@ Object.freeze({
 			"motionFps": 4,
 			"detectionFps": 10,
 			"motionSources": ["analyzer"],
+			"detectionSources": ["pipeline"],
 			"pipelineEnabled": true,
 			"zones": [],
 			"onboardMotionDrivesAnalyzer": true,