@camstack/addon-provider-homeassistant 1.2.652 → 1.2.654

package/dist/{ha-broker-source-CBWl6Wat.mjs → ha-instance-settings-g5pwb3Fi.mjs}

@@ -784,7 +784,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.
@@ -1015,6 +1015,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
@@ -5974,7 +5980,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-hmSP-eJt.mjs
+//#region ../types/dist/sleep-BKClVk0K.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -6053,6 +6059,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;
@@ -7706,7 +7728,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;
 	}
 	/**
@@ -11764,7 +11786,7 @@ object({
 	params: record(string(), union([string(), number()])).optional()
 });
 //#endregion
-//#region ../types/dist/composition-Dh3RfMx5.mjs
+//#region ../types/dist/composition-BodkvOV0.mjs
 /**
 * The ffmpeg build every CamStack node downloads, per platform and arch.
 *
@@ -12901,7 +12923,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}$/;
 /**
@@ -19562,6 +19591,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",
@@ -49531,6 +49602,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().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().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().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()
+});
+var stepInput = object({
+	deviceId: number().int().nonnegative(),
+	/** How many presses: the caller's count (Alexa `volumeSteps`, `channelCount`). */
+	steps: number().int().min(1).max(50).default(1)
+});
+var deviceOnly = object({ deviceId: number().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().int().nonnegative() }), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		pause: method(object({ deviceId: number().int().nonnegative() }), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		stop: method(object({ deviceId: number().int().nonnegative() }), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		next: method(object({ deviceId: number().int().nonnegative() }), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		previous: method(object({ deviceId: number().int().nonnegative() }), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		seek: method(object({
+			deviceId: number().int().nonnegative(),
+			position: number().int().nonnegative()
+		}), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		setVolume: method(object({
+			deviceId: number().int().nonnegative(),
+			volumeLevel: number().min(0).max(100)
+		}), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		setMute: method(object({
+			deviceId: number().int().nonnegative(),
+			muted: boolean()
+		}), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		setShuffle: method(object({
+			deviceId: number().int().nonnegative(),
+			shuffle: boolean()
+		}), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		setRepeat: method(object({
+			deviceId: number().int().nonnegative(),
+			repeat: MediaPlayerRepeatSchema
+		}), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		selectSource: method(object({
+			deviceId: number().int().nonnegative(),
+			source: string().min(1)
+		}), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		playMedia: method(object({
+			deviceId: number().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",
@@ -58284,214 +58593,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().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().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().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()
-});
-var mediaPlayerCapability = {
-	name: "media-player",
-	scope: "device",
-	deviceNative: true,
-	mode: "singleton",
-	deviceTypes: [DeviceType.MediaPlayer],
-	methods: {
-		play: method(object({ deviceId: number().int().nonnegative() }), _void(), {
-			kind: "mutation",
-			auth: "protected"
-		}),
-		pause: method(object({ deviceId: number().int().nonnegative() }), _void(), {
-			kind: "mutation",
-			auth: "protected"
-		}),
-		stop: method(object({ deviceId: number().int().nonnegative() }), _void(), {
-			kind: "mutation",
-			auth: "protected"
-		}),
-		next: method(object({ deviceId: number().int().nonnegative() }), _void(), {
-			kind: "mutation",
-			auth: "protected"
-		}),
-		previous: method(object({ deviceId: number().int().nonnegative() }), _void(), {
-			kind: "mutation",
-			auth: "protected"
-		}),
-		seek: method(object({
-			deviceId: number().int().nonnegative(),
-			position: number().int().nonnegative()
-		}), _void(), {
-			kind: "mutation",
-			auth: "protected"
-		}),
-		setVolume: method(object({
-			deviceId: number().int().nonnegative(),
-			volumeLevel: number().min(0).max(100)
-		}), _void(), {
-			kind: "mutation",
-			auth: "protected"
-		}),
-		setMute: method(object({
-			deviceId: number().int().nonnegative(),
-			muted: boolean()
-		}), _void(), {
-			kind: "mutation",
-			auth: "protected"
-		}),
-		setShuffle: method(object({
-			deviceId: number().int().nonnegative(),
-			shuffle: boolean()
-		}), _void(), {
-			kind: "mutation",
-			auth: "protected"
-		}),
-		setRepeat: method(object({
-			deviceId: number().int().nonnegative(),
-			repeat: MediaPlayerRepeatSchema
-		}), _void(), {
-			kind: "mutation",
-			auth: "protected"
-		}),
-		selectSource: method(object({
-			deviceId: number().int().nonnegative(),
-			source: string().min(1)
-		}), _void(), {
-			kind: "mutation",
-			auth: "protected"
-		}),
-		playMedia: method(object({
-			deviceId: number().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):
@@ -67250,6 +67351,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",
@@ -68105,7 +68221,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 }), {
@@ -74273,7 +74393,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") })]);
@@ -74294,7 +74420,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(),
@@ -76548,7 +76674,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()
 });
@@ -76573,7 +76703,7 @@ var switchCapability = {
 	}) },
 	events: { onStateChanged: { data: object({
 		deviceId: number(),
-		on: boolean(),
+		on: boolean().nullable(),
 		lastChangedAt: number()
 	}) } },
 	status: {
@@ -80256,6 +80386,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,
@@ -86471,6 +86602,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",
@@ -86562,6 +86707,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",
@@ -90118,6 +90291,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",
@@ -93795,6 +93975,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",
@@ -93860,6 +94050,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",
@@ -95025,6 +95235,11 @@ Object.freeze({
 		form: "single",
 		optional: true
 	}],
+	"remote.getAssumedStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"remote.getConfig": [{
 		name: "deviceId",
 		form: "single",
@@ -96544,6 +96759,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]),
@@ -97447,7 +97663,7 @@ object({
 * short-circuits any cap the calling process already provides.
 */
 /** The addon that owns the import direction, and every `ha_*` broker. */
-var HA_PROVIDER_ADDON_ID = "provider-homeassistant";
+var HA_PROVIDER_ADDON_ID$1 = "provider-homeassistant";
 /** The `BrokerInfo.kind` tag the Home Assistant provider stamps. */
 var HA_BROKER_KIND = "home-assistant";
 /**
@@ -97461,5 +97677,53 @@ var HA_BROKER_KIND = "home-assistant";
 async function listHomeAssistantBrokers(query) {
 	return (await query({})).filter((broker) => broker.kind === HA_BROKER_KIND);
 }
+function haInstanceSettingsPortsOver(api) {
+	const listInstances = async () => {
+		const all = await api.list.query();
+		const rows = [];
+		for (const integration of all) {
+			if (integration.addonId !== "provider-homeassistant") continue;
+			const settings = await api.getSettings.query({ id: integration.id });
+			const brokerId = settings["brokerId"];
+			rows.push({
+				integrationId: integration.id,
+				brokerId: typeof brokerId === "string" && brokerId.length > 0 ? brokerId : null,
+				settings
+			});
+		}
+		return rows;
+	};
+	return {
+		listInstances,
+		patchInstanceSettings: async (integrationId, patch) => {
+			if (!(await api.list.query()).some((i) => i.id === integrationId && i.addonId === "provider-homeassistant")) return false;
+			const stored = await api.getSettings.query({ id: integrationId });
+			await api.setSettings.mutate({
+				id: integrationId,
+				settings: {
+					...stored,
+					...patch
+				},
+				skipRestart: true
+			});
+			return true;
+		}
+	};
+}
+/** The brokerId → settings view of the instances: what a reader keeps per broker. */
+function settingsByBroker(rows) {
+	const out = /* @__PURE__ */ new Map();
+	for (const row of rows) if (row.brokerId !== null) out.set(row.brokerId, row.settings);
+	return out;
+}
+/** Read the instances, or report why not and answer nothing (a reader falls back to the legacy key). */
+async function listInstancesOrNothing(ports, onError) {
+	try {
+		return await ports.listInstances();
+	} catch (err) {
+		onError(errMsg(err));
+		return [];
+	}
+}
 //#endregion
-export { humidifierCapability as $, boolean as $t, brightnessCapability as A, switchCapability as At, consumableFormOf as B, weatherCapability as Bt, alarmPanelCapability as C, runningFromLawnMower as Ct, bestLocationMatch as D, scriptRunnerCapability as Dt, batteryCapability as E, runningStateCapability as Et, calendarSourceCapability as F, updateCapability as Ft, deviceAdminLinkCapability as G, defineAddonMigrations as Gt, contactCapability as H, RecordSecretUnavailableError as Ht, carbonMonoxideCapability as I, vacuumControlCapability as It, enumSensorCapability as J, entryBody as Jt, deviceAdoptionCapability as K, defineEntryKind as Kt, climateControlCapability as L, valveCapability as Lt, buildAddonRouteProvider as M, temperatureSensorCapability as Mt, buildDeviceAdminUrl as N, tryConvertDelta as Nt, binaryCapability as O, sendToExportedTarget as Ot, buttonCapability as P, tryConvertUnit as Pt, gasCapability as Q, array as Qt, colorCapability as R, vibrationCapability as Rt, airQualitySensorCapability as S, runExportedAction as St, automationControlCapability as T, runningFromVacuumState as Tt, controlCapability as U, baseUnitOf as Ut, consumableKindOf as V, BaseAddon as Vt, coverCapability as W, createEvent as Wt, fanControlCapability as X, nodePin as Xt, eventEmitterCapability as Y, isReadingQuantity as Yt, floodCapability as Z, _enum as Zt, PLUG_APPLIANCE_TYPES as _, pressureSensorCapability as _t, BaseDevice as a, string as an, mediaPlayerCapability as at, accessoriesCapability as b, quantityFromUnit as bt, COCO_TO_MACRO as c, url as cn, notificationOutputCapability as ct, ConsumableItemSchema as d, DeviceType as dn, oauthIntegrationCapability as dt, discriminatedUnion as en, humiditySensorCapability as et, ConsumableStatusSchema as f, errMsg as fn, parseAdminBase as ft, MediaPlayerRepeatSchema as g, presenceCapability as gt, HvacModeSchema as h, prepareNotification as ht, AlarmArmModeSchema as i, record as in, lockControlCapability as it, brokerCapability as j, tamperCapability as jt, boardKeySourceCapability as k, smokeCapability as kt, CameraSwitchIdSchema as l, DeviceFeature as ln, notifierCapability as lt, FanDirectionSchema as m, preconditionOf as mt, HA_PROVIDER_ADDON_ID as n, number as nn, ingestReading as nt, BaseDeviceProvider as o, union as on, motionCapability as ot, EnumSensorDateTimeFormatSchema as p, EventCategory as pn, powerMeterCapability as pt, deviceExportCapability as q, defineRecordKinds as qt, listHomeAssistantBrokers as r, object as rn, lawnMowerControlCapability as rt, CAMERA_SWITCH_ORDER as s, unknown as sn, normalizeUnit as st, HA_BROKER_KIND as t, literal as tn, imageCapability as tt, ConsumableFormSchema as u, DeviceRole as un, numericSensorCapability as ut, RUNNING_STATE_COLD as v, pruneDeletedEntities as vt, ambientLightSensorCapability as w, runningFromMediaPlayer as wt, addonRoutesCapability as x, resolveAttachmentUrls as xt, TargetSchema as y, publicEndpointReaderFrom as yt, connectivityCapability as z, waterHeaterCapability as zt };
+export { fanControlCapability as $, nodePin as $t, bestLocationMatch as A, scriptRunnerCapability as At, climateControlCapability as B, valveCapability as Bt, accessoriesCapability as C, quantityFromUnit as Ct, ambientLightSensorCapability as D, runningFromMediaPlayer as Dt, alarmPanelCapability as E, runningFromLawnMower as Et, buildAddonRouteProvider as F, temperatureSensorCapability as Ft, contactCapability as G, RecordSecretUnavailableError as Gt, connectivityCapability as H, waterHeaterCapability as Ht, buildDeviceAdminUrl as I, tryConvertDelta as It, deviceAdminLinkCapability as J, defineAddonMigrations as Jt, controlCapability as K, baseUnitOf as Kt, buttonCapability as L, tryConvertUnit as Lt, boardKeySourceCapability as M, smokeCapability as Mt, brightnessCapability as N, switchCapability as Nt, automationControlCapability as O, runningFromVacuumState as Ot, brokerCapability as P, tamperCapability as Pt, eventEmitterCapability as Q, isReadingQuantity as Qt, calendarSourceCapability as R, updateCapability as Rt, TargetSchema as S, publicEndpointReaderFrom as St, airQualitySensorCapability as T, runExportedAction as Tt, consumableFormOf as U, weatherCapability as Ut, colorCapability as V, vibrationCapability as Vt, consumableKindOf as W, BaseAddon as Wt, deviceExportCapability as X, defineRecordKinds as Xt, deviceAdoptionCapability as Y, defineEntryKind as Yt, enumSensorCapability as Z, entryBody as Zt, FanDirectionSchema as _, preconditionOf as _t, HA_PROVIDER_ADDON_ID$1 as a, number as an, ingestReading as at, PLUG_APPLIANCE_TYPES as b, pressureSensorCapability as bt, BaseDevice as c, string as cn, mediaPlayerCapability as ct, COCO_TO_MACRO as d, url as dn, notificationOutputCapability as dt, _enum as en, floodCapability as et, CameraSwitchIdSchema as f, DeviceFeature as fn, notifierCapability as ft, EnumSensorDateTimeFormatSchema as g, EventCategory as gn, powerMeterCapability as gt, ConsumableStatusSchema as h, errMsg as hn, parseAdminBase as ht, HA_BROKER_KIND as i, literal as in, imageCapability as it, binaryCapability as j, sendToExportedTarget as jt, batteryCapability as k, runningStateCapability as kt, BaseDeviceProvider as l, union as ln, motionCapability as lt, ConsumableItemSchema as m, DeviceType as mn, oauthIntegrationCapability as mt, listInstancesOrNothing as n, boolean as nn, humidifierCapability as nt, listHomeAssistantBrokers as o, object as on, lawnMowerControlCapability as ot, ConsumableFormSchema as p, DeviceRole as pn, numericSensorCapability as pt, coverCapability as q, createEvent as qt, settingsByBroker as r, discriminatedUnion as rn, humiditySensorCapability as rt, AlarmArmModeSchema as s, record as sn, lockControlCapability as st, haInstanceSettingsPortsOver as t, array as tn, gasCapability as tt, CAMERA_SWITCH_ORDER as u, unknown as un, normalizeUnit as ut, HvacModeSchema as v, prepareNotification as vt, addonRoutesCapability as w, resolveAttachmentUrls as wt, RUNNING_STATE_COLD as x, pruneDeletedEntities as xt, MediaPlayerRepeatSchema as y, presenceCapability as yt, carbonMonoxideCapability as z, vacuumControlCapability as zt };