@camstack/addon-post-analysis 1.2.116 → 1.2.118

package/dist/pipeline-analytics/index.js

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-C0uPGtBv.js");
+const require_dist = require("../dist-CO6pe7bi.js");
 let node_fs = require("node:fs");
 node_fs = require_dist.__toESM(node_fs, 1);
 let node_path = require("node:path");
@@ -15149,26 +15149,28 @@ function remainingSummaryCandidates(kept, taken, rank) {
 /**
 * The media a tile is drawn from, best first.
 *
-* For a group: `groupCrop` (union crop, the group's own blob) then
-* `nativeFrame` (pointer at the anchor's clean keyFrame). A digest of a
-* cohort may show the native still when the crop was not written; a
-* member's `keyFrame` listed as itself stays off this ladder so tracker
-* ID churn cannot refill a mosaic with eleven driveways. Boxed frames stay
-* absent: a drawn rectangle is a permanent lie in a digest tile.
+* First-level group crop only (`groupCrop`), then the group's native-frame
+* pointer, then a member's clean full frame. Member `thumbnail` / plate /
+* face crops stay off this ladder: a successful plate read overwrites the
+* vehicle first-level crop under the same `thumbnail` kind, and a digest
+* tile of a targa is the wrong picture. Boxed frames stay absent: a drawn
+* rectangle is a permanent lie in a digest tile. Duplicate driveways from
+* tracker ID churn are collapsed by `frameDedupeKey`, not by hiding the
+* full-frame fallback.
 */
 var SUMMARY_MEDIA_LADDER = [
 	"groupCrop",
 	"nativeFrame",
-	"thumbnail",
-	"thumbnailSmall",
-	"snapshot"
+	"keyFrame",
+	"keyFrameSmall",
+	"fullFrame"
 ];
 /**
 * Pick ONE media row for a track — the cheap question first (index rows only),
 * so exactly one blob is ever read.
 *
-* Within a rung the row CLOSEST to the track's peak is chosen; `snapshot` is a
-* filmstrip and its rows accumulate, so "the first one" would systematically
+* Within a rung the row CLOSEST to the track's peak is chosen; a member may
+* carry more than one full-frame still, so "the first one" would systematically
 * pick the moment the subject entered rather than the moment it was best seen.
 */
 function pickSummaryMedia(rows, aroundMs) {
@@ -25922,7 +25924,7 @@ var CLASS_RANK_VEHICLE = .8;
 var CLASS_RANK_ANIMAL = .5;
 var CLASS_RANK_DEFAULT = .25;
 var PERSON_CLASSES = new Set(["person", "face"]);
-var VEHICLE_CLASSES = new Set([
+var VEHICLE_CLASSES$1 = new Set([
 	"vehicle",
 	"car",
 	"truck",
@@ -25953,7 +25955,7 @@ function clamp01$1(x) {
 function classRank(className) {
 	const c = className.toLowerCase();
 	if (PERSON_CLASSES.has(c)) return 1;
-	if (VEHICLE_CLASSES.has(c)) return CLASS_RANK_VEHICLE;
+	if (VEHICLE_CLASSES$1.has(c)) return CLASS_RANK_VEHICLE;
 	if (ANIMAL_CLASSES.has(c)) return CLASS_RANK_ANIMAL;
 	return CLASS_RANK_DEFAULT;
 }
@@ -26556,7 +26558,7 @@ var FaceGalleryProvider = class {
 		const identities = await this.identityStore.listIdentities();
 		const nameMap = new Map(identities.map((i) => [i.id, i.name]));
 		const identityName = face.recognizedIdentityId ? nameMap.get(face.recognizedIdentityId) : void 0;
-		const base64 = await this.faceCropBase64(face);
+		const cropUrl = this.cropUrlFor(face);
 		return {
 			faceId: face.id,
 			deviceId: face.deviceId,
@@ -26565,7 +26567,7 @@ var FaceGalleryProvider = class {
 			...face.recognizedIdentityId != null ? { recognizedIdentityId: face.recognizedIdentityId } : {},
 			...identityName !== void 0 ? { identityName } : {},
 			assigned: face.assigned,
-			...base64 !== void 0 ? { base64 } : {},
+			...cropUrl !== void 0 ? { cropUrl } : {},
 			...face.faceBbox !== void 0 ? { faceBbox: face.faceBbox } : {},
 			...face.keyFrameMediaKey !== void 0 ? { keyFrameMediaKey: face.keyFrameMediaKey } : {},
 			...face.bestMatchScore != null ? { bestMatchScore: face.bestMatchScore } : {},
@@ -29685,9 +29687,15 @@ var TrackCloser = class {
 			await this.suppressZeroMedia(t.deviceId, t.trackId);
 			return;
 		}
-		if (outcome === "raster-fallback" && closure?.rasterFallback) await this.commitRasterFallback(t, closure.rasterFallback.jpeg, closure.rasterFallback.timestamp);
+		let thumbnailLanded = ownedMedia.some((m) => m.kind === "thumbnail");
+		if (outcome === "raster-fallback" && closure?.rasterFallback) {
+			await this.commitRasterFallback(t, closure.rasterFallback.jpeg, closure.rasterFallback.timestamp);
+			thumbnailLanded = true;
+		}
 		await this.maybePromoteLastFrame(t, ownedMedia);
-		await this.maybeDeriveThumbnailFromKeyFrame(t, ownedMedia);
+		const hasRasterFallback = closure?.rasterFallback !== void 0;
+		if (!thumbnailLanded) thumbnailLanded = await this.maybeDeriveThumbnailFromKeyFrame(t, ownedMedia, hasRasterFallback);
+		if (!thumbnailLanded && closure?.rasterFallback) await this.commitRasterFallback(t, closure.rasterFallback.jpeg, closure.rasterFallback.timestamp);
 		this.deps.logger.info("track ended", {
 			tags: { deviceId: t.deviceId },
 			meta: {
@@ -29805,14 +29813,23 @@ var TrackCloser = class {
 	* and the rate could only ever be counted from the database, after the fact.
 	* A branch that drops work silently reads as "never happened".
 	*/
-	async maybeDeriveThumbnailFromKeyFrame(t, ownedMedia) {
-		if (ownedMedia.some((m) => m.kind === "thumbnail")) return;
+	async maybeDeriveThumbnailFromKeyFrame(t, ownedMedia, hasRasterFallback) {
+		if (ownedMedia.some((m) => m.kind === "thumbnail")) return true;
 		const derive = this.deps.deriveThumbnailFromKeyFrame;
-		if (!derive) return this.logNoThumbnailAtClose(t, "derive-not-wired");
+		if (!derive) {
+			if (!hasRasterFallback) this.logNoThumbnailAtClose(t, "derive-not-wired");
+			return false;
+		}
 		const keyFrame = ownedMedia.find((m) => m.kind === "keyFrame");
-		if (!keyFrame) return this.logNoThumbnailAtClose(t, "no-key-frame");
+		if (!keyFrame) {
+			if (!hasRasterFallback) this.logNoThumbnailAtClose(t, "no-key-frame");
+			return false;
+		}
 		const bestSeen = this.deps.residents.bestSeenBbox(t.trackId);
-		if (!bestSeen) return this.logNoThumbnailAtClose(t, "no-best-seen-bbox");
+		if (!bestSeen) {
+			if (!hasRasterFallback) this.logNoThumbnailAtClose(t, "no-best-seen-bbox");
+			return false;
+		}
 		try {
 			const derived = await derive({
 				mediaKey: keyFrame.key,
@@ -29824,17 +29841,23 @@ var TrackCloser = class {
 				},
 				frameWidth: bestSeen.frameWidth,
 				frameHeight: bestSeen.frameHeight,
-				timestamp: bestSeen.timestamp
+				timestamp: keyFrame.timestamp
 			});
-			if (!derived) return this.logNoThumbnailAtClose(t, "derive-returned-null", { keyFrameKey: keyFrame.key });
+			if (!derived) {
+				if (!hasRasterFallback) this.logNoThumbnailAtClose(t, "derive-returned-null", { keyFrameKey: keyFrame.key });
+				return false;
+			}
 			const mediaStore = this.deps.mediaStore();
-			if (!mediaStore) return this.logNoThumbnailAtClose(t, "no-media-store");
+			if (!mediaStore) {
+				if (!hasRasterFallback) this.logNoThumbnailAtClose(t, "no-media-store");
+				return false;
+			}
 			await mediaStore.put({
 				deviceId: t.deviceId,
 				ownerKind: "track",
 				ownerId: t.trackId,
 				kind: "thumbnail",
-				timestamp: bestSeen.timestamp,
+				timestamp: keyFrame.timestamp,
 				data: derived.thumbnail
 			});
 			await mediaStore.put({
@@ -29842,7 +29865,7 @@ var TrackCloser = class {
 				ownerKind: "track",
 				ownerId: t.trackId,
 				kind: "thumbnailSmall",
-				timestamp: bestSeen.timestamp,
+				timestamp: keyFrame.timestamp,
 				data: derived.thumbnailSmall
 			});
 			this.deps.logger.info("thumbnail derived from keyFrame at close (no live best-shot landed)", {
@@ -29853,6 +29876,7 @@ var TrackCloser = class {
 					skewMs: derived.skewMs
 				}
 			});
+			return true;
 		} catch (err) {
 			this.deps.logger.debug("close-time keyFrame thumbnail derive failed", {
 				tags: { deviceId: t.deviceId },
@@ -29861,10 +29885,11 @@ var TrackCloser = class {
 					error: String(err)
 				}
 			});
-			this.logNoThumbnailAtClose(t, "derive-threw", {
+			if (!hasRasterFallback) this.logNoThumbnailAtClose(t, "derive-threw", {
 				keyFrameKey: keyFrame.key,
 				error: String(err)
 			});
+			return false;
 		}
 	}
 	/**
@@ -30734,6 +30759,7 @@ var PlateGalleryProvider = class {
 	logger;
 	refreshGallery;
 	emitPlateGalleryChanged;
+	eventMediaBaseUrl;
 	constructor(deps) {
 		this.plateStore = deps.plateStore;
 		this.vehicleStore = deps.vehicleStore;
@@ -30743,6 +30769,7 @@ var PlateGalleryProvider = class {
 		this.logger = deps.logger;
 		this.refreshGallery = deps.refreshGallery;
 		this.emitPlateGalleryChanged = deps.emitPlateGalleryChanged;
+		this.eventMediaBaseUrl = deps.eventMediaBaseUrl;
 	}
 	/** Best-effort emit — never allowed to fail the mutation it follows. */
 	safeEmitPlateGalleryChanged(payload) {
@@ -30750,6 +30777,12 @@ var PlateGalleryProvider = class {
 			this.emitPlateGalleryChanged(payload);
 		} catch {}
 	}
+	cropUrlFor(plate) {
+		if (plate.mediaKey === void 0 || plate.mediaKey === "") return void 0;
+		const base = this.eventMediaBaseUrl();
+		if (base === null) return void 0;
+		return `${base}/${encodeURIComponent(plate.mediaKey)}`;
+	}
 	async plateCropBase64(plate) {
 		if (plate.mediaKey) {
 			const m = await this.mediaStore.getByKey(plate.mediaKey);
@@ -30758,8 +30791,9 @@ var PlateGalleryProvider = class {
 		const media = await this.mediaStore.listByOwner("plate", plate.id);
 		return media.length > 0 ? media[0].base64 : void 0;
 	}
-	async toPlateInfo(plate, nameMap) {
-		const base64 = await this.plateCropBase64(plate);
+	async toPlateInfo(plate, nameMap, opts) {
+		const base64 = opts?.includeCrops ?? true ? await this.plateCropBase64(plate) : void 0;
+		const cropUrl = this.cropUrlFor(plate);
 		const vehicleName = plate.recognizedVehicleId != null ? nameMap?.get(plate.recognizedVehicleId) : void 0;
 		return {
 			plateId: plate.id,
@@ -30774,7 +30808,8 @@ var PlateGalleryProvider = class {
 			...vehicleName !== void 0 ? { vehicleName } : {},
 			...plate.plateBbox !== void 0 ? { plateBbox: plate.plateBbox } : {},
 			...plate.keyFrameMediaKey !== void 0 ? { keyFrameMediaKey: plate.keyFrameMediaKey } : {},
-			...base64 !== void 0 ? { base64 } : {}
+			...base64 !== void 0 ? { base64 } : {},
+			...cropUrl !== void 0 ? { cropUrl } : {}
 		};
 	}
 	async vehicleNameMap() {
@@ -30793,7 +30828,7 @@ var PlateGalleryProvider = class {
 		const plate = await this.plateStore.get(`plate-${input.trackId}`);
 		if (!plate || plate.deviceId !== input.deviceId) return null;
 		const nameMap = await this.vehicleNameMap();
-		return this.toPlateInfo(plate, nameMap);
+		return this.toPlateInfo(plate, nameMap, { includeCrops: false });
 	}
 	async getPlateMedia(input) {
 		return (await this.mediaStore.listByOwner("plate", input.plateId)).map((m) => ({
@@ -35934,6 +35969,19 @@ function createEventMediaHandler(deps) {
 	};
 }
 //#endregion
+//#region src/pipeline-analytics/copy-face-crop-preview.ts
+var TRACK_PREVIEW_KINDS = new Set(["thumbnail", "thumbnailSmall"]);
+async function copyFaceCropIfTrackHasNoThumbnail(store, input) {
+	if ((await store.listTrackMedia(input.trackId)).some((m) => TRACK_PREVIEW_KINDS.has(m.kind))) return false;
+	await store.putTrackThumbnail({
+		deviceId: input.deviceId,
+		trackId: input.trackId,
+		timestamp: input.timestamp,
+		data: input.crop
+	});
+	return true;
+}
+//#endregion
 //#region src/pipeline-analytics/event-thumbnail-resolver.ts
 /** Pick an event-OWNED media blob: the tight `crop`, else the native-res boxed
 *  `fullFrameBoxed`, else any available file. Both preferred kinds are RETIRED
@@ -35942,29 +35990,47 @@ function createEventMediaHandler(deps) {
 function pickEventOwnedMedia(files) {
 	return files.find((f) => f.kind === "crop") ?? files.find((f) => f.kind === "fullFrameBoxed") ?? files[0];
 }
-/** Pick a track's fallback media in the shared cadence-preference order the
-*  KeyEvent path uses: `thumbnailSmall` (480 fast-load) → best `thumbnail` →
-*  rolling `lastFrame` → `firstFrame` → newest `snapshot` → any track blob.
-*  Undefined when the track owns no media. */
+/** Pick a track's fallback media when no subject crop exists: `thumbnailSmall`
+*  → `thumbnail` → native `keyFrameSmall`/`keyFrame`/`fullFrame` → rolling
+*  `lastFrame` → `firstFrame` → newest `snapshot` → any blob. A full frame
+*  beats a class icon. Undefined when the owner has no media. */
 function pickTrackFallbackMedia(files) {
-	return files.find((f) => f.kind === "thumbnailSmall") ?? files.find((f) => f.kind === "thumbnail") ?? files.find((f) => f.kind === "lastFrame") ?? files.find((f) => f.kind === "firstFrame") ?? [...files].reverse().find((f) => f.kind === "snapshot") ?? files[files.length - 1];
+	return files.find((f) => f.kind === "thumbnailSmall") ?? files.find((f) => f.kind === "thumbnail") ?? files.find((f) => f.kind === "keyFrameSmall") ?? files.find((f) => f.kind === "keyFrame") ?? files.find((f) => f.kind === "fullFrame") ?? files.find((f) => f.kind === "lastFrame") ?? files.find((f) => f.kind === "firstFrame") ?? [...files].reverse().find((f) => f.kind === "snapshot") ?? files[files.length - 1];
 }
 /**
-* Crop-forced resolution (the `?kind=crop` reel/timeline path). Prefer a CLEAN
-* (never-boxed) frame via the injected `pickClean`; when the track owns NO clean
-* frame at all — the regression class created by retiring `crop`/`fullFrame`
-* production (2026-07-21), leaving degenerate tracks with only boxed
-* `lastFrame`/`snapshot`/`firstFrame` — degrade to ANY track media rather than
-* returning undefined. A boxed frame (with the target's box drawn) is a real
-* preview; an empty tile is not. Clean is always tried FIRST so the common case
-* still serves an unboxed tile. Undefined only when the owner has NO media.
+* Crop-forced resolution (the `?kind=crop` / `?kind=thumbnailSmall` reel path).
+*
+* Ladder: body crop (track/event thumbnail) → tight face/plate crop → any
+* remaining image (keyFrame / lastFrame / …). The class icon is only honest
+* when the owner has no stored bytes at all.
 *
 * `pickClean` is injected because the clean-kind picker (`pickCleanMedia`) lives
 * in the addon `index.ts` over the concrete `MediaFileKind` set; this keeps the
 * composition pure + unit-testable here.
 */
-function resolveCropForcedMedia(files, pickClean) {
-	return pickClean(files) ?? pickTrackFallbackMedia(files);
+function resolveCropForcedMedia(files, pickClean, detailFiles = []) {
+	return pickClean(files) ?? pickClean(detailFiles) ?? pickTrackFallbackMedia([...files, ...detailFiles]);
+}
+/**
+* Event + track media (the body/scene) and face/plate media (the detail
+* crops). Face rows live under `face-${trackId}`; a track can close with
+* `hasEmbeddedFace` and ZERO track files (0e343f86).
+*/
+async function collectCropForcedMedia(source, id) {
+	const eventFiles = await source.listByOwner("event", id);
+	const trackFiles = await source.listByOwner("track", id);
+	const ownerTrackId = trackFiles.length === 0 ? await source.getTrackIdForEvent(id) : null;
+	const owningTrackFiles = ownerTrackId === null ? [] : await source.listByOwner("track", ownerTrackId);
+	const trackId = ownerTrackId ?? id;
+	const [faceFiles, plateFiles] = await Promise.all([source.listByOwner("face", `face-${trackId}`), source.listByOwner("plate", `plate-${trackId}`)]);
+	return {
+		bodyFiles: [
+			...eventFiles,
+			...trackFiles,
+			...owningTrackFiles
+		],
+		detailFiles: [...faceFiles, ...plateFiles]
+	};
 }
 /**
 * Resolve the default-path media for an event id: the event's own media when it
@@ -35978,6 +36044,14 @@ async function resolveDefaultEventMedia(deps) {
 	return pickTrackFallbackMedia(await deps.listTrackMedia(trackId)) ?? null;
 }
 //#endregion
+//#region src/pipeline-analytics/ensure-track-hierarchy.ts
+async function ensureTrackHierarchyMedia(deps, input) {
+	const tasks = [];
+	if (!deps.isThumbnailLanded(input.trackId)) tasks.push(deps.captureBodyThumbnail(input));
+	if (!deps.isKeyFrameLanded(input.trackId)) tasks.push(deps.captureKeyFrame(input));
+	await Promise.all(tasks);
+}
+//#endregion
 //#region src/pipeline-analytics/face-settings.ts
 /**
 * Per-device face-recognition settings. Cascade: a per-device override on top
@@ -36496,6 +36570,21 @@ var FaceRecognizer = class {
 					...held,
 					crop
 				});
+				if (crop !== void 0 && input.frameHandle !== void 0) this.deps.onLiveHierarchy?.({
+					deviceId: input.deviceId,
+					trackId: c.trackId,
+					timestamp: input.timestamp,
+					bodyBbox: {
+						x: c.bbox.x,
+						y: c.bbox.y,
+						w: c.bbox.w,
+						h: c.bbox.h
+					},
+					frameWidth: input.frameWidth,
+					frameHeight: input.frameHeight,
+					cropPadding: input.cropPadding,
+					frameHandle: input.frameHandle
+				});
 				this.deps.logger.debug("face: best-face held", {
 					tags: {
 						deviceId: input.deviceId,
@@ -36645,6 +36734,22 @@ var FaceRecognizer = class {
 			});
 			return;
 		}
+		try {
+			await this.deps.copyCropToTrackPreview?.({
+				deviceId,
+				trackId,
+				crop: held.crop,
+				timestamp: held.timestamp
+			});
+		} catch (err) {
+			this.deps.logger.debug("face: track preview copy failed", {
+				tags: { deviceId },
+				meta: {
+					trackId,
+					error: String(err)
+				}
+			});
+		}
 		const keyFrameMediaKey = this.deps.getKeyFrameMediaKey?.(trackId);
 		try {
 			await this.deps.faceStore.insert({
@@ -39935,8 +40040,9 @@ var OverlayDetailStateStore = class {
 *
 * See docs/superpowers/specs/2026-07-17-package-zones-design.md §3.3 +
 * docs/superpowers/specs/2026-07-17-detection-config-exposure-design.md
-* (surface C). Dwell default is 15s per operator decision (the design's
-* §3.3 draft said 45s).
+* (surface C). Confirmation is N frames (default 3); dwell default is 0
+* (an extra bar). The 15 s dwell plus a 5 s round-gap missed a real
+* parcel on device 615 (2026-08-24 13:40).
 */
 var PackageDropSettingsSchema = require_dist.object({
 	/**
@@ -39957,13 +40063,20 @@ var PackageDropSettingsSchema = require_dist.object({
 	*/
 	packageDropEnabled: require_dist.boolean().default(true),
 	/**
-	* Minimum OBSERVED dwell (seconds, since first-seen) before a newly
-	* promoted stationary package counts as a delivery. Kills a bag briefly
-	* set down and snatched back. Operator default 15s. Values beyond the
-	* stationary promotion window (30s) are satisfied only once the entry
-	* has actually been observed that long.
+	* Frames the box must be re-seen on before it is a parked package.
+	* Same bar as tracker `minHits`: one frame is a flicker, two can still
+	* be a passer-by's bag, three is "it stayed". A settle burst of three
+	* frames in ~1 s is enough; no second governor round after the courier
+	* left. Device 615 2026-08-24 13:40 expired at 1 round / 1.5 s dwell.
+	*/
+	packageDropMinFrames: require_dist.number().int().min(1).max(20).default(3),
+	/**
+	* Extra OBSERVED dwell (seconds, since first-seen) on top of N frames.
+	* 0 (the default) means the frame count is enough — a courier who drops
+	* and leaves in 2 s still delivers. Raise this to reject a bag briefly
+	* set down and snatched back.
 	*/
-	packageDropDwellSec: require_dist.number().int().min(0).max(3600).default(15),
+	packageDropDwellSec: require_dist.number().int().min(0).max(3600).default(0),
 	/** Reject tiny far-field blobs: min bbox area as a fraction of the frame. */
 	packageDropMinBboxAreaFrac: require_dist.number().min(0).max(1).default(.004),
 	/**
@@ -39981,13 +40094,15 @@ var PackageDropSettingsSchema = require_dist.object({
 	packageDropPickupEnabled: require_dist.boolean().default(true),
 	/**
 	* A parcel needs a deliverer: a stillness candidate only ever promotes to
-	* `delivered` if a non-package track (person/vehicle/animal) was active on
-	* the device within this many seconds BEFORE the box first appeared — and a
-	* departure only counts as `picked-up` with somebody around the
-	* disappearance. 0 disables both gates. Device 615's streetlight wedge
-	* cycled delivered→picked-up ~23×/night with nobody in frame, ever.
-	* Default 300 s: wide enough to absorb the motion-settle governor's cadence
-	* (the box is often first SEEN minutes after the courier left).
+	* `delivered` if a non-package track (person/vehicle/animal) was active IN
+	* A CONFIGURED PACKAGE DROP-OFF ZONE within this many seconds BEFORE the
+	* box first appeared — and a departure only counts as `picked-up` with
+	* somebody in that zone around the disappearance. Whole-camera motion (a
+	* walker at the far gate) does not count. 0 disables both gates. Device
+	* 615's streetlight wedge cycled delivered→picked-up ~23×/night with
+	* nobody in the drop-off zone. Default 300 s: wide enough to absorb the
+	* motion-settle governor's cadence (the box is often first SEEN minutes
+	* after the courier left).
 	*/
 	packageDropActivityWindowSec: require_dist.number().int().min(0).max(3600).default(300),
 	/**
@@ -40011,6 +40126,7 @@ function resolvePackageDropSettings(raw) {
 	};
 	return {
 		packageDropEnabled: pick("packageDropEnabled"),
+		packageDropMinFrames: pick("packageDropMinFrames"),
 		packageDropDwellSec: pick("packageDropDwellSec"),
 		packageDropMinBboxAreaFrac: pick("packageDropMinBboxAreaFrac"),
 		packageDropMaxBboxAreaFrac: pick("packageDropMaxBboxAreaFrac"),
@@ -40268,29 +40384,6 @@ var DeferredBirthRegistry = class {
 		this.byDevice.delete(deviceKey);
 	}
 };
-var AnalyticsGroupRecordSchema = require_dist.object({
-	id: require_dist.string(),
-	deviceId: require_dist.number().int(),
-	openedAt: require_dist.number().int(),
-	closedAt: require_dist.number().int(),
-	timestamp: require_dist.number().int(),
-	memberCount: require_dist.number().int(),
-	memberTrackIds: require_dist.array(require_dist.string()).readonly(),
-	className: require_dist.string(),
-	classes: require_dist.array(require_dist.string()).readonly(),
-	/** Relative event-media path, or null when the group has no picture yet. */
-	mediaUrl: require_dist.string().nullable(),
-	singleton: require_dist.boolean()
-});
-var AnalyticsGroupMemberSchema = require_dist.object({
-	trackId: require_dist.string(),
-	deviceId: require_dist.number().int(),
-	className: require_dist.string(),
-	firstSeen: require_dist.number().int(),
-	lastSeen: require_dist.number().int(),
-	mediaUrl: require_dist.string().nullable()
-});
-var AnalyticsGroupDetailSchema = AnalyticsGroupRecordSchema.extend({ members: require_dist.array(AnalyticsGroupMemberSchema).readonly() });
 var ListGroupsInputSchema = require_dist.object({
 	deviceId: require_dist.number().int().optional(),
 	sinceMs: require_dist.number().int().optional(),
@@ -40300,66 +40393,11 @@ var ListGroupsInputSchema = require_dist.object({
 });
 var groupActions = require_dist.defineCustomActions({
 	"analytics.listGroups": require_dist.customAction(ListGroupsInputSchema, require_dist.object({
-		groups: require_dist.array(AnalyticsGroupRecordSchema).readonly(),
+		groups: require_dist.array(require_dist.AnalyticsGroupRecordSchema).readonly(),
 		hasMore: require_dist.boolean()
 	})),
-	"analytics.getGroup": require_dist.customAction(require_dist.object({ groupId: require_dist.string().min(1) }), require_dist.object({ group: AnalyticsGroupDetailSchema.nullable() }))
+	"analytics.getGroup": require_dist.customAction(require_dist.object({ groupId: require_dist.string().min(1) }), require_dist.object({ group: require_dist.AnalyticsGroupDetailSchema.nullable() }))
 });
-//#endregion
-//#region src/pipeline-analytics/group/group-query.ts
-/**
-* Stamp a relative event-media URL.
-*
-* Media keys contain `:` and the data-plane serves them by key. Track ids are
-* bare and fall through to the existing event/track thumbnail resolver. Never
-* percent-encode: the handler does not URL-decode the path.
-*/
-function stampEventMediaUrl(baseUrl, id) {
-	if (baseUrl === null || baseUrl.length === 0) return null;
-	if (id === null || id === void 0 || id.length === 0) return null;
-	return `${baseUrl}/${id}`;
-}
-/** Union of every class on the members; `className` is the first, stable order. */
-function aggregateGroupClasses(tracks) {
-	const seen = /* @__PURE__ */ new Set();
-	const classes = [];
-	for (const track of tracks) for (const name of [track.className, ...track.classes ?? []]) {
-		if (name.length === 0 || seen.has(name)) continue;
-		seen.add(name);
-		classes.push(name);
-	}
-	return {
-		className: classes[0] ?? "unknown",
-		classes
-	};
-}
-function toGroupRecord(input) {
-	const { className, classes } = aggregateGroupClasses(input.tracks);
-	const mediaId = input.group.mediaKey ?? input.group.nativeKey ?? (input.group.memberCount === 1 ? input.memberTrackIds[0] : null);
-	return {
-		id: input.group.id,
-		deviceId: input.group.deviceId,
-		openedAt: input.group.openedAt,
-		closedAt: input.group.closedAt,
-		timestamp: input.group.timestamp,
-		memberCount: input.memberTrackIds.length > 0 ? input.memberTrackIds.length : input.group.memberCount,
-		memberTrackIds: [...input.memberTrackIds],
-		className,
-		classes: [...classes],
-		mediaUrl: stampEventMediaUrl(input.eventMediaBaseUrl, mediaId),
-		singleton: input.memberTrackIds.length <= 1
-	};
-}
-function toGroupMember(member, track, eventMediaBaseUrl) {
-	return {
-		trackId: member.trackId,
-		deviceId: member.deviceId,
-		className: track?.className ?? "unknown",
-		firstSeen: track?.firstSeen ?? member.timestamp,
-		lastSeen: track?.lastSeen ?? member.timestamp,
-		mediaUrl: stampEventMediaUrl(eventMediaBaseUrl, member.trackId)
-	};
-}
 function trackToLite(track) {
 	return {
 		trackId: track.trackId,
@@ -40369,56 +40407,18 @@ function trackToLite(track) {
 		lastSeen: track.lastSeen
 	};
 }
-async function listGroupRecords(ports, input) {
-	const page = await ports.groupStore.listRecent(input);
-	const groups = [];
-	for (const group of page.groups) groups.push(await buildGroupRecord(ports, group));
-	return {
-		groups,
-		hasMore: page.hasMore
-	};
-}
-async function getGroupDetail(ports, groupId) {
-	const group = await ports.groupStore.get(groupId);
-	if (group === null) return null;
-	const members = await ports.groupStore.listMembers(groupId);
-	const lites = [];
-	const rows = [];
-	for (const member of members) {
-		const track = await ports.loadTrack(member.trackId);
-		const lite = track === null ? null : trackToLite(track);
-		if (lite !== null) lites.push(lite);
-		rows.push(toGroupMember(member, lite, ports.eventMediaBaseUrl()));
-	}
-	return {
-		...toGroupRecord({
-			group,
-			memberTrackIds: members.map((m) => m.trackId),
-			tracks: lites,
-			eventMediaBaseUrl: ports.eventMediaBaseUrl()
-		}),
-		members: rows
-	};
-}
-async function buildGroupRecord(ports, group) {
-	const members = await ports.groupStore.listMembers(group.id);
-	const lites = [];
-	for (const member of members) {
-		const track = await ports.loadTrack(member.trackId);
-		if (track !== null) lites.push(trackToLite(track));
-	}
-	return toGroupRecord({
-		group,
-		memberTrackIds: members.map((m) => m.trackId),
-		tracks: lites,
-		eventMediaBaseUrl: ports.eventMediaBaseUrl()
-	});
-}
 /**
 * Gallery and digest read the same ladder: groupCrop, then the native-frame
-* pointer, then member subject crops. A multi with no crop still has a
-* picture if the sealer stored `nativeKey`.
+* pointer, then a member's clean full frame. Plate / face / member
+* thumbnails never reach the picker — a plate read overwrites the vehicle
+* first-level crop under the same `thumbnail` kind. A multi with no crop
+* still has a picture if the sealer stored `nativeKey`.
 */
+var DIGEST_MEMBER_FALLBACK_KINDS = new Set([
+	"keyFrame",
+	"keyFrameSmall",
+	"fullFrame"
+]);
 function digestMediaRows(input) {
 	const owned = [];
 	if (input.mediaKey !== null && input.mediaKey.length > 0) owned.push({
@@ -40432,7 +40432,7 @@ function digestMediaRows(input) {
 		timestamp: input.timestamp
 	});
 	if (owned.length > 0) return owned;
-	return input.memberRows;
+	return input.memberRows.filter((row) => DIGEST_MEMBER_FALLBACK_KINDS.has(row.kind));
 }
 var MATCH_WINDOW_MS = 1e3;
 var MOVE_EPS = .35;
@@ -40986,6 +40986,34 @@ function toInstant(t) {
 		confidence: t.importance
 	};
 }
+function memberBoxesAt(members, at, frame) {
+	const w = Math.max(frame.width, 1);
+	const h = Math.max(frame.height, 1);
+	const boxes = [];
+	for (const member of members) {
+		let best = member.positions[0];
+		let bestDt = Number.POSITIVE_INFINITY;
+		for (const p of member.positions) {
+			const dt = Math.abs(p.timestamp - at);
+			if (dt <= 1e3 && dt < bestDt) {
+				best = p;
+				bestDt = dt;
+			}
+		}
+		if (best === void 0 || bestDt === Number.POSITIVE_INFINITY) continue;
+		boxes.push({
+			bbox: {
+				x: best.bbox.x / w,
+				y: best.bbox.y / h,
+				w: best.bbox.w / w,
+				h: best.bbox.h / h
+			},
+			label: member.className,
+			observedAt: best.timestamp
+		});
+	}
+	return boxes;
+}
 function toSealer(track) {
 	return {
 		trackId: track.trackId,
@@ -41002,7 +41030,11 @@ var GroupSealer = class {
 	constructor(deps) {
 		this.deps = deps;
 	}
+	get processEnabled() {
+		return this.deps.enabled ?? false;
+	}
 	async flushIdle(buffer, now = this.deps.now()) {
+		if (!this.processEnabled) return 0;
 		let written = 0;
 		for (const group of buffer.idleGroups(now, GROUP_SESSION_IDLE_MS)) if (await this.persistLiveGroup(group, buffer)) {
 			buffer.drop([group.id]);
@@ -41015,6 +41047,7 @@ var GroupSealer = class {
 	* into the live buffer, persist whoever is already idle, keep the rest in RAM.
 	*/
 	async recoverCamera(deviceId, buffer) {
+		if (!this.processEnabled) return 0;
 		if (buffer.isPrimed(deviceId)) return 0;
 		const now = this.deps.now();
 		try {
@@ -41043,6 +41076,7 @@ var GroupSealer = class {
 	* is what wedged hub-main.
 	*/
 	async sealWindow(deviceId, since, until) {
+		if (!this.processEnabled) return 0;
 		try {
 			const closed = await this.deps.trackStore.queryHistorical({
 				deviceId,
@@ -41157,26 +41191,54 @@ var GroupSealer = class {
 			return;
 		}
 		try {
-			const raw = await (0, sharp.default)(source.jpeg).removeAlpha().raw().toBuffer({ resolveWithObject: true });
-			if (raw.info.channels !== 3) return;
-			const union = {
-				x: instant.ux * raw.info.width,
-				y: instant.uy * raw.info.height,
-				w: instant.uw * raw.info.width,
-				h: instant.uh * raw.info.height
-			};
-			const crop = await cropGroupFromRgb(raw.data, raw.info.width, raw.info.height, union);
-			const mediaKey = await this.deps.mediaStore.put({
+			const raw = await (0, sharp.default)(source.jpeg).removeAlpha().toColorspace("srgb").raw().toBuffer({ resolveWithObject: true });
+			if (raw.info.channels === 3) {
+				const union = {
+					x: instant.ux * raw.info.width,
+					y: instant.uy * raw.info.height,
+					w: instant.uw * raw.info.width,
+					h: instant.uh * raw.info.height
+				};
+				const crop = await cropGroupFromRgb(raw.data, raw.info.width, raw.info.height, union);
+				const mediaKey = await this.deps.mediaStore.put({
+					deviceId,
+					ownerKind: "group",
+					ownerId: draft.id,
+					kind: "thumbnail",
+					timestamp,
+					data: crop
+				});
+				await this.deps.groupStore.setMediaKey(draft.id, mediaKey);
+			}
+		} catch (err) {
+			this.deps.logger.warn("group sealer: crop failed", {
+				tags: { deviceId },
+				meta: {
+					groupId: draft.id,
+					error: String(err)
+				}
+			});
+		}
+		try {
+			const composed = await composeGroupFrame({
+				jpeg: source.jpeg,
+				boxes: memberBoxesAt(instantMembers, timestamp, frame),
+				at: timestamp,
+				logger: this.deps.logger,
+				deviceId,
+				groupKey: draft.id
+			});
+			if (composed === null) return;
+			await this.deps.mediaStore.put({
 				deviceId,
 				ownerKind: "group",
 				ownerId: draft.id,
-				kind: "thumbnail",
+				kind: "fullFrameBoxed",
 				timestamp,
-				data: crop
+				data: composed.bytes
 			});
-			await this.deps.groupStore.setMediaKey(draft.id, mediaKey);
 		} catch (err) {
-			this.deps.logger.warn("group sealer: crop failed", {
+			this.deps.logger.warn("group sealer: boxed frame failed", {
 				tags: { deviceId },
 				meta: {
 					groupId: draft.id,
@@ -41201,6 +41263,37 @@ var GroupSealer = class {
 	}
 };
 //#endregion
+//#region src/pipeline-analytics/group/group-cursor.ts
+function encodeGroupCursor(cursor) {
+	return Buffer.from(JSON.stringify({
+		c: cursor.closedAt,
+		i: cursor.groupId
+	}), "utf8").toString("base64url");
+}
+function decodeGroupCursor(raw) {
+	let parsed;
+	try {
+		parsed = JSON.parse(Buffer.from(raw, "base64url").toString("utf8"));
+	} catch {
+		throw new Error("listGroups: malformed cursor");
+	}
+	if (parsed === null || typeof parsed !== "object" || !("c" in parsed) || !("i" in parsed) || typeof parsed.c !== "number" || !Number.isFinite(parsed.c) || typeof parsed.i !== "string" || parsed.i.length === 0) throw new Error("listGroups: malformed cursor");
+	return {
+		closedAt: parsed.c,
+		groupId: parsed.i
+	};
+}
+function compareGroupDesc(a, b) {
+	if (a.closedAt !== b.closedAt) return b.closedAt - a.closedAt;
+	if (a.id === b.id) return 0;
+	return a.id < b.id ? 1 : -1;
+}
+/** True when `row` sits strictly AFTER the cursor in DESC order. */
+function isAfterGroupCursor(row, cursor) {
+	if (row.closedAt < cursor.closedAt) return true;
+	return row.closedAt === cursor.closedAt && row.id < cursor.groupId;
+}
+//#endregion
 //#region src/pipeline-analytics/group/group-store.ts
 /**
 * The group ENTITY store — a co-moving partition of one session, with one
@@ -41462,6 +41555,24 @@ var TrackGroupStore = class {
 			data: r.data
 		}));
 	}
+	/**
+	* Membership for a page of groups in ONE query. `listGroupRecords` used to
+	* call {@link listMembers} per row — 60 groups is 60 settings-store RPCs,
+	* ~20 s, and the viewer feed times out into a retry loop.
+	*/
+	async listMembersForGroups(groupIds) {
+		if (groupIds.length === 0) return [];
+		return (await this.store.query.query({
+			collection: TRACK_GROUP_MEMBERS_COLLECTION,
+			filter: {
+				whereIn: { groupId: [...groupIds] },
+				limit: 1e4
+			}
+		})).map((r) => this.normalizeMember({
+			id: r.id,
+			data: r.data
+		}));
+	}
 	async membersOfTracks(trackIds) {
 		const out = [];
 		for (const trackId of trackIds) {
@@ -41477,20 +41588,29 @@ var TrackGroupStore = class {
 		return out;
 	}
 	/**
-	* Newest-closed page for the Library Groups tab.
+	* Newest-closed page for the Groups feed.
 	*
 	* Time filter is overlap (`closedAt >= since` and `openedAt <= until`),
 	* same as {@link listOverlapping}. Pagination is applied AFTER the window
 	* so a day cursor is honest rather than a raw-row offset that skips live
-	* groups on a busy camera.
+	* groups on a busy camera. `deviceIds: []` is an empty page (same as
+	* `listRecentTracks`); omit the field for every camera. `deviceId` stays
+	* as the single-camera alias the custom-action bridge still sends.
 	*/
 	async listRecent(input) {
 		const limit = Math.min(Math.max(input.limit ?? 40, 1), 100);
 		const offset = Math.max(input.offset ?? 0, 0);
-		const slice = (await this.store.query.query({
+		const deviceIds = input.deviceIds !== void 0 ? input.deviceIds : input.deviceId !== void 0 ? [input.deviceId] : void 0;
+		if (deviceIds !== void 0 && deviceIds.length === 0) return {
+			groups: [],
+			hasMore: false,
+			nextCursor: null
+		};
+		const cursor = input.cursor !== void 0 && input.cursor.length > 0 ? decodeGroupCursor(input.cursor) : null;
+		const filtered = (await this.store.query.query({
 			collection: TRACK_GROUPS_COLLECTION,
 			filter: {
-				...input.deviceId !== void 0 ? { where: { deviceId: input.deviceId } } : {},
+				...deviceIds !== void 0 && deviceIds.length === 1 ? { where: { deviceId: deviceIds[0] } } : deviceIds !== void 0 ? { whereIn: { deviceId: [...deviceIds] } } : {},
 				orderBy: {
 					field: "closedAt",
 					direction: "desc"
@@ -41503,11 +41623,20 @@ var TrackGroupStore = class {
 		})).filter((g) => {
 			if (input.sinceMs !== void 0 && g.closedAt < input.sinceMs) return false;
 			if (input.untilMs !== void 0 && g.openedAt > input.untilMs) return false;
+			if (cursor !== null && !isAfterGroupCursor(g, cursor)) return false;
 			return true;
-		}).slice(offset, offset + limit + 1);
+		}).toSorted(compareGroupDesc);
+		const slice = (cursor !== null ? filtered : filtered.slice(offset)).slice(0, limit + 1);
+		const groups = slice.slice(0, limit);
+		const hasMore = slice.length > limit;
+		const last = groups[groups.length - 1];
 		return {
-			groups: slice.slice(0, limit),
-			hasMore: slice.length > limit
+			groups,
+			hasMore,
+			nextCursor: hasMore && last !== void 0 ? encodeGroupCursor({
+				closedAt: last.closedAt,
+				groupId: last.id
+			}) : null
 		};
 	}
 	/** Groups whose life overlaps `[since, until]` on one camera. */
@@ -42839,7 +42968,7 @@ function evaluateStationaryPromotion(input) {
 	};
 }
 var DEFAULT_PACKAGE_STILLNESS_CONFIG = {
-	minRounds: 2,
+	minHits: 3,
 	roundGapMs: 5e3,
 	ttlMs: 5 * 6e4,
 	assocIou: .3
@@ -42872,8 +43001,9 @@ var PackageStillnessTracker = class {
 			const prev = next[index];
 			if (prev === void 0) continue;
 			consumed.add(prev.id);
-			const updated = confirm(prev, input, s, this.config.roundGapMs);
-			if (!(updated.promotedAt === null && updated.activityBackedAtOpen && updated.rounds >= this.config.minRounds && input.timestamp - updated.firstSeenAt >= input.minDwellMs)) {
+			const updated = confirm(prev, input, s);
+			const minHits = input.minHits ?? this.config.minHits;
+			if (!(updated.promotedAt === null && updated.activityBackedAtOpen && updated.hits >= minHits && input.timestamp - updated.firstSeenAt >= input.minDwellMs)) {
 				next[index] = updated;
 				continue;
 			}
@@ -42897,7 +43027,7 @@ var PackageStillnessTracker = class {
 					id: c.id,
 					className: c.className,
 					bbox: { ...c.bbox },
-					rounds: c.rounds,
+					hits: c.hits,
 					firstSeenAt: c.firstSeenAt,
 					lastSeenAt: c.lastSeenAt,
 					activityBackedAtOpen: c.activityBackedAtOpen
@@ -42955,7 +43085,7 @@ var PackageStillnessTracker = class {
 			frameHeight: input.frameHeight,
 			firstSeenAt: input.timestamp,
 			lastSeenAt: input.timestamp,
-			rounds: 1,
+			hits: 1,
 			promotedAt: null,
 			activityBackedAtOpen,
 			...s.trackId !== void 0 ? { sourceTrackId: s.trackId } : {},
@@ -42965,18 +43095,16 @@ var PackageStillnessTracker = class {
 		};
 	}
 };
-/** Re-confirm a candidate with this frame's box. A new ROUND is only counted
-*  when the gap since the last sighting clears `roundGapMs`, so a burst of
-*  frames inside one governor round counts once. */
-function confirm(prev, input, s, roundGapMs) {
-	const newRound = input.timestamp - prev.lastSeenAt >= roundGapMs;
+/** Re-confirm a candidate with this frame's box. Every sighting is a hit —
+*  a settle burst of three frames in one second is three confirmations. */
+function confirm(prev, input, s) {
 	return {
 		...prev,
 		bbox: { ...s.bbox },
 		frameWidth: input.frameWidth,
 		frameHeight: input.frameHeight,
 		lastSeenAt: input.timestamp,
-		rounds: newRound ? prev.rounds + 1 : prev.rounds,
+		hits: prev.hits + 1,
 		...s.trackId !== void 0 ? { sourceTrackId: s.trackId } : {},
 		...s.label !== void 0 ? { label: s.label } : {},
 		...s.confidence !== void 0 ? { confidence: s.confidence } : {},
@@ -43001,6 +43129,31 @@ function toEntry(c) {
 	};
 }
 //#endregion
+//#region src/pipeline-analytics/pipeline/package/package-zone-activity.ts
+/**
+* Whether a live track is motion inside a configured package drop-off zone.
+*
+* The stillness activity gate used to stamp ANY non-package track on the
+* camera. A walker at the far gate then "delivered" the streetlight wedge
+* on the doormat. The operator's prerequisite is motion in the drop-off
+* zone the package rule points at — the same zones `PackageDropDetector`
+* uses for the centroid gate.
+*/
+function isDelivererInPackageZone(trackZones, packageZoneIds) {
+	if (packageZoneIds.size === 0 || trackZones.length === 0) return false;
+	for (const z of trackZones) if (packageZoneIds.has(z)) return true;
+	return false;
+}
+/** Zone ids referenced by enabled `package`-stage rules. Disabled rules do not count. */
+function collectPackageZoneIds(rules) {
+	const ids = /* @__PURE__ */ new Set();
+	for (const r of rules) {
+		if (r.enabled === false) continue;
+		for (const z of r.zoneIds) ids.add(z);
+	}
+	return ids;
+}
+//#endregion
 //#region src/pipeline-analytics/pipeline/stationary/stationary-zones.ts
 /**
 * Zone ids whose 0–1 polygon contains the entry's normalised bbox centroid.
@@ -44177,6 +44330,12 @@ var PlateRecognizer = class {
 			text: c.plateText,
 			score: c.plateScore,
 			bbox: c.plateBbox,
+			bodyBbox: {
+				x: c.bbox.x,
+				y: c.bbox.y,
+				w: c.bbox.w,
+				h: c.bbox.h
+			},
 			timestamp: input.timestamp,
 			frameWidth: input.frameWidth,
 			frameHeight: input.frameHeight,
@@ -44250,6 +44409,16 @@ var PlateRecognizer = class {
 				}
 			});
 		}
+		if (crop !== void 0 && input.frameHandle !== void 0 && input.bodyBbox !== void 0) this.deps.onLiveHierarchy?.({
+			deviceId: input.deviceId,
+			trackId: input.trackId,
+			timestamp: input.timestamp,
+			bodyBbox: input.bodyBbox,
+			frameWidth: input.frameWidth,
+			frameHeight: input.frameHeight,
+			cropPadding: input.cropPadding,
+			frameHandle: input.frameHandle
+		});
 		this.bestPlate.set(input.trackId, {
 			text: input.text,
 			score: input.score,
@@ -48284,14 +48453,23 @@ function isAfterCursor(row, cursor) {
 	if (row.lastSeen < cursor.lastSeen) return true;
 	return row.lastSeen === cursor.lastSeen && row.id < cursor.trackId;
 }
+var VEHICLE_CLASSES = new Set([
+	"vehicle",
+	"car",
+	"truck",
+	"bus"
+]);
+function motionlessMaxPxForClass(className) {
+	return VEHICLE_CLASSES.has(className.toLowerCase()) ? 8 : 40;
+}
 function netDisplacementPx(positions) {
 	const first = positions[0];
 	const last = positions[positions.length - 1];
 	if (!first || !last) return 0;
 	return Math.hypot(last.x - first.x, last.y - first.y);
 }
-function isShortMotionlessTrack(lifeMs, movedPx) {
-	return lifeMs <= 25e3 && movedPx <= 8;
+function isShortMotionlessTrack(lifeMs, movedPx, className) {
+	return lifeMs <= 25e3 && movedPx <= motionlessMaxPxForClass(className);
 }
 //#endregion
 //#region src/pipeline-analytics/store/track-store.ts
@@ -48875,7 +49053,7 @@ var TrackStore = class {
 		for (const [trackId, t] of this.active) {
 			if (nowMs - t.lastSeen < this.config.ttlMs) continue;
 			t.active = false;
-			if (t.positions.length > 0 && isShortMotionlessTrack(t.lastSeen - t.firstSeen, netDisplacementPx(t.positions))) t.closedReason = "stationary-promotion";
+			if (t.positions.length > 0 && isShortMotionlessTrack(t.lastSeen - t.firstSeen, netDisplacementPx(t.positions), t.className)) t.closedReason = "stationary-promotion";
 			const record = cloneTrack(t);
 			try {
 				await this.persistCompleted(record);
@@ -49904,6 +50082,28 @@ var TrackStore = class {
 		return this.rowToTrack(row.id, row.data);
 	}
 	/**
+	* Batch read of persisted tracks. `listGroupRecords` cannot call
+	* {@link getPersistedByTrackId} per member — that is one settings-store RPC
+	* per row and a 60-group page takes ~20 s, which the viewer feed times out.
+	*/
+	async getPersistedByTrackIds(trackIds) {
+		if (trackIds.length === 0) return [];
+		const PAGE = 500;
+		const out = [];
+		for (let i = 0; i < trackIds.length; i += PAGE) {
+			const chunk = trackIds.slice(i, i + PAGE);
+			const rows = await this.store.query.query({
+				collection: TRACKS_COLLECTION,
+				filter: {
+					whereIn: { id: [...chunk] },
+					limit: chunk.length
+				}
+			});
+			for (const row of rows) out.push(this.rowToTrack(row.id, row.data));
+		}
+		return out;
+	}
+	/**
 	* Persist a SYNTHETIC track (a sensor/control event projected into the
 	* unified track store). Unlike `persistCompleted` there is no live in-RAM
 	* state and no trajectory envelope (synthetic tracks carry no positions) —
@@ -54976,11 +55176,22 @@ function buildGlobalSettingsSchema(cap) {
 					description: "Also emit a package-picked-up event when the delivered package leaves.",
 					default: PACKAGE_DROP_DEFAULTS.packageDropPickupEnabled
 				},
+				{
+					type: "slider",
+					key: "packageDropMinFrames",
+					label: "Confirmation frames",
+					description: "How many frames the box must be seen on before it counts as a delivery. One is a flicker; two can still be a passer-by; three is the default bar against false positives. Independent of dwell.",
+					min: 1,
+					max: 10,
+					step: 1,
+					default: PACKAGE_DROP_DEFAULTS.packageDropMinFrames,
+					showValue: true
+				},
 				{
 					type: "slider",
 					key: "packageDropDwellSec",
 					label: "Minimum dwell",
-					description: "How long a package must stay parked before it counts as a delivery. Higher = fewer false positives from bags briefly set down.",
+					description: "Extra time the package must stay parked after the confirmation frames. 0 (default) means N frames is enough — a courier who drops and leaves in a couple of seconds still delivers. Raise to reject a bag briefly set down.",
 					min: 0,
 					max: 300,
 					step: 5,
@@ -55014,7 +55225,7 @@ function buildGlobalSettingsSchema(cap) {
 					type: "slider",
 					key: "packageDropActivityWindowSec",
 					label: "Deliverer window",
-					description: "A delivery only counts if a person or vehicle was active on this camera within this many seconds before the package appeared — and a pick-up only with somebody around when it vanished. 0 disables the requirement.",
+					description: "A delivery only counts if a person or vehicle was in the configured package drop-off zone within this many seconds before the package appeared — and a pick-up only with somebody in that zone when it vanished. Motion elsewhere on the camera does not count. 0 disables the requirement.",
 					min: 0,
 					max: 1800,
 					step: 30,
@@ -56848,10 +57059,12 @@ var CONFIRMATION_CROP_MAX_WIDTH = 320;
 *  a late confirmation is still worth running; see `DEFAULT_CAPTURE_PRIORITY`). */
 var ENRICHMENT_CAPTURE_STALE_MS = 3e3;
 /** Reconcile cadence for the per-device `zones` / `zoneRules` slice handles.
-*  The `device.state-changed` push doesn't reliably reach a forked child, so
-*  each cached proxy re-pulls both slices on this timer (see ensureProxy) —
-*  a zone drawn in the editor shows up in per-zone stats within one tick. */
-var ZONE_SLICE_RECONCILE_MS = 3e4;
+*  The `device.state-changed` push reaches a forked child through
+*  `createEventBusSliceSource` (the DeviceProxy no longer waits on
+*  `live.onEvent`). Events are still lossy telemetry (D8); this timer
+*  is the RPC reconcile, not the mechanism. Five minutes matches the
+*  viewer's `RECONCILE_MS`. */
+var ZONE_SLICE_RECONCILE_MS = 3e5;
 /** How often the evaluating node re-reads the central scene set. */
 var SCENE_RELOAD_INTERVAL_MS = 3e4;
 /** How long the install coordinates are trusted between settings reads. */
@@ -56915,38 +57128,31 @@ var MOTION_EVENT_HEARTBEAT_MS = 5e3;
 *
 * `thumbnail` joined the clean set on 2026-07-17: the track best-thumbnail is
 * now a subject-centered crop (event-media-dispatcher), and for DEGENERATE
-* tracks (no object event → no `crop`) it is the ONLY subject-centered media —
-* without it a crop-forced request degraded to the `keyFrame` FULL FRAME,
-* which is how 65% of the timeline tiles rendered as whole scenes. It sits
-* right after a real `crop`, before the full-scene `fullFrame`/`keyFrame`.
-*
-* `keyFrameSmall` (the 960px no-box downscale of the best-shot `keyFrame`)
-* joined the clean set on 2026-07-21 so a crop-forced request can degrade to it
-* for tracks whose only clean media is the small key frame; it sits last
-* (fullest-scene, but subject-centered enough to serve as a reasonable fallback
-* over 404). The retired-but-still-stored kinds (`crop`) stay listed so old rows
-* keep resolving.
+* tracks (no object event → no `crop`) it is the ONLY subject-centered media.
+*
+* Full-scene kinds (`fullFrame`, `keyFrame`, `keyFrameSmall`) stay out of
+* this list so a crop is preferred when one exists. `resolveCropForcedMedia`
+* then falls through to those full-scene kinds — a keyFrame beats an icon.
+* An *explicit* `?kind=keyFrame` / `?kind=snapshot` still matches exactly, so
+* videoclips and other kind-specific fetches keep working.
+*
+* The retired-but-still-stored kind (`crop`) stays listed so old rows resolve.
 */
 var CLEAN_MEDIA_KINDS = [
 	"crop",
 	"thumbnail",
-	"thumbnailSmall",
-	"fullFrame",
-	"keyFrame",
-	"keyFrameSmall"
+	"thumbnailSmall"
 ];
 /**
-* Pick a CLEAN (never boxed) media file for a crop-forced request: the exact
-* `preferKind` if it is itself clean and present, else the first available
-* {@link CLEAN_MEDIA_KINDS} frame. Returns undefined when only boxed / no media
-* exists (caller 404s → the viewer shows an icon).
+* Pick media for a crop-forced request: the exact `preferKind` when present
+* (so `?kind=snapshot` still serves a snapshot), else the first available
+* subject crop in {@link CLEAN_MEDIA_KINDS}. Returns undefined when no crop
+* is in the list — the caller then falls through to any remaining image
+* (`resolveCropForcedMedia`); the class icon is only for a total miss.
 */
 function pickCleanMedia(files, preferKind) {
-	const isClean = (k) => CLEAN_MEDIA_KINDS.includes(k);
-	if (isClean(preferKind)) {
-		const exact = files.find((f) => f.kind === preferKind);
-		if (exact) return exact;
-	}
+	const exact = files.find((f) => f.kind === preferKind);
+	if (exact) return exact;
 	for (const kind of CLEAN_MEDIA_KINDS) {
 		const found = files.find((f) => f.kind === kind);
 		if (found) return found;
@@ -57439,11 +57645,12 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 	*/
 	packageStillness = new PackageStillnessTracker({ newId: () => (0, node_crypto.randomUUID)() });
 	/**
-	* Frame-clock timestamp of the last NON-package track seen per device — the
-	* activity mirror behind the package activity gate ("a parcel needs a
-	* deliverer"). Deliberately not {@link lastTrackActivityMs}: that map is
-	* stamped by ANY live track, including the package-class FP itself, which
-	* would let the streetlight wedge vouch for its own delivery.
+	* Frame-clock timestamp of the last NON-package track seen IN A PACKAGE
+	* DROP-OFF ZONE per device — the activity mirror behind the package
+	* activity gate ("a parcel needs a deliverer"). A walker at the far gate
+	* does not stamp this. Deliberately not {@link lastTrackActivityMs}: that
+	* map is stamped by ANY live track, including the package-class FP itself,
+	* which would let the streetlight wedge vouch for its own delivery.
 	*/
 	lastNonPackageActivityAt = /* @__PURE__ */ new Map();
 	/** Last time the oversize-sighting drop was logged per device — one line
@@ -58409,6 +58616,19 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 				}, trackId);
 			},
 			markEmbeddedFace: (trackId) => stores.trackStore.markEmbeddedFace(trackId),
+			copyCropToTrackPreview: async (input) => {
+				await copyFaceCropIfTrackHasNoThumbnail({
+					listTrackMedia: (trackId) => stores.mediaStore.listByOwner("track", trackId),
+					putTrackThumbnail: (put) => stores.mediaStore.put({
+						deviceId: put.deviceId,
+						ownerKind: "track",
+						ownerId: put.trackId,
+						kind: "thumbnail",
+						timestamp: put.timestamp,
+						data: put.data
+					})
+				}, input);
+			},
 			getKeyFrameMediaKey: (trackId) => this.residents.keyFrameKey(trackId),
 			emitFaceGalleryChanged: (payload) => this.emitFaceGalleryChanged(payload),
 			onSemanticMatch: (match) => this.promoteSemanticRecognition({
@@ -58423,6 +58643,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 				confidence: match.confidence,
 				...match.frameHandle !== void 0 ? { frameHandle: match.frameHandle } : {}
 			}),
+			onLiveHierarchy: (input) => this.requestTrackHierarchy(input),
 			logger: logger.child("FaceRecognizer")
 		});
 		this.faceRecognizer.refreshGallery();
@@ -58455,6 +58676,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 			deriveCropFromKeyFrame,
 			getKeyFrameMediaKey: (trackId) => this.residents.keyFrameKey(trackId),
 			emitPlateGalleryChanged: (payload) => this.emitPlateGalleryChanged(payload),
+			onLiveHierarchy: (input) => this.requestTrackHierarchy(input),
 			logger: logger.child("PlateRecognizer")
 		});
 		this.plateRecognizer.refreshGallery();
@@ -58810,13 +59032,6 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 	buildSummaryPorts(stores) {
 		return {
 			listTracks: async ({ deviceId, sinceMs, untilMs, limit }) => {
-				await this.groupSealer?.sealWindow(deviceId, sinceMs, untilMs);
-				const groups = await stores.groupStore.listOverlapping({
-					deviceId,
-					sinceMs,
-					untilMs,
-					limit
-				});
 				const windowTracks = await stores.trackStore.queryHistorical({
 					deviceId,
 					since: sinceMs,
@@ -58824,33 +59039,19 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 					projection: "slim",
 					limit: Math.max(limit, 2e3)
 				});
-				const trackById = new Map(windowTracks.map((t) => [t.trackId, t]));
 				const { minHits } = await this.resolveDeviceDetectionSensitivitySettings(deviceId);
-				const out = [];
-				for (const group of groups) {
-					const members = await stores.groupStore.listMembers(group.id);
-					const tracks = members.map((m) => trackById.get(m.trackId)).filter((t) => t !== void 0);
-					if (tracks.length === 0) continue;
-					const classes = [...new Set(tracks.flatMap((t) => [t.className, ...t.classes ?? []]))];
-					const zones = [...new Set(tracks.flatMap((t) => [...t.zonesVisited]))];
-					const importance = Math.max(0, ...tracks.map((t) => t.importance ?? 0));
-					const primary = tracks.reduce((best, t) => (t.importance ?? 0) > (best.importance ?? 0) ? t : best);
-					out.push({
-						trackId: group.id,
-						groupId: group.id,
-						memberTrackIds: members.map((m) => m.trackId),
-						deviceId,
-						className: primary.className,
-						firstSeen: group.openedAt,
-						lastSeen: group.closedAt,
-						importance,
-						zones,
-						classes,
-						...tracks.every((t) => t.closedReason === "stationary-promotion") ? { stationary: true } : {},
-						confirmed: tracks.some((t) => t.observations !== void 0 && t.observations >= minHits)
-					});
-				}
-				return out;
+				return windowTracks.map((t) => ({
+					trackId: t.trackId,
+					deviceId,
+					className: t.className,
+					firstSeen: t.firstSeen,
+					lastSeen: t.lastSeen,
+					zones: [...t.zonesVisited],
+					...t.importance !== void 0 ? { importance: t.importance } : {},
+					...t.classes !== void 0 && t.classes.length > 0 ? { classes: t.classes } : {},
+					...t.closedReason === "stationary-promotion" ? { stationary: true } : {},
+					confirmed: t.observations !== void 0 && t.observations >= minHits
+				}));
 			},
 			listMediaInfo: async (id) => {
 				const group = await stores.groupStore.get(id);
@@ -59845,6 +60046,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 			refreshGallery: () => {
 				this.plateRecognizer?.refreshGallery();
 			},
+			eventMediaBaseUrl: () => this.eventMediaBaseUrl,
 			emitPlateGalleryChanged: (payload) => this.emitPlateGalleryChanged(payload)
 		});
 		return [
@@ -60333,6 +60535,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 			deviceId,
 			tracked: result.tracked,
 			packageClasses,
+			packageZoneIds: collectPackageZoneIds(proxy?.state.zoneRules.value?.package ?? []),
 			settings: packageSettings,
 			frameWidth: result.frameWidth,
 			frameHeight: result.frameHeight,
@@ -60900,7 +61103,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 		if (!first) return;
 		const lifeMs = track.lastSeen - track.firstSeen;
 		const moved = netDisplacementPx(track.positions ?? []);
-		if (!isShortMotionlessTrack(lifeMs, moved)) {
+		if (!isShortMotionlessTrack(lifeMs, moved, track.className)) {
 			this.phantomCells?.noteMovingClose({
 				deviceId: track.deviceId,
 				className: track.className,
@@ -61018,6 +61221,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 					}, d.score, d.label, frame.timestamp);
 					if (this.plateRecognizer) {
 						const mediaSettings = await this.resolveDeviceMediaSettings(deviceId);
+						const body = this.residents.bestSeenBbox(trackId);
 						await this.plateRecognizer.observePlateRead({
 							deviceId,
 							trackId,
@@ -61033,7 +61237,13 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 							frameWidth: frame.frameWidth,
 							frameHeight: frame.frameHeight,
 							cropPadding: mediaSettings.cropPadding,
-							...frame.frameHandle !== void 0 ? { frameHandle: frame.frameHandle } : {}
+							...frame.frameHandle !== void 0 ? { frameHandle: frame.frameHandle } : {},
+							...body !== void 0 ? { bodyBbox: {
+								x: body.x,
+								y: body.y,
+								w: body.w,
+								h: body.h
+							} } : {}
 						});
 					}
 				}
@@ -61334,6 +61544,51 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 			}
 		}).catch(() => {})));
 	}
+	/**
+	* A face or plate crop just landed from a still-live handle. Fill the
+	* missing parent rungs — person/vehicle thumbnail (display crop, same
+	* surface that produced the detail) and native keyFrame — so Events never
+	* has a child crop without a body and a scene.
+	*/
+	requestTrackHierarchy(input) {
+		ensureTrackHierarchyMedia({
+			isThumbnailLanded: (trackId) => this.residents.isThumbnailLanded(trackId),
+			isKeyFrameLanded: (trackId) => this.residents.keyFrameCapture(trackId).landed,
+			captureBodyThumbnail: (req) => this.captureHierarchyBodyThumbnail(req),
+			captureKeyFrame: async (req) => {
+				await this.persistKeyFrames(req.deviceId, req.timestamp, [{
+					trackId: req.trackId,
+					retry: false
+				}], req.frameHandle);
+			}
+		}, input);
+	}
+	async captureHierarchyBodyThumbnail(input) {
+		const displayCrop = this.captureDisplayCropFn;
+		const mediaStore = this.mediaStore;
+		if (!displayCrop || !mediaStore) return;
+		await this.captureScheduler.request({
+			deviceId: input.deviceId,
+			trackId: input.trackId,
+			kind: "thumbnail",
+			coalesceKey: captureCoalesceKey(input.deviceId, "thumbnail", `${input.trackId}:hierarchy`),
+			staleAfterMs: ENRICHMENT_CAPTURE_STALE_MS,
+			exec: async () => {
+				if (this.residents.isThumbnailLanded(input.trackId)) return;
+				const jpeg = await displayCrop(input.frameHandle, input.bodyBbox, input.frameWidth, input.frameHeight, input.cropPadding, input.trackId);
+				if (!jpeg) return;
+				await mediaStore.put({
+					deviceId: input.deviceId,
+					ownerKind: "track",
+					ownerId: input.trackId,
+					kind: "thumbnail",
+					timestamp: input.timestamp,
+					data: jpeg
+				});
+				this.residents.markThumbnailLanded(input.deviceId, input.trackId);
+			}
+		}).catch(() => {});
+	}
 	/** Attribution-time SEMANTIC best-shot promotion (D-semantic-bestshot,
 	*  2026-08-21; see `pipeline/semantic-promotion.ts`): offer a frame from
 	*  which a recognition SUCCEEDED to the best-frame ranking with the
@@ -62047,25 +62302,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 	}
 	/** Hub-only: assign this sighting in RAM. First activity on a camera
 	*  replays 2 minutes of that camera (crash recover), then observe is sync. */
-	enqueueLiveGroup(track, now) {
-		if (!this.isPostProcessingNode || !this.groupLive) return;
-		const deviceId = track.deviceId;
-		const snapshot = toGroupableTrack(track);
-		if (this.groupLive.isPrimed(deviceId)) {
-			this.groupLive.observe(snapshot, now);
-			return;
-		}
-		const next = (this.groupObserveTail.get(deviceId) ?? Promise.resolve()).then(async () => {
-			if (this.groupLive && this.groupSealer && !this.groupLive.isPrimed(deviceId)) await this.groupSealer.recoverCamera(deviceId, this.groupLive);
-			this.groupLive?.observe(snapshot, now);
-		}).catch((err) => {
-			this.ctx.logger.warn("group live observe failed", {
-				tags: { deviceId },
-				meta: { error: String(err) }
-			});
-		});
-		this.groupObserveTail.set(deviceId, next);
-	}
+	enqueueLiveGroup(track, now) {}
 	/** Unified retention (Phase 1): earliest retained footage per device — the
 	*  follow-recordings cutoff source. Cached 10 min: availability answers in
 	*  ~70 ms but the sweep asks once per device per pass. `null` = no footage
@@ -62511,7 +62748,9 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 	runPackageStillness(input) {
 		if (this.packageDropDetector === null) return;
 		const tags = { deviceId: input.deviceId };
-		for (const t of input.tracked) if (!input.packageClasses.has(t.className)) {
+		for (const t of input.tracked) {
+			if (input.packageClasses.has(t.className)) continue;
+			if (!isDelivererInPackageZone(t.zones, input.packageZoneIds)) continue;
 			this.lastNonPackageActivityAt.set(input.deviceId, input.timestamp);
 			break;
 		}
@@ -62558,6 +62797,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 			frameWidth: input.frameWidth,
 			frameHeight: input.frameHeight,
 			timestamp: input.timestamp,
+			minHits: input.settings.packageDropMinFrames,
 			minDwellMs: input.settings.packageDropDwellSec * 1e3,
 			activityWindowMs: input.settings.packageDropActivityWindowSec * 1e3,
 			...lastActivityAt !== void 0 ? { lastActivityAt } : {}
@@ -62661,9 +62901,10 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 		for (const ex of outcome.expired) {
 			const observedDwellMs = ex.lastSeenAt - ex.firstSeenAt;
 			const requiredDwellMs = input.settings.packageDropDwellSec * 1e3;
+			const requiredHits = input.settings.packageDropMinFrames;
 			const reasons = [];
 			if (!ex.activityBackedAtOpen) reasons.push("no-activity-before-open");
-			if (ex.rounds < 2) reasons.push("rounds");
+			if (ex.hits < requiredHits) reasons.push("hits");
 			if (observedDwellMs < requiredDwellMs) reasons.push("dwell");
 			this.ctx.logger.info("package candidate expired without promotion", {
 				tags,
@@ -62671,8 +62912,8 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 					candidateId: ex.id,
 					className: ex.className,
 					bbox: ex.bbox,
-					rounds: ex.rounds,
-					minRounds: 2,
+					hits: ex.hits,
+					minHits: requiredHits,
 					observedDwellMs,
 					requiredDwellMs,
 					activityBackedAtOpen: ex.activityBackedAtOpen,
@@ -62853,15 +63094,11 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 	* applies to the very next frame even when frames stop briefly
 	* (e.g. during binding flips).
 	*
-	* RECONCILE: the push channel behind `subscribe` (`device.state-changed`
-	* via `live.onEvent`) does not reliably reach a forked addon child — a
-	* zone created AFTER the proxy's cold read stayed invisible until the
-	* addon respawned (live-diagnosed on device 617, 2026-07-16: zone slice
-	* populated hub-side, `zones: []` in every snapshot). Events are lossy
-	* telemetry (D8); the durable channel is RPC + reconcile — so each
-	* proxy also refreshes its two slices on a slow timer. `refresh()`
-	* round-trips `deviceState.getCapSlice` and fans out through the SAME
-	* subscribe callbacks above, so a zone edit lands within one interval.
+	* RECONCILE: the push channel behind `subscribe` is `device.state-changed`
+	* via the addon's `ctx.eventBus` (`createEventBusSliceSource`). That
+	* declares UDS interest so the parent actually fans the slice here. Events
+	* remain lossy (D8); `refresh()` round-trips `deviceState.getCapSlice` on
+	* this timer as the backstop.
 	*/
 	async ensureProxy(deviceId) {
 		const cached = this.proxies.get(deviceId);
@@ -62934,6 +63171,15 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 	async listRecentTracks(input) {
 		return this.queryFacade.listRecentTracks(input);
 	}
+	async listGroups(input) {
+		return {
+			groups: [],
+			nextCursor: null
+		};
+	}
+	async getGroup(input) {
+		return null;
+	}
 	/**
 	* Every event kind the device can produce: built-ins (motion + audio),
 	* detection classes actually observed on the device, and sensor kinds
@@ -64078,33 +64324,38 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 	buildFaceRescoreActionHandlers() {
 		return { "face.rescoreTrack": (input) => this.rescoreFaceForTrack(input) };
 	}
-	buildGroupActionHandlers() {
-		const ports = () => {
-			const groupStore = this.groupStore;
-			if (groupStore === null) return null;
-			return {
-				groupStore,
-				loadTrack: async (trackId) => {
-					const tracks = this.trackStore;
-					if (!tracks) return null;
-					return tracks.getActiveByTrack(trackId) ?? await tracks.getPersistedByTrackId(trackId);
-				},
-				eventMediaBaseUrl: () => this.eventMediaBaseUrl
-			};
+	groupQueryPorts() {
+		const groupStore = this.groupStore;
+		if (groupStore === null) return null;
+		return {
+			groupStore,
+			loadTracks: async (trackIds) => {
+				const map = /* @__PURE__ */ new Map();
+				const tracks = this.trackStore;
+				if (!tracks || trackIds.length === 0) return map;
+				const missing = [];
+				for (const id of trackIds) {
+					const active = tracks.getActiveByTrack(id);
+					if (active !== null) map.set(id, trackToLite(active));
+					else missing.push(id);
+				}
+				if (missing.length === 0) return map;
+				for (const persisted of await tracks.getPersistedByTrackIds(missing)) map.set(persisted.trackId, trackToLite(persisted));
+				return map;
+			},
+			eventMediaBaseUrl: () => this.eventMediaBaseUrl
 		};
+	}
+	buildGroupActionHandlers() {
 		return {
 			"analytics.listGroups": async (input) => {
-				const ready = ports();
-				if (ready === null) return {
+				return {
 					groups: [],
 					hasMore: false
 				};
-				return listGroupRecords(ready, input);
 			},
 			"analytics.getGroup": async (input) => {
-				const ready = ports();
-				if (ready === null) return { group: null };
-				return { group: await getGroupDetail(ready, input.groupId) };
+				return { group: null };
 			}
 		};
 	}
@@ -64778,14 +65029,11 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 	async readEventThumbnail(id, preferKind) {
 		const eventFiles = await (this.mediaStore?.listByOwner("event", id) ?? Promise.resolve([]));
 		if (preferKind !== void 0 && preferKind.length > 0) {
-			const trackFiles = await (this.mediaStore?.listByOwner("track", id) ?? Promise.resolve([]));
-			const ownerTrackId = trackFiles.length === 0 ? await (this.eventStore?.getTrackIdForEvent(id) ?? Promise.resolve(null)) : null;
-			const owningTrackFiles = ownerTrackId === null ? [] : await (this.mediaStore?.listByOwner("track", ownerTrackId) ?? Promise.resolve([]));
-			const chosen = resolveCropForcedMedia([
-				...eventFiles,
-				...trackFiles,
-				...owningTrackFiles
-			], (files) => pickCleanMedia(files, preferKind));
+			const layers = await collectCropForcedMedia({
+				listByOwner: (ownerKind, ownerId) => this.mediaStore?.listByOwner(ownerKind, ownerId) ?? Promise.resolve([]),
+				getTrackIdForEvent: (eventId) => this.eventStore?.getTrackIdForEvent(eventId) ?? Promise.resolve(null)
+			}, id);
+			const chosen = resolveCropForcedMedia(layers.bodyFiles, (files) => pickCleanMedia(files, preferKind), layers.detailFiles);
 			if (!chosen) return null;
 			return {
 				bytes: Buffer.from(chosen.base64, "base64"),