@camstack/addon-terminal 0.1.18 → 0.1.20
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 +732 -77
- package/dist/addon.mjs +732 -77
- package/package.json +1 -1
package/dist/addon.js
CHANGED
|
@@ -10856,7 +10856,14 @@ var cameraStreamsCapability = {
|
|
|
10856
10856
|
low: string().optional()
|
|
10857
10857
|
}),
|
|
10858
10858
|
lastChangedAt: number()
|
|
10859
|
-
})
|
|
10859
|
+
}),
|
|
10860
|
+
/**
|
|
10861
|
+
* 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.
|
|
10862
|
+
*
|
|
10863
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
10864
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
10865
|
+
*/
|
|
10866
|
+
durability: "session"
|
|
10860
10867
|
};
|
|
10861
10868
|
/** Where a block runs. The operator chooses — a block driving a device on an
|
|
10862
10869
|
* agent is the reason placement is not fixed to the hub. */
|
|
@@ -11417,6 +11424,13 @@ var deviceDiscoveryCapability = {
|
|
|
11417
11424
|
kind: "poll"
|
|
11418
11425
|
},
|
|
11419
11426
|
runtimeState: DeviceDiscoveryStatusSchema.extend({ lastFetchedAt: number().int().nonnegative() }),
|
|
11427
|
+
/**
|
|
11428
|
+
* Runtime-state durability: **session** — 5.7 KB of scan output on the largest device, fully re-derivable by re-scanning.
|
|
11429
|
+
*
|
|
11430
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
11431
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
11432
|
+
*/
|
|
11433
|
+
durability: "session",
|
|
11420
11434
|
methods: {
|
|
11421
11435
|
/**
|
|
11422
11436
|
* Snapshot of the current `discovered` list. Returns the
|
|
@@ -13231,11 +13245,33 @@ var NotificationFormatSchema = _enum([
|
|
|
13231
13245
|
* Named by INTENT, never by glyph. "check" would tie the vocabulary to one
|
|
13232
13246
|
* renderer's icon set; "acknowledge" survives an adapter that draws it
|
|
13233
13247
|
* differently.
|
|
13248
|
+
*
|
|
13249
|
+
* ── A TOKEN IS NOT A WIRE VALUE ─────────────────────────────────────
|
|
13250
|
+
*
|
|
13251
|
+
* These names are for US. **No adapter may forward one verbatim.** Each maps
|
|
13252
|
+
* the whole set onto its own renderer's vocabulary through a
|
|
13253
|
+
* `Record<NotificationActionIcon, string>` — a Record, never a lookup with a
|
|
13254
|
+
* fallback, so adding a member here fails every adapter's build until someone
|
|
13255
|
+
* decides its glyph, which is the only place that decision can be made
|
|
13256
|
+
* honestly.
|
|
13257
|
+
*
|
|
13258
|
+
* This paragraph is the bug. Zentik declared `actionIcons: true` and passed
|
|
13259
|
+
* `disarm` straight through; iOS feeds that string to
|
|
13260
|
+
* `UNNotificationActionIcon(systemImageName:)`, `disarm` is not an SF Symbol,
|
|
13261
|
+
* and every snooze and alarm button arrived BLANK. A pass-through is not a
|
|
13262
|
+
* mapping, and "the field is documented" is not "the value renders".
|
|
13263
|
+
*
|
|
13264
|
+
* Adding a member is TRAIN-BOUND. The enum lives in the published
|
|
13265
|
+
* `@camstack/server` closure and the cap seam validates against the HUB's copy,
|
|
13266
|
+
* so an addon that emits a token the running hub does not know does not lose an
|
|
13267
|
+
* icon — its whole `send` fails Zod validation and the notification never
|
|
13268
|
+
* arrives. Never emit a new token from an addon before the train carrying it.
|
|
13234
13269
|
*/
|
|
13235
13270
|
var NotificationActionIconSchema = _enum([
|
|
13236
13271
|
"acknowledge",
|
|
13237
13272
|
"dismiss",
|
|
13238
13273
|
"silence",
|
|
13274
|
+
"snooze",
|
|
13239
13275
|
"view",
|
|
13240
13276
|
"play",
|
|
13241
13277
|
"open",
|
|
@@ -13243,9 +13279,13 @@ var NotificationActionIconSchema = _enum([
|
|
|
13243
13279
|
"lock",
|
|
13244
13280
|
"unlock",
|
|
13245
13281
|
"arm",
|
|
13282
|
+
"arm-home",
|
|
13283
|
+
"arm-away",
|
|
13284
|
+
"arm-night",
|
|
13246
13285
|
"disarm",
|
|
13247
13286
|
"light",
|
|
13248
|
-
"alert"
|
|
13287
|
+
"alert",
|
|
13288
|
+
"camera"
|
|
13249
13289
|
]);
|
|
13250
13290
|
/** A single tap-through action button. */
|
|
13251
13291
|
var NotificationActionSchema = object({
|
|
@@ -13261,7 +13301,23 @@ var NotificationActionSchema = object({
|
|
|
13261
13301
|
* else — see `notification-center/action-token.ts` for what that does and
|
|
13262
13302
|
* does not buy.
|
|
13263
13303
|
*/
|
|
13264
|
-
destructive: boolean().optional()
|
|
13304
|
+
destructive: boolean().optional(),
|
|
13305
|
+
/**
|
|
13306
|
+
* How the tap should REACH the url.
|
|
13307
|
+
*
|
|
13308
|
+
* `navigate` (absent, and every button authored before this field) opens it:
|
|
13309
|
+
* the phone leaves the notification and shows whatever the callback returns.
|
|
13310
|
+
* That is right for a button whose answer the operator wants to read.
|
|
13311
|
+
*
|
|
13312
|
+
* `background` fires it as a POST and stays put. It exists for the buttons
|
|
13313
|
+
* whose whole point is not to interrupt — "silence this for 30 minutes" is
|
|
13314
|
+
* an answer to the notification, and being thrown into a browser tab to
|
|
13315
|
+
* confirm it costs more attention than the notification did. A backend that
|
|
13316
|
+
* cannot do a background call renders it as an ordinary link (the adapters
|
|
13317
|
+
* fall back rather than dropping the button), so this is a preference, never
|
|
13318
|
+
* a requirement.
|
|
13319
|
+
*/
|
|
13320
|
+
mode: _enum(["navigate", "background"]).optional()
|
|
13265
13321
|
});
|
|
13266
13322
|
/**
|
|
13267
13323
|
* The canonical notification. `body` is the only hard field (Apprise model).
|
|
@@ -13429,6 +13485,24 @@ method(object({}), array(TargetKindSchema)), method(object({}), array(TargetSche
|
|
|
13429
13485
|
targetId: string(),
|
|
13430
13486
|
enabled: boolean()
|
|
13431
13487
|
}), _void(), { kind: "mutation" });
|
|
13488
|
+
new Set([
|
|
13489
|
+
{
|
|
13490
|
+
id: "person",
|
|
13491
|
+
name: "Person"
|
|
13492
|
+
},
|
|
13493
|
+
{
|
|
13494
|
+
id: "vehicle",
|
|
13495
|
+
name: "Vehicle"
|
|
13496
|
+
},
|
|
13497
|
+
{
|
|
13498
|
+
id: "animal",
|
|
13499
|
+
name: "Animal"
|
|
13500
|
+
},
|
|
13501
|
+
{
|
|
13502
|
+
id: "package",
|
|
13503
|
+
name: "Package"
|
|
13504
|
+
}
|
|
13505
|
+
].map((l) => l.id));
|
|
13432
13506
|
var COCO_TO_MACRO = {
|
|
13433
13507
|
mapping: {
|
|
13434
13508
|
person: "person",
|
|
@@ -14113,7 +14187,17 @@ var alarmPanelCapability = {
|
|
|
14113
14187
|
* full slice; renders an arm button per `availableModes` entry and
|
|
14114
14188
|
* a PIN field iff `requiresCode === true`.
|
|
14115
14189
|
*/
|
|
14116
|
-
runtimeState: AlarmPanelStatusSchema
|
|
14190
|
+
runtimeState: AlarmPanelStatusSchema,
|
|
14191
|
+
/**
|
|
14192
|
+
* Runtime-state durability: **restored** — armed state is the one thing a panel must not lose across a restart.
|
|
14193
|
+
*
|
|
14194
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
14195
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
14196
|
+
*/
|
|
14197
|
+
durability: "restored",
|
|
14198
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
14199
|
+
* whether persisting is worth a SQLite commit. */
|
|
14200
|
+
volatileStateFields: ["lastChangedAt"]
|
|
14117
14201
|
};
|
|
14118
14202
|
/**
|
|
14119
14203
|
* Shared geometry vocabulary for on-frame shape caps — privacy-mask,
|
|
@@ -14254,6 +14338,8 @@ var NcSystemEventKindSchema = _enum([
|
|
|
14254
14338
|
"alarm-triggered",
|
|
14255
14339
|
"alarm-armed",
|
|
14256
14340
|
"alarm-disarmed",
|
|
14341
|
+
"alarm-arming",
|
|
14342
|
+
"alarm-arm-refused",
|
|
14257
14343
|
"camera-online",
|
|
14258
14344
|
"camera-offline",
|
|
14259
14345
|
"camera-disabled",
|
|
@@ -14290,6 +14376,9 @@ var NcSystemEventConditionSchema = object({
|
|
|
14290
14376
|
nodeIds: array(string().min(1)).min(1).optional(),
|
|
14291
14377
|
packageNames: array(string().min(1)).min(1).optional()
|
|
14292
14378
|
});
|
|
14379
|
+
/** Hard ceiling on a window (24h). A snooze that could not expire would be an
|
|
14380
|
+
* outage the operator asked for once and forgot. */
|
|
14381
|
+
var NC_SNOOZE_MAX_MINUTES = 1440;
|
|
14293
14382
|
/** Weekly schedule — OR of windows; absence on the rule = always active. */
|
|
14294
14383
|
var NcScheduleSchema = object({
|
|
14295
14384
|
windows: array(object({
|
|
@@ -14666,15 +14755,15 @@ var NcConditionsSchema = object({
|
|
|
14666
14755
|
* (an `immediate` rule naming an `audio-*` class, one notification per
|
|
14667
14756
|
* classified sample) stays exactly as it was for rules that already use it.
|
|
14668
14757
|
*
|
|
14669
|
-
*
|
|
14670
|
-
* rather than an
|
|
14671
|
-
* (`camstack/src/data/notification-center.ts`, guarded by
|
|
14672
|
-
* `scripts/check-viewer-condition-mirror.ts`) and its rule editor
|
|
14758
|
+
* In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
|
|
14759
|
+
* rule rather than an accident: the viewer mirrors the descriptor enums BY
|
|
14760
|
+
* HAND (`camstack/src/data/notification-center.ts`, guarded by
|
|
14761
|
+
* `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
|
|
14673
14762
|
* condition fields it does not know when a rule is saved from the phone.
|
|
14674
14763
|
* Publishing an editor for a condition the app cannot round-trip is how an
|
|
14675
|
-
* operator loses a rule's conditions by opening it — so the
|
|
14676
|
-
*
|
|
14677
|
-
*
|
|
14764
|
+
* operator loses a rule's conditions by opening it — so the viewer mirror
|
|
14765
|
+
* (P3, shipped) went FIRST, and the descriptor an editor renders from
|
|
14766
|
+
* follows here.
|
|
14678
14767
|
*/
|
|
14679
14768
|
audio: NcAudioConditionSchema.optional()
|
|
14680
14769
|
});
|
|
@@ -14910,6 +14999,30 @@ var NcRuleInputSchema = object({
|
|
|
14910
14999
|
*/
|
|
14911
15000
|
snoozeAllowGlobal: boolean().optional(),
|
|
14912
15001
|
/**
|
|
15002
|
+
* The snooze durations THIS rule's notification offers as buttons, in
|
|
15003
|
+
* minutes.
|
|
15004
|
+
*
|
|
15005
|
+
* Three states, and all three are distinct — which is exactly why this is
|
|
15006
|
+
* `.optional()` and never `.default()`. A Zod default does not run on the
|
|
15007
|
+
* addon cap path (three production failures in one day), so a schema default
|
|
15008
|
+
* would collapse the first two:
|
|
15009
|
+
*
|
|
15010
|
+
* | value | meaning |
|
|
15011
|
+
* | --- | --- |
|
|
15012
|
+
* | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
|
|
15013
|
+
* | `[]` | **no snooze buttons on this rule** — the explicit override |
|
|
15014
|
+
* | a list | these choices, de-duplicated and sorted, at most four |
|
|
15015
|
+
*
|
|
15016
|
+
* `.max(4)` because the notifier's own action budget is small (ntfy allows
|
|
15017
|
+
* three buttons in total) and a rule that spent it all on snooze choices
|
|
15018
|
+
* would push its own tap-through actions off the notification.
|
|
15019
|
+
*
|
|
15020
|
+
* An empty list is NOT an alarm exemption: a rule the alarm is about, or
|
|
15021
|
+
* that arms the panel, is exempt automatically and cannot be silenced by a
|
|
15022
|
+
* window from anywhere (D133).
|
|
15023
|
+
*/
|
|
15024
|
+
snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
|
|
15025
|
+
/**
|
|
14913
15026
|
* Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
|
|
14914
15027
|
*
|
|
14915
15028
|
* This is what makes the rule set the alarm's trigger set without the alarm
|
|
@@ -15009,6 +15122,7 @@ var NcConditionDescriptorSchema = object({
|
|
|
15009
15122
|
"device",
|
|
15010
15123
|
"package",
|
|
15011
15124
|
"occupancy",
|
|
15125
|
+
"audio",
|
|
15012
15126
|
"system"
|
|
15013
15127
|
]),
|
|
15014
15128
|
label: string(),
|
|
@@ -15027,6 +15141,7 @@ var NcConditionDescriptorSchema = object({
|
|
|
15027
15141
|
"crossingSelect",
|
|
15028
15142
|
"polygonDraw",
|
|
15029
15143
|
"occupancy",
|
|
15144
|
+
"audio",
|
|
15030
15145
|
"deviceState",
|
|
15031
15146
|
"systemEvent"
|
|
15032
15147
|
]),
|
|
@@ -15178,7 +15293,20 @@ var NcSnoozeInputSchema = object({
|
|
|
15178
15293
|
ruleId: string().optional(),
|
|
15179
15294
|
/** Required when `scope: 'device'`. */
|
|
15180
15295
|
deviceId: number().int().optional(),
|
|
15181
|
-
|
|
15296
|
+
/**
|
|
15297
|
+
* Narrow the window to these subject classes — "the cat, not the person".
|
|
15298
|
+
*
|
|
15299
|
+
* ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
|
|
15300
|
+
* what every window authored before this field meant, so no persisted row
|
|
15301
|
+
* changes meaning and no client has to learn anything to keep working.
|
|
15302
|
+
*
|
|
15303
|
+
* It is what makes the window's real key `(deviceId, classes[])` and lets it
|
|
15304
|
+
* cross rules (D133): the operator points at a camera and a kind of thing,
|
|
15305
|
+
* not at whichever of their four rules happened to produce the notification
|
|
15306
|
+
* they are dismissing.
|
|
15307
|
+
*/
|
|
15308
|
+
classes: array(string().min(1)).min(1).optional(),
|
|
15309
|
+
durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
|
|
15182
15310
|
/**
|
|
15183
15311
|
* Silence this for EVERY recipient, not just the caller. Permission is
|
|
15184
15312
|
* checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
|
|
@@ -15203,6 +15331,10 @@ var NcSnoozeSchema = object({
|
|
|
15203
15331
|
scope: NcSnoozeScopeSchema,
|
|
15204
15332
|
ruleId: string().optional(),
|
|
15205
15333
|
deviceId: number().int().optional(),
|
|
15334
|
+
/** Subject classes this window covers. ABSENT = every class — see
|
|
15335
|
+
* {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
|
|
15336
|
+
* no SQLite column: nothing queries a window by class. */
|
|
15337
|
+
classes: array(string().min(1)).min(1).optional(),
|
|
15206
15338
|
startedAt: number(),
|
|
15207
15339
|
/** Exclusive: at exactly this instant the snooze is over. Expiry is a
|
|
15208
15340
|
* COMPARISON, not a job — no sweeper can leave the operator silenced. */
|
|
@@ -17303,7 +17435,14 @@ var zonesCapability = {
|
|
|
17303
17435
|
* handle. Slice shape is `{ zones: Zone[] }` so future extensions
|
|
17304
17436
|
* (e.g. zone groupings) can sit alongside the polygon list.
|
|
17305
17437
|
*/
|
|
17306
|
-
runtimeState: object({ zones: array(ZoneSchema).readonly() })
|
|
17438
|
+
runtimeState: object({ zones: array(ZoneSchema).readonly() }),
|
|
17439
|
+
/**
|
|
17440
|
+
* 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.
|
|
17441
|
+
*
|
|
17442
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
17443
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
17444
|
+
*/
|
|
17445
|
+
durability: "restored"
|
|
17307
17446
|
};
|
|
17308
17447
|
/**
|
|
17309
17448
|
* A bounding box in NORMALIZED [0,1] frame coordinates for `getNativeCrop`. The
|
|
@@ -17473,6 +17612,22 @@ var detectionFpsField = {
|
|
|
17473
17612
|
default: 10,
|
|
17474
17613
|
step: 1
|
|
17475
17614
|
};
|
|
17615
|
+
/**
|
|
17616
|
+
* The occupancy re-check interval. DEFAULT 300 s (2026-08-13 — was 30 s).
|
|
17617
|
+
*
|
|
17618
|
+
* The recheck is now on by default (a parked car is invisible to occupancy
|
|
17619
|
+
* rules until the stationary registry has been rebuilt by motion, which after a
|
|
17620
|
+
* restart may be never on a quiet camera). Each cycle re-subscribes a detection
|
|
17621
|
+
* session — an RTSP re-dial — so the switch is only affordable at a WIDE
|
|
17622
|
+
* interval: 300 s is ~12 re-dials an hour per camera, against 120 at the old
|
|
17623
|
+
* 30 s. A parked car is therefore counted within 5 minutes of a restart.
|
|
17624
|
+
*
|
|
17625
|
+
* Why not wider: `max` is 300 and raising it is TRAIN-BOUND, not addon-bound —
|
|
17626
|
+
* the host validates `attachCamera` against ITS copy of this schema, so a
|
|
17627
|
+
* runner asked for 600 would be rejected by the hub until a `@camstack/server`
|
|
17628
|
+
* carrying the wider bound is installed everywhere. 300 is the widest value
|
|
17629
|
+
* that ships with an addon deploy.
|
|
17630
|
+
*/
|
|
17476
17631
|
var occupancyRecheckSecField = {
|
|
17477
17632
|
min: 0,
|
|
17478
17633
|
max: 300,
|
|
@@ -17674,15 +17829,21 @@ var RunnerCameraConfigSchema = object({
|
|
|
17674
17829
|
*/
|
|
17675
17830
|
onboardMotionDrivesAnalyzer: boolean().default(true),
|
|
17676
17831
|
/**
|
|
17677
|
-
* Master toggle for the occupancy re-check. When `false`
|
|
17678
|
-
*
|
|
17679
|
-
* this is off by default because the recheck re-subscribes a detection session
|
|
17680
|
-
* every N seconds while `watching`, a major source of pull-decoder re-dial
|
|
17681
|
-
* churn (each cycle creates+tears a session → RTSP re-dial → latency). The
|
|
17832
|
+
* Master toggle for the occupancy re-check. When `false` the runner never arms
|
|
17833
|
+
* the periodic recheck timer, regardless of `occupancyRecheckSec`; the
|
|
17682
17834
|
* `occupancyRecheckSec` / `occupancyRecheckFrames` sliders only take effect
|
|
17683
17835
|
* (and only render) when this is enabled.
|
|
17684
|
-
|
|
17685
|
-
|
|
17836
|
+
*
|
|
17837
|
+
* DEFAULT `true` since 2026-08-13 (was `false`). It was off because the
|
|
17838
|
+
* recheck re-subscribes a detection session every N seconds while `watching`
|
|
17839
|
+
* — each cycle creates+tears a session ⇒ an RTSP re-dial ⇒ latency, a major
|
|
17840
|
+
* pull-decoder churn source. What that bought was a blind spot: a STATIONARY
|
|
17841
|
+
* object is counted only while the stationary registry holds it, and the
|
|
17842
|
+
* registry rebuilds from motion, so after a restart a parked car was invisible
|
|
17843
|
+
* to every occupancy rule until something moved in front of it. The churn is
|
|
17844
|
+
* now paid on the interval instead — see `occupancyRecheckSecField`.
|
|
17845
|
+
*/
|
|
17846
|
+
occupancyRecheckEnabled: boolean().default(true),
|
|
17686
17847
|
occupancyRecheckSec: number().min(occupancyRecheckSecField.min).max(occupancyRecheckSecField.max).default(occupancyRecheckSecField.default),
|
|
17687
17848
|
occupancyRecheckFrames: number().min(occupancyRecheckFramesField.min).max(occupancyRecheckFramesField.max).default(occupancyRecheckFramesField.default),
|
|
17688
17849
|
/**
|
|
@@ -20240,7 +20401,17 @@ var airQualitySensorCapability = {
|
|
|
20240
20401
|
schema: AirQualitySensorStatusSchema,
|
|
20241
20402
|
kind: "push"
|
|
20242
20403
|
},
|
|
20243
|
-
runtimeState: AirQualitySensorStatusSchema
|
|
20404
|
+
runtimeState: AirQualitySensorStatusSchema,
|
|
20405
|
+
/**
|
|
20406
|
+
* Runtime-state durability: **restored** — as `numeric-sensor`.
|
|
20407
|
+
*
|
|
20408
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
20409
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
20410
|
+
*/
|
|
20411
|
+
durability: "restored",
|
|
20412
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
20413
|
+
* whether persisting is worth a SQLite commit. */
|
|
20414
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
20244
20415
|
};
|
|
20245
20416
|
/**
|
|
20246
20417
|
* Ambient illuminance reading in lux. Drives Home Assistant `sensor`
|
|
@@ -20272,7 +20443,17 @@ var ambientLightSensorCapability = {
|
|
|
20272
20443
|
schema: AmbientLightSensorStatusSchema,
|
|
20273
20444
|
kind: "push"
|
|
20274
20445
|
},
|
|
20275
|
-
runtimeState: AmbientLightSensorStatusSchema
|
|
20446
|
+
runtimeState: AmbientLightSensorStatusSchema,
|
|
20447
|
+
/**
|
|
20448
|
+
* Runtime-state durability: **restored** — as `numeric-sensor`.
|
|
20449
|
+
*
|
|
20450
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
20451
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
20452
|
+
*/
|
|
20453
|
+
durability: "restored",
|
|
20454
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
20455
|
+
* whether persisting is worth a SQLite commit. */
|
|
20456
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
20276
20457
|
};
|
|
20277
20458
|
/**
|
|
20278
20459
|
* Per-class audio metrics aggregated over a sliding window.
|
|
@@ -20390,7 +20571,14 @@ var audioMetricsCapability = {
|
|
|
20390
20571
|
}), AudioMetricsHistorySchema)
|
|
20391
20572
|
},
|
|
20392
20573
|
/** Reactive runtime-state mirror — live `device.state.audioMetrics.value`. */
|
|
20393
|
-
runtimeState: AudioMetricsSnapshotSchema
|
|
20574
|
+
runtimeState: AudioMetricsSnapshotSchema,
|
|
20575
|
+
/**
|
|
20576
|
+
* 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.
|
|
20577
|
+
*
|
|
20578
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
20579
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
20580
|
+
*/
|
|
20581
|
+
durability: "session"
|
|
20394
20582
|
};
|
|
20395
20583
|
/**
|
|
20396
20584
|
* Automation-control cap. Models HA `automation.*` entities on
|
|
@@ -20452,7 +20640,14 @@ var automationControlCapability = {
|
|
|
20452
20640
|
* reads `enabled` (toggle) + `isRunning` (spinner) + `lastError`
|
|
20453
20641
|
* (badge) directly.
|
|
20454
20642
|
*/
|
|
20455
|
-
runtimeState: AutomationControlStatusSchema
|
|
20643
|
+
runtimeState: AutomationControlStatusSchema,
|
|
20644
|
+
/**
|
|
20645
|
+
* 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.
|
|
20646
|
+
*
|
|
20647
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
20648
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
20649
|
+
*/
|
|
20650
|
+
durability: "session"
|
|
20456
20651
|
};
|
|
20457
20652
|
/**
|
|
20458
20653
|
* Battery status snapshot. Emitted by providers whose device is
|
|
@@ -20558,7 +20753,17 @@ onStatusChanged: { data: object({
|
|
|
20558
20753
|
* via `device.runtimeState.getCapState('battery')` regardless of
|
|
20559
20754
|
* the underlying driver.
|
|
20560
20755
|
*/
|
|
20561
|
-
runtimeState: BatteryStatusSchema
|
|
20756
|
+
runtimeState: BatteryStatusSchema,
|
|
20757
|
+
/**
|
|
20758
|
+
* 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.
|
|
20759
|
+
*
|
|
20760
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
20761
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
20762
|
+
*/
|
|
20763
|
+
durability: "restored",
|
|
20764
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
20765
|
+
* whether persisting is worth a SQLite commit. */
|
|
20766
|
+
volatileStateFields: ["lastUpdated"]
|
|
20562
20767
|
};
|
|
20563
20768
|
/**
|
|
20564
20769
|
* Generic boolean sensor — last-resort fallback when no domain-
|
|
@@ -20587,7 +20792,17 @@ var binaryCapability = {
|
|
|
20587
20792
|
schema: BinaryStatusSchema,
|
|
20588
20793
|
kind: "push"
|
|
20589
20794
|
},
|
|
20590
|
-
runtimeState: BinaryStatusSchema
|
|
20795
|
+
runtimeState: BinaryStatusSchema,
|
|
20796
|
+
/**
|
|
20797
|
+
* Runtime-state durability: **restored** — transition-driven sensor state; the restored value gives the boot comparison.
|
|
20798
|
+
*
|
|
20799
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
20800
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
20801
|
+
*/
|
|
20802
|
+
durability: "restored",
|
|
20803
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
20804
|
+
* whether persisting is worth a SQLite commit. */
|
|
20805
|
+
volatileStateFields: ["lastChangedAt"]
|
|
20591
20806
|
};
|
|
20592
20807
|
/**
|
|
20593
20808
|
* Dimmable-light brightness control. Co-exists with `switch` on the
|
|
@@ -20640,7 +20855,14 @@ onBrightnessChanged: { data: object({
|
|
|
20640
20855
|
* by the kernel. Read via `device.state.brightness.value` so UI
|
|
20641
20856
|
* sliders surface the current level without polling the provider.
|
|
20642
20857
|
*/
|
|
20643
|
-
runtimeState: BrightnessStatusSchema
|
|
20858
|
+
runtimeState: BrightnessStatusSchema,
|
|
20859
|
+
/**
|
|
20860
|
+
* Runtime-state durability: **session** — live lamp state, re-published by the provider on connect.
|
|
20861
|
+
*
|
|
20862
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
20863
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
20864
|
+
*/
|
|
20865
|
+
durability: "session"
|
|
20644
20866
|
};
|
|
20645
20867
|
DeviceType.Button, method(object({ deviceId: number().int().nonnegative() }), _void(), {
|
|
20646
20868
|
kind: "mutation",
|
|
@@ -20728,7 +20950,17 @@ var carbonMonoxideCapability = {
|
|
|
20728
20950
|
schema: CarbonMonoxideStatusSchema,
|
|
20729
20951
|
kind: "push"
|
|
20730
20952
|
},
|
|
20731
|
-
runtimeState: CarbonMonoxideStatusSchema
|
|
20953
|
+
runtimeState: CarbonMonoxideStatusSchema,
|
|
20954
|
+
/**
|
|
20955
|
+
* Runtime-state durability: **restored** — as `smoke`.
|
|
20956
|
+
*
|
|
20957
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
20958
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
20959
|
+
*/
|
|
20960
|
+
durability: "restored",
|
|
20961
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
20962
|
+
* whether persisting is worth a SQLite commit. */
|
|
20963
|
+
volatileStateFields: ["lastChangedAt"]
|
|
20732
20964
|
};
|
|
20733
20965
|
/**
|
|
20734
20966
|
* HVAC / climate control cap. Models the full surface of a HA
|
|
@@ -20888,7 +21120,14 @@ var climateControlCapability = {
|
|
|
20888
21120
|
* the full slice via `device.state.climate-control.value` and refresh
|
|
20889
21121
|
* on every push without re-querying the provider.
|
|
20890
21122
|
*/
|
|
20891
|
-
runtimeState: ClimateControlStatusSchema
|
|
21123
|
+
runtimeState: ClimateControlStatusSchema,
|
|
21124
|
+
/**
|
|
21125
|
+
* Runtime-state durability: **session** — as `brightness`; `currentTemp` moves continuously and is re-published on connect.
|
|
21126
|
+
*
|
|
21127
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
21128
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
21129
|
+
*/
|
|
21130
|
+
durability: "session"
|
|
20892
21131
|
};
|
|
20893
21132
|
/**
|
|
20894
21133
|
* Color-light cap. Coexists with `switch` (on/off) and `brightness`
|
|
@@ -20998,7 +21237,14 @@ onColorChanged: { data: object({
|
|
|
20998
21237
|
* kernel. Read via `device.state.color.value` so UI pickers surface
|
|
20999
21238
|
* the current chromaticity without polling the provider.
|
|
21000
21239
|
*/
|
|
21001
|
-
runtimeState: ColorStatusSchema
|
|
21240
|
+
runtimeState: ColorStatusSchema,
|
|
21241
|
+
/**
|
|
21242
|
+
* Runtime-state durability: **session** — as `brightness`.
|
|
21243
|
+
*
|
|
21244
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
21245
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
21246
|
+
*/
|
|
21247
|
+
durability: "session"
|
|
21002
21248
|
};
|
|
21003
21249
|
var ConnectionTestOutcomeSchema = discriminatedUnion("outcome", [
|
|
21004
21250
|
object({
|
|
@@ -21056,7 +21302,17 @@ var connectivityCapability = {
|
|
|
21056
21302
|
schema: ConnectivityStatusSchema,
|
|
21057
21303
|
kind: "push"
|
|
21058
21304
|
},
|
|
21059
|
-
runtimeState: ConnectivityStatusSchema
|
|
21305
|
+
runtimeState: ConnectivityStatusSchema,
|
|
21306
|
+
/**
|
|
21307
|
+
* Runtime-state durability: **restored** — same shape and same argument as `device-status`, for links rather than devices.
|
|
21308
|
+
*
|
|
21309
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
21310
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
21311
|
+
*/
|
|
21312
|
+
durability: "restored",
|
|
21313
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
21314
|
+
* whether persisting is worth a SQLite commit. */
|
|
21315
|
+
volatileStateFields: ["lastChangedAt"]
|
|
21060
21316
|
};
|
|
21061
21317
|
/**
|
|
21062
21318
|
* Generic device-consumables capability — surfaces a device's
|
|
@@ -21138,7 +21394,14 @@ reset: method(object({
|
|
|
21138
21394
|
}
|
|
21139
21395
|
}
|
|
21140
21396
|
},
|
|
21141
|
-
runtimeState: ConsumablesStatusSchema.extend({ lastFetchedAt: number() })
|
|
21397
|
+
runtimeState: ConsumablesStatusSchema.extend({ lastFetchedAt: number() }),
|
|
21398
|
+
/**
|
|
21399
|
+
* Runtime-state durability: **session** — the authority is the appliance; the provider re-reads the whole item array on connect.
|
|
21400
|
+
*
|
|
21401
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
21402
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
21403
|
+
*/
|
|
21404
|
+
durability: "session"
|
|
21142
21405
|
};
|
|
21143
21406
|
/**
|
|
21144
21407
|
* Door / window / opening / garage / valve contact sensor. Boolean
|
|
@@ -21169,7 +21432,17 @@ var contactCapability = {
|
|
|
21169
21432
|
schema: ContactStatusSchema,
|
|
21170
21433
|
kind: "push"
|
|
21171
21434
|
},
|
|
21172
|
-
runtimeState: ContactStatusSchema
|
|
21435
|
+
runtimeState: ContactStatusSchema,
|
|
21436
|
+
/**
|
|
21437
|
+
* Runtime-state durability: **restored** — a door left open across a restart must still read open.
|
|
21438
|
+
*
|
|
21439
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
21440
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
21441
|
+
*/
|
|
21442
|
+
durability: "restored",
|
|
21443
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
21444
|
+
* whether persisting is worth a SQLite commit. */
|
|
21445
|
+
volatileStateFields: ["lastChangedAt"]
|
|
21173
21446
|
};
|
|
21174
21447
|
/**
|
|
21175
21448
|
* Status slice — flat object (the framework's `runtimeState` contract
|
|
@@ -21275,7 +21548,14 @@ var controlCapability = {
|
|
|
21275
21548
|
* dropdown / text field / date picker) read the slice's discriminant
|
|
21276
21549
|
* and value directly without polling the provider.
|
|
21277
21550
|
*/
|
|
21278
|
-
runtimeState: ControlStatusSchema
|
|
21551
|
+
runtimeState: ControlStatusSchema,
|
|
21552
|
+
/**
|
|
21553
|
+
* Runtime-state durability: **session** — a generic control mirrors an external entity that re-publishes on connect; the options array is re-derived with it.
|
|
21554
|
+
*
|
|
21555
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
21556
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
21557
|
+
*/
|
|
21558
|
+
durability: "session"
|
|
21279
21559
|
};
|
|
21280
21560
|
var CoverStatusSchema = object({
|
|
21281
21561
|
/** Lifecycle state of the cover. */
|
|
@@ -21336,7 +21616,17 @@ var coverCapability = {
|
|
|
21336
21616
|
* Runtime-state slice — mirrored by the kernel. UI controls watch
|
|
21337
21617
|
* the slice for live position changes during a move.
|
|
21338
21618
|
*/
|
|
21339
|
-
runtimeState: CoverStatusSchema
|
|
21619
|
+
runtimeState: CoverStatusSchema,
|
|
21620
|
+
/**
|
|
21621
|
+
* Runtime-state durability: **restored** — position survives a restart on the device; the mirror should agree at boot rather than read blank.
|
|
21622
|
+
*
|
|
21623
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
21624
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
21625
|
+
*/
|
|
21626
|
+
durability: "restored",
|
|
21627
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
21628
|
+
* whether persisting is worth a SQLite commit. */
|
|
21629
|
+
volatileStateFields: ["lastChangedAt"]
|
|
21340
21630
|
};
|
|
21341
21631
|
/**
|
|
21342
21632
|
* Vendor-neutral day/night (IR-cut) control — the per-camera config cap
|
|
@@ -21430,7 +21720,17 @@ var dayNightCapability = {
|
|
|
21430
21720
|
schema: DayNightStatusSchema,
|
|
21431
21721
|
kind: "poll"
|
|
21432
21722
|
},
|
|
21433
|
-
runtimeState: DayNightStatusSchema
|
|
21723
|
+
runtimeState: DayNightStatusSchema,
|
|
21724
|
+
/**
|
|
21725
|
+
* Runtime-state durability: **restored** — operator-set IR-cut behaviour; mutation-driven.
|
|
21726
|
+
*
|
|
21727
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
21728
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
21729
|
+
*/
|
|
21730
|
+
durability: "restored",
|
|
21731
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
21732
|
+
* whether persisting is worth a SQLite commit. */
|
|
21733
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
21434
21734
|
};
|
|
21435
21735
|
/**
|
|
21436
21736
|
* Generic device-level status snapshot. Auto-registered by `BaseDevice`
|
|
@@ -21477,7 +21777,17 @@ onStatusChanged: { data: object({
|
|
|
21477
21777
|
schema: DeviceStatusSchema,
|
|
21478
21778
|
kind: "push"
|
|
21479
21779
|
},
|
|
21480
|
-
runtimeState: DeviceStatusSchema
|
|
21780
|
+
runtimeState: DeviceStatusSchema,
|
|
21781
|
+
/**
|
|
21782
|
+
* 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.
|
|
21783
|
+
*
|
|
21784
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
21785
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
21786
|
+
*/
|
|
21787
|
+
durability: "restored",
|
|
21788
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
21789
|
+
* whether persisting is worth a SQLite commit. */
|
|
21790
|
+
volatileStateFields: ["lastChangedAt"]
|
|
21481
21791
|
};
|
|
21482
21792
|
/**
|
|
21483
21793
|
* Doorbell button cap. Two kinds of providers coexist behind this cap
|
|
@@ -21539,7 +21849,14 @@ onPressed: { data: DoorbellPressEventSchema } },
|
|
|
21539
21849
|
* `device.state.doorbell.value`. UIs can show "last ring 5m ago"
|
|
21540
21850
|
* without subscribing.
|
|
21541
21851
|
*/
|
|
21542
|
-
runtimeState: DoorbellStatusSchema
|
|
21852
|
+
runtimeState: DoorbellStatusSchema,
|
|
21853
|
+
/**
|
|
21854
|
+
* 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.
|
|
21855
|
+
*
|
|
21856
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
21857
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
21858
|
+
*/
|
|
21859
|
+
durability: "restored"
|
|
21543
21860
|
};
|
|
21544
21861
|
/**
|
|
21545
21862
|
* Enum-state sensor — a string value picked from a finite option set.
|
|
@@ -21579,7 +21896,17 @@ var enumSensorCapability = {
|
|
|
21579
21896
|
schema: EnumSensorStatusSchema,
|
|
21580
21897
|
kind: "push"
|
|
21581
21898
|
},
|
|
21582
|
-
runtimeState: EnumSensorStatusSchema
|
|
21899
|
+
runtimeState: EnumSensorStatusSchema,
|
|
21900
|
+
/**
|
|
21901
|
+
* Runtime-state durability: **restored** — as `numeric-sensor`; 80 devices.
|
|
21902
|
+
*
|
|
21903
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
21904
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
21905
|
+
*/
|
|
21906
|
+
durability: "restored",
|
|
21907
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
21908
|
+
* whether persisting is worth a SQLite commit. */
|
|
21909
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
21583
21910
|
};
|
|
21584
21911
|
/**
|
|
21585
21912
|
* Generic stateless event emitter. Installed on a `DeviceType.EventEmitter`
|
|
@@ -21615,7 +21942,14 @@ var eventEmitterCapability = {
|
|
|
21615
21942
|
schema: EventEmitterStatusSchema,
|
|
21616
21943
|
kind: "push"
|
|
21617
21944
|
},
|
|
21618
|
-
runtimeState: EventEmitterStatusSchema
|
|
21945
|
+
runtimeState: EventEmitterStatusSchema,
|
|
21946
|
+
/**
|
|
21947
|
+
* Runtime-state durability: **session** — `eventCountSinceStart` names its own scope.
|
|
21948
|
+
*
|
|
21949
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
21950
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
21951
|
+
*/
|
|
21952
|
+
durability: "session"
|
|
21619
21953
|
};
|
|
21620
21954
|
var EventItemSchema = object({
|
|
21621
21955
|
id: string(),
|
|
@@ -21896,7 +22230,14 @@ var fanControlCapability = {
|
|
|
21896
22230
|
* Runtime-state slice — mirrored by the kernel. UI fan speed
|
|
21897
22231
|
* sliders read `percentage` for live updates.
|
|
21898
22232
|
*/
|
|
21899
|
-
runtimeState: FanControlStatusSchema
|
|
22233
|
+
runtimeState: FanControlStatusSchema,
|
|
22234
|
+
/**
|
|
22235
|
+
* Runtime-state durability: **session** — as `brightness`.
|
|
22236
|
+
*
|
|
22237
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
22238
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
22239
|
+
*/
|
|
22240
|
+
durability: "session"
|
|
21900
22241
|
};
|
|
21901
22242
|
/**
|
|
21902
22243
|
* Per-device feature/identity probe slice. Holds the runtime-resolved
|
|
@@ -21972,7 +22313,14 @@ onProbeChanged: { data: object({
|
|
|
21972
22313
|
schema: FeatureProbeStatusSchema,
|
|
21973
22314
|
kind: "push"
|
|
21974
22315
|
},
|
|
21975
|
-
runtimeState: FeatureProbeStatusSchema
|
|
22316
|
+
runtimeState: FeatureProbeStatusSchema,
|
|
22317
|
+
/**
|
|
22318
|
+
* 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.
|
|
22319
|
+
*
|
|
22320
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
22321
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
22322
|
+
*/
|
|
22323
|
+
durability: "session"
|
|
21976
22324
|
};
|
|
21977
22325
|
/**
|
|
21978
22326
|
* Water leak / moisture sensor. Boolean "is liquid currently
|
|
@@ -21999,7 +22347,17 @@ var floodCapability = {
|
|
|
21999
22347
|
schema: FloodStatusSchema,
|
|
22000
22348
|
kind: "push"
|
|
22001
22349
|
},
|
|
22002
|
-
runtimeState: FloodStatusSchema
|
|
22350
|
+
runtimeState: FloodStatusSchema,
|
|
22351
|
+
/**
|
|
22352
|
+
* Runtime-state durability: **restored** — as `smoke`.
|
|
22353
|
+
*
|
|
22354
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
22355
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
22356
|
+
*/
|
|
22357
|
+
durability: "restored",
|
|
22358
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
22359
|
+
* whether persisting is worth a SQLite commit. */
|
|
22360
|
+
volatileStateFields: ["lastChangedAt"]
|
|
22003
22361
|
};
|
|
22004
22362
|
/**
|
|
22005
22363
|
* Combustible-gas (LPG / methane / hydrogen) alarm sensor. Drives
|
|
@@ -22022,7 +22380,17 @@ var gasCapability = {
|
|
|
22022
22380
|
schema: GasStatusSchema,
|
|
22023
22381
|
kind: "push"
|
|
22024
22382
|
},
|
|
22025
|
-
runtimeState: GasStatusSchema
|
|
22383
|
+
runtimeState: GasStatusSchema,
|
|
22384
|
+
/**
|
|
22385
|
+
* Runtime-state durability: **restored** — as `smoke`.
|
|
22386
|
+
*
|
|
22387
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
22388
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
22389
|
+
*/
|
|
22390
|
+
durability: "restored",
|
|
22391
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
22392
|
+
* whether persisting is worth a SQLite commit. */
|
|
22393
|
+
volatileStateFields: ["lastChangedAt"]
|
|
22026
22394
|
};
|
|
22027
22395
|
/**
|
|
22028
22396
|
* Humidifier / dehumidifier cap. Models HA `humidifier.*` entities —
|
|
@@ -22098,7 +22466,14 @@ var humidifierCapability = {
|
|
|
22098
22466
|
* Runtime-state slice — mirrored by the kernel. UI controls watch the
|
|
22099
22467
|
* slice for live humidity / mode changes.
|
|
22100
22468
|
*/
|
|
22101
|
-
runtimeState: HumidifierStatusSchema
|
|
22469
|
+
runtimeState: HumidifierStatusSchema,
|
|
22470
|
+
/**
|
|
22471
|
+
* Runtime-state durability: **session** — as `climate-control`.
|
|
22472
|
+
*
|
|
22473
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
22474
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
22475
|
+
*/
|
|
22476
|
+
durability: "session"
|
|
22102
22477
|
};
|
|
22103
22478
|
/**
|
|
22104
22479
|
* Single-metric humidity reading. Drives Home Assistant `sensor`
|
|
@@ -22134,7 +22509,17 @@ var humiditySensorCapability = {
|
|
|
22134
22509
|
schema: HumiditySensorStatusSchema,
|
|
22135
22510
|
kind: "push"
|
|
22136
22511
|
},
|
|
22137
|
-
runtimeState: HumiditySensorStatusSchema
|
|
22512
|
+
runtimeState: HumiditySensorStatusSchema,
|
|
22513
|
+
/**
|
|
22514
|
+
* Runtime-state durability: **restored** — as `numeric-sensor` (67 of 75 writes were the clock alone).
|
|
22515
|
+
*
|
|
22516
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
22517
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
22518
|
+
*/
|
|
22519
|
+
durability: "restored",
|
|
22520
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
22521
|
+
* whether persisting is worth a SQLite commit. */
|
|
22522
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
22138
22523
|
};
|
|
22139
22524
|
/**
|
|
22140
22525
|
* Image display cap. Models a single still image exposed by an integration —
|
|
@@ -22172,7 +22557,14 @@ var imageCapability = {
|
|
|
22172
22557
|
* Runtime-state slice — mirrored by the kernel. The UI reads `url`
|
|
22173
22558
|
* directly and renders the still image.
|
|
22174
22559
|
*/
|
|
22175
|
-
runtimeState: ImageStatusSchema
|
|
22560
|
+
runtimeState: ImageStatusSchema,
|
|
22561
|
+
/**
|
|
22562
|
+
* Runtime-state durability: **session** — a snapshot URL is a session-scoped handle; a restored one points at nothing.
|
|
22563
|
+
*
|
|
22564
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
22565
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
22566
|
+
*/
|
|
22567
|
+
durability: "session"
|
|
22176
22568
|
};
|
|
22177
22569
|
/**
|
|
22178
22570
|
* Vendor-neutral image / picture-adjustment cap — the per-camera config
|
|
@@ -22321,7 +22713,17 @@ var imageSettingsCapability = {
|
|
|
22321
22713
|
schema: ImageSettingsStatusSchema,
|
|
22322
22714
|
kind: "poll"
|
|
22323
22715
|
},
|
|
22324
|
-
runtimeState: ImageSettingsStatusSchema
|
|
22716
|
+
runtimeState: ImageSettingsStatusSchema,
|
|
22717
|
+
/**
|
|
22718
|
+
* Runtime-state durability: **restored** — operator-set camera imaging; mutation-driven.
|
|
22719
|
+
*
|
|
22720
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
22721
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
22722
|
+
*/
|
|
22723
|
+
durability: "restored",
|
|
22724
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
22725
|
+
* whether persisting is worth a SQLite commit. */
|
|
22726
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
22325
22727
|
};
|
|
22326
22728
|
/**
|
|
22327
22729
|
* integrations — system-scoped singleton capability for integration
|
|
@@ -22661,7 +23063,14 @@ var lawnMowerControlCapability = {
|
|
|
22661
23063
|
* Runtime-state slice — mirrored by the kernel. UI controls watch the
|
|
22662
23064
|
* slice for live activity + battery changes.
|
|
22663
23065
|
*/
|
|
22664
|
-
runtimeState: LawnMowerControlStatusSchema
|
|
23066
|
+
runtimeState: LawnMowerControlStatusSchema,
|
|
23067
|
+
/**
|
|
23068
|
+
* Runtime-state durability: **session** — as `vacuum-control`.
|
|
23069
|
+
*
|
|
23070
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
23071
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
23072
|
+
*/
|
|
23073
|
+
durability: "session"
|
|
22665
23074
|
};
|
|
22666
23075
|
/**
|
|
22667
23076
|
* local-network — hub-only singleton.
|
|
@@ -22867,7 +23276,17 @@ var lockControlCapability = {
|
|
|
22867
23276
|
* read `state` and disable themselves during `locking`/`unlocking`
|
|
22868
23277
|
* transitions.
|
|
22869
23278
|
*/
|
|
22870
|
-
runtimeState: LockControlStatusSchema
|
|
23279
|
+
runtimeState: LockControlStatusSchema,
|
|
23280
|
+
/**
|
|
23281
|
+
* Runtime-state durability: **restored** — a lock left locked must still read locked.
|
|
23282
|
+
*
|
|
23283
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
23284
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
23285
|
+
*/
|
|
23286
|
+
durability: "restored",
|
|
23287
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
23288
|
+
* whether persisting is worth a SQLite commit. */
|
|
23289
|
+
volatileStateFields: ["lastChangedAt"]
|
|
22871
23290
|
};
|
|
22872
23291
|
/**
|
|
22873
23292
|
* Media-player cap. Models HA `media_player.*` (Sonos, Chromecast,
|
|
@@ -23029,7 +23448,14 @@ var mediaPlayerCapability = {
|
|
|
23029
23448
|
* full slice for live now-playing, volume, and progress updates
|
|
23030
23449
|
* without polling.
|
|
23031
23450
|
*/
|
|
23032
|
-
runtimeState: MediaPlayerStatusSchema
|
|
23451
|
+
runtimeState: MediaPlayerStatusSchema,
|
|
23452
|
+
/**
|
|
23453
|
+
* Runtime-state durability: **session** — a restored transport position describes a playback that stopped when the hub did.
|
|
23454
|
+
*
|
|
23455
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
23456
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
23457
|
+
*/
|
|
23458
|
+
durability: "session"
|
|
23033
23459
|
};
|
|
23034
23460
|
/**
|
|
23035
23461
|
* mesh-network — collection cap for mesh-VPN providers.
|
|
@@ -23293,7 +23719,14 @@ onMotionChanged: { data: MotionOnMotionChangedDataSchema } },
|
|
|
23293
23719
|
* `device.state.motion.value`. Reads never invoke the provider, so
|
|
23294
23720
|
* UIs and other addons can poll the cached state safely.
|
|
23295
23721
|
*/
|
|
23296
|
-
runtimeState: MotionStatusSchema
|
|
23722
|
+
runtimeState: MotionStatusSchema,
|
|
23723
|
+
/**
|
|
23724
|
+
* 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.
|
|
23725
|
+
*
|
|
23726
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
23727
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
23728
|
+
*/
|
|
23729
|
+
durability: "session"
|
|
23297
23730
|
};
|
|
23298
23731
|
/**
|
|
23299
23732
|
* Motion-trigger toggle for accessory devices.
|
|
@@ -23358,7 +23791,14 @@ var motionTriggerCapability = {
|
|
|
23358
23791
|
schema: MotionTriggerStatusSchema,
|
|
23359
23792
|
kind: "command-driven"
|
|
23360
23793
|
},
|
|
23361
|
-
runtimeState: MotionTriggerRuntimeStateSchema
|
|
23794
|
+
runtimeState: MotionTriggerRuntimeStateSchema,
|
|
23795
|
+
/**
|
|
23796
|
+
* 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.
|
|
23797
|
+
*
|
|
23798
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
23799
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
23800
|
+
*/
|
|
23801
|
+
durability: "session"
|
|
23362
23802
|
};
|
|
23363
23803
|
/**
|
|
23364
23804
|
* Motion-zones share the same MaskShape vocabulary as privacy-mask — the
|
|
@@ -23425,7 +23865,17 @@ var motionZonesCapability = {
|
|
|
23425
23865
|
schema: MotionZoneStatusSchema,
|
|
23426
23866
|
kind: "poll"
|
|
23427
23867
|
},
|
|
23428
|
-
runtimeState: MotionZoneStatusSchema
|
|
23868
|
+
runtimeState: MotionZoneStatusSchema,
|
|
23869
|
+
/**
|
|
23870
|
+
* 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.
|
|
23871
|
+
*
|
|
23872
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
23873
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
23874
|
+
*/
|
|
23875
|
+
durability: "restored",
|
|
23876
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
23877
|
+
* whether persisting is worth a SQLite commit. */
|
|
23878
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
23429
23879
|
};
|
|
23430
23880
|
/**
|
|
23431
23881
|
* On-camera AI object detection cap. Surfaces per-device the classes
|
|
@@ -23499,7 +23949,17 @@ var nativeObjectDetectionCapability = {
|
|
|
23499
23949
|
schema: NativeObjectDetectionStatusSchema,
|
|
23500
23950
|
kind: "push"
|
|
23501
23951
|
},
|
|
23502
|
-
runtimeState: NativeObjectDetectionRuntimeStateSchema
|
|
23952
|
+
runtimeState: NativeObjectDetectionRuntimeStateSchema,
|
|
23953
|
+
/**
|
|
23954
|
+
* 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.
|
|
23955
|
+
*
|
|
23956
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
23957
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
23958
|
+
*/
|
|
23959
|
+
durability: "restored",
|
|
23960
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
23961
|
+
* whether persisting is worth a SQLite commit. */
|
|
23962
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
23503
23963
|
};
|
|
23504
23964
|
/**
|
|
23505
23965
|
* network-quality — system-scoped singleton capability tracking RTT,
|
|
@@ -23833,7 +24293,14 @@ onSent: { data: object({
|
|
|
23833
24293
|
* form reads `supports` to gate optional fields; history pane reads
|
|
23834
24294
|
* `lastSentAt` / `lastError` / `queueDepth`.
|
|
23835
24295
|
*/
|
|
23836
|
-
runtimeState: NotifierStatusSchema
|
|
24296
|
+
runtimeState: NotifierStatusSchema,
|
|
24297
|
+
/**
|
|
24298
|
+
* Runtime-state durability: **session** — live queue depth and last-send state; a restored queue depth describes a queue that no longer exists.
|
|
24299
|
+
*
|
|
24300
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
24301
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
24302
|
+
*/
|
|
24303
|
+
durability: "session"
|
|
23837
24304
|
};
|
|
23838
24305
|
/**
|
|
23839
24306
|
* Generic numeric sensor — last-resort fallback when no typed numeric
|
|
@@ -23876,7 +24343,17 @@ var numericSensorCapability = {
|
|
|
23876
24343
|
schema: NumericSensorStatusSchema,
|
|
23877
24344
|
kind: "push"
|
|
23878
24345
|
},
|
|
23879
|
-
runtimeState: NumericSensorStatusSchema
|
|
24346
|
+
runtimeState: NumericSensorStatusSchema,
|
|
24347
|
+
/**
|
|
24348
|
+
* 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.
|
|
24349
|
+
*
|
|
24350
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
24351
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
24352
|
+
*/
|
|
24353
|
+
durability: "restored",
|
|
24354
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
24355
|
+
* whether persisting is worth a SQLite commit. */
|
|
24356
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
23880
24357
|
};
|
|
23881
24358
|
/**
|
|
23882
24359
|
* Generic on-screen-display (video overlay) cap. Each camera exposes
|
|
@@ -24261,7 +24738,14 @@ var petFeederCapability = {
|
|
|
24261
24738
|
* the full slice via `device.state.petFeeder.value` and refresh on
|
|
24262
24739
|
* every poll without re-querying the provider.
|
|
24263
24740
|
*/
|
|
24264
|
-
runtimeState: PetFeederStatusSchema
|
|
24741
|
+
runtimeState: PetFeederStatusSchema,
|
|
24742
|
+
/**
|
|
24743
|
+
* Runtime-state durability: **session** — live appliance state re-published on connect.
|
|
24744
|
+
*
|
|
24745
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
24746
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
24747
|
+
*/
|
|
24748
|
+
durability: "session"
|
|
24265
24749
|
};
|
|
24266
24750
|
var VehicleSchema = object({
|
|
24267
24751
|
id: string(),
|
|
@@ -24573,7 +25057,17 @@ var powerMeterCapability = {
|
|
|
24573
25057
|
schema: PowerMeterStatusSchema,
|
|
24574
25058
|
kind: "push"
|
|
24575
25059
|
},
|
|
24576
|
-
runtimeState: PowerMeterStatusSchema
|
|
25060
|
+
runtimeState: PowerMeterStatusSchema,
|
|
25061
|
+
/**
|
|
25062
|
+
* Runtime-state durability: **restored** — as `numeric-sensor`; `kwhTotal` is an accumulator whose restored value is the baseline.
|
|
25063
|
+
*
|
|
25064
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
25065
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
25066
|
+
*/
|
|
25067
|
+
durability: "restored",
|
|
25068
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
25069
|
+
* whether persisting is worth a SQLite commit. */
|
|
25070
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
24577
25071
|
};
|
|
24578
25072
|
/**
|
|
24579
25073
|
* Presence cap. Models HA `person.*` and `device_tracker.*` entities
|
|
@@ -24630,7 +25124,17 @@ var presenceCapability = {
|
|
|
24630
25124
|
* the map pin is rendered (use `DeviceFeature.PresenceGps` for the
|
|
24631
25125
|
* pre-fetch fast-path check).
|
|
24632
25126
|
*/
|
|
24633
|
-
runtimeState: PresenceStatusSchema
|
|
25127
|
+
runtimeState: PresenceStatusSchema,
|
|
25128
|
+
/**
|
|
25129
|
+
* Runtime-state durability: **restored** — occupancy-relevant: the restored state is what an occupancy rule compares the first post-restart observation against.
|
|
25130
|
+
*
|
|
25131
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
25132
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
25133
|
+
*/
|
|
25134
|
+
durability: "restored",
|
|
25135
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
25136
|
+
* whether persisting is worth a SQLite commit. */
|
|
25137
|
+
volatileStateFields: ["lastChangedAt"]
|
|
24634
25138
|
};
|
|
24635
25139
|
/**
|
|
24636
25140
|
* Atmospheric pressure reading in hectopascals. Drives Home Assistant
|
|
@@ -24666,7 +25170,17 @@ var pressureSensorCapability = {
|
|
|
24666
25170
|
schema: PressureSensorStatusSchema,
|
|
24667
25171
|
kind: "push"
|
|
24668
25172
|
},
|
|
24669
|
-
runtimeState: PressureSensorStatusSchema
|
|
25173
|
+
runtimeState: PressureSensorStatusSchema,
|
|
25174
|
+
/**
|
|
25175
|
+
* Runtime-state durability: **restored** — as `numeric-sensor`.
|
|
25176
|
+
*
|
|
25177
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
25178
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
25179
|
+
*/
|
|
25180
|
+
durability: "restored",
|
|
25181
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
25182
|
+
* whether persisting is worth a SQLite commit. */
|
|
25183
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
24670
25184
|
};
|
|
24671
25185
|
/**
|
|
24672
25186
|
* PRIVACY — what the camera deliberately does not capture. Two planes:
|
|
@@ -24796,7 +25310,17 @@ var privacyMaskCapability = {
|
|
|
24796
25310
|
schema: PrivacyMaskStatusSchema,
|
|
24797
25311
|
kind: "poll"
|
|
24798
25312
|
},
|
|
24799
|
-
runtimeState: PrivacyMaskStatusSchema
|
|
25313
|
+
runtimeState: PrivacyMaskStatusSchema,
|
|
25314
|
+
/**
|
|
25315
|
+
* Runtime-state durability: **restored** — operator-drawn regions, zero real churn — 22 writes in 25 minutes, every one of them the clock.
|
|
25316
|
+
*
|
|
25317
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
25318
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
25319
|
+
*/
|
|
25320
|
+
durability: "restored",
|
|
25321
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
25322
|
+
* whether persisting is worth a SQLite commit. */
|
|
25323
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
24800
25324
|
};
|
|
24801
25325
|
var PtzPresetSchema = object({
|
|
24802
25326
|
id: string(),
|
|
@@ -24962,7 +25486,14 @@ var ptzAutotrackCapability = {
|
|
|
24962
25486
|
* fetch / cache / fallback logic out of the four cap methods —
|
|
24963
25487
|
* they become trampolines over `runtimeState`.
|
|
24964
25488
|
*/
|
|
24965
|
-
runtimeState: PtzAutotrackRuntimeStateSchema
|
|
25489
|
+
runtimeState: PtzAutotrackRuntimeStateSchema,
|
|
25490
|
+
/**
|
|
25491
|
+
* Runtime-state durability: **session** — mirrors the camera's own autotrack config, re-read on connect.
|
|
25492
|
+
*
|
|
25493
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
25494
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
25495
|
+
*/
|
|
25496
|
+
durability: "session"
|
|
24966
25497
|
};
|
|
24967
25498
|
DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceId: number().int().nonnegative() }), object({ success: literal(true) }), {
|
|
24968
25499
|
kind: "mutation",
|
|
@@ -25612,7 +26143,14 @@ var sceneMonitorCapability = {
|
|
|
25612
26143
|
schema: SceneMonitorStatusSchema,
|
|
25613
26144
|
kind: "push"
|
|
25614
26145
|
},
|
|
25615
|
-
runtimeState: SceneMonitorStatusSchema
|
|
26146
|
+
runtimeState: SceneMonitorStatusSchema,
|
|
26147
|
+
/**
|
|
26148
|
+
* Runtime-state durability: **session** — re-derived from the current scene on the next evaluation.
|
|
26149
|
+
*
|
|
26150
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
26151
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
26152
|
+
*/
|
|
26153
|
+
durability: "session"
|
|
25616
26154
|
};
|
|
25617
26155
|
/**
|
|
25618
26156
|
* Per-stage gating mode applied to the zones a rule references.
|
|
@@ -25756,7 +26294,14 @@ var scriptRunnerCapability = {
|
|
|
25756
26294
|
* `isRunning` to render a spinner during execution and surfaces
|
|
25757
26295
|
* `lastError` / `lastRunSuccess` in the recent-runs panel.
|
|
25758
26296
|
*/
|
|
25759
|
-
runtimeState: ScriptRunnerStatusSchema
|
|
26297
|
+
runtimeState: ScriptRunnerStatusSchema,
|
|
26298
|
+
/**
|
|
26299
|
+
* Runtime-state durability: **session** — a restored `isRunning: true` describes a process that died with the previous hub.
|
|
26300
|
+
*
|
|
26301
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
26302
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
26303
|
+
*/
|
|
26304
|
+
durability: "session"
|
|
25760
26305
|
};
|
|
25761
26306
|
/**
|
|
25762
26307
|
* Smoke alarm sensor — boolean "is smoke currently detected" with
|
|
@@ -25783,7 +26328,17 @@ var smokeCapability = {
|
|
|
25783
26328
|
schema: SmokeStatusSchema,
|
|
25784
26329
|
kind: "push"
|
|
25785
26330
|
},
|
|
25786
|
-
runtimeState: SmokeStatusSchema
|
|
26331
|
+
runtimeState: SmokeStatusSchema,
|
|
26332
|
+
/**
|
|
26333
|
+
* Runtime-state durability: **restored** — a safety sensor must not read "clear" merely because the hub restarted.
|
|
26334
|
+
*
|
|
26335
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
26336
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
26337
|
+
*/
|
|
26338
|
+
durability: "restored",
|
|
26339
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
26340
|
+
* whether persisting is worth a SQLite commit. */
|
|
26341
|
+
volatileStateFields: ["lastChangedAt"]
|
|
25787
26342
|
};
|
|
25788
26343
|
/**
|
|
25789
26344
|
* One publishable camera stream as its OWNING PROVIDER describes it — the same
|
|
@@ -25969,7 +26524,17 @@ var streamParamsCapability = {
|
|
|
25969
26524
|
schema: StreamParamsStatusSchema,
|
|
25970
26525
|
kind: "poll"
|
|
25971
26526
|
},
|
|
25972
|
-
runtimeState: StreamParamsStatusSchema
|
|
26527
|
+
runtimeState: StreamParamsStatusSchema,
|
|
26528
|
+
/**
|
|
26529
|
+
* Runtime-state durability: **restored** — operator-set encoder profile; mutation-driven.
|
|
26530
|
+
*
|
|
26531
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
26532
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
26533
|
+
*/
|
|
26534
|
+
durability: "restored",
|
|
26535
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
26536
|
+
* whether persisting is worth a SQLite commit. */
|
|
26537
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
25973
26538
|
};
|
|
25974
26539
|
/**
|
|
25975
26540
|
* Generic on/off switch cap for accessory children (siren, floodlight,
|
|
@@ -26015,6 +26580,16 @@ var switchCapability = {
|
|
|
26015
26580
|
* not need to re-query the provider after a setState mutation.
|
|
26016
26581
|
*/
|
|
26017
26582
|
runtimeState: SwitchStatusSchema,
|
|
26583
|
+
/**
|
|
26584
|
+
* Runtime-state durability: **restored** — device state an operator reads as authoritative; 55 devices, transition-driven.
|
|
26585
|
+
*
|
|
26586
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
26587
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
26588
|
+
*/
|
|
26589
|
+
durability: "restored",
|
|
26590
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
26591
|
+
* whether persisting is worth a SQLite commit. */
|
|
26592
|
+
volatileStateFields: ["lastChangedAt"],
|
|
26018
26593
|
settings: { bindings: [{
|
|
26019
26594
|
kind: "scalar",
|
|
26020
26595
|
statusPath: "on",
|
|
@@ -26094,7 +26669,17 @@ var tamperCapability = {
|
|
|
26094
26669
|
schema: TamperStatusSchema,
|
|
26095
26670
|
kind: "push"
|
|
26096
26671
|
},
|
|
26097
|
-
runtimeState: TamperStatusSchema
|
|
26672
|
+
runtimeState: TamperStatusSchema,
|
|
26673
|
+
/**
|
|
26674
|
+
* Runtime-state durability: **restored** — as `smoke`.
|
|
26675
|
+
*
|
|
26676
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
26677
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
26678
|
+
*/
|
|
26679
|
+
durability: "restored",
|
|
26680
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
26681
|
+
* whether persisting is worth a SQLite commit. */
|
|
26682
|
+
volatileStateFields: ["lastChangedAt"]
|
|
26098
26683
|
};
|
|
26099
26684
|
/**
|
|
26100
26685
|
* Single-metric temperature reading. Drives Home Assistant `sensor`
|
|
@@ -26139,7 +26724,17 @@ var temperatureSensorCapability = {
|
|
|
26139
26724
|
schema: TemperatureSensorStatusSchema,
|
|
26140
26725
|
kind: "push"
|
|
26141
26726
|
},
|
|
26142
|
-
runtimeState: TemperatureSensorStatusSchema
|
|
26727
|
+
runtimeState: TemperatureSensorStatusSchema,
|
|
26728
|
+
/**
|
|
26729
|
+
* Runtime-state durability: **restored** — as `numeric-sensor` (69 of 125 writes were the clock alone).
|
|
26730
|
+
*
|
|
26731
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
26732
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
26733
|
+
*/
|
|
26734
|
+
durability: "restored",
|
|
26735
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
26736
|
+
* whether persisting is worth a SQLite commit. */
|
|
26737
|
+
volatileStateFields: ["lastFetchedAt"]
|
|
26143
26738
|
};
|
|
26144
26739
|
/**
|
|
26145
26740
|
* toast — system-scoped singleton capability that streams toast
|
|
@@ -26208,7 +26803,14 @@ var updateCapability = {
|
|
|
26208
26803
|
schema: UpdateStatusSchema,
|
|
26209
26804
|
kind: "poll"
|
|
26210
26805
|
},
|
|
26211
|
-
runtimeState: UpdateStatusSchema
|
|
26806
|
+
runtimeState: UpdateStatusSchema,
|
|
26807
|
+
/**
|
|
26808
|
+
* Runtime-state durability: **session** — a restored `inProgress: true` describes an update that is no longer running; versions are re-probed at boot.
|
|
26809
|
+
*
|
|
26810
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
26811
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
26812
|
+
*/
|
|
26813
|
+
durability: "session"
|
|
26212
26814
|
};
|
|
26213
26815
|
var UserSummarySchema = object({
|
|
26214
26816
|
id: string(),
|
|
@@ -26542,7 +27144,14 @@ var vacuumControlCapability = {
|
|
|
26542
27144
|
* Runtime-state slice — mirrored by the kernel. UI controls watch the
|
|
26543
27145
|
* slice for live state + battery + fan-speed changes.
|
|
26544
27146
|
*/
|
|
26545
|
-
runtimeState: VacuumControlStatusSchema
|
|
27147
|
+
runtimeState: VacuumControlStatusSchema,
|
|
27148
|
+
/**
|
|
27149
|
+
* Runtime-state durability: **session** — as `media-player` — a restored `state: cleaning` is a robot that is not cleaning.
|
|
27150
|
+
*
|
|
27151
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
27152
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
27153
|
+
*/
|
|
27154
|
+
durability: "session"
|
|
26546
27155
|
};
|
|
26547
27156
|
var ValveStatusSchema = object({
|
|
26548
27157
|
/** Lifecycle state of the valve. */
|
|
@@ -26594,7 +27203,14 @@ var valveCapability = {
|
|
|
26594
27203
|
* Runtime-state slice — mirrored by the kernel. UI controls watch the
|
|
26595
27204
|
* slice for live position changes during a move.
|
|
26596
27205
|
*/
|
|
26597
|
-
runtimeState: ValveStatusSchema
|
|
27206
|
+
runtimeState: ValveStatusSchema,
|
|
27207
|
+
/**
|
|
27208
|
+
* Runtime-state durability: **session** — as `brightness`.
|
|
27209
|
+
*
|
|
27210
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
27211
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
27212
|
+
*/
|
|
27213
|
+
durability: "session"
|
|
26598
27214
|
};
|
|
26599
27215
|
/**
|
|
26600
27216
|
* Vibration / shake / impact sensor. Drives Home Assistant
|
|
@@ -26616,7 +27232,17 @@ var vibrationCapability = {
|
|
|
26616
27232
|
schema: VibrationStatusSchema,
|
|
26617
27233
|
kind: "push"
|
|
26618
27234
|
},
|
|
26619
|
-
runtimeState: VibrationStatusSchema
|
|
27235
|
+
runtimeState: VibrationStatusSchema,
|
|
27236
|
+
/**
|
|
27237
|
+
* Runtime-state durability: **restored** — as `smoke`.
|
|
27238
|
+
*
|
|
27239
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
27240
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
27241
|
+
*/
|
|
27242
|
+
durability: "restored",
|
|
27243
|
+
/** Clock fields: written, but excluded from the compare that decides
|
|
27244
|
+
* whether persisting is worth a SQLite commit. */
|
|
27245
|
+
volatileStateFields: ["lastChangedAt"]
|
|
26620
27246
|
};
|
|
26621
27247
|
/**
|
|
26622
27248
|
* Water heater / boiler cap. Models HA `water_heater.*` entities — a
|
|
@@ -26690,7 +27316,14 @@ var waterHeaterCapability = {
|
|
|
26690
27316
|
* Runtime-state slice — mirrored by the kernel. UI controls watch the
|
|
26691
27317
|
* slice for live temperature / mode / away changes.
|
|
26692
27318
|
*/
|
|
26693
|
-
runtimeState: WaterHeaterStatusSchema
|
|
27319
|
+
runtimeState: WaterHeaterStatusSchema,
|
|
27320
|
+
/**
|
|
27321
|
+
* Runtime-state durability: **session** — as `climate-control`.
|
|
27322
|
+
*
|
|
27323
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
27324
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
27325
|
+
*/
|
|
27326
|
+
durability: "session"
|
|
26694
27327
|
};
|
|
26695
27328
|
/**
|
|
26696
27329
|
* Weather provider cap. Models HA `weather.*` entities — a read-only
|
|
@@ -26749,7 +27382,14 @@ var weatherCapability = {
|
|
|
26749
27382
|
* Runtime-state slice — mirrored by the kernel. The UI reads the
|
|
26750
27383
|
* current conditions directly from the slice on each weather push.
|
|
26751
27384
|
*/
|
|
26752
|
-
runtimeState: WeatherStatusSchema
|
|
27385
|
+
runtimeState: WeatherStatusSchema,
|
|
27386
|
+
/**
|
|
27387
|
+
* Runtime-state durability: **session** — a forecast is stale the moment the hub is down; the provider re-fetches on connect.
|
|
27388
|
+
*
|
|
27389
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
27390
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
27391
|
+
*/
|
|
27392
|
+
durability: "session"
|
|
26753
27393
|
};
|
|
26754
27394
|
/**
|
|
26755
27395
|
* Per-zone occupancy aggregation produced by the analytics frame
|
|
@@ -26911,7 +27551,14 @@ var zoneAnalyticsCapability = {
|
|
|
26911
27551
|
* automatically; the explicit `getCurrentSnapshot` cap method is
|
|
26912
27552
|
* still useful for one-off polls without a subscription.
|
|
26913
27553
|
*/
|
|
26914
|
-
runtimeState: CameraOccupancySnapshotSchema
|
|
27554
|
+
runtimeState: CameraOccupancySnapshotSchema,
|
|
27555
|
+
/**
|
|
27556
|
+
* Runtime-state durability: **session** — per-frame analytics; with `audio-metrics` it is ~90 % of the offered write rate. Re-derived on the next frame.
|
|
27557
|
+
*
|
|
27558
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
27559
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
27560
|
+
*/
|
|
27561
|
+
durability: "session"
|
|
26915
27562
|
};
|
|
26916
27563
|
/**
|
|
26917
27564
|
* Stages a {@link ZoneRule} can apply to. Discriminator on the rules
|
|
@@ -26989,7 +27636,14 @@ var zoneRulesCapability = {
|
|
|
26989
27636
|
motion: array(ZoneRuleSchema).readonly(),
|
|
26990
27637
|
detection: array(ZoneRuleSchema).readonly(),
|
|
26991
27638
|
package: array(ZoneRuleSchema).readonly()
|
|
26992
|
-
})
|
|
27639
|
+
}),
|
|
27640
|
+
/**
|
|
27641
|
+
* Runtime-state durability: **restored** — operator intent, mutation-only, same argument as `zones`.
|
|
27642
|
+
*
|
|
27643
|
+
* See `RuntimeStateDurability`. Enforced by
|
|
27644
|
+
* `scripts/check-runtime-state-durability.ts`.
|
|
27645
|
+
*/
|
|
27646
|
+
durability: "restored"
|
|
26993
27647
|
};
|
|
26994
27648
|
/**
|
|
26995
27649
|
* Accessory device helpers — shared across drivers.
|
|
@@ -33675,6 +34329,7 @@ Object.freeze({
|
|
|
33675
34329
|
"network-access": "ingress",
|
|
33676
34330
|
"smtp-provider": "email"
|
|
33677
34331
|
});
|
|
34332
|
+
new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
|
|
33678
34333
|
new Set(["devices", "classes"]);
|
|
33679
34334
|
/**
|
|
33680
34335
|
* TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
|