even-toolkit 1.0.0 → 1.1.0

package/dist/stt/providers/whisper-local/provider.js

@@ -0,0 +1,174 @@
+export class WhisperLocalProvider {
+    constructor() {
+        this.type = 'whisper-local';
+        this.supportedModes = ['batch'];
+        this._state = 'idle';
+        this.worker = null;
+        this.config = {};
+        this.ready = false;
+        this.transcriptCbs = [];
+        this.stateCbs = [];
+        this.errorCbs = [];
+        this.pendingResolve = null;
+        this.pendingReject = null;
+        this.initResolve = null;
+        this.initReject = null;
+    }
+    get state() {
+        return this._state;
+    }
+    async init(config) {
+        this.config = config;
+        this.setState('loading');
+        return new Promise((resolve, reject) => {
+            this.initResolve = resolve;
+            this.initReject = reject;
+            this.worker = new Worker(new URL('./worker.ts', import.meta.url), { type: 'module' });
+            this.worker.onmessage = (e) => {
+                this.handleWorkerMessage(e.data);
+            };
+            this.worker.onerror = (err) => {
+                const sttError = {
+                    code: 'model-load',
+                    message: err.message || 'Worker error',
+                    provider: this.type,
+                };
+                this.emitError(sttError);
+                this.setState('error');
+                if (this.initReject) {
+                    this.initReject(new Error(sttError.message));
+                    this.initResolve = null;
+                    this.initReject = null;
+                }
+            };
+            const msg = {
+                type: 'init',
+                modelId: config.modelId,
+                language: config.language,
+            };
+            this.worker.postMessage(msg);
+        });
+    }
+    start() {
+        // Batch mode: start is a no-op; audio is fed via transcribe()
+        if (this.ready) {
+            this.setState('listening');
+        }
+    }
+    stop() {
+        if (this._state === 'listening' || this._state === 'processing') {
+            this.setState('idle');
+        }
+    }
+    abort() {
+        if (this.pendingReject) {
+            this.pendingReject(new Error('Aborted'));
+            this.pendingResolve = null;
+            this.pendingReject = null;
+        }
+        this.setState('idle');
+    }
+    dispose() {
+        this.abort();
+        if (this.worker) {
+            this.worker.terminate();
+            this.worker = null;
+        }
+        this.ready = false;
+        this.transcriptCbs = [];
+        this.stateCbs = [];
+        this.errorCbs = [];
+    }
+    async transcribe(audio, sampleRate) {
+        if (!this.worker || !this.ready) {
+            throw new Error('Provider not initialized');
+        }
+        this.setState('processing');
+        return new Promise((resolve, reject) => {
+            this.pendingResolve = resolve;
+            this.pendingReject = reject;
+            this.worker.postMessage({ type: 'transcribe', audio, language: this.config.language ?? 'en', sampleRate }, [audio.buffer]);
+        });
+    }
+    onTranscript(cb) {
+        this.transcriptCbs.push(cb);
+        return () => { this.transcriptCbs = this.transcriptCbs.filter((c) => c !== cb); };
+    }
+    onStateChange(cb) {
+        this.stateCbs.push(cb);
+        return () => { this.stateCbs = this.stateCbs.filter((c) => c !== cb); };
+    }
+    onError(cb) {
+        this.errorCbs.push(cb);
+        return () => { this.errorCbs = this.errorCbs.filter((c) => c !== cb); };
+    }
+    // ── Private ──
+    handleWorkerMessage(data) {
+        switch (data.type) {
+            case 'ready':
+                this.ready = true;
+                this.setState('idle');
+                if (this.initResolve) {
+                    this.initResolve();
+                    this.initResolve = null;
+                    this.initReject = null;
+                }
+                break;
+            case 'progress':
+                // Model download progress — stay in loading state
+                break;
+            case 'result': {
+                const transcript = {
+                    text: data.text ?? '',
+                    isFinal: true,
+                    confidence: data.confidence ?? 0.95,
+                    timestamp: Date.now(),
+                };
+                this.emitTranscript(transcript);
+                this.setState('listening');
+                if (this.pendingResolve) {
+                    this.pendingResolve(transcript);
+                    this.pendingResolve = null;
+                    this.pendingReject = null;
+                }
+                break;
+            }
+            case 'error': {
+                const sttError = {
+                    code: 'model-load',
+                    message: data.message ?? 'Worker error',
+                    provider: this.type,
+                };
+                this.emitError(sttError);
+                this.setState('error');
+                if (this.pendingReject) {
+                    this.pendingReject(new Error(sttError.message));
+                    this.pendingResolve = null;
+                    this.pendingReject = null;
+                }
+                if (this.initReject) {
+                    this.initReject(new Error(sttError.message));
+                    this.initResolve = null;
+                    this.initReject = null;
+                }
+                break;
+            }
+        }
+    }
+    setState(s) {
+        if (this._state === s)
+            return;
+        this._state = s;
+        for (const cb of this.stateCbs)
+            cb(s);
+    }
+    emitTranscript(t) {
+        for (const cb of this.transcriptCbs)
+            cb(t);
+    }
+    emitError(e) {
+        for (const cb of this.errorCbs)
+            cb(e);
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/stt/providers/whisper-local/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../stt/providers/whisper-local/provider.ts"],"names":[],"mappings":"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"}

package/dist/stt/providers/whisper-local/worker.d.ts

@@ -0,0 +1,2 @@
+declare let pipe: any;
+//# sourceMappingURL=worker.d.ts.map

package/dist/stt/providers/whisper-local/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../../stt/providers/whisper-local/worker.ts"],"names":[],"mappings":"AAEA,QAAA,IAAI,IAAI,EAAE,GAAU,CAAC"}

package/dist/stt/providers/whisper-local/worker.js

@@ -0,0 +1,35 @@
+"use strict";
+// WebWorker for Whisper local inference via @huggingface/transformers
+let pipe = null;
+self.onmessage = async (e) => {
+    const { type } = e.data;
+    if (type === 'init') {
+        try {
+            const { pipeline } = await import('@huggingface/transformers');
+            pipe = await pipeline('automatic-speech-recognition', e.data.modelId ?? 'onnx-community/whisper-tiny', {
+                progress_callback: (p) => self.postMessage({ type: 'progress', ...p }),
+            });
+            self.postMessage({ type: 'ready' });
+        }
+        catch (err) {
+            self.postMessage({ type: 'error', message: err?.message ?? 'Failed to load model' });
+        }
+    }
+    if (type === 'transcribe') {
+        if (!pipe) {
+            self.postMessage({ type: 'error', message: 'Model not loaded' });
+            return;
+        }
+        try {
+            const result = await pipe(e.data.audio, {
+                language: e.data.language ?? 'en',
+                return_timestamps: false,
+            });
+            self.postMessage({ type: 'result', text: result.text, confidence: 0.95 });
+        }
+        catch (err) {
+            self.postMessage({ type: 'error', message: err?.message ?? 'Transcription failed' });
+        }
+    }
+};
+//# sourceMappingURL=worker.js.map

package/dist/stt/providers/whisper-local/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../../../stt/providers/whisper-local/worker.ts"],"names":[],"mappings":";AAAA,sEAAsE;AAEtE,IAAI,IAAI,GAAQ,IAAI,CAAC;AAErB,IAAI,CAAC,SAAS,GAAG,KAAK,EAAE,CAAe,EAAE,EAAE;IACzC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC;IAExB,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;YAC/D,IAAI,GAAG,MAAM,QAAQ,CACnB,8BAA8B,EAC9B,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,6BAA6B,EAC/C;gBACE,iBAAiB,EAAE,CAAC,CAAM,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,CAAC;aAC5E,CACF,CAAC;YACF,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,sBAAsB,EAAE,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IAED,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC,CAAC;YACjE,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE;gBACtC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI;gBACjC,iBAAiB,EAAE,KAAK;aACzB,CAAC,CAAC;YACH,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5E,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,sBAAsB,EAAE,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;AACH,CAAC,CAAC"}

package/dist/stt/react/useSTT.d.ts

@@ -0,0 +1,3 @@
+import type { UseSTTConfig, UseSTTReturn } from '../types';
+export declare function useSTT(config?: UseSTTConfig): UseSTTReturn;
+//# sourceMappingURL=useSTT.d.ts.map

package/dist/stt/react/useSTT.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSTT.d.ts","sourceRoot":"","sources":["../../../stt/react/useSTT.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAsB,MAAM,UAAU,CAAC;AAG/E,wBAAgB,MAAM,CAAC,MAAM,GAAE,YAAiB,GAAG,YAAY,CA4G9D"}

package/dist/stt/react/useSTT.js

@@ -0,0 +1,99 @@
+import { useState, useRef, useEffect, useCallback } from 'react';
+import { STTEngine } from '../engine';
+export function useSTT(config = {}) {
+    const [transcript, setTranscript] = useState('');
+    const [interimTranscript, setInterimTranscript] = useState('');
+    const [isListening, setIsListening] = useState(false);
+    const [isLoading, setIsLoading] = useState(false);
+    const [loadProgress] = useState(0);
+    const [error, setError] = useState(null);
+    const [state, setState] = useState('idle');
+    const engineRef = useRef(null);
+    const configRef = useRef(config);
+    configRef.current = config;
+    // Cleanup on unmount
+    useEffect(() => {
+        return () => {
+            engineRef.current?.dispose();
+            engineRef.current = null;
+        };
+    }, []);
+    const start = useCallback(async () => {
+        // Dispose previous engine
+        engineRef.current?.dispose();
+        const cfg = configRef.current;
+        const engine = new STTEngine({
+            provider: cfg.provider ?? 'web-speech',
+            source: cfg.source,
+            language: cfg.language,
+            mode: cfg.mode,
+            apiKey: cfg.apiKey,
+            modelId: cfg.modelId,
+            continuous: cfg.continuous,
+            vad: cfg.vad,
+            fallback: cfg.fallback,
+        });
+        engineRef.current = engine;
+        // Subscribe to events
+        engine.onTranscript((t) => {
+            if (t.isFinal) {
+                setTranscript((prev) => (prev ? prev + ' ' + t.text : t.text));
+                setInterimTranscript('');
+            }
+            else {
+                setInterimTranscript(t.text);
+            }
+            cfg.onTranscript?.(t.text, t.isFinal);
+        });
+        engine.onStateChange((s) => {
+            setState(s);
+            setIsListening(s === 'listening');
+            setIsLoading(s === 'loading');
+            if (s === 'idle') {
+                setInterimTranscript('');
+            }
+        });
+        engine.onError((e) => {
+            setError(e);
+        });
+        setError(null);
+        await engine.start();
+    }, []);
+    const stop = useCallback(() => {
+        engineRef.current?.stop();
+    }, []);
+    const abort = useCallback(() => {
+        engineRef.current?.abort();
+    }, []);
+    const reset = useCallback(() => {
+        engineRef.current?.abort();
+        setTranscript('');
+        setInterimTranscript('');
+        setError(null);
+        setState('idle');
+        setIsListening(false);
+        setIsLoading(false);
+    }, []);
+    // Auto-start if configured
+    useEffect(() => {
+        if (config.autoStart) {
+            start();
+        }
+        // Only run on mount
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+    return {
+        transcript,
+        interimTranscript,
+        isListening,
+        isLoading,
+        loadProgress,
+        error,
+        state,
+        start,
+        stop,
+        abort,
+        reset,
+    };
+}
+//# sourceMappingURL=useSTT.js.map

package/dist/stt/react/useSTT.js.map

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

package/dist/stt/registry.d.ts

@@ -0,0 +1,3 @@
+import type { STTProvider } from './types';
+export declare function createProvider(type: string): Promise<STTProvider>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/stt/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../stt/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAqBvE"}

package/dist/stt/registry.js

@@ -0,0 +1,23 @@
+export async function createProvider(type) {
+    switch (type) {
+        case 'web-speech': {
+            const { WebSpeechProvider } = await import('./providers/web-speech');
+            return new WebSpeechProvider();
+        }
+        case 'whisper-local': {
+            const { WhisperLocalProvider } = await import('./providers/whisper-local/provider');
+            return new WhisperLocalProvider();
+        }
+        case 'whisper-api': {
+            const { WhisperApiProvider } = await import('./providers/whisper-api');
+            return new WhisperApiProvider();
+        }
+        case 'deepgram': {
+            const { DeepgramProvider } = await import('./providers/deepgram');
+            return new DeepgramProvider();
+        }
+        default:
+            throw new Error(`Unknown STT provider: ${type}`);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/stt/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../stt/registry.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;YACrE,OAAO,IAAI,iBAAiB,EAAE,CAAC;QACjC,CAAC;QACD,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,oCAAoC,CAAC,CAAC;YACpF,OAAO,IAAI,oBAAoB,EAAE,CAAC;QACpC,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;YACvE,OAAO,IAAI,kBAAkB,EAAE,CAAC;QAClC,CAAC;QACD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;YAClE,OAAO,IAAI,gBAAgB,EAAE,CAAC;QAChC,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}

package/dist/stt/sources/glass-bridge.d.ts

@@ -0,0 +1,28 @@
+import type { AudioSource } from '../types';
+export interface GlassBridgeSourceConfig {
+    /** The EvenHub bridge instance that fires audio events */
+    bridge: {
+        onEvent(handler: (event: GlassAudioEvent) => void): void;
+    };
+}
+export interface GlassAudioEvent {
+    audioEvent?: {
+        audioPcm?: Uint8Array;
+    };
+}
+/**
+ * AudioSource for G2 smart glasses.
+ * Listens for audio PCM events from the EvenHub SDK bridge
+ * and converts 16-bit PCM to Float32.
+ */
+export declare class GlassBridgeSource implements AudioSource {
+    private config;
+    private listeners;
+    private listening;
+    constructor(config: GlassBridgeSourceConfig);
+    start(): Promise<void>;
+    stop(): void;
+    onAudioData(cb: (pcm: Float32Array, sampleRate: number) => void): () => void;
+    dispose(): void;
+}
+//# sourceMappingURL=glass-bridge.d.ts.map

package/dist/stt/sources/glass-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glass-bridge.d.ts","sourceRoot":"","sources":["../../../stt/sources/glass-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAK5C,MAAM,WAAW,uBAAuB;IACtC,0DAA0D;IAC1D,MAAM,EAAE;QACN,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI,CAAC;KAC1D,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE;QACX,QAAQ,CAAC,EAAE,UAAU,CAAC;KACvB,CAAC;CACH;AAED;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,SAAS,CAA8D;IAC/E,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,uBAAuB;IAIrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB5B,IAAI,IAAI,IAAI;IAIZ,WAAW,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAQ5E,OAAO,IAAI,IAAI;CAIhB"}

package/dist/stt/sources/glass-bridge.js

@@ -0,0 +1,47 @@
+import { uint8ToPcm16, pcm16ToFloat32 } from '../audio/pcm-utils';
+const GLASS_SAMPLE_RATE = 16000;
+/**
+ * AudioSource for G2 smart glasses.
+ * Listens for audio PCM events from the EvenHub SDK bridge
+ * and converts 16-bit PCM to Float32.
+ */
+export class GlassBridgeSource {
+    constructor(config) {
+        this.listeners = [];
+        this.listening = false;
+        this.config = config;
+    }
+    async start() {
+        if (this.listening)
+            return;
+        this.listening = true;
+        this.config.bridge.onEvent((event) => {
+            if (!this.listening)
+                return;
+            const audioPcm = event.audioEvent?.audioPcm;
+            if (!audioPcm || audioPcm.length === 0)
+                return;
+            const pcm16 = uint8ToPcm16(audioPcm);
+            const float32 = pcm16ToFloat32(pcm16);
+            for (const cb of this.listeners) {
+                cb(float32, GLASS_SAMPLE_RATE);
+            }
+        });
+    }
+    stop() {
+        this.listening = false;
+    }
+    onAudioData(cb) {
+        this.listeners.push(cb);
+        return () => {
+            const idx = this.listeners.indexOf(cb);
+            if (idx >= 0)
+                this.listeners.splice(idx, 1);
+        };
+    }
+    dispose() {
+        this.stop();
+        this.listeners.length = 0;
+    }
+}
+//# sourceMappingURL=glass-bridge.js.map

package/dist/stt/sources/glass-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glass-bridge.js","sourceRoot":"","sources":["../../../stt/sources/glass-bridge.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAElE,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAehC;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IAK5B,YAAY,MAA+B;QAHnC,cAAS,GAA2D,EAAE,CAAC;QACvE,cAAS,GAAG,KAAK,CAAC;QAGxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAEtB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAsB,EAAE,EAAE;YACpD,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,OAAO;YAC5B,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,EAAE,QAAQ,CAAC;YAC5C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YAE/C,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;YACrC,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YAEtC,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBAChC,EAAE,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;YACjC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI;QACF,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IACzB,CAAC;IAED,WAAW,CAAC,EAAmD;QAC7D,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxB,OAAO,GAAG,EAAE;YACV,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACvC,IAAI,GAAG,IAAI,CAAC;gBAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC9C,CAAC,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAC5B,CAAC;CACF"}

package/dist/stt/sources/microphone.d.ts

@@ -0,0 +1,17 @@
+import type { AudioSource } from '../types';
+/**
+ * AudioSource that captures PCM audio from the device microphone
+ * using getUserMedia and ScriptProcessorNode.
+ */
+export declare class MicrophoneSource implements AudioSource {
+    private stream;
+    private audioContext;
+    private scriptNode;
+    private sourceNode;
+    private listeners;
+    start(): Promise<void>;
+    stop(): void;
+    onAudioData(cb: (pcm: Float32Array, sampleRate: number) => void): () => void;
+    dispose(): void;
+}
+//# sourceMappingURL=microphone.d.ts.map

package/dist/stt/sources/microphone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"microphone.d.ts","sourceRoot":"","sources":["../../../stt/sources/microphone.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAK5C;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,WAAW;IAClD,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,UAAU,CAA2C;IAC7D,OAAO,CAAC,SAAS,CAA8D;IAEzE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB5B,IAAI,IAAI,IAAI;IAsBZ,WAAW,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAQ5E,OAAO,IAAI,IAAI;CAIhB"}

package/dist/stt/sources/microphone.js

@@ -0,0 +1,69 @@
+const CHUNK_SIZE = 4096;
+const DEFAULT_SAMPLE_RATE = 16000;
+/**
+ * AudioSource that captures PCM audio from the device microphone
+ * using getUserMedia and ScriptProcessorNode.
+ */
+export class MicrophoneSource {
+    constructor() {
+        this.stream = null;
+        this.audioContext = null;
+        this.scriptNode = null;
+        this.sourceNode = null;
+        this.listeners = [];
+    }
+    async start() {
+        this.stream = await navigator.mediaDevices.getUserMedia({
+            audio: { sampleRate: DEFAULT_SAMPLE_RATE, channelCount: 1 },
+        });
+        this.audioContext = new AudioContext({ sampleRate: DEFAULT_SAMPLE_RATE });
+        this.sourceNode = this.audioContext.createMediaStreamSource(this.stream);
+        this.scriptNode = this.audioContext.createScriptProcessor(CHUNK_SIZE, 1, 1);
+        this.scriptNode.onaudioprocess = (event) => {
+            const input = event.inputBuffer.getChannelData(0);
+            // Copy the buffer — it's reused by the browser
+            const chunk = new Float32Array(input.length);
+            chunk.set(input);
+            const rate = this.audioContext?.sampleRate ?? DEFAULT_SAMPLE_RATE;
+            for (const cb of this.listeners) {
+                cb(chunk, rate);
+            }
+        };
+        this.sourceNode.connect(this.scriptNode);
+        this.scriptNode.connect(this.audioContext.destination);
+    }
+    stop() {
+        if (this.scriptNode) {
+            this.scriptNode.onaudioprocess = null;
+            this.scriptNode.disconnect();
+            this.scriptNode = null;
+        }
+        if (this.sourceNode) {
+            this.sourceNode.disconnect();
+            this.sourceNode = null;
+        }
+        if (this.stream) {
+            for (const track of this.stream.getTracks()) {
+                track.stop();
+            }
+            this.stream = null;
+        }
+        if (this.audioContext) {
+            this.audioContext.close().catch(() => { });
+            this.audioContext = null;
+        }
+    }
+    onAudioData(cb) {
+        this.listeners.push(cb);
+        return () => {
+            const idx = this.listeners.indexOf(cb);
+            if (idx >= 0)
+                this.listeners.splice(idx, 1);
+        };
+    }
+    dispose() {
+        this.stop();
+        this.listeners.length = 0;
+    }
+}
+//# sourceMappingURL=microphone.js.map

package/dist/stt/sources/microphone.js.map

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

package/dist/stt/types.d.ts

@@ -0,0 +1,89 @@
+export type STTProviderType = 'web-speech' | 'whisper-local' | 'whisper-api' | 'deepgram' | string;
+export type STTMode = 'streaming' | 'batch';
+export type STTState = 'idle' | 'loading' | 'listening' | 'processing' | 'error';
+export interface STTTranscript {
+    text: string;
+    isFinal: boolean;
+    confidence: number;
+    language?: string;
+    timestamp: number;
+}
+export interface STTProviderConfig {
+    language?: string;
+    mode?: STTMode;
+    apiKey?: string;
+    modelId?: string;
+    continuous?: boolean;
+    vadEnabled?: boolean;
+    vadSilenceMs?: number;
+    sampleRate?: number;
+    maxDurationMs?: number;
+}
+export interface STTError {
+    code: 'not-allowed' | 'no-speech' | 'network' | 'model-load' | 'aborted' | 'unsupported' | 'unknown';
+    message: string;
+    provider: STTProviderType;
+}
+export interface STTProvider {
+    readonly type: STTProviderType;
+    readonly supportedModes: STTMode[];
+    readonly state: STTState;
+    init(config: STTProviderConfig): Promise<void>;
+    start(): void;
+    stop(): void;
+    abort(): void;
+    dispose(): void;
+    onTranscript(cb: (t: STTTranscript) => void): () => void;
+    onStateChange(cb: (s: STTState) => void): () => void;
+    onError(cb: (e: STTError) => void): () => void;
+    /** Batch mode: feed raw audio for transcription */
+    transcribe?(audio: Float32Array, sampleRate: number): Promise<STTTranscript>;
+}
+export interface AudioSource {
+    start(): Promise<void>;
+    stop(): void;
+    onAudioData(cb: (pcm: Float32Array, sampleRate: number) => void): () => void;
+    dispose(): void;
+}
+export interface STTEngineConfig {
+    provider: STTProviderType;
+    source?: 'microphone' | 'glass-bridge' | AudioSource;
+    language?: string;
+    mode?: STTMode;
+    apiKey?: string;
+    modelId?: string;
+    continuous?: boolean;
+    vad?: boolean | {
+        silenceMs?: number;
+        thresholdDb?: number;
+    };
+    sampleRate?: number;
+    fallback?: STTProviderType;
+}
+export interface UseSTTConfig {
+    provider?: STTProviderType;
+    source?: 'microphone' | 'glass-bridge';
+    language?: string;
+    mode?: STTMode;
+    apiKey?: string;
+    modelId?: string;
+    continuous?: boolean;
+    vad?: boolean;
+    autoStart?: boolean;
+    fallback?: STTProviderType;
+    onTranscript?: (text: string, isFinal: boolean) => void;
+}
+export interface UseSTTReturn {
+    transcript: string;
+    interimTranscript: string;
+    isListening: boolean;
+    isLoading: boolean;
+    loadProgress: number;
+    error: STTError | null;
+    state: STTState;
+    start: () => Promise<void>;
+    stop: () => void;
+    abort: () => void;
+    reset: () => void;
+}
+//# sourceMappingURL=types.d.ts.map