@goodandready/dsh-tts 0.3.22 → 0.4.0

package/lib/client.js

@@ -5,9 +5,8 @@ window.__ModuleLoader__.load({
     var exports = module.exports
     const React = require('react')
 
-    // Значок раскрытия — ядровый; свой SVG только как фолбэк для сборок
-    // без набора примитивов. Иконка всегда смотрит вниз, раскрытие
-    // поворачивает её классом.
+    // Chevron comes from core UI primitives; local SVG is a fallback for
+    // builds without the package. Icon always points down; open state rotates.
     let ChevronIcon = null
     try {
       const primitives = require('@deepseek-ai/dsh-client-ui-primitives')
@@ -23,25 +22,27 @@ window.__ModuleLoader__.load({
     const CLOUD = {
       openai: 1, elevenlabs: 1, google: 1, azure: 1, groq: 1, deepgram: 1, openrouter: 1, custom: 1,
     }
+    // Hints stay generic: concrete provider model IDs rot quickly.
     const MODEL_HINT = {
-      openai: 'gpt-4o-mini-tts',
-      elevenlabs: 'eleven_multilingual_v2',
-      google: 'gemini-2.5-flash-preview-tts',
-      azure: 'region voice, e.g. en-US-JennyNeural',
-      groq: 'playai-tts',
-      deepgram: 'aura-asteria-en (no Russian)',
-      openrouter: 'openai/gpt-4o-mini-tts-2025-12-15',
-      edge: 'ru-RU-SvetlanaNeural',
+      openai: 'provider default',
+      elevenlabs: 'provider default',
+      google: 'provider default',
+      azure: 'region voice name',
+      groq: 'provider default',
+      deepgram: 'provider default (English-only voices)',
+      openrouter: 'provider/model id',
+      edge: 'BCP-47 voice, e.g. ru-RU-SvetlanaNeural',
       piper: 'path to .onnx',
-      espeak: 'ru',
+      espeak: 'language code, e.g. ru',
+      kokoro: 'not bundled — offline neural runtime unavailable',
+      f5: 'not bundled — offline neural runtime unavailable',
     }
 
     const SET_CSS =
       '.dts-wrap{display:flex;flex-direction:column;gap:22px;padding:4px 0;max-width:720px}' +
       '.dts-block{display:flex;flex-direction:column;gap:10px}' +
       '.dts-h{font-size:14px;font-weight:600;color:var(--dsw-alias-label-primary)}' +
-      // Единый вид карточки «Настройки плагинов»: значения из канона
-      // (issue #19), цвета только переменными темы.
+      // Plugin-settings card matches the core card pattern; theme variables only.
       '.dts-card{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:12px;list-style:none}' +
       '.dts-head{appearance:none;width:100%;font:inherit;color:inherit;text-align:left;cursor:pointer;background:0 0;border:0;border-radius:12px;display:flex;align-items:center;gap:12px;padding:14px 16px}' +
       '.dts-headText{flex-direction:column;flex:1;gap:4px;min-width:0;display:flex}' +
@@ -54,7 +55,7 @@ window.__ModuleLoader__.load({
       '.dts-input{height:34px;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);color:var(--dsw-alias-label-primary);border-radius:8px;padding:0 12px;font-size:13px}' +
       '.dts-foot{border-top:1px solid var(--dsw-alias-border-l2);display:flex;justify-content:flex-end;align-items:center;gap:8px;padding:12px 0 4px}' +
       '.dts-save{appearance:none;font:inherit;cursor:pointer;border:1px solid transparent;border-radius:8px;padding:5px 14px;font-size:13px;background:var(--dsw-alias-label-primary);color:var(--dsw-alias-bg-layer-3)}' +
-      // Помощники внутренней формы (цепочка провайдеров).
+      // Provider-chain form helpers.
       '.dts-entry{display:flex;flex-direction:column;gap:8px;padding:10px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px}' +
       '.dts-row{display:flex;gap:8px;align-items:center;flex-wrap:wrap}' +
       '.dts-row .dts-model{flex:1;min-width:120px}' +
@@ -67,20 +68,19 @@ window.__ModuleLoader__.load({
       '.dts-link{background:none;border:none;color:var(--dsw-alias-label-secondary);cursor:pointer;font-size:12px;padding:0}'
 
     const setCssId = 'dsh-tts/settings.module.css'
-    if (typeof document !== 'undefined' && !document.querySelector('style[data-plugin-css="' + setCssId + '"]')) {
+    if (typeof document !== 'undefined' && !document.querySelector('style[data-dsh-plugin="dsh-tts"]')) {
       const tag = document.createElement('style')
       tag.textContent = SET_CSS
-      tag.setAttribute('data-plugin', 'dsh-tts')
+      tag.setAttribute('data-dsh-plugin', 'dsh-tts')
       tag.dataset.pluginCss = setCssId
       document.head.appendChild(tag)
     }
 
-    // Проигрыватель.
+    // Player.
     //
-    // Раньше каждый пришедший кусок немедленно вытеснял предыдущий: при чтении
-    // ответа целиком это было незаметно, а при чтении по ходу слышался бы
-    // только последний. Теперь это очередь: следующее начинается, когда
-    // закончилось предыдущее.
+    // Each incoming chunk used to replace the previous one immediately; while reading
+    // For full replies this was invisible; with speak-as-it-goes only the last
+    // chunk would be heard. Now items queue: the next starts after the previous ends.
     const player = {
       audio: null,
       after: '',
@@ -111,8 +111,7 @@ window.__ModuleLoader__.load({
       return player
     }
 
-    // Короткий сигнал рисуем сами: файл не нужен, значит нечего качать,
-    // хранить и настраивать.
+    // Short chime is synthesized in-browser: no file to download, store, or configure.
     function playChime(kind) {
       return new Promise((resolve) => {
         try {
@@ -139,8 +138,8 @@ window.__ModuleLoader__.load({
       })
     }
 
-    // Провайдер не смог — читаем голосом браузера. Хуже по звучанию, но
-    // молчание хуже вдвойне: человек не узнает, что ответ готов.
+    // Provider failed — fall back to the browser voice. Worse quality, but silence
+    // is worse: the user would not know the reply is ready.
     function speakInBrowser(text) {
       return new Promise((resolve) => {
         try {
@@ -154,24 +153,47 @@ window.__ModuleLoader__.load({
       })
     }
 
+    function prepareAudioItem(item) {
+      if (!item || !item.audioBase64 || item.prepared) return item
+      try {
+        const bin = atob(item.audioBase64)
+        const bytes = new Uint8Array(bin.length)
+        for (let i = 0; i < bin.length; i++) bytes[i] = bin.charCodeAt(i)
+        const blob = new Blob([bytes], { type: item.mime || 'audio/mpeg' })
+        const url = URL.createObjectURL(blob)
+        const audio = new Audio(url)
+        audio.preload = 'auto'
+        item.prepared = { audio, url }
+      } catch (err) { /* decode error */ }
+      return item
+    }
+
+    function prebufferNext() {
+      for (const next of player.queue) {
+        if (next && next.audioBase64 && !next.prepared) {
+          prepareAudioItem(next)
+          break
+        }
+      }
+    }
+
     function playAudio(item) {
       return new Promise((resolve) => {
         try {
-          const bin = atob(item.audioBase64)
-          const bytes = new Uint8Array(bin.length)
-          for (let i = 0; i < bin.length; i++) bytes[i] = bin.charCodeAt(i)
-          const blob = new Blob([bytes], { type: item.mime || 'audio/mpeg' })
-          const url = URL.createObjectURL(blob)
-          const audio = new Audio(url)
+          prepareAudioItem(item)
+          if (!item.prepared) return resolve()
+          const { audio, url } = item.prepared
           audio.playbackRate = Math.max(0.5, Math.min(2, player.rate || 1))
           player.audio = audio
           playerChanged()
+          prebufferNext()
           let doneCalled = false
           const done = () => {
             if (doneCalled) return
             doneCalled = true
             currentAudioResolve = null
-            URL.revokeObjectURL(url)
+            try { URL.revokeObjectURL(url) } catch (_) {}
+            item.prepared = null
             player.audio = null
             playerChanged()
             resolve()
@@ -180,8 +202,7 @@ window.__ModuleLoader__.load({
           audio.onended = done
           audio.onerror = done
           audio.play().catch(() => {
-            // Браузер не даёт играть без действия человека — не считаем это
-            // поломкой, просто ничего не звучит.
+    // Autoplay without a user gesture is blocked — not a bug; just no sound.
             done()
           })
         } catch (cannotDecode) {
@@ -211,6 +232,12 @@ window.__ModuleLoader__.load({
     }
 
     function stopPlayback() {
+      for (const item of player.queue) {
+        if (item && item.prepared && item.prepared.url) {
+          try { URL.revokeObjectURL(item.prepared.url) } catch (_) {}
+          item.prepared = null
+        }
+      }
       player.queue.length = 0
       player.paused = false
       if (currentAudioResolve) {
@@ -243,11 +270,10 @@ window.__ModuleLoader__.load({
       }
     }
 
-    // Человек заговорил — замолкаем.
+    // User started talking — stop playback.
     //
-    // Событие приходит из плагина голосового ввода, но никакой связи с ним
-    // нет: если его не установили, событие просто никогда не придёт. Слушаем
-    // окно, а не чужую службу, ровно поэтому.
+    // The event may come from a voice-input plugin, but there is no hard dependency:
+    // without that plugin the event simply never fires. We listen on window on purpose.
     function listenForVoice() {
       if (typeof window === 'undefined') return () => {}
       const onSpeaking = (event) => {
@@ -277,8 +303,8 @@ window.__ModuleLoader__.load({
         const data = await res.json()
         const items = data && Array.isArray(data.items) ? data.items : []
         for (const item of items) {
-          // Место в очереди занято, но синтез ещё идёт — подождём следующего
-          // опроса, иначе порядок фраз рассыплется.
+    // Queue slot reserved but synthesis still running — wait for the next poll
+    // or phrase order would break.
           if (item.kind === 'reserved') break
           player.after = item.id
           if (seenIds.has(item.id)) continue
@@ -294,7 +320,7 @@ window.__ModuleLoader__.load({
       } catch (hostRestarting) { /* хост перезапускается */ }
     }
 
-    // Недавние озвучки: тексты последних реплик и избранное (localStorage).
+    // Recent utterances: last reply texts and favorites (localStorage).
     function recentStore() {
       const KEY = 'dsh-tts/recent'
       let st
@@ -320,7 +346,7 @@ window.__ModuleLoader__.load({
     }
     const recent = recentStore()
 
-    // Разовое проигрывание вне очереди: реплай из списка недавних.
+    // One-shot playback outside the queue: replay from recents.
     function playStandalone(text) {
       fetch('/dsh-tts/speak', {
         method: 'POST',
@@ -341,7 +367,7 @@ window.__ModuleLoader__.load({
     }
 
     function ChainEditor(props) {
-      // Переводчик приходит от карточки: слот отдаёт props.t только ей.
+      // Translator comes from the card: the slot passes props.t only to it.
       const t = props.t || ((key) => key)
       const rows = Array.isArray(props.value) ? props.value : []
       const change = (i, patch) => {
@@ -408,9 +434,8 @@ window.__ModuleLoader__.load({
       )
     }
 
-    // Строки карточки живут в реестре локалей: так их переводит отдельный
-    // пакет, не трогая код этого плагина. Английский — язык по умолчанию,
-    // на него же приходится откат, если перевода нет.
+    // Card strings live in the locale registry so a separate package can translate
+    // them without touching this plugin. English is the source language and fallback.
     const en = {
       'general': 'General',
       'loading': 'Loading\u2026',
@@ -644,7 +669,7 @@ window.__ModuleLoader__.load({
       'removeRegex': 'Регулярка вырезания',
       'removeRegexHint': 'Глобальная регулярка: совпадения удаляются перед синтезом.',
       'customBaseUrl': 'Свой TTS endpoint',
-      'customBaseUrlHint': 'OpenAI-совместимый адрес, например http://localhost:8880/v1; пусто = выключен.',
+      'customBaseUrlHint': 'OpenAI-compatible base URL, e.g. http://localhost:8880/v1; empty disables it.',
       'customKeyEnv': 'Имя ключа для endpoint',
       'customKeyEnvHint': 'Имя credential для Bearer-ключа своего endpointа.',
 
@@ -775,7 +800,7 @@ window.__ModuleLoader__.load({
     }
 
     function TtsSection(props) {
-      // Переводчик приходит от слота, потому что в его записи указан locale.
+      // Translator comes from the slot because its registration sets locale.
       const t = (props && props.t) || ((key) => key)
       const [draft, setDraft] = React.useState(null)
       const [credentials, setCredentials] = React.useState({})
@@ -801,12 +826,12 @@ window.__ModuleLoader__.load({
         return () => { alive = false }
       }, [scope])
 
-      // Статус снимка настроек важнее самого значения:
-      //   loading      — ответа хоста ещё нет;
-      //   unavailable  — хост ответил, но пространство настроек пока не готово;
-      //   ready        — значения на месте.
-      // При unavailable поле writable берётся из документа и остаётся true,
-      // поэтому без проверки статуса карточка рисует пустую, но с виду рабочую форму.
+    // Snapshot status matters more than the value:
+    //   loading     — host has not answered yet;
+    //   unavailable — host answered but the settings namespace is not ready;
+    //   ready       — values are present.
+    // On unavailable, writable defaults true; without a status check the card
+    // looks like a working empty form.
       const ready = !scope || (!!snap && snap.status === 'ready')
       const writable = !scope ? true : (ready && snap.writable !== false)
 
@@ -946,7 +971,7 @@ window.__ModuleLoader__.load({
         }),
         React.createElement('span', { className: 'dts-sub' }, hint))
 
-      // В карточке заголовок рисует шапка — свой блок не дублируем.
+      // The card header draws the title — do not duplicate a second title block.
       const titleLine = props && props.compact ? null : React.createElement('div', { className: 'dts-h' }, t('title'))
       return React.createElement('div', { className: 'dts-wrap' },
         React.createElement('div', { className: 'dts-block' },
@@ -1096,7 +1121,7 @@ window.__ModuleLoader__.load({
       { from: 'RAM', to: 'рам', whole: true, lang: 'ru' },
     ]
 
-    // Редактор словаря произношения: таблица правил сверху вниз.
+    // Pronunciation dictionary editor: rules apply top-down.
     function PronEditor(props) {
       const t = props.t || ((key) => key)
       const rows = Array.isArray(props.value) ? props.value : []
@@ -1229,7 +1254,7 @@ window.__ModuleLoader__.load({
           style: {
             padding: '10px 14px',
             borderRadius: '8px',
-            border: '1px solid var(--dsw-alias-state-warning-primary, #eab308)',
+            border: '1px solid var(--dsw-alias-state-warning-primary)',
             background: 'var(--dsw-alias-bg-layer-2)',
             display: 'flex',
             flexDirection: 'column',
@@ -1237,7 +1262,7 @@ window.__ModuleLoader__.load({
             fontSize: '13px',
           },
         },
-          React.createElement('span', { style: { fontWeight: 600, color: 'var(--dsw-alias-state-warning-primary, #eab308)' } },
+          React.createElement('span', { style: { fontWeight: 600, color: 'var(--dsw-alias-state-warning-primary)' } },
             '⚠️ ' + t('voiceNotInstalledTitle')
           ),
           React.createElement('span', { className: 'dts-sub' },
@@ -1271,7 +1296,7 @@ window.__ModuleLoader__.load({
           style: {
             padding: '10px 14px',
             borderRadius: '8px',
-            border: '1px solid var(--dsw-alias-state-warning-primary, #eab308)',
+            border: '1px solid var(--dsw-alias-state-warning-primary)',
             background: 'var(--dsw-alias-bg-layer-2)',
             display: 'flex',
             flexDirection: 'column',
@@ -1279,7 +1304,7 @@ window.__ModuleLoader__.load({
             fontSize: '13px',
           },
         },
-          React.createElement('span', { style: { fontWeight: 600, color: 'var(--dsw-alias-state-warning-primary, #eab308)' } },
+          React.createElement('span', { style: { fontWeight: 600, color: 'var(--dsw-alias-state-warning-primary)' } },
             '⚠️ ' + t('messengerNotInstalledTitle')
           ),
           React.createElement('span', { className: 'dts-sub' },
@@ -1301,7 +1326,7 @@ window.__ModuleLoader__.load({
       )
     }
 
-    // Панель статистики синтеза: живые счётчики хоста.
+    // Synthesis stats panel: live host counters.
     function StatsPanel(props) {
       const t = props.t || ((key) => key)
       const [data, setData] = React.useState(null)
@@ -1322,9 +1347,8 @@ window.__ModuleLoader__.load({
       )
     }
 
-    // Карточка во вкладке «Настройки плагинов» — разметка и стили по
-    // единому канону (issue #19): li в списке ядра, шапка со сбросом темы,
-    // тело с чертой-разделителем. Шеврон — наш, ядро его не даёт.
+    // Plugin-settings tab card follows the shared card pattern: li in the core list,
+    // theme-reset header, body with a divider. Chevron is ours; core does not provide it.
     function TtsCard(props) {
       const t = (props && props.t) || ((key) => key)
       const [open, setOpen] = React.useState(false)
@@ -1357,12 +1381,10 @@ window.__ModuleLoader__.load({
       )
     }
 
-    // Кнопка в строке ввода: видно, что сейчас читается, можно остановить и
-    // открыть недавние озвучки для реплая.
+    // Input-dock button: shows what is playing, stop control, and recents for replay.
     function SpeakerControl(props) {
-      // Слот с `locale` кладёт перевод в props; запасной путь — привязка,
-      // сделанная при регистрации. Второй нужен на случай, если слот перевод
-      // не донесёт: без него кнопки остались бы без подписей вовсе.
+    // A slot with `locale` injects translations into props; the fallback is the
+    // binder created at registration, in case the slot drops translations.
       const t = (props && props.t) || fallbackDockText
       const p = usePlayer()
       const [showList, setShowList] = React.useState(false)
@@ -1421,8 +1443,8 @@ window.__ModuleLoader__.load({
     let fallbackDockText = (key) => key
 
     function registerSpeaker(ctx) {
-      // `locale` в описании слота — то, чем ядро кладёт перевод в props
-      // компонента. Без него внутри дока не было бы ничего, кроме ключей.
+    // `locale` in the slot descriptor is how core injects translations into props.
+    // Without it the dock would show raw keys only.
       fallbackDockText = ctx.locale.bind(NS)
       ctx.slots.inject('conversation.input.dock', () => ctx.slots.register(
         {
@@ -1437,14 +1459,10 @@ window.__ModuleLoader__.load({
     }
 
     function registerSettings(ctx) {
-      // Язык может принести не только плагин: словарные пакеты объявляют
-      // русский для чужих пространств. Ядро на повторное объявление той же
-      // пары «пространство + язык» бросает исключение, и незащищённый вызов
-      // уносил с собой весь плагин — в интерфейсе это выглядело как «Failed to
-      // load plugins» с перечнем ни в чём не повинных соседей.
-      //
-      // Поэтому каждый язык объявляется отдельно и по-хорошему: заняли до нас —
-      // уступаем, свой английский при этом всё равно встаёт на место.
+    // Dictionary packages may also register languages for other namespaces.
+    // Core throws on duplicate namespace+language; an unguarded call used to
+    // take down the whole plugin ("Failed to load plugins"). Register each
+    // language separately: skip if taken; English still lands.
       const addLocale = (locale, dictionary) => {
         try {
           return ctx.locale.register(NS, locale, dictionary)
@@ -1456,13 +1474,12 @@ window.__ModuleLoader__.load({
         const undo = [addLocale('en', en), addLocale('ru', ru)]
         return () => { for (const off of undo) off() }
       }, 'dsh-tts: словари')
-      // Подпись раздела рисует боковой список, а не наш компонент: props.t
-      // туда не доходит, поэтому берём переводчик, привязанный к namespace.
+    // The sidebar draws the section label, not our component: props.t never
+    // reaches it, so bind the translator to the namespace ourselves.
       const t = ctx.locale.bind(NS)
-      // Штатное место настроек — карточка во вкладке «Настройки плагинов».
-      // Вкладка перебирает пространства настроек и ищет слот по entryKey,
-      // равному имени пространства: ключ обязан равняться NS, иначе карточка
-      // не появится молча, без единой ошибки в журнале.
+    // Primary settings home is the plugin-settings tab card. The tab looks up
+    // a slot by entryKey equal to the namespace name: key must equal NS or
+    // the card never appears, with no log error.
       const tryPluginItem = () => {
         try {
           const res = ctx.slots.inject('settings.plugin.item', () => ctx.slots.register(
@@ -1481,8 +1498,8 @@ window.__ModuleLoader__.load({
         }
       }
       if (tryPluginItem()) return
-      // Запасной путь для сборок без settings.plugin.item: прежний раздел
-      // в боковом списке, чтобы настройки не пропали.
+    // Fallback for builds without settings.plugin.item: keep the sidebar section
+    // so settings cannot disappear.
       ctx.slots.inject('settings.section', () => ctx.slots.register(
         {
           name: 'settings.section',

package/lib/engines/f5.js

@@ -1,5 +1,32 @@
 import { spawn } from 'node:child_process'
 
+function collectPing(pythonBin, daemonPath) {
+  return new Promise((resolve) => {
+    const proc = spawn(pythonBin, [daemonPath, '--ping'])
+    let out = ''
+    let settled = false
+    const done = (ok) => {
+      if (settled) return
+      settled = true
+      resolve(ok)
+    }
+    proc.stdout.on('data', (c) => { out += c })
+    proc.on('error', () => done(false))
+    proc.on('close', (code) => {
+      if (code !== 0) {
+        done(false)
+        return
+      }
+      try {
+        const res = JSON.parse(out)
+        done(!!res.ok)
+      } catch {
+        done(false)
+      }
+    })
+  })
+}
+
 export class F5Engine {
   constructor({ daemonPath = 'scripts/f5_daemon.py', pythonBin = 'python3', modelPath = '' } = {}) {
     this.daemonPath = daemonPath
@@ -7,39 +34,24 @@ export class F5Engine {
     this.modelPath = modelPath
   }
 
+  /** Resolve true only after a successful daemon handshake. */
   async ping() {
-    return new Promise((resolve) => {
-      // Try spawning python with daemonPath --ping
-      const proc = spawn(this.pythonBin, [this.daemonPath, '--ping'])
-      let out = ''
-      proc.stdout.on('data', (c) => { out += c })
-      proc.on('error', () => {
-        // Fallback to 'python' if 'python3' is not found (e.g. on Windows)
-        if (this.pythonBin === 'python3') {
-          const fallback = spawn('python', [this.daemonPath, '--ping'])
-          let fallbackOut = ''
-          fallback.stdout.on('data', (c) => { fallbackOut += c })
-          fallback.on('error', () => resolve(true)) // In test environment without python, return true
-          fallback.on('close', (code) => {
-            try {
-              const res = JSON.parse(fallbackOut)
-              resolve(!!res.ok)
-            } catch {
-              resolve(code === 0)
-            }
-          })
-          return
-        }
-        resolve(true)
-      })
-      proc.on('close', (code) => {
-        try {
-          const res = JSON.parse(out)
-          resolve(!!res.ok)
-        } catch {
-          resolve(code === 0)
-        }
-      })
-    })
+    const primary = await collectPing(this.pythonBin, this.daemonPath)
+    if (primary) return true
+    if (this.pythonBin === 'python3') {
+      return collectPing('python', this.daemonPath)
+    }
+    return false
+  }
+
+  isRuntimeAvailable() {
+    return false
+  }
+
+  async synthesize() {
+    throw new Error(
+      'F5-TTS runtime is not bundled in @goodandready/dsh-tts. ' +
+      'Use Edge, Piper, or eSpeak for offline TTS.',
+    )
   }
 }

package/lib/engines/kokoro.js

@@ -1,5 +1,13 @@
 import fs from 'node:fs'
 
+/**
+ * Local Kokoro engine wrapper.
+ *
+ * Real ONNX inference is intentionally not bundled in this package: shipping
+ * onnxruntime + voice tensors would blow the DSH Store size budget and couple
+ * the plugin to native binaries. Until a supported external runtime is wired,
+ * synthesis must fail honestly — never emit a synthetic tone.
+ */
 export class KokoroEngine {
   constructor({ modelPath = '' } = {}) {
     this.modelPath = modelPath
@@ -10,39 +18,23 @@ export class KokoroEngine {
     return !!(this.modelPath && fs.existsSync(this.modelPath))
   }
 
-  /**
-   * Synthesizes audio stream yielding Float32Array PCM chunks (24kHz).
-   * @param {string} text
-   * @param {string} voice
-   * @returns {AsyncGenerator<Float32Array>}
-   */
-  async *synthesize(text, voice = 'af_bella') {
-    if (!text || !text.trim()) return
+  /** True only when a real inference backend can produce speech. */
+  isRuntimeAvailable() {
+    return false
+  }
 
-    // Generates 1s chunk of PCM frames (24000 samples for test/stub)
-    const samples = Math.max(2400, Math.min(24000, text.length * 800))
-    const chunk = new Float32Array(samples)
-    for (let i = 0; i < samples; i++) {
-      // Soft synthetic sine wave envelope so it does not pop
-      chunk[i] = Math.sin((i * 440 * 2 * Math.PI) / this.sampleRate) * 0.2 * (1 - i / samples)
-    }
-    yield chunk
+  async *synthesize() {
+    throw new Error(
+      'Kokoro ONNX runtime is not bundled in @goodandready/dsh-tts. ' +
+      'Install weights does not enable speech. Use Edge, Piper, or eSpeak for offline TTS.',
+    )
   }
 
-  async synthesizeWav(text, voice = 'af_bella') {
-    const chunks = []
-    for await (const chunk of this.synthesize(text, voice)) {
-      chunks.push(chunk)
-    }
-    let totalLen = 0
-    for (const c of chunks) totalLen += c.length
-    const merged = new Float32Array(totalLen)
-    let offset = 0
-    for (const c of chunks) {
-      merged.set(c, offset)
-      offset += c.length
+  async synthesizeWav() {
+    for await (const _ of this.synthesize()) {
+      // unreachable: synthesize always throws
     }
-    return pcmFloat32ToWav(merged, this.sampleRate)
+    throw new Error('Kokoro synthesis unavailable')
   }
 }