@camstack/types 1.2.387 → 1.2.388

package/dist/addon.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-6sOPE0EV.js");
+const require_sleep = require("./sleep-DKtoyk6X.js");
 const require_event_category = require("./event-category-eSqkye-K.js");
 const require_err_msg = require("./err-msg-BhVbr0NX.js");
 //#region src/generated/cap-input-defaults.ts
@@ -16,7 +16,7 @@ const require_err_msg = require("./err-msg-BhVbr0NX.js");
 * Plain data, zero Zod: a forked runner must not import the schema barrel
 * (~144MB RSS per runner — D28).
 *
-* Coverage: 29 caps, 71 methods with defaults.
+* Coverage: 29 caps, 72 methods with defaults.
 */
 var CAP_INPUT_DEFAULTS = Object.freeze({
 	"addons": { "getLogs": { "limit": 100 } },
@@ -45,6 +45,10 @@ var CAP_INPUT_DEFAULTS = Object.freeze({
 			"resolution": "auto",
 			"maxPoints": 1e3
 		},
+		"queryMany": {
+			"resolution": "auto",
+			"maxPoints": 1e3
+		},
 		"queryNode": {
 			"resolution": "auto",
 			"maxPoints": 1e3
@@ -103,7 +107,7 @@ var CAP_INPUT_DEFAULTS = Object.freeze({
 		"createRule": { "rule": { "__nested__": {
 			"enabled": true,
 			"conditions": {},
-			"media": { "attach": "best" },
+			"media": {},
 			"throttle": {
 				"cooldownSec": 60,
 				"scope": "rule-device"
@@ -114,7 +118,7 @@ var CAP_INPUT_DEFAULTS = Object.freeze({
 		"previewStateSummary": { "rule": { "__nested__": {
 			"enabled": true,
 			"conditions": {},
-			"media": { "attach": "best" },
+			"media": {},
 			"throttle": {
 				"cooldownSec": 60,
 				"scope": "rule-device"
@@ -125,7 +129,7 @@ var CAP_INPUT_DEFAULTS = Object.freeze({
 			"rule": { "__nested__": {
 				"enabled": true,
 				"conditions": {},
-				"media": { "attach": "best" },
+				"media": {},
 				"throttle": {
 					"cooldownSec": 60,
 					"scope": "rule-device"
@@ -358,7 +362,7 @@ function materialise(defaults) {
 * barrel (`ALL_CAPABILITY_DEFINITIONS`), which would cost ~144MB RSS per
 * forked runner. See docs/decisions/adr-0028.md.
 *
-* Coverage: 27 collection caps, 45 array methods.
+* Coverage: 26 collection caps, 44 array methods.
 */
 var COLLECTION_ARRAY_METHODS = Object.freeze({
 	"addon-pages-source": ["listPages"],
@@ -384,7 +388,6 @@ var COLLECTION_ARRAY_METHODS = Object.freeze({
 	],
 	"load-contribution": ["list"],
 	"log-channels": ["list"],
-	"log-destination": ["query"],
 	"login-method": ["getLoginMethods"],
 	"mqtt-broker": ["listBrokers"],
 	"network-access": ["listEndpoints"],
@@ -419,14 +422,21 @@ function isCollectionArrayMethodName(capName, method) {
 * Per capability, the methods declared `optionalMethod` — the ones whose
 * ABSENCE on a provider is a fact about that provider, not a bug.
 *
-* Coverage: 1 caps, 4 methods.
+* Coverage: 2 caps, 7 methods.
 */
-var PROVIDER_OPTIONAL_METHODS = Object.freeze({ "videoclips": [
-	"dialClipStream",
-	"getPlaybackOptions",
-	"offerClipBytes",
-	"readClipBytes"
-] });
+var PROVIDER_OPTIONAL_METHODS = Object.freeze({
+	"log-destination": [
+		"cancelRead",
+		"describeRead",
+		"read"
+	],
+	"videoclips": [
+		"dialClipStream",
+		"getPlaybackOptions",
+		"offerClipBytes",
+		"readClipBytes"
+	]
+});
 /**
 * True when `method` on cap `capName` is declared `optionalMethod`.
 *

package/dist/addon.mjs

@@ -1,4 +1,4 @@
-import { $n as PEER_BYTES_CHUNK_BYTES, $t as REMOVE_LEAF, A as HF_REPO, An as RECORD_BATCH_MAX_BYTES, Ar as emitReadiness, B as describeCustomActions, Bn as RECORD_SECRET_COLLECTION_PREFIX, Br as SECRET_CLEAR, Bt as settingsBrokersAdoptsFrom, C as addonSliceHandleApi, Cn as RecordsError, Cr as globalSecretScope, Dn as asRecordsError, En as UnknownRecordKindError, Er as parseSecretRef, F as DEVICE_CHILDREN_BATCH_MAX, Fn as RECORD_ID_MAX_LENGTH, Ft as SETTINGS_ARRAY_ADOPTS_PREFIX, Gn as createSecretsAccess, Gr as isSecretMarkerLike, Gt as RecordFieldPathSchema, H as adminUiCapability, Hn as RECORD_SWEEP_INTERVAL_MS, Hr as isSecretClear, Ht as entryBody, I as CALLER_STAMPED_CAPABILITIES, In as RECORD_MAX_DATA_BYTES, It as parseSettingsArrayAdoptsFrom, Jn as forgetKnownSecret, Jt as RecordKindNameSchema, Kn as MIN_SCRUBBED_LENGTH, Kr as makeSecretMarker, Kt as RecordIndexSchema, L as withoutCallerStamp, Ln as RECORD_MAX_INDEXES, Lt as settingsArrayAdoptsFrom, Mn as RECORD_DATABASES, N as deviceOpsCapability, Nn as RECORD_DEFAULT_MAX_DATA_BYTES, On as recordsErrorFromMessage, P as viewerUiCapability, Pn as RECORD_DELETE_BATCH, Pt as makeInMemoryRecords, Qn as shortSecretRefHash, Qt as defineRecordKinds, Rn as RECORD_MAX_INDEX_FIELDS, Rt as SETTINGS_BROKERS_ADOPTS_PREFIX, Sn as RecordUniqueViolationError, Sr as formatSecretScope, Tn as UnindexedFilterError, Tr as normalizeSecretOwner, Un as resolveSecretViewsIn, Ur as isSecretFieldView, Ut as createRecordsAccess, Vn as RECORD_SETTINGS_MAX_ROWS, Vr as classifySecretWrite, Vt as defineEntryKind, Wn as REVALIDATE_AFTER_MS, Wr as isSecretMarker, Wt as EntryDescriptorSchema, X as expandCapMethods, Xn as registerKnownSecret, Xt as assertValidDeclaration, Yn as knownSecretCount, Yt as RecordRetentionSchema, Zn as scrubKnownSecrets, Zt as declarationsOf, _ as readErrorI18n, _n as PlaintextSecretError, an as recordSecretRef, b as isDeviceScopedCap, bn as RecordSecretUnavailableError, br as arrayItemFieldPath, c as asString, cn as collectZodSecretPaths, ct as ReadinessTimeoutError, d as parseJsonUnknown, dn as BatchTooLargeError, dt as scopeKey, en as collectSecretLeaves, er as PEER_BYTES_MAX_OUTSTANDING, f as hfModelUrl, fn as DeclarationRefusedError, g as ErrorI18nPayloadSchema, gn as NoCallerError, hn as InvalidRecordError, in as recordSecretCollection, ir as DATAPLANE_SECRET_HEADER, it as readNodePin, jn as RECORD_CLASSES, kn as RECORD_BATCH_MAX, kr as createEvent, ln as isZodSecret, lr as normalizeAddonInitResult, mn as ForeignSecretMarkerError, nn as parseSecretPath, nr as PEER_BYTES_TICKET_TTL_MS, o as asJsonObject, on as secretArrayPrefixes, or as DisposerChain, ot as MODEL_FORMATS, p as BOOT_RECOVERY_BACKOFF_MS, pn as FilterRequiredError, qn as clearKnownSecrets, qr as toSecretFieldView, qt as RecordKindDeclarationSchema, r as maskUrlCredentials, rn as recordArrayItemPath, rt as nodePin, sr as BaseAddon, st as ReadinessRegistry, t as sleep, tn as mapSecretLeaves, tr as PEER_BYTES_STALL_MS, un as AdoptionPendingError, vn as RECORDS_ERROR_CODES, w as createEventBusSliceSource, wn as RevConflictError, wr as isSecretRef, x as createDeviceProxy, xn as RecordTooLargeError, xr as buildSecretRef, y as DEVICE_SCOPED_CAPS, yn as RecordNotFoundError, yr as SECRET_REF_SCHEME, zn as RECORD_QUERY_MAX, zt as parseSettingsBrokersAdoptsFrom } from "./sleep-yKL5gfrH.mjs";
+import { $n as PEER_BYTES_CHUNK_BYTES, $t as REMOVE_LEAF, A as HF_REPO, An as RECORD_BATCH_MAX_BYTES, Ar as emitReadiness, B as describeCustomActions, Bn as RECORD_SECRET_COLLECTION_PREFIX, Br as SECRET_CLEAR, Bt as settingsBrokersAdoptsFrom, C as addonSliceHandleApi, Cn as RecordsError, Cr as globalSecretScope, Dn as asRecordsError, En as UnknownRecordKindError, Er as parseSecretRef, F as DEVICE_CHILDREN_BATCH_MAX, Fn as RECORD_ID_MAX_LENGTH, Ft as SETTINGS_ARRAY_ADOPTS_PREFIX, Gn as createSecretsAccess, Gr as isSecretMarkerLike, Gt as RecordFieldPathSchema, H as adminUiCapability, Hn as RECORD_SWEEP_INTERVAL_MS, Hr as isSecretClear, Ht as entryBody, I as CALLER_STAMPED_CAPABILITIES, In as RECORD_MAX_DATA_BYTES, It as parseSettingsArrayAdoptsFrom, Jn as forgetKnownSecret, Jt as RecordKindNameSchema, Kn as MIN_SCRUBBED_LENGTH, Kr as makeSecretMarker, Kt as RecordIndexSchema, L as withoutCallerStamp, Ln as RECORD_MAX_INDEXES, Lt as settingsArrayAdoptsFrom, Mn as RECORD_DATABASES, N as deviceOpsCapability, Nn as RECORD_DEFAULT_MAX_DATA_BYTES, On as recordsErrorFromMessage, P as viewerUiCapability, Pn as RECORD_DELETE_BATCH, Pt as makeInMemoryRecords, Qn as shortSecretRefHash, Qt as defineRecordKinds, Rn as RECORD_MAX_INDEX_FIELDS, Rt as SETTINGS_BROKERS_ADOPTS_PREFIX, Sn as RecordUniqueViolationError, Sr as formatSecretScope, Tn as UnindexedFilterError, Tr as normalizeSecretOwner, Un as resolveSecretViewsIn, Ur as isSecretFieldView, Ut as createRecordsAccess, Vn as RECORD_SETTINGS_MAX_ROWS, Vr as classifySecretWrite, Vt as defineEntryKind, Wn as REVALIDATE_AFTER_MS, Wr as isSecretMarker, Wt as EntryDescriptorSchema, X as expandCapMethods, Xn as registerKnownSecret, Xt as assertValidDeclaration, Yn as knownSecretCount, Yt as RecordRetentionSchema, Zn as scrubKnownSecrets, Zt as declarationsOf, _ as readErrorI18n, _n as PlaintextSecretError, an as recordSecretRef, b as isDeviceScopedCap, bn as RecordSecretUnavailableError, br as arrayItemFieldPath, c as asString, cn as collectZodSecretPaths, ct as ReadinessTimeoutError, d as parseJsonUnknown, dn as BatchTooLargeError, dt as scopeKey, en as collectSecretLeaves, er as PEER_BYTES_MAX_OUTSTANDING, f as hfModelUrl, fn as DeclarationRefusedError, g as ErrorI18nPayloadSchema, gn as NoCallerError, hn as InvalidRecordError, in as recordSecretCollection, ir as DATAPLANE_SECRET_HEADER, it as readNodePin, jn as RECORD_CLASSES, kn as RECORD_BATCH_MAX, kr as createEvent, ln as isZodSecret, lr as normalizeAddonInitResult, mn as ForeignSecretMarkerError, nn as parseSecretPath, nr as PEER_BYTES_TICKET_TTL_MS, o as asJsonObject, on as secretArrayPrefixes, or as DisposerChain, ot as MODEL_FORMATS, p as BOOT_RECOVERY_BACKOFF_MS, pn as FilterRequiredError, qn as clearKnownSecrets, qr as toSecretFieldView, qt as RecordKindDeclarationSchema, r as maskUrlCredentials, rn as recordArrayItemPath, rt as nodePin, sr as BaseAddon, st as ReadinessRegistry, t as sleep, tn as mapSecretLeaves, tr as PEER_BYTES_STALL_MS, un as AdoptionPendingError, vn as RECORDS_ERROR_CODES, w as createEventBusSliceSource, wn as RevConflictError, wr as isSecretRef, x as createDeviceProxy, xn as RecordTooLargeError, xr as buildSecretRef, y as DEVICE_SCOPED_CAPS, yn as RecordNotFoundError, yr as SECRET_REF_SCHEME, zn as RECORD_QUERY_MAX, zt as parseSettingsBrokersAdoptsFrom } from "./sleep-BSuCCFjf.mjs";
 import { t as EventCategory } from "./event-category-DOl51-Ij.mjs";
 import { a as DeviceType, t as errMsg } from "./err-msg-BXKzRBwg.mjs";
 //#region src/generated/cap-input-defaults.ts
@@ -15,7 +15,7 @@ import { a as DeviceType, t as errMsg } from "./err-msg-BXKzRBwg.mjs";
 * Plain data, zero Zod: a forked runner must not import the schema barrel
 * (~144MB RSS per runner — D28).
 *
-* Coverage: 29 caps, 71 methods with defaults.
+* Coverage: 29 caps, 72 methods with defaults.
 */
 var CAP_INPUT_DEFAULTS = Object.freeze({
 	"addons": { "getLogs": { "limit": 100 } },
@@ -44,6 +44,10 @@ var CAP_INPUT_DEFAULTS = Object.freeze({
 			"resolution": "auto",
 			"maxPoints": 1e3
 		},
+		"queryMany": {
+			"resolution": "auto",
+			"maxPoints": 1e3
+		},
 		"queryNode": {
 			"resolution": "auto",
 			"maxPoints": 1e3
@@ -102,7 +106,7 @@ var CAP_INPUT_DEFAULTS = Object.freeze({
 		"createRule": { "rule": { "__nested__": {
 			"enabled": true,
 			"conditions": {},
-			"media": { "attach": "best" },
+			"media": {},
 			"throttle": {
 				"cooldownSec": 60,
 				"scope": "rule-device"
@@ -113,7 +117,7 @@ var CAP_INPUT_DEFAULTS = Object.freeze({
 		"previewStateSummary": { "rule": { "__nested__": {
 			"enabled": true,
 			"conditions": {},
-			"media": { "attach": "best" },
+			"media": {},
 			"throttle": {
 				"cooldownSec": 60,
 				"scope": "rule-device"
@@ -124,7 +128,7 @@ var CAP_INPUT_DEFAULTS = Object.freeze({
 			"rule": { "__nested__": {
 				"enabled": true,
 				"conditions": {},
-				"media": { "attach": "best" },
+				"media": {},
 				"throttle": {
 					"cooldownSec": 60,
 					"scope": "rule-device"
@@ -357,7 +361,7 @@ function materialise(defaults) {
 * barrel (`ALL_CAPABILITY_DEFINITIONS`), which would cost ~144MB RSS per
 * forked runner. See docs/decisions/adr-0028.md.
 *
-* Coverage: 27 collection caps, 45 array methods.
+* Coverage: 26 collection caps, 44 array methods.
 */
 var COLLECTION_ARRAY_METHODS = Object.freeze({
 	"addon-pages-source": ["listPages"],
@@ -383,7 +387,6 @@ var COLLECTION_ARRAY_METHODS = Object.freeze({
 	],
 	"load-contribution": ["list"],
 	"log-channels": ["list"],
-	"log-destination": ["query"],
 	"login-method": ["getLoginMethods"],
 	"mqtt-broker": ["listBrokers"],
 	"network-access": ["listEndpoints"],
@@ -418,14 +421,21 @@ function isCollectionArrayMethodName(capName, method) {
 * Per capability, the methods declared `optionalMethod` — the ones whose
 * ABSENCE on a provider is a fact about that provider, not a bug.
 *
-* Coverage: 1 caps, 4 methods.
+* Coverage: 2 caps, 7 methods.
 */
-var PROVIDER_OPTIONAL_METHODS = Object.freeze({ "videoclips": [
-	"dialClipStream",
-	"getPlaybackOptions",
-	"offerClipBytes",
-	"readClipBytes"
-] });
+var PROVIDER_OPTIONAL_METHODS = Object.freeze({
+	"log-destination": [
+		"cancelRead",
+		"describeRead",
+		"read"
+	],
+	"videoclips": [
+		"dialClipStream",
+		"getPlaybackOptions",
+		"offerClipBytes",
+		"readClipBytes"
+	]
+});
 /**
 * True when `method` on cap `capName` is declared `optionalMethod`.
 *

package/dist/capabilities/alarm-panel.cap.d.ts

@@ -178,9 +178,17 @@ export declare const alarmPanelCapability: {
      */
     readonly durability: 'restored';
     /**
-     * History (D850): none — enum state; arm/disarm history belongs in the events ledger.
+     * History (D850): the panel's lifecycle state as an `enum` series —
+     * change-only, no floor, so an `arming -> pending -> triggered` sequence of a
+     * few seconds keeps every step. Who armed it stays in the events ledger.
      */
-    readonly history: 'none';
+    readonly history: {
+        readonly fields: {
+            readonly state: {
+                readonly kind: 'enum';
+            };
+        };
+    };
     /** Clock fields: written, but excluded from the compare that decides
      *  whether persisting is worth a SQLite commit. */
     readonly volatileStateFields: readonly ["lastChangedAt"];

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

@@ -384,7 +384,7 @@ export declare const DEFAULT_RUNTIME_STATE_DURABILITY: RuntimeStateDurability;
  * through {@link HISTORY_UNIT_LABELS}. A series whose unit is a per-device fact
  * names a sibling field with {@link CapabilityHistoryField.unitFrom} instead.
  */
-export type HistoryUnit = '%' | 'dBFS' | 'dBm' | '°C' | 'W' | 'kWh' | 'V' | 'A' | 'VA' | 'lx' | 'ppm' | 'ppb' | 'ug/m3' | 'hPa' | 'count' | 'ratio' | 'ms' | 's' | 'days' | 'bytes';
+export type HistoryUnit = '%' | 'dBFS' | 'dBm' | '°C' | 'W' | 'kWh' | 'V' | 'A' | 'VA' | 'lx' | 'ppm' | 'ppb' | 'ug/m3' | 'hPa' | 'count' | 'ratio' | 'ms' | 's' | 'days' | 'bytes' | 'kbps' | 'fps';
 /** Display label per {@link HistoryUnit} (only `'ug/m3'` differs from its id). */
 export declare const HISTORY_UNIT_LABELS: Readonly<Record<HistoryUnit, string>>;
 /** One `runtimeState` field recorded as a history series. */
@@ -394,8 +394,26 @@ export interface CapabilityHistoryField {
      * meter only (`kwhTotal`); a drop is a reset, never a negative reading. A
      * counter that restarts with the addon (`pressCountSinceStart`) is not one.
      * `boolean` — stored 0/1; a rollup gives the fraction of time true.
+     * `enum` — a STATE (a `z.enum`, or a `z.string` whose values are learned):
+     * stored as the ordinal of its value in the series' append-only value list,
+     * change-only; a rollup keeps the time spent in each state.
      */
-    readonly kind: 'gauge' | 'counter' | 'boolean';
+    readonly kind: 'gauge' | 'counter' | 'boolean' | 'enum';
+    /**
+     * `enum` over a `z.enum` field: its values, in declaration order. WRITTEN BY
+     * CODEGEN from the field's schema (`scripts/generate-history-catalog.ts`) —
+     * never by hand, so the list cannot drift from the schema. Absent for a
+     * `z.string` enum field, whose values are learned as they are first seen.
+     * Ordinals are append-only in the store: reordering the `z.enum` later never
+     * changes what a stored ordinal means.
+     */
+    readonly values?: readonly string[];
+    /**
+     * Path of a SIBLING field: while it is set (not `undefined`, not `null`), the
+     * slice is not a reading of this field and nothing is captured. An
+     * `enum-sensor` with a `format` carries a timestamp, not a state.
+     */
+    readonly skipWhenSet?: string;
     /** Fixed unit of the series. Mutually exclusive with {@link unitFrom}. */
     readonly unit?: HistoryUnit;
     /**
@@ -416,7 +434,7 @@ export interface CapabilityHistoryField {
     readonly deadbandPct?: number;
     /**
      * At most one raw point per this many ms per series. Absent means the capture
-     * floor of the kind: 10 000 for `gauge` and `counter`, none for `boolean`
+     * floor of the kind: 10 000 for `gauge` and `counter`, none for `boolean` and `enum`
      * (change-only). Set it ABOVE the floor to be sparser; the floor is not
      * lowered by a smaller value except `0`, which a field may state to opt out
      * of the floor (a flapping state that must not lose an edge).

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

@@ -40,9 +40,17 @@ export declare const connectivityCapability: {
      */
     readonly durability: 'restored';
     /**
-     * History (D850): none — duplicates device-status.online (one authority for availability).
+     * History (D850): `connected` as a boolean series — change-only, no floor. It
+     * is the upstream entity's own link (a HA connectivity sensor), not the
+     * device's reachability, which stays `device-status.online`.
      */
-    readonly history: 'none';
+    readonly history: {
+        readonly fields: {
+            readonly connected: {
+                readonly kind: 'boolean';
+            };
+        };
+    };
     /** Clock fields: written, but excluded from the compare that decides
      *  whether persisting is worth a SQLite commit. */
     readonly volatileStateFields: readonly ["lastChangedAt"];

package/dist/capabilities/device-history.cap.d.ts

@@ -25,12 +25,32 @@ export declare const DeviceHistorySubjectSchema: z.ZodDiscriminatedUnion<[z.ZodO
     nodeId: z.ZodString;
 }, z.core.$strip>], "kind">;
 export type DeviceHistorySubject = z.infer<typeof DeviceHistorySubjectSchema>;
+/**
+ * `enum` stores a STATE as the ordinal of its value in the series' value list
+ * (`DeviceHistorySeriesInfo.values`, append-only, so an ordinal never changes
+ * meaning); a rollup keeps the time spent in each state (`states`).
+ */
 export declare const DeviceHistoryKindSchema: z.ZodEnum<{
     boolean: "boolean";
     counter: "counter";
+    enum: "enum";
     gauge: "gauge";
 }>;
 export type DeviceHistoryKind = z.infer<typeof DeviceHistoryKindSchema>;
+/** What a PRODUCER may declare. `enum` is cap-only: its value list is the cap field's. */
+export declare const DeviceHistoryProducerKindSchema: z.ZodEnum<{
+    boolean: "boolean";
+    counter: "counter";
+    gauge: "gauge";
+}>;
+export type DeviceHistoryProducerKind = z.infer<typeof DeviceHistoryProducerKindSchema>;
+/**
+ * A key computed at READ time from stored series of the same device, never
+ * stored itself. Energy (kWh per bucket) comes from the power meter's
+ * `kwhTotal` counter when the device has one, else from integrating its
+ * `watts` gauge over time.
+ */
+export declare const DEVICE_HISTORY_ENERGY_KEY = "derived:energy.kwh";
 export declare const DeviceHistoryResolutionSchema: z.ZodEnum<{
     "1d": "1d";
     "1h": "1h";
@@ -72,6 +92,7 @@ declare const SeriesInfoSchema: z.ZodObject<{
     kind: z.ZodEnum<{
         boolean: "boolean";
         counter: "counter";
+        enum: "enum";
         gauge: "gauge";
     }>;
     unit: z.ZodNullable<z.ZodString>;
@@ -79,7 +100,9 @@ declare const SeriesInfoSchema: z.ZodObject<{
     source: z.ZodEnum<{
         addon: "addon";
         cap: "cap";
+        derived: "derived";
     }>;
+    values: z.ZodNullable<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
     firstTs: z.ZodNumber;
     lastTs: z.ZodNumber;
 }, z.core.$strip>;
@@ -92,8 +115,92 @@ declare const QueryPointSchema: z.ZodObject<{
     min: z.ZodNumber;
     max: z.ZodNumber;
     last: z.ZodNullable<z.ZodNumber>;
+    delta: z.ZodNullable<z.ZodNumber>;
+    state: z.ZodNullable<z.ZodString>;
+    states: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodNumber>>;
 }, z.core.$strip>;
 export type DeviceHistoryQueryPoint = z.infer<typeof QueryPointSchema>;
+declare const QueryResultSchema: z.ZodObject<{
+    resolution: z.ZodEnum<{
+        "1d": "1d";
+        "1h": "1h";
+        "5m": "5m";
+        raw: "raw";
+    }>;
+    series: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        scope: z.ZodString;
+        before: z.ZodNullable<z.ZodObject<{
+            t: z.ZodNumber;
+            value: z.ZodNullable<z.ZodNumber>;
+            state: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        points: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            t: z.ZodNumber;
+            samples: z.ZodNumber;
+            mean: z.ZodNullable<z.ZodNumber>;
+            twMean: z.ZodNullable<z.ZodNumber>;
+            min: z.ZodNumber;
+            max: z.ZodNumber;
+            last: z.ZodNullable<z.ZodNumber>;
+            delta: z.ZodNullable<z.ZodNumber>;
+            state: z.ZodNullable<z.ZodString>;
+            states: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        }, z.core.$strip>>>;
+        derivedFrom: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>>;
+    truncated: z.ZodBoolean;
+}, z.core.$strip>;
+export type DeviceHistoryQueryResult = z.infer<typeof QueryResultSchema>;
+/** Items one `queryMany` may carry: a dashboard's worth, not a scan. */
+export declare const DEVICE_HISTORY_QUERY_MANY_MAX_ITEMS = 24;
+/** One read of a batch: a device's key or a node's key (exactly one subject). */
+declare const QueryManyItemSchema: z.ZodUnion<readonly [z.ZodObject<{
+    deviceId: z.ZodNumber;
+    key: z.ZodString;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    forNodeId: z.ZodString;
+    key: z.ZodString;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>;
+export type DeviceHistoryQueryManyItem = z.infer<typeof QueryManyItemSchema>;
+declare const QueryManyEntrySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    result: z.ZodObject<{
+        resolution: z.ZodEnum<{
+            "1d": "1d";
+            "1h": "1h";
+            "5m": "5m";
+            raw: "raw";
+        }>;
+        series: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            scope: z.ZodString;
+            before: z.ZodNullable<z.ZodObject<{
+                t: z.ZodNumber;
+                value: z.ZodNullable<z.ZodNumber>;
+                state: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+            points: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                t: z.ZodNumber;
+                samples: z.ZodNumber;
+                mean: z.ZodNullable<z.ZodNumber>;
+                twMean: z.ZodNullable<z.ZodNumber>;
+                min: z.ZodNumber;
+                max: z.ZodNumber;
+                last: z.ZodNullable<z.ZodNumber>;
+                delta: z.ZodNullable<z.ZodNumber>;
+                state: z.ZodNullable<z.ZodString>;
+                states: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+            }, z.core.$strip>>>;
+            derivedFrom: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>>;
+        truncated: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    ok: z.ZodLiteral<false>;
+    error: z.ZodString;
+}, z.core.$strip>], "ok">;
+export type DeviceHistoryQueryManyEntry = z.infer<typeof QueryManyEntrySchema>;
 /** Operator/diagnostic view: rows per tier, last runs, refusals and drops since boot. */
 export declare const DeviceHistoryStatusSchema: z.ZodObject<{
     startedAt: z.ZodNumber;
@@ -171,6 +278,7 @@ export declare const deviceHistoryCapability: {
             kind: z.ZodEnum<{
                 boolean: "boolean";
                 counter: "counter";
+                enum: "enum";
                 gauge: "gauge";
             }>;
             unit: z.ZodNullable<z.ZodString>;
@@ -178,18 +286,26 @@ export declare const deviceHistoryCapability: {
             source: z.ZodEnum<{
                 addon: "addon";
                 cap: "cap";
+                derived: "derived";
             }>;
+            values: z.ZodNullable<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
             firstTs: z.ZodNumber;
             lastTs: z.ZodNumber;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * A NODE's series. The subject is `forNodeId`, never `nodeId`: a top-level
+         * `nodeId` is the cap ROUTING key, and `nodeId: 'little-unraid'` sent the
+         * read to that agent, which hosts no device-history.
+         */
         readonly listNodeSeries: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
-            nodeId: z.ZodString;
+            forNodeId: z.ZodString;
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
             key: z.ZodString;
             scope: z.ZodString;
             kind: z.ZodEnum<{
                 boolean: "boolean";
                 counter: "counter";
+                enum: "enum";
                 gauge: "gauge";
             }>;
             unit: z.ZodNullable<z.ZodString>;
@@ -197,7 +313,9 @@ export declare const deviceHistoryCapability: {
             source: z.ZodEnum<{
                 addon: "addon";
                 cap: "cap";
+                derived: "derived";
             }>;
+            values: z.ZodNullable<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
             firstTs: z.ZodNumber;
             lastTs: z.ZodNumber;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
@@ -205,7 +323,9 @@ export declare const deviceHistoryCapability: {
          * One series (or every scope of it) at one resolution. `auto` picks the
          * finest tier whose retention covers `from` and whose point count fits
          * `maxPoints`; when even the coarsest tier does not fit, the newest
-         * `maxPoints` points are returned and `truncated` is true.
+         * `maxPoints` points are returned and `truncated` is true. A series fed by
+         * closed buckets has no raw rows, so `auto` never answers it from raw; nor
+         * {@link DEVICE_HISTORY_ENERGY_KEY}, which is computed from rollups.
          */
         readonly query: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             key: z.ZodString;
@@ -232,6 +352,7 @@ export declare const deviceHistoryCapability: {
                 before: z.ZodNullable<z.ZodObject<{
                     t: z.ZodNumber;
                     value: z.ZodNullable<z.ZodNumber>;
+                    state: z.ZodNullable<z.ZodString>;
                 }, z.core.$strip>>;
                 points: z.ZodReadonly<z.ZodArray<z.ZodObject<{
                     t: z.ZodNumber;
@@ -241,7 +362,11 @@ export declare const deviceHistoryCapability: {
                     min: z.ZodNumber;
                     max: z.ZodNumber;
                     last: z.ZodNullable<z.ZodNumber>;
+                    delta: z.ZodNullable<z.ZodNumber>;
+                    state: z.ZodNullable<z.ZodString>;
+                    states: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodNumber>>;
                 }, z.core.$strip>>>;
+                derivedFrom: z.ZodNullable<z.ZodString>;
             }, z.core.$strip>>>;
             truncated: z.ZodBoolean;
         }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
@@ -257,7 +382,7 @@ export declare const deviceHistoryCapability: {
                 raw: "raw";
             }>, z.ZodLiteral<"auto">]>>;
             maxPoints: z.ZodDefault<z.ZodNumber>;
-            nodeId: z.ZodString;
+            forNodeId: z.ZodString;
         }, z.core.$strip>, z.ZodObject<{
             resolution: z.ZodEnum<{
                 "1d": "1d";
@@ -270,6 +395,7 @@ export declare const deviceHistoryCapability: {
                 before: z.ZodNullable<z.ZodObject<{
                     t: z.ZodNumber;
                     value: z.ZodNullable<z.ZodNumber>;
+                    state: z.ZodNullable<z.ZodString>;
                 }, z.core.$strip>>;
                 points: z.ZodReadonly<z.ZodArray<z.ZodObject<{
                     t: z.ZodNumber;
@@ -279,10 +405,76 @@ export declare const deviceHistoryCapability: {
                     min: z.ZodNumber;
                     max: z.ZodNumber;
                     last: z.ZodNullable<z.ZodNumber>;
+                    delta: z.ZodNullable<z.ZodNumber>;
+                    state: z.ZodNullable<z.ZodString>;
+                    states: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodNumber>>;
                 }, z.core.$strip>>>;
+                derivedFrom: z.ZodNullable<z.ZodString>;
             }, z.core.$strip>>>;
             truncated: z.ZodBoolean;
         }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * Several reads over ONE window, answered in order (one entry per item).
+         * Admin-only: its subjects are nested in `items`, where the device scope
+         * gate cannot see them — a principal limited to one device uses `query`.
+         */
+        readonly queryMany: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            items: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                deviceId: z.ZodNumber;
+                key: z.ZodString;
+                scope: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                forNodeId: z.ZodString;
+                key: z.ZodString;
+                scope: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>]>>;
+            from: z.ZodNumber;
+            to: z.ZodNumber;
+            resolution: z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
+                "1d": "1d";
+                "1h": "1h";
+                "5m": "5m";
+                raw: "raw";
+            }>, z.ZodLiteral<"auto">]>>;
+            maxPoints: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            results: z.ZodReadonly<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                ok: z.ZodLiteral<true>;
+                result: z.ZodObject<{
+                    resolution: z.ZodEnum<{
+                        "1d": "1d";
+                        "1h": "1h";
+                        "5m": "5m";
+                        raw: "raw";
+                    }>;
+                    series: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                        scope: z.ZodString;
+                        before: z.ZodNullable<z.ZodObject<{
+                            t: z.ZodNumber;
+                            value: z.ZodNullable<z.ZodNumber>;
+                            state: z.ZodNullable<z.ZodString>;
+                        }, z.core.$strip>>;
+                        points: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                            t: z.ZodNumber;
+                            samples: z.ZodNumber;
+                            mean: z.ZodNullable<z.ZodNumber>;
+                            twMean: z.ZodNullable<z.ZodNumber>;
+                            min: z.ZodNumber;
+                            max: z.ZodNumber;
+                            last: z.ZodNullable<z.ZodNumber>;
+                            delta: z.ZodNullable<z.ZodNumber>;
+                            state: z.ZodNullable<z.ZodString>;
+                            states: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+                        }, z.core.$strip>>>;
+                        derivedFrom: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>>>;
+                    truncated: z.ZodBoolean;
+                }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodObject<{
+                ok: z.ZodLiteral<false>;
+                error: z.ZodString;
+            }, z.core.$strip>], "ok">>>;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
         /** Producer: declare (idempotent) a series key this addon owns: `addon:<callerAddonId>/<name>`. */
         readonly declareSeries: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             name: z.ZodString;

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

@@ -522,6 +522,23 @@ export declare const dishwasherCapability: {
                 readonly unit: '%';
                 readonly deadband: 2;
             };
+            readonly state: {
+                readonly kind: 'enum';
+            };
+            readonly operationState: {
+                readonly kind: 'enum';
+            };
+            readonly remainingSeconds: {
+                readonly kind: 'gauge';
+                readonly unit: 's';
+                readonly minIntervalMs: 60000;
+            };
+            readonly doorOpen: {
+                readonly kind: 'boolean';
+            };
+            readonly powerOn: {
+                readonly kind: 'boolean';
+            };
         };
     };
 };

package/dist/capabilities/enum-sensor.cap.d.ts

@@ -63,9 +63,19 @@ export declare const enumSensorCapability: {
      */
     readonly durability: 'restored';
     /**
-     * History (D850): none — text/enum state has no history (non-goal).
+     * History (D850): the value as an `enum` series (an appliance's program or
+     * operation state, an HVAC action). The option set is per device, so the
+     * value list is LEARNED as values are first seen (bounded). A sensor with a
+     * `format` carries a timestamp, not a state, and is not recorded.
      */
-    readonly history: 'none';
+    readonly history: {
+        readonly fields: {
+            readonly value: {
+                readonly kind: 'enum';
+                readonly skipWhenSet: 'format';
+            };
+        };
+    };
     /** Clock fields: written, but excluded from the compare that decides
      *  whether persisting is worth a SQLite commit. */
     readonly volatileStateFields: readonly ["lastFetchedAt"];