@camstack/addon-provider-homeassistant 1.2.77 → 1.2.79

package/dist/addon.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_dist = require("./dist-gv0Gmrm1.js");
+const require_dist = require("./dist-BI0EGQ5s.js");
 let node_crypto = require("node:crypto");
 let node_zlib = require("node:zlib");
 //#region src/ha-device-source.ts

package/dist/addon.mjs

@@ -1,4 +1,4 @@
-import { $ as presenceCapability, A as controlCapability, At as EventCategory, B as humiditySensorCapability, C as buildAddonRouteProvider, Ct as number, D as colorCapability, Dt as union, E as climateControlCapability, Et as string, F as eventEmitterCapability, G as motionCapability, H as lawnMowerControlCapability, I as fanControlCapability, J as notifierCapability, K as normalizeUnit, L as floodCapability, M as deviceAdoptionCapability, O as connectivityCapability, Ot as unknown, P as enumSensorCapability, Q as prepareNotification, R as gasCapability, S as brokerCapability, St as literal, T as carbonMonoxideCapability, Tt as record, U as lockControlCapability, V as imageCapability, W as mediaPlayerCapability, Y as numericSensorCapability, Z as powerMeterCapability, _ as automationControlCapability, _t as createEvent, at as temperatureSensorCapability, b as binaryCapability, bt as array, ct as valveCapability, d as TargetSchema, dt as weatherCapability, et as pressureSensorCapability, f as accessoriesCapability, ft as errMsg, g as ambientLightSensorCapability, gt as DeviceType, h as alarmPanelCapability, ht as DeviceRole, it as tamperCapability, j as coverCapability, k as contactCapability, kt as url, lt as vibrationCapability, m as airQualitySensorCapability, mt as DeviceFeature, n as BaseDevice, nt as smokeCapability, ot as updateCapability, p as addonRoutesCapability, q as notificationOutputCapability, r as BaseDeviceProvider, rt as switchCapability, s as EnumSensorDateTimeFormatSchema, st as vacuumControlCapability, tt as scriptRunnerCapability, ut as waterHeaterCapability, v as batteryCapability, w as buttonCapability, wt as object, x as brightnessCapability, xt as discriminatedUnion, y as bestLocationMatch, yt as _enum, z as humidifierCapability } from "./dist-CQzCvoCx.mjs";
+import { $ as presenceCapability, A as controlCapability, At as EventCategory, B as humiditySensorCapability, C as buildAddonRouteProvider, Ct as number, D as colorCapability, Dt as union, E as climateControlCapability, Et as string, F as eventEmitterCapability, G as motionCapability, H as lawnMowerControlCapability, I as fanControlCapability, J as notifierCapability, K as normalizeUnit, L as floodCapability, M as deviceAdoptionCapability, O as connectivityCapability, Ot as unknown, P as enumSensorCapability, Q as prepareNotification, R as gasCapability, S as brokerCapability, St as literal, T as carbonMonoxideCapability, Tt as record, U as lockControlCapability, V as imageCapability, W as mediaPlayerCapability, Y as numericSensorCapability, Z as powerMeterCapability, _ as automationControlCapability, _t as createEvent, at as temperatureSensorCapability, b as binaryCapability, bt as array, ct as valveCapability, d as TargetSchema, dt as weatherCapability, et as pressureSensorCapability, f as accessoriesCapability, ft as errMsg, g as ambientLightSensorCapability, gt as DeviceType, h as alarmPanelCapability, ht as DeviceRole, it as tamperCapability, j as coverCapability, k as contactCapability, kt as url, lt as vibrationCapability, m as airQualitySensorCapability, mt as DeviceFeature, n as BaseDevice, nt as smokeCapability, ot as updateCapability, p as addonRoutesCapability, q as notificationOutputCapability, r as BaseDeviceProvider, rt as switchCapability, s as EnumSensorDateTimeFormatSchema, st as vacuumControlCapability, tt as scriptRunnerCapability, ut as waterHeaterCapability, v as batteryCapability, w as buttonCapability, wt as object, x as brightnessCapability, xt as discriminatedUnion, y as bestLocationMatch, yt as _enum, z as humidifierCapability } from "./dist-CXuG5e6V.mjs";
 import { randomUUID } from "node:crypto";
 import { brotliCompressSync, deflateSync, gzipSync } from "node:zlib";
 //#region src/ha-device-source.ts

package/dist/{dist-gv0Gmrm1.js → dist-BI0EGQ5s.js}

@@ -13285,6 +13285,24 @@ var deviceProviderCapability = {
 		})
 	}
 };
+/**
+* Device Manager capability — hub-side singleton that unifies device persistence,
+* live registry access, and all management operations into a single tRPC surface.
+*
+* Replaces:
+*   - `device-persistence` capability (persistence methods absorbed here)
+*   - `device-management.router.ts` (deleted in Phase 2)
+*   - `device-ops.router.ts` (compat layer — deleted; device-provider ops absorbed here)
+*
+* All device provider addons (rtsp, onvif, frigate, …) are hub-local: they may
+* fork into separate processes but never run on remote cluster agents. Therefore:
+*   - No nodeId routing needed — this is a pure hub singleton.
+*   - The hub's DeviceRegistry is the single source of truth for all live devices.
+*   - No shadow registry or cross-node aggregation required.
+*
+* Forked workers register devices back to the hub via `ctx.devices`
+* (DeviceManagerApi → ctx.api.deviceManager.registerDevice), same as today.
+*/
 /** One child-placement directive on a container's `childLayout`. Structurally
 *  identical to `ChildLayoutEntry` in `device-management.ts` — the cap wire
 *  shape for the same field. The child is identified by its re-sync-stable
@@ -19041,6 +19059,9 @@ var RetrainStatusSchema = _enum([
 *
 * `debug` does NOT pin; it is attention, not durability.
 *
+* `debugNote` is the operator's own words about WHAT should be checked on this
+* track, and it lives and dies with `debug` — see {@link MAX_TRACK_DEBUG_NOTE_LEN}.
+*
 * `favourited` IS a BOOLEAN pin (durability bit), not a retrain lifecycle.
 * A favourited track is skipped by retention the same way `staging` is, but
 * it does not enter `none|staging|trained` and has no staging budget.
@@ -19051,6 +19072,21 @@ var TrackFlagFields = {
 	markForTrain: boolean().optional(),
 	/** Operator marked this track for diagnostic attention. */
 	debug: boolean().optional(),
+	/**
+	* What the operator wants CHECKED on this track, in their own words.
+	*
+	* The flag alone says "look at this" and nothing about what for; a debug set
+	* reviewed hours later is a list of tracks with no question attached. Bound
+	* to `debug` on the WRITE side — the body clears it when `debug` goes off,
+	* and refuses it on a track whose debug is off — so a note can never outlive
+	* the attention it belongs to.
+	*
+	* `''` is a real value ("marked, nothing to add"); the ABSENT key means
+	* "leave whatever is stored alone", which is what lets a surface turn debug
+	* on without a note (a cancelled prompt) and what lets it edit the note
+	* without touching the flag.
+	*/
+	debugNote: string().max(500).optional(),
 	/** Operator favourited this track. Pins it against pruning. */
 	favourited: boolean().optional()
 };
@@ -19077,6 +19113,12 @@ var TrackFlagsSchema = object({
 	trackId: string(),
 	markForTrain: boolean(),
 	debug: boolean(),
+	/** The note as it STANDS after the write — never absent here (a track with no
+	*  note reports `''`), for the same reason the booleans are required: a
+	*  surface that has just written must be able to render the note it now owns
+	*  without a re-fetch, and an absent key would read as "unchanged" on a
+	*  screen that has no previous value to keep. */
+	debugNote: string(),
 	favourited: boolean(),
 	/** The lifecycle state the boolean was derived from. Required here (unlike on
 	*  a track row) because this shape is only ever produced by the write body,

package/dist/{dist-CQzCvoCx.mjs → dist-CXuG5e6V.mjs}

@@ -13285,6 +13285,24 @@ var deviceProviderCapability = {
 		})
 	}
 };
+/**
+* Device Manager capability — hub-side singleton that unifies device persistence,
+* live registry access, and all management operations into a single tRPC surface.
+*
+* Replaces:
+*   - `device-persistence` capability (persistence methods absorbed here)
+*   - `device-management.router.ts` (deleted in Phase 2)
+*   - `device-ops.router.ts` (compat layer — deleted; device-provider ops absorbed here)
+*
+* All device provider addons (rtsp, onvif, frigate, …) are hub-local: they may
+* fork into separate processes but never run on remote cluster agents. Therefore:
+*   - No nodeId routing needed — this is a pure hub singleton.
+*   - The hub's DeviceRegistry is the single source of truth for all live devices.
+*   - No shadow registry or cross-node aggregation required.
+*
+* Forked workers register devices back to the hub via `ctx.devices`
+* (DeviceManagerApi → ctx.api.deviceManager.registerDevice), same as today.
+*/
 /** One child-placement directive on a container's `childLayout`. Structurally
 *  identical to `ChildLayoutEntry` in `device-management.ts` — the cap wire
 *  shape for the same field. The child is identified by its re-sync-stable
@@ -19041,6 +19059,9 @@ var RetrainStatusSchema = _enum([
 *
 * `debug` does NOT pin; it is attention, not durability.
 *
+* `debugNote` is the operator's own words about WHAT should be checked on this
+* track, and it lives and dies with `debug` — see {@link MAX_TRACK_DEBUG_NOTE_LEN}.
+*
 * `favourited` IS a BOOLEAN pin (durability bit), not a retrain lifecycle.
 * A favourited track is skipped by retention the same way `staging` is, but
 * it does not enter `none|staging|trained` and has no staging budget.
@@ -19051,6 +19072,21 @@ var TrackFlagFields = {
 	markForTrain: boolean().optional(),
 	/** Operator marked this track for diagnostic attention. */
 	debug: boolean().optional(),
+	/**
+	* What the operator wants CHECKED on this track, in their own words.
+	*
+	* The flag alone says "look at this" and nothing about what for; a debug set
+	* reviewed hours later is a list of tracks with no question attached. Bound
+	* to `debug` on the WRITE side — the body clears it when `debug` goes off,
+	* and refuses it on a track whose debug is off — so a note can never outlive
+	* the attention it belongs to.
+	*
+	* `''` is a real value ("marked, nothing to add"); the ABSENT key means
+	* "leave whatever is stored alone", which is what lets a surface turn debug
+	* on without a note (a cancelled prompt) and what lets it edit the note
+	* without touching the flag.
+	*/
+	debugNote: string().max(500).optional(),
 	/** Operator favourited this track. Pins it against pruning. */
 	favourited: boolean().optional()
 };
@@ -19077,6 +19113,12 @@ var TrackFlagsSchema = object({
 	trackId: string(),
 	markForTrain: boolean(),
 	debug: boolean(),
+	/** The note as it STANDS after the write — never absent here (a track with no
+	*  note reports `''`), for the same reason the booleans are required: a
+	*  surface that has just written must be able to render the note it now owns
+	*  without a re-fetch, and an absent key would read as "unchanged" on a
+	*  screen that has no previous value to keep. */
+	debugNote: string(),
 	favourited: boolean(),
 	/** The lifecycle state the boolean was derived from. Required here (unlike on
 	*  a track row) because this shape is only ever produced by the write body,

package/dist/ha-export/ha-export.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 //#endregion
-const require_dist = require("../dist-gv0Gmrm1.js");
+const require_dist = require("../dist-BI0EGQ5s.js");
 let node_crypto = require("node:crypto");
 //#region src/ha-export/topics.ts
 /**
@@ -1538,13 +1538,31 @@ function cameraSpecs(device) {
 			icon: "mdi:counter",
 			enabledByDefault: false
 		});
-		if (LABELLED_MACROS.includes(macro)) specs.push({
-			entity: `${macro}_last_label`,
-			platform: "sensor",
-			label: `${label} last label`,
-			icon: "mdi:tag",
-			enabledByDefault: true
-		});
+		if (LABELLED_MACROS.includes(macro)) specs.push(
+			{
+				entity: `${macro}_last_label`,
+				platform: "sensor",
+				label: `${label} last label`,
+				icon: "mdi:tag",
+				enabledByDefault: true
+			},
+			/**
+			* The identification OCCURRENCE — moves on every recognition,
+			* including a repeat of the SAME name (an unchanged `last_label`
+			* is deduped by the push client, and an identical value is not a
+			* state change in HA). This is the entity an automation's trigger
+			* binds to; the label value arrives in the same batch, ordered
+			* first. Enabled for the same reason `<macro>_last_detection` is:
+			* it IS the automation hook, not a diagnostic.
+			*/
+			{
+				entity: `${macro}_last_label_at`,
+				platform: "sensor",
+				label: `${label} last label at`,
+				deviceClass: "timestamp",
+				enabledByDefault: true
+			}
+		);
 	}
 	/**
 	* The live picture — every stream the hub lists EXCEPT the adaptive one,
@@ -4886,10 +4904,29 @@ function projectTrackLifecycle(deviceKey, track, mediaUrl) {
 	* topic nothing is subscribed to.
 	*/
 	const label = track.plateText ?? track.label;
-	if (label !== void 0 && label.length > 0 && LABELLED_MACROS.includes(macro)) values.push({
-		topic: stateTopic(deviceKey, `${macro}_last_label`),
-		value: label
-	});
+	if (label !== void 0 && label.length > 0 && LABELLED_MACROS.includes(macro)) {
+		values.push({
+			topic: stateTopic(deviceKey, `${macro}_last_label`),
+			value: label
+		});
+		/**
+		* The occurrence STAMP. A second recognition of the same person is a
+		* real occurrence, but it is invisible on `_last_label`: the push
+		* client dedups per topic, and an identical value is not a state
+		* change in Home Assistant anyway — a state-trigger automation would
+		* never re-fire. The stamp is the value that always moves, so an
+		* automation binds its trigger HERE and reads `<macro>_last_label`
+		* for the name — which is ordered BEFORE the stamp in this array, so
+		* it is already applied when the trigger fires. HA's `event` platform
+		* would be the native home for this, but no released component builds
+		* it (`component-support.ts`): announcing one yields a warning in
+		* HA's log and NO entity — the exact D152 zero-entities failure.
+		*/
+		values.push({
+			topic: stateTopic(deviceKey, `${macro}_last_label_at`),
+			value: iso(track.lastSeen)
+		});
+	}
 	if (mediaUrl !== null) values.push({
 		topic: stateTopic(deviceKey, "last_image"),
 		value: mediaUrl
@@ -5735,6 +5772,23 @@ function projectSynthetic(input, nowMs) {
 	return values;
 }
 //#endregion
+//#region src/ha-export/node-reads.ts
+var UNREAD = {
+	footageUsedBytes: null,
+	footageFreePercent: null
+};
+function footageForNode(nodeId, usage) {
+	if (usage === null || usage.nodeId !== nodeId) return UNREAD;
+	const freePercents = (usage.locations ?? []).filter((loc) => loc.availableBytes !== null && loc.totalBytes !== null && loc.totalBytes > 0).map((loc) => loc.availableBytes / loc.totalBytes * 100);
+	return {
+		footageUsedBytes: usage.totalUsedBytes,
+		footageFreePercent: freePercents.length > 0 ? Math.min(...freePercents) : null
+	};
+}
+function shouldReadPackageStatus(node) {
+	return !node.isHub && node.isOnline;
+}
+//#endregion
 //#region src/ha-export/rule-triggers.ts
 function reduceOne(row) {
 	return {
@@ -6766,35 +6820,33 @@ var HaExportAddon = class extends require_dist.BaseAddon {
 		}
 	}
 	/**
-	* Per-node disk usage (Task D2) and per-AGENT package status (Task D3),
-	* fanned out from the topology this pass already read. Bounded per node —
-	* one unreachable node degrades its own two rows, never the others'.
+	* Per-node disk usage (Task D2) and per-AGENT package status (Task D3).
+	* `recording` is a singleton cap, so its usage is read ONCE, unpinned, and
+	* attributed to the node the answer names (`footageForNode`); package
+	* status is asked only of online agents (`shouldReadPackageStatus`). A node
+	* that is not read stays `unknown` — unread, never failed.
 	*/
 	async buildSyntheticNodes(topology) {
+		const usage = await this.ctx.api.recording.getStorageUsage.query({}).catch((err) => {
+			this.ctx.logger.warn("ha-export: could not read storage usage, the footage entities go unknown", { meta: { error: errMsg(err) } });
+			return null;
+		});
 		let oldestFootageMs = null;
+		for (const device of usage?.devices ?? []) {
+			const oldest = device.oldestMs;
+			if (oldest === null || oldest === void 0) continue;
+			if (oldestFootageMs === null || oldest < oldestFootageMs) oldestFootageMs = oldest;
+		}
 		return {
 			nodes: await Promise.all(topology.map(async (node) => {
-				const disk = await this.ctx.api.recording.getStorageUsage.query({}, require_dist.nodePin(node.id)).catch((err) => {
-					this.ctx.logger.warn("ha-export: could not read storage usage for a node, its disk entities go unknown", { meta: {
-						nodeId: node.id,
-						error: errMsg(err)
-					} });
-					return null;
-				});
-				const freePercents = (disk?.locations ?? []).filter((loc) => loc.availableBytes !== null && loc.totalBytes !== null && loc.totalBytes > 0).map((loc) => loc.availableBytes / loc.totalBytes * 100);
-				const footageFreePercent = freePercents.length > 0 ? Math.min(...freePercents) : null;
-				for (const device of disk?.devices ?? []) {
-					const oldest = device.oldestMs;
-					if (oldest === null || oldest === void 0) continue;
-					if (oldestFootageMs === null || oldest < oldestFootageMs) oldestFootageMs = oldest;
-				}
-				const packageStatus = node.isHub ? null : await this.ctx.api.serverManagement.getServerPackageStatus.query({ nodeId: node.id }).catch((err) => {
+				const footage = footageForNode(node.id, usage);
+				const packageStatus = shouldReadPackageStatus(node) ? await this.ctx.api.serverManagement.getServerPackageStatus.query({ nodeId: node.id }).catch((err) => {
 					this.ctx.logger.warn("ha-export: could not read package status for an agent node, its update entities go unknown", { meta: {
 						nodeId: node.id,
 						error: errMsg(err)
 					} });
 					return null;
-				});
+				}) : null;
 				return {
 					id: node.id,
 					name: node.name,
@@ -6803,8 +6855,8 @@ var HaExportAddon = class extends require_dist.BaseAddon {
 					memoryPercent: node.memoryPercent,
 					uptime: node.uptime,
 					isHub: node.isHub,
-					footageUsedBytes: disk?.totalUsedBytes ?? null,
-					footageFreePercent,
+					footageUsedBytes: footage.footageUsedBytes,
+					footageFreePercent: footage.footageFreePercent,
 					rootPackageVersion: node.rootPackage?.version ?? null,
 					updateAvailable: packageStatus?.updateAvailable ?? null
 				};

package/dist/ha-export/ha-export.addon.mjs

@@ -1,4 +1,4 @@
-import { At as EventCategory, C as buildAddonRouteProvider, Et as string, N as deviceExportCapability, X as oauthIntegrationCapability, a as COCO_TO_MACRO, c as FanDirectionSchema, i as CAMERA_SWITCH_ORDER, l as HvacModeSchema, o as CameraSwitchIdSchema, p as addonRoutesCapability, pt as BaseAddon, t as AlarmArmModeSchema, u as MediaPlayerRepeatSchema, vt as nodePin } from "../dist-CQzCvoCx.mjs";
+import { At as EventCategory, C as buildAddonRouteProvider, Et as string, N as deviceExportCapability, X as oauthIntegrationCapability, a as COCO_TO_MACRO, c as FanDirectionSchema, i as CAMERA_SWITCH_ORDER, l as HvacModeSchema, o as CameraSwitchIdSchema, p as addonRoutesCapability, pt as BaseAddon, t as AlarmArmModeSchema, u as MediaPlayerRepeatSchema, vt as nodePin } from "../dist-CXuG5e6V.mjs";
 import { createHmac, timingSafeEqual } from "node:crypto";
 //#region src/ha-export/topics.ts
 /**
@@ -1533,13 +1533,31 @@ function cameraSpecs(device) {
 			icon: "mdi:counter",
 			enabledByDefault: false
 		});
-		if (LABELLED_MACROS.includes(macro)) specs.push({
-			entity: `${macro}_last_label`,
-			platform: "sensor",
-			label: `${label} last label`,
-			icon: "mdi:tag",
-			enabledByDefault: true
-		});
+		if (LABELLED_MACROS.includes(macro)) specs.push(
+			{
+				entity: `${macro}_last_label`,
+				platform: "sensor",
+				label: `${label} last label`,
+				icon: "mdi:tag",
+				enabledByDefault: true
+			},
+			/**
+			* The identification OCCURRENCE — moves on every recognition,
+			* including a repeat of the SAME name (an unchanged `last_label`
+			* is deduped by the push client, and an identical value is not a
+			* state change in HA). This is the entity an automation's trigger
+			* binds to; the label value arrives in the same batch, ordered
+			* first. Enabled for the same reason `<macro>_last_detection` is:
+			* it IS the automation hook, not a diagnostic.
+			*/
+			{
+				entity: `${macro}_last_label_at`,
+				platform: "sensor",
+				label: `${label} last label at`,
+				deviceClass: "timestamp",
+				enabledByDefault: true
+			}
+		);
 	}
 	/**
 	* The live picture — every stream the hub lists EXCEPT the adaptive one,
@@ -4881,10 +4899,29 @@ function projectTrackLifecycle(deviceKey, track, mediaUrl) {
 	* topic nothing is subscribed to.
 	*/
 	const label = track.plateText ?? track.label;
-	if (label !== void 0 && label.length > 0 && LABELLED_MACROS.includes(macro)) values.push({
-		topic: stateTopic(deviceKey, `${macro}_last_label`),
-		value: label
-	});
+	if (label !== void 0 && label.length > 0 && LABELLED_MACROS.includes(macro)) {
+		values.push({
+			topic: stateTopic(deviceKey, `${macro}_last_label`),
+			value: label
+		});
+		/**
+		* The occurrence STAMP. A second recognition of the same person is a
+		* real occurrence, but it is invisible on `_last_label`: the push
+		* client dedups per topic, and an identical value is not a state
+		* change in Home Assistant anyway — a state-trigger automation would
+		* never re-fire. The stamp is the value that always moves, so an
+		* automation binds its trigger HERE and reads `<macro>_last_label`
+		* for the name — which is ordered BEFORE the stamp in this array, so
+		* it is already applied when the trigger fires. HA's `event` platform
+		* would be the native home for this, but no released component builds
+		* it (`component-support.ts`): announcing one yields a warning in
+		* HA's log and NO entity — the exact D152 zero-entities failure.
+		*/
+		values.push({
+			topic: stateTopic(deviceKey, `${macro}_last_label_at`),
+			value: iso(track.lastSeen)
+		});
+	}
 	if (mediaUrl !== null) values.push({
 		topic: stateTopic(deviceKey, "last_image"),
 		value: mediaUrl
@@ -5730,6 +5767,23 @@ function projectSynthetic(input, nowMs) {
 	return values;
 }
 //#endregion
+//#region src/ha-export/node-reads.ts
+var UNREAD = {
+	footageUsedBytes: null,
+	footageFreePercent: null
+};
+function footageForNode(nodeId, usage) {
+	if (usage === null || usage.nodeId !== nodeId) return UNREAD;
+	const freePercents = (usage.locations ?? []).filter((loc) => loc.availableBytes !== null && loc.totalBytes !== null && loc.totalBytes > 0).map((loc) => loc.availableBytes / loc.totalBytes * 100);
+	return {
+		footageUsedBytes: usage.totalUsedBytes,
+		footageFreePercent: freePercents.length > 0 ? Math.min(...freePercents) : null
+	};
+}
+function shouldReadPackageStatus(node) {
+	return !node.isHub && node.isOnline;
+}
+//#endregion
 //#region src/ha-export/rule-triggers.ts
 function reduceOne(row) {
 	return {
@@ -6761,35 +6815,33 @@ var HaExportAddon = class extends BaseAddon {
 		}
 	}
 	/**
-	* Per-node disk usage (Task D2) and per-AGENT package status (Task D3),
-	* fanned out from the topology this pass already read. Bounded per node —
-	* one unreachable node degrades its own two rows, never the others'.
+	* Per-node disk usage (Task D2) and per-AGENT package status (Task D3).
+	* `recording` is a singleton cap, so its usage is read ONCE, unpinned, and
+	* attributed to the node the answer names (`footageForNode`); package
+	* status is asked only of online agents (`shouldReadPackageStatus`). A node
+	* that is not read stays `unknown` — unread, never failed.
 	*/
 	async buildSyntheticNodes(topology) {
+		const usage = await this.ctx.api.recording.getStorageUsage.query({}).catch((err) => {
+			this.ctx.logger.warn("ha-export: could not read storage usage, the footage entities go unknown", { meta: { error: errMsg(err) } });
+			return null;
+		});
 		let oldestFootageMs = null;
+		for (const device of usage?.devices ?? []) {
+			const oldest = device.oldestMs;
+			if (oldest === null || oldest === void 0) continue;
+			if (oldestFootageMs === null || oldest < oldestFootageMs) oldestFootageMs = oldest;
+		}
 		return {
 			nodes: await Promise.all(topology.map(async (node) => {
-				const disk = await this.ctx.api.recording.getStorageUsage.query({}, nodePin(node.id)).catch((err) => {
-					this.ctx.logger.warn("ha-export: could not read storage usage for a node, its disk entities go unknown", { meta: {
-						nodeId: node.id,
-						error: errMsg(err)
-					} });
-					return null;
-				});
-				const freePercents = (disk?.locations ?? []).filter((loc) => loc.availableBytes !== null && loc.totalBytes !== null && loc.totalBytes > 0).map((loc) => loc.availableBytes / loc.totalBytes * 100);
-				const footageFreePercent = freePercents.length > 0 ? Math.min(...freePercents) : null;
-				for (const device of disk?.devices ?? []) {
-					const oldest = device.oldestMs;
-					if (oldest === null || oldest === void 0) continue;
-					if (oldestFootageMs === null || oldest < oldestFootageMs) oldestFootageMs = oldest;
-				}
-				const packageStatus = node.isHub ? null : await this.ctx.api.serverManagement.getServerPackageStatus.query({ nodeId: node.id }).catch((err) => {
+				const footage = footageForNode(node.id, usage);
+				const packageStatus = shouldReadPackageStatus(node) ? await this.ctx.api.serverManagement.getServerPackageStatus.query({ nodeId: node.id }).catch((err) => {
 					this.ctx.logger.warn("ha-export: could not read package status for an agent node, its update entities go unknown", { meta: {
 						nodeId: node.id,
 						error: errMsg(err)
 					} });
 					return null;
-				});
+				}) : null;
 				return {
 					id: node.id,
 					name: node.name,
@@ -6798,8 +6850,8 @@ var HaExportAddon = class extends BaseAddon {
 					memoryPercent: node.memoryPercent,
 					uptime: node.uptime,
 					isHub: node.isHub,
-					footageUsedBytes: disk?.totalUsedBytes ?? null,
-					footageFreePercent,
+					footageUsedBytes: footage.footageUsedBytes,
+					footageFreePercent: footage.footageFreePercent,
 					rootPackageVersion: node.rootPackage?.version ?? null,
 					updateAvailable: packageStatus?.updateAvailable ?? null
 				};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-homeassistant",
-  "version": "1.2.77",
+  "version": "1.2.79",
   "description": "Home Assistant device provider addon for CamStack",
   "keywords": [
     "camstack",