@iobroker/assistant-satellite 0.0.1

package/build/cli.js.map

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

package/build/config.d.ts

@@ -0,0 +1,46 @@
+/** Satellite configuration (loaded from config.json / CLI). */
+export interface SatelliteConfig {
+    /** Log verbosity. 'debug' also prints the wake-word/mic diagnostics. */
+    logLevel: 'info' | 'debug';
+    /** Device identity reported to the adapter. */
+    device: string;
+    room: string;
+    /** Adapter (voice-server) address. Discovery via MQTT is optional; a fixed host needs no broker. */
+    host: string;
+    port: number;
+    /** UDP port the satellite listens on for TTS/control from the adapter. */
+    listenPort: number;
+    /** Optional MQTT discovery — leave broker empty to run without a broker (fixed host only). */
+    mqttBroker: string;
+    mqttPort: number;
+    mqttUser: string;
+    mqttPass: string;
+    discoveryTopic: string;
+    discoveryTimeoutMs: number;
+    /** Audio backend: 'auto' (alsa on Linux, ffmpeg elsewhere), or force 'alsa' / 'ffmpeg'. */
+    audioBackend: 'auto' | 'alsa' | 'ffmpeg';
+    /**
+     * Capture/playback devices. ALSA: e.g. "plughw:2,0". ffmpeg mic: dshow device name (Windows),
+     * avfoundation index (macOS). "default" or "" = system default.
+     */
+    micDevice: string;
+    speakerDevice: string;
+    /** Wake word. modelPath: path to a wakeword .onnx ('' = built-in "hey_jarvis"). */
+    wakewordModel: string;
+    wakewordThreshold: number;
+    /** Directory the melspectrogram/embedding/wakeword models are downloaded to/read from. */
+    modelsDir: string;
+    /** Recording (VAD) — silence detection to end an utterance. */
+    silenceThreshold: number;
+    silenceMs: number;
+    minRecordMs: number;
+    maxRecordMs: number;
+    /** Number of pre-wake 80 ms chunks prepended to the recording (so no speech is lost). */
+    preBufferChunks: number;
+    /** Heartbeat / registration. */
+    registrationTimeoutMs: number;
+    heartbeatIntervalMs: number;
+}
+export declare const DEFAULT_CONFIG: SatelliteConfig;
+/** Merge a partial config (from config.json) onto the defaults. */
+export declare function loadConfig(partial: Partial<SatelliteConfig>): SatelliteConfig;

package/build/config.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONFIG = void 0;
+exports.loadConfig = loadConfig;
+exports.DEFAULT_CONFIG = {
+    logLevel: 'info',
+    device: 'satellite',
+    room: '',
+    host: '',
+    port: 7775,
+    listenPort: 7776,
+    mqttBroker: '',
+    mqttPort: 1883,
+    mqttUser: '',
+    mqttPass: '',
+    discoveryTopic: 'hannah/server',
+    discoveryTimeoutMs: 5000,
+    audioBackend: 'auto',
+    micDevice: 'default',
+    speakerDevice: 'default',
+    wakewordModel: '',
+    wakewordThreshold: 0.5,
+    modelsDir: 'models',
+    silenceThreshold: 300,
+    silenceMs: 800,
+    minRecordMs: 800,
+    maxRecordMs: 8000,
+    preBufferChunks: 5,
+    registrationTimeoutMs: 5000,
+    heartbeatIntervalMs: 10000,
+};
+/** Merge a partial config (from config.json) onto the defaults. */
+function loadConfig(partial) {
+    return { ...exports.DEFAULT_CONFIG, ...partial };
+}
+//# sourceMappingURL=config.js.map

package/build/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;AAgFA,gCAEC;AA/BY,QAAA,cAAc,GAAoB;IAC3C,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,WAAW;IACnB,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,IAAI;IACV,UAAU,EAAE,IAAI;IAChB,UAAU,EAAE,EAAE;IACd,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,EAAE;IACZ,cAAc,EAAE,eAAe;IAC/B,kBAAkB,EAAE,IAAI;IACxB,YAAY,EAAE,MAAM;IACpB,SAAS,EAAE,SAAS;IACpB,aAAa,EAAE,SAAS;IACxB,aAAa,EAAE,EAAE;IACjB,iBAAiB,EAAE,GAAG;IACtB,SAAS,EAAE,QAAQ;IACnB,gBAAgB,EAAE,GAAG;IACrB,SAAS,EAAE,GAAG;IACd,WAAW,EAAE,GAAG;IAChB,WAAW,EAAE,IAAI;IACjB,eAAe,EAAE,CAAC;IAClB,qBAAqB,EAAE,IAAI;IAC3B,mBAAmB,EAAE,KAAK;CAC7B,CAAC;AAEF,mEAAmE;AACnE,SAAgB,UAAU,CAAC,OAAiC;IACxD,OAAO,EAAE,GAAG,sBAAc,EAAE,GAAG,OAAO,EAAE,CAAC;AAC7C,CAAC"}

package/build/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @iobroker/assistant-satellite — public API.
+ *
+ * The Satellite is dependency-injected with a host (logger + status callback) so the same code runs
+ * standalone (CLI) and, later, inside an ioBroker adapter wrapper — with no ioBroker dependency here.
+ */
+import type { SatelliteState } from './protocol';
+export interface Logger {
+    info(m: string): void;
+    warn(m: string): void;
+    error(m: string): void;
+    debug(m: string): void;
+}
+export interface SatelliteHost {
+    log: Logger;
+    /** Called on every state transition (idle/listening/processing/speaking). */
+    onStatus?(state: SatelliteState): void;
+}
+export { Satellite } from './satellite';
+export { loadConfig, DEFAULT_CONFIG, type SatelliteConfig } from './config';
+export type { SatelliteState } from './protocol';

package/build/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONFIG = exports.loadConfig = exports.Satellite = void 0;
+var satellite_1 = require("./satellite");
+Object.defineProperty(exports, "Satellite", { enumerable: true, get: function () { return satellite_1.Satellite; } });
+var config_1 = require("./config");
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_1.loadConfig; } });
+Object.defineProperty(exports, "DEFAULT_CONFIG", { enumerable: true, get: function () { return config_1.DEFAULT_CONFIG; } });
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAqBA,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAClB,mCAA4E;AAAnE,oGAAA,UAAU,OAAA;AAAE,wGAAA,cAAc,OAAA"}

package/build/models.d.ts

@@ -0,0 +1,15 @@
+import type { Logger } from './index';
+export declare const MELSPEC_URL = "https://github.com/dscripka/openWakeWord/releases/download/v0.5.1/melspectrogram.onnx";
+export declare const EMBEDDING_URL = "https://github.com/dscripka/openWakeWord/releases/download/v0.5.1/embedding_model.onnx";
+/** Built-in wake words available as ONNX (name → asset). Default "hey_jarvis". */
+export declare const WAKEWORDS: Record<string, string>;
+export interface ModelPaths {
+    melspec: string;
+    embedding: string;
+    wakeword: string;
+}
+/**
+ * Ensure the three model files exist locally, downloading the missing ones.
+ * `wakewordModel` may be a name from WAKEWORDS, a URL, or a local .onnx path.
+ */
+export declare function ensureModels(modelsDir: string, wakewordModel: string, log: Logger): Promise<ModelPaths>;

package/build/models.js

@@ -0,0 +1,101 @@
+"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.WAKEWORDS = exports.EMBEDDING_URL = exports.MELSPEC_URL = void 0;
+exports.ensureModels = ensureModels;
+/**
+ * OpenWakeWord ONNX model management. The pipeline needs three models:
+ *   - melspectrogram.onnx  (shared) — audio → mel spectrogram
+ *   - embedding_model.onnx (shared) — mel → Google speech embeddings
+ *   - <wakeword>.onnx               — embeddings → wake-word score
+ *
+ * Models are downloaded on first run to `modelsDir` from the openWakeWord releases.
+ */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+/** openWakeWord release assets (feature models + a few pretrained wake words). */
+const RELEASE = 'https://github.com/dscripka/openWakeWord/releases/download/v0.5.1';
+exports.MELSPEC_URL = `${RELEASE}/melspectrogram.onnx`;
+exports.EMBEDDING_URL = `${RELEASE}/embedding_model.onnx`;
+/** Built-in wake words available as ONNX (name → asset). Default "hey_jarvis". */
+exports.WAKEWORDS = {
+    hey_jarvis: `${RELEASE}/hey_jarvis_v0.1.onnx`,
+    alexa: `${RELEASE}/alexa_v0.1.onnx`,
+    hey_mycroft: `${RELEASE}/hey_mycroft_v0.1.onnx`,
+    hey_rhasspy: `${RELEASE}/hey_rhasspy_v0.1.onnx`,
+};
+async function download(url, dest, log) {
+    if (fs.existsSync(dest)) {
+        return;
+    }
+    log.info(`Downloading model ${path.basename(dest)} …`);
+    const res = await fetch(url);
+    if (!res.ok) {
+        throw new Error(`download ${url} failed: HTTP ${res.status}`);
+    }
+    const buf = Buffer.from(await res.arrayBuffer());
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.writeFileSync(dest, buf);
+    log.info(`Saved ${path.basename(dest)} (${(buf.length / 1024).toFixed(0)} KB).`);
+}
+/**
+ * Ensure the three model files exist locally, downloading the missing ones.
+ * `wakewordModel` may be a name from WAKEWORDS, a URL, or a local .onnx path.
+ */
+async function ensureModels(modelsDir, wakewordModel, log) {
+    const melspec = path.join(modelsDir, 'melspectrogram.onnx');
+    const embedding = path.join(modelsDir, 'embedding_model.onnx');
+    await download(exports.MELSPEC_URL, melspec, log);
+    await download(exports.EMBEDDING_URL, embedding, log);
+    let wakeword;
+    const name = wakewordModel || 'hey_jarvis';
+    if (fs.existsSync(name)) {
+        wakeword = name; // a local file path
+    }
+    else if (/^https?:\/\//.test(name)) {
+        wakeword = path.join(modelsDir, path.basename(name));
+        await download(name, wakeword, log);
+    }
+    else {
+        const url = exports.WAKEWORDS[name];
+        if (!url) {
+            throw new Error(`unknown wake word "${name}" (known: ${Object.keys(exports.WAKEWORDS).join(', ')})`);
+        }
+        wakeword = path.join(modelsDir, `${name}.onnx`);
+        await download(url, wakeword, log);
+    }
+    return { melspec, embedding, wakeword };
+}
+//# sourceMappingURL=models.js.map

package/build/models.js.map

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

package/build/mqtt.d.ts

@@ -0,0 +1,6 @@
+import type { SatelliteConfig } from './config';
+import type { Logger } from './index';
+export declare function discoverServer(cfg: SatelliteConfig, log: Logger): Promise<{
+    host: string;
+    port: number;
+}>;

package/build/mqtt.js

@@ -0,0 +1,47 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discoverServer = discoverServer;
+/**
+ * Optional MQTT discovery — reads the adapter address from a retained topic
+ * (`{ "host": "...", "port": 7775 }`). Only used when no fixed host is configured.
+ */
+const mqtt_1 = __importDefault(require("mqtt"));
+function discoverServer(cfg, log) {
+    return new Promise((resolve, reject) => {
+        const client = mqtt_1.default.connect(`mqtt://${cfg.mqttBroker}:${cfg.mqttPort}`, {
+            username: cfg.mqttUser || undefined,
+            password: cfg.mqttPass || undefined,
+            connectTimeout: cfg.discoveryTimeoutMs,
+        });
+        const timer = setTimeout(() => {
+            client.end(true);
+            reject(new Error(`MQTT discovery timed out (topic '${cfg.discoveryTopic}' on ${cfg.mqttBroker})`));
+        }, cfg.discoveryTimeoutMs);
+        client.on('connect', () => {
+            log.info(`MQTT connected (${cfg.mqttBroker}:${cfg.mqttPort}), waiting for discovery …`);
+            client.subscribe(cfg.discoveryTopic, { qos: 1 });
+        });
+        client.on('message', (_topic, payload) => {
+            try {
+                const data = JSON.parse(payload.toString());
+                if (data.host) {
+                    clearTimeout(timer);
+                    client.end();
+                    resolve({ host: data.host, port: Number(data.port) || cfg.port });
+                }
+            }
+            catch {
+                /* ignore malformed discovery message */
+            }
+        });
+        client.on('error', e => {
+            clearTimeout(timer);
+            client.end(true);
+            reject(e);
+        });
+    });
+}
+//# sourceMappingURL=mqtt.js.map

package/build/mqtt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mqtt.js","sourceRoot":"","sources":["../src/mqtt.ts"],"names":[],"mappings":";;;;;AAQA,wCAkCC;AA1CD;;;GAGG;AACH,gDAAwB;AAIxB,SAAgB,cAAc,CAAC,GAAoB,EAAE,GAAW;IAC5D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACnC,MAAM,MAAM,GAAG,cAAI,CAAC,OAAO,CAAC,UAAU,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,QAAQ,EAAE,EAAE;YACpE,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,SAAS;YACnC,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,SAAS;YACnC,cAAc,EAAE,GAAG,CAAC,kBAAkB;SACzC,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC1B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACjB,MAAM,CAAC,IAAI,KAAK,CAAC,oCAAoC,GAAG,CAAC,cAAc,QAAQ,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QACvG,CAAC,EAAE,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAE3B,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YACtB,GAAG,CAAC,IAAI,CAAC,mBAAmB,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,QAAQ,4BAA4B,CAAC,CAAC;YACxF,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE;YACrC,IAAI,CAAC;gBACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAmC,CAAC;gBAC9E,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;oBACZ,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,MAAM,CAAC,GAAG,EAAE,CAAC;oBACb,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;gBACtE,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACL,wCAAwC;YAC5C,CAAC;QACL,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE;YACnB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACjB,MAAM,CAAC,CAAC,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC"}

package/build/protocol.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Voice-satellite UDP wire protocol — must match the adapter's
+ * `ioBroker.assistant/src/lib/voice/protocol.ts` (and the Hannah satellite).
+ *
+ * One UDP socket, first byte is the packet type:
+ *   0x01 CONTROL — UTF-8 JSON (both directions)
+ *   0x02 AUDIO   — raw 16 kHz mono 16-bit signed LE PCM (satellite → server)
+ *   0x03 TTS     — raw mono 16-bit signed LE PCM (server → satellite)
+ *
+ * ⚠️ KEEP IN SYNC with the adapter copy.
+ */
+export declare const TYPE_CONTROL = 1;
+export declare const TYPE_AUDIO = 2;
+export declare const TYPE_TTS = 3;
+/** Audio streamed to the server is always 16 kHz, mono, 16-bit signed little-endian PCM. */
+export declare const AUDIO_SAMPLE_RATE = 16000;
+/** Control messages the satellite sends to the server. */
+export type SatToServer = {
+    type: 'register';
+    device: string;
+    room?: string;
+    listen_port?: number;
+} | {
+    type: 'heartbeat';
+    device: string;
+} | {
+    type: 'audio_end';
+    device: string;
+};
+export type SatelliteState = 'idle' | 'listening' | 'processing' | 'speaking';
+/** Control messages the satellite receives from the server. */
+export type ServerToSat = {
+    type: 'registered';
+    ok: boolean;
+} | {
+    type: 'heartbeat_ack';
+} | {
+    type: 'reregister';
+} | {
+    type: 'tts_end';
+    sample_rate: number;
+} | {
+    type: 'status';
+    state: SatelliteState;
+};
+/** Prefix a control JSON message with the CONTROL type byte. */
+export declare function encodeControl(msg: SatToServer): Buffer;
+/** Prefix a raw PCM chunk with the AUDIO type byte. */
+export declare function encodeAudio(pcm: Buffer): Buffer;
+/** Split an incoming datagram into its type byte and payload (a view onto the original buffer). */
+export declare function decodePacket(data: Buffer): {
+    type: number;
+    payload: Buffer;
+};

package/build/protocol.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * Voice-satellite UDP wire protocol — must match the adapter's
+ * `ioBroker.assistant/src/lib/voice/protocol.ts` (and the Hannah satellite).
+ *
+ * One UDP socket, first byte is the packet type:
+ *   0x01 CONTROL — UTF-8 JSON (both directions)
+ *   0x02 AUDIO   — raw 16 kHz mono 16-bit signed LE PCM (satellite → server)
+ *   0x03 TTS     — raw mono 16-bit signed LE PCM (server → satellite)
+ *
+ * ⚠️ KEEP IN SYNC with the adapter copy.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AUDIO_SAMPLE_RATE = exports.TYPE_TTS = exports.TYPE_AUDIO = exports.TYPE_CONTROL = void 0;
+exports.encodeControl = encodeControl;
+exports.encodeAudio = encodeAudio;
+exports.decodePacket = decodePacket;
+exports.TYPE_CONTROL = 0x01;
+exports.TYPE_AUDIO = 0x02;
+exports.TYPE_TTS = 0x03;
+/** Audio streamed to the server is always 16 kHz, mono, 16-bit signed little-endian PCM. */
+exports.AUDIO_SAMPLE_RATE = 16000;
+/** Prefix a control JSON message with the CONTROL type byte. */
+function encodeControl(msg) {
+    return Buffer.concat([Buffer.from([exports.TYPE_CONTROL]), Buffer.from(JSON.stringify(msg), 'utf8')]);
+}
+/** Prefix a raw PCM chunk with the AUDIO type byte. */
+function encodeAudio(pcm) {
+    return Buffer.concat([Buffer.from([exports.TYPE_AUDIO]), pcm]);
+}
+/** Split an incoming datagram into its type byte and payload (a view onto the original buffer). */
+function decodePacket(data) {
+    return { type: data[0], payload: data.subarray(1) };
+}
+//# sourceMappingURL=protocol.js.map

package/build/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AA0BH,sCAEC;AAGD,kCAEC;AAGD,oCAEC;AApCY,QAAA,YAAY,GAAG,IAAI,CAAC;AACpB,QAAA,UAAU,GAAG,IAAI,CAAC;AAClB,QAAA,QAAQ,GAAG,IAAI,CAAC;AAE7B,4FAA4F;AAC/E,QAAA,iBAAiB,GAAG,KAAK,CAAC;AAkBvC,gEAAgE;AAChE,SAAgB,aAAa,CAAC,GAAgB;IAC1C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,oBAAY,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;AAClG,CAAC;AAED,uDAAuD;AACvD,SAAgB,WAAW,CAAC,GAAW;IACnC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,kBAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,mGAAmG;AACnG,SAAgB,YAAY,CAAC,IAAY;IACrC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;AACxD,CAAC"}

package/build/satellite.d.ts

@@ -0,0 +1,54 @@
+import type { SatelliteConfig } from './config';
+import type { SatelliteHost } from './index';
+export declare class Satellite {
+    private readonly cfg;
+    private readonly host;
+    private readonly log;
+    private socket;
+    private serverHost;
+    private serverPort;
+    private wakeword;
+    private mic;
+    private readonly backend;
+    private plingPcm;
+    private heartbeatTimer;
+    private micRemainder;
+    private pumping;
+    private micBytesLogged;
+    private wakeFrames;
+    private wakeMaxScore;
+    private wakeMaxRms;
+    private recording;
+    private silence;
+    private preBuffer;
+    private recFrames;
+    private recPeakRms;
+    private ttsChunks;
+    private ttsDiscard;
+    private registerResolve;
+    private running;
+    private heartbeatMisses;
+    private awaitingHeartbeatAck;
+    private reconnecting;
+    constructor(cfg: SatelliteConfig, host: SatelliteHost);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private resolveAddress;
+    private openSocket;
+    /** Register, retrying with exponential backoff until the adapter acknowledges (or we stop). */
+    private registerWithRetry;
+    /** Triggered when heartbeats stop being acknowledged: re-register (adapter probably restarted). */
+    private reconnect;
+    private heartbeatTick;
+    private register;
+    private onMicData;
+    private pump;
+    private handleFrame;
+    private startRecording;
+    private endRecording;
+    private onMessage;
+    private playTts;
+    private sendAudio;
+    private sendControl;
+    private setStatus;
+}