@moxxy/plugin-stt-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/audio.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Pure, dependency-free audio DSP for the local Whisper transcriber. sherpa's
+ * OfflineRecognizer wants Float32 mono PCM in [-1, 1] at 16 kHz; inbound audio
+ * arrives in several shapes, so these helpers convert each to that canonical
+ * form IN-PROCESS (no ffmpeg for raw PCM / WAV):
+ *
+ *   - `pcm16ToFloat32`  int16 little-endian bytes → Float32 in [-1, 1]
+ *   - `downmixToMono`   interleaved N-channel Float32 → averaged mono
+ *   - `resampleLinear`  linear-interpolation resample between two rates
+ *   - `parseWav`        RIFF/WAVE header parse → PCM16 samples (float) + rate +
+ *                       channels; rejects non-PCM16 (float/compressed) WAV
+ *
+ * The `decodeToMono16k` orchestrator (in ./decode.ts) drives these plus the
+ * ffmpeg path. Everything here is synchronous and unit-tested against synthetic
+ * fixtures — the header offsets and the resampler math are load-bearing.
+ */
+/** The sample rate sherpa's Whisper feature extractor expects. */
+export declare const TARGET_SAMPLE_RATE = 16000;
+/**
+ * Convert raw 16-bit little-endian PCM bytes to Float32 in [-1, 1]. A trailing
+ * odd byte (half a sample) is dropped. Channel interleaving is preserved — a
+ * stereo buffer stays interleaved, so callers downmix afterwards.
+ */
+export declare function pcm16ToFloat32(pcm: Uint8Array | ArrayBuffer): Float32Array;
+/**
+ * Average `channels` interleaved Float32 channels down to mono. `channels` must
+ * be a positive integer; a value of 1 returns the input unchanged. Trailing
+ * samples that don't complete a frame are ignored.
+ */
+export declare function downmixToMono(interleaved: Float32Array, channels: number): Float32Array;
+/**
+ * Resample mono Float32 audio from `fromRate` to `toRate` by linear
+ * interpolation. Cheap and dependency-free — good enough for speech recognition
+ * (Whisper is robust to the mild low-pass a linear kernel imposes). Returns the
+ * input unchanged when the rates match, and an empty array for empty input.
+ */
+export declare function resampleLinear(input: Float32Array, fromRate: number, toRate: number): Float32Array;
+/** True when `bytes` begins with the `RIFF….WAVE` magic of a WAV container. */
+export declare function isRiffWave(bytes: Uint8Array): boolean;
+export interface ParsedWav {
+    /** PCM samples as Float32 in [-1, 1], still interleaved if multi-channel. */
+    readonly samples: Float32Array;
+    readonly sampleRate: number;
+    readonly channels: number;
+}
+/**
+ * Parse a canonical RIFF/WAVE buffer into PCM16 samples. Only linear 16-bit PCM
+ * is accepted — IEEE-float, μ-law, and compressed WAV are rejected with a clear
+ * `CONFIG_INVALID` MoxxyError (the caller falls back to ffmpeg for real
+ * compressed formats, but a mislabelled/exotic WAV should fail loudly, not
+ * silently mis-decode). Walks the chunk list rather than assuming a fixed
+ * 44-byte header, so files with extra chunks (`LIST`, `fact`, …) still parse.
+ */
+export declare function parseWav(bytes: Uint8Array): ParsedWav;
+//# sourceMappingURL=audio.d.ts.map

package/dist/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../src/audio.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,kEAAkE;AAClE,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAMzC;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,WAAW,GAAG,YAAY,CAa1E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAiBvF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,YAAY,CA0Bd;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAYrD;AAED,MAAM,WAAW,SAAS;IACxB,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAOD;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,CAoErD"}

package/dist/audio.js

@@ -0,0 +1,197 @@
+/**
+ * Pure, dependency-free audio DSP for the local Whisper transcriber. sherpa's
+ * OfflineRecognizer wants Float32 mono PCM in [-1, 1] at 16 kHz; inbound audio
+ * arrives in several shapes, so these helpers convert each to that canonical
+ * form IN-PROCESS (no ffmpeg for raw PCM / WAV):
+ *
+ *   - `pcm16ToFloat32`  int16 little-endian bytes → Float32 in [-1, 1]
+ *   - `downmixToMono`   interleaved N-channel Float32 → averaged mono
+ *   - `resampleLinear`  linear-interpolation resample between two rates
+ *   - `parseWav`        RIFF/WAVE header parse → PCM16 samples (float) + rate +
+ *                       channels; rejects non-PCM16 (float/compressed) WAV
+ *
+ * The `decodeToMono16k` orchestrator (in ./decode.ts) drives these plus the
+ * ffmpeg path. Everything here is synchronous and unit-tested against synthetic
+ * fixtures — the header offsets and the resampler math are load-bearing.
+ */
+import { MoxxyError } from '@moxxy/sdk';
+/** The sample rate sherpa's Whisper feature extractor expects. */
+export const TARGET_SAMPLE_RATE = 16_000;
+/** Full-scale divisor: int16 spans [-32768, 32767]; dividing by 32768 keeps
+ *  the result in [-1, 1) without clipping the negative rail. */
+const INT16_SCALE = 32_768;
+/**
+ * Convert raw 16-bit little-endian PCM bytes to Float32 in [-1, 1]. A trailing
+ * odd byte (half a sample) is dropped. Channel interleaving is preserved — a
+ * stereo buffer stays interleaved, so callers downmix afterwards.
+ */
+export function pcm16ToFloat32(pcm) {
+    const bytes = pcm instanceof Uint8Array ? pcm : new Uint8Array(pcm);
+    const usable = bytes.byteLength & ~1; // drop a trailing odd byte
+    const count = usable / 2;
+    const out = new Float32Array(count);
+    // Read via DataView so we don't depend on the platform being little-endian
+    // and don't require the byte offset to be 2-aligned (a subarray view can
+    // start on an odd offset).
+    const view = new DataView(bytes.buffer, bytes.byteOffset, usable);
+    for (let i = 0; i < count; i += 1) {
+        out[i] = view.getInt16(i * 2, true) / INT16_SCALE;
+    }
+    return out;
+}
+/**
+ * Average `channels` interleaved Float32 channels down to mono. `channels` must
+ * be a positive integer; a value of 1 returns the input unchanged. Trailing
+ * samples that don't complete a frame are ignored.
+ */
+export function downmixToMono(interleaved, channels) {
+    if (!Number.isInteger(channels) || channels < 1) {
+        throw new MoxxyError({
+            code: 'INTERNAL',
+            message: `downmixToMono: invalid channel count ${channels}.`,
+        });
+    }
+    if (channels === 1)
+        return interleaved;
+    const frames = Math.floor(interleaved.length / channels);
+    const out = new Float32Array(frames);
+    for (let f = 0; f < frames; f += 1) {
+        let sum = 0;
+        const base = f * channels;
+        for (let c = 0; c < channels; c += 1)
+            sum += interleaved[base + c];
+        out[f] = sum / channels;
+    }
+    return out;
+}
+/**
+ * Resample mono Float32 audio from `fromRate` to `toRate` by linear
+ * interpolation. Cheap and dependency-free — good enough for speech recognition
+ * (Whisper is robust to the mild low-pass a linear kernel imposes). Returns the
+ * input unchanged when the rates match, and an empty array for empty input.
+ */
+export function resampleLinear(input, fromRate, toRate) {
+    if (!Number.isFinite(fromRate) || !Number.isFinite(toRate) || fromRate <= 0 || toRate <= 0) {
+        throw new MoxxyError({
+            code: 'INTERNAL',
+            message: `resampleLinear: invalid rate(s) from=${fromRate} to=${toRate}.`,
+        });
+    }
+    if (fromRate === toRate)
+        return input;
+    if (input.length === 0)
+        return new Float32Array(0);
+    if (input.length === 1)
+        return Float32Array.of(input[0]);
+    const ratio = fromRate / toRate;
+    const outLen = Math.max(1, Math.round(input.length / ratio));
+    const out = new Float32Array(outLen);
+    const lastIdx = input.length - 1;
+    for (let i = 0; i < outLen; i += 1) {
+        const srcPos = i * ratio;
+        const i0 = Math.floor(srcPos);
+        if (i0 >= lastIdx) {
+            out[i] = input[lastIdx];
+            continue;
+        }
+        const frac = srcPos - i0;
+        out[i] = input[i0] * (1 - frac) + input[i0 + 1] * frac;
+    }
+    return out;
+}
+/** True when `bytes` begins with the `RIFF….WAVE` magic of a WAV container. */
+export function isRiffWave(bytes) {
+    return (bytes.length >= 12 &&
+        bytes[0] === 0x52 && // R
+        bytes[1] === 0x49 && // I
+        bytes[2] === 0x46 && // F
+        bytes[3] === 0x46 && // F
+        bytes[8] === 0x57 && // W
+        bytes[9] === 0x41 && // A
+        bytes[10] === 0x56 && // V
+        bytes[11] === 0x45 // E
+    );
+}
+// WAV `fmt ` audio-format codes we care about.
+const WAVE_FORMAT_PCM = 1;
+const WAVE_FORMAT_IEEE_FLOAT = 3;
+const WAVE_FORMAT_EXTENSIBLE = 0xfffe;
+/**
+ * Parse a canonical RIFF/WAVE buffer into PCM16 samples. Only linear 16-bit PCM
+ * is accepted — IEEE-float, μ-law, and compressed WAV are rejected with a clear
+ * `CONFIG_INVALID` MoxxyError (the caller falls back to ffmpeg for real
+ * compressed formats, but a mislabelled/exotic WAV should fail loudly, not
+ * silently mis-decode). Walks the chunk list rather than assuming a fixed
+ * 44-byte header, so files with extra chunks (`LIST`, `fact`, …) still parse.
+ */
+export function parseWav(bytes) {
+    if (!isRiffWave(bytes)) {
+        throw wavError('not a RIFF/WAVE file (bad magic).');
+    }
+    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    let fmt = null;
+    let dataOffset = -1;
+    let dataLen = 0;
+    // Chunks begin right after `RIFF<size>WAVE` (offset 12). Each chunk is a
+    // 4-byte id + uint32 little-endian size + payload, word-aligned (odd payloads
+    // carry a pad byte).
+    let off = 12;
+    while (off + 8 <= bytes.byteLength) {
+        const id = ascii4(bytes, off);
+        const size = view.getUint32(off + 4, true);
+        const body = off + 8;
+        if (id === 'fmt ') {
+            if (body + 16 > bytes.byteLength)
+                throw wavError('truncated fmt chunk.');
+            fmt = {
+                format: view.getUint16(body, true),
+                channels: view.getUint16(body + 2, true),
+                sampleRate: view.getUint32(body + 4, true),
+                bitsPerSample: view.getUint16(body + 14, true),
+            };
+        }
+        else if (id === 'data') {
+            dataOffset = body;
+            // Clamp a declared size that overruns the buffer (some encoders write 0
+            // or 0xffffffff for streamed data) to what's actually present.
+            dataLen = Math.min(size, bytes.byteLength - body);
+        }
+        // Advance past the payload + pad byte. Guard against a zero/garbage size
+        // that would loop forever.
+        const advance = 8 + size + (size & 1);
+        if (advance <= 8)
+            break;
+        off += advance;
+    }
+    if (!fmt)
+        throw wavError('missing fmt chunk.');
+    if (dataOffset < 0)
+        throw wavError('missing data chunk.');
+    const { format, channels, sampleRate, bitsPerSample } = fmt;
+    if (!Number.isInteger(channels) || channels < 1) {
+        throw wavError(`unsupported channel count ${channels}.`);
+    }
+    if (!Number.isInteger(sampleRate) || sampleRate <= 0) {
+        throw wavError(`unsupported sample rate ${sampleRate}.`);
+    }
+    // Accept plain PCM; also accept EXTENSIBLE only when it's declared 16-bit PCM
+    // (a common wrapper the codecs emit for the same data). Reject float/exotic.
+    const isPcm16 = (format === WAVE_FORMAT_PCM || format === WAVE_FORMAT_EXTENSIBLE) && bitsPerSample === 16;
+    if (!isPcm16) {
+        const kind = format === WAVE_FORMAT_IEEE_FLOAT
+            ? 'IEEE float'
+            : format === WAVE_FORMAT_PCM || format === WAVE_FORMAT_EXTENSIBLE
+                ? `${bitsPerSample}-bit PCM`
+                : `format 0x${format.toString(16)}`;
+        throw wavError(`unsupported WAV encoding (${kind}). Only 16-bit PCM WAV is decoded in-process; re-export as PCM16 WAV, or install ffmpeg to decode other formats.`);
+    }
+    const pcm = bytes.subarray(dataOffset, dataOffset + dataLen);
+    return { samples: pcm16ToFloat32(pcm), sampleRate, channels };
+}
+function ascii4(bytes, off) {
+    return String.fromCharCode(bytes[off], bytes[off + 1], bytes[off + 2], bytes[off + 3]);
+}
+function wavError(detail) {
+    return new MoxxyError({ code: 'CONFIG_INVALID', message: `Invalid WAV audio: ${detail}` });
+}
+//# sourceMappingURL=audio.js.map

package/dist/audio.js.map

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

package/dist/decode.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The single entry point that turns whatever audio a caller hands the local
+ * Whisper transcriber into the Float32 mono @ 16 kHz that sherpa wants. It
+ * dispatches on the MIME type (with a RIFF magic sniff as a backstop):
+ *
+ *   - `MOXXY_PCM16_24KHZ_MIME` (the TUI/desktop mic) → int16→float32, then
+ *     linear-resample 24 kHz → 16 kHz. Never touches ffmpeg.
+ *   - `audio/wav` / `audio/x-wav`, or any buffer whose bytes start with the WAV
+ *     magic → parse the RIFF header (PCM16 only), downmix, resample. No ffmpeg.
+ *   - everything else (ogg/opus, mp3, m4a, webm, flac, …) → ffmpeg.
+ *
+ * The MIME string is UNTRUSTED (channels forward a messenger's `mime_type`
+ * verbatim), so it's runtime-guarded and canonicalized before matching.
+ */
+import type { spawn } from 'node:child_process';
+export interface DecodeOptions {
+    /** Injected `spawn` for the ffmpeg path (tests). Defaults to real `spawn`. */
+    readonly spawnImpl?: typeof spawn;
+}
+/**
+ * Decode `audio` to Float32 mono PCM in [-1, 1] at 16 kHz. Throws a MoxxyError
+ * for malformed WAV (non-PCM16) or when ffmpeg is needed but missing.
+ */
+export declare function decodeToMono16k(audio: Uint8Array | ArrayBuffer, mimeType: string | undefined, opts?: DecodeOptions): Promise<Float32Array>;
+//# sourceMappingURL=decode.d.ts.map

package/dist/decode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.d.ts","sourceRoot":"","sources":["../src/decode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAehD,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,UAAU,GAAG,WAAW,EAC/B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,YAAY,CAAC,CAuBvB"}

package/dist/decode.js

@@ -0,0 +1,50 @@
+/**
+ * The single entry point that turns whatever audio a caller hands the local
+ * Whisper transcriber into the Float32 mono @ 16 kHz that sherpa wants. It
+ * dispatches on the MIME type (with a RIFF magic sniff as a backstop):
+ *
+ *   - `MOXXY_PCM16_24KHZ_MIME` (the TUI/desktop mic) → int16→float32, then
+ *     linear-resample 24 kHz → 16 kHz. Never touches ffmpeg.
+ *   - `audio/wav` / `audio/x-wav`, or any buffer whose bytes start with the WAV
+ *     magic → parse the RIFF header (PCM16 only), downmix, resample. No ffmpeg.
+ *   - everything else (ogg/opus, mp3, m4a, webm, flac, …) → ffmpeg.
+ *
+ * The MIME string is UNTRUSTED (channels forward a messenger's `mime_type`
+ * verbatim), so it's runtime-guarded and canonicalized before matching.
+ */
+import { MOXXY_PCM16_24KHZ_MIME } from '@moxxy/sdk';
+import { downmixToMono, isRiffWave, parseWav, pcm16ToFloat32, resampleLinear, TARGET_SAMPLE_RATE, } from './audio.js';
+import { decodeViaFfmpeg } from './ffmpeg.js';
+/** The raw mic contract carries mono int16 @ this rate (see the SDK MIME tag). */
+const MOXXY_PCM16_SAMPLE_RATE = 24_000;
+/**
+ * Decode `audio` to Float32 mono PCM in [-1, 1] at 16 kHz. Throws a MoxxyError
+ * for malformed WAV (non-PCM16) or when ffmpeg is needed but missing.
+ */
+export async function decodeToMono16k(audio, mimeType, opts = {}) {
+    const bytes = audio instanceof Uint8Array ? audio : new Uint8Array(audio);
+    const mt = canonicalMime(mimeType);
+    // 1) Raw PCM16 mono @ 24 kHz from the moxxy mic recorder.
+    if (mt === MOXXY_PCM16_24KHZ_MIME) {
+        const mono = pcm16ToFloat32(bytes);
+        return resampleLinear(mono, MOXXY_PCM16_SAMPLE_RATE, TARGET_SAMPLE_RATE);
+    }
+    // 2) WAV — by declared MIME or by sniffing the RIFF/WAVE magic (a mislabelled
+    //    or MIME-less WAV still decodes in-process).
+    if (mt === 'audio/wav' || mt === 'audio/x-wav' || mt === 'audio/wave' || isRiffWave(bytes)) {
+        const wav = parseWav(bytes);
+        const mono = wav.channels > 1 ? downmixToMono(wav.samples, wav.channels) : wav.samples;
+        return wav.sampleRate === TARGET_SAMPLE_RATE
+            ? mono
+            : resampleLinear(mono, wav.sampleRate, TARGET_SAMPLE_RATE);
+    }
+    // 3) Everything else is a compressed container → ffmpeg (already resamples to
+    //    16 kHz mono for us).
+    return decodeViaFfmpeg(bytes, opts.spawnImpl);
+}
+/** Lower-case, strip a `; codecs=…` parameter, trim. Non-string → ''. */
+function canonicalMime(mimeType) {
+    const raw = typeof mimeType === 'string' ? mimeType : '';
+    return raw.toLowerCase().split(';')[0].trim();
+}
+//# sourceMappingURL=decode.js.map

package/dist/decode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.js","sourceRoot":"","sources":["../src/decode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGpD,OAAO,EACL,aAAa,EACb,UAAU,EACV,QAAQ,EACR,cAAc,EACd,cAAc,EACd,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,kFAAkF;AAClF,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAOvC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAA+B,EAC/B,QAA4B,EAC5B,OAAsB,EAAE;IAExB,MAAM,KAAK,GAAG,KAAK,YAAY,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IAC1E,MAAM,EAAE,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAEnC,0DAA0D;IAC1D,IAAI,EAAE,KAAK,sBAAsB,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACnC,OAAO,cAAc,CAAC,IAAI,EAAE,uBAAuB,EAAE,kBAAkB,CAAC,CAAC;IAC3E,CAAC;IAED,8EAA8E;IAC9E,iDAAiD;IACjD,IAAI,EAAE,KAAK,WAAW,IAAI,EAAE,KAAK,aAAa,IAAI,EAAE,KAAK,YAAY,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3F,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC;QACvF,OAAO,GAAG,CAAC,UAAU,KAAK,kBAAkB;YAC1C,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;IAC/D,CAAC;IAED,8EAA8E;IAC9E,0BAA0B;IAC1B,OAAO,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;AAChD,CAAC;AAED,yEAAyE;AACzE,SAAS,aAAa,CAAC,QAA4B;IACjD,MAAM,GAAG,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACzD,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;AACjD,CAAC"}

package/dist/ffmpeg.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The ffmpeg fallback for compressed audio (ogg/opus voice notes, mp3, m4a,
+ * webm, …) that we can't decode in-process. ffmpeg reads the container on stdin
+ * and writes raw 32-bit-float mono PCM at 16 kHz to stdout, which we read
+ * straight into a Float32Array — no intermediate WAV, no temp files.
+ *
+ * Gated behind a presence probe (mirrors channel-kit's voice-reply, cached per
+ * process; an injected `spawnImpl` bypasses the cache so tests are
+ * deterministic). When ffmpeg is absent we throw a clear, actionable MoxxyError
+ * — raw PCM16 and PCM16 WAV keep working without it, only compressed input
+ * needs it.
+ */
+import { spawn } from 'node:child_process';
+import { MoxxyError } from '@moxxy/sdk';
+/**
+ * Decode compressed audio bytes to Float32 mono @ 16 kHz via ffmpeg. Throws a
+ * `PLUGIN_LOAD_FAILED` MoxxyError (with an OS-specific install hint) when ffmpeg
+ * isn't on PATH, and an `INTERNAL` MoxxyError when ffmpeg runs but fails.
+ */
+export declare function decodeViaFfmpeg(audio: Uint8Array, spawnImpl?: typeof spawn): Promise<Float32Array>;
+/** The user-facing error raised when compressed audio arrives but ffmpeg is
+ *  absent. Exported so the decode orchestrator / tests can assert on it. */
+export declare function missingFfmpegError(): MoxxyError;
+/** Reset the cached ffmpeg probe (tests only). */
+export declare function __resetFfmpegProbeForTest(): void;
+//# sourceMappingURL=ffmpeg.d.ts.map

package/dist/ffmpeg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffmpeg.d.ts","sourceRoot":"","sources":["../src/ffmpeg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,OAAO,EAAkB,UAAU,EAAE,MAAM,YAAY,CAAC;AA2BxD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,UAAU,EACjB,SAAS,CAAC,EAAE,OAAO,KAAK,GACvB,OAAO,CAAC,YAAY,CAAC,CAKvB;AAED;4EAC4E;AAC5E,wBAAgB,kBAAkB,IAAI,UAAU,CAQ/C;AAaD,kDAAkD;AAClD,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}

package/dist/ffmpeg.js

@@ -0,0 +1,207 @@
+/**
+ * The ffmpeg fallback for compressed audio (ogg/opus voice notes, mp3, m4a,
+ * webm, …) that we can't decode in-process. ffmpeg reads the container on stdin
+ * and writes raw 32-bit-float mono PCM at 16 kHz to stdout, which we read
+ * straight into a Float32Array — no intermediate WAV, no temp files.
+ *
+ * Gated behind a presence probe (mirrors channel-kit's voice-reply, cached per
+ * process; an injected `spawnImpl` bypasses the cache so tests are
+ * deterministic). When ffmpeg is absent we throw a clear, actionable MoxxyError
+ * — raw PCM16 and PCM16 WAV keep working without it, only compressed input
+ * needs it.
+ */
+import { Buffer } from 'node:buffer';
+import { spawn } from 'node:child_process';
+import { getInstallHint, MoxxyError } from '@moxxy/sdk';
+import { TARGET_SAMPLE_RATE } from './audio.js';
+/** ffmpeg args: decode any input container → f32le mono @ 16 kHz on stdout. */
+const DECODE_ARGS = [
+    '-hide_banner',
+    '-loglevel',
+    'error',
+    '-i',
+    'pipe:0',
+    '-f',
+    'f32le',
+    '-ac',
+    '1',
+    '-ar',
+    String(TARGET_SAMPLE_RATE),
+    'pipe:1',
+];
+/** Ceiling on decoded PCM we buffer. At 16 kHz f32 mono (64 KB/s) this is ~30
+ *  minutes — well past any voice note, and bounds an adversarial input. */
+const MAX_DECODED_BYTES = 120 * 1024 * 1024;
+const PROBE_TIMEOUT_MS = 1_500;
+const DECODE_TIMEOUT_MS = 60_000;
+/**
+ * Decode compressed audio bytes to Float32 mono @ 16 kHz via ffmpeg. Throws a
+ * `PLUGIN_LOAD_FAILED` MoxxyError (with an OS-specific install hint) when ffmpeg
+ * isn't on PATH, and an `INTERNAL` MoxxyError when ffmpeg runs but fails.
+ */
+export async function decodeViaFfmpeg(audio, spawnImpl) {
+    const available = await probeFfmpeg(spawnImpl);
+    if (!available)
+        throw missingFfmpegError();
+    const raw = await runDecode(audio, spawnImpl ?? spawn);
+    return f32leToFloat32(raw);
+}
+/** The user-facing error raised when compressed audio arrives but ffmpeg is
+ *  absent. Exported so the decode orchestrator / tests can assert on it. */
+export function missingFfmpegError() {
+    const hint = getInstallHint('ffmpeg');
+    return new MoxxyError({
+        code: 'PLUGIN_LOAD_FAILED',
+        message: 'Local Whisper needs ffmpeg to decode compressed audio (ogg/opus, mp3, m4a, webm). Raw PCM and 16-bit PCM WAV transcribe without it.',
+        hint: `Install ffmpeg via ${hint.manager}: \`${hint.command}\`.`,
+    });
+}
+// Process-cached ffmpeg availability (the probe spawns a subprocess; caching
+// keeps a chatty voice channel from re-probing on every note). An injected
+// `spawnImpl` (tests) bypasses the cache.
+let ffmpegAvailable = null;
+async function probeFfmpeg(spawnImpl) {
+    if (spawnImpl)
+        return runProbe(spawnImpl);
+    ffmpegAvailable ??= runProbe(spawn);
+    return ffmpegAvailable;
+}
+/** Reset the cached ffmpeg probe (tests only). */
+export function __resetFfmpegProbeForTest() {
+    ffmpegAvailable = null;
+}
+function runProbe(spawnImpl, command = 'ffmpeg') {
+    return new Promise((resolve) => {
+        let settled = false;
+        const done = (v) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve(v);
+        };
+        let child;
+        try {
+            child = spawnImpl(command, ['-version'], { stdio: ['ignore', 'ignore', 'ignore'] });
+        }
+        catch {
+            resolve(false);
+            return;
+        }
+        const timer = setTimeout(() => {
+            try {
+                if (!child.killed)
+                    child.kill('SIGKILL');
+            }
+            catch {
+                /* ignore */
+            }
+            done(false);
+        }, PROBE_TIMEOUT_MS);
+        timer.unref?.();
+        child.once('error', () => done(false));
+        child.once('close', (code) => done(code === 0));
+    });
+}
+function runDecode(audio, spawnImpl, command = 'ffmpeg') {
+    return new Promise((resolve, reject) => {
+        let child;
+        try {
+            child = spawnImpl(command, DECODE_ARGS, { stdio: ['pipe', 'pipe', 'pipe'] });
+        }
+        catch (err) {
+            reject(decodeFailure(err instanceof Error ? err.message : String(err)));
+            return;
+        }
+        const out = [];
+        const errChunks = [];
+        let outBytes = 0;
+        let over = false;
+        let settled = false;
+        const finish = (fn) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            fn();
+        };
+        const timer = setTimeout(() => {
+            try {
+                if (!child.killed)
+                    child.kill('SIGKILL');
+            }
+            catch {
+                /* ignore */
+            }
+            finish(() => reject(decodeFailure('ffmpeg decode timed out')));
+        }, DECODE_TIMEOUT_MS);
+        timer.unref?.();
+        child.stdout?.on('data', (c) => {
+            if (over)
+                return;
+            if (outBytes + c.byteLength > MAX_DECODED_BYTES) {
+                over = true;
+                try {
+                    child.kill('SIGKILL');
+                }
+                catch {
+                    /* ignore */
+                }
+                finish(() => reject(decodeFailure('decoded audio exceeded the size limit')));
+                return;
+            }
+            outBytes += c.byteLength;
+            out.push(Buffer.from(c));
+        });
+        child.stderr?.on('data', (c) => {
+            errChunks.push(Buffer.from(c));
+            while (Buffer.concat(errChunks).byteLength > 4_096)
+                errChunks.shift();
+        });
+        child.once('error', (err) => finish(() => reject(decodeFailure(err instanceof Error ? err.message : String(err)))));
+        child.once('close', (code) => finish(() => {
+            if (over)
+                return; // already rejected on the size cap
+            if (code === 0 && out.length > 0) {
+                resolve(Buffer.concat(out));
+            }
+            else if (code === 0) {
+                reject(decodeFailure('ffmpeg produced no audio'));
+            }
+            else {
+                reject(decodeFailure(`ffmpeg exited ${code}: ${Buffer.concat(errChunks).toString('utf8').trim()}`));
+            }
+        }));
+        const stdin = child.stdin;
+        if (stdin) {
+            stdin.on('error', () => {
+                // EPIPE if ffmpeg died before consuming stdin — the close/error handler
+                // reports the real failure; swallow this to avoid an unhandled 'error'.
+            });
+            try {
+                stdin.end(Buffer.from(audio));
+            }
+            catch {
+                /* the close/error path reports it */
+            }
+        }
+    });
+}
+/** Reinterpret little-endian float32 bytes as a Float32Array. Copies through a
+ *  DataView so a non-4-aligned Buffer offset and big-endian hosts both work. */
+function f32leToFloat32(buf) {
+    const usable = buf.byteLength - (buf.byteLength % 4);
+    const count = usable / 4;
+    const out = new Float32Array(count);
+    const view = new DataView(buf.buffer, buf.byteOffset, usable);
+    for (let i = 0; i < count; i += 1)
+        out[i] = view.getFloat32(i * 4, true);
+    return out;
+}
+function decodeFailure(detail) {
+    return new MoxxyError({
+        code: 'INTERNAL',
+        message: `Local Whisper failed to decode audio with ffmpeg: ${detail}`,
+    });
+}
+//# sourceMappingURL=ffmpeg.js.map

package/dist/ffmpeg.js.map

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