@camstack/types 1.2.365 → 1.2.366

package/dist/addon.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-BBXNq778.js");
+const require_sleep = require("./sleep-NZlEFYGX.js");
 const require_event_category = require("./event-category-T43rdQWR.js");
 const require_err_msg = require("./err-msg-Dx2Kor0g.js");
 //#region src/generated/cap-input-defaults.ts

package/dist/addon.mjs

@@ -1,4 +1,4 @@
-import { $ as ReadinessRegistry, A as viewerUiCapability, At as clearKnownSecrets, C as isZodSecret, Cn as isSecretMarker, Dt as REVALIDATE_AFTER_MS, E as HF_REPO, En as toSecretFieldView, Et as resolveSecretViewsIn, Ft as shortSecretRefHash, Gt as normalizeAddonInitResult, H as expandCapMethods, I as adminUiCapability, It as PEER_BYTES_CHUNK_BYTES, Lt as PEER_BYTES_MAX_OUTSTANDING, Mt as knownSecretCount, Nt as registerKnownSecret, Ot as createSecretsAccess, P as describeCustomActions, Pt as scrubKnownSecrets, Q as MODEL_FORMATS, Rt as PEER_BYTES_STALL_MS, S as collectZodSecretPaths, Sn as isSecretFieldView, Tn as makeSecretMarker, Ut as DisposerChain, Vt as DATAPLANE_SECRET_HEADER, Wt as BaseAddon, X as readNodePin, Y as nodePin, _ as createEventBusSliceSource, an as isSecretRef, bn as classifySecretWrite, c as asString, d as parseJsonUnknown, dn as emitReadiness, en as SECRET_REF_SCHEME, et as ReadinessTimeoutError, f as hfModelUrl, g as createDeviceProxy, h as isDeviceScopedCap, in as globalSecretScope, j as DEVICE_CHILDREN_BATCH_MAX, jt as forgetKnownSecret, k as deviceOpsCapability, kt as MIN_SCRUBBED_LENGTH, m as DEVICE_SCOPED_CAPS, nn as buildSecretRef, o as asJsonObject, on as normalizeSecretOwner, p as BOOT_RECOVERY_BACKOFF_MS, r as maskUrlCredentials, rn as formatSecretScope, rt as scopeKey, sn as parseSecretRef, t as sleep, tn as arrayItemFieldPath, un as createEvent, wn as isSecretMarkerLike, xn as isSecretClear, yn as SECRET_CLEAR, zt as PEER_BYTES_TICKET_TTL_MS } from "./sleep-BBF1iXUi.mjs";
+import { A as viewerUiCapability, At as createSecretsAccess, Bt as PEER_BYTES_STALL_MS, C as isZodSecret, Cn as isSecretClear, Dn as makeSecretMarker, E as HF_REPO, En as isSecretMarkerLike, Ft as registerKnownSecret, Gt as DisposerChain, I as adminUiCapability, It as scrubKnownSecrets, Kt as BaseAddon, Lt as shortSecretRefHash, Mt as clearKnownSecrets, Nt as forgetKnownSecret, On as toSecretFieldView, Ot as resolveSecretViewsIn, P as describeCustomActions, Pt as knownSecretCount, Q as readNodePin, Rt as PEER_BYTES_CHUNK_BYTES, S as collectZodSecretPaths, Sn as classifySecretWrite, Tn as isSecretMarker, Ut as DATAPLANE_SECRET_HEADER, Vt as PEER_BYTES_TICKET_TTL_MS, W as expandCapMethods, Z as nodePin, _ as createEventBusSliceSource, an as formatSecretScope, at as scopeKey, c as asString, cn as normalizeSecretOwner, d as parseJsonUnknown, et as MODEL_FORMATS, f as hfModelUrl, fn as createEvent, g as createDeviceProxy, h as isDeviceScopedCap, in as buildSecretRef, j as DEVICE_CHILDREN_BATCH_MAX, jt as MIN_SCRUBBED_LENGTH, k as deviceOpsCapability, kt as REVALIDATE_AFTER_MS, ln as parseSecretRef, m as DEVICE_SCOPED_CAPS, nn as SECRET_REF_SCHEME, nt as ReadinessTimeoutError, o as asJsonObject, on as globalSecretScope, p as BOOT_RECOVERY_BACKOFF_MS, pn as emitReadiness, qt as normalizeAddonInitResult, r as maskUrlCredentials, rn as arrayItemFieldPath, sn as isSecretRef, t as sleep, tt as ReadinessRegistry, wn as isSecretFieldView, xn as SECRET_CLEAR, zt as PEER_BYTES_MAX_OUTSTANDING } from "./sleep-DxJdzHni.mjs";
 import { t as EventCategory } from "./event-category-C4hVnRo8.mjs";
 import { a as DeviceType, t as errMsg } from "./err-msg-DX6i_MY4.mjs";
 //#region src/generated/cap-input-defaults.ts

package/dist/capabilities/air-quality-sensor.cap.d.ts

@@ -58,6 +58,38 @@ export declare const airQualitySensorCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'restored';
+    /**
+     * History (D850): recorded series.
+     */
+    readonly history: {
+        readonly fields: {
+            readonly co2Ppm: {
+                readonly kind: 'gauge';
+                readonly unit: 'ppm';
+                readonly deadband: 5;
+            };
+            readonly vocPpb: {
+                readonly kind: 'gauge';
+                readonly unit: 'ppb';
+                readonly deadband: 5;
+            };
+            readonly pm25: {
+                readonly kind: 'gauge';
+                readonly unit: 'ug/m3';
+                readonly deadband: 1;
+            };
+            readonly pm10: {
+                readonly kind: 'gauge';
+                readonly unit: 'ug/m3';
+                readonly deadband: 1;
+            };
+            readonly aqi: {
+                readonly kind: 'gauge';
+                readonly unit: 'count';
+                readonly deadband: 1;
+            };
+        };
+    };
     /** Clock fields: written, but excluded from the compare that decides
      *  whether persisting is worth a SQLite commit. */
     readonly volatileStateFields: readonly ["lastFetchedAt"];

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

@@ -177,6 +177,10 @@ export declare const alarmPanelCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'restored';
+    /**
+     * History (D850): none — enum state; arm/disarm history belongs in the events ledger.
+     */
+    readonly history: 'none';
     /** Clock fields: written, but excluded from the compare that decides
      *  whether persisting is worth a SQLite commit. */
     readonly volatileStateFields: readonly ["lastChangedAt"];

package/dist/capabilities/ambient-light-sensor.cap.d.ts

@@ -41,6 +41,19 @@ export declare const ambientLightSensorCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'restored';
+    /**
+     * History (D850): recorded series. Wide range, so a RELATIVE deadband (10 %).
+     */
+    readonly history: {
+        readonly fields: {
+            readonly lux: {
+                readonly kind: 'gauge';
+                readonly unit: 'lx';
+                readonly deadbandPct: 10;
+                readonly minIntervalMs: 60000;
+            };
+        };
+    };
     /** Clock fields: written, but excluded from the compare that decides
      *  whether persisting is worth a SQLite commit. */
     readonly volatileStateFields: readonly ["lastFetchedAt"];

package/dist/capabilities/audio-metrics.cap.d.ts

@@ -175,6 +175,10 @@ export declare const audioMetricsCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'session';
+    /**
+     * History (D850): none — the level is the addon series `pipeline-analytics/audio-level` (producer `record`); the other numbers move every inference window and duplicate it.
+     */
+    readonly history: 'none';
 };
 export type IAudioMetricsProvider = InferProvider<typeof audioMetricsCapability>;
 export { AudioMetricsSnapshotSchema, AudioClassSummarySchema, AudioMetricsHistoryPointSchema, AudioMetricsHistorySchema, };

package/dist/capabilities/automation-control.cap.d.ts

@@ -67,5 +67,9 @@ export declare const automationControlCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'session';
+    /**
+     * History (D850): none — configuration and transient run state.
+     */
+    readonly history: 'none';
 };
 export type IAutomationControlProvider = InferProvider<typeof automationControlCapability>;

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

@@ -149,6 +149,17 @@ export declare const batteryCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'restored';
+    /**
+     * History (D850): recorded series. The generic capture replaces the `battery` series of `pipeline-analytics:stats-5m`.
+     */
+    readonly history: {
+        readonly fields: {
+            readonly percentage: {
+                readonly kind: 'gauge';
+                readonly unit: '%';
+            };
+        };
+    };
     /** Clock fields: written, but excluded from the compare that decides
      *  whether persisting is worth a SQLite commit. */
     readonly volatileStateFields: readonly ["lastUpdated"];

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

@@ -42,6 +42,16 @@ export declare const binaryCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'restored';
+    /**
+     * History (D850): recorded series.
+     */
+    readonly history: {
+        readonly fields: {
+            readonly on: {
+                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/brightness.cap.d.ts

@@ -67,5 +67,17 @@ export declare const brightnessCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'session';
+    /**
+     * History (D850): recorded series. Actuator tier: level keeps every change.
+     */
+    readonly history: {
+        readonly fields: {
+            readonly percentage: {
+                readonly kind: 'gauge';
+                readonly unit: '%';
+                readonly minIntervalMs: 0;
+            };
+        };
+    };
 };
 export type IBrightnessProvider = InferProvider<typeof brightnessCapability>;

package/dist/capabilities/camera-streams.cap.d.ts

@@ -403,5 +403,9 @@ export declare const cameraStreamsCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'session';
+    /**
+     * History (D850): none — `online` duplicates device-status.online (one authority); slot data is nested enum/string.
+     */
+    readonly history: 'none';
 };
 export type ICameraStreamsProvider = InferProvider<typeof cameraStreamsCapability>;

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

@@ -378,6 +378,68 @@ export interface DeviceConfigSpec {
 export type RuntimeStateDurability = 'session' | 'restored';
 /** The default applied to a `runtimeState` cap that declares no `durability`. */
 export declare const DEFAULT_RUNTIME_STATE_DURABILITY: RuntimeStateDurability;
+/**
+ * Unit of a recorded history series. A closed set: the History tab formats by
+ * it. `'ug/m3'` is the ASCII-safe id of micrograms per cubic metre — render it
+ * 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';
+/** 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. */
+export interface CapabilityHistoryField {
+    /**
+     * `gauge` — a level, averaged in a rollup. `counter` — a MONOTONIC hardware
+     * 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.
+     */
+    readonly kind: 'gauge' | 'counter' | 'boolean';
+    /** Fixed unit of the series. Mutually exclusive with {@link unitFrom}. */
+    readonly unit?: HistoryUnit;
+    /**
+     * Path of a SIBLING `runtimeState` field (a string or enum) that carries this
+     * device's unit — `weather.temperature` takes it from `temperatureUnit`. The
+     * catalog records the path; the reader resolves it per device. Mutually
+     * exclusive with {@link unit}.
+     */
+    readonly unitFrom?: string;
+    readonly displayName?: string;
+    /** Drop a change smaller than this (ABSOLUTE) — anti-jitter for noisy gauges. */
+    readonly deadband?: number;
+    /**
+     * Drop a change smaller than this percentage of the last recorded value
+     * (RELATIVE) — for a wide-range gauge such as lux. Applied together with
+     * {@link deadband} when both are set: a change must clear both.
+     */
+    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`
+     * (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).
+     */
+    readonly minIntervalMs?: number;
+    /**
+     * Device types for which this field is NOT captured. `motion.detected` is a
+     * series for a PIR sensor and not for a camera, whose motion is already an
+     * addon series and a ledger.
+     */
+    readonly excludeDeviceTypes?: readonly DeviceType[];
+}
+/**
+ * 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`.
+ */
+export type CapabilityHistory = 'none' | {
+    readonly fields: Readonly<Record<string, CapabilityHistoryField>>;
+};
+/** Capture floor (ms) applied to `gauge` / `counter` series when a field states none. */
+export declare const HISTORY_DEFAULT_MIN_INTERVAL_MS = 10000;
 /**
  * How a COMPOSED provider answers a method it cannot forward yet (D663). A
  * composition that ADDS a cap to a device serves this cap's methods from here
@@ -516,6 +578,14 @@ export interface CapabilityDefinition<TName extends string = string, TMethods ex
      * trick with `ts` for the two hot caps; this is the same idea, declared.
      */
     readonly volatileStateFields?: readonly string[];
+    /**
+     * Which `runtimeState` fields are recorded as long-term history series
+     * (D850), or `'none'`. Mandatory for every cap declaring `runtimeState` —
+     * `scripts/check-cap-history-declared.ts` fails the build otherwise. See
+     * {@link CapabilityHistory}; `npm run codegen` projects it into
+     * `generated/history-catalog.ts`.
+     */
+    readonly history?: CapabilityHistory;
     /**
      * Declarative settings spec. When present, the device-manager's
      * settings aggregator auto-derives the ConfigUISchema and routes

package/dist/capabilities/carbon-monoxide.cap.d.ts

@@ -35,6 +35,16 @@ export declare const carbonMonoxideCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'restored';
+    /**
+     * History (D850): recorded series.
+     */
+    readonly history: {
+        readonly fields: {
+            readonly detected: {
+                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/climate-control.cap.d.ts

@@ -206,5 +206,37 @@ export declare const climateControlCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'session';
+    /**
+     * History (D850): recorded series. Celsius by contract; setpoints keep every change (`minIntervalMs: 0`).
+     */
+    readonly history: {
+        readonly fields: {
+            readonly currentTemp: {
+                readonly kind: 'gauge';
+                readonly unit: '°C';
+                readonly deadband: 0.1;
+            };
+            readonly currentHumidity: {
+                readonly kind: 'gauge';
+                readonly unit: '%';
+                readonly deadband: 0.5;
+            };
+            readonly target: {
+                readonly kind: 'gauge';
+                readonly unit: '°C';
+                readonly minIntervalMs: 0;
+            };
+            readonly targetHigh: {
+                readonly kind: 'gauge';
+                readonly unit: '°C';
+                readonly minIntervalMs: 0;
+            };
+            readonly targetLow: {
+                readonly kind: 'gauge';
+                readonly unit: '°C';
+                readonly minIntervalMs: 0;
+            };
+        };
+    };
 };
 export type IClimateControlProvider = InferProvider<typeof climateControlCapability>;

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

@@ -187,6 +187,10 @@ export declare const colorCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'session';
+    /**
+     * History (D850): none — nested and cosmetic.
+     */
+    readonly history: 'none';
 };
 export type IColorProvider = InferProvider<typeof colorCapability>;
 export {};

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

@@ -39,6 +39,10 @@ export declare const connectivityCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'restored';
+    /**
+     * History (D850): none — duplicates device-status.online (one authority for availability).
+     */
+    readonly history: 'none';
     /** Clock fields: written, but excluded from the compare that decides
      *  whether persisting is worth a SQLite commit. */
     readonly volatileStateFields: readonly ["lastChangedAt"];

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

@@ -227,6 +227,10 @@ export declare const consumablesCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'restored';
+    /**
+     * History (D850): none — `items` is an array keyed by runtime ids; a history path never enters it.
+     */
+    readonly history: 'none';
     /** Clocks, not content: a re-read that changed no item costs no commit. */
     readonly volatileStateFields: readonly ["lastChangedAt", "lastFetchedAt"];
 };

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

@@ -43,6 +43,16 @@ export declare const contactCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'restored';
+    /**
+     * History (D850): recorded series.
+     */
+    readonly history: {
+        readonly fields: {
+            readonly entryOpen: {
+                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/control.cap.d.ts

@@ -168,6 +168,10 @@ export declare const controlCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'session';
+    /**
+     * History (D850): none — `value` is a number/string union; configuration entity.
+     */
+    readonly history: 'none';
 };
 export type IControlProvider = InferProvider<typeof controlCapability>;
 export {};

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

@@ -106,6 +106,18 @@ export declare const coverCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'restored';
+    /**
+     * History (D850): recorded series. Actuator tier: position keeps every tick of a movement.
+     */
+    readonly history: {
+        readonly fields: {
+            readonly position: {
+                readonly kind: 'gauge';
+                readonly unit: '%';
+                readonly minIntervalMs: 0;
+            };
+        };
+    };
     /** Clock fields: written, but excluded from the compare that decides
      *  whether persisting is worth a SQLite commit. */
     readonly volatileStateFields: readonly ["lastChangedAt"];

package/dist/capabilities/day-night.cap.d.ts

@@ -165,6 +165,10 @@ export declare const dayNightCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'restored';
+    /**
+     * History (D850): none — firmware configuration, not a measurement.
+     */
+    readonly history: 'none';
     /** Clock fields: written, but excluded from the compare that decides
      *  whether persisting is worth a SQLite commit. */
     readonly volatileStateFields: readonly ["lastFetchedAt"];

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

@@ -106,6 +106,10 @@ export declare const deviceDiscoveryCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'session';
+    /**
+     * History (D850): none — inventory.
+     */
+    readonly history: 'none';
     readonly methods: {
         /**
          * Snapshot of the current `discovered` list. Returns the

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

@@ -57,6 +57,16 @@ export declare const deviceStatusCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'restored';
+    /**
+     * History (D850): recorded series. The ONE availability series.
+     */
+    readonly history: {
+        readonly fields: {
+            readonly online: {
+                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/doorbell.cap.d.ts

@@ -74,5 +74,9 @@ export declare const doorbellCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'restored';
+    /**
+     * History (D850): none — `pressCountSinceStart` resets with the addon, so it is not a monotonic meter; presses live in the events ledger.
+     */
+    readonly history: 'none';
 };
 export type IDoorbellProvider = InferProvider<typeof doorbellCapability>;

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

@@ -62,6 +62,10 @@ export declare const enumSensorCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'restored';
+    /**
+     * History (D850): none — text/enum state has no history (non-goal).
+     */
+    readonly history: 'none';
     /** Clock fields: written, but excluded from the compare that decides
      *  whether persisting is worth a SQLite commit. */
     readonly volatileStateFields: readonly ["lastFetchedAt"];

package/dist/capabilities/event-emitter.cap.d.ts

@@ -81,5 +81,9 @@ export declare const eventEmitterCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'session';
+    /**
+     * History (D850): none — `eventCountSinceStart` resets with the addon; events live in ledgers.
+     */
+    readonly history: 'none';
 };
 export type IEventEmitterProvider = InferProvider<typeof eventEmitterCapability>;

package/dist/capabilities/fan-control.cap.d.ts

@@ -102,5 +102,20 @@ export declare const fanControlCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'session';
+    /**
+     * History (D850): recorded series. Actuator tier: speed keeps every change.
+     */
+    readonly history: {
+        readonly fields: {
+            readonly percentage: {
+                readonly kind: 'gauge';
+                readonly unit: '%';
+                readonly minIntervalMs: 0;
+            };
+            readonly oscillating: {
+                readonly kind: 'boolean';
+            };
+        };
+    };
 };
 export type IFanControlProvider = InferProvider<typeof fanControlCapability>;

package/dist/capabilities/feature-probe.cap.d.ts

@@ -82,5 +82,9 @@ export declare const featureProbeCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'session';
+    /**
+     * History (D850): none — static identity and capability probe.
+     */
+    readonly history: 'none';
 };
 export type IFeatureProbeProvider = InferProvider<typeof featureProbeCapability>;

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

@@ -39,6 +39,16 @@ export declare const floodCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'restored';
+    /**
+     * History (D850): recorded series.
+     */
+    readonly history: {
+        readonly fields: {
+            readonly flooded: {
+                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/gas.cap.d.ts

@@ -36,6 +36,16 @@ export declare const gasCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'restored';
+    /**
+     * History (D850): recorded series.
+     */
+    readonly history: {
+        readonly fields: {
+            readonly detected: {
+                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/humidifier.cap.d.ts

@@ -84,5 +84,20 @@ export declare const humidifierCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'session';
+    /**
+     * History (D850): recorded series.
+     */
+    readonly history: {
+        readonly fields: {
+            readonly currentHumidity: {
+                readonly kind: 'gauge';
+                readonly unit: '%';
+                readonly deadband: 0.5;
+            };
+            readonly on: {
+                readonly kind: 'boolean';
+            };
+        };
+    };
 };
 export type IHumidifierProvider = InferProvider<typeof humidifierCapability>;

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

@@ -45,6 +45,18 @@ export declare const humiditySensorCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'restored';
+    /**
+     * History (D850): recorded series.
+     */
+    readonly history: {
+        readonly fields: {
+            readonly percent: {
+                readonly kind: 'gauge';
+                readonly unit: '%';
+                readonly deadband: 0.5;
+            };
+        };
+    };
     /** Clock fields: written, but excluded from the compare that decides
      *  whether persisting is worth a SQLite commit. */
     readonly volatileStateFields: readonly ["lastFetchedAt"];

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

@@ -360,6 +360,10 @@ export declare const imageSettingsCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'restored';
+    /**
+     * History (D850): none — camera image configuration (operator intent), not a trend.
+     */
+    readonly history: 'none';
     /** Clock fields: written, but excluded from the compare that decides
      *  whether persisting is worth a SQLite commit. */
     readonly volatileStateFields: readonly ["lastFetchedAt"];

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

@@ -49,5 +49,9 @@ export declare const imageCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'session';
+    /**
+     * History (D850): none — not numeric.
+     */
+    readonly history: 'none';
 };
 export type IImageProvider = InferProvider<typeof imageCapability>;

package/dist/capabilities/index.d.ts

@@ -36,8 +36,8 @@ export { BrokerAddInputSchema, BrokerGetStateInputSchema, type BrokerInfo, type
 export { cameraPipelineConfigCapability, type ICameraPipelineConfigProvider, } from './camera-pipeline-config.cap.js';
 export { cameraStreamsCapability, type ICameraStreamsProvider, type PickedCamStream, PickedCamStreamSchema, type PickStreamPreferences, PickStreamPreferencesSchema, type PickStreamRequirements, PickStreamRequirementsSchema, type StreamCodec, StreamCodecSchema, } from './camera-streams.cap.js';
 export { emitsCollectionSelector, extractNestedAddonId, isArrayOutputSchema, isCollectionArrayMethod, isObjectInput, isVoidInput, kebabToCamel, looseSchema, objectInputDeclaresAddonId, objectInputDeclaresRequiredDeviceId, procedureAuthKey, resolveMethodAuth, } from './cap-router-predicates.js';
-export type { CapabilityDefinition, CapabilityEventSchema, CapabilityMethodAuth, CapabilityMethodCaller, CapabilityMethodKind, CapabilityMethodOptions, CapabilityMethodSchema, CapabilityMountHint, CapabilityMountKind, CapabilityStatusItemArray, CapabilityStatusKind, CapabilityStatusSchema, CapCaller, DeviceConfigDerivedFormUi, DeviceConfigSpec, DeviceConfigUiSpec, DeviceConfigWidgetUi, DeviceSettingsContribution, InferDeviceProxyCap, InferEvents, InferName, InferNativeProvider, InferProvider, InferRuntimeState, ProviderKind, RuntimeStateDurability, UiContribution, UiContributionKind, UiContributionRemote, } from './capability-definition.js';
-export { DEFAULT_RUNTIME_STATE_DURABILITY, DEVICE_SETTINGS_CONTRIBUTION_METHODS, DEVICE_STATUS_METHOD, event, expandCapMethods, isDeviceConfigCap, method, optionalMethod, PROVIDER_PIN_FIELD, resolveCapMount, } from './capability-definition.js';
+export type { CapabilityDefinition, CapabilityEventSchema, CapabilityMethodAuth, CapabilityMethodCaller, CapabilityMethodKind, CapabilityMethodOptions, CapabilityMethodSchema, CapabilityMountHint, CapabilityMountKind, CapabilityStatusItemArray, CapabilityStatusKind, CapabilityStatusSchema, CapCaller, DeviceConfigDerivedFormUi, DeviceConfigSpec, DeviceConfigUiSpec, DeviceConfigWidgetUi, DeviceSettingsContribution, InferDeviceProxyCap, InferEvents, InferName, InferNativeProvider, InferProvider, InferRuntimeState, CapabilityHistory, CapabilityHistoryField, HistoryUnit, ProviderKind, RuntimeStateDurability, UiContribution, UiContributionKind, UiContributionRemote, } from './capability-definition.js';
+export { DEFAULT_RUNTIME_STATE_DURABILITY, HISTORY_DEFAULT_MIN_INTERVAL_MS, HISTORY_UNIT_LABELS, DEVICE_SETTINGS_CONTRIBUTION_METHODS, DEVICE_STATUS_METHOD, event, expandCapMethods, isDeviceConfigCap, method, optionalMethod, PROVIDER_PIN_FIELD, resolveCapMount, } from './capability-definition.js';
 export { COMPOSER_RUNNER_ID, type ComposerApplyInput, ComposerApplyInputSchema, type ComposerApplyResult, ComposerApplyResultSchema, type ComposerBlock, ComposerBlockSchema, type ComposerBlockVerdict, ComposerBlockVerdictSchema, type ComposerUnreadableBlock, ComposerUnreadableBlockSchema, composerCapability, type IComposerProvider, } from './composer.cap.js';
 export { CORE_BLOCK_ADDON_PREFIX, CORE_BLOCKS_ADDON_ID, type CompositionBlockInput, CompositionBlockInputSchema, type CompositionBlockPatch, type CompositionCustomizationRead, CompositionCustomizationReadSchema, type CompositionGetRead, CompositionGetReadSchema, type CompositionListRead, CompositionListReadSchema, type CompositionStateRead, CompositionStateReadSchema, type CompositionView, CompositionViewSchema, type CoreBlock, type CoreBlockCompileInput, CoreBlockCompileInputSchema, type CoreBlockCompileResult, CoreBlockCompileResultSchema, type CoreBlockFiles, CoreBlockFilesSchema, type CoreBlockInput, CoreBlockInputFieldsSchema, CoreBlockInputSchema, type CoreBlockPlacement, CoreBlockPlacementSchema, CoreBlockSchema, type CoreBlockSource, type CoreBlockSourceKind, CoreBlockSourceSchema, type CoreBlockStatus, CoreBlockStatusSchema, coreBlockAddonId, coreBlockComposition, coreBlockIdFromAddonId, coreBlockSourceKind, coreBlocksCapability, DEFAULT_CORE_BLOCK_ENTRY, type ICoreBlocksProvider, normalizeCoreBlockWrite, resolveCoreBlockEntry, resolveCoreBlockFiles, } from './core-blocks.cap.js';
 export * from './custom-actions.js';