@hxnnxs/opencode-voice 0.1.2 → 0.1.4

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to this project are documented here.
 
+## 0.1.4 - 2026-06-16
+
+### Added
+
+- Added bundled `ffmpeg` fallback for Windows recorder flow via `ffmpeg-static` so voice input no longer depends on user-installed `ffmpeg`.
+- Added Windows DirectShow microphone discovery and input handling in the recorder layer.
+
+## 0.1.3 - 2026-06-15
+
+### Fixed
+
+- Made Windows engine and model downloads more reliable with five install attempts, longer transfer stall timeouts, safer resume validation, and retrying final file replacement.
+- Added HuggingFace fallback mirrors for Whisper models that have upstream mirror assets.
+
 ## 0.1.2 - 2026-06-15
 
 ### Fixed

package/README.md

@@ -112,7 +112,7 @@ Planned sidecar models:
 | -------- | ------ |
 | Linux    | one-command engine/model install; recording uses `arecord`, `ffmpeg`, or `sox` |
 | macOS    | one-command engine/model install; recording uses `ffmpeg` AVFoundation until the native recorder sidecar ships |
-| Windows  | engine download path ready; recording needs the native recorder sidecar |
+| Windows  | one-command engine/model install; recording uses `ffmpeg` with DirectShow (system or bundled `ffmpeg` fallback) |
 
 ### Architecture
 
@@ -139,7 +139,7 @@ Voice input needs native audio and STT binaries. The JS plugin manages OpenCode
 - publish managed `whisper-cli` release assets before npm release
 - Rust recorder sidecar with `cpal` and VAD
 - Parakeet, GigaAM, SenseVoice, Canary, and Moonshine model support
-- Windows recorder support
+- Windows recorder stability and UX polish
 - faster streaming-style transcription
 
 ### Development

package/docs/README.es.md

@@ -110,7 +110,7 @@ Modelos sidecar planeados:
 | ---------- | ------ |
 | Linux      | instalación engine/model en una orden; la grabación usa `arecord`, `ffmpeg` o `sox` |
 | macOS      | instalación engine/model en una orden; la grabación usa `ffmpeg` AVFoundation hasta el native recorder sidecar |
-| Windows    | ruta de descarga de engine lista; la grabación necesita el native recorder sidecar |
+| Windows    | instalación one-command de engine/model; grabación con `ffmpeg` + DirectShow (desde ffmpeg del sistema o fallback incluido) |
 
 ### Arquitectura
 
@@ -137,7 +137,7 @@ La entrada por voz necesita native audio y STT binaries. El plugin JS gestiona O
 - publicar managed `whisper-cli` release assets antes del npm release
 - Rust recorder sidecar con `cpal` y VAD
 - soporte para Parakeet, GigaAM, SenseVoice, Canary y Moonshine
-- Windows recorder support
+- Mejorar estabilidad y UX del recorder en Windows
 - streaming-style transcription más rápida
 
 ### Desarrollo

package/docs/README.ru.md

@@ -110,7 +110,7 @@ Hold-to-talk отключен по умолчанию, потому что termi
 | --------- | ------ |
 | Linux     | one-command engine/model install; запись использует `arecord`, `ffmpeg` или `sox` |
 | macOS     | one-command engine/model install; запись использует `ffmpeg` AVFoundation до native recorder sidecar |
-| Windows   | путь скачивания engine готов; recording ждёт native recorder sidecar |
+| Windows   | one-command engine/model install; запись через `ffmpeg` + DirectShow (через системный ffmpeg или встроенный fallback) |
 
 ### Архитектура
 
@@ -137,7 +137,7 @@ Voice input требует native audio и STT binaries. JS-плагин упр
 - опубликовать managed `whisper-cli` release assets перед npm release
 - Rust recorder sidecar с `cpal` и VAD
 - поддержка Parakeet, GigaAM, SenseVoice, Canary и Moonshine
-- Windows recorder support
+- Улучшение устойчивости и UX Windows recorder
 - более быстрая streaming-style transcription
 
 ### Разработка

package/docs/README.zh.md

@@ -110,7 +110,7 @@ ctrl+r -> 停止、转写并插入文本
 | ------- | ---- |
 | Linux   | 一条命令安装 engine/model；录音使用 `arecord`、`ffmpeg` 或 `sox` |
 | macOS   | 一条命令安装 engine/model；native recorder sidecar 发布前使用 `ffmpeg` AVFoundation |
-| Windows | engine 下载路径已准备好；录音还需要 native recorder sidecar |
+| Windows | 下载 engine/model 一条命令完成；通过 `ffmpeg` + DirectShow 录音（使用系统 ffmpeg 或内置备用） |
 
 ### 架构
 
@@ -137,7 +137,7 @@ ctrl+r -> 停止、转写并插入文本
 - npm release 前发布 managed `whisper-cli` release assets
 - 使用 `cpal` 和 VAD 的 Rust recorder sidecar
 - 支持 Parakeet、GigaAM、SenseVoice、Canary 和 Moonshine
-- Windows recorder support
+- 更完善的 Windows 录音体验和稳定性
 - 更快的 streaming-style transcription
 
 ### 开发

package/index.js

@@ -164,11 +164,11 @@ async function ensureDownloaded(ctx, model, settings) {
   const startedAt = Date.now();
   let lastRender = 0;
   let speedBps = 0;
-  renderDownloadStatus(ctx, model, { state: "starting", downloaded: 0, total: model.sizeMB ? model.sizeMB * 1024 * 1024 : 0, percent: 0, attempt: 1, attempts: 3, speedBps });
+  renderDownloadStatus(ctx, model, { state: "starting", downloaded: 0, total: model.sizeMB ? model.sizeMB * 1024 * 1024 : 0, percent: 0, attempt: 1, attempts: 5, speedBps });
 
   toast(ctx.api, `Downloading ${model.name}...`);
   await downloadModel(model, ctx.options, settings, {
-    retries: 3,
+    retries: 5,
     onProgress: (progress) => {
       const now = Date.now();
       const elapsed = Math.max(1, (now - startedAt) / 1000);
@@ -202,10 +202,10 @@ async function ensureEngineReady(ctx, settings) {
     if (probe.ok) return true;
   }
 
-  renderEngineInstallStatus(ctx, { state: "registry", downloaded: 0, total: 0, percent: 0, attempt: 1, attempts: 3 });
+  renderEngineInstallStatus(ctx, { state: "registry", downloaded: 0, total: 0, percent: 0, attempt: 1, attempts: 5 });
   toast(ctx.api, "Installing local voice engine...");
   await installManagedEngine("whisper.cpp", commandOptions, settings, {
-    retries: 3,
+    retries: 5,
     onProgress: (progress) => renderEngineInstallStatus(ctx, progress),
     onRetry: ({ error, nextAttempt, attempts }) => {
       renderEngineInstallStatus(ctx, { state: "downloading", downloaded: 0, total: 0, percent: 0, attempt: nextAttempt, attempts });
@@ -325,6 +325,7 @@ function showLanguagePicker(ctx) {
 
 function showMicrophonePicker(ctx) {
   const settings = readSettings(ctx.api.kv);
+  const placeholder = process.platform === "win32" ? "default, audio=default, \"Microphone (Name)\"" : "default, hw:0,0, pulse, :0, ...";
   const devices = listMicrophones();
   setDialog(ctx, "large", () =>
     ctx.api.ui.DialogSelect({
@@ -339,7 +340,7 @@ function showMicrophonePicker(ctx) {
         if (option.value === "__custom") {
           showPrompt(ctx, {
             title: "Custom microphone device",
-            placeholder: "default, hw:0,0, pulse, :0, ...",
+            placeholder,
             value: settings.mic,
             onConfirm: (value) => {
               writeSetting(ctx.api.kv, "mic", value.trim());

package/lib/download.js

@@ -4,6 +4,9 @@ import { Readable, Transform } from "node:stream";
 import { pipeline } from "node:stream/promises";
 import { getModelPath, getModelsDir, getModelVerificationPath } from "./models.js";
 
+const DEFAULT_DOWNLOAD_RETRIES = 5;
+const DEFAULT_DOWNLOAD_TIMEOUT_MS = 120000;
+
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -33,18 +36,55 @@ export async function writeModelVerificationMarker(model, file, options = {}, se
 
 async function fetchWithTimeout(url, init = {}, timeoutMs = 60000) {
   const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  let timer;
+  const reset = () => {
+    clearTimeout(timer);
+    timer = setTimeout(() => controller.abort(), timeoutMs);
+  };
+  const clear = () => clearTimeout(timer);
+  reset();
+
   try {
-    return await fetch(url, { ...init, signal: controller.signal });
+    const response = await fetch(url, { ...init, signal: controller.signal });
+    return { response, signal: controller.signal, reset, clear };
   } catch (error) {
+    clear();
     if (error?.name === "AbortError") throw new Error(`Download timed out after ${Math.round(timeoutMs / 1000)}s`);
     throw error;
-  } finally {
-    clearTimeout(timer);
   }
 }
 
-async function downloadModelOnce(model, options = {}, settings = {}, hooks = {}, attempt = 1, attempts = 1) {
+function downloadError(error, url, timeoutMs) {
+  if (error?.name === "AbortError" || error?.code === "ABORT_ERR") {
+    return new Error(`Download timed out or stalled from ${url} after ${Math.round(timeoutMs / 1000)}s`);
+  }
+  return error;
+}
+
+function modelUrls(model) {
+  return [...new Set([...(Array.isArray(model.urls) ? model.urls : []), model.url].filter(Boolean))];
+}
+
+function contentRangeStart(value) {
+  const match = /^bytes\s+(\d+)-/i.exec(value || "");
+  return match ? Number(match[1]) : null;
+}
+
+async function replaceFile(source, destination) {
+  await fs.promises.unlink(destination).catch(() => {});
+
+  for (let attempt = 1; attempt <= 5; attempt++) {
+    try {
+      await fs.promises.rename(source, destination);
+      return;
+    } catch (error) {
+      if (attempt >= 5 || !["EBUSY", "EPERM", "EACCES"].includes(error?.code)) throw error;
+      await sleep(100 * attempt);
+    }
+  }
+}
+
+async function downloadModelOnce(model, sourceUrl, options = {}, settings = {}, hooks = {}, attempt = 1, attempts = 1) {
   if (!model?.implemented || !model.url || !model.filename) {
     throw new Error(`${model?.name || "Model"} is not supported by the current local engine yet`);
   }
@@ -66,57 +106,83 @@ async function downloadModelOnce(model, options = {}, settings = {}, hooks = {},
 
   const partialSize = fs.existsSync(partial) ? fs.statSync(partial).size : 0;
   const headers = partialSize > 0 ? { Range: `bytes=${partialSize}-` } : undefined;
-  const response = await fetchWithTimeout(model.url, { headers }, Number(options.downloadTimeoutMs || hooks.timeoutMs || 60000));
+  const timeoutMs = Number(options.downloadTimeoutMs || hooks.timeoutMs || DEFAULT_DOWNLOAD_TIMEOUT_MS);
+  const request = await fetchWithTimeout(sourceUrl, { headers }, timeoutMs);
+  const response = request.response;
 
-  if (response.status === 416 && partialSize > 0) {
-    await fs.promises.unlink(partial).catch(() => {});
-    return downloadModelOnce(model, options, settings, hooks, attempt, attempts);
-  }
+  try {
+    if (response.status === 416 && partialSize > 0) {
+      await fs.promises.unlink(partial).catch(() => {});
+      return downloadModelOnce(model, sourceUrl, options, settings, hooks, attempt, attempts);
+    }
 
-  if (!response.ok && response.status !== 206) {
-    throw new Error(`Download failed: HTTP ${response.status}`);
-  }
+    if (!response.ok && response.status !== 206) {
+      throw new Error(`Download failed from ${sourceUrl}: HTTP ${response.status}`);
+    }
 
-  const append = response.status === 206 && partialSize > 0;
-  const contentLength = Number(response.headers.get("content-length") || 0);
-  const total = contentLength > 0 ? contentLength + (append ? partialSize : 0) : model.sizeMB ? model.sizeMB * 1024 * 1024 : 0;
-  let downloaded = append ? partialSize : 0;
+    const append = response.status === 206 && partialSize > 0;
+    const rangeStart = append ? contentRangeStart(response.headers.get("content-range")) : null;
+    if (append && rangeStart !== null && rangeStart !== partialSize) {
+      await fs.promises.unlink(partial).catch(() => {});
+      throw new Error(`Download resume mismatch from ${sourceUrl}: expected byte ${partialSize}, got ${rangeStart}`);
+    }
 
-  hooks.onProgress?.({ state: "downloading", downloaded, total, percent: total ? (downloaded / total) * 100 : 0, attempt, attempts });
+    const contentLength = Number(response.headers.get("content-length") || 0);
+    const total = contentLength > 0 ? contentLength + (append ? partialSize : 0) : model.sizeMB ? model.sizeMB * 1024 * 1024 : 0;
+    let downloaded = append ? partialSize : 0;
 
-  const body = response.body?.getReader ? Readable.fromWeb(response.body) : response.body;
-  if (!body) throw new Error("Download failed: empty response body");
+    hooks.onProgress?.({ state: "downloading", downloaded, total, percent: total ? (downloaded / total) * 100 : 0, attempt, attempts });
 
-  const progress = new Transform({
-    transform(chunk, _encoding, callback) {
-      downloaded += chunk.length ?? chunk.byteLength ?? 0;
-      hooks.onProgress?.({ state: "downloading", downloaded, total, percent: total ? (downloaded / total) * 100 : 0, attempt, attempts });
-      callback(null, chunk);
-    },
-  });
+    const body = response.body?.getReader ? Readable.fromWeb(response.body) : response.body;
+    if (!body) throw new Error("Download failed: empty response body");
 
-  await pipeline(body, progress, fs.createWriteStream(partial, { flags: append ? "a" : "w" }));
+    const progress = new Transform({
+      transform(chunk, _encoding, callback) {
+        request.reset();
+        downloaded += chunk.length ?? chunk.byteLength ?? 0;
+        hooks.onProgress?.({ state: "downloading", downloaded, total, percent: total ? (downloaded / total) * 100 : 0, attempt, attempts });
+        callback(null, chunk);
+      },
+    });
 
-  hooks.onProgress?.({ state: "verifying", downloaded, total: total || downloaded, percent: 100, attempt, attempts });
+    try {
+      await pipeline(body, progress, fs.createWriteStream(partial, { flags: append ? "a" : "w" }), { signal: request.signal });
+    } catch (error) {
+      throw downloadError(error, sourceUrl, timeoutMs);
+    }
+    request.clear();
 
-  if (!(await verifyModel(model, partial))) {
-    await fs.promises.unlink(partial).catch(() => {});
-    throw new Error(`SHA256 mismatch for ${model.name}`);
-  }
+    const actualSize = fs.statSync(partial).size;
+    downloaded = actualSize;
+    if (contentLength > 0 && actualSize < total) {
+      throw new Error(`Download incomplete from ${sourceUrl}: got ${actualSize} of ${total} bytes`);
+    }
+
+    hooks.onProgress?.({ state: "verifying", downloaded, total: total || downloaded, percent: 100, attempt, attempts });
 
-  await fs.promises.rename(partial, file);
-  await writeModelVerificationMarker(model, file, options, settings);
-  hooks.onProgress?.({ state: "done", downloaded, total: total || downloaded, percent: 100, attempt, attempts });
-  return file;
+    if (!(await verifyModel(model, partial))) {
+      await fs.promises.unlink(partial).catch(() => {});
+      throw new Error(`SHA256 mismatch for ${model.name}`);
+    }
+
+    await replaceFile(partial, file);
+    await writeModelVerificationMarker(model, file, options, settings);
+    hooks.onProgress?.({ state: "done", downloaded, total: total || downloaded, percent: 100, attempt, attempts });
+    return file;
+  } finally {
+    request.clear();
+  }
 }
 
 export async function downloadModel(model, options = {}, settings = {}, hooks = {}) {
-  const attempts = Number(options.downloadRetries || hooks.retries || 3);
+  const urls = modelUrls(model);
+  const attempts = Math.max(Number(options.downloadRetries || hooks.retries || DEFAULT_DOWNLOAD_RETRIES), urls.length || 1);
   let lastError;
 
   for (let attempt = 1; attempt <= attempts; attempt++) {
+    const sourceUrl = urls[(attempt - 1) % urls.length];
     try {
-      return await downloadModelOnce(model, options, settings, hooks, attempt, attempts);
+      return await downloadModelOnce(model, sourceUrl, options, settings, hooks, attempt, attempts);
     } catch (error) {
       lastError = error;
       if (attempt >= attempts) break;

package/lib/engine.js

@@ -1,10 +1,13 @@
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
+import { createRequire } from "node:module";
 import { spawn, spawnSync } from "node:child_process";
 import { ensureDir } from "./download.js";
 import { getAudioDir, getEnginesDir, getModelPath } from "./models.js";
 
+const require = createRequire(import.meta.url);
+
 const RECORDING_MIN_BYTES = 44;
 
 function isExecutable(file) {
@@ -31,6 +34,16 @@ function executableNames(command) {
   return [...new Set(names)];
 }
 
+function bundledFfmpegPath() {
+  if (process.platform !== "win32") return "";
+  try {
+    const candidate = require("ffmpeg-static");
+    return typeof candidate === "string" ? candidate : "";
+  } catch {
+    return "";
+  }
+}
+
 function platformKey(options = {}) {
   return `${options.platform || process.platform}-${options.arch || process.arch}`;
 }
@@ -52,6 +65,11 @@ function candidateCommands(command, options = {}) {
     if (process.env.OPENCODE_VOICE_WHISPER_CLI) candidates.push(process.env.OPENCODE_VOICE_WHISPER_CLI);
   }
 
+  if (command === "ffmpeg") {
+    const bundled = bundledFfmpegPath();
+    if (bundled) candidates.push(bundled);
+  }
+
   const bundledDir = getBundledEngineDir(command, options);
   if (bundledDir) {
     for (const name of executableNames(command)) candidates.push(path.join(bundledDir, name));
@@ -113,6 +131,23 @@ function childEnv(options = {}) {
   };
 }
 
+function normalizeWindowsAudioInput(device = "") {
+  const value = String(device).trim();
+  if (!value || value === "default") return "audio=default";
+  if (value.startsWith("audio=") || value.startsWith("video=")) return value;
+  return `audio=${value}`;
+}
+
+function parseWindowsMicrophones(stderr) {
+  const devices = new Set();
+  for (const line of stderr.split(/\r?\n/)) {
+    const match = line.match(/"([^"]+)"\s+\(audio\)/);
+    if (match?.[1]) devices.add(match[1]);
+  }
+
+  return [...devices].filter(Boolean);
+}
+
 export function listMicrophones() {
   if (process.platform === "linux" && commandExists("arecord")) {
     const result = spawnSync("arecord", ["-L"], { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
@@ -135,6 +170,15 @@ export function listMicrophones() {
       .map((id) => `:${id}`);
   }
 
+  if (process.platform === "win32" && commandExists("ffmpeg")) {
+    const result = spawnSync("ffmpeg", ["-hide_banner", "-f", "dshow", "-list_devices", "true", "-i", "dummy"], {
+      encoding: "utf8",
+      stdio: ["ignore", "ignore", "pipe"],
+    });
+    const devices = parseWindowsMicrophones(result.stderr || "");
+    return ["default", ...devices.filter((device) => device !== "default")];
+  }
+
   return ["default"];
 }
 
@@ -174,6 +218,17 @@ function buildRecorders(file, settings = {}) {
     });
   }
 
+  if (process.platform === "win32" && commandExists("ffmpeg")) {
+    const inputs = [...new Set([normalizeWindowsAudioInput(mic), "audio=default"])];
+    for (const input of inputs) {
+      recorders.push({
+        label: `ffmpeg dshow (${input.replace(/^audio=/, "")})`,
+        command: "ffmpeg",
+        args: ["-hide_banner", "-loglevel", "error", "-y", "-f", "dshow", "-i", input, "-ac", "1", "-ar", "16000", file],
+      });
+    }
+  }
+
   if (commandExists("sox")) {
     recorders.push({
       label: "sox default",

package/lib/engines.js

@@ -18,6 +18,8 @@ const ENGINE = {
   probeContains: ["--model", "--file"],
 };
 
+const DEFAULT_ENGINE_DOWNLOAD_RETRIES = 5;
+
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -257,7 +259,7 @@ export async function installManagedEngine(engineId = ENGINE.id, options = {}, s
   await ensureDir(managedDir);
   const compressedFile = path.join(managedDir, `${path.basename(asset.url || `${platform}.gz`)}.download`);
   const tmpBinary = temporaryBinaryPath(managedBinary);
-  const attempts = Number(options.engineDownloadRetries || hooks.retries || 3);
+  const attempts = Number(options.engineDownloadRetries || hooks.retries || DEFAULT_ENGINE_DOWNLOAD_RETRIES);
   let lastError;
 
   for (let attempt = 1; attempt <= attempts; attempt++) {

package/lib/models.js

@@ -14,6 +14,7 @@ export const MODELS = [
     recommended: true,
     filename: "ggml-small.bin",
     url: "https://blob.handy.computer/ggml-small.bin",
+    urls: ["https://blob.handy.computer/ggml-small.bin", "https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-small.bin"],
     sha256: "1be3a9b2063867b937e64e2ec7483364a79917e157fa98c5d94b5c1fffea987b",
     sizeMB: 465,
     languages: "multilingual",
@@ -26,6 +27,7 @@ export const MODELS = [
     implemented: true,
     filename: "whisper-medium-q4_1.bin",
     url: "https://blob.handy.computer/whisper-medium-q4_1.bin",
+    urls: ["https://blob.handy.computer/whisper-medium-q4_1.bin"],
     sha256: "79283fc1f9fe12ca3248543fbd54b73292164d8df5a16e095e2bceeaaabddf57",
     sizeMB: 469,
     languages: "multilingual",
@@ -38,6 +40,7 @@ export const MODELS = [
     implemented: true,
     filename: "ggml-large-v3-turbo.bin",
     url: "https://blob.handy.computer/ggml-large-v3-turbo.bin",
+    urls: ["https://blob.handy.computer/ggml-large-v3-turbo.bin", "https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-turbo.bin"],
     sha256: "1fc70f774d38eb169993ac391eea357ef47c88757ef72ee5943879b7e8e2bc69",
     sizeMB: 1549,
     languages: "multilingual",
@@ -50,6 +53,7 @@ export const MODELS = [
     implemented: true,
     filename: "ggml-large-v3-q5_0.bin",
     url: "https://blob.handy.computer/ggml-large-v3-q5_0.bin",
+    urls: ["https://blob.handy.computer/ggml-large-v3-q5_0.bin", "https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-q5_0.bin"],
     sha256: "d75795ecff3f83b5faa89d1900604ad8c780abd5739fae406de19f23ecd98ad1",
     sizeMB: 1031,
     languages: "multilingual",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hxnnxs/opencode-voice",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Local voice input plugin for OpenCode",
   "type": "module",
   "license": "MIT",
@@ -45,6 +45,9 @@
     "check": "node --check index.js && node --check lib/models.js && node --check lib/download.js && node --check lib/engine.js && node --check lib/engines.js && node --check bin/opencode-voice.js && node --check scripts/package-engine-asset.mjs && node --check scripts/build-engine-registry.mjs",
     "prepack": "npm run check"
   },
+  "dependencies": {
+    "ffmpeg-static": "^5.2.0"
+  },
   "publishConfig": {
     "access": "public",
     "provenance": true