@camstack/addon-provider-enpal 0.1.16 → 0.1.18

package/dist/addon.js

@@ -3,7 +3,7 @@ let node_child_process = require("node:child_process");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
 let node_url = require("node:url");
-//#region ../types/dist/event-category-78tcBemo.mjs
+//#region ../types/dist/event-category-Dv-Gcv1f.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -444,6 +444,15 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	*/
 	EventCategory["DeviceStateChanged"] = "device.state-changed";
 	/**
+	* A device COMMAND (a vocabulary action, D920/D983) settled in the hub's
+	* transition audit (D1022): confirmed, already in place, unconfirmed or
+	* failed. Never a device's own change. Payload: `DeviceCommandSettledEvent`
+	* (`{deviceId, action, outcome, actor, at}`, no arguments). It feeds
+	* the Notification Center `device-command` kind. Telemetry (D8): losing one
+	* costs a notification, never state; the audit row is the record.
+	*/
+	EventCategory["DeviceCommandSettled"] = "device.command-settled";
+	/**
 	* The NATIVE shadow of a cap a composition has claimed fields of moved
 	* (D663). Payload: `{ deviceId, capName, native }` — what the provider
 	* wrote, BEFORE the owned fields are overlaid. Owner-only (D224): it is for
@@ -806,7 +815,7 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	return EventCategory;
 }({});
 //#endregion
-//#region ../types/dist/composed-stable-id-jnvhwGoH.mjs
+//#region ../types/dist/composed-stable-id-CPp3votu.mjs
 /**
 import { errMsg } from '@camstack/types'
 * Extract a human-readable message from an unknown error value.
@@ -819,17 +828,18 @@ function errMsg(err) {
 }
 var DeviceType = /* @__PURE__ */ function(DeviceType) {
 	DeviceType["Camera"] = "camera";
+	/** Legacy stored value, read only by the hub-to-integration migrations; no live device carries it. */
 	DeviceType["Hub"] = "hub";
 	DeviceType["Light"] = "light";
 	DeviceType["Siren"] = "siren";
 	DeviceType["Switch"] = "switch";
 	DeviceType["Sensor"] = "sensor";
-	DeviceType["Thermostat"] = "thermostat";
-	/** Air-conditioner / heat-pump climate device (HVAC) — shares the
-	*  `climate-control` cap surface with `Thermostat` but renders a
-	*  dedicated AC-appropriate control UI (mode chips, fan speed,
-	*  independent vertical/horizontal swing). Sources: native Gree, and
-	*  reusable by other AC integrations. */
+	/** Every climate device: an air conditioner, a room thermostat, a radiator
+	*  valve, a floor-heating zone, a heat-pump circuit. They share one set of
+	*  controls (`climate-control`), so they are one type; WHICH kind of climate
+	*  device it is is its {@link DeviceRole} (`climate-*`), which the UI and the
+	*  exports branch on. The retired `thermostat` type is read as this one
+	*  (`canonicalStoredDeviceType`). */
 	DeviceType["Climate"] = "climate";
 	DeviceType["Button"] = "button";
 	/** Generic stateless event emitter — carries a device's EXACT declared
@@ -920,10 +930,6 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
 	/** 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";
-	/** A dumb plug-in stove or heater: a switch (and, with a meter, a power
-	*  reading) that only runs while the plug is on. Built from a smart plug;
-	*  the `timed-run` cap switches it off again after a chosen time. */
-	DeviceType["Heater"] = "heater";
 	/** Tumble dryer. Same plug-built running surface as {@link Washer}. */
 	DeviceType["Dryer"] = "dryer";
 	/** The physical bridge box of a vendor ecosystem (Velux KLF-200, and later
@@ -1143,6 +1149,27 @@ var DeviceRole = /* @__PURE__ */ function(DeviceRole) {
 	/** A smart plug: a `switch` whose source says it is an outlet (HA
 	*  `device_class: outlet`). The Alexa export shows it as a SMARTPLUG. */
 	DeviceRole["Outlet"] = "outlet";
+	/** A dumb plug-in stove or heater behind a switch: it runs only while the
+	*  switch is on. Offered `timed-run`, which switches it off again after a
+	*  chosen time. */
+	DeviceRole["SwitchHeater"] = "switch-heater";
+	/** A plain fan behind a switch (a smart plug powering it): drawn as a fan,
+	*  with the switch's on/off only. Speed or oscillation appear only when the
+	*  device also has a fan cap (D1033). */
+	DeviceRole["SwitchFan"] = "switch-fan";
+	/** Air conditioner / split unit: cooling, fan speed, louvres. */
+	DeviceRole["ClimateAc"] = "climate-ac";
+	/** Room thermostat: a setpoint and a room temperature. The default. */
+	DeviceRole["ClimateThermostat"] = "climate-thermostat";
+	/** Floor-heating zone actuator. */
+	DeviceRole["ClimateFloor"] = "climate-floor";
+	/** Radiator valve (thermostatic radiator head). */
+	DeviceRole["ClimateRadiator"] = "climate-radiator";
+	/** A heater with its own thermostat (stove, convector). */
+	DeviceRole["ClimateHeater"] = "climate-heater";
+	/** One heating/cooling circuit of a heat pump: a water loop with comfort /
+	*  eco setpoints and a heat/cool mode, no room sensor. */
+	DeviceRole["ClimateHeatPumpCircuit"] = "climate-heat-pump-circuit";
 	/** Generic motion / occupancy / moving event source. Distinct from
 	*  the camera accessory PirSensor role: that one is a camera child;
 	*  this is a standalone HA / 3rd-party motion sensor. */
@@ -6030,7 +6057,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-Cw1uUXvl.mjs
+//#region ../types/dist/sleep-Czv-4wFH.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -6713,6 +6740,13 @@ async function runAddonMigrations(host, migrations, logger, options = {}) {
 		else skipped.push(id);
 	};
 	const selected = options.only === void 0 ? null : new Set(options.only);
+	const deferred = /* @__PURE__ */ new Set();
+	const deferredBy = (reason) => {
+		if (selected === null || reason === null) return null;
+		const dep = /^dependency-(?:pending|blocked):(.+)$/.exec(reason)?.[1];
+		if (dep === void 0 || !byId.has(dep)) return null;
+		return !selected.has(dep) || deferred.has(dep) ? dep : null;
+	};
 	for (const step of declaration.steps) {
 		if (selected !== null && !selected.has(step.id)) continue;
 		const bound = byId.get(step.id);
@@ -6724,6 +6758,19 @@ async function runAddonMigrations(host, migrations, logger, options = {}) {
 		try {
 			const gate = await host.startMigration({ id: step.id });
 			if (!gate.proceed) {
+				const waitsFor = deferredBy(gate.reason);
+				if (waitsFor !== null) {
+					log.info("migration deferred: its predecessor runs in another phase of this owner", {
+						tags,
+						meta: {
+							waitsFor,
+							reason: gate.reason
+						}
+					});
+					deferred.add(step.id);
+					skipped.push(step.id);
+					continue;
+				}
 				log.warn("migration not run", {
 					tags,
 					meta: {
@@ -10261,6 +10308,13 @@ var DeviceTransitionSchema = object({
 	actor: TransitionActorSchema,
 	command: TransitionCommandSchema.optional()
 });
+object({
+	deviceId: number$1().int(),
+	action: string(),
+	outcome: TransitionOutcomeSchema,
+	actor: TransitionActorSchema,
+	at: number$1()
+});
 var READING_QUANTITIES = [
 	"temperature",
 	"pressure",
@@ -11807,6 +11861,50 @@ var ACTUATOR_CAP_VOCABULARY = {
 					value: false
 				},
 				args: { oscillating: false }
+			},
+			{
+				id: "fan.horizontalOscillateOn",
+				method: "setOscillationAxis",
+				label: t("Horizontal oscillation on", "Oscillazione orizzontale attiva"),
+				phrase: t("Start the horizontal oscillation of {device}", "Attiva l’oscillazione orizzontale di {device}"),
+				icon: "move-horizontal",
+				args: {
+					axis: "horizontal",
+					oscillating: true
+				}
+			},
+			{
+				id: "fan.horizontalOscillateOff",
+				method: "setOscillationAxis",
+				label: t("Horizontal oscillation off", "Oscillazione orizzontale spenta"),
+				phrase: t("Stop the horizontal oscillation of {device}", "Ferma l’oscillazione orizzontale di {device}"),
+				icon: "move-horizontal",
+				args: {
+					axis: "horizontal",
+					oscillating: false
+				}
+			},
+			{
+				id: "fan.verticalOscillateOn",
+				method: "setOscillationAxis",
+				label: t("Vertical oscillation on", "Oscillazione verticale attiva"),
+				phrase: t("Start the vertical oscillation of {device}", "Attiva l’oscillazione verticale di {device}"),
+				icon: "move-vertical",
+				args: {
+					axis: "vertical",
+					oscillating: true
+				}
+			},
+			{
+				id: "fan.verticalOscillateOff",
+				method: "setOscillationAxis",
+				label: t("Vertical oscillation off", "Oscillazione verticale spenta"),
+				phrase: t("Stop the vertical oscillation of {device}", "Ferma l’oscillazione verticale di {device}"),
+				icon: "move-vertical",
+				args: {
+					axis: "vertical",
+					oscillating: false
+				}
 			}
 		],
 		state: [{
@@ -12240,7 +12338,10 @@ var ACTUATOR_CAP_VOCABULARY = {
 	"ir-transmitter": {
 		scope: "device",
 		noun: t("IR / RF transmitter", "Trasmettitore IR / RF"),
-		notOperatorFacing: { send: "a raw pulse train is not something an operator composes in an automation; the remote that owns the command table sends it" }
+		notOperatorFacing: {
+			send: "a raw pulse train is not something an operator composes in an automation; the remote that owns the command table sends it",
+			learn: "an interactive capture the operator starts from the source dialog and answers by pressing a physical remote; no automation can supply the signal"
+		}
 	},
 	control: {
 		scope: "device",
@@ -13896,10 +13997,6 @@ var CAMERA_CAP_VOCABULARY = {
 		scope: "device",
 		noun: t("Admin link", "Link di amministrazione")
 	},
-	"device-discovery": {
-		scope: "device",
-		noun: t("Discovery", "Rilevamento dispositivi")
-	},
 	"device-extension": {
 		scope: "device",
 		noun: t("Device extension", "Estensione del dispositivo")
@@ -15357,7 +15454,6 @@ var CAP_NAMES = Object.freeze([
 	"device-admin-link",
 	"device-adoption",
 	"device-credentials",
-	"device-discovery",
 	"device-export",
 	"device-extension",
 	"device-history",
@@ -15979,13 +16075,6 @@ Object.freeze({
 			"valueType": "string"
 		}
 	],
-	"device-discovery": [{
-		"path": "lastDiscoveryAt",
-		"valueType": "number"
-	}, {
-		"path": "lastError",
-		"valueType": "string"
-	}],
 	"device-export": [
 		{
 			"path": "linkState",
@@ -16174,6 +16263,10 @@ Object.freeze({
 			"path": "lastEvent.eventType",
 			"valueType": "string"
 		},
+		{
+			"path": "lastEvent.sourceId",
+			"valueType": "string"
+		},
 		{
 			"path": "lastEvent.timestamp",
 			"valueType": "number"
@@ -17437,7 +17530,7 @@ Object.freeze({
 	}
 });
 //#endregion
-//#region ../types/dist/implemented-methods-OitwyO1Y.mjs
+//#region ../types/dist/implemented-methods-5YMDeE3f.mjs
 /**
 * The ffmpeg build every CamStack node downloads, per platform and arch.
 *
@@ -44098,6 +44191,41 @@ function macroOnly(macro) {
 		};
 	}
 }
+var EventVocabularyKindSchema = _enum([
+	"press",
+	"long-press",
+	"long-press-start",
+	"release",
+	"repeat",
+	"double-press",
+	"other"
+]);
+/** The part of the device an event comes from: a button, a channel. */
+var EventVocabularySourceSchema = object({
+	id: string().min(1),
+	label: string().min(1)
+});
+/** One scalar field of an event's `data`, by dotted path. */
+var EventVocabularyFieldSchema = object({
+	path: string().min(1),
+	kind: _enum([
+		"string",
+		"number",
+		"boolean",
+		"enum"
+	]),
+	enumValues: array(string()).optional(),
+	label: string().min(1).optional()
+});
+var EventVocabularyEntrySchema = object({
+	/** The native token, verbatim. */
+	id: string().min(1),
+	source: EventVocabularySourceSchema.optional(),
+	label: string().min(1),
+	description: string().optional(),
+	kind: EventVocabularyKindSchema.optional(),
+	payload: array(EventVocabularyFieldSchema).optional()
+});
 Math.PI / 180;
 /**
 * WHEN something happens, as data (D983) — the one time vocabulary of the
@@ -44150,6 +44278,62 @@ var WeekdayKeySchema = _enum([
 	"sat",
 	"sun"
 ]);
+/**
+* Hold semantics — "for N seconds" on a leaf of the `when` tree (#498).
+*
+* ONE primitive, `for: { ms, mode, tolerance? }`, shared by `device-becomes`,
+* `device-is` and `expression`:
+*
+*  - `held`: the condition stays true for `ms`;
+*  - `stable`: the value does not move by more than `tolerance` (absolute, in
+*    the field's base unit) for `ms` while the condition holds.
+*
+* {@link HoldCore} is the pure state machine (an input observation → a reading).
+* {@link HoldTracker} keys cores by a leaf path for the STATE leaves the tree
+* evaluator judges. {@link BecomesWatch} wraps a core with a timer for the
+* `device-becomes` EVENT leaf: the deadline is armed when the hold starts and
+* cancelled when it breaks, and the leaf fires ONCE per episode.
+*
+* Hold state is memory only. A hold that is already running when the watcher
+* first looks (a restart) is INHERITED: nobody knows when it began, so it never
+* fires for that episode and a state leaf reads it as unknown until the window
+* has elapsed from the moment the watcher started (D49: not-known is not false).
+*/
+var HOLD_MAX_MS = 864e5;
+var HoldModeSchema = _enum(["held", "stable"]);
+var HoldSpecSchema = object({
+	/** How long the condition (or the value) must hold. */
+	ms: number$1().int().min(1).max(HOLD_MAX_MS),
+	mode: HoldModeSchema,
+	/** `stable` only: the largest move of the value that still counts as unchanged (absolute, base unit). */
+	tolerance: number$1().min(0).optional()
+});
+/** What a trace says about a hold. */
+var HoldTraceSchema = object({
+	phase: _enum([
+		"pending",
+		"cancelled",
+		"fired",
+		"reseeded"
+	]),
+	ms: number$1().int(),
+	mode: HoldModeSchema,
+	/** When the hold started (ms epoch). */
+	since: number$1().optional(),
+	/** When it completes (ms epoch), for a pending hold. */
+	deadline: number$1().optional()
+});
+/** The operators a `device-becomes` leaf may carry: a threshold or a range. */
+var BecomesOperatorSchema = _enum([
+	"eq",
+	"ne",
+	"gt",
+	"gte",
+	"lt",
+	"lte",
+	"between",
+	"outside"
+]);
 /** How a state leaf compares a device field to a value. Derived from the
 *  field's `kind` in `deviceManager.getWireableFields`, never hand-maintained. */
 var AutomationConditionOperatorSchema = _enum([
@@ -44163,6 +44347,13 @@ var AutomationConditionOperatorSchema = _enum([
 	"in"
 ]);
 /**
+* The stable name of an event leaf. A path (`when.0.1`) moves when a row is
+* reordered; the id does not, so a `triggered-by` leaf keeps pointing at the
+* same row. Optional: a leaf nothing refers to needs none.
+*/
+var EVENT_LEAF_ID_RE = /^[A-Za-z0-9_-]{1,40}$/;
+var eventLeafId = { id: string().regex(EVENT_LEAF_ID_RE).optional() };
+/**
 * D8 compliance, and it is the reason a "becomes" leaf is not merely an event
 * subscription: it evaluates against the **state mirror**, which is reconciled,
 * and an event only WAKES the evaluation. A dropped event therefore DELAYS a
@@ -44170,24 +44361,60 @@ var AutomationConditionOperatorSchema = _enum([
 */
 var DeviceBecomesLeafSchema = object({
 	kind: literal("device-becomes"),
+	...eventLeafId,
 	deviceId: number$1().int().nonnegative(),
 	cap: string().min(1),
 	fieldPath: string().min(1),
-	/** Fire when the field takes this value. Omit to fire on any change. */
+	/** Fire when the field takes this value. Omit (with no `operator`) to fire on any change. */
 	becomes: union([
 		string(),
 		number$1(),
 		boolean()
 	]).optional(),
-	/** Only on a CHANGE of value, not on every re-report. */
+	/**
+	* A threshold or a range instead of an equality: "crosses above 3000", "enters
+	* 18..24". The leaf fires on the TRANSITION into the predicate, never on a re-report.
+	* `value` is in the field's base unit; `between` / `outside` take `[low, high]`.
+	*/
+	operator: BecomesOperatorSchema.optional(),
+	value: union([
+		number$1(),
+		string(),
+		boolean(),
+		array(number$1()).length(2)
+	]).optional(),
+	/**
+	* Hold: the transition (or, with no predicate, the new value) must stay for
+	* `for.ms` before the leaf fires, ONCE per episode. See `hold.ts`.
+	*/
+	for: HoldSpecSchema.optional(),
+	/** @deprecated every leaf fires on a transition now; read as always on. */
 	edge: boolean().optional(),
-	/** The new value must hold this long before it counts. */
-	forMs: number$1().int().min(0).max(864e5).optional(),
+	/** @deprecated legacy `held` window — read through `holdOf` as `for: { ms, mode: 'held' }`. */
+	forMs: number$1().int().min(0).max(HOLD_MAX_MS).optional(),
 	/** Collapse a burst into one occurrence. */
 	debounceMs: number$1().int().min(0).max(6e5).optional()
+}).superRefine((leaf, ctx) => {
+	if (leaf.becomes !== void 0 && leaf.operator !== void 0) ctx.addIssue({
+		code: "custom",
+		message: "a leaf names `becomes` or `operator`, not both",
+		path: ["operator"]
+	});
+	if (leaf.operator !== void 0 && leaf.value === void 0) ctx.addIssue({
+		code: "custom",
+		message: "an operator needs the value to compare to",
+		path: ["value"]
+	});
+	const range = leaf.operator === "between" || leaf.operator === "outside";
+	if (leaf.operator !== void 0 && range !== Array.isArray(leaf.value)) ctx.addIssue({
+		code: "custom",
+		message: range ? "a range takes [low, high]" : "only a range takes [low, high]",
+		path: ["value"]
+	});
 });
 var DeviceEventLeafSchema = object({
 	kind: literal("device-event"),
+	...eventLeafId,
 	/** An `EventCategory` value. */
 	category: string().min(1),
 	deviceId: number$1().int().nonnegative().optional()
@@ -44200,18 +44427,51 @@ var DeviceEventLeafSchema = object({
 */
 var ScheduleLeafSchema = object({
 	kind: literal("schedule"),
+	...eventLeafId,
 	at: TimeSpecSchema.optional(),
 	days: array(WeekdayKeySchema).min(1).max(7).optional(),
 	/** @deprecated legacy cron — new schedules use `at`. */
 	cron: string().min(1).max(120).optional()
 }).refine((leaf) => leaf.at === void 0 !== (leaf.cron === void 0), { message: "a schedule names exactly one of `at` (a time spec) and `cron` (legacy)" }).refine((leaf) => leaf.days === void 0 || leaf.at !== void 0, { message: "`days` goes with `at`; a cron expression carries its own days" });
-var ManualLeafSchema = object({ kind: literal("manual") });
+/**
+* One payload predicate of a `device-fired` row: the value at `path` inside
+* the fire's `data` (dotted) equals `equals`. Compared strictly, no coercion.
+*/
+var DeviceFiredMatchSchema = object({
+	path: string().min(1).max(120),
+	equals: union([
+		string(),
+		number$1(),
+		boolean()
+	])
+});
+/**
+* "fires": one device of the `event-emitter` capability reported an event
+* (D1045). Every list is an OR, the lists together an AND; an absent list does
+* not narrow. `eventIds` are the device's own tokens, `sourceIds` the parts of
+* the device (a button), `kinds` the shared press kinds of its vocabulary.
+*/
+var DeviceFiredLeafSchema = object({
+	kind: literal("device-fired"),
+	...eventLeafId,
+	deviceId: number$1().int().nonnegative(),
+	eventIds: array(string().min(1)).min(1).max(64).optional(),
+	sourceIds: array(string().min(1)).min(1).max(64).optional(),
+	kinds: array(EventVocabularyKindSchema).min(1).optional(),
+	match: array(DeviceFiredMatchSchema).min(1).max(8).optional()
+});
+var ManualLeafSchema = object({
+	kind: literal("manual"),
+	...eventLeafId
+});
 var IntervalLeafSchema = object({
 	kind: literal("interval"),
+	...eventLeafId,
 	minutes: number$1().int().min(1).max(1440)
 });
 var DetectionLeafSchema = object({
 	kind: literal("detection"),
+	...eventLeafId,
 	/** One macro class each, optionally narrowed by a label; a track of any listed subject fires. */
 	subjects: array(DetectionSubjectSchema).min(1),
 	deviceIds: array(number$1().int().nonnegative()).min(1),
@@ -44222,6 +44482,7 @@ var DetectionLeafSchema = object({
 });
 var StationaryLeafSchema = object({
 	kind: literal("stationary"),
+	...eventLeafId,
 	deviceIds: array(number$1().int().nonnegative()).min(1),
 	subjects: array(StationarySubjectSchema).min(1).optional(),
 	zones: array(string().min(1)).min(1).optional(),
@@ -44249,7 +44510,9 @@ var DeviceIsLeafSchema = object({
 		QuantityValueSchema
 	]),
 	/** The unit the person picked for `value` (display only; `value` is in the base unit). */
-	unit: string().min(1).optional()
+	unit: string().min(1).optional(),
+	/** The comparison must hold (`held`) or the value stay put (`stable`) this long. */
+	for: HoldSpecSchema.optional()
 });
 /**
 * True when the camera currently has a PARKED object matching `subjects` in at
@@ -44265,6 +44528,41 @@ var StationaryPresentLeafSchema = object({
 	minCount: number$1().int().positive().optional()
 });
 /**
+* True while the site-local clock is inside a daily window and/or on one of
+* the named days. `days` names the local day a window STARTS on, so
+* 22:00-06:00 on weekdays is still inside at 01:00 Saturday. A one-date spec
+* (`kind: 'date'`) is refused: only a clock time or a sun event makes a window
+* that repeats every day.
+*/
+var TimeIsLeafSchema = object({
+	kind: literal("time-is"),
+	between: object({
+		from: TimeSpecSchema,
+		to: TimeSpecSchema
+	}).optional(),
+	days: array(WeekdayKeySchema).min(1).max(7).optional()
+}).superRefine((leaf, ctx) => {
+	if (leaf.between === void 0 && leaf.days === void 0) ctx.addIssue({
+		code: "custom",
+		message: "a time-is leaf needs a between window, days, or both"
+	});
+	for (const end of ["from", "to"]) if (leaf.between?.[end].kind === "date") ctx.addIssue({
+		code: "custom",
+		message: "a one-date time cannot bound a daily window: use a clock time or a sun event",
+		path: ["between", end]
+	});
+});
+/**
+* True for the run that one of the named event leaves started. It reads the
+* run, not a device: in the tree it is judged against the leaf that fired, in
+* a step guard against the trigger the run carries. A run no event leaf
+* started (a state-only tree becoming true) is false.
+*/
+var TriggeredByLeafSchema = object({
+	kind: literal("triggered-by"),
+	leafIds: array(string().regex(EVENT_LEAF_ID_RE)).min(1).max(20)
+});
+/**
 * The escape hatch: the bounded expression engine over named device bindings.
 * Declared as a plain object so a discriminated union can read `kind`; the
 * author-time validation is the SAME function `ExpressionSourceSchema` runs.
@@ -44272,7 +44570,9 @@ var StationaryPresentLeafSchema = object({
 var ExpressionLeafSchema = object({
 	kind: literal("expression"),
 	expr: string().min(1).max(MAX_EXPRESSION_SOURCE_LENGTH),
-	bindings: record(string().regex(EXPRESSION_IDENTIFIER_RE), ExpressionBindingSourceSchema)
+	bindings: record(string().regex(EXPRESSION_IDENTIFIER_RE), ExpressionBindingSourceSchema),
+	/** The expression must stay true this long. An expression has no single value, so only `held`. */
+	for: HoldSpecSchema.optional()
 }).superRefine((src, ctx) => {
 	const err = validateExpressionSource(src);
 	if (err !== null) ctx.addIssue({
@@ -44280,6 +44580,11 @@ var ExpressionLeafSchema = object({
 		message: err,
 		path: ["expr"]
 	});
+	if (src.for?.mode === "stable") ctx.addIssue({
+		code: "custom",
+		message: "an expression is held, not stable: it has no single value to keep still",
+		path: ["for", "mode"]
+	});
 });
 var AutomationWhenSchema = lazy(() => discriminatedUnion("kind", [
 	object({
@@ -44296,6 +44601,7 @@ var AutomationWhenSchema = lazy(() => discriminatedUnion("kind", [
 	}),
 	DeviceBecomesLeafSchema,
 	DeviceEventLeafSchema,
+	DeviceFiredLeafSchema,
 	ScheduleLeafSchema,
 	ManualLeafSchema,
 	IntervalLeafSchema,
@@ -44303,11 +44609,14 @@ var AutomationWhenSchema = lazy(() => discriminatedUnion("kind", [
 	StationaryLeafSchema,
 	DeviceIsLeafSchema,
 	StationaryPresentLeafSchema,
-	ExpressionLeafSchema
+	ExpressionLeafSchema,
+	TimeIsLeafSchema,
+	TriggeredByLeafSchema
 ]));
 var EVENT_KINDS = new Set([
 	"device-becomes",
 	"device-event",
+	"device-fired",
 	"schedule",
 	"manual",
 	"interval",
@@ -44357,6 +44666,28 @@ function hasEventLeaves(node) {
 	});
 	return found;
 }
+/** The event leaves of the tree that carry an id, in tree order. */
+function identifiedEventLeaves(when) {
+	const found = [];
+	forEachLeaf(when, (leaf, path) => {
+		if (isEventLeaf(leaf) && leaf.id !== void 0) found.push({
+			id: leaf.id,
+			path,
+			leaf
+		});
+	});
+	return found;
+}
+/** Does the tree hold a `triggered-by` leaf? */
+function hasTriggeredByLeaves(when) {
+	let found = false;
+	forEachLeaf(when, (leaf) => {
+		if (leaf.kind === "triggered-by") found = true;
+	});
+	return found;
+}
+/** Why a `triggered-by` leaf is refused outside an automation: there is no trigger row to name. */
+var TRIGGERED_BY_NEEDS_AUTOMATION = "\"triggered by\" reads which trigger started an automation — an action or a scheduler has no trigger rows, so it could never be true here";
 function hasEmptyContainer(node) {
 	if (isLeaf(node)) return false;
 	if (node.kind === "not") return hasEmptyContainer(node.child);
@@ -44366,6 +44697,7 @@ function hasEmptyContainer(node) {
 var LEAF_WORDS = {
 	"device-becomes": "a device value that becomes",
 	"device-event": "a device event",
+	"device-fired": "a device firing an event",
 	schedule: "a schedule",
 	manual: "a manual run",
 	interval: "an interval",
@@ -44415,6 +44747,11 @@ function validateWhenTree(when) {
 	if (depth > 4) return `the rules nest ${depth} levels deep — the limit is 4. "not (any of …)" is the same as "all of (not …)", which is one level shallower`;
 	const leaves = countWhenLeaves(when);
 	if (leaves > 32) return `the rules use ${leaves} rows — the limit is 32`;
+	const seen = /* @__PURE__ */ new Set();
+	for (const entry of identifiedEventLeaves(when)) {
+		if (seen.has(entry.id)) return `two trigger rows share the id "${entry.id}" — an id names one row`;
+		seen.add(entry.id);
+	}
 	const need = eventNeed(when, "when", false);
 	if ("error" in need) return need.error;
 	const [first, second] = need.paths;
@@ -44626,9 +44963,12 @@ function convertLegacyWhen(half) {
 * every caller — automations, Actions, and the notification centre, which runs
 * only Actions (planning#473).
 */
+/** The longest one `wait` step lasts. It is cut by a restart of the run and does not survive a hub restart. */
+var WAIT_MAX_SECONDS = 3600;
+var WAIT_TOO_LONG = `a wait is at most one hour (${WAIT_MAX_SECONDS} s)`;
 var AutomationWaitStepSchema = object({
 	kind: literal("wait"),
-	seconds: number$1().min(0).max(300)
+	seconds: number$1().min(0).max(WAIT_MAX_SECONDS, WAIT_TOO_LONG)
 });
 /** The legacy `deviceId` of a cap step: still READ, never written (D983). */
 var LegacyStepDeviceSchema = union([
@@ -44698,28 +45038,227 @@ var elseNeedsIf = {
 	path: ["else"]
 };
 var GuardedWaitStepSchema = AutomationWaitStepSchema.extend(stepGuardShape).refine((step) => step.else === void 0 || step.if !== void 0, elseNeedsIf);
-var GuardedCapStepSchema = AutomationCapStepBaseSchema.extend(stepGuardShape).refine((step) => step.target !== void 0 || step.deviceId !== void 0, {
+/**
+* A step of a STANDALONE list (an action, a scheduler point, a preset): the
+* same two step kinds an automation runs, minus a guard that reads the
+* automation's trigger, which such a list does not have.
+*/
+var ActionStepSchema = discriminatedUnion("kind", [GuardedWaitStepSchema, AutomationCapStepBaseSchema.extend(stepGuardShape).refine((step) => step.target !== void 0 || step.deviceId !== void 0, {
+	message: "a cap step needs a target",
+	path: ["target"]
+}).refine((step) => step.target?.kind !== "domain" || step.actionId !== void 0, {
+	message: "a domain target needs the vocabulary action it applies to (actionId)",
+	path: ["actionId"]
+}).refine((step) => step.else === void 0 || step.if !== void 0, elseNeedsIf)]).superRefine((step, ctx) => {
+	if (step.if !== void 0 && hasTriggeredByLeaves(step.if)) ctx.addIssue({
+		code: "custom",
+		message: TRIGGERED_BY_NEEDS_AUTOMATION,
+		path: ["if"]
+	});
+});
+/**
+* Flow control of an AUTOMATION's list (#500). A standalone list (an action, a
+* scheduler point, a preset) stays `wait` and `cap`: it has no run of its own
+* to end and no variable bag to write.
+*/
+var continueOnErrorShape = { 
+/** A failure of this step is traced `failed-continued` and the next step runs. */
+continueOnError: literal(true).optional() };
+/** An automation's cap step: the shared guarded cap step, plus `continueOnError`. */
+var AutomationGuardedCapStepSchema = AutomationCapStepBaseSchema.extend({
+	...stepGuardShape,
+	...continueOnErrorShape
+}).refine((step) => step.target !== void 0 || step.deviceId !== void 0, {
 	message: "a cap step needs a target",
 	path: ["target"]
 }).refine((step) => step.target?.kind !== "domain" || step.actionId !== void 0, {
 	message: "a domain target needs the vocabulary action it applies to (actionId)",
 	path: ["actionId"]
 }).refine((step) => step.else === void 0 || step.if !== void 0, elseNeedsIf);
-var ActionStepSchema = discriminatedUnion("kind", [GuardedWaitStepSchema, GuardedCapStepSchema]);
+/** End the run here, on purpose. `reason` may carry `{{vars.x}}` slots. */
+var AutomationStopStepSchema = object({
+	kind: literal("stop"),
+	reason: string().min(1, "a stop needs a reason: it is what the run trace shows").max(200),
+	/** `ok`: the run ends as a success. `failed`: it ends as a failure, with the reason. */
+	outcome: _enum(["ok", "failed"]),
+	/** Stop only when this reads true; false or unknown does not stop. */
+	if: AutomationWhenSchema.optional()
+});
+var SET_VAR_NAME_RE = /^[A-Za-z_][A-Za-z0-9_]{0,39}$/;
+/** Names the run itself writes and reads (`leaf` is what `triggered-by` judges): a step may not overwrite them. */
+var RESERVED_RUN_VARS = [
+	"kind",
+	"leaf",
+	"at"
+];
+/**
+* Write variables into the run's bag, for the steps after it. SUBSTITUTION
+* only, never evaluation: a text value may carry `{{vars.x}}` slots.
+*/
+var AutomationSetStepSchema = object({
+	kind: literal("set"),
+	vars: record(string(), union([
+		string().max(500),
+		number$1(),
+		boolean()
+	])).refine((vars) => Object.keys(vars).every((name) => SET_VAR_NAME_RE.test(name)), { message: "a variable name is letters, digits and _, not starting with a digit (max 40)" }).refine((vars) => Object.keys(vars).length >= 1, { message: "set needs at least one variable" }).refine((vars) => Object.keys(vars).length <= 20, { message: `set holds at most 20 variables` }).refine((vars) => Object.keys(vars).every((name) => !RESERVED_RUN_VARS.includes(name)), { message: `the names ${RESERVED_RUN_VARS.join(", ")} belong to the run and cannot be set` }),
+	/** Set only when this reads true; false or unknown leaves the bag as it is. */
+	if: AutomationWhenSchema.optional()
+});
+var AutomationRunActionStepSchema = object({
+	kind: literal("action"),
+	/** An entry of the `actions` surface (`internal:<uuid>` or `<addonId>:<localId>`). */
+	actionId: string().min(1),
+	/** Values for the action's declared variables; the others take their default. */
+	variables: record(string(), union([
+		string(),
+		number$1(),
+		boolean()
+	])).optional(),
+	...continueOnErrorShape
+});
+/**
+* A step INSIDE a branch of a `choose`: a flow step with no condition of its
+* own (the branch is the condition) and no block inside it. Strict, so an `if`
+* written on such a step is refused rather than dropped.
+*/
+/** The longest a `wait-until` may wait: six hours. */
+var WAIT_UNTIL_TIMEOUT_MAX_S = 21600;
+/**
+* Pause the run until a condition is true (#500). The timeout is mandatory: a
+* run never waits without an end. `onTimeout` says what a wait that ran out
+* does: `continue` goes on to the next step, `stop` ends the run as a failure.
+* A condition that cannot be read is not "true": the wait goes on (D49).
+*/
+var AutomationWaitUntilStepSchema = object({
+	kind: literal("wait-until"),
+	when: AutomationWhenSchema,
+	timeoutS: number$1().int().min(1, "a wait needs a timeout of at least one second").max(WAIT_UNTIL_TIMEOUT_MAX_S, `a wait for a condition is at most six hours (${WAIT_UNTIL_TIMEOUT_MAX_S} s)`),
+	onTimeout: _enum(["continue", "stop"])
+}).strict();
+/** The step kinds that hold steps of their own, or pause on a condition: they nest two levels at most. */
+var BLOCK_STEP_KINDS = [
+	"choose",
+	"repeat",
+	"parallel",
+	"wait-until"
+];
+var NEST_TOO_DEEP = `steps nest two levels at most: a step inside a nested choose or repeat can be a plain step only`;
+function kindOf(input) {
+	return typeof input === "object" && input !== null ? Reflect.get(input, "kind") : void 0;
+}
+/** Where the nesting ends, a block step is refused in words rather than as an unknown kind. */
+function nestTooDeep(issue) {
+	const kind = kindOf(issue.input);
+	return typeof kind === "string" && BLOCK_STEP_KINDS.includes(kind) ? NEST_TOO_DEEP : void 0;
+}
+var plainStepSchemas = [
+	AutomationWaitStepSchema.strict(),
+	AutomationCapStepBaseSchema.extend(continueOnErrorShape).strict().refine((step) => step.target !== void 0 || step.deviceId !== void 0, {
+		message: "a cap step needs a target",
+		path: ["target"]
+	}).refine((step) => step.target?.kind !== "domain" || step.actionId !== void 0, {
+		message: "a domain target needs the vocabulary action it applies to (actionId)",
+		path: ["actionId"]
+	}),
+	AutomationStopStepSchema.omit({ if: true }).strict(),
+	AutomationSetStepSchema.omit({ if: true }).strict(),
+	AutomationRunActionStepSchema.strict()
+];
+/**
+* A plain step: a flow step with no condition of its own and no step inside
+* it. The second (last) level of nesting holds these only.
+*/
+var AutomationBranchStepSchema = discriminatedUnion("kind", plainStepSchemas, { error: nestTooDeep });
+/** A step that can run beside others: it writes no variable and does not end the run. */
+var AutomationParallelMemberSchema = AutomationBranchStepSchema.refine((step) => step.kind === "cap" || step.kind === "action" || step.kind === "wait", "a parallel holds device commands, actions and waits only: a set or a stop beside other steps has no order");
+/**
+* Several steps at once (#500): all are started together and all are awaited.
+* A failure fails the run once the others finished, as in a sequence; a member
+* marked "continue if this fails" does not.
+*/
+var AutomationParallelStepSchema = object({
+	kind: literal("parallel"),
+	steps: array(AutomationParallelMemberSchema).min(2, "a parallel needs at least two steps").max(5, `a parallel takes at most 5 steps`)
+}).strict();
+var REPEAT_NEEDS_MAX = "a repeat on a condition needs a maximum number of iterations";
+/** A loop on a condition: the bound is mandatory, so a run never loops without an end. */
+var repeatConditionShape = {
+	when: AutomationWhenSchema,
+	maxIterations: number$1({ error: REPEAT_NEEDS_MAX }).int().min(1, REPEAT_NEEDS_MAX).max(50, `a repeat on a condition runs at most 50 times`),
+	/** A pause between two iterations, never after the last. */
+	waitS: number$1().int().min(1).max(WAIT_MAX_SECONDS, WAIT_TOO_LONG).optional()
+};
+/** What decides how many times a `repeat` runs. */
+var AutomationRepeatLoopSchema = discriminatedUnion("by", [
+	object({
+		by: literal("count"),
+		count: number$1().int().min(1).max(20, `a repeat runs at most 20 times`)
+	}).strict(),
+	object({
+		by: literal("while"),
+		...repeatConditionShape
+	}).strict(),
+	object({
+		by: literal("until"),
+		...repeatConditionShape
+	}).strict(),
+	object({
+		by: literal("forEach"),
+		target: object({
+			kind: literal("devices"),
+			ids: array(number$1().int()).min(1, "a repeat over devices needs at least one device").max(50, `a repeat over devices takes at most 50 devices`)
+		}).strict()
+	}).strict()
+]);
+/**
+* The same steps several times (#500). Every form is bounded at save, so a
+* run cannot loop without an end. A failure or a `stop` in the steps ends the
+* loop and the run, as in a sequence.
+*/
+function repeatSchemaOf(step) {
+	return object({
+		kind: literal("repeat"),
+		loop: AutomationRepeatLoopSchema,
+		steps: array(step).min(1, "a repeat needs at least one step").max(10, `a repeat takes at most 10 steps`)
+	}).strict();
+}
+/**
+* One step, several ways (#500): the branches are read in order and the FIRST
+* whose condition is true runs; `else` runs when every branch is false. A
+* branch that cannot be read ends the choice: nothing runs, not the branches
+* after it and not the else (D49). The #472 `if` / `else` of a wait or cap
+* step is the one-branch case and stays as it is stored.
+*/
+function chooseSchemaOf(step) {
+	const steps = array(step).max(10);
+	return object({
+		kind: literal("choose"),
+		branches: array(object({
+			if: AutomationWhenSchema,
+			steps: steps.min(1, "a branch needs at least one step")
+		})).min(1, "a choose needs at least one branch").max(6, `a choose takes at most 6 branches`),
+		else: steps.optional()
+	});
+}
+var AutomationBodyStepSchema = discriminatedUnion("kind", [
+	...plainStepSchemas,
+	AutomationWaitUntilStepSchema,
+	AutomationParallelStepSchema,
+	chooseSchemaOf(AutomationBranchStepSchema),
+	repeatSchemaOf(AutomationBranchStepSchema)
+]);
+var AutomationRepeatStepSchema = repeatSchemaOf(AutomationBodyStepSchema);
 var AutomationActionSchema = discriminatedUnion("kind", [
 	GuardedWaitStepSchema,
-	GuardedCapStepSchema,
-	object({
-		kind: literal("action"),
-		/** An entry of the `actions` surface (`internal:<uuid>` or `<addonId>:<localId>`). */
-		actionId: string().min(1),
-		/** Values for the action's declared variables; the others take their default. */
-		variables: record(string(), union([
-			string(),
-			number$1(),
-			boolean()
-		])).optional()
-	}),
+	AutomationGuardedCapStepSchema,
+	AutomationStopStepSchema,
+	AutomationSetStepSchema,
+	chooseSchemaOf(AutomationBodyStepSchema),
+	AutomationWaitUntilStepSchema,
+	AutomationParallelStepSchema,
+	AutomationRepeatStepSchema,
+	AutomationRunActionStepSchema,
 	object({
 		kind: literal("code"),
 		/** Compiled into the automation's OWN block by esbuild — not a third
@@ -44782,11 +45321,6 @@ function convertLegacyRecipe(legacy) {
 		...rest
 	};
 }
-/**
-* Where recipes are PARSED (the core-blocks cap, the MCP tool, the literal a
-* saved block carries): the new shape as it is, or the old shape converted to
-* it. The output type is always the new one.
-*/
 var AutomationRecipeSchema = union([CurrentAutomationRecipeSchema, LegacyAutomationRecipeSchema.transform(convertLegacyRecipe)]);
 var DETECTION_DESCRIPTIONS = {
 	deviceId: "the camera that saw it",
@@ -44802,6 +45336,21 @@ var STATIONARY_DESCRIPTIONS = {
 	phase: "appeared or departed",
 	entryId: "the stopped object"
 };
+var BECOMES_DESCRIPTIONS = {
+	deviceId: "the device that changed",
+	from: "the value before the change, empty when it is not known",
+	to: "the value it changed to"
+};
+/**
+* A fire's payload is offered too, as `data.<path>` (`{{vars.data.channel}}`):
+* those names depend on the device, so they are not in this list.
+*/
+var FIRED_DESCRIPTIONS = {
+	deviceId: "the device that fired",
+	eventType: "the event, as the device names it",
+	sourceId: "the part of the device that fired (a button), empty when it names none",
+	eventKind: "the kind of press (press, long-press …), empty when the device declares none"
+};
 function describe$1(descriptions) {
 	return Object.entries(descriptions).map(([name, description]) => ({
 		name,
@@ -44810,8 +45359,74 @@ function describe$1(descriptions) {
 }
 describe$1(DETECTION_DESCRIPTIONS);
 describe$1(STATIONARY_DESCRIPTIONS);
+describe$1(FIRED_DESCRIPTIONS).map((v) => v.name === "deviceId" ? {
+	...v,
+	hintKey: "firedDeviceId"
+} : v);
+describe$1(BECOMES_DESCRIPTIONS).map((v) => v.name === "deviceId" ? {
+	...v,
+	hintKey: "becomesDeviceId"
+} : v);
 new Set(Object.values(COCO_TO_MACRO.mapping));
 /**
+* Generic stateless event emitter. Installed on a `DeviceType.EventEmitter`
+* device. Carries the device's EXACT declared event vocabulary verbatim
+* (NO normalization). Two shapes:
+*  - structured source (HA `event.*` entity) → `vocabulary` is the fixed
+*    declared set (e.g. press_short, press_long, …).
+*  - generic/legacy source (HA bus events, e.g. zha_event) → `vocabulary`
+*    is [] (open) and `lastEvent.data` carries the complex payload.
+* `vocabulary` (D1044) names each event for a person and types it for a
+* rule; `eventTypes` is its list of native tokens, kept for older readers.
+* A fire names the part of the device it came from in `sourceId` when the
+* vocabulary declares sources (a remote's buttons).
+* `seq` is monotonic so two identical events still produce distinct slice writes.
+*/
+var EventFireSchema = object({
+	deviceId: number$1(),
+	eventType: string(),
+	sourceId: string().optional(),
+	data: record(string(), unknown()).nullable(),
+	timestamp: number$1().meta(readingMeta("none")),
+	seq: number$1().meta(readingMeta("count"))
+});
+var EventEmitterStatusSchema = object({
+	eventTypes: array(string()),
+	/**
+	* Required of a provider by the type. A status written before the field
+	* existed still parses, as an empty vocabulary: read it through
+	* `readEventVocabulary`, which then answers with the plain tokens.
+	*/
+	vocabulary: array(EventVocabularyEntrySchema).default([]),
+	lastEvent: EventFireSchema.nullable(),
+	eventCountSinceStart: number$1().meta(readingMeta("count"))
+});
+var eventEmitterCapability = {
+	name: "event-emitter",
+	scope: "device",
+	deviceNative: true,
+	mode: "singleton",
+	deviceTypes: [DeviceType.EventEmitter],
+	methods: {},
+	events: { onEvent: { data: EventFireSchema } },
+	status: {
+		schema: EventEmitterStatusSchema,
+		kind: "push"
+	},
+	runtimeState: EventEmitterStatusSchema,
+	/**
+	* Runtime-state durability: **session** — `eventCountSinceStart` names its own scope.
+	*
+	* See `RuntimeStateDurability`. Enforced by
+	* `scripts/check-runtime-state-durability.ts`.
+	*/
+	durability: "session",
+	/**
+	* History (D850): none — `eventCountSinceStart` resets with the addon; events live in ledgers.
+	*/
+	history: "none"
+};
+/**
 * Schedulers (D983) — an entity that performs actions over the day.
 *
 * A scheduler has profiles; a profile has weekdays and a timeline of POINTS.
@@ -44834,6 +45449,13 @@ var SchedulerStateTreeSchema = AutomationWhenSchema.superRefine((when, ctx) => {
 		});
 		return;
 	}
+	if (hasTriggeredByLeaves(when)) {
+		ctx.addIssue({
+			code: "custom",
+			message: TRIGGERED_BY_NEEDS_AUTOMATION
+		});
+		return;
+	}
 	const problem = validateWhenTree(when);
 	if (problem !== null) ctx.addIssue({
 		code: "custom",
@@ -44855,12 +45477,16 @@ var HoldOverrideSchema = discriminatedUnion("mode", [object({ mode: literal("res
 })]);
 /** A missed edge up to this late still runs. */
 var DEFAULT_MAX_LATE_MS = 10 * 6e4;
+var SchedulerStepSchema = ActionStepSchema.refine((step) => step.kind !== "wait" || step.seconds <= 300, {
+	message: `a scheduler point waits at most five minutes (300 s); put a longer wait in an action`,
+	path: ["seconds"]
+});
 var SchedulerPointSchema = object({
 	id: string().min(1).max(64),
 	at: SchedulerTimeSpecSchema,
 	mode: SchedulerPointModeSchema,
 	/** The actions of an `edge` or `hold`; a `release` has none. */
-	steps: array(ActionStepSchema).max(20).default([]),
+	steps: array(SchedulerStepSchema).max(20).default([]),
 	/** Checked when the point runs (an edge) or is applied (a hold). */
 	conditions: SchedulerStateTreeSchema.optional(),
 	/** Hold only; absent means `respect`. */
@@ -45039,7 +45665,9 @@ var AutomationTriggerTraceSchema = object({
 	/** Why an event was rejected ("class person not in [dog]") or what fired. */
 	reason: string(),
 	/** deviceId, className, trackId, score … — only what the trigger exposes. */
-	vars: record(string(), TraceValueSchema)
+	vars: record(string(), TraceValueSchema),
+	/** A hold (`for`) this occurrence went through: pending, cancelled, fired or re-seeded. */
+	hold: HoldTraceSchema.optional()
 });
 var AutomationConditionTraceNodeSchema = object({
 	/** `when` for the root, `when.<i>` for its i-th child, … (`conditions…` on an old trace). */
@@ -45052,8 +45680,11 @@ var AutomationConditionTraceNodeSchema = object({
 		"device-is",
 		"expression",
 		"stationary-present",
+		"time-is",
+		"triggered-by",
 		"device-becomes",
 		"device-event",
+		"device-fired",
 		"schedule",
 		"interval",
 		"manual",
@@ -45124,18 +45755,46 @@ var StepTraceBaseSchema = object({
 	]).optional(),
 	/** Why the condition read what it read, in the evaluator's own words. */
 	conditionReason: string().optional(),
-	/** `empty`: the target resolved to no device, so nothing was done — never silently `ok`. `skipped`: its `if` was false (or unknown) and nothing ran in its place. */
+	/** `empty`: the target resolved to no device, so nothing was done — never silently `ok`. `skipped`: its `if` was false (or unknown) and nothing ran in its place. `failed-continued`: it failed and was marked to be passed over (#500). */
 	outcome: _enum([
 		"ok",
 		"error",
 		"not-run",
 		"empty",
-		"skipped"
+		"skipped",
+		"failed-continued",
+		"timed-out"
 	]),
 	message: string().optional()
 });
+/** What a block step adds to its row: which list ran, what each branch read, how many rounds. */
+var blockTraceShape = {
+	/** A `choose` step (#500): the list that ran, `branches.<n>` or `else`. Absent when none did. */
+	branch: string().optional(),
+	/** A `choose` step: what each branch read, in order, up to the one that decided. */
+	branchChecks: array(object({
+		condition: _enum([
+			"true",
+			"false",
+			"unknown"
+		]),
+		conditionReason: string().optional()
+	})).optional(),
+	/** A `repeat` step (#500): how many times its steps ran. */
+	iterations: number$1().int().optional()
+};
+/** A step one level down: it may be a block step itself, whose own steps are plain rows (the nesting ends there). */
+var NestedStepTraceSchema = StepTraceBaseSchema.extend({
+	...blockTraceShape,
+	steps: array(StepTraceBaseSchema).optional()
+});
 /** A step trace; the `else` steps that ran are one level of the same shape (the nesting is bounded at one). */
-var AutomationStepTraceSchema = StepTraceBaseSchema.extend({ else: array(StepTraceBaseSchema).optional() });
+var AutomationStepTraceSchema = StepTraceBaseSchema.extend({
+	else: array(StepTraceBaseSchema).optional(),
+	...blockTraceShape,
+	/** A `choose` step: the steps of the list that ran. A `parallel`: its members. A `repeat`: the LAST iteration. */
+	steps: array(NestedStepTraceSchema).optional()
+});
 var AutomationRunTraceSchema = object({
 	runId: string().min(1),
 	startedAt: number$1(),
@@ -45385,7 +46044,7 @@ object({
 	*  is irrelevant; the array is treated as a set by consumers. */
 	hiddenChildIds: array(number$1()).readonly()
 });
-DeviceType.Camera, DeviceType.Hub, DeviceType.Switch, DeviceType.Light, DeviceType.Sensor, DeviceType.Thermostat, DeviceType.Cover, DeviceType.Lock, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Generic, method(object({
+DeviceType.Camera, DeviceType.Switch, DeviceType.Light, DeviceType.Sensor, DeviceType.Climate, DeviceType.Cover, DeviceType.Lock, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Generic, method(object({
 	deviceId: number$1().int().nonnegative(),
 	childDeviceId: number$1().int().nonnegative(),
 	hidden: boolean()
@@ -45542,7 +46201,9 @@ var AddonHttpRouteSchema = object({
 	]).optional(),
 	description: string().optional(),
 	/** The hub limits this route per client address before the handler runs. */
-	rateLimit: _enum(["auth"]).optional()
+	rateLimit: _enum(["auth"]).optional(),
+	/** Served once per integration instance; the handler reads `instanceId`. */
+	perInstance: boolean().optional()
 });
 /**
 * Cross-process route invocation envelope. The hub captures the
@@ -45559,6 +46220,8 @@ var InvokeRequestSchema = object({
 	query: record(string(), string()),
 	body: unknown(),
 	headers: record(string(), string()),
+	/** The instance the hub resolved for a `perInstance` route. */
+	instanceId: string().optional(),
 	user: object({
 		id: string(),
 		username: string(),
@@ -47683,7 +48346,7 @@ var BATTERY_DEVICE_TYPES = [
 	DeviceType.Switch,
 	DeviceType.PetFeeder,
 	DeviceType.Container,
-	DeviceType.Thermostat,
+	DeviceType.Climate,
 	DeviceType.EventEmitter
 ];
 /** Generic Customize target for the percentage reading (D936). */
@@ -49446,7 +50109,14 @@ var climateControlCapability = {
 	scope: "device",
 	deviceNative: true,
 	mode: "singleton",
-	deviceTypes: [DeviceType.Thermostat, DeviceType.Climate],
+	deviceTypes: [DeviceType.Climate],
+	power: {
+		kind: "mode",
+		field: "mode",
+		offValue: "off",
+		set: "setMode",
+		lastField: "lastActiveMode"
+	},
 	methods: {
 		setMode: method(object({
 			deviceId: number$1().int().nonnegative(),
@@ -49831,6 +50501,7 @@ var CompositionProblemSchema = object({
 		"nested-field",
 		"missing-field",
 		"kind-mismatch",
+		"source-kind-mismatch",
 		"may-be-null",
 		"source-missing",
 		"source-unreadable",
@@ -49852,7 +50523,8 @@ var CompositionProblemSchema = object({
 		"command-method-unknown",
 		"command-source-unknown",
 		"command-input-unknown",
-		"command-input-missing"
+		"command-input-missing",
+		"power-source-is-actuator"
 	]),
 	path: string(),
 	message: string()
@@ -50534,11 +51206,13 @@ var IrCodecError = class extends Error {
 		this.code = code;
 	}
 };
+/** Maximum number of mark/space entries one pulse train may carry. */
+var IR_TIMINGS_MAX = 1024;
 /**
 * A pulse train in signed microseconds: mark (+) first, then space (-), strictly
 * alternating, no zeros, 2..1024 entries.
 */
-var IrTimingsSchema = array(number$1().int()).min(2).max(1024).superRefine((timings, ctx) => {
+var IrTimingsSchema = array(number$1().int()).min(2).max(IR_TIMINGS_MAX).superRefine((timings, ctx) => {
 	timings.forEach((value, index) => {
 		const expectMark = index % 2 === 0;
 		if (value === 0 || value > 0 !== expectMark) ctx.addIssue({
@@ -50585,15 +51259,186 @@ function decodePronto(code) {
 		carrierHz: Math.round(1e6 / unitUs)
 	};
 }
-/** What a remote command stores: a raw pulse train, or a learned Pronto code. */
-var IrPayloadSchema = discriminatedUnion("kind", [object({
-	kind: literal("raw"),
-	timings: array(number$1().int()),
-	settings: TransmitSettingsSchema.optional()
-}), object({
-	kind: literal("pronto"),
-	code: string()
-})]);
+/**
+* FastLZ level 1: a byte-oriented LZ77 stream. A control byte below 32 starts a
+* literal run of `ctrl + 1` bytes; otherwise it is a back-reference whose length
+* is `ctrl >> 5` (extended by one byte when 7) and whose distance is split
+* between the low 5 bits and the next byte.
+*/
+var MAX_DISTANCE = 8192;
+var MAX_LITERAL_RUN = 32;
+var MIN_MATCH = 3;
+var MAX_MATCH = 264;
+/**
+* Most bytes a decoded IR code may hold: two bytes per timing. A level-1 stream
+* can expand ~130x, so the decoder checks this bound before every write.
+*/
+var IR_DECOMPRESSED_MAX = IR_TIMINGS_MAX * 2;
+function fastlzDecompress(input) {
+	const out = [];
+	let ip = 0;
+	const room = (count) => {
+		if (out.length + count > IR_DECOMPRESSED_MAX) throw new IrCodecError("tuya-malformed", "decompressed code is larger than any IR train");
+	};
+	const next = () => {
+		const byte = input[ip++];
+		if (byte === void 0) throw new IrCodecError("tuya-malformed", "compressed stream is truncated");
+		return byte;
+	};
+	while (ip < input.length) {
+		const ctrl = next();
+		if (ctrl < 32) {
+			room(ctrl + 1);
+			for (let i = 0; i <= ctrl; i++) out.push(next());
+			continue;
+		}
+		let len = (ctrl >> 5) - 1;
+		if (len === 6) len += next();
+		const distance = ((ctrl & 31) << 8) + next() + 1;
+		const start = out.length - distance;
+		if (start < 0) throw new IrCodecError("tuya-malformed", "back-reference points before the stream");
+		room(len + 3);
+		for (let i = 0; i < len + 3; i++) {
+			const byte = out[start + i];
+			if (byte === void 0) throw new IrCodecError("tuya-malformed", "back-reference is invalid");
+			out.push(byte);
+		}
+	}
+	return Uint8Array.from(out);
+}
+function fastlzCompress(input) {
+	const out = [];
+	const lastSeen = /* @__PURE__ */ new Map();
+	let literalStart = 0;
+	const flushLiterals = (end) => {
+		for (let from = literalStart; from < end; from += MAX_LITERAL_RUN) {
+			const to = Math.min(from + MAX_LITERAL_RUN, end);
+			out.push(to - from - 1);
+			for (let i = from; i < to; i++) out.push(input[i] ?? 0);
+		}
+	};
+	let pos = 0;
+	while (pos < input.length) {
+		let matchLen = 0;
+		let matchDistance = 0;
+		if (pos + MIN_MATCH <= input.length) {
+			const key = (input[pos] ?? 0) << 16 | (input[pos + 1] ?? 0) << 8 | (input[pos + 2] ?? 0);
+			const candidate = lastSeen.get(key);
+			lastSeen.set(key, pos);
+			if (candidate !== void 0 && pos - candidate <= MAX_DISTANCE) {
+				let len = 0;
+				while (pos + len < input.length && len < MAX_MATCH && input[candidate + len] === input[pos + len]) len++;
+				if (len >= MIN_MATCH) {
+					matchLen = len;
+					matchDistance = pos - candidate - 1;
+				}
+			}
+		}
+		if (matchLen === 0) {
+			pos++;
+			continue;
+		}
+		flushLiterals(pos);
+		const enc = matchLen - 2;
+		if (enc < 7) out.push(enc << 5 | matchDistance >> 8);
+		else out.push(224 | matchDistance >> 8, enc - 7);
+		out.push(matchDistance & 255);
+		pos += matchLen;
+		literalStart = pos;
+	}
+	flushLiterals(input.length);
+	return Uint8Array.from(out);
+}
+var ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+var MAX_DURATION_US = 65535;
+function toBase64(bytes) {
+	let out = "";
+	for (let i = 0; i < bytes.length; i += 3) {
+		const a = bytes[i] ?? 0;
+		const b = bytes[i + 1] ?? 0;
+		const c = bytes[i + 2] ?? 0;
+		const word = a << 16 | b << 8 | c;
+		out += ALPHABET[word >> 18 & 63];
+		out += ALPHABET[word >> 12 & 63];
+		out += i + 1 < bytes.length ? ALPHABET[word >> 6 & 63] : "=";
+		out += i + 2 < bytes.length ? ALPHABET[word & 63] : "=";
+	}
+	return out;
+}
+function fromBase64(text) {
+	const clean = text.trim().replace(/=+$/, "");
+	if (clean.length === 0 || clean.length % 4 === 1) throw new IrCodecError("tuya-malformed", "not a base64 string");
+	const out = [];
+	let bits = 0;
+	let acc = 0;
+	for (const ch of clean) {
+		const value = ALPHABET.indexOf(ch);
+		if (value < 0) throw new IrCodecError("tuya-malformed", "not a base64 string");
+		acc = acc << 6 | value;
+		bits += 6;
+		if (bits >= 8) {
+			bits -= 8;
+			out.push(acc >> bits & 255);
+		}
+	}
+	return Uint8Array.from(out);
+}
+/** Signed pulse train to a Tuya IR code: base64(FastLZ(uint16 LE durations)). */
+function encodeTuya(timings) {
+	const bytes = new Uint8Array(timings.length * 2);
+	timings.forEach((value, index) => {
+		const duration = Math.abs(value);
+		if (duration === 0 || duration > MAX_DURATION_US) throw new IrCodecError("invalid-timings", `timing ${index} does not fit 16 bits`);
+		bytes[index * 2] = duration & 255;
+		bytes[index * 2 + 1] = duration >> 8;
+	});
+	return toBase64(fastlzCompress(bytes));
+}
+/** A Tuya IR code to a signed pulse train (mark first). Throws `IrCodecError`. */
+function decodeTuya(code) {
+	const bytes = fastlzDecompress(fromBase64(code));
+	if (bytes.length === 0 || bytes.length % 2 !== 0) throw new IrCodecError("tuya-malformed", "payload is not a list of 16-bit durations");
+	const timings = [];
+	for (let i = 0; i < bytes.length; i += 2) {
+		const duration = (bytes[i] ?? 0) | (bytes[i + 1] ?? 0) << 8;
+		timings.push(i / 2 % 2 === 0 ? duration : -duration);
+	}
+	const checked = IrTimingsSchema.safeParse(timings);
+	if (!checked.success) throw new IrCodecError("tuya-malformed", checked.error.message);
+	return checked.data;
+}
+/** Device-native IR code formats a transmitter can replay verbatim. */
+var IrNativeFormatSchema = _enum(["tuya"]);
+/**
+* Longest native code accepted: base64 of the worst-case compressed stream
+* (every decoded byte as a literal, plus one control byte per 32), with margin.
+*/
+var IR_NATIVE_CODE_MAX_CHARS = Math.ceil((IR_DECOMPRESSED_MAX + Math.ceil(IR_DECOMPRESSED_MAX / 32)) / 3) * 4 + 256;
+var IrNativeCodeSchema = object({
+	format: IrNativeFormatSchema,
+	code: string().min(1).max(IR_NATIVE_CODE_MAX_CHARS)
+});
+var IR_NATIVE_CODECS = { tuya: {
+	encode: encodeTuya,
+	decode: decodeTuya
+} };
+/** What a remote command stores: a raw pulse train, a learned Pronto code, or a device-native code. */
+var IrPayloadSchema = discriminatedUnion("kind", [
+	object({
+		kind: literal("raw"),
+		timings: array(number$1().int()),
+		settings: TransmitSettingsSchema.optional()
+	}),
+	object({
+		kind: literal("pronto"),
+		code: string()
+	}),
+	object({
+		kind: literal("native"),
+		format: IrNativeFormatSchema,
+		code: string()
+	})
+]);
 /** Resolve a payload to what `ir-transmitter.send` takes. Throws `IrCodecError`. */
 function toTimings(payload) {
 	if (payload.kind === "pronto") {
@@ -50603,6 +51448,10 @@ function toTimings(payload) {
 			settings: { carrierHz: decoded.carrierHz }
 		};
 	}
+	if (payload.kind === "native") return {
+		timings: IR_NATIVE_CODECS[payload.format].decode(payload.code),
+		settings: {}
+	};
 	const checked = IrTimingsSchema.safeParse(payload.timings);
 	if (!checked.success) throw new IrCodecError("invalid-timings", checked.error.message);
 	return {
@@ -50890,6 +51739,13 @@ var mediaPlayerCapability = {
 	deviceNative: true,
 	mode: "singleton",
 	deviceTypes: [DeviceType.MediaPlayer],
+	power: {
+		kind: "methods",
+		field: "state",
+		offValues: ["off", "standby"],
+		on: "turnOn",
+		off: "turnOff"
+	},
 	methods: {
 		turnOn: optionalMethod(deviceOnly, _void(), {
 			kind: "mutation",
@@ -51020,7 +51876,7 @@ var mediaPlayerCapability = {
 		isMuted: { kind: "boolean" }
 	} }
 };
-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.PetFountain, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Heater, DeviceType.Dryer, DeviceType.Gateway, DeviceType.HeatPump, DeviceType.Camera, DeviceType.Fan, DeviceType.Lock, 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.Heater, 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.Heater, 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.Heater, 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.Heater, DeviceType.Gateway, DeviceType.Hub, DeviceType.Camera, DeviceType.Sensor, DeviceType.MediaPlayer, DeviceType.Vacuum, DeviceType.Generic, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.PetFountain, DeviceType.Fan, DeviceType.Humidifier, DeviceType.Climate, DeviceType.WaterHeater, DeviceType.MediaPlayer, 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.Heater, DeviceType.MediaPlayer;
+DeviceType.Camera, DeviceType.Sensor, DeviceType.Button, DeviceType.Switch, DeviceType.PetFeeder, DeviceType.Container, DeviceType.Climate, DeviceType.EventEmitter, DeviceType.Camera, DeviceType.Hub, DeviceType.Light, DeviceType.Siren, DeviceType.Switch, DeviceType.Sensor, 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.PetFountain, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Dryer, DeviceType.Gateway, DeviceType.HeatPump, DeviceType.Camera, DeviceType.Fan, DeviceType.Fan, DeviceType.Fan, DeviceType.Fan, DeviceType.Fan, DeviceType.Fan, DeviceType.Fan, DeviceType.Fan, DeviceType.Fan, DeviceType.Fan, DeviceType.Lock, DeviceType.Camera, DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Climate, 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.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.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.Humidifier, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.PetFeeder, DeviceType.Gateway, DeviceType.Camera, DeviceType.Sensor, DeviceType.MediaPlayer, DeviceType.Vacuum, DeviceType.Generic, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.PetFountain, DeviceType.Fan, DeviceType.Humidifier, DeviceType.Climate, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer, DeviceType.WaterHeater, DeviceType.Humidifier, DeviceType.Fan, DeviceType.Climate, DeviceType.PetFeeder, DeviceType.MediaPlayer;
 var NUMBER$1 = {
 	kind: "fixed",
 	result: ["number"]
@@ -51103,7 +51959,7 @@ function numeric$1(input) {
 		}, ...alsoFrom === void 0 ? [] : [alsoFrom.accept]]
 	};
 }
-var CLIMATE_DEVICES = [DeviceType.Thermostat, DeviceType.Climate];
+var CLIMATE_DEVICES = [DeviceType.Climate];
 function binary(input) {
 	return {
 		...input,
@@ -51425,8 +52281,8 @@ var GROUP_TEMPLATES = [
 	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],
+		deviceType: DeviceType.Climate,
+		memberDeviceTypes: [DeviceType.Climate],
 		outputCap: "group-active",
 		outputField: "active",
 		member: {
@@ -51469,6 +52325,118 @@ function actuator(input) {
 new Map(GROUP_TEMPLATES.map((template) => [template.id, template]));
 DeviceFeature.LightColorRgb, DeviceFeature.LightColorHsv, DeviceFeature.LightColorMired;
 DeviceType.Camera;
+var PowerSourceRefusalReasonSchema = _enum([
+	"no-power-source",
+	"switch-missing",
+	"switch-offline",
+	"switch-unknown",
+	"restart-in-progress",
+	"switch-call-failed",
+	"switch-is-actuator"
+]);
+var PowerSourceActionResultSchema = discriminatedUnion("accepted", [object({ accepted: literal(true) }), object({
+	accepted: literal(false),
+	reason: PowerSourceRefusalReasonSchema,
+	/** One line for the operator, naming the switch. */
+	message: string()
+})]);
+var PowerSourceInfoSchema = object({
+	/** False when the device has no power source linked; the rest is then empty. */
+	linked: boolean(),
+	switchDeviceId: number$1().nullable(),
+	switchName: string().nullable(),
+	/** The switch's on/off state, or null when it is unknown. Never false for unknown (D393). */
+	switchOn: boolean().nullable(),
+	switchOnline: boolean().nullable(),
+	restartInProgress: boolean(),
+	offSeconds: number$1().int()
+});
+/** The composed slice: the switch state the link mirrors, plus the stored off time. */
+var PowerSourceStateSchema = object({
+	/** Null while the switch has not reported: unknown is never `false` (D393). */
+	switchOn: boolean().nullable(),
+	offSeconds: number$1().int(),
+	lastFetchedAt: number$1()
+});
+var POWER_SOURCE_DEVICE_TYPES = [
+	DeviceType.Gateway,
+	DeviceType.Camera,
+	DeviceType.Sensor,
+	DeviceType.MediaPlayer,
+	DeviceType.Vacuum,
+	DeviceType.Generic,
+	DeviceType.Washer,
+	DeviceType.Dryer,
+	DeviceType.Dishwasher,
+	DeviceType.PetFountain,
+	DeviceType.Fan,
+	DeviceType.Humidifier,
+	DeviceType.Climate,
+	DeviceType.WaterHeater
+];
+var powerSourceCustomize = {
+	version: 1,
+	targets: [{
+		id: "switch",
+		cardinality: "scalar",
+		vocabulary: {
+			cap: "power-source",
+			stateField: "switchOn"
+		},
+		deviceTypes: POWER_SOURCE_DEVICE_TYPES,
+		apply: "add",
+		path: "switchOn",
+		sources: [{
+			kind: "switch",
+			transforms: [{ kind: "identity" }]
+		}],
+		companions: [{
+			kind: "constant",
+			path: "offSeconds",
+			value: 10,
+			when: "add",
+			formerValues: [0]
+		}, {
+			kind: "clock",
+			path: "lastFetchedAt",
+			when: "always"
+		}],
+		sourceReport: { status: "assignment-status" }
+	}]
+};
+var deviceInput$2 = object({ deviceId: number$1().int().nonnegative() });
+var powerSourceCapability = {
+	name: "power-source",
+	scope: "device",
+	mode: "singleton",
+	deviceTypes: POWER_SOURCE_DEVICE_TYPES,
+	methods: {
+		getStatus: systemMethod(deviceInput$2, PowerSourceInfoSchema, { auth: "protected" }),
+		powerOn: systemMethod(deviceInput$2, PowerSourceActionResultSchema, {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		powerOff: systemMethod(deviceInput$2, PowerSourceActionResultSchema, {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		forceRestart: systemMethod(deviceInput$2, PowerSourceActionResultSchema, {
+			kind: "mutation",
+			auth: "protected"
+		})
+	},
+	runtimeState: PowerSourceStateSchema,
+	customize: powerSourceCustomize,
+	/**
+	* Runtime-state durability: **session** — mirrored from the linked switch on
+	* its next report; a restored value would outlive the reading it names.
+	*
+	* See `RuntimeStateDurability`. Enforced by
+	* `scripts/check-runtime-state-durability.ts`.
+	*/
+	durability: "session",
+	history: "none"
+};
 `${COMPOSED_DEVICE_STABLE_ID_PREFIX}`;
 /**
 * What a composition may BUILD on a device type (G2, D676): the caps a new
@@ -52513,27 +53481,35 @@ var deviceAdminLinkCapability = {
 getAdminLink: method(object({ deviceId: number$1().int().nonnegative() }), DeviceAdminLinkSchema.nullable(), { auth: "admin" }) }
 };
 /**
-* device-discovery — device-scoped capability for parents that host /
-* enumerate child devices (Reolink Hub / NVR, ONVIF gateway, future
-* integrations). The parent advertises a list of discoverable children,
-* and the operator promotes a subset to real devices via `adoptDevice`.
-* Child lifecycle (kernel device create/remove, parent reference) is
-* owned by the framework so a single shared `<DiscoveryPanel />` can
-* drive any integration.
-*
-* Boundaries:
-*   - The cap exposes ENUMERATION + ADOPT/RELEASE only. The protocol
-*     used to discover children (CGI poll, mDNS, push from hub, ...)
-*     is the integration's business; results land in `runtimeState`
-*     so the panel can render without a fresh round-trip.
-*   - `childNativeId` is integration-defined and must be stable across
-*     reboots so re-discovery doesn't duplicate adopted children.
-*   - `adoptDevice` returns the new `deviceId` so the UI can navigate
-*     directly to the freshly-created child's settings page.
-*/
-/**
-* Status enum for a discovered device. Mirrors the Reolink simpleEvent
-* lifecycle (`online` / `sleeping` / `offline`) — generic enough for
+* `device-adoption` — generic discovery + adoption surface,
+* system-scoped collection (one provider per integration addon), routed
+* by explicit `{ addonId }` on direct `deviceAdoption.*` calls — the same
+* pin model as `connection-test`. The admin UI keeps using
+* `deviceManager.adoption*` (which already threads `addonId`). The de-HA-ified
+* successor to `ha-discovery`:
+* keyed by `integrationId` (the addon resolves integrationId → broker
+* internally) rather than a connection-specific `brokerId`, and it
+* OWNS the shared `DiscoveredChildDevice` candidate type
+* (declared below) so a single shared adoption modal renders any integration's
+* candidate tree.
+*
+* UI flow (Integrations page → integration detail):
+*   1. `listCandidates({integrationId, page, pageSize, filter})` →
+*      paginated candidate list, each row collapsed.
+*   2. User expands a row → `getCandidate({integrationId,
+*      childNativeId})` returns the single candidate (with its nested
+*      `children`) for the accordion render.
+*   3. User clicks "Adopt" on one or more candidates →
+*      `adopt({integrationId, childNativeIds, perCandidate?})`
+*      materialises one parent CamStack device per candidate plus its
+*      accessory children. `perCandidate[childNativeId]` carries an
+*      optional display-name override + a `hiddenChildIds` pre-hide set
+*      (the parent's `accessories.hiddenChildIds` gates UI visibility).
+*   4. User clicks "Release" → `release({integrationId, camDeviceId})`
+*      removes the parent + every child from the kernel registry.
+*/
+/**
+* Status enum for a discovered device. Generic enough for
 * battery cams, awake cams, and unreachable cams alike.
 */
 var DiscoveredChildStatusSchema = _enum([
@@ -52550,12 +53526,12 @@ var DiscoveredChildDeviceSchema = lazy(() => object({
 	/** DeviceType the child should be created with on adopt. */
 	type: _enum(DeviceType),
 	status: DiscoveredChildStatusSchema,
-	/** Free-form integration-specific metadata surfaced in the panel. */
+	/** Free-form integration-specific metadata surfaced in the adoption modal. */
 	metadata: object({
 		model: string().optional(),
 		serialNumber: string().optional(),
 		uid: string().optional(),
-		/** Reolink: 0-based channel index inside the parent NVR/Hub. */
+		/** Reolink: 0-based channel index inside the parent NVR. */
 		rtspChannel: number$1().int().nonnegative().optional(),
 		isBattery: boolean().optional(),
 		isDoorbell: boolean().optional(),
@@ -52571,137 +53547,24 @@ var DiscoveredChildDeviceSchema = lazy(() => object({
 	}).default({}),
 	/**
 	* `true` when the framework already created a child device for this
-	* `childNativeId` under the current parent. The panel uses it to
+	* `childNativeId` under the current parent. The adoption modal uses it to
 	* gate the Add/Remove button and surface the existing `deviceId`.
 	*/
 	alreadyAdopted: boolean(),
 	/** When `alreadyAdopted=true`, the framework-assigned child device id. */
 	adoptedDeviceId: number$1().int().nonnegative().nullable(),
-	/** Capability names the candidate advertises — integrations populate, Hubs omit. */
+	/** Capability names the candidate advertises — integrations populate, flat enumerations omit. */
 	capabilities: array(string()).readonly().optional(),
-	/** Feature flags the candidate advertises — integrations populate, Hubs omit. */
+	/** Feature flags the candidate advertises — integrations populate, flat enumerations omit. */
 	features: array(string()).readonly().optional(),
 	/** Upstream-system identity + rendering hints for the candidate. */
 	sourceInfo: SourceInfoSchema.optional(),
-	/** Nested entity-children for accordion preview — integrations populate, Hubs omit. */
+	/** Nested entity-children for accordion preview — integrations populate, flat enumerations omit. */
 	children: array(DiscoveredChildDeviceSchema).readonly().optional(),
 	/** `childNativeId` of the gateway candidate in the same list this device sits behind. */
 	parentStableId: string().optional()
 }));
 /**
-* Status block — populated by the integration after each
-* `refreshDiscovery` (or push-driven update). The runtime-state slice
-* is what the panel reads via the per-device proxy; `getStatus`
-* returns the same payload via the codegen'd auto-injection.
-*/
-var DeviceDiscoveryStatusSchema = object({
-	discovered: array(DiscoveredChildDeviceSchema),
-	/** Wall-clock ms of the last successful enumeration. */
-	lastDiscoveryAt: number$1().int().nonnegative().nullable(),
-	/** Last error surfaced from the source (rendered as a banner). */
-	lastError: string().nullable()
-});
-var deviceDiscoveryCapability = {
-	name: "device-discovery",
-	scope: "device",
-	deviceNative: true,
-	mode: "singleton",
-	deviceTypes: [DeviceType.Hub],
-	status: {
-		schema: DeviceDiscoveryStatusSchema,
-		kind: "poll"
-	},
-	runtimeState: DeviceDiscoveryStatusSchema.extend({ lastFetchedAt: number$1().int().nonnegative() }),
-	/**
-	* Runtime-state durability: **session** — 5.7 KB of scan output on the largest device, fully re-derivable by re-scanning.
-	*
-	* See `RuntimeStateDurability`. Enforced by
-	* `scripts/check-runtime-state-durability.ts`.
-	*/
-	durability: "session",
-	/**
-	* History (D850): none — inventory.
-	*/
-	history: "none",
-	methods: {
-		/**
-		* Snapshot of the current `discovered` list. Returns the
-		* runtime-state cache — call `refreshDiscovery` first if a
-		* fresh round-trip to the source is required.
-		*/
-		listDiscovered: method(object({ deviceId: number$1().int().nonnegative() }), array(DiscoveredChildDeviceSchema).readonly()),
-		/**
-		* Force the integration to re-enumerate and update the
-		* runtime-state slice. Returns the freshly-enumerated list (also
-		* available via `listDiscovered` post-call).
-		*/
-		refreshDiscovery: method(object({ deviceId: number$1().int().nonnegative() }), array(DiscoveredChildDeviceSchema).readonly(), {
-			kind: "mutation",
-			auth: "admin"
-		}),
-		/**
-		* Promote a discovered entry to a real child device. The framework
-		* creates the child via `kernel.devices.create()` with
-		* `parentDeviceId = parent.id` and seeds the child's config from
-		* `childInitialConfig` (driver-defined; usually carries channel +
-		* uid + parent reference). Returns the kernel-assigned numeric id.
-		*/
-		adoptDevice: method(object({
-			deviceId: number$1().int().nonnegative(),
-			childNativeId: string(),
-			/** Optional override for the child's display name. */
-			name: string().optional()
-		}), object({
-			deviceId: number$1().int().nonnegative(),
-			stableId: string()
-		}), {
-			kind: "mutation",
-			auth: "admin"
-		}),
-		/**
-		* Inverse of `adoptDevice`: removes the child device from the
-		* kernel registry. The discovered entry remains in the
-		* enumeration (status updates resume) so the operator can re-adopt
-		* it later without a fresh refresh.
-		*/
-		releaseDevice: method(object({
-			deviceId: number$1().int().nonnegative(),
-			childDeviceId: number$1().int().nonnegative()
-		}), _void(), {
-			kind: "mutation",
-			auth: "admin"
-		})
-	}
-};
-/**
-* `device-adoption` — generic discovery + adoption surface,
-* system-scoped collection (one provider per integration addon), routed
-* by explicit `{ addonId }` on direct `deviceAdoption.*` calls — the same
-* pin model as `connection-test`. The admin UI keeps using
-* `deviceManager.adoption*` (which already threads `addonId`). The de-HA-ified
-* successor to `ha-discovery`:
-* keyed by `integrationId` (the addon resolves integrationId → broker
-* internally) rather than a connection-specific `brokerId`, and it
-* REUSES the shared `DiscoveredChildDevice` candidate type from
-* `device-discovery.cap.ts` so a single shared adoption panel renders
-* any integration's candidate tree.
-*
-* UI flow (Integrations page → integration detail):
-*   1. `listCandidates({integrationId, page, pageSize, filter})` →
-*      paginated candidate list, each row collapsed.
-*   2. User expands a row → `getCandidate({integrationId,
-*      childNativeId})` returns the single candidate (with its nested
-*      `children`) for the accordion render.
-*   3. User clicks "Adopt" on one or more candidates →
-*      `adopt({integrationId, childNativeIds, perCandidate?})`
-*      materialises one parent CamStack device per candidate plus its
-*      accessory children. `perCandidate[childNativeId]` carries an
-*      optional display-name override + a `hiddenChildIds` pre-hide set
-*      (the parent's `accessories.hiddenChildIds` gates UI visibility).
-*   4. User clicks "Release" → `release({integrationId, camDeviceId})`
-*      removes the parent + every child from the kernel registry.
-*/
-/**
 * Provider-declared discovery *granularity* filter (the keystone of the
 * single-entity-import design). A provider advertises which discovery
 * granularities it supports via `listCandidateFilters`; the operator picks
@@ -54129,8 +54992,14 @@ method(object({
 			"string",
 			"number",
 			"boolean",
-			"enum"
+			"enum",
+			"union"
 		]),
+		unionMembers: array(_enum([
+			"string",
+			"number",
+			"boolean"
+		])).optional(),
 		enumValues: array(string()).optional(),
 		item: boolean().optional(),
 		quantity: ReadingQuantitySchema.optional()
@@ -56222,53 +57091,6 @@ var enumSensorCapability = {
 	*  whether persisting is worth a SQLite commit. */
 	volatileStateFields: ["lastFetchedAt", "timestamp"]
 };
-/**
-* Generic stateless event emitter. Installed on a `DeviceType.EventEmitter`
-* device. Carries the device's EXACT declared event vocabulary verbatim
-* (NO normalization). Two shapes:
-*  - structured source (HA `event.*` entity) → `eventTypes` is the fixed
-*    declared vocabulary (e.g. ['press_short','press_long',...]).
-*  - generic/legacy source (HA bus events, e.g. zha_event) → `eventTypes`
-*    is [] (open) and `lastEvent.data` carries the complex payload.
-* `seq` is monotonic so two identical events still produce distinct slice writes.
-*/
-var EventFireSchema = object({
-	deviceId: number$1(),
-	eventType: string(),
-	data: record(string(), unknown()).nullable(),
-	timestamp: number$1().meta(readingMeta("none")),
-	seq: number$1().meta(readingMeta("count"))
-});
-var EventEmitterStatusSchema = object({
-	eventTypes: array(string()),
-	lastEvent: EventFireSchema.nullable(),
-	eventCountSinceStart: number$1().meta(readingMeta("count"))
-});
-var eventEmitterCapability = {
-	name: "event-emitter",
-	scope: "device",
-	deviceNative: true,
-	mode: "singleton",
-	deviceTypes: [DeviceType.EventEmitter],
-	methods: {},
-	events: { onEvent: { data: EventFireSchema } },
-	status: {
-		schema: EventEmitterStatusSchema,
-		kind: "push"
-	},
-	runtimeState: EventEmitterStatusSchema,
-	/**
-	* Runtime-state durability: **session** — `eventCountSinceStart` names its own scope.
-	*
-	* See `RuntimeStateDurability`. Enforced by
-	* `scripts/check-runtime-state-durability.ts`.
-	*/
-	durability: "session",
-	/**
-	* History (D850): none — `eventCountSinceStart` resets with the addon; events live in ledgers.
-	*/
-	history: "none"
-};
 var IdentitySchema = object({
 	id: string(),
 	name: string(),
@@ -56758,8 +57580,85 @@ method(_void(), array(FailureContributionSchema).readonly());
 *   - `FanPreset` — preset selector
 *   - `FanDirection` — direction toggle (ceiling fans)
 *   - `FanOscillating` — oscillation toggle
+*
+* Per-axis oscillation (`oscillationAxes`, `setOscillationAxis`, D1034): an air
+* circulator sweeps horizontally and vertically, each axis with its own
+* switch, fixed angle, sweep bounds and limits. A provider may report them
+* natively; otherwise the OPERATOR links sibling devices to each field in
+* Customize (a `replace` over the fields listed in `overridable` — nothing is
+* linked or inferred by itself), and a write to a linked field is forwarded to
+* its source. `oscillating` stays the single summary flag: when axes exist it
+* means "any axis oscillates" (`anyAxisOscillating`).
 */
 var FanDirectionSchema = _enum(["forward", "reverse"]);
+var FAN_OSCILLATION_AXES = ["horizontal", "vertical"];
+var FanOscillationAxisNameSchema = _enum(FAN_OSCILLATION_AXES);
+var FanOscillationAxisFieldSchema = _enum([
+	"oscillating",
+	"angle",
+	"sweepFrom",
+	"sweepTo"
+]);
+/** The limits of one axis, read from the source that serves its angle. */
+var FAN_OSCILLATION_AXIS_LIMITS = [
+	"min",
+	"max",
+	"step"
+];
+/**
+* One oscillation axis. Every reading the device has not reported is `null`,
+* never `0` (D393): `0°` is a real position. Each leaf defaults to `null`, so
+* a slice that names only the leaves it knows (a Customize link of one field)
+* is still a whole axis.
+*/
+var FanOscillationAxisSchema = object({
+	/** Whether the axis sweeps. */
+	oscillating: boolean().nullable().default(null),
+	/** The fixed position (degrees) the axis holds when it does not sweep. */
+	angle: number$1().nullable().default(null),
+	/** The sweep bounds (degrees): left → right, bottom → top. */
+	sweepFrom: number$1().nullable().default(null),
+	sweepTo: number$1().nullable().default(null),
+	/** The angles the axis accepts. Null when the device states none. */
+	min: number$1().nullable().default(null),
+	max: number$1().nullable().default(null),
+	step: number$1().nullable().default(null)
+});
+/** Both axes; an axis the device does not have is `null`. */
+var FanOscillationAxesSchema = object({
+	horizontal: FanOscillationAxisSchema.nullable().default(null),
+	vertical: FanOscillationAxisSchema.nullable().default(null)
+});
+var FanOscillationAxisRefusalSchema = _enum([
+	"nothing-to-set",
+	"axis-not-linked",
+	"out-of-range",
+	"source-gone",
+	"source-unknown",
+	"source-call-failed"
+]);
+var FanOscillationAxisResultSchema = discriminatedUnion("status", [object({ status: literal("applied") }), object({
+	status: literal("refused"),
+	reason: FanOscillationAxisRefusalSchema,
+	/** The field at fault, when one is. */
+	field: FanOscillationAxisFieldSchema.optional(),
+	/** One line for the operator, naming the axis, the field and the source. */
+	detail: string(),
+	/** Fields that DID land before the refusal (writes run in order, stop at the first failure). */
+	applied: array(FanOscillationAxisFieldSchema)
+})]);
+var SetOscillationAxisInputSchema = object({
+	deviceId: number$1().int().nonnegative(),
+	axis: FanOscillationAxisNameSchema,
+	oscillating: boolean().optional(),
+	angle: number$1().optional(),
+	sweepFrom: number$1().optional(),
+	sweepTo: number$1().optional()
+});
+/** The state path of one axis field: `oscillationAxes.<axis>.<field>`. */
+function fanAxisPath(axis, field) {
+	return `oscillationAxes.${axis}.${field}`;
+}
 var FanControlStatusSchema = object({
 	/** Active speed as 0..100 inclusive. Null when the device has no
 	*  speed surface (single-speed fan). */
@@ -56778,9 +57677,102 @@ var FanControlStatusSchema = object({
 	/** Oscillation toggle. Null when the device has no oscillation
 	*  surface. */
 	oscillating: boolean().nullable(),
+	/**
+	* Per-axis oscillation (air circulators). Absent when the device has no
+	* per-axis surface and nothing is linked in Customize.
+	*/
+	oscillationAxes: FanOscillationAxesSchema.optional(),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number$1()
 });
+var FAN_CUSTOMIZE_DEVICE_TYPES = [DeviceType.Fan];
+/** The Customize section the axis targets are listed under. */
+var AXES_SECTION = "oscillation-axes";
+function axisOscillatingTarget(axis) {
+	return {
+		id: `${axis}-oscillating`,
+		cardinality: "scalar",
+		vocabulary: {
+			cap: "fan-control",
+			stateField: "oscillating"
+		},
+		deviceTypes: FAN_CUSTOMIZE_DEVICE_TYPES,
+		apply: "replace",
+		section: AXES_SECTION,
+		path: fanAxisPath(axis, "oscillating"),
+		sources: [{
+			kind: "switch",
+			transforms: [{ kind: "identity" }]
+		}],
+		sourceReport: { status: "assignment-status" }
+	};
+}
+/**
+* A numeric axis field. The `angle` link also carries the axis limits, read
+* from the SAME linked control's own range (`min`/`max`/`step`), so the limits
+* are the source's, never guessed.
+*/
+function axisNumericTarget(axis, field) {
+	const base = {
+		id: `${axis}-${field}`,
+		cardinality: "scalar",
+		vocabulary: { cap: "fan-control" },
+		deviceTypes: FAN_CUSTOMIZE_DEVICE_TYPES,
+		apply: "replace",
+		section: AXES_SECTION,
+		path: fanAxisPath(axis, field),
+		sources: [{
+			kind: "numeric",
+			transforms: [{ kind: "identity" }]
+		}],
+		sourceReport: { status: "assignment-status" }
+	};
+	if (field !== "angle") return base;
+	return {
+		...base,
+		companions: FAN_OSCILLATION_AXIS_LIMITS.map((limit) => ({
+			kind: "source-field",
+			path: fanAxisPath(axis, limit),
+			field: limit
+		}))
+	};
+}
+var AXIS_TARGETS = FAN_OSCILLATION_AXES.flatMap((axis) => [
+	axisOscillatingTarget(axis),
+	axisNumericTarget(axis, "angle"),
+	axisNumericTarget(axis, "sweepFrom"),
+	axisNumericTarget(axis, "sweepTo")
+]);
+/** A select (an enum control) the operator links to the fan's `preset`. */
+var PRESET_TARGET = {
+	id: "preset",
+	cardinality: "scalar",
+	vocabulary: { cap: "fan-control" },
+	deviceTypes: FAN_CUSTOMIZE_DEVICE_TYPES,
+	apply: "replace",
+	path: "preset",
+	sources: [{
+		kind: "field",
+		valueKinds: ["string"],
+		transforms: [{ kind: "identity" }]
+	}],
+	sourceReport: { status: "assignment-status" }
+};
+var FAN_CONTROL_TARGETS = [...AXIS_TARGETS, PRESET_TARGET];
+/**
+* Customize (D1034): the fan already serves `fan-control` natively, so every
+* target is a `replace` over a field listed in `overridable` — the axis leaves
+* and `preset`, nothing else. Nothing is pre-linked: the operator picks each
+* source (D356).
+*/
+var fanControlCustomize = {
+	version: 1,
+	overridable: FAN_CONTROL_TARGETS.map((target) => ({
+		path: target.path,
+		by: target.id
+	})),
+	targets: FAN_CONTROL_TARGETS
+};
 var fanControlCapability = {
 	name: "fan-control",
 	scope: "device",
@@ -56815,6 +57807,18 @@ var fanControlCapability = {
 		}), _void(), {
 			kind: "mutation",
 			auth: "protected"
+		}),
+		/**
+		* Sets one oscillation axis: its switch, fixed angle and/or sweep bounds.
+		* Fields left out are untouched. A field linked in Customize is forwarded
+		* to its linked source (D1034); otherwise the native provider serves it;
+		* neither → `axis-not-linked`. Ranges are checked against the axis limits
+		* before anything is written; writes run in order and stop at the first
+		* failure, which the result names.
+		*/
+		setOscillationAxis: optionalMethod(SetOscillationAxisInputSchema, FanOscillationAxisResultSchema, {
+			kind: "mutation",
+			auth: "protected"
 		})
 	},
 	status: {
@@ -56826,6 +57830,7 @@ var fanControlCapability = {
 	* sliders read `speed` for live updates.
 	*/
 	runtimeState: FanControlStatusSchema,
+	customize: fanControlCustomize,
 	/**
 	* Runtime-state durability: **session** — as `brightness`.
 	*
@@ -56845,16 +57850,33 @@ var fanControlCapability = {
 		oscillating: { kind: "boolean" }
 	} }
 };
+/** One axis as a preset wants it; an absent field is left as it is. */
+var FanPresetAxisSchema = object({
+	oscillating: boolean().optional(),
+	angle: number$1().optional(),
+	sweepFrom: number$1().optional(),
+	sweepTo: number$1().optional()
+});
+/** The fan-control state a preset sets; an absent field is left as it is. */
+var FanPresetStateSchema = object({
+	speed: number$1().min(0).max(100).optional(),
+	/** The fan's own preset mode (or the linked select's option). */
+	preset: string().min(1).optional(),
+	direction: FanDirectionSchema.optional(),
+	oscillationAxes: object({
+		horizontal: FanPresetAxisSchema.optional(),
+		vertical: FanPresetAxisSchema.optional()
+	}).optional()
+});
 var FanPresetSchema = object({
 	/** Stable key; never reused after a delete within one device's list. */
 	id: string().min(1).max(64),
 	/** What the operator and a voice assistant call it. */
 	name: string().trim().min(1).max(40),
-	steps: array(ActionStepSchema).min(1).max(20)
+	state: FanPresetStateSchema
 });
 var FanPresetsRefusalSchema = _enum([
-	"not-sibling",
-	"bad-target",
+	"empty-state",
 	"duplicate-name",
 	"duplicate-id",
 	"too-many",
@@ -56866,72 +57888,55 @@ var FanPresetsSetResultSchema = discriminatedUnion("status", [object({
 }), object({
 	status: literal("refused"),
 	reason: FanPresetsRefusalSchema,
-	/** Names the preset and step at fault. */
+	/** Names the preset at fault. */
 	detail: string()
 })]);
-var FanPresetStepResultSchema = object({
-	index: number$1().int().nonnegative(),
+var FanPresetFieldResultSchema = object({
+	/** The state path: `speed`, `preset`, `direction`, `oscillationAxes.horizontal.angle`. */
+	field: string(),
 	outcome: _enum([
 		"applied",
 		"failed",
 		"not-run",
 		"refused"
 	]),
-	deviceId: number$1().int().nonnegative().optional(),
-	cap: string().optional(),
-	method: string().optional(),
 	/** The cause, for every outcome but `applied`. */
 	message: string().optional()
 });
 var FanPresetApplyResultSchema = object({
-	/** `applied`: every step ran. `partial`: some ran, one failed. `refused`: nothing ran. */
+	/** `applied`: every field landed. `partial`: some did, one did not. `refused`: nothing ran. */
 	status: _enum([
 		"applied",
 		"partial",
 		"refused"
 	]),
-	steps: array(FanPresetStepResultSchema)
+	fields: array(FanPresetFieldResultSchema)
 });
 var FanCaptureFieldSchema = _enum([
 	"speed",
-	"oscillating",
 	"direction",
-	"preset"
+	"preset",
+	"oscillationAxes"
 ]);
-var FanCaptureOmissionSchema = object({
-	/** A fan field (`speed`) or `step <n>` for a sibling step. */
-	what: string(),
-	/** Why no value was taken: unknown reading (never stored as 0, D393), or a step that cannot be read. */
-	reason: string()
-});
-var FanCaptureItemSchema = object({
-	group: _enum([
-		"fan",
-		"oscillation",
-		"angles"
-	]),
-	/** What the step sets, in the operator's words (a device name, a fan field). */
-	label: string()
-});
 var FanPresetCaptureResultSchema = object({
-	/** The steps filled from the device's current values; NOT saved. */
-	steps: array(ActionStepSchema),
-	/** One entry per step, same order: its review group and label. */
-	items: array(FanCaptureItemSchema),
-	omitted: array(FanCaptureOmissionSchema)
+	/** The fan's CURRENT fan-control state, as a preset; NOT saved. */
+	state: FanPresetStateSchema,
+	omitted: array(object({
+		/** A state path (`speed`, `oscillationAxes.vertical.angle`). */
+		what: string(),
+		/** Why no value was taken: an unknown reading is never stored as 0 (D393). */
+		reason: string()
+	}))
 });
-var deviceInput$2 = object({ deviceId: number$1().int().nonnegative() });
+var deviceInput$1 = object({ deviceId: number$1().int().nonnegative() });
 DeviceType.Fan;
-method(deviceInput$2, array(FanPresetSchema), { auth: "protected" }), method(deviceInput$2.extend({ presets: array(FanPresetSchema).max(12) }), FanPresetsSetResultSchema, {
+method(deviceInput$1, array(FanPresetSchema), { auth: "protected" }), method(deviceInput$1.extend({ presets: array(FanPresetSchema).max(12) }), FanPresetsSetResultSchema, {
 	kind: "mutation",
 	auth: "admin"
-}), method(deviceInput$2.extend({ presetId: string().min(1) }), FanPresetApplyResultSchema, {
+}), method(deviceInput$1.extend({ presetId: string().min(1) }), FanPresetApplyResultSchema, {
 	kind: "mutation",
 	auth: "protected"
-}), method(deviceInput$2.extend({
-	fields: array(FanCaptureFieldSchema).optional(),
-	steps: array(ActionStepSchema).max(20).default([])
-}), FanPresetCaptureResultSchema, { auth: "protected" });
+}), method(deviceInput$1.extend({ fields: array(FanCaptureFieldSchema).optional() }), FanPresetCaptureResultSchema, { auth: "protected" });
 /**
 * Per-device feature/identity probe slice. Holds the runtime-resolved
 * truth about what a device CAN do — which the kernel uses to:
@@ -57143,8 +58148,7 @@ var groupActiveCapability = {
 		DeviceType.Valve,
 		DeviceType.Lock,
 		DeviceType.MediaPlayer,
-		DeviceType.Climate,
-		DeviceType.Thermostat
+		DeviceType.Climate
 	],
 	methods: {},
 	status: {
@@ -57186,7 +58190,6 @@ var groupCommandsCapability = {
 		DeviceType.Valve,
 		DeviceType.Lock,
 		DeviceType.MediaPlayer,
-		DeviceType.Thermostat,
 		DeviceType.Climate
 	],
 	methods: {},
@@ -57242,7 +58245,6 @@ var groupStatusCapability = {
 		DeviceType.Valve,
 		DeviceType.Lock,
 		DeviceType.MediaPlayer,
-		DeviceType.Thermostat,
 		DeviceType.Climate
 	],
 	methods: {},
@@ -57571,7 +58573,7 @@ var heatingValveCapability = {
 	scope: "device",
 	deviceNative: true,
 	mode: "singleton",
-	deviceTypes: [DeviceType.Thermostat],
+	deviceTypes: [DeviceType.Climate],
 	methods: {},
 	status: {
 		schema: HeatingValveStatusSchema,
@@ -57601,13 +58603,18 @@ var heatingValveCapability = {
 * retried in a loop - D49); a future one is re-armed.
 *
 * What a device may be run for, and for how long at most, is per device type
-* ({@link TIMED_RUN_LIMITS}): the maximum is a safety bound, not a preference,
+* and role ({@link timedRunLimitOf}): the maximum is a safety bound, not a preference,
 * so a request above it is REFUSED with a typed reason, never clamped.
 */
 var TimedRunUnitSchema = _enum(["s", "min"]);
 _enum(["switch", "pet-fountain"]);
-DeviceType.Heater, DeviceType.PetFountain;
-var TIMED_RUN_DEVICE_TYPES = [DeviceType.Heater, DeviceType.PetFountain];
+/**
+* The device types `timed-run` may be offered on. A `switch` is narrowed by
+* role ({@link TIMED_RUN_DEVICE_ROLES}): only a plug-in heater runs on a timer.
+*/
+var TIMED_RUN_DEVICE_TYPES = [DeviceType.Switch, DeviceType.PetFountain];
+/** The roles that make a device of these types timed-run-able (D1033). */
+var TIMED_RUN_DEVICE_ROLES = { [DeviceType.Switch]: [DeviceRole.SwitchHeater] };
 /** One duration, as the one-tap run asks for it. */
 var TimedRunQuickRunSchema = object({
 	duration: number$1().positive().finite(),
@@ -57657,6 +58664,7 @@ var timedRunCapability = {
 	kind: "wrapper",
 	defaultActive: true,
 	deviceTypes: TIMED_RUN_DEVICE_TYPES,
+	deviceRoles: TIMED_RUN_DEVICE_ROLES,
 	deviceConfig: { ui: {
 		kind: "derived-form",
 		builderId: "timed-run",
@@ -57817,8 +58825,8 @@ var HeroSceneSchema = object({
 	/** 0..1: volume, cover position, cycle progress. */
 	level: number$1().min(0).max(1).nullable()
 });
-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.HeatPump, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.PetFountain, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Heater, DeviceType.Dryer, DeviceType.Gateway;
-DeviceRole.Siren, DeviceRole.Floodlight, DeviceRole.Spotlight, DeviceRole.PirSensor, DeviceRole.Chime, DeviceRole.Autotrack, DeviceRole.Nightvision, DeviceRole.PrivacyMask, DeviceRole.Doorbell, DeviceRole.CoverBlind, DeviceRole.CoverShutter, DeviceRole.CoverAwning, DeviceRole.CoverCurtain, DeviceRole.CoverGarage, DeviceRole.CoverGate, DeviceRole.CoverDoor, DeviceRole.CoverWindow, DeviceRole.BinaryHelper, DeviceRole.Outlet, DeviceRole.MotionSensor, DeviceRole.ContactSensor, DeviceRole.LeakSensor, DeviceRole.SmokeSensor, DeviceRole.COSensor, DeviceRole.GasSensor, DeviceRole.TamperSensor, DeviceRole.VibrationSensor, DeviceRole.ConnectivitySensor, DeviceRole.SoundSensor, DeviceRole.BinarySensor, DeviceRole.TemperatureSensor, DeviceRole.HumiditySensor, DeviceRole.AmbientLightSensor, DeviceRole.PressureSensor, DeviceRole.WindSensor, DeviceRole.RainSensor, DeviceRole.UvSensor, DeviceRole.SolarRadiationSensor, DeviceRole.SoilMoistureSensor, DeviceRole.PowerSensor, DeviceRole.EnergySensor, DeviceRole.VoltageSensor, DeviceRole.CurrentSensor, DeviceRole.AirQualitySensor, DeviceRole.BatterySensor, DeviceRole.NumericSensor, DeviceRole.EnumSensor, DeviceRole.DateTimeSensor, DeviceRole.GenericSensor, DeviceRole.NumericControl, DeviceRole.SelectControl, DeviceRole.TextControl, DeviceRole.DateTimeControl, DeviceRole.MobilePushNotifier, DeviceRole.MessagingNotifier, DeviceRole.EmailNotifier, DeviceRole.GenericNotifier, DeviceRole.IrTransmitter;
+DeviceType.Camera, DeviceType.Hub, DeviceType.Light, DeviceType.Siren, DeviceType.Switch, DeviceType.Sensor, 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.HeatPump, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.PetFountain, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Dryer, DeviceType.Gateway;
+DeviceRole.Siren, DeviceRole.Floodlight, DeviceRole.Spotlight, DeviceRole.PirSensor, DeviceRole.Chime, DeviceRole.Autotrack, DeviceRole.Nightvision, DeviceRole.PrivacyMask, DeviceRole.Doorbell, DeviceRole.CoverBlind, DeviceRole.CoverShutter, DeviceRole.CoverAwning, DeviceRole.CoverCurtain, DeviceRole.CoverGarage, DeviceRole.CoverGate, DeviceRole.CoverDoor, DeviceRole.CoverWindow, DeviceRole.BinaryHelper, DeviceRole.Outlet, DeviceRole.SwitchHeater, DeviceRole.SwitchFan, DeviceRole.ClimateAc, DeviceRole.ClimateThermostat, DeviceRole.ClimateFloor, DeviceRole.ClimateRadiator, DeviceRole.ClimateHeater, DeviceRole.ClimateHeatPumpCircuit, DeviceRole.MotionSensor, DeviceRole.ContactSensor, DeviceRole.LeakSensor, DeviceRole.SmokeSensor, DeviceRole.COSensor, DeviceRole.GasSensor, DeviceRole.TamperSensor, DeviceRole.VibrationSensor, DeviceRole.ConnectivitySensor, DeviceRole.SoundSensor, DeviceRole.BinarySensor, DeviceRole.TemperatureSensor, DeviceRole.HumiditySensor, DeviceRole.AmbientLightSensor, DeviceRole.PressureSensor, DeviceRole.WindSensor, DeviceRole.RainSensor, DeviceRole.UvSensor, DeviceRole.SolarRadiationSensor, DeviceRole.SoilMoistureSensor, DeviceRole.PowerSensor, DeviceRole.EnergySensor, DeviceRole.VoltageSensor, DeviceRole.CurrentSensor, DeviceRole.AirQualitySensor, DeviceRole.BatterySensor, DeviceRole.NumericSensor, DeviceRole.EnumSensor, DeviceRole.DateTimeSensor, DeviceRole.GenericSensor, DeviceRole.NumericControl, DeviceRole.SelectControl, DeviceRole.TextControl, DeviceRole.DateTimeControl, DeviceRole.MobilePushNotifier, DeviceRole.MessagingNotifier, DeviceRole.EmailNotifier, DeviceRole.GenericNotifier, DeviceRole.IrTransmitter;
 /** A string in both languages, as the cap vocabulary writes it (D920): no `t()` in the model. */
 var HeroTextSchema = object({
 	en: string(),
@@ -57884,13 +58892,11 @@ var HeroConfirmSchema = _enum([
 	"press"
 ]);
 var HeroActionSchema = object({
-	/** Unique within the model; the `gated` list and the specs name it. */
 	id: string(),
 	label: HeroTextSchema,
 	icon: IconKeySchema,
 	call: HeroCallSchema,
 	emphasis: _enum(["primary", "normal"]),
-	/** Ask before running it. */
 	confirm: HeroConfirmSchema.nullable()
 });
 var HeroControlSchema = discriminatedUnion("kind", [
@@ -57973,9 +58979,16 @@ var HeroBadgeSchema = object({
 	value: number$1().nullable(),
 	label: HeroTextSchema
 });
-var HeroRemoteSlotSchema = object({ 
-/** Saved commands; `null` = not known yet (the button still shows). */
-commands: number$1().int().nullable() });
+var HeroRemoteSlotSchema = object({
+	/** Saved commands; `null` = not known yet (the button still shows). */
+	commands: number$1().int().nullable(),
+	/**
+	* The control a list row draws as the "open the remote" icon. Recognised by its id
+	* ({@link REMOTE_OPEN_ACTION_ID}); it changes no state, so a client opens the remote
+	* instead of running `call`. Absent on a model from an older server.
+	*/
+	open: HeroActionSchema.optional()
+});
 var HeroConsumablesSlotSchema = object({
 	items: array(object({
 		key: string(),
@@ -58143,6 +59156,8 @@ var HeroModelSchema = object({
 *     the FIRST row that has any (a later row's control is never promoted). When
 *     the model lists that part in `gated`, the row has no inline control: the
 *     projection never falls through to another control the caller could use.
+*   - a climate or thermostat row's primary is its `climate.mode` control (no power
+*     toggle: "off" is a mode); when the model gates it the rule above applies as before;
 *   - a timed run, when the model carries the slot, sits beside that primary:
 *     Run while idle, Stop while armed. Gating the slot hides the control.
 *   - the status line is the head (what plays, else the state) plus at most
@@ -58150,6 +59165,13 @@ var HeroModelSchema = object({
 *     time left on an armed timed run;
 *   - the trailing fact is the first of power, battery, consumables.
 *
+*   - `extras` are the further inline controls of the types that carry more than one
+*     ({@link ROW_EXTRAS_BY_TYPE}): climate setpoint, a robot's return to base,
+*     a player's volume and remote. Each is a control the model already has, named by id,
+*     in that order and at most {@link ROW_EXTRAS_MAX}; one the model lacks, or lists in
+*     `gated`, is absent, and the one `primary` already is never repeats. Empty = the
+*     row of an older server: `primary` alone.
+*
 * `projectDeviceRow` is pure and computes nothing: it selects from a
 * {@link HeroModel}. A row that needed a value the hero lacks would mean the
 * model is missing it, so the fix goes in the model.
@@ -58181,8 +59203,25 @@ var HeroRowModelSchema = object({
 	* while armed. `null` when there is no slot, or the caller may not act.
 	*/
 	timedRun: HeroRowTimedRunSchema.nullable(),
+	/**
+	* The further inline controls after `primary`, in order (see the header). The remote
+	* is an `action` with id `remote.open`: the client opens the remote, it does not run
+	* the call. Absent or empty = `primary` alone.
+	*/
+	extras: array(HeroControlSchema).max(2).optional(),
 	trailing: HeroFactSchema.nullable()
 });
+new Set([
+	"temperature",
+	"humidity",
+	"pressure",
+	"illuminance",
+	"reading",
+	"air-quality",
+	"valve"
+]);
+DeviceType.Climate;
+DeviceType.Climate, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer;
 /**
 * hero-layout — what a device's hero says (D1023). Read-only: the FIXED
 * layouts live in `@camstack/types` and nothing here stores or edits one.
@@ -58214,7 +59253,10 @@ method(heroInput, HeroModelSchema.nullable(), {
 }), method(rowModelsInput, array(HeroRowModelSchema.nullable()), {
 	auth: "protected",
 	role: "viewer"
-}), method(object({ deviceType: string() }), HeroLayoutRowsSchema, {
+}), method(object({
+	deviceType: string(),
+	role: string().nullable().optional()
+}), HeroLayoutRowsSchema, {
 	auth: "protected",
 	role: "viewer"
 });
@@ -58261,6 +59303,11 @@ var humidifierCapability = {
 	deviceNative: true,
 	mode: "singleton",
 	deviceTypes: [DeviceType.Humidifier],
+	power: {
+		kind: "field",
+		field: "on",
+		set: "setOn"
+	},
 	methods: {
 		setOn: method(object({
 			deviceId: number$1().int().nonnegative(),
@@ -58334,7 +59381,7 @@ var humiditySensorCapability = {
 	scope: "device",
 	deviceNative: true,
 	mode: "singleton",
-	deviceTypes: [DeviceType.Sensor, DeviceType.Thermostat],
+	deviceTypes: [DeviceType.Sensor, DeviceType.Climate],
 	methods: {},
 	status: {
 		schema: HumiditySensorStatusSchema,
@@ -58628,6 +59675,12 @@ var IntegrationLiteSchema = object({
 var AvailableIntegrationTypeSchema = object({
 	addonId: string(),
 	name: string(),
+	/**
+	* Product name a new integration is prefilled from (`<label> - Home`).
+	* Absent: the client uses `name`. Set when the catalog title is not the
+	* product (Bosch SHC, MQTT).
+	*/
+	providerLabel: string().optional(),
 	description: string(),
 	iconUrl: string().nullable(),
 	color: string(),
@@ -59255,13 +60308,32 @@ var IrSendResultSchema = object({
 var IrTransmitterInfoSchema = object({
 	media: array(IrMediumSchema),
 	settable: array(TransmitSettingKeySchema),
-	maxTimings: number$1().int().positive()
+	maxTimings: number$1().int().positive(),
+	/** The transmitter can learn a code (`learn`). */
+	learn: boolean().default(false),
+	/** Native code formats the transmitter replays verbatim (`send.native`). */
+	formats: array(IrNativeFormatSchema).default([])
+});
+var IR_LEARN_TIMEOUT_DEFAULT_MS = 2e4;
+var IR_LEARN_TIMEOUT_MAX_MS = 6e4;
+var IrLearnResultSchema = object({
+	/** The code in the device's own format, when it reports one. */
+	native: IrNativeCodeSchema.nullable(),
+	timings: IrTimingsSchema,
+	carrierHz: number$1().int().positive().nullable()
 });
 DeviceType.Generic, method(object({
 	deviceId: number$1().int().nonnegative(),
-	timings: IrTimingsSchema,
+	timings: IrTimingsSchema.optional(),
+	native: IrNativeCodeSchema.optional(),
 	settings: TransmitSettingsSchema.optional()
-}), IrSendResultSchema, {
+}).refine((input) => input.timings === void 0 !== (input.native === void 0), { message: "send takes exactly one of timings or native" }), IrSendResultSchema, {
+	kind: "mutation",
+	auth: "protected"
+}), method(object({
+	deviceId: number$1().int().nonnegative(),
+	timeoutMs: number$1().int().positive().max(IR_LEARN_TIMEOUT_MAX_MS).default(IR_LEARN_TIMEOUT_DEFAULT_MS)
+}), IrLearnResultSchema, {
 	kind: "mutation",
 	auth: "protected"
 }), method(object({ deviceId: number$1().int().nonnegative() }), IrTransmitterInfoSchema, {
@@ -69047,6 +70119,7 @@ var NcSystemEventKindSchema = _enum([
 	"recording-degraded",
 	"device-attention-required",
 	"device-attention-resolved",
+	"device-command",
 	"storage-location-low",
 	"storage-location-critical",
 	"storage-location-ok",
@@ -69109,11 +70182,6 @@ var NC_ALARM_SYSTEM_EVENT_KINDS = [
 	"alarm-sensor-bypass",
 	"alarm-disarmed"
 ];
-/**
-* One coherent system-event condition. `kinds` is the required opt-in safety
-* gate; the remaining lists are optional narrowing filters relevant to the
-* selected kinds.
-*/
 var NcSystemEventConditionSchema = object({
 	kinds: array(NcSystemEventKindSchema).min(1),
 	deviceIds: array(number$1().int()).min(1).optional(),
@@ -69145,6 +70213,28 @@ var NcSystemEventConditionSchema = object({
 	nodeIds: array(string().min(1)).min(1).optional(),
 	packageNames: array(string().min(1)).min(1).optional(),
 	/**
+	* `device-command` only: the vocabulary ACTION IDS (D983, `powerSource.forceRestart`)
+	* this rule speaks about - the same dictionary the automation action blocks
+	* pick from. The hub refuses an id the action index does not know.
+	*/
+	commandActions: array(string().min(1)).min(1).optional(),
+	/** `device-command` only: how the command settled. A device's own change is not a command. */
+	commandOutcomes: array(_enum([
+		"confirmed",
+		"already",
+		"unconfirmed",
+		"failed"
+	])).min(1).optional(),
+	/** `device-command` only: who asked (`user`, `addon`, `action`, `scheduler`, `composition`, `node`). */
+	commandActorKinds: array(_enum([
+		"user",
+		"addon",
+		"action",
+		"scheduler",
+		"composition",
+		"node"
+	])).min(1).optional(),
+	/**
 	* At or below this remaining-life %, a consumable is LOW for THIS rule
 	* (D642). Absent = {@link NC_CONSUMABLE_LOW_PERCENT_DEFAULT}; at most
 	* {@link NC_CONSUMABLE_LOW_PERCENT_MAX}, so every episode can recover. Scoped to the
@@ -70125,6 +71215,13 @@ var NcRuleInputSchema = object({
 	*/
 	groupingSec: number$1().int().min(5).max(60).optional(),
 	/**
+	* Hold deliveries of this rule to one target and, when two or more arrive
+	* before the window ends, send them as one summary. Absent = the kind's
+	* default (`groupWithinSecOf`): 5 s for a system-event rule, 0 for every
+	* other kind. `0` sends each delivery as it does today.
+	*/
+	groupWithinSec: number$1().int().min(0).max(300).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
@@ -70561,7 +71658,12 @@ var NcHistoryEntrySchema = object({
 	* Assistant export) must render as "no image right now", never as a
 	* broken link.
 	*/
-	artifactIds: array(string().min(1)).optional()
+	artifactIds: array(string().min(1)).optional(),
+	/**
+	* When this row was folded into a group-window summary, the outbox id of
+	* that one notification. Absent on a row that was sent as itself.
+	*/
+	groupedInto: string().min(1).optional()
 });
 /**
 * Query filter for `getHistory` (spec §4.2). Every field is a narrowing
@@ -71516,7 +72618,18 @@ var OauthIntegrationDescriptorSchema = object({
 	* The value is baked into the authorization code at `/authorize` and travels
 	* on the tokens, so editing this field changes FUTURE links only.
 	*/
-	refreshTokenTtlSec: union([number$1().int().positive(), literal("never")]).optional()
+	refreshTokenTtlSec: union([number$1().int().positive(), literal("never")]).optional(),
+	/**
+	* The integration instances an account can be linked to (planning#415),
+	* beside the default one. `/api/oauth2/authorize?instance=<id>` is accepted
+	* only for an id listed here; with no `instance=` the link is made to the
+	* default instance, which is never listed and always accepted — it is the
+	* address third parties already hold. Omit for a single-instance integration.
+	*/
+	instances: array(object({
+		id: string(),
+		displayName: string()
+	})).optional()
 });
 method(_void(), OauthIntegrationDescriptorSchema, { auth: "admin" });
 /**
@@ -71939,9 +73052,13 @@ var petFeederCapability = {
 	*/
 	durability: "session",
 	/**
-	* History (D850): recorded series.
+	* History (D850): recorded series. `feeding` / `eating` are the meals the
+	* device hero's "Meals" button names — change-only booleans, so a dispense
+	* or a pet at the bowl is one span on the history.
 	*/
 	history: { fields: {
+		feeding: { kind: "boolean" },
+		eating: { kind: "boolean" },
 		foodLevel: { kind: "gauge" },
 		bowlFood: { kind: "gauge" },
 		food1: { kind: "gauge" },
@@ -72002,6 +73119,11 @@ var petFountainCapability = {
 	deviceNative: true,
 	mode: "singleton",
 	deviceTypes: [DeviceType.PetFountain],
+	power: {
+		kind: "field",
+		field: "pumpRunning",
+		set: "setPump"
+	},
 	methods: { 
 	/** Start or stop the pump. */
 setPump: method(object({
@@ -73577,7 +74699,6 @@ var POWER_METER_DEVICE_TYPES = [
 	DeviceType.Light,
 	DeviceType.Fan,
 	DeviceType.Climate,
-	DeviceType.Thermostat,
 	DeviceType.Humidifier,
 	DeviceType.WaterHeater,
 	DeviceType.MediaPlayer,
@@ -73586,8 +74707,7 @@ var POWER_METER_DEVICE_TYPES = [
 	DeviceType.Dishwasher,
 	DeviceType.Vacuum,
 	DeviceType.LawnMower,
-	DeviceType.PetFeeder,
-	DeviceType.Heater
+	DeviceType.PetFeeder
 ];
 /** Everything but a bare `Sensor`: a sensor that takes its reading from another sensor adds nothing. */
 var POWER_METER_CUSTOMIZE_DEVICE_TYPES = POWER_METER_DEVICE_TYPES.filter((type) => type !== DeviceType.Sensor);
@@ -73700,118 +74820,6 @@ var powerMeterCapability = {
 	volatileStateFields: ["lastFetchedAt"],
 	customize: powerMeterCustomize
 };
-var PowerSourceRefusalReasonSchema = _enum([
-	"no-power-source",
-	"switch-missing",
-	"switch-offline",
-	"switch-unknown",
-	"restart-in-progress",
-	"switch-call-failed"
-]);
-var PowerSourceActionResultSchema = discriminatedUnion("accepted", [object({ accepted: literal(true) }), object({
-	accepted: literal(false),
-	reason: PowerSourceRefusalReasonSchema,
-	/** One line for the operator, naming the switch. */
-	message: string()
-})]);
-var PowerSourceInfoSchema = object({
-	/** False when the device has no power source linked; the rest is then empty. */
-	linked: boolean(),
-	switchDeviceId: number$1().nullable(),
-	switchName: string().nullable(),
-	/** The switch's on/off state, or null when it is unknown. Never false for unknown (D393). */
-	switchOn: boolean().nullable(),
-	switchOnline: boolean().nullable(),
-	restartInProgress: boolean(),
-	offSeconds: number$1().int()
-});
-/** The composed slice: the switch state the link mirrors, plus the stored off time. */
-var PowerSourceStateSchema = object({
-	/** Null while the switch has not reported: unknown is never `false` (D393). */
-	switchOn: boolean().nullable(),
-	offSeconds: number$1().int(),
-	lastFetchedAt: number$1()
-});
-var POWER_SOURCE_DEVICE_TYPES = [
-	DeviceType.Gateway,
-	DeviceType.Hub,
-	DeviceType.Camera,
-	DeviceType.Sensor,
-	DeviceType.MediaPlayer,
-	DeviceType.Vacuum,
-	DeviceType.Generic,
-	DeviceType.Washer,
-	DeviceType.Dryer,
-	DeviceType.Dishwasher,
-	DeviceType.PetFountain,
-	DeviceType.Fan,
-	DeviceType.Humidifier,
-	DeviceType.Climate,
-	DeviceType.WaterHeater
-];
-var powerSourceCustomize = {
-	version: 1,
-	targets: [{
-		id: "switch",
-		cardinality: "scalar",
-		vocabulary: {
-			cap: "power-source",
-			stateField: "switchOn"
-		},
-		deviceTypes: POWER_SOURCE_DEVICE_TYPES,
-		apply: "add",
-		path: "switchOn",
-		sources: [{
-			kind: "switch",
-			transforms: [{ kind: "identity" }]
-		}],
-		companions: [{
-			kind: "constant",
-			path: "offSeconds",
-			value: 10,
-			when: "add",
-			formerValues: [0]
-		}, {
-			kind: "clock",
-			path: "lastFetchedAt",
-			when: "always"
-		}],
-		sourceReport: { status: "assignment-status" }
-	}]
-};
-var deviceInput$1 = object({ deviceId: number$1().int().nonnegative() });
-var powerSourceCapability = {
-	name: "power-source",
-	scope: "device",
-	mode: "singleton",
-	deviceTypes: POWER_SOURCE_DEVICE_TYPES,
-	methods: {
-		getStatus: systemMethod(deviceInput$1, PowerSourceInfoSchema, { auth: "protected" }),
-		powerOn: systemMethod(deviceInput$1, PowerSourceActionResultSchema, {
-			kind: "mutation",
-			auth: "protected"
-		}),
-		powerOff: systemMethod(deviceInput$1, PowerSourceActionResultSchema, {
-			kind: "mutation",
-			auth: "protected"
-		}),
-		forceRestart: systemMethod(deviceInput$1, PowerSourceActionResultSchema, {
-			kind: "mutation",
-			auth: "protected"
-		})
-	},
-	runtimeState: PowerSourceStateSchema,
-	customize: powerSourceCustomize,
-	/**
-	* Runtime-state durability: **session** — mirrored from the linked switch on
-	* its next report; a restored value would outlive the reading it names.
-	*
-	* See `RuntimeStateDurability`. Enforced by
-	* `scripts/check-runtime-state-durability.ts`.
-	*/
-	durability: "session",
-	history: "none"
-};
 /**
 * Presence cap. Models HA `person.*` and `device_tracker.*` entities
 * on `DeviceType.Presence`. Read-only — no setters: presence is
@@ -77278,9 +78286,7 @@ var RUNNING_CUSTOMIZE_DEVICE_TYPES = [
 	DeviceType.Humidifier,
 	DeviceType.Fan,
 	DeviceType.Climate,
-	DeviceType.Thermostat,
-	DeviceType.PetFeeder,
-	DeviceType.Heater
+	DeviceType.PetFeeder
 ];
 var runningStateCapability = {
 	name: "running-state",
@@ -78552,6 +79558,13 @@ var SsoBridgeClaimsSchema = object({
 	/** OAuth authorization-code binding — set only on `oauth-code` tokens. */
 	redirectUri: string().optional(),
 	integrationId: string().optional(),
+	/**
+	* The integration INSTANCE an OAuth link was made for (planning#415). Set on
+	* `oauth-code`, `oauth-access` and `oauth-refresh` tokens of a link made
+	* with `instance=`; absent on a link to the default instance. A cloud relay
+	* reads it off the access token to route; the hub answers from the session.
+	*/
+	instanceId: string().optional(),
 	/** JWT ID — unique per issued code; consumed-set enforces single-use. */
 	jti: string().optional(),
 	/** PKCE S256 challenge — set only on `oauth-code` tokens issued to a public
@@ -79368,8 +80381,7 @@ var switchCapability = {
 		DeviceType.Switch,
 		DeviceType.Siren,
 		DeviceType.Light,
-		DeviceType.Fan,
-		DeviceType.Heater
+		DeviceType.Fan
 	],
 	methods: { setState: method(object({
 		deviceId: number$1(),
@@ -80063,7 +81075,7 @@ var temperatureSensorCapability = {
 	scope: "device",
 	deviceNative: true,
 	mode: "singleton",
-	deviceTypes: [DeviceType.Sensor, DeviceType.Thermostat],
+	deviceTypes: [DeviceType.Sensor, DeviceType.Climate],
 	methods: {},
 	status: {
 		schema: TemperatureSensorStatusSchema,
@@ -80931,6 +81943,8 @@ var OauthSessionSummarySchema = object({
 	userId: string(),
 	username: string(),
 	integrationId: string(),
+	/** The instance the link was made for; `null` = the default instance. */
+	instanceId: string().nullable().optional(),
 	scopes: array(TokenScopeSchema),
 	createdAt: number$1(),
 	lastUsedAt: number$1(),
@@ -81030,6 +82044,9 @@ method(_void(), array(UserSummarySchema), { auth: "admin" }), method(_void(), ob
 	access: "view"
 }), method(object({
 	integrationId: string(),
+	/** The integration instance the link is for. Omit for the default
+	*  instance — never pass the addon id to mean it. */
+	instanceId: string().optional(),
 	userId: string(),
 	username: string(),
 	scopes: array(TokenScopeSchema),
@@ -81068,7 +82085,13 @@ method(_void(), array(UserSummarySchema), { auth: "admin" }), method(_void(), ob
 }), method(object({ token: string() }), object({
 	userId: string(),
 	username: string(),
-	scopes: array(TokenScopeSchema)
+	scopes: array(TokenScopeSchema),
+	/** The instance the link was made for, read from the SESSION.
+	*  Absent = the default instance. `oauthLinkServesInstance` is the
+	*  helper a per-instance route calls to compare it with the instance
+	*  of its path; no route declares `perInstance` yet (the Alexa
+	*  per-instance route, T3, is the first consumer). */
+	instanceId: string().optional()
 }).nullable(), { access: "view" }), method(object({ userId: string() }), array(ExternalIdentitySchema), { auth: "admin" }), method(ExternalIdentityKeySchema, object({
 	userId: string(),
 	issuer: string()
@@ -81710,6 +82733,13 @@ var waterHeaterCapability = {
 	deviceNative: true,
 	mode: "singleton",
 	deviceTypes: [DeviceType.WaterHeater],
+	power: {
+		kind: "mode",
+		field: "operationMode",
+		offValue: "off",
+		set: "setOperationMode",
+		lastField: "lastActiveMode"
+	},
 	methods: {
 		setTargetTemp: method(object({
 			deviceId: number$1().int().nonnegative(),
@@ -83368,7 +84398,6 @@ var DEVICE_LOCAL_STATE_CAPS = {
 	control: controlCapability,
 	cover: coverCapability,
 	dayNight: dayNightCapability,
-	deviceDiscovery: deviceDiscoveryCapability,
 	deviceStatus: deviceStatusCapability,
 	dishwasher: dishwasherCapability,
 	doNotDisturb: doNotDisturbCapability,
@@ -84463,15 +85492,16 @@ var BaseDeviceProvider = class extends BaseAddon {
 		});
 		const meta = await this.ctx.api.deviceManager.loadMeta.query({ deviceId: id });
 		if (meta === null) throw new Error(`${this.providerName}: no persisted meta for "${stableId}" (id ${id}) — cannot reload`);
-		const deviceType = Object.values(DeviceType).find((t) => t === meta.type);
-		const Class = deviceType !== void 0 ? this.deviceClasses[deviceType] : void 0;
+		const Class = this.deviceClassForRow({
+			type: meta.type,
+			stableId
+		});
 		if (!Class) throw new Error(`${this.providerName}: no device class for type "${meta.type}" — "${stableId}" is an accessory child; reload its parent instead`);
 		await devices.create(stableId, Class, {}, meta.parentDeviceId ?? null);
 		const rows = await this.ctx.api.deviceManager.listPersistedByAddon.query({ addonId: this.addonId });
 		for (const row of rows) {
 			if (row.parentDeviceId !== id) continue;
-			const childType = Object.values(DeviceType).find((t) => t === row.type);
-			const ChildClass = childType !== void 0 ? this.deviceClasses[childType] : void 0;
+			const ChildClass = this.deviceClassForRow(row);
 			if (!ChildClass) continue;
 			try {
 				await devices.create(row.stableId, ChildClass, {}, id);
@@ -84498,6 +85528,16 @@ var BaseDeviceProvider = class extends BaseAddon {
 		return { deviceId: id };
 	}
 	/**
+	* The class a PERSISTED row is rebuilt with. Default: by type, from
+	* `deviceClasses`. A provider whose distinct devices share one type (D1033:
+	* a radiator valve and a room climate are both `climate`) overrides this
+	* and tells them apart by the row's stable id or config.
+	*/
+	deviceClassForRow(row) {
+		const type = Object.values(DeviceType).find((t) => t === row.type);
+		return type !== void 0 ? this.deviceClasses[type] : void 0;
+	}
+	/**
 	* Restore devices from persisted state. Two-pass:
 	*
 	* 1. **Top-level pass** — invokes `kernel.devices.create()` for every
@@ -84558,7 +85598,7 @@ var BaseDeviceProvider = class extends BaseAddon {
 				restored.add(saved.id);
 				return;
 			}
-			const Class = this.deviceClasses[saved.type];
+			const Class = this.deviceClassForRow(saved);
 			if (!Class) throw new Error(`no device class registered for type "${saved.type}"`);
 			if (saved.parentDeviceId !== null && !restored.has(saved.parentDeviceId)) throw new Error(`parent device ${saved.parentDeviceId} not restored`);
 			await this.healSavedConfig(saved, savedDevices);
@@ -84575,7 +85615,7 @@ var BaseDeviceProvider = class extends BaseAddon {
 		};
 		const topLevel = savedDevices.filter((saved) => saved.parentDeviceId === null);
 		const restoreOne = async (saved) => {
-			if (!this.deviceClasses[saved.type]) {
+			if (!this.deviceClassForRow(saved)) {
 				this.ctx.logger.warn("No device class registered for restored type — skipping", {
 					tags: {
 						deviceId: saved.id,
@@ -84614,7 +85654,7 @@ var BaseDeviceProvider = class extends BaseAddon {
 		const failedTopLevelIds = new Set(failures.map((failure) => failure.saved.id));
 		const childRows = savedDevices.filter((s) => s.parentDeviceId !== null);
 		for (const saved of childRows) {
-			if (!this.deviceClasses[saved.type]) continue;
+			if (!this.deviceClassForRow(saved)) continue;
 			if (saved.parentDeviceId === null) continue;
 			if (restored.has(saved.parentDeviceId)) {
 				try {
@@ -84668,7 +85708,9 @@ var BaseDeviceProvider = class extends BaseAddon {
 	}
 };
 DeviceType.HeatPump;
-DeviceType.Cover, DeviceType.Valve, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.HeatPump, 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.PetFountain, DeviceType.Heater, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Dryer, DeviceType.Gateway;
+DeviceType.Climate;
+DeviceRole.ClimateThermostat, DeviceRole.ClimateAc, DeviceRole.ClimateRadiator, DeviceRole.ClimateFloor, DeviceRole.ClimateHeater, DeviceRole.ClimateHeatPumpCircuit;
+DeviceType.Cover, DeviceType.Valve, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.HeatPump, DeviceType.Camera, DeviceType.Hub, DeviceType.Switch, DeviceType.Siren, DeviceType.Light, DeviceType.Fan, DeviceType.Sensor, 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.PetFountain, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Dryer, DeviceType.Gateway;
 new Set(Object.values(DeviceType));
 /** Parses the raw slice with the cap's own schema; `undefined` when it does not parse. */
 function contribution(cap, schema, build) {
@@ -86674,7 +87716,7 @@ var HEAT_PUMP_FAMILY_CONTRIBUTIONS = { "heat-pump-status": contribution("heat-pu
 	...Object.values(CLIMATE_FAMILY_CONTRIBUTIONS),
 	...Object.values(HEAT_PUMP_FAMILY_CONTRIBUTIONS)
 ];
-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.HeatPump, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.PetFountain, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Heater, DeviceType.Dryer, DeviceType.Gateway;
+DeviceType.Camera, DeviceType.Hub, DeviceType.Light, DeviceType.Siren, DeviceType.Switch, DeviceType.Sensor, 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.HeatPump, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.PetFountain, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Dryer, DeviceType.Gateway;
 /**
 * Who looks like what (D1023). One look per {@link DeviceType}, refined by a
 * {@link DeviceRole} where the role changes how the device reads (a leak
@@ -87318,9 +88360,9 @@ lookOf({
 	idle: INFO,
 	standby: MUTED
 });
-DeviceType.Climate, 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.HeatPump, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.PetFountain, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Heater, DeviceType.Dryer, DeviceType.Gateway;
-DeviceRole.Siren, DeviceRole.Floodlight, DeviceRole.Spotlight, DeviceRole.PirSensor, DeviceRole.Chime, DeviceRole.Autotrack, DeviceRole.Nightvision, DeviceRole.PrivacyMask, DeviceRole.Doorbell, DeviceRole.CoverBlind, DeviceRole.CoverShutter, DeviceRole.CoverAwning, DeviceRole.CoverCurtain, DeviceRole.CoverGarage, DeviceRole.CoverGate, DeviceRole.CoverDoor, DeviceRole.CoverWindow, DeviceRole.BinaryHelper, DeviceRole.Outlet, DeviceRole.MotionSensor, DeviceRole.ContactSensor, DeviceRole.LeakSensor, DeviceRole.SmokeSensor, DeviceRole.COSensor, DeviceRole.GasSensor, DeviceRole.TamperSensor, DeviceRole.VibrationSensor, DeviceRole.ConnectivitySensor, DeviceRole.SoundSensor, DeviceRole.BinarySensor, DeviceRole.TemperatureSensor, DeviceRole.HumiditySensor, DeviceRole.AmbientLightSensor, DeviceRole.PressureSensor, DeviceRole.WindSensor, DeviceRole.RainSensor, DeviceRole.UvSensor, DeviceRole.SolarRadiationSensor, DeviceRole.SoilMoistureSensor, DeviceRole.PowerSensor, DeviceRole.EnergySensor, DeviceRole.VoltageSensor, DeviceRole.CurrentSensor, DeviceRole.AirQualitySensor, DeviceRole.BatterySensor, DeviceRole.NumericSensor, DeviceRole.EnumSensor, DeviceRole.DateTimeSensor, DeviceRole.GenericSensor, DeviceRole.NumericControl, DeviceRole.SelectControl, DeviceRole.TextControl, DeviceRole.DateTimeControl, DeviceRole.MobilePushNotifier, DeviceRole.MessagingNotifier, DeviceRole.EmailNotifier, DeviceRole.GenericNotifier, DeviceRole.IrTransmitter;
+DeviceType.Climate;
+DeviceType.Camera, DeviceType.Hub, DeviceType.Light, DeviceType.Siren, DeviceType.Switch, DeviceType.Sensor, 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.HeatPump, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.PetFountain, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Dryer, DeviceType.Gateway;
+DeviceRole.Siren, DeviceRole.Floodlight, DeviceRole.Spotlight, DeviceRole.PirSensor, DeviceRole.Chime, DeviceRole.Autotrack, DeviceRole.Nightvision, DeviceRole.PrivacyMask, DeviceRole.Doorbell, DeviceRole.CoverBlind, DeviceRole.CoverShutter, DeviceRole.CoverAwning, DeviceRole.CoverCurtain, DeviceRole.CoverGarage, DeviceRole.CoverGate, DeviceRole.CoverDoor, DeviceRole.CoverWindow, DeviceRole.BinaryHelper, DeviceRole.Outlet, DeviceRole.SwitchHeater, DeviceRole.SwitchFan, DeviceRole.ClimateAc, DeviceRole.ClimateThermostat, DeviceRole.ClimateFloor, DeviceRole.ClimateRadiator, DeviceRole.ClimateHeater, DeviceRole.ClimateHeatPumpCircuit, DeviceRole.MotionSensor, DeviceRole.ContactSensor, DeviceRole.LeakSensor, DeviceRole.SmokeSensor, DeviceRole.COSensor, DeviceRole.GasSensor, DeviceRole.TamperSensor, DeviceRole.VibrationSensor, DeviceRole.ConnectivitySensor, DeviceRole.SoundSensor, DeviceRole.BinarySensor, DeviceRole.TemperatureSensor, DeviceRole.HumiditySensor, DeviceRole.AmbientLightSensor, DeviceRole.PressureSensor, DeviceRole.WindSensor, DeviceRole.RainSensor, DeviceRole.UvSensor, DeviceRole.SolarRadiationSensor, DeviceRole.SoilMoistureSensor, DeviceRole.PowerSensor, DeviceRole.EnergySensor, DeviceRole.VoltageSensor, DeviceRole.CurrentSensor, DeviceRole.AirQualitySensor, DeviceRole.BatterySensor, DeviceRole.NumericSensor, DeviceRole.EnumSensor, DeviceRole.DateTimeSensor, DeviceRole.GenericSensor, DeviceRole.NumericControl, DeviceRole.SelectControl, DeviceRole.TextControl, DeviceRole.DateTimeControl, DeviceRole.MobilePushNotifier, DeviceRole.MessagingNotifier, DeviceRole.EmailNotifier, DeviceRole.GenericNotifier, DeviceRole.IrTransmitter;
 Object.freeze({
 	"accessories.getStatus": {
 		capName: "accessories",
@@ -89170,41 +90212,6 @@ Object.freeze({
 		access: "create",
 		role: "admin"
 	},
-	"deviceDiscovery.adoptDevice": {
-		capName: "device-discovery",
-		capScope: "device",
-		addonId: null,
-		access: "create",
-		role: "admin"
-	},
-	"deviceDiscovery.getStatus": {
-		capName: "device-discovery",
-		capScope: "device",
-		addonId: null,
-		access: "view",
-		role: "viewer"
-	},
-	"deviceDiscovery.listDiscovered": {
-		capName: "device-discovery",
-		capScope: "device",
-		addonId: null,
-		access: "view",
-		role: "viewer"
-	},
-	"deviceDiscovery.refreshDiscovery": {
-		capName: "device-discovery",
-		capScope: "device",
-		addonId: null,
-		access: "create",
-		role: "admin"
-	},
-	"deviceDiscovery.releaseDevice": {
-		capName: "device-discovery",
-		capScope: "device",
-		addonId: null,
-		access: "create",
-		role: "admin"
-	},
 	"deviceExport.applyDeviceSettingsPatch": {
 		capName: "device-export",
 		capScope: "system",
@@ -90752,6 +91759,13 @@ Object.freeze({
 		access: "create",
 		role: "viewer"
 	},
+	"fanControl.setOscillationAxis": {
+		capName: "fan-control",
+		capScope: "device",
+		addonId: null,
+		access: "create",
+		role: "viewer"
+	},
 	"fanControl.setPercentage": {
 		capName: "fan-control",
 		capScope: "device",
@@ -91214,6 +92228,13 @@ Object.freeze({
 		access: "view",
 		role: "viewer"
 	},
+	"irTransmitter.learn": {
+		capName: "ir-transmitter",
+		capScope: "device",
+		addonId: null,
+		access: "create",
+		role: "viewer"
+	},
 	"irTransmitter.send": {
 		capName: "ir-transmitter",
 		capScope: "device",
@@ -97773,7 +98794,7 @@ 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.HeatPump, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.PetFountain, DeviceType.Heater, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Dryer, DeviceType.Gateway;
+DeviceType.Camera, DeviceType.Hub, DeviceType.Light, DeviceType.Siren, DeviceType.Switch, DeviceType.Sensor, 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.HeatPump, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.PetFountain, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Dryer, DeviceType.Gateway;
 DeviceFeature.BatteryOperated;
 function bound(cap, methods = [], authority = "reported") {
 	return {
@@ -98262,35 +99283,6 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
-	"deviceDiscovery.adoptDevice": [{
-		name: "deviceId",
-		form: "single",
-		optional: false
-	}],
-	"deviceDiscovery.getStatus": [{
-		name: "deviceId",
-		form: "single",
-		optional: false
-	}],
-	"deviceDiscovery.listDiscovered": [{
-		name: "deviceId",
-		form: "single",
-		optional: false
-	}],
-	"deviceDiscovery.refreshDiscovery": [{
-		name: "deviceId",
-		form: "single",
-		optional: false
-	}],
-	"deviceDiscovery.releaseDevice": [{
-		name: "childDeviceId",
-		form: "single",
-		optional: false
-	}, {
-		name: "deviceId",
-		form: "single",
-		optional: false
-	}],
 	"deviceExport.applyDeviceSettingsPatch": [{
 		name: "deviceId",
 		form: "single",
@@ -98854,6 +99846,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"fanControl.setOscillationAxis": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"fanControl.setPercentage": [{
 		name: "deviceId",
 		form: "single",
@@ -99089,6 +100086,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"irTransmitter.learn": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"irTransmitter.send": [{
 		name: "deviceId",
 		form: "single",
@@ -101028,7 +102030,10 @@ var NC_SYSTEM_EVENT_FILTER_KEYS = [
 	"deviceTypes",
 	"nodeIds",
 	"packageNames",
-	"consumableLowPercent"
+	"consumableLowPercent",
+	"commandActions",
+	"commandOutcomes",
+	"commandActorKinds"
 ];
 new Map(Object.entries({
 	"device-online": "device-events",
@@ -101051,6 +102056,7 @@ new Map(Object.entries({
 	"recording-degraded": "device-events",
 	"device-attention-required": "device-events",
 	"device-attention-resolved": "device-events",
+	"device-command": "device-events",
 	"node-online": "system",
 	"node-offline": "system",
 	"node-restarting": "system",
@@ -101151,6 +102157,12 @@ var NC_SYSTEM_EVENT_KIND_GROUP_SPECS = [
 		label: "Needs attention",
 		kinds: ["device-attention-required", "device-attention-resolved"]
 	},
+	{
+		id: "device-command",
+		family: "device-events",
+		label: "Commands given to devices",
+		kinds: ["device-command"]
+	},
 	{
 		id: "nodes",
 		family: "system",
@@ -101423,6 +102435,7 @@ var DEVICE_EVENTS = [
 	"recording-healthy",
 	"recording-degraded",
 	...DEVICE_ATTENTION,
+	"device-command",
 	...ALARM
 ];
 /** Every kind a summary may speak about — the two summarisable families. */
@@ -101576,6 +102589,9 @@ var STATE_SUMMARY_VARS = [
 	[...RULE_BODY_ONLY],
 	[...RULE_TEXT],
 	([...RULE_TEXT], [...DEVICE_EVENTS]),
+	[...RULE_TEXT],
+	[...RULE_TEXT],
+	([...RULE_TEXT], [...DEVICE_EVENTS]),
 	([...RULE_TEXT], [...COMBINED_ALARM]),
 	([...RULE_TEXT], [...COMBINED_ALARM]),
 	([...RULE_TEXT], [...DEVICE_EVENTS]),
@@ -102328,6 +103344,27 @@ function ingestReading(input) {
 		value: converted
 	};
 }
+function collapse(value) {
+	return value.trim().replace(/\s+/g, " ");
+}
+/** "KLF-200" → "KLF200". A hyphen between words ("Home Hub") stays. */
+function compactModelToken(value) {
+	return value.replace(/([A-Za-z])-(\d)/g, "$1$2");
+}
+/**
+* A Gateway device: "<Brand> <Model>". An unknown model is the brand alone
+* (the caller passes the brand-level fallback it already has, e.g. "Velux KLF-200").
+*/
+function gatewayDeviceName(brand, model) {
+	const brandPart = compactModelToken(collapse(brand));
+	const raw = collapse(model ?? "");
+	if (raw.length === 0) return brandPart;
+	const modelPart = compactModelToken(raw);
+	const prefix = `${brandPart.toLowerCase()} `;
+	if (modelPart.toLowerCase() === brandPart.toLowerCase()) return brandPart;
+	if (modelPart.toLowerCase().startsWith(prefix)) return modelPart;
+	return `${brandPart} ${modelPart}`;
+}
 /**
 * Closes the gap D49 leaves: an integration deleted while its provider was down never emits an
 * event the provider sees. An integration id absent from an ANSWERED list is only a suspect; its
@@ -103714,7 +104751,7 @@ function buildEnpalCandidates(input) {
 	const boxChildren = box === void 0 ? [] : reportedChildren(box, snapshot);
 	const out = [{
 		childNativeId: "box",
-		name: input.box.name,
+		name: gatewayDeviceName("Enpal", "Box"),
 		type: DeviceType.Gateway,
 		status: input.box.online ? "online" : "offline",
 		metadata: METADATA,
@@ -103838,7 +104875,7 @@ function buildEnpalAdoptionProvider(deps) {
 					const specIds = reportedSpecIds(equipment, candidate);
 					const { deviceId, accessoryDeviceIds } = await deps.adoptGateway({
 						integrationId,
-						name: perCandidate?.[equipmentId]?.name ?? boxName(integrationId),
+						name: perCandidate?.[equipmentId]?.name ?? gatewayDeviceName("Enpal", "Box"),
 						specIds,
 						childLayout: childLayoutOf(equipment, specIds)
 					});
@@ -104637,7 +105674,39 @@ var enpalConnectionsEntryKind = defineEntryKind("connections", {
 });
 /** Every kind this addon declares, keyed by its name. */
 var enpalRecordKinds = { connections: enpalConnectionsEntryKind };
+var REJECTED_KINDS = new Set([
+	"unauthorized",
+	"token-missing",
+	"empty"
+]);
+function connectionForTest(values) {
+	const host = values["host"];
+	if (typeof host !== "string" || host.trim().length === 0) return null;
+	const parsed = enpalConnectionSchema.safeParse({ ...values });
+	return parsed.success ? parsed.data : null;
+}
+function testFailure(error) {
+	if (error instanceof EnpalError) return {
+		success: false,
+		status: REJECTED_KINDS.has(error.kind) ? "rejected" : "inconclusive",
+		error: error.message
+	};
+	return {
+		success: false,
+		status: "inconclusive",
+		error: "The Enpal box did not answer"
+	};
+}
+function liveProbe(blazor) {
+	return (connection) => readEnpalSnapshot({
+		connection,
+		fetch: globalThis.fetch,
+		now: () => Date.now(),
+		blazor: blazor?.()
+	});
+}
 function buildEnpalInstances(records, deps) {
+	const probe = deps.probe ?? liveProbe(deps.blazor);
 	return new RecordIntegrationInstances(records, enpalConnectionsEntryKind, {
 		description: {
 			role: "devices",
@@ -104647,18 +105716,36 @@ function buildEnpalInstances(records, deps) {
 			},
 			instanceMode: "multiple",
 			kind: "server",
-			canTest: false,
+			canTest: true,
 			kinds: [{
 				id: "connection",
 				label: "Enpal",
 				functionCap: "device-provider",
-				role: "devices"
+				role: "devices",
+				canTest: true
 			}]
 		},
 		formSchema: () => buildConnectionFormSchema(),
 		initialBody: (name) => ({ name }),
 		configured: (body) => (body.host ?? "").length > 0,
-		onChanged: () => deps.onChanged()
+		onChanged: () => deps.onChanged(),
+		test: async ({ values }) => {
+			const connection = connectionForTest(values);
+			if (connection === null) return {
+				success: false,
+				status: "rejected",
+				error: "Host is required"
+			};
+			try {
+				await probe(connection);
+				return {
+					success: true,
+					status: "validated"
+				};
+			} catch (error) {
+				return testFailure(error);
+			}
+		}
 	});
 }
 /**
@@ -104951,7 +106038,10 @@ var EnpalProviderAddon = class extends BaseDeviceProvider {
 			...rowsDepsOver(api),
 			kind: enpalConnectionsEntryKind
 		}));
-		this.instances = buildEnpalInstances(records, { onChanged: () => this.reconcileIntegrations() });
+		this.instances = buildEnpalInstances(records, {
+			onChanged: () => this.reconcileIntegrations(),
+			blazor: () => this.blazorReader ?? void 0
+		});
 		this.blazorReader = await this.createBlazorBridge();
 		this.clients = new EnpalClientRegistry(this.ctx.logger, {
 			blazor: () => this.blazorReader ?? void 0,