agentvibes 4.6.8 → 5.1.0

package/src/services/navigation-service.js

@@ -1,123 +1,123 @@
-/**
- * AgentVibes TUI Console — Navigation Service
- * Story 6.2: Tab Bar & Global Keyboard Navigation
- *
- * Manages tab state, cycling, modal overlay state, and focus stack.
- * Used by navigation.js (key bindings) and app.js (wiring).
- */
-
-/** Ordered list of all tab IDs — used for cycling and validation */
-export const TAB_ORDER = ['install', 'settings', 'voices', 'music', 'agents', 'receiver', 'readme', 'help'];
-
-export class NavigationService {
-  /**
-   * @param {string} [initialTab='settings'] - Tab to activate on launch
-   */
-  constructor(initialTab = 'settings') {
-    this._activeTab = TAB_ORDER.includes(initialTab) ? initialTab : 'settings';
-    this._switchCallbacks = [];
-    this._focusStack = [];
-    this._modalOpen = false;
-  }
-
-  // ---------------------------------------------------------------------------
-  // Tab navigation
-
-  /** Returns the currently active tab ID */
-  getActiveTab() {
-    return this._activeTab;
-  }
-
-  /**
-   * Switch to the given tab.
-   * Ignores invalid tab IDs. Fires all registered onSwitch callbacks.
-   * @param {string} tabId
-   */
-  switchTab(tabId) {
-    if (!TAB_ORDER.includes(tabId)) return;
-    if (tabId === this._activeTab) return; // no-op: already on this tab
-    this._activeTab = tabId;
-    this._switchCallbacks.forEach(cb => cb(tabId));
-  }
-
-  /**
-   * Activate a tab unconditionally, bypassing the same-tab no-op guard.
-   * Used for initial UI setup: the constructor pre-sets _activeTab but
-   * onSwitch callbacks must still fire to render the initial state.
-   * @param {string} tabId
-   */
-  forceActivate(tabId) {
-    if (!TAB_ORDER.includes(tabId)) return;
-    this._activeTab = tabId;
-    this._switchCallbacks.forEach(cb => cb(tabId));
-  }
-
-  /**
-   * Cycle to the next tab in TAB_ORDER, wrapping from last back to first.
-   */
-  cycleTab() {
-    const idx = TAB_ORDER.indexOf(this._activeTab);
-    const nextIdx = (idx + 1) % TAB_ORDER.length;
-    this.switchTab(TAB_ORDER[nextIdx]);
-  }
-
-  /**
-   * Cycle to the previous tab in TAB_ORDER, wrapping from first back to last.
-   */
-  cycleTabPrev() {
-    const idx = TAB_ORDER.indexOf(this._activeTab);
-    const prevIdx = (idx - 1 + TAB_ORDER.length) % TAB_ORDER.length;
-    this.switchTab(TAB_ORDER[prevIdx]);
-  }
-
-  /**
-   * Register a callback fired whenever the active tab changes.
-   * @param {(tabId: string) => void} callback
-   */
-  onSwitch(callback) {
-    this._switchCallbacks.push(callback);
-  }
-
-  // ---------------------------------------------------------------------------
-  // Modal state (story 6.4 will expand this)
-
-  /** Returns true if a modal is currently open */
-  isModalOpen() {
-    return this._modalOpen;
-  }
-
-  /**
-   * Open a modal. Sets modal-open state and calls the factory fn if provided.
-   * @param {Function|null} fn - Optional factory/callback invoked immediately
-   */
-  openModal(fn) {
-    this._modalOpen = true;
-    fn?.();
-  }
-
-  /** Close the current modal, restoring modal-closed state */
-  closeModal() {
-    this._modalOpen = false;
-  }
-
-
-  // ---------------------------------------------------------------------------
-  // Focus stack (story 7.6 will use this for button-level focus)
-
-  /**
-   * Push a Blessed element onto the focus stack
-   * @param {object} element - Blessed widget
-   */
-  pushFocus(element) {
-    this._focusStack.push(element);
-  }
-
-  /**
-   * Pop the last element from the focus stack.
-   * Returns undefined if the stack is empty.
-   * @returns {object|undefined}
-   */
-  popFocus() {
-    return this._focusStack.pop();
-  }
-}
+/**
+ * AgentVibes TUI Console — Navigation Service
+ * Story 6.2: Tab Bar & Global Keyboard Navigation
+ *
+ * Manages tab state, cycling, modal overlay state, and focus stack.
+ * Used by navigation.js (key bindings) and app.js (wiring).
+ */
+
+/** Ordered list of all tab IDs — used for cycling and validation */
+export const TAB_ORDER = ['setup', 'settings', 'voices', 'music', 'agents', 'receiver', 'readme', 'help'];
+
+export class NavigationService {
+  /**
+   * @param {string} [initialTab='settings'] - Tab to activate on launch
+   */
+  constructor(initialTab = 'settings') {
+    this._activeTab = TAB_ORDER.includes(initialTab) ? initialTab : 'settings';
+    this._switchCallbacks = [];
+    this._focusStack = [];
+    this._modalOpen = false;
+  }
+
+  // ---------------------------------------------------------------------------
+  // Tab navigation
+
+  /** Returns the currently active tab ID */
+  getActiveTab() {
+    return this._activeTab;
+  }
+
+  /**
+   * Switch to the given tab.
+   * Ignores invalid tab IDs. Fires all registered onSwitch callbacks.
+   * @param {string} tabId
+   */
+  switchTab(tabId) {
+    if (!TAB_ORDER.includes(tabId)) return;
+    if (tabId === this._activeTab) return; // no-op: already on this tab
+    this._activeTab = tabId;
+    this._switchCallbacks.forEach(cb => cb(tabId));
+  }
+
+  /**
+   * Activate a tab unconditionally, bypassing the same-tab no-op guard.
+   * Used for initial UI setup: the constructor pre-sets _activeTab but
+   * onSwitch callbacks must still fire to render the initial state.
+   * @param {string} tabId
+   */
+  forceActivate(tabId) {
+    if (!TAB_ORDER.includes(tabId)) return;
+    this._activeTab = tabId;
+    this._switchCallbacks.forEach(cb => cb(tabId));
+  }
+
+  /**
+   * Cycle to the next tab in TAB_ORDER, wrapping from last back to first.
+   */
+  cycleTab() {
+    const idx = TAB_ORDER.indexOf(this._activeTab);
+    const nextIdx = (idx + 1) % TAB_ORDER.length;
+    this.switchTab(TAB_ORDER[nextIdx]);
+  }
+
+  /**
+   * Cycle to the previous tab in TAB_ORDER, wrapping from first back to last.
+   */
+  cycleTabPrev() {
+    const idx = TAB_ORDER.indexOf(this._activeTab);
+    const prevIdx = (idx - 1 + TAB_ORDER.length) % TAB_ORDER.length;
+    this.switchTab(TAB_ORDER[prevIdx]);
+  }
+
+  /**
+   * Register a callback fired whenever the active tab changes.
+   * @param {(tabId: string) => void} callback
+   */
+  onSwitch(callback) {
+    this._switchCallbacks.push(callback);
+  }
+
+  // ---------------------------------------------------------------------------
+  // Modal state (story 6.4 will expand this)
+
+  /** Returns true if a modal is currently open */
+  isModalOpen() {
+    return this._modalOpen;
+  }
+
+  /**
+   * Open a modal. Sets modal-open state and calls the factory fn if provided.
+   * @param {Function|null} fn - Optional factory/callback invoked immediately
+   */
+  openModal(fn) {
+    this._modalOpen = true;
+    fn?.();
+  }
+
+  /** Close the current modal, restoring modal-closed state */
+  closeModal() {
+    this._modalOpen = false;
+  }
+
+
+  // ---------------------------------------------------------------------------
+  // Focus stack (story 7.6 will use this for button-level focus)
+
+  /**
+   * Push a Blessed element onto the focus stack
+   * @param {object} element - Blessed widget
+   */
+  pushFocus(element) {
+    this._focusStack.push(element);
+  }
+
+  /**
+   * Pop the last element from the focus stack.
+   * Returns undefined if the stack is empty.
+   * @returns {object|undefined}
+   */
+  popFocus() {
+    return this._focusStack.pop();
+  }
+}

package/src/services/tts-engine-service.js

@@ -0,0 +1,69 @@
+/**
+ * AgentVibes — TTS Engine Service
+ *
+ * OS-aware TTS engine detection: enumerates available engines,
+ * checks binary availability, and reports installation status.
+ */
+
+import { execFileSync } from 'node:child_process';
+import path from 'node:path';
+import fs from 'node:fs';
+
+const TTS_ENGINES = [
+  {
+    id: 'piper', name: 'Piper TTS', desc: 'Open-source, fast, many voices — recommended', native: false,
+    installCmd: process.platform === 'win32'
+      ? 'winget install --id Rhasspy.Piper --accept-package-agreements --accept-source-agreements'
+      : process.platform === 'darwin'
+        ? 'brew install piper'
+        : 'pip install piper-tts',
+  },
+  {
+    id: 'soprano', name: 'Soprano TTS', desc: 'Web-based TTS service with premium voices', native: false,
+    installCmd: 'pip install soprano-tts',
+  },
+  { id: 'sapi', name: 'Windows SAPI', desc: 'Built-in Windows speech — no install needed', native: true, platform: 'win32' },
+  { id: 'macos-say', name: 'macOS Say', desc: 'Built-in macOS speech synthesis — no install needed', native: true, platform: 'darwin' },
+];
+
+export function getAvailableEngines() {
+  return TTS_ENGINES.filter(e => !e.platform || e.platform === process.platform);
+}
+
+export function checkEngineInstalled(engineId) {
+  const engine = TTS_ENGINES.find(e => e.id === engineId);
+  if (!engine) return false;
+  if (engine.native) return true; // Native engines are always available on their platform
+
+  // Check binary availability — soprano has two possible binaries
+  const binaryMap = { piper: ['piper'], soprano: ['soprano-tts', 'soprano-webui'] };
+  const binaries = binaryMap[engineId];
+  if (!binaries) return false;
+
+  for (const binary of binaries) {
+    try {
+      if (process.platform === 'win32') {
+        // Check Windows Piper location
+        if (engineId === 'piper') {
+          const localAppData = process.env.LOCALAPPDATA ||
+            (process.env.USERPROFILE ? path.join(process.env.USERPROFILE, 'AppData', 'Local') : null);
+          if (localAppData && fs.existsSync(path.join(localAppData, 'Programs', 'Piper', 'piper.exe'))) return true;
+        }
+        execFileSync('where', [binary], { stdio: 'ignore', timeout: 2000 });
+        return true;
+      }
+      execFileSync('which', [binary], { stdio: 'ignore', timeout: 2000 });
+      return true;
+    } catch {
+      // try next binary
+    }
+  }
+  return false;
+}
+
+export function getEngineStatuses() {
+  return getAvailableEngines().map(e => ({
+    ...e,
+    installed: checkEngineInstalled(e.id),
+  }));
+}