@moxxy/plugin-stt-whisper 0.27.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,52 @@
+/**
+ * Audio helpers shared across STT plugins. Whisper-family backends — the
+ * generic OpenAI Whisper endpoint, the Codex OAuth `/transcribe` proxy,
+ * any future Whisper-compatible vendor — all want the same preprocessing
+ * (filename inference from MIME, raw PCM16 → WAV wrapping). Centralizing
+ * them here keeps the wrapper plugins thin.
+ */
+import { MOXXY_PCM16_24KHZ_MIME } from '@moxxy/sdk';
+/** A custom MIME tag used by the TUI voice recorder to flag raw PCM16
+ *  mono @ 24kHz bytes (ffmpeg's `-f s16le` output) so the transcriber
+ *  knows to wrap them in a WAV header before upload. Public so other
+ *  recorders / channels can mark their captures identically. Sourced from
+ *  the SDK's zero-dep cross-package source of truth; re-exported here so the
+ *  existing `@moxxy/plugin-stt-whisper` surface stays stable. */
+export { MOXXY_PCM16_24KHZ_MIME };
+/** Default filename per MIME type, used to set the upload `filename` so
+ *  the vendor's content sniffer routes to the right decoder. Defaults to
+ *  `audio.bin` for anything unmapped.
+ *
+ *  The MIME string is caller-supplied and can be fully untrusted (the
+ *  Telegram voice path forwards `media.mime_type` verbatim). A plain object
+ *  literal would let a crafted MIME equal to an inherited member name
+ *  ('constructor', 'toString', '__proto__', …) resolve to a function/object
+ *  instead of `undefined`, defeating the `?? 'audio.bin'` fallback. Using a
+ *  null-prototype map closes that hole; lookups can only hit own keys. */
+export declare const WHISPER_FILENAME_BY_MIME: Readonly<Record<string, string>>;
+export interface NormalizedAudioUpload {
+    readonly bytes: Uint8Array;
+    readonly mimeType: string;
+    readonly filename: string;
+}
+/**
+ * Normalize a raw audio buffer for upload to a Whisper-family endpoint.
+ *
+ * - If the input is `MOXXY_PCM16_24KHZ_MIME`, wraps the raw samples in a
+ *   WAV header (samples are mono, 24kHz, 16-bit little-endian) and
+ *   reports the upload as `audio/wav`.
+ * - Otherwise passes the bytes through and picks a filename from the
+ *   MIME table (or `audio.bin` for unknown types).
+ *
+ * The optional `filenamePrefix` lets callers brand the upload filename
+ * (e.g. Codex uses `moxxy.wav`); when omitted the default `audio.<ext>`
+ * shape is used.
+ */
+export declare function normalizeWhisperUpload(audio: Uint8Array | ArrayBuffer, mimeType: string | undefined, filenamePrefix?: string): NormalizedAudioUpload;
+/**
+ * Wrap raw PCM16 mono samples in a WAV container. Used by recorders that
+ * stream `s16le` (ffmpeg's default raw output) so the bytes can be sent
+ * to endpoints that only accept container formats.
+ */
+export declare function pcm16MonoToWav(pcm: Uint8Array | ArrayBuffer, sampleRate?: number): Uint8Array;
+//# 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;;;;;;GAMG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;;iEAKiE;AACjE,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAElC;;;;;;;;;0EAS0E;AAC1E,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYlE,CAAC;AAEL,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,UAAU,GAAG,WAAW,EAC/B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,cAAc,CAAC,EAAE,MAAM,GACtB,qBAAqB,CA8BvB;AAWD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,WAAW,EAAE,UAAU,SAAS,GAAG,UAAU,CAgC7F"}

package/dist/audio.js

@@ -0,0 +1,129 @@
+/**
+ * Audio helpers shared across STT plugins. Whisper-family backends — the
+ * generic OpenAI Whisper endpoint, the Codex OAuth `/transcribe` proxy,
+ * any future Whisper-compatible vendor — all want the same preprocessing
+ * (filename inference from MIME, raw PCM16 → WAV wrapping). Centralizing
+ * them here keeps the wrapper plugins thin.
+ */
+import { MOXXY_PCM16_24KHZ_MIME } from '@moxxy/sdk';
+/** A custom MIME tag used by the TUI voice recorder to flag raw PCM16
+ *  mono @ 24kHz bytes (ffmpeg's `-f s16le` output) so the transcriber
+ *  knows to wrap them in a WAV header before upload. Public so other
+ *  recorders / channels can mark their captures identically. Sourced from
+ *  the SDK's zero-dep cross-package source of truth; re-exported here so the
+ *  existing `@moxxy/plugin-stt-whisper` surface stays stable. */
+export { MOXXY_PCM16_24KHZ_MIME };
+/** Default filename per MIME type, used to set the upload `filename` so
+ *  the vendor's content sniffer routes to the right decoder. Defaults to
+ *  `audio.bin` for anything unmapped.
+ *
+ *  The MIME string is caller-supplied and can be fully untrusted (the
+ *  Telegram voice path forwards `media.mime_type` verbatim). A plain object
+ *  literal would let a crafted MIME equal to an inherited member name
+ *  ('constructor', 'toString', '__proto__', …) resolve to a function/object
+ *  instead of `undefined`, defeating the `?? 'audio.bin'` fallback. Using a
+ *  null-prototype map closes that hole; lookups can only hit own keys. */
+export const WHISPER_FILENAME_BY_MIME = 
+/* null-prototype: see comment above */ Object.assign(Object.create(null), {
+    'audio/ogg': 'audio.ogg',
+    'audio/opus': 'audio.opus',
+    'audio/mpeg': 'audio.mp3',
+    'audio/mp3': 'audio.mp3',
+    'audio/wav': 'audio.wav',
+    'audio/x-wav': 'audio.wav',
+    'audio/webm': 'audio.webm',
+    'audio/m4a': 'audio.m4a',
+    'audio/mp4': 'audio.mp4',
+    'audio/flac': 'audio.flac',
+});
+/**
+ * Normalize a raw audio buffer for upload to a Whisper-family endpoint.
+ *
+ * - If the input is `MOXXY_PCM16_24KHZ_MIME`, wraps the raw samples in a
+ *   WAV header (samples are mono, 24kHz, 16-bit little-endian) and
+ *   reports the upload as `audio/wav`.
+ * - Otherwise passes the bytes through and picks a filename from the
+ *   MIME table (or `audio.bin` for unknown types).
+ *
+ * The optional `filenamePrefix` lets callers brand the upload filename
+ * (e.g. Codex uses `moxxy.wav`); when omitted the default `audio.<ext>`
+ * shape is used.
+ */
+export function normalizeWhisperUpload(audio, mimeType, filenamePrefix) {
+    const bytes = audio instanceof Uint8Array ? audio : new Uint8Array(audio);
+    // MIME types are case-insensitive (RFC 2045) and may carry a `; codecs=…`
+    // parameter; some callers (Telegram) forward the header verbatim without
+    // normalizing. Canonicalize once so casing/params don't miss the table.
+    //
+    // `mimeType` is *typed* `string | undefined`, but the value crosses a trust
+    // boundary unvalidated: the Telegram path forwards `media.mime_type` from raw
+    // update JSON, which a crafted message could make a number/object/array.
+    // Guard the runtime type so `.toLowerCase()` can't throw on hostile input —
+    // anything non-string degrades to the default rather than crashing the path.
+    const rawMime = typeof mimeType === 'string' ? mimeType : '';
+    const mt = (rawMime || 'audio/wav').toLowerCase().split(';')[0].trim();
+    if (mt === MOXXY_PCM16_24KHZ_MIME) {
+        return {
+            bytes: pcm16MonoToWav(bytes, 24_000),
+            mimeType: 'audio/wav',
+            filename: rename(filenamePrefix, 'wav') ?? 'audio.wav',
+        };
+    }
+    // Null-prototype map + string guard: an untrusted MIME can't surface an
+    // inherited member (function/object), so the upload filename is always a
+    // real string and `extOf` never receives a non-string.
+    const mapped = WHISPER_FILENAME_BY_MIME[mt];
+    const defaultName = typeof mapped === 'string' ? mapped : 'audio.bin';
+    return {
+        bytes,
+        mimeType: mt,
+        filename: rename(filenamePrefix, extOf(defaultName)) ?? defaultName,
+    };
+}
+function rename(prefix, ext) {
+    return prefix ? `${prefix}.${ext}` : undefined;
+}
+function extOf(filename) {
+    const dot = filename.lastIndexOf('.');
+    return dot >= 0 ? filename.slice(dot + 1) : 'bin';
+}
+/**
+ * Wrap raw PCM16 mono samples in a WAV container. Used by recorders that
+ * stream `s16le` (ffmpeg's default raw output) so the bytes can be sent
+ * to endpoints that only accept container formats.
+ */
+export function pcm16MonoToWav(pcm, sampleRate = 24_000) {
+    const raw = pcm instanceof Uint8Array ? pcm : new Uint8Array(pcm);
+    // 16-bit samples are 2 bytes; a trailing odd byte is half a sample and
+    // breaks RIFF even-alignment, so drop it. `subarray` is a view, no copy.
+    const data = raw.byteLength & 1 ? raw.subarray(0, raw.byteLength & ~1) : raw;
+    // The RIFF/data chunk sizes are unsigned 32-bit; >~4GiB would silently
+    // wrap to a tiny size and emit a structurally corrupt WAV. Reject loudly.
+    if (data.byteLength > 0xffffffff - 36) {
+        throw new RangeError(`PCM payload too large for a WAV container (${data.byteLength} bytes; max ${0xffffffff - 36}).`);
+    }
+    const headerBytes = 44;
+    const wav = new Uint8Array(headerBytes + data.byteLength);
+    const view = new DataView(wav.buffer);
+    writeAscii(wav, 0, 'RIFF');
+    view.setUint32(4, 36 + data.byteLength, true);
+    writeAscii(wav, 8, 'WAVE');
+    writeAscii(wav, 12, 'fmt ');
+    view.setUint32(16, 16, true);
+    view.setUint16(20, 1, true);
+    view.setUint16(22, 1, true);
+    view.setUint32(24, sampleRate, true);
+    view.setUint32(28, sampleRate * 2, true);
+    view.setUint16(32, 2, true);
+    view.setUint16(34, 16, true);
+    writeAscii(wav, 36, 'data');
+    view.setUint32(40, data.byteLength, true);
+    wav.set(data, headerBytes);
+    return wav;
+}
+function writeAscii(target, offset, value) {
+    for (let i = 0; i < value.length; i += 1) {
+        target[offset + i] = value.charCodeAt(i);
+    }
+}
+//# 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/index.d.ts

@@ -0,0 +1,38 @@
+import { type Plugin } from '@moxxy/sdk';
+import { type WhisperModel, type WhisperTranscriberOptions } from './whisper.js';
+export { WhisperTranscriber, createWhisperTranscriber, type WhisperModel, type WhisperTranscriberOptions, } from './whisper.js';
+export { MOXXY_PCM16_24KHZ_MIME, WHISPER_FILENAME_BY_MIME, normalizeWhisperUpload, pcm16MonoToWav, type NormalizedAudioUpload, } from './audio.js';
+export interface BuildWhisperPluginOptions {
+    /**
+     * Default model used when the host calls `session.transcribers.setActive(name)`
+     * without an explicit config. Defaults to `whisper-1`.
+     */
+    readonly model?: WhisperModel;
+    /**
+     * Optional default config baked into the transcriber def. Callers can
+     * still override per-`setActive(name, config)`.
+     */
+    readonly defaults?: Omit<WhisperTranscriberOptions, 'client'>;
+}
+/**
+ * Build the @moxxy/plugin-stt-whisper plugin. Each instance registers
+ * exactly one transcriber, named `openai-<model>`.
+ *
+ * To run several Whisper-family models at once, build the plugin once per
+ * model — the transcriber names won't collide (`openai-whisper-1` vs
+ * `openai-gpt-4o-transcribe`), but each registration carries the SAME
+ * plugin name, so the host must register them under DISTINCT plugin names
+ * (the name-keyed plugin registry would otherwise clobber the first).
+ *
+ * Activation:
+ *   session.transcribers.setActive('openai-whisper-1', { apiKey: ... });
+ *
+ * The plugin is intentionally side-effect free — registering it does
+ * NOT activate the transcriber. The host (CLI / config loader) chooses
+ * activation explicitly so users on local providers aren't surprised by
+ * outbound calls to OpenAI.
+ */
+export declare function buildWhisperPlugin(opts?: BuildWhisperPluginOptions): 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;AAC1E,OAAO,EAAsB,KAAK,YAAY,EAAE,KAAK,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAErG,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,YAAY,EACjB,KAAK,yBAAyB,GAC/B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,cAAc,EACd,KAAK,qBAAqB,GAC3B,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,yBAAyB,EAAE,QAAQ,CAAC,CAAC;CAC/D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,yBAA8B,GAAG,MAAM,CAqB/E;;AAGD,wBAAoC"}

package/dist/index.js

@@ -0,0 +1,47 @@
+import { definePlugin, defineTranscriber } from '@moxxy/sdk';
+import { WhisperTranscriber } from './whisper.js';
+export { WhisperTranscriber, createWhisperTranscriber, } from './whisper.js';
+export { MOXXY_PCM16_24KHZ_MIME, WHISPER_FILENAME_BY_MIME, normalizeWhisperUpload, pcm16MonoToWav, } from './audio.js';
+/**
+ * Build the @moxxy/plugin-stt-whisper plugin. Each instance registers
+ * exactly one transcriber, named `openai-<model>`.
+ *
+ * To run several Whisper-family models at once, build the plugin once per
+ * model — the transcriber names won't collide (`openai-whisper-1` vs
+ * `openai-gpt-4o-transcribe`), but each registration carries the SAME
+ * plugin name, so the host must register them under DISTINCT plugin names
+ * (the name-keyed plugin registry would otherwise clobber the first).
+ *
+ * Activation:
+ *   session.transcribers.setActive('openai-whisper-1', { apiKey: ... });
+ *
+ * The plugin is intentionally side-effect free — registering it does
+ * NOT activate the transcriber. The host (CLI / config loader) chooses
+ * activation explicitly so users on local providers aren't surprised by
+ * outbound calls to OpenAI.
+ */
+export function buildWhisperPlugin(opts = {}) {
+    const model = opts.model ?? 'whisper-1';
+    const name = `openai-${model}`;
+    return definePlugin({
+        name: '@moxxy/plugin-stt-whisper',
+        version: '0.0.0',
+        transcribers: [
+            defineTranscriber({
+                name,
+                displayName: `OpenAI ${model}`,
+                createClient: (config) => {
+                    const merged = {
+                        ...(opts.defaults ?? {}),
+                        ...config,
+                        model,
+                    };
+                    return new WhisperTranscriber(merged);
+                },
+            }),
+        ],
+    });
+}
+// Discovery entry: `createPluginLoader` requires a default Plugin export.
+export default buildWhisperPlugin();
+//# 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;AAC1E,OAAO,EAAE,kBAAkB,EAAqD,MAAM,cAAc,CAAC;AAErG,OAAO,EACL,kBAAkB,EAClB,wBAAwB,GAGzB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,cAAc,GAEf,MAAM,YAAY,CAAC;AAepB;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAkC,EAAE;IACrE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC;IACxC,MAAM,IAAI,GAAG,UAAU,KAAK,EAAE,CAAC;IAC/B,OAAO,YAAY,CAAC;QAClB,IAAI,EAAE,2BAA2B;QACjC,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE;YACZ,iBAAiB,CAAC;gBAChB,IAAI;gBACJ,WAAW,EAAE,UAAU,KAAK,EAAE;gBAC9B,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;oBACvB,MAAM,MAAM,GAA8B;wBACxC,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;wBACxB,GAAI,MAAoC;wBACxC,KAAK;qBACN,CAAC;oBACF,OAAO,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;gBACxC,CAAC;aACF,CAAC;SACH;KACF,CAAC,CAAC;AACL,CAAC;AAED,0EAA0E;AAC1E,eAAe,kBAAkB,EAAE,CAAC"}

package/dist/whisper.d.ts

@@ -0,0 +1,40 @@
+import OpenAI from 'openai';
+import { type Transcriber, type TranscribeOptions, type TranscriptionResult } from '@moxxy/sdk';
+export type WhisperModel = 'whisper-1' | 'gpt-4o-transcribe' | 'gpt-4o-mini-transcribe';
+export interface WhisperTranscriberOptions {
+    readonly apiKey?: string;
+    readonly baseURL?: string;
+    /** Defaults to `whisper-1`. */
+    readonly model?: WhisperModel;
+    /**
+     * Default language hint (BCP-47). Overridden per-call by
+     * `TranscribeOptions.language`. Omit to let Whisper auto-detect.
+     */
+    readonly language?: string;
+    /** Inject a pre-built OpenAI client (tests pass a stub here). */
+    readonly client?: OpenAI;
+}
+/**
+ * `Transcriber` backed by OpenAI's audio.transcriptions endpoint
+ * (Whisper-1 by default). Requests `verbose_json` so we can return
+ * `language`, `durationSec`, and per-segment text without an extra call.
+ *
+ * Audio bytes come in as `Uint8Array | ArrayBuffer`; we wrap them in a
+ * Node `File` for upload (Node 20.10+ provides File / Blob globals).
+ */
+export declare class WhisperTranscriber implements Transcriber {
+    readonly name: string;
+    private readonly client;
+    private readonly model;
+    private readonly defaultLanguage;
+    constructor(opts?: WhisperTranscriberOptions);
+    transcribe(audio: Uint8Array | ArrayBuffer, opts?: TranscribeOptions): Promise<TranscriptionResult>;
+    /**
+     * Run an SDK transcription call, translating failures into structured
+     * `MoxxyError`s (network vs. HTTP status) to match the codex sibling.
+     * User aborts re-throw unchanged so cancellation isn't masked as an error.
+     */
+    private run;
+}
+export declare function createWhisperTranscriber(opts?: WhisperTranscriberOptions): WhisperTranscriber;
+//# sourceMappingURL=whisper.d.ts.map

package/dist/whisper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whisper.d.ts","sourceRoot":"","sources":["../src/whisper.ts"],"names":[],"mappings":"AAAA,OAAO,MAA2D,MAAM,QAAQ,CAAC;AACjF,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AAGpB,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,mBAAmB,GAAG,wBAAwB,CAAC;AAKxF,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;gBAEzC,IAAI,GAAE,yBAA8B;IAY1C,UAAU,CACd,KAAK,EAAE,UAAU,GAAG,WAAW,EAC/B,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,mBAAmB,CAAC;IAkE/B;;;;OAIG;YACW,GAAG;CA0BlB;AAqDD,wBAAgB,wBAAwB,CAAC,IAAI,GAAE,yBAA8B,GAAG,kBAAkB,CAEjG"}

package/dist/whisper.js

@@ -0,0 +1,161 @@
+import OpenAI, { APIError, APIConnectionError, APIUserAbortError } from 'openai';
+import { classifyHttpStatus, classifyNetworkError, MoxxyError, } from '@moxxy/sdk';
+import { normalizeWhisperUpload } from './audio.js';
+/** Provider tag attached to classified errors for logs/debug context. */
+const WHISPER_PROVIDER_ID = 'openai';
+/**
+ * `Transcriber` backed by OpenAI's audio.transcriptions endpoint
+ * (Whisper-1 by default). Requests `verbose_json` so we can return
+ * `language`, `durationSec`, and per-segment text without an extra call.
+ *
+ * Audio bytes come in as `Uint8Array | ArrayBuffer`; we wrap them in a
+ * Node `File` for upload (Node 20.10+ provides File / Blob globals).
+ */
+export class WhisperTranscriber {
+    name;
+    client;
+    model;
+    defaultLanguage;
+    constructor(opts = {}) {
+        this.model = opts.model ?? 'whisper-1';
+        this.name = `openai-${this.model}`;
+        this.defaultLanguage = opts.language;
+        this.client =
+            opts.client ??
+                new OpenAI({
+                    apiKey: opts.apiKey ?? process.env.OPENAI_API_KEY,
+                    ...(opts.baseURL ? { baseURL: opts.baseURL } : {}),
+                });
+    }
+    async transcribe(audio, opts = {}) {
+        // Route through the shared Whisper-family preprocessor so the project's
+        // raw-PCM16 contract (MOXXY_PCM16_24KHZ_MIME) gets WAV-wrapped and filename
+        // inference stays in lockstep with the Codex sibling. Default the MIME to
+        // `audio/ogg` to preserve prior behavior for callers that omit it.
+        const upload = normalizeWhisperUpload(audio, opts.mimeType ?? 'audio/ogg');
+        // Node 20.10+ exposes File globally; the OpenAI SDK accepts it as
+        // an `Uploadable`.
+        const file = new File([upload.bytes], upload.filename, { type: upload.mimeType });
+        const language = opts.language ?? this.defaultLanguage;
+        // verbose_json is only supported by whisper-1; the gpt-4o family
+        // returns plain JSON. Branch so callers get rich segments when
+        // available, and a graceful text-only result when not.
+        if (this.model === 'whisper-1') {
+            const response = await this.run(() => this.client.audio.transcriptions.create({
+                model: this.model,
+                file,
+                response_format: 'verbose_json',
+                ...(language ? { language } : {}),
+                ...(opts.prompt ? { prompt: opts.prompt } : {}),
+            }, { signal: opts.signal }));
+            // OpenAI verbose-json response: { text, language, duration, segments[] }
+            const r = requireTextResponse(response);
+            const result = { text: r.text };
+            if (typeof r.language === 'string')
+                result.language = r.language;
+            if (typeof r.duration === 'number')
+                result.durationSec = r.duration;
+            if (Array.isArray(r.segments)) {
+                // The vendor response is untrusted: a malformed/partial `segments`
+                // entry (`null`, a non-object, or one missing the numeric start/end /
+                // string text) would either crash the blind `.start` read or leak a
+                // value that violates the `TranscriptionSegment` type contract.
+                // Validate each element and drop the ones that don't conform rather
+                // than crashing or emitting `{ text: 123 }` downstream.
+                result.segments = sanitizeSegments(r.segments);
+            }
+            return result;
+        }
+        const response = await this.run(() => this.client.audio.transcriptions.create({
+            model: this.model,
+            file,
+            ...(language ? { language } : {}),
+            ...(opts.prompt ? { prompt: opts.prompt } : {}),
+        }, { signal: opts.signal }));
+        return { text: requireTextResponse(response).text };
+    }
+    /**
+     * Run an SDK transcription call, translating failures into structured
+     * `MoxxyError`s (network vs. HTTP status) to match the codex sibling.
+     * User aborts re-throw unchanged so cancellation isn't masked as an error.
+     */
+    async run(call) {
+        try {
+            return await call();
+        }
+        catch (err) {
+            // Intentional cancellation: propagate as-is so callers see the abort.
+            if (err instanceof APIUserAbortError)
+                throw err;
+            const ctx = { provider: WHISPER_PROVIDER_ID, url: this.client.baseURL };
+            if (err instanceof APIConnectionError) {
+                const network = classifyNetworkError(err.cause ?? err, ctx);
+                if (network)
+                    throw network;
+            }
+            if (err instanceof APIError && typeof err.status === 'number') {
+                const classified = classifyHttpStatus(err.status, { ...ctx, body: err.message });
+                if (classified)
+                    throw classified;
+                throw new MoxxyError({
+                    code: 'PROVIDER_BAD_REQUEST',
+                    message: `OpenAI transcription returned HTTP ${err.status}.`,
+                    context: { ...ctx, status: err.status },
+                    cause: err,
+                });
+            }
+            const network = classifyNetworkError(err, ctx);
+            if (network)
+                throw network;
+            throw err;
+        }
+    }
+}
+/**
+ * Validate that an OpenAI transcription response carries a string `text`
+ * field before we trust it. The SDK's union return type is wider than what
+ * we consume, so we narrow it here; a response missing `text` (or whose
+ * `text` isn't a string) is a real contract violation worth surfacing as a
+ * structured error rather than silently returning `{ text: undefined }`.
+ */
+function requireTextResponse(response) {
+    if (!response ||
+        typeof response !== 'object' ||
+        typeof response.text !== 'string') {
+        throw new MoxxyError({
+            code: 'PROVIDER_UNKNOWN_RESPONSE',
+            message: 'OpenAI transcription response was missing a text field.',
+            context: { provider: WHISPER_PROVIDER_ID },
+        });
+    }
+    return response;
+}
+/**
+ * Defensively narrow an untrusted `segments` array from a vendor response into
+ * the well-typed `TranscriptionSegment[]` contract. Each element is validated
+ * to be an object carrying finite numeric `start`/`end` and a string `text`;
+ * non-conforming entries (`null`, primitives, NaN/Infinity bounds, missing
+ * fields) are dropped so a hostile/partial response degrades to fewer (or zero)
+ * segments instead of crashing the caller or leaking off-contract values.
+ */
+function sanitizeSegments(raw) {
+    const out = [];
+    for (const seg of raw) {
+        if (!seg || typeof seg !== 'object')
+            continue;
+        const s = seg;
+        if (typeof s.start !== 'number' ||
+            typeof s.end !== 'number' ||
+            typeof s.text !== 'string' ||
+            !Number.isFinite(s.start) ||
+            !Number.isFinite(s.end)) {
+            continue;
+        }
+        out.push({ start: s.start, end: s.end, text: s.text });
+    }
+    return out;
+}
+export function createWhisperTranscriber(opts = {}) {
+    return new WhisperTranscriber(opts);
+}
+//# sourceMappingURL=whisper.js.map

package/dist/whisper.js.map

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

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@moxxy/plugin-stt-whisper",
+  "version": "0.27.0",
+  "description": "OpenAI Whisper Transcriber for moxxy. Audio bytes → text + segments. Plugs into the session's TranscriberRegistry; channels with audio input (Telegram voice, HTTP multipart) consume it transparently.",
+  "keywords": [
+    "moxxy",
+    "agent",
+    "stt",
+    "whisper",
+    "transcriber"
+  ],
+  "homepage": "https://moxxy.ai",
+  "bugs": {
+    "url": "https://github.com/moxxy-ai/moxxy/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/moxxy-ai/moxxy.git",
+    "directory": "packages/plugin-stt-whisper"
+  },
+  "author": "Michal Makowski <michal.makowski97@gmail.com>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "moxxy": {
+    "plugin": {
+      "entry": "./dist/index.js",
+      "kind": "transcriber"
+    }
+  },
+  "dependencies": {
+    "openai": "^4.80.0",
+    "@moxxy/sdk": "0.27.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.8",
+    "@moxxy/tsconfig": "0.0.0",
+    "@moxxy/vitest-preset": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist .turbo"
+  }
+}