@camstack/addon-matter-broker 0.2.143 → 0.2.145

package/dist/addon.js

@@ -5578,7 +5578,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-DJFUfKvA.mjs
+//#region ../types/dist/sleep-CUp20JkO.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -8658,7 +8658,11 @@ var ContributionSectionSchema = object({
 		literal(4)
 	]).optional(),
 	tab: string$2().optional(),
-	location: _enum(["settings", "top-tab"]).optional(),
+	location: _enum([
+		"settings",
+		"top-tab",
+		"hero"
+	]).optional(),
 	order: number().optional(),
 	fields: array(any$2())
 });
@@ -13591,7 +13595,11 @@ var ConfigSectionWithValuesSchema = object({
 		literal(4)
 	]).optional(),
 	tab: string$2().optional(),
-	location: _enum(["settings", "top-tab"]).optional(),
+	location: _enum([
+		"settings",
+		"top-tab",
+		"hero"
+	]).optional(),
 	order: number().optional(),
 	fields: array(any$2())
 });
@@ -17520,6 +17528,52 @@ var TierStatusSchema = object({
 	countedAt: number().nullable()
 });
 /** Operator/diagnostic view: rows per tier, last runs, refusals and drops since boot. */
+/**
+* Why a series is orphan. `device-gone`: its device is absent from the
+* successful device listings (the departure clock). `undeclared`: its `cap:`
+* key is declared by no capability any more (a field a cap removed).
+*/
+var DeviceHistoryOrphanReasonSchema = _enum(["device-gone", "undeclared"]);
+/** Rows held per stored tier. */
+var TierRowsSchema = object({
+	raw: number().int(),
+	"5m": number().int(),
+	"1h": number().int(),
+	"1d": number().int()
+});
+var OrphanSeriesSchema = object({
+	seriesId: number().int(),
+	deviceId: number().int(),
+	key: string$2(),
+	scope: string$2(),
+	/** The metric's display name; `null` when its metric row is gone too. */
+	displayName: string$2().nullable(),
+	reason: DeviceHistoryOrphanReasonSchema,
+	/** `device-gone`: since when the device has been absent; `null` otherwise. */
+	missingSince: number().nullable(),
+	firstTs: number(),
+	lastTs: number(),
+	rows: TierRowsSchema
+});
+var DeviceHistoryOrphanDeleteRefusalSchema = _enum([
+	"not-found",
+	"not-orphan",
+	"failed"
+]);
+var OrphanDeleteEntrySchema = discriminatedUnion("ok", [object({
+	seriesId: number().int(),
+	ok: literal(true),
+	deleted: TierRowsSchema
+}), object({
+	seriesId: number().int(),
+	ok: literal(false),
+	reason: DeviceHistoryOrphanDeleteRefusalSchema
+})]);
+var OrphanListSchema = object({
+	series: array(OrphanSeriesSchema).readonly(),
+	/** More orphans exist than {@link DEVICE_HISTORY_ORPHAN_LIST_MAX}. */
+	truncated: boolean()
+});
 var DeviceHistoryStatusSchema = object({
 	startedAt: number(),
 	/** The store is declared, series loaded and the first reconcile has answered. */
@@ -17617,7 +17671,10 @@ method(object({ deviceId: number().int() }), array(SeriesInfoSchema).readonly())
 }), object({ enabled: boolean() }), {
 	kind: "mutation",
 	auth: "admin"
-}), method(object({}), DeviceHistoryStatusSchema, { auth: "admin" });
+}), method(object({}), DeviceHistoryStatusSchema, { auth: "admin" }), method(object({}), OrphanListSchema, { auth: "admin" }), method(object({ seriesIds: array(number().int()).min(1).max(50) }), object({ results: array(OrphanDeleteEntrySchema).readonly() }), {
+	kind: "mutation",
+	auth: "admin"
+});
 var DeviceCaStatusSchema = discriminatedUnion("state", [
 	object({ state: literal("absent") }),
 	object({
@@ -48345,7 +48402,6 @@ var RecommendationReasonSchema = discriminatedUnion("kind", [
 		modelId: string$2()
 	}),
 	object({ kind: literal("cpu-device") }),
-	object({ kind: literal("coral-untouched") }),
 	object({ kind: literal("device-disabled") }),
 	object({ kind: literal("device-unavailable") }),
 	object({ kind: literal("node-offline") }),
@@ -48443,11 +48499,6 @@ var AutoTuneWarningSchema = discriminatedUnion("kind", [
 		kind: literal("detector-store-unreadable"),
 		error: string$2()
 	}),
-	object({
-		kind: literal("coral-enabled"),
-		nodeId: string$2(),
-		deviceKey: string$2()
-	}),
 	object({
 		kind: literal("custom-pin-kept"),
 		nodeId: string$2(),
@@ -55500,17 +55551,69 @@ var connectivityCapability = {
 	volatileStateFields: ["lastChangedAt"]
 };
 /**
-* Generic device-consumables capability — surfaces a device's
-* maintenance items (vacuum filters/brushes, replaceable cartridges,
-* descaling cycles, …) with their remaining life and an optional
-* "Replaced" reset action. Device-agnostic: any provider that knows its
-* device tracks consumables can register it; the cap declares no
-* vocabulary of its own — the provider names each item verbatim.
+* Generic device-consumables capability — the ONE place a device reports what
+* it uses up or fills: wear parts (vacuum filters/brushes, cartridges,
+* descaling cycles), supplies it draws from (a vacuum's clean-water tank and
+* detergent, a dishwasher's salt and rinse aid) and waste it collects (a dirty
+* water tank, a dust bin). Each item carries its remaining life or fill and an
+* optional "Replaced" reset action. Device-agnostic: any provider that knows
+* its device tracks consumables registers it; the provider names each item
+* verbatim and says which `kind` it is.
+*
+* The admin UI renders it as ONE collapsible section directly under the
+* device page's hero card (`placement: 'hero'`), for every device bound to
+* this cap — never drawn by a device type's hero card itself (D915).
 *
 * Like `childLayout`, the cap is INERT until a provider sets items: no
 * provider populates it by guessing (no HA inference). The UI renders a
 * "No consumables reported" placeholder when `items` is empty.
 */
+/**
+* What an item IS, which decides which direction is bad:
+*  - `wear`   — a part that wears out (a brush, a filter); low life is bad.
+*  - `supply` — something the device draws from (clean water, detergent,
+*    salt, rinse aid); low or empty is bad.
+*  - `waste`  — something the device fills (dirty water, a dust bin); full is
+*    bad.
+* Absent = `wear`.
+*/
+var ConsumableKindSchema = _enum([
+	"wear",
+	"supply",
+	"waste"
+]);
+/**
+* What an item LOOKS like, which decides how a client draws it — independent
+* of `kind`, which decides which direction is bad:
+*  - `part`    — a part that wears (a brush, a filter, a mop pad): a wear bar,
+*    remaining time and a reset.
+*  - `tank`    — a container of liquid (clean water, dirty water): a fill gauge.
+*  - `product` — something bought and refilled (detergent, salt, rinse aid):
+*    a stepped level and "refill".
+*  - `bin`     — a container that collects waste (a dust bin): a fill gauge
+*    that warns when full.
+* Absent = derived from the kind ({@link consumableFormOf}).
+*/
+var ConsumableFormSchema = _enum([
+	"part",
+	"tank",
+	"product",
+	"bin"
+]);
+/** The provider's own discrete verdict on an item. */
+var ConsumableStatusSchema = _enum([
+	"ok",
+	"low",
+	"empty",
+	"full",
+	"replace"
+]);
+_enum([
+	"ok",
+	"low",
+	"empty",
+	"full"
+]);
 /** Units a remaining-life counter is reported in. Closed: the panel renders
 *  each. */
 var ConsumableRemainingUnitSchema = _enum([
@@ -55525,18 +55628,23 @@ var ConsumableRemainingSchema = object({
 	unit: ConsumableRemainingUnitSchema
 });
 /** A single consumable item. Either a continuous `level` (remaining
-*  life %) or a discrete `status` may be known — both may be null when a
-*  provider only knows the item exists. `level` and `status` are not
-*  mutually exclusive; a provider may report both. */
+*  life %, or fill % for a `supply` / `waste` item) or a discrete `status`
+*  may be known — both may be null when a provider only knows the item
+*  exists. `level` and `status` are not mutually exclusive; a provider may
+*  report both. */
 var ConsumableItemSchema = object({
 	/** Stable id, e.g. 'main-brush'. */
 	key: string$2().min(1),
 	/** Display name. */
 	label: string$2().min(1),
-	/** Remaining life % when known (0..100). */
+	/** Remaining life % (`wear`) or fill % (`supply`, `waste`) when known (0..100). */
 	level: number().min(0).max(100).nullable(),
-	/** Discrete state when known (binary mode). */
-	status: _enum(["ok", "replace"]).nullable(),
+	/** The provider's discrete verdict when known (binary mode). */
+	status: ConsumableStatusSchema.nullable(),
+	/** What the item is — decides whether low or full is bad. Absent = `wear`. */
+	kind: ConsumableKindSchema.optional(),
+	/** How the item is drawn (part, tank, product, bin). Absent = derived from `kind`. */
+	form: ConsumableFormSchema.optional(),
 	/** Ms epoch of the last replace, when known. */
 	lastResetAt: number().nullable(),
 	/** Whether `reset()` is meaningful for this item. */
@@ -55559,7 +55667,7 @@ var consumablesCapability = {
 		kind: "widget",
 		widgetId: "host/consumables-panel",
 		tab: "consumables",
-		topTab: true,
+		placement: "hero",
 		label: "Consumables",
 		order: 5
 	} },
@@ -55620,9 +55728,37 @@ reset: method(object({
 	*/
 	durability: "restored",
 	/**
-	* History (D850): none — `items` is an array keyed by runtime ids; a history path never enters it.
+	* History (D850, D917): one series per (item field, item `key`) — the item key
+	* is the series scope, the item `label` names it. A vacuum tank's fill, a
+	* brush's remaining life and a dishwasher's salt are each recorded the moment
+	* their provider reports them; an item that appears later gets its series.
 	*/
-	history: "none",
+	history: {
+		fields: {},
+		items: {
+			path: "items",
+			key: "key",
+			label: "label",
+			fields: {
+				level: {
+					kind: "gauge",
+					unit: "%",
+					deadband: 2,
+					displayName: "Level"
+				},
+				status: {
+					kind: "enum",
+					displayName: "Status"
+				},
+				"remaining.value": {
+					kind: "gauge",
+					unitFrom: "remaining.unit",
+					deadband: 1,
+					displayName: "Remaining"
+				}
+			}
+		}
+	},
 	/** Clocks, not content: a re-read that changed no item costs no commit. */
 	volatileStateFields: ["lastChangedAt", "lastFetchedAt"]
 };
@@ -56037,8 +56173,9 @@ onStatusChanged: { data: object({
 	volatileStateFields: ["lastChangedAt"]
 };
 /**
-* Smart-dishwasher cap — program lifecycle, door / remote-start gates,
-* consumable levels (salt, rinse aid) and common program options.
+* Smart-dishwasher cap — program lifecycle, door / remote-start gates and
+* common program options. Salt and rinse aid are NOT here: they are items of
+* the device's `consumables` cap, like every other device's (D915).
 *
 * Sources: native Bosch Home Connect (`dishwasher` device type). Reusable
 * by any integration that exposes the same program / option surface.
@@ -56086,11 +56223,6 @@ var DishwasherAvailabilitySchema = _enum([
 	"offline",
 	"description-missing"
 ]);
-var DishwasherConsumableLevelSchema = _enum([
-	"ok",
-	"low",
-	"empty"
-]);
 var DishwasherStatusSchema = object({
 	availability: DishwasherAvailabilitySchema,
 	/** Coarse state for compact surfaces; `unavailable` whenever the appliance state is not known. */
@@ -56123,8 +56255,6 @@ var DishwasherStatusSchema = object({
 	powerOn: boolean().nullable(),
 	/** The raw power state (`On`, `Off`, `Standby`, …); null when not known. */
 	powerState: string$2().nullable(),
-	saltLevel: DishwasherConsumableLevelSchema.nullable(),
-	rinseAidLevel: DishwasherConsumableLevelSchema.nullable(),
 	/**
 	* True while the appliance asks for its filter to be cleaned (smart-filter, filter-system or
 	* combined care-and-filter reminder raised); false when every such reminder reads clear; null
@@ -64940,60 +65070,17 @@ method(_void(), array(UserSummarySchema), { auth: "admin" }), method(CreateUserI
 	auth: "admin",
 	access: "delete"
 });
-/**
-* Robot-vacuum cap. Models HA `vacuum.*` entities — anything with a
-* cleaning lifecycle plus a return-to-base / locate surface and an
-* optional fan-speed selector.
-*
-* State follows HA's canonical vacuum lifecycle: `idle` / `cleaning` /
-* `paused` / `returning` / `docked` / `error`. `batteryLevel`
-* (0..100) is nullable — some vacuums don't report a battery
-* percentage. `fanSpeed` is the current speed token (provider-verbatim,
-* e.g. `'standard'` / `'turbo'`) and `availableFanSpeeds` lists the
-* tokens the hardware accepts so the UI renders only supported choices.
-*
-* The `setFanSpeed` method takes the bare `speed` token — the provider
-* validates it against the vacuum's own list. `locate` triggers the
-* find-me chirp; `returnToBase` sends it home.
-*
-* Consumable / waste tanks: `cleanWater` / `dirtyWater` / `detergent` /
-* `dustBin` each carry a nullable `{ level (0..100 %), status ('ok' |
-* 'low' | 'full') }` reading. Native providers (e.g. Dreame, Roborock)
-* SHOULD populate whichever tanks the hardware has — leave a field `null`
-* only when the device has no such tank at all, and use a `TankStatus`
-* with both inner fields `null` when the tank exists but its level is
-* currently unknown. HA `vacuum.*` entities expose no per-tank telemetry,
-* so the HA provider leaves all four `null`.
-*/
-var VacuumStateSchema = _enum([
-	"idle",
-	"cleaning",
-	"paused",
-	"returning",
-	"docked",
-	"drying",
-	"error"
-]);
-/**
-* One consumable / waste tank on a robot vacuum (clean-water, dirty-water,
-* detergent or dust-bin). A tank can report a numeric fill `level` (0..100),
-* a discrete `status` (binary-style hardware), or both. Both `null` means the
-* level is currently unknown; the OWNING field being `null` means the
-* hardware has no such tank at all.
-*/
-var TankStatusSchema = object({
-	/** Numeric fill 0..100 when the hardware reports a percentage; null otherwise. */
-	level: number().min(0).max(100).nullable(),
-	/** Discrete state when the hardware is binary-mode; null otherwise. */
-	status: _enum([
-		"ok",
-		"low",
-		"full"
-	]).nullable()
-});
 var VacuumControlStatusSchema = object({
 	/** Lifecycle state of the vacuum. */
-	state: VacuumStateSchema,
+	state: _enum([
+		"idle",
+		"cleaning",
+		"paused",
+		"returning",
+		"docked",
+		"drying",
+		"error"
+	]),
 	/** 0..100 battery percentage. Null when the device has no battery
 	*  reading. */
 	batteryLevel: number().min(0).max(100).nullable(),
@@ -65002,14 +65089,6 @@ var VacuumControlStatusSchema = object({
 	fanSpeed: string$2().nullable(),
 	/** Speed tokens the hardware accepts — drives the UI selector. */
 	availableFanSpeeds: array(string$2()),
-	/** Clean-water (mop) tank. Null when the hardware has no clean-water tank. */
-	cleanWater: TankStatusSchema.nullable(),
-	/** Dirty-water (recovery) tank. Null when the hardware has no dirty-water tank. */
-	dirtyWater: TankStatusSchema.nullable(),
-	/** Detergent tank. Null when the hardware has no detergent tank. */
-	detergent: TankStatusSchema.nullable(),
-	/** Dust bin. Null when the hardware has no dust bin. */
-	dustBin: TankStatusSchema.nullable(),
 	/** 0..100 cleaning-completion percentage of the current task, or null. */
 	progressPercent: number().min(0).max(100).nullable(),
 	/** Current error code (0 / null = no error). */
@@ -65071,35 +65150,14 @@ var vacuumControlCapability = {
 	*/
 	durability: "session",
 	/**
-	* History (D850): recorded series. Tank levels are fixed-object paths (`cleanWater.level`, ...).
+	* History (D850): recorded series. The tanks moved to `consumables` (D915), whose
+	* items are keyed by runtime ids and record no history.
 	*/
-	history: { fields: {
-		batteryLevel: {
-			kind: "gauge",
-			unit: "%",
-			deadband: 2
-		},
-		"cleanWater.level": {
-			kind: "gauge",
-			unit: "%",
-			deadband: 2
-		},
-		"dirtyWater.level": {
-			kind: "gauge",
-			unit: "%",
-			deadband: 2
-		},
-		"detergent.level": {
-			kind: "gauge",
-			unit: "%",
-			deadband: 2
-		},
-		"dustBin.level": {
-			kind: "gauge",
-			unit: "%",
-			deadband: 2
-		}
-	} }
+	history: { fields: { batteryLevel: {
+		kind: "gauge",
+		unit: "%",
+		deadband: 2
+	} } }
 };
 var ValveStatusSchema = object({
 	/** Lifecycle state of the valve. */
@@ -69493,6 +69551,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceHistory.deleteOrphanSeries": {
+		capName: "device-history",
+		capScope: "system",
+		addonId: null,
+		access: "delete"
+	},
 	"deviceHistory.getDeviceEnabled": {
 		capName: "device-history",
 		capScope: "system",
@@ -69511,6 +69575,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"deviceHistory.listOrphanSeries": {
+		capName: "device-history",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceHistory.listSeries": {
 		capName: "device-history",
 		capScope: "system",
@@ -79516,7 +79586,7 @@ var STATE_SUMMARY_VARS = [
 	([...RULE_TEXT], [...COMBINED_ALARM]),
 	([...RULE_TEXT], [...DEVICE_EVENTS]),
 	([...RULE_TEXT], [...BATTERY, ...CONSUMABLE]),
-	([...RULE_TEXT], [...CONSUMABLE]),
+	([...RULE_TEXT], [...CONSUMABLE, ...TANK]),
 	([...RULE_TEXT], [...TANK]),
 	[...RULE_TEXT],
 	([...RULE_TEXT], [...UPDATES, ...ALERT_EPISODE]),

package/dist/addon.mjs

@@ -5576,7 +5576,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-DJFUfKvA.mjs
+//#region ../types/dist/sleep-CUp20JkO.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -8656,7 +8656,11 @@ var ContributionSectionSchema = object({
 		literal(4)
 	]).optional(),
 	tab: string$2().optional(),
-	location: _enum(["settings", "top-tab"]).optional(),
+	location: _enum([
+		"settings",
+		"top-tab",
+		"hero"
+	]).optional(),
 	order: number().optional(),
 	fields: array(any$2())
 });
@@ -13589,7 +13593,11 @@ var ConfigSectionWithValuesSchema = object({
 		literal(4)
 	]).optional(),
 	tab: string$2().optional(),
-	location: _enum(["settings", "top-tab"]).optional(),
+	location: _enum([
+		"settings",
+		"top-tab",
+		"hero"
+	]).optional(),
 	order: number().optional(),
 	fields: array(any$2())
 });
@@ -17518,6 +17526,52 @@ var TierStatusSchema = object({
 	countedAt: number().nullable()
 });
 /** Operator/diagnostic view: rows per tier, last runs, refusals and drops since boot. */
+/**
+* Why a series is orphan. `device-gone`: its device is absent from the
+* successful device listings (the departure clock). `undeclared`: its `cap:`
+* key is declared by no capability any more (a field a cap removed).
+*/
+var DeviceHistoryOrphanReasonSchema = _enum(["device-gone", "undeclared"]);
+/** Rows held per stored tier. */
+var TierRowsSchema = object({
+	raw: number().int(),
+	"5m": number().int(),
+	"1h": number().int(),
+	"1d": number().int()
+});
+var OrphanSeriesSchema = object({
+	seriesId: number().int(),
+	deviceId: number().int(),
+	key: string$2(),
+	scope: string$2(),
+	/** The metric's display name; `null` when its metric row is gone too. */
+	displayName: string$2().nullable(),
+	reason: DeviceHistoryOrphanReasonSchema,
+	/** `device-gone`: since when the device has been absent; `null` otherwise. */
+	missingSince: number().nullable(),
+	firstTs: number(),
+	lastTs: number(),
+	rows: TierRowsSchema
+});
+var DeviceHistoryOrphanDeleteRefusalSchema = _enum([
+	"not-found",
+	"not-orphan",
+	"failed"
+]);
+var OrphanDeleteEntrySchema = discriminatedUnion("ok", [object({
+	seriesId: number().int(),
+	ok: literal(true),
+	deleted: TierRowsSchema
+}), object({
+	seriesId: number().int(),
+	ok: literal(false),
+	reason: DeviceHistoryOrphanDeleteRefusalSchema
+})]);
+var OrphanListSchema = object({
+	series: array(OrphanSeriesSchema).readonly(),
+	/** More orphans exist than {@link DEVICE_HISTORY_ORPHAN_LIST_MAX}. */
+	truncated: boolean()
+});
 var DeviceHistoryStatusSchema = object({
 	startedAt: number(),
 	/** The store is declared, series loaded and the first reconcile has answered. */
@@ -17615,7 +17669,10 @@ method(object({ deviceId: number().int() }), array(SeriesInfoSchema).readonly())
 }), object({ enabled: boolean() }), {
 	kind: "mutation",
 	auth: "admin"
-}), method(object({}), DeviceHistoryStatusSchema, { auth: "admin" });
+}), method(object({}), DeviceHistoryStatusSchema, { auth: "admin" }), method(object({}), OrphanListSchema, { auth: "admin" }), method(object({ seriesIds: array(number().int()).min(1).max(50) }), object({ results: array(OrphanDeleteEntrySchema).readonly() }), {
+	kind: "mutation",
+	auth: "admin"
+});
 var DeviceCaStatusSchema = discriminatedUnion("state", [
 	object({ state: literal("absent") }),
 	object({
@@ -48343,7 +48400,6 @@ var RecommendationReasonSchema = discriminatedUnion("kind", [
 		modelId: string$2()
 	}),
 	object({ kind: literal("cpu-device") }),
-	object({ kind: literal("coral-untouched") }),
 	object({ kind: literal("device-disabled") }),
 	object({ kind: literal("device-unavailable") }),
 	object({ kind: literal("node-offline") }),
@@ -48441,11 +48497,6 @@ var AutoTuneWarningSchema = discriminatedUnion("kind", [
 		kind: literal("detector-store-unreadable"),
 		error: string$2()
 	}),
-	object({
-		kind: literal("coral-enabled"),
-		nodeId: string$2(),
-		deviceKey: string$2()
-	}),
 	object({
 		kind: literal("custom-pin-kept"),
 		nodeId: string$2(),
@@ -55498,17 +55549,69 @@ var connectivityCapability = {
 	volatileStateFields: ["lastChangedAt"]
 };
 /**
-* Generic device-consumables capability — surfaces a device's
-* maintenance items (vacuum filters/brushes, replaceable cartridges,
-* descaling cycles, …) with their remaining life and an optional
-* "Replaced" reset action. Device-agnostic: any provider that knows its
-* device tracks consumables can register it; the cap declares no
-* vocabulary of its own — the provider names each item verbatim.
+* Generic device-consumables capability — the ONE place a device reports what
+* it uses up or fills: wear parts (vacuum filters/brushes, cartridges,
+* descaling cycles), supplies it draws from (a vacuum's clean-water tank and
+* detergent, a dishwasher's salt and rinse aid) and waste it collects (a dirty
+* water tank, a dust bin). Each item carries its remaining life or fill and an
+* optional "Replaced" reset action. Device-agnostic: any provider that knows
+* its device tracks consumables registers it; the provider names each item
+* verbatim and says which `kind` it is.
+*
+* The admin UI renders it as ONE collapsible section directly under the
+* device page's hero card (`placement: 'hero'`), for every device bound to
+* this cap — never drawn by a device type's hero card itself (D915).
 *
 * Like `childLayout`, the cap is INERT until a provider sets items: no
 * provider populates it by guessing (no HA inference). The UI renders a
 * "No consumables reported" placeholder when `items` is empty.
 */
+/**
+* What an item IS, which decides which direction is bad:
+*  - `wear`   — a part that wears out (a brush, a filter); low life is bad.
+*  - `supply` — something the device draws from (clean water, detergent,
+*    salt, rinse aid); low or empty is bad.
+*  - `waste`  — something the device fills (dirty water, a dust bin); full is
+*    bad.
+* Absent = `wear`.
+*/
+var ConsumableKindSchema = _enum([
+	"wear",
+	"supply",
+	"waste"
+]);
+/**
+* What an item LOOKS like, which decides how a client draws it — independent
+* of `kind`, which decides which direction is bad:
+*  - `part`    — a part that wears (a brush, a filter, a mop pad): a wear bar,
+*    remaining time and a reset.
+*  - `tank`    — a container of liquid (clean water, dirty water): a fill gauge.
+*  - `product` — something bought and refilled (detergent, salt, rinse aid):
+*    a stepped level and "refill".
+*  - `bin`     — a container that collects waste (a dust bin): a fill gauge
+*    that warns when full.
+* Absent = derived from the kind ({@link consumableFormOf}).
+*/
+var ConsumableFormSchema = _enum([
+	"part",
+	"tank",
+	"product",
+	"bin"
+]);
+/** The provider's own discrete verdict on an item. */
+var ConsumableStatusSchema = _enum([
+	"ok",
+	"low",
+	"empty",
+	"full",
+	"replace"
+]);
+_enum([
+	"ok",
+	"low",
+	"empty",
+	"full"
+]);
 /** Units a remaining-life counter is reported in. Closed: the panel renders
 *  each. */
 var ConsumableRemainingUnitSchema = _enum([
@@ -55523,18 +55626,23 @@ var ConsumableRemainingSchema = object({
 	unit: ConsumableRemainingUnitSchema
 });
 /** A single consumable item. Either a continuous `level` (remaining
-*  life %) or a discrete `status` may be known — both may be null when a
-*  provider only knows the item exists. `level` and `status` are not
-*  mutually exclusive; a provider may report both. */
+*  life %, or fill % for a `supply` / `waste` item) or a discrete `status`
+*  may be known — both may be null when a provider only knows the item
+*  exists. `level` and `status` are not mutually exclusive; a provider may
+*  report both. */
 var ConsumableItemSchema = object({
 	/** Stable id, e.g. 'main-brush'. */
 	key: string$2().min(1),
 	/** Display name. */
 	label: string$2().min(1),
-	/** Remaining life % when known (0..100). */
+	/** Remaining life % (`wear`) or fill % (`supply`, `waste`) when known (0..100). */
 	level: number().min(0).max(100).nullable(),
-	/** Discrete state when known (binary mode). */
-	status: _enum(["ok", "replace"]).nullable(),
+	/** The provider's discrete verdict when known (binary mode). */
+	status: ConsumableStatusSchema.nullable(),
+	/** What the item is — decides whether low or full is bad. Absent = `wear`. */
+	kind: ConsumableKindSchema.optional(),
+	/** How the item is drawn (part, tank, product, bin). Absent = derived from `kind`. */
+	form: ConsumableFormSchema.optional(),
 	/** Ms epoch of the last replace, when known. */
 	lastResetAt: number().nullable(),
 	/** Whether `reset()` is meaningful for this item. */
@@ -55557,7 +55665,7 @@ var consumablesCapability = {
 		kind: "widget",
 		widgetId: "host/consumables-panel",
 		tab: "consumables",
-		topTab: true,
+		placement: "hero",
 		label: "Consumables",
 		order: 5
 	} },
@@ -55618,9 +55726,37 @@ reset: method(object({
 	*/
 	durability: "restored",
 	/**
-	* History (D850): none — `items` is an array keyed by runtime ids; a history path never enters it.
+	* History (D850, D917): one series per (item field, item `key`) — the item key
+	* is the series scope, the item `label` names it. A vacuum tank's fill, a
+	* brush's remaining life and a dishwasher's salt are each recorded the moment
+	* their provider reports them; an item that appears later gets its series.
 	*/
-	history: "none",
+	history: {
+		fields: {},
+		items: {
+			path: "items",
+			key: "key",
+			label: "label",
+			fields: {
+				level: {
+					kind: "gauge",
+					unit: "%",
+					deadband: 2,
+					displayName: "Level"
+				},
+				status: {
+					kind: "enum",
+					displayName: "Status"
+				},
+				"remaining.value": {
+					kind: "gauge",
+					unitFrom: "remaining.unit",
+					deadband: 1,
+					displayName: "Remaining"
+				}
+			}
+		}
+	},
 	/** Clocks, not content: a re-read that changed no item costs no commit. */
 	volatileStateFields: ["lastChangedAt", "lastFetchedAt"]
 };
@@ -56035,8 +56171,9 @@ onStatusChanged: { data: object({
 	volatileStateFields: ["lastChangedAt"]
 };
 /**
-* Smart-dishwasher cap — program lifecycle, door / remote-start gates,
-* consumable levels (salt, rinse aid) and common program options.
+* Smart-dishwasher cap — program lifecycle, door / remote-start gates and
+* common program options. Salt and rinse aid are NOT here: they are items of
+* the device's `consumables` cap, like every other device's (D915).
 *
 * Sources: native Bosch Home Connect (`dishwasher` device type). Reusable
 * by any integration that exposes the same program / option surface.
@@ -56084,11 +56221,6 @@ var DishwasherAvailabilitySchema = _enum([
 	"offline",
 	"description-missing"
 ]);
-var DishwasherConsumableLevelSchema = _enum([
-	"ok",
-	"low",
-	"empty"
-]);
 var DishwasherStatusSchema = object({
 	availability: DishwasherAvailabilitySchema,
 	/** Coarse state for compact surfaces; `unavailable` whenever the appliance state is not known. */
@@ -56121,8 +56253,6 @@ var DishwasherStatusSchema = object({
 	powerOn: boolean().nullable(),
 	/** The raw power state (`On`, `Off`, `Standby`, …); null when not known. */
 	powerState: string$2().nullable(),
-	saltLevel: DishwasherConsumableLevelSchema.nullable(),
-	rinseAidLevel: DishwasherConsumableLevelSchema.nullable(),
 	/**
 	* True while the appliance asks for its filter to be cleaned (smart-filter, filter-system or
 	* combined care-and-filter reminder raised); false when every such reminder reads clear; null
@@ -64938,60 +65068,17 @@ method(_void(), array(UserSummarySchema), { auth: "admin" }), method(CreateUserI
 	auth: "admin",
 	access: "delete"
 });
-/**
-* Robot-vacuum cap. Models HA `vacuum.*` entities — anything with a
-* cleaning lifecycle plus a return-to-base / locate surface and an
-* optional fan-speed selector.
-*
-* State follows HA's canonical vacuum lifecycle: `idle` / `cleaning` /
-* `paused` / `returning` / `docked` / `error`. `batteryLevel`
-* (0..100) is nullable — some vacuums don't report a battery
-* percentage. `fanSpeed` is the current speed token (provider-verbatim,
-* e.g. `'standard'` / `'turbo'`) and `availableFanSpeeds` lists the
-* tokens the hardware accepts so the UI renders only supported choices.
-*
-* The `setFanSpeed` method takes the bare `speed` token — the provider
-* validates it against the vacuum's own list. `locate` triggers the
-* find-me chirp; `returnToBase` sends it home.
-*
-* Consumable / waste tanks: `cleanWater` / `dirtyWater` / `detergent` /
-* `dustBin` each carry a nullable `{ level (0..100 %), status ('ok' |
-* 'low' | 'full') }` reading. Native providers (e.g. Dreame, Roborock)
-* SHOULD populate whichever tanks the hardware has — leave a field `null`
-* only when the device has no such tank at all, and use a `TankStatus`
-* with both inner fields `null` when the tank exists but its level is
-* currently unknown. HA `vacuum.*` entities expose no per-tank telemetry,
-* so the HA provider leaves all four `null`.
-*/
-var VacuumStateSchema = _enum([
-	"idle",
-	"cleaning",
-	"paused",
-	"returning",
-	"docked",
-	"drying",
-	"error"
-]);
-/**
-* One consumable / waste tank on a robot vacuum (clean-water, dirty-water,
-* detergent or dust-bin). A tank can report a numeric fill `level` (0..100),
-* a discrete `status` (binary-style hardware), or both. Both `null` means the
-* level is currently unknown; the OWNING field being `null` means the
-* hardware has no such tank at all.
-*/
-var TankStatusSchema = object({
-	/** Numeric fill 0..100 when the hardware reports a percentage; null otherwise. */
-	level: number().min(0).max(100).nullable(),
-	/** Discrete state when the hardware is binary-mode; null otherwise. */
-	status: _enum([
-		"ok",
-		"low",
-		"full"
-	]).nullable()
-});
 var VacuumControlStatusSchema = object({
 	/** Lifecycle state of the vacuum. */
-	state: VacuumStateSchema,
+	state: _enum([
+		"idle",
+		"cleaning",
+		"paused",
+		"returning",
+		"docked",
+		"drying",
+		"error"
+	]),
 	/** 0..100 battery percentage. Null when the device has no battery
 	*  reading. */
 	batteryLevel: number().min(0).max(100).nullable(),
@@ -65000,14 +65087,6 @@ var VacuumControlStatusSchema = object({
 	fanSpeed: string$2().nullable(),
 	/** Speed tokens the hardware accepts — drives the UI selector. */
 	availableFanSpeeds: array(string$2()),
-	/** Clean-water (mop) tank. Null when the hardware has no clean-water tank. */
-	cleanWater: TankStatusSchema.nullable(),
-	/** Dirty-water (recovery) tank. Null when the hardware has no dirty-water tank. */
-	dirtyWater: TankStatusSchema.nullable(),
-	/** Detergent tank. Null when the hardware has no detergent tank. */
-	detergent: TankStatusSchema.nullable(),
-	/** Dust bin. Null when the hardware has no dust bin. */
-	dustBin: TankStatusSchema.nullable(),
 	/** 0..100 cleaning-completion percentage of the current task, or null. */
 	progressPercent: number().min(0).max(100).nullable(),
 	/** Current error code (0 / null = no error). */
@@ -65069,35 +65148,14 @@ var vacuumControlCapability = {
 	*/
 	durability: "session",
 	/**
-	* History (D850): recorded series. Tank levels are fixed-object paths (`cleanWater.level`, ...).
+	* History (D850): recorded series. The tanks moved to `consumables` (D915), whose
+	* items are keyed by runtime ids and record no history.
 	*/
-	history: { fields: {
-		batteryLevel: {
-			kind: "gauge",
-			unit: "%",
-			deadband: 2
-		},
-		"cleanWater.level": {
-			kind: "gauge",
-			unit: "%",
-			deadband: 2
-		},
-		"dirtyWater.level": {
-			kind: "gauge",
-			unit: "%",
-			deadband: 2
-		},
-		"detergent.level": {
-			kind: "gauge",
-			unit: "%",
-			deadband: 2
-		},
-		"dustBin.level": {
-			kind: "gauge",
-			unit: "%",
-			deadband: 2
-		}
-	} }
+	history: { fields: { batteryLevel: {
+		kind: "gauge",
+		unit: "%",
+		deadband: 2
+	} } }
 };
 var ValveStatusSchema = object({
 	/** Lifecycle state of the valve. */
@@ -69491,6 +69549,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceHistory.deleteOrphanSeries": {
+		capName: "device-history",
+		capScope: "system",
+		addonId: null,
+		access: "delete"
+	},
 	"deviceHistory.getDeviceEnabled": {
 		capName: "device-history",
 		capScope: "system",
@@ -69509,6 +69573,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"deviceHistory.listOrphanSeries": {
+		capName: "device-history",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceHistory.listSeries": {
 		capName: "device-history",
 		capScope: "system",
@@ -79514,7 +79584,7 @@ var STATE_SUMMARY_VARS = [
 	([...RULE_TEXT], [...COMBINED_ALARM]),
 	([...RULE_TEXT], [...DEVICE_EVENTS]),
 	([...RULE_TEXT], [...BATTERY, ...CONSUMABLE]),
-	([...RULE_TEXT], [...CONSUMABLE]),
+	([...RULE_TEXT], [...CONSUMABLE, ...TANK]),
 	([...RULE_TEXT], [...TANK]),
 	[...RULE_TEXT],
 	([...RULE_TEXT], [...UPDATES, ...ALERT_EPISODE]),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-matter-broker",
-  "version": "0.2.143",
+  "version": "0.2.145",
   "description": "Matter broker addon for CamStack — owns a Matter fabric (commissioning + the long-lived controller) via the matter.js controller and brokers commissioned Matter nodes into CamStack",
   "keywords": [
     "camstack",