@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.
@@ -34,7 +34,7 @@ let node_path = require("node:path");
34
34
  node_path = __toESM(node_path, 1);
35
35
  require("node:child_process");
36
36
  require("node:zlib");
37
- //#region ../types/dist/event-category-DHXxB8t9.mjs
37
+ //#region ../types/dist/event-category-CT-hz5Rb.mjs
38
38
  var EventCategory = /* @__PURE__ */ function(EventCategory) {
39
39
  EventCategory["SystemBoot"] = "system.boot";
40
40
  EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -360,6 +360,14 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
360
360
  /** The recovery edge of {@link PipelineMotionNoisy}: the motion fell back, or a detection arrived. */
361
361
  EventCategory["PipelineMotionCalm"] = "pipeline.motion-calm";
362
362
  /**
363
+ * A camera's package LLM confirm has failed closed three times in a row
364
+ * (D931, 2026-10-26). One edge per camera until
365
+ * {@link PipelinePackageLlmAnswered}.
366
+ */
367
+ EventCategory["PipelinePackageLlmSilent"] = "pipeline.package-llm-silent";
368
+ /** The recovery edge of {@link PipelinePackageLlmSilent}: a confirm returned yes or no. */
369
+ EventCategory["PipelinePackageLlmAnswered"] = "pipeline.package-llm-answered";
370
+ /**
363
371
  * Per-camera pipeline config was mutated by the orchestrator
364
372
  * (a settings change via `setAgentInferenceDevices` /
365
373
  * `setCameraStepToggle` / `setCameraStepSettings`). Orchestrator
@@ -5469,7 +5477,7 @@ var ZodIssueCode = {
5469
5477
  var ZodFirstPartyTypeKind;
5470
5478
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5471
5479
  //#endregion
5472
- //#region ../types/dist/sleep-BErAxhul.mjs
5480
+ //#region ../types/dist/sleep-bykKrTgu.mjs
5473
5481
  /**
5474
5482
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5475
5483
  * window to float samples (D455).
@@ -7956,6 +7964,99 @@ var RecordKindDeclarationSchema = object({
7956
7964
  }).strict();
7957
7965
  /** The kind names: lower-case, dash separated, short enough for an index name. */
7958
7966
  var RecordKindNameSchema = string().regex(/^[a-z][a-z0-9-]{0,47}$/);
7967
+ var READING_QUANTITIES = [
7968
+ "temperature",
7969
+ "pressure",
7970
+ "speed",
7971
+ "precipitation",
7972
+ "precipitation-rate",
7973
+ "length",
7974
+ "area",
7975
+ "illuminance",
7976
+ "irradiance",
7977
+ "power",
7978
+ "energy",
7979
+ "voltage",
7980
+ "current",
7981
+ "apparent-power",
7982
+ "humidity",
7983
+ "percentage",
7984
+ "concentration-volume",
7985
+ "concentration-mass",
7986
+ "concentration-ppb",
7987
+ "volume",
7988
+ "duration",
7989
+ "duration-ms",
7990
+ "information",
7991
+ "sound-level",
7992
+ "signal-level",
7993
+ "colour-temperature",
7994
+ "angle",
7995
+ "bitrate",
7996
+ "rate",
7997
+ "mass",
7998
+ "index",
7999
+ "ratio",
8000
+ "count",
8001
+ "none",
8002
+ "device"
8003
+ ];
8004
+ var ReadingQuantitySchema = _enum(READING_QUANTITIES);
8005
+ new Set(READING_QUANTITIES);
8006
+ /**
8007
+ * Stored unit symbol for a quantity. `none` means the number is dimensionless
8008
+ * (or an index / ratio / count). `device` means the cap has no single unit.
8009
+ */
8010
+ var QUANTITY_BASE = {
8011
+ temperature: "°C",
8012
+ pressure: "hPa",
8013
+ speed: "m/s",
8014
+ precipitation: "mm",
8015
+ "precipitation-rate": "mm/h",
8016
+ length: "m",
8017
+ area: "m²",
8018
+ illuminance: "lx",
8019
+ irradiance: "W/m²",
8020
+ power: "W",
8021
+ energy: "kWh",
8022
+ voltage: "V",
8023
+ current: "A",
8024
+ "apparent-power": "VA",
8025
+ humidity: "%",
8026
+ percentage: "%",
8027
+ "concentration-volume": "ppm",
8028
+ "concentration-mass": "µg/m³",
8029
+ "concentration-ppb": "ppb",
8030
+ volume: "L",
8031
+ duration: "s",
8032
+ "duration-ms": "ms",
8033
+ information: "B",
8034
+ "sound-level": "dBFS",
8035
+ "signal-level": "dBm",
8036
+ "colour-temperature": "mired",
8037
+ angle: "°",
8038
+ bitrate: "kbps",
8039
+ rate: "fps",
8040
+ mass: "kg",
8041
+ index: "none",
8042
+ ratio: "none",
8043
+ count: "none",
8044
+ none: "none",
8045
+ device: "device"
8046
+ };
8047
+ /** The stored unit, or `undefined` when the quantity has no unit symbol. */
8048
+ function baseUnitOf(quantity) {
8049
+ const symbol = QUANTITY_BASE[quantity];
8050
+ if (symbol === "none" || symbol === "device") return void 0;
8051
+ return symbol;
8052
+ }
8053
+ function readingMeta(quantity, extras) {
8054
+ return {
8055
+ quantity,
8056
+ ...extras?.precision !== void 0 ? { precision: extras.precision } : {},
8057
+ ...extras?.label !== void 0 ? { label: extras.label } : {}
8058
+ };
8059
+ }
7959
8060
  /** Shared Zod schemas used across streaming capabilities. */
7960
8061
  var CamProfileSchema = _enum([
7961
8062
  "high",
@@ -7983,8 +8084,8 @@ var CamStreamKindSchema = _enum([
7983
8084
  "derived"
7984
8085
  ]);
7985
8086
  var CamStreamResolutionSchema = object({
7986
- width: number().int().positive(),
7987
- height: number().int().positive()
8087
+ width: number().int().positive().meta(readingMeta("none")),
8088
+ height: number().int().positive().meta(readingMeta("none"))
7988
8089
  });
7989
8090
  var CameraStreamSchema = object({
7990
8091
  /** Stable, provider-assigned id unique within the (deviceId) scope. */
@@ -8520,6 +8621,8 @@ var CAP_NAMES = Object.freeze([
8520
8621
  "filesystem-browse",
8521
8622
  "flood",
8522
8623
  "gas",
8624
+ "group-commands",
8625
+ "group-status",
8523
8626
  "heating-valve",
8524
8627
  "humidifier",
8525
8628
  "humidity-sensor",
@@ -8649,14 +8752,6 @@ Object.freeze({
8649
8752
  {
8650
8753
  "path": "aqi",
8651
8754
  "valueType": "number"
8652
- },
8653
- {
8654
- "path": "unit",
8655
- "valueType": "string"
8656
- },
8657
- {
8658
- "path": "precision",
8659
- "valueType": "number"
8660
8755
  }
8661
8756
  ],
8662
8757
  "alarm-panel": [
@@ -8692,20 +8787,10 @@ Object.freeze({
8692
8787
  "valueType": "boolean"
8693
8788
  }
8694
8789
  ],
8695
- "ambient-light-sensor": [
8696
- {
8697
- "path": "lux",
8698
- "valueType": "number"
8699
- },
8700
- {
8701
- "path": "unit",
8702
- "valueType": "string"
8703
- },
8704
- {
8705
- "path": "precision",
8706
- "valueType": "number"
8707
- }
8708
- ],
8790
+ "ambient-light-sensor": [{
8791
+ "path": "lux",
8792
+ "valueType": "number"
8793
+ }],
8709
8794
  "audio-metrics": [
8710
8795
  {
8711
8796
  "path": "ts",
@@ -8785,6 +8870,10 @@ Object.freeze({
8785
8870
  "path": "lastUpdated",
8786
8871
  "valueType": "number"
8787
8872
  },
8873
+ {
8874
+ "path": "volts",
8875
+ "valueType": "number"
8876
+ },
8788
8877
  {
8789
8878
  "path": "lastContactAt",
8790
8879
  "valueType": "number"
@@ -9027,10 +9116,6 @@ Object.freeze({
9027
9116
  "datetime"
9028
9117
  ]
9029
9118
  },
9030
- {
9031
- "path": "unit",
9032
- "valueType": "string"
9033
- },
9034
9119
  {
9035
9120
  "path": "min",
9036
9121
  "valueType": "number"
@@ -9042,19 +9127,6 @@ Object.freeze({
9042
9127
  {
9043
9128
  "path": "step",
9044
9129
  "valueType": "number"
9045
- },
9046
- {
9047
- "path": "precision",
9048
- "valueType": "number"
9049
- },
9050
- {
9051
- "path": "format",
9052
- "valueType": "enum",
9053
- "enumValues": [
9054
- "date",
9055
- "time",
9056
- "datetime"
9057
- ]
9058
9130
  }
9059
9131
  ],
9060
9132
  "cover": [
@@ -9295,13 +9367,8 @@ Object.freeze({
9295
9367
  "path": "value",
9296
9368
  "valueType": "string"
9297
9369
  }, {
9298
- "path": "format",
9299
- "valueType": "enum",
9300
- "enumValues": [
9301
- "date",
9302
- "time",
9303
- "datetime"
9304
- ]
9370
+ "path": "timestamp",
9371
+ "valueType": "boolean"
9305
9372
  }],
9306
9373
  "event-emitter": [
9307
9374
  {
@@ -9374,6 +9441,20 @@ Object.freeze({
9374
9441
  "path": "detected",
9375
9442
  "valueType": "boolean"
9376
9443
  }],
9444
+ "group-status": [
9445
+ {
9446
+ "path": "included",
9447
+ "valueType": "number"
9448
+ },
9449
+ {
9450
+ "path": "excluded",
9451
+ "valueType": "number"
9452
+ },
9453
+ {
9454
+ "path": "total",
9455
+ "valueType": "number"
9456
+ }
9457
+ ],
9377
9458
  "heating-valve": [{
9378
9459
  "path": "position",
9379
9460
  "valueType": "number"
@@ -9408,20 +9489,10 @@ Object.freeze({
9408
9489
  "valueType": "number"
9409
9490
  }
9410
9491
  ],
9411
- "humidity-sensor": [
9412
- {
9413
- "path": "percent",
9414
- "valueType": "number"
9415
- },
9416
- {
9417
- "path": "unit",
9418
- "valueType": "string"
9419
- },
9420
- {
9421
- "path": "precision",
9422
- "valueType": "number"
9423
- }
9424
- ],
9492
+ "humidity-sensor": [{
9493
+ "path": "percent",
9494
+ "valueType": "number"
9495
+ }],
9425
9496
  "image": [{
9426
9497
  "path": "url",
9427
9498
  "valueType": "string"
@@ -9760,20 +9831,10 @@ Object.freeze({
9760
9831
  "valueType": "boolean"
9761
9832
  }
9762
9833
  ],
9763
- "numeric-sensor": [
9764
- {
9765
- "path": "value",
9766
- "valueType": "number"
9767
- },
9768
- {
9769
- "path": "unit",
9770
- "valueType": "string"
9771
- },
9772
- {
9773
- "path": "precision",
9774
- "valueType": "number"
9775
- }
9776
- ],
9834
+ "numeric-sensor": [{
9835
+ "path": "value",
9836
+ "valueType": "number"
9837
+ }],
9777
9838
  "pet-feeder": [
9778
9839
  {
9779
9840
  "path": "foodLevel",
@@ -9865,14 +9926,6 @@ Object.freeze({
9865
9926
  {
9866
9927
  "path": "powerFactor",
9867
9928
  "valueType": "number"
9868
- },
9869
- {
9870
- "path": "unit",
9871
- "valueType": "string"
9872
- },
9873
- {
9874
- "path": "precision",
9875
- "valueType": "number"
9876
9929
  }
9877
9930
  ],
9878
9931
  "presence": [
@@ -9901,20 +9954,10 @@ Object.freeze({
9901
9954
  "valueType": "number"
9902
9955
  }
9903
9956
  ],
9904
- "pressure-sensor": [
9905
- {
9906
- "path": "hpa",
9907
- "valueType": "number"
9908
- },
9909
- {
9910
- "path": "unit",
9911
- "valueType": "string"
9912
- },
9913
- {
9914
- "path": "precision",
9915
- "valueType": "number"
9916
- }
9917
- ],
9957
+ "pressure-sensor": [{
9958
+ "path": "hpa",
9959
+ "valueType": "number"
9960
+ }],
9918
9961
  "privacy-mask": [{
9919
9962
  "path": "enabled",
9920
9963
  "valueType": "boolean"
@@ -10225,20 +10268,10 @@ Object.freeze({
10225
10268
  "path": "tampered",
10226
10269
  "valueType": "boolean"
10227
10270
  }],
10228
- "temperature-sensor": [
10229
- {
10230
- "path": "celsius",
10231
- "valueType": "number"
10232
- },
10233
- {
10234
- "path": "unit",
10235
- "valueType": "string"
10236
- },
10237
- {
10238
- "path": "precision",
10239
- "valueType": "number"
10240
- }
10241
- ],
10271
+ "temperature-sensor": [{
10272
+ "path": "celsius",
10273
+ "valueType": "number"
10274
+ }],
10242
10275
  "update": [
10243
10276
  {
10244
10277
  "path": "currentVersion",
@@ -10349,10 +10382,6 @@ Object.freeze({
10349
10382
  "path": "temperature",
10350
10383
  "valueType": "number"
10351
10384
  },
10352
- {
10353
- "path": "temperatureUnit",
10354
- "valueType": "string"
10355
- },
10356
10385
  {
10357
10386
  "path": "humidity",
10358
10387
  "valueType": "number"
@@ -10361,18 +10390,10 @@ Object.freeze({
10361
10390
  "path": "pressure",
10362
10391
  "valueType": "number"
10363
10392
  },
10364
- {
10365
- "path": "pressureUnit",
10366
- "valueType": "string"
10367
- },
10368
10393
  {
10369
10394
  "path": "windSpeed",
10370
10395
  "valueType": "number"
10371
10396
  },
10372
- {
10373
- "path": "windSpeedUnit",
10374
- "valueType": "string"
10375
- },
10376
10397
  {
10377
10398
  "path": "windBearing",
10378
10399
  "valueType": "number"
@@ -10775,7 +10796,7 @@ function errMsg(err) {
10775
10796
  return String(err);
10776
10797
  }
10777
10798
  //#endregion
10778
- //#region ../types/dist/composition-kEl9mevu.mjs
10799
+ //#region ../types/dist/composition-OhpuespA.mjs
10779
10800
  /**
10780
10801
  * The ffmpeg build every CamStack node downloads, per platform and arch.
10781
10802
  *
@@ -11530,15 +11551,74 @@ function validateExpressionSource(src) {
11530
11551
  }
11531
11552
  return null;
11532
11553
  }
11533
- /** A composed device's stableId is this prefix plus the block id. */
11534
- var COMPOSED_DEVICE_STABLE_ID_PREFIX = "composed-";
11535
- /** Longest snippet a `code` source may carry (slice 4). */
11536
- var MAX_COMPOSITION_CODE_LENGTH = 2e4;
11554
+ /**
11555
+ * A composition source identity: `(addonId, stableId)`, never a numeric device
11556
+ * id. Split out so helper schemas can name it without a cycle through
11557
+ * `composition.ts` (D659).
11558
+ */
11537
11559
  var CompositionSourceRefSchema = object({
11538
11560
  /** The owning addon; `stableId` is unique only within it. */
11539
11561
  addonId: string().min(1),
11540
11562
  stableId: string().min(1)
11541
11563
  });
11564
+ var GROUP_TEMPLATE_IDS = [
11565
+ "temperature",
11566
+ "humidity",
11567
+ "pressure",
11568
+ "illuminance",
11569
+ "power",
11570
+ "energy",
11571
+ "battery",
11572
+ "numeric",
11573
+ "motion",
11574
+ "contact",
11575
+ "leak",
11576
+ "smoke",
11577
+ "occupancy",
11578
+ "binary",
11579
+ "switch",
11580
+ "light"
11581
+ ];
11582
+ var NUMERIC_AGGREGATES = [
11583
+ "mean",
11584
+ "median",
11585
+ "min",
11586
+ "max",
11587
+ "sum"
11588
+ ];
11589
+ var BINARY_AGGREGATES = ["any", "all"];
11590
+ /** How an actuator group decides it is on. Unknown members never count as off. */
11591
+ var ACTIVE_CRITERIA = ["at-least-one", "all"];
11592
+ var AGGREGATE_REDUCERS = [
11593
+ "mean",
11594
+ "median",
11595
+ "min",
11596
+ "max",
11597
+ "sum",
11598
+ "any",
11599
+ "all"
11600
+ ];
11601
+ var GroupTemplateIdSchema = _enum(GROUP_TEMPLATE_IDS);
11602
+ var AggregateReducerSchema = _enum(AGGREGATE_REDUCERS);
11603
+ var ActiveCriterionSchema = _enum(ACTIVE_CRITERIA);
11604
+ /** One member. The field is stored so occupancy can name motion or binary. */
11605
+ var HelperMemberSchema = object({
11606
+ source: CompositionSourceRefSchema,
11607
+ cap: string().min(1),
11608
+ fieldPath: string().min(1)
11609
+ });
11610
+ var HelperSpecSchema = discriminatedUnion("kind", [object({
11611
+ kind: literal("group"),
11612
+ templateId: GroupTemplateIdSchema,
11613
+ aggregate: AggregateReducerSchema,
11614
+ members: array(HelperMemberSchema).min(1).max(64),
11615
+ /** Actuator groups only. Readings leave this unset. */
11616
+ active: ActiveCriterionSchema.optional()
11617
+ })]);
11618
+ /** A composed device's stableId is this prefix plus the block id. */
11619
+ var COMPOSED_DEVICE_STABLE_ID_PREFIX = "composed-";
11620
+ /** Longest snippet a `code` source may carry (slice 4). */
11621
+ var MAX_COMPOSITION_CODE_LENGTH = 2e4;
11542
11622
  /** One field of one capability of one source device. */
11543
11623
  var CompositionFieldReadSchema = object({
11544
11624
  source: CompositionSourceRefSchema,
@@ -11582,7 +11662,33 @@ var CompositionCodeSourceSchema = object({
11582
11662
  var CompositionFieldSourceSchema = discriminatedUnion("kind", [
11583
11663
  CompositionFromSourceSchema,
11584
11664
  CompositionExpressionSourceSchema,
11585
- CompositionCodeSourceSchema
11665
+ CompositionCodeSourceSchema,
11666
+ object({
11667
+ kind: literal("aggregate"),
11668
+ reducer: _enum([
11669
+ "mean",
11670
+ "median",
11671
+ "min",
11672
+ "max",
11673
+ "sum",
11674
+ "any",
11675
+ "all"
11676
+ ]),
11677
+ reads: array(CompositionFieldReadSchema).min(1).max(64),
11678
+ /** `value` is the reading; the others are the member counts. */
11679
+ publish: _enum([
11680
+ "value",
11681
+ "included",
11682
+ "excluded",
11683
+ "total"
11684
+ ]),
11685
+ /** What a `value` publish does when nobody is included. Counts ignore this. */
11686
+ empty: _enum([
11687
+ "null",
11688
+ "omit",
11689
+ "offline"
11690
+ ])
11691
+ })
11586
11692
  ]);
11587
11693
  var CompositionCommandTargetSchema = discriminatedUnion("kind", [object({
11588
11694
  kind: literal("forward"),
@@ -11628,7 +11734,13 @@ var CompositionSchema = object({
11628
11734
  kind: literal("existing"),
11629
11735
  device: CompositionSourceRefSchema
11630
11736
  })]),
11631
- features: array(CompositionFeatureSchema).min(1).max(16)
11737
+ features: array(CompositionFeatureSchema).min(1).max(16),
11738
+ /**
11739
+ * Present when the block is a helper template. Absent on a free
11740
+ * composition (the room example, device 4603). The editor reads this,
11741
+ * never the compiled features.
11742
+ */
11743
+ helper: HelperSpecSchema.optional()
11632
11744
  }).superRefine((composition, ctx) => {
11633
11745
  const seen = /* @__PURE__ */ new Set();
11634
11746
  composition.features.forEach((feature, index) => {
@@ -18036,7 +18148,11 @@ var CompositionProblemSchema = object({
18036
18148
  "item-field-reserved",
18037
18149
  "target-missing",
18038
18150
  "target-unreadable",
18039
- "not-replaceable"
18151
+ "not-replaceable",
18152
+ "native-capability-replace",
18153
+ "mixed-quantity",
18154
+ "helper-mismatch",
18155
+ "member-constraint"
18040
18156
  ]),
18041
18157
  path: string(),
18042
18158
  message: string()
@@ -18057,7 +18173,8 @@ var CompositionUnavailableModeSchema = _enum([
18057
18173
  "null",
18058
18174
  "offline",
18059
18175
  "unknown",
18060
- "release"
18176
+ "release",
18177
+ "omit"
18061
18178
  ]);
18062
18179
  /**
18063
18180
  * `derived` reads a source · `clock` reads only `now`, recomputed when a sibling
@@ -18094,9 +18211,11 @@ var CompositionFieldPlanSchema = object({
18094
18211
  reads: array(CompositionFieldReadSchema)
18095
18212
  });
18096
18213
  /**
18097
- * What a feature does to its target (D663): `new` builds a capability on a new
18098
- * device; on an existing device it `add`s a capability the device lacks, or
18099
- * `replace`s named fields of one it has natively.
18214
+ * What a feature does to its target (D663, D944): `new` builds a capability on a
18215
+ * new device; on an existing device it `add`s a capability the device lacks.
18216
+ * Replacing a capability the device already serves is refused
18217
+ * (`native-capability-replace`), not planned. `replace` remains on the claim
18218
+ * wire for a claim the hub already holds.
18100
18219
  */
18101
18220
  var CompositionFeatureModeSchema = _enum([
18102
18221
  "new",
@@ -18269,6 +18388,275 @@ Object.freeze({
18269
18388
  result: ["number", "null"]
18270
18389
  }
18271
18390
  });
18391
+ /**
18392
+ * One catalog row per base reading a group helper can build (D944 §3).
18393
+ * Data, not a form default written into the block.
18394
+ */
18395
+ var NOW = {
18396
+ fieldPath: "lastFetchedAt",
18397
+ expr: "now"
18398
+ };
18399
+ var CHANGED = {
18400
+ fieldPath: "lastChangedAt",
18401
+ expr: "now"
18402
+ };
18403
+ function numeric(input) {
18404
+ return {
18405
+ ...input,
18406
+ family: "numeric",
18407
+ deviceType: DeviceType.Sensor,
18408
+ memberDeviceType: DeviceType.Sensor,
18409
+ commandCaps: [],
18410
+ baseUnit: baseUnitOf(input.quantity),
18411
+ aggregates: NUMERIC_AGGREGATES,
18412
+ accept: [{
18413
+ cap: input.outputCap,
18414
+ fieldPath: input.outputField
18415
+ }]
18416
+ };
18417
+ }
18418
+ function binary(input) {
18419
+ return {
18420
+ ...input,
18421
+ family: "binary",
18422
+ deviceType: DeviceType.Sensor,
18423
+ memberDeviceType: DeviceType.Sensor,
18424
+ commandCaps: [],
18425
+ quantity: "none",
18426
+ baseUnit: void 0,
18427
+ aggregates: BINARY_AGGREGATES,
18428
+ empty: "offline"
18429
+ };
18430
+ }
18431
+ var GROUP_TEMPLATES = [
18432
+ numeric({
18433
+ id: "temperature",
18434
+ summary: "Mean, median, min, max or sum of temperatures. Offline and unknown members are left out, never read as 0 °C.",
18435
+ role: DeviceRole.TemperatureSensor,
18436
+ outputCap: "temperature-sensor",
18437
+ outputField: "celsius",
18438
+ quantity: "temperature",
18439
+ defaultAggregate: "mean",
18440
+ empty: "null",
18441
+ companions: [NOW]
18442
+ }),
18443
+ numeric({
18444
+ id: "humidity",
18445
+ summary: "Humidity in percent. Offline and unknown members are left out, never read as 0 %.",
18446
+ role: DeviceRole.HumiditySensor,
18447
+ outputCap: "humidity-sensor",
18448
+ outputField: "percent",
18449
+ quantity: "humidity",
18450
+ defaultAggregate: "mean",
18451
+ empty: "null",
18452
+ companions: [NOW]
18453
+ }),
18454
+ numeric({
18455
+ id: "pressure",
18456
+ summary: "Pressure in hectopascals. Offline and unknown members are left out, never read as 0 hPa.",
18457
+ role: DeviceRole.PressureSensor,
18458
+ outputCap: "pressure-sensor",
18459
+ outputField: "hpa",
18460
+ quantity: "pressure",
18461
+ defaultAggregate: "mean",
18462
+ empty: "null",
18463
+ companions: [NOW]
18464
+ }),
18465
+ numeric({
18466
+ id: "illuminance",
18467
+ summary: "Illuminance in lux. Offline and unknown members are left out, never read as 0 lx.",
18468
+ role: DeviceRole.AmbientLightSensor,
18469
+ outputCap: "ambient-light-sensor",
18470
+ outputField: "lux",
18471
+ quantity: "illuminance",
18472
+ defaultAggregate: "mean",
18473
+ empty: "null",
18474
+ companions: [NOW]
18475
+ }),
18476
+ numeric({
18477
+ id: "power",
18478
+ summary: "Power in watts, summed by default. Nobody reporting omits the key rather than writing 0 W.",
18479
+ role: DeviceRole.PowerSensor,
18480
+ outputCap: "power-meter",
18481
+ outputField: "watts",
18482
+ quantity: "power",
18483
+ defaultAggregate: "sum",
18484
+ empty: "omit",
18485
+ companions: [NOW]
18486
+ }),
18487
+ numeric({
18488
+ id: "energy",
18489
+ summary: "Energy in kilowatt-hours, summed by default. Nobody reporting omits the key rather than writing 0 kWh.",
18490
+ role: DeviceRole.EnergySensor,
18491
+ outputCap: "power-meter",
18492
+ outputField: "kwhTotal",
18493
+ quantity: "energy",
18494
+ defaultAggregate: "sum",
18495
+ empty: "omit",
18496
+ companions: [NOW]
18497
+ }),
18498
+ numeric({
18499
+ id: "battery",
18500
+ summary: "Battery charge in percent. Offline and unknown members are left out, never read as 0 %.",
18501
+ role: DeviceRole.BatterySensor,
18502
+ outputCap: "battery",
18503
+ outputField: "percentage",
18504
+ quantity: "percentage",
18505
+ defaultAggregate: "mean",
18506
+ empty: "null",
18507
+ companions: [
18508
+ {
18509
+ fieldPath: "charging",
18510
+ expr: "\"unknown\""
18511
+ },
18512
+ {
18513
+ fieldPath: "sleeping",
18514
+ expr: "false"
18515
+ },
18516
+ {
18517
+ fieldPath: "lastUpdated",
18518
+ expr: "now"
18519
+ }
18520
+ ]
18521
+ }),
18522
+ numeric({
18523
+ id: "numeric",
18524
+ summary: "A numeric reading in the members’ shared quantity. Mixed quantities are refused. Nobody reporting publishes null, not 0.",
18525
+ role: DeviceRole.NumericSensor,
18526
+ outputCap: "numeric-sensor",
18527
+ outputField: "value",
18528
+ quantity: "device",
18529
+ defaultAggregate: "mean",
18530
+ empty: "null",
18531
+ companions: [NOW]
18532
+ }),
18533
+ binary({
18534
+ id: "motion",
18535
+ summary: "Any or all motion. Offline and unknown members are left out, never read as off. Nobody reporting takes the device offline.",
18536
+ role: DeviceRole.MotionSensor,
18537
+ outputCap: "motion",
18538
+ outputField: "detected",
18539
+ defaultAggregate: "any",
18540
+ accept: [{
18541
+ cap: "motion",
18542
+ fieldPath: "detected"
18543
+ }],
18544
+ companions: [{
18545
+ fieldPath: "lastDetectedAt",
18546
+ expr: "null"
18547
+ }, {
18548
+ fieldPath: "autoClearAfterMs",
18549
+ expr: "null"
18550
+ }]
18551
+ }),
18552
+ binary({
18553
+ id: "contact",
18554
+ summary: "Any or all open contacts. Offline and unknown members are left out, never read as closed.",
18555
+ role: DeviceRole.ContactSensor,
18556
+ outputCap: "contact",
18557
+ outputField: "entryOpen",
18558
+ defaultAggregate: "any",
18559
+ accept: [{
18560
+ cap: "contact",
18561
+ fieldPath: "entryOpen"
18562
+ }],
18563
+ companions: [CHANGED]
18564
+ }),
18565
+ binary({
18566
+ id: "leak",
18567
+ summary: "Any or all leak detections. Offline and unknown members are left out, never read as dry.",
18568
+ role: DeviceRole.LeakSensor,
18569
+ outputCap: "flood",
18570
+ outputField: "flooded",
18571
+ defaultAggregate: "any",
18572
+ accept: [{
18573
+ cap: "flood",
18574
+ fieldPath: "flooded"
18575
+ }],
18576
+ companions: [CHANGED]
18577
+ }),
18578
+ binary({
18579
+ id: "smoke",
18580
+ summary: "Any or all smoke detections. Offline and unknown members are left out, never read as clear.",
18581
+ role: DeviceRole.SmokeSensor,
18582
+ outputCap: "smoke",
18583
+ outputField: "detected",
18584
+ defaultAggregate: "any",
18585
+ accept: [{
18586
+ cap: "smoke",
18587
+ fieldPath: "detected"
18588
+ }],
18589
+ companions: [CHANGED]
18590
+ }),
18591
+ binary({
18592
+ id: "occupancy",
18593
+ summary: "Any or all of motion or binary sensors, published as a binary. Presence zones are not aggregated. Nobody reporting is offline, not off.",
18594
+ role: DeviceRole.BinarySensor,
18595
+ outputCap: "binary",
18596
+ outputField: "on",
18597
+ defaultAggregate: "any",
18598
+ accept: [{
18599
+ cap: "motion",
18600
+ fieldPath: "detected"
18601
+ }, {
18602
+ cap: "binary",
18603
+ fieldPath: "on"
18604
+ }],
18605
+ companions: [CHANGED]
18606
+ }),
18607
+ binary({
18608
+ id: "binary",
18609
+ summary: "Any or all generic binary sensors. Offline and unknown members are left out, never read as off.",
18610
+ role: DeviceRole.BinarySensor,
18611
+ outputCap: "binary",
18612
+ outputField: "on",
18613
+ defaultAggregate: "any",
18614
+ accept: [{
18615
+ cap: "binary",
18616
+ fieldPath: "on"
18617
+ }],
18618
+ companions: [CHANGED]
18619
+ }),
18620
+ actuator({
18621
+ id: "switch",
18622
+ 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.",
18623
+ deviceType: DeviceType.Switch,
18624
+ outputCap: "switch",
18625
+ commandCaps: ["switch"]
18626
+ }),
18627
+ actuator({
18628
+ id: "light",
18629
+ 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.",
18630
+ deviceType: DeviceType.Light,
18631
+ outputCap: "switch",
18632
+ commandCaps: [
18633
+ "switch",
18634
+ "brightness",
18635
+ "color"
18636
+ ]
18637
+ })
18638
+ ];
18639
+ function actuator(input) {
18640
+ return {
18641
+ ...input,
18642
+ family: "actuator",
18643
+ role: void 0,
18644
+ memberDeviceType: input.deviceType,
18645
+ outputField: "on",
18646
+ quantity: "none",
18647
+ baseUnit: void 0,
18648
+ aggregates: BINARY_AGGREGATES,
18649
+ defaultAggregate: "any",
18650
+ empty: "offline",
18651
+ accept: [{
18652
+ cap: "switch",
18653
+ fieldPath: "on"
18654
+ }],
18655
+ companions: [CHANGED]
18656
+ };
18657
+ }
18658
+ new Map(GROUP_TEMPLATES.map((template) => [template.id, template]));
18659
+ DeviceFeature.LightColorRgb, DeviceFeature.LightColorHsv, DeviceFeature.LightColorMired;
18272
18660
  `${COMPOSED_DEVICE_STABLE_ID_PREFIX}`;
18273
18661
  /**
18274
18662
  * What a composition may BUILD on a device type (G2, D676): the caps a new
@@ -19982,12 +20370,12 @@ method(object({ deviceId: number().int().nonnegative() }), DeviceAdminLinkSchema
19982
20370
  * providers detect renames by matching `uniqueId` and patch `id`
19983
20371
  * in-place so dispatch keeps working.
19984
20372
  *
19985
- * **Rendering metadata is NOT stored here.** Display fields (`unit`,
19986
- * `precision`) live in the cap STATUS SLICE so they flow live with every
19987
- * state push and are the single source of truth. The `device_class` tag is
19988
- * an HA-specific input that is consumed at the discovery boundary
19989
- * (`ha-domain-mapping`) to derive the CamStack `DeviceRole`; it is never
19990
- * stored after that point.
20373
+ * **Display unit and precision are NOT stored here.** They are a read-time
20374
+ * preference (D944). A polymorphic reading stores its `quantity` here once,
20375
+ * at adopt, and a date/time value stores `dateTimeShape` the same way —
20376
+ * neither is repeated on each sample. The `device_class` tag is an
20377
+ * HA-specific input consumed at the discovery boundary (`ha-domain-mapping`)
20378
+ * to derive the CamStack `DeviceRole`; it is never stored after that point.
19991
20379
  *
19992
20380
  * The `raw` escape hatch carries provider-specific attributes that don't
19993
20381
  * fit the structured slots (HA `attributes` whitelist, Reolink `deviceCache`
@@ -20001,6 +20389,14 @@ var SourceInfoSchema = object({
20001
20389
  /** Immutable upstream identifier when available (HA `unique_id`, … ).
20002
20390
  * Used to detect rename when `id` changes. */
20003
20391
  uniqueId: string().optional(),
20392
+ /** Quantity of a polymorphic reading, written once at adopt (D944). */
20393
+ quantity: ReadingQuantitySchema.optional(),
20394
+ /** Date / time / datetime shape of a string reading, written once at adopt. */
20395
+ dateTimeShape: _enum([
20396
+ "date",
20397
+ "time",
20398
+ "datetime"
20399
+ ]).optional(),
20004
20400
  /** Provider-specific extras that don't fit the structured slots.
20005
20401
  * Whitelist what goes here per provider — do NOT dump entire HA
20006
20402
  * attribute blobs (would explode the meta JSON column). */
@@ -40938,7 +41334,8 @@ method(object({
40938
41334
  "enum"
40939
41335
  ]),
40940
41336
  enumValues: array(string()).optional(),
40941
- item: boolean().optional()
41337
+ item: boolean().optional(),
41338
+ quantity: ReadingQuantitySchema.optional()
40942
41339
  })).readonly(),
40943
41340
  itemArray: object({
40944
41341
  path: string(),
@@ -44738,8 +45135,8 @@ var MaskPolygonShapeSchema = object({
44738
45135
  /** Boolean cell grid — row-major, length === gridWidth*gridHeight. */
44739
45136
  var MaskGridShapeSchema = object({
44740
45137
  kind: literal("grid"),
44741
- gridWidth: number(),
44742
- gridHeight: number(),
45138
+ gridWidth: number().meta(readingMeta("none")),
45139
+ gridHeight: number().meta(readingMeta("none")),
44743
45140
  cells: array(boolean())
44744
45141
  });
44745
45142
  discriminatedUnion("kind", [
@@ -44851,6 +45248,8 @@ var NcSystemEventKindSchema = _enum([
44851
45248
  "detection-blind",
44852
45249
  "motion-noisy",
44853
45250
  "motion-calm",
45251
+ "package-llm-silent",
45252
+ "package-llm-answered",
44854
45253
  "recording-stalled",
44855
45254
  "recording-healthy",
44856
45255
  "recording-degraded",
@@ -55881,6 +56280,28 @@ var PackageVersionInfoSchema = object({
55881
56280
  deprecated: string().optional(),
55882
56281
  distTags: array(string()).readonly()
55883
56282
  });
56283
+ /**
56284
+ * One published document. `ok` is markdown from the registry. `missing` means
56285
+ * the registry answered and the file was not there. `error` is a registry or
56286
+ * tarball failure — never an empty string standing in for either.
56287
+ */
56288
+ var PackageDocBodySchema = discriminatedUnion("status", [
56289
+ object({
56290
+ status: literal("ok"),
56291
+ markdown: string()
56292
+ }),
56293
+ object({ status: literal("missing") }),
56294
+ object({
56295
+ status: literal("error"),
56296
+ message: string()
56297
+ })
56298
+ ]);
56299
+ var PackageDocsSchema = object({
56300
+ name: string(),
56301
+ version: string(),
56302
+ readme: PackageDocBodySchema,
56303
+ changelog: PackageDocBodySchema
56304
+ });
55884
56305
  var SearchResultSchema = object({
55885
56306
  name: string(),
55886
56307
  version: string(),
@@ -56099,7 +56520,10 @@ method(object({ nodeId: string().optional() }).optional(), array(AddonListItemSc
56099
56520
  }), object({ success: literal(true) }), {
56100
56521
  kind: "mutation",
56101
56522
  auth: "admin"
56102
- }), method(object({ name: string() }), array(PackageVersionInfoSchema).readonly()), method(object({ addonId: string() }), RestartAddonResultSchema, {
56523
+ }), method(object({ name: string() }), array(PackageVersionInfoSchema).readonly()), method(object({
56524
+ name: string().min(1),
56525
+ version: string().min(1).optional()
56526
+ }), PackageDocsSchema, { auth: "admin" }), method(object({ addonId: string() }), RestartAddonResultSchema, {
56103
56527
  kind: "mutation",
56104
56528
  auth: "admin"
56105
56529
  }), method(object({ packageName: string() }), object({ success: literal(true) }), {
@@ -56149,46 +56573,27 @@ method(object({ nodeId: string().optional() }).optional(), array(AddonListItemSc
56149
56573
  }), LogStreamEntrySchema, { kind: "subscription" });
56150
56574
  object({
56151
56575
  /** Carbon dioxide concentration in ppm. */
56152
- co2Ppm: number().min(0).optional(),
56576
+ co2Ppm: number().min(0).optional().meta(readingMeta("concentration-volume")),
56153
56577
  /** Total volatile organic compounds in ppb. */
56154
- vocPpb: number().min(0).optional(),
56578
+ vocPpb: number().min(0).optional().meta(readingMeta("concentration-ppb")),
56155
56579
  /** Particulate matter ≤ 2.5 μm in µg/m³. */
56156
- pm25: number().min(0).optional(),
56580
+ pm25: number().min(0).optional().meta(readingMeta("concentration-mass")),
56157
56581
  /** Particulate matter ≤ 10 μm in µg/m³. */
56158
- pm10: number().min(0).optional(),
56582
+ pm10: number().min(0).optional().meta(readingMeta("concentration-mass")),
56159
56583
  /** Composite AQI value (typically 0..500). */
56160
- aqi: number().optional(),
56584
+ aqi: number().optional().meta(readingMeta("index")),
56161
56585
  /** Ms epoch when the slice was last updated. */
56162
- lastFetchedAt: number(),
56163
- /** Live display unit of the single metric this slice carries (e.g. HA
56164
- * `attributes.unit_of_measurement` → 'ppm' / 'ppb' / 'µg/m³'). Each
56165
- * upstream `sensor.*` entity surfaces ONE device_class, so one unit
56166
- * per slice is unambiguous. */
56167
- unit: string().optional(),
56168
- /** Suggested decimal places for numeric display.
56169
- * Populated live from the upstream source when provided (e.g. HA
56170
- * `attributes.suggested_display_precision`). Falls back to
56171
- * auto-formatting when absent. */
56172
- precision: number().int().min(0).max(10).optional()
56586
+ lastFetchedAt: number()
56173
56587
  });
56174
56588
  DeviceType.Sensor;
56175
56589
  object({
56176
- /** Current illuminance in lux (lx). */
56177
- lux: number().min(0).meta({
56178
- unit: "lx",
56590
+ /** Current illuminance in lux (lx). `null` when the sample was refused (D393). */
56591
+ lux: number().min(0).nullable().meta(readingMeta("illuminance", {
56592
+ precision: 0,
56179
56593
  label: "Illuminance"
56180
- }),
56594
+ })),
56181
56595
  /** Ms epoch when the slice was last updated. */
56182
- lastFetchedAt: number(),
56183
- /** Live display unit from the upstream source (e.g. HA
56184
- * `attributes.unit_of_measurement`). The UI prefers this over the
56185
- * role's canonical unit. Absent → fall back to the canonical unit. */
56186
- unit: string().optional(),
56187
- /** Suggested decimal places for numeric display.
56188
- * Populated live from the upstream source when provided (e.g. HA
56189
- * `attributes.suggested_display_precision`). Falls back to
56190
- * auto-formatting when absent. */
56191
- precision: number().int().min(0).max(10).optional()
56596
+ lastFetchedAt: number()
56192
56597
  });
56193
56598
  DeviceType.Sensor;
56194
56599
  /**
@@ -56333,10 +56738,7 @@ var BatteryStatusSchema = object({
56333
56738
  * Consumers must SKIP a null rather than coerce it — `battery-band` already
56334
56739
  * declines to band a non-finite reading, which is the correct shape.
56335
56740
  */
56336
- percentage: number().min(0).max(100).nullable().meta({
56337
- unit: "%",
56338
- label: "Charge"
56339
- }),
56741
+ percentage: number().min(0).max(100).nullable().meta(readingMeta("percentage", { label: "Charge" })),
56340
56742
  /**
56341
56743
  * Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
56342
56744
  * Reolink-specific for the Solar Panel 2 accessory (will become
@@ -56363,7 +56765,14 @@ var BatteryStatusSchema = object({
56363
56765
  */
56364
56766
  sleeping: boolean().meta({ label: "Sleeping" }),
56365
56767
  /** Ms epoch of the last observation. Lets consumers reason about freshness. */
56366
- lastUpdated: number(),
56768
+ lastUpdated: number().meta(readingMeta("none")),
56769
+ /**
56770
+ * Battery voltage in volts, for a cell the firmware reports as voltage
56771
+ * rather than a percentage (Ecowitt capacitor packs). Absent on cameras
56772
+ * that only report charge. A second reading on this cap, not a second
56773
+ * `numeric-sensor` on the same device.
56774
+ */
56775
+ volts: number().nullable().optional().meta(readingMeta("voltage", { label: "Voltage" })),
56367
56776
  /**
56368
56777
  * Ms epoch of the last time the device PROVED it was reachable — a
56369
56778
  * completed firmware round-trip, an observed wake, or an inbound push
@@ -56435,7 +56844,7 @@ DeviceType.Sensor;
56435
56844
  */
56436
56845
  var BrightnessStatusSchema = object({
56437
56846
  /** Current level as 0..100 inclusive. Firmware-reported. */
56438
- percentage: number().min(0).max(100),
56847
+ percentage: number().min(0).max(100).meta(readingMeta("percentage")),
56439
56848
  /** Ms epoch of the last operator-driven change. Useful for UI freshness. */
56440
56849
  lastChangedAt: number()
56441
56850
  });
@@ -56820,21 +57229,21 @@ var ClimateControlStatusSchema = object({
56820
57229
  /** Single setpoint in Celsius. Used by single-target modes
56821
57230
  * (heat / cool / dry). Null when the device is in a range mode
56822
57231
  * (`heat_cool`) or has no setpoint at all (`fan_only`/`off`). */
56823
- target: number().nullable(),
57232
+ target: number().nullable().meta(readingMeta("temperature")),
56824
57233
  /** Upper bound of the dual setpoint in Celsius. Populated only
56825
57234
  * in `heat_cool` mode. */
56826
- targetHigh: number().nullable(),
57235
+ targetHigh: number().nullable().meta(readingMeta("temperature")),
56827
57236
  /** Lower bound of the dual setpoint in Celsius. Populated only
56828
57237
  * in `heat_cool` mode. */
56829
- targetLow: number().nullable(),
57238
+ targetLow: number().nullable().meta(readingMeta("temperature")),
56830
57239
  /** Target relative humidity (0..100). Null when the device has no
56831
57240
  * humidity control. */
56832
- targetHumidity: number().min(0).max(100).nullable(),
57241
+ targetHumidity: number().min(0).max(100).nullable().meta(readingMeta("humidity")),
56833
57242
  /** Current measured temperature in Celsius. Read-only — pushed by
56834
57243
  * the device's internal sensor. */
56835
- currentTemp: number().nullable(),
57244
+ currentTemp: number().nullable().meta(readingMeta("temperature")),
56836
57245
  /** Current measured relative humidity (0..100). Read-only. */
56837
- currentHumidity: number().min(0).max(100).nullable(),
57246
+ currentHumidity: number().min(0).max(100).nullable().meta(readingMeta("humidity")),
56838
57247
  /** Vertical louver swing on/off. Null when the device has no vertical
56839
57248
  * swing surface (gate with `DeviceFeature.ClimateSwingVertical`). */
56840
57249
  swingVertical: boolean().nullable(),
@@ -56842,11 +57251,11 @@ var ClimateControlStatusSchema = object({
56842
57251
  * horizontal swing surface (gate with `DeviceFeature.ClimateSwingHorizontal`). */
56843
57252
  swingHorizontal: boolean().nullable(),
56844
57253
  /** Lowest setpoint the device accepts, Celsius. Absent / null = not reported. */
56845
- minTemp: number().nullable().optional(),
57254
+ minTemp: number().nullable().optional().meta(readingMeta("temperature")),
56846
57255
  /** Highest setpoint the device accepts, Celsius. Absent / null = not reported. */
56847
- maxTemp: number().nullable().optional(),
57256
+ maxTemp: number().nullable().optional().meta(readingMeta("temperature")),
56848
57257
  /** Setpoint granularity, Celsius (0.5, 1). Absent / null = not reported. */
56849
- tempStep: number().positive().nullable().optional(),
57258
+ tempStep: number().positive().nullable().optional().meta(readingMeta("temperature")),
56850
57259
  /** Ms epoch when the slice was last updated (push or command). */
56851
57260
  lastFetchedAt: number()
56852
57261
  });
@@ -56925,17 +57334,17 @@ DeviceType.Thermostat, DeviceType.Climate, method(object({
56925
57334
  * modes to expose in the picker without a slice fetch.
56926
57335
  */
56927
57336
  var RgbTripletSchema = object({
56928
- r: number().int().min(0).max(255),
56929
- g: number().int().min(0).max(255),
56930
- b: number().int().min(0).max(255)
57337
+ r: number().int().min(0).max(255).meta(readingMeta("none")),
57338
+ g: number().int().min(0).max(255).meta(readingMeta("none")),
57339
+ b: number().int().min(0).max(255).meta(readingMeta("none"))
56931
57340
  });
56932
57341
  var HsvTripletSchema = object({
56933
57342
  /** Hue in degrees, 0..360. */
56934
- h: number().min(0).max(360),
57343
+ h: number().min(0).max(360).meta(readingMeta("none")),
56935
57344
  /** Saturation as 0..100 inclusive. */
56936
- s: number().min(0).max(100),
57345
+ s: number().min(0).max(100).meta(readingMeta("none")),
56937
57346
  /** Value/brightness as 0..100 inclusive. */
56938
- v: number().min(0).max(100)
57347
+ v: number().min(0).max(100).meta(readingMeta("none"))
56939
57348
  });
56940
57349
  var ColorInputSchema = discriminatedUnion("mode", [
56941
57350
  object({
@@ -56964,7 +57373,7 @@ object({
56964
57373
  /** Populated when `mode === 'hsv'`. */
56965
57374
  hsv: HsvTripletSchema.optional(),
56966
57375
  /** Populated when `mode === 'mired'`. */
56967
- mireds: number().int().optional(),
57376
+ mireds: number().int().optional().meta(readingMeta("colour-temperature")),
56968
57377
  /** Ms epoch of the last operator-driven change. */
56969
57378
  lastChangedAt: number()
56970
57379
  });
@@ -57088,18 +57497,12 @@ _enum([
57088
57497
  "empty",
57089
57498
  "full"
57090
57499
  ]);
57091
- /** Units a remaining-life counter is reported in. Closed: the panel renders
57092
- * each. */
57093
- var ConsumableRemainingUnitSchema = _enum([
57094
- "days",
57095
- "hours",
57096
- "cycles"
57097
- ]);
57098
- /** Remaining life as a COUNT, not a percentage (the PetKit desiccant reports
57099
- * days). `value` null = unknown (D393). */
57500
+ /** Whether `remaining.value` is a duration in seconds or a dimensionless count. */
57501
+ var ConsumableRemainingKindSchema = _enum(["duration", "count"]);
57502
+ /** Remaining life. `value` null = unknown (D393). Duration is seconds. */
57100
57503
  var ConsumableRemainingSchema = object({
57101
- value: number().min(0).nullable(),
57102
- unit: ConsumableRemainingUnitSchema
57504
+ value: number().min(0).nullable().meta(readingMeta("device")),
57505
+ kind: ConsumableRemainingKindSchema
57103
57506
  });
57104
57507
  var ConsumablesStatusSchema = object({
57105
57508
  items: array(object({
@@ -57108,7 +57511,7 @@ var ConsumablesStatusSchema = object({
57108
57511
  /** Display name. */
57109
57512
  label: string().min(1),
57110
57513
  /** Remaining life % (`wear`) or fill % (`supply`, `waste`) when known (0..100). */
57111
- level: number().min(0).max(100).nullable(),
57514
+ level: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
57112
57515
  /** The provider's discrete verdict when known (binary mode). */
57113
57516
  status: ConsumableStatusSchema.nullable(),
57114
57517
  /** What the item is — decides whether low or full is bad. Absent = `wear`. */
@@ -57125,7 +57528,7 @@ var ConsumablesStatusSchema = object({
57125
57528
  })),
57126
57529
  lastChangedAt: number()
57127
57530
  });
57128
- Object.values(DeviceType), [...ConsumableRemainingUnitSchema.options], [...ConsumableStatusSchema.options], [...ConsumableKindSchema.options], [...ConsumableFormSchema.options];
57531
+ Object.values(DeviceType), [...ConsumableRemainingKindSchema.options], [...ConsumableStatusSchema.options], [...ConsumableKindSchema.options], [...ConsumableFormSchema.options];
57129
57532
  Object.values(DeviceType), method(object({
57130
57533
  deviceId: number().int().nonnegative(),
57131
57534
  key: string().min(1)
@@ -57162,39 +57565,17 @@ object({
57162
57565
  /** Current value. Numeric kind → number; select/text/datetime → string.
57163
57566
  * Datetime values are ISO 8601 strings (full timestamp, date-only,
57164
57567
  * or time-only — HA accepts all three forms). */
57165
- value: union([number(), string()]),
57568
+ value: union([number().meta(readingMeta("device")), string()]),
57166
57569
  /** Acceptable values when `kind === 'select'`. Empty for other kinds. */
57167
57570
  options: array(string()),
57168
57571
  /** Ms epoch when the slice was last updated. */
57169
57572
  lastChangedAt: number(),
57170
- /** Display unit-of-measurement (e.g. '°C', '%', 'lx').
57171
- * Populated live from HA `attributes.unit_of_measurement` on each push.
57172
- * Meaningful for `kind === 'numeric'`; absent for other kinds. */
57173
- unit: string().optional(),
57174
- /** Minimum allowed value. Populated live from HA `attributes.min`.
57175
- * Meaningful for `kind === 'numeric'`; absent for other kinds. */
57176
- min: number().optional(),
57177
- /** Maximum allowed value. Populated live from HA `attributes.max`.
57178
- * Meaningful for `kind === 'numeric'`; absent for other kinds. */
57179
- max: number().optional(),
57180
- /** Step increment. Populated live from HA `attributes.step`.
57181
- * Meaningful for `kind === 'numeric'`; absent for other kinds. */
57182
- step: number().optional(),
57183
- /** Suggested decimal places for numeric display. Populated live from HA
57184
- * `attributes.suggested_display_precision`, or derived from `step` when the
57185
- * HA attribute is absent. Meaningful for `kind === 'numeric'`; absent for
57186
- * other kinds. Falls back to auto-formatting when absent. */
57187
- precision: number().int().min(0).max(10).optional(),
57188
- /** Date-picker granularity for `kind === 'datetime'`. 'date' → date-only,
57189
- * 'time' → time-only, 'datetime' → full timestamp. Absent for other kinds
57190
- * (UI defaults to 'datetime'). Derived live from the device's HA domain
57191
- * (date.* / time.* / datetime.*) or, for input_datetime, from the entity's
57192
- * `has_date`/`has_time` attributes on each push. */
57193
- format: _enum([
57194
- "date",
57195
- "time",
57196
- "datetime"
57197
- ]).optional()
57573
+ /** Minimum allowed value, in the device quantity's base unit. */
57574
+ min: number().optional().meta(readingMeta("device")),
57575
+ /** Maximum allowed value, in the device quantity's base unit. */
57576
+ max: number().optional().meta(readingMeta("device")),
57577
+ /** Step increment, in the device quantity's base unit. */
57578
+ step: number().optional().meta(readingMeta("device"))
57198
57579
  });
57199
57580
  var ControlSetValueInputSchema = discriminatedUnion("kind", [
57200
57581
  object({
@@ -57232,9 +57613,9 @@ var CoverStatusSchema = object({
57232
57613
  ]),
57233
57614
  /** 0 = fully closed, 100 = fully open. Null when the device has
57234
57615
  * no intermediate position surface. */
57235
- position: number().min(0).max(100).nullable(),
57616
+ position: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
57236
57617
  /** 0 = closed slats, 100 = open slats. Null when no tilt support. */
57237
- tiltPosition: number().min(0).max(100).nullable(),
57618
+ tiltPosition: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
57238
57619
  /** Ms epoch when the slice was last updated. */
57239
57620
  lastChangedAt: number()
57240
57621
  });
@@ -57292,9 +57673,9 @@ var NormalizedRangeSchema$1 = object({
57292
57673
  object({
57293
57674
  mode: DayNightModeSchema,
57294
57675
  /** IR-cut trigger sensitivity, NORMALIZED 0–100 (higher = switches to night sooner). */
57295
- sensitivity: number().optional(),
57676
+ sensitivity: number().optional().meta(readingMeta("none")),
57296
57677
  /** Delay before the IR-cut filter flips, in seconds. */
57297
- switchDelaySec: number().optional(),
57678
+ switchDelaySec: number().optional().meta(readingMeta("duration")),
57298
57679
  lastFetchedAt: number()
57299
57680
  });
57300
57681
  /**
@@ -57449,11 +57830,11 @@ object({
57449
57830
  /** Feature keys of the programs the appliance currently offers — drives the UI selector. */
57450
57831
  availablePrograms: array(string()),
57451
57832
  /** Seconds remaining on the active cycle, or null when not running / not known. */
57452
- remainingSeconds: number().int().nonnegative().nullable(),
57833
+ remainingSeconds: number().int().nonnegative().nullable().meta(readingMeta("duration")),
57453
57834
  /** Seconds the delayed start is set to (time until the cycle starts), or null. */
57454
- delayedStartSeconds: number().int().nonnegative().nullable(),
57835
+ delayedStartSeconds: number().int().nonnegative().nullable().meta(readingMeta("duration")),
57455
57836
  /** Cycle completion 0..100, or null when not applicable. */
57456
- progressPercent: number().min(0).max(100).nullable(),
57837
+ progressPercent: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
57457
57838
  /** True when the door is reported open; null when the door state is not known. */
57458
57839
  doorOpen: boolean().nullable(),
57459
57840
  /** True when the door is latched (locked) during a cycle; null when not reported. */
@@ -57477,7 +57858,7 @@ object({
57477
57858
  /** True while the machine-care (descaling / cleaning-program) reminder is raised; false when clear; null when not reported. */
57478
57859
  machineCareDue: boolean().nullable(),
57479
57860
  /** Program runs left before the machine-care reminder is due; null when the appliance does not say. */
57480
- machineCareRemainingRuns: number().int().nonnegative().nullable(),
57861
+ machineCareRemainingRuns: number().int().nonnegative().nullable().meta(readingMeta("count")),
57481
57862
  /** Option states: null when the appliance does not expose the option or has not said. */
57482
57863
  halfLoad: boolean().nullable(),
57483
57864
  hygienePlus: boolean().nullable(),
@@ -57492,7 +57873,7 @@ object({
57492
57873
  /** Feature keys of the events currently raised (salt low, rinse aid low, program finished, …). */
57493
57874
  activeEvents: array(string()),
57494
57875
  /** Numeric error code when the appliance reports one; null otherwise. */
57495
- errorCode: number().nullable(),
57876
+ errorCode: number().nullable().meta(readingMeta("none")),
57496
57877
  /** Name of the raised alert-level event while the appliance is in error; null otherwise. */
57497
57878
  errorLabel: string().nullable(),
57498
57879
  /** Ms epoch of the last value received from the appliance; 0 = never. */
@@ -57638,24 +58019,14 @@ object({
57638
58019
  /** Ms epoch of the last press. null = never observed since this provider started. */
57639
58020
  lastPressedAt: number().nullable(),
57640
58021
  /** Counter since provider start. Resets on reboot. Useful for metrics/debug. */
57641
- pressCountSinceStart: number()
58022
+ pressCountSinceStart: number().meta(readingMeta("count"))
57642
58023
  });
57643
58024
  object({
57644
58025
  deviceId: number(),
57645
58026
  timestamp: number()
57646
58027
  });
57647
58028
  DeviceType.Button, DeviceType.Camera;
57648
- /**
57649
- * Enum-state sensor — a string value picked from a finite option set.
57650
- * Drives HA `sensor` entries with `state_class: enum` (HVAC action
57651
- * states, weather conditions, contact-source channels, mode strings).
57652
- * The option set is stable across observations; it is persisted in the
57653
- * device config blob (via the control slice at adoption) and is NOT
57654
- * stored in `sourceInfo`.
57655
- */
57656
- /** Locale-render shape for an ISO `value` carried by a `DateTimeSensor`-role
57657
- * enum sensor: `date` (date-only), `time` (time-only), `datetime` (both). */
57658
- var EnumSensorDateTimeFormatSchema = _enum([
58029
+ _enum([
57659
58030
  "date",
57660
58031
  "time",
57661
58032
  "datetime"
@@ -57663,12 +58034,11 @@ var EnumSensorDateTimeFormatSchema = _enum([
57663
58034
  object({
57664
58035
  value: string(),
57665
58036
  /**
57666
- * Set for `DateTimeSensor`-role sensors so the UI renders the ISO `value`
57667
- * as a locale date/time/datetime; absent for plain enum sensors. HA
57668
- * `device_class=timestamp` → `'datetime'`, `device_class=date` → `'date'`,
57669
- * a time-only sensor → `'time'`.
58037
+ * Set when `value` is a timestamp rather than an enum state, so history
58038
+ * does not learn ISO strings as states. The display shape (date / time /
58039
+ * datetime) lives on `SourceInfo.dateTimeShape`, written once at adopt.
57670
58040
  */
57671
- format: EnumSensorDateTimeFormatSchema.optional(),
58041
+ timestamp: boolean().optional(),
57672
58042
  /** Ms epoch when the slice was last updated. */
57673
58043
  lastFetchedAt: number()
57674
58044
  });
@@ -57687,13 +58057,13 @@ var EventFireSchema = object({
57687
58057
  deviceId: number(),
57688
58058
  eventType: string(),
57689
58059
  data: record(string(), unknown()).nullable(),
57690
- timestamp: number(),
57691
- seq: number()
58060
+ timestamp: number().meta(readingMeta("none")),
58061
+ seq: number().meta(readingMeta("count"))
57692
58062
  });
57693
58063
  object({
57694
58064
  eventTypes: array(string()),
57695
58065
  lastEvent: EventFireSchema.nullable(),
57696
- eventCountSinceStart: number()
58066
+ eventCountSinceStart: number().meta(readingMeta("count"))
57697
58067
  });
57698
58068
  DeviceType.EventEmitter;
57699
58069
  var IdentitySchema = object({
@@ -58082,10 +58452,10 @@ var FanDirectionSchema = _enum(["forward", "reverse"]);
58082
58452
  object({
58083
58453
  /** Active speed as 0..100 inclusive. Null when the device has no
58084
58454
  * speed surface (single-speed fan). */
58085
- percentage: number().min(0).max(100).nullable(),
58455
+ percentage: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
58086
58456
  /** Speed granularity the device accepts (HA `percentage_step`, e.g. 25 for
58087
58457
  * a 4-speed fan). Absent when unknown — the UI then falls back to step 1. */
58088
- percentageStep: number().positive().optional(),
58458
+ percentageStep: number().positive().optional().meta(readingMeta("percentage")),
58089
58459
  /** Active preset mode (`auto` / `quiet` / `turbo` / vendor-specific)
58090
58460
  * — empty string when no preset is active or supported. */
58091
58461
  preset: string(),
@@ -58167,7 +58537,7 @@ var FeatureProbeStatusSchema = object({
58167
58537
  /** Camera/firmware model string. `null` when the firmware doesn't expose it. */
58168
58538
  model: string().nullable(),
58169
58539
  /** Channel count for NVR/Hub devices; `1` for standalone cameras; `null` pre-probe. */
58170
- channelCount: number().nullable(),
58540
+ channelCount: number().nullable().meta(readingMeta("count")),
58171
58541
  /**
58172
58542
  * Ms epoch of the last SUCCESSFUL probe. `0` before the first probe
58173
58543
  * completes — drivers' `getAccessoryChildren()` should treat zero as
@@ -58199,9 +58569,39 @@ object({
58199
58569
  lastChangedAt: number()
58200
58570
  });
58201
58571
  DeviceType.Sensor;
58572
+ object({
58573
+ /** One row per member that has been commanded. A later command replaces that member's row. */
58574
+ results: array(object({
58575
+ deviceId: number().int().nonnegative(),
58576
+ cap: string().min(1),
58577
+ method: string().min(1),
58578
+ ok: boolean(),
58579
+ error: string().optional(),
58580
+ /** Ms epoch of the attempt. */
58581
+ at: number()
58582
+ })) });
58583
+ DeviceType.Switch, DeviceType.Light;
58584
+ object({
58585
+ /** Members whose current value entered the aggregate. */
58586
+ included: number().int().nonnegative().meta(readingMeta("count", {
58587
+ precision: 0,
58588
+ label: "Reporting"
58589
+ })),
58590
+ /** Members left out: offline, unknown, or not a finite reading (D393). */
58591
+ excluded: number().int().nonnegative().meta(readingMeta("count", {
58592
+ precision: 0,
58593
+ label: "Excluded"
58594
+ })),
58595
+ /** `included` + `excluded`. */
58596
+ total: number().int().nonnegative().meta(readingMeta("count", {
58597
+ precision: 0,
58598
+ label: "Members"
58599
+ }))
58600
+ });
58601
+ DeviceType.Sensor, DeviceType.Switch, DeviceType.Light;
58202
58602
  object({
58203
58603
  /** Radiator valve opening 0 (closed) .. 100 (open). Null = not yet known. */
58204
- position: number().min(0).max(100).nullable(),
58604
+ position: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
58205
58605
  /** Ms epoch when the slice was last updated (push or poll). */
58206
58606
  lastFetchedAt: number()
58207
58607
  });
@@ -58210,9 +58610,9 @@ object({
58210
58610
  /** Whether the humidifier is currently on. */
58211
58611
  on: boolean(),
58212
58612
  /** Current measured relative humidity (0..100). Null when not reported. */
58213
- currentHumidity: number().min(0).max(100).nullable(),
58613
+ currentHumidity: number().min(0).max(100).nullable().meta(readingMeta("humidity")),
58214
58614
  /** Target relative humidity (0..100). Null when no setpoint surface. */
58215
- targetHumidity: number().min(0).max(100).nullable(),
58615
+ targetHumidity: number().min(0).max(100).nullable().meta(readingMeta("humidity")),
58216
58616
  /** Active mode (`auto` / `normal` / `baby` / vendor). Null when the
58217
58617
  * device has no mode surface. */
58218
58618
  mode: string().nullable(),
@@ -58222,9 +58622,9 @@ object({
58222
58622
  * `idle` / `off`). Null when the device doesn't report it. */
58223
58623
  action: string().nullable(),
58224
58624
  /** HA `min_humidity` attribute. Null → UI uses 0. */
58225
- minHumidity: number().nullable(),
58625
+ minHumidity: number().nullable().meta(readingMeta("humidity")),
58226
58626
  /** HA `max_humidity` attribute. Null → UI uses 100. */
58227
- maxHumidity: number().nullable(),
58627
+ maxHumidity: number().nullable().meta(readingMeta("humidity")),
58228
58628
  /** Ms epoch when the slice was last updated. */
58229
58629
  lastChangedAt: number()
58230
58630
  });
@@ -58256,22 +58656,13 @@ DeviceType.Humidifier, method(object({
58256
58656
  * `sourceInfo`.
58257
58657
  */
58258
58658
  var HumiditySensorStatusSchema = object({
58259
- /** Current relative humidity, 0..100. */
58260
- percent: number().min(0).max(100).meta({
58261
- unit: "%",
58659
+ /** Current relative humidity, 0..100. `null` when the sample was refused (D393). */
58660
+ percent: number().min(0).max(100).nullable().meta(readingMeta("humidity", {
58661
+ precision: 0,
58262
58662
  label: "Humidity"
58263
- }),
58663
+ })),
58264
58664
  /** Ms epoch when the slice was last updated. */
58265
- lastFetchedAt: number(),
58266
- /** Live display unit from the upstream source (e.g. HA
58267
- * `attributes.unit_of_measurement`). The UI prefers this over the
58268
- * role's canonical unit. Absent → fall back to the canonical unit. */
58269
- unit: string().optional(),
58270
- /** Suggested decimal places for numeric display.
58271
- * Populated live from the upstream source when provided (e.g. HA
58272
- * `attributes.suggested_display_precision`). Falls back to
58273
- * auto-formatting when absent. */
58274
- precision: number().int().min(0).max(10).optional()
58665
+ lastFetchedAt: number()
58275
58666
  });
58276
58667
  DeviceType.Sensor, DeviceType.Thermostat;
58277
58668
  object({
@@ -58279,7 +58670,7 @@ object({
58279
58670
  * entity exposes no `entity_picture` (yet). */
58280
58671
  url: string().nullable(),
58281
58672
  /** Ms epoch of the upstream last-updated timestamp. Null at cold-start. */
58282
- lastUpdated: number().nullable()
58673
+ lastUpdated: number().nullable().meta(readingMeta("none"))
58283
58674
  });
58284
58675
  DeviceType.Image;
58285
58676
  /**
@@ -58335,19 +58726,19 @@ var NormalizedRangeSchema = object({
58335
58726
  });
58336
58727
  object({
58337
58728
  /** Normalized 0–100. */
58338
- brightness: number().optional(),
58729
+ brightness: number().optional().meta(readingMeta("none")),
58339
58730
  /** Normalized 0–100. */
58340
- contrast: number().optional(),
58731
+ contrast: number().optional().meta(readingMeta("none")),
58341
58732
  /** Normalized 0–100. */
58342
- saturation: number().optional(),
58733
+ saturation: number().optional().meta(readingMeta("none")),
58343
58734
  /** Normalized 0–100. */
58344
- sharpness: number().optional(),
58735
+ sharpness: number().optional().meta(readingMeta("none")),
58345
58736
  mirror: boolean().optional(),
58346
58737
  flip: boolean().optional(),
58347
58738
  rotate: ImageRotateSchema.optional(),
58348
58739
  whiteBalance: WhiteBalanceModeSchema.optional(),
58349
58740
  /** Manual white-balance warmth, NORMALIZED 0–100. Meaningful only when `whiteBalance === 'manual'`. */
58350
- warmth: number().optional(),
58741
+ warmth: number().optional().meta(readingMeta("none")),
58351
58742
  exposureMode: ExposureModeSchema.optional(),
58352
58743
  backlightMode: BacklightModeSchema.optional(),
58353
58744
  lastFetchedAt: number()
@@ -58592,10 +58983,10 @@ var IntercomAbilitySchema = object({
58592
58983
  /** Codecs accepted by firmware, in preference order. Driver-authored strings. */
58593
58984
  codecs: array(string()),
58594
58985
  /** Sample rate (Hz) the firmware expects. Reolink typical: 16000. */
58595
- sampleRate: number(),
58986
+ sampleRate: number().meta(readingMeta("none")),
58596
58987
  duplex: _enum(["half", "full"]),
58597
58988
  /** Max in-flight audio backlog before drop (ms). Server uses this to bound latency. */
58598
- maxBacklogMs: number()
58989
+ maxBacklogMs: number().meta(readingMeta("duration-ms"))
58599
58990
  });
58600
58991
  var IntercomStatusSchema = object({
58601
58992
  /** True while a talk session is open. */
@@ -58706,13 +59097,13 @@ object({
58706
59097
  activity: LawnMowerActivitySchema,
58707
59098
  /** 0..100 battery percentage. Null when the device has no battery
58708
59099
  * reading. */
58709
- batteryLevel: number().min(0).max(100).nullable(),
59100
+ batteryLevel: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
58710
59101
  /** 0..100 mowing-completion percentage of the current task, or null when no
58711
59102
  * task is active / progress is unavailable. */
58712
- progressPercent: number().min(0).max(100).nullable(),
59103
+ progressPercent: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
58713
59104
  /** Current device/event code (dynamic — mostly status, sometimes an error),
58714
59105
  * or null when unknown. */
58715
- currentCode: number().nullable(),
59106
+ currentCode: number().nullable().meta(readingMeta("none")),
58716
59107
  /** Human label for {@link currentCode}, or null when undecodable. */
58717
59108
  currentCodeLabel: string().nullable(),
58718
59109
  /** Severity of {@link currentCode}. `error` (and often `warning`) warrants UI
@@ -59174,7 +59565,7 @@ object({
59174
59565
  state: MediaPlayerStateSchema,
59175
59566
  /** Volume as 0..100 inclusive. Null when the device has no volume
59176
59567
  * surface. Pair with `DeviceFeature.MediaPlayerVolume`. */
59177
- volumeLevel: number().min(0).max(100).nullable(),
59568
+ volumeLevel: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
59178
59569
  /** Mute toggle distinct from volume=0. Null when no mute surface.
59179
59570
  * Pair with `DeviceFeature.MediaPlayerMute`. */
59180
59571
  isMuted: boolean().nullable(),
@@ -59187,10 +59578,10 @@ object({
59187
59578
  currentMedia: MediaInfoSchema.nullable(),
59188
59579
  /** Current playback position in ms. Null when not seekable or
59189
59580
  * nothing is playing. Pair with `DeviceFeature.MediaPlayerSeek`. */
59190
- positionMs: number().int().nonnegative().nullable(),
59581
+ positionMs: number().int().nonnegative().nullable().meta(readingMeta("duration-ms")),
59191
59582
  /** Total duration of the current media in ms. Null when unknown
59192
59583
  * (live stream) or nothing is playing. */
59193
- durationMs: number().int().nonnegative().nullable(),
59584
+ durationMs: number().int().nonnegative().nullable().meta(readingMeta("duration-ms")),
59194
59585
  /** Shuffle toggle. Null when no shuffle surface.
59195
59586
  * Pair with `DeviceFeature.MediaPlayerShuffle`. */
59196
59587
  shuffle: boolean().nullable(),
@@ -59490,7 +59881,7 @@ var MotionStatusSchema = object({
59490
59881
  * it, every provider seeded it at boot, and every session left it
59491
59882
  * `detected: true` after its detach.
59492
59883
  */
59493
- autoClearAfterMs: number().nullable()
59884
+ autoClearAfterMs: number().nullable().meta(readingMeta("duration-ms"))
59494
59885
  });
59495
59886
  /**
59496
59887
  * Payload of `motion.onMotionChanged` event + the corresponding bus
@@ -59540,7 +59931,7 @@ var MotionZoneRegionSchema = object({
59540
59931
  });
59541
59932
  object({
59542
59933
  enabled: boolean(),
59543
- sensitivity: number(),
59934
+ sensitivity: number().meta(readingMeta("none")),
59544
59935
  /** Grid region(s). Today exactly one `grid` shape. */
59545
59936
  regions: array(MotionZoneRegionSchema),
59546
59937
  lastFetchedAt: number()
@@ -59844,7 +60235,7 @@ var NavigationStatusSchema = object({
59844
60235
  following: boolean(),
59845
60236
  flash: boolean(),
59846
60237
  lightMode: NavigationLightModeSchema,
59847
- lightLevel: number().min(40).max(100),
60238
+ lightLevel: number().min(40).max(100).meta(readingMeta("none")),
59848
60239
  /** Ms epoch when the slice was last updated. */
59849
60240
  lastChangedAt: number()
59850
60241
  });
@@ -59890,13 +60281,13 @@ var NetworkLinkStatusSchema = object({
59890
60281
  * one whose reading has not landed must not be drawn at 0 %. Consumers
59891
60282
  * SKIP a null rather than coerce it.
59892
60283
  */
59893
- signalPercent: number().min(0).max(100).nullable(),
60284
+ signalPercent: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
59894
60285
  /** Raw received signal strength in dBm, when the firmware reports one. */
59895
- rssiDbm: number().optional(),
60286
+ rssiDbm: number().optional().meta(readingMeta("signal-level")),
59896
60287
  /** Network name of a wireless link, when the firmware reports it. */
59897
60288
  ssid: string().optional(),
59898
60289
  /** Ms epoch of the last observation. Lets consumers reason about freshness. */
59899
- lastUpdated: number()
60290
+ lastUpdated: number().meta(readingMeta("none"))
59900
60291
  });
59901
60292
  DeviceType.Camera, DeviceType.Sensor, DeviceType.Button, DeviceType.Switch, DeviceType.Light, DeviceType.Lock, DeviceType.Siren, object({
59902
60293
  deviceId: number(),
@@ -60215,7 +60606,7 @@ object({
60215
60606
  lastError: string().nullable(),
60216
60607
  /** Number of deliveries currently buffered server-side (rate-limited
60217
60608
  * notifiers may queue). 0 when the provider sends synchronously. */
60218
- queueDepth: number().int().nonnegative(),
60609
+ queueDepth: number().int().nonnegative().meta(readingMeta("count")),
60219
60610
  /** Per-feature capability matrix — authoritative source for the
60220
60611
  * compose-form field gating. */
60221
60612
  supports: NotifierSupportsSchema
@@ -60265,15 +60656,8 @@ DeviceType.Notifier, method(NotifierSendInputSchema, NotifierSendResultSchema, {
60265
60656
  acceptedAt: number()
60266
60657
  });
60267
60658
  object({
60268
- value: number(),
60269
- /** Display unit-of-measurement (e.g. 'dBm', 's', 'rpm', 'steps').
60270
- * Populated live from the upstream source on each state push.
60271
- * Absent for unitless sensors. */
60272
- unit: string().optional(),
60273
- /** Suggested decimal places for numeric display.
60274
- * Populated live from the upstream source when provided.
60275
- * Falls back to auto-formatting when absent. */
60276
- precision: number().int().min(0).max(10).optional(),
60659
+ /** Reading in the device quantity's base unit. `null` when refused (D393). */
60660
+ value: number().nullable().meta(readingMeta("device")),
60277
60661
  /** Ms epoch when the slice was last updated. */
60278
60662
  lastFetchedAt: number()
60279
60663
  });
@@ -60563,23 +60947,26 @@ object({
60563
60947
  /** Food currently in the bowl (grams). Null when the device has not
60564
60948
  * reported a reading yet. On dual-hopper models this is the combined
60565
60949
  * bowl reading; per-hopper levels live in `food1`/`food2`. */
60566
- foodLevel: number().nullable(),
60950
+ foodLevel: number().nullable().meta(readingMeta("none")),
60567
60951
  /** Hopper-1 food level (grams) on dual-hopper feeders; null on
60568
60952
  * single-hopper models. */
60569
- food1: number().nullable(),
60953
+ food1: number().nullable().meta(readingMeta("none")),
60570
60954
  /** Hopper-2 food level (grams) on dual-hopper feeders; null on
60571
60955
  * single-hopper models. */
60572
- food2: number().nullable(),
60956
+ food2: number().nullable().meta(readingMeta("none")),
60573
60957
  /** Derived low-food flag — mirrors the HA `food_level` binary_sensor
60574
60958
  * (`device_class: problem`, on = low). True when the bowl is empty /
60575
60959
  * below the feeder's low threshold. */
60576
60960
  lowFood: boolean(),
60577
60961
  /** Battery charge 0..100 (%). Null on mains-powered models or when the
60578
60962
  * device has no battery reading. */
60579
- batteryPower: number().min(0).max(100).nullable(),
60580
- /** Days of desiccant life remaining. Null when the model has no
60581
- * desiccant sensor. */
60582
- desiccantLeftDays: number().nullable(),
60963
+ batteryPower: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
60964
+ /**
60965
+ * Desiccant life remaining, stored in seconds (duration base, D944).
60966
+ * Providers convert from the days the feeder reports. Null when the
60967
+ * model has no desiccant sensor.
60968
+ */
60969
+ desiccantLeftDays: number().nullable().meta(readingMeta("duration")),
60583
60970
  /** True while a feed is in progress. */
60584
60971
  feeding: boolean(),
60585
60972
  /** Decoded connectivity / power status (HA petkit device-status enum).
@@ -60590,7 +60977,7 @@ object({
60590
60977
  * with `errorCode` for consumers that want the raw integer. */
60591
60978
  error: string().nullable(),
60592
60979
  /** Raw device error code (0 / null = no error). */
60593
- errorCode: number().nullable(),
60980
+ errorCode: number().nullable().meta(readingMeta("none")),
60594
60981
  /** True for D4S/D4SH dual-hopper hardware — gates the per-hopper UI. */
60595
60982
  isDualHopper: boolean(),
60596
60983
  /** Child-lock (manual-lock) setting — buttons on the unit are disabled. */
@@ -60600,7 +60987,7 @@ object({
60600
60987
  /** Play a chime when dispensing. */
60601
60988
  feedSound: boolean(),
60602
60989
  /** Speaker / prompt volume level (device-scaled integer). */
60603
- volume: number(),
60990
+ volume: number().meta(readingMeta("none")),
60604
60991
  /** Ms epoch when the slice was last refreshed from the cloud. */
60605
60992
  lastFetchedAt: number()
60606
60993
  });
@@ -61037,36 +61424,19 @@ method(_void(), PlatformCapabilitiesSchema), method(_void(), HardwareInfoSchema)
61037
61424
  });
61038
61425
  object({
61039
61426
  /** Instantaneous power draw in watts. */
61040
- watts: number().optional().meta({
61041
- unit: "W",
61042
- label: "Power"
61043
- }),
61427
+ watts: number().optional().meta(readingMeta("power", { label: "Power" })),
61044
61428
  /** Cumulative energy in kilowatt-hours since the meter was reset. */
61045
- kwhTotal: number().optional().meta({
61046
- unit: "kWh",
61047
- label: "Energy"
61048
- }),
61429
+ kwhTotal: number().optional().meta(readingMeta("energy", { label: "Energy" })),
61049
61430
  /** Voltage in volts. */
61050
- volts: number().optional(),
61431
+ volts: number().optional().meta(readingMeta("voltage")),
61051
61432
  /** Current in amperes. */
61052
- amps: number().optional(),
61053
- /** Apparent power in volt-amperes (W × power-factor reciprocal). */
61054
- va: number().optional(),
61433
+ amps: number().optional().meta(readingMeta("current")),
61434
+ /** Apparent power in volt-amperes. */
61435
+ va: number().optional().meta(readingMeta("apparent-power")),
61055
61436
  /** Power factor (0..1) if reported. */
61056
- powerFactor: number().min(0).max(1).optional(),
61437
+ powerFactor: number().min(0).max(1).optional().meta(readingMeta("ratio")),
61057
61438
  /** Ms epoch when the slice was last updated. */
61058
- lastFetchedAt: number(),
61059
- /** Live display unit of the single metric this slice carries (e.g. HA
61060
- * `attributes.unit_of_measurement` → 'V' / 'A' / 'W' / 'kW' / 'kWh').
61061
- * Each upstream `sensor.*` entity surfaces ONE device_class, so one
61062
- * unit per slice is unambiguous. The UI prefers this over the role's
61063
- * canonical unit so a 'kW' / 'Wh' feed renders verbatim. */
61064
- unit: string().optional(),
61065
- /** Suggested decimal places for numeric display.
61066
- * Populated live from the upstream source when provided (e.g. HA
61067
- * `attributes.suggested_display_precision`). Falls back to
61068
- * auto-formatting when absent. */
61069
- precision: number().int().min(0).max(10).optional()
61439
+ lastFetchedAt: number()
61070
61440
  });
61071
61441
  DeviceType.Sensor;
61072
61442
  /**
@@ -61087,11 +61457,11 @@ DeviceType.Sensor;
61087
61457
  */
61088
61458
  var GpsLocationSchema = object({
61089
61459
  /** Latitude in decimal degrees, -90..90. */
61090
- latitude: number().min(-90).max(90),
61460
+ latitude: number().min(-90).max(90).meta(readingMeta("angle")),
61091
61461
  /** Longitude in decimal degrees, -180..180. */
61092
- longitude: number().min(-180).max(180),
61462
+ longitude: number().min(-180).max(180).meta(readingMeta("angle")),
61093
61463
  /** Reported accuracy in meters (lower = better). */
61094
- accuracyMeters: number().nonnegative()
61464
+ accuracyMeters: number().nonnegative().meta(readingMeta("length"))
61095
61465
  });
61096
61466
  var PresenceStatusSchema = object({
61097
61467
  /** `home` / `not_home` / any user-defined zone name. */
@@ -61103,25 +61473,16 @@ var PresenceStatusSchema = object({
61103
61473
  gps: GpsLocationSchema.nullable(),
61104
61474
  /** Optional battery level of the tracking device (0..100). Null
61105
61475
  * when not reported. */
61106
- batteryPercent: number().min(0).max(100).nullable(),
61476
+ batteryPercent: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
61107
61477
  /** Ms epoch when the slice was last updated. */
61108
61478
  lastChangedAt: number()
61109
61479
  });
61110
61480
  DeviceType.Presence;
61111
61481
  object({
61112
- /** Current pressure in hPa. */
61113
- hpa: number(),
61482
+ /** Current pressure in hPa. `null` when the sample was refused (D393). */
61483
+ hpa: number().nullable().meta(readingMeta("pressure", { precision: 0 })),
61114
61484
  /** Ms epoch when the slice was last updated. */
61115
- lastFetchedAt: number(),
61116
- /** Live display unit from the upstream source (e.g. HA
61117
- * `attributes.unit_of_measurement`). The UI prefers this over the
61118
- * role's canonical unit. Absent → fall back to the canonical unit. */
61119
- unit: string().optional(),
61120
- /** Suggested decimal places for numeric display.
61121
- * Populated live from the upstream source when provided (e.g. HA
61122
- * `attributes.suggested_display_precision`). Falls back to
61123
- * auto-formatting when absent. */
61124
- precision: number().int().min(0).max(10).optional()
61485
+ lastFetchedAt: number()
61125
61486
  });
61126
61487
  DeviceType.Sensor;
61127
61488
  /**
@@ -61454,8 +61815,8 @@ DeviceType.Camera, method(PtzMoveCommandSchema.extend({ deviceId: number() }), _
61454
61815
  }), _void(), { kind: "mutation" });
61455
61816
  var PtzAutotrackSettingsSchema = object({
61456
61817
  targetType: string().describe("Vendor target string (people/vehicle/pet); empty = camera default"),
61457
- stopDelaySeconds: number().int().min(0).max(300),
61458
- disappearDelaySeconds: number().int().min(0).max(300)
61818
+ stopDelaySeconds: number().int().min(0).max(300).meta(readingMeta("duration")),
61819
+ disappearDelaySeconds: number().int().min(0).max(300).meta(readingMeta("duration"))
61459
61820
  });
61460
61821
  /**
61461
61822
  * One option the camera advertises as a valid `targetType`. Drivers
@@ -61512,7 +61873,7 @@ object({
61512
61873
  /** null = unknown — never coerced to false (D393). */
61513
61874
  running: boolean().nullable(),
61514
61875
  /** Epoch ms the current boolean began; null while `running` is null. */
61515
- since: number().nullable(),
61876
+ since: number().nullable().meta(readingMeta("none")),
61516
61877
  source: RunningStateSourceSchema.meta({ label: "Source" }),
61517
61878
  phase: string().nullable(),
61518
61879
  /** null until a reading has been published (D393). */
@@ -62710,9 +63071,9 @@ var RecordTriggerSchema = _enum([
62710
63071
  */
62711
63072
  var RecordWindowSchema = object({
62712
63073
  trigger: RecordTriggerSchema,
62713
- day: number().int().min(0).max(6),
62714
- startMinute: number().int().min(0).max(1439),
62715
- endMinute: number().int().min(1).max(1440)
63074
+ day: number().int().min(0).max(6).meta(readingMeta("none")),
63075
+ startMinute: number().int().min(0).max(1439).meta(readingMeta("none")),
63076
+ endMinute: number().int().min(1).max(1440).meta(readingMeta("none"))
62716
63077
  });
62717
63078
  /** Status of one physical volume, as the camera itself describes it. */
62718
63079
  var OnboardStorageVolumeSchema = object({
@@ -62781,10 +63142,10 @@ object({
62781
63142
  /** Master "record to the card at all" switch. */
62782
63143
  enabled: boolean().nullable(),
62783
63144
  overwriteWhenFull: boolean().nullable(),
62784
- preRecordSec: number().nullable(),
62785
- postRecordSec: number().nullable(),
63145
+ preRecordSec: number().nullable().meta(readingMeta("duration")),
63146
+ postRecordSec: number().nullable().meta(readingMeta("duration")),
62786
63147
  /** Length of one recorded file, in minutes. */
62787
- segmentMinutes: number().nullable(),
63148
+ segmentMinutes: number().nullable().meta(readingMeta("none")),
62788
63149
  /** The primary track's weekly windows, flattened. */
62789
63150
  windows: array(RecordWindowSchema),
62790
63151
  /**
@@ -62800,7 +63161,7 @@ object({
62800
63161
  * provider reporting a non-zero count also reports the schedule as not
62801
63162
  * writable.
62802
63163
  */
62803
- unreadableWindows: number(),
63164
+ unreadableWindows: number().meta(readingMeta("count")),
62804
63165
  /**
62805
63166
  * The camera is scheduled to record and has NO usable storage.
62806
63167
  *
@@ -63437,7 +63798,7 @@ var CamStreamDescriptorSchema = object({
63437
63798
  url: string().optional(),
63438
63799
  codec: string().optional(),
63439
63800
  resolution: CamStreamResolutionSchema.optional(),
63440
- fps: number().positive().optional(),
63801
+ fps: number().positive().optional().meta(readingMeta("rate")),
63441
63802
  label: string().optional(),
63442
63803
  /** Device-level features (e.g. `battery-operated`) — drives broker policy. */
63443
63804
  deviceFeatures: array(string()).optional(),
@@ -63467,18 +63828,18 @@ var StreamProfileSchema = _enum([
63467
63828
  ]);
63468
63829
  /** The current encoding config of one stream profile. */
63469
63830
  var StreamProfileConfigSchema = object({
63470
- width: number(),
63471
- height: number(),
63831
+ width: number().meta(readingMeta("none")),
63832
+ height: number().meta(readingMeta("none")),
63472
63833
  codec: _enum(["h264", "h265"]),
63473
- framerate: number(),
63474
- bitrate: number(),
63834
+ framerate: number().meta(readingMeta("rate")),
63835
+ bitrate: number().meta(readingMeta("bitrate")),
63475
63836
  bitrateMode: _enum(["vbr", "cbr"]).optional(),
63476
63837
  encoderProfile: _enum([
63477
63838
  "high",
63478
63839
  "main",
63479
63840
  "baseline"
63480
63841
  ]).optional(),
63481
- gop: number().optional(),
63842
+ gop: number().optional().meta(readingMeta("none")),
63482
63843
  /**
63483
63844
  * Whether THIS profile currently carries an audio track. READ-ONLY here.
63484
63845
  *
@@ -64132,35 +64493,21 @@ DeviceType.Sensor;
64132
64493
  * entries with `device_class: temperature` and any future native
64133
64494
  * thermometer.
64134
64495
  *
64135
- * Unit normalisation: providers convert to Celsius before storing.
64136
- * The slice value is always Celsius so cross-cap aggregators
64137
- * (climate-control's `currentTemp`, energy analytics) can compose
64138
- * without per-source unit fixups. The canonical display unit (`°C`) is
64139
- * a descriptor constant in the UI (ROLE_DESCRIPTOR), not stored in
64140
- * `sourceInfo`.
64496
+ * The number is Celsius (D944). Providers convert on ingest. A failed
64497
+ * conversion is `null`, never a guess. Display unit is a read-time preference.
64141
64498
  *
64142
64499
  * Status `lastFetchedAt` lets staleness-aware consumers detect a
64143
64500
  * frozen feed (provider hung) distinct from a "temperature hasn't
64144
64501
  * changed" steady state.
64145
64502
  */
64146
64503
  var TemperatureSensorStatusSchema = object({
64147
- /** Current temperature in Celsius. */
64148
- celsius: number().meta({
64149
- unit: "°C",
64504
+ /** Current temperature in Celsius. `null` when the sample was refused (D393). */
64505
+ celsius: number().nullable().meta(readingMeta("temperature", {
64506
+ precision: 1,
64150
64507
  label: "Temperature"
64151
- }),
64508
+ })),
64152
64509
  /** Ms epoch when the slice was last updated (push or poll). */
64153
- lastFetchedAt: number(),
64154
- /** Live display unit from the upstream source (e.g. HA
64155
- * `attributes.unit_of_measurement`). The UI prefers this over the
64156
- * role's canonical unit, so a Fahrenheit feed renders '°F' not '°C'.
64157
- * Absent → the UI falls back to the role's canonical unit. */
64158
- unit: string().optional(),
64159
- /** Suggested decimal places for numeric display.
64160
- * Populated live from the upstream source when provided (e.g. HA
64161
- * `attributes.suggested_display_precision`). Falls back to
64162
- * auto-formatting when absent. */
64163
- precision: number().int().min(0).max(10).optional()
64510
+ lastFetchedAt: number()
64164
64511
  });
64165
64512
  DeviceType.Sensor, DeviceType.Thermostat;
64166
64513
  /**
@@ -64412,16 +64759,16 @@ object({
64412
64759
  ]),
64413
64760
  /** 0..100 battery percentage. Null when the device has no battery
64414
64761
  * reading. */
64415
- batteryLevel: number().min(0).max(100).nullable(),
64762
+ batteryLevel: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
64416
64763
  /** Current fan-speed token (provider-verbatim). Null when unknown or
64417
64764
  * the vacuum has no speed control. */
64418
64765
  fanSpeed: string().nullable(),
64419
64766
  /** Speed tokens the hardware accepts — drives the UI selector. */
64420
64767
  availableFanSpeeds: array(string()),
64421
64768
  /** 0..100 cleaning-completion percentage of the current task, or null. */
64422
- progressPercent: number().min(0).max(100).nullable(),
64769
+ progressPercent: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
64423
64770
  /** Current error code (0 / null = no error). */
64424
- errorCode: number().nullable(),
64771
+ errorCode: number().nullable().meta(readingMeta("none")),
64425
64772
  /** Human label for {@link errorCode}, or null when none / undecodable. */
64426
64773
  errorLabel: string().nullable(),
64427
64774
  /** Ms epoch when the slice was last updated. */
@@ -64460,7 +64807,7 @@ object({
64460
64807
  ]),
64461
64808
  /** 0 = fully closed, 100 = fully open. Null when the device has no
64462
64809
  * intermediate position surface. */
64463
- position: number().min(0).max(100).nullable(),
64810
+ position: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
64464
64811
  /** Ms epoch when the slice was last updated. */
64465
64812
  lastChangedAt: number()
64466
64813
  });
@@ -64488,9 +64835,9 @@ object({
64488
64835
  DeviceType.Sensor;
64489
64836
  object({
64490
64837
  /** Current measured temperature. Null when not reported. */
64491
- currentTemp: number().nullable(),
64838
+ currentTemp: number().nullable().meta(readingMeta("temperature")),
64492
64839
  /** Target temperature setpoint. Null when no setpoint surface. */
64493
- targetTemp: number().nullable(),
64840
+ targetTemp: number().nullable().meta(readingMeta("temperature")),
64494
64841
  /** Active operation mode = HA `state` (`eco` / `electric` / `gas` /
64495
64842
  * `heat_pump` / `high_demand` / `performance` / `off`). Null when the
64496
64843
  * device reports an unknown state. */
@@ -64501,9 +64848,9 @@ object({
64501
64848
  * has no away surface. */
64502
64849
  away: boolean().nullable(),
64503
64850
  /** HA `min_temp` attribute. Null when not reported. */
64504
- minTemp: number().nullable(),
64851
+ minTemp: number().nullable().meta(readingMeta("temperature")),
64505
64852
  /** HA `max_temp` attribute. Null when not reported. */
64506
- maxTemp: number().nullable(),
64853
+ maxTemp: number().nullable().meta(readingMeta("temperature")),
64507
64854
  /** Ms epoch when the slice was last updated. */
64508
64855
  lastChangedAt: number()
64509
64856
  });
@@ -64527,25 +64874,18 @@ DeviceType.WaterHeater, method(object({
64527
64874
  auth: "protected"
64528
64875
  });
64529
64876
  object({
64530
- /** Verbatim HA condition state (`sunny`, `cloudy`, `rainy`, …). Null
64531
- * when no condition has been reported yet. */
64877
+ /** Verbatim condition state (`sunny`, `cloudy`, `rainy`, …). Null when none yet. */
64532
64878
  condition: string().nullable(),
64533
- /** Current temperature in the reported unit. Null when not provided. */
64534
- temperature: number().nullable(),
64535
- /** Temperature unit string (e.g. `°C` / `°F`). Null when not provided. */
64536
- temperatureUnit: string().nullable(),
64879
+ /** Current temperature in Celsius. Null when not provided or refused. */
64880
+ temperature: number().nullable().meta(readingMeta("temperature", { precision: 1 })),
64537
64881
  /** Relative humidity (0..100). Null when not provided. */
64538
- humidity: number().min(0).max(100).nullable(),
64539
- /** Barometric pressure in the reported unit. Null when not provided. */
64540
- pressure: number().nullable(),
64541
- /** Pressure unit string (e.g. `hPa` / `inHg`). Null when not provided. */
64542
- pressureUnit: string().nullable(),
64543
- /** Wind speed in the reported unit. Null when not provided. */
64544
- windSpeed: number().nullable(),
64545
- /** Wind-speed unit string (e.g. `km/h` / `mph`). Null when not provided. */
64546
- windSpeedUnit: string().nullable(),
64882
+ humidity: number().min(0).max(100).nullable().meta(readingMeta("humidity")),
64883
+ /** Barometric pressure in hPa. Null when not provided or refused. */
64884
+ pressure: number().nullable().meta(readingMeta("pressure")),
64885
+ /** Wind speed in metres per second. Null when not provided or refused. */
64886
+ windSpeed: number().nullable().meta(readingMeta("speed")),
64547
64887
  /** Wind bearing in degrees (0..360, meteorological). Null when not provided. */
64548
- windBearing: number().nullable(),
64888
+ windBearing: number().nullable().meta(readingMeta("angle")),
64549
64889
  /** Ms epoch when the slice was last updated. */
64550
64890
  lastFetchedAt: number()
64551
64891
  });
@@ -65457,6 +65797,13 @@ Object.freeze({
65457
65797
  access: "view",
65458
65798
  role: "admin"
65459
65799
  },
65800
+ "addons.getPackageDocs": {
65801
+ capName: "addons",
65802
+ capScope: "system",
65803
+ addonId: null,
65804
+ access: "view",
65805
+ role: "admin"
65806
+ },
65460
65807
  "addons.getVersions": {
65461
65808
  capName: "addons",
65462
65809
  capScope: "system",
@@ -68565,6 +68912,20 @@ Object.freeze({
68565
68912
  access: "view",
68566
68913
  role: "viewer"
68567
68914
  },
68915
+ "groupCommands.getStatus": {
68916
+ capName: "group-commands",
68917
+ capScope: "device",
68918
+ addonId: null,
68919
+ access: "view",
68920
+ role: "viewer"
68921
+ },
68922
+ "groupStatus.getStatus": {
68923
+ capName: "group-status",
68924
+ capScope: "device",
68925
+ addonId: null,
68926
+ access: "view",
68927
+ role: "viewer"
68928
+ },
68568
68929
  "heatingValve.getStatus": {
68569
68930
  capName: "heating-valve",
68570
68931
  capScope: "device",
@@ -78387,6 +78748,37 @@ var SENSOR_CAP_VOCABULARY = {
78387
78748
  icon: "flame"
78388
78749
  }]
78389
78750
  },
78751
+ "group-commands": {
78752
+ scope: "device",
78753
+ noun: t("Group command", "Comando di gruppo")
78754
+ },
78755
+ "group-status": {
78756
+ scope: "device",
78757
+ noun: t("Group", "Gruppo"),
78758
+ state: [
78759
+ {
78760
+ kind: "numeric",
78761
+ field: "included",
78762
+ quantity: t("the members reporting", "i membri che rispondono"),
78763
+ label: t("Reporting", "Rispondono"),
78764
+ icon: "users"
78765
+ },
78766
+ {
78767
+ kind: "numeric",
78768
+ field: "excluded",
78769
+ quantity: t("the members left out", "i membri esclusi"),
78770
+ label: t("Excluded", "Esclusi"),
78771
+ icon: "users"
78772
+ },
78773
+ {
78774
+ kind: "numeric",
78775
+ field: "total",
78776
+ quantity: t("the member count", "il numero di membri"),
78777
+ label: t("Members", "Membri"),
78778
+ icon: "sigma"
78779
+ }
78780
+ ]
78781
+ },
78390
78782
  "humidity-sensor": {
78391
78783
  scope: "device",
78392
78784
  noun: t("Humidity", "Umidità"),
@@ -78420,7 +78812,6 @@ var SENSOR_CAP_VOCABULARY = {
78420
78812
  field: "value",
78421
78813
  quantity: t("the reading", "il valore"),
78422
78814
  label: t("Reading", "Valore"),
78423
- unitField: "unit",
78424
78815
  icon: "gauge"
78425
78816
  }]
78426
78817
  },
@@ -78556,7 +78947,7 @@ var SENSOR_CAP_VOCABULARY = {
78556
78947
  field: "temperature",
78557
78948
  quantity: t("the outdoor temperature", "la temperatura esterna"),
78558
78949
  label: t("Temperature", "Temperatura"),
78559
- unitField: "temperatureUnit",
78950
+ unit: "°C",
78560
78951
  icon: "thermometer"
78561
78952
  },
78562
78953
  {
@@ -78572,7 +78963,7 @@ var SENSOR_CAP_VOCABULARY = {
78572
78963
  field: "windSpeed",
78573
78964
  quantity: t("the wind speed", "la velocità del vento"),
78574
78965
  label: t("Wind", "Vento"),
78575
- unitField: "windSpeedUnit",
78966
+ unit: "m/s",
78576
78967
  icon: "wind"
78577
78968
  },
78578
78969
  {
@@ -78580,7 +78971,7 @@ var SENSOR_CAP_VOCABULARY = {
78580
78971
  field: "pressure",
78581
78972
  quantity: t("the air pressure", "la pressione atmosferica"),
78582
78973
  label: t("Pressure", "Pressione"),
78583
- unitField: "pressureUnit",
78974
+ unit: "hPa",
78584
78975
  icon: "gauge"
78585
78976
  }
78586
78977
  ]
@@ -79853,6 +80244,16 @@ Object.freeze({
79853
80244
  form: "single",
79854
80245
  optional: false
79855
80246
  }],
80247
+ "groupCommands.getStatus": [{
80248
+ name: "deviceId",
80249
+ form: "single",
80250
+ optional: false
80251
+ }],
80252
+ "groupStatus.getStatus": [{
80253
+ name: "deviceId",
80254
+ form: "single",
80255
+ optional: false
80256
+ }],
79856
80257
  "heatingValve.getStatus": [{
79857
80258
  name: "deviceId",
79858
80259
  form: "single",
@@ -81837,6 +82238,8 @@ new Map(Object.entries({
81837
82238
  "detection-blind": "device-events",
81838
82239
  "motion-noisy": "device-events",
81839
82240
  "motion-calm": "device-events",
82241
+ "package-llm-silent": "device-events",
82242
+ "package-llm-answered": "device-events",
81840
82243
  "recording-stalled": "device-events",
81841
82244
  "recording-healthy": "device-events",
81842
82245
  "recording-degraded": "device-events",
@@ -81920,6 +82323,12 @@ var NC_SYSTEM_EVENT_KIND_GROUP_SPECS = [
81920
82323
  label: "Motion without a subject",
81921
82324
  kinds: ["motion-noisy", "motion-calm"]
81922
82325
  },
82326
+ {
82327
+ id: "package-llm",
82328
+ family: "device-events",
82329
+ label: "Package confirm",
82330
+ kinds: ["package-llm-silent", "package-llm-answered"]
82331
+ },
81923
82332
  {
81924
82333
  id: "recording",
81925
82334
  family: "device-events",
@@ -82101,6 +82510,8 @@ var DEVICE_EVENTS = [
82101
82510
  "detection-blind",
82102
82511
  "motion-noisy",
82103
82512
  "motion-calm",
82513
+ "package-llm-silent",
82514
+ "package-llm-answered",
82104
82515
  "recording-stalled",
82105
82516
  "recording-healthy",
82106
82517
  "recording-degraded",
@@ -82369,6 +82780,15 @@ new Map([
82369
82780
  snapshotLabel: "Cameras with constant motion now",
82370
82781
  snapshotSection: null
82371
82782
  },
82783
+ {
82784
+ id: "package-llm-confirm",
82785
+ family: "device-events",
82786
+ label: "Package confirm (not answering / answering again)",
82787
+ bad: ["package-llm-silent"],
82788
+ recovery: ["package-llm-answered"],
82789
+ snapshotLabel: "Cameras whose package confirm is not answering",
82790
+ snapshotSection: null
82791
+ },
82372
82792
  {
82373
82793
  id: "recording-health",
82374
82794
  family: "device-events",
@@ -84768,14 +85188,15 @@ var temperatureAdapter = {
84768
85188
  }),
84769
85189
  properties: (_cap, slice) => {
84770
85190
  const p = TemperatureSensorStatusSchema.pick({ celsius: true }).safeParse(slice);
84771
- return p.success ? [{
85191
+ if (!p.success || p.data.celsius === null) return [];
85192
+ return [{
84772
85193
  namespace: "Alexa.TemperatureSensor",
84773
85194
  name: "temperature",
84774
85195
  value: {
84775
85196
  value: Math.round(p.data.celsius * 10) / 10,
84776
85197
  scale: "CELSIUS"
84777
85198
  }
84778
- }] : [];
85199
+ }];
84779
85200
  },
84780
85201
  directives: [],
84781
85202
  shaping: () => ({
@@ -85518,11 +85939,12 @@ var humidityAdapter = {
85518
85939
  }),
85519
85940
  properties: (_cap, slice) => {
85520
85941
  const p = HumiditySensorStatusSchema.pick({ percent: true }).safeParse(slice);
85521
- return p.success ? [{
85942
+ if (!p.success || p.data.percent === null) return [];
85943
+ return [{
85522
85944
  namespace: "Alexa.HumiditySensor",
85523
85945
  name: "relativeHumidity",
85524
85946
  value: { value: Math.max(0, Math.min(100, p.data.percent)) }
85525
- }] : [];
85947
+ }];
85526
85948
  },
85527
85949
  directives: [],
85528
85950
  shaping: () => ({