@camstack/addon-provider-ecowitt 0.2.14 → 0.2.15

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.mjs CHANGED
@@ -10773,7 +10773,14 @@ var cameraStreamsCapability = {
10773
10773
  low: string().optional()
10774
10774
  }),
10775
10775
  lastChangedAt: number()
10776
- })
10776
+ }),
10777
+ /**
10778
+ * 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.
10779
+ *
10780
+ * See `RuntimeStateDurability`. Enforced by
10781
+ * `scripts/check-runtime-state-durability.ts`.
10782
+ */
10783
+ durability: "session"
10777
10784
  };
10778
10785
  /** Where a block runs. The operator chooses — a block driving a device on an
10779
10786
  * agent is the reason placement is not fixed to the hub. */
@@ -11334,6 +11341,13 @@ var deviceDiscoveryCapability = {
11334
11341
  kind: "poll"
11335
11342
  },
11336
11343
  runtimeState: DeviceDiscoveryStatusSchema.extend({ lastFetchedAt: number().int().nonnegative() }),
11344
+ /**
11345
+ * Runtime-state durability: **session** — 5.7 KB of scan output on the largest device, fully re-derivable by re-scanning.
11346
+ *
11347
+ * See `RuntimeStateDurability`. Enforced by
11348
+ * `scripts/check-runtime-state-durability.ts`.
11349
+ */
11350
+ durability: "session",
11337
11351
  methods: {
11338
11352
  /**
11339
11353
  * Snapshot of the current `discovered` list. Returns the
@@ -13233,7 +13247,23 @@ var NotificationActionSchema = object({
13233
13247
  * else — see `notification-center/action-token.ts` for what that does and
13234
13248
  * does not buy.
13235
13249
  */
13236
- destructive: boolean().optional()
13250
+ destructive: boolean().optional(),
13251
+ /**
13252
+ * How the tap should REACH the url.
13253
+ *
13254
+ * `navigate` (absent, and every button authored before this field) opens it:
13255
+ * the phone leaves the notification and shows whatever the callback returns.
13256
+ * That is right for a button whose answer the operator wants to read.
13257
+ *
13258
+ * `background` fires it as a POST and stays put. It exists for the buttons
13259
+ * whose whole point is not to interrupt — "silence this for 30 minutes" is
13260
+ * an answer to the notification, and being thrown into a browser tab to
13261
+ * confirm it costs more attention than the notification did. A backend that
13262
+ * cannot do a background call renders it as an ordinary link (the adapters
13263
+ * fall back rather than dropping the button), so this is a preference, never
13264
+ * a requirement.
13265
+ */
13266
+ mode: _enum(["navigate", "background"]).optional()
13237
13267
  });
13238
13268
  /**
13239
13269
  * The canonical notification. `body` is the only hard field (Apprise model).
@@ -14085,7 +14115,17 @@ var alarmPanelCapability = {
14085
14115
  * full slice; renders an arm button per `availableModes` entry and
14086
14116
  * a PIN field iff `requiresCode === true`.
14087
14117
  */
14088
- runtimeState: AlarmPanelStatusSchema
14118
+ runtimeState: AlarmPanelStatusSchema,
14119
+ /**
14120
+ * Runtime-state durability: **restored** — armed state is the one thing a panel must not lose across a restart.
14121
+ *
14122
+ * See `RuntimeStateDurability`. Enforced by
14123
+ * `scripts/check-runtime-state-durability.ts`.
14124
+ */
14125
+ durability: "restored",
14126
+ /** Clock fields: written, but excluded from the compare that decides
14127
+ * whether persisting is worth a SQLite commit. */
14128
+ volatileStateFields: ["lastChangedAt"]
14089
14129
  };
14090
14130
  /**
14091
14131
  * Shared geometry vocabulary for on-frame shape caps — privacy-mask,
@@ -14262,6 +14302,9 @@ var NcSystemEventConditionSchema = object({
14262
14302
  nodeIds: array(string().min(1)).min(1).optional(),
14263
14303
  packageNames: array(string().min(1)).min(1).optional()
14264
14304
  });
14305
+ /** Hard ceiling on a window (24h). A snooze that could not expire would be an
14306
+ * outage the operator asked for once and forgot. */
14307
+ var NC_SNOOZE_MAX_MINUTES = 1440;
14265
14308
  /** Weekly schedule — OR of windows; absence on the rule = always active. */
14266
14309
  var NcScheduleSchema = object({
14267
14310
  windows: array(object({
@@ -14638,15 +14681,15 @@ var NcConditionsSchema = object({
14638
14681
  * (an `immediate` rule naming an `audio-*` class, one notification per
14639
14682
  * classified sample) stays exactly as it was for rules that already use it.
14640
14683
  *
14641
- * NOT in {@link NC_CONDITION_CATALOG} yet, and that is the sequencing rule
14642
- * rather than an oversight: the viewer mirrors the descriptor enums BY HAND
14643
- * (`camstack/src/data/notification-center.ts`, guarded by
14644
- * `scripts/check-viewer-condition-mirror.ts`) and its rule editor STRIPS the
14684
+ * In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
14685
+ * rule rather than an accident: the viewer mirrors the descriptor enums BY
14686
+ * HAND (`camstack/src/data/notification-center.ts`, guarded by
14687
+ * `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
14645
14688
  * condition fields it does not know when a rule is saved from the phone.
14646
14689
  * Publishing an editor for a condition the app cannot round-trip is how an
14647
- * operator loses a rule's conditions by opening it — so the descriptor, the
14648
- * admin widget and the viewer mirror land together (P2 + P3), and only then
14649
- * does an audio rule become authorable.
14690
+ * operator loses a rule's conditions by opening it — so the viewer mirror
14691
+ * (P3, shipped) went FIRST, and the descriptor an editor renders from
14692
+ * follows here.
14650
14693
  */
14651
14694
  audio: NcAudioConditionSchema.optional()
14652
14695
  });
@@ -14882,6 +14925,30 @@ var NcRuleInputSchema = object({
14882
14925
  */
14883
14926
  snoozeAllowGlobal: boolean().optional(),
14884
14927
  /**
14928
+ * The snooze durations THIS rule's notification offers as buttons, in
14929
+ * minutes.
14930
+ *
14931
+ * Three states, and all three are distinct — which is exactly why this is
14932
+ * `.optional()` and never `.default()`. A Zod default does not run on the
14933
+ * addon cap path (three production failures in one day), so a schema default
14934
+ * would collapse the first two:
14935
+ *
14936
+ * | value | meaning |
14937
+ * | --- | --- |
14938
+ * | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
14939
+ * | `[]` | **no snooze buttons on this rule** — the explicit override |
14940
+ * | a list | these choices, de-duplicated and sorted, at most four |
14941
+ *
14942
+ * `.max(4)` because the notifier's own action budget is small (ntfy allows
14943
+ * three buttons in total) and a rule that spent it all on snooze choices
14944
+ * would push its own tap-through actions off the notification.
14945
+ *
14946
+ * An empty list is NOT an alarm exemption: a rule the alarm is about, or
14947
+ * that arms the panel, is exempt automatically and cannot be silenced by a
14948
+ * window from anywhere (D133).
14949
+ */
14950
+ snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
14951
+ /**
14885
14952
  * Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
14886
14953
  *
14887
14954
  * This is what makes the rule set the alarm's trigger set without the alarm
@@ -14981,6 +15048,7 @@ var NcConditionDescriptorSchema = object({
14981
15048
  "device",
14982
15049
  "package",
14983
15050
  "occupancy",
15051
+ "audio",
14984
15052
  "system"
14985
15053
  ]),
14986
15054
  label: string(),
@@ -14999,6 +15067,7 @@ var NcConditionDescriptorSchema = object({
14999
15067
  "crossingSelect",
15000
15068
  "polygonDraw",
15001
15069
  "occupancy",
15070
+ "audio",
15002
15071
  "deviceState",
15003
15072
  "systemEvent"
15004
15073
  ]),
@@ -15150,7 +15219,20 @@ var NcSnoozeInputSchema = object({
15150
15219
  ruleId: string().optional(),
15151
15220
  /** Required when `scope: 'device'`. */
15152
15221
  deviceId: number().int().optional(),
15153
- durationMinutes: number().int().min(1).max(1440),
15222
+ /**
15223
+ * Narrow the window to these subject classes — "the cat, not the person".
15224
+ *
15225
+ * ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
15226
+ * what every window authored before this field meant, so no persisted row
15227
+ * changes meaning and no client has to learn anything to keep working.
15228
+ *
15229
+ * It is what makes the window's real key `(deviceId, classes[])` and lets it
15230
+ * cross rules (D133): the operator points at a camera and a kind of thing,
15231
+ * not at whichever of their four rules happened to produce the notification
15232
+ * they are dismissing.
15233
+ */
15234
+ classes: array(string().min(1)).min(1).optional(),
15235
+ durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
15154
15236
  /**
15155
15237
  * Silence this for EVERY recipient, not just the caller. Permission is
15156
15238
  * checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
@@ -15175,6 +15257,10 @@ var NcSnoozeSchema = object({
15175
15257
  scope: NcSnoozeScopeSchema,
15176
15258
  ruleId: string().optional(),
15177
15259
  deviceId: number().int().optional(),
15260
+ /** Subject classes this window covers. ABSENT = every class — see
15261
+ * {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
15262
+ * no SQLite column: nothing queries a window by class. */
15263
+ classes: array(string().min(1)).min(1).optional(),
15178
15264
  startedAt: number(),
15179
15265
  /** Exclusive: at exactly this instant the snooze is over. Expiry is a
15180
15266
  * COMPARISON, not a job — no sweeper can leave the operator silenced. */
@@ -17275,7 +17361,14 @@ var zonesCapability = {
17275
17361
  * handle. Slice shape is `{ zones: Zone[] }` so future extensions
17276
17362
  * (e.g. zone groupings) can sit alongside the polygon list.
17277
17363
  */
17278
- runtimeState: object({ zones: array(ZoneSchema).readonly() })
17364
+ runtimeState: object({ zones: array(ZoneSchema).readonly() }),
17365
+ /**
17366
+ * 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.
17367
+ *
17368
+ * See `RuntimeStateDurability`. Enforced by
17369
+ * `scripts/check-runtime-state-durability.ts`.
17370
+ */
17371
+ durability: "restored"
17279
17372
  };
17280
17373
  /**
17281
17374
  * A bounding box in NORMALIZED [0,1] frame coordinates for `getNativeCrop`. The
@@ -20074,7 +20167,17 @@ var airQualitySensorCapability = {
20074
20167
  schema: AirQualitySensorStatusSchema,
20075
20168
  kind: "push"
20076
20169
  },
20077
- runtimeState: AirQualitySensorStatusSchema
20170
+ runtimeState: AirQualitySensorStatusSchema,
20171
+ /**
20172
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
20173
+ *
20174
+ * See `RuntimeStateDurability`. Enforced by
20175
+ * `scripts/check-runtime-state-durability.ts`.
20176
+ */
20177
+ durability: "restored",
20178
+ /** Clock fields: written, but excluded from the compare that decides
20179
+ * whether persisting is worth a SQLite commit. */
20180
+ volatileStateFields: ["lastFetchedAt"]
20078
20181
  };
20079
20182
  /**
20080
20183
  * Ambient illuminance reading in lux. Drives Home Assistant `sensor`
@@ -20106,7 +20209,17 @@ var ambientLightSensorCapability = {
20106
20209
  schema: AmbientLightSensorStatusSchema,
20107
20210
  kind: "push"
20108
20211
  },
20109
- runtimeState: AmbientLightSensorStatusSchema
20212
+ runtimeState: AmbientLightSensorStatusSchema,
20213
+ /**
20214
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
20215
+ *
20216
+ * See `RuntimeStateDurability`. Enforced by
20217
+ * `scripts/check-runtime-state-durability.ts`.
20218
+ */
20219
+ durability: "restored",
20220
+ /** Clock fields: written, but excluded from the compare that decides
20221
+ * whether persisting is worth a SQLite commit. */
20222
+ volatileStateFields: ["lastFetchedAt"]
20110
20223
  };
20111
20224
  /**
20112
20225
  * Per-class audio metrics aggregated over a sliding window.
@@ -20224,7 +20337,14 @@ var audioMetricsCapability = {
20224
20337
  }), AudioMetricsHistorySchema)
20225
20338
  },
20226
20339
  /** Reactive runtime-state mirror — live `device.state.audioMetrics.value`. */
20227
- runtimeState: AudioMetricsSnapshotSchema
20340
+ runtimeState: AudioMetricsSnapshotSchema,
20341
+ /**
20342
+ * 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.
20343
+ *
20344
+ * See `RuntimeStateDurability`. Enforced by
20345
+ * `scripts/check-runtime-state-durability.ts`.
20346
+ */
20347
+ durability: "session"
20228
20348
  };
20229
20349
  /**
20230
20350
  * Automation-control cap. Models HA `automation.*` entities on
@@ -20286,7 +20406,14 @@ var automationControlCapability = {
20286
20406
  * reads `enabled` (toggle) + `isRunning` (spinner) + `lastError`
20287
20407
  * (badge) directly.
20288
20408
  */
20289
- runtimeState: AutomationControlStatusSchema
20409
+ runtimeState: AutomationControlStatusSchema,
20410
+ /**
20411
+ * 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.
20412
+ *
20413
+ * See `RuntimeStateDurability`. Enforced by
20414
+ * `scripts/check-runtime-state-durability.ts`.
20415
+ */
20416
+ durability: "session"
20290
20417
  };
20291
20418
  /**
20292
20419
  * Battery status snapshot. Emitted by providers whose device is
@@ -20392,7 +20519,17 @@ onStatusChanged: { data: object({
20392
20519
  * via `device.runtimeState.getCapState('battery')` regardless of
20393
20520
  * the underlying driver.
20394
20521
  */
20395
- runtimeState: BatteryStatusSchema
20522
+ runtimeState: BatteryStatusSchema,
20523
+ /**
20524
+ * 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.
20525
+ *
20526
+ * See `RuntimeStateDurability`. Enforced by
20527
+ * `scripts/check-runtime-state-durability.ts`.
20528
+ */
20529
+ durability: "restored",
20530
+ /** Clock fields: written, but excluded from the compare that decides
20531
+ * whether persisting is worth a SQLite commit. */
20532
+ volatileStateFields: ["lastUpdated"]
20396
20533
  };
20397
20534
  /**
20398
20535
  * Generic boolean sensor — last-resort fallback when no domain-
@@ -20421,7 +20558,17 @@ var binaryCapability = {
20421
20558
  schema: BinaryStatusSchema,
20422
20559
  kind: "push"
20423
20560
  },
20424
- runtimeState: BinaryStatusSchema
20561
+ runtimeState: BinaryStatusSchema,
20562
+ /**
20563
+ * Runtime-state durability: **restored** — transition-driven sensor state; the restored value gives the boot comparison.
20564
+ *
20565
+ * See `RuntimeStateDurability`. Enforced by
20566
+ * `scripts/check-runtime-state-durability.ts`.
20567
+ */
20568
+ durability: "restored",
20569
+ /** Clock fields: written, but excluded from the compare that decides
20570
+ * whether persisting is worth a SQLite commit. */
20571
+ volatileStateFields: ["lastChangedAt"]
20425
20572
  };
20426
20573
  /**
20427
20574
  * Dimmable-light brightness control. Co-exists with `switch` on the
@@ -20474,7 +20621,14 @@ onBrightnessChanged: { data: object({
20474
20621
  * by the kernel. Read via `device.state.brightness.value` so UI
20475
20622
  * sliders surface the current level without polling the provider.
20476
20623
  */
20477
- runtimeState: BrightnessStatusSchema
20624
+ runtimeState: BrightnessStatusSchema,
20625
+ /**
20626
+ * Runtime-state durability: **session** — live lamp state, re-published by the provider on connect.
20627
+ *
20628
+ * See `RuntimeStateDurability`. Enforced by
20629
+ * `scripts/check-runtime-state-durability.ts`.
20630
+ */
20631
+ durability: "session"
20478
20632
  };
20479
20633
  DeviceType.Button, method(object({ deviceId: number().int().nonnegative() }), _void(), {
20480
20634
  kind: "mutation",
@@ -20562,7 +20716,17 @@ var carbonMonoxideCapability = {
20562
20716
  schema: CarbonMonoxideStatusSchema,
20563
20717
  kind: "push"
20564
20718
  },
20565
- runtimeState: CarbonMonoxideStatusSchema
20719
+ runtimeState: CarbonMonoxideStatusSchema,
20720
+ /**
20721
+ * Runtime-state durability: **restored** — as `smoke`.
20722
+ *
20723
+ * See `RuntimeStateDurability`. Enforced by
20724
+ * `scripts/check-runtime-state-durability.ts`.
20725
+ */
20726
+ durability: "restored",
20727
+ /** Clock fields: written, but excluded from the compare that decides
20728
+ * whether persisting is worth a SQLite commit. */
20729
+ volatileStateFields: ["lastChangedAt"]
20566
20730
  };
20567
20731
  /**
20568
20732
  * HVAC / climate control cap. Models the full surface of a HA
@@ -20722,7 +20886,14 @@ var climateControlCapability = {
20722
20886
  * the full slice via `device.state.climate-control.value` and refresh
20723
20887
  * on every push without re-querying the provider.
20724
20888
  */
20725
- runtimeState: ClimateControlStatusSchema
20889
+ runtimeState: ClimateControlStatusSchema,
20890
+ /**
20891
+ * Runtime-state durability: **session** — as `brightness`; `currentTemp` moves continuously and is re-published on connect.
20892
+ *
20893
+ * See `RuntimeStateDurability`. Enforced by
20894
+ * `scripts/check-runtime-state-durability.ts`.
20895
+ */
20896
+ durability: "session"
20726
20897
  };
20727
20898
  /**
20728
20899
  * Color-light cap. Coexists with `switch` (on/off) and `brightness`
@@ -20832,7 +21003,14 @@ onColorChanged: { data: object({
20832
21003
  * kernel. Read via `device.state.color.value` so UI pickers surface
20833
21004
  * the current chromaticity without polling the provider.
20834
21005
  */
20835
- runtimeState: ColorStatusSchema
21006
+ runtimeState: ColorStatusSchema,
21007
+ /**
21008
+ * Runtime-state durability: **session** — as `brightness`.
21009
+ *
21010
+ * See `RuntimeStateDurability`. Enforced by
21011
+ * `scripts/check-runtime-state-durability.ts`.
21012
+ */
21013
+ durability: "session"
20836
21014
  };
20837
21015
  var ConnectionTestOutcomeSchema = discriminatedUnion("outcome", [
20838
21016
  object({
@@ -20890,7 +21068,17 @@ var connectivityCapability = {
20890
21068
  schema: ConnectivityStatusSchema,
20891
21069
  kind: "push"
20892
21070
  },
20893
- runtimeState: ConnectivityStatusSchema
21071
+ runtimeState: ConnectivityStatusSchema,
21072
+ /**
21073
+ * Runtime-state durability: **restored** — same shape and same argument as `device-status`, for links rather than devices.
21074
+ *
21075
+ * See `RuntimeStateDurability`. Enforced by
21076
+ * `scripts/check-runtime-state-durability.ts`.
21077
+ */
21078
+ durability: "restored",
21079
+ /** Clock fields: written, but excluded from the compare that decides
21080
+ * whether persisting is worth a SQLite commit. */
21081
+ volatileStateFields: ["lastChangedAt"]
20894
21082
  };
20895
21083
  /**
20896
21084
  * Generic device-consumables capability — surfaces a device's
@@ -20972,7 +21160,14 @@ reset: method(object({
20972
21160
  }
20973
21161
  }
20974
21162
  },
20975
- runtimeState: ConsumablesStatusSchema.extend({ lastFetchedAt: number() })
21163
+ runtimeState: ConsumablesStatusSchema.extend({ lastFetchedAt: number() }),
21164
+ /**
21165
+ * Runtime-state durability: **session** — the authority is the appliance; the provider re-reads the whole item array on connect.
21166
+ *
21167
+ * See `RuntimeStateDurability`. Enforced by
21168
+ * `scripts/check-runtime-state-durability.ts`.
21169
+ */
21170
+ durability: "session"
20976
21171
  };
20977
21172
  /**
20978
21173
  * Door / window / opening / garage / valve contact sensor. Boolean
@@ -21003,7 +21198,17 @@ var contactCapability = {
21003
21198
  schema: ContactStatusSchema,
21004
21199
  kind: "push"
21005
21200
  },
21006
- runtimeState: ContactStatusSchema
21201
+ runtimeState: ContactStatusSchema,
21202
+ /**
21203
+ * Runtime-state durability: **restored** — a door left open across a restart must still read open.
21204
+ *
21205
+ * See `RuntimeStateDurability`. Enforced by
21206
+ * `scripts/check-runtime-state-durability.ts`.
21207
+ */
21208
+ durability: "restored",
21209
+ /** Clock fields: written, but excluded from the compare that decides
21210
+ * whether persisting is worth a SQLite commit. */
21211
+ volatileStateFields: ["lastChangedAt"]
21007
21212
  };
21008
21213
  /**
21009
21214
  * Status slice — flat object (the framework's `runtimeState` contract
@@ -21109,7 +21314,14 @@ var controlCapability = {
21109
21314
  * dropdown / text field / date picker) read the slice's discriminant
21110
21315
  * and value directly without polling the provider.
21111
21316
  */
21112
- runtimeState: ControlStatusSchema
21317
+ runtimeState: ControlStatusSchema,
21318
+ /**
21319
+ * Runtime-state durability: **session** — a generic control mirrors an external entity that re-publishes on connect; the options array is re-derived with it.
21320
+ *
21321
+ * See `RuntimeStateDurability`. Enforced by
21322
+ * `scripts/check-runtime-state-durability.ts`.
21323
+ */
21324
+ durability: "session"
21113
21325
  };
21114
21326
  var CoverStatusSchema = object({
21115
21327
  /** Lifecycle state of the cover. */
@@ -21170,7 +21382,17 @@ var coverCapability = {
21170
21382
  * Runtime-state slice — mirrored by the kernel. UI controls watch
21171
21383
  * the slice for live position changes during a move.
21172
21384
  */
21173
- runtimeState: CoverStatusSchema
21385
+ runtimeState: CoverStatusSchema,
21386
+ /**
21387
+ * Runtime-state durability: **restored** — position survives a restart on the device; the mirror should agree at boot rather than read blank.
21388
+ *
21389
+ * See `RuntimeStateDurability`. Enforced by
21390
+ * `scripts/check-runtime-state-durability.ts`.
21391
+ */
21392
+ durability: "restored",
21393
+ /** Clock fields: written, but excluded from the compare that decides
21394
+ * whether persisting is worth a SQLite commit. */
21395
+ volatileStateFields: ["lastChangedAt"]
21174
21396
  };
21175
21397
  /**
21176
21398
  * Vendor-neutral day/night (IR-cut) control — the per-camera config cap
@@ -21264,7 +21486,17 @@ var dayNightCapability = {
21264
21486
  schema: DayNightStatusSchema,
21265
21487
  kind: "poll"
21266
21488
  },
21267
- runtimeState: DayNightStatusSchema
21489
+ runtimeState: DayNightStatusSchema,
21490
+ /**
21491
+ * Runtime-state durability: **restored** — operator-set IR-cut behaviour; mutation-driven.
21492
+ *
21493
+ * See `RuntimeStateDurability`. Enforced by
21494
+ * `scripts/check-runtime-state-durability.ts`.
21495
+ */
21496
+ durability: "restored",
21497
+ /** Clock fields: written, but excluded from the compare that decides
21498
+ * whether persisting is worth a SQLite commit. */
21499
+ volatileStateFields: ["lastFetchedAt"]
21268
21500
  };
21269
21501
  /**
21270
21502
  * Generic device-level status snapshot. Auto-registered by `BaseDevice`
@@ -21311,7 +21543,17 @@ onStatusChanged: { data: object({
21311
21543
  schema: DeviceStatusSchema,
21312
21544
  kind: "push"
21313
21545
  },
21314
- runtimeState: DeviceStatusSchema
21546
+ runtimeState: DeviceStatusSchema,
21547
+ /**
21548
+ * 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.
21549
+ *
21550
+ * See `RuntimeStateDurability`. Enforced by
21551
+ * `scripts/check-runtime-state-durability.ts`.
21552
+ */
21553
+ durability: "restored",
21554
+ /** Clock fields: written, but excluded from the compare that decides
21555
+ * whether persisting is worth a SQLite commit. */
21556
+ volatileStateFields: ["lastChangedAt"]
21315
21557
  };
21316
21558
  /**
21317
21559
  * Doorbell button cap. Two kinds of providers coexist behind this cap
@@ -21373,7 +21615,14 @@ onPressed: { data: DoorbellPressEventSchema } },
21373
21615
  * `device.state.doorbell.value`. UIs can show "last ring 5m ago"
21374
21616
  * without subscribing.
21375
21617
  */
21376
- runtimeState: DoorbellStatusSchema
21618
+ runtimeState: DoorbellStatusSchema,
21619
+ /**
21620
+ * 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.
21621
+ *
21622
+ * See `RuntimeStateDurability`. Enforced by
21623
+ * `scripts/check-runtime-state-durability.ts`.
21624
+ */
21625
+ durability: "restored"
21377
21626
  };
21378
21627
  /**
21379
21628
  * Enum-state sensor — a string value picked from a finite option set.
@@ -21413,7 +21662,17 @@ var enumSensorCapability = {
21413
21662
  schema: EnumSensorStatusSchema,
21414
21663
  kind: "push"
21415
21664
  },
21416
- runtimeState: EnumSensorStatusSchema
21665
+ runtimeState: EnumSensorStatusSchema,
21666
+ /**
21667
+ * Runtime-state durability: **restored** — as `numeric-sensor`; 80 devices.
21668
+ *
21669
+ * See `RuntimeStateDurability`. Enforced by
21670
+ * `scripts/check-runtime-state-durability.ts`.
21671
+ */
21672
+ durability: "restored",
21673
+ /** Clock fields: written, but excluded from the compare that decides
21674
+ * whether persisting is worth a SQLite commit. */
21675
+ volatileStateFields: ["lastFetchedAt"]
21417
21676
  };
21418
21677
  /**
21419
21678
  * Generic stateless event emitter. Installed on a `DeviceType.EventEmitter`
@@ -21449,7 +21708,14 @@ var eventEmitterCapability = {
21449
21708
  schema: EventEmitterStatusSchema,
21450
21709
  kind: "push"
21451
21710
  },
21452
- runtimeState: EventEmitterStatusSchema
21711
+ runtimeState: EventEmitterStatusSchema,
21712
+ /**
21713
+ * Runtime-state durability: **session** — `eventCountSinceStart` names its own scope.
21714
+ *
21715
+ * See `RuntimeStateDurability`. Enforced by
21716
+ * `scripts/check-runtime-state-durability.ts`.
21717
+ */
21718
+ durability: "session"
21453
21719
  };
21454
21720
  var EventItemSchema = object({
21455
21721
  id: string(),
@@ -21730,7 +21996,14 @@ var fanControlCapability = {
21730
21996
  * Runtime-state slice — mirrored by the kernel. UI fan speed
21731
21997
  * sliders read `percentage` for live updates.
21732
21998
  */
21733
- runtimeState: FanControlStatusSchema
21999
+ runtimeState: FanControlStatusSchema,
22000
+ /**
22001
+ * Runtime-state durability: **session** — as `brightness`.
22002
+ *
22003
+ * See `RuntimeStateDurability`. Enforced by
22004
+ * `scripts/check-runtime-state-durability.ts`.
22005
+ */
22006
+ durability: "session"
21734
22007
  };
21735
22008
  /**
21736
22009
  * Per-device feature/identity probe slice. Holds the runtime-resolved
@@ -21806,7 +22079,14 @@ onProbeChanged: { data: object({
21806
22079
  schema: FeatureProbeStatusSchema,
21807
22080
  kind: "push"
21808
22081
  },
21809
- runtimeState: FeatureProbeStatusSchema
22082
+ runtimeState: FeatureProbeStatusSchema,
22083
+ /**
22084
+ * 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.
22085
+ *
22086
+ * See `RuntimeStateDurability`. Enforced by
22087
+ * `scripts/check-runtime-state-durability.ts`.
22088
+ */
22089
+ durability: "session"
21810
22090
  };
21811
22091
  /**
21812
22092
  * Water leak / moisture sensor. Boolean "is liquid currently
@@ -21833,7 +22113,17 @@ var floodCapability = {
21833
22113
  schema: FloodStatusSchema,
21834
22114
  kind: "push"
21835
22115
  },
21836
- runtimeState: FloodStatusSchema
22116
+ runtimeState: FloodStatusSchema,
22117
+ /**
22118
+ * Runtime-state durability: **restored** — as `smoke`.
22119
+ *
22120
+ * See `RuntimeStateDurability`. Enforced by
22121
+ * `scripts/check-runtime-state-durability.ts`.
22122
+ */
22123
+ durability: "restored",
22124
+ /** Clock fields: written, but excluded from the compare that decides
22125
+ * whether persisting is worth a SQLite commit. */
22126
+ volatileStateFields: ["lastChangedAt"]
21837
22127
  };
21838
22128
  /**
21839
22129
  * Combustible-gas (LPG / methane / hydrogen) alarm sensor. Drives
@@ -21856,7 +22146,17 @@ var gasCapability = {
21856
22146
  schema: GasStatusSchema,
21857
22147
  kind: "push"
21858
22148
  },
21859
- runtimeState: GasStatusSchema
22149
+ runtimeState: GasStatusSchema,
22150
+ /**
22151
+ * Runtime-state durability: **restored** — as `smoke`.
22152
+ *
22153
+ * See `RuntimeStateDurability`. Enforced by
22154
+ * `scripts/check-runtime-state-durability.ts`.
22155
+ */
22156
+ durability: "restored",
22157
+ /** Clock fields: written, but excluded from the compare that decides
22158
+ * whether persisting is worth a SQLite commit. */
22159
+ volatileStateFields: ["lastChangedAt"]
21860
22160
  };
21861
22161
  /**
21862
22162
  * Humidifier / dehumidifier cap. Models HA `humidifier.*` entities —
@@ -21932,7 +22232,14 @@ var humidifierCapability = {
21932
22232
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
21933
22233
  * slice for live humidity / mode changes.
21934
22234
  */
21935
- runtimeState: HumidifierStatusSchema
22235
+ runtimeState: HumidifierStatusSchema,
22236
+ /**
22237
+ * Runtime-state durability: **session** — as `climate-control`.
22238
+ *
22239
+ * See `RuntimeStateDurability`. Enforced by
22240
+ * `scripts/check-runtime-state-durability.ts`.
22241
+ */
22242
+ durability: "session"
21936
22243
  };
21937
22244
  /**
21938
22245
  * Single-metric humidity reading. Drives Home Assistant `sensor`
@@ -21968,7 +22275,17 @@ var humiditySensorCapability = {
21968
22275
  schema: HumiditySensorStatusSchema,
21969
22276
  kind: "push"
21970
22277
  },
21971
- runtimeState: HumiditySensorStatusSchema
22278
+ runtimeState: HumiditySensorStatusSchema,
22279
+ /**
22280
+ * Runtime-state durability: **restored** — as `numeric-sensor` (67 of 75 writes were the clock alone).
22281
+ *
22282
+ * See `RuntimeStateDurability`. Enforced by
22283
+ * `scripts/check-runtime-state-durability.ts`.
22284
+ */
22285
+ durability: "restored",
22286
+ /** Clock fields: written, but excluded from the compare that decides
22287
+ * whether persisting is worth a SQLite commit. */
22288
+ volatileStateFields: ["lastFetchedAt"]
21972
22289
  };
21973
22290
  /**
21974
22291
  * Image display cap. Models a single still image exposed by an integration —
@@ -22006,7 +22323,14 @@ var imageCapability = {
22006
22323
  * Runtime-state slice — mirrored by the kernel. The UI reads `url`
22007
22324
  * directly and renders the still image.
22008
22325
  */
22009
- runtimeState: ImageStatusSchema
22326
+ runtimeState: ImageStatusSchema,
22327
+ /**
22328
+ * Runtime-state durability: **session** — a snapshot URL is a session-scoped handle; a restored one points at nothing.
22329
+ *
22330
+ * See `RuntimeStateDurability`. Enforced by
22331
+ * `scripts/check-runtime-state-durability.ts`.
22332
+ */
22333
+ durability: "session"
22010
22334
  };
22011
22335
  /**
22012
22336
  * Vendor-neutral image / picture-adjustment cap — the per-camera config
@@ -22155,7 +22479,17 @@ var imageSettingsCapability = {
22155
22479
  schema: ImageSettingsStatusSchema,
22156
22480
  kind: "poll"
22157
22481
  },
22158
- runtimeState: ImageSettingsStatusSchema
22482
+ runtimeState: ImageSettingsStatusSchema,
22483
+ /**
22484
+ * Runtime-state durability: **restored** — operator-set camera imaging; mutation-driven.
22485
+ *
22486
+ * See `RuntimeStateDurability`. Enforced by
22487
+ * `scripts/check-runtime-state-durability.ts`.
22488
+ */
22489
+ durability: "restored",
22490
+ /** Clock fields: written, but excluded from the compare that decides
22491
+ * whether persisting is worth a SQLite commit. */
22492
+ volatileStateFields: ["lastFetchedAt"]
22159
22493
  };
22160
22494
  /**
22161
22495
  * integrations — system-scoped singleton capability for integration
@@ -22495,7 +22829,14 @@ var lawnMowerControlCapability = {
22495
22829
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
22496
22830
  * slice for live activity + battery changes.
22497
22831
  */
22498
- runtimeState: LawnMowerControlStatusSchema
22832
+ runtimeState: LawnMowerControlStatusSchema,
22833
+ /**
22834
+ * Runtime-state durability: **session** — as `vacuum-control`.
22835
+ *
22836
+ * See `RuntimeStateDurability`. Enforced by
22837
+ * `scripts/check-runtime-state-durability.ts`.
22838
+ */
22839
+ durability: "session"
22499
22840
  };
22500
22841
  /**
22501
22842
  * local-network — hub-only singleton.
@@ -22701,7 +23042,17 @@ var lockControlCapability = {
22701
23042
  * read `state` and disable themselves during `locking`/`unlocking`
22702
23043
  * transitions.
22703
23044
  */
22704
- runtimeState: LockControlStatusSchema
23045
+ runtimeState: LockControlStatusSchema,
23046
+ /**
23047
+ * Runtime-state durability: **restored** — a lock left locked must still read locked.
23048
+ *
23049
+ * See `RuntimeStateDurability`. Enforced by
23050
+ * `scripts/check-runtime-state-durability.ts`.
23051
+ */
23052
+ durability: "restored",
23053
+ /** Clock fields: written, but excluded from the compare that decides
23054
+ * whether persisting is worth a SQLite commit. */
23055
+ volatileStateFields: ["lastChangedAt"]
22705
23056
  };
22706
23057
  /**
22707
23058
  * Media-player cap. Models HA `media_player.*` (Sonos, Chromecast,
@@ -22863,7 +23214,14 @@ var mediaPlayerCapability = {
22863
23214
  * full slice for live now-playing, volume, and progress updates
22864
23215
  * without polling.
22865
23216
  */
22866
- runtimeState: MediaPlayerStatusSchema
23217
+ runtimeState: MediaPlayerStatusSchema,
23218
+ /**
23219
+ * Runtime-state durability: **session** — a restored transport position describes a playback that stopped when the hub did.
23220
+ *
23221
+ * See `RuntimeStateDurability`. Enforced by
23222
+ * `scripts/check-runtime-state-durability.ts`.
23223
+ */
23224
+ durability: "session"
22867
23225
  };
22868
23226
  /**
22869
23227
  * mesh-network — collection cap for mesh-VPN providers.
@@ -23127,7 +23485,14 @@ onMotionChanged: { data: MotionOnMotionChangedDataSchema } },
23127
23485
  * `device.state.motion.value`. Reads never invoke the provider, so
23128
23486
  * UIs and other addons can poll the cached state safely.
23129
23487
  */
23130
- runtimeState: MotionStatusSchema
23488
+ runtimeState: MotionStatusSchema,
23489
+ /**
23490
+ * 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.
23491
+ *
23492
+ * See `RuntimeStateDurability`. Enforced by
23493
+ * `scripts/check-runtime-state-durability.ts`.
23494
+ */
23495
+ durability: "session"
23131
23496
  };
23132
23497
  /**
23133
23498
  * Motion-trigger toggle for accessory devices.
@@ -23192,7 +23557,14 @@ var motionTriggerCapability = {
23192
23557
  schema: MotionTriggerStatusSchema,
23193
23558
  kind: "command-driven"
23194
23559
  },
23195
- runtimeState: MotionTriggerRuntimeStateSchema
23560
+ runtimeState: MotionTriggerRuntimeStateSchema,
23561
+ /**
23562
+ * 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.
23563
+ *
23564
+ * See `RuntimeStateDurability`. Enforced by
23565
+ * `scripts/check-runtime-state-durability.ts`.
23566
+ */
23567
+ durability: "session"
23196
23568
  };
23197
23569
  /**
23198
23570
  * Motion-zones share the same MaskShape vocabulary as privacy-mask — the
@@ -23259,7 +23631,17 @@ var motionZonesCapability = {
23259
23631
  schema: MotionZoneStatusSchema,
23260
23632
  kind: "poll"
23261
23633
  },
23262
- runtimeState: MotionZoneStatusSchema
23634
+ runtimeState: MotionZoneStatusSchema,
23635
+ /**
23636
+ * 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.
23637
+ *
23638
+ * See `RuntimeStateDurability`. Enforced by
23639
+ * `scripts/check-runtime-state-durability.ts`.
23640
+ */
23641
+ durability: "restored",
23642
+ /** Clock fields: written, but excluded from the compare that decides
23643
+ * whether persisting is worth a SQLite commit. */
23644
+ volatileStateFields: ["lastFetchedAt"]
23263
23645
  };
23264
23646
  /**
23265
23647
  * On-camera AI object detection cap. Surfaces per-device the classes
@@ -23333,7 +23715,17 @@ var nativeObjectDetectionCapability = {
23333
23715
  schema: NativeObjectDetectionStatusSchema,
23334
23716
  kind: "push"
23335
23717
  },
23336
- runtimeState: NativeObjectDetectionRuntimeStateSchema
23718
+ runtimeState: NativeObjectDetectionRuntimeStateSchema,
23719
+ /**
23720
+ * 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.
23721
+ *
23722
+ * See `RuntimeStateDurability`. Enforced by
23723
+ * `scripts/check-runtime-state-durability.ts`.
23724
+ */
23725
+ durability: "restored",
23726
+ /** Clock fields: written, but excluded from the compare that decides
23727
+ * whether persisting is worth a SQLite commit. */
23728
+ volatileStateFields: ["lastFetchedAt"]
23337
23729
  };
23338
23730
  /**
23339
23731
  * network-quality — system-scoped singleton capability tracking RTT,
@@ -23667,7 +24059,14 @@ onSent: { data: object({
23667
24059
  * form reads `supports` to gate optional fields; history pane reads
23668
24060
  * `lastSentAt` / `lastError` / `queueDepth`.
23669
24061
  */
23670
- runtimeState: NotifierStatusSchema
24062
+ runtimeState: NotifierStatusSchema,
24063
+ /**
24064
+ * Runtime-state durability: **session** — live queue depth and last-send state; a restored queue depth describes a queue that no longer exists.
24065
+ *
24066
+ * See `RuntimeStateDurability`. Enforced by
24067
+ * `scripts/check-runtime-state-durability.ts`.
24068
+ */
24069
+ durability: "session"
23671
24070
  };
23672
24071
  /**
23673
24072
  * Generic numeric sensor — last-resort fallback when no typed numeric
@@ -23710,7 +24109,17 @@ var numericSensorCapability = {
23710
24109
  schema: NumericSensorStatusSchema,
23711
24110
  kind: "push"
23712
24111
  },
23713
- runtimeState: NumericSensorStatusSchema
24112
+ runtimeState: NumericSensorStatusSchema,
24113
+ /**
24114
+ * 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.
24115
+ *
24116
+ * See `RuntimeStateDurability`. Enforced by
24117
+ * `scripts/check-runtime-state-durability.ts`.
24118
+ */
24119
+ durability: "restored",
24120
+ /** Clock fields: written, but excluded from the compare that decides
24121
+ * whether persisting is worth a SQLite commit. */
24122
+ volatileStateFields: ["lastFetchedAt"]
23714
24123
  };
23715
24124
  /**
23716
24125
  * Generic on-screen-display (video overlay) cap. Each camera exposes
@@ -24095,7 +24504,14 @@ var petFeederCapability = {
24095
24504
  * the full slice via `device.state.petFeeder.value` and refresh on
24096
24505
  * every poll without re-querying the provider.
24097
24506
  */
24098
- runtimeState: PetFeederStatusSchema
24507
+ runtimeState: PetFeederStatusSchema,
24508
+ /**
24509
+ * Runtime-state durability: **session** — live appliance state re-published on connect.
24510
+ *
24511
+ * See `RuntimeStateDurability`. Enforced by
24512
+ * `scripts/check-runtime-state-durability.ts`.
24513
+ */
24514
+ durability: "session"
24099
24515
  };
24100
24516
  var VehicleSchema = object({
24101
24517
  id: string(),
@@ -24407,7 +24823,17 @@ var powerMeterCapability = {
24407
24823
  schema: PowerMeterStatusSchema,
24408
24824
  kind: "push"
24409
24825
  },
24410
- runtimeState: PowerMeterStatusSchema
24826
+ runtimeState: PowerMeterStatusSchema,
24827
+ /**
24828
+ * Runtime-state durability: **restored** — as `numeric-sensor`; `kwhTotal` is an accumulator whose restored value is the baseline.
24829
+ *
24830
+ * See `RuntimeStateDurability`. Enforced by
24831
+ * `scripts/check-runtime-state-durability.ts`.
24832
+ */
24833
+ durability: "restored",
24834
+ /** Clock fields: written, but excluded from the compare that decides
24835
+ * whether persisting is worth a SQLite commit. */
24836
+ volatileStateFields: ["lastFetchedAt"]
24411
24837
  };
24412
24838
  /**
24413
24839
  * Presence cap. Models HA `person.*` and `device_tracker.*` entities
@@ -24464,7 +24890,17 @@ var presenceCapability = {
24464
24890
  * the map pin is rendered (use `DeviceFeature.PresenceGps` for the
24465
24891
  * pre-fetch fast-path check).
24466
24892
  */
24467
- runtimeState: PresenceStatusSchema
24893
+ runtimeState: PresenceStatusSchema,
24894
+ /**
24895
+ * Runtime-state durability: **restored** — occupancy-relevant: the restored state is what an occupancy rule compares the first post-restart observation against.
24896
+ *
24897
+ * See `RuntimeStateDurability`. Enforced by
24898
+ * `scripts/check-runtime-state-durability.ts`.
24899
+ */
24900
+ durability: "restored",
24901
+ /** Clock fields: written, but excluded from the compare that decides
24902
+ * whether persisting is worth a SQLite commit. */
24903
+ volatileStateFields: ["lastChangedAt"]
24468
24904
  };
24469
24905
  /**
24470
24906
  * Atmospheric pressure reading in hectopascals. Drives Home Assistant
@@ -24500,7 +24936,17 @@ var pressureSensorCapability = {
24500
24936
  schema: PressureSensorStatusSchema,
24501
24937
  kind: "push"
24502
24938
  },
24503
- runtimeState: PressureSensorStatusSchema
24939
+ runtimeState: PressureSensorStatusSchema,
24940
+ /**
24941
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
24942
+ *
24943
+ * See `RuntimeStateDurability`. Enforced by
24944
+ * `scripts/check-runtime-state-durability.ts`.
24945
+ */
24946
+ durability: "restored",
24947
+ /** Clock fields: written, but excluded from the compare that decides
24948
+ * whether persisting is worth a SQLite commit. */
24949
+ volatileStateFields: ["lastFetchedAt"]
24504
24950
  };
24505
24951
  /**
24506
24952
  * PRIVACY — what the camera deliberately does not capture. Two planes:
@@ -24630,7 +25076,17 @@ var privacyMaskCapability = {
24630
25076
  schema: PrivacyMaskStatusSchema,
24631
25077
  kind: "poll"
24632
25078
  },
24633
- runtimeState: PrivacyMaskStatusSchema
25079
+ runtimeState: PrivacyMaskStatusSchema,
25080
+ /**
25081
+ * Runtime-state durability: **restored** — operator-drawn regions, zero real churn — 22 writes in 25 minutes, every one of them the clock.
25082
+ *
25083
+ * See `RuntimeStateDurability`. Enforced by
25084
+ * `scripts/check-runtime-state-durability.ts`.
25085
+ */
25086
+ durability: "restored",
25087
+ /** Clock fields: written, but excluded from the compare that decides
25088
+ * whether persisting is worth a SQLite commit. */
25089
+ volatileStateFields: ["lastFetchedAt"]
24634
25090
  };
24635
25091
  var PtzPresetSchema = object({
24636
25092
  id: string(),
@@ -24796,7 +25252,14 @@ var ptzAutotrackCapability = {
24796
25252
  * fetch / cache / fallback logic out of the four cap methods —
24797
25253
  * they become trampolines over `runtimeState`.
24798
25254
  */
24799
- runtimeState: PtzAutotrackRuntimeStateSchema
25255
+ runtimeState: PtzAutotrackRuntimeStateSchema,
25256
+ /**
25257
+ * Runtime-state durability: **session** — mirrors the camera's own autotrack config, re-read on connect.
25258
+ *
25259
+ * See `RuntimeStateDurability`. Enforced by
25260
+ * `scripts/check-runtime-state-durability.ts`.
25261
+ */
25262
+ durability: "session"
24800
25263
  };
24801
25264
  DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceId: number().int().nonnegative() }), object({ success: literal(true) }), {
24802
25265
  kind: "mutation",
@@ -25446,7 +25909,14 @@ var sceneMonitorCapability = {
25446
25909
  schema: SceneMonitorStatusSchema,
25447
25910
  kind: "push"
25448
25911
  },
25449
- runtimeState: SceneMonitorStatusSchema
25912
+ runtimeState: SceneMonitorStatusSchema,
25913
+ /**
25914
+ * Runtime-state durability: **session** — re-derived from the current scene on the next evaluation.
25915
+ *
25916
+ * See `RuntimeStateDurability`. Enforced by
25917
+ * `scripts/check-runtime-state-durability.ts`.
25918
+ */
25919
+ durability: "session"
25450
25920
  };
25451
25921
  /**
25452
25922
  * Per-stage gating mode applied to the zones a rule references.
@@ -25590,7 +26060,14 @@ var scriptRunnerCapability = {
25590
26060
  * `isRunning` to render a spinner during execution and surfaces
25591
26061
  * `lastError` / `lastRunSuccess` in the recent-runs panel.
25592
26062
  */
25593
- runtimeState: ScriptRunnerStatusSchema
26063
+ runtimeState: ScriptRunnerStatusSchema,
26064
+ /**
26065
+ * Runtime-state durability: **session** — a restored `isRunning: true` describes a process that died with the previous hub.
26066
+ *
26067
+ * See `RuntimeStateDurability`. Enforced by
26068
+ * `scripts/check-runtime-state-durability.ts`.
26069
+ */
26070
+ durability: "session"
25594
26071
  };
25595
26072
  /**
25596
26073
  * Smoke alarm sensor — boolean "is smoke currently detected" with
@@ -25617,7 +26094,17 @@ var smokeCapability = {
25617
26094
  schema: SmokeStatusSchema,
25618
26095
  kind: "push"
25619
26096
  },
25620
- runtimeState: SmokeStatusSchema
26097
+ runtimeState: SmokeStatusSchema,
26098
+ /**
26099
+ * Runtime-state durability: **restored** — a safety sensor must not read "clear" merely because the hub restarted.
26100
+ *
26101
+ * See `RuntimeStateDurability`. Enforced by
26102
+ * `scripts/check-runtime-state-durability.ts`.
26103
+ */
26104
+ durability: "restored",
26105
+ /** Clock fields: written, but excluded from the compare that decides
26106
+ * whether persisting is worth a SQLite commit. */
26107
+ volatileStateFields: ["lastChangedAt"]
25621
26108
  };
25622
26109
  /**
25623
26110
  * One publishable camera stream as its OWNING PROVIDER describes it — the same
@@ -25790,7 +26277,17 @@ var streamParamsCapability = {
25790
26277
  schema: StreamParamsStatusSchema,
25791
26278
  kind: "poll"
25792
26279
  },
25793
- runtimeState: StreamParamsStatusSchema
26280
+ runtimeState: StreamParamsStatusSchema,
26281
+ /**
26282
+ * Runtime-state durability: **restored** — operator-set encoder profile; mutation-driven.
26283
+ *
26284
+ * See `RuntimeStateDurability`. Enforced by
26285
+ * `scripts/check-runtime-state-durability.ts`.
26286
+ */
26287
+ durability: "restored",
26288
+ /** Clock fields: written, but excluded from the compare that decides
26289
+ * whether persisting is worth a SQLite commit. */
26290
+ volatileStateFields: ["lastFetchedAt"]
25794
26291
  };
25795
26292
  /**
25796
26293
  * Generic on/off switch cap for accessory children (siren, floodlight,
@@ -25836,6 +26333,16 @@ var switchCapability = {
25836
26333
  * not need to re-query the provider after a setState mutation.
25837
26334
  */
25838
26335
  runtimeState: SwitchStatusSchema,
26336
+ /**
26337
+ * Runtime-state durability: **restored** — device state an operator reads as authoritative; 55 devices, transition-driven.
26338
+ *
26339
+ * See `RuntimeStateDurability`. Enforced by
26340
+ * `scripts/check-runtime-state-durability.ts`.
26341
+ */
26342
+ durability: "restored",
26343
+ /** Clock fields: written, but excluded from the compare that decides
26344
+ * whether persisting is worth a SQLite commit. */
26345
+ volatileStateFields: ["lastChangedAt"],
25839
26346
  settings: { bindings: [{
25840
26347
  kind: "scalar",
25841
26348
  statusPath: "on",
@@ -25915,7 +26422,17 @@ var tamperCapability = {
25915
26422
  schema: TamperStatusSchema,
25916
26423
  kind: "push"
25917
26424
  },
25918
- runtimeState: TamperStatusSchema
26425
+ runtimeState: TamperStatusSchema,
26426
+ /**
26427
+ * Runtime-state durability: **restored** — as `smoke`.
26428
+ *
26429
+ * See `RuntimeStateDurability`. Enforced by
26430
+ * `scripts/check-runtime-state-durability.ts`.
26431
+ */
26432
+ durability: "restored",
26433
+ /** Clock fields: written, but excluded from the compare that decides
26434
+ * whether persisting is worth a SQLite commit. */
26435
+ volatileStateFields: ["lastChangedAt"]
25919
26436
  };
25920
26437
  /**
25921
26438
  * Single-metric temperature reading. Drives Home Assistant `sensor`
@@ -25960,7 +26477,17 @@ var temperatureSensorCapability = {
25960
26477
  schema: TemperatureSensorStatusSchema,
25961
26478
  kind: "push"
25962
26479
  },
25963
- runtimeState: TemperatureSensorStatusSchema
26480
+ runtimeState: TemperatureSensorStatusSchema,
26481
+ /**
26482
+ * Runtime-state durability: **restored** — as `numeric-sensor` (69 of 125 writes were the clock alone).
26483
+ *
26484
+ * See `RuntimeStateDurability`. Enforced by
26485
+ * `scripts/check-runtime-state-durability.ts`.
26486
+ */
26487
+ durability: "restored",
26488
+ /** Clock fields: written, but excluded from the compare that decides
26489
+ * whether persisting is worth a SQLite commit. */
26490
+ volatileStateFields: ["lastFetchedAt"]
25964
26491
  };
25965
26492
  /**
25966
26493
  * toast — system-scoped singleton capability that streams toast
@@ -26029,7 +26556,14 @@ var updateCapability = {
26029
26556
  schema: UpdateStatusSchema,
26030
26557
  kind: "poll"
26031
26558
  },
26032
- runtimeState: UpdateStatusSchema
26559
+ runtimeState: UpdateStatusSchema,
26560
+ /**
26561
+ * Runtime-state durability: **session** — a restored `inProgress: true` describes an update that is no longer running; versions are re-probed at boot.
26562
+ *
26563
+ * See `RuntimeStateDurability`. Enforced by
26564
+ * `scripts/check-runtime-state-durability.ts`.
26565
+ */
26566
+ durability: "session"
26033
26567
  };
26034
26568
  var UserSummarySchema = object({
26035
26569
  id: string(),
@@ -26363,7 +26897,14 @@ var vacuumControlCapability = {
26363
26897
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
26364
26898
  * slice for live state + battery + fan-speed changes.
26365
26899
  */
26366
- runtimeState: VacuumControlStatusSchema
26900
+ runtimeState: VacuumControlStatusSchema,
26901
+ /**
26902
+ * Runtime-state durability: **session** — as `media-player` — a restored `state: cleaning` is a robot that is not cleaning.
26903
+ *
26904
+ * See `RuntimeStateDurability`. Enforced by
26905
+ * `scripts/check-runtime-state-durability.ts`.
26906
+ */
26907
+ durability: "session"
26367
26908
  };
26368
26909
  var ValveStatusSchema = object({
26369
26910
  /** Lifecycle state of the valve. */
@@ -26415,7 +26956,14 @@ var valveCapability = {
26415
26956
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
26416
26957
  * slice for live position changes during a move.
26417
26958
  */
26418
- runtimeState: ValveStatusSchema
26959
+ runtimeState: ValveStatusSchema,
26960
+ /**
26961
+ * Runtime-state durability: **session** — as `brightness`.
26962
+ *
26963
+ * See `RuntimeStateDurability`. Enforced by
26964
+ * `scripts/check-runtime-state-durability.ts`.
26965
+ */
26966
+ durability: "session"
26419
26967
  };
26420
26968
  /**
26421
26969
  * Vibration / shake / impact sensor. Drives Home Assistant
@@ -26437,7 +26985,17 @@ var vibrationCapability = {
26437
26985
  schema: VibrationStatusSchema,
26438
26986
  kind: "push"
26439
26987
  },
26440
- runtimeState: VibrationStatusSchema
26988
+ runtimeState: VibrationStatusSchema,
26989
+ /**
26990
+ * Runtime-state durability: **restored** — as `smoke`.
26991
+ *
26992
+ * See `RuntimeStateDurability`. Enforced by
26993
+ * `scripts/check-runtime-state-durability.ts`.
26994
+ */
26995
+ durability: "restored",
26996
+ /** Clock fields: written, but excluded from the compare that decides
26997
+ * whether persisting is worth a SQLite commit. */
26998
+ volatileStateFields: ["lastChangedAt"]
26441
26999
  };
26442
27000
  /**
26443
27001
  * Water heater / boiler cap. Models HA `water_heater.*` entities — a
@@ -26511,7 +27069,14 @@ var waterHeaterCapability = {
26511
27069
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
26512
27070
  * slice for live temperature / mode / away changes.
26513
27071
  */
26514
- runtimeState: WaterHeaterStatusSchema
27072
+ runtimeState: WaterHeaterStatusSchema,
27073
+ /**
27074
+ * Runtime-state durability: **session** — as `climate-control`.
27075
+ *
27076
+ * See `RuntimeStateDurability`. Enforced by
27077
+ * `scripts/check-runtime-state-durability.ts`.
27078
+ */
27079
+ durability: "session"
26515
27080
  };
26516
27081
  /**
26517
27082
  * Weather provider cap. Models HA `weather.*` entities — a read-only
@@ -26570,7 +27135,14 @@ var weatherCapability = {
26570
27135
  * Runtime-state slice — mirrored by the kernel. The UI reads the
26571
27136
  * current conditions directly from the slice on each weather push.
26572
27137
  */
26573
- runtimeState: WeatherStatusSchema
27138
+ runtimeState: WeatherStatusSchema,
27139
+ /**
27140
+ * Runtime-state durability: **session** — a forecast is stale the moment the hub is down; the provider re-fetches on connect.
27141
+ *
27142
+ * See `RuntimeStateDurability`. Enforced by
27143
+ * `scripts/check-runtime-state-durability.ts`.
27144
+ */
27145
+ durability: "session"
26574
27146
  };
26575
27147
  /**
26576
27148
  * Per-zone occupancy aggregation produced by the analytics frame
@@ -26732,7 +27304,14 @@ var zoneAnalyticsCapability = {
26732
27304
  * automatically; the explicit `getCurrentSnapshot` cap method is
26733
27305
  * still useful for one-off polls without a subscription.
26734
27306
  */
26735
- runtimeState: CameraOccupancySnapshotSchema
27307
+ runtimeState: CameraOccupancySnapshotSchema,
27308
+ /**
27309
+ * Runtime-state durability: **session** — per-frame analytics; with `audio-metrics` it is ~90 % of the offered write rate. Re-derived on the next frame.
27310
+ *
27311
+ * See `RuntimeStateDurability`. Enforced by
27312
+ * `scripts/check-runtime-state-durability.ts`.
27313
+ */
27314
+ durability: "session"
26736
27315
  };
26737
27316
  /**
26738
27317
  * Stages a {@link ZoneRule} can apply to. Discriminator on the rules
@@ -26810,7 +27389,14 @@ var zoneRulesCapability = {
26810
27389
  motion: array(ZoneRuleSchema).readonly(),
26811
27390
  detection: array(ZoneRuleSchema).readonly(),
26812
27391
  package: array(ZoneRuleSchema).readonly()
26813
- })
27392
+ }),
27393
+ /**
27394
+ * Runtime-state durability: **restored** — operator intent, mutation-only, same argument as `zones`.
27395
+ *
27396
+ * See `RuntimeStateDurability`. Enforced by
27397
+ * `scripts/check-runtime-state-durability.ts`.
27398
+ */
27399
+ durability: "restored"
26814
27400
  };
26815
27401
  /**
26816
27402
  * Accessory device helpers — shared across drivers.
@@ -33497,6 +34083,7 @@ Object.freeze({
33497
34083
  "network-access": "ingress",
33498
34084
  "smtp-provider": "email"
33499
34085
  });
34086
+ new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
33500
34087
  new Set(["devices", "classes"]);
33501
34088
  /**
33502
34089
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.