@kusinta/iot-schema 0.2.0-beta.6 → 0.2.0-beta.60

package/src/kusinta/iot/device/v1/device_event_pb.d.ts

@@ -60,12 +60,21 @@ export declare type DeviceEvent = Message<"kusinta.iot.device.v1.DeviceEvent"> &
   eventId: number;
 
   /**
-   * Matter's EventNumber: monotonically increasing per node, and the reason an event log
-   * can be resumed rather than merely replayed. A consumer that sees a gap knows it missed
-   * something and can say so — the one guarantee a PropertyUpdate stream cannot give.
+   * The device's event number, as its connector numbers it — per device, where Matter's
+   * EventNumber is per node; a connector renumbers what a node gives it. It is the reason
+   * an event log can be resumed rather than merely replayed. A consumer that sees a gap
+   * knows it missed something and can say so — the one guarantee a PropertyUpdate stream
+   * cannot give. On the app leg a gap is judged by previous_event_number and follows_loss
+   * below, not by a skip in this number.
    *
-   * Monotonic within one device. Do NOT compare across devices; they are unrelated
-   * sequences.
+   * Monotonic within one device, its connector and one numbering_id — a device that moves
+   * to another connector begins a new sequence — and consecutive as a connector delivers
+   * it: a connector numbers each device's events on its own, so a skip means events were
+   * lost — including ones the connector lost itself, whose numbers it skips. A number at or
+   * below one already received for the device from the same connector under the same
+   * numbering_id is that event again — a connector resends what it could not confirm,
+   * always the whole unconfirmed tail of what it sent, in order — and is dropped. Do NOT
+   * compare across devices; they are unrelated sequences.
    *
    * @generated from field: uint64 event_number = 5;
    */
@@ -92,6 +101,81 @@ export declare type DeviceEvent = Message<"kusinta.iot.device.v1.DeviceEvent"> &
    * @generated from field: kusinta.iot.device.v1.AttributeValue data = 8;
    */
   data?: AttributeValue | undefined;
+
+  /**
+   * How a recipient tells events it was not sent from events that were lost. Filled by the
+   * gateway on the app leg; a connector leaves both unset.
+   *
+   * A recipient is not sent every event of a device: which ones it receives depends on its
+   * grant (access.v1.DeviceAcl.allowed_event_refs), so event_number skips wherever an event
+   * went to somebody else. A skip in event_number is therefore NOT a gap. A gap is:
+   *
+   *   * previous_event_number set, the recipient holding a last-received event_number for
+   *     this device under the same numbering_id (whether or not it kept the event), and
+   *     previous_event_number above it — its log misses events the gateway sent this user,
+   *     on another session or while it was away, or that were lost; one at or below it is
+   *     no gap; or
+   *   * follows_loss set on an event above the last number the recipient holds, or when it
+   *     holds none.
+   *
+   * Otherwise — previous_event_number unset, or the recipient holding no number for the
+   * device under that numbering_id — continuity is unknown, and only follows_loss claims a
+   * gap: the gateway knows events were lost, whatever the recipient holds.
+   *
+   * event_number counts a device's events over its life, so it tells anyone it reaches
+   * roughly how many events came before; that much the number discloses. And it is still
+   * the device's own, so a recipient granted only some of a device's events learns from it
+   * how many it was not sent: that much a partial grant of events discloses.
+   *
+   * previous_event_number never names an event from before the user's current residency in
+   * a home, nor from before their current, unbroken stretch of seeing the device, nor from
+   * before the home's climate history was last cleared (webrtc.v1 household.proto, CLIMATE
+   * HISTORY), which erases its events — it is unset instead, and follows_loss then looks no
+   * further back either. Otherwise it is the
+   * event_number of the previous event of this device that this user was due — within the
+   * grant they held when it happened — whether or not any session of theirs was open to be
+   * sent it, so that events missed while away are a gap like any other. A number of the
+   * event's own numbering_id. Unset when the gateway has received no such event under that
+   * numbering since the gateway itself last started — the first event after a numbering
+   * restart included: continuity is then unknown. The gateway remembers nothing of a
+   * numbering across its own restart, so follows_loss too covers only what it received
+   * since, and a resend it can no longer recognise reaches the app: an app drops an event
+   * whose number is at or below the last it holds for the device under the same
+   * numbering_id.
+   *
+   * @generated from field: optional uint64 previous_event_number = 9;
+   */
+  previousEventNumber?: bigint | undefined;
+
+  /**
+   * Set when the gateway itself missed events of this device since previous_event_number —
+   * or, when that is unset, since the latest of the start of what the user may learn of the
+   * device, the start of the current numbering and the gateway's own last start — the
+   * sequence it receives from the device skipped. A restart of the numbering is not itself
+   * a loss; a connector shows what it lost by skipping numbers. What was lost is unknown,
+   * so it may have been an event this recipient would have been sent.
+   *
+   * @generated from field: bool follows_loss = 10;
+   */
+  followsLoss: boolean;
+
+  /**
+   * Which numbering event_number belongs to. A connector changes it whenever it restarts a
+   * device's numbering — after losing its own count — so that a restart is never mistaken
+   * for a resend. The gateway then begins a new sequence for the device: the first event of
+   * it that each user is due carries previous_event_number unset, continuity unknown. A new
+   * value is one never used before for the device — a UUIDv4 is the expected form. Opaque;
+   * compare for equality only. Empty is a numbering like any other, for a connector whose
+   * count for a device never restarts; a connector that begins a device's sequence anew —
+   * having lost its count, or the device having come back to it — must give it a
+   * numbering_id never used for that device before. Every numbering starts at 1. On the app leg
+   * the gateway derives it from the connector's own id and the connector's numbering_id
+   * alone, so that it is the same across a gateway restart and changes whenever either
+   * does — a numbering restart, or a device moving to another connector.
+   *
+   * @generated from field: string numbering_id = 11;
+   */
+  numberingId: string;
 };
 
 /**

package/src/kusinta/iot/device/v1/device_event_pb.js

@@ -11,7 +11,7 @@ import { file_kusinta_iot_identity_v1_identity } from "../../identity/v1/identit
  * Describes the file kusinta/iot/device/v1/device_event.proto.
  */
 export const file_kusinta_iot_device_v1_device_event = /*@__PURE__*/
-  fileDesc("CihrdXNpbnRhL2lvdC9kZXZpY2UvdjEvZGV2aWNlX2V2ZW50LnByb3RvEhVrdXNpbnRhLmlvdC5kZXZpY2UudjEixQIKC0RldmljZUV2ZW50EjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkEhgKC2VuZHBvaW50X2lkGAIgASgNSACIAQESEgoKY2x1c3Rlcl9pZBgDIAEoDRIQCghldmVudF9pZBgEIAEoDRIUCgxldmVudF9udW1iZXIYBSABKAQSLQoJdGltZXN0YW1wGAYgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBI2Cghwcmlvcml0eRgHIAEoDjIkLmt1c2ludGEuaW90LmRldmljZS52MS5FdmVudFByaW9yaXR5EjMKBGRhdGEYCCABKAsyJS5rdXNpbnRhLmlvdC5kZXZpY2UudjEuQXR0cmlidXRlVmFsdWVCDgoMX2VuZHBvaW50X2lkIncKEERldmljZUV2ZW50QmF0Y2gSMgoGZXZlbnRzGAEgAygLMiIua3VzaW50YS5pb3QuZGV2aWNlLnYxLkRldmljZUV2ZW50Ei8KC3JlY2VpdmVkX2F0GAIgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcCp/Cg1FdmVudFByaW9yaXR5Eh4KGkVWRU5UX1BSSU9SSVRZX1VOU1BFQ0lGSUVEEAASGAoURVZFTlRfUFJJT1JJVFlfREVCVUcQARIXChNFVkVOVF9QUklPUklUWV9JTkZPEAISGwoXRVZFTlRfUFJJT1JJVFlfQ1JJVElDQUwQA0ICSAFiBnByb3RvMw", [file_google_protobuf_timestamp, file_kusinta_iot_device_v1_cluster_state, file_kusinta_iot_identity_v1_identity]);
+  fileDesc("CihrdXNpbnRhL2lvdC9kZXZpY2UvdjEvZGV2aWNlX2V2ZW50LnByb3RvEhVrdXNpbnRhLmlvdC5kZXZpY2UudjEirwMKC0RldmljZUV2ZW50EjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkEhgKC2VuZHBvaW50X2lkGAIgASgNSACIAQESEgoKY2x1c3Rlcl9pZBgDIAEoDRIQCghldmVudF9pZBgEIAEoDRIUCgxldmVudF9udW1iZXIYBSABKAQSLQoJdGltZXN0YW1wGAYgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBI2Cghwcmlvcml0eRgHIAEoDjIkLmt1c2ludGEuaW90LmRldmljZS52MS5FdmVudFByaW9yaXR5EjMKBGRhdGEYCCABKAsyJS5rdXNpbnRhLmlvdC5kZXZpY2UudjEuQXR0cmlidXRlVmFsdWUSIgoVcHJldmlvdXNfZXZlbnRfbnVtYmVyGAkgASgESAGIAQESFAoMZm9sbG93c19sb3NzGAogASgIEhQKDG51bWJlcmluZ19pZBgLIAEoCUIOCgxfZW5kcG9pbnRfaWRCGAoWX3ByZXZpb3VzX2V2ZW50X251bWJlciJ3ChBEZXZpY2VFdmVudEJhdGNoEjIKBmV2ZW50cxgBIAMoCzIiLmt1c2ludGEuaW90LmRldmljZS52MS5EZXZpY2VFdmVudBIvCgtyZWNlaXZlZF9hdBgCIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXAqfwoNRXZlbnRQcmlvcml0eRIeChpFVkVOVF9QUklPUklUWV9VTlNQRUNJRklFRBAAEhgKFEVWRU5UX1BSSU9SSVRZX0RFQlVHEAESFwoTRVZFTlRfUFJJT1JJVFlfSU5GTxACEhsKF0VWRU5UX1BSSU9SSVRZX0NSSVRJQ0FMEANCAkgBYgZwcm90bzM", [file_google_protobuf_timestamp, file_kusinta_iot_device_v1_cluster_state, file_kusinta_iot_identity_v1_identity]);
 
 /**
  * Describes the message kusinta.iot.device.v1.DeviceEvent.

package/src/kusinta/iot/device/v1/device_pb.d.ts

@@ -2,11 +2,11 @@
 // @generated from file kusinta/iot/device/v1/device.proto (package kusinta.iot.device.v1, syntax proto3)
 /* eslint-disable */
 
-import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
 import type { Message } from "@bufbuild/protobuf";
 import type { ColorTemperatureLightProperties, ContactSensorProperties, DimmableLightProperties, DoorLockProperties, EnergySensorProperties, HumiditySensorProperties, OccupancySensorProperties, OnOffLightProperties, PowerSourceProperties, PressureSensorProperties, TemperatureSensorProperties, ThermostatProperties, WindowCoveringProperties } from "./properties_pb.js";
 import type { HmMaintenanceProps, HmThermostatProps } from "../../vendor/homematic/v1/homematic_pb.js";
-import type { ClusterState } from "./cluster_state_pb.js";
+import type { AttributeBehaviour, ClusterState } from "./cluster_state_pb.js";
 import type { DeviceDescriptor } from "./descriptor_pb.js";
 import type { Timestamp } from "@bufbuild/protobuf/wkt";
 
@@ -25,7 +25,8 @@ export declare const file_kusinta_iot_device_v1_device: GenFile;
  * per physical device, so a device is still one row, one claim, one placement.
  *
  * Field numbers: 1-2 identity, 3-49 standard Matter device types, 50-99 vendor
- * extensions.
+ * extensions — the vendor_properties cases, and radio_link (52) and heat_source (53) outside
+ * that oneof.
  *
  * endpoint_id is Matter's own endpoint number, and it is scoped to ONE DEVICE — not
  * global, and nothing coordinates numbering between devices. Endpoint 1 on one valve and
@@ -181,6 +182,29 @@ export declare type Endpoint = Message<"kusinta.iot.device.v1.Endpoint"> & {
     case: "hmMaintenance";
   } | { case: undefined; value?: undefined };
 
+  /**
+   * How well this device's radio link is doing, on whichever endpoint its connector
+   * reports it. Outside vendor_properties on purpose: it is not a vendor's extension of
+   * one device type but a reading any radio device has, so it must be able to sit beside
+   * whichever vendor case the endpoint already carries — on a HomeMatic device's Power
+   * Source endpoint, beside hm_maintenance. Selected by the vendor branch like a
+   * vendor_properties case, by its (vendor_extension) key "kusinta.radio".
+   *
+   * @generated from field: kusinta.iot.device.v1.RadioLink radio_link = 52;
+   */
+  radioLink?: RadioLink | undefined;
+
+  /**
+   * A heat source's own readings, on the endpoint its connector reports them on. Outside
+   * vendor_properties for the reason radio_link is: they are not one vendor's extension but
+   * readings any heat source may have, whoever made it, and they must be able to sit beside a
+   * vendor case the same endpoint carries. Selected by the vendor branch by its
+   * (vendor_extension) key "kusinta.heat_source".
+   *
+   * @generated from field: kusinta.iot.device.v1.HeatSourceReadings heat_source = 53;
+   */
+  heatSource?: HeatSourceReadings | undefined;
+
   /**
    * Every cluster this endpoint hosts: what it supports, and any attribute value that has
    * no typed field above. This is what makes a device the schema does not model usable
@@ -195,14 +219,18 @@ export declare type Endpoint = Message<"kusinta.iot.device.v1.Endpoint"> & {
   clusters: ClusterState[];
 
   /**
-   * Which vendor parameters this endpoint's vendor extension actually implements, in the
+   * Which vendor parameters this endpoint's vendor extensions actually implement, in the
    * vendor's own spelling — "SABOTAGE", matching (vendor_attribute) byte for byte.
    *
    * The vendor mirror of ClusterState.attribute_ids, and it needs its own field because a
    * vendor parameter has no cluster and so no ClusterState to be listed in. A name list
-   * rather than an id list because the vendor branch addresses by name, and a bare list
-   * rather than a per-extension map because an endpoint carries at most one vendor
-   * extension.
+   * rather than an id list because the vendor branch addresses by name. A bare list
+   * rather than a per-extension map because an endpoint carries at most one
+   * vendor_properties case and at most a radio_link and a heat_source beside it, and the
+   * schema keeps the attribute names of radio_link, heat_source and every vendor_properties
+   * case disjoint — a test enforces it — so a name here never needs its extension to be
+   * read. radio_link's and heat_source's parameters are listed here the same way as a
+   * vendor's.
    *
    * Same reading as the Matter side: named here with no value = implemented, not yet
    * reported. Absent from the list = this device does not have it. Empty = not stated,
@@ -215,6 +243,18 @@ export declare type Endpoint = Message<"kusinta.iot.device.v1.Endpoint"> & {
    * @generated from field: repeated string vendor_attribute_names = 17;
    */
   vendorAttributeNames: string[];
+
+  /**
+   * What a write to each vendor parameter leaves behind, and how late its reports arrive,
+   * keyed by the parameter's vendor name as vendor_attribute_names spells it. The vendor
+   * mirror of ClusterState.attribute_behaviours, with the same rules: an absent key is
+   * "not stated", and not stated is read as the worst case. For a parameter reached through
+   * a vendor's service, the name is the vendor's stable parameter id where it has one,
+   * never a display name that is translated or renamed between firmware versions.
+   *
+   * @generated from field: map<string, kusinta.iot.device.v1.AttributeBehaviour> vendor_attribute_behaviours = 18;
+   */
+  vendorAttributeBehaviours: { [key: string]: AttributeBehaviour };
 };
 
 /**
@@ -246,15 +286,43 @@ export declare type Device = Message<"kusinta.iot.device.v1.Device"> & {
   descriptor?: DeviceDescriptor | undefined;
 
   /**
-   * 15-19 are free; 20+ is the timestamp band.
+   * 17-19 are free; 20+ is the timestamp band.
    *
    * @generated from field: repeated kusinta.iot.device.v1.Endpoint endpoints = 14;
    */
   endpoints: Endpoint[];
 
   /**
-   * When the gateway last had evidence this device exists and is reachable — the
-   * most recent PropertyUpdate, announcement, or command result concerning it.
+   * The fewest seconds this device needs between two writes, to any of its attributes on
+   * any endpoint, without dropping one: a radio limited to a share of airtime, a battery
+   * device that wakes on a schedule. A device-wide budget rather than a per-attribute one,
+   * because two attributes each written at their own pace still share one radio. Stated by
+   * the producer at announcement. Absent: not stated, never zero.
+   *
+   * A lower bound, not the whole budget: devices behind one radio gateway or one hub share
+   * its airtime, and a vendor's service limits an account rather than a device, so a writer
+   * may have to space writes further apart than this says.
+   *
+   * @generated from field: optional uint32 min_write_interval_seconds = 15;
+   */
+  minWriteIntervalSeconds?: number | undefined;
+
+  /**
+   * The longest a write can take to reach the device: a device that listens only after
+   * its own report takes a write at its next one. Stated by the producer at announcement.
+   * Absent: not stated, never zero. A writer that renews a lease renews it this long, plus
+   * a margin, before the lease runs out, or the output lapses between renewals.
+   *
+   * @generated from field: optional uint32 max_write_delay_seconds = 16;
+   */
+  maxWriteDelaySeconds?: number | undefined;
+
+  /**
+   * When the gateway last had evidence this device itself — the
+   * most recent PropertyUpdate (wheter or not the property changed) or command
+   * result concerning it. Should not be advanced on a device announcement: a
+   * connector typically re-announces from its own device list, so a device with a
+   * flat battery would otherwise keep looking freshly seen.
    * Gateway-observed, not connector-reported: no message on either leg carries a
    * per-device liveness timestamp, so this is as precise as the device's own report
    * interval. A device that reports every 15 minutes looks stale for 15 minutes.
@@ -265,12 +333,20 @@ export declare type Device = Message<"kusinta.iot.device.v1.Device"> & {
    * Advisory, for showing staleness in a UI. It is not a removal signal — that is
    * webrtc.v1.DeviceRemoved, sent only when a connector reports the device gone.
    *
+   * Unset in a service view (access.v1.DeviceAcl.relation SERVICE): a device that reports on
+   * change would give away each opening and each turn of a knob. Service learns whether it
+   * is reachable from webrtc.v1.ServiceStatus.
+   *
    * @generated from field: google.protobuf.Timestamp last_seen = 20;
    */
   lastSeen?: Timestamp | undefined;
 
   /**
-   * When any field of this Device last changed value.
+   * When any field of this Device last changed value. Unset in a service view, for the
+   * reason last_seen is. Both are also unset when they date from before the recipient's
+   * current residency in the home, or from a home they did not live in at the time (see
+   * access.v1.MembershipRelation).
+   * Whether such a device is reachable is still told by its webrtc.v1.ServiceStatus.
    *
    * @generated from field: google.protobuf.Timestamp last_updated = 21;
    */
@@ -283,3 +359,360 @@ export declare type Device = Message<"kusinta.iot.device.v1.Device"> & {
  */
 export declare const DeviceSchema: GenMessage<Device>;
 
+/**
+ * A heat source's own readings: the temperatures its controller measures and works out, and
+ * its run state — what it is producing, its compressor, its degree minutes, its alarm — as its
+ * connector reads them from the heat source or the maker's service. What
+ * heating.v1.HeatingPlant.readings_device_id reads a plant's heat source by.
+ *
+ * Travels as vendor-branch PropertyUpdates with vendor_extension "kusinta.heat_source" and
+ * these attribute names, the value case following the field type as everywhere on the vendor
+ * branch. A temperature is in centidegrees (°C × 100) as int_value, as temperatures are
+ * throughout this schema: a connector converts what the heat source gives — degrees with a
+ * decimal, a maker's register scale — into centidegrees and rounds it no further. An
+ * enum-valued reading travels as its number in uint_value, as RadioLink.quality does, and
+ * keeps explicit presence: its UNSPECIFIED is never sent, since an unreported one is an
+ * absent field.
+ *
+ * Vendor-neutral on purpose: the same message for every heat source, a heat pump, a boiler
+ * or a district-heating substation, so that whoever reads a plant reads one shape. Which of
+ * the maker's points carries each reading, and how its codes map onto the values here, is
+ * the connector's mapping and not part of this contract; a reading the heat source has no
+ * sensor or state for is never sent, never sent as zero.
+ *
+ * Every field is `optional`, for the reason vendor readings always are: absent means never
+ * reported, present means a reading, 0 °C included. Read only: a heat source is steered
+ * through its plant's control inputs (heating.v1.HeatPumpControl), never by writing these.
+ *
+ * Who is sent them follows the device, as for any device's readings
+ * (access.v1.MembershipRelation), whoever owns the heat source (common.v1.AssetOwner decides
+ * nothing of who sees what). A heat source filed in a home is household data there: its
+ * readings go to the home's residents and never to service (access.v1.DeviceAcl.relation
+ * SERVICE), who are given of it only what a webrtc.v1.ServiceStatus carries, within the
+ * service signals (access.v1.ServiceSignal): an alarm as a fault (alarm_active), and never
+ * alarm_code or any other reading here.
+ *
+ * @generated from message kusinta.iot.device.v1.HeatSourceReadings
+ */
+export declare type HeatSourceReadings = Message<"kusinta.iot.device.v1.HeatSourceReadings"> & {
+  /**
+   * The heat source's own outdoor sensor: the outdoor temperature its heating curve works
+   * from.
+   *
+   * @generated from field: optional sint32 outdoor_centidegrees = 1;
+   */
+  outdoorCentidegrees?: number | undefined;
+
+  /**
+   * The supply (flow) line from the heat source to its climate system, at its own sensor —
+   * its first climate system where it serves several. Where radiators and a floor circuit
+   * share it, this is the shared supply, before the floor circuit's own mixing
+   * (heating.v1.FloorCircuit.supply_probe reads after it).
+   *
+   * @generated from field: optional sint32 supply_centidegrees = 2;
+   */
+  supplyCentidegrees?: number | undefined;
+
+  /**
+   * The return line into the heat source, at its own sensor: the combined return of
+   * everything it heats.
+   *
+   * @generated from field: optional sint32 return_centidegrees = 3;
+   */
+  returnCentidegrees?: number | undefined;
+
+  /**
+   * The top of the hot-water tank: how hot the water available to draw is.
+   *
+   * @generated from field: optional sint32 hot_water_top_centidegrees = 4;
+   */
+  hotWaterTopCentidegrees?: number | undefined;
+
+  /**
+   * The hot-water tank's charging sensor: the one the heat source starts and stops making
+   * hot water by.
+   *
+   * @generated from field: optional sint32 hot_water_charging_centidegrees = 5;
+   */
+  hotWaterChargingCentidegrees?: number | undefined;
+
+  /**
+   * The supply temperature the heat source's own control is aiming for on the line
+   * supply_centidegrees reads, as it has worked it out from its heating curve and the
+   * outdoor temperature, with whatever offsets it applies. Its target, not a measurement.
+   *
+   * @generated from field: optional sint32 calculated_supply_centidegrees = 6;
+   */
+  calculatedSupplyCentidegrees?: number | undefined;
+
+  /**
+   * What the heat source is producing now (HeatSourceProduction), as its number. While it
+   * makes hot water its supply and return say nothing of the space heating, which is what a
+   * consumer reading them for the heating sets aside. A connector that cannot tell what its
+   * heat source is producing sends none, rather than a guess or OTHER: OTHER is a state the
+   * heat source reports, not a reading the connector lacks.
+   *
+   * @generated from field: optional uint32 producing = 7;
+   */
+  producing?: number | undefined;
+
+  /**
+   * Its compressor's state (CompressorState), as its number — its first compressor, where it
+   * has several. Absent for a heat source with none.
+   *
+   * @generated from field: optional uint32 compressor_state = 8;
+   */
+  compressorState?: number | undefined;
+
+  /**
+   * Its degree minutes, in whole degree-minutes (°C × minutes), rounded to the nearest: the
+   * running sum over time of how far the supply has been from calculated_supply_centidegrees,
+   * negative while it has run below it. What a heat source that keeps one starts its
+   * compressor and its add-on heat by, at thresholds of its own. Absent for a heat source
+   * that keeps none.
+   *
+   * @generated from field: optional sint32 degree_minutes = 9;
+   */
+  degreeMinutes?: number | undefined;
+
+  /**
+   * Whether the heat source reports an alarm now. An error it reports in its own operation:
+   * service is given it as webrtc.v1.SERVICE_FAULT_ERROR (access.v1.SERVICE_SIGNAL_FAULT), as
+   * any device's error, and nothing more of it.
+   *
+   * @generated from field: optional bool alarm_active = 10;
+   */
+  alarmActive?: boolean | undefined;
+
+  /**
+   * The maker's own number for its most severe current alarm, for whoever looks it up in the
+   * maker's documentation. Vendor-specific: it means nothing without the product, and no
+   * consumer decides anything by it. Present only while alarm_active is true; a connector
+   * sends a null value (PropertyUpdate.null_value) when the alarm ends. Never sent to service,
+   * in a home or out of one.
+   *
+   * @generated from field: optional uint32 alarm_code = 11;
+   */
+  alarmCode?: number | undefined;
+
+  /**
+   * The power its internal electric add-on heat (an immersion heater or an electric boiler
+   * inside the heat source) draws now, in watts: 0 while it is off or blocked. Absent for a
+   * heat source without one, or whose connector cannot read it.
+   *
+   * @generated from field: optional uint32 add_on_heat_watts = 12;
+   */
+  addOnHeatWatts?: number | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.device.v1.HeatSourceReadings.
+ * Use `create(HeatSourceReadingsSchema)` to create a new message.
+ */
+export declare const HeatSourceReadingsSchema: GenMessage<HeatSourceReadings>;
+
+/**
+ * A device's radio link, as its connector reports it.
+ *
+ * Travels as vendor-branch PropertyUpdates with vendor_extension "kusinta.radio" and
+ * these attribute names, the value case following the field type as everywhere on the
+ * vendor branch: "quality" as uint_value, "rssi_dbm" as int_value, "snr_db" as
+ * float_value.
+ *
+ * Every field is `optional`, for the reason vendor readings always are: absent means
+ * never reported, present means a reading.
+ *
+ * Technology-agnostic: the same message for every radio. A vendor's own raw radio
+ * readings, such as HmMaintenanceProps.rssi_device, stay in that vendor's extension.
+ *
+ * @generated from message kusinta.iot.device.v1.RadioLink
+ */
+export declare type RadioLink = Message<"kusinta.iot.device.v1.RadioLink"> & {
+  /**
+   * The connector's rating: GOOD = 1, FAIR = 2, POOR = 3 (RadioQuality); 0 is not used.
+   * A number, not the name, as every enum-valued reading travels.
+   *
+   * @generated from field: optional uint32 quality = 1;
+   */
+  quality?: number | undefined;
+
+  /**
+   * Received signal strength in dBm. sint32: negative in normal operation.
+   *
+   * @generated from field: optional sint32 rssi_dbm = 2;
+   */
+  rssiDbm?: number | undefined;
+
+  /**
+   * Signal-to-noise ratio in dB, for technologies that measure one — LoRaWAN does.
+   * Absent elsewhere. Negative values are normal for LoRa.
+   *
+   * @generated from field: optional float snr_db = 3;
+   */
+  snrDb?: number | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.device.v1.RadioLink.
+ * Use `create(RadioLinkSchema)` to create a new message.
+ */
+export declare const RadioLinkSchema: GenMessage<RadioLink>;
+
+/**
+ * The value set of HeatSourceReadings.producing: what a heat source is producing now. Not a
+ * field type — producing is a uint32 like every enum-valued reading, so it keeps explicit
+ * presence — but the named constants for its numbers. A connector maps its maker's codes onto
+ * these; a code none of them names is OTHER.
+ *
+ * @generated from enum kusinta.iot.device.v1.HeatSourceProduction
+ */
+export enum HeatSourceProduction {
+  /**
+   * Never sent; an unreported state is an absent field.
+   *
+   * @generated from enum value: HEAT_SOURCE_PRODUCTION_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * Producing nothing.
+   *
+   * @generated from enum value: HEAT_SOURCE_PRODUCTION_OFF = 1;
+   */
+  OFF = 1,
+
+  /**
+   * Heating the building: its climate systems.
+   *
+   * @generated from enum value: HEAT_SOURCE_PRODUCTION_SPACE_HEATING = 2;
+   */
+  SPACE_HEATING = 2,
+
+  /**
+   * Making hot water.
+   *
+   * @generated from enum value: HEAT_SOURCE_PRODUCTION_HOT_WATER = 3;
+   */
+  HOT_WATER = 3,
+
+  /**
+   * Heating a pool.
+   *
+   * @generated from enum value: HEAT_SOURCE_PRODUCTION_POOL = 4;
+   */
+  POOL = 4,
+
+  /**
+   * Cooling.
+   *
+   * @generated from enum value: HEAT_SOURCE_PRODUCTION_COOLING = 5;
+   */
+  COOLING = 5,
+
+  /**
+   * Something none of the above names, such as a transfer between stores.
+   *
+   * @generated from enum value: HEAT_SOURCE_PRODUCTION_OTHER = 6;
+   */
+  OTHER = 6,
+}
+
+/**
+ * Describes the enum kusinta.iot.device.v1.HeatSourceProduction.
+ */
+export declare const HeatSourceProductionSchema: GenEnum<HeatSourceProduction>;
+
+/**
+ * The value set of HeatSourceReadings.compressor_state, as the named constants for its
+ * numbers. Starting and stopping are kept apart from running and stopped: while a compressor
+ * starts, the heat it makes has not yet reached the supply, and readings then are not yet what
+ * it runs at.
+ *
+ * @generated from enum kusinta.iot.device.v1.CompressorState
+ */
+export enum CompressorState {
+  /**
+   * Never sent; an unreported state is an absent field.
+   *
+   * @generated from enum value: COMPRESSOR_STATE_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * @generated from enum value: COMPRESSOR_STATE_STOPPED = 1;
+   */
+  STOPPED = 1,
+
+  /**
+   * @generated from enum value: COMPRESSOR_STATE_STARTING = 2;
+   */
+  STARTING = 2,
+
+  /**
+   * @generated from enum value: COMPRESSOR_STATE_RUNNING = 3;
+   */
+  RUNNING = 3,
+
+  /**
+   * @generated from enum value: COMPRESSOR_STATE_STOPPING = 4;
+   */
+  STOPPING = 4,
+
+  /**
+   * Stopped and held off: the heat source says its compressor is blocked, for whatever reason
+   * it has (an external input, a low outdoor temperature, its own restart delay, an alarm).
+   * Not a statement of why.
+   *
+   * @generated from enum value: COMPRESSOR_STATE_BLOCKED = 5;
+   */
+  BLOCKED = 5,
+}
+
+/**
+ * Describes the enum kusinta.iot.device.v1.CompressorState.
+ */
+export declare const CompressorStateSchema: GenEnum<CompressorState>;
+
+/**
+ * The value set of RadioLink.quality: how well a link is doing, as the device's
+ * connector rates it. Not a field type — quality is a uint32 like every enum-valued
+ * reading, so it keeps explicit presence — but the named constants for its numbers.
+ * Defined here, unlike the HomeMatic enum parameters, because this vocabulary is the
+ * schema's own rather than an upstream system's.
+ *
+ * The rating is radio-specific and made by the connector that reaches the device, from
+ * whatever its technology measures; the thresholds behind it are not part of this
+ * contract and may differ between technologies. A consumer shows the rating, and treats
+ * the raw readings as detail.
+ *
+ * @generated from enum kusinta.iot.device.v1.RadioQuality
+ */
+export enum RadioQuality {
+  /**
+   * Never sent; an unreported quality is an absent field.
+   *
+   * @generated from enum value: RADIO_QUALITY_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * @generated from enum value: RADIO_QUALITY_GOOD = 1;
+   */
+  GOOD = 1,
+
+  /**
+   * @generated from enum value: RADIO_QUALITY_FAIR = 2;
+   */
+  FAIR = 2,
+
+  /**
+   * @generated from enum value: RADIO_QUALITY_POOR = 3;
+   */
+  POOR = 3,
+}
+
+/**
+ * Describes the enum kusinta.iot.device.v1.RadioQuality.
+ */
+export declare const RadioQualitySchema: GenEnum<RadioQuality>;
+