@iobroker/assistant-satellite 0.0.1

package/build/satellite.js

@@ -0,0 +1,384 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Satellite = void 0;
+/**
+ * Satellite orchestration: resolve the adapter address → register → listen for the wake word →
+ * stream the utterance → play the spoken reply. Protocol-compatible with the Hannah satellite.
+ */
+const dgram = __importStar(require("node:dgram"));
+const protocol_1 = require("./protocol");
+const audio_1 = require("./audio");
+const vad_1 = require("./vad");
+const wakeword_1 = require("./wakeword");
+const models_1 = require("./models");
+const mqtt_1 = require("./mqtt");
+/** 1280 samples (80 ms) of 16 kHz mono 16-bit PCM per processing frame. */
+const FRAME_BYTES = 1280 * 2;
+const FRAME_MS = 80;
+/** Missed heartbeat ACKs before the satellite assumes the adapter is gone and re-registers. */
+const MAX_HEARTBEAT_MISSES = 3;
+const RECONNECT_MAX_BACKOFF_MS = 30_000;
+const sleep = (ms) => new Promise(res => setTimeout(res, ms));
+class Satellite {
+    cfg;
+    host;
+    log;
+    socket = null;
+    serverHost = '';
+    serverPort = 0;
+    wakeword;
+    mic = null;
+    backend;
+    plingPcm = Buffer.alloc(0);
+    heartbeatTimer = null;
+    // mic frame assembly
+    micRemainder = Buffer.alloc(0);
+    pumping = false;
+    micBytesLogged = false;
+    // wake-word diagnostics (periodic summary)
+    wakeFrames = 0;
+    wakeMaxScore = 0;
+    wakeMaxRms = 0;
+    // recording state
+    recording = false;
+    silence = null;
+    preBuffer = [];
+    recFrames = 0;
+    recPeakRms = 0;
+    // tts receiver
+    ttsChunks = [];
+    ttsDiscard = false;
+    registerResolve = null;
+    running = false;
+    heartbeatMisses = 0;
+    awaitingHeartbeatAck = false;
+    reconnecting = false;
+    constructor(cfg, host) {
+        this.cfg = cfg;
+        this.host = host;
+        this.log = host.log;
+        this.backend = (0, audio_1.resolveBackend)(cfg.audioBackend);
+    }
+    async start() {
+        this.running = true;
+        const addr = await this.resolveAddress();
+        this.serverHost = addr.host;
+        this.serverPort = addr.port;
+        this.log.info(`Adapter address: ${this.serverHost}:${this.serverPort}`);
+        await this.openSocket();
+        const models = await (0, models_1.ensureModels)(this.cfg.modelsDir, this.cfg.wakewordModel, this.log);
+        this.wakeword = new wakeword_1.WakeWord(models, this.cfg.wakewordThreshold, this.log);
+        await this.wakeword.load();
+        this.plingPcm = (0, audio_1.pling)();
+        // Retry until the adapter answers, so the satellite survives the adapter being down at boot.
+        await this.registerWithRetry();
+        this.heartbeatTimer = setInterval(() => this.heartbeatTick(), this.cfg.heartbeatIntervalMs);
+        this.mic = new audio_1.Mic(this.backend, this.cfg.micDevice, this.log);
+        this.mic.start(d => this.onMicData(d));
+        this.setStatus('idle');
+        this.log.info(`Satellite '${this.cfg.device}' ready. Listening for the wake word …`);
+    }
+    async stop() {
+        this.running = false;
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+        this.mic?.stop();
+        this.mic = null;
+        const socket = this.socket;
+        this.socket = null;
+        if (socket) {
+            await new Promise(res => socket.close(() => res()));
+        }
+    }
+    // ── setup ──────────────────────────────────────────────────────────────
+    async resolveAddress() {
+        if (this.cfg.host) {
+            return { host: this.cfg.host, port: this.cfg.port };
+        }
+        if (this.cfg.mqttBroker) {
+            return (0, mqtt_1.discoverServer)(this.cfg, this.log);
+        }
+        throw new Error('No adapter address: set "host" (fixed) or "mqttBroker" (discovery) in the config.');
+    }
+    openSocket() {
+        return new Promise((resolve, reject) => {
+            const socket = dgram.createSocket('udp4');
+            this.socket = socket;
+            socket.on('message', d => this.onMessage(d));
+            socket.on('error', e => this.log.error(`UDP error: ${e.message}`));
+            socket.once('error', reject);
+            socket.bind(this.cfg.listenPort, () => {
+                this.log.info(`Listening for TTS on UDP ${this.cfg.listenPort}.`);
+                resolve();
+            });
+        });
+    }
+    /** Register, retrying with exponential backoff until the adapter acknowledges (or we stop). */
+    async registerWithRetry() {
+        let backoff = 1000;
+        while (this.running) {
+            try {
+                await this.register();
+                this.awaitingHeartbeatAck = false;
+                this.heartbeatMisses = 0;
+                return;
+            }
+            catch (e) {
+                this.log.warn(`${e.message} — retrying in ${Math.round(backoff / 1000)} s …`);
+                await sleep(backoff);
+                backoff = Math.min(backoff * 2, RECONNECT_MAX_BACKOFF_MS);
+            }
+        }
+    }
+    /** Triggered when heartbeats stop being acknowledged: re-register (adapter probably restarted). */
+    async reconnect() {
+        if (this.reconnecting || !this.running) {
+            return;
+        }
+        this.reconnecting = true;
+        this.heartbeatMisses = 0;
+        this.awaitingHeartbeatAck = false;
+        this.log.warn('Adapter unreachable — re-registering …');
+        try {
+            await this.registerWithRetry();
+            this.log.info('Re-registered with the adapter.');
+        }
+        finally {
+            this.reconnecting = false;
+        }
+    }
+    heartbeatTick() {
+        if (this.reconnecting) {
+            return;
+        }
+        if (this.awaitingHeartbeatAck) {
+            this.heartbeatMisses++;
+            this.log.warn(`Heartbeat not acknowledged (${this.heartbeatMisses}/${MAX_HEARTBEAT_MISSES}).`);
+            if (this.heartbeatMisses >= MAX_HEARTBEAT_MISSES) {
+                void this.reconnect();
+                return;
+            }
+        }
+        this.awaitingHeartbeatAck = true;
+        this.sendControl({ type: 'heartbeat', device: this.cfg.device });
+    }
+    register() {
+        return new Promise((resolve, reject) => {
+            this.registerResolve = resolve;
+            this.sendControl({
+                type: 'register',
+                device: this.cfg.device,
+                room: this.cfg.room,
+                listen_port: this.cfg.listenPort,
+            });
+            this.log.info(`Registration sent to ${this.serverHost}:${this.serverPort} (device '${this.cfg.device}').`);
+            setTimeout(() => {
+                if (this.registerResolve) {
+                    this.registerResolve = null;
+                    reject(new Error(`registration timed out after ${this.cfg.registrationTimeoutMs} ms`));
+                }
+            }, this.cfg.registrationTimeoutMs);
+        });
+    }
+    // ── microphone → wake word → recording ─────────────────────────────────
+    onMicData(chunk) {
+        if (!this.micBytesLogged) {
+            this.micBytesLogged = true;
+            this.log.info(`Microphone is producing audio (first chunk ${chunk.length} bytes).`);
+        }
+        this.micRemainder = Buffer.concat([this.micRemainder, chunk]);
+        if (!this.pumping) {
+            void this.pump();
+        }
+    }
+    async pump() {
+        this.pumping = true;
+        try {
+            while (this.micRemainder.length >= FRAME_BYTES) {
+                const frame = Buffer.from(this.micRemainder.subarray(0, FRAME_BYTES));
+                this.micRemainder = this.micRemainder.subarray(FRAME_BYTES);
+                await this.handleFrame(frame);
+            }
+        }
+        catch (e) {
+            this.log.error(`frame processing error: ${e.message}`);
+        }
+        finally {
+            this.pumping = false;
+        }
+    }
+    async handleFrame(frame) {
+        if (this.recording) {
+            this.sendAudio(frame);
+            this.recFrames++;
+            const level = (0, vad_1.rms)(frame);
+            if (level > this.recPeakRms) {
+                this.recPeakRms = level;
+            }
+            if (this.silence.push(frame)) {
+                this.endRecording();
+            }
+            return;
+        }
+        // Wake-word listening: keep a rolling pre-buffer so speech during inference is not lost.
+        this.preBuffer.push(frame);
+        if (this.preBuffer.length > this.cfg.preBufferChunks) {
+            this.preBuffer.shift();
+        }
+        const score = await this.wakeword.process(frame);
+        // Periodic diagnostics: every ~2 s report how many frames ran and the peak score, so you can
+        // watch the score rise while saying the wake word and tune `wakewordThreshold`.
+        this.wakeFrames++;
+        if (score !== null && score > this.wakeMaxScore) {
+            this.wakeMaxScore = score;
+        }
+        const level = (0, vad_1.rms)(frame);
+        if (level > this.wakeMaxRms) {
+            this.wakeMaxRms = level;
+        }
+        if (this.wakeFrames >= 25) {
+            this.log.debug(`wake: ${this.wakeFrames} frames, peak mic RMS ${this.wakeMaxRms.toFixed(0)}, ` +
+                `peak score ${this.wakeMaxScore.toFixed(3)} (threshold ${this.cfg.wakewordThreshold})`);
+            this.wakeFrames = 0;
+            this.wakeMaxScore = 0;
+            this.wakeMaxRms = 0;
+        }
+        if (this.wakeword.triggered(score)) {
+            this.log.info(`Wake word detected (score ${score.toFixed(3)}).`);
+            this.wakeword.reset();
+            await this.startRecording();
+        }
+    }
+    async startRecording() {
+        this.setStatus('listening');
+        this.ttsDiscard = true; // drop any late TTS from a previous turn
+        await (0, audio_1.playPcm)(this.plingPcm, protocol_1.AUDIO_SAMPLE_RATE, this.backend, this.cfg.speakerDevice, this.log);
+        this.ttsDiscard = false;
+        this.ttsChunks = [];
+        // Drop everything captured up to now (the beep echo + any inference backlog) so recording runs
+        // in real time — otherwise the silence detector races through buffered quiet frames and ends the
+        // utterance before you finish speaking (→ the adapter's STT gets silence → "(empty)").
+        this.micRemainder = Buffer.alloc(0);
+        this.preBuffer = [];
+        this.recFrames = 0;
+        this.recPeakRms = 0;
+        this.silence = new vad_1.SilenceDetector(this.cfg.silenceThreshold, Math.round(this.cfg.silenceMs / FRAME_MS), Math.round(this.cfg.minRecordMs / FRAME_MS), Math.round(this.cfg.maxRecordMs / FRAME_MS));
+        this.recording = true;
+        this.log.info('Beep done — listening for your command …');
+    }
+    endRecording() {
+        this.recording = false;
+        this.silence = null;
+        this.sendControl({ type: 'audio_end', device: this.cfg.device });
+        const maxFrames = Math.round(this.cfg.maxRecordMs / FRAME_MS);
+        const reason = this.recFrames >= maxFrames ? 'max length' : 'silence';
+        this.log.info(`Recording finished: ${this.recFrames} frames (${this.recFrames * FRAME_MS} ms), ` +
+            `peak RMS ${this.recPeakRms.toFixed(0)}, ended on ${reason} — audio_end sent.`);
+    }
+    // ── incoming UDP (control + TTS) ───────────────────────────────────────
+    onMessage(data) {
+        if (!data.length) {
+            return;
+        }
+        const { type, payload } = (0, protocol_1.decodePacket)(data);
+        if (type === protocol_1.TYPE_AUDIO) {
+            return; // satellites do not receive audio
+        }
+        if (type === protocol_1.TYPE_TTS) {
+            if (!this.ttsDiscard) {
+                this.ttsChunks.push(Buffer.from(payload));
+            }
+            return;
+        }
+        if (type !== protocol_1.TYPE_CONTROL) {
+            return;
+        }
+        let msg;
+        try {
+            msg = JSON.parse(payload.toString('utf8'));
+        }
+        catch {
+            return;
+        }
+        switch (msg.type) {
+            case 'registered':
+                if (msg.ok && this.registerResolve) {
+                    this.log.info('Registration confirmed (ACK).');
+                    this.registerResolve();
+                    this.registerResolve = null;
+                }
+                break;
+            case 'reregister':
+                this.register().catch(e => this.log.warn(`re-register failed: ${e.message}`));
+                break;
+            case 'status':
+                if (msg.state) {
+                    this.setStatus(msg.state);
+                }
+                break;
+            case 'tts_end':
+                void this.playTts(msg.sample_rate || protocol_1.AUDIO_SAMPLE_RATE);
+                break;
+            case 'heartbeat_ack':
+                this.awaitingHeartbeatAck = false;
+                this.heartbeatMisses = 0;
+                break;
+        }
+    }
+    async playTts(sampleRate) {
+        const pcm = Buffer.concat(this.ttsChunks);
+        this.ttsChunks = [];
+        if (!pcm.length) {
+            return;
+        }
+        this.log.info(`Playing reply (${(pcm.length / 2 / sampleRate).toFixed(1)} s @ ${sampleRate} Hz).`);
+        await (0, audio_1.playPcm)(pcm, sampleRate, this.backend, this.cfg.speakerDevice, this.log);
+    }
+    // ── senders / status ───────────────────────────────────────────────────
+    sendAudio(pcm) {
+        this.socket?.send((0, protocol_1.encodeAudio)(pcm), this.serverPort, this.serverHost);
+    }
+    sendControl(msg) {
+        this.socket?.send((0, protocol_1.encodeControl)(msg), this.serverPort, this.serverHost);
+    }
+    setStatus(state) {
+        this.host.onStatus?.(state);
+    }
+}
+exports.Satellite = Satellite;
+//# sourceMappingURL=satellite.js.map

package/build/satellite.js.map

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

package/build/service.d.ts

@@ -0,0 +1,3 @@
+import type { Logger } from './index';
+export declare function installService(configPath: string, log: Logger, force?: boolean): void;
+export declare function uninstallService(log: Logger): void;

package/build/service.js

@@ -0,0 +1,140 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installService = installService;
+exports.uninstallService = uninstallService;
+/**
+ * Self-install as a systemd service: `assistant-satellite install [config.json]`.
+ * Generates /etc/systemd/system/assistant-satellite.service pointing at this node binary + cli.js +
+ * the given config, then daemon-reload + enable --now. Needs root (re-run with sudo).
+ */
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const config_1 = require("./config");
+const audio_1 = require("./audio");
+const checks_1 = require("./checks");
+const SERVICE_NAME = 'assistant-satellite';
+const SERVICE_PATH = `/etc/systemd/system/${SERVICE_NAME}.service`;
+function run(cmd, args, log) {
+    log.debug(`$ ${cmd} ${args.join(' ')}`);
+    (0, node_child_process_1.execFileSync)(cmd, args, { stdio: 'inherit' });
+}
+function requireLinux() {
+    if (process.platform !== 'linux') {
+        throw new Error('Service install/uninstall is only supported on Linux (systemd).');
+    }
+}
+function installService(configPath, log, force = false) {
+    requireLinux();
+    const absConfig = path.resolve(configPath);
+    if (!fs.existsSync(absConfig)) {
+        throw new Error(`config not found: ${absConfig} — run once to create/edit it, then install.`);
+    }
+    // Preflight: verify rights, audio in/out, tools, config before writing the unit.
+    let cfg;
+    try {
+        cfg = (0, config_1.loadConfig)(JSON.parse(fs.readFileSync(absConfig, 'utf8')));
+    }
+    catch (e) {
+        throw new Error(`cannot read ${absConfig}: ${e.message}`);
+    }
+    log.info('Preflight checks:');
+    const passed = (0, checks_1.printChecks)((0, checks_1.runChecks)(cfg, (0, audio_1.resolveBackend)(cfg.audioBackend), true), log);
+    if (!passed && !force) {
+        throw new Error('preflight checks failed — fix the above, or re-run with --force to install anyway.');
+    }
+    const nodeBin = process.execPath;
+    const cliPath = path.join(__dirname, 'cli.js');
+    const workingDir = path.dirname(absConfig);
+    // Run the service as the invoking user (sudo → the real user), not root, so audio access is normal.
+    const user = process.env.SUDO_USER || os.userInfo().username;
+    const unit = `[Unit]\n` +
+        `Description=ioBroker assistant satellite\n` +
+        `After=network-online.target sound.target\n` +
+        `Wants=network-online.target\n\n` +
+        `[Service]\n` +
+        `Type=simple\n` +
+        `WorkingDirectory=${workingDir}\n` +
+        `ExecStart=${nodeBin} ${cliPath} ${absConfig}\n` +
+        `Restart=always\n` +
+        `RestartSec=5\n` +
+        `User=${user}\n` +
+        `SupplementaryGroups=audio\n\n` +
+        `[Install]\n` +
+        `WantedBy=multi-user.target\n`;
+    try {
+        fs.writeFileSync(SERVICE_PATH, unit);
+    }
+    catch (e) {
+        if (e.code === 'EACCES') {
+            throw new Error(`cannot write ${SERVICE_PATH} — re-run with sudo.`);
+        }
+        throw e;
+    }
+    log.info(`Wrote ${SERVICE_PATH} (runs as User=${user}).`);
+    run('systemctl', ['daemon-reload'], log);
+    run('systemctl', ['enable', '--now', SERVICE_NAME], log);
+    log.info(`Service '${SERVICE_NAME}' installed and started.`);
+    log.info(`  logs:    journalctl -u ${SERVICE_NAME} -f`);
+    log.info(`  restart: sudo systemctl restart ${SERVICE_NAME}`);
+    log.info(`  remove:  sudo ${nodeBin} ${cliPath} uninstall`);
+}
+function uninstallService(log) {
+    requireLinux();
+    try {
+        run('systemctl', ['disable', '--now', SERVICE_NAME], log);
+    }
+    catch {
+        /* not enabled/running — ignore */
+    }
+    try {
+        fs.unlinkSync(SERVICE_PATH);
+        log.info(`Removed ${SERVICE_PATH}.`);
+    }
+    catch (e) {
+        const code = e.code;
+        if (code === 'EACCES') {
+            throw new Error(`cannot remove ${SERVICE_PATH} — re-run with sudo.`);
+        }
+        if (code !== 'ENOENT') {
+            throw e;
+        }
+    }
+    run('systemctl', ['daemon-reload'], log);
+    log.info(`Service '${SERVICE_NAME}' removed.`);
+}
+//# sourceMappingURL=service.js.map

package/build/service.js.map

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

package/build/vad.d.ts

@@ -0,0 +1,19 @@
+/** Simple RMS-energy voice-activity detection (ported from the Hannah satellite). */
+/** RMS energy (0..32768) of a 16-bit signed LE PCM frame. */
+export declare function rms(pcm: Buffer): number;
+/**
+ * Tracks trailing silence across frames to decide when an utterance ends.
+ * Silence detection only kicks in after `minFrames` (so a short pause at the very start
+ * does not cut speech off).
+ */
+export declare class SilenceDetector {
+    private readonly threshold;
+    private readonly silenceFrames;
+    private readonly minFrames;
+    private readonly maxFrames;
+    private silentFrames;
+    private recordedFrames;
+    constructor(threshold: number, silenceFrames: number, minFrames: number, maxFrames: number);
+    /** Feed one frame; returns true when recording should stop (silence reached or max length). */
+    push(pcm: Buffer): boolean;
+}

package/build/vad.js

@@ -0,0 +1,55 @@
+"use strict";
+/** Simple RMS-energy voice-activity detection (ported from the Hannah satellite). */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SilenceDetector = void 0;
+exports.rms = rms;
+/** RMS energy (0..32768) of a 16-bit signed LE PCM frame. */
+function rms(pcm) {
+    const n = Math.floor(pcm.length / 2);
+    if (!n) {
+        return 0;
+    }
+    let sum = 0;
+    for (let i = 0; i < n; i++) {
+        const s = pcm.readInt16LE(i * 2);
+        sum += s * s;
+    }
+    return Math.sqrt(sum / n);
+}
+/**
+ * Tracks trailing silence across frames to decide when an utterance ends.
+ * Silence detection only kicks in after `minFrames` (so a short pause at the very start
+ * does not cut speech off).
+ */
+class SilenceDetector {
+    threshold;
+    silenceFrames;
+    minFrames;
+    maxFrames;
+    silentFrames = 0;
+    recordedFrames = 0;
+    constructor(threshold, silenceFrames, minFrames, maxFrames) {
+        this.threshold = threshold;
+        this.silenceFrames = silenceFrames;
+        this.minFrames = minFrames;
+        this.maxFrames = maxFrames;
+    }
+    /** Feed one frame; returns true when recording should stop (silence reached or max length). */
+    push(pcm) {
+        this.recordedFrames++;
+        if (this.recordedFrames >= this.maxFrames) {
+            return true;
+        }
+        if (this.recordedFrames < this.minFrames) {
+            return false;
+        }
+        if (rms(pcm) < this.threshold) {
+            this.silentFrames++;
+            return this.silentFrames >= this.silenceFrames;
+        }
+        this.silentFrames = 0;
+        return false;
+    }
+}
+exports.SilenceDetector = SilenceDetector;
+//# sourceMappingURL=vad.js.map

package/build/vad.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vad.js","sourceRoot":"","sources":["../src/vad.ts"],"names":[],"mappings":";AAAA,qFAAqF;;;AAGrF,kBAWC;AAZD,6DAA6D;AAC7D,SAAgB,GAAG,CAAC,GAAW;IAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrC,IAAI,CAAC,CAAC,EAAE,CAAC;QACL,OAAO,CAAC,CAAC;IACb,CAAC;IACD,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACjC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED;;;;GAIG;AACH,MAAa,eAAe;IAKH;IACA;IACA;IACA;IAPb,YAAY,GAAG,CAAC,CAAC;IACjB,cAAc,GAAG,CAAC,CAAC;IAE3B,YACqB,SAAiB,EACjB,aAAqB,EACrB,SAAiB,EACjB,SAAiB;QAHjB,cAAS,GAAT,SAAS,CAAQ;QACjB,kBAAa,GAAb,aAAa,CAAQ;QACrB,cAAS,GAAT,SAAS,CAAQ;QACjB,cAAS,GAAT,SAAS,CAAQ;IACnC,CAAC;IAEJ,+FAA+F;IAC/F,IAAI,CAAC,GAAW;QACZ,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,IAAI,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YACvC,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAC5B,IAAI,CAAC,YAAY,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,aAAa,CAAC;QACnD,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QACtB,OAAO,KAAK,CAAC;IACjB,CAAC;CACJ;AA3BD,0CA2BC"}

package/build/wakeword.d.ts

@@ -0,0 +1,29 @@
+import type { ModelPaths } from './models';
+import type { Logger } from './index';
+export declare class WakeWord {
+    private readonly models;
+    private readonly threshold;
+    private readonly log;
+    private melspec;
+    private embedding;
+    private classifier;
+    private melBuffer;
+    private melProcessed;
+    private embBuffer;
+    private melShapeLogged;
+    private embShapeLogged;
+    constructor(models: ModelPaths, threshold: number, log: Logger);
+    load(): Promise<void>;
+    /** Reset the streaming buffers (call after a detection so it re-arms cleanly). */
+    reset(): void;
+    /**
+     * Feed one audio chunk (16-bit signed LE PCM, ideally ~1280 samples = 80 ms) and return the
+     * current wake-word score, or null if not enough context yet.
+     */
+    process(pcm: Buffer): Promise<number | null>;
+    /** True when the given score crosses the configured detection threshold. */
+    triggered(score: number | null): boolean;
+    private appendMel;
+    private appendEmbeddings;
+    private classify;
+}