@kusinta/iot-schema 0.2.0-beta.5 → 0.2.0-beta.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kusinta/iot-schema",
-  "version": "0.2.0-beta.5",
+  "version": "0.2.0-beta.8",
   "type": "module",
   "license": "MIT",
   "files": ["src"],
@@ -10,6 +10,7 @@
   },
   "exports": {
     "./common":                 "./src/kusinta/iot/common/v1/types_pb.js",
+    "./common/pairing":         "./src/kusinta/iot/common/v1/pairing_pb.js",
     "./identity":               "./src/kusinta/iot/identity/v1/identity_pb.js",
     "./device":                 "./src/kusinta/iot/device/v1/device_pb.js",
     "./device/descriptor":      "./src/kusinta/iot/device/v1/descriptor_pb.js",
@@ -23,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

@@ -0,0 +1,201 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file kusinta/iot/common/v1/pairing.proto (package kusinta.iot.common.v1, syntax proto3)
+/* eslint-disable */
+
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Message } from "@bufbuild/protobuf";
+
+/**
+ * Describes the file kusinta/iot/common/v1/pairing.proto.
+ */
+export declare const file_kusinta_iot_common_v1_pairing: GenFile;
+
+/**
+ * A pairing failure and what can be said about it, the pairing counterpart of CommandError.
+ *
+ * The message matters more here than elsewhere: DEVICE_UNUSABLE is the code a user is most
+ * likely to see and least able to act on, and naming the device that joined is the whole
+ * difference between "something went wrong" and "this hub does not support that model yet".
+ *
+ * @generated from message kusinta.iot.common.v1.PairingErrorDetail
+ */
+export declare type PairingErrorDetail = Message<"kusinta.iot.common.v1.PairingErrorDetail"> & {
+  /**
+   * @generated from field: kusinta.iot.common.v1.PairingError code = 1;
+   */
+  code: PairingError;
+
+  /**
+   * human-readable; may name the device, its model, or the fault
+   *
+   * @generated from field: string message = 2;
+   */
+  message: string;
+};
+
+/**
+ * Describes the message kusinta.iot.common.v1.PairingErrorDetail.
+ * Use `create(PairingErrorDetailSchema)` to create a new message.
+ */
+export declare const PairingErrorDetailSchema: GenMessage<PairingErrorDetail>;
+
+/**
+ * How long a hub accepts new devices, and which it will take.
+ *
+ * One message on both legs rather than the same three fields declared twice: the clamp rule
+ * and the meaning of a hint are the sort of thing that is written once and then diverges,
+ * and the two copies had already begun to.
+ *
+ * @generated from message kusinta.iot.common.v1.PairingWindow
+ */
+export declare type PairingWindow = Message<"kusinta.iot.common.v1.PairingWindow"> & {
+  /**
+   * How long to accept arrivals. Whoever forwards this clamps it, and so does whoever acts
+   * on it: a window is an interval during which anything nearby can join, so its length is a
+   * security parameter rather than purely the caller's to choose.
+   *
+   * Absent means "no preference, use the default" — distinct from a caller asking for zero.
+   *
+   * @generated from field: optional uint32 duration_seconds = 1;
+   */
+  durationSeconds?: number | undefined;
+
+  /**
+   * The identifier printed on the device being paired, where the technology has one that is
+   * legible and the person is holding it. Free-form: what is printed differs per technology,
+   * and nothing between the app and the hub interprets it.
+   *
+   * Setting it changes the mechanism, not just the accuracy. The hub is restricted to that
+   * device and the arrival is verified against this value, so an arrival is attributed on
+   * identity. Leaving it empty opens the window to anything nearby, and attribution falls
+   * back to the arrival being the only one — which is why one window may be open at a time.
+   *
+   * Verification is not optional where this is set. A restriction can silently fail to take,
+   * and an arrival attributed on a restriction that did not hold is the wrong device in
+   * someone's home.
+   *
+   * @generated from field: string device_hint = 2;
+   */
+  deviceHint: string;
+
+  /**
+   * How many arrivals this one window may attribute. Absent means one.
+   *
+   * A batch suits commissioning, where devices are paired in a row and become a building's
+   * rather than any person's. It does not suit a caller whose pairing mints personal
+   * ownership.
+   *
+   * 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;
+   */
+  maxDevices?: number | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.common.v1.PairingWindow.
+ * Use `create(PairingWindowSchema)` to create a new message.
+ */
+export declare const PairingWindowSchema: GenMessage<PairingWindow>;
+
+/**
+ * Why a pairing attempt did not produce a device, in one vocabulary both the app and a
+ * connector speak.
+ *
+ * Shared rather than mirrored, for the reason CommandError's comment gives: mirrored enums
+ * leave every connector inventing its own spellings and something in the middle keeping a
+ * translation table that silently falls behind. A connector produces the subset it can
+ * observe; the gateway produces the rest and passes a connector's value through unchanged.
+ *
+ * Every value answers one question: *what should the client do now?* A code that does not
+ * change the answer does not need to exist, which is why "the device is on the hub and
+ * unusable" is one value and not two.
+ *
+ * @generated from enum kusinta.iot.common.v1.PairingError
+ */
+export enum PairingError {
+  /**
+   * Sender set no code, or sent one this client's schema does not know.
+   *
+   * This must stay the safe reading. A client decodes every value added after its build as
+   * UNSPECIFIED, so the sensible handling is "it did not work, offering a retry is
+   * reasonable" — and no value below is so dangerous that reading it this way misleads.
+   *
+   * @generated from enum value: PAIRING_ERROR_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * The caller may not pair here. Permanent for this caller: stop, and say so.
+   *
+   * @generated from enum value: PAIRING_ERROR_NOT_ENTITLED = 1;
+   */
+  NOT_ENTITLED = 1,
+
+  /**
+   * A pairing window is already open, and only one may be. Retrying after it closes is the
+   * right response; retrying at once is not.
+   *
+   * The exclusivity is not incidental. Where a request names no device, the only thing
+   * attributing an arrival to a requester is that theirs was the one window open.
+   *
+   * @generated from enum value: PAIRING_ERROR_ALREADY_IN_PROGRESS = 2;
+   */
+  ALREADY_IN_PROGRESS = 2,
+
+  /**
+   * The connector could not be reached, or refused to open its window. Transient.
+   *
+   * @generated from enum value: PAIRING_ERROR_CONNECTOR_UNAVAILABLE = 3;
+   */
+  CONNECTOR_UNAVAILABLE = 3,
+
+  /**
+   * The window closed with nothing paired: no device was put into pairing mode, or it was
+   * out of range, or its batteries are flat. The ordinary outcome of a user who walked away,
+   * so the useful response is to say what to do and offer another go, not to report a fault.
+   *
+   * @generated from enum value: PAIRING_ERROR_NO_DEVICE_APPEARED = 4;
+   */
+  NO_DEVICE_APPEARED = 4,
+
+  /**
+   * A device joined the hub and cannot be presented — the connector has no model for it, or
+   * could not assemble a complete description of it.
+   *
+   * One value rather than two, because the client does the same thing either way: stop, do
+   * not retry, and tell the user there is now an unusable device on their hub. Which of the
+   * two it was belongs in PairingErrorDetail.message, where it can name the device.
+   *
+   * It stays joined deliberately. A later connector release that models it adopts it with
+   * nobody returning to the hardware, where removing it would need someone standing there.
+   *
+   * @generated from enum value: PAIRING_ERROR_DEVICE_UNUSABLE = 5;
+   */
+  DEVICE_UNUSABLE = 5,
+
+  /**
+   * A device joined that is not the one the request named. The connector checked the arrival
+   * against the identifier it was given and they did not match, so it was not attributed.
+   *
+   * @generated from enum value: PAIRING_ERROR_WRONG_DEVICE = 6;
+   */
+  WRONG_DEVICE = 6,
+
+  /**
+   * A fault on the gateway's or the connector's own side. Not the caller's doing.
+   *
+   * @generated from enum value: PAIRING_ERROR_INTERNAL = 7;
+   */
+  INTERNAL = 7,
+}
+
+/**
+ * Describes the enum kusinta.iot.common.v1.PairingError.
+ */
+export declare const PairingErrorSchema: GenEnum<PairingError>;
+

package/src/kusinta/iot/common/v1/pairing_pb.js

@@ -0,0 +1,50 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file kusinta/iot/common/v1/pairing.proto (package kusinta.iot.common.v1, syntax proto3)
+/* eslint-disable */
+
+import { enumDesc, fileDesc, messageDesc, tsEnum } from "@bufbuild/protobuf/codegenv2";
+
+/**
+ * Describes the file kusinta/iot/common/v1/pairing.proto.
+ */
+export const file_kusinta_iot_common_v1_pairing = /*@__PURE__*/
+  fileDesc("CiNrdXNpbnRhL2lvdC9jb21tb24vdjEvcGFpcmluZy5wcm90bxIVa3VzaW50YS5pb3QuY29tbW9uLnYxIlgKElBhaXJpbmdFcnJvckRldGFpbBIxCgRjb2RlGAEgASgOMiMua3VzaW50YS5pb3QuY29tbW9uLnYxLlBhaXJpbmdFcnJvchIPCgdtZXNzYWdlGAIgASgJIoIBCg1QYWlyaW5nV2luZG93Eh0KEGR1cmF0aW9uX3NlY29uZHMYASABKA1IAIgBARITCgtkZXZpY2VfaGludBgCIAEoCRIYCgttYXhfZGV2aWNlcxgDIAEoDUgBiAEBQhMKEV9kdXJhdGlvbl9zZWNvbmRzQg4KDF9tYXhfZGV2aWNlcyqiAgoMUGFpcmluZ0Vycm9yEh0KGVBBSVJJTkdfRVJST1JfVU5TUEVDSUZJRUQQABIeChpQQUlSSU5HX0VSUk9SX05PVF9FTlRJVExFRBABEiUKIVBBSVJJTkdfRVJST1JfQUxSRUFEWV9JTl9QUk9HUkVTUxACEicKI1BBSVJJTkdfRVJST1JfQ09OTkVDVE9SX1VOQVZBSUxBQkxFEAMSJAogUEFJUklOR19FUlJPUl9OT19ERVZJQ0VfQVBQRUFSRUQQBBIhCh1QQUlSSU5HX0VSUk9SX0RFVklDRV9VTlVTQUJMRRAFEh4KGlBBSVJJTkdfRVJST1JfV1JPTkdfREVWSUNFEAYSGgoWUEFJUklOR19FUlJPUl9JTlRFUk5BTBAHQgJIAWIGcHJvdG8z");
+
+/**
+ * Describes the message kusinta.iot.common.v1.PairingErrorDetail.
+ * Use `create(PairingErrorDetailSchema)` to create a new message.
+ */
+export const PairingErrorDetailSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_common_v1_pairing, 0);
+
+/**
+ * Describes the message kusinta.iot.common.v1.PairingWindow.
+ * Use `create(PairingWindowSchema)` to create a new message.
+ */
+export const PairingWindowSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_common_v1_pairing, 1);
+
+/**
+ * Describes the enum kusinta.iot.common.v1.PairingError.
+ */
+export const PairingErrorSchema = /*@__PURE__*/
+  enumDesc(file_kusinta_iot_common_v1_pairing, 0);
+
+/**
+ * Why a pairing attempt did not produce a device, in one vocabulary both the app and a
+ * connector speak.
+ *
+ * Shared rather than mirrored, for the reason CommandError's comment gives: mirrored enums
+ * leave every connector inventing its own spellings and something in the middle keeping a
+ * translation table that silently falls behind. A connector produces the subset it can
+ * observe; the gateway produces the rest and passes a connector's value through unchanged.
+ *
+ * Every value answers one question: *what should the client do now?* A code that does not
+ * change the answer does not need to exist, which is why "the device is on the hub and
+ * unusable" is one value and not two.
+ *
+ * @generated from enum kusinta.iot.common.v1.PairingError
+ */
+export const PairingError = /*@__PURE__*/
+  tsEnum(PairingErrorSchema);
+

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

@@ -7,8 +7,10 @@ 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";
 import type { PropertyUpdateBatch } from "../../device/v1/property_update_pb.js";
 import type { DeviceEventBatch } from "../../device/v1/device_event_pb.js";
 
@@ -73,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[];
 };
 
 /**
@@ -81,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
  */
@@ -122,6 +297,25 @@ export declare type DeviceAnnouncement = Message<"kusinta.iot.connector.v1.Devic
    * @generated from field: kusinta.iot.device.v1.Device device = 2;
    */
   device?: Device | undefined;
+
+  /**
+   * The pairing request this device arrived for, empty for a device that arrived on its own.
+   *
+   * This field is the whole attribution mechanism. A connector is the only party that knows
+   * when its own hub was accepting devices, so it decides whether an arrival belongs to a
+   * request and says so here.
+   *
+   * Set it only when the arrival was actually checked. An arrival that fails the check is
+   * still announced — the device exists and has joined — but with this empty, which files it
+   * as belonging to nobody rather than to the wrong person.
+   *
+   * This is EnterPairingMode.request_id, minted per connector, and NOT an app message id:
+   * whoever forwards the outcome to the app has to map it back. The name avoids `in_reply_to`
+   * for that reason, which everywhere else in this schema means the app's own message id.
+   *
+   * @generated from field: string pairing_request_id = 3;
+   */
+  pairingRequestId: string;
 };
 
 /**
@@ -309,6 +503,127 @@ export declare type ConnectorCommandResult = Message<"kusinta.iot.connector.v1.C
  */
 export declare const ConnectorCommandResultSchema: GenMessage<ConnectorCommandResult>;
 
+/**
+ * Tells a connector to accept new devices for a while, gateway → connector.
+ *
+ * Named for what the connector does rather than for what the app asked. The two legs are
+ * named differently on purpose: the app starts one pairing, and the gateway may put several
+ * connectors into pairing mode to serve it.
+ *
+ * @generated from message kusinta.iot.connector.v1.EnterPairingMode
+ */
+export declare type EnterPairingMode = Message<"kusinta.iot.connector.v1.EnterPairingMode"> & {
+  /**
+   * echoed on PairingModeResult, PairingModeEnded and the announcement
+   *
+   * @generated from field: string request_id = 1;
+   */
+  requestId: string;
+
+  /**
+   * How long, which device, how many. See PairingWindow — and clamp the duration again here.
+   * A connector is the last thing standing between a number on the wire and a radio that
+   * accepts anything nearby for that long.
+   *
+   * @generated from field: kusinta.iot.common.v1.PairingWindow window = 2;
+   */
+  window?: PairingWindow | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.connector.v1.EnterPairingMode.
+ * Use `create(EnterPairingModeSchema)` to create a new message.
+ */
+export declare const EnterPairingModeSchema: GenMessage<EnterPairingMode>;
+
+/**
+ * A connector's answer to EnterPairingMode: whether the window opened, and nothing more.
+ *
+ * The same accept-now-report-later split as ConnectorCommandResult, for the same reason — a
+ * connector that waited for a device to wake before answering would blow every deadline
+ * above it. What the window produced arrives later, as PairingModeEnded.
+ *
+ * @generated from message kusinta.iot.connector.v1.PairingModeResult
+ */
+export declare type PairingModeResult = Message<"kusinta.iot.connector.v1.PairingModeResult"> & {
+  /**
+   * @generated from field: string request_id = 1;
+   */
+  requestId: string;
+
+  /**
+   * @generated from field: bool accepted = 2;
+   */
+  accepted: boolean;
+
+  /**
+   * Why the window did not open. Only what a connector can observe at this point:
+   * CONNECTOR_UNAVAILABLE, INTERNAL. NOT_ENTITLED and ALREADY_IN_PROGRESS are the gateway's,
+   * decided before this message is sent, and a connector must not claim them.
+   *
+   * @generated from field: kusinta.iot.common.v1.PairingErrorDetail error = 3;
+   */
+  error?: PairingErrorDetail | undefined;
+
+  /**
+   * When the window closes, if it opened. Lets the gateway expire its own record against the
+   * connector's clock rather than a guess — the connector is the party that clamped it.
+   *
+   * @generated from field: google.protobuf.Timestamp expires_at = 4;
+   */
+  expiresAt?: Timestamp | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.connector.v1.PairingModeResult.
+ * Use `create(PairingModeResultSchema)` to create a new message.
+ */
+export declare const PairingModeResultSchema: GenMessage<PairingModeResult>;
+
+/**
+ * What the window produced, connector → gateway, sent once when it closes.
+ *
+ * Without this the connector has no way to report anything it learned after the window
+ * opened: a device that joined and cannot be modelled, or one that joined and was not the
+ * device the hint named. Neither can travel on a DeviceAnnouncement — the first has nothing
+ * announceable, and the second is announced but unattributed, which says a device arrived
+ * and not why it was refused.
+ *
+ * It also gives a batch window a definite end. Counting announcements cannot distinguish
+ * "three of five so far" from "three of five, and that is all".
+ *
+ * @generated from message kusinta.iot.connector.v1.PairingModeEnded
+ */
+export declare type PairingModeEnded = Message<"kusinta.iot.connector.v1.PairingModeEnded"> & {
+  /**
+   * @generated from field: string request_id = 1;
+   */
+  requestId: string;
+
+  /**
+   * How many arrivals this connector attributed to the request. The gateway can count the
+   * announcements it received, but only the connector knows it has stopped.
+   *
+   * @generated from field: uint32 devices_attributed = 2;
+   */
+  devicesAttributed: number;
+
+  /**
+   * Why it produced fewer than asked for, absent when it produced them all. DEVICE_UNUSABLE
+   * and WRONG_DEVICE are reported here and should name the device in the message, since that
+   * is the only place a user learns which device is now sitting on their hub.
+   *
+   * @generated from field: kusinta.iot.common.v1.PairingErrorDetail error = 3;
+   */
+  error?: PairingErrorDetail | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.connector.v1.PairingModeEnded.
+ * Use `create(PairingModeEndedSchema)` to create a new message.
+ */
+export declare const PairingModeEndedSchema: GenMessage<PairingModeEnded>;
+
 /**
  * @generated from message kusinta.iot.connector.v1.SessionRequest
  */
@@ -368,6 +683,30 @@ export declare type SessionRequest = Message<"kusinta.iot.connector.v1.SessionRe
      */
     value: DeviceEventBatch;
     case: "deviceEvents";
+  } | {
+    /**
+     * @generated from field: kusinta.iot.connector.v1.PairingModeResult pairing_mode_result = 10;
+     */
+    value: PairingModeResult;
+    case: "pairingModeResult";
+  } | {
+    /**
+     * @generated from field: kusinta.iot.connector.v1.PairingModeEnded pairing_mode_ended = 11;
+     */
+    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 };
 };
 
@@ -433,6 +772,36 @@ export declare type SessionResponse = Message<"kusinta.iot.connector.v1.SessionR
      */
     value: AttributeWriteRequest;
     case: "executeAttributeWrite";
+  } | {
+    /**
+     * The connector-leg half of the pairing flow. See EnterPairingMode.
+     *
+     * @generated from field: kusinta.iot.connector.v1.EnterPairingMode enter_pairing_mode = 10;
+     */
+    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 };
 };