Add the Half-Life VOX/HEV TTS presets

poc/src/control-bridge.ts

@@ -563,7 +563,11 @@ function buildServer(): McpServer {
                 words: z.boolean().optional().describe("Synthesize each word and merge with gaps"),
                 wordGapMs: z.number().min(0).max(500).optional().describe("Silence between words in ms"),
                 vox: z.boolean().optional().describe("NetTTS-style VOX prosody (Flextalk voices)"),
-                voxClean: z.boolean().optional().describe("VOX without the staccato wrapper")
+                voxClean: z.boolean().optional().describe("VOX without the staccato wrapper"),
+                preset: z
+                    .enum(["vox", "hev"])
+                    .optional()
+                    .describe("Half-Life profile preset for the Keith Bell voice")
             }
         },
         async ({
@@ -579,7 +583,8 @@ function buildServer(): McpServer {
             words,
             wordGapMs,
             vox,
-            voxClean
+            voxClean,
+            preset
         }) =>
             jsonText(
                 await audio.speak(text, {
@@ -594,7 +599,8 @@ function buildServer(): McpServer {
                     words,
                     wordGapMs,
                     vox,
-                    voxClean
+                    voxClean,
+                    preset
                 })
             )
     );

poc/src/preferences.ts

@@ -34,6 +34,8 @@ export interface TtsPreferences {
     vox: boolean;
     /** VOX without the staccato wrapper. */
     voxClean: boolean;
+    /** Half-Life profile preset for Keith Bell: vox, hev, or null for factory values. */
+    preset: "vox" | "hev" | null;
 }
 
 const PROFILE_RANGES: Record<string, [number, number]> = {
@@ -152,7 +154,8 @@ const DEFAULTS: WebPreferences = {
         words: false,
         wordGapMs: null,
         vox: false,
-        voxClean: false
+        voxClean: false,
+        preset: null
     },
     audio: { duck: true },
     favourites: { users: [], channels: [] },
@@ -348,7 +351,11 @@ export class PreferencesStore {
                 words: patch.tts?.words === true,
                 wordGapMs: normalizeRange(patch.tts?.wordGapMs, 0, 500),
                 vox: patch.tts?.vox === true,
-                voxClean: patch.tts?.voxClean === true
+                voxClean: patch.tts?.voxClean === true,
+                preset:
+                    patch.tts?.preset === "vox" || patch.tts?.preset === "hev"
+                        ? patch.tts.preset
+                        : null
             };
         }
 
@@ -415,7 +422,8 @@ export class PreferencesStore {
                 words: raw?.tts?.words === true,
                 wordGapMs: normalizeRange(raw?.tts?.wordGapMs, 0, 500),
                 vox: raw?.tts?.vox === true,
-                voxClean: raw?.tts?.voxClean === true
+                voxClean: raw?.tts?.voxClean === true,
+                preset: raw?.tts?.preset === "vox" || raw?.tts?.preset === "hev" ? raw.tts.preset : null
             },
             audio: {
                 duck: raw?.audio?.duck !== false

poc/src/tts.ts

@@ -38,6 +38,8 @@ export interface TtsOptions {
     vox?: boolean;
     /** VOX without the staccato wrapper. */
     voxClean?: boolean;
+    /** Half-Life profile preset for Keith Bell: vox or hev. */
+    preset?: "vox" | "hev";
 }
 
 export interface TtsEngine {
@@ -354,6 +356,7 @@ export class Tts {
                           .replace("{word_gap_ms}", options.wordGapMs !== undefined ? String(options.wordGapMs) : "")
                           .replace("{vox}", options.vox ? "1" : "")
                           .replace("{vox_clean}", options.voxClean ? "1" : "")
+                          .replace("{preset}", options.preset ?? "")
                   )
             : ["espeak-ng", ...(options.voice ? ["-v", options.voice] : []), "-w", out, "-f", textFile];
 
@@ -379,7 +382,8 @@ export class Tts {
                         ? { VESKSLOP_TTS_WORD_GAP_MS: String(options.wordGapMs) }
                         : {}),
                     ...(options.vox ? { VESKSLOP_TTS_VOX: "1" } : {}),
-                    ...(options.voxClean ? { VESKSLOP_TTS_VOX_CLEAN: "1" } : {})
+                    ...(options.voxClean ? { VESKSLOP_TTS_VOX_CLEAN: "1" } : {}),
+                    ...(options.preset ? { VESKSLOP_TTS_PRESET: options.preset } : {})
                 },
                 stdio: ["ignore", "ignore", "pipe"]
             });

poc/src/webui.ts

@@ -510,7 +510,8 @@ export function startWebUi(deps: WebUiDeps): WebUiHandle {
                     words: tts?.words === true,
                     wordGapMs: tts?.wordGapMs ?? null,
                     vox: tts?.vox === true,
-                    voxClean: tts?.voxClean === true
+                    voxClean: tts?.voxClean === true,
+                    preset: tts?.preset === "vox" || tts?.preset === "hev" ? tts.preset : null
                 };
             }
 
@@ -760,6 +761,12 @@ export function startWebUi(deps: WebUiDeps): WebUiHandle {
                 req.body?.wordGapMs !== undefined ? Number(req.body.wordGapMs) : prefs.tts.wordGapMs ?? undefined;
             const vox = req.body?.vox !== undefined ? req.body.vox === true : prefs.tts.vox;
             const voxClean = req.body?.voxClean !== undefined ? req.body.voxClean === true : prefs.tts.voxClean;
+            const preset =
+                req.body?.preset === "vox" || req.body?.preset === "hev"
+                    ? req.body.preset
+                    : req.body?.preset === null || req.body?.preset === ""
+                      ? null
+                      : prefs.tts.preset;
 
             const result = await deps.audio.speak(text, {
                 provider: provider ?? undefined,
@@ -773,7 +780,8 @@ export function startWebUi(deps: WebUiDeps): WebUiHandle {
                 ...(words ? { words: true } : {}),
                 ...(Number.isFinite(wordGapMs) ? { wordGapMs } : {}),
                 ...(vox ? { vox: true } : {}),
-                ...(voxClean ? { voxClean: true } : {})
+                ...(voxClean ? { voxClean: true } : {}),
+                ...(preset ? { preset } : {})
             });
             deps.getPuppet()?.appendAction({
                 type: "audio",