@camstack/addon-import-alexa 0.2.180 → 0.2.182

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.182] - 2026-11-03
+
+### Changed
+
+- An idle Echo shows its volume and mute again (the volume list is read correctly)
+
+## [0.2.181] - 2026-11-03
+
+### Changed
+
+- An idle Echo now shows its real volume and mute (read once per account from Amazon's volume list); volume up and down step the level by 10.
+
 ## [0.2.180] - 2026-11-03
 
 ### Changed

package/dist/addon.js

@@ -6044,7 +6044,7 @@ function number(params) {
 	return /* @__PURE__ */ _coercedNumber(ZodNumber, params);
 }
 //#endregion
-//#region ../types/dist/sleep-BKClVk0K.mjs
+//#region ../types/dist/sleep-DV4qxEyD.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -8132,6 +8132,10 @@ var BaseAddon = class {
 		const stored = keychain ? await this.readAddonStoreWithRetry() : {};
 		const patch = {};
 		for (const key of keys) {
+			if (tree.get(key)?.kind === "array") {
+				patch[key] = [];
+				continue;
+			}
 			const keychainStored = tree.has(key) || collectSecretMarkerRefs(stored[key]).length > 0;
 			patch[key] = keychain && keychainStored ? SECRET_CLEAR : "";
 		}
@@ -11788,7 +11792,7 @@ object({
 	params: record(string(), union([string(), number$1()])).optional()
 });
 //#endregion
-//#region ../types/dist/composition-BodkvOV0.mjs
+//#region ../types/dist/composition-CD1GdFuv.mjs
 /**
 * The ffmpeg build every CamStack node downloads, per platform and arch.
 *
@@ -12977,7 +12981,7 @@ var CompositionSchema = object({
 		kind: literal("existing"),
 		device: CompositionSourceRefSchema
 	})]),
-	features: array(CompositionFeatureSchema).min(1).max(16),
+	features: array(CompositionFeatureSchema).min(0).max(16),
 	/**
 	* Present when the block is a helper template. Absent on a free
 	* composition (the room example, device 4603). The editor reads this,
@@ -70379,6 +70383,14 @@ var powerMeterCapability = {
 	deviceNative: true,
 	mode: "singleton",
 	deviceTypes: POWER_METER_DEVICE_TYPES,
+	deviceConfig: { ui: {
+		kind: "widget",
+		widgetId: "host/power-meter-line",
+		tab: "power",
+		placement: "hero",
+		label: "Power",
+		order: 4
+	} },
 	methods: {},
 	status: {
 		schema: PowerMeterStatusSchema,
@@ -142194,6 +142206,7 @@ function isKnownCap(cap) {
 var EchoSessionRegistry = class {
 	#resolve = null;
 	#dnd = /* @__PURE__ */ new Map();
+	#volumes = /* @__PURE__ */ new Map();
 	setResolver(fn) {
 		this.#resolve = fn;
 	}
@@ -142216,9 +142229,26 @@ var EchoSessionRegistry = class {
 		});
 		return pending;
 	}
+	/** Volume and mute of every device of the account. A failed read is not kept for the next device. */
+	volumes(brokerId, now) {
+		const shared = this.#volumes.get(brokerId);
+		if (shared !== void 0 && now - shared.at < 25e3) return shared.pending;
+		const session = this.get(brokerId);
+		if (session === null) return Promise.reject(/* @__PURE__ */ new Error("no Echo session for this account"));
+		const pending = session.deviceVolumes();
+		this.#volumes.set(brokerId, {
+			at: now,
+			pending
+		});
+		pending.catch(() => {
+			if (this.#volumes.get(brokerId)?.pending === pending) this.#volumes.delete(brokerId);
+		});
+		return pending;
+	}
 	clear() {
 		this.#resolve = null;
 		this.#dnd.clear();
+		this.#volumes.clear();
 	}
 };
 /** The single in-process registry shared across the addon. */
@@ -142301,6 +142331,18 @@ function mapPlayerInfoToStatus(info, input) {
 		repeat: repeatOf(info.transport?.repeat)
 	};
 }
+/**
+* Fill the volume and mute the player read left null from the account's volume
+* list. The player read wins when it has a value; a value neither source has stays null.
+*/
+function withListedVolume(status, listed) {
+	if (listed === void 0) return status;
+	return {
+		...status,
+		volumeLevel: status.volumeLevel ?? percent(listed.volume),
+		isMuted: status.isMuted ?? listed.muted
+	};
+}
 //#endregion
 //#region src/speak/worker-protocol.ts
 /** Line-delimited JSON the long-lived Python worker speaks. One object per line. */
@@ -142418,6 +142460,19 @@ function parseDndState(result) {
 	if (!parsed.success) throw new Error("worker returned an unexpected Do Not Disturb list");
 	return new Map(parsed.data.devices.map((entry) => [entry.serial, entry.enabled]));
 }
+var DeviceVolumeEntrySchema = object({
+	serial: string().min(1),
+	volume: number$1().finite().optional(),
+	muted: boolean().optional()
+});
+function parseDeviceVolumes(result) {
+	const parsed = object({ devices: array(DeviceVolumeEntrySchema) }).safeParse(result);
+	if (!parsed.success) throw new Error("worker returned an unexpected device volume list");
+	return new Map(parsed.data.devices.map((entry) => [entry.serial, {
+		volume: entry.volume ?? null,
+		muted: entry.muted ?? null
+	}]));
+}
 //#endregion
 //#region src/devices/alexa-echo-device.ts
 /**
@@ -142432,6 +142487,8 @@ var alexaEchoDeviceSchema = object({
 	system: literal("alexa").optional(),
 	integrationId: string().optional()
 });
+/** Percent points one volume-up / volume-down moves an Echo. */
+var VOLUME_STEP = 10;
 var COLD_DND = {
 	enabled: null,
 	lastChangedAt: 0
@@ -142452,6 +142509,7 @@ var AlexaEchoDevice = class extends BaseDevice {
 	rereadTimer = null;
 	polling = false;
 	failureLogged = false;
+	volumeFailureLogged = false;
 	health = "ok";
 	constructor(ctx) {
 		const persisted = alexaEchoDeviceSchema.parse(ctx.persistedConfig ?? {});
@@ -142524,12 +142582,11 @@ var AlexaEchoDevice = class extends BaseDevice {
 		}
 		const deviceType = this.amazonDeviceType !== "" ? this.amazonDeviceType : listed?.deviceType ?? "";
 		try {
-			const info = await session.playerState(this.serial, deviceType);
-			const now = Date.now();
-			this.runtimeState.setCapState("media-player", mapPlayerInfoToStatus(info, {
+			const fromPlayer = mapPlayerInfoToStatus(await session.playerState(this.serial, deviceType), {
 				online: true,
-				now
-			}));
+				now: Date.now()
+			});
+			this.runtimeState.setCapState("media-player", await this.completeVolume(fromPlayer));
 			this.markOnline(true);
 			this.noteRecovered();
 		} catch (err) {
@@ -142538,6 +142595,29 @@ var AlexaEchoDevice = class extends BaseDevice {
 		}
 		await this.readDoNotDisturb();
 	}
+	/**
+	* An idle Echo's player read carries no volume. Ask the account's volume list
+	* (shared by every Echo of the account in this cycle); a failed read leaves null.
+	*/
+	async completeVolume(status) {
+		if (status.volumeLevel !== null && status.isMuted !== null) return status;
+		try {
+			const all = await alexaEchoSessions.volumes(this.brokerId, Date.now());
+			if (this.volumeFailureLogged) this.ctx.logger.info("alexa echo: the volume list reads again", { tags: { deviceId: this.id } });
+			this.volumeFailureLogged = false;
+			return withListedVolume(status, all.get(this.serial));
+		} catch (err) {
+			if (err instanceof RateLimitedError) return status;
+			if (!this.volumeFailureLogged) {
+				this.volumeFailureLogged = true;
+				this.ctx.logger.warn("alexa echo: could not read the volume list, volume stays unknown", {
+					tags: { deviceId: this.id },
+					meta: { error: err instanceof Error ? err.message : String(err) }
+				});
+			}
+			return status;
+		}
+	}
 	async readDoNotDisturb() {
 		try {
 			const enabled = (await alexaEchoSessions.dnd(this.brokerId, Date.now())).get(this.serial);
@@ -142573,6 +142653,14 @@ var AlexaEchoDevice = class extends BaseDevice {
 		await this.session().npCommand(this.serial, command);
 		this.rereadSoon();
 	}
+	/** Amazon has no step command: move from the last known level, refuse when there is none. */
+	async stepVolume(delta) {
+		const level = this.runtimeState.getCapState("media-player")?.volumeLevel;
+		if (level === null || level === void 0) throw new Error("the Echo volume is not known yet");
+		const next = Math.max(0, Math.min(100, level + delta));
+		await this.session().setVolume(this.serial, next);
+		this.rereadSoon();
+	}
 	registerMediaPlayer() {
 		this.ctx.registerNativeCap(mediaPlayerCapability, {
 			getStatus: async () => this.runtimeState.getCapState("media-player") ?? emptyEchoStatus("off", 0),
@@ -142587,8 +142675,8 @@ var AlexaEchoDevice = class extends BaseDevice {
 			stop: async () => unsupported("stop"),
 			turnOn: async () => unsupported("power"),
 			turnOff: async () => unsupported("power"),
-			volumeUp: async () => unsupported("volume steps"),
-			volumeDown: async () => unsupported("volume steps"),
+			volumeUp: async () => this.stepVolume(VOLUME_STEP),
+			volumeDown: async () => this.stepVolume(-10),
 			channelUp: async () => unsupported("channel steps"),
 			channelDown: async () => unsupported("channel steps"),
 			seek: async () => unsupported("seek"),
@@ -143095,6 +143183,11 @@ var BrokerEcho = class {
 		await this.requireReady();
 		return this.limited(async () => parseDndState(await this.deps.worker.request({ op: "dnd_state" })));
 	}
+	/** Speaker volume and mute of every device of the account, by serial, in one call. */
+	async deviceVolumes() {
+		await this.requireReady();
+		return this.limited(async () => parseDeviceVolumes(await this.deps.worker.request({ op: "device_volumes" })));
+	}
 	async setDnd(serial, enabled) {
 		await this.requireReady();
 		await this.limited(() => this.deps.worker.request({

package/dist/addon.mjs

@@ -6042,7 +6042,7 @@ function number(params) {
 	return /* @__PURE__ */ _coercedNumber(ZodNumber, params);
 }
 //#endregion
-//#region ../types/dist/sleep-BKClVk0K.mjs
+//#region ../types/dist/sleep-DV4qxEyD.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -8130,6 +8130,10 @@ var BaseAddon = class {
 		const stored = keychain ? await this.readAddonStoreWithRetry() : {};
 		const patch = {};
 		for (const key of keys) {
+			if (tree.get(key)?.kind === "array") {
+				patch[key] = [];
+				continue;
+			}
 			const keychainStored = tree.has(key) || collectSecretMarkerRefs(stored[key]).length > 0;
 			patch[key] = keychain && keychainStored ? SECRET_CLEAR : "";
 		}
@@ -11786,7 +11790,7 @@ object({
 	params: record(string(), union([string(), number$1()])).optional()
 });
 //#endregion
-//#region ../types/dist/composition-BodkvOV0.mjs
+//#region ../types/dist/composition-CD1GdFuv.mjs
 /**
 * The ffmpeg build every CamStack node downloads, per platform and arch.
 *
@@ -12975,7 +12979,7 @@ var CompositionSchema = object({
 		kind: literal("existing"),
 		device: CompositionSourceRefSchema
 	})]),
-	features: array(CompositionFeatureSchema).min(1).max(16),
+	features: array(CompositionFeatureSchema).min(0).max(16),
 	/**
 	* Present when the block is a helper template. Absent on a free
 	* composition (the room example, device 4603). The editor reads this,
@@ -70377,6 +70381,14 @@ var powerMeterCapability = {
 	deviceNative: true,
 	mode: "singleton",
 	deviceTypes: POWER_METER_DEVICE_TYPES,
+	deviceConfig: { ui: {
+		kind: "widget",
+		widgetId: "host/power-meter-line",
+		tab: "power",
+		placement: "hero",
+		label: "Power",
+		order: 4
+	} },
 	methods: {},
 	status: {
 		schema: PowerMeterStatusSchema,
@@ -142192,6 +142204,7 @@ function isKnownCap(cap) {
 var EchoSessionRegistry = class {
 	#resolve = null;
 	#dnd = /* @__PURE__ */ new Map();
+	#volumes = /* @__PURE__ */ new Map();
 	setResolver(fn) {
 		this.#resolve = fn;
 	}
@@ -142214,9 +142227,26 @@ var EchoSessionRegistry = class {
 		});
 		return pending;
 	}
+	/** Volume and mute of every device of the account. A failed read is not kept for the next device. */
+	volumes(brokerId, now) {
+		const shared = this.#volumes.get(brokerId);
+		if (shared !== void 0 && now - shared.at < 25e3) return shared.pending;
+		const session = this.get(brokerId);
+		if (session === null) return Promise.reject(/* @__PURE__ */ new Error("no Echo session for this account"));
+		const pending = session.deviceVolumes();
+		this.#volumes.set(brokerId, {
+			at: now,
+			pending
+		});
+		pending.catch(() => {
+			if (this.#volumes.get(brokerId)?.pending === pending) this.#volumes.delete(brokerId);
+		});
+		return pending;
+	}
 	clear() {
 		this.#resolve = null;
 		this.#dnd.clear();
+		this.#volumes.clear();
 	}
 };
 /** The single in-process registry shared across the addon. */
@@ -142299,6 +142329,18 @@ function mapPlayerInfoToStatus(info, input) {
 		repeat: repeatOf(info.transport?.repeat)
 	};
 }
+/**
+* Fill the volume and mute the player read left null from the account's volume
+* list. The player read wins when it has a value; a value neither source has stays null.
+*/
+function withListedVolume(status, listed) {
+	if (listed === void 0) return status;
+	return {
+		...status,
+		volumeLevel: status.volumeLevel ?? percent(listed.volume),
+		isMuted: status.isMuted ?? listed.muted
+	};
+}
 //#endregion
 //#region src/speak/worker-protocol.ts
 /** Line-delimited JSON the long-lived Python worker speaks. One object per line. */
@@ -142416,6 +142458,19 @@ function parseDndState(result) {
 	if (!parsed.success) throw new Error("worker returned an unexpected Do Not Disturb list");
 	return new Map(parsed.data.devices.map((entry) => [entry.serial, entry.enabled]));
 }
+var DeviceVolumeEntrySchema = object({
+	serial: string().min(1),
+	volume: number$1().finite().optional(),
+	muted: boolean().optional()
+});
+function parseDeviceVolumes(result) {
+	const parsed = object({ devices: array(DeviceVolumeEntrySchema) }).safeParse(result);
+	if (!parsed.success) throw new Error("worker returned an unexpected device volume list");
+	return new Map(parsed.data.devices.map((entry) => [entry.serial, {
+		volume: entry.volume ?? null,
+		muted: entry.muted ?? null
+	}]));
+}
 //#endregion
 //#region src/devices/alexa-echo-device.ts
 /**
@@ -142430,6 +142485,8 @@ var alexaEchoDeviceSchema = object({
 	system: literal("alexa").optional(),
 	integrationId: string().optional()
 });
+/** Percent points one volume-up / volume-down moves an Echo. */
+var VOLUME_STEP = 10;
 var COLD_DND = {
 	enabled: null,
 	lastChangedAt: 0
@@ -142450,6 +142507,7 @@ var AlexaEchoDevice = class extends BaseDevice {
 	rereadTimer = null;
 	polling = false;
 	failureLogged = false;
+	volumeFailureLogged = false;
 	health = "ok";
 	constructor(ctx) {
 		const persisted = alexaEchoDeviceSchema.parse(ctx.persistedConfig ?? {});
@@ -142522,12 +142580,11 @@ var AlexaEchoDevice = class extends BaseDevice {
 		}
 		const deviceType = this.amazonDeviceType !== "" ? this.amazonDeviceType : listed?.deviceType ?? "";
 		try {
-			const info = await session.playerState(this.serial, deviceType);
-			const now = Date.now();
-			this.runtimeState.setCapState("media-player", mapPlayerInfoToStatus(info, {
+			const fromPlayer = mapPlayerInfoToStatus(await session.playerState(this.serial, deviceType), {
 				online: true,
-				now
-			}));
+				now: Date.now()
+			});
+			this.runtimeState.setCapState("media-player", await this.completeVolume(fromPlayer));
 			this.markOnline(true);
 			this.noteRecovered();
 		} catch (err) {
@@ -142536,6 +142593,29 @@ var AlexaEchoDevice = class extends BaseDevice {
 		}
 		await this.readDoNotDisturb();
 	}
+	/**
+	* An idle Echo's player read carries no volume. Ask the account's volume list
+	* (shared by every Echo of the account in this cycle); a failed read leaves null.
+	*/
+	async completeVolume(status) {
+		if (status.volumeLevel !== null && status.isMuted !== null) return status;
+		try {
+			const all = await alexaEchoSessions.volumes(this.brokerId, Date.now());
+			if (this.volumeFailureLogged) this.ctx.logger.info("alexa echo: the volume list reads again", { tags: { deviceId: this.id } });
+			this.volumeFailureLogged = false;
+			return withListedVolume(status, all.get(this.serial));
+		} catch (err) {
+			if (err instanceof RateLimitedError) return status;
+			if (!this.volumeFailureLogged) {
+				this.volumeFailureLogged = true;
+				this.ctx.logger.warn("alexa echo: could not read the volume list, volume stays unknown", {
+					tags: { deviceId: this.id },
+					meta: { error: err instanceof Error ? err.message : String(err) }
+				});
+			}
+			return status;
+		}
+	}
 	async readDoNotDisturb() {
 		try {
 			const enabled = (await alexaEchoSessions.dnd(this.brokerId, Date.now())).get(this.serial);
@@ -142571,6 +142651,14 @@ var AlexaEchoDevice = class extends BaseDevice {
 		await this.session().npCommand(this.serial, command);
 		this.rereadSoon();
 	}
+	/** Amazon has no step command: move from the last known level, refuse when there is none. */
+	async stepVolume(delta) {
+		const level = this.runtimeState.getCapState("media-player")?.volumeLevel;
+		if (level === null || level === void 0) throw new Error("the Echo volume is not known yet");
+		const next = Math.max(0, Math.min(100, level + delta));
+		await this.session().setVolume(this.serial, next);
+		this.rereadSoon();
+	}
 	registerMediaPlayer() {
 		this.ctx.registerNativeCap(mediaPlayerCapability, {
 			getStatus: async () => this.runtimeState.getCapState("media-player") ?? emptyEchoStatus("off", 0),
@@ -142585,8 +142673,8 @@ var AlexaEchoDevice = class extends BaseDevice {
 			stop: async () => unsupported("stop"),
 			turnOn: async () => unsupported("power"),
 			turnOff: async () => unsupported("power"),
-			volumeUp: async () => unsupported("volume steps"),
-			volumeDown: async () => unsupported("volume steps"),
+			volumeUp: async () => this.stepVolume(VOLUME_STEP),
+			volumeDown: async () => this.stepVolume(-10),
 			channelUp: async () => unsupported("channel steps"),
 			channelDown: async () => unsupported("channel steps"),
 			seek: async () => unsupported("seek"),
@@ -143093,6 +143181,11 @@ var BrokerEcho = class {
 		await this.requireReady();
 		return this.limited(async () => parseDndState(await this.deps.worker.request({ op: "dnd_state" })));
 	}
+	/** Speaker volume and mute of every device of the account, by serial, in one call. */
+	async deviceVolumes() {
+		await this.requireReady();
+		return this.limited(async () => parseDeviceVolumes(await this.deps.worker.request({ op: "device_volumes" })));
+	}
 	async setDnd(serial, enabled) {
 		await this.requireReady();
 		await this.limited(() => this.deps.worker.request({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-import-alexa",
-  "version": "0.2.180",
+  "version": "0.2.182",
   "description": "Alexa device-import provider for CamStack — imports the smart-home devices in a user's Alexa account via the unofficial alexa-remote2 cookie/token client (the inverse of the Alexa exporter)",
   "keywords": [
     "camstack",
@@ -68,7 +68,7 @@
       }
     ],
     "requires": {
-      "server": ">=1.2.747"
+      "server": ">=1.2.750"
     }
   },
   "files": [

package/python/alexa_gateway.py

@@ -95,6 +95,9 @@ def normalize_device(raw: dict) -> dict | None:
 # The skill alexapy itself names for an AlexaAnnouncement node.
 ANNOUNCEMENT_SKILL_ID = "amzn1.ask.1p.routines.messaging"
 
+VOLUMES_PATH = "/api/devices/deviceType/dsn/audio/v1/allDeviceVolumes"
+
+
 class AlexaPyGateway:
     """Holds one AlexaLogin for the life of the process (one process per broker)."""
 
@@ -309,6 +312,49 @@ class AlexaPyGateway:
         self._touch_success()
         return {"devices": devices}
 
+    async def device_volumes(self) -> dict:
+        """Speaker volume and mute of every device, in one call (idle Echos included)."""
+        login = self._require_login()
+        _AlexaLogin, AlexaAPI = _import_alexapy()
+        try:
+            body = await AlexaAPI._static_request("get", login, VOLUMES_PATH)
+        except Exception as err:  # noqa: BLE001 — typed below
+            if is_rate_limited(err):
+                raise RateLimitedError("amazon rate limit (429) on the device volumes") from err
+            raise
+        # `_static_request` hands back the raw response (None on status >= 400): parse it here.
+        if body is None:
+            raise RuntimeError("amazon returned no response for the device volume list (HTTP >= 400)")
+        status = getattr(body, "status", None)
+        try:
+            body = await body.json(content_type=None)
+        except Exception as err:  # noqa: BLE001 — typed below
+            raise RuntimeError(
+                f"amazon returned an unexpected body for the device volume list (HTTP {status}, unparseable)"
+            ) from err
+        if not isinstance(body, dict):
+            raise RuntimeError(
+                f"amazon returned an unexpected body for the device volume list (HTTP {status}, not an object)"
+            )
+        rows = body.get("volumes")
+        devices = []
+        for row in rows if isinstance(rows, list) else []:
+            if not isinstance(row, dict):
+                continue
+            serial = row.get("dsn")
+            volume = row.get("speakerVolume")
+            muted = row.get("speakerMuted")
+            if not isinstance(serial, str) or serial == "":
+                continue
+            entry = {"serial": serial}
+            if isinstance(volume, (int, float)) and not isinstance(volume, bool):
+                entry["volume"] = volume
+            if isinstance(muted, bool):
+                entry["muted"] = muted
+            devices.append(entry)
+        self._touch_success()
+        return {"devices": devices}
+
     async def set_dnd(self, serial: str, enabled: bool) -> None:
         device_type = self._device_type_of(serial)
         async with self._lock(serial):

package/python/alexa_protocol.py

@@ -44,6 +44,8 @@ class Gateway(Protocol):
 
     async def dnd_state(self) -> dict: ...
 
+    async def device_volumes(self) -> dict: ...
+
     async def set_dnd(self, serial: str, enabled: bool) -> None: ...
 
     def target_for(self, serial: str) -> EchoTarget | None: ...
@@ -116,6 +118,8 @@ class Session:
             return {}
         if op == "dnd_state":
             return await self._gateway.dnd_state()
+        if op == "device_volumes":
+            return await self._gateway.device_volumes()
         if op == "set_dnd":
             enabled = message.get("enabled")
             if not isinstance(enabled, bool):

package/python/test_alexa_gateway_echo.py

@@ -18,11 +18,25 @@ class AlexapyTooManyRequestsError(Exception):
     pass
 
 
+class FakeResponse:
+    """What alexapy's `_static_request` really returns: an aiohttp-like response, parsed by the caller."""
+
+    def __init__(self, status, payload=None, bad_json=False):
+        self.status = status
+        self._payload = payload
+        self._bad_json = bad_json
+
+    async def json(self, content_type=None):
+        if self._bad_json:
+            raise ValueError("not json")
+        return self._payload
+
+
 def run(coro):
     return asyncio.run(coro)
 
 
-def install_fake(state=None, dnd=None, raises=None):
+def install_fake(state=None, dnd=None, raises=None, volumes=None):
     calls: dict = {"behaviors": [], "media": [], "dnd_set": [], "state_for": [], "active": 0, "max_active": 0}
 
     class FakeAPI:
@@ -54,6 +68,13 @@ def install_fake(state=None, dnd=None, raises=None):
                 raise raises
             calls["behaviors"].append(node)
 
+        @staticmethod
+        async def _static_request(method, login, uri, data=None, query=None):
+            if raises:
+                raise raises
+            calls.setdefault("static", []).append((method, uri))
+            return volumes
+
         @staticmethod
         async def get_dnd_state(login):
             if raises:
@@ -134,6 +155,44 @@ class EchoMediaTests(unittest.TestCase):
         result = run(gateway.dnd_state())
         self.assertEqual(result["devices"], [{"serial": "s1", "enabled": True}, {"serial": "s2", "enabled": False}])
 
+    def test_device_volumes_is_one_call_keeping_only_typed_readings(self) -> None:
+        gateway, calls = install_fake(
+            volumes=FakeResponse(
+                200,
+                {
+                    "volumes": [
+                        {"dsn": "s1", "deviceType": "T1", "speakerVolume": 46, "speakerMuted": False},
+                        {"dsn": "s2", "speakerVolume": None, "speakerMuted": True},
+                        {"deviceType": "T1", "speakerVolume": 10},
+                    ]
+                },
+            )
+        )
+        result = run(gateway.device_volumes())
+        self.assertEqual(
+            result["devices"],
+            [{"serial": "s1", "volume": 46, "muted": False}, {"serial": "s2", "muted": True}],
+        )
+        self.assertEqual(
+            calls["static"], [("get", "/api/devices/deviceType/dsn/audio/v1/allDeviceVolumes")]
+        )
+
+    def test_device_volumes_http_failure_is_told_apart_from_a_bad_body(self) -> None:
+        gateway, _ = install_fake(volumes=None)
+        with self.assertRaisesRegex(RuntimeError, "no response"):
+            run(gateway.device_volumes())
+        gateway, _ = install_fake(volumes=FakeResponse(200, ["not", "a", "dict"]))
+        with self.assertRaisesRegex(RuntimeError, "unexpected body"):
+            run(gateway.device_volumes())
+        gateway, _ = install_fake(volumes=FakeResponse(200, bad_json=True))
+        with self.assertRaisesRegex(RuntimeError, "unexpected body"):
+            run(gateway.device_volumes())
+
+    def test_device_volumes_429_is_typed(self) -> None:
+        gateway, _ = install_fake(raises=AlexapyTooManyRequestsError("Too Many Requests"))
+        with self.assertRaises(RateLimitedError):
+            run(gateway.device_volumes())
+
     def test_set_dnd_goes_to_the_device(self) -> None:
         gateway, calls = install_fake()
         run(gateway.set_dnd("s1", True))