@camstack/addon-post-analysis 1.2.652 → 1.2.654

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-Bz1uQvQ8.js");
+const require_clip_model_registry = require("../clip-model-registry-CFQBxtE2.js");
 let node_fs = require("node:fs");
 node_fs = require_clip_model_registry.__toESM(node_fs, 1);
 let node_path = require("node:path");
@@ -9063,6 +9063,7 @@ var en_default = {
 	"system.node-offline.body.agent": "Agent {{nodeName}} is offline",
 	"system.node-offline.body.agent.connection-lost": "Agent {{nodeName}} lost its connection to the hub",
 	"system.node-offline.body.agent.shutdown": "Agent {{nodeName}} shut down",
+	"system.node-offline.body.agent.updating": "Agent {{nodeName}} went offline while updating and has not come back after {{graceMin}} minutes",
 	"system.node-inference-unavailable.title": "Node cannot infer — {{nodeId}}",
 	"system.node-inference-unavailable.body": "Node {{nodeId}} can no longer run inference — every enabled device is unavailable ({{devices}}). It will not receive cameras until one returns.",
 	"system.addon-crash-loop.title": "Addon crash-loop — {{nodeId}}",
@@ -9467,6 +9468,7 @@ var it_default = {
 	"system.node-offline.body.agent": "L'agent {{nodeName}} è offline",
 	"system.node-offline.body.agent.connection-lost": "L'agent {{nodeName}} ha perso la connessione con l'hub",
 	"system.node-offline.body.agent.shutdown": "L'agent {{nodeName}} si è spento",
+	"system.node-offline.body.agent.updating": "L'agent {{nodeName}} è andato offline durante un aggiornamento e non è tornato dopo {{graceMin}} minuti",
 	"system.node-inference-unavailable.title": "Nodo senza inferenza — {{nodeId}}",
 	"system.node-inference-unavailable.body": "Il nodo {{nodeId}} non può più eseguire inferenza — tutti i dispositivi abilitati non sono disponibili ({{devices}}). Non riceverà camere finché uno non torna disponibile.",
 	"system.addon-crash-loop.title": "Crash-loop addon — {{nodeId}}",
@@ -54721,6 +54723,12 @@ var FrameState = class {
 	*  per 5 minutes, not one per governor round (the wedge re-sights all
 	*  night; ~300 identical lines would bury the log it exists to serve). */
 	packageOversizeLogAt = /* @__PURE__ */ new Map();
+	/**
+	* The newest frame the package path held per camera — the picture a parcel
+	* promoted from a raw look is stored from (`package-still-capture.ts`). The
+	* scene path concludes without a frame of its own, so it reads this.
+	*/
+	packageLookFrames = /* @__PURE__ */ new Map();
 	/** Reasons logged on the previous package look — episode helper for drops. */
 	packageLookDropReasons = /* @__PURE__ */ new Map();
 };
@@ -59025,6 +59033,89 @@ function sweepOne(deps, deviceId) {
 	if (outcome.departed.length > 0 || outcome.departedWithoutActivity.length > 0 || outcome.expired.length > 0) deps.onOutcome(deviceId, outcome, deps.now);
 }
 //#endregion
+//#region src/pipeline-analytics/pipeline/package/package-still-capture.ts
+/** A held look frame older than this is not the parcel's picture any more. */
+var PACKAGE_LOOK_FRAME_MAX_AGE_MS = 15e3;
+async function jpegOf(reply) {
+	if (reply.tier === "ram-fullframe") return "preview-only";
+	if (reply.jpegBytes !== void 0 && reply.jpegBytes.byteLength > 0) return reply.jpegBytes;
+	if (reply.bytes !== void 0 && reply.bytes.length === reply.width * reply.height * 3) return encodeRgbCropToJpeg(reply.bytes, reply.width, reply.height);
+	return "empty-frame";
+}
+/**
+* The entry carrying its still's `keyFrameMediaId`, or the entry unchanged when
+* it already had one or none could be stored (said, with the reason).
+*/
+async function withParcelStill(input) {
+	const { entry, logger } = input;
+	if (entry.keyFrameMediaId !== void 0) return entry;
+	const miss = (reason, detail) => {
+		logger.warn("package still NOT stored — the delivery ships without a picture of the parcel", {
+			tags: { deviceId: entry.deviceId },
+			meta: {
+				entryId: entry.id,
+				reason,
+				...detail !== void 0 ? { error: detail } : {}
+			}
+		});
+		return entry;
+	};
+	if (input.handle === null) return miss("no-frame-handle");
+	if (input.writer === null) return miss("no-media-store");
+	try {
+		const reply = await input.query({
+			handle: input.handle,
+			bbox: {
+				x: 0,
+				y: 0,
+				w: entry.frameWidth,
+				h: entry.frameHeight
+			},
+			acceptJpegBytes: true,
+			encodeJpeg: true,
+			pin: require_clip_model_registry.nodePin(input.handle.nodeId)
+		});
+		if (reply === null) return miss("native-miss");
+		const jpeg = await jpegOf(reply);
+		if (typeof jpeg === "string") return miss(jpeg);
+		const keyFrameMediaId = await input.writer.putReplacing({
+			deviceId: entry.deviceId,
+			ownerKind: "track",
+			ownerId: entry.id,
+			kind: "keyFrame",
+			timestamp: input.timestamp,
+			data: Buffer.from(jpeg),
+			subjectBox: {
+				x: entry.bbox.x,
+				y: entry.bbox.y,
+				w: entry.bbox.w,
+				h: entry.bbox.h,
+				frameWidth: entry.frameWidth,
+				frameHeight: entry.frameHeight
+			}
+		});
+		return {
+			...entry,
+			keyFrameMediaId
+		};
+	} catch (err) {
+		return miss("write-failed", require_clip_model_registry.errMsg(err));
+	}
+}
+/**
+* One promotion, in the order that matters: the still is stored FIRST, then the
+* detector emits `delivered` — the notification centre reads the still when the
+* event arrives, so a picture written after it is a picture nobody sees.
+*/
+async function promoteWithStill(input) {
+	const entry = await withParcelStill(input);
+	await input.detector.onStationaryChange({
+		phase: "appeared",
+		entry,
+		timestamp: input.entry.becameStationaryAt
+	});
+}
+//#endregion
 //#region src/pipeline-analytics/pipeline/person-over-vehicle.ts
 /**
 * How much of the PERSON box must sit inside a vehicle box to be counted.
@@ -70514,7 +70605,12 @@ Object.freeze({
 		"listSupportedEntityKinds"
 	],
 	"device-extension": ["listSlots", "listSources"],
-	"device-provider": ["discoverDevices", "getDevices"],
+	"device-provider": [
+		"classifyDiscoveryHits",
+		"discoverDevices",
+		"getDevices",
+		"getDiscoveryModes"
+	],
 	"device-removal-hook": ["listDeviceData"],
 	"failure-contribution": ["list"],
 	"llm": [
@@ -90273,13 +90369,17 @@ var DeviceLivenessHoldoff = class {
 	rememberIfAbsent(subject, state) {
 		if (!this.lastNotified.has(subject)) this.lastNotified.set(subject, state);
 	}
-	/** A real ledger flip. Starts / resets the trailing timer. */
-	arm(subject, incoming) {
+	/**
+	* A real ledger flip. Starts / resets the trailing timer. `delayMs` replaces
+	* the default delay for THIS arm only (a node's planned-update grace).
+	*/
+	arm(subject, incoming, delayMs) {
+		const delay = delayMs ?? this.delayMs;
 		this.pending.set(subject, incoming);
 		this.trackDeparture(subject, incoming);
 		const existing = this.timers.get(subject);
 		if (existing !== void 0) this.cancel(existing);
-		if (this.delayMs <= 0) {
+		if (delay <= 0) {
 			this.timers.delete(subject);
 			this.fire(subject);
 			return;
@@ -90287,7 +90387,7 @@ var DeviceLivenessHoldoff = class {
 		const id = this.schedule(() => {
 			this.timers.delete(subject);
 			this.fire(subject);
-		}, this.delayMs);
+		}, delay);
 		this.timers.set(subject, id);
 	}
 	dispose() {
@@ -92934,6 +93034,71 @@ var NcRuleStore = class NcRuleStore {
 	}
 };
 //#endregion
+//#region src/notification-center/planned-update-window.ts
+/**
+* A node that ANNOUNCED an update is expected to go offline — the window that
+* says so lives here.
+*
+* `system.restarting` becomes `node-updating` / `node-restarting`; the centre
+* records the announcement per node (RAM, refreshed by the event, never by a
+* read — D49). An offline for that node inside {@link PLANNED_UPDATE_OFFLINE_GRACE_MS}
+* of the announcement is held for the whole window instead of the usual 60 s
+* hold-off: back in time means no offline notification at all, not back means
+* one offline that says it happened during an update. A lost announcement
+* (events may be dropped, D8) simply behaves as before.
+*/
+/** How long after an announcement an offline is held, and how long the announcement counts. */
+var PLANNED_UPDATE_OFFLINE_GRACE_MS = 10 * 6e4;
+var NC_PLANNED_UPDATE_NODES_MAX = 256;
+var NcPlannedUpdateWindow = class {
+	graceMs;
+	/** Insertion-ordered: the oldest node is evicted first. */
+	announcedAt = /* @__PURE__ */ new Map();
+	/** When an offline was put on hold, per node. */
+	heldAt = /* @__PURE__ */ new Map();
+	constructor(graceMs = PLANNED_UPDATE_OFFLINE_GRACE_MS) {
+		this.graceMs = graceMs;
+	}
+	get windowMs() {
+		return this.graceMs;
+	}
+	get graceMinutes() {
+		return Math.round(this.graceMs / 6e4);
+	}
+	/** Feed every system subject the intake accepted; only the two announcements are kept. */
+	observe(system, atMs) {
+		if (system.kind !== "node-updating" && system.kind !== "node-restarting") return;
+		const nodeId = system.nodeId;
+		if (nodeId === void 0) return;
+		this.announcedAt.delete(nodeId);
+		this.announcedAt.set(nodeId, atMs);
+		while (this.announcedAt.size > NC_PLANNED_UPDATE_NODES_MAX) {
+			const oldest = this.announcedAt.keys().next();
+			if (oldest.done === true) break;
+			this.announcedAt.delete(oldest.value);
+		}
+	}
+	/** True when the node announced an update no longer than the window ago. */
+	isPlanned(nodeId, atMs) {
+		const at = this.announcedAt.get(nodeId);
+		return at !== void 0 && atMs - at <= this.graceMs;
+	}
+	/** An offline was put on hold for this node. */
+	hold(nodeId, atMs) {
+		this.heldAt.set(nodeId, atMs);
+	}
+	/**
+	* The node is back: seconds the held offline lasted, or `null` when no offline
+	* was held, or its window already ran out (the offline was sent).
+	*/
+	release(nodeId, atMs) {
+		const at = this.heldAt.get(nodeId);
+		if (at === void 0) return null;
+		this.heldAt.delete(nodeId);
+		return atMs - at < this.graceMs ? Math.round((atMs - at) / 1e3) : null;
+	}
+};
+//#endregion
 //#region src/notification-center/restart-supersede.ts
 /** How many landings are remembered — one per node per update, so a fleet's worth. */
 var NC_UPDATE_LANDINGS_MAX = 256;
@@ -97243,6 +97408,15 @@ var NcSystemStateLedger = class {
 	closeLegacyStreamKeys() {
 		this.closeWhere("legacy-stream-keys", (row) => row.key.startsWith("stream:") && !DEVICE_STREAM_KEY.test(row.key), "legacy-stream-key");
 	}
+	/**
+	* Is this device switched off RIGHT NOW (an open `device-disabled` row)?
+	* D62: the switch outranks the device's liveness and its streams — a device
+	* somebody turned off is reported off, never as offline. `false` while the
+	* store has never answered (unknown is never "disabled").
+	*/
+	isDeviceDisabled(deviceId) {
+		return (this.openRows() ?? []).some((row) => row.kind === "device-disabled" && row.deviceId === deviceId);
+	}
 	/** The open rows, or `null` while the store has never answered. */
 	openRows() {
 		return this.deps.rows.answered() ? this.deps.rows.all() : null;
@@ -97749,6 +97923,7 @@ function readRaw(section, ports, nowMs) {
 		reason: UNREAD_STATE
 	};
 	const items = [];
+	const switchedOff = new Set(state.flatMap((row) => row.kind === "device-disabled" && row.deviceId !== void 0 ? [row.deviceId] : []));
 	if (section === "device-state" || section === "nodes") {
 		const liveness = ports.liveness();
 		if (liveness === null) return {
@@ -97758,10 +97933,14 @@ function readRaw(section, ports, nowMs) {
 		for (const row of liveness) {
 			if (row.state !== "offline" || nowMs - row.updatedAt < ports.livenessHoldoffMs) continue;
 			const item = livenessItem(row, ports.lookup);
-			if (item !== null && item.section === section) items.push(item);
+			if (item === null || item.section !== section) continue;
+			const id = item.subject.deviceId;
+			if (id !== void 0 && switchedOff.has(id)) continue;
+			items.push(item);
 		}
 	}
 	for (const row of state) {
+		if (row.kind === "stream-offline" && row.deviceId !== void 0 && switchedOff.has(row.deviceId)) continue;
 		const item = stateItem(row, ports.lookup, ports.nodes);
 		if (item.section === section) items.push(item);
 	}
@@ -101894,6 +102073,7 @@ function onSystemEvent(host, event) {
 	const system = incoming.subject.systemEvent;
 	if (system !== void 0) host.stateSummary.observeSystem(system, host.now());
 	if (system !== void 0) host.updateLandings.observe(system, host.now());
+	if (system !== void 0) host.plannedUpdates.observe(system, host.now());
 	const observation = system !== void 0 ? ledgeredLiveness(system) : null;
 	if (observation !== null) {
 		const previous = host.liveness.stateOf(observation.subject);
@@ -101920,17 +102100,86 @@ function onSystemEvent(host, event) {
 			});
 			return;
 		}
-		if (isDeviceLivenessKind(observation.kind) || isNodeLivenessKind(observation.kind)) {
+		if (isNodeLivenessKind(observation.kind) && system !== void 0) {
+			armNodeLiveness(host, holdoff, observation.subject, incoming, system);
+			return;
+		}
+		if (isDeviceLivenessKind(observation.kind)) {
+			if (dropSwitchedOff(host, system)) return;
 			holdoff.arm(observation.subject, incoming);
 			return;
 		}
 	} else if (system !== void 0 && (system.kind.startsWith("device-") || system.kind.startsWith("stream-"))) {
 		if (host.lastSystemLiveness.get(system.subject) === system.kind) return;
 		host.lastSystemLiveness.set(system.subject, system.kind);
+		if (dropSwitchedOff(host, system)) return;
 	}
 	host.consumeEvent(incoming);
 }
 /**
+* D62: a device the operator switched off is reported off, never offline. Its
+* `device-offline` / `stream-offline` is dropped (and said) while an open
+* `device-disabled` row exists — the broker of a disabled device stopping is
+* the switch working, not an outage. The memory of the flip is already kept.
+*/
+function dropSwitchedOff(host, system) {
+	if (system === void 0 || system.deviceId === void 0) return false;
+	if (system.kind !== "device-offline" && system.kind !== "stream-offline") return false;
+	if (!host.stateSummary.ledger.isDeviceDisabled(system.deviceId)) return false;
+	host.logger.debug("offline not notified — the device is switched off (D62)", {
+		tags: { deviceId: system.deviceId },
+		meta: {
+			kind: system.kind,
+			subject: system.subject
+		}
+	});
+	return true;
+}
+/**
+* Arm a node liveness flip. An OFFLINE of a node that announced an update is
+* held for the whole planned-update window and worded as such if it is still
+* sent; the node's return inside the window is logged and sends nothing (the
+* hold-off sees the state bounce back to the one last notified).
+*/
+function armNodeLiveness(host, holdoff, subject, incoming, system) {
+	const nodeId = system.nodeId;
+	const now = host.now();
+	if (nodeId === void 0) {
+		holdoff.arm(subject, incoming);
+		return;
+	}
+	const window = host.plannedUpdates;
+	if (system.kind === "node-offline" && window.isPlanned(nodeId, now)) {
+		window.hold(nodeId, now);
+		holdoff.arm(subject, withPlannedUpdateWording(incoming, system, window.graceMinutes), window.windowMs);
+		return;
+	}
+	if (system.kind === "node-online") {
+		const backAfterSec = window.release(nodeId, now);
+		if (backAfterSec !== null) host.logger.info(`node ${nodeId}: offline suppressed: planned update, back after ${backAfterSec}s`, { meta: {
+			nodeId,
+			backAfterSec
+		} });
+	}
+	holdoff.arm(subject, incoming);
+}
+function withPlannedUpdateWording(incoming, system, graceMin) {
+	return {
+		...incoming,
+		subject: {
+			...incoming.subject,
+			systemEvent: {
+				...system,
+				bodyKey: "system.node-offline.body.agent.updating",
+				textParams: {
+					...system.textParams,
+					graceMin: String(graceMin)
+				}
+			}
+		}
+	};
+}
+/**
 * One edge of an alert episode, from the bus or from the reconcile. The
 * ledger decides whether it is news; only news reaches the rules.
 */
@@ -105749,6 +105998,7 @@ var NotificationCenter = class {
 	stateSummary;
 	/** Every `server-updated` heard, so a stale `node-updating` is not sent after it (D723). */
 	updateLandings = new NcUpdateLandings();
+	plannedUpdates = new NcPlannedUpdateWindow();
 	/** States the `deviceState` rule gate reads. Refreshed on the reload tick;
 	*  read with no I/O on the persist hook. */
 	deviceStates;
@@ -107141,6 +107391,9 @@ var NotificationCenter = class {
 			get timelapseRules() {
 				return self.timelapseRules;
 			},
+			get plannedUpdates() {
+				return self.plannedUpdates;
+			},
 			get updateLandings() {
 				return self.updateLandings;
 			},
@@ -113073,7 +113326,10 @@ var PackageDropDetector = class {
 		}
 		if (outcome.kind === "yes") {
 			this.reportLlmSilence(this.llmSilence.noteAnswered(entry.deviceId), tags);
-			return { packageLlmVerdict: outcome.verdict };
+			return {
+				packageLlmVerdict: outcome.verdict,
+				confirmElapsedMs: latencyMs
+			};
 		}
 		this.dropUncertain(entry, tags, outcome.reason, latencyMs);
 		return null;
@@ -113265,10 +113521,12 @@ var PackageDropDetector = class {
 		}
 		const llm = await this.llmFields(entry, rules, hitZones, tags);
 		if (llm === null) return;
+		const { confirmElapsedMs, ...llmRowFields } = llm;
+		const rowTimestamp = timestamp + (confirmElapsedMs ?? 0);
 		const draft = {
 			kind: "object",
 			deviceId: entry.deviceId,
-			timestamp,
+			timestamp: rowTimestamp,
 			source: "pipeline",
 			idempotencyKey,
 			trackId: entry.sourceTrackId ?? entry.id,
@@ -113287,7 +113545,7 @@ var PackageDropDetector = class {
 			frameHeight: entry.frameHeight,
 			...entry.keyFrameMediaId !== void 0 ? { mediaId: entry.keyFrameMediaId } : {},
 			importance: PACKAGE_IMPORTANCE,
-			...llm
+			...llmRowFields
 		};
 		const rowId = await this.deps.events.insertObject(draft);
 		if (rowId === null) {
@@ -113318,7 +113576,7 @@ var PackageDropDetector = class {
 				w: entry.bbox.w,
 				h: entry.bbox.h
 			},
-			timestamp
+			timestamp: rowTimestamp
 		});
 		this.deps.logger.info("package delivered — all 5 gates passed", {
 			tags: { deviceId: entry.deviceId },
@@ -113329,6 +113587,7 @@ var PackageDropDetector = class {
 				zoneIds: hitZones,
 				dwellMs,
 				areaFrac: Number(minAreaFrac.toFixed(5)),
+				...confirmElapsedMs !== void 0 ? { footageAnchorShiftMs: confirmElapsedMs } : {},
 				...entry.confidence !== void 0 ? { confidence: entry.confidence } : {}
 			}
 		});
@@ -123860,6 +124119,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 			this.frameState.lastNonPackageActivityAt.delete(data.deviceId);
 			this.frameState.packageCollectors.forgetDevice(data.deviceId);
 			this.frameState.packageOversizeLogAt.delete(data.deviceId);
+			this.frameState.packageLookFrames.delete(data.deviceId);
 			this.frameState.packageLookDropReasons.delete(data.deviceId);
 			this.overlayState.clearDevice(data.deviceId);
 			this.frameState.overlaySynthesisWarnAt.delete(data.deviceId);
@@ -123883,6 +124143,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 		this.frameState.lastNonPackageActivityAt.delete(deviceId);
 		this.frameState.packageCollectors.forgetDevice(deviceId);
 		this.frameState.packageOversizeLogAt.delete(deviceId);
+		this.frameState.packageLookFrames.delete(deviceId);
 		this.frameState.packageLookDropReasons.delete(deviceId);
 		this.overlayState.clearDevice(deviceId);
 		this.frameState.overlaySynthesisWarnAt.delete(deviceId);
@@ -126865,6 +127126,10 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 	runPackageStillness(input) {
 		if (this.packageDropDetector === null) return;
 		const tags = { deviceId: input.deviceId };
+		if (input.frameHandle !== null) this.frameState.packageLookFrames.set(input.deviceId, {
+			handle: input.frameHandle,
+			at: input.timestamp
+		});
 		for (const t of input.tracked) {
 			if (input.packageClasses.has(t.className)) continue;
 			if (!isDelivererInPackageZone(t.zones, input.packageZoneIds)) continue;
@@ -127098,10 +127363,23 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 					...entry.confidence !== void 0 ? { confidence: entry.confidence } : {}
 				}
 			});
-			this.packageDropDetector.onStationaryChange({
-				phase: "appeared",
+			const lookFrame = this.frameState.packageLookFrames.get(input.deviceId);
+			promoteWithStill({
 				entry,
-				timestamp: entry.becameStationaryAt
+				handle: lookFrame !== void 0 && input.timestamp - lookFrame.at <= PACKAGE_LOOK_FRAME_MAX_AGE_MS ? lookFrame.handle : null,
+				timestamp: lookFrame?.at ?? input.timestamp,
+				query: (request) => this.queryPackageSceneCrop(request),
+				writer: this.mediaStore,
+				logger: this.ctx.logger,
+				detector: this.packageDropDetector
+			}).catch((err) => {
+				this.ctx.logger.warn("package promotion failed", {
+					tags,
+					meta: {
+						entryId: entry.id,
+						error: err instanceof Error ? err.message : String(err)
+					}
+				});
 			});
 		}
 		for (const entry of outcome.departed) {