dvgateway-sdk 1.0.0

package/dist/pipeline/builder.js

@@ -0,0 +1,323 @@
+/**
+ * VoiceAI Pipeline Builder
+ *
+ * High-level fluent API for wiring STT → LLM → TTS pipelines.
+ * Handles the entire lifecycle: call events, audio streaming, AI processing,
+ * and TTS injection — all with a single .start() call.
+ *
+ * Architecture (2026 cascaded pipeline pattern):
+ *
+ *   Inbound call
+ *       ↓
+ *   AudioStream (WebSocket, slin16 → Float32)
+ *       ↓
+ *   [VAD filter] (optional, reduces STT API cost)
+ *       ↓
+ *   SttAdapter.startStream() → onTranscript(isFinal=true)
+ *       ↓
+ *   LlmAdapter.chat() → streaming tokens
+ *       ↓ (first token triggers TTS immediately)
+ *   TtsAdapter.synthesize() → PCM chunks
+ *       ↓
+ *   TtsInjector.injectStreaming()
+ *       ↓
+ *   Call audio (Asterisk)
+ *
+ * Latency budget target: <500ms end-to-end (STT ~200ms, LLM TTFT ~80ms, TTS TTFA ~150ms)
+ */
+import { createAudioStream } from '../streams/audio-stream.js';
+// ─── Fallback wrapper ──────────────────────────────────────────────────────
+class WithFallback {
+    primary;
+    fallback;
+    constructor(primary, fallback) {
+        this.primary = primary;
+        this.fallback = fallback;
+    }
+}
+class SttStage {
+    _adapter;
+    _fallback;
+    _builder;
+    constructor(_adapter, _fallback, _builder) {
+        this._adapter = _adapter;
+        this._fallback = _fallback;
+        this._builder = _builder;
+    }
+    fallback(adapter) {
+        this._fallback = adapter;
+        return this;
+    }
+    toWrapped() {
+        return new WithFallback(this._adapter, this._fallback);
+    }
+    llm(adapter) {
+        return this._builder['setLlm'](adapter, this.toWrapped());
+    }
+    // Conference mode: skip LLM, just emit transcripts
+    forConference() {
+        return new ConferencePipelineBuilder(this._builder, this.toWrapped());
+    }
+}
+class LlmStage {
+    _adapter;
+    _fallback;
+    _stt;
+    _builder;
+    constructor(_adapter, _fallback, _stt, _builder) {
+        this._adapter = _adapter;
+        this._fallback = _fallback;
+        this._stt = _stt;
+        this._builder = _builder;
+    }
+    fallback(adapter) {
+        this._fallback = adapter;
+        return this;
+    }
+    tts(adapter) {
+        return this._builder['setTts'](adapter, this._stt, this.toWrapped());
+    }
+    toWrapped() {
+        return new WithFallback(this._adapter, this._fallback);
+    }
+}
+class TtsStage {
+    _adapter;
+    _fallback;
+    _stt;
+    _llm;
+    _builder;
+    constructor(_adapter, _fallback, _stt, _llm, _builder) {
+        this._adapter = _adapter;
+        this._fallback = _fallback;
+        this._stt = _stt;
+        this._llm = _llm;
+        this._builder = _builder;
+    }
+    fallback(adapter) {
+        this._fallback = adapter;
+        return this;
+    }
+    audioFilter(opts) {
+        this._builder['_dir'] = opts.dir;
+        return this;
+    }
+    onNewCall(handler) {
+        this._builder['_onNewCall'] = handler;
+        return this;
+    }
+    onCallEnded(handler) {
+        this._builder['_onCallEnded'] = handler;
+        return this;
+    }
+    onTranscript(handler) {
+        this._builder['_onTranscript'] = handler;
+        return this;
+    }
+    onError(handler) {
+        this._builder['_onError'] = handler;
+        return this;
+    }
+    async start() {
+        return this._builder['startPipeline'](this._stt, this._llm, new WithFallback(this._adapter, this._fallback));
+    }
+    async stop() {
+        return this._builder['stopPipeline']();
+    }
+}
+// ─── Conference Pipeline (STT-only, no LLM/TTS) ───────────────────────────
+export class ConferencePipelineBuilder {
+    _builder;
+    _stt;
+    _onTranscript;
+    _onError;
+    constructor(_builder, _stt) {
+        this._builder = _builder;
+        this._stt = _stt;
+    }
+    onTranscript(handler) {
+        this._onTranscript = handler;
+        return this;
+    }
+    onError(handler) {
+        this._onError = handler;
+        return this;
+    }
+    async start() {
+        return this._builder['startConferencePipeline'](this._stt, this._onTranscript, this._onError);
+    }
+}
+// ─── Main Builder ──────────────────────────────────────────────────────────
+export class PipelineBuilder {
+    wsPool;
+    callEvents;
+    ttsInjector;
+    logger;
+    // Private state (accessed by inner stages via string indexing above)
+    _dir = 'both';
+    _onNewCall;
+    _onCallEnded;
+    _onTranscript;
+    _onError;
+    _activeCalls = new Map();
+    _running = false;
+    constructor(wsPool, callEvents, ttsInjector, logger) {
+        this.wsPool = wsPool;
+        this.callEvents = callEvents;
+        this.ttsInjector = ttsInjector;
+        this.logger = logger;
+    }
+    /** Set the STT adapter (first step in fluent chain) */
+    stt(adapter) {
+        return new SttStage(adapter, undefined, this);
+    }
+    // ── Internal stage setters (called by stage classes) ────────────────────
+    setLlm(adapter, stt) {
+        return new LlmStage(adapter, undefined, stt, this);
+    }
+    setTts(adapter, stt, llm) {
+        return new TtsStage(adapter, undefined, stt, llm, this);
+    }
+    // ── Full STT → LLM → TTS pipeline ───────────────────────────────────────
+    async startPipeline(stt, llm, tts) {
+        if (this._running)
+            throw new Error('Pipeline is already running. Call stop() first.');
+        this._running = true;
+        const systemPrompt = llm.primary.systemPrompt ??
+            'You are a helpful voice assistant. Keep answers concise and conversational.';
+        const unsubscribe = this.callEvents.on(async (event) => {
+            if (event.type === 'call:new') {
+                const { session } = event;
+                this.logger.info({ linkedId: session.linkedId }, 'New call — starting AI pipeline');
+                await this._onNewCall?.(session);
+                void this.handleCall(session, stt, llm, tts, systemPrompt);
+            }
+            if (event.type === 'call:ended') {
+                const state = this._activeCalls.get(event.linkedId);
+                if (state) {
+                    state.audioStreamUnsubscribe();
+                    await state.sttAdapter.stop();
+                    this._activeCalls.delete(event.linkedId);
+                }
+                await this._onCallEnded?.(event.linkedId, event.durationSec);
+                this.logger.info({ linkedId: event.linkedId, duration: event.durationSec }, 'Call ended');
+            }
+        });
+        // Keep pipeline alive — return a never-resolving promise that
+        // resolves when stop() is called
+        return new Promise((resolve) => {
+            this.wsPool.once('__pipelineStop', () => {
+                unsubscribe();
+                resolve();
+            });
+        });
+    }
+    async handleCall(session, stt, llm, tts, systemPrompt) {
+        const conversationHistory = [
+            { role: 'system', content: systemPrompt },
+        ];
+        // Create audio stream
+        const audioStream = createAudioStream(this.wsPool, session.linkedId, this.logger, { dir: this._dir });
+        // Choose STT adapter (try primary, fall back on error)
+        const sttAdapter = stt.primary;
+        const state = {
+            session,
+            conversationHistory,
+            sttAdapter,
+            audioStreamUnsubscribe: () => audioStream.unsubscribe(),
+        };
+        this._activeCalls.set(session.linkedId, state);
+        // Register transcript handler before starting stream
+        sttAdapter.onTranscript(async (result) => {
+            if (!result.isFinal)
+                return; // Ignore partials in pipeline
+            await this._onTranscript?.(result, session);
+            this.logger.debug({ linkedId: session.linkedId }, 'Transcript finalized, calling LLM');
+            // Append user utterance to conversation
+            conversationHistory.push({ role: 'user', content: result.text });
+            // LLM call (with fallback)
+            try {
+                let responseText = '';
+                const llmAdapter = llm.primary;
+                // Stream tokens and accumulate
+                for await (const token of llmAdapter.chat(conversationHistory)) {
+                    responseText += token;
+                    // First-token trigger: start TTS immediately when we have enough text
+                    if (responseText.length === token.length && token.length > 0) {
+                        this.logger.debug({ linkedId: session.linkedId }, 'LLM first token received, starting TTS');
+                    }
+                }
+                if (!responseText)
+                    return;
+                // Append assistant response to history
+                conversationHistory.push({ role: 'assistant', content: responseText });
+                // TTS synthesis and injection (streamed)
+                const ttsAdapter = tts.primary;
+                const audioChunks = ttsAdapter.synthesize(responseText);
+                await this.ttsInjector.injectStreaming(session.linkedId, audioChunks);
+            }
+            catch (err) {
+                const error = err instanceof Error ? err : new Error(String(err));
+                this.logger.error({ err: error.message, linkedId: session.linkedId }, 'Pipeline error');
+                await this._onError?.(error, session.linkedId);
+            }
+        });
+        // Start STT stream (this will run until audioStream ends)
+        try {
+            await sttAdapter.startStream(session.linkedId, audioStream);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            this.logger.error({ err: error.message, linkedId: session.linkedId }, 'STT stream error');
+            await this._onError?.(error, session.linkedId);
+        }
+    }
+    // ── Conference STT-only pipeline ─────────────────────────────────────────
+    async startConferencePipeline(stt, onTranscript, onError) {
+        if (this._running)
+            throw new Error('Pipeline is already running.');
+        this._running = true;
+        const unsubscribe = this.callEvents.on(async (event) => {
+            if (event.type === 'call:new' || event.type === 'conf:join') {
+                const linkedId = event.type === 'call:new' ? event.session.linkedId : event.linkedId;
+                const fakeSession = event.type === 'call:new'
+                    ? event.session
+                    : { linkedId, confId: event.confId, dir: 'both', startedAt: new Date(), streamUrl: '' };
+                const audioStream = createAudioStream(this.wsPool, linkedId, this.logger, { dir: this._dir });
+                const sttAdapter = stt.primary;
+                sttAdapter.onTranscript(async (result) => {
+                    await onTranscript?.(result, fakeSession);
+                });
+                sttAdapter.startStream(linkedId, audioStream).catch(async (err) => {
+                    const error = err instanceof Error ? err : new Error(String(err));
+                    await onError?.(error, linkedId);
+                });
+            }
+            if (event.type === 'call:ended' || event.type === 'conf:leave') {
+                const linkedId = event.type === 'call:ended' ? event.linkedId : event.linkedId;
+                const state = this._activeCalls.get(linkedId);
+                if (state) {
+                    state.audioStreamUnsubscribe();
+                    await state.sttAdapter.stop();
+                    this._activeCalls.delete(linkedId);
+                }
+            }
+        });
+        return new Promise((resolve) => {
+            this.wsPool.once('__pipelineStop', () => {
+                unsubscribe();
+                resolve();
+            });
+        });
+    }
+    stopPipeline() {
+        this._running = false;
+        for (const [, state] of this._activeCalls) {
+            state.audioStreamUnsubscribe();
+            void state.sttAdapter.stop();
+        }
+        this._activeCalls.clear();
+        this.wsPool.emit('__pipelineStop');
+    }
+}
+//# sourceMappingURL=builder.js.map

package/dist/pipeline/builder.js.map

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

package/dist/session/manager.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Session Manager
+ *
+ * Lists active call/conference sessions and manages session metadata.
+ * REST API: GET /api/v1/sessions, PUT /api/v1/sessions/{linkedId}/meta
+ */
+import type { CallSession, Logger } from '../types/index.js';
+import type { HttpClient } from '../transport/http-client.js';
+export declare class SessionManager {
+    private readonly http;
+    private readonly logger;
+    constructor(http: HttpClient, logger: Logger);
+    /** List all currently active call sessions */
+    listSessions(): Promise<CallSession[]>;
+    /** List active call sessions filtered by tenant ID */
+    listSessionsByTenant(tenantId: string): Promise<CallSession[]>;
+    /** Update metadata key-value pairs on a session */
+    updateMetadata(linkedId: string, meta: Record<string, string>): Promise<void>;
+    private normalizeSession;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/session/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/session/manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAc9D,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM;IAK5C,8CAA8C;IACxC,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAU5C,sDAAsD;IAChD,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAYpE,mDAAmD;IAC7C,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,OAAO,CAAC,IAAI,CAAC;IAahB,OAAO,CAAC,gBAAgB;CAazB"}

package/dist/session/manager.js

@@ -0,0 +1,52 @@
+/**
+ * Session Manager
+ *
+ * Lists active call/conference sessions and manages session metadata.
+ * REST API: GET /api/v1/sessions, PUT /api/v1/sessions/{linkedId}/meta
+ */
+export class SessionManager {
+    http;
+    logger;
+    constructor(http, logger) {
+        this.http = http;
+        this.logger = logger;
+    }
+    /** List all currently active call sessions */
+    async listSessions() {
+        const response = await this.http.get('/api/v1/sessions');
+        if (response.status !== 200) {
+            throw new Error(`Failed to list sessions: HTTP ${response.status}`);
+        }
+        return (response.data.sessions ?? []).map(this.normalizeSession);
+    }
+    /** List active call sessions filtered by tenant ID */
+    async listSessionsByTenant(tenantId) {
+        const response = await this.http.get(`/api/v1/sessions?tenantId=${encodeURIComponent(tenantId)}`);
+        if (response.status !== 200) {
+            throw new Error(`Failed to list sessions by tenant: HTTP ${response.status}`);
+        }
+        return (response.data.sessions ?? []).map(this.normalizeSession);
+    }
+    /** Update metadata key-value pairs on a session */
+    async updateMetadata(linkedId, meta) {
+        const response = await this.http.put(`/api/v1/sessions/${encodeURIComponent(linkedId)}/meta`, { metadata: meta });
+        if (response.status !== 200 && response.status !== 204) {
+            throw new Error(`Failed to update session metadata: HTTP ${response.status}`);
+        }
+        this.logger.debug({ linkedId, keys: Object.keys(meta) }, 'Session metadata updated');
+    }
+    normalizeSession(raw) {
+        return {
+            linkedId: raw.linkedId,
+            confId: raw.confId,
+            dir: raw.dir ?? 'both',
+            caller: raw.caller,
+            callee: raw.callee,
+            startedAt: raw.startedAt ? new Date(raw.startedAt) : new Date(),
+            streamUrl: raw.streamUrl ?? '',
+            tenantId: raw.tenantId,
+            metadata: raw.metadata,
+        };
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/session/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/session/manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,MAAM,OAAO,cAAc;IACR,IAAI,CAAa;IACjB,MAAM,CAAS;IAEhC,YAAY,IAAgB,EAAE,MAAc;QAC1C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,8CAA8C;IAC9C,KAAK,CAAC,YAAY;QAChB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAA6B,kBAAkB,CAAC,CAAC;QAErF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,iCAAiC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACnE,CAAC;IAED,sDAAsD;IACtD,KAAK,CAAC,oBAAoB,CAAC,QAAgB;QACzC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAClC,6BAA6B,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAC5D,CAAC;QAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,2CAA2C,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAChF,CAAC;QAED,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACnE,CAAC;IAED,mDAAmD;IACnD,KAAK,CAAC,cAAc,CAClB,QAAgB,EAChB,IAA4B;QAE5B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAClC,oBAAoB,kBAAkB,CAAC,QAAQ,CAAC,OAAO,EACvD,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;QAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CAAC,2CAA2C,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAChF,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,0BAA0B,CAAC,CAAC;IACvF,CAAC;IAEO,gBAAgB,CAAC,GAAe;QACtC,OAAO;YACL,QAAQ,EAAG,GAAG,CAAC,QAAQ;YACvB,MAAM,EAAK,GAAG,CAAC,MAAM;YACrB,GAAG,EAAS,GAAG,CAAC,GAA6B,IAAI,MAAM;YACvD,MAAM,EAAK,GAAG,CAAC,MAAM;YACrB,MAAM,EAAK,GAAG,CAAC,MAAM;YACrB,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE;YAC/D,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE;YAC9B,QAAQ,EAAG,GAAG,CAAC,QAAQ;YACvB,QAAQ,EAAG,GAAG,CAAC,QAAQ;SACxB,CAAC;IACJ,CAAC;CACF"}

package/dist/streams/audio-stream.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Audio Stream
+ *
+ * Subscribes to real-time call audio from the DVGateway.
+ * Returns an AsyncIterable<AudioChunk> for easy integration with AI STT adapters.
+ *
+ * WebSocket endpoint: /api/v1/ws/stream?linkedid={id}&dir={both|in|out}
+ * Protocol: Binary frames (slin16, 16kHz, 16-bit, little-endian, 640 bytes/frame)
+ */
+import type { AudioChunk, StreamDir, Logger } from '../types/index.js';
+import type { WsPool } from '../transport/ws-pool.js';
+export interface AudioStreamOptions {
+    dir?: StreamDir;
+}
+/**
+ * Creates an async iterable of audio chunks for a given call session.
+ *
+ * Usage:
+ *   for await (const chunk of streamAudio(wsPool, linkedId, logger)) {
+ *     // chunk.samples: Float32Array [-1.0, 1.0]
+ *     // chunk.durationMs: 20
+ *   }
+ *
+ * The iterable ends when the call is hung up or unsubscribe() is called.
+ */
+export declare function createAudioStream(wsPool: WsPool, linkedId: string, logger: Logger, opts?: AudioStreamOptions): AsyncIterable<AudioChunk> & {
+    unsubscribe: () => void;
+};
+//# sourceMappingURL=audio-stream.d.ts.map

package/dist/streams/audio-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-stream.d.ts","sourceRoot":"","sources":["../../src/streams/audio-stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAMtD,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,SAAS,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,kBAAuB,GAC5B,aAAa,CAAC,UAAU,CAAC,GAAG;IAAE,WAAW,EAAE,MAAM,IAAI,CAAA;CAAE,CAwGzD"}

package/dist/streams/audio-stream.js

@@ -0,0 +1,118 @@
+/**
+ * Audio Stream
+ *
+ * Subscribes to real-time call audio from the DVGateway.
+ * Returns an AsyncIterable<AudioChunk> for easy integration with AI STT adapters.
+ *
+ * WebSocket endpoint: /api/v1/ws/stream?linkedid={id}&dir={both|in|out}
+ * Protocol: Binary frames (slin16, 16kHz, 16-bit, little-endian, 640 bytes/frame)
+ */
+import { v4 as uuidv4 } from 'uuid';
+import { slin16ToFloat32 } from '../audio/codec.js';
+const SAMPLE_RATE = 16000;
+const BYTES_PER_SAMPLE = 2;
+const FRAME_BYTES = 640; // 320 samples × 2 bytes = 20ms at 16kHz
+/**
+ * Creates an async iterable of audio chunks for a given call session.
+ *
+ * Usage:
+ *   for await (const chunk of streamAudio(wsPool, linkedId, logger)) {
+ *     // chunk.samples: Float32Array [-1.0, 1.0]
+ *     // chunk.durationMs: 20
+ *   }
+ *
+ * The iterable ends when the call is hung up or unsubscribe() is called.
+ */
+export function createAudioStream(wsPool, linkedId, logger, opts = {}) {
+    const dir = opts.dir ?? 'both';
+    const subId = `audio-${linkedId}-${uuidv4()}`;
+    const queue = [];
+    let waitResolve = null;
+    let ended = false;
+    function push(chunk) {
+        queue.push(chunk);
+        if (waitResolve) {
+            const r = waitResolve;
+            waitResolve = null;
+            r();
+        }
+    }
+    // Subscribe to WebSocket — fire-and-forget, errors surface via 'end'
+    void wsPool.subscribe({
+        id: subId,
+        path: '/api/v1/ws/stream',
+        params: { linkedid: linkedId, dir },
+        onMessage: (data) => {
+            if (ended)
+                return;
+            const timestampMs = Date.now();
+            // Handle multiple frames in one message (gateway may batch)
+            let offset = 0;
+            while (offset + FRAME_BYTES <= data.byteLength) {
+                const frameBytes = data.subarray(offset, offset + FRAME_BYTES);
+                const samples = slin16ToFloat32(frameBytes);
+                const durationMs = (samples.length / SAMPLE_RATE) * 1000;
+                push({
+                    linkedId,
+                    dir: dir === 'both' ? 'mixed' : dir,
+                    samples,
+                    sampleRate: SAMPLE_RATE,
+                    durationMs,
+                    timestampMs: timestampMs + offset / (SAMPLE_RATE * BYTES_PER_SAMPLE / 1000),
+                });
+                offset += FRAME_BYTES;
+            }
+            // Handle partial frame (rare, but possible)
+            if (offset < data.byteLength) {
+                const partial = data.subarray(offset);
+                const samples = slin16ToFloat32(partial);
+                const durationMs = (samples.length / SAMPLE_RATE) * 1000;
+                push({ linkedId, dir: dir === 'both' ? 'mixed' : dir, samples, sampleRate: SAMPLE_RATE, durationMs, timestampMs });
+            }
+        },
+        onClose: () => {
+            logger.debug({ linkedId }, 'Audio stream WebSocket closed');
+            push('end');
+        },
+    }).catch((err) => {
+        logger.error({ linkedId, err }, 'Audio stream subscription failed');
+        push('end');
+    });
+    const iterable = {
+        unsubscribe: () => {
+            ended = true;
+            wsPool.unsubscribe(subId);
+            push('end');
+        },
+        [Symbol.asyncIterator]() {
+            return {
+                async next() {
+                    // eslint-disable-next-line no-constant-condition
+                    while (true) {
+                        if (queue.length > 0) {
+                            const entry = queue.shift();
+                            if (entry === 'end') {
+                                return { done: true, value: undefined };
+                            }
+                            return { done: false, value: entry };
+                        }
+                        if (ended) {
+                            return { done: true, value: undefined };
+                        }
+                        // Wait for the next message
+                        await new Promise((resolve) => {
+                            waitResolve = resolve;
+                        });
+                    }
+                },
+                return() {
+                    ended = true;
+                    wsPool.unsubscribe(subId);
+                    return Promise.resolve({ done: true, value: undefined });
+                },
+            };
+        },
+    };
+    return iterable;
+}
+//# sourceMappingURL=audio-stream.js.map

package/dist/streams/audio-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-stream.js","sourceRoot":"","sources":["../../src/streams/audio-stream.ts"],"names":[],"mappings":"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"}

package/dist/streams/call-events.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Call Event Stream
+ *
+ * Subscribes to real-time call lifecycle events from the DVGateway.
+ * Events: call:new, call:ended, conf:join, conf:leave, conf:ended
+ *
+ * WebSocket endpoint: /api/v1/ws/callinfo
+ * Protocol: JSON text frames
+ */
+import type { CallEvent, Unsubscribe, Logger } from '../types/index.js';
+import type { WsPool } from '../transport/ws-pool.js';
+type CallEventHandler = (event: CallEvent) => void | Promise<void>;
+export declare class CallEventStream {
+    private readonly wsPool;
+    private readonly logger;
+    private readonly handlers;
+    private subscriptionId;
+    constructor(wsPool: WsPool, logger: Logger);
+    /**
+     * Subscribe to all call events.
+     * Returns an unsubscribe function.
+     */
+    on(handler: CallEventHandler): Unsubscribe;
+    /** Subscribe to a specific event type */
+    onType<T extends CallEvent>(type: T['type'], handler: (event: T) => void | Promise<void>): Unsubscribe;
+    private startSubscription;
+    private stopSubscription;
+    private handleMessage;
+    private normalizeEvent;
+}
+export {};
+//# sourceMappingURL=call-events.d.ts.map

package/dist/streams/call-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-events.d.ts","sourceRoot":"","sources":["../../src/streams/call-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD,KAAK,gBAAgB,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnE,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;IACxD,OAAO,CAAC,cAAc,CAAuB;gBAEjC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAK1C;;;OAGG;IACH,EAAE,CAAC,OAAO,EAAE,gBAAgB,GAAG,WAAW;IAiB1C,yCAAyC;IACzC,MAAM,CAAC,CAAC,SAAS,SAAS,EACxB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EACf,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC1C,WAAW;YAQA,iBAAiB;IAgB/B,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,cAAc;CA6DvB"}