@camstack/types 1.2.400 → 1.2.402

package/dist/addon.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-CD18m9HF.js");
+const require_sleep = require("./sleep-DVovpDRU.js");
 const require_event_category = require("./event-category-7AwNbPjm.js");
 const require_err_msg = require("./err-msg-BhVbr0NX.js");
 //#region src/generated/cap-input-defaults.ts
@@ -1067,24 +1067,6 @@ var CAP_STATE_LEAVES = Object.freeze({
 			"path": "powerState",
 			"valueType": "string"
 		},
-		{
-			"path": "saltLevel",
-			"valueType": "enum",
-			"enumValues": [
-				"ok",
-				"low",
-				"empty"
-			]
-		},
-		{
-			"path": "rinseAidLevel",
-			"valueType": "enum",
-			"enumValues": [
-				"ok",
-				"low",
-				"empty"
-			]
-		},
 		{
 			"path": "filterCleaningDue",
 			"valueType": "boolean"
@@ -2110,58 +2092,6 @@ var CAP_STATE_LEAVES = Object.freeze({
 			"path": "fanSpeed",
 			"valueType": "string"
 		},
-		{
-			"path": "cleanWater.level",
-			"valueType": "number"
-		},
-		{
-			"path": "cleanWater.status",
-			"valueType": "enum",
-			"enumValues": [
-				"ok",
-				"low",
-				"full"
-			]
-		},
-		{
-			"path": "dirtyWater.level",
-			"valueType": "number"
-		},
-		{
-			"path": "dirtyWater.status",
-			"valueType": "enum",
-			"enumValues": [
-				"ok",
-				"low",
-				"full"
-			]
-		},
-		{
-			"path": "detergent.level",
-			"valueType": "number"
-		},
-		{
-			"path": "detergent.status",
-			"valueType": "enum",
-			"enumValues": [
-				"ok",
-				"low",
-				"full"
-			]
-		},
-		{
-			"path": "dustBin.level",
-			"valueType": "number"
-		},
-		{
-			"path": "dustBin.status",
-			"valueType": "enum",
-			"enumValues": [
-				"ok",
-				"low",
-				"full"
-			]
-		},
 		{
 			"path": "progressPercent",
 			"valueType": "number"

package/dist/addon.mjs

@@ -1,4 +1,4 @@
-import { $t as recordArrayItemPath, A as HF_REPO, An as RECORD_DELETE_BATCH, B as describeCustomActions, Bn as REVALIDATE_AFTER_MS, Br as isSecretMarker, Bt as RecordFieldPathSchema, C as addonSliceHandleApi, Cn as asRecordsError, Dn as RECORD_CLASSES, En as RECORD_BATCH_MAX_BYTES, Er as emitReadiness, F as DEVICE_CHILDREN_BATCH_MAX, Fn as RECORD_QUERY_MAX, Ft as defineEntryKind, Gn as knownSecretCount, Gt as StoredRecordKindDeclarationSchema, H as adminUiCapability, Hn as MIN_SCRUBBED_LENGTH, Hr as makeSecretMarker, Ht as RecordKindDeclarationSchema, I as CALLER_STAMPED_CAPABILITIES, In as RECORD_SECRET_COLLECTION_PREFIX, Ir as SECRET_CLEAR, It as entryBody, Jn as shortSecretRefHash, Jt as defineRecordKinds, Kn as registerKnownSecret, Kt as assertValidDeclaration, L as withoutCallerStamp, Ln as RECORD_SETTINGS_MAX_ROWS, Lr as classifySecretWrite, Lt as createRecordsAccess, Mn as RECORD_MAX_DATA_BYTES, N as deviceOpsCapability, Nn as RECORD_MAX_INDEXES, On as RECORD_DATABASES, P as viewerUiCapability, Pn as RECORD_MAX_INDEX_FIELDS, Pt as makeInMemoryRecords, Qn as PEER_BYTES_TICKET_TTL_MS, Qt as parseSecretPath, Rn as RECORD_SWEEP_INTERVAL_MS, Rr as isSecretClear, Rt as assertTransactScope, Sn as UnknownRecordKindError, Sr as parseSecretRef, Tn as RECORD_BATCH_MAX, Tr as createEvent, Un as clearKnownSecrets, Ur as toSecretFieldView, Ut as RecordKindNameSchema, Vn as createSecretsAccess, Vr as isSecretMarkerLike, Vt as RecordIndexSchema, Wn as forgetKnownSecret, Wt as RecordRetentionSchema, X as expandCapMethods, Xn as PEER_BYTES_MAX_OUTSTANDING, Xt as collectSecretLeaves, Yn as PEER_BYTES_CHUNK_BYTES, Yt as REMOVE_LEAF, Zn as PEER_BYTES_STALL_MS, Zt as mapSecretLeaves, _ as readErrorI18n, _n as RecordUniqueViolationError, _r as buildSecretRef, an as isZodSecret, ar as normalizeAddonInitResult, b as isDeviceScopedCap, bn as TransactRefusedError, br as isSecretRef, c as asString, cn as FilterRequiredError, ct as ReadinessTimeoutError, d as parseJsonUnknown, dn as NoCallerError, dt as scopeKey, en as recordSecretCollection, er as DATAPLANE_SECRET_HEADER, f as hfModelUrl, fn as PlaintextSecretError, g as ErrorI18nPayloadSchema, gn as RecordTooLargeError, gr as arrayItemFieldPath, hn as RecordSecretUnavailableError, hr as SECRET_REF_SCHEME, in as collectZodSecretPaths, it as readNodePin, jn as RECORD_ID_MAX_LENGTH, kn as RECORD_DEFAULT_MAX_DATA_BYTES, ln as ForeignSecretMarkerError, mn as RecordNotFoundError, nn as secretArrayPrefixes, nr as DisposerChain, o as asJsonObject, on as BatchTooLargeError, ot as MODEL_FORMATS, p as BOOT_RECOVERY_BACKOFF_MS, pn as RECORDS_ERROR_CODES, qn as scrubKnownSecrets, qt as declarationsOf, r as maskUrlCredentials, rr as BaseAddon, rt as nodePin, sn as DeclarationRefusedError, st as ReadinessRegistry, t as sleep, tn as recordSecretRef, un as InvalidRecordError, vn as RecordsError, vr as formatSecretScope, w as createEventBusSliceSource, wn as recordsErrorFromMessage, x as createDeviceProxy, xn as UnindexedFilterError, xr as normalizeSecretOwner, y as DEVICE_SCOPED_CAPS, yn as RevConflictError, yr as globalSecretScope, zn as resolveSecretViewsIn, zr as isSecretFieldView, zt as EntryDescriptorSchema } from "./sleep-DJFUfKvA.mjs";
+import { $n as PEER_BYTES_TICKET_TTL_MS, $t as parseSecretPath, A as HF_REPO, An as RECORD_DEFAULT_MAX_DATA_BYTES, B as describeCustomActions, Bn as resolveSecretViewsIn, Br as isSecretFieldView, Bt as EntryDescriptorSchema, C as addonSliceHandleApi, Cn as UnknownRecordKindError, Cr as parseSecretRef, Dn as RECORD_BATCH_MAX_BYTES, Dr as emitReadiness, En as RECORD_BATCH_MAX, Er as createEvent, F as DEVICE_CHILDREN_BATCH_MAX, Fn as RECORD_MAX_INDEX_FIELDS, Ft as makeInMemoryRecords, Gn as forgetKnownSecret, Gt as RecordRetentionSchema, H as adminUiCapability, Hn as createSecretsAccess, Hr as isSecretMarkerLike, Ht as RecordIndexSchema, I as CALLER_STAMPED_CAPABILITIES, In as RECORD_QUERY_MAX, It as defineEntryKind, Jn as scrubKnownSecrets, Jt as declarationsOf, Kn as knownSecretCount, Kt as StoredRecordKindDeclarationSchema, L as withoutCallerStamp, Ln as RECORD_SECRET_COLLECTION_PREFIX, Lr as SECRET_CLEAR, Lt as entryBody, Mn as RECORD_ID_MAX_LENGTH, N as deviceOpsCapability, Nn as RECORD_MAX_DATA_BYTES, On as RECORD_CLASSES, P as viewerUiCapability, Pn as RECORD_MAX_INDEXES, Qn as PEER_BYTES_STALL_MS, Qt as mapSecretLeaves, Rn as RECORD_SETTINGS_MAX_ROWS, Rr as classifySecretWrite, Rt as createRecordsAccess, Sn as UnindexedFilterError, Sr as normalizeSecretOwner, Tn as recordsErrorFromMessage, Un as MIN_SCRUBBED_LENGTH, Ur as makeSecretMarker, Ut as RecordKindDeclarationSchema, Vn as REVALIDATE_AFTER_MS, Vr as isSecretMarker, Vt as RecordFieldPathSchema, Wn as clearKnownSecrets, Wr as toSecretFieldView, Wt as RecordKindNameSchema, X as expandCapMethods, Xn as PEER_BYTES_CHUNK_BYTES, Xt as REMOVE_LEAF, Yn as shortSecretRefHash, Yt as defineRecordKinds, Zn as PEER_BYTES_MAX_OUTSTANDING, Zt as collectSecretLeaves, _ as readErrorI18n, _n as RecordTooLargeError, _r as arrayItemFieldPath, an as collectZodSecretPaths, at as readNodePin, b as isDeviceScopedCap, bn as RevConflictError, br as globalSecretScope, c as asString, cn as DeclarationRefusedError, ct as ReadinessRegistry, d as parseJsonUnknown, dn as InvalidRecordError, en as recordArrayItemPath, f as hfModelUrl, fn as NoCallerError, ft as scopeKey, g as ErrorI18nPayloadSchema, gn as RecordSecretUnavailableError, gr as SECRET_REF_SCHEME, hn as RecordNotFoundError, ir as BaseAddon, it as nodePin, jn as RECORD_DELETE_BATCH, kn as RECORD_DATABASES, ln as FilterRequiredError, lt as ReadinessTimeoutError, mn as RECORDS_ERROR_CODES, nn as recordSecretRef, o as asJsonObject, on as isZodSecret, or as normalizeAddonInitResult, p as BOOT_RECOVERY_BACKOFF_MS, pn as PlaintextSecretError, qn as registerKnownSecret, qt as assertValidDeclaration, r as maskUrlCredentials, rn as secretArrayPrefixes, rr as DisposerChain, sn as BatchTooLargeError, st as MODEL_FORMATS, t as sleep, tn as recordSecretCollection, tr as DATAPLANE_SECRET_HEADER, un as ForeignSecretMarkerError, vn as RecordUniqueViolationError, vr as buildSecretRef, w as createEventBusSliceSource, wn as asRecordsError, x as createDeviceProxy, xn as TransactRefusedError, xr as isSecretRef, y as DEVICE_SCOPED_CAPS, yn as RecordsError, yr as formatSecretScope, zn as RECORD_SWEEP_INTERVAL_MS, zr as isSecretClear, zt as assertTransactScope } from "./sleep-CUp20JkO.mjs";
 import { t as EventCategory } from "./event-category-BfJwUd2S.mjs";
 import { a as DeviceType, t as errMsg } from "./err-msg-BXKzRBwg.mjs";
 //#region src/generated/cap-input-defaults.ts
@@ -1066,24 +1066,6 @@ var CAP_STATE_LEAVES = Object.freeze({
 			"path": "powerState",
 			"valueType": "string"
 		},
-		{
-			"path": "saltLevel",
-			"valueType": "enum",
-			"enumValues": [
-				"ok",
-				"low",
-				"empty"
-			]
-		},
-		{
-			"path": "rinseAidLevel",
-			"valueType": "enum",
-			"enumValues": [
-				"ok",
-				"low",
-				"empty"
-			]
-		},
 		{
 			"path": "filterCleaningDue",
 			"valueType": "boolean"
@@ -2109,58 +2091,6 @@ var CAP_STATE_LEAVES = Object.freeze({
 			"path": "fanSpeed",
 			"valueType": "string"
 		},
-		{
-			"path": "cleanWater.level",
-			"valueType": "number"
-		},
-		{
-			"path": "cleanWater.status",
-			"valueType": "enum",
-			"enumValues": [
-				"ok",
-				"low",
-				"full"
-			]
-		},
-		{
-			"path": "dirtyWater.level",
-			"valueType": "number"
-		},
-		{
-			"path": "dirtyWater.status",
-			"valueType": "enum",
-			"enumValues": [
-				"ok",
-				"low",
-				"full"
-			]
-		},
-		{
-			"path": "detergent.level",
-			"valueType": "number"
-		},
-		{
-			"path": "detergent.status",
-			"valueType": "enum",
-			"enumValues": [
-				"ok",
-				"low",
-				"full"
-			]
-		},
-		{
-			"path": "dustBin.level",
-			"valueType": "number"
-		},
-		{
-			"path": "dustBin.status",
-			"valueType": "enum",
-			"enumValues": [
-				"ok",
-				"low",
-				"full"
-			]
-		},
 		{
 			"path": "progressPercent",
 			"valueType": "number"

package/dist/capabilities/addon-settings.cap.d.ts

@@ -20,6 +20,7 @@ declare const ConfigSectionWithValuesSchema: z.ZodObject<{
     columns: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>;
     tab: z.ZodOptional<z.ZodString>;
     location: z.ZodOptional<z.ZodEnum<{
+        hero: "hero";
         settings: "settings";
         "top-tab": "top-tab";
     }>>;
@@ -47,6 +48,7 @@ declare const SettingsSchemaWithValuesSchema: z.ZodObject<{
         columns: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>;
         tab: z.ZodOptional<z.ZodString>;
         location: z.ZodOptional<z.ZodEnum<{
+            hero: "hero";
             settings: "settings";
             "top-tab": "top-tab";
         }>>;
@@ -118,6 +120,7 @@ export declare const addonSettingsCapability: {
                 columns: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>;
                 tab: z.ZodOptional<z.ZodString>;
                 location: z.ZodOptional<z.ZodEnum<{
+                    hero: "hero";
                     settings: "settings";
                     "top-tab": "top-tab";
                 }>>;
@@ -156,6 +159,7 @@ export declare const addonSettingsCapability: {
                 columns: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>;
                 tab: z.ZodOptional<z.ZodString>;
                 location: z.ZodOptional<z.ZodEnum<{
+                    hero: "hero";
                     settings: "settings";
                     "top-tab": "top-tab";
                 }>>;
@@ -188,6 +192,7 @@ export declare const addonSettingsCapability: {
                 columns: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>;
                 tab: z.ZodOptional<z.ZodString>;
                 location: z.ZodOptional<z.ZodEnum<{
+                    hero: "hero";
                     settings: "settings";
                     "top-tab": "top-tab";
                 }>>;

package/dist/capabilities/capability-definition.d.ts

@@ -334,6 +334,14 @@ export interface DeviceConfigWidgetUi {
     /** Tab id; with `topTab:true` the section is hoisted to its own device tab. */
     readonly tab: string;
     readonly topTab?: boolean;
+    /**
+     * Where the section lands on the device page. `'tab'` (default) follows
+     * `tab` / `topTab`; `'hero'` shows it ONCE directly under the device's
+     * hero card, in the same block, on every tab of the device page, for every
+     * device bound to the cap (D915). A hero section never also appears in a
+     * tab.
+     */
+    readonly placement?: 'tab' | 'hero';
     /** Section title + field label shown in the UI. */
     readonly label: string;
     /** Section ordering within the tab. Default 0. */
@@ -447,14 +455,45 @@ export interface CapabilityHistoryField {
      */
     readonly excludeDeviceTypes?: readonly DeviceType[];
 }
+/**
+ * Series recorded from a KEYED ARRAY of `runtimeState` (D917): one series per
+ * (item field, item key). The item key is the series SCOPE — the same
+ * dimension a producer's per-zone or per-location series uses — so the store,
+ * rollups, retention and queries need nothing new. The series key is
+ * `cap:<capName>.<path>[].<field>` ({@link historyItemFieldPath}).
+ *
+ * An item that appears later gets its series on its first reading; an item
+ * that disappears keeps its history until retention ages it out. The display
+ * name of an item's series is read at query time from the item's `label`
+ * field in the device's current slice (the key when the item is gone).
+ */
+export interface CapabilityHistoryItems {
+    /** Path of the array: a top-level or fixed-object (`a.b`) `runtimeState` path. */
+    readonly path: string;
+    /** Field of an item that identifies it across readings: a non-empty string. */
+    readonly key: string;
+    /** Field of an item that names it for display (a string). */
+    readonly label?: string;
+    /**
+     * ITEM-relative paths (top-level or fixed-object `a.b`) to a series spec.
+     * `unitFrom` and `skipWhenSet` are item-relative as well.
+     */
+    readonly fields: Readonly<Record<string, CapabilityHistoryField>>;
+}
+/** The catalog field path of an item field: `<itemsPath>[].<field>` (`items[].level`). */
+export declare function historyItemFieldPath(itemsPath: string, field: string): string;
 /**
  * The `history` block of a cap with `runtimeState`: `'none'` is an explicit
  * answer; otherwise `fields` maps TOP-LEVEL or fixed-object (`a.b`) paths of
  * `runtimeState` to a series. A path never goes into an array or a record keyed
- * by runtime ids. Enforced by `scripts/check-cap-history-declared.ts`.
+ * by runtime ids — a keyed array is declared through `items`
+ * ({@link CapabilityHistoryItems}), whose item key becomes the series scope.
+ * `fields` may be empty only when `items` is declared. Enforced by
+ * `scripts/check-cap-history-declared.ts`.
  */
 export type CapabilityHistory = 'none' | {
     readonly fields: Readonly<Record<string, CapabilityHistoryField>>;
+    readonly items?: CapabilityHistoryItems;
 };
 /** Capture floor (ms) applied to `gauge` / `counter` series when a field states none. */
 export declare const HISTORY_DEFAULT_MIN_INTERVAL_MS = 10000;
@@ -851,6 +890,7 @@ export declare const DEVICE_SETTINGS_CONTRIBUTION_METHODS: {
                 columns: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>;
                 tab: z.ZodOptional<z.ZodString>;
                 location: z.ZodOptional<z.ZodEnum<{
+                    hero: "hero";
                     settings: "settings";
                     "top-tab": "top-tab";
                 }>>;
@@ -884,6 +924,7 @@ export declare const DEVICE_SETTINGS_CONTRIBUTION_METHODS: {
                 columns: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>;
                 tab: z.ZodOptional<z.ZodString>;
                 location: z.ZodOptional<z.ZodEnum<{
+                    hero: "hero";
                     settings: "settings";
                     "top-tab": "top-tab";
                 }>>;

package/dist/capabilities/consumables.cap.d.ts

@@ -2,17 +2,87 @@ import { z } from 'zod';
 import { type InferProvider } from './capability-definition.js';
 import { DeviceType } from '../device/device-type.js';
 /**
- * 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`.
+ */
+export declare const ConsumableKindSchema: z.ZodEnum<{
+    supply: "supply";
+    waste: "waste";
+    wear: "wear";
+}>;
+export type ConsumableKind = z.infer<typeof ConsumableKindSchema>;
+/**
+ * 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}).
+ */
+export declare const ConsumableFormSchema: z.ZodEnum<{
+    bin: "bin";
+    part: "part";
+    product: "product";
+    tank: "tank";
+}>;
+export type ConsumableForm = z.infer<typeof ConsumableFormSchema>;
+/** The provider's own discrete verdict on an item. */
+export declare const ConsumableStatusSchema: z.ZodEnum<{
+    empty: "empty";
+    full: "full";
+    low: "low";
+    ok: "ok";
+    replace: "replace";
+}>;
+export type ConsumableStatus = z.infer<typeof ConsumableStatusSchema>;
+/**
+ * The level vocabulary every client draws a consumable in (badge tone, bar
+ * colour): derived from an item by its kind, level and status. `null` beside
+ * it means unknown (D393).
+ */
+export declare const ConsumableLevelSchema: z.ZodEnum<{
+    empty: "empty";
+    full: "full";
+    low: "low";
+    ok: "ok";
+}>;
+export type ConsumableLevel = z.infer<typeof ConsumableLevelSchema>;
+/** The kind of an item, with the documented default for an absent one. */
+export declare function consumableKindOf(item: {
+    readonly kind?: ConsumableKind;
+}): ConsumableKind;
+/** The form of an item: its own when the provider names one, else its kind's default. */
+export declare function consumableFormOf(item: {
+    readonly kind?: ConsumableKind;
+    readonly form?: ConsumableForm;
+}): ConsumableForm;
 /** Units a remaining-life counter is reported in. Closed: the panel renders
  *  each. */
 export declare const ConsumableRemainingUnitSchema: z.ZodEnum<{
@@ -33,17 +103,32 @@ export declare const ConsumableRemainingSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type ConsumableRemaining = z.infer<typeof ConsumableRemainingSchema>;
 /** 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. */
 export declare const ConsumableItemSchema: z.ZodObject<{
     key: z.ZodString;
     label: z.ZodString;
     level: z.ZodNullable<z.ZodNumber>;
     status: z.ZodNullable<z.ZodEnum<{
+        empty: "empty";
+        full: "full";
+        low: "low";
         ok: "ok";
         replace: "replace";
     }>>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        supply: "supply";
+        waste: "waste";
+        wear: "wear";
+    }>>;
+    form: z.ZodOptional<z.ZodEnum<{
+        bin: "bin";
+        part: "part";
+        product: "product";
+        tank: "tank";
+    }>>;
     lastResetAt: z.ZodNullable<z.ZodNumber>;
     resettable: z.ZodBoolean;
     remaining: z.ZodOptional<z.ZodObject<{
@@ -61,9 +146,23 @@ export declare const ConsumablesStatusSchema: z.ZodObject<{
         label: z.ZodString;
         level: z.ZodNullable<z.ZodNumber>;
         status: z.ZodNullable<z.ZodEnum<{
+            empty: "empty";
+            full: "full";
+            low: "low";
             ok: "ok";
             replace: "replace";
         }>>;
+        kind: z.ZodOptional<z.ZodEnum<{
+            supply: "supply";
+            waste: "waste";
+            wear: "wear";
+        }>>;
+        form: z.ZodOptional<z.ZodEnum<{
+            bin: "bin";
+            part: "part";
+            product: "product";
+            tank: "tank";
+        }>>;
         lastResetAt: z.ZodNullable<z.ZodNumber>;
         resettable: z.ZodBoolean;
         remaining: z.ZodOptional<z.ZodObject<{
@@ -90,7 +189,7 @@ export declare const consumablesCapability: {
             readonly kind: 'widget';
             readonly widgetId: 'host/consumables-panel';
             readonly tab: 'consumables';
-            readonly topTab: true;
+            readonly placement: 'hero';
             readonly label: 'Consumables';
             readonly order: 5;
         };
@@ -122,9 +221,23 @@ export declare const consumablesCapability: {
                 label: z.ZodString;
                 level: z.ZodNullable<z.ZodNumber>;
                 status: z.ZodNullable<z.ZodEnum<{
+                    empty: "empty";
+                    full: "full";
+                    low: "low";
                     ok: "ok";
                     replace: "replace";
                 }>>;
+                kind: z.ZodOptional<z.ZodEnum<{
+                    supply: "supply";
+                    waste: "waste";
+                    wear: "wear";
+                }>>;
+                form: z.ZodOptional<z.ZodEnum<{
+                    bin: "bin";
+                    part: "part";
+                    product: "product";
+                    tank: "tank";
+                }>>;
                 lastResetAt: z.ZodNullable<z.ZodNumber>;
                 resettable: z.ZodBoolean;
                 remaining: z.ZodOptional<z.ZodObject<{
@@ -144,7 +257,9 @@ export declare const consumablesCapability: {
                 key: string;
                 label: string;
                 level: number | null;
-                status: "ok" | "replace" | null;
+                status: "empty" | "full" | "low" | "ok" | "replace" | null;
+                kind?: "supply" | "waste" | "wear" | undefined;
+                form?: "bin" | "part" | "product" | "tank" | undefined;
                 lastResetAt: number | null;
                 resettable: boolean;
                 remaining?: {
@@ -163,9 +278,23 @@ export declare const consumablesCapability: {
                 label: z.ZodString;
                 level: z.ZodNullable<z.ZodNumber>;
                 status: z.ZodNullable<z.ZodEnum<{
+                    empty: "empty";
+                    full: "full";
+                    low: "low";
                     ok: "ok";
                     replace: "replace";
                 }>>;
+                kind: z.ZodOptional<z.ZodEnum<{
+                    supply: "supply";
+                    waste: "waste";
+                    wear: "wear";
+                }>>;
+                form: z.ZodOptional<z.ZodEnum<{
+                    bin: "bin";
+                    part: "part";
+                    product: "product";
+                    tank: "tank";
+                }>>;
                 lastResetAt: z.ZodNullable<z.ZodNumber>;
                 resettable: z.ZodBoolean;
                 remaining: z.ZodOptional<z.ZodObject<{
@@ -181,7 +310,9 @@ export declare const consumablesCapability: {
                 key: string;
                 label: string;
                 level: number | null;
-                status: "ok" | "replace" | null;
+                status: "empty" | "full" | "low" | "ok" | "replace" | null;
+                kind?: "supply" | "waste" | "wear" | undefined;
+                form?: "bin" | "part" | "product" | "tank" | undefined;
                 lastResetAt: number | null;
                 resettable: boolean;
                 remaining?: {
@@ -197,9 +328,23 @@ export declare const consumablesCapability: {
             label: z.ZodString;
             level: z.ZodNullable<z.ZodNumber>;
             status: z.ZodNullable<z.ZodEnum<{
+                empty: "empty";
+                full: "full";
+                low: "low";
                 ok: "ok";
                 replace: "replace";
             }>>;
+            kind: z.ZodOptional<z.ZodEnum<{
+                supply: "supply";
+                waste: "waste";
+                wear: "wear";
+            }>>;
+            form: z.ZodOptional<z.ZodEnum<{
+                bin: "bin";
+                part: "part";
+                product: "product";
+                tank: "tank";
+            }>>;
             lastResetAt: z.ZodNullable<z.ZodNumber>;
             resettable: z.ZodBoolean;
             remaining: z.ZodOptional<z.ZodObject<{
@@ -228,9 +373,37 @@ export declare const consumablesCapability: {
      */
     readonly 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.
      */
-    readonly history: 'none';
+    readonly history: {
+        readonly fields: {};
+        readonly items: {
+            readonly path: 'items';
+            readonly key: 'key';
+            readonly label: 'label';
+            readonly fields: {
+                readonly level: {
+                    readonly kind: 'gauge';
+                    readonly unit: '%';
+                    readonly deadband: 2;
+                    readonly displayName: 'Level';
+                };
+                readonly status: {
+                    readonly kind: 'enum';
+                    readonly displayName: 'Status';
+                };
+                readonly 'remaining.value': {
+                    readonly kind: 'gauge';
+                    readonly unitFrom: 'remaining.unit';
+                    readonly deadband: 1;
+                    readonly displayName: 'Remaining';
+                };
+            };
+        };
+    };
     /** Clocks, not content: a re-read that changed no item costs no commit. */
     readonly volatileStateFields: readonly ["lastChangedAt", "lastFetchedAt"];
 };

package/dist/capabilities/core-blocks.cap.d.ts

@@ -2509,6 +2509,7 @@ export declare const coreBlocksCapability: {
                 columns: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>;
                 tab: z.ZodOptional<z.ZodString>;
                 location: z.ZodOptional<z.ZodEnum<{
+                    hero: "hero";
                     settings: "settings";
                     "top-tab": "top-tab";
                 }>>;