@m1kad0/hannah-proto 0.3.3 → 0.3.5

package/dist/hannah.d.ts

@@ -1 +1,1161 @@
+import { type CallOptions, type ChannelCredentials, Client, type ClientDuplexStream, type ClientOptions, type ClientReadableStream, type ClientUnaryCall, type handleBidiStreamingCall, type handleServerStreamingCall, type handleUnaryCall, type Metadata, type ServiceError, type UntypedServiceImplementation } from "@grpc/grpc-js";
+import { AgentCommand, AgentMessage, AgentNotification } from "./agent";
+import { CarStateResponse, GetAllCarStatesResponse } from "./car_state";
+import { AnnounceRequest, CreateAlarmRequest, CreateAlarmResponse, CreateBleTagRequest, CreateBleTagResponse, CreateCarRequest, CreateCarResponse, CreateGroupRequest, CreateRoutineRequest, CreateRoutineResponse, CreateTriggerRequest, DeleteAlarmRequest, DeleteBleTagRequest, DeleteCarRequest, DeleteGroupRequest, DeleteRoutineRequest, DeleteSatelliteRequest, DeleteTriggerRequest, GetAlarmsResponse, GetBleTagsResponse, GetCarsResponse, GetGroupsResponse, GetRoomsResponse, GetRoutinesResponse, GetSatellitesResponse, GetSettingsResponse, GetTriggersResponse, SetGroupRoomsRequest, SetSatelliteDisplayNameRequest, SetSatelliteOwnerRequest, SetSatelliteRoomRequest, SubmitTextRequest, SubmitTextResponse, SubmitVoiceRequest, SubmitVoiceResponse, UpdateAlarmRequest, UpdateBleTagRequest, UpdateCarRequest, UpdateConfigRequest, UpdateGroupRequest, UpdateRoutineRequest, UpdateTriggerRequest } from "./control";
+import { ControlDeviceRequest, GetDevicesResponse } from "./device_control_menu";
+import { EventFilter, HannahEvent, TriggerFirmwareUpdateRequest } from "./event_stream";
+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 { TimerCommand, TimerMessage } from "./timer_service";
+import { CreateUserRequest, CreateUserResponse, DeleteUserRequest, GetResidentsResponse, GetUserRequest, GetUsersRequest, GetUsersResponse, LinkAccountRequest, LoginRequest, SetSystemMessagesRequest, SetTrustLevelRequest, UnlinkAccountRequest, UpdateUserRequest, UserResponse } from "./user_registry";
+import { SatelliteAudioChunk, SatelliteCaptureRequest, SatelliteCaptureResponse, TriggerPlinkRequest } from "./wakeword_capture";
 export declare const protobufPackage = "hannah";
+export type HannahServiceService = typeof HannahServiceService;
+export declare const HannahServiceService: {
+    /** --- User Registry --- */
+    readonly getUsers: {
+        readonly path: "/hannah.HannahService/GetUsers";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: GetUsersRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => GetUsersRequest;
+        readonly responseSerialize: (value: GetUsersResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => GetUsersResponse;
+    };
+    readonly getUser: {
+        readonly path: "/hannah.HannahService/GetUser";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: GetUserRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => GetUserRequest;
+        readonly responseSerialize: (value: UserResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => UserResponse;
+    };
+    readonly linkAccount: {
+        readonly path: "/hannah.HannahService/LinkAccount";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: LinkAccountRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => LinkAccountRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    readonly unlinkAccount: {
+        readonly path: "/hannah.HannahService/UnlinkAccount";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: UnlinkAccountRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => UnlinkAccountRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    readonly setTrustLevel: {
+        readonly path: "/hannah.HannahService/SetTrustLevel";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: SetTrustLevelRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => SetTrustLevelRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    readonly setSystemMessages: {
+        readonly path: "/hannah.HannahService/SetSystemMessages";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: SetSystemMessagesRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => SetSystemMessagesRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    readonly login: {
+        readonly path: "/hannah.HannahService/Login";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: LoginRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => LoginRequest;
+        readonly responseSerialize: (value: UserResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => UserResponse;
+    };
+    /** --- User-Verwaltung (Admin-UI, #27 Phase 6) --- */
+    readonly createUser: {
+        readonly path: "/hannah.HannahService/CreateUser";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: CreateUserRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => CreateUserRequest;
+        readonly responseSerialize: (value: CreateUserResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => CreateUserResponse;
+    };
+    readonly updateUser: {
+        readonly path: "/hannah.HannahService/UpdateUser";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: UpdateUserRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => UpdateUserRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    readonly deleteUser: {
+        readonly path: "/hannah.HannahService/DeleteUser";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: DeleteUserRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => DeleteUserRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    /** Residents (Roomies/Guests/Pets) aus dem ioBroker-Adapter-Cache — fürs "Resident verknüpfen"-Dropdown. */
+    readonly getResidents: {
+        readonly path: "/hannah.HannahService/GetResidents";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: Empty) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => Empty;
+        readonly responseSerialize: (value: GetResidentsResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => GetResidentsResponse;
+    };
+    /**
+     * --- Device Control Menu ---
+     * Returns all rooms and devices with current state — for building control menus.
+     */
+    readonly getDevices: {
+        readonly path: "/hannah.HannahService/GetDevices";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: Empty) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => Empty;
+        readonly responseSerialize: (value: GetDevicesResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => GetDevicesResponse;
+    };
+    /** Directly set a device state (bypasses NLU). Trust level check is done by the caller. */
+    readonly controlDevice: {
+        readonly path: "/hannah.HannahService/ControlDevice";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: ControlDeviceRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => ControlDeviceRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    /**
+     * --- Control ---
+     * Submit a plain-text command; Hannah processes it through NLU and returns the answer.
+     */
+    readonly submitText: {
+        readonly path: "/hannah.HannahService/SubmitText";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: SubmitTextRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => SubmitTextRequest;
+        readonly responseSerialize: (value: SubmitTextResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => SubmitTextResponse;
+    };
+    /** Submit a voice message (OGG/Opus bytes); Hannah does STT → NLU → TTS and returns the result. */
+    readonly submitVoice: {
+        readonly path: "/hannah.HannahService/SubmitVoice";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: SubmitVoiceRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => SubmitVoiceRequest;
+        readonly responseSerialize: (value: SubmitVoiceResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => SubmitVoiceResponse;
+    };
+    /** Send a TTS announcement to one satellite or all ("all"). */
+    readonly announce: {
+        readonly path: "/hannah.HannahService/Announce";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: AnnounceRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => AnnounceRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    /**
+     * Send a notification from ioBroker to Hannah. Returns ok=true when queued.
+     * direct=true: skip LLM reformulation. severity: "alert"|"notify"|"info".
+     */
+    readonly notify: {
+        readonly path: "/hannah.HannahService/Notify";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: AgentNotification) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => AgentNotification;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    /** List all known satellites (DB + live status merged). */
+    readonly getSatellites: {
+        readonly path: "/hannah.HannahService/GetSatellites";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: Empty) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => Empty;
+        readonly responseSerialize: (value: GetSatellitesResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => GetSatellitesResponse;
+    };
+    /** --- Satellites (Admin-UI, #27 Phase 2) --- */
+    readonly setSatelliteRoom: {
+        readonly path: "/hannah.HannahService/SetSatelliteRoom";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: SetSatelliteRoomRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => SetSatelliteRoomRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    readonly setSatelliteDisplayName: {
+        readonly path: "/hannah.HannahService/SetSatelliteDisplayName";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: SetSatelliteDisplayNameRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => SetSatelliteDisplayNameRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    /** Assign a satellite to a Person (User), independent of its room. #31 */
+    readonly setSatelliteOwner: {
+        readonly path: "/hannah.HannahService/SetSatelliteOwner";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: SetSatelliteOwnerRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => SetSatelliteOwnerRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    /** Delete existing satellite */
+    readonly deleteSatellite: {
+        readonly path: "/hannah.HannahService/DeleteSatellite";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: DeleteSatelliteRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => DeleteSatelliteRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    /** --- Rooms/Groups (Admin-UI, #27 Phase 1) --- */
+    readonly getRooms: {
+        readonly path: "/hannah.HannahService/GetRooms";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: Empty) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => Empty;
+        readonly responseSerialize: (value: GetRoomsResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => GetRoomsResponse;
+    };
+    readonly getGroups: {
+        readonly path: "/hannah.HannahService/GetGroups";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: Empty) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => Empty;
+        readonly responseSerialize: (value: GetGroupsResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => GetGroupsResponse;
+    };
+    readonly createGroup: {
+        readonly path: "/hannah.HannahService/CreateGroup";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: CreateGroupRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => CreateGroupRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    readonly updateGroup: {
+        readonly path: "/hannah.HannahService/UpdateGroup";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: UpdateGroupRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => UpdateGroupRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    readonly deleteGroup: {
+        readonly path: "/hannah.HannahService/DeleteGroup";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: DeleteGroupRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => DeleteGroupRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    readonly setGroupRooms: {
+        readonly path: "/hannah.HannahService/SetGroupRooms";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: SetGroupRoomsRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => SetGroupRoomsRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    /** --- Routines/Triggers (Admin-UI, #27 Phase 4) --- */
+    readonly getRoutines: {
+        readonly path: "/hannah.HannahService/GetRoutines";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: Empty) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => Empty;
+        readonly responseSerialize: (value: GetRoutinesResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => GetRoutinesResponse;
+    };
+    readonly createRoutine: {
+        readonly path: "/hannah.HannahService/CreateRoutine";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: CreateRoutineRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => CreateRoutineRequest;
+        readonly responseSerialize: (value: CreateRoutineResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => CreateRoutineResponse;
+    };
+    readonly updateRoutine: {
+        readonly path: "/hannah.HannahService/UpdateRoutine";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: UpdateRoutineRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => UpdateRoutineRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    readonly deleteRoutine: {
+        readonly path: "/hannah.HannahService/DeleteRoutine";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: DeleteRoutineRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => DeleteRoutineRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    readonly getTriggers: {
+        readonly path: "/hannah.HannahService/GetTriggers";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: Empty) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => Empty;
+        readonly responseSerialize: (value: GetTriggersResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => GetTriggersResponse;
+    };
+    readonly createTrigger: {
+        readonly path: "/hannah.HannahService/CreateTrigger";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: CreateTriggerRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => CreateTriggerRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    readonly updateTrigger: {
+        readonly path: "/hannah.HannahService/UpdateTrigger";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: UpdateTriggerRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => UpdateTriggerRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    readonly deleteTrigger: {
+        readonly path: "/hannah.HannahService/DeleteTrigger";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: DeleteTriggerRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => DeleteTriggerRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    /** --- Alarms (Wecker, #4) --- */
+    readonly getAlarms: {
+        readonly path: "/hannah.HannahService/GetAlarms";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: Empty) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => Empty;
+        readonly responseSerialize: (value: GetAlarmsResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => GetAlarmsResponse;
+    };
+    readonly createAlarm: {
+        readonly path: "/hannah.HannahService/CreateAlarm";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: CreateAlarmRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => CreateAlarmRequest;
+        readonly responseSerialize: (value: CreateAlarmResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => CreateAlarmResponse;
+    };
+    readonly updateAlarm: {
+        readonly path: "/hannah.HannahService/UpdateAlarm";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: UpdateAlarmRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => UpdateAlarmRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    readonly deleteAlarm: {
+        readonly path: "/hannah.HannahService/DeleteAlarm";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: DeleteAlarmRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => DeleteAlarmRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    /**
+     * --- Settings (Admin-UI, #27 Phase 5) ---
+     * CreateSetting/DeleteSetting wurden mit #115 entfernt: ble.tags/cars haben jetzt
+     * eigene Modelle+CRUD (unten), nlu/iobroker.state_names/llm.system_prompt sind immer
+     * vorab bekannt/geseedet — es gibt keinen verbleibenden Bedarf, neue Settings anzulegen.
+     */
+    readonly getSettings: {
+        readonly path: "/hannah.HannahService/GetSettings";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: Empty) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => Empty;
+        readonly responseSerialize: (value: GetSettingsResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => GetSettingsResponse;
+    };
+    readonly updateConfig: {
+        readonly path: "/hannah.HannahService/UpdateConfig";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: UpdateConfigRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => UpdateConfigRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    /** --- BLE Tags (Admin-UI, #115 — eigenes Modell statt Settings-JSON-Blob) --- */
+    readonly getBleTags: {
+        readonly path: "/hannah.HannahService/GetBleTags";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: Empty) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => Empty;
+        readonly responseSerialize: (value: GetBleTagsResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => GetBleTagsResponse;
+    };
+    readonly createBleTag: {
+        readonly path: "/hannah.HannahService/CreateBleTag";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: CreateBleTagRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => CreateBleTagRequest;
+        readonly responseSerialize: (value: CreateBleTagResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => CreateBleTagResponse;
+    };
+    readonly updateBleTag: {
+        readonly path: "/hannah.HannahService/UpdateBleTag";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: UpdateBleTagRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => UpdateBleTagRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    readonly deleteBleTag: {
+        readonly path: "/hannah.HannahService/DeleteBleTag";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: DeleteBleTagRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => DeleteBleTagRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    /** --- Cars (Admin-UI, #115 — eigenes Modell + user_to_car-Pivot statt Settings-JSON-Blob) --- */
+    readonly getCars: {
+        readonly path: "/hannah.HannahService/GetCars";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: Empty) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => Empty;
+        readonly responseSerialize: (value: GetCarsResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => GetCarsResponse;
+    };
+    readonly createCar: {
+        readonly path: "/hannah.HannahService/CreateCar";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: CreateCarRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => CreateCarRequest;
+        readonly responseSerialize: (value: CreateCarResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => CreateCarResponse;
+    };
+    readonly updateCar: {
+        readonly path: "/hannah.HannahService/UpdateCar";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: UpdateCarRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => UpdateCarRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    readonly deleteCar: {
+        readonly path: "/hannah.HannahService/DeleteCar";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: DeleteCarRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => DeleteCarRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    /**
+     * --- Car state (Live-VW-Connect-Status, unabhängig von der Car-Konfiguration oben) ---
+     * Returns the current cached car state (available=false if no data received yet).
+     */
+    readonly getCarState: {
+        readonly path: "/hannah.HannahService/GetCarState";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: Empty) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => Empty;
+        readonly responseSerialize: (value: CarStateResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => CarStateResponse;
+    };
+    /** Returns all tracked car states (one per configured car). */
+    readonly getAllCarStates: {
+        readonly path: "/hannah.HannahService/GetAllCarStates";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: Empty) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => Empty;
+        readonly responseSerialize: (value: GetAllCarStatesResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => GetAllCarStatesResponse;
+    };
+    /**
+     * --- Event stream ---
+     * Opens a server-side stream; Hannah pushes events as they occur.
+     * Pass event_types to filter (empty = all events).
+     * Known event types: "car.parked", "resident.arrived", "resident.departed", "satellite.firmware"
+     */
+    readonly subscribeEvents: {
+        readonly path: "/hannah.HannahService/SubscribeEvents";
+        readonly requestStream: false;
+        readonly responseStream: true;
+        readonly requestSerialize: (value: EventFilter) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => EventFilter;
+        readonly responseSerialize: (value: HannahEvent) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => HannahEvent;
+    };
+    /**
+     * --- Firmware Manager ---
+     * Trigger an immediate OTA update for a satellite (bypasses residents check).
+     */
+    readonly triggerFirmwareUpdate: {
+        readonly path: "/hannah.HannahService/TriggerFirmwareUpdate";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: TriggerFirmwareUpdateRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => TriggerFirmwareUpdateRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    /**
+     * --- Wakeword Capture ---
+     * Put a satellite in audio-capture mode for wakeword training data collection.
+     * While captured: wakeword detection is suspended, speaker is muted, DND is active.
+     * Hannah relays raw PCM chunks from the satellite to the collector via StreamSatelliteAudio.
+     * The stream stays open until the collector disconnects; Hannah then auto-releases the satellite.
+     */
+    readonly requestSatelliteCapture: {
+        readonly path: "/hannah.HannahService/RequestSatelliteCapture";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: SatelliteCaptureRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => SatelliteCaptureRequest;
+        readonly responseSerialize: (value: SatelliteCaptureResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => SatelliteCaptureResponse;
+    };
+    readonly releaseSatelliteCapture: {
+        readonly path: "/hannah.HannahService/ReleaseSatelliteCapture";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: SatelliteCaptureRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => SatelliteCaptureRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    readonly streamSatelliteAudio: {
+        readonly path: "/hannah.HannahService/StreamSatelliteAudio";
+        readonly requestStream: false;
+        readonly responseStream: true;
+        readonly requestSerialize: (value: SatelliteCaptureRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => SatelliteCaptureRequest;
+        readonly responseSerialize: (value: SatelliteAudioChunk) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => SatelliteAudioChunk;
+    };
+    /**
+     * Play a plink sound on the satellite, then hold virtual PTT for record_duration seconds.
+     * Returns after PTT is released — Collector calls this in a loop for guided hey-hannah collection.
+     */
+    readonly triggerPlink: {
+        readonly path: "/hannah.HannahService/TriggerPlink";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: TriggerPlinkRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => TriggerPlinkRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    /**
+     * --- Satellite Proxy (Go gRPC proxy) ---
+     * Bidirectional keepalive stream. Proxy sends heartbeats; Hannah sends TTS
+     * audio commands back (for announcements). While this stream is open, Hannah
+     * disables its own UDP server. If the stream drops, Hannah re-enables UDP.
+     */
+    readonly registerProxy: {
+        readonly path: "/hannah.HannahService/RegisterProxy";
+        readonly requestStream: true;
+        readonly responseStream: true;
+        readonly requestSerialize: (value: ProxyHeartbeat) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => ProxyHeartbeat;
+        readonly responseSerialize: (value: ProxyCommand) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => ProxyCommand;
+    };
+    /**
+     * Submit a complete satellite audio session for processing.
+     * Hannah runs the full pipeline (STT → NLU → TTS → MQTT status) and returns
+     * the result so the proxy can play TTS audio back to the satellite.
+     */
+    readonly submitSatelliteAudio: {
+        readonly path: "/hannah.HannahService/SubmitSatelliteAudio";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: SubmitSatelliteAudioRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => SubmitSatelliteAudioRequest;
+        readonly responseSerialize: (value: SubmitSatelliteAudioResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => SubmitSatelliteAudioResponse;
+    };
+    /**
+     * Notify Hannah that a satellite registered or disconnected via the proxy.
+     * Hannah updates its room registry (hannah/rooms MQTT) immediately.
+     */
+    readonly notifySatelliteRegistered: {
+        readonly path: "/hannah.HannahService/NotifySatelliteRegistered";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: SatelliteRegistration) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => SatelliteRegistration;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    readonly notifySatelliteGone: {
+        readonly path: "/hannah.HannahService/NotifySatelliteGone";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: SatelliteRegistration) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => SatelliteRegistration;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    /**
+     * --- Satellite Provisioning ---
+     * Called by the ioBroker adapter before WebFlash to pre-register a seed + display name + room.
+     * When the satellite first connects with that seed, Hannah links serial → pre-config and clears the seed.
+     */
+    readonly provisionSatellite: {
+        readonly path: "/hannah.HannahService/ProvisionSatellite";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: ProvisionSatelliteRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => ProvisionSatelliteRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    /** --- Speaker Enrollment --- */
+    readonly enrollVoiceprint: {
+        readonly path: "/hannah.HannahService/EnrollVoiceprint";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: EnrollVoiceprintRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => EnrollVoiceprintRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    /**
+     * --- Timer Service ---
+     * Bidirectional stream between the Hannah Timer Service and Hannah Core.
+     * The Timer Service initiates the connection; if Hannah restarts, the service reconnects.
+     * Hannah sends timer commands (create, cancel, list); the service fires events when timers expire.
+     */
+    readonly timerConnect: {
+        readonly path: "/hannah.HannahService/TimerConnect";
+        readonly requestStream: true;
+        readonly responseStream: true;
+        readonly requestSerialize: (value: TimerMessage) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => TimerMessage;
+        readonly responseSerialize: (value: TimerCommand) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => TimerCommand;
+    };
+    /**
+     * --- ioBroker Agent ---
+     * Single bidirectional stream between the HannahAgent ioBroker adapter and Hannah Core.
+     * The adapter pushes state updates (device states, presence, text commands);
+     * Hannah pushes device-control commands and on-demand state-subscription requests back.
+     * The adapter initiates the connection; if Hannah restarts, the adapter reconnects.
+     */
+    readonly agentConnect: {
+        readonly path: "/hannah.HannahService/AgentConnect";
+        readonly requestStream: true;
+        readonly responseStream: true;
+        readonly requestSerialize: (value: AgentMessage) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => AgentMessage;
+        readonly responseSerialize: (value: AgentCommand) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => AgentCommand;
+    };
+};
+export interface HannahServiceServer extends UntypedServiceImplementation {
+    /** --- User Registry --- */
+    getUsers: handleUnaryCall<GetUsersRequest, GetUsersResponse>;
+    getUser: handleUnaryCall<GetUserRequest, UserResponse>;
+    linkAccount: handleUnaryCall<LinkAccountRequest, StatusResponse>;
+    unlinkAccount: handleUnaryCall<UnlinkAccountRequest, StatusResponse>;
+    setTrustLevel: handleUnaryCall<SetTrustLevelRequest, StatusResponse>;
+    setSystemMessages: handleUnaryCall<SetSystemMessagesRequest, StatusResponse>;
+    login: handleUnaryCall<LoginRequest, UserResponse>;
+    /** --- User-Verwaltung (Admin-UI, #27 Phase 6) --- */
+    createUser: handleUnaryCall<CreateUserRequest, CreateUserResponse>;
+    updateUser: handleUnaryCall<UpdateUserRequest, StatusResponse>;
+    deleteUser: handleUnaryCall<DeleteUserRequest, StatusResponse>;
+    /** Residents (Roomies/Guests/Pets) aus dem ioBroker-Adapter-Cache — fürs "Resident verknüpfen"-Dropdown. */
+    getResidents: handleUnaryCall<Empty, GetResidentsResponse>;
+    /**
+     * --- Device Control Menu ---
+     * Returns all rooms and devices with current state — for building control menus.
+     */
+    getDevices: handleUnaryCall<Empty, GetDevicesResponse>;
+    /** Directly set a device state (bypasses NLU). Trust level check is done by the caller. */
+    controlDevice: handleUnaryCall<ControlDeviceRequest, StatusResponse>;
+    /**
+     * --- Control ---
+     * Submit a plain-text command; Hannah processes it through NLU and returns the answer.
+     */
+    submitText: handleUnaryCall<SubmitTextRequest, SubmitTextResponse>;
+    /** Submit a voice message (OGG/Opus bytes); Hannah does STT → NLU → TTS and returns the result. */
+    submitVoice: handleUnaryCall<SubmitVoiceRequest, SubmitVoiceResponse>;
+    /** Send a TTS announcement to one satellite or all ("all"). */
+    announce: handleUnaryCall<AnnounceRequest, StatusResponse>;
+    /**
+     * Send a notification from ioBroker to Hannah. Returns ok=true when queued.
+     * direct=true: skip LLM reformulation. severity: "alert"|"notify"|"info".
+     */
+    notify: handleUnaryCall<AgentNotification, StatusResponse>;
+    /** List all known satellites (DB + live status merged). */
+    getSatellites: handleUnaryCall<Empty, GetSatellitesResponse>;
+    /** --- Satellites (Admin-UI, #27 Phase 2) --- */
+    setSatelliteRoom: handleUnaryCall<SetSatelliteRoomRequest, StatusResponse>;
+    setSatelliteDisplayName: handleUnaryCall<SetSatelliteDisplayNameRequest, StatusResponse>;
+    /** Assign a satellite to a Person (User), independent of its room. #31 */
+    setSatelliteOwner: handleUnaryCall<SetSatelliteOwnerRequest, StatusResponse>;
+    /** Delete existing satellite */
+    deleteSatellite: handleUnaryCall<DeleteSatelliteRequest, StatusResponse>;
+    /** --- Rooms/Groups (Admin-UI, #27 Phase 1) --- */
+    getRooms: handleUnaryCall<Empty, GetRoomsResponse>;
+    getGroups: handleUnaryCall<Empty, GetGroupsResponse>;
+    createGroup: handleUnaryCall<CreateGroupRequest, StatusResponse>;
+    updateGroup: handleUnaryCall<UpdateGroupRequest, StatusResponse>;
+    deleteGroup: handleUnaryCall<DeleteGroupRequest, StatusResponse>;
+    setGroupRooms: handleUnaryCall<SetGroupRoomsRequest, StatusResponse>;
+    /** --- Routines/Triggers (Admin-UI, #27 Phase 4) --- */
+    getRoutines: handleUnaryCall<Empty, GetRoutinesResponse>;
+    createRoutine: handleUnaryCall<CreateRoutineRequest, CreateRoutineResponse>;
+    updateRoutine: handleUnaryCall<UpdateRoutineRequest, StatusResponse>;
+    deleteRoutine: handleUnaryCall<DeleteRoutineRequest, StatusResponse>;
+    getTriggers: handleUnaryCall<Empty, GetTriggersResponse>;
+    createTrigger: handleUnaryCall<CreateTriggerRequest, StatusResponse>;
+    updateTrigger: handleUnaryCall<UpdateTriggerRequest, StatusResponse>;
+    deleteTrigger: handleUnaryCall<DeleteTriggerRequest, StatusResponse>;
+    /** --- Alarms (Wecker, #4) --- */
+    getAlarms: handleUnaryCall<Empty, GetAlarmsResponse>;
+    createAlarm: handleUnaryCall<CreateAlarmRequest, CreateAlarmResponse>;
+    updateAlarm: handleUnaryCall<UpdateAlarmRequest, StatusResponse>;
+    deleteAlarm: handleUnaryCall<DeleteAlarmRequest, StatusResponse>;
+    /**
+     * --- Settings (Admin-UI, #27 Phase 5) ---
+     * CreateSetting/DeleteSetting wurden mit #115 entfernt: ble.tags/cars haben jetzt
+     * eigene Modelle+CRUD (unten), nlu/iobroker.state_names/llm.system_prompt sind immer
+     * vorab bekannt/geseedet — es gibt keinen verbleibenden Bedarf, neue Settings anzulegen.
+     */
+    getSettings: handleUnaryCall<Empty, GetSettingsResponse>;
+    updateConfig: handleUnaryCall<UpdateConfigRequest, StatusResponse>;
+    /** --- BLE Tags (Admin-UI, #115 — eigenes Modell statt Settings-JSON-Blob) --- */
+    getBleTags: handleUnaryCall<Empty, GetBleTagsResponse>;
+    createBleTag: handleUnaryCall<CreateBleTagRequest, CreateBleTagResponse>;
+    updateBleTag: handleUnaryCall<UpdateBleTagRequest, StatusResponse>;
+    deleteBleTag: handleUnaryCall<DeleteBleTagRequest, StatusResponse>;
+    /** --- Cars (Admin-UI, #115 — eigenes Modell + user_to_car-Pivot statt Settings-JSON-Blob) --- */
+    getCars: handleUnaryCall<Empty, GetCarsResponse>;
+    createCar: handleUnaryCall<CreateCarRequest, CreateCarResponse>;
+    updateCar: handleUnaryCall<UpdateCarRequest, StatusResponse>;
+    deleteCar: handleUnaryCall<DeleteCarRequest, StatusResponse>;
+    /**
+     * --- Car state (Live-VW-Connect-Status, unabhängig von der Car-Konfiguration oben) ---
+     * Returns the current cached car state (available=false if no data received yet).
+     */
+    getCarState: handleUnaryCall<Empty, CarStateResponse>;
+    /** Returns all tracked car states (one per configured car). */
+    getAllCarStates: handleUnaryCall<Empty, GetAllCarStatesResponse>;
+    /**
+     * --- Event stream ---
+     * Opens a server-side stream; Hannah pushes events as they occur.
+     * Pass event_types to filter (empty = all events).
+     * Known event types: "car.parked", "resident.arrived", "resident.departed", "satellite.firmware"
+     */
+    subscribeEvents: handleServerStreamingCall<EventFilter, HannahEvent>;
+    /**
+     * --- Firmware Manager ---
+     * Trigger an immediate OTA update for a satellite (bypasses residents check).
+     */
+    triggerFirmwareUpdate: handleUnaryCall<TriggerFirmwareUpdateRequest, StatusResponse>;
+    /**
+     * --- Wakeword Capture ---
+     * Put a satellite in audio-capture mode for wakeword training data collection.
+     * While captured: wakeword detection is suspended, speaker is muted, DND is active.
+     * Hannah relays raw PCM chunks from the satellite to the collector via StreamSatelliteAudio.
+     * The stream stays open until the collector disconnects; Hannah then auto-releases the satellite.
+     */
+    requestSatelliteCapture: handleUnaryCall<SatelliteCaptureRequest, SatelliteCaptureResponse>;
+    releaseSatelliteCapture: handleUnaryCall<SatelliteCaptureRequest, StatusResponse>;
+    streamSatelliteAudio: handleServerStreamingCall<SatelliteCaptureRequest, SatelliteAudioChunk>;
+    /**
+     * Play a plink sound on the satellite, then hold virtual PTT for record_duration seconds.
+     * Returns after PTT is released — Collector calls this in a loop for guided hey-hannah collection.
+     */
+    triggerPlink: handleUnaryCall<TriggerPlinkRequest, StatusResponse>;
+    /**
+     * --- Satellite Proxy (Go gRPC proxy) ---
+     * Bidirectional keepalive stream. Proxy sends heartbeats; Hannah sends TTS
+     * audio commands back (for announcements). While this stream is open, Hannah
+     * disables its own UDP server. If the stream drops, Hannah re-enables UDP.
+     */
+    registerProxy: handleBidiStreamingCall<ProxyHeartbeat, ProxyCommand>;
+    /**
+     * Submit a complete satellite audio session for processing.
+     * Hannah runs the full pipeline (STT → NLU → TTS → MQTT status) and returns
+     * the result so the proxy can play TTS audio back to the satellite.
+     */
+    submitSatelliteAudio: handleUnaryCall<SubmitSatelliteAudioRequest, SubmitSatelliteAudioResponse>;
+    /**
+     * Notify Hannah that a satellite registered or disconnected via the proxy.
+     * Hannah updates its room registry (hannah/rooms MQTT) immediately.
+     */
+    notifySatelliteRegistered: handleUnaryCall<SatelliteRegistration, StatusResponse>;
+    notifySatelliteGone: handleUnaryCall<SatelliteRegistration, StatusResponse>;
+    /**
+     * --- Satellite Provisioning ---
+     * Called by the ioBroker adapter before WebFlash to pre-register a seed + display name + room.
+     * When the satellite first connects with that seed, Hannah links serial → pre-config and clears the seed.
+     */
+    provisionSatellite: handleUnaryCall<ProvisionSatelliteRequest, StatusResponse>;
+    /** --- Speaker Enrollment --- */
+    enrollVoiceprint: handleUnaryCall<EnrollVoiceprintRequest, StatusResponse>;
+    /**
+     * --- Timer Service ---
+     * Bidirectional stream between the Hannah Timer Service and Hannah Core.
+     * The Timer Service initiates the connection; if Hannah restarts, the service reconnects.
+     * Hannah sends timer commands (create, cancel, list); the service fires events when timers expire.
+     */
+    timerConnect: handleBidiStreamingCall<TimerMessage, TimerCommand>;
+    /**
+     * --- ioBroker Agent ---
+     * Single bidirectional stream between the HannahAgent ioBroker adapter and Hannah Core.
+     * The adapter pushes state updates (device states, presence, text commands);
+     * Hannah pushes device-control commands and on-demand state-subscription requests back.
+     * The adapter initiates the connection; if Hannah restarts, the adapter reconnects.
+     */
+    agentConnect: handleBidiStreamingCall<AgentMessage, AgentCommand>;
+}
+export interface HannahServiceClient extends Client {
+    /** --- User Registry --- */
+    getUsers(request: GetUsersRequest, callback: (error: ServiceError | null, response: GetUsersResponse) => void): ClientUnaryCall;
+    getUsers(request: GetUsersRequest, metadata: Metadata, callback: (error: ServiceError | null, response: GetUsersResponse) => void): ClientUnaryCall;
+    getUsers(request: GetUsersRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: GetUsersResponse) => void): ClientUnaryCall;
+    getUser(request: GetUserRequest, callback: (error: ServiceError | null, response: UserResponse) => void): ClientUnaryCall;
+    getUser(request: GetUserRequest, metadata: Metadata, callback: (error: ServiceError | null, response: UserResponse) => void): ClientUnaryCall;
+    getUser(request: GetUserRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: UserResponse) => void): ClientUnaryCall;
+    linkAccount(request: LinkAccountRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    linkAccount(request: LinkAccountRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    linkAccount(request: LinkAccountRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    unlinkAccount(request: UnlinkAccountRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    unlinkAccount(request: UnlinkAccountRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    unlinkAccount(request: UnlinkAccountRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    setTrustLevel(request: SetTrustLevelRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    setTrustLevel(request: SetTrustLevelRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    setTrustLevel(request: SetTrustLevelRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    setSystemMessages(request: SetSystemMessagesRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    setSystemMessages(request: SetSystemMessagesRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    setSystemMessages(request: SetSystemMessagesRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    login(request: LoginRequest, callback: (error: ServiceError | null, response: UserResponse) => void): ClientUnaryCall;
+    login(request: LoginRequest, metadata: Metadata, callback: (error: ServiceError | null, response: UserResponse) => void): ClientUnaryCall;
+    login(request: LoginRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: UserResponse) => void): ClientUnaryCall;
+    /** --- User-Verwaltung (Admin-UI, #27 Phase 6) --- */
+    createUser(request: CreateUserRequest, callback: (error: ServiceError | null, response: CreateUserResponse) => void): ClientUnaryCall;
+    createUser(request: CreateUserRequest, metadata: Metadata, callback: (error: ServiceError | null, response: CreateUserResponse) => void): ClientUnaryCall;
+    createUser(request: CreateUserRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: CreateUserResponse) => void): ClientUnaryCall;
+    updateUser(request: UpdateUserRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    updateUser(request: UpdateUserRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    updateUser(request: UpdateUserRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteUser(request: DeleteUserRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteUser(request: DeleteUserRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteUser(request: DeleteUserRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    /** Residents (Roomies/Guests/Pets) aus dem ioBroker-Adapter-Cache — fürs "Resident verknüpfen"-Dropdown. */
+    getResidents(request: Empty, callback: (error: ServiceError | null, response: GetResidentsResponse) => void): ClientUnaryCall;
+    getResidents(request: Empty, metadata: Metadata, callback: (error: ServiceError | null, response: GetResidentsResponse) => void): ClientUnaryCall;
+    getResidents(request: Empty, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: GetResidentsResponse) => void): ClientUnaryCall;
+    /**
+     * --- Device Control Menu ---
+     * Returns all rooms and devices with current state — for building control menus.
+     */
+    getDevices(request: Empty, callback: (error: ServiceError | null, response: GetDevicesResponse) => void): ClientUnaryCall;
+    getDevices(request: Empty, metadata: Metadata, callback: (error: ServiceError | null, response: GetDevicesResponse) => void): ClientUnaryCall;
+    getDevices(request: Empty, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: GetDevicesResponse) => void): ClientUnaryCall;
+    /** Directly set a device state (bypasses NLU). Trust level check is done by the caller. */
+    controlDevice(request: ControlDeviceRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    controlDevice(request: ControlDeviceRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    controlDevice(request: ControlDeviceRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    /**
+     * --- Control ---
+     * Submit a plain-text command; Hannah processes it through NLU and returns the answer.
+     */
+    submitText(request: SubmitTextRequest, callback: (error: ServiceError | null, response: SubmitTextResponse) => void): ClientUnaryCall;
+    submitText(request: SubmitTextRequest, metadata: Metadata, callback: (error: ServiceError | null, response: SubmitTextResponse) => void): ClientUnaryCall;
+    submitText(request: SubmitTextRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: SubmitTextResponse) => void): ClientUnaryCall;
+    /** Submit a voice message (OGG/Opus bytes); Hannah does STT → NLU → TTS and returns the result. */
+    submitVoice(request: SubmitVoiceRequest, callback: (error: ServiceError | null, response: SubmitVoiceResponse) => void): ClientUnaryCall;
+    submitVoice(request: SubmitVoiceRequest, metadata: Metadata, callback: (error: ServiceError | null, response: SubmitVoiceResponse) => void): ClientUnaryCall;
+    submitVoice(request: SubmitVoiceRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: SubmitVoiceResponse) => void): ClientUnaryCall;
+    /** Send a TTS announcement to one satellite or all ("all"). */
+    announce(request: AnnounceRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    announce(request: AnnounceRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    announce(request: AnnounceRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    /**
+     * Send a notification from ioBroker to Hannah. Returns ok=true when queued.
+     * direct=true: skip LLM reformulation. severity: "alert"|"notify"|"info".
+     */
+    notify(request: AgentNotification, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    notify(request: AgentNotification, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    notify(request: AgentNotification, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    /** List all known satellites (DB + live status merged). */
+    getSatellites(request: Empty, callback: (error: ServiceError | null, response: GetSatellitesResponse) => void): ClientUnaryCall;
+    getSatellites(request: Empty, metadata: Metadata, callback: (error: ServiceError | null, response: GetSatellitesResponse) => void): ClientUnaryCall;
+    getSatellites(request: Empty, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: GetSatellitesResponse) => void): ClientUnaryCall;
+    /** --- Satellites (Admin-UI, #27 Phase 2) --- */
+    setSatelliteRoom(request: SetSatelliteRoomRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    setSatelliteRoom(request: SetSatelliteRoomRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    setSatelliteRoom(request: SetSatelliteRoomRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    setSatelliteDisplayName(request: SetSatelliteDisplayNameRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    setSatelliteDisplayName(request: SetSatelliteDisplayNameRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    setSatelliteDisplayName(request: SetSatelliteDisplayNameRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    /** Assign a satellite to a Person (User), independent of its room. #31 */
+    setSatelliteOwner(request: SetSatelliteOwnerRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    setSatelliteOwner(request: SetSatelliteOwnerRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    setSatelliteOwner(request: SetSatelliteOwnerRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    /** Delete existing satellite */
+    deleteSatellite(request: DeleteSatelliteRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteSatellite(request: DeleteSatelliteRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteSatellite(request: DeleteSatelliteRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    /** --- Rooms/Groups (Admin-UI, #27 Phase 1) --- */
+    getRooms(request: Empty, callback: (error: ServiceError | null, response: GetRoomsResponse) => void): ClientUnaryCall;
+    getRooms(request: Empty, metadata: Metadata, callback: (error: ServiceError | null, response: GetRoomsResponse) => void): ClientUnaryCall;
+    getRooms(request: Empty, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: GetRoomsResponse) => void): ClientUnaryCall;
+    getGroups(request: Empty, callback: (error: ServiceError | null, response: GetGroupsResponse) => void): ClientUnaryCall;
+    getGroups(request: Empty, metadata: Metadata, callback: (error: ServiceError | null, response: GetGroupsResponse) => void): ClientUnaryCall;
+    getGroups(request: Empty, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: GetGroupsResponse) => void): ClientUnaryCall;
+    createGroup(request: CreateGroupRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    createGroup(request: CreateGroupRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    createGroup(request: CreateGroupRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    updateGroup(request: UpdateGroupRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    updateGroup(request: UpdateGroupRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    updateGroup(request: UpdateGroupRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteGroup(request: DeleteGroupRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteGroup(request: DeleteGroupRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteGroup(request: DeleteGroupRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    setGroupRooms(request: SetGroupRoomsRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    setGroupRooms(request: SetGroupRoomsRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    setGroupRooms(request: SetGroupRoomsRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    /** --- Routines/Triggers (Admin-UI, #27 Phase 4) --- */
+    getRoutines(request: Empty, callback: (error: ServiceError | null, response: GetRoutinesResponse) => void): ClientUnaryCall;
+    getRoutines(request: Empty, metadata: Metadata, callback: (error: ServiceError | null, response: GetRoutinesResponse) => void): ClientUnaryCall;
+    getRoutines(request: Empty, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: GetRoutinesResponse) => void): ClientUnaryCall;
+    createRoutine(request: CreateRoutineRequest, callback: (error: ServiceError | null, response: CreateRoutineResponse) => void): ClientUnaryCall;
+    createRoutine(request: CreateRoutineRequest, metadata: Metadata, callback: (error: ServiceError | null, response: CreateRoutineResponse) => void): ClientUnaryCall;
+    createRoutine(request: CreateRoutineRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: CreateRoutineResponse) => void): ClientUnaryCall;
+    updateRoutine(request: UpdateRoutineRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    updateRoutine(request: UpdateRoutineRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    updateRoutine(request: UpdateRoutineRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteRoutine(request: DeleteRoutineRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteRoutine(request: DeleteRoutineRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteRoutine(request: DeleteRoutineRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    getTriggers(request: Empty, callback: (error: ServiceError | null, response: GetTriggersResponse) => void): ClientUnaryCall;
+    getTriggers(request: Empty, metadata: Metadata, callback: (error: ServiceError | null, response: GetTriggersResponse) => void): ClientUnaryCall;
+    getTriggers(request: Empty, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: GetTriggersResponse) => void): ClientUnaryCall;
+    createTrigger(request: CreateTriggerRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    createTrigger(request: CreateTriggerRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    createTrigger(request: CreateTriggerRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    updateTrigger(request: UpdateTriggerRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    updateTrigger(request: UpdateTriggerRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    updateTrigger(request: UpdateTriggerRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteTrigger(request: DeleteTriggerRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteTrigger(request: DeleteTriggerRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteTrigger(request: DeleteTriggerRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    /** --- Alarms (Wecker, #4) --- */
+    getAlarms(request: Empty, callback: (error: ServiceError | null, response: GetAlarmsResponse) => void): ClientUnaryCall;
+    getAlarms(request: Empty, metadata: Metadata, callback: (error: ServiceError | null, response: GetAlarmsResponse) => void): ClientUnaryCall;
+    getAlarms(request: Empty, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: GetAlarmsResponse) => void): ClientUnaryCall;
+    createAlarm(request: CreateAlarmRequest, callback: (error: ServiceError | null, response: CreateAlarmResponse) => void): ClientUnaryCall;
+    createAlarm(request: CreateAlarmRequest, metadata: Metadata, callback: (error: ServiceError | null, response: CreateAlarmResponse) => void): ClientUnaryCall;
+    createAlarm(request: CreateAlarmRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: CreateAlarmResponse) => void): ClientUnaryCall;
+    updateAlarm(request: UpdateAlarmRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    updateAlarm(request: UpdateAlarmRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    updateAlarm(request: UpdateAlarmRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteAlarm(request: DeleteAlarmRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteAlarm(request: DeleteAlarmRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteAlarm(request: DeleteAlarmRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    /**
+     * --- Settings (Admin-UI, #27 Phase 5) ---
+     * CreateSetting/DeleteSetting wurden mit #115 entfernt: ble.tags/cars haben jetzt
+     * eigene Modelle+CRUD (unten), nlu/iobroker.state_names/llm.system_prompt sind immer
+     * vorab bekannt/geseedet — es gibt keinen verbleibenden Bedarf, neue Settings anzulegen.
+     */
+    getSettings(request: Empty, callback: (error: ServiceError | null, response: GetSettingsResponse) => void): ClientUnaryCall;
+    getSettings(request: Empty, metadata: Metadata, callback: (error: ServiceError | null, response: GetSettingsResponse) => void): ClientUnaryCall;
+    getSettings(request: Empty, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: GetSettingsResponse) => void): ClientUnaryCall;
+    updateConfig(request: UpdateConfigRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    updateConfig(request: UpdateConfigRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    updateConfig(request: UpdateConfigRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    /** --- BLE Tags (Admin-UI, #115 — eigenes Modell statt Settings-JSON-Blob) --- */
+    getBleTags(request: Empty, callback: (error: ServiceError | null, response: GetBleTagsResponse) => void): ClientUnaryCall;
+    getBleTags(request: Empty, metadata: Metadata, callback: (error: ServiceError | null, response: GetBleTagsResponse) => void): ClientUnaryCall;
+    getBleTags(request: Empty, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: GetBleTagsResponse) => void): ClientUnaryCall;
+    createBleTag(request: CreateBleTagRequest, callback: (error: ServiceError | null, response: CreateBleTagResponse) => void): ClientUnaryCall;
+    createBleTag(request: CreateBleTagRequest, metadata: Metadata, callback: (error: ServiceError | null, response: CreateBleTagResponse) => void): ClientUnaryCall;
+    createBleTag(request: CreateBleTagRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: CreateBleTagResponse) => void): ClientUnaryCall;
+    updateBleTag(request: UpdateBleTagRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    updateBleTag(request: UpdateBleTagRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    updateBleTag(request: UpdateBleTagRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteBleTag(request: DeleteBleTagRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteBleTag(request: DeleteBleTagRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteBleTag(request: DeleteBleTagRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    /** --- Cars (Admin-UI, #115 — eigenes Modell + user_to_car-Pivot statt Settings-JSON-Blob) --- */
+    getCars(request: Empty, callback: (error: ServiceError | null, response: GetCarsResponse) => void): ClientUnaryCall;
+    getCars(request: Empty, metadata: Metadata, callback: (error: ServiceError | null, response: GetCarsResponse) => void): ClientUnaryCall;
+    getCars(request: Empty, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: GetCarsResponse) => void): ClientUnaryCall;
+    createCar(request: CreateCarRequest, callback: (error: ServiceError | null, response: CreateCarResponse) => void): ClientUnaryCall;
+    createCar(request: CreateCarRequest, metadata: Metadata, callback: (error: ServiceError | null, response: CreateCarResponse) => void): ClientUnaryCall;
+    createCar(request: CreateCarRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: CreateCarResponse) => void): ClientUnaryCall;
+    updateCar(request: UpdateCarRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    updateCar(request: UpdateCarRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    updateCar(request: UpdateCarRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteCar(request: DeleteCarRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteCar(request: DeleteCarRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteCar(request: DeleteCarRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    /**
+     * --- Car state (Live-VW-Connect-Status, unabhängig von der Car-Konfiguration oben) ---
+     * Returns the current cached car state (available=false if no data received yet).
+     */
+    getCarState(request: Empty, callback: (error: ServiceError | null, response: CarStateResponse) => void): ClientUnaryCall;
+    getCarState(request: Empty, metadata: Metadata, callback: (error: ServiceError | null, response: CarStateResponse) => void): ClientUnaryCall;
+    getCarState(request: Empty, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: CarStateResponse) => void): ClientUnaryCall;
+    /** Returns all tracked car states (one per configured car). */
+    getAllCarStates(request: Empty, callback: (error: ServiceError | null, response: GetAllCarStatesResponse) => void): ClientUnaryCall;
+    getAllCarStates(request: Empty, metadata: Metadata, callback: (error: ServiceError | null, response: GetAllCarStatesResponse) => void): ClientUnaryCall;
+    getAllCarStates(request: Empty, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: GetAllCarStatesResponse) => void): ClientUnaryCall;
+    /**
+     * --- Event stream ---
+     * Opens a server-side stream; Hannah pushes events as they occur.
+     * Pass event_types to filter (empty = all events).
+     * Known event types: "car.parked", "resident.arrived", "resident.departed", "satellite.firmware"
+     */
+    subscribeEvents(request: EventFilter, options?: Partial<CallOptions>): ClientReadableStream<HannahEvent>;
+    subscribeEvents(request: EventFilter, metadata?: Metadata, options?: Partial<CallOptions>): ClientReadableStream<HannahEvent>;
+    /**
+     * --- Firmware Manager ---
+     * Trigger an immediate OTA update for a satellite (bypasses residents check).
+     */
+    triggerFirmwareUpdate(request: TriggerFirmwareUpdateRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    triggerFirmwareUpdate(request: TriggerFirmwareUpdateRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    triggerFirmwareUpdate(request: TriggerFirmwareUpdateRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    /**
+     * --- Wakeword Capture ---
+     * Put a satellite in audio-capture mode for wakeword training data collection.
+     * While captured: wakeword detection is suspended, speaker is muted, DND is active.
+     * Hannah relays raw PCM chunks from the satellite to the collector via StreamSatelliteAudio.
+     * The stream stays open until the collector disconnects; Hannah then auto-releases the satellite.
+     */
+    requestSatelliteCapture(request: SatelliteCaptureRequest, callback: (error: ServiceError | null, response: SatelliteCaptureResponse) => void): ClientUnaryCall;
+    requestSatelliteCapture(request: SatelliteCaptureRequest, metadata: Metadata, callback: (error: ServiceError | null, response: SatelliteCaptureResponse) => void): ClientUnaryCall;
+    requestSatelliteCapture(request: SatelliteCaptureRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: SatelliteCaptureResponse) => void): ClientUnaryCall;
+    releaseSatelliteCapture(request: SatelliteCaptureRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    releaseSatelliteCapture(request: SatelliteCaptureRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    releaseSatelliteCapture(request: SatelliteCaptureRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    streamSatelliteAudio(request: SatelliteCaptureRequest, options?: Partial<CallOptions>): ClientReadableStream<SatelliteAudioChunk>;
+    streamSatelliteAudio(request: SatelliteCaptureRequest, metadata?: Metadata, options?: Partial<CallOptions>): ClientReadableStream<SatelliteAudioChunk>;
+    /**
+     * Play a plink sound on the satellite, then hold virtual PTT for record_duration seconds.
+     * Returns after PTT is released — Collector calls this in a loop for guided hey-hannah collection.
+     */
+    triggerPlink(request: TriggerPlinkRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    triggerPlink(request: TriggerPlinkRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    triggerPlink(request: TriggerPlinkRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    /**
+     * --- Satellite Proxy (Go gRPC proxy) ---
+     * Bidirectional keepalive stream. Proxy sends heartbeats; Hannah sends TTS
+     * audio commands back (for announcements). While this stream is open, Hannah
+     * disables its own UDP server. If the stream drops, Hannah re-enables UDP.
+     */
+    registerProxy(): ClientDuplexStream<ProxyHeartbeat, ProxyCommand>;
+    registerProxy(options: Partial<CallOptions>): ClientDuplexStream<ProxyHeartbeat, ProxyCommand>;
+    registerProxy(metadata: Metadata, options?: Partial<CallOptions>): ClientDuplexStream<ProxyHeartbeat, ProxyCommand>;
+    /**
+     * Submit a complete satellite audio session for processing.
+     * Hannah runs the full pipeline (STT → NLU → TTS → MQTT status) and returns
+     * the result so the proxy can play TTS audio back to the satellite.
+     */
+    submitSatelliteAudio(request: SubmitSatelliteAudioRequest, callback: (error: ServiceError | null, response: SubmitSatelliteAudioResponse) => void): ClientUnaryCall;
+    submitSatelliteAudio(request: SubmitSatelliteAudioRequest, metadata: Metadata, callback: (error: ServiceError | null, response: SubmitSatelliteAudioResponse) => void): ClientUnaryCall;
+    submitSatelliteAudio(request: SubmitSatelliteAudioRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: SubmitSatelliteAudioResponse) => void): ClientUnaryCall;
+    /**
+     * Notify Hannah that a satellite registered or disconnected via the proxy.
+     * Hannah updates its room registry (hannah/rooms MQTT) immediately.
+     */
+    notifySatelliteRegistered(request: SatelliteRegistration, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    notifySatelliteRegistered(request: SatelliteRegistration, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    notifySatelliteRegistered(request: SatelliteRegistration, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    notifySatelliteGone(request: SatelliteRegistration, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    notifySatelliteGone(request: SatelliteRegistration, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    notifySatelliteGone(request: SatelliteRegistration, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    /**
+     * --- Satellite Provisioning ---
+     * Called by the ioBroker adapter before WebFlash to pre-register a seed + display name + room.
+     * When the satellite first connects with that seed, Hannah links serial → pre-config and clears the seed.
+     */
+    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 --- */
+    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;
+    /**
+     * --- Timer Service ---
+     * Bidirectional stream between the Hannah Timer Service and Hannah Core.
+     * The Timer Service initiates the connection; if Hannah restarts, the service reconnects.
+     * Hannah sends timer commands (create, cancel, list); the service fires events when timers expire.
+     */
+    timerConnect(): ClientDuplexStream<TimerMessage, TimerCommand>;
+    timerConnect(options: Partial<CallOptions>): ClientDuplexStream<TimerMessage, TimerCommand>;
+    timerConnect(metadata: Metadata, options?: Partial<CallOptions>): ClientDuplexStream<TimerMessage, TimerCommand>;
+    /**
+     * --- ioBroker Agent ---
+     * Single bidirectional stream between the HannahAgent ioBroker adapter and Hannah Core.
+     * The adapter pushes state updates (device states, presence, text commands);
+     * Hannah pushes device-control commands and on-demand state-subscription requests back.
+     * The adapter initiates the connection; if Hannah restarts, the adapter reconnects.
+     */
+    agentConnect(): ClientDuplexStream<AgentMessage, AgentCommand>;
+    agentConnect(options: Partial<CallOptions>): ClientDuplexStream<AgentMessage, AgentCommand>;
+    agentConnect(metadata: Metadata, options?: Partial<CallOptions>): ClientDuplexStream<AgentMessage, AgentCommand>;
+}
+export declare const HannahServiceClient: {
+    new (address: string, credentials: ChannelCredentials, options?: Partial<ClientOptions>): HannahServiceClient;
+    service: typeof HannahServiceService;
+    serviceName: string;
+};