# HyperTwist Phase 6R-H coqui-ai/TTS advanced narration preparation packet

Created on `2026-05-22`

## Status

- first-party HyperTwist packet
- source-backed permissive `Phase 6R-H` preparation/control slice

## Purpose

This packet narrows the retained `coqui-ai/TTS` row before implementation.

The retained first slice is:

- advanced narration orchestration profile above the already landed embodied companion narration lane

It is not:

- a broad TTS platform packet
- a downloadable voice-asset or model-shipping packet
- a provider-profile or BYOK packet
- a voice-conversion packet
- a viseme, gesture, or avatar-runtime widening packet

## Source-backed basis

Primary donor surfaces inspected:

- `README.md`
- `docs/source/inference.md`
- `TTS/server/README.md`
- `TTS/api.py`

## Narrowing decision

The strongest bounded donor seam is not raw audio output by itself. That lighter local sidecar lane
already landed through `rhasspy/piper`.

The smallest stronger `coqui-ai/TTS` seam is:

- richer narration orchestration metadata
- normalized model/vocoder binding selection
- speaker-selection and multilingual routing flags
- optional speaker-reference conditioning
- sentence-splitting policy above the same first-party narration contract

The first bounded implementation packet should therefore land only:

- first-party advanced narration orchestration profile types
- bounded request/result metadata for model/vocoder/speaker/reference selection
- mock and HTTP voice-client seam support for the bounded advanced narration profile
- focused automation around the advanced narration request/result/health contract

## Explicit deferrals

Still deferred after this control pass:

- downloadable voice/model review
- bundled voice asset shipping
- voice conversion
- broad playback runtime ownership
- viseme / gesture runtime integration
- provider-profile and BYOK custody
- broad assistant-platform scope

## Queue effect

This preparation packet authorizes one bounded permissive implementation packet:

- `Phase 6R-H` advanced narration orchestration profile

After that packet, move the queue head to:

- source-backed `Phase 6R-I` `roice3/Magic120Cell` preparation/control pass

Keep the legal guard visible:

- `coqui-ai/TTS` code-license judgment stays separate from model, voice, and payload review
