@camstack/addon-post-analysis 1.2.90 → 1.2.92

package/dist/pipeline-analytics/index.mjs

@@ -1,4 +1,4 @@
-import { $ as faceGalleryCapability, At as record, B as VISIT_MERGE_GAP_MS, C as NcSnoozeSchema, Ct as array, D as OpsLogEntrySchema, Dt as number, E as NcTaxonomySchema, Et as literal, F as TIMELAPSE_DENSE_FLOOR_SEC, G as audioModeOf, H as alarmPanelCapability, I as TimelapseRuleInputSchema, J as customAction, K as buildEventKindDescriptor, L as TimelapseRulePatchSchema, M as SCENE_DEFAULT_UNCOVERED_POLICY, Mt as unknown, N as SCENE_DIVERGED, Nt as EventCategory, O as RECORDING_EXPORT_MAX_READ_BYTES, Ot as object, P as SceneMonitorSchema, Q as encodeVectorBase64, R as TimelapseRuleSchema, S as NcSnoozeInputSchema, St as _enum, T as NcSystemEventKindSchema, Tt as discriminatedUnion, U as assertTimelapseCadences, V as addonWidgetsSourceCapability, W as audioMetricsCapability, X as deriveRecordingMode, Y as defineCustomActions, _ as NcRuleInputSchema, _t as createEvent, at as pipelineAnalyticsCapability, b as NcRuleTargetSchema, bt as nodePin, c as EVENT_PAD_MS, ct as readTimelapseGeneratedAt, d as NC_ALARM_SYSTEM_EVENT_KINDS, dt as vectorDimFromBase64, f as NC_CONDITION_CATALOG, ft as videoclipsCapability, g as NcConditionDescriptorSchema, gt as DeviceType, h as NC_TAXONOMY, ht as BaseAddon, i as DETECTION_MACRO_CLASSES, it as notificationRulesCapability, j as SCENE_DEFAULT_ANCHOR_THRESHOLD, jt as string, k as RetrainStatusSchema, kt as partialRecord, l as LabelAttributionSchema, lt as sceneMonitorCapability, mt as errMsg, n as DEFAULT_EVENT_COLOR, nt as isScheduleActive, o as DeclaredDevices, ot as plateGalleryCapability, p as NC_DEFAULT_SNOOZE_MINUTES, pt as zoneAnalyticsCapability, q as cosineSimilarity$1, rt as kebabToCamel, s as EVENT_KIND_BY_CAP, st as readDeviceStateFrom, t as BaseDevice, tt as isDetectionMacroClass, u as MACRO_LABELS, ut as subKindsOf, v as NcRulePatchSchema, vt as hydrateSchema, w as NcSnoozeSuppressedSchema, wt as boolean, x as NcScheduleSchema, xt as sleep, y as NcRuleSchema, yt as isDeviceScopedCap, z as TrackSourceSchema } from "../dist-Bac7ww1C.mjs";
+import { $ as faceGalleryCapability, At as partialRecord, B as VISIT_MERGE_GAP_MS, C as NcSnoozeSchema, Ct as _enum, D as OpsLogEntrySchema, Dt as literal, E as NcTaxonomySchema, Et as discriminatedUnion, F as TIMELAPSE_DENSE_FLOOR_SEC, G as audioModeOf, H as alarmPanelCapability, I as TimelapseRuleInputSchema, J as customAction, K as buildEventKindDescriptor, L as TimelapseRulePatchSchema, M as SCENE_DEFAULT_UNCOVERED_POLICY, Mt as string, N as SCENE_DIVERGED, Nt as unknown, O as RECORDING_EXPORT_MAX_READ_BYTES, Ot as number, P as SceneMonitorSchema, Pt as EventCategory, Q as encodeVectorBase64, R as TimelapseRuleSchema, S as NcSnoozeInputSchema, St as sleep, T as NcSystemEventKindSchema, Tt as boolean, U as assertTimelapseCadences, V as addonWidgetsSourceCapability, W as audioMetricsCapability, X as deriveRecordingMode, Y as defineCustomActions, _ as NcRuleInputSchema, _t as DeviceType, at as pipelineAnalyticsCapability, b as NcRuleTargetSchema, bt as isDeviceScopedCap, c as EVENT_PAD_MS, ct as readTimelapseGeneratedAt, d as NC_ALARM_SYSTEM_EVENT_KINDS, dt as systemEventFilterApplies, f as NC_CONDITION_CATALOG, ft as vectorDimFromBase64, g as NcConditionDescriptorSchema, gt as BaseAddon, h as NC_TAXONOMY, ht as errMsg, i as DETECTION_MACRO_CLASSES, it as notificationRulesCapability, j as SCENE_DEFAULT_ANCHOR_THRESHOLD, jt as record, k as RetrainStatusSchema, kt as object, l as LabelAttributionSchema, lt as sceneMonitorCapability, mt as zoneAnalyticsCapability, n as DEFAULT_EVENT_COLOR, nt as isScheduleActive, o as DeclaredDevices, ot as plateGalleryCapability, p as NC_DEFAULT_SNOOZE_MINUTES, pt as videoclipsCapability, q as cosineSimilarity$1, rt as kebabToCamel, s as EVENT_KIND_BY_CAP, st as readDeviceStateFrom, t as BaseDevice, tt as isDetectionMacroClass, u as MACRO_LABELS, ut as subKindsOf, v as NcRulePatchSchema, vt as createEvent, w as NcSnoozeSuppressedSchema, wt as array, x as NcScheduleSchema, xt as nodePin, y as NcRuleSchema, yt as hydrateSchema, z as TrackSourceSchema } from "../dist-VnaTfwAL.mjs";
 import { t as __exportAll } from "../embedding-encoder/index.mjs";
 import * as fs from "node:fs";
 import { promises } from "node:fs";
@@ -7779,17 +7779,40 @@ function referencesAudioClass(classes) {
 	if (classes === void 0) return false;
 	return classes.some((c) => c.trim().toLowerCase().startsWith("audio-"));
 }
-function matchesSystemEvent(condition, subject) {
-	if (!condition.kinds.includes(subject.kind)) return false;
-	if (condition.deviceIds !== void 0 && (subject.deviceId === void 0 || !condition.deviceIds.includes(subject.deviceId))) return false;
-	if (condition.deviceTypes !== void 0 && (subject.deviceType === void 0 || !condition.deviceTypes.includes(subject.deviceType))) return false;
-	if (condition.nodeIds !== void 0) {
-		if (!subjectNodes(subject).some((id) => condition.nodeIds.includes(id))) return false;
+/**
+* Match one system subject against one rule's system-event condition.
+*
+* EVERY NARROWING FILTER IS SCOPED TO ITS KIND FAMILY, and the scoping is not
+* decided here: `systemEventFilterApplies` (in `@camstack/types`) is the one
+* statement of it, and both rule editors compute their filter visibility from
+* the same predicate. A filter outside a kind's family is IGNORED — never an
+* exclusion. It used to be an exclusion, and that made the operator's
+* eleven-kind rule with `deviceTypes: ['camera']` deliverable for exactly the
+* two kinds that carry a device type; the other nine failed closed and logged
+* nothing for four days.
+*
+* Inside its family a filter still narrows, and still fails CLOSED when the
+* subject cannot produce the identity it tests.
+*
+* Returns `undefined` on a match.
+*/
+function systemEventExclusion(condition, subject) {
+	if (!condition.kinds.includes(subject.kind)) return "kinds";
+	const applies = (filter) => systemEventFilterApplies(subject.kind, filter);
+	if (condition.deviceIds !== void 0 && applies("deviceIds")) {
+		if (subject.deviceId === void 0 || !condition.deviceIds.includes(subject.deviceId)) return "deviceIds";
 	}
-	if (condition.packageNames !== void 0) {
-		if (!subjectPackages(subject).some((name) => condition.packageNames.includes(name))) return false;
+	if (condition.deviceTypes !== void 0 && applies("deviceTypes")) {
+		if (subject.deviceType === void 0 || !condition.deviceTypes.includes(subject.deviceType)) return "deviceTypes";
+	}
+	const wantedNodes = condition.nodeIds;
+	if (wantedNodes !== void 0 && applies("nodeIds")) {
+		if (!subjectNodes(subject).some((id) => wantedNodes.includes(id))) return "nodeIds";
+	}
+	const wantedPackages = condition.packageNames;
+	if (wantedPackages !== void 0 && applies("packageNames")) {
+		if (!subjectPackages(subject).some((name) => wantedPackages.includes(name))) return "packageNames";
 	}
-	return true;
 }
 function subjectNodes(subject) {
 	const ids = [...subject.nodeIds ?? []];
@@ -7805,7 +7828,14 @@ function evaluateRule(rule, subject, deviceState, zoneOwners, sceneStates) {
 	if (subject.kind === "system-event") {
 		if (rule.delivery !== "system-event") return fail("delivery");
 		const condition = rule.conditions.systemEvent;
-		if (condition === void 0 || subject.systemEvent === void 0 || !matchesSystemEvent(condition, subject.systemEvent)) return fail("systemEvent");
+		const systemEvent = subject.systemEvent;
+		if (condition === void 0 || systemEvent === void 0) return fail("systemEvent");
+		const excluded = systemEventExclusion(condition, systemEvent);
+		if (excluded !== void 0) return excluded === "kinds" ? fail("systemEvent") : {
+			matched: false,
+			failedCondition: "systemEvent",
+			excludedBySystemEventFilter: excluded
+		};
 		if (rule.conditions.occupancy !== void 0) return fail("occupancy");
 		if (rule.conditions.audio !== void 0) return fail("audio");
 	} else if (subject.kind === "occupancy-event") {
@@ -20038,6 +20068,39 @@ var NotificationCenter = class NotificationCenter {
 		if (identity.isCamera && identity.detectionActive === false) return "detection-off";
 	}
 	/**
+	* "Your rule covers this kind, and your own filter dropped it."
+	*
+	* INFO, not debug, and unconditional. The alternative is what shipped: a
+	* rule that selected eleven system-event kinds delivered two of them for
+	* four days, and the nine it silently refused produced no line anywhere —
+	* indistinguishable from an intake that had stopped emitting. The filter is
+	* NAMED, and so is the value that failed it, because the fix is always an
+	* edit to that one list.
+	*
+	* `tags.deviceId` carries the SUBJECT's numeric device id (the system
+	* subject's own `deviceId` is the sentinel {@link NC_SYSTEM_DEVICE_ID}), so
+	* "why is 617 louder than 2018?" is answerable by grouping. A node- or
+	* package-scoped exclusion is about no device and carries no tag.
+	*/
+	reportSystemFilterExclusion(rule, subject, filter) {
+		const system = subject.systemEvent;
+		if (system === void 0) return;
+		this.logger.info("system event excluded by a rule filter", {
+			...system.deviceId !== void 0 ? { tags: { deviceId: system.deviceId } } : {},
+			meta: {
+				ruleId: rule.id,
+				rule: rule.name,
+				kind: system.kind,
+				filter,
+				eventId: subject.recordId,
+				subject: system.subject,
+				...system.deviceType !== void 0 ? { deviceType: system.deviceType } : {},
+				...system.nodeId !== void 0 ? { nodeId: system.nodeId } : {},
+				...system.packageName !== void 0 ? { packageName: system.packageName } : {}
+			}
+		});
+	}
+	/**
 	* SAY that the scene gate suppressed this rule.
 	*
 	* A branch that drops work silently logs it — the three-hour media blackout
@@ -20457,6 +20520,7 @@ var NotificationCenter = class NotificationCenter {
 			const evaluation = evaluateRule(rule, subject, (id) => this.deviceStates.get(id), (id) => this.zoneOwners.get(id), (sceneId) => this.sceneStates.get(sceneId));
 			if (!evaluation.matched) {
 				if (evaluation.failedCondition === "scene") this.reportSceneSuppression(rule, subject);
+				if (evaluation.excludedBySystemEventFilter !== void 0) this.reportSystemFilterExclusion(rule, subject, evaluation.excludedBySystemEventFilter);
 				rejections.push(`${rule.name}:${evaluation.failedCondition ?? "unknown"}`);
 				outcomes.push({
 					ruleId: rule.id,
@@ -22357,7 +22421,7 @@ var ncActions = defineCustomActions({
 	"nc.getArtifact": customAction(object({ artifactId: string().min(1) }), object({ artifact: NcArtifactRecordSchema.nullable() }), { caller: "required" })
 });
 /** Fail-closed caller resolution — an absent forwarded caller is NEVER admin. */
-function requireCaller(caller) {
+function requireCaller$1(caller) {
 	if (!caller || typeof caller.userId !== "string" || caller.userId.length === 0) throw new Error("forbidden: authenticated caller required");
 	return caller;
 }
@@ -22455,14 +22519,14 @@ function makeNcActionHandlers(deps) {
 	};
 	return {
 		"nc.listRules": async (_input, caller) => {
-			const c = requireCaller(caller);
+			const c = requireCaller$1(caller);
 			return { rules: (c.isAdmin ? deps.ruleStore.list() : deps.ruleStore.listForOwner(c.userId)).map((r) => ({
 				...r,
 				readOnly: !c.isAdmin && r.ownerUserId !== c.userId
 			})) };
 		},
 		"nc.listTrackGroups": async (input, caller) => {
-			requireCaller(caller);
+			requireCaller$1(caller);
 			const list = deps.listTrackGroups;
 			if (list === void 0) return { groups: [] };
 			return { groups: [...await list(input)] };
@@ -22472,7 +22536,7 @@ function makeNcActionHandlers(deps) {
 			taxonomy: NC_TAXONOMY
 		}),
 		"nc.createRule": async (input, caller) => {
-			const c = requireCaller(caller);
+			const c = requireCaller$1(caller);
 			const parsed = NcRuleInputSchema.parse(input.rule);
 			await assertTargetsOwned(parsed.targets.map((t) => t.targetId), c);
 			const rule = await deps.ruleStore.create({
@@ -22486,7 +22550,7 @@ function makeNcActionHandlers(deps) {
 			return { rule };
 		},
 		"nc.updateRule": async (input, caller) => {
-			const c = requireCaller(caller);
+			const c = requireCaller$1(caller);
 			assertRuleEditable(input.ruleId, c);
 			const patch = NcRulePatchSchema.parse(input.patch);
 			if (patch.targets !== void 0) await assertTargetsOwned(patch.targets.map((t) => t.targetId), c);
@@ -22499,7 +22563,7 @@ function makeNcActionHandlers(deps) {
 			return { rule };
 		},
 		"nc.deleteRule": async (input, caller) => {
-			const c = requireCaller(caller);
+			const c = requireCaller$1(caller);
 			assertRuleEditable(input.ruleId, c);
 			await deps.ruleStore.delete(input.ruleId);
 			deps.logger.info("nc rule deleted", { meta: {
@@ -22509,11 +22573,11 @@ function makeNcActionHandlers(deps) {
 			return { success: true };
 		},
 		"nc.listSnoozes": async (_input, caller) => {
-			const c = requireCaller(caller);
+			const c = requireCaller$1(caller);
 			return { snoozes: [...deps.snooze.list(c.userId, c.isAdmin)] };
 		},
 		"nc.createSnooze": async (input, caller) => {
-			const c = requireCaller(caller);
+			const c = requireCaller$1(caller);
 			const parsed = NcSnoozeInputSchema.parse(input.snooze);
 			if (parsed.ruleId !== void 0) assertRuleVisible(parsed.ruleId, c);
 			const snooze = await deps.snooze.create(parsed, c);
@@ -22526,12 +22590,12 @@ function makeNcActionHandlers(deps) {
 			return { snooze };
 		},
 		"nc.cancelSnooze": async (input, caller) => {
-			const c = requireCaller(caller);
+			const c = requireCaller$1(caller);
 			await deps.snooze.cancel(input.snoozeId, c);
 			return { success: true };
 		},
 		"nc.injectTestEvent": async (input, caller) => {
-			const c = requireCaller(caller);
+			const c = requireCaller$1(caller);
 			if (!c.isAdmin) throw new Error("forbidden: admin required to inject a test event");
 			const inject = deps.injectTestEvent;
 			if (inject === void 0) throw new Error("this node does not host the notification centre — inject on the hub");
@@ -22547,7 +22611,7 @@ function makeNcActionHandlers(deps) {
 			return inject(parsed);
 		},
 		"nc.testRule": async (input, caller) => {
-			const c = requireCaller(caller);
+			const c = requireCaller$1(caller);
 			if (!c.isAdmin) throw new Error("forbidden: admin required to test a rule");
 			const inject = deps.injectTestEvent;
 			if (inject === void 0) throw new Error("this node does not host the notification centre — test on the hub");
@@ -22579,7 +22643,7 @@ function makeNcActionHandlers(deps) {
 			};
 		},
 		"nc.getRuleStatus": async (input, caller) => {
-			const c = requireCaller(caller);
+			const c = requireCaller$1(caller);
 			const status = deps.ruleStatus;
 			if (status === void 0) throw new Error("this node does not host the notification centre — ask the hub");
 			const detection = deps.ruleStore.get(input.ruleId);
@@ -22595,7 +22659,7 @@ function makeNcActionHandlers(deps) {
 			throw new Error(`rule not found: ${input.ruleId}`);
 		},
 		"nc.listTimelapseRules": async (_input, caller) => {
-			const c = requireCaller(caller);
+			const c = requireCaller$1(caller);
 			const tl = requireTimelapse();
 			return { rules: (c.isAdmin ? tl.store.list() : tl.store.listForOwner(c.userId)).map((r) => ({
 				...r,
@@ -22603,7 +22667,7 @@ function makeNcActionHandlers(deps) {
 			})) };
 		},
 		"nc.upsertTimelapseRule": async (input, caller) => {
-			const c = requireCaller(caller);
+			const c = requireCaller$1(caller);
 			const tl = requireTimelapse();
 			if (input.ruleId === void 0) {
 				if (input.rule === void 0) throw new Error("upsertTimelapseRule: rule or ruleId required");
@@ -22639,7 +22703,7 @@ function makeNcActionHandlers(deps) {
 			return { rule };
 		},
 		"nc.deleteTimelapseRule": async (input, caller) => {
-			const c = requireCaller(caller);
+			const c = requireCaller$1(caller);
 			const tl = requireTimelapse();
 			assertTimelapseEditable(input.ruleId, c, tl);
 			await tl.store.delete(input.ruleId);
@@ -22650,7 +22714,7 @@ function makeNcActionHandlers(deps) {
 			return { success: true };
 		},
 		"nc.testTimelapseRule": async (input, caller) => {
-			const c = requireCaller(caller);
+			const c = requireCaller$1(caller);
 			if (!c.isAdmin) throw new Error("forbidden: admin required to produce a test timelapse");
 			const tl = requireTimelapse();
 			deps.logger.info("timelapse test requested", {
@@ -22677,14 +22741,14 @@ function makeNcActionHandlers(deps) {
 			};
 		},
 		"nc.setRuleTargetEnabled": async (input, caller) => {
-			const c = requireCaller(caller);
+			const c = requireCaller$1(caller);
 			assertRuleVisible(input.ruleId, c);
 			await assertTargetsOwned([input.targetId], c);
 			await deps.ruleStore.setRuleTargetEnabled(input.ruleId, input.targetId, input.enabled);
 			return { success: true };
 		},
 		"nc.listSummaryRules": async (_input, caller) => {
-			const c = requireCaller(caller);
+			const c = requireCaller$1(caller);
 			const sum = requireSummary();
 			return { rules: (c.isAdmin ? sum.store.list() : sum.store.listForOwner(c.userId)).map((r) => ({
 				...r,
@@ -22692,7 +22756,7 @@ function makeNcActionHandlers(deps) {
 			})) };
 		},
 		"nc.upsertSummaryRule": async (input, caller) => {
-			const c = requireCaller(caller);
+			const c = requireCaller$1(caller);
 			if (!c.isAdmin) throw new Error("forbidden: admin required to author a summary rule");
 			const sum = requireSummary();
 			if (input.ruleId === void 0) {
@@ -22725,7 +22789,7 @@ function makeNcActionHandlers(deps) {
 			return { rule };
 		},
 		"nc.deleteSummaryRule": async (input, caller) => {
-			const c = requireCaller(caller);
+			const c = requireCaller$1(caller);
 			if (!c.isAdmin) throw new Error("forbidden: admin required to delete a summary rule");
 			await requireSummary().store.delete(input.ruleId);
 			deps.logger.info("summary rule deleted", { meta: {
@@ -22735,7 +22799,7 @@ function makeNcActionHandlers(deps) {
 			return { success: true };
 		},
 		"nc.testSummaryRule": async (input, caller) => {
-			const c = requireCaller(caller);
+			const c = requireCaller$1(caller);
 			if (!c.isAdmin) throw new Error("forbidden: admin required to produce a test summary");
 			const sum = requireSummary();
 			const startMs = input.windowStartMs;
@@ -22782,7 +22846,7 @@ function makeNcActionHandlers(deps) {
 		"nc.setLanguage": async (input) => requireTexts().setLanguage(input.language),
 		"nc.setTextOverrides": async (input) => requireTexts().setOverrides(input.language, input.overrides),
 		"nc.listArtifacts": async (input, caller) => {
-			const c = requireCaller(caller);
+			const c = requireCaller$1(caller);
 			const page = await requireArtifacts().list(input, {
 				userId: c.userId,
 				isAdmin: c.isAdmin
@@ -22794,7 +22858,7 @@ function makeNcActionHandlers(deps) {
 			};
 		},
 		"nc.getArtifact": async (input, caller) => {
-			const c = requireCaller(caller);
+			const c = requireCaller$1(caller);
 			return { artifact: await requireArtifacts().get(input.artifactId, {
 				userId: c.userId,
 				isAdmin: c.isAdmin
@@ -24443,11 +24507,11 @@ var WipeResultSchema = object({ deleted: number() });
 * and can never be called: the bridge insists on `{}` and the schema rejects
 * it. Verified on the live hub, both directions.
 */
-var NoInputSchema = object({});
+var NoInputSchema$1 = object({});
 var embeddingActions = defineCustomActions({
 	"embedding.rebuild": customAction(RebuildInputSchema, RebuildStartedSchema, { auth: "admin" }),
-	"embedding.rebuildStatus": customAction(NoInputSchema, RebuildStatusSchema),
-	"embedding.wipe": customAction(NoInputSchema, WipeResultSchema, { auth: "admin" })
+	"embedding.rebuildStatus": customAction(NoInputSchema$1, RebuildStatusSchema),
+	"embedding.wipe": customAction(NoInputSchema$1, WipeResultSchema, { auth: "admin" })
 });
 //#endregion
 //#region src/pipeline-analytics/map-with-concurrency.ts
@@ -28769,51 +28833,6 @@ var PlateGalleryProvider = class {
 		};
 	}
 };
-var OrphanAuditActionInputSchema = object({
-	mode: _enum(["report", "reclaim"]).default("report"),
-	/**
-	* Start every scope from the top instead of resuming its persisted cursor.
-	*
-	* What draining a backlog wants, and never the default — the cursor exists
-	* so a 6-hourly pass makes progress instead of re-walking the same head.
-	*/
-	restart: boolean().optional(),
-	/** Rows read per statement. Smaller = more yields = a gentler pass. */
-	pageSize: number().int().min(50).max(5e3).optional(),
-	/** Rows EXAMINED per collection in this pass — the pacing bound. */
-	maxRowsPerScope: number().int().min(1).max(2e5).optional(),
-	/** Rows DELETED per collection in this pass — the blast-radius bound. */
-	maxReclaimPerScope: number().int().min(1).max(1e5).optional(),
-	/**
-	* Minutes of immunity for a recent row. Protective ONLY — raising it can
-	* exclusively save rows, never select them, which is what keeps this off
-	* the one-age-keyed-sweep guard's books.
-	*/
-	graceMinutes: number().int().min(1).max(10080).optional()
-});
-var OrphanAuditScopeReportSchema = object({
-	collection: string(),
-	examined: number(),
-	orphans: number(),
-	reclaimed: number(),
-	bytesReclaimed: number(),
-	exempt: number(),
-	withinGrace: number(),
-	unresolvable: number(),
-	stoppedBy: string(),
-	/** Where the NEXT pass resumes. `0` = the scope was walked to the end. */
-	nextCursor: number()
-});
-var orphanAuditActions = defineCustomActions({ "retention.orphanAudit": customAction(OrphanAuditActionInputSchema, object({
-	/** `false` when a pass was already in flight — nothing was done. */
-	ran: boolean(),
-	mode: _enum(["report", "reclaim"]),
-	scopes: array(OrphanAuditScopeReportSchema),
-	totalOrphans: number(),
-	totalReclaimed: number(),
-	totalBytesReclaimed: number(),
-	durationMs: number()
-}), { auth: "admin" }) });
 //#endregion
 //#region src/pipeline-analytics/store/storage-pressure.ts
 /**
@@ -28981,6 +29000,11 @@ var FACE_MEDIA_OWNER_PREFIX = "face-";
 *  `plate-<trackId>`. Used by `deleteByTracks` to derive the plate crop owners
 *  of a set of tracks without a `trackId` column on media rows. */
 var PLATE_MEDIA_OWNER_PREFIX = "plate-";
+/** Index rows per page inside one presence chunk. Must stay under
+*  `SETTINGS_QUERY_DEFAULT_ROW_CAP` (2 000) so the engine's backstop can never
+*  silently truncate a page — an owner reported absent because a cap bit would
+*  DELETE a live thumbnail from the surface. */
+var MEDIA_PRESENCE_PAGE_SIZE = 1e3;
 /**
 * Kinds that hold exactly ONE row per `(ownerKind, ownerId)` — the current
 * "best"/rolling/first artefact, never a filmstrip. Their row id + blob path are
@@ -29408,6 +29432,59 @@ var MediaStore = class {
 		});
 	}
 	/**
+	* Which of `ownerIds` hold at least ONE media row — index only, no blob is
+	* opened, no base64 is allocated.
+	*
+	* This is the licence `videoclips` needs to publish a `thumbnail`. The
+	* event-media URL is stamped from a template for every event in the system,
+	* so "the plane is up" was being served as "there are bytes": 64 of one
+	* camera's 179 clips pointed at a 404 on 2026-08-17.
+	*
+	* Batched by `whereIn` and paged by offset. NOT `listInfoByOwner` in a loop:
+	* that is one query per owner, which is the N+1 this exists to prevent (and
+	* `queryObjectByTrackIds` already records what believing `whereIn` was
+	* unavailable cost the search path).
+	*
+	* `deviceId` is the AUTHORIZATION filter, exactly as in `listByOwner`.
+	*
+	* THROWS on a query failure rather than answering partially — a probe that
+	* quietly under-reports reads as "these owners have nothing", and the caller
+	* drops thumbnails that exist.
+	*/
+	async ownersWithMedia(ownerKind, ownerIds, deviceId) {
+		const found = /* @__PURE__ */ new Set();
+		const unique = [...new Set(ownerIds)];
+		for (let i = 0; i < unique.length; i += 200) {
+			const chunk = unique.slice(i, i + 200);
+			const answered = /* @__PURE__ */ new Set();
+			for (let offset = 0;; offset += MEDIA_PRESENCE_PAGE_SIZE) {
+				const rows = await this.store.query.query({
+					collection: MEDIA_COLLECTION,
+					filter: {
+						where: {
+							ownerKind,
+							deviceId
+						},
+						whereIn: { ownerId: chunk },
+						orderBy: {
+							field: "ownerId",
+							direction: "asc"
+						},
+						limit: MEDIA_PRESENCE_PAGE_SIZE,
+						offset
+					}
+				});
+				for (const row of rows) {
+					const ownerId = row.data["ownerId"];
+					if (typeof ownerId === "string") answered.add(ownerId);
+				}
+				if (rows.length < 1e3 || answered.size >= chunk.length) break;
+			}
+			for (const ownerId of answered) found.add(ownerId);
+		}
+		return found;
+	}
+	/**
 	* Delete all media (blobs + index rows) for the given owners of one kind.
 	* Best-effort per row; returns the number of index rows removed.
 	*/
@@ -29754,6 +29831,51 @@ async function reconcileDeviceFromDisk(deps, deviceId) {
 		events: doomedEvents.length
 	};
 }
+var OrphanAuditActionInputSchema = object({
+	mode: _enum(["report", "reclaim"]).default("report"),
+	/**
+	* Start every scope from the top instead of resuming its persisted cursor.
+	*
+	* What draining a backlog wants, and never the default — the cursor exists
+	* so a 6-hourly pass makes progress instead of re-walking the same head.
+	*/
+	restart: boolean().optional(),
+	/** Rows read per statement. Smaller = more yields = a gentler pass. */
+	pageSize: number().int().min(50).max(5e3).optional(),
+	/** Rows EXAMINED per collection in this pass — the pacing bound. */
+	maxRowsPerScope: number().int().min(1).max(2e5).optional(),
+	/** Rows DELETED per collection in this pass — the blast-radius bound. */
+	maxReclaimPerScope: number().int().min(1).max(1e5).optional(),
+	/**
+	* Minutes of immunity for a recent row. Protective ONLY — raising it can
+	* exclusively save rows, never select them, which is what keeps this off
+	* the one-age-keyed-sweep guard's books.
+	*/
+	graceMinutes: number().int().min(1).max(10080).optional()
+});
+var OrphanAuditScopeReportSchema = object({
+	collection: string(),
+	examined: number(),
+	orphans: number(),
+	reclaimed: number(),
+	bytesReclaimed: number(),
+	exempt: number(),
+	withinGrace: number(),
+	unresolvable: number(),
+	stoppedBy: string(),
+	/** Where the NEXT pass resumes. `0` = the scope was walked to the end. */
+	nextCursor: number()
+});
+var orphanAuditActions = defineCustomActions({ "retention.orphanAudit": customAction(OrphanAuditActionInputSchema, object({
+	/** `false` when a pass was already in flight — nothing was done. */
+	ran: boolean(),
+	mode: _enum(["report", "reclaim"]),
+	scopes: array(OrphanAuditScopeReportSchema),
+	totalOrphans: number(),
+	totalReclaimed: number(),
+	totalBytesReclaimed: number(),
+	durationMs: number()
+}), { auth: "admin" }) });
 //#endregion
 //#region src/pipeline-analytics/videoclip-visits.ts
 /**
@@ -29821,7 +29943,22 @@ function dominantKind(attached) {
 	for (const kind of KIND_ORDER) if (attached.some((a) => a.kind === kind)) return kind;
 	return "motion";
 }
-function visitsToClips(visits, events, pad) {
+/**
+* The instant a recorded still can actually be decoded inside a visit: the
+* midpoint of its LONGEST contiguous range.
+*
+* NOT the midpoint of the visit. A visit spans its holes by construction (it is
+* ranges glued across gaps up to `VISIT_MERGE_GAP_MS`), so the naive midpoint
+* lands in dead air roughly as often as not and the recorder's still route
+* answers 204 for a visit with plenty of footage.
+*/
+function stillInstantMs(ranges) {
+	let best;
+	for (const range of ranges) if (best === void 0 || range.endMs - range.startMs > best.endMs - best.startMs) best = range;
+	if (best === void 0) return void 0;
+	return Math.floor((best.startMs + best.endMs) / 2);
+}
+function visitsToClips(visits, events, pad, vouched) {
 	const tagged = [
 		...events.object.map((event) => ({
 			kind: "object",
@@ -29839,7 +29976,8 @@ function visitsToClips(visits, events, pad) {
 	return visits.map((visit) => {
 		const attached = tagged.filter((t) => eventOverlapsVisit(t.event, visit, pad));
 		const kind = dominantKind(attached);
-		const withThumb = attached.find((a) => a.kind === kind && a.event.mediaUrl) ?? attached.find((a) => a.event.mediaUrl);
+		const withThumb = attached.find((a) => a.kind === kind && a.event.mediaUrl && vouched.has(a.event.id)) ?? attached.find((a) => a.event.mediaUrl && vouched.has(a.event.id));
+		const stillAtMs = stillInstantMs(visit.ranges);
 		return {
 			id: `analytics:${visit.startMs}:${visit.endMs}:${VISIT_EVENT_ID}`,
 			source: "analytics",
@@ -29848,8 +29986,10 @@ function visitsToClips(visits, events, pad) {
 				startMs: visit.startMs,
 				endMs: visit.endMs
 			},
-			thumbnail: withThumb?.event.mediaUrl,
-			eventIds: attached.map((a) => a.event.id),
+			...withThumb?.event.mediaUrl !== void 0 ? { thumbnail: withThumb.event.mediaUrl } : {},
+			...stillAtMs !== void 0 ? { stillAtMs } : {},
+			eventIds: attached.slice(0, 24).map((a) => a.event.id),
+			eventCount: attached.length,
 			holes: [...visit.holes]
 		};
 	}).toSorted((a, b) => b.timeRange.startMs - a.timeRange.startMs);
@@ -29873,6 +30013,17 @@ function visitsToClips(visits, events, pad) {
 * injected fetch/resolve deps so the compose logic is testable without I/O.
 */
 var SOURCE = "analytics";
+/**
+* Backstop on the ANNOTATION read — never on the clip list.
+*
+* A visit is annotated by every event inside it, so the clip `limit` must not
+* reach this fetch (one 615 visit legitimately spans 2 345 motion rows). This
+* bound exists only so a pathological camera-day cannot pull an unbounded page:
+* the store orders `timestamp DESC`, so a truncation drops the OLDEST rows and
+* the EARLIEST visits silently lose their annotations — which is why hitting it
+* is logged, per camera, rather than absorbed.
+*/
+var VISIT_EVENT_FETCH_LIMIT = 5e3;
 function clipIdFor(eventId, startMs, endMs) {
 	return `${SOURCE}:${startMs}:${endMs}:${eventId}`;
 }
@@ -29893,7 +30044,7 @@ function parseClipId(clipId) {
 	};
 }
 /** Map per-kind events into time-ranged clips, newest-first. Pure. */
-function eventsToClips(events, pad) {
+function eventsToClips(events, pad, vouched) {
 	const make = (e, kind) => {
 		const startMs = e.timestamp - pad.preMs;
 		const endMs = e.timestamp + pad.postMs;
@@ -29905,7 +30056,7 @@ function eventsToClips(events, pad) {
 				startMs,
 				endMs
 			},
-			thumbnail: e.mediaUrl
+			...e.mediaUrl !== void 0 && vouched.has(e.id) ? { thumbnail: e.mediaUrl } : {}
 		};
 	};
 	return [
@@ -29914,29 +30065,106 @@ function eventsToClips(events, pad) {
 		...events.audio.map((e) => make(e, "audio"))
 	].toSorted((a, b) => b.timeRange.startMs - a.timeRange.startMs);
 }
+/** Every id in the three buckets, in the order the composers tag them. */
+function allEventIds(events) {
+	return [
+		...events.motion,
+		...events.object,
+		...events.audio
+	].map((e) => e.id);
+}
+/**
+* Resolve the event ids whose `mediaUrl` is backed by real bytes, mirroring
+* `resolveDefaultEventMedia`: the event's OWN media when it has any, else its
+* owning TRACK's. Two batched index reads at most, and the second only over the
+* object events the first did not already answer for — motion and audio are
+* trackless roots, so they never need it.
+*
+* THROWS on a failed read. The caller fails closed on the CLAIM and open on the
+* LIST; swallowing here would collapse those two opposite directions into one.
+*/
+async function resolveVouchedEvents(deviceId, events, fetchMediaOwners) {
+	const eventIds = allEventIds(events);
+	if (eventIds.length === 0) return /* @__PURE__ */ new Set();
+	const ownMedia = await fetchMediaOwners({
+		deviceId,
+		ownerKind: "event",
+		ownerIds: eventIds
+	});
+	const residualTracks = [];
+	const seenTracks = /* @__PURE__ */ new Set();
+	for (const event of events.object) {
+		const trackId = event.trackId;
+		if (trackId === void 0 || ownMedia.has(event.id) || seenTracks.has(trackId)) continue;
+		seenTracks.add(trackId);
+		residualTracks.push(trackId);
+	}
+	const trackMedia = residualTracks.length === 0 ? /* @__PURE__ */ new Set() : await fetchMediaOwners({
+		deviceId,
+		ownerKind: "track",
+		ownerIds: residualTracks
+	});
+	const vouched = new Set(ownMedia);
+	for (const event of events.object) {
+		const trackId = event.trackId;
+		if (trackId !== void 0 && trackMedia.has(trackId)) vouched.add(event.id);
+	}
+	return vouched;
+}
+/** Keep only clips that actually touch the caller's window. The reads are
+*  widened by {@link leftOverhangMs}; the ANSWER is not. */
+function intersectsWindow(clip, since, until) {
+	return clip.timeRange.startMs < until && clip.timeRange.endMs > since;
+}
+/**
+* How far BEFORE `since` the event + availability reads must reach.
+*
+* A visit straddling `since` keeps its heartbeat rows and loses the transition
+* row — the only one that ever carries a snapshot — so the same visit shows a
+* picture or doesn't depending on where the operator scrolled. One wider range
+* scan on an indexed column buys a list that stops changing under the cursor.
+*/
+function leftOverhangMs(pad) {
+	return VISIT_MERGE_GAP_MS + pad.preMs;
+}
 function createVideoclipsProvider(deps) {
 	return {
 		listClips: async ({ deviceId, since, until, limit }) => {
+			const readSince = since - leftOverhangMs(deps.defaultPad);
 			const events = await deps.fetchEvents({
 				deviceId,
-				since,
+				since: readSince,
 				until,
-				...deps.fetchAvailability ? {} : { limit }
+				limit: deps.fetchAvailability ? VISIT_EVENT_FETCH_LIMIT : limit
 			});
-			let clips = eventsToClips(events, deps.defaultPad);
+			warnOnTruncatedFetch(deps, deviceId, events);
+			let vouched = /* @__PURE__ */ new Set();
+			try {
+				vouched = await resolveVouchedEvents(deviceId, events, deps.fetchMediaOwners);
+			} catch (err) {
+				deps.logWarn?.("videoclips: media presence read failed — listing without thumbnails", {
+					deviceId,
+					events: allEventIds(events).length,
+					error: err instanceof Error ? err.message : String(err)
+				});
+			}
+			let clips = eventsToClips(events, deps.defaultPad, vouched);
 			if (deps.fetchAvailability) try {
 				clips = visitsToClips(clusterFootageVisits(await deps.fetchAvailability({
 					deviceId,
-					since,
+					since: readSince,
 					until
-				}), VISIT_MERGE_GAP_MS), events, deps.defaultPad);
+				}), VISIT_MERGE_GAP_MS), events, deps.defaultPad, vouched);
 			} catch (err) {
 				deps.logWarn?.("videoclips: availability read failed — listing unfiltered", {
 					deviceId,
 					error: err instanceof Error ? err.message : String(err)
 				});
 			}
-			return limit != null ? clips.slice(0, limit) : clips;
+			const inWindow = clips.filter((c) => intersectsWindow(c, since, until));
+			const answer = limit != null ? inWindow.slice(0, limit) : inWindow;
+			reportUnvouchedClips(deps, deviceId, answer);
+			return answer;
 		},
 		getClipPlayback: async ({ deviceId, clipId }) => {
 			const parsed = parseClipId(clipId);
@@ -29949,6 +30177,246 @@ function createVideoclipsProvider(deps) {
 		}
 	};
 }
+/** The annotation backstop biting is a SILENT loss of the earliest visits'
+*  events — say so, per camera, instead of shipping a thinner list. */
+function warnOnTruncatedFetch(deps, deviceId, events) {
+	if (!deps.fetchAvailability) return;
+	const truncated = [
+		"motion",
+		"object",
+		"audio"
+	].filter((kind) => events[kind].length >= VISIT_EVENT_FETCH_LIMIT);
+	if (truncated.length === 0) return;
+	deps.logWarn?.("videoclips: annotation fetch truncated — earliest visits lose their events", {
+		deviceId,
+		kinds: truncated,
+		limit: VISIT_EVENT_FETCH_LIMIT
+	});
+}
+/** The operator's acceptance criterion as a number: a rising count on one
+*  camera is its motion-snapshot capturer failing, not a quiet day. */
+function reportUnvouchedClips(deps, deviceId, clips) {
+	const clipsWithoutStill = clips.filter((c) => c.thumbnail === void 0).length;
+	if (clipsWithoutStill === 0) return;
+	deps.logInfo?.("videoclips: visit has no vouched still", {
+		deviceId,
+		clipsWithoutStill,
+		clips: clips.length
+	});
+}
+//#endregion
+//#region src/pipeline-analytics/viewer-settings-actions.ts
+/**
+* Viewer settings snapshots — hub-shared named blobs of the viewer's stores.
+*
+* Rides `addons.custom` (`viewerSettings.*`) so it ships with an addon deploy
+* and does not wait on a cap/codegen/server image. Ownership is the
+* authenticated caller (`caller: 'required'`); snapshots are visible to every
+* hub user, overwrite/delete only of one's own.
+*/
+/**
+* @durable class=config owner=pipeline-analytics
+*   write="a signed-in viewer user saves a named snapshot of their local stores"
+*   retention="none — a row goes only when its owner deletes it"
+*/
+var VIEWER_SETTINGS_SNAPSHOTS_COLLECTION = "viewer-settings-snapshots";
+var COLUMNS = [
+	{
+		name: "id",
+		type: "TEXT",
+		primaryKey: true,
+		notNull: true
+	},
+	{
+		name: "name",
+		type: "TEXT",
+		notNull: true
+	},
+	{
+		name: "ownerUserId",
+		type: "TEXT",
+		notNull: true
+	},
+	{
+		name: "ownerUsername",
+		type: "TEXT",
+		notNull: true
+	},
+	{
+		name: "createdAt",
+		type: "INTEGER",
+		notNull: true
+	},
+	{
+		name: "updatedAt",
+		type: "INTEGER",
+		notNull: true
+	},
+	{
+		name: "blob",
+		type: "JSON",
+		notNull: true
+	}
+];
+var NameSchema = string().trim().min(1).max(80);
+var BlobSchema = record(string(), unknown());
+var ViewerSettingsSnapshotSummarySchema = object({
+	id: string(),
+	name: string(),
+	ownerUserId: string(),
+	ownerUsername: string(),
+	createdAt: number().int(),
+	updatedAt: number().int(),
+	mine: boolean()
+});
+var ViewerSettingsSnapshotSchema = ViewerSettingsSnapshotSummarySchema.extend({ blob: BlobSchema });
+var viewerSettingsActions = defineCustomActions({
+	"viewerSettings.list": customAction(object({}), object({ snapshots: array(ViewerSettingsSnapshotSummarySchema) }), { caller: "required" }),
+	"viewerSettings.save": customAction(object({
+		name: NameSchema,
+		blob: BlobSchema,
+		ownerUsername: string().min(1).max(80)
+	}), object({ snapshot: ViewerSettingsSnapshotSummarySchema }), {
+		kind: "mutation",
+		caller: "required"
+	}),
+	"viewerSettings.get": customAction(object({ id: string().min(1) }), object({ snapshot: ViewerSettingsSnapshotSchema.nullable() }), { caller: "required" }),
+	"viewerSettings.delete": customAction(object({ id: string().min(1) }), object({ success: literal(true) }), {
+		kind: "mutation",
+		caller: "required"
+	})
+});
+function requireCaller(caller) {
+	if (!caller) throw new Error("viewerSettings: authenticated caller required");
+	return caller;
+}
+function asRecord(data) {
+	return typeof data === "object" && data !== null ? data : {};
+}
+function toSummary(id, data, callerUserId) {
+	const parsed = ViewerSettingsSnapshotSummarySchema.omit({ mine: true }).safeParse({
+		id,
+		name: data.name,
+		ownerUserId: data.ownerUserId,
+		ownerUsername: data.ownerUsername,
+		createdAt: data.createdAt,
+		updatedAt: data.updatedAt
+	});
+	if (!parsed.success) return null;
+	return {
+		...parsed.data,
+		mine: parsed.data.ownerUserId === callerUserId
+	};
+}
+var ViewerSettingsSnapshotStore = class {
+	store;
+	constructor(store) {
+		this.store = store;
+	}
+	static async declare(store) {
+		await store.declareCollection.mutate({
+			collection: VIEWER_SETTINGS_SNAPSHOTS_COLLECTION,
+			columns: [...COLUMNS],
+			indexes: [{
+				name: "idx_viewer_settings_owner",
+				columns: ["ownerUserId"]
+			}]
+		});
+	}
+	async list(caller) {
+		const rows = await this.store.query.query({
+			collection: VIEWER_SETTINGS_SNAPSHOTS_COLLECTION,
+			filter: {
+				orderBy: {
+					field: "updatedAt",
+					direction: "desc"
+				},
+				limit: 200
+			}
+		});
+		const out = [];
+		for (const row of rows) {
+			const summary = toSummary(row.id, asRecord(row.data), caller.userId);
+			if (summary) out.push(summary);
+		}
+		return out;
+	}
+	async get(id, caller) {
+		const row = (await this.store.query.query({
+			collection: VIEWER_SETTINGS_SNAPSHOTS_COLLECTION,
+			filter: {
+				where: { id },
+				limit: 1
+			}
+		}))[0];
+		if (!row) return null;
+		const data = asRecord(row.data);
+		const summary = toSummary(row.id, data, caller.userId);
+		if (!summary) return null;
+		const blob = BlobSchema.safeParse(data.blob);
+		if (!blob.success) return null;
+		return {
+			...summary,
+			blob: blob.data
+		};
+	}
+	async save(input, caller) {
+		const now = Date.now();
+		const prior = (await this.store.query.query({
+			collection: VIEWER_SETTINGS_SNAPSHOTS_COLLECTION,
+			filter: {
+				where: {
+					ownerUserId: caller.userId,
+					name: input.name
+				},
+				limit: 1
+			}
+		}))[0];
+		const id = prior?.id ?? randomUUID();
+		const createdAt = typeof asRecord(prior?.data).createdAt === "number" ? asRecord(prior?.data).createdAt : now;
+		await this.store.set.mutate({
+			collection: VIEWER_SETTINGS_SNAPSHOTS_COLLECTION,
+			key: id,
+			value: {
+				name: input.name,
+				ownerUserId: caller.userId,
+				ownerUsername: input.ownerUsername,
+				createdAt,
+				updatedAt: now,
+				blob: input.blob
+			}
+		});
+		return {
+			id,
+			name: input.name,
+			ownerUserId: caller.userId,
+			ownerUsername: input.ownerUsername,
+			createdAt,
+			updatedAt: now,
+			mine: true
+		};
+	}
+	async delete(id, caller) {
+		const row = await this.get(id, caller);
+		if (!row) throw new Error("viewerSettings: snapshot not found");
+		if (row.ownerUserId !== caller.userId && !caller.isAdmin) throw new Error("viewerSettings: only the owner can delete this snapshot");
+		await this.store.delete.mutate({
+			collection: VIEWER_SETTINGS_SNAPSHOTS_COLLECTION,
+			key: id
+		});
+	}
+};
+function makeViewerSettingsActionHandlers(store) {
+	return {
+		"viewerSettings.list": async (_input, caller) => ({ snapshots: await store.list(requireCaller(caller)) }),
+		"viewerSettings.save": async (input, caller) => ({ snapshot: await store.save(input, requireCaller(caller)) }),
+		"viewerSettings.get": async (input, caller) => ({ snapshot: await store.get(input.id, requireCaller(caller)) }),
+		"viewerSettings.delete": async (input, caller) => {
+			await store.delete(input.id, requireCaller(caller));
+			return { success: true };
+		}
+	};
+}
 /**
 * The VIDEO's playback rate — 4×, the same as {@link NC_GIF_SPEED}.
 *
@@ -30755,7 +31223,15 @@ var AudioDetectionSettingsSchema = object({
 	/** Flood ceiling: markers per camera per rolling 24 h. This, not the
 	*  thresholds, is what bounds the worst case — a mis-tuned threshold can
 	*  only ever cost the operator this many markers a day. */
-	audioMarkerMaxPerDay: number().int().positive().default(12)
+	audioMarkerMaxPerDay: number().int().positive().default(12),
+	/** Materialize one event + one synthetic track per classified episode. */
+	audioEpisodeEnabled: boolean().default(true),
+	/** Class must be heard continuously this long before the episode opens. */
+	audioEpisodeOpenHoldSec: number().nonnegative().default(1.5),
+	/** Class must be absent this long before the episode closes. */
+	audioEpisodeCloseGapSec: number().positive().default(12),
+	/** After close, the same class cannot reopen until this elapses. */
+	audioEpisodeCooldownSec: number().nonnegative().default(30)
 });
 var AUDIO_DETECTION_DEFAULTS = AudioDetectionSettingsSchema.parse({});
 /**
@@ -30779,6 +31255,159 @@ function resolveAudioDetectionSettings(raw) {
 	return resolved.success ? resolved.data : AUDIO_DETECTION_DEFAULTS;
 }
 //#endregion
+//#region src/pipeline-analytics/audio-episode-hysteresis.ts
+var EMPTY = {
+	pendingClass: null,
+	pendingSinceMs: 0,
+	openClass: null,
+	episodeId: null,
+	lastHeardMs: 0,
+	lastClosedClass: null,
+	lastClosedMs: 0
+};
+function emptyAudioEpisodeState() {
+	return EMPTY;
+}
+function episodeIdFor(className, timestampMs) {
+	return `${className}:${timestampMs}`;
+}
+function inCooldown(state, className, timestampMs, knobs) {
+	return state.lastClosedClass === className && timestampMs - state.lastClosedMs < knobs.cooldownMs;
+}
+function closedState(className, atMs) {
+	return {
+		...EMPTY,
+		lastClosedClass: className,
+		lastClosedMs: atMs
+	};
+}
+function observeAudioEpisode(state, sample, knobs) {
+	if (!knobs.enabled) return {
+		nextState: EMPTY,
+		action: { kind: "none" }
+	};
+	const { timestampMs, className } = sample;
+	const openClass = state.openClass;
+	const openId = state.episodeId;
+	if (openClass !== null && openId !== null) {
+		if (className === openClass) return {
+			nextState: {
+				...state,
+				pendingClass: null,
+				pendingSinceMs: 0,
+				lastHeardMs: timestampMs
+			},
+			action: {
+				kind: "hold",
+				className: openClass,
+				episodeId: openId
+			}
+		};
+		if (className === null) {
+			if (timestampMs - state.lastHeardMs < knobs.closeGapMs) return {
+				nextState: state,
+				action: { kind: "none" }
+			};
+			return {
+				nextState: closedState(openClass, timestampMs),
+				action: {
+					kind: "close",
+					className: openClass,
+					episodeId: openId
+				}
+			};
+		}
+		if (inCooldown(state, className, timestampMs, knobs)) return {
+			nextState: state,
+			action: { kind: "none" }
+		};
+		const pendingSince = state.pendingClass === className ? state.pendingSinceMs : timestampMs;
+		if (knobs.openHoldMs === 0 || state.pendingClass === className && timestampMs - pendingSince >= knobs.openHoldMs) {
+			const openedId = episodeIdFor(className, timestampMs);
+			return {
+				nextState: {
+					pendingClass: null,
+					pendingSinceMs: 0,
+					openClass: className,
+					episodeId: openedId,
+					lastHeardMs: timestampMs,
+					lastClosedClass: openClass,
+					lastClosedMs: timestampMs
+				},
+				action: {
+					kind: "replace",
+					closed: {
+						className: openClass,
+						episodeId: openId
+					},
+					opened: {
+						className,
+						episodeId: openedId
+					}
+				}
+			};
+		}
+		return {
+			nextState: {
+				...state,
+				pendingClass: className,
+				pendingSinceMs: pendingSince
+			},
+			action: { kind: "none" }
+		};
+	}
+	if (className === null) {
+		if (state.pendingClass === null) return {
+			nextState: state,
+			action: { kind: "none" }
+		};
+		return {
+			nextState: {
+				...state,
+				pendingClass: null,
+				pendingSinceMs: 0
+			},
+			action: { kind: "none" }
+		};
+	}
+	if (inCooldown(state, className, timestampMs, knobs)) return {
+		nextState: state,
+		action: { kind: "none" }
+	};
+	const pendingSince = state.pendingClass === className ? state.pendingSinceMs : timestampMs;
+	if (knobs.openHoldMs === 0 || state.pendingClass === className && timestampMs - pendingSince >= knobs.openHoldMs) {
+		const episodeId = episodeIdFor(className, timestampMs);
+		return {
+			nextState: {
+				pendingClass: null,
+				pendingSinceMs: 0,
+				openClass: className,
+				episodeId,
+				lastHeardMs: timestampMs,
+				lastClosedClass: state.lastClosedClass,
+				lastClosedMs: state.lastClosedMs
+			},
+			action: {
+				kind: "open",
+				className,
+				episodeId
+			}
+		};
+	}
+	if (state.pendingClass === className) return {
+		nextState: state,
+		action: { kind: "none" }
+	};
+	return {
+		nextState: {
+			...state,
+			pendingClass: className,
+			pendingSinceMs: timestampMs
+		},
+		action: { kind: "none" }
+	};
+}
+//#endregion
 //#region src/pipeline-analytics/audio-event-router.ts
 /**
 * Decide whether an audio frame is a (meaningful) classification event or a
@@ -46764,6 +47393,66 @@ var EventMediaDispatcher = class {
 		}
 	}
 };
+var SnapshotTimeoutError$1 = class extends Error {
+	constructor(ms) {
+		super(`snapshot cap timed out after ${ms}ms`);
+		this.name = "SnapshotTimeoutError";
+	}
+};
+function withTimeout$1(promise, ms) {
+	return new Promise((resolve, reject) => {
+		const timer = setTimeout(() => reject(new SnapshotTimeoutError$1(ms)), ms);
+		promise.then((value) => {
+			clearTimeout(timer);
+			resolve(value);
+		}, (err) => {
+			clearTimeout(timer);
+			reject(err instanceof Error ? err : new Error(String(err)));
+		});
+	});
+}
+var MotionEventSnapshotCapturer = class {
+	deps;
+	snapshotTimeoutMs;
+	constructor(deps) {
+		this.deps = deps;
+		this.snapshotTimeoutMs = deps.snapshotTimeoutMs ?? 2500;
+	}
+	/**
+	* Fetch a still and persist it as the motion event's snapshot. Never
+	* throws — the durable record is the motion row, already inserted by
+	* the caller.
+	*/
+	async capture(input) {
+		let snap;
+		try {
+			snap = await withTimeout$1(this.deps.snapshot.getSnapshot({ deviceId: input.deviceId }), this.snapshotTimeoutMs);
+		} catch (err) {
+			this.deps.onError?.(err instanceof SnapshotTimeoutError$1 ? "snapshotTimeout" : "snapshotFetch", err, input.deviceId);
+			return;
+		}
+		if (snap === null) return;
+		const raw = Buffer.from(snap.base64, "base64");
+		let data = raw;
+		try {
+			data = await downscaleFullFrameJpeg(raw, 960, 540);
+		} catch (err) {
+			this.deps.onError?.("downscaleSnapshot", err, input.deviceId);
+		}
+		try {
+			await this.deps.media.put({
+				deviceId: input.deviceId,
+				ownerKind: "event",
+				ownerId: input.eventId,
+				kind: "snapshot",
+				timestamp: input.timestamp,
+				data
+			});
+		} catch (err) {
+			this.deps.onError?.("snapshotMedia", err, input.deviceId);
+		}
+	}
+};
 /**
 * Project one `DeviceStateChanged` of a mapped sensor/control cap into a
 * synthetic track per camera the event belongs to. Returns the number of
@@ -46860,16 +47549,16 @@ var DEFAULT_DEBOUNCE_MS = 1e4;
 /** A hanging snapshot cap must not stall the sensor state-change path. */
 var DEFAULT_SNAPSHOT_TIMEOUT_MS = 1e4;
 /** Distinguishes a snapshot-cap timeout from a fetch failure for reporting. */
-var SnapshotTimeoutError$1 = class extends Error {
+var SnapshotTimeoutError = class extends Error {
 	constructor(ms) {
 		super(`snapshot cap timed out after ${ms}ms`);
 		this.name = "SnapshotTimeoutError";
 	}
 };
 /** Reject with `SnapshotTimeoutError` if `promise` doesn't settle within `ms`. */
-function withTimeout$1(promise, ms) {
+function withTimeout(promise, ms) {
 	return new Promise((resolve, reject) => {
-		const timer = setTimeout(() => reject(new SnapshotTimeoutError$1(ms)), ms);
+		const timer = setTimeout(() => reject(new SnapshotTimeoutError(ms)), ms);
 		promise.then((value) => {
 			clearTimeout(timer);
 			resolve(value);
@@ -46924,11 +47613,11 @@ var SyntheticTrackMaterializer = class {
 	*/
 	async fetchSnapshot(cameraId, timeoutMs) {
 		try {
-			const snap = await withTimeout$1(this.deps.snapshot.getSnapshot({ deviceId: cameraId }), timeoutMs);
+			const snap = await withTimeout(this.deps.snapshot.getSnapshot({ deviceId: cameraId }), timeoutMs);
 			if (snap === null) this.deps.onError?.("getSnapshot", /* @__PURE__ */ new Error("snapshot returned null"), cameraId);
 			return snap;
 		} catch (err) {
-			this.deps.onError?.(err instanceof SnapshotTimeoutError$1 ? "snapshotTimeout" : "snapshotMedia", err, cameraId);
+			this.deps.onError?.(err instanceof SnapshotTimeoutError ? "snapshotTimeout" : "snapshotMedia", err, cameraId);
 			return null;
 		}
 	}
@@ -46994,66 +47683,6 @@ var SyntheticTrackMaterializer = class {
 		return track;
 	}
 };
-var SnapshotTimeoutError = class extends Error {
-	constructor(ms) {
-		super(`snapshot cap timed out after ${ms}ms`);
-		this.name = "SnapshotTimeoutError";
-	}
-};
-function withTimeout(promise, ms) {
-	return new Promise((resolve, reject) => {
-		const timer = setTimeout(() => reject(new SnapshotTimeoutError(ms)), ms);
-		promise.then((value) => {
-			clearTimeout(timer);
-			resolve(value);
-		}, (err) => {
-			clearTimeout(timer);
-			reject(err instanceof Error ? err : new Error(String(err)));
-		});
-	});
-}
-var MotionEventSnapshotCapturer = class {
-	deps;
-	snapshotTimeoutMs;
-	constructor(deps) {
-		this.deps = deps;
-		this.snapshotTimeoutMs = deps.snapshotTimeoutMs ?? 2500;
-	}
-	/**
-	* Fetch a still and persist it as the motion event's snapshot. Never
-	* throws — the durable record is the motion row, already inserted by
-	* the caller.
-	*/
-	async capture(input) {
-		let snap;
-		try {
-			snap = await withTimeout(this.deps.snapshot.getSnapshot({ deviceId: input.deviceId }), this.snapshotTimeoutMs);
-		} catch (err) {
-			this.deps.onError?.(err instanceof SnapshotTimeoutError ? "snapshotTimeout" : "snapshotFetch", err, input.deviceId);
-			return;
-		}
-		if (snap === null) return;
-		const raw = Buffer.from(snap.base64, "base64");
-		let data = raw;
-		try {
-			data = await downscaleFullFrameJpeg(raw, 960, 540);
-		} catch (err) {
-			this.deps.onError?.("downscaleSnapshot", err, input.deviceId);
-		}
-		try {
-			await this.deps.media.put({
-				deviceId: input.deviceId,
-				ownerKind: "event",
-				ownerId: input.eventId,
-				kind: "snapshot",
-				timestamp: input.timestamp,
-				data
-			});
-		} catch (err) {
-			this.deps.onError?.("snapshotMedia", err, input.deviceId);
-		}
-	}
-};
 var TrackingSettingsSchema = object({
 	/**
 	* How much of a detection's box must lie inside a zone (0-1 fraction of the
@@ -48343,6 +48972,51 @@ function buildGlobalSettingsSchema() {
 				}
 			]
 		},
+		{
+			id: "audio-episodes",
+			title: "Audio episodes",
+			description: "One timeline track and one event per classified sound, held open with hysteresis so a long cry is not four tracks. No class filter: speech, crying, a bark — the knobs below are what stop repeats. Leave on for a day or two and judge the spam, then tighten per camera.",
+			columns: 2,
+			fields: [
+				{
+					type: "boolean",
+					key: "audioEpisodeEnabled",
+					label: "Create audio episodes",
+					description: "When off, classified audio still notifies from other paths but does not open a synthetic track or coalesce classification events.",
+					default: AUDIO_DETECTION_DEFAULTS.audioEpisodeEnabled
+				},
+				{
+					type: "number",
+					key: "audioEpisodeOpenHoldSec",
+					label: "Open hold",
+					description: "The class must be heard continuously this long before an episode opens. Filters 200 ms blips.",
+					min: 0,
+					step: .5,
+					default: AUDIO_DETECTION_DEFAULTS.audioEpisodeOpenHoldSec,
+					unit: "s"
+				},
+				{
+					type: "number",
+					key: "audioEpisodeCloseGapSec",
+					label: "Close gap",
+					description: "The class must be absent this long before the episode closes. A pause inside a cry does not start a second track.",
+					min: 1,
+					step: 1,
+					default: AUDIO_DETECTION_DEFAULTS.audioEpisodeCloseGapSec,
+					unit: "s"
+				},
+				{
+					type: "number",
+					key: "audioEpisodeCooldownSec",
+					label: "Cooldown",
+					description: "After an episode closes, the same class cannot reopen until this elapses.",
+					min: 0,
+					step: 5,
+					default: AUDIO_DETECTION_DEFAULTS.audioEpisodeCooldownSec,
+					unit: "s"
+				}
+			]
+		},
 		{
 			id: "face-recognition",
 			title: "Face recognition",
@@ -49828,7 +50502,8 @@ var customActions = {
 	...ncActions,
 	...embeddingActions,
 	...debugActions,
-	...orphanAuditActions
+	...orphanAuditActions,
+	...viewerSettingsActions
 };
 /**
 * Assist threshold when the caller does not pin one. Packages have their own
@@ -49930,7 +50605,12 @@ var LTS_FLUSH_INTERVAL_MS = 6e4;
 var OPS_LOG_RETENTION_MS = 720 * 60 * 6e4;
 /** Throttle for the "overlay synthesis failed" warn — one line / minute / device. */
 var OVERLAY_SYNTHESIS_WARN_THROTTLE_MS = 6e4;
-var AUDIO_EVENT_HEARTBEAT_MS = 5e3;
+/** 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. */
+var AUDIO_EPISODE_VISUAL_QUIET_MS = 2e3;
+/** Persist lastSeen on an open synthetic audio track at most this often. */
+var AUDIO_EPISODE_PERSIST_MS = 2e3;
 var MOTION_EVENT_HEARTBEAT_MS = 5e3;
 /**
 * Stored media kinds that carry NO drawn bounding box, in fallback preference
@@ -50402,6 +51082,11 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 	* fallible read on the decision path.
 	*/
 	lastTrackActivityMs = /* @__PURE__ */ new Map();
+	/** Per-device classified-audio episode hysteresis. */
+	audioEpisodeByDevice = /* @__PURE__ */ new Map();
+	/** Open synthetic tracks keyed by hysteresis episodeId. */
+	audioEpisodeTracks = /* @__PURE__ */ new Map();
+	audioEpisodeLastPersistMs = /* @__PURE__ */ new Map();
 	settingsCaches = new DeviceSettingsCacheHub();
 	/** Avoids a store read every ~30 Hz audio frame. */
 	audioSettingsCache = this.settingsCaches.registerDeviceCache("audio-detection", SETTINGS_CACHE_TTL_MS);
@@ -50685,6 +51370,7 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 	*  NAME — its scope list is derived from the classification registry, not
 	*  from a set of store instances. */
 	settingsStore = null;
+	viewerSettingsSnapshots = null;
 	/** Per-scope resume cursors, so a run interrupted by a restart costs one
 	*  page rather than a full rescan. In RAM: losing them costs a rescan, and
 	*  persisting them would be a durable record of a purely advisory position. */
@@ -50822,12 +51508,14 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 					...ncActions,
 					...embeddingActions,
 					...debugActions,
-					...orphanAuditActions
+					...orphanAuditActions,
+					...viewerSettingsActions
 				},
 				actionHandlers: {
 					...ncHandlers,
 					...this.buildEmbeddingActionHandlers(),
-					...this.buildDebugActionHandlers()
+					...this.buildDebugActionHandlers(),
+					...this.viewerSettingsSnapshots ? makeViewerSettingsActionHandlers(this.viewerSettingsSnapshots) : {}
 				}
 			} : {}
 		};
@@ -51002,8 +51690,10 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 			OpsLogStore.declare(api.settingsStore),
 			AnalyticsLts.declare(api.settingsStore),
 			SceneStore.declare(api.settingsStore),
-			NotificationCenter.declare(api.settingsStore)
+			NotificationCenter.declare(api.settingsStore),
+			ViewerSettingsSnapshotStore.declare(api.settingsStore)
 		]);
+		this.viewerSettingsSnapshots = new ViewerSettingsSnapshotStore(api.settingsStore);
 		runLabelTierMigration({
 			store: api.settingsStore,
 			logger: this.ctx.logger,
@@ -52263,6 +52953,11 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 		this.forgetDeviceProcessors(deviceId);
 		this.levelStateByDevice.delete(deviceId);
 		this.lastTrackActivityMs.delete(deviceId);
+		this.audioEpisodeByDevice.delete(deviceId);
+		for (const [episodeId, track] of this.audioEpisodeTracks) if (track.deviceId === deviceId) {
+			this.audioEpisodeTracks.delete(episodeId);
+			this.audioEpisodeLastPersistMs.delete(episodeId);
+		}
 		this.audioMarkers?.forgetDevice(deviceId);
 		this.settingsCaches.clearDevice(deviceId);
 		this.bindingCache?.invalidate(deviceId);
@@ -52527,6 +53222,9 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 					audio
 				};
 			},
+			fetchMediaOwners: async ({ deviceId, ownerKind, ownerIds }) => {
+				return stores.mediaStore.ownersWithMedia(ownerKind, ownerIds, deviceId);
+			},
 			fetchAvailability: async ({ deviceId, since, until }) => {
 				return (await api.recording.getAvailability.query({
 					deviceId,
@@ -52538,6 +53236,10 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 				tags: { deviceId: Number(meta["deviceId"]) },
 				meta
 			}),
+			logInfo: (message, meta) => this.ctx.logger.info(message, {
+				tags: { deviceId: Number(meta["deviceId"]) },
+				meta
+			}),
 			resolvePlayback: async ({ deviceId, startMs, endMs }) => {
 				const manifest = await api.recording.getPlaybackManifest.query({
 					deviceId,
@@ -54159,6 +54861,146 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 			maxPerDay: settings.audioMarkerMaxPerDay
 		};
 	}
+	audioEpisodeKnobs(settings) {
+		return {
+			enabled: settings.audioEpisodeEnabled,
+			openHoldMs: settings.audioEpisodeOpenHoldSec * 1e3,
+			closeGapMs: settings.audioEpisodeCloseGapSec * 1e3,
+			cooldownMs: settings.audioEpisodeCooldownSec * 1e3
+		};
+	}
+	hasLiveVisualTrack(deviceId, atMs) {
+		const at = this.lastTrackActivityMs.get(deviceId);
+		return at !== void 0 && atMs - at < AUDIO_EPISODE_VISUAL_QUIET_MS;
+	}
+	async driveAudioEpisode(input) {
+		const { nextState, action } = observeAudioEpisode(this.audioEpisodeByDevice.get(input.deviceId) ?? emptyAudioEpisodeState(), {
+			timestampMs: input.timestamp,
+			className: input.className
+		}, input.knobs);
+		this.audioEpisodeByDevice.set(input.deviceId, nextState);
+		switch (action.kind) {
+			case "none": return;
+			case "open":
+				await this.openAudioEpisode(input, action);
+				return;
+			case "hold":
+				await this.holdAudioEpisode(input, action);
+				return;
+			case "close":
+				await this.persistAudioEpisodeLastSeen(action, input.timestamp, true);
+				return;
+			case "replace":
+				await this.persistAudioEpisodeLastSeen(action.closed, input.timestamp, true);
+				await this.openAudioEpisode(input, action.opened);
+				return;
+		}
+	}
+	async openAudioEpisode(input, ref) {
+		const ev = {
+			id: randomUUID(),
+			deviceId: input.deviceId,
+			timestamp: input.timestamp,
+			kind: "audio",
+			rms: input.rms,
+			dbfs: input.dbfs,
+			classification: {
+				className: ref.className,
+				...input.originalClass !== void 0 ? { originalClass: input.originalClass } : {},
+				score: input.score
+			}
+		};
+		this.lastAudioInsertByDevice.set(input.deviceId, {
+			className: ref.className,
+			atMs: input.timestamp
+		});
+		await this.eventStore.insertAudio(ev);
+		this.notificationCenter?.onAudioEventPersisted(ev);
+		this.trackStore?.addAudioLabelEpisode(input.deviceId, ref.className, input.score, input.timestamp);
+		this.ctx.eventBus.emit({
+			id: `pa-${ev.id}`,
+			timestamp: new Date(ev.timestamp),
+			source: {
+				type: "addon",
+				id: "pipeline-analytics",
+				addonId: "pipeline-analytics"
+			},
+			category: EventCategory.PipelineAnalyticsDetectionEvent,
+			data: {
+				deviceId: input.deviceId,
+				kind: "audio",
+				eventId: ev.id,
+				timestamp: ev.timestamp
+			}
+		});
+		if (this.hasLiveVisualTrack(input.deviceId, input.timestamp)) return;
+		const materializer = this.syntheticTracks;
+		if (materializer === null) return;
+		try {
+			const track = await materializer.materialize({
+				cameraId: input.deviceId,
+				sourceDeviceId: input.deviceId,
+				source: "audio",
+				kind: ref.className,
+				timestamp: input.timestamp,
+				audioLabels: [{
+					label: ref.className,
+					peakScore: input.score,
+					count: 1,
+					firstAt: input.timestamp,
+					lastAt: input.timestamp
+				}]
+			});
+			if (track) {
+				this.audioEpisodeTracks.set(ref.episodeId, track);
+				this.audioEpisodeLastPersistMs.set(ref.episodeId, input.timestamp);
+			}
+		} catch (err) {
+			this.ctx.logger.warn("audio-episode synthetic track failed", {
+				tags: { deviceId: input.deviceId },
+				meta: {
+					className: ref.className,
+					error: errMsg(err)
+				}
+			});
+		}
+	}
+	async holdAudioEpisode(input, ref) {
+		await this.persistAudioEpisodeLastSeen(ref, input.timestamp, false);
+	}
+	async persistAudioEpisodeLastSeen(ref, timestamp, force) {
+		const track = this.audioEpisodeTracks.get(ref.episodeId);
+		if (!track) {
+			if (force) {
+				this.audioEpisodeTracks.delete(ref.episodeId);
+				this.audioEpisodeLastPersistMs.delete(ref.episodeId);
+			}
+			return;
+		}
+		const last = this.audioEpisodeLastPersistMs.get(ref.episodeId) ?? 0;
+		if (!force && timestamp - last < AUDIO_EPISODE_PERSIST_MS) return;
+		const updated = {
+			...track,
+			lastSeen: timestamp
+		};
+		this.audioEpisodeTracks.set(ref.episodeId, updated);
+		this.audioEpisodeLastPersistMs.set(ref.episodeId, timestamp);
+		try {
+			await this.trackStore?.persistSyntheticTrack(updated);
+		} catch (err) {
+			this.ctx.logger.warn("audio-episode lastSeen persist failed", {
+				tags: { deviceId: track.deviceId },
+				meta: {
+					episodeId: ref.episodeId,
+					error: errMsg(err)
+				}
+			});
+		}
+		if (force) {
+			this.audioEpisodeTracks.delete(ref.episodeId);
+			this.audioEpisodeLastPersistMs.delete(ref.episodeId);
+		}
+	}
 	async handleAudioResult(data) {
 		if (this.shuttingDown) return;
 		const { deviceId, frame } = data;
@@ -54202,48 +55044,27 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 				});
 				return;
 			}
-			const last = this.lastAudioInsertByDevice.get(deviceId);
-			const sameClass = last?.className === route.className;
-			const heartbeatDue = !last || timestamp - last.atMs >= AUDIO_EVENT_HEARTBEAT_MS;
-			if (sameClass && !heartbeatDue) return;
-			const ev = {
-				id: randomUUID(),
+			await this.driveAudioEpisode({
 				deviceId,
 				timestamp,
-				kind: "audio",
+				className: route.className,
+				score: topClassification.score,
+				originalClass: topClassification.debug?.originalClass,
 				rms: level?.rms ?? 0,
 				dbfs: level?.dbfs ?? 0,
-				classification: {
-					className: topClassification.macroClass,
-					...topClassification.debug?.originalClass !== void 0 ? { originalClass: topClassification.debug.originalClass } : {},
-					score: topClassification.score
-				}
-			};
-			this.lastAudioInsertByDevice.set(deviceId, {
-				className: route.className,
-				atMs: timestamp
-			});
-			await this.eventStore.insertAudio(ev);
-			this.notificationCenter?.onAudioEventPersisted(ev);
-			this.trackStore?.addAudioLabelEpisode(deviceId, route.className, topClassification.score, timestamp);
-			this.ctx.eventBus.emit({
-				id: `pa-${ev.id}`,
-				timestamp: new Date(ev.timestamp),
-				source: {
-					type: "addon",
-					id: "pipeline-analytics",
-					addonId: "pipeline-analytics"
-				},
-				category: EventCategory.PipelineAnalyticsDetectionEvent,
-				data: {
-					deviceId,
-					kind: "audio",
-					eventId: ev.id,
-					timestamp: ev.timestamp
-				}
+				knobs: this.audioEpisodeKnobs(settings)
 			});
 			return;
 		}
+		await this.driveAudioEpisode({
+			deviceId,
+			timestamp,
+			className: null,
+			score: 0,
+			rms: level?.rms ?? 0,
+			dbfs: level?.dbfs ?? 0,
+			knobs: this.audioEpisodeKnobs(settings)
+		});
 		const res = observeLevel(this.levelStateByDevice.get(deviceId) ?? emptyLevelState(), {
 			timestampMs: timestamp,
 			dbfs: level?.dbfs ?? -Infinity