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

package/src/kusinta/iot/webrtc/v1/envelope_pb.d.ts

@@ -7,11 +7,19 @@ import type { Message } from "@bufbuild/protobuf";
 import type { ConnectorId, DeviceId, SpaceId } from "../../identity/v1/identity_pb.js";
 import type { AttributeRef } from "../../access/v1/acl_pb.js";
 import type { Space } from "../../space/v1/space_pb.js";
-import type { ManagementAck, ManagementRequest, SpaceTree } from "./management_pb.js";
+import type { BuildingPlanning, DayAheadPrices, ManagementAck, ManagementRequest, PrivacyDisclosure, SpaceAddress, SpaceTree } from "./management_pb.js";
+import type { DeviceLink, DeviceLinkList } from "../../link/v1/link_pb.js";
+import type { ApartmentClimateSummary, ClimateMode, PlantHistory, RoomClimate, RoomClimateList, RoomHistory } from "../../climate/v1/climate_pb.js";
+import type { IssuedInvite, SpaceInvites } from "./invite_pb.js";
+import type { GatewayMembers, PromotionRequests } from "./members_pb.js";
+import type { HeatingLayout, HeatingRecord } from "../../heating/v1/heating_pb.js";
+import type { AccountLinkNonce, AccountLinks } from "../../accountlink/v1/account_link_pb.js";
+import type { CommissioningGrant, CommissioningGrants, CommissioningProfile, CommissioningRecord, CommissioningTest, HomeSetups } from "../../commissioning/v1/commissioning_pb.js";
+import type { ClimateHistoryCleared, HouseholdExport, HouseholdHandover, HouseholdHandovers } from "./household_pb.js";
 import type { PairingErrorDetail, PairingWindow } from "../../common/v1/pairing_pb.js";
-import type { DeviceOwnershipType } from "../../common/v1/types_pb.js";
+import type { BackendHealth, ConnectorKind, DeviceOwnershipType } from "../../common/v1/types_pb.js";
 import type { Timestamp } from "@bufbuild/protobuf/wkt";
-import type { DeviceAdded, DeviceRemoved, DeviceStateSnapshot, PropertyReport } from "./device_state_pb.js";
+import type { DeviceAdded, DeviceRemoved, DeviceStateSnapshot, PropertyReport, ServiceStatusChanged } from "./device_state_pb.js";
 import type { LivePermissionUpdate } from "./permission_push_pb.js";
 import type { AttributeWriteRequest, CommandResult, DeviceCommand } from "./command_pb.js";
 import type { DeviceEventBatch } from "../../device/v1/device_event_pb.js";
@@ -46,13 +54,26 @@ export declare type Pong = Message<"kusinta.iot.webrtc.v1.Pong"> & {
 export declare const PongSchema: GenMessage<Pong>;
 
 /**
+ * The gateway refused the session's handshake, gateway → app; the session ends.
+ *
  * @generated from message kusinta.iot.webrtc.v1.HandshakeRejected
  */
 export declare type HandshakeRejected = Message<"kusinta.iot.webrtc.v1.HandshakeRejected"> & {
   /**
+   * For logs and debugging only, in the gateway's words. An app MUST NOT show it to a user: it
+   * names the refusal by code, in its user's language.
+   *
    * @generated from field: string reason = 1;
    */
   reason: string;
+
+  /**
+   * Why, as a closed list. Rollout note: a gateway that predates this field sends reason alone,
+   * which an app reads as UNSPECIFIED.
+   *
+   * @generated from field: kusinta.iot.webrtc.v1.HandshakeRejectReason code = 2;
+   */
+  code: HandshakeRejectReason;
 };
 
 /**
@@ -318,6 +339,208 @@ export declare type ManagementResult = Message<"kusinta.iot.webrtc.v1.Management
      */
     value: ManagementAck;
     case: "ack";
+  } | {
+    /**
+     * list_device_links
+     *
+     * @generated from field: kusinta.iot.link.v1.DeviceLinkList links = 6;
+     */
+    value: DeviceLinkList;
+    case: "links";
+  } | {
+    /**
+     * list_room_climates
+     *
+     * @generated from field: kusinta.iot.climate.v1.RoomClimateList room_climates = 7;
+     */
+    value: RoomClimateList;
+    case: "roomClimates";
+  } | {
+    /**
+     * get_room_history
+     *
+     * @generated from field: kusinta.iot.climate.v1.RoomHistory room_history = 8;
+     */
+    value: RoomHistory;
+    case: "roomHistory";
+  } | {
+    /**
+     * get_privacy_disclosure
+     *
+     * @generated from field: kusinta.iot.webrtc.v1.PrivacyDisclosure privacy_disclosure = 9;
+     */
+    value: PrivacyDisclosure;
+    case: "privacyDisclosure";
+  } | {
+    /**
+     * get_apartment_climate_summary
+     *
+     * @generated from field: kusinta.iot.climate.v1.ApartmentClimateSummary apartment_climate_summary = 10;
+     */
+    value: ApartmentClimateSummary;
+    case: "apartmentClimateSummary";
+  } | {
+    /**
+     * create_invite, resend_invite
+     *
+     * @generated from field: kusinta.iot.webrtc.v1.IssuedInvite issued_invite = 11;
+     */
+    value: IssuedInvite;
+    case: "issuedInvite";
+  } | {
+    /**
+     * list_space_invites
+     *
+     * @generated from field: kusinta.iot.webrtc.v1.SpaceInvites space_invites = 12;
+     */
+    value: SpaceInvites;
+    case: "spaceInvites";
+  } | {
+    /**
+     * list_gateway_members
+     *
+     * @generated from field: kusinta.iot.webrtc.v1.GatewayMembers gateway_members = 13;
+     */
+    value: GatewayMembers;
+    case: "gatewayMembers";
+  } | {
+    /**
+     * list_promotion_requests
+     *
+     * @generated from field: kusinta.iot.webrtc.v1.PromotionRequests promotion_requests = 14;
+     */
+    value: PromotionRequests;
+    case: "promotionRequests";
+  } | {
+    /**
+     * list_heating
+     *
+     * @generated from field: kusinta.iot.heating.v1.HeatingLayout heating_layout = 15;
+     */
+    value: HeatingLayout;
+    case: "heatingLayout";
+  } | {
+    /**
+     * put_heating_plant, put_heating_circuit, put_floor_zone, put_comfort_load,
+     * set_comfort_windows
+     *
+     * @generated from field: kusinta.iot.heating.v1.HeatingRecord heating_record = 16;
+     */
+    value: HeatingRecord;
+    case: "heatingRecord";
+  } | {
+    /**
+     * request_account_link_nonce
+     *
+     * @generated from field: kusinta.iot.accountlink.v1.AccountLinkNonce account_link_nonce = 17;
+     */
+    value: AccountLinkNonce;
+    case: "accountLinkNonce";
+  } | {
+    /**
+     * list_account_links
+     *
+     * @generated from field: kusinta.iot.accountlink.v1.AccountLinks account_links = 18;
+     */
+    value: AccountLinks;
+    case: "accountLinks";
+  } | {
+    /**
+     * list_commissioning
+     *
+     * @generated from field: kusinta.iot.commissioning.v1.CommissioningProfile commissioning_profile = 19;
+     */
+    value: CommissioningProfile;
+    case: "commissioningProfile";
+  } | {
+    /**
+     * put_commissioning_fact, put_house_template, run_commissioning_test,
+     * conclude_commissioning_test
+     *
+     * @generated from field: kusinta.iot.commissioning.v1.CommissioningRecord commissioning_record = 20;
+     */
+    value: CommissioningRecord;
+    case: "commissioningRecord";
+  } | {
+    /**
+     * list_home_setups
+     *
+     * @generated from field: kusinta.iot.commissioning.v1.HomeSetups home_setups = 21;
+     */
+    value: HomeSetups;
+    case: "homeSetups";
+  } | {
+    /**
+     * request_commissioning_grant, answer_commissioning_grant (granted)
+     *
+     * @generated from field: kusinta.iot.commissioning.v1.CommissioningGrant commissioning_grant = 22;
+     */
+    value: CommissioningGrant;
+    case: "commissioningGrant";
+  } | {
+    /**
+     * list_commissioning_grants
+     *
+     * @generated from field: kusinta.iot.commissioning.v1.CommissioningGrants commissioning_grants = 23;
+     */
+    value: CommissioningGrants;
+    case: "commissioningGrants";
+  } | {
+    /**
+     * start_household_handover
+     *
+     * @generated from field: kusinta.iot.webrtc.v1.HouseholdHandover household_handover = 24;
+     */
+    value: HouseholdHandover;
+    case: "householdHandover";
+  } | {
+    /**
+     * list_household_handovers
+     *
+     * @generated from field: kusinta.iot.webrtc.v1.HouseholdHandovers household_handovers = 25;
+     */
+    value: HouseholdHandovers;
+    case: "householdHandovers";
+  } | {
+    /**
+     * export_household_data
+     *
+     * @generated from field: kusinta.iot.webrtc.v1.HouseholdExport household_export = 26;
+     */
+    value: HouseholdExport;
+    case: "householdExport";
+  } | {
+    /**
+     * get_plant_history
+     *
+     * @generated from field: kusinta.iot.climate.v1.PlantHistory plant_history = 27;
+     */
+    value: PlantHistory;
+    case: "plantHistory";
+  } | {
+    /**
+     * get_building_planning, put_building_planning
+     *
+     * @generated from field: kusinta.iot.webrtc.v1.BuildingPlanning building_planning = 28;
+     */
+    value: BuildingPlanning;
+    case: "buildingPlanning";
+  } | {
+    /**
+     * get_day_ahead_prices
+     *
+     * @generated from field: kusinta.iot.webrtc.v1.DayAheadPrices day_ahead_prices = 29;
+     */
+    value: DayAheadPrices;
+    case: "dayAheadPrices";
+  } | {
+    /**
+     * get_space_address, put_space_address
+     *
+     * @generated from field: kusinta.iot.webrtc.v1.SpaceAddress space_address = 30;
+     */
+    value: SpaceAddress;
+    case: "spaceAddress";
   } | { case: undefined; value?: undefined };
 };
 
@@ -333,8 +556,9 @@ export declare const ManagementResultSchema: GenMessage<ManagementResult>;
  *
  * A payload case of its own rather than a ManagementRequest. Those are gated on a target —
  * a space, a device — and that is the justification for keeping them behind one wrapper.
- * This one names no target: connector_id is optional, and unset means every connector, so
- * it is authorized against the caller's role and nothing else.
+ * A connector is not a target the caller must reach the way a space is, so this is
+ * authorized against the caller's role and nothing else — but it must still name the
+ * connector to open (see connector_id), never every connector at once.
  *
  * Answered twice, and the two answers say different things at different times.
  * PairingStarted reports whether the window opened; PairingFinished reports what came of
@@ -345,13 +569,13 @@ export declare const ManagementResultSchema: GenMessage<ManagementResult>;
  */
 export declare type StartPairing = Message<"kusinta.iot.webrtc.v1.StartPairing"> & {
   /**
-   * Which connector to open. Unset means every connector the gateway holds, which is the
-   * sensible default: a device picks its hub by radio range, and asking a user to choose is
-   * asking them to guess at something they cannot observe.
-   *
-   * Name one where the answer is not a guess — a device that will be linked to devices on a
-   * particular hub has to join that hub, because links are held by the hub that brokered
-   * them.
+   * Which connector to open. Required: pairing always targets exactly one connector,
+   * picked from the connector enumeration (see ConnectorsAnnounced and
+   * ConnectorInfo.supports_pairing). An untargeted request is refused with
+   * PairingError.CONNECTOR_REQUIRED, never fanned out across every hub — so that no
+   * client can open every radio at once, and so a device is paired onto the specific hub
+   * that will broker its links. The field is a message, so proto cannot mark it required;
+   * the gateway enforces it.
    *
    * @generated from field: kusinta.iot.identity.v1.ConnectorId connector_id = 1;
    */
@@ -365,7 +589,8 @@ export declare type StartPairing = Message<"kusinta.iot.webrtc.v1.StartPairing">
   window?: PairingWindow | undefined;
 
   /**
-   * Where to file the device once it arrives.
+   * Where to file the device once it arrives. Into a home only as PlaceDeviceInSpace
+   * allows.
    *
    * Optional, and the two cases differ. A caller pairing a device of their own must name a
    * space they reach, so it is theirs and placed on arrival rather than sitting unfiled and
@@ -480,7 +705,230 @@ export declare const PairingFinishedSchema: GenMessage<PairingFinished>;
 
 /**
  * GatewayMessage: gateway → app
+ * A link between two devices has changed, gateway to app.
+ *
+ * Sent without being asked for, like device_added, and for the same reason: a link's
+ * state is not settled when it is made. A hub accepting a link is not the two devices
+ * honouring it, and a link that was carrying stops when its sender goes quiet — so the
+ * interesting transitions all happen long after the request that created it was
+ * answered. Without this an app can only learn by listing every link again and
+ * diffing, which means a room that has quietly stopped following its wall thermostat
+ * looks correct until somebody reloads.
+ *
+ * Apply as an upsert keyed on link.link_id, never as an insert: the same link is sent
+ * again whenever its state moves.
+ *
+ * Sent only for links the recipient is entitled to see. An unfiltered one would say
+ * which devices exist and how they are arranged, to somebody entitled to neither. A link
+ * with an end in a home reaches a recipient who sees it as service with details_withheld,
+ * and is pushed to them only when it appears and when it is removed — never for anything
+ * else, its state and settings included, which are not theirs to see. Its removal is pushed
+ * to them at once, as every loss is — to those who were shown it, and to nobody else.
+ *
+ * @generated from message kusinta.iot.webrtc.v1.LinkChanged
+ */
+export declare type LinkChanged = Message<"kusinta.iot.webrtc.v1.LinkChanged"> & {
+  /**
+   * @generated from field: kusinta.iot.link.v1.DeviceLink link = 1;
+   */
+  link?: DeviceLink | undefined;
+
+  /**
+   * The link is gone, rather than merely not carrying. Distinct from a BROKEN state
+   * because the two need opposite responses: a removal is finished business, while a
+   * link that has stopped carrying is a fault worth showing somebody. Announcing a
+   * deletion as BROKEN would leave every removed link looking like something to go
+   * and repair.
+   *
+   * `link` still carries the whole link when this is set, so the app can name what
+   * went rather than only its id — as much of it as the recipient was shown, so with
+   * details_withheld to one who saw it as service. To such a recipient it means the link is
+   * gone from their view, which need not mean it is gone.
+   *
+   * @generated from field: bool removed = 2;
+   */
+  removed: boolean;
+};
+
+/**
+ * Describes the message kusinta.iot.webrtc.v1.LinkChanged.
+ * Use `create(LinkChangedSchema)` to create a new message.
+ */
+export declare const LinkChangedSchema: GenMessage<LinkChanged>;
+
+/**
+ * One connected connector, described for the app, gateway → app.
  *
+ * Deliberately not connector.v1.ConnectorInfo: that carries transport and endpoint,
+ * which are the gateway↔connector wiring and no business of the app. This is the
+ * app-facing projection — who the connector is and what it can do — and nothing
+ * about how the gateway reaches it.
+ *
+ * @generated from message kusinta.iot.webrtc.v1.ConnectorDescriptor
+ */
+export declare type ConnectorDescriptor = Message<"kusinta.iot.webrtc.v1.ConnectorDescriptor"> & {
+  /**
+   * The routing key. Stable and unique; what StartPairing.connector_id and
+   * ProvisionDevice.connector_id name.
+   *
+   * @generated from field: kusinta.iot.identity.v1.ConnectorId connector_id = 1;
+   */
+  connectorId?: ConnectorId | undefined;
+
+  /**
+   * User-facing label, free-form, never matched on.
+   *
+   * @generated from field: string display_name = 2;
+   */
+  displayName: string;
+
+  /**
+   * @generated from field: repeated uint32 supported_device_type_ids = 3;
+   */
+  supportedDeviceTypeIds: number[];
+
+  /**
+   * The capabilities the app branches on. Copied from the connector's handshake;
+   * see ConnectorInfo for what each means. The app decides pairing-vs-provisioning
+   * and whether to offer hard links from these, never from kind.
+   *
+   * @generated from field: bool supports_pairing = 4;
+   */
+  supportsPairing: boolean;
+
+  /**
+   * @generated from field: bool supports_provisioning = 5;
+   */
+  supportsProvisioning: boolean;
+
+  /**
+   * @generated from field: bool brokers_links = 6;
+   */
+  brokersLinks: boolean;
+
+  /**
+   * Presentation only — an icon or an "unknown hub" fallback; see
+   * common.v1.ConnectorKind. Unset renders as a generic hub.
+   *
+   * @generated from field: kusinta.iot.common.v1.ConnectorKind kind = 7;
+   */
+  kind: ConnectorKind;
+
+  /**
+   * Installer or operator detail, free-form, for a person.
+   *
+   * @generated from field: string description = 8;
+   */
+  description: string;
+
+  /**
+   * Whether the backend the connector drives is working, as the connector last reported it
+   * (see connector.v1.BackendHealthReport): state and category only — the connector's own
+   * detail stays in the gateway's logs. Unset when the connector has stated nothing, which
+   * reads as OK. FAILING is what opens a reporting.v1.PROBLEM_KIND_CONNECTOR_ERROR, and
+   * while it holds the app may offer ReconnectConnector.
+   *
+   * @generated from field: kusinta.iot.common.v1.BackendHealth backend_health = 9;
+   */
+  backendHealth?: BackendHealth | undefined;
+
+  /**
+   * The connector can re-initialise its backend on request: ReconnectConnector is
+   * refused for any connector without it. Copied from the handshake, as the other
+   * capabilities are.
+   *
+   * @generated from field: bool supports_backend_reinitialize = 10;
+   */
+  supportsBackendReinitialize: boolean;
+};
+
+/**
+ * Describes the message kusinta.iot.webrtc.v1.ConnectorDescriptor.
+ * Use `create(ConnectorDescriptorSchema)` to create a new message.
+ */
+export declare const ConnectorDescriptorSchema: GenMessage<ConnectorDescriptor>;
+
+/**
+ * The connectors the gateway currently holds, gateway → app: those connected now. A
+ * connector whose stream drops leaves the list, and its backend health with it; it is
+ * listed again when it reconnects. The app offers ReconnectConnector only for a listed
+ * connector.
+ *
+ * A push, not a ManagementResult arm: a new result-oneof member is a compile error
+ * in a consumer whose match on the result is exhaustive, whereas a new push case is
+ * absorbed by that switch's default. Sent on connect and whenever the set changes —
+ * a connector arriving, leaving, revising its capabilities, or its backend health
+ * changing — and replaces the app's whole picture each time rather than being a delta,
+ * so a client that missed one re-syncs from the next.
+ *
+ * @generated from message kusinta.iot.webrtc.v1.ConnectorsAnnounced
+ */
+export declare type ConnectorsAnnounced = Message<"kusinta.iot.webrtc.v1.ConnectorsAnnounced"> & {
+  /**
+   * @generated from field: repeated kusinta.iot.webrtc.v1.ConnectorDescriptor connectors = 1;
+   */
+  connectors: ConnectorDescriptor[];
+};
+
+/**
+ * Describes the message kusinta.iot.webrtc.v1.ConnectorsAnnounced.
+ * Use `create(ConnectorsAnnouncedSchema)` to create a new message.
+ */
+export declare const ConnectorsAnnouncedSchema: GenMessage<ConnectorsAnnounced>;
+
+/**
+ * A room's climate changed, gateway → app: its target, what set it, what it is being
+ * held at, its condition. Apply as an upsert keyed on room.space_id. Sent only for rooms
+ * the recipient may see, and whenever any field the recipient is sent moves — a knob
+ * turned by hand shows up here without the app asking. To a recipient who sees the room
+ * as service, what is new is sent as it happens and what is lost at once. A recipient who
+ * is sent the room with state_withheld is therefore not sent it when only withheld fields
+ * move.
+ *
+ * @generated from message kusinta.iot.webrtc.v1.RoomClimateChanged
+ */
+export declare type RoomClimateChanged = Message<"kusinta.iot.webrtc.v1.RoomClimateChanged"> & {
+  /**
+   * @generated from field: kusinta.iot.climate.v1.RoomClimate room = 1;
+   */
+  room?: RoomClimate | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.webrtc.v1.RoomClimateChanged.
+ * Use `create(RoomClimateChangedSchema)` to create a new message.
+ */
+export declare const RoomClimateChangedSchema: GenMessage<RoomClimateChanged>;
+
+/**
+ * A mode on a space was switched on, changed or ended, gateway → app. `ended` rather than
+ * kind UNSPECIFIED, so an app can still name the mode that finished. A mode on an
+ * apartment or a room in one is sent to its residents only — whether a home stands empty
+ * is theirs to know — and, while the home is empty, to the property owner and the gateway
+ * administrators who reach it (household.proto, EMPTY HOME), who are sent its end at MOVE-IN;
+ * one on any other space, to whoever reaches it.
+ *
+ * @generated from message kusinta.iot.webrtc.v1.ClimateModeChanged
+ */
+export declare type ClimateModeChanged = Message<"kusinta.iot.webrtc.v1.ClimateModeChanged"> & {
+  /**
+   * @generated from field: kusinta.iot.climate.v1.ClimateMode mode = 1;
+   */
+  mode?: ClimateMode | undefined;
+
+  /**
+   * @generated from field: bool ended = 2;
+   */
+  ended: boolean;
+};
+
+/**
+ * Describes the message kusinta.iot.webrtc.v1.ClimateModeChanged.
+ * Use `create(ClimateModeChangedSchema)` to create a new message.
+ */
+export declare const ClimateModeChangedSchema: GenMessage<ClimateModeChanged>;
+
+/**
  * @generated from message kusinta.iot.webrtc.v1.GatewayMessage
  */
 export declare type GatewayMessage = Message<"kusinta.iot.webrtc.v1.GatewayMessage"> & {
@@ -586,6 +1034,86 @@ export declare type GatewayMessage = Message<"kusinta.iot.webrtc.v1.GatewayMessa
      */
     value: PairingFinished;
     case: "pairingFinished";
+  } | {
+    /**
+     * @generated from field: kusinta.iot.webrtc.v1.LinkChanged link_changed = 19;
+     */
+    value: LinkChanged;
+    case: "linkChanged";
+  } | {
+    /**
+     * @generated from field: kusinta.iot.webrtc.v1.ConnectorsAnnounced connectors_announced = 20;
+     */
+    value: ConnectorsAnnounced;
+    case: "connectorsAnnounced";
+  } | {
+    /**
+     * @generated from field: kusinta.iot.webrtc.v1.RoomClimateChanged room_climate_changed = 21;
+     */
+    value: RoomClimateChanged;
+    case: "roomClimateChanged";
+  } | {
+    /**
+     * @generated from field: kusinta.iot.webrtc.v1.ClimateModeChanged climate_mode_changed = 22;
+     */
+    value: ClimateModeChanged;
+    case: "climateModeChanged";
+  } | {
+    /**
+     * @generated from field: kusinta.iot.webrtc.v1.ServiceStatusChanged service_status_changed = 23;
+     */
+    value: ServiceStatusChanged;
+    case: "serviceStatusChanged";
+  } | {
+    /**
+     * A space's pending invites and join requests changed; see SpaceInvites.
+     *
+     * @generated from field: kusinta.iot.webrtc.v1.SpaceInvites space_invites = 24;
+     */
+    value: SpaceInvites;
+    case: "spaceInvites";
+  } | {
+    /**
+     * The promotion requests the session's user made or was asked to accept changed; see
+     * PromotionRequests.
+     *
+     * @generated from field: kusinta.iot.webrtc.v1.PromotionRequests promotion_requests = 25;
+     */
+    value: PromotionRequests;
+    case: "promotionRequests";
+  } | {
+    /**
+     * A commissioning test changed state: to every session whose user is given it
+     * (commissioning.v1), save its start to the session that started it.
+     *
+     * @generated from field: kusinta.iot.commissioning.v1.CommissioningTest commissioning_test = 26;
+     */
+    value: CommissioningTest;
+    case: "commissioningTest";
+  } | {
+    /**
+     * The commissioning grants on a space changed; see commissioning.v1.CommissioningGrants.
+     *
+     * @generated from field: kusinta.iot.commissioning.v1.CommissioningGrants commissioning_grants = 27;
+     */
+    value: CommissioningGrants;
+    case: "commissioningGrants";
+  } | {
+    /**
+     * A home's handover was started, cancelled or done; see HouseholdHandover.
+     *
+     * @generated from field: kusinta.iot.webrtc.v1.HouseholdHandover household_handover = 28;
+     */
+    value: HouseholdHandover;
+    case: "householdHandover";
+  } | {
+    /**
+     * A home's climate history was cleared; see ClimateHistoryCleared.
+     *
+     * @generated from field: kusinta.iot.webrtc.v1.ClimateHistoryCleared climate_history_cleared = 29;
+     */
+    value: ClimateHistoryCleared;
+    case: "climateHistoryCleared";
   } | { case: undefined; value?: undefined };
 };
 
@@ -677,6 +1205,51 @@ export declare type AppMessage = Message<"kusinta.iot.webrtc.v1.AppMessage"> & {
  */
 export declare const AppMessageSchema: GenMessage<AppMessage>;
 
+/**
+ * Why a handshake was refused (HandshakeRejected.code).
+ *
+ * @generated from enum kusinta.iot.webrtc.v1.HandshakeRejectReason
+ */
+export enum HandshakeRejectReason {
+  /**
+   * Not stated, or a value this app's schema does not know: an app says that the gateway
+   * refused the connection, and no more. It treats the refusal as a passing failure, and
+   * retries under its ordinary backoff.
+   *
+   * @generated from enum value: HANDSHAKE_REJECT_REASON_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * A message the gateway could not decode. A fault of the app's: retrying repeats it, so an
+   * app MUST NOT retry in a loop.
+   *
+   * @generated from enum value: HANDSHAKE_REJECT_REASON_INVALID_ENCODING = 1;
+   */
+  INVALID_ENCODING = 1,
+
+  /**
+   * A message before AppHandshake, which must come first. A fault of the app's, as
+   * INVALID_ENCODING is: an app MUST NOT retry in a loop.
+   *
+   * @generated from enum value: HANDSHAKE_REJECT_REASON_HANDSHAKE_REQUIRED = 2;
+   */
+  HANDSHAKE_REQUIRED = 2,
+
+  /**
+   * The token in AppHandshake was not accepted (AppTokenClaims). A fresh token can help: an
+   * app may refresh it and retry once, and then stops and tells its user.
+   *
+   * @generated from enum value: HANDSHAKE_REJECT_REASON_AUTHENTICATION_FAILED = 3;
+   */
+  AUTHENTICATION_FAILED = 3,
+}
+
+/**
+ * Describes the enum kusinta.iot.webrtc.v1.HandshakeRejectReason.
+ */
+export declare const HandshakeRejectReasonSchema: GenEnum<HandshakeRejectReason>;
+
 /**
  * Machine-readable classification of a session-level gateway error, so the app
  * can branch without string-matching a human sentence. Deliberately an enum here,
@@ -741,6 +1314,23 @@ export enum GatewayErrorCode {
    * @generated from enum value: GATEWAY_ERROR_CODE_SESSION_LIMIT_REACHED = 5;
    */
   SESSION_LIMIT_REACHED = 5,
+
+  /**
+   * The request was well formed and the caller may make it, but it will not succeed without
+   * a change on the receiving side — a capability the target lacks, configuration only a
+   * person can fix. Do not retry as is. Distinct from INVALID_REQUEST, which is the app's
+   * bug, and from UNAVAILABLE, which clears on its own. GatewayError.metadata says which
+   * precondition failed where the operation documents one. Sent only in answer to a request
+   * whose operation documents it, never as a session-level error that refuses or ends a
+   * session.
+   *
+   * Rollout note: a client whose schema predates this value decodes it as UNSPECIFIED,
+   * which is retryable by design, so it may offer a retry that fails the same way again.
+   * Harmless, but client handling should ship before or with the gateway that emits it.
+   *
+   * @generated from enum value: GATEWAY_ERROR_CODE_FAILED_PRECONDITION = 6;
+   */
+  FAILED_PRECONDITION = 6,
 }
 
 /**