@camstack/addon-provider-enpal 0.1.20 → 0.1.21

package/CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.21] - 2026-11-14
+
+### Changed
+
+- Enpal: the grid frequency shows in Hz, and the LTE RSRQ and SNR in dB
+- The integration shows the official Enpal icon
+- House and heat-pump meters are named apart, and the energy system reports battery health.
+
 ## [0.1.20] - 2026-11-13
 
 ### Changed

package/dist/addon.js

@@ -6066,7 +6066,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-Cykc2bzi.mjs
+//#region ../types/dist/sleep-D7hCDd7y.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -10377,6 +10377,8 @@ var READING_QUANTITIES = [
 	"information",
 	"sound-level",
 	"signal-level",
+	"signal-ratio",
+	"frequency",
 	"colour-temperature",
 	"angle",
 	"bitrate",
@@ -10420,6 +10422,8 @@ var QUANTITY_BASE = {
 	information: "B",
 	"sound-level": "dBFS",
 	"signal-level": "dBm",
+	"signal-ratio": "dB",
+	frequency: "Hz",
 	"colour-temperature": "mired",
 	angle: "°",
 	bitrate: "kbps",
@@ -10772,41 +10776,57 @@ var CAP_VOCABULARY_BY_NAME = {
 			en: "Switch",
 			it: "Interruttore"
 		},
-		actions: [{
-			id: "switch.on",
-			method: "setState",
-			label: {
-				en: "Turn on",
-				it: "Accendi"
-			},
-			phrase: {
-				en: "Turn on {device}",
-				it: "Accendi {device}"
-			},
-			icon: "power",
-			args: { on: true },
-			effect: {
-				field: "on",
-				value: true
-			}
-		}, {
-			id: "switch.off",
-			method: "setState",
-			label: {
-				en: "Turn off",
-				it: "Spegni"
+		actions: [
+			{
+				id: "switch.on",
+				method: "setState",
+				label: {
+					en: "Turn on",
+					it: "Accendi"
+				},
+				phrase: {
+					en: "Turn on {device}",
+					it: "Accendi {device}"
+				},
+				icon: "power",
+				args: { on: true },
+				effect: {
+					field: "on",
+					value: true
+				}
 			},
-			phrase: {
-				en: "Turn off {device}",
-				it: "Spegni {device}"
+			{
+				id: "switch.off",
+				method: "setState",
+				label: {
+					en: "Turn off",
+					it: "Spegni"
+				},
+				phrase: {
+					en: "Turn off {device}",
+					it: "Spegni {device}"
+				},
+				icon: "power-off",
+				args: { on: false },
+				effect: {
+					field: "on",
+					value: false
+				}
 			},
-			icon: "power-off",
-			args: { on: false },
-			effect: {
-				field: "on",
-				value: false
+			{
+				id: "switch.toggle",
+				method: "toggle",
+				label: {
+					en: "Toggle",
+					it: "Commuta"
+				},
+				phrase: {
+					en: "Toggle {device}",
+					it: "Commuta {device}"
+				},
+				icon: "toggle-right"
 			}
-		}],
+		],
 		state: [{
 			kind: "boolean",
 			field: "on",
@@ -20339,6 +20359,10 @@ Object.freeze({
 		{
 			"path": "storage.dischargedTodayKwh",
 			"valueType": "number"
+		},
+		{
+			"path": "storage.healthPct",
+			"valueType": "number"
 		}
 	],
 	"enum-sensor": [{
@@ -20719,6 +20743,10 @@ Object.freeze({
 			"path": "isMuted",
 			"valueType": "boolean"
 		},
+		{
+			"path": "muteReadback",
+			"valueType": "boolean"
+		},
 		{
 			"path": "source",
 			"valueType": "string"
@@ -22839,7 +22867,7 @@ var NodeColorIdSchema = _enum([
 	"node-h"
 ]);
 //#endregion
-//#region ../types/dist/convert-BAzH15HU.mjs
+//#region ../types/dist/convert-BwMfbk5b.mjs
 /**
 * Frozen unit → spec table. `•` in the doc marks each dimension's canonical
 * unit (`factor: 1, offset: 0`). °F derives from `°C = (°F − 32) × 5/9` ⇒
@@ -23172,6 +23200,21 @@ var UNIT_TABLE = {
 		factor: 1,
 		offset: 0
 	},
+	dB: {
+		dimension: "signal-ratio",
+		factor: 1,
+		offset: 0
+	},
+	Hz: {
+		dimension: "frequency",
+		factor: 1,
+		offset: 0
+	},
+	kHz: {
+		dimension: "frequency",
+		factor: 1e3,
+		offset: 0
+	},
 	mired: {
 		dimension: "colour-temperature",
 		factor: 1,
@@ -55494,7 +55537,9 @@ var ClusterUpdateFailureReasonSchema = _enum([
 	"status-unreadable",
 	"addon-update-failed",
 	"addons-not-converged",
-	"interrupted"
+	"interrupted",
+	"timeout-stall",
+	"timeout-ceiling"
 ]);
 var ClusterUpdateStepSchema = object({
 	kind: ClusterUpdateStepKindSchema,
@@ -57061,6 +57106,12 @@ var MediaPlayerStatusSchema = object({
 	/** Mute toggle distinct from volume=0. Null when no mute surface.
 	*  Pair with `DeviceFeature.MediaPlayerMute`. */
 	isMuted: boolean().nullable(),
+	/**
+	* True only when the provider READS the mute state back from the device.
+	* Absent or false: mute is a momentary key. A non-null `isMuted` is not a
+	* reading on its own — an infrared send can leave a value without this flag.
+	*/
+	muteReadback: boolean().optional(),
 	/** Active source / input. Empty when no source surface. */
 	source: string(),
 	/** Selectable sources. Empty when no source surface.
@@ -59764,9 +59815,15 @@ var SiteZoneSchema = object({
 	locationKeys: array(string())
 });
 var DeviceSearchRequiresSchema = object({
-	/** Capability names the field wants a value of. */
-	caps: array(string()).readonly(),
-	/** `any` (default): a device with one of them is compatible. `all`: it must hold every one. */
+	/** Capability names the field wants a value of. Absent when the field wants actions only. */
+	caps: array(string()).readonly().optional(),
+	/**
+	* Vocabulary action ids (`cover.open`) the device must offer. Compatible means
+	* the device's bindings resolve those actions; `values` stays empty when no
+	* cap was required. `mode` applies the same way as for `caps`.
+	*/
+	actions: array(string()).readonly().optional(),
+	/** `any` (default): one of the named caps, and one of the named actions, is enough. `all`: every one. */
 	mode: _enum(["any", "all"]).optional()
 });
 var DeviceSearchFiltersSchema = object({
@@ -63117,7 +63174,9 @@ var EnergyStorageSchema = object({
 	/** Lifetime discharged, kWh. */
 	dischargedKwh: number$1().nullable().meta(readingMeta("energy")),
 	chargedTodayKwh: number$1().nullable().meta(readingMeta("energy")),
-	dischargedTodayKwh: number$1().nullable().meta(readingMeta("energy"))
+	dischargedTodayKwh: number$1().nullable().meta(readingMeta("energy")),
+	/** State of health, 0..100. Null when the system did not report it. */
+	healthPct: number$1().nullable().meta(readingMeta("percentage"))
 });
 var EnergySystemStatusSchema = object({
 	solar: EnergySolarSchema.nullable(),
@@ -63229,6 +63288,12 @@ var energySystemCapability = {
 			kind: "counter",
 			unit: "kWh",
 			displayName: "Storage discharged"
+		},
+		"storage.healthPct": {
+			kind: "gauge",
+			unit: "%",
+			deadband: 1,
+			displayName: "Storage health"
 		}
 	} },
 	volatileStateFields: ["lastFetchedAt"],
@@ -66123,7 +66188,7 @@ var HeroModelSchema = object({
 *
 *   - `extras` are the further inline controls of the types that carry more than one
 *     ({@link ROW_EXTRAS_BY_TYPE}): climate setpoint, a robot's return to base,
-*     a player's volume and remote. Each is a control the model already has, named by id,
+*     a player's volume and remote, an automation's enabled switch. Each is a control the model already has, named by id,
 *     in that order and at most {@link ROW_EXTRAS_MAX}; one the model lacks, or lists in
 *     `gated`, is absent, and the one `primary` already is never repeats. Empty = the
 *     row of an older server: `primary` alone.
@@ -66183,7 +66248,7 @@ new Set([
 	"valve"
 ]);
 DeviceType.Climate;
-DeviceType.Climate, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer;
+DeviceType.Climate, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer, DeviceType.Automation;
 /**
 * hero-layout — what a device's hero says (D1023). Read-only: the FIXED
 * layouts live in `@camstack/types` and nothing here stores or edits one.
@@ -79306,6 +79371,13 @@ var NcHistoryEntrySchema = object({
 	error: string().optional(),
 	subject: NcHistorySubjectSchema,
 	/**
+	* The title and body actually sent, frozen at delivery. Absent on a row
+	* still pending, a row suppressed before a notification was built, and a
+	* row delivered before this field shipped.
+	*/
+	title: string().optional(),
+	body: string().optional(),
+	/**
 	* Ids of the artefacts (still, then gif, then clip) this row's successful
 	* delivery indexed in the artefact library — a REFERENCE, never the bytes
 	* (an artefact is often megabytes; this row is durable JSON rewritten on
@@ -87616,7 +87688,8 @@ var ServerUpdateActionResultSchema = object({
 	outcome: ServerUpdateOutcomeSchema.optional(),
 	/**
 	* Stable, greppable cause for `refused` / `failed` (the engine's
-	* `UpdateRefusalReason`, `staging-failed`, …). `null` on success.
+	* `UpdateRefusalReason`, `staging-failed`, `timeout-stall`,
+	* `timeout-ceiling`). `null` on success.
 	*/
 	reason: string().nullable().optional(),
 	/**
@@ -87738,6 +87811,14 @@ var smokeCapability = {
 		}]
 	}
 };
+var EmailImagePartSchema = object({
+	ticket: PeerBytesTicketSchema,
+	mime: string().min(1),
+	name: string().min(1),
+	contentId: string().min(1),
+	placement: _enum(["inline", "attachment"]),
+	deviceId: number$1().int().nonnegative().optional()
+});
 /**
 * `smtp-provider` — pluggable email delivery surface.
 *
@@ -87747,8 +87828,8 @@ var smokeCapability = {
 * ready provider OR target a specific addonId.
 *
 * The shape stays small on purpose — `sendEmail` is enough for the
-* 90% case. Attachments / HTML templating / multi-part are room for
-* future fields without breaking the existing call sites.
+* 90% case. An image is not a byte field on this method (D613): `images`
+* names `peerBytes` tickets the sender opens and folds into one MIME body.
 */
 var EmailAddressSchema = email();
 /**
@@ -87775,7 +87856,12 @@ var SendEmailInputSchema = object({
 	*  for clients that strip HTML — including most spam filters). */
 	text: string(),
 	/** Optional HTML body. Renders alongside `text` as multi-part. */
-	html: string().optional()
+	html: string().optional(),
+	/**
+	* Images the caller already offered over `peerBytes`. Absent = a mail with
+	* no image. The sender opens each ticket; one it cannot read is left out.
+	*/
+	images: array(EmailImagePartSchema).max(3).optional()
 });
 var SendEmailResultSchema = object({
 	messageId: string(),
@@ -88805,34 +88891,46 @@ var switchCapability = {
 		DeviceType.Light,
 		DeviceType.Fan
 	],
-	methods: { setState: method(object({
-		deviceId: number$1(),
-		on: boolean()
-	}), _void(), {
-		kind: "mutation",
-		auth: "protected",
-		actions: [{
-			id: "switch.on",
-			label: t("Turn on", "Accendi"),
-			phrase: t("Turn on {device}", "Accendi {device}"),
-			icon: "power",
-			effect: {
-				field: "on",
-				value: true
-			},
-			args: { on: true }
-		}, {
-			id: "switch.off",
-			label: t("Turn off", "Spegni"),
-			phrase: t("Turn off {device}", "Spegni {device}"),
-			icon: "power-off",
-			effect: {
-				field: "on",
-				value: false
-			},
-			args: { on: false }
-		}]
-	}) },
+	methods: {
+		setState: method(object({
+			deviceId: number$1(),
+			on: boolean()
+		}), _void(), {
+			kind: "mutation",
+			auth: "protected",
+			actions: [{
+				id: "switch.on",
+				label: t("Turn on", "Accendi"),
+				phrase: t("Turn on {device}", "Accendi {device}"),
+				icon: "power",
+				effect: {
+					field: "on",
+					value: true
+				},
+				args: { on: true }
+			}, {
+				id: "switch.off",
+				label: t("Turn off", "Spegni"),
+				phrase: t("Turn off {device}", "Spegni {device}"),
+				icon: "power-off",
+				effect: {
+					field: "on",
+					value: false
+				},
+				args: { on: false }
+			}]
+		}),
+		toggle: optionalMethod(object({ deviceId: number$1() }), _void(), {
+			kind: "mutation",
+			auth: "protected",
+			actions: [{
+				id: "switch.toggle",
+				label: t("Toggle", "Commuta"),
+				phrase: t("Toggle {device}", "Commuta {device}"),
+				icon: "toggle-right"
+			}]
+		})
+	},
 	events: { onStateChanged: {
 		data: object({
 			deviceId: number$1(),
@@ -96646,7 +96744,11 @@ var temperatureContribution = contribution("temperature-sensor", TemperatureSens
 var humidityContribution = contribution("humidity-sensor", HumiditySensorStatusSchema, (slice) => measured(sensorFragment(slice?.humidity ?? null, "humidity", "droplets", "Humidity", "Umidità", `${Math.round(slice?.humidity ?? 0)}%`), slice?.humidity == null ? emptyMeasurement("humidity") : humidityMeasurement(slice.humidity, slice.lastFetchedAt)));
 var pressureContribution = contribution("pressure-sensor", PressureSensorStatusSchema, (slice) => sensorFragment(slice?.pressure ?? null, "pressure", "gauge", "Pressure", "Pressione", `${Math.round(slice?.pressure ?? 0)} hPa`));
 var illuminanceContribution = contribution("ambient-light-sensor", AmbientLightSensorStatusSchema, (slice) => sensorFragment(slice?.illuminance ?? null, "illuminance", "sun", "Light", "Luce", `${Math.round(slice?.illuminance ?? 0)} lx`));
-var numericContribution = contribution("numeric-sensor", NumericSensorStatusSchema, (slice) => sensorFragment(slice?.value ?? null, "reading", "gauge", "Value", "Valore", String(Number((slice?.value ?? 0).toFixed(2)))));
+var numericContribution = contribution("numeric-sensor", NumericSensorStatusSchema, (slice, ctx) => {
+	const unit = ctx.quantity == null ? void 0 : baseUnitOf(ctx.quantity);
+	const text = String(Number((slice?.value ?? 0).toFixed(2)));
+	return sensorFragment(slice?.value ?? null, "reading", "gauge", "Value", "Valore", unit === void 0 ? text : `${text} ${unit}`);
+});
 var enumContribution = contribution("enum-sensor", EnumSensorStatusSchema, (slice) => {
 	if (slice === void 0 || slice.value === "") return measured({ reading: reading("sensor", "unknown") }, emptyMeasurement("text"));
 	if (slice.timestamp === true) return { reading: reading("sensor", "on") };
@@ -106916,6 +107018,13 @@ Object.freeze({
 		access: "create",
 		role: "viewer"
 	},
+	"switch.toggle": {
+		capName: "switch",
+		capScope: "device",
+		addonId: null,
+		access: "create",
+		role: "viewer"
+	},
 	"system.debugWatch": {
 		capName: "system",
 		capScope: "system",
@@ -110743,6 +110852,12 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"smtpProvider.sendEmail": [{
+		name: "images",
+		form: "object-array",
+		optional: true,
+		itemField: "deviceId"
+	}],
 	"snapshot.applyDeviceSettingsPatch": [{
 		name: "deviceId",
 		form: "single",
@@ -110909,6 +111024,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"switch.toggle": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"system.debugWatch": [{
 		name: "deviceIds",
 		form: "array",
@@ -111772,6 +111892,28 @@ var STATE_SUMMARY_VARS = [
 		systemEventKinds: [...SUMMARISABLE],
 		systemEventDeliveries: ["summary"]
 	},
+	{
+		name: "offlineCount",
+		label: "Summary: how many went offline",
+		example: "2",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: [...SUMMARISABLE],
+		systemEventDeliveries: ["summary"]
+	},
+	{
+		name: "onlineCount",
+		label: "Summary: how many came back",
+		example: "5",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: [...SUMMARISABLE],
+		systemEventDeliveries: ["summary"]
+	},
 	{
 		name: "summaryCount",
 		label: "Summary: items reported",
@@ -111813,6 +111955,7 @@ var STATE_SUMMARY_VARS = [
 	([...RULE_TEXT], [...COMBINED_ALARM]),
 	([...RULE_TEXT], [...COMBINED_ALARM]),
 	[...RULE_TEXT],
+	[...RULE_TEXT],
 	([...RULE_TEXT], [...COMBINED_ALARM]),
 	([...RULE_TEXT], [...PACKAGE_UPDATES]),
 	[...RULE_TEXT],
@@ -112930,6 +113073,21 @@ function toBase(value, unit, quantity) {
 }
 //#endregion
 //#region src/enpal-catalog.ts
+/**
+* The two meters the box both called "Consumption". English is the device
+* name (one string, like every other catalog entry); Italian is the addon
+* catalogue key `catalog.<id>.name`.
+*/
+var ENPAL_CONSUMPTION_NAMES = {
+	house: {
+		en: "House consumption",
+		it: "Consumo casa"
+	},
+	heatpump: {
+		en: "Heat pump consumption",
+		it: "Consumo pompa di calore"
+	}
+};
 var point = (quantity, ...sources) => ({
 	quantity,
 	sources: sources.map((s) => typeof s === "string" ? { key: s } : s)
@@ -113030,7 +113188,7 @@ var ENPAL_SPECS = [
 	{
 		kind: "power-meter",
 		id: "house",
-		name: "Consumption",
+		name: ENPAL_CONSUMPTION_NAMES.house.en,
 		role: DeviceRole.PowerSensor,
 		power: point("power", "Power.Consumption.Total"),
 		kwh: point("energy", "Energy.Consumption.Total.Lifetime")
@@ -113038,7 +113196,7 @@ var ENPAL_SPECS = [
 	{
 		kind: "power-meter",
 		id: "heatpump",
-		name: "Consumption",
+		name: ENPAL_CONSUMPTION_NAMES.heatpump.en,
 		role: DeviceRole.PowerSensor,
 		power: point("power", "Heatpump.Power.Consumption.Total"),
 		kwh: point("energy", "Heatpump.Energy.Consumption.Total.Lifetime")
@@ -113115,11 +113273,8 @@ var ENPAL_SPECS = [
 		id: "grid-frequency",
 		name: "Frequency",
 		role: DeviceRole.NumericSensor,
-		quantity: "index",
-		value: {
-			...point("index", "Frequency.Grid"),
-			ignoreUnit: true
-		}
+		quantity: "frequency",
+		value: point("frequency", "Frequency.Grid")
 	},
 	numeric("grid-feed-max", "Maximum feed-in power", "power", "Power.Grid.Maximum.Feed", DeviceRole.PowerSensor),
 	numeric("house-energy-day", "Consumption today", "energy", "Energy.Consumption.Total.Day", DeviceRole.EnergySensor),
@@ -113153,9 +113308,9 @@ var ENPAL_SPECS = [
 	text("lte-connection-type", "Connection type", "LTE.Connection.Type"),
 	numeric("lte-quality", "LTE quality", "percentage", "LTE.Quality"),
 	numeric("lte-rsrp", "RSRP", "signal-level", "LTE.RSRP"),
-	numeric("lte-rsrq", "RSRQ", "index", "LTE.RSRQ"),
+	numeric("lte-rsrq", "RSRQ", "signal-ratio", "LTE.RSRQ"),
 	numeric("lte-rssi", "RSSI", "signal-level", "LTE.RSSI"),
-	numeric("lte-snr", "SNR", "index", "LTE.SNR"),
+	numeric("lte-snr", "SNR", "signal-ratio", "LTE.SNR"),
 	text("lte-failover", "Failover result", "LTE.Failover.Result"),
 	text("lte-signal-check", "Signal check", "LTE.Cronny.Result"),
 	text("wifi-state", "Wi-Fi state", "WiFi.State"),
@@ -113196,7 +113351,7 @@ function resolve(target, snapshot) {
 	for (const source of target.sources) {
 		const reading = snapshot.readings.get(source.key);
 		if (reading === void 0) continue;
-		const converted = toBase(reading.value, target.ignoreUnit === true ? void 0 : reading.unit, target.quantity);
+		const converted = toBase(reading.value, reading.unit, target.quantity);
 		if (!converted.ok) {
 			refusal = `${source.key}: ${converted.reason} (unit ${reading.unit ?? "none"})`;
 			continue;
@@ -113669,7 +113824,8 @@ function computeEnergySystemStatus(snapshot, options, now) {
 		chargedKwh: read.meter("battery-charged"),
 		dischargedKwh: read.meter("battery-discharged"),
 		chargedTodayKwh: read.numeric("battery-charge-day"),
-		dischargedTodayKwh: read.numeric("battery-discharge-day")
+		dischargedTodayKwh: read.numeric("battery-discharge-day"),
+		healthPct: read.numeric("battery-health")
 	};
 	return {
 		status: {

package/dist/addon.mjs

@@ -6065,7 +6065,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-Cykc2bzi.mjs
+//#region ../types/dist/sleep-D7hCDd7y.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -10376,6 +10376,8 @@ var READING_QUANTITIES = [
 	"information",
 	"sound-level",
 	"signal-level",
+	"signal-ratio",
+	"frequency",
 	"colour-temperature",
 	"angle",
 	"bitrate",
@@ -10419,6 +10421,8 @@ var QUANTITY_BASE = {
 	information: "B",
 	"sound-level": "dBFS",
 	"signal-level": "dBm",
+	"signal-ratio": "dB",
+	frequency: "Hz",
 	"colour-temperature": "mired",
 	angle: "°",
 	bitrate: "kbps",
@@ -10771,41 +10775,57 @@ var CAP_VOCABULARY_BY_NAME = {
 			en: "Switch",
 			it: "Interruttore"
 		},
-		actions: [{
-			id: "switch.on",
-			method: "setState",
-			label: {
-				en: "Turn on",
-				it: "Accendi"
-			},
-			phrase: {
-				en: "Turn on {device}",
-				it: "Accendi {device}"
-			},
-			icon: "power",
-			args: { on: true },
-			effect: {
-				field: "on",
-				value: true
-			}
-		}, {
-			id: "switch.off",
-			method: "setState",
-			label: {
-				en: "Turn off",
-				it: "Spegni"
+		actions: [
+			{
+				id: "switch.on",
+				method: "setState",
+				label: {
+					en: "Turn on",
+					it: "Accendi"
+				},
+				phrase: {
+					en: "Turn on {device}",
+					it: "Accendi {device}"
+				},
+				icon: "power",
+				args: { on: true },
+				effect: {
+					field: "on",
+					value: true
+				}
 			},
-			phrase: {
-				en: "Turn off {device}",
-				it: "Spegni {device}"
+			{
+				id: "switch.off",
+				method: "setState",
+				label: {
+					en: "Turn off",
+					it: "Spegni"
+				},
+				phrase: {
+					en: "Turn off {device}",
+					it: "Spegni {device}"
+				},
+				icon: "power-off",
+				args: { on: false },
+				effect: {
+					field: "on",
+					value: false
+				}
 			},
-			icon: "power-off",
-			args: { on: false },
-			effect: {
-				field: "on",
-				value: false
+			{
+				id: "switch.toggle",
+				method: "toggle",
+				label: {
+					en: "Toggle",
+					it: "Commuta"
+				},
+				phrase: {
+					en: "Toggle {device}",
+					it: "Commuta {device}"
+				},
+				icon: "toggle-right"
 			}
-		}],
+		],
 		state: [{
 			kind: "boolean",
 			field: "on",
@@ -20338,6 +20358,10 @@ Object.freeze({
 		{
 			"path": "storage.dischargedTodayKwh",
 			"valueType": "number"
+		},
+		{
+			"path": "storage.healthPct",
+			"valueType": "number"
 		}
 	],
 	"enum-sensor": [{
@@ -20718,6 +20742,10 @@ Object.freeze({
 			"path": "isMuted",
 			"valueType": "boolean"
 		},
+		{
+			"path": "muteReadback",
+			"valueType": "boolean"
+		},
 		{
 			"path": "source",
 			"valueType": "string"
@@ -22838,7 +22866,7 @@ var NodeColorIdSchema = _enum([
 	"node-h"
 ]);
 //#endregion
-//#region ../types/dist/convert-BAzH15HU.mjs
+//#region ../types/dist/convert-BwMfbk5b.mjs
 /**
 * Frozen unit → spec table. `•` in the doc marks each dimension's canonical
 * unit (`factor: 1, offset: 0`). °F derives from `°C = (°F − 32) × 5/9` ⇒
@@ -23171,6 +23199,21 @@ var UNIT_TABLE = {
 		factor: 1,
 		offset: 0
 	},
+	dB: {
+		dimension: "signal-ratio",
+		factor: 1,
+		offset: 0
+	},
+	Hz: {
+		dimension: "frequency",
+		factor: 1,
+		offset: 0
+	},
+	kHz: {
+		dimension: "frequency",
+		factor: 1e3,
+		offset: 0
+	},
 	mired: {
 		dimension: "colour-temperature",
 		factor: 1,
@@ -55493,7 +55536,9 @@ var ClusterUpdateFailureReasonSchema = _enum([
 	"status-unreadable",
 	"addon-update-failed",
 	"addons-not-converged",
-	"interrupted"
+	"interrupted",
+	"timeout-stall",
+	"timeout-ceiling"
 ]);
 var ClusterUpdateStepSchema = object({
 	kind: ClusterUpdateStepKindSchema,
@@ -57060,6 +57105,12 @@ var MediaPlayerStatusSchema = object({
 	/** Mute toggle distinct from volume=0. Null when no mute surface.
 	*  Pair with `DeviceFeature.MediaPlayerMute`. */
 	isMuted: boolean().nullable(),
+	/**
+	* True only when the provider READS the mute state back from the device.
+	* Absent or false: mute is a momentary key. A non-null `isMuted` is not a
+	* reading on its own — an infrared send can leave a value without this flag.
+	*/
+	muteReadback: boolean().optional(),
 	/** Active source / input. Empty when no source surface. */
 	source: string(),
 	/** Selectable sources. Empty when no source surface.
@@ -59763,9 +59814,15 @@ var SiteZoneSchema = object({
 	locationKeys: array(string())
 });
 var DeviceSearchRequiresSchema = object({
-	/** Capability names the field wants a value of. */
-	caps: array(string()).readonly(),
-	/** `any` (default): a device with one of them is compatible. `all`: it must hold every one. */
+	/** Capability names the field wants a value of. Absent when the field wants actions only. */
+	caps: array(string()).readonly().optional(),
+	/**
+	* Vocabulary action ids (`cover.open`) the device must offer. Compatible means
+	* the device's bindings resolve those actions; `values` stays empty when no
+	* cap was required. `mode` applies the same way as for `caps`.
+	*/
+	actions: array(string()).readonly().optional(),
+	/** `any` (default): one of the named caps, and one of the named actions, is enough. `all`: every one. */
 	mode: _enum(["any", "all"]).optional()
 });
 var DeviceSearchFiltersSchema = object({
@@ -63116,7 +63173,9 @@ var EnergyStorageSchema = object({
 	/** Lifetime discharged, kWh. */
 	dischargedKwh: number$1().nullable().meta(readingMeta("energy")),
 	chargedTodayKwh: number$1().nullable().meta(readingMeta("energy")),
-	dischargedTodayKwh: number$1().nullable().meta(readingMeta("energy"))
+	dischargedTodayKwh: number$1().nullable().meta(readingMeta("energy")),
+	/** State of health, 0..100. Null when the system did not report it. */
+	healthPct: number$1().nullable().meta(readingMeta("percentage"))
 });
 var EnergySystemStatusSchema = object({
 	solar: EnergySolarSchema.nullable(),
@@ -63228,6 +63287,12 @@ var energySystemCapability = {
 			kind: "counter",
 			unit: "kWh",
 			displayName: "Storage discharged"
+		},
+		"storage.healthPct": {
+			kind: "gauge",
+			unit: "%",
+			deadband: 1,
+			displayName: "Storage health"
 		}
 	} },
 	volatileStateFields: ["lastFetchedAt"],
@@ -66122,7 +66187,7 @@ var HeroModelSchema = object({
 *
 *   - `extras` are the further inline controls of the types that carry more than one
 *     ({@link ROW_EXTRAS_BY_TYPE}): climate setpoint, a robot's return to base,
-*     a player's volume and remote. Each is a control the model already has, named by id,
+*     a player's volume and remote, an automation's enabled switch. Each is a control the model already has, named by id,
 *     in that order and at most {@link ROW_EXTRAS_MAX}; one the model lacks, or lists in
 *     `gated`, is absent, and the one `primary` already is never repeats. Empty = the
 *     row of an older server: `primary` alone.
@@ -66182,7 +66247,7 @@ new Set([
 	"valve"
 ]);
 DeviceType.Climate;
-DeviceType.Climate, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer;
+DeviceType.Climate, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer, DeviceType.Automation;
 /**
 * hero-layout — what a device's hero says (D1023). Read-only: the FIXED
 * layouts live in `@camstack/types` and nothing here stores or edits one.
@@ -79305,6 +79370,13 @@ var NcHistoryEntrySchema = object({
 	error: string().optional(),
 	subject: NcHistorySubjectSchema,
 	/**
+	* The title and body actually sent, frozen at delivery. Absent on a row
+	* still pending, a row suppressed before a notification was built, and a
+	* row delivered before this field shipped.
+	*/
+	title: string().optional(),
+	body: string().optional(),
+	/**
 	* Ids of the artefacts (still, then gif, then clip) this row's successful
 	* delivery indexed in the artefact library — a REFERENCE, never the bytes
 	* (an artefact is often megabytes; this row is durable JSON rewritten on
@@ -87615,7 +87687,8 @@ var ServerUpdateActionResultSchema = object({
 	outcome: ServerUpdateOutcomeSchema.optional(),
 	/**
 	* Stable, greppable cause for `refused` / `failed` (the engine's
-	* `UpdateRefusalReason`, `staging-failed`, …). `null` on success.
+	* `UpdateRefusalReason`, `staging-failed`, `timeout-stall`,
+	* `timeout-ceiling`). `null` on success.
 	*/
 	reason: string().nullable().optional(),
 	/**
@@ -87737,6 +87810,14 @@ var smokeCapability = {
 		}]
 	}
 };
+var EmailImagePartSchema = object({
+	ticket: PeerBytesTicketSchema,
+	mime: string().min(1),
+	name: string().min(1),
+	contentId: string().min(1),
+	placement: _enum(["inline", "attachment"]),
+	deviceId: number$1().int().nonnegative().optional()
+});
 /**
 * `smtp-provider` — pluggable email delivery surface.
 *
@@ -87746,8 +87827,8 @@ var smokeCapability = {
 * ready provider OR target a specific addonId.
 *
 * The shape stays small on purpose — `sendEmail` is enough for the
-* 90% case. Attachments / HTML templating / multi-part are room for
-* future fields without breaking the existing call sites.
+* 90% case. An image is not a byte field on this method (D613): `images`
+* names `peerBytes` tickets the sender opens and folds into one MIME body.
 */
 var EmailAddressSchema = email();
 /**
@@ -87774,7 +87855,12 @@ var SendEmailInputSchema = object({
 	*  for clients that strip HTML — including most spam filters). */
 	text: string(),
 	/** Optional HTML body. Renders alongside `text` as multi-part. */
-	html: string().optional()
+	html: string().optional(),
+	/**
+	* Images the caller already offered over `peerBytes`. Absent = a mail with
+	* no image. The sender opens each ticket; one it cannot read is left out.
+	*/
+	images: array(EmailImagePartSchema).max(3).optional()
 });
 var SendEmailResultSchema = object({
 	messageId: string(),
@@ -88804,34 +88890,46 @@ var switchCapability = {
 		DeviceType.Light,
 		DeviceType.Fan
 	],
-	methods: { setState: method(object({
-		deviceId: number$1(),
-		on: boolean()
-	}), _void(), {
-		kind: "mutation",
-		auth: "protected",
-		actions: [{
-			id: "switch.on",
-			label: t("Turn on", "Accendi"),
-			phrase: t("Turn on {device}", "Accendi {device}"),
-			icon: "power",
-			effect: {
-				field: "on",
-				value: true
-			},
-			args: { on: true }
-		}, {
-			id: "switch.off",
-			label: t("Turn off", "Spegni"),
-			phrase: t("Turn off {device}", "Spegni {device}"),
-			icon: "power-off",
-			effect: {
-				field: "on",
-				value: false
-			},
-			args: { on: false }
-		}]
-	}) },
+	methods: {
+		setState: method(object({
+			deviceId: number$1(),
+			on: boolean()
+		}), _void(), {
+			kind: "mutation",
+			auth: "protected",
+			actions: [{
+				id: "switch.on",
+				label: t("Turn on", "Accendi"),
+				phrase: t("Turn on {device}", "Accendi {device}"),
+				icon: "power",
+				effect: {
+					field: "on",
+					value: true
+				},
+				args: { on: true }
+			}, {
+				id: "switch.off",
+				label: t("Turn off", "Spegni"),
+				phrase: t("Turn off {device}", "Spegni {device}"),
+				icon: "power-off",
+				effect: {
+					field: "on",
+					value: false
+				},
+				args: { on: false }
+			}]
+		}),
+		toggle: optionalMethod(object({ deviceId: number$1() }), _void(), {
+			kind: "mutation",
+			auth: "protected",
+			actions: [{
+				id: "switch.toggle",
+				label: t("Toggle", "Commuta"),
+				phrase: t("Toggle {device}", "Commuta {device}"),
+				icon: "toggle-right"
+			}]
+		})
+	},
 	events: { onStateChanged: {
 		data: object({
 			deviceId: number$1(),
@@ -96645,7 +96743,11 @@ var temperatureContribution = contribution("temperature-sensor", TemperatureSens
 var humidityContribution = contribution("humidity-sensor", HumiditySensorStatusSchema, (slice) => measured(sensorFragment(slice?.humidity ?? null, "humidity", "droplets", "Humidity", "Umidità", `${Math.round(slice?.humidity ?? 0)}%`), slice?.humidity == null ? emptyMeasurement("humidity") : humidityMeasurement(slice.humidity, slice.lastFetchedAt)));
 var pressureContribution = contribution("pressure-sensor", PressureSensorStatusSchema, (slice) => sensorFragment(slice?.pressure ?? null, "pressure", "gauge", "Pressure", "Pressione", `${Math.round(slice?.pressure ?? 0)} hPa`));
 var illuminanceContribution = contribution("ambient-light-sensor", AmbientLightSensorStatusSchema, (slice) => sensorFragment(slice?.illuminance ?? null, "illuminance", "sun", "Light", "Luce", `${Math.round(slice?.illuminance ?? 0)} lx`));
-var numericContribution = contribution("numeric-sensor", NumericSensorStatusSchema, (slice) => sensorFragment(slice?.value ?? null, "reading", "gauge", "Value", "Valore", String(Number((slice?.value ?? 0).toFixed(2)))));
+var numericContribution = contribution("numeric-sensor", NumericSensorStatusSchema, (slice, ctx) => {
+	const unit = ctx.quantity == null ? void 0 : baseUnitOf(ctx.quantity);
+	const text = String(Number((slice?.value ?? 0).toFixed(2)));
+	return sensorFragment(slice?.value ?? null, "reading", "gauge", "Value", "Valore", unit === void 0 ? text : `${text} ${unit}`);
+});
 var enumContribution = contribution("enum-sensor", EnumSensorStatusSchema, (slice) => {
 	if (slice === void 0 || slice.value === "") return measured({ reading: reading("sensor", "unknown") }, emptyMeasurement("text"));
 	if (slice.timestamp === true) return { reading: reading("sensor", "on") };
@@ -106915,6 +107017,13 @@ Object.freeze({
 		access: "create",
 		role: "viewer"
 	},
+	"switch.toggle": {
+		capName: "switch",
+		capScope: "device",
+		addonId: null,
+		access: "create",
+		role: "viewer"
+	},
 	"system.debugWatch": {
 		capName: "system",
 		capScope: "system",
@@ -110742,6 +110851,12 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"smtpProvider.sendEmail": [{
+		name: "images",
+		form: "object-array",
+		optional: true,
+		itemField: "deviceId"
+	}],
 	"snapshot.applyDeviceSettingsPatch": [{
 		name: "deviceId",
 		form: "single",
@@ -110908,6 +111023,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"switch.toggle": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"system.debugWatch": [{
 		name: "deviceIds",
 		form: "array",
@@ -111771,6 +111891,28 @@ var STATE_SUMMARY_VARS = [
 		systemEventKinds: [...SUMMARISABLE],
 		systemEventDeliveries: ["summary"]
 	},
+	{
+		name: "offlineCount",
+		label: "Summary: how many went offline",
+		example: "2",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: [...SUMMARISABLE],
+		systemEventDeliveries: ["summary"]
+	},
+	{
+		name: "onlineCount",
+		label: "Summary: how many came back",
+		example: "5",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: [...SUMMARISABLE],
+		systemEventDeliveries: ["summary"]
+	},
 	{
 		name: "summaryCount",
 		label: "Summary: items reported",
@@ -111812,6 +111954,7 @@ var STATE_SUMMARY_VARS = [
 	([...RULE_TEXT], [...COMBINED_ALARM]),
 	([...RULE_TEXT], [...COMBINED_ALARM]),
 	[...RULE_TEXT],
+	[...RULE_TEXT],
 	([...RULE_TEXT], [...COMBINED_ALARM]),
 	([...RULE_TEXT], [...PACKAGE_UPDATES]),
 	[...RULE_TEXT],
@@ -112929,6 +113072,21 @@ function toBase(value, unit, quantity) {
 }
 //#endregion
 //#region src/enpal-catalog.ts
+/**
+* The two meters the box both called "Consumption". English is the device
+* name (one string, like every other catalog entry); Italian is the addon
+* catalogue key `catalog.<id>.name`.
+*/
+var ENPAL_CONSUMPTION_NAMES = {
+	house: {
+		en: "House consumption",
+		it: "Consumo casa"
+	},
+	heatpump: {
+		en: "Heat pump consumption",
+		it: "Consumo pompa di calore"
+	}
+};
 var point = (quantity, ...sources) => ({
 	quantity,
 	sources: sources.map((s) => typeof s === "string" ? { key: s } : s)
@@ -113029,7 +113187,7 @@ var ENPAL_SPECS = [
 	{
 		kind: "power-meter",
 		id: "house",
-		name: "Consumption",
+		name: ENPAL_CONSUMPTION_NAMES.house.en,
 		role: DeviceRole.PowerSensor,
 		power: point("power", "Power.Consumption.Total"),
 		kwh: point("energy", "Energy.Consumption.Total.Lifetime")
@@ -113037,7 +113195,7 @@ var ENPAL_SPECS = [
 	{
 		kind: "power-meter",
 		id: "heatpump",
-		name: "Consumption",
+		name: ENPAL_CONSUMPTION_NAMES.heatpump.en,
 		role: DeviceRole.PowerSensor,
 		power: point("power", "Heatpump.Power.Consumption.Total"),
 		kwh: point("energy", "Heatpump.Energy.Consumption.Total.Lifetime")
@@ -113114,11 +113272,8 @@ var ENPAL_SPECS = [
 		id: "grid-frequency",
 		name: "Frequency",
 		role: DeviceRole.NumericSensor,
-		quantity: "index",
-		value: {
-			...point("index", "Frequency.Grid"),
-			ignoreUnit: true
-		}
+		quantity: "frequency",
+		value: point("frequency", "Frequency.Grid")
 	},
 	numeric("grid-feed-max", "Maximum feed-in power", "power", "Power.Grid.Maximum.Feed", DeviceRole.PowerSensor),
 	numeric("house-energy-day", "Consumption today", "energy", "Energy.Consumption.Total.Day", DeviceRole.EnergySensor),
@@ -113152,9 +113307,9 @@ var ENPAL_SPECS = [
 	text("lte-connection-type", "Connection type", "LTE.Connection.Type"),
 	numeric("lte-quality", "LTE quality", "percentage", "LTE.Quality"),
 	numeric("lte-rsrp", "RSRP", "signal-level", "LTE.RSRP"),
-	numeric("lte-rsrq", "RSRQ", "index", "LTE.RSRQ"),
+	numeric("lte-rsrq", "RSRQ", "signal-ratio", "LTE.RSRQ"),
 	numeric("lte-rssi", "RSSI", "signal-level", "LTE.RSSI"),
-	numeric("lte-snr", "SNR", "index", "LTE.SNR"),
+	numeric("lte-snr", "SNR", "signal-ratio", "LTE.SNR"),
 	text("lte-failover", "Failover result", "LTE.Failover.Result"),
 	text("lte-signal-check", "Signal check", "LTE.Cronny.Result"),
 	text("wifi-state", "Wi-Fi state", "WiFi.State"),
@@ -113195,7 +113350,7 @@ function resolve(target, snapshot) {
 	for (const source of target.sources) {
 		const reading = snapshot.readings.get(source.key);
 		if (reading === void 0) continue;
-		const converted = toBase(reading.value, target.ignoreUnit === true ? void 0 : reading.unit, target.quantity);
+		const converted = toBase(reading.value, reading.unit, target.quantity);
 		if (!converted.ok) {
 			refusal = `${source.key}: ${converted.reason} (unit ${reading.unit ?? "none"})`;
 			continue;
@@ -113668,7 +113823,8 @@ function computeEnergySystemStatus(snapshot, options, now) {
 		chargedKwh: read.meter("battery-charged"),
 		dischargedKwh: read.meter("battery-discharged"),
 		chargedTodayKwh: read.numeric("battery-charge-day"),
-		dischargedTodayKwh: read.numeric("battery-discharge-day")
+		dischargedTodayKwh: read.numeric("battery-discharge-day"),
+		healthPct: read.numeric("battery-health")
 	};
 	return {
 		status: {

package/i18n/en.json

@@ -15,5 +15,7 @@
   "connection.s_source.pagePort.label": "Device page port",
   "connection.s_polling.title": "Polling",
   "connection.s_polling.pollIntervalMs.label": "Poll interval (ms)",
-  "connection.s_polling.invertBatteryPower.label": "Invert battery power sign"
+  "connection.s_polling.invertBatteryPower.label": "Invert battery power sign",
+  "catalog.house.name": "House consumption",
+  "catalog.heatpump.name": "Heat pump consumption"
 }

package/i18n/it.json

@@ -15,5 +15,7 @@
   "connection.s_source.pagePort.label": "Porta pagina dispositivo",
   "connection.s_polling.title": "Polling",
   "connection.s_polling.pollIntervalMs.label": "Intervallo di polling (ms)",
-  "connection.s_polling.invertBatteryPower.label": "Inverti il segno della potenza batteria"
+  "connection.s_polling.invertBatteryPower.label": "Inverti il segno della potenza batteria",
+  "catalog.house.name": "Consumo casa",
+  "catalog.heatpump.name": "Consumo pompa di calore"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-enpal",
-  "version": "0.1.20",
+  "version": "0.1.21",
   "description": "Enpal solar-box device-provider addon for CamStack — PV, battery, grid, house and heat-pump readings from the box's own web-page channel, its local InfluxDB or its device page",
   "keywords": [
     "camstack",
@@ -42,7 +42,7 @@
         "version": "0.1.0",
         "description": "Add an Enpal solar box as an integration (its own web-page channel, InfluxDB or the device page) and adopt its equipment: photovoltaic, battery, grid, house and heat pump",
         "entry": "./dist/addon.js",
-        "icon": "assets/icon.svg",
+        "icon": "assets/icon.png",
         "color": "#f5a623",
         "instanceMode": "multiple",
         "mode": "account",
@@ -66,7 +66,7 @@
       }
     ],
     "requires": {
-      "server": ">=1.2.858"
+      "server": ">=1.2.863"
     }
   },
   "files": [

package/assets/icon.svg

@@ -1,8 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
-  <!-- Enpal mark: navy tile and amber E from the public favicon. -->
-  <rect width="24" height="24" fill="#072543"/>
-  <rect x="5" y="5" width="3" height="14" fill="#FFB000"/>
-  <rect x="5" y="5" width="14" height="3" fill="#FFB000"/>
-  <rect x="5" y="10.5" width="9" height="3" fill="#FFB000"/>
-  <rect x="5" y="16" width="14" height="3" fill="#FFB000"/>
-</svg>