@goodandready/dsh-tts 0.4.0 → 0.4.2

package/README.md

@@ -187,6 +187,16 @@ dsh-tts:
 
 ---
 
+### Settings UI coverage
+
+The plugin settings card (**Settings → Plugins → Plugin settings**) exposes every user-facing schema field, including an **Advanced** block for `maxChars`, `sentenceChars`, `timeoutMs`, `maxQueue`, `openaiBaseUrl`, `mimoBaseUrl`, `mimoFormat`, and `minimaxBin`.
+
+Provider **API keys are never stored in plugin settings**. Paste them in the chain editor; values go to the DSH credential store via `PUT /dsh-tts/credential`.
+
+Config-only (not in the card): `*KeyEnv` fields (`openaiKeyEnv`, `elevenlabsKeyEnv`, …). They only rename the credential slot the plugin looks up. Change them in `settings.yaml` if you must rebind a key name; the defaults match the usual environment variable names.
+
+The sidebar `settings.section` entry is a **fallback** and is registered only when `settings.plugin.item` is missing from the build.
+
 ## 🤖 HTTP Endpoints Reference
 
 * `GET /dsh-tts/stream` — Real-time Server-Sent Events (SSE) audio streaming.

package/README.ru.md

@@ -180,6 +180,16 @@ dsh-tts:
 
 ---
 
+### Покрытие настроек в UI
+
+Карточка плагина (**Настройки → Плагины → Настройки плагинов**) показывает все пользовательские поля схемы, включая блок **Дополнительно**: `maxChars`, `sentenceChars`, `timeoutMs`, `maxQueue`, `openaiBaseUrl`, `mimoBaseUrl`, `mimoFormat`, `minimaxBin`.
+
+**API-ключи не хранятся в настройках плагина.** Вставляйте их в редакторе цепочки — значение уходит в credential store DSH через `PUT /dsh-tts/credential`.
+
+Только в конфиге (нет в карточке): поля `*KeyEnv` (`openaiKeyEnv`, `elevenlabsKeyEnv`, …). Они задают **имя** credential-слота; по умолчанию совпадают с привычными именами env-переменных. Меняйте в `settings.yaml`, если нужно перевязать имя ключа.
+
+Пункт `settings.section` в боковом меню — **fallback** и регистрируется, только если в сборке нет `settings.plugin.item`.
+
 ## 🤖 HTTP роуты API
 
 * `GET /dsh-tts/stream` — Потоковая передача аудио по SSE в реальном времени.

package/README.zh.md

@@ -139,6 +139,14 @@ dsh plugin --profile web add @goodandready/dsh-tts
 
 ---
 
+### 设置界面覆盖
+
+插件设置卡片（**设置 → 插件 → 插件设置**）展示全部用户向 schema 字段，并含 **Advanced** 区：`maxChars`、`sentenceChars`、`timeoutMs`、`maxQueue`、`openaiBaseUrl`、`mimoBaseUrl`、`mimoFormat`、`minimaxBin`。
+
+API 密钥不写入插件设置，只在链编辑器粘贴，经 `PUT /dsh-tts/credential` 写入 DSH credential store。
+
+仅配置文件：`*KeyEnv` 字段（凭证槽位名称）。侧边栏 `settings.section` 仅为 fallback。
+
 ## ⚙️ 配置示例（`settings.yaml`）
 
 ```yaml

package/lib/breaker.js

@@ -0,0 +1,64 @@
+// Soft circuit breaker for provider fallback (runtime state only).
+// Tracks consecutive failures per chain id and skips a provider during cooldown.
+
+const DEFAULT_THRESHOLD = 3
+const DEFAULT_COOLDOWN_MS = 60000
+
+export function createProviderBreaker(options = {}) {
+  const threshold = options.threshold || DEFAULT_THRESHOLD
+  const cooldownMs = options.cooldownMs || DEFAULT_COOLDOWN_MS
+  const now = options.now || (() => Date.now())
+  const state = new Map()
+
+  function slot(id) {
+    let s = state.get(id)
+    if (!s) {
+      s = { failCount: 0, okCount: 0, lastError: '', lastFailAt: 0, openUntil: 0 }
+      state.set(id, s)
+    }
+    return s
+  }
+
+  function isOpen(id) {
+    const s = slot(id)
+    return s.openUntil > now()
+  }
+
+  function recordFailure(id, error) {
+    const s = slot(id)
+    s.failCount += 1
+    s.lastError = String((error && error.message) || error || 'failure').slice(0, 240)
+    s.lastFailAt = now()
+    if (s.failCount >= threshold) {
+      s.openUntil = now() + cooldownMs
+    }
+  }
+
+  function recordSuccess(id) {
+    const s = slot(id)
+    s.okCount += 1
+    s.failCount = 0
+    s.openUntil = 0
+  }
+
+  function snapshot(ids) {
+    const list = Array.isArray(ids) ? ids : [...state.keys()]
+    return list.map((id) => {
+      const s = slot(id)
+      return {
+        id,
+        failCount: s.failCount,
+        okCount: s.okCount,
+        lastError: s.lastError,
+        open: isOpen(id),
+        openUntil: s.openUntil || 0,
+      }
+    })
+  }
+
+  function reset() {
+    state.clear()
+  }
+
+  return { isOpen, recordFailure, recordSuccess, snapshot, reset, threshold, cooldownMs }
+}

package/lib/cache.js

@@ -35,7 +35,7 @@ export function createSpeechCache({ root, maxBytes }) {
       try {
         const meta = JSON.parse(await fs.promises.readFile(path.join(dir, name.slice(0, -AUDIO_EXT.length) + '.json'), 'utf8'))
         if (meta && typeof meta.at === 'number') at = meta.at
-      } catch (noMeta) { /* старьё без меты — вытесним первым */ }
+      } catch (noMeta) { /* legacy entry without meta — evict as first */ }
       out.push({ full, meta: name.slice(0, -AUDIO_EXT.length) + '.json', size: st.size, at })
     }
     return out

package/lib/client-src/00-open.js

@@ -0,0 +1,85 @@
+window.__ModuleLoader__.load({
+  id: '@goodandready/dsh-tts',
+  factory: (require) => {
+    var module = { exports: {} }
+    var exports = module.exports
+    const React = require('react')
+
+    // 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')
+      ChevronIcon = primitives && primitives.IconChevronDownOutline14
+    } catch (noPrimitives) {
+      ChevronIcon = null
+    }
+    const NS = 'dsh-tts'
+    const PROVIDERS = [
+      'openai', 'elevenlabs', 'google', 'azure', 'groq', 'deepgram', 'openrouter',
+      'edge', 'piper', 'espeak',
+    ]
+    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: '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: 'language code, e.g. ru',
+      kokoro: 'not bundled — offline neural runtime unavailable',
+      f5: 'not bundled — offline neural runtime unavailable',
+    }
+
+
+    function createErrorBoundary() {
+      if (!React || typeof React.Component !== 'function') {
+        return function NoopBoundary(props) { return (props && props.children) || null }
+      }
+      return class ErrorBoundary extends React.Component {
+        constructor(props) {
+          super(props)
+          this.state = { hasError: false, error: null }
+        }
+        static getDerivedStateFromError(error) {
+          return { hasError: true, error }
+        }
+        componentDidCatch(error, errorInfo) {
+          console.error('[dsh-tts] React Error:', error, errorInfo)
+        }
+        render() {
+          if (this.state.hasError) {
+            return React.createElement(
+              'div',
+              {
+                className: 'dts-alert dts-alert-err',
+                style: { margin: '12px 0', padding: '14px', borderRadius: '8px' },
+              },
+              React.createElement('div', { style: { fontWeight: 600, marginBottom: '6px' } }, '⚠️ TTS UI Error:'),
+              React.createElement('div', { style: { fontSize: '12px', wordBreak: 'break-all' } }, String((this.state.error && this.state.error.message) || this.state.error)),
+              React.createElement(
+                'button',
+                {
+                  type: 'button',
+                  className: 'dts-btn',
+                  style: { marginTop: '10px', fontSize: '12px', padding: '4px 10px' },
+                  onClick: () => this.setState({ hasError: false, error: null }),
+                },
+                'Retry',
+              ),
+            )
+          }
+          return (this.props && this.props.children) || null
+        }
+      }
+    }
+    const ErrorBoundary = createErrorBoundary()
+    const SNAPSHOT_READY = Object.freeze({ status: 'ready', value: {} })
+    const SNAPSHOT_LOADING = Object.freeze({ status: 'loading', value: {} })

package/lib/client-src/10-styles.js

@@ -0,0 +1,54 @@
+
+    const SET_CSS =
+      '.dts-wrap{display:flex;flex-direction:column;gap:18px;padding:4px 0 24px;max-width:900px}' +
+      '.dts-header{display:flex;flex-direction:column;gap:8px;padding-bottom:14px;border-bottom:1px solid var(--dsw-alias-border-l2)}' +
+      '.dts-page-title{font-size:20px;font-weight:700;color:var(--dsw-alias-label-primary);display:flex;align-items:center;gap:10px}' +
+      '.dts-page-sub{font-size:13px;color:var(--dsw-alias-label-secondary);line-height:1.5}' +
+      '.dts-block{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:12px;padding:16px 18px;display:flex;flex-direction:column;gap:12px}' +
+      '.dts-h{font-size:15px;font-weight:600;color:var(--dsw-alias-label-primary);display:flex;align-items:center;justify-content:space-between}' +
+      '.dts-sub{font-size:12px;color:var(--dsw-alias-label-secondary);line-height:1.4}' +
+      '.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}' +
+      '.dts-title{color:var(--dsw-alias-label-primary);font-size:15px;font-weight:600;line-height:1.4}' +
+      '.dts-chev{margin-left:auto;color:var(--dsw-alias-label-secondary);flex:none;transition:transform .16s}' +
+      '.dts-chevOpen{transform:rotate(180deg)}' +
+      '.dts-body{border-top:1px solid var(--dsw-alias-border-l2);margin:0 16px;padding:12px 0}' +
+      '.dts-field{display:flex;flex-direction:column;gap:6px;padding:6px 0;font-size:13px;color:var(--dsw-alias-label-primary)}' +
+      '.dts-input{height:34px;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary);border-radius:8px;padding:0 10px;font-size:13px;box-sizing:border-box}' +
+      '.dts-input:focus{outline:none;border-color:var(--dsw-alias-state-brand-primary)}' +
+      '.dts-foot{border-top:1px solid var(--dsw-alias-border-l2);display:flex;justify-content:flex-end;align-items:center;gap:10px;padding:14px 0 4px}' +
+      '.dts-save{appearance:none;font:inherit;cursor:pointer;border:1px solid transparent;border-radius:8px;padding:6px 16px;font-size:13px;font-weight:500;background:var(--dsw-alias-label-primary);color:var(--dsw-alias-bg-layer-3);transition:all .15s ease}' +
+      '.dts-save:hover:not(:disabled){opacity:0.88}' +
+      '.dts-btn{appearance:none;font:inherit;cursor:pointer;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:6px 12px;font-size:13px;background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary);font-weight:500;display:inline-flex;align-items:center;justify-content:center;gap:6px;transition:all .15s ease}' +
+      '.dts-btn:hover:not(:disabled){background:var(--dsw-alias-bg-layer-4, var(--dsw-alias-bg-layer-2));border-color:var(--dsw-alias-label-dimmed, var(--dsw-alias-border-l2))}' +
+      '.dts-btn-danger{color:var(--dsw-alias-state-error-primary);border-color:color-mix(in srgb, var(--dsw-alias-state-error-primary) 30%, transparent)}' +
+      '.dts-btn-danger:hover:not(:disabled){background:color-mix(in srgb, var(--dsw-alias-state-error-primary) 12%, transparent);border-color:color-mix(in srgb, var(--dsw-alias-state-error-primary) 50%, transparent)}' +
+      '.dts-entry{display:flex;flex-direction:column;gap:8px;padding:12px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-bg-layer-2)}' +
+      '.dts-row{display:flex;gap:8px;align-items:center;flex-wrap:wrap}' +
+      '.dts-row .dts-model{flex:1;min-width:120px}' +
+      '.dts-row .dts-key{flex:1;min-width:180px}' +
+      '.dts-mini{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary);border-radius:6px;width:28px;height:28px;cursor:pointer;flex:none;display:inline-flex;align-items:center;justify-content:center;font-size:13px;transition:all .15s ease}' +
+      '.dts-mini:hover:not(:disabled){background:var(--dsw-alias-bg-layer-4, var(--dsw-alias-bg-layer-2))}' +
+      '.dts-ok{font-size:12px;color:var(--dsw-alias-state-success-primary);font-weight:500}' +
+      '.dts-bad{font-size:12px;color:var(--dsw-alias-state-error-primary);font-weight:500}' +
+      '.dts-badge{font-size:11px;padding:3px 8px;border-radius:999px;border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-secondary);white-space:nowrap;display:inline-flex;align-items:center;gap:4px;font-weight:500}' +
+      '.dts-badge-on{color:var(--dsw-alias-state-success-primary);border-color:var(--dsw-alias-state-success-primary);background:color-mix(in srgb, var(--dsw-alias-state-success-primary) 8%, transparent)}' +
+      '.dts-badge-warn{color:var(--dsw-alias-state-warning-primary);border-color:var(--dsw-alias-state-warning-primary);background:color-mix(in srgb, var(--dsw-alias-state-warning-primary) 8%, transparent)}' +
+      '.dts-badge-bad{color:var(--dsw-alias-state-error-primary);border-color:var(--dsw-alias-state-error-primary);background:color-mix(in srgb, var(--dsw-alias-state-error-primary) 8%, transparent)}' +
+      '.dts-link{background:none;border:none;color:var(--dsw-alias-label-secondary);cursor:pointer;font-size:12px;padding:0;text-decoration:underline}' +
+      '.dts-link:hover:not(:disabled){color:var(--dsw-alias-label-primary)}' +
+      '.dts-alert{padding:10px 14px;border-radius:8px;font-size:13px}' +
+      '.dts-alert-err{background:color-mix(in srgb, var(--dsw-alias-state-error-primary) 10%, transparent);color:var(--dsw-alias-state-error-primary);border:1px solid color-mix(in srgb, var(--dsw-alias-state-error-primary) 20%, transparent)}' +
+      '.dts-alert-warn{background:color-mix(in srgb, var(--dsw-alias-state-warning-primary) 10%, transparent);color:var(--dsw-alias-state-warning-primary);border:1px solid color-mix(in srgb, var(--dsw-alias-state-warning-primary) 20%, transparent)}' +
+      '.dts-alert-ok{background:color-mix(in srgb, var(--dsw-alias-state-success-primary) 10%, transparent);color:var(--dsw-alias-state-success-primary);border:1px solid rgba(16,185,129,0.2)}' +
+      '.dts-grow{flex:1;min-width:100px}'
+
+    const setCssId = 'dsh-tts/settings.module.css'
+    if (typeof document !== 'undefined' && !document.querySelector('style[data-dsh-plugin="dsh-tts"]')) {
+      const tag = document.createElement('style')
+      tag.textContent = SET_CSS
+      tag.setAttribute('data-dsh-plugin', 'dsh-tts')
+      tag.dataset.pluginCss = setCssId
+      document.head.appendChild(tag)
+    }

package/lib/client-src/20-player.js

@@ -0,0 +1,328 @@
+    // 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 autoplay = { blocked: false, listeners: new Set() }
+
+    function setAutoplayBlocked(next) {
+      if (autoplay.blocked === next) return
+      autoplay.blocked = next
+      for (const l of [...autoplay.listeners]) {
+        try { l() } catch { /* listener isolation */ }
+      }
+    }
+
+    function unlockAudio() {
+      try {
+        const AC = window.AudioContext || window.webkitAudioContext
+        if (AC) {
+          const ctx = new AC()
+          if (ctx.state === 'suspended') ctx.resume().catch(() => {})
+          setTimeout(() => { try { ctx.close() } catch { /* closed */ } }, 300)
+        }
+      } catch { /* no AudioContext */ }
+      setAutoplayBlocked(false)
+      drainQueue()
+    }
+
+    function useAutoplayGate() {
+      const [, force] = React.useReducer((n) => n + 1, 0)
+      React.useEffect(() => {
+        autoplay.listeners.add(force)
+        return () => { autoplay.listeners.delete(force) }
+      }, [])
+      return autoplay
+    }
+
+    const player = {
+      audio: null,
+      after: '',
+      enabled: false,
+      rate: 1,
+      chime: 'ding',
+      queue: [],
+      bargeIn: true,
+      busy: false,
+      paused: false,
+      listeners: new Set(),
+      unlockAudio,
+      useAutoplayGate,
+      get autoplayBlocked() { return autoplay.blocked },
+    }
+    const seenIds = new Set()
+    let currentAudioResolve = null
+    function playerChanged() {
+      for (const listener of [...player.listeners]) {
+        try { listener() } catch (listenerFailure) { /* foreign listener failure is not ours */ }
+      }
+    }
+
+    function usePlayer() {
+      const [, force] = React.useReducer((n) => n + 1, 0)
+      React.useEffect(() => {
+        player.listeners.add(force)
+        return () => { player.listeners.delete(force) }
+      }, [])
+      return player
+    }
+
+    // Short chime is synthesized in-browser: no file to download, store, or configure.
+    function playChime(kind) {
+      return new Promise((resolve) => {
+        try {
+          const AC = window.AudioContext || window.webkitAudioContext
+          if (!AC) { resolve(); return }
+          const audioCtx = new AC()
+          const gain = audioCtx.createGain()
+          gain.connect(audioCtx.destination)
+          const tones = kind === 'beep' ? [880, 880] : [660, 990]
+          let at = audioCtx.currentTime
+          for (const freq of tones) {
+            const osc = audioCtx.createOscillator()
+            osc.frequency.value = freq
+            osc.connect(gain)
+            gain.gain.setValueAtTime(0.0001, at)
+            gain.gain.exponentialRampToValueAtTime(0.25, at + 0.02)
+            gain.gain.exponentialRampToValueAtTime(0.0001, at + 0.18)
+            osc.start(at)
+            osc.stop(at + 0.2)
+            at += 0.22
+          }
+          setTimeout(() => { try { audioCtx.close() } catch (already) { /* already closed */ } resolve() }, 600)
+        } catch { resolve() /* no AudioContext */ }
+      })
+    }
+
+    // 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 {
+          if (!window.speechSynthesis || !text) { resolve(); return }
+          const utterance = new SpeechSynthesisUtterance(String(text))
+          utterance.rate = Math.max(0.5, Math.min(2, player.rate || 1))
+          utterance.onend = () => resolve()
+          utterance.onerror = () => resolve()
+          window.speechSynthesis.speak(utterance)
+        } catch { resolve() /* no speechSynthesis */ }
+      })
+    }
+
+    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 { /* decode error — item stays unprepared */ }
+      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 {
+          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
+            try { URL.revokeObjectURL(url) } catch { /* URL already revoked */ }
+            item.prepared = null
+            player.audio = null
+            playerChanged()
+            resolve()
+          }
+          currentAudioResolve = done
+          audio.onended = done
+          audio.onerror = done
+          audio.play().catch((playErr) => {
+            // Autoplay without a user gesture is blocked — surface unlock UX, then stop this chunk.
+            if (playErr && (playErr.name === 'NotAllowedError' || playErr.name === 'SecurityError')) {
+              setAutoplayBlocked(true)
+            }
+            done()
+          })
+        } catch { /* cannot decode — skip chunk */
+          currentAudioResolve = null
+          resolve()
+        }
+      })
+    }
+
+    async function drainQueue() {
+      if (player.busy) return
+      player.busy = true
+      playerChanged()
+      try {
+        while (player.queue.length) {
+          if (player.paused) break
+          const item = player.queue.shift()
+          if (!item || item.kind === 'reserved') continue
+          if (item.kind === 'chime') { await playChime(item.chime || player.chime); continue }
+          if (item.audioBase64) await playAudio(item)
+          else if (item.error && item.text) await speakInBrowser(item.text)
+        }
+      } finally {
+        player.busy = false
+        playerChanged()
+      }
+    }
+
+    function stopPlayback() {
+      for (const item of player.queue) {
+        if (item && item.prepared && item.prepared.url) {
+          try { URL.revokeObjectURL(item.prepared.url) } catch { /* already revoked */ }
+          item.prepared = null
+        }
+      }
+      player.queue.length = 0
+      player.paused = false
+      if (player.audio) {
+        try { player.audio.pause() } catch { /* already paused */ }
+      }
+      if (currentAudioResolve) {
+        currentAudioResolve()
+      }
+      player.audio = null
+      try { if (window.speechSynthesis) window.speechSynthesis.cancel() } catch { /* no speechSynthesis */ }
+      playerChanged()
+    }
+
+    function togglePause() {
+      player.paused = !player.paused
+      if (player.audio) {
+        try { player.paused ? player.audio.pause() : player.audio.play() } catch (already) { /* ignore play/pause failure */ }
+      }
+      if (!player.paused) drainQueue()
+      playerChanged()
+    }
+
+    function skipCurrent() {
+      if (currentAudioResolve) {
+        currentAudioResolve()
+      } else if (player.audio) {
+        try { player.audio.pause() } catch (already) { /* already stopped */ }
+        player.audio = null
+        playerChanged()
+        if (player.queue.length) drainQueue()
+      }
+    }
+
+    // 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) => {
+        const phase = event && event.detail && event.detail.phase
+        if (phase !== 'start') return
+        if (!player.bargeIn) return
+        if (!player.audio && !player.queue.length && !player.busy) return
+        stopPlayback()
+      }
+      window.addEventListener('dsh-voice:speaking', onSpeaking)
+      return () => window.removeEventListener('dsh-voice:speaking', onSpeaking)
+    }
+
+    async function pollPending() {
+      try {
+        const st = await fetch('/dsh-tts/status', { cache: 'no-store' })
+        if (!st.ok) return
+        const meta = await st.json()
+        player.enabled = !!(meta && meta.speakReplies)
+        if (meta && typeof meta.rate === 'number') player.rate = meta.rate
+        if (meta && meta.chime) player.chime = meta.chime
+          if (meta && meta.roles) player.roles = meta.roles
+        if (meta && typeof meta.bargeIn === 'boolean') player.bargeIn = meta.bargeIn
+        if (!player.enabled) return
+        const res = await fetch('/dsh-tts/pending?after=' + encodeURIComponent(player.after || ''), { cache: 'no-store' })
+        if (!res.ok) return
+        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
+          seenIds.add(item.id)
+          if (seenIds.size > 500) {
+            const first = seenIds.values().next().value
+            seenIds.delete(first)
+          }
+          if (item.text) recent.add(item.text)
+          player.queue.push(item)
+        }
+        if (player.queue.length) drainQueue()
+      } catch (hostRestarting) { /* host restarting */ }
+    }
+
+    // Recent utterances: last reply texts and favorites (localStorage).
+    function recentStore() {
+      const KEY = 'dsh-tts/recent'
+      let st
+      try {
+        const raw = typeof localStorage !== 'undefined' ? localStorage.getItem(KEY) : null
+        st = JSON.parse(raw) || { items: [], favs: [] }
+      } catch (broken) { st = { items: [], favs: [] } }
+      const persist = () => { try { if (typeof localStorage !== 'undefined') localStorage.setItem(KEY, JSON.stringify(st)) } catch (full) { /* private mode / quota */ } }
+      return {
+        add(text) {
+          if (!text || text.length < 2) return
+          st.items = [text, ...st.items.filter((x) => x !== text)].slice(0, 30)
+          persist()
+        },
+        toggleFav(text) {
+          st.favs = st.favs.includes(text)
+            ? st.favs.filter((x) => x !== text)
+            : [text, ...st.favs].slice(0, 20)
+          persist()
+        },
+        list() { return { items: st.items, favs: st.favs } },
+      }
+    }
+    const recent = recentStore()
+
+    // One-shot playback outside the queue: replay from recents.
+    function playStandalone(text) {
+      fetch('/dsh-tts/speak', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ text }),
+      })
+        .then((r) => r.json())
+        .then((d) => {
+          if (!d || !d.ok) return
+          const audio = new Audio('data:' + (d.mime || 'audio/mpeg') + ';base64,' + d.audioBase64)
+          audio.play().catch(() => {})
+        })
+        .catch(() => {})
+    }
+
+    function credOf(map, provider) {
+      return (map && map[provider]) || { configured: false, writable: true, ref: '' }
+    }
+