@kusinta/iot-schema 0.2.0-beta.19 → 0.2.0-beta.20

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

@@ -61,8 +61,8 @@ 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 this
- * moves.
+ * 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
  */
@@ -83,7 +83,10 @@ export declare type RoomClimate = Message<"kusinta.iot.climate.v1.RoomClimate">
   targetCentidegrees?: number | undefined;
 
   /**
-   * Who or what set target_centidegrees. Unset while the target is.
+   * 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;
    */
@@ -134,18 +137,23 @@ export declare type RoomClimate = Message<"kusinta.iot.climate.v1.RoomClimate">
    * 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.
    *
-   * By default every 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 the order explicitly (see sensors_configured). Empty: the room has no
-   * temperature sensor, and its valves regulate on their own probes (NO_SENSOR).
+   * 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 sensor_ids is an order an owner chose, rather than the default of filing
-   * order. A sensor filed into a room with a chosen order is not added to it.
+   * 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;
    */
@@ -177,12 +185,31 @@ export declare type RoomClimate = Message<"kusinta.iot.climate.v1.RoomClimate">
    *
    * 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 always should. Elsewhere locking is the owner's
-   * choice.
+   * 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.
+   *
+   * @generated from field: bool state_withheld = 15;
+   */
+  stateWithheld: boolean;
 };
 
 /**
@@ -192,6 +219,17 @@ export declare type RoomClimate = Message<"kusinta.iot.climate.v1.RoomClimate">
 export declare const RoomClimateSchema: GenMessage<RoomClimate>;
 
 /**
+ * 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
@@ -223,8 +261,10 @@ export declare type ClimateMode = Message<"kusinta.iot.climate.v1.ClimateMode">
 
   /**
    * 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.
+   * 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;
    */
@@ -236,7 +276,9 @@ export declare type ClimateMode = Message<"kusinta.iot.climate.v1.ClimateMode">
   endsAt?: Timestamp | undefined;
 
   /**
-   * Who switched it on.
+   * 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;
    */
@@ -352,7 +394,9 @@ export declare type RoomHistory = Message<"kusinta.iot.climate.v1.RoomHistory">
   /**
    * 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.
+   * 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;
    */
@@ -372,6 +416,135 @@ export declare type RoomHistory = Message<"kusinta.iot.climate.v1.RoomHistory">
  */
 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.
@@ -480,3 +653,74 @@ export enum 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>;
+

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("CiRrdXNpbnRhL2lvdC9jbGltYXRlL3YxL2NsaW1hdGUucHJvdG8SFmt1c2ludGEuaW90LmNsaW1hdGUudjEiogEKDFRhcmdldENoYW5nZRImCgJhdBgBIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASLwoEdXNlchgCIAEoCzIfLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlVzZXJJZEgAEjMKBmRldmljZRgDIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkSABCBAoCYnki5wUKC1Jvb21DbGltYXRlEjIKCHNwYWNlX2lkGAEgASgLMiAua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuU3BhY2VJZBIgChN0YXJnZXRfY2VudGlkZWdyZWVzGAIgASgRSACIAQESOwoNdGFyZ2V0X2NoYW5nZRgDIAEoCzIkLmt1c2ludGEuaW90LmNsaW1hdGUudjEuVGFyZ2V0Q2hhbmdlEioKHWVmZmVjdGl2ZV90YXJnZXRfY2VudGlkZWdyZWVzGAQgASgRSAGIAQESFgoOb3ZlcnJpZGVzX21vZGUYBSABKAgSNwoNbW9kZV9zcGFjZV9pZBgNIAEoCzIgLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlNwYWNlSWQSHQoQbWluX2NlbnRpZGVncmVlcxgGIAEoEUgCiAEBEh0KEG1heF9jZW50aWRlZ3JlZXMYByABKBFIA4gBARI1CgpzZW5zb3JfaWRzGAggAygLMiEua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuRGV2aWNlSWQSGgoSc2Vuc29yc19jb25maWd1cmVkGA4gASgIEiIKFW1lYXN1cmVkX2NlbnRpZGVncmVlcxgJIAEoEUgEiAEBEjYKC21lYXN1cmVkX2J5GAogASgLMiEua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuRGV2aWNlSWQSPwoJY29uZGl0aW9uGAsgASgOMiwua3VzaW50YS5pb3QuY2xpbWF0ZS52MS5Sb29tQ2xpbWF0ZUNvbmRpdGlvbhIcChRsb2NrX2RldmljZV9jb250cm9scxgMIAEoCEIWChRfdGFyZ2V0X2NlbnRpZGVncmVlc0IgCh5fZWZmZWN0aXZlX3RhcmdldF9jZW50aWRlZ3JlZXNCEwoRX21pbl9jZW50aWRlZ3JlZXNCEwoRX21heF9jZW50aWRlZ3JlZXNCGAoWX21lYXN1cmVkX2NlbnRpZGVncmVlcyKDAwoLQ2xpbWF0ZU1vZGUSMgoIc3BhY2VfaWQYASABKAsyIC5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5TcGFjZUlkEjUKBGtpbmQYAiABKA4yJy5rdXNpbnRhLmlvdC5jbGltYXRlLnYxLkNsaW1hdGVNb2RlS2luZBIhChRzZXRiYWNrX2NlbnRpZGVncmVlcxgDIAEoEUgAiAEBEi0KCXN0YXJ0c19hdBgEIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASKwoHZW5kc19hdBgFIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASLwoGc2V0X2J5GAYgASgLMh8ua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuVXNlcklkEjIKCXdhcm1fZnJvbRgHIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXBIAYgBAUIXChVfc2V0YmFja19jZW50aWRlZ3JlZXNCDAoKX3dhcm1fZnJvbSJ5Cg9Sb29tQ2xpbWF0ZUxpc3QSMgoFcm9vbXMYASADKAsyIy5rdXNpbnRhLmlvdC5jbGltYXRlLnYxLlJvb21DbGltYXRlEjIKBW1vZGVzGAIgAygLMiMua3VzaW50YS5pb3QuY2xpbWF0ZS52MS5DbGltYXRlTW9kZSLzAgoRUm9vbUhpc3RvcnlTYW1wbGUSJgoCYXQYASABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEiIKFW1lYXN1cmVkX2NlbnRpZGVncmVlcxgCIAEoEUgAiAEBEiAKE3RhcmdldF9jZW50aWRlZ3JlZXMYAyABKBFIAYgBARIqCh1lZmZlY3RpdmVfdGFyZ2V0X2NlbnRpZGVncmVlcxgEIAEoEUgCiAEBEiAKE3ZhbHZlX29wZW5fcGVybWlsbGUYBSABKA1IA4gBARIfChJ2YWx2ZV9vcGVuX3NlY29uZHMYBiABKA1IBIgBAUIYChZfbWVhc3VyZWRfY2VudGlkZWdyZWVzQhYKFF90YXJnZXRfY2VudGlkZWdyZWVzQiAKHl9lZmZlY3RpdmVfdGFyZ2V0X2NlbnRpZGVncmVlc0IWChRfdmFsdmVfb3Blbl9wZXJtaWxsZUIVChNfdmFsdmVfb3Blbl9zZWNvbmRzIqsBCgtSb29tSGlzdG9yeRIxCgdyb29tX2lkGAEgASgLMiAua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuU3BhY2VJZBItCglrZXB0X2Zyb20YAiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEjoKB3NhbXBsZXMYAyADKAsyKS5rdXNpbnRhLmlvdC5jbGltYXRlLnYxLlJvb21IaXN0b3J5U2FtcGxlKtUCChRSb29tQ2xpbWF0ZUNvbmRpdGlvbhImCiJST09NX0NMSU1BVEVfQ09ORElUSU9OX1VOU1BFQ0lGSUVEEAASIgoeUk9PTV9DTElNQVRFX0NPTkRJVElPTl9IT0xESU5HEAESJAogUk9PTV9DTElNQVRFX0NPTkRJVElPTl9OT19UQVJHRVQQAhImCiJST09NX0NMSU1BVEVfQ09ORElUSU9OX1NFTlNPUl9MT1NUEAMSJgoiUk9PTV9DTElNQVRFX0NPTkRJVElPTl9XSU5ET1dfT1BFThAEEiUKIVJPT01fQ0xJTUFURV9DT05ESVRJT05fTk9fSEVBVElORxAFEi4KKlJPT01fQ0xJTUFURV9DT05ESVRJT05fSEVBVElOR19VTlJFQUNIQUJMRRAGEiQKIFJPT01fQ0xJTUFURV9DT05ESVRJT05fTk9fU0VOU09SEAcqbwoPQ2xpbWF0ZU1vZGVLaW5kEiEKHUNMSU1BVEVfTU9ERV9LSU5EX1VOU1BFQ0lGSUVEEAASGgoWQ0xJTUFURV9NT0RFX0tJTkRfQVdBWRABEh0KGUNMSU1BVEVfTU9ERV9LSU5EX0hPTElEQVkQAkICSAFiBnByb3RvMw", [file_google_protobuf_timestamp, file_kusinta_iot_identity_v1_identity]);
+  fileDesc("CiRrdXNpbnRhL2lvdC9jbGltYXRlL3YxL2NsaW1hdGUucHJvdG8SFmt1c2ludGEuaW90LmNsaW1hdGUudjEiogEKDFRhcmdldENoYW5nZRImCgJhdBgBIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASLwoEdXNlchgCIAEoCzIfLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlVzZXJJZEgAEjMKBmRldmljZRgDIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkSABCBAoCYnki/wUKC1Jvb21DbGltYXRlEjIKCHNwYWNlX2lkGAEgASgLMiAua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuU3BhY2VJZBIgChN0YXJnZXRfY2VudGlkZWdyZWVzGAIgASgRSACIAQESOwoNdGFyZ2V0X2NoYW5nZRgDIAEoCzIkLmt1c2ludGEuaW90LmNsaW1hdGUudjEuVGFyZ2V0Q2hhbmdlEioKHWVmZmVjdGl2ZV90YXJnZXRfY2VudGlkZWdyZWVzGAQgASgRSAGIAQESFgoOb3ZlcnJpZGVzX21vZGUYBSABKAgSNwoNbW9kZV9zcGFjZV9pZBgNIAEoCzIgLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlNwYWNlSWQSHQoQbWluX2NlbnRpZGVncmVlcxgGIAEoEUgCiAEBEh0KEG1heF9jZW50aWRlZ3JlZXMYByABKBFIA4gBARI1CgpzZW5zb3JfaWRzGAggAygLMiEua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuRGV2aWNlSWQSGgoSc2Vuc29yc19jb25maWd1cmVkGA4gASgIEiIKFW1lYXN1cmVkX2NlbnRpZGVncmVlcxgJIAEoEUgEiAEBEjYKC21lYXN1cmVkX2J5GAogASgLMiEua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuRGV2aWNlSWQSPwoJY29uZGl0aW9uGAsgASgOMiwua3VzaW50YS5pb3QuY2xpbWF0ZS52MS5Sb29tQ2xpbWF0ZUNvbmRpdGlvbhIcChRsb2NrX2RldmljZV9jb250cm9scxgMIAEoCBIWCg5zdGF0ZV93aXRoaGVsZBgPIAEoCEIWChRfdGFyZ2V0X2NlbnRpZGVncmVlc0IgCh5fZWZmZWN0aXZlX3RhcmdldF9jZW50aWRlZ3JlZXNCEwoRX21pbl9jZW50aWRlZ3JlZXNCEwoRX21heF9jZW50aWRlZ3JlZXNCGAoWX21lYXN1cmVkX2NlbnRpZGVncmVlcyKDAwoLQ2xpbWF0ZU1vZGUSMgoIc3BhY2VfaWQYASABKAsyIC5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5TcGFjZUlkEjUKBGtpbmQYAiABKA4yJy5rdXNpbnRhLmlvdC5jbGltYXRlLnYxLkNsaW1hdGVNb2RlS2luZBIhChRzZXRiYWNrX2NlbnRpZGVncmVlcxgDIAEoEUgAiAEBEi0KCXN0YXJ0c19hdBgEIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASKwoHZW5kc19hdBgFIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASLwoGc2V0X2J5GAYgASgLMh8ua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuVXNlcklkEjIKCXdhcm1fZnJvbRgHIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXBIAYgBAUIXChVfc2V0YmFja19jZW50aWRlZ3JlZXNCDAoKX3dhcm1fZnJvbSJ5Cg9Sb29tQ2xpbWF0ZUxpc3QSMgoFcm9vbXMYASADKAsyIy5rdXNpbnRhLmlvdC5jbGltYXRlLnYxLlJvb21DbGltYXRlEjIKBW1vZGVzGAIgAygLMiMua3VzaW50YS5pb3QuY2xpbWF0ZS52MS5DbGltYXRlTW9kZSLzAgoRUm9vbUhpc3RvcnlTYW1wbGUSJgoCYXQYASABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEiIKFW1lYXN1cmVkX2NlbnRpZGVncmVlcxgCIAEoEUgAiAEBEiAKE3RhcmdldF9jZW50aWRlZ3JlZXMYAyABKBFIAYgBARIqCh1lZmZlY3RpdmVfdGFyZ2V0X2NlbnRpZGVncmVlcxgEIAEoEUgCiAEBEiAKE3ZhbHZlX29wZW5fcGVybWlsbGUYBSABKA1IA4gBARIfChJ2YWx2ZV9vcGVuX3NlY29uZHMYBiABKA1IBIgBAUIYChZfbWVhc3VyZWRfY2VudGlkZWdyZWVzQhYKFF90YXJnZXRfY2VudGlkZWdyZWVzQiAKHl9lZmZlY3RpdmVfdGFyZ2V0X2NlbnRpZGVncmVlc0IWChRfdmFsdmVfb3Blbl9wZXJtaWxsZUIVChNfdmFsdmVfb3Blbl9zZWNvbmRzIqsBCgtSb29tSGlzdG9yeRIxCgdyb29tX2lkGAEgASgLMiAua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuU3BhY2VJZBItCglrZXB0X2Zyb20YAiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEjoKB3NhbXBsZXMYAyADKAsyKS5rdXNpbnRhLmlvdC5jbGltYXRlLnYxLlJvb21IaXN0b3J5U2FtcGxlItQCChFDbGltYXRlUGVyaW9kTWVhbhItCglzdGFydHNfYXQYASABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEisKB2VuZHNfYXQYAiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEiIKFW1lYXN1cmVkX2NlbnRpZGVncmVlcxgDIAEoEUgAiAEBEiAKE3RhcmdldF9jZW50aWRlZ3JlZXMYBCABKBFIAYgBARIiChptZWFzdXJlZF9jb3ZlcmFnZV9wZXJtaWxsZRgFIAEoDRIgChh0YXJnZXRfY292ZXJhZ2VfcGVybWlsbGUYBiABKA0SFgoOcm9vbXNfbWVhc3VyZWQYByABKA0SDQoFcm9vbXMYCCABKA1CGAoWX21lYXN1cmVkX2NlbnRpZGVncmVlc0IWChRfdGFyZ2V0X2NlbnRpZGVncmVlcyK+AgoXQXBhcnRtZW50Q2xpbWF0ZVN1bW1hcnkSNgoMYXBhcnRtZW50X2lkGAEgASgLMiAua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuU3BhY2VJZBI8CgZwZXJpb2QYAiABKA4yLC5rdXNpbnRhLmlvdC5jbGltYXRlLnYxLkNsaW1hdGVTdW1tYXJ5UGVyaW9kEkIKCXdlaWdodGluZxgDIAEoDjIvLmt1c2ludGEuaW90LmNsaW1hdGUudjEuQ2xpbWF0ZVN1bW1hcnlXZWlnaHRpbmcSLQoJa2VwdF9mcm9tGAQgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBI6CgdwZXJpb2RzGAUgAygLMikua3VzaW50YS5pb3QuY2xpbWF0ZS52MS5DbGltYXRlUGVyaW9kTWVhbirVAgoUUm9vbUNsaW1hdGVDb25kaXRpb24SJgoiUk9PTV9DTElNQVRFX0NPTkRJVElPTl9VTlNQRUNJRklFRBAAEiIKHlJPT01fQ0xJTUFURV9DT05ESVRJT05fSE9MRElORxABEiQKIFJPT01fQ0xJTUFURV9DT05ESVRJT05fTk9fVEFSR0VUEAISJgoiUk9PTV9DTElNQVRFX0NPTkRJVElPTl9TRU5TT1JfTE9TVBADEiYKIlJPT01fQ0xJTUFURV9DT05ESVRJT05fV0lORE9XX09QRU4QBBIlCiFST09NX0NMSU1BVEVfQ09ORElUSU9OX05PX0hFQVRJTkcQBRIuCipST09NX0NMSU1BVEVfQ09ORElUSU9OX0hFQVRJTkdfVU5SRUFDSEFCTEUQBhIkCiBST09NX0NMSU1BVEVfQ09ORElUSU9OX05PX1NFTlNPUhAHKm8KD0NsaW1hdGVNb2RlS2luZBIhCh1DTElNQVRFX01PREVfS0lORF9VTlNQRUNJRklFRBAAEhoKFkNMSU1BVEVfTU9ERV9LSU5EX0FXQVkQARIdChlDTElNQVRFX01PREVfS0lORF9IT0xJREFZEAIqoQEKFENsaW1hdGVTdW1tYXJ5UGVyaW9kEiYKIkNMSU1BVEVfU1VNTUFSWV9QRVJJT0RfVU5TUEVDSUZJRUQQABIeChpDTElNQVRFX1NVTU1BUllfUEVSSU9EX0RBWRABEh8KG0NMSU1BVEVfU1VNTUFSWV9QRVJJT0RfV0VFSxACEiAKHENMSU1BVEVfU1VNTUFSWV9QRVJJT0RfTU9OVEgQAypvChdDbGltYXRlU3VtbWFyeVdlaWdodGluZxIpCiVDTElNQVRFX1NVTU1BUllfV0VJR0hUSU5HX1VOU1BFQ0lGSUVEEAASKQolQ0xJTUFURV9TVU1NQVJZX1dFSUdIVElOR19ST09NU19FUVVBTBABQgJIAWIGcHJvdG8z", [file_google_protobuf_timestamp, file_kusinta_iot_identity_v1_identity]);
 
 /**
  * Describes the message kusinta.iot.climate.v1.TargetChange.
@@ -54,6 +54,20 @@ export const RoomHistorySampleSchema = /*@__PURE__*/
 export const RoomHistorySchema = /*@__PURE__*/
   messageDesc(file_kusinta_iot_climate_v1_climate, 5);
 
+/**
+ * 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);
+
+/**
+ * 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);
+
 /**
  * Describes the enum kusinta.iot.climate.v1.RoomClimateCondition.
  */
@@ -87,3 +101,42 @@ export const ClimateModeKindSchema = /*@__PURE__*/
 export const ClimateModeKind = /*@__PURE__*/
   tsEnum(ClimateModeKindSchema);
 
+/**
+ * Describes the enum kusinta.iot.climate.v1.ClimateSummaryPeriod.
+ */
+export const ClimateSummaryPeriodSchema = /*@__PURE__*/
+  enumDesc(file_kusinta_iot_climate_v1_climate, 2);
+
+/**
+ * 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 const ClimateSummaryPeriod = /*@__PURE__*/
+  tsEnum(ClimateSummaryPeriodSchema);
+
+/**
+ * Describes the enum kusinta.iot.climate.v1.ClimateSummaryWeighting.
+ */
+export const ClimateSummaryWeightingSchema = /*@__PURE__*/
+  enumDesc(file_kusinta_iot_climate_v1_climate, 3);
+
+/**
+ * How an apartment's mean is formed from its rooms' means.
+ *
+ * @generated from enum kusinta.iot.climate.v1.ClimateSummaryWeighting
+ */
+export const ClimateSummaryWeighting = /*@__PURE__*/
+  tsEnum(ClimateSummaryWeightingSchema);
+

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

@@ -102,6 +102,10 @@ export declare type DeviceDescriptor = Message<"kusinta.iot.device.v1.DeviceDesc
   ownerUserId?: UserId | undefined;
 
   /**
+   * Unset when it is withheld from the recipient: in a service view, 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: google.protobuf.Timestamp claimed_at = 16;
    */
   claimedAt?: Timestamp | undefined;
@@ -121,7 +125,8 @@ export declare type DeviceDescriptor = Message<"kusinta.iot.device.v1.DeviceDesc
    *
    * So a Device is a Matter node OR one device behind one — the equivalence is deliberately
    * not exact, and this field is how a consumer tells which. Absent means the device is
-   * reached directly.
+   * reached directly, or that its bridge is withheld from the recipient (see
+   * access.v1.ServiceSignal FILING).
    *
    * @generated from field: optional kusinta.iot.identity.v1.DeviceId bridged_by = 19;
    */

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,79 @@ 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 — 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

@@ -283,12 +283,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;
    */

package/src/kusinta/iot/link/v1/link_pb.d.ts

@@ -102,6 +102,9 @@ export declare const ClimateLeadSettingsSchema: GenMessage<ClimateLeadSettings>;
  */
 export declare type DeviceLink = Message<"kusinta.iot.link.v1.DeviceLink"> & {
   /**
+   * Opaque, and must not encode when the link was made — a UUIDv4 is the expected form — since
+   * that time is withheld from some recipients (see created_at).
+   *
    * @generated from field: string link_id = 1;
    */
   linkId: string;
@@ -140,6 +143,10 @@ export declare type DeviceLink = Message<"kusinta.iot.link.v1.DeviceLink"> & {
   state: LinkState;
 
   /**
+   * 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: google.protobuf.Timestamp created_at = 7;
    */
   createdAt?: Timestamp | undefined;
@@ -164,6 +171,16 @@ export declare type DeviceLink = Message<"kusinta.iot.link.v1.DeviceLink"> & {
    * @generated from field: kusinta.iot.link.v1.LinkSettings settings = 9;
    */
   settings?: LinkSettings | undefined;
+
+  /**
+   * Set when the recipient sees this link as service, because an end is in a home (see
+   * access.v1.MembershipRelation): state, state_detail, settings and created_at are
+   * WITHHELD and left unset, not unconfigured. An app must not render it as a link doing
+   * nothing.
+   *
+   * @generated from field: bool details_withheld = 10;
+   */
+  detailsWithheld: boolean;
 };
 
 /**

package/src/kusinta/iot/link/v1/link_pb.js

@@ -11,7 +11,7 @@ import { file_kusinta_iot_identity_v1_identity } from "../../identity/v1/identit
  * Describes the file kusinta/iot/link/v1/link.proto.
  */
 export const file_kusinta_iot_link_v1_link = /*@__PURE__*/
-  fileDesc("Ch5rdXNpbnRhL2lvdC9saW5rL3YxL2xpbmsucHJvdG8SE2t1c2ludGEuaW90LmxpbmsudjEiYAoMTGlua1NldHRpbmdzEkAKDGNsaW1hdGVfbGVhZBgBIAEoCzIoLmt1c2ludGEuaW90LmxpbmsudjEuQ2xpbWF0ZUxlYWRTZXR0aW5nc0gAQg4KDHBlcl9mdW5jdGlvbiJHChNDbGltYXRlTGVhZFNldHRpbmdzEhwKD3RhcmdldF9zZXRwb2ludBgBIAEoEUgAiAEBQhIKEF90YXJnZXRfc2V0cG9pbnQilwMKCkRldmljZUxpbmsSDwoHbGlua19pZBgBIAEoCRIxCgZzZW5kZXIYAiABKAsyIS5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5EZXZpY2VJZBIzCghyZWNlaXZlchgDIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkEjMKCGZ1bmN0aW9uGAQgASgOMiEua3VzaW50YS5pb3QubGluay52MS5MaW5rRnVuY3Rpb24SKwoEbW9kZRgFIAEoDjIdLmt1c2ludGEuaW90LmxpbmsudjEuTGlua01vZGUSLQoFc3RhdGUYBiABKA4yHi5rdXNpbnRhLmlvdC5saW5rLnYxLkxpbmtTdGF0ZRIuCgpjcmVhdGVkX2F0GAcgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBIUCgxzdGF0ZV9kZXRhaWwYCCABKAkSMwoIc2V0dGluZ3MYCSABKAsyIS5rdXNpbnRhLmlvdC5saW5rLnYxLkxpbmtTZXR0aW5nc0oECBQQHiL7AQoOTGlua0NhcGFiaWxpdHkSMwoIZnVuY3Rpb24YASABKA4yIS5rdXNpbnRhLmlvdC5saW5rLnYxLkxpbmtGdW5jdGlvbhI1CglkaXJlY3Rpb24YAiABKA4yIi5rdXNpbnRhLmlvdC5saW5rLnYxLkxpbmtEaXJlY3Rpb24SNgoPc3VwcG9ydGVkX21vZGVzGAMgAygOMh0ua3VzaW50YS5pb3QubGluay52MS5MaW5rTW9kZRI2CglhdHRyaWJ1dGUYBCABKAsyIy5rdXNpbnRhLmlvdC5hY2Nlc3MudjEuQXR0cmlidXRlUmVmEg0KBWxhYmVsGAUgASgJIkAKDkRldmljZUxpbmtMaXN0Ei4KBWxpbmtzGAEgAygLMh8ua3VzaW50YS5pb3QubGluay52MS5EZXZpY2VMaW5rKo8BCgxMaW5rRnVuY3Rpb24SHQoZTElOS19GVU5DVElPTl9VTlNQRUNJRklFRBAAEh4KGkxJTktfRlVOQ1RJT05fQ0xJTUFURV9MRUFEEAESHgoaTElOS19GVU5DVElPTl9XSU5ET1dfU1RBVEUQAhIgChxMSU5LX0ZVTkNUSU9OX1JFTU9URV9DT05UUk9MEAMqZQoNTGlua0RpcmVjdGlvbhIeChpMSU5LX0RJUkVDVElPTl9VTlNQRUNJRklFRBAAEhkKFUxJTktfRElSRUNUSU9OX1NPVVJDRRABEhkKFUxJTktfRElSRUNUSU9OX1RBUkdFVBACKk0KCExpbmtNb2RlEhkKFUxJTktfTU9ERV9VTlNQRUNJRklFRBAAEhIKDkxJTktfTU9ERV9IQVJEEAESEgoOTElOS19NT0RFX1NPRlQQAiptCglMaW5rU3RhdGUSGgoWTElOS19TVEFURV9VTlNQRUNJRklFRBAAEhUKEUxJTktfU1RBVEVfQUNUSVZFEAESFQoRTElOS19TVEFURV9CUk9LRU4QAhIWChJMSU5LX1NUQVRFX1VOS05PV04QA0ICSAFiBnByb3RvMw", [file_google_protobuf_timestamp, file_kusinta_iot_access_v1_acl, file_kusinta_iot_identity_v1_identity]);
+  fileDesc("Ch5rdXNpbnRhL2lvdC9saW5rL3YxL2xpbmsucHJvdG8SE2t1c2ludGEuaW90LmxpbmsudjEiYAoMTGlua1NldHRpbmdzEkAKDGNsaW1hdGVfbGVhZBgBIAEoCzIoLmt1c2ludGEuaW90LmxpbmsudjEuQ2xpbWF0ZUxlYWRTZXR0aW5nc0gAQg4KDHBlcl9mdW5jdGlvbiJHChNDbGltYXRlTGVhZFNldHRpbmdzEhwKD3RhcmdldF9zZXRwb2ludBgBIAEoEUgAiAEBQhIKEF90YXJnZXRfc2V0cG9pbnQisQMKCkRldmljZUxpbmsSDwoHbGlua19pZBgBIAEoCRIxCgZzZW5kZXIYAiABKAsyIS5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5EZXZpY2VJZBIzCghyZWNlaXZlchgDIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkEjMKCGZ1bmN0aW9uGAQgASgOMiEua3VzaW50YS5pb3QubGluay52MS5MaW5rRnVuY3Rpb24SKwoEbW9kZRgFIAEoDjIdLmt1c2ludGEuaW90LmxpbmsudjEuTGlua01vZGUSLQoFc3RhdGUYBiABKA4yHi5rdXNpbnRhLmlvdC5saW5rLnYxLkxpbmtTdGF0ZRIuCgpjcmVhdGVkX2F0GAcgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBIUCgxzdGF0ZV9kZXRhaWwYCCABKAkSMwoIc2V0dGluZ3MYCSABKAsyIS5rdXNpbnRhLmlvdC5saW5rLnYxLkxpbmtTZXR0aW5ncxIYChBkZXRhaWxzX3dpdGhoZWxkGAogASgISgQIFBAeIvsBCg5MaW5rQ2FwYWJpbGl0eRIzCghmdW5jdGlvbhgBIAEoDjIhLmt1c2ludGEuaW90LmxpbmsudjEuTGlua0Z1bmN0aW9uEjUKCWRpcmVjdGlvbhgCIAEoDjIiLmt1c2ludGEuaW90LmxpbmsudjEuTGlua0RpcmVjdGlvbhI2Cg9zdXBwb3J0ZWRfbW9kZXMYAyADKA4yHS5rdXNpbnRhLmlvdC5saW5rLnYxLkxpbmtNb2RlEjYKCWF0dHJpYnV0ZRgEIAEoCzIjLmt1c2ludGEuaW90LmFjY2Vzcy52MS5BdHRyaWJ1dGVSZWYSDQoFbGFiZWwYBSABKAkiQAoORGV2aWNlTGlua0xpc3QSLgoFbGlua3MYASADKAsyHy5rdXNpbnRhLmlvdC5saW5rLnYxLkRldmljZUxpbmsqjwEKDExpbmtGdW5jdGlvbhIdChlMSU5LX0ZVTkNUSU9OX1VOU1BFQ0lGSUVEEAASHgoaTElOS19GVU5DVElPTl9DTElNQVRFX0xFQUQQARIeChpMSU5LX0ZVTkNUSU9OX1dJTkRPV19TVEFURRACEiAKHExJTktfRlVOQ1RJT05fUkVNT1RFX0NPTlRST0wQAyplCg1MaW5rRGlyZWN0aW9uEh4KGkxJTktfRElSRUNUSU9OX1VOU1BFQ0lGSUVEEAASGQoVTElOS19ESVJFQ1RJT05fU09VUkNFEAESGQoVTElOS19ESVJFQ1RJT05fVEFSR0VUEAIqTQoITGlua01vZGUSGQoVTElOS19NT0RFX1VOU1BFQ0lGSUVEEAASEgoOTElOS19NT0RFX0hBUkQQARISCg5MSU5LX01PREVfU09GVBACKm0KCUxpbmtTdGF0ZRIaChZMSU5LX1NUQVRFX1VOU1BFQ0lGSUVEEAASFQoRTElOS19TVEFURV9BQ1RJVkUQARIVChFMSU5LX1NUQVRFX0JST0tFThACEhYKEkxJTktfU1RBVEVfVU5LTk9XThADQgJIAWIGcHJvdG8z", [file_google_protobuf_timestamp, file_kusinta_iot_access_v1_acl, file_kusinta_iot_identity_v1_identity]);
 
 /**
  * Describes the message kusinta.iot.link.v1.LinkSettings.