@camstack/addon-terminal 0.1.153 → 0.1.154

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/addon.mjs CHANGED
@@ -8,7 +8,7 @@ import { createServer } from "node:http";
8
8
  //#region \0rolldown/runtime.js
9
9
  var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
10
10
  //#endregion
11
- //#region ../types/dist/event-category-DHXxB8t9.mjs
11
+ //#region ../types/dist/event-category-CT-hz5Rb.mjs
12
12
  var EventCategory = /* @__PURE__ */ function(EventCategory) {
13
13
  EventCategory["SystemBoot"] = "system.boot";
14
14
  EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -334,6 +334,14 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
334
334
  /** The recovery edge of {@link PipelineMotionNoisy}: the motion fell back, or a detection arrived. */
335
335
  EventCategory["PipelineMotionCalm"] = "pipeline.motion-calm";
336
336
  /**
337
+ * A camera's package LLM confirm has failed closed three times in a row
338
+ * (D931, 2026-10-26). One edge per camera until
339
+ * {@link PipelinePackageLlmAnswered}.
340
+ */
341
+ EventCategory["PipelinePackageLlmSilent"] = "pipeline.package-llm-silent";
342
+ /** The recovery edge of {@link PipelinePackageLlmSilent}: a confirm returned yes or no. */
343
+ EventCategory["PipelinePackageLlmAnswered"] = "pipeline.package-llm-answered";
344
+ /**
337
345
  * Per-camera pipeline config was mutated by the orchestrator
338
346
  * (a settings change via `setAgentInferenceDevices` /
339
347
  * `setCameraStepToggle` / `setCameraStepSettings`). Orchestrator
@@ -5443,7 +5451,7 @@ var ZodIssueCode = {
5443
5451
  var ZodFirstPartyTypeKind;
5444
5452
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5445
5453
  //#endregion
5446
- //#region ../types/dist/sleep-BErAxhul.mjs
5454
+ //#region ../types/dist/sleep-bykKrTgu.mjs
5447
5455
  /**
5448
5456
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5449
5457
  * window to float samples (D455).
@@ -7997,6 +8005,99 @@ var RecordKindDeclarationSchema = object({
7997
8005
  }).strict();
7998
8006
  /** The kind names: lower-case, dash separated, short enough for an index name. */
7999
8007
  var RecordKindNameSchema = string().regex(/^[a-z][a-z0-9-]{0,47}$/);
8008
+ var READING_QUANTITIES = [
8009
+ "temperature",
8010
+ "pressure",
8011
+ "speed",
8012
+ "precipitation",
8013
+ "precipitation-rate",
8014
+ "length",
8015
+ "area",
8016
+ "illuminance",
8017
+ "irradiance",
8018
+ "power",
8019
+ "energy",
8020
+ "voltage",
8021
+ "current",
8022
+ "apparent-power",
8023
+ "humidity",
8024
+ "percentage",
8025
+ "concentration-volume",
8026
+ "concentration-mass",
8027
+ "concentration-ppb",
8028
+ "volume",
8029
+ "duration",
8030
+ "duration-ms",
8031
+ "information",
8032
+ "sound-level",
8033
+ "signal-level",
8034
+ "colour-temperature",
8035
+ "angle",
8036
+ "bitrate",
8037
+ "rate",
8038
+ "mass",
8039
+ "index",
8040
+ "ratio",
8041
+ "count",
8042
+ "none",
8043
+ "device"
8044
+ ];
8045
+ var ReadingQuantitySchema = _enum(READING_QUANTITIES);
8046
+ new Set(READING_QUANTITIES);
8047
+ /**
8048
+ * Stored unit symbol for a quantity. `none` means the number is dimensionless
8049
+ * (or an index / ratio / count). `device` means the cap has no single unit.
8050
+ */
8051
+ var QUANTITY_BASE = {
8052
+ temperature: "°C",
8053
+ pressure: "hPa",
8054
+ speed: "m/s",
8055
+ precipitation: "mm",
8056
+ "precipitation-rate": "mm/h",
8057
+ length: "m",
8058
+ area: "m²",
8059
+ illuminance: "lx",
8060
+ irradiance: "W/m²",
8061
+ power: "W",
8062
+ energy: "kWh",
8063
+ voltage: "V",
8064
+ current: "A",
8065
+ "apparent-power": "VA",
8066
+ humidity: "%",
8067
+ percentage: "%",
8068
+ "concentration-volume": "ppm",
8069
+ "concentration-mass": "µg/m³",
8070
+ "concentration-ppb": "ppb",
8071
+ volume: "L",
8072
+ duration: "s",
8073
+ "duration-ms": "ms",
8074
+ information: "B",
8075
+ "sound-level": "dBFS",
8076
+ "signal-level": "dBm",
8077
+ "colour-temperature": "mired",
8078
+ angle: "°",
8079
+ bitrate: "kbps",
8080
+ rate: "fps",
8081
+ mass: "kg",
8082
+ index: "none",
8083
+ ratio: "none",
8084
+ count: "none",
8085
+ none: "none",
8086
+ device: "device"
8087
+ };
8088
+ /** The stored unit, or `undefined` when the quantity has no unit symbol. */
8089
+ function baseUnitOf(quantity) {
8090
+ const symbol = QUANTITY_BASE[quantity];
8091
+ if (symbol === "none" || symbol === "device") return void 0;
8092
+ return symbol;
8093
+ }
8094
+ function readingMeta(quantity, extras) {
8095
+ return {
8096
+ quantity,
8097
+ ...extras?.precision !== void 0 ? { precision: extras.precision } : {},
8098
+ ...extras?.label !== void 0 ? { label: extras.label } : {}
8099
+ };
8100
+ }
8000
8101
  /** Shared Zod schemas used across streaming capabilities. */
8001
8102
  var CamProfileSchema = _enum([
8002
8103
  "high",
@@ -8024,8 +8125,8 @@ var CamStreamKindSchema = _enum([
8024
8125
  "derived"
8025
8126
  ]);
8026
8127
  var CamStreamResolutionSchema = object({
8027
- width: number().int().positive(),
8028
- height: number().int().positive()
8128
+ width: number().int().positive().meta(readingMeta("none")),
8129
+ height: number().int().positive().meta(readingMeta("none"))
8029
8130
  });
8030
8131
  var CameraStreamSchema = object({
8031
8132
  /** Stable, provider-assigned id unique within the (deviceId) scope. */
@@ -8602,6 +8703,8 @@ var CAP_NAMES = Object.freeze([
8602
8703
  "filesystem-browse",
8603
8704
  "flood",
8604
8705
  "gas",
8706
+ "group-commands",
8707
+ "group-status",
8605
8708
  "heating-valve",
8606
8709
  "humidifier",
8607
8710
  "humidity-sensor",
@@ -8731,14 +8834,6 @@ Object.freeze({
8731
8834
  {
8732
8835
  "path": "aqi",
8733
8836
  "valueType": "number"
8734
- },
8735
- {
8736
- "path": "unit",
8737
- "valueType": "string"
8738
- },
8739
- {
8740
- "path": "precision",
8741
- "valueType": "number"
8742
8837
  }
8743
8838
  ],
8744
8839
  "alarm-panel": [
@@ -8774,20 +8869,10 @@ Object.freeze({
8774
8869
  "valueType": "boolean"
8775
8870
  }
8776
8871
  ],
8777
- "ambient-light-sensor": [
8778
- {
8779
- "path": "lux",
8780
- "valueType": "number"
8781
- },
8782
- {
8783
- "path": "unit",
8784
- "valueType": "string"
8785
- },
8786
- {
8787
- "path": "precision",
8788
- "valueType": "number"
8789
- }
8790
- ],
8872
+ "ambient-light-sensor": [{
8873
+ "path": "lux",
8874
+ "valueType": "number"
8875
+ }],
8791
8876
  "audio-metrics": [
8792
8877
  {
8793
8878
  "path": "ts",
@@ -8867,6 +8952,10 @@ Object.freeze({
8867
8952
  "path": "lastUpdated",
8868
8953
  "valueType": "number"
8869
8954
  },
8955
+ {
8956
+ "path": "volts",
8957
+ "valueType": "number"
8958
+ },
8870
8959
  {
8871
8960
  "path": "lastContactAt",
8872
8961
  "valueType": "number"
@@ -9109,10 +9198,6 @@ Object.freeze({
9109
9198
  "datetime"
9110
9199
  ]
9111
9200
  },
9112
- {
9113
- "path": "unit",
9114
- "valueType": "string"
9115
- },
9116
9201
  {
9117
9202
  "path": "min",
9118
9203
  "valueType": "number"
@@ -9124,19 +9209,6 @@ Object.freeze({
9124
9209
  {
9125
9210
  "path": "step",
9126
9211
  "valueType": "number"
9127
- },
9128
- {
9129
- "path": "precision",
9130
- "valueType": "number"
9131
- },
9132
- {
9133
- "path": "format",
9134
- "valueType": "enum",
9135
- "enumValues": [
9136
- "date",
9137
- "time",
9138
- "datetime"
9139
- ]
9140
9212
  }
9141
9213
  ],
9142
9214
  "cover": [
@@ -9377,13 +9449,8 @@ Object.freeze({
9377
9449
  "path": "value",
9378
9450
  "valueType": "string"
9379
9451
  }, {
9380
- "path": "format",
9381
- "valueType": "enum",
9382
- "enumValues": [
9383
- "date",
9384
- "time",
9385
- "datetime"
9386
- ]
9452
+ "path": "timestamp",
9453
+ "valueType": "boolean"
9387
9454
  }],
9388
9455
  "event-emitter": [
9389
9456
  {
@@ -9456,6 +9523,20 @@ Object.freeze({
9456
9523
  "path": "detected",
9457
9524
  "valueType": "boolean"
9458
9525
  }],
9526
+ "group-status": [
9527
+ {
9528
+ "path": "included",
9529
+ "valueType": "number"
9530
+ },
9531
+ {
9532
+ "path": "excluded",
9533
+ "valueType": "number"
9534
+ },
9535
+ {
9536
+ "path": "total",
9537
+ "valueType": "number"
9538
+ }
9539
+ ],
9459
9540
  "heating-valve": [{
9460
9541
  "path": "position",
9461
9542
  "valueType": "number"
@@ -9490,20 +9571,10 @@ Object.freeze({
9490
9571
  "valueType": "number"
9491
9572
  }
9492
9573
  ],
9493
- "humidity-sensor": [
9494
- {
9495
- "path": "percent",
9496
- "valueType": "number"
9497
- },
9498
- {
9499
- "path": "unit",
9500
- "valueType": "string"
9501
- },
9502
- {
9503
- "path": "precision",
9504
- "valueType": "number"
9505
- }
9506
- ],
9574
+ "humidity-sensor": [{
9575
+ "path": "percent",
9576
+ "valueType": "number"
9577
+ }],
9507
9578
  "image": [{
9508
9579
  "path": "url",
9509
9580
  "valueType": "string"
@@ -9842,20 +9913,10 @@ Object.freeze({
9842
9913
  "valueType": "boolean"
9843
9914
  }
9844
9915
  ],
9845
- "numeric-sensor": [
9846
- {
9847
- "path": "value",
9848
- "valueType": "number"
9849
- },
9850
- {
9851
- "path": "unit",
9852
- "valueType": "string"
9853
- },
9854
- {
9855
- "path": "precision",
9856
- "valueType": "number"
9857
- }
9858
- ],
9916
+ "numeric-sensor": [{
9917
+ "path": "value",
9918
+ "valueType": "number"
9919
+ }],
9859
9920
  "pet-feeder": [
9860
9921
  {
9861
9922
  "path": "foodLevel",
@@ -9947,14 +10008,6 @@ Object.freeze({
9947
10008
  {
9948
10009
  "path": "powerFactor",
9949
10010
  "valueType": "number"
9950
- },
9951
- {
9952
- "path": "unit",
9953
- "valueType": "string"
9954
- },
9955
- {
9956
- "path": "precision",
9957
- "valueType": "number"
9958
10011
  }
9959
10012
  ],
9960
10013
  "presence": [
@@ -9983,20 +10036,10 @@ Object.freeze({
9983
10036
  "valueType": "number"
9984
10037
  }
9985
10038
  ],
9986
- "pressure-sensor": [
9987
- {
9988
- "path": "hpa",
9989
- "valueType": "number"
9990
- },
9991
- {
9992
- "path": "unit",
9993
- "valueType": "string"
9994
- },
9995
- {
9996
- "path": "precision",
9997
- "valueType": "number"
9998
- }
9999
- ],
10039
+ "pressure-sensor": [{
10040
+ "path": "hpa",
10041
+ "valueType": "number"
10042
+ }],
10000
10043
  "privacy-mask": [{
10001
10044
  "path": "enabled",
10002
10045
  "valueType": "boolean"
@@ -10307,20 +10350,10 @@ Object.freeze({
10307
10350
  "path": "tampered",
10308
10351
  "valueType": "boolean"
10309
10352
  }],
10310
- "temperature-sensor": [
10311
- {
10312
- "path": "celsius",
10313
- "valueType": "number"
10314
- },
10315
- {
10316
- "path": "unit",
10317
- "valueType": "string"
10318
- },
10319
- {
10320
- "path": "precision",
10321
- "valueType": "number"
10322
- }
10323
- ],
10353
+ "temperature-sensor": [{
10354
+ "path": "celsius",
10355
+ "valueType": "number"
10356
+ }],
10324
10357
  "update": [
10325
10358
  {
10326
10359
  "path": "currentVersion",
@@ -10431,10 +10464,6 @@ Object.freeze({
10431
10464
  "path": "temperature",
10432
10465
  "valueType": "number"
10433
10466
  },
10434
- {
10435
- "path": "temperatureUnit",
10436
- "valueType": "string"
10437
- },
10438
10467
  {
10439
10468
  "path": "humidity",
10440
10469
  "valueType": "number"
@@ -10443,18 +10472,10 @@ Object.freeze({
10443
10472
  "path": "pressure",
10444
10473
  "valueType": "number"
10445
10474
  },
10446
- {
10447
- "path": "pressureUnit",
10448
- "valueType": "string"
10449
- },
10450
10475
  {
10451
10476
  "path": "windSpeed",
10452
10477
  "valueType": "number"
10453
10478
  },
10454
- {
10455
- "path": "windSpeedUnit",
10456
- "valueType": "string"
10457
- },
10458
10479
  {
10459
10480
  "path": "windBearing",
10460
10481
  "valueType": "number"
@@ -10857,7 +10878,7 @@ function errMsg(err) {
10857
10878
  return String(err);
10858
10879
  }
10859
10880
  //#endregion
10860
- //#region ../types/dist/composition-kEl9mevu.mjs
10881
+ //#region ../types/dist/composition-OhpuespA.mjs
10861
10882
  /**
10862
10883
  * The ffmpeg build every CamStack node downloads, per platform and arch.
10863
10884
  *
@@ -11612,15 +11633,74 @@ function validateExpressionSource(src) {
11612
11633
  }
11613
11634
  return null;
11614
11635
  }
11615
- /** A composed device's stableId is this prefix plus the block id. */
11616
- var COMPOSED_DEVICE_STABLE_ID_PREFIX = "composed-";
11617
- /** Longest snippet a `code` source may carry (slice 4). */
11618
- var MAX_COMPOSITION_CODE_LENGTH = 2e4;
11636
+ /**
11637
+ * A composition source identity: `(addonId, stableId)`, never a numeric device
11638
+ * id. Split out so helper schemas can name it without a cycle through
11639
+ * `composition.ts` (D659).
11640
+ */
11619
11641
  var CompositionSourceRefSchema = object({
11620
11642
  /** The owning addon; `stableId` is unique only within it. */
11621
11643
  addonId: string().min(1),
11622
11644
  stableId: string().min(1)
11623
11645
  });
11646
+ var GROUP_TEMPLATE_IDS = [
11647
+ "temperature",
11648
+ "humidity",
11649
+ "pressure",
11650
+ "illuminance",
11651
+ "power",
11652
+ "energy",
11653
+ "battery",
11654
+ "numeric",
11655
+ "motion",
11656
+ "contact",
11657
+ "leak",
11658
+ "smoke",
11659
+ "occupancy",
11660
+ "binary",
11661
+ "switch",
11662
+ "light"
11663
+ ];
11664
+ var NUMERIC_AGGREGATES = [
11665
+ "mean",
11666
+ "median",
11667
+ "min",
11668
+ "max",
11669
+ "sum"
11670
+ ];
11671
+ var BINARY_AGGREGATES = ["any", "all"];
11672
+ /** How an actuator group decides it is on. Unknown members never count as off. */
11673
+ var ACTIVE_CRITERIA = ["at-least-one", "all"];
11674
+ var AGGREGATE_REDUCERS = [
11675
+ "mean",
11676
+ "median",
11677
+ "min",
11678
+ "max",
11679
+ "sum",
11680
+ "any",
11681
+ "all"
11682
+ ];
11683
+ var GroupTemplateIdSchema = _enum(GROUP_TEMPLATE_IDS);
11684
+ var AggregateReducerSchema = _enum(AGGREGATE_REDUCERS);
11685
+ var ActiveCriterionSchema = _enum(ACTIVE_CRITERIA);
11686
+ /** One member. The field is stored so occupancy can name motion or binary. */
11687
+ var HelperMemberSchema = object({
11688
+ source: CompositionSourceRefSchema,
11689
+ cap: string().min(1),
11690
+ fieldPath: string().min(1)
11691
+ });
11692
+ var HelperSpecSchema = discriminatedUnion("kind", [object({
11693
+ kind: literal("group"),
11694
+ templateId: GroupTemplateIdSchema,
11695
+ aggregate: AggregateReducerSchema,
11696
+ members: array(HelperMemberSchema).min(1).max(64),
11697
+ /** Actuator groups only. Readings leave this unset. */
11698
+ active: ActiveCriterionSchema.optional()
11699
+ })]);
11700
+ /** A composed device's stableId is this prefix plus the block id. */
11701
+ var COMPOSED_DEVICE_STABLE_ID_PREFIX = "composed-";
11702
+ /** Longest snippet a `code` source may carry (slice 4). */
11703
+ var MAX_COMPOSITION_CODE_LENGTH = 2e4;
11624
11704
  /** One field of one capability of one source device. */
11625
11705
  var CompositionFieldReadSchema = object({
11626
11706
  source: CompositionSourceRefSchema,
@@ -11664,7 +11744,33 @@ var CompositionCodeSourceSchema = object({
11664
11744
  var CompositionFieldSourceSchema = discriminatedUnion("kind", [
11665
11745
  CompositionFromSourceSchema,
11666
11746
  CompositionExpressionSourceSchema,
11667
- CompositionCodeSourceSchema
11747
+ CompositionCodeSourceSchema,
11748
+ object({
11749
+ kind: literal("aggregate"),
11750
+ reducer: _enum([
11751
+ "mean",
11752
+ "median",
11753
+ "min",
11754
+ "max",
11755
+ "sum",
11756
+ "any",
11757
+ "all"
11758
+ ]),
11759
+ reads: array(CompositionFieldReadSchema).min(1).max(64),
11760
+ /** `value` is the reading; the others are the member counts. */
11761
+ publish: _enum([
11762
+ "value",
11763
+ "included",
11764
+ "excluded",
11765
+ "total"
11766
+ ]),
11767
+ /** What a `value` publish does when nobody is included. Counts ignore this. */
11768
+ empty: _enum([
11769
+ "null",
11770
+ "omit",
11771
+ "offline"
11772
+ ])
11773
+ })
11668
11774
  ]);
11669
11775
  var CompositionCommandTargetSchema = discriminatedUnion("kind", [object({
11670
11776
  kind: literal("forward"),
@@ -11710,7 +11816,13 @@ var CompositionSchema = object({
11710
11816
  kind: literal("existing"),
11711
11817
  device: CompositionSourceRefSchema
11712
11818
  })]),
11713
- features: array(CompositionFeatureSchema).min(1).max(16)
11819
+ features: array(CompositionFeatureSchema).min(1).max(16),
11820
+ /**
11821
+ * Present when the block is a helper template. Absent on a free
11822
+ * composition (the room example, device 4603). The editor reads this,
11823
+ * never the compiled features.
11824
+ */
11825
+ helper: HelperSpecSchema.optional()
11714
11826
  }).superRefine((composition, ctx) => {
11715
11827
  const seen = /* @__PURE__ */ new Set();
11716
11828
  composition.features.forEach((feature, index) => {
@@ -17950,7 +18062,11 @@ var CompositionProblemSchema = object({
17950
18062
  "item-field-reserved",
17951
18063
  "target-missing",
17952
18064
  "target-unreadable",
17953
- "not-replaceable"
18065
+ "not-replaceable",
18066
+ "native-capability-replace",
18067
+ "mixed-quantity",
18068
+ "helper-mismatch",
18069
+ "member-constraint"
17954
18070
  ]),
17955
18071
  path: string(),
17956
18072
  message: string()
@@ -17971,7 +18087,8 @@ var CompositionUnavailableModeSchema = _enum([
17971
18087
  "null",
17972
18088
  "offline",
17973
18089
  "unknown",
17974
- "release"
18090
+ "release",
18091
+ "omit"
17975
18092
  ]);
17976
18093
  /**
17977
18094
  * `derived` reads a source · `clock` reads only `now`, recomputed when a sibling
@@ -18008,9 +18125,11 @@ var CompositionFieldPlanSchema = object({
18008
18125
  reads: array(CompositionFieldReadSchema)
18009
18126
  });
18010
18127
  /**
18011
- * What a feature does to its target (D663): `new` builds a capability on a new
18012
- * device; on an existing device it `add`s a capability the device lacks, or
18013
- * `replace`s named fields of one it has natively.
18128
+ * What a feature does to its target (D663, D944): `new` builds a capability on a
18129
+ * new device; on an existing device it `add`s a capability the device lacks.
18130
+ * Replacing a capability the device already serves is refused
18131
+ * (`native-capability-replace`), not planned. `replace` remains on the claim
18132
+ * wire for a claim the hub already holds.
18014
18133
  */
18015
18134
  var CompositionFeatureModeSchema = _enum([
18016
18135
  "new",
@@ -18183,6 +18302,275 @@ Object.freeze({
18183
18302
  result: ["number", "null"]
18184
18303
  }
18185
18304
  });
18305
+ /**
18306
+ * One catalog row per base reading a group helper can build (D944 §3).
18307
+ * Data, not a form default written into the block.
18308
+ */
18309
+ var NOW = {
18310
+ fieldPath: "lastFetchedAt",
18311
+ expr: "now"
18312
+ };
18313
+ var CHANGED = {
18314
+ fieldPath: "lastChangedAt",
18315
+ expr: "now"
18316
+ };
18317
+ function numeric(input) {
18318
+ return {
18319
+ ...input,
18320
+ family: "numeric",
18321
+ deviceType: DeviceType.Sensor,
18322
+ memberDeviceType: DeviceType.Sensor,
18323
+ commandCaps: [],
18324
+ baseUnit: baseUnitOf(input.quantity),
18325
+ aggregates: NUMERIC_AGGREGATES,
18326
+ accept: [{
18327
+ cap: input.outputCap,
18328
+ fieldPath: input.outputField
18329
+ }]
18330
+ };
18331
+ }
18332
+ function binary(input) {
18333
+ return {
18334
+ ...input,
18335
+ family: "binary",
18336
+ deviceType: DeviceType.Sensor,
18337
+ memberDeviceType: DeviceType.Sensor,
18338
+ commandCaps: [],
18339
+ quantity: "none",
18340
+ baseUnit: void 0,
18341
+ aggregates: BINARY_AGGREGATES,
18342
+ empty: "offline"
18343
+ };
18344
+ }
18345
+ var GROUP_TEMPLATES = [
18346
+ numeric({
18347
+ id: "temperature",
18348
+ summary: "Mean, median, min, max or sum of temperatures. Offline and unknown members are left out, never read as 0 °C.",
18349
+ role: DeviceRole.TemperatureSensor,
18350
+ outputCap: "temperature-sensor",
18351
+ outputField: "celsius",
18352
+ quantity: "temperature",
18353
+ defaultAggregate: "mean",
18354
+ empty: "null",
18355
+ companions: [NOW]
18356
+ }),
18357
+ numeric({
18358
+ id: "humidity",
18359
+ summary: "Humidity in percent. Offline and unknown members are left out, never read as 0 %.",
18360
+ role: DeviceRole.HumiditySensor,
18361
+ outputCap: "humidity-sensor",
18362
+ outputField: "percent",
18363
+ quantity: "humidity",
18364
+ defaultAggregate: "mean",
18365
+ empty: "null",
18366
+ companions: [NOW]
18367
+ }),
18368
+ numeric({
18369
+ id: "pressure",
18370
+ summary: "Pressure in hectopascals. Offline and unknown members are left out, never read as 0 hPa.",
18371
+ role: DeviceRole.PressureSensor,
18372
+ outputCap: "pressure-sensor",
18373
+ outputField: "hpa",
18374
+ quantity: "pressure",
18375
+ defaultAggregate: "mean",
18376
+ empty: "null",
18377
+ companions: [NOW]
18378
+ }),
18379
+ numeric({
18380
+ id: "illuminance",
18381
+ summary: "Illuminance in lux. Offline and unknown members are left out, never read as 0 lx.",
18382
+ role: DeviceRole.AmbientLightSensor,
18383
+ outputCap: "ambient-light-sensor",
18384
+ outputField: "lux",
18385
+ quantity: "illuminance",
18386
+ defaultAggregate: "mean",
18387
+ empty: "null",
18388
+ companions: [NOW]
18389
+ }),
18390
+ numeric({
18391
+ id: "power",
18392
+ summary: "Power in watts, summed by default. Nobody reporting omits the key rather than writing 0 W.",
18393
+ role: DeviceRole.PowerSensor,
18394
+ outputCap: "power-meter",
18395
+ outputField: "watts",
18396
+ quantity: "power",
18397
+ defaultAggregate: "sum",
18398
+ empty: "omit",
18399
+ companions: [NOW]
18400
+ }),
18401
+ numeric({
18402
+ id: "energy",
18403
+ summary: "Energy in kilowatt-hours, summed by default. Nobody reporting omits the key rather than writing 0 kWh.",
18404
+ role: DeviceRole.EnergySensor,
18405
+ outputCap: "power-meter",
18406
+ outputField: "kwhTotal",
18407
+ quantity: "energy",
18408
+ defaultAggregate: "sum",
18409
+ empty: "omit",
18410
+ companions: [NOW]
18411
+ }),
18412
+ numeric({
18413
+ id: "battery",
18414
+ summary: "Battery charge in percent. Offline and unknown members are left out, never read as 0 %.",
18415
+ role: DeviceRole.BatterySensor,
18416
+ outputCap: "battery",
18417
+ outputField: "percentage",
18418
+ quantity: "percentage",
18419
+ defaultAggregate: "mean",
18420
+ empty: "null",
18421
+ companions: [
18422
+ {
18423
+ fieldPath: "charging",
18424
+ expr: "\"unknown\""
18425
+ },
18426
+ {
18427
+ fieldPath: "sleeping",
18428
+ expr: "false"
18429
+ },
18430
+ {
18431
+ fieldPath: "lastUpdated",
18432
+ expr: "now"
18433
+ }
18434
+ ]
18435
+ }),
18436
+ numeric({
18437
+ id: "numeric",
18438
+ summary: "A numeric reading in the members’ shared quantity. Mixed quantities are refused. Nobody reporting publishes null, not 0.",
18439
+ role: DeviceRole.NumericSensor,
18440
+ outputCap: "numeric-sensor",
18441
+ outputField: "value",
18442
+ quantity: "device",
18443
+ defaultAggregate: "mean",
18444
+ empty: "null",
18445
+ companions: [NOW]
18446
+ }),
18447
+ binary({
18448
+ id: "motion",
18449
+ summary: "Any or all motion. Offline and unknown members are left out, never read as off. Nobody reporting takes the device offline.",
18450
+ role: DeviceRole.MotionSensor,
18451
+ outputCap: "motion",
18452
+ outputField: "detected",
18453
+ defaultAggregate: "any",
18454
+ accept: [{
18455
+ cap: "motion",
18456
+ fieldPath: "detected"
18457
+ }],
18458
+ companions: [{
18459
+ fieldPath: "lastDetectedAt",
18460
+ expr: "null"
18461
+ }, {
18462
+ fieldPath: "autoClearAfterMs",
18463
+ expr: "null"
18464
+ }]
18465
+ }),
18466
+ binary({
18467
+ id: "contact",
18468
+ summary: "Any or all open contacts. Offline and unknown members are left out, never read as closed.",
18469
+ role: DeviceRole.ContactSensor,
18470
+ outputCap: "contact",
18471
+ outputField: "entryOpen",
18472
+ defaultAggregate: "any",
18473
+ accept: [{
18474
+ cap: "contact",
18475
+ fieldPath: "entryOpen"
18476
+ }],
18477
+ companions: [CHANGED]
18478
+ }),
18479
+ binary({
18480
+ id: "leak",
18481
+ summary: "Any or all leak detections. Offline and unknown members are left out, never read as dry.",
18482
+ role: DeviceRole.LeakSensor,
18483
+ outputCap: "flood",
18484
+ outputField: "flooded",
18485
+ defaultAggregate: "any",
18486
+ accept: [{
18487
+ cap: "flood",
18488
+ fieldPath: "flooded"
18489
+ }],
18490
+ companions: [CHANGED]
18491
+ }),
18492
+ binary({
18493
+ id: "smoke",
18494
+ summary: "Any or all smoke detections. Offline and unknown members are left out, never read as clear.",
18495
+ role: DeviceRole.SmokeSensor,
18496
+ outputCap: "smoke",
18497
+ outputField: "detected",
18498
+ defaultAggregate: "any",
18499
+ accept: [{
18500
+ cap: "smoke",
18501
+ fieldPath: "detected"
18502
+ }],
18503
+ companions: [CHANGED]
18504
+ }),
18505
+ binary({
18506
+ id: "occupancy",
18507
+ summary: "Any or all of motion or binary sensors, published as a binary. Presence zones are not aggregated. Nobody reporting is offline, not off.",
18508
+ role: DeviceRole.BinarySensor,
18509
+ outputCap: "binary",
18510
+ outputField: "on",
18511
+ defaultAggregate: "any",
18512
+ accept: [{
18513
+ cap: "motion",
18514
+ fieldPath: "detected"
18515
+ }, {
18516
+ cap: "binary",
18517
+ fieldPath: "on"
18518
+ }],
18519
+ companions: [CHANGED]
18520
+ }),
18521
+ binary({
18522
+ id: "binary",
18523
+ summary: "Any or all generic binary sensors. Offline and unknown members are left out, never read as off.",
18524
+ role: DeviceRole.BinarySensor,
18525
+ outputCap: "binary",
18526
+ outputField: "on",
18527
+ defaultAggregate: "any",
18528
+ accept: [{
18529
+ cap: "binary",
18530
+ fieldPath: "on"
18531
+ }],
18532
+ companions: [CHANGED]
18533
+ }),
18534
+ actuator({
18535
+ id: "switch",
18536
+ 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.",
18537
+ deviceType: DeviceType.Switch,
18538
+ outputCap: "switch",
18539
+ commandCaps: ["switch"]
18540
+ }),
18541
+ actuator({
18542
+ id: "light",
18543
+ 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.",
18544
+ deviceType: DeviceType.Light,
18545
+ outputCap: "switch",
18546
+ commandCaps: [
18547
+ "switch",
18548
+ "brightness",
18549
+ "color"
18550
+ ]
18551
+ })
18552
+ ];
18553
+ function actuator(input) {
18554
+ return {
18555
+ ...input,
18556
+ family: "actuator",
18557
+ role: void 0,
18558
+ memberDeviceType: input.deviceType,
18559
+ outputField: "on",
18560
+ quantity: "none",
18561
+ baseUnit: void 0,
18562
+ aggregates: BINARY_AGGREGATES,
18563
+ defaultAggregate: "any",
18564
+ empty: "offline",
18565
+ accept: [{
18566
+ cap: "switch",
18567
+ fieldPath: "on"
18568
+ }],
18569
+ companions: [CHANGED]
18570
+ };
18571
+ }
18572
+ new Map(GROUP_TEMPLATES.map((template) => [template.id, template]));
18573
+ DeviceFeature.LightColorRgb, DeviceFeature.LightColorHsv, DeviceFeature.LightColorMired;
18186
18574
  `${COMPOSED_DEVICE_STABLE_ID_PREFIX}`;
18187
18575
  /**
18188
18576
  * What a composition may BUILD on a device type (G2, D676): the caps a new
@@ -19896,12 +20284,12 @@ method(object({ deviceId: number().int().nonnegative() }), DeviceAdminLinkSchema
19896
20284
  * providers detect renames by matching `uniqueId` and patch `id`
19897
20285
  * in-place so dispatch keeps working.
19898
20286
  *
19899
- * **Rendering metadata is NOT stored here.** Display fields (`unit`,
19900
- * `precision`) live in the cap STATUS SLICE so they flow live with every
19901
- * state push and are the single source of truth. The `device_class` tag is
19902
- * an HA-specific input that is consumed at the discovery boundary
19903
- * (`ha-domain-mapping`) to derive the CamStack `DeviceRole`; it is never
19904
- * stored after that point.
20287
+ * **Display unit and precision are NOT stored here.** They are a read-time
20288
+ * preference (D944). A polymorphic reading stores its `quantity` here once,
20289
+ * at adopt, and a date/time value stores `dateTimeShape` the same way —
20290
+ * neither is repeated on each sample. The `device_class` tag is an
20291
+ * HA-specific input consumed at the discovery boundary (`ha-domain-mapping`)
20292
+ * to derive the CamStack `DeviceRole`; it is never stored after that point.
19905
20293
  *
19906
20294
  * The `raw` escape hatch carries provider-specific attributes that don't
19907
20295
  * fit the structured slots (HA `attributes` whitelist, Reolink `deviceCache`
@@ -19915,6 +20303,14 @@ var SourceInfoSchema = object({
19915
20303
  /** Immutable upstream identifier when available (HA `unique_id`, … ).
19916
20304
  * Used to detect rename when `id` changes. */
19917
20305
  uniqueId: string().optional(),
20306
+ /** Quantity of a polymorphic reading, written once at adopt (D944). */
20307
+ quantity: ReadingQuantitySchema.optional(),
20308
+ /** Date / time / datetime shape of a string reading, written once at adopt. */
20309
+ dateTimeShape: _enum([
20310
+ "date",
20311
+ "time",
20312
+ "datetime"
20313
+ ]).optional(),
19918
20314
  /** Provider-specific extras that don't fit the structured slots.
19919
20315
  * Whitelist what goes here per provider — do NOT dump entire HA
19920
20316
  * 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(),
@@ -44782,8 +45179,8 @@ var MaskPolygonShapeSchema = object({
44782
45179
  /** Boolean cell grid — row-major, length === gridWidth*gridHeight. */
44783
45180
  var MaskGridShapeSchema = object({
44784
45181
  kind: literal("grid"),
44785
- gridWidth: number(),
44786
- gridHeight: number(),
45182
+ gridWidth: number().meta(readingMeta("none")),
45183
+ gridHeight: number().meta(readingMeta("none")),
44787
45184
  cells: array(boolean())
44788
45185
  });
44789
45186
  discriminatedUnion("kind", [
@@ -44895,6 +45292,8 @@ var NcSystemEventKindSchema = _enum([
44895
45292
  "detection-blind",
44896
45293
  "motion-noisy",
44897
45294
  "motion-calm",
45295
+ "package-llm-silent",
45296
+ "package-llm-answered",
44898
45297
  "recording-stalled",
44899
45298
  "recording-healthy",
44900
45299
  "recording-degraded",
@@ -56134,6 +56533,28 @@ var PackageVersionInfoSchema = object({
56134
56533
  deprecated: string().optional(),
56135
56534
  distTags: array(string()).readonly()
56136
56535
  });
56536
+ /**
56537
+ * One published document. `ok` is markdown from the registry. `missing` means
56538
+ * the registry answered and the file was not there. `error` is a registry or
56539
+ * tarball failure — never an empty string standing in for either.
56540
+ */
56541
+ var PackageDocBodySchema = discriminatedUnion("status", [
56542
+ object({
56543
+ status: literal("ok"),
56544
+ markdown: string()
56545
+ }),
56546
+ object({ status: literal("missing") }),
56547
+ object({
56548
+ status: literal("error"),
56549
+ message: string()
56550
+ })
56551
+ ]);
56552
+ var PackageDocsSchema = object({
56553
+ name: string(),
56554
+ version: string(),
56555
+ readme: PackageDocBodySchema,
56556
+ changelog: PackageDocBodySchema
56557
+ });
56137
56558
  var SearchResultSchema = object({
56138
56559
  name: string(),
56139
56560
  version: string(),
@@ -56352,7 +56773,10 @@ method(object({ nodeId: string().optional() }).optional(), array(AddonListItemSc
56352
56773
  }), object({ success: literal(true) }), {
56353
56774
  kind: "mutation",
56354
56775
  auth: "admin"
56355
- }), method(object({ name: string() }), array(PackageVersionInfoSchema).readonly()), method(object({ addonId: string() }), RestartAddonResultSchema, {
56776
+ }), method(object({ name: string() }), array(PackageVersionInfoSchema).readonly()), method(object({
56777
+ name: string().min(1),
56778
+ version: string().min(1).optional()
56779
+ }), PackageDocsSchema, { auth: "admin" }), method(object({ addonId: string() }), RestartAddonResultSchema, {
56356
56780
  kind: "mutation",
56357
56781
  auth: "admin"
56358
56782
  }), method(object({ packageName: string() }), object({ success: literal(true) }), {
@@ -56411,27 +56835,17 @@ method(object({ nodeId: string().optional() }).optional(), array(AddonListItemSc
56411
56835
  */
56412
56836
  var AirQualitySensorStatusSchema = object({
56413
56837
  /** Carbon dioxide concentration in ppm. */
56414
- co2Ppm: number().min(0).optional(),
56838
+ co2Ppm: number().min(0).optional().meta(readingMeta("concentration-volume")),
56415
56839
  /** Total volatile organic compounds in ppb. */
56416
- vocPpb: number().min(0).optional(),
56840
+ vocPpb: number().min(0).optional().meta(readingMeta("concentration-ppb")),
56417
56841
  /** Particulate matter ≤ 2.5 μm in µg/m³. */
56418
- pm25: number().min(0).optional(),
56842
+ pm25: number().min(0).optional().meta(readingMeta("concentration-mass")),
56419
56843
  /** Particulate matter ≤ 10 μm in µg/m³. */
56420
- pm10: number().min(0).optional(),
56844
+ pm10: number().min(0).optional().meta(readingMeta("concentration-mass")),
56421
56845
  /** Composite AQI value (typically 0..500). */
56422
- aqi: number().optional(),
56846
+ aqi: number().optional().meta(readingMeta("index")),
56423
56847
  /** Ms epoch when the slice was last updated. */
56424
- lastFetchedAt: number(),
56425
- /** Live display unit of the single metric this slice carries (e.g. HA
56426
- * `attributes.unit_of_measurement` → 'ppm' / 'ppb' / 'µg/m³'). Each
56427
- * upstream `sensor.*` entity surfaces ONE device_class, so one unit
56428
- * per slice is unambiguous. */
56429
- unit: string().optional(),
56430
- /** Suggested decimal places for numeric display.
56431
- * Populated live from the upstream source when provided (e.g. HA
56432
- * `attributes.suggested_display_precision`). Falls back to
56433
- * auto-formatting when absent. */
56434
- precision: number().int().min(0).max(10).optional()
56848
+ lastFetchedAt: number()
56435
56849
  });
56436
56850
  var airQualitySensorCapability = {
56437
56851
  name: "air-quality-sensor",
@@ -56468,12 +56882,12 @@ var airQualitySensorCapability = {
56468
56882
  },
56469
56883
  pm25: {
56470
56884
  kind: "gauge",
56471
- unit: "ug/m3",
56885
+ unit: "µg/m³",
56472
56886
  deadband: 1
56473
56887
  },
56474
56888
  pm10: {
56475
56889
  kind: "gauge",
56476
- unit: "ug/m3",
56890
+ unit: "µg/m³",
56477
56891
  deadband: 1
56478
56892
  },
56479
56893
  aqi: {
@@ -56491,22 +56905,13 @@ var airQualitySensorCapability = {
56491
56905
  * entries with `device_class: illuminance`.
56492
56906
  */
56493
56907
  var AmbientLightSensorStatusSchema = object({
56494
- /** Current illuminance in lux (lx). */
56495
- lux: number().min(0).meta({
56496
- unit: "lx",
56908
+ /** Current illuminance in lux (lx). `null` when the sample was refused (D393). */
56909
+ lux: number().min(0).nullable().meta(readingMeta("illuminance", {
56910
+ precision: 0,
56497
56911
  label: "Illuminance"
56498
- }),
56912
+ })),
56499
56913
  /** Ms epoch when the slice was last updated. */
56500
- lastFetchedAt: number(),
56501
- /** Live display unit from the upstream source (e.g. HA
56502
- * `attributes.unit_of_measurement`). The UI prefers this over the
56503
- * role's canonical unit. Absent → fall back to the canonical unit. */
56504
- unit: string().optional(),
56505
- /** Suggested decimal places for numeric display.
56506
- * Populated live from the upstream source when provided (e.g. HA
56507
- * `attributes.suggested_display_precision`). Falls back to
56508
- * auto-formatting when absent. */
56509
- precision: number().int().min(0).max(10).optional()
56914
+ lastFetchedAt: number()
56510
56915
  });
56511
56916
  var ambientLightSensorCapability = {
56512
56917
  name: "ambient-light-sensor",
@@ -56538,12 +56943,7 @@ var ambientLightSensorCapability = {
56538
56943
  } } },
56539
56944
  /** Clock fields: written, but excluded from the compare that decides
56540
56945
  * whether persisting is worth a SQLite commit. */
56541
- volatileStateFields: ["lastFetchedAt"],
56542
- customize: {
56543
- version: 1,
56544
- advanced: "derive",
56545
- targets: []
56546
- }
56946
+ volatileStateFields: ["lastFetchedAt"]
56547
56947
  };
56548
56948
  /**
56549
56949
  * Per-class audio metrics aggregated over a sliding window.
@@ -56770,10 +57170,7 @@ var BatteryStatusSchema = object({
56770
57170
  * Consumers must SKIP a null rather than coerce it — `battery-band` already
56771
57171
  * declines to band a non-finite reading, which is the correct shape.
56772
57172
  */
56773
- percentage: number().min(0).max(100).nullable().meta({
56774
- unit: "%",
56775
- label: "Charge"
56776
- }),
57173
+ percentage: number().min(0).max(100).nullable().meta(readingMeta("percentage", { label: "Charge" })),
56777
57174
  /**
56778
57175
  * Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
56779
57176
  * Reolink-specific for the Solar Panel 2 accessory (will become
@@ -56800,7 +57197,14 @@ var BatteryStatusSchema = object({
56800
57197
  */
56801
57198
  sleeping: boolean().meta({ label: "Sleeping" }),
56802
57199
  /** Ms epoch of the last observation. Lets consumers reason about freshness. */
56803
- lastUpdated: number(),
57200
+ lastUpdated: number().meta(readingMeta("none")),
57201
+ /**
57202
+ * Battery voltage in volts, for a cell the firmware reports as voltage
57203
+ * rather than a percentage (Ecowitt capacitor packs). Absent on cameras
57204
+ * that only report charge. A second reading on this cap, not a second
57205
+ * `numeric-sensor` on the same device.
57206
+ */
57207
+ volts: number().nullable().optional().meta(readingMeta("voltage", { label: "Voltage" })),
56804
57208
  /**
56805
57209
  * Ms epoch of the last time the device PROVED it was reachable — a
56806
57210
  * completed firmware round-trip, an observed wake, or an inbound push
@@ -56852,7 +57256,6 @@ var BATTERY_DEVICE_TYPES = [
56852
57256
  /** Generic Customize target for the percentage reading (D936). */
56853
57257
  var batteryCustomize = {
56854
57258
  version: 1,
56855
- advanced: "derive",
56856
57259
  targets: [{
56857
57260
  id: "percentage",
56858
57261
  cardinality: "scalar",
@@ -56861,7 +57264,7 @@ var batteryCustomize = {
56861
57264
  stateField: "percentage"
56862
57265
  },
56863
57266
  deviceTypes: BATTERY_DEVICE_TYPES,
56864
- apply: "add-or-replace",
57267
+ apply: "add",
56865
57268
  path: "percentage",
56866
57269
  sources: [{
56867
57270
  kind: "field",
@@ -56982,10 +57385,16 @@ onStatusChanged: { data: object({
56982
57385
  /**
56983
57386
  * History (D850): recorded series. The generic capture replaces the `battery` series of `pipeline-analytics:stats-5m`.
56984
57387
  */
56985
- history: { fields: { percentage: {
56986
- kind: "gauge",
56987
- unit: "%"
56988
- } } },
57388
+ history: { fields: {
57389
+ percentage: {
57390
+ kind: "gauge",
57391
+ unit: "%"
57392
+ },
57393
+ volts: {
57394
+ kind: "gauge",
57395
+ unit: "V"
57396
+ }
57397
+ } },
56989
57398
  customize: batteryCustomize,
56990
57399
  /** Clock fields: written, but excluded from the compare that decides
56991
57400
  * whether persisting is worth a SQLite commit. */
@@ -57032,12 +57441,7 @@ var binaryCapability = {
57032
57441
  history: { fields: { on: { kind: "boolean" } } },
57033
57442
  /** Clock fields: written, but excluded from the compare that decides
57034
57443
  * whether persisting is worth a SQLite commit. */
57035
- volatileStateFields: ["lastChangedAt"],
57036
- customize: {
57037
- version: 1,
57038
- advanced: "derive",
57039
- targets: []
57040
- }
57444
+ volatileStateFields: ["lastChangedAt"]
57041
57445
  };
57042
57446
  /**
57043
57447
  * Dimmable-light brightness control. Co-exists with `switch` on the
@@ -57053,7 +57457,7 @@ var binaryCapability = {
57053
57457
  */
57054
57458
  var BrightnessStatusSchema = object({
57055
57459
  /** Current level as 0..100 inclusive. Firmware-reported. */
57056
- percentage: number().min(0).max(100),
57460
+ percentage: number().min(0).max(100).meta(readingMeta("percentage")),
57057
57461
  /** Ms epoch of the last operator-driven change. Useful for UI freshness. */
57058
57462
  lastChangedAt: number()
57059
57463
  });
@@ -57507,21 +57911,21 @@ var ClimateControlStatusSchema = object({
57507
57911
  /** Single setpoint in Celsius. Used by single-target modes
57508
57912
  * (heat / cool / dry). Null when the device is in a range mode
57509
57913
  * (`heat_cool`) or has no setpoint at all (`fan_only`/`off`). */
57510
- target: number().nullable(),
57914
+ target: number().nullable().meta(readingMeta("temperature")),
57511
57915
  /** Upper bound of the dual setpoint in Celsius. Populated only
57512
57916
  * in `heat_cool` mode. */
57513
- targetHigh: number().nullable(),
57917
+ targetHigh: number().nullable().meta(readingMeta("temperature")),
57514
57918
  /** Lower bound of the dual setpoint in Celsius. Populated only
57515
57919
  * in `heat_cool` mode. */
57516
- targetLow: number().nullable(),
57920
+ targetLow: number().nullable().meta(readingMeta("temperature")),
57517
57921
  /** Target relative humidity (0..100). Null when the device has no
57518
57922
  * humidity control. */
57519
- targetHumidity: number().min(0).max(100).nullable(),
57923
+ targetHumidity: number().min(0).max(100).nullable().meta(readingMeta("humidity")),
57520
57924
  /** Current measured temperature in Celsius. Read-only — pushed by
57521
57925
  * the device's internal sensor. */
57522
- currentTemp: number().nullable(),
57926
+ currentTemp: number().nullable().meta(readingMeta("temperature")),
57523
57927
  /** Current measured relative humidity (0..100). Read-only. */
57524
- currentHumidity: number().min(0).max(100).nullable(),
57928
+ currentHumidity: number().min(0).max(100).nullable().meta(readingMeta("humidity")),
57525
57929
  /** Vertical louver swing on/off. Null when the device has no vertical
57526
57930
  * swing surface (gate with `DeviceFeature.ClimateSwingVertical`). */
57527
57931
  swingVertical: boolean().nullable(),
@@ -57529,11 +57933,11 @@ var ClimateControlStatusSchema = object({
57529
57933
  * horizontal swing surface (gate with `DeviceFeature.ClimateSwingHorizontal`). */
57530
57934
  swingHorizontal: boolean().nullable(),
57531
57935
  /** Lowest setpoint the device accepts, Celsius. Absent / null = not reported. */
57532
- minTemp: number().nullable().optional(),
57936
+ minTemp: number().nullable().optional().meta(readingMeta("temperature")),
57533
57937
  /** Highest setpoint the device accepts, Celsius. Absent / null = not reported. */
57534
- maxTemp: number().nullable().optional(),
57938
+ maxTemp: number().nullable().optional().meta(readingMeta("temperature")),
57535
57939
  /** Setpoint granularity, Celsius (0.5, 1). Absent / null = not reported. */
57536
- tempStep: number().positive().nullable().optional(),
57940
+ tempStep: number().positive().nullable().optional().meta(readingMeta("temperature")),
57537
57941
  /** Ms epoch when the slice was last updated (push or command). */
57538
57942
  lastFetchedAt: number()
57539
57943
  });
@@ -57675,17 +58079,17 @@ var climateControlCapability = {
57675
58079
  * modes to expose in the picker without a slice fetch.
57676
58080
  */
57677
58081
  var RgbTripletSchema = object({
57678
- r: number().int().min(0).max(255),
57679
- g: number().int().min(0).max(255),
57680
- b: number().int().min(0).max(255)
58082
+ r: number().int().min(0).max(255).meta(readingMeta("none")),
58083
+ g: number().int().min(0).max(255).meta(readingMeta("none")),
58084
+ b: number().int().min(0).max(255).meta(readingMeta("none"))
57681
58085
  });
57682
58086
  var HsvTripletSchema = object({
57683
58087
  /** Hue in degrees, 0..360. */
57684
- h: number().min(0).max(360),
58088
+ h: number().min(0).max(360).meta(readingMeta("none")),
57685
58089
  /** Saturation as 0..100 inclusive. */
57686
- s: number().min(0).max(100),
58090
+ s: number().min(0).max(100).meta(readingMeta("none")),
57687
58091
  /** Value/brightness as 0..100 inclusive. */
57688
- v: number().min(0).max(100)
58092
+ v: number().min(0).max(100).meta(readingMeta("none"))
57689
58093
  });
57690
58094
  var ColorInputSchema = discriminatedUnion("mode", [
57691
58095
  object({
@@ -57714,7 +58118,7 @@ var ColorStatusSchema = object({
57714
58118
  /** Populated when `mode === 'hsv'`. */
57715
58119
  hsv: HsvTripletSchema.optional(),
57716
58120
  /** Populated when `mode === 'mired'`. */
57717
- mireds: number().int().optional(),
58121
+ mireds: number().int().optional().meta(readingMeta("colour-temperature")),
57718
58122
  /** Ms epoch of the last operator-driven change. */
57719
58123
  lastChangedAt: number()
57720
58124
  });
@@ -57909,18 +58313,12 @@ _enum([
57909
58313
  "empty",
57910
58314
  "full"
57911
58315
  ]);
57912
- /** Units a remaining-life counter is reported in. Closed: the panel renders
57913
- * each. */
57914
- var ConsumableRemainingUnitSchema = _enum([
57915
- "days",
57916
- "hours",
57917
- "cycles"
57918
- ]);
57919
- /** Remaining life as a COUNT, not a percentage (the PetKit desiccant reports
57920
- * days). `value` null = unknown (D393). */
58316
+ /** Whether `remaining.value` is a duration in seconds or a dimensionless count. */
58317
+ var ConsumableRemainingKindSchema = _enum(["duration", "count"]);
58318
+ /** Remaining life. `value` null = unknown (D393). Duration is seconds. */
57921
58319
  var ConsumableRemainingSchema = object({
57922
- value: number().min(0).nullable(),
57923
- unit: ConsumableRemainingUnitSchema
58320
+ value: number().min(0).nullable().meta(readingMeta("device")),
58321
+ kind: ConsumableRemainingKindSchema
57924
58322
  });
57925
58323
  /** A single consumable item. Either a continuous `level` (remaining
57926
58324
  * life %, or fill % for a `supply` / `waste` item) or a discrete `status`
@@ -57933,7 +58331,7 @@ var ConsumableItemSchema = object({
57933
58331
  /** Display name. */
57934
58332
  label: string().min(1),
57935
58333
  /** Remaining life % (`wear`) or fill % (`supply`, `waste`) when known (0..100). */
57936
- level: number().min(0).max(100).nullable(),
58334
+ level: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
57937
58335
  /** The provider's discrete verdict when known (binary mode). */
57938
58336
  status: ConsumableStatusSchema.nullable(),
57939
58337
  /** What the item is — decides whether low or full is bad. Absent = `wear`. */
@@ -58015,8 +58413,8 @@ var consumablesCustomize = {
58015
58413
  transforms: [{ kind: "identity" }]
58016
58414
  }],
58017
58415
  literals: [{
58018
- path: "remaining.unit",
58019
- values: [...ConsumableRemainingUnitSchema.options]
58416
+ path: "remaining.kind",
58417
+ values: [...ConsumableRemainingKindSchema.options]
58020
58418
  }]
58021
58419
  },
58022
58420
  {
@@ -58145,7 +58543,6 @@ reset: method(object({
58145
58543
  },
58146
58544
  "remaining.value": {
58147
58545
  kind: "gauge",
58148
- unitFrom: "remaining.unit",
58149
58546
  deadband: 1,
58150
58547
  displayName: "Remaining"
58151
58548
  }
@@ -58215,10 +58612,9 @@ var contactCapability = {
58215
58612
  * (empty array for the other kinds). It lives in the slice because
58216
58613
  * HA `select.*` entities may update their options at runtime.
58217
58614
  *
58218
- * The `unit`/`min`/`max`/`step` fields are meaningful for
58219
- * `kind === 'numeric'` and are absent (undefined) for all other
58220
- * kinds. They are populated live from HA attributes on each state
58221
- * push — consistent with `options` and the sensor-unit approach.
58615
+ * Numeric `min` / `max` / `step` live in the slice and share the device
58616
+ * quantity (`SourceInfo.quantity`, D944). Display precision is a read-time
58617
+ * preference. A datetime control's shape is `SourceInfo.dateTimeShape`.
58222
58618
  */
58223
58619
  var ControlStatusSchema = object({
58224
58620
  kind: _enum([
@@ -58230,39 +58626,17 @@ var ControlStatusSchema = object({
58230
58626
  /** Current value. Numeric kind → number; select/text/datetime → string.
58231
58627
  * Datetime values are ISO 8601 strings (full timestamp, date-only,
58232
58628
  * or time-only — HA accepts all three forms). */
58233
- value: union([number(), string()]),
58629
+ value: union([number().meta(readingMeta("device")), string()]),
58234
58630
  /** Acceptable values when `kind === 'select'`. Empty for other kinds. */
58235
58631
  options: array(string()),
58236
58632
  /** Ms epoch when the slice was last updated. */
58237
58633
  lastChangedAt: number(),
58238
- /** Display unit-of-measurement (e.g. '°C', '%', 'lx').
58239
- * Populated live from HA `attributes.unit_of_measurement` on each push.
58240
- * Meaningful for `kind === 'numeric'`; absent for other kinds. */
58241
- unit: string().optional(),
58242
- /** Minimum allowed value. Populated live from HA `attributes.min`.
58243
- * Meaningful for `kind === 'numeric'`; absent for other kinds. */
58244
- min: number().optional(),
58245
- /** Maximum allowed value. Populated live from HA `attributes.max`.
58246
- * Meaningful for `kind === 'numeric'`; absent for other kinds. */
58247
- max: number().optional(),
58248
- /** Step increment. Populated live from HA `attributes.step`.
58249
- * Meaningful for `kind === 'numeric'`; absent for other kinds. */
58250
- step: number().optional(),
58251
- /** Suggested decimal places for numeric display. Populated live from HA
58252
- * `attributes.suggested_display_precision`, or derived from `step` when the
58253
- * HA attribute is absent. Meaningful for `kind === 'numeric'`; absent for
58254
- * other kinds. Falls back to auto-formatting when absent. */
58255
- precision: number().int().min(0).max(10).optional(),
58256
- /** Date-picker granularity for `kind === 'datetime'`. 'date' → date-only,
58257
- * 'time' → time-only, 'datetime' → full timestamp. Absent for other kinds
58258
- * (UI defaults to 'datetime'). Derived live from the device's HA domain
58259
- * (date.* / time.* / datetime.*) or, for input_datetime, from the entity's
58260
- * `has_date`/`has_time` attributes on each push. */
58261
- format: _enum([
58262
- "date",
58263
- "time",
58264
- "datetime"
58265
- ]).optional()
58634
+ /** Minimum allowed value, in the device quantity's base unit. */
58635
+ min: number().optional().meta(readingMeta("device")),
58636
+ /** Maximum allowed value, in the device quantity's base unit. */
58637
+ max: number().optional().meta(readingMeta("device")),
58638
+ /** Step increment, in the device quantity's base unit. */
58639
+ step: number().optional().meta(readingMeta("device"))
58266
58640
  });
58267
58641
  var ControlSetValueInputSchema = discriminatedUnion("kind", [
58268
58642
  object({
@@ -58328,9 +58702,9 @@ var CoverStatusSchema = object({
58328
58702
  ]),
58329
58703
  /** 0 = fully closed, 100 = fully open. Null when the device has
58330
58704
  * no intermediate position surface. */
58331
- position: number().min(0).max(100).nullable(),
58705
+ position: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
58332
58706
  /** 0 = closed slats, 100 = open slats. Null when no tilt support. */
58333
- tiltPosition: number().min(0).max(100).nullable(),
58707
+ tiltPosition: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
58334
58708
  /** Ms epoch when the slice was last updated. */
58335
58709
  lastChangedAt: number()
58336
58710
  });
@@ -58433,9 +58807,9 @@ var NormalizedRangeSchema$1 = object({
58433
58807
  var DayNightStatusSchema = object({
58434
58808
  mode: DayNightModeSchema,
58435
58809
  /** IR-cut trigger sensitivity, NORMALIZED 0–100 (higher = switches to night sooner). */
58436
- sensitivity: number().optional(),
58810
+ sensitivity: number().optional().meta(readingMeta("none")),
58437
58811
  /** Delay before the IR-cut filter flips, in seconds. */
58438
- switchDelaySec: number().optional(),
58812
+ switchDelaySec: number().optional().meta(readingMeta("duration")),
58439
58813
  lastFetchedAt: number()
58440
58814
  });
58441
58815
  /**
@@ -58653,11 +59027,11 @@ var DishwasherStatusSchema = object({
58653
59027
  /** Feature keys of the programs the appliance currently offers — drives the UI selector. */
58654
59028
  availablePrograms: array(string()),
58655
59029
  /** Seconds remaining on the active cycle, or null when not running / not known. */
58656
- remainingSeconds: number().int().nonnegative().nullable(),
59030
+ remainingSeconds: number().int().nonnegative().nullable().meta(readingMeta("duration")),
58657
59031
  /** Seconds the delayed start is set to (time until the cycle starts), or null. */
58658
- delayedStartSeconds: number().int().nonnegative().nullable(),
59032
+ delayedStartSeconds: number().int().nonnegative().nullable().meta(readingMeta("duration")),
58659
59033
  /** Cycle completion 0..100, or null when not applicable. */
58660
- progressPercent: number().min(0).max(100).nullable(),
59034
+ progressPercent: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
58661
59035
  /** True when the door is reported open; null when the door state is not known. */
58662
59036
  doorOpen: boolean().nullable(),
58663
59037
  /** True when the door is latched (locked) during a cycle; null when not reported. */
@@ -58681,7 +59055,7 @@ var DishwasherStatusSchema = object({
58681
59055
  /** True while the machine-care (descaling / cleaning-program) reminder is raised; false when clear; null when not reported. */
58682
59056
  machineCareDue: boolean().nullable(),
58683
59057
  /** Program runs left before the machine-care reminder is due; null when the appliance does not say. */
58684
- machineCareRemainingRuns: number().int().nonnegative().nullable(),
59058
+ machineCareRemainingRuns: number().int().nonnegative().nullable().meta(readingMeta("count")),
58685
59059
  /** Option states: null when the appliance does not expose the option or has not said. */
58686
59060
  halfLoad: boolean().nullable(),
58687
59061
  hygienePlus: boolean().nullable(),
@@ -58696,7 +59070,7 @@ var DishwasherStatusSchema = object({
58696
59070
  /** Feature keys of the events currently raised (salt low, rinse aid low, program finished, …). */
58697
59071
  activeEvents: array(string()),
58698
59072
  /** Numeric error code when the appliance reports one; null otherwise. */
58699
- errorCode: number().nullable(),
59073
+ errorCode: number().nullable().meta(readingMeta("none")),
58700
59074
  /** Name of the raised alert-level event while the appliance is in error; null otherwise. */
58701
59075
  errorLabel: string().nullable(),
58702
59076
  /** Ms epoch of the last value received from the appliance; 0 = never. */
@@ -58927,7 +59301,7 @@ var DoorbellStatusSchema = object({
58927
59301
  /** Ms epoch of the last press. null = never observed since this provider started. */
58928
59302
  lastPressedAt: number().nullable(),
58929
59303
  /** Counter since provider start. Resets on reboot. Useful for metrics/debug. */
58930
- pressCountSinceStart: number()
59304
+ pressCountSinceStart: number().meta(readingMeta("count"))
58931
59305
  });
58932
59306
  var DoorbellPressEventSchema = object({
58933
59307
  deviceId: number(),
@@ -58992,17 +59366,7 @@ onPressed: {
58992
59366
  history: "none",
58993
59367
  customize: doorbellCustomize
58994
59368
  };
58995
- /**
58996
- * Enum-state sensor — a string value picked from a finite option set.
58997
- * Drives HA `sensor` entries with `state_class: enum` (HVAC action
58998
- * states, weather conditions, contact-source channels, mode strings).
58999
- * The option set is stable across observations; it is persisted in the
59000
- * device config blob (via the control slice at adoption) and is NOT
59001
- * stored in `sourceInfo`.
59002
- */
59003
- /** Locale-render shape for an ISO `value` carried by a `DateTimeSensor`-role
59004
- * enum sensor: `date` (date-only), `time` (time-only), `datetime` (both). */
59005
- var EnumSensorDateTimeFormatSchema = _enum([
59369
+ _enum([
59006
59370
  "date",
59007
59371
  "time",
59008
59372
  "datetime"
@@ -59010,12 +59374,11 @@ var EnumSensorDateTimeFormatSchema = _enum([
59010
59374
  var EnumSensorStatusSchema = object({
59011
59375
  value: string(),
59012
59376
  /**
59013
- * Set for `DateTimeSensor`-role sensors so the UI renders the ISO `value`
59014
- * as a locale date/time/datetime; absent for plain enum sensors. HA
59015
- * `device_class=timestamp` → `'datetime'`, `device_class=date` → `'date'`,
59016
- * a time-only sensor → `'time'`.
59377
+ * Set when `value` is a timestamp rather than an enum state, so history
59378
+ * does not learn ISO strings as states. The display shape (date / time /
59379
+ * datetime) lives on `SourceInfo.dateTimeShape`, written once at adopt.
59017
59380
  */
59018
- format: EnumSensorDateTimeFormatSchema.optional(),
59381
+ timestamp: boolean().optional(),
59019
59382
  /** Ms epoch when the slice was last updated. */
59020
59383
  lastFetchedAt: number()
59021
59384
  });
@@ -59042,11 +59405,11 @@ var enumSensorCapability = {
59042
59405
  * History (D850): the value as an `enum` series (an appliance's program or
59043
59406
  * operation state, an HVAC action). The option set is per device, so the
59044
59407
  * value list is LEARNED as values are first seen (bounded). A sensor with a
59045
- * `format` carries a timestamp, not a state, and is not recorded.
59408
+ * `timestamp` carries a clock, not a state, and is not recorded.
59046
59409
  */
59047
59410
  history: { fields: { value: {
59048
59411
  kind: "enum",
59049
- skipWhenSet: "format"
59412
+ skipWhenSet: "timestamp"
59050
59413
  } } },
59051
59414
  /** Clock fields: written, but excluded from the compare that decides
59052
59415
  * whether persisting is worth a SQLite commit. */
@@ -59066,13 +59429,13 @@ var EventFireSchema = object({
59066
59429
  deviceId: number(),
59067
59430
  eventType: string(),
59068
59431
  data: record(string(), unknown()).nullable(),
59069
- timestamp: number(),
59070
- seq: number()
59432
+ timestamp: number().meta(readingMeta("none")),
59433
+ seq: number().meta(readingMeta("count"))
59071
59434
  });
59072
59435
  var EventEmitterStatusSchema = object({
59073
59436
  eventTypes: array(string()),
59074
59437
  lastEvent: EventFireSchema.nullable(),
59075
- eventCountSinceStart: number()
59438
+ eventCountSinceStart: number().meta(readingMeta("count"))
59076
59439
  });
59077
59440
  var eventEmitterCapability = {
59078
59441
  name: "event-emitter",
@@ -59485,10 +59848,10 @@ var FanDirectionSchema = _enum(["forward", "reverse"]);
59485
59848
  var FanControlStatusSchema = object({
59486
59849
  /** Active speed as 0..100 inclusive. Null when the device has no
59487
59850
  * speed surface (single-speed fan). */
59488
- percentage: number().min(0).max(100).nullable(),
59851
+ percentage: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
59489
59852
  /** Speed granularity the device accepts (HA `percentage_step`, e.g. 25 for
59490
59853
  * a 4-speed fan). Absent when unknown — the UI then falls back to step 1. */
59491
- percentageStep: number().positive().optional(),
59854
+ percentageStep: number().positive().optional().meta(readingMeta("percentage")),
59492
59855
  /** Active preset mode (`auto` / `quiet` / `turbo` / vendor-specific)
59493
59856
  * — empty string when no preset is active or supported. */
59494
59857
  preset: string(),
@@ -59609,7 +59972,7 @@ var FeatureProbeStatusSchema = object({
59609
59972
  /** Camera/firmware model string. `null` when the firmware doesn't expose it. */
59610
59973
  model: string().nullable(),
59611
59974
  /** Channel count for NVR/Hub devices; `1` for standalone cameras; `null` pre-probe. */
59612
- channelCount: number().nullable(),
59975
+ channelCount: number().nullable().meta(readingMeta("count")),
59613
59976
  /**
59614
59977
  * Ms epoch of the last SUCCESSFUL probe. `0` before the first probe
59615
59978
  * completes — drivers' `getAccessoryChildren()` should treat zero as
@@ -59732,9 +60095,91 @@ var gasCapability = {
59732
60095
  * whether persisting is worth a SQLite commit. */
59733
60096
  volatileStateFields: ["lastChangedAt"]
59734
60097
  };
60098
+ var GroupCommandsSchema = object({
60099
+ /** One row per member that has been commanded. A later command replaces that member's row. */
60100
+ results: array(object({
60101
+ deviceId: number().int().nonnegative(),
60102
+ cap: string().min(1),
60103
+ method: string().min(1),
60104
+ ok: boolean(),
60105
+ error: string().optional(),
60106
+ /** Ms epoch of the attempt. */
60107
+ at: number()
60108
+ })) });
60109
+ var groupCommandsCapability = {
60110
+ name: "group-commands",
60111
+ scope: "device",
60112
+ deviceNative: true,
60113
+ mode: "singleton",
60114
+ deviceTypes: [DeviceType.Switch, DeviceType.Light],
60115
+ methods: {},
60116
+ status: {
60117
+ schema: GroupCommandsSchema,
60118
+ kind: "push"
60119
+ },
60120
+ runtimeState: GroupCommandsSchema,
60121
+ /**
60122
+ * Runtime-state durability: **session** — the last attempt. A restored
60123
+ * failure would outlive the command that caused it.
60124
+ *
60125
+ * See `RuntimeStateDurability`. Enforced by
60126
+ * `scripts/check-runtime-state-durability.ts`.
60127
+ */
60128
+ durability: "session",
60129
+ history: "none"
60130
+ };
60131
+ /**
60132
+ * How many members of a helper group answered (D944). Counts are integers,
60133
+ * not measurements: zero included is a real count, never a stand-in reading.
60134
+ * The reading itself stays on the output capability. History is none — the
60135
+ * series that later statistics read is the output cap's own history block.
60136
+ */
60137
+ var GroupStatusSchema = object({
60138
+ /** Members whose current value entered the aggregate. */
60139
+ included: number().int().nonnegative().meta(readingMeta("count", {
60140
+ precision: 0,
60141
+ label: "Reporting"
60142
+ })),
60143
+ /** Members left out: offline, unknown, or not a finite reading (D393). */
60144
+ excluded: number().int().nonnegative().meta(readingMeta("count", {
60145
+ precision: 0,
60146
+ label: "Excluded"
60147
+ })),
60148
+ /** `included` + `excluded`. */
60149
+ total: number().int().nonnegative().meta(readingMeta("count", {
60150
+ precision: 0,
60151
+ label: "Members"
60152
+ }))
60153
+ });
60154
+ var groupStatusCapability = {
60155
+ name: "group-status",
60156
+ scope: "device",
60157
+ deviceNative: true,
60158
+ mode: "singleton",
60159
+ deviceTypes: [
60160
+ DeviceType.Sensor,
60161
+ DeviceType.Switch,
60162
+ DeviceType.Light
60163
+ ],
60164
+ methods: {},
60165
+ status: {
60166
+ schema: GroupStatusSchema,
60167
+ kind: "push"
60168
+ },
60169
+ runtimeState: GroupStatusSchema,
60170
+ /**
60171
+ * Runtime-state durability: **session** — recomputed from members on the
60172
+ * next source event; a restored count would outlive the readings it named.
60173
+ *
60174
+ * See `RuntimeStateDurability`. Enforced by
60175
+ * `scripts/check-runtime-state-durability.ts`.
60176
+ */
60177
+ durability: "session",
60178
+ history: "none"
60179
+ };
59735
60180
  var HeatingValveStatusSchema = object({
59736
60181
  /** Radiator valve opening 0 (closed) .. 100 (open). Null = not yet known. */
59737
- position: number().min(0).max(100).nullable(),
60182
+ position: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
59738
60183
  /** Ms epoch when the slice was last updated (push or poll). */
59739
60184
  lastFetchedAt: number()
59740
60185
  });
@@ -59777,9 +60222,9 @@ var HumidifierStatusSchema = object({
59777
60222
  /** Whether the humidifier is currently on. */
59778
60223
  on: boolean(),
59779
60224
  /** Current measured relative humidity (0..100). Null when not reported. */
59780
- currentHumidity: number().min(0).max(100).nullable(),
60225
+ currentHumidity: number().min(0).max(100).nullable().meta(readingMeta("humidity")),
59781
60226
  /** Target relative humidity (0..100). Null when no setpoint surface. */
59782
- targetHumidity: number().min(0).max(100).nullable(),
60227
+ targetHumidity: number().min(0).max(100).nullable().meta(readingMeta("humidity")),
59783
60228
  /** Active mode (`auto` / `normal` / `baby` / vendor). Null when the
59784
60229
  * device has no mode surface. */
59785
60230
  mode: string().nullable(),
@@ -59789,9 +60234,9 @@ var HumidifierStatusSchema = object({
59789
60234
  * `idle` / `off`). Null when the device doesn't report it. */
59790
60235
  action: string().nullable(),
59791
60236
  /** HA `min_humidity` attribute. Null → UI uses 0. */
59792
- minHumidity: number().nullable(),
60237
+ minHumidity: number().nullable().meta(readingMeta("humidity")),
59793
60238
  /** HA `max_humidity` attribute. Null → UI uses 100. */
59794
- maxHumidity: number().nullable(),
60239
+ maxHumidity: number().nullable().meta(readingMeta("humidity")),
59795
60240
  /** Ms epoch when the slice was last updated. */
59796
60241
  lastChangedAt: number()
59797
60242
  });
@@ -59861,22 +60306,13 @@ var humidifierCapability = {
59861
60306
  * `sourceInfo`.
59862
60307
  */
59863
60308
  var HumiditySensorStatusSchema = object({
59864
- /** Current relative humidity, 0..100. */
59865
- percent: number().min(0).max(100).meta({
59866
- unit: "%",
60309
+ /** Current relative humidity, 0..100. `null` when the sample was refused (D393). */
60310
+ percent: number().min(0).max(100).nullable().meta(readingMeta("humidity", {
60311
+ precision: 0,
59867
60312
  label: "Humidity"
59868
- }),
60313
+ })),
59869
60314
  /** Ms epoch when the slice was last updated. */
59870
- lastFetchedAt: number(),
59871
- /** Live display unit from the upstream source (e.g. HA
59872
- * `attributes.unit_of_measurement`). The UI prefers this over the
59873
- * role's canonical unit. Absent → fall back to the canonical unit. */
59874
- unit: string().optional(),
59875
- /** Suggested decimal places for numeric display.
59876
- * Populated live from the upstream source when provided (e.g. HA
59877
- * `attributes.suggested_display_precision`). Falls back to
59878
- * auto-formatting when absent. */
59879
- precision: number().int().min(0).max(10).optional()
60315
+ lastFetchedAt: number()
59880
60316
  });
59881
60317
  var humiditySensorCapability = {
59882
60318
  name: "humidity-sensor",
@@ -59907,12 +60343,7 @@ var humiditySensorCapability = {
59907
60343
  } } },
59908
60344
  /** Clock fields: written, but excluded from the compare that decides
59909
60345
  * whether persisting is worth a SQLite commit. */
59910
- volatileStateFields: ["lastFetchedAt"],
59911
- customize: {
59912
- version: 1,
59913
- advanced: "derive",
59914
- targets: []
59915
- }
60346
+ volatileStateFields: ["lastFetchedAt"]
59916
60347
  };
59917
60348
  /**
59918
60349
  * Image display cap. Models a single still image exposed by an integration —
@@ -59933,7 +60364,7 @@ var ImageStatusSchema = object({
59933
60364
  * entity exposes no `entity_picture` (yet). */
59934
60365
  url: string().nullable(),
59935
60366
  /** Ms epoch of the upstream last-updated timestamp. Null at cold-start. */
59936
- lastUpdated: number().nullable()
60367
+ lastUpdated: number().nullable().meta(readingMeta("none"))
59937
60368
  });
59938
60369
  var imageCapability = {
59939
60370
  name: "image",
@@ -60021,19 +60452,19 @@ var NormalizedRangeSchema = object({
60021
60452
  */
60022
60453
  var ImageSettingsStatusSchema = object({
60023
60454
  /** Normalized 0–100. */
60024
- brightness: number().optional(),
60455
+ brightness: number().optional().meta(readingMeta("none")),
60025
60456
  /** Normalized 0–100. */
60026
- contrast: number().optional(),
60457
+ contrast: number().optional().meta(readingMeta("none")),
60027
60458
  /** Normalized 0–100. */
60028
- saturation: number().optional(),
60459
+ saturation: number().optional().meta(readingMeta("none")),
60029
60460
  /** Normalized 0–100. */
60030
- sharpness: number().optional(),
60461
+ sharpness: number().optional().meta(readingMeta("none")),
60031
60462
  mirror: boolean().optional(),
60032
60463
  flip: boolean().optional(),
60033
60464
  rotate: ImageRotateSchema.optional(),
60034
60465
  whiteBalance: WhiteBalanceModeSchema.optional(),
60035
60466
  /** Manual white-balance warmth, NORMALIZED 0–100. Meaningful only when `whiteBalance === 'manual'`. */
60036
- warmth: number().optional(),
60467
+ warmth: number().optional().meta(readingMeta("none")),
60037
60468
  exposureMode: ExposureModeSchema.optional(),
60038
60469
  backlightMode: BacklightModeSchema.optional(),
60039
60470
  lastFetchedAt: number()
@@ -60312,10 +60743,10 @@ var IntercomAbilitySchema = object({
60312
60743
  /** Codecs accepted by firmware, in preference order. Driver-authored strings. */
60313
60744
  codecs: array(string()),
60314
60745
  /** Sample rate (Hz) the firmware expects. Reolink typical: 16000. */
60315
- sampleRate: number(),
60746
+ sampleRate: number().meta(readingMeta("none")),
60316
60747
  duplex: _enum(["half", "full"]),
60317
60748
  /** Max in-flight audio backlog before drop (ms). Server uses this to bound latency. */
60318
- maxBacklogMs: number()
60749
+ maxBacklogMs: number().meta(readingMeta("duration-ms"))
60319
60750
  });
60320
60751
  var IntercomStatusSchema = object({
60321
60752
  /** True while a talk session is open. */
@@ -60542,13 +60973,13 @@ var LawnMowerControlStatusSchema = object({
60542
60973
  activity: LawnMowerActivitySchema,
60543
60974
  /** 0..100 battery percentage. Null when the device has no battery
60544
60975
  * reading. */
60545
- batteryLevel: number().min(0).max(100).nullable(),
60976
+ batteryLevel: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
60546
60977
  /** 0..100 mowing-completion percentage of the current task, or null when no
60547
60978
  * task is active / progress is unavailable. */
60548
- progressPercent: number().min(0).max(100).nullable(),
60979
+ progressPercent: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
60549
60980
  /** Current device/event code (dynamic — mostly status, sometimes an error),
60550
60981
  * or null when unknown. */
60551
- currentCode: number().nullable(),
60982
+ currentCode: number().nullable().meta(readingMeta("none")),
60552
60983
  /** Human label for {@link currentCode}, or null when undecodable. */
60553
60984
  currentCodeLabel: string().nullable(),
60554
60985
  /** Severity of {@link currentCode}. `error` (and often `warning`) warrants UI
@@ -61081,7 +61512,7 @@ var MediaPlayerStatusSchema = object({
61081
61512
  state: MediaPlayerStateSchema,
61082
61513
  /** Volume as 0..100 inclusive. Null when the device has no volume
61083
61514
  * surface. Pair with `DeviceFeature.MediaPlayerVolume`. */
61084
- volumeLevel: number().min(0).max(100).nullable(),
61515
+ volumeLevel: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
61085
61516
  /** Mute toggle distinct from volume=0. Null when no mute surface.
61086
61517
  * Pair with `DeviceFeature.MediaPlayerMute`. */
61087
61518
  isMuted: boolean().nullable(),
@@ -61094,10 +61525,10 @@ var MediaPlayerStatusSchema = object({
61094
61525
  currentMedia: MediaInfoSchema.nullable(),
61095
61526
  /** Current playback position in ms. Null when not seekable or
61096
61527
  * nothing is playing. Pair with `DeviceFeature.MediaPlayerSeek`. */
61097
- positionMs: number().int().nonnegative().nullable(),
61528
+ positionMs: number().int().nonnegative().nullable().meta(readingMeta("duration-ms")),
61098
61529
  /** Total duration of the current media in ms. Null when unknown
61099
61530
  * (live stream) or nothing is playing. */
61100
- durationMs: number().int().nonnegative().nullable(),
61531
+ durationMs: number().int().nonnegative().nullable().meta(readingMeta("duration-ms")),
61101
61532
  /** Shuffle toggle. Null when no shuffle surface.
61102
61533
  * Pair with `DeviceFeature.MediaPlayerShuffle`. */
61103
61534
  shuffle: boolean().nullable(),
@@ -61406,7 +61837,7 @@ var motionCustomize = {
61406
61837
  eventName: "onMotionChanged"
61407
61838
  },
61408
61839
  deviceTypes: [DeviceType.Camera],
61409
- apply: "replace",
61840
+ apply: "add",
61410
61841
  applyAuthority: {
61411
61842
  kind: "camera-sensors",
61412
61843
  timeoutField: "motionCooldownMs"
@@ -61478,7 +61909,7 @@ var MotionStatusSchema = object({
61478
61909
  * it, every provider seeded it at boot, and every session left it
61479
61910
  * `detected: true` after its detach.
61480
61911
  */
61481
- autoClearAfterMs: number().nullable()
61912
+ autoClearAfterMs: number().nullable().meta(readingMeta("duration-ms"))
61482
61913
  });
61483
61914
  /**
61484
61915
  * Payload of `motion.onMotionChanged` event + the corresponding bus
@@ -61515,12 +61946,18 @@ var motionCapability = {
61515
61946
  methods: {
61516
61947
  /**
61517
61948
  * Pull the current motion state synchronously. Convenience shortcut
61518
- * for consumers that don't need the full status object; equivalent
61519
- * to `getStatus()?.detected ?? false`. Will likely be folded into
61520
- * `getStatus` once the auto-injected status surface lands in every
61521
- * consumer.
61949
+ * for consumers that don't need the full status object. A composed
61950
+ * group answers from its slice (D944): unknown throws, it is not off.
61522
61951
  */
61523
61952
  isDetected: method(object({ deviceId: number() }), boolean()) },
61953
+ /**
61954
+ * A composed motion group serves `isDetected` from `detected` (D944).
61955
+ * Without this the cap stays uncomposable (`has-commands`).
61956
+ */
61957
+ composedMethods: { isDetected: {
61958
+ kind: "slice",
61959
+ field: "detected"
61960
+ } },
61524
61961
  events: {
61525
61962
  /**
61526
61963
  * Fires every time the runner transitions a camera between
@@ -61660,7 +62097,7 @@ var MotionZoneRegionSchema = object({
61660
62097
  * the grid region(s). */
61661
62098
  var MotionZoneStatusSchema = object({
61662
62099
  enabled: boolean(),
61663
- sensitivity: number(),
62100
+ sensitivity: number().meta(readingMeta("none")),
61664
62101
  /** Grid region(s). Today exactly one `grid` shape. */
61665
62102
  regions: array(MotionZoneRegionSchema),
61666
62103
  lastFetchedAt: number()
@@ -62030,7 +62467,7 @@ var NavigationStatusSchema = object({
62030
62467
  following: boolean(),
62031
62468
  flash: boolean(),
62032
62469
  lightMode: NavigationLightModeSchema,
62033
- lightLevel: number().min(40).max(100),
62470
+ lightLevel: number().min(40).max(100).meta(readingMeta("none")),
62034
62471
  /** Ms epoch when the slice was last updated. */
62035
62472
  lastChangedAt: number()
62036
62473
  });
@@ -62164,13 +62601,13 @@ var NetworkLinkStatusSchema = object({
62164
62601
  * one whose reading has not landed must not be drawn at 0 %. Consumers
62165
62602
  * SKIP a null rather than coerce it.
62166
62603
  */
62167
- signalPercent: number().min(0).max(100).nullable(),
62604
+ signalPercent: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
62168
62605
  /** Raw received signal strength in dBm, when the firmware reports one. */
62169
- rssiDbm: number().optional(),
62606
+ rssiDbm: number().optional().meta(readingMeta("signal-level")),
62170
62607
  /** Network name of a wireless link, when the firmware reports it. */
62171
62608
  ssid: string().optional(),
62172
62609
  /** Ms epoch of the last observation. Lets consumers reason about freshness. */
62173
- lastUpdated: number()
62610
+ lastUpdated: number().meta(readingMeta("none"))
62174
62611
  });
62175
62612
  var networkLinkCapability = {
62176
62613
  name: "network-link",
@@ -62555,7 +62992,7 @@ var NotifierStatusSchema = object({
62555
62992
  lastError: string().nullable(),
62556
62993
  /** Number of deliveries currently buffered server-side (rate-limited
62557
62994
  * notifiers may queue). 0 when the provider sends synchronously. */
62558
- queueDepth: number().int().nonnegative(),
62995
+ queueDepth: number().int().nonnegative().meta(readingMeta("count")),
62559
62996
  /** Per-feature capability matrix — authoritative source for the
62560
62997
  * compose-form field gating. */
62561
62998
  supports: NotifierSupportsSchema
@@ -62647,11 +63084,9 @@ onSent: { data: object({
62647
63084
  * cap fits (HA `sensor` whose `device_class` we don't have a typed cap
62648
63085
  * for: water flow, distance, weight, frequency, signal strength, …).
62649
63086
  *
62650
- * The `unit` and `precision` fields carry the live display metadata that
62651
- * the upstream source provides with each state push (HA
62652
- * `attributes.unit_of_measurement` / `attributes.suggested_display_precision`).
62653
- * The UI reads them directly from the slice — they are the single source
62654
- * of truth for generic numeric rendering and do NOT live on `sourceInfo`.
63087
+ * The quantity is not on this slice. It is chosen when the device is
63088
+ * adopted and stored once on `SourceInfo.quantity` (D944). `value` is in
63089
+ * that quantity's base unit. `null` is a refused sample (D393).
62655
63090
  *
62656
63091
  * Prefer the typed alternatives (`temperature-sensor`, `humidity-sensor`,
62657
63092
  * `ambient-light-sensor`, `pressure-sensor`, `power-meter`,
@@ -62660,15 +63095,8 @@ onSent: { data: object({
62660
63095
  * numeric values land here.
62661
63096
  */
62662
63097
  var NumericSensorStatusSchema = object({
62663
- value: number(),
62664
- /** Display unit-of-measurement (e.g. 'dBm', 's', 'rpm', 'steps').
62665
- * Populated live from the upstream source on each state push.
62666
- * Absent for unitless sensors. */
62667
- unit: string().optional(),
62668
- /** Suggested decimal places for numeric display.
62669
- * Populated live from the upstream source when provided.
62670
- * Falls back to auto-formatting when absent. */
62671
- precision: number().int().min(0).max(10).optional(),
63098
+ /** Reading in the device quantity's base unit. `null` when refused (D393). */
63099
+ value: number().nullable().meta(readingMeta("device")),
62672
63100
  /** Ms epoch when the slice was last updated. */
62673
63101
  lastFetchedAt: number()
62674
63102
  });
@@ -62692,11 +63120,11 @@ var numericSensorCapability = {
62692
63120
  */
62693
63121
  durability: "restored",
62694
63122
  /**
62695
- * History (D850): recorded series. The unit is per device, read from the sibling `unit` field.
63123
+ * History (D850): recorded series. The unit is the device quantity's base,
63124
+ * resolved when the series is read — the cap has no single unit.
62696
63125
  */
62697
63126
  history: { fields: { value: {
62698
63127
  kind: "gauge",
62699
- unitFrom: "unit",
62700
63128
  minIntervalMs: 3e4
62701
63129
  } } },
62702
63130
  /** Clock fields: written, but excluded from the compare that decides
@@ -62988,23 +63416,26 @@ var PetFeederStatusSchema = object({
62988
63416
  /** Food currently in the bowl (grams). Null when the device has not
62989
63417
  * reported a reading yet. On dual-hopper models this is the combined
62990
63418
  * bowl reading; per-hopper levels live in `food1`/`food2`. */
62991
- foodLevel: number().nullable(),
63419
+ foodLevel: number().nullable().meta(readingMeta("none")),
62992
63420
  /** Hopper-1 food level (grams) on dual-hopper feeders; null on
62993
63421
  * single-hopper models. */
62994
- food1: number().nullable(),
63422
+ food1: number().nullable().meta(readingMeta("none")),
62995
63423
  /** Hopper-2 food level (grams) on dual-hopper feeders; null on
62996
63424
  * single-hopper models. */
62997
- food2: number().nullable(),
63425
+ food2: number().nullable().meta(readingMeta("none")),
62998
63426
  /** Derived low-food flag — mirrors the HA `food_level` binary_sensor
62999
63427
  * (`device_class: problem`, on = low). True when the bowl is empty /
63000
63428
  * below the feeder's low threshold. */
63001
63429
  lowFood: boolean(),
63002
63430
  /** Battery charge 0..100 (%). Null on mains-powered models or when the
63003
63431
  * device has no battery reading. */
63004
- batteryPower: number().min(0).max(100).nullable(),
63005
- /** Days of desiccant life remaining. Null when the model has no
63006
- * desiccant sensor. */
63007
- desiccantLeftDays: number().nullable(),
63432
+ batteryPower: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
63433
+ /**
63434
+ * Desiccant life remaining, stored in seconds (duration base, D944).
63435
+ * Providers convert from the days the feeder reports. Null when the
63436
+ * model has no desiccant sensor.
63437
+ */
63438
+ desiccantLeftDays: number().nullable().meta(readingMeta("duration")),
63008
63439
  /** True while a feed is in progress. */
63009
63440
  feeding: boolean(),
63010
63441
  /** Decoded connectivity / power status (HA petkit device-status enum).
@@ -63015,7 +63446,7 @@ var PetFeederStatusSchema = object({
63015
63446
  * with `errorCode` for consumers that want the raw integer. */
63016
63447
  error: string().nullable(),
63017
63448
  /** Raw device error code (0 / null = no error). */
63018
- errorCode: number().nullable(),
63449
+ errorCode: number().nullable().meta(readingMeta("none")),
63019
63450
  /** True for D4S/D4SH dual-hopper hardware — gates the per-hopper UI. */
63020
63451
  isDualHopper: boolean(),
63021
63452
  /** Child-lock (manual-lock) setting — buttons on the unit are disabled. */
@@ -63025,7 +63456,7 @@ var PetFeederStatusSchema = object({
63025
63456
  /** Play a chime when dispensing. */
63026
63457
  feedSound: boolean(),
63027
63458
  /** Speaker / prompt volume level (device-scaled integer). */
63028
- volume: number(),
63459
+ volume: number().meta(readingMeta("none")),
63029
63460
  /** Ms epoch when the slice was last refreshed from the cloud. */
63030
63461
  lastFetchedAt: number()
63031
63462
  });
@@ -63144,7 +63575,7 @@ var petFeederCapability = {
63144
63575
  },
63145
63576
  desiccantLeftDays: {
63146
63577
  kind: "gauge",
63147
- unit: "days"
63578
+ unit: "s"
63148
63579
  }
63149
63580
  } }
63150
63581
  };
@@ -63545,36 +63976,19 @@ method(_void(), PlatformCapabilitiesSchema), method(_void(), HardwareInfoSchema)
63545
63976
  */
63546
63977
  var PowerMeterStatusSchema = object({
63547
63978
  /** Instantaneous power draw in watts. */
63548
- watts: number().optional().meta({
63549
- unit: "W",
63550
- label: "Power"
63551
- }),
63979
+ watts: number().optional().meta(readingMeta("power", { label: "Power" })),
63552
63980
  /** Cumulative energy in kilowatt-hours since the meter was reset. */
63553
- kwhTotal: number().optional().meta({
63554
- unit: "kWh",
63555
- label: "Energy"
63556
- }),
63981
+ kwhTotal: number().optional().meta(readingMeta("energy", { label: "Energy" })),
63557
63982
  /** Voltage in volts. */
63558
- volts: number().optional(),
63983
+ volts: number().optional().meta(readingMeta("voltage")),
63559
63984
  /** Current in amperes. */
63560
- amps: number().optional(),
63561
- /** Apparent power in volt-amperes (W × power-factor reciprocal). */
63562
- va: number().optional(),
63985
+ amps: number().optional().meta(readingMeta("current")),
63986
+ /** Apparent power in volt-amperes. */
63987
+ va: number().optional().meta(readingMeta("apparent-power")),
63563
63988
  /** Power factor (0..1) if reported. */
63564
- powerFactor: number().min(0).max(1).optional(),
63989
+ powerFactor: number().min(0).max(1).optional().meta(readingMeta("ratio")),
63565
63990
  /** Ms epoch when the slice was last updated. */
63566
- lastFetchedAt: number(),
63567
- /** Live display unit of the single metric this slice carries (e.g. HA
63568
- * `attributes.unit_of_measurement` → 'V' / 'A' / 'W' / 'kW' / 'kWh').
63569
- * Each upstream `sensor.*` entity surfaces ONE device_class, so one
63570
- * unit per slice is unambiguous. The UI prefers this over the role's
63571
- * canonical unit so a 'kW' / 'Wh' feed renders verbatim. */
63572
- unit: string().optional(),
63573
- /** Suggested decimal places for numeric display.
63574
- * Populated live from the upstream source when provided (e.g. HA
63575
- * `attributes.suggested_display_precision`). Falls back to
63576
- * auto-formatting when absent. */
63577
- precision: number().int().min(0).max(10).optional()
63991
+ lastFetchedAt: number()
63578
63992
  });
63579
63993
  var powerMeterCapability = {
63580
63994
  name: "power-meter",
@@ -63638,12 +64052,7 @@ var powerMeterCapability = {
63638
64052
  } },
63639
64053
  /** Clock fields: written, but excluded from the compare that decides
63640
64054
  * whether persisting is worth a SQLite commit. */
63641
- volatileStateFields: ["lastFetchedAt"],
63642
- customize: {
63643
- version: 1,
63644
- advanced: "derive",
63645
- targets: []
63646
- }
64055
+ volatileStateFields: ["lastFetchedAt"]
63647
64056
  };
63648
64057
  /**
63649
64058
  * Presence cap. Models HA `person.*` and `device_tracker.*` entities
@@ -63663,11 +64072,11 @@ var powerMeterCapability = {
63663
64072
  */
63664
64073
  var GpsLocationSchema = object({
63665
64074
  /** Latitude in decimal degrees, -90..90. */
63666
- latitude: number().min(-90).max(90),
64075
+ latitude: number().min(-90).max(90).meta(readingMeta("angle")),
63667
64076
  /** Longitude in decimal degrees, -180..180. */
63668
- longitude: number().min(-180).max(180),
64077
+ longitude: number().min(-180).max(180).meta(readingMeta("angle")),
63669
64078
  /** Reported accuracy in meters (lower = better). */
63670
- accuracyMeters: number().nonnegative()
64079
+ accuracyMeters: number().nonnegative().meta(readingMeta("length"))
63671
64080
  });
63672
64081
  var PresenceStatusSchema = object({
63673
64082
  /** `home` / `not_home` / any user-defined zone name. */
@@ -63679,7 +64088,7 @@ var PresenceStatusSchema = object({
63679
64088
  gps: GpsLocationSchema.nullable(),
63680
64089
  /** Optional battery level of the tracking device (0..100). Null
63681
64090
  * when not reported. */
63682
- batteryPercent: number().min(0).max(100).nullable(),
64091
+ batteryPercent: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
63683
64092
  /** Ms epoch when the slice was last updated. */
63684
64093
  lastChangedAt: number()
63685
64094
  });
@@ -63729,19 +64138,10 @@ var presenceCapability = {
63729
64138
  * `sourceInfo`.
63730
64139
  */
63731
64140
  var PressureSensorStatusSchema = object({
63732
- /** Current pressure in hPa. */
63733
- hpa: number(),
64141
+ /** Current pressure in hPa. `null` when the sample was refused (D393). */
64142
+ hpa: number().nullable().meta(readingMeta("pressure", { precision: 0 })),
63734
64143
  /** Ms epoch when the slice was last updated. */
63735
- lastFetchedAt: number(),
63736
- /** Live display unit from the upstream source (e.g. HA
63737
- * `attributes.unit_of_measurement`). The UI prefers this over the
63738
- * role's canonical unit. Absent → fall back to the canonical unit. */
63739
- unit: string().optional(),
63740
- /** Suggested decimal places for numeric display.
63741
- * Populated live from the upstream source when provided (e.g. HA
63742
- * `attributes.suggested_display_precision`). Falls back to
63743
- * auto-formatting when absent. */
63744
- precision: number().int().min(0).max(10).optional()
64144
+ lastFetchedAt: number()
63745
64145
  });
63746
64146
  var pressureSensorCapability = {
63747
64147
  name: "pressure-sensor",
@@ -64155,8 +64555,8 @@ DeviceType.Camera, method(PtzMoveCommandSchema.extend({ deviceId: number() }), _
64155
64555
  }), _void(), { kind: "mutation" });
64156
64556
  var PtzAutotrackSettingsSchema = object({
64157
64557
  targetType: string().describe("Vendor target string (people/vehicle/pet); empty = camera default"),
64158
- stopDelaySeconds: number().int().min(0).max(300),
64159
- disappearDelaySeconds: number().int().min(0).max(300)
64558
+ stopDelaySeconds: number().int().min(0).max(300).meta(readingMeta("duration")),
64559
+ disappearDelaySeconds: number().int().min(0).max(300).meta(readingMeta("duration"))
64160
64560
  });
64161
64561
  /**
64162
64562
  * One option the camera advertises as a valid `targetType`. Drivers
@@ -64310,7 +64710,7 @@ var RunningStateStatusSchema = object({
64310
64710
  /** null = unknown — never coerced to false (D393). */
64311
64711
  running: boolean().nullable(),
64312
64712
  /** Epoch ms the current boolean began; null while `running` is null. */
64313
- since: number().nullable(),
64713
+ since: number().nullable().meta(readingMeta("none")),
64314
64714
  source: RunningStateSourceSchema.meta({ label: "Source" }),
64315
64715
  phase: string().nullable(),
64316
64716
  /** null until a reading has been published (D393). */
@@ -64325,7 +64725,6 @@ var RUNNING_DEVICE_TYPES = Object.values(DeviceType);
64325
64725
  /** Generic Customize target for the running boolean (D936). */
64326
64726
  var runningCustomize = {
64327
64727
  version: 1,
64328
- advanced: "derive",
64329
64728
  targets: [{
64330
64729
  id: "running",
64331
64730
  cardinality: "scalar",
@@ -64345,7 +64744,7 @@ var runningCustomize = {
64345
64744
  DeviceType.Thermostat,
64346
64745
  DeviceType.PetFeeder
64347
64746
  ],
64348
- apply: "add-or-replace",
64747
+ apply: "add",
64349
64748
  path: "running",
64350
64749
  sources: [
64351
64750
  {
@@ -65609,9 +66008,9 @@ var RecordTriggerSchema = _enum([
65609
66008
  */
65610
66009
  var RecordWindowSchema = object({
65611
66010
  trigger: RecordTriggerSchema,
65612
- day: number().int().min(0).max(6),
65613
- startMinute: number().int().min(0).max(1439),
65614
- endMinute: number().int().min(1).max(1440)
66011
+ day: number().int().min(0).max(6).meta(readingMeta("none")),
66012
+ startMinute: number().int().min(0).max(1439).meta(readingMeta("none")),
66013
+ endMinute: number().int().min(1).max(1440).meta(readingMeta("none"))
65615
66014
  });
65616
66015
  /** Status of one physical volume, as the camera itself describes it. */
65617
66016
  var OnboardStorageVolumeSchema = object({
@@ -65687,10 +66086,10 @@ var RecordingOnboardStatusSchema = object({
65687
66086
  /** Master "record to the card at all" switch. */
65688
66087
  enabled: boolean().nullable(),
65689
66088
  overwriteWhenFull: boolean().nullable(),
65690
- preRecordSec: number().nullable(),
65691
- postRecordSec: number().nullable(),
66089
+ preRecordSec: number().nullable().meta(readingMeta("duration")),
66090
+ postRecordSec: number().nullable().meta(readingMeta("duration")),
65692
66091
  /** Length of one recorded file, in minutes. */
65693
- segmentMinutes: number().nullable(),
66092
+ segmentMinutes: number().nullable().meta(readingMeta("none")),
65694
66093
  /** The primary track's weekly windows, flattened. */
65695
66094
  windows: array(RecordWindowSchema),
65696
66095
  /**
@@ -65706,7 +66105,7 @@ var RecordingOnboardStatusSchema = object({
65706
66105
  * provider reporting a non-zero count also reports the schedule as not
65707
66106
  * writable.
65708
66107
  */
65709
- unreadableWindows: number(),
66108
+ unreadableWindows: number().meta(readingMeta("count")),
65710
66109
  /**
65711
66110
  * The camera is scheduled to record and has NO usable storage.
65712
66111
  *
@@ -66551,7 +66950,7 @@ var CamStreamDescriptorSchema = object({
66551
66950
  url: string().optional(),
66552
66951
  codec: string().optional(),
66553
66952
  resolution: CamStreamResolutionSchema.optional(),
66554
- fps: number().positive().optional(),
66953
+ fps: number().positive().optional().meta(readingMeta("rate")),
66555
66954
  label: string().optional(),
66556
66955
  /** Device-level features (e.g. `battery-operated`) — drives broker policy. */
66557
66956
  deviceFeatures: array(string()).optional(),
@@ -66638,18 +67037,18 @@ var StreamProfileSchema = _enum([
66638
67037
  ]);
66639
67038
  /** The current encoding config of one stream profile. */
66640
67039
  var StreamProfileConfigSchema = object({
66641
- width: number(),
66642
- height: number(),
67040
+ width: number().meta(readingMeta("none")),
67041
+ height: number().meta(readingMeta("none")),
66643
67042
  codec: _enum(["h264", "h265"]),
66644
- framerate: number(),
66645
- bitrate: number(),
67043
+ framerate: number().meta(readingMeta("rate")),
67044
+ bitrate: number().meta(readingMeta("bitrate")),
66646
67045
  bitrateMode: _enum(["vbr", "cbr"]).optional(),
66647
67046
  encoderProfile: _enum([
66648
67047
  "high",
66649
67048
  "main",
66650
67049
  "baseline"
66651
67050
  ]).optional(),
66652
- gop: number().optional(),
67051
+ gop: number().optional().meta(readingMeta("none")),
66653
67052
  /**
66654
67053
  * Whether THIS profile currently carries an audio track. READ-ONLY here.
66655
67054
  *
@@ -66870,12 +67269,7 @@ var switchCapability = {
66870
67269
  label: "On",
66871
67270
  kind: "boolean"
66872
67271
  }
66873
- }] },
66874
- customize: {
66875
- version: 1,
66876
- advanced: "derive",
66877
- targets: []
66878
- }
67272
+ }] }
66879
67273
  };
66880
67274
  /** C0 controls, DEL and the C1 range: none of them belongs in a name. */
66881
67275
  function hasControlCharacter(value) {
@@ -67458,35 +67852,21 @@ var tamperCapability = {
67458
67852
  * entries with `device_class: temperature` and any future native
67459
67853
  * thermometer.
67460
67854
  *
67461
- * Unit normalisation: providers convert to Celsius before storing.
67462
- * The slice value is always Celsius so cross-cap aggregators
67463
- * (climate-control's `currentTemp`, energy analytics) can compose
67464
- * without per-source unit fixups. The canonical display unit (`°C`) is
67465
- * a descriptor constant in the UI (ROLE_DESCRIPTOR), not stored in
67466
- * `sourceInfo`.
67855
+ * The number is Celsius (D944). Providers convert on ingest. A failed
67856
+ * conversion is `null`, never a guess. Display unit is a read-time preference.
67467
67857
  *
67468
67858
  * Status `lastFetchedAt` lets staleness-aware consumers detect a
67469
67859
  * frozen feed (provider hung) distinct from a "temperature hasn't
67470
67860
  * changed" steady state.
67471
67861
  */
67472
67862
  var TemperatureSensorStatusSchema = object({
67473
- /** Current temperature in Celsius. */
67474
- celsius: number().meta({
67475
- unit: "°C",
67863
+ /** Current temperature in Celsius. `null` when the sample was refused (D393). */
67864
+ celsius: number().nullable().meta(readingMeta("temperature", {
67865
+ precision: 1,
67476
67866
  label: "Temperature"
67477
- }),
67867
+ })),
67478
67868
  /** Ms epoch when the slice was last updated (push or poll). */
67479
- lastFetchedAt: number(),
67480
- /** Live display unit from the upstream source (e.g. HA
67481
- * `attributes.unit_of_measurement`). The UI prefers this over the
67482
- * role's canonical unit, so a Fahrenheit feed renders '°F' not '°C'.
67483
- * Absent → the UI falls back to the role's canonical unit. */
67484
- unit: string().optional(),
67485
- /** Suggested decimal places for numeric display.
67486
- * Populated live from the upstream source when provided (e.g. HA
67487
- * `attributes.suggested_display_precision`). Falls back to
67488
- * auto-formatting when absent. */
67489
- precision: number().int().min(0).max(10).optional()
67869
+ lastFetchedAt: number()
67490
67870
  });
67491
67871
  var temperatureSensorCapability = {
67492
67872
  name: "temperature-sensor",
@@ -67517,12 +67897,7 @@ var temperatureSensorCapability = {
67517
67897
  } } },
67518
67898
  /** Clock fields: written, but excluded from the compare that decides
67519
67899
  * whether persisting is worth a SQLite commit. */
67520
- volatileStateFields: ["lastFetchedAt"],
67521
- customize: {
67522
- version: 1,
67523
- advanced: "derive",
67524
- targets: []
67525
- }
67900
+ volatileStateFields: ["lastFetchedAt"]
67526
67901
  };
67527
67902
  /**
67528
67903
  * toast — system-scoped singleton capability that streams toast
@@ -67805,16 +68180,16 @@ var VacuumControlStatusSchema = object({
67805
68180
  ]),
67806
68181
  /** 0..100 battery percentage. Null when the device has no battery
67807
68182
  * reading. */
67808
- batteryLevel: number().min(0).max(100).nullable(),
68183
+ batteryLevel: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
67809
68184
  /** Current fan-speed token (provider-verbatim). Null when unknown or
67810
68185
  * the vacuum has no speed control. */
67811
68186
  fanSpeed: string().nullable(),
67812
68187
  /** Speed tokens the hardware accepts — drives the UI selector. */
67813
68188
  availableFanSpeeds: array(string()),
67814
68189
  /** 0..100 cleaning-completion percentage of the current task, or null. */
67815
- progressPercent: number().min(0).max(100).nullable(),
68190
+ progressPercent: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
67816
68191
  /** Current error code (0 / null = no error). */
67817
- errorCode: number().nullable(),
68192
+ errorCode: number().nullable().meta(readingMeta("none")),
67818
68193
  /** Human label for {@link errorCode}, or null when none / undecodable. */
67819
68194
  errorLabel: string().nullable(),
67820
68195
  /** Ms epoch when the slice was last updated. */
@@ -67892,7 +68267,7 @@ var ValveStatusSchema = object({
67892
68267
  ]),
67893
68268
  /** 0 = fully closed, 100 = fully open. Null when the device has no
67894
68269
  * intermediate position surface. */
67895
- position: number().min(0).max(100).nullable(),
68270
+ position: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
67896
68271
  /** Ms epoch when the slice was last updated. */
67897
68272
  lastChangedAt: number()
67898
68273
  });
@@ -68000,9 +68375,9 @@ var vibrationCapability = {
68000
68375
  */
68001
68376
  var WaterHeaterStatusSchema = object({
68002
68377
  /** Current measured temperature. Null when not reported. */
68003
- currentTemp: number().nullable(),
68378
+ currentTemp: number().nullable().meta(readingMeta("temperature")),
68004
68379
  /** Target temperature setpoint. Null when no setpoint surface. */
68005
- targetTemp: number().nullable(),
68380
+ targetTemp: number().nullable().meta(readingMeta("temperature")),
68006
68381
  /** Active operation mode = HA `state` (`eco` / `electric` / `gas` /
68007
68382
  * `heat_pump` / `high_demand` / `performance` / `off`). Null when the
68008
68383
  * device reports an unknown state. */
@@ -68013,9 +68388,9 @@ var WaterHeaterStatusSchema = object({
68013
68388
  * has no away surface. */
68014
68389
  away: boolean().nullable(),
68015
68390
  /** HA `min_temp` attribute. Null when not reported. */
68016
- minTemp: number().nullable(),
68391
+ minTemp: number().nullable().meta(readingMeta("temperature")),
68017
68392
  /** HA `max_temp` attribute. Null when not reported. */
68018
- maxTemp: number().nullable(),
68393
+ maxTemp: number().nullable().meta(readingMeta("temperature")),
68019
68394
  /** Ms epoch when the slice was last updated. */
68020
68395
  lastChangedAt: number()
68021
68396
  });
@@ -68100,25 +68475,18 @@ var waterHeaterCapability = {
68100
68475
  * Forecast deferred — current conditions only for v1.
68101
68476
  */
68102
68477
  var WeatherStatusSchema = object({
68103
- /** Verbatim HA condition state (`sunny`, `cloudy`, `rainy`, …). Null
68104
- * when no condition has been reported yet. */
68478
+ /** Verbatim condition state (`sunny`, `cloudy`, `rainy`, …). Null when none yet. */
68105
68479
  condition: string().nullable(),
68106
- /** Current temperature in the reported unit. Null when not provided. */
68107
- temperature: number().nullable(),
68108
- /** Temperature unit string (e.g. `°C` / `°F`). Null when not provided. */
68109
- temperatureUnit: string().nullable(),
68480
+ /** Current temperature in Celsius. Null when not provided or refused. */
68481
+ temperature: number().nullable().meta(readingMeta("temperature", { precision: 1 })),
68110
68482
  /** Relative humidity (0..100). Null when not provided. */
68111
- humidity: number().min(0).max(100).nullable(),
68112
- /** Barometric pressure in the reported unit. Null when not provided. */
68113
- pressure: number().nullable(),
68114
- /** Pressure unit string (e.g. `hPa` / `inHg`). Null when not provided. */
68115
- pressureUnit: string().nullable(),
68116
- /** Wind speed in the reported unit. Null when not provided. */
68117
- windSpeed: number().nullable(),
68118
- /** Wind-speed unit string (e.g. `km/h` / `mph`). Null when not provided. */
68119
- windSpeedUnit: string().nullable(),
68483
+ humidity: number().min(0).max(100).nullable().meta(readingMeta("humidity")),
68484
+ /** Barometric pressure in hPa. Null when not provided or refused. */
68485
+ pressure: number().nullable().meta(readingMeta("pressure")),
68486
+ /** Wind speed in metres per second. Null when not provided or refused. */
68487
+ windSpeed: number().nullable().meta(readingMeta("speed")),
68120
68488
  /** Wind bearing in degrees (0..360, meteorological). Null when not provided. */
68121
- windBearing: number().nullable(),
68489
+ windBearing: number().nullable().meta(readingMeta("angle")),
68122
68490
  /** Ms epoch when the slice was last updated. */
68123
68491
  lastFetchedAt: number()
68124
68492
  });
@@ -68146,12 +68514,12 @@ var weatherCapability = {
68146
68514
  */
68147
68515
  durability: "session",
68148
68516
  /**
68149
- * History (D850): recorded series. Units follow the sibling `*Unit` fields.
68517
+ * History (D850): recorded series. Numbers are the quantity base (D944).
68150
68518
  */
68151
68519
  history: { fields: {
68152
68520
  temperature: {
68153
68521
  kind: "gauge",
68154
- unitFrom: "temperatureUnit",
68522
+ unit: "°C",
68155
68523
  deadband: .2
68156
68524
  },
68157
68525
  humidity: {
@@ -68161,12 +68529,12 @@ var weatherCapability = {
68161
68529
  },
68162
68530
  pressure: {
68163
68531
  kind: "gauge",
68164
- unitFrom: "pressureUnit",
68532
+ unit: "hPa",
68165
68533
  deadband: .5
68166
68534
  },
68167
68535
  windSpeed: {
68168
68536
  kind: "gauge",
68169
- unitFrom: "windSpeedUnit",
68537
+ unit: "m/s",
68170
68538
  deadband: .5
68171
68539
  }
68172
68540
  } }
@@ -69397,6 +69765,8 @@ var DEVICE_LOCAL_STATE_CAPS = {
69397
69765
  featureProbe: featureProbeCapability,
69398
69766
  flood: floodCapability,
69399
69767
  gas: gasCapability,
69768
+ groupCommands: groupCommandsCapability,
69769
+ groupStatus: groupStatusCapability,
69400
69770
  heatingValve: heatingValveCapability,
69401
69771
  humidifier: humidifierCapability,
69402
69772
  humiditySensor: humiditySensorCapability,
@@ -70290,6 +70660,13 @@ Object.freeze({
70290
70660
  access: "view",
70291
70661
  role: "admin"
70292
70662
  },
70663
+ "addons.getPackageDocs": {
70664
+ capName: "addons",
70665
+ capScope: "system",
70666
+ addonId: null,
70667
+ access: "view",
70668
+ role: "admin"
70669
+ },
70293
70670
  "addons.getVersions": {
70294
70671
  capName: "addons",
70295
70672
  capScope: "system",
@@ -73398,6 +73775,20 @@ Object.freeze({
73398
73775
  access: "view",
73399
73776
  role: "viewer"
73400
73777
  },
73778
+ "groupCommands.getStatus": {
73779
+ capName: "group-commands",
73780
+ capScope: "device",
73781
+ addonId: null,
73782
+ access: "view",
73783
+ role: "viewer"
73784
+ },
73785
+ "groupStatus.getStatus": {
73786
+ capName: "group-status",
73787
+ capScope: "device",
73788
+ addonId: null,
73789
+ access: "view",
73790
+ role: "viewer"
73791
+ },
73401
73792
  "heatingValve.getStatus": {
73402
73793
  capName: "heating-valve",
73403
73794
  capScope: "device",
@@ -83220,6 +83611,37 @@ var SENSOR_CAP_VOCABULARY = {
83220
83611
  icon: "flame"
83221
83612
  }]
83222
83613
  },
83614
+ "group-commands": {
83615
+ scope: "device",
83616
+ noun: t("Group command", "Comando di gruppo")
83617
+ },
83618
+ "group-status": {
83619
+ scope: "device",
83620
+ noun: t("Group", "Gruppo"),
83621
+ state: [
83622
+ {
83623
+ kind: "numeric",
83624
+ field: "included",
83625
+ quantity: t("the members reporting", "i membri che rispondono"),
83626
+ label: t("Reporting", "Rispondono"),
83627
+ icon: "users"
83628
+ },
83629
+ {
83630
+ kind: "numeric",
83631
+ field: "excluded",
83632
+ quantity: t("the members left out", "i membri esclusi"),
83633
+ label: t("Excluded", "Esclusi"),
83634
+ icon: "users"
83635
+ },
83636
+ {
83637
+ kind: "numeric",
83638
+ field: "total",
83639
+ quantity: t("the member count", "il numero di membri"),
83640
+ label: t("Members", "Membri"),
83641
+ icon: "sigma"
83642
+ }
83643
+ ]
83644
+ },
83223
83645
  "humidity-sensor": {
83224
83646
  scope: "device",
83225
83647
  noun: t("Humidity", "Umidità"),
@@ -83253,7 +83675,6 @@ var SENSOR_CAP_VOCABULARY = {
83253
83675
  field: "value",
83254
83676
  quantity: t("the reading", "il valore"),
83255
83677
  label: t("Reading", "Valore"),
83256
- unitField: "unit",
83257
83678
  icon: "gauge"
83258
83679
  }]
83259
83680
  },
@@ -83389,7 +83810,7 @@ var SENSOR_CAP_VOCABULARY = {
83389
83810
  field: "temperature",
83390
83811
  quantity: t("the outdoor temperature", "la temperatura esterna"),
83391
83812
  label: t("Temperature", "Temperatura"),
83392
- unitField: "temperatureUnit",
83813
+ unit: "°C",
83393
83814
  icon: "thermometer"
83394
83815
  },
83395
83816
  {
@@ -83405,7 +83826,7 @@ var SENSOR_CAP_VOCABULARY = {
83405
83826
  field: "windSpeed",
83406
83827
  quantity: t("the wind speed", "la velocità del vento"),
83407
83828
  label: t("Wind", "Vento"),
83408
- unitField: "windSpeedUnit",
83829
+ unit: "m/s",
83409
83830
  icon: "wind"
83410
83831
  },
83411
83832
  {
@@ -83413,7 +83834,7 @@ var SENSOR_CAP_VOCABULARY = {
83413
83834
  field: "pressure",
83414
83835
  quantity: t("the air pressure", "la pressione atmosferica"),
83415
83836
  label: t("Pressure", "Pressione"),
83416
- unitField: "pressureUnit",
83837
+ unit: "hPa",
83417
83838
  icon: "gauge"
83418
83839
  }
83419
83840
  ]
@@ -84686,6 +85107,16 @@ Object.freeze({
84686
85107
  form: "single",
84687
85108
  optional: false
84688
85109
  }],
85110
+ "groupCommands.getStatus": [{
85111
+ name: "deviceId",
85112
+ form: "single",
85113
+ optional: false
85114
+ }],
85115
+ "groupStatus.getStatus": [{
85116
+ name: "deviceId",
85117
+ form: "single",
85118
+ optional: false
85119
+ }],
84689
85120
  "heatingValve.getStatus": [{
84690
85121
  name: "deviceId",
84691
85122
  form: "single",
@@ -86670,6 +87101,8 @@ new Map(Object.entries({
86670
87101
  "detection-blind": "device-events",
86671
87102
  "motion-noisy": "device-events",
86672
87103
  "motion-calm": "device-events",
87104
+ "package-llm-silent": "device-events",
87105
+ "package-llm-answered": "device-events",
86673
87106
  "recording-stalled": "device-events",
86674
87107
  "recording-healthy": "device-events",
86675
87108
  "recording-degraded": "device-events",
@@ -86753,6 +87186,12 @@ var NC_SYSTEM_EVENT_KIND_GROUP_SPECS = [
86753
87186
  label: "Motion without a subject",
86754
87187
  kinds: ["motion-noisy", "motion-calm"]
86755
87188
  },
87189
+ {
87190
+ id: "package-llm",
87191
+ family: "device-events",
87192
+ label: "Package confirm",
87193
+ kinds: ["package-llm-silent", "package-llm-answered"]
87194
+ },
86756
87195
  {
86757
87196
  id: "recording",
86758
87197
  family: "device-events",
@@ -86934,6 +87373,8 @@ var DEVICE_EVENTS = [
86934
87373
  "detection-blind",
86935
87374
  "motion-noisy",
86936
87375
  "motion-calm",
87376
+ "package-llm-silent",
87377
+ "package-llm-answered",
86937
87378
  "recording-stalled",
86938
87379
  "recording-healthy",
86939
87380
  "recording-degraded",
@@ -87202,6 +87643,15 @@ new Map([
87202
87643
  snapshotLabel: "Cameras with constant motion now",
87203
87644
  snapshotSection: null
87204
87645
  },
87646
+ {
87647
+ id: "package-llm-confirm",
87648
+ family: "device-events",
87649
+ label: "Package confirm (not answering / answering again)",
87650
+ bad: ["package-llm-silent"],
87651
+ recovery: ["package-llm-answered"],
87652
+ snapshotLabel: "Cameras whose package confirm is not answering",
87653
+ snapshotSection: null
87654
+ },
87205
87655
  {
87206
87656
  id: "recording-health",
87207
87657
  family: "device-events",