@camstack/addon-provider-onvif 1.2.148 → 1.2.150

package/dist/addon.js

@@ -2,7 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region \0rolldown/runtime.js
 var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
 //#endregion
-//#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";
@@ -328,6 +328,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
@@ -5437,7 +5445,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-BErAxhul.mjs
+//#region ../types/dist/sleep--jXS9hWo.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -7924,6 +7932,99 @@ var RecordKindDeclarationSchema = object({
 }).strict();
 /** The kind names: lower-case, dash separated, short enough for an index name. */
 var RecordKindNameSchema = string().regex(/^[a-z][a-z0-9-]{0,47}$/);
+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",
@@ -7951,8 +8052,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. */
@@ -8466,6 +8567,9 @@ var CAP_NAMES = Object.freeze([
 	"filesystem-browse",
 	"flood",
 	"gas",
+	"group-active",
+	"group-commands",
+	"group-status",
 	"heating-valve",
 	"humidifier",
 	"humidity-sensor",
@@ -8486,6 +8590,7 @@ var CAP_NAMES = Object.freeze([
 	"login-method",
 	"media-player",
 	"mesh-network",
+	"meter",
 	"metrics-provider",
 	"model-convert",
 	"model-distributor",
@@ -8595,14 +8700,6 @@ Object.freeze({
 		{
 			"path": "aqi",
 			"valueType": "number"
-		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
 		}
 	],
 	"alarm-panel": [
@@ -8638,20 +8735,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",
@@ -8731,6 +8818,10 @@ Object.freeze({
 			"path": "lastUpdated",
 			"valueType": "number"
 		},
+		{
+			"path": "volts",
+			"valueType": "number"
+		},
 		{
 			"path": "lastContactAt",
 			"valueType": "number"
@@ -8973,10 +9064,6 @@ Object.freeze({
 				"datetime"
 			]
 		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
 		{
 			"path": "min",
 			"valueType": "number"
@@ -8988,19 +9075,6 @@ Object.freeze({
 		{
 			"path": "step",
 			"valueType": "number"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
-		},
-		{
-			"path": "format",
-			"valueType": "enum",
-			"enumValues": [
-				"date",
-				"time",
-				"datetime"
-			]
 		}
 	],
 	"cover": [
@@ -9241,13 +9315,8 @@ Object.freeze({
 		"path": "value",
 		"valueType": "string"
 	}, {
-		"path": "format",
-		"valueType": "enum",
-		"enumValues": [
-			"date",
-			"time",
-			"datetime"
-		]
+		"path": "timestamp",
+		"valueType": "boolean"
 	}],
 	"event-emitter": [
 		{
@@ -9320,6 +9389,24 @@ Object.freeze({
 		"path": "detected",
 		"valueType": "boolean"
 	}],
+	"group-active": [{
+		"path": "active",
+		"valueType": "boolean"
+	}],
+	"group-status": [
+		{
+			"path": "included",
+			"valueType": "number"
+		},
+		{
+			"path": "excluded",
+			"valueType": "number"
+		},
+		{
+			"path": "total",
+			"valueType": "number"
+		}
+	],
 	"heating-valve": [{
 		"path": "position",
 		"valueType": "number"
@@ -9354,20 +9441,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"
@@ -9575,6 +9652,10 @@ Object.freeze({
 			]
 		}
 	],
+	"meter": [{
+		"path": "value",
+		"valueType": "number"
+	}],
 	"motion": [
 		{
 			"path": "detected",
@@ -9706,20 +9787,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",
@@ -9811,14 +9882,6 @@ Object.freeze({
 		{
 			"path": "powerFactor",
 			"valueType": "number"
-		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
 		}
 	],
 	"presence": [
@@ -9847,20 +9910,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"
@@ -10171,20 +10224,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",
@@ -10295,10 +10338,6 @@ Object.freeze({
 			"path": "temperature",
 			"valueType": "number"
 		},
-		{
-			"path": "temperatureUnit",
-			"valueType": "string"
-		},
 		{
 			"path": "humidity",
 			"valueType": "number"
@@ -10307,18 +10346,10 @@ Object.freeze({
 			"path": "pressure",
 			"valueType": "number"
 		},
-		{
-			"path": "pressureUnit",
-			"valueType": "string"
-		},
 		{
 			"path": "windSpeed",
 			"valueType": "number"
 		},
-		{
-			"path": "windSpeedUnit",
-			"valueType": "string"
-		},
 		{
 			"path": "windBearing",
 			"valueType": "number"
@@ -10368,7 +10399,7 @@ object({
 	params: record(string(), union([string(), number()])).optional()
 });
 //#endregion
-//#region ../types/dist/err-msg-BXKzRBwg.mjs
+//#region ../types/dist/err-msg-DIorGYeC.mjs
 var DeviceType = /* @__PURE__ */ function(DeviceType) {
 	DeviceType["Camera"] = "camera";
 	DeviceType["Hub"] = "hub";
@@ -10462,8 +10493,14 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
 	DeviceType["PetFeeder"] = "pet-feeder";
 	/** Built-in dishwasher — program lifecycle, door / remote-start gates,
 	*  salt and rinse-aid levels. Installed with the `dishwasher` cap.
-	*  Sources: native Bosch Home Connect, reusable by similar integrations. */
+	*  Sources: native Bosch Home Connect, reusable by similar integrations.
+	*  A plug-built dishwasher carries running-state and power instead. */
 	DeviceType["Dishwasher"] = "dishwasher";
+	/** Washing machine. A plug-built one is running while its power stays
+	*  above a threshold. No program cap — that surface is the dishwasher's. */
+	DeviceType["Washer"] = "washer";
+	/** Tumble dryer. Same plug-built running surface as {@link Washer}. */
+	DeviceType["Dryer"] = "dryer";
 	return DeviceType;
 }({});
 var DeviceFeature = /* @__PURE__ */ function(DeviceFeature) {
@@ -10721,7 +10758,7 @@ function errMsg(err) {
 	return String(err);
 }
 //#endregion
-//#region ../types/dist/composition-kEl9mevu.mjs
+//#region ../types/dist/composition-Bb8iwHEJ.mjs
 /**
 * The ffmpeg build every CamStack node downloads, per platform and arch.
 *
@@ -11036,6 +11073,13 @@ var table = {
 		apply: () => {
 			throw new ExpressionEvalError("latchedAt: stateful evaluation context is required");
 		}
+	},
+	schmitt: {
+		minArgs: 3,
+		maxArgs: 5,
+		apply: () => {
+			throw new ExpressionEvalError("schmitt: stateful evaluation context is required");
+		}
 	}
 };
 Object.freeze(Object.assign(Object.create(null), table));
@@ -11476,15 +11520,232 @@ 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;
+/**
+* One power reading becomes a washer, dryer or dishwasher (D944 helper).
+*
+* Standby of the control board is under 5 W; a motor or a heater is far
+* above that, so 5 W is the line. A door lock or a short pump spike is not
+* a cycle, so running starts only after 30 s above the line.
+*
+* A wash, dry or dishwasher pause (soak, heat-wait, heater off between
+* bursts) lasts several minutes. Ending the cycle on the first dip would
+* report "finished" in the middle of the program, so the stop dwell is
+* 10 minutes on every type. The number is stored per type so one machine
+* can move later without moving the others.
+*/
+var APPLIANCE_TEMPLATE_ID = "appliance";
+var APPLIANCE_KINDS = [
+	"washer",
+	"dryer",
+	"dishwasher"
+];
+DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher;
+/**
+* Statistics and integrals over a history read (D944).
+*
+* Pure: the same points always give the same answer, so a restart recomputes
+* rather than trusting a buffer. A gauge mean is time-weighted (value × ms),
+* never the mean of the samples. A hole with no held value is not integrated
+* as zero. A truncated read is not published.
+*/
+var STATISTIC_STATS = [
+	"min",
+	"max",
+	"mean",
+	"sum",
+	"count",
+	"change"
+];
+/**
+* The range a statistics or integral helper asks history for (D944).
+*
+* Calendar edges are the hub's timezone, never UTC midnight: a day is 23, 24
+* or 25 hours across a DST change. A tier is eligible only when its retention
+* is strictly longer than the longest that range can be. Forever qualifies.
+* Equal to a tier's retention is a refusal, not a short answer.
+*/
+var MINUTE_MS = 6e4;
+var HOUR_MS = 60 * MINUTE_MS;
+var DAY_MS = 24 * HOUR_MS;
+var ROLLING_SPANS = [
+	"1h",
+	"24h",
+	"2d",
+	"7d",
+	"30d",
+	"custom"
+];
+var CALENDAR_PERIODS = [
+	"today",
+	"yesterday",
+	"this-week",
+	"this-month"
+];
+var RESET_PERIODS = [
+	"never",
+	"daily",
+	"weekly",
+	"monthly"
+];
+5 * MINUTE_MS;
+24 * HOUR_MS, 2 * DAY_MS, 7 * DAY_MS, 30 * DAY_MS;
+7 * DAY_MS, 30 * DAY_MS, 365 * DAY_MS;
+var rollingWindowObject = object({
+	kind: literal("rolling"),
+	span: _enum(ROLLING_SPANS),
+	customMinutes: number().int().min(5).optional()
+}).check((payload) => {
+	if (payload.value.span === "custom" && payload.value.customMinutes === void 0) payload.issues.push({
+		code: "custom",
+		message: "a custom range needs a duration in minutes",
+		path: ["customMinutes"],
+		input: payload.value
+	});
+	if (payload.value.span !== "custom" && payload.value.customMinutes !== void 0) payload.issues.push({
+		code: "custom",
+		message: "only a custom range carries a duration",
+		path: ["customMinutes"],
+		input: payload.value
+	});
+});
+var RollingWindowSchema = rollingWindowObject;
+var StatisticWindowSchema = discriminatedUnion("kind", [rollingWindowObject, object({
+	kind: literal("calendar"),
+	period: _enum(CALENDAR_PERIODS)
+})]);
+/**
+* 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",
+	"fan",
+	"cover",
+	"valve",
+	"lock",
+	"media-player",
+	"climate"
+];
+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()
+	}),
+	object({
+		kind: literal("appliance"),
+		templateId: literal(APPLIANCE_TEMPLATE_ID),
+		appliance: _enum(APPLIANCE_KINDS),
+		thresholdWatts: number().positive(),
+		startDwellMs: number().int().nonnegative(),
+		stopDwellMs: number().int().nonnegative(),
+		member: HelperMemberSchema
+	}),
+	object({
+		kind: literal("statistic"),
+		stat: _enum(STATISTIC_STATS),
+		window: StatisticWindowSchema,
+		source: HelperMemberSchema
+	}),
+	object({
+		kind: literal("integral"),
+		reset: _enum(RESET_PERIODS),
+		output: _enum(["energy", "meter"]),
+		source: HelperMemberSchema
+	}),
+	object({
+		kind: literal("threshold"),
+		source: HelperMemberSchema,
+		high: number(),
+		low: number(),
+		onForMs: number().int().nonnegative(),
+		offForMs: number().int().nonnegative()
+	}),
+	object({
+		kind: literal("arithmetic"),
+		op: _enum([
+			"sum",
+			"difference",
+			"ratio"
+		]),
+		inputs: array(HelperMemberSchema).min(2).max(64)
+	}),
+	object({
+		kind: literal("expression"),
+		expr: string().min(1),
+		inputs: array(object({
+			name: string().min(1),
+			member: HelperMemberSchema
+		})).min(1).max(64),
+		output: _enum(["number", "boolean"])
+	}),
+	object({
+		kind: literal("derivative"),
+		window: RollingWindowSchema,
+		per: _enum([
+			"second",
+			"minute",
+			"hour"
+		]),
+		source: HelperMemberSchema
+	})
+]);
+/** 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,
@@ -11528,7 +11789,59 @@ 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),
+		/**
+		* Set when the reads are an enum state, not a yes/no: the listed states
+		* count as active (a cover is `open`). A state outside the list is inactive;
+		* a read that is not a state at all is left out. Only `any` / `all` use it.
+		*/
+		activeWhen: array(string().min(1)).min(1).optional(),
+		/** `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"
+		])
+	}),
+	object({
+		kind: literal("series"),
+		read: CompositionFieldReadSchema,
+		/** `value` is the statistic or the integral. The others are the gap counts. */
+		publish: _enum([
+			"value",
+			"included",
+			"excluded",
+			"total"
+		]),
+		/**
+		* What an unanswered `value` does. Counts ignore this. `offline` leaves the
+		* device unseeded until history answers, so a restart cannot publish 0.
+		*/
+		empty: _enum([
+			"null",
+			"omit",
+			"offline"
+		])
+	})
 ]);
 var CompositionCommandTargetSchema = discriminatedUnion("kind", [object({
 	kind: literal("forward"),
@@ -11574,7 +11887,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) => {
@@ -16681,7 +17000,22 @@ var BrokerProviderInfoSchema = object({
 		*/
 		interactiveConnectPath: string().min(1).optional(),
 		/** Relative hub path to disconnect the linked account (same popup pattern). */
-		interactiveDisconnectPath: string().min(1).optional()
+		interactiveDisconnectPath: string().min(1).optional(),
+		/**
+		* The kind signs in through a server-held interactive session instead of
+		* (or before) typed credentials. `basePath` is a hub-relative route set
+		* served by the owning addon (`/addon/<id>/...`) speaking the sign-in
+		* contract: `POST {basePath}/start` (body: the form's settings) answers
+		* `{ sessionId, loginUrl }`; `GET {basePath}/status?sessionId=` answers
+		* `{ phase: 'starting' | 'awaiting-login' | 'captured' | 'error' |
+		* 'cancelled', loginUrl, error }`; `POST {basePath}/commit`
+		* (`{ sessionId, name, brokerId? }`) stores the credentials on a new or
+		* existing broker and answers `{ brokerId }`; `POST {basePath}/cancel`
+		* (`{ sessionId }`) drops the session. The dialog that edits a broker
+		* offers it as the default path; the fields the session fills are
+		* marked `filledBySignIn` in the kind's settings schema.
+		*/
+		signIn: object({ basePath: string().min(1) }).optional()
 	}))
 });
 var ListInputSchema = object({ 
@@ -17676,7 +18010,12 @@ var CompositionProblemSchema = object({
 		"item-field-reserved",
 		"target-missing",
 		"target-unreadable",
-		"not-replaceable"
+		"not-replaceable",
+		"native-capability-replace",
+		"mixed-quantity",
+		"helper-mismatch",
+		"member-constraint",
+		"retention"
 	]),
 	path: string(),
 	message: string()
@@ -17697,7 +18036,8 @@ var CompositionUnavailableModeSchema = _enum([
 	"null",
 	"offline",
 	"unknown",
-	"release"
+	"release",
+	"omit"
 ]);
 /**
 * `derived` reads a source · `clock` reads only `now`, recomputed when a sibling
@@ -17734,9 +18074,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",
@@ -17907,8 +18249,392 @@ Object.freeze({
 	latchedAt: {
 		kind: "fixed",
 		result: ["number", "null"]
+	},
+	schmitt: {
+		kind: "fixed",
+		result: ["boolean", "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$2 = {
+	fieldPath: "lastFetchedAt",
+	expr: "now"
+};
+var CHANGED = {
+	fieldPath: "lastChangedAt",
+	expr: "now"
+};
+function numeric(input) {
+	return {
+		...input,
+		family: "numeric",
+		deviceType: DeviceType.Sensor,
+		memberDeviceType: DeviceType.Sensor,
+		memberDeviceTypes: [DeviceType.Sensor],
+		activeWhen: void 0,
+		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,
+		memberDeviceTypes: [DeviceType.Sensor],
+		activeWhen: void 0,
+		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$2]
+	}),
+	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$2]
+	}),
+	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$2]
+	}),
+	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$2]
+	}),
+	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$2]
+	}),
+	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$2]
+	}),
+	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$2]
+	}),
+	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",
+		outputField: "on",
+		member: {
+			cap: "switch",
+			fieldPath: "on"
+		},
+		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",
+		outputField: "on",
+		member: {
+			cap: "switch",
+			fieldPath: "on"
+		},
+		commandCaps: [
+			"switch",
+			"brightness",
+			"color"
+		]
+	}),
+	actuator({
+		id: "fan",
+		summary: "On when at least one fan is on, or when all of them are. Speed, preset, direction and oscillation are offered only when every fan has them. A command is not sent to a fan that lacks it.",
+		deviceType: DeviceType.Fan,
+		outputCap: "switch",
+		outputField: "on",
+		member: {
+			cap: "switch",
+			fieldPath: "on"
+		},
+		commandCaps: ["switch", "fan-control"]
+	}),
+	actuator({
+		id: "cover",
+		summary: "Open when at least one cover is open or part-open, or only when all of them are. Position and tilt are offered only when every cover has them. A cover that reports nothing is left out, never read as closed.",
+		deviceType: DeviceType.Cover,
+		outputCap: "group-active",
+		outputField: "active",
+		member: {
+			cap: "cover",
+			fieldPath: "state"
+		},
+		activeWhen: [
+			"open",
+			"opening",
+			"stopped"
+		],
+		commandCaps: ["cover"]
+	}),
+	actuator({
+		id: "valve",
+		summary: "Open when at least one valve is open or part-open, or only when all of them are. Position is offered only when every valve has it. A valve that reports nothing is left out, never read as closed.",
+		deviceType: DeviceType.Valve,
+		outputCap: "group-active",
+		outputField: "active",
+		member: {
+			cap: "valve",
+			fieldPath: "state"
+		},
+		activeWhen: [
+			"open",
+			"opening",
+			"stopped"
+		],
+		commandCaps: ["valve"]
+	}),
+	actuator({
+		id: "lock",
+		summary: "Locked when at least one lock is locked, or only when all of them are. A jammed or moving lock is not locked. Locking is one tap; unlocking the group needs a confirmation every time, and nothing is sent without it.",
+		deviceType: DeviceType.Lock,
+		outputCap: "group-active",
+		outputField: "active",
+		member: {
+			cap: "lock-control",
+			fieldPath: "state"
+		},
+		activeWhen: ["locked"],
+		commandCaps: ["lock-control"]
+	}),
+	actuator({
+		id: "media-player",
+		summary: "Playing when at least one player is playing, or only when all of them are. Volume is offered only when every player has it. A player that reports nothing is left out, never read as stopped.",
+		deviceType: DeviceType.MediaPlayer,
+		outputCap: "group-active",
+		outputField: "active",
+		member: {
+			cap: "media-player",
+			fieldPath: "state"
+		},
+		activeWhen: ["playing", "buffering"],
+		commandCaps: ["media-player"]
+	}),
+	actuator({
+		id: "climate",
+		summary: "Running when at least one thermostat or air conditioner is not off, or only when all of them are. Target temperature and fan are offered only when every device has them. A device that reports nothing is left out, never read as off.",
+		deviceType: DeviceType.Thermostat,
+		memberDeviceTypes: [DeviceType.Thermostat, DeviceType.Climate],
+		outputCap: "group-active",
+		outputField: "active",
+		member: {
+			cap: "climate-control",
+			fieldPath: "mode"
+		},
+		activeWhen: [
+			"heat",
+			"cool",
+			"auto",
+			"heat_cool",
+			"fan_only",
+			"dry"
+		],
+		commandCaps: ["climate-control"]
+	})
+];
+function actuator(input) {
+	return {
+		id: input.id,
+		summary: input.summary,
+		deviceType: input.deviceType,
+		outputCap: input.outputCap,
+		outputField: input.outputField,
+		commandCaps: input.commandCaps,
+		family: "actuator",
+		role: void 0,
+		memberDeviceType: input.deviceType,
+		memberDeviceTypes: input.memberDeviceTypes ?? [input.deviceType],
+		activeWhen: input.activeWhen,
+		quantity: "none",
+		baseUnit: void 0,
+		aggregates: BINARY_AGGREGATES,
+		defaultAggregate: "any",
+		empty: "offline",
+		accept: [input.member],
+		companions: [CHANGED]
+	};
+}
+new Map(GROUP_TEMPLATES.map((template) => [template.id, template]));
+DeviceFeature.LightColorRgb, DeviceFeature.LightColorHsv, DeviceFeature.LightColorMired;
+DeviceType.Camera;
 `${COMPOSED_DEVICE_STABLE_ID_PREFIX}`;
 /**
 * What a composition may BUILD on a device type (G2, D676): the caps a new
@@ -19735,12 +20461,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`
@@ -19754,6 +20480,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). */
@@ -40747,7 +41481,8 @@ method(object({
 			"enum"
 		]),
 		enumValues: array(string()).optional(),
-		item: boolean().optional()
+		item: boolean().optional(),
+		quantity: ReadingQuantitySchema.optional()
 	})).readonly(),
 	itemArray: object({
 		path: string(),
@@ -43108,7 +43843,7 @@ var NetworkAccessStatusSchema = object({
 });
 /**
 * Optional, richer endpoint shape returned by providers that expose
-* MORE than one ingress concurrently (Tailscale Ingress with mixed
+* MORE than one ingress concurrently (Tailscale Funnel with mixed
 * serve+funnel rules, future ngrok multi-tunnel, …). Each entry carries
 * the originating provider config (mode + sourcePort) so the
 * orchestrator UI can label rows distinctly. Providers that expose only
@@ -44547,8 +45282,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", [
@@ -44660,6 +45395,8 @@ var NcSystemEventKindSchema = _enum([
 	"detection-blind",
 	"motion-noisy",
 	"motion-calm",
+	"package-llm-silent",
+	"package-llm-answered",
 	"recording-stalled",
 	"recording-healthy",
 	"recording-degraded",
@@ -45749,7 +46486,20 @@ var NcRuleInputSchema = object({
 	* save by the hub's grouping guard). `.optional()`, never `.default()`: the addon cap
 	* path does not run Zod defaults.
 	*/
-	groupingSec: number().int().min(5).max(60).optional()
+	groupingSec: number().int().min(5).max(60).optional(),
+	/**
+	* ASK ME TO CONFIRM DETECTIONS (#243): a DETECTION notification of this rule
+	* carries "Correct" / "Wrong" buttons (and, where the channel has room, a
+	* "Wrong, it is a <class>" choice). A tap marks the track for retraining, the
+	* same mark the Library writes, and records whose notification it was and
+	* when. A channel with no buttons gets the same two choices as links.
+	*
+	* `.optional()`, never `.default()` (a Zod default does not run on the addon
+	* cap path): absent and `false` both mean off, which is what every rule
+	* authored before this field meant. An editor turns it off by writing
+	* `false`, so it needs no `clear` key.
+	*/
+	askVerdict: boolean().optional()
 });
 /**
 * Partial patch for `updateRule` — any subset of the input fields, plus the
@@ -55778,6 +56528,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(),
@@ -55996,7 +56768,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) }), {
@@ -56046,46 +56821,27 @@ method(object({ nodeId: string().optional() }).optional(), array(AddonListItemSc
 }), LogStreamEntrySchema, { kind: "subscription" });
 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()
 });
 DeviceType.Sensor;
 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()
 });
 DeviceType.Sensor;
 /**
@@ -56230,10 +56986,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
@@ -56260,7 +57013,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
@@ -56300,7 +57060,7 @@ var BatteryStatusSchema = object({
 	*/
 	binary: boolean().optional().meta({ label: "Binary indicator" })
 });
-DeviceType.Camera, DeviceType.Sensor, DeviceType.Button, DeviceType.Switch, DeviceType.PetFeeder, DeviceType.Container, DeviceType.Thermostat;
+DeviceType.Camera, DeviceType.Sensor, DeviceType.Button, DeviceType.Switch, DeviceType.PetFeeder, DeviceType.Container, DeviceType.Thermostat, DeviceType.EventEmitter;
 method(object({
 	deviceId: number(),
 	/** Bound on the wait. Sensible range 3000–10000ms. */
@@ -56320,7 +57080,7 @@ object({
 DeviceType.Sensor;
 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()
 });
@@ -56705,21 +57465,21 @@ 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(),
@@ -56727,11 +57487,11 @@ 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()
 });
@@ -56810,17 +57570,17 @@ DeviceType.Thermostat, DeviceType.Climate, method(object({
 * 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({
@@ -56849,7 +57609,7 @@ 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()
 });
@@ -56973,18 +57733,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
 });
 var ConsumablesStatusSchema = object({
 	items: array(object({
@@ -56993,7 +57747,7 @@ var ConsumablesStatusSchema = 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`. */
@@ -57010,7 +57764,7 @@ var ConsumablesStatusSchema = object({
 	})),
 	lastChangedAt: number()
 });
-Object.values(DeviceType), [...ConsumableRemainingUnitSchema.options], [...ConsumableStatusSchema.options], [...ConsumableKindSchema.options], [...ConsumableFormSchema.options];
+Object.values(DeviceType), [...ConsumableRemainingKindSchema.options], [...ConsumableStatusSchema.options], [...ConsumableKindSchema.options], [...ConsumableFormSchema.options];
 Object.values(DeviceType), method(object({
 	deviceId: number().int().nonnegative(),
 	key: string().min(1)
@@ -57035,39 +57789,17 @@ 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({
@@ -57105,9 +57837,9 @@ 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()
 });
@@ -57165,9 +57897,9 @@ var NormalizedRangeSchema$1 = object({
 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()
 });
 /**
@@ -57322,11 +58054,11 @@ 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. */
@@ -57350,7 +58082,7 @@ 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(),
@@ -57365,7 +58097,7 @@ 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. */
@@ -57511,24 +58243,14 @@ 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"))
 });
 object({
 	deviceId: number(),
 	timestamp: number()
 });
 DeviceType.Button, DeviceType.Camera;
-/**
-* 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"
@@ -57536,12 +58258,11 @@ var EnumSensorDateTimeFormatSchema = _enum([
 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()
 });
@@ -57560,13 +58281,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"))
 });
 object({
 	eventTypes: array(string()),
 	lastEvent: EventFireSchema.nullable(),
-	eventCountSinceStart: number()
+	eventCountSinceStart: number().meta(readingMeta("count"))
 });
 DeviceType.EventEmitter;
 var IdentitySchema = object({
@@ -57955,10 +58676,10 @@ var FanDirectionSchema = _enum(["forward", "reverse"]);
 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(),
@@ -58040,7 +58761,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
@@ -58072,9 +58793,45 @@ object({
 	lastChangedAt: number()
 });
 DeviceType.Sensor;
+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()
+})) });
+DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Cover, DeviceType.Valve, DeviceType.Lock, DeviceType.MediaPlayer, DeviceType.Thermostat, DeviceType.Climate;
+object({
+	active: boolean().meta({ label: "Active" }),
+	/** Ms epoch when the slice was last updated. */
+	lastChangedAt: number()
+});
+DeviceType.Cover, DeviceType.Valve, DeviceType.Lock, DeviceType.MediaPlayer, DeviceType.Climate, DeviceType.Thermostat;
+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"
+	}))
+});
+DeviceType.Sensor, DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Cover, DeviceType.Valve, DeviceType.Lock, DeviceType.MediaPlayer, DeviceType.Thermostat, DeviceType.Climate;
 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()
 });
@@ -58083,9 +58840,9 @@ 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(),
@@ -58095,9 +58852,9 @@ 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()
 });
@@ -58121,22 +58878,13 @@ DeviceType.Humidifier, method(object({
 	auth: "protected"
 });
 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()
 });
 DeviceType.Sensor, DeviceType.Thermostat;
 object({
@@ -58144,7 +58892,7 @@ 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"))
 });
 DeviceType.Image;
 /**
@@ -58200,19 +58948,19 @@ var NormalizedRangeSchema = object({
 });
 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()
@@ -58457,10 +59205,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. */
@@ -58571,13 +59319,13 @@ 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
@@ -58987,7 +59735,14 @@ DeviceType.Lock, method(object({
 	auth: "protected"
 }), method(object({
 	deviceId: number().int().nonnegative(),
-	code: string().min(1).optional()
+	code: string().min(1).optional(),
+	/**
+	* Honoured by a helper lock GROUP only (D944): unlocking several doors
+	* with one call is refused unless the caller says it was confirmed. A
+	* single lock ignores it. The refusal lives in the callee, so no
+	* automation or API caller reaches the doors by skipping a dialog.
+	*/
+	confirm: boolean().optional()
 }), _void(), {
 	kind: "mutation",
 	auth: "protected"
@@ -58995,6 +59750,11 @@ DeviceType.Lock, method(object({
 	kind: "mutation",
 	auth: "protected"
 });
+object({
+	value: number().nullable().meta(readingMeta("device", { label: "Total" })),
+	lastFetchedAt: number()
+});
+DeviceType.Sensor;
 /**
 * Media-player cap. Models HA `media_player.*` (Sonos, Chromecast,
 * Apple TV, Spotify, Roku, generic OTT receivers, …) on
@@ -59039,7 +59799,7 @@ 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(),
@@ -59052,10 +59812,10 @@ 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(),
@@ -59355,7 +60115,7 @@ 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
@@ -59405,7 +60165,7 @@ var MotionZoneRegionSchema = object({
 });
 object({
 	enabled: boolean(),
-	sensitivity: number(),
+	sensitivity: number().meta(readingMeta("none")),
 	/** Grid region(s). Today exactly one `grid` shape. */
 	regions: array(MotionZoneRegionSchema),
 	lastFetchedAt: number()
@@ -59709,7 +60469,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()
 });
@@ -59755,13 +60515,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"))
 });
 DeviceType.Camera, DeviceType.Sensor, DeviceType.Button, DeviceType.Switch, DeviceType.Light, DeviceType.Lock, DeviceType.Siren, object({
 	deviceId: number(),
@@ -60080,7 +60840,7 @@ 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
@@ -60130,15 +60890,8 @@ DeviceType.Notifier, method(NotifierSendInputSchema, NotifierSendResultSchema, {
 	acceptedAt: number()
 });
 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()
 });
@@ -60428,23 +61181,26 @@ 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).
@@ -60455,7 +61211,7 @@ 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. */
@@ -60465,7 +61221,7 @@ 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()
 });
@@ -60902,38 +61658,37 @@ method(_void(), PlatformCapabilitiesSchema), method(_void(), HardwareInfoSchema)
 });
 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", { label: "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", { label: "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()
 });
-DeviceType.Sensor;
+[
+	DeviceType.Sensor,
+	DeviceType.Switch,
+	DeviceType.Light,
+	DeviceType.Fan,
+	DeviceType.Climate,
+	DeviceType.Thermostat,
+	DeviceType.Humidifier,
+	DeviceType.WaterHeater,
+	DeviceType.MediaPlayer,
+	DeviceType.Washer,
+	DeviceType.Dryer,
+	DeviceType.Dishwasher,
+	DeviceType.Vacuum,
+	DeviceType.LawnMower,
+	DeviceType.PetFeeder
+].filter((type) => type !== DeviceType.Sensor);
 /**
 * Presence cap. Models HA `person.*` and `device_tracker.*` entities
 * on `DeviceType.Presence`. Read-only — no setters: presence is
@@ -60952,11 +61707,11 @@ DeviceType.Sensor;
 */
 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"))
 });
 object({
 	/** `home` / `not_home` / any user-defined zone name. */
@@ -60968,25 +61723,16 @@ 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()
 });
 DeviceType.Presence;
 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()
 });
 DeviceType.Sensor;
 /**
@@ -61411,8 +62157,8 @@ var ptzCapability = {
 };
 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
@@ -61469,7 +62215,7 @@ 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). */
@@ -61481,7 +62227,7 @@ object({
 	phase: string().nullable()
 });
 Object.values(DeviceType);
-DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer, DeviceType.WaterHeater, DeviceType.Humidifier, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.PetFeeder;
+DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer, DeviceType.WaterHeater, DeviceType.Humidifier, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.PetFeeder;
 DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceId: number().int().nonnegative() }), object({ success: literal(true) }), {
 	kind: "mutation",
 	auth: "admin"
@@ -62667,9 +63413,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({
@@ -62738,10 +63484,10 @@ 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),
 	/**
@@ -62757,7 +63503,7 @@ 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.
 	*
@@ -63394,7 +64140,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(),
@@ -63424,18 +64170,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.
 	*
@@ -63520,7 +64266,7 @@ object({
 	/** Ms epoch of the last state change. Useful for UI "X minutes ago". */
 	lastChangedAt: number()
 });
-DeviceType.Switch, DeviceType.Siren, DeviceType.Light, method(object({
+DeviceType.Switch, DeviceType.Siren, DeviceType.Light, DeviceType.Fan, method(object({
 	deviceId: number(),
 	on: boolean()
 }), _void(), {
@@ -64078,23 +64824,13 @@ object({
 });
 DeviceType.Sensor;
 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()
 });
 DeviceType.Sensor, DeviceType.Thermostat;
 /**
@@ -64346,16 +65082,16 @@ 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. */
@@ -64394,7 +65130,7 @@ 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()
 });
@@ -64422,9 +65158,9 @@ object({
 DeviceType.Sensor;
 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. */
@@ -64435,9 +65171,9 @@ 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()
 });
@@ -64461,25 +65197,18 @@ DeviceType.WaterHeater, method(object({
 	auth: "protected"
 });
 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()
 });
@@ -65229,8 +65958,9 @@ method(object({}), array(TrainingBaseModelSchema).readonly(), { auth: "admin" })
 	kind: "mutation",
 	auth: "admin"
 });
+DeviceFeature.FanSpeed, DeviceFeature.FanPreset, DeviceFeature.FanDirection, DeviceFeature.FanOscillating, DeviceFeature.CoverPositionable, DeviceFeature.CoverTilt, DeviceFeature.ValvePositionable, DeviceFeature.MediaPlayerVolume, DeviceFeature.ClimateFanMode;
 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;
+DeviceType.Camera, DeviceType.Sensor, DeviceType.Button, DeviceType.Switch, DeviceType.PetFeeder, DeviceType.Container, DeviceType.Thermostat, DeviceType.EventEmitter, 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.Washer, DeviceType.Dryer, DeviceType.Camera, DeviceType.Camera, DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.PetFeeder, DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.PetFeeder, DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.PetFeeder, DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.PetFeeder, DeviceType.Washer, DeviceType.Dryer, 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+)?)\)`;
 DeviceRole.BinarySensor, DeviceRole.MotionSensor;
 new Set(CAP_NAMES);
@@ -66108,7 +66838,7 @@ var BaseDeviceProvider = class extends BaseAddon {
 		return toDeviceSummary(device, this.addonId);
 	}
 };
-DeviceType.Cover, DeviceType.Valve, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.Camera, DeviceType.Hub, DeviceType.Switch, DeviceType.Siren, DeviceType.Light, DeviceType.Fan, DeviceType.Sensor, DeviceType.Thermostat, DeviceType.Climate, DeviceType.Button, DeviceType.EventEmitter, DeviceType.Update, DeviceType.Generic, DeviceType.Notifier, DeviceType.Script, DeviceType.Automation, DeviceType.Lock, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.Dishwasher;
+DeviceType.Cover, DeviceType.Valve, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.Camera, DeviceType.Hub, DeviceType.Switch, DeviceType.Siren, DeviceType.Light, DeviceType.Fan, DeviceType.Sensor, DeviceType.Thermostat, DeviceType.Climate, DeviceType.Button, DeviceType.EventEmitter, DeviceType.Update, DeviceType.Generic, DeviceType.Notifier, DeviceType.Script, DeviceType.Automation, DeviceType.Lock, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Dryer;
 new Set(Object.values(DeviceType));
 Object.freeze({
 	"accessories.getStatus": {
@@ -66216,6 +66946,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",
@@ -69324,6 +70061,27 @@ Object.freeze({
 		access: "view",
 		role: "viewer"
 	},
+	"groupActive.getStatus": {
+		capName: "group-active",
+		capScope: "device",
+		addonId: null,
+		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",
@@ -70276,6 +71034,13 @@ Object.freeze({
 		access: "create",
 		role: "admin"
 	},
+	"meter.getStatus": {
+		capName: "meter",
+		capScope: "device",
+		addonId: null,
+		access: "view",
+		role: "viewer"
+	},
 	"metricsProvider.collectSnapshot": {
 		capName: "metrics-provider",
 		capScope: "system",
@@ -78374,7 +79139,39 @@ var APPLIANCE_CAP_VOCABULARY = {
 				phrase: t("When {device} finishes", "Quando {device} finisce"),
 				icon: "square"
 			}
-		}
+		},
+		overrides: { byType: {
+			[DeviceType.Washer]: {
+				state: { running: {
+					whenTrue: t("When the washing machine starts", "Quando la lavatrice inizia"),
+					whenFalse: t("When the washing machine has finished", "Quando la lavatrice ha finito")
+				} },
+				events: {
+					onStarted: { phrase: t("When the washing machine starts", "Quando la lavatrice inizia") },
+					onFinished: { phrase: t("When the washing machine has finished", "Quando la lavatrice ha finito") }
+				}
+			},
+			[DeviceType.Dryer]: {
+				state: { running: {
+					whenTrue: t("When the dryer starts", "Quando l'asciugatrice inizia"),
+					whenFalse: t("When the dryer has finished", "Quando l'asciugatrice ha finito")
+				} },
+				events: {
+					onStarted: { phrase: t("When the dryer starts", "Quando l'asciugatrice inizia") },
+					onFinished: { phrase: t("When the dryer has finished", "Quando l'asciugatrice ha finito") }
+				}
+			},
+			[DeviceType.Dishwasher]: {
+				state: { running: {
+					whenTrue: t("When the dishwasher starts", "Quando la lavastoviglie inizia"),
+					whenFalse: t("When the dishwasher has finished", "Quando la lavastoviglie ha finito")
+				} },
+				events: {
+					onStarted: { phrase: t("When the dishwasher starts", "Quando la lavastoviglie inizia") },
+					onFinished: { phrase: t("When the dishwasher has finished", "Quando la lavastoviglie ha finito") }
+				}
+			}
+		} }
 	},
 	update: {
 		scope: "device",
@@ -79146,6 +79943,41 @@ var SENSOR_CAP_VOCABULARY = {
 			icon: "flame"
 		}]
 	},
+	"group-active": {
+		scope: "device",
+		noun: t("Group state", "Stato del gruppo")
+	},
+	"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à"),
@@ -79171,6 +80003,17 @@ var SENSOR_CAP_VOCABULARY = {
 		}],
 		events: { onMotionChanged: { notOperatorFacing: "the `detected` state trigger phrases both edges, from the mirror that survives a dropped event (D49)" } }
 	},
+	meter: {
+		scope: "device",
+		noun: t("Meter", "Contatore"),
+		state: [{
+			kind: "numeric",
+			field: "value",
+			quantity: t("the total", "il totale"),
+			label: t("Total", "Totale"),
+			icon: "gauge"
+		}]
+	},
 	"numeric-sensor": {
 		scope: "device",
 		noun: t("Sensor", "Sensore"),
@@ -79179,7 +80022,6 @@ var SENSOR_CAP_VOCABULARY = {
 			field: "value",
 			quantity: t("the reading", "il valore"),
 			label: t("Reading", "Valore"),
-			unitField: "unit",
 			icon: "gauge"
 		}]
 	},
@@ -79315,7 +80157,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"
 			},
 			{
@@ -79331,7 +80173,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"
 			},
 			{
@@ -79339,7 +80181,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"
 			}
 		]
@@ -79644,8 +80486,47 @@ function projectAction(cap, action) {
 	};
 }
 Object.entries(CAP_VOCABULARY_BY_NAME).flatMap(([cap, entry]) => entry.scope === "device" ? (entry.actions ?? []).map((a) => projectAction(cap, a)) : []);
-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.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.Washer, DeviceType.Dryer;
 DeviceFeature.BatteryOperated;
+DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher;
+var HA_AS = "a power sensor (device_class power). Home Assistant has no laundry domain. running-state stays unexported until a null reading can be published as unavailable.";
+var HOMEKIT_REASON = "HomeKit has no laundry-appliance service. The export tab would pair an accessory with nothing on it: running-state is withheld until a null reading can be unavailable, and power is not a HomeKit service this export honours.";
+var ALEXA_REASON = "Alexa has no laundry category in this export, and neither power nor running has an Alexa interface.";
+var GOOGLE_REASON = "Google WASHER, DRYER and DISHWASHER require RunCycle. A power threshold is not that trait, and this export does not publish RunCycle.";
+var MATTER_REASON = "No Matter export is built. The closest device types are Laundry Washer (0x0073) and Laundry Dryer (0x0074); a power threshold is not the Laundry Washer Mode cluster.";
+function withheld(reason) {
+	return {
+		[DeviceType.Washer]: {
+			exported: false,
+			reason
+		},
+		[DeviceType.Dryer]: {
+			exported: false,
+			reason
+		},
+		[DeviceType.Dishwasher]: {
+			exported: false,
+			reason
+		}
+	};
+}
+function offered(received) {
+	return {
+		[DeviceType.Washer]: {
+			exported: true,
+			as: received
+		},
+		[DeviceType.Dryer]: {
+			exported: true,
+			as: received
+		},
+		[DeviceType.Dishwasher]: {
+			exported: true,
+			as: received
+		}
+	};
+}
+offered(HA_AS), withheld(HOMEKIT_REASON), withheld(ALEXA_REASON), withheld(GOOGLE_REASON), withheld(MATTER_REASON);
 /** Reject after `ms`; always clears its own timer. */
 async function withTimeout$1(promise, ms, label) {
 	let timer;
@@ -80678,6 +81559,21 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"groupActive.getStatus": [{
+		name: "deviceId",
+		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",
@@ -80878,6 +81774,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"meter.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"motion.getStatus": [{
 		name: "deviceId",
 		form: "single",
@@ -82485,7 +83386,6 @@ Object.freeze({
 	"network-access": "ingress",
 	"smtp-provider": "email"
 });
-DeviceType.Camera;
 /**
 * A saved Customize assignment (D936). The schema is the type: callers use
 * `z.infer`, they do not restate the shape.
@@ -82662,6 +83562,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",
@@ -82745,6 +83647,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",
@@ -82926,6 +83834,8 @@ var DEVICE_EVENTS = [
 	"detection-blind",
 	"motion-noisy",
 	"motion-calm",
+	"package-llm-silent",
+	"package-llm-answered",
 	"recording-stalled",
 	"recording-healthy",
 	"recording-degraded",
@@ -83194,6 +84104,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",