agentvibes 4.2.0 → 4.4.1

package/src/console/tabs/settings-tab.js

@@ -29,6 +29,35 @@ import { formatTrackName as _sharedFormatTrackName, formatReverbState as _shared
 import { showNotice as _showNoticeWidget } from '../widgets/notice.js';
 
 const IS_TEST = process.env.AGENTVIBES_TEST_MODE === 'true';
+const _IS_WINDOWS = process.platform === 'win32' && !process.env.WSL_DISTRO_NAME;
+
+/** Resolve piper binary path — uses exe on Windows, 'piper' in PATH on Unix */
+function _resolvePiperBin() {
+  if (_IS_WINDOWS) {
+    const lad = process.env.LOCALAPPDATA ||
+      (process.env.USERPROFILE ? path.join(process.env.USERPROFILE, 'AppData', 'Local') : null);
+    if (lad) {
+      // Standalone binary install
+      const exe = path.join(lad, 'Programs', 'Piper', 'piper.exe');
+      if (fs.existsSync(exe)) return exe;
+      // pip-installed piper (Python Scripts directory)
+      const pyScripts = path.join(lad, 'Programs', 'Python');
+      try {
+        const pyDirs = fs.readdirSync(pyScripts).filter(d => d.startsWith('Python'));
+        for (const d of pyDirs) {
+          const pipExe = path.join(pyScripts, d, 'Scripts', 'piper.exe');
+          if (fs.existsSync(pipExe)) return pipExe;
+        }
+      } catch { /* no Python installs */ }
+    }
+  }
+  return 'piper';
+}
+
+/** Build spawn options with Windows-safe defaults (no visible console, no detached) */
+function _spawnOpts(env, extraOpts = {}) {
+  return { stdio: 'ignore', detached: !_IS_WINDOWS, windowsHide: true, env, ...extraOpts };
+}
 
 // Sanitize strings before passing as env vars to shell commands.
 // Removes characters that could cause shell injection when expanded inside sh -c.
@@ -51,19 +80,19 @@ const _modalTitle = (text) => ` {${BRAND_PINK}-fg}${text}{/${BRAND_PINK}-fg} `;
 
 const COLORS = {
   contentBg:    '#0a0e1a',  // Near-black content background
-  sectionHdr:   '#7986cb',  // Light blue — section dividers
+  sectionHdr:   'bright-cyan',  // Matches header "Agent" color
   labelFg:      '#e3f2fd',  // Light blue text — labels
   valueFg:      '#ffff00',  // Yellow — current values
   btnDefault:   '#37474f',  // Dark slate — default button bg
-  btnFocus:     '#00e5ff',  // Cyan — focused button bg
-  btnFocusFg:   '#000000',  // Black — focused button text
+  btnFocus:     '#2e7d32',  // Green — focused/selected button bg
+  btnFocusFg:   '#ffffff',  // White — focused button text
   btnPress:     '#ff00ff',  // Magenta — pressed button bg
   btnChange:    '#37474f',  // Dark slate — Change buttons
   btnTest:      '#37474f',  // Dark slate — Test buttons
   btnEdit:      '#37474f',  // Dark slate — Edit buttons
   btnEnableOn:  '#37474f',  // Dark slate — Enabled toggle
   btnEnableOff: '#37474f',  // Dark slate — Disabled toggle
-  borderFg:     '#7986cb',  // Light blue — borders
+  borderFg:     'bright-cyan',  // Matches section headers
   footerBg:     '#2196f3',  // Blue — settings footer
   noticeFg:     '#90a4ae',  // Gray — stub notice text
 };
@@ -413,9 +442,14 @@ export function createSettingsTab(screen, services) {
           `play "${trackPath}" repeat 9999 vol ${volFraction}`,
           `mpg123 -q --loop -1 "${trackPath}"`,
         ].join(' 2>/dev/null || ') + ' 2>/dev/null';
-        _testMusicProc = spawn('sh', ['-c', musicCmd], {
-          stdio: 'ignore', detached: true, env: _testEnv,
-        });
+        if (_IS_WINDOWS) {
+          const _mp3P = detectMp3Player(_testEnv);
+          _testMusicProc = _mp3P
+            ? spawn(_mp3P.bin, _mp3P.args(trackPath), _spawnOpts(_testEnv))
+            : null;
+        } else {
+          _testMusicProc = spawn('sh', ['-c', musicCmd], _spawnOpts(_testEnv));
+        }
         _testMusicProc.unref();
       }
     }
@@ -463,7 +497,7 @@ export function createSettingsTab(screen, services) {
           `soprano "$_AV_PHRASE" -o "$_AV_WAV"`,
         ].join(' || ');
         synthProc = spawn('sh', ['-c', cmd], {
-          stdio: 'ignore', detached: true, env: sopranoEnv,
+          stdio: 'ignore', detached: !_IS_WINDOWS, windowsHide: true, env: sopranoEnv,
         });
       } else {
         const voiceId = providerService.getActiveVoiceId();
@@ -476,8 +510,8 @@ export function createSettingsTab(screen, services) {
         }
         const _piperArgs = ['--model', voicePath, '--output_file', tempWav];
         if (_ms.speakerId != null) _piperArgs.push('--speaker', String(_ms.speakerId));
-        synthProc = spawn('piper', _piperArgs, {
-          stdio: ['pipe', 'ignore', 'ignore'], detached: true, env: _testEnv,
+        synthProc = spawn(_resolvePiperBin(), _piperArgs, {
+          stdio: ['pipe', 'ignore', 'ignore'], detached: !_IS_WINDOWS, windowsHide: true, env: _testEnv,
         });
         synthProc.stdin.write(ttsInput + '\n');
         synthProc.stdin.end();
@@ -528,7 +562,7 @@ export function createSettingsTab(screen, services) {
         _setTestBtnsLabel('■ Stop');
         const _wavPlayer1 = detectWavPlayer(_testEnv);
         const playProc = _wavPlayer1
-          ? spawn(_wavPlayer1.bin, _wavPlayer1.args(wavToPlay), { stdio: 'ignore', detached: true, env: _testEnv })
+          ? spawn(_wavPlayer1.bin, _wavPlayer1.args(wavToPlay), _spawnOpts(_testEnv))
           : null;
         if (!playProc) { _killTest(); _restoreTestBtnsLabels(); return; }
         _testVoiceProc = playProc;
@@ -633,9 +667,14 @@ export function createSettingsTab(screen, services) {
       `mpg123 -q "${trackPath}"`,
     ].join(' 2>/dev/null || ') + ' 2>/dev/null';
 
-    _musicTestProc = spawn('sh', ['-c', cmd], {
-      stdio: 'ignore', detached: true, env: _testEnv,
-    });
+    if (_IS_WINDOWS) {
+      const _mp3P2 = detectMp3Player(_testEnv);
+      _musicTestProc = _mp3P2
+        ? spawn(_mp3P2.bin, _mp3P2.args(trackPath), _spawnOpts(_testEnv))
+        : null;
+    } else {
+      _musicTestProc = spawn('sh', ['-c', cmd], _spawnOpts(_testEnv));
+    }
     _musicTestProc.unref();
     musicTestBtn.setContent('■ Stop');
     screen.render();
@@ -728,7 +767,7 @@ export function createSettingsTab(screen, services) {
       content: lbl, width: lbl.length, height: 1,
       top: 0, left: _xOff,
       keys: true, focusable: true,
-      style: { fg: '#00e5ff', bg: '#263238' },
+      style: { fg: 'bright-cyan', bg: '#263238' },
     });
     _subTabItemsMap[id] = item;
     _xOff += lbl.length;
@@ -742,7 +781,7 @@ export function createSettingsTab(screen, services) {
         item.style.bg = '#0288d1'; // light blue — active tab
         item.style.bold = true;
       } else {
-        item.style.fg = '#00e5ff';
+        item.style.fg = 'bright-cyan';
         item.style.bg = '#263238';
         item.style.bold = false;
       }
@@ -776,12 +815,24 @@ export function createSettingsTab(screen, services) {
     });
   }
 
+  // -------------------------------------------------------------------------
+  // Section header: ── Provider & Voice ──
+
+  const providerVoiceHeader = blessed.text({
+    parent: box,
+    top: 3,
+    left: 1,
+    content: '{bright-cyan-fg} 🎤 Provider & Voice {/bright-cyan-fg}',
+    tags: true,
+    style: { bg: COLORS.contentBg },
+  });
+
   // -------------------------------------------------------------------------
   // Provider row: label + value + [Switch] button
 
   const providerLabel = blessed.text({
     parent: box,
-    top: 3,
+    top: 5,
     left: 6,
     content: 'Provider:',
     style: { fg: COLORS.labelFg, bg: COLORS.contentBg },
@@ -789,7 +840,7 @@ export function createSettingsTab(screen, services) {
 
   const providerValue = blessed.text({
     parent: box,
-    top: 3,
+    top: 5,
     left: 22,
     width: 26,    // truncate before [Switch] at left:40
     wrap: false,
@@ -805,7 +856,7 @@ export function createSettingsTab(screen, services) {
       screen.render();
     }, _restoreFocus);
   });
-  switchBtn.top = 3;
+  switchBtn.top = 5;
   switchBtn.left = 52;
 
   // -------------------------------------------------------------------------
@@ -813,7 +864,7 @@ export function createSettingsTab(screen, services) {
 
   const voiceLabel = blessed.text({
     parent: box,
-    top: 5,
+    top: 7,
     left: 6,
     content: 'Current Voice:',
     style: { fg: COLORS.labelFg, bg: COLORS.contentBg },
@@ -821,7 +872,7 @@ export function createSettingsTab(screen, services) {
 
   const voiceValue = blessed.text({
     parent: box,
-    top: 5,
+    top: 7,
     left: 22,
     width: 26,    // truncate before [Change] at left:40
     wrap: false,
@@ -837,7 +888,7 @@ export function createSettingsTab(screen, services) {
       screen.render();
     }, _restoreFocus);
   }, { bg: COLORS.btnChange });
-  changeBtn.top = 5;
+  changeBtn.top = 7;
   changeBtn.left = 52;
 
   const playBtn = _createButton(box, screen, '▶ Play', COLORS, () => {
@@ -865,14 +916,19 @@ export function createSettingsTab(screen, services) {
       if (!_samplePlaying) { try { fs.unlinkSync(tempWav); } catch {} return; }
       if (code !== 0) {
         _killSample(); playBtn.setContent('▶ Play'); _focusButton(playBtn);
+        _showNotice(screen, 'Voice synthesis failed — check voice model');
         try { fs.unlinkSync(tempWav); } catch {}
         return;
       }
       playBtn.setContent('■ Stop');
       screen.render();
       const _wavPlayer2 = detectWavPlayer(_sampleEnv);
-      if (!_wavPlayer2) { _stopSpinner(); _killSample(); playBtn.setContent('▶ Play'); screen.render(); return; }
-      const playProc = spawn(_wavPlayer2.bin, _wavPlayer2.args(tempWav), { stdio: 'ignore', detached: true, env: _sampleEnv });
+      if (!_wavPlayer2) {
+        _stopSpinner(); _killSample(); playBtn.setContent('▶ Play');
+        _showNotice(screen, 'No audio player found — install ffplay, sox, or mpv');
+        screen.render(); return;
+      }
+      const playProc = spawn(_wavPlayer2.bin, _wavPlayer2.args(tempWav), _spawnOpts(_sampleEnv));
       _sampleProcess = playProc;
       const _done = () => { _killSample(); playBtn.setContent('▶ Play'); _focusButton(playBtn); try { fs.unlinkSync(tempWav); } catch {} };
       playProc.on('exit', _done);
@@ -973,7 +1029,7 @@ export function createSettingsTab(screen, services) {
         ].join(' || ');
 
         const soprano = spawn('sh', ['-c', cmd], {
-          stdio: 'ignore', detached: true, env: sopranoEnv,
+          stdio: 'ignore', detached: !_IS_WINDOWS, windowsHide: true, env: sopranoEnv,
         });
         _sampleProcess = soprano;
         soprano.on('exit', (code) => {
@@ -986,31 +1042,67 @@ export function createSettingsTab(screen, services) {
       // Piper (default): pipe text via stdin
       _startSpinner(playBtn, 'Synthesizing…');
       const voiceId   = providerService.getActiveVoiceId();
-      if (!voiceId) { _stopSpinner(); _killSample(); playBtn.setContent('▶ Play'); screen.render(); return; }
+      if (!voiceId) {
+        _stopSpinner(); _killSample(); playBtn.setContent('▶ Play');
+        _showNotice(screen, 'No voice selected — choose a voice first');
+        screen.render(); return;
+      }
       const _ms2 = parseMultiSpeaker(voiceId);
       const voicePath = path.resolve(PIPER_VOICES_DIR, _ms2.model + '.onnx');
       const safeBase  = path.resolve(PIPER_VOICES_DIR);
       if (!voicePath.startsWith(safeBase + path.sep) && voicePath !== safeBase) {
-        _stopSpinner(); _killSample(); playBtn.setContent('▶ Play'); screen.render(); return;
+        _stopSpinner(); _killSample(); playBtn.setContent('▶ Play');
+        _showNotice(screen, 'Invalid voice path');
+        screen.render(); return;
+      }
+      const piperBin2 = _resolvePiperBin();
+      if (piperBin2 === 'piper') {
+        // Bare command — verify it exists in PATH before spawning
+        const whichCmd = _IS_WINDOWS ? 'where' : 'which';
+        const whichResult = spawnSync(whichCmd, [_IS_WINDOWS ? 'piper.exe' : 'piper'], { stdio: 'pipe', env: _sampleEnv });
+        if (whichResult.status !== 0) {
+          _stopSpinner(); _killSample(); playBtn.setContent('▶ Play');
+          _showNotice(screen, 'Piper not installed — run the installer or: pip install piper-tts');
+          _focusButton(playBtn); screen.render(); return;
+        }
       }
       const _piperArgs2 = ['--model', voicePath, '--output_file', tempWav];
       if (_ms2.speakerId != null) _piperArgs2.push('--speaker', String(_ms2.speakerId));
-      const piper = spawn('piper', _piperArgs2, {
-        stdio: ['pipe', 'ignore', 'ignore'], detached: true, env: _sampleEnv,
+      const piper = spawn(piperBin2, _piperArgs2, {
+        stdio: ['pipe', 'ignore', 'pipe'], detached: !_IS_WINDOWS, windowsHide: true, env: _sampleEnv,
       });
+      let _piperStderr = '';
+      piper.stderr.on('data', (d) => { _piperStderr += d.toString(); });
       piper.stdin.write(phrase + '\n');
       piper.stdin.end();
       _sampleProcess = piper;
-      piper.on('exit', _onSynthDone);
-      piper.on('error', () => { _stopSpinner(); _killSample(); playBtn.setContent('▶ Play'); _focusButton(playBtn); });
+      piper.on('exit', (code) => {
+        if (code !== 0 && _piperStderr) {
+          // Python tracebacks: actual error is the LAST non-empty line
+          const lines = _piperStderr.split('\n').map(l => l.trim()).filter(Boolean);
+          const errLine = lines[lines.length - 1] || lines[0] || 'unknown error';
+          _stopSpinner();
+          if (!_samplePlaying) { try { fs.unlinkSync(tempWav); } catch {} return; }
+          _killSample(); playBtn.setContent('▶ Play'); _focusButton(playBtn);
+          _showNotice(screen, errLine.length > 100 ? errLine.substring(0, 97) + '…' : errLine);
+          try { fs.unlinkSync(tempWav); } catch {}
+          return;
+        }
+        _onSynthDone(code);
+      });
+      piper.on('error', (e) => {
+        _stopSpinner(); _killSample(); playBtn.setContent('▶ Play');
+        _showNotice(screen, `Piper failed: ${e.message}`);
+        _focusButton(playBtn);
+      });
     }
   });
-  playBtn.top = 5;
+  playBtn.top = 7;
   playBtn.left = 64;
 
   const voiceFileText = blessed.text({
     parent: box,
-    top: 6,
+    top: 8,
     left: 22,
     right: 2,
     wrap: false,
@@ -1025,7 +1117,7 @@ export function createSettingsTab(screen, services) {
     parent: box,
     top: 3,
     left: 1,
-    content: '{#7986cb-fg} ⚡ Audio Effects {/#7986cb-fg}',
+    content: '{bright-cyan-fg} ⚡ Audio Effects {/bright-cyan-fg}',
     tags: true,
     style: { bg: COLORS.contentBg },
   });
@@ -1081,7 +1173,7 @@ export function createSettingsTab(screen, services) {
     parent: box,
     top: 7,
     left: 1,
-    content: '{#7986cb-fg} 🎸 Background Music {/#7986cb-fg}',
+    content: '{bright-cyan-fg} 🎸 Background Music {/bright-cyan-fg}',
     tags: true,
     style: { bg: COLORS.contentBg },
   });
@@ -1177,12 +1269,24 @@ export function createSettingsTab(screen, services) {
   volumeChangeBtn.top = 11;
   volumeChangeBtn.left = 52;
 
+  // -------------------------------------------------------------------------
+  // Section header: ── Style ──
+
+  const styleHeader = blessed.text({
+    parent: box,
+    top: 3,
+    left: 1,
+    content: '{bright-cyan-fg} 🎭 Style {/bright-cyan-fg}',
+    tags: true,
+    style: { bg: COLORS.contentBg },
+  });
+
   // -------------------------------------------------------------------------
   // Verbosity row: label + value + [Change] button
 
   const verbosityLabel = blessed.text({
     parent: box,
-    top: 3,
+    top: 5,
     left: 6,
     content: 'Verbosity:',
     style: { fg: COLORS.labelFg, bg: COLORS.contentBg },
@@ -1190,7 +1294,7 @@ export function createSettingsTab(screen, services) {
 
   const verbosityValue = blessed.text({
     parent: box,
-    top: 3,
+    top: 5,
     left: 22,
     width: 26,    // truncate before [Change] at left:40
     wrap: false,
@@ -1201,12 +1305,12 @@ export function createSettingsTab(screen, services) {
   const verbosityChangeBtn = _createButton(box, screen, 'Change', COLORS, () => {
     _openVerbosityPicker(screen, configService, () => refreshDisplay(), _restoreFocus);
   }, { bg: COLORS.btnChange });
-  verbosityChangeBtn.top = 3;
+  verbosityChangeBtn.top = 5;
   verbosityChangeBtn.left = 52;
 
   const verbosityPathText = blessed.text({
     parent: box,
-    top: 4,
+    top: 6,
     left: 22,
     right: 2,
     wrap: false,
@@ -1219,7 +1323,7 @@ export function createSettingsTab(screen, services) {
 
   const personalityLabel = blessed.text({
     parent: box,
-    top: 5,
+    top: 7,
     left: 6,
     content: 'Personality:',
     style: { fg: COLORS.labelFg, bg: COLORS.contentBg },
@@ -1227,7 +1331,7 @@ export function createSettingsTab(screen, services) {
 
   const personalityValue = blessed.text({
     parent: box,
-    top: 5,
+    top: 7,
     left: 22,
     width: 26,    // truncate before [Change] at left:40
     wrap: false,
@@ -1241,7 +1345,7 @@ export function createSettingsTab(screen, services) {
       refreshDisplay();
     }, _restoreFocus);
   }, { bg: COLORS.btnChange });
-  personalityChangeBtn.top = 5;
+  personalityChangeBtn.top = 7;
   personalityChangeBtn.left = 52;
 
   const personalityTestBtn = _createButton(box, screen, '▶ Preview', COLORS, () => {
@@ -1252,12 +1356,12 @@ export function createSettingsTab(screen, services) {
       : _buildPreviewPhrase();
     _runTest(false, phrase);
   }, { bg: COLORS.btnTest });
-  personalityTestBtn.top = 5;
+  personalityTestBtn.top = 7;
   personalityTestBtn.left = 64;
 
   const personalityFileText = blessed.text({
     parent: box,
-    top: 6,
+    top: 8,
     left: 22,
     right: 2,
     wrap: false,
@@ -1271,9 +1375,9 @@ export function createSettingsTab(screen, services) {
 
   const introTextHeader = blessed.text({
     parent: box,
-    top: 8,
+    top: 10,
     left: 1,
-    content: '{#7986cb-fg} ✍️ Intro Text {/#7986cb-fg}',
+    content: '{bright-cyan-fg} ✍️ Intro Text {/bright-cyan-fg}',
     tags: true,
     style: { bg: COLORS.contentBg },
   });
@@ -1283,7 +1387,7 @@ export function createSettingsTab(screen, services) {
 
   const introTextLabel = blessed.text({
     parent: box,
-    top: 10,
+    top: 12,
     left: 6,
     content: 'Intro Text:',
     style: { fg: COLORS.labelFg, bg: COLORS.contentBg },
@@ -1291,7 +1395,7 @@ export function createSettingsTab(screen, services) {
 
   const introTextValue = blessed.text({
     parent: box,
-    top: 10,
+    top: 12,
     left: 22,
     width: 26,    // truncate before [Edit] at left:40
     wrap: false,
@@ -1302,19 +1406,19 @@ export function createSettingsTab(screen, services) {
   const introEditBtn = _createButton(box, screen, 'Edit', COLORS, () => {
     _openIntroTextEditor(screen, configService, () => { refreshDisplay(); }, _restoreFocus);
   }, { bg: COLORS.btnEdit });
-  introEditBtn.top = 10;
+  introEditBtn.top = 12;
   introEditBtn.left = 52;
 
   const introClearBtn = _createButton(box, screen, 'Clear', COLORS, () => {
     configService.set('pretext', '');
     refreshDisplay();
   }, { bg: '#c62828' });
-  introClearBtn.top = 10;
+  introClearBtn.top = 12;
   introClearBtn.left = 64;
 
   const introPathText = blessed.text({
     parent: box,
-    top: 11,
+    top: 13,
     left: 22,
     right: 2,
     wrap: false,
@@ -1334,7 +1438,7 @@ export function createSettingsTab(screen, services) {
     parent: box,
     top: 3,
     left: 2,
-    content: '{#7986cb-fg} 📡 Audio Destination {/#7986cb-fg}',
+    content: '{bright-cyan-fg} 📡 Audio Destination {/bright-cyan-fg}',
     tags: true,
     style: { bg: COLORS.contentBg },
   });
@@ -1463,7 +1567,7 @@ export function createSettingsTab(screen, services) {
     const current = configService.getConfig().audio_stream_mode ?? 'text';
     configService.set('audio_stream_mode', current === 'text' ? 'pulse' : 'text');
     refreshDisplay();
-  }, { bg: '#2e7d32' });  // green = recommended
+  }, { bg: '#1565c0' });  // blue — distinct from green focus
   audioStreamModeBtn.top = 7;
   audioStreamModeBtn.left = 64;
   audioStreamModeBtn.hide();
@@ -1487,7 +1591,7 @@ export function createSettingsTab(screen, services) {
     parent: box,
     top: 11,
     left: 2,
-    content: '{#7986cb-fg} 💾 Config Storage {/#7986cb-fg}',
+    content: '{bright-cyan-fg} 💾 Config Storage {/bright-cyan-fg}',
     tags: true,
     style: { bg: COLORS.contentBg },
   });
@@ -1553,7 +1657,7 @@ export function createSettingsTab(screen, services) {
       refreshConfigDisplay();
       _showNotice(screen, 'Settings Saved');
     }, () => { _currentIdx = _buttons.indexOf(saveLocallyBtn); _focusButton(saveLocallyBtn); });
-  }, { bg: '#2e7d32' });   // green
+  }, { bg: '#1565c0' });   // blue — distinct from green focus
   saveLocallyBtn.bottom = 0;
   saveLocallyBtn.left = 46;
 
@@ -1581,6 +1685,7 @@ export function createSettingsTab(screen, services) {
   // Widget groups for each sub-tab (used by _showSubTab to show/hide)
   const _subTabWidgets = {
     voice: [
+      providerVoiceHeader,
       providerLabel, providerValue, switchBtn,
       voiceLabel, voiceValue, changeBtn, playBtn, voiceFileText,
     ],
@@ -1592,6 +1697,7 @@ export function createSettingsTab(screen, services) {
       volumeLabel, volumeValue, volumeChangeBtn,
     ],
     personality: [
+      styleHeader,
       verbosityLabel, verbosityValue, verbosityChangeBtn, verbosityPathText,
       personalityLabel, personalityValue, personalityChangeBtn, personalityTestBtn, personalityFileText,
       introTextHeader,
@@ -2052,7 +2158,7 @@ export function createSettingsTab(screen, services) {
       audioSshValue.setContent(audioAlias || '(none)');
       const streamMode = cfg.audio_stream_mode ?? 'text';
       audioStreamModeBtn.setContent(streamMode === 'pulse' ? 'Streaming Pulse Audio' : 'Streaming Text Only ✓');
-      audioStreamModeBtn.style.bg = streamMode === 'text' ? '#2e7d32' : COLORS.btnChange;
+      audioStreamModeBtn.style.bg = streamMode === 'text' ? '#1565c0' : COLORS.btnChange;
     } else {
       audioSshLabel.hide();
       audioSshValue.hide();
@@ -2223,14 +2329,14 @@ function _createButton(parent, screen, label, COLORS, onClick, opts = {}) {
 const _ALL_PROVIDERS = [
   { id: 'piper',        name: 'Piper TTS',    platforms: ['linux', 'darwin', 'win32'], desc: 'High-quality local neural TTS' },
   { id: 'soprano',      name: 'Soprano',      platforms: ['linux', 'darwin'],          desc: 'Ultra-fast neural TTS (single voice)' },
-  { id: 'windows-sapi', name: 'Windows SAPI', platforms: ['win32'],                   desc: 'Windows built-in text-to-speech' },
+  { id: 'sapi',         name: 'Windows SAPI', platforms: ['win32'],                   desc: 'Windows built-in text-to-speech' },
   { id: 'macos',        name: 'Mac Say',      platforms: ['darwin'],                  desc: 'macOS built-in text-to-speech' },
 ];
 
 const _INSTALL_CMDS = {
   piper:          ['pip install piper-tts', 'OR:   pipx install piper-tts', '', 'Voices are downloaded separately:', 'Run: agentvibes install  (then choose Piper)'],
   soprano:        ['pip install soprano-tts', 'OR:   pipx install soprano-tts', '', 'Keep model loaded for fast synthesis:', 'soprano-webui'],
-  'windows-sapi': ['Built-in on Windows — no install required.', 'Only works in a native Windows shell,', 'not inside WSL. Use piper or soprano in WSL.'],
+  sapi:           ['Built-in on Windows — no install required.', 'Only works in a native Windows shell,', 'not inside WSL. Use piper or soprano in WSL.'],
   macos:          ['Built-in on macOS — no install required.', 'The say command ships with every Mac.'],
 };
 
@@ -2275,7 +2381,7 @@ function _openProviderPicker(screen, providerService, onSelect, onClose) {
   // Environment header
   blessed.text({
     parent: modal, top: 0, left: 1, tags: true,
-    content: `{#00e5ff-fg}🖥  Environment:{/#00e5ff-fg} {bold}${envLabel}{/bold}`,
+    content: `{bright-cyan-fg}🖥  Environment:{/bright-cyan-fg} {bold}${envLabel}{/bold}`,
     style: { bg: COLORS.contentBg },
   });
   blessed.text({
@@ -2325,8 +2431,8 @@ function _openProviderPicker(screen, providerService, onSelect, onClose) {
         _close(); onSelect(prov.id);
       } else {
         const lines = _INSTALL_CMDS[prov.id] ?? ['No instructions available.'];
-        instrTitle.setContent(`{#7986cb-fg}Install — ${prov.name}:{/#7986cb-fg}`);
-        instrContent.setContent(lines.map(l => l ? `{#00e5ff-fg}${l}{/#00e5ff-fg}` : '').join('\n'));
+        instrTitle.setContent(`{bright-cyan-fg}Install — ${prov.name}:{/bright-cyan-fg}`);
+        instrContent.setContent(lines.map(l => l ? `{bright-cyan-fg}${l}{/bright-cyan-fg}` : '').join('\n'));
         screen.render();
       }
     });
@@ -2340,7 +2446,7 @@ function _openProviderPicker(screen, providerService, onSelect, onClose) {
 
   const instrTitle = blessed.text({
     parent: modal, top: 11, left: 1, width: 66, tags: true,
-    content: '{#7986cb-fg}Install instructions — click Install beside a provider:{/#7986cb-fg}',
+    content: '{bright-cyan-fg}Install instructions — click Install beside a provider:{/bright-cyan-fg}',
     style: { bg: COLORS.contentBg },
   });
   const instrContent = blessed.text({
@@ -2452,7 +2558,7 @@ function _showSavePreview(screen, filePath, data, onConfirm, onClose) {
     style: {
       fg: '#e3f2fd',
       bg: COLORS.contentBg,
-      border: { fg: '#00e5ff' },
+      border: { fg: 'bright-cyan' },
     },
   });
 
@@ -2471,7 +2577,7 @@ function _showSavePreview(screen, filePath, data, onConfirm, onClose) {
   const okBtn = _createButton(modal, screen, 'OK — Save', COLORS, () => {
     _close();
     onConfirm();
-  }, { bg: '#2e7d32' });
+  }, { bg: '#1565c0' });
   okBtn.top  = btnRow;
   okBtn.left = midX + 2;
 
@@ -2540,7 +2646,7 @@ function _openTrackPicker(screen, configService, onSelect, onClose) {
   const currentTrack = (configService.getConfig().backgroundMusic?.track ?? MUSIC_DEFAULTS.track);
   const items = allItems.map(t =>
     t.file === ADD_SENTINEL
-      ? `  {#00e5ff-fg}+ Add Custom Track{/#00e5ff-fg}`
+      ? `  {bright-cyan-fg}+ Add Custom Track{/bright-cyan-fg}`
       : (t.file === currentTrack ? `● ${t.label}` : `  ${t.label}`)
   );
   const currentIdx = tracks.findIndex(t => t.file === currentTrack);
@@ -2779,9 +2885,14 @@ function _openVolumePicker(screen, configService, onSelect, onClose) {
       `mpg123 -q "${trackPath}"`,
     ].join(' 2>/dev/null || ') + ' 2>/dev/null';
 
-    _previewProcess = spawn('sh', ['-c', cmd], {
-      stdio: 'ignore', detached: true, env: _previewEnv,
-    });
+    if (_IS_WINDOWS) {
+      const _mp3P3 = detectMp3Player(_previewEnv);
+      _previewProcess = _mp3P3
+        ? spawn(_mp3P3.bin, _mp3P3.args(trackPath), _spawnOpts(_previewEnv))
+        : null;
+    } else {
+      _previewProcess = spawn('sh', ['-c', cmd], _spawnOpts(_previewEnv));
+    }
     _previewProcess.unref();
     _refreshList();
 
@@ -2917,7 +3028,7 @@ function _openMusicBrowserModal(screen, configService, navigationService, onDone
       fg: COLORS.labelFg,
       bg: COLORS.contentBg,
       border: { fg: COLORS.borderFg },
-      selected: { bg: '#1a237e', fg: '#00e5ff', bold: true },
+      selected: { bg: '#2e7d32', fg: '#ffffff', bold: true },
       item: { fg: COLORS.labelFg },
     },
   });
@@ -2930,7 +3041,7 @@ function _openMusicBrowserModal(screen, configService, navigationService, onDone
     right: 2,
     tags: true,
     content: '',
-    style: { fg: '#00e5ff', bg: COLORS.contentBg },
+    style: { fg: 'bright-cyan', bg: COLORS.contentBg },
   });
 
   // ---- File location hint ----
@@ -3024,15 +3135,16 @@ function _openMusicBrowserModal(screen, configService, navigationService, onDone
 
     const _mp3Player = detectMp3Player(_modalEnv);
     if (!_mp3Player) return;
+    const _isWin = process.platform === 'win32' && !process.env.WSL_DISTRO_NAME;
     _previewProcess = spawn(_mp3Player.bin, _mp3Player.args(trackPath), {
-      stdio: 'ignore', detached: true, env: _modalEnv,
+      stdio: 'ignore', detached: !_isWin, windowsHide: true, env: _modalEnv,
     });
     _previewProcess.unref();
     _previewTrackId = trackId;
 
     const label = _allTracks.find(t => t.id === trackId)?.label ?? formatTrackLabel(trackId);
     if (!_closed) {
-      modalPreviewLine.setContent(`{#00e5ff-fg}\u266A Previewing: ${label}  (Space to stop){/#00e5ff-fg}`);
+      modalPreviewLine.setContent(`{bright-cyan-fg}\u266A Previewing: ${label}  (Space to stop){/bright-cyan-fg}`);
       screen.render();
     }
 
@@ -3327,7 +3439,7 @@ function _openVoiceBrowserModal(screen, providerService, configService, navigati
     keys: true,
     style: {
       fg: COLORS.valueFg,
-      bg: '#1a237e',
+      bg: '#1a3a5c',
       focus: { bg: '#283593' },
     },
   });
@@ -3337,7 +3449,7 @@ function _openVoiceBrowserModal(screen, providerService, configService, navigati
     parent: modal,
     top: 2,
     left: 6,
-    content: `{#7986cb-fg}${'Name'.padEnd(COL_NAME_W)}${'Gender'.padEnd(COL_GENDER_W)}Provider{/#7986cb-fg}`,
+    content: `{bright-cyan-fg}${'Name'.padEnd(COL_NAME_W)}${'Gender'.padEnd(COL_GENDER_W)}Provider{/bright-cyan-fg}`,
     tags: true,
     style: { bg: COLORS.contentBg },
   });
@@ -3358,7 +3470,7 @@ function _openVoiceBrowserModal(screen, providerService, configService, navigati
       fg: COLORS.labelFg,
       bg: COLORS.contentBg,
       border: { fg: COLORS.borderFg },
-      selected: { bg: '#1a237e', fg: '#00e5ff', bold: true },
+      selected: { bg: '#2e7d32', fg: '#ffffff', bold: true },
       item: { fg: COLORS.labelFg },
     },
   });
@@ -3368,7 +3480,7 @@ function _openVoiceBrowserModal(screen, providerService, configService, navigati
     parent: modal,
     bottom: 5,
     left: 2,
-    content: `{#7986cb-fg}── Voice Info ${'─'.repeat(50)}{/#7986cb-fg}`,
+    content: `{bright-cyan-fg}── Voice Info ${'─'.repeat(50)}{/bright-cyan-fg}`,
     tags: true,
     style: { bg: COLORS.contentBg },
   });
@@ -3390,7 +3502,7 @@ function _openVoiceBrowserModal(screen, providerService, configService, navigati
     right: 2,
     tags: true,
     content: '',
-    style: { fg: '#00e5ff', bg: COLORS.contentBg },
+    style: { fg: 'bright-cyan', bg: COLORS.contentBg },
   });
 
   // ---- Key hint bar ----
@@ -3495,11 +3607,22 @@ function _openVoiceBrowserModal(screen, providerService, configService, navigati
     const tempWav = path.join(os.tmpdir(), `agentvibes-preview-${Date.now()}.wav`);
     const phrase  = SAMPLE_PHRASES[Math.floor(Math.random() * SAMPLE_PHRASES.length)];
 
+    const _isWinPreview = process.platform === 'win32' && !process.env.WSL_DISTRO_NAME;
+    let _piperBin3 = 'piper';
+    if (_isWinPreview) {
+      const _lad = process.env.LOCALAPPDATA ||
+        (process.env.USERPROFILE ? path.join(process.env.USERPROFILE, 'AppData', 'Local') : null);
+      if (_lad) {
+        const _exe = path.join(_lad, 'Programs', 'Piper', 'piper.exe');
+        if (fs.existsSync(_exe)) _piperBin3 = _exe;
+      }
+    }
     const _piperArgs3 = ['--model', voicePath, '--output_file', tempWav];
     if (_ms3.speakerId != null) _piperArgs3.push('--speaker', String(_ms3.speakerId));
-    const piper = spawn('piper', _piperArgs3, {
+    const piper = spawn(_piperBin3, _piperArgs3, {
       stdio: ['pipe', 'ignore', 'ignore'],
-      detached: true,
+      detached: !_isWinPreview,
+      windowsHide: true,
       env: _spawnEnv,
     });
     piper.stdin.write(phrase + '\n');
@@ -3508,7 +3631,7 @@ function _openVoiceBrowserModal(screen, providerService, configService, navigati
     _playingProcess = piper;
     _playingVoiceId = voiceId;
     if (!_closed) {
-      modalPreviewLine.setContent(`{#00e5ff-fg}♪ Synthesizing: ${voiceId}…{/#00e5ff-fg}`);
+      modalPreviewLine.setContent(`{bright-cyan-fg}♪ Synthesizing: ${voiceId}…{/bright-cyan-fg}`);
       screen.render();
     }
 
@@ -3521,7 +3644,7 @@ function _openVoiceBrowserModal(screen, providerService, configService, navigati
         _playingVoiceId = null;
         _playingProcess = null;
         if (!_closed) {
-          modalPreviewLine.setContent('{#00e5ff-fg}♪ Preview failed (piper error — is piper installed?){/#00e5ff-fg}');
+          modalPreviewLine.setContent('{bright-cyan-fg}♪ Preview failed (piper error — is piper installed?){/bright-cyan-fg}');
           screen.render();
           setTimeout(() => { if (!_closed) { modalPreviewLine.setContent(''); screen.render(); } }, 4000);
         }
@@ -3532,13 +3655,14 @@ function _openVoiceBrowserModal(screen, providerService, configService, navigati
       if (!_wavPlayer3) return;
       const playProc = spawn(_wavPlayer3.bin, _wavPlayer3.args(tempWav), {
         stdio: 'ignore',
-        detached: true,
+        detached: !_isWinPreview,
+        windowsHide: true,
         env: _spawnEnv,
       });
       _playingProcess = playProc;
 
       if (!_closed) {
-        modalPreviewLine.setContent(`{#00e5ff-fg}♪ Playing: ${voiceId}  (Space to stop){/#00e5ff-fg}`);
+        modalPreviewLine.setContent(`{bright-cyan-fg}♪ Playing: ${voiceId}  (Space to stop){/bright-cyan-fg}`);
         screen.render();
       }
 
@@ -3563,7 +3687,7 @@ function _openVoiceBrowserModal(screen, providerService, configService, navigati
       _playingVoiceId = null;
       _playingProcess = null;
       if (!_closed) {
-        modalPreviewLine.setContent('{#00e5ff-fg}♪ Cannot find piper — install with: pipx install piper-tts{/#00e5ff-fg}');
+        modalPreviewLine.setContent('{bright-cyan-fg}♪ Cannot find piper — install with: pipx install piper-tts{/bright-cyan-fg}');
         screen.render();
         setTimeout(() => { if (!_closed) { modalPreviewLine.setContent(''); screen.render(); } }, 4000);
       }