@fraziym/axoniz 0.1.0

package/dist/voice/wake_word.d.ts

@@ -0,0 +1,153 @@
+/**
+ * src/voice/wake_word.ts
+ * =========================
+ * Always-on wake word detector. Runs as a cancellable async loop.
+ * Fires `on_wake(word)` the moment BERU's name is heard.
+ *
+ * Python backends tried in order (fully offline first):
+ *   1. openwakeword  — ONNX model, ~1MB, zero latency
+ *   2. pvporcupine   — Picovoice local engine
+ *   3. sr_polling    — SpeechRecognition short-clip polling
+ *   4. whisper_polling — faster-whisper tiny on 2s clips
+ *
+ * ── Node reality ─────────────────────────────────────────────────────────────
+ * `openwakeword`, `pvporcupine`, `SpeechRecognition`, `faster-whisper`,
+ * `pyaudio` and `sounddevice` are all Python-only. Every backend name and the
+ * whole lifecycle API are preserved; a detector can be registered at runtime
+ * with `registerWakeDetector(name, detector)` and a clip recognizer with
+ * `registerClipRecognizer(recognizer)`.
+ *
+ * TODO(port): wake-word detection is fully degraded until a detector is
+ *   registered. Recommended replacements to investigate:
+ *     - `@huggingface/transformers` + an openWakeWord ONNX export (NOT installed)
+ *     - `onnxruntime-node` running openWakeWord models (NOT installed)
+ *     - Porcupine via a Node binding (none installed)
+ *     - a `whisper.cpp` CLI binary shelled out from node:child_process
+ */
+export declare const WAKE_WORDS: string[];
+/** Provider ids, matching the strings the Python `_backend` attribute held. */
+export type WakeBackendName = "openwakeword" | "pvporcupine" | "sr_polling" | "whisper_polling" | "none";
+/** Actionable error emitted when nothing is registered. */
+export declare const WAKE_UNAVAILABLE_ERROR: string;
+export declare const WAKE_RECOGNIZER_MISSING_ERROR: string;
+/**
+ * A native (streaming) wake word engine, e.g. an openWakeWord ONNX port.
+ * `feed()` is called with 16-bit 16 kHz mono PCM frames; the detector invokes
+ * `wake()` when the phrase fires.
+ */
+export interface WakeDetector {
+    readonly name: string;
+    /** Start consuming audio. Called once from `start()`. */
+    run(wake: (word: string) => void, signal: AbortSignal): Promise<void>;
+    /** Extra keys are permitted; the detector object is logged via `backend`. */
+    [key: string]: unknown;
+}
+/** A short-clip recognizer used by the sr_polling / whisper_polling backends. */
+export interface ClipRecognizer {
+    readonly name: string;
+    /** Transcribe raw 16-bit 16 kHz mono PCM. Returns "" when nothing is heard. */
+    recognizePcm(pcm: Buffer): Promise<string>;
+}
+/** Register (or replace) a native wake-word detector at runtime. */
+export declare function registerWakeDetector(name: string, detector: WakeDetector): void;
+export declare function unregisterWakeDetector(name: string): void;
+export declare function getWakeDetector(name: string): WakeDetector | undefined;
+/** Register the clip recognizer that powers the polling backends. */
+export declare function registerClipRecognizer(recognizer: ClipRecognizer | null): void;
+/** Small promise/flag signal replacing `threading.Event`. */
+declare class Signal {
+    private _set;
+    private _waiters;
+    set(): void;
+    clear(): void;
+    is_set(): boolean;
+    /** Returns true immediately when already set, else races the timeout. */
+    wait(timeoutSeconds: number): Promise<boolean>;
+}
+export declare class WakeWordDetector {
+    /** Always-on wake word listener. Non-blocking — runs as a cancellable loop. */
+    on_wake: (word: string) => void;
+    wake_words: string[];
+    sensitivity: number;
+    protected _stop_ev: Signal;
+    protected _abort: AbortController | null;
+    protected _thread: Promise<void> | null;
+    protected _backend: string;
+    protected _active: boolean;
+    protected _lastError: string;
+    protected _loggedDegraded: string;
+    constructor(on_wake: (word: string) => void, wake_words?: string[] | null, sensitivity?: number);
+    /**
+     * Ports the Python `_detect_backend()`. Each `import` probe becomes "is an
+     * engine registered under that id".
+     *
+     * For multi-word phrases like "beru activate", openWakeWord cannot score them
+     * directly — its pretrained models are single keywords only — so text-based
+     * matching (sr_polling / whisper_polling) is preferred for those.
+     */
+    private _detect_backend;
+    get backend(): string;
+    /** Last `[ERROR] …` string produced by a degraded path. */
+    get lastError(): string;
+    get isAvailable(): boolean;
+    start(): void;
+    stop(): void;
+    is_running(): boolean;
+    isRunning(): boolean;
+    private _run;
+    /**
+     * Fire the wake callback with a cooldown so it does not double-trigger.
+     * The Python version spawned a 2s reset thread; here it is a timer.
+     */
+    protected _fire(word: string): void;
+    /**
+     * TODO(port): `openwakeword` (ONNX, ~1MB) and `pvporcupine` are Python-only.
+     * A registered detector supplies the same behaviour — the model download,
+     * 1280-frame streaming loop and score-threshold logic all live behind the
+     * `WakeDetector.run()` seam. Recommended replacement: an ONNX runtime
+     * (`onnxruntime-node`, NOT installed) running openWakeWord models.
+     */
+    private _runRegistered;
+    /**
+     * Record short clips and check the transcription for wake words.
+     *
+     * TODO(port): Python used `speech_recognition` with pocketsphinx (offline) or
+     * Google STT. Neither is available for Node; a registered `ClipRecognizer`
+     * takes its place (see `registerClipRecognizer`).
+     */
+    private _run_sr_polling;
+    /**
+     * Last-resort fallback: record ~2s clips and transcribe locally.
+     *
+     * TODO(port): Python used `faster_whisper.WhisperModel("tiny")` plus
+     * pyaudio/sounddevice. There is no Node STT engine installed — the registered
+     * `ClipRecognizer` (or an `registerSTTBackend` engine bridged in) fills in.
+     * Recommended replacement: `whisper.cpp` CLI or whisper ONNX via
+     * `@huggingface/transformers` (NOT installed).
+     */
+    private _run_whisper_polling;
+    /**
+     * Record one short clip through the registered audio input driver.
+     * Returns null (with a descriptive `[ERROR]`) when no driver is registered.
+     */
+    protected _recordClip(signal: AbortSignal, seconds: number): Promise<Buffer | null>;
+    /**
+     * Persist a captured clip as a hand-rolled 44-byte-header WAV.
+     * Replaces Python's `wave` module usage in `_run_whisper_polling`.
+     */
+    protected saveClipWav(pcm: Buffer, filePath?: string): string;
+    protected unlinkClip(filePath: string): void;
+    protected _degraded(msg: string): void;
+}
+export declare function get_wake_detector(on_wake: (word: string) => void, kwargs?: {
+    wake_words?: string[];
+    sensitivity?: number;
+}): WakeWordDetector;
+/** camelCase alias of `get_wake_detector` (avoids colliding with the registry getter). */
+export declare const getWakeDetectorInstance: typeof get_wake_detector;
+/** Test/DI hook — replace the singleton. */
+export declare function setWakeDetector(detector: WakeWordDetector | null): void;
+/** Cancellable sleep — the async replacement for `time.sleep`. */
+export declare function sleep(seconds: number, signal?: AbortSignal): Promise<void>;
+export {};
+//# sourceMappingURL=wake_word.d.ts.map

package/dist/voice/wake_word.d.ts.map

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

package/dist/voice/wake_word.js

@@ -0,0 +1,458 @@
+/**
+ * src/voice/wake_word.ts
+ * =========================
+ * Always-on wake word detector. Runs as a cancellable async loop.
+ * Fires `on_wake(word)` the moment BERU's name is heard.
+ *
+ * Python backends tried in order (fully offline first):
+ *   1. openwakeword  — ONNX model, ~1MB, zero latency
+ *   2. pvporcupine   — Picovoice local engine
+ *   3. sr_polling    — SpeechRecognition short-clip polling
+ *   4. whisper_polling — faster-whisper tiny on 2s clips
+ *
+ * ── Node reality ─────────────────────────────────────────────────────────────
+ * `openwakeword`, `pvporcupine`, `SpeechRecognition`, `faster-whisper`,
+ * `pyaudio` and `sounddevice` are all Python-only. Every backend name and the
+ * whole lifecycle API are preserved; a detector can be registered at runtime
+ * with `registerWakeDetector(name, detector)` and a clip recognizer with
+ * `registerClipRecognizer(recognizer)`.
+ *
+ * TODO(port): wake-word detection is fully degraded until a detector is
+ *   registered. Recommended replacements to investigate:
+ *     - `@huggingface/transformers` + an openWakeWord ONNX export (NOT installed)
+ *     - `onnxruntime-node` running openWakeWord models (NOT installed)
+ *     - Porcupine via a Node binding (none installed)
+ *     - a `whisper.cpp` CLI binary shelled out from node:child_process
+ */
+import { getLogger } from "../core/logger.js";
+import { AUDIO_INPUT_MISSING_ERROR, getAudioInputDriver, pcm16MeanAbs as meanAbs, writeWav, } from "./wav.js";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+const logger = getLogger();
+export const WAKE_WORDS = ["beru activate", "beru", "shadow monarch", "marshal", "my liege"];
+/** Actionable error emitted when nothing is registered. */
+export const WAKE_UNAVAILABLE_ERROR = "[ERROR] wake word detection unavailable — no detector registered. The Python " +
+    "stack used openwakeword / pvporcupine / SpeechRecognition / faster-whisper, " +
+    "none of which have installable Node equivalents here. Call " +
+    "registerWakeDetector('my-detector', impl) or registerClipRecognizer(impl) " +
+    "(see src/voice/wake_word.ts).";
+export const WAKE_RECOGNIZER_MISSING_ERROR = "[ERROR] wake word polling unavailable — no clip recognizer registered and no " +
+    "STT engine installed (whisper/faster-whisper are Python-only). Call " +
+    "registerClipRecognizer({ name, recognizePcm }) to enable sr_polling / " +
+    "whisper_polling.";
+const _detectors = new Map();
+let _clipRecognizer = null;
+/** Register (or replace) a native wake-word detector at runtime. */
+export function registerWakeDetector(name, detector) {
+    _detectors.set(name, detector);
+}
+export function unregisterWakeDetector(name) {
+    _detectors.delete(name);
+}
+export function getWakeDetector(name) {
+    return _detectors.get(name);
+}
+/** Register the clip recognizer that powers the polling backends. */
+export function registerClipRecognizer(recognizer) {
+    _clipRecognizer = recognizer;
+}
+/** The engine currently registered under a polling backend id, if any. */
+function pollRecognizerFor(backend) {
+    const detector = _detectors.get(backend);
+    if (detector && typeof detector["recognizePcm"] === "function") {
+        return detector;
+    }
+    return _clipRecognizer;
+}
+/** First registered streaming detector, regardless of the name it was filed under. */
+function firstRegisteredDetector() {
+    for (const detector of _detectors.values()) {
+        if (typeof detector.run === "function")
+            return detector;
+    }
+    return null;
+}
+/* ────────────────────────────────────────────────────────────────────────────
+ * WakeWordDetector
+ * ──────────────────────────────────────────────────────────────────────────── */
+/** Small promise/flag signal replacing `threading.Event`. */
+class Signal {
+    _set = false;
+    _waiters = [];
+    set() {
+        this._set = true;
+        const waiters = this._waiters;
+        this._waiters = [];
+        for (const w of waiters)
+            w();
+    }
+    clear() {
+        this._set = false;
+    }
+    is_set() {
+        return this._set;
+    }
+    /** Returns true immediately when already set, else races the timeout. */
+    async wait(timeoutSeconds) {
+        if (this._set)
+            return true;
+        return await new Promise((resolve) => {
+            let settled = false;
+            const done = (v) => {
+                if (settled)
+                    return;
+                settled = true;
+                resolve(v);
+            };
+            const timer = setTimeout(() => done(false), Math.max(0, timeoutSeconds * 1000));
+            this._waiters.push(() => {
+                clearTimeout(timer);
+                done(true);
+            });
+        });
+    }
+}
+export class WakeWordDetector {
+    /** Always-on wake word listener. Non-blocking — runs as a cancellable loop. */
+    on_wake;
+    wake_words;
+    sensitivity;
+    _stop_ev = new Signal();
+    _abort = null;
+    _thread = null;
+    _backend;
+    _active = false; // True while in cooldown after wake
+    _lastError = "";
+    _loggedDegraded = "";
+    constructor(on_wake, wake_words = null, sensitivity = 0.5) {
+        this.on_wake = on_wake;
+        this.wake_words = (wake_words ?? WAKE_WORDS).map((w) => w.toLowerCase());
+        this.sensitivity = sensitivity;
+        this._backend = this._detect_backend();
+    }
+    /* ── backend detection ──────────────────────────────────────────────────── */
+    /**
+     * Ports the Python `_detect_backend()`. Each `import` probe becomes "is an
+     * engine registered under that id".
+     *
+     * For multi-word phrases like "beru activate", openWakeWord cannot score them
+     * directly — its pretrained models are single keywords only — so text-based
+     * matching (sr_polling / whisper_polling) is preferred for those.
+     */
+    _detect_backend() {
+        const primary = this.wake_words[0] ?? "";
+        const needsTextMatch = primary.includes(" ");
+        const candidates = [
+            ["openwakeword", "openwakeword"],
+            ["pvporcupine", "pvporcupine"],
+            ["speech_recognition", "sr_polling"],
+        ];
+        for (const [id, name] of candidates) {
+            if (!_detectors.has(id) && !(name === "sr_polling" && _clipRecognizer))
+                continue;
+            if (name === "openwakeword" && needsTextMatch)
+                continue; // can't match multi-word
+            return name;
+        }
+        // whisper/faster-whisper is already a dependency of light_daemon — final fallback.
+        if (_detectors.has("faster_whisper") || _detectors.has("whisper") || _clipRecognizer) {
+            return "whisper_polling";
+        }
+        // Any other registered streaming detector (e.g. a custom ONNX engine).
+        if (firstRegisteredDetector())
+            return "openwakeword";
+        return "none";
+    }
+    get backend() {
+        return this._backend;
+    }
+    /** Last `[ERROR] …` string produced by a degraded path. */
+    get lastError() {
+        return this._lastError;
+    }
+    get isAvailable() {
+        return this._backend !== "none";
+    }
+    /* ── lifecycle ──────────────────────────────────────────────────────────── */
+    start() {
+        if (this._thread)
+            return; // already running
+        this._stop_ev.clear();
+        this._abort = new AbortController();
+        const signal = this._abort.signal;
+        this._thread = this._run(signal)
+            .catch((e) => {
+            logger.error(`[WakeWord] run failed: ${errText(e)}`);
+        })
+            .finally(() => {
+            this._thread = null;
+        });
+        logger.info(`[WakeWord] started | backend=${this._backend} | words=${JSON.stringify(this.wake_words)}`);
+    }
+    stop() {
+        this._stop_ev.set();
+        this._abort?.abort();
+        this._abort = null;
+        logger.info("[WakeWord] stopped");
+    }
+    is_running() {
+        return this._thread !== null;
+    }
+    isRunning() {
+        return this.is_running();
+    }
+    /* ── dispatch ───────────────────────────────────────────────────────────── */
+    async _run(signal) {
+        switch (this._backend) {
+            case "openwakeword":
+            case "pvporcupine":
+                return this._runRegistered(signal);
+            case "sr_polling":
+                return this._run_sr_polling(signal);
+            case "whisper_polling":
+                return this._run_whisper_polling(signal);
+            default:
+                this._degraded(WAKE_UNAVAILABLE_ERROR);
+                logger.warning("[WakeWord] no audio backend found — wake word disabled");
+                logger.warning("[WakeWord] install: a Node detector or register one with registerWakeDetector()");
+        }
+    }
+    /**
+     * Fire the wake callback with a cooldown so it does not double-trigger.
+     * The Python version spawned a 2s reset thread; here it is a timer.
+     */
+    _fire(word) {
+        if (this._active)
+            return;
+        this._active = true;
+        logger.info(`[WakeWord] *** WAKE *** '${word}'`);
+        try {
+            this.on_wake(word);
+        }
+        catch (e) {
+            logger.error(`[WakeWord] on_wake error: ${errText(e)}`);
+        }
+        // Cooldown — reset `_active` after 2 seconds so the caller returns immediately.
+        const timer = setTimeout(() => {
+            this._active = false;
+        }, 2000);
+        if (typeof timer.unref === "function")
+            timer.unref();
+    }
+    /* ── registered streaming backend (openwakeword / porcupine slots) ──────── */
+    /**
+     * TODO(port): `openwakeword` (ONNX, ~1MB) and `pvporcupine` are Python-only.
+     * A registered detector supplies the same behaviour — the model download,
+     * 1280-frame streaming loop and score-threshold logic all live behind the
+     * `WakeDetector.run()` seam. Recommended replacement: an ONNX runtime
+     * (`onnxruntime-node`, NOT installed) running openWakeWord models.
+     */
+    async _runRegistered(signal) {
+        const detector = _detectors.get(this._backend) ??
+            _detectors.get("openwakeword") ??
+            _detectors.get("pvporcupine") ??
+            firstRegisteredDetector();
+        if (!detector) {
+            this._degraded(WAKE_UNAVAILABLE_ERROR);
+            return;
+        }
+        try {
+            // A registered detector owns the score threshold (it supplies `sensitivity`
+            // to its own model); we only gate on an explicit wake-word match.
+            await detector.run((word) => {
+                const lower = word.toLowerCase();
+                if (this.wake_words.length === 0 || this.wake_words.some((w) => lower.includes(w))) {
+                    this._fire(lower);
+                }
+            }, signal);
+        }
+        catch (e) {
+            logger.error(`[WakeWord] ${detector.name} crashed: ${errText(e)}`);
+            this._degraded(`[ERROR] wake detector '${detector.name}' crashed: ${errText(e)}`);
+            // Port the Python fallback: switch to whisper_polling.
+            this._backend = "whisper_polling";
+            await this._run_whisper_polling(signal);
+        }
+    }
+    /* ── SpeechRecognition polling fallback ─────────────────────────────────── */
+    /**
+     * Record short clips and check the transcription for wake words.
+     *
+     * TODO(port): Python used `speech_recognition` with pocketsphinx (offline) or
+     * Google STT. Neither is available for Node; a registered `ClipRecognizer`
+     * takes its place (see `registerClipRecognizer`).
+     */
+    async _run_sr_polling(signal) {
+        const recognizer = pollRecognizerFor("sr_polling");
+        if (!recognizer) {
+            this._degraded(WAKE_RECOGNIZER_MISSING_ERROR);
+            logger.warning("[WakeWord] no clip recognizer registered — falling back to whisper_polling");
+            this._backend = "whisper_polling";
+            await this._run_whisper_polling(signal);
+            return;
+        }
+        // Refuse to spin: without an audio driver there is nothing to poll.
+        if (!getAudioInputDriver()) {
+            this._degraded(AUDIO_INPUT_MISSING_ERROR);
+            return;
+        }
+        logger.info("[WakeWord] sr_polling — listening (short clips)");
+        while (!this._stop_ev.is_set() && !signal.aborted) {
+            try {
+                const pcm = await this._recordClip(signal, 3);
+                if (!pcm) {
+                    await sleep(0.5, signal); // no audio driver / empty clip — do not busy-loop
+                    continue;
+                }
+                const text = (await recognizer.recognizePcm(pcm)).toLowerCase();
+                if (!text)
+                    continue;
+                for (const w of this.wake_words) {
+                    if (text.includes(w)) {
+                        this._fire(w);
+                        break;
+                    }
+                }
+            }
+            catch (e) {
+                logger.debug(`[WakeWord] clip error: ${errText(e)}`);
+                await sleep(0.3, signal);
+            }
+        }
+    }
+    /* ── Whisper polling fallback ───────────────────────────────────────────── */
+    /**
+     * Last-resort fallback: record ~2s clips and transcribe locally.
+     *
+     * TODO(port): Python used `faster_whisper.WhisperModel("tiny")` plus
+     * pyaudio/sounddevice. There is no Node STT engine installed — the registered
+     * `ClipRecognizer` (or an `registerSTTBackend` engine bridged in) fills in.
+     * Recommended replacement: `whisper.cpp` CLI or whisper ONNX via
+     * `@huggingface/transformers` (NOT installed).
+     */
+    async _run_whisper_polling(signal) {
+        const recognizer = pollRecognizerFor("whisper_polling");
+        if (!recognizer) {
+            this._degraded(WAKE_RECOGNIZER_MISSING_ERROR);
+            logger.error("[WakeWord] whisper_polling needs a registered recognizer " +
+                "(whisper/faster-whisper are Python-only)");
+            return;
+        }
+        // Refuse to spin: without an audio driver there is nothing to poll.
+        if (!getAudioInputDriver()) {
+            this._degraded(AUDIO_INPUT_MISSING_ERROR);
+            return;
+        }
+        logger.info("[WakeWord] whisper_polling — listening (2s clips)");
+        while (!this._stop_ev.is_set() && !signal.aborted) {
+            try {
+                const pcm = await this._recordClip(signal, 2);
+                // Quick energy check — skip silence (ported SILENCE/energy guard).
+                if (!pcm || meanAbs(pcm) < 150) {
+                    await sleep(0.5, signal); // nothing captured — do not busy-loop
+                    continue;
+                }
+                const text = (await recognizer.recognizePcm(pcm)).toLowerCase().trim();
+                if (text) {
+                    logger.debug(`[WakeWord] whisper clip: '${text}'`);
+                    for (const w of this.wake_words) {
+                        if (text.includes(w)) {
+                            this._fire(w);
+                            break;
+                        }
+                    }
+                }
+            }
+            catch (e) {
+                logger.debug(`[WakeWord] whisper clip error: ${errText(e)}`);
+                await sleep(0.5, signal);
+            }
+        }
+    }
+    /* ── mic helpers ────────────────────────────────────────────────────────── */
+    /**
+     * Record one short clip through the registered audio input driver.
+     * Returns null (with a descriptive `[ERROR]`) when no driver is registered.
+     */
+    async _recordClip(signal, seconds) {
+        const driver = getAudioInputDriver();
+        if (!driver) {
+            this._degraded(AUDIO_INPUT_MISSING_ERROR);
+            return null;
+        }
+        try {
+            const pcm = await driver.record({
+                maxSeconds: seconds,
+                sampleRate: 16_000,
+                silenceSeconds: seconds,
+                signal,
+            });
+            return pcm && pcm.length > 0 ? pcm : null;
+        }
+        catch (e) {
+            logger.debug(`[WakeWord] record failed: ${errText(e)}`);
+            return null;
+        }
+    }
+    /**
+     * Persist a captured clip as a hand-rolled 44-byte-header WAV.
+     * Replaces Python's `wave` module usage in `_run_whisper_polling`.
+     */
+    saveClipWav(pcm, filePath) {
+        const target = filePath ??
+            path.join(os.tmpdir(), `beru-wake-${Date.now()}-${Math.floor(Math.random() * 1e6)}.wav`);
+        writeWav(target, pcm, 16_000, 1);
+        return target;
+    }
+    unlinkClip(filePath) {
+        try {
+            fs.unlinkSync(filePath);
+        }
+        catch {
+            /* best effort */
+        }
+    }
+    _degraded(msg) {
+        this._lastError = msg;
+        // Deduplicate: the polling loops hit these paths every cycle.
+        if (this._loggedDegraded === msg)
+            return;
+        this._loggedDegraded = msg;
+        logger.warning(msg);
+    }
+}
+/* ── singleton ─────────────────────────────────────────────────────────────── */
+let _wwd = null;
+export function get_wake_detector(on_wake, kwargs = {}) {
+    if (_wwd === null) {
+        _wwd = new WakeWordDetector(on_wake, kwargs.wake_words ?? null, kwargs.sensitivity ?? 0.5);
+    }
+    return _wwd;
+}
+/** camelCase alias of `get_wake_detector` (avoids colliding with the registry getter). */
+export const getWakeDetectorInstance = get_wake_detector;
+/** Test/DI hook — replace the singleton. */
+export function setWakeDetector(detector) {
+    _wwd = detector;
+}
+/* ── helpers ───────────────────────────────────────────────────────────────── */
+/** Cancellable sleep — the async replacement for `time.sleep`. */
+export async function sleep(seconds, signal) {
+    if (signal?.aborted)
+        return;
+    await new Promise((resolve) => {
+        const timer = setTimeout(resolve, Math.max(0, seconds * 1000));
+        if (signal) {
+            const onAbort = () => {
+                clearTimeout(timer);
+                resolve();
+            };
+            signal.addEventListener("abort", onAbort, { once: true });
+        }
+    });
+}
+function errText(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+//# sourceMappingURL=wake_word.js.map

package/dist/voice/wake_word.js.map

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