@moxxy/plugin-stt-local 0.44.0 → 0.46.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { type Plugin } from '@moxxy/sdk';
 import { type LocalWhisperOptions } from './local-stt.js';
 export { LocalWhisperTranscriber, createLocalWhisperTranscriber, shutdownLocalStt, LOCAL_WHISPER_TRANSCRIBER_NAME, type LocalWhisperOptions, type WhisperModelPaths, } from './local-stt.js';
-export { MODEL_CATALOG, DEFAULT_MODEL_ID, modelIds, findModel, requireModel, type WhisperModelEntry, type WhisperModelId, } from './models.js';
+export { MODEL_CATALOG, DEFAULT_MODEL_ID, modelIds, findModel, requireModel, modelFiles, modelBytes, modelDir, defaultModelsDir, type WhisperModelEntry, type WhisperModelId, } from './models.js';
 export { pcm16ToFloat32, downmixToMono, resampleLinear, parseWav, isRiffWave, TARGET_SAMPLE_RATE, type ParsedWav, } from './audio.js';
 export { decodeToMono16k, type DecodeOptions } from './decode.js';
 export { decodeViaFfmpeg, missingFfmpegError, __resetFfmpegProbeForTest, } from './ffmpeg.js';
@@ -9,7 +9,7 @@ export { HostClient, type HostClientLike, type ForkLike, type ChildHandle } from
 export { sherpaPlatformPackage, resolveSherpaLibDir, sherpaEnv, libraryPathVar, } from './platform.js';
 export interface BuildLocalSttPluginOptions {
     /** Build-time defaults / test seams for the transcriber (injected
-     *  `ensureModelImpl`, `hostFactory`, `fetchImpl`, `modelsDir`, `log`, …). */
+     *  `ensureModelFilesImpl`, `hostFactory`, `fetchImpl`, `modelsDir`, `log`, …). */
     readonly defaults?: LocalWhisperOptions;
 }
 /**

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAE1E,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,gBAAgB,EAChB,8BAA8B,EAC9B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,aAAa,EACb,cAAc,EACd,QAAQ,EACR,UAAU,EACV,kBAAkB,EAClB,KAAK,SAAS,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,KAAK,cAAc,EAAE,KAAK,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpG,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,SAAS,EACT,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,0BAA0B;IACzC;iFAC6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CACzC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,0BAA+B,GAAG,MAAM,CAgBjF;;AAsBD,wBAAqC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAE1E,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,gBAAgB,EAChB,8BAA8B,EAC9B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,UAAU,EACV,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,aAAa,EACb,cAAc,EACd,QAAQ,EACR,UAAU,EACV,kBAAkB,EAClB,KAAK,SAAS,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,KAAK,cAAc,EAAE,KAAK,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpG,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,SAAS,EACT,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,0BAA0B;IACzC;sFACkF;IAClF,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CACzC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,0BAA+B,GAAG,MAAM,CAgBjF;;AAsBD,wBAAqC"}

package/dist/index.js

@@ -1,7 +1,7 @@
 import { definePlugin, defineTranscriber } from '@moxxy/sdk';
 import { createLocalWhisperTranscriber, LOCAL_WHISPER_TRANSCRIBER_NAME, shutdownLocalStt, } from './local-stt.js';
 export { LocalWhisperTranscriber, createLocalWhisperTranscriber, shutdownLocalStt, LOCAL_WHISPER_TRANSCRIBER_NAME, } from './local-stt.js';
-export { MODEL_CATALOG, DEFAULT_MODEL_ID, modelIds, findModel, requireModel, } from './models.js';
+export { MODEL_CATALOG, DEFAULT_MODEL_ID, modelIds, findModel, requireModel, modelFiles, modelBytes, modelDir, defaultModelsDir, } from './models.js';
 export { pcm16ToFloat32, downmixToMono, resampleLinear, parseWav, isRiffWave, TARGET_SAMPLE_RATE, } from './audio.js';
 export { decodeToMono16k } from './decode.js';
 export { decodeViaFfmpeg, missingFfmpegError, __resetFfmpegProbeForTest, } from './ffmpeg.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAe,MAAM,YAAY,CAAC;AAE1E,OAAO,EACL,6BAA6B,EAC7B,8BAA8B,EAC9B,gBAAgB,GAEjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,gBAAgB,EAChB,8BAA8B,GAG/B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,QAAQ,EACR,SAAS,EACT,YAAY,GAGb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,aAAa,EACb,cAAc,EACd,QAAQ,EACR,UAAU,EACV,kBAAkB,GAEnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAsB,MAAM,aAAa,CAAC;AAClE,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAwD,MAAM,kBAAkB,CAAC;AACpG,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,SAAS,EACT,cAAc,GACf,MAAM,eAAe,CAAC;AAQvB;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAmC,EAAE;IACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;IACrC,OAAO,YAAY,CAAC;QAClB,IAAI,EAAE,yBAAyB;QAC/B,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE;YACZ,iBAAiB,CAAC;gBAChB,IAAI,EAAE,8BAA8B;gBACpC,WAAW,EAAE,uCAAuC;gBACpD,YAAY,EAAE,CAAC,MAA+B,EAAE,EAAE,CAChD,6BAA6B,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;aAC7E,CAAC;SACH;QACD,iEAAiE;QACjE,KAAK,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,gBAAgB,EAAE,EAAE;KAChD,CAAC,CAAC;AACL,CAAC;AAED;;;uEAGuE;AACvE,SAAS,eAAe,CAAC,MAA+B;IACtD,MAAM,GAAG,GAA4E,EAAE,CAAC;IACxF,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK;QAAE,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC/E,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;QAAE,GAAG,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IACxE,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ;QAAE,GAAG,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC3F,IACE,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;QACrC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC;QACnC,MAAM,CAAC,UAAU,GAAG,CAAC,EACrB,CAAC;QACD,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACrC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,0EAA0E;AAC1E,eAAe,mBAAmB,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAe,MAAM,YAAY,CAAC;AAE1E,OAAO,EACL,6BAA6B,EAC7B,8BAA8B,EAC9B,gBAAgB,GAEjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,gBAAgB,EAChB,8BAA8B,GAG/B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,UAAU,EACV,UAAU,EACV,QAAQ,EACR,gBAAgB,GAGjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,aAAa,EACb,cAAc,EACd,QAAQ,EACR,UAAU,EACV,kBAAkB,GAEnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAsB,MAAM,aAAa,CAAC;AAClE,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAwD,MAAM,kBAAkB,CAAC;AACpG,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,SAAS,EACT,cAAc,GACf,MAAM,eAAe,CAAC;AAQvB;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAmC,EAAE;IACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;IACrC,OAAO,YAAY,CAAC;QAClB,IAAI,EAAE,yBAAyB;QAC/B,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE;YACZ,iBAAiB,CAAC;gBAChB,IAAI,EAAE,8BAA8B;gBACpC,WAAW,EAAE,uCAAuC;gBACpD,YAAY,EAAE,CAAC,MAA+B,EAAE,EAAE,CAChD,6BAA6B,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;aAC7E,CAAC;SACH;QACD,iEAAiE;QACjE,KAAK,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,gBAAgB,EAAE,EAAE;KAChD,CAAC,CAAC;AACL,CAAC;AAED;;;uEAGuE;AACvE,SAAS,eAAe,CAAC,MAA+B;IACtD,MAAM,GAAG,GAA4E,EAAE,CAAC;IACxF,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK;QAAE,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC/E,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;QAAE,GAAG,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IACxE,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ;QAAE,GAAG,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC3F,IACE,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;QACrC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC;QACnC,MAAM,CAAC,UAAU,GAAG,CAAC,EACrB,CAAC;QACD,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACrC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,0EAA0E;AAC1E,eAAe,mBAAmB,EAAE,CAAC"}

package/dist/local-stt.d.ts

@@ -2,18 +2,18 @@
  * The `local-whisper` Transcriber: fully local, on-device speech-to-text.
  *
  * On the first transcription for a model it downloads + verifies that model's
- * Whisper export (once, via @moxxy/model-fetch), then decodes the inbound audio
+ * Whisper files (once, via @moxxy/model-fetch), then decodes the inbound audio
  * to Float32 mono @ 16 kHz IN-PROCESS (raw PCM / WAV) or via ffmpeg (compressed
  * containers) and hands the samples to the sherpa sidecar ({@link HostClient}).
  * No key, no network at transcription time.
  *
- * Every collaborator is injectable (`ensureModelImpl`, `hostFactory`, `log`,
+ * Every collaborator is injectable (`ensureModelFilesImpl`, `hostFactory`, `log`,
  * `modelsDir`, `fetchImpl`, `spawnImpl`) so the whole flow is unit-testable
  * without the native addon, a real download, or ffmpeg.
  */
 import type { spawn } from 'node:child_process';
 import { type TranscribeOptions, type Transcriber, type TranscriptionResult } from '@moxxy/sdk';
-import { ensureModel, type FetchLike } from '@moxxy/model-fetch';
+import { ensureModelFiles, type FetchLike } from '@moxxy/model-fetch';
 import { type HostClientLike } from './host-client.js';
 /** The single registered transcriber name. */
 export declare const LOCAL_WHISPER_TRANSCRIBER_NAME = "local-whisper";
@@ -24,7 +24,7 @@ export interface WhisperModelPaths {
     readonly tokens: string;
 }
 export interface LocalWhisperOptions {
-    /** Model id: `tiny` | `base` | `small`. Default `base` (`small` for Polish). */
+    /** Model id. The only one is `turbo`, also the default. */
     readonly model?: string;
     /** Default Whisper language tag (BCP-47-ish, e.g. `en`, `pl`). Per-call
      *  `TranscribeOptions.language` overrides it; omit to let Whisper auto-detect. */
@@ -38,9 +38,9 @@ export interface LocalWhisperOptions {
     /** Absolute path to the built sidecar entry. Default: `sidecar.js` beside
      *  this module (i.e. `dist/sidecar.js` in a published build). */
     readonly sidecarPath?: string;
-    /** Injected model-ensure (tests). Defaults to @moxxy/model-fetch `ensureModel`. */
-    readonly ensureModelImpl?: typeof ensureModel;
-    /** Injected `fetch`, threaded into `ensureModel` (tests). */
+    /** Injected model download (tests). Defaults to @moxxy/model-fetch `ensureModelFiles`. */
+    readonly ensureModelFilesImpl?: typeof ensureModelFiles;
+    /** Injected `fetch`, threaded into the model download (tests). */
     readonly fetchImpl?: FetchLike;
     /** Injected sidecar host factory (tests). Defaults to a real {@link HostClient}. */
     readonly hostFactory?: () => HostClientLike;
@@ -59,7 +59,7 @@ export declare class LocalWhisperTranscriber implements Transcriber {
     private readonly modelsDir;
     private readonly provider;
     private readonly sidecarPath;
-    private readonly ensureModelImpl;
+    private readonly ensureModelFilesImpl;
     private readonly fetchImpl;
     private readonly hostFactory;
     private readonly spawnImpl;
@@ -72,11 +72,10 @@ export declare class LocalWhisperTranscriber implements Transcriber {
     /** Kill this transcriber's sidecar (if any) and drop registration. */
     shutdown(): void;
     private getHost;
-    /** Resolve on-disk paths for the model, downloading + extracting it once. */
+    /** Resolve on-disk paths for the model, downloading its files once. */
     private ensureModelFiles;
     /** A progress callback that logs a single start line then ~every-10% ticks,
-     *  and an extraction line — but stays silent when the model is already
-     *  present (ensureModel emits only `done`). */
+     *  but stays silent when the model is already present (nothing to fetch). */
     private makeProgressLogger;
     /** Build a real sidecar-backed host, resolving the platform loader path.
      *  Fails clearly when no sherpa binary exists for this platform/arch. */

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

@@ -1 +1 @@
-{"version":3,"file":"local-stt.d.ts","sourceRoot":"","sources":["../src/local-stt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,WAAW,EAGX,KAAK,SAAS,EACf,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAInE,8CAA8C;AAC9C,eAAO,MAAM,8BAA8B,kBAAkB,CAAC;AAI9D,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,gFAAgF;IAChF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;sFACkF;IAClF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,oFAAoF;IACpF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;qEACiE;IACjE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,WAAW,CAAC;IAC9C,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,oFAAoF;IACpF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,cAAc,CAAC;IAC5C,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IAClC,wEAAwE;IACxE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAMD,qEAAqE;AACrE,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC;AAED,qBAAa,uBAAwB,YAAW,WAAW;IACzD,QAAQ,CAAC,IAAI,mBAAkC;IAE/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2B;IACrD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAwB;IAE5C,OAAO,CAAC,IAAI,CAA+B;IAC3C,wEAAwE;IACxE,OAAO,CAAC,QAAQ,CAA2C;gBAE/C,IAAI,GAAE,mBAAwB;IAoBpC,UAAU,CACd,KAAK,EAAE,UAAU,GAAG,WAAW,EAC/B,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,mBAAmB,CAAC;IA6C/B,sEAAsE;IACtE,QAAQ,IAAI,IAAI;IAMhB,OAAO,CAAC,OAAO;IAKf,6EAA6E;YAC/D,gBAAgB;IA2B9B;;mDAE+C;IAC/C,OAAO,CAAC,kBAAkB;IA4B1B;6EACyE;IACzE,OAAO,CAAC,WAAW;CAqBpB;AAED,wBAAgB,6BAA6B,CAAC,IAAI,GAAE,mBAAwB,GAAG,uBAAuB,CAErG"}
+{"version":3,"file":"local-stt.d.ts","sourceRoot":"","sources":["../src/local-stt.ts"],"names":[],"mappings":"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"}

package/dist/local-stt.js

@@ -2,24 +2,23 @@
  * The `local-whisper` Transcriber: fully local, on-device speech-to-text.
  *
  * On the first transcription for a model it downloads + verifies that model's
- * Whisper export (once, via @moxxy/model-fetch), then decodes the inbound audio
+ * Whisper files (once, via @moxxy/model-fetch), then decodes the inbound audio
  * to Float32 mono @ 16 kHz IN-PROCESS (raw PCM / WAV) or via ffmpeg (compressed
  * containers) and hands the samples to the sherpa sidecar ({@link HostClient}).
  * No key, no network at transcription time.
  *
- * Every collaborator is injectable (`ensureModelImpl`, `hostFactory`, `log`,
+ * Every collaborator is injectable (`ensureModelFilesImpl`, `hostFactory`, `log`,
  * `modelsDir`, `fetchImpl`, `spawnImpl`) so the whole flow is unit-testable
  * without the native addon, a real download, or ffmpeg.
  */
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { MoxxyError, } from '@moxxy/sdk';
-import { moxxyPath } from '@moxxy/sdk/server';
-import { ensureModel, } from '@moxxy/model-fetch';
+import { ensureModelFiles, } from '@moxxy/model-fetch';
 import { TARGET_SAMPLE_RATE } from './audio.js';
 import { decodeToMono16k } from './decode.js';
 import { HostClient } from './host-client.js';
-import { DEFAULT_MODEL_ID, requireModel } from './models.js';
+import { DEFAULT_MODEL_ID, defaultModelsDir, modelBytes, modelDir, modelFiles, requireModel, } from './models.js';
 import { resolveSherpaLibDir, sherpaEnv, sherpaPlatformPackage } from './platform.js';
 /** The single registered transcriber name. */
 export const LOCAL_WHISPER_TRANSCRIBER_NAME = 'local-whisper';
@@ -41,7 +40,7 @@ export class LocalWhisperTranscriber {
     modelsDir;
     provider;
     sidecarPath;
-    ensureModelImpl;
+    ensureModelFilesImpl;
     fetchImpl;
     hostFactory;
     spawnImpl;
@@ -58,10 +57,10 @@ export class LocalWhisperTranscriber {
             opts.numThreads && Number.isInteger(opts.numThreads) && opts.numThreads > 0
                 ? opts.numThreads
                 : DEFAULT_NUM_THREADS;
-        this.modelsDir = opts.modelsDir ?? moxxyPath('models', 'stt');
+        this.modelsDir = opts.modelsDir ?? defaultModelsDir();
         this.provider = opts.provider ?? 'cpu';
         this.sidecarPath = opts.sidecarPath;
-        this.ensureModelImpl = opts.ensureModelImpl ?? ensureModel;
+        this.ensureModelFilesImpl = opts.ensureModelFilesImpl ?? ensureModelFiles;
         this.fetchImpl = opts.fetchImpl;
         this.hostFactory = opts.hostFactory ?? (() => this.defaultHost());
         this.spawnImpl = opts.spawnImpl;
@@ -114,14 +113,13 @@ export class LocalWhisperTranscriber {
         this.host ??= this.hostFactory();
         return this.host;
     }
-    /** Resolve on-disk paths for the model, downloading + extracting it once. */
+    /** Resolve on-disk paths for the model, downloading its files once. */
     async ensureModelFiles(signal) {
-        const dir = path.join(this.modelsDir, this.model.id);
+        const dir = modelDir(this.model, this.modelsDir);
         let inflight = this.ensuring;
         if (!inflight) {
-            inflight = this.ensureModelImpl({
-                url: this.model.url,
-                sha256: this.model.sha256,
+            inflight = this.ensureModelFilesImpl({
+                files: modelFiles(this.model),
                 dir,
                 ...(this.fetchImpl ? { fetchImpl: this.fetchImpl } : {}),
                 ...(signal ? { signal } : {}),
@@ -135,40 +133,29 @@ export class LocalWhisperTranscriber {
             });
         }
         await inflight;
-        const root = path.join(dir, this.model.archiveRootDir);
         return {
-            encoder: path.join(root, this.model.encoderFile),
-            decoder: path.join(root, this.model.decoderFile),
-            tokens: path.join(root, this.model.tokensFile),
+            encoder: path.join(dir, this.model.encoder.name),
+            decoder: path.join(dir, this.model.decoder.name),
+            tokens: path.join(dir, this.model.tokens.name),
         };
     }
     /** A progress callback that logs a single start line then ~every-10% ticks,
-     *  and an extraction line — but stays silent when the model is already
-     *  present (ensureModel emits only `done`). */
+     *  but stays silent when the model is already present (nothing to fetch). */
     makeProgressLogger() {
         let started = false;
-        let extracting = false;
         let lastPct = -1;
         return (p) => {
-            if (p.phase === 'downloading') {
-                if (!started) {
-                    started = true;
-                    this.log(`stt-local: first use — downloading Whisper ${this.model.id} (~${this.model.approxMb} MB) to ${this.modelsDir}, one-time`);
-                }
-                if (p.totalBytes > 0) {
-                    const pct = Math.floor((p.receivedBytes / p.totalBytes) * 100);
-                    if (pct >= lastPct + 10) {
-                        lastPct = pct - (pct % 10);
-                        this.log(`stt-local: downloading ${this.model.id} … ${lastPct}%`);
-                    }
-                }
+            const pct = p.totalBytes > 0 ? Math.floor((p.receivedBytes / p.totalBytes) * 100) : 0;
+            if (!started) {
+                if (pct >= 100)
+                    return;
+                started = true;
+                const mb = Math.round(modelBytes(this.model) / 1_000_000);
+                this.log(`stt-local: first use — downloading Whisper ${this.model.id} (~${mb} MB) to ${this.modelsDir}, one-time`);
             }
-            else if (p.phase === 'extracting' && !extracting) {
-                extracting = true;
-                this.log(`stt-local: extracting ${this.model.id} …`);
-            }
-            else if (p.phase === 'done' && started) {
-                this.log(`stt-local: ${this.model.id} ready.`);
+            if (pct >= lastPct + 10) {
+                lastPct = pct - (pct % 10);
+                this.log(lastPct >= 100 ? `stt-local: ${this.model.id} ready.` : `stt-local: downloading ${this.model.id} … ${lastPct}%`);
             }
         };
     }

package/dist/local-stt.js.map

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

package/dist/models.d.ts

@@ -1,42 +1,37 @@
 /**
  * The pinned Whisper model catalog.
  *
- * Every model is a multilingual sherpa-onnx Whisper export published as a
- * `.tar.bz2` under the project's `asr-models` GitHub release. Each `sha256` is
- * copied VERBATIM from that release's `checksum.txt` (re-verified 2026-07-05) —
- * so a first-use download is content-addressed and tamper-evident, unlike an
- * unverified blob fetch. The archive extracts to a single top directory
- * (`archiveRootDir`) holding `<id>-encoder.onnx`, `<id>-decoder.onnx` (+ int8
- * variants we don't use) and `<id>-tokens.txt`.
+ * The one model is Whisper large-v3 turbo, the multilingual sherpa-onnx int8
+ * export. Its three files download as they are from Hugging Face, pinned to a
+ * fixed revision and checked against their size and sha256 — byte for byte the
+ * files the project's `asr-models` GitHub release packs into a `.tar.bz2`
+ * (verified 2026-10-24), but with no archive to unpack: unpacking it in
+ * JavaScript took about 67 s against 9 s for the download.
  *
- * All three are the MULTILINGUAL models (not the `.en` English-only exports),
- * so Polish (and any other Whisper language) works — `small` is the accuracy
- * sweet spot for Polish, `base` the balanced default, `tiny` the fastest.
+ * Multilingual (not an `.en` export), so Polish and every other Whisper
+ * language work.
  */
-export type WhisperModelId = 'tiny' | 'base' | 'small';
+import type { ModelFile } from '@moxxy/model-fetch/files';
+export type WhisperModelId = 'turbo';
 export interface WhisperModelEntry {
-    /** Stable model id (also the `model` config value). */
+    /** Stable model id (also the `model` config value and its directory name). */
     readonly id: WhisperModelId;
     /** Human label for UI surfaces / the first-use notice. */
     readonly label: string;
-    /** Pinned archive URL (sherpa-onnx GitHub `asr-models` release). */
-    readonly url: string;
-    /** Pinned hex sha256 of the archive (from the release checksum.txt). */
-    readonly sha256: string;
-    /** Top directory the archive extracts to (`sherpa-onnx-whisper-<id>`). */
-    readonly archiveRootDir: string;
-    /** Encoder ONNX filename inside `archiveRootDir` (`<id>-encoder.onnx`). */
-    readonly encoderFile: string;
-    /** Decoder ONNX filename inside `archiveRootDir` (`<id>-decoder.onnx`). */
-    readonly decoderFile: string;
-    /** Tokens filename inside `archiveRootDir` (`<id>-tokens.txt`). */
-    readonly tokensFile: string;
-    /** Approximate download size in MB (for the one-time first-use notice). */
-    readonly approxMb: number;
+    readonly encoder: ModelFile;
+    readonly decoder: ModelFile;
+    readonly tokens: ModelFile;
 }
 export declare const MODEL_CATALOG: readonly WhisperModelEntry[];
-/** Default model when the caller doesn't pick one. `base` balances size vs.
- *  accuracy; `small` is recommended for Polish (see the catalog description). */
+/** Every file of a model, in download order. */
+export declare function modelFiles(entry: WhisperModelEntry): ModelFile[];
+/** The model's download size in bytes. */
+export declare function modelBytes(entry: WhisperModelEntry): number;
+/** The models root: `~/.moxxy/models/stt`, MOXXY_HOME-aware. */
+export declare function defaultModelsDir(): string;
+/** Where a model's files live under the models root. */
+export declare function modelDir(entry: WhisperModelEntry, modelsDir: string): string;
+/** The model used when the caller doesn't pick one — the only one there is. */
 export declare const DEFAULT_MODEL_ID: WhisperModelId;
 /** All valid model ids, for error messages and validation. */
 export declare function modelIds(): string[];

package/dist/models.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,2EAA2E;IAC3E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAwBD,eAAO,MAAM,aAAa,EAAE,SAAS,iBAAiB,EAmBrD,CAAC;AAEF;iFACiF;AACjF,eAAO,MAAM,gBAAgB,EAAE,cAAuB,CAAC;AAEvD,8DAA8D;AAC9D,wBAAgB,QAAQ,IAAI,MAAM,EAAE,CAEnC;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEnE;AAED;uEACuE;AACvE,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB,CAWzE"}
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC;AAErC,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;CAC5B;AAKD,eAAO,MAAM,aAAa,EAAE,SAAS,iBAAiB,EAuBrD,CAAC;AAEF,gDAAgD;AAChD,wBAAgB,UAAU,CAAC,KAAK,EAAE,iBAAiB,GAAG,SAAS,EAAE,CAEhE;AAED,0CAA0C;AAC1C,wBAAgB,UAAU,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAE3D;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wDAAwD;AACxD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,EAAE,cAAwB,CAAC;AAExD,8DAA8D;AAC9D,wBAAgB,QAAQ,IAAI,MAAM,EAAE,CAEnC;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEnE;AAED;uEACuE;AACvE,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB,CAWzE"}

package/dist/models.js

@@ -1,42 +1,63 @@
 /**
  * The pinned Whisper model catalog.
  *
- * Every model is a multilingual sherpa-onnx Whisper export published as a
- * `.tar.bz2` under the project's `asr-models` GitHub release. Each `sha256` is
- * copied VERBATIM from that release's `checksum.txt` (re-verified 2026-07-05) —
- * so a first-use download is content-addressed and tamper-evident, unlike an
- * unverified blob fetch. The archive extracts to a single top directory
- * (`archiveRootDir`) holding `<id>-encoder.onnx`, `<id>-decoder.onnx` (+ int8
- * variants we don't use) and `<id>-tokens.txt`.
+ * The one model is Whisper large-v3 turbo, the multilingual sherpa-onnx int8
+ * export. Its three files download as they are from Hugging Face, pinned to a
+ * fixed revision and checked against their size and sha256 — byte for byte the
+ * files the project's `asr-models` GitHub release packs into a `.tar.bz2`
+ * (verified 2026-10-24), but with no archive to unpack: unpacking it in
+ * JavaScript took about 67 s against 9 s for the download.
  *
- * All three are the MULTILINGUAL models (not the `.en` English-only exports),
- * so Polish (and any other Whisper language) works — `small` is the accuracy
- * sweet spot for Polish, `base` the balanced default, `tiny` the fastest.
+ * Multilingual (not an `.en` export), so Polish and every other Whisper
+ * language work.
  */
+import path from 'node:path';
 import { MoxxyError } from '@moxxy/sdk';
-const RELEASE_BASE = 'https://github.com/k2-fsa/sherpa-onnx/releases/download/asr-models';
-function whisperModel(id, label, sha256, approxMb) {
-    const archiveRootDir = `sherpa-onnx-whisper-${id}`;
-    return {
-        id,
-        label,
-        url: `${RELEASE_BASE}/${archiveRootDir}.tar.bz2`,
-        sha256,
-        archiveRootDir,
-        encoderFile: `${id}-encoder.onnx`,
-        decoderFile: `${id}-decoder.onnx`,
-        tokensFile: `${id}-tokens.txt`,
-        approxMb,
-    };
-}
+import { moxxyPath } from '@moxxy/sdk/server';
+const TURBO_REVISION = '2ca6ff69fc878651b770880507669577ac41c2ff';
+const TURBO_BASE = `https://huggingface.co/csukuangfj/sherpa-onnx-whisper-turbo/resolve/${TURBO_REVISION}`;
 export const MODEL_CATALOG = [
-    whisperModel('tiny', 'Whisper tiny (multilingual — fastest, lowest accuracy)', 'c46116994e539aa165266d96b325252728429c12535eb9d8b6a2b10f129e66b1', 111),
-    whisperModel('base', 'Whisper base (multilingual — balanced; default)', '911b2083efd7c0dca2ac3b358b75222660dc09fb716d64fbfc417ba6c99ff3de', 198),
-    whisperModel('small', 'Whisper small (multilingual — best accuracy; recommended for Polish)', '486a46afbb7ba798507190ffe02fea2dd726049af212e774537efac6afb210a6', 610),
+    {
+        id: 'turbo',
+        label: 'Whisper turbo (multilingual, large-v3 turbo)',
+        encoder: {
+            name: 'turbo-encoder.int8.onnx',
+            url: `${TURBO_BASE}/turbo-encoder.int8.onnx`,
+            bytes: 674_716_297,
+            sha256: 'b02dcdf54f348741e93fe732b67d933c8dcb6735655f710640143081db38878b',
+        },
+        decoder: {
+            name: 'turbo-decoder.int8.onnx',
+            url: `${TURBO_BASE}/turbo-decoder.int8.onnx`,
+            bytes: 361_080_764,
+            sha256: '20accd02388482eb3a46bd615631adfdc85e1eb2c7db9ea3f02a40ffe6b81547',
+        },
+        tokens: {
+            name: 'turbo-tokens.txt',
+            url: `${TURBO_BASE}/turbo-tokens.txt`,
+            bytes: 816_730,
+            sha256: 'b34b360dbb493e781e479794586d661700670d65564001f23024971d1f2fa126',
+        },
+    },
 ];
-/** Default model when the caller doesn't pick one. `base` balances size vs.
- *  accuracy; `small` is recommended for Polish (see the catalog description). */
-export const DEFAULT_MODEL_ID = 'base';
+/** Every file of a model, in download order. */
+export function modelFiles(entry) {
+    return [entry.encoder, entry.decoder, entry.tokens];
+}
+/** The model's download size in bytes. */
+export function modelBytes(entry) {
+    return modelFiles(entry).reduce((sum, file) => sum + file.bytes, 0);
+}
+/** The models root: `~/.moxxy/models/stt`, MOXXY_HOME-aware. */
+export function defaultModelsDir() {
+    return moxxyPath('models', 'stt');
+}
+/** Where a model's files live under the models root. */
+export function modelDir(entry, modelsDir) {
+    return path.join(modelsDir, entry.id);
+}
+/** The model used when the caller doesn't pick one — the only one there is. */
+export const DEFAULT_MODEL_ID = 'turbo';
 /** All valid model ids, for error messages and validation. */
 export function modelIds() {
     return MODEL_CATALOG.map((m) => m.id);

package/dist/models.js.map

@@ -1 +1 @@
-{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAyBxC,MAAM,YAAY,GAAG,oEAAoE,CAAC;AAE1F,SAAS,YAAY,CACnB,EAAkB,EAClB,KAAa,EACb,MAAc,EACd,QAAgB;IAEhB,MAAM,cAAc,GAAG,uBAAuB,EAAE,EAAE,CAAC;IACnD,OAAO;QACL,EAAE;QACF,KAAK;QACL,GAAG,EAAE,GAAG,YAAY,IAAI,cAAc,UAAU;QAChD,MAAM;QACN,cAAc;QACd,WAAW,EAAE,GAAG,EAAE,eAAe;QACjC,WAAW,EAAE,GAAG,EAAE,eAAe;QACjC,UAAU,EAAE,GAAG,EAAE,aAAa;QAC9B,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAiC;IACzD,YAAY,CACV,MAAM,EACN,wDAAwD,EACxD,kEAAkE,EAClE,GAAG,CACJ;IACD,YAAY,CACV,MAAM,EACN,iDAAiD,EACjD,kEAAkE,EAClE,GAAG,CACJ;IACD,YAAY,CACV,OAAO,EACP,sEAAsE,EACtE,kEAAkE,EAClE,GAAG,CACJ;CACF,CAAC;AAEF;iFACiF;AACjF,MAAM,CAAC,MAAM,gBAAgB,GAAmB,MAAM,CAAC;AAEvD,8DAA8D;AAC9D,MAAM,UAAU,QAAQ;IACtB,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,EAAU;IAClC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAChD,CAAC;AAED;uEACuE;AACvE,MAAM,UAAU,YAAY,CAAC,EAAU,EAAE,KAAa;IACpD,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;IAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,UAAU,CAAC;YACnB,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,+BAA+B,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,KAAK,IAAI;YACxE,IAAI,EAAE,iBAAiB,QAAQ,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YAC/C,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;SAC9B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAe9C,MAAM,cAAc,GAAG,0CAA0C,CAAC;AAClE,MAAM,UAAU,GAAG,uEAAuE,cAAc,EAAE,CAAC;AAE3G,MAAM,CAAC,MAAM,aAAa,GAAiC;IACzD;QACE,EAAE,EAAE,OAAO;QACX,KAAK,EAAE,8CAA8C;QACrD,OAAO,EAAE;YACP,IAAI,EAAE,yBAAyB;YAC/B,GAAG,EAAE,GAAG,UAAU,0BAA0B;YAC5C,KAAK,EAAE,WAAW;YAClB,MAAM,EAAE,kEAAkE;SAC3E;QACD,OAAO,EAAE;YACP,IAAI,EAAE,yBAAyB;YAC/B,GAAG,EAAE,GAAG,UAAU,0BAA0B;YAC5C,KAAK,EAAE,WAAW;YAClB,MAAM,EAAE,kEAAkE;SAC3E;QACD,MAAM,EAAE;YACN,IAAI,EAAE,kBAAkB;YACxB,GAAG,EAAE,GAAG,UAAU,mBAAmB;YACrC,KAAK,EAAE,OAAO;YACd,MAAM,EAAE,kEAAkE;SAC3E;KACF;CACF,CAAC;AAEF,gDAAgD;AAChD,MAAM,UAAU,UAAU,CAAC,KAAwB;IACjD,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;AACtD,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,UAAU,CAAC,KAAwB;IACjD,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,gBAAgB;IAC9B,OAAO,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACpC,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,QAAQ,CAAC,KAAwB,EAAE,SAAiB;IAClE,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,gBAAgB,GAAmB,OAAO,CAAC;AAExD,8DAA8D;AAC9D,MAAM,UAAU,QAAQ;IACtB,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,EAAU;IAClC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAChD,CAAC;AAED;uEACuE;AACvE,MAAM,UAAU,YAAY,CAAC,EAAU,EAAE,KAAa;IACpD,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;IAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,UAAU,CAAC;YACnB,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,+BAA+B,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,KAAK,IAAI;YACxE,IAAI,EAAE,iBAAiB,QAAQ,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YAC/C,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;SAC9B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@moxxy/plugin-stt-local",
-  "version": "0.44.0",
-  "description": "Fully local, on-device speech-to-text Transcriber for moxxy. Runs multilingual Whisper (English + Polish) via sherpa-onnx in a forked sidecar process; models download once on first use from sherpa-onnx's pinned releases (sha256-verified). No API key, no network at transcription time. Plugs into the session TranscriberRegistry — the TUI and channel voice notes consume it transparently.",
+  "version": "0.46.0",
+  "description": "Fully local, on-device speech-to-text Transcriber for moxxy. Runs multilingual Whisper (English + Polish) via sherpa-onnx in a forked sidecar process; the Whisper turbo model downloads once on first use, pinned and sha256-verified. No API key, no network at transcription time. Plugs into the session TranscriberRegistry — the TUI and channel voice notes consume it transparently.",
   "keywords": [
     "moxxy",
     "agent",
@@ -34,6 +34,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./models": {
+      "types": "./dist/models.d.ts",
+      "import": "./dist/models.js"
     }
   },
   "files": [
@@ -48,15 +52,15 @@
   },
   "dependencies": {
     "sherpa-onnx-node": "^1.13.8",
-    "@moxxy/model-fetch": "0.1.0",
-    "@moxxy/sdk": "0.44.0"
+    "@moxxy/sdk": "0.46.0",
+    "@moxxy/model-fetch": "0.2.0"
   },
   "devDependencies": {
     "@types/node": "^22.20.5",
     "typescript": "^6.0.3",
     "vitest": "^5.0.3",
-    "@moxxy/tsconfig": "0.0.0",
-    "@moxxy/vitest-preset": "0.0.0"
+    "@moxxy/vitest-preset": "0.0.0",
+    "@moxxy/tsconfig": "0.0.0"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",

package/src/host-protocol.test.ts

@@ -137,7 +137,7 @@ describe('createMessageHandler', () => {
     await handle(req({ id: 1 }));
     await handle(req({ id: 2 }));
     await handle(
-      req({ id: 3, modelKey: '/models/small/small-encoder.onnx', encoder: '/models/small/small-encoder.onnx' }),
+      req({ id: 3, modelKey: '/models/turbo/turbo-encoder.int8.onnx', encoder: '/models/turbo/turbo-encoder.int8.onnx' }),
     );
     expect(loads).toBe(1); // module loaded once
     expect(s.constructed).toBe(2); // one recognizer per distinct modelKey

package/src/index.ts

@@ -21,6 +21,10 @@ export {
   modelIds,
   findModel,
   requireModel,
+  modelFiles,
+  modelBytes,
+  modelDir,
+  defaultModelsDir,
   type WhisperModelEntry,
   type WhisperModelId,
 } from './models.js';
@@ -49,7 +53,7 @@ export {
 
 export interface BuildLocalSttPluginOptions {
   /** Build-time defaults / test seams for the transcriber (injected
-   *  `ensureModelImpl`, `hostFactory`, `fetchImpl`, `modelsDir`, `log`, …). */
+   *  `ensureModelFilesImpl`, `hostFactory`, `fetchImpl`, `modelsDir`, `log`, …). */
   readonly defaults?: LocalWhisperOptions;
 }
 

package/src/live.test.ts

@@ -14,8 +14,8 @@ import { removeDir } from '@moxxy/vitest-preset/fs';
 const SIDECAR_PATH = fileURLToPath(new URL('../dist/sidecar.js', import.meta.url));
 
 /**
- * Opt-in end-to-end test that REALLY downloads the tiny Whisper model and runs
- * the native sherpa sidecar — off by default (it fetches ~111 MB and needs the
+ * Opt-in end-to-end test that REALLY downloads the turbo Whisper model and runs
+ * the native sherpa sidecar — off by default (it fetches ~1 GB and needs the
  * platform binary). Run manually with:
  *
  *   MOXXY_STT_LOCAL_LIVE=1 pnpm -F @moxxy/plugin-stt-local test
@@ -64,9 +64,9 @@ afterAll(async () => {
 });
 
 describe.skipIf(!LIVE)('local STT (live, real download + native sidecar)', () => {
-  it('downloads the tiny model and transcribes a generated WAV fixture', async () => {
+  it('downloads the turbo model and transcribes a generated WAV fixture', async () => {
     const stt = createLocalWhisperTranscriber({
-      model: 'tiny',
+      model: 'turbo',
       modelsDir,
       sidecarPath: SIDECAR_PATH,
     });

package/src/local-stt.test.ts

@@ -2,7 +2,7 @@ import * as path from 'node:path';
 import { describe, expect, it } from 'vitest';
 
 import { MOXXY_PCM16_24KHZ_MIME } from '@moxxy/sdk';
-import { ensureModel } from '@moxxy/model-fetch';
+import type { ensureModelFiles } from '@moxxy/model-fetch';
 
 import {
   createLocalWhisperTranscriber,
@@ -49,14 +49,14 @@ function fakeHost(result: TranscribeResult = { text: 'hello world' }): {
   };
 }
 
-/** A fake ensureModel recording the urls it was asked to fetch. */
-function fakeEnsure(): { impl: typeof ensureModel; urls: string[] } {
-  const urls: string[] = [];
-  const impl = (async (opts: Parameters<typeof ensureModel>[0]) => {
-    urls.push(opts.url);
+/** A fake ensureModelFiles recording each model it was asked to fetch. */
+function fakeEnsure(): { impl: typeof ensureModelFiles; calls: Parameters<typeof ensureModelFiles>[0][] } {
+  const calls: Parameters<typeof ensureModelFiles>[0][] = [];
+  const impl = (async (opts: Parameters<typeof ensureModelFiles>[0]) => {
+    calls.push(opts);
     return { dir: opts.dir, skipped: false };
-  }) as unknown as typeof ensureModel;
-  return { impl, urls };
+  }) as typeof ensureModelFiles;
+  return { impl, calls };
 }
 
 function makeTranscriber(
@@ -71,7 +71,7 @@ function makeTranscriber(
   const ensure = fakeEnsure();
   const transcriber = createLocalWhisperTranscriber({
     modelsDir: '/models/stt',
-    ensureModelImpl: ensure.impl,
+    ensureModelFilesImpl: ensure.impl,
     hostFactory: () => host.host,
     log: () => {},
     ...over,
@@ -80,28 +80,29 @@ function makeTranscriber(
 }
 
 describe('LocalWhisperTranscriber.transcribe', () => {
-  it('defaults to the base model, decodes raw PCM, and returns the transcript', async () => {
+  it('defaults to the turbo model, decodes raw PCM, and returns the transcript', async () => {
     const { transcriber, host, ensure } = makeTranscriber();
     const out = await transcriber.transcribe(AUDIO, { mimeType: MOXXY_PCM16_24KHZ_MIME });
     expect(out.text).toBe('hello world');
-    expect(ensure.urls).toEqual([
-      'https://github.com/k2-fsa/sherpa-onnx/releases/download/asr-models/sherpa-onnx-whisper-base.tar.bz2',
+    const modelRoot = path.join('/models/stt', 'turbo');
+    expect(ensure.calls.map((call) => call.dir)).toEqual([modelRoot]);
+    expect(ensure.calls[0]!.files.map((file) => file.name)).toEqual([
+      'turbo-encoder.int8.onnx',
+      'turbo-decoder.int8.onnx',
+      'turbo-tokens.txt',
     ]);
     const req = host.reqs[0]!;
-    expect(req.encoder).toContain(path.join('sherpa-onnx-whisper-base', 'base-encoder.onnx'));
-    expect(req.decoder).toContain('base-decoder.onnx');
-    expect(req.tokens).toContain('base-tokens.txt');
+    expect(req.encoder).toBe(path.join(modelRoot, 'turbo-encoder.int8.onnx'));
+    expect(req.decoder).toBe(path.join(modelRoot, 'turbo-decoder.int8.onnx'));
+    expect(req.tokens).toBe(path.join(modelRoot, 'turbo-tokens.txt'));
     expect(req.sampleRate).toBe(16_000);
     expect(req.samples.length).toBe(160); // resampled 24k → 16k
     expect(req.task).toBe('transcribe');
     expect(out.durationSec).toBeCloseTo(160 / 16_000, 6);
   });
 
-  it('selects a configured model (small) and its files', async () => {
-    const { transcriber, host, ensure } = makeTranscriber({ model: 'small' });
-    await transcriber.transcribe(AUDIO, { mimeType: MOXXY_PCM16_24KHZ_MIME });
-    expect(ensure.urls[0]).toContain('sherpa-onnx-whisper-small.tar.bz2');
-    expect(host.reqs[0]!.encoder).toContain('small-encoder.onnx');
+  it('rejects a removed model (small) left in config, before any download', () => {
+    expect(() => makeTranscriber({ model: 'small' })).toThrow(/Unknown local Whisper model "small"/);
   });
 
   it('passes a per-call language hint through to the recognizer', async () => {
@@ -145,14 +146,14 @@ describe('LocalWhisperTranscriber.transcribe', () => {
     await transcriber.transcribe(AUDIO, { mimeType: MOXXY_PCM16_24KHZ_MIME });
     await transcriber.transcribe(AUDIO, { mimeType: MOXXY_PCM16_24KHZ_MIME });
     await transcriber.transcribe(AUDIO, { mimeType: MOXXY_PCM16_24KHZ_MIME });
-    expect(ensure.urls.length).toBe(1);
+    expect(ensure.calls.length).toBe(1);
   });
 
   it('returns empty text for empty/silent audio without touching the model', async () => {
     const { transcriber, host, ensure } = makeTranscriber();
     const out = await transcriber.transcribe(new Uint8Array(0), { mimeType: MOXXY_PCM16_24KHZ_MIME });
     expect(out.text).toBe('');
-    expect(ensure.urls.length).toBe(0);
+    expect(ensure.calls.length).toBe(0);
     expect(host.reqs.length).toBe(0);
   });
 
@@ -202,14 +203,14 @@ describe('buildLocalSttPlugin', () => {
     const plugin = buildLocalSttPlugin({
       defaults: {
         modelsDir: '/models/stt',
-        ensureModelImpl: ensure.impl,
+        ensureModelFilesImpl: ensure.impl,
         hostFactory: () => host.host,
         log: () => {},
       },
     });
-    const inst = plugin.transcribers![0]!.createClient({ model: 'small', language: 'pl' });
+    const inst = plugin.transcribers![0]!.createClient({ model: 'turbo', language: 'pl' });
     await inst.transcribe(AUDIO, { mimeType: MOXXY_PCM16_24KHZ_MIME });
-    expect(ensure.urls[0]).toContain('sherpa-onnx-whisper-small.tar.bz2');
+    expect(ensure.calls[0]!.dir).toBe(path.join('/models/stt', 'turbo'));
     expect(host.reqs[0]!.language).toBe('pl');
   });
 

package/src/local-stt.ts

@@ -2,12 +2,12 @@
  * The `local-whisper` Transcriber: fully local, on-device speech-to-text.
  *
  * On the first transcription for a model it downloads + verifies that model's
- * Whisper export (once, via @moxxy/model-fetch), then decodes the inbound audio
+ * Whisper files (once, via @moxxy/model-fetch), then decodes the inbound audio
  * to Float32 mono @ 16 kHz IN-PROCESS (raw PCM / WAV) or via ffmpeg (compressed
  * containers) and hands the samples to the sherpa sidecar ({@link HostClient}).
  * No key, no network at transcription time.
  *
- * Every collaborator is injectable (`ensureModelImpl`, `hostFactory`, `log`,
+ * Every collaborator is injectable (`ensureModelFilesImpl`, `hostFactory`, `log`,
  * `modelsDir`, `fetchImpl`, `spawnImpl`) so the whole flow is unit-testable
  * without the native addon, a real download, or ffmpeg.
  */
@@ -22,18 +22,25 @@ import {
   type Transcriber,
   type TranscriptionResult,
 } from '@moxxy/sdk';
-import { moxxyPath } from '@moxxy/sdk/server';
 import {
-  ensureModel,
-  type EnsureModelProgress,
-  type EnsureModelResult,
+  ensureModelFiles,
+  type EnsureModelFilesResult,
   type FetchLike,
+  type ModelFilesProgress,
 } from '@moxxy/model-fetch';
 
 import { TARGET_SAMPLE_RATE } from './audio.js';
 import { decodeToMono16k } from './decode.js';
 import { HostClient, type HostClientLike } from './host-client.js';
-import { DEFAULT_MODEL_ID, requireModel, type WhisperModelEntry } from './models.js';
+import {
+  DEFAULT_MODEL_ID,
+  defaultModelsDir,
+  modelBytes,
+  modelDir,
+  modelFiles,
+  requireModel,
+  type WhisperModelEntry,
+} from './models.js';
 import { resolveSherpaLibDir, sherpaEnv, sherpaPlatformPackage } from './platform.js';
 
 /** The single registered transcriber name. */
@@ -49,7 +56,7 @@ export interface WhisperModelPaths {
 }
 
 export interface LocalWhisperOptions {
-  /** Model id: `tiny` | `base` | `small`. Default `base` (`small` for Polish). */
+  /** Model id. The only one is `turbo`, also the default. */
   readonly model?: string;
   /** Default Whisper language tag (BCP-47-ish, e.g. `en`, `pl`). Per-call
    *  `TranscribeOptions.language` overrides it; omit to let Whisper auto-detect. */
@@ -63,9 +70,9 @@ export interface LocalWhisperOptions {
   /** Absolute path to the built sidecar entry. Default: `sidecar.js` beside
    *  this module (i.e. `dist/sidecar.js` in a published build). */
   readonly sidecarPath?: string;
-  /** Injected model-ensure (tests). Defaults to @moxxy/model-fetch `ensureModel`. */
-  readonly ensureModelImpl?: typeof ensureModel;
-  /** Injected `fetch`, threaded into `ensureModel` (tests). */
+  /** Injected model download (tests). Defaults to @moxxy/model-fetch `ensureModelFiles`. */
+  readonly ensureModelFilesImpl?: typeof ensureModelFiles;
+  /** Injected `fetch`, threaded into the model download (tests). */
   readonly fetchImpl?: FetchLike;
   /** Injected sidecar host factory (tests). Defaults to a real {@link HostClient}. */
   readonly hostFactory?: () => HostClientLike;
@@ -94,7 +101,7 @@ export class LocalWhisperTranscriber implements Transcriber {
   private readonly modelsDir: string;
   private readonly provider: string;
   private readonly sidecarPath: string | undefined;
-  private readonly ensureModelImpl: typeof ensureModel;
+  private readonly ensureModelFilesImpl: typeof ensureModelFiles;
   private readonly fetchImpl: FetchLike | undefined;
   private readonly hostFactory: () => HostClientLike;
   private readonly spawnImpl: typeof spawn | undefined;
@@ -102,7 +109,7 @@ export class LocalWhisperTranscriber implements Transcriber {
 
   private host: HostClientLike | null = null;
   /** In-flight model download promise — de-dupes concurrent first-use. */
-  private ensuring: Promise<EnsureModelResult> | null = null;
+  private ensuring: Promise<EnsureModelFilesResult> | null = null;
 
   constructor(opts: LocalWhisperOptions = {}) {
     // Validate the configured model up front so a bad config fails clearly at
@@ -113,10 +120,10 @@ export class LocalWhisperTranscriber implements Transcriber {
       opts.numThreads && Number.isInteger(opts.numThreads) && opts.numThreads > 0
         ? opts.numThreads
         : DEFAULT_NUM_THREADS;
-    this.modelsDir = opts.modelsDir ?? moxxyPath('models', 'stt');
+    this.modelsDir = opts.modelsDir ?? defaultModelsDir();
     this.provider = opts.provider ?? 'cpu';
     this.sidecarPath = opts.sidecarPath;
-    this.ensureModelImpl = opts.ensureModelImpl ?? ensureModel;
+    this.ensureModelFilesImpl = opts.ensureModelFilesImpl ?? ensureModelFiles;
     this.fetchImpl = opts.fetchImpl;
     this.hostFactory = opts.hostFactory ?? (() => this.defaultHost());
     this.spawnImpl = opts.spawnImpl;
@@ -184,14 +191,13 @@ export class LocalWhisperTranscriber implements Transcriber {
     return this.host;
   }
 
-  /** Resolve on-disk paths for the model, downloading + extracting it once. */
+  /** Resolve on-disk paths for the model, downloading its files once. */
   private async ensureModelFiles(signal?: AbortSignal): Promise<WhisperModelPaths> {
-    const dir = path.join(this.modelsDir, this.model.id);
+    const dir = modelDir(this.model, this.modelsDir);
     let inflight = this.ensuring;
     if (!inflight) {
-      inflight = this.ensureModelImpl({
-        url: this.model.url,
-        sha256: this.model.sha256,
+      inflight = this.ensureModelFilesImpl({
+        files: modelFiles(this.model),
         dir,
         ...(this.fetchImpl ? { fetchImpl: this.fetchImpl } : {}),
         ...(signal ? { signal } : {}),
@@ -204,41 +210,29 @@ export class LocalWhisperTranscriber implements Transcriber {
       });
     }
     await inflight;
-    const root = path.join(dir, this.model.archiveRootDir);
     return {
-      encoder: path.join(root, this.model.encoderFile),
-      decoder: path.join(root, this.model.decoderFile),
-      tokens: path.join(root, this.model.tokensFile),
+      encoder: path.join(dir, this.model.encoder.name),
+      decoder: path.join(dir, this.model.decoder.name),
+      tokens: path.join(dir, this.model.tokens.name),
     };
   }
 
   /** A progress callback that logs a single start line then ~every-10% ticks,
-   *  and an extraction line — but stays silent when the model is already
-   *  present (ensureModel emits only `done`). */
-  private makeProgressLogger(): (p: EnsureModelProgress) => void {
+   *  but stays silent when the model is already present (nothing to fetch). */
+  private makeProgressLogger(): (p: ModelFilesProgress) => void {
     let started = false;
-    let extracting = false;
     let lastPct = -1;
     return (p) => {
-      if (p.phase === 'downloading') {
-        if (!started) {
-          started = true;
-          this.log(
-            `stt-local: first use — downloading Whisper ${this.model.id} (~${this.model.approxMb} MB) to ${this.modelsDir}, one-time`,
-          );
-        }
-        if (p.totalBytes > 0) {
-          const pct = Math.floor((p.receivedBytes / p.totalBytes) * 100);
-          if (pct >= lastPct + 10) {
-            lastPct = pct - (pct % 10);
-            this.log(`stt-local: downloading ${this.model.id} … ${lastPct}%`);
-          }
-        }
-      } else if (p.phase === 'extracting' && !extracting) {
-        extracting = true;
-        this.log(`stt-local: extracting ${this.model.id} …`);
-      } else if (p.phase === 'done' && started) {
-        this.log(`stt-local: ${this.model.id} ready.`);
+      const pct = p.totalBytes > 0 ? Math.floor((p.receivedBytes / p.totalBytes) * 100) : 0;
+      if (!started) {
+        if (pct >= 100) return;
+        started = true;
+        const mb = Math.round(modelBytes(this.model) / 1_000_000);
+        this.log(`stt-local: first use — downloading Whisper ${this.model.id} (~${mb} MB) to ${this.modelsDir}, one-time`);
+      }
+      if (pct >= lastPct + 10) {
+        lastPct = pct - (pct % 10);
+        this.log(lastPct >= 100 ? `stt-local: ${this.model.id} ready.` : `stt-local: downloading ${this.model.id} … ${lastPct}%`);
       }
     };
   }

package/src/models.test.ts

@@ -1,58 +1,79 @@
+import path from 'node:path';
+
 import { describe, expect, it } from 'vitest';
 import {
   DEFAULT_MODEL_ID,
-  MODEL_CATALOG,
   findModel,
+  modelBytes,
+  modelDir,
+  modelFiles,
   modelIds,
   requireModel,
 } from './models.js';
 
 describe('MODEL_CATALOG', () => {
-  it('pins tiny/base/small multilingual models with their release URLs + hashes', () => {
-    expect(modelIds()).toEqual(['tiny', 'base', 'small']);
-    for (const m of MODEL_CATALOG) {
-      expect(m.url).toBe(
-        `https://github.com/k2-fsa/sherpa-onnx/releases/download/asr-models/sherpa-onnx-whisper-${m.id}.tar.bz2`,
-      );
-      expect(m.archiveRootDir).toBe(`sherpa-onnx-whisper-${m.id}`);
-      expect(m.encoderFile).toBe(`${m.id}-encoder.onnx`);
-      expect(m.decoderFile).toBe(`${m.id}-decoder.onnx`);
-      expect(m.tokensFile).toBe(`${m.id}-tokens.txt`);
-      // 64-hex sha256, lower-case.
-      expect(m.sha256).toMatch(/^[0-9a-f]{64}$/);
-    }
+  const HF = 'https://huggingface.co/csukuangfj/sherpa-onnx-whisper-turbo/resolve/2ca6ff69fc878651b770880507669577ac41c2ff';
+
+  it('pins only Whisper turbo, as its three int8 files on a fixed Hugging Face revision', () => {
+    expect(modelIds()).toEqual(['turbo']);
+    const turbo = findModel('turbo')!;
+    expect(turbo.encoder).toEqual({
+      name: 'turbo-encoder.int8.onnx',
+      url: `${HF}/turbo-encoder.int8.onnx`,
+      bytes: 674_716_297,
+      sha256: 'b02dcdf54f348741e93fe732b67d933c8dcb6735655f710640143081db38878b',
+    });
+    expect(turbo.decoder).toEqual({
+      name: 'turbo-decoder.int8.onnx',
+      url: `${HF}/turbo-decoder.int8.onnx`,
+      bytes: 361_080_764,
+      sha256: '20accd02388482eb3a46bd615631adfdc85e1eb2c7db9ea3f02a40ffe6b81547',
+    });
+    expect(turbo.tokens).toEqual({
+      name: 'turbo-tokens.txt',
+      url: `${HF}/turbo-tokens.txt`,
+      bytes: 816_730,
+      sha256: 'b34b360dbb493e781e479794586d661700670d65564001f23024971d1f2fa126',
+    });
   });
 
-  it('records the scout-verified checksums verbatim', () => {
-    expect(findModel('tiny')!.sha256).toBe(
-      'c46116994e539aa165266d96b325252728429c12535eb9d8b6a2b10f129e66b1',
-    );
-    expect(findModel('base')!.sha256).toBe(
-      '911b2083efd7c0dca2ac3b358b75222660dc09fb716d64fbfc417ba6c99ff3de',
-    );
-    expect(findModel('small')!.sha256).toBe(
-      '486a46afbb7ba798507190ffe02fea2dd726049af212e774537efac6afb210a6',
+  it('lists the files of a model and their total size', () => {
+    const turbo = findModel('turbo')!;
+    expect(modelFiles(turbo).map((file) => file.name)).toEqual([
+      'turbo-encoder.int8.onnx',
+      'turbo-decoder.int8.onnx',
+      'turbo-tokens.txt',
+    ]);
+    expect(modelBytes(turbo)).toBe(674_716_297 + 361_080_764 + 816_730);
+  });
+
+  it('keeps each model in its own directory under the models root', () => {
+    expect(modelDir(findModel('turbo')!, '/home/me/.moxxy/models/stt')).toBe(
+      path.join('/home/me/.moxxy/models/stt', 'turbo'),
     );
   });
 
-  it('defaults to base', () => {
-    expect(DEFAULT_MODEL_ID).toBe('base');
+  it('defaults to turbo', () => {
+    expect(DEFAULT_MODEL_ID).toBe('turbo');
     expect(findModel(DEFAULT_MODEL_ID)).toBeDefined();
   });
 });
 
 describe('requireModel', () => {
   it('returns the catalog entry for a known id', () => {
-    expect(requireModel('small', 'model').id).toBe('small');
+    expect(requireModel('turbo', 'model').id).toBe('turbo');
   });
 
-  it('throws CONFIG_INVALID with the valid ids for an unknown model', () => {
-    expect(() => requireModel('medium', 'model')).toThrow(/Unknown local Whisper model/);
-    try {
-      requireModel('medium', 'model');
-    } catch (err) {
-      expect((err as { code?: string }).code).toBe('CONFIG_INVALID');
-      expect((err as { hint?: string }).hint).toContain('tiny, base, small');
+  it('rejects the removed tiny/base/small models with CONFIG_INVALID naming turbo', () => {
+    for (const removed of ['tiny', 'base', 'small']) {
+      try {
+        requireModel(removed, 'model');
+        expect.unreachable(`${removed} should be rejected`);
+      } catch (err) {
+        expect((err as { code?: string }).code).toBe('CONFIG_INVALID');
+        expect((err as Error).message).toMatch(/Unknown local Whisper model/);
+        expect((err as { hint?: string }).hint).toBe('Valid models: turbo.');
+      }
     }
   });
 });

package/src/models.ts

@@ -1,90 +1,85 @@
 /**
  * The pinned Whisper model catalog.
  *
- * Every model is a multilingual sherpa-onnx Whisper export published as a
- * `.tar.bz2` under the project's `asr-models` GitHub release. Each `sha256` is
- * copied VERBATIM from that release's `checksum.txt` (re-verified 2026-07-05) —
- * so a first-use download is content-addressed and tamper-evident, unlike an
- * unverified blob fetch. The archive extracts to a single top directory
- * (`archiveRootDir`) holding `<id>-encoder.onnx`, `<id>-decoder.onnx` (+ int8
- * variants we don't use) and `<id>-tokens.txt`.
+ * The one model is Whisper large-v3 turbo, the multilingual sherpa-onnx int8
+ * export. Its three files download as they are from Hugging Face, pinned to a
+ * fixed revision and checked against their size and sha256 — byte for byte the
+ * files the project's `asr-models` GitHub release packs into a `.tar.bz2`
+ * (verified 2026-10-24), but with no archive to unpack: unpacking it in
+ * JavaScript took about 67 s against 9 s for the download.
  *
- * All three are the MULTILINGUAL models (not the `.en` English-only exports),
- * so Polish (and any other Whisper language) works — `small` is the accuracy
- * sweet spot for Polish, `base` the balanced default, `tiny` the fastest.
+ * Multilingual (not an `.en` export), so Polish and every other Whisper
+ * language work.
  */
 
+import path from 'node:path';
+
 import { MoxxyError } from '@moxxy/sdk';
+import { moxxyPath } from '@moxxy/sdk/server';
+import type { ModelFile } from '@moxxy/model-fetch/files';
 
-export type WhisperModelId = 'tiny' | 'base' | 'small';
+export type WhisperModelId = 'turbo';
 
 export interface WhisperModelEntry {
-  /** Stable model id (also the `model` config value). */
+  /** Stable model id (also the `model` config value and its directory name). */
   readonly id: WhisperModelId;
   /** Human label for UI surfaces / the first-use notice. */
   readonly label: string;
-  /** Pinned archive URL (sherpa-onnx GitHub `asr-models` release). */
-  readonly url: string;
-  /** Pinned hex sha256 of the archive (from the release checksum.txt). */
-  readonly sha256: string;
-  /** Top directory the archive extracts to (`sherpa-onnx-whisper-<id>`). */
-  readonly archiveRootDir: string;
-  /** Encoder ONNX filename inside `archiveRootDir` (`<id>-encoder.onnx`). */
-  readonly encoderFile: string;
-  /** Decoder ONNX filename inside `archiveRootDir` (`<id>-decoder.onnx`). */
-  readonly decoderFile: string;
-  /** Tokens filename inside `archiveRootDir` (`<id>-tokens.txt`). */
-  readonly tokensFile: string;
-  /** Approximate download size in MB (for the one-time first-use notice). */
-  readonly approxMb: number;
+  readonly encoder: ModelFile;
+  readonly decoder: ModelFile;
+  readonly tokens: ModelFile;
 }
 
-const RELEASE_BASE = 'https://github.com/k2-fsa/sherpa-onnx/releases/download/asr-models';
-
-function whisperModel(
-  id: WhisperModelId,
-  label: string,
-  sha256: string,
-  approxMb: number,
-): WhisperModelEntry {
-  const archiveRootDir = `sherpa-onnx-whisper-${id}`;
-  return {
-    id,
-    label,
-    url: `${RELEASE_BASE}/${archiveRootDir}.tar.bz2`,
-    sha256,
-    archiveRootDir,
-    encoderFile: `${id}-encoder.onnx`,
-    decoderFile: `${id}-decoder.onnx`,
-    tokensFile: `${id}-tokens.txt`,
-    approxMb,
-  };
-}
+const TURBO_REVISION = '2ca6ff69fc878651b770880507669577ac41c2ff';
+const TURBO_BASE = `https://huggingface.co/csukuangfj/sherpa-onnx-whisper-turbo/resolve/${TURBO_REVISION}`;
 
 export const MODEL_CATALOG: readonly WhisperModelEntry[] = [
-  whisperModel(
-    'tiny',
-    'Whisper tiny (multilingual — fastest, lowest accuracy)',
-    'c46116994e539aa165266d96b325252728429c12535eb9d8b6a2b10f129e66b1',
-    111,
-  ),
-  whisperModel(
-    'base',
-    'Whisper base (multilingual — balanced; default)',
-    '911b2083efd7c0dca2ac3b358b75222660dc09fb716d64fbfc417ba6c99ff3de',
-    198,
-  ),
-  whisperModel(
-    'small',
-    'Whisper small (multilingual — best accuracy; recommended for Polish)',
-    '486a46afbb7ba798507190ffe02fea2dd726049af212e774537efac6afb210a6',
-    610,
-  ),
+  {
+    id: 'turbo',
+    label: 'Whisper turbo (multilingual, large-v3 turbo)',
+    encoder: {
+      name: 'turbo-encoder.int8.onnx',
+      url: `${TURBO_BASE}/turbo-encoder.int8.onnx`,
+      bytes: 674_716_297,
+      sha256: 'b02dcdf54f348741e93fe732b67d933c8dcb6735655f710640143081db38878b',
+    },
+    decoder: {
+      name: 'turbo-decoder.int8.onnx',
+      url: `${TURBO_BASE}/turbo-decoder.int8.onnx`,
+      bytes: 361_080_764,
+      sha256: '20accd02388482eb3a46bd615631adfdc85e1eb2c7db9ea3f02a40ffe6b81547',
+    },
+    tokens: {
+      name: 'turbo-tokens.txt',
+      url: `${TURBO_BASE}/turbo-tokens.txt`,
+      bytes: 816_730,
+      sha256: 'b34b360dbb493e781e479794586d661700670d65564001f23024971d1f2fa126',
+    },
+  },
 ];
 
-/** Default model when the caller doesn't pick one. `base` balances size vs.
- *  accuracy; `small` is recommended for Polish (see the catalog description). */
-export const DEFAULT_MODEL_ID: WhisperModelId = 'base';
+/** Every file of a model, in download order. */
+export function modelFiles(entry: WhisperModelEntry): ModelFile[] {
+  return [entry.encoder, entry.decoder, entry.tokens];
+}
+
+/** The model's download size in bytes. */
+export function modelBytes(entry: WhisperModelEntry): number {
+  return modelFiles(entry).reduce((sum, file) => sum + file.bytes, 0);
+}
+
+/** The models root: `~/.moxxy/models/stt`, MOXXY_HOME-aware. */
+export function defaultModelsDir(): string {
+  return moxxyPath('models', 'stt');
+}
+
+/** Where a model's files live under the models root. */
+export function modelDir(entry: WhisperModelEntry, modelsDir: string): string {
+  return path.join(modelsDir, entry.id);
+}
+
+/** The model used when the caller doesn't pick one — the only one there is. */
+export const DEFAULT_MODEL_ID: WhisperModelId = 'turbo';
 
 /** All valid model ids, for error messages and validation. */
 export function modelIds(): string[] {