@camstack/system 1.2.243 → 1.2.244

package/dist/builtins/addon-pages-aggregator/addon-pages-aggregator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-D6kqBW1G.js");
+const require_dist = require("../../dist-Cz6h6Nc3.js");
 const require_settle_sources = require("../../settle-sources-Bhsy57y-.js");
 let node_crypto = require("node:crypto");
 let node_path = require("node:path");

package/dist/builtins/addon-pages-aggregator/addon-pages-aggregator.addon.mjs

@@ -1,4 +1,4 @@
-import { A as addonPagesCapability, Sn as EventCategory, Xt as BaseAddon, Yt as errMsg } from "../../dist-B4htkDVv.mjs";
+import { A as addonPagesCapability, Cn as EventCategory, Xt as errMsg, Zt as BaseAddon } from "../../dist-4MS1GNc8.mjs";
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import { createHash, randomUUID } from "node:crypto";
 import * as path$1 from "node:path";

package/dist/builtins/addon-widgets-aggregator/addon-widgets-aggregator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-D6kqBW1G.js");
+const require_dist = require("../../dist-Cz6h6Nc3.js");
 const require_settle_sources = require("../../settle-sources-Bhsy57y-.js");
 let node_crypto = require("node:crypto");
 let node_path = require("node:path");

package/dist/builtins/addon-widgets-aggregator/addon-widgets-aggregator.addon.mjs

@@ -1,4 +1,4 @@
-import { M as addonWidgetsCapability, Sn as EventCategory, Xt as BaseAddon, Yt as errMsg } from "../../dist-B4htkDVv.mjs";
+import { Cn as EventCategory, M as addonWidgetsCapability, Xt as errMsg, Zt as BaseAddon } from "../../dist-4MS1GNc8.mjs";
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import { createHash, randomUUID } from "node:crypto";
 import * as path$1 from "node:path";

package/dist/builtins/alerts/alerts.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-D6kqBW1G.js");
+const require_dist = require("../../dist-Cz6h6Nc3.js");
 //#region src/builtins/alerts/prune-policy.ts
 /**
 * Ids older than `cutoffMs`, oldest first.

package/dist/builtins/alerts/alerts.addon.mjs

@@ -1,4 +1,4 @@
-import { N as alertsCapability, Sn as EventCategory, Xt as BaseAddon, Yt as errMsg, ln as createEvent, n as AlertSchema } from "../../dist-B4htkDVv.mjs";
+import { Cn as EventCategory, N as alertsCapability, Xt as errMsg, Zt as BaseAddon, n as AlertSchema, un as createEvent } from "../../dist-4MS1GNc8.mjs";
 //#region src/builtins/alerts/prune-policy.ts
 /**
 * Ids older than `cutoffMs`, oldest first.

package/dist/builtins/backup-orchestrator/backup-orchestrator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-D6kqBW1G.js");
+const require_dist = require("../../dist-Cz6h6Nc3.js");
 let node_crypto = require("node:crypto");
 let buffer = require("buffer");
 let node_fs_promises = require("node:fs/promises");

package/dist/builtins/backup-orchestrator/backup-orchestrator.addon.mjs

@@ -1,4 +1,4 @@
-import { F as backupCapability, Ht as storageOccupancyCapability, Sn as EventCategory, Xt as BaseAddon, xt as mayWriteToLocation } from "../../dist-B4htkDVv.mjs";
+import { Cn as EventCategory, F as backupCapability, Ut as storageOccupancyCapability, Zt as BaseAddon, xt as mayWriteToLocation } from "../../dist-4MS1GNc8.mjs";
 import { randomBytes, randomUUID } from "node:crypto";
 import { Buffer as Buffer$1 } from "buffer";
 import * as fsp from "node:fs/promises";

package/dist/builtins/console-logging/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-D6kqBW1G.js");
+const require_dist = require("../../dist-Cz6h6Nc3.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 //#region src/builtins/console-logging/console-destination.ts
 var LEVEL_RANK = {

package/dist/builtins/console-logging/index.mjs

@@ -1,4 +1,4 @@
-import { Xt as BaseAddon, _t as logDestinationCapability } from "../../dist-B4htkDVv.mjs";
+import { Zt as BaseAddon, _t as logDestinationCapability } from "../../dist-4MS1GNc8.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 //#region src/builtins/console-logging/console-destination.ts
 var LEVEL_RANK = {

package/dist/builtins/core-blocks/core-blocks.addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-D6kqBW1G.js");
+const require_dist = require("../../dist-Cz6h6Nc3.js");
 let node_crypto = require("node:crypto");
 let node_fs_promises = require("node:fs/promises");
 node_fs_promises = require_chunk.__toESM(node_fs_promises);

package/dist/builtins/core-blocks/core-blocks.addon.mjs

@@ -1,4 +1,4 @@
-import { B as coreBlockAddonId, H as coreBlocksCapability, V as coreBlockIdFromAddonId, Xt as BaseAddon, Yt as errMsg, c as CORE_BLOCK_ADDON_PREFIX, d as DeclaredDevices, l as CoreBlockSchema, s as CORE_BLOCKS_ADDON_ID } from "../../dist-B4htkDVv.mjs";
+import { B as coreBlockAddonId, H as coreBlocksCapability, V as coreBlockIdFromAddonId, Xt as errMsg, Zt as BaseAddon, c as CORE_BLOCK_ADDON_PREFIX, d as DeclaredDevices, l as CoreBlockSchema, s as CORE_BLOCKS_ADDON_ID } from "../../dist-4MS1GNc8.mjs";
 import { randomUUID } from "node:crypto";
 import * as fs from "node:fs/promises";
 import * as path$1 from "node:path";

package/dist/builtins/device-manager/device-manager.addon.js

@@ -3,8 +3,8 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-D6kqBW1G.js");
-const require_retired_settings_keys = require("../../retired-settings-keys-BPIyHR4_.js");
+const require_dist = require("../../dist-Cz6h6Nc3.js");
+const require_retired_settings_keys = require("../../retired-settings-keys-DBrIdOQp.js");
 let node_crypto = require("node:crypto");
 let _camstack_types_node = require("@camstack/types/node");
 //#region src/builtins/device-manager/adoption-job-engine.ts
@@ -5037,6 +5037,234 @@ async function setLocationIcon(pctx, input) {
 	});
 }
 /**
+* Every location that carries a description, sorted by key.
+*
+* Only what was WRITTEN — a location with no description is absent, and the
+* digest then tells the model the location name alone, exactly as it did
+* before descriptions existed.
+*/
+async function listLocationDescriptions(pctx) {
+	const descriptions = (await pctx.metaStore.readStore()).locationDescriptions ?? {};
+	return Object.entries(descriptions).map(([locationKey, description]) => ({
+		locationKey,
+		description
+	})).toSorted((a, b) => a.locationKey.localeCompare(b.locationKey));
+}
+/**
+* Set (or clear) a location's description.
+*
+* A BLANK description clears, exactly as `null` does: an empty line handed to
+* a vision model costs attention and says nothing, so the two must not be
+* different states. The label is folded with `locationIconKey` — the same key
+* the icon uses, which is the whole point of this living here.
+*
+* Same read-modify-write and same lock as `setLocationIcon`; `writeAddonStore`
+* re-inserts the whole key range, so an unordered write carries a stale copy
+* of every other key.
+*/
+async function setLocationDescription(pctx, input) {
+	const trimmed = input.location.trim();
+	if (trimmed.length === 0) throw new Error("[device-manager] setLocationDescription: location must be non-empty");
+	const key = require_dist.locationIconKey(trimmed);
+	const text = input.description === null ? "" : input.description.trim();
+	await pctx.bindingsDeps.withAddonStoreWriteLock(async () => {
+		const descriptions = (await pctx.metaStore.readStore()).locationDescriptions ?? {};
+		if (text.length === 0) {
+			if (!(key in descriptions)) return;
+			const { [key]: _cleared, ...kept } = descriptions;
+			await pctx.settings.writeAddonStore({ locationDescriptions: kept });
+			return;
+		}
+		if (descriptions[key] === text) return;
+		await pctx.settings.writeAddonStore({ locationDescriptions: {
+			...descriptions,
+			[key]: text
+		} });
+	});
+}
+/**
+* Every site zone, with its rooms, sorted by key.
+*
+* Membership is inverted HERE rather than stored both ways: the store keeps
+* `location → zone`, which is what makes "one zone per room" structural, and a
+* second copy keyed the other way is a second thing that can disagree with the
+* first.
+*/
+async function listSiteZones(pctx) {
+	const store = await pctx.metaStore.readStore();
+	const zones = store.siteZones ?? {};
+	const membership = store.locationZones ?? {};
+	const rooms = /* @__PURE__ */ new Map();
+	for (const [locationKey, zoneKey] of Object.entries(membership)) {
+		const list = rooms.get(zoneKey);
+		if (list === void 0) rooms.set(zoneKey, [locationKey]);
+		else list.push(locationKey);
+	}
+	return Object.entries(zones).map(([zoneKey, record]) => ({
+		zoneKey,
+		label: record.label,
+		icon: record.icon ?? null,
+		locationKeys: (rooms.get(zoneKey) ?? []).toSorted((a, b) => a.localeCompare(b))
+	})).toSorted((a, b) => a.zoneKey.localeCompare(b.zoneKey));
+}
+/**
+* Create a zone, or set the icon of one that already exists.
+*
+* `icon: null` clears the icon and KEEPS the zone. Conflating the two would
+* make a mis-click on "no icon" delete every room's membership — the icon is a
+* decoration and the grouping is the data.
+*
+* `icon` OMITTED leaves whatever icon is there: creating a zone from a screen
+* with no picker must not silently clear the glyph a previous screen set.
+*/
+async function setSiteZone(pctx, input) {
+	const label = input.name.trim();
+	if (label.length === 0) throw new Error("[device-manager] setSiteZone: name must be non-empty");
+	const key = require_dist.siteZoneKey(label);
+	await pctx.bindingsDeps.withAddonStoreWriteLock(async () => {
+		const zones = (await pctx.metaStore.readStore()).siteZones ?? {};
+		const existing = zones[key];
+		const icon = input.icon === void 0 ? existing?.icon : input.icon === null ? void 0 : input.icon;
+		const next = icon === void 0 ? { label } : {
+			label,
+			icon
+		};
+		if (existing?.label === next.label && existing.icon === next.icon) return;
+		await pctx.settings.writeAddonStore({ siteZones: {
+			...zones,
+			[key]: next
+		} });
+	});
+}
+/**
+* Delete a zone. Its LOCATIONS survive, unattached.
+*
+* Deleting a grouping must never delete what was grouped — the rooms exist
+* independently and the devices in them were never touched to begin with.
+*/
+async function removeSiteZone(pctx, input) {
+	const key = require_dist.siteZoneKey(input.name);
+	await pctx.bindingsDeps.withAddonStoreWriteLock(async () => {
+		const store = await pctx.metaStore.readStore();
+		const zones = store.siteZones ?? {};
+		const membership = store.locationZones ?? {};
+		const hadZone = key in zones;
+		const orphaned = Object.entries(membership).filter(([, zoneKey]) => zoneKey === key);
+		if (!hadZone && orphaned.length === 0) return;
+		const { [key]: _dropped, ...keptZones } = zones;
+		const keptMembership = Object.fromEntries(Object.entries(membership).filter(([, zoneKey]) => zoneKey !== key));
+		await pctx.settings.writeAddonStore({
+			...hadZone ? { siteZones: keptZones } : {},
+			...orphaned.length > 0 ? { locationZones: keptMembership } : {}
+		});
+	});
+}
+/**
+* Rename a zone, carrying its icon AND every room in it.
+*
+* It exists so that renaming is not delete-then-recreate, which drops both.
+* A rename onto an existing zone MERGES: the target keeps its own icon and the
+* rooms are unioned, the same rule `renameLocation` follows.
+*/
+async function renameSiteZone(pctx, input) {
+	const toLabel = input.to.trim();
+	if (toLabel.length === 0) throw new Error("[device-manager] renameSiteZone: target name must be non-empty");
+	const fromKey = require_dist.siteZoneKey(input.from);
+	const toKey = require_dist.siteZoneKey(toLabel);
+	await pctx.bindingsDeps.withAddonStoreWriteLock(async () => {
+		const store = await pctx.metaStore.readStore();
+		const zones = store.siteZones ?? {};
+		const moved = zones[fromKey];
+		if (moved === void 0) return;
+		const { [fromKey]: _dropped, ...rest } = zones;
+		const target = rest[toKey];
+		const nextZones = {
+			...rest,
+			[toKey]: target ?? (moved.icon === void 0 ? { label: toLabel } : {
+				label: toLabel,
+				icon: moved.icon
+			})
+		};
+		const membership = store.locationZones ?? {};
+		const nextMembership = Object.fromEntries(Object.entries(membership).map(([locationKey, zoneKey]) => [locationKey, zoneKey === fromKey ? toKey : zoneKey]));
+		await pctx.settings.writeAddonStore({
+			siteZones: nextZones,
+			locationZones: nextMembership
+		});
+	});
+}
+/**
+* Put a location in a zone, or take it out with `zone: null`.
+*
+* ONE slot per location, so a second call moves the room rather than listing it
+* twice. The zone is created if it does not exist — a screen that assigns
+* before creating is a normal order, and refusing it would be the only place in
+* this registry that demands registration first.
+*/
+async function setLocationZone(pctx, input) {
+	const location = input.location.trim();
+	if (location.length === 0) throw new Error("[device-manager] setLocationZone: location must be non-empty");
+	const locationKey = require_dist.locationIconKey(location);
+	const label = input.zone === null ? null : input.zone.trim();
+	if (label !== null && label.length === 0) throw new Error("[device-manager] setLocationZone: zone must be non-empty or null");
+	await pctx.bindingsDeps.withAddonStoreWriteLock(async () => {
+		const store = await pctx.metaStore.readStore();
+		const membership = store.locationZones ?? {};
+		if (label === null) {
+			if (!(locationKey in membership)) return;
+			const { [locationKey]: _cleared, ...kept } = membership;
+			await pctx.settings.writeAddonStore({ locationZones: kept });
+			return;
+		}
+		const zoneKey = require_dist.siteZoneKey(label);
+		const zones = store.siteZones ?? {};
+		const needsZone = !(zoneKey in zones);
+		if (membership[locationKey] === zoneKey && !needsZone) return;
+		await pctx.settings.writeAddonStore({
+			...needsZone ? { siteZones: {
+				...zones,
+				[zoneKey]: { label }
+			} } : {},
+			locationZones: {
+				...membership,
+				[locationKey]: zoneKey
+			}
+		});
+	});
+}
+/**
+* Move a location's zone membership from one key to another, for
+* `renameLocation`. Same shape as the icon and description movers.
+*/
+function renameLocationZone(membership, fromKey, toKey) {
+	const moved = membership[fromKey];
+	if (moved === void 0) return null;
+	if (fromKey === toKey) return null;
+	const { [fromKey]: _dropped, ...rest } = membership;
+	return toKey in rest ? rest : {
+		...rest,
+		[toKey]: moved
+	};
+}
+/**
+* Move a location's description from one key to another, for `renameLocation`.
+*
+* Identical rule to {@link renameLocationIcon}, deliberately: a merge keeps the
+* TARGET's description, because renaming "Sala" into "Salone" moves devices
+* into Salone and does not re-describe it. Split from the icon mover only
+* because the value types differ; if one ever changes, the other must.
+*/
+function renameLocationDescription(descriptions, fromKey, toKey) {
+	const moved = descriptions[fromKey];
+	if (moved === void 0) return null;
+	if (fromKey === toKey) return null;
+	const { [fromKey]: _dropped, ...rest } = descriptions;
+	return toKey in rest ? rest : {
+		...rest,
+		[toKey]: moved
+	};
+}
+/**
 * Move a location's icon from one key to another, for `renameLocation`.
 *
 * Returns `null` when NOTHING changes, so the caller can leave the key out of
@@ -5092,14 +5320,18 @@ async function renameLocation(pctx, input) {
 		const current = store.locations ?? [];
 		const registered = current.some((l) => l.trim().toLowerCase() === fromKey);
 		const movedIcons = renameLocationIcon(store.locationIcons ?? {}, fromKey, toKey);
-		if (!registered && movedIcons === null) return;
+		const movedDescriptions = renameLocationDescription(store.locationDescriptions ?? {}, fromKey, toKey);
+		const movedZones = renameLocationZone(store.locationZones ?? {}, fromKey, toKey);
+		if (!registered && movedIcons === null && movedDescriptions === null && movedZones === null) return;
 		const kept = current.filter((l) => {
 			const key = l.trim().toLowerCase();
 			return key !== fromKey && key !== toKey;
 		});
 		await pctx.settings.writeAddonStore({
 			...registered ? { locations: [...kept, to] } : {},
-			...movedIcons !== null ? { locationIcons: movedIcons } : {}
+			...movedIcons !== null ? { locationIcons: movedIcons } : {},
+			...movedDescriptions !== null ? { locationDescriptions: movedDescriptions } : {},
+			...movedZones !== null ? { locationZones: movedZones } : {}
 		});
 	});
 	const moved = await pctx.metaStore.withMetaWriteLock(async () => {
@@ -5145,11 +5377,19 @@ async function removeLocation(pctx, input) {
 		const droppedLabel = remaining.length !== current.length;
 		const icons = store.locationIcons ?? {};
 		const droppedIcon = key in icons;
-		if (!droppedLabel && !droppedIcon) return;
+		const descriptions = store.locationDescriptions ?? {};
+		const droppedDescription = key in descriptions;
+		const membership = store.locationZones ?? {};
+		const droppedZone = key in membership;
+		if (!droppedLabel && !droppedIcon && !droppedDescription && !droppedZone) return;
 		const { [key]: _removedIcon, ...keptIcons } = icons;
+		const { [key]: _removedDescription, ...keptDescriptions } = descriptions;
+		const { [key]: _removedZone, ...keptMembership } = membership;
 		await pctx.settings.writeAddonStore({
 			...droppedLabel ? { locations: remaining } : {},
-			...droppedIcon ? { locationIcons: keptIcons } : {}
+			...droppedIcon ? { locationIcons: keptIcons } : {},
+			...droppedDescription ? { locationDescriptions: keptDescriptions } : {},
+			...droppedZone ? { locationZones: keptMembership } : {}
 		});
 	});
 	if (input.cascade !== true) return;
@@ -5253,11 +5493,17 @@ function decodeAddonStore(raw) {
 	const locations = raw["locations"];
 	const roleDisplayDefaults = raw["roleDisplayDefaults"];
 	const locationIcons = decodeLocationIcons(raw["locationIcons"]);
+	const locationDescriptions = decodeLocationDescriptions(raw["locationDescriptions"]);
+	const siteZones = decodeSiteZones(raw["siteZones"]);
+	const locationZones = decodeStringMap(raw["locationZones"]);
 	return {
 		...typeof nextDeviceId === "number" && Number.isFinite(nextDeviceId) ? { nextDeviceId } : {},
 		...Array.isArray(locations) ? { locations: locations.filter((l) => typeof l === "string") } : {},
 		...isRoleDisplayDefaults(roleDisplayDefaults) ? { roleDisplayDefaults } : {},
-		...locationIcons !== null ? { locationIcons } : {}
+		...locationIcons !== null ? { locationIcons } : {},
+		...locationDescriptions !== null ? { locationDescriptions } : {},
+		...siteZones !== null ? { siteZones } : {},
+		...locationZones !== null ? { locationZones } : {}
 	};
 }
 /**
@@ -5281,6 +5527,61 @@ function decodeLocationIcons(raw) {
 	}
 	return out;
 }
+/**
+* Decode the `locationDescriptions` map, dropping every entry that is not a
+* non-blank string.
+*
+* Same posture as the icons: a blank description and a missing one are the
+* same instruction to every reader, and storing the first would send an empty
+* line to a vision model. Over-long text is TRUNCATED rather than dropped —
+* losing the whole description because a hand-edit ran long is a worse answer
+* than losing its tail.
+*/
+function decodeLocationDescriptions(raw) {
+	if (raw === null || typeof raw !== "object" || Array.isArray(raw)) return null;
+	const out = {};
+	for (const [key, value] of Object.entries(raw)) {
+		if (typeof value !== "string") continue;
+		const text = value.trim();
+		if (text.length === 0) continue;
+		out[key] = text.slice(0, 400);
+	}
+	return out;
+}
+/**
+* Decode the zone registry, dropping any entry without a usable label.
+*
+* A zone whose label did not survive a hand-edit cannot be shown or renamed —
+* it would be a row the operator can see the effects of and never name. An
+* icon outside the vocabulary is dropped on its own, leaving the zone: losing
+* a glyph is a smaller loss than losing the grouping.
+*/
+function decodeSiteZones(raw) {
+	if (raw === null || typeof raw !== "object" || Array.isArray(raw)) return null;
+	const out = {};
+	for (const [key, value] of Object.entries(raw)) {
+		if (value === null || typeof value !== "object" || Array.isArray(value)) continue;
+		const rec = value;
+		const label = typeof rec["label"] === "string" ? rec["label"].trim() : "";
+		if (label.length === 0) continue;
+		const icon = require_dist.LocationIconIdSchema.safeParse(rec["icon"]);
+		out[key] = icon.success ? {
+			label,
+			icon: icon.data
+		} : { label };
+	}
+	return out;
+}
+/** Decode a plain `string → string` map, dropping anything else. */
+function decodeStringMap(raw) {
+	if (raw === null || typeof raw !== "object" || Array.isArray(raw)) return null;
+	const out = {};
+	for (const [key, value] of Object.entries(raw)) {
+		if (typeof value !== "string" || value.trim().length === 0) continue;
+		out[key] = value;
+	}
+	return out;
+}
 function isRoleDisplayDefaults(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value);
 }
@@ -7115,6 +7416,13 @@ var DeviceManagerAddon = class extends require_dist.BaseAddon {
 			renameLocation: (input) => renameLocation(pctx, input),
 			listLocationIcons: () => listLocationIcons(pctx),
 			setLocationIcon: (input) => setLocationIcon(pctx, input),
+			listLocationDescriptions: () => listLocationDescriptions(pctx),
+			setLocationDescription: (input) => setLocationDescription(pctx, input),
+			listSiteZones: () => listSiteZones(pctx),
+			setSiteZone: (input) => setSiteZone(pctx, input),
+			removeSiteZone: (input) => removeSiteZone(pctx, input),
+			renameSiteZone: (input) => renameSiteZone(pctx, input),
+			setLocationZone: (input) => setLocationZone(pctx, input),
 			listPersistedByAddon: (input) => listPersistedByAddon(pctx, input),
 			listAll: (input) => listAll(pctx, input),
 			getDevice: (input) => getDevice(pctx, input),