Eve library

ISIS v2 Voice Line Pack Web UI Controls and Validation

Guide

Revision 1

On this page

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