@camstack/addon-terminal 0.1.18 → 0.1.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/dist/addon.js +656 -69
  2. package/dist/addon.mjs +656 -69
  3. package/package.json +1 -1
package/dist/addon.mjs CHANGED
@@ -10833,7 +10833,14 @@ var cameraStreamsCapability = {
10833
10833
  low: string().optional()
10834
10834
  }),
10835
10835
  lastChangedAt: number()
10836
- })
10836
+ }),
10837
+ /**
10838
+ * 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.
10839
+ *
10840
+ * See `RuntimeStateDurability`. Enforced by
10841
+ * `scripts/check-runtime-state-durability.ts`.
10842
+ */
10843
+ durability: "session"
10837
10844
  };
10838
10845
  /** Where a block runs. The operator chooses — a block driving a device on an
10839
10846
  * agent is the reason placement is not fixed to the hub. */
@@ -11394,6 +11401,13 @@ var deviceDiscoveryCapability = {
11394
11401
  kind: "poll"
11395
11402
  },
11396
11403
  runtimeState: DeviceDiscoveryStatusSchema.extend({ lastFetchedAt: number().int().nonnegative() }),
11404
+ /**
11405
+ * Runtime-state durability: **session** — 5.7 KB of scan output on the largest device, fully re-derivable by re-scanning.
11406
+ *
11407
+ * See `RuntimeStateDurability`. Enforced by
11408
+ * `scripts/check-runtime-state-durability.ts`.
11409
+ */
11410
+ durability: "session",
11397
11411
  methods: {
11398
11412
  /**
11399
11413
  * Snapshot of the current `discovered` list. Returns the
@@ -13238,7 +13252,23 @@ var NotificationActionSchema = object({
13238
13252
  * else — see `notification-center/action-token.ts` for what that does and
13239
13253
  * does not buy.
13240
13254
  */
13241
- destructive: boolean().optional()
13255
+ destructive: boolean().optional(),
13256
+ /**
13257
+ * How the tap should REACH the url.
13258
+ *
13259
+ * `navigate` (absent, and every button authored before this field) opens it:
13260
+ * the phone leaves the notification and shows whatever the callback returns.
13261
+ * That is right for a button whose answer the operator wants to read.
13262
+ *
13263
+ * `background` fires it as a POST and stays put. It exists for the buttons
13264
+ * whose whole point is not to interrupt — "silence this for 30 minutes" is
13265
+ * an answer to the notification, and being thrown into a browser tab to
13266
+ * confirm it costs more attention than the notification did. A backend that
13267
+ * cannot do a background call renders it as an ordinary link (the adapters
13268
+ * fall back rather than dropping the button), so this is a preference, never
13269
+ * a requirement.
13270
+ */
13271
+ mode: _enum(["navigate", "background"]).optional()
13242
13272
  });
13243
13273
  /**
13244
13274
  * The canonical notification. `body` is the only hard field (Apprise model).
@@ -14090,7 +14120,17 @@ var alarmPanelCapability = {
14090
14120
  * full slice; renders an arm button per `availableModes` entry and
14091
14121
  * a PIN field iff `requiresCode === true`.
14092
14122
  */
14093
- runtimeState: AlarmPanelStatusSchema
14123
+ runtimeState: AlarmPanelStatusSchema,
14124
+ /**
14125
+ * Runtime-state durability: **restored** — armed state is the one thing a panel must not lose across a restart.
14126
+ *
14127
+ * See `RuntimeStateDurability`. Enforced by
14128
+ * `scripts/check-runtime-state-durability.ts`.
14129
+ */
14130
+ durability: "restored",
14131
+ /** Clock fields: written, but excluded from the compare that decides
14132
+ * whether persisting is worth a SQLite commit. */
14133
+ volatileStateFields: ["lastChangedAt"]
14094
14134
  };
14095
14135
  /**
14096
14136
  * Shared geometry vocabulary for on-frame shape caps — privacy-mask,
@@ -14267,6 +14307,9 @@ var NcSystemEventConditionSchema = object({
14267
14307
  nodeIds: array(string().min(1)).min(1).optional(),
14268
14308
  packageNames: array(string().min(1)).min(1).optional()
14269
14309
  });
14310
+ /** Hard ceiling on a window (24h). A snooze that could not expire would be an
14311
+ * outage the operator asked for once and forgot. */
14312
+ var NC_SNOOZE_MAX_MINUTES = 1440;
14270
14313
  /** Weekly schedule — OR of windows; absence on the rule = always active. */
14271
14314
  var NcScheduleSchema = object({
14272
14315
  windows: array(object({
@@ -14643,15 +14686,15 @@ var NcConditionsSchema = object({
14643
14686
  * (an `immediate` rule naming an `audio-*` class, one notification per
14644
14687
  * classified sample) stays exactly as it was for rules that already use it.
14645
14688
  *
14646
- * NOT in {@link NC_CONDITION_CATALOG} yet, and that is the sequencing rule
14647
- * rather than an oversight: the viewer mirrors the descriptor enums BY HAND
14648
- * (`camstack/src/data/notification-center.ts`, guarded by
14649
- * `scripts/check-viewer-condition-mirror.ts`) and its rule editor STRIPS the
14689
+ * In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
14690
+ * rule rather than an accident: the viewer mirrors the descriptor enums BY
14691
+ * HAND (`camstack/src/data/notification-center.ts`, guarded by
14692
+ * `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
14650
14693
  * condition fields it does not know when a rule is saved from the phone.
14651
14694
  * Publishing an editor for a condition the app cannot round-trip is how an
14652
- * operator loses a rule's conditions by opening it — so the descriptor, the
14653
- * admin widget and the viewer mirror land together (P2 + P3), and only then
14654
- * does an audio rule become authorable.
14695
+ * operator loses a rule's conditions by opening it — so the viewer mirror
14696
+ * (P3, shipped) went FIRST, and the descriptor an editor renders from
14697
+ * follows here.
14655
14698
  */
14656
14699
  audio: NcAudioConditionSchema.optional()
14657
14700
  });
@@ -14887,6 +14930,30 @@ var NcRuleInputSchema = object({
14887
14930
  */
14888
14931
  snoozeAllowGlobal: boolean().optional(),
14889
14932
  /**
14933
+ * The snooze durations THIS rule's notification offers as buttons, in
14934
+ * minutes.
14935
+ *
14936
+ * Three states, and all three are distinct — which is exactly why this is
14937
+ * `.optional()` and never `.default()`. A Zod default does not run on the
14938
+ * addon cap path (three production failures in one day), so a schema default
14939
+ * would collapse the first two:
14940
+ *
14941
+ * | value | meaning |
14942
+ * | --- | --- |
14943
+ * | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
14944
+ * | `[]` | **no snooze buttons on this rule** — the explicit override |
14945
+ * | a list | these choices, de-duplicated and sorted, at most four |
14946
+ *
14947
+ * `.max(4)` because the notifier's own action budget is small (ntfy allows
14948
+ * three buttons in total) and a rule that spent it all on snooze choices
14949
+ * would push its own tap-through actions off the notification.
14950
+ *
14951
+ * An empty list is NOT an alarm exemption: a rule the alarm is about, or
14952
+ * that arms the panel, is exempt automatically and cannot be silenced by a
14953
+ * window from anywhere (D133).
14954
+ */
14955
+ snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
14956
+ /**
14890
14957
  * Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
14891
14958
  *
14892
14959
  * This is what makes the rule set the alarm's trigger set without the alarm
@@ -14986,6 +15053,7 @@ var NcConditionDescriptorSchema = object({
14986
15053
  "device",
14987
15054
  "package",
14988
15055
  "occupancy",
15056
+ "audio",
14989
15057
  "system"
14990
15058
  ]),
14991
15059
  label: string(),
@@ -15004,6 +15072,7 @@ var NcConditionDescriptorSchema = object({
15004
15072
  "crossingSelect",
15005
15073
  "polygonDraw",
15006
15074
  "occupancy",
15075
+ "audio",
15007
15076
  "deviceState",
15008
15077
  "systemEvent"
15009
15078
  ]),
@@ -15155,7 +15224,20 @@ var NcSnoozeInputSchema = object({
15155
15224
  ruleId: string().optional(),
15156
15225
  /** Required when `scope: 'device'`. */
15157
15226
  deviceId: number().int().optional(),
15158
- durationMinutes: number().int().min(1).max(1440),
15227
+ /**
15228
+ * Narrow the window to these subject classes — "the cat, not the person".
15229
+ *
15230
+ * ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
15231
+ * what every window authored before this field meant, so no persisted row
15232
+ * changes meaning and no client has to learn anything to keep working.
15233
+ *
15234
+ * It is what makes the window's real key `(deviceId, classes[])` and lets it
15235
+ * cross rules (D133): the operator points at a camera and a kind of thing,
15236
+ * not at whichever of their four rules happened to produce the notification
15237
+ * they are dismissing.
15238
+ */
15239
+ classes: array(string().min(1)).min(1).optional(),
15240
+ durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
15159
15241
  /**
15160
15242
  * Silence this for EVERY recipient, not just the caller. Permission is
15161
15243
  * checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
@@ -15180,6 +15262,10 @@ var NcSnoozeSchema = object({
15180
15262
  scope: NcSnoozeScopeSchema,
15181
15263
  ruleId: string().optional(),
15182
15264
  deviceId: number().int().optional(),
15265
+ /** Subject classes this window covers. ABSENT = every class — see
15266
+ * {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
15267
+ * no SQLite column: nothing queries a window by class. */
15268
+ classes: array(string().min(1)).min(1).optional(),
15183
15269
  startedAt: number(),
15184
15270
  /** Exclusive: at exactly this instant the snooze is over. Expiry is a
15185
15271
  * COMPARISON, not a job — no sweeper can leave the operator silenced. */
@@ -17280,7 +17366,14 @@ var zonesCapability = {
17280
17366
  * handle. Slice shape is `{ zones: Zone[] }` so future extensions
17281
17367
  * (e.g. zone groupings) can sit alongside the polygon list.
17282
17368
  */
17283
- runtimeState: object({ zones: array(ZoneSchema).readonly() })
17369
+ runtimeState: object({ zones: array(ZoneSchema).readonly() }),
17370
+ /**
17371
+ * 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.
17372
+ *
17373
+ * See `RuntimeStateDurability`. Enforced by
17374
+ * `scripts/check-runtime-state-durability.ts`.
17375
+ */
17376
+ durability: "restored"
17284
17377
  };
17285
17378
  /**
17286
17379
  * A bounding box in NORMALIZED [0,1] frame coordinates for `getNativeCrop`. The
@@ -20217,7 +20310,17 @@ var airQualitySensorCapability = {
20217
20310
  schema: AirQualitySensorStatusSchema,
20218
20311
  kind: "push"
20219
20312
  },
20220
- runtimeState: AirQualitySensorStatusSchema
20313
+ runtimeState: AirQualitySensorStatusSchema,
20314
+ /**
20315
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
20316
+ *
20317
+ * See `RuntimeStateDurability`. Enforced by
20318
+ * `scripts/check-runtime-state-durability.ts`.
20319
+ */
20320
+ durability: "restored",
20321
+ /** Clock fields: written, but excluded from the compare that decides
20322
+ * whether persisting is worth a SQLite commit. */
20323
+ volatileStateFields: ["lastFetchedAt"]
20221
20324
  };
20222
20325
  /**
20223
20326
  * Ambient illuminance reading in lux. Drives Home Assistant `sensor`
@@ -20249,7 +20352,17 @@ var ambientLightSensorCapability = {
20249
20352
  schema: AmbientLightSensorStatusSchema,
20250
20353
  kind: "push"
20251
20354
  },
20252
- runtimeState: AmbientLightSensorStatusSchema
20355
+ runtimeState: AmbientLightSensorStatusSchema,
20356
+ /**
20357
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
20358
+ *
20359
+ * See `RuntimeStateDurability`. Enforced by
20360
+ * `scripts/check-runtime-state-durability.ts`.
20361
+ */
20362
+ durability: "restored",
20363
+ /** Clock fields: written, but excluded from the compare that decides
20364
+ * whether persisting is worth a SQLite commit. */
20365
+ volatileStateFields: ["lastFetchedAt"]
20253
20366
  };
20254
20367
  /**
20255
20368
  * Per-class audio metrics aggregated over a sliding window.
@@ -20367,7 +20480,14 @@ var audioMetricsCapability = {
20367
20480
  }), AudioMetricsHistorySchema)
20368
20481
  },
20369
20482
  /** Reactive runtime-state mirror — live `device.state.audioMetrics.value`. */
20370
- runtimeState: AudioMetricsSnapshotSchema
20483
+ runtimeState: AudioMetricsSnapshotSchema,
20484
+ /**
20485
+ * 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.
20486
+ *
20487
+ * See `RuntimeStateDurability`. Enforced by
20488
+ * `scripts/check-runtime-state-durability.ts`.
20489
+ */
20490
+ durability: "session"
20371
20491
  };
20372
20492
  /**
20373
20493
  * Automation-control cap. Models HA `automation.*` entities on
@@ -20429,7 +20549,14 @@ var automationControlCapability = {
20429
20549
  * reads `enabled` (toggle) + `isRunning` (spinner) + `lastError`
20430
20550
  * (badge) directly.
20431
20551
  */
20432
- runtimeState: AutomationControlStatusSchema
20552
+ runtimeState: AutomationControlStatusSchema,
20553
+ /**
20554
+ * 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.
20555
+ *
20556
+ * See `RuntimeStateDurability`. Enforced by
20557
+ * `scripts/check-runtime-state-durability.ts`.
20558
+ */
20559
+ durability: "session"
20433
20560
  };
20434
20561
  /**
20435
20562
  * Battery status snapshot. Emitted by providers whose device is
@@ -20535,7 +20662,17 @@ onStatusChanged: { data: object({
20535
20662
  * via `device.runtimeState.getCapState('battery')` regardless of
20536
20663
  * the underlying driver.
20537
20664
  */
20538
- runtimeState: BatteryStatusSchema
20665
+ runtimeState: BatteryStatusSchema,
20666
+ /**
20667
+ * 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.
20668
+ *
20669
+ * See `RuntimeStateDurability`. Enforced by
20670
+ * `scripts/check-runtime-state-durability.ts`.
20671
+ */
20672
+ durability: "restored",
20673
+ /** Clock fields: written, but excluded from the compare that decides
20674
+ * whether persisting is worth a SQLite commit. */
20675
+ volatileStateFields: ["lastUpdated"]
20539
20676
  };
20540
20677
  /**
20541
20678
  * Generic boolean sensor — last-resort fallback when no domain-
@@ -20564,7 +20701,17 @@ var binaryCapability = {
20564
20701
  schema: BinaryStatusSchema,
20565
20702
  kind: "push"
20566
20703
  },
20567
- runtimeState: BinaryStatusSchema
20704
+ runtimeState: BinaryStatusSchema,
20705
+ /**
20706
+ * Runtime-state durability: **restored** — transition-driven sensor state; the restored value gives the boot comparison.
20707
+ *
20708
+ * See `RuntimeStateDurability`. Enforced by
20709
+ * `scripts/check-runtime-state-durability.ts`.
20710
+ */
20711
+ durability: "restored",
20712
+ /** Clock fields: written, but excluded from the compare that decides
20713
+ * whether persisting is worth a SQLite commit. */
20714
+ volatileStateFields: ["lastChangedAt"]
20568
20715
  };
20569
20716
  /**
20570
20717
  * Dimmable-light brightness control. Co-exists with `switch` on the
@@ -20617,7 +20764,14 @@ onBrightnessChanged: { data: object({
20617
20764
  * by the kernel. Read via `device.state.brightness.value` so UI
20618
20765
  * sliders surface the current level without polling the provider.
20619
20766
  */
20620
- runtimeState: BrightnessStatusSchema
20767
+ runtimeState: BrightnessStatusSchema,
20768
+ /**
20769
+ * Runtime-state durability: **session** — live lamp state, re-published by the provider on connect.
20770
+ *
20771
+ * See `RuntimeStateDurability`. Enforced by
20772
+ * `scripts/check-runtime-state-durability.ts`.
20773
+ */
20774
+ durability: "session"
20621
20775
  };
20622
20776
  DeviceType.Button, method(object({ deviceId: number().int().nonnegative() }), _void(), {
20623
20777
  kind: "mutation",
@@ -20705,7 +20859,17 @@ var carbonMonoxideCapability = {
20705
20859
  schema: CarbonMonoxideStatusSchema,
20706
20860
  kind: "push"
20707
20861
  },
20708
- runtimeState: CarbonMonoxideStatusSchema
20862
+ runtimeState: CarbonMonoxideStatusSchema,
20863
+ /**
20864
+ * Runtime-state durability: **restored** — as `smoke`.
20865
+ *
20866
+ * See `RuntimeStateDurability`. Enforced by
20867
+ * `scripts/check-runtime-state-durability.ts`.
20868
+ */
20869
+ durability: "restored",
20870
+ /** Clock fields: written, but excluded from the compare that decides
20871
+ * whether persisting is worth a SQLite commit. */
20872
+ volatileStateFields: ["lastChangedAt"]
20709
20873
  };
20710
20874
  /**
20711
20875
  * HVAC / climate control cap. Models the full surface of a HA
@@ -20865,7 +21029,14 @@ var climateControlCapability = {
20865
21029
  * the full slice via `device.state.climate-control.value` and refresh
20866
21030
  * on every push without re-querying the provider.
20867
21031
  */
20868
- runtimeState: ClimateControlStatusSchema
21032
+ runtimeState: ClimateControlStatusSchema,
21033
+ /**
21034
+ * Runtime-state durability: **session** — as `brightness`; `currentTemp` moves continuously and is re-published on connect.
21035
+ *
21036
+ * See `RuntimeStateDurability`. Enforced by
21037
+ * `scripts/check-runtime-state-durability.ts`.
21038
+ */
21039
+ durability: "session"
20869
21040
  };
20870
21041
  /**
20871
21042
  * Color-light cap. Coexists with `switch` (on/off) and `brightness`
@@ -20975,7 +21146,14 @@ onColorChanged: { data: object({
20975
21146
  * kernel. Read via `device.state.color.value` so UI pickers surface
20976
21147
  * the current chromaticity without polling the provider.
20977
21148
  */
20978
- runtimeState: ColorStatusSchema
21149
+ runtimeState: ColorStatusSchema,
21150
+ /**
21151
+ * Runtime-state durability: **session** — as `brightness`.
21152
+ *
21153
+ * See `RuntimeStateDurability`. Enforced by
21154
+ * `scripts/check-runtime-state-durability.ts`.
21155
+ */
21156
+ durability: "session"
20979
21157
  };
20980
21158
  var ConnectionTestOutcomeSchema = discriminatedUnion("outcome", [
20981
21159
  object({
@@ -21033,7 +21211,17 @@ var connectivityCapability = {
21033
21211
  schema: ConnectivityStatusSchema,
21034
21212
  kind: "push"
21035
21213
  },
21036
- runtimeState: ConnectivityStatusSchema
21214
+ runtimeState: ConnectivityStatusSchema,
21215
+ /**
21216
+ * Runtime-state durability: **restored** — same shape and same argument as `device-status`, for links rather than devices.
21217
+ *
21218
+ * See `RuntimeStateDurability`. Enforced by
21219
+ * `scripts/check-runtime-state-durability.ts`.
21220
+ */
21221
+ durability: "restored",
21222
+ /** Clock fields: written, but excluded from the compare that decides
21223
+ * whether persisting is worth a SQLite commit. */
21224
+ volatileStateFields: ["lastChangedAt"]
21037
21225
  };
21038
21226
  /**
21039
21227
  * Generic device-consumables capability — surfaces a device's
@@ -21115,7 +21303,14 @@ reset: method(object({
21115
21303
  }
21116
21304
  }
21117
21305
  },
21118
- runtimeState: ConsumablesStatusSchema.extend({ lastFetchedAt: number() })
21306
+ runtimeState: ConsumablesStatusSchema.extend({ lastFetchedAt: number() }),
21307
+ /**
21308
+ * Runtime-state durability: **session** — the authority is the appliance; the provider re-reads the whole item array on connect.
21309
+ *
21310
+ * See `RuntimeStateDurability`. Enforced by
21311
+ * `scripts/check-runtime-state-durability.ts`.
21312
+ */
21313
+ durability: "session"
21119
21314
  };
21120
21315
  /**
21121
21316
  * Door / window / opening / garage / valve contact sensor. Boolean
@@ -21146,7 +21341,17 @@ var contactCapability = {
21146
21341
  schema: ContactStatusSchema,
21147
21342
  kind: "push"
21148
21343
  },
21149
- runtimeState: ContactStatusSchema
21344
+ runtimeState: ContactStatusSchema,
21345
+ /**
21346
+ * Runtime-state durability: **restored** — a door left open across a restart must still read open.
21347
+ *
21348
+ * See `RuntimeStateDurability`. Enforced by
21349
+ * `scripts/check-runtime-state-durability.ts`.
21350
+ */
21351
+ durability: "restored",
21352
+ /** Clock fields: written, but excluded from the compare that decides
21353
+ * whether persisting is worth a SQLite commit. */
21354
+ volatileStateFields: ["lastChangedAt"]
21150
21355
  };
21151
21356
  /**
21152
21357
  * Status slice — flat object (the framework's `runtimeState` contract
@@ -21252,7 +21457,14 @@ var controlCapability = {
21252
21457
  * dropdown / text field / date picker) read the slice's discriminant
21253
21458
  * and value directly without polling the provider.
21254
21459
  */
21255
- runtimeState: ControlStatusSchema
21460
+ runtimeState: ControlStatusSchema,
21461
+ /**
21462
+ * Runtime-state durability: **session** — a generic control mirrors an external entity that re-publishes on connect; the options array is re-derived with it.
21463
+ *
21464
+ * See `RuntimeStateDurability`. Enforced by
21465
+ * `scripts/check-runtime-state-durability.ts`.
21466
+ */
21467
+ durability: "session"
21256
21468
  };
21257
21469
  var CoverStatusSchema = object({
21258
21470
  /** Lifecycle state of the cover. */
@@ -21313,7 +21525,17 @@ var coverCapability = {
21313
21525
  * Runtime-state slice — mirrored by the kernel. UI controls watch
21314
21526
  * the slice for live position changes during a move.
21315
21527
  */
21316
- runtimeState: CoverStatusSchema
21528
+ runtimeState: CoverStatusSchema,
21529
+ /**
21530
+ * Runtime-state durability: **restored** — position survives a restart on the device; the mirror should agree at boot rather than read blank.
21531
+ *
21532
+ * See `RuntimeStateDurability`. Enforced by
21533
+ * `scripts/check-runtime-state-durability.ts`.
21534
+ */
21535
+ durability: "restored",
21536
+ /** Clock fields: written, but excluded from the compare that decides
21537
+ * whether persisting is worth a SQLite commit. */
21538
+ volatileStateFields: ["lastChangedAt"]
21317
21539
  };
21318
21540
  /**
21319
21541
  * Vendor-neutral day/night (IR-cut) control — the per-camera config cap
@@ -21407,7 +21629,17 @@ var dayNightCapability = {
21407
21629
  schema: DayNightStatusSchema,
21408
21630
  kind: "poll"
21409
21631
  },
21410
- runtimeState: DayNightStatusSchema
21632
+ runtimeState: DayNightStatusSchema,
21633
+ /**
21634
+ * Runtime-state durability: **restored** — operator-set IR-cut behaviour; mutation-driven.
21635
+ *
21636
+ * See `RuntimeStateDurability`. Enforced by
21637
+ * `scripts/check-runtime-state-durability.ts`.
21638
+ */
21639
+ durability: "restored",
21640
+ /** Clock fields: written, but excluded from the compare that decides
21641
+ * whether persisting is worth a SQLite commit. */
21642
+ volatileStateFields: ["lastFetchedAt"]
21411
21643
  };
21412
21644
  /**
21413
21645
  * Generic device-level status snapshot. Auto-registered by `BaseDevice`
@@ -21454,7 +21686,17 @@ onStatusChanged: { data: object({
21454
21686
  schema: DeviceStatusSchema,
21455
21687
  kind: "push"
21456
21688
  },
21457
- runtimeState: DeviceStatusSchema
21689
+ runtimeState: DeviceStatusSchema,
21690
+ /**
21691
+ * 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.
21692
+ *
21693
+ * See `RuntimeStateDurability`. Enforced by
21694
+ * `scripts/check-runtime-state-durability.ts`.
21695
+ */
21696
+ durability: "restored",
21697
+ /** Clock fields: written, but excluded from the compare that decides
21698
+ * whether persisting is worth a SQLite commit. */
21699
+ volatileStateFields: ["lastChangedAt"]
21458
21700
  };
21459
21701
  /**
21460
21702
  * Doorbell button cap. Two kinds of providers coexist behind this cap
@@ -21516,7 +21758,14 @@ onPressed: { data: DoorbellPressEventSchema } },
21516
21758
  * `device.state.doorbell.value`. UIs can show "last ring 5m ago"
21517
21759
  * without subscribing.
21518
21760
  */
21519
- runtimeState: DoorbellStatusSchema
21761
+ runtimeState: DoorbellStatusSchema,
21762
+ /**
21763
+ * 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.
21764
+ *
21765
+ * See `RuntimeStateDurability`. Enforced by
21766
+ * `scripts/check-runtime-state-durability.ts`.
21767
+ */
21768
+ durability: "restored"
21520
21769
  };
21521
21770
  /**
21522
21771
  * Enum-state sensor — a string value picked from a finite option set.
@@ -21556,7 +21805,17 @@ var enumSensorCapability = {
21556
21805
  schema: EnumSensorStatusSchema,
21557
21806
  kind: "push"
21558
21807
  },
21559
- runtimeState: EnumSensorStatusSchema
21808
+ runtimeState: EnumSensorStatusSchema,
21809
+ /**
21810
+ * Runtime-state durability: **restored** — as `numeric-sensor`; 80 devices.
21811
+ *
21812
+ * See `RuntimeStateDurability`. Enforced by
21813
+ * `scripts/check-runtime-state-durability.ts`.
21814
+ */
21815
+ durability: "restored",
21816
+ /** Clock fields: written, but excluded from the compare that decides
21817
+ * whether persisting is worth a SQLite commit. */
21818
+ volatileStateFields: ["lastFetchedAt"]
21560
21819
  };
21561
21820
  /**
21562
21821
  * Generic stateless event emitter. Installed on a `DeviceType.EventEmitter`
@@ -21592,7 +21851,14 @@ var eventEmitterCapability = {
21592
21851
  schema: EventEmitterStatusSchema,
21593
21852
  kind: "push"
21594
21853
  },
21595
- runtimeState: EventEmitterStatusSchema
21854
+ runtimeState: EventEmitterStatusSchema,
21855
+ /**
21856
+ * Runtime-state durability: **session** — `eventCountSinceStart` names its own scope.
21857
+ *
21858
+ * See `RuntimeStateDurability`. Enforced by
21859
+ * `scripts/check-runtime-state-durability.ts`.
21860
+ */
21861
+ durability: "session"
21596
21862
  };
21597
21863
  var EventItemSchema = object({
21598
21864
  id: string(),
@@ -21873,7 +22139,14 @@ var fanControlCapability = {
21873
22139
  * Runtime-state slice — mirrored by the kernel. UI fan speed
21874
22140
  * sliders read `percentage` for live updates.
21875
22141
  */
21876
- runtimeState: FanControlStatusSchema
22142
+ runtimeState: FanControlStatusSchema,
22143
+ /**
22144
+ * Runtime-state durability: **session** — as `brightness`.
22145
+ *
22146
+ * See `RuntimeStateDurability`. Enforced by
22147
+ * `scripts/check-runtime-state-durability.ts`.
22148
+ */
22149
+ durability: "session"
21877
22150
  };
21878
22151
  /**
21879
22152
  * Per-device feature/identity probe slice. Holds the runtime-resolved
@@ -21949,7 +22222,14 @@ onProbeChanged: { data: object({
21949
22222
  schema: FeatureProbeStatusSchema,
21950
22223
  kind: "push"
21951
22224
  },
21952
- runtimeState: FeatureProbeStatusSchema
22225
+ runtimeState: FeatureProbeStatusSchema,
22226
+ /**
22227
+ * 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.
22228
+ *
22229
+ * See `RuntimeStateDurability`. Enforced by
22230
+ * `scripts/check-runtime-state-durability.ts`.
22231
+ */
22232
+ durability: "session"
21953
22233
  };
21954
22234
  /**
21955
22235
  * Water leak / moisture sensor. Boolean "is liquid currently
@@ -21976,7 +22256,17 @@ var floodCapability = {
21976
22256
  schema: FloodStatusSchema,
21977
22257
  kind: "push"
21978
22258
  },
21979
- runtimeState: FloodStatusSchema
22259
+ runtimeState: FloodStatusSchema,
22260
+ /**
22261
+ * Runtime-state durability: **restored** — as `smoke`.
22262
+ *
22263
+ * See `RuntimeStateDurability`. Enforced by
22264
+ * `scripts/check-runtime-state-durability.ts`.
22265
+ */
22266
+ durability: "restored",
22267
+ /** Clock fields: written, but excluded from the compare that decides
22268
+ * whether persisting is worth a SQLite commit. */
22269
+ volatileStateFields: ["lastChangedAt"]
21980
22270
  };
21981
22271
  /**
21982
22272
  * Combustible-gas (LPG / methane / hydrogen) alarm sensor. Drives
@@ -21999,7 +22289,17 @@ var gasCapability = {
21999
22289
  schema: GasStatusSchema,
22000
22290
  kind: "push"
22001
22291
  },
22002
- runtimeState: GasStatusSchema
22292
+ runtimeState: GasStatusSchema,
22293
+ /**
22294
+ * Runtime-state durability: **restored** — as `smoke`.
22295
+ *
22296
+ * See `RuntimeStateDurability`. Enforced by
22297
+ * `scripts/check-runtime-state-durability.ts`.
22298
+ */
22299
+ durability: "restored",
22300
+ /** Clock fields: written, but excluded from the compare that decides
22301
+ * whether persisting is worth a SQLite commit. */
22302
+ volatileStateFields: ["lastChangedAt"]
22003
22303
  };
22004
22304
  /**
22005
22305
  * Humidifier / dehumidifier cap. Models HA `humidifier.*` entities —
@@ -22075,7 +22375,14 @@ var humidifierCapability = {
22075
22375
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
22076
22376
  * slice for live humidity / mode changes.
22077
22377
  */
22078
- runtimeState: HumidifierStatusSchema
22378
+ runtimeState: HumidifierStatusSchema,
22379
+ /**
22380
+ * Runtime-state durability: **session** — as `climate-control`.
22381
+ *
22382
+ * See `RuntimeStateDurability`. Enforced by
22383
+ * `scripts/check-runtime-state-durability.ts`.
22384
+ */
22385
+ durability: "session"
22079
22386
  };
22080
22387
  /**
22081
22388
  * Single-metric humidity reading. Drives Home Assistant `sensor`
@@ -22111,7 +22418,17 @@ var humiditySensorCapability = {
22111
22418
  schema: HumiditySensorStatusSchema,
22112
22419
  kind: "push"
22113
22420
  },
22114
- runtimeState: HumiditySensorStatusSchema
22421
+ runtimeState: HumiditySensorStatusSchema,
22422
+ /**
22423
+ * Runtime-state durability: **restored** — as `numeric-sensor` (67 of 75 writes were the clock alone).
22424
+ *
22425
+ * See `RuntimeStateDurability`. Enforced by
22426
+ * `scripts/check-runtime-state-durability.ts`.
22427
+ */
22428
+ durability: "restored",
22429
+ /** Clock fields: written, but excluded from the compare that decides
22430
+ * whether persisting is worth a SQLite commit. */
22431
+ volatileStateFields: ["lastFetchedAt"]
22115
22432
  };
22116
22433
  /**
22117
22434
  * Image display cap. Models a single still image exposed by an integration —
@@ -22149,7 +22466,14 @@ var imageCapability = {
22149
22466
  * Runtime-state slice — mirrored by the kernel. The UI reads `url`
22150
22467
  * directly and renders the still image.
22151
22468
  */
22152
- runtimeState: ImageStatusSchema
22469
+ runtimeState: ImageStatusSchema,
22470
+ /**
22471
+ * Runtime-state durability: **session** — a snapshot URL is a session-scoped handle; a restored one points at nothing.
22472
+ *
22473
+ * See `RuntimeStateDurability`. Enforced by
22474
+ * `scripts/check-runtime-state-durability.ts`.
22475
+ */
22476
+ durability: "session"
22153
22477
  };
22154
22478
  /**
22155
22479
  * Vendor-neutral image / picture-adjustment cap — the per-camera config
@@ -22298,7 +22622,17 @@ var imageSettingsCapability = {
22298
22622
  schema: ImageSettingsStatusSchema,
22299
22623
  kind: "poll"
22300
22624
  },
22301
- runtimeState: ImageSettingsStatusSchema
22625
+ runtimeState: ImageSettingsStatusSchema,
22626
+ /**
22627
+ * Runtime-state durability: **restored** — operator-set camera imaging; mutation-driven.
22628
+ *
22629
+ * See `RuntimeStateDurability`. Enforced by
22630
+ * `scripts/check-runtime-state-durability.ts`.
22631
+ */
22632
+ durability: "restored",
22633
+ /** Clock fields: written, but excluded from the compare that decides
22634
+ * whether persisting is worth a SQLite commit. */
22635
+ volatileStateFields: ["lastFetchedAt"]
22302
22636
  };
22303
22637
  /**
22304
22638
  * integrations — system-scoped singleton capability for integration
@@ -22638,7 +22972,14 @@ var lawnMowerControlCapability = {
22638
22972
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
22639
22973
  * slice for live activity + battery changes.
22640
22974
  */
22641
- runtimeState: LawnMowerControlStatusSchema
22975
+ runtimeState: LawnMowerControlStatusSchema,
22976
+ /**
22977
+ * Runtime-state durability: **session** — as `vacuum-control`.
22978
+ *
22979
+ * See `RuntimeStateDurability`. Enforced by
22980
+ * `scripts/check-runtime-state-durability.ts`.
22981
+ */
22982
+ durability: "session"
22642
22983
  };
22643
22984
  /**
22644
22985
  * local-network — hub-only singleton.
@@ -22844,7 +23185,17 @@ var lockControlCapability = {
22844
23185
  * read `state` and disable themselves during `locking`/`unlocking`
22845
23186
  * transitions.
22846
23187
  */
22847
- runtimeState: LockControlStatusSchema
23188
+ runtimeState: LockControlStatusSchema,
23189
+ /**
23190
+ * Runtime-state durability: **restored** — a lock left locked must still read locked.
23191
+ *
23192
+ * See `RuntimeStateDurability`. Enforced by
23193
+ * `scripts/check-runtime-state-durability.ts`.
23194
+ */
23195
+ durability: "restored",
23196
+ /** Clock fields: written, but excluded from the compare that decides
23197
+ * whether persisting is worth a SQLite commit. */
23198
+ volatileStateFields: ["lastChangedAt"]
22848
23199
  };
22849
23200
  /**
22850
23201
  * Media-player cap. Models HA `media_player.*` (Sonos, Chromecast,
@@ -23006,7 +23357,14 @@ var mediaPlayerCapability = {
23006
23357
  * full slice for live now-playing, volume, and progress updates
23007
23358
  * without polling.
23008
23359
  */
23009
- runtimeState: MediaPlayerStatusSchema
23360
+ runtimeState: MediaPlayerStatusSchema,
23361
+ /**
23362
+ * Runtime-state durability: **session** — a restored transport position describes a playback that stopped when the hub did.
23363
+ *
23364
+ * See `RuntimeStateDurability`. Enforced by
23365
+ * `scripts/check-runtime-state-durability.ts`.
23366
+ */
23367
+ durability: "session"
23010
23368
  };
23011
23369
  /**
23012
23370
  * mesh-network — collection cap for mesh-VPN providers.
@@ -23270,7 +23628,14 @@ onMotionChanged: { data: MotionOnMotionChangedDataSchema } },
23270
23628
  * `device.state.motion.value`. Reads never invoke the provider, so
23271
23629
  * UIs and other addons can poll the cached state safely.
23272
23630
  */
23273
- runtimeState: MotionStatusSchema
23631
+ runtimeState: MotionStatusSchema,
23632
+ /**
23633
+ * 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.
23634
+ *
23635
+ * See `RuntimeStateDurability`. Enforced by
23636
+ * `scripts/check-runtime-state-durability.ts`.
23637
+ */
23638
+ durability: "session"
23274
23639
  };
23275
23640
  /**
23276
23641
  * Motion-trigger toggle for accessory devices.
@@ -23335,7 +23700,14 @@ var motionTriggerCapability = {
23335
23700
  schema: MotionTriggerStatusSchema,
23336
23701
  kind: "command-driven"
23337
23702
  },
23338
- runtimeState: MotionTriggerRuntimeStateSchema
23703
+ runtimeState: MotionTriggerRuntimeStateSchema,
23704
+ /**
23705
+ * 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.
23706
+ *
23707
+ * See `RuntimeStateDurability`. Enforced by
23708
+ * `scripts/check-runtime-state-durability.ts`.
23709
+ */
23710
+ durability: "session"
23339
23711
  };
23340
23712
  /**
23341
23713
  * Motion-zones share the same MaskShape vocabulary as privacy-mask — the
@@ -23402,7 +23774,17 @@ var motionZonesCapability = {
23402
23774
  schema: MotionZoneStatusSchema,
23403
23775
  kind: "poll"
23404
23776
  },
23405
- runtimeState: MotionZoneStatusSchema
23777
+ runtimeState: MotionZoneStatusSchema,
23778
+ /**
23779
+ * 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.
23780
+ *
23781
+ * See `RuntimeStateDurability`. Enforced by
23782
+ * `scripts/check-runtime-state-durability.ts`.
23783
+ */
23784
+ durability: "restored",
23785
+ /** Clock fields: written, but excluded from the compare that decides
23786
+ * whether persisting is worth a SQLite commit. */
23787
+ volatileStateFields: ["lastFetchedAt"]
23406
23788
  };
23407
23789
  /**
23408
23790
  * On-camera AI object detection cap. Surfaces per-device the classes
@@ -23476,7 +23858,17 @@ var nativeObjectDetectionCapability = {
23476
23858
  schema: NativeObjectDetectionStatusSchema,
23477
23859
  kind: "push"
23478
23860
  },
23479
- runtimeState: NativeObjectDetectionRuntimeStateSchema
23861
+ runtimeState: NativeObjectDetectionRuntimeStateSchema,
23862
+ /**
23863
+ * 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.
23864
+ *
23865
+ * See `RuntimeStateDurability`. Enforced by
23866
+ * `scripts/check-runtime-state-durability.ts`.
23867
+ */
23868
+ durability: "restored",
23869
+ /** Clock fields: written, but excluded from the compare that decides
23870
+ * whether persisting is worth a SQLite commit. */
23871
+ volatileStateFields: ["lastFetchedAt"]
23480
23872
  };
23481
23873
  /**
23482
23874
  * network-quality — system-scoped singleton capability tracking RTT,
@@ -23810,7 +24202,14 @@ onSent: { data: object({
23810
24202
  * form reads `supports` to gate optional fields; history pane reads
23811
24203
  * `lastSentAt` / `lastError` / `queueDepth`.
23812
24204
  */
23813
- runtimeState: NotifierStatusSchema
24205
+ runtimeState: NotifierStatusSchema,
24206
+ /**
24207
+ * Runtime-state durability: **session** — live queue depth and last-send state; a restored queue depth describes a queue that no longer exists.
24208
+ *
24209
+ * See `RuntimeStateDurability`. Enforced by
24210
+ * `scripts/check-runtime-state-durability.ts`.
24211
+ */
24212
+ durability: "session"
23814
24213
  };
23815
24214
  /**
23816
24215
  * Generic numeric sensor — last-resort fallback when no typed numeric
@@ -23853,7 +24252,17 @@ var numericSensorCapability = {
23853
24252
  schema: NumericSensorStatusSchema,
23854
24253
  kind: "push"
23855
24254
  },
23856
- runtimeState: NumericSensorStatusSchema
24255
+ runtimeState: NumericSensorStatusSchema,
24256
+ /**
24257
+ * 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.
24258
+ *
24259
+ * See `RuntimeStateDurability`. Enforced by
24260
+ * `scripts/check-runtime-state-durability.ts`.
24261
+ */
24262
+ durability: "restored",
24263
+ /** Clock fields: written, but excluded from the compare that decides
24264
+ * whether persisting is worth a SQLite commit. */
24265
+ volatileStateFields: ["lastFetchedAt"]
23857
24266
  };
23858
24267
  /**
23859
24268
  * Generic on-screen-display (video overlay) cap. Each camera exposes
@@ -24238,7 +24647,14 @@ var petFeederCapability = {
24238
24647
  * the full slice via `device.state.petFeeder.value` and refresh on
24239
24648
  * every poll without re-querying the provider.
24240
24649
  */
24241
- runtimeState: PetFeederStatusSchema
24650
+ runtimeState: PetFeederStatusSchema,
24651
+ /**
24652
+ * Runtime-state durability: **session** — live appliance state re-published on connect.
24653
+ *
24654
+ * See `RuntimeStateDurability`. Enforced by
24655
+ * `scripts/check-runtime-state-durability.ts`.
24656
+ */
24657
+ durability: "session"
24242
24658
  };
24243
24659
  var VehicleSchema = object({
24244
24660
  id: string(),
@@ -24550,7 +24966,17 @@ var powerMeterCapability = {
24550
24966
  schema: PowerMeterStatusSchema,
24551
24967
  kind: "push"
24552
24968
  },
24553
- runtimeState: PowerMeterStatusSchema
24969
+ runtimeState: PowerMeterStatusSchema,
24970
+ /**
24971
+ * Runtime-state durability: **restored** — as `numeric-sensor`; `kwhTotal` is an accumulator whose restored value is the baseline.
24972
+ *
24973
+ * See `RuntimeStateDurability`. Enforced by
24974
+ * `scripts/check-runtime-state-durability.ts`.
24975
+ */
24976
+ durability: "restored",
24977
+ /** Clock fields: written, but excluded from the compare that decides
24978
+ * whether persisting is worth a SQLite commit. */
24979
+ volatileStateFields: ["lastFetchedAt"]
24554
24980
  };
24555
24981
  /**
24556
24982
  * Presence cap. Models HA `person.*` and `device_tracker.*` entities
@@ -24607,7 +25033,17 @@ var presenceCapability = {
24607
25033
  * the map pin is rendered (use `DeviceFeature.PresenceGps` for the
24608
25034
  * pre-fetch fast-path check).
24609
25035
  */
24610
- runtimeState: PresenceStatusSchema
25036
+ runtimeState: PresenceStatusSchema,
25037
+ /**
25038
+ * Runtime-state durability: **restored** — occupancy-relevant: the restored state is what an occupancy rule compares the first post-restart observation against.
25039
+ *
25040
+ * See `RuntimeStateDurability`. Enforced by
25041
+ * `scripts/check-runtime-state-durability.ts`.
25042
+ */
25043
+ durability: "restored",
25044
+ /** Clock fields: written, but excluded from the compare that decides
25045
+ * whether persisting is worth a SQLite commit. */
25046
+ volatileStateFields: ["lastChangedAt"]
24611
25047
  };
24612
25048
  /**
24613
25049
  * Atmospheric pressure reading in hectopascals. Drives Home Assistant
@@ -24643,7 +25079,17 @@ var pressureSensorCapability = {
24643
25079
  schema: PressureSensorStatusSchema,
24644
25080
  kind: "push"
24645
25081
  },
24646
- runtimeState: PressureSensorStatusSchema
25082
+ runtimeState: PressureSensorStatusSchema,
25083
+ /**
25084
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
25085
+ *
25086
+ * See `RuntimeStateDurability`. Enforced by
25087
+ * `scripts/check-runtime-state-durability.ts`.
25088
+ */
25089
+ durability: "restored",
25090
+ /** Clock fields: written, but excluded from the compare that decides
25091
+ * whether persisting is worth a SQLite commit. */
25092
+ volatileStateFields: ["lastFetchedAt"]
24647
25093
  };
24648
25094
  /**
24649
25095
  * PRIVACY — what the camera deliberately does not capture. Two planes:
@@ -24773,7 +25219,17 @@ var privacyMaskCapability = {
24773
25219
  schema: PrivacyMaskStatusSchema,
24774
25220
  kind: "poll"
24775
25221
  },
24776
- runtimeState: PrivacyMaskStatusSchema
25222
+ runtimeState: PrivacyMaskStatusSchema,
25223
+ /**
25224
+ * Runtime-state durability: **restored** — operator-drawn regions, zero real churn — 22 writes in 25 minutes, every one of them the clock.
25225
+ *
25226
+ * See `RuntimeStateDurability`. Enforced by
25227
+ * `scripts/check-runtime-state-durability.ts`.
25228
+ */
25229
+ durability: "restored",
25230
+ /** Clock fields: written, but excluded from the compare that decides
25231
+ * whether persisting is worth a SQLite commit. */
25232
+ volatileStateFields: ["lastFetchedAt"]
24777
25233
  };
24778
25234
  var PtzPresetSchema = object({
24779
25235
  id: string(),
@@ -24939,7 +25395,14 @@ var ptzAutotrackCapability = {
24939
25395
  * fetch / cache / fallback logic out of the four cap methods —
24940
25396
  * they become trampolines over `runtimeState`.
24941
25397
  */
24942
- runtimeState: PtzAutotrackRuntimeStateSchema
25398
+ runtimeState: PtzAutotrackRuntimeStateSchema,
25399
+ /**
25400
+ * Runtime-state durability: **session** — mirrors the camera's own autotrack config, re-read on connect.
25401
+ *
25402
+ * See `RuntimeStateDurability`. Enforced by
25403
+ * `scripts/check-runtime-state-durability.ts`.
25404
+ */
25405
+ durability: "session"
24943
25406
  };
24944
25407
  DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceId: number().int().nonnegative() }), object({ success: literal(true) }), {
24945
25408
  kind: "mutation",
@@ -25589,7 +26052,14 @@ var sceneMonitorCapability = {
25589
26052
  schema: SceneMonitorStatusSchema,
25590
26053
  kind: "push"
25591
26054
  },
25592
- runtimeState: SceneMonitorStatusSchema
26055
+ runtimeState: SceneMonitorStatusSchema,
26056
+ /**
26057
+ * Runtime-state durability: **session** — re-derived from the current scene on the next evaluation.
26058
+ *
26059
+ * See `RuntimeStateDurability`. Enforced by
26060
+ * `scripts/check-runtime-state-durability.ts`.
26061
+ */
26062
+ durability: "session"
25593
26063
  };
25594
26064
  /**
25595
26065
  * Per-stage gating mode applied to the zones a rule references.
@@ -25733,7 +26203,14 @@ var scriptRunnerCapability = {
25733
26203
  * `isRunning` to render a spinner during execution and surfaces
25734
26204
  * `lastError` / `lastRunSuccess` in the recent-runs panel.
25735
26205
  */
25736
- runtimeState: ScriptRunnerStatusSchema
26206
+ runtimeState: ScriptRunnerStatusSchema,
26207
+ /**
26208
+ * Runtime-state durability: **session** — a restored `isRunning: true` describes a process that died with the previous hub.
26209
+ *
26210
+ * See `RuntimeStateDurability`. Enforced by
26211
+ * `scripts/check-runtime-state-durability.ts`.
26212
+ */
26213
+ durability: "session"
25737
26214
  };
25738
26215
  /**
25739
26216
  * Smoke alarm sensor — boolean "is smoke currently detected" with
@@ -25760,7 +26237,17 @@ var smokeCapability = {
25760
26237
  schema: SmokeStatusSchema,
25761
26238
  kind: "push"
25762
26239
  },
25763
- runtimeState: SmokeStatusSchema
26240
+ runtimeState: SmokeStatusSchema,
26241
+ /**
26242
+ * Runtime-state durability: **restored** — a safety sensor must not read "clear" merely because the hub restarted.
26243
+ *
26244
+ * See `RuntimeStateDurability`. Enforced by
26245
+ * `scripts/check-runtime-state-durability.ts`.
26246
+ */
26247
+ durability: "restored",
26248
+ /** Clock fields: written, but excluded from the compare that decides
26249
+ * whether persisting is worth a SQLite commit. */
26250
+ volatileStateFields: ["lastChangedAt"]
25764
26251
  };
25765
26252
  /**
25766
26253
  * One publishable camera stream as its OWNING PROVIDER describes it — the same
@@ -25946,7 +26433,17 @@ var streamParamsCapability = {
25946
26433
  schema: StreamParamsStatusSchema,
25947
26434
  kind: "poll"
25948
26435
  },
25949
- runtimeState: StreamParamsStatusSchema
26436
+ runtimeState: StreamParamsStatusSchema,
26437
+ /**
26438
+ * Runtime-state durability: **restored** — operator-set encoder profile; mutation-driven.
26439
+ *
26440
+ * See `RuntimeStateDurability`. Enforced by
26441
+ * `scripts/check-runtime-state-durability.ts`.
26442
+ */
26443
+ durability: "restored",
26444
+ /** Clock fields: written, but excluded from the compare that decides
26445
+ * whether persisting is worth a SQLite commit. */
26446
+ volatileStateFields: ["lastFetchedAt"]
25950
26447
  };
25951
26448
  /**
25952
26449
  * Generic on/off switch cap for accessory children (siren, floodlight,
@@ -25992,6 +26489,16 @@ var switchCapability = {
25992
26489
  * not need to re-query the provider after a setState mutation.
25993
26490
  */
25994
26491
  runtimeState: SwitchStatusSchema,
26492
+ /**
26493
+ * Runtime-state durability: **restored** — device state an operator reads as authoritative; 55 devices, transition-driven.
26494
+ *
26495
+ * See `RuntimeStateDurability`. Enforced by
26496
+ * `scripts/check-runtime-state-durability.ts`.
26497
+ */
26498
+ durability: "restored",
26499
+ /** Clock fields: written, but excluded from the compare that decides
26500
+ * whether persisting is worth a SQLite commit. */
26501
+ volatileStateFields: ["lastChangedAt"],
25995
26502
  settings: { bindings: [{
25996
26503
  kind: "scalar",
25997
26504
  statusPath: "on",
@@ -26071,7 +26578,17 @@ var tamperCapability = {
26071
26578
  schema: TamperStatusSchema,
26072
26579
  kind: "push"
26073
26580
  },
26074
- runtimeState: TamperStatusSchema
26581
+ runtimeState: TamperStatusSchema,
26582
+ /**
26583
+ * Runtime-state durability: **restored** — as `smoke`.
26584
+ *
26585
+ * See `RuntimeStateDurability`. Enforced by
26586
+ * `scripts/check-runtime-state-durability.ts`.
26587
+ */
26588
+ durability: "restored",
26589
+ /** Clock fields: written, but excluded from the compare that decides
26590
+ * whether persisting is worth a SQLite commit. */
26591
+ volatileStateFields: ["lastChangedAt"]
26075
26592
  };
26076
26593
  /**
26077
26594
  * Single-metric temperature reading. Drives Home Assistant `sensor`
@@ -26116,7 +26633,17 @@ var temperatureSensorCapability = {
26116
26633
  schema: TemperatureSensorStatusSchema,
26117
26634
  kind: "push"
26118
26635
  },
26119
- runtimeState: TemperatureSensorStatusSchema
26636
+ runtimeState: TemperatureSensorStatusSchema,
26637
+ /**
26638
+ * Runtime-state durability: **restored** — as `numeric-sensor` (69 of 125 writes were the clock alone).
26639
+ *
26640
+ * See `RuntimeStateDurability`. Enforced by
26641
+ * `scripts/check-runtime-state-durability.ts`.
26642
+ */
26643
+ durability: "restored",
26644
+ /** Clock fields: written, but excluded from the compare that decides
26645
+ * whether persisting is worth a SQLite commit. */
26646
+ volatileStateFields: ["lastFetchedAt"]
26120
26647
  };
26121
26648
  /**
26122
26649
  * toast — system-scoped singleton capability that streams toast
@@ -26185,7 +26712,14 @@ var updateCapability = {
26185
26712
  schema: UpdateStatusSchema,
26186
26713
  kind: "poll"
26187
26714
  },
26188
- runtimeState: UpdateStatusSchema
26715
+ runtimeState: UpdateStatusSchema,
26716
+ /**
26717
+ * Runtime-state durability: **session** — a restored `inProgress: true` describes an update that is no longer running; versions are re-probed at boot.
26718
+ *
26719
+ * See `RuntimeStateDurability`. Enforced by
26720
+ * `scripts/check-runtime-state-durability.ts`.
26721
+ */
26722
+ durability: "session"
26189
26723
  };
26190
26724
  var UserSummarySchema = object({
26191
26725
  id: string(),
@@ -26519,7 +27053,14 @@ var vacuumControlCapability = {
26519
27053
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
26520
27054
  * slice for live state + battery + fan-speed changes.
26521
27055
  */
26522
- runtimeState: VacuumControlStatusSchema
27056
+ runtimeState: VacuumControlStatusSchema,
27057
+ /**
27058
+ * Runtime-state durability: **session** — as `media-player` — a restored `state: cleaning` is a robot that is not cleaning.
27059
+ *
27060
+ * See `RuntimeStateDurability`. Enforced by
27061
+ * `scripts/check-runtime-state-durability.ts`.
27062
+ */
27063
+ durability: "session"
26523
27064
  };
26524
27065
  var ValveStatusSchema = object({
26525
27066
  /** Lifecycle state of the valve. */
@@ -26571,7 +27112,14 @@ var valveCapability = {
26571
27112
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
26572
27113
  * slice for live position changes during a move.
26573
27114
  */
26574
- runtimeState: ValveStatusSchema
27115
+ runtimeState: ValveStatusSchema,
27116
+ /**
27117
+ * Runtime-state durability: **session** — as `brightness`.
27118
+ *
27119
+ * See `RuntimeStateDurability`. Enforced by
27120
+ * `scripts/check-runtime-state-durability.ts`.
27121
+ */
27122
+ durability: "session"
26575
27123
  };
26576
27124
  /**
26577
27125
  * Vibration / shake / impact sensor. Drives Home Assistant
@@ -26593,7 +27141,17 @@ var vibrationCapability = {
26593
27141
  schema: VibrationStatusSchema,
26594
27142
  kind: "push"
26595
27143
  },
26596
- runtimeState: VibrationStatusSchema
27144
+ runtimeState: VibrationStatusSchema,
27145
+ /**
27146
+ * Runtime-state durability: **restored** — as `smoke`.
27147
+ *
27148
+ * See `RuntimeStateDurability`. Enforced by
27149
+ * `scripts/check-runtime-state-durability.ts`.
27150
+ */
27151
+ durability: "restored",
27152
+ /** Clock fields: written, but excluded from the compare that decides
27153
+ * whether persisting is worth a SQLite commit. */
27154
+ volatileStateFields: ["lastChangedAt"]
26597
27155
  };
26598
27156
  /**
26599
27157
  * Water heater / boiler cap. Models HA `water_heater.*` entities — a
@@ -26667,7 +27225,14 @@ var waterHeaterCapability = {
26667
27225
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
26668
27226
  * slice for live temperature / mode / away changes.
26669
27227
  */
26670
- runtimeState: WaterHeaterStatusSchema
27228
+ runtimeState: WaterHeaterStatusSchema,
27229
+ /**
27230
+ * Runtime-state durability: **session** — as `climate-control`.
27231
+ *
27232
+ * See `RuntimeStateDurability`. Enforced by
27233
+ * `scripts/check-runtime-state-durability.ts`.
27234
+ */
27235
+ durability: "session"
26671
27236
  };
26672
27237
  /**
26673
27238
  * Weather provider cap. Models HA `weather.*` entities — a read-only
@@ -26726,7 +27291,14 @@ var weatherCapability = {
26726
27291
  * Runtime-state slice — mirrored by the kernel. The UI reads the
26727
27292
  * current conditions directly from the slice on each weather push.
26728
27293
  */
26729
- runtimeState: WeatherStatusSchema
27294
+ runtimeState: WeatherStatusSchema,
27295
+ /**
27296
+ * Runtime-state durability: **session** — a forecast is stale the moment the hub is down; the provider re-fetches on connect.
27297
+ *
27298
+ * See `RuntimeStateDurability`. Enforced by
27299
+ * `scripts/check-runtime-state-durability.ts`.
27300
+ */
27301
+ durability: "session"
26730
27302
  };
26731
27303
  /**
26732
27304
  * Per-zone occupancy aggregation produced by the analytics frame
@@ -26888,7 +27460,14 @@ var zoneAnalyticsCapability = {
26888
27460
  * automatically; the explicit `getCurrentSnapshot` cap method is
26889
27461
  * still useful for one-off polls without a subscription.
26890
27462
  */
26891
- runtimeState: CameraOccupancySnapshotSchema
27463
+ runtimeState: CameraOccupancySnapshotSchema,
27464
+ /**
27465
+ * Runtime-state durability: **session** — per-frame analytics; with `audio-metrics` it is ~90 % of the offered write rate. Re-derived on the next frame.
27466
+ *
27467
+ * See `RuntimeStateDurability`. Enforced by
27468
+ * `scripts/check-runtime-state-durability.ts`.
27469
+ */
27470
+ durability: "session"
26892
27471
  };
26893
27472
  /**
26894
27473
  * Stages a {@link ZoneRule} can apply to. Discriminator on the rules
@@ -26966,7 +27545,14 @@ var zoneRulesCapability = {
26966
27545
  motion: array(ZoneRuleSchema).readonly(),
26967
27546
  detection: array(ZoneRuleSchema).readonly(),
26968
27547
  package: array(ZoneRuleSchema).readonly()
26969
- })
27548
+ }),
27549
+ /**
27550
+ * Runtime-state durability: **restored** — operator intent, mutation-only, same argument as `zones`.
27551
+ *
27552
+ * See `RuntimeStateDurability`. Enforced by
27553
+ * `scripts/check-runtime-state-durability.ts`.
27554
+ */
27555
+ durability: "restored"
26970
27556
  };
26971
27557
  /**
26972
27558
  * Accessory device helpers — shared across drivers.
@@ -33652,6 +34238,7 @@ Object.freeze({
33652
34238
  "network-access": "ingress",
33653
34239
  "smtp-provider": "email"
33654
34240
  });
34241
+ new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
33655
34242
  new Set(["devices", "classes"]);
33656
34243
  /**
33657
34244
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.