@kusinta/iot-schema 0.2.0-beta.35 → 0.2.0-beta.37

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kusinta/iot-schema",
-  "version": "0.2.0-beta.35",
+  "version": "0.2.0-beta.37",
   "type": "module",
   "license": "MIT",
   "files": ["src"],
@@ -27,6 +27,7 @@
     "./access/roles":           "./src/kusinta/iot/access/v1/roles_pb.js",
     "./link":                   "./src/kusinta/iot/link/v1/link_pb.js",
     "./climate":                "./src/kusinta/iot/climate/v1/climate_pb.js",
+    "./heating":                "./src/kusinta/iot/heating/v1/heating_pb.js",
     "./connector":              "./src/kusinta/iot/connector/v1/connector_pb.js",
     "./connector/service":      "./src/kusinta/iot/connector/v1/connector_service_pb.js",
     "./webrtc":                 "./src/kusinta/iot/webrtc/v1/envelope_pb.js",

package/src/kusinta/iot/climate/v1/climate_pb.d.ts

@@ -207,9 +207,63 @@ export declare type RoomClimate = Message<"kusinta.iot.climate.v1.RoomClimate">
    * the sensors service may see are still sent, since setting a room up is service work.
    * Its climate over time is available to service only as an ApartmentClimateSummary.
    *
+   * explanations, target_held_until, planning and the comfort band are withheld in the
+   * same way.
+   *
    * @generated from field: bool state_withheld = 15;
    */
   stateWithheld: boolean;
+
+  /**
+   * Why the room is being held where it is, when that differs from simply holding its
+   * target: a plan heating ahead of an expensive hour, the heat source busy with hot water,
+   * a floor zone held back. Most significant first. An app that shows one shows the first
+   * it can show: a kind and subject it knows, a pair that kind lists, and not past its
+   * ends_at. Empty: nothing beyond the target and condition needs explaining.
+   *
+   * A window, a lost sensor and the rest of RoomClimateCondition are told by condition and
+   * never repeated here; a target a person set is told by target_change and
+   * target_held_until; whether the room is planned for at all is told by planning — one
+   * fact, one place.
+   *
+   * Sent with the room, so a replaced room replaces its list: an explanation absent from
+   * the latest RoomClimate no longer holds.
+   *
+   * @generated from field: repeated kusinta.iot.climate.v1.ClimateExplanation explanations = 16;
+   */
+  explanations: ClimateExplanation[];
+
+  /**
+   * When a target a person set will next be moved by the gateway on its own — a schedule
+   * step, a plan taking over again. Unset: it holds until somebody changes it. Told so that
+   * a person is not surprised when their change ends. Unset whenever target_change is
+   * withheld from the recipient, for the same reasons: it describes the same change.
+   *
+   * @generated from field: google.protobuf.Timestamp target_held_until = 17;
+   */
+  targetHeldUntil?: Timestamp | undefined;
+
+  /**
+   * Whether a plan steers the room. See RoomPlanning.
+   *
+   * @generated from field: kusinta.iot.climate.v1.RoomPlanning planning = 18;
+   */
+  planning: RoomPlanning;
+
+  /**
+   * The comfort band in force, in centidegrees: the lowest and highest a plan may hold the
+   * room at while it heats ahead, coasts or saves on dear energy. Both set or neither, low
+   * no higher than high, and within [min_centidegrees, max_centidegrees] where those are
+   * set. Absent: no band, and a plan holds the room at its target — never 0 °C.
+   *
+   * @generated from field: optional sint32 comfort_band_low_centidegrees = 19;
+   */
+  comfortBandLowCentidegrees?: number | undefined;
+
+  /**
+   * @generated from field: optional sint32 comfort_band_high_centidegrees = 20;
+   */
+  comfortBandHighCentidegrees?: number | undefined;
 };
 
 /**
@@ -218,6 +272,45 @@ export declare type RoomClimate = Message<"kusinta.iot.climate.v1.RoomClimate">
  */
 export declare const RoomClimateSchema: GenMessage<RoomClimate>;
 
+/**
+ * One reason a room, or a part of its heating, is where it is.
+ *
+ * @generated from message kusinta.iot.climate.v1.ClimateExplanation
+ */
+export declare type ClimateExplanation = Message<"kusinta.iot.climate.v1.ClimateExplanation"> & {
+  /**
+   * @generated from field: kusinta.iot.climate.v1.ClimateExplanationKind kind = 1;
+   */
+  kind: ClimateExplanationKind;
+
+  /**
+   * What the cause acts on. The gateway always sets it. An app shows nothing for an
+   * explanation whose subject is unspecified or unknown to it, rather than presenting it
+   * as the room's.
+   *
+   * @generated from field: kusinta.iot.climate.v1.ClimateExplanationSubject subject = 2;
+   */
+  subject: ClimateExplanationSubject;
+
+  /**
+   * When the explanation stops holding. Unset: while the room's latest RoomClimate carries
+   * it. An app MUST NOT show an explanation past its ends_at, also while it cannot reach
+   * the gateway, and while it cannot reach the gateway it shows none without an ends_at:
+   * an explanation that outlives its window is a claim about the room nobody is making any
+   * more. An explanation that holds because of a leased write ends no later than that
+   * lease, after which the output is back at its lapse value whatever the gateway does.
+   *
+   * @generated from field: google.protobuf.Timestamp ends_at = 3;
+   */
+  endsAt?: Timestamp | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.climate.v1.ClimateExplanation.
+ * Use `create(ClimateExplanationSchema)` to create a new message.
+ */
+export declare const ClimateExplanationSchema: GenMessage<ClimateExplanation>;
+
 /**
  * A mode on a home ends when whoever switched it on stops being one of its residents: a new
  * tenant does not inherit the previous one's holiday. A mode on a room ends when the room
@@ -372,6 +465,17 @@ export declare type RoomHistorySample = Message<"kusinta.iot.climate.v1.RoomHist
    * @generated from field: optional uint32 valve_open_seconds = 6;
    */
   valveOpenSeconds?: number | undefined;
+
+  /**
+   * The seconds within the bucket during which any floor zone heating the room was heating
+   * (heating.v1.FloorZone), counted from the contact state the zone's output reports, read
+   * through its closed_value, not from what was commanded. Kept apart from the valve
+   * fields: a zone's duty and a valve's opening are different controls with different time
+   * scales. Absent where no floor zone heats the room.
+   *
+   * @generated from field: optional uint32 floor_heating_seconds = 7;
+   */
+  floorHeatingSeconds?: number | undefined;
 };
 
 /**
@@ -619,6 +723,217 @@ export enum RoomClimateCondition {
  */
 export declare const RoomClimateConditionSchema: GenEnum<RoomClimateCondition>;
 
+/**
+ * Whether a plan steers a room: one that looks ahead at prices, weather and the heat
+ * source and moves the room within its comfort band. A standing state of the room, not a
+ * reason, so it is a field of its own rather than an explanation.
+ *
+ * @generated from enum kusinta.iot.climate.v1.RoomPlanning
+ */
+export enum RoomPlanning {
+  /**
+   * Not stated.
+   *
+   * @generated from enum value: ROOM_PLANNING_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * A plan steers the room. Its explanations say what it is doing.
+   *
+   * @generated from enum value: ROOM_PLANNING_PLANNED = 1;
+   */
+  PLANNED = 1,
+
+  /**
+   * No plan steers the room: planning is switched off for it, or was never set up. The
+   * room follows its target and schedule.
+   *
+   * @generated from enum value: ROOM_PLANNING_NOT_PLANNED = 2;
+   */
+  NOT_PLANNED = 2,
+
+  /**
+   * A plan would steer the room but cannot be made — prices or a forecast are missing —
+   * so the room follows its target and schedule until one can.
+   *
+   * @generated from enum value: ROOM_PLANNING_UNAVAILABLE = 3;
+   */
+  UNAVAILABLE = 3,
+}
+
+/**
+ * Describes the enum kusinta.iot.climate.v1.RoomPlanning.
+ */
+export declare const RoomPlanningSchema: GenEnum<RoomPlanning>;
+
+/**
+ * What held a room, or a part of its heating, where it is. A closed list of causes: the
+ * gateway sends a kind, never a sentence, and the app names each kind in its user's
+ * language. What the cause acts on is ClimateExplanation.subject, and each kind lists the
+ * subjects it may carry. A pair a kind does not list is shown as nothing, so a pair added
+ * later reaches an older app as nothing rather than as a guess.
+ *
+ * No kind identifies another household or anything about one, its activity included.
+ * Where a limit is shared — a building's power, a shared heat source — the explanation
+ * says that this room was limited, never by whom or because of whom. A kind that a source
+ * or limit shared with other homes drives — HOT_WATER_PRIORITY on a shared heat source,
+ * SHARED_POWER_BUDGET, DISTRICT_HEATING_PEAK on a shared connection — is sent only where at
+ * least three homes share that source or limit, in rooms in homes and outside them alike.
+ * Below that, its onset and end would track another home's use as it happens, and the
+ * room carries no explanation for it.
+ *
+ * @generated from enum kusinta.iot.climate.v1.ClimateExplanationKind
+ */
+export enum ClimateExplanationKind {
+  /**
+   * Sender did not set a kind, or sent one this client's schema does not know. An app
+   * shows nothing for it rather than guessing.
+   *
+   * @generated from enum value: CLIMATE_EXPLANATION_KIND_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * Heated ahead of a dearer or colder period, within the comfort band, so less is needed
+   * then. Subjects: ROOM, FLOOR_ZONE.
+   *
+   * @generated from enum value: CLIMATE_EXPLANATION_KIND_PRE_HEAT = 1;
+   */
+  PRE_HEAT = 1,
+
+  /**
+   * Held back while stored heat carries the room, within the comfort band. Subjects: ROOM,
+   * FLOOR_ZONE.
+   *
+   * @generated from enum value: CLIMATE_EXPLANATION_KIND_COASTING = 2;
+   */
+  COASTING = 2,
+
+  /**
+   * Held back while energy is expensive, within the comfort band. Subjects: ROOM,
+   * FLOOR_ZONE, COMFORT_LOAD, ADD_ON_HEATER.
+   *
+   * @generated from enum value: CLIMATE_EXPLANATION_KIND_PRICE_HIGH = 3;
+   */
+  PRICE_HIGH = 3,
+
+  /**
+   * Held back to keep the home's own electricity use below a peak it is charged for.
+   * Subjects: ROOM, FLOOR_ZONE, COMFORT_LOAD, ADD_ON_HEATER.
+   *
+   * @generated from enum value: CLIMATE_EXPLANATION_KIND_PEAK_GUARD = 4;
+   */
+  PEAK_GUARD = 4,
+
+  /**
+   * Paused while the heat source heats domestic hot water. Subjects: ROOM, FLOOR_ZONE.
+   *
+   * @generated from enum value: CLIMATE_EXPLANATION_KIND_HOT_WATER_PRIORITY = 5;
+   */
+  HOT_WATER_PRIORITY = 5,
+
+  /**
+   * Held back to keep electricity that several homes share — a building's connection, a
+   * shared heat source — within its limit. Subjects: ROOM, FLOOR_ZONE, COMFORT_LOAD,
+   * ADD_ON_HEATER.
+   *
+   * @generated from enum value: CLIMATE_EXPLANATION_KIND_SHARED_POWER_BUDGET = 6;
+   */
+  SHARED_POWER_BUDGET = 6,
+
+  /**
+   * Held back to keep a district-heating connection below its charged peak. Subjects:
+   * ROOM, FLOOR_ZONE.
+   *
+   * @generated from enum value: CLIMATE_EXPLANATION_KIND_DISTRICT_HEATING_PEAK = 7;
+   */
+  DISTRICT_HEATING_PEAK = 7,
+
+  /**
+   * Not heated further because the room is at the top of its comfort band, even though
+   * energy is cheap. Subjects: ROOM, FLOOR_ZONE.
+   *
+   * @generated from enum value: CLIMATE_EXPLANATION_KIND_AT_COMFORT_CEILING = 8;
+   */
+  AT_COMFORT_CEILING = 8,
+
+  /**
+   * Run on a cautious fixed share of the time because the reading that steers it has gone
+   * quiet. Subjects: FLOOR_ZONE only — a room's own lost sensor is told by condition. In
+   * the room whose sensor steers the zone, condition says the sensor is lost and this says
+   * what the zone does about it.
+   *
+   * @generated from enum value: CLIMATE_EXPLANATION_KIND_NO_READING = 9;
+   */
+  NO_READING = 9,
+
+  /**
+   * Off because it is outside its time window — a heated floor kept warm for comfort, a
+   * towel heater. Subjects: COMFORT_LOAD only.
+   *
+   * @generated from enum value: CLIMATE_EXPLANATION_KIND_OUTSIDE_WINDOW = 10;
+   */
+  OUTSIDE_WINDOW = 10,
+}
+
+/**
+ * Describes the enum kusinta.iot.climate.v1.ClimateExplanationKind.
+ */
+export declare const ClimateExplanationKindSchema: GenEnum<ClimateExplanationKind>;
+
+/**
+ * What a cause acts on.
+ *
+ * @generated from enum kusinta.iot.climate.v1.ClimateExplanationSubject
+ */
+export enum ClimateExplanationSubject {
+  /**
+   * Sender did not set a subject, or sent one this client's schema does not know — some
+   * decoders read an unknown value as this one. Never the room as a whole.
+   *
+   * @generated from enum value: CLIMATE_EXPLANATION_SUBJECT_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * The room's heating as a whole.
+   *
+   * @generated from enum value: CLIMATE_EXPLANATION_SUBJECT_ROOM = 1;
+   */
+  ROOM = 1,
+
+  /**
+   * A floor zone heating this room. A zone's explanation is sent only in rooms on the same
+   * side of a home's boundary as the zone's control room: rooms in the same home as it, or
+   * rooms outside homes when it is outside one. A zone that heats rooms on both sides
+   * explains itself on its control room's side alone, so a fact withheld across that
+   * boundary does not cross it here.
+   *
+   * @generated from enum value: CLIMATE_EXPLANATION_SUBJECT_FLOOR_ZONE = 2;
+   */
+  FLOOR_ZONE = 2,
+
+  /**
+   * A comfort load in the room: a heated floor kept warm for comfort, a towel heater.
+   *
+   * @generated from enum value: CLIMATE_EXPLANATION_SUBJECT_COMFORT_LOAD = 3;
+   */
+  COMFORT_LOAD = 3,
+
+  /**
+   * The heat source's add-on heater.
+   *
+   * @generated from enum value: CLIMATE_EXPLANATION_SUBJECT_ADD_ON_HEATER = 4;
+   */
+  ADD_ON_HEATER = 4,
+}
+
+/**
+ * Describes the enum kusinta.iot.climate.v1.ClimateExplanationSubject.
+ */
+export declare const ClimateExplanationSubjectSchema: GenEnum<ClimateExplanationSubject>;
+
 /**
  * A setback that applies to every room in a space while it is on.
  *

package/src/kusinta/iot/climate/v1/climate_pb.js

@@ -10,7 +10,7 @@ import { file_kusinta_iot_identity_v1_identity } from "../../identity/v1/identit
  * Describes the file kusinta/iot/climate/v1/climate.proto.
  */
 export const file_kusinta_iot_climate_v1_climate = /*@__PURE__*/
-  fileDesc("CiRrdXNpbnRhL2lvdC9jbGltYXRlL3YxL2NsaW1hdGUucHJvdG8SFmt1c2ludGEuaW90LmNsaW1hdGUudjEiogEKDFRhcmdldENoYW5nZRImCgJhdBgBIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASLwoEdXNlchgCIAEoCzIfLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlVzZXJJZEgAEjMKBmRldmljZRgDIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkSABCBAoCYnki/wUKC1Jvb21DbGltYXRlEjIKCHNwYWNlX2lkGAEgASgLMiAua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuU3BhY2VJZBIgChN0YXJnZXRfY2VudGlkZWdyZWVzGAIgASgRSACIAQESOwoNdGFyZ2V0X2NoYW5nZRgDIAEoCzIkLmt1c2ludGEuaW90LmNsaW1hdGUudjEuVGFyZ2V0Q2hhbmdlEioKHWVmZmVjdGl2ZV90YXJnZXRfY2VudGlkZWdyZWVzGAQgASgRSAGIAQESFgoOb3ZlcnJpZGVzX21vZGUYBSABKAgSNwoNbW9kZV9zcGFjZV9pZBgNIAEoCzIgLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlNwYWNlSWQSHQoQbWluX2NlbnRpZGVncmVlcxgGIAEoEUgCiAEBEh0KEG1heF9jZW50aWRlZ3JlZXMYByABKBFIA4gBARI1CgpzZW5zb3JfaWRzGAggAygLMiEua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuRGV2aWNlSWQSGgoSc2Vuc29yc19jb25maWd1cmVkGA4gASgIEiIKFW1lYXN1cmVkX2NlbnRpZGVncmVlcxgJIAEoEUgEiAEBEjYKC21lYXN1cmVkX2J5GAogASgLMiEua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuRGV2aWNlSWQSPwoJY29uZGl0aW9uGAsgASgOMiwua3VzaW50YS5pb3QuY2xpbWF0ZS52MS5Sb29tQ2xpbWF0ZUNvbmRpdGlvbhIcChRsb2NrX2RldmljZV9jb250cm9scxgMIAEoCBIWCg5zdGF0ZV93aXRoaGVsZBgPIAEoCEIWChRfdGFyZ2V0X2NlbnRpZGVncmVlc0IgCh5fZWZmZWN0aXZlX3RhcmdldF9jZW50aWRlZ3JlZXNCEwoRX21pbl9jZW50aWRlZ3JlZXNCEwoRX21heF9jZW50aWRlZ3JlZXNCGAoWX21lYXN1cmVkX2NlbnRpZGVncmVlcyKDAwoLQ2xpbWF0ZU1vZGUSMgoIc3BhY2VfaWQYASABKAsyIC5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5TcGFjZUlkEjUKBGtpbmQYAiABKA4yJy5rdXNpbnRhLmlvdC5jbGltYXRlLnYxLkNsaW1hdGVNb2RlS2luZBIhChRzZXRiYWNrX2NlbnRpZGVncmVlcxgDIAEoEUgAiAEBEi0KCXN0YXJ0c19hdBgEIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASKwoHZW5kc19hdBgFIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASLwoGc2V0X2J5GAYgASgLMh8ua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuVXNlcklkEjIKCXdhcm1fZnJvbRgHIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXBIAYgBAUIXChVfc2V0YmFja19jZW50aWRlZ3JlZXNCDAoKX3dhcm1fZnJvbSJ5Cg9Sb29tQ2xpbWF0ZUxpc3QSMgoFcm9vbXMYASADKAsyIy5rdXNpbnRhLmlvdC5jbGltYXRlLnYxLlJvb21DbGltYXRlEjIKBW1vZGVzGAIgAygLMiMua3VzaW50YS5pb3QuY2xpbWF0ZS52MS5DbGltYXRlTW9kZSLzAgoRUm9vbUhpc3RvcnlTYW1wbGUSJgoCYXQYASABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEiIKFW1lYXN1cmVkX2NlbnRpZGVncmVlcxgCIAEoEUgAiAEBEiAKE3RhcmdldF9jZW50aWRlZ3JlZXMYAyABKBFIAYgBARIqCh1lZmZlY3RpdmVfdGFyZ2V0X2NlbnRpZGVncmVlcxgEIAEoEUgCiAEBEiAKE3ZhbHZlX29wZW5fcGVybWlsbGUYBSABKA1IA4gBARIfChJ2YWx2ZV9vcGVuX3NlY29uZHMYBiABKA1IBIgBAUIYChZfbWVhc3VyZWRfY2VudGlkZWdyZWVzQhYKFF90YXJnZXRfY2VudGlkZWdyZWVzQiAKHl9lZmZlY3RpdmVfdGFyZ2V0X2NlbnRpZGVncmVlc0IWChRfdmFsdmVfb3Blbl9wZXJtaWxsZUIVChNfdmFsdmVfb3Blbl9zZWNvbmRzIqsBCgtSb29tSGlzdG9yeRIxCgdyb29tX2lkGAEgASgLMiAua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuU3BhY2VJZBItCglrZXB0X2Zyb20YAiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEjoKB3NhbXBsZXMYAyADKAsyKS5rdXNpbnRhLmlvdC5jbGltYXRlLnYxLlJvb21IaXN0b3J5U2FtcGxlItQCChFDbGltYXRlUGVyaW9kTWVhbhItCglzdGFydHNfYXQYASABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEisKB2VuZHNfYXQYAiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEiIKFW1lYXN1cmVkX2NlbnRpZGVncmVlcxgDIAEoEUgAiAEBEiAKE3RhcmdldF9jZW50aWRlZ3JlZXMYBCABKBFIAYgBARIiChptZWFzdXJlZF9jb3ZlcmFnZV9wZXJtaWxsZRgFIAEoDRIgChh0YXJnZXRfY292ZXJhZ2VfcGVybWlsbGUYBiABKA0SFgoOcm9vbXNfbWVhc3VyZWQYByABKA0SDQoFcm9vbXMYCCABKA1CGAoWX21lYXN1cmVkX2NlbnRpZGVncmVlc0IWChRfdGFyZ2V0X2NlbnRpZGVncmVlcyK+AgoXQXBhcnRtZW50Q2xpbWF0ZVN1bW1hcnkSNgoMYXBhcnRtZW50X2lkGAEgASgLMiAua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuU3BhY2VJZBI8CgZwZXJpb2QYAiABKA4yLC5rdXNpbnRhLmlvdC5jbGltYXRlLnYxLkNsaW1hdGVTdW1tYXJ5UGVyaW9kEkIKCXdlaWdodGluZxgDIAEoDjIvLmt1c2ludGEuaW90LmNsaW1hdGUudjEuQ2xpbWF0ZVN1bW1hcnlXZWlnaHRpbmcSLQoJa2VwdF9mcm9tGAQgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBI6CgdwZXJpb2RzGAUgAygLMikua3VzaW50YS5pb3QuY2xpbWF0ZS52MS5DbGltYXRlUGVyaW9kTWVhbirVAgoUUm9vbUNsaW1hdGVDb25kaXRpb24SJgoiUk9PTV9DTElNQVRFX0NPTkRJVElPTl9VTlNQRUNJRklFRBAAEiIKHlJPT01fQ0xJTUFURV9DT05ESVRJT05fSE9MRElORxABEiQKIFJPT01fQ0xJTUFURV9DT05ESVRJT05fTk9fVEFSR0VUEAISJgoiUk9PTV9DTElNQVRFX0NPTkRJVElPTl9TRU5TT1JfTE9TVBADEiYKIlJPT01fQ0xJTUFURV9DT05ESVRJT05fV0lORE9XX09QRU4QBBIlCiFST09NX0NMSU1BVEVfQ09ORElUSU9OX05PX0hFQVRJTkcQBRIuCipST09NX0NMSU1BVEVfQ09ORElUSU9OX0hFQVRJTkdfVU5SRUFDSEFCTEUQBhIkCiBST09NX0NMSU1BVEVfQ09ORElUSU9OX05PX1NFTlNPUhAHKm8KD0NsaW1hdGVNb2RlS2luZBIhCh1DTElNQVRFX01PREVfS0lORF9VTlNQRUNJRklFRBAAEhoKFkNMSU1BVEVfTU9ERV9LSU5EX0FXQVkQARIdChlDTElNQVRFX01PREVfS0lORF9IT0xJREFZEAIqoQEKFENsaW1hdGVTdW1tYXJ5UGVyaW9kEiYKIkNMSU1BVEVfU1VNTUFSWV9QRVJJT0RfVU5TUEVDSUZJRUQQABIeChpDTElNQVRFX1NVTU1BUllfUEVSSU9EX0RBWRABEh8KG0NMSU1BVEVfU1VNTUFSWV9QRVJJT0RfV0VFSxACEiAKHENMSU1BVEVfU1VNTUFSWV9QRVJJT0RfTU9OVEgQAypvChdDbGltYXRlU3VtbWFyeVdlaWdodGluZxIpCiVDTElNQVRFX1NVTU1BUllfV0VJR0hUSU5HX1VOU1BFQ0lGSUVEEAASKQolQ0xJTUFURV9TVU1NQVJZX1dFSUdIVElOR19ST09NU19FUVVBTBABQgJIAWIGcHJvdG8z", [file_google_protobuf_timestamp, file_kusinta_iot_identity_v1_identity]);
+  fileDesc("CiRrdXNpbnRhL2lvdC9jbGltYXRlL3YxL2NsaW1hdGUucHJvdG8SFmt1c2ludGEuaW90LmNsaW1hdGUudjEiogEKDFRhcmdldENoYW5nZRImCgJhdBgBIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASLwoEdXNlchgCIAEoCzIfLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlVzZXJJZEgAEjMKBmRldmljZRgDIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkSABCBAoCYnkizggKC1Jvb21DbGltYXRlEjIKCHNwYWNlX2lkGAEgASgLMiAua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuU3BhY2VJZBIgChN0YXJnZXRfY2VudGlkZWdyZWVzGAIgASgRSACIAQESOwoNdGFyZ2V0X2NoYW5nZRgDIAEoCzIkLmt1c2ludGEuaW90LmNsaW1hdGUudjEuVGFyZ2V0Q2hhbmdlEioKHWVmZmVjdGl2ZV90YXJnZXRfY2VudGlkZWdyZWVzGAQgASgRSAGIAQESFgoOb3ZlcnJpZGVzX21vZGUYBSABKAgSNwoNbW9kZV9zcGFjZV9pZBgNIAEoCzIgLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlNwYWNlSWQSHQoQbWluX2NlbnRpZGVncmVlcxgGIAEoEUgCiAEBEh0KEG1heF9jZW50aWRlZ3JlZXMYByABKBFIA4gBARI1CgpzZW5zb3JfaWRzGAggAygLMiEua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuRGV2aWNlSWQSGgoSc2Vuc29yc19jb25maWd1cmVkGA4gASgIEiIKFW1lYXN1cmVkX2NlbnRpZGVncmVlcxgJIAEoEUgEiAEBEjYKC21lYXN1cmVkX2J5GAogASgLMiEua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuRGV2aWNlSWQSPwoJY29uZGl0aW9uGAsgASgOMiwua3VzaW50YS5pb3QuY2xpbWF0ZS52MS5Sb29tQ2xpbWF0ZUNvbmRpdGlvbhIcChRsb2NrX2RldmljZV9jb250cm9scxgMIAEoCBIWCg5zdGF0ZV93aXRoaGVsZBgPIAEoCBJACgxleHBsYW5hdGlvbnMYECADKAsyKi5rdXNpbnRhLmlvdC5jbGltYXRlLnYxLkNsaW1hdGVFeHBsYW5hdGlvbhI1ChF0YXJnZXRfaGVsZF91bnRpbBgRIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASNgoIcGxhbm5pbmcYEiABKA4yJC5rdXNpbnRhLmlvdC5jbGltYXRlLnYxLlJvb21QbGFubmluZxIqCh1jb21mb3J0X2JhbmRfbG93X2NlbnRpZGVncmVlcxgTIAEoEUgFiAEBEisKHmNvbWZvcnRfYmFuZF9oaWdoX2NlbnRpZGVncmVlcxgUIAEoEUgGiAEBQhYKFF90YXJnZXRfY2VudGlkZWdyZWVzQiAKHl9lZmZlY3RpdmVfdGFyZ2V0X2NlbnRpZGVncmVlc0ITChFfbWluX2NlbnRpZGVncmVlc0ITChFfbWF4X2NlbnRpZGVncmVlc0IYChZfbWVhc3VyZWRfY2VudGlkZWdyZWVzQiAKHl9jb21mb3J0X2JhbmRfbG93X2NlbnRpZGVncmVlc0IhCh9fY29tZm9ydF9iYW5kX2hpZ2hfY2VudGlkZWdyZWVzIsMBChJDbGltYXRlRXhwbGFuYXRpb24SPAoEa2luZBgBIAEoDjIuLmt1c2ludGEuaW90LmNsaW1hdGUudjEuQ2xpbWF0ZUV4cGxhbmF0aW9uS2luZBJCCgdzdWJqZWN0GAIgASgOMjEua3VzaW50YS5pb3QuY2xpbWF0ZS52MS5DbGltYXRlRXhwbGFuYXRpb25TdWJqZWN0EisKB2VuZHNfYXQYAyABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wIoMDCgtDbGltYXRlTW9kZRIyCghzcGFjZV9pZBgBIAEoCzIgLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlNwYWNlSWQSNQoEa2luZBgCIAEoDjInLmt1c2ludGEuaW90LmNsaW1hdGUudjEuQ2xpbWF0ZU1vZGVLaW5kEiEKFHNldGJhY2tfY2VudGlkZWdyZWVzGAMgASgRSACIAQESLQoJc3RhcnRzX2F0GAQgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBIrCgdlbmRzX2F0GAUgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBIvCgZzZXRfYnkYBiABKAsyHy5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5Vc2VySWQSMgoJd2FybV9mcm9tGAcgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcEgBiAEBQhcKFV9zZXRiYWNrX2NlbnRpZGVncmVlc0IMCgpfd2FybV9mcm9tInkKD1Jvb21DbGltYXRlTGlzdBIyCgVyb29tcxgBIAMoCzIjLmt1c2ludGEuaW90LmNsaW1hdGUudjEuUm9vbUNsaW1hdGUSMgoFbW9kZXMYAiADKAsyIy5rdXNpbnRhLmlvdC5jbGltYXRlLnYxLkNsaW1hdGVNb2RlIrEDChFSb29tSGlzdG9yeVNhbXBsZRImCgJhdBgBIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASIgoVbWVhc3VyZWRfY2VudGlkZWdyZWVzGAIgASgRSACIAQESIAoTdGFyZ2V0X2NlbnRpZGVncmVlcxgDIAEoEUgBiAEBEioKHWVmZmVjdGl2ZV90YXJnZXRfY2VudGlkZWdyZWVzGAQgASgRSAKIAQESIAoTdmFsdmVfb3Blbl9wZXJtaWxsZRgFIAEoDUgDiAEBEh8KEnZhbHZlX29wZW5fc2Vjb25kcxgGIAEoDUgEiAEBEiIKFWZsb29yX2hlYXRpbmdfc2Vjb25kcxgHIAEoDUgFiAEBQhgKFl9tZWFzdXJlZF9jZW50aWRlZ3JlZXNCFgoUX3RhcmdldF9jZW50aWRlZ3JlZXNCIAoeX2VmZmVjdGl2ZV90YXJnZXRfY2VudGlkZWdyZWVzQhYKFF92YWx2ZV9vcGVuX3Blcm1pbGxlQhUKE192YWx2ZV9vcGVuX3NlY29uZHNCGAoWX2Zsb29yX2hlYXRpbmdfc2Vjb25kcyKrAQoLUm9vbUhpc3RvcnkSMQoHcm9vbV9pZBgBIAEoCzIgLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlNwYWNlSWQSLQoJa2VwdF9mcm9tGAIgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBI6CgdzYW1wbGVzGAMgAygLMikua3VzaW50YS5pb3QuY2xpbWF0ZS52MS5Sb29tSGlzdG9yeVNhbXBsZSLUAgoRQ2xpbWF0ZVBlcmlvZE1lYW4SLQoJc3RhcnRzX2F0GAEgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBIrCgdlbmRzX2F0GAIgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBIiChVtZWFzdXJlZF9jZW50aWRlZ3JlZXMYAyABKBFIAIgBARIgChN0YXJnZXRfY2VudGlkZWdyZWVzGAQgASgRSAGIAQESIgoabWVhc3VyZWRfY292ZXJhZ2VfcGVybWlsbGUYBSABKA0SIAoYdGFyZ2V0X2NvdmVyYWdlX3Blcm1pbGxlGAYgASgNEhYKDnJvb21zX21lYXN1cmVkGAcgASgNEg0KBXJvb21zGAggASgNQhgKFl9tZWFzdXJlZF9jZW50aWRlZ3JlZXNCFgoUX3RhcmdldF9jZW50aWRlZ3JlZXMivgIKF0FwYXJ0bWVudENsaW1hdGVTdW1tYXJ5EjYKDGFwYXJ0bWVudF9pZBgBIAEoCzIgLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlNwYWNlSWQSPAoGcGVyaW9kGAIgASgOMiwua3VzaW50YS5pb3QuY2xpbWF0ZS52MS5DbGltYXRlU3VtbWFyeVBlcmlvZBJCCgl3ZWlnaHRpbmcYAyABKA4yLy5rdXNpbnRhLmlvdC5jbGltYXRlLnYxLkNsaW1hdGVTdW1tYXJ5V2VpZ2h0aW5nEi0KCWtlcHRfZnJvbRgEIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASOgoHcGVyaW9kcxgFIAMoCzIpLmt1c2ludGEuaW90LmNsaW1hdGUudjEuQ2xpbWF0ZVBlcmlvZE1lYW4q1QIKFFJvb21DbGltYXRlQ29uZGl0aW9uEiYKIlJPT01fQ0xJTUFURV9DT05ESVRJT05fVU5TUEVDSUZJRUQQABIiCh5ST09NX0NMSU1BVEVfQ09ORElUSU9OX0hPTERJTkcQARIkCiBST09NX0NMSU1BVEVfQ09ORElUSU9OX05PX1RBUkdFVBACEiYKIlJPT01fQ0xJTUFURV9DT05ESVRJT05fU0VOU09SX0xPU1QQAxImCiJST09NX0NMSU1BVEVfQ09ORElUSU9OX1dJTkRPV19PUEVOEAQSJQohUk9PTV9DTElNQVRFX0NPTkRJVElPTl9OT19IRUFUSU5HEAUSLgoqUk9PTV9DTElNQVRFX0NPTkRJVElPTl9IRUFUSU5HX1VOUkVBQ0hBQkxFEAYSJAogUk9PTV9DTElNQVRFX0NPTkRJVElPTl9OT19TRU5TT1IQByqGAQoMUm9vbVBsYW5uaW5nEh0KGVJPT01fUExBTk5JTkdfVU5TUEVDSUZJRUQQABIZChVST09NX1BMQU5OSU5HX1BMQU5ORUQQARIdChlST09NX1BMQU5OSU5HX05PVF9QTEFOTkVEEAISHQoZUk9PTV9QTEFOTklOR19VTkFWQUlMQUJMRRADKoAEChZDbGltYXRlRXhwbGFuYXRpb25LaW5kEigKJENMSU1BVEVfRVhQTEFOQVRJT05fS0lORF9VTlNQRUNJRklFRBAAEiUKIUNMSU1BVEVfRVhQTEFOQVRJT05fS0lORF9QUkVfSEVBVBABEiUKIUNMSU1BVEVfRVhQTEFOQVRJT05fS0lORF9DT0FTVElORxACEicKI0NMSU1BVEVfRVhQTEFOQVRJT05fS0lORF9QUklDRV9ISUdIEAMSJwojQ0xJTUFURV9FWFBMQU5BVElPTl9LSU5EX1BFQUtfR1VBUkQQBBIvCitDTElNQVRFX0VYUExBTkFUSU9OX0tJTkRfSE9UX1dBVEVSX1BSSU9SSVRZEAUSMAosQ0xJTUFURV9FWFBMQU5BVElPTl9LSU5EX1NIQVJFRF9QT1dFUl9CVURHRVQQBhIyCi5DTElNQVRFX0VYUExBTkFUSU9OX0tJTkRfRElTVFJJQ1RfSEVBVElOR19QRUFLEAcSLworQ0xJTUFURV9FWFBMQU5BVElPTl9LSU5EX0FUX0NPTUZPUlRfQ0VJTElORxAIEicKI0NMSU1BVEVfRVhQTEFOQVRJT05fS0lORF9OT19SRUFESU5HEAkSKwonQ0xJTUFURV9FWFBMQU5BVElPTl9LSU5EX09VVFNJREVfV0lORE9XEAoq9wEKGUNsaW1hdGVFeHBsYW5hdGlvblN1YmplY3QSKwonQ0xJTUFURV9FWFBMQU5BVElPTl9TVUJKRUNUX1VOU1BFQ0lGSUVEEAASJAogQ0xJTUFURV9FWFBMQU5BVElPTl9TVUJKRUNUX1JPT00QARIqCiZDTElNQVRFX0VYUExBTkFUSU9OX1NVQkpFQ1RfRkxPT1JfWk9ORRACEiwKKENMSU1BVEVfRVhQTEFOQVRJT05fU1VCSkVDVF9DT01GT1JUX0xPQUQQAxItCilDTElNQVRFX0VYUExBTkFUSU9OX1NVQkpFQ1RfQUREX09OX0hFQVRFUhAEKm8KD0NsaW1hdGVNb2RlS2luZBIhCh1DTElNQVRFX01PREVfS0lORF9VTlNQRUNJRklFRBAAEhoKFkNMSU1BVEVfTU9ERV9LSU5EX0FXQVkQARIdChlDTElNQVRFX01PREVfS0lORF9IT0xJREFZEAIqoQEKFENsaW1hdGVTdW1tYXJ5UGVyaW9kEiYKIkNMSU1BVEVfU1VNTUFSWV9QRVJJT0RfVU5TUEVDSUZJRUQQABIeChpDTElNQVRFX1NVTU1BUllfUEVSSU9EX0RBWRABEh8KG0NMSU1BVEVfU1VNTUFSWV9QRVJJT0RfV0VFSxACEiAKHENMSU1BVEVfU1VNTUFSWV9QRVJJT0RfTU9OVEgQAypvChdDbGltYXRlU3VtbWFyeVdlaWdodGluZxIpCiVDTElNQVRFX1NVTU1BUllfV0VJR0hUSU5HX1VOU1BFQ0lGSUVEEAASKQolQ0xJTUFURV9TVU1NQVJZX1dFSUdIVElOR19ST09NU19FUVVBTBABQgJIAWIGcHJvdG8z", [file_google_protobuf_timestamp, file_kusinta_iot_identity_v1_identity]);
 
 /**
  * Describes the message kusinta.iot.climate.v1.TargetChange.
@@ -26,47 +26,54 @@ export const TargetChangeSchema = /*@__PURE__*/
 export const RoomClimateSchema = /*@__PURE__*/
   messageDesc(file_kusinta_iot_climate_v1_climate, 1);
 
+/**
+ * Describes the message kusinta.iot.climate.v1.ClimateExplanation.
+ * Use `create(ClimateExplanationSchema)` to create a new message.
+ */
+export const ClimateExplanationSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_climate_v1_climate, 2);
+
 /**
  * Describes the message kusinta.iot.climate.v1.ClimateMode.
  * Use `create(ClimateModeSchema)` to create a new message.
  */
 export const ClimateModeSchema = /*@__PURE__*/
-  messageDesc(file_kusinta_iot_climate_v1_climate, 2);
+  messageDesc(file_kusinta_iot_climate_v1_climate, 3);
 
 /**
  * Describes the message kusinta.iot.climate.v1.RoomClimateList.
  * Use `create(RoomClimateListSchema)` to create a new message.
  */
 export const RoomClimateListSchema = /*@__PURE__*/
-  messageDesc(file_kusinta_iot_climate_v1_climate, 3);
+  messageDesc(file_kusinta_iot_climate_v1_climate, 4);
 
 /**
  * Describes the message kusinta.iot.climate.v1.RoomHistorySample.
  * Use `create(RoomHistorySampleSchema)` to create a new message.
  */
 export const RoomHistorySampleSchema = /*@__PURE__*/
-  messageDesc(file_kusinta_iot_climate_v1_climate, 4);
+  messageDesc(file_kusinta_iot_climate_v1_climate, 5);
 
 /**
  * Describes the message kusinta.iot.climate.v1.RoomHistory.
  * Use `create(RoomHistorySchema)` to create a new message.
  */
 export const RoomHistorySchema = /*@__PURE__*/
-  messageDesc(file_kusinta_iot_climate_v1_climate, 5);
+  messageDesc(file_kusinta_iot_climate_v1_climate, 6);
 
 /**
  * Describes the message kusinta.iot.climate.v1.ClimatePeriodMean.
  * Use `create(ClimatePeriodMeanSchema)` to create a new message.
  */
 export const ClimatePeriodMeanSchema = /*@__PURE__*/
-  messageDesc(file_kusinta_iot_climate_v1_climate, 6);
+  messageDesc(file_kusinta_iot_climate_v1_climate, 7);
 
 /**
  * Describes the message kusinta.iot.climate.v1.ApartmentClimateSummary.
  * Use `create(ApartmentClimateSummarySchema)` to create a new message.
  */
 export const ApartmentClimateSummarySchema = /*@__PURE__*/
-  messageDesc(file_kusinta_iot_climate_v1_climate, 7);
+  messageDesc(file_kusinta_iot_climate_v1_climate, 8);
 
 /**
  * Describes the enum kusinta.iot.climate.v1.RoomClimateCondition.
@@ -87,11 +94,68 @@ export const RoomClimateConditionSchema = /*@__PURE__*/
 export const RoomClimateCondition = /*@__PURE__*/
   tsEnum(RoomClimateConditionSchema);
 
+/**
+ * Describes the enum kusinta.iot.climate.v1.RoomPlanning.
+ */
+export const RoomPlanningSchema = /*@__PURE__*/
+  enumDesc(file_kusinta_iot_climate_v1_climate, 1);
+
+/**
+ * Whether a plan steers a room: one that looks ahead at prices, weather and the heat
+ * source and moves the room within its comfort band. A standing state of the room, not a
+ * reason, so it is a field of its own rather than an explanation.
+ *
+ * @generated from enum kusinta.iot.climate.v1.RoomPlanning
+ */
+export const RoomPlanning = /*@__PURE__*/
+  tsEnum(RoomPlanningSchema);
+
+/**
+ * Describes the enum kusinta.iot.climate.v1.ClimateExplanationKind.
+ */
+export const ClimateExplanationKindSchema = /*@__PURE__*/
+  enumDesc(file_kusinta_iot_climate_v1_climate, 2);
+
+/**
+ * What held a room, or a part of its heating, where it is. A closed list of causes: the
+ * gateway sends a kind, never a sentence, and the app names each kind in its user's
+ * language. What the cause acts on is ClimateExplanation.subject, and each kind lists the
+ * subjects it may carry. A pair a kind does not list is shown as nothing, so a pair added
+ * later reaches an older app as nothing rather than as a guess.
+ *
+ * No kind identifies another household or anything about one, its activity included.
+ * Where a limit is shared — a building's power, a shared heat source — the explanation
+ * says that this room was limited, never by whom or because of whom. A kind that a source
+ * or limit shared with other homes drives — HOT_WATER_PRIORITY on a shared heat source,
+ * SHARED_POWER_BUDGET, DISTRICT_HEATING_PEAK on a shared connection — is sent only where at
+ * least three homes share that source or limit, in rooms in homes and outside them alike.
+ * Below that, its onset and end would track another home's use as it happens, and the
+ * room carries no explanation for it.
+ *
+ * @generated from enum kusinta.iot.climate.v1.ClimateExplanationKind
+ */
+export const ClimateExplanationKind = /*@__PURE__*/
+  tsEnum(ClimateExplanationKindSchema);
+
+/**
+ * Describes the enum kusinta.iot.climate.v1.ClimateExplanationSubject.
+ */
+export const ClimateExplanationSubjectSchema = /*@__PURE__*/
+  enumDesc(file_kusinta_iot_climate_v1_climate, 3);
+
+/**
+ * What a cause acts on.
+ *
+ * @generated from enum kusinta.iot.climate.v1.ClimateExplanationSubject
+ */
+export const ClimateExplanationSubject = /*@__PURE__*/
+  tsEnum(ClimateExplanationSubjectSchema);
+
 /**
  * Describes the enum kusinta.iot.climate.v1.ClimateModeKind.
  */
 export const ClimateModeKindSchema = /*@__PURE__*/
-  enumDesc(file_kusinta_iot_climate_v1_climate, 1);
+  enumDesc(file_kusinta_iot_climate_v1_climate, 4);
 
 /**
  * A setback that applies to every room in a space while it is on.
@@ -105,7 +169,7 @@ export const ClimateModeKind = /*@__PURE__*/
  * Describes the enum kusinta.iot.climate.v1.ClimateSummaryPeriod.
  */
 export const ClimateSummaryPeriodSchema = /*@__PURE__*/
-  enumDesc(file_kusinta_iot_climate_v1_climate, 2);
+  enumDesc(file_kusinta_iot_climate_v1_climate, 5);
 
 /**
  * The length of the periods an ApartmentClimateSummary is given in. Each period runs from
@@ -130,7 +194,7 @@ export const ClimateSummaryPeriod = /*@__PURE__*/
  * Describes the enum kusinta.iot.climate.v1.ClimateSummaryWeighting.
  */
 export const ClimateSummaryWeightingSchema = /*@__PURE__*/
-  enumDesc(file_kusinta_iot_climate_v1_climate, 3);
+  enumDesc(file_kusinta_iot_climate_v1_climate, 6);
 
 /**
  * How an apartment's mean is formed from its rooms' means.