@camstack/addon-pipeline 1.2.232 → 1.2.234

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-CoRJjU1W.js");
-const require_process_memory = require("../process-memory-CIOO13cP.js");
+const require_dist = require("../dist-NX0e_oWp.js");
+const require_process_memory = require("../process-memory-C5_Mo9TI.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 { $t as hydrateSchema, At as resolvePoolMemoryPolicy, Kt as BaseAddon, N as audioAnalysisCapability, P as audioAnalyzerCapability, Qt as expandAudioChunkToF32le, Xt as audioChunkBytesPerSample, bn as EventCategory, ct as mapAudioLabelToMacro, n as AUDIO_BACKEND_CHOICES, rn as nodePin, s as DEFAULT_AUDIO_ANALYZER_CONFIG, w as PoolMemoryWatchdog, y as HF_BASE_URL, zt as errMsg } from "../dist-BwQxOtXy.mjs";
-import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-62FAABqk.mjs";
+import { $t as hydrateSchema, At as resolvePoolMemoryPolicy, Kt as BaseAddon, N as audioAnalysisCapability, P as audioAnalyzerCapability, Qt as expandAudioChunkToF32le, Xt as audioChunkBytesPerSample, bn as EventCategory, ct as mapAudioLabelToMacro, n as AUDIO_BACKEND_CHOICES, rn as nodePin, s as DEFAULT_AUDIO_ANALYZER_CONFIG, w as PoolMemoryWatchdog, y as HF_BASE_URL, zt as errMsg } from "../dist-But4XMDJ.mjs";
+import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-C3-EOjjf.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-DcB4--Xd.js → default-detection-model-CDhXxOJQ.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-CoRJjU1W.js");
+const require_dist = require("./dist-NX0e_oWp.js");
 let node_crypto = require("node:crypto");
 //#region src/detection-pipeline/pipeline/landmark-precision-gate.ts
 /**

package/dist/{default-detection-model-DNsmwQx0.mjs → default-detection-model-I8kuDTEi.mjs}

@@ -1,4 +1,4 @@
-import { F as audioKindId, a as COCO_80_LABELS, o as COCO_TO_MACRO, r as AUDIO_MACRO_LABELS, rt as hfModelUrl } from "./dist-BwQxOtXy.mjs";
+import { F as audioKindId, a as COCO_80_LABELS, o as COCO_TO_MACRO, r as AUDIO_MACRO_LABELS, rt as hfModelUrl } from "./dist-But4XMDJ.mjs";
 import { randomUUID } from "node:crypto";
 //#region src/detection-pipeline/pipeline/landmark-precision-gate.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-CoRJjU1W.js");
-const require_node = require("../node-DvcGhYd4.js");
-const require_default_detection_model = require("../default-detection-model-DcB4--Xd.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_lazy_sharp = require("../lazy-sharp-BuwKlQLR.js");
-const require_process_memory = require("../process-memory-CIOO13cP.js");
+const require_process_memory = require("../process-memory-C5_Mo9TI.js");
 let node_os = require("node:os");
 node_os = require_chunk.__toESM(node_os);
 let node_fs = require("node:fs");

package/dist/detection-pipeline/index.mjs

@@ -1,9 +1,9 @@
 import { n as __require } from "../chunk-DnnnRqeS.mjs";
-import { $t as hydrateSchema, At as resolvePoolMemoryPolicy, Dt as resolveClusterStepModelId, H as defaultDeviceFor$1, Kt as BaseAddon, Lt as supportedRuntimes$1, Mt as runtimeDevices$1, Q as evaluateZoneRules, X as enumerateInferenceDevices, Zt as createEvent, _t as pickClusterStepModels, bn as EventCategory, c as DEFAULT_CLUSTER_STEP_MODELS, hn as object, ht as overlayClusterStepSettings, in as parseJsonUnknown, it as inferModelProvider, j as YAMNET_TO_MACRO, l as DEFAULT_CLUSTER_STEP_SETTINGS, ln as array, m as DEVICE_BACKEND_TO_FORMAT, ot as loadContributionCapability, q as detectionPipelineCapability, rn as nodePin, sn as sleep, t as APPLE_SA_TO_MACRO, vn as string, vt as pickClusterStepSettings, w as PoolMemoryWatchdog, xt as pipelineExecutorCapability, yn as union, zt as errMsg } from "../dist-BwQxOtXy.mjs";
-import { o as readProcessCost } from "../node-BjScdHzE.mjs";
-import { a as ALL_PIPELINE_STEPS, c as getStep, d as landmarkPrecisionVerdict, l as getStepDefinition, n as resolveDefaultDetectionModel, o as ALL_STEPS, r as localFrameRegistry, s as getDefaultModelForFormat, u as resolveModelForFormat } from "../default-detection-model-DNsmwQx0.mjs";
+import { $t as hydrateSchema, At as resolvePoolMemoryPolicy, Dt as resolveClusterStepModelId, H as defaultDeviceFor$1, Kt as BaseAddon, Lt as supportedRuntimes$1, Mt as runtimeDevices$1, Q as evaluateZoneRules, X as enumerateInferenceDevices, Zt as createEvent, _t as pickClusterStepModels, bn as EventCategory, c as DEFAULT_CLUSTER_STEP_MODELS, hn as object, ht as overlayClusterStepSettings, in as parseJsonUnknown, it as inferModelProvider, j as YAMNET_TO_MACRO, l as DEFAULT_CLUSTER_STEP_SETTINGS, ln as array, m as DEVICE_BACKEND_TO_FORMAT, ot as loadContributionCapability, q as detectionPipelineCapability, rn as nodePin, sn as sleep, t as APPLE_SA_TO_MACRO, vn as string, vt as pickClusterStepSettings, w as PoolMemoryWatchdog, xt as pipelineExecutorCapability, yn as union, zt as errMsg } from "../dist-But4XMDJ.mjs";
+import { o as readProcessCost } from "../node-BHxRrsoX.mjs";
+import { a as ALL_PIPELINE_STEPS, c as getStep, d as landmarkPrecisionVerdict, l as getStepDefinition, n as resolveDefaultDetectionModel, o as ALL_STEPS, r as localFrameRegistry, s as getDefaultModelForFormat, u as resolveModelForFormat } from "../default-detection-model-I8kuDTEi.mjs";
 import { t as getSharp } from "../lazy-sharp-DXsqwpph.mjs";
-import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-62FAABqk.mjs";
+import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-C3-EOjjf.mjs";
 import * as os from "node:os";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";

package/dist/{dist-BwQxOtXy.mjs → dist-But4XMDJ.mjs}

@@ -23916,6 +23916,14 @@ var MotionSourceEnum = _enum([
 */
 var MotionSourcesSchema = array(MotionSourceEnum);
 /**
+* Which root detectors a camera runs. Deliberately the SAME vocabulary
+* post-analysis already tags every detection with (`DetectionSource`) rather
+* than a second spelling of the same two ideas — the value an operator picks
+* here is the value that comes back on the track, the overlay and the debug
+* row.
+*/
+var DetectionSourcesSchema = array(DetectionSourceSchema);
+/**
 * Input shape for `pipeline-runner.reportMotion` cap method. Exported
 * so cap-side consumers (the orchestrator forward, the runner addon's
 * cap implementation, tests) can reuse the type instead of redeclaring
@@ -24066,6 +24074,35 @@ var RunnerCameraConfigSchema = object({
 	*   events; the orchestrator forwards to `reportMotion`.
 	*/
 	motionSources: MotionSourcesSchema.default(["analyzer"]),
+	/**
+	* WHICH root detector runs for this camera. The detection counterpart of
+	* {@link motionSources}, same shape and same discipline: a per-camera list
+	* of sources the system understands, vendor-agnostic, owned here.
+	*
+	* - `pipeline` — this runner's own root step on decoded pixels (`steps`).
+	* - `onboard` — the CAMERA's own detector, admitted only when it is named
+	*   here. Its boxes reach post-analysis on the same
+	*   `PipelineInferenceResult` payload as the pipeline's, so an onboard-born
+	*   track gets the same tracker, the same overlay and the same detail
+	*   subtree (face / plate / embedding).
+	*
+	* `['onboard']` alone is the REPLACEMENT: this runner's root step does not
+	* run, and that is where a camera with a usable onboard detector buys back
+	* its share of the accelerator. It saves the root inference, not the decode
+	* — the detail subtree still needs pixels to cut crops from.
+	*
+	* A camera whose onboard detections carry no geometry cannot serve as a root
+	* step at all (there is nothing to track), and the cap that knows this says
+	* so on `native-object-detection.getOptions().geometry`. On Reolink that is
+	* every battery camera: the boxes ride a sub-stream a battery camera never
+	* attaches, so such a camera stays on `['pipeline']` and its onboard AI is
+	* worth exactly what it already is — a wake signal with a class.
+	*
+	* Defaults to `['pipeline']`, which is byte-for-byte today's behaviour: a
+	* vendor never turns a detector on for the operator, and neither does a
+	* default.
+	*/
+	detectionSources: DetectionSourcesSchema.default(["pipeline"]),
 	pipelineEnabled: boolean().default(true),
 	/** Ordered tree of video steps. Absent → runner skips video detection. */
 	steps: array(PipelineStepInputSchema).readonly().optional(),
@@ -30124,31 +30161,38 @@ var NativeObjectDetectionStatusSchema = object({
 	/**
 	* Whether forwarding of onboard AI detections is enabled for this device.
 	*
-	* The COLD-START default is the provider's, and it is not one value for
-	* every camera: a mains camera carries the boxed side-channel and its
-	* detections are usable subjects, so it defaults ON; a battery camera never
-	* attaches that channel, so the same toggle would buy it nothing but a write
-	* — it defaults OFF and an operator who wants it turns it on knowing what it
-	* costs. {@link NativeObjectDetectionOptionsSchema.geometry} is how the UI
-	* says which of the two a camera is.
+	* Cold-start OFF on every camera. A vendor does not decide which detector a
+	* camera runs — that is the operator's choice, and it is made where every
+	* other detection choice is made. `geometry` on
+	* {@link NativeObjectDetectionOptionsSchema} is how the form says what the
+	* choice would buy this particular camera.
 	*/
 	enabled: boolean()
 });
 /**
-* What a camera's onboard detections actually CARRY.
+* WHEN a camera's onboard detections carry geometry.
 *
-* `boxed` — the firmware ships a bounding box with the class, so a detection is
-* a subject the pipeline can track, crop and score.
-* `flag-only` — the firmware ships the class and nothing else. The pipeline
-* needs geometry to make a subject out of it, so such a push reaches the
-* tracker as motion and no further. On Reolink this is every battery camera:
-* the boxes ride the BcMedia sub-stream, which a battery camera never attaches.
+* - `boxed` — always. The provider holds a standing channel for the boxes, so
+*   a detection is a trackable subject whenever the camera sees one.
+* - `while-streaming` — only while some stream of this camera is already open.
+*   The boxes ride the video's own side-channel rather than a feed of their
+*   own, so they cost nothing and they exist only when something is pulling.
+*   On Reolink this is every BATTERY camera: a persistent second feed is real
+*   radio drain, but a camera that is awake is awake precisely because
+*   something is in front of it, and its stream is already being pulled.
+* - `flag-only` — never. The firmware ships the class and nothing else; the
+*   pipeline needs geometry to make a subject, so such a push reaches the
+*   tracker as motion and no further.
 *
 * Reported and not inferred, because the operator's question in front of the
-* toggle is "what do I get", and "a class with no box" and "a subject" are
-* different answers (D14: the derived form is only as honest as `getOptions`).
+* picker is "what do I get", and these are three different answers (D14: the
+* derived form is only as honest as `getOptions`).
 */
-var NativeObjectGeometryEnum = _enum(["boxed", "flag-only"]);
+var NativeObjectGeometryEnum = _enum([
+	"boxed",
+	"while-streaming",
+	"flag-only"
+]);
 var NativeObjectDetectionOptionsSchema = object({
 	/** Classes this firmware can detect — the same list the status reports. */
 	supportedClasses: array(NativeObjectClassEnum).readonly(),

package/dist/{dist-CoRJjU1W.js → dist-NX0e_oWp.js}

@@ -23916,6 +23916,14 @@ var MotionSourceEnum = _enum([
 */
 var MotionSourcesSchema = array(MotionSourceEnum);
 /**
+* Which root detectors a camera runs. Deliberately the SAME vocabulary
+* post-analysis already tags every detection with (`DetectionSource`) rather
+* than a second spelling of the same two ideas — the value an operator picks
+* here is the value that comes back on the track, the overlay and the debug
+* row.
+*/
+var DetectionSourcesSchema = array(DetectionSourceSchema);
+/**
 * Input shape for `pipeline-runner.reportMotion` cap method. Exported
 * so cap-side consumers (the orchestrator forward, the runner addon's
 * cap implementation, tests) can reuse the type instead of redeclaring
@@ -24066,6 +24074,35 @@ var RunnerCameraConfigSchema = object({
 	*   events; the orchestrator forwards to `reportMotion`.
 	*/
 	motionSources: MotionSourcesSchema.default(["analyzer"]),
+	/**
+	* WHICH root detector runs for this camera. The detection counterpart of
+	* {@link motionSources}, same shape and same discipline: a per-camera list
+	* of sources the system understands, vendor-agnostic, owned here.
+	*
+	* - `pipeline` — this runner's own root step on decoded pixels (`steps`).
+	* - `onboard` — the CAMERA's own detector, admitted only when it is named
+	*   here. Its boxes reach post-analysis on the same
+	*   `PipelineInferenceResult` payload as the pipeline's, so an onboard-born
+	*   track gets the same tracker, the same overlay and the same detail
+	*   subtree (face / plate / embedding).
+	*
+	* `['onboard']` alone is the REPLACEMENT: this runner's root step does not
+	* run, and that is where a camera with a usable onboard detector buys back
+	* its share of the accelerator. It saves the root inference, not the decode
+	* — the detail subtree still needs pixels to cut crops from.
+	*
+	* A camera whose onboard detections carry no geometry cannot serve as a root
+	* step at all (there is nothing to track), and the cap that knows this says
+	* so on `native-object-detection.getOptions().geometry`. On Reolink that is
+	* every battery camera: the boxes ride a sub-stream a battery camera never
+	* attaches, so such a camera stays on `['pipeline']` and its onboard AI is
+	* worth exactly what it already is — a wake signal with a class.
+	*
+	* Defaults to `['pipeline']`, which is byte-for-byte today's behaviour: a
+	* vendor never turns a detector on for the operator, and neither does a
+	* default.
+	*/
+	detectionSources: DetectionSourcesSchema.default(["pipeline"]),
 	pipelineEnabled: boolean().default(true),
 	/** Ordered tree of video steps. Absent → runner skips video detection. */
 	steps: array(PipelineStepInputSchema).readonly().optional(),
@@ -30124,31 +30161,38 @@ var NativeObjectDetectionStatusSchema = object({
 	/**
 	* Whether forwarding of onboard AI detections is enabled for this device.
 	*
-	* The COLD-START default is the provider's, and it is not one value for
-	* every camera: a mains camera carries the boxed side-channel and its
-	* detections are usable subjects, so it defaults ON; a battery camera never
-	* attaches that channel, so the same toggle would buy it nothing but a write
-	* — it defaults OFF and an operator who wants it turns it on knowing what it
-	* costs. {@link NativeObjectDetectionOptionsSchema.geometry} is how the UI
-	* says which of the two a camera is.
+	* Cold-start OFF on every camera. A vendor does not decide which detector a
+	* camera runs — that is the operator's choice, and it is made where every
+	* other detection choice is made. `geometry` on
+	* {@link NativeObjectDetectionOptionsSchema} is how the form says what the
+	* choice would buy this particular camera.
 	*/
 	enabled: boolean()
 });
 /**
-* What a camera's onboard detections actually CARRY.
+* WHEN a camera's onboard detections carry geometry.
 *
-* `boxed` — the firmware ships a bounding box with the class, so a detection is
-* a subject the pipeline can track, crop and score.
-* `flag-only` — the firmware ships the class and nothing else. The pipeline
-* needs geometry to make a subject out of it, so such a push reaches the
-* tracker as motion and no further. On Reolink this is every battery camera:
-* the boxes ride the BcMedia sub-stream, which a battery camera never attaches.
+* - `boxed` — always. The provider holds a standing channel for the boxes, so
+*   a detection is a trackable subject whenever the camera sees one.
+* - `while-streaming` — only while some stream of this camera is already open.
+*   The boxes ride the video's own side-channel rather than a feed of their
+*   own, so they cost nothing and they exist only when something is pulling.
+*   On Reolink this is every BATTERY camera: a persistent second feed is real
+*   radio drain, but a camera that is awake is awake precisely because
+*   something is in front of it, and its stream is already being pulled.
+* - `flag-only` — never. The firmware ships the class and nothing else; the
+*   pipeline needs geometry to make a subject, so such a push reaches the
+*   tracker as motion and no further.
 *
 * Reported and not inferred, because the operator's question in front of the
-* toggle is "what do I get", and "a class with no box" and "a subject" are
-* different answers (D14: the derived form is only as honest as `getOptions`).
+* picker is "what do I get", and these are three different answers (D14: the
+* derived form is only as honest as `getOptions`).
 */
-var NativeObjectGeometryEnum = _enum(["boxed", "flag-only"]);
+var NativeObjectGeometryEnum = _enum([
+	"boxed",
+	"while-streaming",
+	"flag-only"
+]);
 var NativeObjectDetectionOptionsSchema = object({
 	/** Classes this firmware can detect — the same list the status reports. */
 	supportedClasses: array(NativeObjectClassEnum).readonly(),

package/dist/motion-wasm/index.js

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-CoRJjU1W.js");
+const require_dist = require("../dist-NX0e_oWp.js");
 const require_lazy_sharp = require("../lazy-sharp-BuwKlQLR.js");
 let node_fs = require("node:fs");
 let node_path = require("node:path");

package/dist/motion-wasm/index.mjs

@@ -1,4 +1,4 @@
-import { $t as hydrateSchema, Kt as BaseAddon, Q as evaluateZoneRules, Yt as DeviceType, mt as motionDetectionCapability } from "../dist-BwQxOtXy.mjs";
+import { $t as hydrateSchema, Kt as BaseAddon, Q as evaluateZoneRules, Yt as DeviceType, mt as motionDetectionCapability } from "../dist-But4XMDJ.mjs";
 import { t as getSharp } from "../lazy-sharp-DXsqwpph.mjs";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";

package/dist/{node-BjScdHzE.mjs → node-BHxRrsoX.mjs}

@@ -1,4 +1,4 @@
-import { Ht as buildFfmpegArgs, Vt as Fmp4BoxSplitter, Wt as isSoftwareDecode, zt as errMsg } from "./dist-BwQxOtXy.mjs";
+import { Ht as buildFfmpegArgs, Vt as Fmp4BoxSplitter, Wt as isSoftwareDecode, zt as errMsg } from "./dist-But4XMDJ.mjs";
 import { randomUUID } from "node:crypto";
 import { realpathSync } from "node:fs";
 import path from "node:path";

package/dist/{node-DvcGhYd4.js → node-BgM4n8D4.js}

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

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-CoRJjU1W.js");
-const require_node = require("../node-DvcGhYd4.js");
-const require_default_detection_model = require("../default-detection-model-DcB4--Xd.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",