@camstack/addon-provider-reolink 1.2.23 → 1.2.25
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.
- package/dist/addon.js +723 -95
- package/dist/addon.mjs +723 -95
- package/package.json +1 -1
package/dist/addon.js
CHANGED
|
@@ -10971,7 +10971,14 @@ var cameraStreamsCapability = {
|
|
|
10971
10971
|
low: string().optional()
|
|
10972
10972
|
}),
|
|
10973
10973
|
lastChangedAt: number()
|
|
10974
|
-
})
|
|
10974
|
+
}),
|
|
10975
|
+
/**
|
|
10976
|
+
* 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.
|
|
10977
|
+
*
|
|
10978
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
10979
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
10980
|
+
*/
|
|
10981
|
+
durability: "session"
|
|
10975
10982
|
};
|
|
10976
10983
|
/** Where a block runs. The operator chooses — a block driving a device on an
|
|
10977
10984
|
* agent is the reason placement is not fixed to the hub. */
|
|
@@ -11544,6 +11551,13 @@ var deviceDiscoveryCapability = {
|
|
|
11544
11551
|
kind: "poll"
|
|
11545
11552
|
},
|
|
11546
11553
|
runtimeState: DeviceDiscoveryStatusSchema.extend({ lastFetchedAt: number().int().nonnegative() }),
|
|
11554
|
+
/**
|
|
11555
|
+
* Runtime-state durability: **session** — 5.7 KB of scan output on the largest device, fully re-derivable by re-scanning.
|
|
11556
|
+
*
|
|
11557
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
11558
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
11559
|
+
*/
|
|
11560
|
+
durability: "session",
|
|
11547
11561
|
methods: {
|
|
11548
11562
|
/**
|
|
11549
11563
|
* Snapshot of the current `discovered` list. Returns the
|
|
@@ -13443,7 +13457,23 @@ var NotificationActionSchema = object({
|
|
|
13443
13457
|
* else — see `notification-center/action-token.ts` for what that does and
|
|
13444
13458
|
* does not buy.
|
|
13445
13459
|
*/
|
|
13446
|
-
destructive: boolean().optional()
|
|
13460
|
+
destructive: boolean().optional(),
|
|
13461
|
+
/**
|
|
13462
|
+
* How the tap should REACH the url.
|
|
13463
|
+
*
|
|
13464
|
+
* `navigate` (absent, and every button authored before this field) opens it:
|
|
13465
|
+
* the phone leaves the notification and shows whatever the callback returns.
|
|
13466
|
+
* That is right for a button whose answer the operator wants to read.
|
|
13467
|
+
*
|
|
13468
|
+
* `background` fires it as a POST and stays put. It exists for the buttons
|
|
13469
|
+
* whose whole point is not to interrupt — "silence this for 30 minutes" is
|
|
13470
|
+
* an answer to the notification, and being thrown into a browser tab to
|
|
13471
|
+
* confirm it costs more attention than the notification did. A backend that
|
|
13472
|
+
* cannot do a background call renders it as an ordinary link (the adapters
|
|
13473
|
+
* fall back rather than dropping the button), so this is a preference, never
|
|
13474
|
+
* a requirement.
|
|
13475
|
+
*/
|
|
13476
|
+
mode: _enum(["navigate", "background"]).optional()
|
|
13447
13477
|
});
|
|
13448
13478
|
/**
|
|
13449
13479
|
* The canonical notification. `body` is the only hard field (Apprise model).
|
|
@@ -14295,7 +14325,17 @@ var alarmPanelCapability = {
|
|
|
14295
14325
|
* full slice; renders an arm button per `availableModes` entry and
|
|
14296
14326
|
* a PIN field iff `requiresCode === true`.
|
|
14297
14327
|
*/
|
|
14298
|
-
runtimeState: AlarmPanelStatusSchema
|
|
14328
|
+
runtimeState: AlarmPanelStatusSchema,
|
|
14329
|
+
/**
|
|
14330
|
+
* Runtime-state durability: **restored** — armed state is the one thing a panel must not lose across a restart.
|
|
14331
|
+
*
|
|
14332
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
14333
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
14334
|
+
*/
|
|
14335
|
+
durability: "restored",
|
|
14336
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
14337
|
+
* whether persisting is worth a SQLite commit. */
|
|
14338
|
+
volatileStateFields: ["lastChangedAt"]
|
|
14299
14339
|
};
|
|
14300
14340
|
/**
|
|
14301
14341
|
* Shared geometry vocabulary for on-frame shape caps — privacy-mask,
|
|
@@ -14472,6 +14512,9 @@ var NcSystemEventConditionSchema = object({
|
|
|
14472
14512
|
nodeIds: array(string().min(1)).min(1).optional(),
|
|
14473
14513
|
packageNames: array(string().min(1)).min(1).optional()
|
|
14474
14514
|
});
|
|
14515
|
+
/** Hard ceiling on a window (24h). A snooze that could not expire would be an
|
|
14516
|
+
* outage the operator asked for once and forgot. */
|
|
14517
|
+
var NC_SNOOZE_MAX_MINUTES = 1440;
|
|
14475
14518
|
/** Weekly schedule — OR of windows; absence on the rule = always active. */
|
|
14476
14519
|
var NcScheduleSchema = object({
|
|
14477
14520
|
windows: array(object({
|
|
@@ -14848,15 +14891,15 @@ var NcConditionsSchema = object({
|
|
|
14848
14891
|
* (an `immediate` rule naming an `audio-*` class, one notification per
|
|
14849
14892
|
* classified sample) stays exactly as it was for rules that already use it.
|
|
14850
14893
|
*
|
|
14851
|
-
*
|
|
14852
|
-
* rather than an
|
|
14853
|
-
* (`camstack/src/data/notification-center.ts`, guarded by
|
|
14854
|
-
* `scripts/check-viewer-condition-mirror.ts`) and its rule editor
|
|
14894
|
+
* In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
|
|
14895
|
+
* rule rather than an accident: the viewer mirrors the descriptor enums BY
|
|
14896
|
+
* HAND (`camstack/src/data/notification-center.ts`, guarded by
|
|
14897
|
+
* `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
|
|
14855
14898
|
* condition fields it does not know when a rule is saved from the phone.
|
|
14856
14899
|
* Publishing an editor for a condition the app cannot round-trip is how an
|
|
14857
|
-
* operator loses a rule's conditions by opening it — so the
|
|
14858
|
-
*
|
|
14859
|
-
*
|
|
14900
|
+
* operator loses a rule's conditions by opening it — so the viewer mirror
|
|
14901
|
+
* (P3, shipped) went FIRST, and the descriptor an editor renders from
|
|
14902
|
+
* follows here.
|
|
14860
14903
|
*/
|
|
14861
14904
|
audio: NcAudioConditionSchema.optional()
|
|
14862
14905
|
});
|
|
@@ -15092,6 +15135,30 @@ var NcRuleInputSchema = object({
|
|
|
15092
15135
|
*/
|
|
15093
15136
|
snoozeAllowGlobal: boolean().optional(),
|
|
15094
15137
|
/**
|
|
15138
|
+
* The snooze durations THIS rule's notification offers as buttons, in
|
|
15139
|
+
* minutes.
|
|
15140
|
+
*
|
|
15141
|
+
* Three states, and all three are distinct — which is exactly why this is
|
|
15142
|
+
* `.optional()` and never `.default()`. A Zod default does not run on the
|
|
15143
|
+
* addon cap path (three production failures in one day), so a schema default
|
|
15144
|
+
* would collapse the first two:
|
|
15145
|
+
*
|
|
15146
|
+
* | value | meaning |
|
|
15147
|
+
* | --- | --- |
|
|
15148
|
+
* | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
|
|
15149
|
+
* | `[]` | **no snooze buttons on this rule** — the explicit override |
|
|
15150
|
+
* | a list | these choices, de-duplicated and sorted, at most four |
|
|
15151
|
+
*
|
|
15152
|
+
* `.max(4)` because the notifier's own action budget is small (ntfy allows
|
|
15153
|
+
* three buttons in total) and a rule that spent it all on snooze choices
|
|
15154
|
+
* would push its own tap-through actions off the notification.
|
|
15155
|
+
*
|
|
15156
|
+
* An empty list is NOT an alarm exemption: a rule the alarm is about, or
|
|
15157
|
+
* that arms the panel, is exempt automatically and cannot be silenced by a
|
|
15158
|
+
* window from anywhere (D133).
|
|
15159
|
+
*/
|
|
15160
|
+
snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
|
|
15161
|
+
/**
|
|
15095
15162
|
* Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
|
|
15096
15163
|
*
|
|
15097
15164
|
* This is what makes the rule set the alarm's trigger set without the alarm
|
|
@@ -15191,6 +15258,7 @@ var NcConditionDescriptorSchema = object({
|
|
|
15191
15258
|
"device",
|
|
15192
15259
|
"package",
|
|
15193
15260
|
"occupancy",
|
|
15261
|
+
"audio",
|
|
15194
15262
|
"system"
|
|
15195
15263
|
]),
|
|
15196
15264
|
label: string(),
|
|
@@ -15209,6 +15277,7 @@ var NcConditionDescriptorSchema = object({
|
|
|
15209
15277
|
"crossingSelect",
|
|
15210
15278
|
"polygonDraw",
|
|
15211
15279
|
"occupancy",
|
|
15280
|
+
"audio",
|
|
15212
15281
|
"deviceState",
|
|
15213
15282
|
"systemEvent"
|
|
15214
15283
|
]),
|
|
@@ -15360,7 +15429,20 @@ var NcSnoozeInputSchema = object({
|
|
|
15360
15429
|
ruleId: string().optional(),
|
|
15361
15430
|
/** Required when `scope: 'device'`. */
|
|
15362
15431
|
deviceId: number().int().optional(),
|
|
15363
|
-
|
|
15432
|
+
/**
|
|
15433
|
+
* Narrow the window to these subject classes — "the cat, not the person".
|
|
15434
|
+
*
|
|
15435
|
+
* ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
|
|
15436
|
+
* what every window authored before this field meant, so no persisted row
|
|
15437
|
+
* changes meaning and no client has to learn anything to keep working.
|
|
15438
|
+
*
|
|
15439
|
+
* It is what makes the window's real key `(deviceId, classes[])` and lets it
|
|
15440
|
+
* cross rules (D133): the operator points at a camera and a kind of thing,
|
|
15441
|
+
* not at whichever of their four rules happened to produce the notification
|
|
15442
|
+
* they are dismissing.
|
|
15443
|
+
*/
|
|
15444
|
+
classes: array(string().min(1)).min(1).optional(),
|
|
15445
|
+
durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
|
|
15364
15446
|
/**
|
|
15365
15447
|
* Silence this for EVERY recipient, not just the caller. Permission is
|
|
15366
15448
|
* checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
|
|
@@ -15385,6 +15467,10 @@ var NcSnoozeSchema = object({
|
|
|
15385
15467
|
scope: NcSnoozeScopeSchema,
|
|
15386
15468
|
ruleId: string().optional(),
|
|
15387
15469
|
deviceId: number().int().optional(),
|
|
15470
|
+
/** Subject classes this window covers. ABSENT = every class — see
|
|
15471
|
+
* {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
|
|
15472
|
+
* no SQLite column: nothing queries a window by class. */
|
|
15473
|
+
classes: array(string().min(1)).min(1).optional(),
|
|
15388
15474
|
startedAt: number(),
|
|
15389
15475
|
/** Exclusive: at exactly this instant the snooze is over. Expiry is a
|
|
15390
15476
|
* COMPARISON, not a job — no sweeper can leave the operator silenced. */
|
|
@@ -17485,7 +17571,14 @@ var zonesCapability = {
|
|
|
17485
17571
|
* handle. Slice shape is `{ zones: Zone[] }` so future extensions
|
|
17486
17572
|
* (e.g. zone groupings) can sit alongside the polygon list.
|
|
17487
17573
|
*/
|
|
17488
|
-
runtimeState: object({ zones: array(ZoneSchema).readonly() })
|
|
17574
|
+
runtimeState: object({ zones: array(ZoneSchema).readonly() }),
|
|
17575
|
+
/**
|
|
17576
|
+
* 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.
|
|
17577
|
+
*
|
|
17578
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
17579
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
17580
|
+
*/
|
|
17581
|
+
durability: "restored"
|
|
17489
17582
|
};
|
|
17490
17583
|
/**
|
|
17491
17584
|
* A bounding box in NORMALIZED [0,1] frame coordinates for `getNativeCrop`. The
|
|
@@ -20379,7 +20472,17 @@ var airQualitySensorCapability = {
|
|
|
20379
20472
|
schema: AirQualitySensorStatusSchema,
|
|
20380
20473
|
kind: "push"
|
|
20381
20474
|
},
|
|
20382
|
-
runtimeState: AirQualitySensorStatusSchema
|
|
20475
|
+
runtimeState: AirQualitySensorStatusSchema,
|
|
20476
|
+
/**
|
|
20477
|
+
* Runtime-state durability: **restored** — as `numeric-sensor`.
|
|
20478
|
+
*
|
|
20479
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
20480
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
20481
|
+
*/
|
|
20482
|
+
durability: "restored",
|
|
20483
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
20484
|
+
* whether persisting is worth a SQLite commit. */
|
|
20485
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
20383
20486
|
};
|
|
20384
20487
|
/**
|
|
20385
20488
|
* Ambient illuminance reading in lux. Drives Home Assistant `sensor`
|
|
@@ -20411,7 +20514,17 @@ var ambientLightSensorCapability = {
|
|
|
20411
20514
|
schema: AmbientLightSensorStatusSchema,
|
|
20412
20515
|
kind: "push"
|
|
20413
20516
|
},
|
|
20414
|
-
runtimeState: AmbientLightSensorStatusSchema
|
|
20517
|
+
runtimeState: AmbientLightSensorStatusSchema,
|
|
20518
|
+
/**
|
|
20519
|
+
* Runtime-state durability: **restored** — as `numeric-sensor`.
|
|
20520
|
+
*
|
|
20521
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
20522
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
20523
|
+
*/
|
|
20524
|
+
durability: "restored",
|
|
20525
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
20526
|
+
* whether persisting is worth a SQLite commit. */
|
|
20527
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
20415
20528
|
};
|
|
20416
20529
|
/**
|
|
20417
20530
|
* Per-class audio metrics aggregated over a sliding window.
|
|
@@ -20529,7 +20642,14 @@ var audioMetricsCapability = {
|
|
|
20529
20642
|
}), AudioMetricsHistorySchema)
|
|
20530
20643
|
},
|
|
20531
20644
|
/** Reactive runtime-state mirror — live `device.state.audioMetrics.value`. */
|
|
20532
|
-
runtimeState: AudioMetricsSnapshotSchema
|
|
20645
|
+
runtimeState: AudioMetricsSnapshotSchema,
|
|
20646
|
+
/**
|
|
20647
|
+
* 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.
|
|
20648
|
+
*
|
|
20649
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
20650
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
20651
|
+
*/
|
|
20652
|
+
durability: "session"
|
|
20533
20653
|
};
|
|
20534
20654
|
/**
|
|
20535
20655
|
* Automation-control cap. Models HA `automation.*` entities on
|
|
@@ -20591,7 +20711,14 @@ var automationControlCapability = {
|
|
|
20591
20711
|
* reads `enabled` (toggle) + `isRunning` (spinner) + `lastError`
|
|
20592
20712
|
* (badge) directly.
|
|
20593
20713
|
*/
|
|
20594
|
-
runtimeState: AutomationControlStatusSchema
|
|
20714
|
+
runtimeState: AutomationControlStatusSchema,
|
|
20715
|
+
/**
|
|
20716
|
+
* 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.
|
|
20717
|
+
*
|
|
20718
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
20719
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
20720
|
+
*/
|
|
20721
|
+
durability: "session"
|
|
20595
20722
|
};
|
|
20596
20723
|
/**
|
|
20597
20724
|
* Battery status snapshot. Emitted by providers whose device is
|
|
@@ -20697,7 +20824,17 @@ onStatusChanged: { data: object({
|
|
|
20697
20824
|
* via `device.runtimeState.getCapState('battery')` regardless of
|
|
20698
20825
|
* the underlying driver.
|
|
20699
20826
|
*/
|
|
20700
|
-
runtimeState: BatteryStatusSchema
|
|
20827
|
+
runtimeState: BatteryStatusSchema,
|
|
20828
|
+
/**
|
|
20829
|
+
* 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.
|
|
20830
|
+
*
|
|
20831
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
20832
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
20833
|
+
*/
|
|
20834
|
+
durability: "restored",
|
|
20835
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
20836
|
+
* whether persisting is worth a SQLite commit. */
|
|
20837
|
+
volatileStateFields: ["lastUpdated"]
|
|
20701
20838
|
};
|
|
20702
20839
|
/**
|
|
20703
20840
|
* Generic boolean sensor — last-resort fallback when no domain-
|
|
@@ -20726,7 +20863,17 @@ var binaryCapability = {
|
|
|
20726
20863
|
schema: BinaryStatusSchema,
|
|
20727
20864
|
kind: "push"
|
|
20728
20865
|
},
|
|
20729
|
-
runtimeState: BinaryStatusSchema
|
|
20866
|
+
runtimeState: BinaryStatusSchema,
|
|
20867
|
+
/**
|
|
20868
|
+
* Runtime-state durability: **restored** — transition-driven sensor state; the restored value gives the boot comparison.
|
|
20869
|
+
*
|
|
20870
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
20871
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
20872
|
+
*/
|
|
20873
|
+
durability: "restored",
|
|
20874
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
20875
|
+
* whether persisting is worth a SQLite commit. */
|
|
20876
|
+
volatileStateFields: ["lastChangedAt"]
|
|
20730
20877
|
};
|
|
20731
20878
|
/**
|
|
20732
20879
|
* Dimmable-light brightness control. Co-exists with `switch` on the
|
|
@@ -20779,7 +20926,14 @@ onBrightnessChanged: { data: object({
|
|
|
20779
20926
|
* by the kernel. Read via `device.state.brightness.value` so UI
|
|
20780
20927
|
* sliders surface the current level without polling the provider.
|
|
20781
20928
|
*/
|
|
20782
|
-
runtimeState: BrightnessStatusSchema
|
|
20929
|
+
runtimeState: BrightnessStatusSchema,
|
|
20930
|
+
/**
|
|
20931
|
+
* Runtime-state durability: **session** — live lamp state, re-published by the provider on connect.
|
|
20932
|
+
*
|
|
20933
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
20934
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
20935
|
+
*/
|
|
20936
|
+
durability: "session"
|
|
20783
20937
|
};
|
|
20784
20938
|
DeviceType.Button, method(object({ deviceId: number().int().nonnegative() }), _void(), {
|
|
20785
20939
|
kind: "mutation",
|
|
@@ -20867,7 +21021,17 @@ var carbonMonoxideCapability = {
|
|
|
20867
21021
|
schema: CarbonMonoxideStatusSchema,
|
|
20868
21022
|
kind: "push"
|
|
20869
21023
|
},
|
|
20870
|
-
runtimeState: CarbonMonoxideStatusSchema
|
|
21024
|
+
runtimeState: CarbonMonoxideStatusSchema,
|
|
21025
|
+
/**
|
|
21026
|
+
* Runtime-state durability: **restored** — as `smoke`.
|
|
21027
|
+
*
|
|
21028
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
21029
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
21030
|
+
*/
|
|
21031
|
+
durability: "restored",
|
|
21032
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
21033
|
+
* whether persisting is worth a SQLite commit. */
|
|
21034
|
+
volatileStateFields: ["lastChangedAt"]
|
|
20871
21035
|
};
|
|
20872
21036
|
/**
|
|
20873
21037
|
* HVAC / climate control cap. Models the full surface of a HA
|
|
@@ -21027,7 +21191,14 @@ var climateControlCapability = {
|
|
|
21027
21191
|
* the full slice via `device.state.climate-control.value` and refresh
|
|
21028
21192
|
* on every push without re-querying the provider.
|
|
21029
21193
|
*/
|
|
21030
|
-
runtimeState: ClimateControlStatusSchema
|
|
21194
|
+
runtimeState: ClimateControlStatusSchema,
|
|
21195
|
+
/**
|
|
21196
|
+
* Runtime-state durability: **session** — as `brightness`; `currentTemp` moves continuously and is re-published on connect.
|
|
21197
|
+
*
|
|
21198
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
21199
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
21200
|
+
*/
|
|
21201
|
+
durability: "session"
|
|
21031
21202
|
};
|
|
21032
21203
|
/**
|
|
21033
21204
|
* Color-light cap. Coexists with `switch` (on/off) and `brightness`
|
|
@@ -21137,7 +21308,14 @@ onColorChanged: { data: object({
|
|
|
21137
21308
|
* kernel. Read via `device.state.color.value` so UI pickers surface
|
|
21138
21309
|
* the current chromaticity without polling the provider.
|
|
21139
21310
|
*/
|
|
21140
|
-
runtimeState: ColorStatusSchema
|
|
21311
|
+
runtimeState: ColorStatusSchema,
|
|
21312
|
+
/**
|
|
21313
|
+
* Runtime-state durability: **session** — as `brightness`.
|
|
21314
|
+
*
|
|
21315
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
21316
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
21317
|
+
*/
|
|
21318
|
+
durability: "session"
|
|
21141
21319
|
};
|
|
21142
21320
|
var ConnectionTestOutcomeSchema = discriminatedUnion("outcome", [
|
|
21143
21321
|
object({
|
|
@@ -21195,7 +21373,17 @@ var connectivityCapability = {
|
|
|
21195
21373
|
schema: ConnectivityStatusSchema,
|
|
21196
21374
|
kind: "push"
|
|
21197
21375
|
},
|
|
21198
|
-
runtimeState: ConnectivityStatusSchema
|
|
21376
|
+
runtimeState: ConnectivityStatusSchema,
|
|
21377
|
+
/**
|
|
21378
|
+
* Runtime-state durability: **restored** — same shape and same argument as `device-status`, for links rather than devices.
|
|
21379
|
+
*
|
|
21380
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
21381
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
21382
|
+
*/
|
|
21383
|
+
durability: "restored",
|
|
21384
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
21385
|
+
* whether persisting is worth a SQLite commit. */
|
|
21386
|
+
volatileStateFields: ["lastChangedAt"]
|
|
21199
21387
|
};
|
|
21200
21388
|
/**
|
|
21201
21389
|
* Generic device-consumables capability — surfaces a device's
|
|
@@ -21277,7 +21465,14 @@ reset: method(object({
|
|
|
21277
21465
|
}
|
|
21278
21466
|
}
|
|
21279
21467
|
},
|
|
21280
|
-
runtimeState: ConsumablesStatusSchema.extend({ lastFetchedAt: number() })
|
|
21468
|
+
runtimeState: ConsumablesStatusSchema.extend({ lastFetchedAt: number() }),
|
|
21469
|
+
/**
|
|
21470
|
+
* Runtime-state durability: **session** — the authority is the appliance; the provider re-reads the whole item array on connect.
|
|
21471
|
+
*
|
|
21472
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
21473
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
21474
|
+
*/
|
|
21475
|
+
durability: "session"
|
|
21281
21476
|
};
|
|
21282
21477
|
/**
|
|
21283
21478
|
* Door / window / opening / garage / valve contact sensor. Boolean
|
|
@@ -21308,7 +21503,17 @@ var contactCapability = {
|
|
|
21308
21503
|
schema: ContactStatusSchema,
|
|
21309
21504
|
kind: "push"
|
|
21310
21505
|
},
|
|
21311
|
-
runtimeState: ContactStatusSchema
|
|
21506
|
+
runtimeState: ContactStatusSchema,
|
|
21507
|
+
/**
|
|
21508
|
+
* Runtime-state durability: **restored** — a door left open across a restart must still read open.
|
|
21509
|
+
*
|
|
21510
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
21511
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
21512
|
+
*/
|
|
21513
|
+
durability: "restored",
|
|
21514
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
21515
|
+
* whether persisting is worth a SQLite commit. */
|
|
21516
|
+
volatileStateFields: ["lastChangedAt"]
|
|
21312
21517
|
};
|
|
21313
21518
|
/**
|
|
21314
21519
|
* Status slice — flat object (the framework's `runtimeState` contract
|
|
@@ -21414,7 +21619,14 @@ var controlCapability = {
|
|
|
21414
21619
|
* dropdown / text field / date picker) read the slice's discriminant
|
|
21415
21620
|
* and value directly without polling the provider.
|
|
21416
21621
|
*/
|
|
21417
|
-
runtimeState: ControlStatusSchema
|
|
21622
|
+
runtimeState: ControlStatusSchema,
|
|
21623
|
+
/**
|
|
21624
|
+
* Runtime-state durability: **session** — a generic control mirrors an external entity that re-publishes on connect; the options array is re-derived with it.
|
|
21625
|
+
*
|
|
21626
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
21627
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
21628
|
+
*/
|
|
21629
|
+
durability: "session"
|
|
21418
21630
|
};
|
|
21419
21631
|
var CoverStatusSchema = object({
|
|
21420
21632
|
/** Lifecycle state of the cover. */
|
|
@@ -21475,7 +21687,17 @@ var coverCapability = {
|
|
|
21475
21687
|
* Runtime-state slice — mirrored by the kernel. UI controls watch
|
|
21476
21688
|
* the slice for live position changes during a move.
|
|
21477
21689
|
*/
|
|
21478
|
-
runtimeState: CoverStatusSchema
|
|
21690
|
+
runtimeState: CoverStatusSchema,
|
|
21691
|
+
/**
|
|
21692
|
+
* Runtime-state durability: **restored** — position survives a restart on the device; the mirror should agree at boot rather than read blank.
|
|
21693
|
+
*
|
|
21694
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
21695
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
21696
|
+
*/
|
|
21697
|
+
durability: "restored",
|
|
21698
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
21699
|
+
* whether persisting is worth a SQLite commit. */
|
|
21700
|
+
volatileStateFields: ["lastChangedAt"]
|
|
21479
21701
|
};
|
|
21480
21702
|
/**
|
|
21481
21703
|
* Vendor-neutral day/night (IR-cut) control — the per-camera config cap
|
|
@@ -21569,7 +21791,17 @@ var dayNightCapability = {
|
|
|
21569
21791
|
schema: DayNightStatusSchema,
|
|
21570
21792
|
kind: "poll"
|
|
21571
21793
|
},
|
|
21572
|
-
runtimeState: DayNightStatusSchema
|
|
21794
|
+
runtimeState: DayNightStatusSchema,
|
|
21795
|
+
/**
|
|
21796
|
+
* Runtime-state durability: **restored** — operator-set IR-cut behaviour; mutation-driven.
|
|
21797
|
+
*
|
|
21798
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
21799
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
21800
|
+
*/
|
|
21801
|
+
durability: "restored",
|
|
21802
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
21803
|
+
* whether persisting is worth a SQLite commit. */
|
|
21804
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
21573
21805
|
};
|
|
21574
21806
|
/**
|
|
21575
21807
|
* Generic device-level status snapshot. Auto-registered by `BaseDevice`
|
|
@@ -21616,7 +21848,17 @@ onStatusChanged: { data: object({
|
|
|
21616
21848
|
schema: DeviceStatusSchema,
|
|
21617
21849
|
kind: "push"
|
|
21618
21850
|
},
|
|
21619
|
-
runtimeState: DeviceStatusSchema
|
|
21851
|
+
runtimeState: DeviceStatusSchema,
|
|
21852
|
+
/**
|
|
21853
|
+
* 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.
|
|
21854
|
+
*
|
|
21855
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
21856
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
21857
|
+
*/
|
|
21858
|
+
durability: "restored",
|
|
21859
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
21860
|
+
* whether persisting is worth a SQLite commit. */
|
|
21861
|
+
volatileStateFields: ["lastChangedAt"]
|
|
21620
21862
|
};
|
|
21621
21863
|
/**
|
|
21622
21864
|
* Doorbell button cap. Two kinds of providers coexist behind this cap
|
|
@@ -21678,7 +21920,14 @@ onPressed: { data: DoorbellPressEventSchema } },
|
|
|
21678
21920
|
* `device.state.doorbell.value`. UIs can show "last ring 5m ago"
|
|
21679
21921
|
* without subscribing.
|
|
21680
21922
|
*/
|
|
21681
|
-
runtimeState: DoorbellStatusSchema
|
|
21923
|
+
runtimeState: DoorbellStatusSchema,
|
|
21924
|
+
/**
|
|
21925
|
+
* 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.
|
|
21926
|
+
*
|
|
21927
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
21928
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
21929
|
+
*/
|
|
21930
|
+
durability: "restored"
|
|
21682
21931
|
};
|
|
21683
21932
|
/**
|
|
21684
21933
|
* Enum-state sensor — a string value picked from a finite option set.
|
|
@@ -21718,7 +21967,17 @@ var enumSensorCapability = {
|
|
|
21718
21967
|
schema: EnumSensorStatusSchema,
|
|
21719
21968
|
kind: "push"
|
|
21720
21969
|
},
|
|
21721
|
-
runtimeState: EnumSensorStatusSchema
|
|
21970
|
+
runtimeState: EnumSensorStatusSchema,
|
|
21971
|
+
/**
|
|
21972
|
+
* Runtime-state durability: **restored** — as `numeric-sensor`; 80 devices.
|
|
21973
|
+
*
|
|
21974
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
21975
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
21976
|
+
*/
|
|
21977
|
+
durability: "restored",
|
|
21978
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
21979
|
+
* whether persisting is worth a SQLite commit. */
|
|
21980
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
21722
21981
|
};
|
|
21723
21982
|
/**
|
|
21724
21983
|
* Generic stateless event emitter. Installed on a `DeviceType.EventEmitter`
|
|
@@ -21754,7 +22013,14 @@ var eventEmitterCapability = {
|
|
|
21754
22013
|
schema: EventEmitterStatusSchema,
|
|
21755
22014
|
kind: "push"
|
|
21756
22015
|
},
|
|
21757
|
-
runtimeState: EventEmitterStatusSchema
|
|
22016
|
+
runtimeState: EventEmitterStatusSchema,
|
|
22017
|
+
/**
|
|
22018
|
+
* Runtime-state durability: **session** — `eventCountSinceStart` names its own scope.
|
|
22019
|
+
*
|
|
22020
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
22021
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
22022
|
+
*/
|
|
22023
|
+
durability: "session"
|
|
21758
22024
|
};
|
|
21759
22025
|
var EventItemSchema = object({
|
|
21760
22026
|
id: string(),
|
|
@@ -22035,7 +22301,14 @@ var fanControlCapability = {
|
|
|
22035
22301
|
* Runtime-state slice — mirrored by the kernel. UI fan speed
|
|
22036
22302
|
* sliders read `percentage` for live updates.
|
|
22037
22303
|
*/
|
|
22038
|
-
runtimeState: FanControlStatusSchema
|
|
22304
|
+
runtimeState: FanControlStatusSchema,
|
|
22305
|
+
/**
|
|
22306
|
+
* Runtime-state durability: **session** — as `brightness`.
|
|
22307
|
+
*
|
|
22308
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
22309
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
22310
|
+
*/
|
|
22311
|
+
durability: "session"
|
|
22039
22312
|
};
|
|
22040
22313
|
/**
|
|
22041
22314
|
* Per-device feature/identity probe slice. Holds the runtime-resolved
|
|
@@ -22111,7 +22384,14 @@ onProbeChanged: { data: object({
|
|
|
22111
22384
|
schema: FeatureProbeStatusSchema,
|
|
22112
22385
|
kind: "push"
|
|
22113
22386
|
},
|
|
22114
|
-
runtimeState: FeatureProbeStatusSchema
|
|
22387
|
+
runtimeState: FeatureProbeStatusSchema,
|
|
22388
|
+
/**
|
|
22389
|
+
* 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.
|
|
22390
|
+
*
|
|
22391
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
22392
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
22393
|
+
*/
|
|
22394
|
+
durability: "session"
|
|
22115
22395
|
};
|
|
22116
22396
|
/**
|
|
22117
22397
|
* Water leak / moisture sensor. Boolean "is liquid currently
|
|
@@ -22138,7 +22418,17 @@ var floodCapability = {
|
|
|
22138
22418
|
schema: FloodStatusSchema,
|
|
22139
22419
|
kind: "push"
|
|
22140
22420
|
},
|
|
22141
|
-
runtimeState: FloodStatusSchema
|
|
22421
|
+
runtimeState: FloodStatusSchema,
|
|
22422
|
+
/**
|
|
22423
|
+
* Runtime-state durability: **restored** — as `smoke`.
|
|
22424
|
+
*
|
|
22425
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
22426
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
22427
|
+
*/
|
|
22428
|
+
durability: "restored",
|
|
22429
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
22430
|
+
* whether persisting is worth a SQLite commit. */
|
|
22431
|
+
volatileStateFields: ["lastChangedAt"]
|
|
22142
22432
|
};
|
|
22143
22433
|
/**
|
|
22144
22434
|
* Combustible-gas (LPG / methane / hydrogen) alarm sensor. Drives
|
|
@@ -22161,7 +22451,17 @@ var gasCapability = {
|
|
|
22161
22451
|
schema: GasStatusSchema,
|
|
22162
22452
|
kind: "push"
|
|
22163
22453
|
},
|
|
22164
|
-
runtimeState: GasStatusSchema
|
|
22454
|
+
runtimeState: GasStatusSchema,
|
|
22455
|
+
/**
|
|
22456
|
+
* Runtime-state durability: **restored** — as `smoke`.
|
|
22457
|
+
*
|
|
22458
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
22459
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
22460
|
+
*/
|
|
22461
|
+
durability: "restored",
|
|
22462
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
22463
|
+
* whether persisting is worth a SQLite commit. */
|
|
22464
|
+
volatileStateFields: ["lastChangedAt"]
|
|
22165
22465
|
};
|
|
22166
22466
|
/**
|
|
22167
22467
|
* Humidifier / dehumidifier cap. Models HA `humidifier.*` entities —
|
|
@@ -22237,7 +22537,14 @@ var humidifierCapability = {
|
|
|
22237
22537
|
* Runtime-state slice — mirrored by the kernel. UI controls watch the
|
|
22238
22538
|
* slice for live humidity / mode changes.
|
|
22239
22539
|
*/
|
|
22240
|
-
runtimeState: HumidifierStatusSchema
|
|
22540
|
+
runtimeState: HumidifierStatusSchema,
|
|
22541
|
+
/**
|
|
22542
|
+
* Runtime-state durability: **session** — as `climate-control`.
|
|
22543
|
+
*
|
|
22544
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
22545
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
22546
|
+
*/
|
|
22547
|
+
durability: "session"
|
|
22241
22548
|
};
|
|
22242
22549
|
/**
|
|
22243
22550
|
* Single-metric humidity reading. Drives Home Assistant `sensor`
|
|
@@ -22273,7 +22580,17 @@ var humiditySensorCapability = {
|
|
|
22273
22580
|
schema: HumiditySensorStatusSchema,
|
|
22274
22581
|
kind: "push"
|
|
22275
22582
|
},
|
|
22276
|
-
runtimeState: HumiditySensorStatusSchema
|
|
22583
|
+
runtimeState: HumiditySensorStatusSchema,
|
|
22584
|
+
/**
|
|
22585
|
+
* Runtime-state durability: **restored** — as `numeric-sensor` (67 of 75 writes were the clock alone).
|
|
22586
|
+
*
|
|
22587
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
22588
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
22589
|
+
*/
|
|
22590
|
+
durability: "restored",
|
|
22591
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
22592
|
+
* whether persisting is worth a SQLite commit. */
|
|
22593
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
22277
22594
|
};
|
|
22278
22595
|
/**
|
|
22279
22596
|
* Image display cap. Models a single still image exposed by an integration —
|
|
@@ -22311,7 +22628,14 @@ var imageCapability = {
|
|
|
22311
22628
|
* Runtime-state slice — mirrored by the kernel. The UI reads `url`
|
|
22312
22629
|
* directly and renders the still image.
|
|
22313
22630
|
*/
|
|
22314
|
-
runtimeState: ImageStatusSchema
|
|
22631
|
+
runtimeState: ImageStatusSchema,
|
|
22632
|
+
/**
|
|
22633
|
+
* Runtime-state durability: **session** — a snapshot URL is a session-scoped handle; a restored one points at nothing.
|
|
22634
|
+
*
|
|
22635
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
22636
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
22637
|
+
*/
|
|
22638
|
+
durability: "session"
|
|
22315
22639
|
};
|
|
22316
22640
|
/**
|
|
22317
22641
|
* Vendor-neutral image / picture-adjustment cap — the per-camera config
|
|
@@ -22460,7 +22784,17 @@ var imageSettingsCapability = {
|
|
|
22460
22784
|
schema: ImageSettingsStatusSchema,
|
|
22461
22785
|
kind: "poll"
|
|
22462
22786
|
},
|
|
22463
|
-
runtimeState: ImageSettingsStatusSchema
|
|
22787
|
+
runtimeState: ImageSettingsStatusSchema,
|
|
22788
|
+
/**
|
|
22789
|
+
* Runtime-state durability: **restored** — operator-set camera imaging; mutation-driven.
|
|
22790
|
+
*
|
|
22791
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
22792
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
22793
|
+
*/
|
|
22794
|
+
durability: "restored",
|
|
22795
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
22796
|
+
* whether persisting is worth a SQLite commit. */
|
|
22797
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
22464
22798
|
};
|
|
22465
22799
|
/**
|
|
22466
22800
|
* integrations — system-scoped singleton capability for integration
|
|
@@ -22851,7 +23185,14 @@ var lawnMowerControlCapability = {
|
|
|
22851
23185
|
* Runtime-state slice — mirrored by the kernel. UI controls watch the
|
|
22852
23186
|
* slice for live activity + battery changes.
|
|
22853
23187
|
*/
|
|
22854
|
-
runtimeState: LawnMowerControlStatusSchema
|
|
23188
|
+
runtimeState: LawnMowerControlStatusSchema,
|
|
23189
|
+
/**
|
|
23190
|
+
* Runtime-state durability: **session** — as `vacuum-control`.
|
|
23191
|
+
*
|
|
23192
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
23193
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
23194
|
+
*/
|
|
23195
|
+
durability: "session"
|
|
22855
23196
|
};
|
|
22856
23197
|
/**
|
|
22857
23198
|
* local-network — hub-only singleton.
|
|
@@ -23057,7 +23398,17 @@ var lockControlCapability = {
|
|
|
23057
23398
|
* read `state` and disable themselves during `locking`/`unlocking`
|
|
23058
23399
|
* transitions.
|
|
23059
23400
|
*/
|
|
23060
|
-
runtimeState: LockControlStatusSchema
|
|
23401
|
+
runtimeState: LockControlStatusSchema,
|
|
23402
|
+
/**
|
|
23403
|
+
* Runtime-state durability: **restored** — a lock left locked must still read locked.
|
|
23404
|
+
*
|
|
23405
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
23406
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
23407
|
+
*/
|
|
23408
|
+
durability: "restored",
|
|
23409
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
23410
|
+
* whether persisting is worth a SQLite commit. */
|
|
23411
|
+
volatileStateFields: ["lastChangedAt"]
|
|
23061
23412
|
};
|
|
23062
23413
|
/**
|
|
23063
23414
|
* Media-player cap. Models HA `media_player.*` (Sonos, Chromecast,
|
|
@@ -23219,7 +23570,14 @@ var mediaPlayerCapability = {
|
|
|
23219
23570
|
* full slice for live now-playing, volume, and progress updates
|
|
23220
23571
|
* without polling.
|
|
23221
23572
|
*/
|
|
23222
|
-
runtimeState: MediaPlayerStatusSchema
|
|
23573
|
+
runtimeState: MediaPlayerStatusSchema,
|
|
23574
|
+
/**
|
|
23575
|
+
* Runtime-state durability: **session** — a restored transport position describes a playback that stopped when the hub did.
|
|
23576
|
+
*
|
|
23577
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
23578
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
23579
|
+
*/
|
|
23580
|
+
durability: "session"
|
|
23223
23581
|
};
|
|
23224
23582
|
/**
|
|
23225
23583
|
* mesh-network — collection cap for mesh-VPN providers.
|
|
@@ -23483,7 +23841,14 @@ onMotionChanged: { data: MotionOnMotionChangedDataSchema } },
|
|
|
23483
23841
|
* `device.state.motion.value`. Reads never invoke the provider, so
|
|
23484
23842
|
* UIs and other addons can poll the cached state safely.
|
|
23485
23843
|
*/
|
|
23486
|
-
runtimeState: MotionStatusSchema
|
|
23844
|
+
runtimeState: MotionStatusSchema,
|
|
23845
|
+
/**
|
|
23846
|
+
* 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.
|
|
23847
|
+
*
|
|
23848
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
23849
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
23850
|
+
*/
|
|
23851
|
+
durability: "session"
|
|
23487
23852
|
};
|
|
23488
23853
|
/**
|
|
23489
23854
|
* Motion-trigger toggle for accessory devices.
|
|
@@ -23548,7 +23913,14 @@ var motionTriggerCapability = {
|
|
|
23548
23913
|
schema: MotionTriggerStatusSchema,
|
|
23549
23914
|
kind: "command-driven"
|
|
23550
23915
|
},
|
|
23551
|
-
runtimeState: MotionTriggerRuntimeStateSchema
|
|
23916
|
+
runtimeState: MotionTriggerRuntimeStateSchema,
|
|
23917
|
+
/**
|
|
23918
|
+
* 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.
|
|
23919
|
+
*
|
|
23920
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
23921
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
23922
|
+
*/
|
|
23923
|
+
durability: "session"
|
|
23552
23924
|
};
|
|
23553
23925
|
/**
|
|
23554
23926
|
* Motion-zones share the same MaskShape vocabulary as privacy-mask — the
|
|
@@ -23615,7 +23987,17 @@ var motionZonesCapability = {
|
|
|
23615
23987
|
schema: MotionZoneStatusSchema,
|
|
23616
23988
|
kind: "poll"
|
|
23617
23989
|
},
|
|
23618
|
-
runtimeState: MotionZoneStatusSchema
|
|
23990
|
+
runtimeState: MotionZoneStatusSchema,
|
|
23991
|
+
/**
|
|
23992
|
+
* 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.
|
|
23993
|
+
*
|
|
23994
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
23995
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
23996
|
+
*/
|
|
23997
|
+
durability: "restored",
|
|
23998
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
23999
|
+
* whether persisting is worth a SQLite commit. */
|
|
24000
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
23619
24001
|
};
|
|
23620
24002
|
/**
|
|
23621
24003
|
* On-camera AI object detection cap. Surfaces per-device the classes
|
|
@@ -23689,7 +24071,17 @@ var nativeObjectDetectionCapability = {
|
|
|
23689
24071
|
schema: NativeObjectDetectionStatusSchema,
|
|
23690
24072
|
kind: "push"
|
|
23691
24073
|
},
|
|
23692
|
-
runtimeState: NativeObjectDetectionRuntimeStateSchema
|
|
24074
|
+
runtimeState: NativeObjectDetectionRuntimeStateSchema,
|
|
24075
|
+
/**
|
|
24076
|
+
* 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.
|
|
24077
|
+
*
|
|
24078
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
24079
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
24080
|
+
*/
|
|
24081
|
+
durability: "restored",
|
|
24082
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
24083
|
+
* whether persisting is worth a SQLite commit. */
|
|
24084
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
23693
24085
|
};
|
|
23694
24086
|
/**
|
|
23695
24087
|
* network-quality — system-scoped singleton capability tracking RTT,
|
|
@@ -24023,7 +24415,14 @@ onSent: { data: object({
|
|
|
24023
24415
|
* form reads `supports` to gate optional fields; history pane reads
|
|
24024
24416
|
* `lastSentAt` / `lastError` / `queueDepth`.
|
|
24025
24417
|
*/
|
|
24026
|
-
runtimeState: NotifierStatusSchema
|
|
24418
|
+
runtimeState: NotifierStatusSchema,
|
|
24419
|
+
/**
|
|
24420
|
+
* Runtime-state durability: **session** — live queue depth and last-send state; a restored queue depth describes a queue that no longer exists.
|
|
24421
|
+
*
|
|
24422
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
24423
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
24424
|
+
*/
|
|
24425
|
+
durability: "session"
|
|
24027
24426
|
};
|
|
24028
24427
|
/**
|
|
24029
24428
|
* Generic numeric sensor — last-resort fallback when no typed numeric
|
|
@@ -24066,7 +24465,17 @@ var numericSensorCapability = {
|
|
|
24066
24465
|
schema: NumericSensorStatusSchema,
|
|
24067
24466
|
kind: "push"
|
|
24068
24467
|
},
|
|
24069
|
-
runtimeState: NumericSensorStatusSchema
|
|
24468
|
+
runtimeState: NumericSensorStatusSchema,
|
|
24469
|
+
/**
|
|
24470
|
+
* 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.
|
|
24471
|
+
*
|
|
24472
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
24473
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
24474
|
+
*/
|
|
24475
|
+
durability: "restored",
|
|
24476
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
24477
|
+
* whether persisting is worth a SQLite commit. */
|
|
24478
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
24070
24479
|
};
|
|
24071
24480
|
/**
|
|
24072
24481
|
* Generic on-screen-display (video overlay) cap. Each camera exposes
|
|
@@ -24451,7 +24860,14 @@ var petFeederCapability = {
|
|
|
24451
24860
|
* the full slice via `device.state.petFeeder.value` and refresh on
|
|
24452
24861
|
* every poll without re-querying the provider.
|
|
24453
24862
|
*/
|
|
24454
|
-
runtimeState: PetFeederStatusSchema
|
|
24863
|
+
runtimeState: PetFeederStatusSchema,
|
|
24864
|
+
/**
|
|
24865
|
+
* Runtime-state durability: **session** — live appliance state re-published on connect.
|
|
24866
|
+
*
|
|
24867
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
24868
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
24869
|
+
*/
|
|
24870
|
+
durability: "session"
|
|
24455
24871
|
};
|
|
24456
24872
|
var VehicleSchema = object({
|
|
24457
24873
|
id: string(),
|
|
@@ -24763,7 +25179,17 @@ var powerMeterCapability = {
|
|
|
24763
25179
|
schema: PowerMeterStatusSchema,
|
|
24764
25180
|
kind: "push"
|
|
24765
25181
|
},
|
|
24766
|
-
runtimeState: PowerMeterStatusSchema
|
|
25182
|
+
runtimeState: PowerMeterStatusSchema,
|
|
25183
|
+
/**
|
|
25184
|
+
* Runtime-state durability: **restored** — as `numeric-sensor`; `kwhTotal` is an accumulator whose restored value is the baseline.
|
|
25185
|
+
*
|
|
25186
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
25187
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
25188
|
+
*/
|
|
25189
|
+
durability: "restored",
|
|
25190
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
25191
|
+
* whether persisting is worth a SQLite commit. */
|
|
25192
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
24767
25193
|
};
|
|
24768
25194
|
/**
|
|
24769
25195
|
* Presence cap. Models HA `person.*` and `device_tracker.*` entities
|
|
@@ -24820,7 +25246,17 @@ var presenceCapability = {
|
|
|
24820
25246
|
* the map pin is rendered (use `DeviceFeature.PresenceGps` for the
|
|
24821
25247
|
* pre-fetch fast-path check).
|
|
24822
25248
|
*/
|
|
24823
|
-
runtimeState: PresenceStatusSchema
|
|
25249
|
+
runtimeState: PresenceStatusSchema,
|
|
25250
|
+
/**
|
|
25251
|
+
* Runtime-state durability: **restored** — occupancy-relevant: the restored state is what an occupancy rule compares the first post-restart observation against.
|
|
25252
|
+
*
|
|
25253
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
25254
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
25255
|
+
*/
|
|
25256
|
+
durability: "restored",
|
|
25257
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
25258
|
+
* whether persisting is worth a SQLite commit. */
|
|
25259
|
+
volatileStateFields: ["lastChangedAt"]
|
|
24824
25260
|
};
|
|
24825
25261
|
/**
|
|
24826
25262
|
* Atmospheric pressure reading in hectopascals. Drives Home Assistant
|
|
@@ -24856,7 +25292,17 @@ var pressureSensorCapability = {
|
|
|
24856
25292
|
schema: PressureSensorStatusSchema,
|
|
24857
25293
|
kind: "push"
|
|
24858
25294
|
},
|
|
24859
|
-
runtimeState: PressureSensorStatusSchema
|
|
25295
|
+
runtimeState: PressureSensorStatusSchema,
|
|
25296
|
+
/**
|
|
25297
|
+
* Runtime-state durability: **restored** — as `numeric-sensor`.
|
|
25298
|
+
*
|
|
25299
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
25300
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
25301
|
+
*/
|
|
25302
|
+
durability: "restored",
|
|
25303
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
25304
|
+
* whether persisting is worth a SQLite commit. */
|
|
25305
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
24860
25306
|
};
|
|
24861
25307
|
/**
|
|
24862
25308
|
* PRIVACY — what the camera deliberately does not capture. Two planes:
|
|
@@ -24986,7 +25432,17 @@ var privacyMaskCapability = {
|
|
|
24986
25432
|
schema: PrivacyMaskStatusSchema,
|
|
24987
25433
|
kind: "poll"
|
|
24988
25434
|
},
|
|
24989
|
-
runtimeState: PrivacyMaskStatusSchema
|
|
25435
|
+
runtimeState: PrivacyMaskStatusSchema,
|
|
25436
|
+
/**
|
|
25437
|
+
* Runtime-state durability: **restored** — operator-drawn regions, zero real churn — 22 writes in 25 minutes, every one of them the clock.
|
|
25438
|
+
*
|
|
25439
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
25440
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
25441
|
+
*/
|
|
25442
|
+
durability: "restored",
|
|
25443
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
25444
|
+
* whether persisting is worth a SQLite commit. */
|
|
25445
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
24990
25446
|
};
|
|
24991
25447
|
/**
|
|
24992
25448
|
* Collapse a camera's PER-PROFILE audio flags into the one answer
|
|
@@ -25214,7 +25670,14 @@ var ptzAutotrackCapability = {
|
|
|
25214
25670
|
* fetch / cache / fallback logic out of the four cap methods —
|
|
25215
25671
|
* they become trampolines over `runtimeState`.
|
|
25216
25672
|
*/
|
|
25217
|
-
runtimeState: PtzAutotrackRuntimeStateSchema
|
|
25673
|
+
runtimeState: PtzAutotrackRuntimeStateSchema,
|
|
25674
|
+
/**
|
|
25675
|
+
* Runtime-state durability: **session** — mirrors the camera's own autotrack config, re-read on connect.
|
|
25676
|
+
*
|
|
25677
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
25678
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
25679
|
+
*/
|
|
25680
|
+
durability: "session"
|
|
25218
25681
|
};
|
|
25219
25682
|
/**
|
|
25220
25683
|
* reboot — device-scoped capability for "soft" device reboots (firmware
|
|
@@ -25586,13 +26049,24 @@ method(object({
|
|
|
25586
26049
|
/** Playback-speed multiplier for the render (1 = realtime). */
|
|
25587
26050
|
var ExportSpeedSchema = number().min(.25).max(32);
|
|
25588
26051
|
/**
|
|
25589
|
-
* One dense interval, in SECONDS FROM THE EXPORT'S OWN `fromMs`.
|
|
26052
|
+
* One dense interval, in WALL-CLOCK SECONDS FROM THE EXPORT'S OWN `fromMs`.
|
|
26053
|
+
*
|
|
26054
|
+
* **Wall clock, not ffmpeg's `t`** — and the recorder translates. A caller
|
|
26055
|
+
* derives these bounds from things that happened at a TIME (a track's
|
|
26056
|
+
* `firstSeen`), while `t` runs over the source playlist: the concatenation of
|
|
26057
|
+
* every segment present for the range, with each recording GAP removed. The
|
|
26058
|
+
* two agree only on a window that recorded without one interruption, and only
|
|
26059
|
+
* the render side knows the segments, so the translation lives there
|
|
26060
|
+
* (`export-dense-map.ts`, addon-pipeline).
|
|
26061
|
+
*
|
|
26062
|
+
* It was not always so. These seconds were fed to `between(t,…)` verbatim, and
|
|
26063
|
+
* on a 10 h window holding 29,393 s of footage every range landed late by the
|
|
26064
|
+
* gap accumulated before it — up to 6,607 s, well past EOF. Nothing matched,
|
|
26065
|
+
* the video was a uniform timelapse, and the log line reported the five ranges
|
|
26066
|
+
* that had been ASKED for (2026-08-13, export `57d14363`, camera 615).
|
|
25590
26067
|
*
|
|
25591
|
-
* Relative and not absolute epoch
|
|
25592
|
-
*
|
|
25593
|
-
* playlist. Handing it absolute epochs would make every call site responsible
|
|
25594
|
-
* for the same subtraction, and the one that forgot would emit a filter that
|
|
25595
|
-
* selects nothing — silently, as a uniform timelapse.
|
|
26068
|
+
* Relative and not absolute epoch, because an absolute epoch would make every
|
|
26069
|
+
* call site responsible for the same subtraction.
|
|
25596
26070
|
*/
|
|
25597
26071
|
var ExportDenseRangeSchema = object({
|
|
25598
26072
|
fromSec: number().nonnegative(),
|
|
@@ -25878,7 +26352,14 @@ var sceneMonitorCapability = {
|
|
|
25878
26352
|
schema: SceneMonitorStatusSchema,
|
|
25879
26353
|
kind: "push"
|
|
25880
26354
|
},
|
|
25881
|
-
runtimeState: SceneMonitorStatusSchema
|
|
26355
|
+
runtimeState: SceneMonitorStatusSchema,
|
|
26356
|
+
/**
|
|
26357
|
+
* Runtime-state durability: **session** — re-derived from the current scene on the next evaluation.
|
|
26358
|
+
*
|
|
26359
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
26360
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
26361
|
+
*/
|
|
26362
|
+
durability: "session"
|
|
25882
26363
|
};
|
|
25883
26364
|
/**
|
|
25884
26365
|
* Per-stage gating mode applied to the zones a rule references.
|
|
@@ -26022,7 +26503,14 @@ var scriptRunnerCapability = {
|
|
|
26022
26503
|
* `isRunning` to render a spinner during execution and surfaces
|
|
26023
26504
|
* `lastError` / `lastRunSuccess` in the recent-runs panel.
|
|
26024
26505
|
*/
|
|
26025
|
-
runtimeState: ScriptRunnerStatusSchema
|
|
26506
|
+
runtimeState: ScriptRunnerStatusSchema,
|
|
26507
|
+
/**
|
|
26508
|
+
* Runtime-state durability: **session** — a restored `isRunning: true` describes a process that died with the previous hub.
|
|
26509
|
+
*
|
|
26510
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
26511
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
26512
|
+
*/
|
|
26513
|
+
durability: "session"
|
|
26026
26514
|
};
|
|
26027
26515
|
/**
|
|
26028
26516
|
* Smoke alarm sensor — boolean "is smoke currently detected" with
|
|
@@ -26049,7 +26537,17 @@ var smokeCapability = {
|
|
|
26049
26537
|
schema: SmokeStatusSchema,
|
|
26050
26538
|
kind: "push"
|
|
26051
26539
|
},
|
|
26052
|
-
runtimeState: SmokeStatusSchema
|
|
26540
|
+
runtimeState: SmokeStatusSchema,
|
|
26541
|
+
/**
|
|
26542
|
+
* Runtime-state durability: **restored** — a safety sensor must not read "clear" merely because the hub restarted.
|
|
26543
|
+
*
|
|
26544
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
26545
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
26546
|
+
*/
|
|
26547
|
+
durability: "restored",
|
|
26548
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
26549
|
+
* whether persisting is worth a SQLite commit. */
|
|
26550
|
+
volatileStateFields: ["lastChangedAt"]
|
|
26053
26551
|
};
|
|
26054
26552
|
/**
|
|
26055
26553
|
* One publishable camera stream as its OWNING PROVIDER describes it — the same
|
|
@@ -26235,7 +26733,17 @@ var streamParamsCapability = {
|
|
|
26235
26733
|
schema: StreamParamsStatusSchema,
|
|
26236
26734
|
kind: "poll"
|
|
26237
26735
|
},
|
|
26238
|
-
runtimeState: StreamParamsStatusSchema
|
|
26736
|
+
runtimeState: StreamParamsStatusSchema,
|
|
26737
|
+
/**
|
|
26738
|
+
* Runtime-state durability: **restored** — operator-set encoder profile; mutation-driven.
|
|
26739
|
+
*
|
|
26740
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
26741
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
26742
|
+
*/
|
|
26743
|
+
durability: "restored",
|
|
26744
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
26745
|
+
* whether persisting is worth a SQLite commit. */
|
|
26746
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
26239
26747
|
};
|
|
26240
26748
|
/**
|
|
26241
26749
|
* The three well-known stream profiles in render order. Exported so the
|
|
@@ -26479,6 +26987,16 @@ var switchCapability = {
|
|
|
26479
26987
|
* not need to re-query the provider after a setState mutation.
|
|
26480
26988
|
*/
|
|
26481
26989
|
runtimeState: SwitchStatusSchema,
|
|
26990
|
+
/**
|
|
26991
|
+
* Runtime-state durability: **restored** — device state an operator reads as authoritative; 55 devices, transition-driven.
|
|
26992
|
+
*
|
|
26993
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
26994
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
26995
|
+
*/
|
|
26996
|
+
durability: "restored",
|
|
26997
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
26998
|
+
* whether persisting is worth a SQLite commit. */
|
|
26999
|
+
volatileStateFields: ["lastChangedAt"],
|
|
26482
27000
|
settings: { bindings: [{
|
|
26483
27001
|
kind: "scalar",
|
|
26484
27002
|
statusPath: "on",
|
|
@@ -26558,7 +27076,17 @@ var tamperCapability = {
|
|
|
26558
27076
|
schema: TamperStatusSchema,
|
|
26559
27077
|
kind: "push"
|
|
26560
27078
|
},
|
|
26561
|
-
runtimeState: TamperStatusSchema
|
|
27079
|
+
runtimeState: TamperStatusSchema,
|
|
27080
|
+
/**
|
|
27081
|
+
* Runtime-state durability: **restored** — as `smoke`.
|
|
27082
|
+
*
|
|
27083
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
27084
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
27085
|
+
*/
|
|
27086
|
+
durability: "restored",
|
|
27087
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
27088
|
+
* whether persisting is worth a SQLite commit. */
|
|
27089
|
+
volatileStateFields: ["lastChangedAt"]
|
|
26562
27090
|
};
|
|
26563
27091
|
/**
|
|
26564
27092
|
* Single-metric temperature reading. Drives Home Assistant `sensor`
|
|
@@ -26603,7 +27131,17 @@ var temperatureSensorCapability = {
|
|
|
26603
27131
|
schema: TemperatureSensorStatusSchema,
|
|
26604
27132
|
kind: "push"
|
|
26605
27133
|
},
|
|
26606
|
-
runtimeState: TemperatureSensorStatusSchema
|
|
27134
|
+
runtimeState: TemperatureSensorStatusSchema,
|
|
27135
|
+
/**
|
|
27136
|
+
* Runtime-state durability: **restored** — as `numeric-sensor` (69 of 125 writes were the clock alone).
|
|
27137
|
+
*
|
|
27138
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
27139
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
27140
|
+
*/
|
|
27141
|
+
durability: "restored",
|
|
27142
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
27143
|
+
* whether persisting is worth a SQLite commit. */
|
|
27144
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
26607
27145
|
};
|
|
26608
27146
|
/**
|
|
26609
27147
|
* toast — system-scoped singleton capability that streams toast
|
|
@@ -26672,7 +27210,14 @@ var updateCapability = {
|
|
|
26672
27210
|
schema: UpdateStatusSchema,
|
|
26673
27211
|
kind: "poll"
|
|
26674
27212
|
},
|
|
26675
|
-
runtimeState: UpdateStatusSchema
|
|
27213
|
+
runtimeState: UpdateStatusSchema,
|
|
27214
|
+
/**
|
|
27215
|
+
* Runtime-state durability: **session** — a restored `inProgress: true` describes an update that is no longer running; versions are re-probed at boot.
|
|
27216
|
+
*
|
|
27217
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
27218
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
27219
|
+
*/
|
|
27220
|
+
durability: "session"
|
|
26676
27221
|
};
|
|
26677
27222
|
var UserSummarySchema = object({
|
|
26678
27223
|
id: string(),
|
|
@@ -27006,7 +27551,14 @@ var vacuumControlCapability = {
|
|
|
27006
27551
|
* Runtime-state slice — mirrored by the kernel. UI controls watch the
|
|
27007
27552
|
* slice for live state + battery + fan-speed changes.
|
|
27008
27553
|
*/
|
|
27009
|
-
runtimeState: VacuumControlStatusSchema
|
|
27554
|
+
runtimeState: VacuumControlStatusSchema,
|
|
27555
|
+
/**
|
|
27556
|
+
* Runtime-state durability: **session** — as `media-player` — a restored `state: cleaning` is a robot that is not cleaning.
|
|
27557
|
+
*
|
|
27558
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
27559
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
27560
|
+
*/
|
|
27561
|
+
durability: "session"
|
|
27010
27562
|
};
|
|
27011
27563
|
var ValveStatusSchema = object({
|
|
27012
27564
|
/** Lifecycle state of the valve. */
|
|
@@ -27058,7 +27610,14 @@ var valveCapability = {
|
|
|
27058
27610
|
* Runtime-state slice — mirrored by the kernel. UI controls watch the
|
|
27059
27611
|
* slice for live position changes during a move.
|
|
27060
27612
|
*/
|
|
27061
|
-
runtimeState: ValveStatusSchema
|
|
27613
|
+
runtimeState: ValveStatusSchema,
|
|
27614
|
+
/**
|
|
27615
|
+
* Runtime-state durability: **session** — as `brightness`.
|
|
27616
|
+
*
|
|
27617
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
27618
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
27619
|
+
*/
|
|
27620
|
+
durability: "session"
|
|
27062
27621
|
};
|
|
27063
27622
|
/**
|
|
27064
27623
|
* Vibration / shake / impact sensor. Drives Home Assistant
|
|
@@ -27080,7 +27639,17 @@ var vibrationCapability = {
|
|
|
27080
27639
|
schema: VibrationStatusSchema,
|
|
27081
27640
|
kind: "push"
|
|
27082
27641
|
},
|
|
27083
|
-
runtimeState: VibrationStatusSchema
|
|
27642
|
+
runtimeState: VibrationStatusSchema,
|
|
27643
|
+
/**
|
|
27644
|
+
* Runtime-state durability: **restored** — as `smoke`.
|
|
27645
|
+
*
|
|
27646
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
27647
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
27648
|
+
*/
|
|
27649
|
+
durability: "restored",
|
|
27650
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
27651
|
+
* whether persisting is worth a SQLite commit. */
|
|
27652
|
+
volatileStateFields: ["lastChangedAt"]
|
|
27084
27653
|
};
|
|
27085
27654
|
/**
|
|
27086
27655
|
* Water heater / boiler cap. Models HA `water_heater.*` entities — a
|
|
@@ -27154,7 +27723,14 @@ var waterHeaterCapability = {
|
|
|
27154
27723
|
* Runtime-state slice — mirrored by the kernel. UI controls watch the
|
|
27155
27724
|
* slice for live temperature / mode / away changes.
|
|
27156
27725
|
*/
|
|
27157
|
-
runtimeState: WaterHeaterStatusSchema
|
|
27726
|
+
runtimeState: WaterHeaterStatusSchema,
|
|
27727
|
+
/**
|
|
27728
|
+
* Runtime-state durability: **session** — as `climate-control`.
|
|
27729
|
+
*
|
|
27730
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
27731
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
27732
|
+
*/
|
|
27733
|
+
durability: "session"
|
|
27158
27734
|
};
|
|
27159
27735
|
/**
|
|
27160
27736
|
* Weather provider cap. Models HA `weather.*` entities — a read-only
|
|
@@ -27213,7 +27789,14 @@ var weatherCapability = {
|
|
|
27213
27789
|
* Runtime-state slice — mirrored by the kernel. The UI reads the
|
|
27214
27790
|
* current conditions directly from the slice on each weather push.
|
|
27215
27791
|
*/
|
|
27216
|
-
runtimeState: WeatherStatusSchema
|
|
27792
|
+
runtimeState: WeatherStatusSchema,
|
|
27793
|
+
/**
|
|
27794
|
+
* Runtime-state durability: **session** — a forecast is stale the moment the hub is down; the provider re-fetches on connect.
|
|
27795
|
+
*
|
|
27796
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
27797
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
27798
|
+
*/
|
|
27799
|
+
durability: "session"
|
|
27217
27800
|
};
|
|
27218
27801
|
/**
|
|
27219
27802
|
* Per-zone occupancy aggregation produced by the analytics frame
|
|
@@ -27375,7 +27958,14 @@ var zoneAnalyticsCapability = {
|
|
|
27375
27958
|
* automatically; the explicit `getCurrentSnapshot` cap method is
|
|
27376
27959
|
* still useful for one-off polls without a subscription.
|
|
27377
27960
|
*/
|
|
27378
|
-
runtimeState: CameraOccupancySnapshotSchema
|
|
27961
|
+
runtimeState: CameraOccupancySnapshotSchema,
|
|
27962
|
+
/**
|
|
27963
|
+
* Runtime-state durability: **session** — per-frame analytics; with `audio-metrics` it is ~90 % of the offered write rate. Re-derived on the next frame.
|
|
27964
|
+
*
|
|
27965
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
27966
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
27967
|
+
*/
|
|
27968
|
+
durability: "session"
|
|
27379
27969
|
};
|
|
27380
27970
|
/**
|
|
27381
27971
|
* Stages a {@link ZoneRule} can apply to. Discriminator on the rules
|
|
@@ -27453,7 +28043,14 @@ var zoneRulesCapability = {
|
|
|
27453
28043
|
motion: array(ZoneRuleSchema).readonly(),
|
|
27454
28044
|
detection: array(ZoneRuleSchema).readonly(),
|
|
27455
28045
|
package: array(ZoneRuleSchema).readonly()
|
|
27456
|
-
})
|
|
28046
|
+
}),
|
|
28047
|
+
/**
|
|
28048
|
+
* Runtime-state durability: **restored** — operator intent, mutation-only, same argument as `zones`.
|
|
28049
|
+
*
|
|
28050
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
28051
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
28052
|
+
*/
|
|
28053
|
+
durability: "restored"
|
|
27457
28054
|
};
|
|
27458
28055
|
/**
|
|
27459
28056
|
* Accessory device helpers — shared across drivers.
|
|
@@ -34220,6 +34817,7 @@ Object.freeze({
|
|
|
34220
34817
|
"network-access": "ingress",
|
|
34221
34818
|
"smtp-provider": "email"
|
|
34222
34819
|
});
|
|
34820
|
+
new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
|
|
34223
34821
|
new Set(["devices", "classes"]);
|
|
34224
34822
|
/**
|
|
34225
34823
|
* TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
|
|
@@ -34497,25 +35095,32 @@ object({
|
|
|
34497
35095
|
var NativeLeaseAdmissionSchema = _enum(["all", "inferred"]);
|
|
34498
35096
|
object({
|
|
34499
35097
|
/**
|
|
34500
|
-
* How
|
|
35098
|
+
* How many delivered frames the worker HOLDS at once, waiting for each one's
|
|
35099
|
+
* detection result.
|
|
34501
35100
|
*
|
|
34502
|
-
*
|
|
34503
|
-
*
|
|
34504
|
-
*
|
|
34505
|
-
*
|
|
34506
|
-
*
|
|
35101
|
+
* This replaced a TTL on 2026-08-13, and the replacement is the whole point:
|
|
35102
|
+
* a time window was never related to the event the pixels were waiting for.
|
|
35103
|
+
* A held frame now lives from delivery until the runner has its `FrameResult`
|
|
35104
|
+
* — at which moment the runner cuts the subject tiles it actually wanted and
|
|
35105
|
+
* releases the frame. The bound exists only so a runner that stops answering
|
|
35106
|
+
* cannot pin RAM: above it the OLDEST held frame is dropped and counted.
|
|
35107
|
+
*
|
|
35108
|
+
* Sizing: the steady state is `inferenceLatency × deliveredFps`, measured at
|
|
35109
|
+
* 40-160 ms × ≤25 fps = 1-4 frames. The default leaves headroom for a hiccup
|
|
35110
|
+
* without ever approaching the old resident set (43 frames × 24.9 MB at 4K).
|
|
35111
|
+
* Raising it does not buy hit rate — it buys tolerance for a slow runner, and
|
|
35112
|
+
* `holdOverflow` on the metrics line is what says you need it.
|
|
34507
35113
|
*/
|
|
34508
|
-
|
|
35114
|
+
holdFrames: number().int().min(1).max(64),
|
|
34509
35115
|
/**
|
|
34510
35116
|
* Hard per-decode-worker RAM ceiling for retained native frames, in MB.
|
|
34511
35117
|
*
|
|
34512
|
-
*
|
|
34513
|
-
*
|
|
34514
|
-
*
|
|
34515
|
-
*
|
|
34516
|
-
*
|
|
34517
|
-
*
|
|
34518
|
-
* rather than giving RAM back — lower this knob if RAM is what you wanted.
|
|
35118
|
+
* Since 2026-08-13 this is a SAFETY ceiling and nothing else: `holdFrames`
|
|
35119
|
+
* is what decides how much is held, and the ceiling is the number above which
|
|
35120
|
+
* something is wrong. Before that it was the effective cap — at 1024 MB with
|
|
35121
|
+
* a 2 800 ms TTL a 4K camera sat pinned at `leaseMb:1020, leaseFrames:43`
|
|
35122
|
+
* with the TTL expiring nothing, which is exactly the confusion the hold
|
|
35123
|
+
* removes. `leaseMb` / `leaseFrames` still say what is resident.
|
|
34519
35124
|
* `0` DISABLES the lease entirely and falls the worker back to the tiny
|
|
34520
35125
|
* leak-prone GPU surface ring (~85% crop miss; that is what the lease exists
|
|
34521
35126
|
* to replace).
|
|
@@ -34541,22 +35146,45 @@ object({
|
|
|
34541
35146
|
* there is the signal that some caller names frames outside the inference set
|
|
34542
35147
|
* and that this must go back to `all`.
|
|
34543
35148
|
*/
|
|
34544
|
-
admission: NativeLeaseAdmissionSchema
|
|
35149
|
+
admission: NativeLeaseAdmissionSchema,
|
|
35150
|
+
/**
|
|
35151
|
+
* RAM ceiling per decode worker, in MB, for the SUBJECT TILES — the
|
|
35152
|
+
* compressed native crops the worker cuts at the moment a frame's detection
|
|
35153
|
+
* result arrives, and keeps long after the frame itself is freed.
|
|
35154
|
+
*
|
|
35155
|
+
* This is the knob that replaced the old retention window, and it buys about
|
|
35156
|
+
* three orders of magnitude more of it: a tile is one subject at native
|
|
35157
|
+
* resolution, JPEG-encoded (~60-120 KB on a 4K person), against ~24.9 MB for
|
|
35158
|
+
* the frame it was cut from. A frame on which nothing was detected costs
|
|
35159
|
+
* nothing at all, which is the real change — the old lease paid per FRAME and
|
|
35160
|
+
* was interrogated per SUBJECT.
|
|
35161
|
+
*
|
|
35162
|
+
* `0` DISABLES tiles, leaving only the hold window and the ≤640 RAM
|
|
35163
|
+
* fallback — i.e. the pre-2026-08-13 miss profile. Set it there only to
|
|
35164
|
+
* reproduce that.
|
|
35165
|
+
*/
|
|
35166
|
+
tileBudgetMb: number().int().min(0).max(1024)
|
|
34545
35167
|
});
|
|
34546
35168
|
/**
|
|
34547
|
-
* The values in force when the operator has set nothing
|
|
34548
|
-
*
|
|
34549
|
-
*
|
|
35169
|
+
* The values in force when the operator has set nothing.
|
|
35170
|
+
*
|
|
35171
|
+
* `budgetMb` stays at 1024 on the day the hold landed, deliberately: it stopped
|
|
35172
|
+
* being the retention window and became the OOM ceiling, and lowering a ceiling
|
|
35173
|
+
* in the same change that redefines it would make a regression and a retune
|
|
35174
|
+
* indistinguishable. Cut it once `tileHits` / `holdOverflow` have been read on
|
|
35175
|
+
* live traffic.
|
|
34550
35176
|
*/
|
|
34551
35177
|
var DEFAULT_NATIVE_LEASE_SETTINGS = {
|
|
34552
|
-
|
|
35178
|
+
holdFrames: 8,
|
|
34553
35179
|
budgetMb: 1024,
|
|
34554
35180
|
activityMs: 15e3,
|
|
35181
|
+
tileBudgetMb: 64,
|
|
34555
35182
|
admission: "inferred"
|
|
34556
35183
|
};
|
|
34557
|
-
DEFAULT_NATIVE_LEASE_SETTINGS.
|
|
35184
|
+
DEFAULT_NATIVE_LEASE_SETTINGS.holdFrames;
|
|
34558
35185
|
DEFAULT_NATIVE_LEASE_SETTINGS.budgetMb;
|
|
34559
35186
|
DEFAULT_NATIVE_LEASE_SETTINGS.activityMs;
|
|
35187
|
+
DEFAULT_NATIVE_LEASE_SETTINGS.tileBudgetMb;
|
|
34560
35188
|
DEFAULT_NATIVE_LEASE_SETTINGS.admission;
|
|
34561
35189
|
//#endregion
|
|
34562
35190
|
//#region ../../node_modules/undici/lib/core/symbols.js
|