@camstack/addon-export-alexa 1.2.168 → 1.2.170

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.
@@ -5,7 +5,7 @@ import "node:fs";
5
5
  import "node:path";
6
6
  import "node:child_process";
7
7
  import "node:zlib";
8
- //#region ../types/dist/event-category-DHXxB8t9.mjs
8
+ //#region ../types/dist/event-category-CT-hz5Rb.mjs
9
9
  var EventCategory = /* @__PURE__ */ function(EventCategory) {
10
10
  EventCategory["SystemBoot"] = "system.boot";
11
11
  EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -331,6 +331,14 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
331
331
  /** The recovery edge of {@link PipelineMotionNoisy}: the motion fell back, or a detection arrived. */
332
332
  EventCategory["PipelineMotionCalm"] = "pipeline.motion-calm";
333
333
  /**
334
+ * A camera's package LLM confirm has failed closed three times in a row
335
+ * (D931, 2026-10-26). One edge per camera until
336
+ * {@link PipelinePackageLlmAnswered}.
337
+ */
338
+ EventCategory["PipelinePackageLlmSilent"] = "pipeline.package-llm-silent";
339
+ /** The recovery edge of {@link PipelinePackageLlmSilent}: a confirm returned yes or no. */
340
+ EventCategory["PipelinePackageLlmAnswered"] = "pipeline.package-llm-answered";
341
+ /**
334
342
  * Per-camera pipeline config was mutated by the orchestrator
335
343
  * (a settings change via `setAgentInferenceDevices` /
336
344
  * `setCameraStepToggle` / `setCameraStepSettings`). Orchestrator
@@ -5440,7 +5448,7 @@ var ZodIssueCode = {
5440
5448
  var ZodFirstPartyTypeKind;
5441
5449
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5442
5450
  //#endregion
5443
- //#region ../types/dist/sleep-BErAxhul.mjs
5451
+ //#region ../types/dist/sleep-bykKrTgu.mjs
5444
5452
  /**
5445
5453
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5446
5454
  * window to float samples (D455).
@@ -7927,6 +7935,99 @@ var RecordKindDeclarationSchema = object({
7927
7935
  }).strict();
7928
7936
  /** The kind names: lower-case, dash separated, short enough for an index name. */
7929
7937
  var RecordKindNameSchema = string().regex(/^[a-z][a-z0-9-]{0,47}$/);
7938
+ var READING_QUANTITIES = [
7939
+ "temperature",
7940
+ "pressure",
7941
+ "speed",
7942
+ "precipitation",
7943
+ "precipitation-rate",
7944
+ "length",
7945
+ "area",
7946
+ "illuminance",
7947
+ "irradiance",
7948
+ "power",
7949
+ "energy",
7950
+ "voltage",
7951
+ "current",
7952
+ "apparent-power",
7953
+ "humidity",
7954
+ "percentage",
7955
+ "concentration-volume",
7956
+ "concentration-mass",
7957
+ "concentration-ppb",
7958
+ "volume",
7959
+ "duration",
7960
+ "duration-ms",
7961
+ "information",
7962
+ "sound-level",
7963
+ "signal-level",
7964
+ "colour-temperature",
7965
+ "angle",
7966
+ "bitrate",
7967
+ "rate",
7968
+ "mass",
7969
+ "index",
7970
+ "ratio",
7971
+ "count",
7972
+ "none",
7973
+ "device"
7974
+ ];
7975
+ var ReadingQuantitySchema = _enum(READING_QUANTITIES);
7976
+ new Set(READING_QUANTITIES);
7977
+ /**
7978
+ * Stored unit symbol for a quantity. `none` means the number is dimensionless
7979
+ * (or an index / ratio / count). `device` means the cap has no single unit.
7980
+ */
7981
+ var QUANTITY_BASE = {
7982
+ temperature: "°C",
7983
+ pressure: "hPa",
7984
+ speed: "m/s",
7985
+ precipitation: "mm",
7986
+ "precipitation-rate": "mm/h",
7987
+ length: "m",
7988
+ area: "m²",
7989
+ illuminance: "lx",
7990
+ irradiance: "W/m²",
7991
+ power: "W",
7992
+ energy: "kWh",
7993
+ voltage: "V",
7994
+ current: "A",
7995
+ "apparent-power": "VA",
7996
+ humidity: "%",
7997
+ percentage: "%",
7998
+ "concentration-volume": "ppm",
7999
+ "concentration-mass": "µg/m³",
8000
+ "concentration-ppb": "ppb",
8001
+ volume: "L",
8002
+ duration: "s",
8003
+ "duration-ms": "ms",
8004
+ information: "B",
8005
+ "sound-level": "dBFS",
8006
+ "signal-level": "dBm",
8007
+ "colour-temperature": "mired",
8008
+ angle: "°",
8009
+ bitrate: "kbps",
8010
+ rate: "fps",
8011
+ mass: "kg",
8012
+ index: "none",
8013
+ ratio: "none",
8014
+ count: "none",
8015
+ none: "none",
8016
+ device: "device"
8017
+ };
8018
+ /** The stored unit, or `undefined` when the quantity has no unit symbol. */
8019
+ function baseUnitOf(quantity) {
8020
+ const symbol = QUANTITY_BASE[quantity];
8021
+ if (symbol === "none" || symbol === "device") return void 0;
8022
+ return symbol;
8023
+ }
8024
+ function readingMeta(quantity, extras) {
8025
+ return {
8026
+ quantity,
8027
+ ...extras?.precision !== void 0 ? { precision: extras.precision } : {},
8028
+ ...extras?.label !== void 0 ? { label: extras.label } : {}
8029
+ };
8030
+ }
7930
8031
  /** Shared Zod schemas used across streaming capabilities. */
7931
8032
  var CamProfileSchema = _enum([
7932
8033
  "high",
@@ -7954,8 +8055,8 @@ var CamStreamKindSchema = _enum([
7954
8055
  "derived"
7955
8056
  ]);
7956
8057
  var CamStreamResolutionSchema = object({
7957
- width: number().int().positive(),
7958
- height: number().int().positive()
8058
+ width: number().int().positive().meta(readingMeta("none")),
8059
+ height: number().int().positive().meta(readingMeta("none"))
7959
8060
  });
7960
8061
  var CameraStreamSchema = object({
7961
8062
  /** Stable, provider-assigned id unique within the (deviceId) scope. */
@@ -8491,6 +8592,8 @@ var CAP_NAMES = Object.freeze([
8491
8592
  "filesystem-browse",
8492
8593
  "flood",
8493
8594
  "gas",
8595
+ "group-commands",
8596
+ "group-status",
8494
8597
  "heating-valve",
8495
8598
  "humidifier",
8496
8599
  "humidity-sensor",
@@ -8620,14 +8723,6 @@ Object.freeze({
8620
8723
  {
8621
8724
  "path": "aqi",
8622
8725
  "valueType": "number"
8623
- },
8624
- {
8625
- "path": "unit",
8626
- "valueType": "string"
8627
- },
8628
- {
8629
- "path": "precision",
8630
- "valueType": "number"
8631
8726
  }
8632
8727
  ],
8633
8728
  "alarm-panel": [
@@ -8663,20 +8758,10 @@ Object.freeze({
8663
8758
  "valueType": "boolean"
8664
8759
  }
8665
8760
  ],
8666
- "ambient-light-sensor": [
8667
- {
8668
- "path": "lux",
8669
- "valueType": "number"
8670
- },
8671
- {
8672
- "path": "unit",
8673
- "valueType": "string"
8674
- },
8675
- {
8676
- "path": "precision",
8677
- "valueType": "number"
8678
- }
8679
- ],
8761
+ "ambient-light-sensor": [{
8762
+ "path": "lux",
8763
+ "valueType": "number"
8764
+ }],
8680
8765
  "audio-metrics": [
8681
8766
  {
8682
8767
  "path": "ts",
@@ -8756,6 +8841,10 @@ Object.freeze({
8756
8841
  "path": "lastUpdated",
8757
8842
  "valueType": "number"
8758
8843
  },
8844
+ {
8845
+ "path": "volts",
8846
+ "valueType": "number"
8847
+ },
8759
8848
  {
8760
8849
  "path": "lastContactAt",
8761
8850
  "valueType": "number"
@@ -8998,10 +9087,6 @@ Object.freeze({
8998
9087
  "datetime"
8999
9088
  ]
9000
9089
  },
9001
- {
9002
- "path": "unit",
9003
- "valueType": "string"
9004
- },
9005
9090
  {
9006
9091
  "path": "min",
9007
9092
  "valueType": "number"
@@ -9013,19 +9098,6 @@ Object.freeze({
9013
9098
  {
9014
9099
  "path": "step",
9015
9100
  "valueType": "number"
9016
- },
9017
- {
9018
- "path": "precision",
9019
- "valueType": "number"
9020
- },
9021
- {
9022
- "path": "format",
9023
- "valueType": "enum",
9024
- "enumValues": [
9025
- "date",
9026
- "time",
9027
- "datetime"
9028
- ]
9029
9101
  }
9030
9102
  ],
9031
9103
  "cover": [
@@ -9266,13 +9338,8 @@ Object.freeze({
9266
9338
  "path": "value",
9267
9339
  "valueType": "string"
9268
9340
  }, {
9269
- "path": "format",
9270
- "valueType": "enum",
9271
- "enumValues": [
9272
- "date",
9273
- "time",
9274
- "datetime"
9275
- ]
9341
+ "path": "timestamp",
9342
+ "valueType": "boolean"
9276
9343
  }],
9277
9344
  "event-emitter": [
9278
9345
  {
@@ -9345,6 +9412,20 @@ Object.freeze({
9345
9412
  "path": "detected",
9346
9413
  "valueType": "boolean"
9347
9414
  }],
9415
+ "group-status": [
9416
+ {
9417
+ "path": "included",
9418
+ "valueType": "number"
9419
+ },
9420
+ {
9421
+ "path": "excluded",
9422
+ "valueType": "number"
9423
+ },
9424
+ {
9425
+ "path": "total",
9426
+ "valueType": "number"
9427
+ }
9428
+ ],
9348
9429
  "heating-valve": [{
9349
9430
  "path": "position",
9350
9431
  "valueType": "number"
@@ -9379,20 +9460,10 @@ Object.freeze({
9379
9460
  "valueType": "number"
9380
9461
  }
9381
9462
  ],
9382
- "humidity-sensor": [
9383
- {
9384
- "path": "percent",
9385
- "valueType": "number"
9386
- },
9387
- {
9388
- "path": "unit",
9389
- "valueType": "string"
9390
- },
9391
- {
9392
- "path": "precision",
9393
- "valueType": "number"
9394
- }
9395
- ],
9463
+ "humidity-sensor": [{
9464
+ "path": "percent",
9465
+ "valueType": "number"
9466
+ }],
9396
9467
  "image": [{
9397
9468
  "path": "url",
9398
9469
  "valueType": "string"
@@ -9731,20 +9802,10 @@ Object.freeze({
9731
9802
  "valueType": "boolean"
9732
9803
  }
9733
9804
  ],
9734
- "numeric-sensor": [
9735
- {
9736
- "path": "value",
9737
- "valueType": "number"
9738
- },
9739
- {
9740
- "path": "unit",
9741
- "valueType": "string"
9742
- },
9743
- {
9744
- "path": "precision",
9745
- "valueType": "number"
9746
- }
9747
- ],
9805
+ "numeric-sensor": [{
9806
+ "path": "value",
9807
+ "valueType": "number"
9808
+ }],
9748
9809
  "pet-feeder": [
9749
9810
  {
9750
9811
  "path": "foodLevel",
@@ -9836,14 +9897,6 @@ Object.freeze({
9836
9897
  {
9837
9898
  "path": "powerFactor",
9838
9899
  "valueType": "number"
9839
- },
9840
- {
9841
- "path": "unit",
9842
- "valueType": "string"
9843
- },
9844
- {
9845
- "path": "precision",
9846
- "valueType": "number"
9847
9900
  }
9848
9901
  ],
9849
9902
  "presence": [
@@ -9872,20 +9925,10 @@ Object.freeze({
9872
9925
  "valueType": "number"
9873
9926
  }
9874
9927
  ],
9875
- "pressure-sensor": [
9876
- {
9877
- "path": "hpa",
9878
- "valueType": "number"
9879
- },
9880
- {
9881
- "path": "unit",
9882
- "valueType": "string"
9883
- },
9884
- {
9885
- "path": "precision",
9886
- "valueType": "number"
9887
- }
9888
- ],
9928
+ "pressure-sensor": [{
9929
+ "path": "hpa",
9930
+ "valueType": "number"
9931
+ }],
9889
9932
  "privacy-mask": [{
9890
9933
  "path": "enabled",
9891
9934
  "valueType": "boolean"
@@ -10196,20 +10239,10 @@ Object.freeze({
10196
10239
  "path": "tampered",
10197
10240
  "valueType": "boolean"
10198
10241
  }],
10199
- "temperature-sensor": [
10200
- {
10201
- "path": "celsius",
10202
- "valueType": "number"
10203
- },
10204
- {
10205
- "path": "unit",
10206
- "valueType": "string"
10207
- },
10208
- {
10209
- "path": "precision",
10210
- "valueType": "number"
10211
- }
10212
- ],
10242
+ "temperature-sensor": [{
10243
+ "path": "celsius",
10244
+ "valueType": "number"
10245
+ }],
10213
10246
  "update": [
10214
10247
  {
10215
10248
  "path": "currentVersion",
@@ -10320,10 +10353,6 @@ Object.freeze({
10320
10353
  "path": "temperature",
10321
10354
  "valueType": "number"
10322
10355
  },
10323
- {
10324
- "path": "temperatureUnit",
10325
- "valueType": "string"
10326
- },
10327
10356
  {
10328
10357
  "path": "humidity",
10329
10358
  "valueType": "number"
@@ -10332,18 +10361,10 @@ Object.freeze({
10332
10361
  "path": "pressure",
10333
10362
  "valueType": "number"
10334
10363
  },
10335
- {
10336
- "path": "pressureUnit",
10337
- "valueType": "string"
10338
- },
10339
10364
  {
10340
10365
  "path": "windSpeed",
10341
10366
  "valueType": "number"
10342
10367
  },
10343
- {
10344
- "path": "windSpeedUnit",
10345
- "valueType": "string"
10346
- },
10347
10368
  {
10348
10369
  "path": "windBearing",
10349
10370
  "valueType": "number"
@@ -10746,7 +10767,7 @@ function errMsg(err) {
10746
10767
  return String(err);
10747
10768
  }
10748
10769
  //#endregion
10749
- //#region ../types/dist/composition-kEl9mevu.mjs
10770
+ //#region ../types/dist/composition-OhpuespA.mjs
10750
10771
  /**
10751
10772
  * The ffmpeg build every CamStack node downloads, per platform and arch.
10752
10773
  *
@@ -11501,15 +11522,74 @@ function validateExpressionSource(src) {
11501
11522
  }
11502
11523
  return null;
11503
11524
  }
11504
- /** A composed device's stableId is this prefix plus the block id. */
11505
- var COMPOSED_DEVICE_STABLE_ID_PREFIX = "composed-";
11506
- /** Longest snippet a `code` source may carry (slice 4). */
11507
- var MAX_COMPOSITION_CODE_LENGTH = 2e4;
11525
+ /**
11526
+ * A composition source identity: `(addonId, stableId)`, never a numeric device
11527
+ * id. Split out so helper schemas can name it without a cycle through
11528
+ * `composition.ts` (D659).
11529
+ */
11508
11530
  var CompositionSourceRefSchema = object({
11509
11531
  /** The owning addon; `stableId` is unique only within it. */
11510
11532
  addonId: string().min(1),
11511
11533
  stableId: string().min(1)
11512
11534
  });
11535
+ var GROUP_TEMPLATE_IDS = [
11536
+ "temperature",
11537
+ "humidity",
11538
+ "pressure",
11539
+ "illuminance",
11540
+ "power",
11541
+ "energy",
11542
+ "battery",
11543
+ "numeric",
11544
+ "motion",
11545
+ "contact",
11546
+ "leak",
11547
+ "smoke",
11548
+ "occupancy",
11549
+ "binary",
11550
+ "switch",
11551
+ "light"
11552
+ ];
11553
+ var NUMERIC_AGGREGATES = [
11554
+ "mean",
11555
+ "median",
11556
+ "min",
11557
+ "max",
11558
+ "sum"
11559
+ ];
11560
+ var BINARY_AGGREGATES = ["any", "all"];
11561
+ /** How an actuator group decides it is on. Unknown members never count as off. */
11562
+ var ACTIVE_CRITERIA = ["at-least-one", "all"];
11563
+ var AGGREGATE_REDUCERS = [
11564
+ "mean",
11565
+ "median",
11566
+ "min",
11567
+ "max",
11568
+ "sum",
11569
+ "any",
11570
+ "all"
11571
+ ];
11572
+ var GroupTemplateIdSchema = _enum(GROUP_TEMPLATE_IDS);
11573
+ var AggregateReducerSchema = _enum(AGGREGATE_REDUCERS);
11574
+ var ActiveCriterionSchema = _enum(ACTIVE_CRITERIA);
11575
+ /** One member. The field is stored so occupancy can name motion or binary. */
11576
+ var HelperMemberSchema = object({
11577
+ source: CompositionSourceRefSchema,
11578
+ cap: string().min(1),
11579
+ fieldPath: string().min(1)
11580
+ });
11581
+ var HelperSpecSchema = discriminatedUnion("kind", [object({
11582
+ kind: literal("group"),
11583
+ templateId: GroupTemplateIdSchema,
11584
+ aggregate: AggregateReducerSchema,
11585
+ members: array(HelperMemberSchema).min(1).max(64),
11586
+ /** Actuator groups only. Readings leave this unset. */
11587
+ active: ActiveCriterionSchema.optional()
11588
+ })]);
11589
+ /** A composed device's stableId is this prefix plus the block id. */
11590
+ var COMPOSED_DEVICE_STABLE_ID_PREFIX = "composed-";
11591
+ /** Longest snippet a `code` source may carry (slice 4). */
11592
+ var MAX_COMPOSITION_CODE_LENGTH = 2e4;
11513
11593
  /** One field of one capability of one source device. */
11514
11594
  var CompositionFieldReadSchema = object({
11515
11595
  source: CompositionSourceRefSchema,
@@ -11553,7 +11633,33 @@ var CompositionCodeSourceSchema = object({
11553
11633
  var CompositionFieldSourceSchema = discriminatedUnion("kind", [
11554
11634
  CompositionFromSourceSchema,
11555
11635
  CompositionExpressionSourceSchema,
11556
- CompositionCodeSourceSchema
11636
+ CompositionCodeSourceSchema,
11637
+ object({
11638
+ kind: literal("aggregate"),
11639
+ reducer: _enum([
11640
+ "mean",
11641
+ "median",
11642
+ "min",
11643
+ "max",
11644
+ "sum",
11645
+ "any",
11646
+ "all"
11647
+ ]),
11648
+ reads: array(CompositionFieldReadSchema).min(1).max(64),
11649
+ /** `value` is the reading; the others are the member counts. */
11650
+ publish: _enum([
11651
+ "value",
11652
+ "included",
11653
+ "excluded",
11654
+ "total"
11655
+ ]),
11656
+ /** What a `value` publish does when nobody is included. Counts ignore this. */
11657
+ empty: _enum([
11658
+ "null",
11659
+ "omit",
11660
+ "offline"
11661
+ ])
11662
+ })
11557
11663
  ]);
11558
11664
  var CompositionCommandTargetSchema = discriminatedUnion("kind", [object({
11559
11665
  kind: literal("forward"),
@@ -11599,7 +11705,13 @@ var CompositionSchema = object({
11599
11705
  kind: literal("existing"),
11600
11706
  device: CompositionSourceRefSchema
11601
11707
  })]),
11602
- features: array(CompositionFeatureSchema).min(1).max(16)
11708
+ features: array(CompositionFeatureSchema).min(1).max(16),
11709
+ /**
11710
+ * Present when the block is a helper template. Absent on a free
11711
+ * composition (the room example, device 4603). The editor reads this,
11712
+ * never the compiled features.
11713
+ */
11714
+ helper: HelperSpecSchema.optional()
11603
11715
  }).superRefine((composition, ctx) => {
11604
11716
  const seen = /* @__PURE__ */ new Set();
11605
11717
  composition.features.forEach((feature, index) => {
@@ -18007,7 +18119,11 @@ var CompositionProblemSchema = object({
18007
18119
  "item-field-reserved",
18008
18120
  "target-missing",
18009
18121
  "target-unreadable",
18010
- "not-replaceable"
18122
+ "not-replaceable",
18123
+ "native-capability-replace",
18124
+ "mixed-quantity",
18125
+ "helper-mismatch",
18126
+ "member-constraint"
18011
18127
  ]),
18012
18128
  path: string(),
18013
18129
  message: string()
@@ -18028,7 +18144,8 @@ var CompositionUnavailableModeSchema = _enum([
18028
18144
  "null",
18029
18145
  "offline",
18030
18146
  "unknown",
18031
- "release"
18147
+ "release",
18148
+ "omit"
18032
18149
  ]);
18033
18150
  /**
18034
18151
  * `derived` reads a source · `clock` reads only `now`, recomputed when a sibling
@@ -18065,9 +18182,11 @@ var CompositionFieldPlanSchema = object({
18065
18182
  reads: array(CompositionFieldReadSchema)
18066
18183
  });
18067
18184
  /**
18068
- * What a feature does to its target (D663): `new` builds a capability on a new
18069
- * device; on an existing device it `add`s a capability the device lacks, or
18070
- * `replace`s named fields of one it has natively.
18185
+ * What a feature does to its target (D663, D944): `new` builds a capability on a
18186
+ * new device; on an existing device it `add`s a capability the device lacks.
18187
+ * Replacing a capability the device already serves is refused
18188
+ * (`native-capability-replace`), not planned. `replace` remains on the claim
18189
+ * wire for a claim the hub already holds.
18071
18190
  */
18072
18191
  var CompositionFeatureModeSchema = _enum([
18073
18192
  "new",
@@ -18240,6 +18359,275 @@ Object.freeze({
18240
18359
  result: ["number", "null"]
18241
18360
  }
18242
18361
  });
18362
+ /**
18363
+ * One catalog row per base reading a group helper can build (D944 §3).
18364
+ * Data, not a form default written into the block.
18365
+ */
18366
+ var NOW = {
18367
+ fieldPath: "lastFetchedAt",
18368
+ expr: "now"
18369
+ };
18370
+ var CHANGED = {
18371
+ fieldPath: "lastChangedAt",
18372
+ expr: "now"
18373
+ };
18374
+ function numeric(input) {
18375
+ return {
18376
+ ...input,
18377
+ family: "numeric",
18378
+ deviceType: DeviceType.Sensor,
18379
+ memberDeviceType: DeviceType.Sensor,
18380
+ commandCaps: [],
18381
+ baseUnit: baseUnitOf(input.quantity),
18382
+ aggregates: NUMERIC_AGGREGATES,
18383
+ accept: [{
18384
+ cap: input.outputCap,
18385
+ fieldPath: input.outputField
18386
+ }]
18387
+ };
18388
+ }
18389
+ function binary(input) {
18390
+ return {
18391
+ ...input,
18392
+ family: "binary",
18393
+ deviceType: DeviceType.Sensor,
18394
+ memberDeviceType: DeviceType.Sensor,
18395
+ commandCaps: [],
18396
+ quantity: "none",
18397
+ baseUnit: void 0,
18398
+ aggregates: BINARY_AGGREGATES,
18399
+ empty: "offline"
18400
+ };
18401
+ }
18402
+ var GROUP_TEMPLATES = [
18403
+ numeric({
18404
+ id: "temperature",
18405
+ summary: "Mean, median, min, max or sum of temperatures. Offline and unknown members are left out, never read as 0 °C.",
18406
+ role: DeviceRole.TemperatureSensor,
18407
+ outputCap: "temperature-sensor",
18408
+ outputField: "celsius",
18409
+ quantity: "temperature",
18410
+ defaultAggregate: "mean",
18411
+ empty: "null",
18412
+ companions: [NOW]
18413
+ }),
18414
+ numeric({
18415
+ id: "humidity",
18416
+ summary: "Humidity in percent. Offline and unknown members are left out, never read as 0 %.",
18417
+ role: DeviceRole.HumiditySensor,
18418
+ outputCap: "humidity-sensor",
18419
+ outputField: "percent",
18420
+ quantity: "humidity",
18421
+ defaultAggregate: "mean",
18422
+ empty: "null",
18423
+ companions: [NOW]
18424
+ }),
18425
+ numeric({
18426
+ id: "pressure",
18427
+ summary: "Pressure in hectopascals. Offline and unknown members are left out, never read as 0 hPa.",
18428
+ role: DeviceRole.PressureSensor,
18429
+ outputCap: "pressure-sensor",
18430
+ outputField: "hpa",
18431
+ quantity: "pressure",
18432
+ defaultAggregate: "mean",
18433
+ empty: "null",
18434
+ companions: [NOW]
18435
+ }),
18436
+ numeric({
18437
+ id: "illuminance",
18438
+ summary: "Illuminance in lux. Offline and unknown members are left out, never read as 0 lx.",
18439
+ role: DeviceRole.AmbientLightSensor,
18440
+ outputCap: "ambient-light-sensor",
18441
+ outputField: "lux",
18442
+ quantity: "illuminance",
18443
+ defaultAggregate: "mean",
18444
+ empty: "null",
18445
+ companions: [NOW]
18446
+ }),
18447
+ numeric({
18448
+ id: "power",
18449
+ summary: "Power in watts, summed by default. Nobody reporting omits the key rather than writing 0 W.",
18450
+ role: DeviceRole.PowerSensor,
18451
+ outputCap: "power-meter",
18452
+ outputField: "watts",
18453
+ quantity: "power",
18454
+ defaultAggregate: "sum",
18455
+ empty: "omit",
18456
+ companions: [NOW]
18457
+ }),
18458
+ numeric({
18459
+ id: "energy",
18460
+ summary: "Energy in kilowatt-hours, summed by default. Nobody reporting omits the key rather than writing 0 kWh.",
18461
+ role: DeviceRole.EnergySensor,
18462
+ outputCap: "power-meter",
18463
+ outputField: "kwhTotal",
18464
+ quantity: "energy",
18465
+ defaultAggregate: "sum",
18466
+ empty: "omit",
18467
+ companions: [NOW]
18468
+ }),
18469
+ numeric({
18470
+ id: "battery",
18471
+ summary: "Battery charge in percent. Offline and unknown members are left out, never read as 0 %.",
18472
+ role: DeviceRole.BatterySensor,
18473
+ outputCap: "battery",
18474
+ outputField: "percentage",
18475
+ quantity: "percentage",
18476
+ defaultAggregate: "mean",
18477
+ empty: "null",
18478
+ companions: [
18479
+ {
18480
+ fieldPath: "charging",
18481
+ expr: "\"unknown\""
18482
+ },
18483
+ {
18484
+ fieldPath: "sleeping",
18485
+ expr: "false"
18486
+ },
18487
+ {
18488
+ fieldPath: "lastUpdated",
18489
+ expr: "now"
18490
+ }
18491
+ ]
18492
+ }),
18493
+ numeric({
18494
+ id: "numeric",
18495
+ summary: "A numeric reading in the members’ shared quantity. Mixed quantities are refused. Nobody reporting publishes null, not 0.",
18496
+ role: DeviceRole.NumericSensor,
18497
+ outputCap: "numeric-sensor",
18498
+ outputField: "value",
18499
+ quantity: "device",
18500
+ defaultAggregate: "mean",
18501
+ empty: "null",
18502
+ companions: [NOW]
18503
+ }),
18504
+ binary({
18505
+ id: "motion",
18506
+ summary: "Any or all motion. Offline and unknown members are left out, never read as off. Nobody reporting takes the device offline.",
18507
+ role: DeviceRole.MotionSensor,
18508
+ outputCap: "motion",
18509
+ outputField: "detected",
18510
+ defaultAggregate: "any",
18511
+ accept: [{
18512
+ cap: "motion",
18513
+ fieldPath: "detected"
18514
+ }],
18515
+ companions: [{
18516
+ fieldPath: "lastDetectedAt",
18517
+ expr: "null"
18518
+ }, {
18519
+ fieldPath: "autoClearAfterMs",
18520
+ expr: "null"
18521
+ }]
18522
+ }),
18523
+ binary({
18524
+ id: "contact",
18525
+ summary: "Any or all open contacts. Offline and unknown members are left out, never read as closed.",
18526
+ role: DeviceRole.ContactSensor,
18527
+ outputCap: "contact",
18528
+ outputField: "entryOpen",
18529
+ defaultAggregate: "any",
18530
+ accept: [{
18531
+ cap: "contact",
18532
+ fieldPath: "entryOpen"
18533
+ }],
18534
+ companions: [CHANGED]
18535
+ }),
18536
+ binary({
18537
+ id: "leak",
18538
+ summary: "Any or all leak detections. Offline and unknown members are left out, never read as dry.",
18539
+ role: DeviceRole.LeakSensor,
18540
+ outputCap: "flood",
18541
+ outputField: "flooded",
18542
+ defaultAggregate: "any",
18543
+ accept: [{
18544
+ cap: "flood",
18545
+ fieldPath: "flooded"
18546
+ }],
18547
+ companions: [CHANGED]
18548
+ }),
18549
+ binary({
18550
+ id: "smoke",
18551
+ summary: "Any or all smoke detections. Offline and unknown members are left out, never read as clear.",
18552
+ role: DeviceRole.SmokeSensor,
18553
+ outputCap: "smoke",
18554
+ outputField: "detected",
18555
+ defaultAggregate: "any",
18556
+ accept: [{
18557
+ cap: "smoke",
18558
+ fieldPath: "detected"
18559
+ }],
18560
+ companions: [CHANGED]
18561
+ }),
18562
+ binary({
18563
+ id: "occupancy",
18564
+ summary: "Any or all of motion or binary sensors, published as a binary. Presence zones are not aggregated. Nobody reporting is offline, not off.",
18565
+ role: DeviceRole.BinarySensor,
18566
+ outputCap: "binary",
18567
+ outputField: "on",
18568
+ defaultAggregate: "any",
18569
+ accept: [{
18570
+ cap: "motion",
18571
+ fieldPath: "detected"
18572
+ }, {
18573
+ cap: "binary",
18574
+ fieldPath: "on"
18575
+ }],
18576
+ companions: [CHANGED]
18577
+ }),
18578
+ binary({
18579
+ id: "binary",
18580
+ summary: "Any or all generic binary sensors. Offline and unknown members are left out, never read as off.",
18581
+ role: DeviceRole.BinarySensor,
18582
+ outputCap: "binary",
18583
+ outputField: "on",
18584
+ defaultAggregate: "any",
18585
+ accept: [{
18586
+ cap: "binary",
18587
+ fieldPath: "on"
18588
+ }],
18589
+ companions: [CHANGED]
18590
+ }),
18591
+ actuator({
18592
+ id: "switch",
18593
+ summary: "On when at least one switch is on, or when all of them are. Offline and unknown members are left out of that decision, never read as off, and still receive the command.",
18594
+ deviceType: DeviceType.Switch,
18595
+ outputCap: "switch",
18596
+ commandCaps: ["switch"]
18597
+ }),
18598
+ actuator({
18599
+ id: "light",
18600
+ summary: "On when at least one light is on, or when all of them are. Brightness and colour are offered only when every member has them. A command is not sent to a member that lacks it.",
18601
+ deviceType: DeviceType.Light,
18602
+ outputCap: "switch",
18603
+ commandCaps: [
18604
+ "switch",
18605
+ "brightness",
18606
+ "color"
18607
+ ]
18608
+ })
18609
+ ];
18610
+ function actuator(input) {
18611
+ return {
18612
+ ...input,
18613
+ family: "actuator",
18614
+ role: void 0,
18615
+ memberDeviceType: input.deviceType,
18616
+ outputField: "on",
18617
+ quantity: "none",
18618
+ baseUnit: void 0,
18619
+ aggregates: BINARY_AGGREGATES,
18620
+ defaultAggregate: "any",
18621
+ empty: "offline",
18622
+ accept: [{
18623
+ cap: "switch",
18624
+ fieldPath: "on"
18625
+ }],
18626
+ companions: [CHANGED]
18627
+ };
18628
+ }
18629
+ new Map(GROUP_TEMPLATES.map((template) => [template.id, template]));
18630
+ DeviceFeature.LightColorRgb, DeviceFeature.LightColorHsv, DeviceFeature.LightColorMired;
18243
18631
  `${COMPOSED_DEVICE_STABLE_ID_PREFIX}`;
18244
18632
  /**
18245
18633
  * What a composition may BUILD on a device type (G2, D676): the caps a new
@@ -19953,12 +20341,12 @@ method(object({ deviceId: number().int().nonnegative() }), DeviceAdminLinkSchema
19953
20341
  * providers detect renames by matching `uniqueId` and patch `id`
19954
20342
  * in-place so dispatch keeps working.
19955
20343
  *
19956
- * **Rendering metadata is NOT stored here.** Display fields (`unit`,
19957
- * `precision`) live in the cap STATUS SLICE so they flow live with every
19958
- * state push and are the single source of truth. The `device_class` tag is
19959
- * an HA-specific input that is consumed at the discovery boundary
19960
- * (`ha-domain-mapping`) to derive the CamStack `DeviceRole`; it is never
19961
- * stored after that point.
20344
+ * **Display unit and precision are NOT stored here.** They are a read-time
20345
+ * preference (D944). A polymorphic reading stores its `quantity` here once,
20346
+ * at adopt, and a date/time value stores `dateTimeShape` the same way —
20347
+ * neither is repeated on each sample. The `device_class` tag is an
20348
+ * HA-specific input consumed at the discovery boundary (`ha-domain-mapping`)
20349
+ * to derive the CamStack `DeviceRole`; it is never stored after that point.
19962
20350
  *
19963
20351
  * The `raw` escape hatch carries provider-specific attributes that don't
19964
20352
  * fit the structured slots (HA `attributes` whitelist, Reolink `deviceCache`
@@ -19972,6 +20360,14 @@ var SourceInfoSchema = object({
19972
20360
  /** Immutable upstream identifier when available (HA `unique_id`, … ).
19973
20361
  * Used to detect rename when `id` changes. */
19974
20362
  uniqueId: string().optional(),
20363
+ /** Quantity of a polymorphic reading, written once at adopt (D944). */
20364
+ quantity: ReadingQuantitySchema.optional(),
20365
+ /** Date / time / datetime shape of a string reading, written once at adopt. */
20366
+ dateTimeShape: _enum([
20367
+ "date",
20368
+ "time",
20369
+ "datetime"
20370
+ ]).optional(),
19975
20371
  /** Provider-specific extras that don't fit the structured slots.
19976
20372
  * Whitelist what goes here per provider — do NOT dump entire HA
19977
20373
  * attribute blobs (would explode the meta JSON column). */
@@ -40909,7 +41305,8 @@ method(object({
40909
41305
  "enum"
40910
41306
  ]),
40911
41307
  enumValues: array(string()).optional(),
40912
- item: boolean().optional()
41308
+ item: boolean().optional(),
41309
+ quantity: ReadingQuantitySchema.optional()
40913
41310
  })).readonly(),
40914
41311
  itemArray: object({
40915
41312
  path: string(),
@@ -44709,8 +45106,8 @@ var MaskPolygonShapeSchema = object({
44709
45106
  /** Boolean cell grid — row-major, length === gridWidth*gridHeight. */
44710
45107
  var MaskGridShapeSchema = object({
44711
45108
  kind: literal("grid"),
44712
- gridWidth: number(),
44713
- gridHeight: number(),
45109
+ gridWidth: number().meta(readingMeta("none")),
45110
+ gridHeight: number().meta(readingMeta("none")),
44714
45111
  cells: array(boolean())
44715
45112
  });
44716
45113
  discriminatedUnion("kind", [
@@ -44822,6 +45219,8 @@ var NcSystemEventKindSchema = _enum([
44822
45219
  "detection-blind",
44823
45220
  "motion-noisy",
44824
45221
  "motion-calm",
45222
+ "package-llm-silent",
45223
+ "package-llm-answered",
44825
45224
  "recording-stalled",
44826
45225
  "recording-healthy",
44827
45226
  "recording-degraded",
@@ -55852,6 +56251,28 @@ var PackageVersionInfoSchema = object({
55852
56251
  deprecated: string().optional(),
55853
56252
  distTags: array(string()).readonly()
55854
56253
  });
56254
+ /**
56255
+ * One published document. `ok` is markdown from the registry. `missing` means
56256
+ * the registry answered and the file was not there. `error` is a registry or
56257
+ * tarball failure — never an empty string standing in for either.
56258
+ */
56259
+ var PackageDocBodySchema = discriminatedUnion("status", [
56260
+ object({
56261
+ status: literal("ok"),
56262
+ markdown: string()
56263
+ }),
56264
+ object({ status: literal("missing") }),
56265
+ object({
56266
+ status: literal("error"),
56267
+ message: string()
56268
+ })
56269
+ ]);
56270
+ var PackageDocsSchema = object({
56271
+ name: string(),
56272
+ version: string(),
56273
+ readme: PackageDocBodySchema,
56274
+ changelog: PackageDocBodySchema
56275
+ });
55855
56276
  var SearchResultSchema = object({
55856
56277
  name: string(),
55857
56278
  version: string(),
@@ -56070,7 +56491,10 @@ method(object({ nodeId: string().optional() }).optional(), array(AddonListItemSc
56070
56491
  }), object({ success: literal(true) }), {
56071
56492
  kind: "mutation",
56072
56493
  auth: "admin"
56073
- }), method(object({ name: string() }), array(PackageVersionInfoSchema).readonly()), method(object({ addonId: string() }), RestartAddonResultSchema, {
56494
+ }), method(object({ name: string() }), array(PackageVersionInfoSchema).readonly()), method(object({
56495
+ name: string().min(1),
56496
+ version: string().min(1).optional()
56497
+ }), PackageDocsSchema, { auth: "admin" }), method(object({ addonId: string() }), RestartAddonResultSchema, {
56074
56498
  kind: "mutation",
56075
56499
  auth: "admin"
56076
56500
  }), method(object({ packageName: string() }), object({ success: literal(true) }), {
@@ -56120,46 +56544,27 @@ method(object({ nodeId: string().optional() }).optional(), array(AddonListItemSc
56120
56544
  }), LogStreamEntrySchema, { kind: "subscription" });
56121
56545
  object({
56122
56546
  /** Carbon dioxide concentration in ppm. */
56123
- co2Ppm: number().min(0).optional(),
56547
+ co2Ppm: number().min(0).optional().meta(readingMeta("concentration-volume")),
56124
56548
  /** Total volatile organic compounds in ppb. */
56125
- vocPpb: number().min(0).optional(),
56549
+ vocPpb: number().min(0).optional().meta(readingMeta("concentration-ppb")),
56126
56550
  /** Particulate matter ≤ 2.5 μm in µg/m³. */
56127
- pm25: number().min(0).optional(),
56551
+ pm25: number().min(0).optional().meta(readingMeta("concentration-mass")),
56128
56552
  /** Particulate matter ≤ 10 μm in µg/m³. */
56129
- pm10: number().min(0).optional(),
56553
+ pm10: number().min(0).optional().meta(readingMeta("concentration-mass")),
56130
56554
  /** Composite AQI value (typically 0..500). */
56131
- aqi: number().optional(),
56555
+ aqi: number().optional().meta(readingMeta("index")),
56132
56556
  /** Ms epoch when the slice was last updated. */
56133
- lastFetchedAt: number(),
56134
- /** Live display unit of the single metric this slice carries (e.g. HA
56135
- * `attributes.unit_of_measurement` → 'ppm' / 'ppb' / 'µg/m³'). Each
56136
- * upstream `sensor.*` entity surfaces ONE device_class, so one unit
56137
- * per slice is unambiguous. */
56138
- unit: string().optional(),
56139
- /** Suggested decimal places for numeric display.
56140
- * Populated live from the upstream source when provided (e.g. HA
56141
- * `attributes.suggested_display_precision`). Falls back to
56142
- * auto-formatting when absent. */
56143
- precision: number().int().min(0).max(10).optional()
56557
+ lastFetchedAt: number()
56144
56558
  });
56145
56559
  DeviceType.Sensor;
56146
56560
  object({
56147
- /** Current illuminance in lux (lx). */
56148
- lux: number().min(0).meta({
56149
- unit: "lx",
56561
+ /** Current illuminance in lux (lx). `null` when the sample was refused (D393). */
56562
+ lux: number().min(0).nullable().meta(readingMeta("illuminance", {
56563
+ precision: 0,
56150
56564
  label: "Illuminance"
56151
- }),
56565
+ })),
56152
56566
  /** Ms epoch when the slice was last updated. */
56153
- lastFetchedAt: number(),
56154
- /** Live display unit from the upstream source (e.g. HA
56155
- * `attributes.unit_of_measurement`). The UI prefers this over the
56156
- * role's canonical unit. Absent → fall back to the canonical unit. */
56157
- unit: string().optional(),
56158
- /** Suggested decimal places for numeric display.
56159
- * Populated live from the upstream source when provided (e.g. HA
56160
- * `attributes.suggested_display_precision`). Falls back to
56161
- * auto-formatting when absent. */
56162
- precision: number().int().min(0).max(10).optional()
56567
+ lastFetchedAt: number()
56163
56568
  });
56164
56569
  DeviceType.Sensor;
56165
56570
  /**
@@ -56304,10 +56709,7 @@ var BatteryStatusSchema = object({
56304
56709
  * Consumers must SKIP a null rather than coerce it — `battery-band` already
56305
56710
  * declines to band a non-finite reading, which is the correct shape.
56306
56711
  */
56307
- percentage: number().min(0).max(100).nullable().meta({
56308
- unit: "%",
56309
- label: "Charge"
56310
- }),
56712
+ percentage: number().min(0).max(100).nullable().meta(readingMeta("percentage", { label: "Charge" })),
56311
56713
  /**
56312
56714
  * Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
56313
56715
  * Reolink-specific for the Solar Panel 2 accessory (will become
@@ -56334,7 +56736,14 @@ var BatteryStatusSchema = object({
56334
56736
  */
56335
56737
  sleeping: boolean().meta({ label: "Sleeping" }),
56336
56738
  /** Ms epoch of the last observation. Lets consumers reason about freshness. */
56337
- lastUpdated: number(),
56739
+ lastUpdated: number().meta(readingMeta("none")),
56740
+ /**
56741
+ * Battery voltage in volts, for a cell the firmware reports as voltage
56742
+ * rather than a percentage (Ecowitt capacitor packs). Absent on cameras
56743
+ * that only report charge. A second reading on this cap, not a second
56744
+ * `numeric-sensor` on the same device.
56745
+ */
56746
+ volts: number().nullable().optional().meta(readingMeta("voltage", { label: "Voltage" })),
56338
56747
  /**
56339
56748
  * Ms epoch of the last time the device PROVED it was reachable — a
56340
56749
  * completed firmware round-trip, an observed wake, or an inbound push
@@ -56406,7 +56815,7 @@ DeviceType.Sensor;
56406
56815
  */
56407
56816
  var BrightnessStatusSchema = object({
56408
56817
  /** Current level as 0..100 inclusive. Firmware-reported. */
56409
- percentage: number().min(0).max(100),
56818
+ percentage: number().min(0).max(100).meta(readingMeta("percentage")),
56410
56819
  /** Ms epoch of the last operator-driven change. Useful for UI freshness. */
56411
56820
  lastChangedAt: number()
56412
56821
  });
@@ -56791,21 +57200,21 @@ var ClimateControlStatusSchema = object({
56791
57200
  /** Single setpoint in Celsius. Used by single-target modes
56792
57201
  * (heat / cool / dry). Null when the device is in a range mode
56793
57202
  * (`heat_cool`) or has no setpoint at all (`fan_only`/`off`). */
56794
- target: number().nullable(),
57203
+ target: number().nullable().meta(readingMeta("temperature")),
56795
57204
  /** Upper bound of the dual setpoint in Celsius. Populated only
56796
57205
  * in `heat_cool` mode. */
56797
- targetHigh: number().nullable(),
57206
+ targetHigh: number().nullable().meta(readingMeta("temperature")),
56798
57207
  /** Lower bound of the dual setpoint in Celsius. Populated only
56799
57208
  * in `heat_cool` mode. */
56800
- targetLow: number().nullable(),
57209
+ targetLow: number().nullable().meta(readingMeta("temperature")),
56801
57210
  /** Target relative humidity (0..100). Null when the device has no
56802
57211
  * humidity control. */
56803
- targetHumidity: number().min(0).max(100).nullable(),
57212
+ targetHumidity: number().min(0).max(100).nullable().meta(readingMeta("humidity")),
56804
57213
  /** Current measured temperature in Celsius. Read-only — pushed by
56805
57214
  * the device's internal sensor. */
56806
- currentTemp: number().nullable(),
57215
+ currentTemp: number().nullable().meta(readingMeta("temperature")),
56807
57216
  /** Current measured relative humidity (0..100). Read-only. */
56808
- currentHumidity: number().min(0).max(100).nullable(),
57217
+ currentHumidity: number().min(0).max(100).nullable().meta(readingMeta("humidity")),
56809
57218
  /** Vertical louver swing on/off. Null when the device has no vertical
56810
57219
  * swing surface (gate with `DeviceFeature.ClimateSwingVertical`). */
56811
57220
  swingVertical: boolean().nullable(),
@@ -56813,11 +57222,11 @@ var ClimateControlStatusSchema = object({
56813
57222
  * horizontal swing surface (gate with `DeviceFeature.ClimateSwingHorizontal`). */
56814
57223
  swingHorizontal: boolean().nullable(),
56815
57224
  /** Lowest setpoint the device accepts, Celsius. Absent / null = not reported. */
56816
- minTemp: number().nullable().optional(),
57225
+ minTemp: number().nullable().optional().meta(readingMeta("temperature")),
56817
57226
  /** Highest setpoint the device accepts, Celsius. Absent / null = not reported. */
56818
- maxTemp: number().nullable().optional(),
57227
+ maxTemp: number().nullable().optional().meta(readingMeta("temperature")),
56819
57228
  /** Setpoint granularity, Celsius (0.5, 1). Absent / null = not reported. */
56820
- tempStep: number().positive().nullable().optional(),
57229
+ tempStep: number().positive().nullable().optional().meta(readingMeta("temperature")),
56821
57230
  /** Ms epoch when the slice was last updated (push or command). */
56822
57231
  lastFetchedAt: number()
56823
57232
  });
@@ -56896,17 +57305,17 @@ DeviceType.Thermostat, DeviceType.Climate, method(object({
56896
57305
  * modes to expose in the picker without a slice fetch.
56897
57306
  */
56898
57307
  var RgbTripletSchema = object({
56899
- r: number().int().min(0).max(255),
56900
- g: number().int().min(0).max(255),
56901
- b: number().int().min(0).max(255)
57308
+ r: number().int().min(0).max(255).meta(readingMeta("none")),
57309
+ g: number().int().min(0).max(255).meta(readingMeta("none")),
57310
+ b: number().int().min(0).max(255).meta(readingMeta("none"))
56902
57311
  });
56903
57312
  var HsvTripletSchema = object({
56904
57313
  /** Hue in degrees, 0..360. */
56905
- h: number().min(0).max(360),
57314
+ h: number().min(0).max(360).meta(readingMeta("none")),
56906
57315
  /** Saturation as 0..100 inclusive. */
56907
- s: number().min(0).max(100),
57316
+ s: number().min(0).max(100).meta(readingMeta("none")),
56908
57317
  /** Value/brightness as 0..100 inclusive. */
56909
- v: number().min(0).max(100)
57318
+ v: number().min(0).max(100).meta(readingMeta("none"))
56910
57319
  });
56911
57320
  var ColorInputSchema = discriminatedUnion("mode", [
56912
57321
  object({
@@ -56935,7 +57344,7 @@ object({
56935
57344
  /** Populated when `mode === 'hsv'`. */
56936
57345
  hsv: HsvTripletSchema.optional(),
56937
57346
  /** Populated when `mode === 'mired'`. */
56938
- mireds: number().int().optional(),
57347
+ mireds: number().int().optional().meta(readingMeta("colour-temperature")),
56939
57348
  /** Ms epoch of the last operator-driven change. */
56940
57349
  lastChangedAt: number()
56941
57350
  });
@@ -57059,18 +57468,12 @@ _enum([
57059
57468
  "empty",
57060
57469
  "full"
57061
57470
  ]);
57062
- /** Units a remaining-life counter is reported in. Closed: the panel renders
57063
- * each. */
57064
- var ConsumableRemainingUnitSchema = _enum([
57065
- "days",
57066
- "hours",
57067
- "cycles"
57068
- ]);
57069
- /** Remaining life as a COUNT, not a percentage (the PetKit desiccant reports
57070
- * days). `value` null = unknown (D393). */
57471
+ /** Whether `remaining.value` is a duration in seconds or a dimensionless count. */
57472
+ var ConsumableRemainingKindSchema = _enum(["duration", "count"]);
57473
+ /** Remaining life. `value` null = unknown (D393). Duration is seconds. */
57071
57474
  var ConsumableRemainingSchema = object({
57072
- value: number().min(0).nullable(),
57073
- unit: ConsumableRemainingUnitSchema
57475
+ value: number().min(0).nullable().meta(readingMeta("device")),
57476
+ kind: ConsumableRemainingKindSchema
57074
57477
  });
57075
57478
  var ConsumablesStatusSchema = object({
57076
57479
  items: array(object({
@@ -57079,7 +57482,7 @@ var ConsumablesStatusSchema = object({
57079
57482
  /** Display name. */
57080
57483
  label: string().min(1),
57081
57484
  /** Remaining life % (`wear`) or fill % (`supply`, `waste`) when known (0..100). */
57082
- level: number().min(0).max(100).nullable(),
57485
+ level: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
57083
57486
  /** The provider's discrete verdict when known (binary mode). */
57084
57487
  status: ConsumableStatusSchema.nullable(),
57085
57488
  /** What the item is — decides whether low or full is bad. Absent = `wear`. */
@@ -57096,7 +57499,7 @@ var ConsumablesStatusSchema = object({
57096
57499
  })),
57097
57500
  lastChangedAt: number()
57098
57501
  });
57099
- Object.values(DeviceType), [...ConsumableRemainingUnitSchema.options], [...ConsumableStatusSchema.options], [...ConsumableKindSchema.options], [...ConsumableFormSchema.options];
57502
+ Object.values(DeviceType), [...ConsumableRemainingKindSchema.options], [...ConsumableStatusSchema.options], [...ConsumableKindSchema.options], [...ConsumableFormSchema.options];
57100
57503
  Object.values(DeviceType), method(object({
57101
57504
  deviceId: number().int().nonnegative(),
57102
57505
  key: string().min(1)
@@ -57133,39 +57536,17 @@ object({
57133
57536
  /** Current value. Numeric kind → number; select/text/datetime → string.
57134
57537
  * Datetime values are ISO 8601 strings (full timestamp, date-only,
57135
57538
  * or time-only — HA accepts all three forms). */
57136
- value: union([number(), string()]),
57539
+ value: union([number().meta(readingMeta("device")), string()]),
57137
57540
  /** Acceptable values when `kind === 'select'`. Empty for other kinds. */
57138
57541
  options: array(string()),
57139
57542
  /** Ms epoch when the slice was last updated. */
57140
57543
  lastChangedAt: number(),
57141
- /** Display unit-of-measurement (e.g. '°C', '%', 'lx').
57142
- * Populated live from HA `attributes.unit_of_measurement` on each push.
57143
- * Meaningful for `kind === 'numeric'`; absent for other kinds. */
57144
- unit: string().optional(),
57145
- /** Minimum allowed value. Populated live from HA `attributes.min`.
57146
- * Meaningful for `kind === 'numeric'`; absent for other kinds. */
57147
- min: number().optional(),
57148
- /** Maximum allowed value. Populated live from HA `attributes.max`.
57149
- * Meaningful for `kind === 'numeric'`; absent for other kinds. */
57150
- max: number().optional(),
57151
- /** Step increment. Populated live from HA `attributes.step`.
57152
- * Meaningful for `kind === 'numeric'`; absent for other kinds. */
57153
- step: number().optional(),
57154
- /** Suggested decimal places for numeric display. Populated live from HA
57155
- * `attributes.suggested_display_precision`, or derived from `step` when the
57156
- * HA attribute is absent. Meaningful for `kind === 'numeric'`; absent for
57157
- * other kinds. Falls back to auto-formatting when absent. */
57158
- precision: number().int().min(0).max(10).optional(),
57159
- /** Date-picker granularity for `kind === 'datetime'`. 'date' → date-only,
57160
- * 'time' → time-only, 'datetime' → full timestamp. Absent for other kinds
57161
- * (UI defaults to 'datetime'). Derived live from the device's HA domain
57162
- * (date.* / time.* / datetime.*) or, for input_datetime, from the entity's
57163
- * `has_date`/`has_time` attributes on each push. */
57164
- format: _enum([
57165
- "date",
57166
- "time",
57167
- "datetime"
57168
- ]).optional()
57544
+ /** Minimum allowed value, in the device quantity's base unit. */
57545
+ min: number().optional().meta(readingMeta("device")),
57546
+ /** Maximum allowed value, in the device quantity's base unit. */
57547
+ max: number().optional().meta(readingMeta("device")),
57548
+ /** Step increment, in the device quantity's base unit. */
57549
+ step: number().optional().meta(readingMeta("device"))
57169
57550
  });
57170
57551
  var ControlSetValueInputSchema = discriminatedUnion("kind", [
57171
57552
  object({
@@ -57203,9 +57584,9 @@ var CoverStatusSchema = object({
57203
57584
  ]),
57204
57585
  /** 0 = fully closed, 100 = fully open. Null when the device has
57205
57586
  * no intermediate position surface. */
57206
- position: number().min(0).max(100).nullable(),
57587
+ position: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
57207
57588
  /** 0 = closed slats, 100 = open slats. Null when no tilt support. */
57208
- tiltPosition: number().min(0).max(100).nullable(),
57589
+ tiltPosition: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
57209
57590
  /** Ms epoch when the slice was last updated. */
57210
57591
  lastChangedAt: number()
57211
57592
  });
@@ -57263,9 +57644,9 @@ var NormalizedRangeSchema$1 = object({
57263
57644
  object({
57264
57645
  mode: DayNightModeSchema,
57265
57646
  /** IR-cut trigger sensitivity, NORMALIZED 0–100 (higher = switches to night sooner). */
57266
- sensitivity: number().optional(),
57647
+ sensitivity: number().optional().meta(readingMeta("none")),
57267
57648
  /** Delay before the IR-cut filter flips, in seconds. */
57268
- switchDelaySec: number().optional(),
57649
+ switchDelaySec: number().optional().meta(readingMeta("duration")),
57269
57650
  lastFetchedAt: number()
57270
57651
  });
57271
57652
  /**
@@ -57420,11 +57801,11 @@ object({
57420
57801
  /** Feature keys of the programs the appliance currently offers — drives the UI selector. */
57421
57802
  availablePrograms: array(string()),
57422
57803
  /** Seconds remaining on the active cycle, or null when not running / not known. */
57423
- remainingSeconds: number().int().nonnegative().nullable(),
57804
+ remainingSeconds: number().int().nonnegative().nullable().meta(readingMeta("duration")),
57424
57805
  /** Seconds the delayed start is set to (time until the cycle starts), or null. */
57425
- delayedStartSeconds: number().int().nonnegative().nullable(),
57806
+ delayedStartSeconds: number().int().nonnegative().nullable().meta(readingMeta("duration")),
57426
57807
  /** Cycle completion 0..100, or null when not applicable. */
57427
- progressPercent: number().min(0).max(100).nullable(),
57808
+ progressPercent: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
57428
57809
  /** True when the door is reported open; null when the door state is not known. */
57429
57810
  doorOpen: boolean().nullable(),
57430
57811
  /** True when the door is latched (locked) during a cycle; null when not reported. */
@@ -57448,7 +57829,7 @@ object({
57448
57829
  /** True while the machine-care (descaling / cleaning-program) reminder is raised; false when clear; null when not reported. */
57449
57830
  machineCareDue: boolean().nullable(),
57450
57831
  /** Program runs left before the machine-care reminder is due; null when the appliance does not say. */
57451
- machineCareRemainingRuns: number().int().nonnegative().nullable(),
57832
+ machineCareRemainingRuns: number().int().nonnegative().nullable().meta(readingMeta("count")),
57452
57833
  /** Option states: null when the appliance does not expose the option or has not said. */
57453
57834
  halfLoad: boolean().nullable(),
57454
57835
  hygienePlus: boolean().nullable(),
@@ -57463,7 +57844,7 @@ object({
57463
57844
  /** Feature keys of the events currently raised (salt low, rinse aid low, program finished, …). */
57464
57845
  activeEvents: array(string()),
57465
57846
  /** Numeric error code when the appliance reports one; null otherwise. */
57466
- errorCode: number().nullable(),
57847
+ errorCode: number().nullable().meta(readingMeta("none")),
57467
57848
  /** Name of the raised alert-level event while the appliance is in error; null otherwise. */
57468
57849
  errorLabel: string().nullable(),
57469
57850
  /** Ms epoch of the last value received from the appliance; 0 = never. */
@@ -57609,24 +57990,14 @@ object({
57609
57990
  /** Ms epoch of the last press. null = never observed since this provider started. */
57610
57991
  lastPressedAt: number().nullable(),
57611
57992
  /** Counter since provider start. Resets on reboot. Useful for metrics/debug. */
57612
- pressCountSinceStart: number()
57993
+ pressCountSinceStart: number().meta(readingMeta("count"))
57613
57994
  });
57614
57995
  object({
57615
57996
  deviceId: number(),
57616
57997
  timestamp: number()
57617
57998
  });
57618
57999
  DeviceType.Button, DeviceType.Camera;
57619
- /**
57620
- * Enum-state sensor — a string value picked from a finite option set.
57621
- * Drives HA `sensor` entries with `state_class: enum` (HVAC action
57622
- * states, weather conditions, contact-source channels, mode strings).
57623
- * The option set is stable across observations; it is persisted in the
57624
- * device config blob (via the control slice at adoption) and is NOT
57625
- * stored in `sourceInfo`.
57626
- */
57627
- /** Locale-render shape for an ISO `value` carried by a `DateTimeSensor`-role
57628
- * enum sensor: `date` (date-only), `time` (time-only), `datetime` (both). */
57629
- var EnumSensorDateTimeFormatSchema = _enum([
58000
+ _enum([
57630
58001
  "date",
57631
58002
  "time",
57632
58003
  "datetime"
@@ -57634,12 +58005,11 @@ var EnumSensorDateTimeFormatSchema = _enum([
57634
58005
  object({
57635
58006
  value: string(),
57636
58007
  /**
57637
- * Set for `DateTimeSensor`-role sensors so the UI renders the ISO `value`
57638
- * as a locale date/time/datetime; absent for plain enum sensors. HA
57639
- * `device_class=timestamp` → `'datetime'`, `device_class=date` → `'date'`,
57640
- * a time-only sensor → `'time'`.
58008
+ * Set when `value` is a timestamp rather than an enum state, so history
58009
+ * does not learn ISO strings as states. The display shape (date / time /
58010
+ * datetime) lives on `SourceInfo.dateTimeShape`, written once at adopt.
57641
58011
  */
57642
- format: EnumSensorDateTimeFormatSchema.optional(),
58012
+ timestamp: boolean().optional(),
57643
58013
  /** Ms epoch when the slice was last updated. */
57644
58014
  lastFetchedAt: number()
57645
58015
  });
@@ -57658,13 +58028,13 @@ var EventFireSchema = object({
57658
58028
  deviceId: number(),
57659
58029
  eventType: string(),
57660
58030
  data: record(string(), unknown()).nullable(),
57661
- timestamp: number(),
57662
- seq: number()
58031
+ timestamp: number().meta(readingMeta("none")),
58032
+ seq: number().meta(readingMeta("count"))
57663
58033
  });
57664
58034
  object({
57665
58035
  eventTypes: array(string()),
57666
58036
  lastEvent: EventFireSchema.nullable(),
57667
- eventCountSinceStart: number()
58037
+ eventCountSinceStart: number().meta(readingMeta("count"))
57668
58038
  });
57669
58039
  DeviceType.EventEmitter;
57670
58040
  var IdentitySchema = object({
@@ -58053,10 +58423,10 @@ var FanDirectionSchema = _enum(["forward", "reverse"]);
58053
58423
  object({
58054
58424
  /** Active speed as 0..100 inclusive. Null when the device has no
58055
58425
  * speed surface (single-speed fan). */
58056
- percentage: number().min(0).max(100).nullable(),
58426
+ percentage: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
58057
58427
  /** Speed granularity the device accepts (HA `percentage_step`, e.g. 25 for
58058
58428
  * a 4-speed fan). Absent when unknown — the UI then falls back to step 1. */
58059
- percentageStep: number().positive().optional(),
58429
+ percentageStep: number().positive().optional().meta(readingMeta("percentage")),
58060
58430
  /** Active preset mode (`auto` / `quiet` / `turbo` / vendor-specific)
58061
58431
  * — empty string when no preset is active or supported. */
58062
58432
  preset: string(),
@@ -58138,7 +58508,7 @@ var FeatureProbeStatusSchema = object({
58138
58508
  /** Camera/firmware model string. `null` when the firmware doesn't expose it. */
58139
58509
  model: string().nullable(),
58140
58510
  /** Channel count for NVR/Hub devices; `1` for standalone cameras; `null` pre-probe. */
58141
- channelCount: number().nullable(),
58511
+ channelCount: number().nullable().meta(readingMeta("count")),
58142
58512
  /**
58143
58513
  * Ms epoch of the last SUCCESSFUL probe. `0` before the first probe
58144
58514
  * completes — drivers' `getAccessoryChildren()` should treat zero as
@@ -58170,9 +58540,39 @@ object({
58170
58540
  lastChangedAt: number()
58171
58541
  });
58172
58542
  DeviceType.Sensor;
58543
+ object({
58544
+ /** One row per member that has been commanded. A later command replaces that member's row. */
58545
+ results: array(object({
58546
+ deviceId: number().int().nonnegative(),
58547
+ cap: string().min(1),
58548
+ method: string().min(1),
58549
+ ok: boolean(),
58550
+ error: string().optional(),
58551
+ /** Ms epoch of the attempt. */
58552
+ at: number()
58553
+ })) });
58554
+ DeviceType.Switch, DeviceType.Light;
58555
+ object({
58556
+ /** Members whose current value entered the aggregate. */
58557
+ included: number().int().nonnegative().meta(readingMeta("count", {
58558
+ precision: 0,
58559
+ label: "Reporting"
58560
+ })),
58561
+ /** Members left out: offline, unknown, or not a finite reading (D393). */
58562
+ excluded: number().int().nonnegative().meta(readingMeta("count", {
58563
+ precision: 0,
58564
+ label: "Excluded"
58565
+ })),
58566
+ /** `included` + `excluded`. */
58567
+ total: number().int().nonnegative().meta(readingMeta("count", {
58568
+ precision: 0,
58569
+ label: "Members"
58570
+ }))
58571
+ });
58572
+ DeviceType.Sensor, DeviceType.Switch, DeviceType.Light;
58173
58573
  object({
58174
58574
  /** Radiator valve opening 0 (closed) .. 100 (open). Null = not yet known. */
58175
- position: number().min(0).max(100).nullable(),
58575
+ position: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
58176
58576
  /** Ms epoch when the slice was last updated (push or poll). */
58177
58577
  lastFetchedAt: number()
58178
58578
  });
@@ -58181,9 +58581,9 @@ object({
58181
58581
  /** Whether the humidifier is currently on. */
58182
58582
  on: boolean(),
58183
58583
  /** Current measured relative humidity (0..100). Null when not reported. */
58184
- currentHumidity: number().min(0).max(100).nullable(),
58584
+ currentHumidity: number().min(0).max(100).nullable().meta(readingMeta("humidity")),
58185
58585
  /** Target relative humidity (0..100). Null when no setpoint surface. */
58186
- targetHumidity: number().min(0).max(100).nullable(),
58586
+ targetHumidity: number().min(0).max(100).nullable().meta(readingMeta("humidity")),
58187
58587
  /** Active mode (`auto` / `normal` / `baby` / vendor). Null when the
58188
58588
  * device has no mode surface. */
58189
58589
  mode: string().nullable(),
@@ -58193,9 +58593,9 @@ object({
58193
58593
  * `idle` / `off`). Null when the device doesn't report it. */
58194
58594
  action: string().nullable(),
58195
58595
  /** HA `min_humidity` attribute. Null → UI uses 0. */
58196
- minHumidity: number().nullable(),
58596
+ minHumidity: number().nullable().meta(readingMeta("humidity")),
58197
58597
  /** HA `max_humidity` attribute. Null → UI uses 100. */
58198
- maxHumidity: number().nullable(),
58598
+ maxHumidity: number().nullable().meta(readingMeta("humidity")),
58199
58599
  /** Ms epoch when the slice was last updated. */
58200
58600
  lastChangedAt: number()
58201
58601
  });
@@ -58227,22 +58627,13 @@ DeviceType.Humidifier, method(object({
58227
58627
  * `sourceInfo`.
58228
58628
  */
58229
58629
  var HumiditySensorStatusSchema = object({
58230
- /** Current relative humidity, 0..100. */
58231
- percent: number().min(0).max(100).meta({
58232
- unit: "%",
58630
+ /** Current relative humidity, 0..100. `null` when the sample was refused (D393). */
58631
+ percent: number().min(0).max(100).nullable().meta(readingMeta("humidity", {
58632
+ precision: 0,
58233
58633
  label: "Humidity"
58234
- }),
58634
+ })),
58235
58635
  /** Ms epoch when the slice was last updated. */
58236
- lastFetchedAt: number(),
58237
- /** Live display unit from the upstream source (e.g. HA
58238
- * `attributes.unit_of_measurement`). The UI prefers this over the
58239
- * role's canonical unit. Absent → fall back to the canonical unit. */
58240
- unit: string().optional(),
58241
- /** Suggested decimal places for numeric display.
58242
- * Populated live from the upstream source when provided (e.g. HA
58243
- * `attributes.suggested_display_precision`). Falls back to
58244
- * auto-formatting when absent. */
58245
- precision: number().int().min(0).max(10).optional()
58636
+ lastFetchedAt: number()
58246
58637
  });
58247
58638
  DeviceType.Sensor, DeviceType.Thermostat;
58248
58639
  object({
@@ -58250,7 +58641,7 @@ object({
58250
58641
  * entity exposes no `entity_picture` (yet). */
58251
58642
  url: string().nullable(),
58252
58643
  /** Ms epoch of the upstream last-updated timestamp. Null at cold-start. */
58253
- lastUpdated: number().nullable()
58644
+ lastUpdated: number().nullable().meta(readingMeta("none"))
58254
58645
  });
58255
58646
  DeviceType.Image;
58256
58647
  /**
@@ -58306,19 +58697,19 @@ var NormalizedRangeSchema = object({
58306
58697
  });
58307
58698
  object({
58308
58699
  /** Normalized 0–100. */
58309
- brightness: number().optional(),
58700
+ brightness: number().optional().meta(readingMeta("none")),
58310
58701
  /** Normalized 0–100. */
58311
- contrast: number().optional(),
58702
+ contrast: number().optional().meta(readingMeta("none")),
58312
58703
  /** Normalized 0–100. */
58313
- saturation: number().optional(),
58704
+ saturation: number().optional().meta(readingMeta("none")),
58314
58705
  /** Normalized 0–100. */
58315
- sharpness: number().optional(),
58706
+ sharpness: number().optional().meta(readingMeta("none")),
58316
58707
  mirror: boolean().optional(),
58317
58708
  flip: boolean().optional(),
58318
58709
  rotate: ImageRotateSchema.optional(),
58319
58710
  whiteBalance: WhiteBalanceModeSchema.optional(),
58320
58711
  /** Manual white-balance warmth, NORMALIZED 0–100. Meaningful only when `whiteBalance === 'manual'`. */
58321
- warmth: number().optional(),
58712
+ warmth: number().optional().meta(readingMeta("none")),
58322
58713
  exposureMode: ExposureModeSchema.optional(),
58323
58714
  backlightMode: BacklightModeSchema.optional(),
58324
58715
  lastFetchedAt: number()
@@ -58563,10 +58954,10 @@ var IntercomAbilitySchema = object({
58563
58954
  /** Codecs accepted by firmware, in preference order. Driver-authored strings. */
58564
58955
  codecs: array(string()),
58565
58956
  /** Sample rate (Hz) the firmware expects. Reolink typical: 16000. */
58566
- sampleRate: number(),
58957
+ sampleRate: number().meta(readingMeta("none")),
58567
58958
  duplex: _enum(["half", "full"]),
58568
58959
  /** Max in-flight audio backlog before drop (ms). Server uses this to bound latency. */
58569
- maxBacklogMs: number()
58960
+ maxBacklogMs: number().meta(readingMeta("duration-ms"))
58570
58961
  });
58571
58962
  var IntercomStatusSchema = object({
58572
58963
  /** True while a talk session is open. */
@@ -58677,13 +59068,13 @@ object({
58677
59068
  activity: LawnMowerActivitySchema,
58678
59069
  /** 0..100 battery percentage. Null when the device has no battery
58679
59070
  * reading. */
58680
- batteryLevel: number().min(0).max(100).nullable(),
59071
+ batteryLevel: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
58681
59072
  /** 0..100 mowing-completion percentage of the current task, or null when no
58682
59073
  * task is active / progress is unavailable. */
58683
- progressPercent: number().min(0).max(100).nullable(),
59074
+ progressPercent: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
58684
59075
  /** Current device/event code (dynamic — mostly status, sometimes an error),
58685
59076
  * or null when unknown. */
58686
- currentCode: number().nullable(),
59077
+ currentCode: number().nullable().meta(readingMeta("none")),
58687
59078
  /** Human label for {@link currentCode}, or null when undecodable. */
58688
59079
  currentCodeLabel: string().nullable(),
58689
59080
  /** Severity of {@link currentCode}. `error` (and often `warning`) warrants UI
@@ -59145,7 +59536,7 @@ object({
59145
59536
  state: MediaPlayerStateSchema,
59146
59537
  /** Volume as 0..100 inclusive. Null when the device has no volume
59147
59538
  * surface. Pair with `DeviceFeature.MediaPlayerVolume`. */
59148
- volumeLevel: number().min(0).max(100).nullable(),
59539
+ volumeLevel: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
59149
59540
  /** Mute toggle distinct from volume=0. Null when no mute surface.
59150
59541
  * Pair with `DeviceFeature.MediaPlayerMute`. */
59151
59542
  isMuted: boolean().nullable(),
@@ -59158,10 +59549,10 @@ object({
59158
59549
  currentMedia: MediaInfoSchema.nullable(),
59159
59550
  /** Current playback position in ms. Null when not seekable or
59160
59551
  * nothing is playing. Pair with `DeviceFeature.MediaPlayerSeek`. */
59161
- positionMs: number().int().nonnegative().nullable(),
59552
+ positionMs: number().int().nonnegative().nullable().meta(readingMeta("duration-ms")),
59162
59553
  /** Total duration of the current media in ms. Null when unknown
59163
59554
  * (live stream) or nothing is playing. */
59164
- durationMs: number().int().nonnegative().nullable(),
59555
+ durationMs: number().int().nonnegative().nullable().meta(readingMeta("duration-ms")),
59165
59556
  /** Shuffle toggle. Null when no shuffle surface.
59166
59557
  * Pair with `DeviceFeature.MediaPlayerShuffle`. */
59167
59558
  shuffle: boolean().nullable(),
@@ -59461,7 +59852,7 @@ var MotionStatusSchema = object({
59461
59852
  * it, every provider seeded it at boot, and every session left it
59462
59853
  * `detected: true` after its detach.
59463
59854
  */
59464
- autoClearAfterMs: number().nullable()
59855
+ autoClearAfterMs: number().nullable().meta(readingMeta("duration-ms"))
59465
59856
  });
59466
59857
  /**
59467
59858
  * Payload of `motion.onMotionChanged` event + the corresponding bus
@@ -59511,7 +59902,7 @@ var MotionZoneRegionSchema = object({
59511
59902
  });
59512
59903
  object({
59513
59904
  enabled: boolean(),
59514
- sensitivity: number(),
59905
+ sensitivity: number().meta(readingMeta("none")),
59515
59906
  /** Grid region(s). Today exactly one `grid` shape. */
59516
59907
  regions: array(MotionZoneRegionSchema),
59517
59908
  lastFetchedAt: number()
@@ -59815,7 +60206,7 @@ var NavigationStatusSchema = object({
59815
60206
  following: boolean(),
59816
60207
  flash: boolean(),
59817
60208
  lightMode: NavigationLightModeSchema,
59818
- lightLevel: number().min(40).max(100),
60209
+ lightLevel: number().min(40).max(100).meta(readingMeta("none")),
59819
60210
  /** Ms epoch when the slice was last updated. */
59820
60211
  lastChangedAt: number()
59821
60212
  });
@@ -59861,13 +60252,13 @@ var NetworkLinkStatusSchema = object({
59861
60252
  * one whose reading has not landed must not be drawn at 0 %. Consumers
59862
60253
  * SKIP a null rather than coerce it.
59863
60254
  */
59864
- signalPercent: number().min(0).max(100).nullable(),
60255
+ signalPercent: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
59865
60256
  /** Raw received signal strength in dBm, when the firmware reports one. */
59866
- rssiDbm: number().optional(),
60257
+ rssiDbm: number().optional().meta(readingMeta("signal-level")),
59867
60258
  /** Network name of a wireless link, when the firmware reports it. */
59868
60259
  ssid: string().optional(),
59869
60260
  /** Ms epoch of the last observation. Lets consumers reason about freshness. */
59870
- lastUpdated: number()
60261
+ lastUpdated: number().meta(readingMeta("none"))
59871
60262
  });
59872
60263
  DeviceType.Camera, DeviceType.Sensor, DeviceType.Button, DeviceType.Switch, DeviceType.Light, DeviceType.Lock, DeviceType.Siren, object({
59873
60264
  deviceId: number(),
@@ -60186,7 +60577,7 @@ object({
60186
60577
  lastError: string().nullable(),
60187
60578
  /** Number of deliveries currently buffered server-side (rate-limited
60188
60579
  * notifiers may queue). 0 when the provider sends synchronously. */
60189
- queueDepth: number().int().nonnegative(),
60580
+ queueDepth: number().int().nonnegative().meta(readingMeta("count")),
60190
60581
  /** Per-feature capability matrix — authoritative source for the
60191
60582
  * compose-form field gating. */
60192
60583
  supports: NotifierSupportsSchema
@@ -60236,15 +60627,8 @@ DeviceType.Notifier, method(NotifierSendInputSchema, NotifierSendResultSchema, {
60236
60627
  acceptedAt: number()
60237
60628
  });
60238
60629
  object({
60239
- value: number(),
60240
- /** Display unit-of-measurement (e.g. 'dBm', 's', 'rpm', 'steps').
60241
- * Populated live from the upstream source on each state push.
60242
- * Absent for unitless sensors. */
60243
- unit: string().optional(),
60244
- /** Suggested decimal places for numeric display.
60245
- * Populated live from the upstream source when provided.
60246
- * Falls back to auto-formatting when absent. */
60247
- precision: number().int().min(0).max(10).optional(),
60630
+ /** Reading in the device quantity's base unit. `null` when refused (D393). */
60631
+ value: number().nullable().meta(readingMeta("device")),
60248
60632
  /** Ms epoch when the slice was last updated. */
60249
60633
  lastFetchedAt: number()
60250
60634
  });
@@ -60534,23 +60918,26 @@ object({
60534
60918
  /** Food currently in the bowl (grams). Null when the device has not
60535
60919
  * reported a reading yet. On dual-hopper models this is the combined
60536
60920
  * bowl reading; per-hopper levels live in `food1`/`food2`. */
60537
- foodLevel: number().nullable(),
60921
+ foodLevel: number().nullable().meta(readingMeta("none")),
60538
60922
  /** Hopper-1 food level (grams) on dual-hopper feeders; null on
60539
60923
  * single-hopper models. */
60540
- food1: number().nullable(),
60924
+ food1: number().nullable().meta(readingMeta("none")),
60541
60925
  /** Hopper-2 food level (grams) on dual-hopper feeders; null on
60542
60926
  * single-hopper models. */
60543
- food2: number().nullable(),
60927
+ food2: number().nullable().meta(readingMeta("none")),
60544
60928
  /** Derived low-food flag — mirrors the HA `food_level` binary_sensor
60545
60929
  * (`device_class: problem`, on = low). True when the bowl is empty /
60546
60930
  * below the feeder's low threshold. */
60547
60931
  lowFood: boolean(),
60548
60932
  /** Battery charge 0..100 (%). Null on mains-powered models or when the
60549
60933
  * device has no battery reading. */
60550
- batteryPower: number().min(0).max(100).nullable(),
60551
- /** Days of desiccant life remaining. Null when the model has no
60552
- * desiccant sensor. */
60553
- desiccantLeftDays: number().nullable(),
60934
+ batteryPower: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
60935
+ /**
60936
+ * Desiccant life remaining, stored in seconds (duration base, D944).
60937
+ * Providers convert from the days the feeder reports. Null when the
60938
+ * model has no desiccant sensor.
60939
+ */
60940
+ desiccantLeftDays: number().nullable().meta(readingMeta("duration")),
60554
60941
  /** True while a feed is in progress. */
60555
60942
  feeding: boolean(),
60556
60943
  /** Decoded connectivity / power status (HA petkit device-status enum).
@@ -60561,7 +60948,7 @@ object({
60561
60948
  * with `errorCode` for consumers that want the raw integer. */
60562
60949
  error: string().nullable(),
60563
60950
  /** Raw device error code (0 / null = no error). */
60564
- errorCode: number().nullable(),
60951
+ errorCode: number().nullable().meta(readingMeta("none")),
60565
60952
  /** True for D4S/D4SH dual-hopper hardware — gates the per-hopper UI. */
60566
60953
  isDualHopper: boolean(),
60567
60954
  /** Child-lock (manual-lock) setting — buttons on the unit are disabled. */
@@ -60571,7 +60958,7 @@ object({
60571
60958
  /** Play a chime when dispensing. */
60572
60959
  feedSound: boolean(),
60573
60960
  /** Speaker / prompt volume level (device-scaled integer). */
60574
- volume: number(),
60961
+ volume: number().meta(readingMeta("none")),
60575
60962
  /** Ms epoch when the slice was last refreshed from the cloud. */
60576
60963
  lastFetchedAt: number()
60577
60964
  });
@@ -61008,36 +61395,19 @@ method(_void(), PlatformCapabilitiesSchema), method(_void(), HardwareInfoSchema)
61008
61395
  });
61009
61396
  object({
61010
61397
  /** Instantaneous power draw in watts. */
61011
- watts: number().optional().meta({
61012
- unit: "W",
61013
- label: "Power"
61014
- }),
61398
+ watts: number().optional().meta(readingMeta("power", { label: "Power" })),
61015
61399
  /** Cumulative energy in kilowatt-hours since the meter was reset. */
61016
- kwhTotal: number().optional().meta({
61017
- unit: "kWh",
61018
- label: "Energy"
61019
- }),
61400
+ kwhTotal: number().optional().meta(readingMeta("energy", { label: "Energy" })),
61020
61401
  /** Voltage in volts. */
61021
- volts: number().optional(),
61402
+ volts: number().optional().meta(readingMeta("voltage")),
61022
61403
  /** Current in amperes. */
61023
- amps: number().optional(),
61024
- /** Apparent power in volt-amperes (W × power-factor reciprocal). */
61025
- va: number().optional(),
61404
+ amps: number().optional().meta(readingMeta("current")),
61405
+ /** Apparent power in volt-amperes. */
61406
+ va: number().optional().meta(readingMeta("apparent-power")),
61026
61407
  /** Power factor (0..1) if reported. */
61027
- powerFactor: number().min(0).max(1).optional(),
61408
+ powerFactor: number().min(0).max(1).optional().meta(readingMeta("ratio")),
61028
61409
  /** Ms epoch when the slice was last updated. */
61029
- lastFetchedAt: number(),
61030
- /** Live display unit of the single metric this slice carries (e.g. HA
61031
- * `attributes.unit_of_measurement` → 'V' / 'A' / 'W' / 'kW' / 'kWh').
61032
- * Each upstream `sensor.*` entity surfaces ONE device_class, so one
61033
- * unit per slice is unambiguous. The UI prefers this over the role's
61034
- * canonical unit so a 'kW' / 'Wh' feed renders verbatim. */
61035
- unit: string().optional(),
61036
- /** Suggested decimal places for numeric display.
61037
- * Populated live from the upstream source when provided (e.g. HA
61038
- * `attributes.suggested_display_precision`). Falls back to
61039
- * auto-formatting when absent. */
61040
- precision: number().int().min(0).max(10).optional()
61410
+ lastFetchedAt: number()
61041
61411
  });
61042
61412
  DeviceType.Sensor;
61043
61413
  /**
@@ -61058,11 +61428,11 @@ DeviceType.Sensor;
61058
61428
  */
61059
61429
  var GpsLocationSchema = object({
61060
61430
  /** Latitude in decimal degrees, -90..90. */
61061
- latitude: number().min(-90).max(90),
61431
+ latitude: number().min(-90).max(90).meta(readingMeta("angle")),
61062
61432
  /** Longitude in decimal degrees, -180..180. */
61063
- longitude: number().min(-180).max(180),
61433
+ longitude: number().min(-180).max(180).meta(readingMeta("angle")),
61064
61434
  /** Reported accuracy in meters (lower = better). */
61065
- accuracyMeters: number().nonnegative()
61435
+ accuracyMeters: number().nonnegative().meta(readingMeta("length"))
61066
61436
  });
61067
61437
  var PresenceStatusSchema = object({
61068
61438
  /** `home` / `not_home` / any user-defined zone name. */
@@ -61074,25 +61444,16 @@ var PresenceStatusSchema = object({
61074
61444
  gps: GpsLocationSchema.nullable(),
61075
61445
  /** Optional battery level of the tracking device (0..100). Null
61076
61446
  * when not reported. */
61077
- batteryPercent: number().min(0).max(100).nullable(),
61447
+ batteryPercent: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
61078
61448
  /** Ms epoch when the slice was last updated. */
61079
61449
  lastChangedAt: number()
61080
61450
  });
61081
61451
  DeviceType.Presence;
61082
61452
  object({
61083
- /** Current pressure in hPa. */
61084
- hpa: number(),
61453
+ /** Current pressure in hPa. `null` when the sample was refused (D393). */
61454
+ hpa: number().nullable().meta(readingMeta("pressure", { precision: 0 })),
61085
61455
  /** Ms epoch when the slice was last updated. */
61086
- lastFetchedAt: number(),
61087
- /** Live display unit from the upstream source (e.g. HA
61088
- * `attributes.unit_of_measurement`). The UI prefers this over the
61089
- * role's canonical unit. Absent → fall back to the canonical unit. */
61090
- unit: string().optional(),
61091
- /** Suggested decimal places for numeric display.
61092
- * Populated live from the upstream source when provided (e.g. HA
61093
- * `attributes.suggested_display_precision`). Falls back to
61094
- * auto-formatting when absent. */
61095
- precision: number().int().min(0).max(10).optional()
61456
+ lastFetchedAt: number()
61096
61457
  });
61097
61458
  DeviceType.Sensor;
61098
61459
  /**
@@ -61425,8 +61786,8 @@ DeviceType.Camera, method(PtzMoveCommandSchema.extend({ deviceId: number() }), _
61425
61786
  }), _void(), { kind: "mutation" });
61426
61787
  var PtzAutotrackSettingsSchema = object({
61427
61788
  targetType: string().describe("Vendor target string (people/vehicle/pet); empty = camera default"),
61428
- stopDelaySeconds: number().int().min(0).max(300),
61429
- disappearDelaySeconds: number().int().min(0).max(300)
61789
+ stopDelaySeconds: number().int().min(0).max(300).meta(readingMeta("duration")),
61790
+ disappearDelaySeconds: number().int().min(0).max(300).meta(readingMeta("duration"))
61430
61791
  });
61431
61792
  /**
61432
61793
  * One option the camera advertises as a valid `targetType`. Drivers
@@ -61483,7 +61844,7 @@ object({
61483
61844
  /** null = unknown — never coerced to false (D393). */
61484
61845
  running: boolean().nullable(),
61485
61846
  /** Epoch ms the current boolean began; null while `running` is null. */
61486
- since: number().nullable(),
61847
+ since: number().nullable().meta(readingMeta("none")),
61487
61848
  source: RunningStateSourceSchema.meta({ label: "Source" }),
61488
61849
  phase: string().nullable(),
61489
61850
  /** null until a reading has been published (D393). */
@@ -62681,9 +63042,9 @@ var RecordTriggerSchema = _enum([
62681
63042
  */
62682
63043
  var RecordWindowSchema = object({
62683
63044
  trigger: RecordTriggerSchema,
62684
- day: number().int().min(0).max(6),
62685
- startMinute: number().int().min(0).max(1439),
62686
- endMinute: number().int().min(1).max(1440)
63045
+ day: number().int().min(0).max(6).meta(readingMeta("none")),
63046
+ startMinute: number().int().min(0).max(1439).meta(readingMeta("none")),
63047
+ endMinute: number().int().min(1).max(1440).meta(readingMeta("none"))
62687
63048
  });
62688
63049
  /** Status of one physical volume, as the camera itself describes it. */
62689
63050
  var OnboardStorageVolumeSchema = object({
@@ -62752,10 +63113,10 @@ object({
62752
63113
  /** Master "record to the card at all" switch. */
62753
63114
  enabled: boolean().nullable(),
62754
63115
  overwriteWhenFull: boolean().nullable(),
62755
- preRecordSec: number().nullable(),
62756
- postRecordSec: number().nullable(),
63116
+ preRecordSec: number().nullable().meta(readingMeta("duration")),
63117
+ postRecordSec: number().nullable().meta(readingMeta("duration")),
62757
63118
  /** Length of one recorded file, in minutes. */
62758
- segmentMinutes: number().nullable(),
63119
+ segmentMinutes: number().nullable().meta(readingMeta("none")),
62759
63120
  /** The primary track's weekly windows, flattened. */
62760
63121
  windows: array(RecordWindowSchema),
62761
63122
  /**
@@ -62771,7 +63132,7 @@ object({
62771
63132
  * provider reporting a non-zero count also reports the schedule as not
62772
63133
  * writable.
62773
63134
  */
62774
- unreadableWindows: number(),
63135
+ unreadableWindows: number().meta(readingMeta("count")),
62775
63136
  /**
62776
63137
  * The camera is scheduled to record and has NO usable storage.
62777
63138
  *
@@ -63408,7 +63769,7 @@ var CamStreamDescriptorSchema = object({
63408
63769
  url: string().optional(),
63409
63770
  codec: string().optional(),
63410
63771
  resolution: CamStreamResolutionSchema.optional(),
63411
- fps: number().positive().optional(),
63772
+ fps: number().positive().optional().meta(readingMeta("rate")),
63412
63773
  label: string().optional(),
63413
63774
  /** Device-level features (e.g. `battery-operated`) — drives broker policy. */
63414
63775
  deviceFeatures: array(string()).optional(),
@@ -63438,18 +63799,18 @@ var StreamProfileSchema = _enum([
63438
63799
  ]);
63439
63800
  /** The current encoding config of one stream profile. */
63440
63801
  var StreamProfileConfigSchema = object({
63441
- width: number(),
63442
- height: number(),
63802
+ width: number().meta(readingMeta("none")),
63803
+ height: number().meta(readingMeta("none")),
63443
63804
  codec: _enum(["h264", "h265"]),
63444
- framerate: number(),
63445
- bitrate: number(),
63805
+ framerate: number().meta(readingMeta("rate")),
63806
+ bitrate: number().meta(readingMeta("bitrate")),
63446
63807
  bitrateMode: _enum(["vbr", "cbr"]).optional(),
63447
63808
  encoderProfile: _enum([
63448
63809
  "high",
63449
63810
  "main",
63450
63811
  "baseline"
63451
63812
  ]).optional(),
63452
- gop: number().optional(),
63813
+ gop: number().optional().meta(readingMeta("none")),
63453
63814
  /**
63454
63815
  * Whether THIS profile currently carries an audio track. READ-ONLY here.
63455
63816
  *
@@ -64103,35 +64464,21 @@ DeviceType.Sensor;
64103
64464
  * entries with `device_class: temperature` and any future native
64104
64465
  * thermometer.
64105
64466
  *
64106
- * Unit normalisation: providers convert to Celsius before storing.
64107
- * The slice value is always Celsius so cross-cap aggregators
64108
- * (climate-control's `currentTemp`, energy analytics) can compose
64109
- * without per-source unit fixups. The canonical display unit (`°C`) is
64110
- * a descriptor constant in the UI (ROLE_DESCRIPTOR), not stored in
64111
- * `sourceInfo`.
64467
+ * The number is Celsius (D944). Providers convert on ingest. A failed
64468
+ * conversion is `null`, never a guess. Display unit is a read-time preference.
64112
64469
  *
64113
64470
  * Status `lastFetchedAt` lets staleness-aware consumers detect a
64114
64471
  * frozen feed (provider hung) distinct from a "temperature hasn't
64115
64472
  * changed" steady state.
64116
64473
  */
64117
64474
  var TemperatureSensorStatusSchema = object({
64118
- /** Current temperature in Celsius. */
64119
- celsius: number().meta({
64120
- unit: "°C",
64475
+ /** Current temperature in Celsius. `null` when the sample was refused (D393). */
64476
+ celsius: number().nullable().meta(readingMeta("temperature", {
64477
+ precision: 1,
64121
64478
  label: "Temperature"
64122
- }),
64479
+ })),
64123
64480
  /** Ms epoch when the slice was last updated (push or poll). */
64124
- lastFetchedAt: number(),
64125
- /** Live display unit from the upstream source (e.g. HA
64126
- * `attributes.unit_of_measurement`). The UI prefers this over the
64127
- * role's canonical unit, so a Fahrenheit feed renders '°F' not '°C'.
64128
- * Absent → the UI falls back to the role's canonical unit. */
64129
- unit: string().optional(),
64130
- /** Suggested decimal places for numeric display.
64131
- * Populated live from the upstream source when provided (e.g. HA
64132
- * `attributes.suggested_display_precision`). Falls back to
64133
- * auto-formatting when absent. */
64134
- precision: number().int().min(0).max(10).optional()
64481
+ lastFetchedAt: number()
64135
64482
  });
64136
64483
  DeviceType.Sensor, DeviceType.Thermostat;
64137
64484
  /**
@@ -64383,16 +64730,16 @@ object({
64383
64730
  ]),
64384
64731
  /** 0..100 battery percentage. Null when the device has no battery
64385
64732
  * reading. */
64386
- batteryLevel: number().min(0).max(100).nullable(),
64733
+ batteryLevel: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
64387
64734
  /** Current fan-speed token (provider-verbatim). Null when unknown or
64388
64735
  * the vacuum has no speed control. */
64389
64736
  fanSpeed: string().nullable(),
64390
64737
  /** Speed tokens the hardware accepts — drives the UI selector. */
64391
64738
  availableFanSpeeds: array(string()),
64392
64739
  /** 0..100 cleaning-completion percentage of the current task, or null. */
64393
- progressPercent: number().min(0).max(100).nullable(),
64740
+ progressPercent: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
64394
64741
  /** Current error code (0 / null = no error). */
64395
- errorCode: number().nullable(),
64742
+ errorCode: number().nullable().meta(readingMeta("none")),
64396
64743
  /** Human label for {@link errorCode}, or null when none / undecodable. */
64397
64744
  errorLabel: string().nullable(),
64398
64745
  /** Ms epoch when the slice was last updated. */
@@ -64431,7 +64778,7 @@ object({
64431
64778
  ]),
64432
64779
  /** 0 = fully closed, 100 = fully open. Null when the device has no
64433
64780
  * intermediate position surface. */
64434
- position: number().min(0).max(100).nullable(),
64781
+ position: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
64435
64782
  /** Ms epoch when the slice was last updated. */
64436
64783
  lastChangedAt: number()
64437
64784
  });
@@ -64459,9 +64806,9 @@ object({
64459
64806
  DeviceType.Sensor;
64460
64807
  object({
64461
64808
  /** Current measured temperature. Null when not reported. */
64462
- currentTemp: number().nullable(),
64809
+ currentTemp: number().nullable().meta(readingMeta("temperature")),
64463
64810
  /** Target temperature setpoint. Null when no setpoint surface. */
64464
- targetTemp: number().nullable(),
64811
+ targetTemp: number().nullable().meta(readingMeta("temperature")),
64465
64812
  /** Active operation mode = HA `state` (`eco` / `electric` / `gas` /
64466
64813
  * `heat_pump` / `high_demand` / `performance` / `off`). Null when the
64467
64814
  * device reports an unknown state. */
@@ -64472,9 +64819,9 @@ object({
64472
64819
  * has no away surface. */
64473
64820
  away: boolean().nullable(),
64474
64821
  /** HA `min_temp` attribute. Null when not reported. */
64475
- minTemp: number().nullable(),
64822
+ minTemp: number().nullable().meta(readingMeta("temperature")),
64476
64823
  /** HA `max_temp` attribute. Null when not reported. */
64477
- maxTemp: number().nullable(),
64824
+ maxTemp: number().nullable().meta(readingMeta("temperature")),
64478
64825
  /** Ms epoch when the slice was last updated. */
64479
64826
  lastChangedAt: number()
64480
64827
  });
@@ -64498,25 +64845,18 @@ DeviceType.WaterHeater, method(object({
64498
64845
  auth: "protected"
64499
64846
  });
64500
64847
  object({
64501
- /** Verbatim HA condition state (`sunny`, `cloudy`, `rainy`, …). Null
64502
- * when no condition has been reported yet. */
64848
+ /** Verbatim condition state (`sunny`, `cloudy`, `rainy`, …). Null when none yet. */
64503
64849
  condition: string().nullable(),
64504
- /** Current temperature in the reported unit. Null when not provided. */
64505
- temperature: number().nullable(),
64506
- /** Temperature unit string (e.g. `°C` / `°F`). Null when not provided. */
64507
- temperatureUnit: string().nullable(),
64850
+ /** Current temperature in Celsius. Null when not provided or refused. */
64851
+ temperature: number().nullable().meta(readingMeta("temperature", { precision: 1 })),
64508
64852
  /** Relative humidity (0..100). Null when not provided. */
64509
- humidity: number().min(0).max(100).nullable(),
64510
- /** Barometric pressure in the reported unit. Null when not provided. */
64511
- pressure: number().nullable(),
64512
- /** Pressure unit string (e.g. `hPa` / `inHg`). Null when not provided. */
64513
- pressureUnit: string().nullable(),
64514
- /** Wind speed in the reported unit. Null when not provided. */
64515
- windSpeed: number().nullable(),
64516
- /** Wind-speed unit string (e.g. `km/h` / `mph`). Null when not provided. */
64517
- windSpeedUnit: string().nullable(),
64853
+ humidity: number().min(0).max(100).nullable().meta(readingMeta("humidity")),
64854
+ /** Barometric pressure in hPa. Null when not provided or refused. */
64855
+ pressure: number().nullable().meta(readingMeta("pressure")),
64856
+ /** Wind speed in metres per second. Null when not provided or refused. */
64857
+ windSpeed: number().nullable().meta(readingMeta("speed")),
64518
64858
  /** Wind bearing in degrees (0..360, meteorological). Null when not provided. */
64519
- windBearing: number().nullable(),
64859
+ windBearing: number().nullable().meta(readingMeta("angle")),
64520
64860
  /** Ms epoch when the slice was last updated. */
64521
64861
  lastFetchedAt: number()
64522
64862
  });
@@ -65428,6 +65768,13 @@ Object.freeze({
65428
65768
  access: "view",
65429
65769
  role: "admin"
65430
65770
  },
65771
+ "addons.getPackageDocs": {
65772
+ capName: "addons",
65773
+ capScope: "system",
65774
+ addonId: null,
65775
+ access: "view",
65776
+ role: "admin"
65777
+ },
65431
65778
  "addons.getVersions": {
65432
65779
  capName: "addons",
65433
65780
  capScope: "system",
@@ -68536,6 +68883,20 @@ Object.freeze({
68536
68883
  access: "view",
68537
68884
  role: "viewer"
68538
68885
  },
68886
+ "groupCommands.getStatus": {
68887
+ capName: "group-commands",
68888
+ capScope: "device",
68889
+ addonId: null,
68890
+ access: "view",
68891
+ role: "viewer"
68892
+ },
68893
+ "groupStatus.getStatus": {
68894
+ capName: "group-status",
68895
+ capScope: "device",
68896
+ addonId: null,
68897
+ access: "view",
68898
+ role: "viewer"
68899
+ },
68539
68900
  "heatingValve.getStatus": {
68540
68901
  capName: "heating-valve",
68541
68902
  capScope: "device",
@@ -78358,6 +78719,37 @@ var SENSOR_CAP_VOCABULARY = {
78358
78719
  icon: "flame"
78359
78720
  }]
78360
78721
  },
78722
+ "group-commands": {
78723
+ scope: "device",
78724
+ noun: t("Group command", "Comando di gruppo")
78725
+ },
78726
+ "group-status": {
78727
+ scope: "device",
78728
+ noun: t("Group", "Gruppo"),
78729
+ state: [
78730
+ {
78731
+ kind: "numeric",
78732
+ field: "included",
78733
+ quantity: t("the members reporting", "i membri che rispondono"),
78734
+ label: t("Reporting", "Rispondono"),
78735
+ icon: "users"
78736
+ },
78737
+ {
78738
+ kind: "numeric",
78739
+ field: "excluded",
78740
+ quantity: t("the members left out", "i membri esclusi"),
78741
+ label: t("Excluded", "Esclusi"),
78742
+ icon: "users"
78743
+ },
78744
+ {
78745
+ kind: "numeric",
78746
+ field: "total",
78747
+ quantity: t("the member count", "il numero di membri"),
78748
+ label: t("Members", "Membri"),
78749
+ icon: "sigma"
78750
+ }
78751
+ ]
78752
+ },
78361
78753
  "humidity-sensor": {
78362
78754
  scope: "device",
78363
78755
  noun: t("Humidity", "Umidità"),
@@ -78391,7 +78783,6 @@ var SENSOR_CAP_VOCABULARY = {
78391
78783
  field: "value",
78392
78784
  quantity: t("the reading", "il valore"),
78393
78785
  label: t("Reading", "Valore"),
78394
- unitField: "unit",
78395
78786
  icon: "gauge"
78396
78787
  }]
78397
78788
  },
@@ -78527,7 +78918,7 @@ var SENSOR_CAP_VOCABULARY = {
78527
78918
  field: "temperature",
78528
78919
  quantity: t("the outdoor temperature", "la temperatura esterna"),
78529
78920
  label: t("Temperature", "Temperatura"),
78530
- unitField: "temperatureUnit",
78921
+ unit: "°C",
78531
78922
  icon: "thermometer"
78532
78923
  },
78533
78924
  {
@@ -78543,7 +78934,7 @@ var SENSOR_CAP_VOCABULARY = {
78543
78934
  field: "windSpeed",
78544
78935
  quantity: t("the wind speed", "la velocità del vento"),
78545
78936
  label: t("Wind", "Vento"),
78546
- unitField: "windSpeedUnit",
78937
+ unit: "m/s",
78547
78938
  icon: "wind"
78548
78939
  },
78549
78940
  {
@@ -78551,7 +78942,7 @@ var SENSOR_CAP_VOCABULARY = {
78551
78942
  field: "pressure",
78552
78943
  quantity: t("the air pressure", "la pressione atmosferica"),
78553
78944
  label: t("Pressure", "Pressione"),
78554
- unitField: "pressureUnit",
78945
+ unit: "hPa",
78555
78946
  icon: "gauge"
78556
78947
  }
78557
78948
  ]
@@ -79824,6 +80215,16 @@ Object.freeze({
79824
80215
  form: "single",
79825
80216
  optional: false
79826
80217
  }],
80218
+ "groupCommands.getStatus": [{
80219
+ name: "deviceId",
80220
+ form: "single",
80221
+ optional: false
80222
+ }],
80223
+ "groupStatus.getStatus": [{
80224
+ name: "deviceId",
80225
+ form: "single",
80226
+ optional: false
80227
+ }],
79827
80228
  "heatingValve.getStatus": [{
79828
80229
  name: "deviceId",
79829
80230
  form: "single",
@@ -81808,6 +82209,8 @@ new Map(Object.entries({
81808
82209
  "detection-blind": "device-events",
81809
82210
  "motion-noisy": "device-events",
81810
82211
  "motion-calm": "device-events",
82212
+ "package-llm-silent": "device-events",
82213
+ "package-llm-answered": "device-events",
81811
82214
  "recording-stalled": "device-events",
81812
82215
  "recording-healthy": "device-events",
81813
82216
  "recording-degraded": "device-events",
@@ -81891,6 +82294,12 @@ var NC_SYSTEM_EVENT_KIND_GROUP_SPECS = [
81891
82294
  label: "Motion without a subject",
81892
82295
  kinds: ["motion-noisy", "motion-calm"]
81893
82296
  },
82297
+ {
82298
+ id: "package-llm",
82299
+ family: "device-events",
82300
+ label: "Package confirm",
82301
+ kinds: ["package-llm-silent", "package-llm-answered"]
82302
+ },
81894
82303
  {
81895
82304
  id: "recording",
81896
82305
  family: "device-events",
@@ -82072,6 +82481,8 @@ var DEVICE_EVENTS = [
82072
82481
  "detection-blind",
82073
82482
  "motion-noisy",
82074
82483
  "motion-calm",
82484
+ "package-llm-silent",
82485
+ "package-llm-answered",
82075
82486
  "recording-stalled",
82076
82487
  "recording-healthy",
82077
82488
  "recording-degraded",
@@ -82340,6 +82751,15 @@ new Map([
82340
82751
  snapshotLabel: "Cameras with constant motion now",
82341
82752
  snapshotSection: null
82342
82753
  },
82754
+ {
82755
+ id: "package-llm-confirm",
82756
+ family: "device-events",
82757
+ label: "Package confirm (not answering / answering again)",
82758
+ bad: ["package-llm-silent"],
82759
+ recovery: ["package-llm-answered"],
82760
+ snapshotLabel: "Cameras whose package confirm is not answering",
82761
+ snapshotSection: null
82762
+ },
82343
82763
  {
82344
82764
  id: "recording-health",
82345
82765
  family: "device-events",
@@ -84739,14 +85159,15 @@ var temperatureAdapter = {
84739
85159
  }),
84740
85160
  properties: (_cap, slice) => {
84741
85161
  const p = TemperatureSensorStatusSchema.pick({ celsius: true }).safeParse(slice);
84742
- return p.success ? [{
85162
+ if (!p.success || p.data.celsius === null) return [];
85163
+ return [{
84743
85164
  namespace: "Alexa.TemperatureSensor",
84744
85165
  name: "temperature",
84745
85166
  value: {
84746
85167
  value: Math.round(p.data.celsius * 10) / 10,
84747
85168
  scale: "CELSIUS"
84748
85169
  }
84749
- }] : [];
85170
+ }];
84750
85171
  },
84751
85172
  directives: [],
84752
85173
  shaping: () => ({
@@ -85489,11 +85910,12 @@ var humidityAdapter = {
85489
85910
  }),
85490
85911
  properties: (_cap, slice) => {
85491
85912
  const p = HumiditySensorStatusSchema.pick({ percent: true }).safeParse(slice);
85492
- return p.success ? [{
85913
+ if (!p.success || p.data.percent === null) return [];
85914
+ return [{
85493
85915
  namespace: "Alexa.HumiditySensor",
85494
85916
  name: "relativeHumidity",
85495
85917
  value: { value: Math.max(0, Math.min(100, p.data.percent)) }
85496
- }] : [];
85918
+ }];
85497
85919
  },
85498
85920
  directives: [],
85499
85921
  shaping: () => ({