@camstack/addon-import-alexa 0.2.179 → 0.2.181

package/dist/addon.mjs

@@ -832,7 +832,7 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	return EventCategory;
 }({});
 //#endregion
-//#region ../types/dist/device-type-CfHw_quR.mjs
+//#region ../types/dist/device-type-D1fH5kaC.mjs
 /**
 import { errMsg } from '@camstack/types'
 * Extract a human-readable message from an unknown error value.
@@ -1063,6 +1063,12 @@ var DeviceFeature = /* @__PURE__ */ function(DeviceFeature) {
 	DeviceFeature["MediaPlayerPrevious"] = "media-player-previous";
 	/** Media player exposes stop distinct from pause. */
 	DeviceFeature["MediaPlayerStop"] = "media-player-stop";
+	/** Media player exposes volume up / down in steps (an infrared TV has no level). */
+	DeviceFeature["MediaPlayerVolumeStep"] = "media-player-volume-step";
+	/** Media player exposes channel up / down in steps. */
+	DeviceFeature["MediaPlayerChannelStep"] = "media-player-channel-step";
+	/** Media player exposes power on / off. */
+	DeviceFeature["MediaPlayerPower"] = "media-player-power";
 	/** Alarm panel requires a PIN code on arm/disarm. */
 	DeviceFeature["AlarmPinRequired"] = "alarm-pin-required";
 	/** Presence device carries GPS coordinates (lat/lng/accuracy) in
@@ -6036,7 +6042,7 @@ function number(params) {
 	return /* @__PURE__ */ _coercedNumber(ZodNumber, params);
 }
 //#endregion
-//#region ../types/dist/sleep-hmSP-eJt.mjs
+//#region ../types/dist/sleep-DV4qxEyD.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -6115,6 +6121,22 @@ function buildAlawTable() {
 }
 buildUlawTable();
 buildAlawTable();
+/**
+* An addon whose own migrations did not apply refuses to initialise (D987). The error is typed
+* so a runner hosting several addons can tell "this addon is blocked" from a crash and keep its
+* co-located siblings running. Recognised by NAME and shape, never `instanceof`: a forked addon
+* bundles its own copy of this module, so the class the runner sees is not the one that threw.
+*/
+var MIGRATIONS_BLOCKED_ERROR_NAME = "AddonMigrationsBlockedError";
+var AddonMigrationsBlockedError = class extends Error {
+	/** The ledger ids that did not apply and block the owner. */
+	migrationIds;
+	constructor(migrationIds) {
+		super(`migration(s) ${migrationIds.join(", ")} did not apply and block this addon — fix or retry them (migrations.retry), then restart it`);
+		this.name = MIGRATIONS_BLOCKED_ERROR_NAME;
+		this.migrationIds = migrationIds;
+	}
+};
 /** Is this field's stored value a credential? */
 function isSecretConfigField(field) {
 	if (field.type === "password") return true;
@@ -7768,7 +7790,7 @@ var BaseAddon = class {
 			startMigration: (input) => api.startMigration.mutate(input),
 			finishMigration: (input) => api.finishMigration.mutate(input)
 		}, migrations, this.ctx.logger);
-		if (report.blockOwner.length > 0) throw new Error(`migration(s) ${report.blockOwner.join(", ")} did not apply and block this addon — fix or retry them (migrations.retry), then restart it`);
+		if (report.blockOwner.length > 0) throw new AddonMigrationsBlockedError(report.blockOwner);
 		return report;
 	}
 	/**
@@ -8108,6 +8130,10 @@ var BaseAddon = class {
 		const stored = keychain ? await this.readAddonStoreWithRetry() : {};
 		const patch = {};
 		for (const key of keys) {
+			if (tree.get(key)?.kind === "array") {
+				patch[key] = [];
+				continue;
+			}
 			const keychainStored = tree.has(key) || collectSecretMarkerRefs(stored[key]).length > 0;
 			patch[key] = keychain && keychainStored ? SECRET_CLEAR : "";
 		}
@@ -11764,7 +11790,7 @@ object({
 	params: record(string(), union([string(), number$1()])).optional()
 });
 //#endregion
-//#region ../types/dist/composition-Dh3RfMx5.mjs
+//#region ../types/dist/composition-CD1GdFuv.mjs
 /**
 * The ffmpeg build every CamStack node downloads, per platform and arch.
 *
@@ -12901,7 +12927,14 @@ var CompositionForwardCommandSchema = object({
 	method: string().min(1),
 	args: record(string().min(1), CompositionForwardArgSchema).optional()
 });
-var CompositionCommandTargetSchema = discriminatedUnion("kind", [CompositionForwardCommandSchema, CompositionCodeSourceSchema]);
+var CompositionCommandTargetSchema = discriminatedUnion("kind", [
+	CompositionForwardCommandSchema,
+	CompositionCodeSourceSchema,
+	object({
+		kind: literal("extension"),
+		target: literal("remote")
+	})
+]);
 /** An item key inside an item-array cap (`consumables.items[<key>]`). */
 var COMPOSITION_ITEM_KEY_RE = /^[a-z0-9][a-z0-9-]{0,47}$/;
 /**
@@ -12946,7 +12979,7 @@ var CompositionSchema = object({
 		kind: literal("existing"),
 		device: CompositionSourceRefSchema
 	})]),
-	features: array(CompositionFeatureSchema).min(1).max(16),
+	features: array(CompositionFeatureSchema).min(0).max(16),
 	/**
 	* Present when the block is a helper template. Absent on a free
 	* composition (the room example, device 4603). The editor reads this,
@@ -19525,6 +19558,48 @@ var APPLIANCE_CAP_VOCABULARY = {
 		scope: "device",
 		noun: t("Media player", "Lettore multimediale"),
 		actions: [
+			{
+				id: "media.turnOn",
+				method: "turnOn",
+				label: t("Turn on", "Accendi"),
+				phrase: t("Turn on {device}", "Accendi {device}"),
+				icon: "power"
+			},
+			{
+				id: "media.turnOff",
+				method: "turnOff",
+				label: t("Turn off", "Spegni"),
+				phrase: t("Turn off {device}", "Spegni {device}"),
+				icon: "power"
+			},
+			{
+				id: "media.volumeUp",
+				method: "volumeUp",
+				label: t("Volume up", "Alza il volume"),
+				phrase: t("Raise the volume of {device}", "Alza il volume di {device}"),
+				icon: "volume-2"
+			},
+			{
+				id: "media.volumeDown",
+				method: "volumeDown",
+				label: t("Volume down", "Abbassa il volume"),
+				phrase: t("Lower the volume of {device}", "Abbassa il volume di {device}"),
+				icon: "volume-2"
+			},
+			{
+				id: "media.channelUp",
+				method: "channelUp",
+				label: t("Channel up", "Canale successivo"),
+				phrase: t("Go to the next channel on {device}", "Passa al canale successivo su {device}"),
+				icon: "skip-forward"
+			},
+			{
+				id: "media.channelDown",
+				method: "channelDown",
+				label: t("Channel down", "Canale precedente"),
+				phrase: t("Go to the previous channel on {device}", "Torna al canale precedente su {device}"),
+				icon: "skip-back"
+			},
 			{
 				id: "media.play",
 				method: "play",
@@ -49152,6 +49227,244 @@ var controlCapability = {
 	*/
 	history: "none"
 };
+/**
+* Media-player cap. Models HA `media_player.*` (Sonos, Chromecast,
+* Apple TV, Spotify, Roku, generic OTT receivers, …) on
+* `DeviceType.MediaPlayer`. Disjoint from the camera streaming
+* surface — those use `DeviceType.Camera` + the broker pipeline.
+*
+* The cap declares a wide method surface; not every backend supports
+* every method. Drivers signal sub-capability via the
+* `DeviceFeature.MediaPlayerXxx` flags (paired one-to-one with the
+* corresponding method) so the UI gates buttons without a slice
+* fetch — same pattern as `PanTiltZoom` for cameras.
+*/
+var MediaPlayerStateSchema = _enum([
+	"off",
+	"on",
+	"idle",
+	"playing",
+	"paused",
+	"buffering",
+	"standby"
+]);
+var MediaPlayerRepeatSchema = _enum([
+	"off",
+	"all",
+	"one"
+]);
+var MediaInfoSchema = object({
+	/** Free-form media kind (`music`, `tvshow`, `movie`, `app`, `channel`,
+	*  `podcast`, …). */
+	type: string(),
+	/** Human-readable title. */
+	title: string(),
+	/** Optional artist / channel / station label. */
+	artist: string().optional(),
+	/** Optional album / season / show name. */
+	album: string().optional(),
+	/** Optional cover-art / thumbnail URL. */
+	imageUrl: string().optional()
+});
+/**
+* Where `state`, `volumeLevel`, `isMuted` and `source` come from. `reported`:
+* the device said so. `assumed`: the driver has no feedback (infrared) and
+* tracks what it last SENT; it moves only after a send was accepted, and a
+* human at the real remote makes it wrong. A UI shows an assumed value as a
+* guess, never as a reading.
+*/
+var MediaPlayerStateSourceSchema = _enum(["reported", "assumed"]);
+/** The fields of a media-player status a driver can only guess. */
+var MediaPlayerAssumedFieldSchema = _enum([
+	"state",
+	"volumeLevel",
+	"isMuted",
+	"source"
+]);
+var MediaPlayerStatusSchema = object({
+	/** Playback lifecycle state. */
+	state: MediaPlayerStateSchema,
+	/**
+	* Whether the state fields are readings or the driver's own bookkeeping.
+	* A slice written before this field existed parses as `reported`.
+	*/
+	stateSource: MediaPlayerStateSourceSchema.default("reported"),
+	/**
+	* Which fields are the driver's own guess. `stateSource` is `assumed` when
+	* this is not empty; a field not listed here is a reading even then (power
+	* from a running-state source, mute guessed from the last send).
+	*/
+	assumedFields: array(MediaPlayerAssumedFieldSchema).default([]),
+	/** Volume as 0..100 inclusive. Null when the device has no volume
+	*  surface. Pair with `DeviceFeature.MediaPlayerVolume`. */
+	volumeLevel: number$1().min(0).max(100).nullable().meta(readingMeta("percentage")),
+	/** Mute toggle distinct from volume=0. Null when no mute surface.
+	*  Pair with `DeviceFeature.MediaPlayerMute`. */
+	isMuted: boolean().nullable(),
+	/** Active source / input. Empty when no source surface. */
+	source: string(),
+	/** Selectable sources. Empty when no source surface.
+	*  Pair with `DeviceFeature.MediaPlayerSelectSource`. */
+	availableSources: array(string()),
+	/** Currently-playing media info. Null when nothing is playing. */
+	currentMedia: MediaInfoSchema.nullable(),
+	/** Current playback position in ms. Null when not seekable or
+	*  nothing is playing. Pair with `DeviceFeature.MediaPlayerSeek`. */
+	position: number$1().int().nonnegative().nullable().meta(readingMeta("duration-ms")),
+	/** Total duration of the current media in ms. Null when unknown
+	*  (live stream) or nothing is playing. */
+	duration: number$1().int().nonnegative().nullable().meta(readingMeta("duration-ms")),
+	/** Shuffle toggle. Null when no shuffle surface.
+	*  Pair with `DeviceFeature.MediaPlayerShuffle`. */
+	shuffle: boolean().nullable(),
+	/** Repeat mode. Null when no repeat surface.
+	*  Pair with `DeviceFeature.MediaPlayerRepeat`. */
+	repeat: MediaPlayerRepeatSchema.nullable(),
+	/** Ms epoch when the slice was last updated. */
+	lastChangedAt: number$1()
+});
+var stepInput = object({
+	deviceId: number$1().int().nonnegative(),
+	/** How many presses: the caller's count (Alexa `volumeSteps`, `channelCount`). */
+	steps: number$1().int().min(1).max(50).default(1)
+});
+var deviceOnly = object({ deviceId: number$1().int().nonnegative() });
+var mediaPlayerCapability = {
+	name: "media-player",
+	scope: "device",
+	deviceNative: true,
+	mode: "singleton",
+	deviceTypes: [DeviceType.MediaPlayer],
+	methods: {
+		turnOn: method(deviceOnly, _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		turnOff: method(deviceOnly, _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		volumeUp: method(stepInput, _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		volumeDown: method(stepInput, _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		channelUp: method(stepInput, _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		channelDown: method(stepInput, _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		play: method(object({ deviceId: number$1().int().nonnegative() }), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		pause: method(object({ deviceId: number$1().int().nonnegative() }), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		stop: method(object({ deviceId: number$1().int().nonnegative() }), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		next: method(object({ deviceId: number$1().int().nonnegative() }), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		previous: method(object({ deviceId: number$1().int().nonnegative() }), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		seek: method(object({
+			deviceId: number$1().int().nonnegative(),
+			position: number$1().int().nonnegative()
+		}), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		setVolume: method(object({
+			deviceId: number$1().int().nonnegative(),
+			volumeLevel: number$1().min(0).max(100)
+		}), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		setMute: method(object({
+			deviceId: number$1().int().nonnegative(),
+			muted: boolean()
+		}), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		setShuffle: method(object({
+			deviceId: number$1().int().nonnegative(),
+			shuffle: boolean()
+		}), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		setRepeat: method(object({
+			deviceId: number$1().int().nonnegative(),
+			repeat: MediaPlayerRepeatSchema
+		}), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		selectSource: method(object({
+			deviceId: number$1().int().nonnegative(),
+			source: string().min(1)
+		}), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		playMedia: method(object({
+			deviceId: number$1().int().nonnegative(),
+			/** Media identifier / URL. */
+			mediaId: string().min(1),
+			/** Media kind (`music`, `tvshow`, `movie`, `app`, …) — provider
+			*  passes it through to the upstream service. */
+			mediaType: string().min(1)
+		}), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		})
+	},
+	status: {
+		schema: MediaPlayerStatusSchema,
+		kind: "push"
+	},
+	/**
+	* Runtime-state slice — mirrored by the kernel. UI players read the
+	* full slice for live now-playing, volume, and progress updates
+	* without polling.
+	*/
+	runtimeState: MediaPlayerStatusSchema,
+	/**
+	* Runtime-state durability: **session** — a restored transport position describes a playback that stopped when the hub did.
+	*
+	* See `RuntimeStateDurability`. Enforced by
+	* `scripts/check-runtime-state-durability.ts`.
+	*/
+	durability: "session",
+	/**
+	* History (D850): volume (a level an operator or an automation sets; the
+	* default 10 s floor folds a slider drag into its end value) and mute.
+	* `position` is not recorded: it moves continuously while playing.
+	*/
+	history: { fields: {
+		volumeLevel: {
+			kind: "gauge",
+			unit: "%",
+			deadband: 1
+		},
+		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.Camera, DeviceType.Fan, DeviceType.Lock, DeviceType.Camera, DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.PetFeeder, DeviceType.Heater, DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.PetFeeder, DeviceType.Heater, DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.PetFeeder, DeviceType.Heater, DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.PetFeeder, DeviceType.Heater, DeviceType.Gateway, DeviceType.Hub, DeviceType.Camera, DeviceType.Sensor, DeviceType.MediaPlayer, DeviceType.Vacuum, DeviceType.Generic, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.PetFountain, DeviceType.Fan, DeviceType.Humidifier, DeviceType.Climate, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer, DeviceType.WaterHeater, DeviceType.Humidifier, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.PetFeeder, DeviceType.Heater;
 var NUMBER = {
 	kind: "fixed",
@@ -57845,214 +58158,6 @@ var LoginMethodContributionSchema = discriminatedUnion("kind", [
 ]);
 method(_void(), array(LoginMethodContributionSchema).readonly());
 /**
-* Media-player cap. Models HA `media_player.*` (Sonos, Chromecast,
-* Apple TV, Spotify, Roku, generic OTT receivers, …) on
-* `DeviceType.MediaPlayer`. Disjoint from the camera streaming
-* surface — those use `DeviceType.Camera` + the broker pipeline.
-*
-* The cap declares a wide method surface; not every backend supports
-* every method. Drivers signal sub-capability via the
-* `DeviceFeature.MediaPlayerXxx` flags (paired one-to-one with the
-* corresponding method) so the UI gates buttons without a slice
-* fetch — same pattern as `PanTiltZoom` for cameras.
-*/
-var MediaPlayerStateSchema = _enum([
-	"off",
-	"on",
-	"idle",
-	"playing",
-	"paused",
-	"buffering",
-	"standby"
-]);
-var MediaPlayerRepeatSchema = _enum([
-	"off",
-	"all",
-	"one"
-]);
-var MediaInfoSchema = object({
-	/** Free-form media kind (`music`, `tvshow`, `movie`, `app`, `channel`,
-	*  `podcast`, …). */
-	type: string(),
-	/** Human-readable title. */
-	title: string(),
-	/** Optional artist / channel / station label. */
-	artist: string().optional(),
-	/** Optional album / season / show name. */
-	album: string().optional(),
-	/** Optional cover-art / thumbnail URL. */
-	imageUrl: string().optional()
-});
-/**
-* Where `state`, `volumeLevel`, `isMuted` and `source` come from. `reported`:
-* the device said so. `assumed`: the driver has no feedback (infrared) and
-* tracks what it last SENT; it moves only after a send was accepted, and a
-* human at the real remote makes it wrong. A UI shows an assumed value as a
-* guess, never as a reading.
-*/
-var MediaPlayerStateSourceSchema = _enum(["reported", "assumed"]);
-/** The fields of a media-player status a driver can only guess. */
-var MediaPlayerAssumedFieldSchema = _enum([
-	"state",
-	"volumeLevel",
-	"isMuted",
-	"source"
-]);
-var MediaPlayerStatusSchema = object({
-	/** Playback lifecycle state. */
-	state: MediaPlayerStateSchema,
-	/**
-	* Whether the state fields are readings or the driver's own bookkeeping.
-	* A slice written before this field existed parses as `reported`.
-	*/
-	stateSource: MediaPlayerStateSourceSchema.default("reported"),
-	/**
-	* Which fields are the driver's own guess. `stateSource` is `assumed` when
-	* this is not empty; a field not listed here is a reading even then (power
-	* from a running-state source, mute guessed from the last send).
-	*/
-	assumedFields: array(MediaPlayerAssumedFieldSchema).default([]),
-	/** Volume as 0..100 inclusive. Null when the device has no volume
-	*  surface. Pair with `DeviceFeature.MediaPlayerVolume`. */
-	volumeLevel: number$1().min(0).max(100).nullable().meta(readingMeta("percentage")),
-	/** Mute toggle distinct from volume=0. Null when no mute surface.
-	*  Pair with `DeviceFeature.MediaPlayerMute`. */
-	isMuted: boolean().nullable(),
-	/** Active source / input. Empty when no source surface. */
-	source: string(),
-	/** Selectable sources. Empty when no source surface.
-	*  Pair with `DeviceFeature.MediaPlayerSelectSource`. */
-	availableSources: array(string()),
-	/** Currently-playing media info. Null when nothing is playing. */
-	currentMedia: MediaInfoSchema.nullable(),
-	/** Current playback position in ms. Null when not seekable or
-	*  nothing is playing. Pair with `DeviceFeature.MediaPlayerSeek`. */
-	position: number$1().int().nonnegative().nullable().meta(readingMeta("duration-ms")),
-	/** Total duration of the current media in ms. Null when unknown
-	*  (live stream) or nothing is playing. */
-	duration: number$1().int().nonnegative().nullable().meta(readingMeta("duration-ms")),
-	/** Shuffle toggle. Null when no shuffle surface.
-	*  Pair with `DeviceFeature.MediaPlayerShuffle`. */
-	shuffle: boolean().nullable(),
-	/** Repeat mode. Null when no repeat surface.
-	*  Pair with `DeviceFeature.MediaPlayerRepeat`. */
-	repeat: MediaPlayerRepeatSchema.nullable(),
-	/** Ms epoch when the slice was last updated. */
-	lastChangedAt: number$1()
-});
-var mediaPlayerCapability = {
-	name: "media-player",
-	scope: "device",
-	deviceNative: true,
-	mode: "singleton",
-	deviceTypes: [DeviceType.MediaPlayer],
-	methods: {
-		play: method(object({ deviceId: number$1().int().nonnegative() }), _void(), {
-			kind: "mutation",
-			auth: "protected"
-		}),
-		pause: method(object({ deviceId: number$1().int().nonnegative() }), _void(), {
-			kind: "mutation",
-			auth: "protected"
-		}),
-		stop: method(object({ deviceId: number$1().int().nonnegative() }), _void(), {
-			kind: "mutation",
-			auth: "protected"
-		}),
-		next: method(object({ deviceId: number$1().int().nonnegative() }), _void(), {
-			kind: "mutation",
-			auth: "protected"
-		}),
-		previous: method(object({ deviceId: number$1().int().nonnegative() }), _void(), {
-			kind: "mutation",
-			auth: "protected"
-		}),
-		seek: method(object({
-			deviceId: number$1().int().nonnegative(),
-			position: number$1().int().nonnegative()
-		}), _void(), {
-			kind: "mutation",
-			auth: "protected"
-		}),
-		setVolume: method(object({
-			deviceId: number$1().int().nonnegative(),
-			volumeLevel: number$1().min(0).max(100)
-		}), _void(), {
-			kind: "mutation",
-			auth: "protected"
-		}),
-		setMute: method(object({
-			deviceId: number$1().int().nonnegative(),
-			muted: boolean()
-		}), _void(), {
-			kind: "mutation",
-			auth: "protected"
-		}),
-		setShuffle: method(object({
-			deviceId: number$1().int().nonnegative(),
-			shuffle: boolean()
-		}), _void(), {
-			kind: "mutation",
-			auth: "protected"
-		}),
-		setRepeat: method(object({
-			deviceId: number$1().int().nonnegative(),
-			repeat: MediaPlayerRepeatSchema
-		}), _void(), {
-			kind: "mutation",
-			auth: "protected"
-		}),
-		selectSource: method(object({
-			deviceId: number$1().int().nonnegative(),
-			source: string().min(1)
-		}), _void(), {
-			kind: "mutation",
-			auth: "protected"
-		}),
-		playMedia: method(object({
-			deviceId: number$1().int().nonnegative(),
-			/** Media identifier / URL. */
-			mediaId: string().min(1),
-			/** Media kind (`music`, `tvshow`, `movie`, `app`, …) — provider
-			*  passes it through to the upstream service. */
-			mediaType: string().min(1)
-		}), _void(), {
-			kind: "mutation",
-			auth: "protected"
-		})
-	},
-	status: {
-		schema: MediaPlayerStatusSchema,
-		kind: "push"
-	},
-	/**
-	* Runtime-state slice — mirrored by the kernel. UI players read the
-	* full slice for live now-playing, volume, and progress updates
-	* without polling.
-	*/
-	runtimeState: MediaPlayerStatusSchema,
-	/**
-	* Runtime-state durability: **session** — a restored transport position describes a playback that stopped when the hub did.
-	*
-	* See `RuntimeStateDurability`. Enforced by
-	* `scripts/check-runtime-state-durability.ts`.
-	*/
-	durability: "session",
-	/**
-	* History (D850): volume (a level an operator or an automation sets; the
-	* default 10 s floor folds a slider drag into its end value) and mute.
-	* `position` is not recorded: it moves continuously while playing.
-	*/
-	history: { fields: {
-		volumeLevel: {
-			kind: "gauge",
-			unit: "%",
-			deadband: 1
-		},
-		isMuted: { kind: "boolean" }
-	} }
-};
-/**
 * mesh-network — collection cap for mesh-VPN providers.
 *
 * Different shape from `network-access` (public tunnels):
@@ -66811,6 +66916,21 @@ var NcTemplateVarKindSchema = _enum([
 	"sound",
 	"system"
 ]);
+/**
+* The default title/body a rule of one SITUATION is delivered with when the
+* operator wrote no template — served so an editor can pre-fill it (and the
+* operator can rebuild it from placeholders) instead of starting from a blank
+* box that, once saved, silently replaces it. `id` names the situation inside
+* a rule `kind`: `appliance-cycle` is a `sensor` rule whose device is an
+* appliance finishing a cycle. Texts are raw templates (`{{var}}` intact), in
+* the hub's current language and with its overrides applied.
+*/
+var NcTemplateDefaultSchema = object({
+	id: _enum(["appliance-cycle"]),
+	kind: NcRuleKindSchema,
+	title: string(),
+	body: string()
+});
 /** Which producer renders a template: an ordinary rule, a timelapse, a digest. */
 var NcTemplateFamilySchema = _enum([
 	"rule",
@@ -67666,7 +67786,11 @@ method(object({}), object({ rules: array(NcRuleSchema) }), { auth: "admin" }), m
 }), method(object({}), object({
 	catalog: array(NcConditionDescriptorSchema),
 	taxonomy: NcTaxonomySchema.optional()
-})), method(object({}), object({ vars: array(NcTemplateVarDescriptorSchema) })), method(NcTemplatePreviewInputSchema, NcTemplatePreviewSchema, {
+})), method(object({}), object({
+	vars: array(NcTemplateVarDescriptorSchema),
+	/** Per-situation default texts; absent on a hub that predates them. */
+	defaults: array(NcTemplateDefaultSchema)
+})), method(NcTemplatePreviewInputSchema, NcTemplatePreviewSchema, {
 	kind: "mutation",
 	access: "view"
 }), method(object({ filter: NcHistoryFilterSchema.default({ limit: 100 }) }), object({ entries: array(NcHistoryEntrySchema) }), { auth: "admin" }), method(object({}), NcRuleLastRunsSchema, { auth: "admin" }), method(object({ artifactId: string().min(1) }), object({ url: string().nullable() }), { auth: "admin" }), method(object({}), object({ snoozes: array(NcSnoozeSchema) }), { caller: "required" }), method(object({ snooze: NcSnoozeInputSchema }), object({ snooze: NcSnoozeSchema }), {
@@ -70257,6 +70381,14 @@ var powerMeterCapability = {
 	deviceNative: true,
 	mode: "singleton",
 	deviceTypes: POWER_METER_DEVICE_TYPES,
+	deviceConfig: { ui: {
+		kind: "widget",
+		widgetId: "host/power-meter-line",
+		tab: "power",
+		placement: "hero",
+		label: "Power",
+		order: 4
+	} },
 	methods: {},
 	status: {
 		schema: PowerMeterStatusSchema,
@@ -73818,7 +73950,13 @@ var RemoteMediaCommandSchema = _enum([
 	"next",
 	"previous",
 	"setMute",
-	"selectSource"
+	"selectSource",
+	"turnOn",
+	"turnOff",
+	"volumeUp",
+	"volumeDown",
+	"channelUp",
+	"channelDown"
 ]);
 /** A send result, or `not-routed`: the role is not bound, so the native cap answers. */
 var RemoteMediaCommandResultSchema = discriminatedUnion("status", [...RemoteSendResultSchema.options, object({ status: literal("not-routed") })]);
@@ -73839,7 +73977,7 @@ method(deviceInput, RemoteConfigSchema, { auth: "admin" }), method(deviceInput.e
 }), RemoteSendResultSchema, {
 	kind: "mutation",
 	auth: "protected"
-}), method(deviceInput.extend({
+}), method(deviceInput, MediaPlayerStatusSchema.nullable(), { auth: "protected" }), method(deviceInput.extend({
 	command: RemoteMediaCommandSchema,
 	muted: boolean().optional(),
 	source: string().optional(),
@@ -76085,7 +76223,11 @@ listSignals: method(_void(), array(StreamSignalSchema).readonly()) }
 * `getSettingsUISchema()` surface.
 */
 var SwitchStatusSchema = object({
-	on: boolean().meta({ label: "On" }),
+	/**
+	* `null` = the device has never reported its state (a measurement that
+	* has not happened is unknown, never `false`).
+	*/
+	on: boolean().nullable().meta({ label: "On" }),
 	/** Ms epoch of the last state change. Useful for UI "X minutes ago". */
 	lastChangedAt: number$1()
 });
@@ -76110,7 +76252,7 @@ var switchCapability = {
 	}) },
 	events: { onStateChanged: { data: object({
 		deviceId: number$1(),
-		on: boolean(),
+		on: boolean().nullable(),
 		lastChangedAt: number$1()
 	}) } },
 	status: {
@@ -79667,6 +79809,7 @@ function buildDescriptor(capName, kind) {
 * contributes one entry per bound cap present in this map.
 */
 var EVENT_KIND_BY_CAP = Object.freeze(Object.fromEntries(Object.entries(CAP_TO_KIND).map(([capName, kind]) => [capName, buildDescriptor(capName, kind)])));
+DeviceFeature.MediaPlayerPower, DeviceFeature.MediaPlayerVolumeStep, DeviceFeature.MediaPlayerChannelStep, DeviceFeature.MediaPlayerMute, DeviceFeature.MediaPlayerStop, DeviceFeature.MediaPlayerNext, DeviceFeature.MediaPlayerPrevious;
 var btn = (idSuffix, row, col, init) => ({
 	idSuffix,
 	row,
@@ -85845,6 +85988,20 @@ Object.freeze({
 		access: "view",
 		role: "admin"
 	},
+	"mediaPlayer.channelDown": {
+		capName: "media-player",
+		capScope: "device",
+		addonId: null,
+		access: "create",
+		role: "viewer"
+	},
+	"mediaPlayer.channelUp": {
+		capName: "media-player",
+		capScope: "device",
+		addonId: null,
+		access: "create",
+		role: "viewer"
+	},
 	"mediaPlayer.getStatus": {
 		capName: "media-player",
 		capScope: "device",
@@ -85936,6 +86093,34 @@ Object.freeze({
 		access: "create",
 		role: "viewer"
 	},
+	"mediaPlayer.turnOff": {
+		capName: "media-player",
+		capScope: "device",
+		addonId: null,
+		access: "create",
+		role: "viewer"
+	},
+	"mediaPlayer.turnOn": {
+		capName: "media-player",
+		capScope: "device",
+		addonId: null,
+		access: "create",
+		role: "viewer"
+	},
+	"mediaPlayer.volumeDown": {
+		capName: "media-player",
+		capScope: "device",
+		addonId: null,
+		access: "create",
+		role: "viewer"
+	},
+	"mediaPlayer.volumeUp": {
+		capName: "media-player",
+		capScope: "device",
+		addonId: null,
+		access: "create",
+		role: "viewer"
+	},
 	"meshNetwork.getStatus": {
 		capName: "mesh-network",
 		capScope: "system",
@@ -89492,6 +89677,13 @@ Object.freeze({
 		access: "create",
 		role: "admin"
 	},
+	"remote.getAssumedStatus": {
+		capName: "remote",
+		capScope: "system",
+		addonId: null,
+		access: "view",
+		role: "admin"
+	},
 	"remote.getConfig": {
 		capName: "remote",
 		capScope: "system",
@@ -93158,6 +93350,16 @@ Object.freeze({
 		form: "single",
 		optional: true
 	}],
+	"mediaPlayer.channelDown": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"mediaPlayer.channelUp": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"mediaPlayer.getStatus": [{
 		name: "deviceId",
 		form: "single",
@@ -93223,6 +93425,26 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"mediaPlayer.turnOff": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"mediaPlayer.turnOn": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"mediaPlayer.volumeDown": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"mediaPlayer.volumeUp": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"meter.getStatus": [{
 		name: "deviceId",
 		form: "single",
@@ -94388,6 +94610,11 @@ Object.freeze({
 		form: "single",
 		optional: true
 	}],
+	"remote.getAssumedStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"remote.getConfig": [{
 		name: "deviceId",
 		form: "single",
@@ -95850,6 +96077,7 @@ var STATE_SUMMARY_VARS = [
 	[...RULE_TEXT],
 	([...RULE_TEXT], [...DEVICE_EVENTS]),
 	([...RULE_TEXT], [...COMBINED_ALARM]),
+	([...RULE_TEXT], [...COMBINED_ALARM]),
 	([...RULE_TEXT], [...DEVICE_EVENTS]),
 	([...RULE_TEXT], [...BATTERY, ...CONSUMABLE]),
 	([...RULE_TEXT], [...CONSUMABLE]),
@@ -141976,6 +142204,7 @@ function isKnownCap(cap) {
 var EchoSessionRegistry = class {
 	#resolve = null;
 	#dnd = /* @__PURE__ */ new Map();
+	#volumes = /* @__PURE__ */ new Map();
 	setResolver(fn) {
 		this.#resolve = fn;
 	}
@@ -141998,9 +142227,26 @@ var EchoSessionRegistry = class {
 		});
 		return pending;
 	}
+	/** Volume and mute of every device of the account. A failed read is not kept for the next device. */
+	volumes(brokerId, now) {
+		const shared = this.#volumes.get(brokerId);
+		if (shared !== void 0 && now - shared.at < 25e3) return shared.pending;
+		const session = this.get(brokerId);
+		if (session === null) return Promise.reject(/* @__PURE__ */ new Error("no Echo session for this account"));
+		const pending = session.deviceVolumes();
+		this.#volumes.set(brokerId, {
+			at: now,
+			pending
+		});
+		pending.catch(() => {
+			if (this.#volumes.get(brokerId)?.pending === pending) this.#volumes.delete(brokerId);
+		});
+		return pending;
+	}
 	clear() {
 		this.#resolve = null;
 		this.#dnd.clear();
+		this.#volumes.clear();
 	}
 };
 /** The single in-process registry shared across the addon. */
@@ -142083,6 +142329,18 @@ function mapPlayerInfoToStatus(info, input) {
 		repeat: repeatOf(info.transport?.repeat)
 	};
 }
+/**
+* Fill the volume and mute the player read left null from the account's volume
+* list. The player read wins when it has a value; a value neither source has stays null.
+*/
+function withListedVolume(status, listed) {
+	if (listed === void 0) return status;
+	return {
+		...status,
+		volumeLevel: status.volumeLevel ?? percent(listed.volume),
+		isMuted: status.isMuted ?? listed.muted
+	};
+}
 //#endregion
 //#region src/speak/worker-protocol.ts
 /** Line-delimited JSON the long-lived Python worker speaks. One object per line. */
@@ -142200,6 +142458,19 @@ function parseDndState(result) {
 	if (!parsed.success) throw new Error("worker returned an unexpected Do Not Disturb list");
 	return new Map(parsed.data.devices.map((entry) => [entry.serial, entry.enabled]));
 }
+var DeviceVolumeEntrySchema = object({
+	serial: string().min(1),
+	volume: number$1().finite().optional(),
+	muted: boolean().optional()
+});
+function parseDeviceVolumes(result) {
+	const parsed = object({ devices: array(DeviceVolumeEntrySchema) }).safeParse(result);
+	if (!parsed.success) throw new Error("worker returned an unexpected device volume list");
+	return new Map(parsed.data.devices.map((entry) => [entry.serial, {
+		volume: entry.volume ?? null,
+		muted: entry.muted ?? null
+	}]));
+}
 //#endregion
 //#region src/devices/alexa-echo-device.ts
 /**
@@ -142214,6 +142485,8 @@ var alexaEchoDeviceSchema = object({
 	system: literal("alexa").optional(),
 	integrationId: string().optional()
 });
+/** Percent points one volume-up / volume-down moves an Echo. */
+var VOLUME_STEP = 10;
 var COLD_DND = {
 	enabled: null,
 	lastChangedAt: 0
@@ -142234,6 +142507,7 @@ var AlexaEchoDevice = class extends BaseDevice {
 	rereadTimer = null;
 	polling = false;
 	failureLogged = false;
+	volumeFailureLogged = false;
 	health = "ok";
 	constructor(ctx) {
 		const persisted = alexaEchoDeviceSchema.parse(ctx.persistedConfig ?? {});
@@ -142306,12 +142580,11 @@ var AlexaEchoDevice = class extends BaseDevice {
 		}
 		const deviceType = this.amazonDeviceType !== "" ? this.amazonDeviceType : listed?.deviceType ?? "";
 		try {
-			const info = await session.playerState(this.serial, deviceType);
-			const now = Date.now();
-			this.runtimeState.setCapState("media-player", mapPlayerInfoToStatus(info, {
+			const fromPlayer = mapPlayerInfoToStatus(await session.playerState(this.serial, deviceType), {
 				online: true,
-				now
-			}));
+				now: Date.now()
+			});
+			this.runtimeState.setCapState("media-player", await this.completeVolume(fromPlayer));
 			this.markOnline(true);
 			this.noteRecovered();
 		} catch (err) {
@@ -142320,6 +142593,29 @@ var AlexaEchoDevice = class extends BaseDevice {
 		}
 		await this.readDoNotDisturb();
 	}
+	/**
+	* An idle Echo's player read carries no volume. Ask the account's volume list
+	* (shared by every Echo of the account in this cycle); a failed read leaves null.
+	*/
+	async completeVolume(status) {
+		if (status.volumeLevel !== null && status.isMuted !== null) return status;
+		try {
+			const all = await alexaEchoSessions.volumes(this.brokerId, Date.now());
+			if (this.volumeFailureLogged) this.ctx.logger.info("alexa echo: the volume list reads again", { tags: { deviceId: this.id } });
+			this.volumeFailureLogged = false;
+			return withListedVolume(status, all.get(this.serial));
+		} catch (err) {
+			if (err instanceof RateLimitedError) return status;
+			if (!this.volumeFailureLogged) {
+				this.volumeFailureLogged = true;
+				this.ctx.logger.warn("alexa echo: could not read the volume list, volume stays unknown", {
+					tags: { deviceId: this.id },
+					meta: { error: err instanceof Error ? err.message : String(err) }
+				});
+			}
+			return status;
+		}
+	}
 	async readDoNotDisturb() {
 		try {
 			const enabled = (await alexaEchoSessions.dnd(this.brokerId, Date.now())).get(this.serial);
@@ -142355,6 +142651,14 @@ var AlexaEchoDevice = class extends BaseDevice {
 		await this.session().npCommand(this.serial, command);
 		this.rereadSoon();
 	}
+	/** Amazon has no step command: move from the last known level, refuse when there is none. */
+	async stepVolume(delta) {
+		const level = this.runtimeState.getCapState("media-player")?.volumeLevel;
+		if (level === null || level === void 0) throw new Error("the Echo volume is not known yet");
+		const next = Math.max(0, Math.min(100, level + delta));
+		await this.session().setVolume(this.serial, next);
+		this.rereadSoon();
+	}
 	registerMediaPlayer() {
 		this.ctx.registerNativeCap(mediaPlayerCapability, {
 			getStatus: async () => this.runtimeState.getCapState("media-player") ?? emptyEchoStatus("off", 0),
@@ -142367,6 +142671,12 @@ var AlexaEchoDevice = class extends BaseDevice {
 				this.rereadSoon();
 			},
 			stop: async () => unsupported("stop"),
+			turnOn: async () => unsupported("power"),
+			turnOff: async () => unsupported("power"),
+			volumeUp: async () => this.stepVolume(VOLUME_STEP),
+			volumeDown: async () => this.stepVolume(-10),
+			channelUp: async () => unsupported("channel steps"),
+			channelDown: async () => unsupported("channel steps"),
 			seek: async () => unsupported("seek"),
 			setMute: async () => unsupported("mute"),
 			setShuffle: async () => unsupported("shuffle"),
@@ -142871,6 +143181,11 @@ var BrokerEcho = class {
 		await this.requireReady();
 		return this.limited(async () => parseDndState(await this.deps.worker.request({ op: "dnd_state" })));
 	}
+	/** Speaker volume and mute of every device of the account, by serial, in one call. */
+	async deviceVolumes() {
+		await this.requireReady();
+		return this.limited(async () => parseDeviceVolumes(await this.deps.worker.request({ op: "device_volumes" })));
+	}
 	async setDnd(serial, enabled) {
 		await this.requireReady();
 		await this.limited(() => this.deps.worker.request({