@m1kad0/hannah-proto 4.4.0 → 4.5.0

package/dist/compat_versions.js

@@ -88,5 +88,8 @@ exports.REQUIRED_COMPAT_VERSIONS = {
     "StreamActivityAudio": 1,
     "CreateMessage": 1,
     "ListMessages": 1,
-    "DeleteMessage": 1
+    "DeleteMessage": 1,
+    "Ship": 1,
+    "GetSources": 1,
+    "Export": 1
 };

package/dist/index.d.ts

@@ -11,6 +11,7 @@ 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.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;
+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"));
@@ -50,6 +50,7 @@ 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/logging.d.ts

@@ -0,0 +1,189 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+import { type CallOptions, type ChannelCredentials, Client, type ClientOptions, type ClientReadableStream, type ClientUnaryCall, type ClientWritableStream, type handleClientStreamingCall, type handleServerStreamingCall, type handleUnaryCall, type Metadata, type ServiceError, type UntypedServiceImplementation } from "@grpc/grpc-js";
+import { Empty } from "./shared";
+export declare const protobufPackage = "hannah";
+export declare enum LogLevel {
+    LOG_LEVEL_UNSPECIFIED = 0,
+    LOG_LEVEL_DEBUG = 1,
+    LOG_LEVEL_INFO = 2,
+    LOG_LEVEL_WARNING = 3,
+    LOG_LEVEL_ERROR = 4,
+    LOG_LEVEL_CRITICAL = 5,
+    UNRECOGNIZED = -1
+}
+/** Lets an export leave out sensitive content (e.g. before posting it in a forum). */
+export declare enum LogCategory {
+    LOG_CATEGORY_UNSPECIFIED = 0,
+    LOG_CATEGORY_GENERAL = 1,
+    /** LOG_CATEGORY_TRANSCRIPT - speech transcripts / user utterances */
+    LOG_CATEGORY_TRANSCRIPT = 2,
+    /** LOG_CATEGORY_METADATA - room/device names, presence and similar */
+    LOG_CATEGORY_METADATA = 3,
+    UNRECOGNIZED = -1
+}
+export interface ShipMessage {
+    /** exactly once, as the first message */
+    hello?: ShipHello | undefined;
+    entry?: LogEntry | undefined;
+    /** the component's buffer overflowed, entries were dropped */
+    gap?: LogGap | undefined;
+}
+/** Identifies the source of all entries on this stream. */
+export interface ShipHello {
+    /** e.g. "core", "telegram", "voiceid" */
+    component: string;
+    /** distinguishes several instances of the same component */
+    instance: string;
+    /** component version, shown in the export manifest */
+    version: string;
+}
+export interface LogEntry {
+    /** Unix ms at the time of logging in the component, not of receipt */
+    timestampMs: bigint;
+    level: LogLevel;
+    /** e.g. the Python logger name */
+    logger: string;
+    /** secrets are filtered out by the component before sending */
+    message: string;
+    category: LogCategory;
+}
+/**
+ * Entries the component had to drop (buffer overflow while the collector was
+ * unreachable). Listed in the export manifest so gaps are visible.
+ */
+export interface LogGap {
+    dropped: bigint;
+    fromMs: bigint;
+    toMs: bigint;
+}
+export interface ShipAck {
+    /** number of entries stored from this stream */
+    accepted: bigint;
+}
+export interface LogSource {
+    component: string;
+    instance: string;
+    /** from the most recent ShipHello */
+    version: string;
+    oldestMs: bigint;
+    newestMs: bigint;
+    entries: bigint;
+}
+export interface GetSourcesResponse {
+    sources: LogSource[];
+}
+export interface ExportRequest {
+    sinceMs: bigint;
+    /** 0 = now */
+    untilMs: bigint;
+    /** empty = all */
+    components: string[];
+    excludeCategories: LogCategory[];
+}
+export interface ExportChunk {
+    data: Uint8Array;
+}
+export declare const ShipMessage: MessageFns<ShipMessage>;
+export declare const ShipHello: MessageFns<ShipHello>;
+export declare const LogEntry: MessageFns<LogEntry>;
+export declare const LogGap: MessageFns<LogGap>;
+export declare const ShipAck: MessageFns<ShipAck>;
+export declare const LogSource: MessageFns<LogSource>;
+export declare const GetSourcesResponse: MessageFns<GetSourcesResponse>;
+export declare const ExportRequest: MessageFns<ExportRequest>;
+export declare const ExportChunk: MessageFns<ExportChunk>;
+export type LogServiceService = typeof LogServiceService;
+export declare const LogServiceService: {
+    /**
+     * Component → collector. First message is a ShipHello, then any number of
+     * entries/gaps. The stream stays open for as long as the component runs.
+     */
+    readonly ship: {
+        readonly path: "/hannah.LogService/Ship";
+        readonly requestStream: true;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: ShipMessage) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => ShipMessage;
+        readonly responseSerialize: (value: ShipAck) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => ShipAck;
+    };
+    /** Which sources the collector currently holds logs for, and how far back. */
+    readonly getSources: {
+        readonly path: "/hannah.LogService/GetSources";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: Empty) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => Empty;
+        readonly responseSerialize: (value: GetSourcesResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => GetSourcesResponse;
+    };
+    /**
+     * Archive of the requested logs (tar.gz: one file per source plus a manifest),
+     * split into chunks — the client concatenates ExportChunk.data in order.
+     */
+    readonly export: {
+        readonly path: "/hannah.LogService/Export";
+        readonly requestStream: false;
+        readonly responseStream: true;
+        readonly requestSerialize: (value: ExportRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => ExportRequest;
+        readonly responseSerialize: (value: ExportChunk) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => ExportChunk;
+    };
+};
+export interface LogServiceServer extends UntypedServiceImplementation {
+    /**
+     * Component → collector. First message is a ShipHello, then any number of
+     * entries/gaps. The stream stays open for as long as the component runs.
+     */
+    ship: handleClientStreamingCall<ShipMessage, ShipAck>;
+    /** Which sources the collector currently holds logs for, and how far back. */
+    getSources: handleUnaryCall<Empty, GetSourcesResponse>;
+    /**
+     * Archive of the requested logs (tar.gz: one file per source plus a manifest),
+     * split into chunks — the client concatenates ExportChunk.data in order.
+     */
+    export: handleServerStreamingCall<ExportRequest, ExportChunk>;
+}
+export interface LogServiceClient extends Client {
+    /**
+     * Component → collector. First message is a ShipHello, then any number of
+     * entries/gaps. The stream stays open for as long as the component runs.
+     */
+    ship(callback: (error: ServiceError | null, response: ShipAck) => void): ClientWritableStream<ShipMessage>;
+    ship(metadata: Metadata, callback: (error: ServiceError | null, response: ShipAck) => void): ClientWritableStream<ShipMessage>;
+    ship(options: Partial<CallOptions>, callback: (error: ServiceError | null, response: ShipAck) => void): ClientWritableStream<ShipMessage>;
+    ship(metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: ShipAck) => void): ClientWritableStream<ShipMessage>;
+    /** Which sources the collector currently holds logs for, and how far back. */
+    getSources(request: Empty, callback: (error: ServiceError | null, response: GetSourcesResponse) => void): ClientUnaryCall;
+    getSources(request: Empty, metadata: Metadata, callback: (error: ServiceError | null, response: GetSourcesResponse) => void): ClientUnaryCall;
+    getSources(request: Empty, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: GetSourcesResponse) => void): ClientUnaryCall;
+    /**
+     * Archive of the requested logs (tar.gz: one file per source plus a manifest),
+     * split into chunks — the client concatenates ExportChunk.data in order.
+     */
+    export(request: ExportRequest, options?: Partial<CallOptions>): ClientReadableStream<ExportChunk>;
+    export(request: ExportRequest, metadata?: Metadata, options?: Partial<CallOptions>): ClientReadableStream<ExportChunk>;
+}
+export declare const LogServiceClient: {
+    new (address: string, credentials: ChannelCredentials, options?: Partial<ClientOptions>): LogServiceClient;
+    service: typeof LogServiceService;
+    serviceName: string;
+};
+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/logging.js

@@ -0,0 +1,775 @@
+"use strict";
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.12.1
+//   protoc               unknown
+// source: hannah/logging.proto
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogServiceClient = exports.LogServiceService = exports.ExportChunk = exports.ExportRequest = exports.GetSourcesResponse = exports.LogSource = exports.ShipAck = exports.LogGap = exports.LogEntry = exports.ShipHello = exports.ShipMessage = exports.LogCategory = exports.LogLevel = exports.protobufPackage = void 0;
+/* eslint-disable */
+const wire_1 = require("@bufbuild/protobuf/wire");
+const grpc_js_1 = require("@grpc/grpc-js");
+const shared_1 = require("./shared");
+exports.protobufPackage = "hannah";
+var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["LOG_LEVEL_UNSPECIFIED"] = 0] = "LOG_LEVEL_UNSPECIFIED";
+    LogLevel[LogLevel["LOG_LEVEL_DEBUG"] = 1] = "LOG_LEVEL_DEBUG";
+    LogLevel[LogLevel["LOG_LEVEL_INFO"] = 2] = "LOG_LEVEL_INFO";
+    LogLevel[LogLevel["LOG_LEVEL_WARNING"] = 3] = "LOG_LEVEL_WARNING";
+    LogLevel[LogLevel["LOG_LEVEL_ERROR"] = 4] = "LOG_LEVEL_ERROR";
+    LogLevel[LogLevel["LOG_LEVEL_CRITICAL"] = 5] = "LOG_LEVEL_CRITICAL";
+    LogLevel[LogLevel["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+/** Lets an export leave out sensitive content (e.g. before posting it in a forum). */
+var LogCategory;
+(function (LogCategory) {
+    LogCategory[LogCategory["LOG_CATEGORY_UNSPECIFIED"] = 0] = "LOG_CATEGORY_UNSPECIFIED";
+    LogCategory[LogCategory["LOG_CATEGORY_GENERAL"] = 1] = "LOG_CATEGORY_GENERAL";
+    /** LOG_CATEGORY_TRANSCRIPT - speech transcripts / user utterances */
+    LogCategory[LogCategory["LOG_CATEGORY_TRANSCRIPT"] = 2] = "LOG_CATEGORY_TRANSCRIPT";
+    /** LOG_CATEGORY_METADATA - room/device names, presence and similar */
+    LogCategory[LogCategory["LOG_CATEGORY_METADATA"] = 3] = "LOG_CATEGORY_METADATA";
+    LogCategory[LogCategory["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
+})(LogCategory || (exports.LogCategory = LogCategory = {}));
+function createBaseShipMessage() {
+    return { hello: undefined, entry: undefined, gap: undefined };
+}
+exports.ShipMessage = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.hello !== undefined) {
+            exports.ShipHello.encode(message.hello, writer.uint32(10).fork()).join();
+        }
+        if (message.entry !== undefined) {
+            exports.LogEntry.encode(message.entry, writer.uint32(18).fork()).join();
+        }
+        if (message.gap !== undefined) {
+            exports.LogGap.encode(message.gap, writer.uint32(26).fork()).join();
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const previousRecursionDepth = reader.__tsProtoDecodeDepth ?? 0;
+        if (previousRecursionDepth >= 100) {
+            throw new globalThis.Error("protobuf decode recursion limit exceeded");
+        }
+        reader.__tsProtoDecodeDepth = previousRecursionDepth + 1;
+        try {
+            const end = length === undefined ? reader.len : reader.pos + length;
+            const message = createBaseShipMessage();
+            while (reader.pos < end) {
+                const tag = reader.uint32();
+                switch (tag >>> 3) {
+                    case 1: {
+                        if (tag !== 10) {
+                            break;
+                        }
+                        message.hello = exports.ShipHello.decode(reader, reader.uint32());
+                        continue;
+                    }
+                    case 2: {
+                        if (tag !== 18) {
+                            break;
+                        }
+                        message.entry = exports.LogEntry.decode(reader, reader.uint32());
+                        continue;
+                    }
+                    case 3: {
+                        if (tag !== 26) {
+                            break;
+                        }
+                        message.gap = exports.LogGap.decode(reader, reader.uint32());
+                        continue;
+                    }
+                }
+                if ((tag & 7) === 4 || tag === 0) {
+                    break;
+                }
+                reader.skip(tag & 7);
+            }
+            return message;
+        }
+        finally {
+            reader.__tsProtoDecodeDepth = previousRecursionDepth;
+        }
+    },
+    create(base) {
+        return exports.ShipMessage.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseShipMessage();
+        message.hello = (object.hello !== undefined && object.hello !== null)
+            ? exports.ShipHello.fromPartial(object.hello)
+            : undefined;
+        message.entry = (object.entry !== undefined && object.entry !== null)
+            ? exports.LogEntry.fromPartial(object.entry)
+            : undefined;
+        message.gap = (object.gap !== undefined && object.gap !== null) ? exports.LogGap.fromPartial(object.gap) : undefined;
+        return message;
+    },
+};
+function createBaseShipHello() {
+    return { component: "", instance: "", version: "" };
+}
+exports.ShipHello = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.component !== "") {
+            writer.uint32(10).string(message.component);
+        }
+        if (message.instance !== "") {
+            writer.uint32(18).string(message.instance);
+        }
+        if (message.version !== "") {
+            writer.uint32(26).string(message.version);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const previousRecursionDepth = reader.__tsProtoDecodeDepth ?? 0;
+        if (previousRecursionDepth >= 100) {
+            throw new globalThis.Error("protobuf decode recursion limit exceeded");
+        }
+        reader.__tsProtoDecodeDepth = previousRecursionDepth + 1;
+        try {
+            const end = length === undefined ? reader.len : reader.pos + length;
+            const message = createBaseShipHello();
+            while (reader.pos < end) {
+                const tag = reader.uint32();
+                switch (tag >>> 3) {
+                    case 1: {
+                        if (tag !== 10) {
+                            break;
+                        }
+                        message.component = reader.string();
+                        continue;
+                    }
+                    case 2: {
+                        if (tag !== 18) {
+                            break;
+                        }
+                        message.instance = reader.string();
+                        continue;
+                    }
+                    case 3: {
+                        if (tag !== 26) {
+                            break;
+                        }
+                        message.version = reader.string();
+                        continue;
+                    }
+                }
+                if ((tag & 7) === 4 || tag === 0) {
+                    break;
+                }
+                reader.skip(tag & 7);
+            }
+            return message;
+        }
+        finally {
+            reader.__tsProtoDecodeDepth = previousRecursionDepth;
+        }
+    },
+    create(base) {
+        return exports.ShipHello.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseShipHello();
+        message.component = object.component ?? "";
+        message.instance = object.instance ?? "";
+        message.version = object.version ?? "";
+        return message;
+    },
+};
+function createBaseLogEntry() {
+    return { timestampMs: 0n, level: 0, logger: "", message: "", category: 0 };
+}
+exports.LogEntry = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.timestampMs !== 0n) {
+            if (BigInt.asIntN(64, message.timestampMs) !== message.timestampMs) {
+                throw new globalThis.Error("value provided for field message.timestampMs of type int64 too large");
+            }
+            writer.uint32(8).int64(message.timestampMs);
+        }
+        if (message.level !== 0) {
+            writer.uint32(16).int32(message.level);
+        }
+        if (message.logger !== "") {
+            writer.uint32(26).string(message.logger);
+        }
+        if (message.message !== "") {
+            writer.uint32(34).string(message.message);
+        }
+        if (message.category !== 0) {
+            writer.uint32(40).int32(message.category);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const previousRecursionDepth = reader.__tsProtoDecodeDepth ?? 0;
+        if (previousRecursionDepth >= 100) {
+            throw new globalThis.Error("protobuf decode recursion limit exceeded");
+        }
+        reader.__tsProtoDecodeDepth = previousRecursionDepth + 1;
+        try {
+            const end = length === undefined ? reader.len : reader.pos + length;
+            const message = createBaseLogEntry();
+            while (reader.pos < end) {
+                const tag = reader.uint32();
+                switch (tag >>> 3) {
+                    case 1: {
+                        if (tag !== 8) {
+                            break;
+                        }
+                        message.timestampMs = reader.int64();
+                        continue;
+                    }
+                    case 2: {
+                        if (tag !== 16) {
+                            break;
+                        }
+                        message.level = reader.int32();
+                        continue;
+                    }
+                    case 3: {
+                        if (tag !== 26) {
+                            break;
+                        }
+                        message.logger = reader.string();
+                        continue;
+                    }
+                    case 4: {
+                        if (tag !== 34) {
+                            break;
+                        }
+                        message.message = reader.string();
+                        continue;
+                    }
+                    case 5: {
+                        if (tag !== 40) {
+                            break;
+                        }
+                        message.category = reader.int32();
+                        continue;
+                    }
+                }
+                if ((tag & 7) === 4 || tag === 0) {
+                    break;
+                }
+                reader.skip(tag & 7);
+            }
+            return message;
+        }
+        finally {
+            reader.__tsProtoDecodeDepth = previousRecursionDepth;
+        }
+    },
+    create(base) {
+        return exports.LogEntry.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseLogEntry();
+        message.timestampMs = (object.timestampMs !== undefined && object.timestampMs !== null)
+            ? BigInt(object.timestampMs)
+            : 0n;
+        message.level = object.level ?? 0;
+        message.logger = object.logger ?? "";
+        message.message = object.message ?? "";
+        message.category = object.category ?? 0;
+        return message;
+    },
+};
+function createBaseLogGap() {
+    return { dropped: 0n, fromMs: 0n, toMs: 0n };
+}
+exports.LogGap = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.dropped !== 0n) {
+            if (BigInt.asIntN(64, message.dropped) !== message.dropped) {
+                throw new globalThis.Error("value provided for field message.dropped of type int64 too large");
+            }
+            writer.uint32(8).int64(message.dropped);
+        }
+        if (message.fromMs !== 0n) {
+            if (BigInt.asIntN(64, message.fromMs) !== message.fromMs) {
+                throw new globalThis.Error("value provided for field message.fromMs of type int64 too large");
+            }
+            writer.uint32(16).int64(message.fromMs);
+        }
+        if (message.toMs !== 0n) {
+            if (BigInt.asIntN(64, message.toMs) !== message.toMs) {
+                throw new globalThis.Error("value provided for field message.toMs of type int64 too large");
+            }
+            writer.uint32(24).int64(message.toMs);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const previousRecursionDepth = reader.__tsProtoDecodeDepth ?? 0;
+        if (previousRecursionDepth >= 100) {
+            throw new globalThis.Error("protobuf decode recursion limit exceeded");
+        }
+        reader.__tsProtoDecodeDepth = previousRecursionDepth + 1;
+        try {
+            const end = length === undefined ? reader.len : reader.pos + length;
+            const message = createBaseLogGap();
+            while (reader.pos < end) {
+                const tag = reader.uint32();
+                switch (tag >>> 3) {
+                    case 1: {
+                        if (tag !== 8) {
+                            break;
+                        }
+                        message.dropped = reader.int64();
+                        continue;
+                    }
+                    case 2: {
+                        if (tag !== 16) {
+                            break;
+                        }
+                        message.fromMs = reader.int64();
+                        continue;
+                    }
+                    case 3: {
+                        if (tag !== 24) {
+                            break;
+                        }
+                        message.toMs = reader.int64();
+                        continue;
+                    }
+                }
+                if ((tag & 7) === 4 || tag === 0) {
+                    break;
+                }
+                reader.skip(tag & 7);
+            }
+            return message;
+        }
+        finally {
+            reader.__tsProtoDecodeDepth = previousRecursionDepth;
+        }
+    },
+    create(base) {
+        return exports.LogGap.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseLogGap();
+        message.dropped = (object.dropped !== undefined && object.dropped !== null) ? BigInt(object.dropped) : 0n;
+        message.fromMs = (object.fromMs !== undefined && object.fromMs !== null) ? BigInt(object.fromMs) : 0n;
+        message.toMs = (object.toMs !== undefined && object.toMs !== null) ? BigInt(object.toMs) : 0n;
+        return message;
+    },
+};
+function createBaseShipAck() {
+    return { accepted: 0n };
+}
+exports.ShipAck = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.accepted !== 0n) {
+            if (BigInt.asIntN(64, message.accepted) !== message.accepted) {
+                throw new globalThis.Error("value provided for field message.accepted of type int64 too large");
+            }
+            writer.uint32(8).int64(message.accepted);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const previousRecursionDepth = reader.__tsProtoDecodeDepth ?? 0;
+        if (previousRecursionDepth >= 100) {
+            throw new globalThis.Error("protobuf decode recursion limit exceeded");
+        }
+        reader.__tsProtoDecodeDepth = previousRecursionDepth + 1;
+        try {
+            const end = length === undefined ? reader.len : reader.pos + length;
+            const message = createBaseShipAck();
+            while (reader.pos < end) {
+                const tag = reader.uint32();
+                switch (tag >>> 3) {
+                    case 1: {
+                        if (tag !== 8) {
+                            break;
+                        }
+                        message.accepted = reader.int64();
+                        continue;
+                    }
+                }
+                if ((tag & 7) === 4 || tag === 0) {
+                    break;
+                }
+                reader.skip(tag & 7);
+            }
+            return message;
+        }
+        finally {
+            reader.__tsProtoDecodeDepth = previousRecursionDepth;
+        }
+    },
+    create(base) {
+        return exports.ShipAck.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseShipAck();
+        message.accepted = (object.accepted !== undefined && object.accepted !== null) ? BigInt(object.accepted) : 0n;
+        return message;
+    },
+};
+function createBaseLogSource() {
+    return { component: "", instance: "", version: "", oldestMs: 0n, newestMs: 0n, entries: 0n };
+}
+exports.LogSource = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.component !== "") {
+            writer.uint32(10).string(message.component);
+        }
+        if (message.instance !== "") {
+            writer.uint32(18).string(message.instance);
+        }
+        if (message.version !== "") {
+            writer.uint32(26).string(message.version);
+        }
+        if (message.oldestMs !== 0n) {
+            if (BigInt.asIntN(64, message.oldestMs) !== message.oldestMs) {
+                throw new globalThis.Error("value provided for field message.oldestMs of type int64 too large");
+            }
+            writer.uint32(32).int64(message.oldestMs);
+        }
+        if (message.newestMs !== 0n) {
+            if (BigInt.asIntN(64, message.newestMs) !== message.newestMs) {
+                throw new globalThis.Error("value provided for field message.newestMs of type int64 too large");
+            }
+            writer.uint32(40).int64(message.newestMs);
+        }
+        if (message.entries !== 0n) {
+            if (BigInt.asIntN(64, message.entries) !== message.entries) {
+                throw new globalThis.Error("value provided for field message.entries of type int64 too large");
+            }
+            writer.uint32(48).int64(message.entries);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const previousRecursionDepth = reader.__tsProtoDecodeDepth ?? 0;
+        if (previousRecursionDepth >= 100) {
+            throw new globalThis.Error("protobuf decode recursion limit exceeded");
+        }
+        reader.__tsProtoDecodeDepth = previousRecursionDepth + 1;
+        try {
+            const end = length === undefined ? reader.len : reader.pos + length;
+            const message = createBaseLogSource();
+            while (reader.pos < end) {
+                const tag = reader.uint32();
+                switch (tag >>> 3) {
+                    case 1: {
+                        if (tag !== 10) {
+                            break;
+                        }
+                        message.component = reader.string();
+                        continue;
+                    }
+                    case 2: {
+                        if (tag !== 18) {
+                            break;
+                        }
+                        message.instance = reader.string();
+                        continue;
+                    }
+                    case 3: {
+                        if (tag !== 26) {
+                            break;
+                        }
+                        message.version = reader.string();
+                        continue;
+                    }
+                    case 4: {
+                        if (tag !== 32) {
+                            break;
+                        }
+                        message.oldestMs = reader.int64();
+                        continue;
+                    }
+                    case 5: {
+                        if (tag !== 40) {
+                            break;
+                        }
+                        message.newestMs = reader.int64();
+                        continue;
+                    }
+                    case 6: {
+                        if (tag !== 48) {
+                            break;
+                        }
+                        message.entries = reader.int64();
+                        continue;
+                    }
+                }
+                if ((tag & 7) === 4 || tag === 0) {
+                    break;
+                }
+                reader.skip(tag & 7);
+            }
+            return message;
+        }
+        finally {
+            reader.__tsProtoDecodeDepth = previousRecursionDepth;
+        }
+    },
+    create(base) {
+        return exports.LogSource.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseLogSource();
+        message.component = object.component ?? "";
+        message.instance = object.instance ?? "";
+        message.version = object.version ?? "";
+        message.oldestMs = (object.oldestMs !== undefined && object.oldestMs !== null) ? BigInt(object.oldestMs) : 0n;
+        message.newestMs = (object.newestMs !== undefined && object.newestMs !== null) ? BigInt(object.newestMs) : 0n;
+        message.entries = (object.entries !== undefined && object.entries !== null) ? BigInt(object.entries) : 0n;
+        return message;
+    },
+};
+function createBaseGetSourcesResponse() {
+    return { sources: [] };
+}
+exports.GetSourcesResponse = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        for (const v of message.sources) {
+            exports.LogSource.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 previousRecursionDepth = reader.__tsProtoDecodeDepth ?? 0;
+        if (previousRecursionDepth >= 100) {
+            throw new globalThis.Error("protobuf decode recursion limit exceeded");
+        }
+        reader.__tsProtoDecodeDepth = previousRecursionDepth + 1;
+        try {
+            const end = length === undefined ? reader.len : reader.pos + length;
+            const message = createBaseGetSourcesResponse();
+            while (reader.pos < end) {
+                const tag = reader.uint32();
+                switch (tag >>> 3) {
+                    case 1: {
+                        if (tag !== 10) {
+                            break;
+                        }
+                        message.sources.push(exports.LogSource.decode(reader, reader.uint32()));
+                        continue;
+                    }
+                }
+                if ((tag & 7) === 4 || tag === 0) {
+                    break;
+                }
+                reader.skip(tag & 7);
+            }
+            return message;
+        }
+        finally {
+            reader.__tsProtoDecodeDepth = previousRecursionDepth;
+        }
+    },
+    create(base) {
+        return exports.GetSourcesResponse.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseGetSourcesResponse();
+        message.sources = object.sources?.map((e) => exports.LogSource.fromPartial(e)) || [];
+        return message;
+    },
+};
+function createBaseExportRequest() {
+    return { sinceMs: 0n, untilMs: 0n, components: [], excludeCategories: [] };
+}
+exports.ExportRequest = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.sinceMs !== 0n) {
+            if (BigInt.asIntN(64, message.sinceMs) !== message.sinceMs) {
+                throw new globalThis.Error("value provided for field message.sinceMs of type int64 too large");
+            }
+            writer.uint32(8).int64(message.sinceMs);
+        }
+        if (message.untilMs !== 0n) {
+            if (BigInt.asIntN(64, message.untilMs) !== message.untilMs) {
+                throw new globalThis.Error("value provided for field message.untilMs of type int64 too large");
+            }
+            writer.uint32(16).int64(message.untilMs);
+        }
+        for (const v of message.components) {
+            writer.uint32(26).string(v);
+        }
+        writer.uint32(34).fork();
+        for (const v of message.excludeCategories) {
+            writer.int32(v);
+        }
+        writer.join();
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const previousRecursionDepth = reader.__tsProtoDecodeDepth ?? 0;
+        if (previousRecursionDepth >= 100) {
+            throw new globalThis.Error("protobuf decode recursion limit exceeded");
+        }
+        reader.__tsProtoDecodeDepth = previousRecursionDepth + 1;
+        try {
+            const end = length === undefined ? reader.len : reader.pos + length;
+            const message = createBaseExportRequest();
+            while (reader.pos < end) {
+                const tag = reader.uint32();
+                switch (tag >>> 3) {
+                    case 1: {
+                        if (tag !== 8) {
+                            break;
+                        }
+                        message.sinceMs = reader.int64();
+                        continue;
+                    }
+                    case 2: {
+                        if (tag !== 16) {
+                            break;
+                        }
+                        message.untilMs = reader.int64();
+                        continue;
+                    }
+                    case 3: {
+                        if (tag !== 26) {
+                            break;
+                        }
+                        message.components.push(reader.string());
+                        continue;
+                    }
+                    case 4: {
+                        if (tag === 32) {
+                            message.excludeCategories.push(reader.int32());
+                            continue;
+                        }
+                        if (tag === 34) {
+                            const end2 = reader.uint32() + reader.pos;
+                            while (reader.pos < end2) {
+                                message.excludeCategories.push(reader.int32());
+                            }
+                            continue;
+                        }
+                        break;
+                    }
+                }
+                if ((tag & 7) === 4 || tag === 0) {
+                    break;
+                }
+                reader.skip(tag & 7);
+            }
+            return message;
+        }
+        finally {
+            reader.__tsProtoDecodeDepth = previousRecursionDepth;
+        }
+    },
+    create(base) {
+        return exports.ExportRequest.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseExportRequest();
+        message.sinceMs = (object.sinceMs !== undefined && object.sinceMs !== null) ? BigInt(object.sinceMs) : 0n;
+        message.untilMs = (object.untilMs !== undefined && object.untilMs !== null) ? BigInt(object.untilMs) : 0n;
+        message.components = object.components?.map((e) => e) || [];
+        message.excludeCategories = object.excludeCategories?.map((e) => e) || [];
+        return message;
+    },
+};
+function createBaseExportChunk() {
+    return { data: new Uint8Array(0) };
+}
+exports.ExportChunk = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.data.length !== 0) {
+            writer.uint32(10).bytes(message.data);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const previousRecursionDepth = reader.__tsProtoDecodeDepth ?? 0;
+        if (previousRecursionDepth >= 100) {
+            throw new globalThis.Error("protobuf decode recursion limit exceeded");
+        }
+        reader.__tsProtoDecodeDepth = previousRecursionDepth + 1;
+        try {
+            const end = length === undefined ? reader.len : reader.pos + length;
+            const message = createBaseExportChunk();
+            while (reader.pos < end) {
+                const tag = reader.uint32();
+                switch (tag >>> 3) {
+                    case 1: {
+                        if (tag !== 10) {
+                            break;
+                        }
+                        message.data = reader.bytes();
+                        continue;
+                    }
+                }
+                if ((tag & 7) === 4 || tag === 0) {
+                    break;
+                }
+                reader.skip(tag & 7);
+            }
+            return message;
+        }
+        finally {
+            reader.__tsProtoDecodeDepth = previousRecursionDepth;
+        }
+    },
+    create(base) {
+        return exports.ExportChunk.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseExportChunk();
+        message.data = object.data ?? new Uint8Array(0);
+        return message;
+    },
+};
+exports.LogServiceService = {
+    /**
+     * Component → collector. First message is a ShipHello, then any number of
+     * entries/gaps. The stream stays open for as long as the component runs.
+     */
+    ship: {
+        path: "/hannah.LogService/Ship",
+        requestStream: true,
+        responseStream: false,
+        requestSerialize: (value) => Buffer.from(exports.ShipMessage.encode(value).finish()),
+        requestDeserialize: (value) => exports.ShipMessage.decode(value),
+        responseSerialize: (value) => Buffer.from(exports.ShipAck.encode(value).finish()),
+        responseDeserialize: (value) => exports.ShipAck.decode(value),
+    },
+    /** Which sources the collector currently holds logs for, and how far back. */
+    getSources: {
+        path: "/hannah.LogService/GetSources",
+        requestStream: false,
+        responseStream: false,
+        requestSerialize: (value) => Buffer.from(shared_1.Empty.encode(value).finish()),
+        requestDeserialize: (value) => shared_1.Empty.decode(value),
+        responseSerialize: (value) => Buffer.from(exports.GetSourcesResponse.encode(value).finish()),
+        responseDeserialize: (value) => exports.GetSourcesResponse.decode(value),
+    },
+    /**
+     * Archive of the requested logs (tar.gz: one file per source plus a manifest),
+     * split into chunks — the client concatenates ExportChunk.data in order.
+     */
+    export: {
+        path: "/hannah.LogService/Export",
+        requestStream: false,
+        responseStream: true,
+        requestSerialize: (value) => Buffer.from(exports.ExportRequest.encode(value).finish()),
+        requestDeserialize: (value) => exports.ExportRequest.decode(value),
+        responseSerialize: (value) => Buffer.from(exports.ExportChunk.encode(value).finish()),
+        responseDeserialize: (value) => exports.ExportChunk.decode(value),
+    },
+};
+exports.LogServiceClient = (0, grpc_js_1.makeGenericClientConstructor)(exports.LogServiceService, "hannah.LogService");

package/package.json

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