signalk-piper 0.0.1 → 0.2.0

package/dist/service.js

@@ -0,0 +1,596 @@
+/**
+ * PiperService — the plugin's whole runtime: managed container lifecycle,
+ * Wyoming describe readiness gate, periodic health loop, `wyoming-service`
+ * PropertyValues emission (with the family's emission discipline) and the
+ * plugin router endpoints.
+ *
+ * One instance lives for the whole server process (plugin routers cannot be
+ * deregistered); `start()`/`stop()` may run many times against it.
+ */
+import { ManagedContainer, errMsg, fetchWithTimeout, startSafely, } from "signalk-container-helper";
+import { DOWNLOAD_HINT, IMAGE, buildContainerConfig, isLowSampleRateVoice, isSemverTag, resolveSettings, resolveTag, } from "./config.js";
+import { describeService, isSupportedProtocolVersion } from "./wyoming.js";
+export const PLUGIN_ID = "signalk-piper";
+export const SERVICE_TYPE = "tts";
+export const NOTIFICATION_PATH = "notifications.voice.piper";
+/**
+ * Docker Hub tags listing feeding the config panel's version dropdown (same
+ * endpoint signalk-container's own dockerHubTags source uses; one page
+ * covers the dropdown's top-N plus the running-tag fallback).
+ */
+const TAGS_URL = `https://hub.docker.com/v2/repositories/${IMAGE}/tags/?page_size=25`;
+export const DEFAULT_TIMING = {
+    gateIntervalMs: 2_000,
+    gateDeadlineMs: 600_000,
+    gateStatusEveryMs: 15_000,
+    describeTimeoutMs: 5_000,
+    healthIntervalMs: 30_000,
+    healthFailThreshold: 3,
+    emitDebounceMs: 500,
+    flapWindowMs: 60_000,
+    flapMaxTransitions: 10,
+};
+export class PiperService {
+    container;
+    settings = resolveSettings(undefined);
+    app;
+    timing;
+    running = false;
+    /** Increments per start() so stale async work from a prior run is inert. */
+    runId = 0;
+    uri = null;
+    lastInfo = null;
+    lastHealth = null;
+    consecutiveFailures = 0;
+    probeInFlight = false;
+    /** True while an update apply recreates the container (pauses probes). */
+    updating = false;
+    healthTimer = null;
+    // Emission discipline state (reset per run).
+    currentStatus = null;
+    lastEmittedStatus = null;
+    lastEmittedUri = null;
+    lastEmitAt = 0;
+    pendingEmitTimer = null;
+    transitionTimes = [];
+    flapSuppressed = false;
+    emissionsDisabled = false;
+    constructor(app, timing = {}) {
+        this.app = app;
+        this.timing = { ...DEFAULT_TIMING, ...timing };
+        this.container = new ManagedContainer({
+            app,
+            pluginId: PLUGIN_ID,
+            name: "piper",
+            image: IMAGE,
+            defaultTag: "auto",
+            resolveTag,
+            // Reads this.settings so the one process-lifetime container instance
+            // follows config changes; still pure per (settings, tag).
+            buildConfig: (tag) => buildContainerConfig(this.settings, tag),
+            updates: {
+                versionSource: { dockerHubTags: IMAGE, filter: isSemverTag },
+            },
+            // No `readiness`: it is HTTP-only and Wyoming is raw TCP. Readiness is
+            // our own describe gate below.
+            ensureOptions: {
+                healthCheck: () => this.probeOk(),
+                onUnhealthy: (name, err) => {
+                    this.app.debug(`signalk-container reports ${name} unhealthy${err ? `: ${errMsg(err)}` : ""}`);
+                },
+            },
+        });
+    }
+    get isRunning() {
+        return this.running;
+    }
+    /** Called from the synchronous plugin start(). */
+    start(rawConfig) {
+        this.settings = resolveSettings(rawConfig);
+        this.running = true;
+        this.runId += 1;
+        this.uri = null;
+        this.lastInfo = null;
+        this.lastHealth = null;
+        this.consecutiveFailures = 0;
+        this.currentStatus = null;
+        this.lastEmittedStatus = null;
+        this.lastEmittedUri = null;
+        this.lastEmitAt = 0;
+        this.transitionTimes = [];
+        this.flapSuppressed = false;
+        this.emissionsDisabled = false;
+        const runId = this.runId;
+        startSafely(this.app, async () => {
+            await this.startAsync(runId);
+        });
+    }
+    /** Async server stop() — awaited by Signal K before a restart. */
+    async stop() {
+        this.running = false;
+        this.runId += 1;
+        this.stopHealthLoop();
+        try {
+            this.emit("stopped");
+        }
+        catch (err) {
+            this.app.debug(`stopped emission failed: ${errMsg(err)}`);
+        }
+        if (this.pendingEmitTimer !== null) {
+            clearTimeout(this.pendingEmitTimer);
+            this.pendingEmitTimer = null;
+        }
+        try {
+            await this.container.stop();
+        }
+        catch (err) {
+            this.app.debug(`container stop failed: ${errMsg(err)}`);
+        }
+        this.app.setPluginStatus("Stopped");
+    }
+    // ---------------------------------------------------------------------
+    // Startup flow
+    // ---------------------------------------------------------------------
+    async startAsync(runId) {
+        const { tag } = await this.container.start(this.settings.imageTag);
+        if (!this.active(runId)) {
+            // stop() ran while container.start() was still pulling/creating; its
+            // container.stop() was a no-op then, so the container may now be
+            // running with nobody monitoring it. A successor run owns the
+            // container when the plugin was merely restarted — only clean up when
+            // the plugin is actually stopped.
+            if (!this.running) {
+                try {
+                    await this.container.stop();
+                }
+                catch (err) {
+                    this.app.debug(`stopping the superseded container failed: ${errMsg(err)}`);
+                }
+            }
+            return;
+        }
+        this.app.setPluginStatus(`Starting ${IMAGE}:${tag} — first start downloads ${DOWNLOAD_HINT}`);
+        await this.becomeReady(tag, runId);
+    }
+    /**
+     * Resolve the service address, gate on Wyoming `describe`, go ready and
+     * start the health loop. Shared by first start and the post-update resume.
+     * A gate failure after the uri is known is surfaced loudly (spec §3.3:
+     * wyoming-service 'error' + notification alarm) and the health loop still
+     * starts, so eventual recovery is detected without a manual restart.
+     */
+    async becomeReady(tag, runId) {
+        const address = await this.resolveServiceAddress();
+        if (!this.active(runId))
+            return;
+        this.uri = `tcp://${address}`;
+        this.emit("starting");
+        try {
+            const ready = await this.describeGate(address, runId);
+            if (!this.active(runId) || ready === null)
+                return;
+            this.validateInfo(ready.info, ready.version);
+            this.validateVoice();
+            this.lastInfo = ready.info;
+            this.lastHealth = {
+                ok: true,
+                at: Date.now(),
+                latencyMs: ready.latencyMs,
+            };
+            this.consecutiveFailures = 0;
+            this.app.setPluginStatus(this.runningStatusLine(tag));
+            this.emit("ready");
+            this.notify("normal", "piper is ready");
+        }
+        catch (err) {
+            if (!this.active(runId))
+                return;
+            const message = errMsg(err);
+            this.app.setPluginError(message);
+            this.lastHealth = { ok: false, at: Date.now(), latencyMs: null };
+            // At the fail threshold already: the next successful probe takes the
+            // health loop's recovery branch (ready emission + normal notification).
+            this.consecutiveFailures = this.timing.healthFailThreshold;
+            this.emit("error");
+            this.notify("alarm", message);
+        }
+        this.startHealthLoop(address, tag, runId);
+    }
+    /**
+     * host:port of the Wyoming port. Default networking declares the port via
+     * signalkAccessiblePorts and must resolve; the explicit 0.0.0.0 publish
+     * ("bind") is not manager-resolvable, but is by definition reachable on
+     * the loopback of the host.
+     */
+    async resolveServiceAddress() {
+        if (this.settings.advanced.bind === "0.0.0.0") {
+            return `127.0.0.1:${this.settings.port}`;
+        }
+        const address = await this.container.resolveAddress(this.settings.port);
+        if (address === null) {
+            throw new Error(`could not resolve the piper container address for port ${this.settings.port}`);
+        }
+        return address;
+    }
+    /**
+     * Poll Wyoming `describe` until the service answers with `info` — which
+     * proves the model is downloaded and the service is actually serving.
+     * Returns null when the run was superseded while waiting.
+     */
+    async describeGate(address, runId) {
+        const { host, port } = splitAddress(address);
+        const startedAt = Date.now();
+        const deadline = startedAt + this.timing.gateDeadlineMs;
+        let lastProgressAt = startedAt;
+        let lastError;
+        for (;;) {
+            if (!this.active(runId))
+                return null;
+            try {
+                return await describeService(host, port, this.timing.describeTimeoutMs);
+            }
+            catch (err) {
+                lastError = errMsg(err);
+            }
+            if (Date.now() >= deadline) {
+                throw new Error(`piper did not become ready within ${Math.round(this.timing.gateDeadlineMs / 1000)}s (last error: ${lastError ?? "none"})`);
+            }
+            if (Date.now() - lastProgressAt >= this.timing.gateStatusEveryMs) {
+                lastProgressAt = Date.now();
+                const elapsedS = Math.round((Date.now() - startedAt) / 1000);
+                this.app.setPluginStatus(`Starting — waiting for piper to answer (${elapsedS}s; first start downloads ${DOWNLOAD_HINT})`);
+            }
+            await sleep(this.timing.gateIntervalMs);
+        }
+    }
+    validateInfo(info, version) {
+        if (version !== undefined && !isSupportedProtocolVersion(version)) {
+            this.app.error(`piper speaks Wyoming protocol ${version}, but this plugin targets 1.x — ` +
+                "continuing, but expect breakage until the plugin is updated");
+        }
+        const tts = Array.isArray(info.tts) ? info.tts : [];
+        if (tts.length === 0) {
+            this.app.error("piper's info response advertises no TTS programs — is the configured " +
+                "image really a Wyoming TTS service?");
+            return;
+        }
+        let voices = 0;
+        for (const program of tts) {
+            if (isObject(program) && Array.isArray(program.voices)) {
+                voices += program.voices.length;
+            }
+        }
+        this.app.debug(`piper is ready and advertises ${voices} voice(s)`);
+    }
+    /** Warn (loudly, once per start) about 16 kHz voices; never block. */
+    validateVoice() {
+        if (isLowSampleRateVoice(this.settings.voice)) {
+            this.app.error(`voice ${this.settings.voice} is a 16 kHz (-low/-x_low) voice; the ` +
+                "signalk-wyoming v1 family expects 22.05 kHz — use a -medium or " +
+                "-high voice");
+        }
+    }
+    runningStatusLine(tag) {
+        let line = `Running ${IMAGE}:${tag} at ${this.uri}`;
+        if (isLowSampleRateVoice(this.settings.voice)) {
+            line += ` — warning: voice ${this.settings.voice} is 16 kHz`;
+        }
+        return line;
+    }
+    // ---------------------------------------------------------------------
+    // Health loop
+    // ---------------------------------------------------------------------
+    startHealthLoop(address, tag, runId) {
+        this.stopHealthLoop();
+        this.healthTimer = setInterval(() => {
+            void this.healthProbe(address, tag, runId);
+        }, this.timing.healthIntervalMs);
+    }
+    stopHealthLoop() {
+        if (this.healthTimer !== null) {
+            clearInterval(this.healthTimer);
+            this.healthTimer = null;
+        }
+    }
+    async healthProbe(address, tag, runId) {
+        if (!this.active(runId) || this.probeInFlight || this.updating)
+            return;
+        this.probeInFlight = true;
+        const { host, port } = splitAddress(address);
+        try {
+            const result = await describeService(host, port, this.timing.describeTimeoutMs);
+            if (!this.active(runId))
+                return;
+            this.lastHealth = {
+                ok: true,
+                at: Date.now(),
+                latencyMs: result.latencyMs,
+            };
+            this.lastInfo = result.info;
+            const wasDown = this.consecutiveFailures >= this.timing.healthFailThreshold;
+            this.consecutiveFailures = 0;
+            if (wasDown) {
+                this.app.setPluginStatus(this.runningStatusLine(tag));
+                this.emit("ready");
+                this.notify("normal", "piper recovered");
+            }
+        }
+        catch (err) {
+            if (!this.active(runId))
+                return;
+            this.lastHealth = { ok: false, at: Date.now(), latencyMs: null };
+            this.consecutiveFailures += 1;
+            if (this.consecutiveFailures === this.timing.healthFailThreshold) {
+                const message = `piper is not answering at ${this.uri}: ${errMsg(err)}`;
+                this.app.setPluginError(message);
+                this.emit("error");
+                this.notify("alarm", message);
+            }
+        }
+        finally {
+            this.probeInFlight = false;
+        }
+    }
+    /** Boolean describe probe for signalk-container's recurring healthCheck. */
+    async probeOk() {
+        if (!this.running || this.uri === null)
+            return true;
+        const { host, port } = splitAddress(this.uri.replace("tcp://", ""));
+        try {
+            await describeService(host, port, this.timing.describeTimeoutMs);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    // ---------------------------------------------------------------------
+    // wyoming-service emission discipline (§3.1)
+    // ---------------------------------------------------------------------
+    /**
+     * Request an emission of `status`. Rules:
+     * - never emit the same (status, uri) pair twice in a row — a uri change
+     *   (post-update port move) re-emits even when the status is unchanged;
+     * - at most one emission per emitDebounceMs (later requests collapse into
+     *   the trailing timer, so a flap that settles back emits nothing);
+     * - >flapMaxTransitions transitions per flapWindowMs → warn and suppress;
+     * - omitted while the uri is unknown, except "stopped";
+     * - a throwing emitPropertyValue (server-wide PropertyValues cap) disables
+     *   all further emissions for this run;
+     * - "stopped" flushes immediately (stop() must not race the debounce).
+     */
+    emit(status) {
+        if (status !== this.currentStatus) {
+            this.currentStatus = status;
+            const now = Date.now();
+            this.transitionTimes.push(now);
+            this.transitionTimes = this.transitionTimes.filter((t) => now - t <= this.timing.flapWindowMs);
+            if (!this.flapSuppressed &&
+                this.transitionTimes.length > this.timing.flapMaxTransitions) {
+                this.flapSuppressed = true;
+                this.app.error(`wyoming-service status is flapping (>${this.timing.flapMaxTransitions} ` +
+                    `transitions in ${this.timing.flapWindowMs / 1000}s) — suppressing ` +
+                    "further emissions; health probes continue");
+            }
+        }
+        const flush = status === "stopped";
+        if (this.pendingEmitTimer !== null) {
+            if (!flush)
+                return; // the pending timer emits the latest status
+            clearTimeout(this.pendingEmitTimer);
+            this.pendingEmitTimer = null;
+        }
+        const wait = this.lastEmitAt + this.timing.emitDebounceMs - Date.now();
+        if (flush || wait <= 0) {
+            this.emitNow();
+            return;
+        }
+        this.pendingEmitTimer = setTimeout(() => {
+            this.pendingEmitTimer = null;
+            this.emitNow();
+        }, wait);
+    }
+    emitNow() {
+        const status = this.currentStatus;
+        if (status === null)
+            return;
+        if (status === this.lastEmittedStatus && this.uri === this.lastEmittedUri)
+            return;
+        if (this.emissionsDisabled)
+            return;
+        if (this.flapSuppressed && status !== "stopped")
+            return;
+        if (this.uri === null && status !== "stopped")
+            return;
+        try {
+            this.app.emitPropertyValue("wyoming-service", {
+                plugin: PLUGIN_ID,
+                type: SERVICE_TYPE,
+                uri: this.uri,
+                status,
+            });
+            this.lastEmittedStatus = status;
+            this.lastEmittedUri = this.uri;
+            this.lastEmitAt = Date.now();
+        }
+        catch (err) {
+            this.emissionsDisabled = true;
+            this.app.error("emitPropertyValue threw (server-wide PropertyValues cap reached?) — " +
+                `disabling wyoming-service emissions for this run: ${errMsg(err)}`);
+        }
+    }
+    notify(state, message) {
+        try {
+            this.app.handleMessage(PLUGIN_ID, {
+                updates: [
+                    {
+                        values: [
+                            {
+                                path: NOTIFICATION_PATH,
+                                value: { state, method: ["visual"], message },
+                            },
+                        ],
+                    },
+                ],
+            });
+        }
+        catch (err) {
+            this.app.debug(`notification delta failed: ${errMsg(err)}`);
+        }
+    }
+    // ---------------------------------------------------------------------
+    // Router
+    // ---------------------------------------------------------------------
+    /**
+     * The container was just recreated (and started) by an update apply: the
+     * host port can change and the new instance must answer `describe` before
+     * it is advertised again. Supersede the current run and re-run the
+     * readiness flow (resolve → gate → ready → health loop) against it.
+     */
+    resumeAfterUpdate(resolvedTag) {
+        if (!this.running)
+            return;
+        this.runId += 1;
+        const runId = this.runId;
+        this.stopHealthLoop();
+        this.lastInfo = null;
+        this.lastHealth = null;
+        this.consecutiveFailures = 0;
+        startSafely(this.app, async () => {
+            this.app.setPluginStatus(`Starting ${IMAGE}:${resolvedTag} — waiting for piper after the update`);
+            await this.becomeReady(resolvedTag, runId);
+        });
+    }
+    /**
+     * Mount plugin routes. Called once per server process (even while the
+     * plugin is disabled), so every handler checks the running flag.
+     */
+    registerRoutes(router, rawOptionsForSave) {
+        // registerWithRouter outlives stop(): the update routes must refuse to
+        // act while the plugin is not running — a stray apply would otherwise
+        // start a container nobody monitors and clobber the saved configuration.
+        const guardRunning = (res) => {
+            if (this.running)
+                return true;
+            res.status(503).json({ error: "plugin is not running" });
+            return false;
+        };
+        const guarded = {
+            get: (path, handler) => router.get(path, (req, res) => {
+                if (!guardRunning(res))
+                    return;
+                return handler(req, res);
+            }),
+            post: (path, handler) => router.post(path, async (req, res) => {
+                if (!guardRunning(res))
+                    return;
+                // Pause health probes while the apply recreates the container so
+                // a slow image pull cannot fire a spurious offline alarm.
+                this.updating = true;
+                try {
+                    return await handler(req, res);
+                }
+                finally {
+                    this.updating = false;
+                }
+            }),
+        };
+        this.container.registerUpdateRoutes(guarded, {
+            onApplied: (requestedTag, resolvedTag) => {
+                const raw = rawOptionsForSave();
+                if (isObject(raw)) {
+                    this.app.savePluginOptions({ ...raw, imageTag: requestedTag }, (err) => {
+                        if (err) {
+                            this.app.error(`failed to persist image tag: ${errMsg(err)}`);
+                        }
+                    });
+                }
+                else {
+                    // Never replace the whole saved configuration with just the tag.
+                    this.app.error("not persisting the image tag: the saved plugin options are not " +
+                        "known in this process");
+                }
+                this.settings = { ...this.settings, imageTag: requestedTag };
+                this.resumeAfterUpdate(resolvedTag);
+            },
+        });
+        // readonly when the server supports per-route access levels;
+        // admin-only otherwise (feature-detect).
+        const access = router
+            .access;
+        const statusRouter = typeof access === "function" ? access.call(router, "readonly") : router;
+        statusRouter.get("/api/status", (_req, res) => {
+            if (!this.running) {
+                res.status(503).json({ error: "plugin is not running" });
+                return;
+            }
+            void this.container.getState().then((containerState) => {
+                res.json({
+                    status: this.currentStatus ?? "starting",
+                    uri: this.uri,
+                    tag: this.container.lastStartedTag ?? this.settings.imageTag,
+                    containerState,
+                    lastHealth: this.lastHealth,
+                    info: this.lastInfo,
+                });
+            });
+        });
+        // Version-dropdown feed for the config panel. Deliberately not guarded
+        // by the running flag: the operator picks a tag while the plugin is
+        // still disabled, and the route only reaches out on demand.
+        statusRouter.get("/api/versions", (_req, res) => {
+            void (async () => {
+                try {
+                    const response = await fetchWithTimeout(TAGS_URL, {
+                        timeoutMs: 10_000,
+                    });
+                    if (!response.ok) {
+                        res
+                            .status(502)
+                            .json({ error: `Docker Hub answered HTTP ${response.status}` });
+                        return;
+                    }
+                    const body = (await response.json());
+                    const versions = (Array.isArray(body.results) ? body.results : [])
+                        .map((r) => (typeof r?.name === "string" ? r.name : ""))
+                        .filter(isSemverTag)
+                        .sort(compareSemverDesc)
+                        .map((tag) => ({ tag }));
+                    res.json({ versions });
+                }
+                catch (err) {
+                    res.status(502).json({ error: errMsg(err) });
+                }
+            })();
+        });
+    }
+    // ---------------------------------------------------------------------
+    active(runId) {
+        return this.running && runId === this.runId;
+    }
+}
+/** Numeric-descending compare for the plain x.y.z tags isSemverTag admits. */
+function compareSemverDesc(a, b) {
+    const pa = a.split(".").map(Number);
+    const pb = b.split(".").map(Number);
+    for (let i = 0; i < 3; i += 1) {
+        const d = (pb[i] ?? 0) - (pa[i] ?? 0);
+        if (d !== 0)
+            return d;
+    }
+    return 0;
+}
+function splitAddress(address) {
+    const idx = address.lastIndexOf(":");
+    return {
+        host: address.slice(0, idx),
+        port: Number(address.slice(idx + 1)),
+    };
+}
+function isObject(v) {
+    return v !== null && typeof v === "object" && !Array.isArray(v);
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

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

package/dist/wyoming.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Minimal self-contained Wyoming `describe` client.
+ *
+ * Deliberately embedded (no runtime dependency on the signalk-wyoming
+ * orchestrator package): connects, writes a header-only `describe` event and
+ * incrementally decodes events until an `info` event arrives, then resolves
+ * with its parsed data.
+ *
+ * Wire format (rhasspy/wyoming): one JSON header line terminated by "\n"
+ * with optional `data_length`/`payload_length` byte counts, followed by that
+ * many bytes of JSON data and binary payload. Non-`info` events are consumed
+ * and skipped.
+ */
+export interface DescribeResult {
+    /** Parsed `info` event data (asr/tts/wake/... program lists). */
+    info: Record<string, unknown>;
+    /** Wyoming protocol version from the `info` header, when present. */
+    version?: string;
+    /** Round-trip time from connect to a complete `info` event. */
+    latencyMs: number;
+}
+/**
+ * Send `describe` to a Wyoming service and await its `info` response.
+ * Rejects on connection failure, malformed frames or timeout.
+ */
+export declare function describeService(host: string, port: number, timeoutMs?: number): Promise<DescribeResult>;
+/** True when a Wyoming protocol version string is in the supported 1.x range. */
+export declare function isSupportedProtocolVersion(version: string): boolean;
+//# sourceMappingURL=wyoming.d.ts.map

package/dist/wyoming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wyoming.d.ts","sourceRoot":"","sources":["../src/wyoming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;CACnB;AAKD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,SAAS,SAAqB,GAC7B,OAAO,CAAC,cAAc,CAAC,CA+FzB;AAED,iFAAiF;AACjF,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEnE"}