@camstack/addon-post-analysis 1.2.316 → 1.2.319

package/dist/pipeline-analytics/index.mjs

@@ -1,4 +1,4 @@
-import { $ as NC_ALARM_SYSTEM_EVENT_KINDS, $n as notificationRulesCapability, $r as object, $t as SCENE_DEFAULT_UNCOVERED_POLICY, A as EMBEDDING_REQUIREMENTS_FAILED, Ar as canonicalHash, At as NcScheduleSchema, B as ListTrackRelationsInputSchema, Bn as isAudioClassName, Br as hydrateSchema, Bt as OPS_LOG_DEFAULT_LIMIT, C as DEFAULT_EVENT_COLOR, Cn as buildEventKindDescriptor, Cr as systemEventSummaryScheduleOf, Ct as NcConditionDescriptorSchema, D as DeclaredDevices, Dn as describeSystemEventDeliveryProblem, Dr as vectorDimFromBase64, Dt as NcRuleSchema, E as DETECTION_PIPELINE_CAP_NAME, En as deriveRecordingMode, Er as templateVarsFor, Et as NcRulePatchSchema, F as EXPORT_DENSE_MAX_RANGES, Fn as evictionPolicyOfLocation, Fr as BaseAddon, Ft as NcSystemEventKindSchema, G as MAX_BIRTH_LATENCY_PROXY_MS, Gn as isRetiredClearKey, Gr as ZodObject, Gt as RebuildObjectEmbeddingsRefusalSchema, H as LockStateSchema, Hn as isEventOwnerType, Hr as nodePin, I as FIRST_LEVEL_MACRO_CLASSES, In as faceGalleryCapability, Ir as CamProfileSchema, It as NcTaxonomySchema, J as MOTION_CLOSE_AFTER_MS, Jn as isSystemEventSummaryRule, Jr as boolean, Jt as SCENE_CONFIRM_DEFAULT_TIMEOUT_MS, K as MAX_TRACK_PURITIES, Kn as isScheduleActive, Kr as _enum, Kt as RetrainStatusSchema, L as FULL_IMAGE_BBOX, Ln as failureContributionCapability, Lr as createEvent, Lt as NcTemplatePreviewInputSchema, M as EVENT_DENSITY_BATCH_MAX, Mr as isSourceCap, Mt as NcSnoozeSchema, N as EVENT_KIND_BY_CAP, Nr as DeviceType, Nt as NcSnoozeSuppressedSchema, O as DetectionSourceSchema, On as describeSystemEventFamilyProblem, Or as zoneAnalyticsCapability, Ot as NcRuleTargetSchema, P as EVENT_OWNER_TYPES, Pn as encodeVectorBase64, Pr as errMsg, Pt as NcStateSummarySectionIdSchema, Q as NC_ALARM_DELAY_MAX_SEC, Qn as memoizePinnedFfmpeg, Qr as number, Qt as SCENE_DEFAULT_QUIET_SECONDS, R as FailureCounters, Rn as gifDeriveSpeed, Rr as customAction, Rt as NcTemplatePreviewSchema, S as CoverStateSchema, Sn as audioModeOf, Sr as systemEventFilterApplies, St as NcAlarmSettingsPatchSchema, T as DETECTION_MACRO_CLASSES, Tn as cosineSimilarity$1, Tr as templateCarriesSummary, Tt as NcRuleInputSchema, U as MAX_ARCHIVED_DEBUG_NOTES, Un as isKnownTemplateVar, Ut as RECORDING_EXPORT_MAX_READ_BYTES, V as ListTrackRelationsResultSchema, Vn as isDetectionMacroClass, Vr as isDeviceScopedCap, Vt as OpsLogEntrySchema, W as MAX_BIRTH_DECISION_RECORDS, Wn as isMediaOwnerType, Wr as sleep$1, Wt as RECORDING_SOURCE_CAMSTACK_ADDON, X as MotionTriggeredBySchema, Xn as kebabToCamel, Xr as literal, Xt as SCENE_DEFAULT_CHECK_INTERVAL_SEC, Y as MediaFileKindEnum, Yn as isVectorIndexDimConflict, Yr as discriminatedUnion, Yt as SCENE_DEFAULT_ANCHOR_THRESHOLD, Z as NC_ALARM_DELAY_FIELDS, Zn as mayWriteToLocation, Zr as looseObject, Zt as SCENE_DEFAULT_OBSERVATION_SPACING_SEC, _ as BaseDevice, _n as alarmPanelCapability, _r as servedTemplateVars, _t as NC_TAXONOMY, a as CLIP_EMBEDDING_STEP_ID, ai as tuple, an as SetTrackRelationInputSchema, ar as readMotionTriggeredBy, at as NC_CLIP_RETENTION_MAX_SEC, b as ClearTrackRelationInputSchema, bn as assertTimelapseCadences, br as systemEventDeliveryProblems, bt as NcAlarmSensorsInputSchema, c as resolveClusterModelPin, ci as EventCategory, cn as TimelapseRuleInputSchema, cr as resolveLocationMode, ct as NC_CONSUMABLE_SYSTEM_EVENT_KINDS, d as APPEARANCE_RESOLVES_AMBIGUITY_DEFAULT, dn as TrackPuritySchema, dr as ruleBelongsToAlarm$1, dt as NC_GROUPING_MAX_SEC, ei as partialRecord, en as SCENE_DIVERGED, er as occupancyScope, et as NC_ALARM_TRIGGERED_MAX_SEC, f as ARCHIVED_DEBUG_NOTES_DEFAULT_LIMIT, fn as TrackRelationKindSchema, fr as ruleDeviceCompatCapQueries, ft as NC_GROUPING_MIN_SEC, g as BIRTH_DECISION_DEFAULT_LIMIT, gn as addonWidgetsSourceCapability, gr as sensorRaisedOf, gt as NC_TANK_SYSTEM_EVENT_KINDS, h as ArchivedDebugNoteSchema, hn as TrackSourceSchema, hr as sceneMonitorCapability, ht as NC_SYSTEM_EVENT_KIND_GROUP_SPECS, ii as templateLiteral, in as SetTrackPurityResultSchema, ir as readDeviceStateFrom, it as NC_CLIP_PRE_ROLL_DEFAULT_SEC, j as EMBEDDING_REQUIREMENTS_UNAVAILABLE, jn as embeddingRefusalOf, jr as evaluateSensorEdge, jt as NcSnoozeInputSchema, k as EMBEDDING_MODEL_FAILED, kr as DEFAULT_FIRST_SIGHTING_FRESHNESS_MS, kt as NcRuleUpdateInputSchema, l as APPEARANCE_BIN_COUNT, ln as TimelapseRulePatchSchema, lr as resolveModeDelays, lt as NC_DEFAULT_SNOOZE_MINUTES, m as AlarmArmModeSchema, mn as TrackSideSchema, mr as ruleKindOf, mt as NC_SNOOZE_MAX_MINUTES, ni as strictObject, nn as SceneMonitorSchema, nr as pipelineAnalyticsCapability, nt as NC_AUDIO_CONFIRM_WINDOW_SEC_DEFAULT, o as FACE_EMBEDDING_STEP_ID, oi as union, on as TIMELAPSE_DENSE_FLOOR_SEC, or as readTimelapseGeneratedAt, ot as NC_CONDITION_CATALOG, p as AUDIO_MACRO_LABELS, pn as TrackRelationSchema, pr as ruleGroupingApplies, pt as NC_SENSOR_TRANSITION_KINDS, q as MAX_TRACK_RELATIONS, qn as isSystemDelivery, qr as array, qt as SCENE_CONFIRM_DEFAULT_MAX_IMAGE_PX, ri as string, rn as SetTrackPurityInputSchema, rr as plateGalleryCapability, rt as NC_CLIP_POST_ROLL_DEFAULT_SEC, s as readClusterModelPinStrict, si as unknown, sn as TRACK_RELATIONS_DEFAULT_LIMIT, sr as resolveClipSearchMinScore, st as NC_CONSUMABLE_LOW_PERCENT_DEFAULT, t as BUILTIN_CLIP_MODELS, ti as record, tn as SCENE_RESET_RECAPTURES, tt as NC_AUDIO_CONFIRM_HITS_DEFAULT, u as APPEARANCE_BLOCKS, un as TimelapseRuleSchema, ut as NC_GROUPING_DEFAULT_SEC, v as BirthDecisionRecordSchema, vn as applyModeDelaysEdits, vr as storageOccupancyCapability, vt as NC_TEMPLATE_VARS, w as DEFAULT_TIMELAPSE_PREVIEW_TEXT, wn as consumableLowPercentOf, wr as systemEventSummarySplitOf, wt as NcConditionsSchema, x as ClearTrackRelationResultSchema, xn as audioMetricsCapability, xr as systemEventFamilyProblems, xt as NcAlarmSensorsSchema, y as COCO_TO_MACRO, yn as applyNonBlockingEdit, yr as subKindsOf, yt as NcAlarmConfigSchema, z as LabelAttributionSchema, zn as gifFromMp4Args, zr as defineCustomActions, zt as NcTemplateVarDescriptorSchema } from "../clip-model-registry-Dkv8MUCO.mjs";
+import { $ as NC_ALARM_SYSTEM_EVENT_KINDS, $n as notificationRulesCapability, $r as object, $t as SCENE_DEFAULT_UNCOVERED_POLICY, A as EMBEDDING_REQUIREMENTS_FAILED, Ar as canonicalHash, At as NcScheduleSchema, B as ListTrackRelationsInputSchema, Bn as isAudioClassName, Br as hydrateSchema, Bt as OPS_LOG_DEFAULT_LIMIT, C as DEFAULT_EVENT_COLOR, Cn as buildEventKindDescriptor, Cr as systemEventSummaryScheduleOf, Ct as NcConditionDescriptorSchema, D as DeclaredDevices, Dn as describeSystemEventDeliveryProblem, Dr as vectorDimFromBase64, Dt as NcRuleSchema, E as DETECTION_PIPELINE_CAP_NAME, En as deriveRecordingMode, Er as templateVarsFor, Et as NcRulePatchSchema, F as EXPORT_DENSE_MAX_RANGES, Fn as evictionPolicyOfLocation, Fr as BaseAddon, Ft as NcSystemEventKindSchema, G as MAX_BIRTH_LATENCY_PROXY_MS, Gn as isRetiredClearKey, Gr as ZodObject, Gt as RebuildObjectEmbeddingsRefusalSchema, H as LockStateSchema, Hn as isEventOwnerType, Hr as nodePin, I as FIRST_LEVEL_MACRO_CLASSES, In as faceGalleryCapability, Ir as CamProfileSchema, It as NcTaxonomySchema, J as MOTION_CLOSE_AFTER_MS, Jn as isSystemEventSummaryRule, Jr as boolean, Jt as SCENE_CONFIRM_DEFAULT_TIMEOUT_MS, K as MAX_TRACK_PURITIES, Kn as isScheduleActive, Kr as _enum, Kt as RetrainStatusSchema, L as FULL_IMAGE_BBOX, Ln as failureContributionCapability, Lr as createEvent, Lt as NcTemplatePreviewInputSchema, M as EVENT_DENSITY_BATCH_MAX, Mr as isSourceCap, Mt as NcSnoozeSchema, N as EVENT_KIND_BY_CAP, Nr as DeviceType, Nt as NcSnoozeSuppressedSchema, O as DetectionSourceSchema, On as describeSystemEventFamilyProblem, Or as zoneAnalyticsCapability, Ot as NcRuleTargetSchema, P as EVENT_OWNER_TYPES, Pn as encodeVectorBase64, Pr as errMsg, Pt as NcStateSummarySectionIdSchema, Q as NC_ALARM_DELAY_MAX_SEC, Qn as memoizePinnedFfmpeg, Qr as number, Qt as SCENE_DEFAULT_QUIET_SECONDS, R as FailureCounters, Rn as gifDeriveSpeed, Rr as customAction, Rt as NcTemplatePreviewSchema, S as CoverStateSchema, Sn as audioModeOf, Sr as systemEventFilterApplies, St as NcAlarmSettingsPatchSchema, T as DETECTION_MACRO_CLASSES, Tn as cosineSimilarity$1, Tr as templateCarriesSummary, Tt as NcRuleInputSchema, U as MAX_ARCHIVED_DEBUG_NOTES, Un as isKnownTemplateVar, Ut as RECORDING_EXPORT_MAX_READ_BYTES, V as ListTrackRelationsResultSchema, Vn as isDetectionMacroClass, Vr as isDeviceScopedCap, Vt as OpsLogEntrySchema, W as MAX_BIRTH_DECISION_RECORDS, Wn as isMediaOwnerType, Wr as sleep$1, Wt as RECORDING_SOURCE_CAMSTACK_ADDON, X as MotionTriggeredBySchema, Xn as kebabToCamel, Xr as literal, Xt as SCENE_DEFAULT_CHECK_INTERVAL_SEC, Y as MediaFileKindEnum, Yn as isVectorIndexDimConflict, Yr as discriminatedUnion, Yt as SCENE_DEFAULT_ANCHOR_THRESHOLD, Z as NC_ALARM_DELAY_FIELDS, Zn as mayWriteToLocation, Zr as looseObject, Zt as SCENE_DEFAULT_OBSERVATION_SPACING_SEC, _ as BaseDevice, _n as alarmPanelCapability, _r as servedTemplateVars, _t as NC_TAXONOMY, a as CLIP_EMBEDDING_STEP_ID, ai as tuple, an as SetTrackRelationInputSchema, ar as readMotionTriggeredBy, at as NC_CLIP_RETENTION_MAX_SEC, b as ClearTrackRelationInputSchema, bn as assertTimelapseCadences, br as systemEventDeliveryProblems, bt as NcAlarmSensorsInputSchema, c as resolveClusterModelPin, ci as EventCategory, cn as TimelapseRuleInputSchema, cr as resolveLocationMode, ct as NC_CONSUMABLE_SYSTEM_EVENT_KINDS, d as APPEARANCE_RESOLVES_AMBIGUITY_DEFAULT, dn as TrackPuritySchema, dr as ruleBelongsToAlarm$1, dt as NC_GROUPING_MAX_SEC, ei as partialRecord, en as SCENE_DIVERGED, er as occupancyScope, et as NC_ALARM_TRIGGERED_MAX_SEC, f as ARCHIVED_DEBUG_NOTES_DEFAULT_LIMIT, fn as TrackRelationKindSchema, fr as ruleDeviceCompatCapQueries, ft as NC_GROUPING_MIN_SEC, g as BIRTH_DECISION_DEFAULT_LIMIT, gn as addonWidgetsSourceCapability, gr as sensorRaisedOf, gt as NC_TANK_SYSTEM_EVENT_KINDS, h as ArchivedDebugNoteSchema, hn as TrackSourceSchema, hr as sceneMonitorCapability, ht as NC_SYSTEM_EVENT_KIND_GROUP_SPECS, ii as templateLiteral, in as SetTrackPurityResultSchema, ir as readDeviceStateFrom, it as NC_CLIP_PRE_ROLL_DEFAULT_SEC, j as EMBEDDING_REQUIREMENTS_UNAVAILABLE, jn as embeddingRefusalOf, jr as evaluateSensorEdge, jt as NcSnoozeInputSchema, k as EMBEDDING_MODEL_FAILED, kr as DEFAULT_FIRST_SIGHTING_FRESHNESS_MS, kt as NcRuleUpdateInputSchema, l as APPEARANCE_BIN_COUNT, ln as TimelapseRulePatchSchema, lr as resolveModeDelays, lt as NC_DEFAULT_SNOOZE_MINUTES, m as AlarmArmModeSchema, mn as TrackSideSchema, mr as ruleKindOf, mt as NC_SNOOZE_MAX_MINUTES, ni as strictObject, nn as SceneMonitorSchema, nr as pipelineAnalyticsCapability, nt as NC_AUDIO_CONFIRM_WINDOW_SEC_DEFAULT, o as FACE_EMBEDDING_STEP_ID, oi as union, on as TIMELAPSE_DENSE_FLOOR_SEC, or as readTimelapseGeneratedAt, ot as NC_CONDITION_CATALOG, p as AUDIO_MACRO_LABELS, pn as TrackRelationSchema, pr as ruleGroupingApplies, pt as NC_SENSOR_TRANSITION_KINDS, q as MAX_TRACK_RELATIONS, qn as isSystemDelivery, qr as array, qt as SCENE_CONFIRM_DEFAULT_MAX_IMAGE_PX, ri as string, rn as SetTrackPurityInputSchema, rr as plateGalleryCapability, rt as NC_CLIP_POST_ROLL_DEFAULT_SEC, s as readClusterModelPinStrict, si as unknown, sn as TRACK_RELATIONS_DEFAULT_LIMIT, sr as resolveClipSearchMinScore, st as NC_CONSUMABLE_LOW_PERCENT_DEFAULT, t as BUILTIN_CLIP_MODELS, ti as record, tn as SCENE_RESET_RECAPTURES, tt as NC_AUDIO_CONFIRM_HITS_DEFAULT, u as APPEARANCE_BLOCKS, un as TimelapseRuleSchema, ut as NC_GROUPING_DEFAULT_SEC, v as BirthDecisionRecordSchema, vn as applyModeDelaysEdits, vr as storageOccupancyCapability, vt as NC_TEMPLATE_VARS, w as DEFAULT_TIMELAPSE_PREVIEW_TEXT, wn as consumableLowPercentOf, wr as systemEventSummarySplitOf, wt as NcConditionsSchema, x as ClearTrackRelationResultSchema, xn as audioMetricsCapability, xr as systemEventFamilyProblems, xt as NcAlarmSensorsSchema, y as COCO_TO_MACRO, yn as applyNonBlockingEdit, yr as subKindsOf, yt as NcAlarmConfigSchema, z as LabelAttributionSchema, zn as gifFromMp4Args, zr as defineCustomActions, zt as NcTemplateVarDescriptorSchema } from "../clip-model-registry-DSqobJfx.mjs";
 import { t as __exportAll } from "../embedding-encoder/index.mjs";
 import * as fs$1 from "node:fs";
 import { createWriteStream, promises } from "node:fs";
@@ -51320,6 +51320,11 @@ var MEDIA_ID_SEGMENT = "m";
 /** Path segment that introduces an OWNER question ("best media of"). */
 var MEDIA_OWNER_SEGMENT = "o";
 /**
+* Path segment that introduces an event-owner GENERATION (D694) —
+* `/g/<deviceId>/<recordAt>` after the owner id.
+*/
+var MEDIA_GENERATION_SEGMENT = "g";
+/**
 * The plane path for one media row.
 *
 * `prefix` is `/addon/<addonId>/event-media` — a pure function of the addon
@@ -51336,6 +51341,23 @@ function mediaFileUrl(prefix, mediaId) {
 	return `${prefix}/${MEDIA_ID_SEGMENT}/${mediaId}`;
 }
 /**
+* The plane path for "whatever media best represents this owner".
+*
+* The owner id IS encoded: a trackId is a UUID today but an owner id is an
+* arbitrary row key (the summary mosaic's is `summary-<ruleId>-<windowEndMs>`),
+* and one slash in it would silently re-cut the path.
+*
+* When `generation` is set and `ownerType` is an event table, the path carries
+* `/g/<deviceId>/<recordAt>` so a reused rowid cannot resolve another record's
+* crop. Generation is ignored (and not minted) for non-event owners — a track
+* id is random and needs none.
+*/
+function mediaOwnerUrl(prefix, ownerType, ownerId, generation) {
+	const base = `${prefix}/${MEDIA_OWNER_SEGMENT}/${ownerType}/${encodeURIComponent(ownerId)}`;
+	if (generation === void 0 || !isEventOwnerType(ownerType)) return base;
+	return `${base}/${MEDIA_GENERATION_SEGMENT}/${generation.deviceId}/${generation.recordAt}`;
+}
+/**
 * A stored row as the wire sees it: the ref, the address, and — transitionally
 * — the bytes.
 *
@@ -59186,6 +59208,12 @@ function openGzipStream(out) {
 		onceDrain: (listener) => {
 			gzip.once("drain", listener);
 		},
+		flush: () => new Promise((resolve, reject) => {
+			gzip.flush((err) => {
+				if (err !== null && err !== void 0) reject(err);
+				else resolve();
+			});
+		}),
 		finish: async () => {
 			gzip.end();
 			await closed;
@@ -59281,6 +59309,25 @@ var TapeSegmentWriter = class {
 		});
 	}
 	/**
+	* Push the sink's pending gzip output to disk without ending the segment.
+	* A quiet / silent camera otherwise keeps its tail only in the zlib
+	* buffer until the next rotation (D681 follow-up). Never throws into the
+	* caller's frame path: a flush fault is logged and swallowed here.
+	*/
+	async flushToDisk() {
+		try {
+			await this.deps.sink.flush();
+		} catch (err) {
+			this.deps.logger.warn("tracking tape segment flush failed", {
+				tags: { deviceId: this.deps.deviceId },
+				meta: {
+					segmentOriginMs: this.deps.segmentOriginMs,
+					error: errMsg(err)
+				}
+			});
+		}
+	}
+	/**
 	* Always ends the segment's records (queue flush, lost-span gap, `end`
 	* record) before touching the sink, so a sink that cannot finish still
 	* leaves a decodable body behind it. `sink.finish()`'s rejection is caught
@@ -59607,6 +59654,21 @@ var TapeRecorder = class {
 		if (cam !== void 0) await this.closeSegment(deviceId, cam, "segment-end");
 	}
 	/**
+	* Push every open segment's pending gzip output to disk without rotating
+	* (D681 follow-up). A silent / quiet camera otherwise keeps its tail only
+	* in the zlib buffer until the next frame or the 10-minute cut — a crash
+	* loses it, and `bytesLastHour` lags behind what was already recorded.
+	* Never throws: a per-camera flush fault is logged inside the writer.
+	*/
+	async flushOpenSegments() {
+		const pending = [];
+		for (const cam of this.cameras.values()) {
+			const writer = cam.segment?.writer;
+			if (writer !== void 0 && writer !== null) pending.push(writer.flushToDisk());
+		}
+		await Promise.all(pending);
+	}
+	/**
 	* Close the camera's open segment only if it holds time at or before
 	* `atMs` — what a promotion of a window ending at `atMs` needs on disk
 	* (Task 12 fix round, H1). A window wholly before the open segment leaves
@@ -60106,6 +60168,29 @@ var TapeShelf = class {
 		};
 	}
 };
+/**
+* Log every refusal the sweep already measured (D391 / D681 follow-up).
+* `sweep()` itself never throws for `rootUnreadable` / per-camera `failed`:
+* those land on the report, and a caller that only `.catch`es would drop them
+* silently even when the shelf already warned at the `readdir` site. One
+* tagged line per refusal at the sweep boundary closes that gap.
+*/
+function logTapeSweepReport(report, logger) {
+	if (report.rootUnreadable !== null) logger.warn("tracking tape sweep refused", { meta: {
+		reason: report.rootUnreadable,
+		scope: "root"
+	} });
+	for (const [deviceId, outcome] of report.perDevice) {
+		if (!("failed" in outcome) || outcome.failed !== true) continue;
+		logger.warn("tracking tape sweep refused", {
+			tags: { deviceId },
+			meta: {
+				reason: outcome.reason,
+				scope: "camera"
+			}
+		});
+	}
+}
 //#endregion
 //#region src/pipeline-analytics/tracking-bench/recorder/tape-operation-queue.ts
 /** Generous: a promotion reads its window's segments and walks back through
@@ -61159,6 +61244,17 @@ function shelfFigures(listing, now) {
 		...last !== void 0 ? { heldToMs: last.originMs } : {}
 	};
 }
+/**
+* Default `debug.tape.status` (no `deviceIds`): drop the noise. An Off camera
+* with a measured empty shelf is not a cost row and is not promotable; keep
+* everything else — Recording / Refused / Failing / Unknown, Off with held
+* segments (still promotable after the switch went off), and Off whose shelf
+* could not be read (D393: never silently hide an unreadable camera). Explicit
+* `deviceIds` still return every asked-about camera, Off included (D62).
+*/
+function defaultTapeStatusCameras(rows) {
+	return rows.filter((row) => row.state !== "off" || row.segmentsHeld === null || row.segmentsHeld > 0);
+}
 function describeTapeStatus(input) {
 	return input.deviceIds.map((deviceId) => {
 		const shelf = {
@@ -73017,7 +73113,7 @@ var AnalyticsQueryFacade = class {
 	async getMotionEvents(input) {
 		const events = await (this.deps.eventStore()?.queryMotion(input) ?? Promise.resolve([]));
 		if (input.projection !== "slim" || this.deps.eventMediaBaseUrl() === null) return events;
-		return this.withMediaUrl(events);
+		return this.withMediaUrl(events, "motion");
 	}
 	async getEventDensity(input) {
 		return this.deps.eventStore()?.densityByKind(input) ?? [];
@@ -73074,12 +73170,12 @@ var AnalyticsQueryFacade = class {
 	async getObjectEvents(input) {
 		const events = await (this.deps.eventStore()?.queryObject(input) ?? Promise.resolve([]));
 		if (input.projection !== "slim" || this.deps.eventMediaBaseUrl() === null) return events;
-		return this.withMediaUrl(events);
+		return this.withMediaUrl(events, "object");
 	}
 	async getAudioEvents(input) {
 		const events = await (this.deps.eventStore()?.queryAudio(input) ?? Promise.resolve([]));
 		if (input.projection !== "slim" || this.deps.eventMediaBaseUrl() === null) return events;
-		return this.withMediaUrl(events);
+		return this.withMediaUrl(events, "audio");
 	}
 	async getEventMedia(input) {
 		const store = this.deps.mediaStore();
@@ -73346,13 +73442,20 @@ var AnalyticsQueryFacade = class {
 	*
 	* Only called when `eventMediaBaseUrl()` is non-null (guard sits in
 	* the callers), so the template literal is safe.
+	*
+	* The URL names the owner TABLE and the event's GENERATION (D482 + D694):
+	* a bare `${base}/${id}` was both ambiguous across tables and unable to
+	* survive a reused rowid. New stamps always carry `/o/<type>/<id>/g/…`.
 	*/
-	withMediaUrl(events) {
+	withMediaUrl(events, ownerType) {
 		const base = this.deps.eventMediaBaseUrl();
 		if (base === null) return events;
 		return events.map((e) => ({
 			...e,
-			mediaUrl: `${base}/${e.id}`
+			mediaUrl: mediaOwnerUrl(base, ownerType, String(e.id), {
+				deviceId: e.deviceId,
+				recordAt: e.timestamp
+			})
 		}));
 	}
 };
@@ -76184,18 +76287,26 @@ function eventMediaEtag(media) {
 }
 /** Digits only — `Number('')` is 0 and `Number(' ')` is 0, so neither is used. */
 var DIGITS = /^\d+$/;
+/** One run of digits, for composing the event-owner remainder pattern. */
+var DIGIT_RUN = "\\d+";
+/**
+* Event-owner remainder with an optional generation suffix (D694):
+* `<ownerId>` or `<ownerId>/g/<deviceId>/<recordAt>`. Owner ids for event
+* tables are decimal rowids; the generation segment is the literal `g`.
+*/
+var EVENT_OWNER_REMAINDER = new RegExp(`^(${DIGIT_RUN})(?:/${MEDIA_GENERATION_SEGMENT}/(${DIGIT_RUN})/(${DIGIT_RUN}))?$`);
 /**
 * Read a plane path. `null` for anything that is not one of the two forms —
 * including the BARE id the plane used to accept, which is gone: a bare number
 * could be a media id or an event id, and after D474 an event id could be one
 * of three rows. Ambiguity at the door is what this record removes.
 *
-* The owner id is taken as the whole remainder rather than one segment: the
-* hub's wildcard param is percent-decoded by find-my-way before the sub-path
-* is proxied, so a `%2F` an owner id carried would arrive here as a real
-* slash, and re-cutting on it would silently address a different owner. It is
-* only ever a DB query VALUE (`where: { ownerId }`) — never a filesystem path,
-* which the row itself supplies.
+* For non-event owners the id is the whole remainder rather than one segment:
+* the hub's wildcard param is percent-decoded by find-my-way before the
+* sub-path is proxied, so a `%2F` an owner id carried would arrive here as a
+* real slash, and re-cutting on it would silently address a different owner.
+* Event owners (decimal rowids) may end with `/g/<deviceId>/<recordAt>` —
+* that suffix is the generation, not part of the id (D694).
 */
 function parseMediaAddress(rawPath) {
 	const path = rawPath.replace(/^\/+/, "");
@@ -76215,13 +76326,35 @@ function parseMediaAddress(rawPath) {
 	const typeSlash = rest.indexOf("/");
 	if (typeSlash <= 0) return null;
 	const ownerType = rest.slice(0, typeSlash);
-	const ownerId = rest.slice(typeSlash + 1);
-	if (ownerId.length === 0) return null;
+	const remainder = rest.slice(typeSlash + 1);
+	if (remainder.length === 0) return null;
 	if (!isMediaOwnerType(ownerType)) return null;
+	if (isEventOwnerType(ownerType)) {
+		const match = EVENT_OWNER_REMAINDER.exec(remainder);
+		if (match === null) return null;
+		const ownerId = match[1];
+		const deviceIdRaw = match[2];
+		const recordAtRaw = match[3];
+		if (ownerId === void 0) return null;
+		if (deviceIdRaw !== void 0 && recordAtRaw !== void 0) return {
+			kind: "owner",
+			ownerType,
+			ownerId,
+			generation: {
+				deviceId: Number(deviceIdRaw),
+				recordAt: Number(recordAtRaw)
+			}
+		};
+		return {
+			kind: "owner",
+			ownerType,
+			ownerId
+		};
+	}
 	return {
 		kind: "owner",
 		ownerType,
-		ownerId
+		ownerId: remainder
 	};
 }
 /** Set by the HUB for a `csv_*` share token admitted on this plane; never by a client. */
@@ -78898,6 +79031,218 @@ function createRetrainExportHandler(deps) {
 	};
 }
 //#endregion
+//#region src/pipeline-analytics/retrain/retrain-collection-store.ts
+/**
+* @durable class=ledger owner=pipeline-analytics
+*   write="one row per named training collection the operator creates. Names are
+*     unique on nameKey (lower(trim)); empty names never become rows."
+*   retention="none — operator-owned corpus metadata. Rows leave only when an
+*     explicit delete API lands (not V1)."
+*/
+var RETRAIN_COLLECTIONS_COLLECTION = "pipeline-analytics:retrain-collections";
+var RETRAIN_COLLECTION_COLUMNS = [
+	{
+		name: "id",
+		type: "TEXT",
+		primaryKey: true,
+		notNull: true
+	},
+	{
+		name: "name",
+		type: "TEXT",
+		notNull: true
+	},
+	{
+		name: "nameKey",
+		type: "TEXT",
+		notNull: true
+	},
+	{
+		name: "createdAt",
+		type: "INTEGER",
+		notNull: true
+	},
+	{
+		name: "updatedAt",
+		type: "INTEGER",
+		notNull: true
+	}
+];
+var RETRAIN_COLLECTION_INDEXES = [{
+	name: "idx_retrain_collections_name_key",
+	columns: ["nameKey"],
+	unique: true
+}, {
+	name: "idx_retrain_collections_created",
+	columns: ["createdAt"]
+}];
+function normalizeCollectionName(raw) {
+	const name = raw.trim();
+	if (name.length === 0) return null;
+	return {
+		name,
+		nameKey: name.toLowerCase()
+	};
+}
+var RetrainCollectionStore = class {
+	store;
+	logger;
+	now;
+	newId;
+	countFrames;
+	constructor(deps) {
+		this.store = deps.store;
+		this.logger = deps.logger;
+		this.now = deps.now;
+		this.newId = deps.newId;
+		this.countFrames = deps.countFrames;
+	}
+	static async declare(store) {
+		await store.declareCollection.mutate({
+			collection: RETRAIN_COLLECTIONS_COLLECTION,
+			columns: [...RETRAIN_COLLECTION_COLUMNS],
+			indexes: [...RETRAIN_COLLECTION_INDEXES]
+		});
+	}
+	async create(input) {
+		const normalized = normalizeCollectionName(input.name);
+		if (normalized === null) return {
+			kind: "refused",
+			reason: "empty-name"
+		};
+		if (await this.findByNameKey(normalized.nameKey) !== null) return {
+			kind: "refused",
+			reason: "duplicate-name"
+		};
+		const createdAt = this.now();
+		const id = this.newId();
+		await this.store.set.mutate({
+			collection: RETRAIN_COLLECTIONS_COLLECTION,
+			key: id,
+			value: {
+				name: normalized.name,
+				nameKey: normalized.nameKey,
+				createdAt,
+				updatedAt: createdAt
+			}
+		});
+		return {
+			kind: "created",
+			collection: {
+				id,
+				name: normalized.name,
+				createdAt,
+				frameCount: 0
+			}
+		};
+	}
+	async list() {
+		let rows;
+		try {
+			rows = await this.store.query.query({
+				collection: RETRAIN_COLLECTIONS_COLLECTION,
+				filter: { orderBy: {
+					field: "createdAt",
+					direction: "desc"
+				} }
+			});
+		} catch (err) {
+			this.logger.warn("retrain collections list failed", { meta: { error: String(err) } });
+			return [];
+		}
+		const out = [];
+		for (const row of rows) {
+			const name = typeof row.data["name"] === "string" ? row.data["name"] : "";
+			const createdAt = Number(row.data["createdAt"] ?? 0);
+			const frameCount = this.countFrames !== void 0 ? await this.countFrames(row.id) : 0;
+			out.push({
+				id: row.id,
+				name,
+				createdAt,
+				frameCount
+			});
+		}
+		return out;
+	}
+	async getById(id) {
+		try {
+			const row = await this.store.get.query({
+				collection: RETRAIN_COLLECTIONS_COLLECTION,
+				key: id
+			});
+			if (row === null || row === void 0) return null;
+			const data = row;
+			return {
+				id,
+				name: typeof data["name"] === "string" ? data["name"] : "",
+				createdAt: Number(data["createdAt"] ?? 0),
+				frameCount: this.countFrames !== void 0 ? await this.countFrames(id) : 0
+			};
+		} catch (err) {
+			this.logger.warn("retrain collection get failed", { meta: {
+				collectionId: id,
+				error: String(err)
+			} });
+			return null;
+		}
+	}
+	/**
+	* Stub until still ingest lands. Validates the collection exists, then
+	* refuses with a named reason so callers can wire UI against a stable shape.
+	*/
+	async addRetrainFrameFromRecording(input) {
+		if (await this.getById(input.collectionId) === null) {
+			this.logger.info("retrain collection addFrame refused: unknown-collection", {
+				tags: { deviceId: input.deviceId },
+				meta: {
+					collectionId: input.collectionId,
+					epochMs: input.epochMs
+				}
+			});
+			return {
+				kind: "refused",
+				reason: "unknown-collection"
+			};
+		}
+		this.logger.info("retrain collection addFrame stub: still-capture-unimplemented", {
+			tags: { deviceId: input.deviceId },
+			meta: {
+				collectionId: input.collectionId,
+				epochMs: input.epochMs
+			}
+		});
+		return {
+			kind: "refused",
+			reason: "still-capture-unimplemented",
+			detail: "Still ingest lands in plan Task 3"
+		};
+	}
+	async findByNameKey(nameKey) {
+		try {
+			const row = (await this.store.query.query({
+				collection: RETRAIN_COLLECTIONS_COLLECTION,
+				filter: {
+					where: { nameKey },
+					limit: 1
+				}
+			}))[0];
+			if (row === void 0) return null;
+			return {
+				id: row.id,
+				name: typeof row.data["name"] === "string" ? row.data["name"] : "",
+				createdAt: Number(row.data["createdAt"] ?? 0),
+				frameCount: 0
+			};
+		} catch (err) {
+			this.logger.warn("retrain collection findByNameKey failed", { meta: {
+				nameKey,
+				error: String(err)
+			} });
+			return null;
+		}
+	}
+};
+//#endregion
 //#region src/pipeline-analytics/retrain/retrain-assist.ts
 /** The whole frame, as a normalised rectangle. */
 var WHOLE_FRAME = {
@@ -82307,7 +82652,8 @@ async function rankKeyEvents(candidates, options, peakLookup) {
 			...t.markForTrain !== void 0 ? { markForTrain: t.markForTrain } : {},
 			...t.retrainStatus !== void 0 ? { retrainStatus: t.retrainStatus } : {},
 			...t.debug !== void 0 ? { debug: t.debug } : {},
-			...t.favourited !== void 0 ? { favourited: t.favourited } : {}
+			...t.favourited !== void 0 ? { favourited: t.favourited } : {},
+			...t.audioLabels !== void 0 && t.audioLabels.length > 0 ? { audioLabels: t.audioLabels } : {}
 		});
 	}
 	scored.sort((a, b) => b.importance - a.importance);
@@ -82734,16 +83080,19 @@ var MotionOnsetRegistry = class {
 *  - `resolveSearchThumbnailUrl` — the search-hit thumbnail resolver. It points
 *    a hit at the CLIP embedding row's OWN crop (the crop captured on the
 *    embedding's peak frame → the hit thumbnail IS the embedded crop), and only
-*    falls back to the representative event's crop when the embedding row has no
-*    crop yet, so a hit never renders blank.
+*    falls back to the representative event's owner ladder when the embedding
+*    row has no crop yet, so a hit never renders blank.
 */
 function isClipObjectEmbedding(t, registry = BUILTIN_CLIP_MODELS) {
 	return Array.isArray(t.embedding) && t.embedding.length > 0 && typeof t.embeddingModelId === "string" && registry.resolve(t.embeddingModelId) !== null;
 }
 function resolveSearchThumbnailUrl(input) {
 	if (input.baseUrl === null) return void 0;
-	const id = input.embeddingMediaKey ?? input.eventId;
-	return `${input.baseUrl}/${encodeURIComponent(id)}`;
+	if (input.embeddingMediaId !== void 0) return mediaFileUrl(input.baseUrl, input.embeddingMediaId);
+	return mediaOwnerUrl(input.baseUrl, "object", input.eventId, {
+		deviceId: input.deviceId,
+		recordAt: input.recordAt
+	});
 }
 //#endregion
 //#region src/pipeline-analytics/pipeline/onboard-birth-authority.ts
@@ -100903,7 +101252,10 @@ function ofGeneration(files, scope) {
 function makeNcOwnerMediaReader(deps) {
 	return async (ownerKind, ownerId, eventScope) => {
 		if (ownerKind === "track") return deps.media.listByOwner("track", await deps.resolveTrackOwnerId(ownerId));
-		if (eventScope === void 0) return deps.media.listByOwner("object", ownerId);
+		if (eventScope === void 0) {
+			deps.logger.error("object media read refused — NcEventMediaScope required", { meta: { ownerId } });
+			return [];
+		}
 		const onCamera = await deps.media.listByOwner("object", ownerId, eventScope.deviceId);
 		const kept = ofGeneration(onCamera, eventScope);
 		if (kept.length < onCamera.length) deps.logger.warn("event media of another record on a reused event id — not used", {
@@ -101996,6 +102348,10 @@ var NC_ARTIFACT_PRUNE_INTERVAL_MS = 36e5;
 *  (every camera switched off): the bound is 24 h, not "24 h after the next
 *  close" (D681). */
 var TAPE_SWEEP_INTERVAL_MS = 36e5;
+/** How often open tape segments push their pending gzip output to disk
+*  without rotating (D681 follow-up): a silent camera otherwise keeps its
+*  tail only in the zlib buffer until the next frame or the 10-minute cut. */
+var TAPE_FLUSH_INTERVAL_MS = 6e4;
 /** What a publish answers on a node whose artifact plane never came up: no
 *  link, no index row — and, exactly as before, bytes-only delivery. */
 var NO_PUBLICATION = {
@@ -102529,6 +102885,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 	ncArtifactReadDataPlane = null;
 	ncArtifactPruneTimer = null;
 	tapeSweepTimer = null;
+	tapeFlushTimer = null;
 	/** Why `startTrackingTapes` threw on a node that was allowed to record —
 	*  reported `failing` per switched-on camera, never as `recording`. */
 	tapeStartFailure = null;
@@ -104333,6 +104690,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 			StationaryObjectRegistry.declare(api.settingsStore),
 			RetrainFrameStore.declare(api.settingsStore),
 			RetrainAnnotationStore.declare(api.settingsStore),
+			RetrainCollectionStore.declare(api.settingsStore),
 			OpsLogStore.declare(api.settingsStore),
 			DebugNoteArchiveStore.declare(api.settingsStore),
 			TrackingTapeIndexStore.declare(api.settingsStore),
@@ -106781,6 +107139,10 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 			clearInterval(this.tapeSweepTimer);
 			this.tapeSweepTimer = null;
 		}
+		if (this.tapeFlushTimer !== null) {
+			clearInterval(this.tapeFlushTimer);
+			this.tapeFlushTimer = null;
+		}
 		if (this.ncArtifactPruneTimer !== null) {
 			clearInterval(this.ncArtifactPruneTimer);
 			this.ncArtifactPruneTimer = null;
@@ -113554,10 +113916,13 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 		});
 		const scored = [];
 		for (const { event, score } of bestEventByTrackId.values()) {
+			const embeddingMediaId = event.trackId !== void 0 ? embeddingMediaIdByTrackId.get(event.trackId) : void 0;
 			const mediaUrl = resolveSearchThumbnailUrl({
 				baseUrl: this.eventMediaBaseUrl,
 				eventId: String(event.id),
-				...event.trackId !== void 0 && embeddingMediaIdByTrackId.has(event.trackId) ? { embeddingMediaId: embeddingMediaIdByTrackId.get(event.trackId) } : {}
+				deviceId: event.deviceId,
+				recordAt: event.timestamp,
+				...embeddingMediaId !== void 0 ? { embeddingMediaId } : {}
 			});
 			const keyFrameMediaId = event.trackId !== void 0 ? keyFrameMediaIdByTrackId.get(event.trackId) : void 0;
 			scored.push({
@@ -113944,7 +114309,9 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 				logger
 			});
 			const sweep = (deviceId) => {
-				shelf.sweep().catch((err) => {
+				shelf.sweep().then((report) => {
+					logTapeSweepReport(report, logger);
+				}).catch((err) => {
 					logger.warn("tracking tape sweep failed", {
 						...deviceId !== null ? { tags: { deviceId } } : {},
 						meta: { error: errMsg(err) }
@@ -113976,6 +114343,10 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 			sweep(null);
 			this.tapeSweepTimer = setInterval(() => sweep(null), TAPE_SWEEP_INTERVAL_MS);
 			this.tapeSweepTimer.unref?.();
+			this.tapeFlushTimer = setInterval(() => {
+				this.tapeRecorder?.flushOpenSegments();
+			}, TAPE_FLUSH_INTERVAL_MS);
+			this.tapeFlushTimer.unref?.();
 			this.ctx.logger.info("tracking tapes ready", { meta: { seededProcessors: this.processorInputs.size } });
 		} catch (err) {
 			this.tapeStartFailure = errMsg(err);
@@ -114168,7 +114539,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 					segments.set(deviceId, await this.tapeListingOf(shelf, deviceId));
 				}
 				const recorder = this.tapeRecorder;
-				return { cameras: describeTapeStatus({
+				const cameras = describeTapeStatus({
 					deviceIds,
 					switchOn,
 					switchUnreadable,
@@ -114177,7 +114548,8 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 					startFailure: this.tapeStartFailure,
 					segments,
 					now: Date.now()
-				}) };
+				});
+				return { cameras: input.deviceIds === void 0 ? defaultTapeStatusCameras(cameras) : cameras };
 			},
 			"debug.tape.promote": async (input) => {
 				const deps = this.tapePromotionDeps();
@@ -114626,7 +114998,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 	* owner table, so the motion/object coin-flip is gone from here too.
 	*/
 	async readMediaByAddress(address, variant, preferKind) {
-		const base = address.kind === "row" ? await this.readMediaById(address.mediaId) : await this.readOwnerThumbnail(address.ownerType, address.ownerId, preferKind);
+		const base = address.kind === "row" ? await this.readMediaById(address.mediaId) : await this.readOwnerThumbnail(address.ownerType, address.ownerId, preferKind, address.generation);
 		if (base === null || variant === void 0) return base;
 		return this.applyThumbVariant(base, variant);
 	}
@@ -114684,7 +115056,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 	* ~144 MB and allocated ~190 MB of base64 to deliver ~1.2 MB, all of it on
 	* the single-threaded post-analysis runner.
 	*/
-	async readOwnerThumbnail(ownerType, rawOwnerId, preferKind) {
+	async readOwnerThumbnail(ownerType, rawOwnerId, preferKind, addressGeneration) {
 		const ownerId = ownerType === "track" ? await resolveMediaOwnerId(ownerType, rawOwnerId, (id) => this.trackAliasStore?.resolve(id) ?? Promise.resolve(null), (failure) => this.aliasResolveFailureLogger?.(failure), "readOwnerThumbnail") : rawOwnerId;
 		const listInfo = (ownerKind, id, deviceId) => this.mediaStore?.listInfoByOwner(ownerKind, id, deviceId) ?? Promise.resolve([]);
 		const getTrackIdForEvent = (eventId) => isEventOwnerType(ownerType) ? this.eventStore?.getTrackIdForEvent(eventId, ownerType) ?? Promise.resolve(null) : Promise.resolve(null);
@@ -114698,8 +115070,11 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 			};
 		};
 		let ownFiles = await listInfo(ownerType, ownerId);
-		if (isEventOwnerType(ownerType) && this.eventStore !== null) {
-			const gen = await this.eventStore.eventGenerationOf(ownerType, ownerId);
+		if (isEventOwnerType(ownerType)) {
+			const gen = addressGeneration !== void 0 ? {
+				deviceId: addressGeneration.deviceId,
+				timestamp: addressGeneration.recordAt
+			} : this.eventStore !== null ? await this.eventStore.eventGenerationOf(ownerType, ownerId) : null;
 			if (gen !== null) {
 				const onCamera = await listInfo(ownerType, ownerId, gen.deviceId);
 				const kept = onCamera.filter((f) => f.timestamp === gen.timestamp);
@@ -114711,7 +115086,8 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 						recordAt: gen.timestamp,
 						refused: onCamera.length - kept.length,
 						kept: kept.length,
-						via: "readOwnerThumbnail"
+						via: "readOwnerThumbnail",
+						scopedBy: addressGeneration !== void 0 ? "url" : "live-row"
 					}
 				});
 				ownFiles = kept;