agentvibes 5.12.0 → 5.13.1

package/src/utils/provider-validator.js

@@ -7,6 +7,64 @@ import { spawnSync } from 'node:child_process';
 import path from 'node:path'; // For safe path operations and traversal prevention
 import fs from 'node:fs'; // For checking file/directory existence
 import os from 'node:os'; // For os.homedir() to prevent HOME injection attacks
+import { listProviders, displayName as catalogDisplayName } from '../services/provider-catalog.js';
+
+/**
+ * Canonical set of TTS synthesis providers AgentVibes knows how to use.
+ * SINGLE SOURCE OF TRUTH: every user-facing dispatcher (MCP set_provider
+ * allowlist, voice switch, voice list, Windows provider manager) must recognise
+ * these providers — platform-scoped where noted below. A provider that lives
+ * here but is missing from a dispatcher is the "silent drop to Piper / Unknown
+ * provider" class of bug (see AVI-S8.1). The dispatcher-parity conformance test
+ * asserts this invariant.
+ *
+ * Platform notes: `macos` is Darwin-only; `windows-sapi`/`windows-piper` are
+ * Windows-only. `kokoro` ships a play-tts runtime on BOTH Unix
+ * (play-tts-kokoro.sh) and PowerShell (play-tts-kokoro.ps1). `elevenlabs` ships
+ * a Unix runtime only (play-tts-elevenlabs.sh) — there is NO
+ * play-tts-elevenlabs.ps1 yet — so it is recognised by the portable (bash/JS)
+ * dispatchers but intentionally excluded from the Windows provider manager
+ * until a PowerShell runtime lands (AVI-S8.2).
+ * @type {readonly string[]}
+ */
+export const SUPPORTED_PROVIDERS = Object.freeze(listProviders().map((p) => p.id));
+
+/**
+ * Providers that use the SAME id on every OS and have at least a Unix (bash)
+ * runtime. Every PORTABLE dispatcher — the MCP set_provider allowlist,
+ * voice-manager.sh, and list-voices.js — must recognise these regardless of
+ * platform. DERIVED VIEW over the catalog: the providers with a Unix runtime
+ * whose voices are enumerable without disk (static/name-to-id) — i.e. kokoro and
+ * elevenlabs.
+ * @type {readonly string[]}
+ */
+export const CROSS_PLATFORM_PROVIDERS = Object.freeze(
+  listProviders()
+    .filter((p) => p.runtime.unix !== null && (p.voiceModel === 'static' || p.voiceModel === 'name-to-id'))
+    .map((p) => p.id),
+);
+
+/**
+ * Subset of {@link CROSS_PLATFORM_PROVIDERS} that ALSO ships a PowerShell runtime
+ * (play-tts-*.ps1), so the Windows provider manager (provider-manager.ps1) must
+ * recognise them too. `elevenlabs` is excluded until play-tts-elevenlabs.ps1
+ * exists (AVI-S8.2). DERIVED VIEW over the catalog.
+ * @type {readonly string[]}
+ */
+export const WINDOWS_RUNTIME_PROVIDERS = Object.freeze(
+  listProviders()
+    .filter((p) => p.runtime.unix !== null && (p.voiceModel === 'static' || p.voiceModel === 'name-to-id') && p.runtime.windows !== null)
+    .map((p) => p.id),
+);
+
+/**
+ * Is `name` a provider AgentVibes canonically supports?
+ * @param {string} name
+ * @returns {boolean}
+ */
+export function isKnownProvider(name) {
+  return SUPPORTED_PROVIDERS.includes(String(name || '').toLowerCase());
+}
 
 /**
  * Helper: Check if command exists in PATH
@@ -603,16 +661,8 @@ function getPackageInfo(pkgName) {
  * @returns {string} Display name
  */
 export function getProviderDisplayName(providerName) {
-  const names = {
-    soprano: 'Soprano TTS',
-    piper: 'Piper TTS',
-    kokoro: 'Kokoro TTS',
-    elevenlabs: 'ElevenLabs',
-    macos: 'macOS Say',
-    sapi: 'Windows SAPI',
-    'windows-sapi': 'Windows SAPI',
-    'windows-piper': 'Piper TTS'
-  };
-
-  return names[providerName] || providerName;
+  // DERIVED VIEW: delegate to the Provider Catalog (single source of truth for
+  // display names). The catalog resolves aliases (e.g. 'sapi' → Windows SAPI) and
+  // passes unknown ids through unchanged, preserving this function's contract.
+  return catalogDisplayName(providerName);
 }

package/.claude/commands/agent-vibes/language.md

@@ -1,23 +0,0 @@
----
-description: Set your main/native language for learning mode
----
-
-Set your main/native language. This is the language you already know and will hear first when learning mode is enabled.
-
-Usage:
-```
-/agent-vibes:language english
-/agent-vibes:language spanish
-/agent-vibes:language french
-```
-
-The main language uses your currently selected voice. When learning mode is ON, TTS will speak in your main language FIRST, then translate to your target language.
-
-Default: english
-
-Supported languages: english, spanish, french, german, italian, portuguese, chinese, japanese, korean, hindi, arabic, polish, dutch, turkish, swedish, russian, and 15+ more.
-
-After setting your main language:
-1. Set your target language with `/agent-vibes:target <language>`
-2. Set target voice with `/agent-vibes:target-voice <voice>`
-3. Enable learning mode with `/agent-vibes:learn`

package/.claude/commands/agent-vibes/learn.md

@@ -1,67 +0,0 @@
----
-description: Enable or disable language learning mode
----
-
-Turn language learning mode ON or OFF. When enabled, Claude will speak acknowledgments and completions in BOTH your main language and target language.
-
-Usage:
-```
-/agent-vibes:learn              # Turn ON
-/agent-vibes:learn off          # Turn OFF
-/agent-vibes:learn status       # Show current setup
-```
-
-## How Learning Mode Works:
-
-When learning mode is **ON**:
-1. **First**: Speak in your main language (using your current voice)
-2. **Then**: Speak the SAME message translated to your target language (using target voice)
-
-Example:
-```
-Main language (English, Aria): "I'll check that for you"
-Target language (Spanish, Antoni): "Lo verificaré para ti"
-```
-
-## Setup Steps:
-
-1. Set your main language:
-   ```
-   /agent-vibes:language english
-   ```
-
-2. Set your target language:
-   ```
-   /agent-vibes:target spanish
-   ```
-
-3. Set target voice (recommended):
-   ```
-   /agent-vibes:target-voice Antoni
-   ```
-
-4. Enable learning mode:
-   ```
-   /agent-vibes:learn
-   ```
-
-5. Check your setup:
-   ```
-   /agent-vibes:learn status
-   ```
-
-## Notes:
-
-- Translations are **direct translations** of what was said in the main language
-- Same **personality/sentiment** applies to both languages
-- Works with all AgentVibes features (BMAD, personalities, etc.)
-- Requires multilingual voices for target language (Antoni, Rachel, Domi, Bella, etc.)
-- Small pause (0.5s) between main and target language announcements
-
-## Disable Learning Mode:
-
-```
-/agent-vibes:learn off
-```
-
-This returns to normal single-language TTS mode.

package/.claude/commands/agent-vibes/replay-target.md

@@ -1,14 +0,0 @@
----
-description: Replay the last target language audio (for language learning mode)
----
-
-Replay the last message that was spoken in your target language during language learning mode.
-
-This is useful when learning a new language - you can hear the translation again without triggering a new one.
-
-Usage:
-- `/agent-vibes:replay-target` - Replay the last target language audio
-
-**Note:** This only works when language learning mode is active (`/agent-vibes:learn`).
-
-!bash .claude/hooks/replay-target-audio.sh

package/.claude/commands/agent-vibes/target-voice.md

@@ -1,26 +0,0 @@
----
-description: Set the voice for your target language
----
-
-Set which voice to use when speaking your target language. This should typically be a multilingual voice that supports your target language.
-
-Usage:
-```
-/agent-vibes:target-voice Antoni
-/agent-vibes:target-voice Rachel
-/agent-vibes:target-voice Domi
-```
-
-Recommended multilingual voices:
-- **Antoni** - Best for Spanish, Portuguese
-- **Rachel** - Best for French, English
-- **Domi** - Best for German, European languages
-- **Bella** - Best for Italian, Romance languages
-- **Charlotte** - European languages
-- **Matilda** - Latin languages
-
-These voices support 30+ languages using Piper TTS' Multilingual v2 model.
-
-After setting your target voice:
-- Enable learning mode with `/agent-vibes:learn`
-- Check your setup with `/agent-vibes:learn status`

package/.claude/commands/agent-vibes/target.md

@@ -1,30 +0,0 @@
----
-description: Set the language you want to learn
----
-
-Set the target language you want to learn. When learning mode is enabled, TTS will speak in your main language FIRST, then speak the translation in your target language.
-
-Usage:
-```
-/agent-vibes:target spanish
-/agent-vibes:target french
-/agent-vibes:target german
-```
-
-Recommended voices by target language:
-- Spanish → Antoni (Piper TTS) / es_ES-davefx-medium (Piper)
-- French → Rachel (Piper TTS) / fr_FR-siwis-medium (Piper)
-- German → Domi (Piper TTS) / de_DE-thorsten-medium (Piper)
-- Italian → Bella (Piper TTS) / it_IT-riccardo-x_low (Piper)
-- Portuguese → Matilda (Piper TTS) / pt_BR-faber-medium (Piper)
-- Chinese → Amy (Piper TTS) / zh_CN-huayan-medium (Piper)
-- Japanese → Antoni (Piper TTS) / ja_JP-hikari-medium (Piper)
-- Other languages → Antoni (Piper TTS) / check available Piper voices
-
-**Note:** The system will automatically suggest the correct voice based on your active TTS provider. After setting your target language, the suggestion will match whether you're using Piper TTS or Piper.
-
-After setting your target language:
-1. Set the voice for target language with `/agent-vibes:target-voice <voice>`
-2. Enable learning mode with `/agent-vibes:learn`
-
-Supported languages: spanish, french, german, italian, portuguese, chinese, japanese, korean, hindi, arabic, polish, dutch, turkish, swedish, russian, and 15+ more.