@camstack/addon-post-analysis 1.2.649 → 1.2.651

package/dist/pipeline-analytics/index.js

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_clip_model_registry = require("../clip-model-registry-BweA9zEK.js");
+const require_clip_model_registry = require("../clip-model-registry-Dte3QQEt.js");
 let node_fs = require("node:fs");
 node_fs = require_clip_model_registry.__toESM(node_fs, 1);
 let node_path = require("node:path");
@@ -54676,6 +54676,8 @@ var FrameState = class {
 	gatedNodeByDevice = /* @__PURE__ */ new Map();
 	/** Throttle state for the "overlay synthesis failed" warn, one per device. */
 	overlaySynthesisWarnAt = /* @__PURE__ */ new Map();
+	/** Throttle state for the "overlay skipped a stale frame" debug line, one per device. */
+	overlayStaleLogAt = /* @__PURE__ */ new Map();
 	/** Per-device throttle for the inactive-binding frame-drop warn (5 min). */
 	inactiveBindingDropWarnAt = /* @__PURE__ */ new Map();
 	lastAudioInsertByDevice = /* @__PURE__ */ new Map();
@@ -70436,6 +70438,11 @@ Object.freeze({
 		"setDeviceConfig": { "config": { "__nested__": { "bands": [] } } }
 	},
 	"records": { "query": { "limit": 100 } },
+	"remote": {
+		"sendCommand": { "repeat": 1 },
+		"sendMediaCommand": { "repeat": 1 },
+		"setConfig": { "config": { "__nested__": { "defaultTransmitterId": null } } }
+	},
 	"storage": { "upsertLocation": { "isSystem": false } },
 	"storage-admin": { "readRecords": { "limit": 100 } },
 	"storage-provider": {
@@ -70527,6 +70534,7 @@ Object.freeze({
 	"recording": ["listSources"],
 	"storage-occupancy": ["getOccupancy"],
 	"storage-provider": ["list"],
+	"template": ["list"],
 	"training-provider": [
 		"describe",
 		"describeTypes",
@@ -87284,6 +87292,7 @@ var NcDispatcher = class {
 				...target.ownerUserId !== void 0 ? { ownerUserId: target.ownerUserId } : {},
 				...entry.payload.subject.className !== void 0 ? { className: entry.payload.subject.className } : {},
 				...entry.payload.subject.trackId !== void 0 ? { trackId: entry.payload.subject.trackId } : {},
+				eventAtMs: entry.payload.subject.timestamp,
 				...target.maxActions !== void 0 ? { maxActions: target.maxActions } : {},
 				...entry.payload.subject.systemEvent !== void 0 ? { systemEvent: entry.payload.subject.systemEvent } : {}
 			});
@@ -100056,6 +100065,7 @@ async function mintButtons(host, input) {
 				userId: verdictOwner,
 				...spec.suggestedClass !== void 0 ? { suggestedClass: spec.suggestedClass } : {},
 				...input.maxActions === 0 ? { viaLink: true } : {},
+				...input.eventAtMs !== void 0 ? { eventAtMs: input.eventAtMs } : {},
 				deviceId: input.deviceId,
 				actionId: spec.actionId,
 				targetId: input.targetId,
@@ -100517,6 +100527,57 @@ var VERDICT_REFUSAL_COPY = {
 	budget: "This camera already holds as many tracks for retraining as it may — nothing was changed",
 	"unknown-track": "This track is no longer available — nothing was changed"
 };
+/** What a person is told when the recording fallback refuses too. */
+var VERDICT_FRAME_REFUSAL_COPY = {
+	"still-unavailable": "The track is gone and the recording has no frame for that moment — nothing was changed",
+	"still-busy": "The track is gone and the recorder is busy — nothing was changed, try again later",
+	failed: "The track is gone and its frame could not be saved — nothing was changed"
+};
+/**
+* The track is gone (aged out, or discarded as a still object): the camera's
+* RECORDING still covers the instant, so the verdict lands a frame there
+* instead. Returns when the frame landed; throws a named refusal otherwise —
+* every branch that drops the example logs.
+*/
+async function landFrameFromRecording(host, grant) {
+	const tags = { deviceId: grant.deviceId };
+	const addFrame = host.deps.addVerdictFrameFromRecording;
+	if (addFrame === void 0 || grant.eventAtMs === void 0) {
+		host.logger.warn("detection verdict dropped — the track is gone and no recording fallback", {
+			tags,
+			meta: {
+				trackId: grant.trackId,
+				verdict: grant.verdict,
+				wired: addFrame !== void 0
+			}
+		});
+		throw new NcActionRefusedError(VERDICT_REFUSAL_COPY["unknown-track"]);
+	}
+	const landed = await addFrame({
+		deviceId: grant.deviceId,
+		epochMs: grant.eventAtMs
+	});
+	if (!landed.ok) {
+		host.logger.warn("detection verdict dropped — the track is gone and the recording refused", {
+			tags,
+			meta: {
+				trackId: grant.trackId,
+				verdict: grant.verdict,
+				reason: landed.reason,
+				...landed.detail !== void 0 ? { detail: landed.detail } : {}
+			}
+		});
+		throw new NcActionRefusedError(VERDICT_FRAME_REFUSAL_COPY[landed.reason]);
+	}
+	host.logger.info("detection verdict landed a recording frame — the track is gone", {
+		tags,
+		meta: {
+			trackId: grant.trackId,
+			verdict: grant.verdict,
+			epochMs: grant.eventAtMs
+		}
+	});
+}
 /**
 * Mark the track one notification reported for retraining, and record who was
 * asked and when.
@@ -100533,7 +100594,8 @@ async function applyGrantedDetectionVerdict(host, grant) {
 		deviceId: grant.deviceId,
 		trackId: grant.trackId
 	});
-	if (!outcome.ok) {
+	if (!outcome.ok && outcome.reason === "unknown-track") await landFrameFromRecording(host, grant);
+	else if (!outcome.ok) {
 		host.logger.info("detection verdict changed nothing — the retrain flow refused the mark", {
 			tags: { deviceId: grant.deviceId },
 			meta: {
@@ -108524,6 +108586,39 @@ function buildOccupancyDepartureDeps(input) {
 	};
 }
 //#endregion
+//#region src/pipeline-analytics/boot/verdict-recording-frame.ts
+var VERDICT_COLLECTION_NAME = "Notification verdicts";
+async function findOrCreate(api) {
+	const wanted = VERDICT_COLLECTION_NAME.toLowerCase();
+	const find = async () => (await api.listRetrainCollections()).find((c) => c.name.toLowerCase() === wanted)?.id ?? null;
+	const existing = await find();
+	if (existing !== null) return existing;
+	const created = await api.createRetrainCollection(VERDICT_COLLECTION_NAME);
+	if (created.kind === "created") return created.collection.id;
+	return created.reason === "duplicate-name" ? find() : null;
+}
+async function addVerdictFrameFromRecording(api, logger, input) {
+	const collectionId = await findOrCreate(api);
+	if (collectionId === null) {
+		logger.warn("verdict frame dropped — the \"Notification verdicts\" collection is unavailable", { tags: { deviceId: input.deviceId } });
+		return {
+			ok: false,
+			reason: "failed",
+			detail: "collection-unavailable"
+		};
+	}
+	const result = await api.addRetrainFrameFromRecording({
+		collectionId,
+		...input
+	});
+	if (result.kind === "added") return { ok: true };
+	return {
+		ok: false,
+		reason: result.reason === "still-unavailable" || result.reason === "still-busy" ? result.reason : "failed",
+		detail: result.detail ?? result.reason
+	};
+}
+//#endregion
 //#region src/pipeline-analytics/recognition-outlook.ts
 /** The step ids whose announce means "a recogniser may name this class". */
 var FACE_DETAIL_STEP_ID = "face-detection";
@@ -108885,6 +108980,26 @@ var BuildNotificationCenter = class extends BuildNotificationCenterBase {
 					};
 				}
 			},
+			addVerdictFrameFromRecording: async (input) => {
+				const pa = this.ctx.api.pipelineAnalytics;
+				try {
+					return await addVerdictFrameFromRecording({
+						listRetrainCollections: () => pa.listRetrainCollections.query({}),
+						createRetrainCollection: (name) => pa.createRetrainCollection.mutate({ name }),
+						addRetrainFrameFromRecording: (frame) => pa.addRetrainFrameFromRecording.mutate(frame)
+					}, this.ctx.logger, input);
+				} catch (err) {
+					this.ctx.logger.warn("verdict frame dropped — the recording fallback threw", {
+						tags: { deviceId: input.deviceId },
+						meta: { error: require_clip_model_registry.errMsg(err) }
+					});
+					return {
+						ok: false,
+						reason: "failed",
+						detail: require_clip_model_registry.errMsg(err)
+					};
+				}
+			},
 			readDeviceStates: async (ids) => {
 				const out = /* @__PURE__ */ new Map();
 				for (const id of ids) try {
@@ -120587,6 +120702,16 @@ var LTS_FLUSH_INTERVAL_MS = 6e4;
 var OPS_LOG_RETENTION_FALLBACK_MS = 720 * 60 * 6e4;
 /** Throttle for the "overlay synthesis failed" warn — one line / minute / device. */
 var OVERLAY_SYNTHESIS_WARN_THROTTLE_MS = 6e4;
+/**
+* A frame older than this is not drawn on the live overlay. On-motion session
+* cameras replay the GOP pre-roll when a session starts, so frames 2-9 s old
+* reach the tracker (they still feed tracking and analytics); drawing them
+* paints boxes for where the subject WAS. 1 s is generous for a live frame's
+* decode + inference latency.
+*/
+var OVERLAY_MAX_FRAME_AGE_MS = 1e3;
+/** The stale-overlay-frame skip is logged at most once per device per this window. */
+var OVERLAY_STALE_LOG_THROTTLE_MS = 6e4;
 /** How recently a spatial track must have been alive to count as "visual
 *  happening" — stamp audio labels on that track instead of opening a
 *  synthetic audio episode. */
@@ -123725,6 +123850,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 			this.frameState.packageLookDropReasons.delete(data.deviceId);
 			this.overlayState.clearDevice(data.deviceId);
 			this.frameState.overlaySynthesisWarnAt.delete(data.deviceId);
+			this.frameState.overlayStaleLogAt.delete(data.deviceId);
 			this.forgetDeviceProcessors(data.deviceId);
 			this.frameState.levelStateByDevice.delete(data.deviceId);
 			this.frameState.audioConfirmByDevice.delete(data.deviceId);
@@ -123747,6 +123873,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 		this.frameState.packageLookDropReasons.delete(deviceId);
 		this.overlayState.clearDevice(deviceId);
 		this.frameState.overlaySynthesisWarnAt.delete(deviceId);
+		this.frameState.overlayStaleLogAt.delete(deviceId);
 		this.forgetDeviceProcessors(deviceId);
 		this.frameState.levelStateByDevice.delete(deviceId);
 		this.frameState.motionOnsets.forgetDevice(deviceId);
@@ -124361,6 +124488,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 		this.parkedFrames?.dispose();
 		this.overlayState.clear();
 		this.frameState.overlaySynthesisWarnAt.clear();
+		this.frameState.overlayStaleLogAt.clear();
 		const tapeRecorder = this.tapeRecorder;
 		this.tapeRecorder = null;
 		this.tapeShelf = null;
@@ -125452,6 +125580,21 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 				config: stillnessConfig
 			}).still;
 		});
+		const frameAgeMs = Date.now() - result.timestamp;
+		const frameIsStale = frameAgeMs > OVERLAY_MAX_FRAME_AGE_MS;
+		if (frameIsStale) {
+			const nowMs = Date.now();
+			if (nowMs - (this.frameState.overlayStaleLogAt.get(deviceId) ?? 0) >= OVERLAY_STALE_LOG_THROTTLE_MS) {
+				this.frameState.overlayStaleLogAt.set(deviceId, nowMs);
+				this.ctx.logger.debug("overlay boxes withheld for a stale frame (replayed pre-roll); presence still emitted", {
+					tags: { deviceId },
+					meta: {
+						frameAgeMs,
+						maxFrameAgeMs: OVERLAY_MAX_FRAME_AGE_MS
+					}
+				});
+			}
+		}
 		this.ctx.eventBus.emit({
 			id: `pa-${(0, node_crypto.randomUUID)()}`,
 			timestamp: new Date(result.timestamp),
@@ -125466,7 +125609,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 				timestamp: result.timestamp,
 				frameWidth: result.frameWidth,
 				frameHeight: result.frameHeight,
-				detections: overlayDetections,
+				detections: frameIsStale ? [] : overlayDetections,
 				hasLiveTrack,
 				liveTrackCount: result.tracked.length
 			}
@@ -127929,6 +128072,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 		this.packageBackground?.clearDevice(input.deviceId);
 		this.overlayState.clearDevice(input.deviceId);
 		this.frameState.overlaySynthesisWarnAt.delete(input.deviceId);
+		this.frameState.overlayStaleLogAt.delete(input.deviceId);
 		const prefix = `${input.deviceId}:`;
 		for (const k of this.frameState.lastActiveTrackIds.keys()) if (k.startsWith(prefix)) this.frameState.lastActiveTrackIds.delete(k);
 	}
@@ -130909,6 +131053,7 @@ function withMean(row) {
 //#endregion
 exports.CONFIRMATION_CROP_MAX_WIDTH = CONFIRMATION_CROP_MAX_WIDTH;
 exports.DETECTION_PIPELINE_SECTION_IDS = DETECTION_PIPELINE_SECTION_IDS;
+exports.OVERLAY_MAX_FRAME_AGE_MS = OVERLAY_MAX_FRAME_AGE_MS;
 exports.customActions = customActions;
 exports.default = PipelineAnalyticsAddon;
 exports.ncActions = ncActions;

package/dist/pipeline-analytics/index.mjs

@@ -1,4 +1,4 @@
-import { $ as MediaFileKindEnum, $i as BaseAddon, $n as cloneAlarmSettings, $r as paintHex, $t as OpsLogEntrySchema, A as DeclaredDevices, Aa as unknown, Ai as storageOccupancyCapability, An as TrackSideSchema, Ar as isAudioClassName, At as NcAlarmSensorsInputSchema, B as FULL_IMAGE_BBOX, Bi as systemEventSummarySplitOf, Bn as applyModeDelaysEdits, Br as isRootSuppliableStepId, Bt as NcRuleUpdateInputSchema, C as ClearTrackRelationResultSchema, Ca as partialRecord, Ci as ruleGroupingApplies, Cn as TimelapseRuleInputSchema, Cr as failureContributionCapability, Ct as NC_SNOOZE_MAX_MINUTES, D as DEFAULT_TIMELAPSE_PREVIEW_TEXT, Da as templateLiteral, Di as sensorRaisedOf, Dn as TrackPuritySchema, Dr as isAlertEpisodeOpen, Dt as NC_TEMPLATE_VARS, E as DEFAULT_EVENT_COLOR, Ea as string, Ei as secureActuationFor, En as TrackPlacementSchema, Er as isAlarmControllableCap, Et as NC_TAXONOMY, F as EVENT_DENSITY_BATCH_MAX, Fi as syncActiveAlarmProfileSettings, Fn as alarmPanelCapability, Fr as isEventOwnerType, Ft as NcRuleActionSchema, G as ListTrackRelationsResultSchema, Gi as withSystemEventClasses, Gn as audioMetricsCapability, Gr as kebabToCamel, Gt as NcSnoozeSuppressedSchema, H as LABEL_SUPPLY_MACRO, Hi as templateVarsFor, Hn as applySecureOnArmEdit, Hr as isSystemDelivery, Ht as NcSharedSequenceSchema, I as EVENT_KIND_BY_CAP, Ii as systemEventDeliveryProblems, In as alertEpisodeId, Ir as isKnownTemplateVar, It as NcRuleInputSchema, J as MAX_BIRTH_DECISION_RECORDS, Ji as canonicalHash, Jn as buildSubjectPath, Jr as memoizePinnedFfmpeg, Jt as NcTaxonomySchema, K as LockStateSchema, Ki as zoneAnalyticsCapability, Kn as audioModeOf, Kr as linkedStepOf, Kt as NcStateSummarySectionIdSchema, L as EVENT_OWNER_TYPES, Li as systemEventFamilyProblems, Ln as alertEpisodeKind, Lr as isLabelSupplyStepId, Lt as NcRulePatchSchema, M as EMBEDDING_MODEL_FAILED, Mi as subjectPathSampleFromBox, Mn as activateAlarmProfile, Mr as isDetectionMacroClass, Mt as NcAlarmSettingsPatchSchema, N as EMBEDDING_REQUIREMENTS_FAILED, Ni as subjectPathSvgPoints, Nn as addonWidgetsSourceCapability, Nr as isDrawableSubjectPath, Nt as NcConditionDescriptorSchema, O as DETECTION_MACRO_CLASSES, Oa as tuple, Oi as servedTemplateVars, On as TrackRelationKindSchema, Or as isAlertEpisodeSeverity, Ot as NcAlarmConfigSchema, P as EMBEDDING_REQUIREMENTS_UNAVAILABLE, Pi as summarizeReview, Pn as alarmDeviceSecureOnArm, Pr as isEventKindLabelKey, Pt as NcConditionsSchema, Q as MOTION_CLOSE_AFTER_MS, Qi as errMsg, Qn as classifyRetrainReview, Qr as occupancyScope, Qt as OPS_LOG_DEFAULT_LIMIT, R as EXPORT_DENSE_MAX_RANGES, Ri as systemEventFilterApplies, Rn as alertEpisodePayload, Rr as isMediaOwnerType, Rt as NcRuleSchema, S as ClearTrackRelationInputSchema, Sa as object, Si as ruleDeviceCompatCapQueries, Sn as TRACK_RELATIONS_DEFAULT_LIMIT, Sr as faceGalleryCapability, St as NC_SENSOR_TRANSITION_KINDS, T as DEFAULT_DETAIL_CROP_CONVENTION, Ta as strictObject, Ti as sceneMonitorCapability, Tn as TimelapseRuleSchema, Tr as gifFromMp4Args, Tt as NC_SYSTEM_EVENT_KIND_GROUP_SPECS, U as LabelAttributionSchema, Ui as vectorDimFromBase64, Un as armRemovalReconcile, Ur as isSystemEventSummaryRule, Ut as NcSnoozeInputSchema, V as FailureCounters, Vi as templateCarriesSummary, Vn as applyNonBlockingEdit, Vr as isScheduleActive, Vt as NcScheduleSchema, W as ListTrackRelationsInputSchema, Wi as viewerLinkBaseOf, Wn as assertTimelapseCadences, Wr as isVectorIndexDimConflict, Wt as NcSnoozeSchema, X as MAX_TRACK_PURITIES, Xi as isSourceCap, Xn as bundledCamstack, Xr as normalizeNcMediaPolicy, Xt as NcTemplatePreviewSchema, Y as MAX_BIRTH_LATENCY_PROXY_MS, Yi as evaluateSensorEdge, Yn as buildViewerLink, Yr as ncMediaPolicyError, Yt as NcTemplatePreviewInputSchema, Z as MAX_TRACK_RELATIONS, Zi as DeviceType, Zn as calendarEventLocalSpan, Zr as notificationRulesCapability, Zt as NcTemplateVarDescriptorSchema, _ as BIRTH_DECISION_DEFAULT_LIMIT, _a as boolean, _n as SceneMonitorSchema, _t as NC_CONSUMABLE_SYSTEM_EVENT_KINDS, a as CLIP_EMBEDDING_STEP_ID, aa as createEvent, ai as plateGalleryCapability, an as RetrainDismissedSchema, ar as deleteAlarmProfile, at as NC_ALARM_NOTIFY_FIELDS, b as BucketAccumulator, ba as looseObject, bi as ruleAutoTriggersAlarm, bn as SetTrackRelationInputSchema, br as eventKindLabel, bt as NC_GROUPING_MAX_SEC, c as readClusterModelPinStrict, ca as defineRecordKinds, ci as readMotionTriggeredBy, cn as SCENE_CONFIRM_DEFAULT_MAX_IMAGE_PX, cr as deriveRecordingMode, ct as NC_AUDIO_CONFIRM_HITS_DEFAULT, d as APPEARANCE_BLOCKS, da as nodePin, di as resolveClipSearchMinScore, dn as SCENE_DEFAULT_CHECK_INTERVAL_SEC, dr as deviceAttentionKind, dt as NC_CLIP_PRE_ROLL_DEFAULT_SEC, ea as CAP_ADVANCE_FIELDS, ei as paletteResultSchema, en as PackageLlmVerdictSchema, er as consumableFormOf, et as MotionTriggeredBySchema, f as APPEARANCE_RESOLVES_AMBIGUITY_DEFAULT, fi as resolveDeliveryParams, fn as SCENE_DEFAULT_OBSERVATION_SPACING_SEC, fr as deviceRemovalHookCapability, ft as NC_CLIP_RETENTION_MAX_SEC, g as ArchivedDebugNoteSchema, ga as array, gi as resolveNcMediaImage, gn as SCENE_RESET_RECAPTURES, gt as NC_CONSUMABLE_LOW_PERCENT_DEFAULT, h as AlarmArmModeSchema, ha as _enum, hi as resolveModeNotifyPolicy, hn as SCENE_DIVERGED, hr as embeddingRefusalOf, ht as NC_CONFIRM_DEFAULT_TIMEOUT_MS, ia as RECORD_QUERY_MAX, ii as pipelineAnalyticsCapability, in as RebuildObjectEmbeddingsRefusalSchema, ir as createAlarmProfile, it as NC_ALARM_DELAY_MAX_SEC, j as DetectionSourceSchema, ja as EventCategory, ji as subKindsOf, jn as TrackSourceSchema, jr as isDefaultAlarmProfileId, jt as NcAlarmSensorsSchema, k as DETECTION_PIPELINE_CAP_NAME, ka as union, ki as startMoverUnderClearance, kn as TrackRelationSchema, kr as isAppLinkBase, kt as NcAlarmPostTriggeredActionSchema, l as resolveClusterModelPin, la as hydrateSchema, li as readTimelapseGeneratedAt, ln as SCENE_CONFIRM_DEFAULT_TIMEOUT_MS, lr as describeSystemEventDeliveryProblem, lt as NC_AUDIO_CONFIRM_WINDOW_SEC_DEFAULT, m as AUDIO_MACRO_LABELS, ma as ZodObject, mi as resolveModeDelays, mn as SCENE_DEFAULT_UNCOVERED_POLICY, mt as NC_CONFIRM_DEFAULT_MAX_IMAGE_PX, na as InvalidRecordError, nn as RECORDING_EXPORT_MAX_READ_BYTES, nr as coreBlockIdFromAddonId, nt as NC_ALARM_DEFAULT_TRIGGERED_DURATION_SEC, o as CLUSTER_MODEL_OWNER_ADDON_ID, oa as customAction, oi as projectSubjectPath, on as RetrainOriginSchema, or as deriveDetailCropRect, ot as NC_ALARM_SYSTEM_EVENT_KINDS, p as ARCHIVED_DEBUG_NOTES_DEFAULT_LIMIT, pa as sleep$1, pi as resolveLocationMode, pn as SCENE_DEFAULT_QUIET_SECONDS, pt as NC_CONDITION_CATALOG, q as MAX_ARCHIVED_DEBUG_NOTES, qi as DEFAULT_FIRST_SIGHTING_FRESHNESS_MS, qn as buildEventKindDescriptor, qr as mayWriteToLocation, qt as NcSystemEventKindSchema, ra as RECORD_MAX_DATA_BYTES, ri as pickFaceRescoreIntervalMinutes, rn as RECORDING_SOURCE_CAMSTACK_ADDON, rr as cosineSimilarity$1, rt as NC_ALARM_DELAY_FIELDS, s as FACE_EMBEDDING_STEP_ID, sa as defineCustomActions, si as readDeviceStateFrom, sn as RetrainStatusSchema, sr as derivePostTriggeredAction, st as NC_ALARM_TRIGGERED_MAX_SEC, t as BUILTIN_CLIP_MODELS, ta as CamProfileSchema, ti as parseAlertEpisodePayload, tr as consumableLowPercentOf, tt as NC_ALARM_DEFAULT_PROFILE_ID, u as APPEARANCE_BIN_COUNT, ua as isDeviceScopedCap, ui as renameAlarmProfile, un as SCENE_DEFAULT_ANCHOR_THRESHOLD, ur as describeSystemEventFamilyProblem, ut as NC_CLIP_POST_ROLL_DEFAULT_SEC, v as BaseDevice, va as discriminatedUnion, vi as retrainRevisionConflictMessage, vn as SetTrackPurityInputSchema, vr as encodeVectorBase64, vt as NC_DEFAULT_SNOOZE_MINUTES, w as CoverStateSchema, wa as record, wi as ruleKindOf, wn as TimelapseRulePatchSchema, wr as gifDeriveSpeed, wt as NC_STATE_SUMMARY_SECTION_IDS, x as COCO_TO_MACRO, xa as number, xi as ruleBelongsToAlarm$1, xn as TIMELAPSE_DENSE_FLOOR_SEC, xr as evictionPolicyOfLocation, xt as NC_GROUPING_MIN_SEC, y as BirthDecisionRecordSchema, ya as literal, yi as rootSupplyServes, yn as SetTrackPurityResultSchema, yr as ensureAlarmProfiles, yt as NC_GROUPING_DEFAULT_SEC, z as FIRST_LEVEL_MACRO_CLASSES, zi as systemEventSummaryScheduleOf, zn as applyBlockingEdit, zr as isRetiredClearKey, zt as NcRuleTargetSchema } from "../clip-model-registry-DLCu17dL.mjs";
+import { $ as MediaFileKindEnum, $i as BaseAddon, $n as cloneAlarmSettings, $r as paintHex, $t as OpsLogEntrySchema, A as DeclaredDevices, Aa as unknown, Ai as storageOccupancyCapability, An as TrackSideSchema, Ar as isAudioClassName, At as NcAlarmSensorsInputSchema, B as FULL_IMAGE_BBOX, Bi as systemEventSummarySplitOf, Bn as applyModeDelaysEdits, Br as isRootSuppliableStepId, Bt as NcRuleUpdateInputSchema, C as ClearTrackRelationResultSchema, Ca as partialRecord, Ci as ruleGroupingApplies, Cn as TimelapseRuleInputSchema, Cr as failureContributionCapability, Ct as NC_SNOOZE_MAX_MINUTES, D as DEFAULT_TIMELAPSE_PREVIEW_TEXT, Da as templateLiteral, Di as sensorRaisedOf, Dn as TrackPuritySchema, Dr as isAlertEpisodeOpen, Dt as NC_TEMPLATE_VARS, E as DEFAULT_EVENT_COLOR, Ea as string, Ei as secureActuationFor, En as TrackPlacementSchema, Er as isAlarmControllableCap, Et as NC_TAXONOMY, F as EVENT_DENSITY_BATCH_MAX, Fi as syncActiveAlarmProfileSettings, Fn as alarmPanelCapability, Fr as isEventOwnerType, Ft as NcRuleActionSchema, G as ListTrackRelationsResultSchema, Gi as withSystemEventClasses, Gn as audioMetricsCapability, Gr as kebabToCamel, Gt as NcSnoozeSuppressedSchema, H as LABEL_SUPPLY_MACRO, Hi as templateVarsFor, Hn as applySecureOnArmEdit, Hr as isSystemDelivery, Ht as NcSharedSequenceSchema, I as EVENT_KIND_BY_CAP, Ii as systemEventDeliveryProblems, In as alertEpisodeId, Ir as isKnownTemplateVar, It as NcRuleInputSchema, J as MAX_BIRTH_DECISION_RECORDS, Ji as canonicalHash, Jn as buildSubjectPath, Jr as memoizePinnedFfmpeg, Jt as NcTaxonomySchema, K as LockStateSchema, Ki as zoneAnalyticsCapability, Kn as audioModeOf, Kr as linkedStepOf, Kt as NcStateSummarySectionIdSchema, L as EVENT_OWNER_TYPES, Li as systemEventFamilyProblems, Ln as alertEpisodeKind, Lr as isLabelSupplyStepId, Lt as NcRulePatchSchema, M as EMBEDDING_MODEL_FAILED, Mi as subjectPathSampleFromBox, Mn as activateAlarmProfile, Mr as isDetectionMacroClass, Mt as NcAlarmSettingsPatchSchema, N as EMBEDDING_REQUIREMENTS_FAILED, Ni as subjectPathSvgPoints, Nn as addonWidgetsSourceCapability, Nr as isDrawableSubjectPath, Nt as NcConditionDescriptorSchema, O as DETECTION_MACRO_CLASSES, Oa as tuple, Oi as servedTemplateVars, On as TrackRelationKindSchema, Or as isAlertEpisodeSeverity, Ot as NcAlarmConfigSchema, P as EMBEDDING_REQUIREMENTS_UNAVAILABLE, Pi as summarizeReview, Pn as alarmDeviceSecureOnArm, Pr as isEventKindLabelKey, Pt as NcConditionsSchema, Q as MOTION_CLOSE_AFTER_MS, Qi as errMsg, Qn as classifyRetrainReview, Qr as occupancyScope, Qt as OPS_LOG_DEFAULT_LIMIT, R as EXPORT_DENSE_MAX_RANGES, Ri as systemEventFilterApplies, Rn as alertEpisodePayload, Rr as isMediaOwnerType, Rt as NcRuleSchema, S as ClearTrackRelationInputSchema, Sa as object, Si as ruleDeviceCompatCapQueries, Sn as TRACK_RELATIONS_DEFAULT_LIMIT, Sr as faceGalleryCapability, St as NC_SENSOR_TRANSITION_KINDS, T as DEFAULT_DETAIL_CROP_CONVENTION, Ta as strictObject, Ti as sceneMonitorCapability, Tn as TimelapseRuleSchema, Tr as gifFromMp4Args, Tt as NC_SYSTEM_EVENT_KIND_GROUP_SPECS, U as LabelAttributionSchema, Ui as vectorDimFromBase64, Un as armRemovalReconcile, Ur as isSystemEventSummaryRule, Ut as NcSnoozeInputSchema, V as FailureCounters, Vi as templateCarriesSummary, Vn as applyNonBlockingEdit, Vr as isScheduleActive, Vt as NcScheduleSchema, W as ListTrackRelationsInputSchema, Wi as viewerLinkBaseOf, Wn as assertTimelapseCadences, Wr as isVectorIndexDimConflict, Wt as NcSnoozeSchema, X as MAX_TRACK_PURITIES, Xi as isSourceCap, Xn as bundledCamstack, Xr as normalizeNcMediaPolicy, Xt as NcTemplatePreviewSchema, Y as MAX_BIRTH_LATENCY_PROXY_MS, Yi as evaluateSensorEdge, Yn as buildViewerLink, Yr as ncMediaPolicyError, Yt as NcTemplatePreviewInputSchema, Z as MAX_TRACK_RELATIONS, Zi as DeviceType, Zn as calendarEventLocalSpan, Zr as notificationRulesCapability, Zt as NcTemplateVarDescriptorSchema, _ as BIRTH_DECISION_DEFAULT_LIMIT, _a as boolean, _n as SceneMonitorSchema, _t as NC_CONSUMABLE_SYSTEM_EVENT_KINDS, a as CLIP_EMBEDDING_STEP_ID, aa as createEvent, ai as plateGalleryCapability, an as RetrainDismissedSchema, ar as deleteAlarmProfile, at as NC_ALARM_NOTIFY_FIELDS, b as BucketAccumulator, ba as looseObject, bi as ruleAutoTriggersAlarm, bn as SetTrackRelationInputSchema, br as eventKindLabel, bt as NC_GROUPING_MAX_SEC, c as readClusterModelPinStrict, ca as defineRecordKinds, ci as readMotionTriggeredBy, cn as SCENE_CONFIRM_DEFAULT_MAX_IMAGE_PX, cr as deriveRecordingMode, ct as NC_AUDIO_CONFIRM_HITS_DEFAULT, d as APPEARANCE_BLOCKS, da as nodePin, di as resolveClipSearchMinScore, dn as SCENE_DEFAULT_CHECK_INTERVAL_SEC, dr as deviceAttentionKind, dt as NC_CLIP_PRE_ROLL_DEFAULT_SEC, ea as CAP_ADVANCE_FIELDS, ei as paletteResultSchema, en as PackageLlmVerdictSchema, er as consumableFormOf, et as MotionTriggeredBySchema, f as APPEARANCE_RESOLVES_AMBIGUITY_DEFAULT, fi as resolveDeliveryParams, fn as SCENE_DEFAULT_OBSERVATION_SPACING_SEC, fr as deviceRemovalHookCapability, ft as NC_CLIP_RETENTION_MAX_SEC, g as ArchivedDebugNoteSchema, ga as array, gi as resolveNcMediaImage, gn as SCENE_RESET_RECAPTURES, gt as NC_CONSUMABLE_LOW_PERCENT_DEFAULT, h as AlarmArmModeSchema, ha as _enum, hi as resolveModeNotifyPolicy, hn as SCENE_DIVERGED, hr as embeddingRefusalOf, ht as NC_CONFIRM_DEFAULT_TIMEOUT_MS, ia as RECORD_QUERY_MAX, ii as pipelineAnalyticsCapability, in as RebuildObjectEmbeddingsRefusalSchema, ir as createAlarmProfile, it as NC_ALARM_DELAY_MAX_SEC, j as DetectionSourceSchema, ja as EventCategory, ji as subKindsOf, jn as TrackSourceSchema, jr as isDefaultAlarmProfileId, jt as NcAlarmSensorsSchema, k as DETECTION_PIPELINE_CAP_NAME, ka as union, ki as startMoverUnderClearance, kn as TrackRelationSchema, kr as isAppLinkBase, kt as NcAlarmPostTriggeredActionSchema, l as resolveClusterModelPin, la as hydrateSchema, li as readTimelapseGeneratedAt, ln as SCENE_CONFIRM_DEFAULT_TIMEOUT_MS, lr as describeSystemEventDeliveryProblem, lt as NC_AUDIO_CONFIRM_WINDOW_SEC_DEFAULT, m as AUDIO_MACRO_LABELS, ma as ZodObject, mi as resolveModeDelays, mn as SCENE_DEFAULT_UNCOVERED_POLICY, mt as NC_CONFIRM_DEFAULT_MAX_IMAGE_PX, na as InvalidRecordError, nn as RECORDING_EXPORT_MAX_READ_BYTES, nr as coreBlockIdFromAddonId, nt as NC_ALARM_DEFAULT_TRIGGERED_DURATION_SEC, o as CLUSTER_MODEL_OWNER_ADDON_ID, oa as customAction, oi as projectSubjectPath, on as RetrainOriginSchema, or as deriveDetailCropRect, ot as NC_ALARM_SYSTEM_EVENT_KINDS, p as ARCHIVED_DEBUG_NOTES_DEFAULT_LIMIT, pa as sleep$1, pi as resolveLocationMode, pn as SCENE_DEFAULT_QUIET_SECONDS, pt as NC_CONDITION_CATALOG, q as MAX_ARCHIVED_DEBUG_NOTES, qi as DEFAULT_FIRST_SIGHTING_FRESHNESS_MS, qn as buildEventKindDescriptor, qr as mayWriteToLocation, qt as NcSystemEventKindSchema, ra as RECORD_MAX_DATA_BYTES, ri as pickFaceRescoreIntervalMinutes, rn as RECORDING_SOURCE_CAMSTACK_ADDON, rr as cosineSimilarity$1, rt as NC_ALARM_DELAY_FIELDS, s as FACE_EMBEDDING_STEP_ID, sa as defineCustomActions, si as readDeviceStateFrom, sn as RetrainStatusSchema, sr as derivePostTriggeredAction, st as NC_ALARM_TRIGGERED_MAX_SEC, t as BUILTIN_CLIP_MODELS, ta as CamProfileSchema, ti as parseAlertEpisodePayload, tr as consumableLowPercentOf, tt as NC_ALARM_DEFAULT_PROFILE_ID, u as APPEARANCE_BIN_COUNT, ua as isDeviceScopedCap, ui as renameAlarmProfile, un as SCENE_DEFAULT_ANCHOR_THRESHOLD, ur as describeSystemEventFamilyProblem, ut as NC_CLIP_POST_ROLL_DEFAULT_SEC, v as BaseDevice, va as discriminatedUnion, vi as retrainRevisionConflictMessage, vn as SetTrackPurityInputSchema, vr as encodeVectorBase64, vt as NC_DEFAULT_SNOOZE_MINUTES, w as CoverStateSchema, wa as record, wi as ruleKindOf, wn as TimelapseRulePatchSchema, wr as gifDeriveSpeed, wt as NC_STATE_SUMMARY_SECTION_IDS, x as COCO_TO_MACRO, xa as number, xi as ruleBelongsToAlarm$1, xn as TIMELAPSE_DENSE_FLOOR_SEC, xr as evictionPolicyOfLocation, xt as NC_GROUPING_MIN_SEC, y as BirthDecisionRecordSchema, ya as literal, yi as rootSupplyServes, yn as SetTrackPurityResultSchema, yr as ensureAlarmProfiles, yt as NC_GROUPING_DEFAULT_SEC, z as FIRST_LEVEL_MACRO_CLASSES, zi as systemEventSummaryScheduleOf, zn as applyBlockingEdit, zr as isRetiredClearKey, zt as NcRuleTargetSchema } from "../clip-model-registry-BWY8P-AK.mjs";
 import { t as __exportAll } from "../embedding-encoder/index.mjs";
 import * as fs$1 from "node:fs";
 import { createWriteStream, promises } from "node:fs";
@@ -54581,6 +54581,8 @@ var FrameState = class {
 	gatedNodeByDevice = /* @__PURE__ */ new Map();
 	/** Throttle state for the "overlay synthesis failed" warn, one per device. */
 	overlaySynthesisWarnAt = /* @__PURE__ */ new Map();
+	/** Throttle state for the "overlay skipped a stale frame" debug line, one per device. */
+	overlayStaleLogAt = /* @__PURE__ */ new Map();
 	/** Per-device throttle for the inactive-binding frame-drop warn (5 min). */
 	inactiveBindingDropWarnAt = /* @__PURE__ */ new Map();
 	lastAudioInsertByDevice = /* @__PURE__ */ new Map();
@@ -70341,6 +70343,11 @@ Object.freeze({
 		"setDeviceConfig": { "config": { "__nested__": { "bands": [] } } }
 	},
 	"records": { "query": { "limit": 100 } },
+	"remote": {
+		"sendCommand": { "repeat": 1 },
+		"sendMediaCommand": { "repeat": 1 },
+		"setConfig": { "config": { "__nested__": { "defaultTransmitterId": null } } }
+	},
 	"storage": { "upsertLocation": { "isSystem": false } },
 	"storage-admin": { "readRecords": { "limit": 100 } },
 	"storage-provider": {
@@ -70432,6 +70439,7 @@ Object.freeze({
 	"recording": ["listSources"],
 	"storage-occupancy": ["getOccupancy"],
 	"storage-provider": ["list"],
+	"template": ["list"],
 	"training-provider": [
 		"describe",
 		"describeTypes",
@@ -87189,6 +87197,7 @@ var NcDispatcher = class {
 				...target.ownerUserId !== void 0 ? { ownerUserId: target.ownerUserId } : {},
 				...entry.payload.subject.className !== void 0 ? { className: entry.payload.subject.className } : {},
 				...entry.payload.subject.trackId !== void 0 ? { trackId: entry.payload.subject.trackId } : {},
+				eventAtMs: entry.payload.subject.timestamp,
 				...target.maxActions !== void 0 ? { maxActions: target.maxActions } : {},
 				...entry.payload.subject.systemEvent !== void 0 ? { systemEvent: entry.payload.subject.systemEvent } : {}
 			});
@@ -99961,6 +99970,7 @@ async function mintButtons(host, input) {
 				userId: verdictOwner,
 				...spec.suggestedClass !== void 0 ? { suggestedClass: spec.suggestedClass } : {},
 				...input.maxActions === 0 ? { viaLink: true } : {},
+				...input.eventAtMs !== void 0 ? { eventAtMs: input.eventAtMs } : {},
 				deviceId: input.deviceId,
 				actionId: spec.actionId,
 				targetId: input.targetId,
@@ -100422,6 +100432,57 @@ var VERDICT_REFUSAL_COPY = {
 	budget: "This camera already holds as many tracks for retraining as it may — nothing was changed",
 	"unknown-track": "This track is no longer available — nothing was changed"
 };
+/** What a person is told when the recording fallback refuses too. */
+var VERDICT_FRAME_REFUSAL_COPY = {
+	"still-unavailable": "The track is gone and the recording has no frame for that moment — nothing was changed",
+	"still-busy": "The track is gone and the recorder is busy — nothing was changed, try again later",
+	failed: "The track is gone and its frame could not be saved — nothing was changed"
+};
+/**
+* The track is gone (aged out, or discarded as a still object): the camera's
+* RECORDING still covers the instant, so the verdict lands a frame there
+* instead. Returns when the frame landed; throws a named refusal otherwise —
+* every branch that drops the example logs.
+*/
+async function landFrameFromRecording(host, grant) {
+	const tags = { deviceId: grant.deviceId };
+	const addFrame = host.deps.addVerdictFrameFromRecording;
+	if (addFrame === void 0 || grant.eventAtMs === void 0) {
+		host.logger.warn("detection verdict dropped — the track is gone and no recording fallback", {
+			tags,
+			meta: {
+				trackId: grant.trackId,
+				verdict: grant.verdict,
+				wired: addFrame !== void 0
+			}
+		});
+		throw new NcActionRefusedError(VERDICT_REFUSAL_COPY["unknown-track"]);
+	}
+	const landed = await addFrame({
+		deviceId: grant.deviceId,
+		epochMs: grant.eventAtMs
+	});
+	if (!landed.ok) {
+		host.logger.warn("detection verdict dropped — the track is gone and the recording refused", {
+			tags,
+			meta: {
+				trackId: grant.trackId,
+				verdict: grant.verdict,
+				reason: landed.reason,
+				...landed.detail !== void 0 ? { detail: landed.detail } : {}
+			}
+		});
+		throw new NcActionRefusedError(VERDICT_FRAME_REFUSAL_COPY[landed.reason]);
+	}
+	host.logger.info("detection verdict landed a recording frame — the track is gone", {
+		tags,
+		meta: {
+			trackId: grant.trackId,
+			verdict: grant.verdict,
+			epochMs: grant.eventAtMs
+		}
+	});
+}
 /**
 * Mark the track one notification reported for retraining, and record who was
 * asked and when.
@@ -100438,7 +100499,8 @@ async function applyGrantedDetectionVerdict(host, grant) {
 		deviceId: grant.deviceId,
 		trackId: grant.trackId
 	});
-	if (!outcome.ok) {
+	if (!outcome.ok && outcome.reason === "unknown-track") await landFrameFromRecording(host, grant);
+	else if (!outcome.ok) {
 		host.logger.info("detection verdict changed nothing — the retrain flow refused the mark", {
 			tags: { deviceId: grant.deviceId },
 			meta: {
@@ -108429,6 +108491,39 @@ function buildOccupancyDepartureDeps(input) {
 	};
 }
 //#endregion
+//#region src/pipeline-analytics/boot/verdict-recording-frame.ts
+var VERDICT_COLLECTION_NAME = "Notification verdicts";
+async function findOrCreate(api) {
+	const wanted = VERDICT_COLLECTION_NAME.toLowerCase();
+	const find = async () => (await api.listRetrainCollections()).find((c) => c.name.toLowerCase() === wanted)?.id ?? null;
+	const existing = await find();
+	if (existing !== null) return existing;
+	const created = await api.createRetrainCollection(VERDICT_COLLECTION_NAME);
+	if (created.kind === "created") return created.collection.id;
+	return created.reason === "duplicate-name" ? find() : null;
+}
+async function addVerdictFrameFromRecording(api, logger, input) {
+	const collectionId = await findOrCreate(api);
+	if (collectionId === null) {
+		logger.warn("verdict frame dropped — the \"Notification verdicts\" collection is unavailable", { tags: { deviceId: input.deviceId } });
+		return {
+			ok: false,
+			reason: "failed",
+			detail: "collection-unavailable"
+		};
+	}
+	const result = await api.addRetrainFrameFromRecording({
+		collectionId,
+		...input
+	});
+	if (result.kind === "added") return { ok: true };
+	return {
+		ok: false,
+		reason: result.reason === "still-unavailable" || result.reason === "still-busy" ? result.reason : "failed",
+		detail: result.detail ?? result.reason
+	};
+}
+//#endregion
 //#region src/pipeline-analytics/recognition-outlook.ts
 /** The step ids whose announce means "a recogniser may name this class". */
 var FACE_DETAIL_STEP_ID = "face-detection";
@@ -108790,6 +108885,26 @@ var BuildNotificationCenter = class extends BuildNotificationCenterBase {
 					};
 				}
 			},
+			addVerdictFrameFromRecording: async (input) => {
+				const pa = this.ctx.api.pipelineAnalytics;
+				try {
+					return await addVerdictFrameFromRecording({
+						listRetrainCollections: () => pa.listRetrainCollections.query({}),
+						createRetrainCollection: (name) => pa.createRetrainCollection.mutate({ name }),
+						addRetrainFrameFromRecording: (frame) => pa.addRetrainFrameFromRecording.mutate(frame)
+					}, this.ctx.logger, input);
+				} catch (err) {
+					this.ctx.logger.warn("verdict frame dropped — the recording fallback threw", {
+						tags: { deviceId: input.deviceId },
+						meta: { error: errMsg(err) }
+					});
+					return {
+						ok: false,
+						reason: "failed",
+						detail: errMsg(err)
+					};
+				}
+			},
 			readDeviceStates: async (ids) => {
 				const out = /* @__PURE__ */ new Map();
 				for (const id of ids) try {
@@ -120492,6 +120607,16 @@ var LTS_FLUSH_INTERVAL_MS = 6e4;
 var OPS_LOG_RETENTION_FALLBACK_MS = 720 * 60 * 6e4;
 /** Throttle for the "overlay synthesis failed" warn — one line / minute / device. */
 var OVERLAY_SYNTHESIS_WARN_THROTTLE_MS = 6e4;
+/**
+* A frame older than this is not drawn on the live overlay. On-motion session
+* cameras replay the GOP pre-roll when a session starts, so frames 2-9 s old
+* reach the tracker (they still feed tracking and analytics); drawing them
+* paints boxes for where the subject WAS. 1 s is generous for a live frame's
+* decode + inference latency.
+*/
+var OVERLAY_MAX_FRAME_AGE_MS = 1e3;
+/** The stale-overlay-frame skip is logged at most once per device per this window. */
+var OVERLAY_STALE_LOG_THROTTLE_MS = 6e4;
 /** How recently a spatial track must have been alive to count as "visual
 *  happening" — stamp audio labels on that track instead of opening a
 *  synthetic audio episode. */
@@ -123630,6 +123755,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 			this.frameState.packageLookDropReasons.delete(data.deviceId);
 			this.overlayState.clearDevice(data.deviceId);
 			this.frameState.overlaySynthesisWarnAt.delete(data.deviceId);
+			this.frameState.overlayStaleLogAt.delete(data.deviceId);
 			this.forgetDeviceProcessors(data.deviceId);
 			this.frameState.levelStateByDevice.delete(data.deviceId);
 			this.frameState.audioConfirmByDevice.delete(data.deviceId);
@@ -123652,6 +123778,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 		this.frameState.packageLookDropReasons.delete(deviceId);
 		this.overlayState.clearDevice(deviceId);
 		this.frameState.overlaySynthesisWarnAt.delete(deviceId);
+		this.frameState.overlayStaleLogAt.delete(deviceId);
 		this.forgetDeviceProcessors(deviceId);
 		this.frameState.levelStateByDevice.delete(deviceId);
 		this.frameState.motionOnsets.forgetDevice(deviceId);
@@ -124266,6 +124393,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 		this.parkedFrames?.dispose();
 		this.overlayState.clear();
 		this.frameState.overlaySynthesisWarnAt.clear();
+		this.frameState.overlayStaleLogAt.clear();
 		const tapeRecorder = this.tapeRecorder;
 		this.tapeRecorder = null;
 		this.tapeShelf = null;
@@ -125357,6 +125485,21 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 				config: stillnessConfig
 			}).still;
 		});
+		const frameAgeMs = Date.now() - result.timestamp;
+		const frameIsStale = frameAgeMs > OVERLAY_MAX_FRAME_AGE_MS;
+		if (frameIsStale) {
+			const nowMs = Date.now();
+			if (nowMs - (this.frameState.overlayStaleLogAt.get(deviceId) ?? 0) >= OVERLAY_STALE_LOG_THROTTLE_MS) {
+				this.frameState.overlayStaleLogAt.set(deviceId, nowMs);
+				this.ctx.logger.debug("overlay boxes withheld for a stale frame (replayed pre-roll); presence still emitted", {
+					tags: { deviceId },
+					meta: {
+						frameAgeMs,
+						maxFrameAgeMs: OVERLAY_MAX_FRAME_AGE_MS
+					}
+				});
+			}
+		}
 		this.ctx.eventBus.emit({
 			id: `pa-${randomUUID()}`,
 			timestamp: new Date(result.timestamp),
@@ -125371,7 +125514,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 				timestamp: result.timestamp,
 				frameWidth: result.frameWidth,
 				frameHeight: result.frameHeight,
-				detections: overlayDetections,
+				detections: frameIsStale ? [] : overlayDetections,
 				hasLiveTrack,
 				liveTrackCount: result.tracked.length
 			}
@@ -127834,6 +127977,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 		this.packageBackground?.clearDevice(input.deviceId);
 		this.overlayState.clearDevice(input.deviceId);
 		this.frameState.overlaySynthesisWarnAt.delete(input.deviceId);
+		this.frameState.overlayStaleLogAt.delete(input.deviceId);
 		const prefix = `${input.deviceId}:`;
 		for (const k of this.frameState.lastActiveTrackIds.keys()) if (k.startsWith(prefix)) this.frameState.lastActiveTrackIds.delete(k);
 	}
@@ -130812,4 +130956,4 @@ function withMean(row) {
 	};
 }
 //#endregion
-export { CONFIRMATION_CROP_MAX_WIDTH, DETECTION_PIPELINE_SECTION_IDS, customActions, PipelineAnalyticsAddon as default, ncActions, pickCleanMedia, retagDetectionSections, retagRetentionSection, stripDeviceOnlyFields, stripGlobalOnlyFields, toAnalyticsDeviceSections };
+export { CONFIRMATION_CROP_MAX_WIDTH, DETECTION_PIPELINE_SECTION_IDS, OVERLAY_MAX_FRAME_AGE_MS, customActions, PipelineAnalyticsAddon as default, ncActions, pickCleanMedia, retagDetectionSections, retagRetentionSection, stripDeviceOnlyFields, stripGlobalOnlyFields, toAnalyticsDeviceSections };

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-DFq-lnbD.mjs")).catch((e) => {
+	return l ||= d(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-_vVfXkDx.mjs")).catch((e) => {
 		throw l = void 0, e;
 	}), l;
 }

package/package.json

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