# ISIS v2 Voice Line Pack Web UI Controls and Validation

Generated: 2026-03-03T14:51:01.577Z Checklist: `MXA-0551` (ISIS2-00749) Asset
Family: `voice-line-pack` Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)

## Objective

Expose voice-line-pack workflows in Isis web UI with ergonomic variant-specific
controls and deterministic validation aligned to API and SDK typed contracts.

## Workflow Coverage

| Workflow ID                           | Covered |
| ------------------------------------- | ------- |
| `voice-line-pack-baseline`            | yes     |
| `voice-line-pack-image-conditioned`   | yes     |
| `voice-line-pack-control-conditioned` | yes     |
| `voice-line-pack-consistency-locked`  | yes     |

## Ergonomic Controls

- `Cue ID (required)`: present
- `Script Text (required)`: present
- `Speaker ID (required)`: present
- `Language Locale (required)`: present
- `Emotion (required)`: present
- `Speaking Rate (required)`: present
- `Pitch Shift (Semitones) (required)`: present
- `Duration Seconds (required)`: present
- `Voice Stability (required)`: present
- `Sample Rate (Hz) (required)`: present
- `Target LUFS (required)`: present
- `Output Format (required)`: present
- `Text Prompt Hint`: present
- `Seed (required)`: present
- `Conditioning Strength (required)`: present
- `Reference Image URL (required)`: present
- `Reference Image URLs (comma-separated)`: present
- `Speaker Style Reference ID`: present
- `Voice Consistency Profile ID`: present
- `Conditioning Mode (required)`: present
- `Provider Capability Mode (required)`: present
- `Reference Mix Strategy (required)`: present
- `Preserve Prompt Intent`: present
- `Prompt Template ID (required)`: present
- `Style Profile ID (required)`: present
- `Model Name (required)`: present
- `Control Applicability Mode (required)`: present
- `Control Signal Fusion (required)`: present
- `Control Profile ID (required)`: present
- `Control Timeline FPS (required)`: present
- `Articulation Alignment Mode (required)`: present
- `Use Pose Control`: present
- `Pose Map`: present
- `Pose Strength`: present
- `Use Depth Control`: present
- `Depth Map`: present
- `Depth Strength`: present
- `Use Segmentation Control`: present
- `Segmentation Map`: present
- `Segmentation Strength`: present
- `Use Canny Control`: present
- `Edge Map`: present
- `Canny Strength`: present
- `Use Lineart Control`: present
- `Lineart Map`: present
- `Lineart Strength`: present
- `Continuity Profile ID`: present
- `Continuity Profile Revision`: present
- `Continuity Locked Dimensions`: present
- `Continuity Notes (required)`: present
- `Continuity Window Size (required)`: present
- `Voice Consistency Profile Revision (required)`: present
- `Voice Consistency Provider Mode (required)`: present
- `Voice ID (required)`: present
- `Speaker Embedding ID`: present
- `Speaker Embedding URL`: present
- `Speaker Embedding Vector (comma-separated numbers)`: present
- `Speaker Reference Audio URL (required)`: present
- `Prosody Reference Audio URL`: present
- `Ambience Reference Audio URL`: present
- `Pronunciation Reference Audio URL`: present
- `Speaker Reference Audio URLs (comma-separated)`: present
- `Use Speaker Reference`: present
- `Use Prosody Reference`: present
- `Use Ambience Reference`: present
- `Use Pronunciation Reference`: present
- `Continuity Lock Strength`: present
- `Voice Lock Strength`: present
- `Prosody Lock Strength`: present
- `Pronunciation Lock Strength`: present
- `Ambience Lock Strength`: present
- `Phoneme Alignment Target Score`: present
- `Intelligibility Target Score`: present
- `Integrated LUFS Delta Tolerance`: present
- `Prosody Drift Tolerance`: present
- `Pronunciation Lexicon IDs (comma-separated)`: present
- `Pronunciation Dictionary Locators (comma-separated)`: present
- `Style Tokens (comma-separated)`: present
- `Voice Consistency Strength`: present

## Validation Rules

- present: Voice line pack workflows require generation type voice-synthesis.
- present: Cue ID is required.
- present: Cue ID must be at least 3 characters.
- present: Script Text is required.
- present: Script Text must be at least 5 characters.
- present: Reference Image URL is required.
- present: Reference Image URLs must contain at least one value when provided.
- present: Reference Image URLs must include at most 32 entries.
- present: Reference Image URLs entries must be at most 1200 characters.
- present: Speaker Style Reference ID must be at most 128 characters.
- present: Prompt Template ID is required.
- present: Style Profile ID is required.
- present: Model Name is required.
- present: Control Profile ID is required.
- present: At least one control must be enabled for control-conditioned
  workflows.
- present: Pose Map is required when pose control is enabled.
- present: Depth Map is required when depth control is enabled.
- present: Segmentation Map is required when segmentation control is enabled.
- present: Edge Map is required when canny control is enabled.
- present: Lineart Map is required when lineart control is enabled.
- present: Continuity Profile ID must be scene-continuity-profile.
- present: Continuity Locked Dimensions must contain at least one value.
- present: Continuity Notes is required.
- present: Speaker Reference Audio URL is required.
- present: Prosody Reference Audio URL is required when prosody reference is
  enabled.
- present: Ambience Reference Audio URL is required when ambience reference is
  enabled.
- present: Pronunciation Reference Audio URL is required when pronunciation
  reference is enabled.

## Verification Commands

- `pnpm --filter @isis/web exec vitest run src/pages/voice-line-pack-ui-utils.spec.ts`
- `pnpm --filter @isis/web exec vitest run src/pages/WorkflowDetailsPage.spec.tsx -t "voice line pack"`
- `node scripts/isis/validate-v2-voice-line-pack-web-ui-controls-validation.mjs`

## Acceptance Criteria

- Workflow details page renders ergonomic variant-specific voice-line-pack
  controls for all four workflow IDs.
- Web UI validation enforces typed contract constraints (voice-synthesis lock,
  required fields, and conditional control/reference dependencies).
- Workflow run dispatch includes explicit generationType/type fields for typed
  API contract alignment.
- Web UI tests cover ergonomic form rendering, validation errors, and successful
  workflow run payload dispatch.

## Traceability

- Checklist item: `MXA-0551`
- Ticket key: `ISIS2-00749`
- Source references:
  - `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_VOICE_LINE_PACK_REQUIREMENTS_BRIEF.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_VOICE_LINE_PACK_SDK_END_TO_END_EXAMPLES.json`
  - `apps/isis/web/src/pages/WorkflowDetailsPage.tsx`
  - `apps/isis/web/src/pages/WorkflowDetailsPage.spec.tsx`
  - `apps/isis/web/src/pages/voice-line-pack-ui-utils.ts`
  - `apps/isis/web/src/pages/voice-line-pack-ui-utils.spec.ts`
  - `apps/isis/web/src/pages/workflow-run-utils.ts`
  - `ISIS_TODOS_2.md`
