@camstack/addon-provider-homeassistant 1.2.152 → 1.2.154

package/dist/addon.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_dist = require("./dist-nbfaHTXG.js");
+const require_dist = require("./dist-DLQgcqQT.js");
 let node_crypto = require("node:crypto");
 let node_zlib = require("node:zlib");
 //#region src/ha-admin-link.ts
@@ -960,7 +960,9 @@ var HaBinarySensorDevice = class extends HaBaseChildDevice {
 		this.capName = capName;
 		this.registerCap(capName);
 		const stored = this.runtimeState.getCapState(capName);
-		this.runtimeState.setCapState(this.capName, buildSlice(capName, false, 0, stored));
+		const seededActive = storedActiveLevel(capName, stored) ?? false;
+		const seededChangedAt = storedChangedAt(capName, stored) ?? 0;
+		this.runtimeState.setCapState(this.capName, buildSlice(capName, seededActive, seededChangedAt, stored));
 	}
 	handleStatePush(state) {
 		if (state.state === "unavailable" || state.state === "unknown") return;
@@ -1052,6 +1054,32 @@ function priorLastDetectedAt(prior) {
 	const raw = prior?.["lastDetectedAt"];
 	return typeof raw === "number" && Number.isFinite(raw) && raw > 0 ? raw : null;
 }
+/** The boolean field this cap's slice uses as "active". */
+function activeFieldName(capName) {
+	switch (capName) {
+		case "contact": return "entryOpen";
+		case "flood": return "flooded";
+		case "tamper": return "tampered";
+		case "connectivity": return "connected";
+		case "binary": return "on";
+		case "smoke":
+		case "carbon-monoxide":
+		case "gas":
+		case "vibration":
+		case "motion": return "detected";
+	}
+}
+function storedActiveLevel(capName, stored) {
+	if (stored === void 0) return void 0;
+	const raw = stored[activeFieldName(capName)];
+	return typeof raw === "boolean" ? raw : void 0;
+}
+function storedChangedAt(capName, stored) {
+	if (stored === void 0) return void 0;
+	if (capName === "motion") return priorLastDetectedAt(stored) ?? void 0;
+	const raw = stored["lastChangedAt"];
+	return typeof raw === "number" && Number.isFinite(raw) && raw > 0 ? raw : void 0;
+}
 function buildSlice(capName, active, lastChangedAt, prior) {
 	switch (capName) {
 		case "contact": return {
@@ -5102,6 +5130,7 @@ var HaIntegrationManager = class HaIntegrationManager {
 		if (target.deviceId) targetEnvelope["device_id"] = target.deviceId;
 		if (Object.keys(targetEnvelope).length > 0) message["target"] = targetEnvelope;
 		if (payload !== void 0 && payload !== null) message["service_data"] = payload;
+		if (target.returnResponse === true) message["return_response"] = true;
 		const result = await conn.sendMessagePromise(message);
 		if (result && typeof result === "object") return result;
 		return null;
@@ -7043,6 +7072,122 @@ function createHaNotificationOutputProvider(deps) {
 	};
 }
 //#endregion
+//#region src/ha-calendar-source.ts
+function isCalendarEntity(entityId) {
+	return entityId.startsWith("calendar.");
+}
+function calendarName(state) {
+	const friendly = state.attributes["friendly_name"];
+	if (typeof friendly === "string" && friendly.trim().length > 0) return friendly.trim();
+	return state.entity_id.replace(/^calendar\./, "").replace(/_/g, " ");
+}
+function parseHaDate(value) {
+	if (typeof value !== "string" || value.length === 0) return null;
+	const ms = Date.parse(value.length === 10 ? `${value}T00:00:00` : value);
+	return Number.isFinite(ms) ? ms : null;
+}
+function isRecord(x) {
+	return typeof x === "object" && x !== null && !Array.isArray(x);
+}
+function asEntityState(raw) {
+	const parsed = HaEntityStateSchema.safeParse(raw);
+	return parsed.success ? parsed.data : null;
+}
+/**
+* HA's `calendar.list_events` response shape (return_response):
+* `{ response: { [entity_id]: { events: [...] } } }` or a flat
+* `{ events: [...] }` depending on target width.
+*/
+function extractEvents(result, entityId) {
+	if (!isRecord(result)) return [];
+	const response = result["response"];
+	if (isRecord(response)) {
+		const forEntity = response[entityId];
+		if (isRecord(forEntity) && Array.isArray(forEntity["events"])) return forEntity["events"].filter(isRecord);
+		for (const value of Object.values(response)) if (isRecord(value) && Array.isArray(value["events"])) return value["events"].filter(isRecord);
+	}
+	if (Array.isArray(result["events"])) return result["events"].filter(isRecord);
+	return [];
+}
+function mapEvent(entityId, raw, index) {
+	const startRaw = raw["start"];
+	const endRaw = raw["end"];
+	const startMs = parseHaDate(isRecord(startRaw) ? startRaw["dateTime"] ?? startRaw["date"] : raw["start"] ?? raw["start_date_time"] ?? raw["dtstart"]);
+	const endMs = parseHaDate(isRecord(endRaw) ? endRaw["dateTime"] ?? endRaw["date"] : raw["end"] ?? raw["end_date_time"] ?? raw["dtend"]) ?? startMs;
+	if (startMs === null || endMs === null) return null;
+	const summary = raw["summary"] ?? raw["title"];
+	const title = typeof summary === "string" ? summary : "(no title)";
+	const uid = raw["uid"] ?? raw["id"];
+	const id = typeof uid === "string" && uid.length > 0 ? `${entityId}:${uid}` : `${entityId}:${String(startMs)}:${String(index)}`;
+	const description = raw["description"];
+	const location = raw["location"];
+	return {
+		id,
+		calendarId: entityId,
+		title,
+		startMs,
+		endMs,
+		...isRecord(startRaw) && typeof startRaw["date"] === "string" || typeof raw["start"] === "string" && raw["start"].length === 10 ? { allDay: true } : {},
+		...typeof description === "string" && description.length > 0 ? { description } : {},
+		...typeof location === "string" && location.length > 0 ? { location } : {}
+	};
+}
+function createHaCalendarSource(deps) {
+	return {
+		listCalendars: async () => {
+			const out = [];
+			for (const { manager } of deps.brokers.listManagers()) {
+				const states = manager.snapshotAllStates();
+				for (const [entityId, raw] of Object.entries(states)) {
+					if (!isCalendarEntity(entityId)) continue;
+					const state = asEntityState(raw);
+					if (state === null) continue;
+					out.push({
+						id: entityId,
+						name: calendarName(state),
+						source: "ha",
+						enabled: state.state !== "unavailable"
+					});
+				}
+			}
+			return out;
+		},
+		listEvents: async (input) => {
+			const startIso = new Date(input.startMs).toISOString();
+			const endIso = new Date(input.endMs).toISOString();
+			const wanted = input.calendarIds !== void 0 && input.calendarIds.length > 0 ? new Set(input.calendarIds) : null;
+			const out = [];
+			for (const { brokerId, manager } of deps.brokers.listManagers()) {
+				const states = manager.snapshotAllStates();
+				const entityIds = Object.keys(states).filter((id) => isCalendarEntity(id) && (wanted === null || wanted.has(id)));
+				for (const entityId of entityIds) try {
+					const target = {
+						domain: "calendar",
+						service: "list_events",
+						entityId,
+						returnResponse: true
+					};
+					const rawEvents = extractEvents(await manager.publish(target, {
+						start_date_time: startIso,
+						end_date_time: endIso
+					}), entityId);
+					for (let i = 0; i < rawEvents.length; i += 1) {
+						const mapped = mapEvent(entityId, rawEvents[i], i);
+						if (mapped !== null) out.push(mapped);
+					}
+				} catch (err) {
+					deps.logger.warn("HA calendar.list_events failed", { meta: {
+						entityId,
+						brokerId,
+						error: err instanceof Error ? err.message : String(err)
+					} });
+				}
+			}
+			return out.toSorted((a, b) => a.startMs - b.startMs);
+		}
+	};
+}
+//#endregion
 //#region src/ha-reconcile-broker.ts
 /**
 * Run BOTH reconcilers for one broker off a SINGLE shared inventory fetch.
@@ -7371,11 +7516,14 @@ function buildFreshStandaloneSpec(entity) {
 /** Stable key over the class-affecting fields — drives the drift decision.
 *  Excludes `type` (compared directly) but folds it in so a pure type change
 *  (same caps, different DeviceType — shouldn't happen but defensively safe)
-*  still counts. */
+*  still counts. **Role is deliberately omitted**: after adopt, Role is
+*  operator-owned (`setRole` in the UI). Including it here made every mapping
+*  / capability drift re-push the derived role via `applyDerivedSpec` and
+*  revert the Role select by itself.
+*/
 function standaloneDerivedKey(s) {
 	return JSON.stringify({
 		type: s.type,
-		role: s.role ?? null,
 		capabilities: [...s.capabilities],
 		unitOfMeasurement: s.unitOfMeasurement ?? null,
 		deviceClass: s.deviceClass ?? null,
@@ -7385,7 +7533,8 @@ function standaloneDerivedKey(s) {
 	});
 }
 /** The config patch pushed via `applyDerivedSpec` on drift — the class-affecting
-*  fields only (mirrors the Container reconcile's `childConfigPatch`). */
+*  fields only (mirrors the Container reconcile's `childConfigPatch`), minus
+*  `role` which is operator-owned after adopt and must not be clobbered. */
 function standaloneConfigPatch(s) {
 	return {
 		capabilities: [...s.capabilities],
@@ -7393,22 +7542,21 @@ function standaloneConfigPatch(s) {
 		...s.deviceClass !== void 0 ? { deviceClass: s.deviceClass } : {},
 		...s.options !== void 0 ? { options: [...s.options] } : {},
 		...s.features !== void 0 ? { features: [...s.features] } : {},
-		...s.role !== void 0 ? { role: s.role } : {},
 		...s.dateTimeFormat !== void 0 ? { dateTimeFormat: s.dateTimeFormat } : {}
 	};
 }
 /**
 * Diff a persisted standalone entity device against the fresh HA mapping. Pure —
-* no I/O. On drift the caller pushes `{ type, role?, config }` through
+* no I/O. On drift the caller pushes `{ type, config }` through
 * `kernel.devices.applyDerivedSpec(deviceId, …)`; the captured cap-re-derive
 * factory rebuilds the concrete per-domain class from the new `capabilities`.
+* Role is never part of the patch — it is operator-owned after adopt.
 */
 function diffStandaloneEntity(persisted, fresh) {
 	if (standaloneDerivedKey(persisted) === standaloneDerivedKey(fresh)) return { changed: false };
 	return {
 		changed: true,
 		type: fresh.type,
-		...fresh.role !== void 0 ? { role: fresh.role } : {},
 		config: standaloneConfigPatch(fresh)
 	};
 }
@@ -7438,7 +7586,7 @@ function standaloneEntityId(device) {
 * Pure re-sync planner. Given the broker's live registry `devices` and the
 * FRESH entity inventory (by entityId), enumerate the broker's STANDALONE entity
 * devices and produce one `applyDerivedSpec` action per device whose
-* capability/class/role drifted. No I/O.
+* capability/class drifted. Role is never re-derived (operator-owned). No I/O.
 *
 *   - Non-standalone / other-broker / Container / accessory-child devices →
 *     skipped (via {@link isStandaloneEntityDevice}).
@@ -7460,7 +7608,6 @@ function planStandaloneReconcile(devices, freshById, brokerId) {
 		actions.push({
 			deviceId: device.id,
 			...diff.type !== void 0 ? { type: diff.type } : {},
-			...diff.role !== void 0 ? { role: diff.role } : {},
 			...diff.config !== void 0 ? { config: diff.config } : {}
 		});
 	}
@@ -7566,6 +7713,13 @@ var HaProviderAddon = class HaProviderAddon extends require_dist.BaseDeviceProvi
 			{
 				capability: require_dist.addonRoutesCapability,
 				provider: createHaIconRouteProvider()
+			},
+			{
+				capability: require_dist.calendarSourceCapability,
+				provider: createHaCalendarSource({
+					brokers: this.requireRegistry(),
+					logger: this.ctx.logger.child("calendar-source")
+				})
 			}
 		];
 	}

package/dist/addon.mjs

@@ -1,4 +1,4 @@
-import { $ as parseAdminBase, A as contactCapability, At as union, B as gasCapability, C as buildAddonRouteProvider, Ct as array, D as climateControlCapability, Dt as object, E as carbonMonoxideCapability, Et as number, G as lockControlCapability, H as humiditySensorCapability, I as enumSensorCapability, J as normalizeUnit, K as mediaPlayerCapability, L as eventEmitterCapability, M as coverCapability, Mt as url, N as deviceAdminLinkCapability, Nt as EventCategory, O as colorCapability, Ot as record, P as deviceAdoptionCapability, R as fanControlCapability, S as brokerCapability, St as _enum, T as buttonCapability, Tt as literal, U as imageCapability, V as humidifierCapability, W as lawnMowerControlCapability, X as notifierCapability, Y as notificationOutputCapability, Z as numericSensorCapability, _ as automationControlCapability, _t as DeviceType, at as smokeCapability, b as binaryCapability, bt as createEvent, ct as temperatureSensorCapability, d as TargetSchema, dt as valveCapability, et as powerMeterCapability, f as accessoriesCapability, ft as vibrationCapability, g as ambientLightSensorCapability, gt as DeviceRole, h as alarmPanelCapability, ht as DeviceFeature, it as scriptRunnerCapability, j as controlCapability, jt as unknown, k as connectivityCapability, kt as string, lt as updateCapability, m as airQualitySensorCapability, mt as weatherCapability, n as BaseDevice, nt as presenceCapability, ot as switchCapability, p as addonRoutesCapability, pt as waterHeaterCapability, q as motionCapability, r as BaseDeviceProvider, rt as pressureSensorCapability, s as EnumSensorDateTimeFormatSchema, st as tamperCapability, tt as prepareNotification, ut as vacuumControlCapability, v as batteryCapability, vt as errMsg, w as buildDeviceAdminUrl, wt as discriminatedUnion, x as brightnessCapability, y as bestLocationMatch, z as floodCapability } from "./dist-BITMr6s5.mjs";
+import { A as connectivityCapability, At as string, B as floodCapability, C as buildAddonRouteProvider, Ct as _enum, D as carbonMonoxideCapability, Dt as number, E as calendarSourceCapability, Et as literal, F as deviceAdoptionCapability, G as lawnMowerControlCapability, H as humidifierCapability, J as motionCapability, K as lockControlCapability, L as enumSensorCapability, M as controlCapability, Mt as unknown, N as coverCapability, Nt as url, O as climateControlCapability, Ot as object, P as deviceAdminLinkCapability, Pt as EventCategory, Q as numericSensorCapability, R as eventEmitterCapability, S as brokerCapability, T as buttonCapability, Tt as discriminatedUnion, U as humiditySensorCapability, V as gasCapability, W as imageCapability, X as notificationOutputCapability, Y as normalizeUnit, Z as notifierCapability, _ as automationControlCapability, _t as DeviceRole, at as scriptRunnerCapability, b as binaryCapability, ct as tamperCapability, d as TargetSchema, dt as vacuumControlCapability, et as parseAdminBase, f as accessoriesCapability, ft as valveCapability, g as ambientLightSensorCapability, gt as DeviceFeature, h as alarmPanelCapability, ht as weatherCapability, it as pressureSensorCapability, j as contactCapability, jt as union, k as colorCapability, kt as record, lt as temperatureSensorCapability, m as airQualitySensorCapability, mt as waterHeaterCapability, n as BaseDevice, nt as prepareNotification, ot as smokeCapability, p as addonRoutesCapability, pt as vibrationCapability, q as mediaPlayerCapability, r as BaseDeviceProvider, rt as presenceCapability, s as EnumSensorDateTimeFormatSchema, st as switchCapability, tt as powerMeterCapability, ut as updateCapability, v as batteryCapability, vt as DeviceType, w as buildDeviceAdminUrl, wt as array, x as brightnessCapability, xt as createEvent, y as bestLocationMatch, yt as errMsg, z as fanControlCapability } from "./dist-CvzpCuzm.mjs";
 import { randomUUID } from "node:crypto";
 import { brotliCompressSync, deflateSync, gzipSync } from "node:zlib";
 //#region src/ha-admin-link.ts
@@ -959,7 +959,9 @@ var HaBinarySensorDevice = class extends HaBaseChildDevice {
 		this.capName = capName;
 		this.registerCap(capName);
 		const stored = this.runtimeState.getCapState(capName);
-		this.runtimeState.setCapState(this.capName, buildSlice(capName, false, 0, stored));
+		const seededActive = storedActiveLevel(capName, stored) ?? false;
+		const seededChangedAt = storedChangedAt(capName, stored) ?? 0;
+		this.runtimeState.setCapState(this.capName, buildSlice(capName, seededActive, seededChangedAt, stored));
 	}
 	handleStatePush(state) {
 		if (state.state === "unavailable" || state.state === "unknown") return;
@@ -1051,6 +1053,32 @@ function priorLastDetectedAt(prior) {
 	const raw = prior?.["lastDetectedAt"];
 	return typeof raw === "number" && Number.isFinite(raw) && raw > 0 ? raw : null;
 }
+/** The boolean field this cap's slice uses as "active". */
+function activeFieldName(capName) {
+	switch (capName) {
+		case "contact": return "entryOpen";
+		case "flood": return "flooded";
+		case "tamper": return "tampered";
+		case "connectivity": return "connected";
+		case "binary": return "on";
+		case "smoke":
+		case "carbon-monoxide":
+		case "gas":
+		case "vibration":
+		case "motion": return "detected";
+	}
+}
+function storedActiveLevel(capName, stored) {
+	if (stored === void 0) return void 0;
+	const raw = stored[activeFieldName(capName)];
+	return typeof raw === "boolean" ? raw : void 0;
+}
+function storedChangedAt(capName, stored) {
+	if (stored === void 0) return void 0;
+	if (capName === "motion") return priorLastDetectedAt(stored) ?? void 0;
+	const raw = stored["lastChangedAt"];
+	return typeof raw === "number" && Number.isFinite(raw) && raw > 0 ? raw : void 0;
+}
 function buildSlice(capName, active, lastChangedAt, prior) {
 	switch (capName) {
 		case "contact": return {
@@ -5101,6 +5129,7 @@ var HaIntegrationManager = class HaIntegrationManager {
 		if (target.deviceId) targetEnvelope["device_id"] = target.deviceId;
 		if (Object.keys(targetEnvelope).length > 0) message["target"] = targetEnvelope;
 		if (payload !== void 0 && payload !== null) message["service_data"] = payload;
+		if (target.returnResponse === true) message["return_response"] = true;
 		const result = await conn.sendMessagePromise(message);
 		if (result && typeof result === "object") return result;
 		return null;
@@ -7042,6 +7071,122 @@ function createHaNotificationOutputProvider(deps) {
 	};
 }
 //#endregion
+//#region src/ha-calendar-source.ts
+function isCalendarEntity(entityId) {
+	return entityId.startsWith("calendar.");
+}
+function calendarName(state) {
+	const friendly = state.attributes["friendly_name"];
+	if (typeof friendly === "string" && friendly.trim().length > 0) return friendly.trim();
+	return state.entity_id.replace(/^calendar\./, "").replace(/_/g, " ");
+}
+function parseHaDate(value) {
+	if (typeof value !== "string" || value.length === 0) return null;
+	const ms = Date.parse(value.length === 10 ? `${value}T00:00:00` : value);
+	return Number.isFinite(ms) ? ms : null;
+}
+function isRecord(x) {
+	return typeof x === "object" && x !== null && !Array.isArray(x);
+}
+function asEntityState(raw) {
+	const parsed = HaEntityStateSchema.safeParse(raw);
+	return parsed.success ? parsed.data : null;
+}
+/**
+* HA's `calendar.list_events` response shape (return_response):
+* `{ response: { [entity_id]: { events: [...] } } }` or a flat
+* `{ events: [...] }` depending on target width.
+*/
+function extractEvents(result, entityId) {
+	if (!isRecord(result)) return [];
+	const response = result["response"];
+	if (isRecord(response)) {
+		const forEntity = response[entityId];
+		if (isRecord(forEntity) && Array.isArray(forEntity["events"])) return forEntity["events"].filter(isRecord);
+		for (const value of Object.values(response)) if (isRecord(value) && Array.isArray(value["events"])) return value["events"].filter(isRecord);
+	}
+	if (Array.isArray(result["events"])) return result["events"].filter(isRecord);
+	return [];
+}
+function mapEvent(entityId, raw, index) {
+	const startRaw = raw["start"];
+	const endRaw = raw["end"];
+	const startMs = parseHaDate(isRecord(startRaw) ? startRaw["dateTime"] ?? startRaw["date"] : raw["start"] ?? raw["start_date_time"] ?? raw["dtstart"]);
+	const endMs = parseHaDate(isRecord(endRaw) ? endRaw["dateTime"] ?? endRaw["date"] : raw["end"] ?? raw["end_date_time"] ?? raw["dtend"]) ?? startMs;
+	if (startMs === null || endMs === null) return null;
+	const summary = raw["summary"] ?? raw["title"];
+	const title = typeof summary === "string" ? summary : "(no title)";
+	const uid = raw["uid"] ?? raw["id"];
+	const id = typeof uid === "string" && uid.length > 0 ? `${entityId}:${uid}` : `${entityId}:${String(startMs)}:${String(index)}`;
+	const description = raw["description"];
+	const location = raw["location"];
+	return {
+		id,
+		calendarId: entityId,
+		title,
+		startMs,
+		endMs,
+		...isRecord(startRaw) && typeof startRaw["date"] === "string" || typeof raw["start"] === "string" && raw["start"].length === 10 ? { allDay: true } : {},
+		...typeof description === "string" && description.length > 0 ? { description } : {},
+		...typeof location === "string" && location.length > 0 ? { location } : {}
+	};
+}
+function createHaCalendarSource(deps) {
+	return {
+		listCalendars: async () => {
+			const out = [];
+			for (const { manager } of deps.brokers.listManagers()) {
+				const states = manager.snapshotAllStates();
+				for (const [entityId, raw] of Object.entries(states)) {
+					if (!isCalendarEntity(entityId)) continue;
+					const state = asEntityState(raw);
+					if (state === null) continue;
+					out.push({
+						id: entityId,
+						name: calendarName(state),
+						source: "ha",
+						enabled: state.state !== "unavailable"
+					});
+				}
+			}
+			return out;
+		},
+		listEvents: async (input) => {
+			const startIso = new Date(input.startMs).toISOString();
+			const endIso = new Date(input.endMs).toISOString();
+			const wanted = input.calendarIds !== void 0 && input.calendarIds.length > 0 ? new Set(input.calendarIds) : null;
+			const out = [];
+			for (const { brokerId, manager } of deps.brokers.listManagers()) {
+				const states = manager.snapshotAllStates();
+				const entityIds = Object.keys(states).filter((id) => isCalendarEntity(id) && (wanted === null || wanted.has(id)));
+				for (const entityId of entityIds) try {
+					const target = {
+						domain: "calendar",
+						service: "list_events",
+						entityId,
+						returnResponse: true
+					};
+					const rawEvents = extractEvents(await manager.publish(target, {
+						start_date_time: startIso,
+						end_date_time: endIso
+					}), entityId);
+					for (let i = 0; i < rawEvents.length; i += 1) {
+						const mapped = mapEvent(entityId, rawEvents[i], i);
+						if (mapped !== null) out.push(mapped);
+					}
+				} catch (err) {
+					deps.logger.warn("HA calendar.list_events failed", { meta: {
+						entityId,
+						brokerId,
+						error: err instanceof Error ? err.message : String(err)
+					} });
+				}
+			}
+			return out.toSorted((a, b) => a.startMs - b.startMs);
+		}
+	};
+}
+//#endregion
 //#region src/ha-reconcile-broker.ts
 /**
 * Run BOTH reconcilers for one broker off a SINGLE shared inventory fetch.
@@ -7370,11 +7515,14 @@ function buildFreshStandaloneSpec(entity) {
 /** Stable key over the class-affecting fields — drives the drift decision.
 *  Excludes `type` (compared directly) but folds it in so a pure type change
 *  (same caps, different DeviceType — shouldn't happen but defensively safe)
-*  still counts. */
+*  still counts. **Role is deliberately omitted**: after adopt, Role is
+*  operator-owned (`setRole` in the UI). Including it here made every mapping
+*  / capability drift re-push the derived role via `applyDerivedSpec` and
+*  revert the Role select by itself.
+*/
 function standaloneDerivedKey(s) {
 	return JSON.stringify({
 		type: s.type,
-		role: s.role ?? null,
 		capabilities: [...s.capabilities],
 		unitOfMeasurement: s.unitOfMeasurement ?? null,
 		deviceClass: s.deviceClass ?? null,
@@ -7384,7 +7532,8 @@ function standaloneDerivedKey(s) {
 	});
 }
 /** The config patch pushed via `applyDerivedSpec` on drift — the class-affecting
-*  fields only (mirrors the Container reconcile's `childConfigPatch`). */
+*  fields only (mirrors the Container reconcile's `childConfigPatch`), minus
+*  `role` which is operator-owned after adopt and must not be clobbered. */
 function standaloneConfigPatch(s) {
 	return {
 		capabilities: [...s.capabilities],
@@ -7392,22 +7541,21 @@ function standaloneConfigPatch(s) {
 		...s.deviceClass !== void 0 ? { deviceClass: s.deviceClass } : {},
 		...s.options !== void 0 ? { options: [...s.options] } : {},
 		...s.features !== void 0 ? { features: [...s.features] } : {},
-		...s.role !== void 0 ? { role: s.role } : {},
 		...s.dateTimeFormat !== void 0 ? { dateTimeFormat: s.dateTimeFormat } : {}
 	};
 }
 /**
 * Diff a persisted standalone entity device against the fresh HA mapping. Pure —
-* no I/O. On drift the caller pushes `{ type, role?, config }` through
+* no I/O. On drift the caller pushes `{ type, config }` through
 * `kernel.devices.applyDerivedSpec(deviceId, …)`; the captured cap-re-derive
 * factory rebuilds the concrete per-domain class from the new `capabilities`.
+* Role is never part of the patch — it is operator-owned after adopt.
 */
 function diffStandaloneEntity(persisted, fresh) {
 	if (standaloneDerivedKey(persisted) === standaloneDerivedKey(fresh)) return { changed: false };
 	return {
 		changed: true,
 		type: fresh.type,
-		...fresh.role !== void 0 ? { role: fresh.role } : {},
 		config: standaloneConfigPatch(fresh)
 	};
 }
@@ -7437,7 +7585,7 @@ function standaloneEntityId(device) {
 * Pure re-sync planner. Given the broker's live registry `devices` and the
 * FRESH entity inventory (by entityId), enumerate the broker's STANDALONE entity
 * devices and produce one `applyDerivedSpec` action per device whose
-* capability/class/role drifted. No I/O.
+* capability/class drifted. Role is never re-derived (operator-owned). No I/O.
 *
 *   - Non-standalone / other-broker / Container / accessory-child devices →
 *     skipped (via {@link isStandaloneEntityDevice}).
@@ -7459,7 +7607,6 @@ function planStandaloneReconcile(devices, freshById, brokerId) {
 		actions.push({
 			deviceId: device.id,
 			...diff.type !== void 0 ? { type: diff.type } : {},
-			...diff.role !== void 0 ? { role: diff.role } : {},
 			...diff.config !== void 0 ? { config: diff.config } : {}
 		});
 	}
@@ -7565,6 +7712,13 @@ var HaProviderAddon = class HaProviderAddon extends BaseDeviceProvider {
 			{
 				capability: addonRoutesCapability,
 				provider: createHaIconRouteProvider()
+			},
+			{
+				capability: calendarSourceCapability,
+				provider: createHaCalendarSource({
+					brokers: this.requireRegistry(),
+					logger: this.ctx.logger.child("calendar-source")
+				})
 			}
 		];
 	}