@camstack/addon-post-analysis 1.2.2 → 1.2.3

package/dist/{dist-DSP-cVM0.js → dist-Ck79MtSp.js}

@@ -16708,7 +16708,8 @@ var MediaFileKindEnum = _enum([
 	"faceCrop",
 	"plateCrop",
 	"keyFrame",
-	"keyFrameSmall"
+	"keyFrameSmall",
+	"thumbnailSmall"
 ]);
 var MediaFileSchema = object({
 	key: string(),

package/dist/{dist-Bu9eXObI.mjs → dist-gQ5DHTYd.mjs}

@@ -16686,7 +16686,8 @@ var MediaFileKindEnum = _enum([
 	"faceCrop",
 	"plateCrop",
 	"keyFrame",
-	"keyFrameSmall"
+	"keyFrameSmall",
+	"thumbnailSmall"
 ]);
 var MediaFileSchema = object({
 	key: string(),

package/dist/embedding-encoder/index.js

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-DSP-cVM0.js");
+const require_dist = require("../dist-Ck79MtSp.js");
 let node_fs = require("node:fs");
 let node_fs$1 = require_dist.__toESM(node_fs, 1);
 node_fs = require_dist.__toESM(node_fs);

package/dist/embedding-encoder/index.mjs

@@ -1,4 +1,4 @@
-import { b as BaseAddon, f as hfModelUrl, u as embeddingEncoderCapability } from "../dist-Bu9eXObI.mjs";
+import { b as BaseAddon, f as hfModelUrl, u as embeddingEncoderCapability } from "../dist-gQ5DHTYd.mjs";
 import { createRequire } from "node:module";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";

package/dist/{node-DtSEvIXU.js → node-C4bKtLou.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-DSP-cVM0.js");
+const require_dist = require("./dist-Ck79MtSp.js");
 let node_fs = require("node:fs");
 node_fs = require_dist.__toESM(node_fs, 1);
 let node_path = require("node:path");

package/dist/pipeline-analytics/{_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-2w2j7Rm4.mjs → _virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-C4dWm6ZL.mjs}

@@ -3,7 +3,7 @@ import "./dist-CYZr2fwk.mjs";
 var e = {
 	"@camstack/sdk": {
 		name: "@camstack/sdk",
-		version: "1.2.2",
+		version: "1.2.3",
 		scope: ["default"],
 		loaded: !1,
 		from: "addon_pipeline_analytics_widgets",
@@ -18,7 +18,7 @@ var e = {
 	},
 	"@camstack/types": {
 		name: "@camstack/types",
-		version: "1.2.2",
+		version: "1.2.3",
 		scope: ["default"],
 		loaded: !1,
 		from: "addon_pipeline_analytics_widgets",
@@ -33,7 +33,7 @@ var e = {
 	},
 	"@camstack/ui-library": {
 		name: "@camstack/ui-library",
-		version: "1.2.2",
+		version: "1.2.3",
 		scope: ["default"],
 		loaded: !1,
 		from: "addon_pipeline_analytics_widgets",

package/dist/pipeline-analytics/{hostInit-CTQ8-sg-.mjs → hostInit-3T15bdHA.mjs}

@@ -36,7 +36,7 @@ async function r() {
 				}
 			},
 			"@camstack/types": {
-				version: "1.2.2",
+				version: "1.2.3",
 				scope: "default",
 				shareConfig: {
 					singleton: !0,
@@ -45,7 +45,7 @@ async function r() {
 				}
 			},
 			"@camstack/sdk": {
-				version: "1.2.2",
+				version: "1.2.3",
 				scope: "default",
 				shareConfig: {
 					singleton: !0,
@@ -81,7 +81,7 @@ async function r() {
 				}
 			},
 			"@camstack/ui-library": {
-				version: "1.2.2",
+				version: "1.2.3",
 				scope: "default",
 				shareConfig: {
 					singleton: !0,

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-DSP-cVM0.js");
+const require_dist = require("../dist-Ck79MtSp.js");
 let node_crypto = require("node:crypto");
 let sharp = require("sharp");
 sharp = require_dist.__toESM(sharp);
@@ -4497,6 +4497,7 @@ var SINGLE_INSTANCE_KINDS = new Set([
 	"keyFrame",
 	"keyFrameSmall",
 	"thumbnail",
+	"thumbnailSmall",
 	"firstFrame",
 	"lastFrame"
 ]);
@@ -6477,6 +6478,76 @@ function squareSafeCropRegionNormalized(bbox, frame, padding) {
 	};
 }
 //#endregion
+//#region src/shared/frame/square-subject-crop.ts
+/** Expansion factor applied to the bbox long side to frame the subject with a
+*  little breathing room (operator choice: ×1.2). */
+var SQUARE_SUBJECT_CROP_EXPANSION = 1.2;
+/**
+* Compute a SQUARE crop region in PIXEL space around the subject bbox.
+*
+* Algorithm:
+*   1. center: cx = x + w/2, cy = y + h/2
+*   2. side = max(w, h) × SQUARE_SUBJECT_CROP_EXPANSION
+*   3. clamp side to fit the frame: side = min(side, W, H) — a square can never
+*      exceed the frame's SHORT edge (this is the "subject bigger than the
+*      frame's short side" case)
+*   4. center-and-clamp the origin so the square stays fully inside the frame
+*   5. round to integer pixels
+*
+* The returned region fully contains the bbox whenever the bbox itself fits in a
+* square of the frame's short side (always true for real detections).
+*/
+function squareSubjectCropRegion(bbox, frame) {
+	const { W, H } = frame;
+	const cx = bbox.x + bbox.w / 2;
+	const cy = bbox.y + bbox.h / 2;
+	const longerSide = Math.max(bbox.w, bbox.h);
+	const side = Math.min(longerSide * SQUARE_SUBJECT_CROP_EXPANSION, W, H);
+	const rawX0 = cx - side / 2;
+	const rawY0 = cy - side / 2;
+	const x0 = Math.max(0, Math.min(rawX0, W - side));
+	const y0 = Math.max(0, Math.min(rawY0, H - side));
+	return {
+		x: Math.round(x0),
+		y: Math.round(y0),
+		w: Math.round(side),
+		h: Math.round(side)
+	};
+}
+/**
+* The same SQUARE region as {@link squareSubjectCropRegion}, expressed in
+* NORMALIZED [0,1]×[0,1] coordinates. A normalized box maps DIRECTLY onto a
+* native-resolution surface of the SAME aspect ratio, so the region computed
+* from the detection-frame dimensions addresses the exact same ROI on the
+* runner's retained native frame. Reuses the pixel geometry verbatim (single
+* source of truth) and divides by the frame dimensions.
+*/
+function squareSubjectCropRegionNormalized(bbox, frame) {
+	const region = squareSubjectCropRegion(bbox, frame);
+	return {
+		x: region.x / frame.W,
+		y: region.y / frame.H,
+		w: region.w / frame.W,
+		h: region.h / frame.H
+	};
+}
+/**
+* Derive the `thumbnailSmall` JPEG from an already-encoded native subject-crop
+* JPEG. Downscales to at most {@link THUMBNAIL_SMALL_MAX_WIDTH} on the long side
+* (aspect preserved). If the native crop's long side is already ≤ the cap, the
+* ORIGINAL buffer is returned unchanged (store as-is, never upscale, no wasted
+* re-encode).
+*/
+async function deriveThumbnailSmall(nativeJpeg) {
+	const meta = await (0, sharp.default)(nativeJpeg).metadata();
+	const longSide = Math.max(meta.width ?? 0, meta.height ?? 0);
+	if (longSide > 0 && longSide <= 480) return nativeJpeg;
+	return (0, sharp.default)(nativeJpeg).resize(480, 480, {
+		fit: "inside",
+		withoutEnlargement: true
+	}).jpeg({ quality: 88 }).toBuffer();
+}
+//#endregion
 //#region src/shared/frame/box-drawer.ts
 var DEFAULT_COLOR = require_dist.DEFAULT_EVENT_COLOR;
 var DEFAULT_QUALITY = 80;
@@ -6702,7 +6773,7 @@ var EventMediaDispatcher = class {
 		const storedSnapshots = [];
 		const thumbnailTrackIds = [];
 		for (const sn of snapshots) {
-			const res = await this.writeTrackSnapshot(deviceId, frameHandle, frameData, fw, fh, sn, input.cropPadding);
+			const res = await this.writeTrackSnapshot(deviceId, frameHandle, frameData, fw, fh, sn);
 			if (res.storedSnapshot) storedSnapshots.push(res.storedSnapshot);
 			if (res.thumbnailWritten) thumbnailTrackIds.push(sn.trackId);
 		}
@@ -6723,7 +6794,7 @@ var EventMediaDispatcher = class {
 	* failed). `thumbnailWritten` reports whether a best `thumbnail` actually
 	* landed this frame (#27-A) so the caller can stop forcing retries.
 	*/
-	async writeTrackSnapshot(deviceId, frameHandle, frameData, fw, fh, sn, cropPadding) {
+	async writeTrackSnapshot(deviceId, frameHandle, frameData, fw, fh, sn) {
 		if (!sn.appendSnapshot && !sn.rollingLastFrame && !sn.bestThumbnail) return {
 			storedSnapshot: null,
 			thumbnailWritten: false
@@ -6750,8 +6821,11 @@ var EventMediaDispatcher = class {
 		if (sn.rollingLastFrame && boxed) await this.replaceKind(deviceId, sn.trackId, "lastFrame", sn.timestamp, boxed);
 		let thumbnailWritten = false;
 		if (sn.bestThumbnail) {
-			const crop = await this.cropSubjectRegion(frameHandle, fw, fh, sn.bbox, cropPadding);
-			if (crop) thumbnailWritten = await this.replaceKind(deviceId, sn.trackId, "thumbnail", sn.timestamp, crop);
+			const variants = await this.cropSubjectVariants(frameHandle, fw, fh, sn.bbox);
+			if (variants) {
+				thumbnailWritten = await this.replaceKind(deviceId, sn.trackId, "thumbnail", sn.timestamp, variants.thumbnail);
+				await this.replaceKind(deviceId, sn.trackId, "thumbnailSmall", sn.timestamp, variants.thumbnailSmall);
+			}
 		}
 		return {
 			storedSnapshot: stored,
@@ -6801,6 +6875,54 @@ var EventMediaDispatcher = class {
 		}
 	}
 	/**
+	* The best-shot subject crop as its TWO persisted variants (best-crop
+	* fast-load, 2026-07-21). ONE native fetch: the SQUARE-framed subject ROI
+	* (side = max(w,h)×1.2, clamped to the frame — {@link squareSubjectCropRegionNormalized})
+	* is requested from the runner's retained native surface with NO `maxWidth`
+	* (uncapped TRUE native, decision #3) → the `thumbnail`. The `thumbnailSmall`
+	* is DERIVED by downscaling that SAME JPEG to the 480 long-side cap — never a
+	* second `getNativeCropJpeg`, never upscaled ({@link deriveThumbnailSmall}
+	* returns the native buffer as-is when it is already ≤ 480).
+	*
+	* NATIVE-OR-NOTHING: any miss/error (or a runner without the method) returns
+	* `null` after a loud `logger.warn`; the caller SKIPS the write and the
+	* per-frame retry lands a real native crop later. Never a local resize
+	* upscale of a ≤640 tile (a blurred lie).
+	*/
+	async cropSubjectVariants(frameHandle, fw, fh, bbox) {
+		if (!this.deps.getNativeCropJpeg) {
+			this.deps.logger.warn("native subject crop miss — will retry, no upscale", { meta: {
+				shmId: frameHandle.shmId,
+				reason: "no-native-cap"
+			} });
+			return null;
+		}
+		try {
+			const norm = squareSubjectCropRegionNormalized(bbox, {
+				W: fw,
+				H: fh
+			});
+			const native = await this.deps.getNativeCropJpeg(frameHandle, norm);
+			if (!native) {
+				this.deps.logger.warn("native subject crop miss — will retry, no upscale", { meta: {
+					shmId: frameHandle.shmId,
+					reason: "native-miss"
+				} });
+				return null;
+			}
+			return {
+				thumbnail: native,
+				thumbnailSmall: await deriveThumbnailSmall(native)
+			};
+		} catch (err) {
+			this.deps.logger.warn("native subject crop miss — will retry, no upscale", { meta: {
+				shmId: frameHandle.shmId,
+				error: err instanceof Error ? err.message : String(err)
+			} });
+			return null;
+		}
+	}
+	/**
 	* The boxed timeline tile (`firstFrame`/`snapshot`/`lastFrame`): the track's
 	* OWN box burned onto the NATIVE full frame downscaled to
 	* {@link SNAPSHOT_MAX_WIDTH}. On a native miss it falls back to the ≤640
@@ -11997,10 +12119,11 @@ 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: best `thumbnail` → rolling `lastFrame` → `firstFrame` →
-*  newest `snapshot` → any track blob. Undefined when the track owns no media. */
+*  KeyEvent path uses: `thumbnailSmall` (480 fast-load) → best `thumbnail` →
+*  rolling `lastFrame` → `firstFrame` → newest `snapshot` → any track blob.
+*  Undefined when the track owns no media. */
 function pickTrackFallbackMedia(files) {
-	return 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 === "lastFrame") ?? files.find((f) => f.kind === "firstFrame") ?? [...files].reverse().find((f) => f.kind === "snapshot") ?? files[files.length - 1];
 }
 /**
 * Resolve the default-path media for an event id: the event's own media when it
@@ -12416,7 +12539,7 @@ var PipelineAnalyticsAddon = class extends require_dist.BaseAddon {
 		let storage = this.ctx.kernel.storage;
 		const mediaRoot = process.env.CAMSTACK_MEDIA_ROOT?.trim();
 		if (mediaRoot) {
-			const { FilesystemStorageProvider } = await Promise.resolve().then(() => require("../node-DtSEvIXU.js"));
+			const { FilesystemStorageProvider } = await Promise.resolve().then(() => require("../node-C4bKtLou.js"));
 			storage = new FilesystemStorageProvider(mediaRoot);
 			logger.info("pipeline-analytics: event media rooted at CAMSTACK_MEDIA_ROOT", { meta: { mediaRoot } });
 		}

package/dist/pipeline-analytics/index.mjs

@@ -1,4 +1,4 @@
-import { C as hydrateSchema, D as object, E as number, O as string, S as createEvent, T as boolean, _ as videoclipsCapability, a as OpsLogEntrySchema, b as BaseAddon, c as buildEventKindDescriptor, d as faceGalleryCapability, g as subKindsOf, h as plateGalleryCapability, i as MACRO_LABELS, k as EventCategory, l as cosineSimilarity, m as pipelineAnalyticsCapability, n as EVENT_KIND_BY_CAP, o as addonWidgetsSourceCapability, p as nodePin, r as EVENT_PAD_MS, s as audioMetricsCapability, t as DEFAULT_EVENT_COLOR, v as zoneAnalyticsCapability, w as array, x as DeviceType, y as errMsg } from "../dist-Bu9eXObI.mjs";
+import { C as hydrateSchema, D as object, E as number, O as string, S as createEvent, T as boolean, _ as videoclipsCapability, a as OpsLogEntrySchema, b as BaseAddon, c as buildEventKindDescriptor, d as faceGalleryCapability, g as subKindsOf, h as plateGalleryCapability, i as MACRO_LABELS, k as EventCategory, l as cosineSimilarity, m as pipelineAnalyticsCapability, n as EVENT_KIND_BY_CAP, o as addonWidgetsSourceCapability, p as nodePin, r as EVENT_PAD_MS, s as audioMetricsCapability, t as DEFAULT_EVENT_COLOR, v as zoneAnalyticsCapability, w as array, x as DeviceType, y as errMsg } from "../dist-gQ5DHTYd.mjs";
 import { randomUUID } from "node:crypto";
 import sharp from "sharp";
 //#region src/pipeline-analytics/videoclips-provider.ts
@@ -4492,6 +4492,7 @@ var SINGLE_INSTANCE_KINDS = new Set([
 	"keyFrame",
 	"keyFrameSmall",
 	"thumbnail",
+	"thumbnailSmall",
 	"firstFrame",
 	"lastFrame"
 ]);
@@ -6472,6 +6473,76 @@ function squareSafeCropRegionNormalized(bbox, frame, padding) {
 	};
 }
 //#endregion
+//#region src/shared/frame/square-subject-crop.ts
+/** Expansion factor applied to the bbox long side to frame the subject with a
+*  little breathing room (operator choice: ×1.2). */
+var SQUARE_SUBJECT_CROP_EXPANSION = 1.2;
+/**
+* Compute a SQUARE crop region in PIXEL space around the subject bbox.
+*
+* Algorithm:
+*   1. center: cx = x + w/2, cy = y + h/2
+*   2. side = max(w, h) × SQUARE_SUBJECT_CROP_EXPANSION
+*   3. clamp side to fit the frame: side = min(side, W, H) — a square can never
+*      exceed the frame's SHORT edge (this is the "subject bigger than the
+*      frame's short side" case)
+*   4. center-and-clamp the origin so the square stays fully inside the frame
+*   5. round to integer pixels
+*
+* The returned region fully contains the bbox whenever the bbox itself fits in a
+* square of the frame's short side (always true for real detections).
+*/
+function squareSubjectCropRegion(bbox, frame) {
+	const { W, H } = frame;
+	const cx = bbox.x + bbox.w / 2;
+	const cy = bbox.y + bbox.h / 2;
+	const longerSide = Math.max(bbox.w, bbox.h);
+	const side = Math.min(longerSide * SQUARE_SUBJECT_CROP_EXPANSION, W, H);
+	const rawX0 = cx - side / 2;
+	const rawY0 = cy - side / 2;
+	const x0 = Math.max(0, Math.min(rawX0, W - side));
+	const y0 = Math.max(0, Math.min(rawY0, H - side));
+	return {
+		x: Math.round(x0),
+		y: Math.round(y0),
+		w: Math.round(side),
+		h: Math.round(side)
+	};
+}
+/**
+* The same SQUARE region as {@link squareSubjectCropRegion}, expressed in
+* NORMALIZED [0,1]×[0,1] coordinates. A normalized box maps DIRECTLY onto a
+* native-resolution surface of the SAME aspect ratio, so the region computed
+* from the detection-frame dimensions addresses the exact same ROI on the
+* runner's retained native frame. Reuses the pixel geometry verbatim (single
+* source of truth) and divides by the frame dimensions.
+*/
+function squareSubjectCropRegionNormalized(bbox, frame) {
+	const region = squareSubjectCropRegion(bbox, frame);
+	return {
+		x: region.x / frame.W,
+		y: region.y / frame.H,
+		w: region.w / frame.W,
+		h: region.h / frame.H
+	};
+}
+/**
+* Derive the `thumbnailSmall` JPEG from an already-encoded native subject-crop
+* JPEG. Downscales to at most {@link THUMBNAIL_SMALL_MAX_WIDTH} on the long side
+* (aspect preserved). If the native crop's long side is already ≤ the cap, the
+* ORIGINAL buffer is returned unchanged (store as-is, never upscale, no wasted
+* re-encode).
+*/
+async function deriveThumbnailSmall(nativeJpeg) {
+	const meta = await sharp(nativeJpeg).metadata();
+	const longSide = Math.max(meta.width ?? 0, meta.height ?? 0);
+	if (longSide > 0 && longSide <= 480) return nativeJpeg;
+	return sharp(nativeJpeg).resize(480, 480, {
+		fit: "inside",
+		withoutEnlargement: true
+	}).jpeg({ quality: 88 }).toBuffer();
+}
+//#endregion
 //#region src/shared/frame/box-drawer.ts
 var DEFAULT_COLOR = DEFAULT_EVENT_COLOR;
 var DEFAULT_QUALITY = 80;
@@ -6697,7 +6768,7 @@ var EventMediaDispatcher = class {
 		const storedSnapshots = [];
 		const thumbnailTrackIds = [];
 		for (const sn of snapshots) {
-			const res = await this.writeTrackSnapshot(deviceId, frameHandle, frameData, fw, fh, sn, input.cropPadding);
+			const res = await this.writeTrackSnapshot(deviceId, frameHandle, frameData, fw, fh, sn);
 			if (res.storedSnapshot) storedSnapshots.push(res.storedSnapshot);
 			if (res.thumbnailWritten) thumbnailTrackIds.push(sn.trackId);
 		}
@@ -6718,7 +6789,7 @@ var EventMediaDispatcher = class {
 	* failed). `thumbnailWritten` reports whether a best `thumbnail` actually
 	* landed this frame (#27-A) so the caller can stop forcing retries.
 	*/
-	async writeTrackSnapshot(deviceId, frameHandle, frameData, fw, fh, sn, cropPadding) {
+	async writeTrackSnapshot(deviceId, frameHandle, frameData, fw, fh, sn) {
 		if (!sn.appendSnapshot && !sn.rollingLastFrame && !sn.bestThumbnail) return {
 			storedSnapshot: null,
 			thumbnailWritten: false
@@ -6745,8 +6816,11 @@ var EventMediaDispatcher = class {
 		if (sn.rollingLastFrame && boxed) await this.replaceKind(deviceId, sn.trackId, "lastFrame", sn.timestamp, boxed);
 		let thumbnailWritten = false;
 		if (sn.bestThumbnail) {
-			const crop = await this.cropSubjectRegion(frameHandle, fw, fh, sn.bbox, cropPadding);
-			if (crop) thumbnailWritten = await this.replaceKind(deviceId, sn.trackId, "thumbnail", sn.timestamp, crop);
+			const variants = await this.cropSubjectVariants(frameHandle, fw, fh, sn.bbox);
+			if (variants) {
+				thumbnailWritten = await this.replaceKind(deviceId, sn.trackId, "thumbnail", sn.timestamp, variants.thumbnail);
+				await this.replaceKind(deviceId, sn.trackId, "thumbnailSmall", sn.timestamp, variants.thumbnailSmall);
+			}
 		}
 		return {
 			storedSnapshot: stored,
@@ -6796,6 +6870,54 @@ var EventMediaDispatcher = class {
 		}
 	}
 	/**
+	* The best-shot subject crop as its TWO persisted variants (best-crop
+	* fast-load, 2026-07-21). ONE native fetch: the SQUARE-framed subject ROI
+	* (side = max(w,h)×1.2, clamped to the frame — {@link squareSubjectCropRegionNormalized})
+	* is requested from the runner's retained native surface with NO `maxWidth`
+	* (uncapped TRUE native, decision #3) → the `thumbnail`. The `thumbnailSmall`
+	* is DERIVED by downscaling that SAME JPEG to the 480 long-side cap — never a
+	* second `getNativeCropJpeg`, never upscaled ({@link deriveThumbnailSmall}
+	* returns the native buffer as-is when it is already ≤ 480).
+	*
+	* NATIVE-OR-NOTHING: any miss/error (or a runner without the method) returns
+	* `null` after a loud `logger.warn`; the caller SKIPS the write and the
+	* per-frame retry lands a real native crop later. Never a local resize
+	* upscale of a ≤640 tile (a blurred lie).
+	*/
+	async cropSubjectVariants(frameHandle, fw, fh, bbox) {
+		if (!this.deps.getNativeCropJpeg) {
+			this.deps.logger.warn("native subject crop miss — will retry, no upscale", { meta: {
+				shmId: frameHandle.shmId,
+				reason: "no-native-cap"
+			} });
+			return null;
+		}
+		try {
+			const norm = squareSubjectCropRegionNormalized(bbox, {
+				W: fw,
+				H: fh
+			});
+			const native = await this.deps.getNativeCropJpeg(frameHandle, norm);
+			if (!native) {
+				this.deps.logger.warn("native subject crop miss — will retry, no upscale", { meta: {
+					shmId: frameHandle.shmId,
+					reason: "native-miss"
+				} });
+				return null;
+			}
+			return {
+				thumbnail: native,
+				thumbnailSmall: await deriveThumbnailSmall(native)
+			};
+		} catch (err) {
+			this.deps.logger.warn("native subject crop miss — will retry, no upscale", { meta: {
+				shmId: frameHandle.shmId,
+				error: err instanceof Error ? err.message : String(err)
+			} });
+			return null;
+		}
+	}
+	/**
 	* The boxed timeline tile (`firstFrame`/`snapshot`/`lastFrame`): the track's
 	* OWN box burned onto the NATIVE full frame downscaled to
 	* {@link SNAPSHOT_MAX_WIDTH}. On a native miss it falls back to the ≤640
@@ -11992,10 +12114,11 @@ 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: best `thumbnail` → rolling `lastFrame` → `firstFrame` →
-*  newest `snapshot` → any track blob. Undefined when the track owns no media. */
+*  KeyEvent path uses: `thumbnailSmall` (480 fast-load) → best `thumbnail` →
+*  rolling `lastFrame` → `firstFrame` → newest `snapshot` → any track blob.
+*  Undefined when the track owns no media. */
 function pickTrackFallbackMedia(files) {
-	return 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 === "lastFrame") ?? files.find((f) => f.kind === "firstFrame") ?? [...files].reverse().find((f) => f.kind === "snapshot") ?? files[files.length - 1];
 }
 /**
 * Resolve the default-path media for an event id: the event's own media when it

package/dist/pipeline-analytics/remoteEntry.js

@@ -30,7 +30,7 @@ async function d(e) {
 	}
 }
 async function f() {
-	return l ||= d(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-2w2j7Rm4.mjs")).catch((e) => {
+	return l ||= d(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-C4dWm6ZL.mjs")).catch((e) => {
 		throw l = void 0, e;
 	}), l;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-post-analysis",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "CamStack Post-Analysis bundle — enrichment, embedding-encoder, pipeline-analytics. Multi-entry npm package shipping addons that consume pipeline output.",
   "keywords": [
     "camstack",