git:20260702.b5ec89a to git:20260721.23a866e

+ ElevenLabs provides text-to-speech voices for both **in-app TTS** and **phone calls**. Change the voice with the **`voice_config_update`** tool — it writes the voice to **whichever TTS provider is currently active** and pushes to the macOS app via SSE in one call:

+ ```

+ voice_config_update setting="tts_voice_id" value="<voice-id>"

+ ```

+

+ > **The voice lives under the _active_ provider, not always ElevenLabs.** The config key depends on `services.tts.provider`: `elevenlabs` → `services.tts.providers.elevenlabs.voiceId`, `vellum` (managed) → `services.tts.providers.vellum.model`, `deepgram` → `services.tts.providers.deepgram.model`. The `voice_config_update` tool (and the `assistant tts voice <id>` CLI command) handle this routing for you. **Do NOT `assistant config set services.tts.providers.elevenlabs.voiceId ...` blindly** — on a managed (`vellum`) assistant that field is ignored, so the write "succeeds" but the voice never changes. See [Setting the voice](#setting-the-voice) for the CLI fallback.

+ >

+ > **Managed (`vellum`) assistants can only use a curated subset of voices** — the platform bills per rate-carded model, and voices outside that list are rejected at synthesis (so the write succeeds but the voice fails on the next turn). That subset is a handful of ElevenLabs voices **plus** Deepgram Aura voices, all set through `vellum.model`. **If the active provider is `vellum`, pick from [Managed (Vellum) voices](#managed-vellum-voices), NOT the full ElevenLabs tables below** — most voices below (Bill, George, Amelia, …) are not offered on managed and will fail.

+

+ **First, check the active provider** — it decides which list to pick from:

+ ```bash

+ assistant config get services.tts.provider

+ ```

+

+ - `vellum` (managed) → choose from [Managed (Vellum) voices](#managed-vellum-voices). The ElevenLabs tables below do **not** all work on managed.

+ - `elevenlabs` (BYO key) → choose from the tables below.

+

+ Pick a voice that matches your identity and the user's preferences. Offer to show the full list if they want to choose themselves.

+

+ **Preferred — the tool.** It writes to the active provider's voice field **and** pushes to the macOS app via SSE (`ttsVoiceId`) in one call:

+ **CLI fallback (only if the `voice_config_update` tool is unavailable).** Use `assistant tts voice`, which routes to the active provider's config key for you — do **not** hand-write `assistant config set services.tts.providers.elevenlabs.voiceId ...`:

+ assistant tts voice "<selected-voice-id>"

+ Setting `services.tts.providers.elevenlabs.voiceId` directly while the active provider is `vellum` (or any non-elevenlabs provider) is the #1 cause of "I changed the voice but it didn't change" — that field is ignored by the active provider, so the write reports success but nothing changes. If you must use `config set`, first check `assistant config get services.tts.provider` and write the matching key (`vellum` → `services.tts.providers.vellum.model`, `deepgram` → `services.tts.providers.deepgram.model`).

+

+ Verify it worked by reading back the key for the **active** provider, e.g. for a managed assistant:

+

+ ```bash

+ assistant config get services.tts.providers.vellum.model

+ ```

+

+

+ ## Managed (Vellum) voices

+

+ When the active provider is **vellum** (managed speech, common for voice-mode assistants), pick a voice from the two tables below **and only these** — they are the rate-carded models the platform actually offers. Set the chosen `Model` id exactly as you would an ElevenLabs voice (the tool routes it to `vellum.model`):

+

+ ```

+ voice_config_update setting="tts_voice_id" value="aura-2-zeus-en"

+ ```

+

+ The change hot-applies to the next voice turn (live voice and phone read the config fresh each turn). This list mirrors the daemon `GET /v1/tts/managed-voices` route (which the web voice picker uses); if a requested voice isn't here, don't guess an id — offer the closest one below.

+

+ ### Managed ElevenLabs voices

+

+ | Voice | Style | Model |

+ | ----- | ---------------------------------------- | ---------------------- |

+ | Sarah | American · professional, reassuring | `EXAVITQu4vr4xnSDxMaL` |

+ | Roger | American · laid-back, casual, resonant | `CwhRBWXzGAHq8TQ4Fs17` |

+ | Alice | British · clear, engaging, professional | `Xb7hH8MSUJpSbSDYk0k2` |

+ | River | American · relaxed, neutral, informative | `SAz9YHcvj6GT2YYXdXww` |

+ | Eric | American · smooth, trustworthy, classy | `cjVigY5qzO86Huf0OWal` |

+ | Adam | American · deep, dominant, firm | `pNInz6obpgDQGcFmaJgB` |

+

+ ### Deepgram Aura voices

+

+ | Voice | Style | Model |

+ | --------- | -------------------------------------- | --------------------- |

+ | Thalia | American · clear, confident, energetic | `aura-2-thalia-en` |

+ | Andromeda | American · casual, expressive | `aura-2-andromeda-en` |

+ | Helena | American · caring, natural, friendly | `aura-2-helena-en` |

+ | Athena | American · calm, smooth, professional | `aura-2-athena-en` |

+ | Luna | American · friendly, natural, engaging | `aura-2-luna-en` |

+ | Pandora | British · smooth, calm, melodic | `aura-2-pandora-en` |

+ | Theia | Australian · expressive, polite | `aura-2-theia-en` |

+ | Apollo | American · confident, casual | `aura-2-apollo-en` |

+ | Arcas | American · natural, smooth, clear | `aura-2-arcas-en` |

+ | Zeus | American · deep, trustworthy, smooth | `aura-2-zeus-en` |

+ | Draco | British · warm, approachable, baritone | `aura-2-draco-en` |

+ | Hyperion | Australian · caring, warm, empathetic | `aura-2-hyperion-en` |

+

+ **"American male" on managed** → Eric, Adam, Roger (ElevenLabs) or Apollo, Arcas, Zeus (Aura). (Bill/George from the ElevenLabs tables above are **not** offered on managed.)