@framers/agentos 0.13.78 → 0.13.80

package/dist/io/voice-pipeline/HeuristicEndpointDetector.js.map

@@ -1 +1 @@
-{"version":3,"file":"HeuristicEndpointDetector.js","sourceRoot":"","sources":["../../../src/io/voice-pipeline/HeuristicEndpointDetector.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"HeuristicEndpointDetector.js","sourceRoot":"","sources":["../../../src/io/voice-pipeline/HeuristicEndpointDetector.ts"],"names":[],"mappings":"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"}

package/dist/io/voice-pipeline/ListenSession.d.ts

@@ -0,0 +1,111 @@
+/**
+ * @module voice-pipeline/ListenSession
+ *
+ * A session that listens and writes: a transport's audio into a streaming
+ * transcriber, each final (or each detector turn) into a sink as a numbered
+ * turn. No synthesis, no barge-in, no agent turn. Built for a notetaker, a
+ * meeting bot or a transcription job, where {@link VoicePipelineOrchestrator}
+ * is built for a conversation.
+ */
+import { EventEmitter } from 'node:events';
+import { type ReconnectingSTTOptions } from './ReconnectingSTT.js';
+import type { IEndpointDetector, IStreamingSTT, IStreamTransport, ITranscriptInputSink, StreamingSTTConfig, TranscriptEvent } from './types.js';
+export type { ITranscriptSink, ITranscriptInputSink, TranscriptInput, TranscriptTurn } from './types.js';
+/**
+ * Why a listen session ended. `stopped` drains the last utterance first; `purged` drains nothing and drops what is
+ * queued; faults are `stt_failed` (the transcriber failed for good, past {@link ReconnectingSTT}'s cap or at once
+ * without it), `transport_closed`, `transport_failed` (the transport emitted an error, included in `ended`)
+ * and `sink_failed` (the sink threw on a write).
+ */
+export type ListenEndReason = 'stopped' | 'purged' | 'stt_failed' | 'transport_closed' | 'transport_failed' | 'sink_failed';
+/** What {@link startListenSession} takes besides the transport and the sink: only the transcriber and the run are required. */
+export interface ListenSessionOverrides {
+    /** The streaming transcriber; wrapped in {@link ReconnectingSTT} unless `reconnect` is `false`. */
+    streamingSTT: IStreamingSTT;
+    /** The run the turns belong to; turn ids are `<runId>:<n>`. */
+    runId: string;
+    /**
+     * When given, its `turn_complete` events are the turns; without one, each final is a turn.
+     * An empty detector transcript uses the STT finals since the previous turn, joined with spaces,
+     * and their first start and last end times (including with {@link AcousticEndpointDetector}).
+     */
+    endpointDetector?: IEndpointDetector;
+    /** Passed to the transcriber's `startSession()`. */
+    sttConfig?: StreamingSTTConfig;
+    /** Wrap the transcriber in {@link ReconnectingSTT} (default true). A chain of several providers passes `false`. */
+    reconnect?: boolean | ReconnectingSTTOptions;
+    /** Finals waiting for the sink before the transport is paused. Default 8. */
+    sinkQueueLimit?: number;
+    /**
+     * Names who spoke a turn, from the transcriber's final. A detector turn carries its text and no words,
+     * unless empty detector text uses the accumulated STT finals and their words.
+     */
+    speaker?: (event: TranscriptEvent) => string | undefined;
+    /** How long a stop waits for the flushed final to arrive, before draining a pending detector turn. Default 250. */
+    drainMs?: number;
+}
+/** A listen session's counts so far. */
+export interface ListenSessionStats {
+    /** Turns the sink stored; one it dropped (behind a fence, or for a run that is over) is not counted. */
+    turns: number;
+    /**
+     * Audio frames that came while the transport was asked to pause. They still reach the transcriber, so a count
+     * above zero shows a transport that does not hold its buffer.
+     */
+    dropped: number;
+    /** Reconnects of the transcriber. */
+    reconnects: number;
+}
+/**
+ * `listening`: audio flows and finals are written. `draining`: a stop was asked; the transcriber is flushed and the
+ * finals it still emits are written. `ending`: nothing new is accepted; the queue is written out. `ended`: done.
+ */
+export type ListenSessionState = 'listening' | 'draining' | 'ending' | 'ended';
+/** A running listen session; {@link startListenSession} lists its events. */
+export interface ListenSession extends EventEmitter {
+    /** The run its turns belong to. */
+    readonly runId: string;
+    /** Where the session is in its life, read when asked. */
+    readonly state: ListenSessionState;
+    /** The transport it reads. */
+    readonly transport: IStreamTransport;
+    /** The counts so far. */
+    stats(): ListenSessionStats;
+    /**
+     * `stopped` flushes the transcriber, waits `drainMs`, then waits for a pending detector turn up to
+     * its `turnCompletionTimeoutMs` (3250 ms if omitted), plus one timer tick, before resetting. `purged` drops everything
+     * queued without draining. Every end releases an outstanding transport pause; resolves at `ended`.
+     */
+    close(reason?: ListenEndReason): Promise<void>;
+}
+/**
+ * Starts listening. Emits `turn` (a {@link TranscriptTurn}), `interim` (a {@link TranscriptEvent}), `stt:reconnected`,
+ * `stt:gap`, `paused`, `resumed` and `ended` (`{ reason, error? }`).
+ *
+ * The transport's frames go to the transcriber. Each final, or with an endpoint detector each `turn_complete`, goes
+ * to the sink, one write at a time in arrival order; the sink numbers it. When `sinkQueueLimit` finals wait for the
+ * sink, the session emits `pause` on the transport and `paused` on itself, and `resume` and `resumed` once the queue
+ * is down to half or the session ends; a final is never dropped for a slow sink. The transcriber's `speech_start`
+ * and `speech_end` reach the detector as voice activity, as the orchestrator gives them. The session ends once, for the first
+ * {@link ListenEndReason}; it closes the transcriber and leaves the transport open, since the transport is the
+ * caller's. A transport error ends it with `transport_failed` and the error in `ended`. Its transport listeners
+ * are removed on every end. An empty detector turn uses the accumulated STT finals and their timing.
+ *
+ * @param transport - Where the audio comes from: the session listens for its `audio`, `close` and `error`.
+ * @param sink - Where the turns go; it assigns each turn's number and id.
+ * @param overrides - The transcriber, the run and the session's options.
+ * @returns The session, listening.
+ * @throws {Error} When the transcriber's first session fails to open.
+ *
+ * @example
+ * ```typescript
+ * const session = await startListenSession(transport, sink, {
+ *   streamingSTT: new DeepgramStreamingSTT({ apiKey: process.env.DEEPGRAM_API_KEY! }),
+ *   runId: 'run-1',
+ * });
+ * session.on('ended', ({ reason }: { reason: ListenEndReason }) => console.log(`listening ended: ${reason}`));
+ * await session.close('stopped');
+ * ```
+ */
+export declare function startListenSession(transport: IStreamTransport, sink: ITranscriptInputSink, overrides: ListenSessionOverrides): Promise<ListenSession>;
+//# sourceMappingURL=ListenSession.d.ts.map

package/dist/io/voice-pipeline/ListenSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListenSession.d.ts","sourceRoot":"","sources":["../../../src/io/voice-pipeline/ListenSession.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAmB,KAAK,sBAAsB,EAA8C,MAAM,sBAAsB,CAAC;AAChI,OAAO,KAAK,EAAc,iBAAiB,EAAE,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,kBAAkB,EAAuB,eAAe,EAAgE,MAAM,YAAY,CAAC;AAE/O,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEzG;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,GAAG,kBAAkB,GAAG,kBAAkB,GAAG,aAAa,CAAC;AAE5H,+HAA+H;AAC/H,MAAM,WAAW,sBAAsB;IACrC,mGAAmG;IACnG,YAAY,EAAE,aAAa,CAAC;IAC5B,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;IACrC,oDAAoD;IACpD,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,mHAAmH;IACnH,SAAS,CAAC,EAAE,OAAO,GAAG,sBAAsB,CAAC;IAC7C,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,MAAM,GAAG,SAAS,CAAC;IACzD,mHAAmH;IACnH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,wGAAwG;IACxG,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE/E,6EAA6E;AAC7E,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,8BAA8B;IAC9B,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,yBAAyB;IACzB,KAAK,IAAI,kBAAkB,CAAC;IAC5B;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,gBAAgB,EAAE,IAAI,EAAE,oBAAoB,EAAE,SAAS,EAAE,sBAAsB,GAAG,OAAO,CAAC,aAAa,CAAC,CAwL3J"}

package/dist/io/voice-pipeline/ListenSession.js

@@ -0,0 +1,242 @@
+/**
+ * @module voice-pipeline/ListenSession
+ *
+ * A session that listens and writes: a transport's audio into a streaming
+ * transcriber, each final (or each detector turn) into a sink as a numbered
+ * turn. No synthesis, no barge-in, no agent turn. Built for a notetaker, a
+ * meeting bot or a transcription job, where {@link VoicePipelineOrchestrator}
+ * is built for a conversation.
+ */
+import { EventEmitter } from 'node:events';
+import { ReconnectingSTT } from './ReconnectingSTT.js';
+/**
+ * Starts listening. Emits `turn` (a {@link TranscriptTurn}), `interim` (a {@link TranscriptEvent}), `stt:reconnected`,
+ * `stt:gap`, `paused`, `resumed` and `ended` (`{ reason, error? }`).
+ *
+ * The transport's frames go to the transcriber. Each final, or with an endpoint detector each `turn_complete`, goes
+ * to the sink, one write at a time in arrival order; the sink numbers it. When `sinkQueueLimit` finals wait for the
+ * sink, the session emits `pause` on the transport and `paused` on itself, and `resume` and `resumed` once the queue
+ * is down to half or the session ends; a final is never dropped for a slow sink. The transcriber's `speech_start`
+ * and `speech_end` reach the detector as voice activity, as the orchestrator gives them. The session ends once, for the first
+ * {@link ListenEndReason}; it closes the transcriber and leaves the transport open, since the transport is the
+ * caller's. A transport error ends it with `transport_failed` and the error in `ended`. Its transport listeners
+ * are removed on every end. An empty detector turn uses the accumulated STT finals and their timing.
+ *
+ * @param transport - Where the audio comes from: the session listens for its `audio`, `close` and `error`.
+ * @param sink - Where the turns go; it assigns each turn's number and id.
+ * @param overrides - The transcriber, the run and the session's options.
+ * @returns The session, listening.
+ * @throws {Error} When the transcriber's first session fails to open.
+ *
+ * @example
+ * ```typescript
+ * const session = await startListenSession(transport, sink, {
+ *   streamingSTT: new DeepgramStreamingSTT({ apiKey: process.env.DEEPGRAM_API_KEY! }),
+ *   runId: 'run-1',
+ * });
+ * session.on('ended', ({ reason }: { reason: ListenEndReason }) => console.log(`listening ended: ${reason}`));
+ * await session.close('stopped');
+ * ```
+ */
+export async function startListenSession(transport, sink, overrides) {
+    const stt = overrides.reconnect === false ? overrides.streamingSTT : new ReconnectingSTT(overrides.streamingSTT, typeof overrides.reconnect === 'object' ? overrides.reconnect : {});
+    const sttSession = await stt.startSession(overrides.sttConfig);
+    const detector = overrides.endpointDetector;
+    const queueLimit = overrides.sinkQueueLimit ?? 8;
+    const drainMs = overrides.drainMs ?? 250;
+    const emitter = new EventEmitter();
+    let state = 'listening';
+    let turns = 0;
+    let dropped = 0;
+    let reconnects = 0;
+    let paused = false;
+    let sinkFailed = false;
+    const pending = [];
+    const finals = [];
+    let speechEnded = false;
+    let writing = Promise.resolve();
+    let endPromise;
+    const accepting = () => state === 'listening' || state === 'draining';
+    const resume = () => {
+        if (!paused)
+            return;
+        paused = false;
+        transport.emit('resume');
+        emitter.emit('resumed');
+    };
+    const drainDetector = async () => {
+        if (!detector || finals.length === 0)
+            return;
+        await new Promise((resolve) => {
+            const done = () => {
+                clearTimeout(timer);
+                detector.off('turn_complete', done);
+                resolve();
+            };
+            // One timer tick lets a detector scheduled by the synthetic speech_end
+            // below emit at its bound before the fallback removes its listener.
+            const timer = setTimeout(done, (detector.turnCompletionTimeoutMs ?? 3250) + 1);
+            detector.on('turn_complete', done);
+            // A provider need not report speech_end when flushed. End the input so
+            // the detector can start its silence timer, without restarting a pending one.
+            if (!speechEnded)
+                detector.pushVadEvent({ type: 'speech_end', timestamp: Date.now(), source: 'stt' });
+        });
+    };
+    /** One end for every path. The writer calls it with `fromWriter` and never waits for its own chain. */
+    const end = (reason, error, fromWriter = false) => {
+        if (endPromise)
+            return endPromise;
+        // Reserve the end before cleanup emits resume: its listeners may call close again.
+        let resolveEnd = () => { };
+        let rejectEnd = () => { };
+        endPromise = new Promise((resolve, reject) => { resolveEnd = resolve; rejectEnd = reject; });
+        void (async () => {
+            if (reason === 'stopped') {
+                // the transcriber is flushed and its last finals are still written
+                state = 'draining';
+                try {
+                    await sttSession.flush();
+                }
+                catch {
+                    // the transcriber is gone; nothing to drain
+                }
+                await new Promise((r) => setTimeout(r, drainMs));
+                await drainDetector();
+            }
+            state = 'ending';
+            transport.off('audio', onAudio);
+            transport.off('close', onTransportClose);
+            detector?.off('turn_complete', onTurnComplete);
+            finals.length = 0;
+            if (reason === 'purged')
+                pending.length = 0;
+            resume();
+            sttSession.close();
+            detector?.reset();
+            if (!fromWriter)
+                await writing;
+            transport.off('error', onTransportError);
+            state = 'ended';
+            emitter.emit('ended', error ? { reason, error } : { reason });
+        })().then(resolveEnd, rejectEnd);
+        return endPromise;
+    };
+    const write = (text, event) => {
+        if (!accepting() || sinkFailed)
+            return;
+        const turn = { runId: overrides.runId, at: Date.now(), text, startMs: event.startMs, endMs: event.endMs, speaker: overrides.speaker?.(event) };
+        pending.push(turn);
+        if (pending.length >= queueLimit && !paused) {
+            paused = true;
+            transport.emit('pause');
+            emitter.emit('paused');
+        }
+        writing = writing.then(async () => {
+            const next = pending.shift();
+            if (!next || sinkFailed)
+                return;
+            try {
+                const stored = await sink.appendNext(next);
+                if (stored) {
+                    turns += 1;
+                    emitter.emit('turn', stored);
+                }
+            }
+            catch (err) {
+                sinkFailed = true;
+                pending.length = 0;
+                void end('sink_failed', err instanceof Error ? err : new Error(String(err)), true);
+                return;
+            }
+            if (paused && pending.length < Math.ceil(queueLimit / 2)) {
+                resume();
+            }
+        });
+    };
+    const onAudio = (frame) => {
+        if (state !== 'listening')
+            return;
+        if (paused)
+            dropped += 1; // the transport was asked to pause; a frame that still comes is counted, and the transcriber keeps its own buffer
+        sttSession.pushAudio(frame);
+    };
+    const onTransportClose = () => {
+        void end('transport_closed');
+    };
+    const onTransportError = (error) => {
+        void end('transport_failed', error);
+    };
+    const onTurnComplete = (turn) => {
+        if (!accepting())
+            return;
+        const accumulated = finals.splice(0);
+        if (!turn.transcript.trim()) {
+            const text = accumulated.map((event) => event.text).filter(Boolean).join(' ');
+            if (text)
+                write(text, {
+                    text, confidence: accumulated[accumulated.length - 1].confidence,
+                    words: accumulated.flatMap((event) => event.words), isFinal: true,
+                    startMs: accumulated[0].startMs, endMs: accumulated[accumulated.length - 1].endMs,
+                });
+            return;
+        }
+        // a detector turn has its text and confidence, and no audio boundaries of its own
+        write(turn.transcript, { text: turn.transcript, confidence: turn.confidence, words: [], isFinal: true, durationMs: turn.durationMs });
+    };
+    sttSession.on('transcript', (event) => {
+        if (!accepting())
+            return;
+        if (detector) {
+            if (event.isFinal)
+                finals.push(event);
+            detector.pushTranscript(event);
+            if (!event.isFinal)
+                emitter.emit('interim', event);
+            return;
+        }
+        if (event.isFinal)
+            write(event.text, event);
+        else
+            emitter.emit('interim', event);
+    });
+    const onVad = (event) => {
+        if (!accepting())
+            return;
+        if (event.type === 'speech_start')
+            speechEnded = false;
+        else if (event.type === 'speech_end')
+            speechEnded = true;
+        detector?.pushVadEvent(event);
+    };
+    sttSession.on('vad', onVad);
+    // the transcriber's own speech events reach the detector as voice activity, as the orchestrator gives them
+    sttSession.on('speech_start', () => onVad({ type: 'speech_start', timestamp: Date.now(), source: 'stt' }));
+    sttSession.on('speech_end', () => onVad({ type: 'speech_end', timestamp: Date.now(), source: 'stt' }));
+    sttSession.on('stt:reconnected', (e) => {
+        reconnects += 1;
+        emitter.emit('stt:reconnected', e);
+    });
+    sttSession.on('stt:gap', (e) => emitter.emit('stt:gap', e));
+    sttSession.on('error', (err) => {
+        if (state === 'listening')
+            void end('stt_failed', err);
+    });
+    sttSession.on('close', () => {
+        if (state === 'listening')
+            void end('stt_failed', new Error('the transcriber closed'));
+    });
+    detector?.on('turn_complete', onTurnComplete);
+    transport.on('audio', onAudio);
+    transport.on('close', onTransportClose);
+    transport.on('error', onTransportError);
+    const session = Object.assign(emitter, {
+        runId: overrides.runId,
+        transport,
+        stats: () => ({ turns, dropped, reconnects }),
+        close: (reason = 'stopped') => end(reason),
+    });
+    Object.defineProperty(session, 'state', { get: () => state, enumerable: true });
+    return session;
+}
+//# sourceMappingURL=ListenSession.js.map

package/dist/io/voice-pipeline/ListenSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListenSession.js","sourceRoot":"","sources":["../../../src/io/voice-pipeline/ListenSession.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,eAAe,EAA2E,MAAM,sBAAsB,CAAC;AA6EhI;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,SAA2B,EAAE,IAA0B,EAAE,SAAiC;IACjI,MAAM,GAAG,GAAG,SAAS,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,SAAS,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACrL,MAAM,UAAU,GAAwB,MAAM,GAAG,CAAC,YAAY,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACpF,MAAM,QAAQ,GAAG,SAAS,CAAC,gBAAgB,CAAC;IAC5C,MAAM,UAAU,GAAG,SAAS,CAAC,cAAc,IAAI,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,IAAI,GAAG,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,YAAY,EAAE,CAAC;IACnC,IAAI,KAAK,GAAuB,WAAW,CAAC;IAC5C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,MAAM,OAAO,GAAsB,EAAE,CAAC;IACtC,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,OAAO,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAC/C,IAAI,UAAqC,CAAC;IAE1C,MAAM,SAAS,GAAG,GAAY,EAAE,CAAC,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,UAAU,CAAC;IAE/E,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,GAAG,KAAK,CAAC;QACf,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,KAAK,IAAmB,EAAE;QAC9C,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC7C,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,MAAM,IAAI,GAAG,GAAS,EAAE;gBACtB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,QAAQ,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;gBACpC,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC;YACF,uEAAuE;YACvE,oEAAoE;YACpE,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,uBAAuB,IAAI,IAAK,CAAC,GAAG,CAAC,CAAC,CAAC;YAChF,QAAQ,CAAC,EAAE,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;YACnC,uEAAuE;YACvE,8EAA8E;YAC9E,IAAI,CAAC,WAAW;gBAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACxG,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,uGAAuG;IACvG,MAAM,GAAG,GAAG,CAAC,MAAuB,EAAE,KAAa,EAAE,UAAU,GAAG,KAAK,EAAiB,EAAE;QACxF,IAAI,UAAU;YAAE,OAAO,UAAU,CAAC;QAClC,mFAAmF;QACnF,IAAI,UAAU,GAAe,GAAG,EAAE,GAAE,CAAC,CAAC;QACtC,IAAI,SAAS,GAA6B,GAAG,EAAE,GAAE,CAAC,CAAC;QACnD,UAAU,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,UAAU,GAAG,OAAO,CAAC,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACnG,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,mEAAmE;gBACnE,KAAK,GAAG,UAAU,CAAC;gBACnB,IAAI,CAAC;oBACH,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;gBAC3B,CAAC;gBAAC,MAAM,CAAC;oBACP,4CAA4C;gBAC9C,CAAC;gBACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;gBACjD,MAAM,aAAa,EAAE,CAAC;YACxB,CAAC;YACD,KAAK,GAAG,QAAQ,CAAC;YACjB,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAChC,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;YACzC,QAAQ,EAAE,GAAG,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;YAC/C,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;YAClB,IAAI,MAAM,KAAK,QAAQ;gBAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;YAC5C,MAAM,EAAE,CAAC;YACT,UAAU,CAAC,KAAK,EAAE,CAAC;YACnB,QAAQ,EAAE,KAAK,EAAE,CAAC;YAClB,IAAI,CAAC,UAAU;gBAAE,MAAM,OAAO,CAAC;YAC/B,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;YACzC,KAAK,GAAG,OAAO,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAChE,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QACjC,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,KAAsB,EAAQ,EAAE;QAC3D,IAAI,CAAC,SAAS,EAAE,IAAI,UAAU;YAAE,OAAO;QACvC,MAAM,IAAI,GAAoB,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;QAChK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,IAAI,OAAO,CAAC,MAAM,IAAI,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC;YAC5C,MAAM,GAAG,IAAI,CAAC;YACd,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YAChC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;YAC7B,IAAI,CAAC,IAAI,IAAI,UAAU;gBAAE,OAAO;YAChC,IAAI,CAAC;gBACH,MAAM,MAAM,GAA+B,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;gBACvE,IAAI,MAAM,EAAE,CAAC;oBACX,KAAK,IAAI,CAAC,CAAC;oBACX,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,UAAU,GAAG,IAAI,CAAC;gBAClB,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;gBACnB,KAAK,GAAG,CAAC,aAAa,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;gBACnF,OAAO;YACT,CAAC;YACD,IAAI,MAAM,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC;gBACzD,MAAM,EAAE,CAAC;YACX,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,CAAC,KAAiB,EAAQ,EAAE;QAC1C,IAAI,KAAK,KAAK,WAAW;YAAE,OAAO;QAClC,IAAI,MAAM;YAAE,OAAO,IAAI,CAAC,CAAC,CAAC,kHAAkH;QAC5I,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC,CAAC;IACF,MAAM,gBAAgB,GAAG,GAAS,EAAE;QAClC,KAAK,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC/B,CAAC,CAAC;IACF,MAAM,gBAAgB,GAAG,CAAC,KAAY,EAAQ,EAAE;QAC9C,KAAK,GAAG,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC,CAAC;IACF,MAAM,cAAc,GAAG,CAAC,IAAuB,EAAQ,EAAE;QACvD,IAAI,CAAC,SAAS,EAAE;YAAE,OAAO;QACzB,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC9E,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,EAAE;oBACpB,IAAI,EAAE,UAAU,EAAE,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,UAAU;oBAChE,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI;oBACjE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK;iBAClF,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,kFAAkF;QAClF,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IACxI,CAAC,CAAC;IAEF,UAAU,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,KAAsB,EAAE,EAAE;QACrD,IAAI,CAAC,SAAS,EAAE;YAAE,OAAO;QACzB,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,KAAK,CAAC,OAAO;gBAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtC,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YAC/B,IAAI,CAAC,KAAK,CAAC,OAAO;gBAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YACnD,OAAO;QACT,CAAC;QACD,IAAI,KAAK,CAAC,OAAO;YAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;;YACvC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,CAAC,KAAe,EAAQ,EAAE;QACtC,IAAI,CAAC,SAAS,EAAE;YAAE,OAAO;QACzB,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;YAAE,WAAW,GAAG,KAAK,CAAC;aAClD,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;YAAE,WAAW,GAAG,IAAI,CAAC;QACzD,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC,CAAC;IACF,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC5B,2GAA2G;IAC3G,UAAU,CAAC,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAC3G,UAAU,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACvG,UAAU,CAAC,EAAE,CAAC,iBAAiB,EAAE,CAAC,CAAsB,EAAE,EAAE;QAC1D,UAAU,IAAI,CAAC,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IACH,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,CAAc,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;IACzE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;QACpC,IAAI,KAAK,KAAK,WAAW;YAAE,KAAK,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QAC1B,IAAI,KAAK,KAAK,WAAW;YAAE,KAAK,GAAG,CAAC,YAAY,EAAE,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAC;IACzF,CAAC,CAAC,CAAC;IACH,QAAQ,EAAE,EAAE,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;IAC9C,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IACxC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IAExC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE;QACrC,KAAK,EAAE,SAAS,CAAC,KAAK;QACtB,SAAS;QACT,KAAK,EAAE,GAAuB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;QACjE,KAAK,EAAE,CAAC,SAA0B,SAAS,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC;KAC5D,CAAkB,CAAC;IACpB,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IAChF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/io/voice-pipeline/LiveKitStreamTransport.d.ts

@@ -55,6 +55,8 @@ export interface LiveKitStreamTransportOptions {
      * least one sample at `sampleRate`; rtc-node's default when omitted.
      */
     frameSizeMs?: number;
+    /** While the consumer has asked for a pause, frames are held up to this much audio; beyond it the oldest are dropped and a `gap` is emitted on resume. Default 2000. */
+    bufferMs?: number;
     /** The `@livekit/rtc-node` module the host imports; imported on first use when omitted. */
     rtc?: LiveKitRtcModule;
 }
@@ -67,6 +69,7 @@ export interface LiveKitStreamTransportOptions {
  * | Event       | Payload                   | Description                                   |
  * |-------------|---------------------------|-----------------------------------------------|
  * | `'audio'`   | `AudioFrame`              | The participant's audio, mono Float32.        |
+ * | `'gap'`     | `{ droppedMs: number, reason: 'paused' }` | Audio dropped beyond the paused buffer, reported on resume before held frames. |
  * | `'message'` | {@link ClientTextMessage} | A JSON message from the participant on the topic. |
  * | `'close'`   | *(none)*                  | The transport closed (or the room disconnected). |
  * | `'error'`   | `Error`                   | A message that is not JSON, a text stream of the participant's that fails while it is read, or a failure to read audio (the peer missing among them). |
@@ -91,6 +94,11 @@ export declare class LiveKitStreamTransport extends EventEmitter implements IStr
     private _state;
     private readonly topic;
     private readonly source;
+    private paused;
+    private readonly held;
+    private heldMs;
+    private droppedMs;
+    private readonly bufferMs;
     /** The participant's text streams being read; {@link close} closes them. */
     private readonly readers;
     /**

package/dist/io/voice-pipeline/LiveKitStreamTransport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LiveKitStreamTransport.d.ts","sourceRoot":"","sources":["../../../src/io/voice-pipeline/LiveKitStreamTransport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAEjB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EAEtB,MAAM,sCAAsC,CAAC;AAE9C,6EAA6E;AAC7E,eAAO,MAAM,+BAA+B,kBAAkB,CAAC;AAE/D,iDAAiD;AACjD,MAAM,WAAW,6BAA6B;IAC5C,2DAA2D;IAC3D,IAAI,EAAE,eAAe,CAAC;IACtB,+DAA+D;IAC/D,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2FAA2F;IAC3F,GAAG,CAAC,EAAE,gBAAgB,CAAC;CACxB;AAaD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,sBAAuB,SAAQ,YAAa,YAAW,gBAAgB;IActE,OAAO,CAAC,QAAQ,CAAC,OAAO;IAbpC,QAAQ,CAAC,EAAE,sDAAgB;IAC3B,OAAO,CAAC,MAAM,CAAwD;IACtE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAElE;;;;;OAKG;gBAC0B,OAAO,EAAE,6BAA6B;IAgBnE,IAAI,KAAK,IAAI,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAExD;IAED;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAYnD;;;;OAIG;IACG,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAc5D;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAW7C,yEAAyE;YAC3D,IAAI;IAYlB,OAAO,CAAC,QAAQ,CAAC,MAAM,CA2BrB;IAEF;;;OAGG;IACH,OAAO,CAAC,aAAa;CAOtB"}
+{"version":3,"file":"LiveKitStreamTransport.d.ts","sourceRoot":"","sources":["../../../src/io/voice-pipeline/LiveKitStreamTransport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAEV,gBAAgB,EAChB,iBAAiB,EAEjB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EAEtB,MAAM,sCAAsC,CAAC;AAE9C,6EAA6E;AAC7E,eAAO,MAAM,+BAA+B,kBAAkB,CAAC;AAE/D,iDAAiD;AACjD,MAAM,WAAW,6BAA6B;IAC5C,2DAA2D;IAC3D,IAAI,EAAE,eAAe,CAAC;IACtB,+DAA+D;IAC/D,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wKAAwK;IACxK,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,GAAG,CAAC,EAAE,gBAAgB,CAAC;CACxB;AAaD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,sBAAuB,SAAQ,YAAa,YAAW,gBAAgB;IAmBtE,OAAO,CAAC,QAAQ,CAAC,OAAO;IAlBpC,QAAQ,CAAC,EAAE,sDAAgB;IAC3B,OAAO,CAAC,MAAM,CAAwD;IACtE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;IACzC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAElE;;;;;OAKG;gBAC0B,OAAO,EAAE,6BAA6B;IA6BnE,IAAI,KAAK,IAAI,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAExD;IAED;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAYnD;;;;OAIG;IACG,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAc5D;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAW7C,yEAAyE;YAC3D,IAAI;IAwBlB,OAAO,CAAC,QAAQ,CAAC,MAAM,CA2BrB;IAEF;;;OAGG;IACH,OAAO,CAAC,aAAa;CAOtB"}

package/dist/io/voice-pipeline/LiveKitStreamTransport.js

@@ -56,6 +56,7 @@ function closeTextReader(reader) {
  * | Event       | Payload                   | Description                                   |
  * |-------------|---------------------------|-----------------------------------------------|
  * | `'audio'`   | `AudioFrame`              | The participant's audio, mono Float32.        |
+ * | `'gap'`     | `{ droppedMs: number, reason: 'paused' }` | Audio dropped beyond the paused buffer, reported on resume before held frames. |
  * | `'message'` | {@link ClientTextMessage} | A JSON message from the participant on the topic. |
  * | `'close'`   | *(none)*                  | The transport closed (or the room disconnected). |
  * | `'error'`   | `Error`                   | A message that is not JSON, a text stream of the participant's that fails while it is read, or a failure to read audio (the peer missing among them). |
@@ -86,6 +87,10 @@ export class LiveKitStreamTransport extends EventEmitter {
         this.options = options;
         this.id = randomUUID();
         this._state = 'open';
+        this.paused = false;
+        this.held = [];
+        this.heldMs = 0;
+        this.droppedMs = 0;
         /** The participant's text streams being read; {@link close} closes them. */
         this.readers = new Set();
         this.onText = (reader, participant) => {
@@ -118,6 +123,20 @@ export class LiveKitStreamTransport extends EventEmitter {
             });
         };
         this.topic = options.topic ?? LIVEKIT_TRANSPORT_DEFAULT_TOPIC;
+        this.bufferMs = options.bufferMs ?? 2000;
+        this.on('pause', () => {
+            this.paused = true;
+        });
+        this.on('resume', () => {
+            this.paused = false;
+            if (this.droppedMs > 0) {
+                this.emit('gap', { droppedMs: this.droppedMs, reason: 'paused' });
+                this.droppedMs = 0;
+            }
+            for (const f of this.held.splice(0))
+                this.emit('audio', f);
+            this.heldMs = 0;
+        });
         // The source checks the options before the topic is taken, so a refused
         // option leaves the topic free; until it is read, the source holds nothing.
         this.source = new LiveKitRoomAudioSource({
@@ -184,7 +203,19 @@ export class LiveKitStreamTransport extends EventEmitter {
     async pump() {
         try {
             for await (const frame of this.source) {
-                this.emit('audio', frame);
+                if (!this.paused) {
+                    this.emit('audio', frame);
+                    continue;
+                }
+                const ms = (frame.samples.length / frame.sampleRate) * 1000;
+                this.held.push(frame);
+                this.heldMs += ms;
+                while (this.heldMs > this.bufferMs && this.held.length) {
+                    const old = this.held.shift();
+                    const oldMs = (old.samples.length / old.sampleRate) * 1000;
+                    this.heldMs -= oldMs;
+                    this.droppedMs += oldMs;
+                }
             }
         }
         catch (err) {

package/dist/io/voice-pipeline/LiveKitStreamTransport.js.map

@@ -1 +1 @@
-{"version":3,"file":"LiveKitStreamTransport.js","sourceRoot":"","sources":["../../../src/io/voice-pipeline/LiveKitStreamTransport.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"LiveKitStreamTransport.js","sourceRoot":"","sources":["../../../src/io/voice-pipeline/LiveKitStreamTransport.ts"],"names":[],"mappings":"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"}

package/dist/io/voice-pipeline/ReconnectingSTT.d.ts

@@ -0,0 +1,90 @@
+import type { IStreamingSTT, StreamingSTTConfig, StreamingSTTSession } from './types.js';
+/** Options of {@link ReconnectingSTT}. */
+export interface ReconnectingSTTOptions {
+    /** How much audio is kept for replay. Default 3000. */
+    ringBufferCapacityMs?: number;
+    /** Replays below this are skipped. Default 400. */
+    minReplayMs?: number;
+    /** Attempts allowed in any sixty seconds before the session gives up. Default 3. */
+    maxAttemptsPerMinute?: number;
+    /** Frames queued while a reconnect runs; beyond it the oldest are dropped and counted. Default 2000 ms. */
+    queueCapacityMs?: number;
+    /** Milliseconds now, for the attempt window and the gap's length. Default `Date.now`. */
+    clock?: () => number;
+}
+/** Payload of a session's `stt:reconnected`: a new session of the provider took over. */
+export interface SttReconnectedEvent {
+    /** The attempt's number among the attempts of the last sixty seconds, from 1. */
+    attempt: number;
+    /** Milliseconds of buffered audio replayed into the new session; 0 when there was less than `minReplayMs`. */
+    replayedMs: number;
+}
+/** Payload of a session's `stt:gap`, emitted right after `stt:reconnected`. */
+export interface SttGapEvent {
+    /** The attempt's number, as in {@link SttReconnectedEvent}. */
+    attempt: number;
+    /**
+     * Milliseconds the reconnect took, by the options' clock. The audio pushed in that time was queued for the new
+     * session, less the oldest frames a full queue dropped (the session's `droppedFrames`).
+     */
+    lostMs: number;
+}
+/**
+ * An {@link IStreamingSTT} over one provider whose session is reconnected.
+ *
+ * An `error` or `close` of the provider's session that the caller did not ask
+ * for opens a new session of the same provider, at most
+ * `maxAttemptsPerMinute` times in any sixty seconds. The new session hears the
+ * buffered audio first (the last `ringBufferCapacityMs`, when there is at least
+ * `minReplayMs` of it), then the frames pushed while it opened, then live
+ * audio. Its `startMs` and `endMs` are moved onto one timeline, the audio
+ * pushed since the session began, and a final that repeats one already
+ * emitted over the same audio is dropped. Only finals with finite start and end
+ * bounds and a positive duration enter the dedupe history; others pass through.
+ * Queue overflow leaves a gap after the replay, preserving the original times
+ * of both replayed and retained audio. Each reconnect emits
+ * `stt:reconnected` ({@link SttReconnectedEvent}) and `stt:gap`
+ * ({@link SttGapEvent}). Past the cap the session emits `error`, then `close`.
+ *
+ * The session forwards `transcript`, `vad`, `speech_start`, `speech_end`,
+ * `usage` and `warning` from the provider's sessions; `usage` comes from every
+ * one of them, a replaced one too, since a session reports its audio as it
+ * closes. `flush()` during a reconnect waits for the replacement, replay and
+ * queued audio before flushing it. A close during that flush, or after it with
+ * no further provider activity or pushed audio, ends the stream without a
+ * reconnect. Activity after a completed flush makes a later close a failure.
+ *
+ * @example
+ * ```typescript
+ * const stt = new ReconnectingSTT(new DeepgramStreamingSTT({ apiKey: process.env.DEEPGRAM_API_KEY! }));
+ * const session = await stt.startSession({ language: 'en-US' });
+ * session.on('stt:gap', ({ lostMs }: SttGapEvent) => console.log(`the transcriber was away for ${lostMs} ms`));
+ * ```
+ */
+export declare class ReconnectingSTT implements IStreamingSTT {
+    private readonly inner;
+    /** `reconnecting:` followed by the inner provider's id. */
+    readonly providerId: string;
+    private readonly capacityMs;
+    private readonly minReplayMs;
+    private readonly maxAttempts;
+    private readonly queueCapacityMs;
+    private readonly clock;
+    /**
+     * @param inner - The provider each session opens, again on every reconnect.
+     * @param options - The replay buffer, the attempt cap, the queue and the clock.
+     */
+    constructor(inner: IStreamingSTT, options?: ReconnectingSTTOptions);
+    /** Whether the inner provider has a session open. */
+    get isStreaming(): boolean;
+    /**
+     * Opens a session of the inner provider behind a session that reconnects it.
+     *
+     * @param config - Passed to the inner provider for the first session and for every reconnect.
+     * @returns The session, with a read-only `droppedFrames`: the queued frames dropped during reconnects so far.
+     * @throws {Error} When the first session fails to open; a session that fails to open on a reconnect is retried
+     *   within the cap.
+     */
+    startSession(config?: StreamingSTTConfig): Promise<StreamingSTTSession>;
+}
+//# sourceMappingURL=ReconnectingSTT.d.ts.map

package/dist/io/voice-pipeline/ReconnectingSTT.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReconnectingSTT.d.ts","sourceRoot":"","sources":["../../../src/io/voice-pipeline/ReconnectingSTT.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAc,aAAa,EAAE,kBAAkB,EAAE,mBAAmB,EAAmB,MAAM,YAAY,CAAC;AAEtH,0CAA0C;AAC1C,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,2GAA2G;IAC3G,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yFAAyF;IACzF,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,yFAAyF;AACzF,MAAM,WAAW,mBAAmB;IAClC,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,8GAA8G;IAC9G,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,eAAgB,YAAW,aAAa;IAavC,OAAO,CAAC,QAAQ,CAAC,KAAK;IAZlC,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IAErC;;;OAGG;gBAC0B,KAAK,EAAE,aAAa,EAAE,OAAO,GAAE,sBAA2B;IASvF,qDAAqD;IACrD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;;;;;;OAOG;IACG,YAAY,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CA6N9E"}