@camstack/addon-provider-hikvision 1.2.17 → 1.2.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 +723 -95
  2. package/dist/addon.mjs +723 -95
  3. package/package.json +1 -1
package/dist/addon.js CHANGED
@@ -10927,7 +10927,14 @@ var cameraStreamsCapability = {
10927
10927
  low: string().optional()
10928
10928
  }),
10929
10929
  lastChangedAt: number()
10930
- })
10930
+ }),
10931
+ /**
10932
+ * 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.
10933
+ *
10934
+ * See `RuntimeStateDurability`. Enforced by
10935
+ * `scripts/check-runtime-state-durability.ts`.
10936
+ */
10937
+ durability: "session"
10931
10938
  };
10932
10939
  /** Where a block runs. The operator chooses — a block driving a device on an
10933
10940
  * agent is the reason placement is not fixed to the hub. */
@@ -11500,6 +11507,13 @@ var deviceDiscoveryCapability = {
11500
11507
  kind: "poll"
11501
11508
  },
11502
11509
  runtimeState: DeviceDiscoveryStatusSchema.extend({ lastFetchedAt: number().int().nonnegative() }),
11510
+ /**
11511
+ * Runtime-state durability: **session** — 5.7 KB of scan output on the largest device, fully re-derivable by re-scanning.
11512
+ *
11513
+ * See `RuntimeStateDurability`. Enforced by
11514
+ * `scripts/check-runtime-state-durability.ts`.
11515
+ */
11516
+ durability: "session",
11503
11517
  methods: {
11504
11518
  /**
11505
11519
  * Snapshot of the current `discovered` list. Returns the
@@ -13399,7 +13413,23 @@ var NotificationActionSchema = object({
13399
13413
  * else — see `notification-center/action-token.ts` for what that does and
13400
13414
  * does not buy.
13401
13415
  */
13402
- destructive: boolean().optional()
13416
+ destructive: boolean().optional(),
13417
+ /**
13418
+ * How the tap should REACH the url.
13419
+ *
13420
+ * `navigate` (absent, and every button authored before this field) opens it:
13421
+ * the phone leaves the notification and shows whatever the callback returns.
13422
+ * That is right for a button whose answer the operator wants to read.
13423
+ *
13424
+ * `background` fires it as a POST and stays put. It exists for the buttons
13425
+ * whose whole point is not to interrupt — "silence this for 30 minutes" is
13426
+ * an answer to the notification, and being thrown into a browser tab to
13427
+ * confirm it costs more attention than the notification did. A backend that
13428
+ * cannot do a background call renders it as an ordinary link (the adapters
13429
+ * fall back rather than dropping the button), so this is a preference, never
13430
+ * a requirement.
13431
+ */
13432
+ mode: _enum(["navigate", "background"]).optional()
13403
13433
  });
13404
13434
  /**
13405
13435
  * The canonical notification. `body` is the only hard field (Apprise model).
@@ -14251,7 +14281,17 @@ var alarmPanelCapability = {
14251
14281
  * full slice; renders an arm button per `availableModes` entry and
14252
14282
  * a PIN field iff `requiresCode === true`.
14253
14283
  */
14254
- runtimeState: AlarmPanelStatusSchema
14284
+ runtimeState: AlarmPanelStatusSchema,
14285
+ /**
14286
+ * Runtime-state durability: **restored** — armed state is the one thing a panel must not lose across a restart.
14287
+ *
14288
+ * See `RuntimeStateDurability`. Enforced by
14289
+ * `scripts/check-runtime-state-durability.ts`.
14290
+ */
14291
+ durability: "restored",
14292
+ /** Clock fields: written, but excluded from the compare that decides
14293
+ * whether persisting is worth a SQLite commit. */
14294
+ volatileStateFields: ["lastChangedAt"]
14255
14295
  };
14256
14296
  /**
14257
14297
  * Shared geometry vocabulary for on-frame shape caps — privacy-mask,
@@ -14428,6 +14468,9 @@ var NcSystemEventConditionSchema = object({
14428
14468
  nodeIds: array(string().min(1)).min(1).optional(),
14429
14469
  packageNames: array(string().min(1)).min(1).optional()
14430
14470
  });
14471
+ /** Hard ceiling on a window (24h). A snooze that could not expire would be an
14472
+ * outage the operator asked for once and forgot. */
14473
+ var NC_SNOOZE_MAX_MINUTES = 1440;
14431
14474
  /** Weekly schedule — OR of windows; absence on the rule = always active. */
14432
14475
  var NcScheduleSchema = object({
14433
14476
  windows: array(object({
@@ -14804,15 +14847,15 @@ var NcConditionsSchema = object({
14804
14847
  * (an `immediate` rule naming an `audio-*` class, one notification per
14805
14848
  * classified sample) stays exactly as it was for rules that already use it.
14806
14849
  *
14807
- * NOT in {@link NC_CONDITION_CATALOG} yet, and that is the sequencing rule
14808
- * rather than an oversight: the viewer mirrors the descriptor enums BY HAND
14809
- * (`camstack/src/data/notification-center.ts`, guarded by
14810
- * `scripts/check-viewer-condition-mirror.ts`) and its rule editor STRIPS the
14850
+ * In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
14851
+ * rule rather than an accident: the viewer mirrors the descriptor enums BY
14852
+ * HAND (`camstack/src/data/notification-center.ts`, guarded by
14853
+ * `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
14811
14854
  * condition fields it does not know when a rule is saved from the phone.
14812
14855
  * Publishing an editor for a condition the app cannot round-trip is how an
14813
- * operator loses a rule's conditions by opening it — so the descriptor, the
14814
- * admin widget and the viewer mirror land together (P2 + P3), and only then
14815
- * does an audio rule become authorable.
14856
+ * operator loses a rule's conditions by opening it — so the viewer mirror
14857
+ * (P3, shipped) went FIRST, and the descriptor an editor renders from
14858
+ * follows here.
14816
14859
  */
14817
14860
  audio: NcAudioConditionSchema.optional()
14818
14861
  });
@@ -15048,6 +15091,30 @@ var NcRuleInputSchema = object({
15048
15091
  */
15049
15092
  snoozeAllowGlobal: boolean().optional(),
15050
15093
  /**
15094
+ * The snooze durations THIS rule's notification offers as buttons, in
15095
+ * minutes.
15096
+ *
15097
+ * Three states, and all three are distinct — which is exactly why this is
15098
+ * `.optional()` and never `.default()`. A Zod default does not run on the
15099
+ * addon cap path (three production failures in one day), so a schema default
15100
+ * would collapse the first two:
15101
+ *
15102
+ * | value | meaning |
15103
+ * | --- | --- |
15104
+ * | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
15105
+ * | `[]` | **no snooze buttons on this rule** — the explicit override |
15106
+ * | a list | these choices, de-duplicated and sorted, at most four |
15107
+ *
15108
+ * `.max(4)` because the notifier's own action budget is small (ntfy allows
15109
+ * three buttons in total) and a rule that spent it all on snooze choices
15110
+ * would push its own tap-through actions off the notification.
15111
+ *
15112
+ * An empty list is NOT an alarm exemption: a rule the alarm is about, or
15113
+ * that arms the panel, is exempt automatically and cannot be silenced by a
15114
+ * window from anywhere (D133).
15115
+ */
15116
+ snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
15117
+ /**
15051
15118
  * Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
15052
15119
  *
15053
15120
  * This is what makes the rule set the alarm's trigger set without the alarm
@@ -15147,6 +15214,7 @@ var NcConditionDescriptorSchema = object({
15147
15214
  "device",
15148
15215
  "package",
15149
15216
  "occupancy",
15217
+ "audio",
15150
15218
  "system"
15151
15219
  ]),
15152
15220
  label: string(),
@@ -15165,6 +15233,7 @@ var NcConditionDescriptorSchema = object({
15165
15233
  "crossingSelect",
15166
15234
  "polygonDraw",
15167
15235
  "occupancy",
15236
+ "audio",
15168
15237
  "deviceState",
15169
15238
  "systemEvent"
15170
15239
  ]),
@@ -15316,7 +15385,20 @@ var NcSnoozeInputSchema = object({
15316
15385
  ruleId: string().optional(),
15317
15386
  /** Required when `scope: 'device'`. */
15318
15387
  deviceId: number().int().optional(),
15319
- durationMinutes: number().int().min(1).max(1440),
15388
+ /**
15389
+ * Narrow the window to these subject classes — "the cat, not the person".
15390
+ *
15391
+ * ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
15392
+ * what every window authored before this field meant, so no persisted row
15393
+ * changes meaning and no client has to learn anything to keep working.
15394
+ *
15395
+ * It is what makes the window's real key `(deviceId, classes[])` and lets it
15396
+ * cross rules (D133): the operator points at a camera and a kind of thing,
15397
+ * not at whichever of their four rules happened to produce the notification
15398
+ * they are dismissing.
15399
+ */
15400
+ classes: array(string().min(1)).min(1).optional(),
15401
+ durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
15320
15402
  /**
15321
15403
  * Silence this for EVERY recipient, not just the caller. Permission is
15322
15404
  * checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
@@ -15341,6 +15423,10 @@ var NcSnoozeSchema = object({
15341
15423
  scope: NcSnoozeScopeSchema,
15342
15424
  ruleId: string().optional(),
15343
15425
  deviceId: number().int().optional(),
15426
+ /** Subject classes this window covers. ABSENT = every class — see
15427
+ * {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
15428
+ * no SQLite column: nothing queries a window by class. */
15429
+ classes: array(string().min(1)).min(1).optional(),
15344
15430
  startedAt: number(),
15345
15431
  /** Exclusive: at exactly this instant the snooze is over. Expiry is a
15346
15432
  * COMPARISON, not a job — no sweeper can leave the operator silenced. */
@@ -17441,7 +17527,14 @@ var zonesCapability = {
17441
17527
  * handle. Slice shape is `{ zones: Zone[] }` so future extensions
17442
17528
  * (e.g. zone groupings) can sit alongside the polygon list.
17443
17529
  */
17444
- runtimeState: object({ zones: array(ZoneSchema).readonly() })
17530
+ runtimeState: object({ zones: array(ZoneSchema).readonly() }),
17531
+ /**
17532
+ * 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.
17533
+ *
17534
+ * See `RuntimeStateDurability`. Enforced by
17535
+ * `scripts/check-runtime-state-durability.ts`.
17536
+ */
17537
+ durability: "restored"
17445
17538
  };
17446
17539
  /**
17447
17540
  * A bounding box in NORMALIZED [0,1] frame coordinates for `getNativeCrop`. The
@@ -20335,7 +20428,17 @@ var airQualitySensorCapability = {
20335
20428
  schema: AirQualitySensorStatusSchema,
20336
20429
  kind: "push"
20337
20430
  },
20338
- runtimeState: AirQualitySensorStatusSchema
20431
+ runtimeState: AirQualitySensorStatusSchema,
20432
+ /**
20433
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
20434
+ *
20435
+ * See `RuntimeStateDurability`. Enforced by
20436
+ * `scripts/check-runtime-state-durability.ts`.
20437
+ */
20438
+ durability: "restored",
20439
+ /** Clock fields: written, but excluded from the compare that decides
20440
+ * whether persisting is worth a SQLite commit. */
20441
+ volatileStateFields: ["lastFetchedAt"]
20339
20442
  };
20340
20443
  /**
20341
20444
  * Ambient illuminance reading in lux. Drives Home Assistant `sensor`
@@ -20367,7 +20470,17 @@ var ambientLightSensorCapability = {
20367
20470
  schema: AmbientLightSensorStatusSchema,
20368
20471
  kind: "push"
20369
20472
  },
20370
- runtimeState: AmbientLightSensorStatusSchema
20473
+ runtimeState: AmbientLightSensorStatusSchema,
20474
+ /**
20475
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
20476
+ *
20477
+ * See `RuntimeStateDurability`. Enforced by
20478
+ * `scripts/check-runtime-state-durability.ts`.
20479
+ */
20480
+ durability: "restored",
20481
+ /** Clock fields: written, but excluded from the compare that decides
20482
+ * whether persisting is worth a SQLite commit. */
20483
+ volatileStateFields: ["lastFetchedAt"]
20371
20484
  };
20372
20485
  /**
20373
20486
  * Per-class audio metrics aggregated over a sliding window.
@@ -20485,7 +20598,14 @@ var audioMetricsCapability = {
20485
20598
  }), AudioMetricsHistorySchema)
20486
20599
  },
20487
20600
  /** Reactive runtime-state mirror — live `device.state.audioMetrics.value`. */
20488
- runtimeState: AudioMetricsSnapshotSchema
20601
+ runtimeState: AudioMetricsSnapshotSchema,
20602
+ /**
20603
+ * 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.
20604
+ *
20605
+ * See `RuntimeStateDurability`. Enforced by
20606
+ * `scripts/check-runtime-state-durability.ts`.
20607
+ */
20608
+ durability: "session"
20489
20609
  };
20490
20610
  /**
20491
20611
  * Automation-control cap. Models HA `automation.*` entities on
@@ -20547,7 +20667,14 @@ var automationControlCapability = {
20547
20667
  * reads `enabled` (toggle) + `isRunning` (spinner) + `lastError`
20548
20668
  * (badge) directly.
20549
20669
  */
20550
- runtimeState: AutomationControlStatusSchema
20670
+ runtimeState: AutomationControlStatusSchema,
20671
+ /**
20672
+ * 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.
20673
+ *
20674
+ * See `RuntimeStateDurability`. Enforced by
20675
+ * `scripts/check-runtime-state-durability.ts`.
20676
+ */
20677
+ durability: "session"
20551
20678
  };
20552
20679
  /**
20553
20680
  * Battery status snapshot. Emitted by providers whose device is
@@ -20653,7 +20780,17 @@ onStatusChanged: { data: object({
20653
20780
  * via `device.runtimeState.getCapState('battery')` regardless of
20654
20781
  * the underlying driver.
20655
20782
  */
20656
- runtimeState: BatteryStatusSchema
20783
+ runtimeState: BatteryStatusSchema,
20784
+ /**
20785
+ * 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.
20786
+ *
20787
+ * See `RuntimeStateDurability`. Enforced by
20788
+ * `scripts/check-runtime-state-durability.ts`.
20789
+ */
20790
+ durability: "restored",
20791
+ /** Clock fields: written, but excluded from the compare that decides
20792
+ * whether persisting is worth a SQLite commit. */
20793
+ volatileStateFields: ["lastUpdated"]
20657
20794
  };
20658
20795
  /**
20659
20796
  * Generic boolean sensor — last-resort fallback when no domain-
@@ -20682,7 +20819,17 @@ var binaryCapability = {
20682
20819
  schema: BinaryStatusSchema,
20683
20820
  kind: "push"
20684
20821
  },
20685
- runtimeState: BinaryStatusSchema
20822
+ runtimeState: BinaryStatusSchema,
20823
+ /**
20824
+ * Runtime-state durability: **restored** — transition-driven sensor state; the restored value gives the boot comparison.
20825
+ *
20826
+ * See `RuntimeStateDurability`. Enforced by
20827
+ * `scripts/check-runtime-state-durability.ts`.
20828
+ */
20829
+ durability: "restored",
20830
+ /** Clock fields: written, but excluded from the compare that decides
20831
+ * whether persisting is worth a SQLite commit. */
20832
+ volatileStateFields: ["lastChangedAt"]
20686
20833
  };
20687
20834
  /**
20688
20835
  * Dimmable-light brightness control. Co-exists with `switch` on the
@@ -20735,7 +20882,14 @@ onBrightnessChanged: { data: object({
20735
20882
  * by the kernel. Read via `device.state.brightness.value` so UI
20736
20883
  * sliders surface the current level without polling the provider.
20737
20884
  */
20738
- runtimeState: BrightnessStatusSchema
20885
+ runtimeState: BrightnessStatusSchema,
20886
+ /**
20887
+ * Runtime-state durability: **session** — live lamp state, re-published by the provider on connect.
20888
+ *
20889
+ * See `RuntimeStateDurability`. Enforced by
20890
+ * `scripts/check-runtime-state-durability.ts`.
20891
+ */
20892
+ durability: "session"
20739
20893
  };
20740
20894
  DeviceType.Button, method(object({ deviceId: number().int().nonnegative() }), _void(), {
20741
20895
  kind: "mutation",
@@ -20823,7 +20977,17 @@ var carbonMonoxideCapability = {
20823
20977
  schema: CarbonMonoxideStatusSchema,
20824
20978
  kind: "push"
20825
20979
  },
20826
- runtimeState: CarbonMonoxideStatusSchema
20980
+ runtimeState: CarbonMonoxideStatusSchema,
20981
+ /**
20982
+ * Runtime-state durability: **restored** — as `smoke`.
20983
+ *
20984
+ * See `RuntimeStateDurability`. Enforced by
20985
+ * `scripts/check-runtime-state-durability.ts`.
20986
+ */
20987
+ durability: "restored",
20988
+ /** Clock fields: written, but excluded from the compare that decides
20989
+ * whether persisting is worth a SQLite commit. */
20990
+ volatileStateFields: ["lastChangedAt"]
20827
20991
  };
20828
20992
  /**
20829
20993
  * HVAC / climate control cap. Models the full surface of a HA
@@ -20983,7 +21147,14 @@ var climateControlCapability = {
20983
21147
  * the full slice via `device.state.climate-control.value` and refresh
20984
21148
  * on every push without re-querying the provider.
20985
21149
  */
20986
- runtimeState: ClimateControlStatusSchema
21150
+ runtimeState: ClimateControlStatusSchema,
21151
+ /**
21152
+ * Runtime-state durability: **session** — as `brightness`; `currentTemp` moves continuously and is re-published on connect.
21153
+ *
21154
+ * See `RuntimeStateDurability`. Enforced by
21155
+ * `scripts/check-runtime-state-durability.ts`.
21156
+ */
21157
+ durability: "session"
20987
21158
  };
20988
21159
  /**
20989
21160
  * Color-light cap. Coexists with `switch` (on/off) and `brightness`
@@ -21093,7 +21264,14 @@ onColorChanged: { data: object({
21093
21264
  * kernel. Read via `device.state.color.value` so UI pickers surface
21094
21265
  * the current chromaticity without polling the provider.
21095
21266
  */
21096
- runtimeState: ColorStatusSchema
21267
+ runtimeState: ColorStatusSchema,
21268
+ /**
21269
+ * Runtime-state durability: **session** — as `brightness`.
21270
+ *
21271
+ * See `RuntimeStateDurability`. Enforced by
21272
+ * `scripts/check-runtime-state-durability.ts`.
21273
+ */
21274
+ durability: "session"
21097
21275
  };
21098
21276
  var ConnectionTestOutcomeSchema = discriminatedUnion("outcome", [
21099
21277
  object({
@@ -21151,7 +21329,17 @@ var connectivityCapability = {
21151
21329
  schema: ConnectivityStatusSchema,
21152
21330
  kind: "push"
21153
21331
  },
21154
- runtimeState: ConnectivityStatusSchema
21332
+ runtimeState: ConnectivityStatusSchema,
21333
+ /**
21334
+ * Runtime-state durability: **restored** — same shape and same argument as `device-status`, for links rather than devices.
21335
+ *
21336
+ * See `RuntimeStateDurability`. Enforced by
21337
+ * `scripts/check-runtime-state-durability.ts`.
21338
+ */
21339
+ durability: "restored",
21340
+ /** Clock fields: written, but excluded from the compare that decides
21341
+ * whether persisting is worth a SQLite commit. */
21342
+ volatileStateFields: ["lastChangedAt"]
21155
21343
  };
21156
21344
  /**
21157
21345
  * Generic device-consumables capability — surfaces a device's
@@ -21233,7 +21421,14 @@ reset: method(object({
21233
21421
  }
21234
21422
  }
21235
21423
  },
21236
- runtimeState: ConsumablesStatusSchema.extend({ lastFetchedAt: number() })
21424
+ runtimeState: ConsumablesStatusSchema.extend({ lastFetchedAt: number() }),
21425
+ /**
21426
+ * Runtime-state durability: **session** — the authority is the appliance; the provider re-reads the whole item array on connect.
21427
+ *
21428
+ * See `RuntimeStateDurability`. Enforced by
21429
+ * `scripts/check-runtime-state-durability.ts`.
21430
+ */
21431
+ durability: "session"
21237
21432
  };
21238
21433
  /**
21239
21434
  * Door / window / opening / garage / valve contact sensor. Boolean
@@ -21264,7 +21459,17 @@ var contactCapability = {
21264
21459
  schema: ContactStatusSchema,
21265
21460
  kind: "push"
21266
21461
  },
21267
- runtimeState: ContactStatusSchema
21462
+ runtimeState: ContactStatusSchema,
21463
+ /**
21464
+ * Runtime-state durability: **restored** — a door left open across a restart must still read open.
21465
+ *
21466
+ * See `RuntimeStateDurability`. Enforced by
21467
+ * `scripts/check-runtime-state-durability.ts`.
21468
+ */
21469
+ durability: "restored",
21470
+ /** Clock fields: written, but excluded from the compare that decides
21471
+ * whether persisting is worth a SQLite commit. */
21472
+ volatileStateFields: ["lastChangedAt"]
21268
21473
  };
21269
21474
  /**
21270
21475
  * Status slice — flat object (the framework's `runtimeState` contract
@@ -21370,7 +21575,14 @@ var controlCapability = {
21370
21575
  * dropdown / text field / date picker) read the slice's discriminant
21371
21576
  * and value directly without polling the provider.
21372
21577
  */
21373
- runtimeState: ControlStatusSchema
21578
+ runtimeState: ControlStatusSchema,
21579
+ /**
21580
+ * Runtime-state durability: **session** — a generic control mirrors an external entity that re-publishes on connect; the options array is re-derived with it.
21581
+ *
21582
+ * See `RuntimeStateDurability`. Enforced by
21583
+ * `scripts/check-runtime-state-durability.ts`.
21584
+ */
21585
+ durability: "session"
21374
21586
  };
21375
21587
  var CoverStatusSchema = object({
21376
21588
  /** Lifecycle state of the cover. */
@@ -21431,7 +21643,17 @@ var coverCapability = {
21431
21643
  * Runtime-state slice — mirrored by the kernel. UI controls watch
21432
21644
  * the slice for live position changes during a move.
21433
21645
  */
21434
- runtimeState: CoverStatusSchema
21646
+ runtimeState: CoverStatusSchema,
21647
+ /**
21648
+ * Runtime-state durability: **restored** — position survives a restart on the device; the mirror should agree at boot rather than read blank.
21649
+ *
21650
+ * See `RuntimeStateDurability`. Enforced by
21651
+ * `scripts/check-runtime-state-durability.ts`.
21652
+ */
21653
+ durability: "restored",
21654
+ /** Clock fields: written, but excluded from the compare that decides
21655
+ * whether persisting is worth a SQLite commit. */
21656
+ volatileStateFields: ["lastChangedAt"]
21435
21657
  };
21436
21658
  /**
21437
21659
  * Vendor-neutral day/night (IR-cut) control — the per-camera config cap
@@ -21525,7 +21747,17 @@ var dayNightCapability = {
21525
21747
  schema: DayNightStatusSchema,
21526
21748
  kind: "poll"
21527
21749
  },
21528
- runtimeState: DayNightStatusSchema
21750
+ runtimeState: DayNightStatusSchema,
21751
+ /**
21752
+ * Runtime-state durability: **restored** — operator-set IR-cut behaviour; mutation-driven.
21753
+ *
21754
+ * See `RuntimeStateDurability`. Enforced by
21755
+ * `scripts/check-runtime-state-durability.ts`.
21756
+ */
21757
+ durability: "restored",
21758
+ /** Clock fields: written, but excluded from the compare that decides
21759
+ * whether persisting is worth a SQLite commit. */
21760
+ volatileStateFields: ["lastFetchedAt"]
21529
21761
  };
21530
21762
  /**
21531
21763
  * Generic device-level status snapshot. Auto-registered by `BaseDevice`
@@ -21572,7 +21804,17 @@ onStatusChanged: { data: object({
21572
21804
  schema: DeviceStatusSchema,
21573
21805
  kind: "push"
21574
21806
  },
21575
- runtimeState: DeviceStatusSchema
21807
+ runtimeState: DeviceStatusSchema,
21808
+ /**
21809
+ * 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.
21810
+ *
21811
+ * See `RuntimeStateDurability`. Enforced by
21812
+ * `scripts/check-runtime-state-durability.ts`.
21813
+ */
21814
+ durability: "restored",
21815
+ /** Clock fields: written, but excluded from the compare that decides
21816
+ * whether persisting is worth a SQLite commit. */
21817
+ volatileStateFields: ["lastChangedAt"]
21576
21818
  };
21577
21819
  /**
21578
21820
  * Doorbell button cap. Two kinds of providers coexist behind this cap
@@ -21634,7 +21876,14 @@ onPressed: { data: DoorbellPressEventSchema } },
21634
21876
  * `device.state.doorbell.value`. UIs can show "last ring 5m ago"
21635
21877
  * without subscribing.
21636
21878
  */
21637
- runtimeState: DoorbellStatusSchema
21879
+ runtimeState: DoorbellStatusSchema,
21880
+ /**
21881
+ * 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.
21882
+ *
21883
+ * See `RuntimeStateDurability`. Enforced by
21884
+ * `scripts/check-runtime-state-durability.ts`.
21885
+ */
21886
+ durability: "restored"
21638
21887
  };
21639
21888
  /**
21640
21889
  * Enum-state sensor — a string value picked from a finite option set.
@@ -21674,7 +21923,17 @@ var enumSensorCapability = {
21674
21923
  schema: EnumSensorStatusSchema,
21675
21924
  kind: "push"
21676
21925
  },
21677
- runtimeState: EnumSensorStatusSchema
21926
+ runtimeState: EnumSensorStatusSchema,
21927
+ /**
21928
+ * Runtime-state durability: **restored** — as `numeric-sensor`; 80 devices.
21929
+ *
21930
+ * See `RuntimeStateDurability`. Enforced by
21931
+ * `scripts/check-runtime-state-durability.ts`.
21932
+ */
21933
+ durability: "restored",
21934
+ /** Clock fields: written, but excluded from the compare that decides
21935
+ * whether persisting is worth a SQLite commit. */
21936
+ volatileStateFields: ["lastFetchedAt"]
21678
21937
  };
21679
21938
  /**
21680
21939
  * Generic stateless event emitter. Installed on a `DeviceType.EventEmitter`
@@ -21710,7 +21969,14 @@ var eventEmitterCapability = {
21710
21969
  schema: EventEmitterStatusSchema,
21711
21970
  kind: "push"
21712
21971
  },
21713
- runtimeState: EventEmitterStatusSchema
21972
+ runtimeState: EventEmitterStatusSchema,
21973
+ /**
21974
+ * Runtime-state durability: **session** — `eventCountSinceStart` names its own scope.
21975
+ *
21976
+ * See `RuntimeStateDurability`. Enforced by
21977
+ * `scripts/check-runtime-state-durability.ts`.
21978
+ */
21979
+ durability: "session"
21714
21980
  };
21715
21981
  var EventItemSchema = object({
21716
21982
  id: string(),
@@ -21991,7 +22257,14 @@ var fanControlCapability = {
21991
22257
  * Runtime-state slice — mirrored by the kernel. UI fan speed
21992
22258
  * sliders read `percentage` for live updates.
21993
22259
  */
21994
- runtimeState: FanControlStatusSchema
22260
+ runtimeState: FanControlStatusSchema,
22261
+ /**
22262
+ * Runtime-state durability: **session** — as `brightness`.
22263
+ *
22264
+ * See `RuntimeStateDurability`. Enforced by
22265
+ * `scripts/check-runtime-state-durability.ts`.
22266
+ */
22267
+ durability: "session"
21995
22268
  };
21996
22269
  /**
21997
22270
  * Per-device feature/identity probe slice. Holds the runtime-resolved
@@ -22067,7 +22340,14 @@ onProbeChanged: { data: object({
22067
22340
  schema: FeatureProbeStatusSchema,
22068
22341
  kind: "push"
22069
22342
  },
22070
- runtimeState: FeatureProbeStatusSchema
22343
+ runtimeState: FeatureProbeStatusSchema,
22344
+ /**
22345
+ * 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.
22346
+ *
22347
+ * See `RuntimeStateDurability`. Enforced by
22348
+ * `scripts/check-runtime-state-durability.ts`.
22349
+ */
22350
+ durability: "session"
22071
22351
  };
22072
22352
  /**
22073
22353
  * Water leak / moisture sensor. Boolean "is liquid currently
@@ -22094,7 +22374,17 @@ var floodCapability = {
22094
22374
  schema: FloodStatusSchema,
22095
22375
  kind: "push"
22096
22376
  },
22097
- runtimeState: FloodStatusSchema
22377
+ runtimeState: FloodStatusSchema,
22378
+ /**
22379
+ * Runtime-state durability: **restored** — as `smoke`.
22380
+ *
22381
+ * See `RuntimeStateDurability`. Enforced by
22382
+ * `scripts/check-runtime-state-durability.ts`.
22383
+ */
22384
+ durability: "restored",
22385
+ /** Clock fields: written, but excluded from the compare that decides
22386
+ * whether persisting is worth a SQLite commit. */
22387
+ volatileStateFields: ["lastChangedAt"]
22098
22388
  };
22099
22389
  /**
22100
22390
  * Combustible-gas (LPG / methane / hydrogen) alarm sensor. Drives
@@ -22117,7 +22407,17 @@ var gasCapability = {
22117
22407
  schema: GasStatusSchema,
22118
22408
  kind: "push"
22119
22409
  },
22120
- runtimeState: GasStatusSchema
22410
+ runtimeState: GasStatusSchema,
22411
+ /**
22412
+ * Runtime-state durability: **restored** — as `smoke`.
22413
+ *
22414
+ * See `RuntimeStateDurability`. Enforced by
22415
+ * `scripts/check-runtime-state-durability.ts`.
22416
+ */
22417
+ durability: "restored",
22418
+ /** Clock fields: written, but excluded from the compare that decides
22419
+ * whether persisting is worth a SQLite commit. */
22420
+ volatileStateFields: ["lastChangedAt"]
22121
22421
  };
22122
22422
  /**
22123
22423
  * Humidifier / dehumidifier cap. Models HA `humidifier.*` entities —
@@ -22193,7 +22493,14 @@ var humidifierCapability = {
22193
22493
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
22194
22494
  * slice for live humidity / mode changes.
22195
22495
  */
22196
- runtimeState: HumidifierStatusSchema
22496
+ runtimeState: HumidifierStatusSchema,
22497
+ /**
22498
+ * Runtime-state durability: **session** — as `climate-control`.
22499
+ *
22500
+ * See `RuntimeStateDurability`. Enforced by
22501
+ * `scripts/check-runtime-state-durability.ts`.
22502
+ */
22503
+ durability: "session"
22197
22504
  };
22198
22505
  /**
22199
22506
  * Single-metric humidity reading. Drives Home Assistant `sensor`
@@ -22229,7 +22536,17 @@ var humiditySensorCapability = {
22229
22536
  schema: HumiditySensorStatusSchema,
22230
22537
  kind: "push"
22231
22538
  },
22232
- runtimeState: HumiditySensorStatusSchema
22539
+ runtimeState: HumiditySensorStatusSchema,
22540
+ /**
22541
+ * Runtime-state durability: **restored** — as `numeric-sensor` (67 of 75 writes were the clock alone).
22542
+ *
22543
+ * See `RuntimeStateDurability`. Enforced by
22544
+ * `scripts/check-runtime-state-durability.ts`.
22545
+ */
22546
+ durability: "restored",
22547
+ /** Clock fields: written, but excluded from the compare that decides
22548
+ * whether persisting is worth a SQLite commit. */
22549
+ volatileStateFields: ["lastFetchedAt"]
22233
22550
  };
22234
22551
  /**
22235
22552
  * Image display cap. Models a single still image exposed by an integration —
@@ -22267,7 +22584,14 @@ var imageCapability = {
22267
22584
  * Runtime-state slice — mirrored by the kernel. The UI reads `url`
22268
22585
  * directly and renders the still image.
22269
22586
  */
22270
- runtimeState: ImageStatusSchema
22587
+ runtimeState: ImageStatusSchema,
22588
+ /**
22589
+ * Runtime-state durability: **session** — a snapshot URL is a session-scoped handle; a restored one points at nothing.
22590
+ *
22591
+ * See `RuntimeStateDurability`. Enforced by
22592
+ * `scripts/check-runtime-state-durability.ts`.
22593
+ */
22594
+ durability: "session"
22271
22595
  };
22272
22596
  /**
22273
22597
  * Vendor-neutral image / picture-adjustment cap — the per-camera config
@@ -22416,7 +22740,17 @@ var imageSettingsCapability = {
22416
22740
  schema: ImageSettingsStatusSchema,
22417
22741
  kind: "poll"
22418
22742
  },
22419
- runtimeState: ImageSettingsStatusSchema
22743
+ runtimeState: ImageSettingsStatusSchema,
22744
+ /**
22745
+ * Runtime-state durability: **restored** — operator-set camera imaging; mutation-driven.
22746
+ *
22747
+ * See `RuntimeStateDurability`. Enforced by
22748
+ * `scripts/check-runtime-state-durability.ts`.
22749
+ */
22750
+ durability: "restored",
22751
+ /** Clock fields: written, but excluded from the compare that decides
22752
+ * whether persisting is worth a SQLite commit. */
22753
+ volatileStateFields: ["lastFetchedAt"]
22420
22754
  };
22421
22755
  /**
22422
22756
  * integrations — system-scoped singleton capability for integration
@@ -22807,7 +23141,14 @@ var lawnMowerControlCapability = {
22807
23141
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
22808
23142
  * slice for live activity + battery changes.
22809
23143
  */
22810
- runtimeState: LawnMowerControlStatusSchema
23144
+ runtimeState: LawnMowerControlStatusSchema,
23145
+ /**
23146
+ * Runtime-state durability: **session** — as `vacuum-control`.
23147
+ *
23148
+ * See `RuntimeStateDurability`. Enforced by
23149
+ * `scripts/check-runtime-state-durability.ts`.
23150
+ */
23151
+ durability: "session"
22811
23152
  };
22812
23153
  /**
22813
23154
  * local-network — hub-only singleton.
@@ -23013,7 +23354,17 @@ var lockControlCapability = {
23013
23354
  * read `state` and disable themselves during `locking`/`unlocking`
23014
23355
  * transitions.
23015
23356
  */
23016
- runtimeState: LockControlStatusSchema
23357
+ runtimeState: LockControlStatusSchema,
23358
+ /**
23359
+ * Runtime-state durability: **restored** — a lock left locked must still read locked.
23360
+ *
23361
+ * See `RuntimeStateDurability`. Enforced by
23362
+ * `scripts/check-runtime-state-durability.ts`.
23363
+ */
23364
+ durability: "restored",
23365
+ /** Clock fields: written, but excluded from the compare that decides
23366
+ * whether persisting is worth a SQLite commit. */
23367
+ volatileStateFields: ["lastChangedAt"]
23017
23368
  };
23018
23369
  /**
23019
23370
  * Media-player cap. Models HA `media_player.*` (Sonos, Chromecast,
@@ -23175,7 +23526,14 @@ var mediaPlayerCapability = {
23175
23526
  * full slice for live now-playing, volume, and progress updates
23176
23527
  * without polling.
23177
23528
  */
23178
- runtimeState: MediaPlayerStatusSchema
23529
+ runtimeState: MediaPlayerStatusSchema,
23530
+ /**
23531
+ * Runtime-state durability: **session** — a restored transport position describes a playback that stopped when the hub did.
23532
+ *
23533
+ * See `RuntimeStateDurability`. Enforced by
23534
+ * `scripts/check-runtime-state-durability.ts`.
23535
+ */
23536
+ durability: "session"
23179
23537
  };
23180
23538
  /**
23181
23539
  * mesh-network — collection cap for mesh-VPN providers.
@@ -23439,7 +23797,14 @@ onMotionChanged: { data: MotionOnMotionChangedDataSchema } },
23439
23797
  * `device.state.motion.value`. Reads never invoke the provider, so
23440
23798
  * UIs and other addons can poll the cached state safely.
23441
23799
  */
23442
- runtimeState: MotionStatusSchema
23800
+ runtimeState: MotionStatusSchema,
23801
+ /**
23802
+ * 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.
23803
+ *
23804
+ * See `RuntimeStateDurability`. Enforced by
23805
+ * `scripts/check-runtime-state-durability.ts`.
23806
+ */
23807
+ durability: "session"
23443
23808
  };
23444
23809
  /**
23445
23810
  * Motion-trigger toggle for accessory devices.
@@ -23504,7 +23869,14 @@ var motionTriggerCapability = {
23504
23869
  schema: MotionTriggerStatusSchema,
23505
23870
  kind: "command-driven"
23506
23871
  },
23507
- runtimeState: MotionTriggerRuntimeStateSchema
23872
+ runtimeState: MotionTriggerRuntimeStateSchema,
23873
+ /**
23874
+ * 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.
23875
+ *
23876
+ * See `RuntimeStateDurability`. Enforced by
23877
+ * `scripts/check-runtime-state-durability.ts`.
23878
+ */
23879
+ durability: "session"
23508
23880
  };
23509
23881
  /**
23510
23882
  * Motion-zones share the same MaskShape vocabulary as privacy-mask — the
@@ -23571,7 +23943,17 @@ var motionZonesCapability = {
23571
23943
  schema: MotionZoneStatusSchema,
23572
23944
  kind: "poll"
23573
23945
  },
23574
- runtimeState: MotionZoneStatusSchema
23946
+ runtimeState: MotionZoneStatusSchema,
23947
+ /**
23948
+ * 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.
23949
+ *
23950
+ * See `RuntimeStateDurability`. Enforced by
23951
+ * `scripts/check-runtime-state-durability.ts`.
23952
+ */
23953
+ durability: "restored",
23954
+ /** Clock fields: written, but excluded from the compare that decides
23955
+ * whether persisting is worth a SQLite commit. */
23956
+ volatileStateFields: ["lastFetchedAt"]
23575
23957
  };
23576
23958
  /**
23577
23959
  * On-camera AI object detection cap. Surfaces per-device the classes
@@ -23645,7 +24027,17 @@ var nativeObjectDetectionCapability = {
23645
24027
  schema: NativeObjectDetectionStatusSchema,
23646
24028
  kind: "push"
23647
24029
  },
23648
- runtimeState: NativeObjectDetectionRuntimeStateSchema
24030
+ runtimeState: NativeObjectDetectionRuntimeStateSchema,
24031
+ /**
24032
+ * 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.
24033
+ *
24034
+ * See `RuntimeStateDurability`. Enforced by
24035
+ * `scripts/check-runtime-state-durability.ts`.
24036
+ */
24037
+ durability: "restored",
24038
+ /** Clock fields: written, but excluded from the compare that decides
24039
+ * whether persisting is worth a SQLite commit. */
24040
+ volatileStateFields: ["lastFetchedAt"]
23649
24041
  };
23650
24042
  /**
23651
24043
  * network-quality — system-scoped singleton capability tracking RTT,
@@ -23979,7 +24371,14 @@ onSent: { data: object({
23979
24371
  * form reads `supports` to gate optional fields; history pane reads
23980
24372
  * `lastSentAt` / `lastError` / `queueDepth`.
23981
24373
  */
23982
- runtimeState: NotifierStatusSchema
24374
+ runtimeState: NotifierStatusSchema,
24375
+ /**
24376
+ * Runtime-state durability: **session** — live queue depth and last-send state; a restored queue depth describes a queue that no longer exists.
24377
+ *
24378
+ * See `RuntimeStateDurability`. Enforced by
24379
+ * `scripts/check-runtime-state-durability.ts`.
24380
+ */
24381
+ durability: "session"
23983
24382
  };
23984
24383
  /**
23985
24384
  * Generic numeric sensor — last-resort fallback when no typed numeric
@@ -24022,7 +24421,17 @@ var numericSensorCapability = {
24022
24421
  schema: NumericSensorStatusSchema,
24023
24422
  kind: "push"
24024
24423
  },
24025
- runtimeState: NumericSensorStatusSchema
24424
+ runtimeState: NumericSensorStatusSchema,
24425
+ /**
24426
+ * 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.
24427
+ *
24428
+ * See `RuntimeStateDurability`. Enforced by
24429
+ * `scripts/check-runtime-state-durability.ts`.
24430
+ */
24431
+ durability: "restored",
24432
+ /** Clock fields: written, but excluded from the compare that decides
24433
+ * whether persisting is worth a SQLite commit. */
24434
+ volatileStateFields: ["lastFetchedAt"]
24026
24435
  };
24027
24436
  /**
24028
24437
  * Generic on-screen-display (video overlay) cap. Each camera exposes
@@ -24453,7 +24862,14 @@ var petFeederCapability = {
24453
24862
  * the full slice via `device.state.petFeeder.value` and refresh on
24454
24863
  * every poll without re-querying the provider.
24455
24864
  */
24456
- runtimeState: PetFeederStatusSchema
24865
+ runtimeState: PetFeederStatusSchema,
24866
+ /**
24867
+ * Runtime-state durability: **session** — live appliance state re-published on connect.
24868
+ *
24869
+ * See `RuntimeStateDurability`. Enforced by
24870
+ * `scripts/check-runtime-state-durability.ts`.
24871
+ */
24872
+ durability: "session"
24457
24873
  };
24458
24874
  var VehicleSchema = object({
24459
24875
  id: string(),
@@ -24765,7 +25181,17 @@ var powerMeterCapability = {
24765
25181
  schema: PowerMeterStatusSchema,
24766
25182
  kind: "push"
24767
25183
  },
24768
- runtimeState: PowerMeterStatusSchema
25184
+ runtimeState: PowerMeterStatusSchema,
25185
+ /**
25186
+ * Runtime-state durability: **restored** — as `numeric-sensor`; `kwhTotal` is an accumulator whose restored value is the baseline.
25187
+ *
25188
+ * See `RuntimeStateDurability`. Enforced by
25189
+ * `scripts/check-runtime-state-durability.ts`.
25190
+ */
25191
+ durability: "restored",
25192
+ /** Clock fields: written, but excluded from the compare that decides
25193
+ * whether persisting is worth a SQLite commit. */
25194
+ volatileStateFields: ["lastFetchedAt"]
24769
25195
  };
24770
25196
  /**
24771
25197
  * Presence cap. Models HA `person.*` and `device_tracker.*` entities
@@ -24822,7 +25248,17 @@ var presenceCapability = {
24822
25248
  * the map pin is rendered (use `DeviceFeature.PresenceGps` for the
24823
25249
  * pre-fetch fast-path check).
24824
25250
  */
24825
- runtimeState: PresenceStatusSchema
25251
+ runtimeState: PresenceStatusSchema,
25252
+ /**
25253
+ * Runtime-state durability: **restored** — occupancy-relevant: the restored state is what an occupancy rule compares the first post-restart observation against.
25254
+ *
25255
+ * See `RuntimeStateDurability`. Enforced by
25256
+ * `scripts/check-runtime-state-durability.ts`.
25257
+ */
25258
+ durability: "restored",
25259
+ /** Clock fields: written, but excluded from the compare that decides
25260
+ * whether persisting is worth a SQLite commit. */
25261
+ volatileStateFields: ["lastChangedAt"]
24826
25262
  };
24827
25263
  /**
24828
25264
  * Atmospheric pressure reading in hectopascals. Drives Home Assistant
@@ -24858,7 +25294,17 @@ var pressureSensorCapability = {
24858
25294
  schema: PressureSensorStatusSchema,
24859
25295
  kind: "push"
24860
25296
  },
24861
- runtimeState: PressureSensorStatusSchema
25297
+ runtimeState: PressureSensorStatusSchema,
25298
+ /**
25299
+ * Runtime-state durability: **restored** — as `numeric-sensor`.
25300
+ *
25301
+ * See `RuntimeStateDurability`. Enforced by
25302
+ * `scripts/check-runtime-state-durability.ts`.
25303
+ */
25304
+ durability: "restored",
25305
+ /** Clock fields: written, but excluded from the compare that decides
25306
+ * whether persisting is worth a SQLite commit. */
25307
+ volatileStateFields: ["lastFetchedAt"]
24862
25308
  };
24863
25309
  /**
24864
25310
  * PRIVACY — what the camera deliberately does not capture. Two planes:
@@ -24988,7 +25434,17 @@ var privacyMaskCapability = {
24988
25434
  schema: PrivacyMaskStatusSchema,
24989
25435
  kind: "poll"
24990
25436
  },
24991
- runtimeState: PrivacyMaskStatusSchema
25437
+ runtimeState: PrivacyMaskStatusSchema,
25438
+ /**
25439
+ * Runtime-state durability: **restored** — operator-drawn regions, zero real churn — 22 writes in 25 minutes, every one of them the clock.
25440
+ *
25441
+ * See `RuntimeStateDurability`. Enforced by
25442
+ * `scripts/check-runtime-state-durability.ts`.
25443
+ */
25444
+ durability: "restored",
25445
+ /** Clock fields: written, but excluded from the compare that decides
25446
+ * whether persisting is worth a SQLite commit. */
25447
+ volatileStateFields: ["lastFetchedAt"]
24992
25448
  };
24993
25449
  /**
24994
25450
  * Collapse a camera's PER-PROFILE audio flags into the one answer
@@ -25216,7 +25672,14 @@ var ptzAutotrackCapability = {
25216
25672
  * fetch / cache / fallback logic out of the four cap methods —
25217
25673
  * they become trampolines over `runtimeState`.
25218
25674
  */
25219
- runtimeState: PtzAutotrackRuntimeStateSchema
25675
+ runtimeState: PtzAutotrackRuntimeStateSchema,
25676
+ /**
25677
+ * Runtime-state durability: **session** — mirrors the camera's own autotrack config, re-read on connect.
25678
+ *
25679
+ * See `RuntimeStateDurability`. Enforced by
25680
+ * `scripts/check-runtime-state-durability.ts`.
25681
+ */
25682
+ durability: "session"
25220
25683
  };
25221
25684
  /**
25222
25685
  * reboot — device-scoped capability for "soft" device reboots (firmware
@@ -25588,13 +26051,24 @@ method(object({
25588
26051
  /** Playback-speed multiplier for the render (1 = realtime). */
25589
26052
  var ExportSpeedSchema = number().min(.25).max(32);
25590
26053
  /**
25591
- * One dense interval, in SECONDS FROM THE EXPORT'S OWN `fromMs`.
26054
+ * One dense interval, in WALL-CLOCK SECONDS FROM THE EXPORT'S OWN `fromMs`.
26055
+ *
26056
+ * **Wall clock, not ffmpeg's `t`** — and the recorder translates. A caller
26057
+ * derives these bounds from things that happened at a TIME (a track's
26058
+ * `firstSeen`), while `t` runs over the source playlist: the concatenation of
26059
+ * every segment present for the range, with each recording GAP removed. The
26060
+ * two agree only on a window that recorded without one interruption, and only
26061
+ * the render side knows the segments, so the translation lives there
26062
+ * (`export-dense-map.ts`, addon-pipeline).
26063
+ *
26064
+ * It was not always so. These seconds were fed to `between(t,…)` verbatim, and
26065
+ * on a 10 h window holding 29,393 s of footage every range landed late by the
26066
+ * gap accumulated before it — up to 6,607 s, well past EOF. Nothing matched,
26067
+ * the video was a uniform timelapse, and the log line reported the five ranges
26068
+ * that had been ASKED for (2026-08-13, export `57d14363`, camera 615).
25592
26069
  *
25593
- * Relative and not absolute epoch on purpose: the renderer's frame-select
25594
- * expression sees ffmpeg's `t`, which starts at 0 for the export's source
25595
- * playlist. Handing it absolute epochs would make every call site responsible
25596
- * for the same subtraction, and the one that forgot would emit a filter that
25597
- * selects nothing — silently, as a uniform timelapse.
26070
+ * Relative and not absolute epoch, because an absolute epoch would make every
26071
+ * call site responsible for the same subtraction.
25598
26072
  */
25599
26073
  var ExportDenseRangeSchema = object({
25600
26074
  fromSec: number().nonnegative(),
@@ -25880,7 +26354,14 @@ var sceneMonitorCapability = {
25880
26354
  schema: SceneMonitorStatusSchema,
25881
26355
  kind: "push"
25882
26356
  },
25883
- runtimeState: SceneMonitorStatusSchema
26357
+ runtimeState: SceneMonitorStatusSchema,
26358
+ /**
26359
+ * Runtime-state durability: **session** — re-derived from the current scene on the next evaluation.
26360
+ *
26361
+ * See `RuntimeStateDurability`. Enforced by
26362
+ * `scripts/check-runtime-state-durability.ts`.
26363
+ */
26364
+ durability: "session"
25884
26365
  };
25885
26366
  /**
25886
26367
  * Per-stage gating mode applied to the zones a rule references.
@@ -26024,7 +26505,14 @@ var scriptRunnerCapability = {
26024
26505
  * `isRunning` to render a spinner during execution and surfaces
26025
26506
  * `lastError` / `lastRunSuccess` in the recent-runs panel.
26026
26507
  */
26027
- runtimeState: ScriptRunnerStatusSchema
26508
+ runtimeState: ScriptRunnerStatusSchema,
26509
+ /**
26510
+ * Runtime-state durability: **session** — a restored `isRunning: true` describes a process that died with the previous hub.
26511
+ *
26512
+ * See `RuntimeStateDurability`. Enforced by
26513
+ * `scripts/check-runtime-state-durability.ts`.
26514
+ */
26515
+ durability: "session"
26028
26516
  };
26029
26517
  /**
26030
26518
  * Smoke alarm sensor — boolean "is smoke currently detected" with
@@ -26051,7 +26539,17 @@ var smokeCapability = {
26051
26539
  schema: SmokeStatusSchema,
26052
26540
  kind: "push"
26053
26541
  },
26054
- runtimeState: SmokeStatusSchema
26542
+ runtimeState: SmokeStatusSchema,
26543
+ /**
26544
+ * Runtime-state durability: **restored** — a safety sensor must not read "clear" merely because the hub restarted.
26545
+ *
26546
+ * See `RuntimeStateDurability`. Enforced by
26547
+ * `scripts/check-runtime-state-durability.ts`.
26548
+ */
26549
+ durability: "restored",
26550
+ /** Clock fields: written, but excluded from the compare that decides
26551
+ * whether persisting is worth a SQLite commit. */
26552
+ volatileStateFields: ["lastChangedAt"]
26055
26553
  };
26056
26554
  /**
26057
26555
  * One publishable camera stream as its OWNING PROVIDER describes it — the same
@@ -26237,7 +26735,17 @@ var streamParamsCapability = {
26237
26735
  schema: StreamParamsStatusSchema,
26238
26736
  kind: "poll"
26239
26737
  },
26240
- runtimeState: StreamParamsStatusSchema
26738
+ runtimeState: StreamParamsStatusSchema,
26739
+ /**
26740
+ * Runtime-state durability: **restored** — operator-set encoder profile; mutation-driven.
26741
+ *
26742
+ * See `RuntimeStateDurability`. Enforced by
26743
+ * `scripts/check-runtime-state-durability.ts`.
26744
+ */
26745
+ durability: "restored",
26746
+ /** Clock fields: written, but excluded from the compare that decides
26747
+ * whether persisting is worth a SQLite commit. */
26748
+ volatileStateFields: ["lastFetchedAt"]
26241
26749
  };
26242
26750
  /**
26243
26751
  * The three well-known stream profiles in render order. Exported so the
@@ -26481,6 +26989,16 @@ var switchCapability = {
26481
26989
  * not need to re-query the provider after a setState mutation.
26482
26990
  */
26483
26991
  runtimeState: SwitchStatusSchema,
26992
+ /**
26993
+ * Runtime-state durability: **restored** — device state an operator reads as authoritative; 55 devices, transition-driven.
26994
+ *
26995
+ * See `RuntimeStateDurability`. Enforced by
26996
+ * `scripts/check-runtime-state-durability.ts`.
26997
+ */
26998
+ durability: "restored",
26999
+ /** Clock fields: written, but excluded from the compare that decides
27000
+ * whether persisting is worth a SQLite commit. */
27001
+ volatileStateFields: ["lastChangedAt"],
26484
27002
  settings: { bindings: [{
26485
27003
  kind: "scalar",
26486
27004
  statusPath: "on",
@@ -26560,7 +27078,17 @@ var tamperCapability = {
26560
27078
  schema: TamperStatusSchema,
26561
27079
  kind: "push"
26562
27080
  },
26563
- runtimeState: TamperStatusSchema
27081
+ runtimeState: TamperStatusSchema,
27082
+ /**
27083
+ * Runtime-state durability: **restored** — as `smoke`.
27084
+ *
27085
+ * See `RuntimeStateDurability`. Enforced by
27086
+ * `scripts/check-runtime-state-durability.ts`.
27087
+ */
27088
+ durability: "restored",
27089
+ /** Clock fields: written, but excluded from the compare that decides
27090
+ * whether persisting is worth a SQLite commit. */
27091
+ volatileStateFields: ["lastChangedAt"]
26564
27092
  };
26565
27093
  /**
26566
27094
  * Single-metric temperature reading. Drives Home Assistant `sensor`
@@ -26605,7 +27133,17 @@ var temperatureSensorCapability = {
26605
27133
  schema: TemperatureSensorStatusSchema,
26606
27134
  kind: "push"
26607
27135
  },
26608
- runtimeState: TemperatureSensorStatusSchema
27136
+ runtimeState: TemperatureSensorStatusSchema,
27137
+ /**
27138
+ * Runtime-state durability: **restored** — as `numeric-sensor` (69 of 125 writes were the clock alone).
27139
+ *
27140
+ * See `RuntimeStateDurability`. Enforced by
27141
+ * `scripts/check-runtime-state-durability.ts`.
27142
+ */
27143
+ durability: "restored",
27144
+ /** Clock fields: written, but excluded from the compare that decides
27145
+ * whether persisting is worth a SQLite commit. */
27146
+ volatileStateFields: ["lastFetchedAt"]
26609
27147
  };
26610
27148
  /**
26611
27149
  * toast — system-scoped singleton capability that streams toast
@@ -26674,7 +27212,14 @@ var updateCapability = {
26674
27212
  schema: UpdateStatusSchema,
26675
27213
  kind: "poll"
26676
27214
  },
26677
- runtimeState: UpdateStatusSchema
27215
+ runtimeState: UpdateStatusSchema,
27216
+ /**
27217
+ * Runtime-state durability: **session** — a restored `inProgress: true` describes an update that is no longer running; versions are re-probed at boot.
27218
+ *
27219
+ * See `RuntimeStateDurability`. Enforced by
27220
+ * `scripts/check-runtime-state-durability.ts`.
27221
+ */
27222
+ durability: "session"
26678
27223
  };
26679
27224
  var UserSummarySchema = object({
26680
27225
  id: string(),
@@ -27008,7 +27553,14 @@ var vacuumControlCapability = {
27008
27553
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
27009
27554
  * slice for live state + battery + fan-speed changes.
27010
27555
  */
27011
- runtimeState: VacuumControlStatusSchema
27556
+ runtimeState: VacuumControlStatusSchema,
27557
+ /**
27558
+ * Runtime-state durability: **session** — as `media-player` — a restored `state: cleaning` is a robot that is not cleaning.
27559
+ *
27560
+ * See `RuntimeStateDurability`. Enforced by
27561
+ * `scripts/check-runtime-state-durability.ts`.
27562
+ */
27563
+ durability: "session"
27012
27564
  };
27013
27565
  var ValveStatusSchema = object({
27014
27566
  /** Lifecycle state of the valve. */
@@ -27060,7 +27612,14 @@ var valveCapability = {
27060
27612
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
27061
27613
  * slice for live position changes during a move.
27062
27614
  */
27063
- runtimeState: ValveStatusSchema
27615
+ runtimeState: ValveStatusSchema,
27616
+ /**
27617
+ * Runtime-state durability: **session** — as `brightness`.
27618
+ *
27619
+ * See `RuntimeStateDurability`. Enforced by
27620
+ * `scripts/check-runtime-state-durability.ts`.
27621
+ */
27622
+ durability: "session"
27064
27623
  };
27065
27624
  /**
27066
27625
  * Vibration / shake / impact sensor. Drives Home Assistant
@@ -27082,7 +27641,17 @@ var vibrationCapability = {
27082
27641
  schema: VibrationStatusSchema,
27083
27642
  kind: "push"
27084
27643
  },
27085
- runtimeState: VibrationStatusSchema
27644
+ runtimeState: VibrationStatusSchema,
27645
+ /**
27646
+ * Runtime-state durability: **restored** — as `smoke`.
27647
+ *
27648
+ * See `RuntimeStateDurability`. Enforced by
27649
+ * `scripts/check-runtime-state-durability.ts`.
27650
+ */
27651
+ durability: "restored",
27652
+ /** Clock fields: written, but excluded from the compare that decides
27653
+ * whether persisting is worth a SQLite commit. */
27654
+ volatileStateFields: ["lastChangedAt"]
27086
27655
  };
27087
27656
  /**
27088
27657
  * Water heater / boiler cap. Models HA `water_heater.*` entities — a
@@ -27156,7 +27725,14 @@ var waterHeaterCapability = {
27156
27725
  * Runtime-state slice — mirrored by the kernel. UI controls watch the
27157
27726
  * slice for live temperature / mode / away changes.
27158
27727
  */
27159
- runtimeState: WaterHeaterStatusSchema
27728
+ runtimeState: WaterHeaterStatusSchema,
27729
+ /**
27730
+ * Runtime-state durability: **session** — as `climate-control`.
27731
+ *
27732
+ * See `RuntimeStateDurability`. Enforced by
27733
+ * `scripts/check-runtime-state-durability.ts`.
27734
+ */
27735
+ durability: "session"
27160
27736
  };
27161
27737
  /**
27162
27738
  * Weather provider cap. Models HA `weather.*` entities — a read-only
@@ -27215,7 +27791,14 @@ var weatherCapability = {
27215
27791
  * Runtime-state slice — mirrored by the kernel. The UI reads the
27216
27792
  * current conditions directly from the slice on each weather push.
27217
27793
  */
27218
- runtimeState: WeatherStatusSchema
27794
+ runtimeState: WeatherStatusSchema,
27795
+ /**
27796
+ * Runtime-state durability: **session** — a forecast is stale the moment the hub is down; the provider re-fetches on connect.
27797
+ *
27798
+ * See `RuntimeStateDurability`. Enforced by
27799
+ * `scripts/check-runtime-state-durability.ts`.
27800
+ */
27801
+ durability: "session"
27219
27802
  };
27220
27803
  /**
27221
27804
  * Per-zone occupancy aggregation produced by the analytics frame
@@ -27377,7 +27960,14 @@ var zoneAnalyticsCapability = {
27377
27960
  * automatically; the explicit `getCurrentSnapshot` cap method is
27378
27961
  * still useful for one-off polls without a subscription.
27379
27962
  */
27380
- runtimeState: CameraOccupancySnapshotSchema
27963
+ runtimeState: CameraOccupancySnapshotSchema,
27964
+ /**
27965
+ * Runtime-state durability: **session** — per-frame analytics; with `audio-metrics` it is ~90 % of the offered write rate. Re-derived on the next frame.
27966
+ *
27967
+ * See `RuntimeStateDurability`. Enforced by
27968
+ * `scripts/check-runtime-state-durability.ts`.
27969
+ */
27970
+ durability: "session"
27381
27971
  };
27382
27972
  /**
27383
27973
  * Stages a {@link ZoneRule} can apply to. Discriminator on the rules
@@ -27455,7 +28045,14 @@ var zoneRulesCapability = {
27455
28045
  motion: array(ZoneRuleSchema).readonly(),
27456
28046
  detection: array(ZoneRuleSchema).readonly(),
27457
28047
  package: array(ZoneRuleSchema).readonly()
27458
- })
28048
+ }),
28049
+ /**
28050
+ * Runtime-state durability: **restored** — operator intent, mutation-only, same argument as `zones`.
28051
+ *
28052
+ * See `RuntimeStateDurability`. Enforced by
28053
+ * `scripts/check-runtime-state-durability.ts`.
28054
+ */
28055
+ durability: "restored"
27459
28056
  };
27460
28057
  /**
27461
28058
  * Accessory device helpers — shared across drivers.
@@ -34288,6 +34885,7 @@ Object.freeze({
34288
34885
  "network-access": "ingress",
34289
34886
  "smtp-provider": "email"
34290
34887
  });
34888
+ new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
34291
34889
  new Set(["devices", "classes"]);
34292
34890
  /**
34293
34891
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
@@ -34565,25 +35163,32 @@ object({
34565
35163
  var NativeLeaseAdmissionSchema = _enum(["all", "inferred"]);
34566
35164
  object({
34567
35165
  /**
34568
- * How long a retained native frame is served before it counts as a miss.
35166
+ * How many delivered frames the worker HOLDS at once, waiting for each one's
35167
+ * detection result.
34569
35168
  *
34570
- * Must cover the FULL late-crop horizon: detection inference + the
34571
- * cross-process inference-result hop to hub post-analysis + tracking + the
34572
- * tRPC crop round-trip back. Below ~500 ms the busiest cameras' subject crops
34573
- * outrun it and fall back to the ≤640 detection frame; above ~3 s the resident
34574
- * RAM per busy camera grows linearly with no measured hit-rate gain.
35169
+ * This replaced a TTL on 2026-08-13, and the replacement is the whole point:
35170
+ * a time window was never related to the event the pixels were waiting for.
35171
+ * A held frame now lives from delivery until the runner has its `FrameResult`
35172
+ * at which moment the runner cuts the subject tiles it actually wanted and
35173
+ * releases the frame. The bound exists only so a runner that stops answering
35174
+ * cannot pin RAM: above it the OLDEST held frame is dropped and counted.
35175
+ *
35176
+ * Sizing: the steady state is `inferenceLatency × deliveredFps`, measured at
35177
+ * 40-160 ms × ≤25 fps = 1-4 frames. The default leaves headroom for a hiccup
35178
+ * without ever approaching the old resident set (43 frames × 24.9 MB at 4K).
35179
+ * Raising it does not buy hit rate — it buys tolerance for a slow runner, and
35180
+ * `holdOverflow` on the metrics line is what says you need it.
34575
35181
  */
34576
- ttlMs: number().int().min(250).max(1e4),
35182
+ holdFrames: number().int().min(1).max(64),
34577
35183
  /**
34578
35184
  * Hard per-decode-worker RAM ceiling for retained native frames, in MB.
34579
35185
  *
34580
- * Intended as a SAFETY ceiling with the TTL as the effective cap — but check
34581
- * which one is actually binding before reasoning from that. At the shipped
34582
- * 1024 MB and a 2 800 ms TTL, a 4K camera hits the CEILING first (~43 frames
34583
- * at ~24 MB each) and the TTL never gets to expire anything; `leaseMb` /
34584
- * `leaseFrames` on the metrics line say which. When the ceiling binds, a
34585
- * change that admits fewer frames buys retention WINDOW at constant RAM
34586
- * rather than giving RAM back — lower this knob if RAM is what you wanted.
35186
+ * Since 2026-08-13 this is a SAFETY ceiling and nothing else: `holdFrames`
35187
+ * is what decides how much is held, and the ceiling is the number above which
35188
+ * something is wrong. Before that it was the effective cap at 1024 MB with
35189
+ * a 2 800 ms TTL a 4K camera sat pinned at `leaseMb:1020, leaseFrames:43`
35190
+ * with the TTL expiring nothing, which is exactly the confusion the hold
35191
+ * removes. `leaseMb` / `leaseFrames` still say what is resident.
34587
35192
  * `0` DISABLES the lease entirely and falls the worker back to the tiny
34588
35193
  * leak-prone GPU surface ring (~85% crop miss; that is what the lease exists
34589
35194
  * to replace).
@@ -34609,22 +35214,45 @@ object({
34609
35214
  * there is the signal that some caller names frames outside the inference set
34610
35215
  * and that this must go back to `all`.
34611
35216
  */
34612
- admission: NativeLeaseAdmissionSchema
35217
+ admission: NativeLeaseAdmissionSchema,
35218
+ /**
35219
+ * RAM ceiling per decode worker, in MB, for the SUBJECT TILES — the
35220
+ * compressed native crops the worker cuts at the moment a frame's detection
35221
+ * result arrives, and keeps long after the frame itself is freed.
35222
+ *
35223
+ * This is the knob that replaced the old retention window, and it buys about
35224
+ * three orders of magnitude more of it: a tile is one subject at native
35225
+ * resolution, JPEG-encoded (~60-120 KB on a 4K person), against ~24.9 MB for
35226
+ * the frame it was cut from. A frame on which nothing was detected costs
35227
+ * nothing at all, which is the real change — the old lease paid per FRAME and
35228
+ * was interrogated per SUBJECT.
35229
+ *
35230
+ * `0` DISABLES tiles, leaving only the hold window and the ≤640 RAM
35231
+ * fallback — i.e. the pre-2026-08-13 miss profile. Set it there only to
35232
+ * reproduce that.
35233
+ */
35234
+ tileBudgetMb: number().int().min(0).max(1024)
34613
35235
  });
34614
35236
  /**
34615
- * The values in force when the operator has set nothing — byte-for-byte the
34616
- * constants the decode worker shipped with as env-var defaults, so making these
34617
- * settings changed no behaviour on the day it landed.
35237
+ * The values in force when the operator has set nothing.
35238
+ *
35239
+ * `budgetMb` stays at 1024 on the day the hold landed, deliberately: it stopped
35240
+ * being the retention window and became the OOM ceiling, and lowering a ceiling
35241
+ * in the same change that redefines it would make a regression and a retune
35242
+ * indistinguishable. Cut it once `tileHits` / `holdOverflow` have been read on
35243
+ * live traffic.
34618
35244
  */
34619
35245
  var DEFAULT_NATIVE_LEASE_SETTINGS = {
34620
- ttlMs: 1200,
35246
+ holdFrames: 8,
34621
35247
  budgetMb: 1024,
34622
35248
  activityMs: 15e3,
35249
+ tileBudgetMb: 64,
34623
35250
  admission: "inferred"
34624
35251
  };
34625
- DEFAULT_NATIVE_LEASE_SETTINGS.ttlMs;
35252
+ DEFAULT_NATIVE_LEASE_SETTINGS.holdFrames;
34626
35253
  DEFAULT_NATIVE_LEASE_SETTINGS.budgetMb;
34627
35254
  DEFAULT_NATIVE_LEASE_SETTINGS.activityMs;
35255
+ DEFAULT_NATIVE_LEASE_SETTINGS.tileBudgetMb;
34628
35256
  DEFAULT_NATIVE_LEASE_SETTINGS.admission;
34629
35257
  //#endregion
34630
35258
  //#region src/accessories/base.ts