@iobroker/assistant-satellite 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ioBroker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,173 @@
+# @iobroker/assistant-satellite
+
+A standalone **voice satellite** for the [`ioBroker.assistant`](https://github.com/ioBroker/ioBroker.assistant)
+adapter. It runs the wake word on the device, streams the microphone to the adapter, and plays the
+spoken reply — over the same UDP protocol as the Hannah satellite. **No ioBroker install required**;
+runs on a bare Raspberry Pi via `npx`.
+
+> STT → LLM → TTS all run in the adapter. The satellite only does: wake word · mic capture · playback.
+
+## Requirements
+
+- Node.js ≥ 18
+- Audio backend (auto-selected by platform):
+  - **Linux**: ALSA tools — `sudo apt install alsa-utils` (`arecord`/`aplay`)
+  - **Windows / macOS**: **ffmpeg** (provides `ffmpeg`/`ffplay`) on the PATH
+- A running `ioBroker.assistant` instance with the **Voice** server enabled
+
+Wake-word inference uses `onnxruntime-node`, which ships prebuilt binaries for Linux (x64/arm64),
+Windows (x64) and macOS (x64/arm64) — so the satellite runs on all three; only the audio backend differs.
+
+## Quick start
+
+```bash
+# 1. First run writes a default config and exits:
+npx @iobroker/assistant-satellite
+
+# 2. Edit config.json — at least set "host" (the ioBroker host) and your ALSA devices:
+#    "host": "192.168.1.129", "micDevice": "plughw:2,0", "speakerDevice": "plughw:2,0"
+
+# 3. Run:
+npx @iobroker/assistant-satellite config.json
+```
+
+On first run it downloads the OpenWakeWord models into `modelsDir`. Then say the wake word
+(default **"hey jarvis"**) → speak → the answer is played back.
+
+Find your ALSA device with `arecord -l` / `aplay -l` (→ `plughw:<card>,<device>`; the `plug` prefix
+lets ALSA resample so 16 kHz capture works on any card).
+
+### As a bare command
+
+The package exposes an `assistant-satellite` binary (like `mocha`, `eslint`, … — via the `bin` field),
+so you don't have to type `node build/cli.js`. Get it onto your PATH by installing globally:
+
+```bash
+npm i -g @iobroker/assistant-satellite     # after publish; or `npm i -g .` / `npm link` from a clone
+assistant-satellite check config.json
+assistant-satellite config.json
+sudo assistant-satellite install config.json
+```
+
+`npx @iobroker/assistant-satellite …` works without a global install. All subcommands
+(`check` / `install` / `uninstall`) accept the same forms.
+
+## Configuration (`config.json`)
+
+| Key                              | Default          | Meaning                                              |
+|----------------------------------|------------------|------------------------------------------------------|
+| `logLevel`                       | `info`           | `info` or `debug` (wake-word/mic diagnostics)        |
+| `device` / `room`                | `satellite` / `` | identity reported to the adapter                     |
+| `host` / `port`                  | `` / `7775`      | adapter address (fixed → **no MQTT broker needed**)  |
+| `listenPort`                     | `7776`           | UDP port the satellite receives TTS on               |
+| `mqttBroker` …                   | ``               | optional discovery instead of a fixed `host`         |
+| `audioBackend`                   | `auto`           | `auto` / `alsa` / `ffmpeg`                           |
+| `micDevice` / `speakerDevice`    | `default`        | see per-platform notes below                         |
+| `wakewordModel`                  | `hey_jarvis`     | built-in name, URL, or local `.onnx` path            |
+| `wakewordThreshold`              | `0.5`            | detection sensitivity (0–1)                          |
+| `silenceThreshold` / `silenceMs` | `300` / `800`    | end-of-speech (VAD)                                  |
+| `minRecordMs` / `maxRecordMs`    | `800` / `8000`   | recording bounds                                     |
+
+Built-in wake words: `hey_jarvis`, `alexa`, `hey_mycroft`, `hey_rhasspy`.
+
+### Audio devices per platform
+
+- **Linux (alsa):** `micDevice`/`speakerDevice` = ALSA names, e.g. `plughw:2,0`. List with `arecord -l` /
+  `aplay -l` (the `plug` prefix lets ALSA resample so 16 kHz capture works on any card).
+- **Windows (ffmpeg):** `micDevice` = the DirectShow device **name**, e.g. `Microphone (Poly Sync 20)`.
+  List with `ffmpeg -hide_banner -list_devices true -f dshow -i dummy`. Playback uses the default output
+  (`speakerDevice` is ignored via ffplay).
+- **macOS (ffmpeg):** `micDevice` = the avfoundation audio **index**, e.g. `0`. List with
+  `ffmpeg -hide_banner -f avfoundation -list_devices true -i ""`.
+
+## Run as a service (systemd)
+
+The satellite already retries registration and re-registers automatically if the adapter restarts, so
+`systemd` only needs to keep the process alive.
+
+First verify everything is present (Node, systemd, root, audio tools, **live mic-in / speaker-out test**,
+config) — `install` runs these automatically and aborts on failure:
+
+```bash
+node build/cli.js check config.json     # dry-run of the same checks
+```
+
+Then install itself as a service (Linux, needs `sudo`):
+
+```bash
+# from a clone (build first), pointing at your config:
+npm run build
+sudo node build/cli.js install config.json      # add --force to install despite check failures
+# …or, after `npm i -g @iobroker/assistant-satellite`:
+sudo assistant-satellite install /path/to/config.json
+```
+
+`install` writes `/etc/systemd/system/assistant-satellite.service` (running as **your** user, in the
+`audio` group, with absolute paths to `node`, `cli.js` and the config), then `daemon-reload` +
+`enable --now`. Manage it with:
+
+```bash
+journalctl -u assistant-satellite -f          # logs
+sudo systemctl restart assistant-satellite
+sudo node build/cli.js uninstall              # stop + remove  (or: sudo assistant-satellite uninstall)
+```
+
+<details><summary>Prefer a handwritten unit file?</summary>
+
+```ini
+[Unit]
+Description=ioBroker assistant satellite
+After=network-online.target sound.target
+Wants=network-online.target
+
+[Service]
+WorkingDirectory=/opt/assistant-satellite
+ExecStart=/usr/bin/node /opt/assistant-satellite/build/cli.js /opt/assistant-satellite/config.json
+Restart=always
+RestartSec=5
+User=iob
+SupplementaryGroups=audio
+
+[Install]
+WantedBy=multi-user.target
+```
+</details>
+
+## Status
+
+Early scaffold. The audio/UDP/registration/playback pipeline follows the working Hannah satellite;
+the **OpenWakeWord** inference (`src/wakeword.ts`) is a from-scratch Node port and its frame math /
+threshold should be validated on the target device.
+
+## Changelog
+<!--
+    Placeholder for the next version (at the beginning of the line):
+    ### **WORK IN PROGRESS**
+-->
+### **WORK IN PROGRESS**
+* (@GermanBluefox) Initial commit
+
+
+## License
+
+MIT License
+
+Copyright (c) 2025-2026 Denis Haev <dogafox@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/build/audio.d.ts

@@ -0,0 +1,20 @@
+import type { Logger } from './index';
+export type AudioBackend = 'alsa' | 'ffmpeg';
+/** Resolve 'auto' → alsa on Linux, ffmpeg elsewhere. */
+export declare function resolveBackend(pref: string): AudioBackend;
+/** ffmpeg capture input args per platform (device = dshow name / avfoundation index / ALSA name). */
+export declare function ffmpegInput(device: string): string[];
+/** Continuous microphone capture at 16 kHz mono 16-bit; emits raw PCM chunks. */
+export declare class Mic {
+    private readonly backend;
+    private readonly device;
+    private readonly log;
+    private proc;
+    constructor(backend: AudioBackend, device: string, log: Logger);
+    start(onData: (pcm: Buffer) => void): void;
+    stop(): void;
+}
+/** Play raw mono 16-bit PCM at the given rate; resolves when playback finishes. */
+export declare function playPcm(pcm: Buffer, sampleRate: number, backend: AudioBackend, device: string, log: Logger): Promise<void>;
+/** A short rising "listening" beep (mono 16-bit @ 16 kHz), synthesised once. */
+export declare function pling(): Buffer;

package/build/audio.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Mic = void 0;
+exports.resolveBackend = resolveBackend;
+exports.ffmpegInput = ffmpegInput;
+exports.playPcm = playPcm;
+exports.pling = pling;
+/**
+ * Audio I/O with two backends:
+ *   - 'alsa'  : spawn `arecord`/`aplay` — robust on a Pi, no native build (Linux only).
+ *   - 'ffmpeg': spawn `ffmpeg`/`ffplay` — cross-platform (Windows / macOS / Linux).
+ *
+ * Capture is always 16 kHz mono 16-bit; use a `plughw:CARD,DEV` device (ALSA) so it resamples.
+ */
+const node_child_process_1 = require("node:child_process");
+const protocol_1 = require("./protocol");
+/** Resolve 'auto' → alsa on Linux, ffmpeg elsewhere. */
+function resolveBackend(pref) {
+    if (pref === 'alsa' || pref === 'ffmpeg') {
+        return pref;
+    }
+    return process.platform === 'linux' ? 'alsa' : 'ffmpeg';
+}
+/** ffmpeg capture input args per platform (device = dshow name / avfoundation index / ALSA name). */
+function ffmpegInput(device) {
+    if (process.platform === 'win32') {
+        return ['-f', 'dshow', '-i', `audio=${device || 'default'}`];
+    }
+    if (process.platform === 'darwin') {
+        return ['-f', 'avfoundation', '-i', `:${device || '0'}`];
+    }
+    return ['-f', 'alsa', '-i', device || 'default'];
+}
+/** Continuous microphone capture at 16 kHz mono 16-bit; emits raw PCM chunks. */
+class Mic {
+    backend;
+    device;
+    log;
+    proc = null;
+    constructor(backend, device, log) {
+        this.backend = backend;
+        this.device = device;
+        this.log = log;
+    }
+    start(onData) {
+        const [cmd, args] = this.backend === 'ffmpeg'
+            ? [
+                'ffmpeg',
+                [
+                    '-hide_banner',
+                    '-loglevel',
+                    'error',
+                    ...ffmpegInput(this.device),
+                    '-ac',
+                    '1',
+                    '-ar',
+                    String(protocol_1.AUDIO_SAMPLE_RATE),
+                    '-f',
+                    's16le',
+                    '-',
+                ],
+            ]
+            : [
+                'arecord',
+                [
+                    '-q',
+                    '-t',
+                    'raw',
+                    '-f',
+                    'S16_LE',
+                    '-c',
+                    '1',
+                    '-r',
+                    String(protocol_1.AUDIO_SAMPLE_RATE),
+                    ...(this.device && this.device !== 'default' ? ['-D', this.device] : []),
+                ],
+            ];
+        this.proc = (0, node_child_process_1.spawn)(cmd, args);
+        this.proc.stdout?.on('data', (d) => onData(d));
+        this.proc.stderr?.on('data', (d) => this.log.debug(`${cmd}: ${d.toString().trim()}`));
+        this.proc.on('error', e => this.log.error(`${cmd} failed: ${e.message} — is it installed? ` +
+            (this.backend === 'ffmpeg' ? '(install ffmpeg)' : "(sudo apt install alsa-utils)")));
+        this.log.info(`Microphone capture started (${this.backend}: ${this.device || 'default'} @ ${protocol_1.AUDIO_SAMPLE_RATE} Hz).`);
+    }
+    stop() {
+        this.proc?.kill();
+        this.proc = null;
+    }
+}
+exports.Mic = Mic;
+/** Play raw mono 16-bit PCM at the given rate; resolves when playback finishes. */
+function playPcm(pcm, sampleRate, backend, device, log) {
+    return new Promise(resolve => {
+        const [cmd, args] = backend === 'ffmpeg'
+            ? [
+                'ffplay',
+                ['-hide_banner', '-loglevel', 'error', '-nodisp', '-autoexit', '-f', 's16le', '-ar', String(sampleRate), '-ch_layout', 'mono', '-i', '-'],
+            ]
+            : [
+                'aplay',
+                ['-q', '-t', 'raw', '-f', 'S16_LE', '-c', '1', '-r', String(sampleRate), ...(device && device !== 'default' ? ['-D', device] : [])],
+            ];
+        const proc = (0, node_child_process_1.spawn)(cmd, args);
+        proc.on('close', () => resolve());
+        proc.on('error', e => {
+            log.error(`${cmd} failed: ${e.message}`);
+            resolve();
+        });
+        proc.stdin?.end(pcm);
+    });
+}
+/** A short rising "listening" beep (mono 16-bit @ 16 kHz), synthesised once. */
+function pling() {
+    const rate = protocol_1.AUDIO_SAMPLE_RATE;
+    const dur = 0.18;
+    const n = Math.floor(rate * dur);
+    const buf = Buffer.alloc(n * 2);
+    for (let i = 0; i < n; i++) {
+        const t = i / rate;
+        const freq = 880 + (1320 - 880) * (i / n);
+        const fade = Math.sin((Math.PI * i) / n);
+        const val = Math.max(-32768, Math.min(32767, Math.round(32767 * 0.6 * fade * Math.sin(2 * Math.PI * freq * t))));
+        buf.writeInt16LE(val, i * 2);
+    }
+    return buf;
+}
+//# sourceMappingURL=audio.js.map

package/build/audio.js.map

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

package/build/checks.d.ts

@@ -0,0 +1,13 @@
+import { type AudioBackend } from './audio';
+import type { SatelliteConfig } from './config';
+import type { Logger } from './index';
+export type CheckStatus = 'ok' | 'warn' | 'fail';
+export interface CheckResult {
+    name: string;
+    status: CheckStatus;
+    detail: string;
+}
+/** Run all checks. `forService` adds the systemd/root prerequisites. */
+export declare function runChecks(cfg: SatelliteConfig, backend: AudioBackend, forService: boolean): CheckResult[];
+/** Print the results; returns false if any check failed. */
+export declare function printChecks(results: CheckResult[], log: Logger): boolean;

package/build/checks.js

@@ -0,0 +1,150 @@
+"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.runChecks = runChecks;
+exports.printChecks = printChecks;
+/**
+ * Preflight checks: run before installing the service (and via the `check` subcommand) to verify
+ * everything is present — Node, systemd, root rights, audio tools, and functional mic-in / speaker-out.
+ */
+const node_child_process_1 = require("node:child_process");
+const fs = __importStar(require("node:fs"));
+const audio_1 = require("./audio");
+const ok = (name, detail = '') => ({ name, status: 'ok', detail });
+const warn = (name, detail) => ({ name, status: 'warn', detail });
+const fail = (name, detail) => ({ name, status: 'fail', detail });
+function which(cmd) {
+    try {
+        (0, node_child_process_1.execFileSync)(process.platform === 'win32' ? 'where' : 'which', [cmd], { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+const firstLine = (s) => s.split('\n')[0].slice(0, 140);
+/** Capture ~1 s from the mic and confirm real bytes come out. */
+function checkCapture(cfg, backend) {
+    try {
+        let out;
+        if (backend === 'ffmpeg') {
+            out = (0, node_child_process_1.execFileSync)('ffmpeg', ['-hide_banner', '-loglevel', 'error', ...(0, audio_1.ffmpegInput)(cfg.micDevice), '-t', '1', '-ac', '1', '-ar', '16000', '-f', 's16le', '-'], { timeout: 8000, maxBuffer: 1 << 22 });
+        }
+        else {
+            const args = ['-q', '-f', 'S16_LE', '-r', '16000', '-c', '1', '-d', '1', '-t', 'raw'];
+            if (cfg.micDevice && cfg.micDevice !== 'default') {
+                args.push('-D', cfg.micDevice);
+            }
+            out = (0, node_child_process_1.execFileSync)('arecord', args, { timeout: 8000, maxBuffer: 1 << 22 });
+        }
+        return out.length > 1000
+            ? ok('audio:in', `captured ${out.length} bytes from '${cfg.micDevice}'`)
+            : fail('audio:in', `captured only ${out.length} bytes — wrong device or no signal`);
+    }
+    catch (e) {
+        return fail('audio:in', `capture failed (device busy/wrong?): ${firstLine(e.message)}`);
+    }
+}
+/** Play 0.2 s of silence to confirm the output device opens. */
+function checkPlayback(cfg, backend) {
+    const silence = Buffer.alloc(Math.round((16000 * 2) / 5)); // 0.2 s @ 16 kHz mono 16-bit
+    try {
+        if (backend === 'ffmpeg') {
+            (0, node_child_process_1.execFileSync)('ffplay', ['-hide_banner', '-loglevel', 'error', '-nodisp', '-autoexit', '-f', 's16le', '-ar', '16000', '-ch_layout', 'mono', '-i', '-'], { input: silence, timeout: 8000 });
+        }
+        else {
+            const args = ['-q', '-f', 'S16_LE', '-r', '16000', '-c', '1'];
+            if (cfg.speakerDevice && cfg.speakerDevice !== 'default') {
+                args.push('-D', cfg.speakerDevice);
+            }
+            (0, node_child_process_1.execFileSync)('aplay', args, { input: silence, timeout: 8000 });
+        }
+        return ok('audio:out', `output device '${cfg.speakerDevice}' opened`);
+    }
+    catch (e) {
+        return fail('audio:out', `playback failed (device busy/wrong?): ${firstLine(e.message)}`);
+    }
+}
+/** Run all checks. `forService` adds the systemd/root prerequisites. */
+function runChecks(cfg, backend, forService) {
+    const results = [];
+    const major = Number(process.versions.node.split('.')[0]);
+    results.push(major >= 18 ? ok('node', `v${process.versions.node}`) : fail('node', `v${process.versions.node} (need ≥ 18)`));
+    if (forService) {
+        results.push(process.platform === 'linux'
+            ? ok('platform', 'linux')
+            : fail('platform', `${process.platform} — systemd install is Linux-only`));
+        results.push(which('systemctl') ? ok('systemctl', 'found') : fail('systemctl', 'not found'));
+        const root = typeof process.getuid === 'function' && process.getuid() === 0;
+        results.push(root ? ok('root', 'running as root') : warn('root', 'not root — run install with sudo'));
+    }
+    for (const t of backend === 'ffmpeg' ? ['ffmpeg', 'ffplay'] : ['arecord', 'aplay']) {
+        results.push(which(t)
+            ? ok(`tool:${t}`, 'found')
+            : fail(`tool:${t}`, `not found — install ${backend === 'ffmpeg' ? 'ffmpeg' : 'alsa-utils'}`));
+    }
+    results.push(checkCapture(cfg, backend));
+    results.push(checkPlayback(cfg, backend));
+    results.push(cfg.host || cfg.mqttBroker
+        ? ok('config:server', cfg.host ? `host ${cfg.host}:${cfg.port}` : `discovery via ${cfg.mqttBroker}`)
+        : fail('config:server', 'set "host" (or "mqttBroker") so the satellite can reach the adapter'));
+    try {
+        fs.mkdirSync(cfg.modelsDir, { recursive: true });
+        fs.accessSync(cfg.modelsDir, fs.constants.W_OK);
+        results.push(ok('models', `'${cfg.modelsDir}' writable`));
+    }
+    catch {
+        results.push(warn('models', `'${cfg.modelsDir}' not writable — model download may fail`));
+    }
+    return results;
+}
+/** Print the results; returns false if any check failed. */
+function printChecks(results, log) {
+    const label = { ok: 'OK  ', warn: 'WARN', fail: 'FAIL' };
+    for (const c of results) {
+        const line = `[${label[c.status]}] ${c.name}${c.detail ? ` — ${c.detail}` : ''}`;
+        if (c.status === 'fail') {
+            log.error(line);
+        }
+        else if (c.status === 'warn') {
+            log.warn(line);
+        }
+        else {
+            log.info(line);
+        }
+    }
+    return !results.some(c => c.status === 'fail');
+}
+//# sourceMappingURL=checks.js.map

package/build/checks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.js","sourceRoot":"","sources":["../src/checks.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiFA,8BA2CC;AAGD,kCAaC;AA5ID;;;GAGG;AACH,2DAAkD;AAClD,4CAA8B;AAC9B,mCAAyD;AAWzD,MAAM,EAAE,GAAG,CAAC,IAAY,EAAE,MAAM,GAAG,EAAE,EAAe,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;AACxF,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,MAAc,EAAe,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAC/F,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,MAAc,EAAe,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAE/F,SAAS,KAAK,CAAC,GAAW;IACtB,IAAI,CAAC;QACD,IAAA,iCAAY,EAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC3F,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC;AAED,MAAM,SAAS,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAExE,iEAAiE;AACjE,SAAS,YAAY,CAAC,GAAoB,EAAE,OAAqB;IAC7D,IAAI,CAAC;QACD,IAAI,GAAW,CAAC;QAChB,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YACvB,GAAG,GAAG,IAAA,iCAAY,EACd,QAAQ,EACR,CAAC,cAAc,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,IAAA,mBAAW,EAAC,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,EAChI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CACxC,CAAC;QACN,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YACtF,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC/C,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;YACnC,CAAC;YACD,GAAG,GAAG,IAAA,iCAAY,EAAC,SAAS,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC/E,CAAC;QACD,OAAO,GAAG,CAAC,MAAM,GAAG,IAAI;YACpB,CAAC,CAAC,EAAE,CAAC,UAAU,EAAE,YAAY,GAAG,CAAC,MAAM,gBAAgB,GAAG,CAAC,SAAS,GAAG,CAAC;YACxE,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,iBAAiB,GAAG,CAAC,MAAM,oCAAoC,CAAC,CAAC;IAC5F,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,OAAO,IAAI,CAAC,UAAU,EAAE,wCAAwC,SAAS,CAAE,CAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACvG,CAAC;AACL,CAAC;AAED,gEAAgE;AAChE,SAAS,aAAa,CAAC,GAAoB,EAAE,OAAqB;IAC9D,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,6BAA6B;IACxF,IAAI,CAAC;QACD,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YACvB,IAAA,iCAAY,EACR,QAAQ,EACR,CAAC,cAAc,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,EAC9H,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CACpC,CAAC;QACN,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;YAC9D,IAAI,GAAG,CAAC,aAAa,IAAI,GAAG,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;gBACvD,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;YACvC,CAAC;YACD,IAAA,iCAAY,EAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,EAAE,CAAC,WAAW,EAAE,kBAAkB,GAAG,CAAC,aAAa,UAAU,CAAC,CAAC;IAC1E,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,OAAO,IAAI,CAAC,WAAW,EAAE,yCAAyC,SAAS,CAAE,CAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACzG,CAAC;AACL,CAAC;AAED,wEAAwE;AACxE,SAAgB,SAAS,CAAC,GAAoB,EAAE,OAAqB,EAAE,UAAmB;IACtF,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC;IAE5H,IAAI,UAAU,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CACR,OAAO,CAAC,QAAQ,KAAK,OAAO;YACxB,CAAC,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;YACzB,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,OAAO,CAAC,QAAQ,kCAAkC,CAAC,CAChF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;QAC7F,MAAM,IAAI,GAAG,OAAO,OAAO,CAAC,MAAM,KAAK,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC5E,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,kCAAkC,CAAC,CAAC,CAAC;IAC1G,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC;QACjF,OAAO,CAAC,IAAI,CACR,KAAK,CAAC,CAAC,CAAC;YACJ,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;YAC1B,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,uBAAuB,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CACnG,CAAC;IACN,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IACzC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IAE1C,OAAO,CAAC,IAAI,CACR,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,UAAU;QACtB,CAAC,CAAC,EAAE,CAAC,eAAe,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,iBAAiB,GAAG,CAAC,UAAU,EAAE,CAAC;QACpG,CAAC,CAAC,IAAI,CAAC,eAAe,EAAE,qEAAqE,CAAC,CACrG,CAAC;IAEF,IAAI,CAAC;QACD,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,GAAG,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,CAAC,SAAS,0CAA0C,CAAC,CAAC,CAAC;IAC9F,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,4DAA4D;AAC5D,SAAgB,WAAW,CAAC,OAAsB,EAAE,GAAW;IAC3D,MAAM,KAAK,GAAgC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACtF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACjF,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YACtB,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;aAAM,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC7B,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;aAAM,CAAC;YACJ,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;IACL,CAAC;IACD,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;AACnD,CAAC"}

package/build/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/build/cli.js

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+"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 });
+/**
+ * CLI entry point:
+ *   assistant-satellite [config.json]           run the satellite
+ *   assistant-satellite install [config.json]   install + start a systemd service (Linux, needs sudo)
+ *   assistant-satellite uninstall               stop + remove the systemd service (needs sudo)
+ */
+const fs = __importStar(require("node:fs"));
+const index_1 = require("./index");
+const service_1 = require("./service");
+const checks_1 = require("./checks");
+const audio_1 = require("./audio");
+// Debug is off until we know the config's logLevel; the DEBUG env var forces it on regardless.
+let debugEnabled = !!process.env.DEBUG;
+const log = {
+    info: (m) => console.log(`[INFO]  ${m}`),
+    warn: (m) => console.warn(`[WARN]  ${m}`),
+    error: (m) => console.error(`[ERROR] ${m}`),
+    debug: (m) => {
+        if (debugEnabled) {
+            console.log(`[DEBUG] ${m}`);
+        }
+    },
+};
+const [command, ...rest] = process.argv.slice(2);
+const configArg = rest.find(a => !a.startsWith('--')) || 'config.json';
+// `check` — run preflight checks (rights, audio in/out, tools, config) and exit.
+if (command === 'check') {
+    if (!fs.existsSync(configArg)) {
+        log.error(`config not found: ${configArg}`);
+        process.exit(1);
+    }
+    try {
+        const c = (0, index_1.loadConfig)(JSON.parse(fs.readFileSync(configArg, 'utf8')));
+        const passed = (0, checks_1.printChecks)((0, checks_1.runChecks)(c, (0, audio_1.resolveBackend)(c.audioBackend), true), log);
+        process.exit(passed ? 0 : 1);
+    }
+    catch (e) {
+        log.error(e.message);
+        process.exit(1);
+    }
+}
+// Service management subcommands (Linux/systemd). `install` runs the checks first.
+if (command === 'install' || command === '--install') {
+    try {
+        (0, service_1.installService)(configArg, log, rest.includes('--force'));
+        process.exit(0);
+    }
+    catch (e) {
+        log.error(e.message);
+        process.exit(1);
+    }
+}
+if (command === 'uninstall' || command === '--uninstall') {
+    try {
+        (0, service_1.uninstallService)(log);
+        process.exit(0);
+    }
+    catch (e) {
+        log.error(e.message);
+        process.exit(1);
+    }
+}
+const configPath = command || 'config.json';
+if (!fs.existsSync(configPath)) {
+    fs.writeFileSync(configPath, `${JSON.stringify(index_1.DEFAULT_CONFIG, null, 4)}\n`);
+    log.info(`No config found — wrote defaults to ${configPath}.`);
+    log.info('Edit it (at least set "host" and "device"), then run again.');
+    process.exit(0);
+}
+let cfg;
+try {
+    cfg = (0, index_1.loadConfig)(JSON.parse(fs.readFileSync(configPath, 'utf8')));
+}
+catch (e) {
+    log.error(`Cannot read ${configPath}: ${e.message}`);
+    process.exit(1);
+}
+if (cfg.logLevel === 'debug') {
+    debugEnabled = true;
+}
+const satellite = new index_1.Satellite(cfg, { log, onStatus: s => log.debug(`status: ${s}`) });
+satellite.start().catch(e => {
+    log.error(e.message);
+    process.exit(1);
+});
+let stopping = false;
+async function shutdown() {
+    if (stopping) {
+        return;
+    }
+    stopping = true;
+    log.info('Shutting down …');
+    await satellite.stop();
+    process.exit(0);
+}
+process.on('SIGINT', () => void shutdown());
+process.on('SIGTERM', () => void shutdown());
+//# sourceMappingURL=cli.js.map