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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kusinta/iot-schema",
-  "version": "0.2.0-beta.6",
+  "version": "0.2.0-beta.9",
   "type": "module",
   "license": "MIT",
   "files": ["src"],
@@ -24,6 +24,7 @@
     "./space":                  "./src/kusinta/iot/space/v1/space_pb.js",
     "./access":                 "./src/kusinta/iot/access/v1/acl_pb.js",
     "./access/roles":           "./src/kusinta/iot/access/v1/roles_pb.js",
+    "./link":                   "./src/kusinta/iot/link/v1/link_pb.js",
     "./connector":              "./src/kusinta/iot/connector/v1/connector_pb.js",
     "./connector/service":      "./src/kusinta/iot/connector/v1/connector_service_pb.js",
     "./webrtc":                 "./src/kusinta/iot/webrtc/v1/envelope_pb.js",

package/src/kusinta/iot/common/v1/pairing_pb.d.ts

@@ -85,9 +85,11 @@ export declare type PairingWindow = Message<"kusinta.iot.common.v1.PairingWindow
    * rather than any person's. It does not suit a caller whose pairing mints personal
    * ownership.
    *
-   * A hint and a batch cannot be combined, and that is a contradiction rather than a
-   * limitation: device_hint names one device, so a window restricted to it can never produce
-   * a second arrival to attribute.
+   * Ignored where device_hint is set, and narrowed to one rather than refused: a hint names
+   * one device, so a window restricted to it can never produce a second arrival to attribute.
+   * The combination is meaningless rather than dangerous, and there is no honest code in
+   * PairingError for "your request contradicted itself" — refusing it would mean answering a
+   * malformed request with an entitlement decision that was never made.
    *
    * @generated from field: optional uint32 max_devices = 3;
    */

package/src/kusinta/iot/connector/v1/connector_pb.d.ts

@@ -7,6 +7,7 @@ import type { Message } from "@bufbuild/protobuf";
 import type { ConnectorId, DeviceId, GatewayId } from "../../identity/v1/identity_pb.js";
 import type { ConnectorTransport } from "../../common/v1/types_pb.js";
 import type { Device } from "../../device/v1/device_pb.js";
+import type { DeviceLink, LinkFunction, LinkState } from "../../link/v1/link_pb.js";
 import type { Timestamp } from "@bufbuild/protobuf/wkt";
 import type { AttributeWriteRequest, CommandError, DeviceCommand } from "../../webrtc/v1/command_pb.js";
 import type { PairingErrorDetail, PairingWindow } from "../../common/v1/pairing_pb.js";
@@ -74,6 +75,22 @@ export declare type ConnectorHandshake = Message<"kusinta.iot.connector.v1.Conne
    * @generated from field: repeated kusinta.iot.device.v1.Device known_devices = 2;
    */
   knownDevices: Device[];
+
+  /**
+   * Every link the hub currently holds, reported the way known_devices is.
+   *
+   * Links are hub state, not gateway state: they outlive a connector restart and
+   * can be changed by anyone with access to the hub. The gateway's records are a
+   * statement of intent that can drift, so the handshake is the moment to
+   * reconcile them against what is really there. A link in the gateway's records
+   * and not here has gone; one here and not in the records was made elsewhere.
+   *
+   * Empty means "states nothing" — a connector that does not model linking is not
+   * asserting that no links exist.
+   *
+   * @generated from field: repeated kusinta.iot.link.v1.DeviceLink known_links = 3;
+   */
+  knownLinks: DeviceLink[];
 };
 
 /**
@@ -82,6 +99,163 @@ export declare type ConnectorHandshake = Message<"kusinta.iot.connector.v1.Conne
  */
 export declare const ConnectorHandshakeSchema: GenMessage<ConnectorHandshake>;
 
+/**
+ * Asks the connector to make a link, gateway to connector.
+ *
+ * Names two devices and a function; resolving that into whatever set of
+ * underlying connections the hub needs is the connector's work. It is expected to
+ * build the set atomically and roll back a partial one, because a half-built set
+ * is a link that lists as healthy and carries nothing.
+ *
+ * The connector is also expected to repair whatever the operation disturbs. On at
+ * least one vendor, both making and removing a link leaves the receiving device
+ * in a state it was not in before, with settings that must be captured
+ * beforehand and put back after.
+ *
+ * @generated from message kusinta.iot.connector.v1.CreateLink
+ */
+export declare type CreateLink = Message<"kusinta.iot.connector.v1.CreateLink"> & {
+  /**
+   * assigned by the gateway, echoed in the result
+   *
+   * @generated from field: string link_id = 1;
+   */
+  linkId: string;
+
+  /**
+   * @generated from field: kusinta.iot.identity.v1.DeviceId sender = 2;
+   */
+  sender?: DeviceId | undefined;
+
+  /**
+   * @generated from field: kusinta.iot.identity.v1.DeviceId receiver = 3;
+   */
+  receiver?: DeviceId | undefined;
+
+  /**
+   * @generated from field: kusinta.iot.link.v1.LinkFunction function = 4;
+   */
+  function: LinkFunction;
+};
+
+/**
+ * Describes the message kusinta.iot.connector.v1.CreateLink.
+ * Use `create(CreateLinkSchema)` to create a new message.
+ */
+export declare const CreateLinkSchema: GenMessage<CreateLink>;
+
+/**
+ * Asks the connector to remove a link it previously made.
+ *
+ * @generated from message kusinta.iot.connector.v1.RemoveLink
+ */
+export declare type RemoveLink = Message<"kusinta.iot.connector.v1.RemoveLink"> & {
+  /**
+   * @generated from field: string link_id = 1;
+   */
+  linkId: string;
+
+  /**
+   * @generated from field: kusinta.iot.identity.v1.DeviceId sender = 2;
+   */
+  sender?: DeviceId | undefined;
+
+  /**
+   * @generated from field: kusinta.iot.identity.v1.DeviceId receiver = 3;
+   */
+  receiver?: DeviceId | undefined;
+
+  /**
+   * @generated from field: kusinta.iot.link.v1.LinkFunction function = 4;
+   */
+  function: LinkFunction;
+};
+
+/**
+ * Describes the message kusinta.iot.connector.v1.RemoveLink.
+ * Use `create(RemoveLinkSchema)` to create a new message.
+ */
+export declare const RemoveLinkSchema: GenMessage<RemoveLink>;
+
+/**
+ * Asks the connector what links the hub holds, for reconciliation outside a
+ * handshake.
+ *
+ * @generated from message kusinta.iot.connector.v1.ListLinks
+ */
+export declare type ListLinks = Message<"kusinta.iot.connector.v1.ListLinks"> & {
+  /**
+   * Unset asks for every link the hub holds.
+   *
+   * @generated from field: kusinta.iot.identity.v1.DeviceId device_id = 1;
+   */
+  deviceId?: DeviceId | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.connector.v1.ListLinks.
+ * Use `create(ListLinksSchema)` to create a new message.
+ */
+export declare const ListLinksSchema: GenMessage<ListLinks>;
+
+/**
+ * What became of a CreateLink or RemoveLink, connector to gateway.
+ *
+ * Reports the link's observed state rather than merely whether the call was
+ * accepted. A hub will report a link as present and healthy while the devices
+ * ignore it, so "the request did not fail" is not the same claim as "the link is
+ * carrying" and must not be encoded as though it were.
+ *
+ * @generated from message kusinta.iot.connector.v1.LinkResult
+ */
+export declare type LinkResult = Message<"kusinta.iot.connector.v1.LinkResult"> & {
+  /**
+   * @generated from field: string link_id = 1;
+   */
+  linkId: string;
+
+  /**
+   * @generated from field: bool success = 2;
+   */
+  success: boolean;
+
+  /**
+   * @generated from field: kusinta.iot.link.v1.LinkState state = 3;
+   */
+  state: LinkState;
+
+  /**
+   * Why not, when success is false. For a person; never parsed.
+   *
+   * @generated from field: string detail = 4;
+   */
+  detail: string;
+};
+
+/**
+ * Describes the message kusinta.iot.connector.v1.LinkResult.
+ * Use `create(LinkResultSchema)` to create a new message.
+ */
+export declare const LinkResultSchema: GenMessage<LinkResult>;
+
+/**
+ * Every link the hub holds, connector to gateway, in reply to ListLinks.
+ *
+ * @generated from message kusinta.iot.connector.v1.LinksReported
+ */
+export declare type LinksReported = Message<"kusinta.iot.connector.v1.LinksReported"> & {
+  /**
+   * @generated from field: repeated kusinta.iot.link.v1.DeviceLink links = 1;
+   */
+  links: DeviceLink[];
+};
+
+/**
+ * Describes the message kusinta.iot.connector.v1.LinksReported.
+ * Use `create(LinksReportedSchema)` to create a new message.
+ */
+export declare const LinksReportedSchema: GenMessage<LinksReported>;
+
 /**
  * @generated from message kusinta.iot.connector.v1.HandshakeAck
  */
@@ -521,6 +695,18 @@ export declare type SessionRequest = Message<"kusinta.iot.connector.v1.SessionRe
      */
     value: PairingModeEnded;
     case: "pairingModeEnded";
+  } | {
+    /**
+     * @generated from field: kusinta.iot.connector.v1.LinkResult link_result = 12;
+     */
+    value: LinkResult;
+    case: "linkResult";
+  } | {
+    /**
+     * @generated from field: kusinta.iot.connector.v1.LinksReported links_reported = 13;
+     */
+    value: LinksReported;
+    case: "linksReported";
   } | { case: undefined; value?: undefined };
 };
 
@@ -594,6 +780,28 @@ export declare type SessionResponse = Message<"kusinta.iot.connector.v1.SessionR
      */
     value: EnterPairingMode;
     case: "enterPairingMode";
+  } | {
+    /**
+     * The link operations. Separate cases rather than one with a verb, so a
+     * connector that models none of them fails to match rather than having to
+     * decode a request it cannot serve.
+     *
+     * @generated from field: kusinta.iot.connector.v1.CreateLink create_link = 11;
+     */
+    value: CreateLink;
+    case: "createLink";
+  } | {
+    /**
+     * @generated from field: kusinta.iot.connector.v1.RemoveLink remove_link = 12;
+     */
+    value: RemoveLink;
+    case: "removeLink";
+  } | {
+    /**
+     * @generated from field: kusinta.iot.connector.v1.ListLinks list_links = 13;
+     */
+    value: ListLinks;
+    case: "listLinks";
   } | { case: undefined; value?: undefined };
 };
 

package/src/kusinta/iot/connector/v1/connector_pb.js

@@ -10,13 +10,14 @@ import { file_kusinta_iot_device_v1_device } from "../../device/v1/device_pb.js"
 import { file_kusinta_iot_device_v1_device_event } from "../../device/v1/device_event_pb.js";
 import { file_kusinta_iot_device_v1_property_update } from "../../device/v1/property_update_pb.js";
 import { file_kusinta_iot_identity_v1_identity } from "../../identity/v1/identity_pb.js";
+import { file_kusinta_iot_link_v1_link } from "../../link/v1/link_pb.js";
 import { file_kusinta_iot_webrtc_v1_command } from "../../webrtc/v1/command_pb.js";
 
 /**
  * Describes the file kusinta/iot/connector/v1/connector.proto.
  */
 export const file_kusinta_iot_connector_v1_connector = /*@__PURE__*/
-  fileDesc("CihrdXNpbnRhL2lvdC9jb25uZWN0b3IvdjEvY29ubmVjdG9yLnByb3RvEhhrdXNpbnRhLmlvdC5jb25uZWN0b3IudjEi5QEKDUNvbm5lY3RvckluZm8SOgoMY29ubmVjdG9yX2lkGAEgASgLMiQua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuQ29ubmVjdG9ySWQSFAoMZGlzcGxheV9uYW1lGAIgASgJEg8KB3ZlcnNpb24YAyABKAkSPAoJdHJhbnNwb3J0GAQgASgOMikua3VzaW50YS5pb3QuY29tbW9uLnYxLkNvbm5lY3RvclRyYW5zcG9ydBIQCghlbmRwb2ludBgFIAEoCRIhChlzdXBwb3J0ZWRfZGV2aWNlX3R5cGVfaWRzGAYgAygNIoEBChJDb25uZWN0b3JIYW5kc2hha2USNQoEaW5mbxgBIAEoCzInLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5Db25uZWN0b3JJbmZvEjQKDWtub3duX2RldmljZXMYAiADKAsyHS5rdXNpbnRhLmlvdC5kZXZpY2UudjEuRGV2aWNlImgKDEhhbmRzaGFrZUFjaxIQCghhY2NlcHRlZBgBIAEoCBIOCgZyZWFzb24YAiABKAkSNgoKZ2F0ZXdheV9pZBgDIAEoCzIiLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkdhdGV3YXlJZCJxChJEZXZpY2VBbm5vdW5jZW1lbnQSLQoGZGV2aWNlGAIgASgLMh0ua3VzaW50YS5pb3QuZGV2aWNlLnYxLkRldmljZRIaChJwYWlyaW5nX3JlcXVlc3RfaWQYAyABKAlKBAgBEAJSCmRlc2NyaXB0b3IiVQoNRGV2aWNlUmVtb3ZhbBI0CglkZXZpY2VfaWQYASABKAsyIS5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5EZXZpY2VJZBIOCgZyZWFzb24YAiABKAkiCwoJSGVhcnRCZWF0IkcKD1N1YnNjcmliZURldmljZRI0CglkZXZpY2VfaWQYASABKAsyIS5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5EZXZpY2VJZCJJChFVbnN1YnNjcmliZURldmljZRI0CglkZXZpY2VfaWQYASABKAsyIS5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5EZXZpY2VJZCJBCgxHYXRld2F5RXJyb3ISDAoEY29kZRgBIAEoCRIPCgdtZXNzYWdlGAIgASgJEhIKCnJlcXVlc3RfaWQYAyABKAki7QEKFkNvbm5lY3RvckNvbW1hbmRSZXN1bHQSEgoKcmVxdWVzdF9pZBgBIAEoCRIPCgdzdWNjZXNzGAIgASgIEjAKDGNvbXBsZXRlZF9hdBgEIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASMgoFZXJyb3IYBSABKAsyIy5rdXNpbnRhLmlvdC53ZWJydGMudjEuQ29tbWFuZEVycm9yEjMKCnNldHRsZXNfYnkYBiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wSACIAQFCDQoLX3NldHRsZXNfYnlKBAgDEAQiXAoQRW50ZXJQYWlyaW5nTW9kZRISCgpyZXF1ZXN0X2lkGAEgASgJEjQKBndpbmRvdxgCIAEoCzIkLmt1c2ludGEuaW90LmNvbW1vbi52MS5QYWlyaW5nV2luZG93IqMBChFQYWlyaW5nTW9kZVJlc3VsdBISCgpyZXF1ZXN0X2lkGAEgASgJEhAKCGFjY2VwdGVkGAIgASgIEjgKBWVycm9yGAMgASgLMikua3VzaW50YS5pb3QuY29tbW9uLnYxLlBhaXJpbmdFcnJvckRldGFpbBIuCgpleHBpcmVzX2F0GAQgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcCJ8ChBQYWlyaW5nTW9kZUVuZGVkEhIKCnJlcXVlc3RfaWQYASABKAkSGgoSZGV2aWNlc19hdHRyaWJ1dGVkGAIgASgNEjgKBWVycm9yGAMgASgLMikua3VzaW50YS5pb3QuY29tbW9uLnYxLlBhaXJpbmdFcnJvckRldGFpbCLRBQoOU2Vzc2lvblJlcXVlc3QSEgoKbWVzc2FnZV9pZBgBIAEoCRIrCgdzZW50X2F0GAIgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBJBCgloYW5kc2hha2UYAyABKAsyLC5rdXNpbnRhLmlvdC5jb25uZWN0b3IudjEuQ29ubmVjdG9ySGFuZHNoYWtlSAASRQoPcHJvcGVydHlfdXBkYXRlGAQgASgLMioua3VzaW50YS5pb3QuZGV2aWNlLnYxLlByb3BlcnR5VXBkYXRlQmF0Y2hIABJIChBkZXZpY2VfYW5ub3VuY2VkGAUgASgLMiwua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkRldmljZUFubm91bmNlbWVudEgAEkEKDmRldmljZV9yZW1vdmVkGAYgASgLMicua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkRldmljZVJlbW92YWxIABJKCg5jb21tYW5kX3Jlc3VsdBgHIAEoCzIwLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5Db25uZWN0b3JDb21tYW5kUmVzdWx0SAASOAoJaGVhcnRiZWF0GAggASgLMiMua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkhlYXJ0QmVhdEgAEkAKDWRldmljZV9ldmVudHMYCSABKAsyJy5rdXNpbnRhLmlvdC5kZXZpY2UudjEuRGV2aWNlRXZlbnRCYXRjaEgAEkoKE3BhaXJpbmdfbW9kZV9yZXN1bHQYCiABKAsyKy5rdXNpbnRhLmlvdC5jb25uZWN0b3IudjEuUGFpcmluZ01vZGVSZXN1bHRIABJIChJwYWlyaW5nX21vZGVfZW5kZWQYCyABKAsyKi5rdXNpbnRhLmlvdC5jb25uZWN0b3IudjEuUGFpcmluZ01vZGVFbmRlZEgAQgkKB3BheWxvYWQivQQKD1Nlc3Npb25SZXNwb25zZRISCgptZXNzYWdlX2lkGAEgASgJEisKB3NlbnRfYXQYAiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEj8KDWhhbmRzaGFrZV9hY2sYAyABKAsyJi5rdXNpbnRhLmlvdC5jb25uZWN0b3IudjEuSGFuZHNoYWtlQWNrSAASPgoJc3Vic2NyaWJlGAUgASgLMikua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLlN1YnNjcmliZURldmljZUgAEkIKC3Vuc3Vic2NyaWJlGAYgASgLMisua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLlVuc3Vic2NyaWJlRGV2aWNlSAASNwoFZXJyb3IYByABKAsyJi5rdXNpbnRhLmlvdC5jb25uZWN0b3IudjEuR2F0ZXdheUVycm9ySAASPwoPZXhlY3V0ZV9jb21tYW5kGAggASgLMiQua3VzaW50YS5pb3Qud2VicnRjLnYxLkRldmljZUNvbW1hbmRIABJPChdleGVjdXRlX2F0dHJpYnV0ZV93cml0ZRgJIAEoCzIsLmt1c2ludGEuaW90LndlYnJ0Yy52MS5BdHRyaWJ1dGVXcml0ZVJlcXVlc3RIABJIChJlbnRlcl9wYWlyaW5nX21vZGUYCiABKAsyKi5rdXNpbnRhLmlvdC5jb25uZWN0b3IudjEuRW50ZXJQYWlyaW5nTW9kZUgAQgkKB3BheWxvYWRKBAgEEAVCAkgBYgZwcm90bzM", [file_google_protobuf_timestamp, file_kusinta_iot_common_v1_pairing, file_kusinta_iot_common_v1_types, file_kusinta_iot_device_v1_device, file_kusinta_iot_device_v1_device_event, file_kusinta_iot_device_v1_property_update, file_kusinta_iot_identity_v1_identity, file_kusinta_iot_webrtc_v1_command]);
+  fileDesc("CihrdXNpbnRhL2lvdC9jb25uZWN0b3IvdjEvY29ubmVjdG9yLnByb3RvEhhrdXNpbnRhLmlvdC5jb25uZWN0b3IudjEi5QEKDUNvbm5lY3RvckluZm8SOgoMY29ubmVjdG9yX2lkGAEgASgLMiQua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuQ29ubmVjdG9ySWQSFAoMZGlzcGxheV9uYW1lGAIgASgJEg8KB3ZlcnNpb24YAyABKAkSPAoJdHJhbnNwb3J0GAQgASgOMikua3VzaW50YS5pb3QuY29tbW9uLnYxLkNvbm5lY3RvclRyYW5zcG9ydBIQCghlbmRwb2ludBgFIAEoCRIhChlzdXBwb3J0ZWRfZGV2aWNlX3R5cGVfaWRzGAYgAygNIrcBChJDb25uZWN0b3JIYW5kc2hha2USNQoEaW5mbxgBIAEoCzInLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5Db25uZWN0b3JJbmZvEjQKDWtub3duX2RldmljZXMYAiADKAsyHS5rdXNpbnRhLmlvdC5kZXZpY2UudjEuRGV2aWNlEjQKC2tub3duX2xpbmtzGAMgAygLMh8ua3VzaW50YS5pb3QubGluay52MS5EZXZpY2VMaW5rIroBCgpDcmVhdGVMaW5rEg8KB2xpbmtfaWQYASABKAkSMQoGc2VuZGVyGAIgASgLMiEua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuRGV2aWNlSWQSMwoIcmVjZWl2ZXIYAyABKAsyIS5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5EZXZpY2VJZBIzCghmdW5jdGlvbhgEIAEoDjIhLmt1c2ludGEuaW90LmxpbmsudjEuTGlua0Z1bmN0aW9uIroBCgpSZW1vdmVMaW5rEg8KB2xpbmtfaWQYASABKAkSMQoGc2VuZGVyGAIgASgLMiEua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuRGV2aWNlSWQSMwoIcmVjZWl2ZXIYAyABKAsyIS5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5EZXZpY2VJZBIzCghmdW5jdGlvbhgEIAEoDjIhLmt1c2ludGEuaW90LmxpbmsudjEuTGlua0Z1bmN0aW9uIkEKCUxpc3RMaW5rcxI0CglkZXZpY2VfaWQYASABKAsyIS5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5EZXZpY2VJZCJtCgpMaW5rUmVzdWx0Eg8KB2xpbmtfaWQYASABKAkSDwoHc3VjY2VzcxgCIAEoCBItCgVzdGF0ZRgDIAEoDjIeLmt1c2ludGEuaW90LmxpbmsudjEuTGlua1N0YXRlEg4KBmRldGFpbBgEIAEoCSI/Cg1MaW5rc1JlcG9ydGVkEi4KBWxpbmtzGAEgAygLMh8ua3VzaW50YS5pb3QubGluay52MS5EZXZpY2VMaW5rImgKDEhhbmRzaGFrZUFjaxIQCghhY2NlcHRlZBgBIAEoCBIOCgZyZWFzb24YAiABKAkSNgoKZ2F0ZXdheV9pZBgDIAEoCzIiLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkdhdGV3YXlJZCJxChJEZXZpY2VBbm5vdW5jZW1lbnQSLQoGZGV2aWNlGAIgASgLMh0ua3VzaW50YS5pb3QuZGV2aWNlLnYxLkRldmljZRIaChJwYWlyaW5nX3JlcXVlc3RfaWQYAyABKAlKBAgBEAJSCmRlc2NyaXB0b3IiVQoNRGV2aWNlUmVtb3ZhbBI0CglkZXZpY2VfaWQYASABKAsyIS5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5EZXZpY2VJZBIOCgZyZWFzb24YAiABKAkiCwoJSGVhcnRCZWF0IkcKD1N1YnNjcmliZURldmljZRI0CglkZXZpY2VfaWQYASABKAsyIS5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5EZXZpY2VJZCJJChFVbnN1YnNjcmliZURldmljZRI0CglkZXZpY2VfaWQYASABKAsyIS5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5EZXZpY2VJZCJBCgxHYXRld2F5RXJyb3ISDAoEY29kZRgBIAEoCRIPCgdtZXNzYWdlGAIgASgJEhIKCnJlcXVlc3RfaWQYAyABKAki7QEKFkNvbm5lY3RvckNvbW1hbmRSZXN1bHQSEgoKcmVxdWVzdF9pZBgBIAEoCRIPCgdzdWNjZXNzGAIgASgIEjAKDGNvbXBsZXRlZF9hdBgEIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASMgoFZXJyb3IYBSABKAsyIy5rdXNpbnRhLmlvdC53ZWJydGMudjEuQ29tbWFuZEVycm9yEjMKCnNldHRsZXNfYnkYBiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wSACIAQFCDQoLX3NldHRsZXNfYnlKBAgDEAQiXAoQRW50ZXJQYWlyaW5nTW9kZRISCgpyZXF1ZXN0X2lkGAEgASgJEjQKBndpbmRvdxgCIAEoCzIkLmt1c2ludGEuaW90LmNvbW1vbi52MS5QYWlyaW5nV2luZG93IqMBChFQYWlyaW5nTW9kZVJlc3VsdBISCgpyZXF1ZXN0X2lkGAEgASgJEhAKCGFjY2VwdGVkGAIgASgIEjgKBWVycm9yGAMgASgLMikua3VzaW50YS5pb3QuY29tbW9uLnYxLlBhaXJpbmdFcnJvckRldGFpbBIuCgpleHBpcmVzX2F0GAQgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcCJ8ChBQYWlyaW5nTW9kZUVuZGVkEhIKCnJlcXVlc3RfaWQYASABKAkSGgoSZGV2aWNlc19hdHRyaWJ1dGVkGAIgASgNEjgKBWVycm9yGAMgASgLMikua3VzaW50YS5pb3QuY29tbW9uLnYxLlBhaXJpbmdFcnJvckRldGFpbCLRBgoOU2Vzc2lvblJlcXVlc3QSEgoKbWVzc2FnZV9pZBgBIAEoCRIrCgdzZW50X2F0GAIgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBJBCgloYW5kc2hha2UYAyABKAsyLC5rdXNpbnRhLmlvdC5jb25uZWN0b3IudjEuQ29ubmVjdG9ySGFuZHNoYWtlSAASRQoPcHJvcGVydHlfdXBkYXRlGAQgASgLMioua3VzaW50YS5pb3QuZGV2aWNlLnYxLlByb3BlcnR5VXBkYXRlQmF0Y2hIABJIChBkZXZpY2VfYW5ub3VuY2VkGAUgASgLMiwua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkRldmljZUFubm91bmNlbWVudEgAEkEKDmRldmljZV9yZW1vdmVkGAYgASgLMicua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkRldmljZVJlbW92YWxIABJKCg5jb21tYW5kX3Jlc3VsdBgHIAEoCzIwLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5Db25uZWN0b3JDb21tYW5kUmVzdWx0SAASOAoJaGVhcnRiZWF0GAggASgLMiMua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkhlYXJ0QmVhdEgAEkAKDWRldmljZV9ldmVudHMYCSABKAsyJy5rdXNpbnRhLmlvdC5kZXZpY2UudjEuRGV2aWNlRXZlbnRCYXRjaEgAEkoKE3BhaXJpbmdfbW9kZV9yZXN1bHQYCiABKAsyKy5rdXNpbnRhLmlvdC5jb25uZWN0b3IudjEuUGFpcmluZ01vZGVSZXN1bHRIABJIChJwYWlyaW5nX21vZGVfZW5kZWQYCyABKAsyKi5rdXNpbnRhLmlvdC5jb25uZWN0b3IudjEuUGFpcmluZ01vZGVFbmRlZEgAEjsKC2xpbmtfcmVzdWx0GAwgASgLMiQua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkxpbmtSZXN1bHRIABJBCg5saW5rc19yZXBvcnRlZBgNIAEoCzInLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5MaW5rc1JlcG9ydGVkSABCCQoHcGF5bG9hZCLyBQoPU2Vzc2lvblJlc3BvbnNlEhIKCm1lc3NhZ2VfaWQYASABKAkSKwoHc2VudF9hdBgCIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASPwoNaGFuZHNoYWtlX2FjaxgDIAEoCzImLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5IYW5kc2hha2VBY2tIABI+CglzdWJzY3JpYmUYBSABKAsyKS5rdXNpbnRhLmlvdC5jb25uZWN0b3IudjEuU3Vic2NyaWJlRGV2aWNlSAASQgoLdW5zdWJzY3JpYmUYBiABKAsyKy5rdXNpbnRhLmlvdC5jb25uZWN0b3IudjEuVW5zdWJzY3JpYmVEZXZpY2VIABI3CgVlcnJvchgHIAEoCzImLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5HYXRld2F5RXJyb3JIABI/Cg9leGVjdXRlX2NvbW1hbmQYCCABKAsyJC5rdXNpbnRhLmlvdC53ZWJydGMudjEuRGV2aWNlQ29tbWFuZEgAEk8KF2V4ZWN1dGVfYXR0cmlidXRlX3dyaXRlGAkgASgLMiwua3VzaW50YS5pb3Qud2VicnRjLnYxLkF0dHJpYnV0ZVdyaXRlUmVxdWVzdEgAEkgKEmVudGVyX3BhaXJpbmdfbW9kZRgKIAEoCzIqLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5FbnRlclBhaXJpbmdNb2RlSAASOwoLY3JlYXRlX2xpbmsYCyABKAsyJC5rdXNpbnRhLmlvdC5jb25uZWN0b3IudjEuQ3JlYXRlTGlua0gAEjsKC3JlbW92ZV9saW5rGAwgASgLMiQua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLlJlbW92ZUxpbmtIABI5CgpsaXN0X2xpbmtzGA0gASgLMiMua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkxpc3RMaW5rc0gAQgkKB3BheWxvYWRKBAgEEAVCAkgBYgZwcm90bzM", [file_google_protobuf_timestamp, file_kusinta_iot_common_v1_pairing, file_kusinta_iot_common_v1_types, file_kusinta_iot_device_v1_device, file_kusinta_iot_device_v1_device_event, file_kusinta_iot_device_v1_property_update, file_kusinta_iot_identity_v1_identity, file_kusinta_iot_link_v1_link, file_kusinta_iot_webrtc_v1_command]);
 
 /**
  * Describes the message kusinta.iot.connector.v1.ConnectorInfo.
@@ -32,94 +33,129 @@ export const ConnectorInfoSchema = /*@__PURE__*/
 export const ConnectorHandshakeSchema = /*@__PURE__*/
   messageDesc(file_kusinta_iot_connector_v1_connector, 1);
 
+/**
+ * Describes the message kusinta.iot.connector.v1.CreateLink.
+ * Use `create(CreateLinkSchema)` to create a new message.
+ */
+export const CreateLinkSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_connector_v1_connector, 2);
+
+/**
+ * Describes the message kusinta.iot.connector.v1.RemoveLink.
+ * Use `create(RemoveLinkSchema)` to create a new message.
+ */
+export const RemoveLinkSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_connector_v1_connector, 3);
+
+/**
+ * Describes the message kusinta.iot.connector.v1.ListLinks.
+ * Use `create(ListLinksSchema)` to create a new message.
+ */
+export const ListLinksSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_connector_v1_connector, 4);
+
+/**
+ * Describes the message kusinta.iot.connector.v1.LinkResult.
+ * Use `create(LinkResultSchema)` to create a new message.
+ */
+export const LinkResultSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_connector_v1_connector, 5);
+
+/**
+ * Describes the message kusinta.iot.connector.v1.LinksReported.
+ * Use `create(LinksReportedSchema)` to create a new message.
+ */
+export const LinksReportedSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_connector_v1_connector, 6);
+
 /**
  * Describes the message kusinta.iot.connector.v1.HandshakeAck.
  * Use `create(HandshakeAckSchema)` to create a new message.
  */
 export const HandshakeAckSchema = /*@__PURE__*/
-  messageDesc(file_kusinta_iot_connector_v1_connector, 2);
+  messageDesc(file_kusinta_iot_connector_v1_connector, 7);
 
 /**
  * Describes the message kusinta.iot.connector.v1.DeviceAnnouncement.
  * Use `create(DeviceAnnouncementSchema)` to create a new message.
  */
 export const DeviceAnnouncementSchema = /*@__PURE__*/
-  messageDesc(file_kusinta_iot_connector_v1_connector, 3);
+  messageDesc(file_kusinta_iot_connector_v1_connector, 8);
 
 /**
  * Describes the message kusinta.iot.connector.v1.DeviceRemoval.
  * Use `create(DeviceRemovalSchema)` to create a new message.
  */
 export const DeviceRemovalSchema = /*@__PURE__*/
-  messageDesc(file_kusinta_iot_connector_v1_connector, 4);
+  messageDesc(file_kusinta_iot_connector_v1_connector, 9);
 
 /**
  * Describes the message kusinta.iot.connector.v1.HeartBeat.
  * Use `create(HeartBeatSchema)` to create a new message.
  */
 export const HeartBeatSchema = /*@__PURE__*/
-  messageDesc(file_kusinta_iot_connector_v1_connector, 5);
+  messageDesc(file_kusinta_iot_connector_v1_connector, 10);
 
 /**
  * Describes the message kusinta.iot.connector.v1.SubscribeDevice.
  * Use `create(SubscribeDeviceSchema)` to create a new message.
  */
 export const SubscribeDeviceSchema = /*@__PURE__*/
-  messageDesc(file_kusinta_iot_connector_v1_connector, 6);
+  messageDesc(file_kusinta_iot_connector_v1_connector, 11);
 
 /**
  * Describes the message kusinta.iot.connector.v1.UnsubscribeDevice.
  * Use `create(UnsubscribeDeviceSchema)` to create a new message.
  */
 export const UnsubscribeDeviceSchema = /*@__PURE__*/
-  messageDesc(file_kusinta_iot_connector_v1_connector, 7);
+  messageDesc(file_kusinta_iot_connector_v1_connector, 12);
 
 /**
  * Describes the message kusinta.iot.connector.v1.GatewayError.
  * Use `create(GatewayErrorSchema)` to create a new message.
  */
 export const GatewayErrorSchema = /*@__PURE__*/
-  messageDesc(file_kusinta_iot_connector_v1_connector, 8);
+  messageDesc(file_kusinta_iot_connector_v1_connector, 13);
 
 /**
  * Describes the message kusinta.iot.connector.v1.ConnectorCommandResult.
  * Use `create(ConnectorCommandResultSchema)` to create a new message.
  */
 export const ConnectorCommandResultSchema = /*@__PURE__*/
-  messageDesc(file_kusinta_iot_connector_v1_connector, 9);
+  messageDesc(file_kusinta_iot_connector_v1_connector, 14);
 
 /**
  * Describes the message kusinta.iot.connector.v1.EnterPairingMode.
  * Use `create(EnterPairingModeSchema)` to create a new message.
  */
 export const EnterPairingModeSchema = /*@__PURE__*/
-  messageDesc(file_kusinta_iot_connector_v1_connector, 10);
+  messageDesc(file_kusinta_iot_connector_v1_connector, 15);
 
 /**
  * Describes the message kusinta.iot.connector.v1.PairingModeResult.
  * Use `create(PairingModeResultSchema)` to create a new message.
  */
 export const PairingModeResultSchema = /*@__PURE__*/
-  messageDesc(file_kusinta_iot_connector_v1_connector, 11);
+  messageDesc(file_kusinta_iot_connector_v1_connector, 16);
 
 /**
  * Describes the message kusinta.iot.connector.v1.PairingModeEnded.
  * Use `create(PairingModeEndedSchema)` to create a new message.
  */
 export const PairingModeEndedSchema = /*@__PURE__*/
-  messageDesc(file_kusinta_iot_connector_v1_connector, 12);
+  messageDesc(file_kusinta_iot_connector_v1_connector, 17);
 
 /**
  * Describes the message kusinta.iot.connector.v1.SessionRequest.
  * Use `create(SessionRequestSchema)` to create a new message.
  */
 export const SessionRequestSchema = /*@__PURE__*/
-  messageDesc(file_kusinta_iot_connector_v1_connector, 13);
+  messageDesc(file_kusinta_iot_connector_v1_connector, 18);
 
 /**
  * Describes the message kusinta.iot.connector.v1.SessionResponse.
  * Use `create(SessionResponseSchema)` to create a new message.
  */
 export const SessionResponseSchema = /*@__PURE__*/
-  messageDesc(file_kusinta_iot_connector_v1_connector, 14);
+  messageDesc(file_kusinta_iot_connector_v1_connector, 19);
 

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

@@ -7,6 +7,7 @@ import type { Message } from "@bufbuild/protobuf";
 import type { ConnectorId, DeviceId, SpaceId, UserId } from "../../identity/v1/identity_pb.js";
 import type { DeviceLifecycleState, DeviceOwnershipType } from "../../common/v1/types_pb.js";
 import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import type { LinkCapability } from "../../link/v1/link_pb.js";
 import type { HomematicDeviceIdentity } from "../../vendor/homematic/v1/homematic_pb.js";
 
 /**
@@ -126,6 +127,18 @@ export declare type DeviceDescriptor = Message<"kusinta.iot.device.v1.DeviceDesc
    */
   bridgedBy?: DeviceId | undefined;
 
+  /**
+   * What this device can be linked as, if anything — see link.v1.LinkCapability.
+   *
+   * Declared by the connector that models the device, because only it knows
+   * which of a device's connections can lead, which can follow, and what a hub
+   * will actually broker. Empty means "states nothing", never "cannot be
+   * linked": a connector that does not model linking says nothing here.
+   *
+   * @generated from field: repeated kusinta.iot.link.v1.LinkCapability link_capabilities = 20;
+   */
+  linkCapabilities: LinkCapability[];
+
   /**
    * @generated from oneof kusinta.iot.device.v1.DeviceDescriptor.vendor_identity
    */

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

@@ -6,13 +6,14 @@ import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv2";
 import { file_google_protobuf_timestamp } from "@bufbuild/protobuf/wkt";
 import { file_kusinta_iot_common_v1_types } from "../../common/v1/types_pb.js";
 import { file_kusinta_iot_identity_v1_identity } from "../../identity/v1/identity_pb.js";
+import { file_kusinta_iot_link_v1_link } from "../../link/v1/link_pb.js";
 import { file_kusinta_iot_vendor_homematic_v1_homematic } from "../../vendor/homematic/v1/homematic_pb.js";
 
 /**
  * Describes the file kusinta/iot/device/v1/descriptor.proto.
  */
 export const file_kusinta_iot_device_v1_descriptor = /*@__PURE__*/
-  fileDesc("CiZrdXNpbnRhL2lvdC9kZXZpY2UvdjEvZGVzY3JpcHRvci5wcm90bxIVa3VzaW50YS5pb3QuZGV2aWNlLnYxIrkGChBEZXZpY2VEZXNjcmlwdG9yEjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkEhMKC3ZlbmRvcl9uYW1lGAMgASgJEhQKDHByb2R1Y3RfbmFtZRgEIAEoCRIVCg1zZXJpYWxfbnVtYmVyGAUgASgJEhIKCm5vZGVfbGFiZWwYBiABKAkSEQoJdmVuZG9yX2lkGAcgASgNEhIKCnByb2R1Y3RfaWQYCCABKA0SHwoXaGFyZHdhcmVfdmVyc2lvbl9zdHJpbmcYCSABKAkSHwoXc29mdHdhcmVfdmVyc2lvbl9zdHJpbmcYCiABKAkSOgoMY29ubmVjdG9yX2lkGAsgASgLMiQua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuQ29ubmVjdG9ySWQSMgoIc3BhY2VfaWQYDCABKAsyIC5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5TcGFjZUlkEj0KCW93bmVyc2hpcBgNIAEoDjIqLmt1c2ludGEuaW90LmNvbW1vbi52MS5EZXZpY2VPd25lcnNoaXBUeXBlEj4KCWxpZmVjeWNsZRgOIAEoDjIrLmt1c2ludGEuaW90LmNvbW1vbi52MS5EZXZpY2VMaWZlY3ljbGVTdGF0ZRI2Cg1vd25lcl91c2VyX2lkGA8gASgLMh8ua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuVXNlcklkEi4KCmNsYWltZWRfYXQYECABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEjoKCmJyaWRnZWRfYnkYEyABKAsyIS5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5EZXZpY2VJZEgBiAEBEk0KCWhvbWVtYXRpYxgSIAEoCzI4Lmt1c2ludGEuaW90LnZlbmRvci5ob21lbWF0aWMudjEuSG9tZW1hdGljRGV2aWNlSWRlbnRpdHlIAEIRCg92ZW5kb3JfaWRlbnRpdHlCDQoLX2JyaWRnZWRfYnlKBAgCEANKBAgREBJSFW1hdHRlcl9kZXZpY2VfdHlwZV9pZFIJZW5kcG9pbnRzQgJIAWIGcHJvdG8z", [file_google_protobuf_timestamp, file_kusinta_iot_common_v1_types, file_kusinta_iot_identity_v1_identity, file_kusinta_iot_vendor_homematic_v1_homematic]);
+  fileDesc("CiZrdXNpbnRhL2lvdC9kZXZpY2UvdjEvZGVzY3JpcHRvci5wcm90bxIVa3VzaW50YS5pb3QuZGV2aWNlLnYxIvkGChBEZXZpY2VEZXNjcmlwdG9yEjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkEhMKC3ZlbmRvcl9uYW1lGAMgASgJEhQKDHByb2R1Y3RfbmFtZRgEIAEoCRIVCg1zZXJpYWxfbnVtYmVyGAUgASgJEhIKCm5vZGVfbGFiZWwYBiABKAkSEQoJdmVuZG9yX2lkGAcgASgNEhIKCnByb2R1Y3RfaWQYCCABKA0SHwoXaGFyZHdhcmVfdmVyc2lvbl9zdHJpbmcYCSABKAkSHwoXc29mdHdhcmVfdmVyc2lvbl9zdHJpbmcYCiABKAkSOgoMY29ubmVjdG9yX2lkGAsgASgLMiQua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuQ29ubmVjdG9ySWQSMgoIc3BhY2VfaWQYDCABKAsyIC5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5TcGFjZUlkEj0KCW93bmVyc2hpcBgNIAEoDjIqLmt1c2ludGEuaW90LmNvbW1vbi52MS5EZXZpY2VPd25lcnNoaXBUeXBlEj4KCWxpZmVjeWNsZRgOIAEoDjIrLmt1c2ludGEuaW90LmNvbW1vbi52MS5EZXZpY2VMaWZlY3ljbGVTdGF0ZRI2Cg1vd25lcl91c2VyX2lkGA8gASgLMh8ua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuVXNlcklkEi4KCmNsYWltZWRfYXQYECABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEjoKCmJyaWRnZWRfYnkYEyABKAsyIS5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5EZXZpY2VJZEgBiAEBEj4KEWxpbmtfY2FwYWJpbGl0aWVzGBQgAygLMiMua3VzaW50YS5pb3QubGluay52MS5MaW5rQ2FwYWJpbGl0eRJNCglob21lbWF0aWMYEiABKAsyOC5rdXNpbnRhLmlvdC52ZW5kb3IuaG9tZW1hdGljLnYxLkhvbWVtYXRpY0RldmljZUlkZW50aXR5SABCEQoPdmVuZG9yX2lkZW50aXR5Qg0KC19icmlkZ2VkX2J5SgQIAhADSgQIERASUhVtYXR0ZXJfZGV2aWNlX3R5cGVfaWRSCWVuZHBvaW50c0ICSAFiBnByb3RvMw", [file_google_protobuf_timestamp, file_kusinta_iot_common_v1_types, file_kusinta_iot_identity_v1_identity, file_kusinta_iot_link_v1_link, file_kusinta_iot_vendor_homematic_v1_homematic]);
 
 /**
  * Describes the message kusinta.iot.device.v1.DeviceDescriptor.

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

@@ -253,8 +253,11 @@ export declare type Device = Message<"kusinta.iot.device.v1.Device"> & {
   endpoints: Endpoint[];
 
   /**
-   * When the gateway last had evidence this device exists and is reachable — the
-   * most recent PropertyUpdate, announcement, or command result concerning it.
+   * When the gateway last had evidence this device itself — the
+   * most recent PropertyUpdate (wheter or not the property changed) or command
+   * result concerning it. Should not be advanced on a device announcement: a
+   * connector typically re-announces from its own device list, so a device with a
+   * flat battery would otherwise keep looking freshly seen.
    * Gateway-observed, not connector-reported: no message on either leg carries a
    * per-device liveness timestamp, so this is as precise as the device's own report
    * interval. A device that reports every 15 minutes looks stale for 15 minutes.