@hxnnxs/opencode-voice 0.1.2 → 0.1.3

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project are documented here.
 
+## 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/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 });

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/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.3",
   "description": "Local voice input plugin for OpenCode",
   "type": "module",
   "license": "MIT",