@m1kad0/hannah-proto 4.6.2 → 4.7.0

package/dist/v1/agent.d.ts

@@ -47,6 +47,14 @@ export interface AgentMessage {
     /** full room catalog, independent of devices */
     sendRooms?: AgentRoomSnapshot | undefined;
     weatherUpdate?: AgentWeatherUpdate | undefined;
+    /**
+     * Set = the adapter asks Core to reply with an AgentAck carrying the same
+     * ack_id, listing the fields of this message Core's schema did not know.
+     * Unset = no ack. A Core too old for AgentAck ignores this field and never
+     * replies, so the adapter must treat a missing ack (after a timeout) as
+     * "not supported" (hannah-proto#16).
+     */
+    ackId?: bigint | undefined;
 }
 /**
  * Adapter instructs Hannah to control satellites in a room or a specific satellite.
@@ -126,6 +134,31 @@ export interface AgentCommand {
     satelliteDeleted?: AgentSatelliteDeleted | undefined;
     /** Hannah wants to set a resident's mood, independent of presence */
     setResidentMood?: AgentSetResidentMood | undefined;
+    /** reply to an AgentMessage that set ack_id */
+    ack?: AgentAck | undefined;
+}
+/**
+ * Core's reply to an AgentMessage that set ack_id: which fields of that
+ * message (including nested messages) Core's schema did not know and
+ * therefore dropped. Empty unknown_fields = every field was known.
+ * Core guarantees that every field it does not report is also evaluated,
+ * so a security-relevant field never reads as supported without being
+ * enforced (hannah-proto#16).
+ */
+export interface AgentAck {
+    ackId: bigint;
+    unknownFields: UnknownFields[];
+}
+/**
+ * Unknown field numbers, aggregated per message type — a snapshot with many
+ * devices yields one entry for hannah.v1.AgentDevice, not one per device.
+ * An unknown oneof payload shows up as a field number on the enclosing message.
+ */
+export interface UnknownFields {
+    /** fully qualified name, e.g. "hannah.v1.AgentDevice" */
+    messageType: string;
+    /** deduplicated */
+    fieldNumbers: number[];
 }
 export interface AgentFirmwareEvent {
     device: string;
@@ -291,6 +324,13 @@ export interface AgentDevice {
      * not `false` (hannah-proto#4).
      */
     inverted?: boolean | undefined;
+    /**
+     * Minimum user trust level (0–10, same scale as the users' trust level)
+     * required to control this state, read by the adapter from
+     * common.custom["hannah.0"].neededTrust. Unset = not configured, no
+     * restriction — distinct from an explicit 0 (hannah-proto#15).
+     */
+    requiredTrustLevel?: number | undefined;
 }
 export interface AgentDevice_RoomNamesEntry {
     key: string;
@@ -392,6 +432,8 @@ export declare const CaptureControl: MessageFns<CaptureControl>;
 export declare const AgentStateUpdate: MessageFns<AgentStateUpdate>;
 export declare const AgentTextCommand: MessageFns<AgentTextCommand>;
 export declare const AgentCommand: MessageFns<AgentCommand>;
+export declare const AgentAck: MessageFns<AgentAck>;
+export declare const UnknownFields: MessageFns<UnknownFields>;
 export declare const AgentFirmwareEvent: MessageFns<AgentFirmwareEvent>;
 export declare const AgentSetState: MessageFns<AgentSetState>;
 export declare const AgentWatchMore: MessageFns<AgentWatchMore>;

package/dist/v1/agent.js

@@ -5,7 +5,7 @@
 //   protoc               unknown
 // source: hannah/v1/agent.proto
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgentSensorUpdate = exports.AgentBleUpdate = exports.AgentResidentAnswered = exports.AgentAskResident = exports.AgentResidentSnapshot = exports.AgentResident = exports.AgentRoomSnapshot = exports.AgentRoom_DisplayNamesEntry = exports.AgentRoom = exports.AgentDeviceSnapshot = exports.AgentDevice_RoomNamesEntry = exports.AgentDevice = exports.AgentStateValue = exports.AgentNotification = exports.AgentTextAnswer = exports.AgentSatelliteDeleted = exports.AgentSatelliteUpdate = exports.AgentSetResidentMood = exports.AgentSetResident = exports.AgentWatchMore = exports.AgentSetState = exports.AgentFirmwareEvent = exports.AgentCommand = exports.AgentTextCommand = exports.AgentStateUpdate = exports.CaptureControl = exports.AgentSatelliteControl = exports.AgentMessage = exports.ResidentPresenceAction = exports.ResidentType = exports.protobufPackage = void 0;
+exports.AgentSensorUpdate = exports.AgentBleUpdate = exports.AgentResidentAnswered = exports.AgentAskResident = exports.AgentResidentSnapshot = exports.AgentResident = exports.AgentRoomSnapshot = exports.AgentRoom_DisplayNamesEntry = exports.AgentRoom = exports.AgentDeviceSnapshot = exports.AgentDevice_RoomNamesEntry = exports.AgentDevice = exports.AgentStateValue = exports.AgentNotification = exports.AgentTextAnswer = exports.AgentSatelliteDeleted = exports.AgentSatelliteUpdate = exports.AgentSetResidentMood = exports.AgentSetResident = exports.AgentWatchMore = exports.AgentSetState = exports.AgentFirmwareEvent = exports.UnknownFields = exports.AgentAck = exports.AgentCommand = exports.AgentTextCommand = exports.AgentStateUpdate = exports.CaptureControl = exports.AgentSatelliteControl = exports.AgentMessage = exports.ResidentPresenceAction = exports.ResidentType = exports.protobufPackage = void 0;
 /* eslint-disable */
 const wire_1 = require("@bufbuild/protobuf/wire");
 const shared_1 = require("./shared");
@@ -50,6 +50,7 @@ function createBaseAgentMessage() {
         askResident: undefined,
         sendRooms: undefined,
         weatherUpdate: undefined,
+        ackId: undefined,
     };
 }
 exports.AgentMessage = {
@@ -81,6 +82,12 @@ exports.AgentMessage = {
         if (message.weatherUpdate !== undefined) {
             weather_1.AgentWeatherUpdate.encode(message.weatherUpdate, writer.uint32(74).fork()).join();
         }
+        if (message.ackId !== undefined) {
+            if (BigInt.asUintN(64, message.ackId) !== message.ackId) {
+                throw new globalThis.Error("value provided for field message.ackId of type uint64 too large");
+            }
+            writer.uint32(80).uint64(message.ackId);
+        }
         return writer;
     },
     decode(input, length) {
@@ -159,6 +166,13 @@ exports.AgentMessage = {
                         message.weatherUpdate = weather_1.AgentWeatherUpdate.decode(reader, reader.uint32());
                         continue;
                     }
+                    case 10: {
+                        if (tag !== 80) {
+                            break;
+                        }
+                        message.ackId = reader.uint64();
+                        continue;
+                    }
                 }
                 if ((tag & 7) === 4 || tag === 0) {
                     break;
@@ -203,6 +217,7 @@ exports.AgentMessage = {
         message.weatherUpdate = (object.weatherUpdate !== undefined && object.weatherUpdate !== null)
             ? weather_1.AgentWeatherUpdate.fromPartial(object.weatherUpdate)
             : undefined;
+        message.ackId = (object.ackId !== undefined && object.ackId !== null) ? BigInt(object.ackId) : undefined;
         return message;
     },
 };
@@ -583,6 +598,7 @@ function createBaseAgentCommand() {
         residentAnswered: undefined,
         satelliteDeleted: undefined,
         setResidentMood: undefined,
+        ack: undefined,
     };
 }
 exports.AgentCommand = {
@@ -620,6 +636,9 @@ exports.AgentCommand = {
         if (message.setResidentMood !== undefined) {
             exports.AgentSetResidentMood.encode(message.setResidentMood, writer.uint32(90).fork()).join();
         }
+        if (message.ack !== undefined) {
+            exports.AgentAck.encode(message.ack, writer.uint32(98).fork()).join();
+        }
         return writer;
     },
     decode(input, length) {
@@ -712,6 +731,13 @@ exports.AgentCommand = {
                         message.setResidentMood = exports.AgentSetResidentMood.decode(reader, reader.uint32());
                         continue;
                     }
+                    case 12: {
+                        if (tag !== 98) {
+                            break;
+                        }
+                        message.ack = exports.AgentAck.decode(reader, reader.uint32());
+                        continue;
+                    }
                 }
                 if ((tag & 7) === 4 || tag === 0) {
                     break;
@@ -762,6 +788,143 @@ exports.AgentCommand = {
         message.setResidentMood = (object.setResidentMood !== undefined && object.setResidentMood !== null)
             ? exports.AgentSetResidentMood.fromPartial(object.setResidentMood)
             : undefined;
+        message.ack = (object.ack !== undefined && object.ack !== null) ? exports.AgentAck.fromPartial(object.ack) : undefined;
+        return message;
+    },
+};
+function createBaseAgentAck() {
+    return { ackId: 0n, unknownFields: [] };
+}
+exports.AgentAck = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.ackId !== 0n) {
+            if (BigInt.asUintN(64, message.ackId) !== message.ackId) {
+                throw new globalThis.Error("value provided for field message.ackId of type uint64 too large");
+            }
+            writer.uint32(8).uint64(message.ackId);
+        }
+        for (const v of message.unknownFields) {
+            exports.UnknownFields.encode(v, writer.uint32(18).fork()).join();
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const previousRecursionDepth = reader.__tsProtoDecodeDepth ?? 0;
+        if (previousRecursionDepth >= 100) {
+            throw new globalThis.Error("protobuf decode recursion limit exceeded");
+        }
+        reader.__tsProtoDecodeDepth = previousRecursionDepth + 1;
+        try {
+            const end = length === undefined ? reader.len : reader.pos + length;
+            const message = createBaseAgentAck();
+            while (reader.pos < end) {
+                const tag = reader.uint32();
+                switch (tag >>> 3) {
+                    case 1: {
+                        if (tag !== 8) {
+                            break;
+                        }
+                        message.ackId = reader.uint64();
+                        continue;
+                    }
+                    case 2: {
+                        if (tag !== 18) {
+                            break;
+                        }
+                        message.unknownFields.push(exports.UnknownFields.decode(reader, reader.uint32()));
+                        continue;
+                    }
+                }
+                if ((tag & 7) === 4 || tag === 0) {
+                    break;
+                }
+                reader.skip(tag & 7);
+            }
+            return message;
+        }
+        finally {
+            reader.__tsProtoDecodeDepth = previousRecursionDepth;
+        }
+    },
+    create(base) {
+        return exports.AgentAck.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseAgentAck();
+        message.ackId = (object.ackId !== undefined && object.ackId !== null) ? BigInt(object.ackId) : 0n;
+        message.unknownFields = object.unknownFields?.map((e) => exports.UnknownFields.fromPartial(e)) || [];
+        return message;
+    },
+};
+function createBaseUnknownFields() {
+    return { messageType: "", fieldNumbers: [] };
+}
+exports.UnknownFields = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.messageType !== "") {
+            writer.uint32(10).string(message.messageType);
+        }
+        writer.uint32(18).fork();
+        for (const v of message.fieldNumbers) {
+            writer.uint32(v);
+        }
+        writer.join();
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const previousRecursionDepth = reader.__tsProtoDecodeDepth ?? 0;
+        if (previousRecursionDepth >= 100) {
+            throw new globalThis.Error("protobuf decode recursion limit exceeded");
+        }
+        reader.__tsProtoDecodeDepth = previousRecursionDepth + 1;
+        try {
+            const end = length === undefined ? reader.len : reader.pos + length;
+            const message = createBaseUnknownFields();
+            while (reader.pos < end) {
+                const tag = reader.uint32();
+                switch (tag >>> 3) {
+                    case 1: {
+                        if (tag !== 10) {
+                            break;
+                        }
+                        message.messageType = reader.string();
+                        continue;
+                    }
+                    case 2: {
+                        if (tag === 16) {
+                            message.fieldNumbers.push(reader.uint32());
+                            continue;
+                        }
+                        if (tag === 18) {
+                            const end2 = reader.uint32() + reader.pos;
+                            while (reader.pos < end2) {
+                                message.fieldNumbers.push(reader.uint32());
+                            }
+                            continue;
+                        }
+                        break;
+                    }
+                }
+                if ((tag & 7) === 4 || tag === 0) {
+                    break;
+                }
+                reader.skip(tag & 7);
+            }
+            return message;
+        }
+        finally {
+            reader.__tsProtoDecodeDepth = previousRecursionDepth;
+        }
+    },
+    create(base) {
+        return exports.UnknownFields.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseUnknownFields();
+        message.messageType = object.messageType ?? "";
+        message.fieldNumbers = object.fieldNumbers?.map((e) => e) || [];
         return message;
     },
 };
@@ -1520,6 +1683,7 @@ function createBaseAgentDevice() {
         deviceId: "",
         canonicalKey: "",
         inverted: undefined,
+        requiredTrustLevel: undefined,
     };
 }
 exports.AgentDevice = {
@@ -1566,6 +1730,9 @@ exports.AgentDevice = {
         if (message.inverted !== undefined) {
             writer.uint32(112).bool(message.inverted);
         }
+        if (message.requiredTrustLevel !== undefined) {
+            writer.uint32(120).int32(message.requiredTrustLevel);
+        }
         return writer;
     },
     decode(input, length) {
@@ -1682,6 +1849,13 @@ exports.AgentDevice = {
                         message.inverted = reader.bool();
                         continue;
                     }
+                    case 15: {
+                        if (tag !== 120) {
+                            break;
+                        }
+                        message.requiredTrustLevel = reader.int32();
+                        continue;
+                    }
                 }
                 if ((tag & 7) === 4 || tag === 0) {
                     break;
@@ -1722,6 +1896,7 @@ exports.AgentDevice = {
         message.deviceId = object.deviceId ?? "";
         message.canonicalKey = object.canonicalKey ?? "";
         message.inverted = object.inverted ?? undefined;
+        message.requiredTrustLevel = object.requiredTrustLevel ?? undefined;
         return message;
     },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m1kad0/hannah-proto",
-  "version": "4.6.2",
+  "version": "4.7.0",
   "description": "Generated TypeScript gRPC-js client stubs for the Hannah voice assistant proto schema",
   "license": "UNLICENSED",
   "main": "dist/index.js",