@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.
- package/dist/addon.js +723 -95
- package/dist/addon.mjs +723 -95
- 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
|
-
*
|
|
14808
|
-
* rather than an
|
|
14809
|
-
* (`camstack/src/data/notification-center.ts`, guarded by
|
|
14810
|
-
* `scripts/check-viewer-condition-mirror.ts`) and its rule editor
|
|
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
|
|
14814
|
-
*
|
|
14815
|
-
*
|
|
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
|
-
|
|
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
|
|
25594
|
-
*
|
|
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
|
|
35166
|
+
* How many delivered frames the worker HOLDS at once, waiting for each one's
|
|
35167
|
+
* detection result.
|
|
34569
35168
|
*
|
|
34570
|
-
*
|
|
34571
|
-
*
|
|
34572
|
-
*
|
|
34573
|
-
*
|
|
34574
|
-
*
|
|
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
|
-
|
|
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
|
-
*
|
|
34581
|
-
*
|
|
34582
|
-
*
|
|
34583
|
-
*
|
|
34584
|
-
*
|
|
34585
|
-
*
|
|
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
|
|
34616
|
-
*
|
|
34617
|
-
*
|
|
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
|
-
|
|
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.
|
|
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
|