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

Created on `2026-05-22`

## Status

- first-party HyperTwist packet
- bounded permissive `Phase 6R-H` implementation slice

## Purpose

This packet lands the first narrower bounded slice from the retained `coqui-ai/TTS` voice-output
row.

The landed slice is:

- first-party advanced narration orchestration profile above the existing 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 runtime packet

## Current authority basis

This implementation packet stands on:

- `docs/HYPERTWIST_PHASE_0R_PACKET_0R_A_EVALUATION_2026-05-12.md`
- `docs/HYPERTWIST_PHASE_2R_PACKET_2R_A_OWNERSHIP_AND_ACCEPTANCE_CONTRACT_2026-05-13.md`
- `docs/REPO_LICENSE_TRACKING.md`
- `docs/ops/HYPERTWIST_PROVIDER_NEUTRALITY_AND_BYOK_DOCTRINE_2026-05-21.md`
- `docs/arch/HYPERTWIST_PHASE6R_H_COQUI_TTS_ADVANCED_NARRATION_PREPARATION_PACKET_2026-05-22.md`

The retained owner remains:

- `coqui-ai/TTS`

The top-level provider and companion contract owner does not change here:

- first-party HyperTwist remains the provider-neutral and companion-contract owner
- this packet keeps `coqui-ai/TTS` bounded to the narrower `A1 / R2 / F2` advanced narration
  orchestration slice

## Landed scope

The current code now owns a retained advanced narration orchestration contract through:

- retained recognition contract types for:
  - narration orchestration profile
  - advanced narration request metadata
  - advanced narration result metadata
  - advanced voice service health metadata
- sample voice profiles, basic and advanced narration request shaping, narration result shaping, and
  voice service health outputs in:
  - `UHyperTwistContractLibrary`
- bounded voice client seam support in:
  - `UHyperTwistMockVoiceClient`
  - `UHyperTwistHttpVoiceClient`
- focused automation coverage in:
  - `HyperTwistCoquiPhase6RHAdvancedNarrationContractTest.cpp`

## Why this is still intentionally bounded

This packet lands a richer voice-output donor seam, but it does not widen into the neighboring
retained families.

Still deferred:

- 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

## Validation

Build validation:

- `Build.bat UnrealHyperTwistEditor Win64 Development -Project='C:\HyperTwist\UnrealHyperTwist\UnrealHyperTwist.uproject' -WaitMutex -NoHotReloadFromIDE`

Focused automation validation:

- `Automation RunTests HyperTwist.Permissive.Coqui.Phase6R.H`

Regression automation validation:

- `Automation RunTests HyperTwist.Permissive.Piper.Phase6R.G`
- `Automation RunTests HyperTwist.Permissive.FasterWhisper.Phase6R.F`
- `Automation RunTests HyperTwist.Permissive.WhisperCpp.Phase6R.E`
- `Automation RunTests HyperTwist.CleanRoom.CubeDesk`

Expected covered tests:

- `AdvancedNarrationRequest`
- `AdvancedNarrationResult`
- `ServiceHealth`
- `NarrationRequest`
- `SynthesisResult`
- `SessionConfig`
- `TranscriptMetadata`
- `TranscriptResult`
- existing `CubeDesk` clean-room regression suite

## Queue effect

This packet consumes the current `Phase 6R-H` implementation slice.

`coqui-ai/TTS` remains only partially incorporated:

- landed now:
  - advanced narration orchestration profile
  - normalized model/vocoder binding metadata
  - multilingual routing and speaker-selection flags
  - reference-speaker conditioning flag
  - bounded mock and HTTP voice-client seam support for the richer narration profile
  - advanced voice service-health capability exposure
- still deferred:
  - downloadable voice/model review
  - bundled voice asset shipping
  - voice conversion
  - broad playback runtime ownership
  - viseme / gesture runtime integration
  - broad assistant-platform scope

The next clean move is:

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

Keep the future sequencing guards visible:

- speech-input / voice sidecar set
  - keep code-license judgments separate from model, voice, and payload-license review
- `coqui-ai/TTS`
  - keep the landed slice bounded to orchestration metadata rather than broad voice-platform
    ownership
- `roice3/Magic120Cell`
  - keep the next widening slice bounded to one retained hyper-engine family rather than treating
    the row as a generic non-Euclidean platform by default
