@camstack/addon-provider-bosch 0.1.51 → 0.1.53

package/dist/{bosch-instances-CYBnIcHg.js → bosch-instances-dqTG9no9.js}

@@ -802,7 +802,7 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	return EventCategory;
 }({});
 //#endregion
-//#region ../types/dist/composed-stable-id-DFNyOFzz.mjs
+//#region ../types/dist/composed-stable-id-CPp3votu.mjs
 /**
 import { errMsg } from '@camstack/types'
 * Extract a human-readable message from an unknown error value.
@@ -821,12 +821,12 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
 	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
@@ -917,10 +917,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
@@ -1140,6 +1136,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. */
@@ -6027,7 +6044,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-D_NpiLFP.mjs
+//#region ../types/dist/sleep-D0roI_CZ.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -11804,6 +11821,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: [{
@@ -16181,6 +16242,10 @@ Object.freeze({
 			"path": "lastEvent.eventType",
 			"valueType": "string"
 		},
+		{
+			"path": "lastEvent.sourceId",
+			"valueType": "string"
+		},
 		{
 			"path": "lastEvent.timestamp",
 			"valueType": "number"
@@ -17444,7 +17509,7 @@ Object.freeze({
 	}
 });
 //#endregion
-//#region ../types/dist/implemented-methods-M5aguGon.mjs
+//#region ../types/dist/implemented-methods-5YMDeE3f.mjs
 /**
 * The ffmpeg build every CamStack node downloads, per platform and arch.
 *
@@ -44153,6 +44218,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
@@ -44160,6 +44232,7 @@ var AutomationConditionOperatorSchema = _enum([
 */
 var DeviceBecomesLeafSchema = object({
 	kind: literal("device-becomes"),
+	...eventLeafId,
 	deviceId: number$1().int().nonnegative(),
 	cap: string().min(1),
 	fieldPath: string().min(1),
@@ -44212,6 +44285,7 @@ var DeviceBecomesLeafSchema = object({
 });
 var DeviceEventLeafSchema = object({
 	kind: literal("device-event"),
+	...eventLeafId,
 	/** An `EventCategory` value. */
 	category: string().min(1),
 	deviceId: number$1().int().nonnegative().optional()
@@ -44224,18 +44298,24 @@ 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") });
+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),
@@ -44246,6 +44326,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(),
@@ -44291,6 +44372,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.
@@ -44336,7 +44452,9 @@ var AutomationWhenSchema = lazy(() => discriminatedUnion("kind", [
 	StationaryLeafSchema,
 	DeviceIsLeafSchema,
 	StationaryPresentLeafSchema,
-	ExpressionLeafSchema
+	ExpressionLeafSchema,
+	TimeIsLeafSchema,
+	TriggeredByLeafSchema
 ]));
 var EVENT_KINDS = new Set([
 	"device-becomes",
@@ -44390,6 +44508,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);
@@ -44448,6 +44588,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;
@@ -44659,9 +44804,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([
@@ -44731,28 +44879,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
@@ -44815,11 +45162,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",
@@ -44835,6 +45177,11 @@ 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"
+};
 function describe$1(descriptions) {
 	return Object.entries(descriptions).map(([name, description]) => ({
 		name,
@@ -44843,6 +45190,10 @@ function describe$1(descriptions) {
 }
 describe$1(DETECTION_DESCRIPTIONS);
 describe$1(STATIONARY_DESCRIPTIONS);
+describe$1(BECOMES_DESCRIPTIONS).map((v) => v.name === "deviceId" ? {
+	...v,
+	hintKey: "becomesDeviceId"
+} : v);
 new Set(Object.values(COCO_TO_MACRO.mapping));
 /**
 * Schedulers (D983) — an entity that performs actions over the day.
@@ -44867,6 +45218,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",
@@ -44888,12 +45246,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`. */
@@ -45087,6 +45449,8 @@ var AutomationConditionTraceNodeSchema = object({
 		"device-is",
 		"expression",
 		"stationary-present",
+		"time-is",
+		"triggered-by",
 		"device-becomes",
 		"device-event",
 		"schedule",
@@ -45159,18 +45523,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(),
@@ -45420,7 +45812,7 @@ object({
 	*  is irrelevant; the array is treated as a set by consumers. */
 	hiddenChildIds: array(number$1()).readonly()
 });
-DeviceType.Camera, 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()
@@ -45577,7 +45969,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
@@ -45594,6 +45988,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(),
@@ -47718,7 +48114,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). */
@@ -49481,7 +49877,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(),
@@ -49866,6 +50269,7 @@ var CompositionProblemSchema = object({
 		"nested-field",
 		"missing-field",
 		"kind-mismatch",
+		"source-kind-mismatch",
 		"may-be-null",
 		"source-missing",
 		"source-unreadable",
@@ -49887,7 +50291,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()
@@ -50925,6 +51330,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",
@@ -51055,7 +51467,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.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 = {
 	kind: "fixed",
 	result: ["number"]
@@ -51138,7 +51550,7 @@ function numeric(input) {
 		}, ...alsoFrom === void 0 ? [] : [alsoFrom.accept]]
 	};
 }
-var CLIMATE_DEVICES = [DeviceType.Thermostat, DeviceType.Climate];
+var CLIMATE_DEVICES = [DeviceType.Climate];
 function binary(input) {
 	return {
 		...input,
@@ -51460,8 +51872,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: {
@@ -51504,6 +51916,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
@@ -54038,8 +54562,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()
@@ -56131,25 +56661,81 @@ var enumSensorCapability = {
 	*  whether persisting is worth a SQLite commit. */
 	volatileStateFields: ["lastFetchedAt", "timestamp"]
 };
+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()
+});
+/**
+* The vocabulary of a source that declares tokens and nothing else: one
+* entry per token, labelled with the token itself.
+*/
+function plainEventVocabulary(eventTypes) {
+	return [...new Set(eventTypes)].filter((eventType) => eventType !== "").map((eventType) => ({
+		id: eventType,
+		label: eventType
+	}));
+}
 /**
 * 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`
+*  - 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"))
 });
@@ -56667,8 +57253,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). */
@@ -56687,9 +57350,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",
@@ -56724,6 +57480,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: {
@@ -56735,6 +57503,7 @@ var fanControlCapability = {
 	* sliders read `speed` for live updates.
 	*/
 	runtimeState: FanControlStatusSchema,
+	customize: fanControlCustomize,
 	/**
 	* Runtime-state durability: **session** — as `brightness`.
 	*
@@ -56754,16 +57523,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",
@@ -56775,72 +57561,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:
@@ -57052,8 +57821,7 @@ var groupActiveCapability = {
 		DeviceType.Valve,
 		DeviceType.Lock,
 		DeviceType.MediaPlayer,
-		DeviceType.Climate,
-		DeviceType.Thermostat
+		DeviceType.Climate
 	],
 	methods: {},
 	status: {
@@ -57095,7 +57863,6 @@ var groupCommandsCapability = {
 		DeviceType.Valve,
 		DeviceType.Lock,
 		DeviceType.MediaPlayer,
-		DeviceType.Thermostat,
 		DeviceType.Climate
 	],
 	methods: {},
@@ -57151,7 +57918,6 @@ var groupStatusCapability = {
 		DeviceType.Valve,
 		DeviceType.Lock,
 		DeviceType.MediaPlayer,
-		DeviceType.Thermostat,
 		DeviceType.Climate
 	],
 	methods: {},
@@ -57507,7 +58273,7 @@ var heatingValveCapability = {
 	scope: "device",
 	deviceNative: true,
 	mode: "singleton",
-	deviceTypes: [DeviceType.Thermostat],
+	deviceTypes: [DeviceType.Climate],
 	methods: {},
 	status: {
 		schema: HeatingValveStatusSchema,
@@ -57537,13 +58303,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(),
@@ -57593,6 +58364,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",
@@ -57753,8 +58525,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(),
@@ -58139,8 +58911,8 @@ var HeroRowModelSchema = object({
 	extras: array(HeroControlSchema).max(2).optional(),
 	trailing: HeroFactSchema.nullable()
 });
-DeviceType.Climate, DeviceType.Thermostat;
-DeviceType.Climate, DeviceType.Thermostat, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer;
+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.
@@ -58172,7 +58944,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"
 });
@@ -58219,6 +58994,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(),
@@ -58292,7 +59072,7 @@ var humiditySensorCapability = {
 	scope: "device",
 	deviceNative: true,
 	mode: "singleton",
-	deviceTypes: [DeviceType.Sensor, DeviceType.Thermostat],
+	deviceTypes: [DeviceType.Sensor, DeviceType.Climate],
 	methods: {},
 	status: {
 		schema: HumiditySensorStatusSchema,
@@ -71474,7 +72254,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" });
 /**
@@ -71964,6 +72755,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({
@@ -73539,7 +74335,6 @@ var POWER_METER_DEVICE_TYPES = [
 	DeviceType.Light,
 	DeviceType.Fan,
 	DeviceType.Climate,
-	DeviceType.Thermostat,
 	DeviceType.Humidifier,
 	DeviceType.WaterHeater,
 	DeviceType.MediaPlayer,
@@ -73548,8 +74343,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);
@@ -73662,117 +74456,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.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
@@ -77247,9 +77930,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",
@@ -78521,6 +79202,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
@@ -79337,8 +80025,7 @@ var switchCapability = {
 		DeviceType.Switch,
 		DeviceType.Siren,
 		DeviceType.Light,
-		DeviceType.Fan,
-		DeviceType.Heater
+		DeviceType.Fan
 	],
 	methods: { setState: method(object({
 		deviceId: number$1(),
@@ -80032,7 +80719,7 @@ var temperatureSensorCapability = {
 	scope: "device",
 	deviceNative: true,
 	mode: "singleton",
-	deviceTypes: [DeviceType.Sensor, DeviceType.Thermostat],
+	deviceTypes: [DeviceType.Sensor, DeviceType.Climate],
 	methods: {},
 	status: {
 		schema: TemperatureSensorStatusSchema,
@@ -80900,6 +81587,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(),
@@ -80999,6 +81688,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),
@@ -81037,7 +81729,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()
@@ -81679,6 +82377,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(),
@@ -84370,15 +85075,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);
@@ -84405,6 +85111,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
@@ -84465,7 +85181,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);
@@ -84482,7 +85198,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,
@@ -84521,7 +85237,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 {
@@ -84575,7 +85291,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) {
@@ -86581,7 +87299,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
@@ -87225,9 +87943,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",
@@ -90624,6 +91342,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",
@@ -97645,7 +98370,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 {
@@ -97704,6 +98429,149 @@ function offered(received) {
 	};
 }
 offered(HA_AS), withheld(HOMEKIT_REASON), withheld(ALEXA_REASON), withheld(GOOGLE_REASON), withheld(MATTER_REASON);
+var PowerSwitchRefusedError = class extends Error {
+	reason;
+	constructor(reason, message) {
+		super(message);
+		this.name = "PowerSwitchRefusedError";
+		this.reason = reason;
+	}
+};
+/** `true` / `false` from the owner slice, `null` when the hinted field is
+*  absent or not of the hinted shape. */
+function powerOnFromSlice(hint, slice) {
+	const value = slice?.[hint.field];
+	switch (hint.kind) {
+		case "field": return typeof value === "boolean" ? value : null;
+		case "methods": return typeof value === "string" ? !hint.offValues.includes(value) : null;
+		case "mode": return typeof value === "string" ? value !== hint.offValue : null;
+	}
+}
+function ownerMethod(owner, name, capName) {
+	const fn = Reflect.get(owner, name);
+	if (typeof fn !== "function") throw new PowerSwitchRefusedError("owner-method-missing", `${capName} provider does not serve '${name}', which its power hint names`);
+	return async (input) => fn.call(owner, input);
+}
+async function lastNonOffMode(host, capName, hint) {
+	const isMode = (v) => typeof v === "string" && v.length > 0 && v !== hint.offValue;
+	const fromHub = (await host.readHubSlice(capName).catch(() => null))?.[hint.lastField];
+	if (isMode(fromHub)) return fromHub;
+	const local = host.runtimeState.getCapState(capName)?.[hint.lastField];
+	return isMode(local) ? local : null;
+}
+async function applyPower(host, capName, hint, owner, on) {
+	const deviceId = host.deviceId;
+	switch (hint.kind) {
+		case "field":
+			await ownerMethod(owner, hint.set, capName)({
+				deviceId,
+				on
+			});
+			return;
+		case "methods":
+			await ownerMethod(owner, on ? hint.on : hint.off, capName)({ deviceId });
+			return;
+		case "mode": {
+			const set = ownerMethod(owner, hint.set, capName);
+			if (!on) {
+				await set({
+					deviceId,
+					mode: hint.offValue
+				});
+				return;
+			}
+			const mode = await lastNonOffMode(host, capName, hint);
+			if (mode === null) throw new PowerSwitchRefusedError("no-last-mode", `device ${deviceId}: ${capName} has no last non-off mode to restore; pick a mode instead`);
+			await set({
+				deviceId,
+				mode
+			});
+			return;
+		}
+	}
+}
+function hintedMethods(hint) {
+	return hint.kind === "methods" ? [hint.on, hint.off] : [hint.set];
+}
+/** Whether `owner` serves every method its cap's power hint names. A media
+*  player whose `turnOn` / `turnOff` are not served has no power, so no switch. */
+function powerServedBy(hint, owner) {
+	if (hint === void 0) return false;
+	return hintedMethods(hint).every((name) => typeof Reflect.get(owner, name) === "function");
+}
+/** Builds the `switch` provider and starts the slice projection. Exported
+*  for the specs; providers call `registerPowerSwitch`. */
+function buildPowerSwitch(host, cap, owner) {
+	const hint = cap.power;
+	if (hint === void 0) throw new Error(`capability '${cap.name}' has no power hint: it has no switch to project`);
+	const read = () => powerOnFromSlice(hint, host.runtimeState.getCapState(cap.name));
+	const project = () => {
+		const on = read();
+		const current = host.runtimeState.getCapState(switchCapability.name);
+		if (current !== void 0 && current["on"] === on) return;
+		const next = {
+			on,
+			lastChangedAt: Date.now()
+		};
+		host.runtimeState.setCapState(switchCapability.name, next);
+	};
+	const stop = host.runtimeState.subscribeCap(cap.name, project);
+	if (host.runtimeState.getCapState(cap.name) !== void 0) project();
+	return {
+		provider: {
+			getStatus: async () => {
+				const current = host.runtimeState.getCapState(switchCapability.name);
+				const lastChangedAt = typeof current?.["lastChangedAt"] === "number" ? current["lastChangedAt"] : 0;
+				return {
+					on: read(),
+					lastChangedAt
+				};
+			},
+			setState: async ({ on }) => applyPower(host, cap.name, hint, owner, on)
+		},
+		dispose: stop
+	};
+}
+/**
+* Registers `switch` for a device whose `cap` carries a `power` hint, built
+* from `owner` (the provider the device registered for `cap`). Call it right
+* after `registerNativeCap(cap, owner)`.
+*/
+function registerPowerSwitch(device, cap, owner) {
+	const deviceId = device.ctx.id;
+	if (cap.power !== void 0 && !powerServedBy(cap.power, owner)) {
+		device.ctx.logger.debug("power switch: owner serves no power control, no switch registered", {
+			tags: { deviceId },
+			meta: { capName: cap.name }
+		});
+		return () => {};
+	}
+	const host = {
+		deviceId,
+		runtimeState: device.runtimeState,
+		registerNativeCap: (c, p) => device.ctx.registerNativeCap(c, p),
+		readHubSlice: async (capName) => {
+			try {
+				return await device.ctx.api.deviceState.getCapSlice.query({
+					deviceId,
+					capName
+				});
+			} catch (err) {
+				device.ctx.logger.warn("power switch: hub slice read failed", {
+					tags: { deviceId },
+					meta: {
+						capName,
+						error: err instanceof Error ? err.message : String(err)
+					}
+				});
+				return null;
+			}
+		}
+	};
+	const built = buildPowerSwitch(host, cap, owner);
+	host.registerNativeCap(switchCapability, built.provider);
+	return built.dispose;
+}
 Object.freeze({
 	"accessories.getStatus": [{
 		name: "deviceId",
@@ -98697,6 +99565,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"fanControl.setOscillationAxis": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"fanControl.setPercentage": [{
 		name: "deviceId",
 		form: "single",
@@ -102566,6 +103439,12 @@ Object.defineProperty(exports, "object", {
 		return object;
 	}
 });
+Object.defineProperty(exports, "plainEventVocabulary", {
+	enumerable: true,
+	get: function() {
+		return plainEventVocabulary;
+	}
+});
 Object.defineProperty(exports, "powerMeterCapability", {
 	enumerable: true,
 	get: function() {
@@ -102584,6 +103463,12 @@ Object.defineProperty(exports, "record", {
 		return record;
 	}
 });
+Object.defineProperty(exports, "registerPowerSwitch", {
+	enumerable: true,
+	get: function() {
+		return registerPowerSwitch;
+	}
+});
 Object.defineProperty(exports, "rowsDepsOver", {
 	enumerable: true,
 	get: function() {