@camstack/types 1.2.65 → 1.2.67

package/dist/addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_event_category = require("./event-category-DxZbWydC.js");
-const require_sleep = require("./sleep-BszXLEvP.js");
+const require_sleep = require("./sleep-Dh1EJSqF.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 //#region src/generated/collection-array-methods.ts
 /**
@@ -183,7 +183,7 @@ var CAP_INPUT_DEFAULTS = Object.freeze({
 			"pipelineEnabled": true,
 			"zones": [],
 			"onboardMotionDrivesAnalyzer": true,
-			"occupancyRecheckEnabled": false,
+			"occupancyRecheckEnabled": true,
 			"occupancyRecheckSec": 30,
 			"occupancyRecheckFrames": 4,
 			"frameSource": { "kind": "local-broker" }

package/dist/addon.mjs

@@ -1,5 +1,5 @@
 import { t as EventCategory } from "./event-category-Cv9dO26A.mjs";
-import { C as DeviceType, F as readNodePin, L as ReadinessRegistry, O as expandCapMethods, P as nodePin, R as ReadinessTimeoutError, V as scopeKey, a as asJsonObject, d as DEVICE_SCOPED_CAPS, f as isDeviceScopedCap, gt as normalizeAddonInitResult, ht as BaseAddon, mt as DisposerChain, p as createDeviceProxy, pt as DATAPLANE_SECRET_HEADER, s as asString, t as sleep, u as parseJsonUnknown, v as deviceOpsCapability, w as adminUiCapability, y as viewerUiCapability, yt as emitReadiness } from "./sleep-BxjBLp3L.mjs";
+import { C as DeviceType, F as nodePin, H as scopeKey, I as readNodePin, R as ReadinessRegistry, _t as normalizeAddonInitResult, a as asJsonObject, bt as emitReadiness, d as DEVICE_SCOPED_CAPS, f as isDeviceScopedCap, gt as BaseAddon, ht as DisposerChain, k as expandCapMethods, mt as DATAPLANE_SECRET_HEADER, p as createDeviceProxy, s as asString, t as sleep, u as parseJsonUnknown, v as deviceOpsCapability, w as adminUiCapability, y as viewerUiCapability, z as ReadinessTimeoutError } from "./sleep-CSgK0rNX.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 //#region src/generated/collection-array-methods.ts
 /**
@@ -182,7 +182,7 @@ var CAP_INPUT_DEFAULTS = Object.freeze({
 			"pipelineEnabled": true,
 			"zones": [],
 			"onboardMotionDrivesAnalyzer": true,
-			"occupancyRecheckEnabled": false,
+			"occupancyRecheckEnabled": true,
 			"occupancyRecheckSec": 30,
 			"occupancyRecheckFrames": 4,
 			"frameSource": { "kind": "local-broker" }

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

@@ -51,5 +51,15 @@ export declare const airQualitySensorCapability: {
         unit: z.ZodOptional<z.ZodString>;
         precision: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **restored** — as `numeric-sensor`.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "restored";
+    /** Clock fields: written, but excluded from the compare that decides
+     *  whether persisting is worth a SQLite commit. */
+    readonly volatileStateFields: readonly ["lastFetchedAt"];
 };
 export type IAirQualitySensorProvider = InferProvider<typeof airQualitySensorCapability>;

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

@@ -149,5 +149,15 @@ export declare const alarmPanelCapability: {
         requiresCode: z.ZodBoolean;
         lastChangedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **restored** — armed state is the one thing a panel must not lose across a restart.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "restored";
+    /** Clock fields: written, but excluded from the compare that decides
+     *  whether persisting is worth a SQLite commit. */
+    readonly volatileStateFields: readonly ["lastChangedAt"];
 };
 export type IAlarmPanelProvider = InferProvider<typeof alarmPanelCapability>;

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

@@ -34,5 +34,15 @@ export declare const ambientLightSensorCapability: {
         unit: z.ZodOptional<z.ZodString>;
         precision: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **restored** — as `numeric-sensor`.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "restored";
+    /** Clock fields: written, but excluded from the compare that decides
+     *  whether persisting is worth a SQLite commit. */
+    readonly volatileStateFields: readonly ["lastFetchedAt"];
 };
 export type IAmbientLightSensorProvider = InferProvider<typeof ambientLightSensorCapability>;

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

@@ -168,6 +168,13 @@ export declare const audioMetricsCapability: {
             peakScore: z.ZodNumber;
         }, z.core.$strip>>>;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **session** — 1 Hz per camera at the mirror and ~63 % of the fleet's whole runtime-state write rate. `avgDbfs` is a rolling 60 s mean that genuinely moves every second, so no equality fix reclaims it — and a two-hour-old dB reading rendered as current is worse than no reading.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "session";
 };
 export type IAudioMetricsProvider = InferProvider<typeof audioMetricsCapability>;
 export { AudioMetricsSnapshotSchema, AudioClassSummarySchema, AudioMetricsHistoryPointSchema, AudioMetricsHistorySchema, };

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

@@ -60,5 +60,12 @@ export declare const automationControlCapability: {
         lastError: z.ZodNullable<z.ZodString>;
         lastChangedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **session** — the authority for an automation being enabled is the automation store; a restored `isRunning` would be a lie. D62: one authority per switch.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "session";
 };
 export type IAutomationControlProvider = InferProvider<typeof automationControlCapability>;

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

@@ -115,5 +115,15 @@ export declare const batteryCapability: {
         lastUpdated: z.ZodNumber;
         binary: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **restored** — a sleeping battery camera may not report for hours; the restored percentage is the only thing the UI and the sleep gate have. Zero churn once `lastUpdated` is excluded — 526 writes, 0 value changes, in 25 minutes.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "restored";
+    /** Clock fields: written, but excluded from the compare that decides
+     *  whether persisting is worth a SQLite commit. */
+    readonly volatileStateFields: readonly ["lastUpdated"];
 };
 export type IBatteryProvider = InferProvider<typeof batteryCapability>;

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

@@ -35,5 +35,15 @@ export declare const binaryCapability: {
         on: z.ZodBoolean;
         lastChangedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **restored** — transition-driven sensor state; the restored value gives the boot comparison.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "restored";
+    /** Clock fields: written, but excluded from the compare that decides
+     *  whether persisting is worth a SQLite commit. */
+    readonly volatileStateFields: readonly ["lastChangedAt"];
 };
 export type IBinaryProvider = InferProvider<typeof binaryCapability>;

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

@@ -60,5 +60,12 @@ export declare const brightnessCapability: {
         percentage: z.ZodNumber;
         lastChangedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **session** — live lamp state, re-published by the provider on connect.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "session";
 };
 export type IBrightnessProvider = InferProvider<typeof brightnessCapability>;

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

@@ -350,5 +350,12 @@ export declare const cameraStreamsCapability: {
         }, z.core.$strip>;
         lastChangedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **session** — a restored `slotStatuses: streaming` for a camera that has been dark for two hours is a lie the UI renders as truth.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "session";
 };
 export type ICameraStreamsProvider = InferProvider<typeof cameraStreamsCapability>;

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

@@ -288,6 +288,34 @@ export type DeviceConfigUiSpec = DeviceConfigDerivedFormUi | DeviceConfigWidgetU
 export interface DeviceConfigSpec {
     readonly ui: DeviceConfigUiSpec;
 }
+/**
+ * Does this cap's runtime-state slice survive a restart?
+ *
+ *   - `'session'` — mirrored in RAM, NEVER written to disk. Correct when the
+ *     value is re-published on its own within a poll or a frame, and a restored
+ *     one would be a lie the UI renders as current: a 1 Hz `avgDbfs`, a
+ *     `zone-analytics` frame counter, a `camera-streams.slotStatuses` saying
+ *     `streaming` for a camera that has been dark for two hours. These two hot
+ *     caps alone are ~90 % of the fleet's runtime-state write rate (measured:
+ *     1.0–1.6 M writes/day offered, of which `audio-metrics` + `zone-analytics`
+ *     are 3,897 of 5,765 sampled changes) and their restored value is worth
+ *     nothing.
+ *
+ *   - `'restored'` — persisted, and seeded back into the mirror at boot. Pick
+ *     it when EITHER nothing else holds the value (`native-object-detection
+ *     .enabled` on a camera whose refresh is a no-op; `doorbell
+ *     .pressCountSinceStart`), OR the restored value is what turns the first
+ *     real observation after a restart into a COMPARISON instead of a phantom
+ *     transition (`device-status.online` — D130's rule stated in runtime-state
+ *     vocabulary). A restored value is not a claim about now; it is the
+ *     previous observation.
+ *
+ * The default is `'session'`, and the guard makes it explicit anyway: a value
+ * reaches disk only because its own capability asked for it.
+ */
+export type RuntimeStateDurability = 'session' | 'restored';
+/** The default applied to a `runtimeState` cap that declares no `durability`. */
+export declare const DEFAULT_RUNTIME_STATE_DURABILITY: RuntimeStateDurability;
 /**
  * Full definition of a capability — the single source of truth for the
  * functional contract (methods + events).
@@ -374,6 +402,36 @@ export interface CapabilityDefinition<TName extends string = string, TMethods ex
      * undefined; setCapState refuses to write to those slices.
      */
     readonly runtimeState?: import('zod').ZodObject<import('zod').core.$ZodLooseShape>;
+    /**
+     * Whether this cap's runtime-state slice SURVIVES A RESTART. Mandatory for
+     * every cap declaring `runtimeState` — `scripts/check-runtime-state-
+     * durability.ts` fails the build otherwise, so the choice is made in the diff
+     * rather than inherited by accident.
+     *
+     * See {@link RuntimeStateDurability} for what each value costs and buys.
+     * Behavioural cap metadata lives ONLY here (D4): the kernel has no whitelist
+     * to disagree with.
+     */
+    readonly durability?: RuntimeStateDurability;
+    /**
+     * Fields of `runtimeState` that are CLOCKS, not content — `lastFetchedAt`,
+     * `lastUpdated`, `ts`. They are persisted like any other field; they are
+     * simply excluded from the equality test that decides whether persisting is
+     * worth a SQLite commit.
+     *
+     * The cap names them because the cap knows which of its fields carry meaning.
+     * Measured on the live hub over 25 minutes: `battery` wrote its blob **526
+     * times while not one percentage moved** — every one of those writes was
+     * `lastUpdated` advancing. `privacy-mask` 22 of 22, `humidity-sensor` 67 of
+     * 75, `numeric-sensor` 251 of 669. Roughly half of all non-hot runtime-state
+     * writes on this installation are a device recording that it re-read a value
+     * that had not changed.
+     *
+     * Only meaningful on `durability: 'restored'` caps (a `'session'` slice never
+     * reaches disk, so nothing compares it). `SliceThrottler` already plays this
+     * trick with `ts` for the two hot caps; this is the same idea, declared.
+     */
+    readonly volatileStateFields?: readonly string[];
     /**
      * 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

@@ -28,5 +28,15 @@ export declare const carbonMonoxideCapability: {
         detected: z.ZodBoolean;
         lastChangedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **restored** — as `smoke`.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "restored";
+    /** Clock fields: written, but excluded from the compare that decides
+     *  whether persisting is worth a SQLite commit. */
+    readonly volatileStateFields: readonly ["lastChangedAt"];
 };
 export type ICarbonMonoxideProvider = InferProvider<typeof carbonMonoxideCapability>;

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

@@ -199,5 +199,12 @@ export declare const climateControlCapability: {
         swingHorizontal: z.ZodNullable<z.ZodBoolean>;
         lastFetchedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **session** — as `brightness`; `currentTemp` moves continuously and is re-published on connect.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "session";
 };
 export type IClimateControlProvider = InferProvider<typeof climateControlCapability>;

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

@@ -180,6 +180,13 @@ export declare const colorCapability: {
         mireds: z.ZodOptional<z.ZodNumber>;
         lastChangedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **session** — as `brightness`.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "session";
 };
 export type IColorProvider = InferProvider<typeof colorCapability>;
 export {};

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

@@ -32,5 +32,15 @@ export declare const connectivityCapability: {
         connected: z.ZodBoolean;
         lastChangedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **restored** — same shape and same argument as `device-status`, for links rather than devices.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "restored";
+    /** Clock fields: written, but excluded from the compare that decides
+     *  whether persisting is worth a SQLite commit. */
+    readonly volatileStateFields: readonly ["lastChangedAt"];
 };
 export type IConnectivityProvider = InferProvider<typeof connectivityCapability>;

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

@@ -135,5 +135,12 @@ export declare const consumablesCapability: {
         lastChangedAt: z.ZodNumber;
         lastFetchedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **session** — the authority is the appliance; the provider re-reads the whole item array on connect.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "session";
 };
 export type IConsumablesProvider = InferProvider<typeof consumablesCapability>;

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

@@ -36,5 +36,15 @@ export declare const contactCapability: {
         entryOpen: z.ZodBoolean;
         lastChangedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **restored** — a door left open across a restart must still read open.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "restored";
+    /** Clock fields: written, but excluded from the compare that decides
+     *  whether persisting is worth a SQLite commit. */
+    readonly volatileStateFields: readonly ["lastChangedAt"];
 };
 export type IContactProvider = InferProvider<typeof contactCapability>;

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

@@ -161,6 +161,13 @@ export declare const controlCapability: {
             time: "time";
         }>>;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **session** — a generic control mirrors an external entity that re-publishes on connect; the options array is re-derived with it.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "session";
 };
 export type IControlProvider = InferProvider<typeof controlCapability>;
 export {};

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

@@ -99,5 +99,15 @@ export declare const coverCapability: {
         tiltPosition: z.ZodNullable<z.ZodNumber>;
         lastChangedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **restored** — position survives a restart on the device; the mirror should agree at boot rather than read blank.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "restored";
+    /** Clock fields: written, but excluded from the compare that decides
+     *  whether persisting is worth a SQLite commit. */
+    readonly volatileStateFields: readonly ["lastChangedAt"];
 };
 export type ICoverProvider = InferProvider<typeof coverCapability>;

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

@@ -158,5 +158,15 @@ export declare const dayNightCapability: {
         switchDelaySec: z.ZodOptional<z.ZodNumber>;
         lastFetchedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **restored** — operator-set IR-cut behaviour; mutation-driven.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "restored";
+    /** Clock fields: written, but excluded from the compare that decides
+     *  whether persisting is worth a SQLite commit. */
+    readonly volatileStateFields: readonly ["lastFetchedAt"];
 };
 export type IDayNightProvider = InferNativeProvider<typeof dayNightCapability>;

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

@@ -99,6 +99,13 @@ export declare const deviceDiscoveryCapability: {
         lastError: z.ZodNullable<z.ZodString>;
         lastFetchedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **session** — 5.7 KB of scan output on the largest device, fully re-derivable by re-scanning.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "session";
     readonly methods: {
         /**
          * Snapshot of the current `discovered` list. Returns the

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

@@ -50,5 +50,15 @@ export declare const deviceStatusCapability: {
         online: z.ZodBoolean;
         lastChangedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **restored** — the previous observation is what makes the first reading after a restart a COMPARISON instead of a phantom transition (D130). 32 real flips across 16 devices in 25 min — the busiest slice in the cold half.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "restored";
+    /** Clock fields: written, but excluded from the compare that decides
+     *  whether persisting is worth a SQLite commit. */
+    readonly volatileStateFields: readonly ["lastChangedAt"];
 };
 export type IDeviceStatusProvider = InferProvider<typeof deviceStatusCapability>;

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

@@ -74,5 +74,12 @@ export declare const doorbellCapability: {
         lastPressedAt: z.ZodNullable<z.ZodNumber>;
         pressCountSinceStart: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **restored** — a monotonic accumulator: the slice IS the record. `lastPressedAt` is content here, not a clock, so it is deliberately NOT volatile.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "restored";
 };
 export type IDoorbellProvider = InferProvider<typeof doorbellCapability>;

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

@@ -55,5 +55,15 @@ export declare const enumSensorCapability: {
         }>>;
         lastFetchedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **restored** — as `numeric-sensor`; 80 devices.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "restored";
+    /** Clock fields: written, but excluded from the compare that decides
+     *  whether persisting is worth a SQLite commit. */
+    readonly volatileStateFields: readonly ["lastFetchedAt"];
 };
 export type IEnumSensorProvider = InferProvider<typeof enumSensorCapability>;

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

@@ -74,5 +74,12 @@ export declare const eventEmitterCapability: {
         }, z.core.$strip>>;
         eventCountSinceStart: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **session** — `eventCountSinceStart` names its own scope.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "session";
 };
 export type IEventEmitterProvider = InferProvider<typeof eventEmitterCapability>;

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

@@ -95,5 +95,12 @@ export declare const fanControlCapability: {
         oscillating: z.ZodNullable<z.ZodBoolean>;
         lastChangedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **session** — as `brightness`.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "session";
 };
 export type IFanControlProvider = InferProvider<typeof fanControlCapability>;

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

@@ -75,5 +75,12 @@ export declare const featureProbeCapability: {
         lastProbedAt: z.ZodNumber;
         lastFetchedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **session** — per-session by definition — `lastProbedAt` means "this worker completed a probe THIS session", which is why the mirror seed already blanks it. Persisting it only creates something to blank.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "session";
 };
 export type IFeatureProbeProvider = InferProvider<typeof featureProbeCapability>;

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

@@ -32,5 +32,15 @@ export declare const floodCapability: {
         flooded: z.ZodBoolean;
         lastChangedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **restored** — as `smoke`.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "restored";
+    /** Clock fields: written, but excluded from the compare that decides
+     *  whether persisting is worth a SQLite commit. */
+    readonly volatileStateFields: readonly ["lastChangedAt"];
 };
 export type IFloodProvider = InferProvider<typeof floodCapability>;

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

@@ -29,5 +29,15 @@ export declare const gasCapability: {
         detected: z.ZodBoolean;
         lastChangedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **restored** — as `smoke`.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "restored";
+    /** Clock fields: written, but excluded from the compare that decides
+     *  whether persisting is worth a SQLite commit. */
+    readonly volatileStateFields: readonly ["lastChangedAt"];
 };
 export type IGasProvider = InferProvider<typeof gasCapability>;

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

@@ -77,5 +77,12 @@ export declare const humidifierCapability: {
         maxHumidity: z.ZodNullable<z.ZodNumber>;
         lastChangedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **session** — as `climate-control`.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "session";
 };
 export type IHumidifierProvider = InferProvider<typeof humidifierCapability>;

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

@@ -38,5 +38,15 @@ export declare const humiditySensorCapability: {
         unit: z.ZodOptional<z.ZodString>;
         precision: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **restored** — as `numeric-sensor` (67 of 75 writes were the clock alone).
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "restored";
+    /** Clock fields: written, but excluded from the compare that decides
+     *  whether persisting is worth a SQLite commit. */
+    readonly volatileStateFields: readonly ["lastFetchedAt"];
 };
 export type IHumiditySensorProvider = InferProvider<typeof humiditySensorCapability>;

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

@@ -353,5 +353,15 @@ export declare const imageSettingsCapability: {
         }>>;
         lastFetchedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **restored** — operator-set camera imaging; mutation-driven.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "restored";
+    /** Clock fields: written, but excluded from the compare that decides
+     *  whether persisting is worth a SQLite commit. */
+    readonly volatileStateFields: readonly ["lastFetchedAt"];
 };
 export type IImageSettingsProvider = InferNativeProvider<typeof imageSettingsCapability>;

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

@@ -42,5 +42,12 @@ export declare const imageCapability: {
         url: z.ZodNullable<z.ZodString>;
         lastUpdated: z.ZodNullable<z.ZodNumber>;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **session** — a snapshot URL is a session-scoped handle; a restored one points at nothing.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "session";
 };
 export type IImageProvider = InferProvider<typeof imageCapability>;

package/dist/capabilities/index.d.ts

@@ -36,8 +36,8 @@ export { BrokerAddInputSchema, BrokerGetStateInputSchema, type BrokerInfo as Uni
 export { cameraPipelineConfigCapability, type ICameraPipelineConfigProvider, } from './camera-pipeline-config.cap.js';
 export { cameraStreamsCapability, type ICameraStreamsProvider, type PickedCamStream, PickedCamStreamSchema, PickStreamPreferencesSchema, PickStreamRequirementsSchema, type StreamCodec, StreamCodecSchema, } from './camera-streams.cap.js';
 export { extractNestedAddonId, isArrayOutputSchema, isCollectionArrayMethod, isObjectInput, isVoidInput, kebabToCamel, looseSchema, objectInputDeclaresAddonId, procedureAuthKey, } 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, UiContribution, UiContributionKind, UiContributionRemote, } from './capability-definition.js';
-export { DEVICE_SETTINGS_CONTRIBUTION_METHODS, DEVICE_STATUS_METHOD, event, expandCapMethods, isDeviceConfigCap, method, 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, 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, resolveCapMount, } from './capability-definition.js';
 export { CORE_BLOCK_ADDON_PREFIX, CORE_BLOCKS_ADDON_ID, type CoreBlock, type CoreBlockCompileResult, CoreBlockCompileResultSchema, type CoreBlockInput, CoreBlockInputSchema, type CoreBlockPlacement, CoreBlockPlacementSchema, CoreBlockSchema, type CoreBlockStatus, CoreBlockStatusSchema, coreBlockAddonId, coreBlockIdFromAddonId, coreBlocksCapability, type ICoreBlocksProvider, } from './core-blocks.cap.js';
 export * from './custom-actions.js';
 export type { CustomModelDescriptor, ICustomModelRegistryProvider, } from './custom-model-registry.cap.js';
@@ -74,7 +74,7 @@ export { AddBrokerInputSchema, BrokerConnectionDetailsSchema, BrokerInfoSchema,
 export type { NetworkAccessStatus, NetworkEndpoint } from './network-access.cap.js';
 export { NetworkAccessStatusSchema, NetworkEndpointSchema, networkAccessCapability, } from './network-access.cap.js';
 export { type Attachment, type AttachmentMediaType, AttachmentMediaTypeSchema, AttachmentSchema, type DiscoveredTarget, DiscoveredTargetSchema, type INotificationOutputProvider, type NotificationAction, type NotificationActionIcon, NotificationActionIconSchema, NotificationActionSchema, type NotificationFormat, NotificationFormatSchema, NotificationSchema, notificationOutputCapability, type RenderedAs, RenderedAsSchema, type SendResult, SendResultSchema, type Target, type TargetKind, type TargetKindCaps, TargetKindCapsSchema, type TargetKindLevel, TargetKindLevelSchema, TargetKindSchema, TargetSchema, type TestResult, TestResultSchema, } from './notification-output.cap.js';
-export { type INotificationRulesProvider, NC_ALARM_SYSTEM_EVENT_KINDS, NC_AUDIO_DBFS_FLOOR, NC_AUTHORABLE_SYSTEM_EVENT_KINDS, NC_CONDITION_CATALOG, NC_CONFIRM_DEFAULT_MAX_IMAGE_PX, NC_CONFIRM_DEFAULT_TIMEOUT_MS, NC_CONFIRM_MAX_TIMEOUT_MS, NC_CONFIRM_MIN_TIMEOUT_MS, NC_HISTORY_LIMIT_DEFAULT, NC_HISTORY_LIMIT_MAX, NC_MAX_PER_TRACK_IMMEDIATE, NC_SNOOZE_MAX_MINUTES, type NcAlarmConfig, NcAlarmConfigSchema, type NcAlarmModeCoverage, NcAlarmModeCoverageSchema, type NcAlarmSettings, type NcAlarmSettingsPatch, NcAlarmSettingsPatchSchema, NcAlarmSettingsSchema, type NcAlarmSkippedDevice, NcAlarmSkippedDeviceSchema, type NcAlarmSkipReason, NcAlarmSkipReasonSchema, type NcAudioCondition, NcAudioConditionSchema, type NcConditionDescriptor, NcConditionDescriptorSchema, type NcConditions, NcConditionsSchema, type NcConfirm, type NcConfirmExpect, NcConfirmExpectSchema, NcConfirmSchema, type NcCrossing, NcCrossingSchema, type NcDelivery, NcDeliverySchema, type NcDeviceStateCondition, NcDeviceStateConditionSchema, type NcHistoryEntry, NcHistoryEntrySchema, type NcHistoryFilter, NcHistoryFilterSchema, type NcHistoryRecordKind, NcHistoryRecordKindSchema, type NcHistoryStatus, NcHistoryStatusSchema, type NcHistorySubject, NcHistorySubjectSchema, type NcMediaFrame, NcMediaFrameSchema, type NcMediaPolicy, NcMediaPolicySchema, type NcOccupancyCondition, NcOccupancyConditionSchema, type NcPlateMatcher, NcPlateMatcherSchema, type NcRule, type NcRuleAction, NcRuleActionSchema, type NcRuleActionSequence, NcRuleActionSequenceSchema, type NcRuleActions, NcRuleActionsSchema, type NcRuleInput, NcRuleInputSchema, type NcRuleNotificationButton, NcRuleNotificationButtonSchema, type NcRulePatch, NcRulePatchSchema, NcRuleSchema, type NcRuleTarget, NcRuleTargetSchema, type NcSchedule, NcScheduleSchema, type NcScheduleWindow, NcScheduleWindowSchema, type NcSnooze, type NcSnoozeInput, NcSnoozeInputSchema, NcSnoozeSchema, type NcSnoozeScope, NcSnoozeScopeSchema, type NcSnoozeSuppressed, NcSnoozeSuppressedSchema, type NcSystemEventCondition, NcSystemEventConditionSchema, type NcSystemEventKind, NcSystemEventKindSchema, type NcTestResult, NcTestResultSchema, type NcThrottle, type NcThrottleGranularity, NcThrottleGranularitySchema, NcThrottleSchema, type NcZoneCondition, NcZoneConditionSchema, notificationRulesCapability, } from './notification-rules.cap.js';
+export { type INotificationRulesProvider, NC_ALARM_SYSTEM_EVENT_KINDS, NC_AUDIO_DBFS_FLOOR, NC_AUTHORABLE_SYSTEM_EVENT_KINDS, NC_CONDITION_CATALOG, NC_CONFIRM_DEFAULT_MAX_IMAGE_PX, NC_CONFIRM_DEFAULT_TIMEOUT_MS, NC_CONFIRM_MAX_TIMEOUT_MS, NC_CONFIRM_MIN_TIMEOUT_MS, NC_DEFAULT_SNOOZE_MINUTES, NC_HISTORY_LIMIT_DEFAULT, NC_HISTORY_LIMIT_MAX, NC_MAX_PER_TRACK_IMMEDIATE, NC_SNOOZE_MAX_MINUTES, type NcAlarmConfig, NcAlarmConfigSchema, type NcAlarmModeCoverage, NcAlarmModeCoverageSchema, type NcAlarmSettings, type NcAlarmSettingsPatch, NcAlarmSettingsPatchSchema, NcAlarmSettingsSchema, type NcAlarmSkippedDevice, NcAlarmSkippedDeviceSchema, type NcAlarmSkipReason, NcAlarmSkipReasonSchema, type NcAudioCondition, NcAudioConditionSchema, type NcConditionDescriptor, NcConditionDescriptorSchema, type NcConditions, NcConditionsSchema, type NcConfirm, type NcConfirmExpect, NcConfirmExpectSchema, NcConfirmSchema, type NcCrossing, NcCrossingSchema, type NcDelivery, NcDeliverySchema, type NcDeviceStateCondition, NcDeviceStateConditionSchema, type NcHistoryEntry, NcHistoryEntrySchema, type NcHistoryFilter, NcHistoryFilterSchema, type NcHistoryRecordKind, NcHistoryRecordKindSchema, type NcHistoryStatus, NcHistoryStatusSchema, type NcHistorySubject, NcHistorySubjectSchema, type NcMediaFrame, NcMediaFrameSchema, type NcMediaPolicy, NcMediaPolicySchema, type NcOccupancyCondition, NcOccupancyConditionSchema, type NcPlateMatcher, NcPlateMatcherSchema, type NcRule, type NcRuleAction, NcRuleActionSchema, type NcRuleActionSequence, NcRuleActionSequenceSchema, type NcRuleActions, NcRuleActionsSchema, type NcRuleInput, NcRuleInputSchema, type NcRuleNotificationButton, NcRuleNotificationButtonSchema, type NcRulePatch, NcRulePatchSchema, NcRuleSchema, type NcRuleTarget, NcRuleTargetSchema, type NcSchedule, NcScheduleSchema, type NcScheduleWindow, NcScheduleWindowSchema, type NcSnooze, type NcSnoozeInput, NcSnoozeInputSchema, NcSnoozeSchema, type NcSnoozeScope, NcSnoozeScopeSchema, type NcSnoozeSuppressed, NcSnoozeSuppressedSchema, type NcSystemEventCondition, NcSystemEventConditionSchema, type NcSystemEventKind, NcSystemEventKindSchema, type NcTestResult, NcTestResultSchema, type NcThrottle, type NcThrottleGranularity, NcThrottleGranularitySchema, NcThrottleSchema, type NcZoneCondition, NcZoneConditionSchema, notificationRulesCapability, } from './notification-rules.cap.js';
 export { type IOauthIntegrationProvider, type OauthIntegrationDescriptor, OauthIntegrationDescriptorSchema, oauthIntegrationCapability, } from './oauth-integration.cap.js';
 export { type AudioEvent, AudioEventSchema, type DetectionSource, DetectionSourceSchema, type EventKind, type EventKindCategory, EventKindCategorySchema, type EventKindDescriptor, EventKindDescriptorSchema, type EventKindIcon, EventKindIconSchema, EventKindSchema, type EventKindsForDevice, EventKindsForDeviceSchema, type EventPruneCounts, type EventStoreDeviceFootprint, type EventStoreFootprint, type IPipelineAnalyticsProvider, type KeyEvent, KeyEventSchema, type LabelAttribution, LabelAttributionSchema, type LabelTier, LabelTierSchema, type MediaFile, type MediaFileInfo, MediaFileInfoSchema, type MediaFileKind, MediaFileSchema, type MotionEvent, MotionEventSchema, type ObjectEvent, ObjectEventSchema, pipelineAnalyticsCapability, type RecentTracksPage, RecentTracksPageSchema, type RecentTracksQuery, RecentTracksQueryInput, type RetrainAnnotation, type RetrainAnnotationDraft, RetrainAnnotationDraftSchema, RetrainAnnotationKindSchema, RetrainAnnotationSchema, RetrainAnnotationSourceSchema, type RetrainAssistResult, RetrainAssistResultSchema, RetrainAssistSubjectSchema, RetrainCopyRefusalSchema, type RetrainFrame, type RetrainFrameCandidate, RetrainFrameCandidateSchema, type RetrainFrameList, RetrainFrameListSchema, RetrainFrameSchema, type RetrainFrameSelection, RetrainFrameSelectionSchema, type RetrainMacroClass, RetrainMacroClassSchema, type RetrainStatus, RetrainStatusSchema, type RetrainTrack, RetrainTrackSchema, type RetrainTransitionResult, RetrainTransitionResultSchema, type ScoredObjectEvent, ScoredObjectEventSchema, type SensorEvent, SensorEventSchema, type Track, type TrackCascadeCounts, TrackCascadeCountsSchema, type TrackEnvelope, TrackEnvelopeSchema, TrackedDetectionSchema, type TrackFlags, type TrackFlagsPatch, TrackFlagsPatchSchema, TrackFlagsSchema, type TrackProjection, TrackProjectionSchema, TrackSchema, type TrackSource, TrackSourceSchema, type TrackState, TrackStateSchema, type TrackZoneFilter, TrackZoneFilterSchema, type TrainingExportDeviceTotals, TrainingExportDeviceTotalsSchema, type TrainingExportSummary, TrainingExportSummarySchema, type ZoneCrossing, type ZoneCrossingDirection, ZoneCrossingDirectionSchema, ZoneCrossingSchema, } from './pipeline-analytics.cap.js';
 export type { NativeCropRef, PipelineStepInputOutput, PipelineValidationIssue, PipelineValidationResult, } from './pipeline-executor.cap.js';