agentvibes 4.0.0 → 4.2.0

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

@@ -1,14 +1,34 @@
 /**
- * AgentVibes TUI Console — Agents Tab
- * Epic 11: Stories 11.1-11.5
+ * AgentVibes TUI Console — Agents Tab (BMAD Integration)
  *
  * Implements the Tab Component Contract:
  *   createAgentsTab(screen, services) → { box, show, hide, onFocus, onBlur, getFooterText, getFooterColor }
  *
- * Features: BMAD agent list, voice assignments, party mode toggle, single-voice warning.
+ * Two states:
+ *   1. No BMAD detected → onboarding screen with description, links, install command
+ *   2. BMAD detected → agent table with per-agent voice/pretext/reverb/personality/music customization
  */
 
-import { AgentVoiceStore, scanBmadAgents, isSingleVoiceProvider } from '../../services/agent-voice-store.js';
+import { AgentVoiceStore, scanBmadAgents, isBmadDetected, isSingleVoiceProvider } from '../../services/agent-voice-store.js';
+import { openReverbPicker, REVERB_PRESETS } from '../widgets/reverb-picker.js';
+import { openPersonalityPicker, PERSONALITIES, PERSONALITY_EMOJIS } from '../widgets/personality-picker.js';
+import { openTrackPicker, openVolumeInput } from '../widgets/track-picker.js';
+import { formatReverbState, formatTrackName, formatVoiceName } from '../widgets/format-utils.js';
+import {
+  PIPER_VOICES_DIR, SAMPLE_PHRASES,
+  parseMultiSpeaker, scanInstalledVoices, getVoiceMeta,
+} from './voices-tab.js';
+import { buildAudioEnv, detectWavPlayer } from '../audio-env.js';
+import { destroyList } from '../widgets/destroy-list.js';
+import { BRAND_PINK } from '../brand-colors.js';
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+
+// Max pretext length to prevent excessively long TTS utterances
+const MAX_PRETEXT_LENGTH = 200;
 
 const IS_TEST = process.env.AGENTVIBES_TEST_MODE === 'true';
 
@@ -22,21 +42,39 @@ if (!IS_TEST) {
 
 const COLORS = {
   contentBg:  '#0a0e1a',
-  sectionHdr: '#7b1fa2',  // Purple — section headers for Agents tab
+  sectionHdr: '#7b1fa2',
   labelFg:    '#e3f2fd',
-  valueFg:    '#ffff00',  // Yellow
-  activeFg:   '#ce93d8',  // Light purple — selected agent
-  btnDefault: '#6a1b9a',  // Purple — Agents tab buttons
+  valueFg:    '#ffff00',
+  activeFg:   '#ce93d8',
+  btnDefault: '#6a1b9a',
   btnFocus:   '#9c27b0',
   btnFocusFg: '#ffffff',
   btnPress:   '#ff00ff',
   borderFg:   '#9c27b0',
-  footerBg:   '#9c27b0',  // Purple — Agents tab footer
+  footerBg:   '#9c27b0',
   noticeFg:   '#90a4ae',
   warnFg:     '#ff9800',
+  linkFg:     '#00e5ff',
 };
 
-const FOOTER_TEXT = '[↑↓/jk] Navigate  [Enter] Details  [R] Reset Voice  [P] Party Mode  [S/V/M/A/R] Tab  [Q] Quit';
+const FOOTER_TEXT_BMAD   = '[↑↓/jk] Navigate  [Space] Preview  [Enter] Configure  [A] Auto-assign  [B] Bulk  [X] Reset  [Q] Quit';
+const FOOTER_TEXT_NOBMAD = '[Tab] Switch Tab  [Q] Quit';
+
+const _modalTitle = (text) => ` {${BRAND_PINK}-fg}${text}{/${BRAND_PINK}-fg} `;
+
+// Column widths for agent table
+const COL_ICON     = 4;
+const COL_NAME     = 16;
+const COL_VOICE    = 12;  // beautified names avg 5-11 chars
+const COL_GENDER   = 8;
+const COL_PROVIDER = 12;
+const COL_PRETEXT  = 14;
+const COL_REVERB   = 10;
+const COL_MUSIC    = 11;
+const COL_VOL      = 5;   // e.g. "70%" or "100%"
+
+// Inline hint appended to the selected row when list is focused
+const _ROW_HINT_BMAD = `  {bright-black-fg}[Space] Preview  [Enter] Configure{/bright-black-fg}`;
 
 // ---------------------------------------------------------------------------
 
@@ -47,28 +85,74 @@ function createTestStub() {
     hide: () => {},
     onFocus: () => {},
     onBlur: () => {},
-    getFooterText: () => FOOTER_TEXT,
+    getFooterText: () => FOOTER_TEXT_BMAD,
     getFooterColor: () => COLORS.footerBg,
   };
 }
 
+// ---------------------------------------------------------------------------
+// No-BMAD onboarding content
+
+const ONBOARDING_TEXT = `{bold}{#ce93d8-fg}🧙 BMAD Agents{/#ce93d8-fg}{/bold}
+
+{bold}What is BMAD?{/bold}
+
+The BMad Method (Build More Architect Dreams) is an AI-driven development
+framework module within the BMad Method Ecosystem that helps you build
+software through the whole process from ideation and planning all the way
+through agentic implementation. It provides specialized AI agents, guided
+workflows, and intelligent planning that adapts to your project's
+complexity, whether you're fixing a bug or building an enterprise platform.
+
+If you're comfortable working with AI coding assistants like Claude,
+Cursor, or GitHub Copilot, you're ready to get started.
+
+
+{bold}Install BMAD in your project:{/bold}
+
+  {#00e5ff-fg}npx bmad-method install{/#00e5ff-fg}
+
+
+{bold}Learn more:{/bold}
+
+  {#00e5ff-fg}https://docs.bmad-method.org/{/#00e5ff-fg}
+  {#00e5ff-fg}https://github.com/bmad-code-org/BMAD-METHOD{/#00e5ff-fg}
+
+
+{#90a4ae-fg}Once BMAD is installed, this tab will show all your agents and let you
+customize each agent's voice, pretext, reverb, personality, and background
+music independently.{/#90a4ae-fg}`;
+
 // ---------------------------------------------------------------------------
 
 /**
  * Create the Agents tab component.
- *
- * @param {object} screen   - Blessed screen instance (or test stub)
- * @param {object} services
- * @param {import('../../services/config-service.js').ConfigService}   services.configService
- * @param {import('../../services/provider-service.js').ProviderService} services.providerService
- * @returns {{ box, show, hide, onFocus, onBlur, getFooterText, getFooterColor }}
  */
 export function createAgentsTab(screen, services) {
   if (IS_TEST) return createTestStub();
 
-  const { configService, providerService, focusMainTabBar } = services;
+  const { configService, providerService, focusMainTabBar, navigationService } = services;
   const voiceStore = new AgentVoiceStore();
 
+  // Capture cwd once at construction (L1 fix)
+  const _projectRoot = process.cwd();
+
+  let _bmadDetected = false;
+  let _agents = [];
+  let _playingProcess = null;
+  let _playGeneration = 0; // H4: generation counter to prevent orphaned processes
+
+  /**
+   * Create a secure temp file path using XDG_RUNTIME_DIR or user-specific dir (H3 fix).
+   */
+  function _secureTempWav(prefix) {
+    const baseDir = process.env.XDG_RUNTIME_DIR || os.tmpdir();
+    const dir = path.join(baseDir, `agentvibes-${process.getuid?.() ?? 'u'}`);
+    fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    try { fs.chmodSync(dir, 0o700); } catch {}
+    return path.join(dir, `${prefix}-${crypto.randomUUID()}.wav`);
+  }
+
   // -------------------------------------------------------------------------
   // Container
 
@@ -85,17 +169,48 @@ export function createAgentsTab(screen, services) {
   });
 
   // -------------------------------------------------------------------------
-  // Section header
+  // Onboarding content (no-BMAD state)
+
+  const onboardingBox = blessed.box({
+    parent: box,
+    top: 1,
+    left: 3,
+    right: 3,
+    bottom: 1,
+    hidden: true,
+    tags: true,
+    scrollable: true,
+    keys: true,
+    vi: true,
+    mouse: true,
+    content: ONBOARDING_TEXT,
+    style: { fg: COLORS.labelFg, bg: COLORS.contentBg },
+  });
+
+  // -------------------------------------------------------------------------
+  // BMAD state — section header
 
-  blessed.text({
+  const sectionHeader = blessed.text({
     parent: box,
     top: 1,
     left: 2,
+    hidden: true,
     content: `{#7b1fa2-fg}── BMAD Agents ${'─'.repeat(53)}{/#7b1fa2-fg}`,
     tags: true,
     style: { bg: COLORS.contentBg },
   });
 
+  // Column header
+  const columnHeader = blessed.text({
+    parent: box,
+    top: 2,
+    left: 4,
+    hidden: true,
+    tags: true,
+    content: `{#90a4ae-fg}${''.padEnd(COL_ICON)}${' Agent'.padEnd(COL_NAME)}${' Voice'.padEnd(COL_VOICE)}${' Gender'.padEnd(COL_GENDER)}${' Provider'.padEnd(COL_PROVIDER)}${' Reverb'.padEnd(COL_REVERB)}${' Music'.padEnd(COL_MUSIC)}${' Vol'.padEnd(COL_VOL)}  Pretext{/#90a4ae-fg}`,
+    style: { bg: COLORS.contentBg },
+  });
+
   // -------------------------------------------------------------------------
   // Agent list
 
@@ -105,9 +220,11 @@ export function createAgentsTab(screen, services) {
     left: 2,
     width: '96%',
     height: '55%',
+    hidden: true,
     keys: true,
     vi: true,
     mouse: true,
+    tags: true,
     border: { type: 'line' },
     scrollbar: { ch: '│', style: { fg: COLORS.sectionHdr } },
     style: {
@@ -122,10 +239,11 @@ export function createAgentsTab(screen, services) {
   // -------------------------------------------------------------------------
   // Status panel
 
-  blessed.text({
+  const statusDivider = blessed.text({
     parent: box,
     top: '64%',
     left: 2,
+    hidden: true,
     content: `{#7b1fa2-fg}── Status ${'─'.repeat(58)}{/#7b1fa2-fg}`,
     tags: true,
     style: { bg: COLORS.contentBg },
@@ -135,6 +253,7 @@ export function createAgentsTab(screen, services) {
     parent: box,
     top: '69%',
     left: 2,
+    hidden: true,
     tags: true,
     content: '',
     style: { fg: COLORS.labelFg, bg: COLORS.contentBg },
@@ -144,11 +263,23 @@ export function createAgentsTab(screen, services) {
     parent: box,
     top: '74%',
     left: 2,
+    hidden: true,
     tags: true,
     content: '',
     style: { fg: COLORS.warnFg, bg: COLORS.contentBg },
   });
 
+  // Hint shown inline next to the action buttons at bottom of list
+  const hintLine = blessed.text({
+    parent: box,
+    bottom: 5,
+    left: 4,
+    hidden: true,
+    tags: true,
+    content: '{#546e7a-fg}[Space] Preview  [Enter] Configure  [X] Reset  [A] Auto-assign  [B] Bulk Edit{/#546e7a-fg}',
+    style: { bg: COLORS.contentBg },
+  });
+
   // -------------------------------------------------------------------------
   // Buttons
 
@@ -159,6 +290,7 @@ export function createAgentsTab(screen, services) {
       mouse: true,
       keys: true,
       shrink: true,
+      hidden: true,
       padding: { left: 1, right: 1 },
       style: {
         bg: COLORS.btnDefault,
@@ -191,82 +323,1056 @@ export function createAgentsTab(screen, services) {
     return btn;
   }
 
-  const resetBtn = _createBtn('[R] Reset Voice', () => {
-    const agents = _agents;
-    const agent = agents[agentList.selected];
+  const resetBtn = _createBtn('[X] Reset', () => {
+    const agent = _agents[agentList.selected];
     if (agent) {
-      voiceStore.resetVoice(agent.id);
+      voiceStore.resetAgentProfile(agent.id);
       refreshDisplay();
     }
   });
   resetBtn.bottom = 4;
   resetBtn.left = 4;
 
-  const partyBtn = _createBtn('[P] Party Mode', () => {
-    const current = voiceStore.getPartyMode();
-    voiceStore.setPartyMode(!current);
-    refreshDisplay();
-  });
-  partyBtn.bottom = 4;
-  partyBtn.left = 24;
+  const autoAssignBtn = _createBtn('[A] Auto-assign', () => _autoAssignAll());
+  autoAssignBtn.bottom = 4;
+  autoAssignBtn.left = 18;
+
+  const bulkEditBtn = _createBtn('[B] Bulk Edit', () => _openBulkEditMenu());
+  bulkEditBtn.bottom = 4;
+  bulkEditBtn.left = 36;
 
   // -------------------------------------------------------------------------
-  // State
+  // Show/hide helpers for the two states
 
-  let _agents = [];
+  const _bmadWidgets = [sectionHeader, columnHeader, agentList, hintLine, resetBtn, autoAssignBtn, bulkEditBtn];
+
+  function _showBmadState() {
+    onboardingBox.hide();
+    for (const w of _bmadWidgets) w.show();
+  }
 
-  function _buildListItems(agents, voiceMap) {
+  function _showOnboardingState() {
+    for (const w of _bmadWidgets) w.hide();
+    onboardingBox.show();
+  }
+
+  // -------------------------------------------------------------------------
+  // Build table row items
+
+  function _buildListItems(agents) {
     if (agents.length === 0) {
-      return [' (no BMAD agents detected — open a project with .bmad/ or _bmad/)'];
+      return [' (no BMAD agents detected)'];
     }
     return agents.map(a => {
-      const voice = voiceMap[a.id] ?? '(default)';
-      return ` ${a.displayName.padEnd(20)} → ${voice}`;
+      const profile = voiceStore.getAgentProfile(a.id);
+      // Strip variation selectors (e.g. U+FE0F on 🏗️) so padEnd uses visual width
+      const rawIcon = (a.icon || '').replace(/\uFE0F/g, '');
+      const icon = (rawIcon ? `${rawIcon} ` : '   ').padEnd(COL_ICON);
+      const name = ` ${a.displayName}`.padEnd(COL_NAME).slice(0, COL_NAME);
+      const voiceRaw = formatVoiceName(profile.voice);
+      const voice = (' ' + voiceRaw).padEnd(COL_VOICE).slice(0, COL_VOICE);
+      const meta = profile.voice ? getVoiceMeta(profile.voice) : { gender: '—', provider: '—' };
+      const gender = (' ' + meta.gender).padEnd(COL_GENDER).slice(0, COL_GENDER);
+      const provider = (' ' + meta.provider).padEnd(COL_PROVIDER).slice(0, COL_PROVIDER);
+      const reverb = (' ' + (profile.reverbPreset || '(global)')).padEnd(COL_REVERB).slice(0, COL_REVERB);
+      const music = (' ' + (profile.backgroundMusic?.track
+        ? formatTrackName(profile.backgroundMusic.track)
+        : '(global)')).padEnd(COL_MUSIC).slice(0, COL_MUSIC);
+      const vol = profile.backgroundMusic?.enabled
+        ? ` ${profile.backgroundMusic.volume ?? 70}%`.padEnd(COL_VOL)
+        : '  —  ';
+      const pretext = ' ' + (profile.pretext || '(default)').slice(0, COL_PRETEXT - 1);
+      return ` ${icon}${name}${voice}${gender}${provider}${reverb}${music}${vol}  ${pretext}`;
     });
   }
 
+  // -------------------------------------------------------------------------
+  // Refresh display
+
   function refreshDisplay() {
-    _agents = scanBmadAgents(process.cwd());
-    const voiceMap = voiceStore.getVoiceMap();
-    const partyMode = voiceStore.getPartyMode();
-    const provider = providerService.getProvider?.() ?? configService.getConfig().provider ?? 'piper';
-    const singleVoice = isSingleVoiceProvider(provider);
+    _bmadDetected = isBmadDetected(_projectRoot);
+    _agents = scanBmadAgents(_projectRoot);
+
+    if (!_bmadDetected) {
+      _showOnboardingState();
+      screen.render();
+      return;
+    }
+
+    _showBmadState();
 
-    const items = _buildListItems(_agents, voiceMap);
+    const items = _buildListItems(_agents);
     agentList.setItems(items);
 
-    statusLine.setContent(
-      `  Party Mode: ${partyMode ? 'Enabled' : 'Disabled'}  |  Provider: ${provider}  |  Agents: ${_agents.length}`
-    );
+    if (_listFocused) {
+      _hintIdx = -1;
+      _hintBase = '';
+      _updateHint(agentList.selected ?? 0);
+    }
+
+    screen.render();
+  }
+
+  // -------------------------------------------------------------------------
+  // Temporary "Saved!" toast notification
+
+  function _showSavedToast(agentName) {
+    const toast = blessed.box({
+      parent: screen,
+      top: 'center',
+      left: 'center',
+      width: 34,
+      height: 3,
+      border: { type: 'line' },
+      tags: true,
+      content: `  {green-fg}{bold}✓ ${agentName} saved!{/bold}{/green-fg}`,
+      style: { fg: '#e3f2fd', bg: '#1b5e20', border: { fg: '#4caf50' } },
+    });
+    toast.setFront();
+    screen.render();
+    setTimeout(() => {
+      toast.destroy();
+      try {
+        for (let r = 0; r < screen.height; r++)
+          for (let c = 0; c < screen.width; c++)
+            if (screen.olines[r]?.[c]) screen.olines[r][c][0] = -1;
+      } catch {}
+      screen.render();
+    }, 1500);
+  }
+
+  // -------------------------------------------------------------------------
+  // Row spinner (animated braille while preview is playing)
+
+  const _SPIN_PFX = '{#00e5ff-fg}';
+  const _SPIN_SFX = '{/#00e5ff-fg}';
+  const _SPIN_PFX_TOTAL_LEN = _SPIN_PFX.length + 1 + _SPIN_SFX.length; // tag + 1 frame char + close tag
+  const _SPIN_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+  let _spinnerInterval  = null;
+  let _spinnerFrameIdx  = 0;
+  let _spinnerAgentIdx  = -1;
+
+  // Strip the spinner prefix (tag+frame+close or plain first char) to get the row tail.
+  function _stripSpinnerPfx(c) {
+    return c.startsWith(_SPIN_PFX) ? c.slice(_SPIN_PFX_TOTAL_LEN) : c.slice(1);
+  }
+
+  function _startSpinner(agentIdx) {
+    _stopSpinner();
+    _spinnerAgentIdx = agentIdx;
+    _spinnerFrameIdx = 0;
+    const items = agentList.items;
+    const item = items[_spinnerAgentIdx];
+    if (item) {
+      item.setContent(`${_SPIN_PFX}${_SPIN_FRAMES[0]}${_SPIN_SFX}${_stripSpinnerPfx(item.content ?? ' ')}`);
+      screen.render();
+    }
+    _spinnerInterval = setInterval(() => {
+      _spinnerFrameIdx = (_spinnerFrameIdx + 1) % _SPIN_FRAMES.length;
+      const it = agentList.items[_spinnerAgentIdx];
+      if (!it) return;
+      it.setContent(`${_SPIN_PFX}${_SPIN_FRAMES[_spinnerFrameIdx]}${_SPIN_SFX}${_stripSpinnerPfx(it.content ?? ' ')}`);
+      screen.render();
+    }, 80);
+  }
+
+  function _stopSpinner() {
+    if (_spinnerInterval) { clearInterval(_spinnerInterval); _spinnerInterval = null; }
+    if (_spinnerAgentIdx >= 0) {
+      const item = agentList.items[_spinnerAgentIdx];
+      if (item) item.setContent(' ' + _stripSpinnerPfx(item.content ?? ' '));
+      _spinnerAgentIdx = -1;
+      screen.render();
+    }
+  }
+
+  // -------------------------------------------------------------------------
+  // Kill any playing preview
+
+  function _killPreview() {
+    _stopSpinner();
+    if (_playingProcess) {
+      try { process.kill(-_playingProcess.pid, 'SIGTERM'); } catch {}
+      _playingProcess = null;
+    }
+  }
+
+  // -------------------------------------------------------------------------
+  // Sample an agent with their full profile (voice + pretext + reverb + music)
+  // Uses play-tts-enhanced.sh for the complete effects pipeline.
+
+  function _sampleAgent(agent) {
+    const profile = voiceStore.getAgentProfile(agent.id);
+    const globalCfg = configService.getConfig();
+    _sampleWithFullProfile(agent, {
+      voice:           profile.voice         || globalCfg.voice || '',
+      pretext:         profile.pretext       || AgentVoiceStore.getDefaultPretext(agent.displayName, agent.title),
+      reverbPreset:    profile.reverbPreset  || globalCfg.effects?.reverbPreset || 'light',
+      personality:     profile.personality   || globalCfg.personality || 'none',
+      backgroundMusic: {
+        track:   profile.backgroundMusic?.track   || globalCfg.backgroundMusic?.track || '',
+        volume:  profile.backgroundMusic?.volume  ?? globalCfg.backgroundMusic?.volume ?? 70,
+        enabled: profile.backgroundMusic?.enabled ?? globalCfg.backgroundMusic?.enabled ?? false,
+      },
+    });
+  }
+
+  // -------------------------------------------------------------------------
+  // Agent detail panel (modal overlay)
+
+  function _openAgentDetailPanel(agent) {
+    const profile = voiceStore.getAgentProfile(agent.id);
+    const globalCfg = configService.getConfig();
+
+    // Working copy of the profile being edited
+    const draft = {
+      voice:           profile.voice         || globalCfg.voice || '',
+      pretext:         profile.pretext       || AgentVoiceStore.getDefaultPretext(agent.displayName, agent.title),
+      reverbPreset:    profile.reverbPreset  || globalCfg.effects?.reverbPreset || 'light',
+      personality:     profile.personality   || globalCfg.personality || 'none',
+      backgroundMusic: {
+        track:   profile.backgroundMusic?.track   || globalCfg.backgroundMusic?.track || '',
+        volume:  profile.backgroundMusic?.volume  ?? globalCfg.backgroundMusic?.volume ?? 70,
+        enabled: profile.backgroundMusic?.enabled ?? globalCfg.backgroundMusic?.enabled ?? false,
+      },
+    };
+
+    let _closed = false;
+    navigationService?.openModal();
+
+    const modal = blessed.box({
+      parent: screen,
+      top: 'center',
+      left: 'center',
+      width: 72,
+      height: 18,
+      border: { type: 'line' },
+      tags: true,
+      label: _modalTitle(`${agent.icon || '🧙'} ${agent.displayName} (${agent.title || 'Agent'})`),
+      style: {
+        fg: COLORS.labelFg,
+        bg: COLORS.contentBg,
+        border: { fg: COLORS.btnFocus },
+      },
+    });
+    modal.setFront();
+
+    // Field definitions
+    const FIELDS = [
+      { key: 'voice',        label: 'Voice',       getValue: () => draft.voice || '(global default)' },
+      { key: 'pretext',      label: 'Pretext',     getValue: () => draft.pretext || '(default)' },
+      { key: 'reverbPreset', label: 'Reverb',      getValue: () => formatReverbState(draft.reverbPreset) },
+      { key: 'personality',  label: 'Personality', getValue: () => {
+        const p = draft.personality;
+        const emoji = PERSONALITY_EMOJIS[p] || '';
+        return `${emoji} ${p === 'none' ? 'None' : p.charAt(0).toUpperCase() + p.slice(1)}`;
+      }},
+      { key: 'music',        label: 'Music',       getValue: () => {
+        if (!draft.backgroundMusic.enabled) return '(disabled)';
+        return `${formatTrackName(draft.backgroundMusic.track)} Vol:${draft.backgroundMusic.volume}%`;
+      }},
+    ];
+
+    // Build field list items
+    function _fieldItems() {
+      return FIELDS.map(f => {
+        const label = f.label.padEnd(14);
+        const val = f.getValue();
+        return `  ${label} ${val}`;
+      });
+    }
+
+    const fieldList = blessed.list({
+      parent: modal,
+      top: 1,
+      left: 2,
+      right: 2,
+      height: FIELDS.length + 2,
+      keys: true,
+      vi: true,
+      mouse: true,
+      border: { type: 'line' },
+      tags: true,
+      style: {
+        fg: COLORS.labelFg,
+        bg: COLORS.contentBg,
+        border: { fg: '#4a148c' },
+        selected: { bg: '#4a148c', fg: COLORS.activeFg, bold: true },
+        item: { fg: COLORS.labelFg },
+      },
+    });
+    fieldList.setItems(_fieldItems());
+
+    // Key hint
+    blessed.text({
+      parent: modal,
+      bottom: 4,
+      left: 2,
+      right: 2,
+      tags: true,
+      content: '{#455a64-fg}[↑↓] Navigate fields  [Enter] Edit field  [Space] Sample  [Esc] Cancel{/#455a64-fg}',
+      style: { bg: COLORS.contentBg },
+    });
+
+    // Buttons
+    function _modalBtn(label, leftPos, onClick) {
+      const btn = blessed.button({
+        parent: modal,
+        content: label,
+        bottom: 2,
+        left: leftPos,
+        mouse: true,
+        keys: true,
+        shrink: true,
+        padding: { left: 1, right: 1 },
+        style: {
+          bg: COLORS.btnDefault,
+          fg: 'white',
+          focus: { bg: '#00e5ff', fg: '#000000', bold: true },
+          hover: { bg: '#00e5ff', fg: '#000000', bold: true },
+        },
+      });
+      btn.on('focus', () => {
+        const raw = btn.content.replace(/[►◄]/g, '').trim();
+        btn.setContent(`►${raw}◄`);
+        screen.render();
+      });
+      btn.on('blur', () => {
+        const raw = btn.content.replace(/[►◄]/g, '').trim();
+        btn.setContent(raw);
+        screen.render();
+      });
+      btn.key(['enter', 'space'], () => onClick());
+      btn.on('click', () => onClick());
+      return btn;
+    }
+
+    const saveBtn = _modalBtn('Save', 4, () => {
+      // Only save fields that differ from global
+      const toSave = {};
+      if (draft.voice && draft.voice !== globalCfg.voice) toSave.voice = draft.voice;
+      if (draft.pretext !== AgentVoiceStore.getDefaultPretext(agent.displayName, agent.title)) toSave.pretext = draft.pretext;
+      if (draft.reverbPreset !== (globalCfg.effects?.reverbPreset || 'light')) toSave.reverbPreset = draft.reverbPreset;
+      if (draft.personality !== (globalCfg.personality || 'none')) toSave.personality = draft.personality;
+      if (draft.backgroundMusic.track !== (globalCfg.backgroundMusic?.track || '') ||
+          draft.backgroundMusic.volume !== (globalCfg.backgroundMusic?.volume ?? 70) ||
+          draft.backgroundMusic.enabled !== (globalCfg.backgroundMusic?.enabled ?? false)) {
+        toSave.backgroundMusic = draft.backgroundMusic;
+      }
+      voiceStore.setAgentProfile(agent.id, toSave);
+      _closeModal();
+      refreshDisplay();
+      // Show temporary "Saved!" toast
+      _showSavedToast(agent.displayName);
+    });
+
+    const resetAllBtn = _modalBtn('Reset to Defaults', 14, () => {
+      voiceStore.resetAgentProfile(agent.id);
+      _closeModal();
+      refreshDisplay();
+    });
+
+    const cancelBtn = _modalBtn('Cancel', 38, _closeModal);
+
+    function _closeModal() {
+      if (_closed) return;
+      _closed = true;
+      _killPreview();
+      navigationService?.closeModal();
+      destroyList(modal, screen);
+    }
+
+    // Field editing via Enter
+    fieldList.key(['enter'], () => {
+      const idx = fieldList.selected;
+      const field = FIELDS[idx];
+      if (!field) return;
+
+      switch (field.key) {
+        case 'voice':
+          _openVoicePickerForAgent(agent, draft, () => {
+            fieldList.setItems(_fieldItems());
+            fieldList.select(idx);
+            fieldList.focus();
+            screen.render();
+          });
+          break;
+
+        case 'pretext':
+          _openPretextEditor(modal, draft, () => {
+            fieldList.setItems(_fieldItems());
+            fieldList.select(idx);
+            fieldList.focus();
+            screen.render();
+          });
+          break;
+
+        case 'reverbPreset':
+          openReverbPicker(screen, draft.reverbPreset, (val) => {
+            draft.reverbPreset = val;
+            fieldList.setItems(_fieldItems());
+            fieldList.select(idx);
+            fieldList.focus();
+            screen.render();
+          }, () => {
+            fieldList.focus();
+            screen.render();
+          }, { applyToEffectsManager: false });
+          break;
+
+        case 'personality':
+          openPersonalityPicker(screen, draft.personality, (val) => {
+            draft.personality = val;
+            fieldList.setItems(_fieldItems());
+            fieldList.select(idx);
+            fieldList.focus();
+            screen.render();
+          }, () => {
+            fieldList.focus();
+            screen.render();
+          });
+          break;
+
+        case 'music':
+          openTrackPicker(screen, draft.backgroundMusic.track, draft.backgroundMusic.volume, (track, volume) => {
+            draft.backgroundMusic.track = track;
+            draft.backgroundMusic.volume = volume;
+            draft.backgroundMusic.enabled = true;
+            fieldList.setItems(_fieldItems());
+            fieldList.select(idx);
+            fieldList.focus();
+            screen.render();
+          }, () => {
+            fieldList.focus();
+            screen.render();
+          });
+          break;
+      }
+    });
+
+    // Space = sample with current draft
+    fieldList.key(['space'], () => {
+      const draftAgent = { ...agent };
+      // Temporarily set profile for sampling
+      _sampleAgentWithDraft(draftAgent, draft);
+    });
+
+    // Escape = close
+    fieldList.key(['escape', 'q'], _closeModal);
+    saveBtn.key(['escape'], _closeModal);
+    resetAllBtn.key(['escape'], _closeModal);
+    cancelBtn.key(['escape'], _closeModal);
+
+    // Tab navigation within modal
+    fieldList.key(['tab'], () => { saveBtn.focus(); screen.render(); });
+    saveBtn.key(['tab'], () => { resetAllBtn.focus(); screen.render(); });
+    resetAllBtn.key(['tab'], () => { cancelBtn.focus(); screen.render(); });
+    cancelBtn.key(['tab'], () => { fieldList.focus(); screen.render(); });
+
+    fieldList.focus();
+    screen.render();
+  }
+
+  // -------------------------------------------------------------------------
+  // Voice picker for agent detail panel
+
+  function _openVoicePickerForAgent(agent, draft, onDone) {
+    let _allVoices = [];
+    let _filterText = '';
+    let _previewProc = null;
+    let _previewVoiceId = null;
+    let _vpClosed = false;
+
+    const _spawnEnv = buildAudioEnv();
 
-    warningLine.setContent(
-      partyMode && singleVoice
-        ? `  ⚠ Provider has only 1 voice — all agents sound the same`
-        : ''
-    );
+    function _killVP() {
+      if (_previewProc) {
+        try { process.kill(-_previewProc.pid, 'SIGTERM'); } catch {}
+        _previewProc = null;
+      }
+      _previewVoiceId = null;
+    }
+
+    function _closeVP() {
+      if (_vpClosed) return;
+      _vpClosed = true;
+      _killVP();
+      destroyList(vpModal, screen, onDone);
+    }
+
+    const vpModal = blessed.box({
+      parent: screen,
+      top: '6%',
+      left: '3%',
+      width: '94%',
+      height: '88%',
+      border: { type: 'line' },
+      tags: true,
+      label: _modalTitle(`Select Voice for ${agent.icon || ''} ${agent.displayName}`),
+      style: {
+        fg: COLORS.labelFg,
+        bg: COLORS.contentBg,
+        border: { fg: '#00e5ff' },
+      },
+    });
+    vpModal.setFront();
+
+    // Search
+    blessed.text({
+      parent: vpModal, top: 1, left: 2,
+      content: 'Search:', style: { fg: COLORS.labelFg, bg: COLORS.contentBg },
+    });
+    const vpSearch = blessed.textbox({
+      parent: vpModal, top: 1, left: 11, width: 40, height: 1,
+      inputOnFocus: true, keys: true,
+      style: { fg: COLORS.valueFg, bg: '#1a237e', focus: { bg: '#283593' } },
+    });
+
+    // Column header
+    const COL_N = 28;
+    const COL_G = 10;
+    blessed.text({
+      parent: vpModal, top: 2, left: 6, tags: true,
+      content: `{#7986cb-fg}${'Name'.padEnd(COL_N)}${'Gender'.padEnd(COL_G)}Provider{/#7986cb-fg}`,
+      style: { bg: COLORS.contentBg },
+    });
+
+    const vpList = blessed.list({
+      parent: vpModal, top: 3, left: 2, right: 2, bottom: 5,
+      keys: true, vi: true, mouse: true,
+      border: { type: 'line' },
+      scrollbar: { ch: '│', style: { fg: COLORS.borderFg } },
+      style: {
+        fg: COLORS.labelFg, bg: COLORS.contentBg,
+        border: { fg: COLORS.borderFg },
+        selected: { bg: '#1a237e', fg: '#00e5ff', bold: true },
+        item: { fg: COLORS.labelFg },
+      },
+    });
+
+    const vpInfoLine = blessed.text({
+      parent: vpModal, bottom: 4, left: 2, right: 2, tags: true,
+      content: '', style: { fg: COLORS.labelFg, bg: COLORS.contentBg },
+    });
+
+    const vpPreviewLine = blessed.text({
+      parent: vpModal, bottom: 3, left: 2, right: 2, tags: true,
+      content: '', style: { fg: '#00e5ff', bg: COLORS.contentBg },
+    });
+
+    blessed.text({
+      parent: vpModal, bottom: 2, left: 2, right: 2, tags: true,
+      content: '{#455a64-fg}[↑↓/jk] Navigate  [Enter] Select  [Space] Preview  [/] Search  [Esc] Cancel{/#455a64-fg}',
+      style: { bg: COLORS.contentBg },
+    });
+
+    function _getFiltered() {
+      if (!_filterText) return _allVoices;
+      const f = _filterText.toLowerCase();
+      return _allVoices.filter(v => v.toLowerCase().includes(f));
+    }
+
+    function _buildVoiceItems(voices) {
+      return voices.map(v => {
+        const isActive = v === draft.voice;
+        const isPrev = v === _previewVoiceId;
+        const dot = isPrev ? '♪' : (isActive ? '●' : ' ');
+        const meta = getVoiceMeta(v);
+        const name = meta.displayName.length > COL_N
+          ? meta.displayName.slice(0, COL_N - 1) + '…'
+          : meta.displayName.padEnd(COL_N);
+        return ` ${dot} ${name}${meta.gender.padEnd(COL_G)}${meta.provider}`;
+      });
+    }
+
+    function _refreshVP() {
+      if (_vpClosed) return;
+      _allVoices = scanInstalledVoices();
+      const filtered = _getFiltered();
+      const items = _buildVoiceItems(filtered);
+      vpList.setItems(items.length > 0 ? items : [' (no voices found)']);
+      screen.render();
+    }
+
+    function _previewVoice(voiceId) {
+      if (_previewVoiceId === voiceId) { _killVP(); vpPreviewLine.setContent(''); screen.render(); return; }
+      _killVP();
+
+      const _ms = parseMultiSpeaker(voiceId);
+      const voicePath = path.resolve(PIPER_VOICES_DIR, _ms.model + '.onnx');
+      const safeBase = path.resolve(PIPER_VOICES_DIR);
+      if (!voicePath.startsWith(safeBase + path.sep) && voicePath !== safeBase) return;
+
+      const tempWav = _secureTempWav('vp');
+      const phrase = SAMPLE_PHRASES[Math.floor(Math.random() * SAMPLE_PHRASES.length)];
+
+      const args = ['--model', voicePath, '--output_file', tempWav];
+      if (_ms.speakerId != null) args.push('--speaker', String(_ms.speakerId));
+      const piper = spawn('piper', args, {
+        stdio: ['pipe', 'ignore', 'ignore'], detached: true, env: _spawnEnv,
+      });
+      piper.stdin.write(phrase + '\n');
+      piper.stdin.end();
+      _previewProc = piper;
+      _previewVoiceId = voiceId;
+
+      if (!_vpClosed) {
+        vpPreviewLine.setContent(`{#00e5ff-fg}♪ Synthesizing: ${voiceId}...{/#00e5ff-fg}`);
+        screen.render();
+      }
+
+      piper.on('exit', (code) => {
+        if (_previewVoiceId !== voiceId) { try { fs.unlinkSync(tempWav); } catch {} return; }
+        if (code !== 0) { _previewProc = null; _previewVoiceId = null; return; }
+        const wp = detectWavPlayer(_spawnEnv);
+        if (!wp) return;
+        const pp = spawn(wp.bin, wp.args(tempWav), { stdio: 'ignore', detached: true, env: _spawnEnv });
+        _previewProc = pp;
+        if (!_vpClosed) { vpPreviewLine.setContent(`{#00e5ff-fg}♪ Playing: ${voiceId}{/#00e5ff-fg}`); screen.render(); }
+        pp.on('exit', () => {
+          if (_previewVoiceId === voiceId) { _previewVoiceId = null; _previewProc = null; if (!_vpClosed) { vpPreviewLine.setContent(''); screen.render(); } }
+          try { fs.unlinkSync(tempWav); } catch {}
+        });
+      });
+      piper.on('error', () => { _previewProc = null; _previewVoiceId = null; });
+    }
+
+    vpSearch.on('keypress', () => {
+      setTimeout(() => { _filterText = vpSearch.getValue().trim(); _refreshVP(); }, 0);
+    });
+    vpSearch.key(['escape'], () => { vpList.focus(); screen.render(); });
+    vpList.key(['/'], () => { vpSearch.clearValue(); vpSearch.focus(); screen.render(); });
+    vpList.key(['enter'], () => {
+      const filtered = _getFiltered();
+      const sel = filtered[vpList.selected];
+      if (sel) { draft.voice = sel; _closeVP(); }
+    });
+    vpList.key(['space'], () => {
+      const filtered = _getFiltered();
+      const sel = filtered[vpList.selected];
+      if (sel) _previewVoice(sel);
+    });
+    vpList.key(['escape', 'q'], _closeVP);
+
+    _refreshVP();
+    const activeIdx = _getFiltered().indexOf(draft.voice);
+    if (activeIdx >= 0) vpList.select(activeIdx);
+    vpList.focus();
+    screen.render();
+  }
+
+  // -------------------------------------------------------------------------
+  // Pretext inline editor
+
+  function _openPretextEditor(parentModal, draft, onDone) {
+    const editModal = blessed.box({
+      parent: screen,
+      top: 'center',
+      left: 'center',
+      width: 60,
+      height: 8,
+      border: { type: 'line' },
+      tags: true,
+      label: _modalTitle('Edit Pretext'),
+      style: { fg: COLORS.labelFg, bg: COLORS.contentBg, border: { fg: '#00e5ff' } },
+    });
+    editModal.setFront();
+
+    blessed.text({
+      parent: editModal, top: 1, left: 2,
+      content: 'Agent pretext (spoken before each TTS message):',
+      style: { fg: COLORS.labelFg, bg: COLORS.contentBg },
+    });
+
+    const inputBox = blessed.textbox({
+      parent: editModal, top: 3, left: 2, right: 2, height: 3,
+      border: { type: 'line' },
+      inputOnFocus: true,
+      value: draft.pretext,
+      style: {
+        fg: COLORS.valueFg, bg: '#0d1b35',
+        border: { fg: COLORS.borderFg },
+        focus: { border: { fg: '#00e5ff' } },
+      },
+    });
+
+    let _editClosed = false;
+    function _closeEdit(save) {
+      if (_editClosed) return;
+      _editClosed = true;
+      if (save) {
+        const raw = inputBox.getValue().trim();
+        // M7: enforce max pretext length
+        draft.pretext = (raw || draft.pretext).slice(0, MAX_PRETEXT_LENGTH);
+      }
+      destroyList(editModal, screen, onDone);
+    }
+
+    inputBox.key(['enter'], () => _closeEdit(true));
+    inputBox.key(['escape'], () => _closeEdit(false));
+
+    inputBox.focus();
+    screen.render();
+  }
+
+  // -------------------------------------------------------------------------
+  // Sample agent with a draft profile (no save) — same full pipeline
+
+  function _sampleAgentWithDraft(agent, draft) {
+    _sampleWithFullProfile(agent, draft);
+  }
+
+  // -------------------------------------------------------------------------
+  // Shared: sample with full profile via play-tts-enhanced.sh
+  // Writes a temp agent profile JSON, then calls the enhanced TTS pipeline
+  // which applies voice + reverb + background music.
+
+  function _sampleWithFullProfile(agent, profile) {
+    _killPreview();
+    const gen = ++_playGeneration;
+
+    // Start spinner on the agent's row in the list
+    const agentIdx = _agents.findIndex(a => a.id === agent.id);
+    if (agentIdx >= 0) _startSpinner(agentIdx);
+
+    const voiceId = profile.voice || '';
+    const pretext = profile.pretext || AgentVoiceStore.getDefaultPretext(agent.displayName, agent.title);
+    const phrase = `${pretext} ${SAMPLE_PHRASES[Math.floor(Math.random() * SAMPLE_PHRASES.length)]}`;
+
+    const _spawnEnv = buildAudioEnv();
+    const scriptDir = path.join(_projectRoot, '.claude', 'hooks');
+    const plainScript = path.join(scriptDir, 'play-tts.sh');
+
+    // Use play-tts.sh directly for reliable sample playback.
+    // Voice is passed as CLI arg, pretext is prepended to text.
+    const args = [plainScript, phrase];
+    if (voiceId) args.push(voiceId);
+
+    const env = { ..._spawnEnv };
+
+    const proc = spawn('bash', args, {
+      stdio: ['ignore', 'ignore', 'ignore'],
+      detached: true,
+      env,
+      cwd: _projectRoot,
+    });
+    _playingProcess = proc;
+
+    proc.on('exit', () => {
+      if (gen === _playGeneration) { _playingProcess = null; _stopSpinner(); }
+    });
+
+    proc.on('error', () => {
+      if (gen === _playGeneration) { _playingProcess = null; _stopSpinner(); }
+    });
+  }
+
+  // -------------------------------------------------------------------------
+  // Auto-assign helpers
+
+  function _shuffleArray(arr) {
+    const a = [...arr];
+    for (let i = a.length - 1; i > 0; i--) {
+      const j = Math.floor(Math.random() * (i + 1));
+      [a[i], a[j]] = [a[j], a[i]];
+    }
+    return a;
+  }
+
+  function _autoAssignVoices() {
+    const installed = scanInstalledVoices();
+    if (installed.length === 0) return false;
+
+    // Separate by gender for variety
+    const females = _shuffleArray(installed.filter(v => getVoiceMeta(v).gender === 'Female'));
+    const males   = _shuffleArray(installed.filter(v => getVoiceMeta(v).gender === 'Male'));
+    const others  = _shuffleArray(installed.filter(v => !['Male', 'Female'].includes(getVoiceMeta(v).gender)));
+
+    // Interleave female/male for natural variety, then others
+    const pool = [];
+    const maxLen = Math.max(females.length, males.length);
+    for (let i = 0; i < maxLen; i++) {
+      if (i < females.length) pool.push(females[i]);
+      if (i < males.length)   pool.push(males[i]);
+    }
+    pool.push(...others);
+
+    const used = new Set();
+    _agents.forEach((agent, i) => {
+      const voice = pool.find(v => !used.has(v)) ?? pool[i % pool.length];
+      if (voice) {
+        used.add(voice);
+        voiceStore.setAgentProfile(agent.id, { voice });
+      }
+    });
+    return true;
+  }
+
+  function _autoAssignMusic() {
+    const tracksDir = path.join(_projectRoot, '.claude', 'audio', 'tracks');
+    let tracks = [];
+    try {
+      tracks = fs.readdirSync(tracksDir).filter(f => /\.mp3$/i.test(f));
+    } catch { /* no tracks dir */ }
+    if (tracks.length === 0) return false;
+
+    const shuffled = _shuffleArray(tracks);
+    _agents.forEach((agent, i) => {
+      const track = shuffled[i % shuffled.length];
+      const existing = voiceStore.getAgentProfile(agent.id);
+      voiceStore.setAgentProfile(agent.id, {
+        backgroundMusic: { track, volume: existing.backgroundMusic?.volume ?? 70, enabled: true },
+      });
+    });
+    return true;
+  }
+
+  function _autoAssignAll() {
+    if (_agents.length === 0) return;
+    const voiceOk = _autoAssignVoices();
+    const musicOk = _autoAssignMusic();
+    refreshDisplay();
+    const msg = voiceOk && musicOk ? 'Voices and music auto-assigned'
+               : voiceOk ? 'Voices auto-assigned' : 'Auto-assign: no voices found';
+    _showSavedToast(msg);
+  }
 
+  // -------------------------------------------------------------------------
+  // Bulk edit menu
+
+  function _openBulkEditMenu() {
+    const BULK_ACTIONS = [
+      { label: '  Randomize Voices (gender-aware)',      key: 'voices' },
+      { label: '  Randomize Music (unique per agent)',   key: 'music' },
+      { label: '  Randomize Both',                       key: 'both' },
+      { label: '  Set Same Music for All Agents...',     key: 'setMusic' },
+      { label: '  Set Same Volume for All Agents...',    key: 'setVolume' },
+      { label: '  Set Same Pretext for All Agents...',   key: 'setPretext' },
+      { label: '  Set Same Reverb for All Agents...',    key: 'setReverb' },
+      { label: '  Reset All Agent Profiles',             key: 'resetAll' },
+    ];
+
+    const menuList = blessed.list({
+      parent: screen,
+      top: 'center',
+      left: 'center',
+      width: 52,
+      height: BULK_ACTIONS.length + 4,
+      border: { type: 'line' },
+      tags: true,
+      label: _modalTitle('Bulk Edit'),
+      keys: true,
+      vi: true,
+      mouse: true,
+      items: BULK_ACTIONS.map(a => a.label),
+      style: {
+        fg: COLORS.labelFg,
+        bg: COLORS.contentBg,
+        border: { fg: COLORS.btnFocus },
+        selected: { bg: '#4a148c', fg: COLORS.activeFg, bold: true },
+        item: { fg: COLORS.labelFg },
+      },
+    });
+
+    blessed.text({
+      parent: menuList,
+      bottom: -1,
+      left: 1,
+      width: 48,
+      height: 1,
+      tags: true,
+      content: '{#455a64-fg}[Enter] Select  [Esc] Cancel{/#455a64-fg}',
+      style: { bg: COLORS.contentBg },
+    });
+
+    menuList.setFront();
+    menuList.focus();
+    screen.render();
+
+    let _menuClosed = false;
+    function _closeMenu(callback) {
+      if (_menuClosed) return;
+      _menuClosed = true;
+      destroyList(menuList, screen, callback);
+    }
+
+    menuList.key(['enter'], () => {
+      const action = BULK_ACTIONS[menuList.selected];
+      if (!action) return;
+
+      switch (action.key) {
+        case 'voices':
+          _closeMenu(() => {
+            if (_autoAssignVoices()) { refreshDisplay(); _showSavedToast('Voices randomized'); }
+          });
+          break;
+
+        case 'music':
+          _closeMenu(() => {
+            if (_autoAssignMusic()) { refreshDisplay(); _showSavedToast('Music randomized'); }
+          });
+          break;
+
+        case 'both':
+          _closeMenu(() => { _autoAssignAll(); });
+          break;
+
+        case 'setMusic':
+          _closeMenu(() => {
+            openTrackPicker(screen, '', 70, (track, volume) => {
+              _agents.forEach(agent => {
+                const p = voiceStore.getAgentProfile(agent.id);
+                voiceStore.setAgentProfile(agent.id, {
+                  backgroundMusic: { track, volume, enabled: true },
+                });
+              });
+              refreshDisplay();
+              _showSavedToast('Music set for all agents');
+              agentList.focus();
+            }, () => { agentList.focus(); screen.render(); });
+          });
+          break;
+
+        case 'setVolume':
+          _closeMenu(() => {
+            const curVol = voiceStore.getAgentProfile(_agents[0]?.id)?.backgroundMusic?.volume ?? 70;
+            openVolumeInput(screen, curVol, (volume) => {
+              _agents.forEach(agent => {
+                const p = voiceStore.getAgentProfile(agent.id);
+                const bm = p.backgroundMusic || {};
+                voiceStore.setAgentProfile(agent.id, {
+                  backgroundMusic: { ...bm, volume },
+                });
+              });
+              refreshDisplay();
+              _showSavedToast(`Volume set to ${volume}% for all agents`);
+              agentList.focus();
+            }, () => { agentList.focus(); screen.render(); });
+          });
+          break;
+
+        case 'setPretext':
+          _closeMenu(() => { _openBulkPretextEditor(); });
+          break;
+
+        case 'setReverb':
+          _closeMenu(() => {
+            openReverbPicker(screen, '', (val) => {
+              _agents.forEach(agent => voiceStore.setAgentProfile(agent.id, { reverbPreset: val }));
+              refreshDisplay();
+              _showSavedToast('Reverb set for all agents');
+              agentList.focus();
+            }, () => { agentList.focus(); screen.render(); }, { applyToEffectsManager: false });
+          });
+          break;
+
+        case 'resetAll':
+          _closeMenu(() => {
+            _agents.forEach(agent => voiceStore.resetAgentProfile(agent.id));
+            refreshDisplay();
+            _showSavedToast('All profiles reset');
+          });
+          break;
+      }
+    });
+
+    menuList.key(['escape', 'q'], () => {
+      _closeMenu(() => { agentList.focus(); screen.render(); });
+    });
+  }
+
+  function _openBulkPretextEditor() {
+    const editModal = blessed.box({
+      parent: screen,
+      top: 'center',
+      left: 'center',
+      width: 60,
+      height: 9,
+      border: { type: 'line' },
+      tags: true,
+      label: _modalTitle('Set Pretext for All Agents'),
+      style: { fg: COLORS.labelFg, bg: COLORS.contentBg, border: { fg: '#00e5ff' } },
+    });
+    editModal.setFront();
+
+    blessed.text({
+      parent: editModal, top: 1, left: 2,
+      content: 'Pretext to apply to all agents (leave empty to clear):',
+      style: { fg: COLORS.labelFg, bg: COLORS.contentBg },
+    });
+
+    const inputBox = blessed.textbox({
+      parent: editModal, top: 3, left: 2, right: 2, height: 3,
+      border: { type: 'line' },
+      inputOnFocus: true,
+      style: {
+        fg: COLORS.valueFg, bg: '#0d1b35',
+        border: { fg: COLORS.borderFg },
+        focus: { border: { fg: '#00e5ff' } },
+      },
+    });
+
+    blessed.text({
+      parent: editModal, bottom: 1, left: 2, tags: true,
+      content: '{#455a64-fg}[Enter] Apply to all  [Esc] Cancel{/#455a64-fg}',
+      style: { bg: COLORS.contentBg },
+    });
+
+    let _closed = false;
+    function _close(save) {
+      if (_closed) return;
+      _closed = true;
+      if (save) {
+        const raw = inputBox.getValue().trim().slice(0, MAX_PRETEXT_LENGTH);
+        _agents.forEach(agent => {
+          if (raw) {
+            voiceStore.setAgentProfile(agent.id, { pretext: raw });
+          } else {
+            const p = voiceStore.getAgentProfile(agent.id);
+            const { pretext: _removed, ...rest } = p;
+            voiceStore.resetAgentProfile(agent.id);
+            if (Object.keys(rest).length > 0) voiceStore.setAgentProfile(agent.id, rest);
+          }
+        });
+        refreshDisplay();
+        _showSavedToast('Pretext set for all agents');
+      }
+      destroyList(editModal, screen, () => { agentList.focus(); screen.render(); });
+    }
+
+    inputBox.key(['enter'], () => _close(true));
+    inputBox.key(['escape'], () => _close(false));
+    inputBox.focus();
     screen.render();
   }
 
   // -------------------------------------------------------------------------
   // Key bindings
 
-  agentList.key(['r', 'R'], () => {
+  agentList.key(['x', 'X'], () => {
     const agent = _agents[agentList.selected];
     if (agent) {
-      voiceStore.resetVoice(agent.id);
+      voiceStore.resetAgentProfile(agent.id);
       refreshDisplay();
     }
   });
 
-  agentList.key(['p', 'P'], () => {
-    const current = voiceStore.getPartyMode();
-    voiceStore.setPartyMode(!current);
-    refreshDisplay();
+
+  agentList.key(['enter'], () => {
+    const agent = _agents[agentList.selected];
+    if (agent) _openAgentDetailPanel(agent);
   });
 
-  // Type-to-jump: press a letter to jump to first agent whose name starts with it
-  const _agentJumpBlocked = new Set(['j', 'k', 'g', 'h', 'l', 'd', 'u', 'r', 'p']);
+  agentList.key(['space'], () => {
+    const agent = _agents[agentList.selected];
+    if (agent) _sampleAgent(agent);
+  });
+
+  agentList.key(['a', 'A'], () => { _autoAssignAll(); });
+  agentList.key(['b', 'B'], () => { _openBulkEditMenu(); });
+
+  // Type-to-jump
+  const _agentJumpBlocked = new Set(['j', 'k', 'g', 'h', 'l', 'd', 'u', 'x', 'a', 'b']);
   agentList.on('keypress', (ch, key) => {
     if (!ch || key.ctrl || key.meta) return;
     const lower = ch.toLowerCase();
@@ -286,50 +1392,84 @@ export function createAgentsTab(screen, services) {
     }
   });
 
-  // Blinking █ on selected row while list is focused
+  // Inline row hint (appended to selected row while list is focused)
+  let _listFocused = false;
+  let _hintIdx  = -1;
+  let _hintBase = '';   // row content before hint was appended (no hint, no █)
+
+  function _updateHint(idx) {
+    const items = agentList.items;
+    if (_hintIdx >= 0 && _hintIdx !== idx && items[_hintIdx]) {
+      const hadBlink = (items[_hintIdx].content ?? '').endsWith('  █');
+      items[_hintIdx].setContent(hadBlink ? _hintBase + '  █' : _hintBase);
+    }
+    if (idx >= 0 && items[idx]) {
+      let c = items[idx].content ?? '';
+      const hasBlink = c.endsWith('  █');
+      if (hasBlink) c = c.slice(0, -3);
+      _hintBase = c;
+      items[idx].setContent(c + _ROW_HINT_BMAD + (hasBlink ? '  █' : ''));
+    } else {
+      _hintBase = '';
+    }
+    _hintIdx = idx;
+  }
+
+  // Blinking cursor
   let _alBlink = { interval: null, on: false, sel: -1 };
   function _alTick() {
     _alBlink.on = !_alBlink.on;
     const items = agentList.items;
     const cur = agentList.selected ?? 0;
     if (_alBlink.sel !== cur && _alBlink.sel >= 0 && items[_alBlink.sel]) {
-      items[_alBlink.sel].setContent((items[_alBlink.sel].content ?? '').replace(/ █$/, ''));
+      items[_alBlink.sel].setContent((items[_alBlink.sel].content ?? '').replace(/  █$/, ''));
     }
     _alBlink.sel = cur;
     if (items[cur]) {
-      const base = (items[cur].content ?? '').replace(/ █$/, '');
-      items[cur].setContent(_alBlink.on ? `${base} █` : base);
+      const base = (items[cur].content ?? '').replace(/  █$/, '');
+      items[cur].setContent(_alBlink.on ? `${base}  █` : base);
     }
     screen.render();
   }
   agentList.on('focus', () => {
+    _listFocused = true;
     _alBlink.on = true;
     _alBlink.sel = agentList.selected ?? 0;
+    _hintIdx = -1;
+    _hintBase = '';
+    _updateHint(_alBlink.sel);
     const items = agentList.items;
-    if (items[_alBlink.sel]) items[_alBlink.sel].setContent((items[_alBlink.sel].content ?? '') + ' █');
+    if (items[_alBlink.sel]) items[_alBlink.sel].setContent((items[_alBlink.sel].content ?? '') + '  █');
     screen.render();
     _alBlink.interval = setInterval(_alTick, 500);
   });
   agentList.on('blur', () => {
+    _listFocused = false;
     if (_alBlink.interval) { clearInterval(_alBlink.interval); _alBlink.interval = null; }
     const items = agentList.items;
     const sel = agentList.selected ?? 0;
-    if (items[sel]) items[sel].setContent((items[sel].content ?? '').replace(/ █$/, ''));
+    if (items[sel]) {
+      items[sel].setContent(sel === _hintIdx ? _hintBase : (items[sel].content ?? '').replace(/  █$/, ''));
+    }
+    if (_hintIdx >= 0 && _hintIdx !== sel && items[_hintIdx]) {
+      items[_hintIdx].setContent(_hintBase);
+    }
+    _hintIdx = -1;
+    _hintBase = '';
     screen.render();
   });
   agentList.on('select item', () => {
+    _updateHint(agentList.selected ?? 0);
     if (_alBlink.interval) _alTick();
   });
 
-  // [↑] at top of list → jump to main header tab bar
+  // Navigation: up at top → tab bar, escape → tab bar
   agentList.key(['up'], () => {
     if (agentList.selected === 0 && typeof focusMainTabBar === 'function') {
       focusMainTabBar();
       setTimeout(() => { agentList.select(0); screen.render(); }, 0);
     }
   });
-
-  // Escape at the list level → return to header tab bar
   agentList.key(['escape'], () => {
     if (typeof focusMainTabBar === 'function') { focusMainTabBar(); screen.render(); }
   });
@@ -347,19 +1487,26 @@ export function createAgentsTab(screen, services) {
     },
 
     hide() {
+      _killPreview();
       box.hide();
       screen.render();
     },
 
     onFocus() {
-      agentList.focus();
+      if (_bmadDetected) {
+        agentList.focus();
+      } else {
+        onboardingBox.focus();
+      }
       screen.render();
     },
 
-    onBlur() {},
+    onBlur() {
+      _killPreview();
+    },
 
     getFooterText() {
-      return FOOTER_TEXT;
+      return _bmadDetected ? FOOTER_TEXT_BMAD : FOOTER_TEXT_NOBMAD;
     },
 
     getFooterColor() {