@moxxy/plugin-tts-local 0.28.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Moxxy (moxxy.ai)
+
+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/dist/host-client.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Parent-side manager for the sherpa sidecar: lazy-spawn on first synthesize,
+ * a correlated request/reply protocol over the fork IPC channel, restart-once
+ * on a crash, and a clean shutdown. The `fork` itself is injectable (a
+ * {@link ForkLike}) so tests drive the whole protocol against a fake child with
+ * no real process.
+ */
+import type { HostRequest } from './host-protocol.js';
+/** The minimal child-process surface the client drives — satisfied by a real
+ *  `ChildProcess` and by a test fake. */
+export interface ChildHandle {
+    send(message: unknown): boolean;
+    on(event: 'message', listener: (message: unknown) => void): this;
+    on(event: 'exit', listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
+    on(event: 'error', listener: (err: Error) => void): this;
+    kill(signal?: NodeJS.Signals): boolean;
+}
+/** Fork the sidecar with the given env overrides. Injectable for tests. */
+export type ForkLike = (modulePath: string, env: NodeJS.ProcessEnv) => ChildHandle;
+/** Default fork: advanced serialization (Float32Array round-trip), an IPC
+ *  channel, and inherited std streams so sherpa's own diagnostics reach the
+ *  runner log. `env` already carries the platform loader-path var. */
+export declare const defaultFork: ForkLike;
+export interface HostClientOptions {
+    /** Absolute path to the built sidecar (`dist/sidecar.js`). */
+    readonly hostPath: string;
+    /** Env the child is forked with (platform loader path merged over process.env). */
+    readonly env: NodeJS.ProcessEnv;
+    /** Injected fork (tests). Defaults to {@link defaultFork}. */
+    readonly forkImpl?: ForkLike;
+    /** Per-request deadline. Default 120s (a long read-aloud on CPU). */
+    readonly requestTimeoutMs?: number;
+    /** Optional diagnostic sink. */
+    readonly log?: (msg: string) => void;
+}
+/** The slice of a host the synthesizer depends on — lets tests swap a fake. */
+export interface HostClientLike {
+    synthesize(req: Omit<HostRequest, 'id' | 'type'>): Promise<{
+        samples: Float32Array;
+        sampleRate: number;
+    }>;
+    shutdown(): void;
+}
+/** Raised when the sidecar dies with a request in flight; drives the one retry. */
+export declare class HostCrashError extends Error {
+    constructor(message: string);
+}
+export declare class HostClient implements HostClientLike {
+    private readonly hostPath;
+    private readonly env;
+    private readonly forkImpl;
+    private readonly timeoutMs;
+    private readonly log;
+    private child;
+    private readonly pending;
+    private nextId;
+    private disposed;
+    constructor(opts: HostClientOptions);
+    /** Synthesize, restarting the sidecar ONCE if it crashes mid-request. */
+    synthesize(req: Omit<HostRequest, 'id' | 'type'>): Promise<{
+        samples: Float32Array;
+        sampleRate: number;
+    }>;
+    private send;
+    private ensureChild;
+    private onMessage;
+    private onExit;
+    private onError;
+    /** Resolve/reject one pending request, clearing its timer and map entry. */
+    private settle;
+    private rejectAll;
+    private killChild;
+    /** Kill the sidecar and fail any in-flight requests. Idempotent. */
+    shutdown(): void;
+}
+//# sourceMappingURL=host-client.d.ts.map

package/dist/host-client.d.ts.map

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

package/dist/host-client.js

@@ -0,0 +1,154 @@
+/**
+ * Parent-side manager for the sherpa sidecar: lazy-spawn on first synthesize,
+ * a correlated request/reply protocol over the fork IPC channel, restart-once
+ * on a crash, and a clean shutdown. The `fork` itself is injectable (a
+ * {@link ForkLike}) so tests drive the whole protocol against a fake child with
+ * no real process.
+ */
+import { fork } from 'node:child_process';
+/** Default fork: advanced serialization (Float32Array round-trip), an IPC
+ *  channel, and inherited std streams so sherpa's own diagnostics reach the
+ *  runner log. `env` already carries the platform loader-path var. */
+export const defaultFork = (modulePath, env) => fork(modulePath, [], {
+    serialization: 'advanced',
+    env,
+    execArgv: [],
+    stdio: ['ignore', 'inherit', 'inherit', 'ipc'],
+});
+/** Raised when the sidecar dies with a request in flight; drives the one retry. */
+export class HostCrashError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'HostCrashError';
+    }
+}
+const DEFAULT_TIMEOUT_MS = 120_000;
+export class HostClient {
+    hostPath;
+    env;
+    forkImpl;
+    timeoutMs;
+    log;
+    child = null;
+    pending = new Map();
+    nextId = 1;
+    disposed = false;
+    constructor(opts) {
+        this.hostPath = opts.hostPath;
+        this.env = opts.env;
+        this.forkImpl = opts.forkImpl ?? defaultFork;
+        this.timeoutMs = opts.requestTimeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.log = opts.log ?? (() => { });
+    }
+    /** Synthesize, restarting the sidecar ONCE if it crashes mid-request. */
+    async synthesize(req) {
+        try {
+            return await this.send(req);
+        }
+        catch (err) {
+            if (err instanceof HostCrashError && !this.disposed) {
+                this.log(`tts-local: sherpa sidecar crashed (${err.message}) — restarting once`);
+                return await this.send(req); // a second crash propagates
+            }
+            throw err;
+        }
+    }
+    send(req) {
+        if (this.disposed)
+            return Promise.reject(new Error('tts-local host is shut down'));
+        const child = this.ensureChild();
+        const id = this.nextId++;
+        const message = { ...req, id, type: 'synthesize' };
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                // A hung synthesis is unrecoverable for this child — reset it so the
+                // next call starts fresh.
+                this.killChild();
+                reject(new Error(`tts-local synthesis timed out after ${this.timeoutMs} ms`));
+            }, this.timeoutMs);
+            timer.unref?.();
+            this.pending.set(id, { resolve, reject, timer });
+            try {
+                child.send(message);
+            }
+            catch (err) {
+                this.settle(id, () => reject(err instanceof Error ? err : new Error(String(err))));
+            }
+        });
+    }
+    ensureChild() {
+        if (this.child)
+            return this.child;
+        const child = this.forkImpl(this.hostPath, this.env);
+        this.child = child;
+        child.on('message', (msg) => this.onMessage(msg));
+        child.on('exit', (code, signal) => this.onExit(code, signal));
+        child.on('error', (err) => this.onError(err));
+        return child;
+    }
+    onMessage(msg) {
+        const reply = msg;
+        if (!reply || typeof reply !== 'object' || typeof reply.id !== 'number')
+            return;
+        const p = this.pending.get(reply.id);
+        if (!p)
+            return;
+        this.settle(reply.id, () => {
+            if (reply.ok)
+                p.resolve({ samples: reply.samples, sampleRate: reply.sampleRate });
+            else
+                p.reject(new Error(`tts-local sidecar ${reply.error.kind} error: ${reply.error.message}`));
+        });
+    }
+    onExit(code, signal) {
+        this.child = null;
+        if (this.pending.size === 0)
+            return;
+        const why = `sidecar exited (code=${code ?? 'null'}, signal=${signal ?? 'null'})`;
+        this.rejectAll(new HostCrashError(why));
+    }
+    onError(err) {
+        this.child = null;
+        this.rejectAll(new HostCrashError(`sidecar spawn/runtime error: ${err.message}`));
+    }
+    /** Resolve/reject one pending request, clearing its timer and map entry. */
+    settle(id, run) {
+        const p = this.pending.get(id);
+        if (!p)
+            return;
+        if (p.timer)
+            clearTimeout(p.timer);
+        this.pending.delete(id);
+        run();
+    }
+    rejectAll(err) {
+        for (const [id, p] of this.pending) {
+            if (p.timer)
+                clearTimeout(p.timer);
+            this.pending.delete(id);
+            p.reject(err);
+        }
+    }
+    killChild() {
+        const child = this.child;
+        this.child = null;
+        if (child) {
+            try {
+                child.kill('SIGKILL');
+            }
+            catch {
+                /* already gone */
+            }
+        }
+    }
+    /** Kill the sidecar and fail any in-flight requests. Idempotent. */
+    shutdown() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.rejectAll(new Error('tts-local host shut down'));
+        this.killChild();
+    }
+}
+//# sourceMappingURL=host-client.js.map

package/dist/host-client.js.map

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

package/dist/host-protocol.d.ts

@@ -0,0 +1,84 @@
+/**
+ * The tiny JSON message protocol spoken between the parent (host-client) and
+ * the forked sherpa sidecar, plus the pure per-message handler the sidecar
+ * runs. Kept free of `node:child_process` so BOTH sides can import it (the
+ * parent for the types, the child for the handler) without dragging fork
+ * plumbing into either bundle.
+ *
+ * Wire shape (over the fork IPC channel, `serialization: 'advanced'` so the
+ * Float32Array round-trips intact):
+ *   parent → child:  SynthesizeRequest
+ *   child  → parent: HostReply
+ */
+/** One synthesis request. Carries the full model config so the sidecar is
+ *  stateless-per-message except for a model cache keyed by `voiceKey`. */
+export interface SynthesizeRequest {
+    readonly id: number;
+    readonly type: 'synthesize';
+    /** Cache key for the loaded model (the absolute `.onnx` path). */
+    readonly voiceKey: string;
+    /** Absolute path to the VITS `.onnx` model. */
+    readonly model: string;
+    /** Absolute path to `tokens.txt`. */
+    readonly tokens: string;
+    /** Absolute path to the `espeak-ng-data` directory. */
+    readonly dataDir: string;
+    /** Inference thread count. */
+    readonly numThreads: number;
+    /** Compute provider (`cpu`). */
+    readonly provider: string;
+    /** Text to speak. */
+    readonly text: string;
+    /** Speaker id within the model (0 for single-speaker Piper voices). */
+    readonly sid: number;
+    /** Speaking-rate multiplier already clamped by the caller. */
+    readonly speed: number;
+}
+export type HostRequest = SynthesizeRequest;
+export type HostErrorKind = 
+/** Model failed to load (bad/absent files, unsupported arch, addon dlopen). */
+'init'
+/** Synthesis itself threw. */
+ | 'runtime';
+export type HostReply = {
+    readonly id: number;
+    readonly ok: true;
+    readonly sampleRate: number;
+    /** Mono PCM in [-1, 1]; structured-cloned intact over advanced IPC. */
+    readonly samples: Float32Array;
+} | {
+    readonly id: number;
+    readonly ok: false;
+    readonly error: {
+        readonly message: string;
+        readonly kind: HostErrorKind;
+    };
+};
+/** The subset of the sherpa-onnx-node surface the sidecar uses. Declared here
+ *  (rather than leaning on the addon's ambient types) so the handler is
+ *  unit-testable with a fake module and typechecks without the native addon. */
+export interface SherpaOfflineTts {
+    generateAsync(args: {
+        text: string;
+        sid: number;
+        speed: number;
+    }): Promise<{
+        samples: Float32Array;
+        sampleRate: number;
+    }>;
+}
+export interface SherpaModule {
+    OfflineTts: new (config: unknown) => SherpaOfflineTts;
+}
+/** Lazily load the native sherpa module (so a dlopen failure surfaces as a
+ *  classified reply, not a boot crash). */
+export type LoadSherpa = () => SherpaModule;
+export type HostMessageHandler = (req: HostRequest) => Promise<HostReply>;
+/**
+ * Build the sidecar's message handler. Loads the sherpa module on first use and
+ * caches one `OfflineTts` per `voiceKey` so repeated calls on the same voice
+ * reuse the loaded model. Every failure becomes a typed `ok:false` reply —
+ * nothing throws out of `handle`.
+ */
+export declare function createMessageHandler(loadSherpa: LoadSherpa): HostMessageHandler;
+//# sourceMappingURL=host-protocol.d.ts.map

package/dist/host-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-protocol.d.ts","sourceRoot":"","sources":["../src/host-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;0EAC0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,8BAA8B;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,gCAAgC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,qBAAqB;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAE5C,MAAM,MAAM,aAAa;AACvB,+EAA+E;AAC7E,MAAM;AACR,8BAA8B;GAC5B,SAAS,CAAC;AAEd,MAAM,MAAM,SAAS,GACjB;IACE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;CAChC,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;KAAE,CAAC;CAC5E,CAAC;AAEN;;gFAEgF;AAChF,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,IAAI,EAAE;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,YAAY,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,KAAK,MAAM,EAAE,OAAO,KAAK,gBAAgB,CAAC;CACvD;AAED;2CAC2C;AAC3C,MAAM,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC;AAE5C,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;AAE1E;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,GAAG,kBAAkB,CAmC/E"}

package/dist/host-protocol.js

@@ -0,0 +1,57 @@
+/**
+ * The tiny JSON message protocol spoken between the parent (host-client) and
+ * the forked sherpa sidecar, plus the pure per-message handler the sidecar
+ * runs. Kept free of `node:child_process` so BOTH sides can import it (the
+ * parent for the types, the child for the handler) without dragging fork
+ * plumbing into either bundle.
+ *
+ * Wire shape (over the fork IPC channel, `serialization: 'advanced'` so the
+ * Float32Array round-trips intact):
+ *   parent → child:  SynthesizeRequest
+ *   child  → parent: HostReply
+ */
+/**
+ * Build the sidecar's message handler. Loads the sherpa module on first use and
+ * caches one `OfflineTts` per `voiceKey` so repeated calls on the same voice
+ * reuse the loaded model. Every failure becomes a typed `ok:false` reply —
+ * nothing throws out of `handle`.
+ */
+export function createMessageHandler(loadSherpa) {
+    const cache = new Map();
+    let mod = null;
+    return async function handle(req) {
+        let tts = cache.get(req.voiceKey);
+        if (!tts) {
+            try {
+                mod ??= loadSherpa();
+                tts = new mod.OfflineTts({
+                    model: {
+                        vits: { model: req.model, tokens: req.tokens, dataDir: req.dataDir },
+                        numThreads: req.numThreads,
+                        provider: req.provider,
+                        debug: false,
+                    },
+                    maxNumSentences: 1,
+                });
+                cache.set(req.voiceKey, tts);
+            }
+            catch (err) {
+                return { id: req.id, ok: false, error: { message: errMsg(err), kind: 'init' } };
+            }
+        }
+        try {
+            const out = await tts.generateAsync({ text: req.text, sid: req.sid, speed: req.speed });
+            const samples = out.samples instanceof Float32Array
+                ? out.samples
+                : Float32Array.from(out.samples);
+            return { id: req.id, ok: true, sampleRate: out.sampleRate, samples };
+        }
+        catch (err) {
+            return { id: req.id, ok: false, error: { message: errMsg(err), kind: 'runtime' } };
+        }
+    };
+}
+function errMsg(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=host-protocol.js.map

package/dist/host-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-protocol.js","sourceRoot":"","sources":["../src/host-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAsEH;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAsB;IACzD,MAAM,KAAK,GAAG,IAAI,GAAG,EAA4B,CAAC;IAClD,IAAI,GAAG,GAAwB,IAAI,CAAC;IAEpC,OAAO,KAAK,UAAU,MAAM,CAAC,GAAgB;QAC3C,IAAI,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,IAAI,CAAC;gBACH,GAAG,KAAK,UAAU,EAAE,CAAC;gBACrB,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC;oBACvB,KAAK,EAAE;wBACL,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE;wBACpE,UAAU,EAAE,GAAG,CAAC,UAAU;wBAC1B,QAAQ,EAAE,GAAG,CAAC,QAAQ;wBACtB,KAAK,EAAE,KAAK;qBACb;oBACD,eAAe,EAAE,CAAC;iBACnB,CAAC,CAAC;gBACH,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YAC/B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;YAClF,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;YACxF,MAAM,OAAO,GACX,GAAG,CAAC,OAAO,YAAY,YAAY;gBACjC,CAAC,CAAC,GAAG,CAAC,OAAO;gBACb,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,OAA4B,CAAC,CAAC;YAC1D,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC;QACvE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC;QACrF,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,GAAY;IAC1B,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+import { type Plugin } from '@moxxy/sdk';
+import { type LocalPiperOptions } from './local-tts.js';
+export { LocalPiperSynthesizer, createLocalPiperSynthesizer, clampSpeed, shutdownLocalTts, LOCAL_PIPER_SYNTHESIZER_NAME, type LocalPiperOptions, type VoiceModelPaths, } from './local-tts.js';
+export { encodeWav, WAV_HEADER_BYTES } from './wav.js';
+export { VOICE_CATALOG, voiceIds, findVoice, routeVoice, requireVoice, DEFAULT_VOICE_ID, DEFAULT_POLISH_VOICE_ID, type VoiceEntry, type VoiceLanguage, } from './voices.js';
+export { HostClient, type HostClientLike, type ForkLike, type ChildHandle } from './host-client.js';
+export { sherpaPlatformPackage, resolveSherpaLibDir, sherpaEnv, libraryPathVar, } from './platform.js';
+export interface BuildLocalTtsPluginOptions {
+    /** Build-time defaults / test seams for the synthesizer (injected
+     *  `ensureModelImpl`, `hostFactory`, `fetchImpl`, `modelsDir`, `log`). */
+    readonly defaults?: LocalPiperOptions;
+}
+/**
+ * Build the @moxxy/plugin-tts-local plugin. Registers exactly one synthesizer,
+ * `local-piper`, backed by sherpa-onnx Piper voices running in a forked
+ * sidecar. Side-effect free at load: no model is downloaded and no process is
+ * spawned until the first `synthesize`. Per-activation config
+ * (`session.synthesizers.setActive('local-piper', { voice, polishVoice,
+ * numThreads })`) overrides the build-time defaults.
+ */
+export declare function buildLocalTtsPlugin(opts?: BuildLocalTtsPluginOptions): Plugin;
+declare const _default: Plugin;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAE1E,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,UAAU,EACV,gBAAgB,EAChB,4BAA4B,EAC5B,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EACL,aAAa,EACb,QAAQ,EACR,SAAS,EACT,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,uBAAuB,EACvB,KAAK,UAAU,EACf,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,KAAK,cAAc,EAAE,KAAK,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpG,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,SAAS,EACT,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,0BAA0B;IACzC;8EAC0E;IAC1E,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,0BAA+B,GAAG,MAAM,CAkBjF;;AAmBD,wBAAqC"}

package/dist/index.js

@@ -0,0 +1,52 @@
+import { definePlugin, defineSynthesizer } from '@moxxy/sdk';
+import { createLocalPiperSynthesizer, LOCAL_PIPER_SYNTHESIZER_NAME, shutdownLocalTts, } from './local-tts.js';
+export { LocalPiperSynthesizer, createLocalPiperSynthesizer, clampSpeed, shutdownLocalTts, LOCAL_PIPER_SYNTHESIZER_NAME, } from './local-tts.js';
+export { encodeWav, WAV_HEADER_BYTES } from './wav.js';
+export { VOICE_CATALOG, voiceIds, findVoice, routeVoice, requireVoice, DEFAULT_VOICE_ID, DEFAULT_POLISH_VOICE_ID, } from './voices.js';
+export { HostClient } from './host-client.js';
+export { sherpaPlatformPackage, resolveSherpaLibDir, sherpaEnv, libraryPathVar, } from './platform.js';
+/**
+ * Build the @moxxy/plugin-tts-local plugin. Registers exactly one synthesizer,
+ * `local-piper`, backed by sherpa-onnx Piper voices running in a forked
+ * sidecar. Side-effect free at load: no model is downloaded and no process is
+ * spawned until the first `synthesize`. Per-activation config
+ * (`session.synthesizers.setActive('local-piper', { voice, polishVoice,
+ * numThreads })`) overrides the build-time defaults.
+ */
+export function buildLocalTtsPlugin(opts = {}) {
+    const defaults = opts.defaults ?? {};
+    return definePlugin({
+        name: '@moxxy/plugin-tts-local',
+        version: '0.0.0',
+        synthesizers: [
+            defineSynthesizer({
+                name: LOCAL_PIPER_SYNTHESIZER_NAME,
+                displayName: 'Local (Piper — offline, EN+PL)',
+                // `create` runs lazily and may re-run (buildOnRead) — keep it cheap and
+                // side-effect free; the sidecar + download happen on first synthesize.
+                create: (ctx) => createLocalPiperSynthesizer({ ...defaults, ...configToOptions(ctx.config) }),
+            }),
+        ],
+        // Kill every spawned sidecar when the session/runner shuts down.
+        hooks: { onShutdown: () => shutdownLocalTts() },
+    });
+}
+/** Narrow the untrusted per-activation config into typed options — only the
+ *  known string `voice` / `polishVoice` and a positive-integer `numThreads` are
+ *  honored so a malformed config can't break `create` or route to a bad voice
+ *  (unknown ids are caught by `requireVoice` at construction). */
+function configToOptions(config) {
+    const out = {};
+    if (typeof config.voice === 'string' && config.voice)
+        out.voice = config.voice;
+    if (typeof config.polishVoice === 'string' && config.polishVoice) {
+        out.polishVoice = config.polishVoice;
+    }
+    if (typeof config.numThreads === 'number' && Number.isInteger(config.numThreads) && config.numThreads > 0) {
+        out.numThreads = config.numThreads;
+    }
+    return out;
+}
+// Discovery entry: `createPluginLoader` requires a default Plugin export.
+export default buildLocalTtsPlugin();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAe,MAAM,YAAY,CAAC;AAE1E,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,gBAAgB,GAEjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,UAAU,EACV,gBAAgB,EAChB,4BAA4B,GAG7B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EACL,aAAa,EACb,QAAQ,EACR,SAAS,EACT,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,uBAAuB,GAGxB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAwD,MAAM,kBAAkB,CAAC;AACpG,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,SAAS,EACT,cAAc,GACf,MAAM,eAAe,CAAC;AAQvB;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAmC,EAAE;IACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;IACrC,OAAO,YAAY,CAAC;QAClB,IAAI,EAAE,yBAAyB;QAC/B,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE;YACZ,iBAAiB,CAAC;gBAChB,IAAI,EAAE,4BAA4B;gBAClC,WAAW,EAAE,gCAAgC;gBAC7C,wEAAwE;gBACxE,uEAAuE;gBACvE,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CACd,2BAA2B,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;aAC/E,CAAC;SACH;QACD,iEAAiE;QACjE,KAAK,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,gBAAgB,EAAE,EAAE;KAChD,CAAC,CAAC;AACL,CAAC;AAED;;;kEAGkE;AAClE,SAAS,eAAe,CAAC,MAA+B;IACtD,MAAM,GAAG,GAAwE,EAAE,CAAC;IACpF,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK;QAAE,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC/E,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACjE,GAAG,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACvC,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;QAC1G,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACrC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,0EAA0E;AAC1E,eAAe,mBAAmB,EAAE,CAAC"}

package/dist/local-tts.d.ts

@@ -0,0 +1,87 @@
+/**
+ * The `local-piper` Synthesizer: fully local, on-device text-to-speech.
+ *
+ * On the first synthesis for a voice it downloads + verifies that voice's Piper
+ * model (once, via @moxxy/model-fetch), then hands text to the sherpa sidecar
+ * ({@link HostClient}) and wraps the returned samples as WAV. No key, no network
+ * at synthesis time. Language routing sends `pl*` requests to the configured
+ * Polish voice; an explicit `opts.voice` (a catalog id) overrides everything.
+ *
+ * Every collaborator is injectable (`ensureModelImpl`, `hostFactory`, `log`,
+ * `modelsDir`, `fetchImpl`) so the whole flow is unit-testable without the
+ * native addon or a real download.
+ */
+import { type SynthesizeOptions, type SynthesisResult, type Synthesizer } from '@moxxy/sdk';
+import { ensureModel, type FetchLike } from '@moxxy/model-fetch';
+import { type HostClientLike } from './host-client.js';
+/** The single registered synthesizer name — surfaces show this in `set_voice`. */
+export declare const LOCAL_PIPER_SYNTHESIZER_NAME = "local-piper";
+/** Map a `SynthesizeOptions.rate` multiplier onto sherpa's `speed`, clamped.
+ *  An absent / non-finite rate yields 1.0 (natural speed). */
+export declare function clampSpeed(rate: number | undefined): number;
+/** Resolved on-disk paths sherpa needs for one voice. */
+export interface VoiceModelPaths {
+    readonly model: string;
+    readonly tokens: string;
+    readonly dataDir: string;
+}
+export interface LocalPiperOptions {
+    /** Default (non-Polish) voice id. Default `en_US-amy-medium`. */
+    readonly voice?: string;
+    /** Voice used for `pl*` language requests. Default `pl_PL-gosia-medium`. */
+    readonly polishVoice?: string;
+    /** Inference threads. Default 2. */
+    readonly numThreads?: number;
+    /** Root for downloaded voices. Default `~/.moxxy/models/tts` (MOXXY_HOME-aware). */
+    readonly modelsDir?: string;
+    /** sherpa compute provider. Default `cpu`. */
+    readonly provider?: string;
+    /** Absolute path to the built sidecar entry. Default: `sidecar.js` beside
+     *  this module (i.e. `dist/sidecar.js` in a published build). Overridable so
+     *  the source-run live test can point at the compiled sidecar. */
+    readonly sidecarPath?: string;
+    /** Injected model-ensure (tests). Defaults to @moxxy/model-fetch `ensureModel`. */
+    readonly ensureModelImpl?: typeof ensureModel;
+    /** Injected `fetch`, threaded into `ensureModel` (tests). */
+    readonly fetchImpl?: FetchLike;
+    /** Injected sidecar host factory (tests). Defaults to a real {@link HostClient}. */
+    readonly hostFactory?: () => HostClientLike;
+    /** Diagnostic log sink (download progress etc.). Defaults to stderr. */
+    readonly log?: (msg: string) => void;
+}
+/** Shut down every live local synthesizer (kills their sidecars). */
+export declare function shutdownLocalTts(): void;
+export declare class LocalPiperSynthesizer implements Synthesizer {
+    readonly name = "local-piper";
+    readonly mimeType = "audio/wav";
+    private readonly voiceId;
+    private readonly polishVoiceId;
+    private readonly numThreads;
+    private readonly modelsDir;
+    private readonly provider;
+    private readonly sidecarPath;
+    private readonly ensureModelImpl;
+    private readonly fetchImpl;
+    private readonly hostFactory;
+    private readonly log;
+    private host;
+    /** In-flight per-voice download promises — de-dupes concurrent first-use. */
+    private readonly ensuring;
+    constructor(opts?: LocalPiperOptions);
+    synthesize(text: string, opts?: SynthesizeOptions): Promise<SynthesisResult>;
+    /** Kill this synthesizer's sidecar (if any) and drop registration. */
+    shutdown(): void;
+    private getHost;
+    /** Resolve on-disk paths for `voice`, downloading + extracting it once. */
+    private ensureVoice;
+    private voicePaths;
+    /** A progress callback that logs a single start line then ~every-10% ticks,
+     *  and an extraction line — but stays silent when the voice is already
+     *  present (ensureModel emits only `done`). */
+    private makeProgressLogger;
+    /** Build a real sidecar-backed host, resolving the platform loader path.
+     *  Fails clearly when no sherpa binary exists for this platform/arch. */
+    private defaultHost;
+}
+export declare function createLocalPiperSynthesizer(opts?: LocalPiperOptions): LocalPiperSynthesizer;
+//# sourceMappingURL=local-tts.d.ts.map

package/dist/local-tts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-tts.d.ts","sourceRoot":"","sources":["../src/local-tts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAAc,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAExG,OAAO,EACL,WAAW,EAGX,KAAK,SAAS,EACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAWnE,kFAAkF;AAClF,eAAO,MAAM,4BAA4B,gBAAgB,CAAC;AAO1D;8DAC8D;AAC9D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG3D;AAED,yDAAyD;AACzD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,oCAAoC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,oFAAoF;IACpF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;sEAEkE;IAClE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,WAAW,CAAC;IAC9C,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,oFAAoF;IACpF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,cAAc,CAAC;IAC5C,wEAAwE;IACxE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAMD,qEAAqE;AACrE,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC;AAED,qBAAa,qBAAsB,YAAW,WAAW;IACvD,QAAQ,CAAC,IAAI,iBAAgC;IAC7C,QAAQ,CAAC,QAAQ,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;IACnD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAwB;IAE5C,OAAO,CAAC,IAAI,CAA+B;IAC3C,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiD;gBAE9D,IAAI,GAAE,iBAAsB;IAmBlC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IAmCtF,sEAAsE;IACtE,QAAQ,IAAI,IAAI;IAMhB,OAAO,CAAC,OAAO;IAKf,2EAA2E;YAC7D,WAAW;IAoBzB,OAAO,CAAC,UAAU;IASlB;;mDAE+C;IAC/C,OAAO,CAAC,kBAAkB;IA4B1B;6EACyE;IACzE,OAAO,CAAC,WAAW;CAqBpB;AAED,wBAAgB,2BAA2B,CAAC,IAAI,GAAE,iBAAsB,GAAG,qBAAqB,CAE/F"}