@m1kad0/hannah-proto 1.0.2 → 1.1.0

package/dist/agent.d.ts

@@ -1,5 +1,6 @@
 import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
 import { EnumValues, StateType } from "./shared";
+import { AgentWeatherUpdate } from "./weather";
 export declare const protobufPackage = "hannah";
 export declare enum ResidentType {
     RESIDENT_TYPE_UNSPECIFIED = 0,
@@ -26,6 +27,7 @@ export interface AgentMessage {
     askResident?: AgentAskResident | undefined;
     /** full room catalog, independent of devices */
     sendRooms?: AgentRoomSnapshot | undefined;
+    weatherUpdate?: AgentWeatherUpdate | undefined;
 }
 /**
  * Adapter instructs Hannah to control satellites in a room or a specific satellite.

package/dist/agent.js

@@ -9,6 +9,7 @@ exports.AgentSensorUpdate = exports.AgentBleUpdate = exports.AgentResidentAnswer
 /* eslint-disable */
 const wire_1 = require("@bufbuild/protobuf/wire");
 const shared_1 = require("./shared");
+const weather_1 = require("./weather");
 exports.protobufPackage = "hannah";
 var ResidentType;
 (function (ResidentType) {
@@ -28,6 +29,7 @@ function createBaseAgentMessage() {
         sendResidents: undefined,
         askResident: undefined,
         sendRooms: undefined,
+        weatherUpdate: undefined,
     };
 }
 exports.AgentMessage = {
@@ -56,6 +58,9 @@ exports.AgentMessage = {
         if (message.sendRooms !== undefined) {
             exports.AgentRoomSnapshot.encode(message.sendRooms, writer.uint32(66).fork()).join();
         }
+        if (message.weatherUpdate !== undefined) {
+            weather_1.AgentWeatherUpdate.encode(message.weatherUpdate, writer.uint32(74).fork()).join();
+        }
         return writer;
     },
     decode(input, length) {
@@ -121,6 +126,13 @@ exports.AgentMessage = {
                     message.sendRooms = exports.AgentRoomSnapshot.decode(reader, reader.uint32());
                     continue;
                 }
+                case 9: {
+                    if (tag !== 74) {
+                        break;
+                    }
+                    message.weatherUpdate = weather_1.AgentWeatherUpdate.decode(reader, reader.uint32());
+                    continue;
+                }
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;
@@ -158,6 +170,9 @@ exports.AgentMessage = {
         message.sendRooms = (object.sendRooms !== undefined && object.sendRooms !== null)
             ? exports.AgentRoomSnapshot.fromPartial(object.sendRooms)
             : undefined;
+        message.weatherUpdate = (object.weatherUpdate !== undefined && object.weatherUpdate !== null)
+            ? weather_1.AgentWeatherUpdate.fromPartial(object.weatherUpdate)
+            : undefined;
         return message;
     },
 };

package/dist/index.d.ts

@@ -14,3 +14,4 @@ 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';
+export * as weather from './weather';

package/dist/index.js

@@ -36,7 +36,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-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;
+exports.weather = 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"));
@@ -53,3 +53,4 @@ 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"));
+exports.weather = __importStar(require("./weather"));

package/dist/weather.d.ts

@@ -0,0 +1,81 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+export declare const protobufPackage = "hannah";
+/**
+ * Current weather conditions, discovered by the ioBroker adapter from a configured
+ * weather source and pushed via AgentMessage.weather_update. Field set is deliberately
+ * narrow: only what core/hannah/weather.py's spoken answers actually use today, plus
+ * humidity (cheap addition). Deliberately excluded from v1 (cheap to add later, not
+ * currently used by any sentence): pressure, clouds, wind_gust, visibility, sunrise/sunset.
+ */
+export interface WeatherCurrentData {
+    /** °C; role value.temperature */
+    temperature: number;
+    /** % relative humidity; role value.humidity */
+    humidity?: number | undefined;
+    /** short label e.g. "Rain"; role weather.title */
+    conditionSummary: string;
+    /** longer description; role weather.state */
+    conditionDetail: string;
+    /** role weather.precipitation.rain (fallback: weather.precipitation) */
+    precipitationMm?: number | undefined;
+    /** role value.speed.wind */
+    windSpeedMs?: number | undefined;
+    /** numeric variant of role value.direction.wind */
+    windDirectionDeg?: number | undefined;
+    /** string variant of the SAME role (disambiguate via common.type) */
+    windDirectionText?: string | undefined;
+    /** Unix timestamp of the source reading; role date (unit unverified live) */
+    observedAt: bigint;
+}
+/**
+ * One forecast day. day_offset 0=today .. 5=five days out, matching ioBroker's dayN
+ * channel suffix. Only day-granularity — openweathermap's 3-hourly periodN states
+ * (buggy role suffix weather.forecast.undefined) are explicitly out of scope.
+ */
+export interface WeatherForecastDay {
+    dayOffset: number;
+    /** role value.temperature.min */
+    temperatureMin?: number | undefined;
+    /** role value.temperature.max */
+    temperatureMax?: number | undefined;
+    /** role weather.title */
+    conditionSummary: string;
+    /** role weather.state */
+    conditionDetail: string;
+    /** role weather.precipitation.rain */
+    precipitationMm?: number | undefined;
+    /** role value.speed.wind */
+    windSpeedMs?: number | undefined;
+    /** role value.direction.wind (string variant) */
+    windDirectionText?: string | undefined;
+}
+/**
+ * Sent by the ioBroker adapter whenever its configured weather source changes.
+ * Full aggregated state, not a delta — Core replaces its cache wholesale on each message.
+ * current is absent until at least one value resolved; forecast is empty in "custom"
+ * mapping mode (current-conditions only, v1 scope).
+ */
+export interface AgentWeatherUpdate {
+    current?: WeatherCurrentData | undefined;
+    forecast: WeatherForecastDay[];
+}
+export declare const WeatherCurrentData: MessageFns<WeatherCurrentData>;
+export declare const WeatherForecastDay: MessageFns<WeatherForecastDay>;
+export declare const AgentWeatherUpdate: MessageFns<AgentWeatherUpdate>;
+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/weather.js

@@ -0,0 +1,336 @@
+"use strict";
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.12.0
+//   protoc               unknown
+// source: weather.proto
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentWeatherUpdate = exports.WeatherForecastDay = exports.WeatherCurrentData = exports.protobufPackage = void 0;
+/* eslint-disable */
+const wire_1 = require("@bufbuild/protobuf/wire");
+exports.protobufPackage = "hannah";
+function createBaseWeatherCurrentData() {
+    return {
+        temperature: 0,
+        humidity: undefined,
+        conditionSummary: "",
+        conditionDetail: "",
+        precipitationMm: undefined,
+        windSpeedMs: undefined,
+        windDirectionDeg: undefined,
+        windDirectionText: undefined,
+        observedAt: 0n,
+    };
+}
+exports.WeatherCurrentData = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.temperature !== 0) {
+            writer.uint32(13).float(message.temperature);
+        }
+        if (message.humidity !== undefined) {
+            writer.uint32(21).float(message.humidity);
+        }
+        if (message.conditionSummary !== "") {
+            writer.uint32(26).string(message.conditionSummary);
+        }
+        if (message.conditionDetail !== "") {
+            writer.uint32(34).string(message.conditionDetail);
+        }
+        if (message.precipitationMm !== undefined) {
+            writer.uint32(45).float(message.precipitationMm);
+        }
+        if (message.windSpeedMs !== undefined) {
+            writer.uint32(53).float(message.windSpeedMs);
+        }
+        if (message.windDirectionDeg !== undefined) {
+            writer.uint32(56).int32(message.windDirectionDeg);
+        }
+        if (message.windDirectionText !== undefined) {
+            writer.uint32(66).string(message.windDirectionText);
+        }
+        if (message.observedAt !== 0n) {
+            if (BigInt.asIntN(64, message.observedAt) !== message.observedAt) {
+                throw new globalThis.Error("value provided for field message.observedAt of type int64 too large");
+            }
+            writer.uint32(72).int64(message.observedAt);
+        }
+        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 = createBaseWeatherCurrentData();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 13) {
+                        break;
+                    }
+                    message.temperature = reader.float();
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 21) {
+                        break;
+                    }
+                    message.humidity = reader.float();
+                    continue;
+                }
+                case 3: {
+                    if (tag !== 26) {
+                        break;
+                    }
+                    message.conditionSummary = reader.string();
+                    continue;
+                }
+                case 4: {
+                    if (tag !== 34) {
+                        break;
+                    }
+                    message.conditionDetail = reader.string();
+                    continue;
+                }
+                case 5: {
+                    if (tag !== 45) {
+                        break;
+                    }
+                    message.precipitationMm = reader.float();
+                    continue;
+                }
+                case 6: {
+                    if (tag !== 53) {
+                        break;
+                    }
+                    message.windSpeedMs = reader.float();
+                    continue;
+                }
+                case 7: {
+                    if (tag !== 56) {
+                        break;
+                    }
+                    message.windDirectionDeg = reader.int32();
+                    continue;
+                }
+                case 8: {
+                    if (tag !== 66) {
+                        break;
+                    }
+                    message.windDirectionText = reader.string();
+                    continue;
+                }
+                case 9: {
+                    if (tag !== 72) {
+                        break;
+                    }
+                    message.observedAt = reader.int64();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    create(base) {
+        return exports.WeatherCurrentData.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseWeatherCurrentData();
+        message.temperature = object.temperature ?? 0;
+        message.humidity = object.humidity ?? undefined;
+        message.conditionSummary = object.conditionSummary ?? "";
+        message.conditionDetail = object.conditionDetail ?? "";
+        message.precipitationMm = object.precipitationMm ?? undefined;
+        message.windSpeedMs = object.windSpeedMs ?? undefined;
+        message.windDirectionDeg = object.windDirectionDeg ?? undefined;
+        message.windDirectionText = object.windDirectionText ?? undefined;
+        message.observedAt = (object.observedAt !== undefined && object.observedAt !== null)
+            ? BigInt(object.observedAt)
+            : 0n;
+        return message;
+    },
+};
+function createBaseWeatherForecastDay() {
+    return {
+        dayOffset: 0,
+        temperatureMin: undefined,
+        temperatureMax: undefined,
+        conditionSummary: "",
+        conditionDetail: "",
+        precipitationMm: undefined,
+        windSpeedMs: undefined,
+        windDirectionText: undefined,
+    };
+}
+exports.WeatherForecastDay = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.dayOffset !== 0) {
+            writer.uint32(8).int32(message.dayOffset);
+        }
+        if (message.temperatureMin !== undefined) {
+            writer.uint32(21).float(message.temperatureMin);
+        }
+        if (message.temperatureMax !== undefined) {
+            writer.uint32(29).float(message.temperatureMax);
+        }
+        if (message.conditionSummary !== "") {
+            writer.uint32(34).string(message.conditionSummary);
+        }
+        if (message.conditionDetail !== "") {
+            writer.uint32(42).string(message.conditionDetail);
+        }
+        if (message.precipitationMm !== undefined) {
+            writer.uint32(53).float(message.precipitationMm);
+        }
+        if (message.windSpeedMs !== undefined) {
+            writer.uint32(61).float(message.windSpeedMs);
+        }
+        if (message.windDirectionText !== undefined) {
+            writer.uint32(66).string(message.windDirectionText);
+        }
+        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 = createBaseWeatherForecastDay();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 8) {
+                        break;
+                    }
+                    message.dayOffset = reader.int32();
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 21) {
+                        break;
+                    }
+                    message.temperatureMin = reader.float();
+                    continue;
+                }
+                case 3: {
+                    if (tag !== 29) {
+                        break;
+                    }
+                    message.temperatureMax = reader.float();
+                    continue;
+                }
+                case 4: {
+                    if (tag !== 34) {
+                        break;
+                    }
+                    message.conditionSummary = reader.string();
+                    continue;
+                }
+                case 5: {
+                    if (tag !== 42) {
+                        break;
+                    }
+                    message.conditionDetail = reader.string();
+                    continue;
+                }
+                case 6: {
+                    if (tag !== 53) {
+                        break;
+                    }
+                    message.precipitationMm = reader.float();
+                    continue;
+                }
+                case 7: {
+                    if (tag !== 61) {
+                        break;
+                    }
+                    message.windSpeedMs = reader.float();
+                    continue;
+                }
+                case 8: {
+                    if (tag !== 66) {
+                        break;
+                    }
+                    message.windDirectionText = reader.string();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    create(base) {
+        return exports.WeatherForecastDay.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseWeatherForecastDay();
+        message.dayOffset = object.dayOffset ?? 0;
+        message.temperatureMin = object.temperatureMin ?? undefined;
+        message.temperatureMax = object.temperatureMax ?? undefined;
+        message.conditionSummary = object.conditionSummary ?? "";
+        message.conditionDetail = object.conditionDetail ?? "";
+        message.precipitationMm = object.precipitationMm ?? undefined;
+        message.windSpeedMs = object.windSpeedMs ?? undefined;
+        message.windDirectionText = object.windDirectionText ?? undefined;
+        return message;
+    },
+};
+function createBaseAgentWeatherUpdate() {
+    return { current: undefined, forecast: [] };
+}
+exports.AgentWeatherUpdate = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.current !== undefined) {
+            exports.WeatherCurrentData.encode(message.current, writer.uint32(10).fork()).join();
+        }
+        for (const v of message.forecast) {
+            exports.WeatherForecastDay.encode(v, 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 = createBaseAgentWeatherUpdate();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.current = exports.WeatherCurrentData.decode(reader, reader.uint32());
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 18) {
+                        break;
+                    }
+                    message.forecast.push(exports.WeatherForecastDay.decode(reader, reader.uint32()));
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    create(base) {
+        return exports.AgentWeatherUpdate.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseAgentWeatherUpdate();
+        message.current = (object.current !== undefined && object.current !== null)
+            ? exports.WeatherCurrentData.fromPartial(object.current)
+            : undefined;
+        message.forecast = object.forecast?.map((e) => exports.WeatherForecastDay.fromPartial(e)) || [];
+        return message;
+    },
+};

package/package.json

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