@camstack/addon-post-analysis 1.2.631 → 1.2.633

package/dist/pipeline-analytics/index.js

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_clip_model_registry = require("../clip-model-registry-BgsEOah6.js");
+const require_clip_model_registry = require("../clip-model-registry-CeNmplcH.js");
 let node_fs = require("node:fs");
 node_fs = require_clip_model_registry.__toESM(node_fs, 1);
 let node_path = require("node:path");
@@ -25,6 +25,66 @@ let node_http = require("node:http");
 let node_https = require("node:https");
 let node_timers_promises = require("node:timers/promises");
 let node_buffer = require("node:buffer");
+//#region src/shared/display-palette-painter.ts
+var REFRESH_MS = 3e4;
+function isRecord$5(value) {
+	return typeof value === "object" && value !== null;
+}
+function isPaletteQueryApi(value) {
+	if (!("displayPalette" in value)) return false;
+	const cap = value.displayPalette;
+	if (!isRecord$5(cap) || !("getPalette" in cap)) return false;
+	const method = cap.getPalette;
+	if (!isRecord$5(method) || typeof method.query !== "function") return false;
+	return true;
+}
+/** `getPalette` when the cap is mounted. Otherwise a rejection the painter logs. */
+function readDisplayPalette(api) {
+	if (!isPaletteQueryApi(api)) return Promise.reject(/* @__PURE__ */ new Error("display-palette capability is not mounted"));
+	return api.displayPalette.getPalette.query();
+}
+function createDisplayPalettePainter(read, logger) {
+	let ready = require_clip_model_registry.bundledCamstack();
+	let announced = false;
+	let refreshing = false;
+	let fetchedAt = 0;
+	const say = (reason) => {
+		if (announced) return;
+		announced = true;
+		logger.warn("painting the bundled CamStack preset", { meta: { reason } });
+	};
+	const refresh = () => {
+		refreshing = true;
+		read().then((value) => {
+			const parsed = require_clip_model_registry.paletteResultSchema.safeParse(value);
+			if (!parsed.success) {
+				ready = require_clip_model_registry.bundledCamstack();
+				say("palette read did not match the schema");
+				return;
+			}
+			if (parsed.data.status === "unknown") {
+				ready = require_clip_model_registry.bundledCamstack();
+				say(parsed.data.reason);
+				return;
+			}
+			ready = parsed.data;
+			announced = false;
+		}).catch((err) => {
+			ready = require_clip_model_registry.bundledCamstack();
+			say(err instanceof Error ? err.message : String(err));
+		}).finally(() => {
+			fetchedAt = Date.now();
+			refreshing = false;
+		});
+	};
+	refresh();
+	const paint = (kind) => {
+		if (Date.now() - fetchedAt >= REFRESH_MS && !refreshing) refresh();
+		return require_clip_model_registry.paintHex(ready.swatches, ready.fallbacks, kind);
+	};
+	return { paint };
+}
+//#endregion
 //#region src/notification-center/alarm/alarm-mode-coverage.ts
 /**
 * Whether the panel just BECAME armed, in the sense a person means.
@@ -69174,6 +69234,7 @@ function isUsableBbox(bbox) {
 }
 //#endregion
 //#region src/pipeline-analytics/services/event-media-dispatcher.ts
+var BUNDLED_PALETTE$1 = require_clip_model_registry.bundledCamstack();
 /**
 * Long-side cap (px) for the boxed timeline tiles — `firstFrame`, `snapshot`,
 * `lastFrame`. These are the low-res "timeline filmstrip" images: a native full
@@ -69496,7 +69557,7 @@ var EventMediaDispatcher = class {
 			lastFrameWritten: false
 		};
 		let scene = null;
-		if (sn.appendSnapshot || sn.rollingLastFrame) scene = await this.boxedTimelineFrame(deviceId, frameHandle, frameData, fw, fh, sn.trackId, sn.bbox, sn.label);
+		if (sn.appendSnapshot || sn.rollingLastFrame) scene = await this.boxedTimelineFrame(deviceId, frameHandle, frameData, fw, fh, sn.trackId, sn.bbox, sn.label, sn.className);
 		let stored = null;
 		if (sn.appendSnapshot && scene) {
 			await this.writeSceneTwin(deviceId, sn.trackId, sn.timestamp, scene.clean, "append");
@@ -69713,7 +69774,17 @@ var EventMediaDispatcher = class {
 	* second fetch and no second decode (D654). `null` only if a sharp encode
 	* throws.
 	*/
-	async boxedTimelineFrame(deviceId, frameHandle, frameData, fw, fh, ownerId, bbox, label) {
+	/** Stroke a timeline box in the class's palette colour. No class keeps the drawer's default. */
+	paletteBox(box, className) {
+		if (className === void 0 || className.length === 0) return box;
+		const paint = this.deps.paintClass;
+		const color = paint !== void 0 ? paint(className) : require_clip_model_registry.paintHex(BUNDLED_PALETTE$1.swatches, BUNDLED_PALETTE$1.fallbacks, className);
+		return {
+			...box,
+			color
+		};
+	}
+	async boxedTimelineFrame(deviceId, frameHandle, frameData, fw, fh, ownerId, bbox, label, className) {
 		let nf = null;
 		let nfJpeg = null;
 		let fetchThrew = false;
@@ -69733,7 +69804,7 @@ var EventMediaDispatcher = class {
 		}
 		try {
 			if (nfJpeg && nfJpeg.width > 0 && nfJpeg.height > 0) {
-				const box = scaleBox(bbox, fw, fh, nfJpeg.width, nfJpeg.height, label);
+				const box = this.paletteBox(scaleBox(bbox, fw, fh, nfJpeg.width, nfJpeg.height, label), className);
 				const opts = { quality: MEDIA_QUALITY };
 				const [boxed, clean] = await Promise.all([drawBoxedJpeg(nfJpeg.jpeg, nfJpeg.width, nfJpeg.height, [box], opts), drawBoxedJpeg(nfJpeg.jpeg, nfJpeg.width, nfJpeg.height, [], opts)]);
 				return {
@@ -69742,7 +69813,7 @@ var EventMediaDispatcher = class {
 				};
 			}
 			if (nf && nf.format === "rgb" && nf.width > 0 && nf.height > 0) {
-				const box = scaleBox(bbox, fw, fh, nf.width, nf.height, label);
+				const box = this.paletteBox(scaleBox(bbox, fw, fh, nf.width, nf.height, label), className);
 				const opts = { quality: MEDIA_QUALITY };
 				const [boxed, clean] = await Promise.all([drawBoxedFrame(nf.data, nf.width, nf.height, [box], opts), drawBoxedFrame(nf.data, nf.width, nf.height, [], opts)]);
 				return {
@@ -69758,10 +69829,10 @@ var EventMediaDispatcher = class {
 					shmId: frameHandle.shmId
 				}
 			});
-			const box = {
+			const box = this.paletteBox({
 				...bbox,
 				...label ? { label } : {}
-			};
+			}, className);
 			const opts = {
 				quality: MEDIA_QUALITY,
 				maxWidth: SNAPSHOT_MAX_WIDTH
@@ -69834,7 +69905,7 @@ var EventMediaDispatcher = class {
 		}
 	}
 	async writeTrackFrame(deviceId, frameHandle, frameData, fw, fh, tf) {
-		const scene = await this.boxedTimelineFrame(deviceId, frameHandle, frameData, fw, fh, tf.trackId, tf.bbox, tf.label);
+		const scene = await this.boxedTimelineFrame(deviceId, frameHandle, frameData, fw, fh, tf.trackId, tf.bbox, tf.label, tf.className);
 		if (!scene) return false;
 		await this.writeSceneTwin(deviceId, tf.trackId, tf.timestamp, scene.clean, "append");
 		try {
@@ -82522,8 +82593,9 @@ function unmeasuredEpisode(input) {
 	});
 	const parts = parseConsumableSubject(input.subject);
 	if (parts !== null && parts.legacy) {
-		const attention = input.detail === "full" ? "full" : "low";
-		const form = providerFormFromDetail(input.detail);
+		const parsed = parseProviderVerdictDetail(input.detail);
+		const attention = parsed?.attention ?? "low";
+		const form = parsed?.form ?? "tank";
 		return incomingFromProviderConsumableBand({
 			facts,
 			deviceId,
@@ -82552,9 +82624,43 @@ function unmeasuredEpisode(input) {
 	});
 	return null;
 }
-function providerFormFromDetail(detail) {
-	if (detail === "full") return "bin";
-	return "tank";
+var PROVIDER_DETAIL_FORMS = [
+	"part",
+	"tank",
+	"product",
+	"bin"
+];
+function isConsumableForm(value) {
+	return PROVIDER_DETAIL_FORMS.some((known) => known === value);
+}
+/** Durable `detail` for a provider-verdict episode: band plus form (D934). */
+function providerVerdictDetail(band, form) {
+	return `${band}:${form}`;
+}
+function parseProviderVerdictDetail(detail) {
+	if (detail === "low") return {
+		attention: "low",
+		form: "tank"
+	};
+	if (detail === "full") return {
+		attention: "full",
+		form: "bin"
+	};
+	if (detail === void 0) return null;
+	const sep = detail.indexOf(":");
+	if (sep < 1) return null;
+	const attention = detail.slice(0, sep);
+	const form = detail.slice(sep + 1);
+	if (attention !== "low" && attention !== "full") return null;
+	if (!isConsumableForm(form)) return null;
+	return {
+		attention,
+		form
+	};
+}
+/** True when the row is a provider-verdict consumable, not a threshold episode. */
+function isProviderVerdictDetail(detail) {
+	return parseProviderVerdictDetail(detail) !== null;
 }
 function openAlertOf(row, input) {
 	const parts = parseConsumableSubject(row.subject);
@@ -82823,7 +82929,7 @@ var NcDeviceAlerts = class {
 			},
 			attention,
 			identity: this.deps.lookup(deviceId)
-		}), band === "normal" ? void 0 : band);
+		}), band === "normal" ? void 0 : providerVerdictDetail(band, sliceItem.form));
 	}
 	/**
 	* Has this provider band held long enough to move its episode? A band that
@@ -83023,6 +83129,7 @@ var NcDeviceAlerts = class {
 		for (const row of this.deps.rows.all()) {
 			const parts = parseConsumableSubject(row.subject);
 			if (parts === null || thresholds.includes(parts.thresholdPercent)) continue;
+			if (parts.legacy && isProviderVerdictDetail(row.detail)) continue;
 			absent.add(parts.thresholdPercent);
 			if (this.absentThresholds.has(parts.thresholdPercent)) this.dropRow(row.subject, "retired — no rule judges consumables at this threshold (D642)");
 		}
@@ -86902,6 +87009,14 @@ function toPixels(box, width, height) {
 		h: Math.max(1, Math.min(Math.round(box.h * height), height - y))
 	};
 }
+var BUNDLED_PALETTE = require_clip_model_registry.bundledCamstack();
+function bundledPaint(kind) {
+	return require_clip_model_registry.paintHex(BUNDLED_PALETTE.swatches, BUNDLED_PALETTE.fallbacks, kind);
+}
+function boxStroke(box, paint) {
+	if (box?.className !== void 0 && box.className.length > 0) return (paint ?? bundledPaint)(box.className);
+	return box?.role === "other" ? NC_IMAGE_OTHER_COLOR : NC_IMAGE_SUBJECT_COLOR;
+}
 /** {@link notificationOverlay}'s SVG alone. */
 function notificationOverlaySvg(input) {
 	return notificationOverlay(input).svg;
@@ -86923,9 +87038,10 @@ function notificationOverlay(input) {
 		const points = zone.map((p) => `${String(clampPx(p.x * width, width))},${String(clampPx(p.y * height, height))}`).join(" ");
 		parts.push(`<polygon data-role="zone" points="${points}" fill="${NC_IMAGE_ZONE_COLOR}" fill-opacity="0.18" stroke="${NC_IMAGE_ZONE_COLOR}" stroke-width="${String(strokes.other)}" stroke-dasharray="${String(strokes.subject * 2)},${String(strokes.subject)}"/>`);
 	}
+	const pathColor = boxStroke(input.boxes.find((b) => b.role === "subject"), input.paintClass);
 	for (const run of input.paths ?? []) {
 		if (run.length < 2) continue;
-		parts.push(`<polyline data-role="subject-path" points="${require_clip_model_registry.subjectPathSvgPoints(run, width, height)}" fill="none" stroke="${NC_IMAGE_SUBJECT_COLOR}" stroke-width="${String(strokes.subject)}" stroke-linejoin="round" stroke-linecap="round" stroke-opacity="0.9"/>`);
+		parts.push(`<polyline data-role="subject-path" points="${require_clip_model_registry.subjectPathSvgPoints(run, width, height)}" fill="none" stroke="${pathColor}" stroke-width="${String(strokes.subject)}" stroke-linejoin="round" stroke-linecap="round" stroke-opacity="0.9"/>`);
 	}
 	const ordered = [...input.boxes.filter((b) => b.role === "other"), ...input.boxes.filter((b) => b.role === "subject")];
 	const layout = layoutBoxLabels({
@@ -86937,7 +87053,7 @@ function notificationOverlay(input) {
 	const plates = [];
 	ordered.forEach((box, i) => {
 		const subject = box.role === "subject";
-		const color = subject ? NC_IMAGE_SUBJECT_COLOR : NC_IMAGE_OTHER_COLOR;
+		const color = boxStroke(box, input.paintClass);
 		const stroke = subject ? strokes.subject : strokes.other;
 		parts.push(`<rect data-role="${box.role}" x="${String(box.x)}" y="${String(box.y)}" width="${String(box.w)}" height="${String(box.h)}" fill="none" stroke="${color}" stroke-width="${String(stroke)}"/>`);
 		const plate = layout.placements[i];
@@ -87106,11 +87222,13 @@ async function renderNotificationImage(req) {
 		...toPixels(o, outW, outH),
 		role: "other",
 		label: o.label,
-		...o.confidence !== void 0 ? { score: o.confidence } : {}
+		...o.confidence !== void 0 ? { score: o.confidence } : {},
+		...o.className !== void 0 ? { className: o.className } : {}
 	})), ...req.subject !== null ? [{
 		...toPixels(req.subject, outW, outH),
 		role: "subject",
-		label: req.subject.label
+		label: req.subject.label,
+		...req.subject.className !== void 0 ? { className: req.subject.className } : {}
 	}] : []] : [];
 	const zones = req.mode === "crop" ? [] : req.zones;
 	const paths = require_clip_model_registry.projectSubjectPath(req.path ?? [], {
@@ -87131,7 +87249,8 @@ async function renderNotificationImage(req) {
 			height: outH,
 			boxes,
 			zones,
-			paths
+			paths,
+			...req.paintClass !== void 0 ? { paintClass: req.paintClass } : {}
 		});
 		if (boxes.length > 0) labels = overlay.labels;
 		pipeline = pipeline.composite([{
@@ -87218,7 +87337,8 @@ var NcNotificationImageStage = class {
 		const path = withPath ? this.subjectPath(input, trail) : [];
 		const subject = subjectBox !== null ? {
 			...subjectBox,
-			label: imageLabelText(payload.subject.label ?? payload.subject.className, payload.subject.confidence)
+			label: imageLabelText(payload.subject.label ?? payload.subject.className, payload.subject.confidence),
+			className: payload.subject.className
 		} : null;
 		const othersDrawn = mode === "scene-boxes" ? otherTracks(await this.tracksAt(camera, source.timestamp), subjectTrackId, subjectBox, payload.subject.className) : [];
 		if (mode === "scene-boxes") this.deps.logger.info("scene-boxes: other boxes drawn", {
@@ -87233,6 +87353,7 @@ var NcNotificationImageStage = class {
 		const others = mode === "scene-boxes" ? othersDrawn.map((t) => ({
 			...t.bbox,
 			label: imageLabelText(t.label ?? t.className, t.confidence),
+			className: t.className,
 			...t.confidence !== void 0 ? { confidence: t.confidence } : {}
 		})) : [];
 		if (mode !== "crop" && input.withSubject && payload.mediaShowTriggerZone === true && payload.matchedZoneIds === void 0) this.deps.logger.info("trigger zone not drawn — the row never froze which zone fired", {
@@ -87251,7 +87372,8 @@ var NcNotificationImageStage = class {
 				subject,
 				others,
 				zones,
-				...path.length > 0 ? { path } : {}
+				...path.length > 0 ? { path } : {},
+				...this.deps.paintClass !== void 0 ? { paintClass: this.deps.paintClass } : {}
 			});
 			const reason = image.rendered === mode ? void 0 : mode === "crop" ? "no-subject-box" : "no-tracks-at-instant";
 			if (reason !== void 0) this.reportFallback(input, mode, reason);
@@ -87584,7 +87706,8 @@ var NcDispatcher = class {
 			now: this.now,
 			...deps.getSubjectTrail !== void 0 ? { getSubjectTrail: deps.getSubjectTrail } : {},
 			...deps.getTracksAt !== void 0 ? { getTracksAt: deps.getTracksAt } : {},
-			...deps.getZonePolygons !== void 0 ? { getZonePolygons: deps.getZonePolygons } : {}
+			...deps.getZonePolygons !== void 0 ? { getZonePolygons: deps.getZonePolygons } : {},
+			...deps.paintClass !== void 0 ? { paintClass: deps.paintClass } : {}
 		});
 	}
 	/**
@@ -109939,6 +110062,7 @@ var BuildNotificationCenter = class extends BuildNotificationCenterBase {
 						y: pt.y
 					})));
 				},
+				paintClass: createDisplayPalettePainter(() => readDisplayPalette(api), logger.child("DisplayPalette")).paint,
 				renderEventMedia: (req) => this.renderEventMedia(req),
 				cutRecordedClip: (req) => this.cutNotificationRecordedClip(req),
 				deriveGifFromClip: (req) => deriveRecordedGif(buildRecordedGifPorts({
@@ -120490,7 +120614,8 @@ var SnapshotTargetPlanner = class {
 				trackId: t.trackId,
 				timestamp,
 				bbox: firstFrameRetryBbox(t.bbox, this.trackStore?.peekActive(t.trackId)?.positions[0]?.bbox),
-				...patchDisplayLabel(t.labelPatch) !== void 0 ? { label: patchDisplayLabel(t.labelPatch) } : {}
+				...patchDisplayLabel(t.labelPatch) !== void 0 ? { label: patchDisplayLabel(t.labelPatch) } : {},
+				className: t.className
 			});
 		}
 		return retries;
@@ -120688,6 +120813,7 @@ var SnapshotTargetPlanner = class {
 				timestamp,
 				bbox: { ...t.bbox },
 				...patchDisplayLabel(t.labelPatch) !== void 0 ? { label: patchDisplayLabel(t.labelPatch) } : {},
+				className: t.className,
 				appendSnapshot: plan.appendSnapshot,
 				rollingLastFrame,
 				bestThumbnail,
@@ -123119,6 +123245,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 			getParkedSubjectSlab: (deviceId, trackId) => this.mediaCapture.fetchParkedSubjectSlab(deviceId, trackId),
 			mediaStore: stores.mediaStore,
 			logger: logger.child("EventMediaDispatcher"),
+			paintClass: createDisplayPalettePainter(() => readDisplayPalette(api), logger.child("DisplayPalette")).paint,
 			onSubjectCropMiss: (deviceId, trackId, reason) => this.residents.notePreviewCaptureMiss(deviceId, trackId, `thumbnail:${reason}`)
 		});
 		this.buildRecognizers(api, logger, stores, transport);