@camstack/addon-provider-rademacher 0.2.14 → 0.2.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/dist/addon.js +656 -69
  2. package/dist/addon.mjs +656 -69
  3. package/package.json +1 -1
package/dist/addon.mjs CHANGED
@@ -11755,7 +11755,14 @@ var cameraStreamsCapability = {
11755
11755
  low: string().optional()
11756
11756
  }),
11757
11757
  lastChangedAt: number()
11758
- })
11758
+ }),
11759
+ /**
11760
+ * 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.
11761
+ *
11762
+ * See `RuntimeStateDurability`. Enforced by
11763
+ * `scripts/check-runtime-state-durability.ts`.
11764
+ */
11765
+ durability: "session"
11759
11766
  };
11760
11767
  /** Where a block runs. The operator chooses — a block driving a device on an
11761
11768
  * agent is the reason placement is not fixed to the hub. */
@@ -12316,6 +12323,13 @@ var deviceDiscoveryCapability = {
12316
12323
  kind: "poll"
12317
12324
  },
12318
12325
  runtimeState: DeviceDiscoveryStatusSchema.extend({ lastFetchedAt: number().int().nonnegative() }),
12326
+ /**
12327
+ * Runtime-state durability: **session** — 5.7 KB of scan output on the largest device, fully re-derivable by re-scanning.
12328
+ *
12329
+ * See `RuntimeStateDurability`. Enforced by
12330
+ * `scripts/check-runtime-state-durability.ts`.
12331
+ */
12332
+ durability: "session",
12319
12333
  methods: {
12320
12334
  /**
12321
12335
  * Snapshot of the current `discovered` list. Returns the
@@ -14215,7 +14229,23 @@ var NotificationActionSchema = object({
14215
14229
  * else — see `notification-center/action-token.ts` for what that does and
14216
14230
  * does not buy.
14217
14231
  */
14218
- destructive: boolean().optional()
14232
+ destructive: boolean().optional(),
14233
+ /**
14234
+ * How the tap should REACH the url.
14235
+ *
14236
+ * `navigate` (absent, and every button authored before this field) opens it:
14237
+ * the phone leaves the notification and shows whatever the callback returns.
14238
+ * That is right for a button whose answer the operator wants to read.
14239
+ *
14240
+ * `background` fires it as a POST and stays put. It exists for the buttons
14241
+ * whose whole point is not to interrupt — "silence this for 30 minutes" is
14242
+ * an answer to the notification, and being thrown into a browser tab to
14243
+ * confirm it costs more attention than the notification did. A backend that
14244
+ * cannot do a background call renders it as an ordinary link (the adapters
14245
+ * fall back rather than dropping the button), so this is a preference, never
14246
+ * a requirement.
14247
+ */
14248
+ mode: _enum(["navigate", "background"]).optional()
14219
14249
  });
14220
14250
  /**
14221
14251
  * The canonical notification. `body` is the only hard field (Apprise model).
@@ -15067,7 +15097,17 @@ var alarmPanelCapability = {
15067
15097
  * full slice; renders an arm button per `availableModes` entry and
15068
15098
  * a PIN field iff `requiresCode === true`.
15069
15099
  */
15070
- runtimeState: AlarmPanelStatusSchema
15100
+ runtimeState: AlarmPanelStatusSchema,
15101
+ /**
15102
+ * Runtime-state durability: **restored** — armed state is the one thing a panel must not lose across a restart.
15103
+ *
15104
+ * See `RuntimeStateDurability`. Enforced by
15105
+ * `scripts/check-runtime-state-durability.ts`.
15106
+ */
15107
+ durability: "restored",
15108
+ /** Clock fields: written, but excluded from the compare that decides
15109
+ * whether persisting is worth a SQLite commit. */
15110
+ volatileStateFields: ["lastChangedAt"]
15071
15111
  };
15072
15112
  /**
15073
15113
  * Shared geometry vocabulary for on-frame shape caps — privacy-mask,
@@ -15244,6 +15284,9 @@ var NcSystemEventConditionSchema = object({
15244
15284
  nodeIds: array(string().min(1)).min(1).optional(),
15245
15285
  packageNames: array(string().min(1)).min(1).optional()
15246
15286
  });
15287
+ /** Hard ceiling on a window (24h). A snooze that could not expire would be an
15288
+ * outage the operator asked for once and forgot. */
15289
+ var NC_SNOOZE_MAX_MINUTES = 1440;
15247
15290
  /** Weekly schedule — OR of windows; absence on the rule = always active. */
15248
15291
  var NcScheduleSchema = object({
15249
15292
  windows: array(object({
@@ -15620,15 +15663,15 @@ var NcConditionsSchema = object({
15620
15663
  * (an `immediate` rule naming an `audio-*` class, one notification per
15621
15664
  * classified sample) stays exactly as it was for rules that already use it.
15622
15665
  *
15623
- * NOT in {@link NC_CONDITION_CATALOG} yet, and that is the sequencing rule
15624
- * rather than an oversight: the viewer mirrors the descriptor enums BY HAND
15625
- * (`camstack/src/data/notification-center.ts`, guarded by
15626
- * `scripts/check-viewer-condition-mirror.ts`) and its rule editor STRIPS the
15666
+ * In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
15667
+ * rule rather than an accident: the viewer mirrors the descriptor enums BY
15668
+ * HAND (`camstack/src/data/notification-center.ts`, guarded by
15669
+ * `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
15627
15670
  * condition fields it does not know when a rule is saved from the phone.
15628
15671
  * Publishing an editor for a condition the app cannot round-trip is how an
15629
- * operator loses a rule's conditions by opening it — so the descriptor, the
15630
- * admin widget and the viewer mirror land together (P2 + P3), and only then
15631
- * does an audio rule become authorable.
15672
+ * operator loses a rule's conditions by opening it — so the viewer mirror
15673
+ * (P3, shipped) went FIRST, and the descriptor an editor renders from
15674
+ * follows here.
15632
15675
  */
15633
15676
  audio: NcAudioConditionSchema.optional()
15634
15677
  });
@@ -15864,6 +15907,30 @@ var NcRuleInputSchema = object({
15864
15907
  */
15865
15908
  snoozeAllowGlobal: boolean().optional(),
15866
15909
  /**
15910
+ * The snooze durations THIS rule's notification offers as buttons, in
15911
+ * minutes.
15912
+ *
15913
+ * Three states, and all three are distinct — which is exactly why this is
15914
+ * `.optional()` and never `.default()`. A Zod default does not run on the
15915
+ * addon cap path (three production failures in one day), so a schema default
15916
+ * would collapse the first two:
15917
+ *
15918
+ * | value | meaning |
15919
+ * | --- | --- |
15920
+ * | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
15921
+ * | `[]` | **no snooze buttons on this rule** — the explicit override |
15922
+ * | a list | these choices, de-duplicated and sorted, at most four |
15923
+ *
15924
+ * `.max(4)` because the notifier's own action budget is small (ntfy allows
15925
+ * three buttons in total) and a rule that spent it all on snooze choices
15926
+ * would push its own tap-through actions off the notification.
15927
+ *
15928
+ * An empty list is NOT an alarm exemption: a rule the alarm is about, or
15929
+ * that arms the panel, is exempt automatically and cannot be silenced by a
15930
+ * window from anywhere (D133).
15931
+ */
15932
+ snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
15933
+ /**
15867
15934
  * Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
15868
15935
  *
15869
15936
  * This is what makes the rule set the alarm's trigger set without the alarm
@@ -15963,6 +16030,7 @@ var NcConditionDescriptorSchema = object({
15963
16030
  "device",
15964
16031
  "package",
15965
16032
  "occupancy",
16033
+ "audio",
15966
16034
  "system"
15967
16035
  ]),
15968
16036
  label: string(),
@@ -15981,6 +16049,7 @@ var NcConditionDescriptorSchema = object({
15981
16049
  "crossingSelect",
15982
16050
  "polygonDraw",
15983
16051
  "occupancy",
16052
+ "audio",
15984
16053
  "deviceState",
15985
16054
  "systemEvent"
15986
16055
  ]),
@@ -16132,7 +16201,20 @@ var NcSnoozeInputSchema = object({
16132
16201
  ruleId: string().optional(),
16133
16202
  /** Required when `scope: 'device'`. */
16134
16203
  deviceId: number().int().optional(),
16135
- durationMinutes: number().int().min(1).max(1440),
16204
+ /**
16205
+ * Narrow the window to these subject classes — "the cat, not the person".
16206
+ *
16207
+ * ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
16208
+ * what every window authored before this field meant, so no persisted row
16209
+ * changes meaning and no client has to learn anything to keep working.
16210
+ *
16211
+ * It is what makes the window's real key `(deviceId, classes[])` and lets it
16212
+ * cross rules (D133): the operator points at a camera and a kind of thing,
16213
+ * not at whichever of their four rules happened to produce the notification
16214
+ * they are dismissing.
16215
+ */
16216
+ classes: array(string().min(1)).min(1).optional(),
16217
+ durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
16136
16218
  /**
16137
16219
  * Silence this for EVERY recipient, not just the caller. Permission is
16138
16220
  * checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
@@ -16157,6 +16239,10 @@ var NcSnoozeSchema = object({
16157
16239
  scope: NcSnoozeScopeSchema,
16158
16240
  ruleId: string().optional(),
16159
16241
  deviceId: number().int().optional(),
16242
+ /** Subject classes this window covers. ABSENT = every class — see
16243
+ * {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
16244
+ * no SQLite column: nothing queries a window by class. */
16245
+ classes: array(string().min(1)).min(1).optional(),
16160
16246
  startedAt: number(),
16161
16247
  /** Exclusive: at exactly this instant the snooze is over. Expiry is a
16162
16248
  * COMPARISON, not a job — no sweeper can leave the operator silenced. */
@@ -18257,7 +18343,14 @@ var zonesCapability = {
18257
18343
  * handle. Slice shape is `{ zones: Zone[] }` so future extensions
18258
18344
  * (e.g. zone groupings) can sit alongside the polygon list.
18259
18345
  */
18260
- runtimeState: object({ zones: array(ZoneSchema).readonly() })
18346
+ runtimeState: object({ zones: array(ZoneSchema).readonly() }),
18347
+ /**
18348
+ * 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.
18349
+ *
18350
+ * See `RuntimeStateDurability`. Enforced by
18351
+ * `scripts/check-runtime-state-durability.ts`.
18352
+ */
18353
+ durability: "restored"
18261
18354
  };
18262
18355
  /**
18263
18356
  * A bounding box in NORMALIZED [0,1] frame coordinates for `getNativeCrop`. The
@@ -21056,7 +21149,17 @@ var airQualitySensorCapability = {
21056
21149
  schema: AirQualitySensorStatusSchema,
21057
21150
  kind: "push"
21058
21151
  },
21059
- runtimeState: AirQualitySensorStatusSchema
21152
+ runtimeState: AirQualitySensorStatusSchema,
21153
+ /**
21154
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
21155
+ *
21156
+ * See `RuntimeStateDurability`. Enforced by
21157
+ * `scripts/check-runtime-state-durability.ts`.
21158
+ */
21159
+ durability: "restored",
21160
+ /** Clock fields: written, but excluded from the compare that decides
21161
+ * whether persisting is worth a SQLite commit. */
21162
+ volatileStateFields: ["lastFetchedAt"]
21060
21163
  };
21061
21164
  /**
21062
21165
  * Ambient illuminance reading in lux. Drives Home Assistant `sensor`
@@ -21088,7 +21191,17 @@ var ambientLightSensorCapability = {
21088
21191
  schema: AmbientLightSensorStatusSchema,
21089
21192
  kind: "push"
21090
21193
  },
21091
- runtimeState: AmbientLightSensorStatusSchema
21194
+ runtimeState: AmbientLightSensorStatusSchema,
21195
+ /**
21196
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
21197
+ *
21198
+ * See `RuntimeStateDurability`. Enforced by
21199
+ * `scripts/check-runtime-state-durability.ts`.
21200
+ */
21201
+ durability: "restored",
21202
+ /** Clock fields: written, but excluded from the compare that decides
21203
+ * whether persisting is worth a SQLite commit. */
21204
+ volatileStateFields: ["lastFetchedAt"]
21092
21205
  };
21093
21206
  /**
21094
21207
  * Per-class audio metrics aggregated over a sliding window.
@@ -21206,7 +21319,14 @@ var audioMetricsCapability = {
21206
21319
  }), AudioMetricsHistorySchema)
21207
21320
  },
21208
21321
  /** Reactive runtime-state mirror — live `device.state.audioMetrics.value`. */
21209
- runtimeState: AudioMetricsSnapshotSchema
21322
+ runtimeState: AudioMetricsSnapshotSchema,
21323
+ /**
21324
+ * 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.
21325
+ *
21326
+ * See `RuntimeStateDurability`. Enforced by
21327
+ * `scripts/check-runtime-state-durability.ts`.
21328
+ */
21329
+ durability: "session"
21210
21330
  };
21211
21331
  /**
21212
21332
  * Automation-control cap. Models HA `automation.*` entities on
@@ -21268,7 +21388,14 @@ var automationControlCapability = {
21268
21388
  * reads `enabled` (toggle) + `isRunning` (spinner) + `lastError`
21269
21389
  * (badge) directly.
21270
21390
  */
21271
- runtimeState: AutomationControlStatusSchema
21391
+ runtimeState: AutomationControlStatusSchema,
21392
+ /**
21393
+ * 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.
21394
+ *
21395
+ * See `RuntimeStateDurability`. Enforced by
21396
+ * `scripts/check-runtime-state-durability.ts`.
21397
+ */
21398
+ durability: "session"
21272
21399
  };
21273
21400
  /**
21274
21401
  * Battery status snapshot. Emitted by providers whose device is
@@ -21374,7 +21501,17 @@ onStatusChanged: { data: object({
21374
21501
  * via `device.runtimeState.getCapState('battery')` regardless of
21375
21502
  * the underlying driver.
21376
21503
  */
21377
- runtimeState: BatteryStatusSchema
21504
+ runtimeState: BatteryStatusSchema,
21505
+ /**
21506
+ * 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.
21507
+ *
21508
+ * See `RuntimeStateDurability`. Enforced by
21509
+ * `scripts/check-runtime-state-durability.ts`.
21510
+ */
21511
+ durability: "restored",
21512
+ /** Clock fields: written, but excluded from the compare that decides
21513
+ * whether persisting is worth a SQLite commit. */
21514
+ volatileStateFields: ["lastUpdated"]
21378
21515
  };
21379
21516
  /**
21380
21517
  * Generic boolean sensor — last-resort fallback when no domain-
@@ -21403,7 +21540,17 @@ var binaryCapability = {
21403
21540
  schema: BinaryStatusSchema,
21404
21541
  kind: "push"
21405
21542
  },
21406
- runtimeState: BinaryStatusSchema
21543
+ runtimeState: BinaryStatusSchema,
21544
+ /**
21545
+ * Runtime-state durability: **restored** — transition-driven sensor state; the restored value gives the boot comparison.
21546
+ *
21547
+ * See `RuntimeStateDurability`. Enforced by
21548
+ * `scripts/check-runtime-state-durability.ts`.
21549
+ */
21550
+ durability: "restored",
21551
+ /** Clock fields: written, but excluded from the compare that decides
21552
+ * whether persisting is worth a SQLite commit. */
21553
+ volatileStateFields: ["lastChangedAt"]
21407
21554
  };
21408
21555
  /**
21409
21556
  * Dimmable-light brightness control. Co-exists with `switch` on the
@@ -21456,7 +21603,14 @@ onBrightnessChanged: { data: object({
21456
21603
  * by the kernel. Read via `device.state.brightness.value` so UI
21457
21604
  * sliders surface the current level without polling the provider.
21458
21605
  */
21459
- runtimeState: BrightnessStatusSchema
21606
+ runtimeState: BrightnessStatusSchema,
21607
+ /**
21608
+ * Runtime-state durability: **session** — live lamp state, re-published by the provider on connect.
21609
+ *
21610
+ * See `RuntimeStateDurability`. Enforced by
21611
+ * `scripts/check-runtime-state-durability.ts`.
21612
+ */
21613
+ durability: "session"
21460
21614
  };
21461
21615
  DeviceType.Button, method(object({ deviceId: number().int().nonnegative() }), _void(), {
21462
21616
  kind: "mutation",
@@ -21544,7 +21698,17 @@ var carbonMonoxideCapability = {
21544
21698
  schema: CarbonMonoxideStatusSchema,
21545
21699
  kind: "push"
21546
21700
  },
21547
- runtimeState: CarbonMonoxideStatusSchema
21701
+ runtimeState: CarbonMonoxideStatusSchema,
21702
+ /**
21703
+ * Runtime-state durability: **restored** — as `smoke`.
21704
+ *
21705
+ * See `RuntimeStateDurability`. Enforced by
21706
+ * `scripts/check-runtime-state-durability.ts`.
21707
+ */
21708
+ durability: "restored",
21709
+ /** Clock fields: written, but excluded from the compare that decides
21710
+ * whether persisting is worth a SQLite commit. */
21711
+ volatileStateFields: ["lastChangedAt"]
21548
21712
  };
21549
21713
  /**
21550
21714
  * HVAC / climate control cap. Models the full surface of a HA
@@ -21704,7 +21868,14 @@ var climateControlCapability = {
21704
21868
  * the full slice via `device.state.climate-control.value` and refresh
21705
21869
  * on every push without re-querying the provider.
21706
21870
  */
21707
- runtimeState: ClimateControlStatusSchema
21871
+ runtimeState: ClimateControlStatusSchema,
21872
+ /**
21873
+ * Runtime-state durability: **session** — as `brightness`; `currentTemp` moves continuously and is re-published on connect.
21874
+ *
21875
+ * See `RuntimeStateDurability`. Enforced by
21876
+ * `scripts/check-runtime-state-durability.ts`.
21877
+ */
21878
+ durability: "session"
21708
21879
  };
21709
21880
  /**
21710
21881
  * Color-light cap. Coexists with `switch` (on/off) and `brightness`
@@ -21814,7 +21985,14 @@ onColorChanged: { data: object({
21814
21985
  * kernel. Read via `device.state.color.value` so UI pickers surface
21815
21986
  * the current chromaticity without polling the provider.
21816
21987
  */
21817
- runtimeState: ColorStatusSchema
21988
+ runtimeState: ColorStatusSchema,
21989
+ /**
21990
+ * Runtime-state durability: **session** — as `brightness`.
21991
+ *
21992
+ * See `RuntimeStateDurability`. Enforced by
21993
+ * `scripts/check-runtime-state-durability.ts`.
21994
+ */
21995
+ durability: "session"
21818
21996
  };
21819
21997
  var ConnectionTestOutcomeSchema = discriminatedUnion("outcome", [
21820
21998
  object({
@@ -21872,7 +22050,17 @@ var connectivityCapability = {
21872
22050
  schema: ConnectivityStatusSchema,
21873
22051
  kind: "push"
21874
22052
  },
21875
- runtimeState: ConnectivityStatusSchema
22053
+ runtimeState: ConnectivityStatusSchema,
22054
+ /**
22055
+ * Runtime-state durability: **restored** — same shape and same argument as `device-status`, for links rather than devices.
22056
+ *
22057
+ * See `RuntimeStateDurability`. Enforced by
22058
+ * `scripts/check-runtime-state-durability.ts`.
22059
+ */
22060
+ durability: "restored",
22061
+ /** Clock fields: written, but excluded from the compare that decides
22062
+ * whether persisting is worth a SQLite commit. */
22063
+ volatileStateFields: ["lastChangedAt"]
21876
22064
  };
21877
22065
  /**
21878
22066
  * Generic device-consumables capability — surfaces a device's
@@ -21954,7 +22142,14 @@ reset: method(object({
21954
22142
  }
21955
22143
  }
21956
22144
  },
21957
- runtimeState: ConsumablesStatusSchema.extend({ lastFetchedAt: number() })
22145
+ runtimeState: ConsumablesStatusSchema.extend({ lastFetchedAt: number() }),
22146
+ /**
22147
+ * Runtime-state durability: **session** — the authority is the appliance; the provider re-reads the whole item array on connect.
22148
+ *
22149
+ * See `RuntimeStateDurability`. Enforced by
22150
+ * `scripts/check-runtime-state-durability.ts`.
22151
+ */
22152
+ durability: "session"
21958
22153
  };
21959
22154
  /**
21960
22155
  * Door / window / opening / garage / valve contact sensor. Boolean
@@ -21985,7 +22180,17 @@ var contactCapability = {
21985
22180
  schema: ContactStatusSchema,
21986
22181
  kind: "push"
21987
22182
  },
21988
- runtimeState: ContactStatusSchema
22183
+ runtimeState: ContactStatusSchema,
22184
+ /**
22185
+ * Runtime-state durability: **restored** — a door left open across a restart must still read open.
22186
+ *
22187
+ * See `RuntimeStateDurability`. Enforced by
22188
+ * `scripts/check-runtime-state-durability.ts`.
22189
+ */
22190
+ durability: "restored",
22191
+ /** Clock fields: written, but excluded from the compare that decides
22192
+ * whether persisting is worth a SQLite commit. */
22193
+ volatileStateFields: ["lastChangedAt"]
21989
22194
  };
21990
22195
  /**
21991
22196
  * Status slice — flat object (the framework's `runtimeState` contract
@@ -22091,7 +22296,14 @@ var controlCapability = {
22091
22296
  * dropdown / text field / date picker) read the slice's discriminant
22092
22297
  * and value directly without polling the provider.
22093
22298
  */
22094
- runtimeState: ControlStatusSchema
22299
+ runtimeState: ControlStatusSchema,
22300
+ /**
22301
+ * Runtime-state durability: **session** — a generic control mirrors an external entity that re-publishes on connect; the options array is re-derived with it.
22302
+ *
22303
+ * See `RuntimeStateDurability`. Enforced by
22304
+ * `scripts/check-runtime-state-durability.ts`.
22305
+ */
22306
+ durability: "session"
22095
22307
  };
22096
22308
  var CoverStatusSchema = object({
22097
22309
  /** Lifecycle state of the cover. */
@@ -22152,7 +22364,17 @@ var coverCapability = {
22152
22364
  * Runtime-state slice — mirrored by the kernel. UI controls watch
22153
22365
  * the slice for live position changes during a move.
22154
22366
  */
22155
- runtimeState: CoverStatusSchema
22367
+ runtimeState: CoverStatusSchema,
22368
+ /**
22369
+ * Runtime-state durability: **restored** — position survives a restart on the device; the mirror should agree at boot rather than read blank.
22370
+ *
22371
+ * See `RuntimeStateDurability`. Enforced by
22372
+ * `scripts/check-runtime-state-durability.ts`.
22373
+ */
22374
+ durability: "restored",
22375
+ /** Clock fields: written, but excluded from the compare that decides
22376
+ * whether persisting is worth a SQLite commit. */
22377
+ volatileStateFields: ["lastChangedAt"]
22156
22378
  };
22157
22379
  /**
22158
22380
  * Vendor-neutral day/night (IR-cut) control — the per-camera config cap
@@ -22246,7 +22468,17 @@ var dayNightCapability = {
22246
22468
  schema: DayNightStatusSchema,
22247
22469
  kind: "poll"
22248
22470
  },
22249
- runtimeState: DayNightStatusSchema
22471
+ runtimeState: DayNightStatusSchema,
22472
+ /**
22473
+ * Runtime-state durability: **restored** — operator-set IR-cut behaviour; mutation-driven.
22474
+ *
22475
+ * See `RuntimeStateDurability`. Enforced by
22476
+ * `scripts/check-runtime-state-durability.ts`.
22477
+ */
22478
+ durability: "restored",
22479
+ /** Clock fields: written, but excluded from the compare that decides
22480
+ * whether persisting is worth a SQLite commit. */
22481
+ volatileStateFields: ["lastFetchedAt"]
22250
22482
  };
22251
22483
  /**
22252
22484
  * Generic device-level status snapshot. Auto-registered by `BaseDevice`
@@ -22293,7 +22525,17 @@ onStatusChanged: { data: object({
22293
22525
  schema: DeviceStatusSchema,
22294
22526
  kind: "push"
22295
22527
  },
22296
- runtimeState: DeviceStatusSchema
22528
+ runtimeState: DeviceStatusSchema,
22529
+ /**
22530
+ * 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.
22531
+ *
22532
+ * See `RuntimeStateDurability`. Enforced by
22533
+ * `scripts/check-runtime-state-durability.ts`.
22534
+ */
22535
+ durability: "restored",
22536
+ /** Clock fields: written, but excluded from the compare that decides
22537
+ * whether persisting is worth a SQLite commit. */
22538
+ volatileStateFields: ["lastChangedAt"]
22297
22539
  };
22298
22540
  /**
22299
22541
  * Doorbell button cap. Two kinds of providers coexist behind this cap
@@ -22355,7 +22597,14 @@ onPressed: { data: DoorbellPressEventSchema } },
22355
22597
  * `device.state.doorbell.value`. UIs can show "last ring 5m ago"
22356
22598
  * without subscribing.
22357
22599
  */
22358
- runtimeState: DoorbellStatusSchema
22600
+ runtimeState: DoorbellStatusSchema,
22601
+ /**
22602
+ * 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.
22603
+ *
22604
+ * See `RuntimeStateDurability`. Enforced by
22605
+ * `scripts/check-runtime-state-durability.ts`.
22606
+ */
22607
+ durability: "restored"
22359
22608
  };
22360
22609
  /**
22361
22610
  * Enum-state sensor — a string value picked from a finite option set.
@@ -22395,7 +22644,17 @@ var enumSensorCapability = {
22395
22644
  schema: EnumSensorStatusSchema,
22396
22645
  kind: "push"
22397
22646
  },
22398
- runtimeState: EnumSensorStatusSchema
22647
+ runtimeState: EnumSensorStatusSchema,
22648
+ /**
22649
+ * Runtime-state durability: **restored** — as `numeric-sensor`; 80 devices.
22650
+ *
22651
+ * See `RuntimeStateDurability`. Enforced by
22652
+ * `scripts/check-runtime-state-durability.ts`.
22653
+ */
22654
+ durability: "restored",
22655
+ /** Clock fields: written, but excluded from the compare that decides
22656
+ * whether persisting is worth a SQLite commit. */
22657
+ volatileStateFields: ["lastFetchedAt"]
22399
22658
  };
22400
22659
  /**
22401
22660
  * Generic stateless event emitter. Installed on a `DeviceType.EventEmitter`
@@ -22431,7 +22690,14 @@ var eventEmitterCapability = {
22431
22690
  schema: EventEmitterStatusSchema,
22432
22691
  kind: "push"
22433
22692
  },
22434
- runtimeState: EventEmitterStatusSchema
22693
+ runtimeState: EventEmitterStatusSchema,
22694
+ /**
22695
+ * Runtime-state durability: **session** — `eventCountSinceStart` names its own scope.
22696
+ *
22697
+ * See `RuntimeStateDurability`. Enforced by
22698
+ * `scripts/check-runtime-state-durability.ts`.
22699
+ */
22700
+ durability: "session"
22435
22701
  };
22436
22702
  var EventItemSchema = object({
22437
22703
  id: string(),
@@ -22712,7 +22978,14 @@ var fanControlCapability = {
22712
22978
  * Runtime-state slice — mirrored by the kernel. UI fan speed
22713
22979
  * sliders read `percentage` for live updates.
22714
22980
  */
22715
- runtimeState: FanControlStatusSchema
22981
+ runtimeState: FanControlStatusSchema,
22982
+ /**
22983
+ * Runtime-state durability: **session** — as `brightness`.
22984
+ *
22985
+ * See `RuntimeStateDurability`. Enforced by
22986
+ * `scripts/check-runtime-state-durability.ts`.
22987
+ */
22988
+ durability: "session"
22716
22989
  };
22717
22990
  /**
22718
22991
  * Per-device feature/identity probe slice. Holds the runtime-resolved
@@ -22788,7 +23061,14 @@ onProbeChanged: { data: object({
22788
23061
  schema: FeatureProbeStatusSchema,
22789
23062
  kind: "push"
22790
23063
  },
22791
- runtimeState: FeatureProbeStatusSchema
23064
+ runtimeState: FeatureProbeStatusSchema,
23065
+ /**
23066
+ * 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.
23067
+ *
23068
+ * See `RuntimeStateDurability`. Enforced by
23069
+ * `scripts/check-runtime-state-durability.ts`.
23070
+ */
23071
+ durability: "session"
22792
23072
  };
22793
23073
  /**
22794
23074
  * Water leak / moisture sensor. Boolean "is liquid currently
@@ -22815,7 +23095,17 @@ var floodCapability = {
22815
23095
  schema: FloodStatusSchema,
22816
23096
  kind: "push"
22817
23097
  },
22818
- runtimeState: FloodStatusSchema
23098
+ runtimeState: FloodStatusSchema,
23099
+ /**
23100
+ * Runtime-state durability: **restored** — as `smoke`.
23101
+ *
23102
+ * See `RuntimeStateDurability`. Enforced by
23103
+ * `scripts/check-runtime-state-durability.ts`.
23104
+ */
23105
+ durability: "restored",
23106
+ /** Clock fields: written, but excluded from the compare that decides
23107
+ * whether persisting is worth a SQLite commit. */
23108
+ volatileStateFields: ["lastChangedAt"]
22819
23109
  };
22820
23110
  /**
22821
23111
  * Combustible-gas (LPG / methane / hydrogen) alarm sensor. Drives
@@ -22838,7 +23128,17 @@ var gasCapability = {
22838
23128
  schema: GasStatusSchema,
22839
23129
  kind: "push"
22840
23130
  },
22841
- runtimeState: GasStatusSchema
23131
+ runtimeState: GasStatusSchema,
23132
+ /**
23133
+ * Runtime-state durability: **restored** — as `smoke`.
23134
+ *
23135
+ * See `RuntimeStateDurability`. Enforced by
23136
+ * `scripts/check-runtime-state-durability.ts`.
23137
+ */
23138
+ durability: "restored",
23139
+ /** Clock fields: written, but excluded from the compare that decides
23140
+ * whether persisting is worth a SQLite commit. */
23141
+ volatileStateFields: ["lastChangedAt"]
22842
23142
  };
22843
23143
  /**
22844
23144
  * Humidifier / dehumidifier cap. Models HA `humidifier.*` entities —
@@ -22914,7 +23214,14 @@ var humidifierCapability = {
22914
23214
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
22915
23215
  * slice for live humidity / mode changes.
22916
23216
  */
22917
- runtimeState: HumidifierStatusSchema
23217
+ runtimeState: HumidifierStatusSchema,
23218
+ /**
23219
+ * Runtime-state durability: **session** — as `climate-control`.
23220
+ *
23221
+ * See `RuntimeStateDurability`. Enforced by
23222
+ * `scripts/check-runtime-state-durability.ts`.
23223
+ */
23224
+ durability: "session"
22918
23225
  };
22919
23226
  /**
22920
23227
  * Single-metric humidity reading. Drives Home Assistant `sensor`
@@ -22950,7 +23257,17 @@ var humiditySensorCapability = {
22950
23257
  schema: HumiditySensorStatusSchema,
22951
23258
  kind: "push"
22952
23259
  },
22953
- runtimeState: HumiditySensorStatusSchema
23260
+ runtimeState: HumiditySensorStatusSchema,
23261
+ /**
23262
+ * Runtime-state durability: **restored** — as `numeric-sensor` (67 of 75 writes were the clock alone).
23263
+ *
23264
+ * See `RuntimeStateDurability`. Enforced by
23265
+ * `scripts/check-runtime-state-durability.ts`.
23266
+ */
23267
+ durability: "restored",
23268
+ /** Clock fields: written, but excluded from the compare that decides
23269
+ * whether persisting is worth a SQLite commit. */
23270
+ volatileStateFields: ["lastFetchedAt"]
22954
23271
  };
22955
23272
  /**
22956
23273
  * Image display cap. Models a single still image exposed by an integration —
@@ -22988,7 +23305,14 @@ var imageCapability = {
22988
23305
  * Runtime-state slice — mirrored by the kernel. The UI reads `url`
22989
23306
  * directly and renders the still image.
22990
23307
  */
22991
- runtimeState: ImageStatusSchema
23308
+ runtimeState: ImageStatusSchema,
23309
+ /**
23310
+ * Runtime-state durability: **session** — a snapshot URL is a session-scoped handle; a restored one points at nothing.
23311
+ *
23312
+ * See `RuntimeStateDurability`. Enforced by
23313
+ * `scripts/check-runtime-state-durability.ts`.
23314
+ */
23315
+ durability: "session"
22992
23316
  };
22993
23317
  /**
22994
23318
  * Vendor-neutral image / picture-adjustment cap — the per-camera config
@@ -23137,7 +23461,17 @@ var imageSettingsCapability = {
23137
23461
  schema: ImageSettingsStatusSchema,
23138
23462
  kind: "poll"
23139
23463
  },
23140
- runtimeState: ImageSettingsStatusSchema
23464
+ runtimeState: ImageSettingsStatusSchema,
23465
+ /**
23466
+ * Runtime-state durability: **restored** — operator-set camera imaging; mutation-driven.
23467
+ *
23468
+ * See `RuntimeStateDurability`. Enforced by
23469
+ * `scripts/check-runtime-state-durability.ts`.
23470
+ */
23471
+ durability: "restored",
23472
+ /** Clock fields: written, but excluded from the compare that decides
23473
+ * whether persisting is worth a SQLite commit. */
23474
+ volatileStateFields: ["lastFetchedAt"]
23141
23475
  };
23142
23476
  /**
23143
23477
  * integrations — system-scoped singleton capability for integration
@@ -23477,7 +23811,14 @@ var lawnMowerControlCapability = {
23477
23811
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
23478
23812
  * slice for live activity + battery changes.
23479
23813
  */
23480
- runtimeState: LawnMowerControlStatusSchema
23814
+ runtimeState: LawnMowerControlStatusSchema,
23815
+ /**
23816
+ * Runtime-state durability: **session** — as `vacuum-control`.
23817
+ *
23818
+ * See `RuntimeStateDurability`. Enforced by
23819
+ * `scripts/check-runtime-state-durability.ts`.
23820
+ */
23821
+ durability: "session"
23481
23822
  };
23482
23823
  /**
23483
23824
  * local-network — hub-only singleton.
@@ -23683,7 +24024,17 @@ var lockControlCapability = {
23683
24024
  * read `state` and disable themselves during `locking`/`unlocking`
23684
24025
  * transitions.
23685
24026
  */
23686
- runtimeState: LockControlStatusSchema
24027
+ runtimeState: LockControlStatusSchema,
24028
+ /**
24029
+ * Runtime-state durability: **restored** — a lock left locked must still read locked.
24030
+ *
24031
+ * See `RuntimeStateDurability`. Enforced by
24032
+ * `scripts/check-runtime-state-durability.ts`.
24033
+ */
24034
+ durability: "restored",
24035
+ /** Clock fields: written, but excluded from the compare that decides
24036
+ * whether persisting is worth a SQLite commit. */
24037
+ volatileStateFields: ["lastChangedAt"]
23687
24038
  };
23688
24039
  /**
23689
24040
  * Media-player cap. Models HA `media_player.*` (Sonos, Chromecast,
@@ -23845,7 +24196,14 @@ var mediaPlayerCapability = {
23845
24196
  * full slice for live now-playing, volume, and progress updates
23846
24197
  * without polling.
23847
24198
  */
23848
- runtimeState: MediaPlayerStatusSchema
24199
+ runtimeState: MediaPlayerStatusSchema,
24200
+ /**
24201
+ * Runtime-state durability: **session** — a restored transport position describes a playback that stopped when the hub did.
24202
+ *
24203
+ * See `RuntimeStateDurability`. Enforced by
24204
+ * `scripts/check-runtime-state-durability.ts`.
24205
+ */
24206
+ durability: "session"
23849
24207
  };
23850
24208
  /**
23851
24209
  * mesh-network — collection cap for mesh-VPN providers.
@@ -24109,7 +24467,14 @@ onMotionChanged: { data: MotionOnMotionChangedDataSchema } },
24109
24467
  * `device.state.motion.value`. Reads never invoke the provider, so
24110
24468
  * UIs and other addons can poll the cached state safely.
24111
24469
  */
24112
- runtimeState: MotionStatusSchema
24470
+ runtimeState: MotionStatusSchema,
24471
+ /**
24472
+ * 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.
24473
+ *
24474
+ * See `RuntimeStateDurability`. Enforced by
24475
+ * `scripts/check-runtime-state-durability.ts`.
24476
+ */
24477
+ durability: "session"
24113
24478
  };
24114
24479
  /**
24115
24480
  * Motion-trigger toggle for accessory devices.
@@ -24174,7 +24539,14 @@ var motionTriggerCapability = {
24174
24539
  schema: MotionTriggerStatusSchema,
24175
24540
  kind: "command-driven"
24176
24541
  },
24177
- runtimeState: MotionTriggerRuntimeStateSchema
24542
+ runtimeState: MotionTriggerRuntimeStateSchema,
24543
+ /**
24544
+ * 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.
24545
+ *
24546
+ * See `RuntimeStateDurability`. Enforced by
24547
+ * `scripts/check-runtime-state-durability.ts`.
24548
+ */
24549
+ durability: "session"
24178
24550
  };
24179
24551
  /**
24180
24552
  * Motion-zones share the same MaskShape vocabulary as privacy-mask — the
@@ -24241,7 +24613,17 @@ var motionZonesCapability = {
24241
24613
  schema: MotionZoneStatusSchema,
24242
24614
  kind: "poll"
24243
24615
  },
24244
- runtimeState: MotionZoneStatusSchema
24616
+ runtimeState: MotionZoneStatusSchema,
24617
+ /**
24618
+ * 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.
24619
+ *
24620
+ * See `RuntimeStateDurability`. Enforced by
24621
+ * `scripts/check-runtime-state-durability.ts`.
24622
+ */
24623
+ durability: "restored",
24624
+ /** Clock fields: written, but excluded from the compare that decides
24625
+ * whether persisting is worth a SQLite commit. */
24626
+ volatileStateFields: ["lastFetchedAt"]
24245
24627
  };
24246
24628
  /**
24247
24629
  * On-camera AI object detection cap. Surfaces per-device the classes
@@ -24315,7 +24697,17 @@ var nativeObjectDetectionCapability = {
24315
24697
  schema: NativeObjectDetectionStatusSchema,
24316
24698
  kind: "push"
24317
24699
  },
24318
- runtimeState: NativeObjectDetectionRuntimeStateSchema
24700
+ runtimeState: NativeObjectDetectionRuntimeStateSchema,
24701
+ /**
24702
+ * 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.
24703
+ *
24704
+ * See `RuntimeStateDurability`. Enforced by
24705
+ * `scripts/check-runtime-state-durability.ts`.
24706
+ */
24707
+ durability: "restored",
24708
+ /** Clock fields: written, but excluded from the compare that decides
24709
+ * whether persisting is worth a SQLite commit. */
24710
+ volatileStateFields: ["lastFetchedAt"]
24319
24711
  };
24320
24712
  /**
24321
24713
  * network-quality — system-scoped singleton capability tracking RTT,
@@ -24649,7 +25041,14 @@ onSent: { data: object({
24649
25041
  * form reads `supports` to gate optional fields; history pane reads
24650
25042
  * `lastSentAt` / `lastError` / `queueDepth`.
24651
25043
  */
24652
- runtimeState: NotifierStatusSchema
25044
+ runtimeState: NotifierStatusSchema,
25045
+ /**
25046
+ * Runtime-state durability: **session** — live queue depth and last-send state; a restored queue depth describes a queue that no longer exists.
25047
+ *
25048
+ * See `RuntimeStateDurability`. Enforced by
25049
+ * `scripts/check-runtime-state-durability.ts`.
25050
+ */
25051
+ durability: "session"
24653
25052
  };
24654
25053
  /**
24655
25054
  * Generic numeric sensor — last-resort fallback when no typed numeric
@@ -24692,7 +25091,17 @@ var numericSensorCapability = {
24692
25091
  schema: NumericSensorStatusSchema,
24693
25092
  kind: "push"
24694
25093
  },
24695
- runtimeState: NumericSensorStatusSchema
25094
+ runtimeState: NumericSensorStatusSchema,
25095
+ /**
25096
+ * 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.
25097
+ *
25098
+ * See `RuntimeStateDurability`. Enforced by
25099
+ * `scripts/check-runtime-state-durability.ts`.
25100
+ */
25101
+ durability: "restored",
25102
+ /** Clock fields: written, but excluded from the compare that decides
25103
+ * whether persisting is worth a SQLite commit. */
25104
+ volatileStateFields: ["lastFetchedAt"]
24696
25105
  };
24697
25106
  /**
24698
25107
  * Generic on-screen-display (video overlay) cap. Each camera exposes
@@ -25077,7 +25486,14 @@ var petFeederCapability = {
25077
25486
  * the full slice via `device.state.petFeeder.value` and refresh on
25078
25487
  * every poll without re-querying the provider.
25079
25488
  */
25080
- runtimeState: PetFeederStatusSchema
25489
+ runtimeState: PetFeederStatusSchema,
25490
+ /**
25491
+ * Runtime-state durability: **session** — live appliance state re-published on connect.
25492
+ *
25493
+ * See `RuntimeStateDurability`. Enforced by
25494
+ * `scripts/check-runtime-state-durability.ts`.
25495
+ */
25496
+ durability: "session"
25081
25497
  };
25082
25498
  var VehicleSchema = object({
25083
25499
  id: string(),
@@ -25389,7 +25805,17 @@ var powerMeterCapability = {
25389
25805
  schema: PowerMeterStatusSchema,
25390
25806
  kind: "push"
25391
25807
  },
25392
- runtimeState: PowerMeterStatusSchema
25808
+ runtimeState: PowerMeterStatusSchema,
25809
+ /**
25810
+ * Runtime-state durability: **restored** — as `numeric-sensor`; `kwhTotal` is an accumulator whose restored value is the baseline.
25811
+ *
25812
+ * See `RuntimeStateDurability`. Enforced by
25813
+ * `scripts/check-runtime-state-durability.ts`.
25814
+ */
25815
+ durability: "restored",
25816
+ /** Clock fields: written, but excluded from the compare that decides
25817
+ * whether persisting is worth a SQLite commit. */
25818
+ volatileStateFields: ["lastFetchedAt"]
25393
25819
  };
25394
25820
  /**
25395
25821
  * Presence cap. Models HA `person.*` and `device_tracker.*` entities
@@ -25446,7 +25872,17 @@ var presenceCapability = {
25446
25872
  * the map pin is rendered (use `DeviceFeature.PresenceGps` for the
25447
25873
  * pre-fetch fast-path check).
25448
25874
  */
25449
- runtimeState: PresenceStatusSchema
25875
+ runtimeState: PresenceStatusSchema,
25876
+ /**
25877
+ * Runtime-state durability: **restored** — occupancy-relevant: the restored state is what an occupancy rule compares the first post-restart observation against.
25878
+ *
25879
+ * See `RuntimeStateDurability`. Enforced by
25880
+ * `scripts/check-runtime-state-durability.ts`.
25881
+ */
25882
+ durability: "restored",
25883
+ /** Clock fields: written, but excluded from the compare that decides
25884
+ * whether persisting is worth a SQLite commit. */
25885
+ volatileStateFields: ["lastChangedAt"]
25450
25886
  };
25451
25887
  /**
25452
25888
  * Atmospheric pressure reading in hectopascals. Drives Home Assistant
@@ -25482,7 +25918,17 @@ var pressureSensorCapability = {
25482
25918
  schema: PressureSensorStatusSchema,
25483
25919
  kind: "push"
25484
25920
  },
25485
- runtimeState: PressureSensorStatusSchema
25921
+ runtimeState: PressureSensorStatusSchema,
25922
+ /**
25923
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
25924
+ *
25925
+ * See `RuntimeStateDurability`. Enforced by
25926
+ * `scripts/check-runtime-state-durability.ts`.
25927
+ */
25928
+ durability: "restored",
25929
+ /** Clock fields: written, but excluded from the compare that decides
25930
+ * whether persisting is worth a SQLite commit. */
25931
+ volatileStateFields: ["lastFetchedAt"]
25486
25932
  };
25487
25933
  /**
25488
25934
  * PRIVACY — what the camera deliberately does not capture. Two planes:
@@ -25612,7 +26058,17 @@ var privacyMaskCapability = {
25612
26058
  schema: PrivacyMaskStatusSchema,
25613
26059
  kind: "poll"
25614
26060
  },
25615
- runtimeState: PrivacyMaskStatusSchema
26061
+ runtimeState: PrivacyMaskStatusSchema,
26062
+ /**
26063
+ * Runtime-state durability: **restored** — operator-drawn regions, zero real churn — 22 writes in 25 minutes, every one of them the clock.
26064
+ *
26065
+ * See `RuntimeStateDurability`. Enforced by
26066
+ * `scripts/check-runtime-state-durability.ts`.
26067
+ */
26068
+ durability: "restored",
26069
+ /** Clock fields: written, but excluded from the compare that decides
26070
+ * whether persisting is worth a SQLite commit. */
26071
+ volatileStateFields: ["lastFetchedAt"]
25616
26072
  };
25617
26073
  var PtzPresetSchema = object({
25618
26074
  id: string(),
@@ -25778,7 +26234,14 @@ var ptzAutotrackCapability = {
25778
26234
  * fetch / cache / fallback logic out of the four cap methods —
25779
26235
  * they become trampolines over `runtimeState`.
25780
26236
  */
25781
- runtimeState: PtzAutotrackRuntimeStateSchema
26237
+ runtimeState: PtzAutotrackRuntimeStateSchema,
26238
+ /**
26239
+ * Runtime-state durability: **session** — mirrors the camera's own autotrack config, re-read on connect.
26240
+ *
26241
+ * See `RuntimeStateDurability`. Enforced by
26242
+ * `scripts/check-runtime-state-durability.ts`.
26243
+ */
26244
+ durability: "session"
25782
26245
  };
25783
26246
  DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceId: number().int().nonnegative() }), object({ success: literal(true) }), {
25784
26247
  kind: "mutation",
@@ -26428,7 +26891,14 @@ var sceneMonitorCapability = {
26428
26891
  schema: SceneMonitorStatusSchema,
26429
26892
  kind: "push"
26430
26893
  },
26431
- runtimeState: SceneMonitorStatusSchema
26894
+ runtimeState: SceneMonitorStatusSchema,
26895
+ /**
26896
+ * Runtime-state durability: **session** — re-derived from the current scene on the next evaluation.
26897
+ *
26898
+ * See `RuntimeStateDurability`. Enforced by
26899
+ * `scripts/check-runtime-state-durability.ts`.
26900
+ */
26901
+ durability: "session"
26432
26902
  };
26433
26903
  /**
26434
26904
  * Per-stage gating mode applied to the zones a rule references.
@@ -26572,7 +27042,14 @@ var scriptRunnerCapability = {
26572
27042
  * `isRunning` to render a spinner during execution and surfaces
26573
27043
  * `lastError` / `lastRunSuccess` in the recent-runs panel.
26574
27044
  */
26575
- runtimeState: ScriptRunnerStatusSchema
27045
+ runtimeState: ScriptRunnerStatusSchema,
27046
+ /**
27047
+ * Runtime-state durability: **session** — a restored `isRunning: true` describes a process that died with the previous hub.
27048
+ *
27049
+ * See `RuntimeStateDurability`. Enforced by
27050
+ * `scripts/check-runtime-state-durability.ts`.
27051
+ */
27052
+ durability: "session"
26576
27053
  };
26577
27054
  /**
26578
27055
  * Smoke alarm sensor — boolean "is smoke currently detected" with
@@ -26599,7 +27076,17 @@ var smokeCapability = {
26599
27076
  schema: SmokeStatusSchema,
26600
27077
  kind: "push"
26601
27078
  },
26602
- runtimeState: SmokeStatusSchema
27079
+ runtimeState: SmokeStatusSchema,
27080
+ /**
27081
+ * Runtime-state durability: **restored** — a safety sensor must not read "clear" merely because the hub restarted.
27082
+ *
27083
+ * See `RuntimeStateDurability`. Enforced by
27084
+ * `scripts/check-runtime-state-durability.ts`.
27085
+ */
27086
+ durability: "restored",
27087
+ /** Clock fields: written, but excluded from the compare that decides
27088
+ * whether persisting is worth a SQLite commit. */
27089
+ volatileStateFields: ["lastChangedAt"]
26603
27090
  };
26604
27091
  /**
26605
27092
  * One publishable camera stream as its OWNING PROVIDER describes it — the same
@@ -26772,7 +27259,17 @@ var streamParamsCapability = {
26772
27259
  schema: StreamParamsStatusSchema,
26773
27260
  kind: "poll"
26774
27261
  },
26775
- runtimeState: StreamParamsStatusSchema
27262
+ runtimeState: StreamParamsStatusSchema,
27263
+ /**
27264
+ * Runtime-state durability: **restored** — operator-set encoder profile; mutation-driven.
27265
+ *
27266
+ * See `RuntimeStateDurability`. Enforced by
27267
+ * `scripts/check-runtime-state-durability.ts`.
27268
+ */
27269
+ durability: "restored",
27270
+ /** Clock fields: written, but excluded from the compare that decides
27271
+ * whether persisting is worth a SQLite commit. */
27272
+ volatileStateFields: ["lastFetchedAt"]
26776
27273
  };
26777
27274
  /**
26778
27275
  * Generic on/off switch cap for accessory children (siren, floodlight,
@@ -26818,6 +27315,16 @@ var switchCapability = {
26818
27315
  * not need to re-query the provider after a setState mutation.
26819
27316
  */
26820
27317
  runtimeState: SwitchStatusSchema,
27318
+ /**
27319
+ * Runtime-state durability: **restored** — device state an operator reads as authoritative; 55 devices, transition-driven.
27320
+ *
27321
+ * See `RuntimeStateDurability`. Enforced by
27322
+ * `scripts/check-runtime-state-durability.ts`.
27323
+ */
27324
+ durability: "restored",
27325
+ /** Clock fields: written, but excluded from the compare that decides
27326
+ * whether persisting is worth a SQLite commit. */
27327
+ volatileStateFields: ["lastChangedAt"],
26821
27328
  settings: { bindings: [{
26822
27329
  kind: "scalar",
26823
27330
  statusPath: "on",
@@ -26897,7 +27404,17 @@ var tamperCapability = {
26897
27404
  schema: TamperStatusSchema,
26898
27405
  kind: "push"
26899
27406
  },
26900
- runtimeState: TamperStatusSchema
27407
+ runtimeState: TamperStatusSchema,
27408
+ /**
27409
+ * Runtime-state durability: **restored** — as `smoke`.
27410
+ *
27411
+ * See `RuntimeStateDurability`. Enforced by
27412
+ * `scripts/check-runtime-state-durability.ts`.
27413
+ */
27414
+ durability: "restored",
27415
+ /** Clock fields: written, but excluded from the compare that decides
27416
+ * whether persisting is worth a SQLite commit. */
27417
+ volatileStateFields: ["lastChangedAt"]
26901
27418
  };
26902
27419
  /**
26903
27420
  * Single-metric temperature reading. Drives Home Assistant `sensor`
@@ -26942,7 +27459,17 @@ var temperatureSensorCapability = {
26942
27459
  schema: TemperatureSensorStatusSchema,
26943
27460
  kind: "push"
26944
27461
  },
26945
- runtimeState: TemperatureSensorStatusSchema
27462
+ runtimeState: TemperatureSensorStatusSchema,
27463
+ /**
27464
+ * Runtime-state durability: **restored** — as `numeric-sensor` (69 of 125 writes were the clock alone).
27465
+ *
27466
+ * See `RuntimeStateDurability`. Enforced by
27467
+ * `scripts/check-runtime-state-durability.ts`.
27468
+ */
27469
+ durability: "restored",
27470
+ /** Clock fields: written, but excluded from the compare that decides
27471
+ * whether persisting is worth a SQLite commit. */
27472
+ volatileStateFields: ["lastFetchedAt"]
26946
27473
  };
26947
27474
  /**
26948
27475
  * toast — system-scoped singleton capability that streams toast
@@ -27011,7 +27538,14 @@ var updateCapability = {
27011
27538
  schema: UpdateStatusSchema,
27012
27539
  kind: "poll"
27013
27540
  },
27014
- runtimeState: UpdateStatusSchema
27541
+ runtimeState: UpdateStatusSchema,
27542
+ /**
27543
+ * Runtime-state durability: **session** — a restored `inProgress: true` describes an update that is no longer running; versions are re-probed at boot.
27544
+ *
27545
+ * See `RuntimeStateDurability`. Enforced by
27546
+ * `scripts/check-runtime-state-durability.ts`.
27547
+ */
27548
+ durability: "session"
27015
27549
  };
27016
27550
  var UserSummarySchema = object({
27017
27551
  id: string(),
@@ -27345,7 +27879,14 @@ var vacuumControlCapability = {
27345
27879
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
27346
27880
  * slice for live state + battery + fan-speed changes.
27347
27881
  */
27348
- runtimeState: VacuumControlStatusSchema
27882
+ runtimeState: VacuumControlStatusSchema,
27883
+ /**
27884
+ * Runtime-state durability: **session** — as `media-player` — a restored `state: cleaning` is a robot that is not cleaning.
27885
+ *
27886
+ * See `RuntimeStateDurability`. Enforced by
27887
+ * `scripts/check-runtime-state-durability.ts`.
27888
+ */
27889
+ durability: "session"
27349
27890
  };
27350
27891
  var ValveStatusSchema = object({
27351
27892
  /** Lifecycle state of the valve. */
@@ -27397,7 +27938,14 @@ var valveCapability = {
27397
27938
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
27398
27939
  * slice for live position changes during a move.
27399
27940
  */
27400
- runtimeState: ValveStatusSchema
27941
+ runtimeState: ValveStatusSchema,
27942
+ /**
27943
+ * Runtime-state durability: **session** — as `brightness`.
27944
+ *
27945
+ * See `RuntimeStateDurability`. Enforced by
27946
+ * `scripts/check-runtime-state-durability.ts`.
27947
+ */
27948
+ durability: "session"
27401
27949
  };
27402
27950
  /**
27403
27951
  * Vibration / shake / impact sensor. Drives Home Assistant
@@ -27419,7 +27967,17 @@ var vibrationCapability = {
27419
27967
  schema: VibrationStatusSchema,
27420
27968
  kind: "push"
27421
27969
  },
27422
- runtimeState: VibrationStatusSchema
27970
+ runtimeState: VibrationStatusSchema,
27971
+ /**
27972
+ * Runtime-state durability: **restored** — as `smoke`.
27973
+ *
27974
+ * See `RuntimeStateDurability`. Enforced by
27975
+ * `scripts/check-runtime-state-durability.ts`.
27976
+ */
27977
+ durability: "restored",
27978
+ /** Clock fields: written, but excluded from the compare that decides
27979
+ * whether persisting is worth a SQLite commit. */
27980
+ volatileStateFields: ["lastChangedAt"]
27423
27981
  };
27424
27982
  /**
27425
27983
  * Water heater / boiler cap. Models HA `water_heater.*` entities — a
@@ -27493,7 +28051,14 @@ var waterHeaterCapability = {
27493
28051
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
27494
28052
  * slice for live temperature / mode / away changes.
27495
28053
  */
27496
- runtimeState: WaterHeaterStatusSchema
28054
+ runtimeState: WaterHeaterStatusSchema,
28055
+ /**
28056
+ * Runtime-state durability: **session** — as `climate-control`.
28057
+ *
28058
+ * See `RuntimeStateDurability`. Enforced by
28059
+ * `scripts/check-runtime-state-durability.ts`.
28060
+ */
28061
+ durability: "session"
27497
28062
  };
27498
28063
  /**
27499
28064
  * Weather provider cap. Models HA `weather.*` entities — a read-only
@@ -27552,7 +28117,14 @@ var weatherCapability = {
27552
28117
  * Runtime-state slice — mirrored by the kernel. The UI reads the
27553
28118
  * current conditions directly from the slice on each weather push.
27554
28119
  */
27555
- runtimeState: WeatherStatusSchema
28120
+ runtimeState: WeatherStatusSchema,
28121
+ /**
28122
+ * Runtime-state durability: **session** — a forecast is stale the moment the hub is down; the provider re-fetches on connect.
28123
+ *
28124
+ * See `RuntimeStateDurability`. Enforced by
28125
+ * `scripts/check-runtime-state-durability.ts`.
28126
+ */
28127
+ durability: "session"
27556
28128
  };
27557
28129
  /**
27558
28130
  * Per-zone occupancy aggregation produced by the analytics frame
@@ -27714,7 +28286,14 @@ var zoneAnalyticsCapability = {
27714
28286
  * automatically; the explicit `getCurrentSnapshot` cap method is
27715
28287
  * still useful for one-off polls without a subscription.
27716
28288
  */
27717
- runtimeState: CameraOccupancySnapshotSchema
28289
+ runtimeState: CameraOccupancySnapshotSchema,
28290
+ /**
28291
+ * Runtime-state durability: **session** — per-frame analytics; with `audio-metrics` it is ~90 % of the offered write rate. Re-derived on the next frame.
28292
+ *
28293
+ * See `RuntimeStateDurability`. Enforced by
28294
+ * `scripts/check-runtime-state-durability.ts`.
28295
+ */
28296
+ durability: "session"
27718
28297
  };
27719
28298
  /**
27720
28299
  * Stages a {@link ZoneRule} can apply to. Discriminator on the rules
@@ -27792,7 +28371,14 @@ var zoneRulesCapability = {
27792
28371
  motion: array(ZoneRuleSchema).readonly(),
27793
28372
  detection: array(ZoneRuleSchema).readonly(),
27794
28373
  package: array(ZoneRuleSchema).readonly()
27795
- })
28374
+ }),
28375
+ /**
28376
+ * Runtime-state durability: **restored** — operator intent, mutation-only, same argument as `zones`.
28377
+ *
28378
+ * See `RuntimeStateDurability`. Enforced by
28379
+ * `scripts/check-runtime-state-durability.ts`.
28380
+ */
28381
+ durability: "restored"
27796
28382
  };
27797
28383
  /**
27798
28384
  * Accessory device helpers — shared across drivers.
@@ -34479,6 +35065,7 @@ Object.freeze({
34479
35065
  "network-access": "ingress",
34480
35066
  "smtp-provider": "email"
34481
35067
  });
35068
+ new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
34482
35069
  new Set(["devices", "classes"]);
34483
35070
  /**
34484
35071
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.