@camstack/addon-provider-homematic 1.2.16 → 1.2.17

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
@@ -10830,7 +10830,14 @@ var cameraStreamsCapability = {
10830
10830
  low: string().optional()
10831
10831
  }),
10832
10832
  lastChangedAt: number()
10833
- })
10833
+ }),
10834
+ /**
10835
+ * 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.
10836
+ *
10837
+ * See `RuntimeStateDurability`. Enforced by
10838
+ * `scripts/check-runtime-state-durability.ts`.
10839
+ */
10840
+ durability: "session"
10834
10841
  };
10835
10842
  /** Where a block runs. The operator chooses — a block driving a device on an
10836
10843
  * agent is the reason placement is not fixed to the hub. */
@@ -11391,6 +11398,13 @@ var deviceDiscoveryCapability = {
11391
11398
  kind: "poll"
11392
11399
  },
11393
11400
  runtimeState: DeviceDiscoveryStatusSchema.extend({ lastFetchedAt: number().int().nonnegative() }),
11401
+ /**
11402
+ * Runtime-state durability: **session** — 5.7 KB of scan output on the largest device, fully re-derivable by re-scanning.
11403
+ *
11404
+ * See `RuntimeStateDurability`. Enforced by
11405
+ * `scripts/check-runtime-state-durability.ts`.
11406
+ */
11407
+ durability: "session",
11394
11408
  methods: {
11395
11409
  /**
11396
11410
  * Snapshot of the current `discovered` list. Returns the
@@ -13307,7 +13321,23 @@ var NotificationActionSchema = object({
13307
13321
  * else — see `notification-center/action-token.ts` for what that does and
13308
13322
  * does not buy.
13309
13323
  */
13310
- destructive: boolean().optional()
13324
+ destructive: boolean().optional(),
13325
+ /**
13326
+ * How the tap should REACH the url.
13327
+ *
13328
+ * `navigate` (absent, and every button authored before this field) opens it:
13329
+ * the phone leaves the notification and shows whatever the callback returns.
13330
+ * That is right for a button whose answer the operator wants to read.
13331
+ *
13332
+ * `background` fires it as a POST and stays put. It exists for the buttons
13333
+ * whose whole point is not to interrupt — "silence this for 30 minutes" is
13334
+ * an answer to the notification, and being thrown into a browser tab to
13335
+ * confirm it costs more attention than the notification did. A backend that
13336
+ * cannot do a background call renders it as an ordinary link (the adapters
13337
+ * fall back rather than dropping the button), so this is a preference, never
13338
+ * a requirement.
13339
+ */
13340
+ mode: _enum(["navigate", "background"]).optional()
13311
13341
  });
13312
13342
  /**
13313
13343
  * The canonical notification. `body` is the only hard field (Apprise model).
@@ -14159,7 +14189,17 @@ var alarmPanelCapability = {
14159
14189
  * full slice; renders an arm button per `availableModes` entry and
14160
14190
  * a PIN field iff `requiresCode === true`.
14161
14191
  */
14162
- runtimeState: AlarmPanelStatusSchema
14192
+ runtimeState: AlarmPanelStatusSchema,
14193
+ /**
14194
+ * Runtime-state durability: **restored** — armed state is the one thing a panel must not lose across a restart.
14195
+ *
14196
+ * See `RuntimeStateDurability`. Enforced by
14197
+ * `scripts/check-runtime-state-durability.ts`.
14198
+ */
14199
+ durability: "restored",
14200
+ /** Clock fields: written, but excluded from the compare that decides
14201
+ * whether persisting is worth a SQLite commit. */
14202
+ volatileStateFields: ["lastChangedAt"]
14163
14203
  };
14164
14204
  /**
14165
14205
  * Shared geometry vocabulary for on-frame shape caps — privacy-mask,
@@ -14336,6 +14376,9 @@ var NcSystemEventConditionSchema = object({
14336
14376
  nodeIds: array(string().min(1)).min(1).optional(),
14337
14377
  packageNames: array(string().min(1)).min(1).optional()
14338
14378
  });
14379
+ /** Hard ceiling on a window (24h). A snooze that could not expire would be an
14380
+ * outage the operator asked for once and forgot. */
14381
+ var NC_SNOOZE_MAX_MINUTES = 1440;
14339
14382
  /** Weekly schedule — OR of windows; absence on the rule = always active. */
14340
14383
  var NcScheduleSchema = object({
14341
14384
  windows: array(object({
@@ -14712,15 +14755,15 @@ var NcConditionsSchema = object({
14712
14755
  * (an `immediate` rule naming an `audio-*` class, one notification per
14713
14756
  * classified sample) stays exactly as it was for rules that already use it.
14714
14757
  *
14715
- * NOT in {@link NC_CONDITION_CATALOG} yet, and that is the sequencing rule
14716
- * rather than an oversight: the viewer mirrors the descriptor enums BY HAND
14717
- * (`camstack/src/data/notification-center.ts`, guarded by
14718
- * `scripts/check-viewer-condition-mirror.ts`) and its rule editor STRIPS the
14758
+ * In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
14759
+ * rule rather than an accident: the viewer mirrors the descriptor enums BY
14760
+ * HAND (`camstack/src/data/notification-center.ts`, guarded by
14761
+ * `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
14719
14762
  * condition fields it does not know when a rule is saved from the phone.
14720
14763
  * Publishing an editor for a condition the app cannot round-trip is how an
14721
- * operator loses a rule's conditions by opening it — so the descriptor, the
14722
- * admin widget and the viewer mirror land together (P2 + P3), and only then
14723
- * does an audio rule become authorable.
14764
+ * operator loses a rule's conditions by opening it — so the viewer mirror
14765
+ * (P3, shipped) went FIRST, and the descriptor an editor renders from
14766
+ * follows here.
14724
14767
  */
14725
14768
  audio: NcAudioConditionSchema.optional()
14726
14769
  });
@@ -14956,6 +14999,30 @@ var NcRuleInputSchema = object({
14956
14999
  */
14957
15000
  snoozeAllowGlobal: boolean().optional(),
14958
15001
  /**
15002
+ * The snooze durations THIS rule's notification offers as buttons, in
15003
+ * minutes.
15004
+ *
15005
+ * Three states, and all three are distinct — which is exactly why this is
15006
+ * `.optional()` and never `.default()`. A Zod default does not run on the
15007
+ * addon cap path (three production failures in one day), so a schema default
15008
+ * would collapse the first two:
15009
+ *
15010
+ * | value | meaning |
15011
+ * | --- | --- |
15012
+ * | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
15013
+ * | `[]` | **no snooze buttons on this rule** — the explicit override |
15014
+ * | a list | these choices, de-duplicated and sorted, at most four |
15015
+ *
15016
+ * `.max(4)` because the notifier's own action budget is small (ntfy allows
15017
+ * three buttons in total) and a rule that spent it all on snooze choices
15018
+ * would push its own tap-through actions off the notification.
15019
+ *
15020
+ * An empty list is NOT an alarm exemption: a rule the alarm is about, or
15021
+ * that arms the panel, is exempt automatically and cannot be silenced by a
15022
+ * window from anywhere (D133).
15023
+ */
15024
+ snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
15025
+ /**
14959
15026
  * Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
14960
15027
  *
14961
15028
  * This is what makes the rule set the alarm's trigger set without the alarm
@@ -15055,6 +15122,7 @@ var NcConditionDescriptorSchema = object({
15055
15122
  "device",
15056
15123
  "package",
15057
15124
  "occupancy",
15125
+ "audio",
15058
15126
  "system"
15059
15127
  ]),
15060
15128
  label: string(),
@@ -15073,6 +15141,7 @@ var NcConditionDescriptorSchema = object({
15073
15141
  "crossingSelect",
15074
15142
  "polygonDraw",
15075
15143
  "occupancy",
15144
+ "audio",
15076
15145
  "deviceState",
15077
15146
  "systemEvent"
15078
15147
  ]),
@@ -15224,7 +15293,20 @@ var NcSnoozeInputSchema = object({
15224
15293
  ruleId: string().optional(),
15225
15294
  /** Required when `scope: 'device'`. */
15226
15295
  deviceId: number().int().optional(),
15227
- durationMinutes: number().int().min(1).max(1440),
15296
+ /**
15297
+ * Narrow the window to these subject classes — "the cat, not the person".
15298
+ *
15299
+ * ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
15300
+ * what every window authored before this field meant, so no persisted row
15301
+ * changes meaning and no client has to learn anything to keep working.
15302
+ *
15303
+ * It is what makes the window's real key `(deviceId, classes[])` and lets it
15304
+ * cross rules (D133): the operator points at a camera and a kind of thing,
15305
+ * not at whichever of their four rules happened to produce the notification
15306
+ * they are dismissing.
15307
+ */
15308
+ classes: array(string().min(1)).min(1).optional(),
15309
+ durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
15228
15310
  /**
15229
15311
  * Silence this for EVERY recipient, not just the caller. Permission is
15230
15312
  * checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
@@ -15249,6 +15331,10 @@ var NcSnoozeSchema = object({
15249
15331
  scope: NcSnoozeScopeSchema,
15250
15332
  ruleId: string().optional(),
15251
15333
  deviceId: number().int().optional(),
15334
+ /** Subject classes this window covers. ABSENT = every class — see
15335
+ * {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
15336
+ * no SQLite column: nothing queries a window by class. */
15337
+ classes: array(string().min(1)).min(1).optional(),
15252
15338
  startedAt: number(),
15253
15339
  /** Exclusive: at exactly this instant the snooze is over. Expiry is a
15254
15340
  * COMPARISON, not a job — no sweeper can leave the operator silenced. */
@@ -17349,7 +17435,14 @@ var zonesCapability = {
17349
17435
  * handle. Slice shape is `{ zones: Zone[] }` so future extensions
17350
17436
  * (e.g. zone groupings) can sit alongside the polygon list.
17351
17437
  */
17352
- runtimeState: object({ zones: array(ZoneSchema).readonly() })
17438
+ runtimeState: object({ zones: array(ZoneSchema).readonly() }),
17439
+ /**
17440
+ * 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.
17441
+ *
17442
+ * See `RuntimeStateDurability`. Enforced by
17443
+ * `scripts/check-runtime-state-durability.ts`.
17444
+ */
17445
+ durability: "restored"
17353
17446
  };
17354
17447
  /**
17355
17448
  * A bounding box in NORMALIZED [0,1] frame coordinates for `getNativeCrop`. The
@@ -20148,7 +20241,17 @@ var airQualitySensorCapability = {
20148
20241
  schema: AirQualitySensorStatusSchema,
20149
20242
  kind: "push"
20150
20243
  },
20151
- runtimeState: AirQualitySensorStatusSchema
20244
+ runtimeState: AirQualitySensorStatusSchema,
20245
+ /**
20246
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
20247
+ *
20248
+ * See `RuntimeStateDurability`. Enforced by
20249
+ * `scripts/check-runtime-state-durability.ts`.
20250
+ */
20251
+ durability: "restored",
20252
+ /** Clock fields: written, but excluded from the compare that decides
20253
+ * whether persisting is worth a SQLite commit. */
20254
+ volatileStateFields: ["lastFetchedAt"]
20152
20255
  };
20153
20256
  /**
20154
20257
  * Ambient illuminance reading in lux. Drives Home Assistant `sensor`
@@ -20180,7 +20283,17 @@ var ambientLightSensorCapability = {
20180
20283
  schema: AmbientLightSensorStatusSchema,
20181
20284
  kind: "push"
20182
20285
  },
20183
- runtimeState: AmbientLightSensorStatusSchema
20286
+ runtimeState: AmbientLightSensorStatusSchema,
20287
+ /**
20288
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
20289
+ *
20290
+ * See `RuntimeStateDurability`. Enforced by
20291
+ * `scripts/check-runtime-state-durability.ts`.
20292
+ */
20293
+ durability: "restored",
20294
+ /** Clock fields: written, but excluded from the compare that decides
20295
+ * whether persisting is worth a SQLite commit. */
20296
+ volatileStateFields: ["lastFetchedAt"]
20184
20297
  };
20185
20298
  /**
20186
20299
  * Per-class audio metrics aggregated over a sliding window.
@@ -20298,7 +20411,14 @@ var audioMetricsCapability = {
20298
20411
  }), AudioMetricsHistorySchema)
20299
20412
  },
20300
20413
  /** Reactive runtime-state mirror — live `device.state.audioMetrics.value`. */
20301
- runtimeState: AudioMetricsSnapshotSchema
20414
+ runtimeState: AudioMetricsSnapshotSchema,
20415
+ /**
20416
+ * 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.
20417
+ *
20418
+ * See `RuntimeStateDurability`. Enforced by
20419
+ * `scripts/check-runtime-state-durability.ts`.
20420
+ */
20421
+ durability: "session"
20302
20422
  };
20303
20423
  /**
20304
20424
  * Automation-control cap. Models HA `automation.*` entities on
@@ -20360,7 +20480,14 @@ var automationControlCapability = {
20360
20480
  * reads `enabled` (toggle) + `isRunning` (spinner) + `lastError`
20361
20481
  * (badge) directly.
20362
20482
  */
20363
- runtimeState: AutomationControlStatusSchema
20483
+ runtimeState: AutomationControlStatusSchema,
20484
+ /**
20485
+ * 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.
20486
+ *
20487
+ * See `RuntimeStateDurability`. Enforced by
20488
+ * `scripts/check-runtime-state-durability.ts`.
20489
+ */
20490
+ durability: "session"
20364
20491
  };
20365
20492
  /**
20366
20493
  * Battery status snapshot. Emitted by providers whose device is
@@ -20466,7 +20593,17 @@ onStatusChanged: { data: object({
20466
20593
  * via `device.runtimeState.getCapState('battery')` regardless of
20467
20594
  * the underlying driver.
20468
20595
  */
20469
- runtimeState: BatteryStatusSchema
20596
+ runtimeState: BatteryStatusSchema,
20597
+ /**
20598
+ * 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.
20599
+ *
20600
+ * See `RuntimeStateDurability`. Enforced by
20601
+ * `scripts/check-runtime-state-durability.ts`.
20602
+ */
20603
+ durability: "restored",
20604
+ /** Clock fields: written, but excluded from the compare that decides
20605
+ * whether persisting is worth a SQLite commit. */
20606
+ volatileStateFields: ["lastUpdated"]
20470
20607
  };
20471
20608
  /**
20472
20609
  * Generic boolean sensor — last-resort fallback when no domain-
@@ -20495,7 +20632,17 @@ var binaryCapability = {
20495
20632
  schema: BinaryStatusSchema,
20496
20633
  kind: "push"
20497
20634
  },
20498
- runtimeState: BinaryStatusSchema
20635
+ runtimeState: BinaryStatusSchema,
20636
+ /**
20637
+ * Runtime-state durability: **restored** — transition-driven sensor state; the restored value gives the boot comparison.
20638
+ *
20639
+ * See `RuntimeStateDurability`. Enforced by
20640
+ * `scripts/check-runtime-state-durability.ts`.
20641
+ */
20642
+ durability: "restored",
20643
+ /** Clock fields: written, but excluded from the compare that decides
20644
+ * whether persisting is worth a SQLite commit. */
20645
+ volatileStateFields: ["lastChangedAt"]
20499
20646
  };
20500
20647
  /**
20501
20648
  * Dimmable-light brightness control. Co-exists with `switch` on the
@@ -20548,7 +20695,14 @@ onBrightnessChanged: { data: object({
20548
20695
  * by the kernel. Read via `device.state.brightness.value` so UI
20549
20696
  * sliders surface the current level without polling the provider.
20550
20697
  */
20551
- runtimeState: BrightnessStatusSchema
20698
+ runtimeState: BrightnessStatusSchema,
20699
+ /**
20700
+ * Runtime-state durability: **session** — live lamp state, re-published by the provider on connect.
20701
+ *
20702
+ * See `RuntimeStateDurability`. Enforced by
20703
+ * `scripts/check-runtime-state-durability.ts`.
20704
+ */
20705
+ durability: "session"
20552
20706
  };
20553
20707
  DeviceType.Button, method(object({ deviceId: number().int().nonnegative() }), _void(), {
20554
20708
  kind: "mutation",
@@ -20636,7 +20790,17 @@ var carbonMonoxideCapability = {
20636
20790
  schema: CarbonMonoxideStatusSchema,
20637
20791
  kind: "push"
20638
20792
  },
20639
- runtimeState: CarbonMonoxideStatusSchema
20793
+ runtimeState: CarbonMonoxideStatusSchema,
20794
+ /**
20795
+ * Runtime-state durability: **restored** — as `smoke`.
20796
+ *
20797
+ * See `RuntimeStateDurability`. Enforced by
20798
+ * `scripts/check-runtime-state-durability.ts`.
20799
+ */
20800
+ durability: "restored",
20801
+ /** Clock fields: written, but excluded from the compare that decides
20802
+ * whether persisting is worth a SQLite commit. */
20803
+ volatileStateFields: ["lastChangedAt"]
20640
20804
  };
20641
20805
  /**
20642
20806
  * HVAC / climate control cap. Models the full surface of a HA
@@ -20796,7 +20960,14 @@ var climateControlCapability = {
20796
20960
  * the full slice via `device.state.climate-control.value` and refresh
20797
20961
  * on every push without re-querying the provider.
20798
20962
  */
20799
- runtimeState: ClimateControlStatusSchema
20963
+ runtimeState: ClimateControlStatusSchema,
20964
+ /**
20965
+ * Runtime-state durability: **session** — as `brightness`; `currentTemp` moves continuously and is re-published on connect.
20966
+ *
20967
+ * See `RuntimeStateDurability`. Enforced by
20968
+ * `scripts/check-runtime-state-durability.ts`.
20969
+ */
20970
+ durability: "session"
20800
20971
  };
20801
20972
  /**
20802
20973
  * Color-light cap. Coexists with `switch` (on/off) and `brightness`
@@ -20906,7 +21077,14 @@ onColorChanged: { data: object({
20906
21077
  * kernel. Read via `device.state.color.value` so UI pickers surface
20907
21078
  * the current chromaticity without polling the provider.
20908
21079
  */
20909
- runtimeState: ColorStatusSchema
21080
+ runtimeState: ColorStatusSchema,
21081
+ /**
21082
+ * Runtime-state durability: **session** — as `brightness`.
21083
+ *
21084
+ * See `RuntimeStateDurability`. Enforced by
21085
+ * `scripts/check-runtime-state-durability.ts`.
21086
+ */
21087
+ durability: "session"
20910
21088
  };
20911
21089
  var ConnectionTestOutcomeSchema = discriminatedUnion("outcome", [
20912
21090
  object({
@@ -20964,7 +21142,17 @@ var connectivityCapability = {
20964
21142
  schema: ConnectivityStatusSchema,
20965
21143
  kind: "push"
20966
21144
  },
20967
- runtimeState: ConnectivityStatusSchema
21145
+ runtimeState: ConnectivityStatusSchema,
21146
+ /**
21147
+ * Runtime-state durability: **restored** — same shape and same argument as `device-status`, for links rather than devices.
21148
+ *
21149
+ * See `RuntimeStateDurability`. Enforced by
21150
+ * `scripts/check-runtime-state-durability.ts`.
21151
+ */
21152
+ durability: "restored",
21153
+ /** Clock fields: written, but excluded from the compare that decides
21154
+ * whether persisting is worth a SQLite commit. */
21155
+ volatileStateFields: ["lastChangedAt"]
20968
21156
  };
20969
21157
  /**
20970
21158
  * Generic device-consumables capability — surfaces a device's
@@ -21046,7 +21234,14 @@ reset: method(object({
21046
21234
  }
21047
21235
  }
21048
21236
  },
21049
- runtimeState: ConsumablesStatusSchema.extend({ lastFetchedAt: number() })
21237
+ runtimeState: ConsumablesStatusSchema.extend({ lastFetchedAt: number() }),
21238
+ /**
21239
+ * Runtime-state durability: **session** — the authority is the appliance; the provider re-reads the whole item array on connect.
21240
+ *
21241
+ * See `RuntimeStateDurability`. Enforced by
21242
+ * `scripts/check-runtime-state-durability.ts`.
21243
+ */
21244
+ durability: "session"
21050
21245
  };
21051
21246
  /**
21052
21247
  * Door / window / opening / garage / valve contact sensor. Boolean
@@ -21077,7 +21272,17 @@ var contactCapability = {
21077
21272
  schema: ContactStatusSchema,
21078
21273
  kind: "push"
21079
21274
  },
21080
- runtimeState: ContactStatusSchema
21275
+ runtimeState: ContactStatusSchema,
21276
+ /**
21277
+ * Runtime-state durability: **restored** — a door left open across a restart must still read open.
21278
+ *
21279
+ * See `RuntimeStateDurability`. Enforced by
21280
+ * `scripts/check-runtime-state-durability.ts`.
21281
+ */
21282
+ durability: "restored",
21283
+ /** Clock fields: written, but excluded from the compare that decides
21284
+ * whether persisting is worth a SQLite commit. */
21285
+ volatileStateFields: ["lastChangedAt"]
21081
21286
  };
21082
21287
  /**
21083
21288
  * Status slice — flat object (the framework's `runtimeState` contract
@@ -21183,7 +21388,14 @@ var controlCapability = {
21183
21388
  * dropdown / text field / date picker) read the slice's discriminant
21184
21389
  * and value directly without polling the provider.
21185
21390
  */
21186
- runtimeState: ControlStatusSchema
21391
+ runtimeState: ControlStatusSchema,
21392
+ /**
21393
+ * Runtime-state durability: **session** — a generic control mirrors an external entity that re-publishes on connect; the options array is re-derived with it.
21394
+ *
21395
+ * See `RuntimeStateDurability`. Enforced by
21396
+ * `scripts/check-runtime-state-durability.ts`.
21397
+ */
21398
+ durability: "session"
21187
21399
  };
21188
21400
  var CoverStatusSchema = object({
21189
21401
  /** Lifecycle state of the cover. */
@@ -21244,7 +21456,17 @@ var coverCapability = {
21244
21456
  * Runtime-state slice — mirrored by the kernel. UI controls watch
21245
21457
  * the slice for live position changes during a move.
21246
21458
  */
21247
- runtimeState: CoverStatusSchema
21459
+ runtimeState: CoverStatusSchema,
21460
+ /**
21461
+ * Runtime-state durability: **restored** — position survives a restart on the device; the mirror should agree at boot rather than read blank.
21462
+ *
21463
+ * See `RuntimeStateDurability`. Enforced by
21464
+ * `scripts/check-runtime-state-durability.ts`.
21465
+ */
21466
+ durability: "restored",
21467
+ /** Clock fields: written, but excluded from the compare that decides
21468
+ * whether persisting is worth a SQLite commit. */
21469
+ volatileStateFields: ["lastChangedAt"]
21248
21470
  };
21249
21471
  /**
21250
21472
  * Vendor-neutral day/night (IR-cut) control — the per-camera config cap
@@ -21338,7 +21560,17 @@ var dayNightCapability = {
21338
21560
  schema: DayNightStatusSchema,
21339
21561
  kind: "poll"
21340
21562
  },
21341
- runtimeState: DayNightStatusSchema
21563
+ runtimeState: DayNightStatusSchema,
21564
+ /**
21565
+ * Runtime-state durability: **restored** — operator-set IR-cut behaviour; mutation-driven.
21566
+ *
21567
+ * See `RuntimeStateDurability`. Enforced by
21568
+ * `scripts/check-runtime-state-durability.ts`.
21569
+ */
21570
+ durability: "restored",
21571
+ /** Clock fields: written, but excluded from the compare that decides
21572
+ * whether persisting is worth a SQLite commit. */
21573
+ volatileStateFields: ["lastFetchedAt"]
21342
21574
  };
21343
21575
  /**
21344
21576
  * Generic device-level status snapshot. Auto-registered by `BaseDevice`
@@ -21385,7 +21617,17 @@ onStatusChanged: { data: object({
21385
21617
  schema: DeviceStatusSchema,
21386
21618
  kind: "push"
21387
21619
  },
21388
- runtimeState: DeviceStatusSchema
21620
+ runtimeState: DeviceStatusSchema,
21621
+ /**
21622
+ * 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.
21623
+ *
21624
+ * See `RuntimeStateDurability`. Enforced by
21625
+ * `scripts/check-runtime-state-durability.ts`.
21626
+ */
21627
+ durability: "restored",
21628
+ /** Clock fields: written, but excluded from the compare that decides
21629
+ * whether persisting is worth a SQLite commit. */
21630
+ volatileStateFields: ["lastChangedAt"]
21389
21631
  };
21390
21632
  /**
21391
21633
  * Doorbell button cap. Two kinds of providers coexist behind this cap
@@ -21447,7 +21689,14 @@ onPressed: { data: DoorbellPressEventSchema } },
21447
21689
  * `device.state.doorbell.value`. UIs can show "last ring 5m ago"
21448
21690
  * without subscribing.
21449
21691
  */
21450
- runtimeState: DoorbellStatusSchema
21692
+ runtimeState: DoorbellStatusSchema,
21693
+ /**
21694
+ * 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.
21695
+ *
21696
+ * See `RuntimeStateDurability`. Enforced by
21697
+ * `scripts/check-runtime-state-durability.ts`.
21698
+ */
21699
+ durability: "restored"
21451
21700
  };
21452
21701
  /**
21453
21702
  * Enum-state sensor — a string value picked from a finite option set.
@@ -21487,7 +21736,17 @@ var enumSensorCapability = {
21487
21736
  schema: EnumSensorStatusSchema,
21488
21737
  kind: "push"
21489
21738
  },
21490
- runtimeState: EnumSensorStatusSchema
21739
+ runtimeState: EnumSensorStatusSchema,
21740
+ /**
21741
+ * Runtime-state durability: **restored** — as `numeric-sensor`; 80 devices.
21742
+ *
21743
+ * See `RuntimeStateDurability`. Enforced by
21744
+ * `scripts/check-runtime-state-durability.ts`.
21745
+ */
21746
+ durability: "restored",
21747
+ /** Clock fields: written, but excluded from the compare that decides
21748
+ * whether persisting is worth a SQLite commit. */
21749
+ volatileStateFields: ["lastFetchedAt"]
21491
21750
  };
21492
21751
  /**
21493
21752
  * Generic stateless event emitter. Installed on a `DeviceType.EventEmitter`
@@ -21523,7 +21782,14 @@ var eventEmitterCapability = {
21523
21782
  schema: EventEmitterStatusSchema,
21524
21783
  kind: "push"
21525
21784
  },
21526
- runtimeState: EventEmitterStatusSchema
21785
+ runtimeState: EventEmitterStatusSchema,
21786
+ /**
21787
+ * Runtime-state durability: **session** — `eventCountSinceStart` names its own scope.
21788
+ *
21789
+ * See `RuntimeStateDurability`. Enforced by
21790
+ * `scripts/check-runtime-state-durability.ts`.
21791
+ */
21792
+ durability: "session"
21527
21793
  };
21528
21794
  var EventItemSchema = object({
21529
21795
  id: string(),
@@ -21804,7 +22070,14 @@ var fanControlCapability = {
21804
22070
  * Runtime-state slice — mirrored by the kernel. UI fan speed
21805
22071
  * sliders read `percentage` for live updates.
21806
22072
  */
21807
- runtimeState: FanControlStatusSchema
22073
+ runtimeState: FanControlStatusSchema,
22074
+ /**
22075
+ * Runtime-state durability: **session** — as `brightness`.
22076
+ *
22077
+ * See `RuntimeStateDurability`. Enforced by
22078
+ * `scripts/check-runtime-state-durability.ts`.
22079
+ */
22080
+ durability: "session"
21808
22081
  };
21809
22082
  /**
21810
22083
  * Per-device feature/identity probe slice. Holds the runtime-resolved
@@ -21880,7 +22153,14 @@ onProbeChanged: { data: object({
21880
22153
  schema: FeatureProbeStatusSchema,
21881
22154
  kind: "push"
21882
22155
  },
21883
- runtimeState: FeatureProbeStatusSchema
22156
+ runtimeState: FeatureProbeStatusSchema,
22157
+ /**
22158
+ * 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.
22159
+ *
22160
+ * See `RuntimeStateDurability`. Enforced by
22161
+ * `scripts/check-runtime-state-durability.ts`.
22162
+ */
22163
+ durability: "session"
21884
22164
  };
21885
22165
  /**
21886
22166
  * Water leak / moisture sensor. Boolean "is liquid currently
@@ -21907,7 +22187,17 @@ var floodCapability = {
21907
22187
  schema: FloodStatusSchema,
21908
22188
  kind: "push"
21909
22189
  },
21910
- runtimeState: FloodStatusSchema
22190
+ runtimeState: FloodStatusSchema,
22191
+ /**
22192
+ * Runtime-state durability: **restored** — as `smoke`.
22193
+ *
22194
+ * See `RuntimeStateDurability`. Enforced by
22195
+ * `scripts/check-runtime-state-durability.ts`.
22196
+ */
22197
+ durability: "restored",
22198
+ /** Clock fields: written, but excluded from the compare that decides
22199
+ * whether persisting is worth a SQLite commit. */
22200
+ volatileStateFields: ["lastChangedAt"]
21911
22201
  };
21912
22202
  /**
21913
22203
  * Combustible-gas (LPG / methane / hydrogen) alarm sensor. Drives
@@ -21930,7 +22220,17 @@ var gasCapability = {
21930
22220
  schema: GasStatusSchema,
21931
22221
  kind: "push"
21932
22222
  },
21933
- runtimeState: GasStatusSchema
22223
+ runtimeState: GasStatusSchema,
22224
+ /**
22225
+ * Runtime-state durability: **restored** — as `smoke`.
22226
+ *
22227
+ * See `RuntimeStateDurability`. Enforced by
22228
+ * `scripts/check-runtime-state-durability.ts`.
22229
+ */
22230
+ durability: "restored",
22231
+ /** Clock fields: written, but excluded from the compare that decides
22232
+ * whether persisting is worth a SQLite commit. */
22233
+ volatileStateFields: ["lastChangedAt"]
21934
22234
  };
21935
22235
  /**
21936
22236
  * Humidifier / dehumidifier cap. Models HA `humidifier.*` entities —
@@ -22006,7 +22306,14 @@ var humidifierCapability = {
22006
22306
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
22007
22307
  * slice for live humidity / mode changes.
22008
22308
  */
22009
- runtimeState: HumidifierStatusSchema
22309
+ runtimeState: HumidifierStatusSchema,
22310
+ /**
22311
+ * Runtime-state durability: **session** — as `climate-control`.
22312
+ *
22313
+ * See `RuntimeStateDurability`. Enforced by
22314
+ * `scripts/check-runtime-state-durability.ts`.
22315
+ */
22316
+ durability: "session"
22010
22317
  };
22011
22318
  /**
22012
22319
  * Single-metric humidity reading. Drives Home Assistant `sensor`
@@ -22042,7 +22349,17 @@ var humiditySensorCapability = {
22042
22349
  schema: HumiditySensorStatusSchema,
22043
22350
  kind: "push"
22044
22351
  },
22045
- runtimeState: HumiditySensorStatusSchema
22352
+ runtimeState: HumiditySensorStatusSchema,
22353
+ /**
22354
+ * Runtime-state durability: **restored** — as `numeric-sensor` (67 of 75 writes were the clock alone).
22355
+ *
22356
+ * See `RuntimeStateDurability`. Enforced by
22357
+ * `scripts/check-runtime-state-durability.ts`.
22358
+ */
22359
+ durability: "restored",
22360
+ /** Clock fields: written, but excluded from the compare that decides
22361
+ * whether persisting is worth a SQLite commit. */
22362
+ volatileStateFields: ["lastFetchedAt"]
22046
22363
  };
22047
22364
  /**
22048
22365
  * Image display cap. Models a single still image exposed by an integration —
@@ -22080,7 +22397,14 @@ var imageCapability = {
22080
22397
  * Runtime-state slice — mirrored by the kernel. The UI reads `url`
22081
22398
  * directly and renders the still image.
22082
22399
  */
22083
- runtimeState: ImageStatusSchema
22400
+ runtimeState: ImageStatusSchema,
22401
+ /**
22402
+ * Runtime-state durability: **session** — a snapshot URL is a session-scoped handle; a restored one points at nothing.
22403
+ *
22404
+ * See `RuntimeStateDurability`. Enforced by
22405
+ * `scripts/check-runtime-state-durability.ts`.
22406
+ */
22407
+ durability: "session"
22084
22408
  };
22085
22409
  /**
22086
22410
  * Vendor-neutral image / picture-adjustment cap — the per-camera config
@@ -22229,7 +22553,17 @@ var imageSettingsCapability = {
22229
22553
  schema: ImageSettingsStatusSchema,
22230
22554
  kind: "poll"
22231
22555
  },
22232
- runtimeState: ImageSettingsStatusSchema
22556
+ runtimeState: ImageSettingsStatusSchema,
22557
+ /**
22558
+ * Runtime-state durability: **restored** — operator-set camera imaging; mutation-driven.
22559
+ *
22560
+ * See `RuntimeStateDurability`. Enforced by
22561
+ * `scripts/check-runtime-state-durability.ts`.
22562
+ */
22563
+ durability: "restored",
22564
+ /** Clock fields: written, but excluded from the compare that decides
22565
+ * whether persisting is worth a SQLite commit. */
22566
+ volatileStateFields: ["lastFetchedAt"]
22233
22567
  };
22234
22568
  /**
22235
22569
  * integrations — system-scoped singleton capability for integration
@@ -22569,7 +22903,14 @@ var lawnMowerControlCapability = {
22569
22903
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
22570
22904
  * slice for live activity + battery changes.
22571
22905
  */
22572
- runtimeState: LawnMowerControlStatusSchema
22906
+ runtimeState: LawnMowerControlStatusSchema,
22907
+ /**
22908
+ * Runtime-state durability: **session** — as `vacuum-control`.
22909
+ *
22910
+ * See `RuntimeStateDurability`. Enforced by
22911
+ * `scripts/check-runtime-state-durability.ts`.
22912
+ */
22913
+ durability: "session"
22573
22914
  };
22574
22915
  /**
22575
22916
  * local-network — hub-only singleton.
@@ -22775,7 +23116,17 @@ var lockControlCapability = {
22775
23116
  * read `state` and disable themselves during `locking`/`unlocking`
22776
23117
  * transitions.
22777
23118
  */
22778
- runtimeState: LockControlStatusSchema
23119
+ runtimeState: LockControlStatusSchema,
23120
+ /**
23121
+ * Runtime-state durability: **restored** — a lock left locked must still read locked.
23122
+ *
23123
+ * See `RuntimeStateDurability`. Enforced by
23124
+ * `scripts/check-runtime-state-durability.ts`.
23125
+ */
23126
+ durability: "restored",
23127
+ /** Clock fields: written, but excluded from the compare that decides
23128
+ * whether persisting is worth a SQLite commit. */
23129
+ volatileStateFields: ["lastChangedAt"]
22779
23130
  };
22780
23131
  /**
22781
23132
  * Media-player cap. Models HA `media_player.*` (Sonos, Chromecast,
@@ -22937,7 +23288,14 @@ var mediaPlayerCapability = {
22937
23288
  * full slice for live now-playing, volume, and progress updates
22938
23289
  * without polling.
22939
23290
  */
22940
- runtimeState: MediaPlayerStatusSchema
23291
+ runtimeState: MediaPlayerStatusSchema,
23292
+ /**
23293
+ * Runtime-state durability: **session** — a restored transport position describes a playback that stopped when the hub did.
23294
+ *
23295
+ * See `RuntimeStateDurability`. Enforced by
23296
+ * `scripts/check-runtime-state-durability.ts`.
23297
+ */
23298
+ durability: "session"
22941
23299
  };
22942
23300
  /**
22943
23301
  * mesh-network — collection cap for mesh-VPN providers.
@@ -23201,7 +23559,14 @@ onMotionChanged: { data: MotionOnMotionChangedDataSchema } },
23201
23559
  * `device.state.motion.value`. Reads never invoke the provider, so
23202
23560
  * UIs and other addons can poll the cached state safely.
23203
23561
  */
23204
- runtimeState: MotionStatusSchema
23562
+ runtimeState: MotionStatusSchema,
23563
+ /**
23564
+ * 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.
23565
+ *
23566
+ * See `RuntimeStateDurability`. Enforced by
23567
+ * `scripts/check-runtime-state-durability.ts`.
23568
+ */
23569
+ durability: "session"
23205
23570
  };
23206
23571
  /**
23207
23572
  * Motion-trigger toggle for accessory devices.
@@ -23266,7 +23631,14 @@ var motionTriggerCapability = {
23266
23631
  schema: MotionTriggerStatusSchema,
23267
23632
  kind: "command-driven"
23268
23633
  },
23269
- runtimeState: MotionTriggerRuntimeStateSchema
23634
+ runtimeState: MotionTriggerRuntimeStateSchema,
23635
+ /**
23636
+ * 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.
23637
+ *
23638
+ * See `RuntimeStateDurability`. Enforced by
23639
+ * `scripts/check-runtime-state-durability.ts`.
23640
+ */
23641
+ durability: "session"
23270
23642
  };
23271
23643
  /**
23272
23644
  * Motion-zones share the same MaskShape vocabulary as privacy-mask — the
@@ -23333,7 +23705,17 @@ var motionZonesCapability = {
23333
23705
  schema: MotionZoneStatusSchema,
23334
23706
  kind: "poll"
23335
23707
  },
23336
- runtimeState: MotionZoneStatusSchema
23708
+ runtimeState: MotionZoneStatusSchema,
23709
+ /**
23710
+ * 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.
23711
+ *
23712
+ * See `RuntimeStateDurability`. Enforced by
23713
+ * `scripts/check-runtime-state-durability.ts`.
23714
+ */
23715
+ durability: "restored",
23716
+ /** Clock fields: written, but excluded from the compare that decides
23717
+ * whether persisting is worth a SQLite commit. */
23718
+ volatileStateFields: ["lastFetchedAt"]
23337
23719
  };
23338
23720
  /**
23339
23721
  * On-camera AI object detection cap. Surfaces per-device the classes
@@ -23407,7 +23789,17 @@ var nativeObjectDetectionCapability = {
23407
23789
  schema: NativeObjectDetectionStatusSchema,
23408
23790
  kind: "push"
23409
23791
  },
23410
- runtimeState: NativeObjectDetectionRuntimeStateSchema
23792
+ runtimeState: NativeObjectDetectionRuntimeStateSchema,
23793
+ /**
23794
+ * 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.
23795
+ *
23796
+ * See `RuntimeStateDurability`. Enforced by
23797
+ * `scripts/check-runtime-state-durability.ts`.
23798
+ */
23799
+ durability: "restored",
23800
+ /** Clock fields: written, but excluded from the compare that decides
23801
+ * whether persisting is worth a SQLite commit. */
23802
+ volatileStateFields: ["lastFetchedAt"]
23411
23803
  };
23412
23804
  /**
23413
23805
  * network-quality — system-scoped singleton capability tracking RTT,
@@ -23741,7 +24133,14 @@ onSent: { data: object({
23741
24133
  * form reads `supports` to gate optional fields; history pane reads
23742
24134
  * `lastSentAt` / `lastError` / `queueDepth`.
23743
24135
  */
23744
- runtimeState: NotifierStatusSchema
24136
+ runtimeState: NotifierStatusSchema,
24137
+ /**
24138
+ * Runtime-state durability: **session** — live queue depth and last-send state; a restored queue depth describes a queue that no longer exists.
24139
+ *
24140
+ * See `RuntimeStateDurability`. Enforced by
24141
+ * `scripts/check-runtime-state-durability.ts`.
24142
+ */
24143
+ durability: "session"
23745
24144
  };
23746
24145
  /**
23747
24146
  * Generic numeric sensor — last-resort fallback when no typed numeric
@@ -23784,7 +24183,17 @@ var numericSensorCapability = {
23784
24183
  schema: NumericSensorStatusSchema,
23785
24184
  kind: "push"
23786
24185
  },
23787
- runtimeState: NumericSensorStatusSchema
24186
+ runtimeState: NumericSensorStatusSchema,
24187
+ /**
24188
+ * 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.
24189
+ *
24190
+ * See `RuntimeStateDurability`. Enforced by
24191
+ * `scripts/check-runtime-state-durability.ts`.
24192
+ */
24193
+ durability: "restored",
24194
+ /** Clock fields: written, but excluded from the compare that decides
24195
+ * whether persisting is worth a SQLite commit. */
24196
+ volatileStateFields: ["lastFetchedAt"]
23788
24197
  };
23789
24198
  /**
23790
24199
  * Generic on-screen-display (video overlay) cap. Each camera exposes
@@ -24169,7 +24578,14 @@ var petFeederCapability = {
24169
24578
  * the full slice via `device.state.petFeeder.value` and refresh on
24170
24579
  * every poll without re-querying the provider.
24171
24580
  */
24172
- runtimeState: PetFeederStatusSchema
24581
+ runtimeState: PetFeederStatusSchema,
24582
+ /**
24583
+ * Runtime-state durability: **session** — live appliance state re-published on connect.
24584
+ *
24585
+ * See `RuntimeStateDurability`. Enforced by
24586
+ * `scripts/check-runtime-state-durability.ts`.
24587
+ */
24588
+ durability: "session"
24173
24589
  };
24174
24590
  var VehicleSchema = object({
24175
24591
  id: string(),
@@ -24481,7 +24897,17 @@ var powerMeterCapability = {
24481
24897
  schema: PowerMeterStatusSchema,
24482
24898
  kind: "push"
24483
24899
  },
24484
- runtimeState: PowerMeterStatusSchema
24900
+ runtimeState: PowerMeterStatusSchema,
24901
+ /**
24902
+ * Runtime-state durability: **restored** — as `numeric-sensor`; `kwhTotal` is an accumulator whose restored value is the baseline.
24903
+ *
24904
+ * See `RuntimeStateDurability`. Enforced by
24905
+ * `scripts/check-runtime-state-durability.ts`.
24906
+ */
24907
+ durability: "restored",
24908
+ /** Clock fields: written, but excluded from the compare that decides
24909
+ * whether persisting is worth a SQLite commit. */
24910
+ volatileStateFields: ["lastFetchedAt"]
24485
24911
  };
24486
24912
  /**
24487
24913
  * Presence cap. Models HA `person.*` and `device_tracker.*` entities
@@ -24538,7 +24964,17 @@ var presenceCapability = {
24538
24964
  * the map pin is rendered (use `DeviceFeature.PresenceGps` for the
24539
24965
  * pre-fetch fast-path check).
24540
24966
  */
24541
- runtimeState: PresenceStatusSchema
24967
+ runtimeState: PresenceStatusSchema,
24968
+ /**
24969
+ * Runtime-state durability: **restored** — occupancy-relevant: the restored state is what an occupancy rule compares the first post-restart observation against.
24970
+ *
24971
+ * See `RuntimeStateDurability`. Enforced by
24972
+ * `scripts/check-runtime-state-durability.ts`.
24973
+ */
24974
+ durability: "restored",
24975
+ /** Clock fields: written, but excluded from the compare that decides
24976
+ * whether persisting is worth a SQLite commit. */
24977
+ volatileStateFields: ["lastChangedAt"]
24542
24978
  };
24543
24979
  /**
24544
24980
  * Atmospheric pressure reading in hectopascals. Drives Home Assistant
@@ -24574,7 +25010,17 @@ var pressureSensorCapability = {
24574
25010
  schema: PressureSensorStatusSchema,
24575
25011
  kind: "push"
24576
25012
  },
24577
- runtimeState: PressureSensorStatusSchema
25013
+ runtimeState: PressureSensorStatusSchema,
25014
+ /**
25015
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
25016
+ *
25017
+ * See `RuntimeStateDurability`. Enforced by
25018
+ * `scripts/check-runtime-state-durability.ts`.
25019
+ */
25020
+ durability: "restored",
25021
+ /** Clock fields: written, but excluded from the compare that decides
25022
+ * whether persisting is worth a SQLite commit. */
25023
+ volatileStateFields: ["lastFetchedAt"]
24578
25024
  };
24579
25025
  /**
24580
25026
  * PRIVACY — what the camera deliberately does not capture. Two planes:
@@ -24704,7 +25150,17 @@ var privacyMaskCapability = {
24704
25150
  schema: PrivacyMaskStatusSchema,
24705
25151
  kind: "poll"
24706
25152
  },
24707
- runtimeState: PrivacyMaskStatusSchema
25153
+ runtimeState: PrivacyMaskStatusSchema,
25154
+ /**
25155
+ * Runtime-state durability: **restored** — operator-drawn regions, zero real churn — 22 writes in 25 minutes, every one of them the clock.
25156
+ *
25157
+ * See `RuntimeStateDurability`. Enforced by
25158
+ * `scripts/check-runtime-state-durability.ts`.
25159
+ */
25160
+ durability: "restored",
25161
+ /** Clock fields: written, but excluded from the compare that decides
25162
+ * whether persisting is worth a SQLite commit. */
25163
+ volatileStateFields: ["lastFetchedAt"]
24708
25164
  };
24709
25165
  var PtzPresetSchema = object({
24710
25166
  id: string(),
@@ -24870,7 +25326,14 @@ var ptzAutotrackCapability = {
24870
25326
  * fetch / cache / fallback logic out of the four cap methods —
24871
25327
  * they become trampolines over `runtimeState`.
24872
25328
  */
24873
- runtimeState: PtzAutotrackRuntimeStateSchema
25329
+ runtimeState: PtzAutotrackRuntimeStateSchema,
25330
+ /**
25331
+ * Runtime-state durability: **session** — mirrors the camera's own autotrack config, re-read on connect.
25332
+ *
25333
+ * See `RuntimeStateDurability`. Enforced by
25334
+ * `scripts/check-runtime-state-durability.ts`.
25335
+ */
25336
+ durability: "session"
24874
25337
  };
24875
25338
  DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceId: number().int().nonnegative() }), object({ success: literal(true) }), {
24876
25339
  kind: "mutation",
@@ -25520,7 +25983,14 @@ var sceneMonitorCapability = {
25520
25983
  schema: SceneMonitorStatusSchema,
25521
25984
  kind: "push"
25522
25985
  },
25523
- runtimeState: SceneMonitorStatusSchema
25986
+ runtimeState: SceneMonitorStatusSchema,
25987
+ /**
25988
+ * Runtime-state durability: **session** — re-derived from the current scene on the next evaluation.
25989
+ *
25990
+ * See `RuntimeStateDurability`. Enforced by
25991
+ * `scripts/check-runtime-state-durability.ts`.
25992
+ */
25993
+ durability: "session"
25524
25994
  };
25525
25995
  /**
25526
25996
  * Per-stage gating mode applied to the zones a rule references.
@@ -25664,7 +26134,14 @@ var scriptRunnerCapability = {
25664
26134
  * `isRunning` to render a spinner during execution and surfaces
25665
26135
  * `lastError` / `lastRunSuccess` in the recent-runs panel.
25666
26136
  */
25667
- runtimeState: ScriptRunnerStatusSchema
26137
+ runtimeState: ScriptRunnerStatusSchema,
26138
+ /**
26139
+ * Runtime-state durability: **session** — a restored `isRunning: true` describes a process that died with the previous hub.
26140
+ *
26141
+ * See `RuntimeStateDurability`. Enforced by
26142
+ * `scripts/check-runtime-state-durability.ts`.
26143
+ */
26144
+ durability: "session"
25668
26145
  };
25669
26146
  /**
25670
26147
  * Smoke alarm sensor — boolean "is smoke currently detected" with
@@ -25691,7 +26168,17 @@ var smokeCapability = {
25691
26168
  schema: SmokeStatusSchema,
25692
26169
  kind: "push"
25693
26170
  },
25694
- runtimeState: SmokeStatusSchema
26171
+ runtimeState: SmokeStatusSchema,
26172
+ /**
26173
+ * Runtime-state durability: **restored** — a safety sensor must not read "clear" merely because the hub restarted.
26174
+ *
26175
+ * See `RuntimeStateDurability`. Enforced by
26176
+ * `scripts/check-runtime-state-durability.ts`.
26177
+ */
26178
+ durability: "restored",
26179
+ /** Clock fields: written, but excluded from the compare that decides
26180
+ * whether persisting is worth a SQLite commit. */
26181
+ volatileStateFields: ["lastChangedAt"]
25695
26182
  };
25696
26183
  /**
25697
26184
  * One publishable camera stream as its OWNING PROVIDER describes it — the same
@@ -25864,7 +26351,17 @@ var streamParamsCapability = {
25864
26351
  schema: StreamParamsStatusSchema,
25865
26352
  kind: "poll"
25866
26353
  },
25867
- runtimeState: StreamParamsStatusSchema
26354
+ runtimeState: StreamParamsStatusSchema,
26355
+ /**
26356
+ * Runtime-state durability: **restored** — operator-set encoder profile; mutation-driven.
26357
+ *
26358
+ * See `RuntimeStateDurability`. Enforced by
26359
+ * `scripts/check-runtime-state-durability.ts`.
26360
+ */
26361
+ durability: "restored",
26362
+ /** Clock fields: written, but excluded from the compare that decides
26363
+ * whether persisting is worth a SQLite commit. */
26364
+ volatileStateFields: ["lastFetchedAt"]
25868
26365
  };
25869
26366
  /**
25870
26367
  * Generic on/off switch cap for accessory children (siren, floodlight,
@@ -25910,6 +26407,16 @@ var switchCapability = {
25910
26407
  * not need to re-query the provider after a setState mutation.
25911
26408
  */
25912
26409
  runtimeState: SwitchStatusSchema,
26410
+ /**
26411
+ * Runtime-state durability: **restored** — device state an operator reads as authoritative; 55 devices, transition-driven.
26412
+ *
26413
+ * See `RuntimeStateDurability`. Enforced by
26414
+ * `scripts/check-runtime-state-durability.ts`.
26415
+ */
26416
+ durability: "restored",
26417
+ /** Clock fields: written, but excluded from the compare that decides
26418
+ * whether persisting is worth a SQLite commit. */
26419
+ volatileStateFields: ["lastChangedAt"],
25913
26420
  settings: { bindings: [{
25914
26421
  kind: "scalar",
25915
26422
  statusPath: "on",
@@ -25989,7 +26496,17 @@ var tamperCapability = {
25989
26496
  schema: TamperStatusSchema,
25990
26497
  kind: "push"
25991
26498
  },
25992
- runtimeState: TamperStatusSchema
26499
+ runtimeState: TamperStatusSchema,
26500
+ /**
26501
+ * Runtime-state durability: **restored** — as `smoke`.
26502
+ *
26503
+ * See `RuntimeStateDurability`. Enforced by
26504
+ * `scripts/check-runtime-state-durability.ts`.
26505
+ */
26506
+ durability: "restored",
26507
+ /** Clock fields: written, but excluded from the compare that decides
26508
+ * whether persisting is worth a SQLite commit. */
26509
+ volatileStateFields: ["lastChangedAt"]
25993
26510
  };
25994
26511
  /**
25995
26512
  * Single-metric temperature reading. Drives Home Assistant `sensor`
@@ -26034,7 +26551,17 @@ var temperatureSensorCapability = {
26034
26551
  schema: TemperatureSensorStatusSchema,
26035
26552
  kind: "push"
26036
26553
  },
26037
- runtimeState: TemperatureSensorStatusSchema
26554
+ runtimeState: TemperatureSensorStatusSchema,
26555
+ /**
26556
+ * Runtime-state durability: **restored** — as `numeric-sensor` (69 of 125 writes were the clock alone).
26557
+ *
26558
+ * See `RuntimeStateDurability`. Enforced by
26559
+ * `scripts/check-runtime-state-durability.ts`.
26560
+ */
26561
+ durability: "restored",
26562
+ /** Clock fields: written, but excluded from the compare that decides
26563
+ * whether persisting is worth a SQLite commit. */
26564
+ volatileStateFields: ["lastFetchedAt"]
26038
26565
  };
26039
26566
  /**
26040
26567
  * toast — system-scoped singleton capability that streams toast
@@ -26103,7 +26630,14 @@ var updateCapability = {
26103
26630
  schema: UpdateStatusSchema,
26104
26631
  kind: "poll"
26105
26632
  },
26106
- runtimeState: UpdateStatusSchema
26633
+ runtimeState: UpdateStatusSchema,
26634
+ /**
26635
+ * Runtime-state durability: **session** — a restored `inProgress: true` describes an update that is no longer running; versions are re-probed at boot.
26636
+ *
26637
+ * See `RuntimeStateDurability`. Enforced by
26638
+ * `scripts/check-runtime-state-durability.ts`.
26639
+ */
26640
+ durability: "session"
26107
26641
  };
26108
26642
  var UserSummarySchema = object({
26109
26643
  id: string(),
@@ -26437,7 +26971,14 @@ var vacuumControlCapability = {
26437
26971
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
26438
26972
  * slice for live state + battery + fan-speed changes.
26439
26973
  */
26440
- runtimeState: VacuumControlStatusSchema
26974
+ runtimeState: VacuumControlStatusSchema,
26975
+ /**
26976
+ * Runtime-state durability: **session** — as `media-player` — a restored `state: cleaning` is a robot that is not cleaning.
26977
+ *
26978
+ * See `RuntimeStateDurability`. Enforced by
26979
+ * `scripts/check-runtime-state-durability.ts`.
26980
+ */
26981
+ durability: "session"
26441
26982
  };
26442
26983
  var ValveStatusSchema = object({
26443
26984
  /** Lifecycle state of the valve. */
@@ -26489,7 +27030,14 @@ var valveCapability = {
26489
27030
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
26490
27031
  * slice for live position changes during a move.
26491
27032
  */
26492
- runtimeState: ValveStatusSchema
27033
+ runtimeState: ValveStatusSchema,
27034
+ /**
27035
+ * Runtime-state durability: **session** — as `brightness`.
27036
+ *
27037
+ * See `RuntimeStateDurability`. Enforced by
27038
+ * `scripts/check-runtime-state-durability.ts`.
27039
+ */
27040
+ durability: "session"
26493
27041
  };
26494
27042
  /**
26495
27043
  * Vibration / shake / impact sensor. Drives Home Assistant
@@ -26511,7 +27059,17 @@ var vibrationCapability = {
26511
27059
  schema: VibrationStatusSchema,
26512
27060
  kind: "push"
26513
27061
  },
26514
- runtimeState: VibrationStatusSchema
27062
+ runtimeState: VibrationStatusSchema,
27063
+ /**
27064
+ * Runtime-state durability: **restored** — as `smoke`.
27065
+ *
27066
+ * See `RuntimeStateDurability`. Enforced by
27067
+ * `scripts/check-runtime-state-durability.ts`.
27068
+ */
27069
+ durability: "restored",
27070
+ /** Clock fields: written, but excluded from the compare that decides
27071
+ * whether persisting is worth a SQLite commit. */
27072
+ volatileStateFields: ["lastChangedAt"]
26515
27073
  };
26516
27074
  /**
26517
27075
  * Water heater / boiler cap. Models HA `water_heater.*` entities — a
@@ -26585,7 +27143,14 @@ var waterHeaterCapability = {
26585
27143
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
26586
27144
  * slice for live temperature / mode / away changes.
26587
27145
  */
26588
- runtimeState: WaterHeaterStatusSchema
27146
+ runtimeState: WaterHeaterStatusSchema,
27147
+ /**
27148
+ * Runtime-state durability: **session** — as `climate-control`.
27149
+ *
27150
+ * See `RuntimeStateDurability`. Enforced by
27151
+ * `scripts/check-runtime-state-durability.ts`.
27152
+ */
27153
+ durability: "session"
26589
27154
  };
26590
27155
  /**
26591
27156
  * Weather provider cap. Models HA `weather.*` entities — a read-only
@@ -26644,7 +27209,14 @@ var weatherCapability = {
26644
27209
  * Runtime-state slice — mirrored by the kernel. The UI reads the
26645
27210
  * current conditions directly from the slice on each weather push.
26646
27211
  */
26647
- runtimeState: WeatherStatusSchema
27212
+ runtimeState: WeatherStatusSchema,
27213
+ /**
27214
+ * Runtime-state durability: **session** — a forecast is stale the moment the hub is down; the provider re-fetches on connect.
27215
+ *
27216
+ * See `RuntimeStateDurability`. Enforced by
27217
+ * `scripts/check-runtime-state-durability.ts`.
27218
+ */
27219
+ durability: "session"
26648
27220
  };
26649
27221
  /**
26650
27222
  * Per-zone occupancy aggregation produced by the analytics frame
@@ -26806,7 +27378,14 @@ var zoneAnalyticsCapability = {
26806
27378
  * automatically; the explicit `getCurrentSnapshot` cap method is
26807
27379
  * still useful for one-off polls without a subscription.
26808
27380
  */
26809
- runtimeState: CameraOccupancySnapshotSchema
27381
+ runtimeState: CameraOccupancySnapshotSchema,
27382
+ /**
27383
+ * Runtime-state durability: **session** — per-frame analytics; with `audio-metrics` it is ~90 % of the offered write rate. Re-derived on the next frame.
27384
+ *
27385
+ * See `RuntimeStateDurability`. Enforced by
27386
+ * `scripts/check-runtime-state-durability.ts`.
27387
+ */
27388
+ durability: "session"
26810
27389
  };
26811
27390
  /**
26812
27391
  * Stages a {@link ZoneRule} can apply to. Discriminator on the rules
@@ -26884,7 +27463,14 @@ var zoneRulesCapability = {
26884
27463
  motion: array(ZoneRuleSchema).readonly(),
26885
27464
  detection: array(ZoneRuleSchema).readonly(),
26886
27465
  package: array(ZoneRuleSchema).readonly()
26887
- })
27466
+ }),
27467
+ /**
27468
+ * Runtime-state durability: **restored** — operator intent, mutation-only, same argument as `zones`.
27469
+ *
27470
+ * See `RuntimeStateDurability`. Enforced by
27471
+ * `scripts/check-runtime-state-durability.ts`.
27472
+ */
27473
+ durability: "restored"
26888
27474
  };
26889
27475
  /**
26890
27476
  * Accessory device helpers — shared across drivers.
@@ -33571,6 +34157,7 @@ Object.freeze({
33571
34157
  "network-access": "ingress",
33572
34158
  "smtp-provider": "email"
33573
34159
  });
34160
+ new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
33574
34161
  new Set(["devices", "classes"]);
33575
34162
  /**
33576
34163
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.