@camstack/system 1.2.243 → 1.2.245

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

@@ -1,5 +1,5 @@
-import { C as STREAM_PROFILE_META, Et as parseStreamParamsFormPatch, J as deviceStatusCapability, K as deviceManagerCapability, Pt as runtimeStatePolicyFor, Q as enumerateSchemaFields, R as buildStreamParamsConfigSchema, Sn as EventCategory, Xt as BaseAddon, Yt as errMsg, Z as enumerateItemArrayFields, a as CAMERA_SWITCH_ORDER, an as WELL_KNOWN_TAB_MAP, en as DeviceFeature, f as DeviceStatusSchema, gt as locationIconKey, h as LocationIconIdSchema, jt as resolveContainerPrimaryChild, mn as isDeviceConfigCap, nn as DeviceType, o as CAP_NAMES_WITH_STATUS, q as deviceStateCapability, t as ALL_CAPABILITY_DEFINITIONS, tn as DeviceRole, wt as normalizeUnit, xn as sleep$1 } from "../../dist-B4htkDVv.mjs";
-import { n as purgeRetiredSettingsRows } from "../../retired-settings-keys-C9w4b4TV.mjs";
+import { C as STREAM_PROFILE_META, Cn as EventCategory, Et as parseStreamParamsFormPatch, J as deviceStatusCapability, K as deviceManagerCapability, Pt as runtimeStatePolicyFor, Q as enumerateSchemaFields, R as buildStreamParamsConfigSchema, Sn as sleep$1, Xt as errMsg, Z as enumerateItemArrayFields, Zt as BaseAddon, a as CAMERA_SWITCH_ORDER, f as DeviceStatusSchema, gt as locationIconKey, h as LocationIconIdSchema, hn as isDeviceConfigCap, jt as resolveContainerPrimaryChild, nn as DeviceRole, o as CAP_NAMES_WITH_STATUS, on as WELL_KNOWN_TAB_MAP, q as deviceStateCapability, rn as DeviceType, t as ALL_CAPABILITY_DEFINITIONS, tn as DeviceFeature, wt as normalizeUnit, zt as siteZoneKey } from "../../dist-4MS1GNc8.mjs";
+import { n as purgeRetiredSettingsRows } from "../../retired-settings-keys-D_5MkKII.mjs";
 import { randomUUID } from "node:crypto";
 import { canonicalDeviceFingerprint } from "@camstack/types/node";
 //#region src/builtins/device-manager/adoption-job-engine.ts
@@ -5032,6 +5032,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 = 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 = 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 = 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 = siteZoneKey(input.from);
+	const toKey = 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 = 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 = 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
@@ -5087,14 +5315,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 () => {
@@ -5140,11 +5372,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;
@@ -5248,11 +5488,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 } : {}
 	};
 }
 /**
@@ -5276,6 +5522,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 = 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);
 }
@@ -7110,6 +7411,13 @@ var DeviceManagerAddon = class extends 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),

package/dist/builtins/device-manager/device-meta-actions.d.ts

@@ -244,6 +244,71 @@ export declare function listLocationIcons(pctx: ProviderContext): ReturnType<IDe
  * unordered write carries a stale copy of every other key.
  */
 export declare function setLocationIcon(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['setLocationIcon']>[0]): ReturnType<IDeviceManagerProvider['setLocationIcon']>;
+/**
+ * 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.
+ */
+export declare function listLocationDescriptions(pctx: ProviderContext): ReturnType<IDeviceManagerProvider['listLocationDescriptions']>;
+/**
+ * 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.
+ */
+export declare function setLocationDescription(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['setLocationDescription']>[0]): ReturnType<IDeviceManagerProvider['setLocationDescription']>;
+/**
+ * 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.
+ */
+export declare function listSiteZones(pctx: ProviderContext): ReturnType<IDeviceManagerProvider['listSiteZones']>;
+/**
+ * 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.
+ */
+export declare function setSiteZone(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['setSiteZone']>[0]): ReturnType<IDeviceManagerProvider['setSiteZone']>;
+/**
+ * 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.
+ */
+export declare function removeSiteZone(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['removeSiteZone']>[0]): ReturnType<IDeviceManagerProvider['removeSiteZone']>;
+/**
+ * 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.
+ */
+export declare function renameSiteZone(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['renameSiteZone']>[0]): ReturnType<IDeviceManagerProvider['renameSiteZone']>;
+/**
+ * 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.
+ */
+export declare function setLocationZone(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['setLocationZone']>[0]): ReturnType<IDeviceManagerProvider['setLocationZone']>;
 /**
  * Remove a label from the curated registry. Match is
  * case-insensitive. Devices that still reference this label keep

package/dist/builtins/device-manager/device-meta-types.d.ts

@@ -177,6 +177,47 @@ export interface AddonStore {
      * hole. Dropping it degrades the location to the fallback pin instead.
      */
     locationIcons?: Readonly<Record<string, LocationIconId>>;
+    /**
+     * What each location LOOKS like, in the operator's own words, keyed the same
+     * way as {@link AddonStore.locationIcons}.
+     *
+     * Beside the icon and not in the consumer that reads it (the summary AI)
+     * because it is a fact about the PLACE, not about the digest. It lived in
+     * the post-analysis addon's settings, keyed by a hand-typed label matched
+     * exactly and case-sensitively, and the cost was invisible: a rename in the
+     * Locations page carried the icon and left the description on a key no
+     * location would ever carry again.
+     *
+     * A value that is not a non-empty string is DROPPED on decode — an empty
+     * description costs the model attention and says nothing, so it must never
+     * reach it.
+     */
+    locationDescriptions?: Readonly<Record<string, string>>;
+    /**
+     * SITE ZONES — named parts of the property that group locations, keyed by
+     * `siteZoneKey(label)`. The label is stored as the operator typed it; the
+     * key is what everything else joins on.
+     *
+     * Split from {@link AddonStore.locationZones} on purpose: a zone EXISTS
+     * independently of anything being in it. Folding the two into one map would
+     * make an empty zone unrepresentable, so creating one and then filling it —
+     * the obvious order — would be impossible, and clearing the last room would
+     * silently delete the zone and its icon.
+     */
+    siteZones?: Readonly<Record<string, SiteZoneRecord>>;
+    /**
+     * Which zone each location belongs to: `locationKey → zoneKey`.
+     *
+     * This direction, not `zone → locations`, because it makes "at most one zone
+     * per location" true BY CONSTRUCTION rather than by a check somebody has to
+     * remember — there is one slot, so a second assignment moves the room
+     * instead of duplicating it.
+     *
+     * Keyed on the folded location label, like the icon and the description, and
+     * carried by `renameLocation` / dropped by `removeLocation` for the same
+     * reason they are: this repo has already lost an icon to a rename once.
+     */
+    locationZones?: Readonly<Record<string, string>>;
     /** Operator-authored per-role display defaults (unit/precision/icon), keyed
      *  by `DeviceRole` string. Resolution merges these UNDER any per-device
      *  `display` override. Written whole-record by `setRoleDisplayDefaults`
@@ -192,3 +233,11 @@ export interface AddonStore {
  * cost the caller its default, never a downstream `TypeError`.
  */
 export declare function decodeAddonStore(raw: Record<string, unknown>): AddonStore;
+/**
+ * One zone on disk. The icon is OPTIONAL and absent means "nobody chose one" —
+ * never the fallback pin, which is the renderer's business.
+ */
+export interface SiteZoneRecord {
+    readonly label: string;
+    readonly icon?: LocationIconId;
+}

package/dist/builtins/doorbell/virtual-doorbell.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/doorbell/trigger-engine.ts
 /**
 * Pure trigger logic for the virtual-doorbell builtin — edge detection over

package/dist/builtins/doorbell/virtual-doorbell.addon.mjs

@@ -1,4 +1,4 @@
-import { $ as evaluateSensorEdge, I as bareAddonId, Sn as EventCategory, Xt as BaseAddon, Y as doorbellCapability, Yt as errMsg, b as SOURCE_CAPS, ln as createEvent, lt as isSameAddonId, nn as DeviceType, ut as isSourceCap, x as SOURCE_DEVICE_TYPES } from "../../dist-B4htkDVv.mjs";
+import { $ as evaluateSensorEdge, Cn as EventCategory, I as bareAddonId, Xt as errMsg, Y as doorbellCapability, Zt as BaseAddon, b as SOURCE_CAPS, lt as isSameAddonId, rn as DeviceType, un as createEvent, ut as isSourceCap, x as SOURCE_DEVICE_TYPES } from "../../dist-4MS1GNc8.mjs";
 //#region src/builtins/doorbell/trigger-engine.ts
 /**
 * Pure trigger logic for the virtual-doorbell builtin — edge detection over

package/dist/builtins/hub-forwarder/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/hub-forwarder/hub-forwarder-destination.ts
 var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;

package/dist/builtins/hub-forwarder/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/hub-forwarder/hub-forwarder-destination.ts
 var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;

package/dist/builtins/liveness-monitor/liveness-monitor.addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(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/liveness-monitor/liveness-checks.ts
 var NO_DEVICES = "liveness:no-devices";
 var ALL_OFFLINE = "liveness:all-devices-offline";

package/dist/builtins/liveness-monitor/liveness-monitor.addon.mjs

@@ -1,4 +1,4 @@
-import { Sn as EventCategory, Xt as BaseAddon, Yt as errMsg, ln as createEvent, y as RecordingStatusSchema } from "../../dist-B4htkDVv.mjs";
+import { Cn as EventCategory, Xt as errMsg, Zt as BaseAddon, un as createEvent, y as RecordingStatusSchema } from "../../dist-4MS1GNc8.mjs";
 //#region src/builtins/liveness-monitor/liveness-checks.ts
 var NO_DEVICES = "liveness:no-devices";
 var ALL_OFFLINE = "liveness:all-devices-offline";

package/dist/builtins/local-auth/local-auth.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");
 node_crypto = require_chunk.__toESM(node_crypto);
 let crypto$1 = require("crypto");

package/dist/builtins/local-auth/local-auth.addon.mjs

@@ -1,5 +1,5 @@
 import { i as __require, o as __toESM, t as __commonJSMin } from "../../chunk-CNf5ZN-e.mjs";
-import { Gt as userManagementCapability, P as authProviderCapability, Xt as BaseAddon, k as UserRecordSchema, r as ApiKeyRecordSchema, w as ScopedTokenSchema } from "../../dist-B4htkDVv.mjs";
+import { Kt as userManagementCapability, P as authProviderCapability, Zt as BaseAddon, k as UserRecordSchema, r as ApiKeyRecordSchema, w as ScopedTokenSchema } from "../../dist-4MS1GNc8.mjs";
 import * as crypto$2 from "node:crypto";
 import { createHash, randomUUID, timingSafeEqual } from "node:crypto";
 import nodeCrypto from "crypto";

package/dist/builtins/local-network/local-network.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");
 const require_tls = require("../../tls-BFs4PzoW.js");
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");

package/dist/builtins/local-network/local-network.addon.mjs

@@ -1,4 +1,4 @@
-import { Sn as EventCategory, Xt as BaseAddon, ht as localNetworkCapability } from "../../dist-B4htkDVv.mjs";
+import { Cn as EventCategory, Zt as BaseAddon, ht as localNetworkCapability } from "../../dist-4MS1GNc8.mjs";
 import { S as readLanHttpState, _ as DEFAULT_LAN_HTTP_PORT, a as writeTlsMode, i as writeExtraSans, l as reissueTlsLeaf, n as readTlsAccessStatus, o as validateUploadedTls, r as readTlsMode, s as ensureTlsCert, t as readExtraSans, y as applyLanHttp } from "../../tls-2xbgg78V.mjs";
 import { mkdir, writeFile } from "node:fs/promises";
 import { join } from "node:path";

package/dist/builtins/loki-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");
 //#region src/builtins/loki-logging/loki-payload.ts
 /**
 * Loki rejects a label name that is not a valid Prometheus label

package/dist/builtins/loki-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";
 //#region src/builtins/loki-logging/loki-payload.ts
 /**
 * Loki rejects a label name that is not a valid Prometheus label

package/dist/builtins/native-metrics/native-metrics.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_fs_promises = require("node:fs/promises");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);

package/dist/builtins/native-metrics/native-metrics.addon.mjs

@@ -1,4 +1,4 @@
-import { At as resolveBucketMs, Sn as EventCategory, St as metricsProviderCapability, Xt as BaseAddon, Yt as errMsg, kt as reducePoints, ln as createEvent, rt as foldSnapshotByFunction } from "../../dist-B4htkDVv.mjs";
+import { At as resolveBucketMs, Cn as EventCategory, St as metricsProviderCapability, Xt as errMsg, Zt as BaseAddon, kt as reducePoints, rt as foldSnapshotByFunction, un as createEvent } from "../../dist-4MS1GNc8.mjs";
 import { access, readFile, readdir } from "node:fs/promises";
 import * as fs from "node:fs";
 import { constants, readFileSync } from "node:fs";

package/dist/builtins/platform-probe/index.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_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
 let node_child_process = require("node:child_process");

package/dist/builtins/platform-probe/index.mjs

@@ -1,5 +1,5 @@
 import { o as __toESM } from "../../chunk-CNf5ZN-e.mjs";
-import { Dt as platformProbeCapability, Lt as scoreRuntimes, Sn as EventCategory, X as enumerateInferenceDevices, Xt as BaseAddon, Yt as errMsg, dn as emitReadiness } from "../../dist-B4htkDVv.mjs";
+import { Cn as EventCategory, Dt as platformProbeCapability, Lt as scoreRuntimes, X as enumerateInferenceDevices, Xt as errMsg, Zt as BaseAddon, fn as emitReadiness } from "../../dist-4MS1GNc8.mjs";
 import * as fs from "node:fs";
 import { execFile } from "node:child_process";
 import * as os from "node:os";