@goodandready/dsh-tts 0.3.4 → 0.3.6

package/lib/client.js

@@ -366,6 +366,8 @@ window.__ModuleLoader__.load({
       'save': 'Save',
       'saved': 'Saved',
       'cardHint': 'Provider chain, voices and playback options.',
+      'skipCode': 'Skip code blocks',
+      'skipCodeHint': 'Say a short notice instead of reading code aloud.',
     }
     const ru = {
       'general': 'Общее',
@@ -414,6 +416,8 @@ window.__ModuleLoader__.load({
       'save': 'Сохранить',
       'saved': 'Сохранено',
       'cardHint': 'Цепочка провайдеров, голоса и параметры чтения.',
+      'skipCode': 'Пропускать код',
+      'skipCodeHint': 'Вместо чтения кода вслух — короткая пометка.',
     }
 
     function TtsSection(props) {
@@ -565,6 +569,8 @@ window.__ModuleLoader__.load({
             t('bargeInHint')),
           boolField('announceApproval', t('announce'),
             t('announceHint')),
+          boolField('skipCode', t('skipCode'),
+            t('skipCodeHint')),
           textField('approvalText', t('approvalText'), t('approvalHint')),
           textField('questionText', t('questionText'), t('questionHint')),
           textField('chime', t('chime'), t('chimeHint')),
@@ -646,7 +652,25 @@ window.__ModuleLoader__.load({
     }
 
     function registerSettings(ctx) {
-      ctx.effect(() => ctx.locale.register(NS, { en, ru }), 'dsh-tts: словари')
+      // Язык может принести не только плагин: словарные пакеты объявляют
+      // русский для чужих пространств. Ядро на повторное объявление той же
+      // пары «пространство + язык» бросает исключение, и незащищённый вызов
+      // уносил с собой весь плагин — в интерфейсе это выглядело как «Failed to
+      // load plugins» с перечнем ни в чём не повинных соседей.
+      //
+      // Поэтому каждый язык объявляется отдельно и по-хорошему: заняли до нас —
+      // уступаем, свой английский при этом всё равно встаёт на место.
+      const addLocale = (locale, dictionary) => {
+        try {
+          return ctx.locale.register(NS, locale, dictionary)
+        } catch (alreadyTaken) {
+          return () => {}
+        }
+      }
+      ctx.effect(() => {
+        const undo = [addLocale('en', en), addLocale('ru', ru)]
+        return () => { for (const off of undo) off() }
+      }, 'dsh-tts: словари')
       // Подпись раздела рисует боковой список, а не наш компонент: props.t
       // туда не доходит, поэтому берём переводчик, привязанный к namespace.
       const t = ctx.locale.bind(NS)

package/lib/index.js

@@ -3,7 +3,7 @@ import { defineTool } from '@deepseek-ai/dsh-tools'
 import { credentialRef } from '@deepseek-ai/dsh-credentials'
 import { runChain } from './chain.js'
 import { makeProviders, PROVIDER_KEYS, DEFAULT_MODELS, DEFAULT_VOICES } from './providers.js'
-import { assistantText, stripForSpeech, splitSentences } from './text.js'
+import { assistantText, speechPhrases, splitSentences, stripForSpeech } from './text.js'
 import {
   CLOUD_PROVIDERS,
   assertCredentialRef,
@@ -31,6 +31,8 @@ const ChainEntry = z.object({
 export const Config = z.object({
   speakReplies: z.boolean().default(false)
     .description('When on, speak each finished agent reply in the Web UI.'),
+  skipCode: z.boolean().default(true)
+    .description('Replace fenced code blocks with a short spoken notice instead of reading them aloud.'),
   language: z.string().default('ru'),
   speakAsItGoes: z
     .boolean()
@@ -225,8 +227,13 @@ export function apply(ctx, config) {
     }
   }
 
+  // Настройки чистки текста считаем на каждый вызов: конфиг живой.
+  function cleanOpts(cfg) {
+    return { skipCode: cfg.skipCode !== false, phrases: speechPhrases(cfg.language) }
+  }
+
   async function synthesize(rawText, cfg, signal) {
-    const text = stripForSpeech(rawText, cfg.maxChars)
+    const text = stripForSpeech(rawText, cfg.maxChars, cleanOpts(cfg))
     if (!text) throw new Error('nothing to speak')
     const models = {}
     const voices = {}
@@ -320,7 +327,7 @@ export function apply(ctx, config) {
       // предложениями, и очередь проигрывается по порядку. Ждать конца хода
       // значит молчать всё время, пока агент работает.
       if (cfg.speakAsItGoes) {
-        const ready = stripForSpeech(text, cfg.maxChars)
+        const ready = stripForSpeech(text, cfg.maxChars, cleanOpts(cfg))
         for (const piece of splitSentences(ready, cfg.sentenceChars)) speakPiece(sid, piece, cfg)
         return
       }
@@ -335,7 +342,7 @@ export function apply(ctx, config) {
     const cur = collectors.get(sid)
     collectors.delete(sid)
     const raw = cur && Array.isArray(cur.parts) ? cur.parts.join('\n') : ''
-    const text = stripForSpeech(raw, cfg.maxChars)
+    const text = stripForSpeech(raw, cfg.maxChars, cleanOpts(cfg))
     if (!text) return
     const id = `u${++utteranceSeq}`
     const controller = new AbortController()
@@ -502,7 +509,7 @@ export function apply(ctx, config) {
       }
       let payload
       try { payload = JSON.parse(raw.toString('utf8') || '{}') } catch { payload = {} }
-      const text = stripForSpeech(payload.text, live().maxChars)
+      const text = stripForSpeech(payload.text, live().maxChars, cleanOpts(live()))
       if (!text) { writeJson(res, 400, { ok: false, error: { code: 'no-text', message: 'no text' } }); return }
       const cfg = live()
       const controller = new AbortController()

package/lib/text.js

@@ -11,10 +11,44 @@ export function blocksToText(content) {
   return parts.join('\n')
 }
 
-export function stripForSpeech(raw, maxChars) {
+// Короткие пометки вместо выброшенной разметки. Формулировки выбираются по
+// языку озвучки из настроек; подстановки {n} заполняются числом строк.
+export const SPEECH_PHRASES = {
+  en: { codeBlock: 'code block, {n} lines', table: 'table, {n} rows' },
+  ru: { codeBlock: 'блок кода, {n} строк', table: 'таблица, {n} строк' },
+}
+
+export function speechPhrases(language) {
+  const lang = String(language || '').toLowerCase()
+  return lang.startsWith('ru') ? SPEECH_PHRASES.ru : SPEECH_PHRASES.en
+}
+
+function fill(template, n) {
+  return String(template).replace('{n}', String(n))
+}
+
+export function stripForSpeech(raw, maxChars, opts) {
+  const options = opts || {}
+  const skipCode = options.skipCode !== false
+  const phrases = options.phrases || SPEECH_PHRASES.en
   let text = String(raw || '')
-  text = text.replace(/```[\s\S]*?```/g, ' ')
-  text = text.replace(/`[^`]+`/g, ' ')
+  // Чистка обязана идти до нарезки на предложения, иначе половина блока
+  // уедет в первый кусок и будет озвучена.
+  if (skipCode) {
+    text = text.replace(/```[\s\S]*?```/g, (block) => {
+      const inner = block.replace(/^```[^\n]*\n?/, '').replace(/\n?```\s*$/, '')
+      const lines = inner ? inner.split('\n').length : 1
+      return ' ' + fill(phrases.codeBlock, lines) + ' '
+    })
+    text = text.replace(/`[^`\n]+`/g, ' ')
+  }
+  // Таблицы Markdown: подряд идущие строки, начинающиеся с |; разделительная
+  // шапка |---| в счёт строк не идёт.
+  text = text.replace(/(?:^[ \t]*\|.*\|[ \t]*$\n?)+/gm, (run) => {
+    const rows = run.trim().split('\n')
+      .filter((line) => !/^\s*\|[\s:|-]+\|\s*$/.test(line)).length
+    return fill(phrases.table, Math.max(1, rows)) + '\n'
+  })
   text = text.replace(/!\[[^\]]*\]\([^)]+\)/g, ' ')
   text = text.replace(/\[([^\]]+)\]\([^)]+\)/g, '$1')
   text = text.replace(/[#*_>]+/g, ' ')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-tts",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "Text-to-speech for DeepSeek Harness: speak agent replies in the Web UI with a provider fallback chain (OpenAI, ElevenLabs, Google, Azure, Groq, Deepgram, OpenRouter, Edge, Piper, eSpeak).",
   "license": "MIT",
   "type": "module",