@camstack/addon-post-analysis 1.2.661 → 1.2.663

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-RvEPUqvS.js");
+const require_clip_model_registry = require("../clip-model-registry-Cz8LWYwU.js");
 let node_fs = require("node:fs");
 node_fs = require_clip_model_registry.__toESM(node_fs, 1);
 let node_path = require("node:path");
@@ -8950,6 +8950,17 @@ var en_default = {
 	"detection.subject.identity": "{{label}}",
 	"detection.subject.plate": "{{classNoun}} {{label}}",
 	"detection.inZones": " in {{zones}}",
+	"appliance.finished.title": "{{device}} finished",
+	"appliance.finished.body": "{{device}} finished{{afterDuration}}{{usedEnergy}}",
+	"appliance.finished.duration": " after {{duration}}",
+	"appliance.finished.energy": " and used {{energy}}",
+	"appliance.duration.minutes": {
+		"one": "{{minutes}} minute",
+		"other": "{{minutes}} minutes"
+	},
+	"appliance.duration.hours": "{{hours}} h",
+	"appliance.duration.hoursMinutes": "{{hours}} h {{minutes}} min",
+	"appliance.energy.value": "{{value}} kWh",
 	"class.person": {
 		"one": "person",
 		"other": "people"
@@ -9356,6 +9367,17 @@ var it_default = {
 	"detection.subject.identity": "{{label}}",
 	"detection.subject.plate": "{{classNoun}} {{label}}",
 	"detection.inZones": " in {{zones}}",
+	"appliance.finished.title": "{{device}} ha terminato",
+	"appliance.finished.body": "{{device}} ha terminato{{afterDuration}}{{usedEnergy}}",
+	"appliance.finished.duration": " dopo {{duration}}",
+	"appliance.finished.energy": " e ha consumato {{energy}}",
+	"appliance.duration.minutes": {
+		"one": "{{minutes}} minuto",
+		"other": "{{minutes}} minuti"
+	},
+	"appliance.duration.hours": "{{hours}} h",
+	"appliance.duration.hoursMinutes": "{{hours}} h {{minutes}} min",
+	"appliance.energy.value": "{{value}} kWh",
 	"class.person": {
 		"one": "persona",
 		"other": "persone"
@@ -68703,6 +68725,109 @@ function createAnalyticsWidgetsProvider() {
 	] };
 }
 //#endregion
+//#region src/notification-center/appliance-cycle.ts
+var NC_UNKNOWN_CYCLE_FACTS = {
+	durationMs: null,
+	energyKwh: null
+};
+var NC_EMPTY_CYCLE_VARS = {
+	duration: "",
+	energy: "",
+	afterDuration: "",
+	usedEnergy: ""
+};
+/** `52 minutes` / `1 h 12 min` / `2 h`; `''` below one minute (never "0 minutes"). */
+function durationText(texts, durationMs) {
+	if (durationMs === null || !Number.isFinite(durationMs)) return "";
+	const totalMinutes = Math.round(durationMs / 6e4);
+	if (totalMinutes < 1) return "";
+	if (totalMinutes < 60) return texts.text({
+		key: "appliance.duration.minutes",
+		count: totalMinutes,
+		vars: { minutes: `${totalMinutes}` }
+	});
+	const hours = Math.floor(totalMinutes / 60);
+	const minutes = totalMinutes % 60;
+	return minutes === 0 ? texts.text({
+		key: "appliance.duration.hours",
+		vars: { hours: `${hours}` }
+	}) : texts.text({
+		key: "appliance.duration.hoursMinutes",
+		vars: {
+			hours: `${hours}`,
+			minutes: `${minutes}`
+		}
+	});
+}
+/** `0,84 kWh` (it) / `0.84 kWh` (en); `''` when unmeasured. */
+function energyText(texts, energyKwh) {
+	if (energyKwh === null || !Number.isFinite(energyKwh) || energyKwh < 0) return "";
+	const value = energyKwh.toLocaleString(texts.language, {
+		minimumFractionDigits: 2,
+		maximumFractionDigits: 2
+	});
+	return texts.text({
+		key: "appliance.energy.value",
+		vars: { value }
+	});
+}
+/** The four variables of a finished cycle, fragments rendered from scalars only. */
+function ncApplianceCycleVars(texts, facts) {
+	const duration = durationText(texts, facts.durationMs);
+	const energy = energyText(texts, facts.energyKwh);
+	return {
+		duration,
+		energy,
+		afterDuration: duration === "" ? "" : texts.text({
+			key: "appliance.finished.duration",
+			vars: { duration }
+		}),
+		usedEnergy: energy === "" ? "" : texts.text({
+			key: "appliance.finished.energy",
+			vars: { energy }
+		})
+	};
+}
+/**
+* The frozen reference a FINISHED appliance cycle row carries (`{}` for every
+* other row): kind `appliance-cycle`, edge `cleared`. The appliance is the
+* sensor itself — a linked camera is only where the row was attributed.
+*/
+function applianceCycleOf(subject) {
+	if (subject.sensorKind !== "appliance-cycle" || subject.sensorRaised !== false) return {};
+	return { applianceCycle: { deviceId: subject.linkedSensorId ?? subject.sourceDeviceId ?? subject.deviceId } };
+}
+//#endregion
+//#region src/notification-center/appliance-cycle-runs.ts
+var CYCLE_FACTS_WAIT_MS = 3e3;
+var CYCLE_FACTS_POLL_MS = 250;
+/** A closed run belongs to this finish when it ended within this much of it. */
+var CYCLE_RUN_MATCH_MS = 10 * 6e4;
+function factsOfClosed(run, finishedAtMs) {
+	if (run.endedAt === null || Math.abs(run.endedAt - finishedAtMs) > CYCLE_RUN_MATCH_MS) return NC_UNKNOWN_CYCLE_FACTS;
+	return {
+		durationMs: run.durationMs,
+		energyKwh: run.detail.energyKwh
+	};
+}
+function applianceCycleFactsFromRuns(ports) {
+	return async ({ deviceId, finishedAtMs }) => {
+		let waited = 0;
+		for (;;) {
+			const run = await ports.newestRun(deviceId);
+			if (run === null) return NC_UNKNOWN_CYCLE_FACTS;
+			if (run.state === "closed") return factsOfClosed(run, finishedAtMs);
+			if (run.startedAt > finishedAtMs) return NC_UNKNOWN_CYCLE_FACTS;
+			if (waited >= CYCLE_FACTS_WAIT_MS) return {
+				durationMs: finishedAtMs - run.startedAt,
+				energyKwh: null
+			};
+			await ports.sleep(CYCLE_FACTS_POLL_MS);
+			waited += CYCLE_FACTS_POLL_MS;
+		}
+	};
+}
+//#endregion
 //#region src/pipeline-analytics/runtime/wire-subscriptions.ts
 /**
 * Every category the Notification Center's system-event intake can turn into a
@@ -70664,6 +70789,8 @@ Object.freeze({
 		"page": 1,
 		"pageSize": 50
 	} },
+	"device-runs": { "listRuns": { "limit": 50 } },
+	"fan-presets": { "capturePreset": { "steps": [] } },
 	"llm": { "upsertProfile": { "profile": { "__nested__": {
 		"timeoutMs": 6e4,
 		"connectTimeoutMs": 1e4,
@@ -70904,6 +71031,10 @@ Object.freeze({
 			"speed": 2
 		}
 	},
+	"system": { "debugWatch": {
+		"channels": [],
+		"deviceIds": []
+	} },
 	"terminal-session": { "pullOutput": { "waitMs": 0 } },
 	"training": {
 		"planJob": { "selection": { "__nested__": { "workState": "complete" } } },
@@ -70950,6 +71081,7 @@ Object.freeze({
 	],
 	"device-removal-hook": ["listDeviceData"],
 	"failure-contribution": ["list"],
+	"integration-instances": ["listInstances"],
 	"llm": [
 		"getDefaults",
 		"getUsage",
@@ -70991,6 +71123,7 @@ Object.freeze({
 		"listSupportedEntityKinds",
 		"unexposeEntity"
 	],
+	"integration-instances": ["testInstance"],
 	"log-destination": [
 		"cancelRead",
 		"describeRead",
@@ -85089,6 +85222,9 @@ async function renderMosaic(request, logger) {
 * one composition are decisions about the set, and none of them belongs in a
 * shelf that photographs one camera for an absence.
 *
+* A SLEEPING battery camera is woken by one forced capture when the rule leaves
+* it allowed (D998) — bounded, once per gap per camera, never by a poll.
+*
 * Two reads can only ever ADD a camera back, never take one away on their own
 * failure (D49): a wrapper-state read (run in parallel with the capture) that
 * misses or throws keeps the tile, and a freshness read that misses or throws
@@ -85102,6 +85238,15 @@ var NC_LINKED_CAMERA_PREFIX = "nc-linked:";
 function isLinkedStillId(id) {
 	return id.startsWith(NC_LINKED_MOSAIC_PREFIX) || id.startsWith(NC_LINKED_CAMERA_PREFIX);
 }
+/**
+* D998 — the one forced capture that wakes a sleeping battery camera for a
+* sensor notification: the bound it may take, the pause between re-polls of a
+* camera another wake already started, and the gap per camera before it is
+* woken again (a flapping contact must not drain a battery).
+*/
+var NC_LINKED_WAKE_CAPTURE_TIMEOUT_MS = 15e3;
+var NC_LINKED_WAKE_POLL_MS = 1e3;
+var NC_LINKED_WAKE_MIN_GAP_MS = 6e4;
 /** Per camera — the marker's own bound (`SENSOR_MARKER_SNAPSHOT_TIMEOUT_MS`). */
 var SENSOR_LINKED_CAPTURE_TIMEOUT_MS = 2500;
 /** The capture-free wrapper-state read, per camera. It runs IN PARALLEL with
@@ -85134,11 +85279,14 @@ var NcLinkedStillShelf = class {
 	deps;
 	sets = /* @__PURE__ */ new Map();
 	owners = /* @__PURE__ */ new Map();
+	/** setId → when its in-flight wake gives up (the dispatcher waits that long). */
+	pendingWakes = /* @__PURE__ */ new Map();
+	lastWakeAt = /* @__PURE__ */ new Map();
 	constructor(deps) {
 		this.deps = deps;
 	}
 	/** SYNCHRONOUS: the evaluation that follows names these owners. */
-	captureSet(sensorId, cameraIds, atMs) {
+	captureSet(sensorId, cameraIds, atMs, options = { wakeSleeping: false }) {
 		const now = this.deps.now();
 		this.prune(now);
 		const setId = (0, node_crypto.randomUUID)();
@@ -85166,7 +85314,7 @@ var NcLinkedStillShelf = class {
 				camera: cameraId
 			});
 		});
-		this.run(setId, stills, atMs, now).catch((err) => {
+		this.run(setId, stills, atMs, now, options).catch((err) => {
 			this.deps.logger.warn("sensor notification pictures failed — it ships text-only", {
 				tags: { deviceId: sensorId },
 				meta: { error: String(err) }
@@ -85174,6 +85322,15 @@ var NcLinkedStillShelf = class {
 		});
 		return stills;
 	}
+	/**
+	* While a wake of one of this owner's cameras is in flight: the instant it
+	* gives up (its bound plus one poll). `undefined` otherwise — the dispatcher
+	* then keeps its ordinary still-wait.
+	*/
+	pendingUntil(ownerId) {
+		const ref = this.owners.get(ownerId);
+		return ref === void 0 ? void 0 : this.pendingWakes.get(ref.setId);
+	}
 	/** `undefined` = not an owner this shelf minted (or pruned); `[]` = nothing (yet). */
 	get(ownerId) {
 		const ref = this.owners.get(ownerId);
@@ -85195,20 +85352,37 @@ var NcLinkedStillShelf = class {
 	clear() {
 		this.sets.clear();
 		this.owners.clear();
+		this.pendingWakes.clear();
 	}
-	async run(setId, stills, atMs, startedAt) {
-		const results = await Promise.all(stills.cameraIds.map((id) => this.captureOne(id, startedAt)));
+	async run(setId, stills, atMs, startedAt, options) {
+		const ctx = {
+			setId,
+			sensorId: stills.sensorId,
+			startedAt,
+			options
+		};
+		let results;
+		try {
+			results = await Promise.all(stills.cameraIds.map((id) => this.captureOne(id, ctx)));
+		} finally {
+			this.pendingWakes.delete(setId);
+		}
 		const judged = await this.judgeFreshness(stills.sensorId, results, atMs);
 		for (const r of judged) this.logTile(stills.sensorId, r);
 		const landed = judged.filter(isLandedTile);
 		const composed = await this.compose(stills.sensorId, landed, atMs);
 		const undrawable = landed.length - composed.drawn;
+		const woken = judged.filter((r) => r.woken === true).map((r) => r.cameraId);
 		this.deps.logger.info(composed.mosaic.length === 0 ? "sensor notification has no linked picture — it ships text-only" : "sensor notification pictures ready", {
 			tags: { deviceId: stills.sensorId },
 			meta: {
 				cameras: stills.cameraIds.length,
 				landed: composed.drawn,
 				...undrawable > 0 ? { undrawable } : {},
+				...woken.length > 0 ? {
+					woken,
+					waitedMs: this.deps.now() - startedAt
+				} : {},
 				dropped: Object.fromEntries(judged.filter((r) => r.outcome !== "landed").map((r) => [String(r.cameraId), r.outcome])),
 				tookMs: this.deps.now() - startedAt
 			}
@@ -85221,21 +85395,25 @@ var NcLinkedStillShelf = class {
 			mosaic: composed.mosaic
 		});
 	}
-	async captureOne(cameraId, startedAt) {
-		const took = () => this.deps.now() - startedAt;
+	async captureOne(cameraId, ctx) {
+		const took = () => this.deps.now() - ctx.startedAt;
 		if (this.deps.isOnline(cameraId) === false) return {
 			cameraId,
 			outcome: "excluded",
 			reason: "offline",
 			tookMs: took()
 		};
-		const [verdict, capture] = await Promise.all([this.wrapperVerdict(cameraId), this.captureStill(cameraId)]);
-		if (verdict.reason !== null) return {
+		const [verdict, capture] = await Promise.all([this.wrapperVerdict(cameraId), this.captureStill(cameraId, false, SENSOR_LINKED_CAPTURE_TIMEOUT_MS)]);
+		const excluded = (reason) => ({
 			cameraId,
 			outcome: "excluded",
-			reason: verdict.reason,
+			reason,
 			tookMs: took()
-		};
+		});
+		if (verdict.reason === "sleeping") return this.wakeOne(cameraId, ctx);
+		if (verdict.reason === "waking" && ctx.options.wakeSleeping) return this.awaitWaking(cameraId, ctx);
+		if (verdict.reason === "unreachable" && ctx.options.wakeSleeping) return excluded("wake-skipped:unreachable");
+		if (verdict.reason !== null) return excluded(verdict.reason);
 		return {
 			cameraId,
 			...capture,
@@ -85243,9 +85421,84 @@ var NcLinkedStillShelf = class {
 			tookMs: took()
 		};
 	}
-	async captureStill(cameraId) {
+	/** D998: one forced capture, by the rule's leave, at most once per gap per camera. */
+	async wakeOne(cameraId, ctx) {
+		const took = () => this.deps.now() - ctx.startedAt;
+		const skipped = (reason) => ({
+			cameraId,
+			outcome: "excluded",
+			reason,
+			tookMs: took()
+		});
+		if (!ctx.options.wakeSleeping) return skipped("wake-skipped:policy");
+		const last = this.lastWakeAt.get(cameraId);
+		if (last !== void 0 && ctx.startedAt - last < NC_LINKED_WAKE_MIN_GAP_MS) return skipped("wake-skipped:recent-wake");
+		this.lastWakeAt.set(cameraId, ctx.startedAt);
+		this.markPending(ctx);
+		this.deps.logger.info("linked battery camera woken for the sensor notification", {
+			tags: { deviceId: cameraId },
+			meta: {
+				sensorId: ctx.sensorId,
+				ruleIds: ctx.options.ruleIds ?? [],
+				boundMs: NC_LINKED_WAKE_CAPTURE_TIMEOUT_MS
+			}
+		});
+		const capture = await this.captureStill(cameraId, true, NC_LINKED_WAKE_CAPTURE_TIMEOUT_MS);
+		return {
+			cameraId,
+			...this.asWakeResult(capture),
+			woken: true,
+			tookMs: took()
+		};
+	}
+	/** A camera another wake already started: never forced, re-polled within the bound. */
+	async awaitWaking(cameraId, ctx) {
+		const took = () => this.deps.now() - ctx.startedAt;
+		this.markPending(ctx);
+		const polls = Math.floor(NC_LINKED_WAKE_CAPTURE_TIMEOUT_MS / NC_LINKED_WAKE_POLL_MS);
+		for (let i = 0; i < polls; i++) {
+			await new Promise((resolve) => setTimeout(resolve, NC_LINKED_WAKE_POLL_MS));
+			const verdict = await this.wrapperVerdict(cameraId);
+			if (verdict.reason === "waking") continue;
+			if (verdict.reason !== null) return {
+				cameraId,
+				outcome: "excluded",
+				reason: verdict.reason,
+				tookMs: took()
+			};
+			const capture = await this.captureStill(cameraId, false, SENSOR_LINKED_CAPTURE_TIMEOUT_MS);
+			return {
+				cameraId,
+				...this.asWakeResult(capture),
+				woken: true,
+				tookMs: took()
+			};
+		}
+		return {
+			cameraId,
+			outcome: "wake-timeout",
+			woken: true,
+			tookMs: took()
+		};
+	}
+	markPending(ctx) {
+		const until = ctx.startedAt + NC_LINKED_WAKE_CAPTURE_TIMEOUT_MS + NC_LINKED_WAKE_POLL_MS;
+		this.pendingWakes.set(ctx.setId, Math.max(this.pendingWakes.get(ctx.setId) ?? 0, until));
+	}
+	/** A wake that brought nothing back names itself, not the generic `empty`. */
+	asWakeResult(capture) {
+		if (capture.outcome === "timeout") return {
+			...capture,
+			outcome: "wake-timeout"
+		};
+		return capture.outcome === "empty" || capture.outcome === "error" && capture.reason !== "undecodable" ? {
+			...capture,
+			outcome: "wake-refused"
+		} : capture;
+	}
+	async captureStill(cameraId, force, timeoutMs) {
 		try {
-			const shot = await withTimeout$2(this.deps.getSnapshot(cameraId), SENSOR_LINKED_CAPTURE_TIMEOUT_MS, "snapshot cap");
+			const shot = await withTimeout$2(force ? this.deps.getSnapshot(cameraId, { force: true }) : this.deps.getSnapshot(cameraId), timeoutMs, "snapshot cap");
 			if (shot === null || shot.base64.length === 0) return { outcome: "empty" };
 			const jpeg = await this.decodableStill(Buffer.from(shot.base64, "base64"));
 			if (jpeg === null) return {
@@ -86804,6 +87057,13 @@ var NC_RECORDED_FOOTAGE_WAIT_MS = 3e4;
 var NC_STILL_WAIT_MS = 3e3;
 var NC_STILL_WAIT_INTERVAL_MS = 500;
 /**
+* D998 — the longest a sensor notification holds for a linked battery camera
+* that is being woken (`stillDeadline`). A `sent` row is final, so the picture
+* cannot follow the push: it is waited for here, bounded, or never attached.
+* Owners with no wake in flight keep {@link NC_STILL_WAIT_MS}.
+*/
+var NC_LINKED_WAKE_WAIT_MS = 15e3;
+/**
 * How far a still's OWN instant may sit from the trigger and still count as
 * being ABOUT the trigger, for a `delivery: 'immediate'` rule.
 *
@@ -87772,6 +88032,36 @@ var NcDispatcher = class {
 		});
 	}
 	/**
+	* The facts of a finished appliance cycle; unknown on every other row and on
+	* any failure (a part that cannot be read is omitted, never a blocked send).
+	*/
+	async applianceCycleFacts(entry) {
+		const subject = entry.payload.subject;
+		const resolve = this.deps.resolveApplianceCycleFacts;
+		const deviceId = subject.applianceCycle?.deviceId;
+		if (resolve === void 0 || deviceId === void 0) return NC_UNKNOWN_CYCLE_FACTS;
+		try {
+			const facts = await resolve({
+				deviceId,
+				finishedAtMs: subject.timestamp
+			});
+			if (facts.durationMs === null || facts.energyKwh === null) this.deps.logger.debug("appliance cycle part omitted — unknown", {
+				tags: { deviceId },
+				meta: {
+					duration: facts.durationMs === null ? "unknown" : "known",
+					energy: facts.energyKwh === null ? "unknown" : "known"
+				}
+			});
+			return facts;
+		} catch (err) {
+			this.deps.logger.debug("appliance cycle facts failed — parts omitted", {
+				tags: { deviceId },
+				meta: { error: err instanceof Error ? err.message : String(err) }
+			});
+			return NC_UNKNOWN_CYCLE_FACTS;
+		}
+	}
+	/**
 	* Builds the notification AND returns the artefact ids its media resolve
 	* indexed — see {@link withArtifactUrls}. A tuple rather than a field on
 	* `NcNotificationInput`: the ids are internal (outbox provenance), never
@@ -87783,7 +88073,8 @@ var NcDispatcher = class {
 		const deviceName = await notificationDeviceName(entry, this.deps.getDeviceName);
 		const alarmSource = systemEvent?.alarmSource;
 		const zoneLabels = systemEvent === void 0 ? await resolveZoneLabels(this.deps.getZoneNames, subject.deviceId, subject.zones) : alarmSource?.zones !== void 0 && alarmSource.zones.length > 0 ? await resolveZoneLabels(this.deps.getZoneNames, alarmSource.deviceId, alarmSource.zones) : [];
-		const vars = buildTemplateVars(this.texts, entry, deviceName, zoneLabels);
+		const cycleFacts = await this.applianceCycleFacts(entry);
+		const vars = buildTemplateVars(this.texts, entry, deviceName, zoneLabels, void 0, cycleFacts);
 		this.warnDeprecatedVars(entry);
 		const systemCount = systemEvent?.textCount !== void 0 ? { count: systemEvent.textCount } : {};
 		const title = renderRowTitle(this.texts, entry, vars);
@@ -87989,7 +88280,15 @@ var NcDispatcher = class {
 		const firstLook = groupTiles !== null ? null : await this.resolveAttachment(entry, canStillGainMedia(entry) ? "trigger-only" : "any");
 		const footagePending = this.renderFootage(entry);
 		const mosaic = groupView !== void 0 && groupTiles !== null ? await this.groupedMosaic(entry, groupView, groupTiles) : null;
-		const still = mosaic !== null ? mosaic.attachment : firstLook !== null || entry.payload.media === "none" ? firstLook : await this.waitForStill(entry);
+		let waitedMs = 0;
+		let still;
+		if (mosaic !== null) still = mosaic.attachment;
+		else if (firstLook !== null || entry.payload.media === "none") still = firstLook;
+		else {
+			const waited = await this.waitForStill(entry);
+			still = waited.still;
+			waitedMs = waited.waitedMs;
+		}
 		const grouped = groupView !== void 0 && groupMembers !== null ? {
 			windowKey: groupView.key,
 			members: groupView.members.length,
@@ -88014,6 +88313,7 @@ var NcDispatcher = class {
 				recordKind: entry.recordKind,
 				recordId: entry.recordId,
 				policy: entry.payload.media,
+				waitedMs,
 				...entry.payload.mediaImage !== void 0 ? { image: entry.payload.mediaImage } : {},
 				...memberTrackIds.length > 1 ? { memberTrackIds } : {},
 				owners: [...entry.payload.subject.eventId !== void 0 ? [`object:${entry.payload.subject.eventId}`] : [], ...entry.payload.subject.trackId !== void 0 ? [`track:${entry.payload.subject.trackId}`] : []]
@@ -88040,7 +88340,13 @@ var NcDispatcher = class {
 		const subject = entry.payload.subject;
 		const out = [];
 		for (const { ownerId, cameraId } of subject.extraStills ?? []) {
-			const file = await this.linkedStillFile(entry, ownerId, cameraId);
+			let file = await this.linkedStillFile(entry, ownerId, cameraId);
+			for (let polls = 0; file === void 0 && polls < NC_LINKED_WAKE_WAIT_MS / NC_STILL_WAIT_INTERVAL_MS; polls += 1) {
+				const deadline = this.deps.stillDeadline?.(ownerId);
+				if (deadline === void 0 || this.now() >= deadline) break;
+				await this.sleep(NC_STILL_WAIT_INTERVAL_MS);
+				file = await this.linkedStillFile(entry, ownerId, cameraId);
+			}
 			const bytes = file === void 0 ? null : decodeStillBytes(file.base64);
 			if (file === void 0 || bytes === null) {
 				this.deps.logger.info("linked camera picture missing at send — skipped", {
@@ -88527,11 +88833,19 @@ var NcDispatcher = class {
 	*/
 	async waitForStill(entry) {
 		const subject = entry.payload.subject;
-		if (this.now() - subject.timestamp > NC_STILL_WAIT_MAX_AGE_MS) return this.resolveAttachment(entry, "any");
-		if (subject.eventId === void 0 && subject.trackId === void 0) return null;
-		const attempts = Math.floor(NC_STILL_WAIT_MS / NC_STILL_WAIT_INTERVAL_MS);
-		for (let i = 0; i < attempts; i += 1) {
+		if (this.now() - subject.timestamp > NC_STILL_WAIT_MAX_AGE_MS) return {
+			still: await this.resolveAttachment(entry, "any"),
+			waitedMs: 0
+		};
+		if (subject.eventId === void 0 && subject.trackId === void 0) return {
+			still: null,
+			waitedMs: 0
+		};
+		const startedAt = this.now();
+		let waitedMs = 0;
+		for (let i = 0; waitedMs < this.stillWaitBoundMs(entry, startedAt); i += 1) {
 			await this.sleep(NC_STILL_WAIT_INTERVAL_MS);
+			waitedMs += NC_STILL_WAIT_INTERVAL_MS;
 			const still = await this.resolveAttachment(entry, "trigger-only");
 			if (still !== null) {
 				this.deps.logger.info("the still landed during the bounded wait", {
@@ -88543,10 +88857,32 @@ var NcDispatcher = class {
 						kind: still.name
 					}
 				});
-				return still;
+				return {
+					still,
+					waitedMs
+				};
 			}
 		}
-		return this.resolveAttachment(entry, "any");
+		return {
+			still: await this.resolveAttachment(entry, "any"),
+			waitedMs
+		};
+	}
+	/**
+	* How long this row's still poll may run: {@link NC_STILL_WAIT_MS}, or — while
+	* the shelf says a linked camera of this row is being woken — until that
+	* wake gives up, at most {@link NC_LINKED_WAKE_WAIT_MS} (D998).
+	*/
+	stillWaitBoundMs(entry, startedAt) {
+		const subject = entry.payload.subject;
+		const owners = [...subject.trackId !== void 0 ? [subject.trackId] : [], ...(subject.extraStills ?? []).map((extra) => extra.ownerId)];
+		let deadline;
+		for (const ownerId of owners) {
+			const until = this.deps.stillDeadline?.(ownerId);
+			if (until !== void 0 && (deadline === void 0 || until > deadline)) deadline = until;
+		}
+		if (deadline === void 0) return NC_STILL_WAIT_MS;
+		return Math.max(NC_STILL_WAIT_MS, Math.min(NC_LINKED_WAKE_WAIT_MS, deadline - startedAt));
 	}
 	/**
 	* The grouped MOSAIC (D692 §6.2): one tile per member, at most
@@ -88694,8 +89030,8 @@ var NcDispatcher = class {
 			return ts !== void 0 && this.now() - ts <= NC_STILL_WAIT_MAX_AGE_MS;
 		});
 		await look("trigger-only", pollable());
-		const attempts = Math.floor(NC_STILL_WAIT_MS / NC_STILL_WAIT_INTERVAL_MS);
-		for (let i = 0; i < attempts && pollable().length > 0; i += 1) {
+		const startedAt = this.now();
+		for (let waited = 0; waited < this.stillWaitBoundMs(entry, startedAt) && pollable().length > 0; waited += NC_STILL_WAIT_INTERVAL_MS) {
 			await this.sleep(NC_STILL_WAIT_INTERVAL_MS);
 			await look("trigger-only", pollable());
 		}
@@ -88950,7 +89286,7 @@ function systemEventParamsForTemplate(params) {
 	const { form: _form, attention: _attention, ...rest } = params;
 	return rest;
 }
-function buildTemplateVars(texts, entry, deviceName, zoneLabels, timeZone) {
+function buildTemplateVars(texts, entry, deviceName, zoneLabels, timeZone, cycle) {
 	const subject = entry.payload.subject;
 	const occupancy = subject.occupancy;
 	const systemEvent = subject.systemEvent;
@@ -88986,6 +89322,7 @@ function buildTemplateVars(texts, entry, deviceName, zoneLabels, timeZone) {
 		hitPercent: subject.audio?.hitPercent !== void 0 ? `${Math.round(subject.audio.hitPercent)}` : "",
 		db: subject.audio?.peakDbfs !== void 0 ? `${Math.round(subject.audio.peakDbfs)}` : "",
 		eventType: subject.eventType ?? "",
+		...cycle !== void 0 ? ncApplianceCycleVars(texts, cycle) : NC_EMPTY_CYCLE_VARS,
 		rule: entry.payload.ruleName,
 		count: occupancy !== void 0 ? `${occupancy.count}` : group !== void 0 && group.members.length > 1 ? `${group.members.length}` : "",
 		capacity: occupancy !== void 0 ? `${occupancy.capacity}` : "",
@@ -89012,6 +89349,7 @@ function bodyKeyFor(entry) {
 	const subject = entry.payload.subject;
 	if (subject.systemEvent !== void 0) return subject.systemEvent.bodyKey ?? "";
 	if (subject.occupancy !== void 0) return "occupancy.body";
+	if (subject.applianceCycle !== void 0) return "appliance.finished.body";
 	if (subject.packagePhase === "delivered" && subject.packagePossible === true) return "package.delivered.possible.body";
 	if (subject.packagePhase !== void 0) return `package.${subject.packagePhase}.body`;
 	return entry.recordKind === "track-end" ? "detection.body.trackEnd" : "detection.body";
@@ -89049,7 +89387,7 @@ function renderRowTitle(texts, entry, vars) {
 	const systemEvent = entry.payload.subject.systemEvent;
 	const intrusion = entry.payload.alarmIntrusion;
 	const count = systemEvent?.textCount;
-	return renderRowText(texts, {
+	const rendered = renderRowText(texts, {
 		template: intrusion !== void 0 ? void 0 : entry.payload.template?.title,
 		key: titleKeyFor(entry),
 		vars: intrusion !== void 0 ? {
@@ -89059,11 +89397,13 @@ function renderRowTitle(texts, entry, vars) {
 		...count !== void 0 ? { count } : {},
 		frozen: systemEvent?.title ?? entry.payload.ruleName
 	});
+	return titleKeyFor(entry) === "appliance.finished.title" && entry.payload.template?.title === void 0 ? ncSentenceCaseBody(rendered) : rendered;
 }
 /** The default TITLE key — same shape, same pre-catalog reasoning. */
 function titleKeyFor(entry) {
 	const systemEvent = entry.payload.subject.systemEvent;
 	if (systemEvent !== void 0) return systemEvent.titleKey ?? "";
+	if (entry.payload.subject.applianceCycle !== void 0) return "appliance.finished.title";
 	if (entry.payload.alarmIntrusion !== void 0) return "alarm.intrusion.title";
 	const packagePhase = entry.payload.subject.packagePhase;
 	if (packagePhase === "delivered" && entry.payload.subject.packagePossible === true) return "package.delivered.possible.title";
@@ -102135,6 +102475,7 @@ function buildEntries(host, rule, subject, kind, matchedOn, userTargets = [], or
 					...subject.audioWindow.peakDbfs !== void 0 ? { peakDbfs: subject.audioWindow.peakDbfs } : {}
 				} } : {},
 				...subject.eventType !== void 0 ? { eventType: subject.eventType } : {},
+				...applianceCycleOf(subject),
 				...subject.systemEvent !== void 0 ? { systemEvent: subject.systemEvent } : {}
 			}
 		};
@@ -104210,7 +104551,7 @@ function beginLinkedStills(host, request) {
 	if (rowCameraIds.length > 0 && rowShown.length === 0) return void 0;
 	const shown = host.unmutedCameras(cameraIds);
 	const involved = [sensorId, ...rowShown];
-	if (!host.rules.listEnabled("device-event").some((rule) => {
+	const wanting = host.rules.listEnabled("device-event").filter((rule) => {
 		if (ruleShipsNoStill(rule)) return false;
 		if (!deviceEventRuleMayFireOnKind(rule, sensorKind, sensorRaised)) return false;
 		const excluded = rule.conditions.devicesExclude;
@@ -104221,9 +104562,14 @@ function beginLinkedStills(host, request) {
 		})) return false;
 		const devices = rule.conditions.devices;
 		return devices === void 0 || devices.length === 0 || devices.some((id) => involved.includes(id));
-	})) return void 0;
+	});
+	if (wanting.length === 0) return void 0;
+	const wakeSleeping = wanting.some((rule) => rule.media?.wakeSleepingCamera !== false);
 	for (const cameraId of cameraIds) if (!shown.includes(cameraId)) host.reportLinkedCameraMuted(cameraId, sensorId);
-	return shown.length > 0 ? shelf.captureSet(sensorId, shown, atMs) : void 0;
+	return shown.length > 0 ? shelf.captureSet(sensorId, shown, atMs, {
+		wakeSleeping,
+		ruleIds: wanting.map((rule) => rule.id)
+	}) : void 0;
 }
 /**
 * A muted camera left out of a linked set — one INFO line per camera per
@@ -106946,6 +107292,7 @@ var NotificationCenter = class {
 			...deps.dispatcher,
 			logger: this.logger.child("dispatch"),
 			texts: this.texts,
+			stillDeadline: (ownerId) => isLinkedStillId(ownerId) ? this.linkedStills?.pendingUntil(ownerId) : void 0,
 			getMediaForOwner: async (ownerKind, ownerId, eventScope) => {
 				const held = isSyntheticId(ownerId) ? this.syntheticMedia.get(ownerId) : void 0;
 				if (held !== void 0) return held.files;
@@ -109529,7 +109876,10 @@ var BuildNotificationCenter = class extends BuildNotificationCenterBase {
 			},
 			readAlerts: () => api.alerts.list.query({ limit: 5e3 }),
 			emitBusEvent: (event) => this.ctx.eventBus.emit(event),
-			getSnapshot: (deviceId) => api.snapshot.getSnapshot.query({ deviceId }),
+			getSnapshot: (deviceId, opts) => api.snapshot.getSnapshot.query(opts?.force === true ? {
+				deviceId,
+				force: true
+			} : { deviceId }),
 			recognitionOutlook: ({ deviceId, trackId, className, labelKind, now }) => recognitionOutlook({
 				className,
 				...labelKind !== void 0 ? { labelKind } : {},
@@ -109872,6 +110222,7 @@ var BuildNotificationCenter = class extends BuildNotificationCenterBase {
 					}));
 				},
 				getDeviceName,
+				resolveApplianceCycleFacts: this.deps.resolveApplianceCycleFacts,
 				getDeviceLocation,
 				buildActions: (input) => this.notificationCenter?.mintButtons(input) ?? Promise.resolve([])
 			},
@@ -123743,7 +124094,16 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 			buildTimelapsePorts: (api, stores) => this.buildTimelapsePorts(api, stores),
 			buildSummaryPorts: (api, stores) => this.buildSummaryPorts(api, stores),
 			wireAlarmPanel: (center) => this.wireAlarmPanel(center),
-			serveNcActionPlane: (center) => this.serveNcActionPlane(center)
+			serveNcActionPlane: (center) => this.serveNcActionPlane(center),
+			resolveApplianceCycleFacts: applianceCycleFactsFromRuns({
+				newestRun: async (deviceId) => {
+					return (await this.ctx.api.deviceRuns.listRuns.query({
+						deviceId,
+						limit: 1
+					})).runs[0] ?? null;
+				},
+				sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms))
+			})
 		});
 		return this.notificationCenterBootInstance;
 	}