dominus-sdk-nodejs 1.2.18 → 1.2.20

package/dist/namespaces/oracle/internal/VADGate.d.ts

@@ -0,0 +1,75 @@
+/**
+ * VADGate - Voice Activity Detection Gate (INTERNAL)
+ *
+ * Implements a 4-state machine for VAD gating:
+ * IDLE → ARMED → SPEAKING → TRAILING → IDLE
+ *
+ * Features:
+ * - Pre-roll buffer (320ms) to capture word onsets
+ * - Armed confirmation (80ms) to reject false triggers
+ * - Post-roll/trailing (400ms) to avoid chopped endings
+ * - Circular buffer for pre-roll storage
+ *
+ * This module is INTERNAL and should NOT be exported publicly.
+ */
+import type { VADState, ResolvedOracleSessionOptions } from '../types.js';
+/**
+ * VADGate - 4-state Voice Activity Detection machine.
+ *
+ * State transitions:
+ * - IDLE → ARMED: When VAD detects speech
+ * - ARMED → SPEAKING: After armedConfirmFrames of continuous speech
+ * - ARMED → IDLE: If speech stops before confirmation
+ * - SPEAKING → TRAILING: When VAD detects silence
+ * - TRAILING → SPEAKING: If speech resumes
+ * - TRAILING → IDLE: After postrollMs timeout
+ */
+export declare class VADGate {
+    private state;
+    private preRollBuffer;
+    private armedFrameCount;
+    private trailingTimeout;
+    private config;
+    private vadModel;
+    /** Callback when audio should be sent to server */
+    onSendAudio: ((frames: ArrayBuffer[]) => void) | null;
+    /** Callback when VAD state changes */
+    onStateChange: ((state: VADState) => void) | null;
+    constructor(options: ResolvedOracleSessionOptions, frameDurationMs?: number);
+    /**
+     * Initialize the VAD model (call before processing frames).
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get current VAD state.
+     */
+    getState(): VADState;
+    /**
+     * Process an audio frame through the VAD gate.
+     *
+     * @param pcmFrame - 20ms PCM16 audio frame (640 bytes)
+     */
+    processFrame(pcmFrame: ArrayBuffer): void;
+    /**
+     * Reset VAD state to idle.
+     */
+    reset(): void;
+    /**
+     * Clean up resources.
+     */
+    dispose(): void;
+    /**
+     * Update VAD state and fire callback.
+     */
+    private setState;
+    /**
+     * Start the trailing timeout.
+     * After postrollMs, transition back to idle.
+     */
+    private startTrailingTimer;
+    /**
+     * Cancel the trailing timeout.
+     */
+    private cancelTrailingTimer;
+}
+//# sourceMappingURL=VADGate.d.ts.map

package/dist/namespaces/oracle/internal/VADGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VADGate.d.ts","sourceRoot":"","sources":["../../../../src/namespaces/oracle/internal/VADGate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAwH1E;;;;;;;;;;GAUG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,eAAe,CAA8C;IACrE,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,QAAQ,CAAW;IAE3B,mDAAmD;IAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAEpE,sCAAsC;IAC/B,aAAa,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;gBAEpD,OAAO,EAAE,4BAA4B,EAAE,eAAe,GAAE,MAAW;IAc/E;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;OAEG;IACH,QAAQ,IAAI,QAAQ;IAIpB;;;;OAIG;IACH,YAAY,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;IAkDzC;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,OAAO,IAAI,IAAI;IAOf;;OAEG;IACH,OAAO,CAAC,QAAQ;IAOhB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAM5B"}

package/dist/namespaces/oracle/internal/VADGate.js

@@ -0,0 +1,248 @@
+/**
+ * VADGate - Voice Activity Detection Gate (INTERNAL)
+ *
+ * Implements a 4-state machine for VAD gating:
+ * IDLE → ARMED → SPEAKING → TRAILING → IDLE
+ *
+ * Features:
+ * - Pre-roll buffer (320ms) to capture word onsets
+ * - Armed confirmation (80ms) to reject false triggers
+ * - Post-roll/trailing (400ms) to avoid chopped endings
+ * - Circular buffer for pre-roll storage
+ *
+ * This module is INTERNAL and should NOT be exported publicly.
+ */
+/**
+ * Energy-based VAD fallback.
+ * Uses RMS energy detection when Silero ONNX is unavailable.
+ */
+class EnergyVAD {
+    energyThreshold;
+    constructor(energyThreshold) {
+        this.energyThreshold = energyThreshold;
+    }
+    isSpeech(pcmFrame, _threshold) {
+        const int16Array = new Int16Array(pcmFrame);
+        return detectSpeechByEnergy(int16Array, this.energyThreshold);
+    }
+    dispose() {
+        // No resources to clean up
+    }
+}
+/**
+ * Energy-based speech detection fallback.
+ * Calculates RMS energy and compares against threshold.
+ */
+function detectSpeechByEnergy(pcmFrame, threshold = 500) {
+    let sum = 0;
+    for (let i = 0; i < pcmFrame.length; i++) {
+        sum += pcmFrame[i] * pcmFrame[i];
+    }
+    return Math.sqrt(sum / pcmFrame.length) > threshold;
+}
+/**
+ * Silero VAD wrapper using @ricky0123/vad-web.
+ * Falls back to energy-based detection if ONNX fails.
+ */
+class SileroVAD {
+    threshold;
+    micVAD = null;
+    isInitialized = false;
+    fallback;
+    useFallback = false;
+    constructor(threshold, energyThreshold) {
+        this.threshold = threshold;
+        this.fallback = new EnergyVAD(energyThreshold);
+    }
+    /**
+     * Initialize Silero VAD model.
+     * Called lazily on first use.
+     */
+    async initialize() {
+        if (this.isInitialized)
+            return;
+        try {
+            // Dynamic import to avoid bundling issues in non-browser environments
+            const vadModule = await import('@ricky0123/vad-web');
+            // Create the VAD instance
+            this.micVAD = await vadModule.MicVAD.new({
+                positiveSpeechThreshold: this.threshold,
+                negativeSpeechThreshold: this.threshold - 0.15,
+                redemptionFrames: 3,
+                preSpeechPadFrames: 1,
+                minSpeechFrames: 3,
+                onSpeechStart: () => { },
+                onSpeechEnd: () => { },
+                onVADMisfire: () => { },
+            });
+            this.isInitialized = true;
+        }
+        catch (error) {
+            console.warn('[OracleSDK] Silero VAD initialization failed, using energy-based fallback:', error);
+            this.useFallback = true;
+            this.isInitialized = true;
+        }
+    }
+    isSpeech(pcmFrame, threshold) {
+        if (this.useFallback || !this.micVAD) {
+            return this.fallback.isSpeech(pcmFrame, threshold);
+        }
+        // For now, use energy-based detection as Silero requires specific frame processing
+        // The full Silero integration would require feeding frames through the ONNX model
+        // This is a simplification - in production, you'd use the micVAD's internal VAD
+        return this.fallback.isSpeech(pcmFrame, threshold);
+    }
+    dispose() {
+        if (this.micVAD && typeof this.micVAD.destroy === 'function') {
+            this.micVAD.destroy();
+        }
+        this.micVAD = null;
+        this.isInitialized = false;
+    }
+}
+/**
+ * VADGate - 4-state Voice Activity Detection machine.
+ *
+ * State transitions:
+ * - IDLE → ARMED: When VAD detects speech
+ * - ARMED → SPEAKING: After armedConfirmFrames of continuous speech
+ * - ARMED → IDLE: If speech stops before confirmation
+ * - SPEAKING → TRAILING: When VAD detects silence
+ * - TRAILING → SPEAKING: If speech resumes
+ * - TRAILING → IDLE: After postrollMs timeout
+ */
+export class VADGate {
+    state = 'idle';
+    preRollBuffer = [];
+    armedFrameCount = 0;
+    trailingTimeout = null;
+    config;
+    vadModel;
+    /** Callback when audio should be sent to server */
+    onSendAudio = null;
+    /** Callback when VAD state changes */
+    onStateChange = null;
+    constructor(options, frameDurationMs = 20) {
+        this.config = {
+            prerollFrames: Math.ceil(options.prerollMs / frameDurationMs),
+            armedConfirmFrames: Math.ceil(options.armedConfirmMs / frameDurationMs),
+            postrollMs: options.postrollMs,
+            threshold: options.vadThreshold,
+            energyThreshold: options.energyThreshold,
+        };
+        // Use energy-based VAD as the primary implementation
+        // Silero VAD requires complex ONNX setup that may not work in all environments
+        this.vadModel = new EnergyVAD(this.config.energyThreshold);
+    }
+    /**
+     * Initialize the VAD model (call before processing frames).
+     */
+    async initialize() {
+        if (this.vadModel instanceof SileroVAD) {
+            await this.vadModel.initialize();
+        }
+    }
+    /**
+     * Get current VAD state.
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Process an audio frame through the VAD gate.
+     *
+     * @param pcmFrame - 20ms PCM16 audio frame (640 bytes)
+     */
+    processFrame(pcmFrame) {
+        // Maintain circular pre-roll buffer
+        this.preRollBuffer.push(pcmFrame);
+        if (this.preRollBuffer.length > this.config.prerollFrames) {
+            this.preRollBuffer.shift();
+        }
+        const isSpeech = this.vadModel.isSpeech(pcmFrame, this.config.threshold);
+        switch (this.state) {
+            case 'idle':
+                if (isSpeech) {
+                    this.setState('armed');
+                    this.armedFrameCount = 1;
+                }
+                break;
+            case 'armed':
+                if (isSpeech) {
+                    this.armedFrameCount++;
+                    if (this.armedFrameCount >= this.config.armedConfirmFrames) {
+                        // Confirmed speech - flush pre-roll buffer
+                        this.onSendAudio?.(this.preRollBuffer.slice());
+                        this.setState('speaking');
+                    }
+                }
+                else {
+                    // False trigger - back to idle
+                    this.setState('idle');
+                    this.armedFrameCount = 0;
+                }
+                break;
+            case 'speaking':
+                this.onSendAudio?.([pcmFrame]);
+                if (!isSpeech) {
+                    this.setState('trailing');
+                    this.startTrailingTimer();
+                }
+                break;
+            case 'trailing':
+                this.onSendAudio?.([pcmFrame]);
+                if (isSpeech) {
+                    this.cancelTrailingTimer();
+                    this.setState('speaking');
+                }
+                break;
+        }
+    }
+    /**
+     * Reset VAD state to idle.
+     */
+    reset() {
+        this.cancelTrailingTimer();
+        this.state = 'idle';
+        this.preRollBuffer = [];
+        this.armedFrameCount = 0;
+    }
+    /**
+     * Clean up resources.
+     */
+    dispose() {
+        this.cancelTrailingTimer();
+        this.vadModel.dispose();
+        this.onSendAudio = null;
+        this.onStateChange = null;
+    }
+    /**
+     * Update VAD state and fire callback.
+     */
+    setState(newState) {
+        if (this.state !== newState) {
+            this.state = newState;
+            this.onStateChange?.(newState);
+        }
+    }
+    /**
+     * Start the trailing timeout.
+     * After postrollMs, transition back to idle.
+     */
+    startTrailingTimer() {
+        this.trailingTimeout = setTimeout(() => {
+            this.setState('idle');
+            this.trailingTimeout = null;
+        }, this.config.postrollMs);
+    }
+    /**
+     * Cancel the trailing timeout.
+     */
+    cancelTrailingTimer() {
+        if (this.trailingTimeout !== null) {
+            clearTimeout(this.trailingTimeout);
+            this.trailingTimeout = null;
+        }
+    }
+}
+//# sourceMappingURL=VADGate.js.map

package/dist/namespaces/oracle/internal/VADGate.js.map

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

package/dist/namespaces/oracle/types.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Oracle Namespace Types - Public interfaces for streaming transcription.
+ *
+ * Oracle provides real-time speech-to-text via Deepgram streaming,
+ * with built-in VAD (Voice Activity Detection) for cost optimization.
+ */
+/**
+ * VAD (Voice Activity Detection) states.
+ *
+ * The VAD gate uses a 4-state machine:
+ * - IDLE: No speech detected, not sending audio
+ * - ARMED: Potential speech detected, buffering for confirmation
+ * - SPEAKING: Confirmed speech, actively streaming
+ * - TRAILING: Speech ended, post-roll buffer active
+ */
+export type VADState = 'idle' | 'armed' | 'speaking' | 'trailing';
+/**
+ * Configuration options for OracleSession.
+ */
+export interface OracleSessionOptions {
+    /** Pre-roll buffer duration in ms (default: 320) */
+    prerollMs?: number;
+    /** Post-roll duration in ms (default: 400) */
+    postrollMs?: number;
+    /** VAD confirmation time in ms (default: 80) */
+    armedConfirmMs?: number;
+    /** VAD speech threshold 0-1 (default: 0.5) - used for energy-based fallback */
+    vadThreshold?: number;
+    /** Energy threshold for fallback VAD (default: 500) */
+    energyThreshold?: number;
+    /** Ping interval in ms for keepalive (default: 10000) */
+    pingIntervalMs?: number;
+}
+/**
+ * Resolved session options with all defaults applied.
+ */
+export interface ResolvedOracleSessionOptions {
+    prerollMs: number;
+    postrollMs: number;
+    armedConfirmMs: number;
+    vadThreshold: number;
+    energyThreshold: number;
+    pingIntervalMs: number;
+}
+/**
+ * Default configuration values for OracleSession.
+ */
+export declare const DEFAULT_OPTIONS: ResolvedOracleSessionOptions;
+/**
+ * Audio configuration constants.
+ */
+export declare const AUDIO_CONFIG: {
+    readonly SAMPLE_RATE: 16000;
+    readonly CHANNELS: 1;
+    readonly FRAME_DURATION_MS: 20;
+    readonly FRAME_SIZE_BYTES: 640;
+    readonly SAMPLES_PER_FRAME: 320;
+};
+/**
+ * WebSocket message types from the server.
+ */
+export interface ServerReadyMessage {
+    type: 'ready';
+}
+export interface ServerTranscriptMessage {
+    type: 'transcript';
+    text: string;
+    is_final: boolean;
+    speech_final: boolean;
+}
+export interface ServerPongMessage {
+    type: 'pong';
+}
+export interface ServerErrorMessage {
+    type: 'error';
+    message: string;
+}
+export type ServerMessage = ServerReadyMessage | ServerTranscriptMessage | ServerPongMessage | ServerErrorMessage;
+/**
+ * Event callbacks for OracleSession.
+ */
+export interface OracleSessionCallbacks {
+    /** Called when session is ready to receive speech */
+    onReady?: () => void;
+    /** Called with interim transcripts (may change) */
+    onInterim?: (text: string) => void;
+    /** Called when a transcript segment is finalized */
+    onFinal?: (text: string) => void;
+    /** Called when user finishes an utterance (trigger for Curator) */
+    onUtterance?: (text: string) => void;
+    /** Called on any error */
+    onError?: (error: Error) => void;
+    /** Called when session closes */
+    onClose?: () => void;
+    /** Called when VAD state changes (for UI indicators) */
+    onVADStateChange?: (state: VADState) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/namespaces/oracle/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/namespaces/oracle/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,4BAO7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;CAMf,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,aAAa,GACrB,kBAAkB,GAClB,uBAAuB,GACvB,iBAAiB,GACjB,kBAAkB,CAAC;AAEvB;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,mDAAmD;IACnD,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,oDAAoD;IACpD,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,mEAAmE;IACnE,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,0BAA0B;IAC1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC9C"}

package/dist/namespaces/oracle/types.js

@@ -0,0 +1,28 @@
+/**
+ * Oracle Namespace Types - Public interfaces for streaming transcription.
+ *
+ * Oracle provides real-time speech-to-text via Deepgram streaming,
+ * with built-in VAD (Voice Activity Detection) for cost optimization.
+ */
+/**
+ * Default configuration values for OracleSession.
+ */
+export const DEFAULT_OPTIONS = {
+    prerollMs: 320, // 16 frames x 20ms
+    postrollMs: 400, // Post-roll trailing duration
+    armedConfirmMs: 80, // 4 frames x 20ms to confirm speech
+    vadThreshold: 0.5, // Silero VAD threshold
+    energyThreshold: 200, // Energy-based fallback threshold (lowered for sensitivity)
+    pingIntervalMs: 10000, // 10 second ping interval
+};
+/**
+ * Audio configuration constants.
+ */
+export const AUDIO_CONFIG = {
+    SAMPLE_RATE: 16000, // 16kHz
+    CHANNELS: 1, // Mono
+    FRAME_DURATION_MS: 20, // 20ms frames
+    FRAME_SIZE_BYTES: 640, // 320 samples x 2 bytes per sample
+    SAMPLES_PER_FRAME: 320, // 16kHz x 20ms
+};
+//# sourceMappingURL=types.js.map

package/dist/namespaces/oracle/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/namespaces/oracle/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2CH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAiC;IAC3D,SAAS,EAAE,GAAG,EAAU,mBAAmB;IAC3C,UAAU,EAAE,GAAG,EAAS,8BAA8B;IACtD,cAAc,EAAE,EAAE,EAAM,oCAAoC;IAC5D,YAAY,EAAE,GAAG,EAAO,uBAAuB;IAC/C,eAAe,EAAE,GAAG,EAAI,4DAA4D;IACpF,cAAc,EAAE,KAAK,EAAG,0BAA0B;CACnD,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,WAAW,EAAE,KAAK,EAAM,QAAQ;IAChC,QAAQ,EAAE,CAAC,EAAa,OAAO;IAC/B,iBAAiB,EAAE,EAAE,EAAG,cAAc;IACtC,gBAAgB,EAAE,GAAG,EAAG,mCAAmC;IAC3D,iBAAiB,EAAE,GAAG,EAAE,eAAe;CAC/B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dominus-sdk-nodejs",
-  "version": "1.2.18",
+  "version": "1.2.20",
   "description": "Node.js SDK for the Dominus Orchestrator Platform",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -30,6 +30,7 @@
     "url": "https://github.com/carebridgesystems/dominus-sdk-nodejs.git"
   },
   "dependencies": {
+    "@ricky0123/vad-web": "^0.0.22",
     "bcryptjs": "^2.4.3"
   },
   "devDependencies": {