@goodandready/dsh-voice 0.8.18 → 0.8.19

package/lib/index.js

@@ -1,16 +1,16 @@
-// dsh-voice — хост-половина.
+// dsh-voice — host half.
 //
-// Два режима ввода голосом, у каждого своя цепочка провайдеров:
-//   dictation — браузер режет речь по паузам и шлёт куски, текст дописывается
-//               в строку ввода;
-//   message   — одна запись целиком, текст уходит агенту после окна отмены.
+// Two voice input modes, each with its own provider fallback chain:
+//   dictation — the browser cuts speech on pauses and posts chunks; text is
+//               appended to the composer;
+//   message   — one whole recording; text is sent after the cancel window.
 //
-// Роуты:
+// Routes:
 //   POST /dsh-voice/transcribe  {dataBase64, mimeType, mode} -> {ok, text, provider, tookMs}
 //   GET  /dsh-voice/status      -> {ok, whisperRunning, modes}
 //
-// Ключи провайдеров читаются на хосте через ctx.credentials и в браузер не
-// попадают.
+// Provider keys are resolved on the host via ctx.credentials and never reach
+// the browser.
 
 import z from '@deepseek-ai/schemastery'
 import { defineTool } from '@deepseek-ai/dsh-tools'
@@ -42,7 +42,7 @@ const ChainEntry = z.object({
     .description('Model override. Empty means the provider default.'),
 })
 
-// Свой провайдер: всё, что нужно, чтобы сходить в чужой OpenAI-совместимый API.
+// Custom provider: everything needed to call any OpenAI-compatible API.
 const CustomProvider = z.object({
   key: z.string().default('')
     .description('Name used in the chains above. Must differ from the built-in keys.'),
@@ -168,7 +168,7 @@ function writeJson(res, code, body) {
   try {
     res.writeHead(code, { 'Content-Type': 'application/json', 'Cache-Control': 'no-store' })
     res.end(JSON.stringify(body))
-  } catch { /* сокет мог закрыться */ }
+  } catch { /* socket may already be closed */ }
 }
 
 function readBody(req, maxBytes) {
@@ -188,11 +188,10 @@ function readBody(req, maxBytes) {
 export function apply(ctx, baseConfig) {
   let child = null
 
-  // Карточка настроек правит namespace с именем плагина. Пока хост его не
-  // объявил через settings.register, снимок приходит пустым и нередактируемым:
-  // поля серые, цепочки пустые, сохранять некуда. Чтение через live() заодно
-  // означает, что правка применяется к следующему запросу, а не после
-  // перезапуска процесса.
+  // The settings card edits a namespace named after the plugin. Until the
+  // host registers it via settings.register the snapshot is empty and
+  // read-only. Reading through live() means edits apply to the next request
+  // instead of requiring a process restart.
   let getConfig = () => baseConfig
   const live = () => Config(structuredClone(getConfig() ?? {})) ?? baseConfig
 
@@ -206,7 +205,7 @@ export function apply(ctx, baseConfig) {
     try {
       const resolved = await ctx.credentials.resolve(credentialRef(ref))
       if (resolved && resolved.value) return resolved.value
-    } catch { /* падаем в окружение */ }
+    } catch { /* fall through to environment */ }
     return process.env[ref] || ''
   }
 
@@ -223,8 +222,8 @@ export function apply(ctx, baseConfig) {
   async function startWhisper() {
     const cfg = live()
     if (!cfg.autoStart) return false
-    // Без пути к модели запускать нечего: пакет не знает, где она лежит у
-    // конкретного пользователя, и молча стартовать чужой бинарь не должен.
+    // Without a model path there is nothing to start: the package cannot know
+    // where a user's model lives and must not launch a random binary.
     if (!cfg.whisperModel) return false
     if (await whisperAlive()) return true
     try {
@@ -245,7 +244,7 @@ export function apply(ctx, baseConfig) {
 
   startWhisper().catch(() => {})
 
-  // SenseVoice-ONNX / Sherpa-ONNX: автозапуск и проверка здоровья.
+  // SenseVoice-ONNX / Sherpa-ONNX: autostart and health check.
   let sensevoiceChild = null
 
   async function sensevoiceAlive() {
@@ -257,7 +256,7 @@ export function apply(ctx, baseConfig) {
       const t = setTimeout(() => controller.abort(), 2000)
       const res = await fetch(base + '/', { signal: controller.signal })
       clearTimeout(t)
-      return res.ok || res.status === 404 // sherpa-onnx отвечает 404 на /, но живой
+      return res.ok || res.status === 404 // sherpa-onnx answers 404 on / but is alive
     } catch { return false }
   }
 
@@ -286,15 +285,15 @@ export function apply(ctx, baseConfig) {
 
   startSensevoice().catch(() => {})
 
-  // Статистика здоровья и задержек провайдеров (Latency & Health Dashboard).
+  // Provider health and latency stats (Latency & Health Dashboard).
   const statsTracker = createStatsTracker()
 
-  // Общий путь распознавания: собрать провайдеров по цепочке режима и пройти её.
+  // Shared recognition path: build providers from the mode chain and run it.
   async function transcribe(modeCfg, bytes, mime, signal, contextWords) {
     const cfg = live()
     const customKeys = (Array.isArray(cfg.customProviders) ? cfg.customProviders : [])
       .map((c) => String(c && c.key || '').trim()).filter(Boolean)
-    // Режим «только локальный whisper»: цепочка обрезается до него.
+    // localOnly mode: restrict the chain to local-whisper.
     const chain = cfg.localOnly
       ? (modeCfg.chain || []).filter((e) => e.provider === 'local-whisper')
       : (modeCfg.chain || [])
@@ -303,8 +302,8 @@ export function apply(ctx, baseConfig) {
     for (const entry of chain) {
       if (!KNOWN_KEYS.includes(entry.provider) && !customKeys.includes(entry.provider)) continue
       order.push(entry.provider)
-      // Для своего провайдера модель по умолчанию живёт в его описании,
-      // подставит makeProviders — здесь пусто означает «бери оттуда».
+      // Custom provider default models live in their spec; makeProviders fills
+      // them in — empty here means "use the provider default".
       models[entry.provider] = entry.model || DEFAULT_MODELS[entry.provider] || ''
     }
     if (cfg.localOnly && order.length === 0) {
@@ -322,8 +321,8 @@ export function apply(ctx, baseConfig) {
     return runChain(order, providers, statsTracker.record)
   }
 
-  // Полировка транскрипта (#35) с поддержкой локального LLM (#47).
-  // Ошибка/таймаут не блокирует: возвращаем сырой текст.
+  // Transcript polish (#35) with local LLM support (#47).
+  // Errors/timeouts do not block: return the raw text.
   async function polishText(text, modeCfg, signal) {
     const enable = modeCfg && (modeCfg.polish === true || modeCfg.polishSend === true)
     if (!enable || !text) return text
@@ -334,7 +333,7 @@ export function apply(ctx, baseConfig) {
       + '"ээ", "ну", "как бы"). Keep the original language, wording and meaning. '
       + 'Reply with the polished text only:\n\n' + text
     try {
-      // Локальный OpenAI-совместимый эндпоинт (#47), когда задан.
+      // Local OpenAI-compatible endpoint (#47) when configured.
       if (cfg.polishBaseUrl) {
         const headers = { 'content-type': 'application/json' }
         if (cfg.polishKeyEnv) {
@@ -353,11 +352,11 @@ export function apply(ctx, baseConfig) {
           && data.choices[0].message.content
         return (pick && String(pick).trim()) || text
       }
-      // Штатная модель харнесса (DSH 0.1.2-alpha.1 API).
+      // Harness model (DSH 0.1.2-alpha.1 API).
       const llm = ctx.llm
       if (!llm || typeof llm.stream !== 'function') return text
-      // provider/model обязательны в GenerateOptions; берём дефолт из
-      // agentDefaultModel, если не заданы явно.
+      // provider/model are required in GenerateOptions; fall back to
+      // agentDefaultModel when not set explicitly.
       const sel = (ctx.get && ctx.get('agentDefaultModel') && ctx.get('agentDefaultModel').currentSelection)
         ? ctx.get('agentDefaultModel').currentSelection()
         : null
@@ -377,8 +376,8 @@ export function apply(ctx, baseConfig) {
     } catch { return text }
   }
 
-  // Чистые голосовые команды сессии (#48). Возвращает название команды или null.
-  // Распознаются на сервере, чтобы не попадать в текст композера.
+  // Clean session voice commands (#48). Returns the command name or null.
+  // Matched on the host so they never enter the composer text.
   const SESSION_COMMANDS = [
     { re: /^(отправь|отправить|пошли|send)\s*[.!?]*$/i, cmd: 'send' },
     { re: /^(отмени|отмена|cancel|отменить)\s*[.!?]*$/i, cmd: 'cancel' },
@@ -403,7 +402,7 @@ export function apply(ctx, baseConfig) {
       writeJson(res, 200, {
         ok: true,
         whisperRunning: await whisperAlive(),
-        // Клавиша нужна браузерной половине: она вешает обработчик удержания.
+        // The hotkey is needed by the browser half: it installs the hold handler.
         hotkey: cfg.hotkey,
         providers: KNOWN_KEYS.concat(
           (Array.isArray(cfg.customProviders) ? cfg.customProviders : [])
@@ -451,7 +450,7 @@ export function apply(ctx, baseConfig) {
       let raw
       try { raw = await readBody(req, cfg.maxFileBytes + 1024 * 1024) } catch (e) { writeJson(res, 400, { ok: false, error: { code: 'body', message: e.message } }); return }
       let payload = {}
-      try { payload = JSON.parse(raw.toString('utf8') || '{}') } catch { /* пусто */ }
+      try { payload = JSON.parse(raw.toString('utf8') || '{}') } catch { /* empty */ }
       const text = typeof payload.text === 'string' ? payload.text.trim() : ''
       if (!text) { writeJson(res, 400, { ok: false, error: { code: 'empty', message: 'text required' } }); return }
       const controller = new AbortController()
@@ -494,12 +493,12 @@ export function apply(ctx, baseConfig) {
         writeJson(res, 413, { ok: false, error: { code: 'too-large', message: `audio is ${bytes.length} bytes, max ${cfg.maxFileBytes}` } }); return
       }
 
-      // Локальный whisper в цепочке — поднимаем сервер заранее, иначе первый
-      // же чанк уйдёт в отказ, пока сервер стартует.
+      // Local whisper in the chain — start the server up front, otherwise the
+      // first chunk fails while the server is still booting.
       if ((modeCfg.chain || []).some((e) => e.provider === 'local-whisper') && !(await whisperAlive())) {
         await startWhisper()
       }
-      // Аналогично для SenseVoice-ONNX / Sherpa-ONNX.
+      // Same for SenseVoice-ONNX / Sherpa-ONNX.
       if ((modeCfg.chain || []).some((e) => e.provider === 'sensevoice') && !(await sensevoiceAlive())) {
         await startSensevoice()
       }
@@ -508,8 +507,8 @@ export function apply(ctx, baseConfig) {
       const timer = setTimeout(() => controller.abort(), cfg.timeoutMs)
       try {
         const out = await transcribe(modeCfg, bytes, mime, controller.signal, payload.contextWords)
-        // Голосовые команды сессии (#48): чистые «отправь/отмени/стоп/продолжи»
-        // не становятся текстом, а возвращаются командой для браузера.
+        // Session voice commands (#48): clean "send/cancel/stop/continue"
+        // become a command for the browser instead of composer text.
         if (payload.mode === 'message' && modeCfg.sessionCommands === true) {
           const cmd = sessionCommand(out.text)
           if (cmd) { writeJson(res, 200, { ok: true, command: cmd, provider: out.provider, tookMs: out.tookMs }); return }
@@ -578,7 +577,7 @@ export function apply(ctx, baseConfig) {
   )
 
   ctx.effect(() => () => {
-    if (child) { try { child.kill && child.kill() } catch { /* уже мёртв */ } }
-    if (sensevoiceChild) { try { sensevoiceChild.kill && sensevoiceChild.kill() } catch { /* уже мёртв */ } }
+    if (child) { try { child.kill && child.kill() } catch { /* already dead */ } }
+    if (sensevoiceChild) { try { sensevoiceChild.kill && sensevoiceChild.kill() } catch { /* already dead */ } }
   }, 'dsh-voice: stop child processes')
 }

package/lib/normalize.js

@@ -1,5 +1,5 @@
-// Постобработка распознанного текста перед вставкой в композер.
-// Без сети и без cordis — чистые функции, чтобы поведение проверить юнитами.
+// Transcript post-processing before inserting into the composer.
+// No network and no cordis — pure functions for unit tests.
 
 export function capitalizeSentences(text) {
   return text.replace(/(^|[.!?\n]\s+)([a-zа-яё])/gi, (m, lead, ch) => lead + ch.toUpperCase())

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.18",
+  "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": {