@camstack/addon-provider-wyze 0.2.13 → 0.2.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/dist/addon.js +723 -95
  2. package/dist/addon.mjs +723 -95
  3. package/package.json +1 -1
package/dist/addon.js CHANGED
@@ -10788,7 +10788,14 @@ var cameraStreamsCapability = {
10788
10788
  low: string().optional()
10789
10789
  }),
10790
10790
  lastChangedAt: number()
10791
- })
10791
+ }),
10792
+ /**
10793
+ * 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.
10794
+ *
10795
+ * See `RuntimeStateDurability`. Enforced by
10796
+ * `scripts/check-runtime-state-durability.ts`.
10797
+ */
10798
+ durability: "session"
10792
10799
  };
10793
10800
  /** Where a block runs. The operator chooses — a block driving a device on an
10794
10801
  * agent is the reason placement is not fixed to the hub. */
@@ -11349,6 +11356,13 @@ var deviceDiscoveryCapability = {
11349
11356
  kind: "poll"
11350
11357
  },
11351
11358
  runtimeState: DeviceDiscoveryStatusSchema.extend({ lastFetchedAt: number().int().nonnegative() }),
11359
+ /**
11360
+ * Runtime-state durability: **session** — 5.7 KB of scan output on the largest device, fully re-derivable by re-scanning.
11361
+ *
11362
+ * See `RuntimeStateDurability`. Enforced by
11363
+ * `scripts/check-runtime-state-durability.ts`.
11364
+ */
11365
+ durability: "session",
11352
11366
  methods: {
11353
11367
  /**
11354
11368
  * Snapshot of the current `discovered` list. Returns the
@@ -13265,7 +13279,23 @@ var NotificationActionSchema = object({
13265
13279
  * else — see `notification-center/action-token.ts` for what that does and
13266
13280
  * does not buy.
13267
13281
  */
13268
- destructive: boolean().optional()
13282
+ destructive: boolean().optional(),
13283
+ /**
13284
+ * How the tap should REACH the url.
13285
+ *
13286
+ * `navigate` (absent, and every button authored before this field) opens it:
13287
+ * the phone leaves the notification and shows whatever the callback returns.
13288
+ * That is right for a button whose answer the operator wants to read.
13289
+ *
13290
+ * `background` fires it as a POST and stays put. It exists for the buttons
13291
+ * whose whole point is not to interrupt — "silence this for 30 minutes" is
13292
+ * an answer to the notification, and being thrown into a browser tab to
13293
+ * confirm it costs more attention than the notification did. A backend that
13294
+ * cannot do a background call renders it as an ordinary link (the adapters
13295
+ * fall back rather than dropping the button), so this is a preference, never
13296
+ * a requirement.
13297
+ */
13298
+ mode: _enum(["navigate", "background"]).optional()
13269
13299
  });
13270
13300
  /**
13271
13301
  * The canonical notification. `body` is the only hard field (Apprise model).
@@ -14117,7 +14147,17 @@ var alarmPanelCapability = {
14117
14147
  * full slice; renders an arm button per `availableModes` entry and
14118
14148
  * a PIN field iff `requiresCode === true`.
14119
14149
  */
14120
- runtimeState: AlarmPanelStatusSchema
14150
+ runtimeState: AlarmPanelStatusSchema,
14151
+ /**
14152
+ * Runtime-state durability: **restored** — armed state is the one thing a panel must not lose across a restart.
14153
+ *
14154
+ * See `RuntimeStateDurability`. Enforced by
14155
+ * `scripts/check-runtime-state-durability.ts`.
14156
+ */
14157
+ durability: "restored",
14158
+ /** Clock fields: written, but excluded from the compare that decides
14159
+ * whether persisting is worth a SQLite commit. */
14160
+ volatileStateFields: ["lastChangedAt"]
14121
14161
  };
14122
14162
  /**
14123
14163
  * Shared geometry vocabulary for on-frame shape caps — privacy-mask,
@@ -14294,6 +14334,9 @@ var NcSystemEventConditionSchema = object({
14294
14334
  nodeIds: array(string().min(1)).min(1).optional(),
14295
14335
  packageNames: array(string().min(1)).min(1).optional()
14296
14336
  });
14337
+ /** Hard ceiling on a window (24h). A snooze that could not expire would be an
14338
+ * outage the operator asked for once and forgot. */
14339
+ var NC_SNOOZE_MAX_MINUTES = 1440;
14297
14340
  /** Weekly schedule — OR of windows; absence on the rule = always active. */
14298
14341
  var NcScheduleSchema = object({
14299
14342
  windows: array(object({
@@ -14670,15 +14713,15 @@ var NcConditionsSchema = object({
14670
14713
  * (an `immediate` rule naming an `audio-*` class, one notification per
14671
14714
  * classified sample) stays exactly as it was for rules that already use it.
14672
14715
  *
14673
- * NOT in {@link NC_CONDITION_CATALOG} yet, and that is the sequencing rule
14674
- * rather than an oversight: the viewer mirrors the descriptor enums BY HAND
14675
- * (`camstack/src/data/notification-center.ts`, guarded by
14676
- * `scripts/check-viewer-condition-mirror.ts`) and its rule editor STRIPS the
14716
+ * In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
14717
+ * rule rather than an accident: the viewer mirrors the descriptor enums BY
14718
+ * HAND (`camstack/src/data/notification-center.ts`, guarded by
14719
+ * `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
14677
14720
  * condition fields it does not know when a rule is saved from the phone.
14678
14721
  * Publishing an editor for a condition the app cannot round-trip is how an
14679
- * operator loses a rule's conditions by opening it — so the descriptor, the
14680
- * admin widget and the viewer mirror land together (P2 + P3), and only then
14681
- * does an audio rule become authorable.
14722
+ * operator loses a rule's conditions by opening it — so the viewer mirror
14723
+ * (P3, shipped) went FIRST, and the descriptor an editor renders from
14724
+ * follows here.
14682
14725
  */
14683
14726
  audio: NcAudioConditionSchema.optional()
14684
14727
  });
@@ -14914,6 +14957,30 @@ var NcRuleInputSchema = object({
14914
14957
  */
14915
14958
  snoozeAllowGlobal: boolean().optional(),
14916
14959
  /**
14960
+ * The snooze durations THIS rule's notification offers as buttons, in
14961
+ * minutes.
14962
+ *
14963
+ * Three states, and all three are distinct — which is exactly why this is
14964
+ * `.optional()` and never `.default()`. A Zod default does not run on the
14965
+ * addon cap path (three production failures in one day), so a schema default
14966
+ * would collapse the first two:
14967
+ *
14968
+ * | value | meaning |
14969
+ * | --- | --- |
14970
+ * | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
14971
+ * | `[]` | **no snooze buttons on this rule** — the explicit override |
14972
+ * | a list | these choices, de-duplicated and sorted, at most four |
14973
+ *
14974
+ * `.max(4)` because the notifier's own action budget is small (ntfy allows
14975
+ * three buttons in total) and a rule that spent it all on snooze choices
14976
+ * would push its own tap-through actions off the notification.
14977
+ *
14978
+ * An empty list is NOT an alarm exemption: a rule the alarm is about, or
14979
+ * that arms the panel, is exempt automatically and cannot be silenced by a
14980
+ * window from anywhere (D133).
14981
+ */
14982
+ snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
14983
+ /**
14917
14984
  * Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
14918
14985
  *
14919
14986
  * This is what makes the rule set the alarm's trigger set without the alarm
@@ -15013,6 +15080,7 @@ var NcConditionDescriptorSchema = object({
15013
15080
  "device",
15014
15081
  "package",
15015
15082
  "occupancy",
15083
+ "audio",
15016
15084
  "system"
15017
15085
  ]),
15018
15086
  label: string(),
@@ -15031,6 +15099,7 @@ var NcConditionDescriptorSchema = object({
15031
15099
  "crossingSelect",
15032
15100
  "polygonDraw",
15033
15101
  "occupancy",
15102
+ "audio",
15034
15103
  "deviceState",
15035
15104
  "systemEvent"
15036
15105
  ]),
@@ -15182,7 +15251,20 @@ var NcSnoozeInputSchema = object({
15182
15251
  ruleId: string().optional(),
15183
15252
  /** Required when `scope: 'device'`. */
15184
15253
  deviceId: number().int().optional(),
15185
- durationMinutes: number().int().min(1).max(1440),
15254
+ /**
15255
+ * Narrow the window to these subject classes — "the cat, not the person".
15256
+ *
15257
+ * ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
15258
+ * what every window authored before this field meant, so no persisted row
15259
+ * changes meaning and no client has to learn anything to keep working.
15260
+ *
15261
+ * It is what makes the window's real key `(deviceId, classes[])` and lets it
15262
+ * cross rules (D133): the operator points at a camera and a kind of thing,
15263
+ * not at whichever of their four rules happened to produce the notification
15264
+ * they are dismissing.
15265
+ */
15266
+ classes: array(string().min(1)).min(1).optional(),
15267
+ durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
15186
15268
  /**
15187
15269
  * Silence this for EVERY recipient, not just the caller. Permission is
15188
15270
  * checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
@@ -15207,6 +15289,10 @@ var NcSnoozeSchema = object({
15207
15289
  scope: NcSnoozeScopeSchema,
15208
15290
  ruleId: string().optional(),
15209
15291
  deviceId: number().int().optional(),
15292
+ /** Subject classes this window covers. ABSENT = every class — see
15293
+ * {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
15294
+ * no SQLite column: nothing queries a window by class. */
15295
+ classes: array(string().min(1)).min(1).optional(),
15210
15296
  startedAt: number(),
15211
15297
  /** Exclusive: at exactly this instant the snooze is over. Expiry is a
15212
15298
  * COMPARISON, not a job — no sweeper can leave the operator silenced. */
@@ -17307,7 +17393,14 @@ var zonesCapability = {
17307
17393
  * handle. Slice shape is `{ zones: Zone[] }` so future extensions
17308
17394
  * (e.g. zone groupings) can sit alongside the polygon list.
17309
17395
  */
17310
- runtimeState: object({ zones: array(ZoneSchema).readonly() })
17396
+ runtimeState: object({ zones: array(ZoneSchema).readonly() }),
17397
+ /**
17398
+ * 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.
17399
+ *
17400
+ * See `RuntimeStateDurability`. Enforced by
17401
+ * `scripts/check-runtime-state-durability.ts`.
17402
+ */
17403
+ durability: "restored"
17311
17404
  };
17312
17405
  /**
17313
17406
  * A bounding box in NORMALIZED [0,1] frame coordinates for `getNativeCrop`. The
@@ -20201,7 +20294,17 @@ var airQualitySensorCapability = {
20201
20294
  schema: AirQualitySensorStatusSchema,
20202
20295
  kind: "push"
20203
20296
  },
20204
- runtimeState: AirQualitySensorStatusSchema
20297
+ runtimeState: AirQualitySensorStatusSchema,
20298
+ /**
20299
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
20300
+ *
20301
+ * See `RuntimeStateDurability`. Enforced by
20302
+ * `scripts/check-runtime-state-durability.ts`.
20303
+ */
20304
+ durability: "restored",
20305
+ /** Clock fields: written, but excluded from the compare that decides
20306
+ * whether persisting is worth a SQLite commit. */
20307
+ volatileStateFields: ["lastFetchedAt"]
20205
20308
  };
20206
20309
  /**
20207
20310
  * Ambient illuminance reading in lux. Drives Home Assistant `sensor`
@@ -20233,7 +20336,17 @@ var ambientLightSensorCapability = {
20233
20336
  schema: AmbientLightSensorStatusSchema,
20234
20337
  kind: "push"
20235
20338
  },
20236
- runtimeState: AmbientLightSensorStatusSchema
20339
+ runtimeState: AmbientLightSensorStatusSchema,
20340
+ /**
20341
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
20342
+ *
20343
+ * See `RuntimeStateDurability`. Enforced by
20344
+ * `scripts/check-runtime-state-durability.ts`.
20345
+ */
20346
+ durability: "restored",
20347
+ /** Clock fields: written, but excluded from the compare that decides
20348
+ * whether persisting is worth a SQLite commit. */
20349
+ volatileStateFields: ["lastFetchedAt"]
20237
20350
  };
20238
20351
  /**
20239
20352
  * Per-class audio metrics aggregated over a sliding window.
@@ -20351,7 +20464,14 @@ var audioMetricsCapability = {
20351
20464
  }), AudioMetricsHistorySchema)
20352
20465
  },
20353
20466
  /** Reactive runtime-state mirror — live `device.state.audioMetrics.value`. */
20354
- runtimeState: AudioMetricsSnapshotSchema
20467
+ runtimeState: AudioMetricsSnapshotSchema,
20468
+ /**
20469
+ * 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.
20470
+ *
20471
+ * See `RuntimeStateDurability`. Enforced by
20472
+ * `scripts/check-runtime-state-durability.ts`.
20473
+ */
20474
+ durability: "session"
20355
20475
  };
20356
20476
  /**
20357
20477
  * Automation-control cap. Models HA `automation.*` entities on
@@ -20413,7 +20533,14 @@ var automationControlCapability = {
20413
20533
  * reads `enabled` (toggle) + `isRunning` (spinner) + `lastError`
20414
20534
  * (badge) directly.
20415
20535
  */
20416
- runtimeState: AutomationControlStatusSchema
20536
+ runtimeState: AutomationControlStatusSchema,
20537
+ /**
20538
+ * 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.
20539
+ *
20540
+ * See `RuntimeStateDurability`. Enforced by
20541
+ * `scripts/check-runtime-state-durability.ts`.
20542
+ */
20543
+ durability: "session"
20417
20544
  };
20418
20545
  /**
20419
20546
  * Battery status snapshot. Emitted by providers whose device is
@@ -20519,7 +20646,17 @@ onStatusChanged: { data: object({
20519
20646
  * via `device.runtimeState.getCapState('battery')` regardless of
20520
20647
  * the underlying driver.
20521
20648
  */
20522
- runtimeState: BatteryStatusSchema
20649
+ runtimeState: BatteryStatusSchema,
20650
+ /**
20651
+ * 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.
20652
+ *
20653
+ * See `RuntimeStateDurability`. Enforced by
20654
+ * `scripts/check-runtime-state-durability.ts`.
20655
+ */
20656
+ durability: "restored",
20657
+ /** Clock fields: written, but excluded from the compare that decides
20658
+ * whether persisting is worth a SQLite commit. */
20659
+ volatileStateFields: ["lastUpdated"]
20523
20660
  };
20524
20661
  /**
20525
20662
  * Generic boolean sensor — last-resort fallback when no domain-
@@ -20548,7 +20685,17 @@ var binaryCapability = {
20548
20685
  schema: BinaryStatusSchema,
20549
20686
  kind: "push"
20550
20687
  },
20551
- runtimeState: BinaryStatusSchema
20688
+ runtimeState: BinaryStatusSchema,
20689
+ /**
20690
+ * Runtime-state durability: **restored** — transition-driven sensor state; the restored value gives the boot comparison.
20691
+ *
20692
+ * See `RuntimeStateDurability`. Enforced by
20693
+ * `scripts/check-runtime-state-durability.ts`.
20694
+ */
20695
+ durability: "restored",
20696
+ /** Clock fields: written, but excluded from the compare that decides
20697
+ * whether persisting is worth a SQLite commit. */
20698
+ volatileStateFields: ["lastChangedAt"]
20552
20699
  };
20553
20700
  /**
20554
20701
  * Dimmable-light brightness control. Co-exists with `switch` on the
@@ -20601,7 +20748,14 @@ onBrightnessChanged: { data: object({
20601
20748
  * by the kernel. Read via `device.state.brightness.value` so UI
20602
20749
  * sliders surface the current level without polling the provider.
20603
20750
  */
20604
- runtimeState: BrightnessStatusSchema
20751
+ runtimeState: BrightnessStatusSchema,
20752
+ /**
20753
+ * Runtime-state durability: **session** — live lamp state, re-published by the provider on connect.
20754
+ *
20755
+ * See `RuntimeStateDurability`. Enforced by
20756
+ * `scripts/check-runtime-state-durability.ts`.
20757
+ */
20758
+ durability: "session"
20605
20759
  };
20606
20760
  DeviceType.Button, method(object({ deviceId: number().int().nonnegative() }), _void(), {
20607
20761
  kind: "mutation",
@@ -20689,7 +20843,17 @@ var carbonMonoxideCapability = {
20689
20843
  schema: CarbonMonoxideStatusSchema,
20690
20844
  kind: "push"
20691
20845
  },
20692
- runtimeState: CarbonMonoxideStatusSchema
20846
+ runtimeState: CarbonMonoxideStatusSchema,
20847
+ /**
20848
+ * Runtime-state durability: **restored** — as `smoke`.
20849
+ *
20850
+ * See `RuntimeStateDurability`. Enforced by
20851
+ * `scripts/check-runtime-state-durability.ts`.
20852
+ */
20853
+ durability: "restored",
20854
+ /** Clock fields: written, but excluded from the compare that decides
20855
+ * whether persisting is worth a SQLite commit. */
20856
+ volatileStateFields: ["lastChangedAt"]
20693
20857
  };
20694
20858
  /**
20695
20859
  * HVAC / climate control cap. Models the full surface of a HA
@@ -20849,7 +21013,14 @@ var climateControlCapability = {
20849
21013
  * the full slice via `device.state.climate-control.value` and refresh
20850
21014
  * on every push without re-querying the provider.
20851
21015
  */
20852
- runtimeState: ClimateControlStatusSchema
21016
+ runtimeState: ClimateControlStatusSchema,
21017
+ /**
21018
+ * Runtime-state durability: **session** — as `brightness`; `currentTemp` moves continuously and is re-published on connect.
21019
+ *
21020
+ * See `RuntimeStateDurability`. Enforced by
21021
+ * `scripts/check-runtime-state-durability.ts`.
21022
+ */
21023
+ durability: "session"
20853
21024
  };
20854
21025
  /**
20855
21026
  * Color-light cap. Coexists with `switch` (on/off) and `brightness`
@@ -20959,7 +21130,14 @@ onColorChanged: { data: object({
20959
21130
  * kernel. Read via `device.state.color.value` so UI pickers surface
20960
21131
  * the current chromaticity without polling the provider.
20961
21132
  */
20962
- runtimeState: ColorStatusSchema
21133
+ runtimeState: ColorStatusSchema,
21134
+ /**
21135
+ * Runtime-state durability: **session** — as `brightness`.
21136
+ *
21137
+ * See `RuntimeStateDurability`. Enforced by
21138
+ * `scripts/check-runtime-state-durability.ts`.
21139
+ */
21140
+ durability: "session"
20963
21141
  };
20964
21142
  var ConnectionTestOutcomeSchema = discriminatedUnion("outcome", [
20965
21143
  object({
@@ -21017,7 +21195,17 @@ var connectivityCapability = {
21017
21195
  schema: ConnectivityStatusSchema,
21018
21196
  kind: "push"
21019
21197
  },
21020
- runtimeState: ConnectivityStatusSchema
21198
+ runtimeState: ConnectivityStatusSchema,
21199
+ /**
21200
+ * Runtime-state durability: **restored** — same shape and same argument as `device-status`, for links rather than devices.
21201
+ *
21202
+ * See `RuntimeStateDurability`. Enforced by
21203
+ * `scripts/check-runtime-state-durability.ts`.
21204
+ */
21205
+ durability: "restored",
21206
+ /** Clock fields: written, but excluded from the compare that decides
21207
+ * whether persisting is worth a SQLite commit. */
21208
+ volatileStateFields: ["lastChangedAt"]
21021
21209
  };
21022
21210
  /**
21023
21211
  * Generic device-consumables capability — surfaces a device's
@@ -21099,7 +21287,14 @@ reset: method(object({
21099
21287
  }
21100
21288
  }
21101
21289
  },
21102
- runtimeState: ConsumablesStatusSchema.extend({ lastFetchedAt: number() })
21290
+ runtimeState: ConsumablesStatusSchema.extend({ lastFetchedAt: number() }),
21291
+ /**
21292
+ * Runtime-state durability: **session** — the authority is the appliance; the provider re-reads the whole item array on connect.
21293
+ *
21294
+ * See `RuntimeStateDurability`. Enforced by
21295
+ * `scripts/check-runtime-state-durability.ts`.
21296
+ */
21297
+ durability: "session"
21103
21298
  };
21104
21299
  /**
21105
21300
  * Door / window / opening / garage / valve contact sensor. Boolean
@@ -21130,7 +21325,17 @@ var contactCapability = {
21130
21325
  schema: ContactStatusSchema,
21131
21326
  kind: "push"
21132
21327
  },
21133
- runtimeState: ContactStatusSchema
21328
+ runtimeState: ContactStatusSchema,
21329
+ /**
21330
+ * Runtime-state durability: **restored** — a door left open across a restart must still read open.
21331
+ *
21332
+ * See `RuntimeStateDurability`. Enforced by
21333
+ * `scripts/check-runtime-state-durability.ts`.
21334
+ */
21335
+ durability: "restored",
21336
+ /** Clock fields: written, but excluded from the compare that decides
21337
+ * whether persisting is worth a SQLite commit. */
21338
+ volatileStateFields: ["lastChangedAt"]
21134
21339
  };
21135
21340
  /**
21136
21341
  * Status slice — flat object (the framework's `runtimeState` contract
@@ -21236,7 +21441,14 @@ var controlCapability = {
21236
21441
  * dropdown / text field / date picker) read the slice's discriminant
21237
21442
  * and value directly without polling the provider.
21238
21443
  */
21239
- runtimeState: ControlStatusSchema
21444
+ runtimeState: ControlStatusSchema,
21445
+ /**
21446
+ * Runtime-state durability: **session** — a generic control mirrors an external entity that re-publishes on connect; the options array is re-derived with it.
21447
+ *
21448
+ * See `RuntimeStateDurability`. Enforced by
21449
+ * `scripts/check-runtime-state-durability.ts`.
21450
+ */
21451
+ durability: "session"
21240
21452
  };
21241
21453
  var CoverStatusSchema = object({
21242
21454
  /** Lifecycle state of the cover. */
@@ -21297,7 +21509,17 @@ var coverCapability = {
21297
21509
  * Runtime-state slice — mirrored by the kernel. UI controls watch
21298
21510
  * the slice for live position changes during a move.
21299
21511
  */
21300
- runtimeState: CoverStatusSchema
21512
+ runtimeState: CoverStatusSchema,
21513
+ /**
21514
+ * Runtime-state durability: **restored** — position survives a restart on the device; the mirror should agree at boot rather than read blank.
21515
+ *
21516
+ * See `RuntimeStateDurability`. Enforced by
21517
+ * `scripts/check-runtime-state-durability.ts`.
21518
+ */
21519
+ durability: "restored",
21520
+ /** Clock fields: written, but excluded from the compare that decides
21521
+ * whether persisting is worth a SQLite commit. */
21522
+ volatileStateFields: ["lastChangedAt"]
21301
21523
  };
21302
21524
  /**
21303
21525
  * Vendor-neutral day/night (IR-cut) control — the per-camera config cap
@@ -21391,7 +21613,17 @@ var dayNightCapability = {
21391
21613
  schema: DayNightStatusSchema,
21392
21614
  kind: "poll"
21393
21615
  },
21394
- runtimeState: DayNightStatusSchema
21616
+ runtimeState: DayNightStatusSchema,
21617
+ /**
21618
+ * Runtime-state durability: **restored** — operator-set IR-cut behaviour; mutation-driven.
21619
+ *
21620
+ * See `RuntimeStateDurability`. Enforced by
21621
+ * `scripts/check-runtime-state-durability.ts`.
21622
+ */
21623
+ durability: "restored",
21624
+ /** Clock fields: written, but excluded from the compare that decides
21625
+ * whether persisting is worth a SQLite commit. */
21626
+ volatileStateFields: ["lastFetchedAt"]
21395
21627
  };
21396
21628
  /**
21397
21629
  * Generic device-level status snapshot. Auto-registered by `BaseDevice`
@@ -21438,7 +21670,17 @@ onStatusChanged: { data: object({
21438
21670
  schema: DeviceStatusSchema,
21439
21671
  kind: "push"
21440
21672
  },
21441
- runtimeState: DeviceStatusSchema
21673
+ runtimeState: DeviceStatusSchema,
21674
+ /**
21675
+ * 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.
21676
+ *
21677
+ * See `RuntimeStateDurability`. Enforced by
21678
+ * `scripts/check-runtime-state-durability.ts`.
21679
+ */
21680
+ durability: "restored",
21681
+ /** Clock fields: written, but excluded from the compare that decides
21682
+ * whether persisting is worth a SQLite commit. */
21683
+ volatileStateFields: ["lastChangedAt"]
21442
21684
  };
21443
21685
  /**
21444
21686
  * Doorbell button cap. Two kinds of providers coexist behind this cap
@@ -21500,7 +21742,14 @@ onPressed: { data: DoorbellPressEventSchema } },
21500
21742
  * `device.state.doorbell.value`. UIs can show "last ring 5m ago"
21501
21743
  * without subscribing.
21502
21744
  */
21503
- runtimeState: DoorbellStatusSchema
21745
+ runtimeState: DoorbellStatusSchema,
21746
+ /**
21747
+ * 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.
21748
+ *
21749
+ * See `RuntimeStateDurability`. Enforced by
21750
+ * `scripts/check-runtime-state-durability.ts`.
21751
+ */
21752
+ durability: "restored"
21504
21753
  };
21505
21754
  /**
21506
21755
  * Enum-state sensor — a string value picked from a finite option set.
@@ -21540,7 +21789,17 @@ var enumSensorCapability = {
21540
21789
  schema: EnumSensorStatusSchema,
21541
21790
  kind: "push"
21542
21791
  },
21543
- runtimeState: EnumSensorStatusSchema
21792
+ runtimeState: EnumSensorStatusSchema,
21793
+ /**
21794
+ * Runtime-state durability: **restored** — as `numeric-sensor`; 80 devices.
21795
+ *
21796
+ * See `RuntimeStateDurability`. Enforced by
21797
+ * `scripts/check-runtime-state-durability.ts`.
21798
+ */
21799
+ durability: "restored",
21800
+ /** Clock fields: written, but excluded from the compare that decides
21801
+ * whether persisting is worth a SQLite commit. */
21802
+ volatileStateFields: ["lastFetchedAt"]
21544
21803
  };
21545
21804
  /**
21546
21805
  * Generic stateless event emitter. Installed on a `DeviceType.EventEmitter`
@@ -21576,7 +21835,14 @@ var eventEmitterCapability = {
21576
21835
  schema: EventEmitterStatusSchema,
21577
21836
  kind: "push"
21578
21837
  },
21579
- runtimeState: EventEmitterStatusSchema
21838
+ runtimeState: EventEmitterStatusSchema,
21839
+ /**
21840
+ * Runtime-state durability: **session** — `eventCountSinceStart` names its own scope.
21841
+ *
21842
+ * See `RuntimeStateDurability`. Enforced by
21843
+ * `scripts/check-runtime-state-durability.ts`.
21844
+ */
21845
+ durability: "session"
21580
21846
  };
21581
21847
  var EventItemSchema = object({
21582
21848
  id: string(),
@@ -21857,7 +22123,14 @@ var fanControlCapability = {
21857
22123
  * Runtime-state slice — mirrored by the kernel. UI fan speed
21858
22124
  * sliders read `percentage` for live updates.
21859
22125
  */
21860
- runtimeState: FanControlStatusSchema
22126
+ runtimeState: FanControlStatusSchema,
22127
+ /**
22128
+ * Runtime-state durability: **session** — as `brightness`.
22129
+ *
22130
+ * See `RuntimeStateDurability`. Enforced by
22131
+ * `scripts/check-runtime-state-durability.ts`.
22132
+ */
22133
+ durability: "session"
21861
22134
  };
21862
22135
  /**
21863
22136
  * Per-device feature/identity probe slice. Holds the runtime-resolved
@@ -21933,7 +22206,14 @@ onProbeChanged: { data: object({
21933
22206
  schema: FeatureProbeStatusSchema,
21934
22207
  kind: "push"
21935
22208
  },
21936
- runtimeState: FeatureProbeStatusSchema
22209
+ runtimeState: FeatureProbeStatusSchema,
22210
+ /**
22211
+ * 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.
22212
+ *
22213
+ * See `RuntimeStateDurability`. Enforced by
22214
+ * `scripts/check-runtime-state-durability.ts`.
22215
+ */
22216
+ durability: "session"
21937
22217
  };
21938
22218
  /**
21939
22219
  * Water leak / moisture sensor. Boolean "is liquid currently
@@ -21960,7 +22240,17 @@ var floodCapability = {
21960
22240
  schema: FloodStatusSchema,
21961
22241
  kind: "push"
21962
22242
  },
21963
- runtimeState: FloodStatusSchema
22243
+ runtimeState: FloodStatusSchema,
22244
+ /**
22245
+ * Runtime-state durability: **restored** — as `smoke`.
22246
+ *
22247
+ * See `RuntimeStateDurability`. Enforced by
22248
+ * `scripts/check-runtime-state-durability.ts`.
22249
+ */
22250
+ durability: "restored",
22251
+ /** Clock fields: written, but excluded from the compare that decides
22252
+ * whether persisting is worth a SQLite commit. */
22253
+ volatileStateFields: ["lastChangedAt"]
21964
22254
  };
21965
22255
  /**
21966
22256
  * Combustible-gas (LPG / methane / hydrogen) alarm sensor. Drives
@@ -21983,7 +22273,17 @@ var gasCapability = {
21983
22273
  schema: GasStatusSchema,
21984
22274
  kind: "push"
21985
22275
  },
21986
- runtimeState: GasStatusSchema
22276
+ runtimeState: GasStatusSchema,
22277
+ /**
22278
+ * Runtime-state durability: **restored** — as `smoke`.
22279
+ *
22280
+ * See `RuntimeStateDurability`. Enforced by
22281
+ * `scripts/check-runtime-state-durability.ts`.
22282
+ */
22283
+ durability: "restored",
22284
+ /** Clock fields: written, but excluded from the compare that decides
22285
+ * whether persisting is worth a SQLite commit. */
22286
+ volatileStateFields: ["lastChangedAt"]
21987
22287
  };
21988
22288
  /**
21989
22289
  * Humidifier / dehumidifier cap. Models HA `humidifier.*` entities —
@@ -22059,7 +22359,14 @@ var humidifierCapability = {
22059
22359
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
22060
22360
  * slice for live humidity / mode changes.
22061
22361
  */
22062
- runtimeState: HumidifierStatusSchema
22362
+ runtimeState: HumidifierStatusSchema,
22363
+ /**
22364
+ * Runtime-state durability: **session** — as `climate-control`.
22365
+ *
22366
+ * See `RuntimeStateDurability`. Enforced by
22367
+ * `scripts/check-runtime-state-durability.ts`.
22368
+ */
22369
+ durability: "session"
22063
22370
  };
22064
22371
  /**
22065
22372
  * Single-metric humidity reading. Drives Home Assistant `sensor`
@@ -22095,7 +22402,17 @@ var humiditySensorCapability = {
22095
22402
  schema: HumiditySensorStatusSchema,
22096
22403
  kind: "push"
22097
22404
  },
22098
- runtimeState: HumiditySensorStatusSchema
22405
+ runtimeState: HumiditySensorStatusSchema,
22406
+ /**
22407
+ * Runtime-state durability: **restored** — as `numeric-sensor` (67 of 75 writes were the clock alone).
22408
+ *
22409
+ * See `RuntimeStateDurability`. Enforced by
22410
+ * `scripts/check-runtime-state-durability.ts`.
22411
+ */
22412
+ durability: "restored",
22413
+ /** Clock fields: written, but excluded from the compare that decides
22414
+ * whether persisting is worth a SQLite commit. */
22415
+ volatileStateFields: ["lastFetchedAt"]
22099
22416
  };
22100
22417
  /**
22101
22418
  * Image display cap. Models a single still image exposed by an integration —
@@ -22133,7 +22450,14 @@ var imageCapability = {
22133
22450
  * Runtime-state slice — mirrored by the kernel. The UI reads `url`
22134
22451
  * directly and renders the still image.
22135
22452
  */
22136
- runtimeState: ImageStatusSchema
22453
+ runtimeState: ImageStatusSchema,
22454
+ /**
22455
+ * Runtime-state durability: **session** — a snapshot URL is a session-scoped handle; a restored one points at nothing.
22456
+ *
22457
+ * See `RuntimeStateDurability`. Enforced by
22458
+ * `scripts/check-runtime-state-durability.ts`.
22459
+ */
22460
+ durability: "session"
22137
22461
  };
22138
22462
  /**
22139
22463
  * Vendor-neutral image / picture-adjustment cap — the per-camera config
@@ -22282,7 +22606,17 @@ var imageSettingsCapability = {
22282
22606
  schema: ImageSettingsStatusSchema,
22283
22607
  kind: "poll"
22284
22608
  },
22285
- runtimeState: ImageSettingsStatusSchema
22609
+ runtimeState: ImageSettingsStatusSchema,
22610
+ /**
22611
+ * Runtime-state durability: **restored** — operator-set camera imaging; mutation-driven.
22612
+ *
22613
+ * See `RuntimeStateDurability`. Enforced by
22614
+ * `scripts/check-runtime-state-durability.ts`.
22615
+ */
22616
+ durability: "restored",
22617
+ /** Clock fields: written, but excluded from the compare that decides
22618
+ * whether persisting is worth a SQLite commit. */
22619
+ volatileStateFields: ["lastFetchedAt"]
22286
22620
  };
22287
22621
  /**
22288
22622
  * integrations — system-scoped singleton capability for integration
@@ -22673,7 +23007,14 @@ var lawnMowerControlCapability = {
22673
23007
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
22674
23008
  * slice for live activity + battery changes.
22675
23009
  */
22676
- runtimeState: LawnMowerControlStatusSchema
23010
+ runtimeState: LawnMowerControlStatusSchema,
23011
+ /**
23012
+ * Runtime-state durability: **session** — as `vacuum-control`.
23013
+ *
23014
+ * See `RuntimeStateDurability`. Enforced by
23015
+ * `scripts/check-runtime-state-durability.ts`.
23016
+ */
23017
+ durability: "session"
22677
23018
  };
22678
23019
  /**
22679
23020
  * local-network — hub-only singleton.
@@ -22879,7 +23220,17 @@ var lockControlCapability = {
22879
23220
  * read `state` and disable themselves during `locking`/`unlocking`
22880
23221
  * transitions.
22881
23222
  */
22882
- runtimeState: LockControlStatusSchema
23223
+ runtimeState: LockControlStatusSchema,
23224
+ /**
23225
+ * Runtime-state durability: **restored** — a lock left locked must still read locked.
23226
+ *
23227
+ * See `RuntimeStateDurability`. Enforced by
23228
+ * `scripts/check-runtime-state-durability.ts`.
23229
+ */
23230
+ durability: "restored",
23231
+ /** Clock fields: written, but excluded from the compare that decides
23232
+ * whether persisting is worth a SQLite commit. */
23233
+ volatileStateFields: ["lastChangedAt"]
22883
23234
  };
22884
23235
  /**
22885
23236
  * Media-player cap. Models HA `media_player.*` (Sonos, Chromecast,
@@ -23041,7 +23392,14 @@ var mediaPlayerCapability = {
23041
23392
  * full slice for live now-playing, volume, and progress updates
23042
23393
  * without polling.
23043
23394
  */
23044
- runtimeState: MediaPlayerStatusSchema
23395
+ runtimeState: MediaPlayerStatusSchema,
23396
+ /**
23397
+ * Runtime-state durability: **session** — a restored transport position describes a playback that stopped when the hub did.
23398
+ *
23399
+ * See `RuntimeStateDurability`. Enforced by
23400
+ * `scripts/check-runtime-state-durability.ts`.
23401
+ */
23402
+ durability: "session"
23045
23403
  };
23046
23404
  /**
23047
23405
  * mesh-network — collection cap for mesh-VPN providers.
@@ -23305,7 +23663,14 @@ onMotionChanged: { data: MotionOnMotionChangedDataSchema } },
23305
23663
  * `device.state.motion.value`. Reads never invoke the provider, so
23306
23664
  * UIs and other addons can poll the cached state safely.
23307
23665
  */
23308
- runtimeState: MotionStatusSchema
23666
+ runtimeState: MotionStatusSchema,
23667
+ /**
23668
+ * 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.
23669
+ *
23670
+ * See `RuntimeStateDurability`. Enforced by
23671
+ * `scripts/check-runtime-state-durability.ts`.
23672
+ */
23673
+ durability: "session"
23309
23674
  };
23310
23675
  /**
23311
23676
  * Motion-trigger toggle for accessory devices.
@@ -23370,7 +23735,14 @@ var motionTriggerCapability = {
23370
23735
  schema: MotionTriggerStatusSchema,
23371
23736
  kind: "command-driven"
23372
23737
  },
23373
- runtimeState: MotionTriggerRuntimeStateSchema
23738
+ runtimeState: MotionTriggerRuntimeStateSchema,
23739
+ /**
23740
+ * 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.
23741
+ *
23742
+ * See `RuntimeStateDurability`. Enforced by
23743
+ * `scripts/check-runtime-state-durability.ts`.
23744
+ */
23745
+ durability: "session"
23374
23746
  };
23375
23747
  /**
23376
23748
  * Motion-zones share the same MaskShape vocabulary as privacy-mask — the
@@ -23437,7 +23809,17 @@ var motionZonesCapability = {
23437
23809
  schema: MotionZoneStatusSchema,
23438
23810
  kind: "poll"
23439
23811
  },
23440
- runtimeState: MotionZoneStatusSchema
23812
+ runtimeState: MotionZoneStatusSchema,
23813
+ /**
23814
+ * 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.
23815
+ *
23816
+ * See `RuntimeStateDurability`. Enforced by
23817
+ * `scripts/check-runtime-state-durability.ts`.
23818
+ */
23819
+ durability: "restored",
23820
+ /** Clock fields: written, but excluded from the compare that decides
23821
+ * whether persisting is worth a SQLite commit. */
23822
+ volatileStateFields: ["lastFetchedAt"]
23441
23823
  };
23442
23824
  /**
23443
23825
  * On-camera AI object detection cap. Surfaces per-device the classes
@@ -23511,7 +23893,17 @@ var nativeObjectDetectionCapability = {
23511
23893
  schema: NativeObjectDetectionStatusSchema,
23512
23894
  kind: "push"
23513
23895
  },
23514
- runtimeState: NativeObjectDetectionRuntimeStateSchema
23896
+ runtimeState: NativeObjectDetectionRuntimeStateSchema,
23897
+ /**
23898
+ * 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.
23899
+ *
23900
+ * See `RuntimeStateDurability`. Enforced by
23901
+ * `scripts/check-runtime-state-durability.ts`.
23902
+ */
23903
+ durability: "restored",
23904
+ /** Clock fields: written, but excluded from the compare that decides
23905
+ * whether persisting is worth a SQLite commit. */
23906
+ volatileStateFields: ["lastFetchedAt"]
23515
23907
  };
23516
23908
  /**
23517
23909
  * network-quality — system-scoped singleton capability tracking RTT,
@@ -23845,7 +24237,14 @@ onSent: { data: object({
23845
24237
  * form reads `supports` to gate optional fields; history pane reads
23846
24238
  * `lastSentAt` / `lastError` / `queueDepth`.
23847
24239
  */
23848
- runtimeState: NotifierStatusSchema
24240
+ runtimeState: NotifierStatusSchema,
24241
+ /**
24242
+ * Runtime-state durability: **session** — live queue depth and last-send state; a restored queue depth describes a queue that no longer exists.
24243
+ *
24244
+ * See `RuntimeStateDurability`. Enforced by
24245
+ * `scripts/check-runtime-state-durability.ts`.
24246
+ */
24247
+ durability: "session"
23849
24248
  };
23850
24249
  /**
23851
24250
  * Generic numeric sensor — last-resort fallback when no typed numeric
@@ -23888,7 +24287,17 @@ var numericSensorCapability = {
23888
24287
  schema: NumericSensorStatusSchema,
23889
24288
  kind: "push"
23890
24289
  },
23891
- runtimeState: NumericSensorStatusSchema
24290
+ runtimeState: NumericSensorStatusSchema,
24291
+ /**
24292
+ * 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.
24293
+ *
24294
+ * See `RuntimeStateDurability`. Enforced by
24295
+ * `scripts/check-runtime-state-durability.ts`.
24296
+ */
24297
+ durability: "restored",
24298
+ /** Clock fields: written, but excluded from the compare that decides
24299
+ * whether persisting is worth a SQLite commit. */
24300
+ volatileStateFields: ["lastFetchedAt"]
23892
24301
  };
23893
24302
  /**
23894
24303
  * Generic on-screen-display (video overlay) cap. Each camera exposes
@@ -24273,7 +24682,14 @@ var petFeederCapability = {
24273
24682
  * the full slice via `device.state.petFeeder.value` and refresh on
24274
24683
  * every poll without re-querying the provider.
24275
24684
  */
24276
- runtimeState: PetFeederStatusSchema
24685
+ runtimeState: PetFeederStatusSchema,
24686
+ /**
24687
+ * Runtime-state durability: **session** — live appliance state re-published on connect.
24688
+ *
24689
+ * See `RuntimeStateDurability`. Enforced by
24690
+ * `scripts/check-runtime-state-durability.ts`.
24691
+ */
24692
+ durability: "session"
24277
24693
  };
24278
24694
  var VehicleSchema = object({
24279
24695
  id: string(),
@@ -24585,7 +25001,17 @@ var powerMeterCapability = {
24585
25001
  schema: PowerMeterStatusSchema,
24586
25002
  kind: "push"
24587
25003
  },
24588
- runtimeState: PowerMeterStatusSchema
25004
+ runtimeState: PowerMeterStatusSchema,
25005
+ /**
25006
+ * Runtime-state durability: **restored** — as `numeric-sensor`; `kwhTotal` is an accumulator whose restored value is the baseline.
25007
+ *
25008
+ * See `RuntimeStateDurability`. Enforced by
25009
+ * `scripts/check-runtime-state-durability.ts`.
25010
+ */
25011
+ durability: "restored",
25012
+ /** Clock fields: written, but excluded from the compare that decides
25013
+ * whether persisting is worth a SQLite commit. */
25014
+ volatileStateFields: ["lastFetchedAt"]
24589
25015
  };
24590
25016
  /**
24591
25017
  * Presence cap. Models HA `person.*` and `device_tracker.*` entities
@@ -24642,7 +25068,17 @@ var presenceCapability = {
24642
25068
  * the map pin is rendered (use `DeviceFeature.PresenceGps` for the
24643
25069
  * pre-fetch fast-path check).
24644
25070
  */
24645
- runtimeState: PresenceStatusSchema
25071
+ runtimeState: PresenceStatusSchema,
25072
+ /**
25073
+ * Runtime-state durability: **restored** — occupancy-relevant: the restored state is what an occupancy rule compares the first post-restart observation against.
25074
+ *
25075
+ * See `RuntimeStateDurability`. Enforced by
25076
+ * `scripts/check-runtime-state-durability.ts`.
25077
+ */
25078
+ durability: "restored",
25079
+ /** Clock fields: written, but excluded from the compare that decides
25080
+ * whether persisting is worth a SQLite commit. */
25081
+ volatileStateFields: ["lastChangedAt"]
24646
25082
  };
24647
25083
  /**
24648
25084
  * Atmospheric pressure reading in hectopascals. Drives Home Assistant
@@ -24678,7 +25114,17 @@ var pressureSensorCapability = {
24678
25114
  schema: PressureSensorStatusSchema,
24679
25115
  kind: "push"
24680
25116
  },
24681
- runtimeState: PressureSensorStatusSchema
25117
+ runtimeState: PressureSensorStatusSchema,
25118
+ /**
25119
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
25120
+ *
25121
+ * See `RuntimeStateDurability`. Enforced by
25122
+ * `scripts/check-runtime-state-durability.ts`.
25123
+ */
25124
+ durability: "restored",
25125
+ /** Clock fields: written, but excluded from the compare that decides
25126
+ * whether persisting is worth a SQLite commit. */
25127
+ volatileStateFields: ["lastFetchedAt"]
24682
25128
  };
24683
25129
  /**
24684
25130
  * PRIVACY — what the camera deliberately does not capture. Two planes:
@@ -24808,7 +25254,17 @@ var privacyMaskCapability = {
24808
25254
  schema: PrivacyMaskStatusSchema,
24809
25255
  kind: "poll"
24810
25256
  },
24811
- runtimeState: PrivacyMaskStatusSchema
25257
+ runtimeState: PrivacyMaskStatusSchema,
25258
+ /**
25259
+ * Runtime-state durability: **restored** — operator-drawn regions, zero real churn — 22 writes in 25 minutes, every one of them the clock.
25260
+ *
25261
+ * See `RuntimeStateDurability`. Enforced by
25262
+ * `scripts/check-runtime-state-durability.ts`.
25263
+ */
25264
+ durability: "restored",
25265
+ /** Clock fields: written, but excluded from the compare that decides
25266
+ * whether persisting is worth a SQLite commit. */
25267
+ volatileStateFields: ["lastFetchedAt"]
24812
25268
  };
24813
25269
  var PtzPresetSchema = object({
24814
25270
  id: string(),
@@ -24974,7 +25430,14 @@ var ptzAutotrackCapability = {
24974
25430
  * fetch / cache / fallback logic out of the four cap methods —
24975
25431
  * they become trampolines over `runtimeState`.
24976
25432
  */
24977
- runtimeState: PtzAutotrackRuntimeStateSchema
25433
+ runtimeState: PtzAutotrackRuntimeStateSchema,
25434
+ /**
25435
+ * Runtime-state durability: **session** — mirrors the camera's own autotrack config, re-read on connect.
25436
+ *
25437
+ * See `RuntimeStateDurability`. Enforced by
25438
+ * `scripts/check-runtime-state-durability.ts`.
25439
+ */
25440
+ durability: "session"
24978
25441
  };
24979
25442
  DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceId: number().int().nonnegative() }), object({ success: literal(true) }), {
24980
25443
  kind: "mutation",
@@ -25321,13 +25784,24 @@ method(object({
25321
25784
  /** Playback-speed multiplier for the render (1 = realtime). */
25322
25785
  var ExportSpeedSchema = number().min(.25).max(32);
25323
25786
  /**
25324
- * One dense interval, in SECONDS FROM THE EXPORT'S OWN `fromMs`.
25787
+ * One dense interval, in WALL-CLOCK SECONDS FROM THE EXPORT'S OWN `fromMs`.
25788
+ *
25789
+ * **Wall clock, not ffmpeg's `t`** — and the recorder translates. A caller
25790
+ * derives these bounds from things that happened at a TIME (a track's
25791
+ * `firstSeen`), while `t` runs over the source playlist: the concatenation of
25792
+ * every segment present for the range, with each recording GAP removed. The
25793
+ * two agree only on a window that recorded without one interruption, and only
25794
+ * the render side knows the segments, so the translation lives there
25795
+ * (`export-dense-map.ts`, addon-pipeline).
25796
+ *
25797
+ * It was not always so. These seconds were fed to `between(t,…)` verbatim, and
25798
+ * on a 10 h window holding 29,393 s of footage every range landed late by the
25799
+ * gap accumulated before it — up to 6,607 s, well past EOF. Nothing matched,
25800
+ * the video was a uniform timelapse, and the log line reported the five ranges
25801
+ * that had been ASKED for (2026-08-13, export `57d14363`, camera 615).
25325
25802
  *
25326
- * Relative and not absolute epoch on purpose: the renderer's frame-select
25327
- * expression sees ffmpeg's `t`, which starts at 0 for the export's source
25328
- * playlist. Handing it absolute epochs would make every call site responsible
25329
- * for the same subtraction, and the one that forgot would emit a filter that
25330
- * selects nothing — silently, as a uniform timelapse.
25803
+ * Relative and not absolute epoch, because an absolute epoch would make every
25804
+ * call site responsible for the same subtraction.
25331
25805
  */
25332
25806
  var ExportDenseRangeSchema = object({
25333
25807
  fromSec: number().nonnegative(),
@@ -25613,7 +26087,14 @@ var sceneMonitorCapability = {
25613
26087
  schema: SceneMonitorStatusSchema,
25614
26088
  kind: "push"
25615
26089
  },
25616
- runtimeState: SceneMonitorStatusSchema
26090
+ runtimeState: SceneMonitorStatusSchema,
26091
+ /**
26092
+ * Runtime-state durability: **session** — re-derived from the current scene on the next evaluation.
26093
+ *
26094
+ * See `RuntimeStateDurability`. Enforced by
26095
+ * `scripts/check-runtime-state-durability.ts`.
26096
+ */
26097
+ durability: "session"
25617
26098
  };
25618
26099
  /**
25619
26100
  * Per-stage gating mode applied to the zones a rule references.
@@ -25757,7 +26238,14 @@ var scriptRunnerCapability = {
25757
26238
  * `isRunning` to render a spinner during execution and surfaces
25758
26239
  * `lastError` / `lastRunSuccess` in the recent-runs panel.
25759
26240
  */
25760
- runtimeState: ScriptRunnerStatusSchema
26241
+ runtimeState: ScriptRunnerStatusSchema,
26242
+ /**
26243
+ * Runtime-state durability: **session** — a restored `isRunning: true` describes a process that died with the previous hub.
26244
+ *
26245
+ * See `RuntimeStateDurability`. Enforced by
26246
+ * `scripts/check-runtime-state-durability.ts`.
26247
+ */
26248
+ durability: "session"
25761
26249
  };
25762
26250
  /**
25763
26251
  * Smoke alarm sensor — boolean "is smoke currently detected" with
@@ -25784,7 +26272,17 @@ var smokeCapability = {
25784
26272
  schema: SmokeStatusSchema,
25785
26273
  kind: "push"
25786
26274
  },
25787
- runtimeState: SmokeStatusSchema
26275
+ runtimeState: SmokeStatusSchema,
26276
+ /**
26277
+ * Runtime-state durability: **restored** — a safety sensor must not read "clear" merely because the hub restarted.
26278
+ *
26279
+ * See `RuntimeStateDurability`. Enforced by
26280
+ * `scripts/check-runtime-state-durability.ts`.
26281
+ */
26282
+ durability: "restored",
26283
+ /** Clock fields: written, but excluded from the compare that decides
26284
+ * whether persisting is worth a SQLite commit. */
26285
+ volatileStateFields: ["lastChangedAt"]
25788
26286
  };
25789
26287
  /**
25790
26288
  * One publishable camera stream as its OWNING PROVIDER describes it — the same
@@ -25970,7 +26468,17 @@ var streamParamsCapability = {
25970
26468
  schema: StreamParamsStatusSchema,
25971
26469
  kind: "poll"
25972
26470
  },
25973
- runtimeState: StreamParamsStatusSchema
26471
+ runtimeState: StreamParamsStatusSchema,
26472
+ /**
26473
+ * Runtime-state durability: **restored** — operator-set encoder profile; mutation-driven.
26474
+ *
26475
+ * See `RuntimeStateDurability`. Enforced by
26476
+ * `scripts/check-runtime-state-durability.ts`.
26477
+ */
26478
+ durability: "restored",
26479
+ /** Clock fields: written, but excluded from the compare that decides
26480
+ * whether persisting is worth a SQLite commit. */
26481
+ volatileStateFields: ["lastFetchedAt"]
25974
26482
  };
25975
26483
  /**
25976
26484
  * Generic on/off switch cap for accessory children (siren, floodlight,
@@ -26016,6 +26524,16 @@ var switchCapability = {
26016
26524
  * not need to re-query the provider after a setState mutation.
26017
26525
  */
26018
26526
  runtimeState: SwitchStatusSchema,
26527
+ /**
26528
+ * Runtime-state durability: **restored** — device state an operator reads as authoritative; 55 devices, transition-driven.
26529
+ *
26530
+ * See `RuntimeStateDurability`. Enforced by
26531
+ * `scripts/check-runtime-state-durability.ts`.
26532
+ */
26533
+ durability: "restored",
26534
+ /** Clock fields: written, but excluded from the compare that decides
26535
+ * whether persisting is worth a SQLite commit. */
26536
+ volatileStateFields: ["lastChangedAt"],
26019
26537
  settings: { bindings: [{
26020
26538
  kind: "scalar",
26021
26539
  statusPath: "on",
@@ -26095,7 +26613,17 @@ var tamperCapability = {
26095
26613
  schema: TamperStatusSchema,
26096
26614
  kind: "push"
26097
26615
  },
26098
- runtimeState: TamperStatusSchema
26616
+ runtimeState: TamperStatusSchema,
26617
+ /**
26618
+ * Runtime-state durability: **restored** — as `smoke`.
26619
+ *
26620
+ * See `RuntimeStateDurability`. Enforced by
26621
+ * `scripts/check-runtime-state-durability.ts`.
26622
+ */
26623
+ durability: "restored",
26624
+ /** Clock fields: written, but excluded from the compare that decides
26625
+ * whether persisting is worth a SQLite commit. */
26626
+ volatileStateFields: ["lastChangedAt"]
26099
26627
  };
26100
26628
  /**
26101
26629
  * Single-metric temperature reading. Drives Home Assistant `sensor`
@@ -26140,7 +26668,17 @@ var temperatureSensorCapability = {
26140
26668
  schema: TemperatureSensorStatusSchema,
26141
26669
  kind: "push"
26142
26670
  },
26143
- runtimeState: TemperatureSensorStatusSchema
26671
+ runtimeState: TemperatureSensorStatusSchema,
26672
+ /**
26673
+ * Runtime-state durability: **restored** — as `numeric-sensor` (69 of 125 writes were the clock alone).
26674
+ *
26675
+ * See `RuntimeStateDurability`. Enforced by
26676
+ * `scripts/check-runtime-state-durability.ts`.
26677
+ */
26678
+ durability: "restored",
26679
+ /** Clock fields: written, but excluded from the compare that decides
26680
+ * whether persisting is worth a SQLite commit. */
26681
+ volatileStateFields: ["lastFetchedAt"]
26144
26682
  };
26145
26683
  /**
26146
26684
  * toast — system-scoped singleton capability that streams toast
@@ -26209,7 +26747,14 @@ var updateCapability = {
26209
26747
  schema: UpdateStatusSchema,
26210
26748
  kind: "poll"
26211
26749
  },
26212
- runtimeState: UpdateStatusSchema
26750
+ runtimeState: UpdateStatusSchema,
26751
+ /**
26752
+ * Runtime-state durability: **session** — a restored `inProgress: true` describes an update that is no longer running; versions are re-probed at boot.
26753
+ *
26754
+ * See `RuntimeStateDurability`. Enforced by
26755
+ * `scripts/check-runtime-state-durability.ts`.
26756
+ */
26757
+ durability: "session"
26213
26758
  };
26214
26759
  var UserSummarySchema = object({
26215
26760
  id: string(),
@@ -26543,7 +27088,14 @@ var vacuumControlCapability = {
26543
27088
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
26544
27089
  * slice for live state + battery + fan-speed changes.
26545
27090
  */
26546
- runtimeState: VacuumControlStatusSchema
27091
+ runtimeState: VacuumControlStatusSchema,
27092
+ /**
27093
+ * Runtime-state durability: **session** — as `media-player` — a restored `state: cleaning` is a robot that is not cleaning.
27094
+ *
27095
+ * See `RuntimeStateDurability`. Enforced by
27096
+ * `scripts/check-runtime-state-durability.ts`.
27097
+ */
27098
+ durability: "session"
26547
27099
  };
26548
27100
  var ValveStatusSchema = object({
26549
27101
  /** Lifecycle state of the valve. */
@@ -26595,7 +27147,14 @@ var valveCapability = {
26595
27147
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
26596
27148
  * slice for live position changes during a move.
26597
27149
  */
26598
- runtimeState: ValveStatusSchema
27150
+ runtimeState: ValveStatusSchema,
27151
+ /**
27152
+ * Runtime-state durability: **session** — as `brightness`.
27153
+ *
27154
+ * See `RuntimeStateDurability`. Enforced by
27155
+ * `scripts/check-runtime-state-durability.ts`.
27156
+ */
27157
+ durability: "session"
26599
27158
  };
26600
27159
  /**
26601
27160
  * Vibration / shake / impact sensor. Drives Home Assistant
@@ -26617,7 +27176,17 @@ var vibrationCapability = {
26617
27176
  schema: VibrationStatusSchema,
26618
27177
  kind: "push"
26619
27178
  },
26620
- runtimeState: VibrationStatusSchema
27179
+ runtimeState: VibrationStatusSchema,
27180
+ /**
27181
+ * Runtime-state durability: **restored** — as `smoke`.
27182
+ *
27183
+ * See `RuntimeStateDurability`. Enforced by
27184
+ * `scripts/check-runtime-state-durability.ts`.
27185
+ */
27186
+ durability: "restored",
27187
+ /** Clock fields: written, but excluded from the compare that decides
27188
+ * whether persisting is worth a SQLite commit. */
27189
+ volatileStateFields: ["lastChangedAt"]
26621
27190
  };
26622
27191
  /**
26623
27192
  * Water heater / boiler cap. Models HA `water_heater.*` entities — a
@@ -26691,7 +27260,14 @@ var waterHeaterCapability = {
26691
27260
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
26692
27261
  * slice for live temperature / mode / away changes.
26693
27262
  */
26694
- runtimeState: WaterHeaterStatusSchema
27263
+ runtimeState: WaterHeaterStatusSchema,
27264
+ /**
27265
+ * Runtime-state durability: **session** — as `climate-control`.
27266
+ *
27267
+ * See `RuntimeStateDurability`. Enforced by
27268
+ * `scripts/check-runtime-state-durability.ts`.
27269
+ */
27270
+ durability: "session"
26695
27271
  };
26696
27272
  /**
26697
27273
  * Weather provider cap. Models HA `weather.*` entities — a read-only
@@ -26750,7 +27326,14 @@ var weatherCapability = {
26750
27326
  * Runtime-state slice — mirrored by the kernel. The UI reads the
26751
27327
  * current conditions directly from the slice on each weather push.
26752
27328
  */
26753
- runtimeState: WeatherStatusSchema
27329
+ runtimeState: WeatherStatusSchema,
27330
+ /**
27331
+ * Runtime-state durability: **session** — a forecast is stale the moment the hub is down; the provider re-fetches on connect.
27332
+ *
27333
+ * See `RuntimeStateDurability`. Enforced by
27334
+ * `scripts/check-runtime-state-durability.ts`.
27335
+ */
27336
+ durability: "session"
26754
27337
  };
26755
27338
  /**
26756
27339
  * Per-zone occupancy aggregation produced by the analytics frame
@@ -26912,7 +27495,14 @@ var zoneAnalyticsCapability = {
26912
27495
  * automatically; the explicit `getCurrentSnapshot` cap method is
26913
27496
  * still useful for one-off polls without a subscription.
26914
27497
  */
26915
- runtimeState: CameraOccupancySnapshotSchema
27498
+ runtimeState: CameraOccupancySnapshotSchema,
27499
+ /**
27500
+ * Runtime-state durability: **session** — per-frame analytics; with `audio-metrics` it is ~90 % of the offered write rate. Re-derived on the next frame.
27501
+ *
27502
+ * See `RuntimeStateDurability`. Enforced by
27503
+ * `scripts/check-runtime-state-durability.ts`.
27504
+ */
27505
+ durability: "session"
26916
27506
  };
26917
27507
  /**
26918
27508
  * Stages a {@link ZoneRule} can apply to. Discriminator on the rules
@@ -26990,7 +27580,14 @@ var zoneRulesCapability = {
26990
27580
  motion: array(ZoneRuleSchema).readonly(),
26991
27581
  detection: array(ZoneRuleSchema).readonly(),
26992
27582
  package: array(ZoneRuleSchema).readonly()
26993
- })
27583
+ }),
27584
+ /**
27585
+ * Runtime-state durability: **restored** — operator intent, mutation-only, same argument as `zones`.
27586
+ *
27587
+ * See `RuntimeStateDurability`. Enforced by
27588
+ * `scripts/check-runtime-state-durability.ts`.
27589
+ */
27590
+ durability: "restored"
26994
27591
  };
26995
27592
  /**
26996
27593
  * Accessory device helpers — shared across drivers.
@@ -33677,6 +34274,7 @@ Object.freeze({
33677
34274
  "network-access": "ingress",
33678
34275
  "smtp-provider": "email"
33679
34276
  });
34277
+ new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
33680
34278
  new Set(["devices", "classes"]);
33681
34279
  /**
33682
34280
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
@@ -33954,25 +34552,32 @@ object({
33954
34552
  var NativeLeaseAdmissionSchema = _enum(["all", "inferred"]);
33955
34553
  object({
33956
34554
  /**
33957
- * How long a retained native frame is served before it counts as a miss.
34555
+ * How many delivered frames the worker HOLDS at once, waiting for each one's
34556
+ * detection result.
33958
34557
  *
33959
- * Must cover the FULL late-crop horizon: detection inference + the
33960
- * cross-process inference-result hop to hub post-analysis + tracking + the
33961
- * tRPC crop round-trip back. Below ~500 ms the busiest cameras' subject crops
33962
- * outrun it and fall back to the ≤640 detection frame; above ~3 s the resident
33963
- * RAM per busy camera grows linearly with no measured hit-rate gain.
34558
+ * This replaced a TTL on 2026-08-13, and the replacement is the whole point:
34559
+ * a time window was never related to the event the pixels were waiting for.
34560
+ * A held frame now lives from delivery until the runner has its `FrameResult`
34561
+ * at which moment the runner cuts the subject tiles it actually wanted and
34562
+ * releases the frame. The bound exists only so a runner that stops answering
34563
+ * cannot pin RAM: above it the OLDEST held frame is dropped and counted.
34564
+ *
34565
+ * Sizing: the steady state is `inferenceLatency × deliveredFps`, measured at
34566
+ * 40-160 ms × ≤25 fps = 1-4 frames. The default leaves headroom for a hiccup
34567
+ * without ever approaching the old resident set (43 frames × 24.9 MB at 4K).
34568
+ * Raising it does not buy hit rate — it buys tolerance for a slow runner, and
34569
+ * `holdOverflow` on the metrics line is what says you need it.
33964
34570
  */
33965
- ttlMs: number().int().min(250).max(1e4),
34571
+ holdFrames: number().int().min(1).max(64),
33966
34572
  /**
33967
34573
  * Hard per-decode-worker RAM ceiling for retained native frames, in MB.
33968
34574
  *
33969
- * Intended as a SAFETY ceiling with the TTL as the effective cap — but check
33970
- * which one is actually binding before reasoning from that. At the shipped
33971
- * 1024 MB and a 2 800 ms TTL, a 4K camera hits the CEILING first (~43 frames
33972
- * at ~24 MB each) and the TTL never gets to expire anything; `leaseMb` /
33973
- * `leaseFrames` on the metrics line say which. When the ceiling binds, a
33974
- * change that admits fewer frames buys retention WINDOW at constant RAM
33975
- * rather than giving RAM back — lower this knob if RAM is what you wanted.
34575
+ * Since 2026-08-13 this is a SAFETY ceiling and nothing else: `holdFrames`
34576
+ * is what decides how much is held, and the ceiling is the number above which
34577
+ * something is wrong. Before that it was the effective cap at 1024 MB with
34578
+ * a 2 800 ms TTL a 4K camera sat pinned at `leaseMb:1020, leaseFrames:43`
34579
+ * with the TTL expiring nothing, which is exactly the confusion the hold
34580
+ * removes. `leaseMb` / `leaseFrames` still say what is resident.
33976
34581
  * `0` DISABLES the lease entirely and falls the worker back to the tiny
33977
34582
  * leak-prone GPU surface ring (~85% crop miss; that is what the lease exists
33978
34583
  * to replace).
@@ -33998,22 +34603,45 @@ object({
33998
34603
  * there is the signal that some caller names frames outside the inference set
33999
34604
  * and that this must go back to `all`.
34000
34605
  */
34001
- admission: NativeLeaseAdmissionSchema
34606
+ admission: NativeLeaseAdmissionSchema,
34607
+ /**
34608
+ * RAM ceiling per decode worker, in MB, for the SUBJECT TILES — the
34609
+ * compressed native crops the worker cuts at the moment a frame's detection
34610
+ * result arrives, and keeps long after the frame itself is freed.
34611
+ *
34612
+ * This is the knob that replaced the old retention window, and it buys about
34613
+ * three orders of magnitude more of it: a tile is one subject at native
34614
+ * resolution, JPEG-encoded (~60-120 KB on a 4K person), against ~24.9 MB for
34615
+ * the frame it was cut from. A frame on which nothing was detected costs
34616
+ * nothing at all, which is the real change — the old lease paid per FRAME and
34617
+ * was interrogated per SUBJECT.
34618
+ *
34619
+ * `0` DISABLES tiles, leaving only the hold window and the ≤640 RAM
34620
+ * fallback — i.e. the pre-2026-08-13 miss profile. Set it there only to
34621
+ * reproduce that.
34622
+ */
34623
+ tileBudgetMb: number().int().min(0).max(1024)
34002
34624
  });
34003
34625
  /**
34004
- * The values in force when the operator has set nothing — byte-for-byte the
34005
- * constants the decode worker shipped with as env-var defaults, so making these
34006
- * settings changed no behaviour on the day it landed.
34626
+ * The values in force when the operator has set nothing.
34627
+ *
34628
+ * `budgetMb` stays at 1024 on the day the hold landed, deliberately: it stopped
34629
+ * being the retention window and became the OOM ceiling, and lowering a ceiling
34630
+ * in the same change that redefines it would make a regression and a retune
34631
+ * indistinguishable. Cut it once `tileHits` / `holdOverflow` have been read on
34632
+ * live traffic.
34007
34633
  */
34008
34634
  var DEFAULT_NATIVE_LEASE_SETTINGS = {
34009
- ttlMs: 1200,
34635
+ holdFrames: 8,
34010
34636
  budgetMb: 1024,
34011
34637
  activityMs: 15e3,
34638
+ tileBudgetMb: 64,
34012
34639
  admission: "inferred"
34013
34640
  };
34014
- DEFAULT_NATIVE_LEASE_SETTINGS.ttlMs;
34641
+ DEFAULT_NATIVE_LEASE_SETTINGS.holdFrames;
34015
34642
  DEFAULT_NATIVE_LEASE_SETTINGS.budgetMb;
34016
34643
  DEFAULT_NATIVE_LEASE_SETTINGS.activityMs;
34644
+ DEFAULT_NATIVE_LEASE_SETTINGS.tileBudgetMb;
34017
34645
  DEFAULT_NATIVE_LEASE_SETTINGS.admission;
34018
34646
  //#endregion
34019
34647
  //#region ../../node_modules/@apocaliss92/wyze-bridge-js/dist/index.js