@kusinta/iot-schema 0.2.0-beta.4 → 0.2.0-beta.41

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

@@ -0,0 +1,1041 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file kusinta/iot/climate/v1/climate.proto (package kusinta.iot.climate.v1, syntax proto3)
+/* eslint-disable */
+
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Message } from "@bufbuild/protobuf";
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import type { DeviceId, SpaceId, UserId } from "../../identity/v1/identity_pb.js";
+
+/**
+ * Describes the file kusinta/iot/climate/v1/climate.proto.
+ */
+export declare const file_kusinta_iot_climate_v1_climate: GenFile;
+
+/**
+ * Who or what last set a room's target, and when.
+ *
+ * Shown beside the target, because under "last change wins" a target that moved on its
+ * own looks like a fault unless the reader can see that somebody turned a radiator by
+ * hand ten minutes ago.
+ *
+ * @generated from message kusinta.iot.climate.v1.TargetChange
+ */
+export declare type TargetChange = Message<"kusinta.iot.climate.v1.TargetChange"> & {
+  /**
+   * @generated from field: google.protobuf.Timestamp at = 1;
+   */
+  at?: Timestamp | undefined;
+
+  /**
+   * @generated from oneof kusinta.iot.climate.v1.TargetChange.by
+   */
+  by: {
+    /**
+     * Set in the app, by this user.
+     *
+     * @generated from field: kusinta.iot.identity.v1.UserId user = 2;
+     */
+    value: UserId;
+    case: "user";
+  } | {
+    /**
+     * Turned by hand at this device: a valve's knob or a wall thermostat's dial, as the
+     * device reported it (Matter Thermostat SetpointChangeSource = Manual). A change the
+     * device made on its own — window-open, frost protection, its own schedule — is never
+     * adopted and never appears here.
+     *
+     * @generated from field: kusinta.iot.identity.v1.DeviceId device = 3;
+     */
+    value: DeviceId;
+    case: "device";
+  } | { case: undefined; value?: undefined };
+};
+
+/**
+ * Describes the message kusinta.iot.climate.v1.TargetChange.
+ * Use `create(TargetChangeSchema)` to create a new message.
+ */
+export declare const TargetChangeSchema: GenMessage<TargetChange>;
+
+/**
+ * The climate of one room.
+ *
+ * Apply as an upsert keyed on space_id: the same room is sent again whenever any of it
+ * that the recipient is sent moves (see state_withheld).
+ *
+ * @generated from message kusinta.iot.climate.v1.RoomClimate
+ */
+export declare type RoomClimate = Message<"kusinta.iot.climate.v1.RoomClimate"> & {
+  /**
+   * A Space of SPACE_TYPE_ROOM.
+   *
+   * @generated from field: kusinta.iot.identity.v1.SpaceId space_id = 1;
+   */
+  spaceId?: SpaceId | undefined;
+
+  /**
+   * The temperature the room is to be held at, in centidegrees. Unset: nobody has set
+   * one. Always within [min_centidegrees, max_centidegrees] where those are set.
+   *
+   * @generated from field: optional sint32 target_centidegrees = 2;
+   */
+  targetCentidegrees?: number | undefined;
+
+  /**
+   * Who or what set target_centidegrees. Unset while the target is, and when it is withheld
+   * from the recipient: from service in a home, and from anyone when it dates from before
+   * their current residency in the home, or from a home they did not live in at the time
+   * (see access.v1.MembershipRelation).
+   *
+   * @generated from field: kusinta.iot.climate.v1.TargetChange target_change = 3;
+   */
+  targetChange?: TargetChange | undefined;
+
+  /**
+   * What the valves are actually being held at, in centidegrees. Equal to the target
+   * unless a ClimateMode on an enclosing space sets the room back — and then the room's
+   * own target again if somebody changed this room during the mode (see
+   * overrides_mode). Unset while nothing is being held.
+   *
+   * @generated from field: optional sint32 effective_target_centidegrees = 4;
+   */
+  effectiveTargetCentidegrees?: number | undefined;
+
+  /**
+   * Set when somebody changed this room while a ClimateMode was on: the room keeps its
+   * own target until the mode ends, while the rest of the apartment stays set back.
+   *
+   * @generated from field: bool overrides_mode = 5;
+   */
+  overridesMode: boolean;
+
+  /**
+   * The space whose ClimateMode applies to this room, if one does — set back or,
+   * with overrides_mode, overridden. Unset when no mode applies.
+   *
+   * @generated from field: kusinta.iot.identity.v1.SpaceId mode_space_id = 13;
+   */
+  modeSpaceId?: SpaceId | undefined;
+
+  /**
+   * The owner's limits, in centidegrees. The gateway writes them to every device in the
+   * room (Matter Min/MaxHeatSetpointLimit), so a knob stops at them physically, and
+   * clamps every target — from the app, a knob or a mode — to them. The minimum is also
+   * the floor under a mode's setback.
+   *
+   * @generated from field: optional sint32 min_centidegrees = 6;
+   */
+  minCentidegrees?: number | undefined;
+
+  /**
+   * @generated from field: optional sint32 max_centidegrees = 7;
+   */
+  maxCentidegrees?: number | undefined;
+
+  /**
+   * The sensors the room measures with, in order: the first is used, each later one
+   * takes over while those before it are quiet. Only devices filed in this room.
+   *
+   * In a home, sensors its residents own come first, in the order they were filed, and then
+   * the building's; outside homes a room measures with the building's sensors only. The
+   * building's are by default every building temperature sensor filed in the room, in the
+   * order it was filed, so a sensor filed later joins at the end without anyone configuring
+   * anything; an owner can set their order explicitly (see sensors_configured). Empty: the
+   * room has no temperature sensor, and its valves regulate on their own probes
+   * (NO_SENSOR).
+   *
+   * @generated from field: repeated kusinta.iot.identity.v1.DeviceId sensor_ids = 8;
+   */
+  sensorIds: DeviceId[];
+
+  /**
+   * Whether the building's part of sensor_ids is an order an owner chose, rather than the
+   * default of filing order. A building sensor filed into a room with a chosen order is
+   * not added to it; a resident's own always is. A sensor that becomes the building's in a
+   * room — released by its owner — counts as filed there at that moment.
+   *
+   * @generated from field: bool sensors_configured = 14;
+   */
+  sensorsConfigured: boolean;
+
+  /**
+   * The reading steering the room now, in centidegrees, and which sensor it came from.
+   * measured_by unset while the valves are on their own probes.
+   *
+   * @generated from field: optional sint32 measured_centidegrees = 9;
+   */
+  measuredCentidegrees?: number | undefined;
+
+  /**
+   * @generated from field: kusinta.iot.identity.v1.DeviceId measured_by = 10;
+   */
+  measuredBy?: DeviceId | undefined;
+
+  /**
+   * @generated from field: kusinta.iot.climate.v1.RoomClimateCondition condition = 11;
+   */
+  condition: RoomClimateCondition;
+
+  /**
+   * Whether the controls on this room's devices are locked. While unlocked, a change made
+   * by hand at a device becomes the room's target. Locked, the gateway sets the devices'
+   * own lock (Matter Thermostat User Interface Configuration KeypadLockout), so the
+   * refusal happens at the device rather than being undone later.
+   *
+   * Stated as the lock rather than as a permission so that the proto3 default — false,
+   * unlocked — is the intended default: a room nobody has configured takes changes at its
+   * devices, as a room in an apartment should until its residents decide otherwise; when a
+   * home loses its last resident, its rooms' locks are cleared. Elsewhere locking is the
+   * owner's choice.
+   *
+   * @generated from field: bool lock_device_controls = 12;
+   */
+  lockDeviceControls: boolean;
+
+  /**
+   * Set when the recipient reaches this room only as service (see
+   * access.v1.MembershipRelation): the room is in someone's home, and what describes the
+   * people in it is WITHHELD — target_centidegrees, target_change,
+   * effective_target_centidegrees, overrides_mode, mode_space_id, measured_centidegrees,
+   * measured_by, condition and lock_device_controls are all left unset, and sensor_ids
+   * leaves out sensors a resident owns.
+   *
+   * Unset because withheld, not because unknown: an app must not render them as NO_TARGET or
+   * a lost sensor. A withheld room is sent again only when something that IS sent changes,
+   * so that the timing of an update does not give away what was withheld. Its limits and
+   * 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;
+};
+
+/**
+ * Describes the message kusinta.iot.climate.v1.RoomClimate.
+ * Use `create(RoomClimateSchema)` to create a new message.
+ */
+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
+ * joins a home, whose rooms follow the apartment's mode alone. Any other mode — one switched on by
+ * someone who is not one of its residents now: who never lived there, or a member still
+ * recorded with no relation — ends when the
+ * home gains a resident: when anyone other than its setter, not already its resident, is
+ * assigned RESIDENT on the apartment, a member recorded with no relation included, or the
+ * space becomes an apartment with RESIDENT members on it other than its setter. A mode's
+ * setter recorded with no relation being assigned RESIDENT ends none of their own modes;
+ * being assigned SERVICE or removed ends them.
+ *
+ * A mode set on an apartment — or, for rooms that are not in one, on their floor or
+ * common area. While it is on it sets back every room below that space, except that a
+ * room inside an apartment follows only its apartment's mode: a mode on a floor does not
+ * reach into the flats on it. Where more than one mode could apply, the nearest enclosing
+ * space's wins. A room somebody changes during the mode keeps its own target
+ * (RoomClimate.overrides_mode) until the mode ends.
+ *
+ * @generated from message kusinta.iot.climate.v1.ClimateMode
+ */
+export declare type ClimateMode = Message<"kusinta.iot.climate.v1.ClimateMode"> & {
+  /**
+   * @generated from field: kusinta.iot.identity.v1.SpaceId space_id = 1;
+   */
+  spaceId?: SpaceId | undefined;
+
+  /**
+   * @generated from field: kusinta.iot.climate.v1.ClimateModeKind kind = 2;
+   */
+  kind: ClimateModeKind;
+
+  /**
+   * The temperature every room is set back to, in centidegrees. Required while a mode is
+   * on — a mode with nothing to set back to is refused, not defaulted. Clamped by each
+   * room's min_centidegrees, which is the frost floor.
+   *
+   * @generated from field: optional sint32 setback_centidegrees = 3;
+   */
+  setbackCentidegrees?: number | undefined;
+
+  /**
+   * HOLIDAY: when the setback begins and when the rooms are to be back at their own
+   * targets — warm by then, not starting to heat (see warm_from). AWAY: starts_at is when it
+   * was switched on; ends_at is unset. starts_at is unset when it dates from before the
+   * recipient's current residency in the home, or from a home they did not live in at the
+   * time; an ends_at ahead is always sent.
+   *
+   * @generated from field: google.protobuf.Timestamp starts_at = 4;
+   */
+  startsAt?: Timestamp | undefined;
+
+  /**
+   * @generated from field: google.protobuf.Timestamp ends_at = 5;
+   */
+  endsAt?: Timestamp | undefined;
+
+  /**
+   * Who switched it on. Unset when it is withheld from the recipient: from service in a
+   * home, and from anyone when it dates from before their current residency in the home, or
+   * from a home they did not live in at the time (see access.v1.MembershipRelation).
+   *
+   * @generated from field: kusinta.iot.identity.v1.UserId set_by = 6;
+   */
+  setBy?: UserId | undefined;
+
+  /**
+   * Read-only: filled by the gateway, ignored if sent to it. The moment the setback ends
+   * ahead of ends_at, so that the rooms are warm by ends_at. Absent when there is no
+   * lead — an AWAY mode, or one the gateway has not computed.
+   *
+   * @generated from field: optional google.protobuf.Timestamp warm_from = 7;
+   */
+  warmFrom?: Timestamp | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.climate.v1.ClimateMode.
+ * Use `create(ClimateModeSchema)` to create a new message.
+ */
+export declare const ClimateModeSchema: GenMessage<ClimateMode>;
+
+/**
+ * Every room climate and mode a caller may see, in reply to a listing.
+ *
+ * @generated from message kusinta.iot.climate.v1.RoomClimateList
+ */
+export declare type RoomClimateList = Message<"kusinta.iot.climate.v1.RoomClimateList"> & {
+  /**
+   * @generated from field: repeated kusinta.iot.climate.v1.RoomClimate rooms = 1;
+   */
+  rooms: RoomClimate[];
+
+  /**
+   * @generated from field: repeated kusinta.iot.climate.v1.ClimateMode modes = 2;
+   */
+  modes: ClimateMode[];
+};
+
+/**
+ * Describes the message kusinta.iot.climate.v1.RoomClimateList.
+ * Use `create(RoomClimateListSchema)` to create a new message.
+ */
+export declare const RoomClimateListSchema: GenMessage<RoomClimateList>;
+
+/**
+ * One fixed 15-minute bucket of a room's history. Every reading is optional: absent
+ * means nothing was known for that bucket, never zero.
+ *
+ * @generated from message kusinta.iot.climate.v1.RoomHistorySample
+ */
+export declare type RoomHistorySample = Message<"kusinta.iot.climate.v1.RoomHistorySample"> & {
+  /**
+   * The start of the bucket. Buckets are fixed 15-minute intervals aligned to UTC
+   * quarter hours (:00, :15, :30, :45).
+   *
+   * @generated from field: google.protobuf.Timestamp at = 1;
+   */
+  at?: Timestamp | undefined;
+
+  /**
+   * The mean of the room's measured temperature over the bucket, in centidegrees.
+   *
+   * @generated from field: optional sint32 measured_centidegrees = 2;
+   */
+  measuredCentidegrees?: number | undefined;
+
+  /**
+   * RoomClimate.target_centidegrees and .effective_target_centidegrees as they were in
+   * force at the bucket's start, in centidegrees.
+   *
+   * @generated from field: optional sint32 target_centidegrees = 3;
+   */
+  targetCentidegrees?: number | undefined;
+
+  /**
+   * @generated from field: optional sint32 effective_target_centidegrees = 4;
+   */
+  effectiveTargetCentidegrees?: number | undefined;
+
+  /**
+   * The mean opening over the bucket across the room's valves that report one, in
+   * thousandths of fully open. Absent if none of them does.
+   *
+   * @generated from field: optional uint32 valve_open_permille = 5;
+   */
+  valveOpenPermille?: number | undefined;
+
+  /**
+   * The seconds within the bucket during which any of the room's valves was open.
+   *
+   * @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;
+};
+
+/**
+ * Describes the message kusinta.iot.climate.v1.RoomHistorySample.
+ * Use `create(RoomHistorySampleSchema)` to create a new message.
+ */
+export declare const RoomHistorySampleSchema: GenMessage<RoomHistorySample>;
+
+/**
+ * A room's history, in reply to GetRoomHistory.
+ *
+ * @generated from message kusinta.iot.climate.v1.RoomHistory
+ */
+export declare type RoomHistory = Message<"kusinta.iot.climate.v1.RoomHistory"> & {
+  /**
+   * @generated from field: kusinta.iot.identity.v1.SpaceId room_id = 1;
+   */
+  roomId?: SpaceId | undefined;
+
+  /**
+   * The earliest moment the gateway still holds for this room. The request's from_time
+   * and to_time are clamped to [kept_from, now], so nothing before kept_from is ever
+   * returned. For a room in the recipient's own home it is no earlier than the start of
+   * their current residency, nor than when the room last joined their home; for any other
+   * room, no earlier than when it last left a home.
+   *
+   * @generated from field: google.protobuf.Timestamp kept_from = 2;
+   */
+  keptFrom?: Timestamp | undefined;
+
+  /**
+   * The buckets within the clamped range, in order of `at`.
+   *
+   * @generated from field: repeated kusinta.iot.climate.v1.RoomHistorySample samples = 3;
+   */
+  samples: RoomHistorySample[];
+};
+
+/**
+ * Describes the message kusinta.iot.climate.v1.RoomHistory.
+ * Use `create(RoomHistorySchema)` to create a new message.
+ */
+export declare const RoomHistorySchema: GenMessage<RoomHistory>;
+
+/**
+ * An apartment's climate over one period.
+ *
+ * Each room's mean is taken over the quarter hours of the period in which it was in this
+ * apartment and had a value; coverage likewise counts only the quarter hours it was here,
+ * and the apartment's mean is formed from the rooms' means as the summary's weighting says.
+ * Every mean is optional: absent means nothing was known, never zero.
+ *
+ * @generated from message kusinta.iot.climate.v1.ClimatePeriodMean
+ */
+export declare type ClimatePeriodMean = Message<"kusinta.iot.climate.v1.ClimatePeriodMean"> & {
+  /**
+   * The period, half-open: starts_at <= t < ends_at.
+   *
+   * @generated from field: google.protobuf.Timestamp starts_at = 1;
+   */
+  startsAt?: Timestamp | undefined;
+
+  /**
+   * @generated from field: google.protobuf.Timestamp ends_at = 2;
+   */
+  endsAt?: Timestamp | undefined;
+
+  /**
+   * The mean measured temperature, in centidegrees, taken from the building's own sensors
+   * only: in each room, the first of its building sensors that was heard. A reading from a
+   * sensor a resident owns never enters it.
+   *
+   * @generated from field: optional sint32 measured_centidegrees = 3;
+   */
+  measuredCentidegrees?: number | undefined;
+
+  /**
+   * The mean target, in centidegrees: RoomClimate.target_centidegrees — the temperature
+   * somebody asked for, not the effective target a mode set it back to, so that a
+   * setback is not reported as what the residents chose. The measured mean still falls
+   * while a home is set back; how much that reveals is governed by how long a period
+   * service may ask for (webrtc.v1.PrivacyDisclosure.climate_summary_period).
+   *
+   * @generated from field: optional sint32 target_centidegrees = 4;
+   */
+  targetCentidegrees?: number | undefined;
+
+  /**
+   * How much of the period the means rest on, in thousandths: the quarter hours with a
+   * value, summed over the apartment's rooms, divided by the quarter hours each room was in
+   * the apartment during the period, summed likewise. A room with no sensor, or one that
+   * went quiet, lowers it — a mean with low coverage describes part of the apartment, or
+   * part of the period.
+   *
+   * @generated from field: uint32 measured_coverage_permille = 5;
+   */
+  measuredCoveragePermille: number;
+
+  /**
+   * @generated from field: uint32 target_coverage_permille = 6;
+   */
+  targetCoveragePermille: number;
+
+  /**
+   * The rooms that contributed a measured value, of the rooms the apartment had at any time
+   * in the period.
+   *
+   * @generated from field: uint32 rooms_measured = 7;
+   */
+  roomsMeasured: number;
+
+  /**
+   * @generated from field: uint32 rooms = 8;
+   */
+  rooms: number;
+};
+
+/**
+ * Describes the message kusinta.iot.climate.v1.ClimatePeriodMean.
+ * Use `create(ClimatePeriodMeanSchema)` to create a new message.
+ */
+export declare const ClimatePeriodMeanSchema: GenMessage<ClimatePeriodMean>;
+
+/**
+ * An apartment's climate as means over whole periods, in reply to
+ * webrtc.v1.GetApartmentClimateSummary. What a party who does not live there may know of
+ * how warm it is kept — see webrtc.v1.PrivacyDisclosure.
+ *
+ * Only CLOSED periods are given. The period running now is never included, so that a
+ * summary cannot be polled into a live reading.
+ *
+ * @generated from message kusinta.iot.climate.v1.ApartmentClimateSummary
+ */
+export declare type ApartmentClimateSummary = Message<"kusinta.iot.climate.v1.ApartmentClimateSummary"> & {
+  /**
+   * @generated from field: kusinta.iot.identity.v1.SpaceId apartment_id = 1;
+   */
+  apartmentId?: SpaceId | undefined;
+
+  /**
+   * @generated from field: kusinta.iot.climate.v1.ClimateSummaryPeriod period = 2;
+   */
+  period: ClimateSummaryPeriod;
+
+  /**
+   * @generated from field: kusinta.iot.climate.v1.ClimateSummaryWeighting weighting = 3;
+   */
+  weighting: ClimateSummaryWeighting;
+
+  /**
+   * The start of the earliest period the gateway still holds that the recipient may be
+   * given: for a resident of this apartment, no earlier than their current residency; for
+   * anyone else, of the length disclosed now, and no earlier than the first such period
+   * after it was last changed (see webrtc.v1.PrivacyDisclosure.climate_summary_period).
+   *
+   * @generated from field: google.protobuf.Timestamp kept_from = 4;
+   */
+  keptFrom?: Timestamp | undefined;
+
+  /**
+   * The periods within the requested range, in order of starts_at.
+   *
+   * @generated from field: repeated kusinta.iot.climate.v1.ClimatePeriodMean periods = 5;
+   */
+  periods: ClimatePeriodMean[];
+};
+
+/**
+ * Describes the message kusinta.iot.climate.v1.ApartmentClimateSummary.
+ * Use `create(ApartmentClimateSummarySchema)` to create a new message.
+ */
+export declare const ApartmentClimateSummarySchema: GenMessage<ApartmentClimateSummary>;
+
+/**
+ * What a room is doing right now, in one word. Details live in the fields of
+ * RoomClimate; this is what a list row shows.
+ *
+ * Where several hold at once the room reports the first that applies, in this order:
+ * NO_TARGET, NO_HEATING, WINDOW_OPEN, HEATING_UNREACHABLE, SENSOR_LOST, NO_SENSOR,
+ * HOLDING — the one that most changes what a person should expect of the room.
+ *
+ * @generated from enum kusinta.iot.climate.v1.RoomClimateCondition
+ */
+export enum RoomClimateCondition {
+  /**
+   * @generated from enum value: ROOM_CLIMATE_CONDITION_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * Being held at its effective target from a sensor's reading.
+   *
+   * @generated from enum value: ROOM_CLIMATE_CONDITION_HOLDING = 1;
+   */
+  HOLDING = 1,
+
+  /**
+   * Nobody has set a target yet. Not a fault: a room that was just created.
+   *
+   * @generated from enum value: ROOM_CLIMATE_CONDITION_NO_TARGET = 2;
+   */
+  NO_TARGET = 2,
+
+  /**
+   * Every sensor the room uses has gone quiet. The valves regulate on their own probes
+   * towards the target meanwhile — worse comfort, never a frozen reading.
+   *
+   * @generated from enum value: ROOM_CLIMATE_CONDITION_SENSOR_LOST = 3;
+   */
+  SENSOR_LOST = 3,
+
+  /**
+   * A window in the room is open, so heating is paused.
+   *
+   * @generated from enum value: ROOM_CLIMATE_CONDITION_WINDOW_OPEN = 4;
+   */
+  WINDOW_OPEN = 4,
+
+  /**
+   * The room has a target but nothing in it can heat.
+   *
+   * @generated from enum value: ROOM_CLIMATE_CONDITION_NO_HEATING = 5;
+   */
+  NO_HEATING = 5,
+
+  /**
+   * Every heating device in the room has gone quiet, so nothing is being held however
+   * the target is set.
+   *
+   * @generated from enum value: ROOM_CLIMATE_CONDITION_HEATING_UNREACHABLE = 6;
+   */
+  HEATING_UNREACHABLE = 6,
+
+  /**
+   * The room has no temperature sensor, so its valves regulate on their own probes
+   * towards the target. Not a fault; a room can be set up that way.
+   *
+   * @generated from enum value: ROOM_CLIMATE_CONDITION_NO_SENSOR = 7;
+   */
+  NO_SENSOR = 7,
+}
+
+/**
+ * Describes the enum kusinta.iot.climate.v1.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.
+ *
+ * @generated from enum kusinta.iot.climate.v1.ClimateModeKind
+ */
+export enum ClimateModeKind {
+  /**
+   * No mode: every room at its own target.
+   *
+   * @generated from enum value: CLIMATE_MODE_KIND_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * Every room to the setback until the mode is switched off.
+   *
+   * @generated from enum value: CLIMATE_MODE_KIND_AWAY = 1;
+   */
+  AWAY = 1,
+
+  /**
+   * Every room to the setback between starts_at and ends_at, then back to normal on its
+   * own — timed so the rooms are warm again at ends_at, not starting to heat then.
+   *
+   * @generated from enum value: CLIMATE_MODE_KIND_HOLIDAY = 2;
+   */
+  HOLIDAY = 2,
+}
+
+/**
+ * Describes the enum kusinta.iot.climate.v1.ClimateModeKind.
+ */
+export declare const ClimateModeKindSchema: GenEnum<ClimateModeKind>;
+
+/**
+ * The length of the periods an ApartmentClimateSummary is given in. Each period runs from
+ * the start of one local date to the start of another in the building's time zone
+ * (space.v1.Space.time_zone) — midnight, or the first moment of the date where daylight
+ * saving skips midnight — so a day is 23 or 25 hours long across a change of daylight
+ * saving time. A period is cut by the time zone in force when it opened, and kept as cut.
+ * After a change of zone, the next period runs from that cut to the first boundary of its
+ * length in the new zone — a midnight, a Monday or a first of the month — that leaves it
+ * covering at least one whole day, week or month of the new zone's calendar, so no period
+ * covers less than one whole day, week or month of its calendar, however many hours that
+ * is. While the zone is unknown — never set, or cleared — nothing is summarised, and the
+ * period open when it was cleared ends unsummarised; once it is known again, the first
+ * period begins at the first boundary of its length after that.
+ *
+ * @generated from enum kusinta.iot.climate.v1.ClimateSummaryPeriod
+ */
+export enum ClimateSummaryPeriod {
+  /**
+   * @generated from enum value: CLIMATE_SUMMARY_PERIOD_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * @generated from enum value: CLIMATE_SUMMARY_PERIOD_DAY = 1;
+   */
+  DAY = 1,
+
+  /**
+   * ISO weeks, Monday to Monday.
+   *
+   * @generated from enum value: CLIMATE_SUMMARY_PERIOD_WEEK = 2;
+   */
+  WEEK = 2,
+
+  /**
+   * Calendar months.
+   *
+   * @generated from enum value: CLIMATE_SUMMARY_PERIOD_MONTH = 3;
+   */
+  MONTH = 3,
+}
+
+/**
+ * Describes the enum kusinta.iot.climate.v1.ClimateSummaryPeriod.
+ */
+export declare const ClimateSummaryPeriodSchema: GenEnum<ClimateSummaryPeriod>;
+
+/**
+ * How an apartment's mean is formed from its rooms' means.
+ *
+ * @generated from enum kusinta.iot.climate.v1.ClimateSummaryWeighting
+ */
+export enum ClimateSummaryWeighting {
+  /**
+   * @generated from enum value: CLIMATE_SUMMARY_WEIGHTING_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * Each room counts once, whatever its size: a bathroom weighs as much as a living room.
+   *
+   * @generated from enum value: CLIMATE_SUMMARY_WEIGHTING_ROOMS_EQUAL = 1;
+   */
+  ROOMS_EQUAL = 1,
+}
+
+/**
+ * Describes the enum kusinta.iot.climate.v1.ClimateSummaryWeighting.
+ */
+export declare const ClimateSummaryWeightingSchema: GenEnum<ClimateSummaryWeighting>;
+