@m1kad0/hannah-proto 3.3.1 → 3.5.0

package/dist/activity_log.d.ts

@@ -0,0 +1,60 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+export declare const protobufPackage = "hannah";
+export interface ActivityLogEntry {
+    id: bigint;
+    ts: string;
+    channelType: string;
+    channelId: string;
+    /** 0 = unresolved/unset */
+    userId: number;
+    rawText: string;
+    intentName: string;
+    /** JSON-encoded, "" = none */
+    intentMetaJson: string;
+    answerText: string;
+    /** audio_path was set — tells the caller whether to offer playback */
+    hasAudio: boolean;
+}
+export interface ListActivityLogRequest {
+    requestorId: number;
+    /** only honored when requestor's trust_level >= 10; 0 = no target filter */
+    filterUserId: number;
+    pageSize: number;
+    /** cursor, 0 = start from newest */
+    beforeId: bigint;
+}
+export interface ListActivityLogResponse {
+    entries: ActivityLogEntry[];
+    hasMore: boolean;
+}
+export interface StreamActivityAudioRequest {
+    requestorId: number;
+    activityLogId: bigint;
+}
+/** A chunk of raw PCM audio (16-bit signed, mono) streamed from a single Activity Log entry. */
+export interface ActivityAudioChunk {
+    pcm: Uint8Array;
+    sampleRate: number;
+}
+export declare const ActivityLogEntry: MessageFns<ActivityLogEntry>;
+export declare const ListActivityLogRequest: MessageFns<ListActivityLogRequest>;
+export declare const ListActivityLogResponse: MessageFns<ListActivityLogResponse>;
+export declare const StreamActivityAudioRequest: MessageFns<StreamActivityAudioRequest>;
+export declare const ActivityAudioChunk: MessageFns<ActivityAudioChunk>;
+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/activity_log.js

@@ -0,0 +1,403 @@
+"use strict";
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.12.0
+//   protoc               unknown
+// source: hannah/activity_log.proto
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActivityAudioChunk = exports.StreamActivityAudioRequest = exports.ListActivityLogResponse = exports.ListActivityLogRequest = exports.ActivityLogEntry = exports.protobufPackage = void 0;
+/* eslint-disable */
+const wire_1 = require("@bufbuild/protobuf/wire");
+exports.protobufPackage = "hannah";
+function createBaseActivityLogEntry() {
+    return {
+        id: 0n,
+        ts: "",
+        channelType: "",
+        channelId: "",
+        userId: 0,
+        rawText: "",
+        intentName: "",
+        intentMetaJson: "",
+        answerText: "",
+        hasAudio: false,
+    };
+}
+exports.ActivityLogEntry = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.id !== 0n) {
+            if (BigInt.asIntN(64, message.id) !== message.id) {
+                throw new globalThis.Error("value provided for field message.id of type int64 too large");
+            }
+            writer.uint32(8).int64(message.id);
+        }
+        if (message.ts !== "") {
+            writer.uint32(18).string(message.ts);
+        }
+        if (message.channelType !== "") {
+            writer.uint32(26).string(message.channelType);
+        }
+        if (message.channelId !== "") {
+            writer.uint32(34).string(message.channelId);
+        }
+        if (message.userId !== 0) {
+            writer.uint32(40).int32(message.userId);
+        }
+        if (message.rawText !== "") {
+            writer.uint32(50).string(message.rawText);
+        }
+        if (message.intentName !== "") {
+            writer.uint32(58).string(message.intentName);
+        }
+        if (message.intentMetaJson !== "") {
+            writer.uint32(66).string(message.intentMetaJson);
+        }
+        if (message.answerText !== "") {
+            writer.uint32(74).string(message.answerText);
+        }
+        if (message.hasAudio !== false) {
+            writer.uint32(80).bool(message.hasAudio);
+        }
+        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 = createBaseActivityLogEntry();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 8) {
+                        break;
+                    }
+                    message.id = reader.int64();
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 18) {
+                        break;
+                    }
+                    message.ts = reader.string();
+                    continue;
+                }
+                case 3: {
+                    if (tag !== 26) {
+                        break;
+                    }
+                    message.channelType = reader.string();
+                    continue;
+                }
+                case 4: {
+                    if (tag !== 34) {
+                        break;
+                    }
+                    message.channelId = reader.string();
+                    continue;
+                }
+                case 5: {
+                    if (tag !== 40) {
+                        break;
+                    }
+                    message.userId = reader.int32();
+                    continue;
+                }
+                case 6: {
+                    if (tag !== 50) {
+                        break;
+                    }
+                    message.rawText = reader.string();
+                    continue;
+                }
+                case 7: {
+                    if (tag !== 58) {
+                        break;
+                    }
+                    message.intentName = reader.string();
+                    continue;
+                }
+                case 8: {
+                    if (tag !== 66) {
+                        break;
+                    }
+                    message.intentMetaJson = reader.string();
+                    continue;
+                }
+                case 9: {
+                    if (tag !== 74) {
+                        break;
+                    }
+                    message.answerText = reader.string();
+                    continue;
+                }
+                case 10: {
+                    if (tag !== 80) {
+                        break;
+                    }
+                    message.hasAudio = reader.bool();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    create(base) {
+        return exports.ActivityLogEntry.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseActivityLogEntry();
+        message.id = (object.id !== undefined && object.id !== null) ? BigInt(object.id) : 0n;
+        message.ts = object.ts ?? "";
+        message.channelType = object.channelType ?? "";
+        message.channelId = object.channelId ?? "";
+        message.userId = object.userId ?? 0;
+        message.rawText = object.rawText ?? "";
+        message.intentName = object.intentName ?? "";
+        message.intentMetaJson = object.intentMetaJson ?? "";
+        message.answerText = object.answerText ?? "";
+        message.hasAudio = object.hasAudio ?? false;
+        return message;
+    },
+};
+function createBaseListActivityLogRequest() {
+    return { requestorId: 0, filterUserId: 0, pageSize: 0, beforeId: 0n };
+}
+exports.ListActivityLogRequest = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.requestorId !== 0) {
+            writer.uint32(8).int32(message.requestorId);
+        }
+        if (message.filterUserId !== 0) {
+            writer.uint32(16).int32(message.filterUserId);
+        }
+        if (message.pageSize !== 0) {
+            writer.uint32(24).int32(message.pageSize);
+        }
+        if (message.beforeId !== 0n) {
+            if (BigInt.asIntN(64, message.beforeId) !== message.beforeId) {
+                throw new globalThis.Error("value provided for field message.beforeId of type int64 too large");
+            }
+            writer.uint32(32).int64(message.beforeId);
+        }
+        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 = createBaseListActivityLogRequest();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 8) {
+                        break;
+                    }
+                    message.requestorId = reader.int32();
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 16) {
+                        break;
+                    }
+                    message.filterUserId = reader.int32();
+                    continue;
+                }
+                case 3: {
+                    if (tag !== 24) {
+                        break;
+                    }
+                    message.pageSize = reader.int32();
+                    continue;
+                }
+                case 4: {
+                    if (tag !== 32) {
+                        break;
+                    }
+                    message.beforeId = reader.int64();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    create(base) {
+        return exports.ListActivityLogRequest.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseListActivityLogRequest();
+        message.requestorId = object.requestorId ?? 0;
+        message.filterUserId = object.filterUserId ?? 0;
+        message.pageSize = object.pageSize ?? 0;
+        message.beforeId = (object.beforeId !== undefined && object.beforeId !== null) ? BigInt(object.beforeId) : 0n;
+        return message;
+    },
+};
+function createBaseListActivityLogResponse() {
+    return { entries: [], hasMore: false };
+}
+exports.ListActivityLogResponse = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        for (const v of message.entries) {
+            exports.ActivityLogEntry.encode(v, writer.uint32(10).fork()).join();
+        }
+        if (message.hasMore !== false) {
+            writer.uint32(16).bool(message.hasMore);
+        }
+        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 = createBaseListActivityLogResponse();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.entries.push(exports.ActivityLogEntry.decode(reader, reader.uint32()));
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 16) {
+                        break;
+                    }
+                    message.hasMore = reader.bool();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    create(base) {
+        return exports.ListActivityLogResponse.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseListActivityLogResponse();
+        message.entries = object.entries?.map((e) => exports.ActivityLogEntry.fromPartial(e)) || [];
+        message.hasMore = object.hasMore ?? false;
+        return message;
+    },
+};
+function createBaseStreamActivityAudioRequest() {
+    return { requestorId: 0, activityLogId: 0n };
+}
+exports.StreamActivityAudioRequest = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.requestorId !== 0) {
+            writer.uint32(8).int32(message.requestorId);
+        }
+        if (message.activityLogId !== 0n) {
+            if (BigInt.asIntN(64, message.activityLogId) !== message.activityLogId) {
+                throw new globalThis.Error("value provided for field message.activityLogId of type int64 too large");
+            }
+            writer.uint32(16).int64(message.activityLogId);
+        }
+        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 = createBaseStreamActivityAudioRequest();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 8) {
+                        break;
+                    }
+                    message.requestorId = reader.int32();
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 16) {
+                        break;
+                    }
+                    message.activityLogId = reader.int64();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    create(base) {
+        return exports.StreamActivityAudioRequest.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseStreamActivityAudioRequest();
+        message.requestorId = object.requestorId ?? 0;
+        message.activityLogId = (object.activityLogId !== undefined && object.activityLogId !== null)
+            ? BigInt(object.activityLogId)
+            : 0n;
+        return message;
+    },
+};
+function createBaseActivityAudioChunk() {
+    return { pcm: new Uint8Array(0), sampleRate: 0 };
+}
+exports.ActivityAudioChunk = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.pcm.length !== 0) {
+            writer.uint32(10).bytes(message.pcm);
+        }
+        if (message.sampleRate !== 0) {
+            writer.uint32(16).int32(message.sampleRate);
+        }
+        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 = createBaseActivityAudioChunk();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.pcm = reader.bytes();
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 16) {
+                        break;
+                    }
+                    message.sampleRate = reader.int32();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    create(base) {
+        return exports.ActivityAudioChunk.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseActivityAudioChunk();
+        message.pcm = object.pcm ?? new Uint8Array(0);
+        message.sampleRate = object.sampleRate ?? 0;
+        return message;
+    },
+};

package/dist/compat_versions.js

@@ -61,6 +61,7 @@ exports.REQUIRED_COMPAT_VERSIONS = {
     "ReleaseSatelliteCapture": 1,
     "StreamSatelliteAudio": 1,
     "TriggerPlink": 1,
+    "CollectorConnect": 1,
     "RegisterProxy": 1,
     "SubmitSatelliteAudio": 1,
     "NotifySatelliteRegistered": 1,
@@ -71,5 +72,7 @@ exports.REQUIRED_COMPAT_VERSIONS = {
     "GetTimers": 1,
     "DeleteTimer": 1,
     "AgentConnect": 1,
-    "AutomationConnect": 1
+    "AutomationConnect": 1,
+    "ListActivityLog": 1,
+    "StreamActivityAudio": 1
 };

package/dist/hannah.d.ts

@@ -1,4 +1,5 @@
 import { type CallOptions, type ChannelCredentials, Client, type ClientDuplexStream, type ClientOptions, type ClientReadableStream, type ClientUnaryCall, type handleBidiStreamingCall, type handleServerStreamingCall, type handleUnaryCall, type Metadata, type ServiceError, type UntypedServiceImplementation } from "@grpc/grpc-js";
+import { ActivityAudioChunk, ListActivityLogRequest, ListActivityLogResponse, StreamActivityAudioRequest } from "./activity_log";
 import { AgentCommand, AgentMessage, AgentNotification } from "./agent";
 import { AutomationCommand, AutomationMessage } from "./automation";
 import { CarStateResponse, GetAllCarStatesResponse } from "./car_state";
@@ -13,7 +14,7 @@ import { EnrollVoiceprintRequest } from "./speaker_enrollment";
 import { DeleteTimerRequest, GetTimersRequest, GetTimersResponse } from "./timer_admin";
 import { TimerCommand, TimerMessage } from "./timer_service";
 import { CreateUserRequest, CreateUserResponse, DeleteUserRequest, GetResidentsResponse, GetUserRequest, GetUsersRequest, GetUsersResponse, LinkAccountRequest, LoginRequest, SetAutomationRequest, SetSystemMessagesRequest, SetTrustLevelRequest, UnlinkAccountRequest, UpdateUserRequest, UserResponse } from "./user_registry";
-import { SatelliteAudioChunk, SatelliteCaptureRequest, SatelliteCaptureResponse, TriggerPlinkRequest } from "./wakeword_capture";
+import { CaptureCommand, CollectorMessage, SatelliteAudioChunk, SatelliteCaptureRequest, SatelliteCaptureResponse, TriggerPlinkRequest } from "./wakeword_capture";
 export declare const protobufPackage = "hannah";
 export type HannahServiceService = typeof HannahServiceService;
 export declare const HannahServiceService: {
@@ -603,6 +604,20 @@ export declare const HannahServiceService: {
         readonly responseSerialize: (value: StatusResponse) => Buffer;
         readonly responseDeserialize: (value: Buffer) => StatusResponse;
     };
+    /**
+     * Bidirectional stream between the Collector and Hannah Core, analogous to TimerConnect.
+     * The Collector initiates and holds the connection open; Hannah pushes CaptureCommands
+     * down to start/stop satellite captures instead of the Collector polling for them.
+     */
+    readonly collectorConnect: {
+        readonly path: "/hannah.HannahService/CollectorConnect";
+        readonly requestStream: true;
+        readonly responseStream: true;
+        readonly requestSerialize: (value: CollectorMessage) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => CollectorMessage;
+        readonly responseSerialize: (value: CaptureCommand) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => CaptureCommand;
+    };
     /**
      * --- Satellite Proxy (Go gRPC proxy) ---
      * Bidirectional keepalive stream. Proxy sends heartbeats; Hannah sends TTS
@@ -750,6 +765,31 @@ export declare const HannahServiceService: {
         readonly responseSerialize: (value: AutomationCommand) => Buffer;
         readonly responseDeserialize: (value: Buffer) => AutomationCommand;
     };
+    /**
+     * --- Activity Log ---
+     * Read access to the Activity Log (#220) for external consumers (WebUI). List returns
+     * full entry detail inline (transcript, intent + intent_meta, answer text) with
+     * cursor-based pagination; audio is fetched separately, decoded server-side from the
+     * stored WAV and streamed as raw PCM chunks.
+     */
+    readonly listActivityLog: {
+        readonly path: "/hannah.HannahService/ListActivityLog";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: ListActivityLogRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => ListActivityLogRequest;
+        readonly responseSerialize: (value: ListActivityLogResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => ListActivityLogResponse;
+    };
+    readonly streamActivityAudio: {
+        readonly path: "/hannah.HannahService/StreamActivityAudio";
+        readonly requestStream: false;
+        readonly responseStream: true;
+        readonly requestSerialize: (value: StreamActivityAudioRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => StreamActivityAudioRequest;
+        readonly responseSerialize: (value: ActivityAudioChunk) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => ActivityAudioChunk;
+    };
 };
 export interface HannahServiceServer extends UntypedServiceImplementation {
     /** --- User Registry --- */
@@ -882,6 +922,12 @@ export interface HannahServiceServer extends UntypedServiceImplementation {
      * Returns after PTT is released — Collector calls this in a loop for guided hey-hannah collection.
      */
     triggerPlink: handleUnaryCall<TriggerPlinkRequest, StatusResponse>;
+    /**
+     * Bidirectional stream between the Collector and Hannah Core, analogous to TimerConnect.
+     * The Collector initiates and holds the connection open; Hannah pushes CaptureCommands
+     * down to start/stop satellite captures instead of the Collector polling for them.
+     */
+    collectorConnect: handleBidiStreamingCall<CollectorMessage, CaptureCommand>;
     /**
      * --- Satellite Proxy (Go gRPC proxy) ---
      * Bidirectional keepalive stream. Proxy sends heartbeats; Hannah sends TTS
@@ -941,6 +987,15 @@ export interface HannahServiceServer extends UntypedServiceImplementation {
      * instead of missing state changes that happened while it was offline.
      */
     automationConnect: handleBidiStreamingCall<AutomationMessage, AutomationCommand>;
+    /**
+     * --- Activity Log ---
+     * Read access to the Activity Log (#220) for external consumers (WebUI). List returns
+     * full entry detail inline (transcript, intent + intent_meta, answer text) with
+     * cursor-based pagination; audio is fetched separately, decoded server-side from the
+     * stored WAV and streamed as raw PCM chunks.
+     */
+    listActivityLog: handleUnaryCall<ListActivityLogRequest, ListActivityLogResponse>;
+    streamActivityAudio: handleServerStreamingCall<StreamActivityAudioRequest, ActivityAudioChunk>;
 }
 export interface HannahServiceClient extends Client {
     /** --- User Registry --- */
@@ -1185,6 +1240,14 @@ export interface HannahServiceClient extends Client {
     triggerPlink(request: TriggerPlinkRequest, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
     triggerPlink(request: TriggerPlinkRequest, metadata: Metadata, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
     triggerPlink(request: TriggerPlinkRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: StatusResponse) => void): ClientUnaryCall;
+    /**
+     * Bidirectional stream between the Collector and Hannah Core, analogous to TimerConnect.
+     * The Collector initiates and holds the connection open; Hannah pushes CaptureCommands
+     * down to start/stop satellite captures instead of the Collector polling for them.
+     */
+    collectorConnect(): ClientDuplexStream<CollectorMessage, CaptureCommand>;
+    collectorConnect(options: Partial<CallOptions>): ClientDuplexStream<CollectorMessage, CaptureCommand>;
+    collectorConnect(metadata: Metadata, options?: Partial<CallOptions>): ClientDuplexStream<CollectorMessage, CaptureCommand>;
     /**
      * --- Satellite Proxy (Go gRPC proxy) ---
      * Bidirectional keepalive stream. Proxy sends heartbeats; Hannah sends TTS
@@ -1266,6 +1329,18 @@ export interface HannahServiceClient extends Client {
     automationConnect(): ClientDuplexStream<AutomationMessage, AutomationCommand>;
     automationConnect(options: Partial<CallOptions>): ClientDuplexStream<AutomationMessage, AutomationCommand>;
     automationConnect(metadata: Metadata, options?: Partial<CallOptions>): ClientDuplexStream<AutomationMessage, AutomationCommand>;
+    /**
+     * --- Activity Log ---
+     * Read access to the Activity Log (#220) for external consumers (WebUI). List returns
+     * full entry detail inline (transcript, intent + intent_meta, answer text) with
+     * cursor-based pagination; audio is fetched separately, decoded server-side from the
+     * stored WAV and streamed as raw PCM chunks.
+     */
+    listActivityLog(request: ListActivityLogRequest, callback: (error: ServiceError | null, response: ListActivityLogResponse) => void): ClientUnaryCall;
+    listActivityLog(request: ListActivityLogRequest, metadata: Metadata, callback: (error: ServiceError | null, response: ListActivityLogResponse) => void): ClientUnaryCall;
+    listActivityLog(request: ListActivityLogRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: ListActivityLogResponse) => void): ClientUnaryCall;
+    streamActivityAudio(request: StreamActivityAudioRequest, options?: Partial<CallOptions>): ClientReadableStream<ActivityAudioChunk>;
+    streamActivityAudio(request: StreamActivityAudioRequest, metadata?: Metadata, options?: Partial<CallOptions>): ClientReadableStream<ActivityAudioChunk>;
 }
 export declare const HannahServiceClient: {
     new (address: string, credentials: ChannelCredentials, options?: Partial<ClientOptions>): HannahServiceClient;

package/dist/hannah.js

@@ -8,6 +8,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.HannahServiceClient = exports.HannahServiceService = exports.protobufPackage = void 0;
 /* eslint-disable */
 const grpc_js_1 = require("@grpc/grpc-js");
+const activity_log_1 = require("./activity_log");
 const agent_1 = require("./agent");
 const automation_1 = require("./automation");
 const car_state_1 = require("./car_state");
@@ -611,6 +612,20 @@ exports.HannahServiceService = {
         responseSerialize: (value) => Buffer.from(shared_1.StatusResponse.encode(value).finish()),
         responseDeserialize: (value) => shared_1.StatusResponse.decode(value),
     },
+    /**
+     * Bidirectional stream between the Collector and Hannah Core, analogous to TimerConnect.
+     * The Collector initiates and holds the connection open; Hannah pushes CaptureCommands
+     * down to start/stop satellite captures instead of the Collector polling for them.
+     */
+    collectorConnect: {
+        path: "/hannah.HannahService/CollectorConnect",
+        requestStream: true,
+        responseStream: true,
+        requestSerialize: (value) => Buffer.from(wakeword_capture_1.CollectorMessage.encode(value).finish()),
+        requestDeserialize: (value) => wakeword_capture_1.CollectorMessage.decode(value),
+        responseSerialize: (value) => Buffer.from(wakeword_capture_1.CaptureCommand.encode(value).finish()),
+        responseDeserialize: (value) => wakeword_capture_1.CaptureCommand.decode(value),
+    },
     /**
      * --- Satellite Proxy (Go gRPC proxy) ---
      * Bidirectional keepalive stream. Proxy sends heartbeats; Hannah sends TTS
@@ -758,5 +773,30 @@ exports.HannahServiceService = {
         responseSerialize: (value) => Buffer.from(automation_1.AutomationCommand.encode(value).finish()),
         responseDeserialize: (value) => automation_1.AutomationCommand.decode(value),
     },
+    /**
+     * --- Activity Log ---
+     * Read access to the Activity Log (#220) for external consumers (WebUI). List returns
+     * full entry detail inline (transcript, intent + intent_meta, answer text) with
+     * cursor-based pagination; audio is fetched separately, decoded server-side from the
+     * stored WAV and streamed as raw PCM chunks.
+     */
+    listActivityLog: {
+        path: "/hannah.HannahService/ListActivityLog",
+        requestStream: false,
+        responseStream: false,
+        requestSerialize: (value) => Buffer.from(activity_log_1.ListActivityLogRequest.encode(value).finish()),
+        requestDeserialize: (value) => activity_log_1.ListActivityLogRequest.decode(value),
+        responseSerialize: (value) => Buffer.from(activity_log_1.ListActivityLogResponse.encode(value).finish()),
+        responseDeserialize: (value) => activity_log_1.ListActivityLogResponse.decode(value),
+    },
+    streamActivityAudio: {
+        path: "/hannah.HannahService/StreamActivityAudio",
+        requestStream: false,
+        responseStream: true,
+        requestSerialize: (value) => Buffer.from(activity_log_1.StreamActivityAudioRequest.encode(value).finish()),
+        requestDeserialize: (value) => activity_log_1.StreamActivityAudioRequest.decode(value),
+        responseSerialize: (value) => Buffer.from(activity_log_1.ActivityAudioChunk.encode(value).finish()),
+        responseDeserialize: (value) => activity_log_1.ActivityAudioChunk.decode(value),
+    },
 };
 exports.HannahServiceClient = (0, grpc_js_1.makeGenericClientConstructor)(exports.HannahServiceService, "hannah.HannahService");

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './version';
+export * as activity_log from './activity_log';
 export * as agent from './agent';
 export * as automation from './automation';
 export * as car_state from './car_state';

package/dist/index.js

@@ -36,8 +36,9 @@ 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.hannah = exports.event_stream = exports.device_control_menu = exports.control = exports.compat_versions = exports.compat_interceptor = 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.satellite = exports.options = exports.hannah = exports.event_stream = exports.device_control_menu = exports.control = exports.compat_versions = exports.compat_interceptor = 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"));
 exports.automation = __importStar(require("./automation"));
 exports.car_state = __importStar(require("./car_state"));

package/dist/wakeword_capture.d.ts

@@ -1,5 +1,12 @@
 import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
 export declare const protobufPackage = "hannah";
+export declare enum CaptureMode {
+    CAPTURE_MODE_UNSPECIFIED = 0,
+    CAPTURE_MODE_MANUAL = 1,
+    CAPTURE_MODE_PTT = 2,
+    CAPTURE_MODE_PLINK = 3,
+    UNRECOGNIZED = -1
+}
 export interface SatelliteCaptureRequest {
     deviceId: string;
     /**
@@ -32,10 +39,50 @@ export interface SatelliteAudioChunk {
     /** true = PTT released, utterance boundary */
     endOfUtterance: boolean;
 }
+/**
+ * Sent by Hannah Core over the CollectorConnect stream to start or stop a
+ * satellite capture — the Collector-side counterpart to RequestSatelliteCapture/
+ * ReleaseSatelliteCapture, pushed proactively instead of polled.
+ * capture_mode is only meaningful when sample_type is hey_hannah.
+ */
+export interface CaptureCommand {
+    deviceId: string;
+    sampleType: SampleType | undefined;
+    captureMode: CaptureMode;
+    stop: boolean;
+}
+/**
+ * Deliberately a oneof of (currently empty) payload messages rather than a plain
+ * enum — leaves room to attach per-sample-type data later without a breaking change.
+ */
+export interface SampleType {
+    noise?: NoiseSample | undefined;
+    heyHannah?: HeyHannahSample | undefined;
+}
+export interface NoiseSample {
+}
+export interface HeyHannahSample {
+}
+/** Sent by the Collector over the CollectorConnect stream. */
+export interface CollectorMessage {
+    /** initial confirmation when stream is established */
+    ack?: CollectorAck | undefined;
+}
+/** Sent once by the Collector after the CollectorConnect stream is established. */
+export interface CollectorAck {
+    /** human-readable status */
+    message: string;
+}
 export declare const SatelliteCaptureRequest: MessageFns<SatelliteCaptureRequest>;
 export declare const TriggerPlinkRequest: MessageFns<TriggerPlinkRequest>;
 export declare const SatelliteCaptureResponse: MessageFns<SatelliteCaptureResponse>;
 export declare const SatelliteAudioChunk: MessageFns<SatelliteAudioChunk>;
+export declare const CaptureCommand: MessageFns<CaptureCommand>;
+export declare const SampleType: MessageFns<SampleType>;
+export declare const NoiseSample: MessageFns<NoiseSample>;
+export declare const HeyHannahSample: MessageFns<HeyHannahSample>;
+export declare const CollectorMessage: MessageFns<CollectorMessage>;
+export declare const CollectorAck: MessageFns<CollectorAck>;
 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]>;

package/dist/wakeword_capture.js

@@ -5,10 +5,18 @@
 //   protoc               unknown
 // source: hannah/wakeword_capture.proto
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SatelliteAudioChunk = exports.SatelliteCaptureResponse = exports.TriggerPlinkRequest = exports.SatelliteCaptureRequest = exports.protobufPackage = void 0;
+exports.CollectorAck = exports.CollectorMessage = exports.HeyHannahSample = exports.NoiseSample = exports.SampleType = exports.CaptureCommand = exports.SatelliteAudioChunk = exports.SatelliteCaptureResponse = exports.TriggerPlinkRequest = exports.SatelliteCaptureRequest = exports.CaptureMode = exports.protobufPackage = void 0;
 /* eslint-disable */
 const wire_1 = require("@bufbuild/protobuf/wire");
 exports.protobufPackage = "hannah";
+var CaptureMode;
+(function (CaptureMode) {
+    CaptureMode[CaptureMode["CAPTURE_MODE_UNSPECIFIED"] = 0] = "CAPTURE_MODE_UNSPECIFIED";
+    CaptureMode[CaptureMode["CAPTURE_MODE_MANUAL"] = 1] = "CAPTURE_MODE_MANUAL";
+    CaptureMode[CaptureMode["CAPTURE_MODE_PTT"] = 2] = "CAPTURE_MODE_PTT";
+    CaptureMode[CaptureMode["CAPTURE_MODE_PLINK"] = 3] = "CAPTURE_MODE_PLINK";
+    CaptureMode[CaptureMode["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
+})(CaptureMode || (exports.CaptureMode = CaptureMode = {}));
 function createBaseSatelliteCaptureRequest() {
     return { deviceId: "", sampleType: "" };
 }
@@ -228,3 +236,277 @@ exports.SatelliteAudioChunk = {
         return message;
     },
 };
+function createBaseCaptureCommand() {
+    return { deviceId: "", sampleType: undefined, captureMode: 0, stop: false };
+}
+exports.CaptureCommand = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.deviceId !== "") {
+            writer.uint32(10).string(message.deviceId);
+        }
+        if (message.sampleType !== undefined) {
+            exports.SampleType.encode(message.sampleType, writer.uint32(18).fork()).join();
+        }
+        if (message.captureMode !== 0) {
+            writer.uint32(24).int32(message.captureMode);
+        }
+        if (message.stop !== false) {
+            writer.uint32(32).bool(message.stop);
+        }
+        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 = createBaseCaptureCommand();
+        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 !== 18) {
+                        break;
+                    }
+                    message.sampleType = exports.SampleType.decode(reader, reader.uint32());
+                    continue;
+                }
+                case 3: {
+                    if (tag !== 24) {
+                        break;
+                    }
+                    message.captureMode = reader.int32();
+                    continue;
+                }
+                case 4: {
+                    if (tag !== 32) {
+                        break;
+                    }
+                    message.stop = reader.bool();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    create(base) {
+        return exports.CaptureCommand.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseCaptureCommand();
+        message.deviceId = object.deviceId ?? "";
+        message.sampleType = (object.sampleType !== undefined && object.sampleType !== null)
+            ? exports.SampleType.fromPartial(object.sampleType)
+            : undefined;
+        message.captureMode = object.captureMode ?? 0;
+        message.stop = object.stop ?? false;
+        return message;
+    },
+};
+function createBaseSampleType() {
+    return { noise: undefined, heyHannah: undefined };
+}
+exports.SampleType = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.noise !== undefined) {
+            exports.NoiseSample.encode(message.noise, writer.uint32(10).fork()).join();
+        }
+        if (message.heyHannah !== undefined) {
+            exports.HeyHannahSample.encode(message.heyHannah, 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 = createBaseSampleType();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.noise = exports.NoiseSample.decode(reader, reader.uint32());
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 18) {
+                        break;
+                    }
+                    message.heyHannah = exports.HeyHannahSample.decode(reader, reader.uint32());
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    create(base) {
+        return exports.SampleType.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseSampleType();
+        message.noise = (object.noise !== undefined && object.noise !== null)
+            ? exports.NoiseSample.fromPartial(object.noise)
+            : undefined;
+        message.heyHannah = (object.heyHannah !== undefined && object.heyHannah !== null)
+            ? exports.HeyHannahSample.fromPartial(object.heyHannah)
+            : undefined;
+        return message;
+    },
+};
+function createBaseNoiseSample() {
+    return {};
+}
+exports.NoiseSample = {
+    encode(_, writer = new wire_1.BinaryWriter()) {
+        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 = createBaseNoiseSample();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    create(base) {
+        return exports.NoiseSample.fromPartial(base ?? {});
+    },
+    fromPartial(_) {
+        const message = createBaseNoiseSample();
+        return message;
+    },
+};
+function createBaseHeyHannahSample() {
+    return {};
+}
+exports.HeyHannahSample = {
+    encode(_, writer = new wire_1.BinaryWriter()) {
+        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 = createBaseHeyHannahSample();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    create(base) {
+        return exports.HeyHannahSample.fromPartial(base ?? {});
+    },
+    fromPartial(_) {
+        const message = createBaseHeyHannahSample();
+        return message;
+    },
+};
+function createBaseCollectorMessage() {
+    return { ack: undefined };
+}
+exports.CollectorMessage = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.ack !== undefined) {
+            exports.CollectorAck.encode(message.ack, writer.uint32(10).fork()).join();
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseCollectorMessage();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.ack = exports.CollectorAck.decode(reader, reader.uint32());
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    create(base) {
+        return exports.CollectorMessage.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseCollectorMessage();
+        message.ack = (object.ack !== undefined && object.ack !== null) ? exports.CollectorAck.fromPartial(object.ack) : undefined;
+        return message;
+    },
+};
+function createBaseCollectorAck() {
+    return { message: "" };
+}
+exports.CollectorAck = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.message !== "") {
+            writer.uint32(10).string(message.message);
+        }
+        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 = createBaseCollectorAck();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.message = reader.string();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    create(base) {
+        return exports.CollectorAck.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseCollectorAck();
+        message.message = object.message ?? "";
+        return message;
+    },
+};

package/package.json

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