@camstack/addon-post-analysis 1.2.203 → 1.2.205

package/dist/{dist-B2bqI0T1.mjs → dist-C6gK_SDX.mjs}

@@ -30925,8 +30925,27 @@ var PrivacyMaskRegionSchema = object({
 /** Current on-camera privacy state — mask master enable + zones + microphone. */
 var PrivacyMaskStatusSchema = object({
 	enabled: boolean(),
-	/** Active zones (normalized 0..1). Length ≤ maxRegions. */
-	regions: array(PrivacyMaskRegionSchema),
+	/**
+	* Active zones (normalized 0..1). Length ≤ maxRegions.
+	*
+	* `null` means "no answer" — the provider has never reached this camera
+	* (a cold `runtimeState` slice, a battery camera asleep) or the read
+	* failed. A consumer must render it as UNKNOWN and never as "this camera
+	* has no zones": those two look identical to an operator right up to the
+	* moment one of them is acted on, and acting on them differs completely.
+	* The switch group turned an unanswered read into *"nothing is set up for
+	* it to act on"* — an instruction to go and draw a zone that already
+	* exists — and this editor seeded an EMPTY canvas from it, one Save away
+	* from deleting the mask it could not read.
+	*
+	* Empty-and-answered is `[]` and stays a real answer: this camera genuinely
+	* has no zones. The distinction is the same one {@link
+	* PrivacyMaskStatusSchema.shape.audioEnabled} already draws for the
+	* microphone, on the very same payload — both planes come from ONE refresh,
+	* so it was never coherent for one of them to be able to say "unknown"
+	* while the other could not.
+	*/
+	regions: array(PrivacyMaskRegionSchema).nullable(),
 	/**
 	* Is the camera capturing sound right now? Read from the camera, never from
 	* a server-side mirror.

package/dist/{dist-rqvrMbFv.js → dist-CJ0RJC87.js}

@@ -30956,8 +30956,27 @@ var PrivacyMaskRegionSchema = object({
 /** Current on-camera privacy state — mask master enable + zones + microphone. */
 var PrivacyMaskStatusSchema = object({
 	enabled: boolean(),
-	/** Active zones (normalized 0..1). Length ≤ maxRegions. */
-	regions: array(PrivacyMaskRegionSchema),
+	/**
+	* Active zones (normalized 0..1). Length ≤ maxRegions.
+	*
+	* `null` means "no answer" — the provider has never reached this camera
+	* (a cold `runtimeState` slice, a battery camera asleep) or the read
+	* failed. A consumer must render it as UNKNOWN and never as "this camera
+	* has no zones": those two look identical to an operator right up to the
+	* moment one of them is acted on, and acting on them differs completely.
+	* The switch group turned an unanswered read into *"nothing is set up for
+	* it to act on"* — an instruction to go and draw a zone that already
+	* exists — and this editor seeded an EMPTY canvas from it, one Save away
+	* from deleting the mask it could not read.
+	*
+	* Empty-and-answered is `[]` and stays a real answer: this camera genuinely
+	* has no zones. The distinction is the same one {@link
+	* PrivacyMaskStatusSchema.shape.audioEnabled} already draws for the
+	* microphone, on the very same payload — both planes come from ONE refresh,
+	* so it was never coherent for one of them to be able to say "unknown"
+	* while the other could not.
+	*/
+	regions: array(PrivacyMaskRegionSchema).nullable(),
 	/**
 	* Is the camera capturing sound right now? Read from the camera, never from
 	* a server-side mirror.

package/dist/embedding-encoder/index.js

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

package/dist/embedding-encoder/index.mjs

@@ -1,4 +1,4 @@
-import { F as PoolMemoryWatchdog, Pt as BaseAddon, Tt as resolvePoolMemoryPolicy, at as embeddingEncoderCapability, dt as hfModelUrl, vt as parseProcStatus } from "../dist-B2bqI0T1.mjs";
+import { F as PoolMemoryWatchdog, Pt as BaseAddon, Tt as resolvePoolMemoryPolicy, at as embeddingEncoderCapability, dt as hfModelUrl, vt as parseProcStatus } from "../dist-C6gK_SDX.mjs";
 import { createRequire } from "node:module";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";

package/dist/pipeline-analytics/{_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-BhGMdGiF.mjs → _virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-Vdk1rrss.mjs}

@@ -3,7 +3,7 @@ import "./dist-CYZr2fwk.mjs";
 var e = {
 	"@camstack/sdk": {
 		name: "@camstack/sdk",
-		version: "1.2.85",
+		version: "1.2.86",
 		scope: ["default"],
 		loaded: !1,
 		from: "addon_pipeline_analytics_widgets",
@@ -18,7 +18,7 @@ var e = {
 	},
 	"@camstack/types": {
 		name: "@camstack/types",
-		version: "1.2.165",
+		version: "1.2.166",
 		scope: ["default"],
 		loaded: !1,
 		from: "addon_pipeline_analytics_widgets",
@@ -33,7 +33,7 @@ var e = {
 	},
 	"@camstack/ui-library": {
 		name: "@camstack/ui-library",
-		version: "1.2.133",
+		version: "1.2.134",
 		scope: ["default"],
 		loaded: !1,
 		from: "addon_pipeline_analytics_widgets",

package/dist/pipeline-analytics/{hostInit-1Wpi1AHy.mjs → hostInit-OI-5yBsz.mjs}

@@ -36,7 +36,7 @@ async function r() {
 				}
 			},
 			"@camstack/types": {
-				version: "1.2.165",
+				version: "1.2.166",
 				scope: "default",
 				shareConfig: {
 					singleton: !0,
@@ -45,7 +45,7 @@ async function r() {
 				}
 			},
 			"@camstack/sdk": {
-				version: "1.2.85",
+				version: "1.2.86",
 				scope: "default",
 				shareConfig: {
 					singleton: !0,
@@ -81,7 +81,7 @@ async function r() {
 				}
 			},
 			"@camstack/ui-library": {
-				version: "1.2.133",
+				version: "1.2.134",
 				scope: "default",
 				shareConfig: {
 					singleton: !0,

package/dist/pipeline-analytics/index.js

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-rqvrMbFv.js");
+const require_dist = require("../dist-CJ0RJC87.js");
 let node_fs = require("node:fs");
 node_fs = require_dist.__toESM(node_fs, 1);
 let node_path = require("node:path");
@@ -46115,6 +46115,8 @@ function detailsCarryEnrichment(details) {
 }
 /** Throttle for the per-device "detail call failed" warn — one line / minute. */
 var FAIL_WARN_THROTTLE_MS = 6e4;
+/** How often a camera reports the coasted frames its detail plane ignored (D397). */
+var COASTED_REPORT_INTERVAL_MS = 6e4;
 var TrackDetailDispatcher = class {
 	deps;
 	devices = /* @__PURE__ */ new Map();
@@ -46148,6 +46150,11 @@ var TrackDetailDispatcher = class {
 	*  already has state is never reset. */
 	onFrame(deviceId, trackId, announce, frame, nowMs) {
 		if (this.disposed) return;
+		if (frame.matchedThisFrame === false) {
+			const known = this.devices.get(deviceId);
+			if (known) known.coastedFramesIgnored += 1;
+			return;
+		}
 		const dev = this.devices.get(deviceId);
 		if (!dev || !dev.tracks.has(trackId)) {
 			if (announce.length > 0) this.onTrackStarted(deviceId, trackId, frame.className, announce, frame, nowMs);
@@ -46158,6 +46165,16 @@ var TrackDetailDispatcher = class {
 		const requests = dev.scheduler.onCandidateImproved(trackId, nowMs);
 		this.enqueue(deviceId, dev, requests);
 	}
+	/**
+	* Coasted frames ignored for one device since this dispatcher started.
+	*
+	* Exposed rather than logged from here: the dispatcher has no cadence of its
+	* own to report on, and the addon already emits a per-camera line where this
+	* belongs beside the numbers it explains.
+	*/
+	coastedFramesIgnored(deviceId) {
+		return this.devices.get(deviceId)?.coastedFramesIgnored ?? 0;
+	}
 	/** A track ended (durable TTL expiry): drop its scheduler + frame state. Any
 	*  queued request for it is discarded at dequeue. */
 	onTrackEnded(deviceId, trackId) {
@@ -46186,6 +46203,11 @@ var TrackDetailDispatcher = class {
 				tracks: /* @__PURE__ */ new Map(),
 				candidateBest: new BestDetectionTracker(CANDIDATE_IMPROVE_POLICY),
 				queue: [],
+				coastedFramesIgnored: 0,
+				coastedReportedAt: {
+					count: 0,
+					at: Date.now()
+				},
 				inFlight: 0,
 				timer: null,
 				lastFailWarnAt: 0,
@@ -46209,9 +46231,42 @@ var TrackDetailDispatcher = class {
 	}
 	tick(deviceId, dev) {
 		if (this.disposed) return;
-		const requests = dev.scheduler.tick(Date.now());
+		const now = Date.now();
+		this.reportCoasted(deviceId, dev, now);
+		const requests = dev.scheduler.tick(now);
 		this.enqueue(deviceId, dev, requests);
 	}
+	/**
+	* Say how many coasted frames this camera's detail plane ignored (D397),
+	* once per {@link COASTED_REPORT_INTERVAL_MS}, and only when there were any.
+	*
+	* Per camera and per interval rather than per frame: a coasting track offers
+	* one of these several times a second, and the question this answers is
+	* always "why is 617 worse than 615?".
+	*/
+	reportCoasted(deviceId, dev, now) {
+		const ignored = dev.coastedFramesIgnored - dev.coastedReportedAt.count;
+		if (ignored <= 0) {
+			dev.coastedReportedAt = {
+				count: dev.coastedFramesIgnored,
+				at: now
+			};
+			return;
+		}
+		if (now - dev.coastedReportedAt.at < COASTED_REPORT_INTERVAL_MS) return;
+		this.deps.logger.info("detail dispatch: coasted frames ignored — the subject was not observed in them", {
+			tags: { deviceId },
+			meta: {
+				ignored,
+				windowMs: now - dev.coastedReportedAt.at,
+				liveTracks: dev.tracks.size
+			}
+		});
+		dev.coastedReportedAt = {
+			count: dev.coastedFramesIgnored,
+			at: now
+		};
+	}
 	enqueue(deviceId, dev, requests) {
 		if (requests.length === 0) return;
 		for (const r of requests) dev.queue.push(r);
@@ -71666,6 +71721,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 					className: t.className,
 					confidence: t.confidence,
 					timestamp: result.timestamp,
+					...t.matchedThisFrame !== void 0 ? { matchedThisFrame: t.matchedThisFrame } : {},
 					...frameHandle !== void 0 ? {
 						frameHandle,
 						nodeId: frameHandle.nodeId

package/dist/pipeline-analytics/index.mjs

@@ -1,4 +1,4 @@
-import { $ as audioModeOf, $t as EventCategory, A as NcSnoozeSchema, At as vectorDimFromBase64, B as SCENE_DEFAULT_UNCOVERED_POLICY, Bt as nodePin, C as NcConditionDescriptorSchema, Ct as readTimelapseGeneratedAt, D as NcRuleTargetSchema, Dt as storageOccupancyCapability, E as NcRuleSchema, Et as sceneMonitorCapability, Ft as CamProfileSchema, G as TimelapseRulePatchSchema, Gt as discriminatedUnion, H as SceneMonitorSchema, Ht as _enum, I as RECORDING_EXPORT_MAX_READ_BYTES, It as DeviceType, J as VISIT_MERGE_GAP_MS, Jt as object, K as TimelapseRuleSchema, Kt as literal, L as RetrainStatusSchema, Lt as createEvent, M as NcSystemEventKindSchema, Mt as zoneAnalyticsCapability, N as NcTaxonomySchema, Nt as errMsg$1, O as NcScheduleSchema, Ot as subKindsOf, P as OpsLogEntrySchema, Pt as BaseAddon, Q as audioMetricsCapability, Qt as unknown, Rt as hydrateSchema, S as NC_TAXONOMY, St as readDeviceStateFrom, T as NcRulePatchSchema, U as TIMELAPSE_DENSE_FLOOR_SEC, Ut as array, V as SCENE_DIVERGED, Vt as sleep$1, W as TimelapseRuleInputSchema, Wt as boolean, X as alarmPanelCapability, Xt as record, Y as addonWidgetsSourceCapability, Yt as partialRecord, Z as assertTimelapseCadences, Zt as string, _ as MediaFileKindEnum, _t as notificationRulesCapability, a as DEFAULT_EVENT_COLOR, b as NC_DEFAULT_SNOOZE_MINUTES, bt as pipelineAnalyticsCapability, c as DETECTION_MACRO_CLASSES, ct as evictionPolicyOfLocation, d as EVENT_KIND_BY_CAP, et as buildEventKindDescriptor, f as EVENT_PAD_MS, ft as isDetectionMacroClass, g as MACRO_LABELS, gt as mayWriteToLocation, h as LabelAttributionSchema, ht as kebabToCamel, i as COCO_TO_MACRO, it as deriveRecordingMode, j as NcSnoozeSuppressedSchema, jt as videoclipsCapability, k as NcSnoozeInputSchema, kt as systemEventFilterApplies, lt as faceGalleryCapability, m as FailureCounters, mt as isSourceCap, n as BaseDevice, nt as customAction, ot as encodeVectorBase64, p as FULL_IMAGE_BBOX, pt as isScheduleActive, q as TrackSourceSchema, qt as number, r as CLUSTER_MODEL_SCOPED_STEPS, rt as defineCustomActions, st as evaluateSensorEdge, t as AUDIO_MACRO_LABELS, tt as cosineSimilarity$1, u as DeclaredDevices, ut as failureContributionCapability, v as NC_ALARM_SYSTEM_EVENT_KINDS, w as NcRuleInputSchema, wt as resolveLocationMode, xt as plateGalleryCapability, y as NC_CONDITION_CATALOG, yt as pickClusterStepModels, z as SCENE_DEFAULT_ANCHOR_THRESHOLD, zt as isDeviceScopedCap } from "../dist-B2bqI0T1.mjs";
+import { $ as audioModeOf, $t as EventCategory, A as NcSnoozeSchema, At as vectorDimFromBase64, B as SCENE_DEFAULT_UNCOVERED_POLICY, Bt as nodePin, C as NcConditionDescriptorSchema, Ct as readTimelapseGeneratedAt, D as NcRuleTargetSchema, Dt as storageOccupancyCapability, E as NcRuleSchema, Et as sceneMonitorCapability, Ft as CamProfileSchema, G as TimelapseRulePatchSchema, Gt as discriminatedUnion, H as SceneMonitorSchema, Ht as _enum, I as RECORDING_EXPORT_MAX_READ_BYTES, It as DeviceType, J as VISIT_MERGE_GAP_MS, Jt as object, K as TimelapseRuleSchema, Kt as literal, L as RetrainStatusSchema, Lt as createEvent, M as NcSystemEventKindSchema, Mt as zoneAnalyticsCapability, N as NcTaxonomySchema, Nt as errMsg$1, O as NcScheduleSchema, Ot as subKindsOf, P as OpsLogEntrySchema, Pt as BaseAddon, Q as audioMetricsCapability, Qt as unknown, Rt as hydrateSchema, S as NC_TAXONOMY, St as readDeviceStateFrom, T as NcRulePatchSchema, U as TIMELAPSE_DENSE_FLOOR_SEC, Ut as array, V as SCENE_DIVERGED, Vt as sleep$1, W as TimelapseRuleInputSchema, Wt as boolean, X as alarmPanelCapability, Xt as record, Y as addonWidgetsSourceCapability, Yt as partialRecord, Z as assertTimelapseCadences, Zt as string, _ as MediaFileKindEnum, _t as notificationRulesCapability, a as DEFAULT_EVENT_COLOR, b as NC_DEFAULT_SNOOZE_MINUTES, bt as pipelineAnalyticsCapability, c as DETECTION_MACRO_CLASSES, ct as evictionPolicyOfLocation, d as EVENT_KIND_BY_CAP, et as buildEventKindDescriptor, f as EVENT_PAD_MS, ft as isDetectionMacroClass, g as MACRO_LABELS, gt as mayWriteToLocation, h as LabelAttributionSchema, ht as kebabToCamel, i as COCO_TO_MACRO, it as deriveRecordingMode, j as NcSnoozeSuppressedSchema, jt as videoclipsCapability, k as NcSnoozeInputSchema, kt as systemEventFilterApplies, lt as faceGalleryCapability, m as FailureCounters, mt as isSourceCap, n as BaseDevice, nt as customAction, ot as encodeVectorBase64, p as FULL_IMAGE_BBOX, pt as isScheduleActive, q as TrackSourceSchema, qt as number, r as CLUSTER_MODEL_SCOPED_STEPS, rt as defineCustomActions, st as evaluateSensorEdge, t as AUDIO_MACRO_LABELS, tt as cosineSimilarity$1, u as DeclaredDevices, ut as failureContributionCapability, v as NC_ALARM_SYSTEM_EVENT_KINDS, w as NcRuleInputSchema, wt as resolveLocationMode, xt as plateGalleryCapability, y as NC_CONDITION_CATALOG, yt as pickClusterStepModels, z as SCENE_DEFAULT_ANCHOR_THRESHOLD, zt as isDeviceScopedCap } from "../dist-C6gK_SDX.mjs";
 import { t as __exportAll } from "../embedding-encoder/index.mjs";
 import * as fs from "node:fs";
 import { promises } from "node:fs";
@@ -46041,6 +46041,8 @@ function detailsCarryEnrichment(details) {
 }
 /** Throttle for the per-device "detail call failed" warn — one line / minute. */
 var FAIL_WARN_THROTTLE_MS = 6e4;
+/** How often a camera reports the coasted frames its detail plane ignored (D397). */
+var COASTED_REPORT_INTERVAL_MS = 6e4;
 var TrackDetailDispatcher = class {
 	deps;
 	devices = /* @__PURE__ */ new Map();
@@ -46074,6 +46076,11 @@ var TrackDetailDispatcher = class {
 	*  already has state is never reset. */
 	onFrame(deviceId, trackId, announce, frame, nowMs) {
 		if (this.disposed) return;
+		if (frame.matchedThisFrame === false) {
+			const known = this.devices.get(deviceId);
+			if (known) known.coastedFramesIgnored += 1;
+			return;
+		}
 		const dev = this.devices.get(deviceId);
 		if (!dev || !dev.tracks.has(trackId)) {
 			if (announce.length > 0) this.onTrackStarted(deviceId, trackId, frame.className, announce, frame, nowMs);
@@ -46084,6 +46091,16 @@ var TrackDetailDispatcher = class {
 		const requests = dev.scheduler.onCandidateImproved(trackId, nowMs);
 		this.enqueue(deviceId, dev, requests);
 	}
+	/**
+	* Coasted frames ignored for one device since this dispatcher started.
+	*
+	* Exposed rather than logged from here: the dispatcher has no cadence of its
+	* own to report on, and the addon already emits a per-camera line where this
+	* belongs beside the numbers it explains.
+	*/
+	coastedFramesIgnored(deviceId) {
+		return this.devices.get(deviceId)?.coastedFramesIgnored ?? 0;
+	}
 	/** A track ended (durable TTL expiry): drop its scheduler + frame state. Any
 	*  queued request for it is discarded at dequeue. */
 	onTrackEnded(deviceId, trackId) {
@@ -46112,6 +46129,11 @@ var TrackDetailDispatcher = class {
 				tracks: /* @__PURE__ */ new Map(),
 				candidateBest: new BestDetectionTracker(CANDIDATE_IMPROVE_POLICY),
 				queue: [],
+				coastedFramesIgnored: 0,
+				coastedReportedAt: {
+					count: 0,
+					at: Date.now()
+				},
 				inFlight: 0,
 				timer: null,
 				lastFailWarnAt: 0,
@@ -46135,9 +46157,42 @@ var TrackDetailDispatcher = class {
 	}
 	tick(deviceId, dev) {
 		if (this.disposed) return;
-		const requests = dev.scheduler.tick(Date.now());
+		const now = Date.now();
+		this.reportCoasted(deviceId, dev, now);
+		const requests = dev.scheduler.tick(now);
 		this.enqueue(deviceId, dev, requests);
 	}
+	/**
+	* Say how many coasted frames this camera's detail plane ignored (D397),
+	* once per {@link COASTED_REPORT_INTERVAL_MS}, and only when there were any.
+	*
+	* Per camera and per interval rather than per frame: a coasting track offers
+	* one of these several times a second, and the question this answers is
+	* always "why is 617 worse than 615?".
+	*/
+	reportCoasted(deviceId, dev, now) {
+		const ignored = dev.coastedFramesIgnored - dev.coastedReportedAt.count;
+		if (ignored <= 0) {
+			dev.coastedReportedAt = {
+				count: dev.coastedFramesIgnored,
+				at: now
+			};
+			return;
+		}
+		if (now - dev.coastedReportedAt.at < COASTED_REPORT_INTERVAL_MS) return;
+		this.deps.logger.info("detail dispatch: coasted frames ignored — the subject was not observed in them", {
+			tags: { deviceId },
+			meta: {
+				ignored,
+				windowMs: now - dev.coastedReportedAt.at,
+				liveTracks: dev.tracks.size
+			}
+		});
+		dev.coastedReportedAt = {
+			count: dev.coastedFramesIgnored,
+			at: now
+		};
+	}
 	enqueue(deviceId, dev, requests) {
 		if (requests.length === 0) return;
 		for (const r of requests) dev.queue.push(r);
@@ -71592,6 +71647,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 					className: t.className,
 					confidence: t.confidence,
 					timestamp: result.timestamp,
+					...t.matchedThisFrame !== void 0 ? { matchedThisFrame: t.matchedThisFrame } : {},
 					...frameHandle !== void 0 ? {
 						frameHandle,
 						nodeId: frameHandle.nodeId

package/dist/pipeline-analytics/remoteEntry.js

@@ -30,7 +30,7 @@ async function d(e) {
 	}
 }
 async function f() {
-	return l ||= d(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-BhGMdGiF.mjs")).catch((e) => {
+	return l ||= d(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-Vdk1rrss.mjs")).catch((e) => {
 		throw l = void 0, e;
 	}), l;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-post-analysis",
-  "version": "1.2.203",
+  "version": "1.2.205",
   "description": "Post-Analysis bundle — enrichment, embedding-encoder, pipeline-analytics. Multi-entry npm package shipping addons that consume pipeline output.",
   "keywords": [
     "camstack",