@m1kad0/hannah-proto 0.3.6 → 0.3.8

package/dist/automation.d.ts

@@ -0,0 +1,54 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+export declare const protobufPackage = "hannah";
+/** Sent by an automation service (e.g. telegram_autoresponder) over the AutomationConnect stream. */
+export interface AutomationMessage {
+    /** sent once, right after connecting */
+    register?: AutomationRegister | undefined;
+}
+/** Identifies which automation this connection represents. */
+export interface AutomationRegister {
+    /** e.g. "telegram_autoresponder" */
+    automation: string;
+}
+/** Sent by Hannah Core over the AutomationConnect stream. */
+export interface AutomationCommand {
+    /** sent once, right after register */
+    snapshot?: AutomationSnapshot | undefined;
+    /** live delta */
+    stateChanged?: AutomationStateChanged | undefined;
+}
+/**
+ * Full list of users with the registered automation currently enabled.
+ * Sent once per connection, right after AutomationRegister — the recovery
+ * mechanism for state changes that happened while the service was offline.
+ */
+export interface AutomationSnapshot {
+    userIds: number[];
+}
+/** A single user's enabled/disabled state changed for the registered automation. */
+export interface AutomationStateChanged {
+    userId: number;
+    enabled: boolean;
+}
+export declare const AutomationMessage: MessageFns<AutomationMessage>;
+export declare const AutomationRegister: MessageFns<AutomationRegister>;
+export declare const AutomationCommand: MessageFns<AutomationCommand>;
+export declare const AutomationSnapshot: MessageFns<AutomationSnapshot>;
+export declare const AutomationStateChanged: MessageFns<AutomationStateChanged>;
+type Builtin = Date | Function | Uint8Array | string | number | boolean | bigint | undefined;
+export type DeepPartial<T> = T extends bigint ? string | number | bigint : T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+type KeysOfUnion<T> = T extends T ? keyof T : never;
+export type Exact<P, I extends P> = P extends Builtin ? P : P & {
+    [K in keyof P]: Exact<P[K], I[K]>;
+} & {
+    [K in Exclude<keyof I, KeysOfUnion<P>>]: never;
+};
+export interface MessageFns<T> {
+    encode(message: T, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): T;
+    create<I extends Exact<DeepPartial<T>, I>>(base?: I): T;
+    fromPartial<I extends Exact<DeepPartial<T>, I>>(object: I): T;
+}
+export {};

package/dist/automation.js

@@ -0,0 +1,253 @@
+"use strict";
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.12.0
+//   protoc               unknown
+// source: automation.proto
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutomationStateChanged = exports.AutomationSnapshot = exports.AutomationCommand = exports.AutomationRegister = exports.AutomationMessage = exports.protobufPackage = void 0;
+/* eslint-disable */
+const wire_1 = require("@bufbuild/protobuf/wire");
+exports.protobufPackage = "hannah";
+function createBaseAutomationMessage() {
+    return { register: undefined };
+}
+exports.AutomationMessage = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.register !== undefined) {
+            exports.AutomationRegister.encode(message.register, writer.uint32(10).fork()).join();
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseAutomationMessage();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.register = exports.AutomationRegister.decode(reader, reader.uint32());
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    create(base) {
+        return exports.AutomationMessage.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseAutomationMessage();
+        message.register = (object.register !== undefined && object.register !== null)
+            ? exports.AutomationRegister.fromPartial(object.register)
+            : undefined;
+        return message;
+    },
+};
+function createBaseAutomationRegister() {
+    return { automation: "" };
+}
+exports.AutomationRegister = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.automation !== "") {
+            writer.uint32(10).string(message.automation);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseAutomationRegister();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.automation = reader.string();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    create(base) {
+        return exports.AutomationRegister.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseAutomationRegister();
+        message.automation = object.automation ?? "";
+        return message;
+    },
+};
+function createBaseAutomationCommand() {
+    return { snapshot: undefined, stateChanged: undefined };
+}
+exports.AutomationCommand = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.snapshot !== undefined) {
+            exports.AutomationSnapshot.encode(message.snapshot, writer.uint32(10).fork()).join();
+        }
+        if (message.stateChanged !== undefined) {
+            exports.AutomationStateChanged.encode(message.stateChanged, writer.uint32(18).fork()).join();
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseAutomationCommand();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.snapshot = exports.AutomationSnapshot.decode(reader, reader.uint32());
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 18) {
+                        break;
+                    }
+                    message.stateChanged = exports.AutomationStateChanged.decode(reader, reader.uint32());
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    create(base) {
+        return exports.AutomationCommand.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseAutomationCommand();
+        message.snapshot = (object.snapshot !== undefined && object.snapshot !== null)
+            ? exports.AutomationSnapshot.fromPartial(object.snapshot)
+            : undefined;
+        message.stateChanged = (object.stateChanged !== undefined && object.stateChanged !== null)
+            ? exports.AutomationStateChanged.fromPartial(object.stateChanged)
+            : undefined;
+        return message;
+    },
+};
+function createBaseAutomationSnapshot() {
+    return { userIds: [] };
+}
+exports.AutomationSnapshot = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        writer.uint32(10).fork();
+        for (const v of message.userIds) {
+            writer.int32(v);
+        }
+        writer.join();
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseAutomationSnapshot();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag === 8) {
+                        message.userIds.push(reader.int32());
+                        continue;
+                    }
+                    if (tag === 10) {
+                        const end2 = reader.uint32() + reader.pos;
+                        while (reader.pos < end2) {
+                            message.userIds.push(reader.int32());
+                        }
+                        continue;
+                    }
+                    break;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    create(base) {
+        return exports.AutomationSnapshot.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseAutomationSnapshot();
+        message.userIds = object.userIds?.map((e) => e) || [];
+        return message;
+    },
+};
+function createBaseAutomationStateChanged() {
+    return { userId: 0, enabled: false };
+}
+exports.AutomationStateChanged = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.userId !== 0) {
+            writer.uint32(8).int32(message.userId);
+        }
+        if (message.enabled !== false) {
+            writer.uint32(16).bool(message.enabled);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseAutomationStateChanged();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 8) {
+                        break;
+                    }
+                    message.userId = reader.int32();
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 16) {
+                        break;
+                    }
+                    message.enabled = reader.bool();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    create(base) {
+        return exports.AutomationStateChanged.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseAutomationStateChanged();
+        message.userId = object.userId ?? 0;
+        message.enabled = object.enabled ?? false;
+        return message;
+    },
+};

package/dist/hannah.d.ts

@@ -1,5 +1,6 @@
 import { type CallOptions, type ChannelCredentials, Client, type ClientDuplexStream, type ClientOptions, type ClientReadableStream, type ClientUnaryCall, type handleBidiStreamingCall, type handleServerStreamingCall, type handleUnaryCall, type Metadata, type ServiceError, type UntypedServiceImplementation } from "@grpc/grpc-js";
 import { AgentCommand, AgentMessage, AgentNotification } from "./agent";
+import { AutomationCommand, AutomationMessage } from "./automation";
 import { CarStateResponse, GetAllCarStatesResponse } from "./car_state";
 import { AnnounceRequest, CreateAlarmRequest, CreateAlarmResponse, CreateBleTagRequest, CreateBleTagResponse, CreateCarRequest, CreateCarResponse, CreateGroupRequest, CreateRoutineRequest, CreateRoutineResponse, CreateTriggerRequest, DeleteAlarmRequest, DeleteBleTagRequest, DeleteCarRequest, DeleteGroupRequest, DeleteRoutineRequest, DeleteSatelliteRequest, DeleteTriggerRequest, GetAlarmsResponse, GetBleTagsResponse, GetCarsResponse, GetGroupsResponse, GetRoomsResponse, GetRoutinesResponse, GetSatellitesResponse, GetSettingsResponse, GetTriggersResponse, SetGroupRoomsRequest, SetSatelliteDisplayNameRequest, SetSatelliteOwnerRequest, SetSatelliteRoomRequest, SubmitTextRequest, SubmitTextResponse, SubmitVoiceRequest, SubmitVoiceResponse, UpdateAlarmRequest, UpdateBleTagRequest, UpdateCarRequest, UpdateConfigRequest, UpdateGroupRequest, UpdateRoutineRequest, UpdateTriggerRequest } from "./control";
 import { ControlDeviceRequest, GetDevicesResponse } from "./device_control_menu";
@@ -8,8 +9,9 @@ import { ProvisionSatelliteRequest } from "./satellite_provisioning";
 import { ProxyCommand, ProxyHeartbeat, SatelliteRegistration, SubmitSatelliteAudioRequest, SubmitSatelliteAudioResponse } from "./satellite_proxy";
 import { Empty, StatusResponse } from "./shared";
 import { EnrollVoiceprintRequest } from "./speaker_enrollment";
+import { DeleteTimerRequest, GetTimersRequest, GetTimersResponse } from "./timer_admin";
 import { TimerCommand, TimerMessage } from "./timer_service";
-import { CreateUserRequest, CreateUserResponse, DeleteUserRequest, GetResidentsResponse, GetUserRequest, GetUsersRequest, GetUsersResponse, LinkAccountRequest, LoginRequest, SetSystemMessagesRequest, SetTrustLevelRequest, UnlinkAccountRequest, UpdateUserRequest, UserResponse } from "./user_registry";
+import { CreateUserRequest, CreateUserResponse, DeleteUserRequest, GetResidentsResponse, GetUserRequest, GetUsersRequest, GetUsersResponse, LinkAccountRequest, LoginRequest, SetAutomationRequest, SetSystemMessagesRequest, SetTrustLevelRequest, UnlinkAccountRequest, UpdateUserRequest, UserResponse } from "./user_registry";
 import { SatelliteAudioChunk, SatelliteCaptureRequest, SatelliteCaptureResponse, TriggerPlinkRequest } from "./wakeword_capture";
 export declare const protobufPackage = "hannah";
 export type HannahServiceService = typeof HannahServiceService;
@@ -69,6 +71,19 @@ export declare const HannahServiceService: {
         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.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.HannahService/Login";
         readonly requestStream: false;
@@ -685,6 +700,29 @@ export declare const HannahServiceService: {
         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.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.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.
@@ -701,6 +739,24 @@ export declare const HannahServiceService: {
         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.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;
+    };
 };
 export interface HannahServiceServer extends UntypedServiceImplementation {
     /** --- User Registry --- */
@@ -710,6 +766,11 @@ export interface HannahServiceServer extends UntypedServiceImplementation {
     unlinkAccount: handleUnaryCall<UnlinkAccountRequest, StatusResponse>;
     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>;
@@ -854,6 +915,13 @@ export interface HannahServiceServer extends UntypedServiceImplementation {
      * 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.
@@ -862,6 +930,16 @@ export interface HannahServiceServer extends UntypedServiceImplementation {
      * 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>;
 }
 export interface HannahServiceClient extends Client {
     /** --- User Registry --- */
@@ -883,6 +961,13 @@ export interface HannahServiceClient extends Client {
     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;
@@ -1143,6 +1228,17 @@ export interface HannahServiceClient extends Client {
     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.
@@ -1153,6 +1249,18 @@ export interface HannahServiceClient extends Client {
     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>;
 }
 export declare const HannahServiceClient: {
     new (address: string, credentials: ChannelCredentials, options?: Partial<ClientOptions>): HannahServiceClient;

package/dist/hannah.js

@@ -9,6 +9,7 @@ exports.HannahServiceClient = exports.HannahServiceService = exports.protobufPac
 /* eslint-disable */
 const grpc_js_1 = require("@grpc/grpc-js");
 const agent_1 = require("./agent");
+const automation_1 = require("./automation");
 const car_state_1 = require("./car_state");
 const control_1 = require("./control");
 const device_control_menu_1 = require("./device_control_menu");
@@ -17,6 +18,7 @@ const satellite_provisioning_1 = require("./satellite_provisioning");
 const satellite_proxy_1 = require("./satellite_proxy");
 const shared_1 = require("./shared");
 const speaker_enrollment_1 = require("./speaker_enrollment");
+const timer_admin_1 = require("./timer_admin");
 const timer_service_1 = require("./timer_service");
 const user_registry_1 = require("./user_registry");
 const wakeword_capture_1 = require("./wakeword_capture");
@@ -77,6 +79,19 @@ exports.HannahServiceService = {
         responseSerialize: (value) => Buffer.from(shared_1.StatusResponse.encode(value).finish()),
         responseDeserialize: (value) => shared_1.StatusResponse.decode(value),
     },
+    /**
+     * 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: {
+        path: "/hannah.HannahService/SetAutomation",
+        requestStream: false,
+        responseStream: false,
+        requestSerialize: (value) => Buffer.from(user_registry_1.SetAutomationRequest.encode(value).finish()),
+        requestDeserialize: (value) => user_registry_1.SetAutomationRequest.decode(value),
+        responseSerialize: (value) => Buffer.from(shared_1.StatusResponse.encode(value).finish()),
+        responseDeserialize: (value) => shared_1.StatusResponse.decode(value),
+    },
     login: {
         path: "/hannah.HannahService/Login",
         requestStream: false,
@@ -693,6 +708,29 @@ exports.HannahServiceService = {
         responseSerialize: (value) => Buffer.from(timer_service_1.TimerCommand.encode(value).finish()),
         responseDeserialize: (value) => timer_service_1.TimerCommand.decode(value),
     },
+    /**
+     * --- 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: {
+        path: "/hannah.HannahService/GetTimers",
+        requestStream: false,
+        responseStream: false,
+        requestSerialize: (value) => Buffer.from(timer_admin_1.GetTimersRequest.encode(value).finish()),
+        requestDeserialize: (value) => timer_admin_1.GetTimersRequest.decode(value),
+        responseSerialize: (value) => Buffer.from(timer_admin_1.GetTimersResponse.encode(value).finish()),
+        responseDeserialize: (value) => timer_admin_1.GetTimersResponse.decode(value),
+    },
+    deleteTimer: {
+        path: "/hannah.HannahService/DeleteTimer",
+        requestStream: false,
+        responseStream: false,
+        requestSerialize: (value) => Buffer.from(timer_admin_1.DeleteTimerRequest.encode(value).finish()),
+        requestDeserialize: (value) => timer_admin_1.DeleteTimerRequest.decode(value),
+        responseSerialize: (value) => Buffer.from(shared_1.StatusResponse.encode(value).finish()),
+        responseDeserialize: (value) => shared_1.StatusResponse.decode(value),
+    },
     /**
      * --- ioBroker Agent ---
      * Single bidirectional stream between the HannahAgent ioBroker adapter and Hannah Core.
@@ -709,5 +747,23 @@ exports.HannahServiceService = {
         responseSerialize: (value) => Buffer.from(agent_1.AgentCommand.encode(value).finish()),
         responseDeserialize: (value) => agent_1.AgentCommand.decode(value),
     },
+    /**
+     * --- 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: {
+        path: "/hannah.HannahService/AutomationConnect",
+        requestStream: true,
+        responseStream: true,
+        requestSerialize: (value) => Buffer.from(automation_1.AutomationMessage.encode(value).finish()),
+        requestDeserialize: (value) => automation_1.AutomationMessage.decode(value),
+        responseSerialize: (value) => Buffer.from(automation_1.AutomationCommand.encode(value).finish()),
+        responseDeserialize: (value) => automation_1.AutomationCommand.decode(value),
+    },
 };
 exports.HannahServiceClient = (0, grpc_js_1.makeGenericClientConstructor)(exports.HannahServiceService, "hannah.HannahService");

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from './version';
 export * as agent from './agent';
+export * as automation from './automation';
 export * as car_state from './car_state';
 export * as control from './control';
 export * as device_control_menu from './device_control_menu';
@@ -9,6 +10,7 @@ export * as satellite_provisioning from './satellite_provisioning';
 export * as satellite_proxy from './satellite_proxy';
 export * as shared from './shared';
 export * as speaker_enrollment from './speaker_enrollment';
+export * as timer_admin from './timer_admin';
 export * as timer_service from './timer_service';
 export * as user_registry from './user_registry';
 export * as wakeword_capture from './wakeword_capture';

package/dist/index.js

@@ -36,9 +36,10 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.wakeword_capture = exports.user_registry = exports.timer_service = exports.speaker_enrollment = exports.shared = exports.satellite_proxy = exports.satellite_provisioning = exports.hannah = exports.event_stream = exports.device_control_menu = exports.control = exports.car_state = exports.agent = void 0;
+exports.wakeword_capture = exports.user_registry = exports.timer_service = exports.timer_admin = exports.speaker_enrollment = exports.shared = exports.satellite_proxy = exports.satellite_provisioning = exports.hannah = exports.event_stream = exports.device_control_menu = exports.control = exports.car_state = exports.automation = exports.agent = void 0;
 __exportStar(require("./version"), exports);
 exports.agent = __importStar(require("./agent"));
+exports.automation = __importStar(require("./automation"));
 exports.car_state = __importStar(require("./car_state"));
 exports.control = __importStar(require("./control"));
 exports.device_control_menu = __importStar(require("./device_control_menu"));
@@ -48,6 +49,7 @@ exports.satellite_provisioning = __importStar(require("./satellite_provisioning"
 exports.satellite_proxy = __importStar(require("./satellite_proxy"));
 exports.shared = __importStar(require("./shared"));
 exports.speaker_enrollment = __importStar(require("./speaker_enrollment"));
+exports.timer_admin = __importStar(require("./timer_admin"));
 exports.timer_service = __importStar(require("./timer_service"));
 exports.user_registry = __importStar(require("./user_registry"));
 exports.wakeword_capture = __importStar(require("./wakeword_capture"));

package/dist/timer_admin.d.ts

@@ -0,0 +1,42 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+export declare const protobufPackage = "hannah";
+export interface Timer {
+    timerId: string;
+    label: string;
+    /** remaining seconds until fire, computed relative to now */
+    seconds: bigint;
+    roomId: string;
+    userId: number;
+}
+export interface GetTimersRequest {
+    userId: number;
+}
+export interface GetTimersResponse {
+    timers: Timer[];
+}
+export interface DeleteTimerRequest {
+    timerId: string;
+    /** caller performing the deletion, may differ from the timer's owner */
+    requestorId: number;
+}
+export declare const Timer: MessageFns<Timer>;
+export declare const GetTimersRequest: MessageFns<GetTimersRequest>;
+export declare const GetTimersResponse: MessageFns<GetTimersResponse>;
+export declare const DeleteTimerRequest: MessageFns<DeleteTimerRequest>;
+type Builtin = Date | Function | Uint8Array | string | number | boolean | bigint | undefined;
+export type DeepPartial<T> = T extends bigint ? string | number | bigint : T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+type KeysOfUnion<T> = T extends T ? keyof T : never;
+export type Exact<P, I extends P> = P extends Builtin ? P : P & {
+    [K in keyof P]: Exact<P[K], I[K]>;
+} & {
+    [K in Exclude<keyof I, KeysOfUnion<P>>]: never;
+};
+export interface MessageFns<T> {
+    encode(message: T, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): T;
+    create<I extends Exact<DeepPartial<T>, I>>(base?: I): T;
+    fromPartial<I extends Exact<DeepPartial<T>, I>>(object: I): T;
+}
+export {};

package/dist/timer_admin.js

@@ -0,0 +1,233 @@
+"use strict";
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.12.0
+//   protoc               unknown
+// source: timer_admin.proto
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeleteTimerRequest = exports.GetTimersResponse = exports.GetTimersRequest = exports.Timer = exports.protobufPackage = void 0;
+/* eslint-disable */
+const wire_1 = require("@bufbuild/protobuf/wire");
+exports.protobufPackage = "hannah";
+function createBaseTimer() {
+    return { timerId: "", label: "", seconds: 0n, roomId: "", userId: 0 };
+}
+exports.Timer = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.timerId !== "") {
+            writer.uint32(10).string(message.timerId);
+        }
+        if (message.label !== "") {
+            writer.uint32(18).string(message.label);
+        }
+        if (message.seconds !== 0n) {
+            if (BigInt.asIntN(64, message.seconds) !== message.seconds) {
+                throw new globalThis.Error("value provided for field message.seconds of type int64 too large");
+            }
+            writer.uint32(24).int64(message.seconds);
+        }
+        if (message.roomId !== "") {
+            writer.uint32(34).string(message.roomId);
+        }
+        if (message.userId !== 0) {
+            writer.uint32(40).int32(message.userId);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseTimer();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.timerId = reader.string();
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 18) {
+                        break;
+                    }
+                    message.label = reader.string();
+                    continue;
+                }
+                case 3: {
+                    if (tag !== 24) {
+                        break;
+                    }
+                    message.seconds = reader.int64();
+                    continue;
+                }
+                case 4: {
+                    if (tag !== 34) {
+                        break;
+                    }
+                    message.roomId = reader.string();
+                    continue;
+                }
+                case 5: {
+                    if (tag !== 40) {
+                        break;
+                    }
+                    message.userId = reader.int32();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    create(base) {
+        return exports.Timer.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseTimer();
+        message.timerId = object.timerId ?? "";
+        message.label = object.label ?? "";
+        message.seconds = (object.seconds !== undefined && object.seconds !== null) ? BigInt(object.seconds) : 0n;
+        message.roomId = object.roomId ?? "";
+        message.userId = object.userId ?? 0;
+        return message;
+    },
+};
+function createBaseGetTimersRequest() {
+    return { userId: 0 };
+}
+exports.GetTimersRequest = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.userId !== 0) {
+            writer.uint32(8).int32(message.userId);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseGetTimersRequest();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 8) {
+                        break;
+                    }
+                    message.userId = reader.int32();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    create(base) {
+        return exports.GetTimersRequest.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseGetTimersRequest();
+        message.userId = object.userId ?? 0;
+        return message;
+    },
+};
+function createBaseGetTimersResponse() {
+    return { timers: [] };
+}
+exports.GetTimersResponse = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        for (const v of message.timers) {
+            exports.Timer.encode(v, writer.uint32(10).fork()).join();
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseGetTimersResponse();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.timers.push(exports.Timer.decode(reader, reader.uint32()));
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    create(base) {
+        return exports.GetTimersResponse.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseGetTimersResponse();
+        message.timers = object.timers?.map((e) => exports.Timer.fromPartial(e)) || [];
+        return message;
+    },
+};
+function createBaseDeleteTimerRequest() {
+    return { timerId: "", requestorId: 0 };
+}
+exports.DeleteTimerRequest = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.timerId !== "") {
+            writer.uint32(10).string(message.timerId);
+        }
+        if (message.requestorId !== 0) {
+            writer.uint32(16).int32(message.requestorId);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseDeleteTimerRequest();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.timerId = reader.string();
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 16) {
+                        break;
+                    }
+                    message.requestorId = reader.int32();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    create(base) {
+        return exports.DeleteTimerRequest.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseDeleteTimerRequest();
+        message.timerId = object.timerId ?? "";
+        message.requestorId = object.requestorId ?? 0;
+        return message;
+    },
+};

package/dist/user_registry.d.ts

@@ -17,6 +17,11 @@ export interface User {
     email: string;
     /** "roomie" | "guest" | "pet", #27 Phase 6 */
     type: string;
+    /**
+     * Keys of automation services (e.g. "telegram_autoresponder") currently enabled for
+     * this user. Presence-based: a key is only listed here when enabled, absent = disabled.
+     */
+    enabledAutomations: string[];
 }
 export interface User_LinkedAccountsEntry {
     key: string;
@@ -80,6 +85,12 @@ export interface SetSystemMessagesRequest {
     userId: number;
     enabled: boolean;
 }
+export interface SetAutomationRequest {
+    userId: number;
+    /** e.g. "telegram_autoresponder" */
+    automation: string;
+    enabled: boolean;
+}
 export interface CreateUserRequest {
     username: string;
     /** Klartext, wird serverseitig gehasht — gleicher akzeptierter Constraint wie LoginRequest */
@@ -131,6 +142,7 @@ export declare const LinkAccountRequest: MessageFns<LinkAccountRequest>;
 export declare const UnlinkAccountRequest: MessageFns<UnlinkAccountRequest>;
 export declare const SetTrustLevelRequest: MessageFns<SetTrustLevelRequest>;
 export declare const SetSystemMessagesRequest: MessageFns<SetSystemMessagesRequest>;
+export declare const SetAutomationRequest: MessageFns<SetAutomationRequest>;
 export declare const CreateUserRequest: MessageFns<CreateUserRequest>;
 export declare const CreateUserResponse: MessageFns<CreateUserResponse>;
 export declare const UpdateUserRequest: MessageFns<UpdateUserRequest>;

package/dist/user_registry.js

@@ -5,7 +5,7 @@
 //   protoc               unknown
 // source: user_registry.proto
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GetResidentsResponse = exports.Resident = exports.DeleteUserRequest = exports.UpdateUserRequest = exports.CreateUserResponse = exports.CreateUserRequest = exports.SetSystemMessagesRequest = exports.SetTrustLevelRequest = exports.UnlinkAccountRequest = exports.LinkAccountRequest = exports.LoginRequest = exports.UserResponse = exports.LinkedAccountLookup = exports.GetUserRequest = exports.GetUsersResponse = exports.GetUsersRequest = exports.User_LinkedAccountsEntry = exports.User = exports.protobufPackage = void 0;
+exports.GetResidentsResponse = exports.Resident = exports.DeleteUserRequest = exports.UpdateUserRequest = exports.CreateUserResponse = exports.CreateUserRequest = exports.SetAutomationRequest = exports.SetSystemMessagesRequest = exports.SetTrustLevelRequest = exports.UnlinkAccountRequest = exports.LinkAccountRequest = exports.LoginRequest = exports.UserResponse = exports.LinkedAccountLookup = exports.GetUserRequest = exports.GetUsersResponse = exports.GetUsersRequest = exports.User_LinkedAccountsEntry = exports.User = exports.protobufPackage = void 0;
 /* eslint-disable */
 const wire_1 = require("@bufbuild/protobuf/wire");
 exports.protobufPackage = "hannah";
@@ -20,6 +20,7 @@ function createBaseUser() {
         systemMessages: false,
         email: "",
         type: "",
+        enabledAutomations: [],
     };
 }
 exports.User = {
@@ -51,6 +52,9 @@ exports.User = {
         if (message.type !== "") {
             writer.uint32(74).string(message.type);
         }
+        for (const v of message.enabledAutomations) {
+            writer.uint32(82).string(v);
+        }
         return writer;
     },
     decode(input, length) {
@@ -126,6 +130,13 @@ exports.User = {
                     message.type = reader.string();
                     continue;
                 }
+                case 10: {
+                    if (tag !== 82) {
+                        break;
+                    }
+                    message.enabledAutomations.push(reader.string());
+                    continue;
+                }
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;
@@ -153,6 +164,7 @@ exports.User = {
         message.systemMessages = object.systemMessages ?? false;
         message.email = object.email ?? "";
         message.type = object.type ?? "";
+        message.enabledAutomations = object.enabledAutomations?.map((e) => e) || [];
         return message;
     },
 };
@@ -774,6 +786,69 @@ exports.SetSystemMessagesRequest = {
         return message;
     },
 };
+function createBaseSetAutomationRequest() {
+    return { userId: 0, automation: "", enabled: false };
+}
+exports.SetAutomationRequest = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.userId !== 0) {
+            writer.uint32(8).int32(message.userId);
+        }
+        if (message.automation !== "") {
+            writer.uint32(18).string(message.automation);
+        }
+        if (message.enabled !== false) {
+            writer.uint32(24).bool(message.enabled);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseSetAutomationRequest();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 8) {
+                        break;
+                    }
+                    message.userId = reader.int32();
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 18) {
+                        break;
+                    }
+                    message.automation = reader.string();
+                    continue;
+                }
+                case 3: {
+                    if (tag !== 24) {
+                        break;
+                    }
+                    message.enabled = reader.bool();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    create(base) {
+        return exports.SetAutomationRequest.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseSetAutomationRequest();
+        message.userId = object.userId ?? 0;
+        message.automation = object.automation ?? "";
+        message.enabled = object.enabled ?? false;
+        return message;
+    },
+};
 function createBaseCreateUserRequest() {
     return { username: "", password: "", email: "", displayName: "", type: "" };
 }

package/package.json

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