@camstack/addon-provider-wyze 0.2.14 → 0.2.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/dist/addon.js +732 -77
  2. package/dist/addon.mjs +732 -77
  3. package/package.json +1 -1
package/dist/addon.mjs CHANGED
@@ -10767,7 +10767,14 @@ var cameraStreamsCapability = {
10767
10767
  low: string().optional()
10768
10768
  }),
10769
10769
  lastChangedAt: number()
10770
- })
10770
+ }),
10771
+ /**
10772
+ * 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.
10773
+ *
10774
+ * See `RuntimeStateDurability`. Enforced by
10775
+ * `scripts/check-runtime-state-durability.ts`.
10776
+ */
10777
+ durability: "session"
10771
10778
  };
10772
10779
  /** Where a block runs. The operator chooses — a block driving a device on an
10773
10780
  * agent is the reason placement is not fixed to the hub. */
@@ -11328,6 +11335,13 @@ var deviceDiscoveryCapability = {
11328
11335
  kind: "poll"
11329
11336
  },
11330
11337
  runtimeState: DeviceDiscoveryStatusSchema.extend({ lastFetchedAt: number().int().nonnegative() }),
11338
+ /**
11339
+ * Runtime-state durability: **session** — 5.7 KB of scan output on the largest device, fully re-derivable by re-scanning.
11340
+ *
11341
+ * See `RuntimeStateDurability`. Enforced by
11342
+ * `scripts/check-runtime-state-durability.ts`.
11343
+ */
11344
+ durability: "session",
11331
11345
  methods: {
11332
11346
  /**
11333
11347
  * Snapshot of the current `discovered` list. Returns the
@@ -13214,11 +13228,33 @@ var NotificationFormatSchema = _enum([
13214
13228
  * Named by INTENT, never by glyph. "check" would tie the vocabulary to one
13215
13229
  * renderer's icon set; "acknowledge" survives an adapter that draws it
13216
13230
  * differently.
13231
+ *
13232
+ * ── A TOKEN IS NOT A WIRE VALUE ─────────────────────────────────────
13233
+ *
13234
+ * These names are for US. **No adapter may forward one verbatim.** Each maps
13235
+ * the whole set onto its own renderer's vocabulary through a
13236
+ * `Record<NotificationActionIcon, string>` — a Record, never a lookup with a
13237
+ * fallback, so adding a member here fails every adapter's build until someone
13238
+ * decides its glyph, which is the only place that decision can be made
13239
+ * honestly.
13240
+ *
13241
+ * This paragraph is the bug. Zentik declared `actionIcons: true` and passed
13242
+ * `disarm` straight through; iOS feeds that string to
13243
+ * `UNNotificationActionIcon(systemImageName:)`, `disarm` is not an SF Symbol,
13244
+ * and every snooze and alarm button arrived BLANK. A pass-through is not a
13245
+ * mapping, and "the field is documented" is not "the value renders".
13246
+ *
13247
+ * Adding a member is TRAIN-BOUND. The enum lives in the published
13248
+ * `@camstack/server` closure and the cap seam validates against the HUB's copy,
13249
+ * so an addon that emits a token the running hub does not know does not lose an
13250
+ * icon — its whole `send` fails Zod validation and the notification never
13251
+ * arrives. Never emit a new token from an addon before the train carrying it.
13217
13252
  */
13218
13253
  var NotificationActionIconSchema = _enum([
13219
13254
  "acknowledge",
13220
13255
  "dismiss",
13221
13256
  "silence",
13257
+ "snooze",
13222
13258
  "view",
13223
13259
  "play",
13224
13260
  "open",
@@ -13226,9 +13262,13 @@ var NotificationActionIconSchema = _enum([
13226
13262
  "lock",
13227
13263
  "unlock",
13228
13264
  "arm",
13265
+ "arm-home",
13266
+ "arm-away",
13267
+ "arm-night",
13229
13268
  "disarm",
13230
13269
  "light",
13231
- "alert"
13270
+ "alert",
13271
+ "camera"
13232
13272
  ]);
13233
13273
  /** A single tap-through action button. */
13234
13274
  var NotificationActionSchema = object({
@@ -13244,7 +13284,23 @@ var NotificationActionSchema = object({
13244
13284
  * else — see `notification-center/action-token.ts` for what that does and
13245
13285
  * does not buy.
13246
13286
  */
13247
- destructive: boolean().optional()
13287
+ destructive: boolean().optional(),
13288
+ /**
13289
+ * How the tap should REACH the url.
13290
+ *
13291
+ * `navigate` (absent, and every button authored before this field) opens it:
13292
+ * the phone leaves the notification and shows whatever the callback returns.
13293
+ * That is right for a button whose answer the operator wants to read.
13294
+ *
13295
+ * `background` fires it as a POST and stays put. It exists for the buttons
13296
+ * whose whole point is not to interrupt — "silence this for 30 minutes" is
13297
+ * an answer to the notification, and being thrown into a browser tab to
13298
+ * confirm it costs more attention than the notification did. A backend that
13299
+ * cannot do a background call renders it as an ordinary link (the adapters
13300
+ * fall back rather than dropping the button), so this is a preference, never
13301
+ * a requirement.
13302
+ */
13303
+ mode: _enum(["navigate", "background"]).optional()
13248
13304
  });
13249
13305
  /**
13250
13306
  * The canonical notification. `body` is the only hard field (Apprise model).
@@ -13412,6 +13468,24 @@ method(object({}), array(TargetKindSchema)), method(object({}), array(TargetSche
13412
13468
  targetId: string(),
13413
13469
  enabled: boolean()
13414
13470
  }), _void(), { kind: "mutation" });
13471
+ new Set([
13472
+ {
13473
+ id: "person",
13474
+ name: "Person"
13475
+ },
13476
+ {
13477
+ id: "vehicle",
13478
+ name: "Vehicle"
13479
+ },
13480
+ {
13481
+ id: "animal",
13482
+ name: "Animal"
13483
+ },
13484
+ {
13485
+ id: "package",
13486
+ name: "Package"
13487
+ }
13488
+ ].map((l) => l.id));
13415
13489
  var COCO_TO_MACRO = {
13416
13490
  mapping: {
13417
13491
  person: "person",
@@ -14096,7 +14170,17 @@ var alarmPanelCapability = {
14096
14170
  * full slice; renders an arm button per `availableModes` entry and
14097
14171
  * a PIN field iff `requiresCode === true`.
14098
14172
  */
14099
- runtimeState: AlarmPanelStatusSchema
14173
+ runtimeState: AlarmPanelStatusSchema,
14174
+ /**
14175
+ * Runtime-state durability: **restored** — armed state is the one thing a panel must not lose across a restart.
14176
+ *
14177
+ * See `RuntimeStateDurability`. Enforced by
14178
+ * `scripts/check-runtime-state-durability.ts`.
14179
+ */
14180
+ durability: "restored",
14181
+ /** Clock fields: written, but excluded from the compare that decides
14182
+ * whether persisting is worth a SQLite commit. */
14183
+ volatileStateFields: ["lastChangedAt"]
14100
14184
  };
14101
14185
  /**
14102
14186
  * Shared geometry vocabulary for on-frame shape caps — privacy-mask,
@@ -14237,6 +14321,8 @@ var NcSystemEventKindSchema = _enum([
14237
14321
  "alarm-triggered",
14238
14322
  "alarm-armed",
14239
14323
  "alarm-disarmed",
14324
+ "alarm-arming",
14325
+ "alarm-arm-refused",
14240
14326
  "camera-online",
14241
14327
  "camera-offline",
14242
14328
  "camera-disabled",
@@ -14273,6 +14359,9 @@ var NcSystemEventConditionSchema = object({
14273
14359
  nodeIds: array(string().min(1)).min(1).optional(),
14274
14360
  packageNames: array(string().min(1)).min(1).optional()
14275
14361
  });
14362
+ /** Hard ceiling on a window (24h). A snooze that could not expire would be an
14363
+ * outage the operator asked for once and forgot. */
14364
+ var NC_SNOOZE_MAX_MINUTES = 1440;
14276
14365
  /** Weekly schedule — OR of windows; absence on the rule = always active. */
14277
14366
  var NcScheduleSchema = object({
14278
14367
  windows: array(object({
@@ -14649,15 +14738,15 @@ var NcConditionsSchema = object({
14649
14738
  * (an `immediate` rule naming an `audio-*` class, one notification per
14650
14739
  * classified sample) stays exactly as it was for rules that already use it.
14651
14740
  *
14652
- * NOT in {@link NC_CONDITION_CATALOG} yet, and that is the sequencing rule
14653
- * rather than an oversight: the viewer mirrors the descriptor enums BY HAND
14654
- * (`camstack/src/data/notification-center.ts`, guarded by
14655
- * `scripts/check-viewer-condition-mirror.ts`) and its rule editor STRIPS the
14741
+ * In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
14742
+ * rule rather than an accident: the viewer mirrors the descriptor enums BY
14743
+ * HAND (`camstack/src/data/notification-center.ts`, guarded by
14744
+ * `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
14656
14745
  * condition fields it does not know when a rule is saved from the phone.
14657
14746
  * Publishing an editor for a condition the app cannot round-trip is how an
14658
- * operator loses a rule's conditions by opening it — so the descriptor, the
14659
- * admin widget and the viewer mirror land together (P2 + P3), and only then
14660
- * does an audio rule become authorable.
14747
+ * operator loses a rule's conditions by opening it — so the viewer mirror
14748
+ * (P3, shipped) went FIRST, and the descriptor an editor renders from
14749
+ * follows here.
14661
14750
  */
14662
14751
  audio: NcAudioConditionSchema.optional()
14663
14752
  });
@@ -14893,6 +14982,30 @@ var NcRuleInputSchema = object({
14893
14982
  */
14894
14983
  snoozeAllowGlobal: boolean().optional(),
14895
14984
  /**
14985
+ * The snooze durations THIS rule's notification offers as buttons, in
14986
+ * minutes.
14987
+ *
14988
+ * Three states, and all three are distinct — which is exactly why this is
14989
+ * `.optional()` and never `.default()`. A Zod default does not run on the
14990
+ * addon cap path (three production failures in one day), so a schema default
14991
+ * would collapse the first two:
14992
+ *
14993
+ * | value | meaning |
14994
+ * | --- | --- |
14995
+ * | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
14996
+ * | `[]` | **no snooze buttons on this rule** — the explicit override |
14997
+ * | a list | these choices, de-duplicated and sorted, at most four |
14998
+ *
14999
+ * `.max(4)` because the notifier's own action budget is small (ntfy allows
15000
+ * three buttons in total) and a rule that spent it all on snooze choices
15001
+ * would push its own tap-through actions off the notification.
15002
+ *
15003
+ * An empty list is NOT an alarm exemption: a rule the alarm is about, or
15004
+ * that arms the panel, is exempt automatically and cannot be silenced by a
15005
+ * window from anywhere (D133).
15006
+ */
15007
+ snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
15008
+ /**
14896
15009
  * Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
14897
15010
  *
14898
15011
  * This is what makes the rule set the alarm's trigger set without the alarm
@@ -14992,6 +15105,7 @@ var NcConditionDescriptorSchema = object({
14992
15105
  "device",
14993
15106
  "package",
14994
15107
  "occupancy",
15108
+ "audio",
14995
15109
  "system"
14996
15110
  ]),
14997
15111
  label: string(),
@@ -15010,6 +15124,7 @@ var NcConditionDescriptorSchema = object({
15010
15124
  "crossingSelect",
15011
15125
  "polygonDraw",
15012
15126
  "occupancy",
15127
+ "audio",
15013
15128
  "deviceState",
15014
15129
  "systemEvent"
15015
15130
  ]),
@@ -15161,7 +15276,20 @@ var NcSnoozeInputSchema = object({
15161
15276
  ruleId: string().optional(),
15162
15277
  /** Required when `scope: 'device'`. */
15163
15278
  deviceId: number().int().optional(),
15164
- durationMinutes: number().int().min(1).max(1440),
15279
+ /**
15280
+ * Narrow the window to these subject classes — "the cat, not the person".
15281
+ *
15282
+ * ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
15283
+ * what every window authored before this field meant, so no persisted row
15284
+ * changes meaning and no client has to learn anything to keep working.
15285
+ *
15286
+ * It is what makes the window's real key `(deviceId, classes[])` and lets it
15287
+ * cross rules (D133): the operator points at a camera and a kind of thing,
15288
+ * not at whichever of their four rules happened to produce the notification
15289
+ * they are dismissing.
15290
+ */
15291
+ classes: array(string().min(1)).min(1).optional(),
15292
+ durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
15165
15293
  /**
15166
15294
  * Silence this for EVERY recipient, not just the caller. Permission is
15167
15295
  * checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
@@ -15186,6 +15314,10 @@ var NcSnoozeSchema = object({
15186
15314
  scope: NcSnoozeScopeSchema,
15187
15315
  ruleId: string().optional(),
15188
15316
  deviceId: number().int().optional(),
15317
+ /** Subject classes this window covers. ABSENT = every class — see
15318
+ * {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
15319
+ * no SQLite column: nothing queries a window by class. */
15320
+ classes: array(string().min(1)).min(1).optional(),
15189
15321
  startedAt: number(),
15190
15322
  /** Exclusive: at exactly this instant the snooze is over. Expiry is a
15191
15323
  * COMPARISON, not a job — no sweeper can leave the operator silenced. */
@@ -17286,7 +17418,14 @@ var zonesCapability = {
17286
17418
  * handle. Slice shape is `{ zones: Zone[] }` so future extensions
17287
17419
  * (e.g. zone groupings) can sit alongside the polygon list.
17288
17420
  */
17289
- runtimeState: object({ zones: array(ZoneSchema).readonly() })
17421
+ runtimeState: object({ zones: array(ZoneSchema).readonly() }),
17422
+ /**
17423
+ * 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.
17424
+ *
17425
+ * See `RuntimeStateDurability`. Enforced by
17426
+ * `scripts/check-runtime-state-durability.ts`.
17427
+ */
17428
+ durability: "restored"
17290
17429
  };
17291
17430
  /**
17292
17431
  * A bounding box in NORMALIZED [0,1] frame coordinates for `getNativeCrop`. The
@@ -17456,6 +17595,22 @@ var detectionFpsField = {
17456
17595
  default: 10,
17457
17596
  step: 1
17458
17597
  };
17598
+ /**
17599
+ * The occupancy re-check interval. DEFAULT 300 s (2026-08-13 — was 30 s).
17600
+ *
17601
+ * The recheck is now on by default (a parked car is invisible to occupancy
17602
+ * rules until the stationary registry has been rebuilt by motion, which after a
17603
+ * restart may be never on a quiet camera). Each cycle re-subscribes a detection
17604
+ * session — an RTSP re-dial — so the switch is only affordable at a WIDE
17605
+ * interval: 300 s is ~12 re-dials an hour per camera, against 120 at the old
17606
+ * 30 s. A parked car is therefore counted within 5 minutes of a restart.
17607
+ *
17608
+ * Why not wider: `max` is 300 and raising it is TRAIN-BOUND, not addon-bound —
17609
+ * the host validates `attachCamera` against ITS copy of this schema, so a
17610
+ * runner asked for 600 would be rejected by the hub until a `@camstack/server`
17611
+ * carrying the wider bound is installed everywhere. 300 is the widest value
17612
+ * that ships with an addon deploy.
17613
+ */
17459
17614
  var occupancyRecheckSecField = {
17460
17615
  min: 0,
17461
17616
  max: 300,
@@ -17657,15 +17812,21 @@ var RunnerCameraConfigSchema = object({
17657
17812
  */
17658
17813
  onboardMotionDrivesAnalyzer: boolean().default(true),
17659
17814
  /**
17660
- * Master toggle for the occupancy re-check. When `false` (DEFAULT) the runner
17661
- * never arms the periodic recheck timer, regardless of `occupancyRecheckSec`
17662
- * this is off by default because the recheck re-subscribes a detection session
17663
- * every N seconds while `watching`, a major source of pull-decoder re-dial
17664
- * churn (each cycle creates+tears a session → RTSP re-dial → latency). The
17815
+ * Master toggle for the occupancy re-check. When `false` the runner never arms
17816
+ * the periodic recheck timer, regardless of `occupancyRecheckSec`; the
17665
17817
  * `occupancyRecheckSec` / `occupancyRecheckFrames` sliders only take effect
17666
17818
  * (and only render) when this is enabled.
17667
- */
17668
- occupancyRecheckEnabled: boolean().default(false),
17819
+ *
17820
+ * DEFAULT `true` since 2026-08-13 (was `false`). It was off because the
17821
+ * recheck re-subscribes a detection session every N seconds while `watching`
17822
+ * — each cycle creates+tears a session ⇒ an RTSP re-dial ⇒ latency, a major
17823
+ * pull-decoder churn source. What that bought was a blind spot: a STATIONARY
17824
+ * object is counted only while the stationary registry holds it, and the
17825
+ * registry rebuilds from motion, so after a restart a parked car was invisible
17826
+ * to every occupancy rule until something moved in front of it. The churn is
17827
+ * now paid on the interval instead — see `occupancyRecheckSecField`.
17828
+ */
17829
+ occupancyRecheckEnabled: boolean().default(true),
17669
17830
  occupancyRecheckSec: number().min(occupancyRecheckSecField.min).max(occupancyRecheckSecField.max).default(occupancyRecheckSecField.default),
17670
17831
  occupancyRecheckFrames: number().min(occupancyRecheckFramesField.min).max(occupancyRecheckFramesField.max).default(occupancyRecheckFramesField.default),
17671
17832
  /**
@@ -20180,7 +20341,17 @@ var airQualitySensorCapability = {
20180
20341
  schema: AirQualitySensorStatusSchema,
20181
20342
  kind: "push"
20182
20343
  },
20183
- runtimeState: AirQualitySensorStatusSchema
20344
+ runtimeState: AirQualitySensorStatusSchema,
20345
+ /**
20346
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
20347
+ *
20348
+ * See `RuntimeStateDurability`. Enforced by
20349
+ * `scripts/check-runtime-state-durability.ts`.
20350
+ */
20351
+ durability: "restored",
20352
+ /** Clock fields: written, but excluded from the compare that decides
20353
+ * whether persisting is worth a SQLite commit. */
20354
+ volatileStateFields: ["lastFetchedAt"]
20184
20355
  };
20185
20356
  /**
20186
20357
  * Ambient illuminance reading in lux. Drives Home Assistant `sensor`
@@ -20212,7 +20383,17 @@ var ambientLightSensorCapability = {
20212
20383
  schema: AmbientLightSensorStatusSchema,
20213
20384
  kind: "push"
20214
20385
  },
20215
- runtimeState: AmbientLightSensorStatusSchema
20386
+ runtimeState: AmbientLightSensorStatusSchema,
20387
+ /**
20388
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
20389
+ *
20390
+ * See `RuntimeStateDurability`. Enforced by
20391
+ * `scripts/check-runtime-state-durability.ts`.
20392
+ */
20393
+ durability: "restored",
20394
+ /** Clock fields: written, but excluded from the compare that decides
20395
+ * whether persisting is worth a SQLite commit. */
20396
+ volatileStateFields: ["lastFetchedAt"]
20216
20397
  };
20217
20398
  /**
20218
20399
  * Per-class audio metrics aggregated over a sliding window.
@@ -20330,7 +20511,14 @@ var audioMetricsCapability = {
20330
20511
  }), AudioMetricsHistorySchema)
20331
20512
  },
20332
20513
  /** Reactive runtime-state mirror — live `device.state.audioMetrics.value`. */
20333
- runtimeState: AudioMetricsSnapshotSchema
20514
+ runtimeState: AudioMetricsSnapshotSchema,
20515
+ /**
20516
+ * 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.
20517
+ *
20518
+ * See `RuntimeStateDurability`. Enforced by
20519
+ * `scripts/check-runtime-state-durability.ts`.
20520
+ */
20521
+ durability: "session"
20334
20522
  };
20335
20523
  /**
20336
20524
  * Automation-control cap. Models HA `automation.*` entities on
@@ -20392,7 +20580,14 @@ var automationControlCapability = {
20392
20580
  * reads `enabled` (toggle) + `isRunning` (spinner) + `lastError`
20393
20581
  * (badge) directly.
20394
20582
  */
20395
- runtimeState: AutomationControlStatusSchema
20583
+ runtimeState: AutomationControlStatusSchema,
20584
+ /**
20585
+ * 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.
20586
+ *
20587
+ * See `RuntimeStateDurability`. Enforced by
20588
+ * `scripts/check-runtime-state-durability.ts`.
20589
+ */
20590
+ durability: "session"
20396
20591
  };
20397
20592
  /**
20398
20593
  * Battery status snapshot. Emitted by providers whose device is
@@ -20498,7 +20693,17 @@ onStatusChanged: { data: object({
20498
20693
  * via `device.runtimeState.getCapState('battery')` regardless of
20499
20694
  * the underlying driver.
20500
20695
  */
20501
- runtimeState: BatteryStatusSchema
20696
+ runtimeState: BatteryStatusSchema,
20697
+ /**
20698
+ * 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.
20699
+ *
20700
+ * See `RuntimeStateDurability`. Enforced by
20701
+ * `scripts/check-runtime-state-durability.ts`.
20702
+ */
20703
+ durability: "restored",
20704
+ /** Clock fields: written, but excluded from the compare that decides
20705
+ * whether persisting is worth a SQLite commit. */
20706
+ volatileStateFields: ["lastUpdated"]
20502
20707
  };
20503
20708
  /**
20504
20709
  * Generic boolean sensor — last-resort fallback when no domain-
@@ -20527,7 +20732,17 @@ var binaryCapability = {
20527
20732
  schema: BinaryStatusSchema,
20528
20733
  kind: "push"
20529
20734
  },
20530
- runtimeState: BinaryStatusSchema
20735
+ runtimeState: BinaryStatusSchema,
20736
+ /**
20737
+ * Runtime-state durability: **restored** — transition-driven sensor state; the restored value gives the boot comparison.
20738
+ *
20739
+ * See `RuntimeStateDurability`. Enforced by
20740
+ * `scripts/check-runtime-state-durability.ts`.
20741
+ */
20742
+ durability: "restored",
20743
+ /** Clock fields: written, but excluded from the compare that decides
20744
+ * whether persisting is worth a SQLite commit. */
20745
+ volatileStateFields: ["lastChangedAt"]
20531
20746
  };
20532
20747
  /**
20533
20748
  * Dimmable-light brightness control. Co-exists with `switch` on the
@@ -20580,7 +20795,14 @@ onBrightnessChanged: { data: object({
20580
20795
  * by the kernel. Read via `device.state.brightness.value` so UI
20581
20796
  * sliders surface the current level without polling the provider.
20582
20797
  */
20583
- runtimeState: BrightnessStatusSchema
20798
+ runtimeState: BrightnessStatusSchema,
20799
+ /**
20800
+ * Runtime-state durability: **session** — live lamp state, re-published by the provider on connect.
20801
+ *
20802
+ * See `RuntimeStateDurability`. Enforced by
20803
+ * `scripts/check-runtime-state-durability.ts`.
20804
+ */
20805
+ durability: "session"
20584
20806
  };
20585
20807
  DeviceType.Button, method(object({ deviceId: number().int().nonnegative() }), _void(), {
20586
20808
  kind: "mutation",
@@ -20668,7 +20890,17 @@ var carbonMonoxideCapability = {
20668
20890
  schema: CarbonMonoxideStatusSchema,
20669
20891
  kind: "push"
20670
20892
  },
20671
- runtimeState: CarbonMonoxideStatusSchema
20893
+ runtimeState: CarbonMonoxideStatusSchema,
20894
+ /**
20895
+ * Runtime-state durability: **restored** — as `smoke`.
20896
+ *
20897
+ * See `RuntimeStateDurability`. Enforced by
20898
+ * `scripts/check-runtime-state-durability.ts`.
20899
+ */
20900
+ durability: "restored",
20901
+ /** Clock fields: written, but excluded from the compare that decides
20902
+ * whether persisting is worth a SQLite commit. */
20903
+ volatileStateFields: ["lastChangedAt"]
20672
20904
  };
20673
20905
  /**
20674
20906
  * HVAC / climate control cap. Models the full surface of a HA
@@ -20828,7 +21060,14 @@ var climateControlCapability = {
20828
21060
  * the full slice via `device.state.climate-control.value` and refresh
20829
21061
  * on every push without re-querying the provider.
20830
21062
  */
20831
- runtimeState: ClimateControlStatusSchema
21063
+ runtimeState: ClimateControlStatusSchema,
21064
+ /**
21065
+ * Runtime-state durability: **session** — as `brightness`; `currentTemp` moves continuously and is re-published on connect.
21066
+ *
21067
+ * See `RuntimeStateDurability`. Enforced by
21068
+ * `scripts/check-runtime-state-durability.ts`.
21069
+ */
21070
+ durability: "session"
20832
21071
  };
20833
21072
  /**
20834
21073
  * Color-light cap. Coexists with `switch` (on/off) and `brightness`
@@ -20938,7 +21177,14 @@ onColorChanged: { data: object({
20938
21177
  * kernel. Read via `device.state.color.value` so UI pickers surface
20939
21178
  * the current chromaticity without polling the provider.
20940
21179
  */
20941
- runtimeState: ColorStatusSchema
21180
+ runtimeState: ColorStatusSchema,
21181
+ /**
21182
+ * Runtime-state durability: **session** — as `brightness`.
21183
+ *
21184
+ * See `RuntimeStateDurability`. Enforced by
21185
+ * `scripts/check-runtime-state-durability.ts`.
21186
+ */
21187
+ durability: "session"
20942
21188
  };
20943
21189
  var ConnectionTestOutcomeSchema = discriminatedUnion("outcome", [
20944
21190
  object({
@@ -20996,7 +21242,17 @@ var connectivityCapability = {
20996
21242
  schema: ConnectivityStatusSchema,
20997
21243
  kind: "push"
20998
21244
  },
20999
- runtimeState: ConnectivityStatusSchema
21245
+ runtimeState: ConnectivityStatusSchema,
21246
+ /**
21247
+ * Runtime-state durability: **restored** — same shape and same argument as `device-status`, for links rather than devices.
21248
+ *
21249
+ * See `RuntimeStateDurability`. Enforced by
21250
+ * `scripts/check-runtime-state-durability.ts`.
21251
+ */
21252
+ durability: "restored",
21253
+ /** Clock fields: written, but excluded from the compare that decides
21254
+ * whether persisting is worth a SQLite commit. */
21255
+ volatileStateFields: ["lastChangedAt"]
21000
21256
  };
21001
21257
  /**
21002
21258
  * Generic device-consumables capability — surfaces a device's
@@ -21078,7 +21334,14 @@ reset: method(object({
21078
21334
  }
21079
21335
  }
21080
21336
  },
21081
- runtimeState: ConsumablesStatusSchema.extend({ lastFetchedAt: number() })
21337
+ runtimeState: ConsumablesStatusSchema.extend({ lastFetchedAt: number() }),
21338
+ /**
21339
+ * Runtime-state durability: **session** — the authority is the appliance; the provider re-reads the whole item array on connect.
21340
+ *
21341
+ * See `RuntimeStateDurability`. Enforced by
21342
+ * `scripts/check-runtime-state-durability.ts`.
21343
+ */
21344
+ durability: "session"
21082
21345
  };
21083
21346
  /**
21084
21347
  * Door / window / opening / garage / valve contact sensor. Boolean
@@ -21109,7 +21372,17 @@ var contactCapability = {
21109
21372
  schema: ContactStatusSchema,
21110
21373
  kind: "push"
21111
21374
  },
21112
- runtimeState: ContactStatusSchema
21375
+ runtimeState: ContactStatusSchema,
21376
+ /**
21377
+ * Runtime-state durability: **restored** — a door left open across a restart must still read open.
21378
+ *
21379
+ * See `RuntimeStateDurability`. Enforced by
21380
+ * `scripts/check-runtime-state-durability.ts`.
21381
+ */
21382
+ durability: "restored",
21383
+ /** Clock fields: written, but excluded from the compare that decides
21384
+ * whether persisting is worth a SQLite commit. */
21385
+ volatileStateFields: ["lastChangedAt"]
21113
21386
  };
21114
21387
  /**
21115
21388
  * Status slice — flat object (the framework's `runtimeState` contract
@@ -21215,7 +21488,14 @@ var controlCapability = {
21215
21488
  * dropdown / text field / date picker) read the slice's discriminant
21216
21489
  * and value directly without polling the provider.
21217
21490
  */
21218
- runtimeState: ControlStatusSchema
21491
+ runtimeState: ControlStatusSchema,
21492
+ /**
21493
+ * Runtime-state durability: **session** — a generic control mirrors an external entity that re-publishes on connect; the options array is re-derived with it.
21494
+ *
21495
+ * See `RuntimeStateDurability`. Enforced by
21496
+ * `scripts/check-runtime-state-durability.ts`.
21497
+ */
21498
+ durability: "session"
21219
21499
  };
21220
21500
  var CoverStatusSchema = object({
21221
21501
  /** Lifecycle state of the cover. */
@@ -21276,7 +21556,17 @@ var coverCapability = {
21276
21556
  * Runtime-state slice — mirrored by the kernel. UI controls watch
21277
21557
  * the slice for live position changes during a move.
21278
21558
  */
21279
- runtimeState: CoverStatusSchema
21559
+ runtimeState: CoverStatusSchema,
21560
+ /**
21561
+ * Runtime-state durability: **restored** — position survives a restart on the device; the mirror should agree at boot rather than read blank.
21562
+ *
21563
+ * See `RuntimeStateDurability`. Enforced by
21564
+ * `scripts/check-runtime-state-durability.ts`.
21565
+ */
21566
+ durability: "restored",
21567
+ /** Clock fields: written, but excluded from the compare that decides
21568
+ * whether persisting is worth a SQLite commit. */
21569
+ volatileStateFields: ["lastChangedAt"]
21280
21570
  };
21281
21571
  /**
21282
21572
  * Vendor-neutral day/night (IR-cut) control — the per-camera config cap
@@ -21370,7 +21660,17 @@ var dayNightCapability = {
21370
21660
  schema: DayNightStatusSchema,
21371
21661
  kind: "poll"
21372
21662
  },
21373
- runtimeState: DayNightStatusSchema
21663
+ runtimeState: DayNightStatusSchema,
21664
+ /**
21665
+ * Runtime-state durability: **restored** — operator-set IR-cut behaviour; mutation-driven.
21666
+ *
21667
+ * See `RuntimeStateDurability`. Enforced by
21668
+ * `scripts/check-runtime-state-durability.ts`.
21669
+ */
21670
+ durability: "restored",
21671
+ /** Clock fields: written, but excluded from the compare that decides
21672
+ * whether persisting is worth a SQLite commit. */
21673
+ volatileStateFields: ["lastFetchedAt"]
21374
21674
  };
21375
21675
  /**
21376
21676
  * Generic device-level status snapshot. Auto-registered by `BaseDevice`
@@ -21417,7 +21717,17 @@ onStatusChanged: { data: object({
21417
21717
  schema: DeviceStatusSchema,
21418
21718
  kind: "push"
21419
21719
  },
21420
- runtimeState: DeviceStatusSchema
21720
+ runtimeState: DeviceStatusSchema,
21721
+ /**
21722
+ * 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.
21723
+ *
21724
+ * See `RuntimeStateDurability`. Enforced by
21725
+ * `scripts/check-runtime-state-durability.ts`.
21726
+ */
21727
+ durability: "restored",
21728
+ /** Clock fields: written, but excluded from the compare that decides
21729
+ * whether persisting is worth a SQLite commit. */
21730
+ volatileStateFields: ["lastChangedAt"]
21421
21731
  };
21422
21732
  /**
21423
21733
  * Doorbell button cap. Two kinds of providers coexist behind this cap
@@ -21479,7 +21789,14 @@ onPressed: { data: DoorbellPressEventSchema } },
21479
21789
  * `device.state.doorbell.value`. UIs can show "last ring 5m ago"
21480
21790
  * without subscribing.
21481
21791
  */
21482
- runtimeState: DoorbellStatusSchema
21792
+ runtimeState: DoorbellStatusSchema,
21793
+ /**
21794
+ * 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.
21795
+ *
21796
+ * See `RuntimeStateDurability`. Enforced by
21797
+ * `scripts/check-runtime-state-durability.ts`.
21798
+ */
21799
+ durability: "restored"
21483
21800
  };
21484
21801
  /**
21485
21802
  * Enum-state sensor — a string value picked from a finite option set.
@@ -21519,7 +21836,17 @@ var enumSensorCapability = {
21519
21836
  schema: EnumSensorStatusSchema,
21520
21837
  kind: "push"
21521
21838
  },
21522
- runtimeState: EnumSensorStatusSchema
21839
+ runtimeState: EnumSensorStatusSchema,
21840
+ /**
21841
+ * Runtime-state durability: **restored** — as `numeric-sensor`; 80 devices.
21842
+ *
21843
+ * See `RuntimeStateDurability`. Enforced by
21844
+ * `scripts/check-runtime-state-durability.ts`.
21845
+ */
21846
+ durability: "restored",
21847
+ /** Clock fields: written, but excluded from the compare that decides
21848
+ * whether persisting is worth a SQLite commit. */
21849
+ volatileStateFields: ["lastFetchedAt"]
21523
21850
  };
21524
21851
  /**
21525
21852
  * Generic stateless event emitter. Installed on a `DeviceType.EventEmitter`
@@ -21555,7 +21882,14 @@ var eventEmitterCapability = {
21555
21882
  schema: EventEmitterStatusSchema,
21556
21883
  kind: "push"
21557
21884
  },
21558
- runtimeState: EventEmitterStatusSchema
21885
+ runtimeState: EventEmitterStatusSchema,
21886
+ /**
21887
+ * Runtime-state durability: **session** — `eventCountSinceStart` names its own scope.
21888
+ *
21889
+ * See `RuntimeStateDurability`. Enforced by
21890
+ * `scripts/check-runtime-state-durability.ts`.
21891
+ */
21892
+ durability: "session"
21559
21893
  };
21560
21894
  var EventItemSchema = object({
21561
21895
  id: string(),
@@ -21836,7 +22170,14 @@ var fanControlCapability = {
21836
22170
  * Runtime-state slice — mirrored by the kernel. UI fan speed
21837
22171
  * sliders read `percentage` for live updates.
21838
22172
  */
21839
- runtimeState: FanControlStatusSchema
22173
+ runtimeState: FanControlStatusSchema,
22174
+ /**
22175
+ * Runtime-state durability: **session** — as `brightness`.
22176
+ *
22177
+ * See `RuntimeStateDurability`. Enforced by
22178
+ * `scripts/check-runtime-state-durability.ts`.
22179
+ */
22180
+ durability: "session"
21840
22181
  };
21841
22182
  /**
21842
22183
  * Per-device feature/identity probe slice. Holds the runtime-resolved
@@ -21912,7 +22253,14 @@ onProbeChanged: { data: object({
21912
22253
  schema: FeatureProbeStatusSchema,
21913
22254
  kind: "push"
21914
22255
  },
21915
- runtimeState: FeatureProbeStatusSchema
22256
+ runtimeState: FeatureProbeStatusSchema,
22257
+ /**
22258
+ * 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.
22259
+ *
22260
+ * See `RuntimeStateDurability`. Enforced by
22261
+ * `scripts/check-runtime-state-durability.ts`.
22262
+ */
22263
+ durability: "session"
21916
22264
  };
21917
22265
  /**
21918
22266
  * Water leak / moisture sensor. Boolean "is liquid currently
@@ -21939,7 +22287,17 @@ var floodCapability = {
21939
22287
  schema: FloodStatusSchema,
21940
22288
  kind: "push"
21941
22289
  },
21942
- runtimeState: FloodStatusSchema
22290
+ runtimeState: FloodStatusSchema,
22291
+ /**
22292
+ * Runtime-state durability: **restored** — as `smoke`.
22293
+ *
22294
+ * See `RuntimeStateDurability`. Enforced by
22295
+ * `scripts/check-runtime-state-durability.ts`.
22296
+ */
22297
+ durability: "restored",
22298
+ /** Clock fields: written, but excluded from the compare that decides
22299
+ * whether persisting is worth a SQLite commit. */
22300
+ volatileStateFields: ["lastChangedAt"]
21943
22301
  };
21944
22302
  /**
21945
22303
  * Combustible-gas (LPG / methane / hydrogen) alarm sensor. Drives
@@ -21962,7 +22320,17 @@ var gasCapability = {
21962
22320
  schema: GasStatusSchema,
21963
22321
  kind: "push"
21964
22322
  },
21965
- runtimeState: GasStatusSchema
22323
+ runtimeState: GasStatusSchema,
22324
+ /**
22325
+ * Runtime-state durability: **restored** — as `smoke`.
22326
+ *
22327
+ * See `RuntimeStateDurability`. Enforced by
22328
+ * `scripts/check-runtime-state-durability.ts`.
22329
+ */
22330
+ durability: "restored",
22331
+ /** Clock fields: written, but excluded from the compare that decides
22332
+ * whether persisting is worth a SQLite commit. */
22333
+ volatileStateFields: ["lastChangedAt"]
21966
22334
  };
21967
22335
  /**
21968
22336
  * Humidifier / dehumidifier cap. Models HA `humidifier.*` entities —
@@ -22038,7 +22406,14 @@ var humidifierCapability = {
22038
22406
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
22039
22407
  * slice for live humidity / mode changes.
22040
22408
  */
22041
- runtimeState: HumidifierStatusSchema
22409
+ runtimeState: HumidifierStatusSchema,
22410
+ /**
22411
+ * Runtime-state durability: **session** — as `climate-control`.
22412
+ *
22413
+ * See `RuntimeStateDurability`. Enforced by
22414
+ * `scripts/check-runtime-state-durability.ts`.
22415
+ */
22416
+ durability: "session"
22042
22417
  };
22043
22418
  /**
22044
22419
  * Single-metric humidity reading. Drives Home Assistant `sensor`
@@ -22074,7 +22449,17 @@ var humiditySensorCapability = {
22074
22449
  schema: HumiditySensorStatusSchema,
22075
22450
  kind: "push"
22076
22451
  },
22077
- runtimeState: HumiditySensorStatusSchema
22452
+ runtimeState: HumiditySensorStatusSchema,
22453
+ /**
22454
+ * Runtime-state durability: **restored** — as `numeric-sensor` (67 of 75 writes were the clock alone).
22455
+ *
22456
+ * See `RuntimeStateDurability`. Enforced by
22457
+ * `scripts/check-runtime-state-durability.ts`.
22458
+ */
22459
+ durability: "restored",
22460
+ /** Clock fields: written, but excluded from the compare that decides
22461
+ * whether persisting is worth a SQLite commit. */
22462
+ volatileStateFields: ["lastFetchedAt"]
22078
22463
  };
22079
22464
  /**
22080
22465
  * Image display cap. Models a single still image exposed by an integration —
@@ -22112,7 +22497,14 @@ var imageCapability = {
22112
22497
  * Runtime-state slice — mirrored by the kernel. The UI reads `url`
22113
22498
  * directly and renders the still image.
22114
22499
  */
22115
- runtimeState: ImageStatusSchema
22500
+ runtimeState: ImageStatusSchema,
22501
+ /**
22502
+ * Runtime-state durability: **session** — a snapshot URL is a session-scoped handle; a restored one points at nothing.
22503
+ *
22504
+ * See `RuntimeStateDurability`. Enforced by
22505
+ * `scripts/check-runtime-state-durability.ts`.
22506
+ */
22507
+ durability: "session"
22116
22508
  };
22117
22509
  /**
22118
22510
  * Vendor-neutral image / picture-adjustment cap — the per-camera config
@@ -22261,7 +22653,17 @@ var imageSettingsCapability = {
22261
22653
  schema: ImageSettingsStatusSchema,
22262
22654
  kind: "poll"
22263
22655
  },
22264
- runtimeState: ImageSettingsStatusSchema
22656
+ runtimeState: ImageSettingsStatusSchema,
22657
+ /**
22658
+ * Runtime-state durability: **restored** — operator-set camera imaging; mutation-driven.
22659
+ *
22660
+ * See `RuntimeStateDurability`. Enforced by
22661
+ * `scripts/check-runtime-state-durability.ts`.
22662
+ */
22663
+ durability: "restored",
22664
+ /** Clock fields: written, but excluded from the compare that decides
22665
+ * whether persisting is worth a SQLite commit. */
22666
+ volatileStateFields: ["lastFetchedAt"]
22265
22667
  };
22266
22668
  /**
22267
22669
  * integrations — system-scoped singleton capability for integration
@@ -22652,7 +23054,14 @@ var lawnMowerControlCapability = {
22652
23054
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
22653
23055
  * slice for live activity + battery changes.
22654
23056
  */
22655
- runtimeState: LawnMowerControlStatusSchema
23057
+ runtimeState: LawnMowerControlStatusSchema,
23058
+ /**
23059
+ * Runtime-state durability: **session** — as `vacuum-control`.
23060
+ *
23061
+ * See `RuntimeStateDurability`. Enforced by
23062
+ * `scripts/check-runtime-state-durability.ts`.
23063
+ */
23064
+ durability: "session"
22656
23065
  };
22657
23066
  /**
22658
23067
  * local-network — hub-only singleton.
@@ -22858,7 +23267,17 @@ var lockControlCapability = {
22858
23267
  * read `state` and disable themselves during `locking`/`unlocking`
22859
23268
  * transitions.
22860
23269
  */
22861
- runtimeState: LockControlStatusSchema
23270
+ runtimeState: LockControlStatusSchema,
23271
+ /**
23272
+ * Runtime-state durability: **restored** — a lock left locked must still read locked.
23273
+ *
23274
+ * See `RuntimeStateDurability`. Enforced by
23275
+ * `scripts/check-runtime-state-durability.ts`.
23276
+ */
23277
+ durability: "restored",
23278
+ /** Clock fields: written, but excluded from the compare that decides
23279
+ * whether persisting is worth a SQLite commit. */
23280
+ volatileStateFields: ["lastChangedAt"]
22862
23281
  };
22863
23282
  /**
22864
23283
  * Media-player cap. Models HA `media_player.*` (Sonos, Chromecast,
@@ -23020,7 +23439,14 @@ var mediaPlayerCapability = {
23020
23439
  * full slice for live now-playing, volume, and progress updates
23021
23440
  * without polling.
23022
23441
  */
23023
- runtimeState: MediaPlayerStatusSchema
23442
+ runtimeState: MediaPlayerStatusSchema,
23443
+ /**
23444
+ * Runtime-state durability: **session** — a restored transport position describes a playback that stopped when the hub did.
23445
+ *
23446
+ * See `RuntimeStateDurability`. Enforced by
23447
+ * `scripts/check-runtime-state-durability.ts`.
23448
+ */
23449
+ durability: "session"
23024
23450
  };
23025
23451
  /**
23026
23452
  * mesh-network — collection cap for mesh-VPN providers.
@@ -23284,7 +23710,14 @@ onMotionChanged: { data: MotionOnMotionChangedDataSchema } },
23284
23710
  * `device.state.motion.value`. Reads never invoke the provider, so
23285
23711
  * UIs and other addons can poll the cached state safely.
23286
23712
  */
23287
- runtimeState: MotionStatusSchema
23713
+ runtimeState: MotionStatusSchema,
23714
+ /**
23715
+ * 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.
23716
+ *
23717
+ * See `RuntimeStateDurability`. Enforced by
23718
+ * `scripts/check-runtime-state-durability.ts`.
23719
+ */
23720
+ durability: "session"
23288
23721
  };
23289
23722
  /**
23290
23723
  * Motion-trigger toggle for accessory devices.
@@ -23349,7 +23782,14 @@ var motionTriggerCapability = {
23349
23782
  schema: MotionTriggerStatusSchema,
23350
23783
  kind: "command-driven"
23351
23784
  },
23352
- runtimeState: MotionTriggerRuntimeStateSchema
23785
+ runtimeState: MotionTriggerRuntimeStateSchema,
23786
+ /**
23787
+ * 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.
23788
+ *
23789
+ * See `RuntimeStateDurability`. Enforced by
23790
+ * `scripts/check-runtime-state-durability.ts`.
23791
+ */
23792
+ durability: "session"
23353
23793
  };
23354
23794
  /**
23355
23795
  * Motion-zones share the same MaskShape vocabulary as privacy-mask — the
@@ -23416,7 +23856,17 @@ var motionZonesCapability = {
23416
23856
  schema: MotionZoneStatusSchema,
23417
23857
  kind: "poll"
23418
23858
  },
23419
- runtimeState: MotionZoneStatusSchema
23859
+ runtimeState: MotionZoneStatusSchema,
23860
+ /**
23861
+ * 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.
23862
+ *
23863
+ * See `RuntimeStateDurability`. Enforced by
23864
+ * `scripts/check-runtime-state-durability.ts`.
23865
+ */
23866
+ durability: "restored",
23867
+ /** Clock fields: written, but excluded from the compare that decides
23868
+ * whether persisting is worth a SQLite commit. */
23869
+ volatileStateFields: ["lastFetchedAt"]
23420
23870
  };
23421
23871
  /**
23422
23872
  * On-camera AI object detection cap. Surfaces per-device the classes
@@ -23490,7 +23940,17 @@ var nativeObjectDetectionCapability = {
23490
23940
  schema: NativeObjectDetectionStatusSchema,
23491
23941
  kind: "push"
23492
23942
  },
23493
- runtimeState: NativeObjectDetectionRuntimeStateSchema
23943
+ runtimeState: NativeObjectDetectionRuntimeStateSchema,
23944
+ /**
23945
+ * 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.
23946
+ *
23947
+ * See `RuntimeStateDurability`. Enforced by
23948
+ * `scripts/check-runtime-state-durability.ts`.
23949
+ */
23950
+ durability: "restored",
23951
+ /** Clock fields: written, but excluded from the compare that decides
23952
+ * whether persisting is worth a SQLite commit. */
23953
+ volatileStateFields: ["lastFetchedAt"]
23494
23954
  };
23495
23955
  /**
23496
23956
  * network-quality — system-scoped singleton capability tracking RTT,
@@ -23824,7 +24284,14 @@ onSent: { data: object({
23824
24284
  * form reads `supports` to gate optional fields; history pane reads
23825
24285
  * `lastSentAt` / `lastError` / `queueDepth`.
23826
24286
  */
23827
- runtimeState: NotifierStatusSchema
24287
+ runtimeState: NotifierStatusSchema,
24288
+ /**
24289
+ * Runtime-state durability: **session** — live queue depth and last-send state; a restored queue depth describes a queue that no longer exists.
24290
+ *
24291
+ * See `RuntimeStateDurability`. Enforced by
24292
+ * `scripts/check-runtime-state-durability.ts`.
24293
+ */
24294
+ durability: "session"
23828
24295
  };
23829
24296
  /**
23830
24297
  * Generic numeric sensor — last-resort fallback when no typed numeric
@@ -23867,7 +24334,17 @@ var numericSensorCapability = {
23867
24334
  schema: NumericSensorStatusSchema,
23868
24335
  kind: "push"
23869
24336
  },
23870
- runtimeState: NumericSensorStatusSchema
24337
+ runtimeState: NumericSensorStatusSchema,
24338
+ /**
24339
+ * 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.
24340
+ *
24341
+ * See `RuntimeStateDurability`. Enforced by
24342
+ * `scripts/check-runtime-state-durability.ts`.
24343
+ */
24344
+ durability: "restored",
24345
+ /** Clock fields: written, but excluded from the compare that decides
24346
+ * whether persisting is worth a SQLite commit. */
24347
+ volatileStateFields: ["lastFetchedAt"]
23871
24348
  };
23872
24349
  /**
23873
24350
  * Generic on-screen-display (video overlay) cap. Each camera exposes
@@ -24252,7 +24729,14 @@ var petFeederCapability = {
24252
24729
  * the full slice via `device.state.petFeeder.value` and refresh on
24253
24730
  * every poll without re-querying the provider.
24254
24731
  */
24255
- runtimeState: PetFeederStatusSchema
24732
+ runtimeState: PetFeederStatusSchema,
24733
+ /**
24734
+ * Runtime-state durability: **session** — live appliance state re-published on connect.
24735
+ *
24736
+ * See `RuntimeStateDurability`. Enforced by
24737
+ * `scripts/check-runtime-state-durability.ts`.
24738
+ */
24739
+ durability: "session"
24256
24740
  };
24257
24741
  var VehicleSchema = object({
24258
24742
  id: string(),
@@ -24564,7 +25048,17 @@ var powerMeterCapability = {
24564
25048
  schema: PowerMeterStatusSchema,
24565
25049
  kind: "push"
24566
25050
  },
24567
- runtimeState: PowerMeterStatusSchema
25051
+ runtimeState: PowerMeterStatusSchema,
25052
+ /**
25053
+ * Runtime-state durability: **restored** — as `numeric-sensor`; `kwhTotal` is an accumulator whose restored value is the baseline.
25054
+ *
25055
+ * See `RuntimeStateDurability`. Enforced by
25056
+ * `scripts/check-runtime-state-durability.ts`.
25057
+ */
25058
+ durability: "restored",
25059
+ /** Clock fields: written, but excluded from the compare that decides
25060
+ * whether persisting is worth a SQLite commit. */
25061
+ volatileStateFields: ["lastFetchedAt"]
24568
25062
  };
24569
25063
  /**
24570
25064
  * Presence cap. Models HA `person.*` and `device_tracker.*` entities
@@ -24621,7 +25115,17 @@ var presenceCapability = {
24621
25115
  * the map pin is rendered (use `DeviceFeature.PresenceGps` for the
24622
25116
  * pre-fetch fast-path check).
24623
25117
  */
24624
- runtimeState: PresenceStatusSchema
25118
+ runtimeState: PresenceStatusSchema,
25119
+ /**
25120
+ * Runtime-state durability: **restored** — occupancy-relevant: the restored state is what an occupancy rule compares the first post-restart observation against.
25121
+ *
25122
+ * See `RuntimeStateDurability`. Enforced by
25123
+ * `scripts/check-runtime-state-durability.ts`.
25124
+ */
25125
+ durability: "restored",
25126
+ /** Clock fields: written, but excluded from the compare that decides
25127
+ * whether persisting is worth a SQLite commit. */
25128
+ volatileStateFields: ["lastChangedAt"]
24625
25129
  };
24626
25130
  /**
24627
25131
  * Atmospheric pressure reading in hectopascals. Drives Home Assistant
@@ -24657,7 +25161,17 @@ var pressureSensorCapability = {
24657
25161
  schema: PressureSensorStatusSchema,
24658
25162
  kind: "push"
24659
25163
  },
24660
- runtimeState: PressureSensorStatusSchema
25164
+ runtimeState: PressureSensorStatusSchema,
25165
+ /**
25166
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
25167
+ *
25168
+ * See `RuntimeStateDurability`. Enforced by
25169
+ * `scripts/check-runtime-state-durability.ts`.
25170
+ */
25171
+ durability: "restored",
25172
+ /** Clock fields: written, but excluded from the compare that decides
25173
+ * whether persisting is worth a SQLite commit. */
25174
+ volatileStateFields: ["lastFetchedAt"]
24661
25175
  };
24662
25176
  /**
24663
25177
  * PRIVACY — what the camera deliberately does not capture. Two planes:
@@ -24787,7 +25301,17 @@ var privacyMaskCapability = {
24787
25301
  schema: PrivacyMaskStatusSchema,
24788
25302
  kind: "poll"
24789
25303
  },
24790
- runtimeState: PrivacyMaskStatusSchema
25304
+ runtimeState: PrivacyMaskStatusSchema,
25305
+ /**
25306
+ * Runtime-state durability: **restored** — operator-drawn regions, zero real churn — 22 writes in 25 minutes, every one of them the clock.
25307
+ *
25308
+ * See `RuntimeStateDurability`. Enforced by
25309
+ * `scripts/check-runtime-state-durability.ts`.
25310
+ */
25311
+ durability: "restored",
25312
+ /** Clock fields: written, but excluded from the compare that decides
25313
+ * whether persisting is worth a SQLite commit. */
25314
+ volatileStateFields: ["lastFetchedAt"]
24791
25315
  };
24792
25316
  var PtzPresetSchema = object({
24793
25317
  id: string(),
@@ -24953,7 +25477,14 @@ var ptzAutotrackCapability = {
24953
25477
  * fetch / cache / fallback logic out of the four cap methods —
24954
25478
  * they become trampolines over `runtimeState`.
24955
25479
  */
24956
- runtimeState: PtzAutotrackRuntimeStateSchema
25480
+ runtimeState: PtzAutotrackRuntimeStateSchema,
25481
+ /**
25482
+ * Runtime-state durability: **session** — mirrors the camera's own autotrack config, re-read on connect.
25483
+ *
25484
+ * See `RuntimeStateDurability`. Enforced by
25485
+ * `scripts/check-runtime-state-durability.ts`.
25486
+ */
25487
+ durability: "session"
24957
25488
  };
24958
25489
  DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceId: number().int().nonnegative() }), object({ success: literal(true) }), {
24959
25490
  kind: "mutation",
@@ -25603,7 +26134,14 @@ var sceneMonitorCapability = {
25603
26134
  schema: SceneMonitorStatusSchema,
25604
26135
  kind: "push"
25605
26136
  },
25606
- runtimeState: SceneMonitorStatusSchema
26137
+ runtimeState: SceneMonitorStatusSchema,
26138
+ /**
26139
+ * Runtime-state durability: **session** — re-derived from the current scene on the next evaluation.
26140
+ *
26141
+ * See `RuntimeStateDurability`. Enforced by
26142
+ * `scripts/check-runtime-state-durability.ts`.
26143
+ */
26144
+ durability: "session"
25607
26145
  };
25608
26146
  /**
25609
26147
  * Per-stage gating mode applied to the zones a rule references.
@@ -25747,7 +26285,14 @@ var scriptRunnerCapability = {
25747
26285
  * `isRunning` to render a spinner during execution and surfaces
25748
26286
  * `lastError` / `lastRunSuccess` in the recent-runs panel.
25749
26287
  */
25750
- runtimeState: ScriptRunnerStatusSchema
26288
+ runtimeState: ScriptRunnerStatusSchema,
26289
+ /**
26290
+ * Runtime-state durability: **session** — a restored `isRunning: true` describes a process that died with the previous hub.
26291
+ *
26292
+ * See `RuntimeStateDurability`. Enforced by
26293
+ * `scripts/check-runtime-state-durability.ts`.
26294
+ */
26295
+ durability: "session"
25751
26296
  };
25752
26297
  /**
25753
26298
  * Smoke alarm sensor — boolean "is smoke currently detected" with
@@ -25774,7 +26319,17 @@ var smokeCapability = {
25774
26319
  schema: SmokeStatusSchema,
25775
26320
  kind: "push"
25776
26321
  },
25777
- runtimeState: SmokeStatusSchema
26322
+ runtimeState: SmokeStatusSchema,
26323
+ /**
26324
+ * Runtime-state durability: **restored** — a safety sensor must not read "clear" merely because the hub restarted.
26325
+ *
26326
+ * See `RuntimeStateDurability`. Enforced by
26327
+ * `scripts/check-runtime-state-durability.ts`.
26328
+ */
26329
+ durability: "restored",
26330
+ /** Clock fields: written, but excluded from the compare that decides
26331
+ * whether persisting is worth a SQLite commit. */
26332
+ volatileStateFields: ["lastChangedAt"]
25778
26333
  };
25779
26334
  /**
25780
26335
  * One publishable camera stream as its OWNING PROVIDER describes it — the same
@@ -25960,7 +26515,17 @@ var streamParamsCapability = {
25960
26515
  schema: StreamParamsStatusSchema,
25961
26516
  kind: "poll"
25962
26517
  },
25963
- runtimeState: StreamParamsStatusSchema
26518
+ runtimeState: StreamParamsStatusSchema,
26519
+ /**
26520
+ * Runtime-state durability: **restored** — operator-set encoder profile; mutation-driven.
26521
+ *
26522
+ * See `RuntimeStateDurability`. Enforced by
26523
+ * `scripts/check-runtime-state-durability.ts`.
26524
+ */
26525
+ durability: "restored",
26526
+ /** Clock fields: written, but excluded from the compare that decides
26527
+ * whether persisting is worth a SQLite commit. */
26528
+ volatileStateFields: ["lastFetchedAt"]
25964
26529
  };
25965
26530
  /**
25966
26531
  * Generic on/off switch cap for accessory children (siren, floodlight,
@@ -26006,6 +26571,16 @@ var switchCapability = {
26006
26571
  * not need to re-query the provider after a setState mutation.
26007
26572
  */
26008
26573
  runtimeState: SwitchStatusSchema,
26574
+ /**
26575
+ * Runtime-state durability: **restored** — device state an operator reads as authoritative; 55 devices, transition-driven.
26576
+ *
26577
+ * See `RuntimeStateDurability`. Enforced by
26578
+ * `scripts/check-runtime-state-durability.ts`.
26579
+ */
26580
+ durability: "restored",
26581
+ /** Clock fields: written, but excluded from the compare that decides
26582
+ * whether persisting is worth a SQLite commit. */
26583
+ volatileStateFields: ["lastChangedAt"],
26009
26584
  settings: { bindings: [{
26010
26585
  kind: "scalar",
26011
26586
  statusPath: "on",
@@ -26085,7 +26660,17 @@ var tamperCapability = {
26085
26660
  schema: TamperStatusSchema,
26086
26661
  kind: "push"
26087
26662
  },
26088
- runtimeState: TamperStatusSchema
26663
+ runtimeState: TamperStatusSchema,
26664
+ /**
26665
+ * Runtime-state durability: **restored** — as `smoke`.
26666
+ *
26667
+ * See `RuntimeStateDurability`. Enforced by
26668
+ * `scripts/check-runtime-state-durability.ts`.
26669
+ */
26670
+ durability: "restored",
26671
+ /** Clock fields: written, but excluded from the compare that decides
26672
+ * whether persisting is worth a SQLite commit. */
26673
+ volatileStateFields: ["lastChangedAt"]
26089
26674
  };
26090
26675
  /**
26091
26676
  * Single-metric temperature reading. Drives Home Assistant `sensor`
@@ -26130,7 +26715,17 @@ var temperatureSensorCapability = {
26130
26715
  schema: TemperatureSensorStatusSchema,
26131
26716
  kind: "push"
26132
26717
  },
26133
- runtimeState: TemperatureSensorStatusSchema
26718
+ runtimeState: TemperatureSensorStatusSchema,
26719
+ /**
26720
+ * Runtime-state durability: **restored** — as `numeric-sensor` (69 of 125 writes were the clock alone).
26721
+ *
26722
+ * See `RuntimeStateDurability`. Enforced by
26723
+ * `scripts/check-runtime-state-durability.ts`.
26724
+ */
26725
+ durability: "restored",
26726
+ /** Clock fields: written, but excluded from the compare that decides
26727
+ * whether persisting is worth a SQLite commit. */
26728
+ volatileStateFields: ["lastFetchedAt"]
26134
26729
  };
26135
26730
  /**
26136
26731
  * toast — system-scoped singleton capability that streams toast
@@ -26199,7 +26794,14 @@ var updateCapability = {
26199
26794
  schema: UpdateStatusSchema,
26200
26795
  kind: "poll"
26201
26796
  },
26202
- runtimeState: UpdateStatusSchema
26797
+ runtimeState: UpdateStatusSchema,
26798
+ /**
26799
+ * Runtime-state durability: **session** — a restored `inProgress: true` describes an update that is no longer running; versions are re-probed at boot.
26800
+ *
26801
+ * See `RuntimeStateDurability`. Enforced by
26802
+ * `scripts/check-runtime-state-durability.ts`.
26803
+ */
26804
+ durability: "session"
26203
26805
  };
26204
26806
  var UserSummarySchema = object({
26205
26807
  id: string(),
@@ -26533,7 +27135,14 @@ var vacuumControlCapability = {
26533
27135
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
26534
27136
  * slice for live state + battery + fan-speed changes.
26535
27137
  */
26536
- runtimeState: VacuumControlStatusSchema
27138
+ runtimeState: VacuumControlStatusSchema,
27139
+ /**
27140
+ * Runtime-state durability: **session** — as `media-player` — a restored `state: cleaning` is a robot that is not cleaning.
27141
+ *
27142
+ * See `RuntimeStateDurability`. Enforced by
27143
+ * `scripts/check-runtime-state-durability.ts`.
27144
+ */
27145
+ durability: "session"
26537
27146
  };
26538
27147
  var ValveStatusSchema = object({
26539
27148
  /** Lifecycle state of the valve. */
@@ -26585,7 +27194,14 @@ var valveCapability = {
26585
27194
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
26586
27195
  * slice for live position changes during a move.
26587
27196
  */
26588
- runtimeState: ValveStatusSchema
27197
+ runtimeState: ValveStatusSchema,
27198
+ /**
27199
+ * Runtime-state durability: **session** — as `brightness`.
27200
+ *
27201
+ * See `RuntimeStateDurability`. Enforced by
27202
+ * `scripts/check-runtime-state-durability.ts`.
27203
+ */
27204
+ durability: "session"
26589
27205
  };
26590
27206
  /**
26591
27207
  * Vibration / shake / impact sensor. Drives Home Assistant
@@ -26607,7 +27223,17 @@ var vibrationCapability = {
26607
27223
  schema: VibrationStatusSchema,
26608
27224
  kind: "push"
26609
27225
  },
26610
- runtimeState: VibrationStatusSchema
27226
+ runtimeState: VibrationStatusSchema,
27227
+ /**
27228
+ * Runtime-state durability: **restored** — as `smoke`.
27229
+ *
27230
+ * See `RuntimeStateDurability`. Enforced by
27231
+ * `scripts/check-runtime-state-durability.ts`.
27232
+ */
27233
+ durability: "restored",
27234
+ /** Clock fields: written, but excluded from the compare that decides
27235
+ * whether persisting is worth a SQLite commit. */
27236
+ volatileStateFields: ["lastChangedAt"]
26611
27237
  };
26612
27238
  /**
26613
27239
  * Water heater / boiler cap. Models HA `water_heater.*` entities — a
@@ -26681,7 +27307,14 @@ var waterHeaterCapability = {
26681
27307
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
26682
27308
  * slice for live temperature / mode / away changes.
26683
27309
  */
26684
- runtimeState: WaterHeaterStatusSchema
27310
+ runtimeState: WaterHeaterStatusSchema,
27311
+ /**
27312
+ * Runtime-state durability: **session** — as `climate-control`.
27313
+ *
27314
+ * See `RuntimeStateDurability`. Enforced by
27315
+ * `scripts/check-runtime-state-durability.ts`.
27316
+ */
27317
+ durability: "session"
26685
27318
  };
26686
27319
  /**
26687
27320
  * Weather provider cap. Models HA `weather.*` entities — a read-only
@@ -26740,7 +27373,14 @@ var weatherCapability = {
26740
27373
  * Runtime-state slice — mirrored by the kernel. The UI reads the
26741
27374
  * current conditions directly from the slice on each weather push.
26742
27375
  */
26743
- runtimeState: WeatherStatusSchema
27376
+ runtimeState: WeatherStatusSchema,
27377
+ /**
27378
+ * Runtime-state durability: **session** — a forecast is stale the moment the hub is down; the provider re-fetches on connect.
27379
+ *
27380
+ * See `RuntimeStateDurability`. Enforced by
27381
+ * `scripts/check-runtime-state-durability.ts`.
27382
+ */
27383
+ durability: "session"
26744
27384
  };
26745
27385
  /**
26746
27386
  * Per-zone occupancy aggregation produced by the analytics frame
@@ -26902,7 +27542,14 @@ var zoneAnalyticsCapability = {
26902
27542
  * automatically; the explicit `getCurrentSnapshot` cap method is
26903
27543
  * still useful for one-off polls without a subscription.
26904
27544
  */
26905
- runtimeState: CameraOccupancySnapshotSchema
27545
+ runtimeState: CameraOccupancySnapshotSchema,
27546
+ /**
27547
+ * Runtime-state durability: **session** — per-frame analytics; with `audio-metrics` it is ~90 % of the offered write rate. Re-derived on the next frame.
27548
+ *
27549
+ * See `RuntimeStateDurability`. Enforced by
27550
+ * `scripts/check-runtime-state-durability.ts`.
27551
+ */
27552
+ durability: "session"
26906
27553
  };
26907
27554
  /**
26908
27555
  * Stages a {@link ZoneRule} can apply to. Discriminator on the rules
@@ -26980,7 +27627,14 @@ var zoneRulesCapability = {
26980
27627
  motion: array(ZoneRuleSchema).readonly(),
26981
27628
  detection: array(ZoneRuleSchema).readonly(),
26982
27629
  package: array(ZoneRuleSchema).readonly()
26983
- })
27630
+ }),
27631
+ /**
27632
+ * Runtime-state durability: **restored** — operator intent, mutation-only, same argument as `zones`.
27633
+ *
27634
+ * See `RuntimeStateDurability`. Enforced by
27635
+ * `scripts/check-runtime-state-durability.ts`.
27636
+ */
27637
+ durability: "restored"
26984
27638
  };
26985
27639
  /**
26986
27640
  * Accessory device helpers — shared across drivers.
@@ -33667,6 +34321,7 @@ Object.freeze({
33667
34321
  "network-access": "ingress",
33668
34322
  "smtp-provider": "email"
33669
34323
  });
34324
+ new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
33670
34325
  new Set(["devices", "classes"]);
33671
34326
  /**
33672
34327
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.