@goodandready/dsh-voice 0.8.17 → 0.8.19

package/lib/providers.js

@@ -1,27 +1,24 @@
-// Провайдеры распознавания речи: четыре встроенных плюс любые свои, объявленные
-// в настройках. Чистые функции: сеть приходит параметром (fetchImpl), ключи —
-// через resolveKey, поэтому всё проверяется без реальных запросов.
+// Speech recognition providers: built-ins plus custom ones from settings.
+// Pure functions: network arrives as fetchImpl, keys via resolveKey, so
+// everything is testable without real requests.
 
-// 'browser' стоит в этом списке, но работает не здесь: речь распознаёт сам
-// браузер, до хоста звук не доходит. Ключ нужен, чтобы такую цепочку принимал
-// и валидатор настроек, и перебор ниже — иначе цепочка ['browser', 'groq'] на
-// хосте оборвалась бы на первом же шаге вместо перехода к groq.
+// 'browser' is listed for chain validation only: recognition runs in the
+// page and audio never reaches the host. Without this key a ['browser','groq']
+// chain would break on the host instead of falling through to groq.
 export const PROVIDER_KEYS = ['browser', 'deepgram', 'groq', 'hf', 'local-whisper', 'sensevoice']
 
-// Свой провайдер описывается одним из двух шаблонов, потому что
-// OpenAI-совместимые API разошлись: у OpenRouter, например, нет
-// /audio/transcriptions вовсе, и распознавание там идёт через чат.
+// Custom providers use one of two templates because OpenAI-compatible APIs
+// diverged: OpenRouter has no /audio/transcriptions and recognizes via chat.
 export const CUSTOM_TEMPLATES = ['openai-transcriptions', 'openai-chat-audio']
 
-// Готовые провайдеры: то же самое, что свой провайдер, только адрес, модель и
-// имя ключа уже проставлены. Нужен лишь ключ.
+// Presets: the same as a custom provider with address, model and key name
+// already filled in. Only the key itself is required.
 //
-// Каждый адрес проверен запросом без ключа: все отвечают 401 «дайте ключ», то
-// есть путь существует. Модель — разумная отправная точка, её можно заменить
-// в строке цепочки, не трогая остальное.
+// Each URL answers 401 without a key, so the path exists. The model is a
+// reasonable starting point and can be overridden per chain row.
 //
-// Своим провайдером с тем же именем можно перекрыть любую заготовку целиком:
-// это не встроенный движок, а всего лишь заранее заполненная анкета.
+// A custom provider with the same name fully replaces a preset: presets are
+// prefilled forms, not special engines.
 export const PRESET_PROVIDERS = {
   openai: {
     template: 'openai-transcriptions',
@@ -53,7 +50,7 @@ export const PRESET_PROVIDERS = {
     model: 'voxtral-mini-latest',
     keyEnv: 'MISTRAL_API_KEY',
   },
-  // У OpenRouter нет /audio/transcriptions вовсе — только через чат.
+  // OpenRouter has no /audio/transcriptions at all — chat only.
   openrouter: {
     template: 'openai-chat-audio',
     baseURL: 'https://openrouter.ai/api/v1',
@@ -64,15 +61,15 @@ export const PRESET_PROVIDERS = {
 
 export const PRESET_KEYS = Object.keys(PRESET_PROVIDERS)
 
-/** Все имена, которые можно ставить в цепочку без объявления своего провайдера. */
+/** All names usable in a chain without declaring a custom provider. */
 export const KNOWN_KEYS = PROVIDER_KEYS.concat(PRESET_KEYS)
 
 const CHAT_AUDIO_PROMPT =
   'Transcribe the audio verbatim. Reply with the transcript text only, '
   + 'without comments, quotes or formatting.'
 
-// Форматы, которые чат-шаблон принимает в input_audio. Всё остальное —
-// включая webm/opus, который пишет браузер, — сначала перегоняем в WAV.
+// Formats the chat template accepts in input_audio. Everything else
+// (including browser webm/opus) is converted to WAV first.
 function chatAudioFormat(mime) {
   if (mime.includes('wav')) return 'wav'
   if (mime.includes('mpeg') || mime.includes('mp3')) return 'mp3'
@@ -99,8 +96,8 @@ function fileName(mime) {
   return 'audio.webm'
 }
 
-// Автоязык: пусто, 'auto' или список ('ru,en') — провайдер определяет сам,
-// поле language не отправляется. whisper.cpp при этом получает -l auto.
+// Auto language: empty, 'auto', or a list ('ru,en') means the provider
+// detects language; the language field is omitted. whisper.cpp gets -l auto.
 function isAutoLang(lang) {
   return !lang || lang === 'auto' || String(lang).includes(',')
 }
@@ -167,8 +164,8 @@ export function makeProviders(deps, req) {
     return { ok: text.length > 0, provider: 'hf', text, reason: text ? '' : 'empty transcript' }
   }
 
-  // whisper.cpp принимает только WAV — на webm/opus из браузера его сервер
-  // отвечает "Invalid request". Перегоняем, если формат не WAV.
+  // whisper.cpp accepts WAV only — browser webm/opus gets "Invalid request".
+  // Convert when the format is not WAV.
   async function localWhisper() {
     let sendBytes = bytes
     let sendMime = mime
@@ -195,11 +192,11 @@ export function makeProviders(deps, req) {
     if (vocab) form.append('prompt', vocab)
     form.append('response_format', 'json')
     const res = await fetchImpl(cfg.whisperUrl, { method: 'POST', body: form, signal })
-    // whisper.cpp отвечает 400 с JSON-телом на внутренних сбоях (например, не
-    // смог декодировать аудио) — читаем причину, а не бросаем исключение.
+    // whisper.cpp returns 400 with a JSON body on internal failures (e.g. decode
+    // errors) — read the reason instead of throwing.
     if (!res.ok) {
       let detail = `HTTP ${res.status}`
-      try { const e = await res.json(); if (e?.error) detail = e.error } catch { /* тело не json */ }
+      try { const e = await res.json(); if (e?.error) detail = e.error } catch { /* body is not json */ }
       return { ok: false, provider: 'local-whisper', reason: `local whisper: ${detail}` }
     }
     const data = await res.json()
@@ -207,8 +204,8 @@ export function makeProviders(deps, req) {
     return { ok: text.length > 0, provider: 'local-whisper', text, reason: text ? '' : 'empty transcript' }
   }
 
-  // SenseVoice-ONNX / Sherpa-ONNX: сверхбыстрое локальное распознавание (~50-100ms).
-  // Поддерживает эндпоинты sherpa-onnx (/api/v1/asr) и OpenAI-совместимые (/audio/transcriptions).
+  // SenseVoice-ONNX / Sherpa-ONNX: ultra-fast local recognition (~50-100ms).
+  // Supports sherpa-onnx (/api/v1/asr) and OpenAI-compatible endpoints.
   async function sensevoice() {
     const url = String(cfg.sensevoiceUrl || 'http://127.0.0.1:6006/api/v1/asr').trim()
     let sendBytes = bytes
@@ -244,7 +241,7 @@ export function makeProviders(deps, req) {
 
     if (!res.ok) {
       let detail = `HTTP ${res.status}`
-      try { const e = await res.json(); if (e?.error) detail = e.error } catch { /* тело не json */ }
+      try { const e = await res.json(); if (e?.error) detail = e.error } catch { /* body is not json */ }
       return { ok: false, provider: 'sensevoice', reason: `sensevoice: ${detail}` }
     }
 
@@ -256,7 +253,7 @@ export function makeProviders(deps, req) {
     }
 
     let text = String(data?.text || data?.transcript || '').trim()
-    // Очищаем служебные теги эмоций и звуковых событий SenseVoice (<|NEUTRAL|>, <|HAPPY|>, <|Speech|> и др.)
+    // Strip SenseVoice emotion/event tags (<|NEUTRAL|>, <|HAPPY|>, <|Speech|>, ...).
     text = text.replace(/<\|[^|>]+\|>/g, '').trim()
     return {
       ok: text.length > 0,
@@ -266,8 +263,8 @@ export function makeProviders(deps, req) {
     }
   }
 
-  // Свой провайдер. Ключ в цепочке — его имя, поэтому в остальном коде он
-  // ничем не отличается от встроенного.
+  // Custom provider. The chain key is its name, so the rest of the code
+  // treats it like a built-in.
   function customProvider(spec) {
     const label = spec.key
     const base = String(spec.baseURL || '').replace(/\/+$/, '')
@@ -338,27 +335,27 @@ export function makeProviders(deps, req) {
           ? await viaChatAudio(headers)
           : await viaTranscriptions(headers)
       } catch (e) {
-        // Отказ одного провайдера не должен ронять цепочку — она сама решит,
-        // идти дальше или сдаться.
+        // One provider failure must not abort the chain — the chain decides
+        // whether to continue or give up.
         return { ok: false, provider: label, reason: `${label}: ${String(e && e.message || e)}` }
       }
       return { ok: text.length > 0, provider: label, text, reason: text ? '' : 'empty transcript' }
     }
   }
 
-  // Если звук всё-таки доехал до хоста с 'browser' в цепочке, значит
-  // браузерная нога не сработала: отказываем понятно и идём к следующему.
+  // If audio still reached the host with 'browser' in the chain, the browser
+  // leg failed: fail clearly and move on.
   async function browser() {
     return {
       ok: false,
       provider: 'browser',
-      reason: 'browser: распознавание идёт в браузере, на хосте его нет',
+      reason: 'browser: recognition runs in the page, the host has no browser engine',
     }
   }
 
   const out = { browser, deepgram, groq, hf, 'local-whisper': localWhisper, sensevoice }
 
-  // Заготовки: те же свои провайдеры, только анкета заполнена заранее.
+  // Presets: custom providers with the form pre-filled.
   for (const key of PRESET_KEYS) {
     if (out[key]) continue
     out[key] = customProvider({ ...PRESET_PROVIDERS[key], key })
@@ -366,9 +363,8 @@ export function makeProviders(deps, req) {
 
   for (const spec of Array.isArray(cfg.customProviders) ? cfg.customProviders : []) {
     const key = String(spec && spec.key || '').trim()
-    // Встроенные движки не перекрываем: опечатка в имени тихо подменила бы
-    // рабочего провайдера в чужой цепочке. А заготовку перекрыть можно — она
-    // для того и заготовка, чтобы её правили.
+    // Do not override built-in engines: a typo would silently replace a working
+    // provider in a chain. Presets may be overridden — that is their purpose.
     if (!key || PROVIDER_KEYS.includes(key)) continue
     out[key] = customProvider({ ...spec, key })
   }

package/lib/stats.js

@@ -1,5 +1,5 @@
-// dsh-voice — чистые утилиты метрик провайдеров и объединения контекстного словаря.
-// Без cordis и без сети — тестируются юнит-тестами.
+// dsh-voice — pure helpers for provider metrics and context vocabulary.
+// No cordis and no network — unit-tested.
 
 export function createStatsTracker() {
   const stats = new Map()

package/lib/wav.js

@@ -1,15 +1,15 @@
-// Перегон произвольного аудио в WAV 16 кГц моно.
+// Convert arbitrary audio to 16 kHz mono WAV.
 //
-// Локальный whisper.cpp принимает только WAV: на webm/opus, который пишет
-// браузер, его сервер отвечает "Invalid request". API-провайдеры webm едят
-// как есть, поэтому конвертация нужна ровно для локальной ноги цепочки.
+// Local whisper.cpp accepts WAV only: browser webm/opus gets "Invalid
+// request". Cloud providers accept webm as-is, so conversion is only needed
+// for the local leg of the chain.
 
 import { spawn } from 'node:child_process'
 
 /**
- * @param bytes {Buffer|Uint8Array} исходное аудио в любом контейнере
- * @param ffmpegBin {string} путь к ffmpeg
- * @returns {Promise<Buffer>} WAV 16 кГц моно
+ * @param bytes {Buffer|Uint8Array} source audio in any container
+ * @param ffmpegBin {string} ffmpeg binary path
+ * @returns {Promise<Buffer>} 16 kHz mono WAV
  */
 export function toWav16k(bytes, ffmpegBin = 'ffmpeg') {
   return new Promise((resolve, reject) => {
@@ -33,7 +33,7 @@ export function toWav16k(bytes, ffmpegBin = 'ffmpeg') {
       if (wav.length < 64) { reject(new Error('ffmpeg produced empty output')); return }
       resolve(wav)
     })
-    proc.stdin.on('error', () => { /* ffmpeg закрыл вход раньше — код возврата всё расскажет */ })
+    proc.stdin.on('error', () => { /* ffmpeg closed stdin early — the exit code tells the story */ })
     proc.stdin.end(Buffer.from(bytes))
   })
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-voice",
-  "version": "0.8.17",
+  "version": "0.8.19",
   "description": "Voice input for DeepSeek Harness: dictation chunked by pauses and voice messages, each with its own provider fallback chain (Deepgram, Groq, HuggingFace, local whisper.cpp, plus any OpenAI-compatible API of your own).",
   "license": "MIT",
   "type": "module",
@@ -39,7 +39,9 @@
     "url": "https://github.com/GooDAnDReaDY/dsh-voice/issues"
   },
   "scripts": {
-    "test": "node --test test/*.test.mjs"
+    "test": "node --test test/*.test.mjs",
+    "build:client": "node scripts/build-client.mjs",
+    "pretest": "node scripts/build-client.mjs"
   },
   "dsh": {
     "bundle": {