@camstack/addon-provider-dreo 0.2.15 → 0.2.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/dist/addon.js +656 -69
  2. package/dist/addon.mjs +656 -69
  3. package/package.json +1 -1
package/dist/addon.js CHANGED
@@ -10793,7 +10793,14 @@ var cameraStreamsCapability = {
10793
10793
  low: string().optional()
10794
10794
  }),
10795
10795
  lastChangedAt: number()
10796
- })
10796
+ }),
10797
+ /**
10798
+ * 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.
10799
+ *
10800
+ * See `RuntimeStateDurability`. Enforced by
10801
+ * `scripts/check-runtime-state-durability.ts`.
10802
+ */
10803
+ durability: "session"
10797
10804
  };
10798
10805
  /** Where a block runs. The operator chooses — a block driving a device on an
10799
10806
  * agent is the reason placement is not fixed to the hub. */
@@ -11354,6 +11361,13 @@ var deviceDiscoveryCapability = {
11354
11361
  kind: "poll"
11355
11362
  },
11356
11363
  runtimeState: DeviceDiscoveryStatusSchema.extend({ lastFetchedAt: number().int().nonnegative() }),
11364
+ /**
11365
+ * Runtime-state durability: **session** — 5.7 KB of scan output on the largest device, fully re-derivable by re-scanning.
11366
+ *
11367
+ * See `RuntimeStateDurability`. Enforced by
11368
+ * `scripts/check-runtime-state-durability.ts`.
11369
+ */
11370
+ durability: "session",
11357
11371
  methods: {
11358
11372
  /**
11359
11373
  * Snapshot of the current `discovered` list. Returns the
@@ -13270,7 +13284,23 @@ var NotificationActionSchema = object({
13270
13284
  * else — see `notification-center/action-token.ts` for what that does and
13271
13285
  * does not buy.
13272
13286
  */
13273
- destructive: boolean().optional()
13287
+ destructive: boolean().optional(),
13288
+ /**
13289
+ * How the tap should REACH the url.
13290
+ *
13291
+ * `navigate` (absent, and every button authored before this field) opens it:
13292
+ * the phone leaves the notification and shows whatever the callback returns.
13293
+ * That is right for a button whose answer the operator wants to read.
13294
+ *
13295
+ * `background` fires it as a POST and stays put. It exists for the buttons
13296
+ * whose whole point is not to interrupt — "silence this for 30 minutes" is
13297
+ * an answer to the notification, and being thrown into a browser tab to
13298
+ * confirm it costs more attention than the notification did. A backend that
13299
+ * cannot do a background call renders it as an ordinary link (the adapters
13300
+ * fall back rather than dropping the button), so this is a preference, never
13301
+ * a requirement.
13302
+ */
13303
+ mode: _enum(["navigate", "background"]).optional()
13274
13304
  });
13275
13305
  /**
13276
13306
  * The canonical notification. `body` is the only hard field (Apprise model).
@@ -14122,7 +14152,17 @@ var alarmPanelCapability = {
14122
14152
  * full slice; renders an arm button per `availableModes` entry and
14123
14153
  * a PIN field iff `requiresCode === true`.
14124
14154
  */
14125
- runtimeState: AlarmPanelStatusSchema
14155
+ runtimeState: AlarmPanelStatusSchema,
14156
+ /**
14157
+ * Runtime-state durability: **restored** — armed state is the one thing a panel must not lose across a restart.
14158
+ *
14159
+ * See `RuntimeStateDurability`. Enforced by
14160
+ * `scripts/check-runtime-state-durability.ts`.
14161
+ */
14162
+ durability: "restored",
14163
+ /** Clock fields: written, but excluded from the compare that decides
14164
+ * whether persisting is worth a SQLite commit. */
14165
+ volatileStateFields: ["lastChangedAt"]
14126
14166
  };
14127
14167
  /**
14128
14168
  * Shared geometry vocabulary for on-frame shape caps — privacy-mask,
@@ -14299,6 +14339,9 @@ var NcSystemEventConditionSchema = object({
14299
14339
  nodeIds: array(string().min(1)).min(1).optional(),
14300
14340
  packageNames: array(string().min(1)).min(1).optional()
14301
14341
  });
14342
+ /** Hard ceiling on a window (24h). A snooze that could not expire would be an
14343
+ * outage the operator asked for once and forgot. */
14344
+ var NC_SNOOZE_MAX_MINUTES = 1440;
14302
14345
  /** Weekly schedule — OR of windows; absence on the rule = always active. */
14303
14346
  var NcScheduleSchema = object({
14304
14347
  windows: array(object({
@@ -14675,15 +14718,15 @@ var NcConditionsSchema = object({
14675
14718
  * (an `immediate` rule naming an `audio-*` class, one notification per
14676
14719
  * classified sample) stays exactly as it was for rules that already use it.
14677
14720
  *
14678
- * NOT in {@link NC_CONDITION_CATALOG} yet, and that is the sequencing rule
14679
- * rather than an oversight: the viewer mirrors the descriptor enums BY HAND
14680
- * (`camstack/src/data/notification-center.ts`, guarded by
14681
- * `scripts/check-viewer-condition-mirror.ts`) and its rule editor STRIPS the
14721
+ * In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
14722
+ * rule rather than an accident: the viewer mirrors the descriptor enums BY
14723
+ * HAND (`camstack/src/data/notification-center.ts`, guarded by
14724
+ * `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
14682
14725
  * condition fields it does not know when a rule is saved from the phone.
14683
14726
  * Publishing an editor for a condition the app cannot round-trip is how an
14684
- * operator loses a rule's conditions by opening it — so the descriptor, the
14685
- * admin widget and the viewer mirror land together (P2 + P3), and only then
14686
- * does an audio rule become authorable.
14727
+ * operator loses a rule's conditions by opening it — so the viewer mirror
14728
+ * (P3, shipped) went FIRST, and the descriptor an editor renders from
14729
+ * follows here.
14687
14730
  */
14688
14731
  audio: NcAudioConditionSchema.optional()
14689
14732
  });
@@ -14919,6 +14962,30 @@ var NcRuleInputSchema = object({
14919
14962
  */
14920
14963
  snoozeAllowGlobal: boolean().optional(),
14921
14964
  /**
14965
+ * The snooze durations THIS rule's notification offers as buttons, in
14966
+ * minutes.
14967
+ *
14968
+ * Three states, and all three are distinct — which is exactly why this is
14969
+ * `.optional()` and never `.default()`. A Zod default does not run on the
14970
+ * addon cap path (three production failures in one day), so a schema default
14971
+ * would collapse the first two:
14972
+ *
14973
+ * | value | meaning |
14974
+ * | --- | --- |
14975
+ * | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
14976
+ * | `[]` | **no snooze buttons on this rule** — the explicit override |
14977
+ * | a list | these choices, de-duplicated and sorted, at most four |
14978
+ *
14979
+ * `.max(4)` because the notifier's own action budget is small (ntfy allows
14980
+ * three buttons in total) and a rule that spent it all on snooze choices
14981
+ * would push its own tap-through actions off the notification.
14982
+ *
14983
+ * An empty list is NOT an alarm exemption: a rule the alarm is about, or
14984
+ * that arms the panel, is exempt automatically and cannot be silenced by a
14985
+ * window from anywhere (D133).
14986
+ */
14987
+ snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
14988
+ /**
14922
14989
  * Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
14923
14990
  *
14924
14991
  * This is what makes the rule set the alarm's trigger set without the alarm
@@ -15018,6 +15085,7 @@ var NcConditionDescriptorSchema = object({
15018
15085
  "device",
15019
15086
  "package",
15020
15087
  "occupancy",
15088
+ "audio",
15021
15089
  "system"
15022
15090
  ]),
15023
15091
  label: string(),
@@ -15036,6 +15104,7 @@ var NcConditionDescriptorSchema = object({
15036
15104
  "crossingSelect",
15037
15105
  "polygonDraw",
15038
15106
  "occupancy",
15107
+ "audio",
15039
15108
  "deviceState",
15040
15109
  "systemEvent"
15041
15110
  ]),
@@ -15187,7 +15256,20 @@ var NcSnoozeInputSchema = object({
15187
15256
  ruleId: string().optional(),
15188
15257
  /** Required when `scope: 'device'`. */
15189
15258
  deviceId: number().int().optional(),
15190
- durationMinutes: number().int().min(1).max(1440),
15259
+ /**
15260
+ * Narrow the window to these subject classes — "the cat, not the person".
15261
+ *
15262
+ * ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
15263
+ * what every window authored before this field meant, so no persisted row
15264
+ * changes meaning and no client has to learn anything to keep working.
15265
+ *
15266
+ * It is what makes the window's real key `(deviceId, classes[])` and lets it
15267
+ * cross rules (D133): the operator points at a camera and a kind of thing,
15268
+ * not at whichever of their four rules happened to produce the notification
15269
+ * they are dismissing.
15270
+ */
15271
+ classes: array(string().min(1)).min(1).optional(),
15272
+ durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
15191
15273
  /**
15192
15274
  * Silence this for EVERY recipient, not just the caller. Permission is
15193
15275
  * checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
@@ -15212,6 +15294,10 @@ var NcSnoozeSchema = object({
15212
15294
  scope: NcSnoozeScopeSchema,
15213
15295
  ruleId: string().optional(),
15214
15296
  deviceId: number().int().optional(),
15297
+ /** Subject classes this window covers. ABSENT = every class — see
15298
+ * {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
15299
+ * no SQLite column: nothing queries a window by class. */
15300
+ classes: array(string().min(1)).min(1).optional(),
15215
15301
  startedAt: number(),
15216
15302
  /** Exclusive: at exactly this instant the snooze is over. Expiry is a
15217
15303
  * COMPARISON, not a job — no sweeper can leave the operator silenced. */
@@ -17312,7 +17398,14 @@ var zonesCapability = {
17312
17398
  * handle. Slice shape is `{ zones: Zone[] }` so future extensions
17313
17399
  * (e.g. zone groupings) can sit alongside the polygon list.
17314
17400
  */
17315
- runtimeState: object({ zones: array(ZoneSchema).readonly() })
17401
+ runtimeState: object({ zones: array(ZoneSchema).readonly() }),
17402
+ /**
17403
+ * Runtime-state durability: **restored** — written only on operator mutation, so a camera that never had one has nothing to re-derive from. This is the slice `zone-mirror-hydration.ts` exists to paper over.
17404
+ *
17405
+ * See `RuntimeStateDurability`. Enforced by
17406
+ * `scripts/check-runtime-state-durability.ts`.
17407
+ */
17408
+ durability: "restored"
17316
17409
  };
17317
17410
  /**
17318
17411
  * A bounding box in NORMALIZED [0,1] frame coordinates for `getNativeCrop`. The
@@ -20111,7 +20204,17 @@ var airQualitySensorCapability = {
20111
20204
  schema: AirQualitySensorStatusSchema,
20112
20205
  kind: "push"
20113
20206
  },
20114
- runtimeState: AirQualitySensorStatusSchema
20207
+ runtimeState: AirQualitySensorStatusSchema,
20208
+ /**
20209
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
20210
+ *
20211
+ * See `RuntimeStateDurability`. Enforced by
20212
+ * `scripts/check-runtime-state-durability.ts`.
20213
+ */
20214
+ durability: "restored",
20215
+ /** Clock fields: written, but excluded from the compare that decides
20216
+ * whether persisting is worth a SQLite commit. */
20217
+ volatileStateFields: ["lastFetchedAt"]
20115
20218
  };
20116
20219
  /**
20117
20220
  * Ambient illuminance reading in lux. Drives Home Assistant `sensor`
@@ -20143,7 +20246,17 @@ var ambientLightSensorCapability = {
20143
20246
  schema: AmbientLightSensorStatusSchema,
20144
20247
  kind: "push"
20145
20248
  },
20146
- runtimeState: AmbientLightSensorStatusSchema
20249
+ runtimeState: AmbientLightSensorStatusSchema,
20250
+ /**
20251
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
20252
+ *
20253
+ * See `RuntimeStateDurability`. Enforced by
20254
+ * `scripts/check-runtime-state-durability.ts`.
20255
+ */
20256
+ durability: "restored",
20257
+ /** Clock fields: written, but excluded from the compare that decides
20258
+ * whether persisting is worth a SQLite commit. */
20259
+ volatileStateFields: ["lastFetchedAt"]
20147
20260
  };
20148
20261
  /**
20149
20262
  * Per-class audio metrics aggregated over a sliding window.
@@ -20261,7 +20374,14 @@ var audioMetricsCapability = {
20261
20374
  }), AudioMetricsHistorySchema)
20262
20375
  },
20263
20376
  /** Reactive runtime-state mirror — live `device.state.audioMetrics.value`. */
20264
- runtimeState: AudioMetricsSnapshotSchema
20377
+ runtimeState: AudioMetricsSnapshotSchema,
20378
+ /**
20379
+ * 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.
20380
+ *
20381
+ * See `RuntimeStateDurability`. Enforced by
20382
+ * `scripts/check-runtime-state-durability.ts`.
20383
+ */
20384
+ durability: "session"
20265
20385
  };
20266
20386
  /**
20267
20387
  * Automation-control cap. Models HA `automation.*` entities on
@@ -20323,7 +20443,14 @@ var automationControlCapability = {
20323
20443
  * reads `enabled` (toggle) + `isRunning` (spinner) + `lastError`
20324
20444
  * (badge) directly.
20325
20445
  */
20326
- runtimeState: AutomationControlStatusSchema
20446
+ runtimeState: AutomationControlStatusSchema,
20447
+ /**
20448
+ * 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.
20449
+ *
20450
+ * See `RuntimeStateDurability`. Enforced by
20451
+ * `scripts/check-runtime-state-durability.ts`.
20452
+ */
20453
+ durability: "session"
20327
20454
  };
20328
20455
  /**
20329
20456
  * Battery status snapshot. Emitted by providers whose device is
@@ -20429,7 +20556,17 @@ onStatusChanged: { data: object({
20429
20556
  * via `device.runtimeState.getCapState('battery')` regardless of
20430
20557
  * the underlying driver.
20431
20558
  */
20432
- runtimeState: BatteryStatusSchema
20559
+ runtimeState: BatteryStatusSchema,
20560
+ /**
20561
+ * 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.
20562
+ *
20563
+ * See `RuntimeStateDurability`. Enforced by
20564
+ * `scripts/check-runtime-state-durability.ts`.
20565
+ */
20566
+ durability: "restored",
20567
+ /** Clock fields: written, but excluded from the compare that decides
20568
+ * whether persisting is worth a SQLite commit. */
20569
+ volatileStateFields: ["lastUpdated"]
20433
20570
  };
20434
20571
  /**
20435
20572
  * Generic boolean sensor — last-resort fallback when no domain-
@@ -20458,7 +20595,17 @@ var binaryCapability = {
20458
20595
  schema: BinaryStatusSchema,
20459
20596
  kind: "push"
20460
20597
  },
20461
- runtimeState: BinaryStatusSchema
20598
+ runtimeState: BinaryStatusSchema,
20599
+ /**
20600
+ * Runtime-state durability: **restored** — transition-driven sensor state; the restored value gives the boot comparison.
20601
+ *
20602
+ * See `RuntimeStateDurability`. Enforced by
20603
+ * `scripts/check-runtime-state-durability.ts`.
20604
+ */
20605
+ durability: "restored",
20606
+ /** Clock fields: written, but excluded from the compare that decides
20607
+ * whether persisting is worth a SQLite commit. */
20608
+ volatileStateFields: ["lastChangedAt"]
20462
20609
  };
20463
20610
  /**
20464
20611
  * Dimmable-light brightness control. Co-exists with `switch` on the
@@ -20511,7 +20658,14 @@ onBrightnessChanged: { data: object({
20511
20658
  * by the kernel. Read via `device.state.brightness.value` so UI
20512
20659
  * sliders surface the current level without polling the provider.
20513
20660
  */
20514
- runtimeState: BrightnessStatusSchema
20661
+ runtimeState: BrightnessStatusSchema,
20662
+ /**
20663
+ * Runtime-state durability: **session** — live lamp state, re-published by the provider on connect.
20664
+ *
20665
+ * See `RuntimeStateDurability`. Enforced by
20666
+ * `scripts/check-runtime-state-durability.ts`.
20667
+ */
20668
+ durability: "session"
20515
20669
  };
20516
20670
  DeviceType.Button, method(object({ deviceId: number().int().nonnegative() }), _void(), {
20517
20671
  kind: "mutation",
@@ -20599,7 +20753,17 @@ var carbonMonoxideCapability = {
20599
20753
  schema: CarbonMonoxideStatusSchema,
20600
20754
  kind: "push"
20601
20755
  },
20602
- runtimeState: CarbonMonoxideStatusSchema
20756
+ runtimeState: CarbonMonoxideStatusSchema,
20757
+ /**
20758
+ * Runtime-state durability: **restored** — as `smoke`.
20759
+ *
20760
+ * See `RuntimeStateDurability`. Enforced by
20761
+ * `scripts/check-runtime-state-durability.ts`.
20762
+ */
20763
+ durability: "restored",
20764
+ /** Clock fields: written, but excluded from the compare that decides
20765
+ * whether persisting is worth a SQLite commit. */
20766
+ volatileStateFields: ["lastChangedAt"]
20603
20767
  };
20604
20768
  /**
20605
20769
  * HVAC / climate control cap. Models the full surface of a HA
@@ -20759,7 +20923,14 @@ var climateControlCapability = {
20759
20923
  * the full slice via `device.state.climate-control.value` and refresh
20760
20924
  * on every push without re-querying the provider.
20761
20925
  */
20762
- runtimeState: ClimateControlStatusSchema
20926
+ runtimeState: ClimateControlStatusSchema,
20927
+ /**
20928
+ * Runtime-state durability: **session** — as `brightness`; `currentTemp` moves continuously and is re-published on connect.
20929
+ *
20930
+ * See `RuntimeStateDurability`. Enforced by
20931
+ * `scripts/check-runtime-state-durability.ts`.
20932
+ */
20933
+ durability: "session"
20763
20934
  };
20764
20935
  /**
20765
20936
  * Color-light cap. Coexists with `switch` (on/off) and `brightness`
@@ -20869,7 +21040,14 @@ onColorChanged: { data: object({
20869
21040
  * kernel. Read via `device.state.color.value` so UI pickers surface
20870
21041
  * the current chromaticity without polling the provider.
20871
21042
  */
20872
- runtimeState: ColorStatusSchema
21043
+ runtimeState: ColorStatusSchema,
21044
+ /**
21045
+ * Runtime-state durability: **session** — as `brightness`.
21046
+ *
21047
+ * See `RuntimeStateDurability`. Enforced by
21048
+ * `scripts/check-runtime-state-durability.ts`.
21049
+ */
21050
+ durability: "session"
20873
21051
  };
20874
21052
  var ConnectionTestOutcomeSchema = discriminatedUnion("outcome", [
20875
21053
  object({
@@ -20935,7 +21113,17 @@ var connectivityCapability = {
20935
21113
  schema: ConnectivityStatusSchema,
20936
21114
  kind: "push"
20937
21115
  },
20938
- runtimeState: ConnectivityStatusSchema
21116
+ runtimeState: ConnectivityStatusSchema,
21117
+ /**
21118
+ * Runtime-state durability: **restored** — same shape and same argument as `device-status`, for links rather than devices.
21119
+ *
21120
+ * See `RuntimeStateDurability`. Enforced by
21121
+ * `scripts/check-runtime-state-durability.ts`.
21122
+ */
21123
+ durability: "restored",
21124
+ /** Clock fields: written, but excluded from the compare that decides
21125
+ * whether persisting is worth a SQLite commit. */
21126
+ volatileStateFields: ["lastChangedAt"]
20939
21127
  };
20940
21128
  /**
20941
21129
  * Generic device-consumables capability — surfaces a device's
@@ -21017,7 +21205,14 @@ reset: method(object({
21017
21205
  }
21018
21206
  }
21019
21207
  },
21020
- runtimeState: ConsumablesStatusSchema.extend({ lastFetchedAt: number() })
21208
+ runtimeState: ConsumablesStatusSchema.extend({ lastFetchedAt: number() }),
21209
+ /**
21210
+ * Runtime-state durability: **session** — the authority is the appliance; the provider re-reads the whole item array on connect.
21211
+ *
21212
+ * See `RuntimeStateDurability`. Enforced by
21213
+ * `scripts/check-runtime-state-durability.ts`.
21214
+ */
21215
+ durability: "session"
21021
21216
  };
21022
21217
  /**
21023
21218
  * Door / window / opening / garage / valve contact sensor. Boolean
@@ -21048,7 +21243,17 @@ var contactCapability = {
21048
21243
  schema: ContactStatusSchema,
21049
21244
  kind: "push"
21050
21245
  },
21051
- runtimeState: ContactStatusSchema
21246
+ runtimeState: ContactStatusSchema,
21247
+ /**
21248
+ * Runtime-state durability: **restored** — a door left open across a restart must still read open.
21249
+ *
21250
+ * See `RuntimeStateDurability`. Enforced by
21251
+ * `scripts/check-runtime-state-durability.ts`.
21252
+ */
21253
+ durability: "restored",
21254
+ /** Clock fields: written, but excluded from the compare that decides
21255
+ * whether persisting is worth a SQLite commit. */
21256
+ volatileStateFields: ["lastChangedAt"]
21052
21257
  };
21053
21258
  /**
21054
21259
  * Status slice — flat object (the framework's `runtimeState` contract
@@ -21154,7 +21359,14 @@ var controlCapability = {
21154
21359
  * dropdown / text field / date picker) read the slice's discriminant
21155
21360
  * and value directly without polling the provider.
21156
21361
  */
21157
- runtimeState: ControlStatusSchema
21362
+ runtimeState: ControlStatusSchema,
21363
+ /**
21364
+ * Runtime-state durability: **session** — a generic control mirrors an external entity that re-publishes on connect; the options array is re-derived with it.
21365
+ *
21366
+ * See `RuntimeStateDurability`. Enforced by
21367
+ * `scripts/check-runtime-state-durability.ts`.
21368
+ */
21369
+ durability: "session"
21158
21370
  };
21159
21371
  var CoverStatusSchema = object({
21160
21372
  /** Lifecycle state of the cover. */
@@ -21215,7 +21427,17 @@ var coverCapability = {
21215
21427
  * Runtime-state slice — mirrored by the kernel. UI controls watch
21216
21428
  * the slice for live position changes during a move.
21217
21429
  */
21218
- runtimeState: CoverStatusSchema
21430
+ runtimeState: CoverStatusSchema,
21431
+ /**
21432
+ * Runtime-state durability: **restored** — position survives a restart on the device; the mirror should agree at boot rather than read blank.
21433
+ *
21434
+ * See `RuntimeStateDurability`. Enforced by
21435
+ * `scripts/check-runtime-state-durability.ts`.
21436
+ */
21437
+ durability: "restored",
21438
+ /** Clock fields: written, but excluded from the compare that decides
21439
+ * whether persisting is worth a SQLite commit. */
21440
+ volatileStateFields: ["lastChangedAt"]
21219
21441
  };
21220
21442
  /**
21221
21443
  * Vendor-neutral day/night (IR-cut) control — the per-camera config cap
@@ -21309,7 +21531,17 @@ var dayNightCapability = {
21309
21531
  schema: DayNightStatusSchema,
21310
21532
  kind: "poll"
21311
21533
  },
21312
- runtimeState: DayNightStatusSchema
21534
+ runtimeState: DayNightStatusSchema,
21535
+ /**
21536
+ * Runtime-state durability: **restored** — operator-set IR-cut behaviour; mutation-driven.
21537
+ *
21538
+ * See `RuntimeStateDurability`. Enforced by
21539
+ * `scripts/check-runtime-state-durability.ts`.
21540
+ */
21541
+ durability: "restored",
21542
+ /** Clock fields: written, but excluded from the compare that decides
21543
+ * whether persisting is worth a SQLite commit. */
21544
+ volatileStateFields: ["lastFetchedAt"]
21313
21545
  };
21314
21546
  /**
21315
21547
  * Generic device-level status snapshot. Auto-registered by `BaseDevice`
@@ -21356,7 +21588,17 @@ onStatusChanged: { data: object({
21356
21588
  schema: DeviceStatusSchema,
21357
21589
  kind: "push"
21358
21590
  },
21359
- runtimeState: DeviceStatusSchema
21591
+ runtimeState: DeviceStatusSchema,
21592
+ /**
21593
+ * 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.
21594
+ *
21595
+ * See `RuntimeStateDurability`. Enforced by
21596
+ * `scripts/check-runtime-state-durability.ts`.
21597
+ */
21598
+ durability: "restored",
21599
+ /** Clock fields: written, but excluded from the compare that decides
21600
+ * whether persisting is worth a SQLite commit. */
21601
+ volatileStateFields: ["lastChangedAt"]
21360
21602
  };
21361
21603
  /**
21362
21604
  * Doorbell button cap. Two kinds of providers coexist behind this cap
@@ -21418,7 +21660,14 @@ onPressed: { data: DoorbellPressEventSchema } },
21418
21660
  * `device.state.doorbell.value`. UIs can show "last ring 5m ago"
21419
21661
  * without subscribing.
21420
21662
  */
21421
- runtimeState: DoorbellStatusSchema
21663
+ runtimeState: DoorbellStatusSchema,
21664
+ /**
21665
+ * 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.
21666
+ *
21667
+ * See `RuntimeStateDurability`. Enforced by
21668
+ * `scripts/check-runtime-state-durability.ts`.
21669
+ */
21670
+ durability: "restored"
21422
21671
  };
21423
21672
  /**
21424
21673
  * Enum-state sensor — a string value picked from a finite option set.
@@ -21458,7 +21707,17 @@ var enumSensorCapability = {
21458
21707
  schema: EnumSensorStatusSchema,
21459
21708
  kind: "push"
21460
21709
  },
21461
- runtimeState: EnumSensorStatusSchema
21710
+ runtimeState: EnumSensorStatusSchema,
21711
+ /**
21712
+ * Runtime-state durability: **restored** — as `numeric-sensor`; 80 devices.
21713
+ *
21714
+ * See `RuntimeStateDurability`. Enforced by
21715
+ * `scripts/check-runtime-state-durability.ts`.
21716
+ */
21717
+ durability: "restored",
21718
+ /** Clock fields: written, but excluded from the compare that decides
21719
+ * whether persisting is worth a SQLite commit. */
21720
+ volatileStateFields: ["lastFetchedAt"]
21462
21721
  };
21463
21722
  /**
21464
21723
  * Generic stateless event emitter. Installed on a `DeviceType.EventEmitter`
@@ -21494,7 +21753,14 @@ var eventEmitterCapability = {
21494
21753
  schema: EventEmitterStatusSchema,
21495
21754
  kind: "push"
21496
21755
  },
21497
- runtimeState: EventEmitterStatusSchema
21756
+ runtimeState: EventEmitterStatusSchema,
21757
+ /**
21758
+ * Runtime-state durability: **session** — `eventCountSinceStart` names its own scope.
21759
+ *
21760
+ * See `RuntimeStateDurability`. Enforced by
21761
+ * `scripts/check-runtime-state-durability.ts`.
21762
+ */
21763
+ durability: "session"
21498
21764
  };
21499
21765
  var EventItemSchema = object({
21500
21766
  id: string(),
@@ -21775,7 +22041,14 @@ var fanControlCapability = {
21775
22041
  * Runtime-state slice — mirrored by the kernel. UI fan speed
21776
22042
  * sliders read `percentage` for live updates.
21777
22043
  */
21778
- runtimeState: FanControlStatusSchema
22044
+ runtimeState: FanControlStatusSchema,
22045
+ /**
22046
+ * Runtime-state durability: **session** — as `brightness`.
22047
+ *
22048
+ * See `RuntimeStateDurability`. Enforced by
22049
+ * `scripts/check-runtime-state-durability.ts`.
22050
+ */
22051
+ durability: "session"
21779
22052
  };
21780
22053
  /**
21781
22054
  * Per-device feature/identity probe slice. Holds the runtime-resolved
@@ -21851,7 +22124,14 @@ onProbeChanged: { data: object({
21851
22124
  schema: FeatureProbeStatusSchema,
21852
22125
  kind: "push"
21853
22126
  },
21854
- runtimeState: FeatureProbeStatusSchema
22127
+ runtimeState: FeatureProbeStatusSchema,
22128
+ /**
22129
+ * 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.
22130
+ *
22131
+ * See `RuntimeStateDurability`. Enforced by
22132
+ * `scripts/check-runtime-state-durability.ts`.
22133
+ */
22134
+ durability: "session"
21855
22135
  };
21856
22136
  /**
21857
22137
  * Water leak / moisture sensor. Boolean "is liquid currently
@@ -21878,7 +22158,17 @@ var floodCapability = {
21878
22158
  schema: FloodStatusSchema,
21879
22159
  kind: "push"
21880
22160
  },
21881
- runtimeState: FloodStatusSchema
22161
+ runtimeState: FloodStatusSchema,
22162
+ /**
22163
+ * Runtime-state durability: **restored** — as `smoke`.
22164
+ *
22165
+ * See `RuntimeStateDurability`. Enforced by
22166
+ * `scripts/check-runtime-state-durability.ts`.
22167
+ */
22168
+ durability: "restored",
22169
+ /** Clock fields: written, but excluded from the compare that decides
22170
+ * whether persisting is worth a SQLite commit. */
22171
+ volatileStateFields: ["lastChangedAt"]
21882
22172
  };
21883
22173
  /**
21884
22174
  * Combustible-gas (LPG / methane / hydrogen) alarm sensor. Drives
@@ -21901,7 +22191,17 @@ var gasCapability = {
21901
22191
  schema: GasStatusSchema,
21902
22192
  kind: "push"
21903
22193
  },
21904
- runtimeState: GasStatusSchema
22194
+ runtimeState: GasStatusSchema,
22195
+ /**
22196
+ * Runtime-state durability: **restored** — as `smoke`.
22197
+ *
22198
+ * See `RuntimeStateDurability`. Enforced by
22199
+ * `scripts/check-runtime-state-durability.ts`.
22200
+ */
22201
+ durability: "restored",
22202
+ /** Clock fields: written, but excluded from the compare that decides
22203
+ * whether persisting is worth a SQLite commit. */
22204
+ volatileStateFields: ["lastChangedAt"]
21905
22205
  };
21906
22206
  /**
21907
22207
  * Humidifier / dehumidifier cap. Models HA `humidifier.*` entities —
@@ -21977,7 +22277,14 @@ var humidifierCapability = {
21977
22277
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
21978
22278
  * slice for live humidity / mode changes.
21979
22279
  */
21980
- runtimeState: HumidifierStatusSchema
22280
+ runtimeState: HumidifierStatusSchema,
22281
+ /**
22282
+ * Runtime-state durability: **session** — as `climate-control`.
22283
+ *
22284
+ * See `RuntimeStateDurability`. Enforced by
22285
+ * `scripts/check-runtime-state-durability.ts`.
22286
+ */
22287
+ durability: "session"
21981
22288
  };
21982
22289
  /**
21983
22290
  * Single-metric humidity reading. Drives Home Assistant `sensor`
@@ -22013,7 +22320,17 @@ var humiditySensorCapability = {
22013
22320
  schema: HumiditySensorStatusSchema,
22014
22321
  kind: "push"
22015
22322
  },
22016
- runtimeState: HumiditySensorStatusSchema
22323
+ runtimeState: HumiditySensorStatusSchema,
22324
+ /**
22325
+ * Runtime-state durability: **restored** — as `numeric-sensor` (67 of 75 writes were the clock alone).
22326
+ *
22327
+ * See `RuntimeStateDurability`. Enforced by
22328
+ * `scripts/check-runtime-state-durability.ts`.
22329
+ */
22330
+ durability: "restored",
22331
+ /** Clock fields: written, but excluded from the compare that decides
22332
+ * whether persisting is worth a SQLite commit. */
22333
+ volatileStateFields: ["lastFetchedAt"]
22017
22334
  };
22018
22335
  /**
22019
22336
  * Image display cap. Models a single still image exposed by an integration —
@@ -22051,7 +22368,14 @@ var imageCapability = {
22051
22368
  * Runtime-state slice — mirrored by the kernel. The UI reads `url`
22052
22369
  * directly and renders the still image.
22053
22370
  */
22054
- runtimeState: ImageStatusSchema
22371
+ runtimeState: ImageStatusSchema,
22372
+ /**
22373
+ * Runtime-state durability: **session** — a snapshot URL is a session-scoped handle; a restored one points at nothing.
22374
+ *
22375
+ * See `RuntimeStateDurability`. Enforced by
22376
+ * `scripts/check-runtime-state-durability.ts`.
22377
+ */
22378
+ durability: "session"
22055
22379
  };
22056
22380
  /**
22057
22381
  * Vendor-neutral image / picture-adjustment cap — the per-camera config
@@ -22200,7 +22524,17 @@ var imageSettingsCapability = {
22200
22524
  schema: ImageSettingsStatusSchema,
22201
22525
  kind: "poll"
22202
22526
  },
22203
- runtimeState: ImageSettingsStatusSchema
22527
+ runtimeState: ImageSettingsStatusSchema,
22528
+ /**
22529
+ * Runtime-state durability: **restored** — operator-set camera imaging; mutation-driven.
22530
+ *
22531
+ * See `RuntimeStateDurability`. Enforced by
22532
+ * `scripts/check-runtime-state-durability.ts`.
22533
+ */
22534
+ durability: "restored",
22535
+ /** Clock fields: written, but excluded from the compare that decides
22536
+ * whether persisting is worth a SQLite commit. */
22537
+ volatileStateFields: ["lastFetchedAt"]
22204
22538
  };
22205
22539
  /**
22206
22540
  * integrations — system-scoped singleton capability for integration
@@ -22540,7 +22874,14 @@ var lawnMowerControlCapability = {
22540
22874
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
22541
22875
  * slice for live activity + battery changes.
22542
22876
  */
22543
- runtimeState: LawnMowerControlStatusSchema
22877
+ runtimeState: LawnMowerControlStatusSchema,
22878
+ /**
22879
+ * Runtime-state durability: **session** — as `vacuum-control`.
22880
+ *
22881
+ * See `RuntimeStateDurability`. Enforced by
22882
+ * `scripts/check-runtime-state-durability.ts`.
22883
+ */
22884
+ durability: "session"
22544
22885
  };
22545
22886
  /**
22546
22887
  * local-network — hub-only singleton.
@@ -22746,7 +23087,17 @@ var lockControlCapability = {
22746
23087
  * read `state` and disable themselves during `locking`/`unlocking`
22747
23088
  * transitions.
22748
23089
  */
22749
- runtimeState: LockControlStatusSchema
23090
+ runtimeState: LockControlStatusSchema,
23091
+ /**
23092
+ * Runtime-state durability: **restored** — a lock left locked must still read locked.
23093
+ *
23094
+ * See `RuntimeStateDurability`. Enforced by
23095
+ * `scripts/check-runtime-state-durability.ts`.
23096
+ */
23097
+ durability: "restored",
23098
+ /** Clock fields: written, but excluded from the compare that decides
23099
+ * whether persisting is worth a SQLite commit. */
23100
+ volatileStateFields: ["lastChangedAt"]
22750
23101
  };
22751
23102
  /**
22752
23103
  * Media-player cap. Models HA `media_player.*` (Sonos, Chromecast,
@@ -22908,7 +23259,14 @@ var mediaPlayerCapability = {
22908
23259
  * full slice for live now-playing, volume, and progress updates
22909
23260
  * without polling.
22910
23261
  */
22911
- runtimeState: MediaPlayerStatusSchema
23262
+ runtimeState: MediaPlayerStatusSchema,
23263
+ /**
23264
+ * Runtime-state durability: **session** — a restored transport position describes a playback that stopped when the hub did.
23265
+ *
23266
+ * See `RuntimeStateDurability`. Enforced by
23267
+ * `scripts/check-runtime-state-durability.ts`.
23268
+ */
23269
+ durability: "session"
22912
23270
  };
22913
23271
  /**
22914
23272
  * mesh-network — collection cap for mesh-VPN providers.
@@ -23172,7 +23530,14 @@ onMotionChanged: { data: MotionOnMotionChangedDataSchema } },
23172
23530
  * `device.state.motion.value`. Reads never invoke the provider, so
23173
23531
  * UIs and other addons can poll the cached state safely.
23174
23532
  */
23175
- runtimeState: MotionStatusSchema
23533
+ runtimeState: MotionStatusSchema,
23534
+ /**
23535
+ * Runtime-state durability: **session** — self-clearing by construction (`autoClearAfterMs`); a restored `detected: true` is a frozen event, and the next frame re-publishes the real one.
23536
+ *
23537
+ * See `RuntimeStateDurability`. Enforced by
23538
+ * `scripts/check-runtime-state-durability.ts`.
23539
+ */
23540
+ durability: "session"
23176
23541
  };
23177
23542
  /**
23178
23543
  * Motion-trigger toggle for accessory devices.
@@ -23237,7 +23602,14 @@ var motionTriggerCapability = {
23237
23602
  schema: MotionTriggerStatusSchema,
23238
23603
  kind: "command-driven"
23239
23604
  },
23240
- runtimeState: MotionTriggerRuntimeStateSchema
23605
+ runtimeState: MotionTriggerRuntimeStateSchema,
23606
+ /**
23607
+ * Runtime-state durability: **session** — the authority for motion-trigger enablement is the provider's own config; the slice is a mirror of it, re-published on connect.
23608
+ *
23609
+ * See `RuntimeStateDurability`. Enforced by
23610
+ * `scripts/check-runtime-state-durability.ts`.
23611
+ */
23612
+ durability: "session"
23241
23613
  };
23242
23614
  /**
23243
23615
  * Motion-zones share the same MaskShape vocabulary as privacy-mask — the
@@ -23304,7 +23676,17 @@ var motionZonesCapability = {
23304
23676
  schema: MotionZoneStatusSchema,
23305
23677
  kind: "poll"
23306
23678
  },
23307
- runtimeState: MotionZoneStatusSchema
23679
+ runtimeState: MotionZoneStatusSchema,
23680
+ /**
23681
+ * Runtime-state durability: **restored** — the 14 KB polygon list is the single largest slice on the fleet and has not changed since the operator drew it. Highest value per byte in the table.
23682
+ *
23683
+ * See `RuntimeStateDurability`. Enforced by
23684
+ * `scripts/check-runtime-state-durability.ts`.
23685
+ */
23686
+ durability: "restored",
23687
+ /** Clock fields: written, but excluded from the compare that decides
23688
+ * whether persisting is worth a SQLite commit. */
23689
+ volatileStateFields: ["lastFetchedAt"]
23308
23690
  };
23309
23691
  /**
23310
23692
  * On-camera AI object detection cap. Surfaces per-device the classes
@@ -23378,7 +23760,17 @@ var nativeObjectDetectionCapability = {
23378
23760
  schema: NativeObjectDetectionStatusSchema,
23379
23761
  kind: "push"
23380
23762
  },
23381
- runtimeState: NativeObjectDetectionRuntimeStateSchema
23763
+ runtimeState: NativeObjectDetectionRuntimeStateSchema,
23764
+ /**
23765
+ * Runtime-state durability: **restored** — `enabled` is an operator toggle on a camera whose refresh is a no-op and whose staleMs is Infinity. There is no hardware value to re-read — losing it loses the setting.
23766
+ *
23767
+ * See `RuntimeStateDurability`. Enforced by
23768
+ * `scripts/check-runtime-state-durability.ts`.
23769
+ */
23770
+ durability: "restored",
23771
+ /** Clock fields: written, but excluded from the compare that decides
23772
+ * whether persisting is worth a SQLite commit. */
23773
+ volatileStateFields: ["lastFetchedAt"]
23382
23774
  };
23383
23775
  /**
23384
23776
  * network-quality — system-scoped singleton capability tracking RTT,
@@ -23712,7 +24104,14 @@ onSent: { data: object({
23712
24104
  * form reads `supports` to gate optional fields; history pane reads
23713
24105
  * `lastSentAt` / `lastError` / `queueDepth`.
23714
24106
  */
23715
- runtimeState: NotifierStatusSchema
24107
+ runtimeState: NotifierStatusSchema,
24108
+ /**
24109
+ * Runtime-state durability: **session** — live queue depth and last-send state; a restored queue depth describes a queue that no longer exists.
24110
+ *
24111
+ * See `RuntimeStateDurability`. Enforced by
24112
+ * `scripts/check-runtime-state-durability.ts`.
24113
+ */
24114
+ durability: "session"
23716
24115
  };
23717
24116
  /**
23718
24117
  * Generic numeric sensor — last-resort fallback when no typed numeric
@@ -23755,7 +24154,17 @@ var numericSensorCapability = {
23755
24154
  schema: NumericSensorStatusSchema,
23756
24155
  kind: "push"
23757
24156
  },
23758
- runtimeState: NumericSensorStatusSchema
24157
+ runtimeState: NumericSensorStatusSchema,
24158
+ /**
24159
+ * Runtime-state durability: **restored** — polled value, low churn once the clock is excluded (251 of 669 writes were the clock alone); restoring it removes the cold window before the first poll.
24160
+ *
24161
+ * See `RuntimeStateDurability`. Enforced by
24162
+ * `scripts/check-runtime-state-durability.ts`.
24163
+ */
24164
+ durability: "restored",
24165
+ /** Clock fields: written, but excluded from the compare that decides
24166
+ * whether persisting is worth a SQLite commit. */
24167
+ volatileStateFields: ["lastFetchedAt"]
23759
24168
  };
23760
24169
  /**
23761
24170
  * Generic on-screen-display (video overlay) cap. Each camera exposes
@@ -24140,7 +24549,14 @@ var petFeederCapability = {
24140
24549
  * the full slice via `device.state.petFeeder.value` and refresh on
24141
24550
  * every poll without re-querying the provider.
24142
24551
  */
24143
- runtimeState: PetFeederStatusSchema
24552
+ runtimeState: PetFeederStatusSchema,
24553
+ /**
24554
+ * Runtime-state durability: **session** — live appliance state re-published on connect.
24555
+ *
24556
+ * See `RuntimeStateDurability`. Enforced by
24557
+ * `scripts/check-runtime-state-durability.ts`.
24558
+ */
24559
+ durability: "session"
24144
24560
  };
24145
24561
  var VehicleSchema = object({
24146
24562
  id: string(),
@@ -24452,7 +24868,17 @@ var powerMeterCapability = {
24452
24868
  schema: PowerMeterStatusSchema,
24453
24869
  kind: "push"
24454
24870
  },
24455
- runtimeState: PowerMeterStatusSchema
24871
+ runtimeState: PowerMeterStatusSchema,
24872
+ /**
24873
+ * Runtime-state durability: **restored** — as `numeric-sensor`; `kwhTotal` is an accumulator whose restored value is the baseline.
24874
+ *
24875
+ * See `RuntimeStateDurability`. Enforced by
24876
+ * `scripts/check-runtime-state-durability.ts`.
24877
+ */
24878
+ durability: "restored",
24879
+ /** Clock fields: written, but excluded from the compare that decides
24880
+ * whether persisting is worth a SQLite commit. */
24881
+ volatileStateFields: ["lastFetchedAt"]
24456
24882
  };
24457
24883
  /**
24458
24884
  * Presence cap. Models HA `person.*` and `device_tracker.*` entities
@@ -24509,7 +24935,17 @@ var presenceCapability = {
24509
24935
  * the map pin is rendered (use `DeviceFeature.PresenceGps` for the
24510
24936
  * pre-fetch fast-path check).
24511
24937
  */
24512
- runtimeState: PresenceStatusSchema
24938
+ runtimeState: PresenceStatusSchema,
24939
+ /**
24940
+ * Runtime-state durability: **restored** — occupancy-relevant: the restored state is what an occupancy rule compares the first post-restart observation against.
24941
+ *
24942
+ * See `RuntimeStateDurability`. Enforced by
24943
+ * `scripts/check-runtime-state-durability.ts`.
24944
+ */
24945
+ durability: "restored",
24946
+ /** Clock fields: written, but excluded from the compare that decides
24947
+ * whether persisting is worth a SQLite commit. */
24948
+ volatileStateFields: ["lastChangedAt"]
24513
24949
  };
24514
24950
  /**
24515
24951
  * Atmospheric pressure reading in hectopascals. Drives Home Assistant
@@ -24545,7 +24981,17 @@ var pressureSensorCapability = {
24545
24981
  schema: PressureSensorStatusSchema,
24546
24982
  kind: "push"
24547
24983
  },
24548
- runtimeState: PressureSensorStatusSchema
24984
+ runtimeState: PressureSensorStatusSchema,
24985
+ /**
24986
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
24987
+ *
24988
+ * See `RuntimeStateDurability`. Enforced by
24989
+ * `scripts/check-runtime-state-durability.ts`.
24990
+ */
24991
+ durability: "restored",
24992
+ /** Clock fields: written, but excluded from the compare that decides
24993
+ * whether persisting is worth a SQLite commit. */
24994
+ volatileStateFields: ["lastFetchedAt"]
24549
24995
  };
24550
24996
  /**
24551
24997
  * PRIVACY — what the camera deliberately does not capture. Two planes:
@@ -24675,7 +25121,17 @@ var privacyMaskCapability = {
24675
25121
  schema: PrivacyMaskStatusSchema,
24676
25122
  kind: "poll"
24677
25123
  },
24678
- runtimeState: PrivacyMaskStatusSchema
25124
+ runtimeState: PrivacyMaskStatusSchema,
25125
+ /**
25126
+ * Runtime-state durability: **restored** — operator-drawn regions, zero real churn — 22 writes in 25 minutes, every one of them the clock.
25127
+ *
25128
+ * See `RuntimeStateDurability`. Enforced by
25129
+ * `scripts/check-runtime-state-durability.ts`.
25130
+ */
25131
+ durability: "restored",
25132
+ /** Clock fields: written, but excluded from the compare that decides
25133
+ * whether persisting is worth a SQLite commit. */
25134
+ volatileStateFields: ["lastFetchedAt"]
24679
25135
  };
24680
25136
  var PtzPresetSchema = object({
24681
25137
  id: string(),
@@ -24841,7 +25297,14 @@ var ptzAutotrackCapability = {
24841
25297
  * fetch / cache / fallback logic out of the four cap methods —
24842
25298
  * they become trampolines over `runtimeState`.
24843
25299
  */
24844
- runtimeState: PtzAutotrackRuntimeStateSchema
25300
+ runtimeState: PtzAutotrackRuntimeStateSchema,
25301
+ /**
25302
+ * Runtime-state durability: **session** — mirrors the camera's own autotrack config, re-read on connect.
25303
+ *
25304
+ * See `RuntimeStateDurability`. Enforced by
25305
+ * `scripts/check-runtime-state-durability.ts`.
25306
+ */
25307
+ durability: "session"
24845
25308
  };
24846
25309
  DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceId: number().int().nonnegative() }), object({ success: literal(true) }), {
24847
25310
  kind: "mutation",
@@ -25491,7 +25954,14 @@ var sceneMonitorCapability = {
25491
25954
  schema: SceneMonitorStatusSchema,
25492
25955
  kind: "push"
25493
25956
  },
25494
- runtimeState: SceneMonitorStatusSchema
25957
+ runtimeState: SceneMonitorStatusSchema,
25958
+ /**
25959
+ * Runtime-state durability: **session** — re-derived from the current scene on the next evaluation.
25960
+ *
25961
+ * See `RuntimeStateDurability`. Enforced by
25962
+ * `scripts/check-runtime-state-durability.ts`.
25963
+ */
25964
+ durability: "session"
25495
25965
  };
25496
25966
  /**
25497
25967
  * Per-stage gating mode applied to the zones a rule references.
@@ -25635,7 +26105,14 @@ var scriptRunnerCapability = {
25635
26105
  * `isRunning` to render a spinner during execution and surfaces
25636
26106
  * `lastError` / `lastRunSuccess` in the recent-runs panel.
25637
26107
  */
25638
- runtimeState: ScriptRunnerStatusSchema
26108
+ runtimeState: ScriptRunnerStatusSchema,
26109
+ /**
26110
+ * Runtime-state durability: **session** — a restored `isRunning: true` describes a process that died with the previous hub.
26111
+ *
26112
+ * See `RuntimeStateDurability`. Enforced by
26113
+ * `scripts/check-runtime-state-durability.ts`.
26114
+ */
26115
+ durability: "session"
25639
26116
  };
25640
26117
  /**
25641
26118
  * Smoke alarm sensor — boolean "is smoke currently detected" with
@@ -25662,7 +26139,17 @@ var smokeCapability = {
25662
26139
  schema: SmokeStatusSchema,
25663
26140
  kind: "push"
25664
26141
  },
25665
- runtimeState: SmokeStatusSchema
26142
+ runtimeState: SmokeStatusSchema,
26143
+ /**
26144
+ * Runtime-state durability: **restored** — a safety sensor must not read "clear" merely because the hub restarted.
26145
+ *
26146
+ * See `RuntimeStateDurability`. Enforced by
26147
+ * `scripts/check-runtime-state-durability.ts`.
26148
+ */
26149
+ durability: "restored",
26150
+ /** Clock fields: written, but excluded from the compare that decides
26151
+ * whether persisting is worth a SQLite commit. */
26152
+ volatileStateFields: ["lastChangedAt"]
25666
26153
  };
25667
26154
  /**
25668
26155
  * One publishable camera stream as its OWNING PROVIDER describes it — the same
@@ -25835,7 +26322,17 @@ var streamParamsCapability = {
25835
26322
  schema: StreamParamsStatusSchema,
25836
26323
  kind: "poll"
25837
26324
  },
25838
- runtimeState: StreamParamsStatusSchema
26325
+ runtimeState: StreamParamsStatusSchema,
26326
+ /**
26327
+ * Runtime-state durability: **restored** — operator-set encoder profile; mutation-driven.
26328
+ *
26329
+ * See `RuntimeStateDurability`. Enforced by
26330
+ * `scripts/check-runtime-state-durability.ts`.
26331
+ */
26332
+ durability: "restored",
26333
+ /** Clock fields: written, but excluded from the compare that decides
26334
+ * whether persisting is worth a SQLite commit. */
26335
+ volatileStateFields: ["lastFetchedAt"]
25839
26336
  };
25840
26337
  /**
25841
26338
  * Generic on/off switch cap for accessory children (siren, floodlight,
@@ -25881,6 +26378,16 @@ var switchCapability = {
25881
26378
  * not need to re-query the provider after a setState mutation.
25882
26379
  */
25883
26380
  runtimeState: SwitchStatusSchema,
26381
+ /**
26382
+ * Runtime-state durability: **restored** — device state an operator reads as authoritative; 55 devices, transition-driven.
26383
+ *
26384
+ * See `RuntimeStateDurability`. Enforced by
26385
+ * `scripts/check-runtime-state-durability.ts`.
26386
+ */
26387
+ durability: "restored",
26388
+ /** Clock fields: written, but excluded from the compare that decides
26389
+ * whether persisting is worth a SQLite commit. */
26390
+ volatileStateFields: ["lastChangedAt"],
25884
26391
  settings: { bindings: [{
25885
26392
  kind: "scalar",
25886
26393
  statusPath: "on",
@@ -25960,7 +26467,17 @@ var tamperCapability = {
25960
26467
  schema: TamperStatusSchema,
25961
26468
  kind: "push"
25962
26469
  },
25963
- runtimeState: TamperStatusSchema
26470
+ runtimeState: TamperStatusSchema,
26471
+ /**
26472
+ * Runtime-state durability: **restored** — as `smoke`.
26473
+ *
26474
+ * See `RuntimeStateDurability`. Enforced by
26475
+ * `scripts/check-runtime-state-durability.ts`.
26476
+ */
26477
+ durability: "restored",
26478
+ /** Clock fields: written, but excluded from the compare that decides
26479
+ * whether persisting is worth a SQLite commit. */
26480
+ volatileStateFields: ["lastChangedAt"]
25964
26481
  };
25965
26482
  /**
25966
26483
  * Single-metric temperature reading. Drives Home Assistant `sensor`
@@ -26005,7 +26522,17 @@ var temperatureSensorCapability = {
26005
26522
  schema: TemperatureSensorStatusSchema,
26006
26523
  kind: "push"
26007
26524
  },
26008
- runtimeState: TemperatureSensorStatusSchema
26525
+ runtimeState: TemperatureSensorStatusSchema,
26526
+ /**
26527
+ * Runtime-state durability: **restored** — as `numeric-sensor` (69 of 125 writes were the clock alone).
26528
+ *
26529
+ * See `RuntimeStateDurability`. Enforced by
26530
+ * `scripts/check-runtime-state-durability.ts`.
26531
+ */
26532
+ durability: "restored",
26533
+ /** Clock fields: written, but excluded from the compare that decides
26534
+ * whether persisting is worth a SQLite commit. */
26535
+ volatileStateFields: ["lastFetchedAt"]
26009
26536
  };
26010
26537
  /**
26011
26538
  * toast — system-scoped singleton capability that streams toast
@@ -26074,7 +26601,14 @@ var updateCapability = {
26074
26601
  schema: UpdateStatusSchema,
26075
26602
  kind: "poll"
26076
26603
  },
26077
- runtimeState: UpdateStatusSchema
26604
+ runtimeState: UpdateStatusSchema,
26605
+ /**
26606
+ * Runtime-state durability: **session** — a restored `inProgress: true` describes an update that is no longer running; versions are re-probed at boot.
26607
+ *
26608
+ * See `RuntimeStateDurability`. Enforced by
26609
+ * `scripts/check-runtime-state-durability.ts`.
26610
+ */
26611
+ durability: "session"
26078
26612
  };
26079
26613
  var UserSummarySchema = object({
26080
26614
  id: string(),
@@ -26408,7 +26942,14 @@ var vacuumControlCapability = {
26408
26942
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
26409
26943
  * slice for live state + battery + fan-speed changes.
26410
26944
  */
26411
- runtimeState: VacuumControlStatusSchema
26945
+ runtimeState: VacuumControlStatusSchema,
26946
+ /**
26947
+ * Runtime-state durability: **session** — as `media-player` — a restored `state: cleaning` is a robot that is not cleaning.
26948
+ *
26949
+ * See `RuntimeStateDurability`. Enforced by
26950
+ * `scripts/check-runtime-state-durability.ts`.
26951
+ */
26952
+ durability: "session"
26412
26953
  };
26413
26954
  var ValveStatusSchema = object({
26414
26955
  /** Lifecycle state of the valve. */
@@ -26460,7 +27001,14 @@ var valveCapability = {
26460
27001
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
26461
27002
  * slice for live position changes during a move.
26462
27003
  */
26463
- runtimeState: ValveStatusSchema
27004
+ runtimeState: ValveStatusSchema,
27005
+ /**
27006
+ * Runtime-state durability: **session** — as `brightness`.
27007
+ *
27008
+ * See `RuntimeStateDurability`. Enforced by
27009
+ * `scripts/check-runtime-state-durability.ts`.
27010
+ */
27011
+ durability: "session"
26464
27012
  };
26465
27013
  /**
26466
27014
  * Vibration / shake / impact sensor. Drives Home Assistant
@@ -26482,7 +27030,17 @@ var vibrationCapability = {
26482
27030
  schema: VibrationStatusSchema,
26483
27031
  kind: "push"
26484
27032
  },
26485
- runtimeState: VibrationStatusSchema
27033
+ runtimeState: VibrationStatusSchema,
27034
+ /**
27035
+ * Runtime-state durability: **restored** — as `smoke`.
27036
+ *
27037
+ * See `RuntimeStateDurability`. Enforced by
27038
+ * `scripts/check-runtime-state-durability.ts`.
27039
+ */
27040
+ durability: "restored",
27041
+ /** Clock fields: written, but excluded from the compare that decides
27042
+ * whether persisting is worth a SQLite commit. */
27043
+ volatileStateFields: ["lastChangedAt"]
26486
27044
  };
26487
27045
  /**
26488
27046
  * Water heater / boiler cap. Models HA `water_heater.*` entities — a
@@ -26556,7 +27114,14 @@ var waterHeaterCapability = {
26556
27114
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
26557
27115
  * slice for live temperature / mode / away changes.
26558
27116
  */
26559
- runtimeState: WaterHeaterStatusSchema
27117
+ runtimeState: WaterHeaterStatusSchema,
27118
+ /**
27119
+ * Runtime-state durability: **session** — as `climate-control`.
27120
+ *
27121
+ * See `RuntimeStateDurability`. Enforced by
27122
+ * `scripts/check-runtime-state-durability.ts`.
27123
+ */
27124
+ durability: "session"
26560
27125
  };
26561
27126
  /**
26562
27127
  * Weather provider cap. Models HA `weather.*` entities — a read-only
@@ -26615,7 +27180,14 @@ var weatherCapability = {
26615
27180
  * Runtime-state slice — mirrored by the kernel. The UI reads the
26616
27181
  * current conditions directly from the slice on each weather push.
26617
27182
  */
26618
- runtimeState: WeatherStatusSchema
27183
+ runtimeState: WeatherStatusSchema,
27184
+ /**
27185
+ * Runtime-state durability: **session** — a forecast is stale the moment the hub is down; the provider re-fetches on connect.
27186
+ *
27187
+ * See `RuntimeStateDurability`. Enforced by
27188
+ * `scripts/check-runtime-state-durability.ts`.
27189
+ */
27190
+ durability: "session"
26619
27191
  };
26620
27192
  /**
26621
27193
  * Per-zone occupancy aggregation produced by the analytics frame
@@ -26777,7 +27349,14 @@ var zoneAnalyticsCapability = {
26777
27349
  * automatically; the explicit `getCurrentSnapshot` cap method is
26778
27350
  * still useful for one-off polls without a subscription.
26779
27351
  */
26780
- runtimeState: CameraOccupancySnapshotSchema
27352
+ runtimeState: CameraOccupancySnapshotSchema,
27353
+ /**
27354
+ * Runtime-state durability: **session** — per-frame analytics; with `audio-metrics` it is ~90 % of the offered write rate. Re-derived on the next frame.
27355
+ *
27356
+ * See `RuntimeStateDurability`. Enforced by
27357
+ * `scripts/check-runtime-state-durability.ts`.
27358
+ */
27359
+ durability: "session"
26781
27360
  };
26782
27361
  /**
26783
27362
  * Stages a {@link ZoneRule} can apply to. Discriminator on the rules
@@ -26855,7 +27434,14 @@ var zoneRulesCapability = {
26855
27434
  motion: array(ZoneRuleSchema).readonly(),
26856
27435
  detection: array(ZoneRuleSchema).readonly(),
26857
27436
  package: array(ZoneRuleSchema).readonly()
26858
- })
27437
+ }),
27438
+ /**
27439
+ * Runtime-state durability: **restored** — operator intent, mutation-only, same argument as `zones`.
27440
+ *
27441
+ * See `RuntimeStateDurability`. Enforced by
27442
+ * `scripts/check-runtime-state-durability.ts`.
27443
+ */
27444
+ durability: "restored"
26859
27445
  };
26860
27446
  /**
26861
27447
  * Accessory device helpers — shared across drivers.
@@ -33542,6 +34128,7 @@ Object.freeze({
33542
34128
  "network-access": "ingress",
33543
34129
  "smtp-provider": "email"
33544
34130
  });
34131
+ new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
33545
34132
  new Set(["devices", "classes"]);
33546
34133
  /**
33547
34134
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.