@hyperdrive.bot/paseo-server 0.2.6

package/dist/server/server/dictation/dictation-stream-manager.d.ts

@@ -0,0 +1,87 @@
+import type pino from "pino";
+import type { SpeechToTextProvider } from "../speech/speech-provider.js";
+import { type Resolvable } from "../speech/provider-resolver.js";
+export type DictationStreamOutboundMessage = {
+    type: "dictation_stream_ack";
+    payload: {
+        dictationId: string;
+        ackSeq: number;
+    };
+} | {
+    type: "dictation_stream_finish_accepted";
+    payload: {
+        dictationId: string;
+        timeoutMs: number;
+    };
+} | {
+    type: "dictation_stream_partial";
+    payload: {
+        dictationId: string;
+        text: string;
+    };
+} | {
+    type: "dictation_stream_final";
+    payload: {
+        dictationId: string;
+        text: string;
+        debugRecordingPath?: string;
+    };
+} | {
+    type: "dictation_stream_error";
+    payload: {
+        dictationId: string;
+        error: string;
+        retryable: boolean;
+        debugRecordingPath?: string;
+    };
+} | {
+    type: "activity_log";
+    payload: {
+        id: string;
+        timestamp: Date;
+        type: "system";
+        content: string;
+        metadata: Record<string, unknown>;
+    };
+};
+export declare class DictationStreamManager {
+    private readonly logger;
+    private readonly emit;
+    private readonly sessionId;
+    private readonly resolveStt;
+    private readonly language;
+    private readonly finalTimeoutMs;
+    private readonly autoCommitSeconds;
+    private readonly streams;
+    constructor(params: {
+        logger: pino.Logger;
+        emit: (msg: DictationStreamOutboundMessage) => void;
+        sessionId: string;
+        stt: Resolvable<SpeechToTextProvider | null>;
+        language?: string;
+        finalTimeoutMs?: number;
+        autoCommitSeconds?: number;
+    });
+    cleanupAll(): void;
+    handleStart(dictationId: string, format: string): Promise<void>;
+    handleChunk(params: {
+        dictationId: string;
+        seq: number;
+        audioBase64: string;
+        format: string;
+    }): Promise<void>;
+    handleFinish(dictationId: string, finalSeq: number): Promise<void>;
+    handleCancel(dictationId: string): void;
+    private emitDictationAck;
+    private emitDictationPartial;
+    private maybePersistDictationStreamAudio;
+    private failDictationStream;
+    private failAndCleanupDictationStream;
+    private cleanupDictationStream;
+    private estimateFinalizationTimeout;
+    private maybeAutoCommitDictationSegment;
+    private maybeSealDictationStreamFinish;
+    private dropUncommittedNonFinalTranscripts;
+    private maybeFinalizeDictationStream;
+}
+//# sourceMappingURL=dictation-stream-manager.d.ts.map

package/dist/server/server/dictation/dictation-stream-manager.js

@@ -0,0 +1,572 @@
+import { v4 as uuidv4 } from "uuid";
+import { createDictationDebugChunkWriter, maybePersistDictationDebugAudio, } from "../agent/dictation-debug.js";
+import { isPaseoDictationDebugEnabled } from "../agent/recordings-debug.js";
+import { Pcm16MonoResampler } from "../agent/pcm16-resampler.js";
+import { toResolver } from "../speech/provider-resolver.js";
+import { parsePcmRateFromFormat, pcm16lePeakAbs } from "../speech/audio.js";
+const PCM_CHANNELS = 1;
+const PCM_BITS_PER_SAMPLE = 16;
+const DEFAULT_DICTATION_FINAL_TIMEOUT_MS = 10000;
+const DEFAULT_DICTATION_AUTO_COMMIT_SECONDS = 15;
+const DICTATION_FINAL_TIMEOUT_MAX_MS = 5 * 60 * 1000;
+const DICTATION_FINAL_TIMEOUT_PER_PENDING_SEGMENT_MS = 15 * 1000;
+const DICTATION_FINAL_TIMEOUT_PER_PENDING_AUDIO_SECOND_MS = 1500;
+const DICTATION_FINAL_TIMEOUT_PER_MISSING_SEQ_MS = 250;
+const DICTATION_SILENCE_PEAK_THRESHOLD = Number.parseInt(process.env.PASEO_DICTATION_SILENCE_PEAK_THRESHOLD ?? "300", 10);
+function parseNonNegativeNumber(value) {
+    if (value === undefined) {
+        return null;
+    }
+    const parsed = Number.parseFloat(value);
+    if (!Number.isFinite(parsed) || parsed < 0) {
+        return null;
+    }
+    return parsed;
+}
+function convertPCMToWavBuffer(pcmBuffer, sampleRate, channels, bitsPerSample) {
+    const headerSize = 44;
+    const wavBuffer = Buffer.alloc(headerSize + pcmBuffer.length);
+    const byteRate = (sampleRate * channels * bitsPerSample) / 8;
+    const blockAlign = (channels * bitsPerSample) / 8;
+    wavBuffer.write("RIFF", 0);
+    wavBuffer.writeUInt32LE(36 + pcmBuffer.length, 4);
+    wavBuffer.write("WAVE", 8);
+    wavBuffer.write("fmt ", 12);
+    wavBuffer.writeUInt32LE(16, 16);
+    wavBuffer.writeUInt16LE(1, 20);
+    wavBuffer.writeUInt16LE(channels, 22);
+    wavBuffer.writeUInt32LE(sampleRate, 24);
+    wavBuffer.writeUInt32LE(byteRate, 28);
+    wavBuffer.writeUInt16LE(blockAlign, 32);
+    wavBuffer.writeUInt16LE(bitsPerSample, 34);
+    wavBuffer.write("data", 36);
+    wavBuffer.writeUInt32LE(pcmBuffer.length, 40);
+    pcmBuffer.copy(wavBuffer, 44);
+    return wavBuffer;
+}
+export class DictationStreamManager {
+    constructor(params) {
+        this.streams = new Map();
+        this.logger = params.logger.child({ component: "dictation-stream-manager" });
+        this.emit = params.emit;
+        this.sessionId = params.sessionId;
+        this.resolveStt = toResolver(params.stt);
+        this.language = params.language ?? "en";
+        this.finalTimeoutMs = params.finalTimeoutMs ?? DEFAULT_DICTATION_FINAL_TIMEOUT_MS;
+        this.autoCommitSeconds =
+            params.autoCommitSeconds ??
+                parseNonNegativeNumber(process.env.PASEO_DICTATION_AUTO_COMMIT_SECONDS) ??
+                DEFAULT_DICTATION_AUTO_COMMIT_SECONDS;
+    }
+    cleanupAll() {
+        for (const dictationId of this.streams.keys()) {
+            this.cleanupDictationStream(dictationId);
+        }
+    }
+    async handleStart(dictationId, format) {
+        this.cleanupDictationStream(dictationId);
+        const sttProvider = this.resolveStt();
+        if (!sttProvider) {
+            this.failDictationStream(dictationId, "Dictation STT not configured", false);
+            return;
+        }
+        const transcriptionPrompt = process.env.PASEO_DICTATION_TRANSCRIPTION_PROMPT ??
+            "Transcribe only what the speaker says. Do not add words. Preserve punctuation and casing. If the audio is silence or non-speech noise, return an empty transcript.";
+        let stt;
+        try {
+            stt = sttProvider.createSession({
+                logger: this.logger.child({ dictationId }),
+                language: this.language,
+                prompt: transcriptionPrompt,
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.failDictationStream(dictationId, message, false);
+            return;
+        }
+        stt.on("committed", ({ segmentId }) => {
+            const state = this.streams.get(dictationId);
+            if (!state) {
+                return;
+            }
+            state.committedSegmentIds.push(segmentId);
+            state.bytesSinceCommit = 0;
+            state.peakSinceCommit = 0;
+            if (state.finishRequested && state.awaitingFinalCommit) {
+                state.awaitingFinalCommit = false;
+            }
+            this.maybeFinalizeDictationStream(dictationId);
+        });
+        stt.on("transcript", ({ segmentId, transcript, isFinal }) => {
+            const state = this.streams.get(dictationId);
+            if (!state) {
+                return;
+            }
+            state.transcriptsBySegmentId.set(segmentId, transcript);
+            if (isFinal) {
+                state.finalTranscriptSegmentIds.add(segmentId);
+            }
+            if (state.finishRequested && state.awaitingFinalCommit && isFinal) {
+                state.awaitingFinalCommit = false;
+            }
+            const orderedIds = state.committedSegmentIds.includes(segmentId)
+                ? state.committedSegmentIds
+                : [...state.committedSegmentIds, segmentId];
+            const partialText = orderedIds
+                .map((id) => state.transcriptsBySegmentId.get(id) ?? "")
+                .join(" ")
+                .trim();
+            this.emitDictationPartial(dictationId, partialText);
+            this.maybeSealDictationStreamFinish(dictationId);
+            this.maybeFinalizeDictationStream(dictationId);
+        });
+        stt.on("error", (err) => {
+            const message = err instanceof Error ? err.message : String(err);
+            const state = this.streams.get(dictationId);
+            if (state && state.finishRequested && isBufferTooSmallError(message)) {
+                if (state.awaitingFinalCommit) {
+                    state.awaitingFinalCommit = false;
+                }
+                this.maybeFinalizeDictationStream(dictationId);
+                return;
+            }
+            void this.failAndCleanupDictationStream(dictationId, message, true);
+        });
+        try {
+            await stt.connect();
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.failDictationStream(dictationId, message, true);
+            try {
+                stt.close();
+            }
+            catch {
+                // no-op
+            }
+            return;
+        }
+        const inputRate = parsePcmRateFromFormat(format, 16000) ?? 16000;
+        if (!Number.isFinite(inputRate) || inputRate <= 0) {
+            this.failDictationStream(dictationId, `Invalid dictation input rate in format: ${format}`, false);
+            try {
+                stt.close();
+            }
+            catch {
+                // no-op
+            }
+            return;
+        }
+        const debugChunkWriter = createDictationDebugChunkWriter({ sessionId: this.sessionId, dictationId }, this.logger);
+        const outputRate = stt.requiredSampleRate;
+        const autoCommitBytes = this.autoCommitSeconds > 0
+            ? Math.max(1, Math.round(this.autoCommitSeconds * outputRate * 2))
+            : 0;
+        this.streams.set(dictationId, {
+            dictationId,
+            sessionId: this.sessionId,
+            inputFormat: format,
+            stt,
+            inputRate,
+            outputRate,
+            resampler: inputRate === outputRate
+                ? null
+                : new Pcm16MonoResampler({
+                    inputRate,
+                    outputRate,
+                }),
+            debugAudioChunks: [],
+            debugRecordingPath: null,
+            debugChunkWriter,
+            receivedChunks: new Map(),
+            nextSeqToForward: 0,
+            ackSeq: -1,
+            autoCommitBytes,
+            bytesSinceCommit: 0,
+            peakSinceCommit: 0,
+            committedSegmentIds: [],
+            transcriptsBySegmentId: new Map(),
+            finalTranscriptSegmentIds: new Set(),
+            awaitingFinalCommit: false,
+            finishRequested: false,
+            finishSealed: false,
+            finalSeq: null,
+            finalTimeout: null,
+        });
+        this.emitDictationAck(dictationId, -1);
+    }
+    async handleChunk(params) {
+        const state = this.streams.get(params.dictationId);
+        if (!state) {
+            this.failDictationStream(params.dictationId, "Dictation stream not started", true);
+            return;
+        }
+        if (params.format !== state.inputFormat) {
+            void this.failAndCleanupDictationStream(params.dictationId, `Mismatched dictation stream format: ${params.format}`, false);
+            return;
+        }
+        if (params.seq < state.nextSeqToForward) {
+            this.emitDictationAck(params.dictationId, state.ackSeq);
+            return;
+        }
+        if (!state.receivedChunks.has(params.seq)) {
+            state.receivedChunks.set(params.seq, Buffer.from(params.audioBase64, "base64"));
+        }
+        while (state.receivedChunks.has(state.nextSeqToForward)) {
+            const seq = state.nextSeqToForward;
+            const pcm16 = state.receivedChunks.get(seq);
+            state.receivedChunks.delete(seq);
+            const resampled = state.resampler ? state.resampler.processChunk(pcm16) : pcm16;
+            if (resampled.length > 0) {
+                state.stt.appendPcm16(resampled);
+                state.debugAudioChunks.push(resampled);
+                state.bytesSinceCommit += resampled.length;
+                state.peakSinceCommit = Math.max(state.peakSinceCommit, pcm16lePeakAbs(resampled));
+                try {
+                    this.maybeAutoCommitDictationSegment(state);
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    void this.failAndCleanupDictationStream(params.dictationId, message, true);
+                    return;
+                }
+                if (state.debugChunkWriter) {
+                    void state.debugChunkWriter.writeChunk(seq, resampled).catch((err) => {
+                        this.logger.warn({ dictationId: params.dictationId, seq, err }, "Failed to write debug chunk");
+                    });
+                }
+            }
+            state.nextSeqToForward += 1;
+            state.ackSeq = state.nextSeqToForward - 1;
+        }
+        this.emitDictationAck(params.dictationId, state.ackSeq);
+        this.maybeSealDictationStreamFinish(params.dictationId);
+        this.maybeFinalizeDictationStream(params.dictationId);
+    }
+    async handleFinish(dictationId, finalSeq) {
+        const state = this.streams.get(dictationId);
+        if (!state) {
+            this.failDictationStream(dictationId, "Dictation stream not started", true);
+            return;
+        }
+        state.finishRequested = true;
+        state.finalSeq = finalSeq;
+        if (finalSeq >= 0 &&
+            state.ackSeq < 0 &&
+            state.nextSeqToForward === 0 &&
+            state.receivedChunks.size === 0) {
+            this.logger.debug({
+                dictationId,
+                finalSeq,
+                ackSeq: state.ackSeq,
+                nextSeqToForward: state.nextSeqToForward,
+                receivedChunks: state.receivedChunks.size,
+                bytesSinceCommit: state.bytesSinceCommit,
+            }, "Dictation finish: no chunks received (failing fast)");
+            this.failDictationStream(dictationId, `Dictation finished (finalSeq=${finalSeq}) but no audio chunks were received`, true);
+            this.cleanupDictationStream(dictationId);
+            return;
+        }
+        this.maybeSealDictationStreamFinish(dictationId);
+        this.maybeFinalizeDictationStream(dictationId);
+        const updatedState = this.streams.get(dictationId);
+        if (!updatedState) {
+            return;
+        }
+        const timeoutEstimate = this.estimateFinalizationTimeout(updatedState);
+        if (updatedState.finalTimeout) {
+            clearTimeout(updatedState.finalTimeout);
+        }
+        updatedState.finalTimeout = setTimeout(() => {
+            void this.failAndCleanupDictationStream(dictationId, "Timed out waiting for final transcription", true);
+        }, timeoutEstimate.timeoutMs);
+        this.emit({
+            type: "dictation_stream_finish_accepted",
+            payload: {
+                dictationId,
+                timeoutMs: timeoutEstimate.timeoutMs,
+            },
+        });
+        this.logger.debug({
+            dictationId,
+            finalSeq,
+            ackSeq: updatedState.ackSeq,
+            pendingSegments: timeoutEstimate.pendingSegments,
+            pendingAudioSeconds: timeoutEstimate.pendingAudioSeconds,
+            missingSeqCount: timeoutEstimate.missingSeqCount,
+            timeoutMs: timeoutEstimate.timeoutMs,
+        }, "Accepted dictation finish request with adaptive timeout budget");
+    }
+    handleCancel(dictationId) {
+        this.cleanupDictationStream(dictationId);
+    }
+    emitDictationAck(dictationId, ackSeq) {
+        this.emit({ type: "dictation_stream_ack", payload: { dictationId, ackSeq } });
+    }
+    emitDictationPartial(dictationId, text) {
+        this.emit({ type: "dictation_stream_partial", payload: { dictationId, text } });
+    }
+    async maybePersistDictationStreamAudio(dictationId) {
+        if (!isPaseoDictationDebugEnabled()) {
+            return null;
+        }
+        const state = this.streams.get(dictationId);
+        if (!state) {
+            return null;
+        }
+        if (state.debugRecordingPath) {
+            return state.debugRecordingPath;
+        }
+        if (state.debugAudioChunks.length === 0) {
+            return null;
+        }
+        const pcmBuffer = Buffer.concat(state.debugAudioChunks);
+        const wavBuffer = convertPCMToWavBuffer(pcmBuffer, state.outputRate, PCM_CHANNELS, PCM_BITS_PER_SAMPLE);
+        const path = await maybePersistDictationDebugAudio(wavBuffer, { sessionId: state.sessionId, dictationId: state.dictationId, format: "audio/wav" }, this.logger, state.debugChunkWriter?.folder);
+        state.debugRecordingPath = path;
+        return path;
+    }
+    failDictationStream(dictationId, error, retryable) {
+        this.emit({
+            type: "dictation_stream_error",
+            payload: { dictationId, error, retryable },
+        });
+    }
+    async failAndCleanupDictationStream(dictationId, error, retryable) {
+        const debugRecordingPath = await this.maybePersistDictationStreamAudio(dictationId);
+        this.emit({
+            type: "dictation_stream_error",
+            payload: {
+                dictationId,
+                error,
+                retryable,
+                ...(debugRecordingPath ? { debugRecordingPath } : {}),
+            },
+        });
+        if (debugRecordingPath) {
+            this.emit({
+                type: "activity_log",
+                payload: {
+                    id: uuidv4(),
+                    timestamp: new Date(),
+                    type: "system",
+                    content: `Saved dictation audio: ${debugRecordingPath}`,
+                    metadata: { recordingPath: debugRecordingPath, dictationId },
+                },
+            });
+        }
+        this.cleanupDictationStream(dictationId);
+    }
+    cleanupDictationStream(dictationId) {
+        const state = this.streams.get(dictationId) ?? null;
+        if (!state) {
+            return;
+        }
+        if (state.finalTimeout) {
+            clearTimeout(state.finalTimeout);
+        }
+        try {
+            state.stt.close();
+        }
+        catch {
+            // no-op
+        }
+        this.streams.delete(dictationId);
+    }
+    estimateFinalizationTimeout(state) {
+        const bytesPerSecond = Math.max(1, state.outputRate * PCM_CHANNELS * (PCM_BITS_PER_SAMPLE / 8));
+        const pendingCommittedSegments = state.committedSegmentIds.reduce((count, segmentId) => {
+            return state.finalTranscriptSegmentIds.has(segmentId) ? count : count + 1;
+        }, 0);
+        const committedSet = new Set(state.committedSegmentIds);
+        const pendingUncommittedTranscriptSegments = Array.from(state.transcriptsBySegmentId.keys()).reduce((count, segmentId) => {
+            if (committedSet.has(segmentId)) {
+                return count;
+            }
+            return state.finalTranscriptSegmentIds.has(segmentId) ? count : count + 1;
+        }, 0);
+        const pendingSegments = pendingCommittedSegments +
+            pendingUncommittedTranscriptSegments +
+            (state.awaitingFinalCommit ? 1 : 0);
+        const pendingAudioSeconds = Math.ceil(Math.max(0, state.bytesSinceCommit) / bytesPerSecond);
+        const missingSeqCount = state.finalSeq === null ? 0 : Math.max(0, state.finalSeq - state.ackSeq);
+        const extraMs = pendingSegments * DICTATION_FINAL_TIMEOUT_PER_PENDING_SEGMENT_MS +
+            pendingAudioSeconds * DICTATION_FINAL_TIMEOUT_PER_PENDING_AUDIO_SECOND_MS +
+            missingSeqCount * DICTATION_FINAL_TIMEOUT_PER_MISSING_SEQ_MS;
+        const timeoutMs = Math.max(this.finalTimeoutMs, Math.min(DICTATION_FINAL_TIMEOUT_MAX_MS, this.finalTimeoutMs + extraMs));
+        return {
+            timeoutMs,
+            pendingSegments,
+            pendingAudioSeconds,
+            missingSeqCount,
+        };
+    }
+    maybeAutoCommitDictationSegment(state) {
+        if (state.finishRequested) {
+            return;
+        }
+        if (state.autoCommitBytes <= 0 || state.bytesSinceCommit < state.autoCommitBytes) {
+            return;
+        }
+        if (state.peakSinceCommit < DICTATION_SILENCE_PEAK_THRESHOLD) {
+            state.stt.clear();
+            state.bytesSinceCommit = 0;
+            state.peakSinceCommit = 0;
+            return;
+        }
+        state.bytesSinceCommit = 0;
+        state.peakSinceCommit = 0;
+        state.stt.commit();
+    }
+    maybeSealDictationStreamFinish(dictationId) {
+        const state = this.streams.get(dictationId);
+        if (!state) {
+            return;
+        }
+        if (!state.finishRequested || state.finalSeq === null) {
+            return;
+        }
+        if (state.ackSeq < state.finalSeq) {
+            return;
+        }
+        if (state.finishSealed) {
+            return;
+        }
+        if (state.bytesSinceCommit > 0) {
+            if (state.peakSinceCommit < DICTATION_SILENCE_PEAK_THRESHOLD) {
+                this.logger.debug({
+                    dictationId,
+                    bytesSinceCommit: state.bytesSinceCommit,
+                    peakSinceCommit: state.peakSinceCommit,
+                }, "Dictation finish: clearing silence-only tail (skip final commit)");
+                state.stt.clear();
+                state.bytesSinceCommit = 0;
+                state.peakSinceCommit = 0;
+                state.awaitingFinalCommit = false;
+                const droppedSegments = this.dropUncommittedNonFinalTranscripts(state);
+                if (droppedSegments > 0) {
+                    this.logger.debug({
+                        dictationId,
+                        droppedSegments,
+                    }, "Dictation finish: dropped uncommitted non-final transcript segments after silence clear");
+                }
+            }
+            else {
+                state.awaitingFinalCommit = true;
+                try {
+                    state.stt.commit();
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    void this.failAndCleanupDictationStream(dictationId, message, true);
+                    return;
+                }
+            }
+        }
+        else {
+            state.awaitingFinalCommit = false;
+        }
+        state.finishSealed = true;
+    }
+    dropUncommittedNonFinalTranscripts(state) {
+        const committedSet = new Set(state.committedSegmentIds);
+        let droppedCount = 0;
+        for (const segmentId of state.transcriptsBySegmentId.keys()) {
+            if (committedSet.has(segmentId)) {
+                continue;
+            }
+            if (state.finalTranscriptSegmentIds.has(segmentId)) {
+                continue;
+            }
+            state.transcriptsBySegmentId.delete(segmentId);
+            droppedCount += 1;
+        }
+        return droppedCount;
+    }
+    maybeFinalizeDictationStream(dictationId) {
+        const state = this.streams.get(dictationId);
+        if (!state) {
+            return;
+        }
+        if (!state.finishRequested || state.finalSeq === null) {
+            return;
+        }
+        if (state.ackSeq < state.finalSeq) {
+            return;
+        }
+        if (state.awaitingFinalCommit) {
+            return;
+        }
+        const committedSet = new Set(state.committedSegmentIds);
+        const orderedSegmentIds = [...state.committedSegmentIds];
+        for (const segmentId of state.transcriptsBySegmentId.keys()) {
+            if (!committedSet.has(segmentId)) {
+                orderedSegmentIds.push(segmentId);
+            }
+        }
+        if (orderedSegmentIds.length === 0) {
+            void (async () => {
+                const debugRecordingPath = await this.maybePersistDictationStreamAudio(dictationId);
+                this.emit({
+                    type: "dictation_stream_final",
+                    payload: {
+                        dictationId,
+                        text: "",
+                        ...(debugRecordingPath ? { debugRecordingPath } : {}),
+                    },
+                });
+                if (debugRecordingPath) {
+                    this.emit({
+                        type: "activity_log",
+                        payload: {
+                            id: uuidv4(),
+                            timestamp: new Date(),
+                            type: "system",
+                            content: `Saved dictation audio: ${debugRecordingPath}`,
+                            metadata: { recordingPath: debugRecordingPath, dictationId },
+                        },
+                    });
+                }
+                this.cleanupDictationStream(dictationId);
+            })();
+            return;
+        }
+        const allTranscriptsReady = orderedSegmentIds.every((segmentId) => state.finalTranscriptSegmentIds.has(segmentId));
+        if (!allTranscriptsReady) {
+            return;
+        }
+        const orderedText = orderedSegmentIds
+            .map((segmentId) => state.transcriptsBySegmentId.get(segmentId) ?? "")
+            .join(" ")
+            .trim();
+        void (async () => {
+            const debugRecordingPath = await this.maybePersistDictationStreamAudio(dictationId);
+            this.emit({
+                type: "dictation_stream_final",
+                payload: {
+                    dictationId,
+                    text: orderedText,
+                    ...(debugRecordingPath ? { debugRecordingPath } : {}),
+                },
+            });
+            if (debugRecordingPath) {
+                this.emit({
+                    type: "activity_log",
+                    payload: {
+                        id: uuidv4(),
+                        timestamp: new Date(),
+                        type: "system",
+                        content: `Saved dictation audio: ${debugRecordingPath}`,
+                        metadata: { recordingPath: debugRecordingPath, dictationId },
+                    },
+                });
+            }
+            this.cleanupDictationStream(dictationId);
+        })();
+    }
+}
+function isBufferTooSmallError(message) {
+    return /buffer too small/i.test(message);
+}
+//# sourceMappingURL=dictation-stream-manager.js.map

package/dist/server/server/editor-targets.d.ts

@@ -0,0 +1,18 @@
+import { existsSync } from "node:fs";
+import type { EditorTargetDescriptorPayload, EditorTargetId } from "@hyperdrive.bot/paseo-protocol/messages";
+import { spawnProcess } from "../utils/spawn.js";
+interface ListAvailableEditorTargetsDependencies {
+    platform?: NodeJS.Platform;
+    findExecutable?: (command: string) => string | null | Promise<string | null>;
+}
+type OpenInEditorTargetDependencies = ListAvailableEditorTargetsDependencies & {
+    existsSync?: typeof existsSync;
+    spawn?: typeof spawnProcess;
+};
+export declare function listAvailableEditorTargets(dependencies?: ListAvailableEditorTargetsDependencies): Promise<EditorTargetDescriptorPayload[]>;
+export declare function openInEditorTarget(input: {
+    editorId: EditorTargetId;
+    path: string;
+}, dependencies?: OpenInEditorTargetDependencies): Promise<void>;
+export {};
+//# sourceMappingURL=editor-targets.d.ts.map