@camstack/addon-pipeline 1.2.28 → 1.2.29

package/dist/detection-pipeline/index.js

@@ -4,7 +4,7 @@ Object.defineProperties(exports, {
 });
 const require_chunk = require("../chunk-emK7D4bc.js");
 const require_dist = require("../dist-DUHlZcWd.js");
-const require_step_definitions = require("../step-definitions-Bo1hJQQw.js");
+const require_step_definitions = require("../step-definitions-Drb9cWbB.js");
 const require_node_topology_platform = require("../node-topology-platform-CFZ7F4xW.js");
 const require_model_download_service_Cp9f4dk6 = require("../model-download-service-Cp9f4dk6-fsdDExML.js");
 let node_child_process = require("node:child_process");
@@ -2704,19 +2704,25 @@ async function nativeChildCrop(provider, bbox, imageWidth, imageHeight, maxWidth
 * DROPS detections outright, so it sits between that and a hard cut).
 */
 var FULL_FRAME_MAX_CONFIDENCE = .7;
+/** A cut only makes sense in (0, 1); anything else is treated as OFF rather
+*  than dropping every detection on a typo. */
+function isUsableHardAreaCut(ratio) {
+	return Number.isFinite(ratio) && ratio > 0 && ratio < 1;
+}
 /**
 * True when `bbox` is a near-full-frame LOW-confidence phantom that should be
 * DROPPED from the frame's detections (overlay / tracker / events / motion-wake).
 *
 * Rule (drop ⇔ returns true):
-*   (areaRatio ≥ {@link FULL_FRAME_AREA_RATIO}
-*      OR width  ≥ {@link FULL_FRAME_DIMENSION_RATIO} × frameWidth
-*      OR height ≥ {@link FULL_FRAME_DIMENSION_RATIO} × frameHeight)
-*   AND score < `maxConfidence`
+*   areaRatio ≥ `hardAreaRatio`                      ← score-independent, OFF by default
+*   OR (  (areaRatio ≥ {@link FULL_FRAME_AREA_RATIO}
+*          OR width  ≥ {@link FULL_FRAME_DIMENSION_RATIO} × frameWidth
+*          OR height ≥ {@link FULL_FRAME_DIMENSION_RATIO} × frameHeight)
+*         AND score < `maxConfidence` )
 *
-* A high-confidence detection (`score ≥ maxConfidence`) is trusted as a real
-* subject and always survives. Degenerate frame dimensions (≤0) carry no info
-* to reject on → not a phantom.
+* Below the hard cut a high-confidence detection (`score ≥ maxConfidence`) is
+* trusted as a real subject and survives. Degenerate frame dimensions (≤0)
+* carry no info to reject on → not a phantom.
 *
 * @param bbox absolute-pixel `[x1, y1, x2, y2]` box in source-frame coords.
 * @param frameWidth source frame width in px.
@@ -2725,10 +2731,26 @@ var FULL_FRAME_MAX_CONFIDENCE = .7;
 * @param maxConfidence confidence bar below which a full-frame box is a phantom
 *   (defaults to {@link FULL_FRAME_MAX_CONFIDENCE}; overridable by the caller so
 *   the bar can be threaded from detection settings without new cap methods).
+* @param hardAreaRatio area fraction at/above which the box is dropped NO
+*   MATTER the score. Defaults to {@link HARD_AREA_CUT_DISABLED} (off) — it is
+*   armed per camera, because a doorbell close-up legitimately fills the frame
+*   while an overhead courtyard box never does. Threaded from step settings as
+*   `fullFrameGuardHardAreaRatio`.
 */
-function isFullFramePhantomDetection(bbox, frameWidth, frameHeight, score, maxConfidence = FULL_FRAME_MAX_CONFIDENCE) {
+/**
+* True when a box trips the guard's GEOMETRY test (near-full-frame, or
+* edge-to-edge in one axis) but SURVIVES because its score cleared the
+* confidence bar.
+*
+* These are the ones worth counting: on 2026-07-30 device 615 produced six
+* such boxes in a day, at 0.710-0.787, and they were only found by an offline
+* sweep of stored events — nothing in production reported them. Arming the
+* hard-area cut on a camera should be a decision made from this count, not
+* from one incident.
+*/
+function isFullFrameSurvivor(bbox, frameWidth, frameHeight, score, maxConfidence = FULL_FRAME_MAX_CONFIDENCE) {
 	if (frameWidth <= 0 || frameHeight <= 0) return false;
-	if (score >= maxConfidence) return false;
+	if (score < maxConfidence) return false;
 	const [x1, y1, x2, y2] = bbox;
 	const w = x2 - x1;
 	const h = y2 - y1;
@@ -2737,6 +2759,19 @@ function isFullFramePhantomDetection(bbox, frameWidth, frameHeight, score, maxCo
 	if (h >= frameHeight * .98) return true;
 	return false;
 }
+function isFullFramePhantomDetection(bbox, frameWidth, frameHeight, score, maxConfidence = FULL_FRAME_MAX_CONFIDENCE, hardAreaRatio = 1) {
+	if (frameWidth <= 0 || frameHeight <= 0) return false;
+	const [x1, y1, x2, y2] = bbox;
+	const w = x2 - x1;
+	const h = y2 - y1;
+	const areaRatio = w * h / (frameWidth * frameHeight);
+	if (isUsableHardAreaCut(hardAreaRatio) && areaRatio >= hardAreaRatio) return true;
+	if (score >= maxConfidence) return false;
+	if (areaRatio >= .9) return true;
+	if (w >= frameWidth * .98) return true;
+	if (h >= frameHeight * .98) return true;
+	return false;
+}
 //#endregion
 //#region src/detection-pipeline/pipeline/plate-deskew.ts
 /**
@@ -3584,10 +3619,34 @@ var PipelineExecutor = class {
 					continue;
 				}
 				const fullFrameBar = rootStep.settings?.["fullFrameGuardMaxConfidence"];
-				if (isFullFramePhantomDetection(mutable.bbox, imageWidth, imageHeight, mutable.score, typeof fullFrameBar === "number" ? fullFrameBar : void 0)) {
-					if (debug) console.log(`[executor] drop det macro=${mutable.macroClass} score=${mutable.score} bbox=${JSON.stringify(mutable.bbox)} (full-frame phantom guard)`);
+				const fullFrameHardArea = rootStep.settings?.["fullFrameGuardHardAreaRatio"];
+				if (isFullFramePhantomDetection(mutable.bbox, imageWidth, imageHeight, mutable.score, typeof fullFrameBar === "number" ? fullFrameBar : void 0, typeof fullFrameHardArea === "number" ? fullFrameHardArea : void 0)) {
+					this.opts.logger?.info("full-frame phantom guard: detection dropped", {
+						tags: { deviceId },
+						meta: {
+							macroClass: mutable.macroClass,
+							score: mutable.score,
+							bbox: mutable.bbox,
+							frameWidth: imageWidth,
+							frameHeight: imageHeight,
+							areaRatio: imageWidth > 0 && imageHeight > 0 ? Math.round((mutable.bbox[2] - mutable.bbox[0]) * (mutable.bbox[3] - mutable.bbox[1]) / (imageWidth * imageHeight) * 1e3) / 1e3 : void 0,
+							bar: typeof fullFrameBar === "number" ? fullFrameBar : void 0,
+							hardAreaRatio: typeof fullFrameHardArea === "number" ? fullFrameHardArea : void 0
+						}
+					});
 					continue;
 				}
+				if (isFullFrameSurvivor(mutable.bbox, imageWidth, imageHeight, mutable.score, typeof fullFrameBar === "number" ? fullFrameBar : void 0)) this.opts.logger?.warn("full-frame box SURVIVED the guard on score", {
+					tags: { deviceId },
+					meta: {
+						macroClass: mutable.macroClass,
+						score: mutable.score,
+						bbox: mutable.bbox,
+						areaRatio: imageWidth > 0 && imageHeight > 0 ? Math.round((mutable.bbox[2] - mutable.bbox[0]) * (mutable.bbox[3] - mutable.bbox[1]) / (imageWidth * imageHeight) * 1e3) / 1e3 : void 0,
+						bar: typeof fullFrameBar === "number" ? fullFrameBar : void 0,
+						hint: "arm fullFrameGuardHardAreaRatio on this camera if these are phantoms"
+					}
+				});
 				try {
 					await this.executeChildren(rootStep.children, mutable, fullFrameJpegProvider, imageWidth, imageHeight, traceBuilder, stepTimings, ctx, poolAgg, runOpts?.plane, deviceId, nativeCropProvider);
 				} catch (err) {

package/dist/detection-pipeline/index.mjs

@@ -1,6 +1,6 @@
 import { n as __require } from "../chunk-DnnnRqeS.mjs";
 import { B as errMsg, E as evaluateZoneRules, F as runtimeDevices$1, G as createEvent, K as hydrateSchema, R as supportedRuntimes$1, T as enumerateInferenceDevices, V as BaseAddon, X as nodePin, Z as parseJsonUnknown, ct as object, dt as union, et as sleep, ft as EventCategory, h as YAMNET_TO_MACRO, j as pipelineExecutorCapability, nt as array, s as DEVICE_BACKEND_TO_FORMAT, t as APPLE_SA_TO_MACRO, ut as string, w as detectionPipelineCapability, x as defaultDeviceFor$1 } from "../dist-CsKaXmP8.mjs";
-import { a as getStepDefinition, i as getStep, n as ALL_STEPS, o as resolveModelForFormat, r as getDefaultModelForFormat, t as ALL_PIPELINE_STEPS } from "../step-definitions-C8A78dBi.mjs";
+import { a as getStepDefinition, i as getStep, n as ALL_STEPS, o as resolveModelForFormat, r as getDefaultModelForFormat, t as ALL_PIPELINE_STEPS } from "../step-definitions-1GIwU6R8.mjs";
 import { t as pickNodePlatformArch } from "../node-topology-platform-BkR_k6WT.mjs";
 import { a as ensureModel, o as isModelDownloaded, r as deleteModelFromDisk } from "../model-download-service-Cp9f4dk6-CwUb5v3Y.mjs";
 import { spawn } from "node:child_process";
@@ -2696,19 +2696,25 @@ async function nativeChildCrop(provider, bbox, imageWidth, imageHeight, maxWidth
 * DROPS detections outright, so it sits between that and a hard cut).
 */
 var FULL_FRAME_MAX_CONFIDENCE = .7;
+/** A cut only makes sense in (0, 1); anything else is treated as OFF rather
+*  than dropping every detection on a typo. */
+function isUsableHardAreaCut(ratio) {
+	return Number.isFinite(ratio) && ratio > 0 && ratio < 1;
+}
 /**
 * True when `bbox` is a near-full-frame LOW-confidence phantom that should be
 * DROPPED from the frame's detections (overlay / tracker / events / motion-wake).
 *
 * Rule (drop ⇔ returns true):
-*   (areaRatio ≥ {@link FULL_FRAME_AREA_RATIO}
-*      OR width  ≥ {@link FULL_FRAME_DIMENSION_RATIO} × frameWidth
-*      OR height ≥ {@link FULL_FRAME_DIMENSION_RATIO} × frameHeight)
-*   AND score < `maxConfidence`
+*   areaRatio ≥ `hardAreaRatio`                      ← score-independent, OFF by default
+*   OR (  (areaRatio ≥ {@link FULL_FRAME_AREA_RATIO}
+*          OR width  ≥ {@link FULL_FRAME_DIMENSION_RATIO} × frameWidth
+*          OR height ≥ {@link FULL_FRAME_DIMENSION_RATIO} × frameHeight)
+*         AND score < `maxConfidence` )
 *
-* A high-confidence detection (`score ≥ maxConfidence`) is trusted as a real
-* subject and always survives. Degenerate frame dimensions (≤0) carry no info
-* to reject on → not a phantom.
+* Below the hard cut a high-confidence detection (`score ≥ maxConfidence`) is
+* trusted as a real subject and survives. Degenerate frame dimensions (≤0)
+* carry no info to reject on → not a phantom.
 *
 * @param bbox absolute-pixel `[x1, y1, x2, y2]` box in source-frame coords.
 * @param frameWidth source frame width in px.
@@ -2717,10 +2723,26 @@ var FULL_FRAME_MAX_CONFIDENCE = .7;
 * @param maxConfidence confidence bar below which a full-frame box is a phantom
 *   (defaults to {@link FULL_FRAME_MAX_CONFIDENCE}; overridable by the caller so
 *   the bar can be threaded from detection settings without new cap methods).
+* @param hardAreaRatio area fraction at/above which the box is dropped NO
+*   MATTER the score. Defaults to {@link HARD_AREA_CUT_DISABLED} (off) — it is
+*   armed per camera, because a doorbell close-up legitimately fills the frame
+*   while an overhead courtyard box never does. Threaded from step settings as
+*   `fullFrameGuardHardAreaRatio`.
 */
-function isFullFramePhantomDetection(bbox, frameWidth, frameHeight, score, maxConfidence = FULL_FRAME_MAX_CONFIDENCE) {
+/**
+* True when a box trips the guard's GEOMETRY test (near-full-frame, or
+* edge-to-edge in one axis) but SURVIVES because its score cleared the
+* confidence bar.
+*
+* These are the ones worth counting: on 2026-07-30 device 615 produced six
+* such boxes in a day, at 0.710-0.787, and they were only found by an offline
+* sweep of stored events — nothing in production reported them. Arming the
+* hard-area cut on a camera should be a decision made from this count, not
+* from one incident.
+*/
+function isFullFrameSurvivor(bbox, frameWidth, frameHeight, score, maxConfidence = FULL_FRAME_MAX_CONFIDENCE) {
 	if (frameWidth <= 0 || frameHeight <= 0) return false;
-	if (score >= maxConfidence) return false;
+	if (score < maxConfidence) return false;
 	const [x1, y1, x2, y2] = bbox;
 	const w = x2 - x1;
 	const h = y2 - y1;
@@ -2729,6 +2751,19 @@ function isFullFramePhantomDetection(bbox, frameWidth, frameHeight, score, maxCo
 	if (h >= frameHeight * .98) return true;
 	return false;
 }
+function isFullFramePhantomDetection(bbox, frameWidth, frameHeight, score, maxConfidence = FULL_FRAME_MAX_CONFIDENCE, hardAreaRatio = 1) {
+	if (frameWidth <= 0 || frameHeight <= 0) return false;
+	const [x1, y1, x2, y2] = bbox;
+	const w = x2 - x1;
+	const h = y2 - y1;
+	const areaRatio = w * h / (frameWidth * frameHeight);
+	if (isUsableHardAreaCut(hardAreaRatio) && areaRatio >= hardAreaRatio) return true;
+	if (score >= maxConfidence) return false;
+	if (areaRatio >= .9) return true;
+	if (w >= frameWidth * .98) return true;
+	if (h >= frameHeight * .98) return true;
+	return false;
+}
 //#endregion
 //#region src/detection-pipeline/pipeline/plate-deskew.ts
 /**
@@ -3576,10 +3611,34 @@ var PipelineExecutor = class {
 					continue;
 				}
 				const fullFrameBar = rootStep.settings?.["fullFrameGuardMaxConfidence"];
-				if (isFullFramePhantomDetection(mutable.bbox, imageWidth, imageHeight, mutable.score, typeof fullFrameBar === "number" ? fullFrameBar : void 0)) {
-					if (debug) console.log(`[executor] drop det macro=${mutable.macroClass} score=${mutable.score} bbox=${JSON.stringify(mutable.bbox)} (full-frame phantom guard)`);
+				const fullFrameHardArea = rootStep.settings?.["fullFrameGuardHardAreaRatio"];
+				if (isFullFramePhantomDetection(mutable.bbox, imageWidth, imageHeight, mutable.score, typeof fullFrameBar === "number" ? fullFrameBar : void 0, typeof fullFrameHardArea === "number" ? fullFrameHardArea : void 0)) {
+					this.opts.logger?.info("full-frame phantom guard: detection dropped", {
+						tags: { deviceId },
+						meta: {
+							macroClass: mutable.macroClass,
+							score: mutable.score,
+							bbox: mutable.bbox,
+							frameWidth: imageWidth,
+							frameHeight: imageHeight,
+							areaRatio: imageWidth > 0 && imageHeight > 0 ? Math.round((mutable.bbox[2] - mutable.bbox[0]) * (mutable.bbox[3] - mutable.bbox[1]) / (imageWidth * imageHeight) * 1e3) / 1e3 : void 0,
+							bar: typeof fullFrameBar === "number" ? fullFrameBar : void 0,
+							hardAreaRatio: typeof fullFrameHardArea === "number" ? fullFrameHardArea : void 0
+						}
+					});
 					continue;
 				}
+				if (isFullFrameSurvivor(mutable.bbox, imageWidth, imageHeight, mutable.score, typeof fullFrameBar === "number" ? fullFrameBar : void 0)) this.opts.logger?.warn("full-frame box SURVIVED the guard on score", {
+					tags: { deviceId },
+					meta: {
+						macroClass: mutable.macroClass,
+						score: mutable.score,
+						bbox: mutable.bbox,
+						areaRatio: imageWidth > 0 && imageHeight > 0 ? Math.round((mutable.bbox[2] - mutable.bbox[0]) * (mutable.bbox[3] - mutable.bbox[1]) / (imageWidth * imageHeight) * 1e3) / 1e3 : void 0,
+						bar: typeof fullFrameBar === "number" ? fullFrameBar : void 0,
+						hint: "arm fullFrameGuardHardAreaRatio on this camera if these are phantoms"
+					}
+				});
 				try {
 					await this.executeChildren(rootStep.children, mutable, fullFrameJpegProvider, imageWidth, imageHeight, traceBuilder, stepTimings, ctx, poolAgg, runOpts?.plane, deviceId, nativeCropProvider);
 				} catch (err) {

package/dist/pipeline-runner/index.js

@@ -7,7 +7,7 @@ const require_dist = require("../dist-DUHlZcWd.js");
 const require_remote_restream = require("../remote-restream-CO36Sr30.js");
 const require_hub_hostname = require("../hub-hostname-DAJXlOgV.js");
 const require_worker_protocol = require("../worker-protocol-DextwlTX.js");
-const require_step_definitions = require("../step-definitions-Bo1hJQQw.js");
+const require_step_definitions = require("../step-definitions-Drb9cWbB.js");
 let node_child_process = require("node:child_process");
 let node_url = require("node:url");
 let sharp = require("sharp");
@@ -658,6 +658,9 @@ function toFrameInput$1(frame) {
 * without spinning up Moleculer or the addon framework.
 */
 var PipelineRunner = class {
+	/** Abandoned inference calls that have not yet settled. A BURST reads as
+	*  one rising number instead of N unrelated lines. */
+	inflightTimeouts = 0;
 	config;
 	cameras = /* @__PURE__ */ new Map();
 	semaphore;
@@ -1144,16 +1147,33 @@ var PipelineRunner = class {
 			timer.unref?.();
 		});
 		try {
-			const outcome = await Promise.race([this.config.processFrame(deviceId, frameInput, executorHandle), expiry]);
+			const inflight = this.config.processFrame(deviceId, frameInput, executorHandle);
+			const outcome = await Promise.race([inflight, expiry]);
 			if (outcome === TIMED_OUT) {
 				release();
+				this.inflightTimeouts += 1;
 				this.logger?.warn("inference timed out — permit released, result discarded", {
 					tags: { deviceId },
 					meta: {
 						timeoutMs,
-						availablePermits: this.semaphore.available
+						availablePermits: this.semaphore.available,
+						outstandingTimeouts: this.inflightTimeouts
 					}
 				});
+				const deadlineAt = Date.now();
+				const noteSettled = (fate) => {
+					this.inflightTimeouts = Math.max(0, this.inflightTimeouts - 1);
+					this.logger?.info("inference: abandoned call settled after the deadline", {
+						tags: { deviceId },
+						meta: {
+							lateByMs: Date.now() - deadlineAt,
+							totalMs: timeoutMs + (Date.now() - deadlineAt),
+							fate,
+							outstandingTimeouts: this.inflightTimeouts
+						}
+					});
+				};
+				inflight.then(() => noteSettled("resolved"), () => noteSettled("rejected"));
 			}
 			return outcome;
 		} finally {

package/dist/pipeline-runner/index.mjs

@@ -2,7 +2,7 @@ import { B as errMsg, G as createEvent, M as pipelineRunnerCapability, S as defi
 import { n as profileForStreamId, t as isRemoteRestream } from "../remote-restream-BeHi78PZ.mjs";
 import { t as resolveHubHostname } from "../hub-hostname-cCknRYKj.mjs";
 import { t as isWorkerReply } from "../worker-protocol-D7RzZIla.mjs";
-import { a as getStepDefinition } from "../step-definitions-C8A78dBi.mjs";
+import { a as getStepDefinition } from "../step-definitions-1GIwU6R8.mjs";
 import { fork } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import sharp from "sharp";
@@ -652,6 +652,9 @@ function toFrameInput$1(frame) {
 * without spinning up Moleculer or the addon framework.
 */
 var PipelineRunner = class {
+	/** Abandoned inference calls that have not yet settled. A BURST reads as
+	*  one rising number instead of N unrelated lines. */
+	inflightTimeouts = 0;
 	config;
 	cameras = /* @__PURE__ */ new Map();
 	semaphore;
@@ -1138,16 +1141,33 @@ var PipelineRunner = class {
 			timer.unref?.();
 		});
 		try {
-			const outcome = await Promise.race([this.config.processFrame(deviceId, frameInput, executorHandle), expiry]);
+			const inflight = this.config.processFrame(deviceId, frameInput, executorHandle);
+			const outcome = await Promise.race([inflight, expiry]);
 			if (outcome === TIMED_OUT) {
 				release();
+				this.inflightTimeouts += 1;
 				this.logger?.warn("inference timed out — permit released, result discarded", {
 					tags: { deviceId },
 					meta: {
 						timeoutMs,
-						availablePermits: this.semaphore.available
+						availablePermits: this.semaphore.available,
+						outstandingTimeouts: this.inflightTimeouts
 					}
 				});
+				const deadlineAt = Date.now();
+				const noteSettled = (fate) => {
+					this.inflightTimeouts = Math.max(0, this.inflightTimeouts - 1);
+					this.logger?.info("inference: abandoned call settled after the deadline", {
+						tags: { deviceId },
+						meta: {
+							lateByMs: Date.now() - deadlineAt,
+							totalMs: timeoutMs + (Date.now() - deadlineAt),
+							fate,
+							outstandingTimeouts: this.inflightTimeouts
+						}
+					});
+				};
+				inflight.then(() => noteSettled("resolved"), () => noteSettled("rejected"));
 			}
 			return outcome;
 		} finally {

package/dist/{step-definitions-C8A78dBi.mjs → step-definitions-1GIwU6R8.mjs}

@@ -1296,7 +1296,18 @@ var ObjectDetectionStep = class {
 				min: 0,
 				max: 1,
 				step: .05,
-				default: .5,
+				default: .65,
+				showValue: true
+			},
+			{
+				type: "slider",
+				key: "fullFrameGuardHardAreaRatio",
+				label: "Drop full-frame boxes above",
+				description: "Fraction of the frame at or above which a detection is dropped WHATEVER its score. 1 = off. Use on cameras where a subject can never fill the frame; leave off for doorbells and close-up lenses.",
+				min: .5,
+				max: 1,
+				step: .01,
+				default: 1,
 				showValue: true
 			},
 			{

package/dist/{step-definitions-Bo1hJQQw.js → step-definitions-Drb9cWbB.js}

@@ -1296,7 +1296,18 @@ var ObjectDetectionStep = class {
 				min: 0,
 				max: 1,
 				step: .05,
-				default: .5,
+				default: .65,
+				showValue: true
+			},
+			{
+				type: "slider",
+				key: "fullFrameGuardHardAreaRatio",
+				label: "Drop full-frame boxes above",
+				description: "Fraction of the frame at or above which a detection is dropped WHATEVER its score. 1 = off. Use on cameras where a subject can never fill the frame; leave off for doorbells and close-up lenses.",
+				min: .5,
+				max: 1,
+				step: .01,
+				default: 1,
 				showValue: true
 			},
 			{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-pipeline",
-  "version": "1.2.28",
+  "version": "1.2.29",
   "description": "CamStack Pipeline bundle — runner, detection, motion, audio + stream broker. Multi-entry npm package shipping pipeline addons under a single bundle.",
   "keywords": [
     "camstack",