@m1kad0/hannah-proto 4.3.0 → 4.5.0

package/dist/compat_versions.js

@@ -82,9 +82,14 @@ exports.REQUIRED_COMPAT_VERSIONS = {
     "AutomationConnect": 1,
     "ChannelConnect": 1,
     "GetChannels": 1,
+    "SubscribeInfrastructure": 1,
+    "LogCollectorConnect": 1,
     "ListActivityLog": 1,
     "StreamActivityAudio": 1,
     "CreateMessage": 1,
     "ListMessages": 1,
-    "DeleteMessage": 1
+    "DeleteMessage": 1,
+    "Ship": 1,
+    "GetSources": 1,
+    "Export": 1
 };

package/dist/hannah.d.ts

@@ -7,6 +7,7 @@ import { ChannelCommand, ChannelMessage, GetChannelsResponse } from "./channel";
 import { AnnounceRequest, CreateAlarmRequest, CreateAlarmResponse, CreateBleTagRequest, CreateBleTagResponse, CreateCarRequest, CreateCarResponse, CreateGroupRequest, CreatePresenceSourceRequest, CreatePresenceSourceResponse, CreateTriggerRequest, DeleteAlarmRequest, DeleteBleTagRequest, DeleteCarRequest, DeleteGroupRequest, DeletePresenceSourceRequest, DeleteTriggerRequest, GetAlarmsResponse, GetBleTagsResponse, GetCarsResponse, GetGroupsResponse, GetPresenceSourcesResponse, GetRoomsResponse, GetSettingsResponse, GetTriggersResponse, SetGroupSatellitesRequest, SubmitTextRequest, SubmitTextResponse, SubmitVoiceRequest, SubmitVoiceResponse, UpdateAlarmRequest, UpdateBleTagRequest, UpdateCarRequest, UpdateConfigRequest, UpdateGroupRequest, UpdatePresenceSourceRequest, UpdateTriggerRequest } from "./control";
 import { ControlDeviceRequest, GetDevicesResponse } from "./device_control_menu";
 import { EventFilter, HannahEvent, TriggerFirmwareUpdateRequest, TriggerSatelliteRestartRequest } from "./event_stream";
+import { InfrastructureFilter, InfrastructureMessage, LogCollectorCommand, LogCollectorMessage } from "./infrastructure";
 import { CreateMessageRequest, DeleteMessageRequest, ListMessagesRequest, ListMessagesResponse } from "./messages";
 import { DeleteSatelliteRequest, GetSatellitesResponse, SetSatelliteDisplayNameRequest, SetSatelliteOwnerRequest, SetSatelliteRoomRequest, SetSatelliteSmalltalkFollowupRequest } from "./satellite";
 import { ProvisionSatelliteRequest } from "./satellite_provisioning";
@@ -872,6 +873,36 @@ export declare const HannahServiceService: {
         readonly responseSerialize: (value: GetChannelsResponse) => Buffer;
         readonly responseDeserialize: (value: Buffer) => GetChannelsResponse;
     };
+    /**
+     * --- Infrastructure ---
+     * Service discovery for components: Hannah sends an InfrastructureSnapshot of all
+     * currently available infrastructure services (e.g. the log collector) right after
+     * subscribing, followed by ServiceAvailable/ServiceUnavailable deltas.
+     */
+    readonly subscribeInfrastructure: {
+        readonly path: "/hannah.HannahService/SubscribeInfrastructure";
+        readonly requestStream: false;
+        readonly responseStream: true;
+        readonly requestSerialize: (value: InfrastructureFilter) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => InfrastructureFilter;
+        readonly responseSerialize: (value: InfrastructureMessage) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => InfrastructureMessage;
+    };
+    /**
+     * Bidirectional stream for the log collector. The collector sends a LogCollectorRegister
+     * and keeps the stream open; it counts as available exactly as long as the stream is
+     * open, and a second registration for the same instance replaces the first (same
+     * semantics as ChannelConnect). Not related to CollectorConnect (wakeword capture).
+     */
+    readonly logCollectorConnect: {
+        readonly path: "/hannah.HannahService/LogCollectorConnect";
+        readonly requestStream: true;
+        readonly responseStream: true;
+        readonly requestSerialize: (value: LogCollectorMessage) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => LogCollectorMessage;
+        readonly responseSerialize: (value: LogCollectorCommand) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => LogCollectorCommand;
+    };
     /**
      * --- Activity Log ---
      * Read access to the Activity Log (#220) for external consumers (WebUI). List returns
@@ -1155,6 +1186,20 @@ export interface HannahServiceServer extends UntypedServiceImplementation {
     channelConnect: handleBidiStreamingCall<ChannelMessage, ChannelCommand>;
     /** Currently connected channel adapters and whether they support account linking. */
     getChannels: handleUnaryCall<Empty, GetChannelsResponse>;
+    /**
+     * --- Infrastructure ---
+     * Service discovery for components: Hannah sends an InfrastructureSnapshot of all
+     * currently available infrastructure services (e.g. the log collector) right after
+     * subscribing, followed by ServiceAvailable/ServiceUnavailable deltas.
+     */
+    subscribeInfrastructure: handleServerStreamingCall<InfrastructureFilter, InfrastructureMessage>;
+    /**
+     * Bidirectional stream for the log collector. The collector sends a LogCollectorRegister
+     * and keeps the stream open; it counts as available exactly as long as the stream is
+     * open, and a second registration for the same instance replaces the first (same
+     * semantics as ChannelConnect). Not related to CollectorConnect (wakeword capture).
+     */
+    logCollectorConnect: handleBidiStreamingCall<LogCollectorMessage, LogCollectorCommand>;
     /**
      * --- Activity Log ---
      * Read access to the Activity Log (#220) for external consumers (WebUI). List returns
@@ -1552,6 +1597,23 @@ export interface HannahServiceClient extends Client {
     getChannels(request: Empty, callback: (error: ServiceError | null, response: GetChannelsResponse) => void): ClientUnaryCall;
     getChannels(request: Empty, metadata: Metadata, callback: (error: ServiceError | null, response: GetChannelsResponse) => void): ClientUnaryCall;
     getChannels(request: Empty, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: GetChannelsResponse) => void): ClientUnaryCall;
+    /**
+     * --- Infrastructure ---
+     * Service discovery for components: Hannah sends an InfrastructureSnapshot of all
+     * currently available infrastructure services (e.g. the log collector) right after
+     * subscribing, followed by ServiceAvailable/ServiceUnavailable deltas.
+     */
+    subscribeInfrastructure(request: InfrastructureFilter, options?: Partial<CallOptions>): ClientReadableStream<InfrastructureMessage>;
+    subscribeInfrastructure(request: InfrastructureFilter, metadata?: Metadata, options?: Partial<CallOptions>): ClientReadableStream<InfrastructureMessage>;
+    /**
+     * Bidirectional stream for the log collector. The collector sends a LogCollectorRegister
+     * and keeps the stream open; it counts as available exactly as long as the stream is
+     * open, and a second registration for the same instance replaces the first (same
+     * semantics as ChannelConnect). Not related to CollectorConnect (wakeword capture).
+     */
+    logCollectorConnect(): ClientDuplexStream<LogCollectorMessage, LogCollectorCommand>;
+    logCollectorConnect(options: Partial<CallOptions>): ClientDuplexStream<LogCollectorMessage, LogCollectorCommand>;
+    logCollectorConnect(metadata: Metadata, options?: Partial<CallOptions>): ClientDuplexStream<LogCollectorMessage, LogCollectorCommand>;
     /**
      * --- Activity Log ---
      * Read access to the Activity Log (#220) for external consumers (WebUI). List returns

package/dist/hannah.js

@@ -16,6 +16,7 @@ const channel_1 = require("./channel");
 const control_1 = require("./control");
 const device_control_menu_1 = require("./device_control_menu");
 const event_stream_1 = require("./event_stream");
+const infrastructure_1 = require("./infrastructure");
 const messages_1 = require("./messages");
 const satellite_1 = require("./satellite");
 const satellite_provisioning_1 = require("./satellite_provisioning");
@@ -880,6 +881,36 @@ exports.HannahServiceService = {
         responseSerialize: (value) => Buffer.from(channel_1.GetChannelsResponse.encode(value).finish()),
         responseDeserialize: (value) => channel_1.GetChannelsResponse.decode(value),
     },
+    /**
+     * --- Infrastructure ---
+     * Service discovery for components: Hannah sends an InfrastructureSnapshot of all
+     * currently available infrastructure services (e.g. the log collector) right after
+     * subscribing, followed by ServiceAvailable/ServiceUnavailable deltas.
+     */
+    subscribeInfrastructure: {
+        path: "/hannah.HannahService/SubscribeInfrastructure",
+        requestStream: false,
+        responseStream: true,
+        requestSerialize: (value) => Buffer.from(infrastructure_1.InfrastructureFilter.encode(value).finish()),
+        requestDeserialize: (value) => infrastructure_1.InfrastructureFilter.decode(value),
+        responseSerialize: (value) => Buffer.from(infrastructure_1.InfrastructureMessage.encode(value).finish()),
+        responseDeserialize: (value) => infrastructure_1.InfrastructureMessage.decode(value),
+    },
+    /**
+     * Bidirectional stream for the log collector. The collector sends a LogCollectorRegister
+     * and keeps the stream open; it counts as available exactly as long as the stream is
+     * open, and a second registration for the same instance replaces the first (same
+     * semantics as ChannelConnect). Not related to CollectorConnect (wakeword capture).
+     */
+    logCollectorConnect: {
+        path: "/hannah.HannahService/LogCollectorConnect",
+        requestStream: true,
+        responseStream: true,
+        requestSerialize: (value) => Buffer.from(infrastructure_1.LogCollectorMessage.encode(value).finish()),
+        requestDeserialize: (value) => infrastructure_1.LogCollectorMessage.decode(value),
+        responseSerialize: (value) => Buffer.from(infrastructure_1.LogCollectorCommand.encode(value).finish()),
+        responseDeserialize: (value) => infrastructure_1.LogCollectorCommand.decode(value),
+    },
     /**
      * --- Activity Log ---
      * Read access to the Activity Log (#220) for external consumers (WebUI). List returns

package/dist/index.d.ts

@@ -10,6 +10,8 @@ export * as control from './control';
 export * as device_control_menu from './device_control_menu';
 export * as event_stream from './event_stream';
 export * as hannah from './hannah';
+export * as infrastructure from './infrastructure';
+export * as logging from './logging';
 export * as messages from './messages';
 export * as options from './options';
 export * as satellite from './satellite';

package/dist/index.js

@@ -36,7 +36,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-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.satellite = exports.options = exports.messages = exports.hannah = exports.event_stream = exports.device_control_menu = exports.control = exports.compat_versions = exports.compat_interceptor = exports.channel = exports.car_state = exports.automation = exports.agent = exports.activity_log = 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.satellite = exports.options = exports.messages = exports.logging = exports.infrastructure = exports.hannah = exports.event_stream = exports.device_control_menu = exports.control = exports.compat_versions = exports.compat_interceptor = exports.channel = exports.car_state = exports.automation = exports.agent = exports.activity_log = void 0;
 __exportStar(require("./version"), exports);
 exports.activity_log = __importStar(require("./activity_log"));
 exports.agent = __importStar(require("./agent"));
@@ -49,6 +49,8 @@ exports.control = __importStar(require("./control"));
 exports.device_control_menu = __importStar(require("./device_control_menu"));
 exports.event_stream = __importStar(require("./event_stream"));
 exports.hannah = __importStar(require("./hannah"));
+exports.infrastructure = __importStar(require("./infrastructure"));
+exports.logging = __importStar(require("./logging"));
 exports.messages = __importStar(require("./messages"));
 exports.options = __importStar(require("./options"));
 exports.satellite = __importStar(require("./satellite"));

package/dist/infrastructure.d.ts

@@ -0,0 +1,98 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+export declare const protobufPackage = "hannah";
+/**
+ * Infrastructure services that Hannah Core announces to all connected components
+ * (service discovery). Typed on purpose — a new kind of service gets a new enum value,
+ * a fundamentally new use case gets its own oneof branch, never a generic key/value bag.
+ */
+export declare enum ServiceKind {
+    SERVICE_KIND_UNSPECIFIED = 0,
+    SERVICE_KIND_LOG_COLLECTOR = 1,
+    UNRECOGNIZED = -1
+}
+/** Where a currently available infrastructure service can be reached. */
+export interface ServiceEndpoint {
+    kind: ServiceKind;
+    instance: string;
+    host: string;
+    port: number;
+    /** informational */
+    version: string;
+}
+/** Which kinds of service the subscriber cares about. Empty = all kinds. */
+export interface InfrastructureFilter {
+    kinds: ServiceKind[];
+}
+export interface InfrastructureMessage {
+    /** sent once, right after subscribing */
+    snapshot?: InfrastructureSnapshot | undefined;
+    /** live delta */
+    available?: ServiceAvailable | undefined;
+    /** live delta */
+    unavailable?: ServiceUnavailable | undefined;
+}
+/**
+ * All matching services available right now. Sent once per subscription, before any
+ * delta — a subscriber replaces its whole state with it, so a reconnect never keeps a
+ * service that disappeared while it was offline.
+ */
+export interface InfrastructureSnapshot {
+    services: ServiceEndpoint[];
+}
+/** A service became available, or an available one re-registered (e.g. new address). */
+export interface ServiceAvailable {
+    service: ServiceEndpoint | undefined;
+}
+/** A service is no longer available (its registration stream ended or was displaced). */
+export interface ServiceUnavailable {
+    kind: ServiceKind;
+    instance: string;
+}
+/** Sent by the log collector over the LogCollectorConnect stream. */
+export interface LogCollectorMessage {
+    /** sent once, right after connecting */
+    register?: LogCollectorRegister | undefined;
+}
+/** A second log collector registering with the same instance replaces the first. */
+export interface LogCollectorRegister {
+    instance: string;
+    /** empty = Hannah Core uses the stream's peer address */
+    host: string;
+    port: number;
+    /** informational */
+    version: string;
+}
+/** Sent by Hannah Core over the LogCollectorConnect stream. */
+export interface LogCollectorCommand {
+    /** sent once, right after register */
+    registered?: LogCollectorRegistered | undefined;
+}
+export interface LogCollectorRegistered {
+}
+export declare const ServiceEndpoint: MessageFns<ServiceEndpoint>;
+export declare const InfrastructureFilter: MessageFns<InfrastructureFilter>;
+export declare const InfrastructureMessage: MessageFns<InfrastructureMessage>;
+export declare const InfrastructureSnapshot: MessageFns<InfrastructureSnapshot>;
+export declare const ServiceAvailable: MessageFns<ServiceAvailable>;
+export declare const ServiceUnavailable: MessageFns<ServiceUnavailable>;
+export declare const LogCollectorMessage: MessageFns<LogCollectorMessage>;
+export declare const LogCollectorRegister: MessageFns<LogCollectorRegister>;
+export declare const LogCollectorCommand: MessageFns<LogCollectorCommand>;
+export declare const LogCollectorRegistered: MessageFns<LogCollectorRegistered>;
+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 {};