@m1kad0/hannah-proto 0.5.3 → 0.5.5

package/README.md

@@ -0,0 +1,33 @@
+# hannah-proto
+
+Protobuf/gRPC schema definitions for the Hannah voice assistant ecosystem (Core, satellites, WebUI, ioBroker adapter, Telegram bot, and other consumers). This repo is the single source of truth for the wire protocol shared across all of them.
+
+The `.proto` files live flat at the repo root, one per functional area — satellite control, event streaming, the ioBroker agent bridge, user registry, timers, automations, and so on. Nothing here is application code, just schema.
+
+## Distribution
+
+Three independent, tag-triggered publish targets — pick whichever matches your language. Each contains only generated gRPC stubs/types for the current tagged release.
+
+| Language   | Package                                 | Install                                    |
+|------------|------------------------------------------|---------------------------------------------|
+| Python     | PyPI [`hannah-proto`](https://pypi.org/project/hannah-proto/) | `pip install hannah-proto` |
+| TypeScript | npm [`@m1kad0/hannah-proto`](https://www.npmjs.com/package/@m1kad0/hannah-proto) | `npm install @m1kad0/hannah-proto` |
+| Go         | [github.com/NurPech/hannah-proto-go](https://github.com/NurPech/hannah-proto-go) | `go get github.com/NurPech/hannah-proto-go` |
+
+Go has no separate package registry, so that tagged GitHub repo *is* the package — `go get` resolves it directly.
+
+## Versioning: PROTO_VERSION
+
+Alongside the semver package/tag version, every release carries a single-integer `PROTO_VERSION` (see the `PROTO_VERSION` file). Hannah Core and its clients exchange this value on every call and reject a mismatch at runtime — that's the actual compatibility gate, not the semver tag. A breaking schema change requires bumping `PROTO_VERSION`; CI enforces this on every merge request via `buf breaking`.
+
+## Compatibility checks
+
+CI runs `buf lint` and `buf breaking` (against `origin/master`) on every MR. To check a local branch against a specific released version:
+
+```sh
+buf breaking --against '.git#tag=vX.Y.Z'
+```
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for what changed release to release, including breaking changes and the consumers they affect.

package/dist/control.d.ts

@@ -73,6 +73,8 @@ export interface Satellite {
     /** true if the device has a new firmware available */
     updateAvailable: boolean;
     newVersion?: string | undefined;
+    /** #158: mic reopens after a Smalltalk answer instead of waiting for wake-word/PTT again */
+    smalltalkFollowupListen: boolean;
 }
 export interface GetSatellitesResponse {
     satellites: Satellite[];
@@ -97,6 +99,12 @@ export interface SetSatelliteOwnerRequest {
     /** requestor */
     requestorId: number;
 }
+export interface SetSatelliteSmalltalkFollowupRequest {
+    deviceId: string;
+    enabled: boolean;
+    /** requestor */
+    requestorId: number;
+}
 export interface DeleteSatelliteRequest {
     deviceId: string;
     /** requestor */
@@ -324,6 +332,7 @@ export declare const GetSatellitesResponse: MessageFns<GetSatellitesResponse>;
 export declare const SetSatelliteRoomRequest: MessageFns<SetSatelliteRoomRequest>;
 export declare const SetSatelliteDisplayNameRequest: MessageFns<SetSatelliteDisplayNameRequest>;
 export declare const SetSatelliteOwnerRequest: MessageFns<SetSatelliteOwnerRequest>;
+export declare const SetSatelliteSmalltalkFollowupRequest: MessageFns<SetSatelliteSmalltalkFollowupRequest>;
 export declare const DeleteSatelliteRequest: MessageFns<DeleteSatelliteRequest>;
 export declare const Room: MessageFns<Room>;
 export declare const GetRoomsResponse: MessageFns<GetRoomsResponse>;

package/dist/control.js

@@ -5,7 +5,7 @@
 //   protoc               unknown
 // source: control.proto
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DeleteCarRequest = exports.UpdateCarRequest = exports.CreateCarResponse = exports.CreateCarRequest = exports.GetCarsResponse = exports.Car = exports.DeleteBleTagRequest = exports.UpdateBleTagRequest = exports.CreateBleTagResponse = exports.CreateBleTagRequest = exports.GetBleTagsResponse = exports.BleTag = exports.UpdateConfigRequest = exports.SettingUpdate = exports.GetSettingsResponse = exports.Setting = exports.Category = exports.DeleteAlarmRequest = exports.UpdateAlarmRequest = exports.CreateAlarmResponse = exports.CreateAlarmRequest = exports.GetAlarmsResponse = exports.Alarm = exports.DeleteTriggerRequest = exports.UpdateTriggerRequest = exports.CreateTriggerRequest = exports.GetTriggersResponse = exports.Trigger = exports.SetGroupRoomsRequest = exports.DeleteGroupRequest = exports.UpdateGroupRequest = exports.CreateGroupRequest = exports.GetGroupsResponse = exports.Group = exports.GetRoomsResponse = exports.Room = exports.DeleteSatelliteRequest = exports.SetSatelliteOwnerRequest = exports.SetSatelliteDisplayNameRequest = exports.SetSatelliteRoomRequest = exports.GetSatellitesResponse = exports.Satellite = exports.AnnounceRequest = exports.SubmitVoiceResponse = exports.SubmitVoiceRequest = exports.SubmitTextResponse = exports.SubmitTextRequest = exports.protobufPackage = void 0;
+exports.DeleteCarRequest = exports.UpdateCarRequest = exports.CreateCarResponse = exports.CreateCarRequest = exports.GetCarsResponse = exports.Car = exports.DeleteBleTagRequest = exports.UpdateBleTagRequest = exports.CreateBleTagResponse = exports.CreateBleTagRequest = exports.GetBleTagsResponse = exports.BleTag = exports.UpdateConfigRequest = exports.SettingUpdate = exports.GetSettingsResponse = exports.Setting = exports.Category = exports.DeleteAlarmRequest = exports.UpdateAlarmRequest = exports.CreateAlarmResponse = exports.CreateAlarmRequest = exports.GetAlarmsResponse = exports.Alarm = exports.DeleteTriggerRequest = exports.UpdateTriggerRequest = exports.CreateTriggerRequest = exports.GetTriggersResponse = exports.Trigger = exports.SetGroupRoomsRequest = exports.DeleteGroupRequest = exports.UpdateGroupRequest = exports.CreateGroupRequest = exports.GetGroupsResponse = exports.Group = exports.GetRoomsResponse = exports.Room = exports.DeleteSatelliteRequest = exports.SetSatelliteSmalltalkFollowupRequest = exports.SetSatelliteOwnerRequest = exports.SetSatelliteDisplayNameRequest = exports.SetSatelliteRoomRequest = exports.GetSatellitesResponse = exports.Satellite = exports.AnnounceRequest = exports.SubmitVoiceResponse = exports.SubmitVoiceRequest = exports.SubmitTextResponse = exports.SubmitTextRequest = exports.protobufPackage = void 0;
 /* eslint-disable */
 const wire_1 = require("@bufbuild/protobuf/wire");
 exports.protobufPackage = "hannah";
@@ -351,6 +351,7 @@ function createBaseSatellite() {
         firmwareVersion: "",
         updateAvailable: false,
         newVersion: undefined,
+        smalltalkFollowupListen: false,
     };
 }
 exports.Satellite = {
@@ -397,6 +398,9 @@ exports.Satellite = {
         if (message.newVersion !== undefined) {
             writer.uint32(122).string(message.newVersion);
         }
+        if (message.smalltalkFollowupListen !== false) {
+            writer.uint32(128).bool(message.smalltalkFollowupListen);
+        }
         return writer;
     },
     decode(input, length) {
@@ -504,6 +508,13 @@ exports.Satellite = {
                     message.newVersion = reader.string();
                     continue;
                 }
+                case 16: {
+                    if (tag !== 128) {
+                        break;
+                    }
+                    message.smalltalkFollowupListen = reader.bool();
+                    continue;
+                }
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;
@@ -531,6 +542,7 @@ exports.Satellite = {
         message.firmwareVersion = object.firmwareVersion ?? "";
         message.updateAvailable = object.updateAvailable ?? false;
         message.newVersion = object.newVersion ?? undefined;
+        message.smalltalkFollowupListen = object.smalltalkFollowupListen ?? false;
         return message;
     },
 };
@@ -764,6 +776,69 @@ exports.SetSatelliteOwnerRequest = {
         return message;
     },
 };
+function createBaseSetSatelliteSmalltalkFollowupRequest() {
+    return { deviceId: "", enabled: false, requestorId: 0 };
+}
+exports.SetSatelliteSmalltalkFollowupRequest = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.deviceId !== "") {
+            writer.uint32(10).string(message.deviceId);
+        }
+        if (message.enabled !== false) {
+            writer.uint32(16).bool(message.enabled);
+        }
+        if (message.requestorId !== 0) {
+            writer.uint32(24).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 = createBaseSetSatelliteSmalltalkFollowupRequest();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.deviceId = reader.string();
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 16) {
+                        break;
+                    }
+                    message.enabled = reader.bool();
+                    continue;
+                }
+                case 3: {
+                    if (tag !== 24) {
+                        break;
+                    }
+                    message.requestorId = reader.int32();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    create(base) {
+        return exports.SetSatelliteSmalltalkFollowupRequest.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseSetSatelliteSmalltalkFollowupRequest();
+        message.deviceId = object.deviceId ?? "";
+        message.enabled = object.enabled ?? false;
+        message.requestorId = object.requestorId ?? 0;
+        return message;
+    },
+};
 function createBaseDeleteSatelliteRequest() {
     return { deviceId: "", requestorId: 0 };
 }

package/dist/event_stream.d.ts

@@ -28,6 +28,9 @@ export interface FirmwareEventProto {
 export interface TriggerFirmwareUpdateRequest {
     device: string;
 }
+export interface TriggerSatelliteRestartRequest {
+    device: string;
+}
 export interface ResidentEventProto {
     roomieId: string;
     displayName: string;
@@ -39,6 +42,7 @@ export declare const HannahEvent: MessageFns<HannahEvent>;
 export declare const SystemNotificationEvent: MessageFns<SystemNotificationEvent>;
 export declare const FirmwareEventProto: MessageFns<FirmwareEventProto>;
 export declare const TriggerFirmwareUpdateRequest: MessageFns<TriggerFirmwareUpdateRequest>;
+export declare const TriggerSatelliteRestartRequest: MessageFns<TriggerSatelliteRestartRequest>;
 export declare const ResidentEventProto: MessageFns<ResidentEventProto>;
 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 {} ? {

package/dist/event_stream.js

@@ -5,7 +5,7 @@
 //   protoc               unknown
 // source: event_stream.proto
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ResidentEventProto = exports.TriggerFirmwareUpdateRequest = exports.FirmwareEventProto = exports.SystemNotificationEvent = exports.HannahEvent = exports.EventFilter = exports.protobufPackage = void 0;
+exports.ResidentEventProto = exports.TriggerSatelliteRestartRequest = exports.TriggerFirmwareUpdateRequest = exports.FirmwareEventProto = exports.SystemNotificationEvent = exports.HannahEvent = exports.EventFilter = exports.protobufPackage = void 0;
 /* eslint-disable */
 const wire_1 = require("@bufbuild/protobuf/wire");
 const car_state_1 = require("./car_state");
@@ -318,6 +318,47 @@ exports.TriggerFirmwareUpdateRequest = {
         return message;
     },
 };
+function createBaseTriggerSatelliteRestartRequest() {
+    return { device: "" };
+}
+exports.TriggerSatelliteRestartRequest = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.device !== "") {
+            writer.uint32(10).string(message.device);
+        }
+        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 = createBaseTriggerSatelliteRestartRequest();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.device = reader.string();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    create(base) {
+        return exports.TriggerSatelliteRestartRequest.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseTriggerSatelliteRestartRequest();
+        message.device = object.device ?? "";
+        return message;
+    },
+};
 function createBaseResidentEventProto() {
     return { roomieId: "", displayName: "", event: "" };
 }

package/dist/hannah.d.ts

@@ -2,9 +2,9 @@ import { type CallOptions, type ChannelCredentials, Client, type ClientDuplexStr
 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, CreateTriggerRequest, DeleteAlarmRequest, DeleteBleTagRequest, DeleteCarRequest, DeleteGroupRequest, DeleteSatelliteRequest, DeleteTriggerRequest, GetAlarmsResponse, GetBleTagsResponse, GetCarsResponse, GetGroupsResponse, GetRoomsResponse, GetSatellitesResponse, GetSettingsResponse, GetTriggersResponse, SetGroupRoomsRequest, SetSatelliteDisplayNameRequest, SetSatelliteOwnerRequest, SetSatelliteRoomRequest, SubmitTextRequest, SubmitTextResponse, SubmitVoiceRequest, SubmitVoiceResponse, UpdateAlarmRequest, UpdateBleTagRequest, UpdateCarRequest, UpdateConfigRequest, UpdateGroupRequest, UpdateTriggerRequest } from "./control";
+import { AnnounceRequest, CreateAlarmRequest, CreateAlarmResponse, CreateBleTagRequest, CreateBleTagResponse, CreateCarRequest, CreateCarResponse, CreateGroupRequest, CreateTriggerRequest, DeleteAlarmRequest, DeleteBleTagRequest, DeleteCarRequest, DeleteGroupRequest, DeleteSatelliteRequest, DeleteTriggerRequest, GetAlarmsResponse, GetBleTagsResponse, GetCarsResponse, GetGroupsResponse, GetRoomsResponse, GetSatellitesResponse, GetSettingsResponse, GetTriggersResponse, SetGroupRoomsRequest, SetSatelliteDisplayNameRequest, SetSatelliteOwnerRequest, SetSatelliteRoomRequest, SetSatelliteSmalltalkFollowupRequest, SubmitTextRequest, SubmitTextResponse, SubmitVoiceRequest, SubmitVoiceResponse, UpdateAlarmRequest, UpdateBleTagRequest, UpdateCarRequest, UpdateConfigRequest, UpdateGroupRequest, UpdateTriggerRequest } from "./control";
 import { ControlDeviceRequest, GetDevicesResponse } from "./device_control_menu";
-import { EventFilter, HannahEvent, TriggerFirmwareUpdateRequest } from "./event_stream";
+import { EventFilter, HannahEvent, TriggerFirmwareUpdateRequest, TriggerSatelliteRestartRequest } from "./event_stream";
 import { ProvisionSatelliteRequest } from "./satellite_provisioning";
 import { ProxyCommand, ProxyHeartbeat, SatelliteRegistration, SubmitSatelliteAudioRequest, SubmitSatelliteAudioResponse } from "./satellite_proxy";
 import { Empty, StatusResponse } from "./shared";
@@ -239,6 +239,19 @@ export declare const HannahServiceService: {
         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.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.HannahService/DeleteSatellite";
@@ -527,6 +540,21 @@ export declare const HannahServiceService: {
         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.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.
@@ -770,6 +798,11 @@ export interface HannahServiceServer extends UntypedServiceImplementation {
     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) --- */
@@ -826,6 +859,13 @@ export interface HannahServiceServer extends UntypedServiceImplementation {
      * 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.
@@ -993,6 +1033,13 @@ export interface HannahServiceClient extends Client {
     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;
@@ -1106,6 +1153,15 @@ export interface HannahServiceClient extends Client {
     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.

package/dist/hannah.js

@@ -247,6 +247,19 @@ exports.HannahServiceService = {
         responseSerialize: (value) => Buffer.from(shared_1.StatusResponse.encode(value).finish()),
         responseDeserialize: (value) => shared_1.StatusResponse.decode(value),
     },
+    /**
+     * 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: {
+        path: "/hannah.HannahService/SetSatelliteSmalltalkFollowup",
+        requestStream: false,
+        responseStream: false,
+        requestSerialize: (value) => Buffer.from(control_1.SetSatelliteSmalltalkFollowupRequest.encode(value).finish()),
+        requestDeserialize: (value) => control_1.SetSatelliteSmalltalkFollowupRequest.decode(value),
+        responseSerialize: (value) => Buffer.from(shared_1.StatusResponse.encode(value).finish()),
+        responseDeserialize: (value) => shared_1.StatusResponse.decode(value),
+    },
     /** Delete existing satellite */
     deleteSatellite: {
         path: "/hannah.HannahService/DeleteSatellite",
@@ -535,6 +548,21 @@ exports.HannahServiceService = {
         responseSerialize: (value) => Buffer.from(shared_1.StatusResponse.encode(value).finish()),
         responseDeserialize: (value) => shared_1.StatusResponse.decode(value),
     },
+    /**
+     * 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: {
+        path: "/hannah.HannahService/TriggerSatelliteRestart",
+        requestStream: false,
+        responseStream: false,
+        requestSerialize: (value) => Buffer.from(event_stream_1.TriggerSatelliteRestartRequest.encode(value).finish()),
+        requestDeserialize: (value) => event_stream_1.TriggerSatelliteRestartRequest.decode(value),
+        responseSerialize: (value) => Buffer.from(shared_1.StatusResponse.encode(value).finish()),
+        responseDeserialize: (value) => shared_1.StatusResponse.decode(value),
+    },
     /**
      * --- Wakeword Capture ---
      * Put a satellite in audio-capture mode for wakeword training data collection.

package/package.json

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