@m1kad0/hannah-proto 4.5.0 → 4.6.1

package/dist/v1/hannah.d.ts

@@ -0,0 +1,1644 @@
+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 { ActivityAudioChunk, ListActivityLogRequest, ListActivityLogResponse, StreamActivityAudioRequest } from "./activity_log";
+import { AgentCommand, AgentMessage, AgentNotification } from "./agent";
+import { AutomationCommand, AutomationMessage } from "./automation";
+import { CarStateResponse, GetAllCarStatesResponse } from "./car_state";
+import { ChannelCommand, ChannelMessage, GetChannelsResponse } from "./channel";
+import { AnnounceRequest, CreateAlarmRequest, CreateAlarmResponse, CreateBleTagRequest, CreateBleTagResponse, CreateCarRequest, CreateCarResponse, CreateGroupRequest, CreatePresenceSourceRequest, CreatePresenceSourceResponse, CreateTriggerRequest, DeleteAlarmRequest, DeleteBleTagRequest, DeleteCarRequest, DeleteGroupRequest, DeletePresenceSourceRequest, DeleteTriggerRequest, GetAlarmsResponse, GetBleTagsResponse, GetCarsResponse, GetGroupsResponse, GetPresenceSourcesResponse, GetRoomsResponse, GetSettingsResponse, GetTriggersResponse, SetGroupSatellitesRequest, SubmitTextRequest, SubmitTextResponse, SubmitVoiceRequest, SubmitVoiceResponse, UpdateAlarmRequest, UpdateBleTagRequest, UpdateCarRequest, UpdateConfigRequest, UpdateGroupRequest, UpdatePresenceSourceRequest, UpdateTriggerRequest } from "./control";
+import { ControlDeviceRequest, GetDevicesResponse } from "./device_control_menu";
+import { EventFilter, HannahEvent, TriggerFirmwareUpdateRequest, TriggerSatelliteRestartRequest } from "./event_stream";
+import { InfrastructureFilter, InfrastructureMessage, LogCollectorCommand, LogCollectorMessage } from "./infrastructure";
+import { CreateMessageRequest, DeleteMessageRequest, ListMessagesRequest, ListMessagesResponse } from "./messages";
+import { DeleteSatelliteRequest, GetSatellitesResponse, SetSatelliteDisplayNameRequest, SetSatelliteOwnerRequest, SetSatelliteRoomRequest, SetSatelliteSmalltalkFollowupRequest } from "./satellite";
+import { ProvisionSatelliteRequest } from "./satellite_provisioning";
+import { ProxyCommand, ProxyHeartbeat, SatelliteRegistration, SubmitSatelliteAudioRequest, SubmitSatelliteAudioResponse } from "./satellite_proxy";
+import { Empty, StatusResponse } from "./shared";
+import { EnrollVoiceprintRequest, StartVoiceEnrollmentRequest } from "./speaker_enrollment";
+import { DeleteTimerRequest, GetTimersRequest, GetTimersResponse } from "./timer_admin";
+import { TimerCommand, TimerMessage } from "./timer_service";
+import { CreateLinkTokenRequest, CreateLinkTokenResponse, CreateUserRequest, CreateUserResponse, DeleteUserRequest, GetResidentsResponse, GetUserRequest, GetUsersRequest, GetUsersResponse, LinkAccountRequest, LoginRequest, SetAutomationRequest, SetSystemMessagesRequest, SetTrustLevelRequest, UnlinkAccountRequest, UpdateUserRequest, UserResponse } from "./user_registry";
+import { CaptureCommand, CollectorMessage, SatelliteAudioChunk, SatelliteCaptureRequest, SatelliteCaptureResponse, TriggerPlinkRequest } from "./wakeword_capture";
+export declare const protobufPackage = "hannah.v1";
+export type HannahServiceService = typeof HannahServiceService;
+export declare const HannahServiceService: {
+    /** --- User Registry --- */
+    readonly getUsers: {
+        readonly path: "/hannah.v1.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.v1.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.v1.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.v1.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;
+    };
+    /**
+     * One-time token for linking an account via the service's adapter (e.g. Telegram deep link).
+     * Redeemed by the adapter over ChannelConnect.
+     */
+    readonly createLinkToken: {
+        readonly path: "/hannah.v1.HannahService/CreateLinkToken";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: CreateLinkTokenRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => CreateLinkTokenRequest;
+        readonly responseSerialize: (value: CreateLinkTokenResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => CreateLinkTokenResponse;
+    };
+    readonly setTrustLevel: {
+        readonly path: "/hannah.v1.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.v1.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;
+    };
+    /**
+     * Enable/disable an automation service (e.g. "telegram_autoresponder") for a user.
+     * Pushes a live update to any connected AutomationConnect stream registered for it.
+     */
+    readonly setAutomation: {
+        readonly path: "/hannah.v1.HannahService/SetAutomation";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: SetAutomationRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => SetAutomationRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    readonly login: {
+        readonly path: "/hannah.v1.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.v1.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.v1.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.v1.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.v1.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.v1.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.v1.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.v1.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.v1.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.v1.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.v1.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.v1.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.v1.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.v1.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.v1.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;
+    };
+    /**
+     * Toggle whether the satellite's mic reopens after a Smalltalk answer instead of
+     * waiting for wake-word/PTT again (silence-timeout lives in the satellite firmware). #158
+     */
+    readonly setSatelliteSmalltalkFollowup: {
+        readonly path: "/hannah.v1.HannahService/SetSatelliteSmalltalkFollowup";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: SetSatelliteSmalltalkFollowupRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => SetSatelliteSmalltalkFollowupRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    /** Delete existing satellite */
+    readonly deleteSatellite: {
+        readonly path: "/hannah.v1.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.v1.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.v1.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.v1.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.v1.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.v1.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 setGroupSatellites: {
+        readonly path: "/hannah.v1.HannahService/SetGroupSatellites";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: SetGroupSatellitesRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => SetGroupSatellitesRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    /** --- Triggers (Admin-UI, #28) --- */
+    readonly getTriggers: {
+        readonly path: "/hannah.v1.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.v1.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.v1.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.v1.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.v1.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.v1.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.v1.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.v1.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.v1.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.v1.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.v1.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.v1.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.v1.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.v1.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;
+    };
+    /** --- Presence Sources (Admin-UI, hannah#294 — presence fusion) --- */
+    readonly getPresenceSources: {
+        readonly path: "/hannah.v1.HannahService/GetPresenceSources";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: Empty) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => Empty;
+        readonly responseSerialize: (value: GetPresenceSourcesResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => GetPresenceSourcesResponse;
+    };
+    readonly createPresenceSource: {
+        readonly path: "/hannah.v1.HannahService/CreatePresenceSource";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: CreatePresenceSourceRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => CreatePresenceSourceRequest;
+        readonly responseSerialize: (value: CreatePresenceSourceResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => CreatePresenceSourceResponse;
+    };
+    readonly updatePresenceSource: {
+        readonly path: "/hannah.v1.HannahService/UpdatePresenceSource";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: UpdatePresenceSourceRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => UpdatePresenceSourceRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    readonly deletePresenceSource: {
+        readonly path: "/hannah.v1.HannahService/DeletePresenceSource";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: DeletePresenceSourceRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => DeletePresenceSourceRequest;
+        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.v1.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.v1.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.v1.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.v1.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.v1.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.v1.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.v1.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.v1.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;
+    };
+    /**
+     * Trigger an ordered remote restart (esp_restart()) of a satellite over MQTT.
+     * Diagnostic/rejuvenation tool for suspected resource exhaustion (heap fragmentation
+     * after long uptime) — works even when the satellite's OTA/webserver no longer
+     * respond, since MQTT stays alive in that failure mode.
+     */
+    readonly triggerSatelliteRestart: {
+        readonly path: "/hannah.v1.HannahService/TriggerSatelliteRestart";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: TriggerSatelliteRestartRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => TriggerSatelliteRestartRequest;
+        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.v1.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.v1.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.v1.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.v1.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;
+    };
+    /**
+     * Bidirectional stream between the Collector and Hannah Core, analogous to TimerConnect.
+     * The Collector initiates and holds the connection open; Hannah pushes CaptureCommands
+     * down to start/stop satellite captures instead of the Collector polling for them.
+     */
+    readonly collectorConnect: {
+        readonly path: "/hannah.v1.HannahService/CollectorConnect";
+        readonly requestStream: true;
+        readonly responseStream: true;
+        readonly requestSerialize: (value: CollectorMessage) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => CollectorMessage;
+        readonly responseSerialize: (value: CaptureCommand) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => CaptureCommand;
+    };
+    /**
+     * Unary trigger for external callers (e.g. WebUI) that can't hold a CollectorConnect
+     * stream themselves — Hannah relays the command over its own CollectorConnect stream
+     * to the connected Collector. Fails with ok=false if no Collector is connected.
+     */
+    readonly triggerCollectorCapture: {
+        readonly path: "/hannah.v1.HannahService/TriggerCollectorCapture";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: CaptureCommand) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => CaptureCommand;
+        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.v1.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.v1.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.v1.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.v1.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.v1.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 ---
+     * 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.v1.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.v1.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.v1.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;
+    };
+    /**
+     * --- Timer Admin ---
+     * Query and cancel timers independent of the TimerConnect stream — e.g. for an
+     * Admin-UI or Telegram bot listing/cancelling a user's active timers.
+     */
+    readonly getTimers: {
+        readonly path: "/hannah.v1.HannahService/GetTimers";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: GetTimersRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => GetTimersRequest;
+        readonly responseSerialize: (value: GetTimersResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => GetTimersResponse;
+    };
+    readonly deleteTimer: {
+        readonly path: "/hannah.v1.HannahService/DeleteTimer";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: DeleteTimerRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => DeleteTimerRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    /**
+     * --- 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.v1.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;
+    };
+    /**
+     * --- Automations ---
+     * Bidirectional stream for external automation services (e.g. telegram_autoresponder).
+     * The service sends an AutomationRegister identifying itself, then Hannah replies with
+     * an AutomationSnapshot (all users with it currently enabled) followed by live
+     * AutomationStateChanged deltas as users toggle it via SetAutomation/voice.
+     * Chosen over SubscribeEvents so a reconnecting service always gets a fresh snapshot
+     * instead of missing state changes that happened while it was offline.
+     */
+    readonly automationConnect: {
+        readonly path: "/hannah.v1.HannahService/AutomationConnect";
+        readonly requestStream: true;
+        readonly responseStream: true;
+        readonly requestSerialize: (value: AutomationMessage) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => AutomationMessage;
+        readonly responseSerialize: (value: AutomationCommand) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => AutomationCommand;
+    };
+    /**
+     * --- Channels ---
+     * Bidirectional stream for channel adapters (e.g. the Telegram service). The adapter
+     * sends a ChannelRegister and keeps the stream open; it counts as available exactly as
+     * long as the stream is open. A second registration for the same service replaces the
+     * first. Link tokens (CreateLinkToken) are redeemed over this stream.
+     */
+    readonly channelConnect: {
+        readonly path: "/hannah.v1.HannahService/ChannelConnect";
+        readonly requestStream: true;
+        readonly responseStream: true;
+        readonly requestSerialize: (value: ChannelMessage) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => ChannelMessage;
+        readonly responseSerialize: (value: ChannelCommand) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => ChannelCommand;
+    };
+    /** Currently connected channel adapters and whether they support account linking. */
+    readonly getChannels: {
+        readonly path: "/hannah.v1.HannahService/GetChannels";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: Empty) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => Empty;
+        readonly responseSerialize: (value: GetChannelsResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => GetChannelsResponse;
+    };
+    /**
+     * --- Infrastructure ---
+     * Service discovery for components: Hannah sends an InfrastructureSnapshot of all
+     * currently available infrastructure services (e.g. the log collector) right after
+     * subscribing, followed by ServiceAvailable/ServiceUnavailable deltas.
+     */
+    readonly subscribeInfrastructure: {
+        readonly path: "/hannah.v1.HannahService/SubscribeInfrastructure";
+        readonly requestStream: false;
+        readonly responseStream: true;
+        readonly requestSerialize: (value: InfrastructureFilter) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => InfrastructureFilter;
+        readonly responseSerialize: (value: InfrastructureMessage) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => InfrastructureMessage;
+    };
+    /**
+     * Bidirectional stream for the log collector. The collector sends a LogCollectorRegister
+     * and keeps the stream open; it counts as available exactly as long as the stream is
+     * open, and a second registration for the same instance replaces the first (same
+     * semantics as ChannelConnect). Not related to CollectorConnect (wakeword capture).
+     */
+    readonly logCollectorConnect: {
+        readonly path: "/hannah.v1.HannahService/LogCollectorConnect";
+        readonly requestStream: true;
+        readonly responseStream: true;
+        readonly requestSerialize: (value: LogCollectorMessage) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => LogCollectorMessage;
+        readonly responseSerialize: (value: LogCollectorCommand) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => LogCollectorCommand;
+    };
+    /**
+     * --- Activity Log ---
+     * Read access to the Activity Log (#220) for external consumers (WebUI). List returns
+     * full entry detail inline (transcript, intent + intent_meta, answer text) with
+     * cursor-based pagination; audio is fetched separately, decoded server-side from the
+     * stored WAV and streamed as raw PCM chunks.
+     */
+    readonly listActivityLog: {
+        readonly path: "/hannah.v1.HannahService/ListActivityLog";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: ListActivityLogRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => ListActivityLogRequest;
+        readonly responseSerialize: (value: ListActivityLogResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => ListActivityLogResponse;
+    };
+    readonly streamActivityAudio: {
+        readonly path: "/hannah.v1.HannahService/StreamActivityAudio";
+        readonly requestStream: false;
+        readonly responseStream: true;
+        readonly requestSerialize: (value: StreamActivityAudioRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => StreamActivityAudioRequest;
+        readonly responseSerialize: (value: ActivityAudioChunk) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => ActivityAudioChunk;
+    };
+    /** --- Messages (passive per-user mailbox, third notification type) --- */
+    readonly createMessage: {
+        readonly path: "/hannah.v1.HannahService/CreateMessage";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: CreateMessageRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => CreateMessageRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+    readonly listMessages: {
+        readonly path: "/hannah.v1.HannahService/ListMessages";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: ListMessagesRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => ListMessagesRequest;
+        readonly responseSerialize: (value: ListMessagesResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => ListMessagesResponse;
+    };
+    readonly deleteMessage: {
+        readonly path: "/hannah.v1.HannahService/DeleteMessage";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: DeleteMessageRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => DeleteMessageRequest;
+        readonly responseSerialize: (value: StatusResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => StatusResponse;
+    };
+};
+export interface HannahServiceServer extends UntypedServiceImplementation {
+    /** --- User Registry --- */
+    getUsers: handleUnaryCall<GetUsersRequest, GetUsersResponse>;
+    getUser: handleUnaryCall<GetUserRequest, UserResponse>;
+    linkAccount: handleUnaryCall<LinkAccountRequest, StatusResponse>;
+    unlinkAccount: handleUnaryCall<UnlinkAccountRequest, StatusResponse>;
+    /**
+     * One-time token for linking an account via the service's adapter (e.g. Telegram deep link).
+     * Redeemed by the adapter over ChannelConnect.
+     */
+    createLinkToken: handleUnaryCall<CreateLinkTokenRequest, CreateLinkTokenResponse>;
+    setTrustLevel: handleUnaryCall<SetTrustLevelRequest, StatusResponse>;
+    setSystemMessages: handleUnaryCall<SetSystemMessagesRequest, StatusResponse>;
+    /**
+     * Enable/disable an automation service (e.g. "telegram_autoresponder") for a user.
+     * Pushes a live update to any connected AutomationConnect stream registered for it.
+     */
+    setAutomation: handleUnaryCall<SetAutomationRequest, 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>;
+    /**
+     * Toggle whether the satellite's mic reopens after a Smalltalk answer instead of
+     * waiting for wake-word/PTT again (silence-timeout lives in the satellite firmware). #158
+     */
+    setSatelliteSmalltalkFollowup: handleUnaryCall<SetSatelliteSmalltalkFollowupRequest, 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>;
+    setGroupSatellites: handleUnaryCall<SetGroupSatellitesRequest, StatusResponse>;
+    /** --- Triggers (Admin-UI, #28) --- */
+    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>;
+    /** --- Presence Sources (Admin-UI, hannah#294 — presence fusion) --- */
+    getPresenceSources: handleUnaryCall<Empty, GetPresenceSourcesResponse>;
+    createPresenceSource: handleUnaryCall<CreatePresenceSourceRequest, CreatePresenceSourceResponse>;
+    updatePresenceSource: handleUnaryCall<UpdatePresenceSourceRequest, StatusResponse>;
+    deletePresenceSource: handleUnaryCall<DeletePresenceSourceRequest, 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>;
+    /**
+     * Trigger an ordered remote restart (esp_restart()) of a satellite over MQTT.
+     * Diagnostic/rejuvenation tool for suspected resource exhaustion (heap fragmentation
+     * after long uptime) — works even when the satellite's OTA/webserver no longer
+     * respond, since MQTT stays alive in that failure mode.
+     */
+    triggerSatelliteRestart: handleUnaryCall<TriggerSatelliteRestartRequest, 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>;
+    /**
+     * Bidirectional stream between the Collector and Hannah Core, analogous to TimerConnect.
+     * The Collector initiates and holds the connection open; Hannah pushes CaptureCommands
+     * down to start/stop satellite captures instead of the Collector polling for them.
+     */
+    collectorConnect: handleBidiStreamingCall<CollectorMessage, CaptureCommand>;
+    /**
+     * Unary trigger for external callers (e.g. WebUI) that can't hold a CollectorConnect
+     * stream themselves — Hannah relays the command over its own CollectorConnect stream
+     * to the connected Collector. Fails with ok=false if no Collector is connected.
+     */
+    triggerCollectorCapture: handleUnaryCall<CaptureCommand, 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 ---
+     * 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 ---
+     * 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>;
+    /**
+     * --- Timer Admin ---
+     * Query and cancel timers independent of the TimerConnect stream — e.g. for an
+     * Admin-UI or Telegram bot listing/cancelling a user's active timers.
+     */
+    getTimers: handleUnaryCall<GetTimersRequest, GetTimersResponse>;
+    deleteTimer: handleUnaryCall<DeleteTimerRequest, StatusResponse>;
+    /**
+     * --- 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>;
+    /**
+     * --- Automations ---
+     * Bidirectional stream for external automation services (e.g. telegram_autoresponder).
+     * The service sends an AutomationRegister identifying itself, then Hannah replies with
+     * an AutomationSnapshot (all users with it currently enabled) followed by live
+     * AutomationStateChanged deltas as users toggle it via SetAutomation/voice.
+     * Chosen over SubscribeEvents so a reconnecting service always gets a fresh snapshot
+     * instead of missing state changes that happened while it was offline.
+     */
+    automationConnect: handleBidiStreamingCall<AutomationMessage, AutomationCommand>;
+    /**
+     * --- Channels ---
+     * Bidirectional stream for channel adapters (e.g. the Telegram service). The adapter
+     * sends a ChannelRegister and keeps the stream open; it counts as available exactly as
+     * long as the stream is open. A second registration for the same service replaces the
+     * first. Link tokens (CreateLinkToken) are redeemed over this stream.
+     */
+    channelConnect: handleBidiStreamingCall<ChannelMessage, ChannelCommand>;
+    /** Currently connected channel adapters and whether they support account linking. */
+    getChannels: handleUnaryCall<Empty, GetChannelsResponse>;
+    /**
+     * --- Infrastructure ---
+     * Service discovery for components: Hannah sends an InfrastructureSnapshot of all
+     * currently available infrastructure services (e.g. the log collector) right after
+     * subscribing, followed by ServiceAvailable/ServiceUnavailable deltas.
+     */
+    subscribeInfrastructure: handleServerStreamingCall<InfrastructureFilter, InfrastructureMessage>;
+    /**
+     * Bidirectional stream for the log collector. The collector sends a LogCollectorRegister
+     * and keeps the stream open; it counts as available exactly as long as the stream is
+     * open, and a second registration for the same instance replaces the first (same
+     * semantics as ChannelConnect). Not related to CollectorConnect (wakeword capture).
+     */
+    logCollectorConnect: handleBidiStreamingCall<LogCollectorMessage, LogCollectorCommand>;
+    /**
+     * --- Activity Log ---
+     * Read access to the Activity Log (#220) for external consumers (WebUI). List returns
+     * full entry detail inline (transcript, intent + intent_meta, answer text) with
+     * cursor-based pagination; audio is fetched separately, decoded server-side from the
+     * stored WAV and streamed as raw PCM chunks.
+     */
+    listActivityLog: handleUnaryCall<ListActivityLogRequest, ListActivityLogResponse>;
+    streamActivityAudio: handleServerStreamingCall<StreamActivityAudioRequest, ActivityAudioChunk>;
+    /** --- Messages (passive per-user mailbox, third notification type) --- */
+    createMessage: handleUnaryCall<CreateMessageRequest, StatusResponse>;
+    listMessages: handleUnaryCall<ListMessagesRequest, ListMessagesResponse>;
+    deleteMessage: handleUnaryCall<DeleteMessageRequest, StatusResponse>;
+}
+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;
+    /**
+     * One-time token for linking an account via the service's adapter (e.g. Telegram deep link).
+     * Redeemed by the adapter over ChannelConnect.
+     */
+    createLinkToken(request: CreateLinkTokenRequest, callback: (error: ServiceError | null, response: CreateLinkTokenResponse) => void): ClientUnaryCall;
+    createLinkToken(request: CreateLinkTokenRequest, metadata: Metadata, callback: (error: ServiceError | null, response: CreateLinkTokenResponse) => void): ClientUnaryCall;
+    createLinkToken(request: CreateLinkTokenRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: CreateLinkTokenResponse) => 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;
+    /**
+     * Enable/disable an automation service (e.g. "telegram_autoresponder") for a user.
+     * Pushes a live update to any connected AutomationConnect stream registered for it.
+     */
+    setAutomation(request: SetAutomationRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    setAutomation(request: SetAutomationRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    setAutomation(request: SetAutomationRequest, 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;
+    /**
+     * Toggle whether the satellite's mic reopens after a Smalltalk answer instead of
+     * waiting for wake-word/PTT again (silence-timeout lives in the satellite firmware). #158
+     */
+    setSatelliteSmalltalkFollowup(request: SetSatelliteSmalltalkFollowupRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    setSatelliteSmalltalkFollowup(request: SetSatelliteSmalltalkFollowupRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    setSatelliteSmalltalkFollowup(request: SetSatelliteSmalltalkFollowupRequest, 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;
+    setGroupSatellites(request: SetGroupSatellitesRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    setGroupSatellites(request: SetGroupSatellitesRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    setGroupSatellites(request: SetGroupSatellitesRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    /** --- Triggers (Admin-UI, #28) --- */
+    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;
+    /** --- Presence Sources (Admin-UI, hannah#294 — presence fusion) --- */
+    getPresenceSources(request: Empty, callback: (error: ServiceError | null, response: GetPresenceSourcesResponse) => void): ClientUnaryCall;
+    getPresenceSources(request: Empty, metadata: Metadata, callback: (error: ServiceError | null, response: GetPresenceSourcesResponse) => void): ClientUnaryCall;
+    getPresenceSources(request: Empty, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: GetPresenceSourcesResponse) => void): ClientUnaryCall;
+    createPresenceSource(request: CreatePresenceSourceRequest, callback: (error: ServiceError | null, response: CreatePresenceSourceResponse) => void): ClientUnaryCall;
+    createPresenceSource(request: CreatePresenceSourceRequest, metadata: Metadata, callback: (error: ServiceError | null, response: CreatePresenceSourceResponse) => void): ClientUnaryCall;
+    createPresenceSource(request: CreatePresenceSourceRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: CreatePresenceSourceResponse) => void): ClientUnaryCall;
+    updatePresenceSource(request: UpdatePresenceSourceRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    updatePresenceSource(request: UpdatePresenceSourceRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    updatePresenceSource(request: UpdatePresenceSourceRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deletePresenceSource(request: DeletePresenceSourceRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deletePresenceSource(request: DeletePresenceSourceRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deletePresenceSource(request: DeletePresenceSourceRequest, 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;
+    /**
+     * Trigger an ordered remote restart (esp_restart()) of a satellite over MQTT.
+     * Diagnostic/rejuvenation tool for suspected resource exhaustion (heap fragmentation
+     * after long uptime) — works even when the satellite's OTA/webserver no longer
+     * respond, since MQTT stays alive in that failure mode.
+     */
+    triggerSatelliteRestart(request: TriggerSatelliteRestartRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    triggerSatelliteRestart(request: TriggerSatelliteRestartRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    triggerSatelliteRestart(request: TriggerSatelliteRestartRequest, 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;
+    /**
+     * Bidirectional stream between the Collector and Hannah Core, analogous to TimerConnect.
+     * The Collector initiates and holds the connection open; Hannah pushes CaptureCommands
+     * down to start/stop satellite captures instead of the Collector polling for them.
+     */
+    collectorConnect(): ClientDuplexStream<CollectorMessage, CaptureCommand>;
+    collectorConnect(options: Partial<CallOptions>): ClientDuplexStream<CollectorMessage, CaptureCommand>;
+    collectorConnect(metadata: Metadata, options?: Partial<CallOptions>): ClientDuplexStream<CollectorMessage, CaptureCommand>;
+    /**
+     * Unary trigger for external callers (e.g. WebUI) that can't hold a CollectorConnect
+     * stream themselves — Hannah relays the command over its own CollectorConnect stream
+     * to the connected Collector. Fails with ok=false if no Collector is connected.
+     */
+    triggerCollectorCapture(request: CaptureCommand, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    triggerCollectorCapture(request: CaptureCommand, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    triggerCollectorCapture(request: CaptureCommand, 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 ---
+     * 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;
+    /**
+     * --- 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>;
+    /**
+     * --- Timer Admin ---
+     * Query and cancel timers independent of the TimerConnect stream — e.g. for an
+     * Admin-UI or Telegram bot listing/cancelling a user's active timers.
+     */
+    getTimers(request: GetTimersRequest, callback: (error: ServiceError | null, response: GetTimersResponse) => void): ClientUnaryCall;
+    getTimers(request: GetTimersRequest, metadata: Metadata, callback: (error: ServiceError | null, response: GetTimersResponse) => void): ClientUnaryCall;
+    getTimers(request: GetTimersRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: GetTimersResponse) => void): ClientUnaryCall;
+    deleteTimer(request: DeleteTimerRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteTimer(request: DeleteTimerRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteTimer(request: DeleteTimerRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    /**
+     * --- 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>;
+    /**
+     * --- Automations ---
+     * Bidirectional stream for external automation services (e.g. telegram_autoresponder).
+     * The service sends an AutomationRegister identifying itself, then Hannah replies with
+     * an AutomationSnapshot (all users with it currently enabled) followed by live
+     * AutomationStateChanged deltas as users toggle it via SetAutomation/voice.
+     * Chosen over SubscribeEvents so a reconnecting service always gets a fresh snapshot
+     * instead of missing state changes that happened while it was offline.
+     */
+    automationConnect(): ClientDuplexStream<AutomationMessage, AutomationCommand>;
+    automationConnect(options: Partial<CallOptions>): ClientDuplexStream<AutomationMessage, AutomationCommand>;
+    automationConnect(metadata: Metadata, options?: Partial<CallOptions>): ClientDuplexStream<AutomationMessage, AutomationCommand>;
+    /**
+     * --- Channels ---
+     * Bidirectional stream for channel adapters (e.g. the Telegram service). The adapter
+     * sends a ChannelRegister and keeps the stream open; it counts as available exactly as
+     * long as the stream is open. A second registration for the same service replaces the
+     * first. Link tokens (CreateLinkToken) are redeemed over this stream.
+     */
+    channelConnect(): ClientDuplexStream<ChannelMessage, ChannelCommand>;
+    channelConnect(options: Partial<CallOptions>): ClientDuplexStream<ChannelMessage, ChannelCommand>;
+    channelConnect(metadata: Metadata, options?: Partial<CallOptions>): ClientDuplexStream<ChannelMessage, ChannelCommand>;
+    /** Currently connected channel adapters and whether they support account linking. */
+    getChannels(request: Empty, callback: (error: ServiceError | null, response: GetChannelsResponse) => void): ClientUnaryCall;
+    getChannels(request: Empty, metadata: Metadata, callback: (error: ServiceError | null, response: GetChannelsResponse) => void): ClientUnaryCall;
+    getChannels(request: Empty, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: GetChannelsResponse) => void): ClientUnaryCall;
+    /**
+     * --- Infrastructure ---
+     * Service discovery for components: Hannah sends an InfrastructureSnapshot of all
+     * currently available infrastructure services (e.g. the log collector) right after
+     * subscribing, followed by ServiceAvailable/ServiceUnavailable deltas.
+     */
+    subscribeInfrastructure(request: InfrastructureFilter, options?: Partial<CallOptions>): ClientReadableStream<InfrastructureMessage>;
+    subscribeInfrastructure(request: InfrastructureFilter, metadata?: Metadata, options?: Partial<CallOptions>): ClientReadableStream<InfrastructureMessage>;
+    /**
+     * Bidirectional stream for the log collector. The collector sends a LogCollectorRegister
+     * and keeps the stream open; it counts as available exactly as long as the stream is
+     * open, and a second registration for the same instance replaces the first (same
+     * semantics as ChannelConnect). Not related to CollectorConnect (wakeword capture).
+     */
+    logCollectorConnect(): ClientDuplexStream<LogCollectorMessage, LogCollectorCommand>;
+    logCollectorConnect(options: Partial<CallOptions>): ClientDuplexStream<LogCollectorMessage, LogCollectorCommand>;
+    logCollectorConnect(metadata: Metadata, options?: Partial<CallOptions>): ClientDuplexStream<LogCollectorMessage, LogCollectorCommand>;
+    /**
+     * --- Activity Log ---
+     * Read access to the Activity Log (#220) for external consumers (WebUI). List returns
+     * full entry detail inline (transcript, intent + intent_meta, answer text) with
+     * cursor-based pagination; audio is fetched separately, decoded server-side from the
+     * stored WAV and streamed as raw PCM chunks.
+     */
+    listActivityLog(request: ListActivityLogRequest, callback: (error: ServiceError | null, response: ListActivityLogResponse) => void): ClientUnaryCall;
+    listActivityLog(request: ListActivityLogRequest, metadata: Metadata, callback: (error: ServiceError | null, response: ListActivityLogResponse) => void): ClientUnaryCall;
+    listActivityLog(request: ListActivityLogRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: ListActivityLogResponse) => void): ClientUnaryCall;
+    streamActivityAudio(request: StreamActivityAudioRequest, options?: Partial<CallOptions>): ClientReadableStream<ActivityAudioChunk>;
+    streamActivityAudio(request: StreamActivityAudioRequest, metadata?: Metadata, options?: Partial<CallOptions>): ClientReadableStream<ActivityAudioChunk>;
+    /** --- Messages (passive per-user mailbox, third notification type) --- */
+    createMessage(request: CreateMessageRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    createMessage(request: CreateMessageRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    createMessage(request: CreateMessageRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    listMessages(request: ListMessagesRequest, callback: (error: ServiceError | null, response: ListMessagesResponse) => void): ClientUnaryCall;
+    listMessages(request: ListMessagesRequest, metadata: Metadata, callback: (error: ServiceError | null, response: ListMessagesResponse) => void): ClientUnaryCall;
+    listMessages(request: ListMessagesRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: ListMessagesResponse) => void): ClientUnaryCall;
+    deleteMessage(request: DeleteMessageRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteMessage(request: DeleteMessageRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    deleteMessage(request: DeleteMessageRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+}
+export declare const HannahServiceClient: {
+    new (address: string, credentials: ChannelCredentials, options?: Partial<ClientOptions>): HannahServiceClient;
+    service: typeof HannahServiceService;
+    serviceName: string;
+};