@camstack/addon-provider-homeassistant 1.2.26 → 1.2.27

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.
@@ -10943,7 +10943,14 @@ var cameraStreamsCapability = {
10943
10943
  low: string().optional()
10944
10944
  }),
10945
10945
  lastChangedAt: number()
10946
- })
10946
+ }),
10947
+ /**
10948
+ * 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.
10949
+ *
10950
+ * See `RuntimeStateDurability`. Enforced by
10951
+ * `scripts/check-runtime-state-durability.ts`.
10952
+ */
10953
+ durability: "session"
10947
10954
  };
10948
10955
  /** Where a block runs. The operator chooses — a block driving a device on an
10949
10956
  * agent is the reason placement is not fixed to the hub. */
@@ -11549,6 +11556,13 @@ var deviceDiscoveryCapability = {
11549
11556
  kind: "poll"
11550
11557
  },
11551
11558
  runtimeState: DeviceDiscoveryStatusSchema.extend({ lastFetchedAt: number().int().nonnegative() }),
11559
+ /**
11560
+ * Runtime-state durability: **session** — 5.7 KB of scan output on the largest device, fully re-derivable by re-scanning.
11561
+ *
11562
+ * See `RuntimeStateDurability`. Enforced by
11563
+ * `scripts/check-runtime-state-durability.ts`.
11564
+ */
11565
+ durability: "session",
11552
11566
  methods: {
11553
11567
  /**
11554
11568
  * Snapshot of the current `discovered` list. Returns the
@@ -13490,7 +13504,23 @@ var NotificationActionSchema = object({
13490
13504
  * else — see `notification-center/action-token.ts` for what that does and
13491
13505
  * does not buy.
13492
13506
  */
13493
- destructive: boolean().optional()
13507
+ destructive: boolean().optional(),
13508
+ /**
13509
+ * How the tap should REACH the url.
13510
+ *
13511
+ * `navigate` (absent, and every button authored before this field) opens it:
13512
+ * the phone leaves the notification and shows whatever the callback returns.
13513
+ * That is right for a button whose answer the operator wants to read.
13514
+ *
13515
+ * `background` fires it as a POST and stays put. It exists for the buttons
13516
+ * whose whole point is not to interrupt — "silence this for 30 minutes" is
13517
+ * an answer to the notification, and being thrown into a browser tab to
13518
+ * confirm it costs more attention than the notification did. A backend that
13519
+ * cannot do a background call renders it as an ordinary link (the adapters
13520
+ * fall back rather than dropping the button), so this is a preference, never
13521
+ * a requirement.
13522
+ */
13523
+ mode: _enum(["navigate", "background"]).optional()
13494
13524
  });
13495
13525
  /**
13496
13526
  * The canonical notification. `body` is the only hard field (Apprise model).
@@ -14356,7 +14386,17 @@ var alarmPanelCapability = {
14356
14386
  * full slice; renders an arm button per `availableModes` entry and
14357
14387
  * a PIN field iff `requiresCode === true`.
14358
14388
  */
14359
- runtimeState: AlarmPanelStatusSchema
14389
+ runtimeState: AlarmPanelStatusSchema,
14390
+ /**
14391
+ * Runtime-state durability: **restored** — armed state is the one thing a panel must not lose across a restart.
14392
+ *
14393
+ * See `RuntimeStateDurability`. Enforced by
14394
+ * `scripts/check-runtime-state-durability.ts`.
14395
+ */
14396
+ durability: "restored",
14397
+ /** Clock fields: written, but excluded from the compare that decides
14398
+ * whether persisting is worth a SQLite commit. */
14399
+ volatileStateFields: ["lastChangedAt"]
14360
14400
  };
14361
14401
  /**
14362
14402
  * Shared geometry vocabulary for on-frame shape caps — privacy-mask,
@@ -14533,6 +14573,9 @@ var NcSystemEventConditionSchema = object({
14533
14573
  nodeIds: array(string().min(1)).min(1).optional(),
14534
14574
  packageNames: array(string().min(1)).min(1).optional()
14535
14575
  });
14576
+ /** Hard ceiling on a window (24h). A snooze that could not expire would be an
14577
+ * outage the operator asked for once and forgot. */
14578
+ var NC_SNOOZE_MAX_MINUTES = 1440;
14536
14579
  /** Weekly schedule — OR of windows; absence on the rule = always active. */
14537
14580
  var NcScheduleSchema = object({
14538
14581
  windows: array(object({
@@ -14909,15 +14952,15 @@ var NcConditionsSchema = object({
14909
14952
  * (an `immediate` rule naming an `audio-*` class, one notification per
14910
14953
  * classified sample) stays exactly as it was for rules that already use it.
14911
14954
  *
14912
- * NOT in {@link NC_CONDITION_CATALOG} yet, and that is the sequencing rule
14913
- * rather than an oversight: the viewer mirrors the descriptor enums BY HAND
14914
- * (`camstack/src/data/notification-center.ts`, guarded by
14915
- * `scripts/check-viewer-condition-mirror.ts`) and its rule editor STRIPS the
14955
+ * In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
14956
+ * rule rather than an accident: the viewer mirrors the descriptor enums BY
14957
+ * HAND (`camstack/src/data/notification-center.ts`, guarded by
14958
+ * `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
14916
14959
  * condition fields it does not know when a rule is saved from the phone.
14917
14960
  * Publishing an editor for a condition the app cannot round-trip is how an
14918
- * operator loses a rule's conditions by opening it — so the descriptor, the
14919
- * admin widget and the viewer mirror land together (P2 + P3), and only then
14920
- * does an audio rule become authorable.
14961
+ * operator loses a rule's conditions by opening it — so the viewer mirror
14962
+ * (P3, shipped) went FIRST, and the descriptor an editor renders from
14963
+ * follows here.
14921
14964
  */
14922
14965
  audio: NcAudioConditionSchema.optional()
14923
14966
  });
@@ -15153,6 +15196,30 @@ var NcRuleInputSchema = object({
15153
15196
  */
15154
15197
  snoozeAllowGlobal: boolean().optional(),
15155
15198
  /**
15199
+ * The snooze durations THIS rule's notification offers as buttons, in
15200
+ * minutes.
15201
+ *
15202
+ * Three states, and all three are distinct — which is exactly why this is
15203
+ * `.optional()` and never `.default()`. A Zod default does not run on the
15204
+ * addon cap path (three production failures in one day), so a schema default
15205
+ * would collapse the first two:
15206
+ *
15207
+ * | value | meaning |
15208
+ * | --- | --- |
15209
+ * | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
15210
+ * | `[]` | **no snooze buttons on this rule** — the explicit override |
15211
+ * | a list | these choices, de-duplicated and sorted, at most four |
15212
+ *
15213
+ * `.max(4)` because the notifier's own action budget is small (ntfy allows
15214
+ * three buttons in total) and a rule that spent it all on snooze choices
15215
+ * would push its own tap-through actions off the notification.
15216
+ *
15217
+ * An empty list is NOT an alarm exemption: a rule the alarm is about, or
15218
+ * that arms the panel, is exempt automatically and cannot be silenced by a
15219
+ * window from anywhere (D133).
15220
+ */
15221
+ snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
15222
+ /**
15156
15223
  * Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
15157
15224
  *
15158
15225
  * This is what makes the rule set the alarm's trigger set without the alarm
@@ -15252,6 +15319,7 @@ var NcConditionDescriptorSchema = object({
15252
15319
  "device",
15253
15320
  "package",
15254
15321
  "occupancy",
15322
+ "audio",
15255
15323
  "system"
15256
15324
  ]),
15257
15325
  label: string(),
@@ -15270,6 +15338,7 @@ var NcConditionDescriptorSchema = object({
15270
15338
  "crossingSelect",
15271
15339
  "polygonDraw",
15272
15340
  "occupancy",
15341
+ "audio",
15273
15342
  "deviceState",
15274
15343
  "systemEvent"
15275
15344
  ]),
@@ -15421,7 +15490,20 @@ var NcSnoozeInputSchema = object({
15421
15490
  ruleId: string().optional(),
15422
15491
  /** Required when `scope: 'device'`. */
15423
15492
  deviceId: number().int().optional(),
15424
- durationMinutes: number().int().min(1).max(1440),
15493
+ /**
15494
+ * Narrow the window to these subject classes — "the cat, not the person".
15495
+ *
15496
+ * ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
15497
+ * what every window authored before this field meant, so no persisted row
15498
+ * changes meaning and no client has to learn anything to keep working.
15499
+ *
15500
+ * It is what makes the window's real key `(deviceId, classes[])` and lets it
15501
+ * cross rules (D133): the operator points at a camera and a kind of thing,
15502
+ * not at whichever of their four rules happened to produce the notification
15503
+ * they are dismissing.
15504
+ */
15505
+ classes: array(string().min(1)).min(1).optional(),
15506
+ durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
15425
15507
  /**
15426
15508
  * Silence this for EVERY recipient, not just the caller. Permission is
15427
15509
  * checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
@@ -15446,6 +15528,10 @@ var NcSnoozeSchema = object({
15446
15528
  scope: NcSnoozeScopeSchema,
15447
15529
  ruleId: string().optional(),
15448
15530
  deviceId: number().int().optional(),
15531
+ /** Subject classes this window covers. ABSENT = every class — see
15532
+ * {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
15533
+ * no SQLite column: nothing queries a window by class. */
15534
+ classes: array(string().min(1)).min(1).optional(),
15449
15535
  startedAt: number(),
15450
15536
  /** Exclusive: at exactly this instant the snooze is over. Expiry is a
15451
15537
  * COMPARISON, not a job — no sweeper can leave the operator silenced. */
@@ -17552,7 +17638,14 @@ var zonesCapability = {
17552
17638
  * handle. Slice shape is `{ zones: Zone[] }` so future extensions
17553
17639
  * (e.g. zone groupings) can sit alongside the polygon list.
17554
17640
  */
17555
- runtimeState: object({ zones: array(ZoneSchema).readonly() })
17641
+ runtimeState: object({ zones: array(ZoneSchema).readonly() }),
17642
+ /**
17643
+ * 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.
17644
+ *
17645
+ * See `RuntimeStateDurability`. Enforced by
17646
+ * `scripts/check-runtime-state-durability.ts`.
17647
+ */
17648
+ durability: "restored"
17556
17649
  };
17557
17650
  /**
17558
17651
  * A bounding box in NORMALIZED [0,1] frame coordinates for `getNativeCrop`. The
@@ -20423,7 +20516,17 @@ var airQualitySensorCapability = {
20423
20516
  schema: AirQualitySensorStatusSchema,
20424
20517
  kind: "push"
20425
20518
  },
20426
- runtimeState: AirQualitySensorStatusSchema
20519
+ runtimeState: AirQualitySensorStatusSchema,
20520
+ /**
20521
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
20522
+ *
20523
+ * See `RuntimeStateDurability`. Enforced by
20524
+ * `scripts/check-runtime-state-durability.ts`.
20525
+ */
20526
+ durability: "restored",
20527
+ /** Clock fields: written, but excluded from the compare that decides
20528
+ * whether persisting is worth a SQLite commit. */
20529
+ volatileStateFields: ["lastFetchedAt"]
20427
20530
  };
20428
20531
  /**
20429
20532
  * Ambient illuminance reading in lux. Drives Home Assistant `sensor`
@@ -20455,7 +20558,17 @@ var ambientLightSensorCapability = {
20455
20558
  schema: AmbientLightSensorStatusSchema,
20456
20559
  kind: "push"
20457
20560
  },
20458
- runtimeState: AmbientLightSensorStatusSchema
20561
+ runtimeState: AmbientLightSensorStatusSchema,
20562
+ /**
20563
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
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: ["lastFetchedAt"]
20459
20572
  };
20460
20573
  /**
20461
20574
  * Per-class audio metrics aggregated over a sliding window.
@@ -20573,7 +20686,14 @@ var audioMetricsCapability = {
20573
20686
  }), AudioMetricsHistorySchema)
20574
20687
  },
20575
20688
  /** Reactive runtime-state mirror — live `device.state.audioMetrics.value`. */
20576
- runtimeState: AudioMetricsSnapshotSchema
20689
+ runtimeState: AudioMetricsSnapshotSchema,
20690
+ /**
20691
+ * 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.
20692
+ *
20693
+ * See `RuntimeStateDurability`. Enforced by
20694
+ * `scripts/check-runtime-state-durability.ts`.
20695
+ */
20696
+ durability: "session"
20577
20697
  };
20578
20698
  /**
20579
20699
  * Automation-control cap. Models HA `automation.*` entities on
@@ -20635,7 +20755,14 @@ var automationControlCapability = {
20635
20755
  * reads `enabled` (toggle) + `isRunning` (spinner) + `lastError`
20636
20756
  * (badge) directly.
20637
20757
  */
20638
- runtimeState: AutomationControlStatusSchema
20758
+ runtimeState: AutomationControlStatusSchema,
20759
+ /**
20760
+ * 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.
20761
+ *
20762
+ * See `RuntimeStateDurability`. Enforced by
20763
+ * `scripts/check-runtime-state-durability.ts`.
20764
+ */
20765
+ durability: "session"
20639
20766
  };
20640
20767
  /**
20641
20768
  * Battery status snapshot. Emitted by providers whose device is
@@ -20741,7 +20868,17 @@ onStatusChanged: { data: object({
20741
20868
  * via `device.runtimeState.getCapState('battery')` regardless of
20742
20869
  * the underlying driver.
20743
20870
  */
20744
- runtimeState: BatteryStatusSchema
20871
+ runtimeState: BatteryStatusSchema,
20872
+ /**
20873
+ * 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.
20874
+ *
20875
+ * See `RuntimeStateDurability`. Enforced by
20876
+ * `scripts/check-runtime-state-durability.ts`.
20877
+ */
20878
+ durability: "restored",
20879
+ /** Clock fields: written, but excluded from the compare that decides
20880
+ * whether persisting is worth a SQLite commit. */
20881
+ volatileStateFields: ["lastUpdated"]
20745
20882
  };
20746
20883
  /**
20747
20884
  * Generic boolean sensor — last-resort fallback when no domain-
@@ -20770,7 +20907,17 @@ var binaryCapability = {
20770
20907
  schema: BinaryStatusSchema,
20771
20908
  kind: "push"
20772
20909
  },
20773
- runtimeState: BinaryStatusSchema
20910
+ runtimeState: BinaryStatusSchema,
20911
+ /**
20912
+ * Runtime-state durability: **restored** — transition-driven sensor state; the restored value gives the boot comparison.
20913
+ *
20914
+ * See `RuntimeStateDurability`. Enforced by
20915
+ * `scripts/check-runtime-state-durability.ts`.
20916
+ */
20917
+ durability: "restored",
20918
+ /** Clock fields: written, but excluded from the compare that decides
20919
+ * whether persisting is worth a SQLite commit. */
20920
+ volatileStateFields: ["lastChangedAt"]
20774
20921
  };
20775
20922
  /**
20776
20923
  * Dimmable-light brightness control. Co-exists with `switch` on the
@@ -20823,7 +20970,14 @@ onBrightnessChanged: { data: object({
20823
20970
  * by the kernel. Read via `device.state.brightness.value` so UI
20824
20971
  * sliders surface the current level without polling the provider.
20825
20972
  */
20826
- runtimeState: BrightnessStatusSchema
20973
+ runtimeState: BrightnessStatusSchema,
20974
+ /**
20975
+ * Runtime-state durability: **session** — live lamp state, re-published by the provider on connect.
20976
+ *
20977
+ * See `RuntimeStateDurability`. Enforced by
20978
+ * `scripts/check-runtime-state-durability.ts`.
20979
+ */
20980
+ durability: "session"
20827
20981
  };
20828
20982
  /**
20829
20983
  * button — device-scoped capability for HA `button.*` / `input_button.*`
@@ -20928,7 +21082,17 @@ var carbonMonoxideCapability = {
20928
21082
  schema: CarbonMonoxideStatusSchema,
20929
21083
  kind: "push"
20930
21084
  },
20931
- runtimeState: CarbonMonoxideStatusSchema
21085
+ runtimeState: CarbonMonoxideStatusSchema,
21086
+ /**
21087
+ * Runtime-state durability: **restored** — as `smoke`.
21088
+ *
21089
+ * See `RuntimeStateDurability`. Enforced by
21090
+ * `scripts/check-runtime-state-durability.ts`.
21091
+ */
21092
+ durability: "restored",
21093
+ /** Clock fields: written, but excluded from the compare that decides
21094
+ * whether persisting is worth a SQLite commit. */
21095
+ volatileStateFields: ["lastChangedAt"]
20932
21096
  };
20933
21097
  /**
20934
21098
  * HVAC / climate control cap. Models the full surface of a HA
@@ -21088,7 +21252,14 @@ var climateControlCapability = {
21088
21252
  * the full slice via `device.state.climate-control.value` and refresh
21089
21253
  * on every push without re-querying the provider.
21090
21254
  */
21091
- runtimeState: ClimateControlStatusSchema
21255
+ runtimeState: ClimateControlStatusSchema,
21256
+ /**
21257
+ * Runtime-state durability: **session** — as `brightness`; `currentTemp` moves continuously and is re-published on connect.
21258
+ *
21259
+ * See `RuntimeStateDurability`. Enforced by
21260
+ * `scripts/check-runtime-state-durability.ts`.
21261
+ */
21262
+ durability: "session"
21092
21263
  };
21093
21264
  /**
21094
21265
  * Color-light cap. Coexists with `switch` (on/off) and `brightness`
@@ -21198,7 +21369,14 @@ onColorChanged: { data: object({
21198
21369
  * kernel. Read via `device.state.color.value` so UI pickers surface
21199
21370
  * the current chromaticity without polling the provider.
21200
21371
  */
21201
- runtimeState: ColorStatusSchema
21372
+ runtimeState: ColorStatusSchema,
21373
+ /**
21374
+ * Runtime-state durability: **session** — as `brightness`.
21375
+ *
21376
+ * See `RuntimeStateDurability`. Enforced by
21377
+ * `scripts/check-runtime-state-durability.ts`.
21378
+ */
21379
+ durability: "session"
21202
21380
  };
21203
21381
  var ConnectionTestOutcomeSchema = discriminatedUnion("outcome", [
21204
21382
  object({
@@ -21256,7 +21434,17 @@ var connectivityCapability = {
21256
21434
  schema: ConnectivityStatusSchema,
21257
21435
  kind: "push"
21258
21436
  },
21259
- runtimeState: ConnectivityStatusSchema
21437
+ runtimeState: ConnectivityStatusSchema,
21438
+ /**
21439
+ * Runtime-state durability: **restored** — same shape and same argument as `device-status`, for links rather than devices.
21440
+ *
21441
+ * See `RuntimeStateDurability`. Enforced by
21442
+ * `scripts/check-runtime-state-durability.ts`.
21443
+ */
21444
+ durability: "restored",
21445
+ /** Clock fields: written, but excluded from the compare that decides
21446
+ * whether persisting is worth a SQLite commit. */
21447
+ volatileStateFields: ["lastChangedAt"]
21260
21448
  };
21261
21449
  /**
21262
21450
  * Generic device-consumables capability — surfaces a device's
@@ -21338,7 +21526,14 @@ reset: method(object({
21338
21526
  }
21339
21527
  }
21340
21528
  },
21341
- runtimeState: ConsumablesStatusSchema.extend({ lastFetchedAt: number() })
21529
+ runtimeState: ConsumablesStatusSchema.extend({ lastFetchedAt: number() }),
21530
+ /**
21531
+ * Runtime-state durability: **session** — the authority is the appliance; the provider re-reads the whole item array on connect.
21532
+ *
21533
+ * See `RuntimeStateDurability`. Enforced by
21534
+ * `scripts/check-runtime-state-durability.ts`.
21535
+ */
21536
+ durability: "session"
21342
21537
  };
21343
21538
  /**
21344
21539
  * Door / window / opening / garage / valve contact sensor. Boolean
@@ -21369,7 +21564,17 @@ var contactCapability = {
21369
21564
  schema: ContactStatusSchema,
21370
21565
  kind: "push"
21371
21566
  },
21372
- runtimeState: ContactStatusSchema
21567
+ runtimeState: ContactStatusSchema,
21568
+ /**
21569
+ * Runtime-state durability: **restored** — a door left open across a restart must still read open.
21570
+ *
21571
+ * See `RuntimeStateDurability`. Enforced by
21572
+ * `scripts/check-runtime-state-durability.ts`.
21573
+ */
21574
+ durability: "restored",
21575
+ /** Clock fields: written, but excluded from the compare that decides
21576
+ * whether persisting is worth a SQLite commit. */
21577
+ volatileStateFields: ["lastChangedAt"]
21373
21578
  };
21374
21579
  /**
21375
21580
  * Status slice — flat object (the framework's `runtimeState` contract
@@ -21475,7 +21680,14 @@ var controlCapability = {
21475
21680
  * dropdown / text field / date picker) read the slice's discriminant
21476
21681
  * and value directly without polling the provider.
21477
21682
  */
21478
- runtimeState: ControlStatusSchema
21683
+ runtimeState: ControlStatusSchema,
21684
+ /**
21685
+ * Runtime-state durability: **session** — a generic control mirrors an external entity that re-publishes on connect; the options array is re-derived with it.
21686
+ *
21687
+ * See `RuntimeStateDurability`. Enforced by
21688
+ * `scripts/check-runtime-state-durability.ts`.
21689
+ */
21690
+ durability: "session"
21479
21691
  };
21480
21692
  var CoverStatusSchema = object({
21481
21693
  /** Lifecycle state of the cover. */
@@ -21536,7 +21748,17 @@ var coverCapability = {
21536
21748
  * Runtime-state slice — mirrored by the kernel. UI controls watch
21537
21749
  * the slice for live position changes during a move.
21538
21750
  */
21539
- runtimeState: CoverStatusSchema
21751
+ runtimeState: CoverStatusSchema,
21752
+ /**
21753
+ * Runtime-state durability: **restored** — position survives a restart on the device; the mirror should agree at boot rather than read blank.
21754
+ *
21755
+ * See `RuntimeStateDurability`. Enforced by
21756
+ * `scripts/check-runtime-state-durability.ts`.
21757
+ */
21758
+ durability: "restored",
21759
+ /** Clock fields: written, but excluded from the compare that decides
21760
+ * whether persisting is worth a SQLite commit. */
21761
+ volatileStateFields: ["lastChangedAt"]
21540
21762
  };
21541
21763
  /**
21542
21764
  * Vendor-neutral day/night (IR-cut) control — the per-camera config cap
@@ -21630,7 +21852,17 @@ var dayNightCapability = {
21630
21852
  schema: DayNightStatusSchema,
21631
21853
  kind: "poll"
21632
21854
  },
21633
- runtimeState: DayNightStatusSchema
21855
+ runtimeState: DayNightStatusSchema,
21856
+ /**
21857
+ * Runtime-state durability: **restored** — operator-set IR-cut behaviour; mutation-driven.
21858
+ *
21859
+ * See `RuntimeStateDurability`. Enforced by
21860
+ * `scripts/check-runtime-state-durability.ts`.
21861
+ */
21862
+ durability: "restored",
21863
+ /** Clock fields: written, but excluded from the compare that decides
21864
+ * whether persisting is worth a SQLite commit. */
21865
+ volatileStateFields: ["lastFetchedAt"]
21634
21866
  };
21635
21867
  /**
21636
21868
  * Generic device-level status snapshot. Auto-registered by `BaseDevice`
@@ -21677,7 +21909,17 @@ onStatusChanged: { data: object({
21677
21909
  schema: DeviceStatusSchema,
21678
21910
  kind: "push"
21679
21911
  },
21680
- runtimeState: DeviceStatusSchema
21912
+ runtimeState: DeviceStatusSchema,
21913
+ /**
21914
+ * 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.
21915
+ *
21916
+ * See `RuntimeStateDurability`. Enforced by
21917
+ * `scripts/check-runtime-state-durability.ts`.
21918
+ */
21919
+ durability: "restored",
21920
+ /** Clock fields: written, but excluded from the compare that decides
21921
+ * whether persisting is worth a SQLite commit. */
21922
+ volatileStateFields: ["lastChangedAt"]
21681
21923
  };
21682
21924
  /**
21683
21925
  * Doorbell button cap. Two kinds of providers coexist behind this cap
@@ -21739,7 +21981,14 @@ onPressed: { data: DoorbellPressEventSchema } },
21739
21981
  * `device.state.doorbell.value`. UIs can show "last ring 5m ago"
21740
21982
  * without subscribing.
21741
21983
  */
21742
- runtimeState: DoorbellStatusSchema
21984
+ runtimeState: DoorbellStatusSchema,
21985
+ /**
21986
+ * 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.
21987
+ *
21988
+ * See `RuntimeStateDurability`. Enforced by
21989
+ * `scripts/check-runtime-state-durability.ts`.
21990
+ */
21991
+ durability: "restored"
21743
21992
  };
21744
21993
  /**
21745
21994
  * Enum-state sensor — a string value picked from a finite option set.
@@ -21779,7 +22028,17 @@ var enumSensorCapability = {
21779
22028
  schema: EnumSensorStatusSchema,
21780
22029
  kind: "push"
21781
22030
  },
21782
- runtimeState: EnumSensorStatusSchema
22031
+ runtimeState: EnumSensorStatusSchema,
22032
+ /**
22033
+ * Runtime-state durability: **restored** — as `numeric-sensor`; 80 devices.
22034
+ *
22035
+ * See `RuntimeStateDurability`. Enforced by
22036
+ * `scripts/check-runtime-state-durability.ts`.
22037
+ */
22038
+ durability: "restored",
22039
+ /** Clock fields: written, but excluded from the compare that decides
22040
+ * whether persisting is worth a SQLite commit. */
22041
+ volatileStateFields: ["lastFetchedAt"]
21783
22042
  };
21784
22043
  /**
21785
22044
  * Generic stateless event emitter. Installed on a `DeviceType.EventEmitter`
@@ -21815,7 +22074,14 @@ var eventEmitterCapability = {
21815
22074
  schema: EventEmitterStatusSchema,
21816
22075
  kind: "push"
21817
22076
  },
21818
- runtimeState: EventEmitterStatusSchema
22077
+ runtimeState: EventEmitterStatusSchema,
22078
+ /**
22079
+ * Runtime-state durability: **session** — `eventCountSinceStart` names its own scope.
22080
+ *
22081
+ * See `RuntimeStateDurability`. Enforced by
22082
+ * `scripts/check-runtime-state-durability.ts`.
22083
+ */
22084
+ durability: "session"
21819
22085
  };
21820
22086
  var EventItemSchema = object({
21821
22087
  id: string(),
@@ -22096,7 +22362,14 @@ var fanControlCapability = {
22096
22362
  * Runtime-state slice — mirrored by the kernel. UI fan speed
22097
22363
  * sliders read `percentage` for live updates.
22098
22364
  */
22099
- runtimeState: FanControlStatusSchema
22365
+ runtimeState: FanControlStatusSchema,
22366
+ /**
22367
+ * Runtime-state durability: **session** — as `brightness`.
22368
+ *
22369
+ * See `RuntimeStateDurability`. Enforced by
22370
+ * `scripts/check-runtime-state-durability.ts`.
22371
+ */
22372
+ durability: "session"
22100
22373
  };
22101
22374
  /**
22102
22375
  * Per-device feature/identity probe slice. Holds the runtime-resolved
@@ -22172,7 +22445,14 @@ onProbeChanged: { data: object({
22172
22445
  schema: FeatureProbeStatusSchema,
22173
22446
  kind: "push"
22174
22447
  },
22175
- runtimeState: FeatureProbeStatusSchema
22448
+ runtimeState: FeatureProbeStatusSchema,
22449
+ /**
22450
+ * 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.
22451
+ *
22452
+ * See `RuntimeStateDurability`. Enforced by
22453
+ * `scripts/check-runtime-state-durability.ts`.
22454
+ */
22455
+ durability: "session"
22176
22456
  };
22177
22457
  /**
22178
22458
  * Water leak / moisture sensor. Boolean "is liquid currently
@@ -22199,7 +22479,17 @@ var floodCapability = {
22199
22479
  schema: FloodStatusSchema,
22200
22480
  kind: "push"
22201
22481
  },
22202
- runtimeState: FloodStatusSchema
22482
+ runtimeState: FloodStatusSchema,
22483
+ /**
22484
+ * Runtime-state durability: **restored** — as `smoke`.
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: ["lastChangedAt"]
22203
22493
  };
22204
22494
  /**
22205
22495
  * Combustible-gas (LPG / methane / hydrogen) alarm sensor. Drives
@@ -22222,7 +22512,17 @@ var gasCapability = {
22222
22512
  schema: GasStatusSchema,
22223
22513
  kind: "push"
22224
22514
  },
22225
- runtimeState: GasStatusSchema
22515
+ runtimeState: GasStatusSchema,
22516
+ /**
22517
+ * Runtime-state durability: **restored** — as `smoke`.
22518
+ *
22519
+ * See `RuntimeStateDurability`. Enforced by
22520
+ * `scripts/check-runtime-state-durability.ts`.
22521
+ */
22522
+ durability: "restored",
22523
+ /** Clock fields: written, but excluded from the compare that decides
22524
+ * whether persisting is worth a SQLite commit. */
22525
+ volatileStateFields: ["lastChangedAt"]
22226
22526
  };
22227
22527
  /**
22228
22528
  * Humidifier / dehumidifier cap. Models HA `humidifier.*` entities —
@@ -22298,7 +22598,14 @@ var humidifierCapability = {
22298
22598
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
22299
22599
  * slice for live humidity / mode changes.
22300
22600
  */
22301
- runtimeState: HumidifierStatusSchema
22601
+ runtimeState: HumidifierStatusSchema,
22602
+ /**
22603
+ * Runtime-state durability: **session** — as `climate-control`.
22604
+ *
22605
+ * See `RuntimeStateDurability`. Enforced by
22606
+ * `scripts/check-runtime-state-durability.ts`.
22607
+ */
22608
+ durability: "session"
22302
22609
  };
22303
22610
  /**
22304
22611
  * Single-metric humidity reading. Drives Home Assistant `sensor`
@@ -22334,7 +22641,17 @@ var humiditySensorCapability = {
22334
22641
  schema: HumiditySensorStatusSchema,
22335
22642
  kind: "push"
22336
22643
  },
22337
- runtimeState: HumiditySensorStatusSchema
22644
+ runtimeState: HumiditySensorStatusSchema,
22645
+ /**
22646
+ * Runtime-state durability: **restored** — as `numeric-sensor` (67 of 75 writes were the clock alone).
22647
+ *
22648
+ * See `RuntimeStateDurability`. Enforced by
22649
+ * `scripts/check-runtime-state-durability.ts`.
22650
+ */
22651
+ durability: "restored",
22652
+ /** Clock fields: written, but excluded from the compare that decides
22653
+ * whether persisting is worth a SQLite commit. */
22654
+ volatileStateFields: ["lastFetchedAt"]
22338
22655
  };
22339
22656
  /**
22340
22657
  * Image display cap. Models a single still image exposed by an integration —
@@ -22372,7 +22689,14 @@ var imageCapability = {
22372
22689
  * Runtime-state slice — mirrored by the kernel. The UI reads `url`
22373
22690
  * directly and renders the still image.
22374
22691
  */
22375
- runtimeState: ImageStatusSchema
22692
+ runtimeState: ImageStatusSchema,
22693
+ /**
22694
+ * Runtime-state durability: **session** — a snapshot URL is a session-scoped handle; a restored one points at nothing.
22695
+ *
22696
+ * See `RuntimeStateDurability`. Enforced by
22697
+ * `scripts/check-runtime-state-durability.ts`.
22698
+ */
22699
+ durability: "session"
22376
22700
  };
22377
22701
  /**
22378
22702
  * Vendor-neutral image / picture-adjustment cap — the per-camera config
@@ -22521,7 +22845,17 @@ var imageSettingsCapability = {
22521
22845
  schema: ImageSettingsStatusSchema,
22522
22846
  kind: "poll"
22523
22847
  },
22524
- runtimeState: ImageSettingsStatusSchema
22848
+ runtimeState: ImageSettingsStatusSchema,
22849
+ /**
22850
+ * Runtime-state durability: **restored** — operator-set camera imaging; mutation-driven.
22851
+ *
22852
+ * See `RuntimeStateDurability`. Enforced by
22853
+ * `scripts/check-runtime-state-durability.ts`.
22854
+ */
22855
+ durability: "restored",
22856
+ /** Clock fields: written, but excluded from the compare that decides
22857
+ * whether persisting is worth a SQLite commit. */
22858
+ volatileStateFields: ["lastFetchedAt"]
22525
22859
  };
22526
22860
  /**
22527
22861
  * integrations — system-scoped singleton capability for integration
@@ -22861,7 +23195,14 @@ var lawnMowerControlCapability = {
22861
23195
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
22862
23196
  * slice for live activity + battery changes.
22863
23197
  */
22864
- runtimeState: LawnMowerControlStatusSchema
23198
+ runtimeState: LawnMowerControlStatusSchema,
23199
+ /**
23200
+ * Runtime-state durability: **session** — as `vacuum-control`.
23201
+ *
23202
+ * See `RuntimeStateDurability`. Enforced by
23203
+ * `scripts/check-runtime-state-durability.ts`.
23204
+ */
23205
+ durability: "session"
22865
23206
  };
22866
23207
  /**
22867
23208
  * local-network — hub-only singleton.
@@ -23067,7 +23408,17 @@ var lockControlCapability = {
23067
23408
  * read `state` and disable themselves during `locking`/`unlocking`
23068
23409
  * transitions.
23069
23410
  */
23070
- runtimeState: LockControlStatusSchema
23411
+ runtimeState: LockControlStatusSchema,
23412
+ /**
23413
+ * Runtime-state durability: **restored** — a lock left locked must still read locked.
23414
+ *
23415
+ * See `RuntimeStateDurability`. Enforced by
23416
+ * `scripts/check-runtime-state-durability.ts`.
23417
+ */
23418
+ durability: "restored",
23419
+ /** Clock fields: written, but excluded from the compare that decides
23420
+ * whether persisting is worth a SQLite commit. */
23421
+ volatileStateFields: ["lastChangedAt"]
23071
23422
  };
23072
23423
  /**
23073
23424
  * Media-player cap. Models HA `media_player.*` (Sonos, Chromecast,
@@ -23229,7 +23580,14 @@ var mediaPlayerCapability = {
23229
23580
  * full slice for live now-playing, volume, and progress updates
23230
23581
  * without polling.
23231
23582
  */
23232
- runtimeState: MediaPlayerStatusSchema
23583
+ runtimeState: MediaPlayerStatusSchema,
23584
+ /**
23585
+ * Runtime-state durability: **session** — a restored transport position describes a playback that stopped when the hub did.
23586
+ *
23587
+ * See `RuntimeStateDurability`. Enforced by
23588
+ * `scripts/check-runtime-state-durability.ts`.
23589
+ */
23590
+ durability: "session"
23233
23591
  };
23234
23592
  /**
23235
23593
  * mesh-network — collection cap for mesh-VPN providers.
@@ -23493,7 +23851,14 @@ onMotionChanged: { data: MotionOnMotionChangedDataSchema } },
23493
23851
  * `device.state.motion.value`. Reads never invoke the provider, so
23494
23852
  * UIs and other addons can poll the cached state safely.
23495
23853
  */
23496
- runtimeState: MotionStatusSchema
23854
+ runtimeState: MotionStatusSchema,
23855
+ /**
23856
+ * 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.
23857
+ *
23858
+ * See `RuntimeStateDurability`. Enforced by
23859
+ * `scripts/check-runtime-state-durability.ts`.
23860
+ */
23861
+ durability: "session"
23497
23862
  };
23498
23863
  /**
23499
23864
  * Motion-trigger toggle for accessory devices.
@@ -23558,7 +23923,14 @@ var motionTriggerCapability = {
23558
23923
  schema: MotionTriggerStatusSchema,
23559
23924
  kind: "command-driven"
23560
23925
  },
23561
- runtimeState: MotionTriggerRuntimeStateSchema
23926
+ runtimeState: MotionTriggerRuntimeStateSchema,
23927
+ /**
23928
+ * 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.
23929
+ *
23930
+ * See `RuntimeStateDurability`. Enforced by
23931
+ * `scripts/check-runtime-state-durability.ts`.
23932
+ */
23933
+ durability: "session"
23562
23934
  };
23563
23935
  /**
23564
23936
  * Motion-zones share the same MaskShape vocabulary as privacy-mask — the
@@ -23625,7 +23997,17 @@ var motionZonesCapability = {
23625
23997
  schema: MotionZoneStatusSchema,
23626
23998
  kind: "poll"
23627
23999
  },
23628
- runtimeState: MotionZoneStatusSchema
24000
+ runtimeState: MotionZoneStatusSchema,
24001
+ /**
24002
+ * 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.
24003
+ *
24004
+ * See `RuntimeStateDurability`. Enforced by
24005
+ * `scripts/check-runtime-state-durability.ts`.
24006
+ */
24007
+ durability: "restored",
24008
+ /** Clock fields: written, but excluded from the compare that decides
24009
+ * whether persisting is worth a SQLite commit. */
24010
+ volatileStateFields: ["lastFetchedAt"]
23629
24011
  };
23630
24012
  /**
23631
24013
  * On-camera AI object detection cap. Surfaces per-device the classes
@@ -23699,7 +24081,17 @@ var nativeObjectDetectionCapability = {
23699
24081
  schema: NativeObjectDetectionStatusSchema,
23700
24082
  kind: "push"
23701
24083
  },
23702
- runtimeState: NativeObjectDetectionRuntimeStateSchema
24084
+ runtimeState: NativeObjectDetectionRuntimeStateSchema,
24085
+ /**
24086
+ * 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.
24087
+ *
24088
+ * See `RuntimeStateDurability`. Enforced by
24089
+ * `scripts/check-runtime-state-durability.ts`.
24090
+ */
24091
+ durability: "restored",
24092
+ /** Clock fields: written, but excluded from the compare that decides
24093
+ * whether persisting is worth a SQLite commit. */
24094
+ volatileStateFields: ["lastFetchedAt"]
23703
24095
  };
23704
24096
  /**
23705
24097
  * network-quality — system-scoped singleton capability tracking RTT,
@@ -24033,7 +24425,14 @@ onSent: { data: object({
24033
24425
  * form reads `supports` to gate optional fields; history pane reads
24034
24426
  * `lastSentAt` / `lastError` / `queueDepth`.
24035
24427
  */
24036
- runtimeState: NotifierStatusSchema
24428
+ runtimeState: NotifierStatusSchema,
24429
+ /**
24430
+ * Runtime-state durability: **session** — live queue depth and last-send state; a restored queue depth describes a queue that no longer exists.
24431
+ *
24432
+ * See `RuntimeStateDurability`. Enforced by
24433
+ * `scripts/check-runtime-state-durability.ts`.
24434
+ */
24435
+ durability: "session"
24037
24436
  };
24038
24437
  /**
24039
24438
  * Generic numeric sensor — last-resort fallback when no typed numeric
@@ -24076,7 +24475,17 @@ var numericSensorCapability = {
24076
24475
  schema: NumericSensorStatusSchema,
24077
24476
  kind: "push"
24078
24477
  },
24079
- runtimeState: NumericSensorStatusSchema
24478
+ runtimeState: NumericSensorStatusSchema,
24479
+ /**
24480
+ * 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.
24481
+ *
24482
+ * See `RuntimeStateDurability`. Enforced by
24483
+ * `scripts/check-runtime-state-durability.ts`.
24484
+ */
24485
+ durability: "restored",
24486
+ /** Clock fields: written, but excluded from the compare that decides
24487
+ * whether persisting is worth a SQLite commit. */
24488
+ volatileStateFields: ["lastFetchedAt"]
24080
24489
  };
24081
24490
  /**
24082
24491
  * Generic on-screen-display (video overlay) cap. Each camera exposes
@@ -24461,7 +24870,14 @@ var petFeederCapability = {
24461
24870
  * the full slice via `device.state.petFeeder.value` and refresh on
24462
24871
  * every poll without re-querying the provider.
24463
24872
  */
24464
- runtimeState: PetFeederStatusSchema
24873
+ runtimeState: PetFeederStatusSchema,
24874
+ /**
24875
+ * Runtime-state durability: **session** — live appliance state re-published on connect.
24876
+ *
24877
+ * See `RuntimeStateDurability`. Enforced by
24878
+ * `scripts/check-runtime-state-durability.ts`.
24879
+ */
24880
+ durability: "session"
24465
24881
  };
24466
24882
  var VehicleSchema = object({
24467
24883
  id: string(),
@@ -24773,7 +25189,17 @@ var powerMeterCapability = {
24773
25189
  schema: PowerMeterStatusSchema,
24774
25190
  kind: "push"
24775
25191
  },
24776
- runtimeState: PowerMeterStatusSchema
25192
+ runtimeState: PowerMeterStatusSchema,
25193
+ /**
25194
+ * Runtime-state durability: **restored** — as `numeric-sensor`; `kwhTotal` is an accumulator whose restored value is the baseline.
25195
+ *
25196
+ * See `RuntimeStateDurability`. Enforced by
25197
+ * `scripts/check-runtime-state-durability.ts`.
25198
+ */
25199
+ durability: "restored",
25200
+ /** Clock fields: written, but excluded from the compare that decides
25201
+ * whether persisting is worth a SQLite commit. */
25202
+ volatileStateFields: ["lastFetchedAt"]
24777
25203
  };
24778
25204
  /**
24779
25205
  * Presence cap. Models HA `person.*` and `device_tracker.*` entities
@@ -24830,7 +25256,17 @@ var presenceCapability = {
24830
25256
  * the map pin is rendered (use `DeviceFeature.PresenceGps` for the
24831
25257
  * pre-fetch fast-path check).
24832
25258
  */
24833
- runtimeState: PresenceStatusSchema
25259
+ runtimeState: PresenceStatusSchema,
25260
+ /**
25261
+ * Runtime-state durability: **restored** — occupancy-relevant: the restored state is what an occupancy rule compares the first post-restart observation against.
25262
+ *
25263
+ * See `RuntimeStateDurability`. Enforced by
25264
+ * `scripts/check-runtime-state-durability.ts`.
25265
+ */
25266
+ durability: "restored",
25267
+ /** Clock fields: written, but excluded from the compare that decides
25268
+ * whether persisting is worth a SQLite commit. */
25269
+ volatileStateFields: ["lastChangedAt"]
24834
25270
  };
24835
25271
  /**
24836
25272
  * Atmospheric pressure reading in hectopascals. Drives Home Assistant
@@ -24866,7 +25302,17 @@ var pressureSensorCapability = {
24866
25302
  schema: PressureSensorStatusSchema,
24867
25303
  kind: "push"
24868
25304
  },
24869
- runtimeState: PressureSensorStatusSchema
25305
+ runtimeState: PressureSensorStatusSchema,
25306
+ /**
25307
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
25308
+ *
25309
+ * See `RuntimeStateDurability`. Enforced by
25310
+ * `scripts/check-runtime-state-durability.ts`.
25311
+ */
25312
+ durability: "restored",
25313
+ /** Clock fields: written, but excluded from the compare that decides
25314
+ * whether persisting is worth a SQLite commit. */
25315
+ volatileStateFields: ["lastFetchedAt"]
24870
25316
  };
24871
25317
  /**
24872
25318
  * PRIVACY — what the camera deliberately does not capture. Two planes:
@@ -24996,7 +25442,17 @@ var privacyMaskCapability = {
24996
25442
  schema: PrivacyMaskStatusSchema,
24997
25443
  kind: "poll"
24998
25444
  },
24999
- runtimeState: PrivacyMaskStatusSchema
25445
+ runtimeState: PrivacyMaskStatusSchema,
25446
+ /**
25447
+ * Runtime-state durability: **restored** — operator-drawn regions, zero real churn — 22 writes in 25 minutes, every one of them the clock.
25448
+ *
25449
+ * See `RuntimeStateDurability`. Enforced by
25450
+ * `scripts/check-runtime-state-durability.ts`.
25451
+ */
25452
+ durability: "restored",
25453
+ /** Clock fields: written, but excluded from the compare that decides
25454
+ * whether persisting is worth a SQLite commit. */
25455
+ volatileStateFields: ["lastFetchedAt"]
25000
25456
  };
25001
25457
  var PtzPresetSchema = object({
25002
25458
  id: string(),
@@ -25162,7 +25618,14 @@ var ptzAutotrackCapability = {
25162
25618
  * fetch / cache / fallback logic out of the four cap methods —
25163
25619
  * they become trampolines over `runtimeState`.
25164
25620
  */
25165
- runtimeState: PtzAutotrackRuntimeStateSchema
25621
+ runtimeState: PtzAutotrackRuntimeStateSchema,
25622
+ /**
25623
+ * Runtime-state durability: **session** — mirrors the camera's own autotrack config, re-read on connect.
25624
+ *
25625
+ * See `RuntimeStateDurability`. Enforced by
25626
+ * `scripts/check-runtime-state-durability.ts`.
25627
+ */
25628
+ durability: "session"
25166
25629
  };
25167
25630
  DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceId: number().int().nonnegative() }), object({ success: literal(true) }), {
25168
25631
  kind: "mutation",
@@ -25812,7 +26275,14 @@ var sceneMonitorCapability = {
25812
26275
  schema: SceneMonitorStatusSchema,
25813
26276
  kind: "push"
25814
26277
  },
25815
- runtimeState: SceneMonitorStatusSchema
26278
+ runtimeState: SceneMonitorStatusSchema,
26279
+ /**
26280
+ * Runtime-state durability: **session** — re-derived from the current scene on the next evaluation.
26281
+ *
26282
+ * See `RuntimeStateDurability`. Enforced by
26283
+ * `scripts/check-runtime-state-durability.ts`.
26284
+ */
26285
+ durability: "session"
25816
26286
  };
25817
26287
  /**
25818
26288
  * Per-stage gating mode applied to the zones a rule references.
@@ -25956,7 +26426,14 @@ var scriptRunnerCapability = {
25956
26426
  * `isRunning` to render a spinner during execution and surfaces
25957
26427
  * `lastError` / `lastRunSuccess` in the recent-runs panel.
25958
26428
  */
25959
- runtimeState: ScriptRunnerStatusSchema
26429
+ runtimeState: ScriptRunnerStatusSchema,
26430
+ /**
26431
+ * Runtime-state durability: **session** — a restored `isRunning: true` describes a process that died with the previous hub.
26432
+ *
26433
+ * See `RuntimeStateDurability`. Enforced by
26434
+ * `scripts/check-runtime-state-durability.ts`.
26435
+ */
26436
+ durability: "session"
25960
26437
  };
25961
26438
  /**
25962
26439
  * Smoke alarm sensor — boolean "is smoke currently detected" with
@@ -25983,7 +26460,17 @@ var smokeCapability = {
25983
26460
  schema: SmokeStatusSchema,
25984
26461
  kind: "push"
25985
26462
  },
25986
- runtimeState: SmokeStatusSchema
26463
+ runtimeState: SmokeStatusSchema,
26464
+ /**
26465
+ * Runtime-state durability: **restored** — a safety sensor must not read "clear" merely because the hub restarted.
26466
+ *
26467
+ * See `RuntimeStateDurability`. Enforced by
26468
+ * `scripts/check-runtime-state-durability.ts`.
26469
+ */
26470
+ durability: "restored",
26471
+ /** Clock fields: written, but excluded from the compare that decides
26472
+ * whether persisting is worth a SQLite commit. */
26473
+ volatileStateFields: ["lastChangedAt"]
25987
26474
  };
25988
26475
  /**
25989
26476
  * One publishable camera stream as its OWNING PROVIDER describes it — the same
@@ -26156,7 +26643,17 @@ var streamParamsCapability = {
26156
26643
  schema: StreamParamsStatusSchema,
26157
26644
  kind: "poll"
26158
26645
  },
26159
- runtimeState: StreamParamsStatusSchema
26646
+ runtimeState: StreamParamsStatusSchema,
26647
+ /**
26648
+ * Runtime-state durability: **restored** — operator-set encoder profile; mutation-driven.
26649
+ *
26650
+ * See `RuntimeStateDurability`. Enforced by
26651
+ * `scripts/check-runtime-state-durability.ts`.
26652
+ */
26653
+ durability: "restored",
26654
+ /** Clock fields: written, but excluded from the compare that decides
26655
+ * whether persisting is worth a SQLite commit. */
26656
+ volatileStateFields: ["lastFetchedAt"]
26160
26657
  };
26161
26658
  /**
26162
26659
  * Generic on/off switch cap for accessory children (siren, floodlight,
@@ -26202,6 +26699,16 @@ var switchCapability = {
26202
26699
  * not need to re-query the provider after a setState mutation.
26203
26700
  */
26204
26701
  runtimeState: SwitchStatusSchema,
26702
+ /**
26703
+ * Runtime-state durability: **restored** — device state an operator reads as authoritative; 55 devices, transition-driven.
26704
+ *
26705
+ * See `RuntimeStateDurability`. Enforced by
26706
+ * `scripts/check-runtime-state-durability.ts`.
26707
+ */
26708
+ durability: "restored",
26709
+ /** Clock fields: written, but excluded from the compare that decides
26710
+ * whether persisting is worth a SQLite commit. */
26711
+ volatileStateFields: ["lastChangedAt"],
26205
26712
  settings: { bindings: [{
26206
26713
  kind: "scalar",
26207
26714
  statusPath: "on",
@@ -26281,7 +26788,17 @@ var tamperCapability = {
26281
26788
  schema: TamperStatusSchema,
26282
26789
  kind: "push"
26283
26790
  },
26284
- runtimeState: TamperStatusSchema
26791
+ runtimeState: TamperStatusSchema,
26792
+ /**
26793
+ * Runtime-state durability: **restored** — as `smoke`.
26794
+ *
26795
+ * See `RuntimeStateDurability`. Enforced by
26796
+ * `scripts/check-runtime-state-durability.ts`.
26797
+ */
26798
+ durability: "restored",
26799
+ /** Clock fields: written, but excluded from the compare that decides
26800
+ * whether persisting is worth a SQLite commit. */
26801
+ volatileStateFields: ["lastChangedAt"]
26285
26802
  };
26286
26803
  /**
26287
26804
  * Single-metric temperature reading. Drives Home Assistant `sensor`
@@ -26326,7 +26843,17 @@ var temperatureSensorCapability = {
26326
26843
  schema: TemperatureSensorStatusSchema,
26327
26844
  kind: "push"
26328
26845
  },
26329
- runtimeState: TemperatureSensorStatusSchema
26846
+ runtimeState: TemperatureSensorStatusSchema,
26847
+ /**
26848
+ * Runtime-state durability: **restored** — as `numeric-sensor` (69 of 125 writes were the clock alone).
26849
+ *
26850
+ * See `RuntimeStateDurability`. Enforced by
26851
+ * `scripts/check-runtime-state-durability.ts`.
26852
+ */
26853
+ durability: "restored",
26854
+ /** Clock fields: written, but excluded from the compare that decides
26855
+ * whether persisting is worth a SQLite commit. */
26856
+ volatileStateFields: ["lastFetchedAt"]
26330
26857
  };
26331
26858
  /**
26332
26859
  * toast — system-scoped singleton capability that streams toast
@@ -26395,7 +26922,14 @@ var updateCapability = {
26395
26922
  schema: UpdateStatusSchema,
26396
26923
  kind: "poll"
26397
26924
  },
26398
- runtimeState: UpdateStatusSchema
26925
+ runtimeState: UpdateStatusSchema,
26926
+ /**
26927
+ * Runtime-state durability: **session** — a restored `inProgress: true` describes an update that is no longer running; versions are re-probed at boot.
26928
+ *
26929
+ * See `RuntimeStateDurability`. Enforced by
26930
+ * `scripts/check-runtime-state-durability.ts`.
26931
+ */
26932
+ durability: "session"
26399
26933
  };
26400
26934
  var UserSummarySchema = object({
26401
26935
  id: string(),
@@ -26729,7 +27263,14 @@ var vacuumControlCapability = {
26729
27263
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
26730
27264
  * slice for live state + battery + fan-speed changes.
26731
27265
  */
26732
- runtimeState: VacuumControlStatusSchema
27266
+ runtimeState: VacuumControlStatusSchema,
27267
+ /**
27268
+ * Runtime-state durability: **session** — as `media-player` — a restored `state: cleaning` is a robot that is not cleaning.
27269
+ *
27270
+ * See `RuntimeStateDurability`. Enforced by
27271
+ * `scripts/check-runtime-state-durability.ts`.
27272
+ */
27273
+ durability: "session"
26733
27274
  };
26734
27275
  var ValveStatusSchema = object({
26735
27276
  /** Lifecycle state of the valve. */
@@ -26781,7 +27322,14 @@ var valveCapability = {
26781
27322
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
26782
27323
  * slice for live position changes during a move.
26783
27324
  */
26784
- runtimeState: ValveStatusSchema
27325
+ runtimeState: ValveStatusSchema,
27326
+ /**
27327
+ * Runtime-state durability: **session** — as `brightness`.
27328
+ *
27329
+ * See `RuntimeStateDurability`. Enforced by
27330
+ * `scripts/check-runtime-state-durability.ts`.
27331
+ */
27332
+ durability: "session"
26785
27333
  };
26786
27334
  /**
26787
27335
  * Vibration / shake / impact sensor. Drives Home Assistant
@@ -26803,7 +27351,17 @@ var vibrationCapability = {
26803
27351
  schema: VibrationStatusSchema,
26804
27352
  kind: "push"
26805
27353
  },
26806
- runtimeState: VibrationStatusSchema
27354
+ runtimeState: VibrationStatusSchema,
27355
+ /**
27356
+ * Runtime-state durability: **restored** — as `smoke`.
27357
+ *
27358
+ * See `RuntimeStateDurability`. Enforced by
27359
+ * `scripts/check-runtime-state-durability.ts`.
27360
+ */
27361
+ durability: "restored",
27362
+ /** Clock fields: written, but excluded from the compare that decides
27363
+ * whether persisting is worth a SQLite commit. */
27364
+ volatileStateFields: ["lastChangedAt"]
26807
27365
  };
26808
27366
  /**
26809
27367
  * Water heater / boiler cap. Models HA `water_heater.*` entities — a
@@ -26877,7 +27435,14 @@ var waterHeaterCapability = {
26877
27435
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
26878
27436
  * slice for live temperature / mode / away changes.
26879
27437
  */
26880
- runtimeState: WaterHeaterStatusSchema
27438
+ runtimeState: WaterHeaterStatusSchema,
27439
+ /**
27440
+ * Runtime-state durability: **session** — as `climate-control`.
27441
+ *
27442
+ * See `RuntimeStateDurability`. Enforced by
27443
+ * `scripts/check-runtime-state-durability.ts`.
27444
+ */
27445
+ durability: "session"
26881
27446
  };
26882
27447
  /**
26883
27448
  * Weather provider cap. Models HA `weather.*` entities — a read-only
@@ -26936,7 +27501,14 @@ var weatherCapability = {
26936
27501
  * Runtime-state slice — mirrored by the kernel. The UI reads the
26937
27502
  * current conditions directly from the slice on each weather push.
26938
27503
  */
26939
- runtimeState: WeatherStatusSchema
27504
+ runtimeState: WeatherStatusSchema,
27505
+ /**
27506
+ * Runtime-state durability: **session** — a forecast is stale the moment the hub is down; the provider re-fetches on connect.
27507
+ *
27508
+ * See `RuntimeStateDurability`. Enforced by
27509
+ * `scripts/check-runtime-state-durability.ts`.
27510
+ */
27511
+ durability: "session"
26940
27512
  };
26941
27513
  /**
26942
27514
  * Per-zone occupancy aggregation produced by the analytics frame
@@ -27098,7 +27670,14 @@ var zoneAnalyticsCapability = {
27098
27670
  * automatically; the explicit `getCurrentSnapshot` cap method is
27099
27671
  * still useful for one-off polls without a subscription.
27100
27672
  */
27101
- runtimeState: CameraOccupancySnapshotSchema
27673
+ runtimeState: CameraOccupancySnapshotSchema,
27674
+ /**
27675
+ * Runtime-state durability: **session** — per-frame analytics; with `audio-metrics` it is ~90 % of the offered write rate. Re-derived on the next frame.
27676
+ *
27677
+ * See `RuntimeStateDurability`. Enforced by
27678
+ * `scripts/check-runtime-state-durability.ts`.
27679
+ */
27680
+ durability: "session"
27102
27681
  };
27103
27682
  /**
27104
27683
  * Stages a {@link ZoneRule} can apply to. Discriminator on the rules
@@ -27176,7 +27755,14 @@ var zoneRulesCapability = {
27176
27755
  motion: array(ZoneRuleSchema).readonly(),
27177
27756
  detection: array(ZoneRuleSchema).readonly(),
27178
27757
  package: array(ZoneRuleSchema).readonly()
27179
- })
27758
+ }),
27759
+ /**
27760
+ * Runtime-state durability: **restored** — operator intent, mutation-only, same argument as `zones`.
27761
+ *
27762
+ * See `RuntimeStateDurability`. Enforced by
27763
+ * `scripts/check-runtime-state-durability.ts`.
27764
+ */
27765
+ durability: "restored"
27180
27766
  };
27181
27767
  /**
27182
27768
  * Accessory device helpers — shared across drivers.
@@ -33863,6 +34449,7 @@ Object.freeze({
33863
34449
  "network-access": "ingress",
33864
34450
  "smtp-provider": "email"
33865
34451
  });
34452
+ new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
33866
34453
  new Set(["devices", "classes"]);
33867
34454
  /** Strip a small, safe subset of Markdown down to plain text. */
33868
34455
  function markdownToText(md) {