@m1kad0/hannah-proto 3.7.2 → 3.9.0

package/dist/agent.d.ts

@@ -235,6 +235,23 @@ export interface AgentDevice {
     enumValues: EnumValues | undefined;
     /** derived from ioBroker's common.write */
     writable: boolean;
+    /**
+     * Grouping ID for the device this state belongs to (the adapter's own
+     * `deviceId`, one path segment up from state_id) — lets Core group sibling
+     * states without guessing from state_id's path depth. Empty = adapter hasn't
+     * been updated yet; Core falls back to its own path-depth heuristic (hannah#257).
+     */
+    deviceId: string;
+    /**
+     * Semantic role of this specific state (e.g. "on", "level", "color", "current",
+     * "expected"), resolved by the adapter from the state's ioBroker common.role —
+     * same per-state basis as device_type, not aggregated across sibling states
+     * (a thermostat's "current" and "expected" states have different roles but
+     * belong to one device). Empty = adapter hasn't been updated yet or role is
+     * unresolvable; Core falls back to its iobroker.state_names default table
+     * (hannah#256, hannah#257).
+     */
+    canonicalKey: string;
 }
 export interface AgentDevice_RoomNamesEntry {
     key: string;

package/dist/agent.js

@@ -1487,6 +1487,8 @@ function createBaseAgentDevice() {
         stateType: 0,
         enumValues: undefined,
         writable: false,
+        deviceId: "",
+        canonicalKey: "",
     };
 }
 exports.AgentDevice = {
@@ -1524,6 +1526,12 @@ exports.AgentDevice = {
         if (message.writable !== false) {
             writer.uint32(88).bool(message.writable);
         }
+        if (message.deviceId !== "") {
+            writer.uint32(98).string(message.deviceId);
+        }
+        if (message.canonicalKey !== "") {
+            writer.uint32(106).string(message.canonicalKey);
+        }
         return writer;
     },
     decode(input, length) {
@@ -1619,6 +1627,20 @@ exports.AgentDevice = {
                         message.writable = reader.bool();
                         continue;
                     }
+                    case 12: {
+                        if (tag !== 98) {
+                            break;
+                        }
+                        message.deviceId = reader.string();
+                        continue;
+                    }
+                    case 13: {
+                        if (tag !== 106) {
+                            break;
+                        }
+                        message.canonicalKey = reader.string();
+                        continue;
+                    }
                 }
                 if ((tag & 7) === 4 || tag === 0) {
                     break;
@@ -1656,6 +1678,8 @@ exports.AgentDevice = {
             ? shared_1.EnumValues.fromPartial(object.enumValues)
             : undefined;
         message.writable = object.writable ?? false;
+        message.deviceId = object.deviceId ?? "";
+        message.canonicalKey = object.canonicalKey ?? "";
         return message;
     },
 };

package/dist/compat_versions.js

@@ -68,6 +68,7 @@ exports.REQUIRED_COMPAT_VERSIONS = {
     "NotifySatelliteRegistered": 1,
     "NotifySatelliteGone": 1,
     "ProvisionSatellite": 1,
+    "StartVoiceEnrollment": 1,
     "EnrollVoiceprint": 1,
     "TimerConnect": 1,
     "GetTimers": 1,

package/dist/hannah.d.ts

@@ -11,7 +11,7 @@ import { DeleteSatelliteRequest, GetSatellitesResponse, SetSatelliteDisplayNameR
 import { ProvisionSatelliteRequest } from "./satellite_provisioning";
 import { ProxyCommand, ProxyHeartbeat, SatelliteRegistration, SubmitSatelliteAudioRequest, SubmitSatelliteAudioResponse } from "./satellite_proxy";
 import { Empty, StatusResponse } from "./shared";
-import { EnrollVoiceprintRequest } from "./speaker_enrollment";
+import { EnrollVoiceprintRequest, StartVoiceEnrollmentRequest } from "./speaker_enrollment";
 import { DeleteTimerRequest, GetTimersRequest, GetTimersResponse } from "./timer_admin";
 import { TimerCommand, TimerMessage } from "./timer_service";
 import { CreateUserRequest, CreateUserResponse, DeleteUserRequest, GetResidentsResponse, GetUserRequest, GetUsersRequest, GetUsersResponse, LinkAccountRequest, LoginRequest, SetAutomationRequest, SetSystemMessagesRequest, SetTrustLevelRequest, UnlinkAccountRequest, UpdateUserRequest, UserResponse } from "./user_registry";
@@ -698,7 +698,22 @@ export declare const HannahServiceService: {
         readonly responseSerialize: (value: StatusResponse) => Buffer;
         readonly responseDeserialize: (value: Buffer) => StatusResponse;
     };
-    /** --- Speaker Enrollment --- */
+    /**
+     * --- Speaker Enrollment ---
+     * Trigger a guided voice-enrollment dialog for user_id at satellite_id (hannah#8);
+     * Core orchestrates the dialog itself. EnrollVoiceprint stays available as the
+     * low-level "store one already-captured sample" call — kept for now (additive,
+     * no hard cut) until hannah#8 confirms Core no longer needs it as an external RPC.
+     */
+    readonly startVoiceEnrollment: {
+        readonly path: "/hannah.HannahService/StartVoiceEnrollment";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: StartVoiceEnrollmentRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => StartVoiceEnrollmentRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
     readonly enrollVoiceprint: {
         readonly path: "/hannah.HannahService/EnrollVoiceprint";
         readonly requestStream: false;
@@ -1002,7 +1017,14 @@ export interface HannahServiceServer extends UntypedServiceImplementation {
      * When the satellite first connects with that seed, Hannah links serial → pre-config and clears the seed.
      */
     provisionSatellite: handleUnaryCall<ProvisionSatelliteRequest, StatusResponse>;
-    /** --- Speaker Enrollment --- */
+    /**
+     * --- Speaker Enrollment ---
+     * Trigger a guided voice-enrollment dialog for user_id at satellite_id (hannah#8);
+     * Core orchestrates the dialog itself. EnrollVoiceprint stays available as the
+     * low-level "store one already-captured sample" call — kept for now (additive,
+     * no hard cut) until hannah#8 confirms Core no longer needs it as an external RPC.
+     */
+    startVoiceEnrollment: handleUnaryCall<StartVoiceEnrollmentRequest, StatusResponse>;
     enrollVoiceprint: handleUnaryCall<EnrollVoiceprintRequest, StatusResponse>;
     /**
      * --- Timer Service ---
@@ -1344,7 +1366,16 @@ export interface HannahServiceClient extends Client {
     provisionSatellite(request: ProvisionSatelliteRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
     provisionSatellite(request: ProvisionSatelliteRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
     provisionSatellite(request: ProvisionSatelliteRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
-    /** --- Speaker Enrollment --- */
+    /**
+     * --- Speaker Enrollment ---
+     * Trigger a guided voice-enrollment dialog for user_id at satellite_id (hannah#8);
+     * Core orchestrates the dialog itself. EnrollVoiceprint stays available as the
+     * low-level "store one already-captured sample" call — kept for now (additive,
+     * no hard cut) until hannah#8 confirms Core no longer needs it as an external RPC.
+     */
+    startVoiceEnrollment(request: StartVoiceEnrollmentRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    startVoiceEnrollment(request: StartVoiceEnrollmentRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    startVoiceEnrollment(request: StartVoiceEnrollmentRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
     enrollVoiceprint(request: EnrollVoiceprintRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
     enrollVoiceprint(request: EnrollVoiceprintRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
     enrollVoiceprint(request: EnrollVoiceprintRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;

package/dist/hannah.js

@@ -706,7 +706,22 @@ exports.HannahServiceService = {
         responseSerialize: (value) => Buffer.from(shared_1.StatusResponse.encode(value).finish()),
         responseDeserialize: (value) => shared_1.StatusResponse.decode(value),
     },
-    /** --- Speaker Enrollment --- */
+    /**
+     * --- Speaker Enrollment ---
+     * Trigger a guided voice-enrollment dialog for user_id at satellite_id (hannah#8);
+     * Core orchestrates the dialog itself. EnrollVoiceprint stays available as the
+     * low-level "store one already-captured sample" call — kept for now (additive,
+     * no hard cut) until hannah#8 confirms Core no longer needs it as an external RPC.
+     */
+    startVoiceEnrollment: {
+        path: "/hannah.HannahService/StartVoiceEnrollment",
+        requestStream: false,
+        responseStream: false,
+        requestSerialize: (value) => Buffer.from(speaker_enrollment_1.StartVoiceEnrollmentRequest.encode(value).finish()),
+        requestDeserialize: (value) => speaker_enrollment_1.StartVoiceEnrollmentRequest.decode(value),
+        responseSerialize: (value) => Buffer.from(shared_1.StatusResponse.encode(value).finish()),
+        responseDeserialize: (value) => shared_1.StatusResponse.decode(value),
+    },
     enrollVoiceprint: {
         path: "/hannah.HannahService/EnrollVoiceprint",
         requestStream: false,

package/dist/speaker_enrollment.d.ts

@@ -8,7 +8,23 @@ export interface EnrollVoiceprintRequest {
     /** e.g. 16000 */
     sampleRate: number;
 }
+/**
+ * Triggers a guided voice-enrollment dialog (hannah#8) for user_id at satellite_id.
+ * Called by an already-authenticated external client (WebUI/Telegram) against Core,
+ * which then orchestrates the recording dialog itself (STT prompts, sample capture,
+ * eventually calling voiceid_client.enroll() directly) instead of the caller submitting
+ * samples via EnrollVoiceprint. requestor_id/user_id follow the same split as
+ * ListActivityLogRequest (activity_log.proto): enrolling another user
+ * (requestor_id != user_id) requires the requestor's trust_level >= 10 — enforced by
+ * Core, not expressed in this schema.
+ */
+export interface StartVoiceEnrollmentRequest {
+    requestorId: number;
+    userId: number;
+    satelliteId: string;
+}
 export declare const EnrollVoiceprintRequest: MessageFns<EnrollVoiceprintRequest>;
+export declare const StartVoiceEnrollmentRequest: MessageFns<StartVoiceEnrollmentRequest>;
 type Builtin = Date | Function | Uint8Array | string | number | boolean | bigint | undefined;
 export type DeepPartial<T> = T extends bigint ? string | number | bigint : T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {} ? {
     [K in keyof T]?: DeepPartial<T[K]>;

package/dist/speaker_enrollment.js

@@ -5,7 +5,7 @@
 //   protoc               unknown
 // source: hannah/speaker_enrollment.proto
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EnrollVoiceprintRequest = exports.protobufPackage = void 0;
+exports.StartVoiceEnrollmentRequest = exports.EnrollVoiceprintRequest = exports.protobufPackage = void 0;
 /* eslint-disable */
 const wire_1 = require("@bufbuild/protobuf/wire");
 exports.protobufPackage = "hannah";
@@ -82,3 +82,76 @@ exports.EnrollVoiceprintRequest = {
         return message;
     },
 };
+function createBaseStartVoiceEnrollmentRequest() {
+    return { requestorId: 0, userId: 0, satelliteId: "" };
+}
+exports.StartVoiceEnrollmentRequest = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.requestorId !== 0) {
+            writer.uint32(8).int32(message.requestorId);
+        }
+        if (message.userId !== 0) {
+            writer.uint32(16).int32(message.userId);
+        }
+        if (message.satelliteId !== "") {
+            writer.uint32(26).string(message.satelliteId);
+        }
+        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 = createBaseStartVoiceEnrollmentRequest();
+            while (reader.pos < end) {
+                const tag = reader.uint32();
+                switch (tag >>> 3) {
+                    case 1: {
+                        if (tag !== 8) {
+                            break;
+                        }
+                        message.requestorId = reader.int32();
+                        continue;
+                    }
+                    case 2: {
+                        if (tag !== 16) {
+                            break;
+                        }
+                        message.userId = reader.int32();
+                        continue;
+                    }
+                    case 3: {
+                        if (tag !== 26) {
+                            break;
+                        }
+                        message.satelliteId = reader.string();
+                        continue;
+                    }
+                }
+                if ((tag & 7) === 4 || tag === 0) {
+                    break;
+                }
+                reader.skip(tag & 7);
+            }
+            return message;
+        }
+        finally {
+            reader.__tsProtoDecodeDepth = previousRecursionDepth;
+        }
+    },
+    create(base) {
+        return exports.StartVoiceEnrollmentRequest.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseStartVoiceEnrollmentRequest();
+        message.requestorId = object.requestorId ?? 0;
+        message.userId = object.userId ?? 0;
+        message.satelliteId = object.satelliteId ?? "";
+        return message;
+    },
+};

package/package.json

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