@camstack/addon-provider-homeassistant 1.2.155 → 1.2.156

package/dist/addon.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_dist = require("./dist-CERTsNmo.js");
+const require_dist = require("./dist-CUS3XDdU.js");
 let node_crypto = require("node:crypto");
 let node_zlib = require("node:zlib");
 //#region src/ha-admin-link.ts
@@ -7047,6 +7047,11 @@ function createHaNotificationOutputProvider(deps) {
 			}
 			return out;
 		},
+		probeTargetConfig: async ({ kind }) => ({
+			ok: false,
+			resolvedUrl: "",
+			error: `Kind '${kind}' does not support credential probing`
+		}),
 		send: async ({ targetId, notification }) => {
 			const target = await store.getById(targetId);
 			if (!target) return {

package/dist/addon.mjs

@@ -1,4 +1,4 @@
-import { A as connectivityCapability, At as string, B as floodCapability, C as buildAddonRouteProvider, Ct as _enum, D as carbonMonoxideCapability, Dt as number, E as calendarSourceCapability, Et as literal, F as deviceAdoptionCapability, G as lawnMowerControlCapability, H as humidifierCapability, J as motionCapability, K as lockControlCapability, L as enumSensorCapability, M as controlCapability, Mt as unknown, N as coverCapability, Nt as url, O as climateControlCapability, Ot as object, P as deviceAdminLinkCapability, Pt as EventCategory, Q as numericSensorCapability, R as eventEmitterCapability, S as brokerCapability, T as buttonCapability, Tt as discriminatedUnion, U as humiditySensorCapability, V as gasCapability, W as imageCapability, X as notificationOutputCapability, Y as normalizeUnit, Z as notifierCapability, _ as automationControlCapability, _t as DeviceRole, at as scriptRunnerCapability, b as binaryCapability, ct as tamperCapability, d as TargetSchema, dt as vacuumControlCapability, et as parseAdminBase, f as accessoriesCapability, ft as valveCapability, g as ambientLightSensorCapability, gt as DeviceFeature, h as alarmPanelCapability, ht as weatherCapability, it as pressureSensorCapability, j as contactCapability, jt as union, k as colorCapability, kt as record, lt as temperatureSensorCapability, m as airQualitySensorCapability, mt as waterHeaterCapability, n as BaseDevice, nt as prepareNotification, ot as smokeCapability, p as addonRoutesCapability, pt as vibrationCapability, q as mediaPlayerCapability, r as BaseDeviceProvider, rt as presenceCapability, s as EnumSensorDateTimeFormatSchema, st as switchCapability, tt as powerMeterCapability, ut as updateCapability, v as batteryCapability, vt as DeviceType, w as buildDeviceAdminUrl, wt as array, x as brightnessCapability, xt as createEvent, y as bestLocationMatch, yt as errMsg, z as fanControlCapability } from "./dist-DqKiElqb.mjs";
+import { A as connectivityCapability, At as string, B as floodCapability, C as buildAddonRouteProvider, Ct as _enum, D as carbonMonoxideCapability, Dt as number, E as calendarSourceCapability, Et as literal, F as deviceAdoptionCapability, G as lawnMowerControlCapability, H as humidifierCapability, J as motionCapability, K as lockControlCapability, L as enumSensorCapability, M as controlCapability, Mt as unknown, N as coverCapability, Nt as url, O as climateControlCapability, Ot as object, P as deviceAdminLinkCapability, Pt as EventCategory, Q as numericSensorCapability, R as eventEmitterCapability, S as brokerCapability, T as buttonCapability, Tt as discriminatedUnion, U as humiditySensorCapability, V as gasCapability, W as imageCapability, X as notificationOutputCapability, Y as normalizeUnit, Z as notifierCapability, _ as automationControlCapability, _t as DeviceRole, at as scriptRunnerCapability, b as binaryCapability, ct as tamperCapability, d as TargetSchema, dt as vacuumControlCapability, et as parseAdminBase, f as accessoriesCapability, ft as valveCapability, g as ambientLightSensorCapability, gt as DeviceFeature, h as alarmPanelCapability, ht as weatherCapability, it as pressureSensorCapability, j as contactCapability, jt as union, k as colorCapability, kt as record, lt as temperatureSensorCapability, m as airQualitySensorCapability, mt as waterHeaterCapability, n as BaseDevice, nt as prepareNotification, ot as smokeCapability, p as addonRoutesCapability, pt as vibrationCapability, q as mediaPlayerCapability, r as BaseDeviceProvider, rt as presenceCapability, s as EnumSensorDateTimeFormatSchema, st as switchCapability, tt as powerMeterCapability, ut as updateCapability, v as batteryCapability, vt as DeviceType, w as buildDeviceAdminUrl, wt as array, x as brightnessCapability, xt as createEvent, y as bestLocationMatch, yt as errMsg, z as fanControlCapability } from "./dist-CbGUsakM.mjs";
 import { randomUUID } from "node:crypto";
 import { brotliCompressSync, deflateSync, gzipSync } from "node:zlib";
 //#region src/ha-admin-link.ts
@@ -7046,6 +7046,11 @@ function createHaNotificationOutputProvider(deps) {
 			}
 			return out;
 		},
+		probeTargetConfig: async ({ kind }) => ({
+			ok: false,
+			resolvedUrl: "",
+			error: `Kind '${kind}' does not support credential probing`
+		}),
 		send: async ({ targetId, notification }) => {
 			const target = await store.getById(targetId);
 			if (!target) return {

package/dist/{dist-CERTsNmo.js → dist-CUS3XDdU.js}

@@ -5379,7 +5379,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-CDCONfkt.mjs
+//#region ../types/dist/sleep-DXKLNFvA.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -5687,6 +5687,43 @@ function hydrateField(field, values) {
 	}
 	const rawValue = storedValue !== void 0 ? storedValue : defaultValue !== void 0 ? defaultValue : null;
 	const value = field.type === "textarea" && field.isJson && rawValue !== null && typeof rawValue === "object" ? JSON.stringify(rawValue, null, 2) : rawValue;
+	if (field.type === "tags" && typeof field.suggestionsFrom === "string") {
+		const from = values[field.suggestionsFrom];
+		const extra = Array.isArray(from) ? from.filter((s) => typeof s === "string" && s.length > 0) : [];
+		const merged = [...new Set([...field.suggestions ?? [], ...extra])];
+		return {
+			...field,
+			suggestions: merged,
+			value
+		};
+	}
+	if ((field.type === "select" || field.type === "multiselect") && typeof field.optionsFrom === "string") {
+		const from = values[field.optionsFrom];
+		const byValue = /* @__PURE__ */ new Map();
+		for (const opt of field.options) byValue.set(opt.value, opt);
+		if (Array.isArray(from)) for (const entry of from) {
+			if (typeof entry === "string" && entry.length > 0) {
+				if (!byValue.has(entry)) byValue.set(entry, {
+					value: entry,
+					label: entry
+				});
+				continue;
+			}
+			if (entry === null || typeof entry !== "object") continue;
+			const v = Reflect.get(entry, "value");
+			const lbl = Reflect.get(entry, "label");
+			if (typeof v !== "string" || v.length === 0) continue;
+			if (!byValue.has(v)) byValue.set(v, {
+				value: v,
+				label: typeof lbl === "string" && lbl.length > 0 ? lbl : v
+			});
+		}
+		return {
+			...field,
+			options: [...byValue.values()],
+			value
+		};
+	}
 	return {
 		...field,
 		value
@@ -18329,6 +18366,17 @@ var SendResultSchema = object({
 });
 /** Same shape as SendResult — kept as a distinct name for the test panel. */
 var TestResultSchema = SendResultSchema;
+/**
+* Pre-save credential probe against a partial (unsaved) target config.
+* `resolvedUrl` never includes secrets (token stripped from path).
+*/
+var ProbeTargetConfigResultSchema = object({
+	ok: boolean(),
+	resolvedUrl: string(),
+	httpStatus: number().int().optional(),
+	stateInstance: string().optional(),
+	error: string().optional()
+});
 var notificationOutputCapability = {
 	name: "notification-output",
 	scope: "system",
@@ -18336,10 +18384,32 @@ var notificationOutputCapability = {
 	methods: {
 		listTargetKinds: method(object({}), array(TargetKindSchema)),
 		listTargets: method(object({}), array(TargetSchema), { auth: "admin" }),
+		/**
+		* One target WITH secrets — admin edit / duplicate hydration only.
+		* `listTargets` stays redacted; the editor loads this so password fields
+		* are filled (masked in the input) and a save can round-trip the token
+		* when a destination changes (Duplicate with a new chatId, etc.).
+		*/
+		getTarget: method(object({ targetId: string() }), TargetSchema, { auth: "admin" }),
 		discoverTargets: method(object({
 			kind: string(),
-			config: record(string(), unknown()).optional()
+			config: record(string(), unknown()).optional(),
+			/**
+			* When editing / duplicating, the blank password field never round-trips
+			* the stored token. Pass the source target id so the provider can restore
+			* secrets server-side before dialling (same merge as upsert).
+			*/
+			targetId: string().optional()
 		}), array(DiscoveredTargetSchema), { auth: "admin" }),
+		probeTargetConfig: method(object({
+			kind: string(),
+			config: record(string(), unknown()),
+			/** See `discoverTargets.targetId` — restore stored secrets for a blank password. */
+			targetId: string().optional()
+		}), ProbeTargetConfigResultSchema, {
+			kind: "mutation",
+			auth: "admin"
+		}),
 		send: method(object({
 			targetId: string(),
 			notification: NotificationSchema
@@ -18354,7 +18424,16 @@ var notificationOutputCapability = {
 			kind: "mutation",
 			auth: "admin"
 		}),
-		upsertTarget: method(object({ target: TargetSchema }), TargetSchema, {
+		upsertTarget: method(object({
+			target: TargetSchema,
+			/**
+			* Duplicate flow: create a NEW target id while copying secrets from an
+			* existing row. The UI never holds the stored token; blank / redacted
+			* password fields are restored from this source (D634 still applies if
+			* destinations diverge without a re-typed secret).
+			*/
+			cloneSecretsFrom: string().optional()
+		}), TargetSchema, {
 			kind: "mutation",
 			auth: "admin"
 		}),
@@ -44767,6 +44846,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"notificationOutput.getTarget": {
+		capName: "notification-output",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"notificationOutput.listTargetKinds": {
 		capName: "notification-output",
 		capScope: "system",
@@ -44779,6 +44864,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"notificationOutput.probeTargetConfig": {
+		capName: "notification-output",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"notificationOutput.send": {
 		capName: "notification-output",
 		capScope: "system",

package/dist/{dist-DqKiElqb.mjs → dist-CbGUsakM.mjs}

@@ -5378,7 +5378,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-CDCONfkt.mjs
+//#region ../types/dist/sleep-DXKLNFvA.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -5686,6 +5686,43 @@ function hydrateField(field, values) {
 	}
 	const rawValue = storedValue !== void 0 ? storedValue : defaultValue !== void 0 ? defaultValue : null;
 	const value = field.type === "textarea" && field.isJson && rawValue !== null && typeof rawValue === "object" ? JSON.stringify(rawValue, null, 2) : rawValue;
+	if (field.type === "tags" && typeof field.suggestionsFrom === "string") {
+		const from = values[field.suggestionsFrom];
+		const extra = Array.isArray(from) ? from.filter((s) => typeof s === "string" && s.length > 0) : [];
+		const merged = [...new Set([...field.suggestions ?? [], ...extra])];
+		return {
+			...field,
+			suggestions: merged,
+			value
+		};
+	}
+	if ((field.type === "select" || field.type === "multiselect") && typeof field.optionsFrom === "string") {
+		const from = values[field.optionsFrom];
+		const byValue = /* @__PURE__ */ new Map();
+		for (const opt of field.options) byValue.set(opt.value, opt);
+		if (Array.isArray(from)) for (const entry of from) {
+			if (typeof entry === "string" && entry.length > 0) {
+				if (!byValue.has(entry)) byValue.set(entry, {
+					value: entry,
+					label: entry
+				});
+				continue;
+			}
+			if (entry === null || typeof entry !== "object") continue;
+			const v = Reflect.get(entry, "value");
+			const lbl = Reflect.get(entry, "label");
+			if (typeof v !== "string" || v.length === 0) continue;
+			if (!byValue.has(v)) byValue.set(v, {
+				value: v,
+				label: typeof lbl === "string" && lbl.length > 0 ? lbl : v
+			});
+		}
+		return {
+			...field,
+			options: [...byValue.values()],
+			value
+		};
+	}
 	return {
 		...field,
 		value
@@ -18328,6 +18365,17 @@ var SendResultSchema = object({
 });
 /** Same shape as SendResult — kept as a distinct name for the test panel. */
 var TestResultSchema = SendResultSchema;
+/**
+* Pre-save credential probe against a partial (unsaved) target config.
+* `resolvedUrl` never includes secrets (token stripped from path).
+*/
+var ProbeTargetConfigResultSchema = object({
+	ok: boolean(),
+	resolvedUrl: string(),
+	httpStatus: number().int().optional(),
+	stateInstance: string().optional(),
+	error: string().optional()
+});
 var notificationOutputCapability = {
 	name: "notification-output",
 	scope: "system",
@@ -18335,10 +18383,32 @@ var notificationOutputCapability = {
 	methods: {
 		listTargetKinds: method(object({}), array(TargetKindSchema)),
 		listTargets: method(object({}), array(TargetSchema), { auth: "admin" }),
+		/**
+		* One target WITH secrets — admin edit / duplicate hydration only.
+		* `listTargets` stays redacted; the editor loads this so password fields
+		* are filled (masked in the input) and a save can round-trip the token
+		* when a destination changes (Duplicate with a new chatId, etc.).
+		*/
+		getTarget: method(object({ targetId: string() }), TargetSchema, { auth: "admin" }),
 		discoverTargets: method(object({
 			kind: string(),
-			config: record(string(), unknown()).optional()
+			config: record(string(), unknown()).optional(),
+			/**
+			* When editing / duplicating, the blank password field never round-trips
+			* the stored token. Pass the source target id so the provider can restore
+			* secrets server-side before dialling (same merge as upsert).
+			*/
+			targetId: string().optional()
 		}), array(DiscoveredTargetSchema), { auth: "admin" }),
+		probeTargetConfig: method(object({
+			kind: string(),
+			config: record(string(), unknown()),
+			/** See `discoverTargets.targetId` — restore stored secrets for a blank password. */
+			targetId: string().optional()
+		}), ProbeTargetConfigResultSchema, {
+			kind: "mutation",
+			auth: "admin"
+		}),
 		send: method(object({
 			targetId: string(),
 			notification: NotificationSchema
@@ -18353,7 +18423,16 @@ var notificationOutputCapability = {
 			kind: "mutation",
 			auth: "admin"
 		}),
-		upsertTarget: method(object({ target: TargetSchema }), TargetSchema, {
+		upsertTarget: method(object({
+			target: TargetSchema,
+			/**
+			* Duplicate flow: create a NEW target id while copying secrets from an
+			* existing row. The UI never holds the stored token; blank / redacted
+			* password fields are restored from this source (D634 still applies if
+			* destinations diverge without a re-typed secret).
+			*/
+			cloneSecretsFrom: string().optional()
+		}), TargetSchema, {
 			kind: "mutation",
 			auth: "admin"
 		}),
@@ -44766,6 +44845,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"notificationOutput.getTarget": {
+		capName: "notification-output",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"notificationOutput.listTargetKinds": {
 		capName: "notification-output",
 		capScope: "system",
@@ -44778,6 +44863,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"notificationOutput.probeTargetConfig": {
+		capName: "notification-output",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"notificationOutput.send": {
 		capName: "notification-output",
 		capScope: "system",

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

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 //#endregion
-const require_dist = require("../dist-CERTsNmo.js");
+const require_dist = require("../dist-CUS3XDdU.js");
 let node_crypto = require("node:crypto");
 //#region src/ha-export/topics.ts
 /**
@@ -2582,13 +2582,18 @@ mireds: {
 	},
 	/**
 	* The generic user-settable input. `value` is `number | string` and
-	* `kind` says which of the four shapes it is — a `number`, a `select`
-	* or a text box, all three of which would need `control.setValue` in
-	* the route table before they could be anything but a reading.
+	* `kind` on the slice says which of the four shapes it is. The row
+	* here is the PROJECTOR + route authority (`writable` gates
+	* `control.setValue`); the announced platform (`select` / `number` /
+	* read-only `sensor`) is minted at reconcile from the slice by
+	* {@link controlEntitySpecs} — a static `select` here cannot carry
+	* the device's live `options`, and a static `number` cannot carry
+	* its live min/max/step.
 	*/
 	control: {
 		platform: "sensor",
 		field: "value",
+		writable: true,
 		extras: { kind: {
 			platform: "sensor",
 			field: "kind",
@@ -2755,6 +2760,71 @@ function capEntitySpecs(capName) {
 	});
 	return specs;
 }
+function readControlOptions(slice) {
+	const raw = slice?.["options"];
+	if (!Array.isArray(raw)) return [];
+	return raw.filter((entry) => typeof entry === "string" && entry.length > 0);
+}
+function readFiniteNumber(slice, field) {
+	const raw = slice?.[field];
+	return typeof raw === "number" && Number.isFinite(raw) ? raw : void 0;
+}
+/**
+* The announced shape of a `control` device, from its live slice.
+*
+* `CAP_ENTITY_MAP.control` cannot name a static `select`/`number`: the
+* options and the bounds live on the slice and change (VPN station list,
+* HA `input_number` limits). A select with no options is an entity HA
+* builds with nothing to choose from — so an empty list falls back to a
+* read-only sensor rather than a dead control.
+*/
+function controlEntitySpecs(slice) {
+	const kind = typeof slice?.["kind"] === "string" ? slice["kind"] : null;
+	const primary = derivedEntityId("control");
+	const kindExtra = {
+		entity: derivedExtraEntityId("control", "kind"),
+		platform: "sensor",
+		label: "Input kind",
+		entityCategory: "diagnostic",
+		enabledByDefault: false
+	};
+	if (kind === "select") {
+		const options = readControlOptions(slice);
+		if (options.length > 0) return [{
+			entity: primary,
+			platform: "select",
+			label: humanise("control"),
+			writable: true,
+			options,
+			enabledByDefault: true
+		}, kindExtra];
+	}
+	if (kind === "numeric") {
+		const min = readFiniteNumber(slice, "min") ?? PERCENT_RANGE.min;
+		const max = readFiniteNumber(slice, "max") ?? PERCENT_RANGE.max;
+		const step = readFiniteNumber(slice, "step") ?? PERCENT_RANGE.step;
+		const unit = typeof slice?.["unit"] === "string" ? slice["unit"] : void 0;
+		if (min < max && step > 0) return [{
+			entity: primary,
+			platform: "number",
+			label: humanise("control"),
+			writable: true,
+			range: {
+				min,
+				max,
+				step
+			},
+			...unit !== void 0 ? { unit } : {},
+			enabledByDefault: true
+		}, kindExtra];
+	}
+	return [{
+		entity: primary,
+		platform: "sensor",
+		label: humanise("control"),
+		enabledByDefault: true
+	}, kindExtra];
+}
 var CAPS_NOT_EXPORTED = [
 	{
 		cap: "recording-onboard",
@@ -2984,6 +3054,15 @@ function buildDerivedPlan(device, options = UNNEGOTIATED_PLAN_OPTIONS) {
 		* two halves of this file would build the same entity id twice.
 		*/
 		if (CAMERA_DERIVED_CAPS.includes(cap)) continue;
+		/**
+		* `control` is slice-shaped: select options and number bounds are not
+		* on the static row. Mint the announced platform here; the CAP_ENTITY_MAP
+		* row stays the projector + writable-route authority.
+		*/
+		if (cap === "control") {
+			specs.push(...controlEntitySpecs(device.capSlices?.["control"]).map((spec) => degradeUnsupported(spec, options)));
+			continue;
+		}
 		const mapping = CAP_ENTITY_MAP[cap];
 		const platform = nativePlatformFor(cap);
 		const plan = mapping === void 0 || platform === null || !options.platforms.has(platform) ? null : buildNativeComponent({
@@ -3207,6 +3286,11 @@ var CAP_COMMAND_ROUTES = {
 		deviceId,
 		capName: "button"
 	}) },
+	control: { primary: (deviceId, value) => value.trim().length === 0 ? null : {
+		kind: "cap-control",
+		deviceId,
+		value
+	} },
 	cover: {
 		extras: {
 			position: (deviceId, value) => {
@@ -3895,6 +3979,28 @@ async function applyCapCommand(device, command) {
 			};
 			await device.button.press({});
 			return { ok: true };
+		case "cap-control": return call(device.control, "control", async (control) => {
+			const status = await control.getStatus({});
+			if (status === null || typeof status !== "object") throw new Error("the device reports no control status, so setValue has no kind");
+			const kind = Reflect.get(status, "kind");
+			if (kind === "numeric") {
+				const numeric = Number(command.value);
+				if (!Number.isFinite(numeric)) throw new Error(`control value is not a number: ${command.value}`);
+				await control.setValue({ control: {
+					kind: "numeric",
+					value: numeric
+				} });
+				return;
+			}
+			if (kind === "select" || kind === "text" || kind === "datetime") {
+				await control.setValue({ control: {
+					kind,
+					value: command.value
+				} });
+				return;
+			}
+			throw new Error(`unsupported control kind: ${String(kind)}`);
+		});
 		case "cover-position": return call(device.cover, "cover", (cover) => cover.setPosition({ position: command.position }));
 		case "cover-tilt": return call(device.cover, "cover", (cover) => cover.setTiltPosition({ tiltPosition: command.tiltPosition }));
 		case "cover-verb": return call(device.cover, "cover", (cover) => {

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

@@ -1,4 +1,4 @@
-import { $ as oauthIntegrationCapability, At as string, C as buildAddonRouteProvider, I as deviceExportCapability, Pt as EventCategory, St as nodePin, a as COCO_TO_MACRO, bt as BaseAddon, c as FanDirectionSchema, i as CAMERA_SWITCH_ORDER, l as HvacModeSchema, o as CameraSwitchIdSchema, p as addonRoutesCapability, t as AlarmArmModeSchema, u as MediaPlayerRepeatSchema } from "../dist-DqKiElqb.mjs";
+import { $ as oauthIntegrationCapability, At as string, C as buildAddonRouteProvider, I as deviceExportCapability, Pt as EventCategory, St as nodePin, a as COCO_TO_MACRO, bt as BaseAddon, c as FanDirectionSchema, i as CAMERA_SWITCH_ORDER, l as HvacModeSchema, o as CameraSwitchIdSchema, p as addonRoutesCapability, t as AlarmArmModeSchema, u as MediaPlayerRepeatSchema } from "../dist-CbGUsakM.mjs";
 import { createHmac, timingSafeEqual } from "node:crypto";
 //#region src/ha-export/topics.ts
 /**
@@ -2577,13 +2577,18 @@ mireds: {
 	},
 	/**
 	* The generic user-settable input. `value` is `number | string` and
-	* `kind` says which of the four shapes it is — a `number`, a `select`
-	* or a text box, all three of which would need `control.setValue` in
-	* the route table before they could be anything but a reading.
+	* `kind` on the slice says which of the four shapes it is. The row
+	* here is the PROJECTOR + route authority (`writable` gates
+	* `control.setValue`); the announced platform (`select` / `number` /
+	* read-only `sensor`) is minted at reconcile from the slice by
+	* {@link controlEntitySpecs} — a static `select` here cannot carry
+	* the device's live `options`, and a static `number` cannot carry
+	* its live min/max/step.
 	*/
 	control: {
 		platform: "sensor",
 		field: "value",
+		writable: true,
 		extras: { kind: {
 			platform: "sensor",
 			field: "kind",
@@ -2750,6 +2755,71 @@ function capEntitySpecs(capName) {
 	});
 	return specs;
 }
+function readControlOptions(slice) {
+	const raw = slice?.["options"];
+	if (!Array.isArray(raw)) return [];
+	return raw.filter((entry) => typeof entry === "string" && entry.length > 0);
+}
+function readFiniteNumber(slice, field) {
+	const raw = slice?.[field];
+	return typeof raw === "number" && Number.isFinite(raw) ? raw : void 0;
+}
+/**
+* The announced shape of a `control` device, from its live slice.
+*
+* `CAP_ENTITY_MAP.control` cannot name a static `select`/`number`: the
+* options and the bounds live on the slice and change (VPN station list,
+* HA `input_number` limits). A select with no options is an entity HA
+* builds with nothing to choose from — so an empty list falls back to a
+* read-only sensor rather than a dead control.
+*/
+function controlEntitySpecs(slice) {
+	const kind = typeof slice?.["kind"] === "string" ? slice["kind"] : null;
+	const primary = derivedEntityId("control");
+	const kindExtra = {
+		entity: derivedExtraEntityId("control", "kind"),
+		platform: "sensor",
+		label: "Input kind",
+		entityCategory: "diagnostic",
+		enabledByDefault: false
+	};
+	if (kind === "select") {
+		const options = readControlOptions(slice);
+		if (options.length > 0) return [{
+			entity: primary,
+			platform: "select",
+			label: humanise("control"),
+			writable: true,
+			options,
+			enabledByDefault: true
+		}, kindExtra];
+	}
+	if (kind === "numeric") {
+		const min = readFiniteNumber(slice, "min") ?? PERCENT_RANGE.min;
+		const max = readFiniteNumber(slice, "max") ?? PERCENT_RANGE.max;
+		const step = readFiniteNumber(slice, "step") ?? PERCENT_RANGE.step;
+		const unit = typeof slice?.["unit"] === "string" ? slice["unit"] : void 0;
+		if (min < max && step > 0) return [{
+			entity: primary,
+			platform: "number",
+			label: humanise("control"),
+			writable: true,
+			range: {
+				min,
+				max,
+				step
+			},
+			...unit !== void 0 ? { unit } : {},
+			enabledByDefault: true
+		}, kindExtra];
+	}
+	return [{
+		entity: primary,
+		platform: "sensor",
+		label: humanise("control"),
+		enabledByDefault: true
+	}, kindExtra];
+}
 var CAPS_NOT_EXPORTED = [
 	{
 		cap: "recording-onboard",
@@ -2979,6 +3049,15 @@ function buildDerivedPlan(device, options = UNNEGOTIATED_PLAN_OPTIONS) {
 		* two halves of this file would build the same entity id twice.
 		*/
 		if (CAMERA_DERIVED_CAPS.includes(cap)) continue;
+		/**
+		* `control` is slice-shaped: select options and number bounds are not
+		* on the static row. Mint the announced platform here; the CAP_ENTITY_MAP
+		* row stays the projector + writable-route authority.
+		*/
+		if (cap === "control") {
+			specs.push(...controlEntitySpecs(device.capSlices?.["control"]).map((spec) => degradeUnsupported(spec, options)));
+			continue;
+		}
 		const mapping = CAP_ENTITY_MAP[cap];
 		const platform = nativePlatformFor(cap);
 		const plan = mapping === void 0 || platform === null || !options.platforms.has(platform) ? null : buildNativeComponent({
@@ -3202,6 +3281,11 @@ var CAP_COMMAND_ROUTES = {
 		deviceId,
 		capName: "button"
 	}) },
+	control: { primary: (deviceId, value) => value.trim().length === 0 ? null : {
+		kind: "cap-control",
+		deviceId,
+		value
+	} },
 	cover: {
 		extras: {
 			position: (deviceId, value) => {
@@ -3890,6 +3974,28 @@ async function applyCapCommand(device, command) {
 			};
 			await device.button.press({});
 			return { ok: true };
+		case "cap-control": return call(device.control, "control", async (control) => {
+			const status = await control.getStatus({});
+			if (status === null || typeof status !== "object") throw new Error("the device reports no control status, so setValue has no kind");
+			const kind = Reflect.get(status, "kind");
+			if (kind === "numeric") {
+				const numeric = Number(command.value);
+				if (!Number.isFinite(numeric)) throw new Error(`control value is not a number: ${command.value}`);
+				await control.setValue({ control: {
+					kind: "numeric",
+					value: numeric
+				} });
+				return;
+			}
+			if (kind === "select" || kind === "text" || kind === "datetime") {
+				await control.setValue({ control: {
+					kind,
+					value: command.value
+				} });
+				return;
+			}
+			throw new Error(`unsupported control kind: ${String(kind)}`);
+		});
 		case "cover-position": return call(device.cover, "cover", (cover) => cover.setPosition({ position: command.position }));
 		case "cover-tilt": return call(device.cover, "cover", (cover) => cover.setTiltPosition({ tiltPosition: command.tiltPosition }));
 		case "cover-verb": return call(device.cover, "cover", (cover) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-homeassistant",
-  "version": "1.2.155",
+  "version": "1.2.156",
   "description": "Home Assistant device provider addon for CamStack",
   "keywords": [
     "camstack",