@m1kad0/hannah-proto 4.1.0 → 4.2.0

package/dist/agent.d.ts

@@ -10,6 +10,24 @@ export declare enum ResidentType {
     PET = 3,
     UNRECOGNIZED = -1
 }
+/**
+ * Which single presence aspect to set. The residents adapter's presence.{away,home,night}
+ * datapoints guard their own cross-consistency (e.g. setting "away" true automatically
+ * flips "home" false) — Hannah only needs to name the aspect it actually has an opinion
+ * about, instead of writing the whole combined presence.state value (hannah#309, root
+ * cause of hannah#299: two independent Hannah-side decisions, home/away presence fusion
+ * and an explicit asleep/awake trigger, collapsed onto one write and could clobber each
+ * other's information). SET_AWAKE has no direct presence.state equivalent — it only
+ * clears "night" and leaves "home" untouched, regardless of its current value.
+ */
+export declare enum ResidentPresenceAction {
+    RESIDENT_PRESENCE_ACTION_UNSPECIFIED = 0,
+    AWAY = 1,
+    HOME = 2,
+    ASLEEP = 3,
+    AWAKE = 4,
+    UNRECOGNIZED = -1
+}
 /** Sent by the HannahAgent ioBroker adapter over the AgentConnect stream. */
 export interface AgentMessage {
     /** any ioBroker state changed */
@@ -141,9 +159,23 @@ export interface AgentWatchMore {
 export interface AgentSetResident {
     /** e.g. "leonie", "hannah" */
     residentId: string;
-    /** residents adapter presence value (0=absent, 1=home, …) */
+    /**
+     * Legacy absolute presence value (0=absent, 1=home, 2=night) — writes the combined
+     * presence.state, which cross-clobbers whichever of home/away/night Hannah didn't
+     * intend to change. Superseded by `action`; kept only for adapters older than
+     * compat_version 2, which don't understand `action` yet and ignore it entirely.
+     * Senders should populate both until those adapters are no longer in use.
+     *
+     * @deprecated
+     */
     presenceState: number;
     type: ResidentType;
+    /**
+     * Preferred over `presence_state`: sets only the single presence.{away,home,night}
+     * flag this action corresponds to, letting the residents adapter's own consistency
+     * guard handle the rest.
+     */
+    action: ResidentPresenceAction;
 }
 /**
  * Hannah instructs the adapter to set a resident's mood — separate command from

package/dist/agent.js

@@ -5,7 +5,7 @@
 //   protoc               unknown
 // source: hannah/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.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.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");
@@ -20,6 +20,25 @@ var ResidentType;
     ResidentType[ResidentType["PET"] = 3] = "PET";
     ResidentType[ResidentType["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
 })(ResidentType || (exports.ResidentType = ResidentType = {}));
+/**
+ * Which single presence aspect to set. The residents adapter's presence.{away,home,night}
+ * datapoints guard their own cross-consistency (e.g. setting "away" true automatically
+ * flips "home" false) — Hannah only needs to name the aspect it actually has an opinion
+ * about, instead of writing the whole combined presence.state value (hannah#309, root
+ * cause of hannah#299: two independent Hannah-side decisions, home/away presence fusion
+ * and an explicit asleep/awake trigger, collapsed onto one write and could clobber each
+ * other's information). SET_AWAKE has no direct presence.state equivalent — it only
+ * clears "night" and leaves "home" untouched, regardless of its current value.
+ */
+var ResidentPresenceAction;
+(function (ResidentPresenceAction) {
+    ResidentPresenceAction[ResidentPresenceAction["RESIDENT_PRESENCE_ACTION_UNSPECIFIED"] = 0] = "RESIDENT_PRESENCE_ACTION_UNSPECIFIED";
+    ResidentPresenceAction[ResidentPresenceAction["AWAY"] = 1] = "AWAY";
+    ResidentPresenceAction[ResidentPresenceAction["HOME"] = 2] = "HOME";
+    ResidentPresenceAction[ResidentPresenceAction["ASLEEP"] = 3] = "ASLEEP";
+    ResidentPresenceAction[ResidentPresenceAction["AWAKE"] = 4] = "AWAKE";
+    ResidentPresenceAction[ResidentPresenceAction["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
+})(ResidentPresenceAction || (exports.ResidentPresenceAction = ResidentPresenceAction = {}));
 function createBaseAgentMessage() {
     return {
         stateUpdate: undefined,
@@ -933,7 +952,7 @@ exports.AgentWatchMore = {
     },
 };
 function createBaseAgentSetResident() {
-    return { residentId: "", presenceState: 0, type: 0 };
+    return { residentId: "", presenceState: 0, type: 0, action: 0 };
 }
 exports.AgentSetResident = {
     encode(message, writer = new wire_1.BinaryWriter()) {
@@ -946,6 +965,9 @@ exports.AgentSetResident = {
         if (message.type !== 0) {
             writer.uint32(24).int32(message.type);
         }
+        if (message.action !== 0) {
+            writer.uint32(32).int32(message.action);
+        }
         return writer;
     },
     decode(input, length) {
@@ -982,6 +1004,13 @@ exports.AgentSetResident = {
                         message.type = reader.int32();
                         continue;
                     }
+                    case 4: {
+                        if (tag !== 32) {
+                            break;
+                        }
+                        message.action = reader.int32();
+                        continue;
+                    }
                 }
                 if ((tag & 7) === 4 || tag === 0) {
                     break;
@@ -1002,6 +1031,7 @@ exports.AgentSetResident = {
         message.residentId = object.residentId ?? "";
         message.presenceState = object.presenceState ?? 0;
         message.type = object.type ?? 0;
+        message.action = object.action ?? 0;
         return message;
     },
 };

package/package.json

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