@camstack/addon-provider-homeassistant 1.2.78 → 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
 /**
@@ -5772,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 {
@@ -6803,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,
@@ -6840,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
 /**
@@ -5767,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 {
@@ -6798,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,
@@ -6835,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.78",
+  "version": "1.2.79",
   "description": "Home Assistant device provider addon for CamStack",
   "keywords": [
     "camstack",