@camstack/addon-provider-homematic 1.2.157 → 1.2.159

package/dist/addon.js

@@ -8,7 +8,7 @@ let http = require("http");
 let crypto$1 = require("crypto");
 let fs_promises = require("fs/promises");
 let path = require("path");
-//#region ../types/dist/event-category-DHXxB8t9.mjs
+//#region ../types/dist/event-category-CT-hz5Rb.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -334,6 +334,14 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	/** The recovery edge of {@link PipelineMotionNoisy}: the motion fell back, or a detection arrived. */
 	EventCategory["PipelineMotionCalm"] = "pipeline.motion-calm";
 	/**
+	* A camera's package LLM confirm has failed closed three times in a row
+	* (D931, 2026-10-26). One edge per camera until
+	* {@link PipelinePackageLlmAnswered}.
+	*/
+	EventCategory["PipelinePackageLlmSilent"] = "pipeline.package-llm-silent";
+	/** The recovery edge of {@link PipelinePackageLlmSilent}: a confirm returned yes or no. */
+	EventCategory["PipelinePackageLlmAnswered"] = "pipeline.package-llm-answered";
+	/**
 	* Per-camera pipeline config was mutated by the orchestrator
 	* (a settings change via `setAgentInferenceDevices` /
 	* `setCameraStepToggle` / `setCameraStepSettings`). Orchestrator
@@ -5576,7 +5584,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-BErAxhul.mjs
+//#region ../types/dist/sleep-bykKrTgu.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -8318,6 +8326,99 @@ function defineEntryKind(name, spec) {
 	if (defined === void 0) throw new DeclarationRefusedError(`entry kind "${name}" was not built`);
 	return defined;
 }
+var READING_QUANTITIES = [
+	"temperature",
+	"pressure",
+	"speed",
+	"precipitation",
+	"precipitation-rate",
+	"length",
+	"area",
+	"illuminance",
+	"irradiance",
+	"power",
+	"energy",
+	"voltage",
+	"current",
+	"apparent-power",
+	"humidity",
+	"percentage",
+	"concentration-volume",
+	"concentration-mass",
+	"concentration-ppb",
+	"volume",
+	"duration",
+	"duration-ms",
+	"information",
+	"sound-level",
+	"signal-level",
+	"colour-temperature",
+	"angle",
+	"bitrate",
+	"rate",
+	"mass",
+	"index",
+	"ratio",
+	"count",
+	"none",
+	"device"
+];
+var ReadingQuantitySchema = _enum(READING_QUANTITIES);
+new Set(READING_QUANTITIES);
+/**
+* Stored unit symbol for a quantity. `none` means the number is dimensionless
+* (or an index / ratio / count). `device` means the cap has no single unit.
+*/
+var QUANTITY_BASE = {
+	temperature: "°C",
+	pressure: "hPa",
+	speed: "m/s",
+	precipitation: "mm",
+	"precipitation-rate": "mm/h",
+	length: "m",
+	area: "m²",
+	illuminance: "lx",
+	irradiance: "W/m²",
+	power: "W",
+	energy: "kWh",
+	voltage: "V",
+	current: "A",
+	"apparent-power": "VA",
+	humidity: "%",
+	percentage: "%",
+	"concentration-volume": "ppm",
+	"concentration-mass": "µg/m³",
+	"concentration-ppb": "ppb",
+	volume: "L",
+	duration: "s",
+	"duration-ms": "ms",
+	information: "B",
+	"sound-level": "dBFS",
+	"signal-level": "dBm",
+	"colour-temperature": "mired",
+	angle: "°",
+	bitrate: "kbps",
+	rate: "fps",
+	mass: "kg",
+	index: "none",
+	ratio: "none",
+	count: "none",
+	none: "none",
+	device: "device"
+};
+/** The stored unit, or `undefined` when the quantity has no unit symbol. */
+function baseUnitOf(quantity) {
+	const symbol = QUANTITY_BASE[quantity];
+	if (symbol === "none" || symbol === "device") return void 0;
+	return symbol;
+}
+function readingMeta(quantity, extras) {
+	return {
+		quantity,
+		...extras?.precision !== void 0 ? { precision: extras.precision } : {},
+		...extras?.label !== void 0 ? { label: extras.label } : {}
+	};
+}
 /** Shared Zod schemas used across streaming capabilities. */
 var CamProfileSchema = _enum([
 	"high",
@@ -8345,8 +8446,8 @@ var CamStreamKindSchema = _enum([
 	"derived"
 ]);
 var CamStreamResolutionSchema = object({
-	width: number().int().positive(),
-	height: number().int().positive()
+	width: number().int().positive().meta(readingMeta("none")),
+	height: number().int().positive().meta(readingMeta("none"))
 });
 var CameraStreamSchema = object({
 	/** Stable, provider-assigned id unique within the (deviceId) scope. */
@@ -8864,6 +8965,8 @@ var CAP_NAMES = Object.freeze([
 	"filesystem-browse",
 	"flood",
 	"gas",
+	"group-commands",
+	"group-status",
 	"heating-valve",
 	"humidifier",
 	"humidity-sensor",
@@ -8993,14 +9096,6 @@ Object.freeze({
 		{
 			"path": "aqi",
 			"valueType": "number"
-		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
 		}
 	],
 	"alarm-panel": [
@@ -9036,20 +9131,10 @@ Object.freeze({
 			"valueType": "boolean"
 		}
 	],
-	"ambient-light-sensor": [
-		{
-			"path": "lux",
-			"valueType": "number"
-		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
-		}
-	],
+	"ambient-light-sensor": [{
+		"path": "lux",
+		"valueType": "number"
+	}],
 	"audio-metrics": [
 		{
 			"path": "ts",
@@ -9129,6 +9214,10 @@ Object.freeze({
 			"path": "lastUpdated",
 			"valueType": "number"
 		},
+		{
+			"path": "volts",
+			"valueType": "number"
+		},
 		{
 			"path": "lastContactAt",
 			"valueType": "number"
@@ -9371,10 +9460,6 @@ Object.freeze({
 				"datetime"
 			]
 		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
 		{
 			"path": "min",
 			"valueType": "number"
@@ -9386,19 +9471,6 @@ Object.freeze({
 		{
 			"path": "step",
 			"valueType": "number"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
-		},
-		{
-			"path": "format",
-			"valueType": "enum",
-			"enumValues": [
-				"date",
-				"time",
-				"datetime"
-			]
 		}
 	],
 	"cover": [
@@ -9639,13 +9711,8 @@ Object.freeze({
 		"path": "value",
 		"valueType": "string"
 	}, {
-		"path": "format",
-		"valueType": "enum",
-		"enumValues": [
-			"date",
-			"time",
-			"datetime"
-		]
+		"path": "timestamp",
+		"valueType": "boolean"
 	}],
 	"event-emitter": [
 		{
@@ -9718,6 +9785,20 @@ Object.freeze({
 		"path": "detected",
 		"valueType": "boolean"
 	}],
+	"group-status": [
+		{
+			"path": "included",
+			"valueType": "number"
+		},
+		{
+			"path": "excluded",
+			"valueType": "number"
+		},
+		{
+			"path": "total",
+			"valueType": "number"
+		}
+	],
 	"heating-valve": [{
 		"path": "position",
 		"valueType": "number"
@@ -9752,20 +9833,10 @@ Object.freeze({
 			"valueType": "number"
 		}
 	],
-	"humidity-sensor": [
-		{
-			"path": "percent",
-			"valueType": "number"
-		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
-		}
-	],
+	"humidity-sensor": [{
+		"path": "percent",
+		"valueType": "number"
+	}],
 	"image": [{
 		"path": "url",
 		"valueType": "string"
@@ -10104,20 +10175,10 @@ Object.freeze({
 			"valueType": "boolean"
 		}
 	],
-	"numeric-sensor": [
-		{
-			"path": "value",
-			"valueType": "number"
-		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
-		}
-	],
+	"numeric-sensor": [{
+		"path": "value",
+		"valueType": "number"
+	}],
 	"pet-feeder": [
 		{
 			"path": "foodLevel",
@@ -10209,14 +10270,6 @@ Object.freeze({
 		{
 			"path": "powerFactor",
 			"valueType": "number"
-		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
 		}
 	],
 	"presence": [
@@ -10245,20 +10298,10 @@ Object.freeze({
 			"valueType": "number"
 		}
 	],
-	"pressure-sensor": [
-		{
-			"path": "hpa",
-			"valueType": "number"
-		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
-		}
-	],
+	"pressure-sensor": [{
+		"path": "hpa",
+		"valueType": "number"
+	}],
 	"privacy-mask": [{
 		"path": "enabled",
 		"valueType": "boolean"
@@ -10569,20 +10612,10 @@ Object.freeze({
 		"path": "tampered",
 		"valueType": "boolean"
 	}],
-	"temperature-sensor": [
-		{
-			"path": "celsius",
-			"valueType": "number"
-		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
-		}
-	],
+	"temperature-sensor": [{
+		"path": "celsius",
+		"valueType": "number"
+	}],
 	"update": [
 		{
 			"path": "currentVersion",
@@ -10693,10 +10726,6 @@ Object.freeze({
 			"path": "temperature",
 			"valueType": "number"
 		},
-		{
-			"path": "temperatureUnit",
-			"valueType": "string"
-		},
 		{
 			"path": "humidity",
 			"valueType": "number"
@@ -10705,18 +10734,10 @@ Object.freeze({
 			"path": "pressure",
 			"valueType": "number"
 		},
-		{
-			"path": "pressureUnit",
-			"valueType": "string"
-		},
 		{
 			"path": "windSpeed",
 			"valueType": "number"
 		},
-		{
-			"path": "windSpeedUnit",
-			"valueType": "string"
-		},
 		{
 			"path": "windBearing",
 			"valueType": "number"
@@ -11119,7 +11140,7 @@ function errMsg(err) {
 	return String(err);
 }
 //#endregion
-//#region ../types/dist/composition-kEl9mevu.mjs
+//#region ../types/dist/composition-OhpuespA.mjs
 /**
 * The ffmpeg build every CamStack node downloads, per platform and arch.
 *
@@ -11874,15 +11895,74 @@ function validateExpressionSource(src) {
 	}
 	return null;
 }
-/** A composed device's stableId is this prefix plus the block id. */
-var COMPOSED_DEVICE_STABLE_ID_PREFIX = "composed-";
-/** Longest snippet a `code` source may carry (slice 4). */
-var MAX_COMPOSITION_CODE_LENGTH = 2e4;
+/**
+* A composition source identity: `(addonId, stableId)`, never a numeric device
+* id. Split out so helper schemas can name it without a cycle through
+* `composition.ts` (D659).
+*/
 var CompositionSourceRefSchema = object({
 	/** The owning addon; `stableId` is unique only within it. */
 	addonId: string().min(1),
 	stableId: string().min(1)
 });
+var GROUP_TEMPLATE_IDS = [
+	"temperature",
+	"humidity",
+	"pressure",
+	"illuminance",
+	"power",
+	"energy",
+	"battery",
+	"numeric",
+	"motion",
+	"contact",
+	"leak",
+	"smoke",
+	"occupancy",
+	"binary",
+	"switch",
+	"light"
+];
+var NUMERIC_AGGREGATES = [
+	"mean",
+	"median",
+	"min",
+	"max",
+	"sum"
+];
+var BINARY_AGGREGATES = ["any", "all"];
+/** How an actuator group decides it is on. Unknown members never count as off. */
+var ACTIVE_CRITERIA = ["at-least-one", "all"];
+var AGGREGATE_REDUCERS = [
+	"mean",
+	"median",
+	"min",
+	"max",
+	"sum",
+	"any",
+	"all"
+];
+var GroupTemplateIdSchema = _enum(GROUP_TEMPLATE_IDS);
+var AggregateReducerSchema = _enum(AGGREGATE_REDUCERS);
+var ActiveCriterionSchema = _enum(ACTIVE_CRITERIA);
+/** One member. The field is stored so occupancy can name motion or binary. */
+var HelperMemberSchema = object({
+	source: CompositionSourceRefSchema,
+	cap: string().min(1),
+	fieldPath: string().min(1)
+});
+var HelperSpecSchema = discriminatedUnion("kind", [object({
+	kind: literal("group"),
+	templateId: GroupTemplateIdSchema,
+	aggregate: AggregateReducerSchema,
+	members: array(HelperMemberSchema).min(1).max(64),
+	/** Actuator groups only. Readings leave this unset. */
+	active: ActiveCriterionSchema.optional()
+})]);
+/** A composed device's stableId is this prefix plus the block id. */
+var COMPOSED_DEVICE_STABLE_ID_PREFIX = "composed-";
+/** Longest snippet a `code` source may carry (slice 4). */
+var MAX_COMPOSITION_CODE_LENGTH = 2e4;
 /** One field of one capability of one source device. */
 var CompositionFieldReadSchema = object({
 	source: CompositionSourceRefSchema,
@@ -11926,7 +12006,33 @@ var CompositionCodeSourceSchema = object({
 var CompositionFieldSourceSchema = discriminatedUnion("kind", [
 	CompositionFromSourceSchema,
 	CompositionExpressionSourceSchema,
-	CompositionCodeSourceSchema
+	CompositionCodeSourceSchema,
+	object({
+		kind: literal("aggregate"),
+		reducer: _enum([
+			"mean",
+			"median",
+			"min",
+			"max",
+			"sum",
+			"any",
+			"all"
+		]),
+		reads: array(CompositionFieldReadSchema).min(1).max(64),
+		/** `value` is the reading; the others are the member counts. */
+		publish: _enum([
+			"value",
+			"included",
+			"excluded",
+			"total"
+		]),
+		/** What a `value` publish does when nobody is included. Counts ignore this. */
+		empty: _enum([
+			"null",
+			"omit",
+			"offline"
+		])
+	})
 ]);
 var CompositionCommandTargetSchema = discriminatedUnion("kind", [object({
 	kind: literal("forward"),
@@ -11972,7 +12078,13 @@ var CompositionSchema = object({
 		kind: literal("existing"),
 		device: CompositionSourceRefSchema
 	})]),
-	features: array(CompositionFeatureSchema).min(1).max(16)
+	features: array(CompositionFeatureSchema).min(1).max(16),
+	/**
+	* Present when the block is a helper template. Absent on a free
+	* composition (the room example, device 4603). The editor reads this,
+	* never the compiled features.
+	*/
+	helper: HelperSpecSchema.optional()
 }).superRefine((composition, ctx) => {
 	const seen = /* @__PURE__ */ new Set();
 	composition.features.forEach((feature, index) => {
@@ -18229,7 +18341,11 @@ var CompositionProblemSchema = object({
 		"item-field-reserved",
 		"target-missing",
 		"target-unreadable",
-		"not-replaceable"
+		"not-replaceable",
+		"native-capability-replace",
+		"mixed-quantity",
+		"helper-mismatch",
+		"member-constraint"
 	]),
 	path: string(),
 	message: string()
@@ -18250,7 +18366,8 @@ var CompositionUnavailableModeSchema = _enum([
 	"null",
 	"offline",
 	"unknown",
-	"release"
+	"release",
+	"omit"
 ]);
 /**
 * `derived` reads a source · `clock` reads only `now`, recomputed when a sibling
@@ -18287,9 +18404,11 @@ var CompositionFieldPlanSchema = object({
 	reads: array(CompositionFieldReadSchema)
 });
 /**
-* What a feature does to its target (D663): `new` builds a capability on a new
-* device; on an existing device it `add`s a capability the device lacks, or
-* `replace`s named fields of one it has natively.
+* What a feature does to its target (D663, D944): `new` builds a capability on a
+* new device; on an existing device it `add`s a capability the device lacks.
+* Replacing a capability the device already serves is refused
+* (`native-capability-replace`), not planned. `replace` remains on the claim
+* wire for a claim the hub already holds.
 */
 var CompositionFeatureModeSchema = _enum([
 	"new",
@@ -18462,6 +18581,275 @@ Object.freeze({
 		result: ["number", "null"]
 	}
 });
+/**
+* One catalog row per base reading a group helper can build (D944 §3).
+* Data, not a form default written into the block.
+*/
+var NOW = {
+	fieldPath: "lastFetchedAt",
+	expr: "now"
+};
+var CHANGED = {
+	fieldPath: "lastChangedAt",
+	expr: "now"
+};
+function numeric(input) {
+	return {
+		...input,
+		family: "numeric",
+		deviceType: DeviceType.Sensor,
+		memberDeviceType: DeviceType.Sensor,
+		commandCaps: [],
+		baseUnit: baseUnitOf(input.quantity),
+		aggregates: NUMERIC_AGGREGATES,
+		accept: [{
+			cap: input.outputCap,
+			fieldPath: input.outputField
+		}]
+	};
+}
+function binary(input) {
+	return {
+		...input,
+		family: "binary",
+		deviceType: DeviceType.Sensor,
+		memberDeviceType: DeviceType.Sensor,
+		commandCaps: [],
+		quantity: "none",
+		baseUnit: void 0,
+		aggregates: BINARY_AGGREGATES,
+		empty: "offline"
+	};
+}
+var GROUP_TEMPLATES = [
+	numeric({
+		id: "temperature",
+		summary: "Mean, median, min, max or sum of temperatures. Offline and unknown members are left out, never read as 0 °C.",
+		role: DeviceRole.TemperatureSensor,
+		outputCap: "temperature-sensor",
+		outputField: "celsius",
+		quantity: "temperature",
+		defaultAggregate: "mean",
+		empty: "null",
+		companions: [NOW]
+	}),
+	numeric({
+		id: "humidity",
+		summary: "Humidity in percent. Offline and unknown members are left out, never read as 0 %.",
+		role: DeviceRole.HumiditySensor,
+		outputCap: "humidity-sensor",
+		outputField: "percent",
+		quantity: "humidity",
+		defaultAggregate: "mean",
+		empty: "null",
+		companions: [NOW]
+	}),
+	numeric({
+		id: "pressure",
+		summary: "Pressure in hectopascals. Offline and unknown members are left out, never read as 0 hPa.",
+		role: DeviceRole.PressureSensor,
+		outputCap: "pressure-sensor",
+		outputField: "hpa",
+		quantity: "pressure",
+		defaultAggregate: "mean",
+		empty: "null",
+		companions: [NOW]
+	}),
+	numeric({
+		id: "illuminance",
+		summary: "Illuminance in lux. Offline and unknown members are left out, never read as 0 lx.",
+		role: DeviceRole.AmbientLightSensor,
+		outputCap: "ambient-light-sensor",
+		outputField: "lux",
+		quantity: "illuminance",
+		defaultAggregate: "mean",
+		empty: "null",
+		companions: [NOW]
+	}),
+	numeric({
+		id: "power",
+		summary: "Power in watts, summed by default. Nobody reporting omits the key rather than writing 0 W.",
+		role: DeviceRole.PowerSensor,
+		outputCap: "power-meter",
+		outputField: "watts",
+		quantity: "power",
+		defaultAggregate: "sum",
+		empty: "omit",
+		companions: [NOW]
+	}),
+	numeric({
+		id: "energy",
+		summary: "Energy in kilowatt-hours, summed by default. Nobody reporting omits the key rather than writing 0 kWh.",
+		role: DeviceRole.EnergySensor,
+		outputCap: "power-meter",
+		outputField: "kwhTotal",
+		quantity: "energy",
+		defaultAggregate: "sum",
+		empty: "omit",
+		companions: [NOW]
+	}),
+	numeric({
+		id: "battery",
+		summary: "Battery charge in percent. Offline and unknown members are left out, never read as 0 %.",
+		role: DeviceRole.BatterySensor,
+		outputCap: "battery",
+		outputField: "percentage",
+		quantity: "percentage",
+		defaultAggregate: "mean",
+		empty: "null",
+		companions: [
+			{
+				fieldPath: "charging",
+				expr: "\"unknown\""
+			},
+			{
+				fieldPath: "sleeping",
+				expr: "false"
+			},
+			{
+				fieldPath: "lastUpdated",
+				expr: "now"
+			}
+		]
+	}),
+	numeric({
+		id: "numeric",
+		summary: "A numeric reading in the members’ shared quantity. Mixed quantities are refused. Nobody reporting publishes null, not 0.",
+		role: DeviceRole.NumericSensor,
+		outputCap: "numeric-sensor",
+		outputField: "value",
+		quantity: "device",
+		defaultAggregate: "mean",
+		empty: "null",
+		companions: [NOW]
+	}),
+	binary({
+		id: "motion",
+		summary: "Any or all motion. Offline and unknown members are left out, never read as off. Nobody reporting takes the device offline.",
+		role: DeviceRole.MotionSensor,
+		outputCap: "motion",
+		outputField: "detected",
+		defaultAggregate: "any",
+		accept: [{
+			cap: "motion",
+			fieldPath: "detected"
+		}],
+		companions: [{
+			fieldPath: "lastDetectedAt",
+			expr: "null"
+		}, {
+			fieldPath: "autoClearAfterMs",
+			expr: "null"
+		}]
+	}),
+	binary({
+		id: "contact",
+		summary: "Any or all open contacts. Offline and unknown members are left out, never read as closed.",
+		role: DeviceRole.ContactSensor,
+		outputCap: "contact",
+		outputField: "entryOpen",
+		defaultAggregate: "any",
+		accept: [{
+			cap: "contact",
+			fieldPath: "entryOpen"
+		}],
+		companions: [CHANGED]
+	}),
+	binary({
+		id: "leak",
+		summary: "Any or all leak detections. Offline and unknown members are left out, never read as dry.",
+		role: DeviceRole.LeakSensor,
+		outputCap: "flood",
+		outputField: "flooded",
+		defaultAggregate: "any",
+		accept: [{
+			cap: "flood",
+			fieldPath: "flooded"
+		}],
+		companions: [CHANGED]
+	}),
+	binary({
+		id: "smoke",
+		summary: "Any or all smoke detections. Offline and unknown members are left out, never read as clear.",
+		role: DeviceRole.SmokeSensor,
+		outputCap: "smoke",
+		outputField: "detected",
+		defaultAggregate: "any",
+		accept: [{
+			cap: "smoke",
+			fieldPath: "detected"
+		}],
+		companions: [CHANGED]
+	}),
+	binary({
+		id: "occupancy",
+		summary: "Any or all of motion or binary sensors, published as a binary. Presence zones are not aggregated. Nobody reporting is offline, not off.",
+		role: DeviceRole.BinarySensor,
+		outputCap: "binary",
+		outputField: "on",
+		defaultAggregate: "any",
+		accept: [{
+			cap: "motion",
+			fieldPath: "detected"
+		}, {
+			cap: "binary",
+			fieldPath: "on"
+		}],
+		companions: [CHANGED]
+	}),
+	binary({
+		id: "binary",
+		summary: "Any or all generic binary sensors. Offline and unknown members are left out, never read as off.",
+		role: DeviceRole.BinarySensor,
+		outputCap: "binary",
+		outputField: "on",
+		defaultAggregate: "any",
+		accept: [{
+			cap: "binary",
+			fieldPath: "on"
+		}],
+		companions: [CHANGED]
+	}),
+	actuator({
+		id: "switch",
+		summary: "On when at least one switch is on, or when all of them are. Offline and unknown members are left out of that decision, never read as off, and still receive the command.",
+		deviceType: DeviceType.Switch,
+		outputCap: "switch",
+		commandCaps: ["switch"]
+	}),
+	actuator({
+		id: "light",
+		summary: "On when at least one light is on, or when all of them are. Brightness and colour are offered only when every member has them. A command is not sent to a member that lacks it.",
+		deviceType: DeviceType.Light,
+		outputCap: "switch",
+		commandCaps: [
+			"switch",
+			"brightness",
+			"color"
+		]
+	})
+];
+function actuator(input) {
+	return {
+		...input,
+		family: "actuator",
+		role: void 0,
+		memberDeviceType: input.deviceType,
+		outputField: "on",
+		quantity: "none",
+		baseUnit: void 0,
+		aggregates: BINARY_AGGREGATES,
+		defaultAggregate: "any",
+		empty: "offline",
+		accept: [{
+			cap: "switch",
+			fieldPath: "on"
+		}],
+		companions: [CHANGED]
+	};
+}
+new Map(GROUP_TEMPLATES.map((template) => [template.id, template]));
+DeviceFeature.LightColorRgb, DeviceFeature.LightColorHsv, DeviceFeature.LightColorMired;
 `${COMPOSED_DEVICE_STABLE_ID_PREFIX}`;
 /**
 * What a composition may BUILD on a device type (G2, D676): the caps a new
@@ -20288,12 +20676,12 @@ function buildDeviceAdminUrl(parts) {
 *      providers detect renames by matching `uniqueId` and patch `id`
 *      in-place so dispatch keeps working.
 *
-* **Rendering metadata is NOT stored here.** Display fields (`unit`,
-* `precision`) live in the cap STATUS SLICE so they flow live with every
-* state push and are the single source of truth. The `device_class` tag is
-* an HA-specific input that is consumed at the discovery boundary
-* (`ha-domain-mapping`) to derive the CamStack `DeviceRole`; it is never
-* stored after that point.
+* **Display unit and precision are NOT stored here.** They are a read-time
+* preference (D944). A polymorphic reading stores its `quantity` here once,
+* at adopt, and a date/time value stores `dateTimeShape` the same way —
+* neither is repeated on each sample. The `device_class` tag is an
+* HA-specific input consumed at the discovery boundary (`ha-domain-mapping`)
+* to derive the CamStack `DeviceRole`; it is never stored after that point.
 *
 * The `raw` escape hatch carries provider-specific attributes that don't
 * fit the structured slots (HA `attributes` whitelist, Reolink `deviceCache`
@@ -20307,6 +20695,14 @@ var SourceInfoSchema = object({
 	/** Immutable upstream identifier when available (HA `unique_id`, … ).
 	*  Used to detect rename when `id` changes. */
 	uniqueId: string().optional(),
+	/** Quantity of a polymorphic reading, written once at adopt (D944). */
+	quantity: ReadingQuantitySchema.optional(),
+	/** Date / time / datetime shape of a string reading, written once at adopt. */
+	dateTimeShape: _enum([
+		"date",
+		"time",
+		"datetime"
+	]).optional(),
 	/** Provider-specific extras that don't fit the structured slots.
 	*  Whitelist what goes here per provider — do NOT dump entire HA
 	*  attribute blobs (would explode the meta JSON column). */
@@ -20352,6 +20748,80 @@ function mergeSourceInfo(prev, patch) {
 	return next;
 }
 /**
+* Coerce common unit-of-measurement string variants to a canonical form
+* so the UI's display templates can rely on stable strings. Pure
+* passthrough for unknown units — kept conservative on purpose, the goal
+* is to normalise the long tail of HA `unit_of_measurement` values that
+* have multiple historical spellings (`'°C'` vs `'C'` vs `'celsius'`).
+*
+* Extend the map as we encounter real-world data. Returning the raw
+* input for unknown values is intentional: providers should never
+* lose information silently here.
+*/
+function normalizeUnit(raw) {
+	if (raw == null) return void 0;
+	const trimmed = raw.trim();
+	if (trimmed === "") return void 0;
+	const lower = trimmed.toLowerCase();
+	if (lower === "°c" || lower === "c" || lower === "celsius") return "°C";
+	if (lower === "°f" || lower === "f" || lower === "fahrenheit") return "°F";
+	if (lower === "k" || lower === "kelvin") return "K";
+	if (lower === "%" || lower === "percent" || lower === "percentage") return "%";
+	if (lower === "lx" || lower === "lux") return "lx";
+	if (lower === "hpa" || lower === "hectopascal") return "hPa";
+	if (lower === "kpa") return "kPa";
+	if (lower === "pa") return "Pa";
+	if (lower === "mbar" || lower === "millibar") return "mbar";
+	if (lower === "w" || lower === "watt") return "W";
+	if (lower === "kw" || lower === "kilowatt") return "kW";
+	if (lower === "wh" || lower === "watt-hour") return "Wh";
+	if (lower === "kwh" || lower === "kilowatt-hour") return "kWh";
+	if (lower === "v" || lower === "volt") return "V";
+	if (lower === "a" || lower === "amp" || lower === "ampere") return "A";
+	if (lower === "ma" || lower === "milliampere") return "mA";
+	if (lower === "va") return "VA";
+	if (lower === "ppm") return "ppm";
+	if (lower === "ppb") return "ppb";
+	if (lower === "µg/m³" || lower === "ug/m3" || lower === "µg/m3") return "µg/m³";
+	if (lower === "km/h" || lower === "kph") return "km/h";
+	if (lower === "mph") return "mph";
+	if (lower === "m/s") return "m/s";
+	if (lower === "m") return "m";
+	if (lower === "m²" || lower === "m2") return "m²";
+	if (lower === "mm") return "mm";
+	if (lower === "cm") return "cm";
+	if (lower === "km") return "km";
+	if (lower === "in" || lower === "inch" || lower === "inches") return "in";
+	if (lower === "ft" || lower === "foot" || lower === "feet") return "ft";
+	if (lower === "kg") return "kg";
+	if (lower === "g") return "g";
+	if (lower === "l" || lower === "liter" || lower === "litre" || lower === "liters" || lower === "litres") return "L";
+	if (lower === "ml") return "mL";
+	if (lower === "gal" || lower === "gallon" || lower === "gallons") return "gal";
+	if (lower === "s" || lower === "sec" || lower === "second" || lower === "seconds") return "s";
+	if (lower === "ms") return "ms";
+	if (lower === "min" || lower === "minute" || lower === "minutes") return "min";
+	if (lower === "h" || lower === "hr" || lower === "hour" || lower === "hours") return "h";
+	if (lower === "d" || lower === "day" || lower === "days") return "d";
+	if (lower === "b" || lower === "byte" || lower === "bytes") return "B";
+	if (lower === "kib") return "KiB";
+	if (lower === "mib") return "MiB";
+	if (lower === "gib") return "GiB";
+	if (lower === "tib") return "TiB";
+	if (lower === "kb") return "kB";
+	if (lower === "mb") return "MB";
+	if (lower === "gb") return "GB";
+	if (lower === "dbm") return "dBm";
+	if (lower === "dbfs") return "dBFS";
+	if (lower === "inhg") return "inHg";
+	if (lower === "mm/h") return "mm/h";
+	if (lower === "w/m²" || lower === "w/m2") return "W/m²";
+	if (lower === "°" || lower === "deg" || lower === "degree" || lower === "degrees") return "°";
+	if (lower === "kbps") return "kbps";
+	if (lower === "fps") return "fps";
+	return trimmed;
+}
+/**
 * Key under which `SourceInfo` lives inside `DeviceMeta.metadata`. The
 * blob is a free-form `Record<string, unknown>` shared with hardware-
 * identity fields (`manufacturer`, `model`, `firmware`, …); SourceInfo
@@ -41428,7 +41898,8 @@ method(object({
 			"enum"
 		]),
 		enumValues: array(string()).optional(),
-		item: boolean().optional()
+		item: boolean().optional(),
+		quantity: ReadingQuantitySchema.optional()
 	})).readonly(),
 	itemArray: object({
 		path: string(),
@@ -45272,8 +45743,8 @@ var MaskPolygonShapeSchema = object({
 /** Boolean cell grid — row-major, length === gridWidth*gridHeight. */
 var MaskGridShapeSchema = object({
 	kind: literal("grid"),
-	gridWidth: number(),
-	gridHeight: number(),
+	gridWidth: number().meta(readingMeta("none")),
+	gridHeight: number().meta(readingMeta("none")),
 	cells: array(boolean())
 });
 discriminatedUnion("kind", [
@@ -45385,6 +45856,8 @@ var NcSystemEventKindSchema = _enum([
 	"detection-blind",
 	"motion-noisy",
 	"motion-calm",
+	"package-llm-silent",
+	"package-llm-answered",
 	"recording-stalled",
 	"recording-healthy",
 	"recording-degraded",
@@ -56476,6 +56949,28 @@ var PackageVersionInfoSchema = object({
 	deprecated: string().optional(),
 	distTags: array(string()).readonly()
 });
+/**
+* One published document. `ok` is markdown from the registry. `missing` means
+* the registry answered and the file was not there. `error` is a registry or
+* tarball failure — never an empty string standing in for either.
+*/
+var PackageDocBodySchema = discriminatedUnion("status", [
+	object({
+		status: literal("ok"),
+		markdown: string()
+	}),
+	object({ status: literal("missing") }),
+	object({
+		status: literal("error"),
+		message: string()
+	})
+]);
+var PackageDocsSchema = object({
+	name: string(),
+	version: string(),
+	readme: PackageDocBodySchema,
+	changelog: PackageDocBodySchema
+});
 var SearchResultSchema = object({
 	name: string(),
 	version: string(),
@@ -56694,7 +57189,10 @@ method(object({ nodeId: string().optional() }).optional(), array(AddonListItemSc
 }), object({ success: literal(true) }), {
 	kind: "mutation",
 	auth: "admin"
-}), method(object({ name: string() }), array(PackageVersionInfoSchema).readonly()), method(object({ addonId: string() }), RestartAddonResultSchema, {
+}), method(object({ name: string() }), array(PackageVersionInfoSchema).readonly()), method(object({
+	name: string().min(1),
+	version: string().min(1).optional()
+}), PackageDocsSchema, { auth: "admin" }), method(object({ addonId: string() }), RestartAddonResultSchema, {
 	kind: "mutation",
 	auth: "admin"
 }), method(object({ packageName: string() }), object({ success: literal(true) }), {
@@ -56753,27 +57251,17 @@ method(object({ nodeId: string().optional() }).optional(), array(AddonListItemSc
 */
 var AirQualitySensorStatusSchema = object({
 	/** Carbon dioxide concentration in ppm. */
-	co2Ppm: number().min(0).optional(),
+	co2Ppm: number().min(0).optional().meta(readingMeta("concentration-volume")),
 	/** Total volatile organic compounds in ppb. */
-	vocPpb: number().min(0).optional(),
+	vocPpb: number().min(0).optional().meta(readingMeta("concentration-ppb")),
 	/** Particulate matter ≤ 2.5 μm in µg/m³. */
-	pm25: number().min(0).optional(),
+	pm25: number().min(0).optional().meta(readingMeta("concentration-mass")),
 	/** Particulate matter ≤ 10 μm in µg/m³. */
-	pm10: number().min(0).optional(),
+	pm10: number().min(0).optional().meta(readingMeta("concentration-mass")),
 	/** Composite AQI value (typically 0..500). */
-	aqi: number().optional(),
+	aqi: number().optional().meta(readingMeta("index")),
 	/** Ms epoch when the slice was last updated. */
-	lastFetchedAt: number(),
-	/** Live display unit of the single metric this slice carries (e.g. HA
-	*  `attributes.unit_of_measurement` → 'ppm' / 'ppb' / 'µg/m³'). Each
-	*  upstream `sensor.*` entity surfaces ONE device_class, so one unit
-	*  per slice is unambiguous. */
-	unit: string().optional(),
-	/** Suggested decimal places for numeric display.
-	*  Populated live from the upstream source when provided (e.g. HA
-	*  `attributes.suggested_display_precision`). Falls back to
-	*  auto-formatting when absent. */
-	precision: number().int().min(0).max(10).optional()
+	lastFetchedAt: number()
 });
 var airQualitySensorCapability = {
 	name: "air-quality-sensor",
@@ -56810,12 +57298,12 @@ var airQualitySensorCapability = {
 		},
 		pm25: {
 			kind: "gauge",
-			unit: "ug/m3",
+			unit: "µg/m³",
 			deadband: 1
 		},
 		pm10: {
 			kind: "gauge",
-			unit: "ug/m3",
+			unit: "µg/m³",
 			deadband: 1
 		},
 		aqi: {
@@ -56833,22 +57321,13 @@ var airQualitySensorCapability = {
 * entries with `device_class: illuminance`.
 */
 var AmbientLightSensorStatusSchema = object({
-	/** Current illuminance in lux (lx). */
-	lux: number().min(0).meta({
-		unit: "lx",
+	/** Current illuminance in lux (lx). `null` when the sample was refused (D393). */
+	lux: number().min(0).nullable().meta(readingMeta("illuminance", {
+		precision: 0,
 		label: "Illuminance"
-	}),
+	})),
 	/** Ms epoch when the slice was last updated. */
-	lastFetchedAt: number(),
-	/** Live display unit from the upstream source (e.g. HA
-	*  `attributes.unit_of_measurement`). The UI prefers this over the
-	*  role's canonical unit. Absent → fall back to the canonical unit. */
-	unit: string().optional(),
-	/** Suggested decimal places for numeric display.
-	*  Populated live from the upstream source when provided (e.g. HA
-	*  `attributes.suggested_display_precision`). Falls back to
-	*  auto-formatting when absent. */
-	precision: number().int().min(0).max(10).optional()
+	lastFetchedAt: number()
 });
 var ambientLightSensorCapability = {
 	name: "ambient-light-sensor",
@@ -56880,12 +57359,7 @@ var ambientLightSensorCapability = {
 	} } },
 	/** Clock fields: written, but excluded from the compare that decides
 	*  whether persisting is worth a SQLite commit. */
-	volatileStateFields: ["lastFetchedAt"],
-	customize: {
-		version: 1,
-		advanced: "derive",
-		targets: []
-	}
+	volatileStateFields: ["lastFetchedAt"]
 };
 /**
 * Per-class audio metrics aggregated over a sliding window.
@@ -57112,10 +57586,7 @@ var BatteryStatusSchema = object({
 	* Consumers must SKIP a null rather than coerce it — `battery-band` already
 	* declines to band a non-finite reading, which is the correct shape.
 	*/
-	percentage: number().min(0).max(100).nullable().meta({
-		unit: "%",
-		label: "Charge"
-	}),
+	percentage: number().min(0).max(100).nullable().meta(readingMeta("percentage", { label: "Charge" })),
 	/**
 	* Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
 	* Reolink-specific for the Solar Panel 2 accessory (will become
@@ -57142,7 +57613,14 @@ var BatteryStatusSchema = object({
 	*/
 	sleeping: boolean().meta({ label: "Sleeping" }),
 	/** Ms epoch of the last observation. Lets consumers reason about freshness. */
-	lastUpdated: number(),
+	lastUpdated: number().meta(readingMeta("none")),
+	/**
+	* Battery voltage in volts, for a cell the firmware reports as voltage
+	* rather than a percentage (Ecowitt capacitor packs). Absent on cameras
+	* that only report charge. A second reading on this cap, not a second
+	* `numeric-sensor` on the same device.
+	*/
+	volts: number().nullable().optional().meta(readingMeta("voltage", { label: "Voltage" })),
 	/**
 	* Ms epoch of the last time the device PROVED it was reachable — a
 	* completed firmware round-trip, an observed wake, or an inbound push
@@ -57194,7 +57672,6 @@ var BATTERY_DEVICE_TYPES = [
 /** Generic Customize target for the percentage reading (D936). */
 var batteryCustomize = {
 	version: 1,
-	advanced: "derive",
 	targets: [{
 		id: "percentage",
 		cardinality: "scalar",
@@ -57203,7 +57680,7 @@ var batteryCustomize = {
 			stateField: "percentage"
 		},
 		deviceTypes: BATTERY_DEVICE_TYPES,
-		apply: "add-or-replace",
+		apply: "add",
 		path: "percentage",
 		sources: [{
 			kind: "field",
@@ -57324,10 +57801,16 @@ onStatusChanged: { data: object({
 	/**
 	* History (D850): recorded series. The generic capture replaces the `battery` series of `pipeline-analytics:stats-5m`.
 	*/
-	history: { fields: { percentage: {
-		kind: "gauge",
-		unit: "%"
-	} } },
+	history: { fields: {
+		percentage: {
+			kind: "gauge",
+			unit: "%"
+		},
+		volts: {
+			kind: "gauge",
+			unit: "V"
+		}
+	} },
 	customize: batteryCustomize,
 	/** Clock fields: written, but excluded from the compare that decides
 	*  whether persisting is worth a SQLite commit. */
@@ -57374,12 +57857,7 @@ var binaryCapability = {
 	history: { fields: { on: { kind: "boolean" } } },
 	/** Clock fields: written, but excluded from the compare that decides
 	*  whether persisting is worth a SQLite commit. */
-	volatileStateFields: ["lastChangedAt"],
-	customize: {
-		version: 1,
-		advanced: "derive",
-		targets: []
-	}
+	volatileStateFields: ["lastChangedAt"]
 };
 /**
 * Dimmable-light brightness control. Co-exists with `switch` on the
@@ -57395,7 +57873,7 @@ var binaryCapability = {
 */
 var BrightnessStatusSchema = object({
 	/** Current level as 0..100 inclusive. Firmware-reported. */
-	percentage: number().min(0).max(100),
+	percentage: number().min(0).max(100).meta(readingMeta("percentage")),
 	/** Ms epoch of the last operator-driven change. Useful for UI freshness. */
 	lastChangedAt: number()
 });
@@ -57849,21 +58327,21 @@ var ClimateControlStatusSchema = object({
 	/** Single setpoint in Celsius. Used by single-target modes
 	*  (heat / cool / dry). Null when the device is in a range mode
 	*  (`heat_cool`) or has no setpoint at all (`fan_only`/`off`). */
-	target: number().nullable(),
+	target: number().nullable().meta(readingMeta("temperature")),
 	/** Upper bound of the dual setpoint in Celsius. Populated only
 	*  in `heat_cool` mode. */
-	targetHigh: number().nullable(),
+	targetHigh: number().nullable().meta(readingMeta("temperature")),
 	/** Lower bound of the dual setpoint in Celsius. Populated only
 	*  in `heat_cool` mode. */
-	targetLow: number().nullable(),
+	targetLow: number().nullable().meta(readingMeta("temperature")),
 	/** Target relative humidity (0..100). Null when the device has no
 	*  humidity control. */
-	targetHumidity: number().min(0).max(100).nullable(),
+	targetHumidity: number().min(0).max(100).nullable().meta(readingMeta("humidity")),
 	/** Current measured temperature in Celsius. Read-only — pushed by
 	*  the device's internal sensor. */
-	currentTemp: number().nullable(),
+	currentTemp: number().nullable().meta(readingMeta("temperature")),
 	/** Current measured relative humidity (0..100). Read-only. */
-	currentHumidity: number().min(0).max(100).nullable(),
+	currentHumidity: number().min(0).max(100).nullable().meta(readingMeta("humidity")),
 	/** Vertical louver swing on/off. Null when the device has no vertical
 	*  swing surface (gate with `DeviceFeature.ClimateSwingVertical`). */
 	swingVertical: boolean().nullable(),
@@ -57871,11 +58349,11 @@ var ClimateControlStatusSchema = object({
 	*  horizontal swing surface (gate with `DeviceFeature.ClimateSwingHorizontal`). */
 	swingHorizontal: boolean().nullable(),
 	/** Lowest setpoint the device accepts, Celsius. Absent / null = not reported. */
-	minTemp: number().nullable().optional(),
+	minTemp: number().nullable().optional().meta(readingMeta("temperature")),
 	/** Highest setpoint the device accepts, Celsius. Absent / null = not reported. */
-	maxTemp: number().nullable().optional(),
+	maxTemp: number().nullable().optional().meta(readingMeta("temperature")),
 	/** Setpoint granularity, Celsius (0.5, 1). Absent / null = not reported. */
-	tempStep: number().positive().nullable().optional(),
+	tempStep: number().positive().nullable().optional().meta(readingMeta("temperature")),
 	/** Ms epoch when the slice was last updated (push or command). */
 	lastFetchedAt: number()
 });
@@ -58017,17 +58495,17 @@ var climateControlCapability = {
 * modes to expose in the picker without a slice fetch.
 */
 var RgbTripletSchema = object({
-	r: number().int().min(0).max(255),
-	g: number().int().min(0).max(255),
-	b: number().int().min(0).max(255)
+	r: number().int().min(0).max(255).meta(readingMeta("none")),
+	g: number().int().min(0).max(255).meta(readingMeta("none")),
+	b: number().int().min(0).max(255).meta(readingMeta("none"))
 });
 var HsvTripletSchema = object({
 	/** Hue in degrees, 0..360. */
-	h: number().min(0).max(360),
+	h: number().min(0).max(360).meta(readingMeta("none")),
 	/** Saturation as 0..100 inclusive. */
-	s: number().min(0).max(100),
+	s: number().min(0).max(100).meta(readingMeta("none")),
 	/** Value/brightness as 0..100 inclusive. */
-	v: number().min(0).max(100)
+	v: number().min(0).max(100).meta(readingMeta("none"))
 });
 var ColorInputSchema = discriminatedUnion("mode", [
 	object({
@@ -58056,7 +58534,7 @@ var ColorStatusSchema = object({
 	/** Populated when `mode === 'hsv'`. */
 	hsv: HsvTripletSchema.optional(),
 	/** Populated when `mode === 'mired'`. */
-	mireds: number().int().optional(),
+	mireds: number().int().optional().meta(readingMeta("colour-temperature")),
 	/** Ms epoch of the last operator-driven change. */
 	lastChangedAt: number()
 });
@@ -58251,18 +58729,12 @@ _enum([
 	"empty",
 	"full"
 ]);
-/** Units a remaining-life counter is reported in. Closed: the panel renders
-*  each. */
-var ConsumableRemainingUnitSchema = _enum([
-	"days",
-	"hours",
-	"cycles"
-]);
-/** Remaining life as a COUNT, not a percentage (the PetKit desiccant reports
-*  days). `value` null = unknown (D393). */
+/** Whether `remaining.value` is a duration in seconds or a dimensionless count. */
+var ConsumableRemainingKindSchema = _enum(["duration", "count"]);
+/** Remaining life. `value` null = unknown (D393). Duration is seconds. */
 var ConsumableRemainingSchema = object({
-	value: number().min(0).nullable(),
-	unit: ConsumableRemainingUnitSchema
+	value: number().min(0).nullable().meta(readingMeta("device")),
+	kind: ConsumableRemainingKindSchema
 });
 /** A single consumable item. Either a continuous `level` (remaining
 *  life %, or fill % for a `supply` / `waste` item) or a discrete `status`
@@ -58275,7 +58747,7 @@ var ConsumableItemSchema = object({
 	/** Display name. */
 	label: string().min(1),
 	/** Remaining life % (`wear`) or fill % (`supply`, `waste`) when known (0..100). */
-	level: number().min(0).max(100).nullable(),
+	level: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** The provider's discrete verdict when known (binary mode). */
 	status: ConsumableStatusSchema.nullable(),
 	/** What the item is — decides whether low or full is bad. Absent = `wear`. */
@@ -58357,8 +58829,8 @@ var consumablesCustomize = {
 					transforms: [{ kind: "identity" }]
 				}],
 				literals: [{
-					path: "remaining.unit",
-					values: [...ConsumableRemainingUnitSchema.options]
+					path: "remaining.kind",
+					values: [...ConsumableRemainingKindSchema.options]
 				}]
 			},
 			{
@@ -58487,7 +58959,6 @@ reset: method(object({
 				},
 				"remaining.value": {
 					kind: "gauge",
-					unitFrom: "remaining.unit",
 					deadband: 1,
 					displayName: "Remaining"
 				}
@@ -58557,10 +59028,9 @@ var contactCapability = {
 * (empty array for the other kinds). It lives in the slice because
 * HA `select.*` entities may update their options at runtime.
 *
-* The `unit`/`min`/`max`/`step` fields are meaningful for
-* `kind === 'numeric'` and are absent (undefined) for all other
-* kinds. They are populated live from HA attributes on each state
-* push — consistent with `options` and the sensor-unit approach.
+* Numeric `min` / `max` / `step` live in the slice and share the device
+* quantity (`SourceInfo.quantity`, D944). Display precision is a read-time
+* preference. A datetime control's shape is `SourceInfo.dateTimeShape`.
 */
 var ControlStatusSchema = object({
 	kind: _enum([
@@ -58572,39 +59042,17 @@ var ControlStatusSchema = object({
 	/** Current value. Numeric kind → number; select/text/datetime → string.
 	*  Datetime values are ISO 8601 strings (full timestamp, date-only,
 	*  or time-only — HA accepts all three forms). */
-	value: union([number(), string()]),
+	value: union([number().meta(readingMeta("device")), string()]),
 	/** Acceptable values when `kind === 'select'`. Empty for other kinds. */
 	options: array(string()),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number(),
-	/** Display unit-of-measurement (e.g. '°C', '%', 'lx').
-	*  Populated live from HA `attributes.unit_of_measurement` on each push.
-	*  Meaningful for `kind === 'numeric'`; absent for other kinds. */
-	unit: string().optional(),
-	/** Minimum allowed value. Populated live from HA `attributes.min`.
-	*  Meaningful for `kind === 'numeric'`; absent for other kinds. */
-	min: number().optional(),
-	/** Maximum allowed value. Populated live from HA `attributes.max`.
-	*  Meaningful for `kind === 'numeric'`; absent for other kinds. */
-	max: number().optional(),
-	/** Step increment. Populated live from HA `attributes.step`.
-	*  Meaningful for `kind === 'numeric'`; absent for other kinds. */
-	step: number().optional(),
-	/** Suggested decimal places for numeric display. Populated live from HA
-	*  `attributes.suggested_display_precision`, or derived from `step` when the
-	*  HA attribute is absent. Meaningful for `kind === 'numeric'`; absent for
-	*  other kinds. Falls back to auto-formatting when absent. */
-	precision: number().int().min(0).max(10).optional(),
-	/** Date-picker granularity for `kind === 'datetime'`. 'date' → date-only,
-	*  'time' → time-only, 'datetime' → full timestamp. Absent for other kinds
-	*  (UI defaults to 'datetime'). Derived live from the device's HA domain
-	*  (date.* / time.* / datetime.*) or, for input_datetime, from the entity's
-	*  `has_date`/`has_time` attributes on each push. */
-	format: _enum([
-		"date",
-		"time",
-		"datetime"
-	]).optional()
+	/** Minimum allowed value, in the device quantity's base unit. */
+	min: number().optional().meta(readingMeta("device")),
+	/** Maximum allowed value, in the device quantity's base unit. */
+	max: number().optional().meta(readingMeta("device")),
+	/** Step increment, in the device quantity's base unit. */
+	step: number().optional().meta(readingMeta("device"))
 });
 var ControlSetValueInputSchema = discriminatedUnion("kind", [
 	object({
@@ -58670,9 +59118,9 @@ var CoverStatusSchema = object({
 	]),
 	/** 0 = fully closed, 100 = fully open. Null when the device has
 	*  no intermediate position surface. */
-	position: number().min(0).max(100).nullable(),
+	position: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** 0 = closed slats, 100 = open slats. Null when no tilt support. */
-	tiltPosition: number().min(0).max(100).nullable(),
+	tiltPosition: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number()
 });
@@ -58775,9 +59223,9 @@ var NormalizedRangeSchema$1 = object({
 var DayNightStatusSchema = object({
 	mode: DayNightModeSchema,
 	/** IR-cut trigger sensitivity, NORMALIZED 0–100 (higher = switches to night sooner). */
-	sensitivity: number().optional(),
+	sensitivity: number().optional().meta(readingMeta("none")),
 	/** Delay before the IR-cut filter flips, in seconds. */
-	switchDelaySec: number().optional(),
+	switchDelaySec: number().optional().meta(readingMeta("duration")),
 	lastFetchedAt: number()
 });
 /**
@@ -58995,11 +59443,11 @@ var DishwasherStatusSchema = object({
 	/** Feature keys of the programs the appliance currently offers — drives the UI selector. */
 	availablePrograms: array(string()),
 	/** Seconds remaining on the active cycle, or null when not running / not known. */
-	remainingSeconds: number().int().nonnegative().nullable(),
+	remainingSeconds: number().int().nonnegative().nullable().meta(readingMeta("duration")),
 	/** Seconds the delayed start is set to (time until the cycle starts), or null. */
-	delayedStartSeconds: number().int().nonnegative().nullable(),
+	delayedStartSeconds: number().int().nonnegative().nullable().meta(readingMeta("duration")),
 	/** Cycle completion 0..100, or null when not applicable. */
-	progressPercent: number().min(0).max(100).nullable(),
+	progressPercent: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** True when the door is reported open; null when the door state is not known. */
 	doorOpen: boolean().nullable(),
 	/** True when the door is latched (locked) during a cycle; null when not reported. */
@@ -59023,7 +59471,7 @@ var DishwasherStatusSchema = object({
 	/** True while the machine-care (descaling / cleaning-program) reminder is raised; false when clear; null when not reported. */
 	machineCareDue: boolean().nullable(),
 	/** Program runs left before the machine-care reminder is due; null when the appliance does not say. */
-	machineCareRemainingRuns: number().int().nonnegative().nullable(),
+	machineCareRemainingRuns: number().int().nonnegative().nullable().meta(readingMeta("count")),
 	/** Option states: null when the appliance does not expose the option or has not said. */
 	halfLoad: boolean().nullable(),
 	hygienePlus: boolean().nullable(),
@@ -59038,7 +59486,7 @@ var DishwasherStatusSchema = object({
 	/** Feature keys of the events currently raised (salt low, rinse aid low, program finished, …). */
 	activeEvents: array(string()),
 	/** Numeric error code when the appliance reports one; null otherwise. */
-	errorCode: number().nullable(),
+	errorCode: number().nullable().meta(readingMeta("none")),
 	/** Name of the raised alert-level event while the appliance is in error; null otherwise. */
 	errorLabel: string().nullable(),
 	/** Ms epoch of the last value received from the appliance; 0 = never. */
@@ -59269,7 +59717,7 @@ var DoorbellStatusSchema = object({
 	/** Ms epoch of the last press. null = never observed since this provider started. */
 	lastPressedAt: number().nullable(),
 	/** Counter since provider start. Resets on reboot. Useful for metrics/debug. */
-	pressCountSinceStart: number()
+	pressCountSinceStart: number().meta(readingMeta("count"))
 });
 var DoorbellPressEventSchema = object({
 	deviceId: number(),
@@ -59334,17 +59782,7 @@ onPressed: {
 	history: "none",
 	customize: doorbellCustomize
 };
-/**
-* Enum-state sensor — a string value picked from a finite option set.
-* Drives HA `sensor` entries with `state_class: enum` (HVAC action
-* states, weather conditions, contact-source channels, mode strings).
-* The option set is stable across observations; it is persisted in the
-* device config blob (via the control slice at adoption) and is NOT
-* stored in `sourceInfo`.
-*/
-/** Locale-render shape for an ISO `value` carried by a `DateTimeSensor`-role
-*  enum sensor: `date` (date-only), `time` (time-only), `datetime` (both). */
-var EnumSensorDateTimeFormatSchema = _enum([
+_enum([
 	"date",
 	"time",
 	"datetime"
@@ -59352,12 +59790,11 @@ var EnumSensorDateTimeFormatSchema = _enum([
 var EnumSensorStatusSchema = object({
 	value: string(),
 	/**
-	* Set for `DateTimeSensor`-role sensors so the UI renders the ISO `value`
-	* as a locale date/time/datetime; absent for plain enum sensors. HA
-	* `device_class=timestamp` → `'datetime'`, `device_class=date` → `'date'`,
-	* a time-only sensor → `'time'`.
+	* Set when `value` is a timestamp rather than an enum state, so history
+	* does not learn ISO strings as states. The display shape (date / time /
+	* datetime) lives on `SourceInfo.dateTimeShape`, written once at adopt.
 	*/
-	format: EnumSensorDateTimeFormatSchema.optional(),
+	timestamp: boolean().optional(),
 	/** Ms epoch when the slice was last updated. */
 	lastFetchedAt: number()
 });
@@ -59384,11 +59821,11 @@ var enumSensorCapability = {
 	* History (D850): the value as an `enum` series (an appliance's program or
 	* operation state, an HVAC action). The option set is per device, so the
 	* value list is LEARNED as values are first seen (bounded). A sensor with a
-	* `format` carries a timestamp, not a state, and is not recorded.
+	* `timestamp` carries a clock, not a state, and is not recorded.
 	*/
 	history: { fields: { value: {
 		kind: "enum",
-		skipWhenSet: "format"
+		skipWhenSet: "timestamp"
 	} } },
 	/** Clock fields: written, but excluded from the compare that decides
 	*  whether persisting is worth a SQLite commit. */
@@ -59408,13 +59845,13 @@ var EventFireSchema = object({
 	deviceId: number(),
 	eventType: string(),
 	data: record(string(), unknown()).nullable(),
-	timestamp: number(),
-	seq: number()
+	timestamp: number().meta(readingMeta("none")),
+	seq: number().meta(readingMeta("count"))
 });
 var EventEmitterStatusSchema = object({
 	eventTypes: array(string()),
 	lastEvent: EventFireSchema.nullable(),
-	eventCountSinceStart: number()
+	eventCountSinceStart: number().meta(readingMeta("count"))
 });
 var eventEmitterCapability = {
 	name: "event-emitter",
@@ -59827,10 +60264,10 @@ var FanDirectionSchema = _enum(["forward", "reverse"]);
 var FanControlStatusSchema = object({
 	/** Active speed as 0..100 inclusive. Null when the device has no
 	*  speed surface (single-speed fan). */
-	percentage: number().min(0).max(100).nullable(),
+	percentage: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** Speed granularity the device accepts (HA `percentage_step`, e.g. 25 for
 	*  a 4-speed fan). Absent when unknown — the UI then falls back to step 1. */
-	percentageStep: number().positive().optional(),
+	percentageStep: number().positive().optional().meta(readingMeta("percentage")),
 	/** Active preset mode (`auto` / `quiet` / `turbo` / vendor-specific)
 	*  — empty string when no preset is active or supported. */
 	preset: string(),
@@ -59951,7 +60388,7 @@ var FeatureProbeStatusSchema = object({
 	/** Camera/firmware model string. `null` when the firmware doesn't expose it. */
 	model: string().nullable(),
 	/** Channel count for NVR/Hub devices; `1` for standalone cameras; `null` pre-probe. */
-	channelCount: number().nullable(),
+	channelCount: number().nullable().meta(readingMeta("count")),
 	/**
 	* Ms epoch of the last SUCCESSFUL probe. `0` before the first probe
 	* completes — drivers' `getAccessoryChildren()` should treat zero as
@@ -60074,9 +60511,91 @@ var gasCapability = {
 	*  whether persisting is worth a SQLite commit. */
 	volatileStateFields: ["lastChangedAt"]
 };
+var GroupCommandsSchema = object({ 
+/** One row per member that has been commanded. A later command replaces that member's row. */
+results: array(object({
+	deviceId: number().int().nonnegative(),
+	cap: string().min(1),
+	method: string().min(1),
+	ok: boolean(),
+	error: string().optional(),
+	/** Ms epoch of the attempt. */
+	at: number()
+})) });
+var groupCommandsCapability = {
+	name: "group-commands",
+	scope: "device",
+	deviceNative: true,
+	mode: "singleton",
+	deviceTypes: [DeviceType.Switch, DeviceType.Light],
+	methods: {},
+	status: {
+		schema: GroupCommandsSchema,
+		kind: "push"
+	},
+	runtimeState: GroupCommandsSchema,
+	/**
+	* Runtime-state durability: **session** — the last attempt. A restored
+	* failure would outlive the command that caused it.
+	*
+	* See `RuntimeStateDurability`. Enforced by
+	* `scripts/check-runtime-state-durability.ts`.
+	*/
+	durability: "session",
+	history: "none"
+};
+/**
+* How many members of a helper group answered (D944). Counts are integers,
+* not measurements: zero included is a real count, never a stand-in reading.
+* The reading itself stays on the output capability. History is none — the
+* series that later statistics read is the output cap's own history block.
+*/
+var GroupStatusSchema = object({
+	/** Members whose current value entered the aggregate. */
+	included: number().int().nonnegative().meta(readingMeta("count", {
+		precision: 0,
+		label: "Reporting"
+	})),
+	/** Members left out: offline, unknown, or not a finite reading (D393). */
+	excluded: number().int().nonnegative().meta(readingMeta("count", {
+		precision: 0,
+		label: "Excluded"
+	})),
+	/** `included` + `excluded`. */
+	total: number().int().nonnegative().meta(readingMeta("count", {
+		precision: 0,
+		label: "Members"
+	}))
+});
+var groupStatusCapability = {
+	name: "group-status",
+	scope: "device",
+	deviceNative: true,
+	mode: "singleton",
+	deviceTypes: [
+		DeviceType.Sensor,
+		DeviceType.Switch,
+		DeviceType.Light
+	],
+	methods: {},
+	status: {
+		schema: GroupStatusSchema,
+		kind: "push"
+	},
+	runtimeState: GroupStatusSchema,
+	/**
+	* Runtime-state durability: **session** — recomputed from members on the
+	* next source event; a restored count would outlive the readings it named.
+	*
+	* See `RuntimeStateDurability`. Enforced by
+	* `scripts/check-runtime-state-durability.ts`.
+	*/
+	durability: "session",
+	history: "none"
+};
 var HeatingValveStatusSchema = object({
 	/** Radiator valve opening 0 (closed) .. 100 (open). Null = not yet known. */
-	position: number().min(0).max(100).nullable(),
+	position: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** Ms epoch when the slice was last updated (push or poll). */
 	lastFetchedAt: number()
 });
@@ -60119,9 +60638,9 @@ var HumidifierStatusSchema = object({
 	/** Whether the humidifier is currently on. */
 	on: boolean(),
 	/** Current measured relative humidity (0..100). Null when not reported. */
-	currentHumidity: number().min(0).max(100).nullable(),
+	currentHumidity: number().min(0).max(100).nullable().meta(readingMeta("humidity")),
 	/** Target relative humidity (0..100). Null when no setpoint surface. */
-	targetHumidity: number().min(0).max(100).nullable(),
+	targetHumidity: number().min(0).max(100).nullable().meta(readingMeta("humidity")),
 	/** Active mode (`auto` / `normal` / `baby` / vendor). Null when the
 	*  device has no mode surface. */
 	mode: string().nullable(),
@@ -60131,9 +60650,9 @@ var HumidifierStatusSchema = object({
 	*  `idle` / `off`). Null when the device doesn't report it. */
 	action: string().nullable(),
 	/** HA `min_humidity` attribute. Null → UI uses 0. */
-	minHumidity: number().nullable(),
+	minHumidity: number().nullable().meta(readingMeta("humidity")),
 	/** HA `max_humidity` attribute. Null → UI uses 100. */
-	maxHumidity: number().nullable(),
+	maxHumidity: number().nullable().meta(readingMeta("humidity")),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number()
 });
@@ -60203,22 +60722,13 @@ var humidifierCapability = {
 * `sourceInfo`.
 */
 var HumiditySensorStatusSchema = object({
-	/** Current relative humidity, 0..100. */
-	percent: number().min(0).max(100).meta({
-		unit: "%",
+	/** Current relative humidity, 0..100. `null` when the sample was refused (D393). */
+	percent: number().min(0).max(100).nullable().meta(readingMeta("humidity", {
+		precision: 0,
 		label: "Humidity"
-	}),
+	})),
 	/** Ms epoch when the slice was last updated. */
-	lastFetchedAt: number(),
-	/** Live display unit from the upstream source (e.g. HA
-	*  `attributes.unit_of_measurement`). The UI prefers this over the
-	*  role's canonical unit. Absent → fall back to the canonical unit. */
-	unit: string().optional(),
-	/** Suggested decimal places for numeric display.
-	*  Populated live from the upstream source when provided (e.g. HA
-	*  `attributes.suggested_display_precision`). Falls back to
-	*  auto-formatting when absent. */
-	precision: number().int().min(0).max(10).optional()
+	lastFetchedAt: number()
 });
 var humiditySensorCapability = {
 	name: "humidity-sensor",
@@ -60249,12 +60759,7 @@ var humiditySensorCapability = {
 	} } },
 	/** Clock fields: written, but excluded from the compare that decides
 	*  whether persisting is worth a SQLite commit. */
-	volatileStateFields: ["lastFetchedAt"],
-	customize: {
-		version: 1,
-		advanced: "derive",
-		targets: []
-	}
+	volatileStateFields: ["lastFetchedAt"]
 };
 /**
 * Image display cap. Models a single still image exposed by an integration —
@@ -60275,7 +60780,7 @@ var ImageStatusSchema = object({
 	*  entity exposes no `entity_picture` (yet). */
 	url: string().nullable(),
 	/** Ms epoch of the upstream last-updated timestamp. Null at cold-start. */
-	lastUpdated: number().nullable()
+	lastUpdated: number().nullable().meta(readingMeta("none"))
 });
 var imageCapability = {
 	name: "image",
@@ -60363,19 +60868,19 @@ var NormalizedRangeSchema = object({
 */
 var ImageSettingsStatusSchema = object({
 	/** Normalized 0–100. */
-	brightness: number().optional(),
+	brightness: number().optional().meta(readingMeta("none")),
 	/** Normalized 0–100. */
-	contrast: number().optional(),
+	contrast: number().optional().meta(readingMeta("none")),
 	/** Normalized 0–100. */
-	saturation: number().optional(),
+	saturation: number().optional().meta(readingMeta("none")),
 	/** Normalized 0–100. */
-	sharpness: number().optional(),
+	sharpness: number().optional().meta(readingMeta("none")),
 	mirror: boolean().optional(),
 	flip: boolean().optional(),
 	rotate: ImageRotateSchema.optional(),
 	whiteBalance: WhiteBalanceModeSchema.optional(),
 	/** Manual white-balance warmth, NORMALIZED 0–100. Meaningful only when `whiteBalance === 'manual'`. */
-	warmth: number().optional(),
+	warmth: number().optional().meta(readingMeta("none")),
 	exposureMode: ExposureModeSchema.optional(),
 	backlightMode: BacklightModeSchema.optional(),
 	lastFetchedAt: number()
@@ -60654,10 +61159,10 @@ var IntercomAbilitySchema = object({
 	/** Codecs accepted by firmware, in preference order. Driver-authored strings. */
 	codecs: array(string()),
 	/** Sample rate (Hz) the firmware expects. Reolink typical: 16000. */
-	sampleRate: number(),
+	sampleRate: number().meta(readingMeta("none")),
 	duplex: _enum(["half", "full"]),
 	/** Max in-flight audio backlog before drop (ms). Server uses this to bound latency. */
-	maxBacklogMs: number()
+	maxBacklogMs: number().meta(readingMeta("duration-ms"))
 });
 var IntercomStatusSchema = object({
 	/** True while a talk session is open. */
@@ -60884,13 +61389,13 @@ var LawnMowerControlStatusSchema = object({
 	activity: LawnMowerActivitySchema,
 	/** 0..100 battery percentage. Null when the device has no battery
 	*  reading. */
-	batteryLevel: number().min(0).max(100).nullable(),
+	batteryLevel: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** 0..100 mowing-completion percentage of the current task, or null when no
 	*  task is active / progress is unavailable. */
-	progressPercent: number().min(0).max(100).nullable(),
+	progressPercent: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** Current device/event code (dynamic — mostly status, sometimes an error),
 	*  or null when unknown. */
-	currentCode: number().nullable(),
+	currentCode: number().nullable().meta(readingMeta("none")),
 	/** Human label for {@link currentCode}, or null when undecodable. */
 	currentCodeLabel: string().nullable(),
 	/** Severity of {@link currentCode}. `error` (and often `warning`) warrants UI
@@ -61423,7 +61928,7 @@ var MediaPlayerStatusSchema = object({
 	state: MediaPlayerStateSchema,
 	/** Volume as 0..100 inclusive. Null when the device has no volume
 	*  surface. Pair with `DeviceFeature.MediaPlayerVolume`. */
-	volumeLevel: number().min(0).max(100).nullable(),
+	volumeLevel: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** Mute toggle distinct from volume=0. Null when no mute surface.
 	*  Pair with `DeviceFeature.MediaPlayerMute`. */
 	isMuted: boolean().nullable(),
@@ -61436,10 +61941,10 @@ var MediaPlayerStatusSchema = object({
 	currentMedia: MediaInfoSchema.nullable(),
 	/** Current playback position in ms. Null when not seekable or
 	*  nothing is playing. Pair with `DeviceFeature.MediaPlayerSeek`. */
-	positionMs: number().int().nonnegative().nullable(),
+	positionMs: number().int().nonnegative().nullable().meta(readingMeta("duration-ms")),
 	/** Total duration of the current media in ms. Null when unknown
 	*  (live stream) or nothing is playing. */
-	durationMs: number().int().nonnegative().nullable(),
+	durationMs: number().int().nonnegative().nullable().meta(readingMeta("duration-ms")),
 	/** Shuffle toggle. Null when no shuffle surface.
 	*  Pair with `DeviceFeature.MediaPlayerShuffle`. */
 	shuffle: boolean().nullable(),
@@ -61748,7 +62253,7 @@ var motionCustomize = {
 			eventName: "onMotionChanged"
 		},
 		deviceTypes: [DeviceType.Camera],
-		apply: "replace",
+		apply: "add",
 		applyAuthority: {
 			kind: "camera-sensors",
 			timeoutField: "motionCooldownMs"
@@ -61820,7 +62325,7 @@ var MotionStatusSchema = object({
 	* it, every provider seeded it at boot, and every session left it
 	* `detected: true` after its detach.
 	*/
-	autoClearAfterMs: number().nullable()
+	autoClearAfterMs: number().nullable().meta(readingMeta("duration-ms"))
 });
 /**
 * Payload of `motion.onMotionChanged` event + the corresponding bus
@@ -61857,12 +62362,18 @@ var motionCapability = {
 	methods: { 
 	/**
 	* Pull the current motion state synchronously. Convenience shortcut
-	* for consumers that don't need the full status object; equivalent
-	* to `getStatus()?.detected ?? false`. Will likely be folded into
-	* `getStatus` once the auto-injected status surface lands in every
-	* consumer.
+	* for consumers that don't need the full status object. A composed
+	* group answers from its slice (D944): unknown throws, it is not off.
 	*/
 isDetected: method(object({ deviceId: number() }), boolean()) },
+	/**
+	* A composed motion group serves `isDetected` from `detected` (D944).
+	* Without this the cap stays uncomposable (`has-commands`).
+	*/
+	composedMethods: { isDetected: {
+		kind: "slice",
+		field: "detected"
+	} },
 	events: { 
 	/**
 	* Fires every time the runner transitions a camera between
@@ -62002,7 +62513,7 @@ var MotionZoneRegionSchema = object({
 *  the grid region(s). */
 var MotionZoneStatusSchema = object({
 	enabled: boolean(),
-	sensitivity: number(),
+	sensitivity: number().meta(readingMeta("none")),
 	/** Grid region(s). Today exactly one `grid` shape. */
 	regions: array(MotionZoneRegionSchema),
 	lastFetchedAt: number()
@@ -62372,7 +62883,7 @@ var NavigationStatusSchema = object({
 	following: boolean(),
 	flash: boolean(),
 	lightMode: NavigationLightModeSchema,
-	lightLevel: number().min(40).max(100),
+	lightLevel: number().min(40).max(100).meta(readingMeta("none")),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number()
 });
@@ -62506,13 +63017,13 @@ var NetworkLinkStatusSchema = object({
 	* one whose reading has not landed must not be drawn at 0 %. Consumers
 	* SKIP a null rather than coerce it.
 	*/
-	signalPercent: number().min(0).max(100).nullable(),
+	signalPercent: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** Raw received signal strength in dBm, when the firmware reports one. */
-	rssiDbm: number().optional(),
+	rssiDbm: number().optional().meta(readingMeta("signal-level")),
 	/** Network name of a wireless link, when the firmware reports it. */
 	ssid: string().optional(),
 	/** Ms epoch of the last observation. Lets consumers reason about freshness. */
-	lastUpdated: number()
+	lastUpdated: number().meta(readingMeta("none"))
 });
 var networkLinkCapability = {
 	name: "network-link",
@@ -62897,7 +63408,7 @@ var NotifierStatusSchema = object({
 	lastError: string().nullable(),
 	/** Number of deliveries currently buffered server-side (rate-limited
 	*  notifiers may queue). 0 when the provider sends synchronously. */
-	queueDepth: number().int().nonnegative(),
+	queueDepth: number().int().nonnegative().meta(readingMeta("count")),
 	/** Per-feature capability matrix — authoritative source for the
 	*  compose-form field gating. */
 	supports: NotifierSupportsSchema
@@ -62989,11 +63500,9 @@ onSent: { data: object({
 * cap fits (HA `sensor` whose `device_class` we don't have a typed cap
 * for: water flow, distance, weight, frequency, signal strength, …).
 *
-* The `unit` and `precision` fields carry the live display metadata that
-* the upstream source provides with each state push (HA
-* `attributes.unit_of_measurement` / `attributes.suggested_display_precision`).
-* The UI reads them directly from the slice — they are the single source
-* of truth for generic numeric rendering and do NOT live on `sourceInfo`.
+* The quantity is not on this slice. It is chosen when the device is
+* adopted and stored once on `SourceInfo.quantity` (D944). `value` is in
+* that quantity's base unit. `null` is a refused sample (D393).
 *
 * Prefer the typed alternatives (`temperature-sensor`, `humidity-sensor`,
 * `ambient-light-sensor`, `pressure-sensor`, `power-meter`,
@@ -63002,15 +63511,8 @@ onSent: { data: object({
 * numeric values land here.
 */
 var NumericSensorStatusSchema = object({
-	value: number(),
-	/** Display unit-of-measurement (e.g. 'dBm', 's', 'rpm', 'steps').
-	*  Populated live from the upstream source on each state push.
-	*  Absent for unitless sensors. */
-	unit: string().optional(),
-	/** Suggested decimal places for numeric display.
-	*  Populated live from the upstream source when provided.
-	*  Falls back to auto-formatting when absent. */
-	precision: number().int().min(0).max(10).optional(),
+	/** Reading in the device quantity's base unit. `null` when refused (D393). */
+	value: number().nullable().meta(readingMeta("device")),
 	/** Ms epoch when the slice was last updated. */
 	lastFetchedAt: number()
 });
@@ -63034,11 +63536,11 @@ var numericSensorCapability = {
 	*/
 	durability: "restored",
 	/**
-	* History (D850): recorded series. The unit is per device, read from the sibling `unit` field.
+	* History (D850): recorded series. The unit is the device quantity's base,
+	* resolved when the series is read — the cap has no single unit.
 	*/
 	history: { fields: { value: {
 		kind: "gauge",
-		unitFrom: "unit",
 		minIntervalMs: 3e4
 	} } },
 	/** Clock fields: written, but excluded from the compare that decides
@@ -63330,23 +63832,26 @@ var PetFeederStatusSchema = object({
 	/** Food currently in the bowl (grams). Null when the device has not
 	*  reported a reading yet. On dual-hopper models this is the combined
 	*  bowl reading; per-hopper levels live in `food1`/`food2`. */
-	foodLevel: number().nullable(),
+	foodLevel: number().nullable().meta(readingMeta("none")),
 	/** Hopper-1 food level (grams) on dual-hopper feeders; null on
 	*  single-hopper models. */
-	food1: number().nullable(),
+	food1: number().nullable().meta(readingMeta("none")),
 	/** Hopper-2 food level (grams) on dual-hopper feeders; null on
 	*  single-hopper models. */
-	food2: number().nullable(),
+	food2: number().nullable().meta(readingMeta("none")),
 	/** Derived low-food flag — mirrors the HA `food_level` binary_sensor
 	*  (`device_class: problem`, on = low). True when the bowl is empty /
 	*  below the feeder's low threshold. */
 	lowFood: boolean(),
 	/** Battery charge 0..100 (%). Null on mains-powered models or when the
 	*  device has no battery reading. */
-	batteryPower: number().min(0).max(100).nullable(),
-	/** Days of desiccant life remaining. Null when the model has no
-	*  desiccant sensor. */
-	desiccantLeftDays: number().nullable(),
+	batteryPower: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
+	/**
+	* Desiccant life remaining, stored in seconds (duration base, D944).
+	* Providers convert from the days the feeder reports. Null when the
+	* model has no desiccant sensor.
+	*/
+	desiccantLeftDays: number().nullable().meta(readingMeta("duration")),
 	/** True while a feed is in progress. */
 	feeding: boolean(),
 	/** Decoded connectivity / power status (HA petkit device-status enum).
@@ -63357,7 +63862,7 @@ var PetFeederStatusSchema = object({
 	*  with `errorCode` for consumers that want the raw integer. */
 	error: string().nullable(),
 	/** Raw device error code (0 / null = no error). */
-	errorCode: number().nullable(),
+	errorCode: number().nullable().meta(readingMeta("none")),
 	/** True for D4S/D4SH dual-hopper hardware — gates the per-hopper UI. */
 	isDualHopper: boolean(),
 	/** Child-lock (manual-lock) setting — buttons on the unit are disabled. */
@@ -63367,7 +63872,7 @@ var PetFeederStatusSchema = object({
 	/** Play a chime when dispensing. */
 	feedSound: boolean(),
 	/** Speaker / prompt volume level (device-scaled integer). */
-	volume: number(),
+	volume: number().meta(readingMeta("none")),
 	/** Ms epoch when the slice was last refreshed from the cloud. */
 	lastFetchedAt: number()
 });
@@ -63486,7 +63991,7 @@ var petFeederCapability = {
 		},
 		desiccantLeftDays: {
 			kind: "gauge",
-			unit: "days"
+			unit: "s"
 		}
 	} }
 };
@@ -63887,36 +64392,19 @@ method(_void(), PlatformCapabilitiesSchema), method(_void(), HardwareInfoSchema)
 */
 var PowerMeterStatusSchema = object({
 	/** Instantaneous power draw in watts. */
-	watts: number().optional().meta({
-		unit: "W",
-		label: "Power"
-	}),
+	watts: number().optional().meta(readingMeta("power", { label: "Power" })),
 	/** Cumulative energy in kilowatt-hours since the meter was reset. */
-	kwhTotal: number().optional().meta({
-		unit: "kWh",
-		label: "Energy"
-	}),
+	kwhTotal: number().optional().meta(readingMeta("energy", { label: "Energy" })),
 	/** Voltage in volts. */
-	volts: number().optional(),
+	volts: number().optional().meta(readingMeta("voltage")),
 	/** Current in amperes. */
-	amps: number().optional(),
-	/** Apparent power in volt-amperes (W × power-factor reciprocal). */
-	va: number().optional(),
+	amps: number().optional().meta(readingMeta("current")),
+	/** Apparent power in volt-amperes. */
+	va: number().optional().meta(readingMeta("apparent-power")),
 	/** Power factor (0..1) if reported. */
-	powerFactor: number().min(0).max(1).optional(),
+	powerFactor: number().min(0).max(1).optional().meta(readingMeta("ratio")),
 	/** Ms epoch when the slice was last updated. */
-	lastFetchedAt: number(),
-	/** Live display unit of the single metric this slice carries (e.g. HA
-	*  `attributes.unit_of_measurement` → 'V' / 'A' / 'W' / 'kW' / 'kWh').
-	*  Each upstream `sensor.*` entity surfaces ONE device_class, so one
-	*  unit per slice is unambiguous. The UI prefers this over the role's
-	*  canonical unit so a 'kW' / 'Wh' feed renders verbatim. */
-	unit: string().optional(),
-	/** Suggested decimal places for numeric display.
-	*  Populated live from the upstream source when provided (e.g. HA
-	*  `attributes.suggested_display_precision`). Falls back to
-	*  auto-formatting when absent. */
-	precision: number().int().min(0).max(10).optional()
+	lastFetchedAt: number()
 });
 var powerMeterCapability = {
 	name: "power-meter",
@@ -63980,12 +64468,7 @@ var powerMeterCapability = {
 	} },
 	/** Clock fields: written, but excluded from the compare that decides
 	*  whether persisting is worth a SQLite commit. */
-	volatileStateFields: ["lastFetchedAt"],
-	customize: {
-		version: 1,
-		advanced: "derive",
-		targets: []
-	}
+	volatileStateFields: ["lastFetchedAt"]
 };
 /**
 * Presence cap. Models HA `person.*` and `device_tracker.*` entities
@@ -64005,11 +64488,11 @@ var powerMeterCapability = {
 */
 var GpsLocationSchema = object({
 	/** Latitude in decimal degrees, -90..90. */
-	latitude: number().min(-90).max(90),
+	latitude: number().min(-90).max(90).meta(readingMeta("angle")),
 	/** Longitude in decimal degrees, -180..180. */
-	longitude: number().min(-180).max(180),
+	longitude: number().min(-180).max(180).meta(readingMeta("angle")),
 	/** Reported accuracy in meters (lower = better). */
-	accuracyMeters: number().nonnegative()
+	accuracyMeters: number().nonnegative().meta(readingMeta("length"))
 });
 var PresenceStatusSchema = object({
 	/** `home` / `not_home` / any user-defined zone name. */
@@ -64021,7 +64504,7 @@ var PresenceStatusSchema = object({
 	gps: GpsLocationSchema.nullable(),
 	/** Optional battery level of the tracking device (0..100). Null
 	*  when not reported. */
-	batteryPercent: number().min(0).max(100).nullable(),
+	batteryPercent: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number()
 });
@@ -64071,19 +64554,10 @@ var presenceCapability = {
 * `sourceInfo`.
 */
 var PressureSensorStatusSchema = object({
-	/** Current pressure in hPa. */
-	hpa: number(),
+	/** Current pressure in hPa. `null` when the sample was refused (D393). */
+	hpa: number().nullable().meta(readingMeta("pressure", { precision: 0 })),
 	/** Ms epoch when the slice was last updated. */
-	lastFetchedAt: number(),
-	/** Live display unit from the upstream source (e.g. HA
-	*  `attributes.unit_of_measurement`). The UI prefers this over the
-	*  role's canonical unit. Absent → fall back to the canonical unit. */
-	unit: string().optional(),
-	/** Suggested decimal places for numeric display.
-	*  Populated live from the upstream source when provided (e.g. HA
-	*  `attributes.suggested_display_precision`). Falls back to
-	*  auto-formatting when absent. */
-	precision: number().int().min(0).max(10).optional()
+	lastFetchedAt: number()
 });
 var pressureSensorCapability = {
 	name: "pressure-sensor",
@@ -64497,8 +64971,8 @@ DeviceType.Camera, method(PtzMoveCommandSchema.extend({ deviceId: number() }), _
 }), _void(), { kind: "mutation" });
 var PtzAutotrackSettingsSchema = object({
 	targetType: string().describe("Vendor target string (people/vehicle/pet); empty = camera default"),
-	stopDelaySeconds: number().int().min(0).max(300),
-	disappearDelaySeconds: number().int().min(0).max(300)
+	stopDelaySeconds: number().int().min(0).max(300).meta(readingMeta("duration")),
+	disappearDelaySeconds: number().int().min(0).max(300).meta(readingMeta("duration"))
 });
 /**
 * One option the camera advertises as a valid `targetType`. Drivers
@@ -64652,7 +65126,7 @@ var RunningStateStatusSchema = object({
 	/** null = unknown — never coerced to false (D393). */
 	running: boolean().nullable(),
 	/** Epoch ms the current boolean began; null while `running` is null. */
-	since: number().nullable(),
+	since: number().nullable().meta(readingMeta("none")),
 	source: RunningStateSourceSchema.meta({ label: "Source" }),
 	phase: string().nullable(),
 	/** null until a reading has been published (D393). */
@@ -64667,7 +65141,6 @@ var RUNNING_DEVICE_TYPES = Object.values(DeviceType);
 /** Generic Customize target for the running boolean (D936). */
 var runningCustomize = {
 	version: 1,
-	advanced: "derive",
 	targets: [{
 		id: "running",
 		cardinality: "scalar",
@@ -64687,7 +65160,7 @@ var runningCustomize = {
 			DeviceType.Thermostat,
 			DeviceType.PetFeeder
 		],
-		apply: "add-or-replace",
+		apply: "add",
 		path: "running",
 		sources: [
 			{
@@ -65951,9 +66424,9 @@ var RecordTriggerSchema = _enum([
 */
 var RecordWindowSchema = object({
 	trigger: RecordTriggerSchema,
-	day: number().int().min(0).max(6),
-	startMinute: number().int().min(0).max(1439),
-	endMinute: number().int().min(1).max(1440)
+	day: number().int().min(0).max(6).meta(readingMeta("none")),
+	startMinute: number().int().min(0).max(1439).meta(readingMeta("none")),
+	endMinute: number().int().min(1).max(1440).meta(readingMeta("none"))
 });
 /** Status of one physical volume, as the camera itself describes it. */
 var OnboardStorageVolumeSchema = object({
@@ -66029,10 +66502,10 @@ var RecordingOnboardStatusSchema = object({
 	/** Master "record to the card at all" switch. */
 	enabled: boolean().nullable(),
 	overwriteWhenFull: boolean().nullable(),
-	preRecordSec: number().nullable(),
-	postRecordSec: number().nullable(),
+	preRecordSec: number().nullable().meta(readingMeta("duration")),
+	postRecordSec: number().nullable().meta(readingMeta("duration")),
 	/** Length of one recorded file, in minutes. */
-	segmentMinutes: number().nullable(),
+	segmentMinutes: number().nullable().meta(readingMeta("none")),
 	/** The primary track's weekly windows, flattened. */
 	windows: array(RecordWindowSchema),
 	/**
@@ -66048,7 +66521,7 @@ var RecordingOnboardStatusSchema = object({
 	* provider reporting a non-zero count also reports the schedule as not
 	* writable.
 	*/
-	unreadableWindows: number(),
+	unreadableWindows: number().meta(readingMeta("count")),
 	/**
 	* The camera is scheduled to record and has NO usable storage.
 	*
@@ -66893,7 +67366,7 @@ var CamStreamDescriptorSchema = object({
 	url: string().optional(),
 	codec: string().optional(),
 	resolution: CamStreamResolutionSchema.optional(),
-	fps: number().positive().optional(),
+	fps: number().positive().optional().meta(readingMeta("rate")),
 	label: string().optional(),
 	/** Device-level features (e.g. `battery-operated`) — drives broker policy. */
 	deviceFeatures: array(string()).optional(),
@@ -66980,18 +67453,18 @@ var StreamProfileSchema = _enum([
 ]);
 /** The current encoding config of one stream profile. */
 var StreamProfileConfigSchema = object({
-	width: number(),
-	height: number(),
+	width: number().meta(readingMeta("none")),
+	height: number().meta(readingMeta("none")),
 	codec: _enum(["h264", "h265"]),
-	framerate: number(),
-	bitrate: number(),
+	framerate: number().meta(readingMeta("rate")),
+	bitrate: number().meta(readingMeta("bitrate")),
 	bitrateMode: _enum(["vbr", "cbr"]).optional(),
 	encoderProfile: _enum([
 		"high",
 		"main",
 		"baseline"
 	]).optional(),
-	gop: number().optional(),
+	gop: number().optional().meta(readingMeta("none")),
 	/**
 	* Whether THIS profile currently carries an audio track. READ-ONLY here.
 	*
@@ -67212,12 +67685,7 @@ var switchCapability = {
 			label: "On",
 			kind: "boolean"
 		}
-	}] },
-	customize: {
-		version: 1,
-		advanced: "derive",
-		targets: []
-	}
+	}] }
 };
 /** C0 controls, DEL and the C1 range: none of them belongs in a name. */
 function hasControlCharacter(value) {
@@ -67800,35 +68268,21 @@ var tamperCapability = {
 * entries with `device_class: temperature` and any future native
 * thermometer.
 *
-* Unit normalisation: providers convert to Celsius before storing.
-* The slice value is always Celsius so cross-cap aggregators
-* (climate-control's `currentTemp`, energy analytics) can compose
-* without per-source unit fixups. The canonical display unit (`°C`) is
-* a descriptor constant in the UI (ROLE_DESCRIPTOR), not stored in
-* `sourceInfo`.
+* The number is Celsius (D944). Providers convert on ingest. A failed
+* conversion is `null`, never a guess. Display unit is a read-time preference.
 *
 * Status `lastFetchedAt` lets staleness-aware consumers detect a
 * frozen feed (provider hung) distinct from a "temperature hasn't
 * changed" steady state.
 */
 var TemperatureSensorStatusSchema = object({
-	/** Current temperature in Celsius. */
-	celsius: number().meta({
-		unit: "°C",
+	/** Current temperature in Celsius. `null` when the sample was refused (D393). */
+	celsius: number().nullable().meta(readingMeta("temperature", {
+		precision: 1,
 		label: "Temperature"
-	}),
+	})),
 	/** Ms epoch when the slice was last updated (push or poll). */
-	lastFetchedAt: number(),
-	/** Live display unit from the upstream source (e.g. HA
-	*  `attributes.unit_of_measurement`). The UI prefers this over the
-	*  role's canonical unit, so a Fahrenheit feed renders '°F' not '°C'.
-	*  Absent → the UI falls back to the role's canonical unit. */
-	unit: string().optional(),
-	/** Suggested decimal places for numeric display.
-	*  Populated live from the upstream source when provided (e.g. HA
-	*  `attributes.suggested_display_precision`). Falls back to
-	*  auto-formatting when absent. */
-	precision: number().int().min(0).max(10).optional()
+	lastFetchedAt: number()
 });
 var temperatureSensorCapability = {
 	name: "temperature-sensor",
@@ -67859,12 +68313,7 @@ var temperatureSensorCapability = {
 	} } },
 	/** Clock fields: written, but excluded from the compare that decides
 	*  whether persisting is worth a SQLite commit. */
-	volatileStateFields: ["lastFetchedAt"],
-	customize: {
-		version: 1,
-		advanced: "derive",
-		targets: []
-	}
+	volatileStateFields: ["lastFetchedAt"]
 };
 /**
 * toast — system-scoped singleton capability that streams toast
@@ -68147,16 +68596,16 @@ var VacuumControlStatusSchema = object({
 	]),
 	/** 0..100 battery percentage. Null when the device has no battery
 	*  reading. */
-	batteryLevel: number().min(0).max(100).nullable(),
+	batteryLevel: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** Current fan-speed token (provider-verbatim). Null when unknown or
 	*  the vacuum has no speed control. */
 	fanSpeed: string().nullable(),
 	/** Speed tokens the hardware accepts — drives the UI selector. */
 	availableFanSpeeds: array(string()),
 	/** 0..100 cleaning-completion percentage of the current task, or null. */
-	progressPercent: number().min(0).max(100).nullable(),
+	progressPercent: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** Current error code (0 / null = no error). */
-	errorCode: number().nullable(),
+	errorCode: number().nullable().meta(readingMeta("none")),
 	/** Human label for {@link errorCode}, or null when none / undecodable. */
 	errorLabel: string().nullable(),
 	/** Ms epoch when the slice was last updated. */
@@ -68234,7 +68683,7 @@ var ValveStatusSchema = object({
 	]),
 	/** 0 = fully closed, 100 = fully open. Null when the device has no
 	*  intermediate position surface. */
-	position: number().min(0).max(100).nullable(),
+	position: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number()
 });
@@ -68342,9 +68791,9 @@ var vibrationCapability = {
 */
 var WaterHeaterStatusSchema = object({
 	/** Current measured temperature. Null when not reported. */
-	currentTemp: number().nullable(),
+	currentTemp: number().nullable().meta(readingMeta("temperature")),
 	/** Target temperature setpoint. Null when no setpoint surface. */
-	targetTemp: number().nullable(),
+	targetTemp: number().nullable().meta(readingMeta("temperature")),
 	/** Active operation mode = HA `state` (`eco` / `electric` / `gas` /
 	*  `heat_pump` / `high_demand` / `performance` / `off`). Null when the
 	*  device reports an unknown state. */
@@ -68355,9 +68804,9 @@ var WaterHeaterStatusSchema = object({
 	*  has no away surface. */
 	away: boolean().nullable(),
 	/** HA `min_temp` attribute. Null when not reported. */
-	minTemp: number().nullable(),
+	minTemp: number().nullable().meta(readingMeta("temperature")),
 	/** HA `max_temp` attribute. Null when not reported. */
-	maxTemp: number().nullable(),
+	maxTemp: number().nullable().meta(readingMeta("temperature")),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number()
 });
@@ -68442,25 +68891,18 @@ var waterHeaterCapability = {
 * Forecast deferred — current conditions only for v1.
 */
 var WeatherStatusSchema = object({
-	/** Verbatim HA condition state (`sunny`, `cloudy`, `rainy`, …). Null
-	*  when no condition has been reported yet. */
+	/** Verbatim condition state (`sunny`, `cloudy`, `rainy`, …). Null when none yet. */
 	condition: string().nullable(),
-	/** Current temperature in the reported unit. Null when not provided. */
-	temperature: number().nullable(),
-	/** Temperature unit string (e.g. `°C` / `°F`). Null when not provided. */
-	temperatureUnit: string().nullable(),
+	/** Current temperature in Celsius. Null when not provided or refused. */
+	temperature: number().nullable().meta(readingMeta("temperature", { precision: 1 })),
 	/** Relative humidity (0..100). Null when not provided. */
-	humidity: number().min(0).max(100).nullable(),
-	/** Barometric pressure in the reported unit. Null when not provided. */
-	pressure: number().nullable(),
-	/** Pressure unit string (e.g. `hPa` / `inHg`). Null when not provided. */
-	pressureUnit: string().nullable(),
-	/** Wind speed in the reported unit. Null when not provided. */
-	windSpeed: number().nullable(),
-	/** Wind-speed unit string (e.g. `km/h` / `mph`). Null when not provided. */
-	windSpeedUnit: string().nullable(),
+	humidity: number().min(0).max(100).nullable().meta(readingMeta("humidity")),
+	/** Barometric pressure in hPa. Null when not provided or refused. */
+	pressure: number().nullable().meta(readingMeta("pressure")),
+	/** Wind speed in metres per second. Null when not provided or refused. */
+	windSpeed: number().nullable().meta(readingMeta("speed")),
 	/** Wind bearing in degrees (0..360, meteorological). Null when not provided. */
-	windBearing: number().nullable(),
+	windBearing: number().nullable().meta(readingMeta("angle")),
 	/** Ms epoch when the slice was last updated. */
 	lastFetchedAt: number()
 });
@@ -68488,12 +68930,12 @@ var weatherCapability = {
 	*/
 	durability: "session",
 	/**
-	* History (D850): recorded series. Units follow the sibling `*Unit` fields.
+	* History (D850): recorded series. Numbers are the quantity base (D944).
 	*/
 	history: { fields: {
 		temperature: {
 			kind: "gauge",
-			unitFrom: "temperatureUnit",
+			unit: "°C",
 			deadband: .2
 		},
 		humidity: {
@@ -68503,12 +68945,12 @@ var weatherCapability = {
 		},
 		pressure: {
 			kind: "gauge",
-			unitFrom: "pressureUnit",
+			unit: "hPa",
 			deadband: .5
 		},
 		windSpeed: {
 			kind: "gauge",
-			unitFrom: "windSpeedUnit",
+			unit: "m/s",
 			deadband: .5
 		}
 	} }
@@ -69409,6 +69851,389 @@ method(object({}), array(TrainingBaseModelSchema).readonly(), { auth: "admin" })
 	kind: "mutation",
 	auth: "admin"
 });
+/**
+* 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` ⇒
+* `factor = 5/9`, `offset = -160/9` (kept as exact expressions, not rounded
+* decimals). K derives from `°C = K − 273.15`.
+*/
+var UNIT_TABLE = {
+	"°C": {
+		dimension: "temperature",
+		factor: 1,
+		offset: 0
+	},
+	"°F": {
+		dimension: "temperature",
+		factor: 5 / 9,
+		offset: -160 / 9
+	},
+	K: {
+		dimension: "temperature",
+		factor: 1,
+		offset: -273.15
+	},
+	hPa: {
+		dimension: "pressure",
+		factor: 1,
+		offset: 0
+	},
+	kPa: {
+		dimension: "pressure",
+		factor: 10,
+		offset: 0
+	},
+	Pa: {
+		dimension: "pressure",
+		factor: .01,
+		offset: 0
+	},
+	mbar: {
+		dimension: "pressure",
+		factor: 1,
+		offset: 0
+	},
+	bar: {
+		dimension: "pressure",
+		factor: 1e3,
+		offset: 0
+	},
+	inHg: {
+		dimension: "pressure",
+		factor: 33.8639,
+		offset: 0
+	},
+	mmHg: {
+		dimension: "pressure",
+		factor: 1.33322,
+		offset: 0
+	},
+	psi: {
+		dimension: "pressure",
+		factor: 68.9476,
+		offset: 0
+	},
+	"m/s": {
+		dimension: "speed",
+		factor: 1,
+		offset: 0
+	},
+	"km/h": {
+		dimension: "speed",
+		factor: 1 / 3.6,
+		offset: 0
+	},
+	mph: {
+		dimension: "speed",
+		factor: .44704,
+		offset: 0
+	},
+	kn: {
+		dimension: "speed",
+		factor: .514444,
+		offset: 0
+	},
+	"mm/h": {
+		dimension: "precipitation-rate",
+		factor: 1,
+		offset: 0
+	},
+	"in/h": {
+		dimension: "precipitation-rate",
+		factor: 25.4,
+		offset: 0
+	},
+	m: {
+		dimension: "length",
+		factor: 1,
+		offset: 0
+	},
+	mm: {
+		dimension: "length",
+		factor: .001,
+		offset: 0
+	},
+	cm: {
+		dimension: "length",
+		factor: .01,
+		offset: 0
+	},
+	km: {
+		dimension: "length",
+		factor: 1e3,
+		offset: 0
+	},
+	in: {
+		dimension: "length",
+		factor: .0254,
+		offset: 0
+	},
+	ft: {
+		dimension: "length",
+		factor: .3048,
+		offset: 0
+	},
+	mi: {
+		dimension: "length",
+		factor: 1609.344,
+		offset: 0
+	},
+	"m²": {
+		dimension: "area",
+		factor: 1,
+		offset: 0
+	},
+	lx: {
+		dimension: "illuminance",
+		factor: 1,
+		offset: 0
+	},
+	"W/m²": {
+		dimension: "irradiance",
+		factor: 1,
+		offset: 0
+	},
+	W: {
+		dimension: "power",
+		factor: 1,
+		offset: 0
+	},
+	kW: {
+		dimension: "power",
+		factor: 1e3,
+		offset: 0
+	},
+	VA: {
+		dimension: "apparent-power",
+		factor: 1,
+		offset: 0
+	},
+	Wh: {
+		dimension: "energy",
+		factor: 1,
+		offset: 0
+	},
+	kWh: {
+		dimension: "energy",
+		factor: 1e3,
+		offset: 0
+	},
+	MWh: {
+		dimension: "energy",
+		factor: 1e6,
+		offset: 0
+	},
+	V: {
+		dimension: "voltage",
+		factor: 1,
+		offset: 0
+	},
+	mV: {
+		dimension: "voltage",
+		factor: .001,
+		offset: 0
+	},
+	A: {
+		dimension: "current",
+		factor: 1,
+		offset: 0
+	},
+	mA: {
+		dimension: "current",
+		factor: .001,
+		offset: 0
+	},
+	ppm: {
+		dimension: "concentration-volume",
+		factor: 1,
+		offset: 0
+	},
+	ppb: {
+		dimension: "concentration-volume",
+		factor: .001,
+		offset: 0
+	},
+	"µg/m³": {
+		dimension: "concentration-mass",
+		factor: 1,
+		offset: 0
+	},
+	"mg/m³": {
+		dimension: "concentration-mass",
+		factor: 1e3,
+		offset: 0
+	},
+	kg: {
+		dimension: "mass",
+		factor: 1,
+		offset: 0
+	},
+	g: {
+		dimension: "mass",
+		factor: .001,
+		offset: 0
+	},
+	lb: {
+		dimension: "mass",
+		factor: .453592,
+		offset: 0
+	},
+	oz: {
+		dimension: "mass",
+		factor: .0283495,
+		offset: 0
+	},
+	"%": {
+		dimension: "percentage",
+		factor: 1,
+		offset: 0
+	},
+	L: {
+		dimension: "volume",
+		factor: 1,
+		offset: 0
+	},
+	mL: {
+		dimension: "volume",
+		factor: .001,
+		offset: 0
+	},
+	gal: {
+		dimension: "volume",
+		factor: 3.785411784,
+		offset: 0
+	},
+	s: {
+		dimension: "duration",
+		factor: 1,
+		offset: 0
+	},
+	ms: {
+		dimension: "duration",
+		factor: .001,
+		offset: 0
+	},
+	min: {
+		dimension: "duration",
+		factor: 60,
+		offset: 0
+	},
+	h: {
+		dimension: "duration",
+		factor: 3600,
+		offset: 0
+	},
+	d: {
+		dimension: "duration",
+		factor: 86400,
+		offset: 0
+	},
+	B: {
+		dimension: "information",
+		factor: 1,
+		offset: 0
+	},
+	KiB: {
+		dimension: "information",
+		factor: 1024,
+		offset: 0
+	},
+	MiB: {
+		dimension: "information",
+		factor: 1024 ** 2,
+		offset: 0
+	},
+	GiB: {
+		dimension: "information",
+		factor: 1024 ** 3,
+		offset: 0
+	},
+	TiB: {
+		dimension: "information",
+		factor: 1024 ** 4,
+		offset: 0
+	},
+	kB: {
+		dimension: "information",
+		factor: 1e3,
+		offset: 0
+	},
+	MB: {
+		dimension: "information",
+		factor: 1e6,
+		offset: 0
+	},
+	GB: {
+		dimension: "information",
+		factor: 1e9,
+		offset: 0
+	},
+	"°": {
+		dimension: "angle",
+		factor: 1,
+		offset: 0
+	},
+	dBFS: {
+		dimension: "sound-level",
+		factor: 1,
+		offset: 0
+	},
+	dBm: {
+		dimension: "signal-level",
+		factor: 1,
+		offset: 0
+	},
+	mired: {
+		dimension: "colour-temperature",
+		factor: 1,
+		offset: 0
+	},
+	kbps: {
+		dimension: "bitrate",
+		factor: 1,
+		offset: 0
+	},
+	Mbps: {
+		dimension: "bitrate",
+		factor: 1e3,
+		offset: 0
+	},
+	fps: {
+		dimension: "rate",
+		factor: 1,
+		offset: 0
+	}
+};
+/** Resolve a unit's `UnitSpec`, or `undefined` when the spelling is unknown. */
+function specFor(unit) {
+	return Object.hasOwn(UNIT_TABLE, unit) ? UNIT_TABLE[unit] : void 0;
+}
+/** The dimension a unit belongs to, or `undefined` for an unknown unit. */
+function unitDimension(unit) {
+	return specFor(unit)?.dimension;
+}
+/** Value in `spec`'s unit → its dimension's canonical unit. */
+function toCanonical(value, spec) {
+	return value * spec.factor + spec.offset;
+}
+/** Canonical-unit value → the unit described by `spec`. */
+function fromCanonical(canonical, spec) {
+	return (canonical - spec.offset) / spec.factor;
+}
+/**
+* Graceful variant for the render path: returns the converted value, or
+* `undefined` when the conversion is refused (unknown unit / cross-dimension).
+* Never throws — a render caller falls back to the raw value + source unit.
+*/
+function tryConvertUnit(value, from, to) {
+	if (from === to) return value;
+	const fromSpec = specFor(from);
+	if (!fromSpec) return void 0;
+	const toSpec = specFor(to);
+	if (!toSpec) return void 0;
+	if (fromSpec.dimension !== toSpec.dimension) return void 0;
+	return fromCanonical(toCanonical(value, fromSpec), toSpec);
+}
 SOURCE_CAPS.filter((cap) => cap !== "switch" && cap !== "motion");
 DeviceType.Camera, DeviceType.Sensor, DeviceType.Button, DeviceType.Switch, DeviceType.PetFeeder, DeviceType.Container, DeviceType.Thermostat, DeviceType.Camera, DeviceType.Hub, DeviceType.Light, DeviceType.Siren, DeviceType.Switch, DeviceType.Sensor, DeviceType.Thermostat, DeviceType.Climate, DeviceType.Button, DeviceType.EventEmitter, DeviceType.Update, DeviceType.Generic, DeviceType.Notifier, DeviceType.Script, DeviceType.Automation, DeviceType.Lock, DeviceType.Cover, DeviceType.Valve, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.Dishwasher, DeviceType.Camera, DeviceType.Camera, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer, DeviceType.WaterHeater, DeviceType.Humidifier, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.PetFeeder;
 String.raw`rose\(active(\d+), changed(\d+), (\d+(?:\.\d+)?)\)`;
@@ -69739,6 +70564,8 @@ var DEVICE_LOCAL_STATE_CAPS = {
 	featureProbe: featureProbeCapability,
 	flood: floodCapability,
 	gas: gasCapability,
+	groupCommands: groupCommandsCapability,
+	groupStatus: groupStatusCapability,
 	heatingValve: heatingValveCapability,
 	humidifier: humidifierCapability,
 	humiditySensor: humiditySensorCapability,
@@ -71115,6 +71942,13 @@ Object.freeze({
 		access: "view",
 		role: "admin"
 	},
+	"addons.getPackageDocs": {
+		capName: "addons",
+		capScope: "system",
+		addonId: null,
+		access: "view",
+		role: "admin"
+	},
 	"addons.getVersions": {
 		capName: "addons",
 		capScope: "system",
@@ -74223,6 +75057,20 @@ Object.freeze({
 		access: "view",
 		role: "viewer"
 	},
+	"groupCommands.getStatus": {
+		capName: "group-commands",
+		capScope: "device",
+		addonId: null,
+		access: "view",
+		role: "viewer"
+	},
+	"groupStatus.getStatus": {
+		capName: "group-status",
+		capScope: "device",
+		addonId: null,
+		access: "view",
+		role: "viewer"
+	},
 	"heatingValve.getStatus": {
 		capName: "heating-valve",
 		capScope: "device",
@@ -84045,6 +84893,37 @@ var SENSOR_CAP_VOCABULARY = {
 			icon: "flame"
 		}]
 	},
+	"group-commands": {
+		scope: "device",
+		noun: t("Group command", "Comando di gruppo")
+	},
+	"group-status": {
+		scope: "device",
+		noun: t("Group", "Gruppo"),
+		state: [
+			{
+				kind: "numeric",
+				field: "included",
+				quantity: t("the members reporting", "i membri che rispondono"),
+				label: t("Reporting", "Rispondono"),
+				icon: "users"
+			},
+			{
+				kind: "numeric",
+				field: "excluded",
+				quantity: t("the members left out", "i membri esclusi"),
+				label: t("Excluded", "Esclusi"),
+				icon: "users"
+			},
+			{
+				kind: "numeric",
+				field: "total",
+				quantity: t("the member count", "il numero di membri"),
+				label: t("Members", "Membri"),
+				icon: "sigma"
+			}
+		]
+	},
 	"humidity-sensor": {
 		scope: "device",
 		noun: t("Humidity", "Umidità"),
@@ -84078,7 +84957,6 @@ var SENSOR_CAP_VOCABULARY = {
 			field: "value",
 			quantity: t("the reading", "il valore"),
 			label: t("Reading", "Valore"),
-			unitField: "unit",
 			icon: "gauge"
 		}]
 	},
@@ -84214,7 +85092,7 @@ var SENSOR_CAP_VOCABULARY = {
 				field: "temperature",
 				quantity: t("the outdoor temperature", "la temperatura esterna"),
 				label: t("Temperature", "Temperatura"),
-				unitField: "temperatureUnit",
+				unit: "°C",
 				icon: "thermometer"
 			},
 			{
@@ -84230,7 +85108,7 @@ var SENSOR_CAP_VOCABULARY = {
 				field: "windSpeed",
 				quantity: t("the wind speed", "la velocità del vento"),
 				label: t("Wind", "Vento"),
-				unitField: "windSpeedUnit",
+				unit: "m/s",
 				icon: "wind"
 			},
 			{
@@ -84238,7 +85116,7 @@ var SENSOR_CAP_VOCABULARY = {
 				field: "pressure",
 				quantity: t("the air pressure", "la pressione atmosferica"),
 				label: t("Pressure", "Pressione"),
-				unitField: "pressureUnit",
+				unit: "hPa",
 				icon: "gauge"
 			}
 		]
@@ -85511,6 +86389,16 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"groupCommands.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"groupStatus.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"heatingValve.getStatus": [{
 		name: "deviceId",
 		form: "single",
@@ -87495,6 +88383,8 @@ new Map(Object.entries({
 	"detection-blind": "device-events",
 	"motion-noisy": "device-events",
 	"motion-calm": "device-events",
+	"package-llm-silent": "device-events",
+	"package-llm-answered": "device-events",
 	"recording-stalled": "device-events",
 	"recording-healthy": "device-events",
 	"recording-degraded": "device-events",
@@ -87578,6 +88468,12 @@ var NC_SYSTEM_EVENT_KIND_GROUP_SPECS = [
 		label: "Motion without a subject",
 		kinds: ["motion-noisy", "motion-calm"]
 	},
+	{
+		id: "package-llm",
+		family: "device-events",
+		label: "Package confirm",
+		kinds: ["package-llm-silent", "package-llm-answered"]
+	},
 	{
 		id: "recording",
 		family: "device-events",
@@ -87759,6 +88655,8 @@ var DEVICE_EVENTS = [
 	"detection-blind",
 	"motion-noisy",
 	"motion-calm",
+	"package-llm-silent",
+	"package-llm-answered",
 	"recording-stalled",
 	"recording-healthy",
 	"recording-degraded",
@@ -88027,6 +88925,15 @@ new Map([
 		snapshotLabel: "Cameras with constant motion now",
 		snapshotSection: null
 	},
+	{
+		id: "package-llm-confirm",
+		family: "device-events",
+		label: "Package confirm (not answering / answering again)",
+		bad: ["package-llm-silent"],
+		recovery: ["package-llm-answered"],
+		snapshotLabel: "Cameras whose package confirm is not answering",
+		snapshotSection: null
+	},
 	{
 		id: "recording-health",
 		family: "device-events",
@@ -88604,6 +89511,96 @@ DEFAULT_NATIVE_LEASE_SETTINGS.tileBudgetMb;
 DEFAULT_NATIVE_LEASE_SETTINGS.sceneBudgetMb;
 DEFAULT_NATIVE_LEASE_SETTINGS.admission;
 /**
+* Convert an upstream number into the stored base of its quantity (D944 §4).
+* An unknown unit or a unit from another dimension is a refusal: the caller
+* logs it and publishes null (D393). This function never guesses.
+*/
+var DIMENSION_QUANTITY = {
+	temperature: "temperature",
+	pressure: "pressure",
+	speed: "speed",
+	"precipitation-rate": "precipitation-rate",
+	length: "length",
+	area: "area",
+	illuminance: "illuminance",
+	irradiance: "irradiance",
+	power: "power",
+	"apparent-power": "apparent-power",
+	energy: "energy",
+	voltage: "voltage",
+	current: "current",
+	"concentration-volume": "concentration-volume",
+	"concentration-mass": "concentration-mass",
+	mass: "mass",
+	percentage: "percentage",
+	volume: "volume",
+	duration: "duration",
+	information: "information",
+	angle: "angle",
+	"sound-level": "sound-level",
+	"signal-level": "signal-level",
+	"colour-temperature": "colour-temperature",
+	bitrate: "bitrate",
+	rate: "rate"
+};
+/**
+* Quantity implied by a unit symbol. `ppb` and `ms` are the two symbols
+* whose stored base is not the dimension's canonical unit. `mm` is length;
+* precipitation is chosen by the caller (a device class), not by the symbol.
+*/
+function quantityFromUnit(rawUnit) {
+	const unit = normalizeUnit(rawUnit);
+	if (unit === void 0) return void 0;
+	if (unit === "ppb") return "concentration-ppb";
+	if (unit === "ms") return "duration-ms";
+	const dimension = unitDimension(unit);
+	if (dimension === void 0) return void 0;
+	return DIMENSION_QUANTITY[dimension];
+}
+function ingestReading(input) {
+	if (!Number.isFinite(input.value)) return {
+		ok: false,
+		reason: "non-finite"
+	};
+	if (input.quantity === "device") return {
+		ok: false,
+		reason: "unknown-unit"
+	};
+	const raw = input.rawUnit?.trim();
+	if (raw === void 0 || raw.length === 0) return {
+		ok: true,
+		value: input.value
+	};
+	const unit = normalizeUnit(raw);
+	if (unit === void 0) return {
+		ok: false,
+		reason: "unknown-unit"
+	};
+	const base = baseUnitOf(input.quantity);
+	if (base === void 0) {
+		if (unitDimension(unit) !== void 0) return {
+			ok: false,
+			reason: "cross-dimension"
+		};
+		return {
+			ok: false,
+			reason: "unknown-unit"
+		};
+	}
+	const converted = tryConvertUnit(input.value, unit, base);
+	if (converted === void 0) return unitDimension(unit) === void 0 ? {
+		ok: false,
+		reason: "unknown-unit"
+	} : {
+		ok: false,
+		reason: "cross-dimension"
+	};
+	return {
+		ok: true,
+		value: converted
+	};
+}
+/**
 * Pure fuzzy matcher for adoption location import. Normalized
 * case-insensitive Levenshtein similarity, used to reuse an existing
 * CamStack location when an imported source location (e.g. an HA area) is
@@ -114238,11 +115235,7 @@ var hmDiagnosticSchema = hmChildSchema.extend({
 	sourceParams: array(string()).min(1)
 });
 /** Cold-start slices keyed by cap. */
-var COLD_NUMERIC = (unit) => unit !== void 0 ? {
-	value: 0,
-	unit,
-	lastFetchedAt: 0
-} : {
+var COLD_NUMERIC = {
 	value: 0,
 	lastFetchedAt: 0
 };
@@ -114286,7 +115279,7 @@ var HmDiagnosticDevice = class extends HmChildDevice {
 				this.runtimeState.setCapState("temperature-sensor", COLD_TEMP);
 				return;
 			default: {
-				const cold = COLD_NUMERIC(this.unit);
+				const cold = COLD_NUMERIC;
 				this.ctx.registerNativeCap(numericSensorCapability, { getStatus: async () => this.runtimeState.getCapState("numeric-sensor") ?? cold });
 				this.runtimeState.setCapState("numeric-sensor", cold);
 				return;
@@ -114311,22 +115304,55 @@ var HmDiagnosticDevice = class extends HmChildDevice {
 			return;
 		}
 		if (typeof value !== "number") return;
+		const stored = this.toBase(value);
+		if (stored === null) return;
 		if (this.capName === "temperature-sensor") {
 			this.runtimeState.setCapState("temperature-sensor", {
-				celsius: value,
+				celsius: stored,
 				lastFetchedAt: now
 			});
 			return;
 		}
-		const next = this.unit !== void 0 ? {
-			value,
-			unit: this.unit,
+		this.runtimeState.setCapState("numeric-sensor", {
+			value: stored,
 			lastFetchedAt: now
-		} : {
+		});
+	}
+	/** Upstream diagnostic number → the quantity's base. Unknown units publish nothing. */
+	toBase(value) {
+		const quantity = this.readingQuantity();
+		if (quantity === null) {
+			this.warnRefusal("unknown-unit");
+			return null;
+		}
+		const result = ingestReading({
 			value,
-			lastFetchedAt: now
-		};
-		this.runtimeState.setCapState("numeric-sensor", next);
+			rawUnit: this.unit,
+			quantity
+		});
+		if (!result.ok) {
+			this.warnRefusal(result.reason);
+			return null;
+		}
+		if (this.capName === "numeric-sensor" && this.sourceInfo.quantity !== quantity) this.updateSourceInfo({ quantity });
+		return result.value;
+	}
+	readingQuantity() {
+		if (this.capName === "temperature-sensor") return "temperature";
+		if (this.unit === void 0) return "none";
+		const learned = quantityFromUnit(this.unit);
+		if (learned === void 0 || learned === "device") return null;
+		return learned;
+	}
+	warnRefusal(reason) {
+		this.ctx.logger.warn("numeric reading refused", {
+			tags: { deviceId: this.id },
+			meta: {
+				quantity: this.readingQuantity() ?? "device",
+				unit: this.unit ?? "",
+				reason
+			}
+		});
 	}
 };
 //#endregion