feat: local offline voice models (sherpa-onnx) with model manager and wake word (v2.1.0)

- electron/voice: model catalog (Whisper base/small/turbo, SenseVoice, Kokoro v1.0,
  Piper fr), streaming tar.bz2 downloader with progress, sherpa-onnx worker running in
  an Electron utilityProcess (transcribe / synthesize / status / unload), IPC + bridge.
- Renderer: 'local' providers for STT and TTS, Settings → Modèles locaux (download,
  progress, delete, activate), speaker selection, hands-free wake word with a tolerant
  matcher (accents, punctuation, edit distance) and attention window after a bare wake word.
- Packaging: native addon and worker unpacked from the asar; release 2.1.0.

Validated on Linux: Kokoro (fr) → Whisper base round trip, Piper (fr) → Whisper round trip.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017Wn5VX9HNbJ7N54hR24u9Y

electron/voice/models.ts

@@ -0,0 +1,135 @@
+/**
+ * Model manager: downloads sherpa-onnx model archives (tar.bz2) into userData/models,
+ * extracts them, verifies required files and reports progress to the renderer.
+ */
+import { app, type WebContents } from 'electron';
+import fs from 'node:fs';
+import path from 'node:path';
+import { pipeline } from 'node:stream/promises';
+import { Readable, Transform } from 'node:stream';
+import * as tar from 'tar';
+import unbzip2 from 'unbzip2-stream';
+import { VOICE_IPC, type VoiceDownloadProgress, type VoiceModelSpec, type VoiceModelStatus } from '../../shared/voice';
+import { VOICE_CATALOG, findModel } from './catalog';
+import { log } from '../logger';
+
+const active = new Map<string, AbortController>();
+
+export function modelsDir(): string {
+  const dir = path.join(app.getPath('userData'), 'models');
+  fs.mkdirSync(dir, { recursive: true });
+  return dir;
+}
+
+export function modelDir(spec: VoiceModelSpec): string {
+  return path.join(modelsDir(), spec.dir);
+}
+
+export function isInstalled(spec: VoiceModelSpec): boolean {
+  const dir = modelDir(spec);
+  return spec.files.every((f) => fs.existsSync(path.join(dir, f)));
+}
+
+function dirSize(dir: string): number {
+  let total = 0;
+  try {
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+      const full = path.join(dir, entry.name);
+      if (entry.isDirectory()) total += dirSize(full);
+      else total += fs.statSync(full).size;
+    }
+  } catch {
+    /* missing */
+  }
+  return total;
+}
+
+export function listModels(): VoiceModelStatus[] {
+  return VOICE_CATALOG.map((spec) => {
+    const installed = isInstalled(spec);
+    return {
+      ...spec,
+      installed,
+      downloading: active.has(spec.id),
+      installedBytes: installed ? dirSize(modelDir(spec)) : 0
+    };
+  });
+}
+
+export async function removeModel(id: string): Promise<void> {
+  const spec = findModel(id);
+  if (!spec) throw new Error(`Modèle inconnu : ${id}`);
+  await fs.promises.rm(modelDir(spec), { recursive: true, force: true });
+  log('INFO', 'voice', `model removed: ${id}`);
+}
+
+export function cancelDownload(id: string): void {
+  active.get(id)?.abort();
+}
+
+export async function downloadModel(id: string, sender: WebContents | null): Promise<VoiceModelStatus> {
+  const spec = findModel(id);
+  if (!spec) throw new Error(`Modèle inconnu : ${id}`);
+  if (active.has(id)) throw new Error('Téléchargement déjà en cours');
+  const controller = new AbortController();
+  active.set(id, controller);
+  const report = (progress: Omit<VoiceDownloadProgress, 'id'>) => {
+    if (sender && !sender.isDestroyed()) sender.send(VOICE_IPC.modelsProgress, { id, ...progress });
+  };
+
+  const tmpDir = path.join(modelsDir(), `.tmp-${spec.id}`);
+  await fs.promises.rm(tmpDir, { recursive: true, force: true });
+  await fs.promises.mkdir(tmpDir, { recursive: true });
+
+  try {
+    log('INFO', 'voice', `downloading ${spec.id} from ${spec.url}`);
+    const response = await fetch(spec.url, { signal: controller.signal, redirect: 'follow' });
+    if (!response.ok || !response.body) throw new Error(`HTTP ${response.status} lors du téléchargement`);
+    const total = Number(response.headers.get('content-length')) || Math.round(spec.sizeMb * 1024 * 1024);
+    let received = 0;
+    let lastReport = 0;
+    const counter = new Transform({
+      transform(chunk: Buffer, _enc, cb) {
+        received += chunk.length;
+        const now = Date.now();
+        if (now - lastReport > 250) {
+          lastReport = now;
+          report({ phase: 'download', received, total, percent: Math.min(99, Math.round((received / total) * 100)) });
+        }
+        cb(null, chunk);
+      }
+    });
+
+    const source = Readable.fromWeb(response.body as import('node:stream/web').ReadableStream<Uint8Array>);
+    if (spec.url.endsWith('.tar.bz2')) {
+      report({ phase: 'download', received: 0, total, percent: 0 });
+      await pipeline(source, counter, unbzip2(), tar.x({ cwd: tmpDir }), { signal: controller.signal });
+    } else {
+      const target = path.join(tmpDir, spec.dir, path.basename(spec.url));
+      await fs.promises.mkdir(path.dirname(target), { recursive: true });
+      await pipeline(source, counter, fs.createWriteStream(target), { signal: controller.signal });
+    }
+    report({ phase: 'extract', received: total, total, percent: 99 });
+
+    const extracted = path.join(tmpDir, spec.dir);
+    const missing = spec.files.filter((f) => !fs.existsSync(path.join(extracted, f)));
+    if (missing.length) throw new Error(`Archive incomplète, fichiers manquants : ${missing.join(', ')}`);
+
+    const finalDir = modelDir(spec);
+    await fs.promises.rm(finalDir, { recursive: true, force: true });
+    await fs.promises.rename(extracted, finalDir);
+    await fs.promises.rm(tmpDir, { recursive: true, force: true });
+    report({ phase: 'done', received: total, total, percent: 100 });
+    log('INFO', 'voice', `model installed: ${spec.id}`);
+  } catch (err) {
+    await fs.promises.rm(tmpDir, { recursive: true, force: true }).catch(() => undefined);
+    const e = err as Error;
+    const cancelled = e.name === 'AbortError' || controller.signal.aborted;
+    report({ phase: cancelled ? 'cancelled' : 'error', received: 0, total: 0, percent: 0, message: cancelled ? 'annulé' : e.message });
+    log(cancelled ? 'INFO' : 'ERROR', 'voice', `download ${spec.id} ${cancelled ? 'cancelled' : 'failed: ' + e.message}`);
+    if (!cancelled) throw new Error(e.message);
+  } finally {
+    active.delete(id);
+  }
+  return listModels().find((m) => m.id === id)!;
+}