@camstack/addon-post-analysis 1.1.33 → 1.1.35

package/dist/pipeline-analytics/index.mjs

@@ -1,4 +1,4 @@
-import { C as string, S as object, _ as createEvent, a as cosineSimilarity, b as boolean, d as plateGalleryCapability, f as videoclipsCapability, g as DeviceType, h as BaseAddon, i as audioMetricsCapability, l as nodePin, m as errMsg, n as EVENT_PAD_MS, p as zoneAnalyticsCapability, r as addonWidgetsSourceCapability, s as faceGalleryCapability, t as EVENT_KIND_BY_CAP, u as pipelineAnalyticsCapability, v as hydrateSchema, w as EventCategory, x as number, y as array } from "../dist-CA0GikiM.mjs";
+import { C as hydrateSchema, D as object, E as number, O as string, S as createEvent, T as boolean, _ as videoclipsCapability, a as OpsLogEntrySchema, b as BaseAddon, c as buildEventKindDescriptor, d as faceGalleryCapability, g as subKindsOf, h as plateGalleryCapability, i as MACRO_LABELS, k as EventCategory, l as cosineSimilarity, m as pipelineAnalyticsCapability, n as EVENT_KIND_BY_CAP, o as addonWidgetsSourceCapability, p as nodePin, r as EVENT_PAD_MS, s as audioMetricsCapability, t as DEFAULT_EVENT_COLOR, v as zoneAnalyticsCapability, w as array, x as DeviceType, y as errMsg } from "../dist-8DTQLWKO.mjs";
 import { randomUUID } from "node:crypto";
 import sharp from "sharp";
 //#region src/pipeline-analytics/videoclips-provider.ts
@@ -160,13 +160,13 @@ var CLASS_RANK_VEHICLE = .8;
 var CLASS_RANK_ANIMAL = .5;
 var CLASS_RANK_DEFAULT = .25;
 var PERSON_CLASSES = new Set(["person", "face"]);
-var VEHICLE_CLASSES$1 = new Set([
+var VEHICLE_CLASSES = new Set([
 	"vehicle",
 	"car",
 	"truck",
 	"bus"
 ]);
-var ANIMAL_CLASSES$1 = new Set([
+var ANIMAL_CLASSES = new Set([
 	"animal",
 	"dog",
 	"cat"
@@ -182,8 +182,8 @@ function clamp01(x) {
 function classRank(className) {
 	const c = className.toLowerCase();
 	if (PERSON_CLASSES.has(c)) return 1;
-	if (VEHICLE_CLASSES$1.has(c)) return CLASS_RANK_VEHICLE;
-	if (ANIMAL_CLASSES$1.has(c)) return CLASS_RANK_ANIMAL;
+	if (VEHICLE_CLASSES.has(c)) return CLASS_RANK_VEHICLE;
+	if (ANIMAL_CLASSES.has(c)) return CLASS_RANK_ANIMAL;
 	return CLASS_RANK_DEFAULT;
 }
 /**
@@ -3314,6 +3314,10 @@ var TRACKS_COLUMNS = [
 		name: "label",
 		type: "TEXT"
 	},
+	{
+		name: "source",
+		type: "TEXT"
+	},
 	{
 		name: "firstSeen",
 		type: "INTEGER",
@@ -4004,6 +4008,34 @@ var TrackStore = class {
 		const row = records[0];
 		return this.rowToTrack(row.id, row.data);
 	}
+	/**
+	* Persist a SYNTHETIC track (a sensor/control event projected into the
+	* unified track store). Unlike `persistCompleted` there is no live in-RAM
+	* state and no trajectory envelope (synthetic tracks carry no positions) —
+	* the row is written directly. `source: 'sensor'` marks it so spatial
+	* consumers skip it; the existing time-based clustering joins it by
+	* timestamp like any other track.
+	*/
+	async persistSyntheticTrack(t) {
+		await this.store.set.mutate({
+			collection: TRACKS_COLLECTION,
+			key: t.trackId,
+			value: {
+				deviceId: t.deviceId,
+				className: t.className,
+				...t.label !== void 0 ? { label: t.label } : {},
+				source: t.source ?? "sensor",
+				firstSeen: t.firstSeen,
+				lastSeen: t.lastSeen,
+				positions: [...t.positions],
+				snapshots: [...t.snapshots],
+				zonesVisited: [...t.zonesVisited],
+				...t.classes !== void 0 ? { classes: [...t.classes] } : {},
+				totalDistance: t.totalDistance,
+				state: t.state
+			}
+		});
+	}
 	async persistCompleted(t) {
 		const dims = this.frameDims?.(t.deviceId);
 		const envelope = computeTrackEnvelope(t.positions, dims?.w, dims?.h);
@@ -4014,6 +4046,7 @@ var TrackStore = class {
 				deviceId: t.deviceId,
 				className: t.className,
 				...t.label !== void 0 ? { label: t.label } : {},
+				...t.source !== void 0 ? { source: t.source } : {},
 				firstSeen: t.firstSeen,
 				lastSeen: t.lastSeen,
 				positions: [...t.positions],
@@ -4052,6 +4085,7 @@ var TrackStore = class {
 		const zones = data["zonesVisited"] ?? [];
 		const classes = data["classes"];
 		const label = data["label"];
+		const source = data["source"];
 		const importance = data["importance"];
 		const bestEventId = data["bestEventId"];
 		const importanceReason = data["importanceReason"];
@@ -4071,6 +4105,7 @@ var TrackStore = class {
 			deviceId: Number(data["deviceId"]),
 			className: String(data["className"]),
 			...typeof label === "string" ? { label } : {},
+			...source === "sensor" || source === "pipeline" ? { source } : {},
 			firstSeen: Number(data["firstSeen"]),
 			lastSeen: Number(data["lastSeen"]),
 			positions,
@@ -4393,6 +4428,48 @@ var MediaStore = class {
 		}
 		return removed;
 	}
+	/**
+	* On-demand footprint aggregation for the events-management UI: sum
+	* `sizeBytes` and count rows per device across the whole media collection.
+	* Pages by `id` (offset-based) so a large collection never loads at once.
+	* Metadata rows are small (no blob) — the image bytes live on the storage
+	* provider and are counted via the persisted `sizeBytes` column.
+	*/
+	async footprintByDevice() {
+		const PAGE = 1e3;
+		const out = /* @__PURE__ */ new Map();
+		let offset = 0;
+		for (;;) {
+			const rows = await this.store.query.query({
+				collection: MEDIA_COLLECTION,
+				filter: {
+					orderBy: {
+						field: "id",
+						direction: "asc"
+					},
+					limit: PAGE,
+					offset
+				}
+			});
+			if (rows.length === 0) break;
+			for (const row of rows) {
+				const data = row.data;
+				const deviceId = Number(data["deviceId"]);
+				const sizeBytes = Number(data["sizeBytes"]);
+				if (!Number.isFinite(deviceId)) continue;
+				const acc = out.get(deviceId) ?? {
+					bytes: 0,
+					rows: 0
+				};
+				acc.bytes += Number.isFinite(sizeBytes) ? sizeBytes : 0;
+				acc.rows += 1;
+				out.set(deviceId, acc);
+			}
+			if (rows.length < PAGE) break;
+			offset += PAGE;
+		}
+		return out;
+	}
 	/** Move a single media entry from one owner to another.
 	*  The new copy is written before the old one is removed.
 	*  The old-entry deletion is best-effort: on failure a warning is logged
@@ -4754,12 +4831,12 @@ var EventStore = class {
 			collection: MOTION_EVENTS_COLLECTION,
 			filter: this.buildFilter(q)
 		});
-		if (q.projection === "slim") return rows.map((r) => slimMotion(r.id, stripNulls(r.data)));
+		if (q.projection === "slim") return rows.map((r) => slimMotion(r.id, stripNulls$1(r.data)));
 		return rows.map((r) => {
 			return {
 				id: r.id,
 				kind: "motion",
-				...stripNulls(r.data)
+				...stripNulls$1(r.data)
 			};
 		});
 	}
@@ -4773,12 +4850,12 @@ var EventStore = class {
 			collection: OBJECT_EVENTS_COLLECTION,
 			filter
 		});
-		if (q.projection === "slim") return rows.map((r) => slimObject(r.id, stripNulls(r.data)));
+		if (q.projection === "slim") return rows.map((r) => slimObject(r.id, stripNulls$1(r.data)));
 		return rows.map((r) => {
 			return {
 				id: r.id,
 				kind: "object",
-				...stripNulls(r.data)
+				...stripNulls$1(r.data)
 			};
 		});
 	}
@@ -4787,12 +4864,12 @@ var EventStore = class {
 			collection: AUDIO_EVENTS_COLLECTION,
 			filter: this.buildFilter(q)
 		});
-		if (q.projection === "slim") return rows.map((r) => slimAudio(r.id, stripNulls(r.data)));
+		if (q.projection === "slim") return rows.map((r) => slimAudio(r.id, stripNulls$1(r.data)));
 		return rows.map((r) => {
 			return {
 				id: r.id,
 				kind: "audio",
-				...stripNulls(r.data)
+				...stripNulls$1(r.data)
 			};
 		});
 	}
@@ -4938,6 +5015,23 @@ var EventStore = class {
 		return updated;
 	}
 	/**
+	* Total persisted event rows (motion + object + audio) for a device — the
+	* "rows" figure in the events-management footprint. Uses the indexed `count`
+	* aggregate per collection, run in parallel.
+	*/
+	async countForDevice(deviceId) {
+		const one = (collection) => this.store.count.query({
+			collection,
+			filter: { where: { deviceId } }
+		});
+		const [motion, object, audio] = await Promise.all([
+			one(MOTION_EVENTS_COLLECTION),
+			one(OBJECT_EVENTS_COLLECTION),
+			one(AUDIO_EVENTS_COLLECTION)
+		]);
+		return motion + object + audio;
+	}
+	/**
 	* Return per-kind event counts in equal-width time buckets.
 	*
 	* Each bucket maps to a `bucketStart = since + i * bucketMs`.
@@ -5212,12 +5306,189 @@ function bboxAreaFrac(data) {
 	if (w <= 0 || h <= 0) return 0;
 	return w * h / (fw * fh);
 }
-function stripNulls(data) {
+function stripNulls$1(data) {
 	const out = {};
 	for (const [k, v] of Object.entries(data)) if (v !== null) out[k] = v;
 	return out;
 }
 //#endregion
+//#region src/pipeline-analytics/store/ops-log-store.ts
+/**
+* OpsLogStore — the EVENTS-domain operations audit for pipeline-analytics.
+*
+* pipeline-analytics already owns SQLite collections, so (unlike the recorder's
+* DurableState ring) the events ops-log is a DECLARED SQL-backed collection.
+* MUST be declared in `onInitialize` via `declare()` before the first insert —
+* an undeclared collection crash-loops the runner.
+*
+* Collection name: pipeline-analytics:ops-log
+*
+* Append is BEST-EFFORT (`append` catches + logs, never throws) — a failed
+* audit write must not fail the operation it records.
+*/
+var OPS_LOG_COLLECTION = "pipeline-analytics:ops-log";
+var OPS_LOG_COLUMNS = [
+	{
+		name: "id",
+		type: "TEXT",
+		primaryKey: true,
+		notNull: true
+	},
+	{
+		name: "at",
+		type: "INTEGER",
+		notNull: true
+	},
+	{
+		name: "domain",
+		type: "TEXT",
+		notNull: true
+	},
+	{
+		name: "op",
+		type: "TEXT",
+		notNull: true
+	},
+	{
+		name: "reason",
+		type: "TEXT",
+		notNull: true
+	},
+	{
+		name: "deviceId",
+		type: "INTEGER"
+	},
+	{
+		name: "nodeId",
+		type: "TEXT",
+		notNull: true
+	},
+	{
+		name: "itemsAffected",
+		type: "INTEGER",
+		notNull: true
+	},
+	{
+		name: "bytesReclaimed",
+		type: "INTEGER",
+		notNull: true
+	},
+	{
+		name: "detail",
+		type: "TEXT"
+	},
+	{
+		name: "actor",
+		type: "TEXT",
+		notNull: true
+	}
+];
+var OPS_LOG_INDEXES = [{
+	name: "idx_opslog_at",
+	columns: ["at"]
+}, {
+	name: "idx_opslog_device_at",
+	columns: ["deviceId", "at"]
+}];
+var OpsLogStore = class {
+	store;
+	logger;
+	nodeId;
+	now;
+	newId;
+	constructor(deps) {
+		this.store = deps.store;
+		this.logger = deps.logger;
+		this.nodeId = deps.nodeId;
+		this.now = deps.now ?? (() => Date.now());
+		this.newId = deps.newId ?? (() => globalThis.crypto.randomUUID());
+	}
+	static async declare(store) {
+		await store.declareCollection.mutate({
+			collection: OPS_LOG_COLLECTION,
+			columns: [...OPS_LOG_COLUMNS],
+			indexes: [...OPS_LOG_INDEXES]
+		});
+	}
+	/**
+	* Append one events-domain ops-log row. Best-effort — stamps
+	* `domain:'events'`, `nodeId`, `id`, `at`, validates, inserts, and swallows
+	* (logs) any failure so it can never fail the operation being audited.
+	*/
+	async append(input) {
+		const entry = {
+			id: this.newId(),
+			at: this.now(),
+			domain: "events",
+			op: input.op,
+			reason: input.reason,
+			deviceId: input.deviceId,
+			nodeId: this.nodeId,
+			itemsAffected: input.itemsAffected,
+			bytesReclaimed: input.bytesReclaimed,
+			detail: input.detail ?? null,
+			actor: input.actor ?? "operator"
+		};
+		try {
+			const { id, ...rest } = OpsLogEntrySchema.parse(entry);
+			await this.store.insert.mutate({
+				collection: OPS_LOG_COLLECTION,
+				record: {
+					id,
+					data: rest
+				}
+			});
+		} catch (err) {
+			this.logger.warn("OpsLogStore.append failed (best-effort)", {
+				tags: { deviceId: input.deviceId ?? void 0 },
+				meta: {
+					op: input.op,
+					error: String(err)
+				}
+			});
+		}
+	}
+	/**
+	* List events ops-log rows newest-first, optionally scoped to one device,
+	* capped at `limit` (default {@link OPS_LOG_DEFAULT_LIMIT}).
+	*/
+	async list(query) {
+		const filter = {
+			orderBy: {
+				field: "at",
+				direction: "desc"
+			},
+			limit: query.limit ?? 200
+		};
+		if (query.deviceId !== void 0) filter.where = { deviceId: query.deviceId };
+		const rows = await this.store.query.query({
+			collection: OPS_LOG_COLLECTION,
+			filter
+		});
+		const out = [];
+		for (const r of rows) {
+			const parsed = OpsLogEntrySchema.safeParse({
+				id: r.id,
+				...stripNulls(r.data)
+			});
+			if (parsed.success) out.push(parsed.data);
+			else this.logger.debug("OpsLogStore.list: skipped malformed row", { meta: { id: r.id } });
+		}
+		return out;
+	}
+};
+/** SQLite stores nullable columns as `null`; the row schema uses `.nullable()`
+*  for deviceId/detail (accepts null) but drop any stray null on required
+*  fields defensively before parse. */
+function stripNulls(data) {
+	const out = {};
+	for (const [k, v] of Object.entries(data)) {
+		if (v === null && k !== "deviceId" && k !== "detail") continue;
+		out[k] = v;
+	}
+	return out;
+}
+//#endregion
 //#region src/pipeline-analytics/store/sensor-event-store.ts
 var SENSOR_EVENTS_COLLECTION = "pipeline-analytics:sensor-events";
 var SENSOR_EVENT_COLUMNS = [
@@ -5390,114 +5661,49 @@ function isRecord(x) {
 * linked camera ids) with a TTL, so the `DeviceStateChanged` handler stays
 * cheap at bus rate.
 */
-var MOTION_COLOR = "#f59e0b";
-var AUDIO_COLOR = "#06b6d4";
-var PERSON_COLOR = "#22c55e";
-var VEHICLE_COLOR = "#3b82f6";
-var ANIMAL_COLOR = "#f97316";
-var GENERIC_DETECTION_COLOR = "#64748b";
-var PACKAGE_COLOR = "#a855f7";
-var VEHICLE_CLASSES = new Set([
-	"vehicle",
-	"car",
-	"truck",
-	"bus",
-	"motorcycle",
-	"bicycle",
-	"boat",
-	"train"
-]);
-var ANIMAL_CLASSES = new Set([
-	"animal",
-	"dog",
-	"cat",
-	"bird",
-	"horse",
-	"cow",
-	"sheep"
-]);
-function detectionIcon(className) {
-	if (className === "person") return "person";
-	if (VEHICLE_CLASSES.has(className)) return "vehicle";
-	if (ANIMAL_CLASSES.has(className)) return "animal";
-	return "generic";
-}
-function detectionColor(className) {
-	if (className === "person") return PERSON_COLOR;
-	if (VEHICLE_CLASSES.has(className)) return VEHICLE_COLOR;
-	if (ANIMAL_CLASSES.has(className)) return ANIMAL_COLOR;
-	return GENERIC_DETECTION_COLOR;
-}
-function titleCase(s) {
-	return s.length > 0 ? s.charAt(0).toUpperCase() + s.slice(1) : s;
-}
 /**
-* Full event-kind list for a camera. Sensor kinds are deduped per
-* (kind, source deviceId) — two linked contact sensors each contribute
-* their own entry, distinguishable by `source.deviceId`.
+* Full event-kind taxonomy a camera CAN emit (config-derived):
+*   (a) motion built-in — always;
+*   (b) each enabled detection macro + its taxonomy subs (reverse COCO);
+*   (c) audio macro + its subs when the classifier is enabled;
+*   (d) package kinds when a package zone rule is enabled;
+*   (e) sensor/control kinds from LINKED devices (binding-driven), deduped
+*       per (kind, source deviceId).
+* Every descriptor carries parentKind/level/iconId/labelKey via the single
+* taxonomy dictionary — no color/icon is declared here.
 */
 async function composeEventKinds(deps, deviceId) {
-	const out = [{
-		kind: "motion",
-		label: "Motion",
-		color: MOTION_COLOR,
-		icon: "motion",
-		category: "motion",
-		source: {
-			capName: "pipeline-analytics",
-			deviceId
-		}
-	}, {
-		kind: "audio",
-		label: "Audio",
-		color: AUDIO_COLOR,
-		icon: "audio",
-		category: "audio",
-		source: {
-			capName: "pipeline-analytics",
-			deviceId
-		}
-	}];
+	const out = [];
+	const cameraSource = {
+		capName: "pipeline-analytics",
+		deviceId
+	};
+	const pushKind = (kind, source = cameraSource) => {
+		const d = buildEventKindDescriptor(kind, source);
+		if (d !== null) out.push(d);
+	};
+	pushKind("motion");
 	try {
-		const classNames = await deps.observedClassNames(deviceId);
-		for (const className of [...classNames].sort()) out.push({
-			kind: className,
-			label: titleCase(className),
-			color: detectionColor(className),
-			icon: detectionIcon(className),
-			category: "detection",
-			source: {
-				capName: "pipeline-analytics",
-				deviceId
-			}
-		});
+		const macros = await deps.enabledMacroClasses(deviceId);
+		for (const macro of macros) {
+			pushKind(macro);
+			for (const sub of subKindsOf(macro)) pushKind(sub.kind);
+		}
 	} catch (err) {
-		deps.onError?.("observedClassNames", err);
+		deps.onError?.("enabledMacroClasses", err);
+	}
+	try {
+		if (await deps.audioEnabled(deviceId)) {
+			pushKind("audio");
+			for (const sub of subKindsOf("audio")) pushKind(sub.kind);
+		}
+	} catch (err) {
+		deps.onError?.("audioEnabled", err);
 	}
 	try {
 		if (deps.packageZonesEnabled && await deps.packageZonesEnabled(deviceId)) {
-			out.push({
-				kind: "package-delivered",
-				label: "Package delivered",
-				color: PACKAGE_COLOR,
-				icon: "package",
-				category: "package",
-				source: {
-					capName: "pipeline-analytics",
-					deviceId
-				}
-			});
-			out.push({
-				kind: "package-picked-up",
-				label: "Package picked up",
-				color: PACKAGE_COLOR,
-				icon: "package",
-				category: "package",
-				source: {
-					capName: "pipeline-analytics",
-					deviceId
-				}
-			});
+			pushKind("package");
+			for (const sub of subKindsOf("package")) pushKind(sub.kind);
 		}
 	} catch (err) {
 		deps.onError?.("packageZonesEnabled", err);
@@ -5520,16 +5726,9 @@ async function composeEventKinds(deps, deviceId) {
 				const dedupeKey = `${descriptor.kind}:${linked.deviceId}`;
 				if (seen.has(dedupeKey)) continue;
 				seen.add(dedupeKey);
-				out.push({
-					kind: descriptor.kind,
-					label: descriptor.label,
-					color: descriptor.color,
-					icon: descriptor.icon,
-					category: descriptor.category,
-					source: {
-						capName,
-						deviceId: linked.deviceId
-					}
+				pushKind(descriptor.kind, {
+					capName,
+					deviceId: linked.deviceId
 				});
 			}
 		}
@@ -5625,6 +5824,110 @@ async function ingestSensorStateChange(deps, data, timestamp) {
 	return inserted;
 }
 //#endregion
+//#region src/pipeline-analytics/services/synthetic-sensor-track.ts
+/**
+* Synthetic sensor/control tracks (event-kinds-taxonomy §8).
+*
+* A linked sensor/control state change is projected into the UNIFIED track
+* store as a SYNTHETIC track: `className` = the event kind (`contact` /
+* `lock` / `switch` …), `source: 'sensor'`, media = an on-demand snapshot of
+* the linked camera in the SAME `getTrackMedia` shape the UIs consume (no
+* bbox → full frame), `positions: []`. It joins the timeline via the existing
+* time-based clustering — no new join mechanism.
+*
+* The raw `SensorEvent` remains the durable record; this track is its
+* projection. Snapshots are debounced per `(camera, kind)` so a chattery
+* sensor doesn't hammer the snapshot cap. Spatial consumers MUST skip
+* `source:'sensor'` tracks (they carry no trajectory).
+*/
+var DEFAULT_DEBOUNCE_MS = 1e4;
+/** Full-frame, position-less placeholder (spatial consumers skip these). */
+function zeroPosition(timestamp) {
+	return {
+		x: 0,
+		y: 0,
+		timestamp,
+		bbox: {
+			x: 0,
+			y: 0,
+			w: 0,
+			h: 0
+		}
+	};
+}
+var SyntheticSensorTrackMaterializer = class {
+	deps;
+	debounceMs;
+	makeId;
+	now;
+	/** Last snapshot time per `${cameraId}:${kind}`. */
+	lastAt = /* @__PURE__ */ new Map();
+	constructor(deps) {
+		this.deps = deps;
+		this.debounceMs = deps.debounceMs ?? DEFAULT_DEBOUNCE_MS;
+		this.makeId = deps.makeId ?? (() => `pa-synth-${randomUUID()}`);
+		this.now = deps.now ?? Date.now;
+	}
+	/**
+	* Materialize a synthetic track for a sensor/control event on `cameraId`.
+	* Returns the persisted track, or null when debounced. Snapshot failure
+	* still lands a track (with no media) — it never blocks the sensor record.
+	*/
+	async materialize(input) {
+		const key = `${input.cameraId}:${input.kind}`;
+		const last = this.lastAt.get(key);
+		if (last !== void 0 && this.now() - last < this.debounceMs) return null;
+		this.lastAt.set(key, this.now());
+		const trackId = this.makeId();
+		const ts = input.timestamp;
+		let mediaKey = null;
+		try {
+			const snap = await this.deps.snapshot.getSnapshot({
+				deviceId: input.cameraId,
+				force: true
+			});
+			if (snap !== null) {
+				const data = Buffer.from(snap.base64, "base64");
+				mediaKey = await this.deps.media.put({
+					deviceId: input.cameraId,
+					ownerKind: "track",
+					ownerId: trackId,
+					kind: "snapshot",
+					timestamp: ts,
+					data
+				});
+			} else this.deps.onError?.("getSnapshot", /* @__PURE__ */ new Error("snapshot returned null"));
+		} catch (err) {
+			this.deps.onError?.("snapshotMedia", err);
+		}
+		const track = {
+			trackId,
+			deviceId: input.cameraId,
+			className: input.kind,
+			source: "sensor",
+			firstSeen: ts,
+			lastSeen: ts,
+			positions: [],
+			snapshots: mediaKey !== null ? [{
+				timestamp: ts,
+				position: zeroPosition(ts),
+				mediaKey
+			}] : [],
+			zonesVisited: [],
+			totalDistance: 0,
+			state: "idle",
+			active: false
+		};
+		try {
+			await this.deps.tracks.persistSyntheticTrack(track);
+		} catch (err) {
+			this.deps.onError?.("persistSyntheticTrack", err);
+			return null;
+		}
+		return track;
+	}
+};
+//#endregion
 //#region src/shared/frame/resolve-frame.ts
 /**
 * Resolve the pixels a `FrameHandle` refers to via the node-routed fetch.
@@ -5672,7 +5975,7 @@ function squareSafeCropRegion(bbox, frame, padding) {
 }
 //#endregion
 //#region src/shared/frame/box-drawer.ts
-var DEFAULT_COLOR = "#22ff55";
+var DEFAULT_COLOR = DEFAULT_EVENT_COLOR;
 var DEFAULT_QUALITY = 80;
 var STROKE_WIDTH = 3;
 function escapeXml(s) {
@@ -10959,11 +11262,15 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 	stationaryRegistry = null;
 	mediaStore = null;
 	eventStore = null;
+	/** Events-domain ops-log (footprint/prune/manual-delete audit). Null until onInitialize. */
+	eventsOpsLog = null;
 	/** Per-camera history of LINKED-device sensor state changes (Part B). */
 	sensorEventStore = null;
 	/** Ingest-side reverse index (sensor device → linked camera ids), TTL-cached
 	*  so the DeviceStateChanged handler stays cheap. */
 	linkedCamerasCache = null;
+	/** Projects sensor/control events into synthetic snapshot-carrying tracks. */
+	syntheticSensorTracks = null;
 	identityStore = null;
 	faceStore = null;
 	faceRecognizer = null;
@@ -11121,6 +11428,7 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 		await VehicleStore.declare(api.settingsStore);
 		await ObjectEmbeddingStore.declare(api.settingsStore);
 		await StationaryObjectRegistry.declare(api.settingsStore);
+		await OpsLogStore.declare(api.settingsStore);
 		const logger = this.ctx.logger;
 		let storage = this.ctx.kernel.storage;
 		const mediaRoot = process.env.CAMSTACK_MEDIA_ROOT?.trim();
@@ -11130,11 +11438,12 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 			logger.info("pipeline-analytics: event media rooted at CAMSTACK_MEDIA_ROOT", { meta: { mediaRoot } });
 		}
 		if (!storage) throw new Error("pipeline-analytics requires ctx.kernel.storage");
-		this.trackStore = new TrackStore({
+		const trackStore = new TrackStore({
 			store: api.settingsStore,
 			logger: logger.child("TrackStore"),
 			frameDims: (deviceId) => this.lastFrameDimsByDevice.get(deviceId)
 		});
+		this.trackStore = trackStore;
 		this.stationaryRegistry = new StationaryObjectRegistry({
 			store: api.settingsStore,
 			logger: logger.child("StationaryRegistry"),
@@ -11164,11 +11473,12 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 			}
 		});
 		await this.stationaryRegistry.load();
-		this.mediaStore = new MediaStore({
+		const mediaStore = new MediaStore({
 			storage,
 			store: api.settingsStore,
 			logger: logger.child("MediaStore")
 		});
+		this.mediaStore = mediaStore;
 		const eventStore = new EventStore({
 			store: api.settingsStore,
 			logger: logger.child("EventStore"),
@@ -11228,6 +11538,15 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 				error: errMsg(err)
 			} })
 		});
+		this.syntheticSensorTracks = new SyntheticSensorTrackMaterializer({
+			snapshot: { getSnapshot: (i) => api.snapshot.getSnapshot.query(i) },
+			media: mediaStore,
+			tracks: trackStore,
+			onError: (scope, err) => logger.warn("synthetic sensor-track error", { meta: {
+				scope,
+				error: errMsg(err)
+			} })
+		});
 		this.identityStore = new IdentityStore({
 			store: api.settingsStore,
 			logger: logger.child("IdentityStore")
@@ -11246,6 +11565,11 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 		});
 		const rawNodeId = this.ctx.kernel.localNodeId ?? this.ctx.id;
 		const ownNodeId = rawNodeId.includes("/") ? rawNodeId.split("/")[0] : rawNodeId;
+		this.eventsOpsLog = new OpsLogStore({
+			store: api.settingsStore,
+			logger: logger.child("ops-log"),
+			nodeId: ownNodeId
+		});
 		{
 			const designated = await this.postProcessingNodeState.get();
 			this.isPostProcessingNode = ownNodeId === designated;
@@ -13460,10 +13784,21 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 	*/
 	async listEventKinds(input) {
 		const api = this.ctx.api;
+		const status = await api.pipelineOrchestrator.getCameraStatus.query({ deviceId: input.deviceId }).catch((err) => {
+			this.ctx.logger.warn("listEventKinds: getCameraStatus failed", {
+				tags: { deviceId: input.deviceId },
+				meta: { error: errMsg(err) }
+			});
+			return null;
+		});
+		const detectionOn = status?.detection != null;
+		const audioOn = status?.audio?.enabled === true;
+		const detectionMacros = MACRO_LABELS.map((l) => l.id).filter((id) => id !== "package");
 		return composeEventKinds({
 			linkedDevices: { getLinkedDevices: (i) => api.deviceManager.getLinkedDevices.query(i) },
 			bindings: { getBindings: (i) => api.deviceManager.getBindings.query(i) },
-			observedClassNames: async (deviceId) => this.trackStore?.observedClassNames(deviceId) ?? [],
+			enabledMacroClasses: async () => detectionOn ? detectionMacros : [],
+			audioEnabled: async () => audioOn,
 			packageZonesEnabled: async (deviceId) => {
 				return (await this.resolveDevicePackageRules(deviceId)).some((r) => r.enabled !== false);
 			},
@@ -13503,6 +13838,26 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 				}
 			});
 		}
+		const materializer = this.syntheticSensorTracks;
+		const descriptor = EVENT_KIND_BY_CAP[data.capName];
+		if (materializer === null || descriptor === void 0) return;
+		try {
+			const cameraIds = await cache.camerasFor(data.deviceId);
+			for (const cameraId of cameraIds) await materializer.materialize({
+				cameraId,
+				sourceDeviceId: data.deviceId,
+				kind: descriptor.kind,
+				timestamp
+			});
+		} catch (err) {
+			this.ctx.logger.warn("synthetic sensor-track materialize failed", {
+				tags: { deviceId: data.deviceId },
+				meta: {
+					capName: data.capName,
+					error: errMsg(err)
+				}
+			});
+		}
 	}
 	async clearTracks(input) {
 		this.trackStore?.clearDevice(input.deviceId);
@@ -13751,6 +14106,120 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 		};
 	}
 	/**
+	* Durable event-store footprint for the events-management UI: event ROWS
+	* (motion + object + audio) counted per camera (indexed `count`) + total, and
+	* event-owned media BYTES on disk per camera (paged `sizeBytes` sum) + total.
+	* The device set is the union of cameras that have media OR persisted tracks;
+	* cameras with neither rows nor bytes are omitted.
+	*/
+	async getEventStoreFootprint() {
+		const eventStore = this.eventStore;
+		const mediaStore = this.mediaStore;
+		if (!eventStore || !mediaStore) return {
+			totalRows: 0,
+			totalBytes: 0,
+			devices: []
+		};
+		const mediaByDevice = await mediaStore.footprintByDevice();
+		const deviceIds = new Set(mediaByDevice.keys());
+		if (this.trackStore) for (const id of await this.trackStore.listDeviceIds()) deviceIds.add(id);
+		const devices = [];
+		let totalRows = 0;
+		let totalBytes = 0;
+		for (const deviceId of deviceIds) {
+			const rows = await eventStore.countForDevice(deviceId);
+			const bytes = mediaByDevice.get(deviceId)?.bytes ?? 0;
+			if (rows === 0 && bytes === 0) continue;
+			totalRows += rows;
+			totalBytes += bytes;
+			devices.push({
+				deviceId,
+				rows,
+				bytes
+			});
+		}
+		devices.sort((a, b) => b.bytes - a.bytes);
+		return {
+			totalRows,
+			totalBytes,
+			devices
+		};
+	}
+	/**
+	* Cluster-wide prune of events with `timestamp < olderThanMs` across every
+	* camera (via the device-agnostic `evictBefore`), deleting each pruned event's
+	* media in lockstep. Logs one global (`deviceId:null`) events ops-log row.
+	* `bytesReclaimed` is 0 (media deletion does not surface freed bytes).
+	*/
+	async pruneEvents(input) {
+		const eventStore = this.eventStore;
+		if (!eventStore) return {
+			motion: 0,
+			object: 0,
+			audio: 0
+		};
+		const cutoff = input.olderThanMs;
+		const evicted = await eventStore.evictBefore({
+			motionCutoffMs: cutoff,
+			objectCutoffMs: cutoff,
+			audioCutoffMs: cutoff
+		});
+		const ids = [
+			...evicted.motion,
+			...evicted.object,
+			...evicted.audio
+		];
+		if (ids.length > 0 && this.mediaStore) await this.mediaStore.deleteForEvents(ids);
+		const counts = {
+			motion: evicted.motion.length,
+			object: evicted.object.length,
+			audio: evicted.audio.length
+		};
+		const total = counts.motion + counts.object + counts.audio;
+		await this.eventsOpsLog?.append({
+			op: "prune",
+			reason: input.reason ?? "retention",
+			deviceId: null,
+			itemsAffected: total,
+			bytesReclaimed: 0,
+			detail: `pruned events older than ${cutoff}`
+		});
+		if (total > 0) this.ctx.logger.info("analytics events pruned (cluster)", { meta: {
+			cutoffMs: cutoff,
+			...counts
+		} });
+		return counts;
+	}
+	/**
+	* Manually delete EVERY event (motion + object + audio) for one camera and its
+	* event-owned media in lockstep. Logs a manual events ops-log row.
+	*/
+	async deleteDeviceEvents(input) {
+		if (!this.eventStore) return {
+			motion: 0,
+			object: 0,
+			audio: 0
+		};
+		const counts = await this.pruneEventsBefore({
+			deviceId: input.deviceId,
+			cutoffMs: Number.MAX_SAFE_INTEGER
+		});
+		const total = counts.motion + counts.object + counts.audio;
+		await this.eventsOpsLog?.append({
+			op: "manual-delete",
+			reason: "manual",
+			deviceId: input.deviceId,
+			itemsAffected: total,
+			bytesReclaimed: 0,
+			detail: "deleted all events for device"
+		});
+		return counts;
+	}
+	/** The events ops-log rows (newest-first), optionally scoped to one camera. */
+	async listOpsLog(input) {
+		return await this.eventsOpsLog?.list(input) ?? [];
+	}
+	/**
 	* Track-centric time-based retention (design §5.1). Drains every persisted
 	* track for the device whose `lastSeen < cutoffMs`, page by page, through the
 	* widened cascade — enrolled faces/plates + identity media are exempt (design