@camstack/addon-provider-homeassistant 1.2.649 → 1.2.650

package/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.650] - 2026-11-02
+
+### Changed
+
+- Home Assistant export: a cover offers position and tilt only when the device declares them, shows unavailable while its provider is offline, and a refused command now answers 422 with the reason
+- A cover exports the stop control to Home Assistant only when the device declares cover-stoppable, and a Home Assistant cover with the STOP bit declares it.
+
 ## [1.2.649] - 2026-11-02
 
 ### Changed

package/dist/addon.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_ha_broker_source = require("./ha-broker-source-CE3nHkyW.js");
+const require_ha_broker_source = require("./ha-broker-source-DUj9pUWr.js");
 let node_crypto = require("node:crypto");
 let node_zlib = require("node:zlib");
 //#region src/ha-admin-link.ts
@@ -6328,6 +6328,7 @@ function mapCover(attributes, deviceClass) {
 	const features = [];
 	const sf = readNumericAttr(attributes, "supported_features");
 	if (sf !== null && (sf & 4) !== 0) features.push(require_ha_broker_source.DeviceFeature.CoverPositionable);
+	if (sf !== null && (sf & 8) !== 0) features.push(require_ha_broker_source.DeviceFeature.CoverStoppable);
 	if (sf !== null && (sf & 128) !== 0) features.push(require_ha_broker_source.DeviceFeature.CoverTilt);
 	return {
 		deviceType: require_ha_broker_source.DeviceType.Cover,

package/dist/addon.mjs

@@ -1,4 +1,4 @@
-import { $ as humiditySensorCapability, $t as discriminatedUnion, A as brokerCapability, At as tamperCapability, C as alarmPanelCapability, Ct as runningFromMediaPlayer, D as bestLocationMatch, E as batteryCapability, Et as scriptRunnerCapability, F as carbonMonoxideCapability, Ft as vacuumControlCapability, G as deviceAdoptionCapability, Gt as defineEntryKind, H as controlCapability, Ht as baseUnitOf, I as climateControlCapability, It as valveCapability, J as eventEmitterCapability, Kt as defineRecordKinds, L as colorCapability, Lt as vibrationCapability, M as buildDeviceAdminUrl, Mt as tryConvertDelta, N as buttonCapability, Nt as tryConvertUnit, O as binaryCapability, Ot as smokeCapability, P as calendarSourceCapability, Pt as updateCapability, Q as humidifierCapability, Qt as boolean, R as connectivityCapability, Rt as waterHeaterCapability, S as airQualitySensorCapability, St as runningFromLawnMower, T as automationControlCapability, Tt as runningStateCapability, U as coverCapability, Ut as createEvent, V as contactCapability, Vt as RecordSecretUnavailableError, W as deviceAdminLinkCapability, X as floodCapability, Xt as _enum, Y as fanControlCapability, Z as gasCapability, Zt as array, a as BaseDevice, an as union, at as motionCapability, b as accessoriesCapability, bt as resolveAttachmentUrls, cn as DeviceFeature, ct as notifierCapability, dn as errMsg, dt as parseAdminBase, en as literal, et as imageCapability, fn as EventCategory, ft as powerMeterCapability, gt as pressureSensorCapability, ht as presenceCapability, in as string, it as mediaPlayerCapability, j as buildAddonRouteProvider, jt as temperatureSensorCapability, k as brightnessCapability, kt as switchCapability, ln as DeviceRole, lt as numericSensorCapability, mt as prepareNotification, nn as object, nt as lawnMowerControlCapability, o as BaseDeviceProvider, on as unknown, ot as normalizeUnit, p as EnumSensorDateTimeFormatSchema, q as enumSensorCapability, qt as entryBody, rn as record, rt as lockControlCapability, sn as url, st as notificationOutputCapability, t as HA_BROKER_KIND, tn as number, tt as ingestReading, un as DeviceType, v as RUNNING_STATE_COLD, vt as publicEndpointReaderFrom, w as ambientLightSensorCapability, wt as runningFromVacuumState, x as addonRoutesCapability, y as TargetSchema, yt as quantityFromUnit, zt as weatherCapability } from "./ha-broker-source-D3FBA6uG.mjs";
+import { $ as humiditySensorCapability, $t as discriminatedUnion, A as brokerCapability, At as tamperCapability, C as alarmPanelCapability, Ct as runningFromMediaPlayer, D as bestLocationMatch, E as batteryCapability, Et as scriptRunnerCapability, F as carbonMonoxideCapability, Ft as vacuumControlCapability, G as deviceAdoptionCapability, Gt as defineEntryKind, H as controlCapability, Ht as baseUnitOf, I as climateControlCapability, It as valveCapability, J as eventEmitterCapability, Kt as defineRecordKinds, L as colorCapability, Lt as vibrationCapability, M as buildDeviceAdminUrl, Mt as tryConvertDelta, N as buttonCapability, Nt as tryConvertUnit, O as binaryCapability, Ot as smokeCapability, P as calendarSourceCapability, Pt as updateCapability, Q as humidifierCapability, Qt as boolean, R as connectivityCapability, Rt as waterHeaterCapability, S as airQualitySensorCapability, St as runningFromLawnMower, T as automationControlCapability, Tt as runningStateCapability, U as coverCapability, Ut as createEvent, V as contactCapability, Vt as RecordSecretUnavailableError, W as deviceAdminLinkCapability, X as floodCapability, Xt as _enum, Y as fanControlCapability, Z as gasCapability, Zt as array, a as BaseDevice, an as union, at as motionCapability, b as accessoriesCapability, bt as resolveAttachmentUrls, cn as DeviceFeature, ct as notifierCapability, dn as errMsg, dt as parseAdminBase, en as literal, et as imageCapability, fn as EventCategory, ft as powerMeterCapability, gt as pressureSensorCapability, ht as presenceCapability, in as string, it as mediaPlayerCapability, j as buildAddonRouteProvider, jt as temperatureSensorCapability, k as brightnessCapability, kt as switchCapability, ln as DeviceRole, lt as numericSensorCapability, mt as prepareNotification, nn as object, nt as lawnMowerControlCapability, o as BaseDeviceProvider, on as unknown, ot as normalizeUnit, p as EnumSensorDateTimeFormatSchema, q as enumSensorCapability, qt as entryBody, rn as record, rt as lockControlCapability, sn as url, st as notificationOutputCapability, t as HA_BROKER_KIND, tn as number, tt as ingestReading, un as DeviceType, v as RUNNING_STATE_COLD, vt as publicEndpointReaderFrom, w as ambientLightSensorCapability, wt as runningFromVacuumState, x as addonRoutesCapability, y as TargetSchema, yt as quantityFromUnit, zt as weatherCapability } from "./ha-broker-source-B2v2dnPe.mjs";
 import { randomUUID } from "node:crypto";
 import { brotliCompressSync, deflateSync, gzipSync } from "node:zlib";
 //#region src/ha-admin-link.ts
@@ -6327,6 +6327,7 @@ function mapCover(attributes, deviceClass) {
 	const features = [];
 	const sf = readNumericAttr(attributes, "supported_features");
 	if (sf !== null && (sf & 4) !== 0) features.push(DeviceFeature.CoverPositionable);
+	if (sf !== null && (sf & 8) !== 0) features.push(DeviceFeature.CoverStoppable);
 	if (sf !== null && (sf & 128) !== 0) features.push(DeviceFeature.CoverTilt);
 	return {
 		deviceType: DeviceType.Cover,

package/dist/{ha-broker-source-D3FBA6uG.mjs → ha-broker-source-B2v2dnPe.mjs}

@@ -784,7 +784,7 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	return EventCategory;
 }({});
 //#endregion
-//#region ../types/dist/device-type-BOWLtoOt.mjs
+//#region ../types/dist/device-type-CfHw_quR.mjs
 /**
 import { errMsg } from '@camstack/types'
 * Extract a human-readable message from an unknown error value.
@@ -973,6 +973,9 @@ var DeviceFeature = /* @__PURE__ */ function(DeviceFeature) {
 	DeviceFeature["CoverPositionable"] = "cover-positionable";
 	/** Cover exposes slat-tilt control. Gates the tilt slider UI. */
 	DeviceFeature["CoverTilt"] = "cover-tilt";
+	/** Cover has a real stop: `stop` halts the travel in place. Gates the stop
+	*  control in exporters; a provider whose `stop` is a no-op never declares it. */
+	DeviceFeature["CoverStoppable"] = "cover-stoppable";
 	/** Valve exposes intermediate position control (0..100). Gates the
 	*  position slider / drag surface UI. */
 	DeviceFeature["ValvePositionable"] = "valve-positionable";
@@ -5971,7 +5974,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-CdJHPm-k.mjs
+//#region ../types/dist/sleep-QsoHs66J.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -11757,7 +11760,7 @@ object({
 	params: record(string(), union([string(), number()])).optional()
 });
 //#endregion
-//#region ../types/dist/composition-BDUoQsw9.mjs
+//#region ../types/dist/composition-Dh3RfMx5.mjs
 /**
 * The ffmpeg build every CamStack node downloads, per platform and arch.
 *
@@ -55740,15 +55743,9 @@ var AvailableIntegrationTypeSchema = object({
 	* branch on CAP — never on addon name. `device-adoption` integrations
 	* (Home Assistant, …) route through the broker step (Approach A);
 	* `device-provider` integrations (Reolink/ONVIF) keep the
-	* legacy config → discovery flow. `connection` is an addon that only holds a
-	* connection as typed records (`integration-instances`, D985): no devices,
-	* no discovery.
+	* legacy config → discovery flow.
 	*/
-	kind: _enum([
-		"device-adoption",
-		"device-provider",
-		"connection"
-	]),
+	kind: _enum(["device-adoption", "device-provider"]),
 	/**
 	* For `device-adoption` addons: the broker kind to create/link
 	* (e.g. `home-assistant`), declared in the addon manifest. `null` for
@@ -55862,18 +55859,17 @@ method(_void(), array(IntegrationWithStateSchema)), method(object({ id: string()
 });
 /**
 * `integration-instances` - the connection of an addon that holds ONE or SEVERAL
-* (an account, a relay, a destination) as typed records, shown on the
-* Integrations page like every other integration (D985, D986).
+* (an account, a relay, a destination) as typed records (D985, D986). The addon's
+* own function page reads and writes them (Logging for Loki); the Integrations
+* page lists only the integrations that bring devices (D996).
 *
-* A collection of providers: each addon that holds connections registers one
-* and the hub aggregator (`integrations.*`) reaches a provider with the pinned
-* `addonId`. It is internal and has no route: the operator-facing surface is
-* the `integrations` cap, which keeps ONE list.
+* A collection of providers: each addon that holds connections registers one and a
+* caller reaches a provider with the pinned `addonId`.
 *
-* Identity: the instance id IS the `integrations` registry id (`int_NNNN`,
-* immutable, already in the `/integrations/<id>` URL). A second operator-chosen
-* slug would be a second authority over one identity (D224). `name` is the
-* editable label.
+* Identity: the instance id is immutable and opaque to the caller. A record the
+* Loki migration made keeps the `integrations` registry id it was created under
+* (`int_NNNN`); a single instance made by its function page takes the addon id.
+* `name` is the editable label.
 *
 * Secrets: every field the instance kind marks `.meta({ secret: true })` reaches
 * the form as a `SecretFieldView`, never text (D789). A patch value omitted, `''`
@@ -55914,13 +55910,25 @@ var IntegrationInstancePatchSchema = object({
 	/** Omitted / '' / redaction token keeps a secret; `{ $secretClear: true }` clears it. */
 	values: record(string(), unknown())
 });
-method(_void(), IntegrationInstanceDescriptionSchema), method(object({ id: IntegrationInstanceIdSchema.nullable() }), ConfigSchemaPassthrough$3), method(_void(), array(IntegrationInstanceSchema).readonly()), method(object({ id: IntegrationInstanceIdSchema }), IntegrationInstanceSchema.nullable()), method(object({
+method(_void(), IntegrationInstanceDescriptionSchema, { auth: "admin" }), method(object({ id: IntegrationInstanceIdSchema.nullable() }), ConfigSchemaPassthrough$3, { auth: "admin" }), method(_void(), array(IntegrationInstanceSchema).readonly(), { auth: "admin" }), method(object({ id: IntegrationInstanceIdSchema }), IntegrationInstanceSchema.nullable(), { auth: "admin" }), method(object({
 	id: IntegrationInstanceIdSchema,
 	name: string().min(1)
-}), object({ id: string() }), { kind: "mutation" }), method(IntegrationInstancePatchSchema, object({ ok: literal(true) }), { kind: "mutation" }), method(object({ id: IntegrationInstanceIdSchema }), object({ ok: literal(true) }), { kind: "mutation" }), optionalMethod(object({
+}), object({ id: string() }), {
+	kind: "mutation",
+	auth: "admin"
+}), method(IntegrationInstancePatchSchema, object({ ok: literal(true) }), {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({ id: IntegrationInstanceIdSchema }), object({ ok: literal(true) }), {
+	kind: "mutation",
+	auth: "admin"
+}), optionalMethod(object({
 	id: IntegrationInstanceIdSchema.nullable(),
 	values: record(string(), unknown())
-}), TestConnectionResultSchema$1, { kind: "mutation" });
+}), TestConnectionResultSchema$1, {
+	kind: "mutation",
+	auth: "admin"
+});
 /**
 * Two-way audio / talk-back cap. Clients open a WebRTC audio-only
 * session (server-initiated offer pattern, identical to the main
@@ -66689,7 +66697,14 @@ var NcMediaPolicySchema = object({
 	*/
 	profile: CamProfileSchema.optional(),
 	/** See {@link NcLinkedCameraModeSchema}. */
-	linkedCameras: NcLinkedCameraModeSchema.optional()
+	linkedCameras: NcLinkedCameraModeSchema.optional(),
+	/**
+	* Sensor rules only: may this rule wake a SLEEPING battery camera to take
+	* the linked still it attaches (D998)? Absent means yes, an explicit `false`
+	* opts out. Deliberately not a Zod default: a rule that never chose keeps
+	* following the hub's. One bounded wake per event; nothing is attached later.
+	*/
+	wakeSleepingCamera: boolean().optional()
 });
 /**
 * Cooldown GRANULARITY over the subject's class — how much a fired
@@ -75270,7 +75285,16 @@ var smokeCapability = {
 * future fields without breaking the existing call sites.
 */
 var EmailAddressSchema = email();
+/**
+* Which relay of a multi-relay provider answers (D996). Absent = the provider's first / default
+* relay, so a caller written before relays existed keeps working unchanged. A provider with one
+* fixed relay ignores it. This is the integration instance id (`int_NNNN`), NOT the addon id: the
+* collection pin `addonId` still picks the provider, `instanceId` picks the relay inside it.
+*/
+var InstanceIdSchema = string().min(1).optional();
+var RelayPinSchema = object({ instanceId: InstanceIdSchema });
 var SendEmailInputSchema = object({
+	instanceId: InstanceIdSchema,
 	to: union([EmailAddressSchema, array(EmailAddressSchema).min(1)]),
 	cc: array(EmailAddressSchema).optional(),
 	bcc: array(EmailAddressSchema).optional(),
@@ -75306,11 +75330,11 @@ method(SendEmailInputSchema, SendEmailResultSchema, {
 	kind: "mutation",
 	auth: "admin",
 	access: "create"
-}), method(_void(), SmtpStatusSchema, {
+}), method(RelayPinSchema, SmtpStatusSchema, {
 	kind: "mutation",
 	auth: "admin",
 	access: "view"
-}), method(_void(), SmtpStatusSchema, { auth: "admin" });
+}), method(RelayPinSchema, SmtpStatusSchema, { auth: "admin" });
 /**
 * A single device snapshot returned as base64 JPEG/PNG.
 *
@@ -75342,10 +75366,12 @@ DeviceType.Camera, method(object({
 	* even when the cache is well within the device's
 	* `snapshotMaxAgeS` window.
 	*
-	* **`force` is an OPERATOR signal, not a freshness preference.** On a
+	* **`force` is a demand with a named principal, not a freshness
+	* preference** — an operator button, the scheduled refresh (D847), or a
+	* notification rule that left the camera's wake allowed (D998). On a
 	* battery camera it is the one thing that walks past the wrapper's
-	* sleep gate and wakes the camera, so a background caller — a poller,
-	* an event handler, a thumbnail — must NEVER set it. Every such caller
+	* sleep gate and wakes the camera, so a poller, a thumbnail or a
+	* prestream must NEVER set it. Every such caller
 	* gets the cached frame, which on a sleeping battery camera is the
 	* correct answer: stale but honest beats woken.
 	*/
@@ -80195,7 +80221,7 @@ function runningFromMediaPlayer(state, previous, fetchedAt, transitionAt) {
 	if (state === "paused") return nativeSlice(false, "paused", previous, transitionAtMs, fetchedAt, null);
 	return nativeSlice(false, state, previous, transitionAtMs, fetchedAt, null);
 }
-DeviceFeature.FanSpeed, DeviceFeature.FanPreset, DeviceFeature.FanDirection, DeviceFeature.FanOscillating, DeviceFeature.CoverPositionable, DeviceFeature.CoverTilt, DeviceFeature.ValvePositionable, DeviceFeature.MediaPlayerVolume, DeviceFeature.ClimateFanMode;
+DeviceFeature.FanSpeed, DeviceFeature.FanPreset, DeviceFeature.FanDirection, DeviceFeature.FanOscillating, DeviceFeature.CoverStoppable, DeviceFeature.CoverPositionable, DeviceFeature.CoverTilt, DeviceFeature.ValvePositionable, DeviceFeature.MediaPlayerVolume, DeviceFeature.ClimateFanMode;
 SOURCE_CAPS.filter((cap) => cap !== "switch" && cap !== "motion");
 String.raw`rose\(active(\d+), changed(\d+), (\d+(?:\.\d+)?)\)`;
 DeviceRole.BinarySensor, DeviceRole.MotionSensor;

package/dist/{ha-broker-source-CE3nHkyW.js → ha-broker-source-DUj9pUWr.js}

@@ -785,7 +785,7 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	return EventCategory;
 }({});
 //#endregion
-//#region ../types/dist/device-type-BOWLtoOt.mjs
+//#region ../types/dist/device-type-CfHw_quR.mjs
 /**
 import { errMsg } from '@camstack/types'
 * Extract a human-readable message from an unknown error value.
@@ -974,6 +974,9 @@ var DeviceFeature = /* @__PURE__ */ function(DeviceFeature) {
 	DeviceFeature["CoverPositionable"] = "cover-positionable";
 	/** Cover exposes slat-tilt control. Gates the tilt slider UI. */
 	DeviceFeature["CoverTilt"] = "cover-tilt";
+	/** Cover has a real stop: `stop` halts the travel in place. Gates the stop
+	*  control in exporters; a provider whose `stop` is a no-op never declares it. */
+	DeviceFeature["CoverStoppable"] = "cover-stoppable";
 	/** Valve exposes intermediate position control (0..100). Gates the
 	*  position slider / drag surface UI. */
 	DeviceFeature["ValvePositionable"] = "valve-positionable";
@@ -5972,7 +5975,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-CdJHPm-k.mjs
+//#region ../types/dist/sleep-QsoHs66J.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -11758,7 +11761,7 @@ object({
 	params: record(string(), union([string(), number()])).optional()
 });
 //#endregion
-//#region ../types/dist/composition-BDUoQsw9.mjs
+//#region ../types/dist/composition-Dh3RfMx5.mjs
 /**
 * The ffmpeg build every CamStack node downloads, per platform and arch.
 *
@@ -55741,15 +55744,9 @@ var AvailableIntegrationTypeSchema = object({
 	* branch on CAP — never on addon name. `device-adoption` integrations
 	* (Home Assistant, …) route through the broker step (Approach A);
 	* `device-provider` integrations (Reolink/ONVIF) keep the
-	* legacy config → discovery flow. `connection` is an addon that only holds a
-	* connection as typed records (`integration-instances`, D985): no devices,
-	* no discovery.
+	* legacy config → discovery flow.
 	*/
-	kind: _enum([
-		"device-adoption",
-		"device-provider",
-		"connection"
-	]),
+	kind: _enum(["device-adoption", "device-provider"]),
 	/**
 	* For `device-adoption` addons: the broker kind to create/link
 	* (e.g. `home-assistant`), declared in the addon manifest. `null` for
@@ -55863,18 +55860,17 @@ method(_void(), array(IntegrationWithStateSchema)), method(object({ id: string()
 });
 /**
 * `integration-instances` - the connection of an addon that holds ONE or SEVERAL
-* (an account, a relay, a destination) as typed records, shown on the
-* Integrations page like every other integration (D985, D986).
+* (an account, a relay, a destination) as typed records (D985, D986). The addon's
+* own function page reads and writes them (Logging for Loki); the Integrations
+* page lists only the integrations that bring devices (D996).
 *
-* A collection of providers: each addon that holds connections registers one
-* and the hub aggregator (`integrations.*`) reaches a provider with the pinned
-* `addonId`. It is internal and has no route: the operator-facing surface is
-* the `integrations` cap, which keeps ONE list.
+* A collection of providers: each addon that holds connections registers one and a
+* caller reaches a provider with the pinned `addonId`.
 *
-* Identity: the instance id IS the `integrations` registry id (`int_NNNN`,
-* immutable, already in the `/integrations/<id>` URL). A second operator-chosen
-* slug would be a second authority over one identity (D224). `name` is the
-* editable label.
+* Identity: the instance id is immutable and opaque to the caller. A record the
+* Loki migration made keeps the `integrations` registry id it was created under
+* (`int_NNNN`); a single instance made by its function page takes the addon id.
+* `name` is the editable label.
 *
 * Secrets: every field the instance kind marks `.meta({ secret: true })` reaches
 * the form as a `SecretFieldView`, never text (D789). A patch value omitted, `''`
@@ -55915,13 +55911,25 @@ var IntegrationInstancePatchSchema = object({
 	/** Omitted / '' / redaction token keeps a secret; `{ $secretClear: true }` clears it. */
 	values: record(string(), unknown())
 });
-method(_void(), IntegrationInstanceDescriptionSchema), method(object({ id: IntegrationInstanceIdSchema.nullable() }), ConfigSchemaPassthrough$3), method(_void(), array(IntegrationInstanceSchema).readonly()), method(object({ id: IntegrationInstanceIdSchema }), IntegrationInstanceSchema.nullable()), method(object({
+method(_void(), IntegrationInstanceDescriptionSchema, { auth: "admin" }), method(object({ id: IntegrationInstanceIdSchema.nullable() }), ConfigSchemaPassthrough$3, { auth: "admin" }), method(_void(), array(IntegrationInstanceSchema).readonly(), { auth: "admin" }), method(object({ id: IntegrationInstanceIdSchema }), IntegrationInstanceSchema.nullable(), { auth: "admin" }), method(object({
 	id: IntegrationInstanceIdSchema,
 	name: string().min(1)
-}), object({ id: string() }), { kind: "mutation" }), method(IntegrationInstancePatchSchema, object({ ok: literal(true) }), { kind: "mutation" }), method(object({ id: IntegrationInstanceIdSchema }), object({ ok: literal(true) }), { kind: "mutation" }), optionalMethod(object({
+}), object({ id: string() }), {
+	kind: "mutation",
+	auth: "admin"
+}), method(IntegrationInstancePatchSchema, object({ ok: literal(true) }), {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({ id: IntegrationInstanceIdSchema }), object({ ok: literal(true) }), {
+	kind: "mutation",
+	auth: "admin"
+}), optionalMethod(object({
 	id: IntegrationInstanceIdSchema.nullable(),
 	values: record(string(), unknown())
-}), TestConnectionResultSchema$1, { kind: "mutation" });
+}), TestConnectionResultSchema$1, {
+	kind: "mutation",
+	auth: "admin"
+});
 /**
 * Two-way audio / talk-back cap. Clients open a WebRTC audio-only
 * session (server-initiated offer pattern, identical to the main
@@ -66690,7 +66698,14 @@ var NcMediaPolicySchema = object({
 	*/
 	profile: CamProfileSchema.optional(),
 	/** See {@link NcLinkedCameraModeSchema}. */
-	linkedCameras: NcLinkedCameraModeSchema.optional()
+	linkedCameras: NcLinkedCameraModeSchema.optional(),
+	/**
+	* Sensor rules only: may this rule wake a SLEEPING battery camera to take
+	* the linked still it attaches (D998)? Absent means yes, an explicit `false`
+	* opts out. Deliberately not a Zod default: a rule that never chose keeps
+	* following the hub's. One bounded wake per event; nothing is attached later.
+	*/
+	wakeSleepingCamera: boolean().optional()
 });
 /**
 * Cooldown GRANULARITY over the subject's class — how much a fired
@@ -75271,7 +75286,16 @@ var smokeCapability = {
 * future fields without breaking the existing call sites.
 */
 var EmailAddressSchema = email();
+/**
+* Which relay of a multi-relay provider answers (D996). Absent = the provider's first / default
+* relay, so a caller written before relays existed keeps working unchanged. A provider with one
+* fixed relay ignores it. This is the integration instance id (`int_NNNN`), NOT the addon id: the
+* collection pin `addonId` still picks the provider, `instanceId` picks the relay inside it.
+*/
+var InstanceIdSchema = string().min(1).optional();
+var RelayPinSchema = object({ instanceId: InstanceIdSchema });
 var SendEmailInputSchema = object({
+	instanceId: InstanceIdSchema,
 	to: union([EmailAddressSchema, array(EmailAddressSchema).min(1)]),
 	cc: array(EmailAddressSchema).optional(),
 	bcc: array(EmailAddressSchema).optional(),
@@ -75307,11 +75331,11 @@ method(SendEmailInputSchema, SendEmailResultSchema, {
 	kind: "mutation",
 	auth: "admin",
 	access: "create"
-}), method(_void(), SmtpStatusSchema, {
+}), method(RelayPinSchema, SmtpStatusSchema, {
 	kind: "mutation",
 	auth: "admin",
 	access: "view"
-}), method(_void(), SmtpStatusSchema, { auth: "admin" });
+}), method(RelayPinSchema, SmtpStatusSchema, { auth: "admin" });
 /**
 * A single device snapshot returned as base64 JPEG/PNG.
 *
@@ -75343,10 +75367,12 @@ DeviceType.Camera, method(object({
 	* even when the cache is well within the device's
 	* `snapshotMaxAgeS` window.
 	*
-	* **`force` is an OPERATOR signal, not a freshness preference.** On a
+	* **`force` is a demand with a named principal, not a freshness
+	* preference** — an operator button, the scheduled refresh (D847), or a
+	* notification rule that left the camera's wake allowed (D998). On a
 	* battery camera it is the one thing that walks past the wrapper's
-	* sleep gate and wakes the camera, so a background caller — a poller,
-	* an event handler, a thumbnail — must NEVER set it. Every such caller
+	* sleep gate and wakes the camera, so a poller, a thumbnail or a
+	* prestream must NEVER set it. Every such caller
 	* gets the cached frame, which on a sleeping battery camera is the
 	* correct answer: stale but honest beats woken.
 	*/
@@ -80196,7 +80222,7 @@ function runningFromMediaPlayer(state, previous, fetchedAt, transitionAt) {
 	if (state === "paused") return nativeSlice(false, "paused", previous, transitionAtMs, fetchedAt, null);
 	return nativeSlice(false, state, previous, transitionAtMs, fetchedAt, null);
 }
-DeviceFeature.FanSpeed, DeviceFeature.FanPreset, DeviceFeature.FanDirection, DeviceFeature.FanOscillating, DeviceFeature.CoverPositionable, DeviceFeature.CoverTilt, DeviceFeature.ValvePositionable, DeviceFeature.MediaPlayerVolume, DeviceFeature.ClimateFanMode;
+DeviceFeature.FanSpeed, DeviceFeature.FanPreset, DeviceFeature.FanDirection, DeviceFeature.FanOscillating, DeviceFeature.CoverStoppable, DeviceFeature.CoverPositionable, DeviceFeature.CoverTilt, DeviceFeature.ValvePositionable, DeviceFeature.MediaPlayerVolume, DeviceFeature.ClimateFanMode;
 SOURCE_CAPS.filter((cap) => cap !== "switch" && cap !== "motion");
 String.raw`rose\(active(\d+), changed(\d+), (\d+(?:\.\d+)?)\)`;
 DeviceRole.BinarySensor, DeviceRole.MotionSensor;

package/dist/ha-export/ha-export.addon.js

@@ -24,7 +24,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-const require_ha_broker_source = require("../ha-broker-source-CE3nHkyW.js");
+const require_ha_broker_source = require("../ha-broker-source-DUj9pUWr.js");
 let node_crypto = require("node:crypto");
 require("node:zlib");
 let node_fs = require("node:fs");
@@ -975,19 +975,22 @@ var NATIVE_CAP_PLATFORMS = {
 	*/
 	cover: {
 		platform: "cover",
+		availableWhenOnline: true,
 		primary: { from: null },
 		controls: {
 			position: {
 				from: "position",
 				min: 0,
 				max: 100,
-				step: 1
+				step: 1,
+				requiresFeature: "cover-positionable"
 			},
 			tilt: {
 				from: "tilt",
 				min: 0,
 				max: 100,
-				step: 1
+				step: 1,
+				requiresFeature: "cover-tilt"
 			},
 			open: {
 				from: "open",
@@ -999,7 +1002,8 @@ var NATIVE_CAP_PLATFORMS = {
 			},
 			stop: {
 				from: "stop",
-				commandOnly: true
+				commandOnly: true,
+				requiresFeature: "cover-stoppable"
 			}
 		}
 	},
@@ -1388,9 +1392,11 @@ function buildNativeComponent(input) {
 	if (native === void 0) return null;
 	const primary = resolveBinding(input, native.primary);
 	if (primary === null) return null;
+	const features = input.features ?? [];
 	const absorbed = new Set([derivedEntityId(input.capName), ...primary.entities]);
 	const controls = {};
 	for (const [name, binding] of Object.entries(native.controls ?? {})) {
+		if (binding.requiresFeature !== void 0 && !features.includes(binding.requiresFeature)) continue;
 		const resolved = resolveBinding(input, binding);
 		if (resolved === null) continue;
 		controls[name] = resolved.control;
@@ -1409,6 +1415,11 @@ function buildNativeComponent(input) {
 			...primary.control,
 			...native.deviceClass !== void 0 ? { device_class: native.deviceClass } : {},
 			...native.icon !== void 0 ? { icon: native.icon } : {},
+			...native.availableWhenOnline === true ? {
+				availability_topic: stateTopic(input.deviceKey, "online"),
+				payload_available: "true",
+				payload_not_available: "false"
+			} : {},
 			...Object.keys(controls).length > 0 ? { controls } : {},
 			...native.constants,
 			...flags
@@ -2343,7 +2354,8 @@ var CAP_ENTITY_MAP = {
 				unit: "%",
 				icon: "mdi:arrow-up-down",
 				writable: true,
-				range: PERCENT_RANGE
+				range: PERCENT_RANGE,
+				requiresFeature: "cover-positionable"
 			},
 			tilt: {
 				platform: "number",
@@ -2353,7 +2365,8 @@ var CAP_ENTITY_MAP = {
 				icon: "mdi:angle-acute",
 				writable: true,
 				range: PERCENT_RANGE,
-				enabledByDefault: false
+				enabledByDefault: false,
+				requiresFeature: "cover-tilt"
 			}
 		},
 		commands: {
@@ -2368,7 +2381,8 @@ var CAP_ENTITY_MAP = {
 			stop: {
 				label: "Stop",
 				icon: "mdi:stop",
-				enabledByDefault: false
+				enabledByDefault: false,
+				requiresFeature: "cover-stoppable"
 			}
 		}
 	},
@@ -3375,7 +3389,8 @@ function capEntities(capName) {
 	for (const [suffix, extra] of Object.entries(mapping.extras ?? {})) refs.push({
 		entity: derivedExtraEntityId(capName, suffix),
 		label: extra.label,
-		descriptor: extra
+		descriptor: extra,
+		...extra.requiresFeature !== void 0 ? { requiresFeature: extra.requiresFeature } : {}
 	});
 	return refs;
 }
@@ -3394,8 +3409,9 @@ function deriveCapValue(derivation, raw) {
 	return derivation.kind === "equals" ? raw === derivation.value : raw !== derivation.value;
 }
 /** A capability's entities as the catalog builders consume them. */
-function capEntitySpecs(capName) {
-	const specs = capEntities(capName).map((ref) => ({
+function capEntitySpecs(capName, features = []) {
+	const declared = (required) => required === void 0 || features.includes(required);
+	const specs = capEntities(capName).filter((ref) => declared(ref.requiresFeature)).map((ref) => ({
 		entity: ref.entity,
 		platform: ref.descriptor.platform,
 		label: ref.label,
@@ -3408,15 +3424,18 @@ function capEntitySpecs(capName) {
 		...ref.descriptor.entityCategory !== void 0 ? { entityCategory: ref.descriptor.entityCategory } : {},
 		...ref.descriptor.writable === true ? { writable: true } : {}
 	}));
-	for (const ref of capCommandEntities(capName)) specs.push({
-		entity: ref.entity,
-		platform: "button",
-		label: ref.label,
-		enabledByDefault: ref.command.enabledByDefault ?? true,
-		writable: true,
-		...ref.command.icon !== void 0 ? { icon: ref.command.icon } : {},
-		...ref.command.entityCategory !== void 0 ? { entityCategory: ref.command.entityCategory } : {}
-	});
+	for (const ref of capCommandEntities(capName)) {
+		if (!declared(ref.command.requiresFeature)) continue;
+		specs.push({
+			entity: ref.entity,
+			platform: "button",
+			label: ref.label,
+			enabledByDefault: ref.command.enabledByDefault ?? true,
+			writable: true,
+			...ref.command.icon !== void 0 ? { icon: ref.command.icon } : {},
+			...ref.command.entityCategory !== void 0 ? { entityCategory: ref.command.entityCategory } : {}
+		});
+	}
 	return specs;
 }
 function readControlOptions(slice) {
@@ -3794,11 +3813,12 @@ function buildDerivedPlan(device, options = UNNEGOTIATED_PLAN_OPTIONS) {
 			deviceId: device.id,
 			capName: cap,
 			label: humanise(cap),
+			features: device.features,
 			slice: device.capSlices?.[cap],
 			mapping
 		});
 		if (plan === null) {
-			specs.push(...capEntitySpecs(cap).map((spec) => degradeUnsupported(spec, options)));
+			specs.push(...capEntitySpecs(cap, device.features).map((spec) => degradeUnsupported(spec, options)));
 			continue;
 		}
 		native[toComponentKey(plan.component.platform, derivedEntityId(cap))] = plan.component;
@@ -3809,7 +3829,7 @@ function buildDerivedPlan(device, options = UNNEGOTIATED_PLAN_OPTIONS) {
 		* to make the device look tidy would be a silent loss of a value an
 		* operator already automates on.
 		*/
-		specs.push(...capEntitySpecs(cap).filter((spec) => !plan.absorbed.has(spec.entity)));
+		specs.push(...capEntitySpecs(cap, device.features).filter((spec) => !plan.absorbed.has(spec.entity)));
 	}
 	const assembled = assemble(device, specs);
 	return {
@@ -4671,6 +4691,15 @@ function isCameraCommand(command) {
 function isCapCommand(command) {
 	return !isCameraCommand(command);
 }
+var APPLIED = { ok: true };
+/** The 422 body of a command that was not applied: the reason travels with it. */
+function commandNotAppliedBody(refusal) {
+	return {
+		error: "command not applied",
+		reason: refusal.reason,
+		...refusal.message !== void 0 ? { message: refusal.message } : {}
+	};
+}
 /**
 * Make the call the command names.
 *
@@ -9168,9 +9197,23 @@ var HaExportAddon = class extends require_ha_broker_source.BaseAddon {
 			reply.send({ error: `unroutable command (${resolution.reason})` });
 			return;
 		}
-		const applied = await this.dispatch(resolution.command);
-		reply.status(applied ? 200 : 422);
-		reply.send(applied ? {} : { error: "command not applied" });
+		const outcome = await this.dispatch(resolution.command);
+		if (outcome.ok) {
+			reply.status(200);
+			reply.send({});
+			return;
+		}
+		this.ctx.logger.warn("ha-export: command answered 422", {
+			tags: { deviceId: exported.deviceId },
+			meta: {
+				topic,
+				entity: parsed.entity,
+				reason: outcome.reason,
+				message: outcome.message
+			}
+		});
+		reply.status(422);
+		reply.send(commandNotAppliedBody(outcome));
 	}
 	async dispatch(command) {
 		try {
@@ -9184,7 +9227,7 @@ var HaExportAddon = class extends require_ha_broker_source.BaseAddon {
 			*/
 			if (isCapCommand(command)) {
 				const outcome = await applyCapCommand(await this.ctx.fetchDevice(command.deviceId), command);
-				if (outcome.ok) return true;
+				if (outcome.ok) return APPLIED;
 				if (outcome.reason === "no-provider") return this.noProvider(command.deviceId, outcome.capName);
 				this.ctx.logger.warn("ha-export: the device refused the command", {
 					tags: { deviceId: command.deviceId },
@@ -9194,7 +9237,11 @@ var HaExportAddon = class extends require_ha_broker_source.BaseAddon {
 						...outcome.error !== void 0 ? { error: outcome.error } : {}
 					}
 				});
-				return false;
+				return {
+					ok: false,
+					reason: outcome.reason,
+					...outcome.error !== void 0 ? { message: outcome.error } : {}
+				};
 			}
 			switch (command.kind) {
 				case "camera-function": {
@@ -9204,7 +9251,11 @@ var HaExportAddon = class extends require_ha_broker_source.BaseAddon {
 							tags: { deviceId: command.deviceId },
 							meta: { switchId: command.switchId }
 						});
-						return false;
+						return {
+							ok: false,
+							reason: "unknown-function",
+							message: "the switch id is not a camera function"
+						};
 					}
 					/**
 					* A FRESH read for this one device — the pass-level caches are up to
@@ -9214,7 +9265,11 @@ var HaExportAddon = class extends require_ha_broker_source.BaseAddon {
 					const device = await this.ctx.api.deviceManager.getDevice.query({ deviceId: command.deviceId });
 					if (device === null) {
 						this.ctx.logger.warn("ha-export: dropping a camera-function command, the device is not in the registry", { tags: { deviceId: command.deviceId } });
-						return false;
+						return {
+							ok: false,
+							reason: "device-not-found",
+							message: "the device is not in the registry"
+						};
 					}
 					const privacySlice = await this.ctx.api.deviceState.getCapSlice.query({
 						deviceId: command.deviceId,
@@ -9250,22 +9305,26 @@ var HaExportAddon = class extends require_ha_broker_source.BaseAddon {
 							tags: { deviceId: command.deviceId },
 							meta: { switchId: parsed.data }
 						});
-						return false;
+						return {
+							ok: false,
+							reason: "function-unavailable",
+							message: "the camera function is not available"
+						};
 					}
 					await applyCameraFunctionWrite(this.ctx.api, command.deviceId, write, sourceNodeId);
-					return true;
+					return APPLIED;
 				}
 				case "reboot": {
 					const device = await this.ctx.fetchDevice(command.deviceId);
 					if (device.reboot === void 0) return this.noProvider(command.deviceId, "reboot");
 					await device.reboot.reboot({});
-					return true;
+					return APPLIED;
 				}
 				case "ptz-move": {
 					const device = await this.ctx.fetchDevice(command.deviceId);
 					if (device.ptz === void 0) return this.noProvider(command.deviceId, "ptz");
 					await device.ptz.move(PTZ_MOVE_BY_DIRECTION[command.direction] ?? {});
-					return true;
+					return APPLIED;
 				}
 				case "ptz-preset": {
 					const device = await this.ctx.fetchDevice(command.deviceId);
@@ -9276,10 +9335,14 @@ var HaExportAddon = class extends require_ha_broker_source.BaseAddon {
 							tags: { deviceId: command.deviceId },
 							meta: { preset: command.preset }
 						});
-						return false;
+						return {
+							ok: false,
+							reason: "no-such-preset",
+							message: "no preset by that name"
+						};
 					}
 					await device.ptz.goToPreset({ presetId: preset.id });
-					return true;
+					return APPLIED;
 				}
 			}
 		} catch (err) {
@@ -9295,7 +9358,11 @@ var HaExportAddon = class extends require_ha_broker_source.BaseAddon {
 					error: errMsg(err)
 				}
 			});
-			return false;
+			return {
+				ok: false,
+				reason: "error",
+				message: errMsg(err)
+			};
 		}
 	}
 	/** A cap the device does not provide. Refused, and never silently. */
@@ -9304,7 +9371,11 @@ var HaExportAddon = class extends require_ha_broker_source.BaseAddon {
 			tags: { deviceId },
 			meta: { capName }
 		});
-		return false;
+		return {
+			ok: false,
+			reason: "no-provider",
+			message: `the device has no provider for ${capName}`
+		};
 	}
 	/**
 	* A public, signed, expiring route Home Assistant can fetch bytes from.

package/dist/ha-export/ha-export.addon.mjs

@@ -1,4 +1,4 @@
-import { B as consumableKindOf, Bt as BaseAddon, Dt as sendToExportedTarget, Ht as baseUnitOf, Jt as isReadingQuantity, K as deviceExportCapability, Wt as defineAddonMigrations, Yt as nodePin, Zt as array, _ as PLUG_APPLIANCE_TYPES, _t as pruneDeletedEntities, c as COCO_TO_MACRO, d as ConsumableItemSchema, f as ConsumableStatusSchema, fn as EventCategory, g as MediaPlayerRepeatSchema, h as HvacModeSchema, i as AlarmArmModeSchema, in as string, j as buildAddonRouteProvider, l as CameraSwitchIdSchema, m as FanDirectionSchema, nn as object, on as unknown, pt as preconditionOf, r as listHomeAssistantBrokers, s as CAMERA_SWITCH_ORDER, u as ConsumableFormSchema, ut as oauthIntegrationCapability, x as addonRoutesCapability, xt as runExportedAction, z as consumableFormOf } from "../ha-broker-source-D3FBA6uG.mjs";
+import { B as consumableKindOf, Bt as BaseAddon, Dt as sendToExportedTarget, Ht as baseUnitOf, Jt as isReadingQuantity, K as deviceExportCapability, Wt as defineAddonMigrations, Yt as nodePin, Zt as array, _ as PLUG_APPLIANCE_TYPES, _t as pruneDeletedEntities, c as COCO_TO_MACRO, d as ConsumableItemSchema, f as ConsumableStatusSchema, fn as EventCategory, g as MediaPlayerRepeatSchema, h as HvacModeSchema, i as AlarmArmModeSchema, in as string, j as buildAddonRouteProvider, l as CameraSwitchIdSchema, m as FanDirectionSchema, nn as object, on as unknown, pt as preconditionOf, r as listHomeAssistantBrokers, s as CAMERA_SWITCH_ORDER, u as ConsumableFormSchema, ut as oauthIntegrationCapability, x as addonRoutesCapability, xt as runExportedAction, z as consumableFormOf } from "../ha-broker-source-B2v2dnPe.mjs";
 import { createHmac, timingSafeEqual } from "node:crypto";
 import "node:zlib";
 import "node:fs";
@@ -940,19 +940,22 @@ var NATIVE_CAP_PLATFORMS = {
 	*/
 	cover: {
 		platform: "cover",
+		availableWhenOnline: true,
 		primary: { from: null },
 		controls: {
 			position: {
 				from: "position",
 				min: 0,
 				max: 100,
-				step: 1
+				step: 1,
+				requiresFeature: "cover-positionable"
 			},
 			tilt: {
 				from: "tilt",
 				min: 0,
 				max: 100,
-				step: 1
+				step: 1,
+				requiresFeature: "cover-tilt"
 			},
 			open: {
 				from: "open",
@@ -964,7 +967,8 @@ var NATIVE_CAP_PLATFORMS = {
 			},
 			stop: {
 				from: "stop",
-				commandOnly: true
+				commandOnly: true,
+				requiresFeature: "cover-stoppable"
 			}
 		}
 	},
@@ -1353,9 +1357,11 @@ function buildNativeComponent(input) {
 	if (native === void 0) return null;
 	const primary = resolveBinding(input, native.primary);
 	if (primary === null) return null;
+	const features = input.features ?? [];
 	const absorbed = new Set([derivedEntityId(input.capName), ...primary.entities]);
 	const controls = {};
 	for (const [name, binding] of Object.entries(native.controls ?? {})) {
+		if (binding.requiresFeature !== void 0 && !features.includes(binding.requiresFeature)) continue;
 		const resolved = resolveBinding(input, binding);
 		if (resolved === null) continue;
 		controls[name] = resolved.control;
@@ -1374,6 +1380,11 @@ function buildNativeComponent(input) {
 			...primary.control,
 			...native.deviceClass !== void 0 ? { device_class: native.deviceClass } : {},
 			...native.icon !== void 0 ? { icon: native.icon } : {},
+			...native.availableWhenOnline === true ? {
+				availability_topic: stateTopic(input.deviceKey, "online"),
+				payload_available: "true",
+				payload_not_available: "false"
+			} : {},
 			...Object.keys(controls).length > 0 ? { controls } : {},
 			...native.constants,
 			...flags
@@ -2308,7 +2319,8 @@ var CAP_ENTITY_MAP = {
 				unit: "%",
 				icon: "mdi:arrow-up-down",
 				writable: true,
-				range: PERCENT_RANGE
+				range: PERCENT_RANGE,
+				requiresFeature: "cover-positionable"
 			},
 			tilt: {
 				platform: "number",
@@ -2318,7 +2330,8 @@ var CAP_ENTITY_MAP = {
 				icon: "mdi:angle-acute",
 				writable: true,
 				range: PERCENT_RANGE,
-				enabledByDefault: false
+				enabledByDefault: false,
+				requiresFeature: "cover-tilt"
 			}
 		},
 		commands: {
@@ -2333,7 +2346,8 @@ var CAP_ENTITY_MAP = {
 			stop: {
 				label: "Stop",
 				icon: "mdi:stop",
-				enabledByDefault: false
+				enabledByDefault: false,
+				requiresFeature: "cover-stoppable"
 			}
 		}
 	},
@@ -3340,7 +3354,8 @@ function capEntities(capName) {
 	for (const [suffix, extra] of Object.entries(mapping.extras ?? {})) refs.push({
 		entity: derivedExtraEntityId(capName, suffix),
 		label: extra.label,
-		descriptor: extra
+		descriptor: extra,
+		...extra.requiresFeature !== void 0 ? { requiresFeature: extra.requiresFeature } : {}
 	});
 	return refs;
 }
@@ -3359,8 +3374,9 @@ function deriveCapValue(derivation, raw) {
 	return derivation.kind === "equals" ? raw === derivation.value : raw !== derivation.value;
 }
 /** A capability's entities as the catalog builders consume them. */
-function capEntitySpecs(capName) {
-	const specs = capEntities(capName).map((ref) => ({
+function capEntitySpecs(capName, features = []) {
+	const declared = (required) => required === void 0 || features.includes(required);
+	const specs = capEntities(capName).filter((ref) => declared(ref.requiresFeature)).map((ref) => ({
 		entity: ref.entity,
 		platform: ref.descriptor.platform,
 		label: ref.label,
@@ -3373,15 +3389,18 @@ function capEntitySpecs(capName) {
 		...ref.descriptor.entityCategory !== void 0 ? { entityCategory: ref.descriptor.entityCategory } : {},
 		...ref.descriptor.writable === true ? { writable: true } : {}
 	}));
-	for (const ref of capCommandEntities(capName)) specs.push({
-		entity: ref.entity,
-		platform: "button",
-		label: ref.label,
-		enabledByDefault: ref.command.enabledByDefault ?? true,
-		writable: true,
-		...ref.command.icon !== void 0 ? { icon: ref.command.icon } : {},
-		...ref.command.entityCategory !== void 0 ? { entityCategory: ref.command.entityCategory } : {}
-	});
+	for (const ref of capCommandEntities(capName)) {
+		if (!declared(ref.command.requiresFeature)) continue;
+		specs.push({
+			entity: ref.entity,
+			platform: "button",
+			label: ref.label,
+			enabledByDefault: ref.command.enabledByDefault ?? true,
+			writable: true,
+			...ref.command.icon !== void 0 ? { icon: ref.command.icon } : {},
+			...ref.command.entityCategory !== void 0 ? { entityCategory: ref.command.entityCategory } : {}
+		});
+	}
 	return specs;
 }
 function readControlOptions(slice) {
@@ -3759,11 +3778,12 @@ function buildDerivedPlan(device, options = UNNEGOTIATED_PLAN_OPTIONS) {
 			deviceId: device.id,
 			capName: cap,
 			label: humanise(cap),
+			features: device.features,
 			slice: device.capSlices?.[cap],
 			mapping
 		});
 		if (plan === null) {
-			specs.push(...capEntitySpecs(cap).map((spec) => degradeUnsupported(spec, options)));
+			specs.push(...capEntitySpecs(cap, device.features).map((spec) => degradeUnsupported(spec, options)));
 			continue;
 		}
 		native[toComponentKey(plan.component.platform, derivedEntityId(cap))] = plan.component;
@@ -3774,7 +3794,7 @@ function buildDerivedPlan(device, options = UNNEGOTIATED_PLAN_OPTIONS) {
 		* to make the device look tidy would be a silent loss of a value an
 		* operator already automates on.
 		*/
-		specs.push(...capEntitySpecs(cap).filter((spec) => !plan.absorbed.has(spec.entity)));
+		specs.push(...capEntitySpecs(cap, device.features).filter((spec) => !plan.absorbed.has(spec.entity)));
 	}
 	const assembled = assemble(device, specs);
 	return {
@@ -4636,6 +4656,15 @@ function isCameraCommand(command) {
 function isCapCommand(command) {
 	return !isCameraCommand(command);
 }
+var APPLIED = { ok: true };
+/** The 422 body of a command that was not applied: the reason travels with it. */
+function commandNotAppliedBody(refusal) {
+	return {
+		error: "command not applied",
+		reason: refusal.reason,
+		...refusal.message !== void 0 ? { message: refusal.message } : {}
+	};
+}
 /**
 * Make the call the command names.
 *
@@ -9133,9 +9162,23 @@ var HaExportAddon = class extends BaseAddon {
 			reply.send({ error: `unroutable command (${resolution.reason})` });
 			return;
 		}
-		const applied = await this.dispatch(resolution.command);
-		reply.status(applied ? 200 : 422);
-		reply.send(applied ? {} : { error: "command not applied" });
+		const outcome = await this.dispatch(resolution.command);
+		if (outcome.ok) {
+			reply.status(200);
+			reply.send({});
+			return;
+		}
+		this.ctx.logger.warn("ha-export: command answered 422", {
+			tags: { deviceId: exported.deviceId },
+			meta: {
+				topic,
+				entity: parsed.entity,
+				reason: outcome.reason,
+				message: outcome.message
+			}
+		});
+		reply.status(422);
+		reply.send(commandNotAppliedBody(outcome));
 	}
 	async dispatch(command) {
 		try {
@@ -9149,7 +9192,7 @@ var HaExportAddon = class extends BaseAddon {
 			*/
 			if (isCapCommand(command)) {
 				const outcome = await applyCapCommand(await this.ctx.fetchDevice(command.deviceId), command);
-				if (outcome.ok) return true;
+				if (outcome.ok) return APPLIED;
 				if (outcome.reason === "no-provider") return this.noProvider(command.deviceId, outcome.capName);
 				this.ctx.logger.warn("ha-export: the device refused the command", {
 					tags: { deviceId: command.deviceId },
@@ -9159,7 +9202,11 @@ var HaExportAddon = class extends BaseAddon {
 						...outcome.error !== void 0 ? { error: outcome.error } : {}
 					}
 				});
-				return false;
+				return {
+					ok: false,
+					reason: outcome.reason,
+					...outcome.error !== void 0 ? { message: outcome.error } : {}
+				};
 			}
 			switch (command.kind) {
 				case "camera-function": {
@@ -9169,7 +9216,11 @@ var HaExportAddon = class extends BaseAddon {
 							tags: { deviceId: command.deviceId },
 							meta: { switchId: command.switchId }
 						});
-						return false;
+						return {
+							ok: false,
+							reason: "unknown-function",
+							message: "the switch id is not a camera function"
+						};
 					}
 					/**
 					* A FRESH read for this one device — the pass-level caches are up to
@@ -9179,7 +9230,11 @@ var HaExportAddon = class extends BaseAddon {
 					const device = await this.ctx.api.deviceManager.getDevice.query({ deviceId: command.deviceId });
 					if (device === null) {
 						this.ctx.logger.warn("ha-export: dropping a camera-function command, the device is not in the registry", { tags: { deviceId: command.deviceId } });
-						return false;
+						return {
+							ok: false,
+							reason: "device-not-found",
+							message: "the device is not in the registry"
+						};
 					}
 					const privacySlice = await this.ctx.api.deviceState.getCapSlice.query({
 						deviceId: command.deviceId,
@@ -9215,22 +9270,26 @@ var HaExportAddon = class extends BaseAddon {
 							tags: { deviceId: command.deviceId },
 							meta: { switchId: parsed.data }
 						});
-						return false;
+						return {
+							ok: false,
+							reason: "function-unavailable",
+							message: "the camera function is not available"
+						};
 					}
 					await applyCameraFunctionWrite(this.ctx.api, command.deviceId, write, sourceNodeId);
-					return true;
+					return APPLIED;
 				}
 				case "reboot": {
 					const device = await this.ctx.fetchDevice(command.deviceId);
 					if (device.reboot === void 0) return this.noProvider(command.deviceId, "reboot");
 					await device.reboot.reboot({});
-					return true;
+					return APPLIED;
 				}
 				case "ptz-move": {
 					const device = await this.ctx.fetchDevice(command.deviceId);
 					if (device.ptz === void 0) return this.noProvider(command.deviceId, "ptz");
 					await device.ptz.move(PTZ_MOVE_BY_DIRECTION[command.direction] ?? {});
-					return true;
+					return APPLIED;
 				}
 				case "ptz-preset": {
 					const device = await this.ctx.fetchDevice(command.deviceId);
@@ -9241,10 +9300,14 @@ var HaExportAddon = class extends BaseAddon {
 							tags: { deviceId: command.deviceId },
 							meta: { preset: command.preset }
 						});
-						return false;
+						return {
+							ok: false,
+							reason: "no-such-preset",
+							message: "no preset by that name"
+						};
 					}
 					await device.ptz.goToPreset({ presetId: preset.id });
-					return true;
+					return APPLIED;
 				}
 			}
 		} catch (err) {
@@ -9260,7 +9323,11 @@ var HaExportAddon = class extends BaseAddon {
 					error: errMsg(err)
 				}
 			});
-			return false;
+			return {
+				ok: false,
+				reason: "error",
+				message: errMsg(err)
+			};
 		}
 	}
 	/** A cap the device does not provide. Refused, and never silently. */
@@ -9269,7 +9336,11 @@ var HaExportAddon = class extends BaseAddon {
 			tags: { deviceId },
 			meta: { capName }
 		});
-		return false;
+		return {
+			ok: false,
+			reason: "no-provider",
+			message: `the device has no provider for ${capName}`
+		};
 	}
 	/**
 	* A public, signed, expiring route Home Assistant can fetch bytes from.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-homeassistant",
-  "version": "1.2.649",
+  "version": "1.2.650",
   "description": "Home Assistant device provider addon for CamStack",
   "keywords": [
     "camstack",
@@ -127,7 +127,7 @@
       "description": "Device provider (import) + native entity export (push). Two addons, one bundle, separate processes."
     },
     "requires": {
-      "server": ">=1.2.738"
+      "server": ">=1.2.740"
     }
   },
   "files": [