@camstack/addon-terminal 0.1.18 → 0.1.20

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.js CHANGED
@@ -10856,7 +10856,14 @@ var cameraStreamsCapability = {
10856
10856
  low: string().optional()
10857
10857
  }),
10858
10858
  lastChangedAt: number()
10859
- })
10859
+ }),
10860
+ /**
10861
+ * 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.
10862
+ *
10863
+ * See `RuntimeStateDurability`. Enforced by
10864
+ * `scripts/check-runtime-state-durability.ts`.
10865
+ */
10866
+ durability: "session"
10860
10867
  };
10861
10868
  /** Where a block runs. The operator chooses — a block driving a device on an
10862
10869
  * agent is the reason placement is not fixed to the hub. */
@@ -11417,6 +11424,13 @@ var deviceDiscoveryCapability = {
11417
11424
  kind: "poll"
11418
11425
  },
11419
11426
  runtimeState: DeviceDiscoveryStatusSchema.extend({ lastFetchedAt: number().int().nonnegative() }),
11427
+ /**
11428
+ * Runtime-state durability: **session** — 5.7 KB of scan output on the largest device, fully re-derivable by re-scanning.
11429
+ *
11430
+ * See `RuntimeStateDurability`. Enforced by
11431
+ * `scripts/check-runtime-state-durability.ts`.
11432
+ */
11433
+ durability: "session",
11420
11434
  methods: {
11421
11435
  /**
11422
11436
  * Snapshot of the current `discovered` list. Returns the
@@ -13231,11 +13245,33 @@ var NotificationFormatSchema = _enum([
13231
13245
  * Named by INTENT, never by glyph. "check" would tie the vocabulary to one
13232
13246
  * renderer's icon set; "acknowledge" survives an adapter that draws it
13233
13247
  * differently.
13248
+ *
13249
+ * ── A TOKEN IS NOT A WIRE VALUE ─────────────────────────────────────
13250
+ *
13251
+ * These names are for US. **No adapter may forward one verbatim.** Each maps
13252
+ * the whole set onto its own renderer's vocabulary through a
13253
+ * `Record<NotificationActionIcon, string>` — a Record, never a lookup with a
13254
+ * fallback, so adding a member here fails every adapter's build until someone
13255
+ * decides its glyph, which is the only place that decision can be made
13256
+ * honestly.
13257
+ *
13258
+ * This paragraph is the bug. Zentik declared `actionIcons: true` and passed
13259
+ * `disarm` straight through; iOS feeds that string to
13260
+ * `UNNotificationActionIcon(systemImageName:)`, `disarm` is not an SF Symbol,
13261
+ * and every snooze and alarm button arrived BLANK. A pass-through is not a
13262
+ * mapping, and "the field is documented" is not "the value renders".
13263
+ *
13264
+ * Adding a member is TRAIN-BOUND. The enum lives in the published
13265
+ * `@camstack/server` closure and the cap seam validates against the HUB's copy,
13266
+ * so an addon that emits a token the running hub does not know does not lose an
13267
+ * icon — its whole `send` fails Zod validation and the notification never
13268
+ * arrives. Never emit a new token from an addon before the train carrying it.
13234
13269
  */
13235
13270
  var NotificationActionIconSchema = _enum([
13236
13271
  "acknowledge",
13237
13272
  "dismiss",
13238
13273
  "silence",
13274
+ "snooze",
13239
13275
  "view",
13240
13276
  "play",
13241
13277
  "open",
@@ -13243,9 +13279,13 @@ var NotificationActionIconSchema = _enum([
13243
13279
  "lock",
13244
13280
  "unlock",
13245
13281
  "arm",
13282
+ "arm-home",
13283
+ "arm-away",
13284
+ "arm-night",
13246
13285
  "disarm",
13247
13286
  "light",
13248
- "alert"
13287
+ "alert",
13288
+ "camera"
13249
13289
  ]);
13250
13290
  /** A single tap-through action button. */
13251
13291
  var NotificationActionSchema = object({
@@ -13261,7 +13301,23 @@ var NotificationActionSchema = object({
13261
13301
  * else — see `notification-center/action-token.ts` for what that does and
13262
13302
  * does not buy.
13263
13303
  */
13264
- destructive: boolean().optional()
13304
+ destructive: boolean().optional(),
13305
+ /**
13306
+ * How the tap should REACH the url.
13307
+ *
13308
+ * `navigate` (absent, and every button authored before this field) opens it:
13309
+ * the phone leaves the notification and shows whatever the callback returns.
13310
+ * That is right for a button whose answer the operator wants to read.
13311
+ *
13312
+ * `background` fires it as a POST and stays put. It exists for the buttons
13313
+ * whose whole point is not to interrupt — "silence this for 30 minutes" is
13314
+ * an answer to the notification, and being thrown into a browser tab to
13315
+ * confirm it costs more attention than the notification did. A backend that
13316
+ * cannot do a background call renders it as an ordinary link (the adapters
13317
+ * fall back rather than dropping the button), so this is a preference, never
13318
+ * a requirement.
13319
+ */
13320
+ mode: _enum(["navigate", "background"]).optional()
13265
13321
  });
13266
13322
  /**
13267
13323
  * The canonical notification. `body` is the only hard field (Apprise model).
@@ -13429,6 +13485,24 @@ method(object({}), array(TargetKindSchema)), method(object({}), array(TargetSche
13429
13485
  targetId: string(),
13430
13486
  enabled: boolean()
13431
13487
  }), _void(), { kind: "mutation" });
13488
+ new Set([
13489
+ {
13490
+ id: "person",
13491
+ name: "Person"
13492
+ },
13493
+ {
13494
+ id: "vehicle",
13495
+ name: "Vehicle"
13496
+ },
13497
+ {
13498
+ id: "animal",
13499
+ name: "Animal"
13500
+ },
13501
+ {
13502
+ id: "package",
13503
+ name: "Package"
13504
+ }
13505
+ ].map((l) => l.id));
13432
13506
  var COCO_TO_MACRO = {
13433
13507
  mapping: {
13434
13508
  person: "person",
@@ -14113,7 +14187,17 @@ var alarmPanelCapability = {
14113
14187
  * full slice; renders an arm button per `availableModes` entry and
14114
14188
  * a PIN field iff `requiresCode === true`.
14115
14189
  */
14116
- runtimeState: AlarmPanelStatusSchema
14190
+ runtimeState: AlarmPanelStatusSchema,
14191
+ /**
14192
+ * Runtime-state durability: **restored** — armed state is the one thing a panel must not lose across a restart.
14193
+ *
14194
+ * See `RuntimeStateDurability`. Enforced by
14195
+ * `scripts/check-runtime-state-durability.ts`.
14196
+ */
14197
+ durability: "restored",
14198
+ /** Clock fields: written, but excluded from the compare that decides
14199
+ * whether persisting is worth a SQLite commit. */
14200
+ volatileStateFields: ["lastChangedAt"]
14117
14201
  };
14118
14202
  /**
14119
14203
  * Shared geometry vocabulary for on-frame shape caps — privacy-mask,
@@ -14254,6 +14338,8 @@ var NcSystemEventKindSchema = _enum([
14254
14338
  "alarm-triggered",
14255
14339
  "alarm-armed",
14256
14340
  "alarm-disarmed",
14341
+ "alarm-arming",
14342
+ "alarm-arm-refused",
14257
14343
  "camera-online",
14258
14344
  "camera-offline",
14259
14345
  "camera-disabled",
@@ -14290,6 +14376,9 @@ var NcSystemEventConditionSchema = object({
14290
14376
  nodeIds: array(string().min(1)).min(1).optional(),
14291
14377
  packageNames: array(string().min(1)).min(1).optional()
14292
14378
  });
14379
+ /** Hard ceiling on a window (24h). A snooze that could not expire would be an
14380
+ * outage the operator asked for once and forgot. */
14381
+ var NC_SNOOZE_MAX_MINUTES = 1440;
14293
14382
  /** Weekly schedule — OR of windows; absence on the rule = always active. */
14294
14383
  var NcScheduleSchema = object({
14295
14384
  windows: array(object({
@@ -14666,15 +14755,15 @@ var NcConditionsSchema = object({
14666
14755
  * (an `immediate` rule naming an `audio-*` class, one notification per
14667
14756
  * classified sample) stays exactly as it was for rules that already use it.
14668
14757
  *
14669
- * NOT in {@link NC_CONDITION_CATALOG} yet, and that is the sequencing rule
14670
- * rather than an oversight: the viewer mirrors the descriptor enums BY HAND
14671
- * (`camstack/src/data/notification-center.ts`, guarded by
14672
- * `scripts/check-viewer-condition-mirror.ts`) and its rule editor STRIPS the
14758
+ * In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
14759
+ * rule rather than an accident: the viewer mirrors the descriptor enums BY
14760
+ * HAND (`camstack/src/data/notification-center.ts`, guarded by
14761
+ * `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
14673
14762
  * condition fields it does not know when a rule is saved from the phone.
14674
14763
  * Publishing an editor for a condition the app cannot round-trip is how an
14675
- * operator loses a rule's conditions by opening it — so the descriptor, the
14676
- * admin widget and the viewer mirror land together (P2 + P3), and only then
14677
- * does an audio rule become authorable.
14764
+ * operator loses a rule's conditions by opening it — so the viewer mirror
14765
+ * (P3, shipped) went FIRST, and the descriptor an editor renders from
14766
+ * follows here.
14678
14767
  */
14679
14768
  audio: NcAudioConditionSchema.optional()
14680
14769
  });
@@ -14910,6 +14999,30 @@ var NcRuleInputSchema = object({
14910
14999
  */
14911
15000
  snoozeAllowGlobal: boolean().optional(),
14912
15001
  /**
15002
+ * The snooze durations THIS rule's notification offers as buttons, in
15003
+ * minutes.
15004
+ *
15005
+ * Three states, and all three are distinct — which is exactly why this is
15006
+ * `.optional()` and never `.default()`. A Zod default does not run on the
15007
+ * addon cap path (three production failures in one day), so a schema default
15008
+ * would collapse the first two:
15009
+ *
15010
+ * | value | meaning |
15011
+ * | --- | --- |
15012
+ * | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
15013
+ * | `[]` | **no snooze buttons on this rule** — the explicit override |
15014
+ * | a list | these choices, de-duplicated and sorted, at most four |
15015
+ *
15016
+ * `.max(4)` because the notifier's own action budget is small (ntfy allows
15017
+ * three buttons in total) and a rule that spent it all on snooze choices
15018
+ * would push its own tap-through actions off the notification.
15019
+ *
15020
+ * An empty list is NOT an alarm exemption: a rule the alarm is about, or
15021
+ * that arms the panel, is exempt automatically and cannot be silenced by a
15022
+ * window from anywhere (D133).
15023
+ */
15024
+ snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
15025
+ /**
14913
15026
  * Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
14914
15027
  *
14915
15028
  * This is what makes the rule set the alarm's trigger set without the alarm
@@ -15009,6 +15122,7 @@ var NcConditionDescriptorSchema = object({
15009
15122
  "device",
15010
15123
  "package",
15011
15124
  "occupancy",
15125
+ "audio",
15012
15126
  "system"
15013
15127
  ]),
15014
15128
  label: string(),
@@ -15027,6 +15141,7 @@ var NcConditionDescriptorSchema = object({
15027
15141
  "crossingSelect",
15028
15142
  "polygonDraw",
15029
15143
  "occupancy",
15144
+ "audio",
15030
15145
  "deviceState",
15031
15146
  "systemEvent"
15032
15147
  ]),
@@ -15178,7 +15293,20 @@ var NcSnoozeInputSchema = object({
15178
15293
  ruleId: string().optional(),
15179
15294
  /** Required when `scope: 'device'`. */
15180
15295
  deviceId: number().int().optional(),
15181
- durationMinutes: number().int().min(1).max(1440),
15296
+ /**
15297
+ * Narrow the window to these subject classes — "the cat, not the person".
15298
+ *
15299
+ * ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
15300
+ * what every window authored before this field meant, so no persisted row
15301
+ * changes meaning and no client has to learn anything to keep working.
15302
+ *
15303
+ * It is what makes the window's real key `(deviceId, classes[])` and lets it
15304
+ * cross rules (D133): the operator points at a camera and a kind of thing,
15305
+ * not at whichever of their four rules happened to produce the notification
15306
+ * they are dismissing.
15307
+ */
15308
+ classes: array(string().min(1)).min(1).optional(),
15309
+ durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
15182
15310
  /**
15183
15311
  * Silence this for EVERY recipient, not just the caller. Permission is
15184
15312
  * checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
@@ -15203,6 +15331,10 @@ var NcSnoozeSchema = object({
15203
15331
  scope: NcSnoozeScopeSchema,
15204
15332
  ruleId: string().optional(),
15205
15333
  deviceId: number().int().optional(),
15334
+ /** Subject classes this window covers. ABSENT = every class — see
15335
+ * {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
15336
+ * no SQLite column: nothing queries a window by class. */
15337
+ classes: array(string().min(1)).min(1).optional(),
15206
15338
  startedAt: number(),
15207
15339
  /** Exclusive: at exactly this instant the snooze is over. Expiry is a
15208
15340
  * COMPARISON, not a job — no sweeper can leave the operator silenced. */
@@ -17303,7 +17435,14 @@ var zonesCapability = {
17303
17435
  * handle. Slice shape is `{ zones: Zone[] }` so future extensions
17304
17436
  * (e.g. zone groupings) can sit alongside the polygon list.
17305
17437
  */
17306
- runtimeState: object({ zones: array(ZoneSchema).readonly() })
17438
+ runtimeState: object({ zones: array(ZoneSchema).readonly() }),
17439
+ /**
17440
+ * Runtime-state durability: **restored** — written only on operator mutation, so a camera that never had one has nothing to re-derive from. This is the slice `zone-mirror-hydration.ts` exists to paper over.
17441
+ *
17442
+ * See `RuntimeStateDurability`. Enforced by
17443
+ * `scripts/check-runtime-state-durability.ts`.
17444
+ */
17445
+ durability: "restored"
17307
17446
  };
17308
17447
  /**
17309
17448
  * A bounding box in NORMALIZED [0,1] frame coordinates for `getNativeCrop`. The
@@ -17473,6 +17612,22 @@ var detectionFpsField = {
17473
17612
  default: 10,
17474
17613
  step: 1
17475
17614
  };
17615
+ /**
17616
+ * The occupancy re-check interval. DEFAULT 300 s (2026-08-13 — was 30 s).
17617
+ *
17618
+ * The recheck is now on by default (a parked car is invisible to occupancy
17619
+ * rules until the stationary registry has been rebuilt by motion, which after a
17620
+ * restart may be never on a quiet camera). Each cycle re-subscribes a detection
17621
+ * session — an RTSP re-dial — so the switch is only affordable at a WIDE
17622
+ * interval: 300 s is ~12 re-dials an hour per camera, against 120 at the old
17623
+ * 30 s. A parked car is therefore counted within 5 minutes of a restart.
17624
+ *
17625
+ * Why not wider: `max` is 300 and raising it is TRAIN-BOUND, not addon-bound —
17626
+ * the host validates `attachCamera` against ITS copy of this schema, so a
17627
+ * runner asked for 600 would be rejected by the hub until a `@camstack/server`
17628
+ * carrying the wider bound is installed everywhere. 300 is the widest value
17629
+ * that ships with an addon deploy.
17630
+ */
17476
17631
  var occupancyRecheckSecField = {
17477
17632
  min: 0,
17478
17633
  max: 300,
@@ -17674,15 +17829,21 @@ var RunnerCameraConfigSchema = object({
17674
17829
  */
17675
17830
  onboardMotionDrivesAnalyzer: boolean().default(true),
17676
17831
  /**
17677
- * Master toggle for the occupancy re-check. When `false` (DEFAULT) the runner
17678
- * never arms the periodic recheck timer, regardless of `occupancyRecheckSec`
17679
- * this is off by default because the recheck re-subscribes a detection session
17680
- * every N seconds while `watching`, a major source of pull-decoder re-dial
17681
- * churn (each cycle creates+tears a session → RTSP re-dial → latency). The
17832
+ * Master toggle for the occupancy re-check. When `false` the runner never arms
17833
+ * the periodic recheck timer, regardless of `occupancyRecheckSec`; the
17682
17834
  * `occupancyRecheckSec` / `occupancyRecheckFrames` sliders only take effect
17683
17835
  * (and only render) when this is enabled.
17684
- */
17685
- occupancyRecheckEnabled: boolean().default(false),
17836
+ *
17837
+ * DEFAULT `true` since 2026-08-13 (was `false`). It was off because the
17838
+ * recheck re-subscribes a detection session every N seconds while `watching`
17839
+ * — each cycle creates+tears a session ⇒ an RTSP re-dial ⇒ latency, a major
17840
+ * pull-decoder churn source. What that bought was a blind spot: a STATIONARY
17841
+ * object is counted only while the stationary registry holds it, and the
17842
+ * registry rebuilds from motion, so after a restart a parked car was invisible
17843
+ * to every occupancy rule until something moved in front of it. The churn is
17844
+ * now paid on the interval instead — see `occupancyRecheckSecField`.
17845
+ */
17846
+ occupancyRecheckEnabled: boolean().default(true),
17686
17847
  occupancyRecheckSec: number().min(occupancyRecheckSecField.min).max(occupancyRecheckSecField.max).default(occupancyRecheckSecField.default),
17687
17848
  occupancyRecheckFrames: number().min(occupancyRecheckFramesField.min).max(occupancyRecheckFramesField.max).default(occupancyRecheckFramesField.default),
17688
17849
  /**
@@ -20240,7 +20401,17 @@ var airQualitySensorCapability = {
20240
20401
  schema: AirQualitySensorStatusSchema,
20241
20402
  kind: "push"
20242
20403
  },
20243
- runtimeState: AirQualitySensorStatusSchema
20404
+ runtimeState: AirQualitySensorStatusSchema,
20405
+ /**
20406
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
20407
+ *
20408
+ * See `RuntimeStateDurability`. Enforced by
20409
+ * `scripts/check-runtime-state-durability.ts`.
20410
+ */
20411
+ durability: "restored",
20412
+ /** Clock fields: written, but excluded from the compare that decides
20413
+ * whether persisting is worth a SQLite commit. */
20414
+ volatileStateFields: ["lastFetchedAt"]
20244
20415
  };
20245
20416
  /**
20246
20417
  * Ambient illuminance reading in lux. Drives Home Assistant `sensor`
@@ -20272,7 +20443,17 @@ var ambientLightSensorCapability = {
20272
20443
  schema: AmbientLightSensorStatusSchema,
20273
20444
  kind: "push"
20274
20445
  },
20275
- runtimeState: AmbientLightSensorStatusSchema
20446
+ runtimeState: AmbientLightSensorStatusSchema,
20447
+ /**
20448
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
20449
+ *
20450
+ * See `RuntimeStateDurability`. Enforced by
20451
+ * `scripts/check-runtime-state-durability.ts`.
20452
+ */
20453
+ durability: "restored",
20454
+ /** Clock fields: written, but excluded from the compare that decides
20455
+ * whether persisting is worth a SQLite commit. */
20456
+ volatileStateFields: ["lastFetchedAt"]
20276
20457
  };
20277
20458
  /**
20278
20459
  * Per-class audio metrics aggregated over a sliding window.
@@ -20390,7 +20571,14 @@ var audioMetricsCapability = {
20390
20571
  }), AudioMetricsHistorySchema)
20391
20572
  },
20392
20573
  /** Reactive runtime-state mirror — live `device.state.audioMetrics.value`. */
20393
- runtimeState: AudioMetricsSnapshotSchema
20574
+ runtimeState: AudioMetricsSnapshotSchema,
20575
+ /**
20576
+ * 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.
20577
+ *
20578
+ * See `RuntimeStateDurability`. Enforced by
20579
+ * `scripts/check-runtime-state-durability.ts`.
20580
+ */
20581
+ durability: "session"
20394
20582
  };
20395
20583
  /**
20396
20584
  * Automation-control cap. Models HA `automation.*` entities on
@@ -20452,7 +20640,14 @@ var automationControlCapability = {
20452
20640
  * reads `enabled` (toggle) + `isRunning` (spinner) + `lastError`
20453
20641
  * (badge) directly.
20454
20642
  */
20455
- runtimeState: AutomationControlStatusSchema
20643
+ runtimeState: AutomationControlStatusSchema,
20644
+ /**
20645
+ * 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.
20646
+ *
20647
+ * See `RuntimeStateDurability`. Enforced by
20648
+ * `scripts/check-runtime-state-durability.ts`.
20649
+ */
20650
+ durability: "session"
20456
20651
  };
20457
20652
  /**
20458
20653
  * Battery status snapshot. Emitted by providers whose device is
@@ -20558,7 +20753,17 @@ onStatusChanged: { data: object({
20558
20753
  * via `device.runtimeState.getCapState('battery')` regardless of
20559
20754
  * the underlying driver.
20560
20755
  */
20561
- runtimeState: BatteryStatusSchema
20756
+ runtimeState: BatteryStatusSchema,
20757
+ /**
20758
+ * 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.
20759
+ *
20760
+ * See `RuntimeStateDurability`. Enforced by
20761
+ * `scripts/check-runtime-state-durability.ts`.
20762
+ */
20763
+ durability: "restored",
20764
+ /** Clock fields: written, but excluded from the compare that decides
20765
+ * whether persisting is worth a SQLite commit. */
20766
+ volatileStateFields: ["lastUpdated"]
20562
20767
  };
20563
20768
  /**
20564
20769
  * Generic boolean sensor — last-resort fallback when no domain-
@@ -20587,7 +20792,17 @@ var binaryCapability = {
20587
20792
  schema: BinaryStatusSchema,
20588
20793
  kind: "push"
20589
20794
  },
20590
- runtimeState: BinaryStatusSchema
20795
+ runtimeState: BinaryStatusSchema,
20796
+ /**
20797
+ * Runtime-state durability: **restored** — transition-driven sensor state; the restored value gives the boot comparison.
20798
+ *
20799
+ * See `RuntimeStateDurability`. Enforced by
20800
+ * `scripts/check-runtime-state-durability.ts`.
20801
+ */
20802
+ durability: "restored",
20803
+ /** Clock fields: written, but excluded from the compare that decides
20804
+ * whether persisting is worth a SQLite commit. */
20805
+ volatileStateFields: ["lastChangedAt"]
20591
20806
  };
20592
20807
  /**
20593
20808
  * Dimmable-light brightness control. Co-exists with `switch` on the
@@ -20640,7 +20855,14 @@ onBrightnessChanged: { data: object({
20640
20855
  * by the kernel. Read via `device.state.brightness.value` so UI
20641
20856
  * sliders surface the current level without polling the provider.
20642
20857
  */
20643
- runtimeState: BrightnessStatusSchema
20858
+ runtimeState: BrightnessStatusSchema,
20859
+ /**
20860
+ * Runtime-state durability: **session** — live lamp state, re-published by the provider on connect.
20861
+ *
20862
+ * See `RuntimeStateDurability`. Enforced by
20863
+ * `scripts/check-runtime-state-durability.ts`.
20864
+ */
20865
+ durability: "session"
20644
20866
  };
20645
20867
  DeviceType.Button, method(object({ deviceId: number().int().nonnegative() }), _void(), {
20646
20868
  kind: "mutation",
@@ -20728,7 +20950,17 @@ var carbonMonoxideCapability = {
20728
20950
  schema: CarbonMonoxideStatusSchema,
20729
20951
  kind: "push"
20730
20952
  },
20731
- runtimeState: CarbonMonoxideStatusSchema
20953
+ runtimeState: CarbonMonoxideStatusSchema,
20954
+ /**
20955
+ * Runtime-state durability: **restored** — as `smoke`.
20956
+ *
20957
+ * See `RuntimeStateDurability`. Enforced by
20958
+ * `scripts/check-runtime-state-durability.ts`.
20959
+ */
20960
+ durability: "restored",
20961
+ /** Clock fields: written, but excluded from the compare that decides
20962
+ * whether persisting is worth a SQLite commit. */
20963
+ volatileStateFields: ["lastChangedAt"]
20732
20964
  };
20733
20965
  /**
20734
20966
  * HVAC / climate control cap. Models the full surface of a HA
@@ -20888,7 +21120,14 @@ var climateControlCapability = {
20888
21120
  * the full slice via `device.state.climate-control.value` and refresh
20889
21121
  * on every push without re-querying the provider.
20890
21122
  */
20891
- runtimeState: ClimateControlStatusSchema
21123
+ runtimeState: ClimateControlStatusSchema,
21124
+ /**
21125
+ * Runtime-state durability: **session** — as `brightness`; `currentTemp` moves continuously and is re-published on connect.
21126
+ *
21127
+ * See `RuntimeStateDurability`. Enforced by
21128
+ * `scripts/check-runtime-state-durability.ts`.
21129
+ */
21130
+ durability: "session"
20892
21131
  };
20893
21132
  /**
20894
21133
  * Color-light cap. Coexists with `switch` (on/off) and `brightness`
@@ -20998,7 +21237,14 @@ onColorChanged: { data: object({
20998
21237
  * kernel. Read via `device.state.color.value` so UI pickers surface
20999
21238
  * the current chromaticity without polling the provider.
21000
21239
  */
21001
- runtimeState: ColorStatusSchema
21240
+ runtimeState: ColorStatusSchema,
21241
+ /**
21242
+ * Runtime-state durability: **session** — as `brightness`.
21243
+ *
21244
+ * See `RuntimeStateDurability`. Enforced by
21245
+ * `scripts/check-runtime-state-durability.ts`.
21246
+ */
21247
+ durability: "session"
21002
21248
  };
21003
21249
  var ConnectionTestOutcomeSchema = discriminatedUnion("outcome", [
21004
21250
  object({
@@ -21056,7 +21302,17 @@ var connectivityCapability = {
21056
21302
  schema: ConnectivityStatusSchema,
21057
21303
  kind: "push"
21058
21304
  },
21059
- runtimeState: ConnectivityStatusSchema
21305
+ runtimeState: ConnectivityStatusSchema,
21306
+ /**
21307
+ * Runtime-state durability: **restored** — same shape and same argument as `device-status`, for links rather than devices.
21308
+ *
21309
+ * See `RuntimeStateDurability`. Enforced by
21310
+ * `scripts/check-runtime-state-durability.ts`.
21311
+ */
21312
+ durability: "restored",
21313
+ /** Clock fields: written, but excluded from the compare that decides
21314
+ * whether persisting is worth a SQLite commit. */
21315
+ volatileStateFields: ["lastChangedAt"]
21060
21316
  };
21061
21317
  /**
21062
21318
  * Generic device-consumables capability — surfaces a device's
@@ -21138,7 +21394,14 @@ reset: method(object({
21138
21394
  }
21139
21395
  }
21140
21396
  },
21141
- runtimeState: ConsumablesStatusSchema.extend({ lastFetchedAt: number() })
21397
+ runtimeState: ConsumablesStatusSchema.extend({ lastFetchedAt: number() }),
21398
+ /**
21399
+ * Runtime-state durability: **session** — the authority is the appliance; the provider re-reads the whole item array on connect.
21400
+ *
21401
+ * See `RuntimeStateDurability`. Enforced by
21402
+ * `scripts/check-runtime-state-durability.ts`.
21403
+ */
21404
+ durability: "session"
21142
21405
  };
21143
21406
  /**
21144
21407
  * Door / window / opening / garage / valve contact sensor. Boolean
@@ -21169,7 +21432,17 @@ var contactCapability = {
21169
21432
  schema: ContactStatusSchema,
21170
21433
  kind: "push"
21171
21434
  },
21172
- runtimeState: ContactStatusSchema
21435
+ runtimeState: ContactStatusSchema,
21436
+ /**
21437
+ * Runtime-state durability: **restored** — a door left open across a restart must still read open.
21438
+ *
21439
+ * See `RuntimeStateDurability`. Enforced by
21440
+ * `scripts/check-runtime-state-durability.ts`.
21441
+ */
21442
+ durability: "restored",
21443
+ /** Clock fields: written, but excluded from the compare that decides
21444
+ * whether persisting is worth a SQLite commit. */
21445
+ volatileStateFields: ["lastChangedAt"]
21173
21446
  };
21174
21447
  /**
21175
21448
  * Status slice — flat object (the framework's `runtimeState` contract
@@ -21275,7 +21548,14 @@ var controlCapability = {
21275
21548
  * dropdown / text field / date picker) read the slice's discriminant
21276
21549
  * and value directly without polling the provider.
21277
21550
  */
21278
- runtimeState: ControlStatusSchema
21551
+ runtimeState: ControlStatusSchema,
21552
+ /**
21553
+ * Runtime-state durability: **session** — a generic control mirrors an external entity that re-publishes on connect; the options array is re-derived with it.
21554
+ *
21555
+ * See `RuntimeStateDurability`. Enforced by
21556
+ * `scripts/check-runtime-state-durability.ts`.
21557
+ */
21558
+ durability: "session"
21279
21559
  };
21280
21560
  var CoverStatusSchema = object({
21281
21561
  /** Lifecycle state of the cover. */
@@ -21336,7 +21616,17 @@ var coverCapability = {
21336
21616
  * Runtime-state slice — mirrored by the kernel. UI controls watch
21337
21617
  * the slice for live position changes during a move.
21338
21618
  */
21339
- runtimeState: CoverStatusSchema
21619
+ runtimeState: CoverStatusSchema,
21620
+ /**
21621
+ * Runtime-state durability: **restored** — position survives a restart on the device; the mirror should agree at boot rather than read blank.
21622
+ *
21623
+ * See `RuntimeStateDurability`. Enforced by
21624
+ * `scripts/check-runtime-state-durability.ts`.
21625
+ */
21626
+ durability: "restored",
21627
+ /** Clock fields: written, but excluded from the compare that decides
21628
+ * whether persisting is worth a SQLite commit. */
21629
+ volatileStateFields: ["lastChangedAt"]
21340
21630
  };
21341
21631
  /**
21342
21632
  * Vendor-neutral day/night (IR-cut) control — the per-camera config cap
@@ -21430,7 +21720,17 @@ var dayNightCapability = {
21430
21720
  schema: DayNightStatusSchema,
21431
21721
  kind: "poll"
21432
21722
  },
21433
- runtimeState: DayNightStatusSchema
21723
+ runtimeState: DayNightStatusSchema,
21724
+ /**
21725
+ * Runtime-state durability: **restored** — operator-set IR-cut behaviour; mutation-driven.
21726
+ *
21727
+ * See `RuntimeStateDurability`. Enforced by
21728
+ * `scripts/check-runtime-state-durability.ts`.
21729
+ */
21730
+ durability: "restored",
21731
+ /** Clock fields: written, but excluded from the compare that decides
21732
+ * whether persisting is worth a SQLite commit. */
21733
+ volatileStateFields: ["lastFetchedAt"]
21434
21734
  };
21435
21735
  /**
21436
21736
  * Generic device-level status snapshot. Auto-registered by `BaseDevice`
@@ -21477,7 +21777,17 @@ onStatusChanged: { data: object({
21477
21777
  schema: DeviceStatusSchema,
21478
21778
  kind: "push"
21479
21779
  },
21480
- runtimeState: DeviceStatusSchema
21780
+ runtimeState: DeviceStatusSchema,
21781
+ /**
21782
+ * 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.
21783
+ *
21784
+ * See `RuntimeStateDurability`. Enforced by
21785
+ * `scripts/check-runtime-state-durability.ts`.
21786
+ */
21787
+ durability: "restored",
21788
+ /** Clock fields: written, but excluded from the compare that decides
21789
+ * whether persisting is worth a SQLite commit. */
21790
+ volatileStateFields: ["lastChangedAt"]
21481
21791
  };
21482
21792
  /**
21483
21793
  * Doorbell button cap. Two kinds of providers coexist behind this cap
@@ -21539,7 +21849,14 @@ onPressed: { data: DoorbellPressEventSchema } },
21539
21849
  * `device.state.doorbell.value`. UIs can show "last ring 5m ago"
21540
21850
  * without subscribing.
21541
21851
  */
21542
- runtimeState: DoorbellStatusSchema
21852
+ runtimeState: DoorbellStatusSchema,
21853
+ /**
21854
+ * 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.
21855
+ *
21856
+ * See `RuntimeStateDurability`. Enforced by
21857
+ * `scripts/check-runtime-state-durability.ts`.
21858
+ */
21859
+ durability: "restored"
21543
21860
  };
21544
21861
  /**
21545
21862
  * Enum-state sensor — a string value picked from a finite option set.
@@ -21579,7 +21896,17 @@ var enumSensorCapability = {
21579
21896
  schema: EnumSensorStatusSchema,
21580
21897
  kind: "push"
21581
21898
  },
21582
- runtimeState: EnumSensorStatusSchema
21899
+ runtimeState: EnumSensorStatusSchema,
21900
+ /**
21901
+ * Runtime-state durability: **restored** — as `numeric-sensor`; 80 devices.
21902
+ *
21903
+ * See `RuntimeStateDurability`. Enforced by
21904
+ * `scripts/check-runtime-state-durability.ts`.
21905
+ */
21906
+ durability: "restored",
21907
+ /** Clock fields: written, but excluded from the compare that decides
21908
+ * whether persisting is worth a SQLite commit. */
21909
+ volatileStateFields: ["lastFetchedAt"]
21583
21910
  };
21584
21911
  /**
21585
21912
  * Generic stateless event emitter. Installed on a `DeviceType.EventEmitter`
@@ -21615,7 +21942,14 @@ var eventEmitterCapability = {
21615
21942
  schema: EventEmitterStatusSchema,
21616
21943
  kind: "push"
21617
21944
  },
21618
- runtimeState: EventEmitterStatusSchema
21945
+ runtimeState: EventEmitterStatusSchema,
21946
+ /**
21947
+ * Runtime-state durability: **session** — `eventCountSinceStart` names its own scope.
21948
+ *
21949
+ * See `RuntimeStateDurability`. Enforced by
21950
+ * `scripts/check-runtime-state-durability.ts`.
21951
+ */
21952
+ durability: "session"
21619
21953
  };
21620
21954
  var EventItemSchema = object({
21621
21955
  id: string(),
@@ -21896,7 +22230,14 @@ var fanControlCapability = {
21896
22230
  * Runtime-state slice — mirrored by the kernel. UI fan speed
21897
22231
  * sliders read `percentage` for live updates.
21898
22232
  */
21899
- runtimeState: FanControlStatusSchema
22233
+ runtimeState: FanControlStatusSchema,
22234
+ /**
22235
+ * Runtime-state durability: **session** — as `brightness`.
22236
+ *
22237
+ * See `RuntimeStateDurability`. Enforced by
22238
+ * `scripts/check-runtime-state-durability.ts`.
22239
+ */
22240
+ durability: "session"
21900
22241
  };
21901
22242
  /**
21902
22243
  * Per-device feature/identity probe slice. Holds the runtime-resolved
@@ -21972,7 +22313,14 @@ onProbeChanged: { data: object({
21972
22313
  schema: FeatureProbeStatusSchema,
21973
22314
  kind: "push"
21974
22315
  },
21975
- runtimeState: FeatureProbeStatusSchema
22316
+ runtimeState: FeatureProbeStatusSchema,
22317
+ /**
22318
+ * 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.
22319
+ *
22320
+ * See `RuntimeStateDurability`. Enforced by
22321
+ * `scripts/check-runtime-state-durability.ts`.
22322
+ */
22323
+ durability: "session"
21976
22324
  };
21977
22325
  /**
21978
22326
  * Water leak / moisture sensor. Boolean "is liquid currently
@@ -21999,7 +22347,17 @@ var floodCapability = {
21999
22347
  schema: FloodStatusSchema,
22000
22348
  kind: "push"
22001
22349
  },
22002
- runtimeState: FloodStatusSchema
22350
+ runtimeState: FloodStatusSchema,
22351
+ /**
22352
+ * Runtime-state durability: **restored** — as `smoke`.
22353
+ *
22354
+ * See `RuntimeStateDurability`. Enforced by
22355
+ * `scripts/check-runtime-state-durability.ts`.
22356
+ */
22357
+ durability: "restored",
22358
+ /** Clock fields: written, but excluded from the compare that decides
22359
+ * whether persisting is worth a SQLite commit. */
22360
+ volatileStateFields: ["lastChangedAt"]
22003
22361
  };
22004
22362
  /**
22005
22363
  * Combustible-gas (LPG / methane / hydrogen) alarm sensor. Drives
@@ -22022,7 +22380,17 @@ var gasCapability = {
22022
22380
  schema: GasStatusSchema,
22023
22381
  kind: "push"
22024
22382
  },
22025
- runtimeState: GasStatusSchema
22383
+ runtimeState: GasStatusSchema,
22384
+ /**
22385
+ * Runtime-state durability: **restored** — as `smoke`.
22386
+ *
22387
+ * See `RuntimeStateDurability`. Enforced by
22388
+ * `scripts/check-runtime-state-durability.ts`.
22389
+ */
22390
+ durability: "restored",
22391
+ /** Clock fields: written, but excluded from the compare that decides
22392
+ * whether persisting is worth a SQLite commit. */
22393
+ volatileStateFields: ["lastChangedAt"]
22026
22394
  };
22027
22395
  /**
22028
22396
  * Humidifier / dehumidifier cap. Models HA `humidifier.*` entities —
@@ -22098,7 +22466,14 @@ var humidifierCapability = {
22098
22466
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
22099
22467
  * slice for live humidity / mode changes.
22100
22468
  */
22101
- runtimeState: HumidifierStatusSchema
22469
+ runtimeState: HumidifierStatusSchema,
22470
+ /**
22471
+ * Runtime-state durability: **session** — as `climate-control`.
22472
+ *
22473
+ * See `RuntimeStateDurability`. Enforced by
22474
+ * `scripts/check-runtime-state-durability.ts`.
22475
+ */
22476
+ durability: "session"
22102
22477
  };
22103
22478
  /**
22104
22479
  * Single-metric humidity reading. Drives Home Assistant `sensor`
@@ -22134,7 +22509,17 @@ var humiditySensorCapability = {
22134
22509
  schema: HumiditySensorStatusSchema,
22135
22510
  kind: "push"
22136
22511
  },
22137
- runtimeState: HumiditySensorStatusSchema
22512
+ runtimeState: HumiditySensorStatusSchema,
22513
+ /**
22514
+ * Runtime-state durability: **restored** — as `numeric-sensor` (67 of 75 writes were the clock alone).
22515
+ *
22516
+ * See `RuntimeStateDurability`. Enforced by
22517
+ * `scripts/check-runtime-state-durability.ts`.
22518
+ */
22519
+ durability: "restored",
22520
+ /** Clock fields: written, but excluded from the compare that decides
22521
+ * whether persisting is worth a SQLite commit. */
22522
+ volatileStateFields: ["lastFetchedAt"]
22138
22523
  };
22139
22524
  /**
22140
22525
  * Image display cap. Models a single still image exposed by an integration —
@@ -22172,7 +22557,14 @@ var imageCapability = {
22172
22557
  * Runtime-state slice — mirrored by the kernel. The UI reads `url`
22173
22558
  * directly and renders the still image.
22174
22559
  */
22175
- runtimeState: ImageStatusSchema
22560
+ runtimeState: ImageStatusSchema,
22561
+ /**
22562
+ * Runtime-state durability: **session** — a snapshot URL is a session-scoped handle; a restored one points at nothing.
22563
+ *
22564
+ * See `RuntimeStateDurability`. Enforced by
22565
+ * `scripts/check-runtime-state-durability.ts`.
22566
+ */
22567
+ durability: "session"
22176
22568
  };
22177
22569
  /**
22178
22570
  * Vendor-neutral image / picture-adjustment cap — the per-camera config
@@ -22321,7 +22713,17 @@ var imageSettingsCapability = {
22321
22713
  schema: ImageSettingsStatusSchema,
22322
22714
  kind: "poll"
22323
22715
  },
22324
- runtimeState: ImageSettingsStatusSchema
22716
+ runtimeState: ImageSettingsStatusSchema,
22717
+ /**
22718
+ * Runtime-state durability: **restored** — operator-set camera imaging; mutation-driven.
22719
+ *
22720
+ * See `RuntimeStateDurability`. Enforced by
22721
+ * `scripts/check-runtime-state-durability.ts`.
22722
+ */
22723
+ durability: "restored",
22724
+ /** Clock fields: written, but excluded from the compare that decides
22725
+ * whether persisting is worth a SQLite commit. */
22726
+ volatileStateFields: ["lastFetchedAt"]
22325
22727
  };
22326
22728
  /**
22327
22729
  * integrations — system-scoped singleton capability for integration
@@ -22661,7 +23063,14 @@ var lawnMowerControlCapability = {
22661
23063
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
22662
23064
  * slice for live activity + battery changes.
22663
23065
  */
22664
- runtimeState: LawnMowerControlStatusSchema
23066
+ runtimeState: LawnMowerControlStatusSchema,
23067
+ /**
23068
+ * Runtime-state durability: **session** — as `vacuum-control`.
23069
+ *
23070
+ * See `RuntimeStateDurability`. Enforced by
23071
+ * `scripts/check-runtime-state-durability.ts`.
23072
+ */
23073
+ durability: "session"
22665
23074
  };
22666
23075
  /**
22667
23076
  * local-network — hub-only singleton.
@@ -22867,7 +23276,17 @@ var lockControlCapability = {
22867
23276
  * read `state` and disable themselves during `locking`/`unlocking`
22868
23277
  * transitions.
22869
23278
  */
22870
- runtimeState: LockControlStatusSchema
23279
+ runtimeState: LockControlStatusSchema,
23280
+ /**
23281
+ * Runtime-state durability: **restored** — a lock left locked must still read locked.
23282
+ *
23283
+ * See `RuntimeStateDurability`. Enforced by
23284
+ * `scripts/check-runtime-state-durability.ts`.
23285
+ */
23286
+ durability: "restored",
23287
+ /** Clock fields: written, but excluded from the compare that decides
23288
+ * whether persisting is worth a SQLite commit. */
23289
+ volatileStateFields: ["lastChangedAt"]
22871
23290
  };
22872
23291
  /**
22873
23292
  * Media-player cap. Models HA `media_player.*` (Sonos, Chromecast,
@@ -23029,7 +23448,14 @@ var mediaPlayerCapability = {
23029
23448
  * full slice for live now-playing, volume, and progress updates
23030
23449
  * without polling.
23031
23450
  */
23032
- runtimeState: MediaPlayerStatusSchema
23451
+ runtimeState: MediaPlayerStatusSchema,
23452
+ /**
23453
+ * Runtime-state durability: **session** — a restored transport position describes a playback that stopped when the hub did.
23454
+ *
23455
+ * See `RuntimeStateDurability`. Enforced by
23456
+ * `scripts/check-runtime-state-durability.ts`.
23457
+ */
23458
+ durability: "session"
23033
23459
  };
23034
23460
  /**
23035
23461
  * mesh-network — collection cap for mesh-VPN providers.
@@ -23293,7 +23719,14 @@ onMotionChanged: { data: MotionOnMotionChangedDataSchema } },
23293
23719
  * `device.state.motion.value`. Reads never invoke the provider, so
23294
23720
  * UIs and other addons can poll the cached state safely.
23295
23721
  */
23296
- runtimeState: MotionStatusSchema
23722
+ runtimeState: MotionStatusSchema,
23723
+ /**
23724
+ * 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.
23725
+ *
23726
+ * See `RuntimeStateDurability`. Enforced by
23727
+ * `scripts/check-runtime-state-durability.ts`.
23728
+ */
23729
+ durability: "session"
23297
23730
  };
23298
23731
  /**
23299
23732
  * Motion-trigger toggle for accessory devices.
@@ -23358,7 +23791,14 @@ var motionTriggerCapability = {
23358
23791
  schema: MotionTriggerStatusSchema,
23359
23792
  kind: "command-driven"
23360
23793
  },
23361
- runtimeState: MotionTriggerRuntimeStateSchema
23794
+ runtimeState: MotionTriggerRuntimeStateSchema,
23795
+ /**
23796
+ * 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.
23797
+ *
23798
+ * See `RuntimeStateDurability`. Enforced by
23799
+ * `scripts/check-runtime-state-durability.ts`.
23800
+ */
23801
+ durability: "session"
23362
23802
  };
23363
23803
  /**
23364
23804
  * Motion-zones share the same MaskShape vocabulary as privacy-mask — the
@@ -23425,7 +23865,17 @@ var motionZonesCapability = {
23425
23865
  schema: MotionZoneStatusSchema,
23426
23866
  kind: "poll"
23427
23867
  },
23428
- runtimeState: MotionZoneStatusSchema
23868
+ runtimeState: MotionZoneStatusSchema,
23869
+ /**
23870
+ * 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.
23871
+ *
23872
+ * See `RuntimeStateDurability`. Enforced by
23873
+ * `scripts/check-runtime-state-durability.ts`.
23874
+ */
23875
+ durability: "restored",
23876
+ /** Clock fields: written, but excluded from the compare that decides
23877
+ * whether persisting is worth a SQLite commit. */
23878
+ volatileStateFields: ["lastFetchedAt"]
23429
23879
  };
23430
23880
  /**
23431
23881
  * On-camera AI object detection cap. Surfaces per-device the classes
@@ -23499,7 +23949,17 @@ var nativeObjectDetectionCapability = {
23499
23949
  schema: NativeObjectDetectionStatusSchema,
23500
23950
  kind: "push"
23501
23951
  },
23502
- runtimeState: NativeObjectDetectionRuntimeStateSchema
23952
+ runtimeState: NativeObjectDetectionRuntimeStateSchema,
23953
+ /**
23954
+ * 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.
23955
+ *
23956
+ * See `RuntimeStateDurability`. Enforced by
23957
+ * `scripts/check-runtime-state-durability.ts`.
23958
+ */
23959
+ durability: "restored",
23960
+ /** Clock fields: written, but excluded from the compare that decides
23961
+ * whether persisting is worth a SQLite commit. */
23962
+ volatileStateFields: ["lastFetchedAt"]
23503
23963
  };
23504
23964
  /**
23505
23965
  * network-quality — system-scoped singleton capability tracking RTT,
@@ -23833,7 +24293,14 @@ onSent: { data: object({
23833
24293
  * form reads `supports` to gate optional fields; history pane reads
23834
24294
  * `lastSentAt` / `lastError` / `queueDepth`.
23835
24295
  */
23836
- runtimeState: NotifierStatusSchema
24296
+ runtimeState: NotifierStatusSchema,
24297
+ /**
24298
+ * Runtime-state durability: **session** — live queue depth and last-send state; a restored queue depth describes a queue that no longer exists.
24299
+ *
24300
+ * See `RuntimeStateDurability`. Enforced by
24301
+ * `scripts/check-runtime-state-durability.ts`.
24302
+ */
24303
+ durability: "session"
23837
24304
  };
23838
24305
  /**
23839
24306
  * Generic numeric sensor — last-resort fallback when no typed numeric
@@ -23876,7 +24343,17 @@ var numericSensorCapability = {
23876
24343
  schema: NumericSensorStatusSchema,
23877
24344
  kind: "push"
23878
24345
  },
23879
- runtimeState: NumericSensorStatusSchema
24346
+ runtimeState: NumericSensorStatusSchema,
24347
+ /**
24348
+ * 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.
24349
+ *
24350
+ * See `RuntimeStateDurability`. Enforced by
24351
+ * `scripts/check-runtime-state-durability.ts`.
24352
+ */
24353
+ durability: "restored",
24354
+ /** Clock fields: written, but excluded from the compare that decides
24355
+ * whether persisting is worth a SQLite commit. */
24356
+ volatileStateFields: ["lastFetchedAt"]
23880
24357
  };
23881
24358
  /**
23882
24359
  * Generic on-screen-display (video overlay) cap. Each camera exposes
@@ -24261,7 +24738,14 @@ var petFeederCapability = {
24261
24738
  * the full slice via `device.state.petFeeder.value` and refresh on
24262
24739
  * every poll without re-querying the provider.
24263
24740
  */
24264
- runtimeState: PetFeederStatusSchema
24741
+ runtimeState: PetFeederStatusSchema,
24742
+ /**
24743
+ * Runtime-state durability: **session** — live appliance state re-published on connect.
24744
+ *
24745
+ * See `RuntimeStateDurability`. Enforced by
24746
+ * `scripts/check-runtime-state-durability.ts`.
24747
+ */
24748
+ durability: "session"
24265
24749
  };
24266
24750
  var VehicleSchema = object({
24267
24751
  id: string(),
@@ -24573,7 +25057,17 @@ var powerMeterCapability = {
24573
25057
  schema: PowerMeterStatusSchema,
24574
25058
  kind: "push"
24575
25059
  },
24576
- runtimeState: PowerMeterStatusSchema
25060
+ runtimeState: PowerMeterStatusSchema,
25061
+ /**
25062
+ * Runtime-state durability: **restored** — as `numeric-sensor`; `kwhTotal` is an accumulator whose restored value is the baseline.
25063
+ *
25064
+ * See `RuntimeStateDurability`. Enforced by
25065
+ * `scripts/check-runtime-state-durability.ts`.
25066
+ */
25067
+ durability: "restored",
25068
+ /** Clock fields: written, but excluded from the compare that decides
25069
+ * whether persisting is worth a SQLite commit. */
25070
+ volatileStateFields: ["lastFetchedAt"]
24577
25071
  };
24578
25072
  /**
24579
25073
  * Presence cap. Models HA `person.*` and `device_tracker.*` entities
@@ -24630,7 +25124,17 @@ var presenceCapability = {
24630
25124
  * the map pin is rendered (use `DeviceFeature.PresenceGps` for the
24631
25125
  * pre-fetch fast-path check).
24632
25126
  */
24633
- runtimeState: PresenceStatusSchema
25127
+ runtimeState: PresenceStatusSchema,
25128
+ /**
25129
+ * Runtime-state durability: **restored** — occupancy-relevant: the restored state is what an occupancy rule compares the first post-restart observation against.
25130
+ *
25131
+ * See `RuntimeStateDurability`. Enforced by
25132
+ * `scripts/check-runtime-state-durability.ts`.
25133
+ */
25134
+ durability: "restored",
25135
+ /** Clock fields: written, but excluded from the compare that decides
25136
+ * whether persisting is worth a SQLite commit. */
25137
+ volatileStateFields: ["lastChangedAt"]
24634
25138
  };
24635
25139
  /**
24636
25140
  * Atmospheric pressure reading in hectopascals. Drives Home Assistant
@@ -24666,7 +25170,17 @@ var pressureSensorCapability = {
24666
25170
  schema: PressureSensorStatusSchema,
24667
25171
  kind: "push"
24668
25172
  },
24669
- runtimeState: PressureSensorStatusSchema
25173
+ runtimeState: PressureSensorStatusSchema,
25174
+ /**
25175
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
25176
+ *
25177
+ * See `RuntimeStateDurability`. Enforced by
25178
+ * `scripts/check-runtime-state-durability.ts`.
25179
+ */
25180
+ durability: "restored",
25181
+ /** Clock fields: written, but excluded from the compare that decides
25182
+ * whether persisting is worth a SQLite commit. */
25183
+ volatileStateFields: ["lastFetchedAt"]
24670
25184
  };
24671
25185
  /**
24672
25186
  * PRIVACY — what the camera deliberately does not capture. Two planes:
@@ -24796,7 +25310,17 @@ var privacyMaskCapability = {
24796
25310
  schema: PrivacyMaskStatusSchema,
24797
25311
  kind: "poll"
24798
25312
  },
24799
- runtimeState: PrivacyMaskStatusSchema
25313
+ runtimeState: PrivacyMaskStatusSchema,
25314
+ /**
25315
+ * Runtime-state durability: **restored** — operator-drawn regions, zero real churn — 22 writes in 25 minutes, every one of them the clock.
25316
+ *
25317
+ * See `RuntimeStateDurability`. Enforced by
25318
+ * `scripts/check-runtime-state-durability.ts`.
25319
+ */
25320
+ durability: "restored",
25321
+ /** Clock fields: written, but excluded from the compare that decides
25322
+ * whether persisting is worth a SQLite commit. */
25323
+ volatileStateFields: ["lastFetchedAt"]
24800
25324
  };
24801
25325
  var PtzPresetSchema = object({
24802
25326
  id: string(),
@@ -24962,7 +25486,14 @@ var ptzAutotrackCapability = {
24962
25486
  * fetch / cache / fallback logic out of the four cap methods —
24963
25487
  * they become trampolines over `runtimeState`.
24964
25488
  */
24965
- runtimeState: PtzAutotrackRuntimeStateSchema
25489
+ runtimeState: PtzAutotrackRuntimeStateSchema,
25490
+ /**
25491
+ * Runtime-state durability: **session** — mirrors the camera's own autotrack config, re-read on connect.
25492
+ *
25493
+ * See `RuntimeStateDurability`. Enforced by
25494
+ * `scripts/check-runtime-state-durability.ts`.
25495
+ */
25496
+ durability: "session"
24966
25497
  };
24967
25498
  DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceId: number().int().nonnegative() }), object({ success: literal(true) }), {
24968
25499
  kind: "mutation",
@@ -25612,7 +26143,14 @@ var sceneMonitorCapability = {
25612
26143
  schema: SceneMonitorStatusSchema,
25613
26144
  kind: "push"
25614
26145
  },
25615
- runtimeState: SceneMonitorStatusSchema
26146
+ runtimeState: SceneMonitorStatusSchema,
26147
+ /**
26148
+ * Runtime-state durability: **session** — re-derived from the current scene on the next evaluation.
26149
+ *
26150
+ * See `RuntimeStateDurability`. Enforced by
26151
+ * `scripts/check-runtime-state-durability.ts`.
26152
+ */
26153
+ durability: "session"
25616
26154
  };
25617
26155
  /**
25618
26156
  * Per-stage gating mode applied to the zones a rule references.
@@ -25756,7 +26294,14 @@ var scriptRunnerCapability = {
25756
26294
  * `isRunning` to render a spinner during execution and surfaces
25757
26295
  * `lastError` / `lastRunSuccess` in the recent-runs panel.
25758
26296
  */
25759
- runtimeState: ScriptRunnerStatusSchema
26297
+ runtimeState: ScriptRunnerStatusSchema,
26298
+ /**
26299
+ * Runtime-state durability: **session** — a restored `isRunning: true` describes a process that died with the previous hub.
26300
+ *
26301
+ * See `RuntimeStateDurability`. Enforced by
26302
+ * `scripts/check-runtime-state-durability.ts`.
26303
+ */
26304
+ durability: "session"
25760
26305
  };
25761
26306
  /**
25762
26307
  * Smoke alarm sensor — boolean "is smoke currently detected" with
@@ -25783,7 +26328,17 @@ var smokeCapability = {
25783
26328
  schema: SmokeStatusSchema,
25784
26329
  kind: "push"
25785
26330
  },
25786
- runtimeState: SmokeStatusSchema
26331
+ runtimeState: SmokeStatusSchema,
26332
+ /**
26333
+ * Runtime-state durability: **restored** — a safety sensor must not read "clear" merely because the hub restarted.
26334
+ *
26335
+ * See `RuntimeStateDurability`. Enforced by
26336
+ * `scripts/check-runtime-state-durability.ts`.
26337
+ */
26338
+ durability: "restored",
26339
+ /** Clock fields: written, but excluded from the compare that decides
26340
+ * whether persisting is worth a SQLite commit. */
26341
+ volatileStateFields: ["lastChangedAt"]
25787
26342
  };
25788
26343
  /**
25789
26344
  * One publishable camera stream as its OWNING PROVIDER describes it — the same
@@ -25969,7 +26524,17 @@ var streamParamsCapability = {
25969
26524
  schema: StreamParamsStatusSchema,
25970
26525
  kind: "poll"
25971
26526
  },
25972
- runtimeState: StreamParamsStatusSchema
26527
+ runtimeState: StreamParamsStatusSchema,
26528
+ /**
26529
+ * Runtime-state durability: **restored** — operator-set encoder profile; mutation-driven.
26530
+ *
26531
+ * See `RuntimeStateDurability`. Enforced by
26532
+ * `scripts/check-runtime-state-durability.ts`.
26533
+ */
26534
+ durability: "restored",
26535
+ /** Clock fields: written, but excluded from the compare that decides
26536
+ * whether persisting is worth a SQLite commit. */
26537
+ volatileStateFields: ["lastFetchedAt"]
25973
26538
  };
25974
26539
  /**
25975
26540
  * Generic on/off switch cap for accessory children (siren, floodlight,
@@ -26015,6 +26580,16 @@ var switchCapability = {
26015
26580
  * not need to re-query the provider after a setState mutation.
26016
26581
  */
26017
26582
  runtimeState: SwitchStatusSchema,
26583
+ /**
26584
+ * Runtime-state durability: **restored** — device state an operator reads as authoritative; 55 devices, transition-driven.
26585
+ *
26586
+ * See `RuntimeStateDurability`. Enforced by
26587
+ * `scripts/check-runtime-state-durability.ts`.
26588
+ */
26589
+ durability: "restored",
26590
+ /** Clock fields: written, but excluded from the compare that decides
26591
+ * whether persisting is worth a SQLite commit. */
26592
+ volatileStateFields: ["lastChangedAt"],
26018
26593
  settings: { bindings: [{
26019
26594
  kind: "scalar",
26020
26595
  statusPath: "on",
@@ -26094,7 +26669,17 @@ var tamperCapability = {
26094
26669
  schema: TamperStatusSchema,
26095
26670
  kind: "push"
26096
26671
  },
26097
- runtimeState: TamperStatusSchema
26672
+ runtimeState: TamperStatusSchema,
26673
+ /**
26674
+ * Runtime-state durability: **restored** — as `smoke`.
26675
+ *
26676
+ * See `RuntimeStateDurability`. Enforced by
26677
+ * `scripts/check-runtime-state-durability.ts`.
26678
+ */
26679
+ durability: "restored",
26680
+ /** Clock fields: written, but excluded from the compare that decides
26681
+ * whether persisting is worth a SQLite commit. */
26682
+ volatileStateFields: ["lastChangedAt"]
26098
26683
  };
26099
26684
  /**
26100
26685
  * Single-metric temperature reading. Drives Home Assistant `sensor`
@@ -26139,7 +26724,17 @@ var temperatureSensorCapability = {
26139
26724
  schema: TemperatureSensorStatusSchema,
26140
26725
  kind: "push"
26141
26726
  },
26142
- runtimeState: TemperatureSensorStatusSchema
26727
+ runtimeState: TemperatureSensorStatusSchema,
26728
+ /**
26729
+ * Runtime-state durability: **restored** — as `numeric-sensor` (69 of 125 writes were the clock alone).
26730
+ *
26731
+ * See `RuntimeStateDurability`. Enforced by
26732
+ * `scripts/check-runtime-state-durability.ts`.
26733
+ */
26734
+ durability: "restored",
26735
+ /** Clock fields: written, but excluded from the compare that decides
26736
+ * whether persisting is worth a SQLite commit. */
26737
+ volatileStateFields: ["lastFetchedAt"]
26143
26738
  };
26144
26739
  /**
26145
26740
  * toast — system-scoped singleton capability that streams toast
@@ -26208,7 +26803,14 @@ var updateCapability = {
26208
26803
  schema: UpdateStatusSchema,
26209
26804
  kind: "poll"
26210
26805
  },
26211
- runtimeState: UpdateStatusSchema
26806
+ runtimeState: UpdateStatusSchema,
26807
+ /**
26808
+ * Runtime-state durability: **session** — a restored `inProgress: true` describes an update that is no longer running; versions are re-probed at boot.
26809
+ *
26810
+ * See `RuntimeStateDurability`. Enforced by
26811
+ * `scripts/check-runtime-state-durability.ts`.
26812
+ */
26813
+ durability: "session"
26212
26814
  };
26213
26815
  var UserSummarySchema = object({
26214
26816
  id: string(),
@@ -26542,7 +27144,14 @@ var vacuumControlCapability = {
26542
27144
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
26543
27145
  * slice for live state + battery + fan-speed changes.
26544
27146
  */
26545
- runtimeState: VacuumControlStatusSchema
27147
+ runtimeState: VacuumControlStatusSchema,
27148
+ /**
27149
+ * Runtime-state durability: **session** — as `media-player` — a restored `state: cleaning` is a robot that is not cleaning.
27150
+ *
27151
+ * See `RuntimeStateDurability`. Enforced by
27152
+ * `scripts/check-runtime-state-durability.ts`.
27153
+ */
27154
+ durability: "session"
26546
27155
  };
26547
27156
  var ValveStatusSchema = object({
26548
27157
  /** Lifecycle state of the valve. */
@@ -26594,7 +27203,14 @@ var valveCapability = {
26594
27203
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
26595
27204
  * slice for live position changes during a move.
26596
27205
  */
26597
- runtimeState: ValveStatusSchema
27206
+ runtimeState: ValveStatusSchema,
27207
+ /**
27208
+ * Runtime-state durability: **session** — as `brightness`.
27209
+ *
27210
+ * See `RuntimeStateDurability`. Enforced by
27211
+ * `scripts/check-runtime-state-durability.ts`.
27212
+ */
27213
+ durability: "session"
26598
27214
  };
26599
27215
  /**
26600
27216
  * Vibration / shake / impact sensor. Drives Home Assistant
@@ -26616,7 +27232,17 @@ var vibrationCapability = {
26616
27232
  schema: VibrationStatusSchema,
26617
27233
  kind: "push"
26618
27234
  },
26619
- runtimeState: VibrationStatusSchema
27235
+ runtimeState: VibrationStatusSchema,
27236
+ /**
27237
+ * Runtime-state durability: **restored** — as `smoke`.
27238
+ *
27239
+ * See `RuntimeStateDurability`. Enforced by
27240
+ * `scripts/check-runtime-state-durability.ts`.
27241
+ */
27242
+ durability: "restored",
27243
+ /** Clock fields: written, but excluded from the compare that decides
27244
+ * whether persisting is worth a SQLite commit. */
27245
+ volatileStateFields: ["lastChangedAt"]
26620
27246
  };
26621
27247
  /**
26622
27248
  * Water heater / boiler cap. Models HA `water_heater.*` entities — a
@@ -26690,7 +27316,14 @@ var waterHeaterCapability = {
26690
27316
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
26691
27317
  * slice for live temperature / mode / away changes.
26692
27318
  */
26693
- runtimeState: WaterHeaterStatusSchema
27319
+ runtimeState: WaterHeaterStatusSchema,
27320
+ /**
27321
+ * Runtime-state durability: **session** — as `climate-control`.
27322
+ *
27323
+ * See `RuntimeStateDurability`. Enforced by
27324
+ * `scripts/check-runtime-state-durability.ts`.
27325
+ */
27326
+ durability: "session"
26694
27327
  };
26695
27328
  /**
26696
27329
  * Weather provider cap. Models HA `weather.*` entities — a read-only
@@ -26749,7 +27382,14 @@ var weatherCapability = {
26749
27382
  * Runtime-state slice — mirrored by the kernel. The UI reads the
26750
27383
  * current conditions directly from the slice on each weather push.
26751
27384
  */
26752
- runtimeState: WeatherStatusSchema
27385
+ runtimeState: WeatherStatusSchema,
27386
+ /**
27387
+ * Runtime-state durability: **session** — a forecast is stale the moment the hub is down; the provider re-fetches on connect.
27388
+ *
27389
+ * See `RuntimeStateDurability`. Enforced by
27390
+ * `scripts/check-runtime-state-durability.ts`.
27391
+ */
27392
+ durability: "session"
26753
27393
  };
26754
27394
  /**
26755
27395
  * Per-zone occupancy aggregation produced by the analytics frame
@@ -26911,7 +27551,14 @@ var zoneAnalyticsCapability = {
26911
27551
  * automatically; the explicit `getCurrentSnapshot` cap method is
26912
27552
  * still useful for one-off polls without a subscription.
26913
27553
  */
26914
- runtimeState: CameraOccupancySnapshotSchema
27554
+ runtimeState: CameraOccupancySnapshotSchema,
27555
+ /**
27556
+ * Runtime-state durability: **session** — per-frame analytics; with `audio-metrics` it is ~90 % of the offered write rate. Re-derived on the next frame.
27557
+ *
27558
+ * See `RuntimeStateDurability`. Enforced by
27559
+ * `scripts/check-runtime-state-durability.ts`.
27560
+ */
27561
+ durability: "session"
26915
27562
  };
26916
27563
  /**
26917
27564
  * Stages a {@link ZoneRule} can apply to. Discriminator on the rules
@@ -26989,7 +27636,14 @@ var zoneRulesCapability = {
26989
27636
  motion: array(ZoneRuleSchema).readonly(),
26990
27637
  detection: array(ZoneRuleSchema).readonly(),
26991
27638
  package: array(ZoneRuleSchema).readonly()
26992
- })
27639
+ }),
27640
+ /**
27641
+ * Runtime-state durability: **restored** — operator intent, mutation-only, same argument as `zones`.
27642
+ *
27643
+ * See `RuntimeStateDurability`. Enforced by
27644
+ * `scripts/check-runtime-state-durability.ts`.
27645
+ */
27646
+ durability: "restored"
26993
27647
  };
26994
27648
  /**
26995
27649
  * Accessory device helpers — shared across drivers.
@@ -33675,6 +34329,7 @@ Object.freeze({
33675
34329
  "network-access": "ingress",
33676
34330
  "smtp-provider": "email"
33677
34331
  });
34332
+ new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
33678
34333
  new Set(["devices", "classes"]);
33679
34334
  /**
33680
34335
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.