@kuralle-syrinx/openai-tts 4.4.0 → 4.5.0

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+import type { PipelineBus } from "@kuralle-syrinx/core";
+import { type PluginConfig, type VoicePlugin } from "@kuralle-syrinx/core";
+export { WsolaTimeStretch } from "./wsola.js";
+export declare class OpenAICompatibleTTSPlugin implements VoicePlugin {
+    private bus;
+    private baseUrl;
+    private apiKey;
+    private model;
+    private voice;
+    private responseFormat;
+    private sourceSampleRateHz;
+    private sampleRate;
+    private tempo;
+    private extraBody;
+    private disposers;
+    private inflight;
+    initialize(bus: PipelineBus, config: PluginConfig): Promise<void>;
+    close(): Promise<void>;
+    prewarm(): Promise<void>;
+    private abortInflight;
+    private synth;
+    private emitError;
+    private emitAudio;
+    private emitUsage;
+    private emitEnd;
+}
+//# 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":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAGL,KAAK,YAAY,EAIjB,KAAK,WAAW,EAIjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAY9C,qBAAa,yBAA0B,YAAW,WAAW;IAC3D,OAAO,CAAC,GAAG,CAA4B;IACvC,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,cAAc,CAA2B;IACjD,OAAO,CAAC,kBAAkB,CAAiC;IAC3D,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,QAAQ,CAA8B;IAExC,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB9B,OAAO,CAAC,aAAa;YAOP,KAAK;IAqGnB,OAAO,CAAC,SAAS;IAcjB,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,OAAO;CAOhB"}

package/dist/index.js

@@ -0,0 +1,279 @@
+// SPDX-License-Identifier: MIT
+//
+// Syrinx Kernel v2 — OpenAI-Compatible HTTP Streaming TTS Plugin
+//
+// Generic plugin for any OpenAI-compatible POST /audio/speech endpoint with
+// stream:true returning raw mono s16le PCM. Configurable base_url, api_key,
+// model, voice, response_format, source_sample_rate_hz, sample_rate, tempo,
+// and extra_body. Supports WSOLA time-stretch for tempo control.
+import { Route, StreamingPcm16Resampler, categorizeTtsError, isRecoverable, optionalStringConfig, } from "@kuralle-syrinx/core";
+import { WsolaTimeStretch } from "./wsola.js";
+export { WsolaTimeStretch } from "./wsola.js";
+const EMPTY = new Uint8Array(0);
+const DEFAULT_BASE_URL = "https://api.openai.com/v1";
+const DEFAULT_MODEL = "gpt-4o-mini-tts";
+const DEFAULT_RESPONSE_FORMAT = "pcm";
+const DEFAULT_SOURCE_SAMPLE_RATE_HZ = 24_000;
+const DEFAULT_ENGINE_RATE_HZ = 16_000;
+const DEFAULT_TEMPO = 1.0;
+const TEMPO_MIN = 0.5;
+const TEMPO_MAX = 1.5;
+export class OpenAICompatibleTTSPlugin {
+    bus = null;
+    baseUrl = DEFAULT_BASE_URL;
+    apiKey = "";
+    model = DEFAULT_MODEL;
+    voice;
+    responseFormat = DEFAULT_RESPONSE_FORMAT;
+    sourceSampleRateHz = DEFAULT_SOURCE_SAMPLE_RATE_HZ;
+    sampleRate = DEFAULT_ENGINE_RATE_HZ;
+    tempo = DEFAULT_TEMPO;
+    extraBody;
+    disposers = [];
+    inflight = new Set();
+    async initialize(bus, config) {
+        this.bus = bus;
+        this.baseUrl = stripTrailingSlash(optionalStringConfig(config, "base_url") ??
+            processEnv("OPENAI_BASE_URL") ??
+            DEFAULT_BASE_URL);
+        this.apiKey =
+            optionalStringConfig(config, "api_key") ?? processEnv("OPENAI_API_KEY") ?? "";
+        this.model = optionalStringConfig(config, "model") ?? DEFAULT_MODEL;
+        this.voice = optionalStringConfig(config, "voice");
+        this.responseFormat = optionalStringConfig(config, "response_format") ?? DEFAULT_RESPONSE_FORMAT;
+        this.sourceSampleRateHz = readPositiveInteger(config["source_sample_rate_hz"], DEFAULT_SOURCE_SAMPLE_RATE_HZ);
+        this.sampleRate = readPositiveInteger(config["sample_rate"], DEFAULT_ENGINE_RATE_HZ);
+        this.tempo = readClampedTempo(config["tempo"], DEFAULT_TEMPO);
+        this.extraBody = readPlainObject(config["extra_body"]);
+        this.disposers.push(bus.on("tts.text", async (pkt) => {
+            const textPkt = pkt;
+            await this.synth(textPkt.text, textPkt.contextId);
+        }), bus.on("interrupt.tts", () => {
+            this.abortInflight();
+        }));
+    }
+    async close() {
+        this.abortInflight();
+        for (const dispose of this.disposers.splice(0))
+            dispose();
+        this.bus = null;
+    }
+    async prewarm() {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 8_000);
+        try {
+            const headers = {};
+            if (this.apiKey) {
+                headers["Authorization"] = `Bearer ${this.apiKey}`;
+            }
+            await fetch(`${this.baseUrl}/models`, {
+                method: "GET",
+                headers,
+                signal: controller.signal,
+            });
+        }
+        catch {
+            // best-effort
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    abortInflight() {
+        for (const controller of this.inflight) {
+            controller.abort();
+        }
+        this.inflight.clear();
+    }
+    async synth(text, contextId) {
+        if (!text.trim())
+            return;
+        const controller = new AbortController();
+        this.inflight.add(controller);
+        const speechUrl = `${this.baseUrl}/audio/speech`;
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (this.apiKey) {
+            headers["Authorization"] = `Bearer ${this.apiKey}`;
+        }
+        const body = {
+            model: this.model,
+            input: text,
+            response_format: this.responseFormat,
+            stream: true,
+            ...this.extraBody,
+        };
+        if (this.voice !== undefined) {
+            body.voice = this.voice;
+        }
+        try {
+            const response = await fetch(speechUrl, {
+                method: "POST",
+                headers,
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                if (response.status === 503) {
+                    console.error("[openai-tts] cold start (HTTP 503) — provider may be warming up; keep-warm required for production");
+                }
+                const err = Object.assign(new Error(`OpenAI-compatible TTS HTTP ${String(response.status)}: ${response.statusText || "request failed"}`), { status: response.status });
+                this.emitError(contextId, err);
+                return;
+            }
+            const responseBody = response.body;
+            if (!responseBody) {
+                this.emitError(contextId, new Error("OpenAI-compatible TTS response body is null"));
+                return;
+            }
+            const reader = responseBody.getReader();
+            const resampler = new StreamingPcm16Resampler(this.sourceSampleRateHz, this.sampleRate);
+            const stretch = Math.abs(this.tempo - 1) >= 1e-6
+                ? new WsolaTimeStretch(this.tempo, this.sampleRate)
+                : null;
+            let carry = EMPTY;
+            while (true) {
+                if (controller.signal.aborted)
+                    return;
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                if (!value || value.byteLength === 0)
+                    continue;
+                const frame = value instanceof Uint8Array ? value : new Uint8Array(value);
+                const buf = carry.byteLength === 0 ? frame : concatBytes(carry, frame);
+                const evenLen = buf.byteLength - (buf.byteLength % 2);
+                if (evenLen > 0) {
+                    const pcmBytes = buf.subarray(0, evenLen);
+                    const samples = bytesToInt16LE(pcmBytes);
+                    const resampled = resampler.process(samples);
+                    const stretched = stretch ? stretch.process(resampled) : resampled;
+                    if (stretched.length > 0) {
+                        this.emitAudio(contextId, stretched);
+                    }
+                }
+                carry = evenLen < buf.byteLength ? buf.subarray(evenLen) : EMPTY;
+            }
+            if (controller.signal.aborted)
+                return;
+            if (stretch) {
+                const tail = stretch.flush();
+                if (tail.length > 0) {
+                    this.emitAudio(contextId, tail);
+                }
+            }
+            this.emitUsage(contextId, text.length);
+            this.emitEnd(contextId);
+        }
+        catch (err) {
+            if (isAbortError(err) || controller.signal.aborted)
+                return;
+            this.emitError(contextId, err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            this.inflight.delete(controller);
+        }
+    }
+    emitError(contextId, err) {
+        const category = categorizeTtsError(err);
+        const packet = {
+            kind: "tts.error",
+            contextId,
+            timestampMs: Date.now(),
+            component: "tts",
+            category,
+            cause: err,
+            isRecoverable: isRecoverable(category),
+        };
+        this.bus?.push(Route.Critical, packet);
+    }
+    emitAudio(contextId, samples) {
+        const audio = int16ToBytes(samples);
+        const packet = {
+            kind: "tts.audio",
+            contextId,
+            timestampMs: Date.now(),
+            audio,
+            sampleRateHz: this.sampleRate,
+            provider: { name: "openai", model: this.model, cancelled: false },
+        };
+        this.bus?.push(Route.Main, packet);
+    }
+    emitUsage(contextId, characters) {
+        if (characters <= 0)
+            return;
+        this.bus?.push(Route.Background, {
+            kind: "usage.recorded",
+            contextId,
+            timestampMs: Date.now(),
+            stage: "tts",
+            provider: "openai",
+            model: this.model,
+            characters,
+        });
+    }
+    emitEnd(contextId) {
+        this.bus?.push(Route.Main, {
+            kind: "tts.end",
+            contextId,
+            timestampMs: Date.now(),
+        });
+    }
+}
+function processEnv(key) {
+    try {
+        const value = globalThis.process
+            ?.env?.[key];
+        return typeof value === "string" && value.trim().length > 0 ? value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function stripTrailingSlash(url) {
+    return url.endsWith("/") ? url.slice(0, -1) : url;
+}
+function readPositiveInteger(value, fallback) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return fallback;
+    const integer = Math.floor(value);
+    return integer > 0 ? integer : fallback;
+}
+function readClampedTempo(value, fallback) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return fallback;
+    if (value < TEMPO_MIN)
+        return TEMPO_MIN;
+    if (value > TEMPO_MAX)
+        return TEMPO_MAX;
+    return value;
+}
+function readPlainObject(value) {
+    if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+        return value;
+    }
+    return undefined;
+}
+function concatBytes(a, b) {
+    const out = new Uint8Array(a.byteLength + b.byteLength);
+    out.set(a, 0);
+    out.set(b, a.byteLength);
+    return out;
+}
+/** Copy into an owned ArrayBuffer so Int16Array is always 2-byte aligned. */
+function bytesToInt16LE(bytes) {
+    const ab = new ArrayBuffer(bytes.byteLength);
+    new Uint8Array(ab).set(bytes);
+    return new Int16Array(ab);
+}
+function int16ToBytes(samples) {
+    return new Uint8Array(samples.buffer, samples.byteOffset, samples.byteLength);
+}
+function isAbortError(err) {
+    if (!err || typeof err !== "object")
+        return false;
+    const name = err.name;
+    return name === "AbortError" || name === "TimeoutError";
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/wsola.d.ts

@@ -0,0 +1,47 @@
+export declare class WsolaTimeStretch {
+    private readonly passthrough;
+    private readonly frame;
+    private readonly hs;
+    private readonly ha;
+    private readonly searchRadius;
+    private readonly window;
+    /** Accumulated input samples (float). */
+    private input;
+    private inputLen;
+    /** Absolute sample index of input[0] in the stream. */
+    private inputOrigin;
+    /** Overlap-add synthesis buffer (float). */
+    private ola;
+    private olaLen;
+    /** Absolute synthesis index of ola[0]. */
+    private olaOrigin;
+    /**
+     * Absolute synthesis index up to which samples are final (no further OLA).
+     * After placing a frame at absSynth, samples in [0, absSynth) are complete.
+     */
+    private emitThrough;
+    /** Ideal analysis position (absolute input sample index). */
+    private analysisPos;
+    /** Absolute synthesis index for the next frame. */
+    private synthPos;
+    private havePrev;
+    /** Natural continuation of previous frame (hs samples) for waveform matching. */
+    private prevContinuation;
+    constructor(tempo: number, sampleRateHz: number);
+    process(input: Int16Array): Int16Array;
+    flush(): Int16Array;
+    private appendInput;
+    private extractReady;
+    /**
+     * Place one more synthesis frame via WSOLA.
+     * @returns false when more input is needed or the stream is exhausted.
+     */
+    private tryAddFrame;
+    private findBestOffset;
+    private olaAddFrame;
+    private storeContinuation;
+    private compactInput;
+    private ensureInputCapacity;
+    private ensureOlaCapacity;
+}
+//# sourceMappingURL=wsola.d.ts.map

package/dist/wsola.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wsola.d.ts","sourceRoot":"","sources":["../src/wsola.ts"],"names":[],"mappings":"AAYA,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IAEtC,yCAAyC;IACzC,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,QAAQ,CAAK;IACrB,uDAAuD;IACvD,OAAO,CAAC,WAAW,CAAK;IAExB,4CAA4C;IAC5C,OAAO,CAAC,GAAG,CAAqC;IAChD,OAAO,CAAC,MAAM,CAAK;IACnB,0CAA0C;IAC1C,OAAO,CAAC,SAAS,CAAK;IACtB;;;OAGG;IACH,OAAO,CAAC,WAAW,CAAK;IAExB,6DAA6D;IAC7D,OAAO,CAAC,WAAW,CAAK;IACxB,mDAAmD;IACnD,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAS;IACzB,iFAAiF;IACjF,OAAO,CAAC,gBAAgB,CAAe;gBAE3B,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;IAiB/C,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU;IAMtC,KAAK,IAAI,UAAU;IAKnB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,YAAY;IAmCpB;;;OAGG;IACH,OAAO,CAAC,WAAW;IA4CnB,OAAO,CAAC,cAAc;IAiCtB,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,iBAAiB;CAO1B"}

package/dist/wsola.js

@@ -0,0 +1,257 @@
+// SPDX-License-Identifier: MIT
+//
+// Streaming WSOLA (Waveform Similarity Overlap-Add) time-stretch.
+// Pitch-preserving tempo control: tempo < 1 slows, > 1 speeds, 1.0 passthrough.
+// Matches the intent of ffmpeg atempo without an ffmpeg runtime dependency.
+const PASSTHROUGH_EPS = 1e-6;
+const FRAME_MS = 0.03;
+const SEARCH_MS = 0.01;
+const INT16_MIN = -32768;
+const INT16_MAX = 32767;
+export class WsolaTimeStretch {
+    passthrough;
+    frame;
+    hs;
+    ha;
+    searchRadius;
+    window;
+    /** Accumulated input samples (float). */
+    input = new Float64Array(0);
+    inputLen = 0;
+    /** Absolute sample index of input[0] in the stream. */
+    inputOrigin = 0;
+    /** Overlap-add synthesis buffer (float). */
+    ola = new Float64Array(0);
+    olaLen = 0;
+    /** Absolute synthesis index of ola[0]. */
+    olaOrigin = 0;
+    /**
+     * Absolute synthesis index up to which samples are final (no further OLA).
+     * After placing a frame at absSynth, samples in [0, absSynth) are complete.
+     */
+    emitThrough = 0;
+    /** Ideal analysis position (absolute input sample index). */
+    analysisPos = 0;
+    /** Absolute synthesis index for the next frame. */
+    synthPos = 0;
+    havePrev = false;
+    /** Natural continuation of previous frame (hs samples) for waveform matching. */
+    prevContinuation;
+    constructor(tempo, sampleRateHz) {
+        if (!(sampleRateHz > 0) || !Number.isFinite(sampleRateHz)) {
+            throw new RangeError(`WsolaTimeStretch: invalid sampleRateHz ${String(sampleRateHz)}`);
+        }
+        if (!Number.isFinite(tempo) || tempo <= 0) {
+            throw new RangeError(`WsolaTimeStretch: invalid tempo ${String(tempo)}`);
+        }
+        this.passthrough = Math.abs(tempo - 1) < PASSTHROUGH_EPS;
+        this.frame = Math.max(2, Math.round(FRAME_MS * sampleRateHz));
+        this.hs = Math.max(1, Math.floor(this.frame / 2));
+        this.ha = Math.max(1, Math.round(this.hs * tempo));
+        this.searchRadius = Math.max(0, Math.round(SEARCH_MS * sampleRateHz));
+        this.window = hann(this.frame);
+        this.prevContinuation = new Float64Array(this.hs);
+    }
+    process(input) {
+        if (this.passthrough)
+            return input;
+        if (input.length > 0)
+            this.appendInput(input);
+        return this.extractReady(false);
+    }
+    flush() {
+        if (this.passthrough)
+            return new Int16Array(0);
+        return this.extractReady(true);
+    }
+    appendInput(samples) {
+        this.ensureInputCapacity(this.inputLen + samples.length);
+        for (let i = 0; i < samples.length; i++) {
+            this.input[this.inputLen + i] = samples[i];
+        }
+        this.inputLen += samples.length;
+    }
+    extractReady(flushing) {
+        while (this.tryAddFrame(flushing)) {
+            // keep consuming frames while input allows
+        }
+        if (flushing) {
+            this.emitThrough = this.olaOrigin + this.olaLen;
+        }
+        const ready = this.emitThrough - this.olaOrigin;
+        if (ready <= 0)
+            return new Int16Array(0);
+        const out = new Int16Array(ready);
+        for (let i = 0; i < ready; i++) {
+            out[i] = clampInt16(this.ola[i]);
+        }
+        const remaining = this.olaLen - ready;
+        if (remaining > 0) {
+            this.ola.copyWithin(0, ready, this.olaLen);
+        }
+        this.ola.fill(0, remaining, this.olaLen);
+        this.olaLen = remaining;
+        this.olaOrigin += ready;
+        if (flushing) {
+            this.inputLen = 0;
+            this.inputOrigin = this.analysisPos;
+        }
+        else {
+            this.compactInput();
+        }
+        return out;
+    }
+    /**
+     * Place one more synthesis frame via WSOLA.
+     * @returns false when more input is needed or the stream is exhausted.
+     */
+    tryAddFrame(flushing) {
+        const frame = this.frame;
+        const hs = this.hs;
+        const search = this.searchRadius;
+        const inputEnd = this.inputOrigin + this.inputLen;
+        if (!this.havePrev) {
+            if (inputEnd < frame)
+                return false;
+            const localStart = 0;
+            this.olaAddFrame(localStart, 0);
+            this.storeContinuation(localStart);
+            this.havePrev = true;
+            this.analysisPos = this.ha;
+            this.synthPos = hs;
+            // Samples [0, hs) still receive the next frame's OLA contribution.
+            this.emitThrough = 0;
+            return true;
+        }
+        // Need a full frame at some position in [ideal - search, ideal + search].
+        const ideal = this.analysisPos;
+        if (!flushing) {
+            // Require full right-side search room so offsets are unbiased while streaming.
+            if (inputEnd < ideal + frame + search)
+                return false;
+        }
+        else {
+            // On flush, accept any position that can hold a frame near the ideal.
+            if (inputEnd < ideal - search + frame && inputEnd < frame)
+                return false;
+            if (inputEnd - this.inputOrigin < frame)
+                return false;
+            // If even the earliest searchable start cannot fit a frame, stop.
+            const latestStart = inputEnd - frame;
+            if (latestStart < Math.max(this.inputOrigin, ideal - search))
+                return false;
+        }
+        const bestLocal = this.findBestOffset(ideal);
+        const absSynth = this.synthPos;
+        this.olaAddFrame(bestLocal, absSynth);
+        this.storeContinuation(bestLocal);
+        this.analysisPos = ideal + this.ha;
+        this.synthPos = absSynth + hs;
+        // After placing frame at absSynth, no future frame touches [0, absSynth).
+        this.emitThrough = absSynth;
+        return true;
+    }
+    findBestOffset(idealAbs) {
+        const frame = this.frame;
+        const hs = this.hs;
+        const search = this.searchRadius;
+        const inputEnd = this.inputOrigin + this.inputLen;
+        const earliest = Math.max(this.inputOrigin, idealAbs - search);
+        const latest = Math.min(inputEnd - frame, idealAbs + search);
+        if (latest < earliest) {
+            const fallbackAbs = Math.min(Math.max(idealAbs, this.inputOrigin), Math.max(this.inputOrigin, inputEnd - frame));
+            return fallbackAbs - this.inputOrigin;
+        }
+        let bestLocal = earliest - this.inputOrigin;
+        let bestScore = -Infinity;
+        for (let abs = earliest; abs <= latest; abs++) {
+            const local = abs - this.inputOrigin;
+            let score = 0;
+            for (let i = 0; i < hs; i++) {
+                score += this.input[local + i] * this.prevContinuation[i];
+            }
+            if (score > bestScore) {
+                bestScore = score;
+                bestLocal = local;
+            }
+        }
+        return bestLocal;
+    }
+    olaAddFrame(localStart, absSynth) {
+        const frame = this.frame;
+        const localOla = absSynth - this.olaOrigin;
+        const needLen = localOla + frame;
+        this.ensureOlaCapacity(needLen);
+        if (needLen > this.olaLen) {
+            if (this.olaLen < localOla) {
+                this.ola.fill(0, this.olaLen, localOla);
+            }
+            this.olaLen = needLen;
+        }
+        for (let i = 0; i < frame; i++) {
+            const sample = localStart + i < this.inputLen ? this.input[localStart + i] : 0;
+            this.ola[localOla + i] += sample * this.window[i];
+        }
+    }
+    storeContinuation(localStart) {
+        const hs = this.hs;
+        for (let i = 0; i < hs; i++) {
+            const idx = localStart + hs + i;
+            this.prevContinuation[i] = idx < this.inputLen ? this.input[idx] : 0;
+        }
+    }
+    compactInput() {
+        const keepFromAbs = Math.max(0, this.analysisPos - this.searchRadius);
+        if (keepFromAbs <= this.inputOrigin)
+            return;
+        const drop = keepFromAbs - this.inputOrigin;
+        if (drop <= 0)
+            return;
+        if (drop >= this.inputLen) {
+            this.inputLen = 0;
+            this.inputOrigin = keepFromAbs;
+            return;
+        }
+        this.input.copyWithin(0, drop, this.inputLen);
+        this.inputLen -= drop;
+        this.inputOrigin = keepFromAbs;
+    }
+    ensureInputCapacity(needed) {
+        if (needed <= this.input.length)
+            return;
+        const cap = Math.max(needed, this.input.length > 0 ? this.input.length * 2 : 1024);
+        const next = new Float64Array(cap);
+        next.set(this.input.subarray(0, this.inputLen));
+        this.input = next;
+    }
+    ensureOlaCapacity(needed) {
+        if (needed <= this.ola.length)
+            return;
+        const cap = Math.max(needed, this.ola.length > 0 ? this.ola.length * 2 : 1024);
+        const next = new Float64Array(cap);
+        next.set(this.ola.subarray(0, this.olaLen));
+        this.ola = next;
+    }
+}
+/** Symmetric Hann window; 50% overlap is COLA (overlapping windows sum ≈ 1). */
+function hann(n) {
+    const w = new Float64Array(n);
+    if (n === 1) {
+        w[0] = 1;
+        return w;
+    }
+    const denom = n - 1;
+    for (let i = 0; i < n; i++) {
+        w[i] = 0.5 * (1 - Math.cos((2 * Math.PI * i) / denom));
+    }
+    return w;
+}
+function clampInt16(x) {
+    const r = Math.round(x);
+    if (r < INT16_MIN)
+        return INT16_MIN;
+    if (r > INT16_MAX)
+        return INT16_MAX;
+    return r;
+}
+//# sourceMappingURL=wsola.js.map

package/dist/wsola.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kuralle-syrinx/openai-tts",
-  "version": "4.4.0",
+  "version": "4.5.0",
   "private": false,
   "description": "OpenAI-compatible streaming TTS plugin for Syrinx",
   "keywords": [
@@ -23,17 +23,24 @@
     "url": "https://github.com/kuralle/syrinx/issues"
   },
   "type": "module",
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "dependencies": {
-    "@kuralle-syrinx/core": "4.4.0"
+    "@kuralle-syrinx/core": "4.5.0"
   },
   "devDependencies": {
+    "@types/node": "^22.0.0",
     "typescript": "^5.7.0",
     "vitest": "^3.2.6"
   },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
   "scripts": {
     "typecheck": "tsc --noEmit",
-    "test": "vitest run"
+    "test": "vitest run",
+    "build": "tsc -p tsconfig.build.json"
   }
 }

package/src/index.test.ts

@@ -0,0 +1,527 @@
+// SPDX-License-Identifier: MIT
+
+import { afterEach, describe, expect, it, vi } from "vitest";
+import {
+  PipelineBusImpl,
+  Route,
+  type TextToSpeechAudioPacket,
+  type TextToSpeechEndPacket,
+  type TtsErrorPacket,
+  type UsageRecordedPacket,
+} from "@kuralle-syrinx/core";
+
+import { OpenAICompatibleTTSPlugin } from "./index.js";
+
+function startBus(bus: PipelineBusImpl): Promise<void> {
+  return bus.start();
+}
+
+async function waitForCondition(predicate: () => boolean, timeoutMs = 2000): Promise<void> {
+  const startedAt = Date.now();
+  while (Date.now() - startedAt < timeoutMs) {
+    if (predicate()) return;
+    await new Promise((resolve) => setTimeout(resolve, 10));
+  }
+  throw new Error("Timed out waiting for openai-tts test condition");
+}
+
+/** Minimal mono s16le silence: `sampleCount` samples (`sampleCount * 2` bytes). */
+function pcmSilence(sampleCount: number): Uint8Array {
+  return new Uint8Array(sampleCount * 2);
+}
+
+function streamFromChunks(chunks: Uint8Array[]): ReadableStream<Uint8Array> {
+  let i = 0;
+  return new ReadableStream({
+    pull(controller) {
+      if (i >= chunks.length) {
+        controller.close();
+        return;
+      }
+      controller.enqueue(chunks[i]!);
+      i += 1;
+    },
+  });
+}
+
+afterEach(() => {
+  vi.unstubAllGlobals();
+  vi.restoreAllMocks();
+});
+
+describe("OpenAICompatibleTTSPlugin", () => {
+  it("emits usage.recorded with stage tts and characters equal to synthesized text length", async () => {
+    const fetchMock = vi.fn(async () => {
+      return new Response(streamFromChunks([pcmSilence(8)]), {
+        status: 200,
+        headers: { "Content-Type": "application/octet-stream" },
+      });
+    });
+    vi.stubGlobal("fetch", fetchMock);
+
+    const bus = new PipelineBusImpl();
+    const started = startBus(bus);
+    const plugin = new OpenAICompatibleTTSPlugin();
+    const ends: TextToSpeechEndPacket[] = [];
+    const usage: UsageRecordedPacket[] = [];
+    bus.on("tts.end", (pkt) => {
+      ends.push(pkt as TextToSpeechEndPacket);
+    });
+    bus.on("usage.recorded", (pkt) => {
+      usage.push(pkt as UsageRecordedPacket);
+    });
+
+    const text = "Hello usage.";
+    await plugin.initialize(bus, {
+      base_url: "https://tts.test/v1",
+      model: "gpt-4o-mini-tts",
+      sample_rate: 16000,
+    });
+    bus.push(Route.Main, {
+      kind: "tts.text",
+      contextId: "turn-usage",
+      timestampMs: Date.now(),
+      text,
+    });
+    await waitForCondition(() => ends.length >= 1 && usage.length >= 1);
+
+    expect(usage).toEqual([
+      expect.objectContaining({
+        kind: "usage.recorded",
+        contextId: "turn-usage",
+        stage: "tts",
+        provider: "openai",
+        model: "gpt-4o-mini-tts",
+        characters: text.length,
+      }),
+    ]);
+
+    await plugin.close();
+    bus.stop();
+    await started;
+  });
+
+  it("POSTs speech body with stream, pcm, and extra_body merged", async () => {
+    const fetchMock = vi.fn(async (_url: string | URL | Request, init?: RequestInit) => {
+      return new Response(streamFromChunks([pcmSilence(8)]), {
+        status: 200,
+        headers: { "Content-Type": "application/octet-stream" },
+      });
+    });
+    vi.stubGlobal("fetch", fetchMock);
+
+    const bus = new PipelineBusImpl();
+    const started = startBus(bus);
+    const plugin = new OpenAICompatibleTTSPlugin();
+    const ends: TextToSpeechEndPacket[] = [];
+    bus.on("tts.end", (pkt) => {
+      ends.push(pkt as TextToSpeechEndPacket);
+    });
+
+    await plugin.initialize(bus, {
+      base_url: "https://zeta.test/v1",
+      sample_rate: 16000,
+      extra_body: { task_type: "Base", num_steps: 8 },
+    });
+
+    bus.push(Route.Main, {
+      kind: "tts.text",
+      contextId: "turn-1",
+      timestampMs: Date.now(),
+      text: "ආයුබෝවන්",
+    });
+    await waitForCondition(() => ends.length >= 1);
+
+    expect(fetchMock).toHaveBeenCalledTimes(1);
+    const [url, init] = fetchMock.mock.calls[0]!;
+    expect(String(url)).toBe("https://zeta.test/v1/audio/speech");
+    expect(init?.method).toBe("POST");
+    const body = JSON.parse(String(init?.body)) as Record<string, unknown>;
+    expect(body).toEqual({
+      model: "gpt-4o-mini-tts",
+      input: "ආයුබෝවන්",
+      response_format: "pcm",
+      stream: true,
+      task_type: "Base",
+      num_steps: 8,
+    });
+    expect((init?.headers as Record<string, string>)["Content-Type"]).toBe("application/json");
+
+    await plugin.close();
+    bus.stop();
+    await started;
+  });
+
+  it("honors response_format override and keeps stream true by default", async () => {
+    const fetchMock = vi.fn(async (_url: string | URL | Request, init?: RequestInit) => {
+      return new Response(streamFromChunks([pcmSilence(8)]), {
+        status: 200,
+        headers: { "Content-Type": "application/octet-stream" },
+      });
+    });
+    vi.stubGlobal("fetch", fetchMock);
+
+    const bus = new PipelineBusImpl();
+    const started = startBus(bus);
+    const plugin = new OpenAICompatibleTTSPlugin();
+    const ends: TextToSpeechEndPacket[] = [];
+    bus.on("tts.end", (pkt) => {
+      ends.push(pkt as TextToSpeechEndPacket);
+    });
+
+    await plugin.initialize(bus, {
+      base_url: "https://openai.test/v1",
+      response_format: "wav",
+      sample_rate: 16000,
+    });
+
+    bus.push(Route.Main, {
+      kind: "tts.text",
+      contextId: "turn-fmt",
+      timestampMs: Date.now(),
+      text: "format",
+    });
+    await waitForCondition(() => ends.length >= 1);
+
+    const [_url, init] = fetchMock.mock.calls[0]!;
+    const body = JSON.parse(String(init?.body)) as Record<string, unknown>;
+    expect(body.response_format).toBe("wav");
+    expect(body.stream).toBe(true);
+
+    await plugin.close();
+    bus.stop();
+    await started;
+  });
+
+  it("includes voice in body only when configured", async () => {
+    const fetchMock = vi.fn(async (_url: string | URL | Request, init?: RequestInit) => {
+      return new Response(streamFromChunks([pcmSilence(8)]), {
+        status: 200,
+        headers: { "Content-Type": "application/octet-stream" },
+      });
+    });
+    vi.stubGlobal("fetch", fetchMock);
+
+    const bus = new PipelineBusImpl();
+    const started = startBus(bus);
+    const plugin = new OpenAICompatibleTTSPlugin();
+    const ends: TextToSpeechEndPacket[] = [];
+    bus.on("tts.end", (pkt) => {
+      ends.push(pkt as TextToSpeechEndPacket);
+    });
+
+    await plugin.initialize(bus, {
+      base_url: "https://openai.test/v1",
+      api_key: "sk-test",
+      voice: "alloy",
+      sample_rate: 16000,
+    });
+
+    bus.push(Route.Main, {
+      kind: "tts.text",
+      contextId: "turn-voice",
+      timestampMs: Date.now(),
+      text: "hello",
+    });
+    await waitForCondition(() => ends.length >= 1);
+
+    const [_url, init] = fetchMock.mock.calls[0]!;
+    const body = JSON.parse(String(init?.body)) as Record<string, unknown>;
+    expect(body.voice).toBe("alloy");
+    expect((init?.headers as Record<string, string>)["Authorization"]).toBe("Bearer sk-test");
+
+    await plugin.close();
+    bus.stop();
+    await started;
+  });
+
+  it("omits voice key when voice is not configured", async () => {
+    const fetchMock = vi.fn(async (_url: string | URL | Request, init?: RequestInit) => {
+      return new Response(streamFromChunks([pcmSilence(8)]), {
+        status: 200,
+        headers: { "Content-Type": "application/octet-stream" },
+      });
+    });
+    vi.stubGlobal("fetch", fetchMock);
+
+    const bus = new PipelineBusImpl();
+    const started = startBus(bus);
+    const plugin = new OpenAICompatibleTTSPlugin();
+    const ends: TextToSpeechEndPacket[] = [];
+    bus.on("tts.end", (pkt) => {
+      ends.push(pkt as TextToSpeechEndPacket);
+    });
+
+    await plugin.initialize(bus, {
+      base_url: "https://openai.test/v1",
+      sample_rate: 16000,
+    });
+
+    bus.push(Route.Main, {
+      kind: "tts.text",
+      contextId: "turn-no-voice",
+      timestampMs: Date.now(),
+      text: "hi",
+    });
+    await waitForCondition(() => ends.length >= 1);
+
+    const [_url, init] = fetchMock.mock.calls[0]!;
+    const body = JSON.parse(String(init?.body)) as Record<string, unknown>;
+    expect(body).not.toHaveProperty("voice");
+
+    await plugin.close();
+    bus.stop();
+    await started;
+  });
+
+  it("streams PCM into tts.audio at engine sampleRateHz then tts.end", async () => {
+    // Two chunks with an odd-byte split so the plugin must carry across frames.
+    const full = pcmSilence(48); // 96 bytes
+    const chunkA = full.subarray(0, 15); // odd
+    const chunkB = full.subarray(15);
+
+    vi.stubGlobal(
+      "fetch",
+      vi.fn(async () => {
+        return new Response(streamFromChunks([chunkA, chunkB]), {
+          status: 200,
+          headers: { "Content-Type": "application/octet-stream" },
+        });
+      }),
+    );
+
+    const bus = new PipelineBusImpl();
+    const started = startBus(bus);
+    const plugin = new OpenAICompatibleTTSPlugin();
+    const audio: TextToSpeechAudioPacket[] = [];
+    const ends: TextToSpeechEndPacket[] = [];
+    bus.on("tts.audio", (pkt) => {
+      audio.push(pkt as TextToSpeechAudioPacket);
+    });
+    bus.on("tts.end", (pkt) => {
+      ends.push(pkt as TextToSpeechEndPacket);
+    });
+
+    await plugin.initialize(bus, {
+      base_url: "https://openai.test/v1",
+      sample_rate: 16000,
+    });
+
+    bus.push(Route.Main, {
+      kind: "tts.text",
+      contextId: "turn-2",
+      timestampMs: Date.now(),
+      text: "hello",
+    });
+    await waitForCondition(() => ends.length >= 1);
+
+    expect(audio.length).toBeGreaterThanOrEqual(1);
+    for (const pkt of audio) {
+      expect(pkt.kind).toBe("tts.audio");
+      expect(pkt.contextId).toBe("turn-2");
+      expect(pkt.sampleRateHz).toBe(16000);
+      expect(pkt.audio.byteLength % 2).toBe(0);
+      expect(pkt.audio.byteLength).toBeGreaterThan(0);
+    }
+    expect(ends).toEqual([expect.objectContaining({ kind: "tts.end", contextId: "turn-2" })]);
+
+    await plugin.close();
+    bus.stop();
+    await started;
+  });
+
+  it("source_sample_rate_hz drives the resampler output length", async () => {
+    // 96 bytes = 48 samples. Different source rates → different resampled lengths.
+    const pcm48k = pcmSilence(48);
+
+    async function collectAudioBytes(sourceRate: number): Promise<number> {
+      vi.stubGlobal(
+        "fetch",
+        vi.fn(async () => {
+          return new Response(streamFromChunks([pcm48k]), {
+            status: 200,
+            headers: { "Content-Type": "application/octet-stream" },
+          });
+        }),
+      );
+
+      const bus = new PipelineBusImpl();
+      const started = startBus(bus);
+      const plugin = new OpenAICompatibleTTSPlugin();
+      let totalBytes = 0;
+      const ends: TextToSpeechEndPacket[] = [];
+      bus.on("tts.audio", (pkt) => {
+        totalBytes += (pkt as TextToSpeechAudioPacket).audio.byteLength;
+      });
+      bus.on("tts.end", (pkt) => {
+        ends.push(pkt as TextToSpeechEndPacket);
+      });
+
+      await plugin.initialize(bus, {
+        base_url: "https://openai.test/v1",
+        sample_rate: 16000,
+        source_sample_rate_hz: sourceRate,
+      });
+
+      bus.push(Route.Main, {
+        kind: "tts.text",
+        contextId: `rate-${String(sourceRate)}`,
+        timestampMs: Date.now(),
+        text: "test",
+      });
+      await waitForCondition(() => ends.length >= 1);
+
+      await plugin.close();
+      bus.stop();
+      await started;
+      vi.unstubAllGlobals();
+      return totalBytes;
+    }
+
+    const bytesAt48k = await collectAudioBytes(48_000);
+    const bytesAt24k = await collectAudioBytes(24_000);
+    expect(bytesAt48k).toBeGreaterThan(0);
+    expect(bytesAt24k).toBeGreaterThan(bytesAt48k);
+  });
+
+  it("tempo: 0.9 produces more tts.audio bytes than tempo: 1.0 for the same PCM stream", async () => {
+    // ~100 ms of 24 kHz silence → enough samples after resample for WSOLA to stretch.
+    const pcm = pcmSilence(2400);
+
+    async function collectAudioBytes(tempo: number): Promise<number> {
+      vi.stubGlobal(
+        "fetch",
+        vi.fn(async () => {
+          return new Response(streamFromChunks([pcm]), {
+            status: 200,
+            headers: { "Content-Type": "application/octet-stream" },
+          });
+        }),
+      );
+
+      const bus = new PipelineBusImpl();
+      const started = startBus(bus);
+      const plugin = new OpenAICompatibleTTSPlugin();
+      let totalBytes = 0;
+      const ends: TextToSpeechEndPacket[] = [];
+      bus.on("tts.audio", (pkt) => {
+        totalBytes += (pkt as TextToSpeechAudioPacket).audio.byteLength;
+      });
+      bus.on("tts.end", (pkt) => {
+        ends.push(pkt as TextToSpeechEndPacket);
+      });
+
+      await plugin.initialize(bus, {
+        base_url: "https://openai.test/v1",
+        sample_rate: 16000,
+        tempo,
+      });
+
+      bus.push(Route.Main, {
+        kind: "tts.text",
+        contextId: `tempo-${String(tempo)}`,
+        timestampMs: Date.now(),
+        text: "slow",
+      });
+      await waitForCondition(() => ends.length >= 1);
+
+      await plugin.close();
+      bus.stop();
+      await started;
+      vi.unstubAllGlobals();
+      return totalBytes;
+    }
+
+    const bytesAt1 = await collectAudioBytes(1.0);
+    const bytesAt09 = await collectAudioBytes(0.9);
+    expect(bytesAt1).toBeGreaterThan(0);
+    expect(bytesAt09).toBeGreaterThan(bytesAt1);
+  });
+
+  it("maps HTTP 503 to a recoverable tts.error", async () => {
+    const errorLog = vi.spyOn(console, "error").mockImplementation(() => {});
+    vi.stubGlobal(
+      "fetch",
+      vi.fn(async () => new Response("Service Unavailable", { status: 503 })),
+    );
+
+    const bus = new PipelineBusImpl();
+    const started = startBus(bus);
+    const plugin = new OpenAICompatibleTTSPlugin();
+    const errors: TtsErrorPacket[] = [];
+    bus.on("tts.error", (pkt) => {
+      errors.push(pkt as TtsErrorPacket);
+    });
+
+    await plugin.initialize(bus, {
+      base_url: "https://openai.test/v1",
+      sample_rate: 16000,
+    });
+
+    bus.push(Route.Main, {
+      kind: "tts.text",
+      contextId: "turn-cold",
+      timestampMs: Date.now(),
+      text: "cold",
+    });
+    await waitForCondition(() => errors.length >= 1);
+
+    expect(errors).toEqual([
+      expect.objectContaining({
+        kind: "tts.error",
+        contextId: "turn-cold",
+        component: "tts",
+        isRecoverable: true,
+      }),
+    ]);
+    expect(errorLog).toHaveBeenCalledWith(
+      expect.stringContaining("[openai-tts] cold start"),
+    );
+
+    await plugin.close();
+    bus.stop();
+    await started;
+    errorLog.mockRestore();
+  });
+
+  it("prewarm issues GET {baseUrl}/models with auth when api_key is set", async () => {
+    const fetchMock = vi.fn(async (_url: string | URL | Request, init?: RequestInit) => {
+      return new Response("{}", { status: 200 });
+    });
+    vi.stubGlobal("fetch", fetchMock);
+
+    const bus = new PipelineBusImpl();
+    const plugin = new OpenAICompatibleTTSPlugin();
+    await plugin.initialize(bus, {
+      base_url: "https://zeta.test/v1",
+      api_key: "sk-test",
+    });
+
+    await plugin.prewarm();
+
+    expect(fetchMock).toHaveBeenCalledTimes(1);
+    const [url, init] = fetchMock.mock.calls[0]!;
+    expect(String(url)).toBe("https://zeta.test/v1/models");
+    expect(init?.method).toBe("GET");
+    expect((init?.headers as Record<string, string>)["Authorization"]).toBe("Bearer sk-test");
+
+    await plugin.close();
+  });
+
+  it("swallows fetch rejection in prewarm", async () => {
+    vi.stubGlobal(
+      "fetch",
+      vi.fn(async () => {
+        throw new Error("network down");
+      }),
+    );
+
+    const bus = new PipelineBusImpl();
+    const plugin = new OpenAICompatibleTTSPlugin();
+    await plugin.initialize(bus, { base_url: "https://zeta.test/v1" });
+
+    await expect(plugin.prewarm()).resolves.toBeUndefined();
+
+    await plugin.close();
+  });
+});

package/src/wsola.test.ts

@@ -0,0 +1,116 @@
+// SPDX-License-Identifier: MIT
+
+import { describe, expect, it } from "vitest";
+import { WsolaTimeStretch } from "./wsola.js";
+
+const SR = 24_000;
+const FREQ_HZ = 220;
+const DURATION_S = 1;
+
+function sinePcm16(sampleRateHz: number, freqHz: number, durationS: number): Int16Array {
+  const n = Math.round(sampleRateHz * durationS);
+  const out = new Int16Array(n);
+  const amp = 16000;
+  for (let i = 0; i < n; i++) {
+    out[i] = Math.round(amp * Math.sin((2 * Math.PI * freqHz * i) / sampleRateHz));
+  }
+  return out;
+}
+
+/** Mean period (samples) between successive rising zero-crossings. */
+function meanRisingZeroCrossingPeriod(samples: Int16Array): number {
+  const crossings: number[] = [];
+  for (let i = 1; i < samples.length; i++) {
+    const prev = samples[i - 1]!;
+    const cur = samples[i]!;
+    if (prev < 0 && cur >= 0) {
+      // Linear interpolate fractional index
+      const frac = prev === cur ? 0 : prev / (prev - cur);
+      crossings.push(i - 1 + frac);
+    }
+  }
+  if (crossings.length < 2) {
+    throw new Error(`too few zero-crossings: ${String(crossings.length)}`);
+  }
+  let sum = 0;
+  for (let i = 1; i < crossings.length; i++) {
+    sum += crossings[i]! - crossings[i - 1]!;
+  }
+  return sum / (crossings.length - 1);
+}
+
+function stretchAll(tempo: number, input: Int16Array, sampleRateHz = SR): Int16Array {
+  const s = new WsolaTimeStretch(tempo, sampleRateHz);
+  const a = s.process(input);
+  const b = s.flush();
+  const out = new Int16Array(a.length + b.length);
+  out.set(a, 0);
+  out.set(b, a.length);
+  return out;
+}
+
+function stretchChunked(tempo: number, input: Int16Array, chunkSize: number, sampleRateHz = SR): Int16Array {
+  const s = new WsolaTimeStretch(tempo, sampleRateHz);
+  const parts: Int16Array[] = [];
+  for (let i = 0; i < input.length; i += chunkSize) {
+    const chunk = input.subarray(i, Math.min(i + chunkSize, input.length));
+    const out = s.process(chunk);
+    if (out.length > 0) parts.push(out);
+  }
+  const tail = s.flush();
+  if (tail.length > 0) parts.push(tail);
+  let total = 0;
+  for (const p of parts) total += p.length;
+  const out = new Int16Array(total);
+  let off = 0;
+  for (const p of parts) {
+    out.set(p, off);
+    off += p.length;
+  }
+  return out;
+}
+
+describe("WsolaTimeStretch", () => {
+  const input = sinePcm16(SR, FREQ_HZ, DURATION_S);
+  const frame = Math.round(0.03 * SR);
+
+  it("length scaling: tempo=0.9 lengthens output ≈ input/tempo (±1 frame)", () => {
+    const out = stretchAll(0.9, input);
+    const expected = input.length / 0.9;
+    expect(Math.abs(out.length - expected)).toBeLessThanOrEqual(frame);
+  });
+
+  it("length scaling: tempo=1.2 shortens output ≈ input/tempo (±1 frame)", () => {
+    const out = stretchAll(1.2, input);
+    const expected = input.length / 1.2;
+    expect(Math.abs(out.length - expected)).toBeLessThanOrEqual(frame);
+  });
+
+  it("pitch preserved: tempo=0.9 zero-crossing period matches input within 5%", () => {
+    const out = stretchAll(0.9, input);
+    // Skip a short edge region where OLA windowing is incomplete
+    const skip = frame;
+    const inPeriod = meanRisingZeroCrossingPeriod(input.subarray(skip, input.length - skip));
+    const outPeriod = meanRisingZeroCrossingPeriod(out.subarray(skip, out.length - skip));
+    const relErr = Math.abs(outPeriod - inPeriod) / inPeriod;
+    expect(relErr).toBeLessThanOrEqual(0.05);
+  });
+
+  it("passthrough: tempo=1.0 returns input samples unchanged", () => {
+    const s = new WsolaTimeStretch(1.0, SR);
+    const out = s.process(input);
+    expect(out.length).toBe(input.length);
+    expect(out).toBe(input); // same reference — zero-cost passthrough
+    for (let i = 0; i < input.length; i++) {
+      expect(out[i]).toBe(input[i]);
+    }
+    const tail = s.flush();
+    expect(tail.length).toBe(0);
+  });
+
+  it("streaming invariance: one chunk vs many small chunks → same total length (±1 frame)", () => {
+    const one = stretchAll(0.9, input);
+    const many = stretchChunked(0.9, input, 64);
+    expect(Math.abs(one.length - many.length)).toBeLessThanOrEqual(frame);
+  });
+});