@kusinta/iot-schema 0.1.0-beta.9 → 0.2.0-beta.2

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

@@ -6,10 +6,11 @@ import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
 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 { DeviceDescriptor } from "../../device/v1/descriptor_pb.js";
+import type { Device } from "../../device/v1/device_pb.js";
 import type { Timestamp } from "@bufbuild/protobuf/wkt";
 import type { PropertyUpdateBatch } from "../../device/v1/property_update_pb.js";
-import type { DeviceCommand } from "../../webrtc/v1/command_pb.js";
+import type { DeviceEventBatch } from "../../device/v1/device_event_pb.js";
+import type { AttributeWriteRequest, DeviceCommand } from "../../webrtc/v1/command_pb.js";
 
 /**
  * Describes the file kusinta/iot/connector/v1/connector.proto.
@@ -69,9 +70,9 @@ export declare type ConnectorHandshake = Message<"kusinta.iot.connector.v1.Conne
   info?: ConnectorInfo | undefined;
 
   /**
-   * @generated from field: repeated kusinta.iot.device.v1.DeviceDescriptor known_devices = 2;
+   * @generated from field: repeated kusinta.iot.device.v1.Device known_devices = 2;
    */
-  knownDevices: DeviceDescriptor[];
+  knownDevices: Device[];
 };
 
 /**
@@ -107,13 +108,20 @@ export declare type HandshakeAck = Message<"kusinta.iot.connector.v1.HandshakeAc
 export declare const HandshakeAckSchema: GenMessage<HandshakeAck>;
 
 /**
+ * A device the connector has found. Carries the full Device, not just its descriptor,
+ * because a device's endpoints are what say which Matter device types it presents — and
+ * without them the gateway cannot resolve any PropertyUpdate the device goes on to send.
+ *
+ * Properties may be unset on every endpoint; that means the device exists and has
+ * reported nothing yet, which is the normal state at announcement.
+ *
  * @generated from message kusinta.iot.connector.v1.DeviceAnnouncement
  */
 export declare type DeviceAnnouncement = Message<"kusinta.iot.connector.v1.DeviceAnnouncement"> & {
   /**
-   * @generated from field: kusinta.iot.device.v1.DeviceDescriptor descriptor = 1;
+   * @generated from field: kusinta.iot.device.v1.Device device = 2;
    */
-  descriptor?: DeviceDescriptor | undefined;
+  device?: Device | undefined;
 };
 
 /**
@@ -202,11 +210,11 @@ export declare type GatewayError = Message<"kusinta.iot.connector.v1.GatewayErro
   message: string;
 
   /**
-   * non-empty if the error is in response to a command
+   * non-empty if the error answers a command or a write
    *
-   * @generated from field: string command_id = 3;
+   * @generated from field: string request_id = 3;
    */
-  commandId: string;
+  requestId: string;
 };
 
 /**
@@ -216,13 +224,20 @@ export declare type GatewayError = Message<"kusinta.iot.connector.v1.GatewayErro
 export declare const GatewayErrorSchema: GenMessage<GatewayError>;
 
 /**
- * @generated from message kusinta.iot.connector.v1.CommandResult
+ * A connector's answer to an executed command OR attribute write. One message for both:
+ * the two operations differ in what they do to a device, not in how a connector reports
+ * having done it, and request_id says which request this answers either way.
+ *
+ * @generated from message kusinta.iot.connector.v1.ConnectorCommandResult
  */
-export declare type CommandResult = Message<"kusinta.iot.connector.v1.CommandResult"> & {
+export declare type ConnectorCommandResult = Message<"kusinta.iot.connector.v1.ConnectorCommandResult"> & {
   /**
-   * @generated from field: string command_id = 1;
+   * Was command_id. Renamed with webrtc.v1.DeviceCommand.request_id, which it mirrors, and
+   * because it now correlates writes as well as commands.
+   *
+   * @generated from field: string request_id = 1;
    */
-  commandId: string;
+  requestId: string;
 
   /**
    * @generated from field: bool success = 2;
@@ -241,15 +256,15 @@ export declare type CommandResult = Message<"kusinta.iot.connector.v1.CommandRes
 };
 
 /**
- * Describes the message kusinta.iot.connector.v1.CommandResult.
- * Use `create(CommandResultSchema)` to create a new message.
+ * Describes the message kusinta.iot.connector.v1.ConnectorCommandResult.
+ * Use `create(ConnectorCommandResultSchema)` to create a new message.
  */
-export declare const CommandResultSchema: GenMessage<CommandResult>;
+export declare const ConnectorCommandResultSchema: GenMessage<ConnectorCommandResult>;
 
 /**
- * @generated from message kusinta.iot.connector.v1.ConnectRequest
+ * @generated from message kusinta.iot.connector.v1.SessionRequest
  */
-export declare type ConnectRequest = Message<"kusinta.iot.connector.v1.ConnectRequest"> & {
+export declare type SessionRequest = Message<"kusinta.iot.connector.v1.SessionRequest"> & {
   /**
    * @generated from field: string message_id = 1;
    */
@@ -261,7 +276,7 @@ export declare type ConnectRequest = Message<"kusinta.iot.connector.v1.ConnectRe
   sentAt?: Timestamp | undefined;
 
   /**
-   * @generated from oneof kusinta.iot.connector.v1.ConnectRequest.payload
+   * @generated from oneof kusinta.iot.connector.v1.SessionRequest.payload
    */
   payload: {
     /**
@@ -289,9 +304,9 @@ export declare type ConnectRequest = Message<"kusinta.iot.connector.v1.ConnectRe
     case: "deviceRemoved";
   } | {
     /**
-     * @generated from field: kusinta.iot.connector.v1.CommandResult command_result = 7;
+     * @generated from field: kusinta.iot.connector.v1.ConnectorCommandResult command_result = 7;
      */
-    value: CommandResult;
+    value: ConnectorCommandResult;
     case: "commandResult";
   } | {
     /**
@@ -299,19 +314,25 @@ export declare type ConnectRequest = Message<"kusinta.iot.connector.v1.ConnectRe
      */
     value: HeartBeat;
     case: "heartbeat";
+  } | {
+    /**
+     * @generated from field: kusinta.iot.device.v1.DeviceEventBatch device_events = 9;
+     */
+    value: DeviceEventBatch;
+    case: "deviceEvents";
   } | { case: undefined; value?: undefined };
 };
 
 /**
- * Describes the message kusinta.iot.connector.v1.ConnectRequest.
- * Use `create(ConnectRequestSchema)` to create a new message.
+ * Describes the message kusinta.iot.connector.v1.SessionRequest.
+ * Use `create(SessionRequestSchema)` to create a new message.
  */
-export declare const ConnectRequestSchema: GenMessage<ConnectRequest>;
+export declare const SessionRequestSchema: GenMessage<SessionRequest>;
 
 /**
- * @generated from message kusinta.iot.connector.v1.ConnectResponse
+ * @generated from message kusinta.iot.connector.v1.SessionResponse
  */
-export declare type ConnectResponse = Message<"kusinta.iot.connector.v1.ConnectResponse"> & {
+export declare type SessionResponse = Message<"kusinta.iot.connector.v1.SessionResponse"> & {
   /**
    * @generated from field: string message_id = 1;
    */
@@ -323,7 +344,7 @@ export declare type ConnectResponse = Message<"kusinta.iot.connector.v1.ConnectR
   sentAt?: Timestamp | undefined;
 
   /**
-   * @generated from oneof kusinta.iot.connector.v1.ConnectResponse.payload
+   * @generated from oneof kusinta.iot.connector.v1.SessionResponse.payload
    */
   payload: {
     /**
@@ -355,12 +376,21 @@ export declare type ConnectResponse = Message<"kusinta.iot.connector.v1.ConnectR
      */
     value: DeviceCommand;
     case: "executeCommand";
+  } | {
+    /**
+     * The connector-leg half of PERMISSION_ACTION_WRITE. A sibling case rather than another
+     * meaning overloaded onto execute_command, which is the mistake this replaces.
+     *
+     * @generated from field: kusinta.iot.webrtc.v1.AttributeWriteRequest execute_attribute_write = 9;
+     */
+    value: AttributeWriteRequest;
+    case: "executeAttributeWrite";
   } | { case: undefined; value?: undefined };
 };
 
 /**
- * Describes the message kusinta.iot.connector.v1.ConnectResponse.
- * Use `create(ConnectResponseSchema)` to create a new message.
+ * Describes the message kusinta.iot.connector.v1.SessionResponse.
+ * Use `create(SessionResponseSchema)` to create a new message.
  */
-export declare const ConnectResponseSchema: GenMessage<ConnectResponse>;
+export declare const SessionResponseSchema: GenMessage<SessionResponse>;
 

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

@@ -6,7 +6,8 @@ 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_device_v1_descriptor } from "../../device/v1/descriptor_pb.js";
+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_webrtc_v1_command } from "../../webrtc/v1/command_pb.js";
 
@@ -14,7 +15,7 @@ import { file_kusinta_iot_webrtc_v1_command } from "../../webrtc/v1/command_pb.j
  * Describes the file kusinta/iot/connector/v1/connector.proto.
  */
 export const file_kusinta_iot_connector_v1_connector = /*@__PURE__*/
-  fileDesc("CihrdXNpbnRhL2lvdC9jb25uZWN0b3IvdjEvY29ubmVjdG9yLnByb3RvEhhrdXNpbnRhLmlvdC5jb25uZWN0b3IudjEi5QEKDUNvbm5lY3RvckluZm8SOgoMY29ubmVjdG9yX2lkGAEgASgLMiQua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuQ29ubmVjdG9ySWQSFAoMZGlzcGxheV9uYW1lGAIgASgJEg8KB3ZlcnNpb24YAyABKAkSPAoJdHJhbnNwb3J0GAQgASgOMikua3VzaW50YS5pb3QuY29tbW9uLnYxLkNvbm5lY3RvclRyYW5zcG9ydBIQCghlbmRwb2ludBgFIAEoCRIhChlzdXBwb3J0ZWRfZGV2aWNlX3R5cGVfaWRzGAYgAygNIosBChJDb25uZWN0b3JIYW5kc2hha2USNQoEaW5mbxgBIAEoCzInLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5Db25uZWN0b3JJbmZvEj4KDWtub3duX2RldmljZXMYAiADKAsyJy5rdXNpbnRhLmlvdC5kZXZpY2UudjEuRGV2aWNlRGVzY3JpcHRvciJoCgxIYW5kc2hha2VBY2sSEAoIYWNjZXB0ZWQYASABKAgSDgoGcmVhc29uGAIgASgJEjYKCmdhdGV3YXlfaWQYAyABKAsyIi5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5HYXRld2F5SWQiUQoSRGV2aWNlQW5ub3VuY2VtZW50EjsKCmRlc2NyaXB0b3IYASABKAsyJy5rdXNpbnRhLmlvdC5kZXZpY2UudjEuRGV2aWNlRGVzY3JpcHRvciJVCg1EZXZpY2VSZW1vdmFsEjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkEg4KBnJlYXNvbhgCIAEoCSILCglIZWFydEJlYXQiRwoPU3Vic2NyaWJlRGV2aWNlEjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkIkkKEVVuc3Vic2NyaWJlRGV2aWNlEjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkIkEKDEdhdGV3YXlFcnJvchIMCgRjb2RlGAEgASgJEg8KB21lc3NhZ2UYAiABKAkSEgoKY29tbWFuZF9pZBgDIAEoCSKdAQoNQ29tbWFuZFJlc3VsdBISCgpjb21tYW5kX2lkGAEgASgJEg8KB3N1Y2Nlc3MYAiABKAgSNQoFZXJyb3IYAyABKAsyJi5rdXNpbnRhLmlvdC5jb25uZWN0b3IudjEuR2F0ZXdheUVycm9yEjAKDGNvbXBsZXRlZF9hdBgEIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXAi8AMKDkNvbm5lY3RSZXF1ZXN0EhIKCm1lc3NhZ2VfaWQYASABKAkSKwoHc2VudF9hdBgCIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASQQoJaGFuZHNoYWtlGAMgASgLMiwua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkNvbm5lY3RvckhhbmRzaGFrZUgAEkUKD3Byb3BlcnR5X3VwZGF0ZRgEIAEoCzIqLmt1c2ludGEuaW90LmRldmljZS52MS5Qcm9wZXJ0eVVwZGF0ZUJhdGNoSAASSAoQZGV2aWNlX2Fubm91bmNlZBgFIAEoCzIsLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5EZXZpY2VBbm5vdW5jZW1lbnRIABJBCg5kZXZpY2VfcmVtb3ZlZBgGIAEoCzInLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5EZXZpY2VSZW1vdmFsSAASQQoOY29tbWFuZF9yZXN1bHQYByABKAsyJy5rdXNpbnRhLmlvdC5jb25uZWN0b3IudjEuQ29tbWFuZFJlc3VsdEgAEjgKCWhlYXJ0YmVhdBgIIAEoCzIjLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5IZWFydEJlYXRIAEIJCgdwYXlsb2FkIqIDCg9Db25uZWN0UmVzcG9uc2USEgoKbWVzc2FnZV9pZBgBIAEoCRIrCgdzZW50X2F0GAIgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBI/Cg1oYW5kc2hha2VfYWNrGAMgASgLMiYua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkhhbmRzaGFrZUFja0gAEj4KCXN1YnNjcmliZRgFIAEoCzIpLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5TdWJzY3JpYmVEZXZpY2VIABJCCgt1bnN1YnNjcmliZRgGIAEoCzIrLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5VbnN1YnNjcmliZURldmljZUgAEjcKBWVycm9yGAcgASgLMiYua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkdhdGV3YXlFcnJvckgAEj8KD2V4ZWN1dGVfY29tbWFuZBgIIAEoCzIkLmt1c2ludGEuaW90LndlYnJ0Yy52MS5EZXZpY2VDb21tYW5kSABCCQoHcGF5bG9hZEoECAQQBUICSAFiBnByb3RvMw", [file_google_protobuf_timestamp, file_kusinta_iot_common_v1_types, file_kusinta_iot_identity_v1_identity, file_kusinta_iot_device_v1_descriptor, file_kusinta_iot_device_v1_property_update, file_kusinta_iot_webrtc_v1_command]);
+  fileDesc("CihrdXNpbnRhL2lvdC9jb25uZWN0b3IvdjEvY29ubmVjdG9yLnByb3RvEhhrdXNpbnRhLmlvdC5jb25uZWN0b3IudjEi5QEKDUNvbm5lY3RvckluZm8SOgoMY29ubmVjdG9yX2lkGAEgASgLMiQua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuQ29ubmVjdG9ySWQSFAoMZGlzcGxheV9uYW1lGAIgASgJEg8KB3ZlcnNpb24YAyABKAkSPAoJdHJhbnNwb3J0GAQgASgOMikua3VzaW50YS5pb3QuY29tbW9uLnYxLkNvbm5lY3RvclRyYW5zcG9ydBIQCghlbmRwb2ludBgFIAEoCRIhChlzdXBwb3J0ZWRfZGV2aWNlX3R5cGVfaWRzGAYgAygNIoEBChJDb25uZWN0b3JIYW5kc2hha2USNQoEaW5mbxgBIAEoCzInLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5Db25uZWN0b3JJbmZvEjQKDWtub3duX2RldmljZXMYAiADKAsyHS5rdXNpbnRhLmlvdC5kZXZpY2UudjEuRGV2aWNlImgKDEhhbmRzaGFrZUFjaxIQCghhY2NlcHRlZBgBIAEoCBIOCgZyZWFzb24YAiABKAkSNgoKZ2F0ZXdheV9pZBgDIAEoCzIiLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkdhdGV3YXlJZCJVChJEZXZpY2VBbm5vdW5jZW1lbnQSLQoGZGV2aWNlGAIgASgLMh0ua3VzaW50YS5pb3QuZGV2aWNlLnYxLkRldmljZUoECAEQAlIKZGVzY3JpcHRvciJVCg1EZXZpY2VSZW1vdmFsEjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkEg4KBnJlYXNvbhgCIAEoCSILCglIZWFydEJlYXQiRwoPU3Vic2NyaWJlRGV2aWNlEjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkIkkKEVVuc3Vic2NyaWJlRGV2aWNlEjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkIkEKDEdhdGV3YXlFcnJvchIMCgRjb2RlGAEgASgJEg8KB21lc3NhZ2UYAiABKAkSEgoKcmVxdWVzdF9pZBgDIAEoCSKmAQoWQ29ubmVjdG9yQ29tbWFuZFJlc3VsdBISCgpyZXF1ZXN0X2lkGAEgASgJEg8KB3N1Y2Nlc3MYAiABKAgSNQoFZXJyb3IYAyABKAsyJi5rdXNpbnRhLmlvdC5jb25uZWN0b3IudjEuR2F0ZXdheUVycm9yEjAKDGNvbXBsZXRlZF9hdBgEIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXAiuwQKDlNlc3Npb25SZXF1ZXN0EhIKCm1lc3NhZ2VfaWQYASABKAkSKwoHc2VudF9hdBgCIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASQQoJaGFuZHNoYWtlGAMgASgLMiwua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkNvbm5lY3RvckhhbmRzaGFrZUgAEkUKD3Byb3BlcnR5X3VwZGF0ZRgEIAEoCzIqLmt1c2ludGEuaW90LmRldmljZS52MS5Qcm9wZXJ0eVVwZGF0ZUJhdGNoSAASSAoQZGV2aWNlX2Fubm91bmNlZBgFIAEoCzIsLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5EZXZpY2VBbm5vdW5jZW1lbnRIABJBCg5kZXZpY2VfcmVtb3ZlZBgGIAEoCzInLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5EZXZpY2VSZW1vdmFsSAASSgoOY29tbWFuZF9yZXN1bHQYByABKAsyMC5rdXNpbnRhLmlvdC5jb25uZWN0b3IudjEuQ29ubmVjdG9yQ29tbWFuZFJlc3VsdEgAEjgKCWhlYXJ0YmVhdBgIIAEoCzIjLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5IZWFydEJlYXRIABJACg1kZXZpY2VfZXZlbnRzGAkgASgLMicua3VzaW50YS5pb3QuZGV2aWNlLnYxLkRldmljZUV2ZW50QmF0Y2hIAEIJCgdwYXlsb2FkIvMDCg9TZXNzaW9uUmVzcG9uc2USEgoKbWVzc2FnZV9pZBgBIAEoCRIrCgdzZW50X2F0GAIgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBI/Cg1oYW5kc2hha2VfYWNrGAMgASgLMiYua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkhhbmRzaGFrZUFja0gAEj4KCXN1YnNjcmliZRgFIAEoCzIpLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5TdWJzY3JpYmVEZXZpY2VIABJCCgt1bnN1YnNjcmliZRgGIAEoCzIrLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5VbnN1YnNjcmliZURldmljZUgAEjcKBWVycm9yGAcgASgLMiYua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkdhdGV3YXlFcnJvckgAEj8KD2V4ZWN1dGVfY29tbWFuZBgIIAEoCzIkLmt1c2ludGEuaW90LndlYnJ0Yy52MS5EZXZpY2VDb21tYW5kSAASTwoXZXhlY3V0ZV9hdHRyaWJ1dGVfd3JpdGUYCSABKAsyLC5rdXNpbnRhLmlvdC53ZWJydGMudjEuQXR0cmlidXRlV3JpdGVSZXF1ZXN0SABCCQoHcGF5bG9hZEoECAQQBUICSAFiBnByb3RvMw", [file_google_protobuf_timestamp, file_kusinta_iot_common_v1_types, file_kusinta_iot_identity_v1_identity, file_kusinta_iot_device_v1_device, file_kusinta_iot_device_v1_device_event, file_kusinta_iot_device_v1_property_update, file_kusinta_iot_webrtc_v1_command]);
 
 /**
  * Describes the message kusinta.iot.connector.v1.ConnectorInfo.
@@ -80,23 +81,23 @@ export const GatewayErrorSchema = /*@__PURE__*/
   messageDesc(file_kusinta_iot_connector_v1_connector, 8);
 
 /**
- * Describes the message kusinta.iot.connector.v1.CommandResult.
- * Use `create(CommandResultSchema)` to create a new message.
+ * Describes the message kusinta.iot.connector.v1.ConnectorCommandResult.
+ * Use `create(ConnectorCommandResultSchema)` to create a new message.
  */
-export const CommandResultSchema = /*@__PURE__*/
+export const ConnectorCommandResultSchema = /*@__PURE__*/
   messageDesc(file_kusinta_iot_connector_v1_connector, 9);
 
 /**
- * Describes the message kusinta.iot.connector.v1.ConnectRequest.
- * Use `create(ConnectRequestSchema)` to create a new message.
+ * Describes the message kusinta.iot.connector.v1.SessionRequest.
+ * Use `create(SessionRequestSchema)` to create a new message.
  */
-export const ConnectRequestSchema = /*@__PURE__*/
+export const SessionRequestSchema = /*@__PURE__*/
   messageDesc(file_kusinta_iot_connector_v1_connector, 10);
 
 /**
- * Describes the message kusinta.iot.connector.v1.ConnectResponse.
- * Use `create(ConnectResponseSchema)` to create a new message.
+ * Describes the message kusinta.iot.connector.v1.SessionResponse.
+ * Use `create(SessionResponseSchema)` to create a new message.
  */
-export const ConnectResponseSchema = /*@__PURE__*/
+export const SessionResponseSchema = /*@__PURE__*/
   messageDesc(file_kusinta_iot_connector_v1_connector, 11);
 

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

@@ -3,7 +3,7 @@
 /* eslint-disable */
 
 import type { GenFile, GenService } from "@bufbuild/protobuf/codegenv2";
-import type { ConnectRequestSchema, ConnectResponseSchema } from "./connector_pb.js";
+import type { SessionRequestSchema, SessionResponseSchema } from "./connector_pb.js";
 
 /**
  * Describes the file kusinta/iot/connector/v1/connector_service.proto.
@@ -18,12 +18,12 @@ export declare const file_kusinta_iot_connector_v1_connector_service: GenFile;
  */
 export declare const ConnectorGatewayService: GenService<{
   /**
-   * @generated from rpc kusinta.iot.connector.v1.ConnectorGatewayService.Connect
+   * @generated from rpc kusinta.iot.connector.v1.ConnectorGatewayService.Session
    */
-  connect: {
+  session: {
     methodKind: "bidi_streaming";
-    input: typeof ConnectRequestSchema;
-    output: typeof ConnectResponseSchema;
+    input: typeof SessionRequestSchema;
+    output: typeof SessionResponseSchema;
   },
 }>;
 

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

@@ -9,7 +9,7 @@ import { file_kusinta_iot_connector_v1_connector } from "./connector_pb.js";
  * Describes the file kusinta/iot/connector/v1/connector_service.proto.
  */
 export const file_kusinta_iot_connector_v1_connector_service = /*@__PURE__*/
-  fileDesc("CjBrdXNpbnRhL2lvdC9jb25uZWN0b3IvdjEvY29ubmVjdG9yX3NlcnZpY2UucHJvdG8SGGt1c2ludGEuaW90LmNvbm5lY3Rvci52MTJ9ChdDb25uZWN0b3JHYXRld2F5U2VydmljZRJiCgdDb25uZWN0Eigua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkNvbm5lY3RSZXF1ZXN0Gikua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkNvbm5lY3RSZXNwb25zZSgBMAFCAkgBYgZwcm90bzM", [file_kusinta_iot_connector_v1_connector]);
+  fileDesc("CjBrdXNpbnRhL2lvdC9jb25uZWN0b3IvdjEvY29ubmVjdG9yX3NlcnZpY2UucHJvdG8SGGt1c2ludGEuaW90LmNvbm5lY3Rvci52MTJ9ChdDb25uZWN0b3JHYXRld2F5U2VydmljZRJiCgdTZXNzaW9uEigua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLlNlc3Npb25SZXF1ZXN0Gikua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLlNlc3Npb25SZXNwb25zZSgBMAFCAkgBYgZwcm90bzM", [file_kusinta_iot_connector_v1_connector]);
 
 /**
  * ConnectorGatewayService: connector dials the gateway on startup.

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

@@ -0,0 +1,238 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file kusinta/iot/device/v1/cluster_state.proto (package kusinta.iot.device.v1, syntax proto3)
+/* eslint-disable */
+
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Message } from "@bufbuild/protobuf";
+
+/**
+ * Describes the file kusinta/iot/device/v1/cluster_state.proto.
+ */
+export declare const file_kusinta_iot_device_v1_cluster_state: GenFile;
+
+/**
+ * Matter null. Distinct from a field being absent: Matter types many attributes as
+ * nullable, where null is a reported value meaning "not currently known" — a thermostat
+ * that cannot read its local temperature reports null, which is not the same as never
+ * having reported at all.
+ *
+ * @generated from message kusinta.iot.device.v1.NullValue
+ */
+export declare type NullValue = Message<"kusinta.iot.device.v1.NullValue"> & {
+};
+
+/**
+ * Describes the message kusinta.iot.device.v1.NullValue.
+ * Use `create(NullValueSchema)` to create a new message.
+ */
+export declare const NullValueSchema: GenMessage<NullValue>;
+
+/**
+ * A Matter attribute value of any shape, including the ones a scalar cannot carry.
+ *
+ * Self-describing rather than Matter's own TLV as opaque bytes: an app that cannot decode
+ * a value cannot show it, and TLV would make the generic path useful only to the gateway.
+ * The cost is a recursive message; the benefit is that an attribute this schema has never
+ * heard of is still renderable.
+ *
+ * Widths are deliberately wider than most attributes need — sint64 covers every signed
+ * Matter integer type and uint64 every unsigned one, so a generic carrier never has to
+ * know an attribute's declared width to carry its value.
+ *
+ * @generated from message kusinta.iot.device.v1.AttributeValue
+ */
+export declare type AttributeValue = Message<"kusinta.iot.device.v1.AttributeValue"> & {
+  /**
+   * @generated from oneof kusinta.iot.device.v1.AttributeValue.value
+   */
+  value: {
+    /**
+     * @generated from field: bool bool_value = 1;
+     */
+    value: boolean;
+    case: "boolValue";
+  } | {
+    /**
+     * @generated from field: sint64 int_value = 2;
+     */
+    value: bigint;
+    case: "intValue";
+  } | {
+    /**
+     * @generated from field: uint64 uint_value = 3;
+     */
+    value: bigint;
+    case: "uintValue";
+  } | {
+    /**
+     * @generated from field: double double_value = 4;
+     */
+    value: number;
+    case: "doubleValue";
+  } | {
+    /**
+     * @generated from field: string string_value = 5;
+     */
+    value: string;
+    case: "stringValue";
+  } | {
+    /**
+     * @generated from field: bytes bytes_value = 6;
+     */
+    value: Uint8Array;
+    case: "bytesValue";
+  } | {
+    /**
+     * @generated from field: kusinta.iot.device.v1.AttributeValueList list_value = 7;
+     */
+    value: AttributeValueList;
+    case: "listValue";
+  } | {
+    /**
+     * @generated from field: kusinta.iot.device.v1.AttributeValueStruct struct_value = 8;
+     */
+    value: AttributeValueStruct;
+    case: "structValue";
+  } | {
+    /**
+     * @generated from field: kusinta.iot.device.v1.NullValue null_value = 9;
+     */
+    value: NullValue;
+    case: "nullValue";
+  } | { case: undefined; value?: undefined };
+};
+
+/**
+ * Describes the message kusinta.iot.device.v1.AttributeValue.
+ * Use `create(AttributeValueSchema)` to create a new message.
+ */
+export declare const AttributeValueSchema: GenMessage<AttributeValue>;
+
+/**
+ * @generated from message kusinta.iot.device.v1.AttributeValueList
+ */
+export declare type AttributeValueList = Message<"kusinta.iot.device.v1.AttributeValueList"> & {
+  /**
+   * @generated from field: repeated kusinta.iot.device.v1.AttributeValue values = 1;
+   */
+  values: AttributeValue[];
+};
+
+/**
+ * Describes the message kusinta.iot.device.v1.AttributeValueList.
+ * Use `create(AttributeValueListSchema)` to create a new message.
+ */
+export declare const AttributeValueListSchema: GenMessage<AttributeValueList>;
+
+/**
+ * Matter struct fields are addressed by numeric context tag, not by name, so the map is
+ * keyed by tag. A consumer that knows the struct's definition reads the tags it wants; one
+ * that does not can still carry and re-emit the whole thing.
+ *
+ * @generated from message kusinta.iot.device.v1.AttributeValueStruct
+ */
+export declare type AttributeValueStruct = Message<"kusinta.iot.device.v1.AttributeValueStruct"> & {
+  /**
+   * @generated from field: map<uint32, kusinta.iot.device.v1.AttributeValue> fields = 1;
+   */
+  fields: { [key: number]: AttributeValue };
+};
+
+/**
+ * Describes the message kusinta.iot.device.v1.AttributeValueStruct.
+ * Use `create(AttributeValueStructSchema)` to create a new message.
+ */
+export declare const AttributeValueStructSchema: GenMessage<AttributeValueStruct>;
+
+/**
+ * @generated from message kusinta.iot.device.v1.AttributeState
+ */
+export declare type AttributeState = Message<"kusinta.iot.device.v1.AttributeState"> & {
+  /**
+   * @generated from field: uint32 attribute_id = 1;
+   */
+  attributeId: number;
+
+  /**
+   * @generated from field: kusinta.iot.device.v1.AttributeValue value = 2;
+   */
+  value?: AttributeValue | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.device.v1.AttributeState.
+ * Use `create(AttributeStateSchema)` to create a new message.
+ */
+export declare const AttributeStateSchema: GenMessage<AttributeState>;
+
+/**
+ * One cluster hosted by an endpoint: what it is, what it supports, and any attribute value
+ * that has no typed home.
+ *
+ * An entry exists for EVERY cluster the endpoint hosts, including clusters this schema
+ * models with a typed properties message. That is not a contradiction of the
+ * one-value-one-place rule below — cluster_revision, feature_map and
+ * accepted_command_ids describe the cluster itself and have nowhere else to live.
+ *
+ * attributes is where the rule applies: it holds ONLY the attribute values that no typed
+ * field covers. An attribute the schema models is carried in its typed field and MUST NOT
+ * be repeated here — a value that exists in two places is a value that can disagree with
+ * itself.
+ *
+ * This is what lets an endpoint report something useful when its device type is not
+ * modelled, or when it carries a cluster beyond its device type's set, which the Matter
+ * specification explicitly permits.
+ *
+ * @generated from message kusinta.iot.device.v1.ClusterState
+ */
+export declare type ClusterState = Message<"kusinta.iot.device.v1.ClusterState"> & {
+  /**
+   * @generated from field: uint32 cluster_id = 1;
+   */
+  clusterId: number;
+
+  /**
+   * Matter's ClusterRevision. Which revision of the cluster definition the device
+   * implements.
+   *
+   * @generated from field: optional uint32 cluster_revision = 2;
+   */
+  clusterRevision?: number | undefined;
+
+  /**
+   * Matter's FeatureMap: a bitmap of the optional features this cluster supports on this
+   * endpoint.
+   *
+   * Worth carrying even for fully-modelled clusters, because it resolves an ambiguity the
+   * presence rule cannot. properties.proto says an absent field means "never reported" —
+   * but without a FeatureMap, absent is also what an attribute the device does not
+   * implement looks like. With it, a consumer can tell "not supported" from "not yet
+   * seen".
+   *
+   * @generated from field: optional uint32 feature_map = 3;
+   */
+  featureMap?: number | undefined;
+
+  /**
+   * Attribute values with no typed field. See the message comment.
+   *
+   * @generated from field: repeated kusinta.iot.device.v1.AttributeState attributes = 4;
+   */
+  attributes: AttributeState[];
+
+  /**
+   * Matter's AcceptedCommandList: which commands this cluster accepts on this endpoint.
+   * Without it a consumer must infer a device's capabilities from its device type and
+   * discover the truth by sending a command and watching it fail.
+   *
+   * @generated from field: repeated uint32 accepted_command_ids = 5;
+   */
+  acceptedCommandIds: number[];
+};
+
+/**
+ * Describes the message kusinta.iot.device.v1.ClusterState.
+ * Use `create(ClusterStateSchema)` to create a new message.
+ */
+export declare const ClusterStateSchema: GenMessage<ClusterState>;
+

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

@@ -0,0 +1,54 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file kusinta/iot/device/v1/cluster_state.proto (package kusinta.iot.device.v1, syntax proto3)
+/* eslint-disable */
+
+import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv2";
+
+/**
+ * Describes the file kusinta/iot/device/v1/cluster_state.proto.
+ */
+export const file_kusinta_iot_device_v1_cluster_state = /*@__PURE__*/
+  fileDesc("CilrdXNpbnRhL2lvdC9kZXZpY2UvdjEvY2x1c3Rlcl9zdGF0ZS5wcm90bxIVa3VzaW50YS5pb3QuZGV2aWNlLnYxIgsKCU51bGxWYWx1ZSLfAgoOQXR0cmlidXRlVmFsdWUSFAoKYm9vbF92YWx1ZRgBIAEoCEgAEhMKCWludF92YWx1ZRgCIAEoEkgAEhQKCnVpbnRfdmFsdWUYAyABKARIABIWCgxkb3VibGVfdmFsdWUYBCABKAFIABIWCgxzdHJpbmdfdmFsdWUYBSABKAlIABIVCgtieXRlc192YWx1ZRgGIAEoDEgAEj8KCmxpc3RfdmFsdWUYByABKAsyKS5rdXNpbnRhLmlvdC5kZXZpY2UudjEuQXR0cmlidXRlVmFsdWVMaXN0SAASQwoMc3RydWN0X3ZhbHVlGAggASgLMisua3VzaW50YS5pb3QuZGV2aWNlLnYxLkF0dHJpYnV0ZVZhbHVlU3RydWN0SAASNgoKbnVsbF92YWx1ZRgJIAEoCzIgLmt1c2ludGEuaW90LmRldmljZS52MS5OdWxsVmFsdWVIAEIHCgV2YWx1ZSJLChJBdHRyaWJ1dGVWYWx1ZUxpc3QSNQoGdmFsdWVzGAEgAygLMiUua3VzaW50YS5pb3QuZGV2aWNlLnYxLkF0dHJpYnV0ZVZhbHVlIrUBChRBdHRyaWJ1dGVWYWx1ZVN0cnVjdBJHCgZmaWVsZHMYASADKAsyNy5rdXNpbnRhLmlvdC5kZXZpY2UudjEuQXR0cmlidXRlVmFsdWVTdHJ1Y3QuRmllbGRzRW50cnkaVAoLRmllbGRzRW50cnkSCwoDa2V5GAEgASgNEjQKBXZhbHVlGAIgASgLMiUua3VzaW50YS5pb3QuZGV2aWNlLnYxLkF0dHJpYnV0ZVZhbHVlOgI4ASJcCg5BdHRyaWJ1dGVTdGF0ZRIUCgxhdHRyaWJ1dGVfaWQYASABKA0SNAoFdmFsdWUYAiABKAsyJS5rdXNpbnRhLmlvdC5kZXZpY2UudjEuQXR0cmlidXRlVmFsdWUi2QEKDENsdXN0ZXJTdGF0ZRISCgpjbHVzdGVyX2lkGAEgASgNEh0KEGNsdXN0ZXJfcmV2aXNpb24YAiABKA1IAIgBARIYCgtmZWF0dXJlX21hcBgDIAEoDUgBiAEBEjkKCmF0dHJpYnV0ZXMYBCADKAsyJS5rdXNpbnRhLmlvdC5kZXZpY2UudjEuQXR0cmlidXRlU3RhdGUSHAoUYWNjZXB0ZWRfY29tbWFuZF9pZHMYBSADKA1CEwoRX2NsdXN0ZXJfcmV2aXNpb25CDgoMX2ZlYXR1cmVfbWFwQgJIAWIGcHJvdG8z");
+
+/**
+ * Describes the message kusinta.iot.device.v1.NullValue.
+ * Use `create(NullValueSchema)` to create a new message.
+ */
+export const NullValueSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_device_v1_cluster_state, 0);
+
+/**
+ * Describes the message kusinta.iot.device.v1.AttributeValue.
+ * Use `create(AttributeValueSchema)` to create a new message.
+ */
+export const AttributeValueSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_device_v1_cluster_state, 1);
+
+/**
+ * Describes the message kusinta.iot.device.v1.AttributeValueList.
+ * Use `create(AttributeValueListSchema)` to create a new message.
+ */
+export const AttributeValueListSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_device_v1_cluster_state, 2);
+
+/**
+ * Describes the message kusinta.iot.device.v1.AttributeValueStruct.
+ * Use `create(AttributeValueStructSchema)` to create a new message.
+ */
+export const AttributeValueStructSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_device_v1_cluster_state, 3);
+
+/**
+ * Describes the message kusinta.iot.device.v1.AttributeState.
+ * Use `create(AttributeStateSchema)` to create a new message.
+ */
+export const AttributeStateSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_device_v1_cluster_state, 4);
+
+/**
+ * Describes the message kusinta.iot.device.v1.ClusterState.
+ * Use `create(ClusterStateSchema)` to create a new message.
+ */
+export const ClusterStateSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_device_v1_cluster_state, 5);
+

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 { HomematicDeviceIdentity } from "../../vendor/homematic/v1/homematic_pb.js";
 
 /**
  * Describes the file kusinta/iot/device/v1/descriptor.proto.
@@ -14,7 +15,10 @@ import type { Timestamp } from "@bufbuild/protobuf/wkt";
 export declare const file_kusinta_iot_device_v1_descriptor: GenFile;
 
 /**
- * DeviceDescriptor holds identity and Matter BasicInformation cluster fields.
+ * DeviceDescriptor holds identity and Matter BasicInformation cluster fields — what the
+ * device IS, not what it reports. The device types it presents are one per endpoint, in
+ * Device.endpoints.
+ *
  * Fields 1-19 are stable Matter-aligned fields. Fields 20+ are ownership/lifecycle.
  *
  * @generated from message kusinta.iot.device.v1.DeviceDescriptor
@@ -25,13 +29,6 @@ export declare type DeviceDescriptor = Message<"kusinta.iot.device.v1.DeviceDesc
    */
   deviceId?: DeviceId | undefined;
 
-  /**
-   * Matter 1.5.1 device type ID (e.g. 0x0301 = Thermostat, 0x0302 = TemperatureSensor)
-   *
-   * @generated from field: uint32 matter_device_type_id = 2;
-   */
-  matterDeviceTypeId: number;
-
   /**
    * Matter BasicInformation cluster attributes
    *
@@ -105,6 +102,38 @@ export declare type DeviceDescriptor = Message<"kusinta.iot.device.v1.DeviceDesc
    * @generated from field: google.protobuf.Timestamp claimed_at = 16;
    */
   claimedAt?: Timestamp | undefined;
+
+  /**
+   * Who the device is in its vendor's own terms — an address and a model string that
+   * identify the PHYSICAL device, not one of its endpoints. It belongs here rather than
+   * beside the per-endpoint vendor readings, which would duplicate it onto every
+   * endpoint with no rule saying whether a producer should.
+   *
+   * Absent for a device with no vendor extension, which is most of them.
+   * Set when this device sits behind a Matter bridge, naming the bridge's own Device.
+   *
+   * A bridge is one Matter node exposing many devices, and each gets its own DeviceId here
+   * rather than becoming an endpoint of the bridge: a user perceives twelve bridged bulbs
+   * as twelve things, and one row that cannot be placed in twelve rooms is not usable.
+   *
+   * 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.
+   *
+   * @generated from field: optional kusinta.iot.identity.v1.DeviceId bridged_by = 19;
+   */
+  bridgedBy?: DeviceId | undefined;
+
+  /**
+   * @generated from oneof kusinta.iot.device.v1.DeviceDescriptor.vendor_identity
+   */
+  vendorIdentity: {
+    /**
+     * @generated from field: kusinta.iot.vendor.homematic.v1.HomematicDeviceIdentity homematic = 18;
+     */
+    value: HomematicDeviceIdentity;
+    case: "homematic";
+  } | { case: undefined; value?: undefined };
 };
 
 /**